Manual Pages for UNIX Operating System command usage for man sip_free_msg

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 

     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 mes-
     sage  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 des-
     troyed 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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     libsip(3LIB)





SunOS 5.11          Last change: 25 Jan 2007                    1