2.25. test_classifier_ip6 module¶

class test_classifier_ip6.TestClassifier(methodName='runTest')¶

Bases: framework.VppTestCase

Classifier Test Case

static build_ip6_mask(nh='', src_ip='', dst_ip='', src_port='', dst_port='')¶

Build IPv6 ACL mask data with hexstring format.

Parameters:	nh (str) – next header number <0-ff> src_ip (str) – source ip address <0-ffffffff> dst_ip (str) – destination ip address <0-ffffffff> src_port (str) – source port number <0-ffff> dst_port (str) – destination port number <0-ffff>

static build_ip6_match(nh=0, src_ip='', dst_ip='', src_port=0, dst_port=0)¶

Build IPv6 ACL match data with hexstring format.

Parameters:	nh (int) – next header number with valid option “x” src_ip (str) – source ip6 address with format of “xxx:xxxx::xxxx” dst_ip (str) – destination ip6 address with format of “xxx:xxxx::xxxx” src_port (int) – source port number “x” dst_port (int) – destination port number “x”

static build_mac_mask(dst_mac='', src_mac='', ether_type='')¶

Build MAC ACL mask data with hexstring format.

Parameters:	dst_mac (str) – source MAC address <0-ffffffffffff> src_mac (str) – destination MAC address <0-ffffffffffff> ether_type (str) – ethernet type <0-ffff>

static build_mac_match(dst_mac='', src_mac='', ether_type='')¶

Build MAC ACL match data with hexstring format.

Parameters:	dst_mac (str) – source MAC address <x:x:x:x:x:x> src_mac (str) – destination MAC address <x:x:x:x:x:x> ether_type (str) – ethernet type <0-ffff>

create_classify_session(table_index, match, vrfid=0, is_add=1)¶

Create Classify Session

Parameters:	table_index (int) – table index to identify classify table. match (str) – matched value for interested traffic. vrfid (int) – VRF id. is_add (int) – option to configure classify session. - create(1) or delete(0)

create_classify_table(key, mask, data_offset=0)¶

Create Classify Table

Parameters:	key (str) – key for classify table (ex, ACL name). mask (str) – mask value for interested traffic. data_offset (int) –

create_stream(src_if, dst_if, packet_sizes, proto_l=<UDP sport=1234 dport=5678 |>)¶

Create input packet stream for defined interfaces.

Parameters:	src_if (VppInterface) – Source Interface for packet stream. dst_if (VppInterface) – Destination Interface for packet stream. packet_sizes (list) – packet size to test. proto_l (Scapy) – Required IP protocol. Default protocol is UDP.

input_acl_set_interface(intf, table_index, is_add=1)¶

Configure Input ACL interface

Parameters:	intf (VppInterface) – Interface to apply Input ACL feature. table_index (int) – table index to identify classify table. is_add (int) – option to configure classify session. - enable(1) or disable(0)

output_acl_set_interface(intf, table_index, is_add=1)¶

Configure Output ACL interface

Parameters:	intf (VppInterface) – Interface to apply Output ACL feature. table_index (int) – table index to identify classify table. is_add (int) – option to configure classify session. - enable(1) or disable(0)

setUp()¶

Perform test setup before test case.

Config:

create 4 pg interfaces
- untagged pg0/pg1/pg2 interface
  
  pg0 ——-> pg1 (IP ACL)
  
  —> pg2 (MAC ACL))
setup interfaces:
- put it into UP state
- set IPv6 addresses
- resolve neighbor address using NDP

Variables:	interfaces (list) – pg interfaces. pg_if_packet_sizes (list) – packet sizes in test. acl_tbl_idx (dict) – ACL table index. pbr_vrfid (int) – VRF id for PBR test.

classmethod setUpClass()¶: Perform standard class setup (defined by class method setUpClass in class VppTestCase) before running the test case, set test case related variables and configure VPP.

tearDown()¶: Run standard test teardown and acl related log.

verify_capture(dst_if, capture, proto_l=<class 'scapy.layers.inet.UDP'>)¶

Verify captured input packet stream for defined interface.

Parameters:	dst_if (VppInterface) – Interface to verify captured packet stream. capture (list) – Captured packet stream. proto_l (Scapy) – Required IP protocol. Default protocol is UDP.

class test_classifier_ip6.TestClassifierIP6(methodName='runTest')¶

Bases: test_classifier_ip6.TestClassifier

Classifier IP6 Test Case

test_iacl_dst_ip()¶

Destination IP6 iACL test

Test scenario for basic IP ACL with destination IP

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with destination IP address.
Send and verify received packets on pg1 interface.

test_iacl_src_dst_ip()¶

Source and destination IP6 iACL test

Test scenario for basic IP ACL with source and destination IP

Create IPv4 stream for pg0 -> pg1 interface.
Create iACL with source and destination IP addresses.
Send and verify received packets on pg1 interface.

test_iacl_src_ip()¶

Source IP6 iACL test

Test scenario for basic IP ACL with source IP

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with source IP address.
Send and verify received packets on pg1 interface.

class test_classifier_ip6.TestClassifierIP6MAC(methodName='runTest')¶

Bases: test_classifier_ip6.TestClassifier

Classifier IP6 MAC Test Case

test_acl_mac()¶

IP6 MAC iACL test

Test scenario for basic MAC ACL with source MAC

Create IPv6 stream for pg0 -> pg2 interface.
Create ACL with source MAC address.
Send and verify received packets on pg2 interface.

class test_classifier_ip6.TestClassifierIP6Out(methodName='runTest')¶

Bases: test_classifier_ip6.TestClassifier

Classifier output IP6 Test Case

test_acl_ip_out()¶

Output IP6 ACL test

Test scenario for basic IP ACL with source IP

Create IPv6 stream for pg1 -> pg0 interface.
Create ACL with source IP address.
Send and verify received packets on pg0 interface.

class test_classifier_ip6.TestClassifierIP6TCP(methodName='runTest')¶

Bases: test_classifier_ip6.TestClassifier

Classifier IP6 TCP proto Test Case

test_iacl_proto_tcp()¶

IP6 TCP protocol iACL test

Test scenario for basic protocol ACL with TCP protocol

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with TCP IP protocol.
Send and verify received packets on pg1 interface.

test_iacl_proto_tcp_dport()¶

IP6 TCP destination port iACL test

Test scenario for basic protocol ACL with TCP and dport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with TCP IP protocol and defined dport.
Send and verify received packets on pg1 interface.

test_iacl_proto_tcp_sport()¶

IP6 TCP source port iACL test

Test scenario for basic protocol ACL with TCP and sport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with TCP IP protocol and defined sport.
Send and verify received packets on pg1 interface.

test_iacl_proto_tcp_sport_dport()¶

IP6 TCP source and destination ports iACL test

Test scenario for basic protocol ACL with TCP and sport and dport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with TCP IP protocol and defined sport and dport.
Send and verify received packets on pg1 interface.

class test_classifier_ip6.TestClassifierIP6UDP(methodName='runTest')¶

Bases: test_classifier_ip6.TestClassifier

Classifier IP6 UDP proto Test Case

test_iacl_proto_udp()¶

IP6 UDP protocol iACL test

Test scenario for basic protocol ACL with UDP protocol

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with UDP IP protocol.
Send and verify received packets on pg1 interface.

test_iacl_proto_udp_dport()¶

IP6 UDP destination port iACL test

Test scenario for basic protocol ACL with UDP and dport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with UDP IP protocol and defined dport.
Send and verify received packets on pg1 interface.

test_iacl_proto_udp_sport()¶

IP6 UDP source port iACL test

Test scenario for basic protocol ACL with UDP and sport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with UDP IP protocol and defined sport.
Send and verify received packets on pg1 interface.

test_iacl_proto_udp_sport_dport()¶

IP6 UDP source and destination ports iACL test

Test scenario for basic protocol ACL with UDP and sport and dport

Create IPv6 stream for pg0 -> pg1 interface.
Create iACL with UDP IP protocol and defined sport and dport.
Send and verify received packets on pg1 interface.