SCO OpenServer

remove_intr_handler(D3oddi)

remove_intr_handler -- dynamically remove interrupt routine handler

Synopsis

#include <sys/devreg.h>

int remove_intr_handler(int vector, void (handler)());

Description

The remove_intr_handler( ) function dynamically removes the interrupt routine handler, thereby preventing it from processing interrupts occurring on vector.

Arguments

vector: Vector being used for this interrupt handler; must match that used for the call to add_intr_handler(D3oddi) function.
handler: Handler to be removed; must match that used for the call to add_intr_handler(D3oddi) function.

Return values

If handler is successfully removed, 0 is returned. Otherwise, handler is not installed and an error code is returned, as follows:

INTR_BADVECTOR: The vector was not in the range 1 to {MAXIVECT}, inclusive. {MAXIVECT} is the maximum usable vector for this architecture.
INTR_PRIVATE: handler does not process interrupts on vector.
INTR_ENABLED: Interrupts have been enabled. It is no longer possible to remove interrupt handlers.

Usage

Context and synchronization

Initialization context

This function must be called before interrupts are enabled.

Hardware applicability

All

Version applicability

oddi: 2

Differences between versions

ODDI version 3 and later use the idistributed(D3oddi) function to register interrupt handlers. No kernel function is provided to remove interrupts that are registered with idistributed( ).

SVR5 DDI compatibility

DDI does not support this function. See ``Interrupt handlers, attaching and registering'' in HDK Technical Reference for information about how DDI interrupts are attached.

References

add_intr_handler(D3oddi), pr_intr_rmerr(D3oddi)

``Interrupt handlers, attaching and registering'' in HDK Technical Reference