Provided by: efax_0.9a-21_amd64 bug

NAME

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

SYNOPSIS

       fax help

       fax make [-l] file

       fax send [-l] [-v] { -m | number } filename...

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

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

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

       fax answer

OPTIONS

       -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'')

DESCRIPTION

       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 fax help 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  fax  send  command  or  you  can use the fax make 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 fax make doc.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 fax send 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  fax send 555-1212 doc.ps.0* (if you had already run the fax make command) or
       simply fax send 555-1212 doc.ps.  If the number is busy  the  script  will  wait  and  try
       again.

       Use  the  fax  receive  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 fax print, fax view, and fax rm 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 fax queue 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 fax print, view and rm commands will first check for the  named  files  in
       this  spool  directory.   The fax status command shows the status of the automatic receive
       process once, or every t seconds.  Privileged users can use the fax  stop  and  fax  start
       commands to stop and restart the fax reception daemon.

       The  fax  answer 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 fax new command to create a simple cover page and start up a text editor

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

RESOLUTION

       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.

SESSION LOGS

       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.

FILES

       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.

AUTHOR

       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.

COPYRIGHT

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

DISCLAIMER

       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.

SEE ALSO

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

BUGS

       See efax(1).