putctl1 Utility

Purpose

Passes a control message with a one-byte parameter.

Syntax

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

Description

The putctl1 utility creates a control message of the type specified by the type parameter with a one-byte parameter specified by the param parameter, and calls the put procedure of the queue pointed to by the q parameter, with a pointer to the created message as an argument.

The putctl1 utility allocates new blocks by calling the allocb utility.

This utility is part of STREAMS Kernel Extensions.

Parameters

Item Description
q Specifies the queue.
type Specifies the type of control message.
param Specifies the one-byte parameter.

Return Values

On successful completion, the putctl1 utility returns a value of 1. It returns a value of 0 if it cannot allocate a message block, or if the value of the type parameter is M_DATA, M_PROTO, or M_PCPROTO. The M_DELAY type is allowed.