FAX(1)                                                     FAX(1)


NAME
       fax or faxps - send a fax


SYNOPSIS
       fax  -p phone [-m] [-h host] [-u user] [-c] [-r recipient]
       [-s sender] [-S reply fax] [-v sender  voice]  [-e  sender
       email] [file]


DESCRIPTION
       The  fax  and faxps commands sends electronic documents as
       CCITT Group 3 faxes to the specified  fax  phone  numbers.
       One or more phone numbers are given with the -p command.

       The  fax  command sends text files, which are converted to
       Postscipt using a local program (perhaps enscript).

       The faxps command send a raw Postscipt file, which is con-
       verted  to  Group  3 fax format using the Ghostscript pro-
       gram.


OPTIONS
       If no filename is specified, fax and faxps reads the  text
       of your document from the standard input.  The fax command
       will accept more than one file name.   The  faxps  command
       takes at most a single Postscript file.

       -p phone      Specify  a  recipient  phone  number for the
                     fax.  One or more -p options can be given.

       -m            Tells the system to mail you a  notice  when
                     the  fax  has  been delivered to all recipi-
                     ents, or when  the  transmission  has  timed
                     out.

       -h host       Specifies the host for the fax spooler.  The
                     environment variable  FAXHOST  can  also  be
                     used to specify this host.

       -u username   Specifies  an alternative username for queu-
                     ing the job.

       -c            Will create a coversheet, using the informa-
                     tion  specified  in flags that are described
                     below.

       -r name       Specify the recipient's name  to  appear  on
                     the coversheet.

       -s name       Specifies the sender's name to appear on the
                     coversheet.




                           10 July 1991                         1

FAX(1)                                                     FAX(1)


       -S phone      Specifies the sender's return fax number  to
                     appear on the coversheet.


USAGE
       The  phone  number  is  given  as a Hayes modem style dial
       string.  Valid dial characters are:
       0-9 Numeric Digits
       * # A-D Auxiliary Digits
       T   Tone Dialing
       P   Pulse Dialing
       ,   Pause for (S8) seconds, default is 2 seconds
       /   Pause 1/8 second in dialing sequence
       W   Wait for second Dial Tone
       In addition, prefixing the phone number with '@' will sup-
       press  the  number  from  appearing in the faxq.  This can
       help protect account and credit card numbers.


EXAMPLES
       To fax the text file foo.text to 2  recipients,  with  the
       phone  numbers  212-555-1212 and 314-555-1212, and receive
       email notification when both faxes have been  sent,  issue
       the command:

       prompt> fax -p 2125551212 -p 3145551212 -m foo.text

       To fax the Postscript file foo.ps to 123-4567, with a cov-
       ersheet which has "To:  Foo",  "From:  Bar",  "Fax  reply:
       777-7777" issue the command:

       prompt> faxps -p 1234567 -c -r "Foo" -s "Bar" -S "777-7777" foo.ps

       To send the standard input text to 123-4567 issue the com-
       mand:

       prompt> fax -p 123-4567


SEE ALSO
       faxq(1), faxrm(1), faxenq(8), faxspooler(8)
















                           10 July 1991                         2