canput man page on DigitalUNIX

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

canput(9r)							    canput(9r)

       canput - STREAMS: Tests for room in a message queue

       #include <sys/stream.h>

       int canput(
	       queue_t *message_queue );

       Specifies  a  pointer  to  the message queue. The typedef queue_t is an
       alternate name for struct queue_entry *.

       The canput interface searches through the stream (starting at the  mes‐
       sage  queue  identified by the message_queue argument) until it finds a
       queue that contains a  service  interface  where	 the  message  can  be
       enqueued	 or until it reaches the end of the stream.  If canput finds a
       service interface in a queue, it tests the queue to determine if	 there
       is  space in the queue to accommodate a message.	 If the queue is full,
       canput sets the q_flag member of the queue_entry structure pointer (the
       message	queue) to the constant QWANTW to back-enable the caller's ser‐
       vice interface.

       You are responsible for both testing a queue with canput and not	 plac‐
       ing a message on the queue if canput fails.

       The  canput  interface returns a value of 1 if the message queue is not
       full. It returns the value zero (0) if the message queue is full.

       Kernel Interfaces: bcanput(9r), putbq(9r), putnext(9r)

       Programmer's Guide: STREAMS


List of man pages available for DigitalUNIX

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]
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