rt-watchdog

Crates.iort-watchdog
lib.rsrt-watchdog
version0.1.0
sourcesrc
created_at2023-12-29 17:56:32.375336
updated_at2023-12-29 17:56:32.375336
descriptionReal-time userspace watchdog for Rust.
homepage
repository
max_upload_size
id1083519
size26,376
Heyang Zhou (losfair)

documentation

README

rt-watchdog

Real-time userspace watchdog for Rust. Currently supported platforms are x86-64 Linux and AArch64 Linux.

  • The watchdog thread runs with the SCHED_DEADLINE scheduler, guaranteeing the highest real-time priority.
  • Code and data pages used by the watchdog thread are mlock-ed.

If a tick is missed, the current process is immediately aborted.

An option is provided to fall back to a simple, non-realtime implementation on unsupported platforms.

Usage

use std::sync::atomic::Ordering;
use std::time::Duration;

let ctx = rt_watchdog::start_watchdog(
  rt_watchdog::Strategy::RealtimeOrFallback,
  Duration::from_millis(100),
);

loop {
  ctx.counter.fetch_add(1, Ordering::SeqCst);
  std::thread::sleep(Duration::from_millis(90));
}

The process must have the CAP_SYS_NICE capability to use the deadline scheduler. Add the capability to an executable with:

sudo setcap "cap_sys_nice=eip" ./myapp
Commit count: 0

cargo fmt