NAME    [Toc]    [Back]

       dupmsg - STREAMS: Duplicates a message

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP dupmsg(
               MBLKP message_block_ptr );

ARGUMENTS    [Toc]    [Back]

       Specifies  a  pointer  to  the  message block. The typedef
       MBLKP is an alternate name for typedef struct msgb *.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Kernel Interfaces: copyb(9r), copymsg(9r), dupb(9r)

       Programmer's Guide: STREAMS



                                                       dupmsg(9r)