NAME

       sendfax - send group 3 fax files (G3 files) with a class 2 faxmodem

SYNOPSIS

       sendfax  [-p]  [-x<debuglevel>] [-v] [-l<modemlines>] [-m<initstring>] [-d<polldirectory>]
       [-C<modemclass>] [-S] [-n] [-r] [-D<dialprefix>] phone-number [g3file(s)]

DESCRIPTION

       Send the named g3 fax files to the fax machine at "phone number".  The  g3  files  can  be
       created with pbm2g3(1) or GNU's GhostScript with the "digifax" driver.

OPTIONS

       -p     Tells  sendfax  to try fax polling, that is, get any documents queued in the remote
              fax machine for you (used for weather maps and the like)

       -x <debug level>
              Use the given level of verbosity for logging - 0 means  no  logging,  5  is  really
              noisy.

       -v     Give some progress report on stdout.

       -l <modem lines>
              Use  the  given  modem  lines.  Multiple  lines  can be separated by ":".  Example:
              sendfax -l tty1a:tty2a

       -m <initstring>
              Send an additional init string. This string is sent right  after  initializing  the
              modem  and setting it into class 2 mode. You can use this to set the speaker value,
              some special registers, whatsoever. The modem  must  return  "OK".  If  it  returns
              "ERROR",  sendfax  prints  an error message and aborts.  You do not have to prepend
              the "AT" prefix, but it won't do harm either.

       -d <directory>
              Specify the directory where polled fax files should go to. Defaults to "."  for the
              current directory. Unused if not polling a fax.

       -C <class>
              Tells  sendfax  how  to  treat  the  modem.  Possible values for <class> are "auto"
              (default, try to find out which fax command set the modem  supports),  "cls2"  (use
              the  class  2  fax  command set, even if the modem claims to support class 2.0) and
              "c2.0" (use the class 2.0 fax command set). Obviously, "data" (which is  valid  for
              "mgetty -C ...") is not of much use here.

       -S     Assume  modem  connection  on  stdin, do not try to lock or initialize anything. To
              take over existing connection (for interworking with vgetty et.al.) use with a dial
              string  of  "T1"  (just  a  short  beep,  no phone number at all would confuse many
              modems, a pulse dialed number may confuse the telco switch) and "-m ATX1"  (do  not
              wait for dial tone).

       -n     Tells  sendfax  to  send  the fax pages in ``normal'' (204x98 dpi) mode. Default is
              ``fine'' mode (204x196 dpi).

       -r     If  this  option  is  given,  sendfax  will  rename  all  the  fax  G3   files   to
              ``<filename>.done''  after  successfully  sending this. This is intended to be used
              from ``faxrunq'', to make sure that a partially-sended fax isn't retransmitted as a
              whole every time.

              If  this option is set, sendfax will not (!) complain if not all files named on the
              command line exist.

       -D <dial prefix>
              Override the default (set by sendfax.config or in policy.h) for the 'ATxxx' command
              to  dial  the  remote  number.   This is rarely used from the command line, but you
              might want to use it in combination with  faxrunqd's  policy  routing  option  (see
              example in faxrunqd.policy(5)).

       -M <max speed>
              Sets  the maximum transmission (modem to modem) speed.  This is only needed in very
              rare cases, because normally the modems negotiate the correct speed  automatically.
              Example: "-M 7200".

       -R <max tries>
              Sets  the maximum number of attempts to transmit a given page, before sendfax gives
              up on this page.  Normally it's not needed to change this - the default is "(up to)
              3 tries" and that works quite well for most environments.

CONFIG FILE

       If  compiled  accordingly,  sendfax can read all its configuration from at run-time from a
       file, usually called /etc/mgetty/sendfax.config. See the documentation in the  mgetty.info
       manual for details.

DIAGNOSTICS

       sendfax  returns  an  error  code, according to the reason why the program terminated.  If
       everything went OK, sendfax returns 0. If ``harmless'' errors (didn't cost money) occured,
       an  error  code below 10 is returned. If a dial attempt failed after the remote end picked
       up (it will cost money), a return code of 10 or higher is returned.

       In Detail, the return codes are as follows:

              0      all pages have been transmitted successfully

              1      error on the sendfax command line

              2      cannot open fax device (e.g. due to locked modem)

              3      cannot initialize modem (e.g. modem switched off)

              4      dialup failed with BUSY

              5      dialup failed with NO DIALTONE

              10     dialup failed with ERROR or NO CARRIER (modem handshake failed)

              11     waiting for XON failed (rarely seen)

              12     transmitting or polling page(s) failed (connection dropped)

       Very detailed debug information  is  written  to  the  log  file.   It  can  be  found  in
       "/var/log/mgetty/fax/sendfax.log".  If  it doesn't contain enough details, enhance the log
       level with the "-x" option to sendfax, e.g. "-x 5".

       Many of the common problems and solutions are discussed in the mgetty manual and the  FAQ.
       Please see the WWW page at http://alpha.greenie.net/mgetty/ for both.

REFERENCES

       The standard for Group 3 fax is defined in CCITT Recommendation T.4.

BUGS

       sendfax should be able to put a header on the page.

       sendfax should be able to read TIFF g3 input files.

SEE ALSO

       g3cat(1), pbm2g3(1), mgetty(1), faxspool(1), faxrunq(1), faxrunqd(8)

AUTHOR

       sendfax is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>.