fax - make, send, receive, view or print a fax

       Fax was written by Ed Casas.  Please send comments or bug reports to edc@cce.com.   Please  describe  the
       type of modem used and include a copy of the log file.

       See efax(1).

3rd Berkeley Distribution                           May 1996                                              FAX(1)

       Fax  is  copyright  1993 -- 1999 by Ed Casas.  It may be used, copied and modified under the terms of the
       GNU Public License.

fax provides a simple user interface to the efax(1) and efix(1) programs.  It allows you to send text  or
       Postscript  files  as  faxes and receive, print or preview received faxes.  The faxhelp command prints a
       summary of the possible commands.

       To send a fax, the original files need to be converted from ASCII or Postscript into a particular bit-map
       format (TIFF with Group 3 encoding).  This can be done automatically by the faxsend command or  you  can
       use  the  faxmake  command to do the conversion before sending the fax.  The conversion will create one
       file per page.  These files will have the name of the original file with the page number as an additional
       suffix.  For example, running faxmakedoc.ps on the two-page postscript file doc.ps would  generate  the
       files doc.ps.001 and doc.ps.002.

       When  sending  a  fax with the faxsend command you may dial the number manually and use the -m option or
       you may give the phone number on the command line.  The names of the files to be sent are  given  on  the
       command  line, usually by using wildcards.  For example, to send a multi-page fax consisting of the files
       doc.ps.001, doc.ps.002, and so on, you could use the command faxsend555-1212doc.ps.0*  (if  you  had
       already  run  the faxmake command) or simply faxsend555-1212doc.ps.  If the number is busy the script
       will wait and try again.

       Use the faxreceive command to answer the phone and receive a fax.  If  a  file  name  is  specified  the
       received fax will be stored in files with the given file name plus an extension equal to the page number.
       If  no  options  are  given, the received fax will be stored in files having a name given by the date and
       time and an extension equal to the page number.  For example, a fax  received  beginning  on  July  4  at
       3:05:20 pm will generate files 0704150520.001, 0704150520.002, and so on.

       The faxprint, faxview, and faxrm commands are used to print, preview or remove received fax files.  As
       with the send command the file names are usually given using wildcards.

       If  efax  has  been  installed for automatic fax reception you can use the faxqueue command to check for
       files in the incoming spool directory.  The fax script can also be configured to print received faxes  or
       e-mail  them  as  MIME  attachments  with  type image/tiff-f.  For convenience the faxprint, view and rm
       commands will first check for the named files in this spool directory.  The faxstatus command shows  the
       status  of the automatic receive process once, or every t seconds.  Privileged users can use the faxstop
       and faxstart commands to stop and restart the fax reception daemon.

       The faxanswer command is used for  unattended  reception  of  faxes.   It  is  normally  placed  in  the
       inittab(5) or ttytab(5) file and is run automatically by init(8).

       The -v option displays verbose messages.

       Other features of the fax script are documented within the script:

       -  a directory that lets you specify recipients by name instead of number

       -  the faxnew command to create a simple cover page and start up a text editor

       -  the faxmakefont command converts a Postscript font to a bit-mapped font for use in headers or text

       Although fax has been tested, it may have errors that will prevent it  from  working  correctly  on  your
       system.   Some  of  these  errors  may cause serious problems including loss of data and interruptions to
       telephone service.

       The  fax  script will `source' the optional shell scripts /etc/efax.rc, ~/.efaxrc and/or ./.efaxrc before
       processing command-line arguments.  These files can be used to set script variables to custom values  for
       a particular system, user and/or directory.

       The  following  files  are  created in the FAXDIR spool directory when automatic fax reception is enabled
       (see the fax script).  DEV represents the name of the fax modem  device  file  in  /dev  (e.g.  cua1  for
       /dev/cua1).

       DEV.n     the log file created by the fax answer daemon with process id n

       DEV.log   contains  collected  log  files  for  device  DEV.  Log files showing a termination status of 1
                 (device busy) or 4 (no response from modem) are not added to this file.

       DEV.stop  created by the fax stop command to prevent the fax daemon from starting up.

       fax - make, send, receive, view or print a fax

-l       use low (96 line per inch) resolution

       -v       display verbose messages for debugging

       -m       the phone call has already been dialed manually

       The commands make, send, receive, view and queue may be abbreviated to their first characters (e.g. ``fax
       q'').

       Assignments  of  the  form  VARIABLE=value  may  appear before the command name to temporarily change the
       values of most fax script variables (e.g. ``fax PAGE=a4 print letter.001'')

       Faxes  can  be  created at low (98 lines per inch) or high (196 lpi) resolution.  Almost all fax machines
       will operate at either resolution.  By default files are created at high resolution but you can  use  the
       optional -l argument to create files at low resolution.

efax(1),efix(1),ghostscript(1).

       The modem commands and responses together with status and error messages are written to file.  If the fax
       is successfully sent or received the log file is removed.  Otherwise a message is printed showing the log
       file name.  Please send a copy of this file when reporting problems with efax.

faxhelpfaxmake [-l] filefaxsend [-l] [-v] { -m | number } filename...

       fax [ receive [-v] [ filename-prefix ] ]

       fax { print | view | rm } filename...

       fax { queue | status [t] |  start | stop }

       faxanswer