multiboot2头在ELF文件偏移过大超出32KiB检测范围如何解决

问题根本原因 #

你当前的链接脚本仅约束了段在虚拟内存中的布局顺序，没有控制段在ELF文件内的存储偏移。GNU ld默认会以系统页大小（通常4KiB）对齐段的文件偏移，同时如果没有显式定义程序头规则，程序头与第一个段之间会产生大量填充空洞，导致就算.multiboot2_header是第一个逻辑段，实际文件偏移也会远大于32KiB。

解决方案 #

按以下两步调整即可：

1. 修改链接脚本，显式定义程序头规则

调整后的链接脚本如下：

/** The "start"-symbol from start.asm. */
ENTRY(start)

/* 显式定义程序头，将multiboot2头放入第一个加载段，对齐要求仅保留multiboot2要求的8字节 */
PHDRS {
    multiboot2 PT_LOAD FILEHDR PHDRS ALIGN(8);
    kernel_rest PT_LOAD;
}

SECTIONS {
    /* 此处起始虚拟地址按你内核的实际需求配置即可，不影响文件内偏移 */
    . = 0x100000;

    /* Multiboot2-Header must be 64-bit (8 byte) aligned according to spec. */
    .multiboot2_header ALIGN(8) :
    {
        *(.multiboot2_header)
    } :multiboot2 /* 归属到第一个程序头 */

    .text :
    {
        *(.text)
    } :kernel_rest

    /* 其余段规则保持不变即可 */
}

2. 调整链接参数，修改最大页对齐配置

调用ld时添加参数 -z max-page-size=8，强制ld按8字节对齐段的文件偏移，取消默认4KiB对齐带来的大段填充。
如果是通过cargo配置链接参数，可以在.cargo/config.toml中添加以下配置：

[target.x86_64-unknown-none]
rustflags = [
    "-C", "link-arg=-z",
    "-C", "link-arg=max-page-size=8",
]

验证方法 #

重新构建后执行readelf -WSl <目标ELF文件>，可看到.multiboot2_header的文件偏移会降到几百字节以内，必然落在32KiB的扫描范围内，执行grub-file --is-x86-multiboot2 <目标ELF文件>返回0即为识别成功。

内容的提问来源于stack exchange，提问作者phip1611