is an interactive shell script that does the
necessary setup work to configure a client or server machine
for the HylaFAX software.
must be run on every HylaFAX server machine before the software
will function-if a HylaFAX server program or script is invoked before
is run, the command will abort with a message that says to run
may optionally be run on a HylaFAX client machine to verify the
configuration of the software.
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:
definition of a ``FaxMaster'' mail alias for reporting server problems.
For server machines
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
that communicate with modems.
Do client-specific consistency checks.
Do server-specific consistency checks.
Override the default definition for the configuration parameter named
optionally specifying a new
(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
software distribution are located (``-with-TIFFBIN=/usr/freeware''),
A complete list of the possible parameters can be found by looking
at the contents of the
many of these configuration parameters are also
described in the
Print a help message and terminate.
Do not print verbose messages to the terminal.
Print informative messages to the terminal (default).
does not query a modem to find out its capabilities when invoking the
program to setup a server in a send-only configuration; it may be
necessary to run
/var/spool/hylafax/etc/setup.cache master configuration parameters
/var/spool/hylafax/etc/setup.modem modem-related configuration support
for a complete discussion of the structure and
content of the spooling area.