NAME

msgpullup − concatenate bytes in a message

SYNOPSIS

#include <sys/stream.h>

mblk_t ∗msgpullup(mblk_t ∗mp, int len);

ARGUMENTS

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

len Number of bytes to concatenate. 

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI). 

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

On success, a pointer to the new message is returned; on failure, NULL is returned. 

CONTEXT

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

SEE ALSO

srv(9E), allocb(9F), msgb(9S)

Writing Device Drivers
STREAMS Programmer’s 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.4  —  Last change: 8 Oct 1992