模型接口:TCP

以下各节讨论了与 TCP 模型进行接口所需的主题。

数据包格式

以下数据包格式用于表示一个 TCP 段:

格式 说明
tcp_seg_v2 代表一个 TCP 段。TCP 用它封装应用数据,以便传送到连接的另一端。它包含用于源/目的端口标识的字段、状态标志(如 SYN、FIN)以及其他若干 TCP 专用信息字段

每个 TCP 段都包含 TCP 头部、选项和数据字段。这由 TCP 数据包格式(tcp_seg_v2)定义。在数据包格式编辑器中,它看起来如下:

图 562:TCP 数据包格式

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 API 包含声明

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

有关本节更多信息,请参见:

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com