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