sunos man page for strqget

strqget(9F)						   Kernel Functions for Drivers 					       strqget(9F)

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, void *valp);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       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.

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
       strqset(9F), queue(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    17 Oct 2000 						       strqget(9F)