fax - fax sending and receiving with mgetty+sendfax
SYNOPSIS
faxspool [options] phone-number file
faxrm job-id
faxq [options]
faxrunq [options]
sendfax [options] phone-number file
mgetty [options] tty
pbm2g3 [options] [pbm-file]
g32pbm [options] [pbm-file]
g3cat [options] [g3-file(s)]
DESCRIPTION
This manpage very briefly describes every program from the
mgetty+sendfax fax/modem software suite. For details, see
the manpages for each program.
faxspool is used to queue jobs for later transmission by
fax. faxspool accepts different input formats, converts
them into the proper format required by sendfax and places
the jobs into the outgoing spool directory.
faxq displays the current FAX work queue.
faxrm removes one or more jobs from the current fax work
queue. You have to specify the job id (returned by faxq)
on the command line.
faxrunq processes all the faxes in the fax work queue, and
sends them one-by-one. If transmission isn't possible,
the job will be retried later. While meant to be run from
cron, faxrunq can as well be started from the shell (but
you must be root).
sendfax is the backend used by faxrunq for actually send
ing the fax. It is not meant to be ever called directly,
but can be used in own applications.
mgetty is the part of the program suite that handles
incoming calls. Data calls are handled as getty does it
(login, shell), while fax calls are handled internally.
The received faxes are stored in /var/spool/fax/incoming.
called directly, it must be called by /etc/init.
pbm2g3 is used to convert portable bitmaps to G3 fax data
(for sendfax). Do not use the pbmtog3 program from the
pbmplus or netpbm toolkit, it will create broken G3 data.
g32pbm is used to convert received faxes (which are stored
in G3 format) to portable bitmap format. PBM can be con
verted to other formats with the named pbmplus toolkit.
g3cat is used to concat multiple G3 files, as cat does
with text files.
FILES
/var/spool/fax/outgoing/
outgoing fax spool directory
/var/spool/fax/incoming/
incoming faxes
/usr/lib/mgetty+sendfax/
The cover page program, and a few font files live
here.
/etc/mgetty+sendfax/
most configuration files for mgetty and sendfax
live here.
/usr/sbin
mgetty and sendfax live here
/usr/bin
all the other programs
/etc/mgetty+sendfax/faxaliases
global fax alias file
$HOME/.faxnrs
private fax alias file
/etc/mgetty+sendfax/fax.allow
list of allowed users
/etc/mgetty+sendfax/fax.deny
list of denied users
/etc/mgetty+sendfax/faxheader
fax page header
/usr/lib/mgetty+sendfax/make.coverpg
program to create fax cover page (see coverpg(1)).
login configuration file for mgetty.
/etc/mgetty+sendfax/dialin.config
caller ID setup file for mgetty (optional).
/etc/mgetty+sendfax/mgetty.config
runtime configuration file for mgetty (not imple
mented yet).
/etc/mgetty+sendfax/sendfax.config
runtime configuration file for sendfax (optional).
BUGS
Look into the responding man pages.
SEE ALSO
faxspool(1), faxq(1), faxrunq(1), sendfax(8), faxrm(1),
mgetty(8), pbm2g3(1), g32pbm(1), g3cat(1), faxqueue(5),
mgettydefs(4), coverpg(1)
mgetty.info
AUTHOR
The mgetty+sendfax program suite is Copyright (C) 1993 by
Gert Doering, <gert@greenie.muc.de>. Parts of the pro
grams kindly donated by Chris Lewis, Paul Sutcliffe, Klaus
Weidner, and numerous others.
Man(1) output converted with
man2html