.ds Fx \fIQfax\fP.TH QRUN 1 "1 March, 1996".SH NAMEqrun \- \*(Fx fax spool processor for efax.SH SYNOPSIS.B qrun [username].SH DESCRIPTION.B qrunchecks the fax spool directory for any faxes waiting to besent, and tries to send any faxes it finds, otherwise itexits without doing anything.If an optional username is supplied, only faxes that belongto the specified user will be sent out during this processingrun.If a "long distance period" was defined at compile time,.B qrunchecks the phone number of the outgoing fax before sendingit, to make sure it has permission to dial out at this time.Faxes are sent out one at a time, with a 15 second pausebetween them.If a fax transmission is successful, the fax files in thespool directory are deleted and the sender is notified byemail, telling him the time of the transmission and itsresult.If a fax transmission fails for any reason,.B qrunwrites a "try file" to the spool directory, making a note ofthe time of the attempt and its result.  The fax files remainin the spool directory until the next time.B qrunis invoked, when it will try again to send them.  This processcontinues 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 isnotified by email..SH "RUNNING QRUN WITH CRON".B qrunis intended to be run from a.B crontabentry periodically.  Ideally this should be fax's (or uucp's)crontab entry, but it will work properly from root's crontabas well.  An entry such as:.B 0,15,30,45 * * * * /usr/local/bin/qrunwill 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 qrunwas compiled, then.B qrun makes the assumption that you will be using.B fax answerfrom your.B /etc/inittabto answer incoming calls..B qrundisables any.B fax answerprocess that might be running when it is invoked, so that it won'tbe interrupted by incoming calls prior to dialing out.  When thelast fax is sent,.B qrunenables.B fax answeronce again by removing the stop file that was preventing.B initfrom spawning a new one.  This should allow.B qrunto 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 managerconfig.h                Qfax compile-time configuration file.fi.RE.sp.SH AUTHOR.B Qrunwas written by Robert LeBlanc <rjl@renaissoft.com>.  Comments,feedback, and suggestions are welcome..SH ACKNOWLEGEMENTS.B efaxwas written by Ed Casas <edc@ee.ubc.ca>.  Without this wonderfulfax program of his, many of us would still be living in a faxlessworld.  Thanks Ed..SH COPYRIGHTThe.B Qfaxutilities (.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 termsof the GNU Public License..SH "SEE ALSO".IR fax(1),.IR efax(1),.IR init(1),.IR crontab(1),.IR crontab(5).SH BUGSI'm only human.  Please send in bug reports to me at the addressgiven above.Ideally, the compile time configuration options defined in.B config.hshould be moved to.B fax.rcin the next version.