putctl1(9f) [xfree86 man page]

putctl1(9F)						   Kernel Functions for Drivers 					       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

       putctl1(),  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 message block cannot be allocated. If successful, putctl1() calls the put(9E) rou-
       tine 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

       putctl1() can be called from user or interrupt 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

SunOS 5.10							    11 Apr 1991 						       putctl1(9F)

putctl1(9F)						   Kernel Functions for Drivers 					       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

       putctl1(),  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 message block cannot be allocated. If successful, putctl1() calls the put(9E) rou-
       tine 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

       putctl1() can be called from user or interrupt 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

SunOS 5.10							    11 Apr 1991 						       putctl1(9F)