30 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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和读取期间其他写入。