devela 0.28.0

A development substrate of coherence.
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

// devela::sys::os::linux::process::signal::handler
//
//! Defines `LinuxSigactionHandler`, and static tables.
//

#[cfg(doc)]
use crate::Linux;
use crate::{AtomicPtr, LinuxSiginfo, LinuxSignal, Ptr, c_void};

#[cfg(target_pointer_width = "32")]
crate::test_size_of!(LinuxSigactionHandler = 4 | 32);
#[cfg(target_pointer_width = "64")]
crate::test_size_of!(LinuxSigactionHandler = 8 | 64);

/// A union representing either a simple handler or a `SA_SIGINFO` handler.
#[repr(C)]
pub(crate) union LinuxSigactionHandler {
    pub(super) sa_handler: extern "C" fn(i32),
    pub(super) sa_sigaction: extern "C" fn(i32, *mut LinuxSiginfo, *mut c_void),
}

/// Simple Rust handlers indexed by signal number.
///
/// This table stores user-provided `fn(i32)` handlers registered through
/// [`Linux::sig_handler`]. They are not installed directly as kernel handlers.
/// Instead, the RT signal trampoline calls a siginfo-shaped adapter,
/// and that adapter looks up the simple handler here.
///
/// The stored pointer is the function's code address, erased through a raw pointer
/// for atomic storage. A null value means no simple handler is installed for that signal.
pub(crate) static LINUX_SIG_HANDLERS: [AtomicPtr<()>; LinuxSignal::TABLE_LEN] =
    [const { AtomicPtr::new(Ptr::null_mut()) }; LinuxSignal::TABLE_LEN];

/// RT/siginfo-shaped Rust handlers indexed by signal number.
///
/// This is the canonical dispatch table used by the kernel-facing `SA_SIGINFO`
/// trampoline. Entries registered through [`Linux::sig_handler_info`] point
/// to the user-provided info handler directly. Entries registered through
/// [`Linux::sig_handler`] point to a small adapter that discards the extra
/// signal information and then dispatches through [`LINUX_SIG_HANDLERS`].
///
/// The stored pointer is the function's code address, erased through a raw pointer
/// for atomic storage. A null value means no siginfo handler is installed for that signal.
pub(crate) static LINUX_SIGINFO_HANDLERS: [AtomicPtr<()>; LinuxSignal::TABLE_LEN] =
    [const { AtomicPtr::new(Ptr::null_mut()) }; LinuxSignal::TABLE_LEN];