osf1 man page for copymsg

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)