eeh_set_and_broadcast_user_state
Purpose
Sets a user-state and broadcasts a user message.
Parameter
| Item | Description |
|---|---|
| Handle | Extending Enhanced I/O Error Handling (EEH) handle acquired from the eeh_init_multifunc() service. |
| Flags | Additional flags. Currently, the value must be 0. |
| State | User-defined state value. |
| Message | User-defined message value. |
Description
This service allows a device driver to change a user-defined state and to send a message to all other device drivers in the same EEH-shared domain. The caller of this service is marked EEH_INITIATOR for the message and is called with the previous message. The messages are broadcast at an INTIODONE priority. The EEH callback handler that is registered during the registration of the eeh_init_multifunc() service time is used to callback each device driver with the message.
Execution Environment
The eeh_set_and_broadcast_user_state() service either process or interrupt. This function can be called from the live dump, the eeh callback, and other process level entry points. The eeh_set_and_broadcast_user_state() service will not work in the system dump context.
Return Values
| Item | Description |
|---|---|
| 0 | Success |
| Kerrno with EBUSY | Session is currently active with another initiator |
| Kerrno | Error |