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.

This utility is part of STREAMS Kernel Extensions.

Parameters

Item Description
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.