'\" te
.\"  Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved
.TH sip_hold_trans 3SIP "25 Jan 2007" "SunOS 5.11" "Session Initiation Protocol Library Functions"
.SH NAME
sip_hold_trans, sip_release_trans \- hold or release reference on a transaction
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lsip\fR [ \fIlibrary\fR ... ]
#include <sip.h>

\fBvoid\fR \fIsip_hold_trans\fR(\fBsip_transaction_t\fR \fIsip_trans\fR);
.fi

.LP
.nf
\fBvoid\fR \fIsip_release_trans\fR(\fBsip_transaction_t\fR \fIsip_trans\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBsip_hold_trans()\fR function is used to hold a reference on the transaction \fIsip_trans\fR. A transaction is not freed if there are any references on it.
.sp
.LP
The \fBsip_release_trans()\fR function is used to release a reference on the transaction \fIsip_trans\fR. If the reference falls to \fB0\fR and the transaction is in a terminated state, the transaction is freed.
.SH RETURN VALUES
.sp
.LP
The value of \fBerrno\fR is not changed by these calls in the event of an error.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
.TE

.SH SEE ALSO
.sp
.LP
\fBlibsip\fR(3LIB)