读写锁纪元缓存:原子发布、排队写者和读者代际

这是由 HWE syn-hard-rwlock-epoch-cache 的 rwlock/每读者单调观测方向重新编写的原创软件可靠性工程。只执行 Linux pthread 软件行为,不声称测得 cacheline 性能、物理缓存一致性、DMA 或板卡行为。实现 epoch_cache.c,保持 epoch_cache.h 原字节不变。公开 observer.c 是只记录原始观察的驱动,可自行用标准 C11/pthread 编译运行;判据独立复算期望。不得把测试输入或固定输出当作库实现。

API 详见头文件,以下规则完整定义全部行为。所有普通函数返回 errno 数字(不是 -1/errno);成功 0。epoch_create 返回指针,失败 NULL 并设置 errno。所有 NULL cache/out 参数 EINVAL(destroy 的 NULL 也如此)。失败不修改输出结构;错误不产生额外状态变化,下述已排队、提交溢出为明确例外。标准 pthread/内存分配错误原样返回;不注入 OS 资源故障。调用者保证 cache 指针有效、所有 out 指向有效独立存储;销毁后不再使用指针,不传任意地址。owner 是应用提供且同时存活缓存之间唯一的非零 u64,owner=0 创建 EINVAL。初始 epoch 可为任意 u64,16 个键初始全部不存在。可以使用 mutex/cond 构建公平准入,但实际数据读写必须分别持有 pthread_rwlock 的读/写锁,且读锁覆盖整个 lease。不可用常量、自报计数或睡眠替代同步。锁顺序必须一致;API 单个阻塞调用不能在持有全局 mutex 时等 rwlock。头文件内的 public token 都按值传递。

注册与代际

epoch_register 选择最小可用 slot(0..7),返回 owner、slot 和该 slot 新一代 generation。每 slot generation 从 1 起,每次成功重新注册严格加 1;注销与 reseed 不重置代际。无空位 ENOSPC。新注册 reader 的 seen_max=当前 epoch、completed=0、busy=0。epoch_unregister 验证 owner/slot/generation 和当前注册身份;任一不符 EINVAL。存在该 reader 已获得或正在等待准入的 read_begin 时 EBUSY。注销不影响其它 reader。reader_status 返回该身份的 seen_max、completed、busy(busy 包括等待和活动)。身份非法 EINVAL。所有代际不会在输入场景中耗尽。

读 lease 与单调观测

epoch_read_begin 先验证 reader;同 reader 已 busy 返回 EBUSY。成功获得共享读准入并持有真正 rwlock 读锁,返回新 serial(同缓存每次成功 lease 严格递增,从1开始)、owner/generation/slot 和该次一致快照 epoch。read_begin 在有活动 writer 或任何已排队 writer 时等待,不可让新 reader 插队。开始等待立即令该 reader busy,因此不能被注销。多个不同 reader 可同时获得 lease。调用者不会在同一线程同时持有两个 reader lease,也不在自己持有写事务时调用 read_begin。

epoch_read_value 接受 key 0..15,返回 lease.epoch 为 snapshot_epoch,以及该快照下的 record。present 为严格 0/1。不存在时 version/tag/value/present 全零;存在时 version 为最近一次有效写该键的提交 epoch,tag/value 原样保存。lease 上的每一个字段都必须与当前活动身份匹配,包括 epoch;调用线程必须是取得该 lease 的线程,否则 EINVAL。读不修改 seen_max/completed。保持 lease 期间的所有键始终来自同一已提交快照,且 writer 不得发布。非法 key 或 NULL out EINVAL,lease 仍有效。

epoch_read_end 验证同样身份及线程,释放共享锁,使 reader busy=0;seen_max=max(原 seen_max, lease.epoch),completed 加 1,恰在成功 end 时发生。已结束 lease 再读/结束 EINVAL,旧 lease 不得结束同 slot 后来的 lease。status 在 busy 时仍可查询。对其它缓存使用 token/lease 返回 EINVAL,不得影响任一缓存。

写事务、公平与提交

epoch_write_begin 为每次合法请求分配单调 ticket,从0开始。next_ticket 为下一个待分配编号,serving_ticket 为下一个应准入编号,queued_writers 只计等待(不含活动 writer)。按分配 ticket 的 FIFO 次序准入,一次至多一个活动 writer;有活动读 lease 时 writer 等待。活动 writer 期间及排队 writer 之前到达的新 reader 继续等待。准入后返回 owner/ticket,并持有真实 rwlock 写锁。阻塞前检查同线程已经拥有任意读 lease 或当前写事务,返回 EDEADLK,不能消耗 ticket。不会测试 ticket u64 耗尽。

write_put/erase/commit/abort 必须验证 owner、当前活动 ticket 和创建线程,错误 EINVAL 且零修改。put/erase 的非法 key EINVAL。事务从当前已提交全部键复制一份私有暂存;put 设置键为 present、保存 value/tag;erase 使键不存在。同一事务最后一次动作生效。有效 put(即使值相同)将该键标记为写过;erase 对存在/不存在的键都有效且最后不存在。事务期间 inspect 可以执行,但只能看到旧全局 epoch,不可看到私有暂存。reader 无法看到中间结果。

commit 恰将全局 epoch 加 1,包括没有 put/erase 的空事务。所有被 put 且最后存在的键 version=新 epoch,未修改键保留原 version;不存在键所有字段为零。事务所有更改一次发布。新 epoch 溢出时返回 EOVERFLOW,保留事务与全部私有暂存和写锁,允许随后 abort;不修改公共 epoch/键。commit 成功后事务失效、writer_active=0、serving_ticket加1,并唤醒下一个写者/可准入读者。abort 丢弃全部暂存,不改变 epoch/键,同样释放和推进 ticket。事务只提交或放弃一次,旧 token 不得操作下一事务。

状态、重置和收尾

inspect 返回同一 mutex 保护下的一致 state,可与活动 lease/事务并发。epoch 为已提交 epoch;active_readers 只计获得共享锁的 lease,不含等待 reader;registered 为当前注册数量。next_ticket/serving_ticket 保留所有已成功分配请求历史,abort 也消耗 ticket。正常空闲两者相等,writer_active 为0/1。

reseed 只在无注册 reader、无等待/活动 writer 和无活动 reader 时成功,否则 EBUSY。成功把 epoch 改为参数、清空全部键、重置 lease serial 为下一次1及 next_ticket/serving_ticket为0,但每 slot generation 保持,旧 token 仍无效。close 也仅在上述完全空闲状态成功,否则 EBUSY。成功设置 closed;重复 close 成功且无变化。closed 后除 inspect、close、destroy 外所有 API 返回 ESHUTDOWN(非NULL cache优先closed判断;NULL out仍EINVAL);reseed 不能重新打开。destroy 只在已经 closed 且完全空闲时释放对象,未 closed 返回 EBUSY,不隐式关闭、不遗留线程或锁。

可运行 cc -std=c11 -D_POSIX_C_SOURCE=200809L -Wall -Wextra -Werror -pedantic -pthread epoch_cache.c observer.c -Wl,--wrap=pthread_rwlock_rdlock -Wl,--wrap=pthread_rwlock_wrlock -Wl,--wrap=pthread_rwlock_tryrdlock -Wl,--wrap=pthread_rwlock_trywrlock -Wl,--wrap=pthread_rwlock_timedrdlock -Wl,--wrap=pthread_rwlock_timedwrlock -Wl,--wrap=pthread_rwlock_unlock -o observer 自测。本题不要求特定容器实现、对象布局、线程调度速度或具体 pthread 内部队列;验收用条件变量控制可观察准入顺序,以状态作为门控,不用偶然 sleep 顺序决定正确性。

observer 从 stdin 读取操作流,argv[1] 是输出标记。c/r/u/s/b/v/e/w/p/x/k/a/i/z/q/d 分别创建、注册、注销、状态、开始读、读键、结束读、开始写、写键、删除、提交、放弃、全局状态、重置、关闭、销毁;字段形式可直接查看各 scanf。T 用第二线程尝试使用给定 lease/tx;F 是持读者时依次排队写者再到达读者的 FIFO 门控;G 是两个同时持有的共享读者逐一释放;M 是三个读者与一个写者并发采样。所有输出都是返回码/句柄/内存/门控/锁调用原始观察,输出不含通过断言。驱动只输入有效索引和有限计数,库负责自己的 API 校验。

observer按线程TLS编号与实际pthread_rwlock对象记录当前read/write持有深度,包含阻塞、try和timed获取;每个API边界及FIFO/共享读门控都报告当前持锁集合。读lease和写事务必须在整个生命期内持有同一数据锁;不能在begin后提前解锁并在end/commit前补锁。