mirror of
https://github.com/aydencharles/onionHEN.git
synced 2026-10-22 11:53:07 -05:00
76 lines
2.4 KiB
C
76 lines
2.4 KiB
C
/* Copyright (C) 2025 OnionHEN / LightningMods
|
|
|
|
Cross-process readiness protocol for OnionHEN services.
|
|
|
|
Services publish a named marker under /system_tmp/onionhen/ready/<name>.
|
|
Consumers wait with timeout instead of fixed sleep() races.
|
|
|
|
All runtime markers live under the shared OnionHEN system_tmp namespace.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <onion/system_tmp.h>
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <sys/types.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define ONION_READY_ROOT ONION_SYSTEM_TMP_READY_ROOT
|
|
|
|
/* Well-known service names (startup orchestration) */
|
|
#define ONION_READY_UTIL "util"
|
|
#define ONION_READY_KSTUFF "kstuff"
|
|
#define ONION_READY_DAEMON "daemon"
|
|
#define ONION_READY_TOOLBOX "toolbox"
|
|
|
|
/*
|
|
* Runtime flags (same storage as ready markers; typed names replace ad-hoc
|
|
* /system_tmp flag files).
|
|
* fps_overlay — legacy only; cleared on boot (FPS inject removed)
|
|
* util_booted — util finished at least one full start (mid-session restart detect)
|
|
*/
|
|
#define ONION_FLAG_FPS_OVERLAY "fps_overlay"
|
|
#define ONION_FLAG_UTIL_BOOTED "util_booted"
|
|
|
|
/* Publish / clear / query. name is a short token (no path separators). */
|
|
bool onion_ready_signal(const char *name);
|
|
bool onion_ready_clear(const char *name);
|
|
bool onion_ready_is_set(const char *name);
|
|
|
|
/*
|
|
* Process-instance readiness.
|
|
*
|
|
* A service publishes the PID of the process instance it initialized. A
|
|
* consumer can then distinguish a still-running initialized instance from a
|
|
* replacement process that reused the same service name. The marker remains
|
|
* compatible with onion_ready_is_set(); only its contents differ from the plain
|
|
* marker value "1".
|
|
*/
|
|
bool onion_ready_signal_pid(const char *name, pid_t pid);
|
|
bool onion_ready_read_pid(const char *name, pid_t *pid_out);
|
|
bool onion_ready_matches_pid(const char *name, pid_t pid);
|
|
|
|
/*
|
|
* Poll until marker is set or timeout_ms elapses.
|
|
* poll_ms is the sleep between checks (clamped to >= 50).
|
|
* Returns true if ready, false on timeout or invalid name.
|
|
*/
|
|
bool onion_ready_wait(const char *name, int timeout_ms, int poll_ms);
|
|
|
|
/* Wait until the marker contains exactly the expected process PID. */
|
|
bool onion_ready_wait_pid(const char *name, pid_t pid, int timeout_ms,
|
|
int poll_ms);
|
|
|
|
/* Build absolute path for a name into buf (for logging). */
|
|
bool onion_ready_path(const char *name, char *buf, size_t buflen);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|