UDP_InterfaceFactoryProperty Struct Reference

<<eXtension>> <<cert>> Properties for the UDP Transport. More...

#include <netio_udp.h>

Data Fields
struct REDA_StringSeq	allow_interface
	Sequence of allowed interface names.
struct REDA_StringSeq	deny_interface
	Sequence of denied interface names. This list is checked after the allow_interface list.
RTI_INT32	max_send_buffer_size
	The size of the send socket buffer.
RTI_INT32	max_receive_buffer_size
	The size of the receive socket buffer.
RTI_INT32	max_message_size
	The maximum size of the message which can be sent or received.
RTI_INT32	max_send_message_size
	The maximum size of the message which can be sent. This is only a hint and not enforced.
RTI_INT32	multicast_ttl
	The maximum TTL.
struct UDP_NatEntrySeq	nat
	Configure network address translation (NAT).
struct UDP_InterfaceTableEntrySeq	if_table
	The interface table if interfaces are added manually.
REDA_String_T	multicast_interface
	The network interface to use to send to multicast.
RTI_BOOL	is_default_interface
	If this should be considered the default UDP interface if no other UDP interface is found to handle a route.
RTI_BOOL	disable_auto_interface_config
	Disable reading of available network interfaces using system information and instead rely on the manually configured interface table.
RTI_BOOL	multicast_loopback_disabled
	Prevents the transport plugin from putting multicast packets onto the loopback interface.
struct OSAPI_ThreadProperty	recv_thread
	Thread properties for each receive thread created by this NETIO interface.
RTI_BOOL	enable_interface_bind
	Bind receive sockets to specific interfaces.
RTI_BOOL	disable_multicast_bind
	Disable a multicast receive socket binding to a multicast address.
RTI_BOOL	disable_multicast_interface_select
	Do not select outgoing interfaces when sending to multicast groups.
struct UDP_TransformRuleSeq	source_rules
	Rules for how to transform received UDP payloads based on the source address.
struct UDP_TransformRuleSeq	destination_rules
	Rules for how to transform sent UDP payloads based on the destination address.
UDP_TransformUdpMode_T	transform_udp_mode
	Determines how regular UDP is supported when transformations are supported.
RTI_INT32	transform_locator_kind
	The locator to use for locators that have transformations.

---

Detailed Description

<<eXtension>> <<cert>> Properties for the UDP Transport.

---

Field Documentation

struct REDA_StringSeq UDP_InterfaceFactoryProperty::allow_interface

Sequence of allowed interface names.

struct REDA_StringSeq UDP_InterfaceFactoryProperty::deny_interface

Sequence of denied interface names. This list is checked after the allow_interface list.

RTI_INT32 UDP_InterfaceFactoryProperty::max_send_buffer_size

The size of the send socket buffer.

RTI_INT32 UDP_InterfaceFactoryProperty::max_receive_buffer_size

The size of the receive socket buffer.

RTI_INT32 UDP_InterfaceFactoryProperty::max_message_size

The maximum size of the message which can be sent or received.

RTI_INT32 UDP_InterfaceFactoryProperty::max_send_message_size

The maximum size of the message which can be sent. This is only a hint and not enforced.

This parameters is useful to UDP transformation functions which must allocate a buffer to put the result in.

RTI_INT32 UDP_InterfaceFactoryProperty::multicast_ttl

The maximum TTL.

struct UDP_NatEntrySeq UDP_InterfaceFactoryProperty::nat

Configure network address translation (NAT).

Configure network address translation (NAT). This feature only supports translation between a private and public IP address; UDP ports are not translated. Does not support any hole punching technique or WAN server, thus is only useful when the private and public address mapping is static. Please refer to UDP_NatEntrySeq for the definition of the sequence element.

struct UDP_InterfaceTableEntrySeq UDP_InterfaceFactoryProperty::if_table

The interface table if interfaces are added manually.

REDA_String_T UDP_InterfaceFactoryProperty::multicast_interface

The network interface to use to send to multicast.

RTI_BOOL UDP_InterfaceFactoryProperty::is_default_interface

If this should be considered the default UDP interface if no other UDP interface is found to handle a route.

RTI_BOOL UDP_InterfaceFactoryProperty::disable_auto_interface_config

Disable reading of available network interfaces using system information and instead rely on the manually configured interface table.

RTI_BOOL UDP_InterfaceFactoryProperty::multicast_loopback_disabled

Prevents the transport plugin from putting multicast packets onto the loopback interface.

If multicast loopback is disabled (this value is set to 1), then when sending multicast packets, RTI Connext DDS Micro will not put a copy of the packets on the loopback interface. This prevents applications on the same node (including itself) from receiving those packets.

This value is set to 0 by default, meaning multicast loopback is enabled.

Disabling multicast loopback (setting this value to 1) may result in minor performance gains when using multicast.

struct OSAPI_ThreadProperty UDP_InterfaceFactoryProperty::recv_thread

Thread properties for each receive thread created by this NETIO interface.

RTI_BOOL UDP_InterfaceFactoryProperty::enable_interface_bind

Bind receive sockets to specific interfaces.

When this is set to 1, the UDP transport binds each receive port to a specific interface when the allow_interface/deny_interface lists are non-empty. This allows multiple UDP transports to be used by a single DomainParticipant at the expense of an increased number of threads. This property is ignored when transformations are enabled and the allow_interface/deny_interface lists are non-empty.

The default value is 0.

RTI_BOOL UDP_InterfaceFactoryProperty::disable_multicast_bind

Disable a multicast receive socket binding to a multicast address.

NOTE: This option has no effect on Windows. On Windows a multicast socket is only bound to the UDP port.

The default value is 0, meaning that a multicast socket is bound to both the UDP port and multicast address.

When this is set to 1, the UDP transport binds a multicast receive socket only to the UDP port.

RTI_BOOL UDP_InterfaceFactoryProperty::disable_multicast_interface_select

Do not select outgoing interfaces when sending to multicast groups.

The default value is 0 and RTI Connext DDS Micro will select the outgoing interfaces when sending to multicast either using the allow_interface and deny_interface properties, or the multicast_interface property.

When this is set to 1, RTI Connext DDS Micro will not select the outgoing interface when sending to multicast groups. This may be useful if the OS has fine grained control to select which interface should be used to send to multicast.

struct UDP_TransformRuleSeq UDP_InterfaceFactoryProperty::source_rules

Rules for how to transform received UDP payloads based on the source address.

struct UDP_TransformRuleSeq UDP_InterfaceFactoryProperty::destination_rules

Rules for how to transform sent UDP payloads based on the destination address.

UDP_TransformUdpMode_T UDP_InterfaceFactoryProperty::transform_udp_mode

Determines how regular UDP is supported when transformations are supported.

RTI_INT32 UDP_InterfaceFactoryProperty::transform_locator_kind

The locator to use for locators that have transformations.

When transformation rules have been enabled, they are announced as a vendor-specific locator. This property overrides this value. NOTE: Changing this value may prevent communication. NOTE: Must be greater or equal than NETIO_ADDRESS_KIND_USER and not equal to NETIO_ADDRESS_KIND_SHMEM or NETIO_ADDRESS_KIND_INTRA.