refactor(编号): F-* 网络设计条目号转语义说明——批次一收尾,代码注释 43 处 + 文档 9 处
批次一(不碰门禁即可清)的最后半批,原派道中途失败且**未留任何改动**(Lead 核实那批文件零 diff 后重派 setpage 执行,14 只文件 / 46 处),测试侧与一张生成器共 9 处由 Lead 收尾。 做法:**逐处先读属主文档 §7 速查表里那条的语义**,再改写成「一句话结论 + §指针」,同号跨文件同一措辞, 无一处机械删号(例:`F-NET-7` → 「唯一读者红线(docs/网络/网络自愈架构设计.md §7 I7)」)。属主登记处 **12 条定义行原样保留**、不删登记族(删了历史行会报未登记前缀),只在该章加停发句。 顺带清掉 **3 处裸形**(`T6` → 「台架实测」、`M4-lite`、`Q1` 语义化)——裸形正是 id-check 校验 2 抓的形态, 属净减。测试侧收尾时两条纪律:主机侧**断言字符串必须保持 ASCII**(`ns_s3_msg.c` 等三处的号在 CHECK 文本 里,改成 `sole reader of the global register` 而不是中文);板端注释可用中文。 生成器 gen_net_instability_svg.py 文案改动 → 同批重跑产物 `docs/images/网络不稳根因总览.svg`:只有那一 行的**框宽随文字自适应**(526 → 551,右缘 1411 未越界),画布 1560x1468 不变,无溢出告警。 ⚠ 本笔**只含代码注释面**:该半批的文档面(BSD 函数调用关系 9 处、属主文档 §7 停发句、 生成器与产物那张网络不稳图)已被上一笔 `git add docs tools` 一并收走,两笔合起来才是完整的 F-* 批次。 自证:@build **0 错 0 警**且 Program Size 与改前**逐字节同数**(Code=233900 RO=26104 RW=1 536 ZI=136808, 注释无误伤的机器证据);net_socket 457/457、iec104_serv / net_pending 两套 exit 0;cppchec k 钩子参数零 发现、coding-standard 0(lftpd_inet.c 那 4 条是存量且该目录本在钩子 exclude 内,用 HEAD 副本对照 甄别过)。
This commit is contained in:
@@ -39,7 +39,8 @@ typedef enum {
|
||||
NET_MSG_LISTEN,
|
||||
NET_MSG_ACCEPT,
|
||||
NET_MSG_DROP_CONN, /* 主动拆会话、保监听(见 net_drop_conn) */
|
||||
/* F-NET-2/3:NET_MSG_RESYNC_LISTEN / NET_MSG_RELISTEN 已删——
|
||||
/* 静默回收认领 + 手动自愈 API 退役(docs/网络/网络自愈架构设计.md §4.1、§4.2):
|
||||
* NET_MSG_RESYNC_LISTEN / NET_MSG_RELISTEN 已删——
|
||||
* 静默回收由对账⑤自动认领(net_reconcile_tick),重建由 reconciler
|
||||
* 形态③④/D10 单一
|
||||
* 所有者负责;手动自愈 API 面退役(生产调用者本就为零) */
|
||||
@@ -172,7 +173,7 @@ int net_listen(int sockfd);
|
||||
*/
|
||||
int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen);
|
||||
|
||||
/* F-NET-4:net_can_accept 已退役——只认 ESTABLISHED 的旧门控会把
|
||||
/* accept 门控迁移(docs/网络/网络自愈架构设计.md §4.2):net_can_accept 已退役——只认 ESTABLISHED 的旧门控会把
|
||||
* "监听器在服役、本轮待 CONNECT"窗口全挡掉(CONNECT 事件补 accept 探针因此从不运行);
|
||||
* 监听 accept 门控统一用 net_listener_armed(),recv 门控 net_can_read() 保留。 */
|
||||
|
||||
@@ -457,7 +458,7 @@ int net_get_errno(void);
|
||||
*/
|
||||
int net_sock_state(int sockfd);
|
||||
|
||||
/* F-NET-3:net_resync_listen / net_relisten 声明已删——
|
||||
/* 手动自愈 API 退役(docs/网络/网络自愈架构设计.md §4.2):net_resync_listen / net_relisten 声明已删——
|
||||
* 静默回收形态由对账⑤自动认领(2 轮去抖 + 1s 冷却,纪律"不发芯片命令"
|
||||
* 原样保留在认领动作内);监听重建由 reconciler 形态③④(100ms 周期)/
|
||||
* D10(30ms 重试)单一所有者。勿再引入"应用层手动自愈"入口。 */
|
||||
|
||||
Reference in New Issue
Block a user