putctl1 man page on SmartOS

putctl1 man page on SmartOS

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

PUTCTL1(9F)							   PUTCTL1(9F)

NAME
       putctl1 - send a control message with a one-byte parameter to a queue

SYNOPSIS
       #include <sys/stream.h>

       int putctl1(queue_t *q, int type, int p);

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

PARAMETERS
       q
	       Queue to which the message is to be sent.

       type
	       Type of message.

       p
	       One-byte parameter.

DESCRIPTION
       The  putctl1()  function,  like	putctl(9F), tests the type argument to
       make sure a data type has not been specified, and attempts to  allocate
       a  message  block. The p parameter can be used, for example, to specify
       how long the delay will be when	an  M_DELAY  message  is  being	 sent.
       putctl1()  fails if type is M_DATA, M_PROTO, or M_PCPROTO, or if a mes‐
       sage block cannot be allocated.	If  successful,	 putctl1()  calls  the
       put(9E)	routine	 of the queue pointed to by q with the newly allocated
       and initialized message.

RETURN VALUES
       On success, 1 is returned. 0 is returned if type is a data type, or  if
       a message block cannot be allocated.

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

EXAMPLES
       See the putctl(9F) function page for an example of putctl1().

SEE ALSO
       put(9E), allocb(9F), datamsg(9F), putctl(9F), putnextctl1(9F)

       Writing Device Drivers

       STREAMS Programming Guide

				 Jan 16, 2006			   PUTCTL1(9F)

[top]

List of man pages available for SmartOS

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