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:
@@ -380,13 +380,14 @@ static int cmd_dele(lftpd_client_t *client, const char *arg)
|
||||
|
||||
static int cmd_epsv(lftpd_client_t *client, const char *arg)
|
||||
{
|
||||
if (client->data_socket >= 0) {
|
||||
if (client->data_socket != NET_FD_INVALID) {
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
}
|
||||
|
||||
int listener_socket = lftpd_inet_listen(0);
|
||||
if (listener_socket < 0) {
|
||||
int listener_socket = NET_FD_INVALID;
|
||||
listener_socket = lftpd_inet_listen(0);
|
||||
if (listener_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
@@ -414,19 +415,20 @@ static int cmd_feat(lftpd_client_t *client, const char *arg)
|
||||
|
||||
static int cmd_list(lftpd_client_t *client, const char *arg)
|
||||
{
|
||||
if (client->data_socket == -1) {
|
||||
if (client->data_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
|
||||
send_simple_response(client->socket, 150, STATUS_150);
|
||||
int data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock < 0) {
|
||||
int data_sock = NET_FD_INVALID;
|
||||
data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock == NET_FD_INVALID) {
|
||||
lftpd_log_peer("%s data accept failed (peer gone?), sk=%d",
|
||||
__func__, client->data_socket);
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
return -1;
|
||||
}
|
||||
|
||||
@@ -435,7 +437,7 @@ static int cmd_list(lftpd_client_t *client, const char *arg)
|
||||
* 不关会让客户端一直读到超时(曾试"优雅断开+复用监听器"方案,因该语义限制
|
||||
* 与芯片行为未能稳定工作,见 链路延迟测试说明.md §8.2)。 */
|
||||
lftpd_inet_close(data_sock);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
|
||||
if (err == 0) {
|
||||
send_simple_response(client->socket, 226, STATUS_226);
|
||||
@@ -447,19 +449,20 @@ static int cmd_list(lftpd_client_t *client, const char *arg)
|
||||
|
||||
static int cmd_nlst(lftpd_client_t *client, const char *arg)
|
||||
{
|
||||
if (client->data_socket == -1) {
|
||||
if (client->data_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
|
||||
send_simple_response(client->socket, 150, STATUS_150);
|
||||
int data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock < 0) {
|
||||
int data_sock = NET_FD_INVALID;
|
||||
data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock == NET_FD_INVALID) {
|
||||
lftpd_log_peer("%s data accept failed (peer gone?), sk=%d",
|
||||
__func__, client->data_socket);
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
return -1;
|
||||
}
|
||||
|
||||
@@ -468,7 +471,7 @@ static int cmd_nlst(lftpd_client_t *client, const char *arg)
|
||||
* 不关会让客户端一直读到超时(曾试"优雅断开+复用监听器"方案,因该语义限制
|
||||
* 与芯片行为未能稳定工作,见 链路延迟测试说明.md §8.2)。 */
|
||||
lftpd_inet_close(data_sock);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
|
||||
if (err == 0) {
|
||||
send_simple_response(client->socket, 226, STATUS_226);
|
||||
@@ -518,15 +521,16 @@ static int cmd_pass(lftpd_client_t *client, const char *arg)
|
||||
|
||||
static int cmd_pasv(lftpd_client_t *client, const char *arg)
|
||||
{
|
||||
if (client->data_socket >= 0) {
|
||||
if (client->data_socket != NET_FD_INVALID) {
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
}
|
||||
|
||||
/* 原 3×200ms 应用层重试已删(lftpd_inet_listen 单次化)——
|
||||
* 失败直接 425,FTP 客户端自带传输重试语义;服务端不再叠阻塞重试 */
|
||||
int listener_socket = lftpd_inet_listen(0);
|
||||
if (listener_socket < 0) {
|
||||
int listener_socket = NET_FD_INVALID;
|
||||
listener_socket = lftpd_inet_listen(0);
|
||||
if (listener_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
@@ -578,19 +582,20 @@ static int cmd_quit(lftpd_client_t *client, const char *arg)
|
||||
|
||||
static int cmd_retr(lftpd_client_t *client, const char *arg)
|
||||
{
|
||||
if (client->data_socket == -1) {
|
||||
if (client->data_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
|
||||
send_simple_response(client->socket, 150, STATUS_150);
|
||||
int data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock < 0) {
|
||||
int data_sock = NET_FD_INVALID;
|
||||
data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock == NET_FD_INVALID) {
|
||||
lftpd_log_peer("%s data accept failed (peer gone?), sk=%d",
|
||||
__func__, client->data_socket);
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
return -1;
|
||||
}
|
||||
|
||||
@@ -601,7 +606,7 @@ static int cmd_retr(lftpd_client_t *client, const char *arg)
|
||||
* 不关会让客户端一直读到超时(曾试"优雅断开+复用监听器"方案,因该语义限制
|
||||
* 与芯片行为未能稳定工作,见 链路延迟测试说明.md §8.2)。 */
|
||||
lftpd_inet_close(data_sock);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
|
||||
if (err == 0) {
|
||||
lftpd_log_info("DOWNLOAD '%s' OK", path);
|
||||
@@ -646,19 +651,20 @@ static int cmd_stor(lftpd_client_t *client, const char *arg)
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (client->data_socket == -1) {
|
||||
if (client->data_socket == NET_FD_INVALID) {
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
return -1;
|
||||
}
|
||||
|
||||
send_simple_response(client->socket, 150, STATUS_150);
|
||||
int data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock < 0) {
|
||||
int data_sock = NET_FD_INVALID;
|
||||
data_sock = lftpd_inet_accept_timeout(client->data_socket, 5000);
|
||||
if (data_sock == NET_FD_INVALID) {
|
||||
lftpd_log_peer("%s data accept failed (peer gone?), sk=%d",
|
||||
__func__, client->data_socket);
|
||||
send_simple_response(client->socket, 425, STATUS_425);
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
return -1;
|
||||
}
|
||||
|
||||
@@ -669,7 +675,7 @@ static int cmd_stor(lftpd_client_t *client, const char *arg)
|
||||
* 不关会让客户端一直读到超时(曾试"优雅断开+复用监听器"方案,因该语义限制
|
||||
* 与芯片行为未能稳定工作,见 链路延迟测试说明.md §8.2)。 */
|
||||
lftpd_inet_close(data_sock);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
|
||||
if (err == 0) {
|
||||
uint32_t size = 0;
|
||||
@@ -798,9 +804,9 @@ static int handle_control_channel(lftpd_client_t *client)
|
||||
|
||||
cleanup:
|
||||
/* 数据监听器在复用模式下会跨命令保留,会话结束必须显式释放(否则每次会话泄漏一个 Socket) */
|
||||
if (client->data_socket >= 0) {
|
||||
if (client->data_socket != NET_FD_INVALID) {
|
||||
lftpd_inet_close(client->data_socket);
|
||||
client->data_socket = -1;
|
||||
client->data_socket = NET_FD_INVALID;
|
||||
}
|
||||
/* 控制通道不得 close:单连接模型下它即监听器(fd 与监听一体),EOF/断连时
|
||||
* net 层已 auto_relisten 回 LISTEN;此处 close 会连监听一起毁掉并触发
|
||||
@@ -815,7 +821,7 @@ int lftpd_start(const char *directory, int port, lftpd_t *lftpd)
|
||||
|
||||
lftpd->directory = directory;
|
||||
lftpd->port = port;
|
||||
lftpd->server_socket = -1; /* memset 清零后显式置"无监听器"(0 是合法 fd) */
|
||||
lftpd->server_socket = NET_FD_INVALID; /* memset 清零后显式置"无监听器"(0 是合法 fd) */
|
||||
|
||||
/* 出厂默认口令在用告警(台架锚点;改了 [ftp] pwd_hash 即消失) */
|
||||
if (ftp_cfg_is_default_pwd() != 0) {
|
||||
@@ -824,10 +830,10 @@ int lftpd_start(const char *directory, int port, lftpd_t *lftpd)
|
||||
|
||||
while (true) {
|
||||
lftpd_task_wd_beat(); /* 看门狗:事件循环每轮喂心跳(ftpTask 主循环节拍点) */
|
||||
if (lftpd->server_socket < 0) {
|
||||
if (lftpd->server_socket == NET_FD_INVALID) {
|
||||
/* 首次启动 / 网络重建后:全量创建监听器(socket+bind+listen) */
|
||||
lftpd->server_socket = lftpd_inet_listen(port);
|
||||
if (lftpd->server_socket < 0) {
|
||||
if (lftpd->server_socket == NET_FD_INVALID) {
|
||||
lftpd_log_error("error creating listener");
|
||||
/* 看门狗:3s 重试等待拆短片喂心跳(单次 3s 挂起超 IWDG 最坏窗
|
||||
* ~1.7s → 误复位;与 time_sync.c 监听重试同模式) */
|
||||
@@ -848,11 +854,12 @@ int lftpd_start(const char *directory, int port, lftpd_t *lftpd)
|
||||
|
||||
lftpd_log_info("waiting for connection...");
|
||||
|
||||
int client_socket = lftpd_inet_accept(lftpd->server_socket);
|
||||
if (client_socket < 0) {
|
||||
int client_socket = NET_FD_INVALID;
|
||||
client_socket = lftpd_inet_accept(lftpd->server_socket);
|
||||
if (client_socket == NET_FD_INVALID) {
|
||||
lftpd_log_peer("listener rebuilt (reason logged by accept layer)");
|
||||
lftpd_inet_close(lftpd->server_socket);
|
||||
lftpd->server_socket = -1; /* 监听器已不可用(网络重建):下轮重建 */
|
||||
lftpd->server_socket = NET_FD_INVALID; /* 监听器已不可用(网络重建):下轮重建 */
|
||||
continue;
|
||||
}
|
||||
|
||||
@@ -876,12 +883,15 @@ int lftpd_start(const char *directory, int port, lftpd_t *lftpd)
|
||||
}
|
||||
}
|
||||
|
||||
static lftpd_client_t client; /* static: off-stack session context (single session) */
|
||||
static lftpd_client_t client = { /* static: off-stack session context (single session) */
|
||||
.socket = NET_FD_INVALID,
|
||||
.data_socket = NET_FD_INVALID,
|
||||
};
|
||||
memset(&client, 0, sizeof(client));
|
||||
strncpy(client.directory, directory, sizeof(client.directory) - 1);
|
||||
client.directory[sizeof(client.directory) - 1] = '\0';
|
||||
client.socket = client_socket;
|
||||
client.data_socket = -1;
|
||||
client.data_socket = NET_FD_INVALID;
|
||||
|
||||
lftpd->client = &client;
|
||||
handle_control_channel(&client);
|
||||
@@ -894,7 +904,7 @@ int lftpd_start(const char *directory, int port, lftpd_t *lftpd)
|
||||
|
||||
int lftpd_stop(lftpd_t *lftpd)
|
||||
{
|
||||
if (lftpd->server_socket >= 0) {
|
||||
if (lftpd->server_socket != NET_FD_INVALID) {
|
||||
lftpd_inet_close(lftpd->server_socket);
|
||||
}
|
||||
if (lftpd->client) {
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
typedef struct {
|
||||
char directory[256];
|
||||
/* 两个 fd 均遵循 NET_FD_INVALID 契约:0 是合法 fd,失效值只认 NET_FD_INVALID
|
||||
* (docs/网络/网络句柄失效值契约.md);对象 memset 后必须在 5 行内重置 */
|
||||
int socket;
|
||||
int data_socket;
|
||||
/* FTP 鉴权会话态(每会话 memset 0 = 未登录;跨会话锁定计数在
|
||||
@@ -16,7 +18,7 @@ typedef struct {
|
||||
typedef struct {
|
||||
const char *directory;
|
||||
int port;
|
||||
int server_socket;
|
||||
int server_socket; /* 监听 fd;无监听器 = NET_FD_INVALID(0 是合法 fd) */
|
||||
lftpd_client_t *client;
|
||||
} lftpd_t;
|
||||
|
||||
|
||||
@@ -37,10 +37,11 @@ int lftpd_inet_listen(int port)
|
||||
* 监听交给 FTP 客户端自身的重试语义(主流 FTP 服务器 passive listen 失败
|
||||
* 亦直接 425,不在服务端叠应用层阻塞重试) */
|
||||
lftpd_task_wd_beat(); /* 看门狗:入口喂心跳 */
|
||||
int s = net_socket(NET_AF_INET, NET_SOCK_STREAM);
|
||||
if (s < 0) {
|
||||
int s = NET_FD_INVALID;
|
||||
s = net_socket(NET_AF_INET, NET_SOCK_STREAM);
|
||||
if (s == NET_FD_INVALID) {
|
||||
DBG_ERROR("create socket");
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
struct net_sockaddr_in addr;
|
||||
@@ -51,7 +52,7 @@ int lftpd_inet_listen(int port)
|
||||
if (net_bind(s, (struct net_sockaddr *)&addr, sizeof(addr)) < 0) {
|
||||
DBG_ERROR("bind port %d", port);
|
||||
net_close(s);
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
if (net_listen(s) >= 0) {
|
||||
@@ -60,7 +61,7 @@ int lftpd_inet_listen(int port)
|
||||
|
||||
DBG_ERROR("listen port %d failed", port);
|
||||
net_close(s);
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
int lftpd_inet_get_socket_port(int socket)
|
||||
@@ -83,14 +84,15 @@ int lftpd_inet_accept(int socket)
|
||||
uint32_t gen = net_get_generation();
|
||||
|
||||
while (1) {
|
||||
int s = net_accept(socket, NULL, NULL);
|
||||
if (s >= 0) {
|
||||
int s = NET_FD_INVALID;
|
||||
s = net_accept(socket, NULL, NULL);
|
||||
if (s != NET_FD_INVALID) {
|
||||
return s;
|
||||
}
|
||||
if (net_get_generation() != gen) {
|
||||
/* 运维改 IP 的正常后果,不是缺陷 → info(级别划分见存储架构说明 §10.3) */
|
||||
DBG_INFO("network re-init: abort accept, relisten");
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
lftpd_task_wd_beat(); /* 看门狗:自旋轮次喂心跳(无限等待,可能长时间无客户端) */
|
||||
vTaskDelay(pdMS_TO_TICKS(100));
|
||||
@@ -102,8 +104,9 @@ int lftpd_inet_accept_timeout(int socket, int timeout_ms)
|
||||
int elapsed = 0;
|
||||
|
||||
while (elapsed < timeout_ms) {
|
||||
int s = net_accept(socket, NULL, NULL);
|
||||
if (s >= 0) {
|
||||
int s = NET_FD_INVALID;
|
||||
s = net_accept(socket, NULL, NULL);
|
||||
if (s != NET_FD_INVALID) {
|
||||
return s;
|
||||
}
|
||||
/* M2 镜像门控退役(自愈专项实验 2026-10-12;沉降门失效族收口,
|
||||
@@ -115,7 +118,7 @@ int lftpd_inet_accept_timeout(int socket, int timeout_ms)
|
||||
/* **故意留 error**:控制连接还活着、我方数据监听却已不在服役 →
|
||||
* 这是本侧异常,不是对端行为 */
|
||||
DBG_ERROR("data listener disarmed, accept aborted");
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
lftpd_task_wd_beat(); /* 看门狗:每轮喂心跳(数据连接等待最长 5s) */
|
||||
vTaskDelay(pdMS_TO_TICKS(100));
|
||||
@@ -124,7 +127,7 @@ int lftpd_inet_accept_timeout(int socket, int timeout_ms)
|
||||
|
||||
/* 客户端连上控制通道却没来建数据连接(中止/被防火墙拦)= 对端行为 → info */
|
||||
DBG_INFO("accept timeout (%dms) - peer never opened data channel", timeout_ms);
|
||||
return -1;
|
||||
return NET_FD_INVALID;
|
||||
}
|
||||
|
||||
int lftpd_inet_read_line(int socket, char *buffer, size_t buffer_len)
|
||||
|
||||
@@ -26,6 +26,8 @@
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#include "net_fd.h" /* NET_FD_INVALID:fd 失效值契约(零依赖头) */
|
||||
|
||||
/*
|
||||
* 最大支持的 Socket 数量(CH395F 支持 0~7)
|
||||
*/
|
||||
@@ -33,6 +35,13 @@ extern "C" {
|
||||
#define NET_MAX_SOCKETS 8
|
||||
#endif
|
||||
|
||||
/*
|
||||
* fd 区间校验(**net 层内部专用**,契约 C4):0 号是合法句柄,NET_FD_INVALID
|
||||
* 与一切越界值均无效。上界只在本头 / net 层内部出现,应用层判"是否持有 fd"
|
||||
* 一律只与 NET_FD_INVALID 比较(docs/网络/网络句柄失效值契约.md)。
|
||||
*/
|
||||
#define NET_FD_IN_RANGE(fd) (((fd) > NET_FD_INVALID) && ((fd) < NET_MAX_SOCKETS))
|
||||
|
||||
/*
|
||||
* 超时时间配置(毫秒)
|
||||
* 0 = 无限等待(阻塞模式)
|
||||
|
||||
@@ -282,9 +282,9 @@ void handle_disconnect_event(net_sock_t *p_sock) {
|
||||
* +100ms 沉降落在窗内不可见。沉降窗口同时让残渣 DISCONNECT 在 state==CLOSED
|
||||
* (无害、仅留痕)时被消费,断开"杀下一条 → 新拆链 → 再杀"的繁殖链 */
|
||||
{
|
||||
/* fd 取自 uint8_t ch395_sock → 恒非负,只需上界门 */
|
||||
/* fd 取自 uint8_t ch395_sock → 恒为有效值,此处只复核 fd 域上界 */
|
||||
int qfd = (int)p_sock->ch395_sock;
|
||||
if (qfd < NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(qfd) != 0) {
|
||||
/* 登记优雅沉降(NET_RELISTEN_SETTLE_GRACEFUL) */
|
||||
net_listener_settle(qfd, NET_LISTENER_SETTLE_GRACEFUL);
|
||||
}
|
||||
@@ -374,9 +374,9 @@ void handle_timeout_event(net_sock_t *p_sock) {
|
||||
/* TRAP-NET-18:异常释放(TIMEOUT,例如客户端中止上传)→ 复监听前隔离,
|
||||
* 等对端在途数据落尽并排空 RX 残渣(详见 net_relisten_locked 区块注释) */
|
||||
{
|
||||
/* fd 取自 uint8_t ch395_sock → 恒非负,只需上界门 */
|
||||
/* fd 取自 uint8_t ch395_sock → 恒为有效值,此处只复核 fd 域上界 */
|
||||
int qfd = (int)p_sock->ch395_sock;
|
||||
if (qfd < NET_MAX_SOCKETS) {
|
||||
if (NET_FD_IN_RANGE(qfd) != 0) {
|
||||
/* 登记异常释放隔离(重监听前等待在途数据落尽 + RX 排空) */
|
||||
net_listener_settle(qfd, NET_LISTENER_SETTLE_QUARANTINE);
|
||||
}
|
||||
|
||||
@@ -0,0 +1,28 @@
|
||||
/*
|
||||
* 模块名称: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 */
|
||||
@@ -237,7 +237,7 @@ static int net_relisten_locked(int sockfd) {
|
||||
* 函数说明:只置事实、不做动作(动作只在 net_listener_tick 一处发生);越界静默忽略。
|
||||
*/
|
||||
void net_listener_settle(int sockfd, net_listener_settle_t level) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
s_relisten_quarantine[sockfd] = (uint8_t)level;
|
||||
@@ -252,7 +252,7 @@ void net_listener_settle(int sockfd, net_listener_settle_t level) {
|
||||
* 上一轮的 400/800ms 等待(跨轮残留);上限留痕标志漏清则下一生成静默无声。
|
||||
*/
|
||||
void net_listener_clear(int sockfd) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
s_relisten_req[sockfd] = 0U;
|
||||
@@ -292,7 +292,7 @@ static void net_relisten_done(int sockfd) {
|
||||
* 3. 非阻塞:实际重建发生在下一轮 tick;越界静默忽略。
|
||||
*/
|
||||
void net_listener_request(int sockfd, net_listener_req_t reason) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
if (s_relisten_req[sockfd] != 0U) { /* 已在请求中:保持既有节奏(防重试饥饿) */
|
||||
|
||||
@@ -80,7 +80,7 @@ static void net_pending_complete(int sockfd, int result) {
|
||||
net_pending_t *p;
|
||||
|
||||
/* 描述符越界:静默返回(防重复通知) */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
/* 取挂起请求 */
|
||||
@@ -122,7 +122,7 @@ int net_pending_register(int sockfd, void *buf, int len,
|
||||
uint32_t now;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
/* 取挂起请求 */
|
||||
@@ -318,7 +318,7 @@ void net_pending_tick(net_sock_t *p_socks) {
|
||||
*/
|
||||
int net_pending_active(int sockfd) {
|
||||
/* 描述符越界:视为无挂起 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return 0;
|
||||
}
|
||||
return (s_net_pending[sockfd].active != 0U) ? 1 : 0;
|
||||
@@ -335,7 +335,7 @@ int net_pending_active(int sockfd) {
|
||||
*/
|
||||
void net_pending_clear(int sockfd) {
|
||||
/* 描述符越界:直接返回 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
/* 挂起状态清零(静默,不发通知) */
|
||||
@@ -390,7 +390,7 @@ void net_pending_settle_close(int sockfd, net_sock_t *p_sock) {
|
||||
int avail;
|
||||
|
||||
/* 描述符越界或无在位挂起:静默返回 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
if (s_net_pending[sockfd].active == 0U) {
|
||||
@@ -447,7 +447,7 @@ static void net_send_pending_complete(int sockfd, int result) {
|
||||
net_send_pending_t *p;
|
||||
|
||||
/* 描述符越界:静默返回(防重复通知) */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
/* 取挂起请求 */
|
||||
@@ -479,7 +479,7 @@ int net_send_pending_register(int sockfd, const void *buf, int len, int sent,
|
||||
uint32_t now;
|
||||
|
||||
/* 描述符越界 → BADF */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
/* 参数非法(缓冲无效 / 长度非正 / 进度越界)→ INVAL */
|
||||
@@ -632,7 +632,7 @@ void net_send_pending_tick(net_sock_t *p_socks) {
|
||||
*/
|
||||
void net_send_pending_clear(int sockfd) {
|
||||
/* 描述符越界:直接返回 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
/* 挂起状态清零(静默,不发通知) */
|
||||
@@ -654,7 +654,7 @@ void net_send_pending_cancel(int sockfd, int err) {
|
||||
const net_send_pending_t *p;
|
||||
|
||||
/* 描述符越界:静默返回 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
/* 取挂起请求 */
|
||||
@@ -698,7 +698,7 @@ void net_send_pending_cancel_all(int err) {
|
||||
*/
|
||||
int net_send_pending_active(int sockfd) {
|
||||
/* 描述符越界:视为无挂起 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return 0;
|
||||
}
|
||||
return (s_net_send[sockfd].active != 0U) ? 1 : 0;
|
||||
|
||||
@@ -184,7 +184,7 @@ int net_poll_events(net_pollfd_t *fds, int nfds, int timeout) {
|
||||
fds[i].revents = 0;
|
||||
|
||||
/* 检查 fd 有效性 */
|
||||
if ((fds[i].fd < 0) || (fds[i].fd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(fds[i].fd) == 0) {
|
||||
fds[i].revents |= NET_POLLNVAL;
|
||||
ready++;
|
||||
continue;
|
||||
@@ -324,7 +324,7 @@ static int check_socket_error(int sockfd) {
|
||||
const net_sock_t *p_sock;
|
||||
|
||||
/* 无效 fd 视为错误 */
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return 1;
|
||||
}
|
||||
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -41,6 +41,8 @@
|
||||
#define NET_UDP_HDR_IP_OFF 4U
|
||||
/* 截断数据报的排空粒度(字节):读空不丢后续包,只在调用方缓冲偏小时走这条路 */
|
||||
#define NET_UDP_DRAIN_CHUNK 64U
|
||||
/* 上电芯片默认只给低位 Socket 分配收发缓冲;从该编号起须兜底重设(手册 §5.45) */
|
||||
#define NET_UDP_REBUF_FIRST 4
|
||||
|
||||
/*
|
||||
* 私有类型定义区
|
||||
@@ -102,7 +104,7 @@ static void net_udp_req_complete(int sockfd, int result);
|
||||
* 拒绝比交错投递安全(TCP 挂起 recv 同一守卫,见 net_pending_register)。
|
||||
*/
|
||||
int net_udp_outparam_arm(int sockfd, struct net_sockaddr *src_addr, int *addrlen) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return NET_ERR_RETURN_1(NET_ERR_BADF);
|
||||
}
|
||||
|
||||
@@ -129,7 +131,7 @@ int net_udp_outparam_arm(int sockfd, struct net_sockaddr *src_addr, int *addrlen
|
||||
* 调用方侧"消息没投出去"的清理,防槽位泄漏把该 fd 永久钉成 BUSY。
|
||||
*/
|
||||
void net_udp_outparam_disarm(int sockfd) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -155,7 +157,7 @@ void net_udp_outparam_disarm(int sockfd) {
|
||||
* 调用方侧通知已在各 settle/cancel 路径发过,这里只做幂等归零。
|
||||
*/
|
||||
void net_udp_clear(int sockfd) {
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
(void)memset(&s_net_udp[sockfd], 0, sizeof(s_net_udp[sockfd]));
|
||||
@@ -212,7 +214,7 @@ int net_udp_bind_exec(int sockfd, uint16_t local_port) {
|
||||
|
||||
/* net_init 已为全部 8 个 Socket 分配缓冲;此处仅对 Socket 4~7 兜底重设,
|
||||
* 布局与 net_init 一致(固定 6 块/Socket,与 MSS 解耦) */
|
||||
if (sockfd >= 4) {
|
||||
if (sockfd >= NET_UDP_REBUF_FIRST) {
|
||||
/* 每 Socket 块数 = 接收 + 发送 */
|
||||
uint8_t blocks_per_socket = (uint8_t)(CH395F_RECV_BLOCKS + CH395F_SEND_BLOCKS);
|
||||
/* 本 Socket 接收缓冲起始块 */
|
||||
@@ -548,7 +550,7 @@ void net_udp_settle_close(int sockfd, net_sock_t *p_sock) {
|
||||
/* 芯片侧可用字节 */
|
||||
int avail;
|
||||
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
p = &s_net_udp[sockfd];
|
||||
@@ -585,7 +587,7 @@ static void net_udp_req_complete(int sockfd, int result) {
|
||||
/* 本 fd 接收槽 */
|
||||
net_udp_req_t *p;
|
||||
|
||||
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
|
||||
if (NET_FD_IN_RANGE(sockfd) == 0) {
|
||||
return;
|
||||
}
|
||||
p = &s_net_udp[sockfd];
|
||||
|
||||
Reference in New Issue
Block a user