bootmgr 1.0.1

A framework for easily creating boot managers in 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
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

// SPDX-FileCopyrightText: 2025 some100 <ootinnyoo@outlook.com>
// SPDX-License-Identifier: MIT

//! An auto detector for the fallback boot loader (BOOTx64.efi, etc.)

use alloc::vec::Vec;

use const_format::formatcp;
use uefi::{CStr16, Handle, cstr16};

use crate::{
    config::{
        Config,
        builder::ConfigBuilder,
        parsers::{ConfigParser, Parsers},
    },
    system::{
        fs::UefiFileSystem,
        helper::{get_path_cstr, str_to_cstr},
    },
};

/// The configuration prefix.
const FALLBACK_PREFIX: &CStr16 = cstr16!("\\EFI\\BOOT");

/// The configuration prefix as an &str.
const FALLBACK_PREFIX_STR: &str = "\\EFI\\BOOT";

/// The configuration suffix.
const FALLBACK_SUFFIX: &str = ".efi";

/// The filename of the fallback boot program for the architecture.
const FILENAME: &str = get_filename();

/// A "parser" for detecting BOOTx64.efi, BOOTia32.efi, BOOTaa32.efi, BOOTaa64.efi
pub struct FallbackConfig;

impl ConfigParser for FallbackConfig {
    fn parse_configs(fs: &mut UefiFileSystem, handle: Handle, configs: &mut Vec<Config>) {
        let Ok(filename) = str_to_cstr(FILENAME) else {
            return; // there is no way this can fail, as filename can only be one of four strings
        };

        let Ok(path) = get_path_cstr(FALLBACK_PREFIX, &filename) else {
            return; // this also should not fail, since this path is hardcoded and valid
        };

        if fs.exists(&path)
            && let Ok(volume_label) = fs.get_volume_label()
        {
            let efi_path = formatcp!("{FALLBACK_PREFIX_STR}\\{FILENAME}");
            let title = if volume_label.is_empty() {
                &filename
            } else {
                &volume_label // prefer the volume label if it exists, so we can tell the difference between fallbacks
            };
            let config = ConfigBuilder::new(&filename, FALLBACK_SUFFIX)
                .efi_path(efi_path)
                .title(title)
                .sort_key("fallback")
                .fs_handle(handle)
                .origin(Parsers::Fallback);

            configs.push(config.build());
        }
    }
}

/// Get the filename of the fallback boot program for the current architecture.
const fn get_filename() -> &'static str {
    if cfg!(target_arch = "x86") {
        "BOOTia32.efi"
    } else if cfg!(target_arch = "x86_64") {
        "BOOTx64.efi"
    } else if cfg!(target_arch = "arm") {
        "BOOTaa32.efi"
    } else if cfg!(target_arch = "aarch64") {
        "BOOTaa64.efi"
    } else {
        ""
    }
}