origin 0.26.2

Program startup and thread support written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Signal handlers.

#[cfg(not(target_arch = "riscv64"))]
use crate::arch;
use rustix::io;

pub use rustix::runtime::{
    KernelSigaction as Sigaction, KernelSigactionFlags as SigactionFlags, Siginfo, Signal,
};

/// A handler function type for use with [`Sigaction`].
pub type Sighandler = rustix::runtime::KernelSighandler;

/// Register a signal handler.
///
/// # Safety
///
/// yolo. At least this function handles `sa_restorer` automatically though.
pub unsafe fn sigaction(sig: Signal, action: Option<Sigaction>) -> io::Result<Sigaction> {
    unsafe {
        #[allow(unused_mut)]
        let mut action = action;

        #[cfg(not(target_arch = "riscv64"))]
        if let Some(action) = &mut action {
            action.sa_flags |= SigactionFlags::RESTORER;

            if action.sa_flags.contains(SigactionFlags::SIGINFO) {
                action.sa_restorer = Some(arch::return_from_signal_handler);
            } else {
                action.sa_restorer = Some(arch::return_from_signal_handler_noinfo);
            }
        }

        rustix::runtime::kernel_sigaction(sig, action)
    }
}

/// Return a special “ignore” signal handler for ignoring signals.
///
/// If you're looking for `sig_dfl`; use [`SigDfl`].
#[doc(alias = "SIG_IGN")]
#[must_use]
pub const fn sig_ign() -> Sighandler {
    rustix::runtime::kernel_sig_ign()
}

/// A special “default” signal handler representing the default behavior
/// for handling a signal.
///
/// If you're looking for `SigIgn`; use [`sig_ign`].
pub use rustix::runtime::KERNEL_SIG_DFL as SIG_DFL;

/// `SIGSTKSZ`
pub const SIGSTKSZ: usize = linux_raw_sys::general::SIGSTKSZ as usize;
/// `SS_DISABLE`
pub const SS_DISABLE: i32 = linux_raw_sys::general::SS_DISABLE as i32;