README
1
2 Introduction
3
4This is the README file for version 0.9 of efax, a small ANSI
5C/POSIX program that sends and receives faxes using any fax modem
6(Class 1, 2 or 2.0).
7
8efax is smaller and easier to install than HylaFAX or
9mgetty+sendfax. As one user put it ``EFAX is a nice simple
10program for single user systems.''
11
12The ``fax'' command, a shell script, lets you send, receive, view
13and print faxes. In larger systems, faxes can be sent by
14printing to a ``fax'' printer and received faxes can be e-mailed
15as MIME attachments to an administrator for distribution. efax
16can also pass incoming data calls to a getty program.
17
18The efax package includes ``efix,'' a program to convert between
19various image file formats. To fax Postscript files you will
20need Ghostscript. To view faxes you can use any program that
21displays PGM files (e.g. xloadimage or xv). efix can convert
22received files to Postscript or HP Laserjet formats for printing.
23
24This version of the program was written & tested under Linux 2.0.
25Previous versions have been compiled and used under most versions
26of Unix and should work with minor changes on any Unix with an
27ANSI C compiler and libraries that include select(2) and
28termios(4).
29
30efax is distributed as a gzip'ed tar file, efax-0.9.tar.gz. It
31may be obtained by anonymous FTP from metalab.unc.edu in
32/pub/Linux/apps/serialcomm/fax.
33
34 Changes from version 0.8a to version 0.9
35
36- fixed bad (0x0 pixel) file output on new glibc systems
37
38- fixed bad file output on 64-bit systems
39
40- automatic selection of baud rate and class
41
42- hardware flow control made optional
43
44- modernized directory and file names
45
46- many bugs removed, others added
47
48 Manifest
49
50The efax distribution should contain the following files:
51
52README - this file
53COPYING - the GNU General Public License
54Makefile - makefile to make all/install/clean
55efax.c - program to send and receive faxes
56efix.c - program to convert between file formats
57efaxmsg.{h,c} - functions to print errors, warnings, etc
58efaxlib.{h,c} - functions common to efax and efix
59efaxio.{h,c} - low-level modem i/o functions
60efaxos.{h,c} - OS-dependent functions
61fax.1 - man page for fax(1)
62efax.1 - man page for efax(1)
63efix.1 - man page for efix(1)
64fax - a (Bourne) shell script to create, send,
65 receive, view and print faxes.
66
67 Installation
68
69Edit the makefile and change the compile command and destination
70directories if required.
71
72Type "make" to compile the efax and efix binaries.
73
74Edit the configuration information at the beginning of the
75``fax'' script according to the comments.
76
77Type "make install" to install the fax script, the binaries and
78the man pages.
79
80Read the fax(1) man page first for information on using efax.
81
82The efax(1) man page has details on resolving problems, setting
83up a network fax server and using efax to handle both fax and
84data calls.
85