pub struct GuardStopHandle { /* private fields */ }Expand description
Cloneable, thread-safe handle for stopping a running guard loop.
Obtain via GuardRunner::stop_handle() before calling GuardRunner::run().
Can be sent to another thread, stored in a signal handler, or used from
an async runtime to request graceful shutdown.
§Example
use std::time::Duration;
use sysprims_proc::{
GuardRunnerConfig, GuardRunner, GuardConfig, GuardRule, GuardAction,
CpuMode,
};
let config = GuardRunnerConfig {
guard: GuardConfig {
rule: GuardRule {
root_pid: 12345,
max_levels: u32::MAX,
filter: None,
cpu_mode: CpuMode::Lifetime,
sample_duration: None,
},
action: GuardAction::KillDescendants { signal: 15, cascade: false },
action_enabled: false,
max_targets: 8,
},
interval: Duration::from_secs(5),
max_iterations: None,
};
let mut runner = GuardRunner::new(config).unwrap();
let handle = runner.stop_handle();
// Stop from another thread after 30 seconds
std::thread::spawn(move || {
std::thread::sleep(Duration::from_secs(30));
handle.stop();
});
let summary = runner.run(|event| {
println!("matched={}", event.matched);
}, |_tick, err| {
eprintln!("error: {err}");
}).unwrap();
// summary.stop_reason == StopReason::RequestedImplementations§
Source§impl GuardStopHandle
impl GuardStopHandle
Sourcepub fn stop(&self)
pub fn stop(&self)
Request the guard loop to stop gracefully.
The loop will finish the current tick and then exit with
StopReason::Requested.
Trait Implementations§
Source§impl Clone for GuardStopHandle
impl Clone for GuardStopHandle
Auto Trait Implementations§
impl Forget for GuardStopHandle
impl Freeze for GuardStopHandle
impl RefUnwindSafe for GuardStopHandle
impl Send for GuardStopHandle
impl Sync for GuardStopHandle
impl Unpin for GuardStopHandle
impl UnsafeUnpin for GuardStopHandle
impl UnwindSafe for GuardStopHandle
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more