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 数据包进行完整翻译。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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