use signal

Unix signal handling with polling-based API.

Signals are caught and stored as flags. Use pending() to check if a signal was received, and clear() to reset the flag.

Example:

use signal

fn main() {
    signal::SigInt signal::trap
    "Running. Press Ctrl+C to stop." print nl

    loop {
        signal::SigInt signal::pending if {
            "Shutting down" print nl
            signal::SigInt signal::clear
            break
        }
    }
}

Constants

Functions

fn clear

Clear the pending flag for a signal.

Signature: (signum:i64 -- )

Example:

signal::SigInt signal::clear

fn ignore

Ignore the specified signal completely.

Signature: (signum:i64 -- )

Example:

signal::SigPipe signal::ignore

fn pending

Check if a signal is pending (received but not cleared). Returns 1 if pending, 0 otherwise. Does not clear the flag.

Signature: (signum:i64 -- flag:i64)

Example:

signal::SigInt signal::pending

fn reset

Reset signal to default behavior.

Signature: (signum:i64 -- )

Example:

signal::SigInt signal::reset

fn trap

Install a handler to catch the specified signal. After trapping, the signal sets a pending flag instead of causing the default action (e.g., termination).

Signature: (signum:i64 -- )

Example:

signal::SigInt signal::trap

fn wait

Block until any trapped signal is received. Returns the signal number that was received.

Signature: ( -- signum:i64)

Example:

signal::wait  // sig