dupmsg(9r)dupmsg(9r)NAMEdupmsg - STREAMS: Duplicates a message
SYNOPSIS
#include <sys/stream.h>
MBLKP dupmsg(
MBLKP message_block_ptr );
ARGUMENTS
Specifies a pointer to the message block. The typedef MBLKP is an
alternate name for typedef struct msgb *.
DESCRIPTION
The dupmsg interface forms a new message by copying the message block
descriptors pointed to by the message_block_ptr argument and linking
them. The dupmsg interface calls dupb for each message block. The data
blocks themselves are not duplicated.
RETURN VALUES
Upon successful completion, the dupmsg interface returns a pointer to
the newly allocated message block. This newly allocated message block
is of type struct msgb *. The msgb data structure is defined in the
/usr/sys/include/sys/stream.h file.
Otherwise, dupmsg returns a NULL pointer.
SEE ALSO
Kernel Interfaces: copyb(9r), copymsg(9r), dupb(9r)
Programmer's Guide: STREAMS
dupmsg(9r)