copymsg(9r) copymsg(9r)
NAME
copymsg - 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
message 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)
