rlmctl-core 0.2.0

cgroup v2 limit management and the rlm-guard engine for rlmctl
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! Freeze-guard engine: watch memory pressure and proactively freeze/soft-cap
//! the non-protected app driving the pressure before the system locks up, healing
//! itself once pressure clears. Pure engine + sampler live here; the daemon loop
//! lives in the `rlm-guard` binary.

use std::path::PathBuf;

pub mod cgfs;
pub mod effector;
pub mod history;
pub mod journal;
pub mod lock;
pub mod policy;
pub mod report;
pub mod resolve;
pub mod sampler;
pub mod service;
pub mod systemd;
pub mod types;

pub use effector::Effector;
pub use journal::Journal;
pub use policy::PolicyEngine;
pub use sampler::Sampler;
pub use systemd::SystemdUser;
pub use types::{Action, Intervention, Level, ProcInfo, PsiSource, Sample, Target};

/// Default path for the guard's write-ahead restore journal.
///
/// Prefers `$XDG_STATE_HOME` (`~/.local/state` by default), matching the
/// XDG-first convention `common::Config` already uses for `config_dir()`.
/// Falls back to `/tmp/rlm` on the rare system where no state dir can be
/// resolved (e.g. `$HOME` unset) — the journal is still boot_id-guarded, so a
/// non-persistent fallback location only costs us WAL recovery across a
/// reboot in that degraded case, not correctness.
pub fn journal_path() -> PathBuf {
    dirs::state_dir()
        .unwrap_or_else(|| PathBuf::from("/tmp"))
        .join("rlm")
        .join("guard-journal.jsonl")
}

/// Path of the lock file that keeps a second `rlm-guard` from running.
/// It sits next to the journal the lock protects.
pub fn lock_path() -> PathBuf {
    journal_path().with_file_name("rlm-guard.lock")
}