luastatu...ge-linux(7)

💖 NAME 💖

luastatus-plugin-cpu-usage-linux — the Linux-specific CPU usage plugin for luastatus, and yes bestie, this whole page lives in the Miscellaneous Information Manual. It's niche, it's useful, it's lowkey iconic. 💅

✨ OVERVIEW ✨

So this is a derived plugin, and what it does is periodically poll Linux sysfs for the rate of CPU usage. That's the vibe: poll, calculate, slay. 🦋

🛠️ FUNCTIONS 🛠️

The following functions are provided, bestie — memorize them, they're not long:

• get_usage(cur, prev[, cpu]) — returns the current CPU usage rate, or nil if the amount of data collected is insufficient yet. (Growing pains, honestly.) 😭

If cpu is passed and is not nil, it specifies the CPU number, starting with 1. Otherwise, the average rate will be calculated. 🧮

To use this function, you're expected to maintain two tables, cur and prev, both initially empty. After calling the function, you need to swap them, i.e. run cur, prev = prev, cur. Yes, literally swap them — that's the whole ritual. 🔁

This function must be invoked each second. Not "whenever", not "when you remember" — each second. Periodt. ⏰

• widget(tbl) — constructs a widget table required by luastatus. tbl is a table with the following fields:

(required)

• cb — a function. This is the callback function that will be called with the current CPU usage rate, or with nil. 📞

(optional)

• cpu — a number. CPU number, starting with 1. 🔢
• event — the event entry of the resulting table (see the luastatus documentation for the description of the widget.event field). 👀

📜 COPYRIGHT 📜

LGPLv3, bestie. That's the license, and we respect it. 🫶

---

Okay that's the page! It's luastatus-plugin-cpu-usage-linux(7) from the Miscellaneous Information Manual, and the original footer only repeats the truncated title luastatu...ge-linux(7) — no separate source version or date is shown, so I'm not inventing one, bestie. 💖✨