[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

i_mask Kernel Service

Purpose

Disables a bus interrupt level.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/intr.h>
void i_mask (handler)
struct intr *handler;

Parameter

handler Specifies the address of the interrupt handler structure that was passed to the i_init service.

Description

The i_mask service disables the bus interrupt level specified by the handler parameter.

The i_disable and i_enable services are used to serialize the execution of various device driver routines with their device interrupts.

The i_init and i_clear services use the i_mask and i_unmask services internally to configure bus interrupt levels.

Device drivers can use the i_disable, i_enable, i_mask, and i_unmask services when they must perform off-level processing with their device interrupts disabled. Device drivers also use these services to allow process execution when their device interrupts are disabled.

Execution Environment

The i_mask kernel service can be called from either the process or interrupt environment.

Return Values

The i_mask service has no return values.

Implementation Specifics

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

Related Information

The i_unmask kernel service.

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


[ Previous | Next | Contents | Home | Search ]