NAME

       faxinfo - print information about a received facsimile

SYNOPSIS

       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 ] ]

DESCRIPTION

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

              /var/spool/hylafax/recvq/fax00017.tif:
                  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 HylaFAX.

       -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 name

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

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

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

NOTES

       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.

ERRORS

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

SEE ALSO

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

                                                November 15, 1996                                     FAXINFO(8)