Manpage of UNLINKB

UNLINKB

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

NAME

unlinkb - unlink a message block from a STREAMS message

SYNOPSIS

#include <sys/stream.h>

mblk_t *unlinkb(mblk_t *mp);

ARGUMENTS

mp: the message to unlink.

INTERFACE

STREAMS.

DESCRIPTION

unlinkb() removes the first message block from the message pointed to by mp and returns a pointer to the next message block in the message (or NULL if there are no remaining message blocks in the message). The removed message block is not freed.

RETURN

Upon success, unlinkb() returns a pointer to the next message block in the message, or NULL if there is no further message blocks in the message. Upon failure, unlinkb() returns NULL.

ERRORS

When unlinkb() fails, it returns NULL. unlinkb() fails when the message pointer mp is NULL.

CONTEXT

unlinkb() can be called from any context including user context, queue procedures, callouts, callbacks and interrupt service routines.

MP-STREAMS

is MP-safe; however, the caller is responsible for ensuring exclusive access to the passed in message block, mp.

NOTICES

None.

BUGS

unlinkb() has no known bugs.

COMPATIBILITY

unlinkb() is compatible with SVR 4.2 MP DDI/DKI[1], and systems based on SVR 4, with the following portability considerations:

---: Binary compatibility is not guaranteed.

See STREAMS(9) for additional compatibility considerations.

CONFORMANCE

SVR 4.2 MP DDI/DKI[1],

HISTORY

unlinkb() appears as part of SVR 4.0 STREAMS[2].

unlinkb() first appeared in SVR 3[3].

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, UNIX® System V Release 4 STREAMS Programmer's Guide, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[3]: 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
NOTICES
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 11:42:35 GMT, May 19, 2013