aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--GPL/traffic_scripts/nat.py219
-rw-r--r--GPL/traffic_scripts/send_vxlan_check_vxlan.py1
-rw-r--r--resources/api/vpp/supported_crcs.yaml40
-rw-r--r--resources/libraries/robot/ip/ip4.robot2
-rw-r--r--resources/libraries/robot/shared/traffic.robot53
-rw-r--r--tests/vpp/device/ip4/eth2p-ethip4tcp-snat44ed-dev.robot117
-rw-r--r--tests/vpp/device/ip4/eth2p-ethip4udp-snat44ed-dev.robot117
7 files changed, 528 insertions, 21 deletions
diff --git a/GPL/traffic_scripts/nat.py b/GPL/traffic_scripts/nat.py
new file mode 100644
index 0000000000..0ba9f4aefc
--- /dev/null
+++ b/GPL/traffic_scripts/nat.py
@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2020 Cisco and/or its affiliates.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at:
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Traffic script for NAT verification."""
+
+import sys
+
+import ipaddress
+
+from scapy.layers.inet import IP, TCP, UDP
+from scapy.layers.inet6 import IPv6, ICMPv6ND_NS
+from scapy.layers.l2 import Ether
+from scapy.packet import Raw
+
+from .PacketVerifier import RxQueue, TxQueue
+from .TrafficScriptArg import TrafficScriptArg
+
+
+def valid_ipv4(ip):
+ try:
+ ipaddress.IPv4Address(ip)
+ return True
+ except (AttributeError, ipaddress.AddressValueError):
+ return False
+
+
+def valid_ipv6(ip):
+ try:
+ ipaddress.IPv6Address(ip)
+ return True
+ except (AttributeError, ipaddress.AddressValueError):
+ return False
+
+
+def main():
+ """Send, receive and check IP/IPv6 packets with UDP/TCP layer passing
+ through NAT.
+ """
+ args = TrafficScriptArg(
+ [
+ u"tx_src_mac", u"rx_dst_mac", u"src_ip_in", u"src_ip_out",
+ u"dst_ip", u"tx_dst_mac", u"rx_src_mac", u"protocol",
+ u"src_port_in", u"src_port_out", u"dst_port"
+ ]
+ )
+
+ tx_src_mac = args.get_arg(u"tx_src_mac")
+ tx_dst_mac = args.get_arg(u"tx_dst_mac")
+ rx_dst_mac = args.get_arg(u"rx_dst_mac")
+ rx_src_mac = args.get_arg(u"rx_src_mac")
+ src_ip_in = args.get_arg(u"src_ip_in")
+ src_ip_out = args.get_arg(u"src_ip_out")
+ dst_ip = args.get_arg(u"dst_ip")
+ protocol = args.get_arg(u"protocol")
+ sport_in = int(args.get_arg(u"src_port_in"))
+ try:
+ sport_out = int(args.get_arg(u"src_port_out"))
+ except ValueError:
+ sport_out = None
+ dst_port = int(args.get_arg(u"dst_port"))
+
+ tx_txq = TxQueue(args.get_arg(u"tx_if"))
+ tx_rxq = RxQueue(args.get_arg(u"tx_if"))
+ rx_txq = TxQueue(args.get_arg(u"rx_if"))
+ rx_rxq = RxQueue(args.get_arg(u"rx_if"))
+
+ sent_packets = list()
+ pkt_raw = Ether(src=tx_src_mac, dst=tx_dst_mac)
+
+ if valid_ipv4(src_ip_in) and valid_ipv4(dst_ip):
+ ip_layer = IP
+ elif valid_ipv6(src_ip_in) and valid_ipv6(dst_ip):
+ ip_layer = IPv6
+ else:
+ raise ValueError(u"IP not in correct format")
+ pkt_raw /= ip_layer(src=src_ip_in, dst=dst_ip)
+
+ if protocol == u"UDP":
+ pkt_raw /= UDP(sport=sport_in, dport=dst_port)
+ proto_layer = UDP
+ elif protocol == u"TCP":
+ # flags=0x2 => SYN flag set
+ pkt_raw /= TCP(sport=sport_in, dport=dst_port, flags=0x2)
+ proto_layer = TCP
+ else:
+ raise ValueError(u"Incorrect protocol")
+
+ pkt_raw /= Raw()
+ sent_packets.append(pkt_raw)
+ tx_txq.send(pkt_raw)
+
+ while True:
+ ether = rx_rxq.recv(2)
+
+ if ether is None:
+ raise RuntimeError(u"IP packet Rx timeout")
+
+ if ether.haslayer(ICMPv6ND_NS):
+ # read another packet in the queue if the current one is ICMPv6ND_NS
+ continue
+ else:
+ # otherwise process the current packet
+ break
+
+ if rx_dst_mac != ether[Ether].dst or rx_src_mac != ether[Ether].src:
+ raise RuntimeError(f"Matching packet unsuccessful: {ether!r}")
+
+ ip_pkt = ether.payload
+ if not isinstance(ip_pkt, ip_layer):
+ raise RuntimeError(f"Not an {ip_layer!s} packet received: {ip_pkt!r}")
+ if ip_pkt.src != src_ip_out:
+ raise RuntimeError(
+ f"Matching Src IP address unsuccessful: "
+ f"{src_ip_out} != {ip_pkt.src}"
+ )
+ if ip_pkt.dst != dst_ip:
+ raise RuntimeError(
+ f"Matching Dst IP address unsuccessful: {dst_ip} != {ip_pkt.dst}"
+ )
+
+ proto_pkt = ip_pkt.payload
+ if not isinstance(proto_pkt, proto_layer):
+ raise RuntimeError(
+ f"Not a {proto_layer!s} packet received: {proto_pkt!r}"
+ )
+ if sport_out is not None:
+ if proto_pkt.sport != sport_out:
+ raise RuntimeError(
+ f"Matching Src {proto_layer!s} port unsuccessful: "
+ f"{sport_out} != {proto_pkt.sport}"
+ )
+ else:
+ sport_out = proto_pkt.sport
+ if proto_pkt.dport != dst_port:
+ raise RuntimeError(
+ f"Matching Dst {proto_layer!s} port unsuccessful: "
+ f"{dst_port} != {proto_pkt.dport}"
+ )
+ if proto_layer == TCP:
+ if proto_pkt.flags != 0x2:
+ raise RuntimeError(
+ f"Not a TCP SYN packet received: {proto_pkt!r}"
+ )
+
+ pkt_raw = Ether(src=rx_dst_mac, dst=rx_src_mac)
+ pkt_raw /= ip_layer(src=dst_ip, dst=src_ip_out)
+ pkt_raw /= proto_layer(sport=dst_port, dport=sport_out)
+ if proto_layer == TCP:
+ # flags=0x12 => SYN, ACK flags set
+ pkt_raw[TCP].flags = 0x12
+ pkt_raw /= Raw()
+ rx_txq.send(pkt_raw)
+
+ while True:
+ ether = tx_rxq.recv(2, ignore=sent_packets)
+
+ if ether is None:
+ raise RuntimeError(u"IP packet Rx timeout")
+
+ if ether.haslayer(ICMPv6ND_NS):
+ # read another packet in the queue if the current one is ICMPv6ND_NS
+ continue
+ else:
+ # otherwise process the current packet
+ break
+
+ if ether[Ether].dst != tx_src_mac or ether[Ether].src != tx_dst_mac:
+ raise RuntimeError(f"Matching packet unsuccessful: {ether!r}")
+
+ ip_pkt = ether.payload
+ if not isinstance(ip_pkt, ip_layer):
+ raise RuntimeError(f"Not an {ip_layer!s} packet received: {ip_pkt!r}")
+ if ip_pkt.src != dst_ip:
+ raise RuntimeError(
+ f"Matching Src IP address unsuccessful: {dst_ip} != {ip_pkt.src}"
+ )
+ if ip_pkt.dst != src_ip_in:
+ raise RuntimeError(
+ f"Matching Dst IP address unsuccessful: {src_ip_in} != {ip_pkt.dst}"
+ )
+
+ proto_pkt = ip_pkt.payload
+ if not isinstance(proto_pkt, proto_layer):
+ raise RuntimeError(
+ f"Not a {proto_layer!s} packet received: {proto_pkt!r}"
+ )
+ if proto_pkt.sport != dst_port:
+ raise RuntimeError(
+ f"Matching Src {proto_layer!s} port unsuccessful: "
+ f"{dst_port} != {proto_pkt.sport}"
+ )
+ if proto_pkt.dport != sport_in:
+ raise RuntimeError(
+ f"Matching Dst {proto_layer!s} port unsuccessful: "
+ f"{sport_in} != {proto_pkt.dport}"
+ )
+ if proto_layer == TCP:
+ if proto_pkt.flags != 0x12:
+ raise RuntimeError(
+ f"Not a TCP SYN-ACK packet received: {proto_pkt!r}"
+ )
+
+ sys.exit(0)
+
+
+if __name__ == u"__main__":
+ main()
diff --git a/GPL/traffic_scripts/send_vxlan_check_vxlan.py b/GPL/traffic_scripts/send_vxlan_check_vxlan.py
index 0b1da81f18..8bc8f6e09e 100644
--- a/GPL/traffic_scripts/send_vxlan_check_vxlan.py
+++ b/GPL/traffic_scripts/send_vxlan_check_vxlan.py
@@ -115,5 +115,6 @@ def main():
sys.exit(0)
+
if __name__ == u"__main__":
main()
diff --git a/resources/api/vpp/supported_crcs.yaml b/resources/api/vpp/supported_crcs.yaml
index e8eb379aa8..c4bc243aae 100644
--- a/resources/api/vpp/supported_crcs.yaml
+++ b/resources/api/vpp/supported_crcs.yaml
@@ -186,26 +186,26 @@
memif_dump: '0x51077d14' # dev
memif_socket_filename_add_del: '0xa2ce1a10' # dev
memif_socket_filename_add_del_reply: '0xe8d4e804' # dev
- nat44_add_del_address_range: '0xd4c7568c' # perf
- nat44_add_del_address_range_reply: '0xe8d4e804' # perf
- nat44_address_details: '0x45410ac4' # perf teardown
- nat44_address_dump: '0x51077d14' # perf teardown
- nat44_interface_add_del_feature: '0xf3699b83' # perf
- nat44_interface_add_del_feature_reply: '0xe8d4e804' # perf
- nat44_interface_addr_details: '0x3e687514' # perf teardown
- nat44_interface_addr_dump: '0x51077d14' # perf teardown
- nat44_interface_details: '0x5d286289' # perf teardown
- nat44_interface_dump: '0x51077d14' # perf teardown
- nat44_static_mapping_details: '0x1a433ef7' # perf teardown
- nat44_static_mapping_dump: '0x51077d14' # perf teardown
- nat44_user_details: '0x355896c2' # perf teardown
- nat44_user_dump: '0x51077d14' # perf teardown
- nat44_user_session_details: '0x1965fd69' # perf teardown
- nat44_user_session_dump: '0xe1899c98' # perf teardown
- nat_show_config: '0x51077d14' # perf teardown
- nat_show_config_reply: '0x7903ef06' # perf teardown
- nat_worker_details: '0x84bf06fc' # perf teardown
- nat_worker_dump: '0x51077d14' # perf teardown
+ nat44_add_del_address_range: '0xd4c7568c' # dev
+ nat44_add_del_address_range_reply: '0xe8d4e804' # dev
+ nat44_address_details: '0x45410ac4' # dev teardown
+ nat44_address_dump: '0x51077d14' # dev teardown
+ nat44_interface_add_del_feature: '0xf3699b83' # dev
+ nat44_interface_add_del_feature_reply: '0xe8d4e804' # dev
+ nat44_interface_addr_details: '0x3e687514' # dev teardown
+ nat44_interface_addr_dump: '0x51077d14' # dev teardown
+ nat44_interface_details: '0x5d286289' # dev teardown
+ nat44_interface_dump: '0x51077d14' # dev teardown
+ nat44_static_mapping_details: '0x1a433ef7' # dev teardown
+ nat44_static_mapping_dump: '0x51077d14' # dev teardown
+ nat44_user_details: '0x355896c2' # dev teardown
+ nat44_user_dump: '0x51077d14' # dev teardown
+ nat44_user_session_details: '0x1965fd69' # dev teardown
+ nat44_user_session_dump: '0xe1899c98' # dev teardown
+ nat_show_config: '0x51077d14' # dev teardown
+ nat_show_config_reply: '0x7903ef06' # dev teardown
+ nat_worker_details: '0x84bf06fc' # dev teardown
+ nat_worker_dump: '0x51077d14' # dev teardown
# 6x^ tc01-64B-1c-ethip4udp-snat44det-h1-p1-s1-mrr
# ^ nat44NOTscaleNOTsrc_user_1
nsim_configure: '0x16ed400f' # perf
diff --git a/resources/libraries/robot/ip/ip4.robot b/resources/libraries/robot/ip/ip4.robot
index 9855e129a4..f61466bf4e 100644
--- a/resources/libraries/robot/ip/ip4.robot
+++ b/resources/libraries/robot/ip/ip4.robot
@@ -599,7 +599,7 @@
| | ... | VPP Interface Set IP Address | ${dut2} | ${subif_index_2}
| | ... | 2.2.2.2 | 30
| | VPP Interface Set IP Address
-| | ... | ${dut} | ${dut_if2} | 3.3.3.2 | 30
+| | ... | ${dut} | ${dut_if2} | 3.3.3.2 | 30
| | Vpp Route Add | ${dut1} | ${tg_if1_net} | 30 | gateway=1.1.1.1
| | ... | interface=${DUT1_${int}1}[0]
| | Run Keyword If | '${dut2_status}' == 'PASS'
diff --git a/resources/libraries/robot/shared/traffic.robot b/resources/libraries/robot/shared/traffic.robot
index 0b65c8d892..1f10787bc1 100644
--- a/resources/libraries/robot/shared/traffic.robot
+++ b/resources/libraries/robot/shared/traffic.robot
@@ -556,3 +556,56 @@
| | ... | --dir0_dstsid3 ${tg_dstsid3} | --dir1_dstsid3 ${dut_dstsid3}
| | ... | --static_proxy ${static_proxy}
| | Run Traffic Script On Node | srv6_encap.py | ${node} | ${args}
+
+| Send TCP or UDP packet and verify network address translations
+| | [Documentation] | Send TCP or UDP packet from TG-if1 to TG-if2 and response\
+| | ... | in opposite direction via DUT with configured NAT. Check packet\
+| | ... | headers on both sides.
+| |
+| | ... | *Arguments:*
+| |
+| | ... | _NOTE:_ Arguments are based on topology:
+| | ... | TG(if1)->(if1)DUT(if2)->TG(if2)
+| |
+| | ... | - tg_node - Node where to run traffic script. Type: dictionary
+| | ... | - tx_interface - TG Interface 1. Type: string
+| | ... | - rx_interface - TG Interface 2. Type: string
+| | ... | - tx_dst_mac - Destination MAC for TX interface / DUT interface 1 MAC.
+| | ... | Type: string
+| | ... | - rx_src_mac - Source MAC for RX interface / DUT interface 2 MAC.
+| | ... | Type: string
+| | ... | - src_ip_in - Internal source IP address. Type: string
+| | ... | - src_ip_out - External source IP address. Type: string
+| | ... | - dst_ip - Destination IP address. Type: string
+| | ... | - protocol - TCP or UDP protocol. Type: string
+| | ... | - src_port_in - Internal source TCP/UDP port. Type: string or integer
+| | ... | - src_port_out - External source TCP/UDP port; default value: unknown.
+| | ... | Type: string or integer
+| | ... | - dst_port - Destination TCP/UDP port. Type: string or integer
+| |
+| | ... | *Return:*
+| | ... | - No value returned
+| |
+| | ... | *Example:*
+| |
+| | ... | \| Send TCP or UDP packet and verify network address translations \
+| | ... | \| ${nodes['TG']} \| port1 \| port2 \| 08:00:27:cc:4f:54 \
+| | ... | \| 08:00:27:c9:6a:d5 \| 192.168.0.0 \| 68.142.68.0 \| 20.0.0.0 \
+| | ... | \| TCP \| 1024 \| 8080 \|
+| |
+| | [Arguments] | ${tg_node} | ${tx_interface} | ${rx_interface} | ${tx_dst_mac}
+| | ... | ${rx_src_mac} | ${src_ip_in} | ${src_ip_out} | ${dst_ip}
+| | ... | ${protocol} | ${src_port_in} | ${dst_port} | ${src_port_out}=unknown
+| |
+| | ${tx_src_mac}= | Get Interface Mac | ${tg_node} | ${tx_interface}
+| | ${tx_if_name}= | Get Interface Name | ${tg_node} | ${tx_interface}
+| | ${rx_dst_mac}= | Get Interface Mac | ${tg_node} | ${rx_interface}
+| | ${rx_if_name}= | Get Interface Name | ${tg_node} | ${rx_interface}
+| | ${args}= | Catenate | --rx_if ${rx_if_name} | --tx_if ${tx_if_name}
+| | ... | --tx_src_mac ${tx_src_mac} | --tx_dst_mac ${tx_dst_mac}
+| | ... | --rx_src_mac ${rx_src_mac} | --rx_dst_mac ${rx_dst_mac}
+| | ... | --src_ip_in ${src_ip_in} | --src_ip_out ${src_ip_out}
+| | ... | --dst_ip ${dst_ip} | --protocol ${protocol}
+| | ... | --src_port_in ${src_port_in} | --src_port_out ${src_port_out}
+| | ... | --dst_port ${dst_port}
+| | Run Traffic Script On Node | nat.py | ${tg_node} | ${args}
diff --git a/tests/vpp/device/ip4/eth2p-ethip4tcp-snat44ed-dev.robot b/tests/vpp/device/ip4/eth2p-ethip4tcp-snat44ed-dev.robot
new file mode 100644
index 0000000000..5fe36c4341
--- /dev/null
+++ b/tests/vpp/device/ip4/eth2p-ethip4tcp-snat44ed-dev.robot
@@ -0,0 +1,117 @@
+# Copyright (c) 2020 Cisco and/or its affiliates.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at:
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+*** Settings ***
+| Resource | resources/libraries/robot/shared/default.robot
+| Resource | resources/libraries/robot/ip/nat.robot
+| Resource | resources/libraries/robot/shared/traffic.robot
+|
+| Force Tags | 2_NODE_SINGLE_LINK_TOPO | DEVICETEST | HW_ENV | DCR_ENV | SCAPY
+| ... | NIC_Virtual | ETH | IP4FWD | FEATURE | NAT44 | NAT44_ENDPOINT_DEPENDENT
+| ... | BASE | TCP | DRV_VFIO_PCI
+| ... | RXQ_SIZE_0 | TXQ_SIZE_0
+| ... | ethip4tcp-snat44ed-dev
+|
+| Suite Setup | Setup suite topology interfaces | scapy
+| Test Setup | Setup test
+| Test Teardown | Tear down test | packet_trace | nat-ed
+|
+| Test Template | Local Template
+|
+| Documentation | *Connections per second NAT44 endpoint-dependent mode
+| ... | performance test cases*
+|
+| ... | *[Top] Network Topologies:* TG-DUT1-TG 2-node circular topology
+| ... | with single links between nodes.
+| ... | *[Enc] Packet Encapsulations:* Eth-IPv4-TCP for IPv4 routing.
+| ... | *[Cfg] DUT configuration:* DUT1 is configured with IPv4 routing and
+| ... | one static IPv4 /18 route entries.
+| ... | DUT1 is tested with ${nic_name}.\
+| ... | *[Ver] TG verification:* Eth-IPv4-TCP packet is sent from TG to DUT1 in\
+| ... | one direction. Packet is received and verified for correctness on TG.\
+| ... | Then Eth-IPv4-TCP packet is sent from TG in opposite direction. Packet\
+| ... | is received and verified for correctness on TG.
+| ... | *[Ref] Applicable standard specifications:* RFC791, RFC793, RFC3022,
+| ... | RFC4787.
+
+*** Variables ***
+| @{plugins_to_enable}= | dpdk_plugin.so | nat_plugin.so
+| ${crypto_type}= | ${None}
+| ${nic_name}= | virtual
+| ${nic_driver}= | vfio-pci
+| ${nic_rxq_size}= | 0
+| ${nic_txq_size}= | 0
+| ${nic_pfs}= | 2
+| ${nic_vfs}= | 0
+| ${overhead}= | ${0}
+# IP settings
+| ${tg_if1_ip4}= | 10.0.0.2
+| ${tg_if1_mask}= | ${20}
+| ${tg_if2_ip4}= | 12.0.0.2
+| ${tg_if2_mask}= | ${20}
+| ${dut1_if1_ip4}= | 10.0.0.1
+| ${dut1_if1_mask}= | ${24}
+| ${dut1_if2_ip4}= | 12.0.0.1
+| ${dut1_if2_mask}= | ${24}
+| ${dest_net}= | 20.0.0.0
+| ${dest_mask}= | ${22}
+# proto layer settings
+| ${protocol}= | TCP
+| ${src_port_in}= | 1024
+| ${dst_port}= | 8080
+# NAT settings
+| ${nat_mode}= | endpoint-dependent
+| ${max_translations_per_thread}= | 81920
+| ${in_net}= | 192.168.0.0
+| ${in_mask}= | ${22}
+| ${out_net}= | 68.142.68.0
+| ${out_net_end}= | 68.142.68.0
+| ${out_mask}= | ${32}
+
+*** Keywords ***
+| Local Template
+| |
+| | [Documentation]
+| | ... | [Cfg] DUT runs NAT44 ${nat_mode} configuration.
+| | ... | [Ver] Make TG send IPv4 packet routed over DUT1 interfaces.\
+| | ... | Make TG verify IPv4 packet is correct.
+| |
+| | ... | *Arguments:*
+| | ... | - frame_size - Framesize in Bytes in integer. Type: integer
+| | ... | - phy_cores - Number of physical cores. Type: integer
+| | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
+| |
+| | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
+| |
+| | Set Test Variable | \${frame_size}
+| |
+| | Given Set Jumbo
+| | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
+| | And Pre-initialize layer driver | ${nic_driver}
+| | And Add NAT to all DUTs | nat_mode=${nat_mode}
+| | And Add NAT max translations per thread to all DUTs
+| | ... | ${max_translations_per_thread}
+| | And Apply startup configuration on all VPP DUTs | with_trace=${True}
+| | When Initialize layer driver | ${nic_driver}
+| | And Initialize layer interface
+| | And Initialize IPv4 forwarding for NAT44 in circular topology
+| | And Initialize NAT44 endpoint-dependent mode in circular topology
+| | Then Send TCP or UDP packet and verify network address translations
+| | ... | ${tg} | ${TG_pf1}[0] | ${TG_pf2}[0] | ${DUT1_vf1_mac}[0]
+| | ... | ${DUT1_vf2_mac}[0] | ${in_net} | ${out_net} | ${dest_net}
+| | ... | ${protocol} | ${src_port_in} | ${dst_port}
+
+*** Test Cases ***
+| 64B-ethip4tcp-snat44ed-dev
+| | [Tags] | 64B
+| | frame_size=${64} | phy_cores=${0}
diff --git a/tests/vpp/device/ip4/eth2p-ethip4udp-snat44ed-dev.robot b/tests/vpp/device/ip4/eth2p-ethip4udp-snat44ed-dev.robot
new file mode 100644
index 0000000000..99cb761578
--- /dev/null
+++ b/tests/vpp/device/ip4/eth2p-ethip4udp-snat44ed-dev.robot
@@ -0,0 +1,117 @@
+# Copyright (c) 2020 Cisco and/or its affiliates.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at:
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+*** Settings ***
+| Resource | resources/libraries/robot/shared/default.robot
+| Resource | resources/libraries/robot/ip/nat.robot
+| Resource | resources/libraries/robot/shared/traffic.robot
+|
+| Force Tags | 2_NODE_SINGLE_LINK_TOPO | DEVICETEST | HW_ENV | DCR_ENV | SCAPY
+| ... | NIC_Virtual | ETH | IP4FWD | FEATURE | NAT44 | NAT44_ENDPOINT_DEPENDENT
+| ... | BASE | UDP | DRV_VFIO_PCI
+| ... | RXQ_SIZE_0 | TXQ_SIZE_0
+| ... | ethip4udp-snat44ed-dev
+|
+| Suite Setup | Setup suite topology interfaces | scapy
+| Test Setup | Setup test
+| Test Teardown | Tear down test | packet_trace | nat-ed
+|
+| Test Template | Local Template
+|
+| Documentation | *RFC2544: Pkt throughput NAT44 endpoint-dependent mode
+| ... | performance test cases*
+|
+| ... | *[Top] Network Topologies:* TG-DUT1-TG 2-node circular topology
+| ... | with single links between nodes.
+| ... | *[Enc] Packet Encapsulations:* Eth-IPv4-UDP for IPv4 routing.
+| ... | *[Cfg] DUT configuration:* DUT1 is configured with IPv4 routing and
+| ... | one static IPv4 /${dest_mask} route entries.
+| ... | DUT1 is tested with ${nic_name}.\
+| ... | *[Ver] TG verification:* Eth-IPv4-UDP packet is sent from TG to DUT1 in\
+| ... | one direction. Packet is received and verified for correctness on TG.\
+| ... | Then Eth-IPv4-UDP packet is sent from TG in opposite direction. Packet\
+| ... | is received and verified for correctness on TG.
+| ... | *[Ref] Applicable standard specifications:* RFC791, RFC768, RFC3022,
+| ... | RFC4787.
+
+*** Variables ***
+| @{plugins_to_enable}= | dpdk_plugin.so | nat_plugin.so
+| ${crypto_type}= | ${None}
+| ${nic_name}= | virtual
+| ${nic_driver}= | vfio-pci
+| ${nic_rxq_size}= | 0
+| ${nic_txq_size}= | 0
+| ${nic_pfs}= | 2
+| ${nic_vfs}= | 0
+| ${overhead}= | ${0}
+# IP settings
+| ${tg_if1_ip4}= | 10.0.0.2
+| ${tg_if1_mask}= | ${20}
+| ${tg_if2_ip4}= | 12.0.0.2
+| ${tg_if2_mask}= | ${20}
+| ${dut1_if1_ip4}= | 10.0.0.1
+| ${dut1_if1_mask}= | ${24}
+| ${dut1_if2_ip4}= | 12.0.0.1
+| ${dut1_if2_mask}= | ${24}
+| ${dest_net}= | 20.0.0.0
+| ${dest_mask}= | ${22}
+# proto layer settings
+| ${protocol}= | UDP
+| ${src_port_in}= | 1024
+| ${dst_port}= | 8080
+# NAT settings
+| ${nat_mode}= | endpoint-dependent
+| ${max_translations_per_thread}= | 81920
+| ${in_net}= | 192.168.0.0
+| ${in_mask}= | ${22}
+| ${out_net}= | 68.142.68.0
+| ${out_net_end}= | 68.142.68.0
+| ${out_mask}= | ${32}
+
+*** Keywords ***
+| Local Template
+| |
+| | [Documentation]
+| | ... | [Cfg] DUT runs NAT44 ${nat_mode} configuration.
+| | ... | [Ver] Make TG send IPv4 packet routed over DUT1 interfaces.\
+| | ... | Make TG verify IPv4 packet is correct.
+| |
+| | ... | *Arguments:*
+| | ... | - frame_size - Framesize in Bytes in integer. Type: integer
+| | ... | - phy_cores - Number of physical cores. Type: integer
+| | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
+| |
+| | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
+| |
+| | Set Test Variable | \${frame_size}
+| |
+| | Given Set Jumbo
+| | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
+| | And Pre-initialize layer driver | ${nic_driver}
+| | And Add NAT to all DUTs | nat_mode=${nat_mode}
+| | And Add NAT max translations per thread to all DUTs
+| | ... | ${max_translations_per_thread}
+| | And Apply startup configuration on all VPP DUTs | with_trace=${True}
+| | When Initialize layer driver | ${nic_driver}
+| | And Initialize layer interface
+| | And Initialize IPv4 forwarding for NAT44 in circular topology
+| | And Initialize NAT44 endpoint-dependent mode in circular topology
+| | Then Send TCP or UDP packet and verify network address translations
+| | ... | ${tg} | ${TG_pf1}[0] | ${TG_pf2}[0] | ${DUT1_vf1_mac}[0]
+| | ... | ${DUT1_vf2_mac}[0] | ${in_net} | ${out_net} | ${dest_net}
+| | ... | ${protocol} | ${src_port_in} | ${dst_port}
+
+*** Test Cases ***
+| 64B-ethip4udp-snat44ed-dev
+| | [Tags] | 64B
+| | frame_size=${64} | phy_cores=${0}