sunos man page for linkb

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)