Kernel/iwd
3
0
Fork 0
mirror of https://git.kernel.org/pub/scm/network/wireless/iwd.git synced 2025-01-03 02:02:33 +01:00
Code Releases Activity

doc: add some documentation about --shell

Browse Source
This commit is contained in:
James Prestwood 2019-08-28 12:33:34 -07:00 committed by Denis Kenzior
parent 7acb910a26
commit 342aeeb62b
1 changed files with 28 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/test-runner.txt
View File

@ -425,3 +425,31 @@ class TestFailingCase(unittest.TestCase):
if __name__ == '__main__':
unittest.main()
#~~~~~~~~~~~~~~~~~~ end of alwaysFailingTest.py ~~~~~~~~~~~~~~~~~~~~~~~~~
Using the 'shell' feature
---------------------------
The --shell,-s flag allows you to boot into a shell inside the test-runner VM.
If this flag is used the python test will not actually run, only the environment
will be setup. Tis is useful for diagnosing issues with a particular test
quickly without having to modify the python test and restart the VM. The shell
flag is meant to be used in conjunction with --autotest,-A. If no specific test
is specified test-runner will default to the 'shell' test, which is just an
empty test with one adapter.
Using the shell with real hardware (--hw flag) is even more powerful. If your
system is setup for USB/PCI passthrough you can expose physical network cards
in the VM and use them in the shell sandbox. This allows you to try out
different kernels in the VM very quickly (no reboots/swapping out kernels on
the host system).
Here are some examples of --shell usage:
Setup environment for 'testWPA' and boot into shell:
./test-runner -k <kernel> -A testWPA --shell
Boot directly into 'shell' test (sandbox):
./test-runner -k <kernel> --shell
Use hardware passthrough:
./test-runner -k <kernel> --hw <hw.conf> --shell