FAXQ(8C)FAXQ(8C)NAMEfaxq - HylaFAX queue manager process
SYNOPSIS
/usr/contrib/lib/hylafax/faxq [ -D ] [ -q queue-dir ]
DESCRIPTIONfaxq is the central queueing agent for HylaFAX. One (and
only one) faxq process is normally running at all times.
faxq is responsible for scheduling, preparing, and initi-
ating outbound facsimile jobs (and potentially other types
of jobs as well).
faxq may be run by itself to provide outbound-only ser-
vices or it may be run together with one or more
faxgetty(8C) processes, in which case inbound services
(e.g. receiving facsimile) are provided. When faxq is run
by itself the set of available modems must be specified
using the faxmodem(8C) command. Each modem specified in
this way is assumed to exist and to be capable of use as a
facsimile modem. When faxq is run in conjunction with
faxgetty processes, it is not necessary to use faxmodem to
specify modems; instead the programs communicate informa-
tion 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.
faxq receives notification of outbound jobs to process
from the hfaxd(8C) process that implements the server-side
of the HylaFAX client-server protocol. Notification is
through messages sent to a FIFO special file that faxq
listens to. This file is also used by other administra-
tive programs such as faxquit(8C).
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 con-
fig.devid); consult config(5F) 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(8C)
program. Beware however that parameters changed in this
way will be reset to the values specified in the configu-
ration file if the file is re-read.
OPTIONS-q dir The specified directory is treated as the spool-
ing area. The default spooling area,
/var/spool/fax, is defined at the time the soft-
ware is built.
-D This option forces faxq to remain attached to
October 27, 1995 1
FAXQ(8C)FAXQ(8C)
the controlling tty from which it was invoked.
In normal operation faxq will fork(2) and dis-
sassociate itself from the controlling tty.
This option is useful for debugging.
FILES
/var/spool/fax/FIFO FIFO special file for submitting commands
/var/spool/fax/etc/config configuration file
Consult hylafax-server(5F) for a complete discussion of
the structure and content of the spooling area.
SEE ALSOfaxabort(8C), faxconfig(8C), faxmodem(8C), faxquit(8C),
faxstate(8C), getty(8C), hylafax-server(5F), config(5F).
October 27, 1995 2