PAGESEND(8C)PAGESEND(8C)NAMEpagesend - HylaFAX IXO/TAP and UCP transmit program
SYNOPSIS
/usr/contrib/lib/hylafax/pagesend [ -l ] [ -p ] [ -c con-
fig ] -m device-ID qfile
DESCRIPTIONpagesend is the program that implements the IXO/TAP and
the UCP transmission protocol for the HylaFAX system.
pagesend is invoked by the faxq scheduler process for each
pager transmit attempt. pagesend assumes that its current
working directory is the top of the spooling hierarchy and
that a suitable modem device has been allocated for its
use. In normal use pagesend will inherit a lockfile for
the modem from the faxq process. The format of the job
description file specified on the command line is
described in sendq(5F).
pagesend initializes the modem before attempting to trans-
mit the pager message using the information in the appro-
priate modem configuration file. If the modem does not
respond to this initialization, pagesend 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 prop-
erly initialized state). pagesend catches SIGINT and
SIGTERM and cleans up any resources it controls; this is
the mechanism used by faxq to abort a job while it is in
progress.
Many aspects of pagesend 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
information on the contents of configuration files.
The protocol which must be used for a specific service
provider is controled from the info(5F) file.
OPTIONS-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
PAGESEND(8C)PAGESEND(8C)
any ``/'' characters to ``_'' characters.
-l Do the UUCP lockfile protocol in pagesend. By
default pagesend 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 pagesend will raise its pri-
ority to reduce i/o latency. This option is
useful for debugging.
NOTESpagesend 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), info(5F)
October 3, 1995 2
