sel4_elf_header/
lib.rs

1//
2// Copyright 2024, Colias Group, LLC
3//
4// SPDX-License-Identifier: BSD-2-Clause
5//
6
7#![no_std]
8
9use core::ops::Range;
10use core::ptr;
11use core::slice;
12
13#[repr(C)]
14#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
15pub struct ElfHeader {
16    pub e_ident: ElfHeaderIdent,
17    pub e_type: u16,
18    pub e_machine: u16,
19    pub e_version: u32,
20    pub e_entry: usize,
21    pub e_phoff: usize,
22    pub e_shoff: usize,
23    pub e_flags: u32,
24    pub e_ehsize: u16,
25    pub e_phentsize: u16,
26    pub e_phnum: u16,
27    pub e_shentsize: u16,
28    pub e_shnum: u16,
29    pub e_shstrndx: u16,
30}
31
32#[repr(C)]
33#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
34pub struct ElfHeaderIdent {
35    pub magic: [u8; 4],
36    pub class: u8,
37    pub data: u8,
38    pub version: u8,
39    pub os_abi: u8,
40    pub abi_version: u8,
41    pub padding: [u8; 7],
42}
43
44pub const ELFMAG: [u8; 4] = [0x7f, b'E', b'L', b'F'];
45
46impl ElfHeader {
47    pub fn is_magic_valid(&self) -> bool {
48        self.e_ident.magic == ELFMAG
49    }
50
51    pub fn locate_phdrs(&'static self) -> &'static [ProgramHeader] {
52        unsafe {
53            let ptr = ptr::from_ref(self)
54                .cast::<u8>()
55                .wrapping_byte_offset(self.e_phoff as isize)
56                .cast::<ProgramHeader>();
57            slice::from_raw_parts(ptr, self.e_phnum.into())
58        }
59    }
60}
61
62#[repr(C)]
63#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
64pub struct ProgramHeader {
65    pub p_type: u32,
66    #[cfg(target_pointer_width = "64")]
67    pub p_flags: u32,
68    pub p_offset: usize,
69    pub p_vaddr: usize,
70    pub p_paddr: usize,
71    pub p_filesz: usize,
72    pub p_memsz: usize,
73    #[cfg(target_pointer_width = "32")]
74    pub p_flags: u32,
75    pub p_align: usize,
76}
77
78pub const PT_NULL: u32 = 0;
79pub const PT_LOAD: u32 = 1;
80pub const PT_TLS: u32 = 7;
81pub const PT_GNU_EH_FRAME: u32 = 0x6474_e550;
82
83impl ProgramHeader {
84    pub fn vaddr_range(&self) -> Range<usize> {
85        let start = self.p_vaddr;
86        let end = start + self.p_memsz;
87        start..end
88    }
89}