canput man page on SunOS

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

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

NAME
       canput - test for room in a message queue

SYNOPSIS
       #include <sys/stream.h>

       int canput(queue_t *q);

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

PARAMETERS
       q	Pointer to the message queue.

DESCRIPTION
       canput()	 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 con‐
       taining the service routine is tested to see if there  is  room	for  a
       message in the queue.

       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 the message queue is not full.

       0	If the queue is full.

CONTEXT
       canput() can be called from user or interrupt context.

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

       Writing Device Drivers

	STREAMS Programming Guide

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

SunOS 5.10			  11 Apr 1991			    canput(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