putctl1(9r) [osf1 man page]

putctl1(9r)															       putctl1(9r)

NAME

       putctl1 - Puts a control message with a 1-byte parameter on a queue

SYNOPSIS

       #include <sys/stream.h>

       int putctl1(
	       queue_t *queue_pointer,
	       int type,
	       int parameter );

ARGUMENTS

       Specifies  a  pointer  to  the queue to which the message is to be sent. The typedef queue_t is an alternate name for struct queue_entry *.
       Specifies a message type (must be control and not a data type).	Specifies a 1-byte parameter.

DESCRIPTION

       Like the putctl interface, the putctl1 interface tests the type argument to make sure a data type was not specified. It	then  attempts	to
       allocate a message block. In addition, the putctl1 interface can send a 1-byte parameter in the parameter argument. You can use the parame-
       ter for any purpose. For example, you can use this argument to specify how long the delay will be when  sending	an  M_DELAY  message.  The
       putctl1 interface fails if a message block cannot be allocated or if the type argument is M_DELAY, M_PROTO, or M_PCPROTO.

NOTES

       The putctl1 interface calls the putctl_comm interface, which actually performs the work of sending the control message.

RETURN VALUES

       Upon  successful completion, putctl1 returns the value 1. The putctl1 interface fails if a message block cannot be allocated or if the type
       argument is M_DELAY, M_PROTO, or M_PCPROTO.

SEE ALSO

       Kernel Interfaces: allocb(9r), datamsg(9r), putctl(9r)

       Programmer's Guide: STREAMS

																       putctl1(9r)