Manual Reference Pages - FAXSEND (8)
faxsend - HylaFAX facsimile transmit program
-l ] [
-p ] [
qfile [qfile [qfile [...]]]
faxsend is the program that implements the facsimile transmission protocol
for the HylaFAX system.
faxsend is invoked by the
faxq scheduler process for each facsimile transmit attempt.
faxsend assumes that its current working directory is the top of
the spooling hierarchy, that a suitable modem device
has been allocated for its use, and that all documents
to be sent are already converted to
TIFF Class F) at the appropriate resolution and with an appropriate
In normal use
faxsend will inherit a lockfile for the modem from the
The format of the job description file specified on the
command line is described in
faxsend initializes the modem before attempting to transmit the facsimile
using the information in the appropriate modem configuration file.
If the modem does not respond to this initialization,
faxsend will repeatedly try to initialize the modem.
This behaviour is required for send-only environments in which a
process is not run (and the modem would be known to be in a
properly initialized state).
SIGTERM and cleans up any resources it controls; this is the mechanism
faxq to abort a job while it is in progress.
Multiple fax jobs of documents with varying formatting may be sent in
one fax call by batching them by supplying faxsend with multiple
Many aspects of
faxsend operation are controlled through a configuration file.
The configuration file is located in the spooler hierarchy
etc subdirectory and is named
for detailed information on the contents of configuration files.
The following options are recognized:
-c config ||
config as a configuration parameter specification that is interpreted
after reading the per-device configuration file.
For example, -c sessiontracing:0x4f would set the
SessionTracing configuration parameter to 0x4f, overriding any setting in
the configuration file.
-m devID ||
The device to use in processing the job.
Note that this is a device identifier and not the
pathname of the tty special file.
A device identifier is formed from a device filename by removing
any leading /dev/ and converting any / characters to _
UUCP lockfile protocol in
faxsend. By default
faxsend assumes that it is invoked with the device already locked
and that it does not need to manage the lockfile.
Do not change the process priority when transmitting.
faxsend will raise its priority to reduce i/o latency.
This option is useful for debugging.
faxsend returns the new job status to
faxq through the
returned value in the associated qfile:
send_retry, retry job;
send_failed, job finished without success,
send_done, job completed successfully,
send_reformat, job should be retried after documents are reformatted.
/var/spool/hylafax/etc/config.devID device-specific configuration file
for a complete discussion of the structure and
content of the spooling area.
|--> ||FAXSEND (8C) ||October 3, 1995 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.