SITL 翻译函数
本节介绍 SITL 提供的数据包翻译 Kernel Procedure(内核过程)。
注册函数
op_pk_sitl_register_translation_function()
注册一对翻译/测试函数。原型如下:
int op_pk_sitl_register_translation_function (
OP_SIM_CONTEXT_ARG_OPT_COMMA
SitlT_Translation_Direction direction,
SitlT_Translation_Function translation_func,
SitlT_Translation_Test translation_test,
const char* base_packet_format, int priority);
op_pk_sitl_unregister_translation_function()
注销一对翻译/测试函数。原型如下:
int op_pk_sitl_unregister_translation_function (
OP_SIM_CONTEXT_ARG_OPT_COMMA
SitlT_Translation_Direction direction,
SitlT_Translation_Function translation_func,
SitlT_Translation_Test translation_test);
载荷翻译函数
op_pk_sitl_translate_payload_from_real_to_sim()
将数据包的载荷从真实(real)翻译为仿真(simulated)。原型如下:
int op_pk_sitl_translate_payload_from_real_to_sim (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_payload_from_sim_to_real()
将数据包的载荷从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_payload_from_sim_to_real (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
初始化函数
op_pk_sitl_packet_translation_init()
对所有翻译函数调用注册函数。详见内置翻译函数注册。原型如下:
int op_pk_sitl_packet_translation_init (OP_SIM_CONTEXT_ARG_OPT_COMMA void);
从真实到仿真的翻译函数
op_pk_sitl_from_real_all_supported()
用作翻译入口函数,调用载荷翻译函数。原型如下:
int op_pk_sitl_from_real_all_supported (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ethernet()
将 Ethernet(以太网)数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ethernet (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_arp()
将 ARP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_arp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_ip()
将 IPv4 IP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_ip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_icmp()
将 IPv4 ICMP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_icmp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_tcp()
将 IPv4 TCP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_tcp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_udp()
将 IPv4 UDP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_udp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_ospf()
将 IPv4 OSPF 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_ospf (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_from_real_ipv4_rip()
将 IPv4 RIP 数据包从真实翻译为仿真。原型如下:
int op_pk_sitl_translate_from_real_ipv4_rip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
从仿真到真实的翻译函数
op_pk_sitl_to_real_all_supported()
用作翻译入口函数,调用载荷翻译函数。原型如下:
int op_pk_sitl_to_real_all_supported (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ethernet()
将 Ethernet 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ethernet (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_arp()
将 ARP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_arp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_ip()
将 IPv4 IP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_ip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_icmp()
将 IPv4 ICMP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_icmp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_tcp()
将 IPv4 TCP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_tcp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_udp()
将 IPv4 UDP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_udp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_ospf()
将 IPv4 OSPF 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_ospf (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
op_pk_sitl_translate_to_real_ipv4_rip()
将 IPv4 RIP 数据包从仿真翻译为真实。原型如下:
int op_pk_sitl_translate_to_real_ipv4_rip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
测试函数
这些函数与翻译函数配对使用。不过,多数情况下真实到仿真与仿真到真实的翻译会使用同一个测试函数。
int op_pk_sitl_test_from_real_ethernet (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_to_real_ethernet (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr)
int op_pk_sitl_test_from_real_arp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_ip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_icmp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_tcp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_udp (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_ospf (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_from_real_ipv4_rip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
int op_pk_sitl_test_to_real_ipv4_ip (OP_SIM_CONTEXT_ARG_OPT_COMMA SitlT_SCDB* scdb_ptr);
SITL 支持的仿真数据包格式
仿真到真实的 Kernel Procedure 要求使用标准的 Riverbed 数据包格式。支持的格式如下:
- ethernet_v2
- ip_dgram_v4
- arp_v2
- tcp_seg_v2
- ip_icmp_echo
- udp_dgram_v2
- rip_message2
- ospf_hello_v2
- ospf_dbase_desc_v2
- ospf_ls_request_v2
- ospf_ls_update_v2
- ospf_ls_ack_v2
这些 Kernel Procedure 会翻译当前嵌套层中处于上述任一格式的任何数据包。你可以在 Packet Format Editor(数据包格式编辑器)中打开这些格式以查看其细节。
真实到仿真的 Kernel Procedure 返回的仿真数据包同样使用这一组标准的 Riverbed 数据包格式,但格式可能按如下方式修改。
所有数据包
如果某种不支持的协议的数据包到达 SITL(处于任意嵌套层),保存未翻译载荷的一块内存将作为结构字段存储在无格式数据包(unformatted packet)中,并且该数据包将成为翻译的结果,通常作为更低层数据包的载荷。你可以使用 SITL 节点的 Maximum Packet Translation Level 属性将翻译限制在任意层。未翻译的数据将如上所述存储在无格式数据包中。
TCP 与 UDP 数据包
如果真实数据包的目的地址位于仿真内部,SITL 会尝试转换其载荷。如果真实数据包的目的地址位于仿真外部,载荷数据将被封装在无格式数据包中(如前文对所有数据包所述),并设置为该 TCP 或 UDP 数据包的载荷数据包。此行为由 SITL 节点的 Limit Pass-through Translation To IP Level 属性控制,默认设置为 “enabled”(启用)。你可以将其设置为 “disabled”(禁用),以允许对直通仿真的 TCP 和 UDP 数据包进行完整翻译。