canput man page on IRIX

canput man page on IRIX

Man page or keyword search:
man Server 31559 pages
apropos Keyword Search (all sections)
Output format



canput(D3)							    canput(D3)

NAME
     canput - test for room in a message queue

SYNOPSIS
     #include <sys/stream.h>
     #include <sys/ddi.h>
     int canput(queue_t *q);

   Arguments
     q	       Pointer to the message queue.

DESCRIPTION
     canput tests if there is room for a message in the queue pointed to by q.
     The queue must have a service procedure.

   Return Values
     canput returns 1 if a message can be placed on the queue.	0 is returned
     if a message cannot be enqueued because of flow control.

USAGE
     The driver is responsible for both testing a queue with canput and
     refraining from placing a message on the queue if canput fails.

     It is possible because of race conditions to test for room using canput
     and get an indication that there is room for a message, and then have the
     queue fill up before subsequently enqueuing the message, causing a
     violation of flow control.	 This is not a problem, since the violation of
     flow control in this case is bounded.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks may be held
     across calls to this function.

   Examples
     See bufcall(D3) for an example of canput.

REFERENCES
     bcanput(D3), putbq(D3), putnext(D3)

									Page 1

[top]

List of man pages available for IRIX

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