select_wakeup(9r) [osf1 man page]

select_wakeup(9r)														 select_wakeup(9r)

NAME

       select_wakeup - General: Wakes up a kernel thread

SYNOPSIS

       void select_wakeup(
	       sel_queue_t *selq );

ARGUMENTS

       Specifies a pointer to a sel_queue structure.

DESCRIPTION

       The  select_wakeup  routine  wakes  up  a  kernel thread that is suspended while waiting for an event on the specified device. A user-level
       process can use the select system call to cause the process to be suspended while waiting for an event to happen on a device. For  example,
       a  graphics  application  may issue a select call while waiting for mouse or keyboard input to arrive. In this case the process would issue
       the select system call, which would indirectly call the graphics driver's select routine (through the driver's select entry  point  in  the
       dsent  table)  to  determine if any input is available. If input is available, the select call may return immediately.  If no input is cur-
       rently available, the graphics driver would suspend the process until input arrived.

       For this example, when the graphics driver has received input (typically through its interrupt handler), it causes any processes  suspended
       from  calling  select  to continue by calling the select_wakeup routine.  This causes any process currently suspended on the select channel
       (as specified by the selq argument) to resume.

RETURN VALUES

       None

SEE ALSO

       Routines: select_dequeue(9r), select_dequeue_all(9r), select_enqueue(9r)

       System Calls: select(2)

																 select_wakeup(9r)

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)