NAME

       faxq - HylaFAX queue manager process

SYNOPSIS

       /usr/sbin/faxq [ -D ] [ -q queue-dir ]

DESCRIPTION

       faxq  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 initiating outbound  facsimile  jobs  (and
       potentially other types of jobs as well).

       faxq  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
       is run by itself the set of available modems must be specified using the faxmodem(8) 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 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.

       faxq receives notification of outbound jobs to process from the  hfaxd(8)  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  administrative  programs  such  as
       faxquit(8).

       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);  consult  hylafax-config(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.

OPTIONS

       -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.

       -D        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.

FILES

       /var/spool/hylafax/FIFO          FIFO special file for submitting commands
       /var/spool/hylafax/etc/config    configuration file

       Consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area.

SEE ALSO

       faxabort(8),  faxconfig(8),  faxmodem(8),  faxquit(8), faxstate(8), getty(8), hylafax-server(5), hylafax-
       config(5).

                                                October 27, 1995                                         FAXQ(8)