pagesend - HylaFAX
IXO/TAP and UCP transmit program
] [ -p
] [ -c config
] -m device-ID qfile
is the program that implements the IXO/TAP
transmission protocol for the HylaFAX
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
initializes the modem before attempting to transmit the pager
message using the information in the appropriate modem configuration file. If
the modem does not respond to this initialization, pagesend
repeatedly try to initialize the modem. This behaviour is required for
send-only environments in which a faxgetty
(8) process is not run (and
the modem would be known to be in a properly initialized state).
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
subdirectory and is named config.device-ID;
(5) for detailed information on the contents of
The protocol which must be used for a specific service provider is controled
from the hylafax-info
- -c config
- Treat 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 ``_'' characters.
- 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
- Do not change the process priority when transmitting.
Normally pagesend will raise its priority to reduce i/o latency.
This option is useful for debugging.
returns the new job status to faxq
(2) return value of the process: send_retry
(0), retry job;
(1), job finished without success, send_done
job completed successfully, send_reformat
(3), job should be retried
after documents are reformatted.
/var/spool/hylafax/etc/config.devID device-specific configuration file
(5) for a complete discussion of the structure and
content of the spooling area.