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 val­
              ues 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.

              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 suc­
              cessfully 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 (!) com­
              plain 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 com­
              mand line, but you might want to use it in combina­
              tion  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".


CONFIG FILE

       If compiled accordingly, sendfax can read all its configu­
       ration from  at  run-time  from  a  file,  usually  called
       /etc/mgetty+sendfax/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.
       See mgetty.info for more details.

       file.   It  can  be found in "/var/log/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 Recommen­
       dation 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)


AUTHOR

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


Man(1) output converted with man2html