1FAXQ(8C)                                                              FAXQ(8C)


6       faxq - HylaFAX queue manager process


9       /usr/sbin/faxq [ -D ] [ -q queue-dir ] [ -c config ]


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).
17       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.
29       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).
35       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.


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


63       /var/spool/hylafax/FIFO          FIFO special file for submitting commands
64       /var/spool/hylafax/etc/config    configuration file
66       Consult hylafax-server(5F) for a complete discussion of  the  structure
67       and content of the spooling area.


70       faxabort(8C),  faxconfig(8C),  faxmodem(8C), faxquit(8C), faxstate(8C),
71       getty(8C), hylafax-server(5F), hylafax-config(5F).
75                               October 27, 1995                       FAXQ(8C)