PAGESEND(8C)

NAME
       pagesend - HylaFAX IXO/TAP and UCP transmit program

SYNOPSIS
       /usr/local/sbin/pagesend  [  -l  ] [ -p ] [ -c config ] -m
       device-ID qfile

DESCRIPTION
       pagesend 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
                 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.

NOTES
       pagesend  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(5F)  for  a  complete  discussion  of the
       structure and content of the spooling area.

SEE ALSO
       faxq(8C) hylafax(5F) config(5F) info(5F)