Connext DDS comes with three different transport plugins built into the core libraries (for most supported target platforms). These are plugins for UDPv4, shared memory, and UDPv6.
This QosPolicy allows you to control which built-in transport plugins are used by a DomainParticipant. By default, only the UDPv4 and shared memory plugins are enabled (for most platforms; on some platforms, the shared memory plugin is not available). You can disable one or all of the builtin transports.
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.
It contains the member in DDS_TransportBuiltinQosPolicy. For the default and valid values, please refer to the API Reference HTML documentation.
|
Type |
Field Name |
Description |
|
DDS_TransportBuiltinKindMask |
mask |
A mask with bits that indicate which built-in transports will be installed. |
Please see the API Reference HTML documentation (select Modules, RTI Connext DDS API Reference, Pluggable Transports, Using Transport Plugins and Built-in Transport Plugins) for more information.
Note: Currently, Connext DDS will only listen for discovery traffic on the first multicast address (element 0) in multicast_receive_addresses.
See System Resource Considerations for an example of why you may want to use this QosPolicy.
In addition, customers may wish to install and use their own custom transport plugins instead of any of the builtin transports. In that case, this QosPolicy may be used to disable all builtin transports.
This QosPolicy cannot be modified after the DomainParticipant is created.
It can be set differently on the publishing and subscribing sides.
You can save memory and other system resources if you disable the built-in transports that your application will not use. For example, if you only run a single application with a single DomainParticipant on each machine in your network, then you can disable the shared memory transport since your applications will never use it to send or receive messages.
© 2018 RTI