unregister_HA_handler Kernel Service
Purpose
Removes from the kernel the registration of a High Availability Event Handler.
Syntax
Parameter
| Item | Description |
|---|---|
| ha_handler | Specifies a pointer to a structure of the type ha_handler_ext_t defined in /usr/include/sys/high_avail.h. This structure must be identical to the one passed to register_HA_handler at the time of registration. |
Description
The unregister_HA_handler kernel service cancels an unconfigured kernel extensions that have registered a high availability event handler, done by the register_HA_handler kernel service, so that the kernel extension can be unloaded.
Failure to do so may cause a system crash when a high availability event such as a processor deallocation is initiated due to some hardware fault.
Execution Environment
The unregister_HA_handler kernel service can be called from the process environment only.
An extension may register the same HAEH N times (N > 1). Although this is considered an incorrect behaviour, no error is reported. The given HAEH will be invoked N times for each HA event. This handler has to be unregistered as many times as it was registered.
Return Values
| Item | Description |
|---|---|
| 0 | Indicates a successful operation. |