linux/tools/testing/selftests/net/forwarding
Ido Schimmel 9413248753 selftests: forwarding: Increase maximum deviation in multipath test
We sometimes observe failures in the test due to too large discrepancy
between the measured and expected ratios. For example:

TEST: ECMP                                                          [FAIL]
        Too large discrepancy between expected and measured ratios
        INFO: Expected ratio 1.00 Measured ratio 1.11

Fix this by allowing an up to 15% deviation between both ratios.

Another possibility is to increase the number of generated flows, but
this will prolong the execution time of the test, which is already quite
high.

Signed-off-by: Ido Schimmel <idosch@mellanox.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
2018-05-03 12:54:31 -04:00
..
.gitignore
bridge_vlan_aware.sh selftests: forwarding: Only check tc version for tc tests 2018-03-01 21:19:02 -05:00
bridge_vlan_unaware.sh selftests: forwarding: Add a test for VLAN-unaware bridge 2018-03-11 22:44:23 -04:00
config
forwarding.config.sample selftests: forwarding: Allow creation of interfaces without a config file 2018-03-11 22:44:24 -04:00
lib.sh selftests: forwarding: Add libs for gretap mirror testing 2018-04-27 14:57:49 -04:00
mirror_gre_bound.sh selftests: forwarding: Test mirror to gretap w/ bound dev 2018-04-27 14:57:50 -04:00
mirror_gre_changes.sh selftests: forwarding: Test changes in mirror-to-gretap 2018-04-27 14:57:50 -04:00
mirror_gre_flower.sh selftests: forwarding: Test flower mirror to gretap 2018-04-27 14:57:50 -04:00
mirror_gre_lib.sh selftests: forwarding: Add libs for gretap mirror testing 2018-04-27 14:57:49 -04:00
mirror_gre_neigh.sh selftests: forwarding: Test neighbor updates when mirroring to gretap 2018-04-27 14:57:50 -04:00
mirror_gre_nh.sh selftests: forwarding: Test gretap mirror with next-hop remote 2018-04-27 14:57:49 -04:00
mirror_gre_topo_lib.sh selftests: forwarding: Add libs for gretap mirror testing 2018-04-27 14:57:49 -04:00
mirror_gre.sh selftests: forwarding: Add test for mirror to gretap 2018-04-27 14:57:49 -04:00
mirror_lib.sh selftests: forwarding: Add libs for gretap mirror testing 2018-04-27 14:57:49 -04:00
README
router_multipath.sh selftests: forwarding: Increase maximum deviation in multipath test 2018-05-03 12:54:31 -04:00
router.sh selftests: forwarding: Add a test for basic IPv4 and IPv6 routing 2018-02-28 12:25:47 -05:00
tc_actions.sh selftests: forwarding: fix flags passed to first drop rule in gact_drop_and_ok_test 2018-03-07 15:41:20 -05:00
tc_chains.sh selftests: forwarding: Only check tc version for tc tests 2018-03-01 21:19:02 -05:00
tc_common.sh selftests: forwarding: Only check tc version for tc tests 2018-03-01 21:19:02 -05:00
tc_flower.sh selftest: tc_flower: add testcase for 'ip_flags' 2018-04-17 13:41:54 -04:00
tc_shblocks.sh selftests: forwarding: Only check tc version for tc tests 2018-03-01 21:19:02 -05:00

Motivation
==========

One of the nice things about network namespaces is that they allow one
to easily create and test complex environments.

Unfortunately, these namespaces can not be used with actual switching
ASICs, as their ports can not be migrated to other network namespaces
(NETIF_F_NETNS_LOCAL) and most of them probably do not support the
L1-separation provided by namespaces.

However, a similar kind of flexibility can be achieved by using VRFs and
by looping the switch ports together. For example:

                             br0
                              +
               vrf-h1         |           vrf-h2
                 +        +---+----+        +
                 |        |        |        |
    192.0.2.1/24 +        +        +        + 192.0.2.2/24
               swp1     swp2     swp3     swp4
                 +        +        +        +
                 |        |        |        |
                 +--------+        +--------+

The VRFs act as lightweight namespaces representing hosts connected to
the switch.

This approach for testing switch ASICs has several advantages over the
traditional method that requires multiple physical machines, to name a
few:

1. Only the device under test (DUT) is being tested without noise from
other system.

2. Ability to easily provision complex topologies. Testing bridging
between 4-ports LAGs or 8-way ECMP requires many physical links that are
not always available. With the VRF-based approach one merely needs to
loopback more ports.

These tests are written with switch ASICs in mind, but they can be run
on any Linux box using veth pairs to emulate physical loopbacks.

Guidelines for Writing Tests
============================

o Where possible, reuse an existing topology for different tests instead
  of recreating the same topology.
o Where possible, IPv6 and IPv4 addresses shall conform to RFC 3849 and
  RFC 5737, respectively.
o Where possible, tests shall be written so that they can be reused by
  multiple topologies and added to lib.sh.
o Checks shall be added to lib.sh for any external dependencies.
o Code shall be checked using ShellCheck [1] prior to submission.

1. https://www.shellcheck.net/