Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FAXQ(8C)							      FAXQ(8C)

       faxq - HylaFAX queue manager process

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

       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 po-
       tentially 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(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 fax-
       modem  to  specify modems; instead the programs communicate information
       about the status	and capabilities of each modem.	 The latter setup pro-
       vides 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 administrative programs such as faxquit(8C).

       Many aspects of faxq operation may be controlled	through	 a  configura-
       tion  file.   This  file	is located in the spooler hierarchy in the etc
       subdirectory and	is named config	(as opposed to the per-modem  configu-
       ration  files  named  config.devid); consult hylafax-config(5F) for de-
       tailed information on this configuration	file.  Note that faxq automat-
       ically  re-reads	 its configuration file	if it has been changed.	 It is
       also possible to	dynamically change configuration parameters in a  run-
       ning  process  with the faxconfig(8C) program.  Beware however that pa-
       rameters	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.

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

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

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

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

			       October 27, 1995			      FAXQ(8C)


Want to link to this manual page? Use this URL:

home | help