NAME

       faxsetup - setup a machine for use with HylaFAX

SYNOPSIS

       /usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ]

DESCRIPTION

       faxsetup  is  an  interactive  shell  script  that does the necessary setup work to configure a client or
       server machine for the HylaFAX software.  faxsetup must be run on every HylaFAX server machine before the
       software will function-if a HylaFAX server program or script is  invoked  before  faxsetup  is  run,  the
       command will abort with a message that says to run faxsetup.  faxsetup may optionally be run on a HylaFAX
       client machine to verify the configuration of the software.

       By default faxsetup checks a machine for use both as a HylaFAX client and server.  Client-specific checks
       include:

       •  the installation of client programs and data,

       •  the  installation of the Adobe Font Metric (AFM) information files used by the HylaFAX text formatting
          support.

       Server-specific checks include:

       •  the installation of server programs and data,

       •  the existence of the UUCP lock file directory,

       •  the installation of the TIFF software tools,

       •  the configuration of the getty programs invoked for data and voice calls,

       •  the pathnames for various system programs used by server shell scripts,

       •  proper support for FIFO special files,

       •  proper installation of a POSTSCRIPT RIP,

       •  definition of a ``fax'' user,

       •  definitions for the ``hylafax'' and ``snpp'' services,

       •  startup of the HylaFAX server processes: faxq(8) and hfaxd(8),

       •  definition of a ``FaxMaster'' mail alias for reporting server problems.

       For server machines faxsetup also creates two files that are required by  the  HylaFAX  command  scripts.
       One  file  contains  master  configuration  parameters and the other contains various definitions used by
       scripts such as faxaddmodem(8) that communicate with modems.

OPTIONS

       -client   Do client-specific consistency checks.

       -server   Do server-specific consistency checks.

       -with-VAR[=value]
                 Override  the  default  definition  for  the  configuration  parameter  named  VAR;  optionally
                 specifying  a  new  value  (if  no  value  is  specified then ``yes'' is used).  This option is
                 especially useful to override the default settings for the POSTSCRIPT  interpreter  package  to
                 use   (e.g.   ``-with-PS=dps''),  the  spooling  directory  (``-with-DIR_SPOOL=/mumble''),  the
                 directory where the tool applications of  TIFF  software  distribution  are  located  (``-with-
                 TIFFBIN=/usr/freeware''),  etc.   A  complete  list  of the possible parameters can be found by
                 looking at the contents of the faxsetup shell script; many of  these  configuration  parameters
                 are also described in the online documentation

       -help     Print a help message and terminate.

       -quiet    Do not print verbose messages to the terminal.

       -verbose  Print informative messages to the terminal (default).

BUGS

       faxsetup  does not query a modem to find out its capabilities when invoking the faxmodem program to setup
       a server in a send-only configuration; it may be necessary to run faxmodem manually.

FILES

       /var/spool/hylafax/etc/setup.cache    master configuration parameters
       /var/spool/hylafax/etc/setup.modem    modem-related configuration support

       Consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area.

SEE ALSO

       hylafax-server(5), hylafax-config(5), faxq(8), faxgetty(8), faxmodem(8), faxconfig(8), faxsend(8)

                                                 August 26, 1996                                     FAXSETUP(8)