firma_runtime_state (root module)
Module: firma_runtime_state
Section titled “Module: firma_runtime_state”Contents
Section titled “Contents”Modules
error- Error surface for runtime state operations.pidfile- Pid-file read, write, remove, and metadata helpers.process_id- Process identifier types used by runtime state files.runtime_paths- Canonical resolution and layout of Firma runtime files.sidecar_markers- Persistence and observation of per-run sidecar markers.status- Shared coarse-grained liveness state.
Functions
resolve_state_dir- Resolve the canonical runtime-state directory and return its root path.
Module: error
Section titled “Module: error”Error surface for runtime state operations.
Module: pidfile
Section titled “Module: pidfile”Pid-file read, write, remove, and metadata helpers.
Module: process_id
Section titled “Module: process_id”Process identifier types used by runtime state files.
firma_runtime_state::resolve_state_dir
Section titled “firma_runtime_state::resolve_state_dir”Function
Resolve the canonical runtime-state directory and return its root path.
Prefer [RuntimeLayout::resolve] when callers also need to derive paths
within the runtime directory.
Errors
Section titled “Errors”Returns an error when the platform has no usable runtime-directory fallback.
fn resolve_state_dir(flag: Option<std::path::PathBuf>) -> Result<std::path::PathBuf>Module: runtime_paths
Section titled “Module: runtime_paths”Canonical resolution and layout of Firma runtime files.
Linux uses XDG_RUNTIME_DIR. macOS and Windows have no XDG equivalent;
the fallback path is /tmp/firma-$UID (Unix) or %LOCALAPPDATA%\firma\runtime
(Windows).
Module: sidecar_markers
Section titled “Module: sidecar_markers”Persistence and observation of per-run sidecar markers.
Module: status
Section titled “Module: status”Shared coarse-grained liveness state.