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). 

ARGUMENTS

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-complaint replacement for the older pullupmsg(9F) routine.  Users are strongly encouraged to use msgpullup() instead of of pullupmsg(9F). 

SunOS 5.6  —  Last change: 11 Nov 1996