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 安全,无第二处生产误判。
29 lines
1.3 KiB
C
29 lines
1.3 KiB
C
/*
|
||
* 模块名称:Network Socket 句柄失效值契约
|
||
* 模块功能:定义网络 socket 句柄的**唯一**失效值 NET_FD_INVALID,供 MCU 侧、
|
||
* PC 模拟器与主机单测 stub 共用。
|
||
* 适用平台:STM32F4 系列(CH395F 以太网芯片) / PC 模拟器
|
||
* 作者:王建锋
|
||
* 创建日期:2026-11-18
|
||
* 修改记录:
|
||
*
|
||
* 契约要点(全文 → docs/网络/网络句柄失效值契约.md):
|
||
* 1. net_socket() 成功返回 0 .. NET_MAX_SOCKETS-1,**0 是合法 fd**;
|
||
* 失败返回 NET_FD_INVALID。
|
||
* 2. 任何"持有 fd"的变量/结构体成员,声明处必须显式初始化为 NET_FD_INVALID,
|
||
* 不得依赖 C 的零初始化(零值恰好是合法 fd 0)。
|
||
* 3. 判"是否持有 fd"只允许与 NET_FD_INVALID 比较(== / !=),
|
||
* 禁止 >= 0、< 0、== -1 之类的数值形态判据。
|
||
*
|
||
* ⚠ 本头文件刻意**零依赖**(不 include net_config.h / net_types.h):
|
||
* 主机单测的 stub 目录里没有 net_config.h,而 stub 的 net_socket.h 同样要
|
||
* include 本文件取失效值。不得在此引入任何其它头文件或 NET_MAX_SOCKETS。
|
||
*/
|
||
#ifndef NET_FD_H
|
||
#define NET_FD_H
|
||
|
||
/* 网络 socket 句柄失效值("未持有 / 已关闭 / 申请失败") */
|
||
#define NET_FD_INVALID (-1)
|
||
|
||
#endif /* NET_FD_H */
|