linkb(9F)

NAME | SYNOPSIS | PARAMETERS | INTERFACE LEVEL | DESCRIPTION | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES

NAME

linkb- Concatenate two message blocks

SYNOPSIS

#include <sys/stream.h>

void linkb(mblk_t *mp1, mblk_t *mp2);

PARAMETERS

mp1

The message to which mp2 is to be added. mblk_t is an instance of the msgb(9S) structure.

mp2

The message to be added.

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI).

DESCRIPTION

linkb() creates a new message by adding mp2 to the tail of mp1. The continuation pointer, b_cont, of mp1 is set to point to mp2.



linkb(mp1, mp2);

CONTEXT

linkb() can be called from user or interrupt context.

EXAMPLES

See dupb(9F) for an example of using linkb().

SUMMARY OF TRUSTED SOLARIS CHANGES

This function can fail because of mismatched attributes attached to the messages. If any attributes are different, the second message is discarded. Module writers should check the attributes before calling this function or use the tsol_linkb(9F) function.

SEE ALSO

Trusted Solaris 8 Reference Manual

dupb(9F), unlinkb(9F), tsol_linkb(9F)

SunOS 5.8 Reference Manual

msgb(9S)

Writing Device Drivers

STREAMS Programming Guide

NOTES

These interfaces are uncommitted. Although not expected to do so, they may change between minor Trusted Solaris releases.

Trusted Solaris 8  Last Revised 30 Sep 1999

NAME | SYNOPSIS | PARAMETERS | INTERFACE LEVEL | DESCRIPTION | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES