Manual Pages for UNIX Operating System command usage for man sip_hold_dialog

Session Initiation Protocol Library Functions
                                            sip_hold_dialog(3SIP)



NAME
     sip_hold_dialog, sip_release_dialog - hold/release reference
     on a dialog

SYNOPSIS
     cc [ flag ... ] file ... -lsip [ library ... ]
     #include 

     void sip_hold_dialog(sip_dialog_t dialog);


     void sip_release_dialog(sip_dialog_t dialog);


DESCRIPTION
     For functions that  return  a  pointer  of  type  sip_str_t,
     sip_str_t is supplied by:

       typedef struct sip_str {
            char *sip_str_ptr;
            int  sip_str_len;
       }sip_str_t;



     The  sip_str_ptr  parameter  points  to  the  start  of  the
     returned  value  and  sip_str_len supplies the length of the
     returned value.


     The sip_hold_dialog() function is used to hold  a  reference
     on the dialog. A dialog is not freed if there are any refer-
     ences on it.


     The sip_release_dialog()  function  is  used  to  release  a
     reference  in the dialog. If the reference in a dialog drops
     to 0 and it is in SIP_DLG_DESTROYED state, it is freed.

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:








SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                            sip_hold_dialog(3SIP)



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


SEE ALSO
     libsip(3LIB)











































SunOS 5.11          Last change: 25 Jan 2007                    2






Session Initiation Protocol Library Functions
                                            sip_hold_dialog(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3