PPPSTATS(8)

💖 PPPSTATS 💖

okay bestie, gather round, because we're talking about pppstats, a whole member of the System Manager's Manual squad (section 8, the big-kid section, we love her). She prints PPP statistics. That's the whole vibe. Let's get into it. 🎀

---

✨ SYNOPSIS ✨

pppstats [ -a ] [ -d ] [ -v ] [ -r ] [ -z ] [ -c <count> ] [ -w <secs> ]
[ interface ]

that's it, that's the whole incantation, no cap ✨

---

🌸 DESCRIPTION 🌸

so like, the pppstats utility reports PPP-related statistics at regular intervals for the PPP interface you point at. Didn't name an interface? No stress, she defaults to ppp0. periodt. 💅

The display splits horizontally into an input section and an output section, and those sections hold columns of statistics describing the properties and volume of packets received and transmitted by the interface. it's giving spreadsheet but make it serve 🦋

The options are as follows:

🎀 OPTIONS 🎀

• -a — Display absolute values rather than deltas. With this option, all reports show statistics for the time since the link was initiated. Without it, the second and subsequent reports show statistics for the time since the last report. (delta girlies vs absolute girlies, both valid 🙈)
• -d — Show data rate (kB/s) instead of bytes. slay, units.
• -c count — Repeat the display count times. If this option is not specified, the default repeat count is 1 if the -w option is not specified, otherwise infinity. 🔥 (infinity is not a drill)
• -r — Display additional statistics summarizing the compression ratio achieved by the packet compression algorithm in use.
• -v — Display additional statistics relating to the performance of the Van Jacobson TCP header compression algorithm. iconic algorithm, honestly.
• -w wait — Pause wait seconds between each display. If this option is not specified, the default interval is 5 seconds.
• -z — Instead of the standard display, show statistics indicating the performance of the packet compression algorithm in use.

---

🌈 THE INPUT SIDE FIELDS 🌈

The following fields are printed on the input side when the -z option is not used:

• IN — The total number of bytes received by this interface.
• PACK — The total number of packets received by this interface.
• VJCOMP — The number of header-compressed TCP packets received by this interface.
• VJUNC — The number of header-uncompressed TCP packets received by this interface. Not reported when the -r option is specified.
• VJERR — The number of corrupted or bogus header-compressed TCP packets received by this interface. Not reported when the -r option is specified.
• VJTOSS — The number of VJ header-compressed TCP packets dropped on reception by this interface because of preceding errors. Only reported when the -v option is specified.
• NON-VJ — The total number of non-TCP packets received by this interface. Only reported when the -v option is specified.
• RATIO — The compression ratio achieved for received packets by the packet compression scheme in use, defined as the uncompressed size divided by the compressed size. Only reported when the -r option is specified.
• UBYTE — The total number of bytes received, after decompression of compressed packets. Only reported when the -r option is specified.

---

💜 THE OUTPUT SIDE FIELDS 💜

The following fields are printed on the output side:

• OUT — The total number of bytes transmitted from this interface.
• PACK — The total number of packets transmitted from this interface.
• VJCOMP — The number of TCP packets transmitted from this interface with VJ-compressed TCP headers.
• VJUNC — The number of TCP packets transmitted from this interface with VJ-uncompressed TCP headers. Not reported when the -r option is specified.
• NON-VJ — The total number of non-TCP packets transmitted from this interface. Not reported when the -r option is specified.
• VJSRCH — The number of searches for the cached header entry for a VJ header compressed TCP packet. Only reported when the -v option is specified.
• VJMISS — The number of failed searches for the cached header entry for a VJ header compressed TCP packet. Only reported when the -v option is specified.
• RATIO — The compression ratio achieved for transmitted packets by the packet compression scheme in use, defined as the size before compression divided by the compressed size. Only reported when the -r option is specified.
• UBYTE — The total number of bytes to be transmitted, before packet compression is applied. Only reported when the -r option is specified.

---

🧚 THE -z ERA 🧚

When the -z option is specified, pppstats instead displays the following fields, relating to the packet compression algorithm currently in use.

if packet compression is not in use, these fields will all display zeroes. just zeroes. nothing to see. 💀

🌸 the -z input side 🌸

• COMPRESSED BYTE — The number of bytes of compressed packets received.
• COMPRESSED PACK — The number of compressed packets received.
• INCOMPRESSIBLE BYTE — The number of bytes of incompressible packets (that is, those which were transmitted in uncompressed form) received.
• INCOMPRESSIBLE PACK — The number of incompressible packets received.
• COMP RATIO — The recent compression ratio for incoming packets, defined as the uncompressed size divided by the compressed size (including both compressible and incompressible packets).

💜 the -z output side 💜

• COMPRESSED BYTE — The number of bytes of compressed packets transmitted.
• COMPRESSED PACK — The number of compressed packets transmitted.
• INCOMPRESSIBLE BYTE — The number of bytes of incompressible packets transmitted (that is, those which were transmitted in uncompressed form).
• INCOMPRESSIBLE PACK — The number of incompressible packets transmitted.
• COMP RATIO — The recent compression ratio for outgoing packets.

---

👑 SEE ALSO 👑

• pppd(8)

---

and that's the whole page, bestie 🫶 this one's from the System Manager's Manual, and it was dated 26 June 1995 — like, vintage vintage — and yeah, the footer just says PPPSTATS(8) again because she loves a little signature moment. mwah 💅💖