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

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)