Files
UniXNU/docs/zh/reference/index.md

3.8 KiB

技术参考

从这里查找一次修改对应的文件、操作步骤和验证方法。完整流程见移植设备和构建与启动;板级参数与当前结果见设备列表。

1. 找到配置或实现

修改内容 文件或实现 操作步骤
本地输入路径 主仓库 unixnu.local.toml 配置构建输入
设备、SoC 或组件选择 设备 board.toml、feeds.toml、configs/ 解析设备配置
硬件资源 SoC DTSI 和板级 DTS 设备树
驱动行为 所选组件或设备 package 适配硬件、开发驱动
内核行为 所属 profile 或组件的补丁序列 修改 XNU
XNU 启动参数 [payload] kernel_args 或本地 [build] kernel_args 应用启动参数
启动菜单或 kit payload 的 EFI/UniXNU/unixnu.toml、kit 的 Kit.toml 启动配置
设备支持记录 设备 porting.toml 与主仓库 devices.toml 更新和发布记录
文档 主仓库 docs/ 中英文页面 编辑和发布文档

完成结果: 编辑前确定文件归属和对应操作步骤。

2. 查阅对应规范

内容 参考文档
构建工具 命令与参数、配置字段、输出路径与报告
组件 组件目录与源码身份、仓库和组件页面
驱动接口 UEFI 驱动、内置 XNU 驱动、kext 包、设备树匹配
XNU 源码与补丁归属、补丁目录、4 KiB 页表
启动与镜像格式 启动链、预链接、payload、userdata 布局、启动配置
完整性 trust cache 与启动策略
项目结构 仓库归属、术语

字段表列出可用值和路径,操作顺序与构建命令见对应步骤链接。

3. 验证受影响的输出

在主仓库中选定目标设备,运行:

./unixnu status --json

核对设备、OS profile、配置、模块来源和输出目录,再执行对应验证:

改动 验证方法 预期结果
内核、驱动或补丁 构建内核,再按启动验证顺序检查 内核与预链接成功,受影响的设备检查点单独记录
固件或 payload 构建与启动 更新的 FD、payload 和启动镜像使用指定输入
启动参数 检查 payload 配置 打包后的 args 与预期命令行一致
公共 UEFI 行为 QEMU 操作步骤 所选场景出现预期日志标记
适配记录或文档 记录检查、站点构建 记录验证和文档构建通过

步骤失败时按故障排查处理,保存命令、输入版本和相关日志。