gvisor/test
Zeling Feng aed7183976 Packetimpact test for IPv6 unknown options action
The Option Type identifiers are internally encoded such that their
highest-order two bits specify the action that must be taken if the
processing IPv6 node does not recognize the Option Type:

  00 - skip over this option and continue processing the header.
  01 - discard the packet.
  10 - discard the packet and, regardless of whether or not the
       packet's Destination Address was a multicast address, send an
       ICMP Parameter Problem, Code 2, message to the packet's
       Source Address, pointing to the unrecognized Option Type.
  11 - discard the packet and, only if the packet's Destination
       Address was not a multicast address, send an ICMP Parameter
       Problem, Code 2, message to the packet's Source Address,
       pointing to the unrecognized Option Type.

PiperOrigin-RevId: 318566613
2020-06-26 16:43:53 -07:00
..
cmd/test_app Simplify Docker test infrastructure. 2020-04-23 11:33:30 -07:00
e2e Add TempTmpMount test 2020-06-17 19:09:37 -07:00
image Move mount configutation to RunOpts 2020-06-17 18:43:26 -07:00
iptables Move mount configutation to RunOpts 2020-06-17 18:43:26 -07:00
packetdrill Standardize all Docker images. 2020-04-24 14:11:42 -07:00
packetimpact Packetimpact test for IPv6 unknown options action 2020-06-26 16:43:53 -07:00
perf Internal change. 2020-06-23 14:42:15 -07:00
root Set the HOME environment variable for sub-containers. 2020-06-11 19:31:24 -07:00
runner Use internal tmpfs in test runner, even when running with overlay. 2020-06-19 14:14:21 -07:00
runtimes Move mount configutation to RunOpts 2020-06-17 18:43:26 -07:00
syscalls Require CAP_SYS_ADMIN in the root user namespace for TTY theft 2020-06-26 16:24:39 -07:00
uds Standardize on tools directory. 2020-01-27 12:21:00 -08:00
util Fix vfs2 tmpfs link permission checks. 2020-06-18 22:02:07 -07:00
BUILD Standardize on tools directory. 2020-01-27 12:21:00 -08:00
README.md Fix typos in test/README.md. 2020-06-17 09:13:09 -07:00

README.md

Tests

The tests defined under this path are verifying functionality beyond what unit tests can cover, e.g. integration and end to end tests. Due to their nature, they may need extra setup in the test machine and extra configuration to run.

  • syscalls: system call tests use a local runner, and do not require additional configuration in the machine.
  • integration: defines integration tests that uses docker run to test functionality.
  • image: basic end to end test for popular images. These require the same setup as integration tests.
  • root: tests that require to be run as root. These require the same setup as integration tests.
  • util: utilities library to support the tests.

For the above noted cases, the relevant runtime must be installed via runsc install before running. Just note that they require specific configuration to work. This is handled automatically by the test scripts in the scripts directory and they can be used to run tests locally on your machine. They are also used to run these tests in kokoro.

Example:

To run image and integration tests, run:

./scripts/docker_tests.sh

To run root tests, run:

./scripts/root_tests.sh

There are a few other interesting variations for image and integration tests:

  • overlay: sets writable overlay inside the sentry
  • hostnet: configures host network pass-thru, instead of netstack
  • kvm: runsc the test using the KVM platform, instead of ptrace

The test will build runsc, configure it with your local docker, restart dockerd, and run tests. The location for runsc logs is printed to the output.