Files
STM32F4-Base/test/host/lftpd_inet/stub/net_socket.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

37 lines
1.7 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.
/*
* 模块名称:主机侧单测桩 - net_socket.h(lftpd_inet 模块专用)
* 模块功能:给 FTP 的 inet 适配层一个可控的 socket 面。地址结构与 NET_AF_INET /
* NET_SOCK_STREAM 一律取**真实** net_types.h(sin_port 的注释就写着
* "网络字节序",本模块的 htons/ntohs 契约靠它才钉得住);下面这些函数
* 原型与真实 net_socket.h 逐字一致(不一致就会在被测代码的调用点报错)。
* ⚠ 仅供主机侧单测使用,不参与 MCU 构建。真实 net_socket.h 带整条 netTask 消息队列
* 与芯片依赖,PC 上编不动。
* 创建日期:2026-10-23
*/
#ifndef NET_SOCKET_H
#define NET_SOCKET_H
#include "net_fd.h" /* NET_FD_INVALID:与生产同一份契约(stub 不复制失效值) */
/* 真实 net_socket.h 会把 FreeRTOS.h / task.h 一起带给调用方,
* lftpd_inet.c 正是靠那条链拿 TickType_t / vTaskDelay / pdMS_TO_TICKS,
* 所以桩必须照做同样的 include(少一行就是 C2065 未声明)。 */
#include "FreeRTOS.h"
#include "task.h"
#include "net_types.h"
int net_socket(int domain, int type);
int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen);
int net_listen(int sockfd);
int net_close(int sockfd);
int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen);
int net_send(int sockfd, const void *buf, int len, int flags);
int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms);
int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen);
uint16_t net_htons(uint16_t hostshort);
uint16_t net_ntohs(uint16_t netshort);
uint32_t net_get_generation(void);
int net_listener_armed(int sockfd);
#endif /* NET_SOCKET_H */