模型接口:TCP
以下各节讨论了与 TCP 模型进行接口所需的主题。
数据包格式
以下数据包格式用于表示一个 TCP 段:
| 格式 | 说明 |
|---|---|
tcp_seg_v2 |
代表一个 TCP 段。TCP 用它封装应用数据,以便传送到连接的另一端。它包含用于源/目的端口标识的字段、状态标志(如 SYN、FIN)以及其他若干 TCP 专用信息字段 |
每个 TCP 段都包含 TCP 头部、选项和数据字段。这由 TCP 数据包格式(tcp_seg_v2)定义。在数据包格式编辑器中,它看起来如下:
图 562:TCP 数据包格式

有关各数据包字段的重要性,请参见为每个字段提供的说明。
ICI 格式
下表列出了 TCP 模型套件中使用的接口控制信息(ICI)格式:
| 格式 | 说明 |
|---|---|
ip_encap_ind_v4 |
底层(网络层)协议将数据包转发给 TCP 时会附带此 ICI。它包含到达数据包的源网络和源节点信息。 |
ip_encap_req_v4 |
TCP 进程使用此格式向网络层指定目的网络和节点信息。该 ICI 始终随数据包传送一同安装。 |
tcp_command_v3 |
应用层进程使用此 ICI 格式标识目标 TCP 连接,使其发出的命令能够派发到正确的连接进程。在同一条连接的整个存续期间,与该连接的所有交互都应使用同一个 ICI。ICI 复用简化了 TCP 接口,因为连接参数可以在连接首次打开时保存下来。 |
tcp_status_ind |
TCP 连接进程使用此 ICI 向应用层进程通知重要事件。连接创建该 ICI,但不会销毁它;销毁由应用负责。 |
tcp_open_ind |
当应用与服务器建立被动会话时,TCP 连接进程使用此 ICI 通知应用该被动会话已绑定。随后应用向 TCP 发送创建新被动连接的请求。 |
TCP 命令与指示
TCP 与应用之间的接口基于应用向 TCP 发出的命令以及 TCP 返回给应用的指示。命令和指示由 C 头文件 tcp_api_v3.h(位于 <models>/std/include 目录)中定义的符号常量标识;任何与 TCP 交互的应用都应参考该文件以获取这些定义。
下表列出了 TCP 模型套件中使用的各种命令:
| 命令 | 说明 |
|---|---|
OPEN |
应用向 TCP 模块发出 OPEN 命令以打开新连接。OPEN 命令有两种类型:OPEN_ACTIVE,使一个段被发送到远端 socket,请求建立连接;以及 OPEN_PASSIVE,使本地 socket 等待建立请求(SYN)段。该命令通过在 TCP 模块处强制一个远程中断发出,其 code 参数设置为 TCPC_COMMAND_OPEN_ACTIVE 或 TCPC_COMMAND_OPEN_PASSIVE。该中断通常应当被强制发出而不是计划发出,以便检查命令 ICI 中的 “return value”,确定命令是否成功。 |
SEND |
应用向 TCP 模块发出 SEND 命令,将数据包发送到已建立连接的另一端。具体做法是将数据数据包发送给 TCP 模块。如果连接是以 OPEN_PASSIVE 命令打开的,且远端 socket 的地址或端口信息尚未指定,则 SEND 命令(此时必须附带缺失的远端 socket 信息)同时起到 OPEN_ACTIVE 命令的作用。 |
RECEIVE |
应用发出 RECEIVE 命令以请求数据。应用向 TCP 模块发送一个远程中断,其 code 参数设置为 TCPC_COMMAND_RECEIVE。连接进程随后会在所请求的数据包可用时立即转发。RECEIVE 命令带有一个参数,即请求的数据包数量。 |
CLOSE |
应用向 TCP 模块发出 CLOSE 命令,表明其已完成数据发送并准备好关闭连接。具体做法是发送一个 code 参数设置为 TCPC_COMMAND_CLOSE 的远程中断。发出该命令后,本地 socket(tcp_conn_v3 进程)即开始连接拆除序列。 |
ABORT |
应用发出 ABORT 命令,不经执行正常拆除序列而突然断开连接。应用发送一个 code 参数设置为 TCPC_COMMAND_ABORT 的远程中断。 |
指示的形式是从 TCP 连接进程发往应用的远程中断或流中断。所有指示都附带一个先前描述的 tcp_status_ind_v3 类型的 ICI。
| TCP 指示 | 说明 |
|---|---|
SEG_FWD |
当应用请求的数据可用时,或收到未经请求的紧急数据时,连接进程将数据包转发给应用。 |
ESTAB |
连接进程使用远程中断向应用指示连接已建立。附带 ICI 中的 “status” 属性设置为 TCPC_IND_ESTAB。 |
FIN_RECEIVED |
连接进程向应用层发送 FIN_RECEIVED 指示,以启动连接的关闭。 |
CLOSED |
连接进程在标准拆除序列结束时向应用层转发 CLOSED 指示。这依赖于一个远程中断,其附带 ICI 中的 “status” 属性设置为 TCPC_IND_CLOSED。 |
ABORTED |
连接进程向应用发出 ABORTED 指示,以指示意外的连接拆除。应用通过一个远程中断收到通知,其附带 ICI 中的 status 属性设置为 TCPC_IND_ABORTED。 |
应用层接口
下图展示了与 TCP 模型接口的典型应用层进程模型的相关部分。
图 563:典型应用层进程模型

创建应用到 TCP 的接口有两种方法:一是直接使用远程中断;二是使用 TCP API。除非你习惯于直接创建该接口,否则你可能会发现 API 方法更简单。
- 使用远程中断发出命令:命令的形式是应用向 TCP 管理进程(即 TCP 模块的根进程)发出的远程中断或流中断。所有命令都必须附带先前描述的
tcp_command_v3类型的 ICI。 - 使用 TCP API 发出命令:TCP API 是一组函数,隐藏了发出命令所涉及的许多细节。要使用这些函数,声明外部源文件
tcp_api.ex.c;然后在应用层进程的头块中包含tcp_api.h:

每个应用模块必须首先使用 tcp_app_register() 函数向 TCP 注册自身;该函数返回一个句柄,应用在后续函数调用中将其作为参数使用。单个应用层模块内的动态进程可以复制该句柄用于函数调用,而不必重新注册。
有关本节更多信息,请参见: