feat!: S11.10 SolidSyslog core onto PoolAllocator (handle API)

Bdd/Targets/Common/BddTargetInteractive.c

@@ -62,13 +62,13 @@ static int ParseCount(const char* args)
     return (count > 0) ? count : 1;
 }
 
-static void HandleSend(const char* args, const struct SolidSyslogMessage* message)
+static void HandleSend(struct SolidSyslog* handle, const char* args, const struct SolidSyslogMessage* message)
 {
     int count = ParseCount(args);
 
     for (int i = 0; i < count; i++)
     {
-        SolidSyslog_Log(message);
+        SolidSyslog_Log(handle, message);
     }
 
     printf("Sent %d message%s\n", count, (count == 1) ? "" : "s");
@@ -95,6 +95,7 @@ static void HandleSet(const char* args, BddTargetInteractiveSetHandler onSet)
 }
 
 void BddTargetInteractive_Run(
+    struct SolidSyslog* handle,
     const struct SolidSyslogMessage* message,
     FILE* input,
     BddTargetInteractiveSwitchHandler onSwitch,
@@ -121,7 +122,7 @@ void BddTargetInteractive_Run(
         const char* args = NULL;
         if (MatchCommand(line, "send", &args))
         {
-            HandleSend(args, message);
+            HandleSend(handle, args, message);
         }
         else if (onSwitch != NULL && MatchCommand(line, "switch", &args))
         {

Bdd/Targets/Common/BddTargetInteractive.h

@@ -6,6 +6,7 @@
 
 #include "ExternC.h"
 
+struct SolidSyslog;
 struct SolidSyslogMessage;
 
 EXTERN_C_BEGIN
@@ -14,6 +15,7 @@ EXTERN_C_BEGIN
     typedef bool (*BddTargetInteractiveSetHandler)(const char* name, const char* value);
 
     void BddTargetInteractive_Run(
+        struct SolidSyslog * handle,
         const struct SolidSyslogMessage* message,
         FILE* input,
         BddTargetInteractiveSwitchHandler onSwitch,

Bdd/Targets/Common/BddTargetServiceThread.c

@@ -8,11 +8,11 @@ enum
 
 // cppcheck-suppress constParameter -- volatile bool written by another thread; const would be incorrect
 // NOLINTNEXTLINE(readability-non-const-parameter) -- volatile bool written by another thread; const would be incorrect
-void BddTargetServiceThread_Run(volatile bool* shutdown, SolidSyslogSleepFunction sleep)
+void BddTargetServiceThread_Run(struct SolidSyslog* handle, volatile bool* shutdown, SolidSyslogSleepFunction sleep)
 {
     while (!(*shutdown))
     {
-        SolidSyslog_Service();
+        SolidSyslog_Service(handle);
         sleep(IDLE_YIELD_MILLISECONDS);
     }
 }

Bdd/Targets/Common/BddTargetServiceThread.h

@@ -8,7 +8,13 @@
 
 EXTERN_C_BEGIN
 
-    void BddTargetServiceThread_Run(volatile bool* shutdown, SolidSyslogSleepFunction sleep);
+    struct SolidSyslog;
+
+    void BddTargetServiceThread_Run(
+        struct SolidSyslog * handle,
+        volatile bool* shutdown,
+        SolidSyslogSleepFunction sleep
+    );
 
 EXTERN_C_END
 

Bdd/Targets/FreeRtos/main.c

@@ -172,6 +172,7 @@ static uint8_t bufferRing[SOLIDSYSLOG_CIRCULAR_BUFFER_RING_BYTES(BDD_TARGET_BUFF
  * for one Service() call per iteration; the rebuild path holds it across
  * Destroy → BlockStore_Create → Create. */
 static struct SolidSyslogMutex* lifecycleMutex = NULL;
+static struct SolidSyslog* solidSyslog = NULL;
 static volatile bool solidSyslogReady;
 /* Signals Service to self-delete BEFORE Teardown destroys the lifecycle
  * mutex. Without this, Service races against InteractiveTask: Teardown
@@ -572,7 +573,8 @@ static bool RebuildWithFileStore(void)
     }
 
     solidSyslogReady = false;
-    SolidSyslog_Destroy();
+    SolidSyslog_Destroy(solidSyslog);
+    solidSyslog = NULL;
     DestroyCurrentStore();
 
     /* Build a fresh FatFs-backed BlockStore. With the volume mounted above,
@@ -602,7 +604,7 @@ static bool RebuildWithFileStore(void)
      * sort order in target_driver.py guarantees `set no-sd` comes before
      * `set store file` so the value is final by the time we get here. */
     solidSyslogConfig.SdCount = pendingNoSd ? 1U : (sizeof(sdList) / sizeof(sdList[0]));
-    SolidSyslog_Create(&solidSyslogConfig);
+    solidSyslog = SolidSyslog_Create(&solidSyslogConfig);
     solidSyslogReady = true;
     SolidSyslogMutex_Unlock(lifecycleMutex);
     return true;
@@ -637,7 +639,8 @@ static void TeardownAll(void)
     SolidSyslogMutex_Lock(lifecycleMutex);
     solidSyslogTeardown = true;
     solidSyslogReady = false;
-    SolidSyslog_Destroy();
+    SolidSyslog_Destroy(solidSyslog);
+    solidSyslog = NULL;
     SolidSyslogOriginSd_Destroy(originSd);
     SolidSyslogTimeQualitySd_Destroy(timeQualitySd);
     SolidSyslogMetaSd_Destroy(metaSd);
@@ -866,10 +869,10 @@ static void InteractiveTask(void* argument)
         .SdCount = pendingNoSd ? 1U : (sizeof(sdList) / sizeof(sdList[0])),
     };
     SolidSyslog_SetErrorHandler(ErrorHandler, NULL);
-    SolidSyslog_Create(&solidSyslogConfig);
+    solidSyslog = SolidSyslog_Create(&solidSyslogConfig);
     solidSyslogReady = true;
 
-    BddTargetInteractive_Run(&testMessage, stdin, BddTargetSwitchConfig_SetByName, OnSet);
+    BddTargetInteractive_Run(solidSyslog, &testMessage, stdin, BddTargetSwitchConfig_SetByName, OnSet);
 
     /* Peak stack usage report on `quit`. Captured into every BDD run's QEMU
      * console output so stack regressions surface in bdd-freertos-qemu logs
@@ -924,7 +927,7 @@ static void ServiceTask(void* argument)
         }
         if (solidSyslogReady)
         {
-            SolidSyslog_Service();
+            SolidSyslog_Service(solidSyslog);
         }
         SolidSyslogMutex_Unlock(lifecycleMutex);
         vTaskDelay(pdMS_TO_TICKS(1));

Bdd/Targets/Linux/main.c

@@ -66,11 +66,12 @@ static void GetTimeQuality(struct SolidSyslogTimeQuality* timeQuality)
 }
 
 static volatile bool shutdown_flag;
+static struct SolidSyslog* solidSyslog;
 
 static void* ServiceThreadEntry(void* arg)
 {
     volatile bool* shutdown = (volatile bool*) arg;
-    BddTargetServiceThread_Run(shutdown, SolidSyslogPosixSleep);
+    BddTargetServiceThread_Run(solidSyslog, shutdown, SolidSyslogPosixSleep);
     return NULL;
 }
 
@@ -264,7 +265,7 @@ int main(int argc, char* argv[])
         .Sd = sdList,
         .SdCount = sdCount,
     };
-    SolidSyslog_Create(&config);
+    solidSyslog = SolidSyslog_Create(&config);
 
     shutdown_flag = false;
     haltExit = options.HaltExit;
@@ -279,12 +280,12 @@ int main(int argc, char* argv[])
         .Msg = options.Msg,
     };
 
-    BddTargetInteractive_Run(&message, stdin, BddTargetSwitchConfig_SetByName, NULL);
+    BddTargetInteractive_Run(solidSyslog, &message, stdin, BddTargetSwitchConfig_SetByName, NULL);
 
     shutdown_flag = true;
     pthread_join(serviceThread, NULL);
 
-    SolidSyslog_Destroy();
+    SolidSyslog_Destroy(solidSyslog);
     SolidSyslogOriginSd_Destroy(originSd);
     SolidSyslogTimeQualitySd_Destroy(timeQuality);
     SolidSyslogMetaSd_Destroy(metaSd);

Bdd/Targets/Windows/BddTargetWindows.c

@@ -66,6 +66,7 @@ static const char* const THRESHOLD_MARKER_PATH = "Bdd/output/solidsyslog_thresho
 
 static uint8_t bufferRing[SOLIDSYSLOG_CIRCULAR_BUFFER_RING_BYTES(BDD_TARGET_BUFFER_MESSAGES)];
 static volatile bool shutdownFlag;
+static struct SolidSyslog* solidSyslog;
 
 /* Created in CreateSender, destroyed in DestroySender — held in file scope so
    teardown can reach them after the SwitchingSender wraps them all. */
@@ -83,7 +84,7 @@ static struct SolidSyslogBlockDevice* storeBlockDevice;
 // NOLINTNEXTLINE(readability-non-const-parameter) -- _beginthreadex thread-entry signature requires void*
 static unsigned __stdcall ServiceThreadEntry(void* arg)
 {
-    BddTargetServiceThread_Run((volatile bool*) arg, SolidSyslogWindowsSleep);
+    BddTargetServiceThread_Run(solidSyslog, (volatile bool*) arg, SolidSyslogWindowsSleep);
     return 0;
 }
 
@@ -333,7 +334,7 @@ int BddTargetWindows_Run(int argc, char* argv[])
         .Sd = sdList,
         .SdCount = sdCount,
     };
-    SolidSyslog_Create(&config);
+    solidSyslog = SolidSyslog_Create(&config);
 
     shutdownFlag = false;
     HANDLE serviceThread = (HANDLE) _beginthreadex(NULL, 0, ServiceThreadEntry, (void*) &shutdownFlag, 0, NULL);
@@ -345,13 +346,13 @@ int BddTargetWindows_Run(int argc, char* argv[])
         .Msg = options.Msg,
     };
 
-    BddTargetInteractive_Run(&message, stdin, BddTargetSwitchConfig_SetByName, NULL);
+    BddTargetInteractive_Run(solidSyslog, &message, stdin, BddTargetSwitchConfig_SetByName, NULL);
 
     shutdownFlag = true;
     WaitForSingleObject(serviceThread, INFINITE);
     CloseHandle(serviceThread);
 
-    SolidSyslog_Destroy();
+    SolidSyslog_Destroy(solidSyslog);
     SolidSyslogOriginSd_Destroy(originSd);
     SolidSyslogTimeQualitySd_Destroy(timeQuality);
     SolidSyslogMetaSd_Destroy(metaSd);

CLAUDE.md

@@ -310,8 +310,8 @@ live under `Core/Interface/`; platform-specific helpers (the `SolidSyslogPosix*`
 
 | Header | Audience | Provides |
 |---|---|---|
-| `SolidSyslog.h` | Application code that logs events | `SolidSyslogMessage`, `SolidSyslog_Log`, `SolidSyslog_Service` |
-| `SolidSyslogConfig.h` | System setup code | `SolidSyslogConfig`, `SolidSyslog_Create`, `SolidSyslog_Destroy` |
+| `SolidSyslog.h` | Application code that logs events | `SolidSyslogMessage`, `SolidSyslog_Log(handle, message)`, `SolidSyslog_Service(handle)`. `struct SolidSyslog` opaque. |
+| `SolidSyslogConfig.h` | System setup code | `SolidSyslogConfig`, `SolidSyslog_Create(config) → handle`, `SolidSyslog_Destroy(handle)`. Instance struct lives in a library-internal static pool (E11; tunable `SOLIDSYSLOG_POOL_SIZE`, default `1U`). Pool-exhaustion fallback is a TU-private `NullInstance` wired to `SolidSyslogNull{Buffer,Sender,Store}_Get()` siblings — `_Log`/`_Service` against it dispatch through Null vtables and silently drop. |
 | `SolidSyslogError.h` | Any code installing a handler to react to library-internal errors (NULL guards, send failures); also the library-internal call site for emitting them | `SolidSyslogErrorHandler` typedef, `SolidSyslog_SetErrorHandler(handler, context)`, `SolidSyslog_Error(severity, message)`. Default handler is a silent no-op; setting `handler = NULL` restores the default. Single global slot — intended for setup-time configuration, not synchronised with concurrent `Error` calls. |
 | `SolidSyslogConfigLock.h` | Setup code on systems where library-internal config-time critical sections (E11 pool `_Create`/`_Destroy` slot walks) may race across tasks or cores. Single-task setup needs nothing — defaults are no-ops. | `SolidSyslogConfigLockFunction` typedef (zero-arg `void(void)`), `SolidSyslog_SetConfigLock(lockFn, unlockFn)`, `SolidSyslog_LockConfig()`, `SolidSyslog_UnlockConfig()`. Pair API: both handlers installed together. `NULL` on either side restores that side's no-op default. Single global slot — intended for setup-time configuration, not synchronised with concurrent installs. Integrators wire `taskENTER_CRITICAL`/`taskEXIT_CRITICAL` (FreeRTOS), `pthread_mutex_lock`/`unlock` on a static `pthread_mutex_t` (POSIX), `EnterCriticalSection`/`LeaveCriticalSection` on a static `CRITICAL_SECTION` (Windows), or a spinlock pair. This is the only synchronisation primitive available to the Mutex and AtomicCounter pools for their own pool walks — chicken-and-egg eliminates their own injectables. |
 | `SolidSyslogStringFunction.h` | Any code needing the string-callback typedef | `SolidSyslogStringFunction` (callback writes into a `SolidSyslogFormatter*`) — used by `SolidSyslogConfig` (hostname/appName/processId), `SolidSyslogMetaSdConfig` (language), `SolidSyslogOriginSdConfig` |

Core/Interface/SolidSyslog.h

@@ -6,6 +6,8 @@
 
 EXTERN_C_BEGIN
 
+    struct SolidSyslog;
+
     struct SolidSyslogMessage
     {
         enum SolidSyslogFacility Facility;
@@ -14,8 +16,8 @@ EXTERN_C_BEGIN
         const char* Msg;
     };
 
-    void SolidSyslog_Log(const struct SolidSyslogMessage* message);
-    void SolidSyslog_Service(void);
+    void SolidSyslog_Log(struct SolidSyslog * handle, const struct SolidSyslogMessage* message);
+    void SolidSyslog_Service(struct SolidSyslog * handle);
 
 EXTERN_C_END
 

Core/Interface/SolidSyslogConfig.h

@@ -9,6 +9,7 @@
 
 EXTERN_C_BEGIN
 
+    struct SolidSyslog;
     struct SolidSyslogBuffer;
     struct SolidSyslogFormatter;
     struct SolidSyslogSender;
@@ -28,8 +29,8 @@ EXTERN_C_BEGIN
         size_t SdCount;
     };
 
-    void SolidSyslog_Create(const struct SolidSyslogConfig* config);
-    void SolidSyslog_Destroy(void);
+    struct SolidSyslog* SolidSyslog_Create(const struct SolidSyslogConfig* config);
+    void SolidSyslog_Destroy(struct SolidSyslog * handle);
 
 EXTERN_C_END
 

Core/Interface/SolidSyslogTunablesDefaults.h

@@ -28,6 +28,26 @@
 #error "SOLIDSYSLOG_MAX_MESSAGE_SIZE must be >= 64"
 #endif
 
+/*
+ * Number of SolidSyslog instances the library's internal static pool
+ * can simultaneously hold. Each instance is a small bookkeeping struct
+ * (collaborator pointers + SD array pointer + count).
+ *
+ * Most integrators only ever create one SolidSyslog per process; default 1.
+ * Bump via SOLIDSYSLOG_USER_TUNABLES_FILE if the integrator needs multiple
+ * concurrent SolidSyslog instances.
+ *
+ * Floor: 1. Sub-floor values rejected at compile time.
+ */
+#ifndef SOLIDSYSLOG_POOL_SIZE
+/* NOLINTNEXTLINE(cppcoreguidelines-macro-usage) -- macro form required for preprocessor visibility (floor #if) and C array-size const-expr. */
+#define SOLIDSYSLOG_POOL_SIZE 1U
+#endif
+
+#if SOLIDSYSLOG_POOL_SIZE < 1
+#error "SOLIDSYSLOG_POOL_SIZE must be >= 1"
+#endif
+
 /*
  * Number of SolidSyslogCircularBuffer instances the library's internal
  * static pool can simultaneously hold. Each instance is a small

Core/Source/CMakeLists.txt

@@ -1,5 +1,6 @@
 set(SOURCES
     SolidSyslog.c
+    SolidSyslogStatic.c
     SolidSyslogError.c
     SolidSyslogConfigLock.c
     SolidSyslogSwitchingSender.c