[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, 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.

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.

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

The allocb utility, putctl utility.

List of Streams Programming References and Understanding STREAMS Messages in AIX Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]