patina 21.1.1

Common types and functionality used in UEFI development.
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

//! Runtime Architectural Protocol
//!
//! Contains the UEFI runtime services that are callable only in physical mode.
//!
//! See <https://uefi.org/specs/PI/1.8A/V2_DXE_Architectural_Protocols.html#runtime-architectural-protocol>
//!
//! ## License
//!
//! Copyright (c) Microsoft Corporation.
//!
//! SPDX-License-Identifier: Apache-2.0
//!

use core::{ffi::c_void, sync::atomic::AtomicBool};

use crate::pi::list_entry;
use r_efi::efi;

/// Runtime Arch Protocol GUID.
pub const PROTOCOL_GUID: crate::BinaryGuid = crate::BinaryGuid::from_string("B7DFB4E1-052F-449F-87BE-9818FC91B733");

/// Allows the runtime functionality of the DXE Foundation to be contained
/// in a separate driver. It also provides hooks for the DXE Foundation to
/// export information that is needed at runtime. As such, this protocol allows
/// services to the DXE Foundation to manage runtime drivers and events.
/// This protocol also implies that the runtime services required to transition
/// to virtual mode, SetVirtualAddressMap() and ConvertPointer(), have been
/// registered into the UEFI Runtime Table in the UEFI System Table. This protocol
/// must be produced by a runtime DXE driver and may only be consumed by the DXE Foundation.
///
/// # Documentation
/// UEFI Platform Initialization Specification, Release 1.8, Section II-12.8.1
#[repr(C)]
#[derive(Debug)]
pub struct Protocol {
    /// List head for registered runtime images.
    pub image_head: list_entry::Entry,
    /// List head for registered runtime events.
    pub event_head: list_entry::Entry,
    /// Size of each memory descriptor.
    pub memory_descriptor_size: usize,
    /// Version of the memory descriptor.
    pub memory_descriptor_version: u32,
    /// Total size of the memory map.
    pub memory_map_size: usize,
    /// Physical address of the memory map.
    pub memory_map_physical: *mut efi::MemoryDescriptor,
    /// Virtual address of the memory map.
    pub memory_map_virtual: *mut efi::MemoryDescriptor,
    /// Whether virtual addressing mode is active.
    pub virtual_mode: AtomicBool,
    /// Whether system is at runtime.
    pub at_runtime: AtomicBool,
}

/// Related definition for runtime architectural protocol as the entry type
/// for the image list.
///
/// # Documentation
/// UEFI Platform Initialization Specification, Release 1.8, Section II-12.8.1
#[repr(C)]
#[derive(Debug)]
pub struct ImageEntry {
    /// Base address of the image.
    pub image_base: *mut c_void,
    /// Size of the image.
    pub image_size: u64,
    /// Relocation data for the image.
    pub relocation_data: *mut c_void,
    /// Handle associated with the image.
    pub handle: efi::Handle,
    /// Link entry in the image list.
    pub link: list_entry::Entry,
}

/// Related definition for runtime architectural protocol as the entry type
/// for the event list.
///
/// # Documentation
/// UEFI Platform Initialization Specification, Release 1.8, Section II-12.8.1
#[repr(C)]
#[derive(Debug)]
pub struct EventEntry {
    /// Type of the runtime event.
    pub event_type: u32,
    /// Task priority level for the event.
    pub notify_tpl: efi::Tpl,
    /// Notification function for the event.
    pub notify_function: efi::EventNotify,
    /// Context data for the event notification.
    pub context: *mut c_void,
    /// Event handle.
    pub event: efi::Event,
    /// Link entry in the image list.
    pub link: list_entry::Entry,
}