dupmsg Utility

Purpose

Duplicates a message.

Syntax

mblk_t *
dupmsg(bp)
register mblk_t *bp;

Description

The dupmsg utility calls the dupb utility to duplicate the message pointed to by the bp parameter by copying all individual message block descriptors and then linking the new message blocks to form the new message. The dupmsg utility does not copy data buffers, only message-block descriptors.

Parameters

Return Values

On successful completion, the dupmsg utility returns a pointer to the new message. Otherwise, it returns a null pointer.

Implementation Specifics

This utility is part of STREAMS Kernel Extensions.

Related Information

The dupb utility.

List of Streams Programming References and Understanding STREAMS Messages in AIX Version 4.3 Communications Programming Concepts.