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)

SunOS 5.1 Writing Device Drivers
SunOS 5.1 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.2  —  Last change: 8 Oct 1992