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

e_assert_wait Kernel Service

Purpose

Asserts that the calling kernel thread is going to sleep.

Syntax

#include <sys/sleep.h>
void e_assert_wait (event_word, interruptible)
int *event_word;
boolean_t interruptible;

Parameters

event_word Specifies the shared event word. The kernel uses the event_word parameter as the anchor to the list of threads waiting on this shared event.
interruptible Specifies if the sleep is interruptible.

Description

The e_assert_wait kernel service asserts that the calling kernel thread is about to be placed on the event list anchored by the event_word parameter. The interruptible parameter indicates wether the sleep can be interrupted.

This kernel service gives the caller the opportunity to release multiple locks and sleep atomically without losing the event should it occur. This call is typically followed by a call to either the e_clear_wait or e_block_thread kernel service. If only a single lock needs to be released, then the e_sleep_thread kernel service should be used instead.

The e_assert_wait kernel service has no return values.

Execution Environment

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

Implementation Specifics

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

Related Information

The e_clear_wait kernel service, e_block_thread kernel service, e_sleep_thread kernel service

Process and Exception Management Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]