Files
STM32F4-Base/Drivers/BSP/NET/net_fd.h
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

29 lines
1.3 KiB
C
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.
/*
* 模块名称: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 */