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);  func-
     tion concatenates two message blocks, mp1 and mp2:

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

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