STREAMS-UX Programmer's Guide (February 2007)

STREAMS Utilities Supported by HP-UX
Appendix B
191
NAME
pullupmsg () – pullupmsg concatenates multiple message blocks into a single message block.
SYNOPSIS
#include <sys/stream.h>
int pullupmsg (mblk_t *mp, int len);
PARAMETERS
mp Pointer to message whose message blocks are to be concatenated.
len Number of bytes to be concatenated. If len = -1, all message blocks from the original
message are concatenated into a single message block.
DESCRIPTION
pullupmsg() concatenates and aligns the number of bytes as represented by len bytes stored in a complex
message
mp . The pullupmsg only concatenates of same message type. If len is -1 then pullupmsg() will
concatenate and align the entire contents of all the messages into a single data block.
RETURN VALUES
pullupmsg returns 1 on success, and a 0 on failure.
CONSTRAINTS
pullupmsg() can be called from thread or interrupt context. Only spinlocks of STREAMS/UX user lock order
can be held across this call.