sendfax(8)
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>.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
