IPMI(7D)IPMI(7D)NAMEipmi - OpenIPMI compatible IPMI interface driver
SYNOPSIS
/dev/ipmi0
DESCRIPTION
The ipmi device is a character special file that provides access to the
Intelligent Platform Management Interface for the system. For more
information on IPMI and to obtain a copy of the IPMI specification and
implementation guidelines, refer to
http://www.intel.com/design/servers/ipmi/. The driver is adapted from
the FreeBSD driver which is in turn adapted from the Linux driver, how‐
ever, not all features described in the standard are supported. The
current implementation depends on the smbios(7d) to discover the exis‐
tence of an IPMI device.
IOCTLS
Sending and receiving messages through the IPMI drivers requires the
use of ioctl(2).
The ioctl command codes below are defined in sys/ipmi.h. The third
argument to ioctl should be a pointer to the type indicated. Currently
the following ioctls are supported:
o IPMICTL_RECEIVE_MSG "struct ipmi_recv"
Receive a message.
Possible error values:
EAGAIN No messages are in the process queue.
EFAULT An address supplied was invalid.
EMSGSIZE The address could not fit in the message buffer
and will remain in the buffer.
o IPMICTL_RECEIVE_MSG_TRUNC "struct ipmi_recv"
Like IPMICTL_RECEIVE_MSG but if the message cannot fit into
the buffer, it will truncate the contents instead of leaving
the data in the buffer.
o IPMICTL_SEND_COMMAND "struct ipmi_req"
Send a message to the interface.
Possible error values:
EFAULT An address supplied was invalid
ENOMEM Buffers could not be allowed for the command, out of
memory.
o IPMICTL_SET_MY_ADDRESS_CMD "unsigned int"
Set the slave address for source messages.
o IPMICTL_GET_MY_ADDRESS_CMD "unsigned int"
Get the slave address for source messages.
o IPMICTL_SET_MY_LUN_CMD "unsigned int"
Set the slave LUN for source messages.
o IPMICTL_GET_MY_LUN_CMD "unsigned int"
Get the slave LUN for source messages.
Stub Only Ioctl
o IPMICTL_SET_GETS_EVENTS_CMD int
Set whether this interface receives events.
Unimplemented Ioctls
o IPMICTL_REGISTER_FOR_CMD
Register to receive a specific command
o IPMICTL_UNREGISTER_FOR_CMD
Unregister to receive a specific command
SEE ALSOipmitool(1M), ioctl(2), smbios(7d)
Intelligent Platform Management Interface Specification Second Genera‐
tion, v2.0 — June 12, 2009 Markup
NOTES
Not all systems include an IPMI.
Oct 31, 2013 IPMI(7D)