Name | Synopsis | Description | Return Values | Attributes | See Also
cc [ flag ... ] file ... -lsip [ library ... ] #include <sip.h> void sip_hold_dialog(sip_dialog_t dialog);
void sip_release_dialog(sip_dialog_t dialog);
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 references 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.
The value of errno is not changed by these calls in the event of an error.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Interface Stability |
Committed |
MT-Level |
MT-Safe |
Name | Synopsis | Description | Return Values | Attributes | See Also