2.0 KiB
Raw Blame History

异步日志 spool 合同

生产者用 P id length seed 投递一帧,id=0..999,length=0..32,seed=0..255;最多缓存 3 帧,先进先出,队列满则拒绝。字节 i 为 (seed+17i) mod 256,以便脱离设备复现日志内容。 队列是 3 槽环形表;head 初始 0,tail=(head+count)%3。投递保存 id/length/seed/offset=0,queued 累加,发 QUEUED(id,length,新count)。id 不要求全局唯一。 W allowance error 是消费者的一次可写调度。allowance=1..32;error=0 正常、1 EINTR、2 EAGAIN、3 不可恢复错误、4 write 返回 0。没有待写帧时 W 无效果,一步只处理队头帧。 队头 remaining=length-offset;remaining=0 时不调用 write,直接 DONE。其它情况 attempts 加一。error=0 时实际只接收 min(remaining,allowance) 字节,发 WRITE(id,原offset,实际接收数),offset 只增加接收数。 成功接收未覆盖帧尾时,帧继续留在队头,下次 W 从保存的 offset 继续。覆盖帧尾后才 done 加一、发 DONE(id,length,累计done)、清槽并移动 head。 error=1/2 都没有接收字节,pauses 加一,发 PAUSE(id,error,当前offset),保留整帧、offset 和队列顺序,等待下一次消费者调度,不在本次忙循环。 error=3/4 为当前帧失败:dropped 加一,发 DROP(id,error,当前offset),保留已接收字节的统计,清队头槽并移动 head,其它帧不受影响。 每次实际接收的字节按顺序更新 checksum=(checksum33+byte) mod 2^32,bytes 累加。checksum/bytes 在帧结束、失败和队列清空时保留,只有 R 才清零。 快照为 head,count,queued,done,dropped,attempts,pauses,bytes,checksum,rejected,随后物理槽 0..2 的 ids,lengths,seeds,offsets。消费后该槽四字段清零,head 始终模 3 移动。 替身把 write 接收结果固定为输入控制的短写或瞬态返回,保留 POSIX write 的实际进度语义。P 与 W 分别是生产者提交和消费者被唤醒的一次原子调度,避免依赖真实管道容量、信号时机或线程调度。