RECVSTATS(8)

💖 RECVSTATS(8) 💖

okay bestie, so this one lives in the System Manager's Manual section 8, and it's genuinely one of my faves — it's the little script that tells you the tea about all the faxes your HylaFAX box has been receiving. 🫶

✨ 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. No cap, that's the whole job. 💅

You can sort the stats by one of several keys:

• the caller's CSI (this is the default, bestie — it's the moment)
• CIDName (that's CallID2)
• CIDNumber (that's CallID1)
• the communication speed
• or the communication data format

Where does it read from? It pulls stats from the file /var/spool/hylafax/log/xferfaxlog, unless you hand it filenames on the command line. Then it reads those instead. Periodt. 📁

Here's what the output looks like (this example is using the default sort key, obviously):

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

okay so now let me decode every single column for you, because each one is doing something 🎀

• The Sender column shows the caller's TSI — and notice how some callers literally haven't set up a TSI at all? 😭 iconic of them.
• 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 tells you 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 info only for the facsimile received in the last however-many days you said. 🗓️
• -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 info only for the facsimile received since the specified time; where time is of the form `MM/DD/YY HH:MM` (that's the date(1) format string %D %H:%M). ⏰
• -end time — show info only for the facsimile received before the specified time; where time is of the same form as since.

🎀 FILES 🎀

• /var/spool/hylafax — the spooling area 🗂️
• /var/spool/hylafax/log/xferfaxlog — default file from which to read statistics

🌈 SEE ALSO 🌈

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

and that's the whole page, bestie!! 🫶 this one came from the System Manager's Manual, dated March 3, 1995 — yes, a 90s queen, and she still ate. go summarize those faxes, you've got this 💖✨👑