README file for Renaissoft Qfax 1.1 (22 Jul 1995)What is Qfax?-------------The Qfax utilities are designed to work with Ed Casas' great littlefax program, efax.  Efax was designed for a single-user system,however, and lacks some of the functionality necessary to make it amulti-user fax server.  That's where Qfax comes in.The Qfax suite adds an e-mail-to-fax gateway to efax, a phonebookdatabase system, automated cover page generation, and fax spooling fordelayed transmission of faxes.For example, once Qfax is installed, a user on your system can sende-mail to "joe@acmecorp.fax" and have that turned into a fax(complete with a custom cover page), which is then put on the queue tobe sent out the next time you process it via cron.  When it finallygoes out, it gets faxed to "Joseph P. Smith" at "Acme Incorporated".After the send is complete, the user gets mailed a receipt that tellsher the time of the transmission, and a list of any failed attempts.The Qfax utilities are comprised of several programs:Qfax accepts its input directly from your mailer (sendmail or smail)and produces the cover page and fax pages, then deposits the files inthe queue to be sent out later.Qsend effectively replaces "fax send"; it allows you to send non-mailfiles the same way Qfax does--complete with cover page.  It promptsthe user for some cover page information about the recipient, thenbehaves just like Qfax.Qrun is the fax spool processor.  Usually run from a crontab entry atregular intervals, its job is to scan the spool directory to see ifthere are any faxes waiting to be sent.  If it finds any, it sendsthem out one at a time.  Optionally, Qrun can make sure thatlong-distance fax calls are only placed during certain hours.Qstat lets users list their queued faxes and check on their status(root can list all queued faxes).  Each fax is identified by a uniqueprefix.Qdel removes one or more faxes from the queue, as identified by itsunique prefix.  Users can only delete faxes they sent, while root candelete any fax.What you need:--------------Linux Kernel: 1.0.x OR 1.1.42+The early 1.1.x kernels had problems with software flow controlhandshaking, which made fax send/receive operations unreliable.  Touse efax and Qfax you should either use a 1.0.x kernel or upgrade tokernel 1.1.42 or later.efax: 07aQfax does not come with efax, which was written separately by EdCasas.  Version 07a is available by ftp from sunsite.unc.edu as"/pub/Linux/apps/comm/fax/efax07a.tar.gz".Mailer: sendmail OR smailYou will need either sendmail or smail to use the e-mail-to-faxgateway, and some kind of front-end software for it, such as elm,pine, etc.What do I do next?------------------Read the INSTALL file to find a step-by-step guide to walk you throughthe setup process.Help!  I'm lost!!!------------------First try looking through the man pages for qfax(1), qsend(1),qrun(1), qstat(1), qdel(1), and qfax.phonebook(1).  If that doesn'thelp, you can try looking through the files in the doc subdirectory,which can help you if your problems are modem-related.If all else fails, there's a mailing list for Qfax and efax users.  Tosubscribe just send e-mail to qfax-request@renaissoft.com with theword "subscribe" in the subject field; the body of the message will beignored.  Once subscribed, the actual mailing list can be posted-to bysending your post to qfax@renaissoft.com.The purposes of the mailing list are to:	(a) Announce updates and patches to Qfax and efax.	(b) Provide a forum for feedback and discussions about	    features you'd like to see in the next versions of each	    package.	(c) Provide a degree of technical support for those who have	    difficulty getting Qfax and/or efax set up.Alternatively, you can address your Qfax-related comments andquestions to me at rjl@renaissoft.com.