ipmi

- service processor driver interface using IPMI

Synopsis

#include <sys/ipmi.h>

open("/dev/ipmi0", mode);

Description

The ipmi driver provides access to a system's service processor using an
IPMI (Intelligent Platform Management Interface) standard interface. This driver is OpenIPMI compliant
and supports the service processor's watchdog timer.

ipmi supplies a standard way to access and monitor system sensors, the
FRU database, and the overall environmental state and health of the system.

The primary method for communication between user land and the driver is
through the use of ioctl(2).

ipmi supplies the new functionality of the OpenIPMI compatible driver module. If
you only need the functionality of the legacy bmc driver, use the
bmc module.

Properties

The impi module supplies an OpenIPMI compatible
driver module. If you need this new
functionality then this is the driver module that you should use.

If you only need the functionality of the legacy bmc driver, use
the bmc module.

If you want the extended features of the new OpenIPMI driver, but
still require legacy bmc driver functionality you have the choice of using
the new sbmc/ipmi driver module pair. This new pair offers an OpenIPMI
compatible driver (ipmi) and a legacy bmc compatible driver, sbmc, both of which
can be used at the same time.

The above properties can be set to either 1 (enable) or 0
(disable). If you need OpenIPMI with legacy support then ipmi-anable=1 should be
in the file ipmi.conf. Also sbmc-enable=1 should be in the file sbmc.conf. and
bmc-enable=0 must be in the file bmc.conf.

The driver properties are set by editing the related configuration file. For
the ipmi driver the file is ipmi.conf.

The following properties are supported:

ipmi-enable

Enables or disables the ipmi driver. When the driver is disabled it does not attach and is not active.

When set to 1 the ipmi driver is enabled. The default is disabled.

ipmi-polltime

The time in milliseconds between polls to check for asynchronous events.

If this value is set to 0 then asynchronous event notification is disabled. The default value is 1 second.

ipmi-wdtime

The initial value for the watch-dog time out period in seconds. The watch-dog counts down from this value until it reaches 0, at which time the system resets.

The default for is 90 seconds. If this value is set to 0 the watch-dog feature is disabled.

ipmi-wdupdate

The driver watch-dog update period in seconds. The driver watch-dog update period is the number of seconds between the time that the driver resets the watch-dog timer back to its initial value.

If this value is set to 0 the watch-dog feature is disabled. The default for this value is 30 seconds.