linkb(9F)						   Kernel Functions for Drivers 						 linkb(9F)

NAME

       linkb - concatenate two message blocks

SYNOPSIS

       #include <sys/stream.h>

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

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.

       The following figure describes how the linkb(m1, m2); function concatenates two message blocks, mp1 and mp2:

	      Please see the online man page on docs.sun.com or a print copy for the diagram.

       Figure that describes how the linkb(m1, m2); function creates a new message by adding mp1 to the tail of 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.

CONTEXT

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

EXAMPLES

       See dupb(9F) for an example that uses linkb().

SEE ALSO

       dupb(9F), unlinkb(9F), msgb(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    22 Mar 2002 							 linkb(9F)