63#ifndef NTA_AGENT_MAGIC_T
67#define NTA_AGENT_MAGIC_T struct nta_agent_magic_s
69#ifndef NTA_LEG_MAGIC_T
73#define NTA_LEG_MAGIC_T struct nta_leg_magic_s
75#ifndef NTA_OUTGOING_MAGIC_T
79#define NTA_OUTGOING_MAGIC_T struct nta_outgoing_magic_s
81#ifndef NTA_INCOMING_MAGIC_T
85#define NTA_INCOMING_MAGIC_T struct nta_incoming_magic_s
102#define NTA_VERSION "2.0"
170 char const *method_name,
220 sip_record_route_t
const *route,
221 sip_contact_t
const *contact);
224 sip_record_route_t
const *route,
225 sip_contact_t
const *contact,
229 sip_record_route_t
const *route,
230 sip_contact_t
const *contact);
234 sip_route_t
const **return_route,
235 sip_contact_t
const **return_target);
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,
249 url_t const *to_url);
322 int status,
char const *phrase,
334 sip_supported_t
const *supported,
339 sip_require_t *require,
344 sip_allow_t
const *allow,
348 sip_accept_t
const *session_accepts,
353 sip_accept_t
const *acceptable,
354 sip_accept_t
const **return_acceptable,
376 char const *method_name,
417 sip_rseq_t
const *rseq);
449 sip_t const *response_to_prack,
460#ifndef NTA_RELIABLE_MAGIC_T
464#define NTA_RELIABLE_MAGIC_T struct nta_reliable_magic_s
477 nta_prack_f *callback,
479 int status,
char const *phrase,
485 nta_prack_f *callback,
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())
char const * nta_incoming_method_name(nta_incoming_t const *irq)
Get method name of a server transaction.
Definition nta.c:5830
@ NTA_SIP_T1
SIP T1, 500 milliseconds.
Definition nta.h:109
@ NTA_SIP_T4
SIP T4, 5 seconds.
Definition nta.h:111
@ NTA_SIP_T2
SIP T2, 4 seconds.
Definition nta.h:110
@ NTA_TIME_MAX
Maximum value for timers.
Definition nta.h:112
int nta_sip_is_internal(sip_t const *sip)
Check if the headers are from response generated locally by NTA.
Definition nta.c:3371
int nta_outgoing_status(nta_outgoing_t const *orq)
Get the status code of a client transaction.
Definition nta.c:7574
char const * nta_leg_tag(nta_leg_t *leg, char const *tag)
Add local tag.
Definition nta.c:4418
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_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
int nta_agent_get_stats(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Get NTA statistics.
Definition nta.c:1873
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
void nta_agent_destroy(nta_agent_t *agent)
Destroy an NTA agent object.
Definition nta.c:1010
nta_agent_magic_t * nta_agent_magic(nta_agent_t const *a)
Return agent context.
Definition nta.c:1085
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
uint32_t nta_leg_get_rseq(nta_leg_t const *leg)
Get remote request sequence number.
Definition nta.c:4501
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_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_AGENT_MAGIC_T nta_agent_magic_t
Application context for NTA agents.
Definition nta.h:89
struct nta_reliable_s nta_reliable_t
NTA reliable response.
Definition nta.h:458
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
char const * nta_outgoing_method_name(nta_outgoing_t const *orq)
Return method name of the client transaction.
Definition nta.c:7558
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
NTA_INCOMING_MAGIC_T nta_incoming_magic_t
Application context for incoming NTA requests.
Definition nta.h:95
NTA_RELIABLE_MAGIC_T nta_reliable_magic_t
Application context for reliable preliminary responses.
Definition nta.h:468
#define NTA_AGENT_MAGIC_T
Default type of application context for NTA agents.
Definition nta.h:67
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
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
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
struct nta_leg_s nta_leg_t
NTA call leg.
Definition nta.h:57
char const nta_version[]
NTA module version.
Definition nta.c:98
int nta_is_internal_msg(msg_t const *msg)
Check if the message is internally generated by NTA.
Definition nta.c:3388
void nta_incoming_destroy(nta_incoming_t *irq)
Destroy an incoming transaction.
Definition nta.c:5444
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
struct nta_incoming_s nta_incoming_t
NTA incoming request.
Definition nta.h:61
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
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
msg_t * nta_incoming_getresponse(nta_incoming_t *irq)
Get response message.
Definition nta.c:5813
NTA_LEG_MAGIC_T nta_leg_magic_t
Application context for NTA call legs.
Definition nta.h:91
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
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_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
nta_incoming_t * nta_incoming_default(nta_agent_t *agent)
Create a default server transaction.
Definition nta.c:5163
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
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
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
int nta_agent_get_params(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Get NTA Parameters.
Definition nta.c:1764
msg_t * nta_msg_create(nta_agent_t *self, int flags)
Create a new message belonging to the agent.
Definition nta.c:3328
int nta_outgoing_setrseq(nta_outgoing_t *orq, uint32_t rseq)
Set RSeq value stored with client transaction.
Definition nta.c:11609
msg_t * nta_outgoing_getresponse(nta_outgoing_t *orq)
Get reference to response message.
Definition nta.c:7606
int nta_msg_is_internal(msg_t const *msg)
Check if the message is internally generated by NTA.
Definition nta.c:3379
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
msg_t * nta_outgoing_getrequest(nta_outgoing_t *orq)
Get request message.
Definition nta.c:7623
int nta_tport_keepalive(nta_outgoing_t *orq)
Initiate STUN keepalive controller to TPORT.
Definition nta.c:11801
nta_leg_t * nta_leg_by_uri(nta_agent_t const *, url_string_t const *)
Get leg by destination.
Definition nta.c:4929
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
int nta_incoming_status(nta_incoming_t const *irq)
Get status code of a server transaction.
Definition nta.c:5862
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_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_leg_t * nta_leg_by_replaces(nta_agent_t *, sip_replaces_t const *)
Get dialog leg by Replaces header.
Definition nta.c:4605
int nta_outgoing_cancel(nta_outgoing_t *)
Cancel the request.
Definition nta.c:7347
unsigned nta_outgoing_delay(nta_outgoing_t const *orq)
Get the RTT delay measured using Timestamp header.
Definition nta.c:7581
sip_via_t * nta_agent_via(nta_agent_t const *a)
Return a list of Via headers.
Definition nta.c:1123
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
int nta_agent_close_tports(nta_agent_t *agent)
Close all transports.
Definition nta.c:11814
uint32_t nta_incoming_cseq(nta_incoming_t const *irq)
Get sequence number of a server transaction.
Definition nta.c:5848
msg_t * nta_incoming_getrequest_ackcancel(nta_incoming_t *irq)
Get ACK or CANCEL message.
Definition nta.c:5792
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
char const * nta_leg_rtag(nta_leg_t *leg, char const *tag)
Add remote tag.
Definition nta.c:4471
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
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_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
void nta_reliable_destroy(nta_reliable_t *)
Destroy a reliable response.
Definition nta.c:11241
uint32_t nta_outgoing_cseq(nta_outgoing_t const *orq)
Get sequence number of a client transaction.
Definition nta.c:7565
#define NTA_OUTGOING_MAGIC_T
Default type of application context for outgoing NTA requests.
Definition nta.h:79
struct nta_agent_s nta_agent_t
NTA agent.
Definition nta.h:55
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
msg_t * nta_incoming_getrequest(nta_incoming_t *irq)
Get request message.
Definition nta.c:5771
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
url_t const * nta_outgoing_request_uri(nta_outgoing_t const *orq)
Return the request URI.
Definition nta.c:7540
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
url_t const * nta_outgoing_route_uri(nta_outgoing_t const *orq)
Return the URI used to route the request.
Definition nta.c:7546
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_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
char const * nta_leg_get_rtag(nta_leg_t const *leg)
Get remote tag.
Definition nta.c:4486
uint32_t nta_leg_get_seq(nta_leg_t const *leg)
Get local request sequence number.
Definition nta.c:4495
char const * nta_leg_get_tag(nta_leg_t const *leg)
Get local tag.
Definition nta.c:4453
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
char const * nta_incoming_gettag(nta_incoming_t const *irq)
Get local tag for incoming request.
Definition nta.c:5854
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
char const * nta_agent_newtag(su_home_t *, char const *fmt, nta_agent_t *)
Calculate a new unique tag.
Definition nta.c:1931
url_t const * nta_incoming_url(nta_incoming_t const *irq)
Get Request-URI of a server transaction.
Definition nta.c:5841
struct nta_outgoing_s nta_outgoing_t
NTA outgoing request.
Definition nta.h:59
#define NTA_RELIABLE_MAGIC_T
Default type of application context for reliable preliminary responses.
Definition nta.h:464
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
int nta_agent_set_params(nta_agent_t *agent, tag_type_t tag, tag_value_t value,...)
Set NTA Parameters.
Definition nta.c:1434
sip_time_t nta_incoming_received(nta_incoming_t *irq, su_nanotime_t *nano)
When received.
Definition nta.c:5890
sip_contact_t * nta_agent_contact(nta_agent_t const *a)
Return Contact header.
Definition nta.c:1110
char const * nta_agent_version(nta_agent_t const *a)
Return User-Agent header.
Definition nta.c:1180
nta_leg_t * nta_default_leg(nta_agent_t const *agent)
Return the default leg, if any.
Definition nta.c:4304
uint32_t nta_outgoing_rseq(nta_outgoing_t const *orq)
Get RSeq value stored with client transaction.
Definition nta.c:11599
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
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
#define NTA_INCOMING_MAGIC_T
Default type of application context for incoming NTA requests.
Definition nta.h:85
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
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
char const * nta_outgoing_branch(nta_outgoing_t const *orq)
Get the branch parameter.
Definition nta.c:7587
#define NTA_LEG_MAGIC_T
Default type of application context for NTA call legs.
Definition nta.h:73
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
sip_method_t nta_outgoing_method(nta_outgoing_t const *orq)
Return method of the client transaction.
Definition nta.c:7552
int nta_incoming_mreply(nta_incoming_t *irq, msg_t *msg)
Return a response message to client.
Definition nta.c:6498
sip_method_t nta_incoming_method(nta_incoming_t const *irq)
Get method of a server transaction.
Definition nta.c:5824
void nta_msg_discard(nta_agent_t *agent, msg_t *msg)
Discard a message.
Definition nta.c:3365
int nta_msg_complete(msg_t *msg)
Complete a message.
Definition nta.c:3359
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
void nta_leg_destroy(nta_leg_t *leg)
Destroy a leg.
Definition nta.c:4341
NTA_OUTGOING_MAGIC_T nta_outgoing_magic_t
Application context for outgoing NTA requests.
Definition nta.h:93
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
void nta_outgoing_destroy(nta_outgoing_t *)
Destroy a request object.
Definition nta.c:7525
struct tag_type_s const * tag_type_t
su_time64_t su_nanotime_t
struct su_root_t su_root_t