Release notes

Version 3.6.1 (latest)

This release includes the following fixes:

1. Apply sqlite3 patch to eliminate const issue

2. Remove deprecated doxygen warnings

3. Fix compilation warnings and errors in Ubuntu Focal

Previous end-of-life versions

Release notes

2.14.4 Stable Release

• Free and Open Source: Apache 2.0 License
• Commercial Support Available.

 Main Features

• High performance. See the performance benchmarks on the product page.
• Multi-Platform: Windows, Linux, Mac OS, iOS, Android, Raspbian.
• Easy to use: Hello World video tutorial available on the product page.
• Full DDS & RTPS compliance: OMG DDS1-4 & RTPS 2.2 Compliant. Best Effort and Reliable Communications in both Unicast and Multicast.
• DDS Security Support.

What is new:

2.14.3

This release includes the following features in an ABI compatible manner:

1. Setting vendor_id on received CacheChange_t

This release includes the following improvements:

1. Repository & CI improvements.

2. Create InitialConnection for TCP Transport initial peers

This release includes the following fixes:

1. Fix topic interference on liveliness_changed status

2. Remove doxygen warnings

3. Adjust doxygen so Fast DDS Python pydoc makes RTD build

4. Fix compilation in Ubuntu 24.04 platforms

5. Fix Latency test destruction

2.14.2

This release includes the following new features:

1. Add netmask filter transport configuration

2. Add interface allowlist and blocklist

3. Expose Security Authentication plugin Handshake Properties

4. Extend LARGE_DATA configuration options

5. Allow single listening port on TCP

6. OpenOutputChannels / CloseOutputChannels that receive a LocatorSelectorEntry

7. Support GTest v1.14.0

8. Update Fast CDR submodule to v2.2.0

9. Update roadmap and release support

This release includes the following improvements:

1. Ignore custom PIDs defined in Fast DDS when they are received from other vendors

2. Add catch of out-of-range exception for thread settings port

3. Explicitly pass vendor ID to readFromCdrMessage

4. TCP transport improvements:

   1. TCPSendResources cleanup

   2. TCP non_blocking_send moved to TCPTransportDescriptor

5. Various repository improvements and housekeeping:

   1. Migrate communication tests to the DDS API

   2. Migrate TCPReqRepHelloWorldReplier/Requester to the DDS API

   3. Update APIs in video performance tests to the DDS API

   4. Remove FASTDDS_TODO_BEFORE 2.14

   5. Remove use of deprecated FindPythonInterp

   6. Remove idl parser from .repos file

   7. Force usage of semicolon in FASTDDS_TODO_BEFORE macro

   8. Ubuntu example testing automation infrastructure

6. Multiple Github CI improvements:

   1. Add nightly Ubuntu Github CI

   2. Improve CI version management

   3. Avoid running GitHub CI if PR has conflicts

   4. Migrate apt package installation to eProsima-CI action

   5. Include missing nightly for 3.0.x branch

   6. Adapt nightly jobs for all supported versions

   7. Pin CMake version and vm.mmap_rnd_bits in sanitizer workflows

   8. Select reusable workflow version depending on target branch in nightly jobs

This release includes the following fixes:

1. Fix warnings when compiling for Windows x86

2. TCP first message loss (see TCPTransportDescriptor)

3. Fix warnings on tests on Windows 32bits

4. Protect asio exception hotfix

5. Fix CVE-2024-28231

6. Github CI fixes:

   1. Fix CI documentation workflow label triggering

   2. Fix nightly jobs

   3. Fix input branch on reusable windows CI

   4. Use correct version of GTest on DS ASan tests

This release includes the following features:

1. Support Monitor Service.

2. Enable configuration of thread settings for all threads (both through the C++ API and XML configuration files).

3. Support Autofill port (automatic assignment of a port) for TCP Transport listening port.

4. Support TCP for Discovery Server CLI and environment variable.

5. Usage of gtest_discover_tests.

6. Define a super client by an environment variable.

7. Support adding interfaces to the interface whitelist by the name.

8. Add new methods to configure Builtin Transport.

9. Support DataRepresentationQos.

10. Change the serialize function default behavior to omit the data representation.

11. Upgrade the Fast CDR submodule to v2.1.2.

12. Update roadmap & platform support.

This release includes the following improvements:

1. Rerun failed tests with ctest option instead of colcon’s.

2. Add CCache to all CI jobs.

This release includes the following fixes:

1. Fast DDS bugfixes

   1. Fix compilation of XMLProfileParserTests when building without security.

   2. Improve IgnoreNonExistentSegment test for Windows.

   3. Add missing thread includes.

   4. Fix warning in Mac rewarding unnecessary lambda capture.

   5. Use SO_EXCLUSIVEADDRUSE for Win32 unicast listening sockets.

   6. Fix gtest discovery timeout.

   7. Mark on_participant_discovery overload removal.

   8. Fix uninitialized member in BuiltinAttributes class.

   9. Fix set affinity directive for Android.

   10. Fix Monitor Service types & test without security.

   11. Fix TCP deadlock on channel reuse.

   12. Fix DNS filter in CMakeLists file for tests.

   13. Fix memory issues related to ciphering payload.

   14. Fix a bad-free when receiving a malformed DATA_FRAG submessage.

   15. Fix CVE-2023-50257.

   16. Fix compilation of Fast DDS Python tests.

   17. Fix data race on writer destruction while sending heartbeat.

   18. Fix build with TLS, when SECURITY=OFF and NO_TLS=OFF.

2. CI fixes:

   1. Fix colcon on github CI.

   2. Better handling of trigger events in docs CI.

 

 

2.12.1:

 This release includes the following improvements:

1. Support for linking with Fast CDR v1.

2. The period for the timer within the DisablePositiveACKsQosPolicy is now updatable.

3. Log error message upon receiver resource creation failure.

4. CI and repository improvements.

5. Simplify code in CDRMessage.

This release includes the following fixes:

1. Fast DDS bugfixes

   1. Fix transient local durability for reliable readers using intra-process and data-sharing.

   2. Use STL implementation of Timed/RecursiveTimedMutex when MSVC >= 19.36.

   3. Fix updatability of immutable DataWriterQos.

   4. Fix the clang build for clang 14.

   5. Fix remote locators filtering when whitelist provided.

   6. Fix Data Race when updating liveliness changed in WLP.

   7. Add XML parser bit_bound bounds check.

   8. Fix missing mandatory attribute check in XML parser struct type.

   9. SHM transport: ignore non-existing segment on pop.

   10. Fix: mac address overflow on Windows.

2. CI fixes:

   1. Fix flow controllers unit tests compilation when using Fast CDR from thirdparty.

   2. PubSubAsReliable test fix.

   3. FileWatchTest fix for github windows CI.

2.12.0:

This release includes the following features:

1. New participant property to configure SHM transport metatraffic behavior.

2. Exposed custom payload pool on DDS DataWriter and DataReader declaration.

3. Processing environment variables in XML text.

4. Dependencies

This release includes the following improvements:

1. fixed_string comparison operators.

2. Remove mutex from TimedEventImpl (#3745, #3760)

3. Performance improvements on intraprocess and datasharing.

4. Improve Shared Memory resilience to crashing participants.

5. Improve scripts shebang portability.

6. Use foonathan_memory to reduce allocations in SharedMemManager.

This release includes the following fixes:

1. Fast DDS bugfixes

   1. Fixed XMLParser null-dereference when parsing log configuration.

   2. Allow participant XML profiles with no  tag.

   3. Fix encapsulation format in Writer Liveliness Protocol.

   4. Fix DomainParticipant::register_remote_type return when negotiating type.

   5. Fix strict real-time feature when using Flow Controller feature.

   6. Fix ParameterPropertyList increment operators.

   7. Fix bad-free when receiving malformed DATA submessage.

   8. Fix asymmetric whitelist matching.

   9. Fix heap-use-after-free on XMLElementParser.

   10. Fix History remove change return statement.

2. CI fixes

   1. Fix RemoteBuiltinEndpointHonoring blackbox test.

   2. Improve repository workflows.

   3. Use FASTRTPS_NO_LIB on unittest root folder.

   4. Fix Windows workflow.

3. Tools

   1. Remove C++11 check in fastdds-discovery-server CLI tool.

4. Examples

   1. Fix HelloWorldDataSharing data type.

5. Documentation

   1. Doxygen typos.

6. Repository

   1. Remove 2.9.x as active branch.

7. Non Tier 1 support

   1. Fixed SHM in 32-bit architectures.

   2. Fix warning on Win32 architecture.

See the full release notes for more details.

Prior versions:

2.11.2:

This release includes the following improvements:

1. Improve Shared Memory resilience to crashing participants
2. User configuration for Shared Memory metatraffic
3. Performance improvements on intraprocess and data-sharing

This release includes the following bugfixes:

1. Remove Mutex from TimedEventImpl
2. Replace uint64_t by 8 in alignas specifier
3. Fix XMLParser null-derefence in parseLogConfig

2.11.0:

Mind that, even though this release is API compatible with previous v2.x versions, it is NOT ABI compatible with previous versions. This means that applications upgrading Fast DDS to v2.11.0 will require recompilation, though not source code modification

It is also advisable to regenerate the type support from the IDL files using Fast DDS-Gen v2.5.1. Furthermore, if upgrading to v2.11.0, it is also recommended to upgrade Fast CDR to v1.1.0.

This release includes the following features:

1. Ignore every local endpoint within the DomainParticipant preventing local matching.

2. Extend DynamicDataHelper API providing a print overload with std::ostream as parameter.

3. TypeLookup Service Configuration.

4. Static Discovery XSD Schema.

This release includes the following improvements:

1. Fast DDS improvements

   1. Assign minimum available participant ID to new participants.

   2. Export symbols correctly on ContentFilteredTopic.

   3. Improve content filter expression parameters check and verbosity.

   4. Check TCP headers endianness.

   5. Security module: distinguished names (DN) comparison.

2. Fast DDS deprecation

   1. DDS:Crypto:AES-GCM-GMAC configuration using Property Policy QoS (security vulnerability).

3. CI improvements

   1. Include BitmapRange unit tests.

   2. Support for running some tests in parallel.

   3. Windows workflow.

4. Build system

   1. Improve CMake target loading. Removal of FASTDDS_STATIC CMake option.

   2. Avoid auto-linkage using CMake.

5. Dependencies

   1. Upgrade internal type supports using latest Fast DDS-Gen release v2.5.1.

   2. Upgrade Fast CDR submodule to v1.1.0.

6. Examples

   1. Admit XML configuration files in AdvanceConfigurationExample.

   2. New Discovery Server example.

This release includes the following fixes:

1. Fast DDS bugfixes

   1. Fix crash when creating two participants with the same fixed participant ID.

   2. Fix crash when calling on_requested_deadline_missed() callback.

   3. Fix crashes caused by not capturing every Fast CDR exception.

   4. Correctly resolve aliases in DDSSQLFilter.

   5. Wait for log background thread initialization on the first queued entry.

   6. Fix data race when accessing WRITE_PARAM_DEFAULT static variable.

   7. Fix partition copy in QoS.

   8. Fix Data-Sharing delivery when data_count is zero.

   9. Fix API Fast DDS v2.10.0 API break calling correctly. on_participant_discovery() callbacks.

   10. Security module: Honor Allow Unauthenticated Participants flag.

   11. Fix concurrent access to load_profiles().

   12. Fix UBSan (Undefined Behavior Sanitizer) issues.

   13. Improve Doxygen documentation about DomainParticipantListener discovery callbacks.

2. XSD fixes

   1. Set TransportDescriptor kind parameter as optional.

   2. Correctly assign QoS to the proper endpoint.

   3. Add missing tags.

3. CI fixes

   1. Fix null dereference in fuzzer code.

   2. Limit Thread Sanitizer memory usage to prevent runner shutdown.

   3. Use correct time unit in latency tests.

   4. Run communication tests.

4. Examples

   1. Correct DDS entity deletion order.

5. Installer generation

   1. Add documentation fallback when the documentation tag is not found.

6. Repository

   1. Remove 2.1.x as active branch.

   2. Remove 2.8.x as active branch.

7. Non Tier 1 support

   1. Fix build on MSVC 19.36.

   2. Forward compatibility with Boost inter-process 1.74+.

   3. Include missing header files required for compiling with GCC 13.

   4. QNX build fixes.

   5. Fix build issues in RPM systems.

2.10.1:

This release includes the following bugfixes and improvements:

• Bugfixes:

  • Fix repeated matched event notification.

  • Fix regression introduced by #3396.

  • Initial acknack backoff.

  • Fix regular expression in XML schema.

  • Correctly assign multicast port to multicast initial peers.

• CI Improvements:

  • Update runner and GCC version for Thread Sanitizer job.

2.10.0:

This release includes the following features besides many other improvements and bugfixes:

• Features:
  • Secure Discovery Server. Now users can configure Security on Discovery Server deployments.
  • New on_unacknowledged_sample_removed callback in DataWriterListener. This callback is useful in overloaded systems to detect any possible data loss.
• Improvements:
  • Community supported platforms. Now QNX 7.1 build infrastructure is supported
  • New Request-Reply example
  • CI improvements, more checks and configurations available
  • Update XSD schema: to an easier XML validation
  • Contributions to increase repository quality

2.9.1:

This release includes the following bugfixes:

• Synchronization fixes:
  • Fix deadlock in Writer Liveliness Protocol (WLP) using intraprocess.
  • Fix data race in DomainParticipant::set_listener().
  • Fix deadlock on TLS closure.
• Other fixes:
  • Fix notification lost.
  • Fix total_read_ to be consistent with Reader’s History after DataReader::get_first_untaken_info().
  • Use shared pointers for internal singletons.
  • Support CCache on Windows.
  • Avoid null dereference on fuzzer.
  • Other minor fixes and improvements.

2.9.0:

Mind that, even though this release is API compatible with previous v2.x versions, it is NOT ABI compatible with previous versions. This means that applications upgrading Fast DDS to v2.9.0 will require recompilation, though not source code modification.

This release includes the following features and improvements besides many others and various bugfixes:

• New log macros EPROSIMA_LOG_INFO, EPROSIMA_LOG_WARNING and EPROSIMA_LOG_ERROR.
• Add ENABLE_OLD_LOG_MACROS CMake option to support disabling the compilation of previous log macros.
• CI improvements:
  • Add address sanitizer job for Fast DDS library.
  • Add address sanitizer job for Discovery Server test suite.
• Upgrade Fast CDR submodule.
• Synchronization fixes:
  • Fix deadlock when removing remote DomainParticipants by expired liveliness when using Security.
  • Protect DomainParticipant::set_listener() avoiding null reference.
  • Fix data race on WriterProxy::stop while TimedEvent is being triggered.
  • Protect creation/destruction of Boost’s named_mutex.
• CI fixes:
  • Fix Statistics Module test suite.
  • Fix recurring data races in test suite.
  • Fix thread sanitizer job keeping Ubuntu 20.04.

2.8.1:

• Synchronization fixes:
  • Fix data races when creating DataWriters.
  • Ensure shared_mutex implementation is consistent throughout supported platforms.

• Address sanitizer fixes:
  • Add ASAN CI job and SANITIZE CMake option.
  • Fixes reported by address sanitizer.

• Statistics module fixes:
  • Increase statistics DataWriter history.
  • Fix Statistics module CI.
  • Install Statistics IDL file.
  • Fix for building in old compilers.
  • Fix core dumped in delete_contained_entities().

...and others

2.8.0:

Mind that, even though this release is API compatible with previous v2.x versions, it is NOT ABI compatible with previous versions. This means that applications upgrading Fast DDS to v2.8.0 will require recompilation, though not source code modification.

This release includes the following features besides many other improvements and bugfixes:

• Full Ownership and OwnershipStrength QoS support
• External locators
• UDPv6 support for fast-discovery-server tool and ROS_DISCOVERY_SERVER
• XML configuration support for statistics DataWriters QoS
• SNI support
• Propagate PropertyQoS properties when explicitly set
• Add API to createRTPSWriter with a custom pool
• Add std::string::compare API to fixed_string
• Get WAN address API in TCPv4 transport descriptors
• Adding DomainParticipantFactory::get_shared_instance() API

2.7.1:

• Checking STATIC EDP XML Files by means of DomainParticipantFactory::check_xml_static_discovery().
• ReadCondition implementation.
• Thread sanitizer CI.
• Overload get_unread_count().
• Improve read/take performance when using topic with a great number of keys.
• Improve rediscovery on lossy environments.
• New CMake option USE_THIRDPARTY_SHARED_MUTEX.
• Notify changes in bulk in RTPS readers.
• Fix Fast CDR submodule update to v1.0.24.
• Fix access to some pointers.
• Fixed acknowledgement in DataSharing.
• and other

2.7.0:

• Support for DDS SampleRejectedStatus API
• Support for DDS DataWriter methods:
  • DataWriter::write_w_timestamp()
  • DataWriter::register_instance_w_timestamp()
  • DataWriter::unregister_instance_w_timestamp()
  • DataWriter::dispose_w_timestamp()
• Support for DDS find_topic()
• Support for GCC 12
• Upgrade CMake minimum requirement to 3.16.3
• Add Windows DLL support to Dynamic Types API
• Deadlocks and data races
• Move deprecated OpenSSL cleanup function to match the right version

2.6.1:

• Support for writer side content filtering
• Support hexadecimal values on SQL filter
• Support for DataWriter::get_key_value()
• Support for DataReader::lookup_instance()
• Support for SampleLostStatus on DataReader
• Improved doxygen documentation
• Fixed several lock order inversion issues
• Fixed data race when closing UDP channels
• Fixed empty partition validation checks
• Fixed corner case with reliable writers and samples with a huge number of fragments
• Other minor fixes and improvements

2.6.0:

• Allow modifying remote server locators at runtime
• Add statistics physical information to DATA[p] using properties
• Content filter discovery information RTPS API
• Endpoint discovery RTPS API
• on_sample_lost RTPS API
• Transport layer API extension
• XML support for Fast DDS CLI
• New exchange format to reduce bandwidth in Static Discovery
• Support lowercase keywords on SQL filter
• Separate initialization and enabling of BuiltinProtocols
• Support for octet vectors on XML parser
• Update README and roadmap
• Fix recommended statistics DataReaderQos to enable backwards compatibility
• Fixes for supporting Python bindings in Windows platforms
• Fix publishing physical data on statistics topic
• etc.

2.5.1:

• ContentFilterTopic filtering at the DataReader side
• Release lifecycle
• XML parser fixes
• Discovery Server fixes
• Fix DataSharing sample validation

2.5.0:

• Support for PKCS#11 format URIs for private keys
• Added interfaces for content filter APIs
• Allow new network interfaces to be detected at runtime
• New API on DataWriter to wait for a specific instance to be acknowledged
• Added interfaces for concatenation of transports
• Allow XML profiles to be loaded from a string
• Allow disabling piggyback heartbeat on XML and DataWriter QoS
• New basic configuration example

2.4.1:

• Fixed several flaky tests
• Improved bandwidth usage of GAPs and HEARTBEATs
• Correctly implement delete_contained_entities
• Use native inter-process on Windows
• Improved performance of unregister_instance
• Improved OSS-fuzz integration
• Support for partitions on DataWriterQoS and DataReaderQoS
• Some documentation improvements
• Removed unused macro to avoid naming clashes

2.4.0:

• Conditions and Wait-sets implementation.
• Flow controllers.
• Configure Discovery Server locators using names.
• Modifying remote servers list at run time.
• Environment file override.
• Allow setting custom folder for data-sharing files.
• Allow setting persistence guid with static discovery.
• Check for NDEBUG in logInfo.
• Removed old unused CMake code.
• Fixed TLS behavior on TCP example.
• Prepare API for easy integration of python bindings.
• Improved statistics performance.

2.3.4:

• Support of googletest using colcon
• Network latency reports source participant
• Update Fast DDS Gen to v2.0.2

2.3.3:

• Added more durability kinds in Static Discovery xml parser
• Explicitly enable/disable data-sharing on performance tests
• Allow fully qualified name in TypeDescriptor
• Added missing DynamicData::get_union_id() method
• Change log severity in DiscoveryServer first announcement
• Several corrections to README

2.3.2:

• Statistics Module
• Update Asio submodule and avoid exporting Asio API
• Improve Windows installers
• Ease Google Fuzz integration
• Improve Doxygen documentation on lifetime of pointers created with RTPSDomain
• Update Fast CDR to v1.0.21

2.3.1:

• Added Fast DDS Statistics Module implementation
• Fixed alignment issues on generated code calculation of maximum serialized size
• Fixed calculation of data-sharing domain id
• Fixed issues on data-sharing with volatile writers
• Fixed build issues on old compilers
• Fixed some tests when the library is built without security
• Fixed and exposed pull mode on writers
• Fixed handling of –data_sharing on latency test
• Fixed calculation of memory pools sizes on debug builds
• Correctly update memory policy on writers and readers

2.3.0:

• Unique network flows
• Discovery super-client
• Statistics module API
• New flow controller API
• Static discovery configuration from raw string
• Added reception timestamp to SampleInfo
• Exposing get_unread_count on DataReader
• Data-sharing delivery internal refactor
• Additional metadata on persistence databases
• Refactor on ReturnCode_t to make it switch friendly
• Performance tests refactored to use DDS-PIM high-level API
• Receive const pointers on delete_xxx methods
• Discovery server improvements
• Made SOVERSION follow major.minor

 2.2.0

• Data Sharing delivery (avoids transport encapsulation for localhost communications)
• Complete DDS-PIM high-level API declarations
• Extension APIs allowing zero-copy delivery (both intra-process and inter-process)
• Upgrade to Quality Level 1

2.1.0

• Support persistence for large data
• Added support for on_requested_incompatible_qos and on_offered_incompatible_qos
• SKIP_DEFAULT_XML environment variable
• Added FORCE value to THIRDPARTY cmake options
• New log consumer (StdOutErrConsumer)
• Added methods to get qos defined in XML Profile
• Support for persistence on TRANSIENT_LOCAL
• Internal refactor for intra-process performance boost
• Allow usage of foonathan/memory library built without debug tool
• Large data support on performance tests

2.0.2

• Improve QNX support
• Security improvements
• Fast DDS Quality Declaration (QL 2)
• Large traffic reduction when using Discovery Server (up to 85-90% for large deployments)
• Configuration of Clients of Discovery Server using an environment variable
• A CLI for Fast DDS:
  • This can be used to launch a discovery server
  • Clean SHM directories with one command
• Shared memory transport enabled by default
• Solved edge-case interoperability issue with CycloneDDS
• Add package.xml

2.0.1

• Fixed sending GAPs to late joiners
• Fixed asserting liveliness on data reception
• Avoid calling OpenSSL_add_all_algorithms() when not required

2.0.0

• Added support for register/unregister/dispose instance
• Added DDS compliant API. This new API exposes all the functionality of the Publisher-Subscriber Fast RTPS API adhering to the Data Distribution Service (DDS) version 1.4 specification
• Added Security Logging Plugin (contributed by Cannonical Ltd.)
• Bump to FastCDR v1.0.14

1.10.0:

• New built-in Shared memory Transport (SHM)
• Transport API refactored to support locator iterators
• Added subscriber API to retrieve info of first non-taken sample
• Added parameters to fully avoid dynamic allocations
• History of built-in endpoints can be configured
• Bump to FastCDR v1.0.13.
• Bump to Fast-RTPS-Gen v1.0.4.
• Require CMake 3.5 but use policies from 3.13

1.9.3:

• Participant discovery filtering flags.
• Intra-process delivery mechanism opt-in.

1.9.2:

• Multiple initial PDP announcements.
• Flag to avoid builtin multicast.

1.9.1:

• Fast-RTPS-Gen is now an independent project.
• Header eClock.h is now marked as deprecated.

1.9.0:

• Partial implementation of allocation QoS
• Implementation of Discovery Server

1.8.1:

• Implementation of Liveliness QoS

1.8.0:

• Implementation of IDL 4.2
• Implementation of Deadline QoS
• Implementation of Lifespan QoS
• Implementation of Disable positive acks QoS
• Secure sockets on TCP transport (TLS over TCP)

1.7.2:

• Bug fixing

1.7.1:

• Bug fixing
• Support for QNX

1.7.0:

• TCP Transport: Fast RTPS on WAN.
• Dynamic Topic Types: Define your topic data type at runtime.
• DDS Security 1.1 compliance: Latest DDS security specification.

1.6.0:

• Persistence: Saves your sent messages in a database for late use.
• Better Security: Finer Access Control.
• Performance improvements: Even better latency and jitter.

1.5.0:

• Easier Configuration of Fast RTPS entities through XML profiles.
• Improved Reliability protocol: Added piggybacked heartbeat support.

1.4.0:

• Security: Authentication and encryption support. DDS Security Specification compliant. 
• Cpp 11 Support.
• Removed Boost Libraries Dependencies.
• Android Support
• Improved performance for large data.

1.3.1:

• New examples that illustrate how to tweak Fast RTPS towards different applications.
• Improved support for embedded Linux.
• Bug fixing.

1.3.0

• Unbound Arrays support: Now you can send variable size data arrays.
• Extended Fragmentation Configuration: It allows you to setup a Message/Fragment max size different to the standard 64Kb limit.
• Improved logging system: Get even more introspection about the status of your communications system.
• Static Discovery: Use XML to map your network and keep discovery traffic to a minimum.
• Stability and performance improvements: A new iteration of our built-in performance tests will make benchmarking easier for you.
• ReadTheDocs Support: We improved our documentation format and now our installation and user manuals are available online on ReadTheDocs.

 

Release notes

2.10.6

Stable Release

• Free and Open Source: Apache 2.0 License
• Commercial Support Available.

Main Features

• High performance. See the performance benchmarks in the product page.
• Multi-Platform: Windows, Linux, Mac OS, iOS, Android, Raspbian.
• Easy to use: Hello world video tutorial available in the product page.
• Full DDS & RTPS compliance: OMG DDS1-4 & RTPS 2.2 Compliant. Best Effort and Reliable Communications in both Unicast and Multicast.
• DDS Security Support.

What is new:

This release includes the following fixes:

1. Remove double // in some installation paths (#5254)
2. Discard changes with big key-only payload and no key hash (#5275)
3. Fix DataReaderHistory regression (#5333)
4. Be less strict with parameter lengths (#5248)
5. Check if SHM transport is disabled in LARGE_DATA modes (#5378)
6. Fix issues in Dynamic Network Interfaces (#5390)

This release includes the following improvements:

1. Add references to new nightly jobs per supported branch in README (#5299)
2. Update commercial support section in readme (#5323)
3. Modify help command of XML CLI tool (#5250)

Github CI management:

1. Allow runing CI on external contributions (#5289)

PRs in merged order:

#5289, #5299, #5254, #5275, #5333, #5323, #5250, #5248, #5378, #5390, #5395

Prior versions:

2.10.5

This release includes the following features in an ABI compatible manner:

1. Add XML configuration for FlowControllerDescriptor

This release includes the following improvements:

1. Use %* instead of loop in .bat scripts

2. Documentation improvements

3. Use absolute paths when loading XML files

4. Reduce tests flakiness

5. Add unsigned specification to literals

Github CI management:

1. Set fallback branch for get_related_branch_from_repo correctly

2. Fix sanitizers CI test summary report

3. Run selected VS tool on Windows CI

4. Use token for CCache action

5. Refactor Fast DDS Ubuntu CI to include several tests

6. Avoid CCache in some Github workflows

7. Build profiling tests as alternate build in Ubuntu CI

8. Add Ubuntu weekly CI

9. Fix python version in sanitizers CI

10. Fix windows CI and add vanilla build step in Ubuntu CI

11. Use eProsima-CI action to install Qt

12. Update types regeneration script homing path

This release includes the following fixes:

1. Automatically unmatch remote participants on participant deletion

2. Only apply content filter to ALIVE changes

3. Fix liveliness state in a multiple reader - one writer scenario

4. Fix topic interference on liveliness_changed status

5. Fix DS servers not connecting due to ports logic

6. Fix issue with exclusive ownership and unordered samples

7. Fix SecurityManager memory issue

8. Correctly initialize MatchingFailureMask constants to be used with the std::bitset API

9. Fix data race in TypeObjectFactory::get_instance

10. Properly delete builtin statistics writers upon delete_contained_entities()

11. Fix secure simple participants with initial peers not matching over TCP

12. Fix access violations on XML parser detected by OSS-fuzz

Note

If you are upgrading from a version older than 1.7.0, it is required to regenerate generated source from IDL files using fastddsgen. If you are upgrading from any older version, regenerating the code is highly recommended.

2.10.4:

This release includes the following features in an ABI compatible manner:

1. TCP Client and Server Participant Decision Making.

2. Authentication Handshake Properties documentation.

3. New max_message_size property to limit output datagrams size.

This release includes the following improvements:

1. Return const reference in get_log_resources.

2. Include variety of terminate process signals handler in discovery server.

3. Check History QoS inconsistencies.

4. Make DataWriters always send the key hash on keyed topics.

5. LARGE_DATA Participants logic with same listening ports.

6. Effectively assert AUTOMATIC/MANUAL_BY_PARTICIPANT liveliness.

7. Improve checklist on PR template.

8. Allow processing of AckNack submessages with count == 0.

9. Internal refactor on port handling.

10. Upgrade Fast CDR submodule to v1.0.28

TCP transport improvements:

1. TCP non-blocking send.

2. Enabling multiple interfaces through whitelist in TCP servers.

3. Set real TCP non-blocking-send limitation.

4. Clean up TCP send resources on peer disconnection.

Github CI management:

1. Add macOS Github CI.

2. Avoid running GitHub CI if PR has conflicts.

3. Add Ubuntu Github CI.

4. Improve CI version management.

5. Pin CMake version and vm.mmap_rnd_bits in sanitizer workflows.

6. Only run PRs CI when review is requested.

7. Refactor Github CI sanitizer related jobs.

8. Build ShapesDemo on Ubuntu Github CI.

9. Fix Python version and environment.

10. Add DNS entries to hosts files on Github workflows.

11. Build Fast DDS Python bindings in Fast DDS Docs Github CI job.

This release includes the following fixes:

1. Fix and refactor Windows Github CI.

2. Fix wrong log info messages on TCP.

3. Add a keyed fragmented change to the reader data instance only when complete.

4. Prevent index overflow and correctly assert the end iterator in DataSharing.

5. Fix the shared memory cleaning script.

6. Fix CI documentation workflow label triggering.

7. Add missing virtual destructor for StatisticsAncillary.

8. Migrate apt package installation action to eProsima-CI.

9. Add missing TypeLookup listeners.

10. Fix doxygen docs warnings. Prepare for compiling with Doxygen 1.10.0.

11. Upgrade dependency version to last patch version in .repos file.

12. Fix TCP reconnection after open logical port failure.

13. Avoid unhandled asio exceptions.

14. Fix CVE-2024-28231.

15. Fix data race on PDP.

16. Fix flaky Log tests.

17. Fix some flaky MacOS tests.

18. Fix hidden overloaded virtual methods.

19. Fix test filtering in CMake files.

20. Avoid first message loss in TCP.

21. Fix CVE-2024-30258 / CVE-2024-30259.

22. Enforce SHM ports open mode exclusions.

23. Force unlimited ResourceLimits if lower or equal to zero.

24. Removed warning in ParameterList.

25. Make DataReader::get_first_untaken_info() coherent with read()/take().

26. Fix leak in SecurityManager.

27. Fix support for @key annotation in DynamicTypes.

28. Fix leaks in XML parser for DynamicTypes.

29. Fix Discovery Server over TCP.

30. Handle errors when setting socket buffer sizes.

31. Fix on_sample_lost notification on best-effort readers for fragmented samples.

32. Fix DataSharing QoS deserialization.

Note

If you are upgrading from a version older than 1.7.0, it is required to regenerate generated source from IDL files using fastddsgen. If you are upgrading from any older version, regenerating the code is highly recommended.

This release includes the following features in an ABI compatible manner:

1. Support Autofill port (automatically set a port) for TCP Transport.

2. Define a super client by environment variable

3. Support TCP Discovery server CLI and environment variable

4. Define methods (environment variable, rtps layer, xml) to configure transport scenarios

5. Custom pools on DDS layer (DataWriter and DataReader)

This release includes the following improvements:

1. Log warning upon receiver resource creation failure

2. Simplify code in CDRMessage

3. Backport workflows from master

4. Rerun failed tests with ctest option instead of colcon’s

5. Use foonathan memory manager for reducing allocations in SharedMemManager.hpp

6. Add CCache to all CI jobs

This release includes the following bugfixes:

1. Fix RemoteBuiltinEndpointHonoring blackbox test

2. Fix bad-free when receiving malformed DATA submessage

3. Fix clang warnings

4. Use STL implementation of Timed/RecursiveTimedMutex when MSVC >= 19.36

5. Notify data-sharing listener at the end of a successful matching in intraprocess

6. Fix the clang build for clang 14

7. Fix HelloWorld Data-Sharing example idl

8. Fix the behaviour of disable_positive_acks period

9. Fix DomainParticipant::register_remote_type return when negotiating type

10. Fix Data Race when updating liveliness changed in WLP

11. Fix TCP sender resources creation

12. Fix flow controllers unit tests compilation when using Fast CDR from thirdparty

13. Add XML parser bit_bound bounds check

14. Add tests for reconnection with same GUID

15. Fix Github Windows CI

16. Fix PubSubAsReliable test

17. Use FASTRTPS_NO_LIB on unittest root folder

18. Fix missing mandatory attribute check in XML parser struct type

19. Fix mac address overflow on windows

20. Use SO_EXCLUSIVEADDRUSE for Win32 unicast listening sockets

21. Fix FileWatchTest for Github windows CI

22. Add missing thread include

23. Update TLS unit test certificates

24. Select correct .repos file on push events

25. Fix documentation CI branch

26. Fix TCP deadlock on channel reuse

27. Fix DNS filter in CMakeLists file for tests

28. Fix bad-free when receiving malformed DATA_FRAG submessage

29. Fix memory problem when ciphering payload

30. Fix build with TLS, but not security

31. Fix CVE-2023-50257

32. Fix data race on writer destruction while sending heartbeat

33. Fix comparison in remove_from_pdp_reader_history

34. Fix data race in PDPListener and SecurityManager

35. Update PR template to include check for PR description, title and backports

36. Fix std::move warning

37. Revert “TCP deadlock on channel reuse”

38. Fix max clash with Windows CI

39. Remove unnecessary TCP warning

40. Discard already processed samples on PDPListener

41. TCP unique client announced local port

See the full release notes for more details.

 2.10.2:

This release includes the following improvements and bugfixes:

• Improvements:
  • Fix Data-Sharing delivery when data_count is zero 
  • Improve performance of intraprocess plus data-sharing
  • Improve content filter expression parameters checks and verbosity
  • Improve validation on PID_PROPERTY_LIST deserialization
  • Participant ignore local endpoints
  • Pick smallest available participant ID for new participants
  • Improve endpoint QoS XML tags
  • Forward compatibility with boost interprocess 1.74+
  • Cap Thread Sanitizer memory usage to prevent runner shutdown
  • Allow participant XML profile with no  tag
  • Add unsupported note in API documentation to new ignore DomainParticipantListener callbacks
  • Add documentation version fallback
• Bugfixes:
  • Fixed long-standing reconnection issue on SHM transport
  • Fix null dereference when fuzzing
  • Fix segfault when creating two participant with same fixed id
  • Fix UBSan (Undefined Behavior Sanitizer) issues
  • Fix listener selection for on_requested_deadline_missed
  • Fix build on msvc 19.36.32528
  • Fix XML schema to set Transport descriptor kind as NOT mandatory
  • Fix missing includes
  • Fix overhead time unit
  • Fix request reply example spelling typo
  • Fix topic deletion after endpoint in examples
  • Fix Data-Sharing delivery when data_count is zero
  • Wait for log background thread initialization on the first queued entry
  • Fix alias resolve in DDSSQLFilter
  • Fix partition copy in QoS
  • Fix StatelessWriter locators filtering
  • Fix XMLParser null-dereference in parseLogConfig
  • Fix encapsulation format in WLP
  • Replace uint64_t by 8 in alignas specifier
  • Capture all Fast CDR exceptions
  • Security module: Honor allow_unauthenticated_participants flag
  • Explicitly register type object in ContentFilteredTopicExample
  • Avoid double definition of FASTDDS_ENFORCE_LOG_INFO
  • Fix API Fast DDS v2.10.0 API break calling correctly on_participant_discovery callbacks
  • Remove mutex from TimedEventImpl

2.10.1:

This release includes the following bugfixes and improvements:

• Bugfixes:

  • Fix repeated matched event notification.

  • Fix regression introduced by #3396.

  • Initial acknack backoff.

  • Fix regular expression in XML schema.

  • Correctly assign multicast port to multicast initial peers.

• CI Improvements:

  • Update runner and GCC version for Thread Sanitizer job.

2.10.0:

This release includes the following features besides many other improvements and bugfixes:

• Features:
  • Secure Discovery Server. Now users can configure Security on Discovery Server deployments.
  • New on_unacknowledged_sample_removed callback in DataWriterListener. This callback is useful in overloaded systems to detect any possible data loss.
• Improvements:
  • Community supported platforms. Now QNX 7.1 build infrastructure is supported
  • New Request-Reply example
  • CI improvements, more checks and configurations available
  • Update XSD schema: to an easier XML validation
  • Contributions to increase repository quality

2.9.1:

This release includes the following bugfixes:

• Synchronization fixes:
  • Fix deadlock in Writer Liveliness Protocol (WLP) using intraprocess.
  • Fix data race in DomainParticipant::set_listener().
  • Fix deadlock on TLS closure.
• Other fixes:
  • Fix notification lost.
  • Fix total_read_ to be consistent with Reader’s History after DataReader::get_first_untaken_info().
  • Use shared pointers for internal singletons.
  • Support CCache on Windows.
  • Avoid null dereference on fuzzer.
  • Other minor fixes and improvements.

2.9.0:

Mind that, even though this release is API compatible with previous v2.x versions, it is NOT ABI compatible with previous versions. This means that applications upgrading Fast DDS to v2.9.0 will require recompilation, though not source code modification.

This release includes the following features and improvements besides many others and various bugfixes:

• New log macros EPROSIMA_LOG_INFO, EPROSIMA_LOG_WARNING and EPROSIMA_LOG_ERROR.
• Add ENABLE_OLD_LOG_MACROS CMake option to support disabling the compilation of previous log macros.
• CI improvements:
  • Add address sanitizer job for Fast DDS library.
  • Add address sanitizer job for Discovery Server test suite.
• Upgrade Fast CDR submodule.
• Synchronization fixes:
  • Fix deadlock when removing remote DomainParticipants by expired liveliness when using Security.
  • Protect DomainParticipant::set_listener() avoiding null reference.
  • Fix data race on WriterProxy::stop while TimedEvent is being triggered.
  • Protect creation/destruction of Boost’s named_mutex.
• CI fixes:
  • Fix Statistics Module test suite.
  • Fix recurring data races in test suite.
  • Fix thread sanitizer job keeping Ubuntu 20.04.

2.8.1:

• Synchronization fixes:
  • Fix data races when creating DataWriters.
  • Ensure shared_mutex implementation is consistent throughout supported platforms.

• Address sanitizer fixes:
  • Add ASAN CI job and SANITIZE CMake option.
  • Fixes reported by address sanitizer.

• Statistics module fixes:
  • Increase statistics DataWriter history.
  • Fix Statistics module CI.
  • Install Statistics IDL file.
  • Fix for building in old compilers.
  • Fix core dumped in delete_contained_entities().

...and others

2.8.0:

Mind that, even though this release is API compatible with previous v2.x versions, it is NOT ABI compatible with previous versions. This means that applications upgrading Fast DDS to v2.8.0 will require recompilation, though not source code modification.

This release includes the following features besides many other improvements and bugfixes:

• Full Ownership and OwnershipStrength QoS support
• External locators
• UDPv6 support for fast-discovery-server tool and ROS_DISCOVERY_SERVER
• XML configuration support for statistics DataWriters QoS
• SNI support
• Propagate PropertyQoS properties when explicitly set
• Add API to createRTPSWriter with a custom pool
• Add std::string::compare API to fixed_string
• Get WAN address API in TCPv4 transport descriptors
• Adding DomainParticipantFactory::get_shared_instance() API

2.7.1:

• Checking STATIC EDP XML Files by means of DomainParticipantFactory::check_xml_static_discovery().
• ReadCondition implementation.
• Thread sanitizer CI.
• Overload get_unread_count().
• Improve read/take performance when using topic with a great number of keys.
• Improve rediscovery on lossy environments.
• New CMake option USE_THIRDPARTY_SHARED_MUTEX.
• Notify changes in bulk in RTPS readers.
• Fix Fast CDR submodule update to v1.0.24.
• Fix access to some pointers.
• Fixed acknowledgement in DataSharing.
• and other

2.7.0:

• Support for DDS SampleRejectedStatus API
• Support for DDS DataWriter methods:
  • DataWriter::write_w_timestamp()
  • DataWriter::register_instance_w_timestamp()
  • DataWriter::unregister_instance_w_timestamp()
  • DataWriter::dispose_w_timestamp()
• Support for DDS find_topic()
• Support for GCC 12
• Upgrade CMake minimum requirement to 3.16.3
• Add Windows DLL support to Dynamic Types API
• Deadlocks and data races
• Move deprecated OpenSSL cleanup function to match the right version

2.6.1:

• Support for writer side content filtering
• Support hexadecimal values on SQL filter
• Support for DataWriter::get_key_value()
• Support for DataReader::lookup_instance()
• Support for SampleLostStatus on DataReader
• Improved doxygen documentation
• Fixed several lock order inversion issues
• Fixed data race when closing UDP channels
• Fixed empty partition validation checks
• Fixed corner case with reliable writers and samples with a huge number of fragments
• Other minor fixes and improvements

2.6.0:

• Allow modifying remote server locators at runtime
• Add statistics physical information to DATA[p] using properties
• Content filter discovery information RTPS API
• Endpoint discovery RTPS API
• on_sample_lost RTPS API
• Transport layer API extension
• XML support for Fast DDS CLI
• New exchange format to reduce bandwidth in Static Discovery
• Support lowercase keywords on SQL filter
• Separate initialization and enabling of BuiltinProtocols
• Support for octet vectors on XML parser
• Update README and roadmap
• Fix recommended statistics DataReaderQos to enable backwards compatibility
• Fixes for supporting Python bindings in Windows platforms
• Fix publishing physical data on statistics topic
• etc.

2.5.1:

• ContentFilterTopic filtering at the DataReader side
• Release lifecycle
• XML parser fixes
• Discovery Server fixes
• Fix DataSharing sample validation

2.5.0:

• Support for PKCS#11 format URIs for private keys
• Added interfaces for content filter APIs
• Allow new network interfaces to be detected at runtime
• New API on DataWriter to wait for a specific instance to be acknowledged
• Added interfaces for concatenation of transports
• Allow XML profiles to be loaded from a string
• Allow disabling piggyback heartbeat on XML and DataWriter QoS
• New basic configuration example

2.4.1:

• Fixed several flaky tests
• Improved bandwidth usage of GAPs and HEARTBEATs
• Correctly implement delete_contained_entities
• Use native inter-process on Windows
• Improved performance of unregister_instance
• Improved OSS-fuzz integration
• Support for partitions on DataWriterQoS and DataReaderQoS
• Some documentation improvements
• Removed unused macro to avoid naming clashes

2.4.0:

• Conditions and Wait-sets implementation.
• Flow controllers.
• Configure Discovery Server locators using names.
• Modifying remote servers list at run time.
• Environment file override.
• Allow setting custom folder for data-sharing files.
• Allow setting persistence guid with static discovery.
• Check for NDEBUG in logInfo.
• Removed old unused CMake code.
• Fixed TLS behavior on TCP example.
• Prepare API for easy integration of python bindings.
• Improved statistics performance.

2.3.4:

• Support of googletest using colcon
• Network latency reports source participant
• Update Fast DDS Gen to v2.0.2

2.3.3:

• Added more durability kinds in Static Discovery xml parser
• Explicitly enable/disable data-sharing on performance tests
• Allow fully qualified name in TypeDescriptor
• Added missing DynamicData::get_union_id() method
• Change log severity in DiscoveryServer first announcement
• Several corrections to README

2.3.2:

• Statistics Module
• Update Asio submodule and avoid exporting Asio API
• Improve Windows installers
• Ease Google Fuzz integration
• Improve Doxygen documentation on lifetime of pointers created with RTPSDomain
• Update Fast CDR to v1.0.21

2.3.1:

• Added Fast DDS Statistics Module implementation
• Fixed alignment issues on generated code calculation of maximum serialized size
• Fixed calculation of data-sharing domain id
• Fixed issues on data-sharing with volatile writers
• Fixed build issues on old compilers
• Fixed some tests when the library is built without security
• Fixed and exposed pull mode on writers
• Fixed handling of –data_sharing on latency test
• Fixed calculation of memory pools sizes on debug builds
• Correctly update memory policy on writers and readers

2.3.0:

• Unique network flows
• Discovery super-client
• Statistics module API
• New flow controller API
• Static discovery configuration from raw string
• Added reception timestamp to SampleInfo
• Exposing get_unread_count on DataReader
• Data-sharing delivery internal refactor
• Additional metadata on persistence databases
• Refactor on ReturnCode_t to make it switch friendly
• Performance tests refactored to use DDS-PIM high-level API
• Receive const pointers on delete_xxx methods
• Discovery server improvements
• Made SOVERSION follow major.minor

 2.2.0

• Data Sharing delivery (avoids transport encapsulation for localhost communications)
• Complete DDS-PIM high-level API declarations
• Extension APIs allowing zero-copy delivery (both intra-process and inter-process)
• Upgrade to Quality Level 1

2.1.0

• Support persistence for large data
• Added support for on_requested_incompatible_qos and on_offered_incompatible_qos
• SKIP_DEFAULT_XML environment variable
• Added FORCE value to THIRDPARTY cmake options
• New log consumer (StdOutErrConsumer)
• Added methods to get qos defined in XML Profile
• Support for persistence on TRANSIENT_LOCAL
• Internal refactor for intra-process performance boost
• Allow usage of foonathan/memory library built without debug tool
• Large data support on performance tests

2.0.2

• Improve QNX support
• Security improvements
• Fast DDS Quality Declaration (QL 2)
• Large traffic reduction when using Discovery Server (up to 85-90% for large deployments)
• Configuration of Clients of Discovery Server using an environment variable
• A CLI for Fast DDS:
  • This can be used to launch a discovery server
  • Clean SHM directories with one command
• Shared memory transport enabled by default
• Solved edge-case interoperability issue with CycloneDDS
• Add package.xml

2.0.1

• Fixed sending GAPs to late joiners
• Fixed asserting liveliness on data reception
• Avoid calling OpenSSL_add_all_algorithms() when not required

2.0.0

• Added support for register/unregister/dispose instance
• Added DDS compliant API. This new API exposes all the functionality of the Publisher-Subscriber Fast RTPS API adhering to the Data Distribution Service (DDS) version 1.4 specification
• Added Security Logging Plugin (contributed by Cannonical Ltd.)
• Bump to FastCDR v1.0.14

1.10.0:

• New built-in Shared memory Transport (SHM)
• Transport API refactored to support locator iterators
• Added subscriber API to retrieve info of first non-taken sample
• Added parameters to fully avoid dynamic allocations
• History of built-in endpoints can be configured
• Bump to FastCDR v1.0.13.
• Bump to Fast-RTPS-Gen v1.0.4.
• Require CMake 3.5 but use policies from 3.13

1.9.3:

• Participant discovery filtering flags.
• Intra-process delivery mechanism opt-in.

1.9.2:

• Multiple initial PDP announcements.
• Flag to avoid builtin multicast.

1.9.1:

• Fast-RTPS-Gen is now an independent project.
• Header eClock.h is now marked as deprecated.

1.9.0:

• Partial implementation of allocation QoS
• Implementation of Discovery Server

1.8.1:

• Implementation of Liveliness QoS

1.8.0:

• Implementation of IDL 4.2
• Implementation of Deadline QoS
• Implementation of Lifespan QoS
• Implementation of Disable positive acks QoS
• Secure sockets on TCP transport (TLS over TCP)

1.7.2:

• Bug fixing

1.7.1:

• Bug fixing
• Support for QNX

1.7.0:

• TCP Transport: Fast RTPS on WAN.
• Dynamic Topic Types: Define your topic data type at runtime.
• DDS Security 1.1 compliance: Latest DDS security specification.

1.6.0:

• Persistence: Saves your sent messages in a database for late use.
• Better Security: Finer Access Control.
• Performance improvements: Even better latency and jitter.

1.5.0:

• Easier Configuration of Fast RTPS entities through XML profiles.
• Improved Reliability protocol: Added piggybacked heartbeat support.

1.4.0:

• Security: Authentication and encryption support. DDS Security Specification compliant. 
• Cpp 11 Support.
• Removed Boost Libraries Dependencies.
• Android Support
• Improved performance for large data.

1.3.1:

• New examples that illustrate how to tweak Fast RTPS towards different applications.
• Improved support for embedded Linux.
• Bug fixing.

1.3.0

• Unbound Arrays support: Now you can send variable size data arrays.
• Extended Fragmentation Configuration: It allows you to setup a Message/Fragment max size different to the standard 64Kb limit.
• Improved logging system: Get even more introspection about the status of your communications system.
• Static Discovery: Use XML to map your network and keep discovery traffic to a minimum.
• Stability and performance improvements: A new iteration of our built-in performance tests will make benchmarking easier for you.
• ReadTheDocs Support: We improved our documentation format and now our installation and user manuals are available online on ReadTheDocs.

 

Release notes

2.6.7 Stable Release

• Free and Open Source: Apache 2.0 License
• Commercial Support Available.

Main Features

• High performance. See the performance benchmarks in the product page.
• Multi-Platform: Windows, Linux, Mac OS, iOS, Android, Raspbian.
• Easy to use: Hello world video tutorial available in the product page.
• Full DDS & RTPS compliance: OMG DDS1-4 & RTPS 2.2 Compliant. Best Effort and Reliable Communications in both Unicast and Multicast.
• DDS Security Support.

What is new:

This release includes the following features:

1. Support Autofill port (automatically set a port) for TCP Transport.

2. Define a super client by environment variable

3. Support TCP Discovery server CLI and environment variable

4. Define methods (environment variable, rtps layer, xml) to configure transport scenarios

5. Secure discovery server

This release includes the following improvements:

1. Log warning message upon receiver resource creation failure.

2. Add tests for reconnection with same GUID

3. Use foonathan memory manager for reducing allocations in SharedMemManager.hpp

4. Simplify code in CDRMessage.

5. Rerun failed tests with ctest option instead of colcon’s.

6. Several improvements on CI jobs.

7. Upgrade CMake minimum requirement to 3.16.3

8. Update PR checklist template. Backports and Description

This release includes the following bugfixes:

1. Fix DomainParticipant::register_remote_type return when negotiating type.

2. Fix RemoteBuiltinEndpointHonoring blackbox test.

3. Allow participant profiles with no rtps tag.

4. Fix bad-free when receiving malformed DATA submessage.

5. Fix clang warnings

6. Use STL implementation of Timed/RecursiveTimedMutex when MSVC >= 19.36.

7. Fix encapsulation format in WLP.

8. Fix the clang build for clang 14.

9. Notify data-sharing listener at the end of a successful matching in intraprocess.

10. Updatable disable_positive_acks period.

11. Fix Data Race when updating liveliness changed in WLP.

12. Fix TCP sender resources creation.

13. Fix flow controllers unit tests compilation when using Fast CDR from thirdparty.

14. Add XML parser bit_bound bounds check.

15. Use FASTRTPS_NO_LIB on unittest root folder.

16. Use SO_EXCLUSIVEADDRUSE for Win32 unicast listening sockets.

17. Fix mac address overflow on windows.

18. Fix PubSubAsReliable test.

19. Fix FileWatchTest.

20. Add missing thread include.

21. Fix missing mandatory attribute check in XML parser struct type.

22. Better handling of trigger events in docs CI.

23. Fix memory problem when ciphering payload

24. Select correct .repos file on push events

25. Update TLS unit test certificates

26. Fix bad-free when receiving malformed DATA_FRAG submessage

27. Fix data race on writer destruction while sending heartbeat

28. Fix DiscoveryServer list access deadlock

29. Fix c++11 support for fast discovery server tool

30. Fix CVE-2023-50257

31. Fix std::move warning

32. Fix Github Windows CI

See the full release notes for more details.

Prior versions:

2.6.6:

• Improve validation on PID_PROPERTY_LIST deserialization.
• Improved CPU usage of timed events thread.
• Improved performance on intraprocess + data-sharing.
• Explicitly register type object in ContentFilteredTopicExample.
• Improve installer generation with documentation version fallback.
• Improve content filter expression parameters checks and verbosity.

This release includes the following bugfixes:

• Fixed long-standing reconnection issues on SHM transport.
• Correctly resolve alias in DDSQLFilter.
• Fixed partition copy in QoS.
• Added length checks to prevent nullptr memcpy calls.
• Fixed XMLParser null-dereference when parsing log configuration.
• Fixed SHM in 32-bit architectures.
• Added missing cstdint include.
• Avoid double definition of FASTDDS_ENFORCE_LOG_INFO.
• Fixed statistics data_count with data-sharing.

2.6.1:

This release includes the following improvements:

• Support for writer side content filtering
• Support hexadecimal values on SQL filter
• Support for DataWriter::get_key_value()
• Support for DataReader::lookup_instance()
• Support for SampleLostStatus on DataReader
• Improved doxygen documentation

This release includes the following bugfixes:

• Fixed several lock order inversion issues
• Fixed data race when closing UDP channels
• Fixed empty partition validation checks
• Fixed corner case with reliable writers and samples with a huge number of fragments
• Other minor fixes and improvements

2.6.0:

• Allow modifying remote server locators at runtime
• Add statistics physical information to DATA[p] using properties
• Content filter discovery information RTPS API
• Endpoint discovery RTPS API
• on_sample_lost RTPS API
• Transport layer API extension
• XML support for Fast DDS CLI
• New exchange format to reduce bandwidth in Static Discovery
• Support lowercase keywords on SQL filter
• Separate initialization and enabling of BuiltinProtocols
• Support for octet vectors on XML parser
• Update README and roadmap
• Fix recommended statistics DataReaderQos to enable backwards compatibility
• Fixes for supporting Python bindings in Windows platforms
• Fix publishing physical data on statistics topic
• etc.

2.5.1:

• ContentFilterTopic filtering at the DataReader side
• Release lifecycle
• XML parser fixes
• Discovery Server fixes
• Fix DataSharing sample validation

2.5.0:

• Support for PKCS#11 format URIs for private keys
• Added interfaces for content filter APIs
• Allow new network interfaces to be detected at runtime
• New API on DataWriter to wait for a specific instance to be acknowledged
• Added interfaces for concatenation of transports
• Allow XML profiles to be loaded from a string
• Allow disabling piggyback heartbeat on XML and DataWriter QoS
• New basic configuration example

2.4.1:

• Fixed several flaky tests
• Improved bandwidth usage of GAPs and HEARTBEATs
• Correctly implement delete_contained_entities
• Use native inter-process on Windows
• Improved performance of unregister_instance
• Improved OSS-fuzz integration
• Support for partitions on DataWriterQoS and DataReaderQoS
• Some documentation improvements
• Removed unused macro to avoid naming clashes

2.4.0:

• Conditions and Wait-sets implementation.
• Flow controllers.
• Configure Discovery Server locators using names.
• Modifying remote servers list at run time.
• Environment file override.
• Allow setting custom folder for data-sharing files.
• Allow setting persistence guid with static discovery.
• Check for NDEBUG in logInfo.
• Removed old unused CMake code.
• Fixed TLS behavior on TCP example.
• Prepare API for easy integration of python bindings.
• Improved statistics performance.

2.3.4:

• Support of googletest using colcon
• Network latency reports source participant
• Update Fast DDS Gen to v2.0.2

2.3.3:

• Added more durability kinds in Static Discovery xml parser
• Explicitly enable/disable data-sharing on performance tests
• Allow fully qualified name in TypeDescriptor
• Added missing DynamicData::get_union_id() method
• Change log severity in DiscoveryServer first announcement
• Several corrections to README

2.3.2:

• Statistics Module
• Update Asio submodule and avoid exporting Asio API
• Improve Windows installers
• Ease Google Fuzz integration
• Improve Doxygen documentation on lifetime of pointers created with RTPSDomain
• Update Fast CDR to v1.0.21

2.3.1:

• Added Fast DDS Statistics Module implementation
• Fixed alignment issues on generated code calculation of maximum serialized size
• Fixed calculation of data-sharing domain id
• Fixed issues on data-sharing with volatile writers
• Fixed build issues on old compilers
• Fixed some tests when the library is built without security
• Fixed and exposed pull mode on writers
• Fixed handling of –data_sharing on latency test
• Fixed calculation of memory pools sizes on debug builds
• Correctly update memory policy on writers and readers

2.3.0:

• Unique network flows
• Discovery super-client
• Statistics module API
• New flow controller API
• Static discovery configuration from raw string
• Added reception timestamp to SampleInfo
• Exposing get_unread_count on DataReader
• Data-sharing delivery internal refactor
• Additional metadata on persistence databases
• Refactor on ReturnCode_t to make it switch friendly
• Performance tests refactored to use DDS-PIM high-level API
• Receive const pointers on delete_xxx methods
• Discovery server improvements
• Made SOVERSION follow major.minor

 2.2.0

• Data Sharing delivery (avoids transport encapsulation for localhost communications)
• Complete DDS-PIM high-level API declarations
• Extension APIs allowing zero-copy delivery (both intra-process and inter-process)
• Upgrade to Quality Level 1

2.1.0

• Support persistence for large data
• Added support for on_requested_incompatible_qos and on_offered_incompatible_qos
• SKIP_DEFAULT_XML environment variable
• Added FORCE value to THIRDPARTY cmake options
• New log consumer (StdOutErrConsumer)
• Added methods to get qos defined in XML Profile
• Support for persistence on TRANSIENT_LOCAL
• Internal refactor for intra-process performance boost
• Allow usage of foonathan/memory library built without debug tool
• Large data support on performance tests

2.0.2

• Improve QNX support
• Security improvements
• Fast DDS Quality Declaration (QL 2)
• Large traffic reduction when using Discovery Server (up to 85-90% for large deployments)
• Configuration of Clients of Discovery Server using an environment variable
• A CLI for Fast DDS:
  • This can be used to launch a discovery server
  • Clean SHM directories with one command
• Shared memory transport enabled by default
• Solved edge-case interoperability issue with CycloneDDS
• Add package.xml

2.0.1

• Fixed sending GAPs to late joiners
• Fixed asserting liveliness on data reception
• Avoid calling OpenSSL_add_all_algorithms() when not required

2.0.0

• Added support for register/unregister/dispose instance
• Added DDS compliant API. This new API exposes all the functionality of the Publisher-Subscriber Fast RTPS API adhering to the Data Distribution Service (DDS) version 1.4 specification
• Added Security Logging Plugin (contributed by Cannonical Ltd.)
• Bump to FastCDR v1.0.14

1.10.0:

• New built-in Shared memory Transport (SHM)
• Transport API refactored to support locator iterators
• Added subscriber API to retrieve info of first non-taken sample
• Added parameters to fully avoid dynamic allocations
• History of built-in endpoints can be configured
• Bump to FastCDR v1.0.13.
• Bump to Fast-RTPS-Gen v1.0.4.
• Require CMake 3.5 but use policies from 3.13

1.9.3:

• Participant discovery filtering flags.
• Intra-process delivery mechanism opt-in.

1.9.2:

• Multiple initial PDP announcements.
• Flag to avoid builtin multicast.

1.9.1:

• Fast-RTPS-Gen is now an independent project.
• Header eClock.h is now marked as deprecated.

1.9.0:

• Partial implementation of allocation QoS
• Implementation of Discovery Server

1.8.1:

• Implementation of Liveliness QoS

1.8.0:

• Implementation of IDL 4.2
• Implementation of Deadline QoS
• Implementation of Lifespan QoS
• Implementation of Disable positive acks QoS
• Secure sockets on TCP transport (TLS over TCP)

1.7.2:

• Bug fixing

1.7.1:

• Bug fixing
• Support for QNX

1.7.0:

• TCP Transport: Fast RTPS on WAN.
• Dynamic Topic Types: Define your topic data type at runtime.
• DDS Security 1.1 compliance: Latest DDS security specification.

1.6.0:

• Persistence: Saves your sent messages in a database for late use.
• Better Security: Finer Access Control.
• Performance improvements: Even better latency and jitter.

1.5.0:

• Easier Configuration of Fast RTPS entities through XML profiles.
• Improved Reliability protocol: Added piggybacked heartbeat support.

1.4.0:

• Security: Authentication and encryption support. DDS Security Specification compliant. 
• Cpp 11 Support.
• Removed Boost Libraries Dependencies.
• Android Support
• Improved performance for large data.

1.3.1:

• New examples that illustrate how to tweak Fast RTPS towards different applications.
• Improved support for embedded Linux.
• Bug fixing.

1.3.0

• Unbound Arrays support: Now you can send variable size data arrays.
• Extended Fragmentation Configuration: It allows you to setup a Message/Fragment max size different to the standard 64Kb limit.
• Improved logging system: Get even more introspection about the status of your communications system.
• Static Discovery: Use XML to map your network and keep discovery traffic to a minimum.
• Stability and performance improvements: A new iteration of our built-in performance tests will make benchmarking easier for you.
• ReadTheDocs Support: We improved our documentation format and now our installation and user manuals are available online on ReadTheDocs.