[eclipse-iceoryx#528] Add C++ binding

iceoryx2-ffi/cxx/include/iox2/enum_translation.hpp

@@ -31,6 +31,7 @@
 #include "iox2/service_builder_publish_subscribe_error.hpp"
 #include "iox2/service_error_enums.hpp"
 #include "iox2/service_type.hpp"
+#include "iox2/signal_handling_mode.hpp"
 #include "iox2/subscriber_error.hpp"
 #include "iox2/type_variant.hpp"
 #include "iox2/unable_to_deliver_strategy.hpp"
@@ -1432,6 +1433,32 @@ inline auto from<iox2::WaitSetRunError, const char*>(const iox2::WaitSetRunError
     return iox2_waitset_run_error_string(iox::into<iox2_waitset_run_error_e>(value));
 }
 
+template <>
+inline constexpr auto from<iox2::SignalHandlingMode, iox2_signal_handling_mode_e>(
+    const iox2::SignalHandlingMode value) noexcept -> iox2_signal_handling_mode_e {
+    switch (value) {
+    case iox2::SignalHandlingMode::Disabled:
+        return iox2_signal_handling_mode_e_DISABLED;
+    case iox2::SignalHandlingMode::HandleTerminationRequests:
+        return iox2_signal_handling_mode_e_HANDLE_TERMINATION_REQUESTS;
+    }
+
+    IOX_UNREACHABLE();
+}
+
+template <>
+inline constexpr auto from<int, iox2::SignalHandlingMode>(const int value) noexcept -> iox2::SignalHandlingMode {
+    const auto variant = static_cast<iox2_signal_handling_mode_e>(value);
+
+    switch (variant) {
+    case iox2_signal_handling_mode_e_DISABLED:
+        return iox2::SignalHandlingMode::Disabled;
+    case iox2_signal_handling_mode_e_HANDLE_TERMINATION_REQUESTS:
+        return iox2::SignalHandlingMode::HandleTerminationRequests;
+    }
+
+    IOX_UNREACHABLE();
+}
 } // namespace iox
 
 #endif

iceoryx2-ffi/cxx/include/iox2/node.hpp

@@ -28,6 +28,7 @@
 #include "iox2/service_builder.hpp"
 #include "iox2/service_name.hpp"
 #include "iox2/service_type.hpp"
+#include "iox2/signal_handling_mode.hpp"
 
 namespace iox2 {
 /// The central entry point of iceoryx2. Represents a node of the iceoryx2
@@ -84,6 +85,10 @@ class NodeBuilder {
     /// is specified the [`Config::global_config()`] is used.
     IOX_BUILDER_OPTIONAL(Config, config);
 
+    /// Defines the [`SignalHandlingMode`] for the [`Node`]. It affects the [`Node::wait()`] call
+    /// that returns any received signal via its [`NodeWaitFailure`]
+    IOX_BUILDER_OPTIONAL(SignalHandlingMode, signal_handling_mode);
+
   public:
     NodeBuilder();
     NodeBuilder(NodeBuilder&&) = default;

iceoryx2-ffi/cxx/include/iox2/signal_handling_mode.hpp

@@ -0,0 +1,30 @@
+// Copyright (c) 2024 Contributors to the Eclipse Foundation
+//
+// See the NOTICE file(s) distributed with this work for additional
+// information regarding copyright ownership.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Apache Software License 2.0 which is available at
+// https://www.apache.org/licenses/LICENSE-2.0, or the MIT license
+// which is available at https://opensource.org/licenses/MIT.
+//
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+
+#ifndef IOX2_SIGNAL_HANDLING_MODE_HPP
+#define IOX2_SIGNAL_HANDLING_MODE_HPP
+
+#include <cstdint>
+
+namespace iox2 {
+/// Defines how signals are handled by constructs that might register a custom
+/// [`SignalHandler`]
+enum class SignalHandlingMode : uint8_t {
+    /// The signals `SIGINT` and `SIGTERM` are registered and handled. If such a Signal is received
+    /// the user will be notified.
+    HandleTerminationRequests,
+    /// No signal handler will be registered.
+    Disabled,
+};
+} // namespace iox2
+
+#endif

iceoryx2-ffi/cxx/include/iox2/waitset.hpp

@@ -13,13 +13,15 @@
 #ifndef IOX2_WAITSET_HPP
 #define IOX2_WAITSET_HPP
 
+#include "iox/builder_addendum.hpp"
 #include "iox/duration.hpp"
 #include "iox/expected.hpp"
 #include "iox2/callback_progression.hpp"
 #include "iox2/file_descriptor.hpp"
 #include "iox2/internal/iceoryx2.hpp"
 #include "iox2/listener.hpp"
 #include "iox2/service_type.hpp"
+#include "iox2/signal_handling_mode.hpp"
 #include "iox2/waitset_enums.hpp"
 
 namespace iox2 {
@@ -230,6 +232,11 @@ class WaitSet {
 
 /// The builder for the [`WaitSet`].
 class WaitSetBuilder {
+    /// Defines the [`SignalHandlingMode`] for the [`WaitSet`]. It affects the
+    /// [`WaitSet::wait_and_process()`] and [`WaitSet::wait_and_process_once()`] calls
+    /// that returns any received [`Signal`] via its [`WaitSetRunResult`] return value.
+    IOX_BUILDER_OPTIONAL(SignalHandlingMode, signal_handling_mode);
+
   public:
     WaitSetBuilder();
     ~WaitSetBuilder() = default;

iceoryx2-ffi/cxx/src/node.cpp

@@ -142,6 +142,11 @@ auto NodeBuilder::create() const&& -> iox::expected<Node<T>, NodeCreationFailure
         iox2_node_builder_set_config(&m_handle, &m_config.value().m_handle);
     }
 
+    if (m_signal_handling_mode.has_value()) {
+        iox2_node_builder_set_signal_handling_mode(
+            &m_handle, iox::into<iox2_signal_handling_mode_e>(m_signal_handling_mode.value()));
+    }
+
     iox2_node_h node_handle {};
     const auto ret_val = iox2_node_builder_create(m_handle, nullptr, iox::into<iox2_service_type_e>(T), &node_handle);
 

iceoryx2-ffi/cxx/src/waitset.cpp

@@ -11,6 +11,8 @@
 // SPDX-License-Identifier: Apache-2.0 OR MIT
 
 #include "iox2/waitset.hpp"
+#include "iox/into.hpp"
+#include "iox2/enum_translation.hpp"
 #include "iox2/internal/callback_context.hpp"
 
 namespace iox2 {
@@ -153,6 +155,11 @@ WaitSetBuilder::WaitSetBuilder()
 
 template <ServiceType S>
 auto WaitSetBuilder::create() const&& -> iox::expected<WaitSet<S>, WaitSetCreateError> {
+    if (m_signal_handling_mode.has_value()) {
+        iox2_waitset_builder_set_signal_handling_mode(
+            &m_handle, iox::into<iox2_signal_handling_mode_e>(m_signal_handling_mode.value()));
+    }
+
     iox2_waitset_h waitset_handle {};
     auto result = iox2_waitset_builder_create(m_handle, iox::into<iox2_service_type_e>(S), nullptr, &waitset_handle);