数据包翻译详解
本节先描述数据包翻译过程的各个组成部分,然后详细描述整体翻译过程。
转换描述块
这是翻译过程中最重要的数据结构。它作为参数传递给翻译过程中使用的大多数函数,例如翻译函数和测试函数。其声明可以在 sitl_packet_translation.h 中找到,如下所示:
typedef struct Sitl_Conversion_Descriptor_Block
{
SitlT_Translation_Direction direction;
Packet* sim_pk_ptr;
unsigned char* real_pk_ptr;
unsigned int real_pk_size;
unsigned int real_pk_offset;
unsigned int max_conv_level;
unsigned int max_conv_level_passthrough;
unsigned int cur_conv_level;
unsigned int drop_unsup_packets;
unsigned char* user_data_ptr;
void* current_tfe_ptr;
int passthrough;
int link_layer_type;
int next_protocol;
VosT_uInt8 BSS_IS [6];
Packet* sim_pk_ptr_arr [SITL_MAX_CONV_LEVEL];
unsigned char* real_pk_ptr_arr [SITL_MAX_CONV_LEVEL];
} SitlT_SCDB;
让我们更详细地查看各字段。
direction
该字段指定翻译的方向。它可以取两个值之一,定义在下面的 typedef 中:
typedef enum {
SITL_TRANSLATION_DIRECTION_REAL_TO_SIM = 0,
SITL_TRANSLATION_DIRECTION_SIM_TO_REAL = 1
} SitlT_Translation_Direction;
该参数由 SITL 设置,你不应该更改它。
sim_pk_ptr
该字段持有指向仿真数据包的指针。在仿真到真实的翻译中它可以是输入参数,在真实到仿真的翻译中它可以是输出参数。
real_pk_ptr
该字段持有指向真实数据包的指针。在真实到仿真的翻译中,它指向传入的真实数据包;在仿真到真实的翻译中,它指向用于接收翻译后真实数据包的内存区域。它始终由 SITL 设置,除非在非常复杂的情况下,否则你不应该更改它。
real_pk_size
该字段持有真实数据包的大小(字节)。它由 SITL 设置,你不应该更改它。
real_pk_offset
该字段持有从真实数据包开头算起的偏移量,翻译过程将在该处处理下一批数据。在真实到仿真的情况下,这是读取下一批数据的位置;在仿真到真实的情况下,这是写入数据的位置。随着翻译过程的推进,你应该递增该参数。
max_conv_level
该字段是要转换的最大数据包嵌套层数。它由 SITL 根据 SITL 节点上的一个参数设置。必要时你可以更改它。
max_conv_level_passthrough
该字段是针对直通数据包要转换的最大数据包嵌套层数。例如,设置为 2 时,SITL 只翻译到 IP 层(含)。该字段由 SITL 根据 SITL 节点上的一个参数设置。必要时你可以更改它。
cur_conv_level
该字段是翻译过程当前到达的嵌套层数。你应该在自定义翻译函数中递增它。
drop_unsup_packets
该字段告诉 SITL 是否丢弃无法从真实转换为仿真的数据包。如果设置为 0,SITL 会将数据包数据封装在一个无格式数据包中。默认值为 1,表示 SITL 将丢弃所有无法转换的数据包。
user_data_ptr
该字段可以持有指向自定义用户数据的指针。你可以根据需要设置它。
current_tfe_ptr
该字段持有关于当前格式和翻译函数的信息。它是 SITL 内部字段,你不应该更改它。
passthrough
如果数据包的目的地在仿真之外,该字段设置为 1,否则为 0。它由 SITL 设置,你不应该更改它。
link_layer_type
该字段包含数据链路层类型,如 WinPcap/libpcap 文档所述。
next_protocol
在适用时(例如以太网或 IP 隧道),该字段被设置为载荷数据包的协议。不适用时设置为 0。
BSS_ID
该字段包含无线网络的 BSS ID。它仅用于 WLAN 接口,其他情况下应留空。
sim_pk_ptr_arr
该字段持有指向迄今已翻译的仿真数据包的指针数组。因此,sim_pk_ptr_arr[cur_conv_level] 与 sim_pk_ptr 相同,real_pk_ptr_arr[cur_conv_level] 与 real_pk_ptr 相同。该字段可用于访问协议栈中较低层的仿真数据包。
real_pk_ptr_arr
该字段持有指向迄今已翻译的真实数据包的指针数组。因此,real_pk_ptr_arr[cur_conv_level] 与 real_pk_ptr 相同。该字段可用于访问协议栈中较低层的真实数据包。
翻译函数
这些函数执行实际的数据包翻译。它们的形式如下:
int sitl_translation_function (SitlT_SCDB* scdb_ptr)
它们以转换描述块作为参数,成功返回 1,失败返回 0。翻译函数的示例见图 5。
翻译函数必须注册到 SITL,如函数注册所述。
函数注册
所有翻译函数和测试函数都必须注册到 SITL。内置函数由初始化函数 op_pk_sitl_packet_translation_init() 注册。你应该使用 op_pk_sitl_register_translation_function() 注册自定义函数。
注册翻译函数时,你需要指定以下几项:
- 翻译的方向
- 指向翻译函数的指针
- 指向关联测试函数的指针
你还可以指定基础数据包格式,它决定你的数据包作为载荷承载于哪种协议之上。当 SITL 为某个数据包寻找可应用的翻译函数时,这一点很有用。只有在该嵌套层实际可能出现的数据包对应的翻译函数才会被考虑。你可以为该参数传入 NULL 指针,但这样效率较低,而且你的数据包由多种协议承载的可能性极小。
最后一个要指定的参数是优先级。它用于决定先考虑哪个翻译函数。SITL 使用其关联测试函数返回 true 的第一个翻译函数。优先级较高的函数先被考虑。利用优先级可以提高翻译效率:为对应更常见数据包的翻译函数赋予更高优先级。
注: 如果将同一个翻译函数与不同的测试函数配对,你可以多次注册该翻译函数。
测试函数
测试函数根据它们在数据包中找到的签名来确定数据包格式(协议)。该签名是唯一确定格式的一组字段值的组合。测试函数的形式如下:
int sitl_translation_test (SitlT_SCDB* scdb_ptr)
测试函数以描述块作为参数,返回一个真/假值,指示数据包是否通过测试。测试函数必须注册到 SITL。
测试函数既可以使用输入数据包(真实或仿真),也可以使用迄今已转换的输出数据包。必须注意不要对数据包做任何修改。此外,非常重要的一点是,不要基于“数据包就是所需类型”的假设而错误地解释数据包中的字段。例如,在使用来自真实数据包的偏移量时,使用前必须确保它们指向数据包范围之内。如果你使用的字段不是偏移量,可能会导致代码指向真实数据包之外,从而发生内存访问违规。
翻译入口函数
翻译过程从两个入口函数开始,一个用于真实到仿真的翻译,一个用于仿真到真实。这些函数应像其他翻译函数一样声明,但它们不需要注册,也不需要对应的测试函数。它们总是最先被调用来转换数据包。这些函数由两个 SITL 网关节点属性指定:
- From Real Packet Translation Function
- To Real Packet Translation Function
这些函数可以在不同的 SITL 节点上不同,不过目前将它们设置为不同值可能没有用处,因为所有 SITL 数据包的最低层都必须是以太网。但已注册的翻译函数是全局的,它们由所有 SITL 节点共享。
SITL 提供两个内置函数作为标准翻译函数的入口点——op_pk_sitl_from_real_all_supported() 和 op_pk_sitl_to_real_all_supported()。如果你在内置函数之外编写自己的自定义翻译函数,可以使用这些内置入口点。一旦注册了你的翻译函数,它们会在适当的时候被调用。但是,由于入口点和初始化函数必须由你的自定义模块导出,你需要创建调用内置入口点的包装函数。你的包装函数可以如下所示:
DLLEXPORT int my_from_real_all_supported (SitlT_SCDB* scdb_ptr)
{
int result;
FIN (my_from_real_all_supported (scdb_ptr));
result = op_pk_sitl_from_real_all_supported (scdb_ptr);
FRET (result);
}
DLLEXPORT int my_to_real_all_supported (SitlT_SCDB* scdb_ptr)
{
int result;
FIN (my_to_real_all_supported(scdb_ptr));
result = op_pk_sitl_to_real_all_supported (scdb_ptr);
FRET (result);
}
这些示例只是调用内置的入口函数。
初始化函数
在实际翻译过程开始之前,翻译需要完成一些初始化工作。至少,翻译函数和测试函数需要注册到 SITL。它们的形式如下:
int sitl_translation_initialization (void)
它们不接受参数,返回成功或失败。
SITL 为其内置翻译过程提供了一个初始化函数 op_pk_sitl_packet_translation_init()。该函数注册所有内置翻译和测试函数。如果你在内置函数之外编写自己的一组翻译函数,应在你自己的初始化函数中调用该函数。如果你的一组翻译函数完全取代 SITL 提供的函数,则无需在初始化函数中调用内置初始化函数。
初始化函数通过 SITL 节点上的 Translation Initialization Function 属性指定。
内存分配与释放
数据包进出翻译函数。让我们看看谁创建数据包、谁销毁数据包。
真实数据包的内存始终由 SITL 处理。在非常复杂的翻译函数中,你可以操作真实数据包内存,但除非绝对必要,否则不建议这样做。
real_pk_offset 从第一个翻译函数被调用时从零开始,并且在最后一个翻译函数结束时应当与 real_pk_size 相同。
在真实到仿真的翻译中,real_pk_ptr 是输入参数,翻译函数使用 real_pk_offset 确定下一批待转换数据的位置。
在仿真到真实的翻译中,real_pk_ptr 指向由 SITL 分配、用于存放转换后数据包的内存块。real_pk_offset 应指向真实数据包内紧接在最后一批已转换数据之后的内存区域。下一批数据在转换时就写入这里。
在仿真到真实的情况下,仿真数据包是输入参数,用户负责销毁数据包。必须注意不要在较高嵌套层有机会转换它们的数据包之前就销毁数据包,因为这些数据包是较低层数据包的字段。
在真实到仿真的情况下,翻译函数负责创建在翻译结束时于描述块中返回的仿真数据包。
载荷翻译函数
提供两个载荷翻译函数:
SITL 调用这两个函数来转换当前正在转换的数据包的内层数据包(载荷)。这些函数的工作方式如下。
真实到仿真的载荷翻译
op_pk_sitl_translate_payload_from_real_to_sim() 检查是否已达到相应节点属性指定的最大翻译层数。如果已达到,载荷被封装在一个无格式数据包中,翻译结束。如果未达到,SITL 为载荷数据包寻找合适的翻译函数。SITL 按优先级从高到低调用适用于该嵌套层的测试函数。如果没有找到,接着尝试未指定基础层的测试函数。如果找到翻译函数,则调用该函数继续翻译过程。如果没有找到任何函数,载荷被封装在一个无格式数据包中,翻译结束。
注: 目的地不在仿真内节点的数据包以不同方式处理。详见直通数据包。
仿真到真实的载荷翻译
op_pk_sitl_translate_payload_from_sim_to_real() 检查内层数据包是否为无格式数据包。如果是,它提取封装的数据并原样复制到真实数据包中。否则,它检查是否已达到最大翻译层数,如果已达到则退出。如果未达到,该函数寻找合适的翻译函数。SITL 按优先级从高到低调用适用于该嵌套层的测试函数。如果没有找到,接着尝试未指定基础层的测试函数。如果找到翻译函数,则调用该函数继续翻译。如果没有找到任何函数,翻译结束。
直通数据包
目的地不在仿真中节点的传入真实数据包只翻译到 IP 层。没有必要尝试进一步转换它们,因为它们只是穿过仿真,并且必须在出向的 SITL 节点中再翻译回去。不做完整翻译使得 IP 之上不受支持协议的数据包无需自定义翻译函数即可穿越仿真。避免来回翻译数据包也更高效。
如果你需要完全转换直通数据包,请在相应的 SITL 网关节点上将 Limit Pass-through Translation To IP Level 属性设置为 “disabled”。
限制所有数据包的翻译
你可以使用 Maximum Packet Translation Level 属性指定转换数据包的最大嵌套层数(真实到仿真和仿真到真实均适用)。该属性默认设置为 9,即不施加限制。你可以将其设置为较低的值,以防止翻译超过某个层数。如果你想在某个内部进程模型中处理原始数据包数据,这可能很有用。请注意,SITL 将所有未转换的数据封装在一个无格式数据包的结构字段中。
队列大小
传入数据包队列的默认大小为 1000 个数据包。这对大多数情况已经足够,但你可以使用 SITL Queue Size (packets) 属性将其设置为 100 到 1000000 之间的任意数值。这是一个全局(仿真)属性,可以在 Configure/Run DES 对话框的 Inputs > Global Attributes 页面设置。
请记住,队列充当传入数据包的缓冲区,用于平滑流量峰值。如果仿真很慢、跟不上流量,更大的缓冲区也不会让它更快。缓冲区终会填满。发生这种情况时,传入的数据包将被丢弃,并且仿真控制台中每丢弃一个数据包就会打印一个字符 “@”。
翻译过程如何工作
现在把一切串起来。仿真初始化时,SITL 调用数据包翻译初始化函数。该函数注册所有翻译/测试函数对。当数据包到达时,SITL 调用翻译入口函数来转换数据包。该入口点通常调用基础数据包格式(即以太网)的翻译函数。每个翻译函数转换自己数据包格式的数据。然后,如果该格式还承载其他数据包作为载荷,翻译函数会调用两个载荷翻译函数之一来转换内层数据包。这些载荷函数又依次调用其他翻译函数,过程递归进行,直到到达数据包嵌套的顶层。
在某些情况下,翻译过程可能提前停止。对于真实到仿真的翻译,在以下情况下载荷数据被封装在一个无格式仿真数据包中:
-
已达到最大翻译层数。
-
数据包是直通数据包,且 Limit Pass-through Translation to IP Level 属性设置为 Enabled。
-
没有找到合适的翻译函数,或翻译因任何原因失败。
此情况仅当 Drop Real Packet if Translation Fails 属性设置为 Disabled 时适用。默认情况下,该属性设置为 Enabled,导致数据包被丢弃。
无格式数据包将只有一个字段,即包含载荷数据的结构。
在仿真到真实的情况下,翻译可能在上述相同情况下结束。但是在做出决定之前,SITL 会提取封装在无格式数据包中的任何数据。请注意,如果你生成仿真数据包并希望将它们转换为真实数据包而无需编写自己的翻译函数,可以使用这一特性。只需把你的自定义数据包封装为受支持协议的载荷并发送给 SITL。SITL 不会改动这些数据,只会将它们复制到真实数据包中。