Experimental support for using the client on macOS (Darwin) (#1321)

* shorter SHM names on macOS
* fix segfault on macOS when string is empty
* apple version of read exe path
* ifdef for linux specific API
* fixed test for shm and udp socket
* updated release notes

slsDetectorSoftware/CMakeLists.txt

@@ -29,7 +29,6 @@ target_link_libraries(slsDetectorObject
         slsProjectOptions
         slsSupportStatic
         pthread
-        rt
     PRIVATE
         slsProjectWarnings
 )

slsDetectorSoftware/src/CmdParser.cpp

@@ -27,6 +27,10 @@ void CmdParser::Parse(std::string s) {
     // taking s by value we can modify it.
     Reset();
 
+    // If the string is empty there is nothing to parse
+    if (s.empty())
+        return;
+
     // Are we looking at -h --help? avoid removing h from command starting
     // with h when combined with detector id (ex, 1-hostname)
     bool h = replace_first(&s, "--help", " ");

slsDetectorSoftware/src/Module.cpp

@@ -1202,7 +1202,7 @@ void Module::setDestinationUDPIP(const IpAddr ip) {
     }
     sendToDetector(F_SET_DEST_UDP_IP, ip, nullptr);
     if (shm()->useReceiverFlag) {
-        MacAddr retval(0LU);
+        MacAddr retval;
         sendToReceiver(F_SET_RECEIVER_UDP_IP, ip, retval);
         LOG(logINFO) << "Setting destination udp mac of Module " << moduleIndex
                      << " to " << retval;
@@ -1225,7 +1225,7 @@ void Module::setDestinationUDPIP2(const IpAddr ip) {
     }
     sendToDetector(F_SET_DEST_UDP_IP2, ip, nullptr);
     if (shm()->useReceiverFlag) {
-        MacAddr retval(0LU);
+        MacAddr retval;
         sendToReceiver(F_SET_RECEIVER_UDP_IP2, ip, retval);
         LOG(logINFO) << "Setting destination udp mac2 of Module " << moduleIndex
                      << " to " << retval;

slsDetectorSoftware/src/SharedMemory.h

@@ -25,15 +25,27 @@
 #include <sys/stat.h> // fstat
 #include <unistd.h>
 
-namespace sls {
-
-struct CtbConfig;
-// struct sharedDetector;
+// ********************** Defines for shared memory. **********************
+// WARNING! before chaning these search the codebase for their usage!
 
 #define SHM_IS_VALID_CHECK_VERSION 0x250820
+
+//Max shared memory name length in macOS is 31 characters
+#ifdef __APPLE__
+#define SHM_DETECTOR_PREFIX        "/sls_"
+#define SHM_MODULE_PREFIX          "_mod_"
+#else
 #define SHM_DETECTOR_PREFIX        "/slsDetectorPackage_detector_"
 #define SHM_MODULE_PREFIX          "_module_"
+#endif
+
 #define SHM_ENV_NAME               "SLSDETNAME"
+// ************************************************************************
+
+namespace sls {
+
+class CtbConfig;
+
 
 template <typename T, typename U> constexpr bool is_type() {
     return std::is_same_v<std::decay_t<U>, T>;
@@ -267,6 +279,11 @@ template <typename T> class SharedMemory {
             throw SharedMemoryError(msg);
         }
 
+        #ifdef __APPLE__
+        // On macOS, fstat returns the allocated size and not the requested size.
+        // This means we can't check for size since we always get for example 16384 bytes.
+        return;
+        #endif
         auto actual_size = static_cast<size_t>(sb.st_size);
         auto expected_size = sizeof(T);
         if (actual_size != expected_size) {

slsDetectorSoftware/tests/test-SharedMemory.cpp

@@ -38,10 +38,16 @@ void freeShm(const int dindex, const int mIndex) {
 }
 
 constexpr int shm_id = 10;
+
+//macOS does not expose shm in the filesystem
+#ifndef __APPLE__
+
 const std::string file_path =
     std::string("/dev/shm/slsDetectorPackage_detector_") +
     std::to_string(shm_id);
 
+
+
 TEST_CASE("Free obsolete (without isValid)", "[detector][shm]") {
 
     // ensure its clean to start
@@ -89,6 +95,8 @@ TEST_CASE("Free obsolete (without isValid)", "[detector][shm]") {
     }
 }
 
+#endif
+
 TEST_CASE("Create SharedMemory read and write", "[detector][shm]") {
     SharedMemory<Data> shm(shm_id, -1);
     if (shm.exists()) {
@@ -96,9 +104,9 @@ TEST_CASE("Create SharedMemory read and write", "[detector][shm]") {
     }
     shm.createSharedMemory();
 
-    const char *env_p = std::getenv("SLSDETNAME");
+    const char *env_p = std::getenv(SHM_ENV_NAME);
     std::string env_name = env_p ? ("_" + std::string(env_p)) : "";
-    CHECK(shm.getName() == std::string("/slsDetectorPackage_detector_") +
+    CHECK(shm.getName() == std::string(SHM_DETECTOR_PREFIX) +
                                std::to_string(shm_id) + env_name);
     shm()->x = 3;
     shm()->y = 5.7;
@@ -168,11 +176,11 @@ TEST_CASE("Open two shared memories to the same place", "[detector][shm]") {
 }
 
 TEST_CASE("Move SharedMemory", "[detector][shm]") {
-    const char *env_p = std::getenv("SLSDETNAME");
+    const char *env_p = std::getenv(SHM_ENV_NAME);
     std::string env_name = env_p ? ("_" + std::string(env_p)) : "";
 
     SharedMemory<Data> shm(shm_id, -1);
-    CHECK(shm.getName() == std::string("/slsDetectorPackage_detector_") +
+    CHECK(shm.getName() == std::string(SHM_DETECTOR_PREFIX) +
                                std::to_string(shm_id) + env_name);
     shm.createSharedMemory();
     shm()->x = 9;
@@ -183,13 +191,13 @@ TEST_CASE("Move SharedMemory", "[detector][shm]") {
     CHECK(shm2()->x == 9);
     REQUIRE_THROWS(
         shm()); // trying to access should throw instead of returning a nullptr
-    CHECK(shm2.getName() == std::string("/slsDetectorPackage_detector_") +
+    CHECK(shm2.getName() == std::string(SHM_DETECTOR_PREFIX) +
                                 std::to_string(shm_id) + env_name);
     shm2.removeSharedMemory();
 }
 
 TEST_CASE("Create several shared memories", "[detector][shm]") {
-    const char *env_p = std::getenv("SLSDETNAME");
+    const char *env_p = std::getenv(SHM_ENV_NAME);
     std::string env_name = env_p ? ("_" + std::string(env_p)) : "";
 
     constexpr int N = 5;
@@ -205,7 +213,7 @@ TEST_CASE("Create several shared memories", "[detector][shm]") {
 
     for (int i = 0; i != N; ++i) {
         CHECK(v[i]()->x == i);
-        CHECK(v[i].getName() == std::string("/slsDetectorPackage_detector_") +
+        CHECK(v[i].getName() == std::string(SHM_DETECTOR_PREFIX) +
                                     std::to_string(i + shm_id) + env_name);
     }
 
@@ -216,12 +224,12 @@ TEST_CASE("Create several shared memories", "[detector][shm]") {
 }
 
 TEST_CASE("Create create a shared memory with a tag") {
-    const char *env_p = std::getenv("SLSDETNAME");
+    const char *env_p = std::getenv(SHM_ENV_NAME);
     std::string env_name = env_p ? ("_" + std::string(env_p)) : "";
 
     SharedMemory<Data> shm(0, -1, "ctbdacs");
     REQUIRE(shm.getName() ==
-            "/slsDetectorPackage_detector_0" + env_name + "_ctbdacs");
+            std::string(SHM_DETECTOR_PREFIX) + "0" + env_name + "_ctbdacs");
 }
 
 TEST_CASE("Create create a shared memory with a tag when SLSDETNAME is set") {
@@ -235,7 +243,7 @@ TEST_CASE("Create create a shared memory with a tag when SLSDETNAME is set") {
     setenv(SHM_ENV_NAME, "myprefix", 1);
 
     SharedMemory<Data> shm(0, -1, "ctbdacs");
-    REQUIRE(shm.getName() == "/slsDetectorPackage_detector_0_myprefix_ctbdacs");
+    REQUIRE(shm.getName() == std::string(SHM_DETECTOR_PREFIX) + "0_myprefix_ctbdacs");
 
     // Clean up after us
     if (old_slsdetname.empty())