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

Item Description
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.