1XFERFAXSTATS(8C) XFERFAXSTATS(8C)
2
6 xferfaxstats - summarize HylaFAX transmission accounting
7
9 /usr/sbin/xferfaxstats [ options ] [ files ]
10
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 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 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
69 -age days Show information only for the facsimile transmitted in the
70 last specified number of days.
71 -csi* Sort output by the remote party's CSI.
73 -dest* Sort output by the phone number called.
75 -dev* Sort output by the output device (i.e. modem) used.
77 -format Sort output by the negotiated data format.
79 -job* Sort output by client-specified job tag identifiers.
81 -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 -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 -send* Sort output by sender's account name (default).
92 -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 -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 -speed Sort output by the signalling rate.
102
104 ``Warning, address clash, "%s" and "%s".'' During address mapping two
105 mapped addresses were found for the same account name.
106 ``Warning, weird user address/name "%s".'' During address mapping an
108 address was encountered that multiple ``@'' symbols in it.
109
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
117 /var/spool/hylafax spooling area
118 etc/xferfaxlog default file from which to read statistics
119
121 faxq(8C), faxsend(8C), recvstats(8C), hylafax-log(5F)
122 May 12, 1996 XFERFAXSTATS(8C)