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
+21
View File
@@ -0,0 +1,21 @@
/*
* 模块名称:主机侧单测桩 - FreeRTOS.h(lftpd_inet 模块专用)
* 模块功能:宿主等价类型与 tick 换算。本仓 tick = 1ms,故 pdMS_TO_TICKS 就是原值——
* 这不是偷懒:写成本机换算,测试里的 30000ms 预算与 200ms 分片才可直接读。
* ⚠ 仅供主机侧单测使用,不参与 MCU 构建。
* 创建日期:2026-10-23
*/
#ifndef FREERTOS_H
#define FREERTOS_H
#include <stddef.h>
#include <stdint.h>
typedef uint32_t TickType_t;
typedef long BaseType_t;
typedef unsigned long UBaseType_t;
typedef void *TaskHandle_t;
#define pdMS_TO_TICKS(ms) ((TickType_t)(ms))
#endif /* FREERTOS_H */
+19
View File
@@ -0,0 +1,19 @@
/*
* 模块名称:主机侧单测桩 - dbg_log.h(lftpd_inet 模块专用)
* 模块功能:DBG_* 换成计数,让"建 socket/bind/listen 失败各留一条 ERROR""对端不开
* 数据通道时只 INFO"这些通道可断言。
* ⚠ 仅供主机侧单测使用,不参与 MCU 构建。
* 创建日期:2026-10-23
*/
#ifndef DBG_LOG_H
#define DBG_LOG_H
extern int g_lfi_info_count;
extern int g_lfi_error_count;
extern int g_lfi_debug_count;
#define DBG_INFO(fmt, ...) do { (void)(fmt); g_lfi_info_count++; } while (0)
#define DBG_DEBUG(fmt, ...) do { (void)(fmt); g_lfi_debug_count++; } while (0)
#define DBG_ERROR(fmt, ...) do { (void)(fmt); g_lfi_error_count++; } while (0)
#endif /* DBG_LOG_H */
+34
View File
@@ -0,0 +1,34 @@
/*
* 模块名称:主机侧单测桩 - net_socket.h(lftpd_inet 模块专用)
* 模块功能:给 FTP 的 inet 适配层一个可控的 socket 面。地址结构与 NET_AF_INET /
* NET_SOCK_STREAM 一律取**真实** net_types.h(sin_port 的注释就写着
* "网络字节序",本模块的 htons/ntohs 契约靠它才钉得住);下面这些函数
* 原型与真实 net_socket.h 逐字一致(不一致就会在被测代码的调用点报错)。
* ⚠ 仅供主机侧单测使用,不参与 MCU 构建。真实 net_socket.h 带整条 netTask 消息队列
* 与芯片依赖,PC 上编不动。
* 创建日期:2026-10-23
*/
#ifndef NET_SOCKET_H
#define NET_SOCKET_H
/* 真实 net_socket.h 会把 FreeRTOS.h / task.h 一起带给调用方,
* lftpd_inet.c 正是靠那条链拿 TickType_t / vTaskDelay / pdMS_TO_TICKS,
* 所以桩必须照做同样的 include(少一行就是 C2065 未声明)。 */
#include "FreeRTOS.h"
#include "task.h"
#include "net_types.h"
int net_socket(int domain, int type);
int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen);
int net_listen(int sockfd);
int net_close(int sockfd);
int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen);
int net_send(int sockfd, const void *buf, int len, int flags);
int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms);
int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen);
uint16_t net_htons(uint16_t hostshort);
uint16_t net_ntohs(uint16_t netshort);
uint32_t net_get_generation(void);
int net_listener_armed(int sockfd);
#endif /* NET_SOCKET_H */
+20
View File
@@ -0,0 +1,20 @@
/*
* 模块名称:主机侧单测桩 - task.h(lftpd_inet 模块专用)
* 模块功能:只声明两个时间入口:xTaskGetTickCount(read_line / read 的 30 s 总预算
* 时基)与 vTaskDelay(accept 轮的让出点,兼作"这一轮真的等了"的证据)。
* ⚠ 仅供主机侧单测使用,不参与 MCU 构建。
* 为什么用 vTaskDelay 计数而不是直接数喂狗:lftpd_task_wd_beat 在本文件里是
* __weak 空实现(真机由 lftpd.c 覆盖成真实喂狗),ARMCC 的 weak 在 MSVC 下走的是
* 普通定义那条支路,主机侧**替换不掉**它。而每轮 accept 失败后"喂狗 + 睡 100ms"
* 是同一段代码里的相邻两句,所以睡的次数就是喂狗轮数的可靠代理。
* 创建日期:2026-10-23
*/
#ifndef TASK_H
#define TASK_H
#include "FreeRTOS.h"
TickType_t xTaskGetTickCount(void);
void vTaskDelay(TickType_t xTicksToDelay);
#endif /* TASK_H */