[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Kernel and Subsystems, 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)
tid_t *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.

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 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]