Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
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

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.