nta  1.12.11devel
nta.h
Go to the documentation of this file.
1 /*
2  * This file is part of the Sofia-SIP package
3  *
4  * Copyright (C) 2005 Nokia Corporation.
5  *
6  * Contact: Pekka Pessi <pekka.pessi@nokia-email.address.hidden>
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public License
10  * as published by the Free Software Foundation; either version 2.1 of
11  * the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful, but
14  * WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
21  * 02110-1301 USA
22  *
23  */
24 
25 #ifndef NTA_H
26 
27 #define NTA_H
28 
36 #ifndef SU_WAIT_H
37 #include <sofia-sip/su_wait.h>
38 #endif
39 
40 #ifndef SIP_H
41 #include <sofia-sip/sip.h>
42 #endif
43 
44 #ifndef NTA_TAG_H
45 #include <sofia-sip/nta_tag.h>
46 #endif
47 
48 SOFIA_BEGIN_DECLS
49 
50 /* ----------------------------------------------------------------------
51  * 1) Types
52  */
53 
55 typedef struct nta_agent_s nta_agent_t;
57 typedef struct nta_leg_s nta_leg_t;
59 typedef struct nta_outgoing_s nta_outgoing_t;
61 typedef struct nta_incoming_s nta_incoming_t;
62 
63 #ifndef NTA_AGENT_MAGIC_T
64 
67 #define NTA_AGENT_MAGIC_T struct nta_agent_magic_s
68 #endif
69 #ifndef NTA_LEG_MAGIC_T
70 
73 #define NTA_LEG_MAGIC_T struct nta_leg_magic_s
74 #endif
75 #ifndef NTA_OUTGOING_MAGIC_T
76 
79 #define NTA_OUTGOING_MAGIC_T struct nta_outgoing_magic_s
80 #endif
81 #ifndef NTA_INCOMING_MAGIC_T
82 
85 #define NTA_INCOMING_MAGIC_T struct nta_incoming_magic_s
86 #endif
87 
96 
97 /* ----------------------------------------------------------------------
98  * 2) Constants
99  */
100 
102 #define NTA_VERSION "2.0"
103 
105 SOFIAPUBVAR char const nta_version[];
106 
107 enum {
108  /* Stack parameters */
109  NTA_SIP_T1 = 500,
110  NTA_SIP_T2 = 4000,
111  NTA_SIP_T4 = 5000,
112  NTA_TIME_MAX = 15 * 24 * 3600 * 1000
114 };
115 
116 /* ----------------------------------------------------------------------
117  * 3) Agent-level prototypes
118  */
119 
120 typedef int nta_message_f(nta_agent_magic_t *context,
121  nta_agent_t *agent,
122  msg_t *msg,
123  sip_t *sip);
124 
127  url_string_t const *name,
128  nta_message_f *callback,
129  nta_agent_magic_t *magic,
130  tag_type_t tag, tag_value_t value, ...);
131 
133 
134 SOFIAPUBFUN char const *nta_agent_version(nta_agent_t const *a);
136 
139  url_string_t const *url,
140  tag_type_t tag, tag_value_t value, ...);
141 
143 
147 
149  char const *fmt, nta_agent_t *);
150 
152  tag_type_t tag, tag_value_t value, ...);
154  tag_type_t tag, tag_value_t value, ...);
155 
157  tag_type_t tag, tag_value_t value, ...);
158 
159 /* ----------------------------------------------------------------------
160  * 4) Message-level prototypes
161  */
162 
163 SOFIAPUBFUN msg_t *nta_msg_create(nta_agent_t *self, int flags);
164 
166 
168  nta_leg_t *leg,
169  sip_method_t method,
170  char const *method_name,
171  url_string_t const *req_url);
172 
173 SOFIAPUBFUN int nta_msg_is_internal(msg_t const *msg);
174 SOFIAPUBFUN int nta_sip_is_internal(sip_t const *sip);
175 
176 /* ----------------------------------------------------------------------
177  * 5) Leg-level prototypes
178  */
179 typedef int nta_request_f(nta_leg_magic_t *lmagic,
180  nta_leg_t *leg,
181  nta_incoming_t *irq,
182  sip_t const *sip);
183 
186  nta_request_f *req_callback,
187  nta_leg_magic_t *magic,
188  tag_type_t tag, tag_value_t value, ...);
189 
191 
193 
195  nta_request_f *callback);
196 
198  nta_request_f *callback,
199  nta_leg_magic_t *);
200 
202 SOFIAPUBFUN char const *nta_leg_tag(nta_leg_t *leg, char const *tag);
203 
205 SOFIAPUBFUN char const *nta_leg_get_tag(nta_leg_t const *leg);
206 
208 SOFIAPUBFUN char const *nta_leg_rtag(nta_leg_t *leg, char const *tag);
209 
211 SOFIAPUBFUN char const *nta_leg_get_rtag(nta_leg_t const *leg);
212 
215 
218 
220  sip_record_route_t const *route,
221  sip_contact_t const *contact);
222 
224  sip_record_route_t const *route,
225  sip_contact_t const *contact,
226  int initial);
227 
229  sip_record_route_t const *route,
230  sip_contact_t const *contact);
231 
234  sip_route_t const **return_route,
235  sip_contact_t const **return_target);
236 
239  url_string_t const *);
240 
244  url_t const *request_uri,
245  sip_call_id_t const *call_id,
246  char const *from_tag,
247  url_t const *from_url,
248  char const *to_tag,
249  url_t const *to_url);
250 
253  su_home_t *home,
254  int early_only);
258 
261 nta_leg_t *nta_leg_by_call_id(nta_agent_t *sa, const char *call_id);
262 
263 /* ----------------------------------------------------------------------
264  * 6) Prototypes for incoming transactions
265  */
266 
269  nta_leg_t *leg,
270  msg_t *msg,
271  sip_t *sip,
272  tag_type_t tag, tag_value_t value, ...);
273 
275 
277  nta_incoming_t *irq,
278  sip_t const *sip);
279 
281  nta_ack_cancel_f *callback,
282  nta_incoming_magic_t *imagic);
283 
286  nta_ack_cancel_f *callback);
287 
290  sip_t const *sip,
291  sip_via_t const *v);
292 
293 SOFIAPUBFUN char const *nta_incoming_tag(nta_incoming_t *irq, char const *tag);
294 SOFIAPUBFUN char const *nta_incoming_gettag(nta_incoming_t const *irq);
295 
298 SOFIAPUBFUN char const *nta_incoming_method_name(nta_incoming_t const *irq);
302 
304  tag_type_t tag, tag_value_t value, ...);
305 
309 
312  msg_t *msg,
313  int status,
314  char const *phrase,
315  tag_type_t tag, tag_value_t value, ...);
316 
318 msg_t *nta_incoming_create_response(nta_incoming_t *irq, int status, char const *phrase);
319 
322  int status, char const *phrase,
323  tag_type_t tag, tag_value_t value, ...);
324 
326 
328 
329 /* Functions for feature, method, mime, session-timer negotation */
330 
333  sip_t const *sip,
334  sip_supported_t const *supported,
335  tag_type_t tag, tag_value_t value, ...);
338  sip_t const *sip,
339  sip_require_t *require,
340  tag_type_t tag, tag_value_t value, ...);
343  sip_t const *sip,
344  sip_allow_t const *allow,
345  tag_type_t tag, tag_value_t value, ...);
347 int nta_check_session_content(nta_incoming_t *irq, sip_t const *sip,
348  sip_accept_t const *session_accepts,
349  tag_type_t tag, tag_value_t value, ...);
352  sip_t const *sip,
353  sip_accept_t const *acceptable,
354  sip_accept_t const **return_acceptable,
355  tag_type_t tag, tag_value_t value, ...);
356 
359  sip_t const *sip,
360  sip_time_t my_min_se,
361  tag_type_t tag, tag_value_t value, ...);
362 
363 /* ----------------------------------------------------------------------
364  * 7) Prototypes for outgoing transactions
365  */
367  nta_outgoing_t *request,
368  sip_t const *sip);
369 
372  nta_response_f *callback,
373  nta_outgoing_magic_t *magic,
374  url_string_t const *route_url,
375  sip_method_t method,
376  char const *method_name,
377  url_string_t const *request_uri,
378  tag_type_t tag, tag_value_t value, ...);
379 
382  nta_response_f *callback,
383  nta_outgoing_magic_t *magic,
384  url_string_t const *route_url,
385  msg_t *msg,
386  tag_type_t tag, tag_value_t value, ...);
387 
390  nta_response_f *callback,
391  nta_outgoing_magic_t *magic);
392 
394  nta_response_f *callback,
395  nta_outgoing_magic_t *magic);
397  nta_response_f *callback);
400 SOFIAPUBFUN char const *nta_outgoing_method_name(nta_outgoing_t const *orq);
402 SOFIAPUBFUN char const *nta_outgoing_branch(nta_outgoing_t const *orq);
403 
404 SOFIAPUBFUN unsigned nta_outgoing_delay(nta_outgoing_t const *orq);
405 
408 
411 
414  nta_response_f *callback,
415  nta_outgoing_magic_t *magic,
416  char const *to_tag,
417  sip_rseq_t const *rseq);
418 
420 
423  nta_response_f *callback,
424  nta_outgoing_magic_t *magic,
425  tag_type_t, tag_value_t, ...);
426 
428 
431  msg_t const *msg,
432  sip_t const *sip,
433  sip_via_t const *v);
434 
436 
437 /* ----------------------------------------------------------------------
438  * 8) Reliable provisional responses (100rel)
439  */
440 
441 /* UAC side */
442 
445  nta_outgoing_t *oorq,
446  nta_response_f *callback,
447  nta_outgoing_magic_t *magic,
448  url_string_t const *route_url,
449  sip_t const *response_to_prack,
450  tag_type_t, tag_value_t, ...);
451 
454 
455 /* UAS side */
456 
458 typedef struct nta_reliable_s nta_reliable_t;
459 
460 #ifndef NTA_RELIABLE_MAGIC_T
461 
464 #define NTA_RELIABLE_MAGIC_T struct nta_reliable_magic_s
465 #endif
466 
469 
470 typedef int nta_prack_f(nta_reliable_magic_t *rmagic,
471  nta_reliable_t *rel,
472  nta_incoming_t *prack,
473  sip_t const *sip);
474 
477  nta_prack_f *callback,
478  nta_reliable_magic_t *rmagic,
479  int status, char const *phrase,
480  tag_type_t tag,
481  tag_value_t value, ...);
482 
485  nta_prack_f *callback,
486  nta_reliable_magic_t *rmagic,
487  msg_t *msg);
488 
490 
491 /* ----------------------------------------------------------------------
492  * Backward-compatibility stuff - going away soon
493  */
494 
495 #define nta_outgoing_tmcreate nta_outgoing_mcreate
496 #define nta_msg_response_complete(msg, irq, status, phrase) \
497  nta_incoming_complete_response((irq), (msg), (status), (phrase), TAG_END())
498 
499 SOFIAPUBFUN void nta_msg_discard(nta_agent_t *agent, msg_t *msg);
500 
501 SOFIAPUBFUN int nta_is_internal_msg(msg_t const *msg);
502 
503 SOFIA_END_DECLS
504 
505 #endif
nta_incoming_mreply
int nta_incoming_mreply(nta_incoming_t *irq, msg_t *msg)
Return a response message to client.
Definition: nta.c:6498
nta_outgoing_tcreate
nta_outgoing_t * nta_outgoing_tcreate(nta_leg_t *leg, nta_response_f *callback, nta_outgoing_magic_t *magic, url_string_t const *route_url, sip_method_t method, char const *method_name, url_string_t const *request_uri, tag_type_t tag, tag_value_t value,...)
Create an outgoing request and client transaction belonging to the leg.
Definition: nta.c:7222
nta_incoming_destroy
void nta_incoming_destroy(nta_incoming_t *irq)
Destroy an incoming transaction.
Definition: nta.c:5444
nta_outgoing_getrequest
msg_t * nta_outgoing_getrequest(nta_outgoing_t *orq)
Get request message.
Definition: nta.c:7623
su_home_t
SU_HOME_T su_home_t
nta_incoming_gettag
char const * nta_incoming_gettag(nta_incoming_t const *irq)
Get local tag for incoming request.
Definition: nta.c:5854
nta_agent_version
char const * nta_agent_version(nta_agent_t const *a)
Return User-Agent header.
Definition: nta.c:1180
nta_incoming_treply
int nta_incoming_treply(nta_incoming_t *ireq, int status, char const *phrase, tag_type_t tag, tag_value_t value,...)
Reply to an incoming transaction request.
Definition: nta.c:6454
nta_check_session_expires
int nta_check_session_expires(nta_incoming_t *irq, sip_t const *sip, sip_time_t my_min_se, tag_type_t tag, tag_value_t value,...)
Check Session-Expires header.
Definition: nta_check.c:410
nta_is_internal_msg
int nta_is_internal_msg(msg_t const *msg)
Check if the message is internally generated by NTA.
Definition: nta.c:3388
nta_leg_get_rseq
uint32_t nta_leg_get_rseq(nta_leg_t const *leg)
Get remote request sequence number.
Definition: nta.c:4501
nta_leg_destroy
void nta_leg_destroy(nta_leg_t *leg)
Destroy a leg.
Definition: nta.c:4341
nta_incoming_create_response
msg_t * nta_incoming_create_response(nta_incoming_t *irq, int status, char const *phrase)
Create a response message for request.
Definition: nta.c:6414
nta_incoming_set_params
int nta_incoming_set_params(nta_incoming_t *irq, tag_type_t tag, tag_value_t value,...)
Set server transaction parameters.
Definition: nta.c:6228
sip_accept_s
nta_incoming_status
int nta_incoming_status(nta_incoming_t const *irq)
Get status code of a server transaction.
Definition: nta.c:5862
nta_leg_client_route
int nta_leg_client_route(nta_leg_t *leg, sip_record_route_t const *route, sip_contact_t const *contact)
Save target and route set at UAC side.
Definition: nta.c:4515
nta_incoming_method_name
char const * nta_incoming_method_name(nta_incoming_t const *irq)
Get method name of a server transaction.
Definition: nta.c:5830
sip_method_t
sip_method_t
nta_leg_make_replaces
sip_replaces_t * nta_leg_make_replaces(nta_leg_t *leg, su_home_t *home, int early_only)
Generate Replaces header.
Definition: nta.c:4581
nta_outgoing_tcancel
nta_outgoing_t * nta_outgoing_tcancel(nta_outgoing_t *orq, nta_response_f *callback, nta_outgoing_magic_t *magic, tag_type_t, tag_value_t,...)
Cancel the request.
Definition: nta.c:7379
nta_agent_create
nta_agent_t * nta_agent_create(su_root_t *root, url_string_t const *name, nta_message_f *callback, nta_agent_magic_t *magic, tag_type_t tag, tag_value_t value,...)
Create an NTA agent object.
Definition: nta.c:855
nta_default_leg
nta_leg_t * nta_default_leg(nta_agent_t const *agent)
Return the default leg, if any.
Definition: nta.c:4304
nta_agent_get_params
int nta_agent_get_params(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Get NTA Parameters.
Definition: nta.c:1764
nta_outgoing_cancel
int nta_outgoing_cancel(nta_outgoing_t *)
Cancel the request.
Definition: nta.c:7347
nta_check_method
int nta_check_method(nta_incoming_t *irq, sip_t const *sip, sip_allow_t const *allow, tag_type_t tag, tag_value_t value,...)
Check that we allow the request method.
Definition: nta_check.c:167
nta_msg_discard
void nta_msg_discard(nta_agent_t *agent, msg_t *msg)
Discard a message.
Definition: nta.c:3365
nta_incoming_received
sip_time_t nta_incoming_received(nta_incoming_t *irq, su_nanotime_t *nano)
When received.
Definition: nta.c:5890
uint32_t
SU_U32_T uint32_t
tag_type_t
struct tag_type_s const * tag_type_t
nta_leg_get_tag
char const * nta_leg_get_tag(nta_leg_t const *leg)
Get local tag.
Definition: nta.c:4453
nta_leg_by_call_id
nta_leg_t * nta_leg_by_call_id(nta_agent_t *sa, const char *call_id)
Get dialog leg by CallID.
Definition: nta.c:4664
nta_outgoing_t
struct nta_outgoing_s nta_outgoing_t
NTA outgoing request.
Definition: nta.h:59
nta_agent_get_stats
int nta_agent_get_stats(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Get NTA statistics.
Definition: nta.c:1873
sip_s
nta_reliable_mreply
nta_reliable_t * nta_reliable_mreply(nta_incoming_t *irq, nta_prack_f *callback, nta_reliable_magic_t *rmagic, msg_t *msg)
Respond reliably with msg.
Definition: nta.c:10876
nta_leg_bind
void nta_leg_bind(nta_leg_t *leg, nta_request_f *callback, nta_leg_magic_t *)
Bind a callback function and context to a leg object.
Definition: nta.c:4397
nta_msg_create
msg_t * nta_msg_create(nta_agent_t *self, int flags)
Create a new message belonging to the agent.
Definition: nta.c:3328
nta_agent_close_tports
int nta_agent_close_tports(nta_agent_t *agent)
Close all transports.
Definition: nta.c:11814
NTA_AGENT_MAGIC_T
#define NTA_AGENT_MAGIC_T
Default type of application context for NTA agents.
Definition: nta.h:67
nta_agent_t
struct nta_agent_s nta_agent_t
NTA agent.
Definition: nta.h:55
nta_outgoing_method_name
char const * nta_outgoing_method_name(nta_outgoing_t const *orq)
Return method name of the client transaction.
Definition: nta.c:7558
nta_leg_get_seq
uint32_t nta_leg_get_seq(nta_leg_t const *leg)
Get local request sequence number.
Definition: nta.c:4495
nta_leg_server_route
int nta_leg_server_route(nta_leg_t *leg, sip_record_route_t const *route, sip_contact_t const *contact)
Save target and route set at UAS side.
Definition: nta.c:4552
NTA_RELIABLE_MAGIC_T
#define NTA_RELIABLE_MAGIC_T
Default type of application context for reliable preliminary responses.
Definition: nta.h:464
nta_outgoing_getresponse
msg_t * nta_outgoing_getresponse(nta_outgoing_t *orq)
Get reference to response message.
Definition: nta.c:7606
nta_leg_rtag
char const * nta_leg_rtag(nta_leg_t *leg, char const *tag)
Add remote tag.
Definition: nta.c:4471
msg_list_s
nta_incoming_getresponse
msg_t * nta_incoming_getresponse(nta_incoming_t *irq)
Get response message.
Definition: nta.c:5813
nta_agent_magic
nta_agent_magic_t * nta_agent_magic(nta_agent_t const *a)
Return agent context.
Definition: nta.c:1085
nta_agent_via
sip_via_t * nta_agent_via(nta_agent_t const *a)
Return a list of Via headers.
Definition: nta.c:1123
nta_ack_cancel_f
int nta_ack_cancel_f(nta_incoming_magic_t *imagic, nta_incoming_t *irq, sip_t const *sip)
Callback function prototype for CANCELed/ACKed requests.
Definition: nta.h:276
url_t
nta_incoming_t
struct nta_incoming_s nta_incoming_t
NTA incoming request.
Definition: nta.h:61
nta_outgoing_magic_t
NTA_OUTGOING_MAGIC_T nta_outgoing_magic_t
Application context for outgoing NTA requests.
Definition: nta.h:93
nta_incoming_method
sip_method_t nta_incoming_method(nta_incoming_t const *irq)
Get method of a server transaction.
Definition: nta.c:5824
nta_outgoing_magic
nta_outgoing_magic_t * nta_outgoing_magic(nta_outgoing_t const *orq, nta_response_f *callback)
Get application context bound to a client transaction.
Definition: nta.c:7508
nta_outgoing_delay
unsigned nta_outgoing_delay(nta_outgoing_t const *orq)
Get the RTT delay measured using Timestamp header.
Definition: nta.c:7581
nta_incoming_tag
char const * nta_incoming_tag(nta_incoming_t *irq, char const *tag)
Add a To tag to incoming request if needed.
Definition: nta.c:5730
nta_check_required
int nta_check_required(nta_incoming_t *irq, sip_t const *sip, sip_supported_t const *supported, tag_type_t tag, tag_value_t value,...)
Check that we support all features which UAC requires.
Definition: nta_check.c:70
nta_outgoing_method
sip_method_t nta_outgoing_method(nta_outgoing_t const *orq)
Return method of the client transaction.
Definition: nta.c:7552
tag_value_t
intptr_t tag_value_t
nta_outgoing_branch
char const * nta_outgoing_branch(nta_outgoing_t const *orq)
Get the branch parameter.
Definition: nta.c:7587
nta_agent_set_params
int nta_agent_set_params(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Set NTA Parameters.
Definition: nta.c:1434
nta_incoming_getrequest
msg_t * nta_incoming_getrequest(nta_incoming_t *irq)
Get request message.
Definition: nta.c:5771
nta_leg_client_reroute
int nta_leg_client_reroute(nta_leg_t *leg, sip_record_route_t const *route, sip_contact_t const *contact, int initial)
Save target and route set at UAC side.
Definition: nta.c:4536
nta_incoming_cseq
uint32_t nta_incoming_cseq(nta_incoming_t const *irq)
Get sequence number of a server transaction.
Definition: nta.c:5848
nta_agent_newtag
char const * nta_agent_newtag(su_home_t *, char const *fmt, nta_agent_t *)
Calculate a new unique tag.
Definition: nta.c:1931
nta_msg_request_complete
int nta_msg_request_complete(msg_t *msg, nta_leg_t *leg, sip_method_t method, char const *method_name, url_string_t const *req_url)
Complete a request with values from dialog.
Definition: nta.c:3835
su_nanotime_t
su_time64_t su_nanotime_t
sip_call_id_s
NTA_TIME_MAX
@ NTA_TIME_MAX
Maximum value for timers.
Definition: nta.h:112
nta_incoming_magic_t
NTA_INCOMING_MAGIC_T nta_incoming_magic_t
Application context for incoming NTA requests.
Definition: nta.h:95
url_string_t
nta_reliable_t
struct nta_reliable_s nta_reliable_t
NTA reliable response.
Definition: nta.h:458
NTA_INCOMING_MAGIC_T
#define NTA_INCOMING_MAGIC_T
Default type of application context for incoming NTA requests.
Definition: nta.h:85
sip_allow_s
nta_version
char const nta_version[]
NTA module version.
Definition: nta.c:98
nta_tag.h
NTA tags.
nta_msg_is_internal
int nta_msg_is_internal(msg_t const *msg)
Check if the message is internally generated by NTA.
Definition: nta.c:3379
nta_incoming_url
url_t const * nta_incoming_url(nta_incoming_t const *irq)
Get Request-URI of a server transaction.
Definition: nta.c:5841
nta_incoming_complete_response
int nta_incoming_complete_response(nta_incoming_t *irq, msg_t *msg, int status, char const *phrase, tag_type_t tag, tag_value_t value,...)
Complete a response message.
Definition: nta.c:6357
NTA_LEG_MAGIC_T
#define NTA_LEG_MAGIC_T
Default type of application context for NTA call legs.
Definition: nta.h:73
nta_leg_tcreate
nta_leg_t * nta_leg_tcreate(nta_agent_t *agent, nta_request_f *req_callback, nta_leg_magic_t *magic, tag_type_t tag, tag_value_t value,...)
Create a new leg object.
Definition: nta.c:4089
su_root_t
struct su_root_t su_root_t
nta_outgoing_find
nta_outgoing_t * nta_outgoing_find(nta_agent_t const *sa, msg_t const *msg, sip_t const *sip, sip_via_t const *v)
Find an outgoing request corresponging to a message and Via line.
Definition: nta.c:9072
SOFIAPUBVAR
#define SOFIAPUBVAR
su_wait.h
nta_outgoing_default
nta_outgoing_t * nta_outgoing_default(nta_agent_t *agent, nta_response_f *callback, nta_outgoing_magic_t *magic)
Create a default outgoing transaction.
Definition: nta.c:7155
msg_s
nta_leg_by_dialog
nta_leg_t * nta_leg_by_dialog(nta_agent_t const *agent, url_t const *request_uri, sip_call_id_t const *call_id, char const *from_tag, url_t const *from_url, char const *to_tag, url_t const *to_url)
Get leg by dialog.
Definition: nta.c:4805
nta_message_f
int nta_message_f(nta_agent_magic_t *context, nta_agent_t *agent, msg_t *msg, sip_t *sip)
Callback for incoming messages.
Definition: nta.h:120
nta_incoming_getrequest_ackcancel
msg_t * nta_incoming_getrequest_ackcancel(nta_incoming_t *irq)
Get ACK or CANCEL message.
Definition: nta.c:5792
nta_outgoing_route_uri
url_t const * nta_outgoing_route_uri(nta_outgoing_t const *orq)
Return the URI used to route the request.
Definition: nta.c:7546
nta_agent_destroy
void nta_agent_destroy(nta_agent_t *agent)
Destroy an NTA agent object.
Definition: nta.c:1010
nta_leg_by_uri
nta_leg_t * nta_leg_by_uri(nta_agent_t const *, url_string_t const *)
Get leg by destination.
Definition: nta.c:4929
nta_leg_t
struct nta_leg_s nta_leg_t
NTA call leg.
Definition: nta.h:57
nta_response_f
int nta_response_f(nta_outgoing_magic_t *magic, nta_outgoing_t *request, sip_t const *sip)
Callback for replies to outgoing requests.
Definition: nta.h:366
SOFIAPUBFUN
#define SOFIAPUBFUN
nta_check_supported
int nta_check_supported(nta_incoming_t *irq, sip_t const *sip, sip_require_t *require, tag_type_t tag, tag_value_t value,...)
Check that UAC supports all the required features.
Definition: nta_check.c:124
nta_outgoing_mcreate
nta_outgoing_t * nta_outgoing_mcreate(nta_agent_t *agent, nta_response_f *callback, nta_outgoing_magic_t *magic, url_string_t const *route_url, msg_t *msg, tag_type_t tag, tag_value_t value,...)
Create an outgoing client transaction.
Definition: nta.c:7318
sip_time_t
msg_time_t sip_time_t
sip_rseq_s
nta_outgoing_bind
int nta_outgoing_bind(nta_outgoing_t *orq, nta_response_f *callback, nta_outgoing_magic_t *magic)
Bind callback and application context to a client transaction.
Definition: nta.c:7482
nta_leg_by_replaces
nta_leg_t * nta_leg_by_replaces(nta_agent_t *, sip_replaces_t const *)
Get dialog leg by Replaces header.
Definition: nta.c:4605
nta_outgoing_setrseq
int nta_outgoing_setrseq(nta_outgoing_t *orq, uint32_t rseq)
Set RSeq value stored with client transaction.
Definition: nta.c:11609
nta_agent_public_via
sip_via_t * nta_agent_public_via(nta_agent_t const *a)
Return a list of public (UPnP, STUN) Via headers.
Definition: nta.c:1136
NTA_SIP_T2
@ NTA_SIP_T2
SIP T2, 4 seconds.
Definition: nta.h:110
nta_sip_is_internal
int nta_sip_is_internal(sip_t const *sip)
Check if the headers are from response generated locally by NTA.
Definition: nta.c:3371
nta_outgoing_rseq
uint32_t nta_outgoing_rseq(nta_outgoing_t const *orq)
Get RSeq value stored with client transaction.
Definition: nta.c:11599
nta_incoming_create
nta_incoming_t * nta_incoming_create(nta_agent_t *agent, nta_leg_t *leg, msg_t *msg, sip_t *sip, tag_type_t tag, tag_value_t value,...)
Create a server transaction.
Definition: nta.c:5217
sip_route_s
nta_leg_magic
nta_leg_magic_t * nta_leg_magic(nta_leg_t const *leg, nta_request_f *callback)
Return application context for the leg.
Definition: nta.c:4378
nta_check_session_content
int nta_check_session_content(nta_incoming_t *irq, sip_t const *sip, sip_accept_t const *session_accepts, tag_type_t tag, tag_value_t value,...)
Check that we understand session content in the request.
Definition: nta_check.c:244
nta_outgoing_tagged
nta_outgoing_t * nta_outgoing_tagged(nta_outgoing_t *orq, nta_response_f *callback, nta_outgoing_magic_t *magic, char const *to_tag, sip_rseq_t const *rseq)
Create a tagged fork of outgoing request.
Definition: nta.c:11341
nta_outgoing_prack
nta_outgoing_t * nta_outgoing_prack(nta_leg_t *leg, nta_outgoing_t *oorq, nta_response_f *callback, nta_outgoing_magic_t *magic, url_string_t const *route_url, sip_t const *response_to_prack, tag_type_t, tag_value_t,...)
PRACK a provisional response.
Definition: nta.c:11454
sip.h
nta_reliable_treply
nta_reliable_t * nta_reliable_treply(nta_incoming_t *ireq, nta_prack_f *callback, nta_reliable_magic_t *rmagic, int status, char const *phrase, tag_type_t tag, tag_value_t value,...)
Respond reliably.
Definition: nta.c:10831
nta_leg_magic_t
NTA_LEG_MAGIC_T nta_leg_magic_t
Application context for NTA call legs.
Definition: nta.h:91
nta_check_accept
int nta_check_accept(nta_incoming_t *irq, sip_t const *sip, sip_accept_t const *acceptable, sip_accept_t const **return_acceptable, tag_type_t tag, tag_value_t value,...)
Check that UAC accepts one of listed MIME content-types.
Definition: nta_check.c:321
nta_incoming_magic
nta_incoming_magic_t * nta_incoming_magic(nta_incoming_t *irq, nta_ack_cancel_f *callback)
Get application context for a server transaction.
Definition: nta.c:5877
sip_contact_s
nta_incoming_find
nta_incoming_t * nta_incoming_find(nta_agent_t const *agent, sip_t const *sip, sip_via_t const *v)
Find incoming transaction.
Definition: nta.c:5905
nta_msg_complete
int nta_msg_complete(msg_t *msg)
Complete a message.
Definition: nta.c:3359
nta_leg_get_rtag
char const * nta_leg_get_rtag(nta_leg_t const *leg)
Get remote tag.
Definition: nta.c:4486
nta_outgoing_request_uri
url_t const * nta_outgoing_request_uri(nta_outgoing_t const *orq)
Return the request URI.
Definition: nta.c:7540
nta_leg_tag
char const * nta_leg_tag(nta_leg_t *leg, char const *tag)
Add local tag.
Definition: nta.c:4418
sip_via_s
nta_outgoing_cseq
uint32_t nta_outgoing_cseq(nta_outgoing_t const *orq)
Get sequence number of a client transaction.
Definition: nta.c:7565
sip_replaces_s
nta_agent_add_tport
int nta_agent_add_tport(nta_agent_t *agent, url_string_t const *url, tag_type_t tag, tag_value_t value,...)
Add a transport to the agent.
Definition: nta.c:2135
nta_tport_keepalive
int nta_tport_keepalive(nta_outgoing_t *orq)
Initiate STUN keepalive controller to TPORT.
Definition: nta.c:11801
NTA_SIP_T1
@ NTA_SIP_T1
SIP T1, 500 milliseconds.
Definition: nta.h:109
nta_leg_get_route
int nta_leg_get_route(nta_leg_t *leg, sip_route_t const **return_route, sip_contact_t const **return_target)
Get route.
Definition: nta.c:4560
NTA_SIP_T4
@ NTA_SIP_T4
SIP T4, 5 seconds.
Definition: nta.h:111
nta_outgoing_destroy
void nta_outgoing_destroy(nta_outgoing_t *)
Destroy a request object.
Definition: nta.c:7525
nta_outgoing_status
int nta_outgoing_status(nta_outgoing_t const *orq)
Get the status code of a client transaction.
Definition: nta.c:7574
nta_reliable_magic_t
NTA_RELIABLE_MAGIC_T nta_reliable_magic_t
Application context for reliable preliminary responses.
Definition: nta.h:468
nta_incoming_default
nta_incoming_t * nta_incoming_default(nta_agent_t *agent)
Create a default server transaction.
Definition: nta.c:5163
nta_request_f
int nta_request_f(nta_leg_magic_t *lmagic, nta_leg_t *leg, nta_incoming_t *irq, sip_t const *sip)
Callback for incoming requests.
Definition: nta.h:179
nta_agent_contact
sip_contact_t * nta_agent_contact(nta_agent_t const *a)
Return Contact header.
Definition: nta.c:1110
NTA_OUTGOING_MAGIC_T
#define NTA_OUTGOING_MAGIC_T
Default type of application context for outgoing NTA requests.
Definition: nta.h:79
nta_agent_magic_t
NTA_AGENT_MAGIC_T nta_agent_magic_t
Application context for NTA agents.
Definition: nta.h:89
nta_incoming_bind
void nta_incoming_bind(nta_incoming_t *irq, nta_ack_cancel_f *callback, nta_incoming_magic_t *imagic)
Bind a callback and context to an incoming transaction object.
Definition: nta.c:5716
nta_reliable_destroy
void nta_reliable_destroy(nta_reliable_t *)
Destroy a reliable response.
Definition: nta.c:11241

Sofia-SIP 1.12.11devel - Copyright (C) 2006 Nokia Corporation. All rights reserved. Licensed under the terms of the GNU Lesser General Public License.