assert_wait_mesg(9r)													      assert_wait_mesg(9r)

NAME

       assert_wait_mesg - General: Asserts that the current kernel thread is about to block (sleep)

SYNOPSIS

       void assert_wait_mesg(
	       vm_offset_t event,
	       boolean_t interruptible,
	       char *message );

ARGUMENTS

       Specifies the event associated with the current kernel thread.  Specifies a Boolean value that indicates how the kernel thread is awakened.
       You can pass one of the following values: The current kernel thread is interruptible. This value means that a signal can awaken the current
       kernel  thread.	The current kernel thread is not interruptible. This value means that only the specified event can awaken the current ker-
       nel thread.  Specifies a mnemonic for the type of wait. The ps command uses this mnemonic to print out more  meaningful	messages  about  a
       process.

DESCRIPTION

       The assert_wait_mesgroutine asserts that the current kernel thread is about to block (sleep) until the specified event occurs. This routine
       sets a thread wait bit in the pointer to the thread structure associated with the current kernel thread.  This bit signifies that this ker-
       nel thread is on the appropriate wait hash queue, waiting for a wakeup call.

       To actually block (put to sleep) the current kernel thread, call thread_block.

       To issue a wakeup call on the specified event, call the thread_wakeup_prim or clear_wait routine.

CAUTIONS

       You  must  not call assert_wait_mesg from a device driver's interrupt handler. The reason for this is that at interrupt context there is no
       process to be put to sleep.

RETURN VALUES

       None

SEE ALSO

       Data Structures: thread(9s)

       Routines: clear_wait(9r), current_thread(9r), thread_block(9r)

       Reference Pages Section 1: ps

															      assert_wait_mesg(9r)