strqget(9r) [osf1 man page]

strqget(9r)															       strqget(9r)

NAME

       strqget - General: Obtains information about a queue

SYNOPSIS

       #include <sys/stream.h>

       int strqget(
	       queue_t *queue_pointer,
	       qfields_t what,
	       unsigned char pri,
	       long *val );

ARGUMENTS

       Specifies  a pointer to the queue for which you want to obtain information. The typedef queue_t is an alternate name for struct queue_entry
       *.  Specifies which member of the queue structure to return information about. The valid values are specified  in  the  qfields	enumerated
       data  type. See the DESCRIPTION section for the definition of this enumerated data type.  Specifies the priority of the request.  Specifies
       the value for the requested member.

DESCRIPTION

       The strqget routine gives modules and drivers a way to obtain information about a queue or a particular band of a  queue  without  directly
       accessing STREAMS data structures. The values that can be returned are defined in the following enumerated data type:

       typedef enum qfields {
	       QHIWAT  = 0,
	       QLOWAT  = 1,
	       QMAXPSZ = 2,
	       QMINPSZ = 3,
	       QCOUNT  = 4,
	       QFIRST  = 5,
	       QLAST   = 6,
	       QFLAG   = 7,
	       QBAD    = 8 } qfields_t;

RETURN VALUES

       Upon successful completion, strqget returns the value 0 (zero). On failure, strqget returns an error number.

SEE ALSO

       Routines: strqset(9r)

																       strqget(9r)

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

       The  strqget()  function  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

       The strqget() function can be called from user, interrupt, or kernel context.

SEE ALSO

       strqset(9F), queue(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.11							    16 Jan 2006 						       strqget(9F)