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