fix(net): 建立网络 fd 失效值契约,杜绝零初始化误判
根因:静态 fd 零初始化为 0,而 0 是合法 socket 句柄;判据用 >=0 会把"未初始化"误判成"有效",关闭时误伤他人 fd。本次把该修复 契约化、机械化,而不是再补一个点。 - 新增 net_fd.h 定义唯一失效值 NET_FD_INVALID(-1),全仓零依赖复用 - fd 判据只用 ==/!= NET_FD_INVALID,禁 >=0/<0/数值形态/if(fd) - 网络层内部用 NET_FD_IN_RANGE 做范围校验,上界不外泄 - 主机 fake 改 0 基并跟踪已分配 fd,补冷启动回归(变异测试可捕获) - 新增 net-handle 静态门禁(钩子 53)+ 契约文档 + 审计 + 最小加固 验证:net-handle 487 文件 0 违规;8 个主机套件全绿;Keil 0 错误 0 警告; 审计 3 确认/5 疑似/35 安全,无第二处生产误判。
This commit is contained in:
+30
-5
@@ -196,7 +196,8 @@ repos:
|
||||
docs/芯片手册/
|
||||
)
|
||||
# mermaid 图:围栏内确定性语法预检(2026-10-30 加;当日口径 51 → 52、提交期实跑 48 → 49,
|
||||
# 2026-11-17/18 摘 `iec104-unit-test` + 加 `iec104-tcp` 后收敛为 52 / 47 / 48)。
|
||||
# 2026-11-17/18 摘 `iec104-unit-test` + 加 `iec104-tcp` 后为 52 / 47 / 48,
|
||||
# 同日再加 `net-handle` 后当前为 **53 / 48 / 49**)。
|
||||
# 为什么要有:屏板链路设计.md §1 的 flowchart 里 `-.|"文字"|`(`-.` 直接跟管道,不是任何合法
|
||||
# 箭头 token)让 mermaid 渲染 `Syntax error in text`——该图 2026-10-29 落库、期间 doc-links 等
|
||||
# 全绿:文档门禁查链接与章节,**从不查围栏内图表语法**,这是它们的共同盲区。
|
||||
@@ -514,10 +515,11 @@ repos:
|
||||
# 新板端网络后端的等价验证是 test/host/iec104_netmcu/(fake net 层 + 自定义
|
||||
# runner,不是 run_unit_test.py 形态,硬套进这里只会得到一个跑不起来的钩子),
|
||||
# 由 scripts/ci_local.py 与人工运行,不进提交门禁。
|
||||
# ⚠ 计数口径(2026-11-18 两笔合并后实测):本条摘除使 YAML 解析条目 52 → 51、
|
||||
# ⚠ 计数口径(2026-11-18 三笔合并后实测):本条摘除使 YAML 解析条目 52 → 51、
|
||||
# 提交期实跑 49 → 48;同日新增的 `iec104-tcp`(下面 12b 条,manual 阶段)再把
|
||||
# 声明数加回 **52**、manual 根数 3 → **4**、manual 阶段枚举行数 50 → **51**。
|
||||
# ⇒ 终态:**声明 52 / pre-commit 阶段 47 / 一次 git commit 实跑 48 / manual 4**。
|
||||
# 声明数加回 52、manual 根数 3 → 4、manual 阶段枚举行数 50 → 51;同日再加
|
||||
# `net-handle`(下面 13 条,pre-commit 阶段)。
|
||||
# ⇒ 当前:**声明 53 / pre-commit 阶段 48 / 一次 git commit 实跑 49 / manual 4**。
|
||||
# 须与 AGENTS.md 的「共 N 个钩子」、docs/门禁说明/README.md §2 标题、
|
||||
# docs/代码规范/pre-commit使用说明.md 三处同批改(勿在别处另立字面量)。
|
||||
|
||||
@@ -879,7 +881,30 @@ repos:
|
||||
language: system
|
||||
types: [c]
|
||||
|
||||
# ─── SKILL.md 体积与 reference/ 指针门禁(第 52 条,2026-10-29 加)─────────────────────
|
||||
# ─── 网络句柄失效值契约门禁(第 52 条,2026-11-18 加,声明数 52 → 53)──────────────────
|
||||
# 为什么要有:板端 104 连不上的真因不是"漏了一个 -1",而是"未打开的 fd"由 C 零初始化
|
||||
# 成 0,而本项目 net 层 fd 域是 0~7(0 是**合法**描述符)——失效值恰好落在合法值域,
|
||||
# 再被 `fd >= 0` 这类数值形态判据当成"持有 fd";网络代际切换后它去关 fd 0,把别的
|
||||
# 服务的监听槽(FTP)关掉,最终 104 建链拿到 FTP 的 220 banner。修好一处只是治标,
|
||||
# 本闸把契约(Drivers/BSP/NET/net_fd.h 的 NET_FD_INVALID)搬到提交期机械判定:
|
||||
# R1 fd 形标识符与整数字面量比较;R2 文件作用域 static fd 无初始化/`{0}`/缺 fd 成员;
|
||||
# R3 memset 含 fd 成员的结构体后 5 行内不回填;R4 `if (fd)` / `if (!fd)`;
|
||||
# R5 契约头文件存在且被 net_socket.h include。
|
||||
# 白名单不是漏判:`Drivers/BSP/NET/` 是契约的层内实现者(C4 允许 `0 <= fd < 上界`
|
||||
# 区间校验,fd 槽数组清零即"释放",套 R1~R4 会把正经实现判红);`test/host/` 的假
|
||||
# 对象按 C7 从 0 基分配,断言语域不同。两者的契约合规性由 R5 + 独立验收复核。
|
||||
# 自证:`--selftest` 42 条断言(每个 R 都有"故意写错必须抓到"与"正确写法不误报",
|
||||
# 含注释里的反面教材不误报、白名单不误伤、整数组清零不误报)。
|
||||
# 全树扫不只看变更文件(files 只当触发):R5 要判契约文件本身,且"当前树 0 违规"
|
||||
# 才是可复核的口径。判据、盲区与豁免写法 → docs/门禁说明/net-handle.md。
|
||||
- id: net-handle
|
||||
name: "网络 fd 失效值契约(NET_FD_INVALID:数值判据 / 零初始化 / memset 后不回填)"
|
||||
entry: scripts/gate_python.py scripts/check_net_handle.py
|
||||
language: system
|
||||
files: ^(.*\.(c|h)|scripts/check_net_handle\.py|\.pre-commit-config\.yaml)$
|
||||
pass_filenames: false
|
||||
|
||||
# ─── SKILL.md 体积与 reference/ 指针门禁(第 53 条,2026-10-29 加)─────────────────────
|
||||
# 为什么要有:dsh-mnemon 插件对技能正文有 65536 字节的**写侧**硬上限(validateSkillContent),
|
||||
# 但**加载侧不查**——超限的 SKILL.md 照常可读、照常进技能目录,只有一件事会坏:自进化每次
|
||||
# 「生成草案」都在落盘那一步被拒,那一行永久卡在「生成中」、界面只剩转圈、连「忽略」都不出现
|
||||
|
||||
Reference in New Issue
Block a user