bcanput man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

bcanput(9F)		 Kernel Functions for Drivers		   bcanput(9F)

NAME
       bcanput - test for flow control in specified priority band

SYNOPSIS
       #include <sys/stream.h>

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

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       q	Pointer to the message queue.

       pri	Message priority.

DESCRIPTION
       The  bcanput()  function	 searches  through  the stream (starting at q)
       until it finds a queue containing a service routine where  the  message
       can be enqueued, or until it reaches the end of the stream.
	If found, the queue containing the service routine is tested to see if
       there is room for a message of priority pri in the queue.

       If pri is 0, bcanput() is equivalent to a call with  canput(9F).

       canputnext(q) and bcanputnext(q,pri) should always be used  in  prefer‐
       ence to canput(q→q_next) and bcanput(q→q_next,pri) respectively.

RETURN VALUES
       1	If a message of priority pri can be placed on the queue.

       0	If the priority band is full.

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

SEE ALSO
       bcanputnext(9F), canput(9F), canputnext(9F), putbq(9F), putnext(9F)

       Writing Device Drivers

       STREAMS Programming Guide

WARNINGS
       Drivers are responsible for both testing a  queue  with	bcanput()  and
       refraining from placing a message on the queue if bcanput() fails.

SunOS 5.10			  16 Jan 2006			   bcanput(9F)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net