copymsg(9r)copymsg(9r)NAMEcopymsg - STREAMS: Copies a message to a new message
SYNOPSIS
#include <sys/stream.h>
MBLKP copymsg(
MBLKP message_block );
ARGUMENTS
Specifies a pointer to the message block from which copymsg copies the
data. (Actually, copymsg calls the copyb interface to copy the data.)
The typedef MBLKP is an alternate name for typedef struct msgb *.
DESCRIPTION
The copymsg interface: Forms a new message by allocating new message
blocks Copies (by calling the copyb interface) the contents of the mes‐
sage referred to by the message_block argument Returns a pointer to the
new message block.
RETURN VALUES
Upon successful completion, the copymsg interface returns a pointer to
the newly allocated message block that contains the copied data. 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, copymsg returns a NULL pointer.
SEE ALSO
Kernel Interfaces: allocb(9r), copyb(9r)
Programmer's Guide: STREAMS
copymsg(9r)