opensolaris man page for sip_hold_msg

sip_hold_msg(3SIP)				   Session Initiation Protocol Library Functions				sip_hold_msg(3SIP)

NAME
       sip_hold_msg, sip_free_msg - adds and removes a reference from a SIP message

SYNOPSIS
       cc [ flag ... ] file ... -lsip [ library ... ]
       #include <sip.h>

       void sip_hold_msg(sip_msg_t sip_msg);

       void sip_free_msg(sip_msg_t sip_msg);

DESCRIPTION
       The  sip_hold_msg()  function  adds a reference to the SIP message passed as the argument. The reference is used to prevent the SIP message
       from being freed when in use.

       The sip_free_msg() function is used to remove an added reference on the SIP message passed as the argument. If this is the  last  reference
       on  the	SIP  message (i.e. the number of references on the SIP message is 0), the SIP message is destroyed and associated resources freed.
       Freeing a SIP message does not set the sip_msg pointer to NULL. Applications should not expect the pointer to a freed  SIP  message  to	be
       NULL.

RETURN VALUES
       The value of errno is not changed by these calls in the event of an error.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       libsip(3LIB)

SunOS 5.11							    25 Jan 2007 						sip_hold_msg(3SIP)