LEDMON(8)

📦
version 1.1.0 · 9 versions
, in opensuse-leap 16.0

💖 LEDMON 💖 — the Intel(R) LED Monitor, manual section 8 🦋

okay so bestie, welcome to LEDMON(8) — yes, section 8, the "system administration commands" section, we love a grown-up section. This is the page for ledmon, and it's giving "quiet little daemon that runs your LED situation" and honestly? Iconic. 🎀

✨ SYNOPSIS ✨

ledmon [OPTIONS]

that's it, that's the whole vibe. run it, maybe with some OPTIONS, and let it cook. 💅

🦋 DESCRIPTION 🦋

okay so here's the tea: ledmon is a daemon — a background program, the kind that just lives in your machine and minds its own business — and what it does is monitor the state of your hard drives, both the local ones and the external ones, and then show you that state through the LEDs. Yes. Actual little lights. On your disk enclosure. It's giving disco but make it systems administration. ✨

The whole point is that you can glance at your hardware and see what's going on instead of having to ssh in and interrogate seventeen different tools. ledmon keeps the LEDs in sync with reality so you don't have to. Periodt.

Before you get too excited though, bestie, there are two very real things you need:

⚠️ ledmon needs the kernel support for LED / enclosure management to actually be there (think the SGPIO / SES-2 style enclosure management bits). No driver, no lights — the daemon can't manifest LEDs out of sheer willpower, sadly. 😭 ⚠️ It also needs the privileges to talk to that hardware — so run it as root, not as your regular little user account. Root or bust, fr fr.

🌸 OPTIONS 🌸

okay, the menu. one bullet per flag, no skips, we're thorough in this household. 💅

  • -h, --help — prints the usage message and dips. if you're ever lost, start here.
  • -v, --version — tells you which version of ledmon you're running, then exits. cute little flex.
  • --dump-block — dumps out info about the block devices it can see and exits, instead of hanging around as a daemon. detective mode 🔍
  • -l, --log-level=<level> — sets how chatty the log is. the levels are ERROR, WARNING, INFO, DEBUG and ALL, going from "only scream if something's on fire" to "tell me literally everything, I want the whole group chat".
  • --log-path=<path> — where the log file goes. point it somewhere your filesystem actually wants a log file to live.
  • -t, --interval=<seconds> — how often the daemon wakes up to check on things, in seconds. smaller number = more checking = more CPU doing its little jog. 🏃‍♀️
  • --error-log=<path> — a separate path for the error log, so the bad news gets its own folder to live in.
  • --led-config=<path> — path to the LED configuration file, if you've got one and you're feeling fancy.
  • --power-mode=<type> — picks the power mode used for the LED handling. check your hardware and your config, bestie, don't just guess. 🫶
  • --rebuild-mode=<type> — picks how rebuild activity gets shown on the LEDs. this one's about how the light tells you a rebuild is happening.
  • --shared-lib-path=<path> — path to the shared library ledmon should load. for when things aren't where the default expects them to be. 🙈
💀 real talk: a bunch of these want specific values, and the values are hardware-and-config dependent. If something looks off, check the docs for your enclosure and your kernel driver before you start flailing. don't come for me, I'm just the messenger.

🎀 FILES 🎀

  • the daemon's log — wherever you pointed --log-path (and the error log, wherever --error-log pointed it).
  • the LED configuration file — the one you hand over with --led-config.

⭐ EXIT STATUS ⭐

  • 0 — slay. it did the thing (or printed the thing) and left cleanly. ✅
  • non-zero — something went sideways. go read the log, bestie, it's literally right there. 😭

👑 SEE ALSO 👑

  • ledctl(8) — the other half of this duo. the one you actually poke at when you want to do stuff instead of just watching. 🔥

ledmon comes from the ledmon project — Copyright (C) 2013 Intel Corporation — and it's distributed under the GNU General Public License, version 2 (GPLv2). read the license, it's good for you. 📚

okay and finally, the cute little sign-off you knew was coming: this whole page is the LEDMON(8) man page from ledmon, dated 2013-08-01, and now you know everything it knows, bestie. go forth, watch your LEDs, and remember — root privileges, correct kernel support, and a good log file will carry you further than any vibes. mwah 💋🫶✨

📦 where this page comes from