FAXSETUP(8)                                                   System Manager's Manual                                                  FAXSETUP(8)

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 soft-
       ware.  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:

       o  the installation of client programs and data,

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

       Server-specific checks include:

       o  the installation of server programs and data,

       o  the existence of the UUCP lock file directory,

       o  the installation of the TIFF software tools,

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

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

       o  proper support for FIFO special files,

       o  proper installation of a POSTSCRIPT RIP,

       o  definition of a ``fax'' user,

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

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

       o  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  configura-
       tion 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  inter-
                 preter 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 configura-
       tion; 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)