1msgpullup(9F)            Kernel Functions for Drivers            msgpullup(9F)
2
3
4

NAME

6       msgpullup - concatenate bytes in a message
7

SYNOPSIS

9       #include <sys/stream.h>
10
11
12
13       mblk_t *msgpullup(mblk_t *mp, ssize_t len);
14
15

INTERFACE LEVEL

17       Architecture independent level 1 (DDI/DKI).
18

PARAMETERS

20       mp     Pointer to the message whose blocks are to be concatenated.
21
22
23       len    Number of bytes to concatenate.
24
25

DESCRIPTION

27       The  msgpullup()  function  concatenates  and aligns the first len data
28       bytes of the message pointed to by mp, copying the data into a new mes‐
29       sage.  Any  remaining  bytes  in  the  remaining message blocks will be
30       copied and linked onto the new message. The original message  is  unal‐
31       tered. If len equals −1, all data are concatenated. If len bytes of the
32       same message type cannot be found, msgpullup() fails and returns NULL.
33

RETURN VALUES

35       The msgpullup function returns the following values:
36
37       Non-null    Successful completion. A pointer  to  the  new  message  is
38                   returned.
39
40
41       NULL        An error occurred.
42
43

CONTEXT

45       The  msgpullup() function can be called from user, interrupt, or kernel
46       context.
47

SEE ALSO

49       srv(9E), allocb(9F), pullupmsg(9F), msgb(9S)
50
51
52       Writing Device Drivers
53
54
55       STREAMS Programming Guide
56

NOTES

58       The msgpullup() function is a DKI-compliant replacement for  the  older
59       pullupmsg(9F) routine. Users are strongly encouraged to use msgpullup()
60       instead of pullupmsg(9F).
61
62
63
64SunOS 5.11                        16 Jan 2006                    msgpullup(9F)