putctl1(9r)putctl1(9r)NAMEputctl1 - 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). Speci‐
fies a 1-byte parameter.
DESCRIPTION
Like the putctl interface, the putctl1 interface tests the type argu‐
ment 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 parameter
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)