HylaFAX Home
Download HylaFAX
About HylaFAX
HylaFAX Howto
HylaFAX Setup
HylaFAX Links
HylaFAX Frequently Asked Questions
HylaFAX Mailing List
HylaFAX Search
HylaFAX Troubleshooting


Section: Maintenance Commands (8C)
Updated: May 12, 1996
Index Return to Main Contents


xferfaxstats - summarize HylaFAX transmission accounting  


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


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/etc/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 MR
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 MR
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 MR
jlw@wpd.sgi.com        346     3:57:57   1.5      100    9600      1-D MR
karlton@asd.sgi.com    68      36:57     1.8      0      9600      1-D MR
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 MR
kubey@wpd.sgi.com      264     3:22:13   1.3      6      9600      1-D MR
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 MR
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 MR
rosa@corp.sgi.com      32      28:00     1.1      2      9600      1-D MR
sam@asd.sgi.com        65      46:25     1.4      5      9600      1-D MR
seth@asd.sgi.com       34      25:04     1.4      0      9600      1-D MR
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 facsimile. (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.

By default, account names other than ``root'' and ``guest'' are automatically mapped to a canonical format in which the host name is removed and identical addresses in the same domain are merged together. 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''. If the -nomap option is specified, then the above mapping is not done and account names are not altered.  


Sort output by the remote party's CSI.
Sort output by the phone number called.
Sort output by the output device (i.e. modem) used.
Sort output by the negotiated data format.
Sort output by client-specified job tag identifiers.
Supress the normal account name mapping by which statistics for the ``root'' and ``guest'' acounts are merged and leading hostname part of domain names are stripped.
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).
Sort output by the signalling rate.


``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.  


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


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


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




This document was created by man2html, using the manual pages.
Time: 09:07:33 GMT, June 23, 2001
VirtuALL Private Host Services
Report any problems to webmaster@hylafax.org

HylaFAX is a trademark of Silicon Graphics Corporation.
Internet connectivity for hylafax.org is provided by:
VirtuALL Private Host Services