Skip to main content

sel4_runtime_common/
lib.rs

1//
2// Copyright 2023, Colias Group, LLC
3//
4// SPDX-License-Identifier: BSD-2-Clause
5//
6
7#![no_std]
8#![feature(cfg_target_thread_local)]
9#![feature(never_type)]
10#![feature(core_intrinsics)]
11#![feature(linkage)]
12#![allow(internal_features)]
13
14use core::sync::atomic::{AtomicBool, Ordering};
15
16use sel4_panicking_env::abort;
17
18mod abort;
19mod start;
20
21#[cfg(target_thread_local)]
22mod tls;
23
24#[cfg(panic = "unwind")]
25mod unwinding;
26
27#[cfg(not(any(
28    target_arch = "aarch64",
29    target_arch = "arm",
30    target_arch = "riscv64",
31    target_arch = "riscv32",
32    target_arch = "x86_64",
33)))]
34compile_error!("unsupported architecture");
35
36#[allow(clippy::missing_safety_doc)]
37pub unsafe fn with_local_init(f: impl FnOnce() -> !) -> ! {
38    cfg_if::cfg_if! {
39        if #[cfg(target_thread_local)] {
40            unsafe {
41                tls::with_tls(f)
42            }
43        } else {
44            f()
45        }
46    }
47}
48
49static GLOBAL_INIT_COMPLETE: AtomicBool = AtomicBool::new(false);
50
51unsafe fn global_init() {
52    #[cfg(panic = "unwind")]
53    {
54        unwinding::init_unwinding();
55    }
56
57    sel4_ctors_dtors::run_ctors().unwrap_or_else(|err| abort!("{err}"));
58
59    GLOBAL_INIT_COMPLETE.swap(true, Ordering::Release);
60}
61
62pub fn global_init_complete() -> bool {
63    GLOBAL_INIT_COMPLETE.load(Ordering::Acquire)
64}
65
66#[cfg(target_arch = "arm")]
67#[linkage = "weak"]
68#[unsafe(no_mangle)]
69extern "C" fn __aeabi_read_tp() -> usize {
70    let mut val: usize;
71    unsafe {
72        core::arch::asm!("mrc p15, 0, {val}, c13, c0, 2", val = out(reg) val); // tpidrurw
73    }
74    val
75}
76
77#[doc(hidden)]
78#[allow(unreachable_code)]
79pub unsafe fn _run_entrypoint(global_init_cond: bool, f: impl FnOnce() -> !) -> ! {
80    unsafe {
81        with_local_init(|| {
82            if global_init_cond {
83                global_init();
84            }
85            f()
86        });
87    }
88}
89
90#[macro_export]
91macro_rules! declare_rust_entrypoint {
92    {
93        $f:ident($( $i:ident: $t:ty ),* $(,)?)
94    } => {
95        $crate::declare_rust_entrypoint! {
96            $f($($i: $t,)*)
97            global_init if true
98        }
99    };
100    {
101        $f:ident($( $i:ident: $t:ty ),* $(,)?)
102        global_init if $global_init_cond:expr
103    } => {
104        const _: () = {
105            #[unsafe(no_mangle)]
106            unsafe extern "C" fn __sel4_runtime_common__rust_entrypoint($($i: $t,)*) -> ! {
107                $crate::_private::_run_entrypoint($global_init_cond, || {
108                    $f($($i,)*)
109                });
110            }
111        };
112    };
113}
114
115#[doc(hidden)]
116pub mod _private {
117    pub use super::_run_entrypoint;
118    pub use cfg_if::cfg_if;
119    pub use core::arch::global_asm;
120    pub use sel4_stack::{Stack, StackBottom};
121}