Provided by: hylafax-server_6.0.6-6_i386 bug


       faxinfo - print information about a received facsimile


       Basic usage:

       /usr/sbin/faxinfo [ -b ] [ -n ] [ -D ] file.tif [ file2.tif [...] ]

       Formatting shortcuts:

       /usr/sbin/faxinfo [ -C delim | -c delim | -r ] file.tif [ file2.tif ] ]

       Raw formatting:

       /usr/sbin/faxinfo  [ -S fmt ] [ -s fmt ] [ -e fmt ] [ -E fmt ] file.tif
       [ file2.tif ] ]


       faxinfo prints descriptive information on the standard output  about  a
       received facsimile file.  For example:

                  Sender: +14159657824
                   Pages: 3
                 Quality: Normal
                    Page: North American Letter
                Received: 1996:01:19 13:51:02
              TimeToRecv: 0:39
              SignalRate: 14400 bit/s
              DataFormat: 2-D MR
              ErrCorrect: No
                 CallID1: 2152345678
                 CallID2: 1234

       This  information  is  typically  included  in  the  notification  mail
       generated by the faxrcvd(8) script when  a  facsimile  is  received  by

       -n     suppresses the printing of the filename.

       -b     strips any leading directory of the filename before printing

       -D     prints the actual print strings being used for debug purposes

       Formatting shortcuts:

       -C delim
              Sets the format to a quoted CSV, shortcut to
              -S '"%s"' -s ',"' -e '"' -E '\n'

       -c delim
              Sets the format to a CSV, shortcut to:
              -S '%s' -s ',' -e '' -E '\n'

       -r     Sets the format to raw values, shortcut to:
              -S '' -s '' -e '0 -E ''

       Raw formating:

       -S fmt used to start each fax, it is passed one parameter, the fax file

       -s fmt used to start each field, it is passed one parameter, the  field

       -e fmt used  to  end  each field, it is passed one parameter, the field

       -E fmt used to end each fax, it is passed one parameter, the  fax  file


       The information that faxinfo prints is obtained from the tags stored in
       the TIFF image that is written by the HylaFAX software.  If faxinfo  is
       presented  with  an  invalid  TIFF  image  it  may  print uninteresting
       information.  Similarly if a TIFF image that was not written by HylaFAX
       is  supplied  as  an  argument  then  only  partial  information may be
       printed—this is because HylaFAX stores certain information  in  private
       tags that other TIFF writers may not emit.

       Use  of  the raw fmt options to allow you to directly control the print
       format strings used when formating the output.   These  format  strings
       are  passed  directly  to  printf,  with  basic \<char> sequences being
       interpreted, including \n, \r, and \t, and can  be  used  to  make  the
       faxinfo  output  conform  to  specific requirements, like peculiar CVS,
       tables, HTML, etc.

       The order of the options is important.  They are parsed from  first  to
       last, so any later options will override settings of previous ones.


       faxinfo return 0 on success and 1 if the file passed as argument is not


       hylafax-server(5), faxrcvd(8), faxgetty(8)

                               November 15, 1996                    FAXINFO(8)