debian man page for msgpullup

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

NAME
       msgpullup - concatenate bytes in a message

SYNOPSIS
       #include <sys/stream.h>

       mblk_t *msgpullup(mblk_t *mp, ssize_t len);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       mp	Pointer to the message whose blocks are to be concatenated.

       len	Number of bytes to concatenate.

DESCRIPTION
       msgpullup()  concatenates  and  aligns  the first len data bytes of the message pointed to by mp, copying the data into a new message.  Any
       remaining bytes in the remaining message blocks will be copied and linked onto the new message. The original message is unaltered.  If  len
       equals -1, all data are concatenated. If len bytes of the same message type cannot be found, msgpullup() fails and returns NULL.

RETURN VALUES
       msgpullup returns the following values:

       Non-null        Successful completion.  A pointer to the new message is returned.

       NULL	       An error occurred.

CONTEXT
       msgpullup() can be called from user or interrupt context.

SEE ALSO
       srv(9E), allocb(9F), pullupmsg(9F), msgb(9S)

       Writing Device Drivers

	STREAMS Programming Guide

NOTES
       msgpullup() is a DKI-compliant replacement for the older pullupmsg(9F) routine. Users are strongly encouraged to use msgpullup() instead of
       pullupmsg(9F).

SunOS 5.10							    11 Nov 1996 						     msgpullup(9F)