merge: 合入网络 fd 失效值契约(含 104 目录重构解冲突)

把 dsh-204f318c-38b4 的网络 fd 契约工作流合入主树:NET_FD_INVALID
单一契约 + 静态门禁 + 回归测试 + 全仓审计 + 最小加固。

解冲突与集成修复:
- 5 个数值快照(RAM 文档/tsv/size_attestation/report.json)两侧各自
  过时,取主线重构后结构,合并后用权威 Keil 构建(0/0)重新回填:
  Code=365896 RO=48336 RW=2736 ZI=173104,IRAM1 90.3% / CCM 87.9%。
- iec104_net_mcu.c 的 net_fd 改动随主树 104 目录重构
  App/protocol/ → App/iec60870/ 自动迁移,路径正确。
- net-handle 豁免面从旧路径 App/protocol/iec60870/ 对齐到主树重构后的
  App/iec60870/(大写 IEC104_* 上游代码暂免检,小写 iec104_* 自研
  适配层仍受检),消除 read_socket 布尔标志的误报。

验证:net-handle 0 违规/493 文件 + selftest 42 PASS;size-gate 同码
PASS;mem 双区 <92%;本次 6 文档链接 PASS;主机套件全绿。
预存红项(ioboard_di.c / IEC60870-Slave 第三方文档)不在本次提交。
This commit is contained in:
2026-11-18 22:28:49 +08:00
52 changed files with 1964 additions and 313 deletions
+29 -2
View File
@@ -1414,8 +1414,35 @@ void ch395f_get_unreach_info(uint8_t *p_buf) {
/* 每 Socket 状态缓存(刷新点:主动回读 ch395f_get_sock_state;
* 以及 net_poll 每轮对在用 Socket 各刷一次——E2 实测 18.1us/次,
* 4 监听 ~72us 远小于 1ms 轮询周期) */
static ch395f_sock_state_t g_sock_state[8];
* 4 监听 ~72us 远小于 1ms 轮询周期)
*
* 初值**必须显式写**,不能靠零初始化:本类型的不变量是「open != OPEN 时
* tcp_state == CH395F_SOCK_STATE_NONE(无意义)」(ch395f.h 类型注释),而零初始化
* 给的是 {CLOSED, TCP_CLOSED(0x00)}——TCP=00 是一个**合法**取值(二段关闭的 05/00
* 中间态,TC-NET-1501 台架实证),于是"从未回读过"与"回读到已关闭"无法区分。
* 显式给 NONE 后不变量从启动第一刻就成立,未刷新时的读取一律落在"无意义"上。
* 行为不变(9 处生产消费点,逐处可 grep 坐实,分两档):
* 7 处先判 open 再看 tcp_state —— 本文件 ch395f_sock_is_listening、
* ch395f_cmd_done(DONE_LISTEN)、复位状态机 WAIT_CLOSE;net_events 的
* chip_listening(AND)、形态①"连接已失"OR 门(第一支 open==CLOSED 已短路)、
* 形态⑤"静默回收"(AND);net_listener 的"芯片已在听"(AND)。
* 2 处只比较 tcp_state、不判 open —— net_events 的 net_lost_connect_probe
* (目标值 ESTABLISHED=0x04)与 reconciler 的 LISTENING 分支
* (目标值 ESTABLISHED=0x04);其目标值与 0x00(TCP_CLOSED) 和
* 0xFF(NONE) 都不相交,故改前改后同样早退、同样不进。
* 而 open 的初值本来就是 CLOSED、不受本次改动影响,故仅"open=CLOSED 时的
* tcp_state"由 0x00 变 0xFF,判定结果无一处改变。代价:16B 从 ZI 移入 RW-data
* (RAM 占用不变,Flash 初始化镜像 +16B)。 */
static ch395f_sock_state_t g_sock_state[8] = {
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
{ CH395F_SOCKET_CLOSED, CH395F_SOCK_STATE_NONE },
};
/* sock_reset 非阻塞状态机槽位(每 Socket 一个;t0 用 16 位 tick 差值,
* 各阶段超时 <=2s,远小于 65535ms 回绕窗) */
+49 -39
View File
@@ -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) {
+3 -1
View File
@@ -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;
+15 -12
View File
@@ -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)
+9
View File
@@ -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 = 无限等待(阻塞模式)
+4 -4
View File
@@ -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);
}
+28
View File
@@ -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 */
+3 -3
View File
@@ -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) { /* 已在请求中:保持既有节奏(防重试饥饿) */
+10 -10
View File
@@ -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;
+2 -2
View File
@@ -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;
}
+46 -43
View File
@@ -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);
}
+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);
+8 -6
View File
@@ -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];
+19 -19
View File
@@ -85,8 +85,8 @@ static uint8_t g_lcdmem_data[4 + UI_FB_SIZE]; /* LCDMEM 应答缓冲:4B 偏
static uint8_t g_status_data[32]; /* STATUS 应答缓冲:最大 28 B,见应答注释 */
static uint8_t g_rx[RM_RX_BUF]; /* 接收暂存区:整块 recv 后逐字节喂入状态机 */
static int g_listen = -1; /* 监听 Socket fd(未启动或已停止时为 -1) */
static int g_client = -1; /* 当前客户端 Socket fd(无连接时为 -1) */
static int g_listen = NET_FD_INVALID; /* 监听 Socket fd(未启动或已停止时为失效值) */
static int g_client = NET_FD_INVALID; /* 当前客户端 Socket fd(无连接时为失效值) */
static uint16_t g_port; /* 监听端口(网络重建 / 断线后重监听用) */
static uint32_t g_gen; /* 建立监听时的网络代次号(变化 = 网络已重建) */
static uint8_t s_send_fail_run; /* 连续发送失败计数(0 = 正常) */
@@ -192,7 +192,7 @@ static int remo_send(uint8_t cmd, const uint8_t *data, uint16_t len) {
int total;
int ret;
if (g_client < 0) {
if (g_client == NET_FD_INVALID) {
return -1;
}
if (s_sink_blocked) {
@@ -586,11 +586,11 @@ static void rm_parser_feed(uint8_t b) {
* 函数说明:绑定 g_port 与任意本地地址并进入监听;成功后写回 g_listen
*/
static int bind_listen(void) {
int ls;
int ls = NET_FD_INVALID;
struct net_sockaddr_in addr;
ls = net_socket(NET_AF_INET, NET_SOCK_STREAM);
if (ls < 0) {
if (ls == NET_FD_INVALID) {
return -1;
}
@@ -624,11 +624,11 @@ int ui_net_sink_start(uint16_t port) {
g_port = port;
if (bind_listen() < 0) {
g_listen = -1;
g_listen = NET_FD_INVALID;
return -1;
}
g_client = -1;
g_client = NET_FD_INVALID;
g_gen = net_get_generation();
rm_parser_reset();
return 0;
@@ -661,15 +661,15 @@ void ui_net_sink_poll(void) {
/* 网络重建(代次变化):旧监听/客户端已随芯片复位失效,重建监听 */
if (net_get_generation() != g_gen) {
if (g_client >= 0 && g_client != g_listen) {
if (g_client != NET_FD_INVALID && g_client != g_listen) {
net_close(g_client);
}
if (g_listen >= 0) {
if (g_listen != NET_FD_INVALID) {
net_close(g_listen);
g_listen = -1;
g_listen = NET_FD_INVALID;
}
sink_beat(); /* F3:重建前的一对 close 往返结束 */
g_client = -1;
g_client = NET_FD_INVALID;
rm_parser_reset();
s_send_fail_run = 0U; /* 网络重建:失败累计清零、解除推送阻断 */
s_sink_blocked = 0U;
@@ -678,7 +678,7 @@ void ui_net_sink_poll(void) {
return;
}
if (g_listen < 0) {
if (g_listen == NET_FD_INVALID) {
/* 尚未启动或启动失败:重试(成功则 g_listen 更新) */
(void)ui_net_sink_start(g_port);
return;
@@ -690,19 +690,19 @@ void ui_net_sink_poll(void) {
* 内恒 0 → :7003 永不进 net_accept → net_lost_connect_probe 对该端口等于
* 从未运行(CONNECT 事件未收到时无第二信源);armed 放行后由 net_accept_locked
* 的状态门自行裁决(含 RX 有数据的 closed-but-readable 接受) */
if (g_client < 0) {
if (g_client == NET_FD_INVALID) {
if (net_listener_armed(g_listen) == 0) {
/* 监听器已不在服役(fd 消失 / 非监听型)→ 置 -1 交回上方
* g_listen < 0 分支重建监听。改前靠"每轮都 accept"撞出 BADF 来暴露,
* 加了门控就必须显式兜这一条,否则端口永久不再接受新客户端 */
if (net_get_sock(g_listen) == NULL) {
g_listen = -1;
g_listen = NET_FD_INVALID;
}
return;
}
int c = net_accept(g_listen, NULL, NULL);
sink_beat(); /* F3:accept 往返返回即喂(风暴期该往返实测 150ms 级) */
if (c >= 0) {
if (c != NET_FD_INVALID) {
g_client = c;
rm_parser_reset();
s_send_fail_run = 0U; /* 新连接:失败累计清零、解除推送阻断 */
@@ -738,7 +738,7 @@ void ui_net_sink_poll(void) {
if (g_client != g_listen) {
net_close(g_client); /* 多连接后端(PC 模拟器):数据通道独立,需显式关闭 */
}
g_client = -1;
g_client = NET_FD_INVALID;
rm_parser_reset();
/* 监听生命周期 P1 不变量 II:重建**不再**由本处自行 bind_listen。
* ① net_recv_locked 的 EOF 分支已触发 auto_relisten(D10 非阻塞重试);
@@ -748,7 +748,7 @@ void ui_net_sink_poll(void) {
* 仅当 fd 真消失(net_get_sock 返 NULL = 网络重建)才置 -1,交回上方
* 分支重新走 start → bind_listen */
if (net_get_sock(g_listen) == NULL) {
g_listen = -1; /* fd 真消失:交回主循环重试 */
g_listen = NET_FD_INVALID; /* fd 真消失:交回主循环重试 */
}
} else {
/* n < 0:区分"暂无数据"(继续等待)与"真错误"(断开并视情况重建监听) */
@@ -762,13 +762,13 @@ void ui_net_sink_poll(void) {
net_close(g_client); /* 多连接后端(PC 模拟器):数据通道独立,需显式关闭 */
}
sink_beat(); /* F3:EOF/错误路径的 close 往返结束 */
g_client = -1;
g_client = NET_FD_INVALID;
rm_parser_reset();
/* 监听生命周期 P1 不变量 II:同 EOF 分支——不再自行 bind_listen,
* 重建交回 net 层(recv 的错误分支同样会走 relisten)。仅 fd 真消失
* 时置 -1 交回主循环走 start */
if (net_get_sock(g_listen) == NULL) {
g_listen = -1; /* fd 真消失:交回主循环重试 */
g_listen = NET_FD_INVALID; /* fd 真消失:交回主循环重试 */
}
}
}
+10 -4
View File
@@ -64,10 +64,16 @@ static const uint8_t k_cl_id[CL_ROW_N] = {
UI_W_REC_LOG_START, UI_W_REC_LOG_OPER, UI_W_REC_LOG_YK
};
static uint8_t s_confirm; /* 待确认行(第一次 ENTER 已按下),CL_NONE = 无 */
static uint8_t s_note; /* 已投递、要显示清除结果的行,CL_NONE = 无 */
static uint8_t s_err; /* 投递被拒的行,CL_NONE = 无 */
static uint16_t s_sel_seen; /* 上一次绘制时的选中行(移开光标即收回三个锁存) */
/* 三个锁存的失效值一律在声明处写死:行号 0 是合法行("运行记录"),零初始化等于
* "行 0 上有结果",只能靠 pg_init 在开页时覆盖掉——把正确性押在调用顺序上。声明处
* 给 CL_NONE 后,.bss 阶段即满足"无行",pg_init 仍照旧重设(幂等)。 */
static uint8_t s_confirm = CL_NONE; /* 待确认行(第一次 ENTER 已按下),CL_NONE = 无 */
static uint8_t s_note = CL_NONE; /* 已投递、要显示清除结果的行,CL_NONE = 无 */
static uint8_t s_err = CL_NONE; /* 投递被拒的行,CL_NONE = 无 */
/* 本变量不是"无行"锁存,而是"上次绘制时看到的选中行":零值=行 0(合法),且只在
* pg_draw 里与当前选中行比较,三个锁存已有声明初值后它取任何初值都不影响安全,
* 故不套 CL_NONE(0xFF 不是合法行号,用了反而误导) */
static uint16_t s_sel_seen; /* 上一次绘制时的选中行(移开光标即收回三个锁存) */
/* 函数定义区 */