RMVB

Section: Linux Fast-STREAMS DDI/DKI (9)
Updated: 2008-10-31
Index Return to Main Contents

NAME

rmvb - remove a message block from a STREAMS message

SYNOPSIS

#include <sys/stream.h>

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

ARGUMENTS

mp: the message from which to remove the message block.
bp: the message block to remove from the message.

INTERFACE

STREAMS.

DESCRIPTION

Removes the message block pointed to by bp from the message pointed to by mp and returns the pointer to the (new) first message block in the message. If the block pointer, bp, points to the only message block that existed in the message, mp, when rmvb() was called, then rmvb() returns NULL.

rmvb() removes the message block bp from the message mp, but does not free the message block bp. bp's b_cont pointer is set to NULL.

RETURN

Upon success, rmvb() returns a pointer to the modified message. The modified message may be NULL (if the removed block was the only block in the message). Upon failure, rmvb() returns (mblk_t *)(-1).

ERRORS

When rmvb() fails it returns (mblk_t *)(-1). rmvb() only fails if bp was not in the message.

CONTEXT

rmvb() can be called from any context, including user context, module procedures, callouts, callbacks, soft interrupts (tasklets and bottom halves), and interrupt service routines.

MP-STREAMS

rmvb() is MP-safe; however, it is the responsibility of the caller to ensure exclusive access to the passed in message mp and message block dp.

BUGS

rmvb() has no known bugs.

COMPATIBILITY

rmvb() is source-level compatible with SVR 4.2 MP DDI/DKI[1], and implementations based on SVR 4[2] with the following protability considerations:

---: rmvb() is not bug for bug compatible with LiS.
: When mp and bp are NULL, rmvb() correctly returns (mblk_t *)(-1). Under LiS rmvb() will return NULL in the same situation. This is an LiS bug.
: Portable STREAMS drivers and modules will not pass NULL pointers to rmvb().
---: rmvb() sets the block pointer's continuation pointer, bp->b_cont, to NULL. No other implementation documents this behaviour.
: Portable STREAMS drivers and modules will not rely upon rmvb() setting the removed block's continuation pointer, bp->b_cont to NULL.
---: Binary compatibility is not guaranteed.

See STREAMS(9) for additional compatibility considerations.

CONFORMANCE

SVR 4.2 MP DDI/DKI[1].

HISTORY

rmvb() appears as part of SVR 4.0 STREAMS[3].

rmvb() first appeared in SVR 3[4].

REFERENCES

[1]: USL DDI/DKI, Device Driver Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual for Intel Processors, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]: SVR 4 DDI/DKI, UNIX® System V Release 4 Device Driver Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[3]: SVR 4, UNIX® System V Release 4 STREAMS Programmer's Guide, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[4]: SVR 3, UNIX® System V Release 3 STREAMS Programmer's Guide, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

Linux Fast-STREAMS: Package streams version 0.9.2.4 released 2008-10-31.

Index

NAME
SYNOPSIS
ARGUMENTS
INTERFACE
DESCRIPTION
RETURN
ERRORS
CONTEXT
MP-STREAMS
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 04:05:58 GMT, May 24, 2013

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci