Files
STM32F4-Base/Drivers/BSP/NET/lftpd/lftpd.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.5 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.
#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);