Index for Section 9r

Alphabetical listing for G

Bottom of page

getq(9r)
NAME
  getq - STREAMS: Gets a message from the front of the queue

SYNOPSIS
  #include <sys/stream.h>

  MBLKP getq(
	  queue_t *message_queue );

ARGUMENTS
  message_queue
      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),
  qenable(9r)

  Programmer's Guide: STREAMS

Index for Section 9r

Alphabetical listing for G

Top of page