XFERFAXSTATS(8) 					      System Manager's Manual						   XFERFAXSTATS(8)

NAME

       xferfaxstats - summarize HylaFAX transmission accounting

SYNOPSIS

       /usr/sbin/xferfaxstats [ options ] [ files ]

DESCRIPTION

       xferfaxstats  is  a  command script that prints a summary of the HylaFAX accounting statistics for transmitted jobs.  The statistics can be
       sorted using one of several keys: the sender's account name (default), the job tag (useful when used for accounting purposes),  the  remote
       party's	CSI,  the  called  phone  number, the output device used for the call, the communication speed, and the communication data format.
       Statistics are read from the file /var/spool/hylafax/log/xferfaxlog in the spooling area, unless filenames are  specified  on  the  command
       line.

       The following table is an example of the output from xferfaxstats (using the default sort key):
       Destination	      Pages   Time	Pg/min	 Errs	TypRate   TypData
       cadsmith@esd.sgi.com   34      24:05	1.4	 0	9600	  1-D MH
       ctb@corp.sgi.com       32      20:43	1.5	 2	9600	  2-D MR
       edmark@esd.sgi.com     42      29:30	1.4	 3	9600	  1-D MH
       fredc@mfg.sgi.com      157     1:37:52	1.6	 0	9600	  2-D MR
       jlw@engr.sgi.com       81      57:29	1.4	 1	9600	  1-D MH
       jlw@wpd.sgi.com	      346     3:57:57	1.5	 100	9600	  1-D MH
       karlton@asd.sgi.com    68      36:57	1.8	 0	9600	  1-D MH
       kerrie@mfg.sgi.com     48      32:29	1.5	 1	9600	  2-D MR
       kgraf@mfg.sgi.com      128     1:48:21	1.2	 2	9600	  1-D MH
       kubey@wpd.sgi.com      264     3:22:13	1.3	 6	9600	  1-D MH
       loki@wpd.sgi.com       205     2:56:45	1.2	 5	9600	  2-D MR
       moondog@esd.sgi.com    112     1:23:01	1.3	 4	9600	  2-D MR
       mpolen@mti.sgi.com     122     1:39:32	1.2	 1	9600	  1-D MH
       nancyf@mfg.sgi.com     174     2:08:44	1.4	 2	9600	  2-D MR
       paulh@mfg.sgi.com      56      1:29:24	0.6	 0	9600	  2-D MR
       richardn@mfg.sgi.com   34      24:42	1.4	 1	9600	  1-D MH
       rosa@corp.sgi.com      32      28:00	1.1	 2	9600	  1-D MH
       sam@asd.sgi.com	      65      46:25	1.4	 5	9600	  1-D MH
       seth@asd.sgi.com       34      25:04	1.4	 0	9600	  1-D MH
       --------------------------------------------------------------------------
       Total		      2034    25:49:13	1.3	 135
       The  first column column shows the sort key value used (the sender's identity here, but otherwise the destination phone number, remote CSI,
       etc.).  The Pages column is the total number of good pages transmitted.	The time column shows the total amount of time spent transmitting.
       The  Pg/min  column displays the average transfer rate.	The Errs column indicates how many errors were encountered while transmitting fac-
       simile.	(Note that this statistic does not include problems encountered while placing a call; e.g.  busy  signals.)   The  TypRate  column
       displays  the  most common communication speed with which facsimile were transmitted.  The TypData column shows the most common data format
       in which facsimile data were transmitted.

       Account names other than ``root'' and ``guest'' can be automatically mapped to a canonical format in which the host  name  is  removed  and
       identical  addresses  in  the  same  domain  are  merged  together (i.e. for NIS environments).	For example, ``sam@flake.asd.sgi.com'' and
       ``sam@foobar.asd.sgi.com'' are both mapped to ``sam@asd.sgi.com'' with the associated statistics accumulated.  Identical account  names	in
       different  domains  generate  a	warning;  e.g. ``loki@wpd.sgi.com'' and ``loki@corp.sgi.com''.	The above mapping is done only if the -map
       option is specified, by default account names are not altered.

OPTIONS

       -age days   Show information only for the facsimile transmitted in the last specified number of days.

       -csi*	   Sort output by the remote party's CSI.

       -dest*	   Sort output by the phone number called.

       -dev*	   Sort output by the output device (i.e. modem) used.

       -format	   Sort output by the negotiated data format.

       -job*	   Sort output by client-specified job tag identifiers.

       -nomap	   Do not perform the account name mapping by which statistics for the ``root'' and ``guest''  accounts  are  merged  and  leading
		   hostname part of domain names are stripped.	This is the default behavior.

       -map	   Perform  the  account  name mapping by which statistics for the ``root'' and ``guest'' accounts are merged and leading hostname
		   part of domain names are stripped.

       -send*	   Sort output by sender's account name (default).

       -since time Show information only for the facsimile transmitted since the specified time; where time is of the form ``MM/DD/YY HH:MM'' (the
		   date(1) format string %D %H:%M).

       -end time   Show information only for the facsimile transmitted before the specified time; where time is of the same form as since.

       -speed	   Sort output by the signalling rate.

DIAGNOSTICS

       ``Warning, address clash, "%s" and "%s".''  During address mapping two mapped addresses were found for the same account name.

       ``Warning, weird user address/name "%s".''  During address mapping an address was encountered that multiple ``@'' symbols in it.

NOTES

       The  sender  field  does  not necessarily represent the submitter's actual identity.  For example, it reflects the value given by the send-
       fax(8) ``-f'' option.  Be cautious that this field is not utilized for auditing if the fax user base is not trusted.

FILES

       /var/spool/hylafax    spooling area
       log/xferfaxlog	     default file from which to read statistics

SEE ALSO

       faxq(8), faxsend(8), recvstats(8), hylafax-log(5)

								   May 12, 1996 						   XFERFAXSTATS(8)