1FAXQ(8C) FAXQ(8C)
2
6 faxq - HylaFAX queue manager process
7
9 /usr/sbin/faxq [ -D ] [ -q queue-dir ] [ -c config ]
10
12 faxq is the central queueing agent for HylaFAX. One (and only one)
13 faxq process is normally running at all times. faxq is responsible for
14 scheduling, preparing, and initiating outbound facsimile jobs (and
15 potentially other types of jobs as well).
16 faxq may be run by itself to provide outbound-only services or it may
18 be run together with one or more faxgetty(8C) processes, in which case
19 inbound services (e.g. receiving facsimile) are provided. When faxq is
20 run by itself the set of available modems must be specified using the
21 faxmodem(8C) command. Each modem specified in this way is assumed to
22 exist and to be capable of use as a facsimile modem. When faxq is run
23 in conjunction with faxgetty processes, it is not necessary to use fax‐
24 modem to specify modems; instead the programs communicate information
25 about the status and capabilities of each modem. The latter setup pro‐
26 vides a more robust and powerful system and is the intended way for the
27 software to operate.
28 faxq receives notification of outbound jobs to process from the
30 hfaxd(8C) process that implements the server-side of the HylaFAX
31 client-server protocol. Notification is through messages sent to a
32 FIFO special file that faxq listens to. This file is also used by
33 other administrative programs such as faxquit(8C).
34 Many aspects of faxq operation may be controlled through a configura‐
36 tion file. This file is located in the spooler hierarchy in the etc
37 subdirectory and is named config (as opposed to the per-modem configu‐
38 ration files named config.devid); consult hylafax-config(5F) for
39 detailed information on this configuration file. Note that faxq auto‐
40 matically re-reads its configuration file if it has been changed. It
41 is also possible to dynamically change configuration parameters in a
42 running process with the faxconfig(8C) program. Beware however that
43 parameters changed in this way will be reset to the values specified in
44 the configuration file if the file is re-read.
45
47 -q dir The specified directory is treated as the spooling area. The
48 default spooling area, /var/spool/hylafax, is defined at the
49 time the software is built.
50 -D This option forces faxq to remain attached to the controlling
52 tty from which it was invoked. In normal operation faxq will
53 fork(2) and disassociate itself from the controlling tty.
54 This option is useful for debugging.
55 -c config Treat config as a configuration parameter specification that
57 is interpreted after reading the configuration file. For
58 example, ``-c servertracing:0x4f'' would set the ServerTrac‐
59 ing configuration parameter to ``0x4f'', overriding any set‐
60 ting in the configuration file.
61
63 /var/spool/hylafax/FIFO FIFO special file for submitting commands
64 /var/spool/hylafax/etc/config configuration file
65 Consult hylafax-server(5F) for a complete discussion of the structure
67 and content of the spooling area.
68
70 faxabort(8C), faxconfig(8C), faxmodem(8C), faxquit(8C), faxstate(8C),
71 getty(8C), hylafax-server(5F), hylafax-config(5F).
72 October 27, 1995 FAXQ(8C)