MLNXOFEDCTL(8)

📦 version 23.07, in epel 10, epel 9, fedora 43, fedora 44

💖 MLNXOFEDCTL 💖

okay bestie, welcome to mlnxofedctl, a manual page from the System Manager's Manual section 8, which is the "commands you run as root" section, iykyk 💅

✨ NAME ✨

mlnxofedctl — load and unload mlnx-ofed kernel modules 🧚

🌸 SYNOPSIS 🌸

mlnxofedctl [-a|--altmods]<command>

🦋 DESCRIPTION 🦋

so like, mlnxofedctl is basically a wrapper around /etc/init.d/openibd or /etc/init.d/mlnx_en.d (that second one is in mlnx_en, okay?). that "init.d" script is being used as a script and should not. 💀

currently it supports all the commands that openibd supports, but it may grow some extra functionality in the future. main character energy, honestly. 👑

🎀 OPTIONS 🎀

  • -a, --altmods — loads modules from /host/lib/modules instead of from /lib/modules. and the way it does that? it runs the whole command in a separate mounts namespace. obsessed with the commitment honestly. ✨

💜 Supported commands 💜

  • start — load modules. in some cases it calls restart on its own, because it senses that a wrong version of the modules is loaded. yes bestie it has intuition. 🔮
  • force-start — okay so the start operation also checks that the modules are ones that are provided in the mlnx-ofed-kernel / mlnx-ofa_kernel / mlnx_en modules package (rpm or deb). if they're not, it will refuse to load modules to make sure that inbox modules will not be used.

force-start ignores this sanity check and allows using modules that were not part of the MLNX_OFED / mlnx-en packages. this is also useful if you want to use kernel modules you built manually. DIY queen 🛠️

  • stop — unload modules. note that this unloads not only current modules but also various modules that were previously part of mlnx-ofa_kernel (such as mlnx4_core and rdma_rxe) to simplify upgrades. it's giving "clean slate, no baggage" 🌈
  • restart — stop and start. short king of a command. 🫶
  • force-stop, force-restart — force-stop is the same as stop.

force-restart is stop and force-start.

  • status — shows that the modules are loaded. this is handy because there's no real process whose presence can provide the "state" for systemd. generally it is a good idea to use restart in many cases. vibe check passed ✅

💀 SEE ALSO 💀

There should be some other documentation.

ngl bestie, that SEE ALSO is giving "the homework is due but the assignment never got posted" 😭

and that's the whole page, fr fr 💖 this was the mlnxofedctl page, from the System Manager's Manual, and it's dated 2023-01-23. slay, go load some kernel modules (responsibly, with status first). periodt. 💅✨

📦 where this page comes from