Solaris DDI specific (Solaris DDI)

pm_get_normal_power() parameters:

dip

Pointer to the device's dev_info structure

component

Number of component from which to get normal power level

pm_set_normal_power() parameters:

dip

Pointer to the device's dev_info structure

component

Number of component for which to set normal power level

level

Component's new normal power level

The pm_get_normal_power() and pm_set_normal_power() functions are now obsolete and will be removed in a future release. It is recommended that device drivers use new automatic device Power Management interfaces.

The pm_get_normal_power() function returns the normal power level of component of the device dip.

The pm_set_normal_power() function sets the normal power level of component of the device dip to level.

When a device has been power managed and is being returned to a state to be used by the system, it will be brought to its normal power level. Except for a power level of 0, which is defined by the system to mean "powered off," the interpretation of the meaning of the power level is entirely up to the driver.

The pm_get_normal_power() function returns:

level

The normal power level of the specified component (a positive integer).

DDI_FAILURE

Invalid component number component or the device has no components.

These functions can be called from user or kernel context.

See attributes(5) for descriptions of the following attributes:

power.conf(4), pm(7D), pm(9P), power(9E), pm_busy_component(9F), pm_create_components(9F), pm_destroy_components(9F), pm_idle_component(9F)

Writing Device Drivers