bmc

- legacy service processor driver interfaces

Synopsis

#include <sys/mbc_intf.h>

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

Description

The bmc streams driver provides access to a system's service processor using the legacy Sun BMC driver interface.

bmc uses putmsg() and getmsg() as the primary method to communicate with a system service processor. A streams message which contains a bmc_req_tstructure and response buffer is sent to the driver with putmsg(). The driver issues the request to the system service processor. The driver retrieves the response from the system BMC and puts the response in the buffer. When the user-land application issues a streams getmsg() the original request and the response from the BMC are returned.

Properties

This is the original bmc driver module. If you only need the Sun legacy bmc driver then this is the driver module that you should use.

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.

You can only have the original bmc or the new pair sbmc/ipmi enabled. You can not have both enabled.

This choice is made though driver properties as follows:

Driver Module  Functionality         Enable Property

bmc            Legacy bmc driver     bmc.conf/bmc-enable
ipmi           OpenIPMI driver       ipmi.conf/ipmi-enable
sbmc           bmc compatibility     sbmc.conf/sbmc-enable
                for OpenIPMI

The driver properties are set by editing the related configuration files. The configuration file for the bmc driver is bmc.conf. The configuration file for the bmc compatibility module for OpenIPMI is sbmc.conf. When the ipmi module is enabled there is a bmc compatibility mode module called sbmc and its related configuration file, sbmc.conf.

The following properties are supported:

bmc-enable

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

When set to 1 the bmc driver is enabled.

sbmc-enable

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

When this is set to 1 the sbmc compatible driver is enabled. The default is disabled (0).

If this property is enabled then ipmi must be enabled and bmc must not be enabled.

Files

/dev/bmc

Legacy bmc driver file node

/dev/ipmi0

OpenIPMI compatible driver file node

/kernel/drv/amd64/bmc

64-bit x86 kernel bmc driver module

/kernel/drv/amd64/sbmc

64-bit x86 kernel bmc compatible driver module

/kernel/drv/bmc.conf

bmc configuration file

/kernel/drv/ipmi.conf

OpenIPMI driver property configuration file

/kernel/drv/sbmc.conf

bmc compatibility module for OpenIPMI configuration file

/kernel/drv/sparcv9/bmc

64-bit SPARC kernel bmc driver module

/kernel/drv/sparcv9/sbmc

64-bit SPARC kernel bmc compatible driver module

Attributes

See attributes(5) for a description of the following attributes:

See Also

getmsg(2), putmsg(2), attributes(5), ipmi(7D)