Manual page for dupmsg(9F)
dupmsg - duplicate a message
SYNOPSIS
#include <sys/stream.h>
mblk_t *dupmsg(mblk_t *mp);
INTERFACE LEVEL
Architecture independent level 1 (DDI/DKI).
ARGUMENTS
- 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 message 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
indicates 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
See
copyb.9f
for an example using
dupmsg().
SEE ALSO
copyb.9f
copymsg.9f
dupb.9f
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97
