Provided by: hylafax-server_6.0.6-5_amd64 bug

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

       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 sendfax(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)