.IX \f4dupmsg\fP(D3DK)
.IX STREAMS message blocks

NAME

dupmsg − duplicate a message

SYNOPSIS

#include <sys/stream.h>
mblk_t ∗dupmsg(mblk_t ∗mp);

ARGUMENTS

mpPointer to the message. 

DESCRIPTION

dupmsg forms a new message by duplicating the message blocks in the message pointed to by mp and linking them via their b_cont pointers. 

RETURN VALUE

If successful, dupmsg returns a pointer to the new message.  Otherwise, it returns a NULL pointer. 

LEVEL

Base or Interrupt. 

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function. 

NOTES

Does not sleep. 

SEE ALSO

copyb(D3DK), copymsg(D3DK), dupb(D3DK), datab(D4DK), msgb(D4DK)

EXAMPLE

See the copyb(D3DK) manual page for an example of dupmsg. 

DDI/DKI  —  STREAMS