可重入事件分发与订阅代际

现场症状:分发回调中的订阅修改失败;满队列时回调补投事件被意外拒绝。此工程以显式互斥锁状态、订阅代际及可重入钩子模拟用户态事件分发器,无真实线程或时间依赖。

订阅和事件队列

四订阅槽0..3。B slot mask(mask=0..7)创建或替换订阅,active=1、mask更新、generation加一,输出 SUB slot mask generation。U slot 对活动槽置 inactive、generation加一并输出 UNSUB slot generation 0;非活动槽无操作,保留mask。队列容量8,初始 head=0。Q channel value(channel=0..2,value=-10000..10000)追加事件,成功时 posted加一并作为串行号,输出 POST serial channel value。满时 Q 被拒绝,不消耗 serial。

分发

D budget(0..8)按 FIFO 处理调用入口的至多 budget 个事件;回调期间追加的新事件即使 budget有剩余也留待下次 D。每个事件必须先从队列移除(head=(head+1)%8、count--),再快照当前四订阅。按槽升序对快照 active 且 mask包含该channel 的订阅回调;回调前还须检查当前该槽仍 active 且 generation与快照相同,避免调用已注销/替换对象。每次回调 callbacks加一并输出 CALL slot value serial。回调必须在锁外;每个弹出事件 dispatched加一,包括没有订阅者的事件。

调度钩子

A action a b 安装下一次 CALL 之后执行的一次性动作,后者覆盖前者;action=1执行B a b,action=2执行U a且b必须0,action=3执行Q a b,action=4执行D a且b必须0。参数范围与目标命令相同。动作执行前 hook_action清零。订阅修改只影响尚未回调的槽与后续事件,新订阅不能收到当前事件。回调内重入 D 不弹出事件,只使 reentered加一并输出 REENTER budget 0 0。无 CALL 时钩子保留。

输入与观察

R 清零全部状态。所有错误命令、数目/范围错误及满队列Q只使 rejected加一并输出 REJECT 命令ASCII码 0 0。合法行为不能有 LOCKED 事件,命令返回时 locked=dispatching=0。S 字段为 head、count、posted、callbacks、dispatched、rejected、reentered、hook_action、locked、dispatching,随后四槽各 active、mask、generation。

构建和命令协议

当前目录运行 make,再运行 ./concurrency-demo < smoke.txt 查看原始观察。工程使用 C11 和现有 gcc/make,无额外依赖。最终只提交并评分 engine.c;其他文件用于公开上下文,正式评分用原始副本重新构建。不要改变 engine.h 中公开签名及观察格式。

输入每行一条命令,命令为单个大写字符,参数以空格分隔;支持空行和以 # 开始的注释,数字是十进制有符号整数。协议测试只提供可被 wire 外层解析的行,单行不超过8191字节、参数不超过10个、单参数不超过520字节;领域数目和范围错误按下述规则处理。初态等于 R。

harness 在每条命令后按顺序打印事件 E step NAME a b c,再打印状态 S step ...;step 从1递增,R不重置step。未说明事件的操作只输出状态;所有事件的未用参数为0。不根据实际时间、进程号或线程调度推断行为。wire/harness 不作正确性断言。

外层输入正常处理完毕须退出0(make构建成功也退出0);wire检测到分帧错误时退出2,观察写出失败退出3。领域参数错误按领域REJECT处理后继续读取,最终仍退出0。