1sendfax(8)                   mgetty+sendfax manual                  sendfax(8)
2
3
4

NAME

6       sendfax - send group 3 fax files (G3 files) with a class 2 faxmodem
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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
23       -x <debug level>
24              Use  the  given level of verbosity for logging - 0 means no log‐
25              ging, 5 is really noisy.
26
27       -v     Give some progress report on stdout.
28
29       -l <modem lines>
30              Use the given modem lines. Multiple lines can  be  separated  by
31              ":".  Example: sendfax -l tty1a:tty2a
32
33       -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
41       -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
46       -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
54       -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
61       -n     Tells sendfax to send the fax pages in ``normal''  (204x98  dpi)
62              mode. Default is ``fine'' mode (204x196 dpi).
63
64       -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
70              If  this option is set, sendfax will not (!) complain if not all
71              files named on the command line exist.
72
73       -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
80       -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
85       -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
91

CONFIG FILE

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
97

DIAGNOSTICS

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
105       In Detail, the return codes are as follows:
106
107              0      all pages have been transmitted successfully
108
109              1      error on the sendfax command line
110
111              2      cannot open fax device (e.g. due to locked modem)
112
113              3      cannot initialize modem (e.g. modem switched off)
114
115              4      dialup failed with BUSY
116
117              5      dialup failed with NO DIALTONE
118
119              10     dialup  failed  with ERROR or NO CARRIER (modem handshake
120                     failed)
121
122              11     waiting for XON failed (rarely seen)
123
124              12     transmitting  or  polling  page(s)   failed   (connection
125                     dropped)
126
127       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
131       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
135
136

REFERENCES

138       The standard for Group 3 fax is defined in CCITT Recommendation T.4.
139

BUGS

141       sendfax should be able to put a header on the page.
142
143       sendfax should be able to read TIFF g3 input files.
144
145

SEE ALSO

147       g3cat(1), pbm2g3(1), mgetty(1), faxspool(1), faxrunq(1), faxrunqd(8)
148

AUTHOR

150       sendfax is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>.
151
152
153
154greenie                            27 Oct 93                        sendfax(8)
Impressum