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