QFAX(1)

NAME
qfax - Qfax email to fax gateway for efax

SYNOPSIS
qfax

DESCRIPTION
qfax accepts electronic mail piped to it from smail or sendmail and converts it into a Group III fax, complete with cover page, then queues it up to be sent later. E-mail is parsed into three distinct sections: 1. Standard mail headers Standard headers (e.g. "To:", "From:", "Subject:", etc.) are parsed to gather information for the cover page. This information does not appear in the body of the fax. 2. Cover page comments The first line of the body of the e-mail message is checked to see whether it happens to be the "fax comment start" marker, as defined in the fax.rc file. If it is, all text on lines between it and the "fax comment end" marker will be displayed on the cover page in the comments section; otherwise it is assumed that there are no cover page comments, and therefore the body of the mail message is treated as the body of the fax. 3. The body of the fax message Everything following the "fax comment end" marker (if present) will be copied verbatim into the fax message. This includes signatures, if your mail program appends them. qfax uses configuration data from your fax.rc file to determine how to format the cover page. Recipient information is looked up first in the sender's home directory in a phonebook called .fax and then in the master directory fax.db if the recipient couldn't be found. If the recipient could not be found in either phonebook, the sender is notified by mail.

FAX ADDRESSES
To use the email to fax gateway, users must address their email to: <PersonAlias>@<CompanyAlias>.fax e.g. "karen@megacorp.fax". The aliases are used for lookup in the phonebooks, and are replaced with the full names on the cover page of the fax (see qfax.phonebook(1) for more details).

FILES

    /usr/local/bin/qfax     Qfax binary
    /conf/fax/fax.rc        Qfax configuration file
    /conf/fax/fax.db        Qfax master phonebook
    ~/.fax                  Qfax user phonebook

AUTHOR
Qfax was written by Robert LeBlanc <rjl@renaissoft.com>. Comments, feedback, and suggestions are welcome.

ACKNOWLEGEMENTS
efax was written by Ed Casas <edc@ee.ubc.ca>. Without this wonderful fax program of his, many of us would still be living in a faxless world. Thanks Ed.

COPYRIGHT
The Qfax utilities ( qfax, qrun, qsend, qstat, qdel ) are copyright 1994 by Robert LeBlanc and Renaissoft. These files may be used, copied, and modified under the terms of the GNU Public License.

SEE ALSO
qrun(1), qsend(1), qstat(1), qdel(1), qfax.phonebook(1)

BUGS
I'm only human. Please send in bug reports to me at the address given above.