strqget(D3)

NAME
     strqget - get information about a queue or band of the queue

SYNOPSIS
     #include <sys/types.h>
     #include <sys/stream.h>
     #include <sys/ddi.h>
     int strqget(queue_t *q, qfields_t what, uchar_t pri, long *valp);

   Arguments
     q         Pointer to the queue.

     what      The field of the queue about which to return information.

     pri       Priority band of the queue about which to obtain information.

     valp      Pointer to the memory location where the value is to be stored.

DESCRIPTION
     strqget gives drivers and modules a way to get information about a queue
     or a particular priority band of a queue without directly accessing
     STREAMS data structures.

   Return Values
     On success, 0 is returned.  An error number is returned on failure.  The
     actual value of the requested field is returned through the reference
     parameter, valp.

USAGE
     Valid what values are:

          QHIWAT    High water mark of the specified priority band.

          QLOWAT    Low water mark of the specified priority band.

          QMAXPSZ   Maximum packet size of the specified priority band.

          QMINPSZ   Minimum packet size of the specified priority band.

          QCOUNT    Number of bytes of data in messages in the specified
                    priority band.

          QFIRST    Pointer to the first message in the specified priority
                    band.

          QLAST     Pointer to the last message in the specified priority
                    band.

          QFLAG     Flags for the specified priority band [see queue(D4)].
   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks may be held
     across calls to this function.

REFERENCES
     queue(D4), strqset(D3),