qrun.1

使用efax的fax工具程序

.ds Fx \fIQfax\fP
.TH QRUN 1 "1 March, 1996"
.SH NAME
qrun \- \*(Fx fax spool processor for efax
.SH SYNOPSIS
.B qrun [username]
.SH DESCRIPTION
.B qrun
checks the fax spool directory for any faxes waiting to be
sent, and tries to send any faxes it finds, otherwise it
exits without doing anything.

If an optional username is supplied, only faxes that belong
to the specified user will be sent out during this processing
run.

If a "long distance period" was defined at compile time,
.B qrun
checks the phone number of the outgoing fax before sending
it, to make sure it has permission to dial out at this time.

Faxes are sent out one at a time, with a 15 second pause
between them.

If a fax transmission is successful, the fax files in the
spool directory are deleted and the sender is notified by
email, telling him the time of the transmission and its
result.

If a fax transmission fails for any reason,
.B qrun
writes a "try file" to the spool directory, making a note of
the time of the attempt and its result.  The fax files remain
in the spool directory until the next time
.B qrun
is invoked, when it will try again to send them.  This process
continues until either the fax gets sent successfully or
.B MAXTRIES
(as defined in
.B config.h
) is met.  If this maximum number of failed attempts is achieved,
the fax is moved to the storage directory, and the sender is
notified by email.

.SH "RUNNING QRUN WITH CRON"
.B qrun
is intended to be run from a
.B crontab
entry periodically.  Ideally this should be fax's (or uucp's)
crontab entry, but it will work properly from root's crontab
as well.  An entry such as:

.B 0,15,30,45 * * * * /usr/local/bin/qrun

will process the fax spool once every 15 minutes, for instance.

.SH "ANSWER PROCESSES AND INIT"
If USE_DAEMON was defined in config.h when
.B qrun
was compiled, then
.B qrun 
makes the assumption that you will be using
.B fax answer
from your
.B /etc/inittab
to answer incoming calls.

.B qrun
disables any
.B fax answer
process that might be running when it is invoked, so that it won't
be interrupted by incoming calls prior to dialing out.  When the
last fax is sent,
.B qrun
enables
.B fax answer
once again by removing the stop file that was preventing
.B init
from spawning a new one.  This should allow
.B qrun
to seamlessly coexist with your answer process.

.SH FILES
.sp
.RS +.2i
.ta 1.0i
.nf
/usr/local/bin/qrun     Qrun binary
/usr/local/bin/fax      efax fax script
/usr/local/bin/efax     efax binary
/etc/inittab            init configuration file
/etc/crontab            crontab manager
config.h                Qfax compile-time configuration file
.fi
.RE
.sp

.SH AUTHOR
.B Qrun
was written by Robert LeBlanc <[e-mail]>.  Comments,
feedback, and suggestions are welcome.

.SH ACKNOWLEGEMENTS
.B efax
was written by Ed Casas <[e-mail]>.  Without this wonderful
fax program of his, many of us would still be living in a faxless
world.  Thanks Ed.

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

.SH "SEE ALSO"
.IR fax(1),
.IR efax(1),
.IR init(1),
.IR crontab(1),
.IR crontab(5)

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

Ideally, the compile time configuration options defined in
.B config.h
should be moved to
.B fax.rc
in the next version.