1sendfax(8) mgetty+sendfax manual sendfax(8)
2
6 sendfax - send group 3 fax files (G3 files) with a class 2 faxmodem
7
9 sendfax [-p] [-x<debuglevel>] [-v] [-l<modemlines>] [-m<initstring>]
10 [-d<polldirectory>] [-C<modemclass>] [-S] [-n] [-r] [-D<dialprefix>]
11 phone-number [g3file(s)]
12
14 Send the named g3 fax files to the fax machine at "phone number". The
15 g3 files can be created with pbm2g3(1) or GNU's GhostScript with the
16 "digifax" driver.
17
19 -p Tells sendfax to try fax polling, that is, get any documents
20 queued in the remote fax machine for you (used for weather maps
21 and the like)
22 -x <debug level>
24 Use the given level of verbosity for logging - 0 means no log‐
25 ging, 5 is really noisy.
26 -v Give some progress report on stdout.
28 -l <modem lines>
30 Use the given modem lines. Multiple lines can be separated by
31 ":". Example: sendfax -l tty1a:tty2a
32 -m <initstring>
34 Send an additional init string. This string is sent right after
35 initializing the modem and setting it into class 2 mode. You can
36 use this to set the speaker value, some special registers, what‐
37 soever. The modem must return "OK". If it returns "ERROR", send‐
38 fax prints an error message and aborts. You do not have to
39 prepend the "AT" prefix, but it won't do harm either.
40 -d <directory>
42 Specify the directory where polled fax files should go to.
43 Defaults to "." for the current directory. Unused if not
44 polling a fax.
45 -C <class>
47 Tells sendfax how to treat the modem. Possible values for
48 <class> are "auto" (default, try to find out which fax command
49 set the modem supports), "cls2" (use the class 2 fax command
50 set, even if the modem claims to support class 2.0) and "c2.0"
51 (use the class 2.0 fax command set). Obviously, "data" (which is
52 valid for "mgetty -C ...") is not of much use here.
53 -S Assume modem connection on stdin, do not try to lock or initial‐
55 ize anything. To take over existing connection (for interworking
56 with vgetty et.al.) use with a dial string of "T1" (just a short
57 beep, no phone number at all would confuse many modems, a pulse
58 dialed number may confuse the telco switch) and "-m ATX1" (do
59 not wait for dial tone).
60 -n Tells sendfax to send the fax pages in ``normal'' (204x98 dpi)
62 mode. Default is ``fine'' mode (204x196 dpi).
63 -r If this option is given, sendfax will rename all the fax G3
65 files to ``<filename>.done'' after successfully sending this.
66 This is intended to be used from ``faxrunq'', to make sure that
67 a partially-sended fax isn't retransmitted as a whole every
68 time.
69 If this option is set, sendfax will not (!) complain if not all
71 files named on the command line exist.
72 -D <dial prefix>
74 Override the default (set by sendfax.config or in policy.h) for
75 the 'ATxxx' command to dial the remote number. This is rarely
76 used from the command line, but you might want to use it in com‐
77 bination with faxrunqd's policy routing option (see example in
78 faxrunqd.policy(5)).
79 -M <max speed>
81 Sets the maximum transmission (modem to modem) speed. This is
82 only needed in very rare cases, because normally the modems
83 negotiate the correct speed automatically. Example: "-M 7200".
84 -R <max tries>
86 Sets the maximum number of attempts to transmit a given page,
87 before sendfax gives up on this page. Normally it's not needed
88 to change this - the default is "(up to) 3 tries" and that works
89 quite well for most environments.
90
93 If compiled accordingly, sendfax can read all its configuration from at
94 run-time from a file, usually called /etc/mgetty+sendfax/sendfax.con‐
95 fig. See the documentation in the mgetty.info manual for details.
96
99 sendfax returns an error code, according to the reason why the program
100 terminated. If everything went OK, sendfax returns 0. If ``harmless''
101 errors (didn't cost money) occured, an error code below 10 is returned.
102 If a dial attempt failed after the remote end picked up (it will cost
103 money), a return code of 10 or higher is returned.
104 In Detail, the return codes are as follows:
106 0 all pages have been transmitted successfully
108 1 error on the sendfax command line
110 2 cannot open fax device (e.g. due to locked modem)
112 3 cannot initialize modem (e.g. modem switched off)
114 4 dialup failed with BUSY
116 5 dialup failed with NO DIALTONE
118 10 dialup failed with ERROR or NO CARRIER (modem handshake
120 failed)
121 11 waiting for XON failed (rarely seen)
123 12 transmitting or polling page(s) failed (connection
125 dropped)
126 Very detailed debug information is written to the log file. It can be
128 found in "/var/log/sendfax.log". If it doesn't contain enough details,
129 enhance the log level with the "-x" option to sendfax, e.g. "-x 5".
130 Many of the common problems and solutions are discussed in the mgetty
132 manual and the FAQ. Please see the WWW page at http://alpha.gree‐
133 nie.net/mgetty/ for both.
134
138 The standard for Group 3 fax is defined in CCITT Recommendation T.4.
139
141 sendfax should be able to put a header on the page.
142 sendfax should be able to read TIFF g3 input files.
144
147 g3cat(1), pbm2g3(1), mgetty(1), faxspool(1), faxrunq(1), faxrunqd(8)
148
150 sendfax is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>.
151greenie 27 Oct 93 sendfax(8)