*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> getq (9r)              



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

SEE ALSO    [Toc]    [Back]

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

       Programmer's Guide: STREAMS

[ Back ]
 Similar pages
Name OS Title
insq Tru64 STREAMS: Inserts a STREAMS message into a queue
putq Tru64 STREAMS: Puts a message on a queue
flushq Tru64 STREAMS: Removes a message from a queue
canput Tru64 STREAMS: Tests for room in a message queue
putbq Tru64 STREAMS: Places a message at the head of a queue
putctl Tru64 STREAMS: Puts a control message on a queue
rmvq Tru64 STREAMS: Removes a message block from a queue
mq_open Tru64 Establishes the connection between a message queue and a message queue descriptor (P1003.1b)
alNextEvent IRIX Retrieves front most event from queue
qenable Tru64 STREAMS: Enables a queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service