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:
2026-11-18 22:20:00 +08:00
parent 50ee1b4402
commit 04ee5867b4
52 changed files with 1954 additions and 314 deletions
+8 -4
View File
@@ -15,6 +15,7 @@
extern "C" {
#endif
#include "net_fd.h" /* NET_FD_INVALID:fd 失效值契约(0 是合法 fd) */
#include "net_types.h"
/*
@@ -155,9 +156,12 @@ int net_poll(void);
* 函数功能:创建 socket
* 入口参数:domain - 地址族,仅支持 AF_INET
* type - SOCK_STREAM(TCP) 或 SOCK_DGRAM(UDP)
* 返回值:socket 描述符 (0~7),失败返回 -1
* 返回值:socket 描述符 (0~NET_MAX_SOCKETS-1,**0 是合法句柄**,首个成功值为 0);
* 失败返回 NET_FD_INVALID(同时置 net_errno)
* 限定条件:net_init() 已调用
* 函数说明:自动分配空闲 Socket 控制块
* 函数说明:自动分配空闲 Socket 控制块。句柄失效值契约见 net_fd.h /
* docs/网络/网络句柄失效值契约.md —— 判"是否持有 fd"只与
* NET_FD_INVALID 比较,禁止 >= 0 / < 0 之类的数值形态判据。
*/
int net_socket(int domain, int type);
@@ -186,9 +190,9 @@ int net_listen(int sockfd);
* 入口参数:sockfd - 监听 socket 描述符
* addr - 输出:客户端地址
* addrlen - 输入输出:地址长度
* 返回值:新 socket 描述符,失败返回 -1
* 返回值:新 socket 描述符,失败返回 NET_FD_INVALID
* 限定条件:socket 正在监听
* 函数说明:在非阻塞模式下,如果没有新连接,返回 -1 并设置
* 函数说明:在非阻塞模式下,如果没有新连接,返回 NET_FD_INVALID 并设置
* net_errno 为 NET_ERR_WOULDBLOCK
*/
int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen);