.IX \f4msgpullup\fP(D3DK)

NAME

msgpullup − concatenate bytes in a message

SYNOPSIS

#include <sys/stream.h>
mblk_t ∗msgpullup(mblk_t ∗mp, int len);

ARGUMENTS

mpPointer to the message whose blocks are to be concatenated. 

lenNumber 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.  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 VALUE

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

LEVEL

Base or Interrupt

NOTES

Does not sleep. 

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function. 

SEE ALSO

allocb(D3DK), msgb(D4DK)

DDI/DKI  —  STREAMS