MPT-STATUS(8)

💖 MPT-STATUS — bestie edition 💖

okay so you know how sometimes your RAID controller is just… vibing and you have no idea what's going on inside it? yeah. that's what this is for. it's mpt-status, from section 8 of the System Manager's Manual, and it's your little window into LSI hardware RAID controllers. ✨

---

🌸 NAME 🌸

mpt-status — the girlies' tool for retrieving configuration and health status straight off LSI hardware RAID controllers. no cap. 🎀

---

✨ SYNOPSIS ✨

mpt-status [ options ]

---

🦋 DESCRIPTION 🦋

so the mpt-status software is literally a query tool — it reaches into your LSI SCSI HBAs and pulls out the running configuration and status. that's it. that's the whole job. 💅

and the point of it? monitoring the health and status of your RAID setup. so you can sleep at night instead of lying awake wondering if a disk is having a moment. iconic behaviour, honestly. 🫶

---

👑 OPTIONS 👑

• --autoload — this one tries to automatically load the mptctl kernel module for you. convenience queen. 💖
• -u, --controller <int> — sets the IOC unit, aka the controller. you're telling it which one, bestie.
• -h, --help — prints some help information. the classic. 🌈
• -n, --newstyle — use the new style output. this parameter exists purely to retain backwards compatibility, so if you don't set it you get the old style output.

⚠️ heads up though: it is very likely that the output of the newstyle format will change heavily in the future. so do not rely on it when you're writing plugins for monitoring software, for example. consider yourself warned. 😭

• -i, --set_id <int> — sets the id of the primary device (go check the README, bestie, it's all in there).
• -p, --probe_id — use this to probe SCSI id's when you're not on id 0. detective mode 🔍
• -q, --quiet — do not display any warnings. shhh. 🙈
• -s, --status_only — only print the status information. this one is perfect for easy scripting, ngl. ⭐
• -v, --verbose — print verbose information, such as warnings. the yapper option. 💀
• -V, --version — print version information.
• -d, --debug [<int>] — enable debugging and set the level optionally.

NOTE: this is not fully implemented yet. so like… it's giving unfinished. don't come for me. 🙈

---

💀 DIAGNOSTICS 💀

okay this part is genuinely important so pay attention bestie. 👑

the program's exit(2) status is meant to be interpreted as a bit mask. if everything went well, zero is returned. if not — i.e. if for example an error or unknown condition is detected — then the bits of the return value shall be interpreted like this:

• Bit 0 → value 1 → Abnormal condition / unknown error
• Bit 1 → value 2 → A logical volume has failed
• Bit 2 → value 4 → A logical volume is degraded
• Bit 3 → value 8 → A logical volume is resyncing
• Bit 4 → value 16 → At least one physical disk failed
• Bit 5 → value 32 → At least one physical disk is in warning condition

so yeah, read your exit codes like a bit mask, not like a single sad number. it's giving ✨layered✨.

---

🐛 REPORTING BUGS 🐛

found a bug? okay so here's the vibe:

report bugs to your linux distribution or software vendor, if mpt-status was bundled on your installation. (they shipped it, they can deal with it 💅)

but if you have been compiling mpt-status from the vanilla sources and experience problems, redirect them — preferably to <ratz@drugphish.ch> or <rnibali@pyx.ch>. 🫶

---

😭 BUGS 😭

besides design bugs, gross software engineering and missing features, this software is considered pretty stable and can be used in production environments. so like… yeah there's some mess, but she works. periodt. 💖

---

🍓 FILES 🍓

• /dev/mptctl

---

🔥 SEE ALSO 🔥

LSI Logic provides CLI tools for megaraid controllers which you can find on their webpage, following http://www.lsil.com/cm/DownloadSearch.do — go look, iykyk. 🌈

---

🧚 AUTHOR 🧚

mpt-status was written by Roberto Nibali <ratz@drugphish.ch>.

This manual page was written by Steffen Joeris <steffen.joeris@skolelinux.de>, for the Debian project (but may be used by others).

---

and that's the whole page, bestie!! 🎀 this was the November 2006 edition of the System Manager's Manual, and that's a wrap — go check your RAID array, she deserves the attention. mwah 💖✨