RTI Connext C API  Version 5.0.0
DDS_TransportBuiltinQosPolicy Struct Reference

Specifies which built-in transports are used. More...

Data Fields

DDS_TransportBuiltinKindMask mask
 Specifies the built-in transports that are registered automatically when the DDS_DomainParticipant is enabled.
 

Detailed Description

Specifies which built-in transports are used.

Three different transport plug-ins are built into the core RTI Connext libraries (for most supported target platforms): UDPv4, shared memory, and UDPv6.

This QoS policy allows you to control which of these built-in transport plug-ins are used by a DDS_DomainParticipant. By default, only the UDPv4 and shared memory plug-ins are enabled (although on some embedded platforms, the shared memory plug-in is not available). In some cases, users will disable the shared memory transport when they do not want applications to use shared memory to communicate when running on the same node.

Note: If one application is configured to use UDPv4 and shared memory, while another application is only configured for UDPv4, and these two applications run on the same node, they will not communicate. This is due to an internal optimization which will default to use shared memory instead of loopback. However if the other peer application does not enable shared memory there is no common transport, therefore they will not communicate.

Entity:
DDS_DomainParticipant
Properties:
RxO = N/A
Changeable = NO

Field Documentation

DDS_TransportBuiltinKindMask DDS_TransportBuiltinQosPolicy::mask

Specifies the built-in transports that are registered automatically when the DDS_DomainParticipant is enabled.

RTI Connext provides several built-in transports. Only those that are specified with this mask are registered automatically when the DDS_DomainParticipant is enabled.

[default] DDS_TRANSPORTBUILTIN_MASK_DEFAULT


RTI Connext C API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc