'\"macro stdmacro
.if n .pH ddi_dki.strqset @(#)strqset	40.6 of 10/10/89
.\" Copyright 1989 AT&T
.de IX
.ie '\\n(.z'' .tm .Index: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9	\\n%
.el \\!.IX \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
..
.nr X
.if \nX=0 .ds x} strqset D3DK "STREAMS" "DDI/DKI" "\&"
.if \nX=1 .ds x} strqset D3DK "STREAMS" "DDI/DKI"
.if \nX=2 .ds x} strqset D3DK "" "\&"
.if \nX=3 .ds x} strqset "" "" "\&"
.TH \*(x}
.IX "\f4strqset\fP(D3DK)"
.SH NAME
\f4strqset\f1 \- change information about a queue or band of the queue
.SH SYNOPSIS
.nf
.na
\f4#include <sys/stream.h>
.sp 0.5
int strqset(queue_t *\f2q, \f4qfields_t \f2what, \f4unsigned char \f2pri,
	\f4long *\f2val\f4);\f1
.ad
.fi
.SH ARGUMENTS
.RS 0n 10
.IP "\f2q\f1" 10n
Pointer to the queue.
.IP "\f2what\f1" 10n
Which field of the \f4queue\fP
structure to return information about.
Valid values are specified in \f4stream.h\fP:
.P
.RS 14
.ft 4
.nf
typedef enum qfields {
        QHIWAT   = 0,   /* q_hiwat or qb_hiwat */
        QLOWAT   = 1,   /* q_lowat or qb_lowat */
        QMAXPSZ  = 2,   /* q_maxpsz */
        QMINPSZ  = 3,   /* q_minpsz */
        QCOUNT   = 4,   /* q_count or qb_count */
        QFIRST   = 5,   /* q_first or qb_first */
        QLAST    = 6,   /* q_last or qb_last */
        QFLAG    = 7,   /* q_flag or qb_flag */
        QBAD     = 8
} qfields_t;
.ft
.fi
.RE
.IP "\f2pri\f1" 10n
Priority of request.
.IP "\f2val\f1" 10n
The value for the field to be changed.
.RE
.SH DESCRIPTION
\f4strqset\f1 gives drivers and modules a way to change information
about a queue or a particular band of a queue without
directly accessing STREAMS data structures.
The fields that can be returned are defined in the enumerated type
\f4qfields\f1.  \f4qfields\f1 defines the following fields:

.SH RETURN VALUE
On success, \f40\f1 is returned.
An error number is returned on failure.
If the \f2what\f1 field is read-only, \f4EPERM\f1 is returned
and the field is left unchanged.
.SH LEVEL
Base or Interrupt
.SH SEE ALSO
\f2BCI Driver Development Guide\f1, Chapter 7, ``STREAMS''
.P
.na
\f4strqget\f1(D3DK)
.ad
