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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005