diff --git a/nixos/doc/manual/development/running-nixos-tests.xml b/nixos/doc/manual/development/running-nixos-tests.xml index d9be761eb01d..156dcd205a55 100644 --- a/nixos/doc/manual/development/running-nixos-tests.xml +++ b/nixos/doc/manual/development/running-nixos-tests.xml @@ -39,24 +39,13 @@ $ firefox result/log.html -It is also possible to run the test environment interactively, -allowing you to experiment with the VMs. For example: +Running Tests interactively - -$ nix-build login.nix -A driver -$ ./result/bin/nixos-run-vms - - -The script nixos-run-vms starts the virtual -machines defined by test. The root file system of the VMs is created -on the fly and kept across VM restarts in -./hostname.qcow2. - -Finally, the test itself can be run interactively. This is +The test itself can be run interactively. This is particularly useful when developing or debugging a test: -$ nix-build tests/ -A nfs.driver +$ nix-build nixos/tests/login.nix -A driver $ ./result/bin/nixos-test-driver starting VDE switch for network 1 > @@ -66,6 +55,7 @@ You can then take any Perl statement, e.g. > startAll +> testScript > $machine->succeed("touch /tmp/foo") @@ -74,4 +64,16 @@ script and drops you back into the test driver command line upon its completion. This allows you to inspect the state of the VMs after the test (e.g. to debug the test script). - \ No newline at end of file +To just start and experiment with the VMs, run: + + +$ nix-build nixos/tests/login.nix -A driver +$ ./result/bin/nixos-run-vms + + +The script nixos-run-vms starts the virtual +machines defined by test. The root file system of the VMs is created +on the fly and kept across VM restarts in +./hostname.qcow2. + +