zfi 0.2.0

Zero-cost and safe interface to UEFI firmware
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

use crate::{system_table, Device, Guid, OpenProtocolAttributes, Path, SystemTable, IMAGE};
use core::ptr::null;

/// Represents an `EFI_HANDLE` for the image.
pub struct Image(());

impl Image {
    /// Gets the `EFI_LOADED_IMAGE_PROTOCOL` from this image.
    pub fn proto(&self) -> &LoadedImage {
        static ID: Guid = Guid::new(
            0x5B1B31A1,
            0x9562,
            0x11d2,
            [0x8E, 0x3F, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B],
        );

        let proto = unsafe {
            system_table()
                .boot_services()
                .open_protocol(
                    self as *const Image as *const (),
                    &ID,
                    IMAGE.cast(),
                    null(),
                    OpenProtocolAttributes::GET_PROTOCOL,
                )
                .unwrap()
        };

        unsafe { &*(proto as *const LoadedImage) }
    }
}

/// Represents an `EFI_LOADED_IMAGE_PROTOCOL`.
#[repr(C)]
pub struct LoadedImage {
    revision: u32,
    parent_handle: *const (),
    system_table: *const SystemTable,
    device_handle: *const (),
    file_path: *const u8,
    reserved: *const (),
    load_options_size: u32,
    load_options: *const (),
    image_base: *const u8,
}

impl LoadedImage {
    pub fn device(&self) -> &Device {
        unsafe { &*(self.device_handle as *const Device) }
    }

    pub fn file_path(&self) -> &Path {
        unsafe { Path::from_ptr(self.file_path) }
    }

    pub fn image_base(&self) -> *const u8 {
        self.image_base
    }
}