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

Technical Reference: Communications, Volume 2


putctl Utility

Purpose

Passes a control message.

Syntax


int
putctl( q, type)
queue_t *q;

Description

The putctl utility creates a control message of the type specified by the type parameter, and calls the put procedure of the queue pointed to by the q parameter. The argument of the put procedure is a pointer to the created message. The putctl utility allocates new blocks by calling the allocb utility.

Parameters


q Specifies the queue that contains the desired put procedure.
type Specifies the type of control message to create.

Return Values

On successful completion, the putctl 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, M_PCPROTO, or M_DELAY.

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

The allocb utility, putctl1 utility.

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


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