FAX(1) FAX(1)

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

SYNOPSIS
       ffaaxx hheellpp

       ffaaxx mmaakkee [-ll] file

       ffaaxx sseenndd [-ll] [-vv] { -mm | number } filename...

       ffaaxx [ rreecceeiivvee [-vv] [ filename-prefix ] ]

       ffaaxx { pprriinntt | vviieeww | rrmm } filename...

       ffaaxx { qquueeuuee | ssttaattuuss [t] |  ssttaarrtt | ssttoopp }

       ffaaxx aannsswweerr


OOPPTTIIOONNSS
       -ll       use low (96 line per inch) resolution

       -vv       display verbose messages for debugging

       -mm       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
       ffaaxx provides a simple user interface to the efax(1)  and  efix(1)  pro-
       grams.   It  allows  you  to send text or Postscript files as faxes and
       receive, print or preview received faxes.  The ffaaxx hheellpp 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  encod-
       ing).   This  can  be done automatically by the ffaaxx sseenndd command or you
       can use the ffaaxx mmaakkee 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  addi-
       tional  suffix.   For  example, running ffaaxx mmaakkee ddoocc..ppss 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 ffaaxx sseenndd command you may dial the number
       manually and use the -mm option or you may give the phone number on  the
       command  line.  The names of the files to be sent are given on the com-
       mand 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 ffaaxx sseenndd 555555-11221122 ddoocc..ppss..00** (if you  had  already
       run  the  ffaaxx mmaakkee command) or simply ffaaxx sseenndd 555555-11221122 ddoocc..ppss.  If the
       number is busy the script will wait and try again.

       Use the ffaaxx rreecceeiivvee 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 num-
       ber.   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 ffaaxx pprriinntt, ffaaxx vviieeww, and ffaaxx rrmm 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
       ffaaxx  qquueeuuee  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
       ffaaxx pprriinntt, vviieeww and rrmm commands will first check for the named files in
       this  spool  directory.  The ffaaxx ssttaattuuss command shows the status of the
       automatic receive process once, or every t seconds.   Privileged  users
       can use the ffaaxx ssttoopp and ffaaxx ssttaarrtt commands to stop and restart the fax
       reception daemon.

       The ffaaxx aannsswweerr command is used for unattended reception of  faxes.   It
       is normally placed in the inittab(5) or ttytab(5) file and is run auto-
       matically by init(8).

       The -vv 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 num-
          ber


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


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


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


SSEESSSSIIOONN LLOOGGSS
       The modem commands and responses together with status  and  error  mes-
       sages 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  //eettcc//eeffaaxx..rrcc,
       ~~//..eeffaaxxrrcc  and/or  ..//..eeffaaxxrrcc  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  repre-
       sents  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 show-
                 ing 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.


DDIISSCCLLAAIIMMEERR
       Although  ffaaxx  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
       eeffaaxx((11)),, eeffiixx((11)),, gghhoossttssccrriipptt((11))..


BUGS
       See efax(1).



3rd Berkeley Distribution          May 1996                             FAX(1)