/* * 模块名称:Network Socket 句柄失效值契约 * 模块功能:定义网络 socket 句柄的**唯一**失效值 NET_FD_INVALID,供 MCU 侧、 * PC 模拟器与主机单测 stub 共用。 * 适用平台:STM32F4 系列(CH395F 以太网芯片) / PC 模拟器 * 作者:王建锋 * 创建日期:2026-11-18 * 修改记录: * * 契约要点(全文 → docs/网络/网络句柄失效值契约.md): * 1. net_socket() 成功返回 0 .. NET_MAX_SOCKETS-1,**0 是合法 fd**; * 失败返回 NET_FD_INVALID。 * 2. 任何"持有 fd"的变量/结构体成员,声明处必须显式初始化为 NET_FD_INVALID, * 不得依赖 C 的零初始化(零值恰好是合法 fd 0)。 * 3. 判"是否持有 fd"只允许与 NET_FD_INVALID 比较(== / !=), * 禁止 >= 0、< 0、== -1 之类的数值形态判据。 * * ⚠ 本头文件刻意**零依赖**(不 include net_config.h / net_types.h): * 主机单测的 stub 目录里没有 net_config.h,而 stub 的 net_socket.h 同样要 * include 本文件取失效值。不得在此引入任何其它头文件或 NET_MAX_SOCKETS。 */ #ifndef NET_FD_H #define NET_FD_H /* 网络 socket 句柄失效值("未持有 / 已关闭 / 申请失败") */ #define NET_FD_INVALID (-1) #endif /* NET_FD_H */