[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Kernel and Subsystems, Volume 1

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

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

0 Indicates a successful operation.

A non-zero value indicates an error.

Related Information

The register_HA_handler kernel service.

The RAS Kernel Services in the AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]