41 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			41 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
| <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>
 | 
