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.10 11 Apr 1991 dupmsg(9F)