diff options
Diffstat (limited to 'GPL/traffic_profiles/trex')
7 files changed, 1403 insertions, 12 deletions
diff --git a/GPL/traffic_profiles/trex/profile_trex_stateless_base_class.py b/GPL/traffic_profiles/trex/profile_trex_stateless_base_class.py index 5cae6bfb79..5b86192021 100644 --- a/GPL/traffic_profiles/trex/profile_trex_stateless_base_class.py +++ b/GPL/traffic_profiles/trex/profile_trex_stateless_base_class.py @@ -24,7 +24,6 @@ """Base class for stream profiles for T-rex traffic generator. """ -import sys import socket import struct @@ -129,35 +128,39 @@ class TrafficStreamsBaseClass: # Frame size is defined as an integer, e.g. 64, 1518: if isinstance(self.framesize, int): - # Create a base packet and pad it to size - payload_len = max(0, self.framesize - len(base_pkt_a) - 4) # No FCS + # Create a base packet and pad it to size; deduct FCS + payload_len_a = max(0, self.framesize - len(base_pkt_a) - 4) + payload_len_b = max(0, self.framesize - len(base_pkt_b) - 4) # Direction 0 --> 1 pkt_a = STLPktBuilder( - pkt=base_pkt_a / self._gen_payload(payload_len), vm=vm1 + pkt=base_pkt_a / self._gen_payload(payload_len_a), vm=vm1 ) # Direction 1 --> 0 pkt_b = STLPktBuilder( - pkt=base_pkt_b / self._gen_payload(payload_len), vm=vm2 + pkt=base_pkt_b / self._gen_payload(payload_len_b), vm=vm2 ) # Packets for latency measurement: # Direction 0 --> 1 pkt_lat_a = STLPktBuilder( - pkt=base_pkt_a / self._gen_payload(payload_len), vm=vm1 + pkt=base_pkt_a / self._gen_payload(payload_len_a), vm=vm1 ) # Direction 1 --> 0 pkt_lat_b = STLPktBuilder( - pkt=base_pkt_b / self._gen_payload(payload_len), vm=vm2 + pkt=base_pkt_b / self._gen_payload(payload_len_b), vm=vm2 ) # Create the streams: # Direction 0 --> 1 - stream1 = STLStream(packet=pkt_a, mode=STLTXCont(pps=9000)) + stream1 = STLStream( + packet=pkt_a, mode=STLTXCont(pps=9000) + ) # Direction 1 --> 0 # second traffic stream with a phase of 10ns (inter-stream gap) - stream2 = STLStream(packet=pkt_b, isg=10.0, - mode=STLTXCont(pps=9000)) + stream2 = STLStream( + packet=pkt_b, isg=10.0, mode=STLTXCont(pps=9000) + ) # Streams for latency measurement: # Direction 0 --> 1 @@ -189,10 +192,12 @@ class TrafficStreamsBaseClass: # Create a base packet and pad it to size pkt_a = STLPktBuilder( pkt=base_pkt_a / self._gen_payload(payload_len_a), - vm=vm1) + vm=vm1 + ) pkt_b = STLPktBuilder( pkt=base_pkt_b / self._gen_payload(payload_len_b), - vm=vm2) + vm=vm2 + ) # Create the streams: stream1.append(STLStream( diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1024t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1024t.py new file mode 100644 index 0000000000..42c015272d --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1024t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.132.0.255 + - Destination IP address range: 10.0.1.0 - 10.4.0.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.4.0.255 + - Inner Destination IP address range: 10.128.1.0 - 10.132.0.255 + - Source UDP port range: 1024 - 65535 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from trex.stl.api import * +from scapy.contrib.geneve import GENEVE + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 1024 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-16t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-16t.py new file mode 100644 index 0000000000..151ae505c8 --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-16t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.128.17.255 + - Destination IP address range: 10.0.1.0 - 10.0.17.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.0.17.255 + - Inner Destination IP address range: 10.128.1.0 - 10.128.17.255 + - Source UDP port range: 1024 - 5119 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from scapy.contrib.geneve import GENEVE +from trex.stl.api import * + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 16 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1t.py new file mode 100644 index 0000000000..a62577e292 --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-1t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.128.1.255 + - Destination IP address range: 10.0.1.0 - 10.0.1.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.0.1.255 + - Inner Destination IP address range: 10.128.1.0 - 10.128.1.255 + - Source UDP port range: 1024 - 1279 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from scapy.contrib.geneve import GENEVE +from trex.stl.api import * + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 1 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-256t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-256t.py new file mode 100644 index 0000000000..8098f919d5 --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-256t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.129.0.255 + - Destination IP address range: 10.0.1.0 - 10.1.0.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.1.0.255 + - Inner Destination IP address range: 10.128.1.0 - 10.129.0.255 + - Source UDP port range: 1024 - 65535 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from scapy.contrib.geneve import GENEVE +from trex.stl.api import * + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 256 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-4t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-4t.py new file mode 100644 index 0000000000..975d204d7d --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-4t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.128.4.255 + - Destination IP address range: 10.0.1.0 - 10.0.4.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.0.4.255 + - Inner Destination IP address range: 10.128.1.0 - 10.128.4.255 + - Source UDP port range: 1024 - 2047 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from scapy.contrib.geneve import GENEVE +from trex.stl.api import * + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 4 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() diff --git a/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-64t.py b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-64t.py new file mode 100644 index 0000000000..fd1fa88a52 --- /dev/null +++ b/GPL/traffic_profiles/trex/trex-stl-2n-ethip4-geneve-64t.py @@ -0,0 +1,231 @@ +# Copyright (c) 2021 Cisco and/or its affiliates. +# +# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later +# +# Licensed under the Apache License 2.0 or +# GNU General Public License v2.0 or later; you may not use this file +# except in compliance with one of these Licenses. You +# may obtain a copy of the Licenses at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html +# +# Note: If this file is linked with Scapy, which is GPLv2+, your use of it +# must be under GPLv2+. If at any point in the future it is no longer linked +# with Scapy (or other GPLv2+ licensed software), you are free to choose +# Apache 2. +# +# 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. + +"""Stream profile for T-rex traffic generator. + +Stream profile: + - Two streams sent in directions 0 --> 1 and 1 --> 0 at the same time. + - Direction 0 --> 1: + - Packet: ETH / IP + - Source IP address range: 10.128.1.0 - 10.128.65.255 + - Destination IP address range: 10.0.1.0 - 10.0.65.255 + - Direction 1 --> 0: + - Packet: ETH / IP / UDP / GENEVE / ETH / IP + - Outer Source IP address range: 1.1.1.1 + - Outer Destination IP address range: 1.1.1.2 + - Inner Source IP address range: 10.0.1.0 - 10.0.65.255 + - Inner Destination IP address range: 10.128.1.0 - 10.128.65.255 + - Source UDP port range: 1024 - 17407 + - Destination UDP port range: 6081 +""" + +from ctypes import c_int +from ipaddress import IPv4Address + +from scapy.contrib.geneve import GENEVE +from trex.stl.api import * + +from profile_trex_stateless_base_class import TrafficStreamsBaseClass + + +class TrafficStreams(TrafficStreamsBaseClass): + """Stream profile.""" + + def __init__(self): + """Initialization and setting of streams' parameters.""" + + super(TrafficStreamsBaseClass, self).__init__() + + # Nr. of GENEVE tunnels + self.n_tunnels = 64 + # VNIs used in GENEVE headers of Direction 1 --> 0. + self.p2_geneve_start_vni = 1 + + # IPs used in packet headers of Direction 0 --> 1. + self.p1_src_start_ip = u"10.128.1.0" + self.p1_dst_start_ip = u"10.0.1.0" + + # IPs used in packet headers of Direction 1 --> 0. + self.p2_outer_src_ip = u"1.1.1.1" + self.p2_outer_dst_ip = u"1.1.1.2" + + self.p2_inner_src_start_ip = u"10.0.1.0" + self.p2_inner_dst_start_ip = u"10.128.1.0" + + # MACs used in inner ethernet header of Direction 1 --> 0. + self.p2_inner_dst_mac = u"d0:0b:ee:d0:00:00" + + # UDP ports used in packet headers of Direction 1 --> 0. + self.p2_udp_sport_start = 1024 + self.p2_udp_dport = 6081 + + def define_packets(self): + """Defines the packets to be sent from the traffic generator. + + Packet definition: | ETH | IP | UDP | + + :returns: Packets to be sent from the traffic generator. + :rtype: tuple + """ + p1_src_start_ip_int = int(IPv4Address(self.p1_src_start_ip)) + p1_dst_start_ip_int = int(IPv4Address(self.p1_dst_start_ip)) + p2_inner_src_start_ip_int = int(IPv4Address(self.p2_inner_src_start_ip)) + p2_inner_dst_start_ip_int = int(IPv4Address(self.p2_inner_dst_start_ip)) + + # Direction 0 --> 1 + base_pkt_a = ( + Ether() / + IP( + src=self.p1_src_start_ip, + dst=self.p1_dst_start_ip, + proto=61 + ) + ) + # Direction 1 --> 0 + base_pkt_b = ( + Ether() / + IP( + src=self.p2_outer_src_ip, + dst=self.p2_outer_dst_ip, + proto=17 + ) / + UDP( + sport=self.p2_udp_sport_start, + dport=self.p2_udp_dport + ) / + GENEVE(vni=self.p2_geneve_start_vni) / + Ether(dst=self.p2_inner_dst_mac) / + IP( + src=self.p2_inner_src_start_ip, + dst=self.p2_inner_dst_start_ip, + proto=61 + ) + ) + base_pkt_b /= Raw(load=self._gen_payload(110 - len(base_pkt_b))) + # Direction 0 --> 1 + vm1 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip_src", + min_value=p1_src_start_ip_int, + max_value=p1_src_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_src", + pkt_offset=u"IP.src" + ), + STLVmFlowVar( + name=u"ip_dst", + min_value=p1_dst_start_ip_int, + max_value=p1_dst_start_ip_int + self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrFlowVar( + fv_name=u"ip_dst", + pkt_offset=u"IP.dst" + ), + STLVmFixIpv4( + offset=u"IP" + ) + ] + ) + # Direction 1 --> 0 + vm2 = STLScVmRaw( + [ + STLVmFlowVar( + name=u"ip", + min_value=0, + max_value=self.n_tunnels * 256 - 1, + size=4, + op=u"inc" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_src_start_ip_int, + pkt_offset=u"IP:1.src" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffffff, + add_value=p2_inner_dst_start_ip_int, + pkt_offset=u"IP:1.dst" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=2, + mask=0xffff, + add_value=self.p2_udp_sport_start, + pkt_offset=u"UDP.sport" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff00, + add_value=(self.p2_geneve_start_vni << 8), + pkt_offset=u"GENEVE.vni" + ), + STLVmWrMaskFlowVar( + fv_name=u"ip", + pkt_cast_size=4, + mask=0xffffff, + shift=-8, + offset_fixup=2, + add_value=c_int( + int( + self.p2_inner_dst_mac.replace(u":", u"")[6:12], 16 + ) << 8 + ).value, + pkt_offset=u"Ether:1.dst" + ), + STLVmFixIpv4( + offset=u"IP:1" + ), + STLVmFixIpv4( + offset=u"IP" + ), + STLVmFixChecksumHw( + l3_offset=u"IP", + l4_offset=u"UDP", + l4_type=CTRexVmInsFixHwCs.L4_TYPE_UDP + ) + ] + ) + + return base_pkt_a, base_pkt_b, vm1, vm2 + + +def register(): + """Register this traffic profile to T-rex. + + Do not change this function. + + :return: Traffic streams. + :rtype: Object + """ + return TrafficStreams() |