SVR5 and SCO OpenServer 5

strqget(D3str)

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);

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.

Arguments

q

Pointer to the queue.

what

The field of the queue about which to return information. 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(D4str)).

pri

Priority band of the queue about which to obtain information.

valp

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

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

Context

Base or Interrupt.

Synchronization constraints

Does not block.

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

For DDI drivers, the caller must have the stream frozen (see freezestr(D3str)) when calling this function.

Hardware applicability

All

Version applicability

ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp
oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp

References

freezestr(D3str), queue(D4str) strqset(D3str), unfreezestr(D3str)