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

Technical Reference: Communications, Volume 2


rmvb Utility

Purpose

Removes a message block from a message.

Syntax


mblk_t *
rmvb(mp, bp)
register mblk_t * mp;
register mblk_t * bp;

Description

The rmvb utility removes the message block pointed to by the bp parameter from the message pointed to by the mp parameter, and then restores the linkage of the message blocks remaining in the message. The rmvb utility does not free the removed message block, but returns a pointer to the head of the resulting message. If the message block specified by the bp parameter is not contained in the message specified by the mp parameter, the rmvb utility returns a -1. If there are no message blocks in the resulting message, the rmvb utility returns a null pointer.

Parameters


bp Specifies the message block to be removed.
mp Specifies the message from which to remove the message block.

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 ]