faxq - HylaFAX
queue manager process
] [ -q queue-dir
is the central queueing agent for HylaFAX
. One (and only one)
process is normally running at all times. faxq
responsible for scheduling, preparing, and initiating outbound facsimile jobs
(and potentially other types of jobs as well).
may be run by itself to provide outbound-only services or it may be
run together with one or more faxgetty
(8) processes, in which case
inbound services (e.g. receiving facsimile) are provided. When faxq
run by itself the set of available modems must be specified using the
(8) command. Each modem specified in this way is assumed to
exist and to be capable of use as a facsimile modem. When faxq
in conjunction with faxgetty
processes, it is not necessary to use
to specify modems; instead the programs communicate
information about the status and capabilities of each modem. The latter setup
provides a more robust and powerful system and is the intended way for the
software to operate.
receives notification of outbound jobs to process from the
(8) process that implements the server-side of the HylaFAX
client-server protocol. Notification is through messages sent to a
special file that faxq
listens to. This file is
also used by other administrative programs such as faxquit
Many aspects of faxq
operation may be controlled through a configuration
file. This file is located in the spooler hierarchy in the etc
subdirectory and is named config
(as opposed to the per-modem
configuration files named config.devid);
(5) for detailed information on this configuration file.
Note that faxq
automatically re-reads its configuration file if it has
been changed. It is also possible to dynamically change configuration
parameters in a running process with the faxconfig
(8) program. Beware
however that parameters changed in this way will be reset to the values
specified in the configuration file if the file is re-read.
- -q dir
- The specified directory is treated as the spooling area.
The default spooling area, /var/spool/hylafax, is defined at the
time the software is built.
- This option forces faxq to remain attached to the
controlling tty from which it was invoked. In normal operation faxq
will fork(2) and disassociate itself from the controlling tty. This
option is useful for debugging.
/var/spool/hylafax/FIFO FIFO special file for submitting commands
/var/spool/hylafax/etc/config configuration file
(5) for a complete discussion of the structure and
content of the spooling area.