[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 2


bcanput Utility

Purpose

Tests for flow control in the given priority band.

Syntax


int
bcanput(q, pri)
register queue_t * q;
unsigned char pri;

Description

The bcanput utility provides modules and drivers with a way to test flow control in the given priority band.

The bcanput (q, 0) call is equivalent to the canput (q) call.

Parameters


q Specifies the queue from which to begin to test.
pri Specifies the priority band to test.

Return Values

The bcanput utility returns a value of 1 if a message of the specified priority can be placed on the queue. It returns a value of 0 if the priority band is flow-controlled and sets the QWANTW flag to 0 band (the QB_WANTW flag is set to nonzero band). If the band does not yet exist on the queue in question, it returns a value of 1.

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

List of Streams Programming References, Understanding STREAMS Flow Control in AIX 5L Version 5.1 Communications Programming Concepts.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]