HP-UX Reference (11i v2 04/09) - 7 Device (Special) Files, 9 General Information, Index (vol 10)

i
ipmi(7) ipmi(7)
NAME
ipmi - intelligent platform management interface (IPMI) driver
SYNOPSIS
#include <sys/ipmi.h>
DESCRIPTION
The /dev/ipmi driver allows user processes to send IPMI messages to the BMC (Baseboard Manage-
ment Controller) System Message Interface.
The following data structures are provided in the
<sys/ipmi.h> header file for sending IPMI requests
to the BMC.
ImbRequest
The ImbRequest structure is used to specify the fields in the IPMI request.
typedef struct {
BYTE rsSa;
BYTE cmd;
BYTE netFn;
BYTE rsLun;
BYTE dataLength;
BYTE data[1];
} ImbRequest;
rsSa Responding device Slave Address (BMC_SA).
cmd IPMI Command specified in hexadecimal.
netFn IPMI Network Function in hexadecimal.
rsLun Hexadecimal value dependent on cmd.
dataLength Length of following data field.
data Request data if any.
ImbRequestBuffer
The ImbRequestBuffer
structure is used to specify a timeout value for the request. It also
contains the IPMI request itself.
typedef struct {
DWORD flags;
DWORD timeOut;
ImbRequest req;
} ImbRequestBuffer;
flags Currently unused. May be removed in the future.
timeOut Timeout in micro seconds.
req Variable sized
ImbRequest buffer.
ImbResponseBuffer
The ImbResponseBuffer structure contains the response from the BMC.
typedef struct {
BYTE cCode;
BYTE data[1];
} ImbResponseBuffer;
cCode Completion code from BMC in hexadecimal.
data Response data from BMC excluding Completion Code.
ioctl Commands
The commands used to send IPMI messages to the BMC are:
IOCTL_IMB_SEND_MESSAGE Allows a 64-bit user process to send a message to the BMC. The
arg parameter points to an ipmi_data_t structure (defined in
the <sys/ipmi.h> header file) whose members are as follows:
Section 7−−56 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004