4.2 KiB
dev-ioctl-config:公开工程合同
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 ioctl配置接口
初始每bank client及backend槽0为100。I magic nr dir size rate mode是唯一业务命令(参数数错误-EINVAL,其他业务命令-EINVAL且不增加errors)。合法命令字仅(80,1,2,8) GET、(80,2,1,8) SET、(80,3,0,0) RESET,任一字段不符-ENOTTY,且不得调用后端。GET忽略rate/mode,op1 a0读取8字节:rate和mode各有符号32位小端,成功gets加1但不更新缓存。SET rate1..1000、mode0..3,否则-EINVAL;op2 a=rate b=mode原子更新,成功才更新客户端rate/mode、sets和generation各加1。RESET忽略rate/mode,op3 a0恢复100/0,成功更新客户端并resets和generation各加1。I命令每次失败(含错误参数数)errors加1。
client槽rate,mode,gets,sets,resets,errors,generation,0;backend槽rate,mode,gets,sets,resets,0,0,0。故障槽0..2对应op1..3;失败调用无副作用。GET不能代替SET的提交,也不得缓存失败后的拟写值。Z可模拟其他客户端更新后端;GET忠实返回后端但保持本客户端缓存。
P4 自测
printf 'I 80 2 1 8 711 3\nI 80 1 2 8 0 0\nF 1 5 1\nI 80 2 1 8 299 2\nI 80 1 2 8 0 0\n' | ./observe;检查错误方向、size、magic和失败后恢复。