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