NAME

       faxsend - HylaFAX facsimile transmit program

SYNOPSIS

       /usr/sbin/faxsend [ -l ] [ -p ] [ -c config ] -m device-ID qfile [qfile [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 working 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 process.  The format of the job description file specified
       on the command line is described in sendq(5).

       faxsend  initializes  the  modem before attempting to transmit 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(8) 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 mechanism used by
       faxq to abort a job while it is in progress.

       Multiple fax jobs of documents with varying formatting may be sent in one fax call by  ``batching''  them
       by supplying faxsend with multiple qfile entries.

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

OPTIONS

       The following options are recognized:

       -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 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 transmitting.  Normally faxsend will raise its priority
                 to reduce i/o latency.  This option is useful for debugging.

NOTES

       faxsend returns the new job  status  to  faxq  through  the  returned  value  in  the  associated  qfile:
       send_retry,  retry job; send_failed, job finished without success, send_done, job completed successfully,
       send_reformat, 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)

                                                 October 3, 1995                                      FAXSEND(8)