Files
STM32F4-Base/test/host/ui_sink/run_unit_test.py
T
wandering1 04ee5867b4 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 安全,无第二处生产误判。
2026-11-18 22:20:00 +08:00

51 lines
2.1 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""ui_net_sink 心跳边界主机侧纯逻辑单元测试运行器(纯标准库)。
做什么:
用本机 MSVC 编译 test/host/ui_sink/ui_sink_test.c(以 #include 纳入生产源
Drivers/BSP/UI/ui_net_sink.c),用桩 net_* 假件驱动推流协议全路径,钉死
F3(2026-10-25 大窗判读)两条判据:未注册钩子 = 行为逐字不变(模拟器形态);
注册后每个可等待 net 往返的返回处恰好喂一次心跳(风暴期单轮多往返不再串成
UI 心跳缺口,看门狗按位连击判据只抓真挂死)。
为什么要主机侧单测:
台架能复现风暴但造不出确定性的 RPC 计数;而心跳漏喂是回归性风险(改一行
调用位置就静默失效),必须在门禁层用计数断言钉死。
用法(仓库根目录):
& '.venv\\Scripts\\python.exe' test/host/ui_sink/run_unit_test.py
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/UI设计/UI_设计架构.md(推流心跳边界);
docs/子系统设计/看门狗设计说明.md §5.3(按位连击判据)
创建日期:2026-10-25
"""
import os
import sys
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
# stub 目录必须**先于** Drivers/BSP/UI:net_socket.h / ui_port.h / dbg_log.h /
# test_config.h 由桩提供,ui_net_sink.h 与 ui_net_sink_backend.h 用真实头
# (几何令牌与协议常量一改即编译期报错)。
BUILD = TestBuild(
name="UI Sink Beat Tests",
src=os.path.join(HERE, "ui_sink_test.c"),
include_dirs=[
os.path.join(HERE, "stub"),
os.path.join(ROOT, "Drivers", "BSP", "UI"),
os.path.join(ROOT, "Drivers", "BSP", "NET"), # net_fd.h(stub 先命中,仅补零依赖契约头)
HERE,
],
summary_marker="=== UI Sink Tests:",
)
if __name__ == "__main__":
sys.exit(run_host_unit_test(BUILD))