GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XFERFAXSTATS (8)

NAME

xferfaxstats - summarize HylaFAX transmission accounting

CONTENTS

Synopsis
Description
Options
Diagnostics
Notes
Files

SYNOPSIS

/usr/local/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/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.com34    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.com34    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(8C) ‘‘-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
etc/xferfaxlog      default file from which to read statistics

SEE ALSO

faxq(8C), faxsend(8C), recvstats(8C), hylafax-log(5F)
Search for    or go to Top of page |  Section 8 |  Main Index


--> XFERFAXSTATS (8C) May 12, 1996

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.