[ Bottom of Page | Previous Page | Next Page | 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.

This utility is part of STREAMS Kernel Extensions.

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.

Related Information

List of Streams Programming References, 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 ]