strqget(D3DK) —

.IX \f4strqget\fP(D3DK)

NAME

strqget − get information about a queue or band of the queue

SYNOPSIS

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

ARGUMENTS

qPointer to the queue.

whatThe field of the queue about which to return information. Valid 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(D4DK)].

priPriority band of the queue about which to obtain information.

valpPointer 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 VALUE

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.

LEVEL

Base or Interrupt.

NOTES

Does not sleep.

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

Museum