test(NET/lftpd): lftpd_inet 模块(28 条,127/127 = 100%)

FTP 的 socket 适配层吃满——全仓第一个 **100% 行覆盖**的文件(127/127)。
新增 test/host/lftpd_inet/,28 条断言全部 MSVC 编译通过并 PASS。

钉住的契约:
- 端口字节序:bind 前必须过 net_htons(sin_port 的注释就写着"网络字节序"),问名字
  回来要 ntohs 还原;问不到名字报 -1,不拿脏端口当结果。
- 失败路径一律关 socket:建口失败不 bind;bind 失败关口不 listen;listen 失败关口
  并各留一条 ERROR(漏关就是白占一个号,CH395F 只有 8 个)。
- accept 每轮失败都让出 CPU(同一段里也喂狗),直到成功;**网络代次一变立刻撤掉
  accept**——否则改了 IP 之后监听还挂在旧代次上,端口在新地址上根本不通。这是现场
  最常见的自愈路径,台架上要凑"对面正连着我顺手改 IP"极难。
- 带超时的 accept:监听门撤防时**立即放弃**,不对着死监听耗满窗口;对端一直不开
  数据通道就按 100ms 步进等满再 INFO 收场。
- read_line:CRLF 就地截成结束符(FTP 命令行的边界);跨包分片要能拼出整行;读到 0
  (对端关闭)立刻失败;-2 表示这一片超时继续等;其它负值**原样返回**(错误码不许被
  吞成 -1);等待按 200ms 分片、30 s 总预算到点退出(分片写错就饿死看门狗);缓冲
  填满仍无行尾要失败且**不越界写**(最后一格留给结束符)。
- 短写续传:net_send 可以只写一部分,续传必须从正确偏移接着写(少半条响应就是协议
  错乱);写 0 字节按失败处理;二进制写成功时回请求长度。

桩的口径:private/lftpd_inet.h 与 net_types.h 用真实头;net_socket.h 是桩但函数原型
与真实头逐字一致,并**照做真实头对 FreeRTOS.h / task.h 的 include**(lftpd_inet.c 的
TickType_t / vTaskDelay / pdMS_TO_TICKS 就是从那条链上拿的,桩少这一行就是 C2065)。
lftpd_task_wd_beat 是 __weak 空实现、主机侧替换不掉,因此用同段代码里的"睡 100ms"
次数当喂狗轮数的代理(写进桩注释,不假装能直接数到喂狗)。accept 循环带 100 轮跑飞
保险(net_select 批次被挂死教训换来的)。

覆盖率与台账:套件 25 → 26 全绿;files_tested 29 → 30;未触及 .c 37 → 36;分母
3,945 → 4,072 行;line=3599/4072(**88.4%**,连涨三批)、func=272/299(91.0%)。
恒等式 36 = 2(P1 剩:lftpd.c 与 iec104_serv.c) + 5(P2) + 29(P3) 仍咬合。编号补建
TC-HOST-LFTINET(游标 070),族数 19 → 20。

自查:test-cppcheck Passed;check_ids --strict 通过;doc-links 35 处(= 存量);
9 个新增/改动文件 BOM/CR/U+FFFD/行尾逐项净。零生产代码改动,未跑 @build。
--all-files 仍只有 mem-numbers / mem-budget(.map 台账漂移,等 Lead 合并后统一回填)
与 ui-golden(ref/*.bin 不入库,新 worktree 天生没有黄金参考)三条失败,与本分支无关。
This commit is contained in:
2026-10-23 22:58:48 +08:00
parent 59e6d77224
commit 8aaf9bbb0e
9 changed files with 657 additions and 17 deletions
+56
View File
@@ -0,0 +1,56 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""FTP socket 适配层(lftpd_inet)主机侧单元测试运行器(L0.5,纯标准库)。
做什么:
用本机 MSVC 编译 test/host/lftpd_inet/lftpd_inet_test.c(以 #include 纳入生产源
Drivers/BSP/NET/lftpd/lftpd_inet.c),离线验证监听/接受/读写适配:端口过 htons、
accept 每轮喂狗让出、网络代次一变就撤 accept、监听门撤防立即放弃、read_line 的
CRLF 截断与分片拼接与 200ms 分片 + 30s 总预算、错误码原样返回、短写续传。
为什么要主机侧单测(而不是只用台架):
代次撤 accept 与撤防放弃只在异常时刻成立(网络重建、客户端连上控制口却不开数据
通道),台架极难复现而真机上是常见自愈路径;200ms 分片写错会饿死看门狗、30s 预算
写错会让 ftpTask 永久卡在一条命令上;短写没续传就是"FTP 响应少半条"。这些都要
按毫秒与字节数着测。
桩的边界:private/lftpd_inet.h 与 net_types.h 用真实头(struct net_sockaddr_in 的
sin_port 注释就写着"网络字节序",htons/ntohs 契约靠它钉住);net_socket.h 是桩,
函数原型与真实头逐字一致;FreeRTOS.h / task.h 给宿主 tick 与 vTaskDelay(带跑飞
保险)。lftpd_task_wd_beat 是 __weak 空实现、主机侧替换不掉,故用同段代码里的
"睡 100ms"次数当喂狗轮数的代理。
用法(仓库根目录):
python test/host/lftpd_inet/run_unit_test.py
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/子系统设计/网络配置说明.md §3.4、docs/测试说明/FTP_Test_Guide.md、
docs/测试说明/主机单测覆盖率口径.md §9
创建日期:2026-10-23
"""
import os
import sys
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
BUILD = TestBuild(
name="LFTPD INET Tests",
src=os.path.join(HERE, "lftpd_inet_test.c"),
include_dirs=[
os.path.join(HERE, "stub"),
os.path.join(ROOT, "Drivers", "BSP", "NET", "lftpd"),
os.path.join(ROOT, "Drivers", "BSP", "NET"),
HERE,
],
extra_flags=["/D_CRT_SECURE_NO_WARNINGS"],
summary_marker="=== LFTPD INET Tests:",
)
if __name__ == "__main__":
sys.exit(run_host_unit_test(BUILD))