From the 101 lk/man/pth code-gen sources: 63 tasks (C11 36, C++17 27, 11 canonical families), 38 skipped for scope or duplication. Each task has at least one independent contract-edge defect, boundary types rotate, and public docs state trap clauses as plain contract prose. Claude reviewed 63/63 USABLE against current digests. Difficulty is unmeasured. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
固定控制台与内存设备
- 输入为ASCII文本。每行(不含LF)最多1023字节;EOF前最后一行可无LF。行首/词间ASCII空白允许;空行、首个非空白为#及词间或数字后#起的行尾注释忽略。每个实际命令是一个非空白字节的名称及至多32个十进制整数,整数可带+/-,范围-32768..32767。损坏数字、多字符命令词、整数越界、过长行、超过32个整数属于语法错误,立即退出2,不为错误行输出;前面已完成命令的输出保留。
- 语法正确但未知命令、数量不符或控制台参数非法时,result=-4、无库调用、会话与pin不变;仍计一个命令。每个实际命令sequence从1递增。正常EOF返回0;输出失败返回3。stderr仅用于诊断,不限制内容或编码。
N:清空24个pin和模拟器,调用session_init清会话;sequence持续递增。C:调用close。L low value:直接调用physical。V n triples...直接调用validate,M n triples...直接调用mask,每个triple是pin low initial。n在0..8时必须恰有n个triple;n域外时不带triple并交库判非法。O n fail_request fail_direction triples...:按与V相同规则组成计划并调用open。两个fail参数各为0..8,0不注入失败,k表示本命令第k个该类回调失败。任一失败参数域外属于控制台非法。request阶段失败后不会进入direction阶段。A n fail_write values...:n在0..8时恰有n个值,否则不带值,由库判非法;fail_write为0..8,含义同上。注入是按该命令内write回调序号的一次故障,后续恢复write不再失败;k超过实际回调数时没有故障。值参数是否合法由库整体判断。B pin raw:pin为0..23、raw为0或1且该pin当前不属于本会话(owner不为1)时,设置外部占用owner=2、direction=1、raw保存;否则控制台非法。不会产生后端事件。N清外部占用,close不能清它。Z operation n:直接NULL指针接口观察。operation=0调用validate(NULL,n),1调用mask(NULL,n),2调用open(session,bus,NULL,n),3调用apply(session,bus,NULL,n)。其他operation控制台非法。- 每个实际命令恰输出一个JSON对象,键sequence/result/session/pins/events/arguments。JSON空白和对象键顺序不限;不输出其他stdout文本。session为
[active,count,generation,pins[8],active_low[8],logical[8]];pins为24个[owner,direction,raw];events为本命令发生的回调数组,元素是[operation,pin,raw,result],operation字符串为R(request)、D(direction)、W(write)、X(release)。arguments为本命令整数参数的调用后观察,必须保持原输入。所有数值为整数,不能以JSON布尔代替。 - 初始和N后所有状态为0。request成功把pin置为[1,0,0];遇外部/自身占用或注入失败不改pin。direction成功在owner=1时置direction=1、raw为参数;write成功要求owner=1且direction=1,仅改raw;release清owner=1的pin为[0,0,0]。所有失败回调记录result=-1且不改pin,成功记0。R与X的事件raw固定-1;D与W记录传入电平。X按合同应只用于本会话持有pin。日志上限64项,正确库单条命令不会超过此限。
- 固定观察模块负责读命令、设置故障和打印原始状态,不包含正确答案或断言。评分直接链接提交的两个C文件和该观察模块;全部公开库API及辅助接口都会独立调用,不要求特定内部实现。