linux/tools/testing/selftests/net/forwarding
Petr Machata 68d9cea594 selftests: forwarding: lib: Parameterize NUM_NETIFS in two functions
setup_wait() and tc_offload_check() both assume that all NUM_NETIFS
interfaces are relevant for a given test. However, the scale test script
acts as an umbrella for a number of sub-tests, some of which may not
require all the interfaces.

Thus it's suboptimal for tc_offload_check() to query all the interfaces.
In case of setup_wait() it's incorrect, because the sub-test in question
of course doesn't configure any interfaces beyond what it needs, and
setup_wait() then ends up waiting indefinitely for the extraneous
interfaces to come up.

For that reason, give setup_wait() and tc_offload_check() an optional
parameter with a number of interfaces to probe. Fall back to global
NUM_NETIFS if the parameter is not given.

Signed-off-by: Petr Machata <petrm@mellanox.com>
Reviewed-by: Yuval Mintz <yuvalm@mellanox.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
2018-06-30 22:06:15 +09:00
..
.gitignore
bridge_vlan_aware.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
bridge_vlan_unaware.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
config
forwarding.config.sample selftests: forwarding: Allow creation of interfaces without a config file 2018-03-11 22:44:24 -04:00
gre_multipath.sh selftests: forwarding: Test multipath tunneling 2018-06-27 10:42:13 +09:00
lib.sh selftests: forwarding: lib: Parameterize NUM_NETIFS in two functions 2018-06-30 22:06:15 +09:00
mirror_gre_bound.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
mirror_gre_bridge_1d_vlan.sh selftests: forwarding: Tweak tc filters for mirror-to-gretap tests 2018-06-30 20:34:09 +09:00
mirror_gre_changes.sh selftests: forwarding: mirror_gre_changes: Fix waiting for neighbor 2018-06-30 20:34:09 +09:00
mirror_gre_flower.sh selftests: forwarding: Test removal of mirroring 2018-05-24 22:14:36 -04:00
mirror_gre_lib.sh selftests: forwarding: Tweak tc filters for mirror-to-gretap tests 2018-06-30 20:34:09 +09:00
mirror_gre_neigh.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
mirror_gre_nh.sh selftests: forwarding: mirror_gre_nh: Unset RP filter 2018-05-03 13:37:02 -04:00
mirror_gre_topo_lib.sh selftests: forwarding: Split mirror_gre_topo_lib.sh 2018-05-24 22:26:19 -04:00
mirror_gre_vlan_bridge_1q.sh selftests: forwarding: Tweak tc filters for mirror-to-gretap tests 2018-06-30 20:34:09 +09:00
mirror_gre_vlan.sh selftests: forwarding: Test mirror-to-gre w/ UL VLAN 2018-05-24 22:26:20 -04:00
mirror_gre.sh selftests: forwarding: Add $h3's clsact to mirror_topo_lib.sh 2018-05-24 22:26:19 -04:00
mirror_lib.sh selftests: forwarding: mirror_lib: skip_hw the VLAN capture 2018-06-01 14:11:02 -04:00
mirror_topo_lib.sh selftests: forwarding: Add $h3's clsact to mirror_topo_lib.sh 2018-05-24 22:26:19 -04:00
mirror_vlan.sh selftests: forwarding: mirror_vlan: Change test description 2018-06-04 10:08:45 -04:00
README selftests: forwarding: README: Require diagrams 2018-06-27 10:42:13 +09:00
router_bridge_vlan.sh selftests: forwarding: Test routed bridge interface 2018-06-26 18:05:22 +09:00
router_bridge.sh selftests: forwarding: Test routed bridge interface 2018-06-26 18:05:22 +09:00
router_multipath.sh selftests: forwarding: Move multipath_eval() to lib.sh 2018-06-27 10:42:12 +09:00
router.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
tc_actions.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
tc_chains.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
tc_common.sh selftests: forwarding: Only check tc version for tc tests 2018-03-01 21:19:02 -05:00
tc_flower.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04:00
tc_shblocks.sh selftests: forwarding: Allow running specific tests 2018-05-03 12:54:31 -04: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 Tests that use anything but the most trivial topologies should include
  an ASCII art showing the 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/