1XFERFAXSTATS(8C)                                              XFERFAXSTATS(8C)
2
3
4

NAME

6       xferfaxstats - summarize HylaFAX transmission accounting
7

SYNOPSIS

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

DESCRIPTION

12       xferfaxstats  is  a command script that prints a summary of the HylaFAX
13       accounting statistics for transmitted  jobs.   The  statistics  can  be
14       sorted  using one of several keys: the sender's account name (default),
15       the job tag (useful when used  for  accounting  purposes),  the  remote
16       party's  CSI,  the  called phone number, the output device used for the
17       call, the communication speed, and the communication data format.  Sta‐
18       tistics are read from the file /var/spool/hylafax/etc/xferfaxlog in the
19       spooling area, unless filenames are specified on the command line.
20
21       The following table is an  example  of  the  output  from  xferfaxstats
22       (using the default sort key):
23       Destination            Pages   Calls   Time      Pg/min   Errs   TypRate   TypData
24       cadsmith@esd.sgi.com   34      41      24:05     1.4      0      9600      1-D MH
25       ctb@corp.sgi.com       32      42      20:43     1.5      2      9600      2-D MR
26       edmark@esd.sgi.com     42      53      29:30     1.4      3      9600      1-D MH
27       fredc@mfg.sgi.com      157     174     1:37:52   1.6      0      9600      2-D MR
28       jlw@engr.sgi.com       81      90      57:29     1.4      1      9600      1-D MH
29       jlw@wpd.sgi.com        346     411     3:57:57   1.5      100    9600      1-D MH
30       karlton@asd.sgi.com    68      71      36:57     1.8      0      9600      1-D MH
31       kerrie@mfg.sgi.com     48      58      32:29     1.5      1      9600      2-D MR
32       kgraf@mfg.sgi.com      128     130     1:48:21   1.2      2      9600      1-D MH
33       kubey@wpd.sgi.com      264     289     3:22:13   1.3      6      9600      1-D MH
34       loki@wpd.sgi.com       205     225     2:56:45   1.2      5      9600      2-D MR
35       moondog@esd.sgi.com    112     120     1:23:01   1.3      4      9600      2-D MR
36       mpolen@mti.sgi.com     122     129     1:39:32   1.2      1      9600      1-D MH
37       nancyf@mfg.sgi.com     174     180     2:08:44   1.4      2      9600      2-D MR
38       paulh@mfg.sgi.com      56      56      1:29:24   0.6      0      9600      2-D MR
39       richardn@mfg.sgi.com   34      30      24:42     1.4      1      9600      1-D MH
40       rosa@corp.sgi.com      32      30      28:00     1.1      2      9600      1-D MH
41       sam@asd.sgi.com        65      65      46:25     1.4      5      9600      1-D MH
42       seth@asd.sgi.com       34      30      25:04     1.4      0      9600      1-D MH
43       --------------------------------------------------------------------------
44       Total                  2034    2224    25:49:13  1.3      135
45       The  first  column  column  shows the sort key value used (the sender's
46       identity here, but otherwise the destination phone number, remote  CSI,
47       etc.).  The Pages column is the total number of good pages transmitted.
48       The Calls column is the total number of calls placed.  The time  column
49       shows  the  total amount of time spent transmitting.  The Pg/min column
50       displays the average transfer rate.  The Errs column indicates how many
51       errors  were encountered while transmitting facsimile.  (Note that this
52       statistic does not include problems encountered while placing  a  call;
53       e.g.   busy signals.)  The TypRate column displays the most common com‐
54       munication speed with which facsimile were  transmitted.   The  TypData
55       column  shows  the most common data format in which facsimile data were
56       transmitted.
57
58       Account names other than ``root'' and ``guest''  can  be  automatically
59       mapped  to  a  canonical  format  in which the host name is removed and
60       identical addresses in the same domain are merged  together  (i.e.  for
61       NIS   environments).    For   example,   ``sam@flake.asd.sgi.com''  and
62       ``sam@foobar.asd.sgi.com'' are both mapped to ``sam@asd.sgi.com''  with
63       the associated statistics accumulated.  Identical account names in dif‐
64       ferent  domains  generate  a  warning;  e.g.  ``loki@wpd.sgi.com''  and
65       ``loki@corp.sgi.com''.   The  above  mapping  is  done only if the -map
66       option is specified, by default account names are not altered.
67

OPTIONS

69       -age days   Show information only for the facsimile transmitted in  the
70                   last specified number of days.
71
72       -csi*       Sort output by the remote party's CSI.
73
74       -dest*      Sort output by the phone number called.
75
76       -dev*       Sort output by the output device (i.e. modem) used.
77
78       -format     Sort output by the negotiated data format.
79
80       -job*       Sort output by client-specified job tag identifiers.
81
82       -nomap      Do not perform the account name mapping by which statistics
83                   for the ``root'' and  ``guest''  accounts  are  merged  and
84                   leading  hostname  part of domain names are stripped.  This
85                   is the default behavior.
86
87       -map        Perform the account name mapping by  which  statistics  for
88                   the  ``root'' and ``guest'' accounts are merged and leading
89                   hostname part of domain names are stripped.
90
91       -send*      Sort output by sender's account name (default).
92
93       -since time Show information only for the facsimile  transmitted  since
94                   the  specified  time;  where time is of the form ``MM/DD/YY
95                   HH:MM'' (the date(1) format string %D %H:%M).
96
97       -end time   Show information only for the facsimile transmitted  before
98                   the  specified  time;  where  time  is  of the same form as
99                   since.
100
101       -speed      Sort output by the signalling rate.
102

DIAGNOSTICS

104       ``Warning, address clash, "%s" and "%s".''  During address mapping  two
105       mapped addresses were found for the same account name.
106
107       ``Warning,  weird  user address/name "%s".''  During address mapping an
108       address was encountered that multiple ``@'' symbols in it.
109

NOTES

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

FILES

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

SEE ALSO

121       faxq(8C), faxsend(8C), recvstats(8C), hylafax-log(5F)
122
123
124
125                                 May 12, 1996                 XFERFAXSTATS(8C)
Impressum