NAME    [Toc]    [Back]

       getq - STREAMS: Gets a message from the front of the queue

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP getq(
               queue_t *message_queue );

ARGUMENTS    [Toc]    [Back]

       Specifies a pointer to the message queue  from  which  the
       message  is  to  be  retrieved.  The typedef queue_t is an
       alternate name for struct queue_entry *.

DESCRIPTION    [Toc]    [Back]

       The getq interface is  used  by  a  service  interface  to
       retrieve its enqueued messages.

       A module or driver may include a service interface to process
 enqueued messages. Once the STREAMS  scheduler  calls
       this service it must process all enqueued messages, unless
       prevented by flow control. The  getq  interface  gets  the
       next  available  message from the top of the queue pointed
       to by the message_queue argument. You should call getq  in
       a  while loop that should be exited only when there are no
       more messages.

RETURN VALUES    [Toc]    [Back]

       If there is a message to retrieve, getq returns a  pointer
       to  it.  If  no  message  is  queued,  getq returns a NULL
       pointer.

SEE ALSO    [Toc]    [Back]

       Kernel  Interfaces:  bcanput(9r),  canput(9r),  putbq(9r),
       putq(9r), qenable(9r)

       Programmer's Guide: STREAMS



                                                         getq(9r)