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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

#![cfg(target_thread_local)]
#![unstable(feature = "thread_local_internals", issue = "none")]

//! 提供不具有关联的 "key" 的线程局部析构函数，这可以提高效率。
//!

// 由于看起来好像是 glibc 2.18，因此已经发布了该符号，GCC 和 clang 都使用它们在 thread_local 全局变量中调用析构函数，所以我们做同样的事情！
//
// 但是请注意，我们在许多较旧的 Linux 上运行，以及从较新的 linux 到较旧的 linux 进行交叉编译，因此我们也有一个可替代的实现。
//
//
//
//
#[cfg(any(target_os = "linux", target_os = "fuchsia", target_os = "redox"))]
pub unsafe fn register_dtor(t: *mut u8, dtor: unsafe extern "C" fn(*mut u8)) {
    use crate::mem;
    use crate::sys_common::thread_local_dtor::register_dtor_fallback;

    extern "C" {
        #[linkage = "extern_weak"]
        static __dso_handle: *mut u8;
        #[linkage = "extern_weak"]
        static __cxa_thread_atexit_impl: *const libc::c_void;
    }
    if !__cxa_thread_atexit_impl.is_null() {
        type F = unsafe extern "C" fn(
            dtor: unsafe extern "C" fn(*mut u8),
            arg: *mut u8,
            dso_handle: *mut u8,
        ) -> libc::c_int;
        mem::transmute::<*const libc::c_void, F>(__cxa_thread_atexit_impl)(
            dtor,
            t,
            &__dso_handle as *const _ as *mut _,
        );
        return;
    }
    register_dtor_fallback(t, dtor);
}

// 此实现与 sys_common/thread_local.rs 中的 register_dtor_fallback 非常相似。
// 主要区别在于我们希望将钩子转换为上述 linux 函数 _tlv_atexit 的 macOS 模拟。
//
// OSX 将在任何 TLS 插槽被释放之前，以及主线程退出时运行注册的 dtor。
//
// 不幸的是，在 tls dtor 运行时调用 _tlv_atexit 是 UB。
// 以下解决方法是每个线程通过 _tlv_atexit 注册一个自定义 DTOR 列表。
// 将 thread_local dtor 推送到 DTOR 列表，而无需调用 _tlv_atexit。
//
//
#[cfg(target_os = "macos")]
pub unsafe fn register_dtor(t: *mut u8, dtor: unsafe extern "C" fn(*mut u8)) {
    use crate::cell::Cell;
    use crate::mem;
    use crate::ptr;

    #[thread_local]
    static REGISTERED: Cell<bool> = Cell::new(false);

    #[thread_local]
    static mut DTORS: Vec<(*mut u8, unsafe extern "C" fn(*mut u8))> = Vec::new();

    if !REGISTERED.get() {
        _tlv_atexit(run_dtors, ptr::null_mut());
        REGISTERED.set(true);
    }

    extern "C" {
        fn _tlv_atexit(dtor: unsafe extern "C" fn(*mut u8), arg: *mut u8);
    }

    let list = &mut DTORS;
    list.push((t, dtor));

    unsafe extern "C" fn run_dtors(_: *mut u8) {
        let mut list = mem::take(&mut DTORS);
        while !list.is_empty() {
            for (ptr, dtor) in list {
                dtor(ptr);
            }
            list = mem::take(&mut DTORS);
        }
    }
}

#[cfg(any(target_os = "vxworks", target_os = "horizon", target_os = "emscripten"))]
#[cfg_attr(target_family = "wasm", allow(unused))] // 根据目标详细信息 (例如 wasm32-unknown-emscripten)，可能仍未使用
pub unsafe fn register_dtor(t: *mut u8, dtor: unsafe extern "C" fn(*mut u8)) {
    use crate::sys_common::thread_local_dtor::register_dtor_fallback;
    register_dtor_fallback(t, dtor);
}