3.4 KiB
修复设备发布工程:build-static-deploy
现场症状:产物在开发机能运行,送到只含可执行文件的系统后仍要求共享运行库;队列排空后重放旧记录会再次计费。
修复当前工程,使已有采集、构建和发布合同同时成立。修改范围为 Makefile 与 engine.c;其他源文件是公开工程上下文。使用已有宿主 C11 工具链,无硬件、网络或交叉编译依赖。
构建与发布合同 B
make STATIC=0(默认)构建普通动态 app,STATIC=1 构建无 DT_NEEDED 的静态 app。两者运行结果一致。验证将 app 单独复制到新目录运行。排空值为 value-channel*5,再加到该通道累计值。去重历史与排空相互独立,只有 RESET 或 64 条新成功入队才改变其保留范围。
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。发布/环境变量合同可在同一树或复制后的干净目录重复构建观察。隐藏验收只组合以上公开行为。