i_clear Kernel Service

Purpose

Removes an interrupt handler.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/intr.h>

void i_clear (handler)
struct intr *handler;

Parameter

Description

The i_clear service removes the interrupt handler specified by the handler parameter from the set of interrupt handlers that the kernel knows about. "Coding an Interrupt Handler" in AIX Kernel Extensions and Device Support Programming Concepts contains a brief description of interrupt handlers.

The i_mask service is called by the i_clear service to disable the interrupt handler's bus interrupt level when this is the last interrupt handler for the bus interrupt level. The i_clear service removes the interrupt handler structure from the list of interrupt handlers. The kernel maintains this list for that bus interrupt level.

Execution Environment

The i_clear kernel service can be called from the process environment only.

Return Values

The i_clear service has no return values.

Implementation Specifics

The i_clear kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The i_init kernel service.

I/O Kernel Services, Understanding Interrupts in AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.