fix(log,net): 处置主机单测照出的 10 条现状，撤销 1 条误报
用户裁定「全部修」。第 1 轮修复跨三名队友、写范围互斥、零越界；
11 条登记现状 → 10 条已处置 + 1 条撤销（非阻塞 recv 「看不见 EOF」是误报：
net_recv_locked:1885 的非阻塞分支已把 CLOSED||session_dead 判成 EOF(0)，
动手前读码才发现，误报比漏报更贵）。
存储与日志（App/log/sys_log_mcu.c、soe_store.c、cfg_file_store_mcu.c、sys_log.h）
A 卷忙整批丢日志：批量路径补 rc==-2 分支整批回投（不计故障/不打日志/
保序）；此前一批最多 8 条既不落盘也不回投，而文档写着「条目不丢」
B rc==-1 文案与行为相反：改 write fail, requeue + 正常→故障节流
C 删永不可达的截断支；容量契约写死 sys_log.h（不足一律 -1、不写调用方字节）
D 自愈触发集违规（比原报告更严重）：新增代码侧唯一入口 s_is_selfheal_code，
触发集收敛为 {DISK_ERR,INT_ERR,NO_FILESYSTEM,DENIED}，移出名字/参数类码——
旧集合在 8.3 同名同因下每轮删一次自己的历史日志且永不自愈，正是存储架构
§10.1 第 10 条严禁的归集；soe_store 侧同源取更保守子集（打开失败绝不 unlink）
E 注释里的 FR_NO_SYSTEM 不存在，改 FR_NOT_READY / FR_NO_FILESYSTEM
F syslog_post 满态留痕节流（A 修好后「队列常驻满」成必然场景，不修等于用
新刷屏换掉静默丢）；丢弃语义一字未改
NET（net_socket.c/.h、net_types.h、net_socket_sim.c、lftpd.c）
IP 字节序统一到 POSIX 网络序：改 net_inet_addr（&s_addr[0]==第一段）+ 出向
IP 数组按内存字节顺位拆装（进与出同时换族→芯片侧数组净效果不变，550h 钉住）
+ 模拟器逐字同步；ntoa 函数体未动，只改对它注释里取了废弃族值的例子——
那正是两套约定长期共存不被发现的原因。lftpd 两处算术核对确认无需改
UDP 绕过 netTask：两入口加执行任务上下文守卫，新码 NET_ERR_NOT_IN_NETTASK
(-12，重试永远无意义)；结论口径=危险面已结构性关掉、串行化改造仍未做。
附带关掉第二条更隐蔽的路：非 netTask 自旋 recvfrom 期间控制块被 close 并
把同一 sockfd 分给新会话→旧自旋者消费新会话数据报
控制台（console_log.c/.h）：冷却改独立 s_con_cooling 标志（旧写法在 tick==0 那
拍冷却等于没记）；con_append 的判空位+推进 head+整行拷贝收进同一临界区（旧
为区外 check-then-act，环 >95% 满时可静默覆盖且既不打 [ERR] 也不计 dropped）；
Instance==NULL 与僵尸通道分诊（未初始化绝不 reinit）；三本账分离 + 新读口
dbg_console_tx_timeout()；[ERR] 行改为发成功才销账
测试：net_socket 452、console_log 127、sys_log_mcu 104、soe_store 27、
cfg_file_store_mcu 34；回归 net_listener 34 / net_events 34 / net_pending 43 /
net_select 22 / lftpd 35 / lftpd_inet 28 / lftpd_io 33 / iec104_serv 28 /
nand_port 149 / vol_lock 33 / soe 32 / cfg_file 151 全绿。原「按现状钉住」的
用例全部翻正向；console_log 用「逐条退回旧实现」做变异自证，失败集合单调增长
6→11→18→22（把一条本来空转的断言逼了出来）。
游标抬升：TC-NETSOCK-545→560、TC-SYSLOG-100→107、TC-CONLOG-135→167。
文档：控制台设计说明 §4.1 口径与 §13-O2 销项 + v1.5；运行与自检记录 §4.4/§4.5
四条；存储架构 §10.1 第 10 条推论（指向 s_is_selfheal_code）；TRAP-NET-21 后续
条目；BSD 指南新增 §9.0 s_addr 唯一约定；覆盖率口径 §9「第 1 轮修复处置」表 +
后续项 5 条 + 台架复验 7 条 + 新坑 8 条 + 变更记录。
后续项（本轮刻意不做，理由见 §9）：UDP 改走 netMsgQueue（需 per-task 结果槽，
net_msg_t 按值拷贝、禁止加回传字段，且要真机回归）；sim_syslog.c 同源不可达
支（本轮编译验证不到，不交没编译过的改动）；syslog_post 丢弃计数；
dbg_console_tx_timeout() 读端接线（STALL 行是被解析的证据行，加字段要连解析端
与台架判据一起改）；104 来源地址日志（现网无输出点）。
gate: @build 0 errors 0 warnings（Code=213720 RO=18860 RW=1204 ZI=131500）。
pre-commit run --all-files -> 39 hooks, 36 Passed; failed = mem-numbers +
mem-budget（受管快照与本树首次构建产物的漂移，非本批增量）+ id-check（已修，
现 0 台账外新账，可判定 84.63% > 基线 82.6%）。实测水位 RW_IRAM1 57.4%、
RW_CCM 87.9%，均低于 92% 红线；RAM/Flash 本批增量为数个 static 变量。
test-coverage / cppcheck / coding-standard / bsp-err / layer-deps / doc-links
全 Passed；全量覆盖率 33/33 套件、line 89.3%、func 92.3%、逐文件下降 0。
按仓内分支约定 --no-verify 提交，台账 --write 回填留待主工作树合并后。
This commit is contained in:
@@ -324,6 +324,8 @@ int net_setblocking(int sockfd, int on);
|
||||
* 3. 用本接口把等待切成 ≤timeout_ms 的片，调用方自行累计总预算：总超时语义不变、单次占用有界
|
||||
* 4. 超时用独立返回码 -2（而非靠 errno 区分）→ 无跨任务 errno 竞态
|
||||
* 5. ⚠ IWDG required_mask 内任务必须走本接口或 net_select（见 net_recv 契约）
|
||||
* 6. 本接口**走消息队列**、任意任务可调用（与 net_recv 同一条路径），
|
||||
* 与 net_recvfrom（仅限执行任务、直调芯片）不是一回事，勿混
|
||||
*/
|
||||
int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms);
|
||||
|
||||
@@ -335,9 +337,26 @@ int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms);
|
||||
* flags - 通常为 0
|
||||
* dest_addr - 目标地址
|
||||
* addrlen - 地址长度
|
||||
* 返回值：实际发送字节数，失败返回 -1
|
||||
* 限定条件：socket 已创建，指针非空
|
||||
* 函数说明：设置目标地址后调用 CH395F 发送
|
||||
* 返回值：实际发送字节数 int > 0
|
||||
* -1 失败，精确码经本任务错误码槽给出（net_get_errno()）：
|
||||
* NET_ERR_BADF / NET_ERR_INVAL / NET_ERR_TIMEDOUT /
|
||||
* NET_ERR_NOT_IN_NETTASK（调用上下文不对，见「限定条件」）
|
||||
* 限定条件：**仅限本层执行任务（net_init 的调用者，NET 层 = netTask）调用**；
|
||||
* socket 已创建且为 DGRAM；指针非空
|
||||
* 函数说明：1. 设置目标地址后调用 CH395F 发送
|
||||
* 2. ⚠ 本接口**不走消息队列**：它在调用方上下文里直接 net_poll +
|
||||
* 写芯片缓冲，与 net_send/net_recv/net_connect 那一族（入队交 netTask
|
||||
* 串行执行）不是同一条路径。别的任务调用它 = 与本层的 net_poll 抢
|
||||
* 同一根 SPI2（TRAP-NET-14 的根因形态），故加上下文守卫直接拒掉，
|
||||
* 回 NET_ERR_NOT_IN_NETTASK。**该码重试永远无意义**（既非忙也非超时）：
|
||||
* 要么把调用挪进执行任务，要么改用走队列的 net_send——没有第三条。
|
||||
* 3. 「把它改成走消息队列」是已知后续项，未做的原因：UDP 的目的地址
|
||||
* 与源地址回传都要穿过 net_msg_t，而 net_msg_t 按值拷入队列、
|
||||
* 错误码只搭任务通知值回来（AGENTS 明文「勿给 net_msg_t 加回传字段」），
|
||||
* 真要串行化得先设计 per-task 结果槽并配真机回归（2026-10-24 定案：
|
||||
* 本轮只把危险面关掉，串行化仍未做）。
|
||||
* 4. 全仓当前**无生产调用者**（只有 test/board 与模拟器），正因如此
|
||||
* 这条守卫要在有人开始用之前就在。
|
||||
*/
|
||||
int net_sendto(int sockfd, const void *buf, int len, int flags,
|
||||
const struct net_sockaddr *dest_addr, int addrlen);
|
||||
@@ -350,8 +369,12 @@ int net_sendto(int sockfd, const void *buf, int len, int flags,
|
||||
* flags - 通常为 0；NET_MSG_DONTWAIT 单次强制非阻塞
|
||||
* src_addr - 输出：发送方地址
|
||||
* addrlen - 输入输出：地址长度
|
||||
* 返回值：实际接收字节数，失败返回 -1
|
||||
* 限定条件：socket 已创建，指针非空
|
||||
* 返回值：实际接收字节数（0 = 无数据可报的边界形态见说明） int >= 0
|
||||
* -1 失败，精确码经本任务错误码槽给出（net_get_errno()）：
|
||||
* NET_ERR_BADF / NET_ERR_INVAL / NET_ERR_WOULDBLOCK /
|
||||
* NET_ERR_NOT_IN_NETTASK（调用上下文不对，见「限定条件」）
|
||||
* 限定条件：**仅限本层执行任务（net_init 的调用者，NET 层 = netTask）调用**；
|
||||
* socket 已创建且为 DGRAM；指针非空
|
||||
* 函数说明：1. 读取 CH395F 接收缓冲区，获取对端地址
|
||||
* 2. 阻塞语义与 net_recv 同：blocking 属性下无数据
|
||||
* 无限等待，DONTWAIT / 非阻塞属性立即 NET_ERR_WOULDBLOCK；
|
||||
@@ -438,6 +461,16 @@ int net_sock_state(int sockfd);
|
||||
* 返回值：网络字节序 IP，失败返回 0
|
||||
* 限定条件：cp 指针非空
|
||||
* 函数说明：不支持域名解析
|
||||
*
|
||||
* s_addr 的**唯一约定**（2026-10-24 定案：两套 IP 字节序约定统一为 POSIX 网络序；全仓只此一族，勿再引入第二套）：
|
||||
* 网络字节序整数 —— &s_addr 的第 0 个内存字节 == 点分第一段。
|
||||
* 小端主机（STM32F407 与 PC 模拟器都是）上 "192.168.1.100" 的数值 = 0x6401A8C0。
|
||||
* 与 net_inet_ntoa 互为逆运算；net_getsockname / net_getpeername / net_recvfrom
|
||||
* 填出来的 s_addr、以及 net_bind / net_connect / net_sendto 收进去的 s_addr
|
||||
* 全在同一族，故可直接做相等比较（旧实现里 inet_addr 与其余四个不互逆，
|
||||
* 曾造成「解析→存储→打印」链路输出反序 IP，见 TRAP-NET-21 与本函数实现注释）。
|
||||
* 另：本层 inet_addr 语义与 BSD 一致——失败回 0，故 "0.0.0.0" 与非法串同值；
|
||||
* 需要区分时用 net_inet_addr 的返回值再判，勿拿 NET_INADDR_NONE 当失败哨兵。
|
||||
*/
|
||||
uint32_t net_inet_addr(const char *cp);
|
||||
|
||||
|
||||
Reference in New Issue
Block a user