sel_queue(9s) [osf1 man page]

sel_queue(9s)															     sel_queue(9s)

NAME

       sel_queue - General: Defines a queue of select events

SYNOPSIS

       ---------------------------------
       Member Name   Data Type
       ---------------------------------
       links	     struct queue_entry
       event	     struct event *
       ---------------------------------

MEMBERS

       Specifies  a  queue_entry structure.  This structure contains a generic doubly linked list (queue).  Specifies a pointer to an event struc-
       ture.  This structure is an opaque structure; that is, you do not reference it in your kernel module.

DESCRIPTION

       The sel_queue data structure provides kernel module writers with a generic queue of select events. You must initialize the links member	by
       calling the queue_init routine prior to using the select_enqueue and select_dequeue routines.

FILES

SEE ALSO

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

																     sel_queue(9s)

select_enqueue(9r)														select_enqueue(9r)

NAME

       select_enqueue - General: Adds the current kernel thread

SYNOPSIS

       void select_enqueue(
	       sel_queue_t *selq );

ARGUMENTS

       Specifies a pointer to a sel_queue structure.

DESCRIPTION

       The select_enqueue routine adds the current kernel thread to the list of kernel threads waiting for a select event on the specified device.
       This routine is called when a kernel module's select routine has been called and the requested event cannot be immediately satisfied.   For
       example,  the  requested  event	cannot	be immediately satisfied when xxselect is called for the following reasons: To select on input and
       there are no characters available When called for output and the kernel module's output buffers are currently full

       By calling select_enqueue, the kernel module's select routine ensures that the kernel thread issuing the select call will be blocked  until
       the requested event can be satisfied or until the select call terminates.

CAUTIONS

       You must call the queue_init routine to initialize the sel_queue structure pointer prior to calling select_enqueue. Failure to do so causes
       the kernel to panic.

RETURN VALUES

       None

FILES

SEE ALSO

       Routines: queue_init(9r), select_dequeue(9r), select_dequeue_all(9r), select_wakeup(9r)

       Data Structures: sel_queue(9s)

       System Calls: select(2)

																select_enqueue(9r)