pm_create_components(9F)

NAME | SYNOPSIS | INTERFACE LEVEL | PARAMETERS | DESCRIPTION | RETURN VALUES | CONTEXT | ATTRIBUTES | SEE ALSO

NAME

pm_create_components, pm_destroy_components– Create or destroy power-manageable components

SYNOPSIS

#include <sys/ddi.h>
#include <sys/sunddi.h>

int pm_create_components(dev_info_t *dip, int components);
void pm_destroy_components(dev_info_t *dip);

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI).

PARAMETERS

dip

Pointer to the device's dev_info structure

components

Number of components to create

DESCRIPTION

The pm_create_components() and pm_destroy_components() functions are now obsolete and will be removed in a future release. It is recommended that the driver use pm-components(9) instead.

The pm_create_components() function creates power-manageable components for a device. It should be called from the driver's attach(9E) entry point if the device has power-manageable components.

The correspondence of components to parts of the physical device controlled by the driver are the responsibility of the driver.

The pm_destroy_components() function removes all components from the device. It should be called from the driver's detach(9E) entry point.

RETURN VALUES

The pm_create_components() function returns:

DDI_SUCCESS

Components are successfully created.

DDI_FAILURE

The device already has components.

CONTEXT

These functions may be called from user or kernel context.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface stability	Obsolete

SEE ALSO

power.conf(4), pm(7D), attach(9E), detach(9E), pm_busy_component(9F), pm_idle_component(9F), pm(9P), pm-components(9P)

Writing Device Drivers

SunOS 5.9  Last Revised 14 Oct 1999

NAME | SYNOPSIS | INTERFACE LEVEL | PARAMETERS | DESCRIPTION | RETURN VALUES | CONTEXT | ATTRIBUTES | SEE ALSO