MPSUTIL(8)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

🌸 MPSUTIL(8) 💅

okay bestie, so this is the manual for mpsutil (and its twin mprutil) — the System Manager's Manual page, no less. Pull up a chair, we're gonna talk about LSI Fusion-MPT 2/3 controllers and it's gonna be iconic.

✨ NAME ✨

mpsutil, mprutil — a whole utility for managing LSI Fusion-MPT 2/3 controllers. that's the vibe. 🎀

🦋 SYNOPSIS 🦋

like, the shape of it is: zero or more global options, then a command. here's every single way you can call it, no cap:

mpsutil version
mpsutil [-u unit] show adapter
mpsutil [-u unit] show adapters
mpsutil [-u unit] show all
mpsutil [-u unit] show cfgpage page [num] [addr]
mpsutil [-u unit] show devices
mpsutil [-u unit] show enclosures
mpsutil [-u unit] show expanders
mpsutil [-u unit] show iocfacts
mpsutil [-u unit] set ncq [enable|disable]
mpsutil [-u unit] flash save [firmware|bios] [file]
mpsutil [-u unit] flash update [firmware|bios] file

💖 DESCRIPTION 💖

so, the mpsutil utility can be used to display or modify various parameters on LSI Fusion-MPS 2 controllers. 🫶

and the mprutil utility can be used to do the exact same display-or-modify thing on LSI Fusion-MPS 3 controllers. same energy, different chip gen.

both the mprutil and mpsutil commands behave identically — like, truly identical, they're giving twins in matching outfits. 👑

each invocation of mpsutil consists of zero or more global options followed by a command. and heads up: commands may support additional optional or required arguments after the command itself. so the options come first, then the command, then whatever that command wants from you.

currently one global option is supported, and it's this one right here:

  • -u unit — unit specifies the unit of the controller to work with. and if no unit is specified? then unit 0 is used. default slay.

the mpsutil utility supports several different groups of commands. the first group of commands provide information about the controller. the second group of commands are used to manage controller-wide operations. info girlies vs. management girlies, both valid. 🌈

🌟 the informational commands include:

  • version — displays the version of mpsutil. that's it, that's the whole thing. a little selfie.
  • show adapter — displays information about the controller, such as the model number or firmware version. the basics, bestie.
  • show adapters — displays a summary of all adapters. plural, we're zooming out.
  • show all — displays all devices, expanders and enclosures. the full feed, no filtering.
  • show devices — displays all devices.
  • show expanders — displays all expanders.
  • show enclosures — displays all enclosures.
  • show iocfacts — displays IOC Facts messages. yes, that's what it's called. iykyk.
  • show cfgpage page [num] [addr] — dump raw config page in hex. raw. hex. bring your reading glasses. 🔥

🧚 the controller management commands include:

  • set ncq [enable|disable] — enables or disables NCQ in the NVRAM of the card. so like, this one actually changes things. NVRAM. permanent-ish. main character energy. ⭐
  • flash save [firmware|bios] [file] — save the firmware or bios from the controller into a local file. and if no file is specified, then the file will be named firmware or bios. it names itself, we love a self-sufficient file. 🍓
  • flash update [firmware|bios] file — replace the firmware or bios from the controller with the one specified via file. note that here the file is not optional, bestie, you gotta give it something. 🎀
fr fr though, flash update writes to your controller's firmware. be chill, double-check your file. the manpage isn't gonna hold your hand past this point.

🌈 SEE ALSO 🌈

mpr(4), mps(4) — go read those too, they're the lore. 📚

💜 HISTORY 💜

the mpsutil utility first appeared in FreeBSD 11.0. a legend was born. ✨

💀 TODO 💀

okay so this is the part where we keep it real: flash operations (save/update) are not supported on big-endian architectures. that's the whole todo entry. it's giving "known limitation, we're aware, moving on." 🙈

and that's the page, bestie!! 🫶 this was the Debian build of MPSUTIL(8) from the System Manager's Manual, dated May 7, 2021 — go forth and show adapter responsibly 💅💖

📦 where this page comes from