OpenDDS 3.28.0

Download OpenDDS-3.28.zip (Windows) or OpenDDS-3.28.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Version 3.28.0 of OpenDDS

Released 2024-04-16

Read the documentation for this release on Read the Docs.

Additions

• Added an XCDR2 value writer that can be used to serialize static and dynamic samples to XCDR2 encoding format. (PR #4421)
• Added utility to flatten the index to a multi-dimensional array represented by dynamic data. (PR #4421)
• A new header, dds/OpenDDSConfig.h is generated by configure or CMake. (PR #4482, PR #4498)
  • Users manually configuring a build will need to create this file, which may be empty, or add #define OPENDDS_IGNORE_OPENDDSCONFIG_H_FILE to their ace/config.h file.
  • See dds/OpenDDSConfig.h.in for details.
• ConfigStore
  • Converted the transport and discovery loading and domain section to use ConfigStore. (PR #4488, PR #4475, PR #4469, PR #4454)
  • OpenDDS can now be configured with environment variables. (PR #4491)
    • See Configuration with Environment Variables for details.
  • OpenDDS now supports multiple config files. (PR #4505)
    • See Configuration Approach for details.
  • The ConfigStore is available in Java. (PR #4515)
• The @value(x) annotation is now supported on IDL enumerators when using the IDL-to-C++11 mapping. (PR #4519)
  • See @value(v) for details.
• The IDL for the Shapes example was updated for interoperability. (PR #4528)
• Added [rtps_discovery] SpdpUserTag. (PR #4533)
• The data type for the OpenDDS-specific Built-in ParticipantLocation Topic now includes the lease duration. (PR #4545)
  • See OpenDDSParticipantLocation Topic for details.
• Allow compile-time configuration of CLOCK_BOOTTIME as the clock used for timers (PR #4568)
  • If the platform supports it, this can be done using --boottime when building with the configure script or OPENDDS_BOOTTIME_TIMERS when building with CMake.

Platform Support and Dependencies

• Building with CMake
  • Fixed building with CMake and Apple Clang on macOS without setting -DCMAKE_CXX_STANDARD=14 or using ACE 6. (PR #4481, PR #4487)
  • Added support for C++03 and some support for building ACE/TAO with the same compiler and C++ standard as OpenDDS. (PR #4481, PR #4487)
  • Fixed building release builds on Windows at the same time as ACE/TAO (PR #4535)
  • Fixed ACE/TAO build not getting Xerces path when using OPENDDS_XERCES3. (PR #4572)

Fixes

• The ValueReader and ValueWriter interfaces now use ACE_CDR::Fixed as the type of IDL fixed values (PR #4466)
• CMake Config Package
  • Made opendds_target_sources(INCLUDE_BASE) work correctly in more cases, specifically involving generating an export header. (PR #4489)
    • Added opendds_target_sources(EXPORT_HEADER_DIR) and opendds_export_header(DIR) as part of these changes.
• Fixed bug so ConfigStore entries generated by SEDP are cleaned up. (PR #4540, PR #4485)
• Fixed bug where various RtpsDiscoveryConfig setters didn't set. (PR #4540, PR #4485)
• Fixed bug where vread for unions used uninitialized memory. (PR #4544)
• Fixed bug where an RTPS Reader gets stuck when heartbeat advances. (PR #4548)
• XCDR2 KeyOnly serialization of union that has no key now has a delimiter for appendable and mutable extensibility. (PR #4554)

Documentation

• Run-time Configuration (PR #4464, PR #4570, PR #4467, PR #4588)
  • Restructured configuration properties so they can be linked to directly.
    Also reviewed each property description to correct or add missing context as needed.
• Introduction to OpenDDS (PR #4467)
  • Added Plugins to explain generally how discovery, transports, and security libraries must be initialized when statically linking these libraries.
  • Added summaries of important information needed to use the discovery and transport libraries.
• Quality of Service (PR #4520)
  • Added Property QoS, Data Representation QoS, and Type Consistency Enforcement QoS.
  • Every policy now has a box that says if it's mutable, if it affects writer-reader association, and a link to the spec definition.
    Also removed large default value tables and put the default values in these boxes.
  • Added links to the QoS policies.
• Added definitions for instance, unregister, and dispose to the glossary. (PR #4520)
• DDS Security
  • Added summary of important information needed to use the security library. (PR #4467)
  • Moved Fnmatch Expressions into an "annex" file so it can be common between security and partitions QoS. (PR #4520)
• ConfigStore
  • Add configuration capabilities to DevGuide. (PR #4556)

OpenDDS 3.27.0

Download OpenDDS-3.27.zip (Windows) or OpenDDS-3.27.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Version 3.27.0 of OpenDDS

Released 2024-02-07

Read the documentation for this release on Read the Docs.

Additions

• Complete interfaces for dealing with DynamicData and DynamicTypes. (PR #4320, PR #4339)
• It is now possible to specify the validity for individual publish/subscribe actions in DDS Security Permission documents. This is an OpenDDS extension. (PR #4344)
• Building with CMake
  • Added new options for how to get ACE/TAO. (PR #4346)
• CMake Config Package
  • Added OPENDDS_ACE_VERSION and OPENDDS_TAO_VERSION. (PR #4346)
• Add a warning that @optional is not supported. (PR #4355)
• Convert discovery configurations (repository, static discovery, rtps_discovery including templates) to key-value store. (PR #4360, PR #4361, PR #4426, PR #4411, PR #4276, PR #4347)
• Convert ICE configuration to key-value store. (PR #4360, PR #4361, PR #4426, PR #4411, PR #4276, PR #4347)
• Change transport_template and rtps_discovery template processing to not generate new keys. (PR #4360, PR #4361, PR #4426, PR #4411, PR #4276, PR #4347)

Platform Support and Dependencies

• Improved support for configure script detection of clang on Linux (PR #4449)
• When using Visual C++, OpenDDS can now be configured using --std=c++NN (NN = 17 or 20). (PR #4452)

Fixes

• Updated the read and write semantics of DynamicData for union, expandable collections (sequence and string), and optional member of an aggregated type. (PR #4278)
• Fixed memory leak where instances were not cleaned up with exlusive ownership. (PR #4343)
• Removed the special handling for sequence members with length code of 5,6, or 7. (PR #4376)
• Reading data from a dynamic data object for a primitive type now must use MEMBER_ID_INVALID id. (PR #4376)
• create_datawriter and create_datareader check if the topic belongs to the same participant as the publisher/subscriber. (PR #4398)
• Fixed uninitialized durability_service in Topic QoS when using QoS-XML. (PR #4424)
• Fixed a bug where compiling IDL with -Lc++11 -Gequality produced code outside of a namespace that didn't compile. (PR #4450)
• SedpLocalAddress now defaults to DCPSDefaultAddress to behave like SpdpLocalAddress and local_address. (PR #4451)

Notes

• TheParticipantFactory* will now return a null pointer when DCPSConfigFile doesn't exist. (PR #4372)

OpenDDS 3.26.1

Download OpenDDS-3.26.1.zip (Windows) or OpenDDS-3.26.1.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Version 3.26.1 of OpenDDS

Released 2023-11-14

Read the documentation for this release on Read the Docs.

Fixes

• Building with CMake

  • Fixed Issue #4328, where each run of CMake effectively always appended the MPC features to default.features in ACE. (PR #4330)

• Fixed a corner case in RTPS ParameterList parsing (PR #4336)

• Reject some types of invalid RTPS DataFrag submessages (PR #4348)

OpenDDS 3.26.0

Download OpenDDS-3.26.zip (Windows) or OpenDDS-3.26.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Version 3.26.0 of OpenDDS

Released 2023-10-23

Read the documenation for this release on Read the Docs.

Additions

• OpenDDS can now be built using CMake for most common scenarios. (PR #4203, PR #4214)

  • This is still considered somewhat experimental as it doesn't support everything that an MPC-built OpenDDS currently can.
  • See Building OpenDDS Using CMake for details.

• Convert transport configurations (rtps_udp, multicast, shmem, tcp, udp) uses key-value store. (PR #4162, PR #4270, PR #4272, PR #4241, PR #4242, PR #4243, PR #4249, PR #4255)

• CMake Config Package

  • Added opendds_install_interface_files to help install IDL files and the files generated from them. (PR #4203, PR #4214)

  • Added OPENDDS_HOST_TOOLS and OPENDDS_ACE_TAO_HOST_TOOLS to allow cross compiling applications with both MPC and CMake-built OpenDDS. (PR #4203, PR #4214)

  • opendds_target_sources:

    • Added opendds_target_sources(INCLUDE_BASE) to preserve the directory structure of the IDL files for compiling the resulting generated files and installing everything using opendds_install_interface_files. (PR #4203, PR #4214)
    • Added opendds_target_sources(USE_VERSIONED_NAMESPACE) as a shortcut to the -Wb,versioning_\* IDL compiler options. (PR #4203, PR #4214)

• Support sending DynamicDataAdapter sample via DynamicDataWriter (PR #4226)

• Added export macro to ConditionImpl (PR #4295)

Deprecations

• Deprecated OPENDDS_FILENAME_ONLY_INCLUDES in favor of opendds_target_sources(INCLUDE_BASE). (PR #4203, PR #4214)

Fixes

• Improved the subject name parsing to better conform to the DDS Security spec. (PR #4201)

  • The order of attributes in subject names is now significant when comparing them.

• Remove from TypeLookupService when remote endpoint is removed from SEDP (PR #4216)

• WaitSet is now notified when DataWriter liveliness is lost. (PR #4223)

• ICE doesn't use IPv4-mapped IPv6 addresses anymore. (PR #4230)

• Efficiency: Remove per-element locking in JobQueue (PR #4253)

• RtpsRelay: fixed bug in record_activity's use of remove in GuidAddrSet (PR #4254)

• Fix warnings in typeobject_generator when using TAO 3 (PR #4262)

• Fix null pointer when participant is absent when updating locators (PR #4265)

• Initialize variables in TypeObject to silence warnings (PR #4292)

• RtpsRelay: Use ACE_Message_Block's locking strategy for cached SPDP to fix tsan warning (PR #4293)

• Fix tsan warning in ReactorTask (PR #4298)

Documentation

• Remove -Grapidjson flag [opendds_idl] (PR #4231)
• Remove reference to mailing lists (PR #4234)
• Restructured parts of DDS Security page and expanded documentation of some XML security document elements. (PR #4281)
• OS-specific instructions will now be automatically selected based on the browser's user agent. (PR #4281)
• OMG specification section references are now links to that section in the specification PDF. (PR #4281)
• Move build and install instructions to DevGuide (PR #4294)
• Incorporate the quick start guides, FAQ, and shapes demo into the DevGuide. (PR #4297)

Notes

• Using Perl 5.38.0 might prevent TAO from building properly, see here for details.

OpenDDS 3.25.0

Download OpenDDS-3.25.zip (Windows) or OpenDDS-3.25.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Version 3.25.0 of OpenDDS

Released 2023-07-20

Read the documenation for this release on Read the Docs.

Additions

• The Observer interface now has support for dispose and unregister. (PR #4137)

• OpenDDS now stores configuration information in a key-value store. (PR #4138, PR #4134, PR #4151)

  • Configuration values can be set via API, config file, or command line.

    • Currently applies to the common section and common transport configuration.

• Added encode_to_string, encode_to_bytes, decode_from_string, and decode_from_bytes to TypeSupport. (PR #4144, PR #4122, PR #4133, PR #4135)

  • These methods convert samples to and from other formats.
  • Currently only OpenDDS::DCPS::JSON_DATA_REPRESENTATION is supported.

• Add -Gequality option to opendds_idl to generate == and != for structs and unions. (PR #4154)

  • The members of the struct or union must have a type that could appear in a DDS topic and be supported by opendds_idl.
  • The motivation for this change was to make the generated code more useful as many users go on to define these operators.

• CMake Config Package

  • Added executable targets. (PR #4160)

  • OPENDDS_CMAKE_VERBOSE output has been expanded, but now accepts a list of categories to control how much is logged. (PR #4160)

  • Added opendds_export_header to generate an export header. (PR #4160)

  • opendds_target_sources:

    • Added opendds_target_sources(GENERATE_SERVER_SKELETONS) to allow tao_idl to generate code for CORBA servers. (PR #4140)
    • Added opendds_target_sources(AUTO_LINK) as a fine-grained version of OPENDDS_AUTO_LINK_DCPS. (PR #4140)
    • Added opendds_target_sources(SKIP_TAO_IDL) to disable tao_idl. (PR #4140)
    • Added opendds_target_sources(SKIP_OPENDDS_IDL) to disable opendds_idl. (PR #4140)
    • Added opendds_target_sources(USE_EXPORT) to allow overriding the generated export header with an existing one. (PR #4160)

  • Libraries and features can be passed to find_package(OpenDDS COMPONENTS) to change what is required. (PR #4160, PR #4140)

    • See Components for details.

Security

• Fixed null pointer exception caused by RTPS Parameters with incorrect zero size. (PR #4197)

Fixes

• CMake Config Package

  • Made linking dependencies and macro definitions closer match using MPC with OpenDDS and TAO. (PR #4140)
  • Fixed issues with passing OPENDDS_IDL_OPTIONS -SI to opendds_target_sources. (PR #4140)

• Fixed issue deserializing bounded sequences with JSON (PR #4150)

  • The deserialization will fail if the JSON input contains more elements than the bounded sequence can hold.

• Updated the RtpsRelay's tracking of client IP addresses so they are removed when no longer used. (PR #4202)

  • The RtpsRelay configuration option -MaxAddrSetSize was renamed to -MaxIpsPerClient

Documentation

• Moved various markdown files into the Sphinx documentation so that they are now included along with the Developer's Guide: (PR #4139)

  • INSTALL.md is now Building and Installing.
  • docs/dependencies.md is now Dependencies.
  • docs/cmake.md is now Using OpenDDS in a CMake Project.
  • docs/android.md is now Android.
  • docs/ios.md is now iOS.

• Restructured how the documentation is presented to cleanly separate the Developer's Guide and internal documentation. (PR #4139)

• Added a proper main page. (PR #4139)

• Added Glossary. (PR #4139)

• In addition to NEWS.md, started adding release notes to Release Notes. (PR #4125)

Notes

• CMake Config Package

  • OPENDDS_TARGET_SOURCES is now called opendds_target_sources. (PR #4140)

    • CMake macros and functions names are case insensitive, so this should have no effect on CMake code.

OpenDDS 3.24.2

Download OpenDDS-3.24.2.zip (Windows) or OpenDDS-3.24.2.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

The OpenDDS Developer's Guide for this version is available at https://opendds.readthedocs.io/en/dds-3.24.2

Updates in this version:

Security:

• Fixed a vulnerability in the rtps_udp transport where an acknowledgement sequence number beyond the maximum expected by the writer leads to an assert and incorrect state. (#4155)
  • Thanks to Seulbae Kim (@squizz617) for discovering this.

Fixes:

• Fixed leaked shared memory by the shared memory transport. (#4171)
  • For a 100% fix, a new ACE version including DOCGroup/ACE_TAO#2077 must be used.
• Fixed bug introduced by #4120 (#4180, #4184)
  • The fix introduced in #4120 causes the TransportClient to silently drop messages when the client's guid is not initialized.
    This causes issues for TransportClients that send messages to the transport before association.
    One such example is a DataWriter with liveliness configured.
    The DataWriter will send liveliness messages to the transport (which will be dropped) and hang waiting for them to be delivered.
  • The solution was set the guid for a TransportClient before calling any method that uses the guid.

Notes:

• #4180 required changes in InfoRepoDiscovery's IDL, so InfoRepo compatibility with older versions has been broken.

OpenDDS 3.24.1

Download OpenDDS-3.24.1.zip (Windows) or OpenDDS-3.24.1.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

The documentation for this version is available at https://opendds.readthedocs.io/en/dds-3.24.1

Updates in this version:

Fixes:

• Fixed compile warnings in TypeSupport that can happen with GCC and -O2 or higher (#4117)
• Fixed compile error in TypeSupport for IDL that contains a typedef of a typedef (#4117)
• Fixed bug in the tcp transport where readers and writers can fail to associate (#4120)
• Fixed issue in some headers that could leak #pragma pack (push, 8) into user code on Visual Studio (#4123)
• Fixed theoretical infinite loop in rtps_udp transport code (#4124)

Documentation:

• Removed invalid links and references in README and the Developer's Guide and fixed other minor issues (#4115, #4116, #4121, #4126)
• Changed theme used by the Sphinx documentation to make the Developer's Guide easier to navigate (#4127)
• Added copy buttons to embedded code and code-like examples (#4127)

OpenDDS 3.24.0

Download OpenDDS-3.24.zip (Windows) or OpenDDS-3.24.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

The OpenDDS Developer's Guide for this version is available at https://opendds.readthedocs.io/en/dds-3.24

Updates in this version:

Additions:

• The OpenDDS Developer's Guide is now available at https://opendds.readthedocs.io/ (#4051, #4094, #4092, #4100, #4101, #4095, #4103, #4102, #4104, #4105)
  • The Sphinx/reStructuredText source for this new format is now located in the repo at docs/devguide
• DOCGroup ACE6/TAO2 is now the default ACE/TAO for OpenDDS, OCI ACE/TAO is no longer supported (#4069)
• Dynamic content subscription (#3988)
  • This allows DynamicDataReaders to use QueryCondition and ContentFilteredTopic and allows DynamicDataWriters to do filtering on behalf of matched DataReaders that use ContentFilteredTopic.
• DynamicData:
  • Can now read and write enum members as strings (#4022)
  • get_int64_value and get_uint64_value can now cast from different types (#4078)
  • DynamicDataImpl now uses lazy initialization to reduce memory usage (#4024)
• Added aliases for IDL types from XTypes spec such as DDS::UInt32 (#3994)
  • See DdsDcpsCore.idl for all of them.
• Added PublicationMatchedStatus Current Count To RtpsRelay Statistics (#4006)
• Allow reassembly of overlapping fragment ranges in RTPS (#4035, #4047)
• Can now cross-compile on macOS (#4048)
• Added hardening features to RtpsRelay (#4045)
  • These are configured with the new options -MaxAddrSetSize and -RejectedAddressDuration.
• Expanded support for using C++ keywords in IDL (#4073)
• Improved support for anonymous types in unions branches (#4078)
• IDL file and generated TypeSupport.idl can now be in different directories (#4077)

Fixes:

• Fixed rtps_relay_address_change deadlocks (#3989)
• Fixed RtpsUdpTransport data race from relay_stun_mutex_ (#3990)
• Fixed invalid socket handles in RtpsUdpTransport (#4002)
• Fixed index increment in GuidPartitionTable::prepare_relay_partitions (#4005)
• Fixed a bug in content filtering with enum comparisons on serialized samples (#4038)
• Fixed transport config and transport instance derived from template conflicting (#4058)
• Improved reliability of the shared memory transport (#4028)
• Secure writers and readers in same participant can now associate (#4041)
• Fixed issue with using -o in tao_idl/opendds_idl options in OPENDDS_TARGET_SOURCES and those directories are now automatically included (#4071)
• XTypes (#4078):
  • TypeObjects struct and union members used to be sorted by member ID, but they are now sorted by declaration order as the XTypes spec calls for.
    By default member IDs increment starting at 0, and in that case the TypeObjects will be the same.
    If @autoid(hash), --default-autoid hash, or @id(ID) are being used then the order could be different.
    This could cause some reader/writer matching incompatibility with older versions of OpenDDS:
    • Topics with final and appendable structs will no longer match.
    • If DISALLOW_TYPE_COERCION QoS is being used, then all topics where the order differ will not longer match.
      Note that this is true for any time the type hash changes.
    • Pass the --old-typeobject-member-order option to opendds_idl to use the non-standard order.
  • The size of XCDR2 member parameters in mutable structs and unions is now correctly interpreted when the "length code" is 5, 6, or 7.
    • This is an optimization that OpenDDS doesn't serialize samples with, so this could only be an issue when dealing with samples from other DDS implementations.
  • DynamicDataImpl (DynamicData made by DynamicDataFactory that can be passed to DynamicDataWriter):
    • get_member_id_at_index now returns ids for members that haven't been initialized yet.
    • Fixed incorrect serialization of keyed unions for instance registration, disposal, and unregistration samples.
    • Fixed errors from serializing some cases of arrays and sequences.

Notes:

• Release files will only be uploaded to GitHub from now on
• OpenDDS::DCPS::RepoId has been removed, if needed use OpenDDS::DCPS::GUID_t instead (#3972)

OpenDDS 3.23.1

Download OpenDDS-3.23.1.zip (Windows) or OpenDDS-3.23.1.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Fixes:

• Addressed a DDS Security issue where participants can sign their own permissions file if the same CA is used for both identity and permissions (#3992)
• Addressed CVE-2023-23932, where untrusted sources can use invalid CDR strings in RTPS messages to crash OpenDDS applications (#4010, #4016, #4018)
  • Thanks to Seulbae Kim (@squizz617) for discovering this.
• Fixed an issue in DynamicData::get_*_values and print_dynamic_data (#3952)
• Fixed a bug where DynamicDataReader wouldn't be able to read a topic type with final or mutable extensibility (#3993)
• Fixed race conditions involving reference counted objects (#3999)

OpenDDS 3.23.0

Download OpenDDS-3.23.zip (Windows) or OpenDDS-3.23.tar.gz (Linux/macOS) instead of "Source code (zip)" or "Source code (tar.gz)".

Additions:

• DataRepresentationQosPolicy and TypeConsistencyEnforcementQosPolicy can be set through XML (#3763)
• RTPS send queue performance improvements (#3794)
• Cross-compiling improvements (#3853)
• New support for DynamicDataWriter and enhanced support for DynamicDataReader (#3827, #3727, #3871, #3718, #3830, #3893, #3904, #3885, #3933, #3935)
• New config option for RtpsDiscovery SpdpRequestRandomPort (#3903)
• New opendds_mwc.pl Wrapper Script (#3821, #3913)
• Improve support for loading signed documents (#3864)

Fixes:

• Unauthenticated participant leads to invalid iterator (#3748)
• Shmem Association race (#3549)
• Shmem and tcp null pointer (#3779)
• Submodule checkout on Windows (#3812)

Notes:

• Docker images are built for release tags https://github.com/objectcomputing/OpenDDS/pkgs/container/opendds (#3776)