gvisor/test/iptables
Nayana Bidari 92b9069b67 Support owner matching for iptables.
This feature will match UID and GID of the packet creator, for locally
generated packets. This match is only valid in the OUTPUT and POSTROUTING
chains. Forwarded packets do not have any socket associated with them.
Packets from kernel threads do have a socket, but usually no owner.
2020-03-26 12:21:24 -07:00
..
runner Standardize on tools directory. 2020-01-27 12:21:00 -08:00
BUILD Standardize on tools directory. 2020-01-27 12:21:00 -08:00
README.md iptables: add instructions for runsc building. 2020-02-10 11:09:19 -08:00
filter_input.go Check error in DropTCP*Port tests and fix comment. 2020-03-26 10:47:51 -07:00
filter_output.go Support owner matching for iptables. 2020-03-26 12:21:24 -07:00
iptables.go Add iptables testing framework. 2019-12-12 14:42:11 -08:00
iptables_test.go Support owner matching for iptables. 2020-03-26 12:21:24 -07:00
iptables_util.go iptables: deflake DropTCP*Port tests 2020-03-18 18:16:33 -07:00
nat.go Merge pull request #1943 from kevinGC:ipt-filter-ip 2020-03-16 11:13:14 -07:00

README.md

iptables Tests

iptables tests are run via scripts/iptables_test.sh.

iptables requires raw socket support, so you must add the --net-raw=true flag to /etc/docker/daemon.json in order to use it.

Test Structure

Each test implements TestCase, providing (1) a function to run inside the container and (2) a function to run locally. Those processes are given each others' IP addresses. The test succeeds when both functions succeed.

The function inside the container (ContainerAction) typically sets some iptables rules and then tries to send or receive packets. The local function (LocalAction) will typically just send or receive packets.

Adding Tests

  1. Add your test to the iptables package.

  2. Register the test in an init function via RegisterTestCase (see filter_input.go as an example).

  3. Add it to iptables_test.go (see the other tests in that file).

Your test is now runnable with bazel!

Run individual tests

Build and install runsc. Re-run this when you modify gVisor:

$ bazel build //runsc && sudo cp bazel-bin/runsc/linux_amd64_pure_stripped/runsc $(which runsc)

Build the testing Docker container. Re-run this when you modify the test code in this directory:

$ bazel run //test/iptables/runner:runner-image -- --norun

Run an individual test via:

$ bazel test //test/iptables:iptables_test --test_filter=<TESTNAME>

To run an individual test with runc:

$ bazel test //test/iptables:iptables_test --test_filter=<TESTNAME> --test_arg=--runtime=runc