CAPSTATS(8)

📦 version 0.31, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 CAPSTATS(8) — the capstats girlie manual 💖

okay bestie, welcome to capstats(8) from the System Manager's Manual section — yes she's a section 8 girlie, admin-coded, iconic. let's get into it 🫶

✨ NAME ✨

capstats — prints stats about the current load on a network interface. that's it, that's the whole vibe 💅

🌸 SYNOPSIS 🌸

capstats [ options ] -i interface

🦋 DESCRIPTION 🦋

okay so this manual page documents briefly the capstats command. brief queen, but we're still gonna cover everything, no cap.

capstats is a program that prints statistics about the current load on a network interface, and she does it using libpcap. she reports stats per time interval and/or for the tool's total run-time. so like, both? both. we love options 💖

here's an example output, with output in one-second intervals until you hit CTRL-C:

>capstats -i eth0 -I 1
1186620936.890567 pkts=12747 kpps=12.6 kbytes=10807 mbps=87.5
nic_pkts=12822 nic_drops=0 u=960 t=11705 i=58 o=24 nonip=0
1186620937.901490 pkts=13558 kpps=13.4 kbytes=11329 mbps=91.8
nic_pkts=13613 nic_drops=0 u=1795 t=24339 i=119 o=52 nonip=0
1186620938.912399 pkts=14771 kpps=14.6 kbytes=13659 mbps=110.7
nic_pkts=14781 nic_drops=0 u=2626 t=38154 i=185 o=111 nonip=0
1186620939.012446 pkts=1332 kpps=13.3 kbytes=1129 mbps=92.6
nic_pkts=1367 nic_drops=0 u=2715 t=39387 i=194 o=112 nonip=0
=== Total
1186620939.012483 pkts=42408 kpps=13.5 kbytes=36925 mbps=96.5 nic_pkts=1
nic_drops=0 u=2715 t=39387 i=194 o=112 nonip=0

like look at those numbers go. the === Total line is her little summary moment at the end, main character energy honestly 👑

✨ OPTIONS ✨

these programs follow the usual GNU command line syntax, with long options starting with two dashes (-). a summary of options is included below. we're listing every single one, no skipping, because we respect her 🎀

  • -i, --interface interface — Listen on interface. this one's the moment, she's required in the synopsis and everything.
  • -d, --dag — Use native DAG API, but only if capstats was built with DAG support. conditional queen 💅
  • -f, --filter filter — BPF filter. yes, the tcpdump-filter kind. slay.
  • -I, --interval secs — Stats logging interval. how often she spills the stats.
  • -l, --syslog — Use syslog rather than print to stderr. quiet luxury.
  • -n, --number count — Stop after outputting count intervals. she can stop, she just doesn't want to.
  • -p, --payload n — Verifies that packets' payloads consist entirely of bytes of the given value. she's checking, fr fr.
  • -q, --quiet count — Suppress output, and the exit code indicates >= count packets received. silent but the exit code is doing all the talking 😭
  • -S, --size size — Verify packets to have given size.
  • -s, --snaplen size — Use pcap snaplen size.
  • -v, --version — Print version and exit. short and sweet, we stan a clean exit 🫶
  • -w, --write filename — Write packets to filename. she's taking notes.

💜 SEE ALSO 💜

🌈 AUTHOR 🌈

capstats was written by Robin Sommer <robin@icir.org>

This manual page was written by Justin Azoff <JAzoff@uamail.albany.edu>, for the Debian project (but may be used by others). generous king, sharing the manual page with the whole group chat 🎀

okay that's the whole page bestie, you ate, go sniff some packets 💖✨🦋

this was the capstats(8) page, dated January 15, 2010 — she's a 2010 queen and she still hits. periodt. 👑

📦 where this page comes from