RECVSTATS(8C)

💖 RECVSTATS 💖

okay bestie, so you know how HylaFAX keeps receipts on every fax it receives? this is the little script that reads those receipts and makes a whole cute summary out of them. it's recvstats, it lives in section 8C of the manual, and honestly? it ate. let's go. 🦋

---

✨ SYNOPSIS ✨

/usr/bin/recvstats [ options ] [ files ]

---

🌸 DESCRIPTION 🌸

recvstats is a command script that prints out a summary of the HylaFAX accounting statistics for received facsimile. basically: all the tea about who faxed you, how fast, and how badly it went. 💅

you can sort that summary with one of several keys:

• the caller's CSI (this is the default, no cap)
• CIDName (aka CallID2)
• CIDNumber (aka CallID1)
• the input device used for the call
• the communication speed
• the communication data format

and where does it read all this from? from the file /var/spool/hylafax/etc/xferfaxlog — unless you specify filenames on the command line, in which case it reads those instead. periodt.

so here's an example of what the output looks like (using the default sort key, bestie):

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

now let me walk you through every single column because the way this table is organized is lowkey a work of art: 🎀

• Sender — this is the caller's TSI. and yes, notice that some of these callers haven't even set up a TSI, which is why some rows look a lil empty. we don't judge. 🙈
• CIDName — the received CIDName value for the sender.
• CIDNumber — the received CIDNumber value for the sender.
• Pages — the total number of good pages received. only the good ones, we don't count the mess.
• Time — the total amount of time spent receiving facsimile from that sender. look at that 5:47:51, someone was committed. 😭
• Pg/min — the average transfer rate.
• Errs — how many protocol errors were encountered while receiving facsimile. drama count, basically.
• TypRate — the most common communication speed at which facsimile were received.
• TypData — 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 specify. a lil time filter, we love her.
• -csi* — sort the output by the caller's CSI.
• -cidname — sort the output by CIDName
• -cidnumber — sort the output by CIDNumber
• -dev* — sort the output by the input device (i.e. modem) used. which modem ate, and which modem was just there.
• -format — sort the output by data format.
• -send* — sort the output by sender (i.e. caller's CSI).
• -speed — sort the output by signalling rate.
• -since time — show info only for the facsimile received since the specified time. and time has to be in the form MM/DD/YY HH:MM, which is literally the date(1) format string %D %H:%M. copy it exactly bestie, the script is not flexible about this. 💀
• -end time — show info only for the facsimile received before the specified time. and time is the same form as since. same rules, same energy.

---

🗂️ FILES 🗂️

• /var/spool/hylafax — spooling area
• /var/spool/hylafax/etc/xferfaxlog — default file from which to read statistics

---

🫶 SEE ALSO 🫶

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

---

and that's the whole page, bestie!! ✨ this little icon was brought to you by HylaFAX, dated March 3, 1995 — yes she's vintage, yes she still serves. go read your logs, go sort by -speed, go be the main character of your own fax server. iykyk 💜💅🎀