DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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