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

Technical Reference: Communications, Volume 2


pullupmsg Utility

Purpose

Concatenates and aligns bytes in a message.

Syntax


int
pullupmsg(mp, len)
register struct msgb * mp;
register int len;

Description

The pullupmsg utility concatenates and aligns the number of data bytes specified by the len parameter of the passed message into a single, contiguous message block. Proper alignment is hardware-dependent. The pullupmsg utility only concatenates across message blocks of similar type. It fails if the mp parameter points to a message of less than len bytes of similar type. If the len parameter contains a value of -1, the pullupmsg utility concatenates all blocks of the same type at the beginning of the message pointed to by the mp parameter.

As a result of the concatenation, the contents of the message pointed to by the mp parameter may be altered.

Parameters


mp Specifies the message that is to be aligned.
len Specifies the number of bytes to align.

Return Values

On success, the pullupmsg utility returns a value of 1. On failure, it returns a value of 0.

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

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


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