FREEMSG(9F)             Kernel Functions for Drivers             FREEMSG(9F)
NAME
       freemsg - free all message blocks in a message
SYNOPSIS
       #include <sys/stream.h>       
void freemsg(
mblk_t *mp);
INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).
PARAMETERS
       mp             Pointer to the message blocks to be deallocated. 
mblk_t is an
             instance of the 
msgb(9S) structure. If 
mp is 
NULL, 
freemsg()             immediately returns.
DESCRIPTION
       The 
freemsg() function calls 
freeb(9F) to free all message and data
       blocks associated with the message pointed to by 
mp.
CONTEXT
       The 
freemsg() function can be called from user, interrupt, or kernel
       context.
EXAMPLES
       Example 1: Using freemsg()
       See 
copymsg(9F).
SEE ALSO
       copymsg(9F), 
freeb(9F), 
msgb(9S)       Writing Device Drivers       STREAMS Programming GuideNOTES
       The behavior of 
freemsg() when passed a 
NULL pointer is Solaris-
       specific.
                              January 16, 2006                   FREEMSG(9F)