openipmicmd(1)

💖 openipmicmd — An IPMI Command Interface 💖

okay bestie, come sit with me, we're gonna talk about openipmicmd, which lives in section 1 of the manual (iykyk — that's the "user commands" girlies). She's giving An IPMI Command Interface and honestly? she's iconic. 🎀

---

✨ SYNOPSIS ✨

openipmicmd [-k entry-to-execute] <connection parms>

---

🌸 DESCRIPTION 🌸

So the openipmicmd program lets you, a whole entire human, execute direct IPMI commands. That's the whole vibe. 💅

She can work with a direct interface to the OpenIPMI driver, or she can work with IPMI LAN interfaces. Two ways to be her bestie, pick your fighter. 🦋

---

🫶 OPTIONS 🫶

• -k entry-to-execute — Execute a single command and then exit. One and done, no hanging around, she's got places to be. 💅
• <connection parms> — The parameters for the connection depend on the connection type. Every single one of them is described over in openipmi_conparms(7) — go read her, she's got the details. 📖

---

👑 COMMANDS 👑

Once she's up, you can execute commands in the user interface. ✨

⚠️ Note that commands and responses are asynchronous — you issue a command and the interface returns immediately. When the response comes back, it will be dumped on your console. That's a little strange looking, but IPMI is asynchronous underneath, that's just how she is. 💀

💡 Note that the -k option is synchronous — it will wait for the response or a timeout before returning. So -k is the patient friend and the interactive UI is the chaotic one. Both valid. 🫶

---

🌈 the commands, one by one

• 0f lun netfn cmd [data1 [data2 ...]] — Send a command to the BMC you are connected to. Straight to the source, no middleman. 🔥
• channel [ipmb] IPMB-addr lun netfn [seq] cmd [data1 [data2 ...]] — Send a command to a device on the IPMB bus. The "ipmb" string is optional. The seq must be provided if the netfn is a response (an odd number). And it must be the same sequence number that came in on the command in the "Command Sequence = seq" part of the command. Like, matching numbers, no cap. 🔢
• channel 00 IPMB-addr lun netfn cmd [data1 [data2 ...]] — Send a broadcast command to a device on the IPMB bus. 📢 Everyone hears it, that's the point.
• channel lan handle remote-swid local-swid lun netfn cmd [data1 [data ...]] — Send a command to a device over a LAN channel. 👀 Note that this is not the same as a LAN connection. This sends a message through a local BMC to a remote system that is hooked up with a LAN connection. It's giving "message in a bottle, but the bottle is a BMC." 🍓
• test_lat count command — Executes the given commands (one of the previous commands, so pick your fave) count times and gives you the average time per command to execute. She's benchmarking, she's methodical, we love her. 📊

💡 Note that count is hexadecimal. Yes bestie, hex. Not decimal. Do not come for me, that's just what it says. 🙈

• help — Display some help. That's it. That's the whole thing. Sometimes you just need a lil help. 🫶
• regcmd netfn cmd — Register to receive the given command. If the driver receives an external command, it will print it out. ✨

⚠️ This only works with system interface connections — it will not work on LAN connections. Sorry LAN girlies, this one isn't for you. 😭

• unregcmd netfn cmd — Remove a command registration. Undo, unregister, unbothered. 💅

---

💜 SEE ALSO 💜

• ipmi_ui(1)
• ipmilan(8)
• openipmi_conparms(7)

go read your sisters, they're all serving. 👑

---

😭 KNOWN PROBLEMS 😭

The asynchronous nature of the program can be annoying.

That's it. That's the known problem. She said it herself, and honestly? relatable. The chaos is the charm until it isn't. 💀

---

🌸 AUTHOR 🌸

Corey Minyard <cminyard@mvista.com> — thank you for your service, king. 🫡✨

---

OpenIPMI · version/date situation: 05/13/03 🎀

and that's the whole page bestie, mwah, go forth and send some commands 💖✨🦋🌸💅