*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> dupmsg (9r)              



NAME    [Toc]    [Back]

       dupmsg - STREAMS: Duplicates a message

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP dupmsg(
               MBLKP message_block_ptr );

ARGUMENTS    [Toc]    [Back]

       Specifies  a  pointer  to  the  message block. The typedef
       MBLKP is an alternate name for typedef struct msgb *.

DESCRIPTION    [Toc]    [Back]

       The dupmsg interface forms a new message  by  copying  the
       message   block   descriptors   pointed  to  by  the  message_block_ptr
  argument  and  linking  them.  The  dupmsg
       interface  calls  dupb  for  each  message block. The data
       blocks themselves are not duplicated.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the dupmsg interface returns a
       pointer  to the newly allocated message block.  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, dupmsg returns a NULL pointer.

SEE ALSO    [Toc]    [Back]

       Kernel Interfaces: copyb(9r), copymsg(9r), dupb(9r)

       Programmer's Guide: STREAMS

[ Back ]
 Similar pages
Name OS Title
dupb Tru64 STREAMS: Duplicates a message block descriptor
insq Tru64 STREAMS: Inserts a STREAMS message into a queue
unlinkb Tru64 STREAMS: Removes a message block from the head of a message
datamsg Tru64 STREAMS: Tests whether a message is a data message
freemsg Tru64 STREAMS: Frees all message blocks in a message
copymsg Tru64 STREAMS: Copies a message to a new message
linkb Tru64 STREAMS: Concatenates two message blocks
getmsg HP-UX receive next message from a STREAMS file
getpmsg HP-UX receive next message from a STREAMS file
freeb Tru64 STREAMS: Frees a message block
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service