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
+31 -31
View File
@@ -72,7 +72,7 @@ static int ensure_wsa(void) {
* 函数功能:分配一个空闲 fd(控制块索引)
* 入口参数:无
* 出口参数:无
* 返回值:空闲索引(0 ~ NET_MAX_SOCKETS-1),-1 表示无空闲
* 返回值:空闲索引(0 ~ NET_MAX_SOCKETS-1),NET_FD_INVALID 表示无空闲
* 限定条件:s_socks 已定义
* 函数说明:线性扫描,返回首个 in_use == 0 的控制块索引
*/
@@ -84,7 +84,7 @@ static int alloc_fd(void) {
return i;
}
}
return -1;
return NET_FD_INVALID;
}
/*
@@ -173,7 +173,7 @@ int net_poll(void) {
* 入口参数:domain - 地址族(仅 AF_INET)
* type - NET_SOCK_STREAM(TCP) 或 NET_SOCK_DGRAM(UDP)
* 出口参数:无
* 返回值:socket 描述符(0 ~ NET_MAX_SOCKETS-1),失败 -1
* 返回值:socket 描述符(0 ~ NET_MAX_SOCKETS-1),失败 NET_FD_INVALID
* 限定条件:Winsock 已就绪
* 函数说明:分配空闲控制块,创建 Winsock SOCKET 并置非阻塞
*/
@@ -187,13 +187,13 @@ int net_socket(int domain, int type) {
if (ensure_wsa() != 0) {
s_net_errno = NET_ERR;
return -1;
return NET_FD_INVALID;
}
idx = alloc_fd();
if (idx < 0) {
if (idx == NET_FD_INVALID) {
s_net_errno = NET_ERR;
return -1;
return NET_FD_INVALID;
}
is_udp = (type == NET_SOCK_DGRAM);
@@ -201,13 +201,13 @@ int net_socket(int domain, int type) {
is_udp ? IPPROTO_UDP : IPPROTO_TCP);
if (ws == INVALID_SOCKET) {
s_net_errno = NET_ERR;
return -1;
return NET_FD_INVALID;
}
if (ioctlsocket(ws, FIONBIO, &nb) != 0) {
closesocket(ws);
s_net_errno = NET_ERR;
return -1;
return NET_FD_INVALID;
}
memset(&s_socks[idx], 0, sizeof(net_sock_t));
@@ -238,7 +238,7 @@ int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen) {
struct sockaddr_in wsaddr;
int yes = 1;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -269,7 +269,7 @@ int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen) {
* 函数说明:backlog 为 1(单客户端),监听 Socket 保持非阻塞
*/
int net_listen(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -302,9 +302,9 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
int nidx;
u_long nb = 1;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
return NET_FD_INVALID;
}
wslen = sizeof(wscli);
@@ -313,7 +313,7 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
if (cws == INVALID_SOCKET) {
int err = WSAGetLastError();
s_net_errno = (err == WSAEWOULDBLOCK) ? NET_ERR_WOULDBLOCK : NET_ERR;
return -1;
return NET_FD_INVALID;
}
if (addr != NULL && addrlen != NULL) {
@@ -322,10 +322,10 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
}
nidx = alloc_fd();
if (nidx < 0) {
if (nidx == NET_FD_INVALID) {
closesocket(cws);
s_net_errno = NET_ERR;
return -1;
return NET_FD_INVALID;
}
ioctlsocket(cws, FIONBIO, &nb);
@@ -357,7 +357,7 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
* (设计文档 D6:双模型分裂暂不消除),无此中间态,恒 1 即为正确语义。
*/
int net_listener_armed(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
return 0;
}
return 1;
@@ -372,7 +372,7 @@ int net_listener_armed(int sockfd) {
* 上层门控在模拟器上不改变既有行为(含"每轮都 recv"的自愈特性)
*/
int net_can_read(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
return 0;
}
return 1;
@@ -391,7 +391,7 @@ int net_can_read(int sockfd) {
int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen) {
struct sockaddr_in wsaddr;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -430,7 +430,7 @@ int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen) {
int net_send(int sockfd, const void *buf, int len, int flags) {
int r;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -529,7 +529,7 @@ static int recv_wait(int sockfd, void *buf, int len, int has_budget, unsigned lo
* 无限等待还是立即 WOULDBLOCK;DONTWAIT 单次覆盖属性
*/
int net_recv(int sockfd, void *buf, int len, int flags) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -554,7 +554,7 @@ int net_recv(int sockfd, void *buf, int len, int flags) {
* 函数说明:等价 net_recv(sockfd, buf, len, NET_MSG_DONTWAIT),不改变 blocking 属性
*/
int net_recv_nb(int sockfd, void *buf, int len) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -575,7 +575,7 @@ int net_recv_nb(int sockfd, void *buf, int len) {
* 函数说明:模拟器以 GetTickCount64 + Sleep(1) 轮询兑现预算
*/
int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -616,7 +616,7 @@ int net_sendto(int sockfd, const void *buf, int len, int flags,
struct sockaddr_in wsaddr;
int r;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -664,7 +664,7 @@ int net_recvfrom(int sockfd, void *buf, int len, int flags,
(void)flags;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -700,7 +700,7 @@ int net_recvfrom(int sockfd, void *buf, int len, int flags,
* 函数说明:关闭 Winsock 句柄并释放控制块(in_use 清零,net_get_sock 转返回 NULL)
*/
int net_close(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
if (NET_FD_IN_RANGE(sockfd) == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -729,7 +729,7 @@ int net_close(int sockfd) {
* 监听 fd 不受影响。无活动会话幂等返 0。
*/
int net_drop_conn(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
if (NET_FD_IN_RANGE(sockfd) == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -763,7 +763,7 @@ int net_drop_conn(int sockfd) {
* 函数说明:模拟器以非阻塞 I/O 直接感知事件,回调仅存储不主动触发
*/
int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -786,7 +786,7 @@ int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg) {
* 语义与 MCU 端"模式挂控制块属性"一致
*/
int net_setblocking(int sockfd, int on) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -920,7 +920,7 @@ uint32_t net_ntohl(uint32_t netlong) {
* 函数说明:上层据此判断"监听 Socket 是否随客户端一同失效"(单连接模型)
*/
net_sock_t *net_get_sock(int sockfd) {
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
if (NET_FD_IN_RANGE(sockfd) == 0) {
return NULL;
}
if (s_socks[sockfd].in_use == 0) {
@@ -943,7 +943,7 @@ int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen) {
struct sockaddr_in wsaddr;
int wslen;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}
@@ -980,7 +980,7 @@ int net_getpeername(int sockfd, struct net_sockaddr *addr, int *addrlen) {
struct sockaddr_in wsaddr;
int wslen;
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
if (NET_FD_IN_RANGE(sockfd) == 0 || s_socks[sockfd].in_use == 0) {
s_net_errno = NET_ERR_BADF;
return -1;
}