Index for Section 9r

Alphabetical listing for C

Bottom of page

copymsg(9r)
NAME
  copymsg - STREAMS: Copies a message to a new message

SYNOPSIS
  #include <sys/stream.h>

  MBLKP copymsg(
	  MBLKP message_block );

ARGUMENTS
  message_block
      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

Index for Section 9r

Alphabetical listing for C

Top of page