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:
@@ -951,7 +951,8 @@ static int net_wait_result(const char *kind, int sockfd) {
|
||||
* 入口参数:domain - 地址族,仅支持 NET_AF_INET int
|
||||
* type - SOCK_STREAM(TCP) 或 SOCK_DGRAM(UDP) int
|
||||
* 出口参数:无
|
||||
* 返回值:Socket 描述符 (0~7),失败返回 -1 int
|
||||
* 返回值:Socket 描述符 (0~NET_MAX_SOCKETS-1,首个成功值为 0),
|
||||
* 失败返回 NET_FD_INVALID int
|
||||
* 限定条件:net_init() 已调用成功;s_net_initialized == 1
|
||||
* 函数说明:自动分配一个空闲的 Socket 控制块(in_use=0),初始化为 CREATED 状态
|
||||
*/
|
||||
@@ -963,15 +964,17 @@ int net_socket(int domain, int type) {
|
||||
|
||||
/* 参数检查:地址族仅支持 NET_AF_INET */
|
||||
if (domain != NET_AF_INET) {
|
||||
/* 不支持的地址族 → INVAL */
|
||||
return NET_ERR_RETURN_1(NET_ERR_INVAL);
|
||||
/* 不支持的地址族 → INVAL(保留 errno 副作用;返回值为契约失效值) */
|
||||
(void)NET_ERR_RETURN_1(NET_ERR_INVAL);
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
/* 分配空闲控制块(in_use=0 的槽位) */
|
||||
sockfd = alloc_socket();
|
||||
if (sockfd < 0) {
|
||||
/* 无空闲控制块 → NOMEM */
|
||||
return NET_ERR_RETURN_1(NET_ERR_NOMEM);
|
||||
if (sockfd == NET_FD_INVALID) {
|
||||
/* 无空闲控制块 → NOMEM(保留 errno 副作用;返回值为契约失效值) */
|
||||
(void)NET_ERR_RETURN_1(NET_ERR_NOMEM);
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
/* 初始化控制块:芯片侧 Socket 编号与描述符一一对应 */
|
||||
@@ -1038,7 +1041,7 @@ int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen) {
|
||||
const struct net_sockaddr_in *p_addr_in;
|
||||
|
||||
/* 参数检查:描述符范围 */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 越界 → BADF */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -1289,7 +1292,7 @@ int net_listen(int sockfd) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -1332,7 +1335,7 @@ int net_listen(int sockfd) {
|
||||
* 入口参数:sockfd - 监听 Socket 描述符 int
|
||||
* 出口参数:addr - 输出:客户端地址结构体指针 struct net_sockaddr *(可为 NULL)
|
||||
* addrlen - 输入输出:地址结构体长度 int *(可为 NULL)
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 -1 int
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 NET_FD_INVALID int
|
||||
* 限定条件:Socket 处于 LISTENING 状态
|
||||
* 函数说明:单连接:监听 Socket 自身在 CONNECT 后已转为 ESTABLISHED
|
||||
*/
|
||||
@@ -1357,7 +1360,7 @@ int net_listen(int sockfd) {
|
||||
* 入口参数:sockfd - 监听 Socket 描述符 int
|
||||
* 出口参数:addr - 输出:客户端地址结构体指针 struct net_sockaddr *(可为 NULL)
|
||||
* addrlen - 输入输出:地址结构体长度 int *(可为 NULL)
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 -1 int
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 NET_FD_INVALID int
|
||||
* 限定条件:Socket 处于 LISTENING 状态
|
||||
* 函数说明:1. 单连接:监听 Socket 自身在 CONNECT 后已转为 ESTABLISHED
|
||||
* 2. 等待期叠加芯片状态轮询探针(CONNECT 事件未收到自愈,TRAP-NET-20)
|
||||
@@ -1443,7 +1446,7 @@ int net_accept_locked(int sockfd, struct net_sockaddr *addr, int *addrlen) {
|
||||
* 入口参数:sockfd - 监听 Socket 描述符 int
|
||||
* 出口参数:addr - 输出:客户端地址结构体指针 struct net_sockaddr *(可为 NULL)
|
||||
* addrlen - 输入输出:地址结构体长度 int *(可为 NULL)
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 -1 int
|
||||
* 返回值:新连接的 Socket 描述符,失败返回 NET_FD_INVALID int
|
||||
* 限定条件:Socket 处于 LISTENING 状态;net_init() + MX_FREERTOS_Init() 已执行;非 netTask 上下文
|
||||
* 函数说明:将接受请求放入消息队列,阻塞等待 netTask 处理完毕
|
||||
*/
|
||||
@@ -1452,7 +1455,7 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -1613,7 +1616,7 @@ int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -1688,7 +1691,7 @@ static int net_connect_locked(int sockfd, const struct net_sockaddr *addr, int a
|
||||
uint8_t status;
|
||||
|
||||
/* 参数检查:描述符范围 */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 越界 → BADF */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -2232,7 +2235,7 @@ int net_drop_conn_locked(net_sock_t *p_sock) {
|
||||
|
||||
/*
|
||||
* 函数功能:发送数据(线程安全版本,通过消息队列委托给 netTask)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 待发送数据缓冲区指针(调用返回前须保持有效,本函数不拷贝数据) const void *
|
||||
* len - 数据长度(字节),> 0 int
|
||||
* flags - 标志位,当前实现忽略(保留 BSD send 接口兼容) int
|
||||
@@ -2256,7 +2259,7 @@ int net_send(int sockfd, const void *buf, int len, int flags) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* ---- 1. 参数合法性检查 ---- */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 描述符越界 */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -2309,7 +2312,7 @@ int net_send(int sockfd, const void *buf, int len, int flags) {
|
||||
/*
|
||||
* 函数功能:接收数据(线程安全版本,通过消息队列委托给 netTask;
|
||||
* **默认无限阻塞**,30s 默认预算已删)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 接收缓冲区指针 void *
|
||||
* len - 缓冲区大小 int > 0
|
||||
* flags - 标志位,0=按 socket 阻塞属性等待,NET_MSG_DONTWAIT=单次非阻塞 int
|
||||
@@ -2333,7 +2336,7 @@ int net_recv(int sockfd, void *buf, int len, int flags) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -2387,7 +2390,7 @@ int net_recv(int sockfd, void *buf, int len, int flags) {
|
||||
/*
|
||||
* 函数功能:接收数据(非阻塞具名入口——原 NET_MSG_DONTWAIT 路径转正,
|
||||
* 对齐 BSD recv(MSG_DONTWAIT) / Python recv 非阻塞模式的"名如其义")
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 接收缓冲区指针 void *
|
||||
* len - 缓冲区大小 int > 0
|
||||
* 出口参数:buf - 填充接收到的数据
|
||||
@@ -2407,7 +2410,7 @@ int net_recv_nb(int sockfd, void *buf, int len) {
|
||||
* 函数功能:接收数据(带调用方指定超时的阻塞版,用于分片有界读;
|
||||
* 为**显式预算**便捷入口,等价 Python settimeout,
|
||||
* 不再有隐藏默认值)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf / len - 接收缓冲与容量 void * / int > 0
|
||||
* timeout_ms - 单次占用 netTask 的最长等待(毫秒,>0) uint32_t
|
||||
* 出口参数:无
|
||||
@@ -2425,7 +2428,7 @@ int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* ---- 1. 参数合法性检查 ---- */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 描述符越界 */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -2504,7 +2507,7 @@ int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms) {
|
||||
|
||||
/*
|
||||
* 函数功能:关闭 Socket(线程安全版本,通过消息队列委托给 netTask)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* 出口参数:无
|
||||
* 返回值:0 - 关闭成功 int
|
||||
* -1 - 关闭失败 int
|
||||
@@ -2517,7 +2520,7 @@ int net_close(int sockfd) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -2557,7 +2560,7 @@ int net_close(int sockfd) {
|
||||
|
||||
/*
|
||||
* 函数功能:主动拆掉当前 TCP 会话、保留监听(线程安全版本,经消息队列委托 netTask)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* 出口参数:无
|
||||
* 返回值:0 - 成功(含幂等:无活动会话直接 0) int
|
||||
* -1 - 失败(BADF/INVAL/入队失败) int
|
||||
@@ -2576,7 +2579,7 @@ int net_drop_conn(int sockfd) {
|
||||
net_msg_t msg;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -2615,7 +2618,7 @@ int net_drop_conn(int sockfd) {
|
||||
|
||||
/*
|
||||
* 函数功能:发送 UDP 数据报(含目标地址)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 待发送数据缓冲区指针 const void *
|
||||
* len - 数据长度 int > 0
|
||||
* flags - 标志位,通常为 0 int
|
||||
@@ -2658,7 +2661,7 @@ int net_sendto(int sockfd, const void *buf, int len, int flags,
|
||||
(void)flags;
|
||||
|
||||
/* 参数检查:本批检查全部留在守卫/队列之前,参数错误先报参数错误 */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 描述符越界 → BADF */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -2729,7 +2732,7 @@ int net_sendto(int sockfd, const void *buf, int len, int flags,
|
||||
}
|
||||
/*
|
||||
* 函数功能:接收 UDP 数据报(含源地址)——无限等待形态
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 接收缓冲区指针 void *
|
||||
* len - 缓冲区大小 int > 0
|
||||
* flags - NET_MSG_DONTWAIT = 本次非阻塞,其余按 0 处理 int
|
||||
@@ -2770,7 +2773,7 @@ int net_recvfrom(int sockfd, void *buf, int len, int flags,
|
||||
|
||||
/*
|
||||
* 函数功能:接收 UDP 数据报(含源地址),带显式等待预算
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* buf - 接收缓冲区指针 void *
|
||||
* len - 缓冲区大小 int > 0
|
||||
* timeout_ms - 等待预算(毫秒,**> 0**;无限等待请用 net_recvfrom) uint32_t
|
||||
@@ -2818,7 +2821,7 @@ int net_udp_set_peer(int sockfd, const struct net_sockaddr_in *peer) {
|
||||
/* 执行结果 */
|
||||
int result;
|
||||
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
if (s_net_socks[sockfd].in_use == 0U) {
|
||||
@@ -2911,7 +2914,7 @@ static int net_recvfrom_impl(int sockfd, void *buf, int len, int flags,
|
||||
int result;
|
||||
|
||||
/* 参数检查(顺序与改造前一致:BADF → INVAL → 出参容量) */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_BADF;
|
||||
}
|
||||
if (s_net_socks[sockfd].in_use == 0U) {
|
||||
@@ -3048,7 +3051,7 @@ int net_close_sock(net_sock_t *p_sock) {
|
||||
}
|
||||
/*
|
||||
* 函数功能:注册 Socket 事件回调函数
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* cb - 回调函数指针 net_event_cb_t(可为 NULL 取消注册)
|
||||
* arg - 用户自定义参数指针 void *
|
||||
* 出口参数:无
|
||||
@@ -3064,7 +3067,7 @@ int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg) {
|
||||
net_sock_t *p_sock;
|
||||
|
||||
/* 参数检查 */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 描述符越界 → BADF */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -3088,7 +3091,7 @@ int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg) {
|
||||
/*
|
||||
* 函数功能:设置 Socket 阻塞/非阻塞**模式属性**(模式挂控制块属性,
|
||||
* 对齐 BSD O_NONBLOCK / Python setblocking)
|
||||
* 入口参数:sockfd - Socket 描述符 int >= 0 && < NET_MAX_SOCKETS
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* on - 1 = 阻塞(net_socket 默认);0 = 非阻塞 int
|
||||
* 出口参数:无
|
||||
* 返回值:0 - 设置成功 int
|
||||
@@ -3106,7 +3109,7 @@ int net_setblocking(int sockfd, int on) {
|
||||
net_sock_t *p_sock;
|
||||
|
||||
/* 参数检查:描述符范围 */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
/* 描述符越界 → BADF */
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
@@ -3153,7 +3156,7 @@ int net_get_errno(void) {
|
||||
*/
|
||||
int net_sock_state(int sockfd) {
|
||||
/* 描述符越界:返回 -1(不设错误码,只读查询) */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return -1;
|
||||
}
|
||||
/* 控制块未在用:返回 -1 */
|
||||
@@ -3318,7 +3321,7 @@ uint32_t net_ntohl(uint32_t netlong) {
|
||||
* 函数功能:分配一个空闲的 Socket 控制块
|
||||
* 入口参数:无
|
||||
* 出口参数:无
|
||||
* 返回值:空闲 Socket 索引(0~NET_MAX_SOCKETS-1);-1 表示无空闲 Socket int
|
||||
* 返回值:空闲 Socket 索引(0~NET_MAX_SOCKETS-1);NET_FD_INVALID 表示无空闲 int
|
||||
* 限定条件:s_net_socks 已定义
|
||||
* 函数说明:1. 线性扫描 s_net_socks,返回首个 in_use == 0 的控制块索引
|
||||
* 2. 调用方负责初始化该控制块
|
||||
@@ -3336,8 +3339,8 @@ static int alloc_socket(void) {
|
||||
}
|
||||
}
|
||||
|
||||
/* 无空闲控制块:返回 -1 */
|
||||
return -1;
|
||||
/* 无空闲控制块:返回契约失效值 */
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
|
||||
@@ -3380,7 +3383,7 @@ static void parse_ip_string(const char *str, uint8_t *ip_arr) {
|
||||
|
||||
/*
|
||||
* 函数功能:根据描述符获取 Socket 控制块指针(内部使用)
|
||||
* 入口参数:sockfd - Socket 描述符 int 0 - NET_MAX_SOCKETS-1
|
||||
* 入口参数:sockfd - Socket 描述符 int 有效 fd
|
||||
* 出口参数:无
|
||||
* 返回值:Socket 控制块指针;描述符越界或未分配时返回 NULL net_sock_t *
|
||||
* 限定条件:无
|
||||
@@ -3389,7 +3392,7 @@ static void parse_ip_string(const char *str, uint8_t *ip_arr) {
|
||||
*/
|
||||
net_sock_t *net_get_sock(int sockfd) {
|
||||
/* 描述符越界:返回 NULL */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NULL;
|
||||
}
|
||||
|
||||
@@ -3426,7 +3429,7 @@ net_sock_t *net_sock_raw(int sockfd) {
|
||||
*/
|
||||
int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen) {
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -3477,7 +3480,7 @@ int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen) {
|
||||
*/
|
||||
int net_getpeername(int sockfd, struct net_sockaddr *addr, int *addrlen) {
|
||||
/* 描述符越界 → BADF */
|
||||
if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user