test/README.testsuite

   1 The extended testsuite only works with UID=0. It contains of several
   2 subdirectories named "test/TEST-??-*", which are run one by one.
   3
   4 To run the extended testsuite do the following:
   5
   6 $ ninja -C build  # Avoid building anything as root later
   7 $ sudo test/run-integration-tests.sh
   8 ninja: Entering directory `/home/zbyszek/src/systemd/build'
   9 ninja: no work to do.
  10 --x-- Running TEST-01-BASIC --x--
  11 + make -C TEST-01-BASIC BUILD_DIR=/home/zbyszek/src/systemd/build clean setup run
  12 make: Entering directory '/home/zbyszek/src/systemd/test/TEST-01-BASIC'
  13 TEST CLEANUP: Basic systemd setup
  14 TEST SETUP: Basic systemd setup
  15 ...
  16 TEST RUN: Basic systemd setup [OK]
  17 make: Leaving directory '/home/zbyszek/src/systemd/test/TEST-01-BASIC'
  18 --x-- Result of TEST-01-BASIC: 0 --x--
  19 --x-- Running TEST-02-CRYPTSETUP --x--
  20 + make -C TEST-02-CRYPTSETUP BUILD_DIR=/home/zbyszek/src/systemd/build clean setup run
  21
  22 If one of the tests fails, then $subdir/test.log contains the log file of
  23 the test.
  24
  25 To run just one of the cases:
  26
  27 $ sudo make -C test/TEST-01-BASIC clean setup run
  28
  29 Specifying the build directory
  30 ==============================
  31
  32 If the build directory is not detected automatically, it can be specified
  33 with BUILD_DIR=:
  34
  35 $ sudo BUILD_DIR=some-other-build/ test/run-integration-tests
  36
  37 or
  38
  39 $ sudo make -C test/TEST-01-BASIC BUILD_DIR=../../some-other-build/ ...
  40
  41 Note that in the second case, the path is relative to the test case directory.
  42 An absolute path may also be used in both cases.
  43
  44 Configuration variables
  45 =======================
  46
  47 TEST_NO_QEMU=1 can be used to disable qemu tests.
  48
  49 TEST_NO_NSPAWN=1 can be used to disable nspawn tests.
  50
  51 KERNEL_APPEND='...' can be used to add additional kernel parameters for the QEMU runs.
  52
  53 The kernel and initramfs can be specified with $KERNEL_BIN and $INITRD.
  54 (Fedora's or Debian's default kernel path and initramfs are used by default)
  55
  56 A script will try to find your QEMU binary. If you want to specify a different
  57 one with $QEMU_BIN.
  58
  59 Debugging the qemu image
  60 ========================
  61
  62 If you want to log in the testsuite virtual machine, you can specify additional
  63 kernel command line parameter with $KERNEL_APPEND and then log in as root.
  64
  65 $ sudo make -C test/TEST-01-BASIC KERNEL_APPEND="systemd.unit=multi-user.target" run
  66
  67 Root password is empty.