1sip_get_trans(3SIPS)ession Initiation Protocol Library Functiosnisp_get_trans(3SIP)
2
3
4

NAME

6       sip_get_trans - lookup a transaction
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsip [ library ... ]
10       #include <sip.h>
11
12       const struct sip_xaction *sip_get_trans(sip_msg_t sip_msg, int which,
13            int *error);
14
15

DESCRIPTION

17       The sip_get_trans() transaction for the SIP message sip_msg. A transac‐
18       tion is not freed if there are any references on it.
19
20
21       The transaction type should be specified as one of the following:
22         SIP_CLIENT_TRANSACTON - lookup a client transaction
23         SIP_SERVER_TRANSACTON - lookup a server transaction
24
25
26       The sip_get_trans() function matches a  transaction  to  a  message  as
27       specified  in RFC 3261, sections 17.1.3 and 17.2.3. The sip_get_trans()
28       function holds a reference to the returned transaction. The caller must
29       release this reference after use.
30

RETURN VALUES

32       The  sip_get_trans()  function returns the required value on success or
33       NULL on failure.
34
35
36       The value of errno is not changed by these calls in  the  event  of  an
37       error.
38

ERRORS

40       On success, the value of the location pointed to by error is set to 0.
41

ATTRIBUTES

43       See attributes(5) for descriptions of the following attributes:
44
45
46
47
48       ┌─────────────────────────────┬─────────────────────────────┐
49       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
50       ├─────────────────────────────┼─────────────────────────────┤
51       │Interface Stability          │Committed                    │
52       ├─────────────────────────────┼─────────────────────────────┤
53       │MT-Level                     │MT-Safe                      │
54       └─────────────────────────────┴─────────────────────────────┘
55

SEE ALSO

57       libsip(3LIB)
58
59
60
61SunOS 5.11                        25 Jan 2007              sip_get_trans(3SIP)
Impressum