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)