NAME

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 to return information about.  Valid values are:

QHIWAT High water mark. 

QLOWAT Low water mark. 

QMAXPSZ Largest packet accepted by QUEUE. 

QMINPSZ Smallest packet accepted by QUEUE. 

QCOUNT Approximate size of message queue. 

QFIRST First message in the queue. 

QLAST Last message in the queue. 

QFLAG Status of the queue. 

QBAD Priority band. 

pri Priority of request. 

valp The value for 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.  The fields that can be returned are defined in the enumerated type qfields. 

RETURN VALUES

On success, 0 is returned.  An error number is returned on failure. 

CONTEXT

strqget() can be called from user or interrupt context. 

SEE ALSO

strqset(9F)

SunOS 5.1 Writing Device Drivers
SunOS 5.1 STREAMS Programmer’s Guide

SunOS 5.1/SPARC  —  Last change: 11 Apr 1991