3.4 KiB
Raw Blame History

修复设备发布工程:build-versioned-api

现场症状:共享库发布后内部符号出现在动态 API 中;同一条线记录换一个序号后,其指纹与通信端不一致。

修复当前工程,使已有采集、构建和发布合同同时成立。修改范围为 Makefile 与 engine.c;其他源文件是公开工程上下文。使用已有宿主 C11 工具链,无硬件、网络或交叉编译依赖。

构建与发布合同 B

app 经 libdevice.so 运行,运行路径相对可执行文件。共享库 engine_ 前缀全局定义的动态函数必须且仅有 engine_execute@@DEVICE_1.0 与 engine_reset@@DEVICE_1.0。排空值为记录前 12 字节的 IEEE CRC32(无符号),再加到该通道累计值。线记录始终小端,不依赖主机字节序。

make 默认目标为 app,make clean 可重复执行;构建须保留协议、队列和主程序。应用从 stdin 接受多条命令,逐行响应,不写输入文件。不会根据新增文件拒绝候选;最终只提交和评分 Makefile、engine.c。编译器、make、ar、ld、readelf 均已提供,不使用 cmake。

采集与队列合同 Q

device.h 定义 Request/Response、engine_reset(uint32_t epoch) 与 engine_execute(const Request*,Response*)。进程起始等同 RESET 0。RESET E 清空队列、全部计数、去重历史及各通道累计值,并设置 epoch=E。8 个通道编号为 0..7,FIFO 容量 32。

PUT sequence channel value 使用 uint32 序号、uint32 通道和 int32 值。非法通道返回 -1;在最近 64 条成功入队记录中出现过的序号返回 -2(跨通道、排空及 DROP 均有效);队列满返回 -3。检查顺序依次为通道、历史、可选过滤、容量。成功返回 0,accepted 增 1 并加入历史;历史满后移除最早的成功入队序号。失败不改变任何状态。序号 0 与 UINT32_MAX 均合法。

DRAIN limit:limit=0..32,按 FIFO 取至多 limit 条,按构建合同转换每条原值并累加到它所在通道的 int64 总值,每条输出更新后的该通道总值;limit>32 返回 -1 且不修改状态。累计值仅由排空推进。DROP channel 删除该通道所有待处理记录,dropped 增加删除数量,保持其他记录次序、历史及累计值;非法通道返回 -1。STATE 仅观察。

线格式与观察合同 W

WIRE hex 等同 PUT:16 字节为小端 uint32 sequence/channel、int32 value,末尾为前 12 字节的 IEEE CRC32(与 Python zlib.crc32 一致)。大小写十六进制均有效;长度、校验或通道错误与未知/格式错误命令返回 -1、不改状态。不会要求处理超过公开行缓冲区的输入。所有数值运算在不溢出 int64 的范围内。

每条命令(含错误)打印一行:R status epoch accepted dropped pending digest backend feature version count [values...]。digest 为待处理 FIFO 中各完整 16 字节线记录串联的 IEEE CRC32,空队列为 0。count 为本命令排空记录数;其余命令 count=0。backend 缺省为 1(构建合同另述除外),feature/version 默认 0/1(构建合同另述除外)。错误仍输出完整当前状态。stdout 仅包含协议行,诊断可写 stderr。

自测:make clean、make,再将 RESET 7、PUT 1 0 11、PUT 2 1 -12、DRAIN 1、STATE、DRAIN 32 逐行送入 ./app。发布/环境变量合同可在同一树或复制后的干净目录重复构建观察。隐藏验收只组合以上公开行为。