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

Item Description
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.