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

\fBconst struct sip_xaction *\fR\fIsip_get_trans\fR(\fBsip_msg_t\fR \fIsip_msg\fR, \fBint\fR \fIwhich\fR,
     \fBint *\fR\fIerror\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBsip_get_trans()\fR transaction for the SIP message \fIsip_msg\fR. A transaction is not freed if there are any references on it.
.sp
.LP
The transaction type should be specified as one of the following:
.br
.in +2
\fBSIP_CLIENT_TRANSACTON\fR - lookup a client transaction
.in -2
.br
.in +2
\fBSIP_SERVER_TRANSACTON\fR - lookup a server transaction
.in -2
.sp
.LP
The \fBsip_get_trans()\fR function matches a transaction to a message as specified in RFC 3261, sections 17.1.3 and 17.2.3. The \fBsip_get_trans()\fR function holds a reference to the returned transaction. The caller must release this reference after use.
.SH RETURN VALUES
.sp
.LP
The \fBsip_get_trans()\fR function returns the required value on success or \fINULL\fR on failure.
.sp
.LP
The value of \fBerrno\fR is not changed by these calls in the event of an error.
.SH ERRORS
.sp
.LP
On success, the value of the location pointed to by \fIerror\fR is set to \fB0\fR.
.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)