多引导加载器使用手册和API清单

多引导加载器使用手册和API清单

概述

多引导加载器是一个支持多种架构（BIOS/UEFI）、多种文件系统（FAT32/EXT2）和多种操作系统格式（ELF/PE）的现代化引导解决方案。

功能特性

1. 架构支持

· ✅ BIOS 传统引导

· ✅ UEFI 现代引导

· ✅ UEFI 安全启动

· ✅ 多架构检测和初始化

2. 文件系统支持

· ✅ FAT12/16/32 完整支持

· ✅ EXT2/3/4 基础支持

· ✅ 文件系统自动检测

· ✅ 统一文件操作接口

3. 操作系统支持

· ✅ Linux ELF 格式加载

· ✅ Windows PE 格式加载

· ✅ 多操作系统引导菜单

· ✅ 引导参数管理

4. 用户界面

· ✅ 图形化菜单系统

· ✅ 文本模式回退

· ✅ 动画效果支持

· ✅ 主题和样式系统

5. 高级功能

· ✅ 内存管理优化

· ✅ 错误处理和恢复

· ✅ 引导阶段管理

· ✅ 模块化架构

快速开始

1. 环境要求

# 开发工具

sudo apt-get install build-essential nasm qemu-system-x86_64

# 交叉编译工具

sudo apt-get install gcc-multilib g++-multilib

# UEFI开发库

sudo apt-get install gnu-efi

2. 构建项目

# 克隆项目

git clone https://github.com/your-username/multi-bootloader.git

cd multi-bootloader

# 配置构建

make config ARCH=x86_64 TARGET=uefi

# 构建项目

make all

# 构建特定目标

make bios # BIOS版本

make uefi # UEFI版本

make debug # 调试版本

3. 安装部署

# 创建启动磁盘

sudo make disk

# 安装到UEFI系统

sudo make install

# 创建虚拟机测试

make qemu

4. 配置文件示例

创建 /boot/loader.cfg:

```ini

[global]

timeout = 10

default_boot = windows

theme = dark

language = en

animation = true

[display]

mode = graphics

resolution = 1024x768

refresh_rate = 60

[menu]

style = modern

font_size = 16

background = /boot/background.bmp

[os:windows]

name = Windows 11

type = windows

path = \EFI\Microsoft\Boot\bootmgfw.efi

params = /noexecute=optin /fastdetect

icon = \EFI\BOOT\icons\windows.bmp

[os:ubuntu]

name = Ubuntu 22.04 LTS

type = linux  

path = \EFI\ubuntu\grubx64.efi

params = quiet splash

icon = \EFI\BOOT\icons\ubuntu.bmp

API 清单

核心架构 API

架构检测和管理

```c

// 检测系统架构

architecture_context_t* architecture_detect(void);

// 初始化架构

error_code_t architecture_init(architecture_context_t* ctx);

// 获取架构信息

const char* architecture_get_name(BOOT_ARCHITECTURE arch);

uint64_t architecture_get_memory_size(architecture_context_t* ctx);

// 清理架构资源

void architecture_cleanup(architecture_context_t* ctx);

错误处理系统

// 错误代码定义

typedef enum {

    ERROR_SUCCESS = 0,

    ERROR_OUT_OF_MEMORY = -2,

    ERROR_FS_NOT_FOUND = -100,

    ERROR_BOOT_INVALID_SIGNATURE = -200,

    // ... 更多错误代码

} error_code_t;

// 错误处理函数

error_info_t error_get_last(void);

void error_set(error_code_t code, const char* message, const char* file, uint32_t line);

void error_clear(void);

const char* error_to_string(error_code_t code);

// 错误检查宏

#define ERROR_CHECK(expr)

#define ERROR_SET(code, msg)

#define ERROR_RETURN(code, msg)

内存管理

// 内存检测

memory_map_t* memory_detect(void);

// 内存分配

void* memory_alloc(size_t size);

void* memory_alloc_aligned(size_t size, size_t alignment);

void* me