elf_loader 0.15.1

A no_std-friendly ELF loader, runtime linker, and JIT linker for 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

/// ELF lifecycle functions associated with `.init`, `.init_array`, `.fini`, or `.fini_array`.
#[derive(Clone, Copy)]
pub struct Lifecycle<'a> {
    func: Option<fn()>,
    func_array: Option<&'a [fn()]>,
}

impl<'a> Lifecycle<'a> {
    #[inline]
    pub(crate) const fn new(func: Option<fn()>, func_array: Option<&'a [fn()]>) -> Self {
        Self { func, func_array }
    }

    #[inline]
    pub(crate) const fn empty() -> Self {
        Self::new(None, None)
    }

    /// Returns the single initialization/finalization function.
    #[inline]
    pub fn func(&self) -> Option<fn()> {
        self.func
    }

    /// Returns the array of initialization/finalization functions.
    #[inline]
    pub fn func_array(&self) -> Option<&'a [fn()]> {
        self.func_array
    }

    /// Address of the single lifecycle function, if present.
    #[inline]
    pub fn func_addr(&self) -> Option<usize> {
        self.func.map(|func| func as usize)
    }

    /// Addresses from the lifecycle function array.
    #[inline]
    pub fn func_array_addrs(&self) -> impl Iterator<Item = usize> + '_ {
        self.func_array
            .unwrap_or(&[])
            .iter()
            .map(|func| *func as usize)
    }
}