49#include <sofia-sip/url.h>
59#define TPORT_T struct tport_s
60typedef TPORT_T tport_t;
65#define TP_STACK_T struct tp_stack_s
67#define TP_STACK_T TP_AGENT_T
75#define TP_MAGIC_T struct tp_magic_s
81#define TP_CLIENT_T struct tp_client_s
89struct sigcomp_compartment;
102 int errcode,
char const *remote);
106 char const [], usize_t,
119 tport_t *,
msg_t *msg,
int error);
130#define TP_AI_COMPRESSED 0x01000
132#define TP_AI_SECURE 0x02000
135#define TP_AI_SHUTDOWN 0x04000
137#define TP_AI_CLOSE 0x08000
140#define TP_AI_ANY 0x80000
142#define TP_AI_MASK 0xff000
145#define TPORT_HOSTPORTSIZE (55)
165#define TPN_FORMAT "%s/%s:%s%s%s%s%s"
168 (n)->tpn_proto, (n)->tpn_host, (n)->tpn_port, \
169 (n)->tpn_comp ? ";comp=" : "", (n)->tpn_comp ? (n)->tpn_comp : "", \
170 (n)->tpn_ident ? "/" : "", (n)->tpn_ident ? (n)->tpn_ident : ""
181 char const *
const transports[],
197TPORT_DLL tport_t *
tport_ref(tport_t *tp);
304TPORT_DLL
char const *
tport_ident(tport_t
const *self);
316TPORT_DLL tport_t *
tport_next(tport_t
const *tport);
332 url_string_t
const *us);
358 char const *protoname,
360 su_sockaddr_t
const *su);
364 su_sockaddr_t
const *su,
int with_port);
373#ifndef TPORT_COMPRESSOR
374#define TPORT_COMPRESSOR struct tport_compressor
377typedef TPORT_COMPRESSOR tport_compressor_t;
388 struct sigcomp_compartment *cc,
392TPORT_DLL
struct sigcomp_compartment *
394 char const *name, isize_t namelen,
395 int create_if_needed);
407 struct sigcomp_compartment *cc,
413 tport_compressor_t **return_compressor);
418 struct sigcomp_compartment *cc,
424 struct sigcomp_compartment *,
425 unsigned lifetime_in_ms,
Transport name.
Definition tport.h:156
char const * tpn_comp
Compression algorithm (NULL if none)
Definition tport.h:161
char const * tpn_host
Node address in textual format.
Definition tport.h:159
char const * tpn_ident
Transport identifier (NULL if none)
Definition tport.h:162
char const * tpn_canon
Node DNS name (if known).
Definition tport.h:158
char const * tpn_proto
Protocol name ("udp", "tcp", etc.)
Definition tport.h:157
char const * tpn_port
Port number in textual format.
Definition tport.h:160
Interface towards stack.
Definition tport.h:93
struct addrinfo su_addrinfo_t
struct tag_type_s const * tag_type_t
struct su_root_t su_root_t
TPORT_DLL int tport_is_connected(tport_t const *self)
Test if transport is connected.
Definition tport.c:321
@ TPORT_QUEUESIZE
Maximum number of messages in send queue.
Definition tport.h:123
TPORT_DLL int tport_sigcomp_accept(tport_t *self, struct sigcomp_compartment *cc, msg_t *msg)
Accept SigComp message.
Definition tport_sigcomp.c:761
TPORT_DLL int tport_sigcomp_lifetime(tport_t *self, struct sigcomp_compartment *, unsigned lifetime_in_ms, int only_expand)
Set SigComp compartment lifetime.
TPORT_DLL tp_magic_t * tport_magic(tport_t const *tport)
Get transport magic.
Definition tport.c:4388
TPORT_DLL int tport_tqsend(tport_t *, msg_t *, msg_t *, tag_type_t, tag_value_t,...)
Send a queued message (and queue another, if required).
Definition tport.c:3876
TPORT_DLL tport_t * tport_tsend(tport_t *, msg_t *, tp_name_t const *, tag_type_t, tag_value_t,...)
Send a message using transport.
Definition tport.c:3298
TPORT_DLL int tport_stall(tport_t *self)
Stop reading from socket until tport_continue() is called.
Definition tport.c:2872
TPORT_DLL int tport_name_by_url(su_home_t *, tp_name_t *, url_string_t const *us)
Create a transport name corresponding to the URL.
Definition tport.c:4747
TPORT_DLL int tport_continue(tport_t *self)
Continue reading from socket.
Definition tport.c:2878
TPORT_DLL struct sigcomp_compartment * tport_sigcomp_compartment(tport_t *self, char const *name, isize_t namelen, int create_if_needed)
Obtain a SigComp compartment with given name.
TPORT_DLL int tport_is_shutdown(tport_t const *self)
Test if transport has been shut down.
Definition tport.c:309
TPORT_DLL char const * tport_ident(tport_t const *self)
Get transport ident.
Definition tport.c:4452
TPORT_DLL int tport_tbind(tport_t *self, tp_name_t const *tpn, char const *const transports[], tag_type_t tag, tag_value_t value,...)
Bind transports to network.
Definition tport.c:1540
TPORT_DLL tport_t * tport_primaries(tport_t const *tport)
Get primary transports.
Definition tport.c:4400
void tport_pending_error_f(tp_stack_t *, tp_client_t *, tport_t *, msg_t *msg, int error)
Callback to report error by pending requests.
Definition tport.h:118
TPORT_DLL int tport_is_closed(tport_t const *self)
Test if transport has been closed.
Definition tport.c:300
TPORT_DLL int tport_release(tport_t *self, int pendd, msg_t *msg, msg_t *reply, tp_client_t *client, int still_pending)
Do not wait for response anymore.
Definition tport.c:4257
TPORT_DLL tport_t * tport_incref(tport_t *tp)
Create a new transport reference.
Definition tport.c:1227
TPORT_DLL int tport_shutdown(tport_t *tport, int how)
Shutdown a transport connection.
Definition tport.c:2194
TPORT_DLL int tport_has_compression(tport_t const *self, char const *comp)
Check if transport supports named compression.
Definition tport_stub_sigcomp.c:140
TPORT_DLL int tport_keepalive(tport_t *tp, su_addrinfo_t const *ai, tag_type_t tag, tag_value_t value,...)
Initialize STUN keepalives.
Definition tport_stub_stun.c:253
#define TP_MAGIC_T
Type of transport-protocol-specific context.
Definition tport.h:75
TPORT_DLL int tport_is_tcp(tport_t const *self)
Test if transport is tcp.
Definition tport.c:221
TPORT_DLL tport_t * tport_delivered_by(tport_t const *tp, msg_t const *msg)
Return source transport object for delivered message.
Definition tport.c:3112
TPORT_DLL int tport_has_ip6(tport_t const *tport)
Return true if transport supports IPv6.
TP_STACK_T tp_stack_t
Type of stack object.
Definition tport.h:71
TPORT_DLL tport_t * tport_parent(tport_t const *self)
Get primary transport (or self, if already parent)
Definition tport.c:4394
TPORT_DLL int tport_delivered_with_comp(tport_t *tp, msg_t const *msg, tport_compressor_t **return_compressor)
Get compressor context with which the request was delivered.
Definition tport.c:3150
TPORT_DLL int tport_sigcomp_option(tport_t const *self, struct sigcomp_compartment *cc, char const *option)
Set SigComp option.
Definition tport_stub_sigcomp.c:159
TPORT_DLL int tport_can_recv_sigcomp(tport_t const *self)
Check if transport can receive compressed messages.
Definition tport_stub_sigcomp.c:118
TPORT_DLL int tport_name_dup(su_home_t *, tp_name_t *dst, tp_name_t const *src)
Duplicate a transport name.
Definition tport.c:4812
TPORT_DLL int tport_pend(tport_t *self, msg_t *msg, tport_pending_error_f *callback, tp_client_t *client)
Mark message as waiting for a response.
Definition tport.c:4204
TPORT_DLL isize_t tport_queuelen(tport_t const *self)
Return number of queued messages.
Definition tport.c:3820
TPORT_DLL su_addrinfo_t const * tport_get_address(tport_t const *tport)
Get transport address list.
Definition tport.c:4440
TPORT_DLL int tport_is_clear_to_send(tport_t const *self)
Test if transport can be used to send message.
Definition tport.c:327
TPORT_DLL int tport_convert_addr(su_home_t *home, tp_name_t *tpn, char const *protoname, char const *canon, su_sockaddr_t const *su)
Convert a socket address to a transport name.
Definition tport.c:2402
TPORT_DLL void tport_decref(tport_t **tp)
Destroy a transport reference.
Definition tport.c:1233
TPORT_DLL tport_t * tport_by_protocol(tport_t const *self, char const *proto)
Get a protocol corresponding to the protocol name.
Definition tport.c:4458
TPORT_DLL void tport_destroy(tport_t *tport)
Destroy a master transport.
Definition tport.c:556
TP_MAGIC_T tp_magic_t
Type of transport-protocol-specific context object.
Definition tport.h:78
TPORT_DLL int tport_can_send_sigcomp(tport_t const *self)
Check if transport can send compressed messages.
Definition tport_stub_sigcomp.c:129
TPORT_DLL int tport_set_compression(tport_t *self, char const *comp)
Set the compression protocol as comp.
Definition tport_stub_sigcomp.c:148
TPORT_DLL int tport_has_ip4(tport_t const *tport)
Return true if transport supports IPv4.
Definition tport.c:249
TPORT_DLL int tport_has_sigcomp_assigned(tport_t const *self)
Test if a SigComp compartment is assigned to a tport.
Definition tport_stub_sigcomp.c:214
TPORT_DLL void tport_unref(tport_t *tp)
Destroy reference to a transport object.
Definition tport.c:1215
TPORT_DLL int tport_sigcomp_assign(tport_t *self, struct sigcomp_compartment *)
Assign a SigComp compartment to a connection-oriented tport.
Definition tport_sigcomp.c:194
TP_CLIENT_T tp_client_t
Transaction object given as a reference to the transport.
Definition tport.h:87
TPORT_DLL int tport_delivered_from(tport_t *tp, msg_t const *msg, tp_name_t name[1])
Return source transport name for delivered message.
Definition tport.c:3122
TPORT_DLL int tport_is_stream(tport_t const *tport)
Return true if transport is a stream (no message boundaries).
Definition tport.c:203
TPORT_DLL int tport_get_params(tport_t const *, tag_type_t tag, tag_value_t value,...)
Get transport parameters.
Definition tport.c:1256
TPORT_DLL int tport_is_verified(tport_t const *tport)
Test if transport provided a verified certificate chain (TLS only)
Definition tport.c:274
TPORT_DLL int tport_is_reliable(tport_t const *tport)
Return true if transport is reliable, false otherwise.
Definition tport.c:230
TPORT_DLL int tport_is_primary(tport_t const *self)
Return true if transport is primary.
Definition tport.c:180
TPORT_DLL int tport_is_master(tport_t const *self)
Return true if transport is master.
Definition tport.c:172
TPORT_DLL int tport_set_params(tport_t *self, tag_type_t tag, tag_value_t value,...)
Set transport parameters.
Definition tport.c:1319
TPORT_DLL char * tport_hostport(char buf[], isize_t bufsize, su_sockaddr_t const *su, int with_port)
Print host and port separated with ':' to a string.
Definition tport.c:4866
TPORT_DLL int tport_has_tls(tport_t const *tport)
Test if transport has TLS.
Definition tport.c:268
TPORT_DLL int tport_is_updating(tport_t const *self)
Return true if transport is being updated.
Definition tport.c:280
TPORT_DLL int tport_tqueue(tport_t *, msg_t *, tag_type_t, tag_value_t,...)
Queue a message to transport.
Definition tport.c:3811
TPORT_DLL int tport_subject_search(char const *, su_strlst_t const *)
Check if the given subject string is found in su_strlst_t.
Definition tport.c:3164
TPORT_DLL int tport_is_secondary(tport_t const *self)
Return true if transport is secondary.
Definition tport.c:188
TPORT_DLL int tport_flush(tport_t *)
Flush idle connections.
Definition tport.c:2367
TPORT_DLL tport_t * tport_primary_by_name(tport_t const *self, tp_name_t const *tpn)
Get transport by interface identifier and protocol name.
Definition tport.c:4470
TPORT_DLL tport_t * tport_secondary(tport_t const *tport)
Get secondary transports.
Definition tport.c:4423
TPORT_DLL tp_name_t const * tport_name(tport_t const *tport)
Get transport name.
Definition tport.c:4446
TPORT_DLL tport_t * tport_tcreate(tp_stack_t *stack, tport_stack_class_t const *tpac, su_root_t *root, tag_type_t tag, tag_value_t value,...)
Create master transport.
Definition tport.c:494
TPORT_DLL su_strlst_t const * tport_delivered_from_subjects(tport_t *tp, msg_t const *msg)
Return TLS Subjects provided by the source transport.
Definition tport.c:3138
TPORT_DLL void tport_set_magic(tport_t *self, tp_magic_t *magic)
Set transport magic.
Definition tport.c:4382
TPORT_DLL int tport_is_dgram(tport_t const *tport)
Return true if transport is dgram-based.
Definition tport.c:209
TPORT_DLL int tport_is_udp(tport_t const *self)
Test if transport is udp.
Definition tport.c:215
TPORT_DLL int tport_sigcomp_close(tport_t *self, struct sigcomp_compartment *cc, int how)
Shutdown SigComp compartment.
TPORT_DLL tport_t * tport_ref(tport_t *tp)
Create a new reference to a transport object.
Definition tport.c:1198
TPORT_DLL tport_t * tport_by_name(tport_t const *self, tp_name_t const *)
Get a transport corresponding to the name.
Definition tport.c:4536
TPORT_DLL int tport_is_public(tport_t const *self)
Return nonzero if transport is public.
Definition tport.c:243
TPORT_DLL int tport_name_is_resolved(tp_name_t const *)
Check if transport named is already resolved.
Definition tport.c:4792
TPORT_DLL tport_t * tport_next(tport_t const *tport)
Get next transport.
Definition tport.c:4409