FAXSEND(8C)

NAME
       faxsend - HylaFAX facsimile transmit program

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

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

NOTES
       faxsend 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)