NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

ARGUMENTS    [Toc]    [Back]

       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  kernel 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    [Toc]    [Back]

       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 kernel
       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    [Toc]    [Back]

       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    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Data Structures: thread(9s)

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

       Reference Pages Section 1: ps



                                             assert_wait_mesg(9r)