1FAXSETUP(8C)                                                      FAXSETUP(8C)
2
3
4

NAME

6       faxsetup - setup a machine for use with HylaFAX
7

SYNOPSIS

9       /usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ]
10

DESCRIPTION

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
20       By  default  faxsetup checks a machine for use both as a HylaFAX client
21       and server.  Client-specific checks include:
22
23       ·  the installation of client programs and data,
24
25       ·  the installation of the Adobe Font Metric  (AFM)  information  files
26          used by the HylaFAX text formatting support.
27
28       Server-specific checks include:
29
30       ·  the installation of server programs and data,
31
32       ·  the existence of the UUCP lock file directory,
33
34       ·  the installation of the TIFF software tools,
35
36       ·  the  configuration  of the getty programs invoked for data and voice
37          calls,
38
39       ·  the pathnames for various  system  programs  used  by  server  shell
40          scripts,
41
42       ·  proper support for FIFO special files,
43
44       ·  proper installation of a POSTSCRIPT RIP,
45
46       ·  definition of a ``fax'' user,
47
48       ·  definitions for the ``hylafax'' and ``snpp'' services,
49
50       ·  startup of the HylaFAX server processes: faxq(8C) and hfaxd(8C),
51
52       ·  definition  of a ``FaxMaster'' mail alias for reporting server prob‐
53          lems.
54
55       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

OPTIONS

61       -client   Do client-specific consistency checks.
62
63       -server   Do server-specific consistency checks.
64
65       -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
79       -help     Print a help message and terminate.
80
81       -quiet    Do not print verbose messages to the terminal.
82
83       -verbose  Print informative messages to the terminal (default).
84

BUGS

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

FILES

91       /var/spool/hylafax/etc/setup.cache    master configuration parameters
92       /var/spool/hylafax/etc/setup.modem    modem-related configuration support
93
94       Consult hylafax-server(5F) for a complete discussion of  the  structure
95       and content of the spooling area.
96

SEE ALSO

98       hylafax-server(5F),  hylafax-config(5F), faxq(8C), faxgetty(8C), faxmo‐
99       dem(8C), faxconfig(8C), faxsend(8C)
100
101
102
103                                August 26, 1996                   FAXSETUP(8C)
Impressum