Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

freezestr(9F)

queue(9S)

strqget(9F)

unfreezestr(9F)

strqset(9F)

NAME

strqset − change information about a queue or band of the queue

SYNOPSIS

#include <sys/stream.h>
int strqset(queue_t ∗q, qfields_t what, unsigned char pri
, long val);

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI). 

ARGUMENTS

q Pointer to the queue. 

what Field of the queue structure (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. 

pri Priority band of interest. 

val The value for the field to be changed. 

DESCRIPTION

strqset() 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. 

RETURN VALUES

On success, 0 is returned.  EINVAL is returned if an undefined attribute is specified. 

CONTEXT

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

SEE ALSO

freezestr(9F), queue(9S), strqget(9F), unfreezestr(9F)

Writing Device Drivers
STREAMS Programming Guide

NOTES

The stream must be frozen using freezestr(9F) before calling strqset().

To set the values of QMINPSZ and QMAXPSZ from within a single call to freezestr(9F) and unfreezestr(9F): when lowering the existing values, set QMINPSZ before setting QMAXPSZ; when raising the existing values, set QMAXPSZ before setting QMINPSZ. 

SunOS 5.5/SPARC  —  Last change: 28 Jan 1993

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026