NDDS_Transport_WAN_Property_t Struct Reference

WAN transport plugin property. More...

Data Fields
struct NDDS_Transport_UDPv4_Property_t	parent
	UDPv4 transport plugin property.
RTI_INT32	enable_security
	Set to 1 to enable secure transport using DTLS.
RTI_INT32	recv_decode_buffer_size
	Size of buffer for decoding packets from wire when security-enabled.
RTI_INT32	port_offset
	Port offset to allow coexistence with non-WAN UDP transport.
RTI_UINT32	dtls_handshake_resend_interval
	DTLS handshake retransmission interval in milliseconds.
RTI_UINT32	dtls_connection_liveliness_interval
	Liveliness interval (multiple of resend interval)
struct NDDS_Transport_TLS_OpenSSL_Configuration	tls
	OpenSSL TLS parameters.
unsigned char	transport_instance_id [NDDS_TRANSPORT_WAN_TRANSPORT_INSTANCE_ID_LENGTH]
	The WAN ID.
char *	interface_address
	Interface IP address for the transport sockets.
char *	server
	WAN Rendezvous Server address.
NDDS_Transport_Port_t	server_port
	WAN Rendezvous Server port.
RTI_UINT32	stun_retransmission_interval
	STUN Retransmission interval in millisecs.
RTI_UINT32	stun_number_of_retransmissions
	STUN Retransmission count.
RTI_UINT32	stun_liveliness_period
	STUN Liveliness period in millisecs.

Detailed Description

WAN transport plugin property.

Should be initialized with NDDS_Transport_WAN_Plugin::NDDS_TRANSPORT_WAN_PROPERTY_DEFAULT

Field Documentation

struct NDDS_Transport_UDPv4_Property_t NDDS_Transport_WAN_Property_t::parent

UDPv4 transport plugin property.

[default] Refer to NDDS_Transport_WAN_Plugin::NDDS_TRANSPORT_WAN_PROPERTY_DEFAULT

RTI_INT32 NDDS_Transport_WAN_Property_t::enable_security

Set to 1 to enable secure transport using DTLS.

If enabled, there must be valid OpenSSL properties in NDDS_Transport_WAN_Property_t::tls

[default] 0 (off)

RTI_INT32 NDDS_Transport_WAN_Property_t::recv_decode_buffer_size

Size of buffer for decoding packets from wire when security-enabled.

An extra buffer is required for storage of encrypted data

[default] NDDS_Transport_WAN_Plugin::NDDS_TRANSPORT_WAN_DTLS_FRAGMENT_SIZE_MAX_DEFAULT

RTI_INT32 NDDS_Transport_WAN_Property_t::port_offset

Port offset to allow coexistence with non-WAN UDP transport.

[default] 144

RTI_UINT32 NDDS_Transport_WAN_Property_t::dtls_handshake_resend_interval

DTLS handshake retransmission interval in milliseconds.

[default] 1000 (1 sec)

RTI_UINT32 NDDS_Transport_WAN_Property_t::dtls_connection_liveliness_interval

Liveliness interval (multiple of resend interval)

The connection will be dropped if no message from the peer is received in this amount of time. This enables cleaning up state for peers that are no longer responding. A secure keep-alive message will be sent every half-interval if no other sends have occurred for a given DTLS connection during that time.

[default] 60

struct NDDS_Transport_TLS_OpenSSL_Configuration NDDS_Transport_WAN_Property_t::tls

OpenSSL TLS parameters.

[default] NDDS_Transport_TLS_Plugin::NDDS_TRANSPORT_TLS_OPENSSL_CONFIGURATION_DEFAULT

unsigned char NDDS_Transport_WAN_Property_t::transport_instance_id[NDDS_TRANSPORT_WAN_TRANSPORT_INSTANCE_ID_LENGTH]

The WAN ID.

This value must be unique for all transport instances communicating with the same WAN Rendezvous Server.

[default] {0,0,0,0,0,0,0,0,0,0,0,0}

[range] {0,0,0,0,0,0,0,0,0,0,0,0} to {0xfe,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff}

char* NDDS_Transport_WAN_Property_t::interface_address

Interface IP address for the transport sockets.

The WAN transport can be configured to bind all sockets to a specified interface. This is required for consistent WAN communication on multi-homed systems.

If the value is NULL, the sockets will be bound to the special IP address INADDR_ANY. This address allows the sockets to receive packets destined to any of the interfaces.

[default] NULL

char* NDDS_Transport_WAN_Property_t::server

WAN Rendezvous Server address.

[default] NULL

NDDS_Transport_Port_t NDDS_Transport_WAN_Property_t::server_port

WAN Rendezvous Server port.

[default] 3478

RTI_UINT32 NDDS_Transport_WAN_Property_t::stun_retransmission_interval

STUN Retransmission interval in millisecs.

STUN request messages requiring a response are re-sent with this interval. The interval is doubled after each retransmission.

[default] 100

RTI_UINT32 NDDS_Transport_WAN_Property_t::stun_number_of_retransmissions

STUN Retransmission count.

STUN messages are resent up to this number of times until a response is received

[default] 7

RTI_UINT32 NDDS_Transport_WAN_Property_t::stun_liveliness_period

STUN Liveliness period in millisecs.

This is the period at which messages are sent to peers to keep NAT holes open; and to the WAN server to refresh bound ports

[default] 15000