Manual page for strqget(9F)
strqget - get information about a queue or band of the queue
SYNOPSIS
#include <sys/stream.h>
int strqget(queue_t *q, qfields_t what, unsigned char pri, long *valp);
ARGUMENTS
- q
-
Pointer to the queue.
- what
-
Field of the
queue
structure for (or the specified priority band) to return information about.
Valid values are one of:
-
- QHIWAT
-
High water mark.
- QLOWAT
-
Low water mark.
- QMAXPSZ
-
Largest packet accepted.
- QMINPSZ
-
Smallest packet accepted.
- QCOUNT
-
Approximate size (in bytes) of data.
- QFIRST
-
First message.
- QLAST
-
Last message.
- QFLAG
-
Status.
- pri
-
Priority band of interest.
- valp
-
The address of where to store the value of the requested field.
INTERFACE LEVEL
Architecture independent level 1 (DDI/DKI).
DESCRIPTION
strqget()
gives drivers and modules a way to get information
about a queue or a particular band of a queue without
directly accessing STREAMS data structures, thus insulating
them from changes in the implementation of these data structures
from release to release.
RETURN VALUES
On success,
0
is returned and the value of the requested field is stored in the
location pointed to by
valp.
An error number is returned on failure.
CONTEXT
strqget()
can be called from user or interrupt context.
SEE ALSO
freezestr.9f
queue.9s
strqset.9f
unfreezestr.9f
NOTES
The stream must be frozen using
freezestr.9f
before calling
strqget().
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97
