strqget(D3) 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.
Copyright 1994 Novell, Inc. Page 1
strqget(D3) strqget(D3)
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.
The caller must have the stream frozen [see freezestr(D3)]
when calling this function.
REFERENCES
freezestr(D3), queue(D4), strqset(D3), unfreezestr(D3)
NOTICES
Portability
All processors
Applicability
ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2