Provided by: hylafax-server_6.0.3-5.1ubuntu1_i386 bug

NAME

       pagesend - HylaFAX IXO/TAP and UCP transmit program

SYNOPSIS

       /usr/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(5).

       pagesend 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
       will  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).   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  hylafax-config(5)  for detailed information on the contents of
       configuration files.

       The protocol which must be used for  a  specific  service  provider  is
       controled from the hylafax-info(5) file.

OPTIONS

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

       -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  transmitting.
                 Normally pagesend will  raise  its  priority  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
       reformatted.

FILES

       /var/spool/hylafax/etc/config.devID     device-specific   configuration
       file

       Consult hylafax-server(5) for a complete discussion  of  the  structure
       and content of the spooling area.

SEE ALSO

       faxq(8), hylafax-server(5), hylafax-config(5), hylafax-info(5)

                                October 3, 1995                    PAGESEND(8)