RTI Connext Modern C++ API Version 7.3.0
rti::core::policy::TransportSelection Class Reference

<<extension>> Specifies the transports that a dds::pub::DataWriter or a dds::sub::DataReader may use to send or receive data More...

#include <rti/core/policy/CorePolicy.hpp>

Public Member Functions

 TransportSelection ()
 Creates the default policy. More...
 
 TransportSelection (const dds::core::StringSeq &the_enabled_transports)
 Creates an instance with the sepcified transport aliases. More...
 
TransportSelectionenabled_transports (const dds::core::StringSeq &the_enabled_transports)
 A sequence of transport aliases that specifies the transport instances available for use by the entity. More...
 
dds::core::StringSeq enabled_transports () const
 Getter (see setter with the same name) More...
 

Detailed Description

<<extension>> Specifies the transports that a dds::pub::DataWriter or a dds::sub::DataReader may use to send or receive data

An application may be simultaneously connected to many different physical transports, e.g., Ethernet, Infiniband, shared memory, VME backplane, and wireless. By default, RTI Connext will use up to 16 transports to deliver data from a DataWriter to a DataReader.

This QoS policy can be used to both limit and control which of the application's available transports may be used by a dds::pub::DataWriter to send data or by a dds::sub::DataReader to receive data.

Entity:
dds::sub::DataReader, dds::pub::DataWriter
Properties:
RxO = N/A
Changeable = NO

Constructor & Destructor Documentation

◆ TransportSelection() [1/2]

rti::core::policy::TransportSelection::TransportSelection ( )
inline

Creates the default policy.

◆ TransportSelection() [2/2]

rti::core::policy::TransportSelection::TransportSelection ( const dds::core::StringSeq the_enabled_transports)
inlineexplicit

Creates an instance with the sepcified transport aliases.

Member Function Documentation

◆ enabled_transports() [1/2]

TransportSelection & rti::core::policy::TransportSelection::enabled_transports ( const dds::core::StringSeq the_enabled_transports)

A sequence of transport aliases that specifies the transport instances available for use by the entity.

Of the transport instances installed with the dds::domain::DomainParticipant, only those with aliases matching an alias in this sequence are available to the entity.

Thus, this list of aliases sub-selects from the transports available to the dds::domain::DomainParticipant.

An empty sequence is a special value that specifies all the transports installed with the dds::domain::DomainParticipant.

Alias names for the builtin transports are defined in TRANSPORT_BUILTIN. These alias names are case sensitive and should be written in lowercase.

[default] Empty sequence; i.e. all the transports installed with and available to the dds::domain::DomainParticipant.

[range] A sequence of non-empty strings.

See also
dds::domain::qos::DomainParticipantQos::transport_builtin.

◆ enabled_transports() [2/2]

dds::core::StringSeq rti::core::policy::TransportSelection::enabled_transports ( ) const

Getter (see setter with the same name)