getq(9r)getq(9r)NAMEgetq - STREAMS: Gets a message from the front of the queue
SYNOPSIS
#include <sys/stream.h>
MBLKP getq(
queue_t *message_queue );
ARGUMENTS
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
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
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
Kernel Interfaces: bcanput(9r), canput(9r), putbq(9r), putq(9r), qen‐
able(9r)
Programmer's Guide: STREAMS
getq(9r)