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

sip_hold_dialog, sip_release_dialog - hold/release reference on a dialog

cc [ flag ... ] file ... -lsip [ library ... ]
#include <sip.h>
void sip_hold_dialog(sip_dialog_t dialog);

void sip_release_dialog(sip_dialog_t dialog);

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 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(7) for descriptions of the following attributes:

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

libsip(3LIB)

January 25, 2007 OmniOS