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
+23 -4
View File
@@ -53,12 +53,20 @@ typedef enum {
typedef struct {
uintptr_t handle; /* 0 = 空闲;非 0 单调,不复用 */
int fd; /* net 层 fd,同 fd 模型下 LISTEN/CLIENT 相同 */
int fd; /* net 层 fd(0 合法;失效值只认 NET_FD_INVALID) */
uint32_t net_gen; /* 成功 Listen 时的网络代次,跨代旧句柄一律失效 */
uint8_t role; /* slot_role_t */
} slot_t;
static slot_t s_slots[IEC104_MCU_MAP_SIZE];
/* 槽位初值:fd 必须显式写成契约失效值,禁止依赖静态零初始化(0 是合法 fd)。
* 条目数必须等于 IEC104_MCU_MAP_SIZE(8)。 */
#define IEC104_SLOT_INIT { .handle = 0U, .fd = NET_FD_INVALID, \
.net_gen = 0U, .role = SLOT_FREE }
static slot_t s_slots[IEC104_MCU_MAP_SIZE] = {
IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT,
IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT,
};
static uintptr_t s_next_handle = 1U;
static uint8_t s_inited;
@@ -174,6 +182,7 @@ static void client_slot_drop(slot_t *slot)
/* 代次自锁:跨代槽的 fd 号可能已被复用,绝不能对它做任何硬件读取/拆除。 */
if (slot->net_gen != net_get_generation()) {
memset(slot, 0, sizeof(*slot));
slot->fd = NET_FD_INVALID;
return;
}
state = net_sock_state(slot->fd);
@@ -185,6 +194,7 @@ static void client_slot_drop(slot_t *slot)
}
/* 只清客户端槽;监听槽的 handle/fd/net_gen/role 原地不动。 */
memset(slot, 0, sizeof(*slot));
slot->fd = NET_FD_INVALID;
}
/* 函数功能:分配一个新句柄值(单调递增、永不复用),必要时先整表作废重启。
@@ -198,6 +208,9 @@ static uintptr_t handle_new(void)
uintptr_t h = s_next_handle;
if (h >= (uintptr_t)(UINTPTR_MAX - IEC104_MCU_MAP_SIZE)) {
memset(s_slots, 0, sizeof(s_slots));
for (uint32_t i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) {
s_slots[i].fd = NET_FD_INVALID;
}
h = 1U;
}
s_next_handle = h + 1U;
@@ -214,6 +227,9 @@ IEC104_NetResult_t IEC104_Net_Init(int *native_error)
* 这里只清后端映射表、不向任何旧 fd 发 net_close_sock——fd 号可能已被
* 复用,误关会打掉新会话。不变量见本文件头。 */
memset(s_slots, 0, sizeof(s_slots));
for (uint32_t i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) {
s_slots[i].fd = NET_FD_INVALID;
}
s_next_handle = 1U;
s_rx_bytes = 0U;
s_inited = 1U;
@@ -235,7 +251,8 @@ IEC104_NetResult_t IEC104_Net_Listen(
const char *bind_address, uint16_t port, IEC104_NetSocket_t *listener,
uint16_t *bound_port, int *native_error)
{
int fd, rc, addrlen;
int fd = NET_FD_INVALID;
int rc, addrlen;
uint32_t i;
uint32_t ip;
struct net_sockaddr_in addr;
@@ -259,6 +276,7 @@ IEC104_NetResult_t IEC104_Net_Listen(
for (i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) {
if (s_slots[i].handle != 0U && s_slots[i].net_gen != gen) {
memset(&s_slots[i], 0, sizeof(s_slots[i]));
s_slots[i].fd = NET_FD_INVALID;
}
}
}
@@ -268,7 +286,7 @@ IEC104_NetResult_t IEC104_Net_Listen(
return result(IEC104_NET_ERROR, NET_ERR_INVAL, native_error);
}
fd = net_socket(NET_AF_INET, NET_SOCK_STREAM);
if (fd < 0) {
if (fd == NET_FD_INVALID) {
return result(IEC104_NET_ERROR, net_get_errno(), native_error);
}
memset(&addr, 0, sizeof(addr));
@@ -635,6 +653,7 @@ IEC104_NetResult_t IEC104_Net_Close(
}
}
memset(slot, 0, sizeof(*slot));
slot->fd = NET_FD_INVALID;
return result(IEC104_NET_OK, 0, native_error);
}
+10 -9
View File
@@ -77,15 +77,16 @@ static struct {
SntpTimestamp_t t1; /* 本轮请求时间(serializer 要求跨收发保存) */
uint8_t pkt[SNTP_PACKET_BASE_SIZE]; /* 请求报文(48B,静态省栈) */
} s_ctx = {
/* fd 必须显式初始化成 -1:net 层的 fd 0 是**合法**描述符,零初始化的 0
* 会被 s_socket_close() 的 `fd >= 0` 判据当成"已打开的 socket",
/* fd 必须显式初始化成 NET_FD_INVALID(契约 C1):net 层的 fd 0 是**合法**
* 描述符,零初始化的 0 会被历史判据 `fd >= 0` 当成"已打开的 socket",
* 于是在 SNTP 从未开过 socket 时对 fd 0 发 net_close(0),关掉别的服务
* (实测 2026-11-18 台架:网卡起来第一轮代次变化即把 ftpTask 刚 listen
* 的槽 0 关掉,随后 104 的 net_socket() 又复用 fd 0,两个监听器抢同一
* 芯片 Socket,表现为 104 连接立刻收到 FTP 的 220 banner)。
* 教训:本项目 net fd 是"槽位下标",0 完全合法,任何"用 0 表示未打开"
* 的写法都是错的。 */
.fd = -1,
* 的写法都是错的;判据只允许与 NET_FD_INVALID 比较。
* 契约全文 → docs/网络/网络句柄失效值契约.md */
.fd = NET_FD_INVALID,
};
static uint32_t s_rng; /* xorshift32:散布/防欺骗随机数(非密钥用途) */
@@ -249,10 +250,10 @@ static void s_ts_now(SntpTimestamp_t *p_ts) {
*/
static int s_socket_open(uint32_t gen) {
struct net_sockaddr_in addr;
int s;
int s = NET_FD_INVALID;
s = net_socket(NET_AF_INET, NET_SOCK_DGRAM);
if (s < 0) {
if (s == NET_FD_INVALID) {
DBG_ERROR("net_socket FAIL errno=%d", net_get_errno());
return -1;
}
@@ -277,9 +278,9 @@ static int s_socket_open(uint32_t gen) {
* 返回值:无
*/
static void s_socket_close(void) {
if (s_ctx.fd >= 0) {
if (s_ctx.fd != NET_FD_INVALID) {
net_close(s_ctx.fd);
s_ctx.fd = -1;
s_ctx.fd = NET_FD_INVALID;
}
}
@@ -476,7 +477,7 @@ static void s_send_round(uint32_t net_gen, uint32_t now) {
}
s_ctx.no_srv_logged = 0u;
if (s_ctx.fd < 0) {
if (s_ctx.fd == NET_FD_INVALID) {
if (s_socket_open(net_gen) != 0) {
s_fail_backoff(now);
return;