04ee5867b4
根因:静态 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 安全,无第二处生产误判。
65 lines
3.1 KiB
Python
65 lines
3.1 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""SNTP 客户端(time_sntp)的主机侧纯逻辑单元测试运行器(纯标准库)。
|
||
|
||
做什么:
|
||
用本机 MSVC 编译 test/host/sntp/sntp_test.c(它以 #include 纳入**生产源
|
||
文件** App/sync/time_sntp.c + Drivers/BSP/NETCFG/sntp_cfg.c + vendor
|
||
Lib/coreSNTP/core_sntp_serializer.c),在 PC 上离线跑:
|
||
RFC 4330 §10 节奏(初始 1~5min 随机散布 / 失败超时翻倍封顶 60s / 成功按
|
||
poll_min 重排)、§5.3 防欺骗(应答源 IP:port / originate 含随机低位精确
|
||
匹配 / mode / LI=3 / stratum>15 / KoD DENY·RSTR·RATE·他码)、§5.5 步进
|
||
策略(±2s 死区只记录、冷启动直采 T3、钟面 = 本地 UTC+8 恒加 28800、
|
||
值域守卫)、[sntp] 配置注册与 poll 钳位、网络代次/停用收口与 socket 生命周期。
|
||
失败即非 0 退出。零硬件、零烧录、毫秒级。
|
||
|
||
工具链探测 / 编译运行 / 退出码判定全部委托通用 harness
|
||
`test/host/common/unit_test_harness.py`(本文件只做声明)。
|
||
|
||
为什么要主机侧单测(而不是只用真机):
|
||
SNTP 的失败路径(伪造应答、KoD、超时风暴、tick 回绕)在真机上不可复现或
|
||
要等小时级;且本模块直接拨 RTC(sys_clock→SD2506 写回),拨错一次就是
|
||
事故——判据必须逐包断言。真机只做正向链路回归(PC W32Time 对端)。
|
||
|
||
用法(仓库根目录):
|
||
& '.venv\\Scripts\\python.exe' test/host/sntp/run_unit_test.py
|
||
|
||
退出码:0=PASS / 1=测试失败 / 2=环境错误(找不到编译器 / 编译失败 / 无汇总行)。
|
||
|
||
设计依据:#57 调研(docs 见 sntp-调研报告.md)+ App/sync/time_sntp.c 文件头;
|
||
创建日期:2026-11-04
|
||
"""
|
||
import os
|
||
import sys
|
||
|
||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
||
# harness 位于 test/host/common/
|
||
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
||
|
||
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
||
|
||
# 顺序敏感:stub 目录必须**先于**生产目录,才能覆盖 FreeRTOS.h / task.h /
|
||
# cmsis_os2.h / net_types.h / net_socket.h / sys_clock.h / sys_events.h /
|
||
# sys_log.h / dbg_log.h(真实头会拖入整套 FreeRTOS / HAL / CH395F)。
|
||
# cfg_file.h 用**真实头**(App/cfg,纯 stdint/stddef——注册描述符契约原汁);
|
||
# sntp_cfg.h / time_sntp.h 用真实头(接口契约原汁)。
|
||
BUILD = TestBuild(
|
||
name="SNTP Client Tests",
|
||
src=os.path.join(HERE, "sntp_test.c"),
|
||
include_dirs=[
|
||
os.path.join(HERE, "stub"),
|
||
os.path.join(ROOT, "App", "sync"),
|
||
os.path.join(ROOT, "App", "cfg"),
|
||
os.path.join(ROOT, "Drivers", "BSP", "NETCFG"),
|
||
os.path.join(ROOT, "Drivers", "BSP", "NET"), # net_fd.h(stub 先命中,仅补零依赖契约头)
|
||
os.path.join(ROOT, "Lib", "coreSNTP"),
|
||
os.path.join(ROOT, "Lib", "coreSNTP", "include"),
|
||
HERE,
|
||
],
|
||
summary_marker="=== SNTP Client Tests:",
|
||
)
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(run_host_unit_test(BUILD))
|