dupb(9r)dupb(9r)NAMEdupb - 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 message
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)