FAXSEND(8C)FAXSEND(8C)NAMEfaxsend - HylaFAX facsimile transmit program
SYNOPSIS
/usr/contrib/lib/hylafax/faxsend [ -l ] [ -p ] [ -c config
] -m device-ID qfile
DESCRIPTIONfaxsend 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 work-
ing 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/F (TIFF Class F) at the appropriate resolution and
with an appropriate data encoding. In normal use faxsend
will inherit a lockfile for the modem from the faxq pro-
cess. The format of the job description file specified on
the command line is described in sendq(5F).
faxsend initializes the modem before attempting to trans-
mit 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 faxgetty(8C) process is
not run (and the modem would be known to be in a properly
initialized state). faxsend catches SIGINT and SIGTERM
and cleans up any resources it controls; this is the mech-
anism used by faxq to abort a job while it is in progress.
Many aspects of faxsend operation are controlled through a
configuration file. The configuration file is located in
the spooler hierarchy in the etc subdirectory and is named
config.device-ID; consult config(5F) for detailed informa-
tion on the contents of configuration files.
OPTIONS
The following options are recognized:
-c config Treat config as a configuration parameter speci-
fication that is interpreted after reading the
per-device configuration file. For example,
``-c sessiontracing:0x4f'' would set the Ses-
sionTracing 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
October 3, 1995 1
FAXSEND(8C)FAXSEND(8C)
any ``/'' characters to ``_'' characters.
-l Do the 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.
-p Do not change the process priority when trans-
mitting. Normally faxsend will raise its prior-
ity to reduce i/o latency. This option is use-
ful for debugging.
NOTESfaxsend returns the new job status to faxq through the
exit(2) return value of the process: send_retry (0), retry
job; send_failed (1), job finished without success,
send_done (2), job completed successfully, send_reformat
(3), job should be retried after documents are reformat-
ted.
FILES
/var/spool/fax/etc/config.devID device-specific config-
uration file
Consult hylafax-server(5F) for a complete discussion of
the structure and content of the spooling area.
SEE ALSOfaxq(8C), hylafax-server(5F), config(5F)
October 3, 1995 2