Built-in Transport Plugins

Summary: Transport plugins delivered with dds.

The DDSTransportBuiltinQosModule specifies the collection of transport plugins that can be automatically configured and managed by RTI Connext as a convenience to the user.

These transport plugins can simply be turned "on" or "off" by a specifying a bitmask in DDS.TransportBuiltinQosPolicy, thus bypassing the steps for setting up a transport plugin. RTI Connext preconfigures the transport plugin properties, the network address, and the aliases to "factory defined" values.

If a builtin transport plugin is turned "on" in DDS.TransportBuiltinQosPolicy, the plugin is implicitly created and registered to the corresponding DDS.DomainParticipant by RTI Connext when:

  • the DDS.DomainParticipant is enabled,
  • the first DataWriter/DataReader is created, or
  • you lookup a builtin DataReader (DDS.Subscriber.lookup_datareader),

    whichever happens first.

    Each builtin transport contains its own set of properties. For example, the NDDS_Transport_UDPv4_Plugin allows the application to specify whether or not multicast is supported, the maximum size of the message, and provides a mechanism for the application to filter out network interfaces.

    The builtin transport plugin properties can be changed by the procedure NDDSTransportSupport.set_builtin_transport_property() or by using the DDSPropertyQosModule QoS policy associated with the DDS.DomainParticipant. Builtin transport plugin properties specified in DDS.PropertyQosPolicy always overwrite the ones specified through NDDSTransportSupport.set_builtin_transport_property(). Refer to the specific builtin transport for the list of property names that can be specified through DDSPropertyQosModule QoS policy.

    Any changes to the builtin transport properties after the builtin transports have been registered with will have no effect.


    See also: NDDSTransportSupport.set_builtin_transport_property() DDS.PropertyQosPolicy