Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Kernel Functions for Driverspm_create_components(9F)


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 TYPEATTRIBUTE VALUE
Interface stabilityObsolete

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.9Go To TopLast Changed 14 Oct 1999


Updated: 2004-01-16, 19:58