dev-gpio-lease:公开工程合同

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 GPIO租约接口

O pin direction附着,pin0..255、direction0输入/1输出;已active优先-EALREADY,参数错误-EINVAL。先SYSFS op1 export(pin),EBUSY表示借用(owned0)并继续,新导出owned1,其他错误终止。再op2 direction(direction),失败时仅owned1调用op5 unexport(pin)回滚(回滚故障忽略,保留原错误),不建立客户端租约。成功更新active/owned/pin/direction,保留累计计数。借用不会覆盖后端原pin。D direction要求active否则-ENODEV,非法方向-EINVAL,成功op2并更新方向。W level要求active、输出方向(否则-EPERM)、level0/1(否则-EINVAL),按此顺序;op3 a=level、传1字节ASCII '0'/'1',成功更新写数与last。R要求active,op4 a0读1字节ASCII并返回,成功更新读数及last。X关闭,inactive幂等;owned1需op5成功后关闭,借用不unexport;关闭清active/owned,其他槽保留并closes加1。

client槽依次active,owned,pin,direction,writes,reads,last,closes。后端槽依次exported,pin,direction,level,0,0,0,0;GPIO故障槽0..4对应op1..5。op1已有exported返回-EBUSY,否则置exported=1并记录pin;op5清exported。其他op未exported返回-ENODEV,op3方向非输出/长度非1/非ASCII返回-EINVAL,否则改level。op4返回ASCII电平。没有自动unexport或EOF副作用。

P4 自测

printf 'O 7 1\nW 1\nR\nX\n' | ./observe;还应覆盖Z模拟已导出、关闭再附着、方向错误及F模拟中断/失败。