FAXSETUP(8C)
NAME
faxsetup - setup a machine for use with HylaFAX
SYNOPSIS
/usr/local/sbin/faxsetup [ -client ] [ -server ] [ -with-
VAR[=value] ]
DESCRIPTION
faxsetup is an interactive shell script that does the nec-
essary 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 func-
tion-if a HylaFAX server program or script is invoked
before faxsetup is run, the command will abort with a mes-
sage that says to run faxsetup. faxsetup may optionally
be run on a HylaFAX client machine to verify the configu-
ration 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) infor-
mation files used by the HylaFAX text formatting sup-
port.
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(8C) and
hfaxd(8C),
+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 configuration parameters and the other
contains various definitions used by scripts such as fax-
addmodem(8C) 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 configu-
ration parameter named VAR; optionally specify-
ing 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-TIFF-
BIN=/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 HTML 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 capabili-
ties 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/fax/etc/setup.cache master configuration parameters
/var/spool/fax/etc/setup.modem modem-related configuration support
Consult hylafax(5F) for a complete discussion of the
structure and content of the spooling area.
SEE ALSO
hylafax(5F) config(5F) faxq(8C) faxgetty(8C) faxmo-
dem(8C) faxconfig(8C) faxsend(8C)