wandering1
8aaf9bbb0e
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 天生没有黄金参考）三条失败，与本分支无关。
35 lines
1.6 KiB
C
35 lines
1.6 KiB
C
/*
|
||
* 模块名称：主机侧单测桩 - 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 */
|