04ee5867b4
根因:静态 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 安全,无第二处生产误判。
37 lines
1.5 KiB
C
37 lines
1.5 KiB
C
#pragma once
|
||
|
||
#include <stdint.h>
|
||
|
||
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 = 未登录;跨会话锁定计数在
|
||
* lftpd.c 的 s_auth_state,不在此处) */
|
||
char auth_user[32]; /* USER 阶段暂存的用户名 */
|
||
uint8_t auth_user_ok; /* 1 = 用户名与 [ftp] user 匹配 */
|
||
uint8_t auth_logged_in; /* 1 = PASS 校验通过 */
|
||
} lftpd_client_t;
|
||
|
||
typedef struct {
|
||
const char *directory;
|
||
int port;
|
||
int server_socket; /* 监听 fd;无监听器 = NET_FD_INVALID(0 是合法 fd) */
|
||
lftpd_client_t *client;
|
||
} lftpd_t;
|
||
|
||
int lftpd_start(const char *directory, int port, lftpd_t *lftpd);
|
||
int lftpd_stop(lftpd_t *lftpd);
|
||
|
||
/*
|
||
* 看门狗心跳钩子(弱符号,默认空实现见 lftpd_inet.c):
|
||
* lftpd 事件循环与长等待点周期调用,为 ftpTask 喂任务心跳;
|
||
* 应用层(App/util/task_watchdog.c)提供强符号路由到
|
||
* task_wd_beat(TASK_WD_FTP),驱动层因此不向上依赖应用层
|
||
* (分层铁律);未接线的构建(如模拟器)空实现生效、行为不变。
|
||
* 2026-10-02 台架:FTP 心跳缺失致 IWDG 复位循环,本钩子为修复的一部分。
|
||
*/
|
||
void lftpd_task_wd_beat(void);
|