210 batch-15 tasks used 119 ad-hoc family names. Each now carries one of the canonical root-cause families (11 of the 19 are used), with version + 1 and a spec.md note, and was recalibrated through both gates. Claude checked that only family, version and spec.md changed, that every family is canonical, and the new trace6 Docker receipts against current digests (210/210 USABLE). Squashed from the 36-local branch batch20-family. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
84 lines
10 KiB
Markdown
84 lines
10 KiB
Markdown
# dev-tx-frames v1
|
||
|
||
状态 CALIBRATED;难度 UNMEASURED。路线 C 原创,source `hwe/gi-dma-cache-flush-missing`;来源只提供发送前设备可见性方向,未复现真实事故。授权来自本批 BRIEF。独有 TX 服务工程,不复制原料参考解或其他新题业务骨架。
|
||
|
||
软件替身将 CPU cache 与设备 memory 分离,clean 显式按行发布,queue 仅留地址,complete 才读设备字节。保留 clean-before-submit 与完成回收知识;不验证实际 ARM cache 指令、DMA 总线、物理对齐、电气或真实时序。发送是单向;不凭空把接收 invalidate 当发送完成要求。
|
||
|
||
两处独立缺陷:初态 send 未发布 CPU 写入;初态完成回收最早挂起槽而非完成 id 的槽。后一缺陷只在公开并发与乱序完成场景暴露,默认 demo 不覆盖。only_fix_visibility 与 only_fix_release 分别只修一处。
|
||
|
||
公开行为以 template/docs/tx-contract.md 逐条合同与 tx.h 为依据;实现前冻结合同。精确行号矩阵与实际校准证据如下。
|
||
|
||
## 公开判据逐项依据
|
||
|
||
下表路径均相对任务目录;每项逐行 stdout 由 Python 独立状态与字节模型计算,C harness 仅执行公开调用并打印原始结果。表内行号都是确切行,不用笼统章节替代。所有场景一同运行,编译35秒、执行25秒、清理20秒,正式评分上限120秒。
|
||
|
||
| 判据行为 | 确切公开依据 | 输入覆盖与观察 |
|
||
| --- | --- | --- |
|
||
| C11工程、gcc构建、公开命令、正常EOF退出0 | template/docs/tx-contract.md:3;template/docs/tx-contract.md:15 | 重建tx_engine.c+port.c+main.c,进程退出码 |
|
||
| 全部tx API签名与结果结构 | template/docs/tx-contract.md:13;template/tx.h:70;template/tx.h:80 | 链接公开主程序,按声明传参 |
|
||
| 初始32、合法16/32/64复位、非法line不改状态 | template/docs/tx-contract.md:4;template/docs/tx-contract.md:15 | R16/32/64/0/17/-1,复位前后Q/P/D |
|
||
| 四槽、256容量、最低空闲槽分配 | template/docs/tx-contract.md:4;template/docs/tx-contract.md:6 | 四帧并存、第五帧BUSY、P回传slot |
|
||
| id范围1..65535、length范围1..256 | template/docs/tx-contract.md:6;template/docs/tx-contract.md:11 | 0/-1/65536、0/257、1/65535与最大长度 |
|
||
| 活跃id唯一、重复begin/full为BUSY | template/docs/tx-contract.md:6;template/docs/tx-contract.md:11 | 重复B及四槽压力后Q/P |
|
||
| 新draft覆盖清零、id及槽复用 | template/docs/tx-contract.md:6;template/docs/tx-contract.md:10 | 完成/取消后同id重建,部分写后S仍INCOMPLETE |
|
||
| W任意字节、F重复字节、合法范围 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:14 | 运行时固定种子payload、大写hex、各种边界长度 |
|
||
| 多次部分写与重叠,最后写入为准 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:16 | 分段W/F、最后单字节覆盖;D及C逐字节相等 |
|
||
| 写入范围非法不改变状态、INVALID优先 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:11 | 负offset、256、跨frame尾、零长、跨容量,后续P/Q/D |
|
||
| F值0..255 | template/docs/tx-contract.md:14;template/docs/tx-contract.md:11 | -1、256及合法随机字节 |
|
||
| pending写/填/再次send/cancel均BUSY | template/docs/tx-contract.md:8;template/docs/tx-contract.md:11 | 已发帧上的W/F/S/X,后续字节与计数不变 |
|
||
| 有洞draft不可send,完整draft方可send | template/docs/tx-contract.md:8;template/docs/tx-contract.md:11 | 未写、半写、中间三字节覆盖后的S/P |
|
||
| send后的设备视图必须为最新payload | template/docs/tx-contract.md:5;template/docs/tx-contract.md:8;template/docs/tx-contract.md:17 | D直接观察device memory,拒绝只伪造completion |
|
||
| 设备视图和CPU视图分离、queue不复制payload | template/docs/tx-contract.md:5;template/tx.h:20 | 冻结port.c真实内存端口;harness直接读取描述符memory |
|
||
| 成功completion返回id、长度、完整最新字节 | template/docs/tx-contract.md:8;template/docs/tx-contract.md:9 | 所有边界帧C id 0逐字节检查 |
|
||
| 任意完成次序、释放对应id与槽 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:16 | 四帧按3/1/0/2次序完成,每步观察所有P/D |
|
||
| 乱序完成不改变其他帧状态/覆盖/内容 | template/docs/tx-contract.md:9 | 每次完成后其他帧P/D、Q,随后其自身C |
|
||
| 失败completion返回id且无payload并释放 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:12 | 固定随机0/1状态、失败后复用、长度0与'-' |
|
||
| 非法completion status为INVALID且不释放 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:11 | -1/2之后D与最终正常C |
|
||
| draft completion为BUSY | template/docs/tx-contract.md:11 | 未发draft上C后P/Q |
|
||
| draft取消、pending拒绝取消 | template/docs/tx-contract.md:10;template/docs/tx-contract.md:11 | X后P,pending上X后D/C |
|
||
| 已完成/已取消或其他合法缺失id为ABSENT | template/docs/tx-contract.md:10;template/docs/tx-contract.md:11 | 重复C、缺失S/X/W/F/P/D |
|
||
| 所有错误无副作用 | template/docs/tx-contract.md:11 | 每个错误后Q/P/D,后续合法操作继续 |
|
||
| 成功begin/write/send/cancel逐次累计 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:12 | 重叠写也计一次,错误不计,Q比较全部字段 |
|
||
| 成功/失败完成分别累计、bytes只计成功长度 | template/docs/tx-contract.md:12 | 混合完成状态、Q精确整数 |
|
||
| 活跃draft/pending计数、inspect覆盖个数 | template/docs/tx-contract.md:12 | Q/P在每个生命周期及错误分支后 |
|
||
| inspect错误输出零字段、completion错误id/length为0 | template/docs/tx-contract.md:12 | P错误五字段、C错误id0/length0,仅有效范围 |
|
||
| reset丢弃pending并清全部计数 | template/docs/tx-contract.md:10 | live pending上R,然后P/D/C/Q |
|
||
| 命令格式、参数个数、hex/decimal校验 | template/docs/tx-contract.md:14 | 奇数hex/zz/0x、参数少/多、越int、错误符号 |
|
||
| 空白、注释无输出,错误命令ERROR | template/docs/tx-contract.md:14 | 空行与两类注释;未知Z/BB;随后Q |
|
||
| 每种stdout记录布局、空payload '-' | template/docs/tx-contract.md:15;template/docs/tx-contract.md:17 | 所有6133行输出按协议逐行检查 |
|
||
| 诊断stderr允许,不是拒绝条件 | template/docs/tx-contract.md:15 | 仅存诊断,比较stdout与退出码 |
|
||
| D只读、draft/absent为ABSENT,invalid为INVALID | template/docs/tx-contract.md:17 | 每步D,后Q/P确认无副作用 |
|
||
| 不按源代码拼写/调用次数/unused尾部判分 | template/docs/tx-contract.md:12;template/docs/tx-contract.md:16 | 仅比较输出有效字段,valid位图+逐写发布实现通过 |
|
||
|
||
## 实现、样例与边界
|
||
|
||
工程只提交tx_engine.c;其余公开支撑逐字冻结进support.json。评分器不调用gold、不读候选输出文件、不把答案放进C进程,不在控制进程导入/执行候选。固定随机种子0xD4A15;6133条输出观测覆盖45组边界payload与54组并发压力,含连续复用与恢复。该数字是独立观测行数,不冒充独立根因数。数据总量与计数不溢出uint64_t。
|
||
|
||
| 样例 | 预期 | 机制 |
|
||
| --- | --- | --- |
|
||
| gold | PASS | 字节覆盖表,send整帧clean,完成按id回收 |
|
||
| template | FAIL | 未发布设备字节;乱序完成回收最早pending槽 |
|
||
| noop | FAIL | send直接成功而无queue/state转换 |
|
||
| cheat | FAIL | 发前把payload全覆为公开常见0xa5;运行时不同字节与重叠写拒绝 |
|
||
| cheat_read_grader | FAIL正式 | 仅能读grader才正常工作;正式UID65534不可读。可信本地预期意外PASS如实保留 |
|
||
| only_fix_visibility | FAIL | 仅修发布;乱序完成丢失其他帧、错误槽回收 |
|
||
| only_fix_release | FAIL | 仅修按id回收;设备仍读旧字节 |
|
||
| mask_symptom | FAIL | completion用CPU副本覆盖回报,但D直接设备观察仍旧 |
|
||
| valid_eager_bitmap | PASS | packed bitmap跟踪覆盖,每次成功写/填立即发布相交行,send不clean;与gold批量发布的时机及数据组织不同 |
|
||
|
||
每类仅含candidate_files并均成功构建。正常初始化0x5a用于确定性旧数据,不把填充尾部是否为零当条件。发送完成不要求接收方向invalidate;不测试没有公开规定的硬件性能或真实cache指令。
|
||
|
||
隔离由逐字复制的verify.py执行;首child前写完源码与所有输入,在仍属控制端的新建build子目录设权限,不chmod已交UID65534的scratch根。首次child启动后父check不再读写scratch;cleanup由候选身份rm执行并检查returncode,失败不能打印PASS。stderr不导致行为误拒。临时目录不复用,完整重建无额外依赖。
|
||
|
||
已完成只读自审:合同边界、独立模型、全部buildable fixture、只比较公开有效范围、首child后无父端树访问、cleanup返回码必查。独立root复审待做。全库unittest按本批BRIEF由root统一执行;本单题不重复执行。真实Agent采样/完整轨迹/硬件测试/Salty归档均未做。
|
||
|
||
## 实际双门证据
|
||
|
||
- 本地:`/home/ming01.wang/embedded-rollout/.tmp/wt-batch15/runs/20261023-C-hwe-scale-15/gi-dma-cache-flush-missing/local/calibration-4037e074dc854930a9a07284bf626202`,45次;原始整体FAIL、cleanup confirmed,仅cheat_read_grader五次PASS为合同允许例外;其他40次符合预期。
|
||
- Docker:`/home/ming01.wang/embedded-rollout/.tmp/wt-batch15/runs/20261023-C-hwe-scale-15/gi-dma-cache-flush-missing/docker/calibration-d01335aea9d445d399889d901257a962`,45次全部符合预期,整体PASS、cleanup confirmed。gold与valid各5次PASS,全部7类负例各5次FAIL。
|
||
- task digest:`a5c4f30a8192f0b927f92450a1de46ac8e12b0d6a78ddbc2fcfc362222052ede`;实际image ID:`sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1`。
|
||
- 工程严格去空行/注释/纯括号后520行,其中C及头文件510行,必要Makefile10行;样例副本、docs、输入数据、Python判据及support.json编码均不计。逐文件统计见本题subagent的engineering-lines.json。
|
||
- 当前仅CALIBRATED/UNMEASURED;root独立审阅与本批统一unittest尚待执行。未采样、不提交、不推送。
|
||
|
||
族名规范化:device-tx-lifecycle → device-io(2026-10-27)
|