CNFSSTAT(8)

💅 CNFSSTAT(8) — the cnfsstat glow-up

okay so bestie, welcome to cnfsstat from InterNetNews ✨ this is the little tool that tells you how full your CNFS buffers are, and honestly? she's iconic for it. Let's get into it 🫶

---

✨ NAME ✨

cnfsstat — show usage of CNFS buffers 🌸 (yes that's literally her whole job and she does it beautifully)

---

🦋 SYNOPSIS 🦋

cnfsstat [-ahpPsv] [-c class] [-i seconds] [-l [seconds]] [-m buffer]

---

💖 DESCRIPTION 💖

So first things first, cnfsstat reads pathetc/cycbuff.conf and pathetc/storage.conf to figure out which CNFS buffers even exist. Then she reads the specified cyclic buffers and shows you their usage status. That's the whole vibe check 💅

Fun fact: cnfsstat can be invoked from rc.news if docnfsstat is set to true in inn.conf, and in that case the result gets written to syslog(3) instead of your terminal. very demure, very mindful 🎀

---

🔥 OPTIONS 🔥

• -a — besides her usual output, cnfsstat also prints the age of the oldest article in the cycbuff 👑 ngl you might also wanna pair this with -v to see the extended consistency checks. slay.
• -c class — only print info for the specified class. lowkey a filter, highkey useful 💜
• -h — print usage information and exit. the classic "help meee" flag 😭
• -i seconds — with this one, cnfsstat takes an initial nap of seconds seconds at startup 🦋 super handy when cnfsstat gets started at the same time as INN, so she can wait a lil bit before starting her checks. self-care fr fr.
• -l [seconds] — with this, cnfsstat prints a status snapshot every seconds seconds, and only exits if an error occurs. when seconds isn't given, the default interval is 600 seconds ⏰

At each iteration, cnfsstat checks whether cycbuff.conf and storage.conf have been modified, and loads the new configuration if needed. she stays fresh, no cap ✨

• -m buffer — print info about the specified buffer in a format suitable for MRTG 📊
• -p — print an MRTG config file 🎀
• -P — write the PID into pathrun/cnfsstat.pid 🫶
• -s — write output to syslog(3) instead of standard output 💅
• -v — write additional information, especially about consistency checks for article storage and the history file 👀 this is the "tell me everything" flag bestie.

---

🌈 HISTORY 🌈

Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews. Converted to POD by Julien Elie. 🧚 giving credit where credit is due, always.

---

⭐ SEE ALSO ⭐

cycbuff.conf(5), history(5), inn.conf(5), rc.news(8), storage.conf(5) — go read these too, iykyk 📚

---

and that's the whole page bestie! 💜 this little beauty is from INN 2.7.4, dated 2022-07-10, and honestly? she ate. periodt. 🎀✨