Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FAXINFO(8C)							   FAXINFO(8C)

       faxinfo - print information about a received facsimile

       Basic usage:

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

       Formatting shortcuts:

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

       Raw formatting:

       /usr/local/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	gener-
       ated by the faxrcvd(8C) 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

       -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	infor-
       mation.	 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  in-
       terpreted,  including  \n, \r, and \t, and can be used to make the fax-
       info output conform to specific requirements, like  peculiar  CVS,  ta-
       bles, 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(5F), faxrcvd(8C),	faxgetty(8C)

			       November	15, 1996		   FAXINFO(8C)


Want to link to this manual page? Use this URL:

home | help