Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
sendfax(8)		     mgetty+sendfax manual		    sendfax(8)

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

       sendfax	[-p]  [-x<debuglevel>]	[-v] [-l<modemlines>] [-m<initstring>]
       [-d<polldirectory>] [-C<modemclass>] [-S]  [-n]	[-r]  [-D<dialprefix>]
       phone-number [g3file(s)]

       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.

       -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 log-
	      ging, 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, what-
	      soever. The modem	must return "OK". If it	returns	"ERROR", send-
	      fax  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.  De-
	      faults  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 initial-
	      ize anything. To take over existing connection (for interworking
	      with vgetty 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

	      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 com-
	      bination	with  faxrunqd's policy	routing	option (see example in

       -M <max speed>
	      Sets the maximum transmission (modem to modem) speed.   This  is
	      only  needed in very rare	cases, because normally	the modems ne-
	      gotiate 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.

       If compiled accordingly,	sendfax	can read all its configuration from at
       run-time	 from  a  file,	 usually  called   /usr/local/etc/mgetty+send-
       fax/sendfax.config. See the documentation in the manual for

       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

	      11     waiting for XON failed (rarely seen)

	      12     transmitting   or	 polling  page(s)  failed  (connection

       Very detailed debug information is written to the log file.  It can  be
       found in	"/var/spool/fax/Faxlog". 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.gree- for both.

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

       sendfax should be able to put a header on the page.

       sendfax should be able to read TIFF g3 input files.

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

       sendfax is Copyright (C)	1993 by	Gert Doering, <>.

greenie				   27 Oct 93			    sendfax(8)


Want to link to this manual page? Use this URL:

home | help