disablement_checking_suspend Kernel Service

Purpose

Indicates the start of a disabled code path that is exempt from detection of excessive interrupt disablement.

Syntax

#include <sys/intr.h>

long disablement_checking_suspend(void)

Description

A call to the disablement_checking_suspend service temporarily disables the detection of excessive disablement for the duration of a portion of a critical section. For base level code, insert this call at the beginning of the exempt critical section immediately after it disables, or as soon as possible within interrupt handling code.

This service must be used in conjunction with the disablement_checking_resume kernel service, which resumes the prior disablement checking state.

Note: Error checking, including that for excessive interrupt disablement, can be enabled or disabled by the errctrl command.

Execution Environment

The disablement_checking_suspend service can be called from either the process or the interrupt environments. Interrupts should be at least partially disabled at the time of the call.

Return Values

The disablement_checking_suspend service returns the previous suspension state to the caller. This value must be passed later to the resume function, which restores that state. This enables nesting of exempt critical sections.