posix man page for freemsg

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() imme-
		diately returns.

DESCRIPTION

       freemsg() calls freeb(9F) to free all message and data blocks associated with the message pointed to by mp.

CONTEXT

       freemsg() can be called from user or interrupt context.

EXAMPLES

       Example 1: Using freemsg()

       See copymsg(9F).

SEE ALSO

       copymsg(9F), freeb(9F), msgb(9S)

       Writing Device Drivers

       STREAMS Programming Guide

NOTES

       The behavior of freemsg() when passed a NULL pointer is Solaris-specific.

SunOS 5.10							    26 Oct 2001 						       freemsg(9F)