install

使用efax的fax工具程序

<<<  5. Unpack the Qfax sources  >>>

You should unpack the entire Qfax and efax distribution in a temporary 
directory of its own (e.g. /tmp works just fine).

To do this, move the archive file qfax1.3.tar.gz to the new
directory and type:

	zcat qfax1.3.tar.gz | tar xvf -


<<<  6. Create a master directory for fax configuration files  >>>

You'll need to create a directory (e.g. "/conf/fax") for Qfax to store
its configuration information in.  You could just as easily use
"/etc", but that leads to a cluttered mess after awhile; far better to
be organized from the start.

Into this directory you should copy the following files from the Qfax
distribution:

	fax.rc
	fax.db
	cover-template.ps


<<<  7. Configure Qfax for your site's needs  >>>

Edit the file "config.h" to your liking.  In most cases the default
options should suffice; the comments explain the options fairly
clearly.


<<<  8. Define any privileged users  >>>

Privileged users are allowed to have faxes sent out immediately,
rather than having their faxes thrown onto the queue for later
processing.  The FAXGROUP setting in config.h defines the name of this
privileged group, which you should add to /etc/group.  Add the
usernames of any users you want to give this privilege to.  For
instance, if you wanted to give this privilege to users named "huey",
"dewey", and "louie", and the name of the privileged group was
"faxnow", you'd add the following line to /etc/group:

	faxnow::1006:huey,dewey,louie

(The "1006" is just the group ID number; use any unused number you
like for this group)


<<<  9. Edit the efax fax script  >>>

Take a look at the fax script (/usr/bin/fax, or /usr/local/bin/fax)
and edit it to conform to your particular modem, phone number, and so
on.  efax requires that this file be configured in order to send
faxes, and to answer fax calls.


<<<  10. Edit the fax.rc file  >>>

Change directories now to the "configuration directory" you set up in
step 6.  The fax.rc file contains configuration information which is
not compiled into Qfax or efax--you can change it at any time.  It
allows you to define the format and fonts used on your site's cover
pages, your company address, page sizes, and so on.  The comments in
the file provided should be clear enough to help you set up values for
your site.

NOTE: Qfax requires ALL the fields in this data file to be filled in;
leaving a field blank will cause the data to be improperly read, as it
messes with the expected order.  If you have to leave an entry blank
because it doesn't apply to you, try leaving a '.' or similarly
innocuous character there instead.


<<<  11. Create fax.db and ~/.fax files >>>

Qfax uses a phonebook-style database to look up fax information about
a recipient  (see qfax.phonebook(1) for more details).  The master
(site-wide) phonebook is fax.db, while each user can have his own
phonebook in his home directory as a .fax file.  The phonebook
database is presently quite simple and naive, and in future versions I
intend to improve it considerably.  The format of entries in both
files is identical:

	<company-alias>		<full-company-name>
	<voice-phone-number>
	<fax-phone-number>
	<person-1-alias>	<person-1-full-name>
	<person-2-alias>	<person-2-full-name>
		. . .
	<person-n-alias>	<person-n-full-name>
	+

Each entry MUST conform to this format, leaving empty lines for items
which do not apply.  Each entry is terminated by a '+' on a new line.
As an example:

	megacorp	MegaCorp International
	1.212.555.1212
	1.212.555.2121
	john	John Q. Smith, Vice-President
	+
	microcorp	MicroCorp Inc.

	1 [phone]
	jane	Jane Doe
	john	John Q. Public
	+

In this example, note that we don't have a voice phone number for
MicroCorp, so we leave that line empty (i.e. just '\n').  There is no
limit to the number of contact people at any given company, but there
MUST be at least one at each company.  In this way, mail to
"[e-mail]" would send a fax to John Q. Smith at MegaCorp
International, and "[e-mail]" would send a fax to Jane Doe
at MicroCorp.

Note that the format for phone numbers is not rigid; Qfax ignores all
non-digit characters when it reads a phone number, so you can include
spaces, dashes, or parentheses as you see fit to make it readable.
However, you MUST include all necessary digits (i.e. a leading "1" or
"0" if it's a long-distance number).  Qfax isn't terribly bright when
it comes to determining whether a phone number is long-distance or
not, so make sure all the necessary digits are there.  Similarly, if a
phone number is local, do NOT include any unnecessary digits (i.e.
area codes, city codes, etc.).  Qfax will be sending this series of
digits to the modem as a dialstring, so just think in those terms when
deciding how to phrase a number.

The master directory (fax.db) should be stocked by the FaxMaster with
commonly used names and sites.  The "~.fax" phonebooks should be
created by each user to suit her personal needs.  Qfax searches the
user's personal directory first (if it exists), and then searches the
master directory if the recipient could not be found, so for sites
where a single phonebook is desirable, the master directory can be
used.

NOTE: Every entry in these phonebooks (including the last one) has to
be terminated by a '+' at the beginning of a new line, just as the
example above shows.


<<<  12. Edit the Makefile  >>>

Just make sure the configurable options at the top of the Makefile are
to your liking.  Mostly this just involves making sure the pathnames
and compiler options are correct for your system.


<<<  13. Build everything and install it  >>>

Typing "make install" will cause everything (including efax) to be
built and installed.  Note that some of the Qfax files and efax are
owned by uucp, of group uucp, and setuid uucp.  This is necessary in a
server-style arrangement, don't be alarmed.


<<<  14. Test efax  >>>

Before you try using Qfax, make sure that efax is configured properly
and works by itself; this makes it MUCH easier to diagnose problems
with your system.  To test efax, you'll want to make sure it can do
two things--convert text files into fax files, and send those fax
files.

(1) Write up a simple text message (a paragraph will do) and save it
    to a file (e.g. test.txt).  Now, type "fax make test.txt".  If
    this is successful, you should see the file test.001 in the same
    directory; this is your fax file.  If this didn't work, chances
    are you don't have GhostScript installed, or your fax script
    doesn't know where to find GhostScript.  It may also be that the
    fax devices have not been compiled into your particular version of
    GhostScript (try "gs -h" to see a list of the devices your
    GhostScript supports); in this case, fetch the sources for
    GhostScript and rebuild it with support for dfaxhigh and dfaxlow.

(2) Try sending your new fax file to someone who can verify that it
    arrived intact.  To send the fax to 123-4567, you'd do this by
    typing "fax send 1234567 test.001".  If the fax doesn't arrive
    properly, you've probably got a configuration problem in your fax
    script, so look there to solve it.  You may find your modem's
    manual handy in this case.


<<<  15. Make an entry in a crontab file  >>>

In order to process the outgoing fax queue at regular intervals,
you'll have to invoke Qrun through cron, at, or something similar.
For instance, to process the queue every 15 minutes, you'd need a
crontab entry like:

	# Process the fax spool
	0,15,30,45 * * * * /usr/local/bin/qrun

To process it only once a day at midnight, try:

	# Process the fax spool
	0 0 * * * /usr/local/bin/qrun

See the man pages for cron and crontab for more details.

Ideally this should be done in fax's (or uucp's) crontab, since the
jobs should be run by that UID.  However, you can put it in root's
crontab instead if you wish.


<<<  16. Make an inittab entry for efax  >>>

If you'd like to use efax to answer incoming fax calls, make sure that
USE_DAEMON is defined in config.h.  If you'd rather not use efax for
receiving faxes, comment out this definition.

If you are using efax's "fax answer" process to handle incoming calls,
you should put an entry in your /etc/inittab file that looks like:

	s1:56:respawn:/bin/sh /usr/local/bin/fax answer

NOTE: Only put this entry in your /etc/inittab if you defined
      USE_DAEMON in config.h.


<<<  17. Sign on to the mailing list  >>>

Well, strictly speaking this is an optional step :)  Now that you're
effectively done, you might want to put yourself on the Qfax/efax
mailing list to keep yourself apprised of updates and bug fixes.

To subscribe, send email to [e-mail], with the word
"subscribe" in the subject field; the body of the message is ignored.
To post to the list itself, send your post to [e-mail].

If you encounter problems getting things to look right or work
properly, the mailing list is the place to ask your questions, and to
share your thoughts with other Qfax users.

There's also a digested version of the mailing list available, if
you'd prefer to receive accumulated postings instead of individual
messages.  To subscribe to the digested version, send your request to
[e-mail].


<<<  18. Check out the FTP archives  >>>

You might also want to take a look at the FTP archives at Qfax's home
site, ftp.renaissoft.com, under /pub/qfax.  This is where you'll find the
latest (often alpha) versions of Qfax, and where you'll find patches
and documentation.  You can also reach these archives via gopher
(gopher.renaissoft.com) and the WWW (http://www.renaissoft.com/Qfax/).