NAME    [Toc]    [Back]

       copymsg - STREAMS: Copies a message to a new message

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP copymsg(
               MBLKP message_block );

ARGUMENTS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Kernel Interfaces: allocb(9r), copyb(9r)

       Programmer's Guide: STREAMS



                                                      copymsg(9r)