link-section 0.17.2

Link-time initialized slices for Rust, with full support for Linux, macOS, Windows, WASM and many more platforms.
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
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

//! Generate a macro to add the various `used` and other attributes to a static.
#![allow(unknown_lints, edition_2024_expr_fragment_specifier)]

use crate::{__chain, __perform};

__perform!((all=() export=()), __chain[
    __add_used,
    __add_asan,
    __add_export_name[$],
    __generate_macro[$],
]);

#[cfg(linktime_used_linker)]
macro_rules! __add_used {
    (@entry next=$next:path[$next_args:tt], input=(all=($($input:tt)*) export=$export:tt)) => {
        $next!($next_args, (all=($($input)* #[used(linker)]) export=$export));
    };
}

#[cfg(not(linktime_used_linker))]
macro_rules! __add_used {
    (@entry next=$next:path[$next_args:tt], input=(all=($($input:tt)*) export=$export:tt)) => {
        $next!($next_args, (all=($($input)* #[used]) export=$export));
    };
}

#[cfg(linktime_asan)]
macro_rules! __add_asan {
    (@entry next=$next:path[$next_args:tt], input=(all=($($input:tt)*) export=$export:tt)) => {
        $next!($next_args, (all=($($input)* #[sanitize(address = "off")]) export=$export));
    };
}

#[cfg(not(linktime_asan))]
macro_rules! __add_asan {
    (@entry next=$next:path[$next_args:tt], input=$input:tt) => {
        $next!($next_args, $input);
    };
}

#[cfg(target_os = "aix")]
macro_rules! __add_export_name {
    (@entry next=$next:path[$next_args:tt], input=(all=$all:tt export=($($input:tt)*)), args=[$dollar:tt]) => {
        $next!($next_args, (all=$all export=((
            "_P", env!("CARGO_PKG_NAME"),
            "_M", ::core::module_path!(),
            "_L", line!(),
            "_C", column!()
        ))));
    };
}

#[cfg(not(target_os = "aix"))]
macro_rules! __add_export_name {
    (@entry next=$next:path[$next_args:tt], input=$input:tt, args=[$dollar:tt]) => {
        $next!($next_args, $input);
    };
}

macro_rules! __generate_macro {
    (@entry next=$next:path[$next_args:tt], input=(all=($($all:tt)*) export=($(($($export:tt)*))?)), args=[$dollar:tt]) => {
        #[doc(hidden)]
        #[macro_export]
        macro_rules! __add_linktime_attributes_to_static {
            (
                #[link_section = $link_section:expr]
                $dollar (#[$meta:meta])* $vis:vis static $ident:ident : $dollar ($static:tt)*
            ) => {
                $($all)*
                $(#[export_name = concat! (stringify!($ident), $($export)* )])?
                $dollar (#[$meta])*
                #[link_section = $link_section]
                $vis static $ident : $dollar ($static)*
            };

            (
                #[export_name = $export_name:expr]
                $dollar (#[$meta:meta])* $vis:vis static $ident:ident : $dollar ($static:tt)*
            ) => {
                #[export_name = $export_name]
                $($all)*
                $dollar (#[$meta])*
                $vis static $ident : $dollar ($static)*
            };

            (
                extern "C" {
                    #[link_name = $link_name:expr]
                    $dollar (#[$meta:meta])* $vis:vis static $ident:ident : $ty:ty;
                }
            ) => {
                #[allow(missing_unsafe_on_extern)] // MSRV
                extern "C" {
                    #[link_name = $link_name]
                    $dollar (#[$meta])* $vis static $ident : $ty;
                }
            };

            (
                $dollar ($item:tt)*
            ) => {
                $dollar ($item)*
            };
        }
    };
}

pub(crate) use __add_asan;
pub(crate) use __add_export_name;
pub(crate) use __add_used;
pub(crate) use __generate_macro;