elf_loader 0.15.0

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

use super::{LinkPassPlan, ReorderAccess};
use crate::{
    linker::scan::{ArenaDescriptor, ArenaId, ArenaUsage},
    relocation::RelocationArch,
};
use core::marker::PhantomData;

/// An arena handle created through a reorder-capable pass.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Arena<'plan> {
    id: ArenaId,
    marker: PhantomData<fn(&'plan ())>,
}

impl<'plan> Arena<'plan> {
    #[inline]
    pub(super) const fn new(id: ArenaId) -> Self {
        Self {
            id,
            marker: PhantomData,
        }
    }

    #[inline]
    pub(in crate::linker) const fn id(self) -> ArenaId {
        self.id
    }
}

impl<'scope> Arena<'scope> {
    /// Returns this arena's descriptor through `plan`.
    #[inline]
    pub fn descriptor<'borrow, K, S, Arch>(
        self,
        plan: &'borrow LinkPassPlan<'scope, K, S, Arch>,
    ) -> &'borrow ArenaDescriptor
    where
        K: Clone + Ord,
        S: ReorderAccess,
        Arch: RelocationArch,
    {
        plan.plan.memory_layout().arena(self.id)
    }

    /// Returns this arena's derived usage summary through `plan`.
    #[inline]
    pub fn usage<K, S, Arch>(self, plan: &LinkPassPlan<'scope, K, S, Arch>) -> ArenaUsage
    where
        K: Clone + Ord,
        S: ReorderAccess,
        Arch: RelocationArch,
    {
        plan.plan.memory_layout().usage(self.id)
    }
}