ipmicmd - An IPMI Command Interface

ipmicmd [-k entry-to-execute] smi smi-num

ipmicmd [-k entry-to-execute] lan IP-addr port [IP-addr-2 port-2] auth privilege username password

The ipmicmd program allows a user to execute direct IPMI commands. It can work with direct interface with the OpenIPMI driver or with IPMI LAN interfaces.

-k entry-to-execute

Execute a single command an exit.

smi-num

The SMI number to connect to, for systems with more than on system interface. Generally, this is '0'.

IP-addr

The IP address of the LAN interface.

port

The UDP port of the LAN interface, general 623.

IP-addr-2

Some systems support multiple IP connections, this specified the second address and is optional. If specified, OpenIPMI will use both IP addresses and fail over to the working one if one of them fails.

port-2

The port for the second IP connection, generally 623.

auth

The authorization to use for the connection, either "none", "straight", "md5", or "md2".

privilege

The privilege to use for the connection, either "callback", "user", "operator", or "admin". Note that some IPMI operations will fail without the correct privilege.

username

The user name to use for the connection. If using this anonymous user, this should be the empty string "".

password

The password to use for the connection.

Once 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 ansychronous underneath. Note that the -k option is synchronous, it will wait for the response or a timeout before returning.

0f lun netfn cmd [data1 [data2 ...]]

Send a command to the BMC you are connected to.

channel [ipmb] IPMB-addr lun netfn cmd [data1 [data2 ...]]

Send a command to a device on the IPMB bus. The "ipmb" string is optional.

channel 00 IPMB-addr lun netfn cmd [data1 [data2 ...]]

Send a broadcast command to a device on the IPMB bus.

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 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.

test_lat count command

Executes the given commands (one of the previous commands) count times and gives the average time per command to execute. Note that "count" is hexadecimal.

help

Display some 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.

unregcmd netfn cmd

Remove a command registration.

ipmi_ui(1), ipmilan(8)

The asychronous nature of the program can be annoying.

Corey Minyard <cminyard@mvista.org>