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

greenie                                             27 Oct 93                                         sendfax(8)