SVR5 and SCO OpenServer 5

dupmsg(D3str)

dupmsg -- duplicate a message

Synopsis

   #include <sys/stream.h>
   #include <sys/ddi.h>
   
   mblk_t *dupmsg(mblk_t *mp);

Description

dupmsg forms a new message by duplicating the message blocks in the message pointed to by mp and linking them using their b_cont pointers.

Arguments

mp: Pointer to the msgb(D4str) message block.

Return values

On success, dupmsg returns a pointer to the new message. On failure, it returns a NULL pointer.

Usage

The dupmsg( ) function calls the dupb(D3str) function to duplicate the specified message block. This is done by copying all individual message block descriptors and then linking the new message blocks to form the new message. dupmsg( ) does not copy data buffers, only message block descriptors.

Context

Base or Interrupt.

Synchronization constraints

Does not block.

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function.

Examples

See the copyb(D3str) manual page for an example of dupmsg.

Hardware applicability

All

Version applicability

ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp
oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp

References

copyb(D3str), copymsg(D3str), dupb(D3str), datab(D4str), msgb(D4str)