Provided by: hylafax-client_6.0.5-5ubuntu3_i386 bug

NAME

       sendfax - submit a facsimile job for transmission

SYNOPSIS

       sendfax [ options ] [ files...  ]

DESCRIPTION

       sendfax  submits  one  or  more  facsimile  transmission  requests to a
       HylaFAX facsimile server.  Requests are normally processed immediately,
       although they may also be queued for transmission at a later time using
       a syntax identical to the at(1) command.  For each job that is  queued,
       sendfax  prints  a  job  identifier  and  a job group identifier on the
       standard output.  A job identifier is  the  token  by  which  jobs  are
       identified  within HylaFAX; job group identifiers are used to reference
       a set of jobs that have been submitted at the same time.  Job  and  job
       group identifiers can be supplied to the faxrm(1) command to remove the
       jobs or to the faxalter(1) command to alter job parameters.

       Facsimile are made from the concatenation of a cover page  (see  below)
       and  one  or more files specified on the command line.  If no files are
       supplied on the command line, sendfax will read data from the  standard
       input  unless  polling is requested.  Cover pages are distinguished for
       the purpose of generating ``continuation cover pages'' on  the  server;
       these  are makeup cover pages that are automatically generated if a job
       fails after sending the original user-specified cover page.

       sendfax passes POSTSCRIPT(R) and TIFF documents directly through to the
       fax server for transmission, and attempts to convert other file formats
       to  either  POSTSCRIPT  or   TIFF.    In   normal   operation   sendfax
       automatically  converts  ASCII-text, troff(1) output, Portable Document
       Format (PDF), and Silicon  Graphics  format  images  for  transmission.
       Support  for  other  file  formats  can  be  easily  added  through  an
       extensible file typing and conversion facility; see typerules(5).  Note
       that  since  TIFF Class F documents are processed directly it is simple
       to forward a received facsimile.

       By default sendfax will generate a cover page for each  facsimile  that
       is  to  be  transmitted.   This  cover page is created by the ancillary
       faxcover(1)  program  using  information  deduced  by  sendfax  and  by
       information  supplied  on  the  command  line.   Automatic  cover  page
       generation may be suppressed with the -n option.

       In addition to sending documents, sendfax can be used to poll a  remote
       facsimile  machine  to retrieve waiting documents.  If the -p option is
       specified, a polling request will be submitted to each destination.  If
       a  poll  request  is  made  in  conjunction  with  the  transmission of
       documents, the poll request will take place  after  the  documents  are
       transmitted.   Documents  retrieved  by  polling  are  returned  to the
       requestor by electronic mail and may be viewed with a  suitable  viewer
       program.

       One  or  more  destinations must be specified on the command line using
       the -d option.  A destination is the dialing string to use  to  contact
       the  remote  fax  machine.   Phone numbers may include non-alphanumeric
       characters for readability--only alphanumerics, ``+'' (for  denoting  a
       country code), and ``#'' (for denoting a subaddress) are significant in
       placing a call.  Alphabetic  characters  are  automatically  mapped  to
       their  numeric  key  equivalents:  ``abcABC''  to  ``2'', ``defDEF'' to
       ``3'', etc.  Dialing prefixes, such as  ``1''  and  ``011''  (for  long
       distance  calling  in  the  United  States)  need not be included if an
       unambiguous number is specified.  Examples of unambiguous phone numbers
       are:
              +31.77.594.131      to call the Netherlands
              +14159657824        to call California
              9657824             to make a local call
              1-215-356-1666      to call Pennsylvania from within the US
       Non-numeric  strings,  such as ``*70'' (to defeat call waiting), may be
       included in the destination phone number.   Whether  or  not  they  are
       stripped  from  the  string used to dial the destination fax machine is
       dependent on the dialstring rules configured for  use  on  the  server;
       c.f.  hylafax-config(5) and dialrules(5).

       A  destination  may also be specified as user@fax-number.  In this case
       the user string will be passed to  faxcover  as  the  identity  of  the
       recipient.  Note that multi-word names must be enclosed in quote marks;
       for example, ``Sam Leffler@+1.415.555.1212''.

       The order of options on the command line is significant.  Each  fax  to
       be transmitted is assigned the current value of parameters specified on
       the command line; e.g. whether or not to generate a cover  page.   This
       means that options that specify parameters for a particular destination
       must precede the dialstring specified with the -d option.  For example,

              sendfax -n -d 5551212 /etc/passwd

       submits a fax to 5551212 that has no cover page while

              sendfax -d 5551212 -n /etc/passwd

       submits the same fax but with the default cover  page  handling.   Note
       also that parameter values persist across -d options so the following

              sendfax -n -d 5551212 -d 5551313 /etc/network

       submits two facsimile, both of which have no cover page.

OPTIONS

       -1          Transmit  facsimile documents using 1-D MH compression.  By
                   default HylaFAX will use  the  optimal  compression  scheme
                   supported by the transmitting modem and receiving facsimile
                   device.

       -2          Transmit facsimile documents using 2-D MR  compression,  if
                   possible.    By   default  HylaFAX  will  use  the  optimal
                   compression scheme supported by the transmitting modem  and
                   receiving facsimile device.

       -3          Transmit  facsimile documents using 2-D MMR compression, if
                   possible.   By  default  HylaFAX  will  use   the   optimal
                   compression  scheme supported by the transmitting modem and
                   receiving facsimile device.

       -a time     Schedule transmission up to one  year  in  advance  at  the
                   indicated  time.   Time is specified in the format: ``HH:MM
                   [AM|PM] | now [+ N period | month DD | dayofweek ]''  where
                   month  can be Jan(uary), Feb(ruary), Mar(ch), Apr(il), May,
                   Jun(e),   Jul(y),   Aug(ust),    Sep(tember),    Oct(ober),
                   Nov(ember),   or   Dec(ember);  period  can  be  minute(s),
                   hour(s), day(s), week(s), or  month(s);  dayofweek  can  be
                   Mon(day),  Tue(sday),  Wed(nesday),  Thu(rsday),  Fri(day),
                   Sat(urday), Sun(day); e.g. ``now + 30 minutes'' to schedule
                   transmission   30   minutes   in   the   future.   Trailing
                   information in the time field (such as  YYYY)  is  ignored.
                   By  default,  sendfax  schedules  facsimile  for  immediate
                   delivery.  Time should be given in the user's local time.

       -A          Archive the job on the server according to the  bin/archive
                   script when the job is done.

       -b speed    Transmit  facsimile  documents using a signalling rate that
                   is constrained to be at least speed  bits/second.   If  the
                   specified  speed  is greater than the transmitting modem or
                   receiver is capable  of,  it  is  reduced  to  the  highest
                   possible  speed  both  devices  support.   If  a negotiated
                   signalling rate greater than or equal to  speed  cannot  be
                   negotiated  then  the job is aborted.  Possible speeds are:
                   2400, 4800, 7200, 9600, 12000, 14400, 16800, 19200,  21600,
                   24000,  26400, 28800, 31200, and 33600.  By default HylaFAX
                   will  use  the  fastest  possible  rate  supported  by  the
                   transmitting modem and receiving facsimile device.

       -B speed    Try  to  transmit  facsimile  documents  using  the desired
                   signalling rate.  Possible speeds are:  2400,  4800,  7200,
                   9600,  12000,  14400,  16800,  19200,  21600, 24000, 26400,
                   28800, 31200, and 33600.  If the specified speed is greater
                   than  the  transmitting modem or receiver is capable of, it
                   is reduced to  the  highest  possible  speed  both  devices
                   support.   By default HylaFAX will use the fastest possible
                   rate supported by  the  transmitting  modem  and  receiving
                   facsimile   device   (unless  restricted  by  other  server
                   configuration); this option  can  be  used  to  reduce  the
                   speed.   Note  that international calls are frequently more
                   reliable  when  transmissions  are   restricted   to   9600
                   bits/second.   For  Class  1/1.0  devices, if the specified
                   speed is not greater than  14400  then  V.34  will  not  be
                   attempted,  and if the specified speed is 9600 or 7200 then
                   V.29 will be assumed in lieu of V.17.

       -c comments Pass comments to the faxcover(1) program for  inclusion  in
                   the comments field of any generated cover page.

       -C file     Pass  file  to the faxcover(1) program for use as the cover
                   page template.

       -D          Enable notification by electronic mail when  the  facsimile
                   has  been  delivered.   By  default HylaFAX will notify the
                   submitter only if there is a problem with a job.

       -d destination
                   Create a job  to  transmit  the  supplied  documents  to  a
                   facsimile  machine  at  the  indicated destination.  If the
                   destination is of the form ``user@phone-number#subaddress''
                   then  any  cover  page  will  show  user  as  the  intended
                   recipient, and the  remote  system  will  be  supplied  the
                   subaddress  value  (i.e.  for  routing)  provided  that the
                   sending modem and the receiving system support it.

       -E          Disable  use  of  the  Error  Correction  Mode  (ECM)  when
                   transmitting page data. Setting ECM to false will limit the
                   maximum speed  to  14400  bps.   By  default  HylaFAX  will
                   attempt  to  use  ECM  when both the transmitting modem and
                   receiving device support it.  Note that international calls
                   are  sometimes  faster  when  ECM is disabled.  Beware also
                   that some modems and/or facsimile devices do  not  properly
                   implement ECM causing transmission failures.

       -f from     Use   from   as  the  identity  of  the  facsimile  sender.
                   Otherwise the sender is the user that invoked sendfax.  The
                   sender  is  an  account  name to which the HylaFAX software
                   should direct notification messages.  The from identity may
                   be  a  fullblown  ``From:''  line,  e.g.   e.g.  ``Joe Blow
                   <joe@foo.com>''  and   ``joe@foo.com   (Joe   Blow)''   are
                   acceptable.   If  no  host-part  is  specified  in the from
                   string the local hostname is used.  This option  is  useful
                   when  sendfax is invoked on behalf of another user, such as
                   in the implementation of an electronic mail to fax gateway.

       -F format   Use the specified format when imaging tag lines on outgoing
                   pages.    Consult  the  description  of  the  TagLineFormat
                   parameter in hylafax-config(5) for an explanation of how to
                   construct a format string.

                   Note  that  many locales require that proper identification
                   appear  on  all  transmitted  facsimile;  when  using  this
                   facility  one  should  always include proper identification
                   (e.g. a phone number) in the imaged taglines.

       -G          Enable usage of any extended resolutions supported  by  the
                   receiver.  -G supersedes the usage of any -l or -m options.
                   Beware that increased resolution will increase transmission
                   time.

       -h [modem@]host[:port]
                   Force  the  jobs  to  be  processed on a specific host and,
                   optionally, using a particular  modem.   The  host  may  be
                   either  a  symbolic  name  or  a network address.  If no -h
                   option is supplied, sendfax uses the FAXSERVER  environment
                   variable  to  identify the HylaFAX server to which the jobs
                   should be directed.  If no server is specified then sendfax
                   attempts  to  contact  a  server  on the local host.  If no
                   modem is specified,  the  job  will  be  submitted  to  any
                   available modem.

       -i identifier
                   Use  the  identifier  string  in  any notification messages
                   instead of the usual job identifier number.  This option is
                   useful  for  applications that cross reference notification
                   messages against job submissions.

       -I time     If a job  must  be  requeued  because  of  a  communication
                   failure schedule the retry according to the specified time.
                   Times are given in seconds.  Minutes, hours, and  days  can
                   be  specified with ``min'', ``hour'', and ``day'' suffixes,
                   respectively.  By default HylaFAX  reschedules  jobs  using
                   retry  times  that  depend  on  the manner in which the job
                   failed; this interface permits  a  user  to  override  this
                   algorithm  and  specify  a  single fixed retry time for all
                   communication failures.

       -k time     Kill the job if it does not complete in the indicated time.
                   The  time  is  specified using notation identical to the -a
                   option.  Note that the time is relative to the time of  the
                   initial  time-to-send.   The default kill time is ``now + 3
                   hours'' (three  hours  from  the  time  the  job  is  first
                   processed).  To retry for an hour, ``now +1 hour'' could be
                   used.

       -l          Transmit the facsimile  at  a  vertical  resolution  of  98
                   lines/inch; otherwise known as low resolution.

       -m          Transmit  the  facsimile  at  a  vertical resolution of 196
                   lines/inch; otherwise known as medium  resolution  or  fine
                   mode.

       -M mst      Transmit  facsimile  documents  using the specified minimum
                   scanline time.  Possible times are: 0ms, 5ms, 10ms2,  10ms,
                   20ms2,  20ms,  40ms2,  and  40ms.  If the specified time is
                   less than the transmitting modem or receiver is capable of,
                   it  is  increased  to the lowest possible time both devices
                   support.  By default HylaFAX will use the  lowest  possible
                   time  supported  by  the  transmitting  modem and receiving
                   facsimile  device  (unless  restricted  by   other   server
                   configuration).    This   option   is   mostly  useful  for
                   debugging.

       -n          Suppress the automatic  generation  of  a  cover  page  for
                   subsequent  facsimile.   Note  that polling requests do not
                   receive a cover page unless  they  are  combined  with  the
                   transmission of one or more files.

       -N          Do  not  notify  the  sender  by  electronic  mail when the
                   facsimile has been delivered or requeued.

       -o owner    Specify the fax owner login  name,  replacing  any  FAXUSER
                   environment  variable that may be set for the same purpose.
                   If neither is specified, the user's current login  name  is
                   used.

       -p          Poll  each  destination  for any available documents.  If a
                   poll request is made together with  document  transmission,
                   the   poll  operation  is  done  after  the  documents  are
                   transmitted.  Documents received by polling are returned to
                   the sender by electronic mail.

       -P priority Assign  the  specified  scheduling  priority  to subsequent
                   jobs.  A priority is an integer value in the range [0-255].
                   Lower  values  result  in  higher  priority processing.  By
                   default, each job is assigned 127 for an initial scheduling
                   priority.   If  a job's priority is greater than bulk faxes
                   then the job's priority is raised (numerically lowered) for
                   each failed attempt to transmit so that retransmit attempts
                   are done ahead of newly submitted jobs.   In  the  case  of
                   bulk  faxes  (numerically  higher than 190), then the job's
                   priority is lowered (numerically raised)  for  each  failed
                   attempt  to  transmit  so that the whole of the bulk-queued
                   jobs  will  be  attempted  before  any  are  retried.   The
                   priority  may  also  be  specified  as one of the following
                   symbolic names: default  or  normal  (127),  bulk  or  junk
                   (191), low (190), or high (63).

       -R          Enable  notification  by electronic mail when the facsimile
                   has  been  delivered  and   when   it   is   requeued   for
                   retransmission.    By   default  HylaFAX  will  notify  the
                   submitter only if there is a problem with a job.

       -r regarding
                   Pass regarding to the faxcover(1) program as the  value  of
                   the ``Re:'' field of any generated cover page.

       -s size     Set  the  page  size  to use for the transmitted facsimile.
                   Facsimile are normally imaged with  a  system-default  page
                   size  (usually letter-size pages, 8.5" by 11", for sites in
                   North  America).   Alternate  page  sizes   are   specified
                   symbolically  using  either  the name or abbreviation of an
                   entry in the pagesizes(5) database; e.g.  a3 (ISO  A3),  a4
                   (ISO  A4),  a5  (ISO  A5), a6 (ISO A6), b4 (ISO B4), na-let
                   (North American Letter), us-leg  (American  Legal),  us-led
                   (American  Ledger),  us-exe  (American  Executive),  jp-let
                   (Japanese   Letter),   and   jp-leg    (Japanese    Legal).
                   Comparisons   are  case-insensitive  and  any  match  of  a
                   substring of the full page-size name  is  sufficient;  e.g.
                   ``legal'' would match ``American Legal''.

                   Note  that it may not be permissible to image into the full
                   page area; the guaranteed reproducible area for a  page  is
                   typically  inset.   Also,  note  that  while arbitrary page
                   sizes can be specified through the page size database, only
                   a limited set of page dimensions are supported by the Group
                   3 facsimile protocol.  Thus if  an  odd-size  facsimile  is
                   submitted  for  transmission  it  may  not  be  possible to
                   determine  if  it  can  be  sent  until  the   fax   server
                   establishes   communication   with   the  remote  facsimile
                   machine.

       -S tsi      Pass  tsi  to  the   server   as   the   suggested   sender
                   identification  to be used, for example, in tagline imaging
                   and fax protocol.

       -t tries    Make no more than tries attempts to send the facsimile.  By
                   default,  HylaFAX  will  terminate  a  job if 3 consecutive
                   attempts to send a particular page fail, or it appears  the
                   receiver  is  not  a  facsimile machine.  Otherwise HylaFAX
                   places no limit  on  the  number  of  attempts  to  send  a
                   facsimile, instead terminating a job if it is not completed
                   within a kill time timeout interval.  Note that a try is  a
                   call  in  which  carrier  is  established and the facsimile
                   protocol is commenced;  this  is  contrasted  with  a  call
                   attempt  that  might have failed because the line was busy.
                   Use ``-1'' to  indicate  that  no  tries  value  should  be
                   specified to the server.

       -T maxdials Make  no more than maxdials calls in attempting to send the
                   facsimile.  By default, HylaFAX will redial 12 times before
                   killing  a  job.   Use  ``-1'' to indicate that no maxdials
                   value should be specified to the server.

       -U voice-no Pass voice-no to the faxcover(1) program  as  the  sender's
                   voice number.

       -V voice-no Pass voice-no to the faxcover(1) program as the destination
                   person's voice number.

       -w          Wait for the job to  complete  before  ending  the  sendfax
                   session.   If this option is used, the sendfax process will
                   not terminate until the job is completed.

       -W fax-no   Pass fax-no to the faxcover(1) program as the sender's  fax
                   number.

       -x company  Pass  company to the faxcover(1) program as the destination
                   company name.

       -X company  Pass company to the faxcover(1)  program  as  the  sender's
                   company name.

       -y location Pass location to the faxcover(1) program as the destination
                   company's location.

       -Y location Pass location to the faxcover(1) program  as  the  sender's
                   company location.

       -z filename Read  destinations  from  filename which contains a list of
                   the destinations formatted identically as destinations  for
                   the  -d  option,  one  per  line.   Usage of this option is
                   similar to the -d option and may  be  done  in  conjunction
                   with other -d and -z options.

       -v          Print   information  on  the  standard  output  about  each
                   conversion and cover sheet generation  operation  it  does.
                   If  -v is specified twice, the protocol between sendfax and
                   the hfaxd server process that does the submission  work  on
                   the remote machine is also displayed.

       -Z range    Specify  that only certain pages of the fax should actually
                   be transmitted.  The range is in a comma-seperated list  of
                   ranges in the form of A[-B][,....].  The range is specified
                   agains the resulting document to be  faxed,  excluding  any
                   cover  pages.   So if you have more than one document, make
                   sure to account for them, and exclude the  cover  pages  in
                   the range specification.  Cover pages will always be faxed,
                   so a fax with a coverpage and 2 5  page  documents  with  a
                   range  specified  of of 1,3,10 will fax the cover page, and
                   pages 1, 3, and 10 of the combined documents (page 1 and  3
                   from   the  first  document,  and  page  5  of  the  second
                   document).

CONFIGURATION PARAMETERS

       sendfax   reads    configuration    information    from    the    files
       /etc/hylafax/hfaxd.conf,                        /etc/hylafax/hyla.conf,
       /etc/hylafax/sendfax.conf, and ~/.hylarc; in that  order,  with  later-
       read  settings  superseding  any  that  may  have been previously read.
       Configuration  files  follow  the  conventions  described  in  hylafax-
       client(1).   The  following  configuration  parameters  are recognized.
       Parameters marked with 1 are not available in /etc/hylafax/hfaxd.conf :
       Tag              Type       Default      Description
       AutoCoverPage    boolean    Yes          automatically generate cover page
       ChopThreshold    float      3.0          page chopping threshold
       CoverCmd         string     see below    pathname of cover sheet program
       Cover-Comments   string     -            cover page comments string
       Cover-Company1   string     -            cover page to-company name string
       Cover-Location1  string     -            cover page to-company location string
       Cover-Regarding  string     -            cover page regarding string
       Cover-Template   string     -            cover page template filename
       Cover-Voice1     string     -            cover page to-voice number string
       Cover-From-Company1         string       -cover page from-company string
       Cover-From-Location1        string       -cover page from-location string
       Cover-From-Voice1           string       -cover page from-voice number string
       Cover-From-Fax1  string     -            cover page from-fax number string
       DateFormat       string     -            cover page date format string
       DesiredEC        integer    2            desired type of ECM
       DesiredMST       string     -            desired minimum scanling time to use
       DesiredSpeed     integer    -            desired signalling rate to use
       DialRules        string     see below    file containing dialstring rules
       From             string     -            sender's identity
       HRes             float      204.         horizontal resolution
       Host             string     localhost    host to contact for service
       KillTime         string     -            time to expire job
       MailAddr         string     -            mail address for notification messages
       MaxDials         integer    12           times to retry dialing
       MaxTries         integer    3            times to retry transmission
       MinSpeed         integer    -            minimum acceptable signalling rate
       Modem            string     -            modem to use on server
       Notify           string     none         control email notification
       PageChop         string     default      control page chop handling
       PageLength       float      -            page length in millimeters
       PageSize         string     default      page size by name
       PageWidth        float      -            page width in millimeters
       PassiveMode      boolean    false        whether or not to use passive mode
       Port             integer    4559         port to use in contacting server
       Priority         string     default      job scheduling priority
       Protocol         string     tcp          protocol to use in contacting server
       RetryTime        string     -            delay between failed attempts to send
       SendTime         string     -            time to send job
       TagLine          string     -            tagline format string
       TypeRules        string     see below    file containing file typing rules
       VRes             float      98.          vertical resolution
       Verbose          boolean    No           whether or not to enable protocol tracing

       The   configuration   parameters   are   explained   below.     Certain
       configuration   parameters,   notably  those  for  setting  strings  on
       automatically generated cover pages, are  defined  mainly  for  use  by
       other HylaFAX programs that share common code used by sendfax.

       AutoCoverPage   Control  whether  or  not a cover page is automatically
                       generated for each job.  (Equivalent to the -n option.)

       ChopThreshold   The amount of white space,  in  inches,  that  must  be
                       present  at  the  bottom  of a page before HylaFAX will
                       attempt to truncate the page transmission.

       CoverCmd        The absolute pathname of the program to use to generate
                       cover  pages.   The  default  cover  sheet  program  is
                       /usr/bin/faxcover.

       Cover-Comments  The comments string to pass to the cover sheet  program
                       when auto-generating cover pages.

       Cover-Company   The  to-company  name string to pass to the cover sheet
                       program when auto-generating cover pages.

       Cover-Location  The to-company location string to  pass  to  the  cover
                       sheet program when auto-generating cover pages.

       Cover-Regarding The regarding string to pass to the cover sheet program
                       when auto-generating cover pages.

       Cover-Template  The absolute pathname of a cover sheet template file to
                       use in auto-generating cover pages.

       Cover-Voice     The  to-voice  number string to pass to the cover sheet
                       program when auto-generating cover pages.

       Cover-From-Company
                       The from-company name string to pass to the cover sheet
                       program when auto-generating cover pages.

       Cover-From-Location
                       The  from-location  string  to  pass to the cover sheet
                       program when auto-generating cover pages.

       Cover-From-Voice
                       The from-voice number string to pass to the cover sheet
                       program when auto-generating cover pages.

       Cover-From-Fax  The  from-fax  number string to pass to the cover sheet
                       program when auto-generating cover pages.

       DateFormat      The strftime(3) format string to pass to the cover page
                       command when auto-generating cover pages.

       DesiredEC       Which  type of the optional Error Correct Mode (ECM) to
                       use when transmitting facsimile.  0 to disable,  1  for
                       64-byte ECM, and 2 for 256-byte ECM (default).

       DesiredMST      The   desired   minimum   scanline  time  to  use  when
                       transmitting facsimile.  (Equivalent to the -M option.)

       DesiredSpeed    The  desired  signalling   rate   to   the   use   when
                       transmitting facsimile.  (Equivalent to the -B option.)

       DialRules       The   name   of  the  file  containing  the  dialstring
                       processing  rules  to  when  preparing  an   externally
                       visible representation of the dialstring (e.g. to strip
                       credit   card   numbers).    By   default    this    is
                       /etc/hylafax/dialrules.

       From            The sender's identity.  (Equivalent to the -f option.)

       Host            The host to contact for service.  (Equivalent to the -h
                       option.)

       HRes            The horizontal  resolution  to  use  when  transmitting
                       facsimile.  (NB: this currently has no effect.)

       KillTime        The expiration time to assign to each job.  (Equivalent
                       to the -k option.)

       MailAddr        The electronic  mail  address  to  direct  notification
                       messages  from the server.  If this string is specified
                       without an ``@hostname'' part then the  local  hostname
                       will  automatically be appended.  (Equivalent to the -f
                       option.)

       MaxDials        The maximum number of times to dial the phone for  each
                       job.  (Equivalent to the -T option.)

       MaxTries        The  maximum  number  of  times to retry sending a job.
                       (Equivalent to the -t option.)

       MinSpeed        The minimum acceptable  signalling  rate  to  use  when
                       transmitting facsimile.  (Equivalent to the -b option.)

       Modem           The  modem to use on the server.  (Equivalent to the -h
                       option.)

       Notify          Control  the  email  notification  messages  from   the
                       server.   This string may be one of ``done'', ``none'',
                       ``requeued''  or   ``default''   with   an   optionally
                       preceding  ``when  ''  (e.g. ``when done'').  Note that
                       ``when requeued'' implies ``when  done''.   (Equivalent
                       to the -D, -R, and -N options.)

       PageChop        Control page chop handling when transmitting facsimile.
                       This string may be one of ``none'', ``all'', or ``last'
                       to  have  no  pages chopped, all pages chopped, or only
                       the last page chopped; respectively.  Page chopping  is
                       controlled by the ChopThreshold parameter.

       PageLength      Set the transmitted page length in millimeters.

       PageSize        Set  the  page  dimensions according to an entry in the
                       pagesizes(5) database.  (Equivalent to the -s option.)

       PageWidth       Set the transmitted page width in millimeters.

       PassiveMode     Whether or not to use  passive  mode  in  communication
                       with the server.

       Port            The  network  port to contact for service.  (Equivalent
                       to the -h option.)

       Priority        The  scheduling  priority  to  assign  to   each   job.
                       (Equivalent to the -P option.)

       Protocol        The  name  of  the  communication  protocol to use when
                       contacting a server.   (Equivalent  to  the  FAXSERVICE
                       environment variable.)

       RetryTime       The  time  to  delay  between  job  retries  due  to  a
                       communication failure.  (Equivalent to the -I option.)

       SendTime        The time to send jobs.  (Equivalent to the -a option.)

       TagLine         The tagline format  string  to  use  when  transmitting
                       facsimile.  (Equivalent to the -F option.)

       TypeRules       The  name  of  the file containing file type conversion
                       rules.  By default this is /etc/hylafax/typerules.

       Verbose         Control  protocol  tracing.   (Equivalent  to  the  -vv
                       option.)

       VRes            Set  the  vertical resolution in lines/inch to use when
                       transmitting facsimile.  (Equivalent to the -m  and  -l
                       options.)

DIAGNOSTICS

       The following messages are generated because of problems encountered on
       the local machine.

       Could not call server.  The facsimile server on the remote machine  did
       not respond.

       No  input  data; transmission aborted.  No data was supplied (typically
       on the standard input).  No facsimile will be sent.

       Error converting data; command was  %s."  A data  conversion  operation
       failed; the shell command that was used is printed.

       Can  not convert %s.  Data needed to be converted for transmission, but
       the required conversion rule was not located.  This may  indicate  that
       the HylaFAX software was incorrectly installed; or perhaps that an NFS-
       mounted directory is temporarily unavailable.

       %s: Can not determine file type.  sendfax was unable to deduce the type
       of the file.

       %s:  Not  a  regular  file.  The file is something other than a regular
       file; for example, a directory.

       The following messages may  be  printed  by  sendfax.   These  messages
       describe  problems  encountered  by  the  server  process on the remote
       machine.  This list is incomplete; other messages may be  generated  by
       the server under unusual circumstances.

FILES

       ~/.hylarc                    per-user configuration file
       /etc/hylafax/hyla.conf       system-wide configuration file
       /etc/hylafax/sendfax.conf    system-wide configuration file
       /etc/hylafax/typerules       file type and conversion rules
       /etc/hylafax/pagesizes       page size database
       /etc/hylafax/dialrules       optional client dialstring rules
       /usr/bin/faxcover            for generating cover sheets
       /usr/sbin/textfmt            for converting text to PostScript
       /usr/sbin/sgi2fax            for converting SGI RGB images
       /var/spool/hylafax/tmp/sndfaxXXXXXXtemporary files

SEE ALSO

       at(1),   hylafax-client(1),   faxalter(1),   faxcover(1),   faxmail(1),
       faxrm(1),  faxstat(1),  sgi2fax(1),  textfmt(1),   hfaxd(8),   hylafax-
       server(5), typerules(5)

                               January 06, 2001                     SENDFAX(1)