MRTG-UPTIME(1)

📦
version 0.8.4 · 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing

💖 MRTG-UPTIME 💖

okay bestie, so this lil cutie lives in the mrtg helper utilities family (the manual name is literally mrtg-uptime, iykyk) and it's here to pull your uptime + idle numbers straight out of /proc/uptime and hand them over all nice and formatted. 🫶

✨ NAME ✨

mrtg-uptime — returns uptime and idle data from /proc/uptime

🎀 SYNOPSIS 🎀

mrtg-uptime ([-t sys|idle] [-m multiplier] [-u s|m|h|d])*2 [-c #cores]

🌸 DESCRIPTION 🌸

so mrtg-uptime just reads what's chillin' in /proc/uptime and spits it back out in a shape that the MRTG utility can actually eat. nom nom. 🍓

here's the iconic part: every single parameter can be handed to it twice, which is how you get to control the two values in the output. the one exception is -c, which only ever touches the idle uptime. periodt. 💅

  • -t sys|idle — sets the uptime parameter in the output. if you only set one of them, the other one just sits there being zero. sys = the time the system has been up, idle = the time the machine has spent idle. two little moods, pick your fighter. ✨
  • -m multiplier — sets the multiplier used in the output. like, if the value is 280936.41 and you throw a multiplier of 100 at it, the output becomes 28093641. if you define it once, it affects both output values (yes, both, generous queen 👑). the default multiplier is 1.
  • -u s|m|h|d — sets the unit of the parameter. it can be (s)econds, (m)inutes, (h)ours, or (d)ays. if you define it once, it affects both output values. default is seconds. ⏱️
  • -c #cores — okay so this one's a lil detail nobody thinks about: idle uptime measures the cumulative time of each processor, ignoring how many cores you have, so the value you get is the sum of how much time every core spent idle. this parameter divides that value by #cores (an integer) to get the average idle time per core. default is 1. we love an average 💜

🌈 EXAMPLES 🌈

this one prints the average idle uptime of a core in a dual-core and the system uptime, both in minutes. cute.

mrtg-uptime -t idle -t sys -u m -c 2

and this one prints the uptime in hours and in seconds. same param, two vibes, slay.

mrtg-uptime -t sys -u h -t sys -u s

👀 SEE ALSO 👀

mrtg(1)

🫶 AUTHORS 🫶

Randolph Chung <tausq@debian.org> is the orginal writer of mrtgutils. (their spelling, not mine, bestie, we keep it exactly as-is 😭)

Luciano Bello <luciano@debian.org> wrote mrtg-uptime and this manpage. iconic behaviour honestly.

📜 HISTORY 📜

this document first appeared with mrtgutils-0.8.2

and that's the whole page, no cap. it's mrtgutils version 0.8.4, dated 2022-04-01 — consider this your cute lil sign-off, go forth and monitor your uptime 💖✨🦋

📦 where this page comes from