NAME | SYNOPSIS | INTERFACE LEVEL | PARAMETERS | DESCRIPTION | RETURN VALUES | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES
#include <sys/stream.h>mblk_t *dupmsg(mblk_t *mp);
Architecture independent level 1 (DDI/DKI).
dupmsg() forms a new message by copying the message block descriptors pointed to by mp and linking them. dupb(9F) is called for each message block. The data blocks themselves are not duplicated.
If successful, dupmsg() returns a pointer to the new message block. Otherwise, it returns a NULL pointer. A return value of NULL indicates either memory depletion or the data block reference count, db_ref (see datab(9S)), has reached a limit (255). See dupb(9F).
dupmsg() can be called from user, kernel, or interrupt context.
See copyb(9F) for an example using dupmsg().
This routine will preserve the attributes of the message it manipulates.
These interfaces are uncommitted. Although not expected to do so, they may change between minor Trusted Solaris releases.
NAME | SYNOPSIS | INTERFACE LEVEL | PARAMETERS | DESCRIPTION | RETURN VALUES | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES