• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..--

READMED22-Nov-20232.6 KiB7851

all_tests.shD22-Nov-20231.2 KiB4923

anycast_test.pyD22-Nov-20233 KiB11468

csocket.pyD22-Nov-20235.5 KiB183119

cstruct.pyD22-Nov-20236.1 KiB195134

cstruct_test.pyD22-Nov-20231.8 KiB6133

forwarding_test.pyD22-Nov-20233.7 KiB11066

iproute.pyD22-Nov-202317.8 KiB542400

multinetwork_base.pyD22-Nov-202321.6 KiB643442

multinetwork_test.pyD22-Nov-202334.3 KiB927637

neighbour_test.pyD22-Nov-202310.3 KiB298201

net_test.pyD22-Nov-202310.9 KiB395259

net_test.shD22-Nov-2023524 219

netlink.pyD22-Nov-20237.8 KiB256164

packets.pyD22-Nov-20236.9 KiB198150

ping6_test.pyD22-Nov-202325.7 KiB710498

ping6_test.shD22-Nov-2023266 175

run_net_test.shD22-Nov-20234.2 KiB12674

sock_diag.pyD22-Nov-202311 KiB343249

sock_diag_test.pyD22-Nov-202321.1 KiB549414

srcaddr_selection_test.pyD22-Nov-202313.9 KiB346202

tcp_nuke_addr_test.pyD22-Nov-20237.6 KiB251184

tcp_test.pyD22-Nov-20234 KiB12581

README

1                                net_test v0.1
2                                =============
3
4A simple framework for blackbox testing of kernel networking code.
5
6
7Why use it?
8===========
9
10- Fast test / boot cycle.
11- Access to host filesystem and networking via L2 bridging.
12- Full Linux userland including Python, etc.
13- Kernel bugs don't crash the system.
14
15
16How to use it
17=============
18
19cd <kerneldir>
20path/to/net_test/run_net_test.sh <test>
21
22where <test> is the name of a test binary in the net_test directory. This can
23be an x86 binary, a shell script, a Python script. etc.
24
25
26How it works
27============
28
29net_test compiles the kernel to a user-mode linux binary, which runs as a
30process on the host machine. It runs the binary to start a Linux "virtual
31machine" whose root filesystem is the supplied Debian disk image. The machine
32boots, mounts the root filesystem read-only, runs the specified test from init, and then drops to a shell.
33
34
35Access to host filesystem
36=========================
37
38The VM mounts the host filesystem at /host, so the test can be modified and
39re-run without rebooting the VM.
40
41
42Access to host networking
43=========================
44
45Access to host networking is provided by tap interfaces. On the host, the
46interfaces are named <user>TAP0, <user>TAP1, etc., where <user> is the first
4710 characters of the username running net_test. (10 characters because
48IFNAMSIZ = 16). On the guest, they are named eth0, eth1, etc.
49
50net_test does not do any networking setup beyond creating the tap interfaces.
51IP connectivity can be provided on the host side by setting up a DHCP server
52and NAT, sending IPv6 router advertisements, etc. By default, the VM has IPv6
53privacy addresses disabled, so its IPv6 addresses can be predicted using a tool
54such as ipv6calc.
55
56The provided filesystem contains a DHCPv4 client and simple networking
57utilities such as ping[6], traceroute[6], and wget.
58
59The number of tap interfaces is currently hardcoded to two. To change this
60number, modify run_net_test.sh.
61
62
63Logging into the VM, installing packages, etc.
64==============================================
65
66net_test mounts the root filesystem read-only, and runs the test from init, but
67since the filesystem contains a full Linux userland, it's possible to boot into
68userland and modify the filesystem, for example to install packages using
69apt-get install. Log in as root with no password. By default, the filesystem is
70configured to perform DHCPv4 on eth0 and listen to RAs.
71
72
73Bugs
74====
75
76Since the test mounts the filesystem read-only, tests cannot modify
77/etc/resolv.conf and the system resolver is hardcoded to 8.8.8.8.
78