dupb(9r) [osf1 man page]

dupb(9r)																  dupb(9r)

NAME

       dupb - STREAMS: Duplicates a message block descriptor

SYNOPSIS

       #include <sys/stream.h>

       MBLKP dupb(
	       MBLKP message_block_ptr );

ARGUMENTS

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

DESCRIPTION

       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  mes-
       sage block structure contains the same information as the first message block structure.

RETURN VALUES

       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

       Kernel Interfaces: copyb(9r)

       Programmer's Guide: STREAMS

																	  dupb(9r)