DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

modify_callback(D2hpci)


modify_callback -- communicate user requested changes to the HPCD driver

Synopsis

   #include <sys/types.h>
   #include <sys/hpci.h>
   #include <sys/ddi.h>
   

int modify_callback(hpci_hpcd_t *hpcd_info, int cmd, hpci_socket_info_t *modified, hpci_socket_info_t *original)

Description

modify_callback( ) communicates user requested changes to the HPCD driver.

Arguments


hpcd_info
Pointer to an hpci_hpcd_t(D4hpci) structure that represents an HPCD instance.

cmd
Requested action. Currently, only HPCD_STATE_CHANGE_COMMAND is supported.

modified
Socket copy with the properties that the user wants to modify in the current_state member.

original
Pointer to the socket in the tree.

Return values

modify_callback( ) returns 0 if the request completes successfully, EINVAL if this is an invalid command argument or the read-only bits changed, or EIO if the error is embedded in socket state bits.

Usage

This entry point routine is required for all hot-plug controller drivers. It communicates to the HPCD user requested changes such as power up/down a socket or turn attention LED on/off. When powering up/down a socket, the information about the devices connected to the socket could change and the HPCD may have to call the hpci_confupdate(D3hpci) function.

Context and synchronization

Interrupt context

Hardware applicability

All

Version applicability

hpci: 1

References

lock_callback(D2hpci), unlock_callback(D2hpci), hpci_confupdate(D3hpci), hpci_hpcd_t(D4hpci)

``Hotplug devices'' in HDK Technical Reference


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005