1FAXSETUP(8C) FAXSETUP(8C)
2
6 faxsetup - setup a machine for use with HylaFAX
7
9 /usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ]
10
12 faxsetup is an interactive shell script that does the necessary setup
13 work to configure a client or server machine for the HylaFAX software.
14 faxsetup must be run on every HylaFAX server machine before the soft‐
15 ware will function-if a HylaFAX server program or script is invoked
16 before faxsetup is run, the command will abort with a message that says
17 to run faxsetup. faxsetup may optionally be run on a HylaFAX client
18 machine to verify the configuration of the software.
19 By default faxsetup checks a machine for use both as a HylaFAX client
21 and server. Client-specific checks include:
22 · the installation of client programs and data,
24 · the installation of the Adobe Font Metric (AFM) information files
26 used by the HylaFAX text formatting support.
27 Server-specific checks include:
29 · the installation of server programs and data,
31 · the existence of the UUCP lock file directory,
33 · the installation of the TIFF software tools,
35 · the configuration of the getty programs invoked for data and voice
37 calls,
38 · the pathnames for various system programs used by server shell
40 scripts,
41 · proper support for FIFO special files,
43 · proper installation of a POSTSCRIPT RIP,
45 · definition of a ``fax'' user,
47 · definitions for the ``hylafax'' and ``snpp'' services,
49 · startup of the HylaFAX server processes: faxq(8C) and hfaxd(8C),
51 · definition of a ``FaxMaster'' mail alias for reporting server prob‐
53 lems.
54 For server machines faxsetup also creates two files that are required
56 by the HylaFAX command scripts. One file contains master configuration
57 parameters and the other contains various definitions used by scripts
58 such as faxaddmodem(8C) that communicate with modems.
59
61 -client Do client-specific consistency checks.
62 -server Do server-specific consistency checks.
64 -with-VAR[=value]
66 Override the default definition for the configuration parame‐
67 ter named VAR; optionally specifying a new value (if no value
68 is specified then ``yes'' is used). This option is espe‐
69 cially useful to override the default settings for the POST‐
70 SCRIPT interpreter package to use (e.g. ``-with-PS=dps''),
71 the spooling directory (``-with-DIR_SPOOL=/mumble''), the
72 directory where the tool applications of TIFF software dis‐
73 tribution are located (``-with-TIFFBIN=/usr/freeware''), etc.
74 A complete list of the possible parameters can be found by
75 looking at the contents of the faxsetup shell script; many of
76 these configuration parameters are also described in the HTML
77 documentation
78 -help Print a help message and terminate.
80 -quiet Do not print verbose messages to the terminal.
82 -verbose Print informative messages to the terminal (default).
84
86 faxsetup does not query a modem to find out its capabilities when
87 invoking the faxmodem program to setup a server in a send-only configu‐
88 ration; it may be necessary to run faxmodem manually.
89
91 /var/spool/hylafax/etc/setup.cache master configuration parameters
92 /var/spool/hylafax/etc/setup.modem modem-related configuration support
93 Consult hylafax-server(5F) for a complete discussion of the structure
95 and content of the spooling area.
96
98 hylafax-server(5F), hylafax-config(5F), faxq(8C), faxgetty(8C), faxmo‐
99 dem(8C), faxconfig(8C), faxsend(8C)
100 August 26, 1996 FAXSETUP(8C)