diff options
author | Domen Kožar <domen@dev.si> | 2015-04-21 02:27:40 -0400 |
---|---|---|
committer | Domen Kožar <domen@dev.si> | 2015-04-21 02:28:59 -0400 |
commit | f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba (patch) | |
tree | 3b3e49e8e38e41a7b71024219bdafa06a02a0bd9 /nixos/doc/manual/development/running-nixos-tests-interactively.xml | |
parent | dbaeb7c42867bc4775ea81ec9ff997bbea987843 (diff) | |
download | nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar.gz nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar.bz2 nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar.lz nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar.xz nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.tar.zst nixlib-f39b1ead2a5fba63be7cd77dd70c00c09d7f6aba.zip |
manual: re-add running nixos tests sections
Diffstat (limited to 'nixos/doc/manual/development/running-nixos-tests-interactively.xml')
-rw-r--r-- | nixos/doc/manual/development/running-nixos-tests-interactively.xml | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/nixos/doc/manual/development/running-nixos-tests-interactively.xml b/nixos/doc/manual/development/running-nixos-tests-interactively.xml new file mode 100644 index 000000000000..e47490777815 --- /dev/null +++ b/nixos/doc/manual/development/running-nixos-tests-interactively.xml @@ -0,0 +1,43 @@ +<section xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + version="5.0" + xml:id="sec-running-nixos-tests"> +<title>Running Tests interactively</title> + +<para>The test itself can be run interactively. This is +particularly useful when developing or debugging a test: + +<screen> +$ nix-build nixos/tests/login.nix -A driver +$ ./result/bin/nixos-test-driver +starting VDE switch for network 1 +> +</screen> + +You can then take any Perl statement, e.g. + +<screen> +> startAll +> testScript +> $machine->succeed("touch /tmp/foo") +</screen> + +The function <command>testScript</command> executes the entire test +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).</para> + +<para>To just start and experiment with the VMs, run: + +<screen> +$ nix-build nixos/tests/login.nix -A driver +$ ./result/bin/nixos-run-vms +</screen> + +The script <command>nixos-run-vms</command> 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 +<filename>./</filename><varname>hostname</varname><filename>.qcow2</filename>.</para> + +</section> |