dev-sysfs-cursor:公开工程合同

P1 构建、边界与输入

这是软件替身工程,不连接内核、物理设备或网络。构建 make observe(C11、gcc、-O2 -Wall -Wextra -pedantic),运行 ./observe 从stdin逐行接收命令,正常EOF退出0;词法错误退出2。所有参数均为十进制int,单行≤2047字符、≤80参数。空行和以#开始的行忽略。下述合法词法但非法命令返回-EINVAL,继续处理后续输入。独立程序一次≤2000命令;构建25秒、运行20秒、评分120秒,Agent3600秒用于防挂死。

公共 lab.h 是接口和布局;client_init清空客户端状态并保留backend指针(属性/配置初始值见P3),client_apply只修改当前bank的公开状态。最终只评分client.c,其他文件恢复为本工程版本。不得依赖新增文件或改写后端。候选可以采用任何满足观察合同的实现。

P2 设备替身、故障与观察

四个相互独立bank,初选0;每bank有8个客户端int槽、8个后端int槽和256字节存储。存储初始 (17*offset+29*bank)&255;未说明的槽初值0且保持0。A bank选择0..3(client/backend同步);F index errno count设置全局故障槽0..7,errno和count非负(测试最多count=3),后续该类调用每次消耗一个并在副作用前返回-errno;count耗尽正常。所有客户端系统调用遇到-EINTR原参数重试,其余错误立即返回;失败不改变成功计数或缓存,除P3明确的部分成功及错误计数。Z slot value seed直接设置当前bank后端槽0..7,seed≥0时全存储重置为 (17*offset+seed)&255,seed<0则不改存储;用于模拟其他进程。Z参数非法返回-EINVAL。F/A非法转由client作为未知命令拒绝。

每命令输出N序号(从1连续),再输出0或多条T(调用原始观察,严格按调用顺序),再R、C、B各一行。格式为 N seq,T kind operation a result,R result length [byte...](字节十进制),C selected [bank0的8槽 ... bank3的8槽],B selected total_calls [每bank的8槽及存储sum&65535] [8组errno remaining]。T的kind、operation、a与设备副作用是backend.c::device_call的冻结公开合同;不是判分期望。trace总数包括失败和EINTR,每个命令≤64个实际调用。R无数据时length0。所有失败返回负的Linux errno,所有成功返回0。

只读wire.c负责输入解析、trace/故障队列和字节输出;console.c只路由公共控制命令和打印原始状态;codec.c严格文本整数解析与格式化。不能跳过设备调用而仅伪造客户端快照,因为公开调用序列和后端状态也属于接口。

诊断接口Q slot width返回当前client槽的低width字节小端表示(slot0..7,width1/2/4);P start count连续返回count个int32小端槽,start0..8、count0..8-start,可返回空。参数数或范围错误-EINVAL,无设备调用、不改状态。负值按二补数低位输出。诊断不计业务错误计数。

P3 sysfs属性接口

每bank初始client与backend的value为-1。W count bytes...把给定count字节作为sysfs store;count0..12且个数准确、字节0..255,否则-EINVAL。文本只能是可选单个+/-、至少一个ASCII十进制数字以及可选单个末尾LF,不容许空白、NUL或其他字符;先检查整个文本语法,语法错误-EINVAL;语法正确但超有符号32位范围-ERANGE;不改变状态或调用设备。成功解析后op1 a=value提交,成功才更改client.value并stores加1;失败保留值和计数。成功W不重置已有read快照或cursor。

R capacity要求capacity1..16否则-EINVAL;没有快照时op2 a0获取当前backend value(4字节有符号小端),成功冻结为snapshot并置snapshot_valid,之后连续R不再调用op2,直到S。文本为十进制value加LF;从cursor读取min(capacity,剩余)字节并返回,读到EOF返回空。成功每次reads加1(含EOF)、bytes_read加实际字节,cursor前进。读取不更新client.value。S重置cursor=0、snapshot_valid=0、snapshot=0,seeks加1,无设备调用。失败的捕获不移动游标、不建快照。

client槽value,cursor,snapshot_valid,snapshot,stores,reads,bytes_read,seeks;backend槽value,stores,reads,0,0,0,0,0。故障槽0..1对应op1..2;op1提交值、stores加1,op2返回值并reads加1。Z可模拟属性被其他进程改写;已经开始的读取必须继续旧快照。

P4 自测

printf 'W 5 49 50 51 52 53\nR 2\nW 3 45 55 55\nR 8\nS\nR 16\n' | ./observe;加测非法文本、整数边界、连续EOF和读取期间其他写入。