Builtin Transport Plugins

There are two ways in which the builtin transport plugins may be registered:

• Default builtin Transport Instances: Builtin transports that are turned "on" in the TRANSPORT_BUILTIN QosPolicy (DDS Extension) are implicitly registered when (a) the DomainParticipant is enabled, (b) the first DataWriter/DataReader is created, or (c) you look up a builtin DataReader (by calling lookup_datareader() on a Subscriber), whichever happens first. The builtin transport plugins have default properties. If you want to change these properties, do so before1Any transport property changes made after the plugin is registered will have no effect. the transports are registered.
• Other Transport Instances: There are two ways to install non-default builtin transport instances:
  • Transport plugins may be explicitly registered by first creating an instance of the transport plugin (by calling NDDS_Transport_UDPv4_new(), NDDS_Transport_UDPv6_new() or NDDS_Transport_Shmem_new(), see Explicitly Creating Builtin Transport Plugin Instances), then calling register_transport() (Installing Additional Builtin Transport Plugins with register_transport()). (For example, suppose you want an extra instance of a transport.) (Not available for the Java or .NET API.)
  • Additional builtin transport instances can also be installed through the PROPERTY QosPolicy (DDS Extension) .

To configure the properties of the builtin transports:

• Set properties by calling set_builtin_transport_property() (see Setting Builtin Transport Properties of Default Transport Instance—get/set_builtin_transport_properties())

or

• Specify predefined property strings in the DomainParticipant’s PropertyQosPolicy, as described in Setting Builtin Transport Properties with the PropertyQosPolicy.

For other builtin transport instances:

• If the builtin transport plugin is created with NDDS_Transport_UDPv4_new(), NDDS_Transport_UDPv6_new() or NDDS_Transport_Shmem_new(), properties can be specified during creation time. See Explicitly Creating Builtin Transport Plugin Instances.
• If the additional builtin transport instances are installed through the PROPERTY QosPolicy (DDS Extension) , the properties of the builtin transport plugins can also be specified through that same QosPolicy.

© 2017 RTI