osf1 man page for dupb

Query: dupb

OS: osf1

Section: 9r

Links: osf1 man pages   all man pages

Forums: forum home   forum categories

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)