ROUTERSTAT(8)

💅 ROUTERSTAT(8) — bestie edition

okay so real quick, the manual name is ROUTERSTAT and it lives in section 8 of the Lustre Configuration Utilities docs. she's a system admin girlie. let's get into it 🫶

---

✨ NAME ✨

routerstat — print Lustre router statistics 🦋

---

🌸 SYNOPSIS 🌸

routerstat [INTERVAL]

---

🎀 DESCRIPTION 🎀

okay so routerstat shows you LNET router statistics. that's it, that's the job 💅

if you don't give it an INTERVAL, it samples the stats and prints them only once. if you do give it an INTERVAL, it samples and prints every interval seconds, forever, like a girl who will not stop texting. to make it stop, hit Ctrl+C. 😭

---

the fields, bestie (single sample mode) 🔍

the output has these fields and you WILL learn them:

• M — number of messages currently being processed by LNET (and, in parentheses, the maximum number of messages ever processed by LNET concurrently) — iconic peak-message flex ✨
• E — number of LNET errors 💀
• S — total size (length) of messages sent, in bytes. also the number of messages sent.
• R — total size (length) of messages received, in bytes. also the number of messages received.
• F — total size (length) of messages routed, in bytes. also the number of messages routed.
• D — total size (length) of messages dropped, in bytes. also the number of messages dropped.

---

the fields when you pass an INTERVAL 🔥

when an INTERVAL is specified, extra lines of stats get printed, and the fields mean slightly different things (rates, not totals — do not get these mixed up, i'm begging):

• M — number of messages currently being processed by LNET (and the maximum number of messages ever processed by LNET concurrently) — same as before, still the same energy
• E — number of LNET errors per second
• S — rate of data sent in Mbytes per second. plus the count of messages sent per second.
• R — rate of data received in Mbytes per second. plus the count of messages received per second.
• F — rate of data routed in Mbytes per second. plus the count of messages routed per second.
• D — rate of data dropped in Mbytes per second. plus the count of messages dropped per second.

---

🍓 FILES 🍓

• /proc/sys/lnet/stats — the source of truth, the whole vibe, the file she's reading 👑

---

🌈 EXAMPLES 🌈

# routerstat 1
M 0(13) E 0 S 117379184/4250 R 878480/4356 F 0/0 D 0/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
...

yes she just keeps going. that's the whole point. it's giving "loop that never ends and honestly slays" 💅

---

👑 AVAILABILITY 👑

routerstat is part of the lustre(7) filesystem package, and she's been here since release 0.7.0. a legend. an OG. periodt ✨

---

🦋 SEE ALSO 🦋

• lustre(7)

---

and that's the whole page, bestie 🫶 go sample some stats, be the main character of your own LNET router, no cap 💖

this page is from the Lustre package, dated 2024-08-28, and it's ROUTERSTAT(8) — mwah, stan a well-documented manual, iykyk 🎀