[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 2

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

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.

Related Information

The allocb utility, putctl utility.

List of Streams Programming References and Understanding STREAMS Messages in AIX 5L Version 5.2 Communications Programming Concepts.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]