GRUB 40_custom文件menuentry完整文档查询及chainloading故障咨询

我来帮你梳理这几个问题的解决方案和相关信息：

首先要明确：40_custom本质是GRUB的自定义配置片段，它的menuentry语法和系统自动生成的grub.cfg完全一致，所以完整的文档可以从这些本地渠道获取：

• 终端手册页：运行man grub.cfg，里面详细说明了menuentry的结构、可用参数、内置命令；或者man grub-mkconfig，会提到自定义配置文件（比如40_custom）的使用规范。
• GRUB info文档：运行info grub，里面有更全面的GRUB脚本编程和menuentry编写指南，包括各种命令的细节。
• 系统自带文档目录：通常在/usr/share/doc/grub2-common（Debian/Ubuntu系）或/usr/share/doc/grub（RHEL/CentOS系）里，会有HTML或PDF格式的详细手册。

你遇到的chainloading失败，大概率是因为加密分区需要先解锁才能被GRUB访问，结合ext3/ext4的特性，可以从这几点调整：

1. 必须先解锁加密卷：在menuentry开头添加解密命令，用加密卷的UUID挂载（可通过blkid查看带TYPE="crypto_LUKS"的条目）：

   cryptomount UUID=你的加密卷UUID
   

2. 正确引用解密后的设备：解锁后GRUB会把解密后的设备命名为cryptouuid/你的加密卷UUID，设置root时要指向这个设备（带分区号的话格式如(cryptouuid/xxxx-yyyy,gpt2)）。
3. 确认GRUB支持ext3/ext4：大部分发行版默认安装的GRUB已经包含ext3.mod和ext4.mod模块，但如果是手动编译的GRUB，需要确认这些模块已被包含。

给你一个适配加密ext4分区的chainloading示例：

menuentry "Chainload Encrypted Ext4 Partition" {
    # 解锁加密卷
    cryptomount UUID=1a2b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6
    # 设置root为解密后的第一个GPT分区
    set root='(cryptouuid/1a2b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6,gpt1)'
    # 加载目标引导器（MBR用+1，EFI则指定路径比如/EFI/boot/bootx64.efi）
    chainloader +1
    # 启动引导器
    boot
}

你注意到的几种引用方式各有适用场景：

• 相对位置（set root='(hd1)'）：GRUB按BIOS/UEFI枚举磁盘的顺序编号，hd0是第一块盘，分区格式为(hdX,msdosY)（MBR）或(hdX,gptY)（GPT）。优点是直观，缺点是磁盘顺序变化（如插U盘、换硬盘接口）会导致引用失效。
• UUID方式（set root=UUID=XXXX-YYYY）：使用普通分区的UUID（blkid可查），不受磁盘顺序影响，适合固定安装的系统，是最推荐的方式之一。
• 加密卷UUID（set root='(cryptouuid/XXXX-YYYY)'）：专门用于已解锁的加密分区，引用解密后的逻辑设备，必须配合cryptomount命令使用。

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