Struct SignalHandler 

pub struct SignalHandler { /* private fields */ }

Handles SIGINT signals for graceful shutdown.

SignalHandler registers a handler for SIGINT that sets an internal flag when triggered. The main loop can check this flag using is_shutdown_requested() without blocking.

Thread Safety

SignalHandler is thread-safe and can be cloned to share across threads. The underlying shutdown flag uses atomic operations.

Example

let handler = SignalHandler::new()?;

// In main loop
loop {
    if handler.is_shutdown_requested() {
        // Clean up and exit
        break;
    }
    // Continue processing
}

Implementations

impl SignalHandler

pub fn new() -> Result<Self>

Creates a new SignalHandler and registers the SIGINT handler.

The handler will set an internal flag when SIGINT is received (e.g., when the user presses Ctrl+C). This flag can be checked using is_shutdown_requested().

Errors

Returns an error if the signal handler cannot be registered.

pub fn is_shutdown_requested(&self) -> bool

Checks if a shutdown has been requested (non-blocking).

Returns true if SIGINT has been received since the handler was created, false otherwise.

This method is safe to call from any thread and does not block.

Trait Implementations

impl Clone for SignalHandler

fn clone(&self) -> SignalHandler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.