unregister_HA_handler Kernel Service

Purpose

Removes from the kernel the registration of a High Availability Event Handler.

Syntax

#include <sys/high_avail.h>

int register_HA_handler (ha_handler)
ha_handler_ext_t  *
ha_handler;

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.
A non-zero value indicates an error.