recvstats (8)


NAME

recvstats - summarize HylaFAX receive accounting information

SYNOPSIS

/usr/sbin/recvstats [ options ] [ files ]

DESCRIPTION

recvstats is a command script that prints a summary of the HylaFAX accounting statistics for received facsimile. The statistics can be sorted using one of several keys: the caller's CSI (default), CIDName (CallID2), CIDNumber (CallID1), the communication speed, or the communication data format. Statistics are read from the file /var/spool/hylafax/log/xferfaxlog unless filenames are specified on the command line.

The following table is an example of the output from recvstats (using the default sort key):


Sender                CIDName   CIDNumber Pages   Time      Pg/min   Errs   TypRate   TypData
                                          61      30:47     2.0      16     9600      1-DMR
+13037904674                              5       1:34      3.2      2      9600      1-DMH
+14159657824                              1       1:00      1.0      0      9600      1-DMH
+15086636852                              2       0:00      2.0      0      9600      1-DMH
+15105268781                              740     5:47:51   2.1      59     9600      1-DMH
+15105287164                              20      7:00      2.9      0      9600      1-DMH
+15123713545                              3       1:19      2.3      0      9600      1-DMH
+15123713641                              5       1:04      4.6      0      9600      1-DMH
+16099211926                              3       2:00      1.5      0      9600      1-DMH
+17088987617                              1       0:18      3.3      0      9600      1-DMH
415 390 6175                              22      6:01      3.6      0      9600      1-DMH
415 965 7651                              56      34:52     1.6      14     9600      1-DMH
415 973 6723                              1       2:09      0.5      0      9600      2-DMR
49 211 161514                             1       0:00      1.0      0      9600      2-DMR
8185970503                                1       0:28      2.1      0      9600      2-DMR
ALDUS CORPORATION     ALDUS CO  5551212   3       2:34      1.2      0      9600      1-DMH
--------------------------------------------------------------------------------------------------
Total                                     925     7:19:03   2.1      91

The Sender column shows the caller's TSI (notice that some callers have not setup a TSI). The CIDName column is the received CIDName value for the sender. The CIDNumber column is the received CIDNumber value for the sender. The Pages column is the total number of good pages received. The time column shows the total amount of time spent receiving facsimile from a sender. The Pg/min column displays the average transfer rate. The Errs column indicates how many protocol errors were encountered while receiving facsimile. The TypRate column displays the most common communication speed with which facsimile were received. The TypData column shows the most common data format in which facsimile data were received.

OPTIONS

-age days
Show information only for the facsimile received in the last specified number of days.
-csi*
Sort output by caller's CSI.
-cidname
Sort output by CIDName
-cidnumber
Sort output by CIDNumber
-format
Sort output by data format.
-send*
Sort output by sender (i.e. caller's CSI).
-speed
Sort output by signalling rate.
-since time
Show information only for the facsimile received 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 received before the specified time; where time is of the same form as since.

FILES


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

SEE ALSO

faxq(8), xferfaxstats(8), hylafax-log(5)