NAME    [Toc]    [Back]

       dupb - STREAMS: Duplicates a message block descriptor

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP dupb(
               MBLKP message_block_ptr );

ARGUMENTS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       The  dupb  interface creates a new message block structure
       to reference the message block  pointed  to  by  the  message_block_ptr
  argument. Unlike copyb, the dupb interface
       does not copy the information in the data block, but  creates
 a new structure to point to it. The new message block
       structure contains the same information as the first  message
 block structure.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion, the dupb 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, dupb returns a NULL pointer.

SEE ALSO    [Toc]    [Back]

       Kernel Interfaces: copyb(9r)

       Programmer's Guide: STREAMS



                                                         dupb(9r)