Index for Section 9r

Alphabetical listing for D

Bottom of page

dupb(9r)
NAME
  dupb - STREAMS: Duplicates a message block descriptor

SYNOPSIS
  #include <sys/stream.h>

  MBLKP dupb(
	  MBLKP message_block_ptr );

ARGUMENTS
  message_block_ptr
      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

Index for Section 9r

Alphabetical listing for D

Top of page