amos 341a37d7c0 Add the first Qwen-measured tasks from batches 28 and 29 (2 HARD, 2 MEDIUM)
Batch 29 (Zephyr and NuttX fixes) commit 2bb22bb gave NuttX mounted-path
transactions and Zephyr NVS recovery compaction as HARD and NuttX ELF
module bindings as MEDIUM. Batch 28 commit b804230 gave Mynewt JSON
arrays as MEDIUM; four of its tasks are being topped up.

Each task comes from the commit Qwen measured, its digest matches, and it
is still present at the batch branch head.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 18:03:25 +08:00

4.4 KiB
Raw Permalink Blame History

ELF 模块的软件观察合同

这里使用 64 位 little-endian ELF 数据布局,程序头与节头均来自输入文件。host 端只装入字节、绑定符号并记录架构回调,模块中的代码、构造函数和函数描述符都不会被调用。它检验加载器的软件接口,不代表板卡或 ARM 指令验收。

R01. 模块读入须保留初始化、程序头/节头加载、段内容加载、符号绑定的调用链。ET_DYN 设置模块的 dynamic 状态,ET_REL 保持非动态状态;有效输入初始化和加载返回 0。 R02. ET_DYN 的普通动态表使用 DT_REL;PLT 表以 DT_PLTREL 区分 REL 和 RELA。FDPIC 输入的 PLT 为 REL,声明 RELA 的 FDPIC PLT 返回 -ENOEXEC。普通非 FDPIC PLT 可以使用 RELA。 R03. ET_DYN 导入先查注册的全局符号表;未命中时查调用者传入的 exports[0..nexports)。同名全局项优先于调用者项。表为空或计数为零时不产生匹配,不能借用计数以外的项。 R04. ET_DYN 中未解析的非弱导入返回 -EINVAL,未解析的弱导入写入零;解析成功写入所选择导出项的完整指针值。长符号名由可增长的 I/O 缓冲区完整读取。 R05. 地址映射以装入段为准:小于 datasec 的链接地址映射到 textalloc 加链接地址;大于等于 datasec 的地址映射到 datastart 加链接地址减 datasec。FDPIC 的文本和数据分别分配,段间的链接距离不要求在内存里保持。 R06. FDPIC 动态重定位引用对象内定义的符号时,将该符号的链接值转换为装入地址,保留其余符号字段,把映射后的 r_offset 位置交给 up_relocate。该过程适用于命名的函数符号和不命名的节符号,并保持 REL 位置中的隐式加数不变,由架构回调解释。 R07. 动态重定位没有符号索引时沿用相对重定位路径:从被重定位位置取 32 位链接值并映射,作为回调符号值。非 FDPIC 对象内定义符号沿用现有动态路径,不额外调用 FDPIC 回调。 R08. 该加载器普通非 FDPIC 动态 PLT 的 RELA 路径在映射 r_offset 后加 r_addend,导入写入或无符号回调使用这个位置。ET_REL 的 r_offset 是目标节内偏移,REL 调 up_relocate,RELA 调 up_relocateadd 并原样传递显式加数。 R09. ET_REL 的导入由调用者导出表解析;对象内定义符号的值加对应装入节的基址。缓存与分块读入不能改变每个条目的参数或顺序。 R10. 架构回调收到已解析的符号、重定位条目及目的地址。回调返回负 errno 时,绑定返回同一错误并终止后续条目;成功时返回 0。观察桩只记录参数,不修改被观察内存。 R11. 可选符号扫描允许无名条目,遍历空符号或节符号不产生错误级诊断。找到命名项返回 0 及原始 ELF 符号值;不存在返回 -ENOENT。无名项本身的名字查询仍返回 -ESRCH,可使用信息级诊断。 R12. 评分只收集 README 列出的两个源文件。现有支撑文件保持可用;额外文件不参与评分。观察程序 stdout 是原始 JSON,包含初始化/加载/绑定结果、地址、目标字与回调记录;进程退出成功不能替代这些行为。

依据

R01、R03、R09、R10 对应冻结的 include/nuttx/lib/elf.h 中 libelf_initialize/libelf_load/libelf_bind 的合同、include/nuttx/elf.h 的架构回调合同和 libs/libc/elf/elf_symbols.c 的查表注释。R05 是 libs/libc/elf/elf.h 的 libelf_addr 公开注释与映射。R02、R07、R08 对应冻结的动态表分派及回调处理;这是本工作区采用的加载器行为,不能推成所有平台通用 ABI。R04 与 R11 的未解析符号规则另可参见 ELF gABI 第 5 章的弱符号、st_name 和符号值语义。

ELF gABI 第 6.1 节定义:REL 将隐式加数存放在目标位置,RELA 单独携带显式加数;共享对象的 r_offset 使用虚拟地址,ET_REL 使用节内偏移。第 5.3 节定义节符号用于重定位;第 5.7 节说明共享对象的符号值是虚拟地址。这些条款连同本工作区的地址映射和架构回调合同构成 R06 的依据。

公开标准:ELF gABI 符号表、ELF gABI 重定位。本软件观察适配器用 EI_OSABI=65 标记 FDPIC 布局,并使用 ELF64 来容纳 host 指针;它不声称这是 ARM 可执行对象,机器类型为 EM_X86_64,输入字节永不执行。