Session Initiation Protocol Library Functions
                                            sipholddialog(3SIP)



NAME
     sipholddialog, sipreleasedialog - hold/release reference
     on a dialog

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

     void sipholddialog(sipdialogt dialog);


     void sipreleasedialog(sipdialogt dialog);


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

       typedef struct sipstr {
            char *sipstrptr;
            int  sipstrlen;
       }sipstrt;



     The  sipstrptr  parameter  points  to  the  start  of  the
     returned  value  and  sipstrlen supplies the length of the
     returned value.


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


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

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

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                            sipholddialog(3SIP)




           ATRIBUTE TYPE               ATRIBUTE 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
                                            sipholddialog(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3