NAME
ipmicmd - An IPMI Command Interface
SYNOPSIS
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
DESCRIPTION
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.
OPTIONS
- -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.
COMMANDS
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.
SEE ALSO
ipmi_ui(1),
(8)
KNOWN PROBLEMS
The asychronous nature of the program can be
annoying.
AUTHOR
Corey Minyard <cminyard@mvista.org>