opensolaris man page for dupmsg

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

NAME
       dupmsg - duplicate a message

SYNOPSIS
       #include <sys/stream.h>

       mblk_t *dupmsg(mblk_t *mp);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       mp     Pointer to the message.

DESCRIPTION
       dupmsg()  forms a new message by copying the message block descriptors pointed to by  mp and linking them. dupb(9F) is called for each mes-
       sage block. The data blocks themselves are not duplicated.

RETURN VALUES
       If successful,  dupmsg() returns a pointer to the new message block. Otherwise, it returns a  NULL pointer. A return value of   NULL  indi-
       cates either memory depletion or the data block reference count, db_ref (see datab(9S)), has reached a limit(255). See  dupb(9F).

CONTEXT
       dupmsg() can be called from user, kernel, or interrupt context.

EXAMPLES
       Example 1 Using dupmsg()

       See copyb(9F) for an example using dupmsg().

SEE ALSO
       copyb(9F), copymsg(9F), dupb(9F), datab(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.11							    11 Apr 1991 							dupmsg(9F)