README 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. This is regression testing for nix.
  2. Each directory named with a number represents a single test.
  3. (e.g., 1/ 2/ ...)
  4. A test directory may be also named k1, k2, k....
  5. All k tests run affter all std. tests. They are meant to install ad-hoc
  6. kernels for testing.
  7. The script actually running the tests is runtests, which should be run from
  8. cpustart during the machine boot process.
  9. That is, include
  10. test -x /cfg/$sysname/runtests && /cfg/$sysname/runtests
  11. in your cpustart file.
  12. It is not meant to start the testing sequence by hand.
  13. To (re)run all the tests, you should run ./Tests instead.
  14. See 1/ for a template. Copy it to your own and tweak it at will.
  15. To start testing, run the script ./Tests in clu, which would
  16. change the boot sequence such that the machine starts to run tests
  17. (perhaps installing different kernels and rebooting) until all
  18. tests have been run or one has failed.
  19. Each directory must contain:
  20. - kern: a script used to compile and install a kernel used for testing
  21. if no such file is found, no new kernel is installed. the current one
  22. is used. Otherwise, the indicated kernel is installed and the machine
  23. reboots using this kernel.
  24. - runtest: a script used to run a test. This is mandatory.
  25. - whichever other files must be available for the tests to run.
  26. Tests generate within each test directory:
  27. - koutput: a file keeping the output for a kern that did run
  28. - output: a file keeping the output for a test that did run
  29. - FAIL: an empty file, reporting that a test did fail.
  30. BEWARE that if you install a kernel for a test then that kernel is used
  31. for all following tests.
  32. As a convention, tests installing a kernel should be named k0, k1, ...
  33. test 1 installs the std kernel, so that all tests use the regular kernel.