GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
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 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(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 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(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 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(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 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

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.