Files
STM32F4-Base/Drivers/BSP/NET/lftpd
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
..
2026-07-21 20:18:28 +08:00

Drivers/BSP/NET/lftpd/ — 轻量 FTP 服务器(第三方移植)

⚠️ 第三方开源库移植(lftpd,许可证见 LICENSE.txt),非自研代码。 本目录 README 仅说明其在本项目中的定位与对接方式;库内部逻辑请参考上游。

文件一览

文件 作用
lftpd.c/h FTP 服务器主体(命令解析、状态机、数据通道)
lftpd_io.c I/O 适配层(本项目对接 FatFs 的关键所在)
lftpd_inet.c 网络适配(对接本项目的 BSD Socket API)
lftpd_log.c 日志输出适配
lftpd_string.c 字符串工具
private/*.h 内部头文件
LICENSE.txt 上游许可证

在本项目中的对接

ftpTask(App/ 侧创建)
    ↓ 等待 SYS_EVT_NET_READY + SYS_EVT_STORAGE_READY(osFlagsNoClear!)
lftpd(本目录)
    ├── lftpd_inet.c  → Drivers/BSP/NET/net_socket.c(BSD Socket API)
    └── lftpd_io.c    → Lib/FatFs(文件读写)

⚠️ 项目相关注意

  • ftpTask 就绪屏障:osEventFlagsWait 等两位就绪必须加 osFlagsNoClear, 否则位被先到的消费者清掉 → FTP 21 端口静默不监听(无日志无报错)
  • lftpd 大局部缓冲:已按 docs/内存管理/RAM使用分析与优化方案.md §4.1.4 静态化 9 处 大局部缓冲(BSS +4.6KB),使 ftpTask 栈峰值从 3480B 降到 1184B——勿改回局部变量
  • 上传中止截断:FTP STOR 中途断开后首笔复连被截断(TRAP-NET-18)已在 net_socket.c 侧修复
  • 本目录受 pre-commit 的部分排除(第三方代码)

相关文档

  • 测试指南:docs/测试说明/板级测试/FTP_Test_Guide.md
  • 台架探针:test/host/bench/ftp/ftp_abort_probe.py、MDK-ARM/ftp_freeze_probe.py
  • 内存优化:docs/内存管理/RAM使用分析与优化方案.md §4.1.4