osf1 man page for putctl1

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)