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
@@ -222,9 +222,9 @@
|---|---|---|---|
| 配置与工具 4 块 | ✅ 完成 | `test/host/{net_cfg,ftp_cfg,prot_set_store,task_prof}`(104 条) |
`net_cfg.c` 108/112、`task_prof.c` 88/93、`ftp_cfg.c` 35/36、`prot_set_store.c` 27/29 |
| FTP 一套(4 块里 2 块) | 🟡 部分 | `test/host/lftpd_io`(33 条,含 `lftpd_string.c`) |
`lftpd_io.c` **85/159 = 53.5%**、`lftpd_string.c` 8/10;`read/write/close/stat/unlink/readdir`
未测(要先把假 `FIL/FILINFO` 的字段语义做实,否则断言落在假件自己写的规则上) |
| FTP 一套(4 块里 3 块) | ✅ 大部分 | `test/host/lftpd_io`(33 条)、`test/host/lftpd_inet`(28 条) |
`lftpd_inet.c` **127/127 = 100%**(全仓第一个满覆盖文件)、`lftpd_string.c` 8/10、
`lftpd_io.c` 85/159(`read/write/close/stat/unlink/readdir` 待假 `FIL/FILINFO` 字段语义) |
| NET 四块之一:`net_select.c` | ✅ 完成 | `test/host/net_select`(21 条) | `net_select.c` 97/114 = **85.1%** |
| `lftpd.c` / `lftpd_inet.c` | ⬜ 未开始 | — | 需假 `net_socket` 层(`time_sync`/stub 那份可扩展) |
| NET 三块之一:`net_listener.c` | ✅ 完成(**125/126 = 99.2%**) |