shim 技术文档

1. 安装指南

环境准备

在开始安装前，请确保您的系统满足以下环境要求：

• 支持EFI的系统
• 具备编译环境的操作系统（如Linux）

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/LinuxUEFI/shim.git
   cd shim
   

2. 准备证书文件（如pub.cer），该文件应为DER编码的公钥证书。将其放置在项目根目录。

3. 编译项目，指定证书文件路径：

   make VENDOR_CERT_FILE=pub.cer
   

4. 编译完成后，将在项目目录生成相应的shim应用程序。

2. 项目的使用说明

使用步骤

1. 将编译好的shim应用程序放置到EFI系统分区中。

2. 修改系统启动配置，确保将shim作为第一阶段的引导程序。

3. 当系统启动时，shim将尝试加载并执行另一个应用程序。如果标准EFI的LoadImage()和StartImage()调用失败（例如，因为开启了Secure Boot且二进制文件未使用适当的密钥签名），它将验证二进制文件是否与内置证书匹配。

4. 如果验证成功，并且二进制文件或签名密钥未被禁止，shim将重新定位并执行该二进制文件。

5. shim还将安装一个协议，允许第二阶段引导程序执行类似的二进制文件验证。

3. 项目API使用文档

由于shim是一个引导加载器，其API主要是针对引导程序的开发者。以下是其主要功能的简要说明：

• 加载和执行应用程序：通过LoadImage()和StartImage()函数加载并执行另一个应用程序。
• 内置证书验证：如果标准加载失败，使用内置证书验证二进制文件。
• PCR扩展：在系统具有TPM芯片支持的情况下，shim将扩展各种PCR以包含加载目标的摘要。

详细API接口和说明，请参考项目源代码中的相关实现。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细描述。简要概括，主要包括以下步骤：

• 准备环境
• 克隆项目
• 准备证书
• 编译项目
• 安装到系统

请按照安装指南中的详细步骤进行操作。