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)