osf1 man page for dupmsg

dupmsg(9r)																dupmsg(9r)

NAME
       dupmsg - 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)