Struct GracefulShutdown 

pub struct GracefulShutdown {
    requested: Arc<AtomicBool>,
    tx: Sender<bool>,
    rx: Receiver<bool>,
    grace_period: Duration,
}

Builder and coordinator for graceful shutdown of persistent GPU kernels.

Captures SIGTERM and SIGINT (Ctrl-C), notifies all holders of ShutdownSignal, waits for a configurable grace period, then force-terminates.

Fields

requested: Arc<AtomicBool>

tx: Sender<bool>

rx: Receiver<bool>

grace_period: Duration

Implementations

impl GracefulShutdown

pub fn new(grace_period: Duration) -> GracefulShutdown

Create a new shutdown coordinator with the given grace period.

The grace period determines how long ShutdownGuard::wait will allow after the signal fires before it returns (allowing the caller to force-terminate remaining work).

pub fn with_default_grace_period() -> GracefulShutdown

Create a shutdown coordinator with the default grace period (5 seconds).

pub fn grace_period(&self) -> Duration

Get the configured grace period.

pub fn is_shutdown_requested(&self) -> bool

Check if shutdown has already been requested.

pub fn signal(&self) -> ShutdownSignal

Obtain a ShutdownSignal that can be cloned and distributed to kernels and background tasks.

pub fn trigger(&self)

Manually trigger shutdown (useful for programmatic shutdown or testing).

pub fn install(self) -> ShutdownGuard

Install OS signal handlers and return a ShutdownGuard.

The guard spawns a background task that listens for SIGTERM and SIGINT (Ctrl-C). When a signal is received the shutdown flag is set and all ShutdownSignal holders are notified.

Call ShutdownGuard::wait to block until the grace period elapses after a signal (or until all work completes, whichever comes first).

Trait Implementations

impl Debug for GracefulShutdown

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.