ipmicmd



ipmicmd(8)                 An IPMI Command Interface                ipmicmd(8)




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 sys-
              tem 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 anony-
              mous 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 con-
              nection.


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


       unregcmd netfn cmd
              Remove a command registration.



SEE ALSO

       ipmi_ui(1), ipmilan(8)



KNOWN PROBLEMS

       The asychronous nature of the program can be annoying.



AUTHOR

       Corey Minyard <cminyard@mvista.org>



OpenIPMI                           05/13/03                         ipmicmd(8)

Man(1) output converted with man2html