dupmsg(9r) [osf1 man page]

dupmsg(9r)																dupmsg(9r)

NAME

       dupmsg - STREAMS: Duplicates a message

SYNOPSIS

       #include <sys/stream.h>

       MBLKP dupmsg(
	       MBLKP message_block_ptr );

ARGUMENTS

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

DESCRIPTION

       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

       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

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

       Programmer's Guide: STREAMS

																	dupmsg(9r)

dupmsg(9F)						   Kernel Functions for Drivers 						dupmsg(9F)

NAME

       dupmsg - duplicate a message

SYNOPSIS

       #include <sys/stream.h>

       mblk_t *dupmsg(mblk_t *mp);

INTERFACE LEVEL

       Architecture independent level 1 (DDI/DKI).

PARAMETERS

       mp	Pointer to the message.

DESCRIPTION

       dupmsg()  forms a new message by copying the message block descriptors pointed to by  mp and linking them. dupb(9F) is called for each mes-
       sage block. The data blocks themselves are not duplicated.

RETURN VALUES

       If successful,  dupmsg() returns a pointer to the new message block. Otherwise, it returns a  NULL pointer. A return value of   NULL  indi-
       cates either memory depletion or the data block reference count, db_ref (see datab(9S)), has reached a limit(255). See  dupb(9F).

CONTEXT

       dupmsg() can be called from user, kernel, or interrupt context.

EXAMPLES

       Example 1: Using dupmsg()

       See copyb(9F) for an example using dupmsg().

SEE ALSO

       copyb(9F), copymsg(9F), dupb(9F), datab(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    11 Apr 1991 							dupmsg(9F)