1
0
mirror of https://github.com/systemd/systemd.git synced 2024-10-31 16:21:26 +03:00
systemd/test
Frantisek Sumsal 2de908aead test: count call instructions as well
Binaries on the latest Arch Linux use `call` instructions instead of
`callq`, which breaks the ASan detection and eventually the image
building process (due to insufficient space).
2021-02-10 20:20:31 +03:00
..
dmidecode-dumps test: add one more dmidecode dump 2020-12-17 09:21:31 +01:00
fuzz fuzz-systemctl-parse-argv: a new fuzzer 2021-02-09 14:11:42 +01:00
hwdb.d
journal-data
mocks
TEST-01-BASIC test/TEST-01-BASIC: also install testsuite.target 2021-01-26 17:38:23 -05:00
TEST-02-UNITTESTS test: switch TEST-02-CRYPTSETUP and TEST-24-UNITTESTS 2020-09-24 17:02:20 +02:00
TEST-03-JOBS test: unify quotation around image names 2020-05-17 10:43:08 +02:00
TEST-04-JOURNAL
TEST-05-RLIMITS
TEST-06-SELINUX test: add a custom SELinux file context 2021-02-05 17:08:58 +01:00
TEST-07-ISSUE-1981
TEST-08-ISSUE-2730 tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-09-ISSUE-2691
TEST-10-ISSUE-2467
TEST-11-ISSUE-3166
TEST-12-ISSUE-3171
TEST-13-NSPAWN-SMOKE tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-14-MACHINE-ID tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-15-DROPIN
TEST-16-EXTEND-TIMEOUT
TEST-17-UDEV-WANTS
TEST-18-FAILUREACTION
TEST-19-DELEGATE
TEST-20-MAINPIDGAMES
TEST-22-TMPFILES
TEST-23-TYPE-EXEC
TEST-24-CRYPTSETUP tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-25-IMPORT test: convert ubuntu-ci to use deny-list 2020-08-01 15:36:35 +02:00
TEST-26-SETENV
TEST-27-STDOUTFILE
TEST-28-PERCENTJ-WANTEDBY
TEST-29-UDEV-ID_RENAMING tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-30-ONCLOCKCHANGE test: convert ubuntu-ci to use deny-list 2020-08-01 15:36:35 +02:00
TEST-31-DEVICE-ENUMERATION
TEST-32-OOMPOLICY
TEST-33-CLEAN-UNIT
TEST-34-DYNAMICUSERMIGRATE
TEST-36-NUMAPOLICY test: s/MUMA/NUMA/ 2020-12-16 16:38:44 +01:00
TEST-37-RUNTIMEDIRECTORYPRESERVE
TEST-38-FREEZER test: add test for cgroup v2 freezer support 2020-04-30 19:02:55 +02:00
TEST-39-EXECRELOAD
TEST-40-EXEC-COMMAND-EX test: convert ubuntu-ci to use deny-list 2020-08-01 15:36:35 +02:00
TEST-41-ONESHOT-RESTART
TEST-42-EXECSTOPPOST
TEST-43-PRIVATEUSER-UNPRIV
TEST-44-LOG-NAMESPACE
TEST-46-HOMED
TEST-47-ISSUE-14566
TEST-48-START-STOP-NO-RELOAD core: store timestamps of unit load attempts 2020-06-30 16:50:00 +02:00
TEST-49-UDEV-EVENT-TIMEOUT test: add integration test for udev event timeout 2020-06-05 11:09:21 +02:00
TEST-50-DISSECT tests: build the image once and then copy/extend it 2021-01-24 13:07:39 +00:00
TEST-51-ISSUE-16115 core: don't consider SERVICE_SKIP_CONDITION for abnormal or failure restarts 2020-06-10 17:12:55 +02:00
TEST-52-HONORFIRSTSHUTDOWN test: find $BUILD_DIR in test-functions, remove from other scripts 2021-01-26 17:09:48 -05:00
TEST-53-ISSUE-16347 timer: Adjust calendar timers based on monotonic timer instead of realtime 2020-07-15 09:23:09 +02:00
TEST-54-CREDS test: add test suite for new credentials logic 2020-08-25 19:46:36 +02:00
TEST-55-UDEV-TAGS test: add test for new "sticky" tags logic 2020-09-01 17:40:12 +02:00
TEST-56-OOMD test: add basic memory pressure extended test for oomd 2020-10-22 17:04:22 -07:00
TEST-57-RUNTIME-BIND-PATHS core: add DBUS method to bind mount new nodes without service restart 2021-01-18 17:24:05 +00:00
test-execute New directives NoExecPaths= ExecPaths= 2021-01-29 12:40:52 +00:00
test-network test-network: support protocol and linkdown flag for ff00::/8 route 2021-02-09 12:25:27 +01:00
test-network-generator-conversion
test-path license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
test-path-util core/execute: fall back to execve() for scripts 2020-11-06 15:14:13 +01:00
test-resolve
test-sysusers sysusers: look at login.defs when setting the default range to allocate users 2020-10-01 19:53:45 +02:00
test-umount
testsuite-04.units tests: replace the few remaining Type=simple with Type=exec 2020-10-22 11:05:17 +02:00
testsuite-06.units test: clean the module build dir before compiling it 2021-02-05 16:57:30 +01:00
testsuite-08.units
testsuite-10.units
testsuite-11.units tests: replace the few remaining Type=simple with Type=exec 2020-10-22 11:05:17 +02:00
testsuite-16.units
testsuite-28.units
testsuite-30.units/systemd-timedated.service.d
testsuite-52.units test: remove executable bit from testsuite-52.service 2020-08-27 12:13:16 +02:00
units oom: rework *MemoryPressureLimit= properties to have 1/10000 precision 2021-02-02 17:52:48 -08:00
.gitignore
create-busybox-container machine: enter target PID namespace when adding a live mount 2021-01-18 17:24:05 +00:00
create-sys-script.py license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
hwdb-test.sh license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
meson.build meson.build: drop unused variable 2021-01-19 07:04:19 +09:00
mkosi.build.networkd-test
mkosi.default.networkd-test mkosi: make sure our mkosi files work with f33 2020-11-25 13:18:36 +01:00
mkosi.nspawn.networkd-test
networkd-test.py networkd-test: add final newlines in generated files, use .format() 2020-12-10 14:31:39 +09:00
README.testsuite test: allow run-integration-tests.sh to run without build 2021-01-26 17:09:48 -05:00
rule-syntax-check.py license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
run-integration-tests.sh test/run-integration-tests.sh: adjust arg processing 2021-01-26 17:36:53 -05:00
run-unit-tests.py
sd-script.py tree-wide: fix typo 2020-12-14 12:05:55 +00:00
splash.bmp
sys-script.py Merge pull request #17431 from msekletar/udev-link-update-race 2020-11-10 09:41:57 +01:00
sysv-generator-test.py license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
test-efi-create-disk.sh
test-exec-deserialization.py license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00
test-functions test: count call instructions as well 2021-02-10 20:20:31 +03:00
test-network-generator-conversion.sh tests: when creating temp dirs, include test name in path 2020-10-01 19:53:45 +02:00
test-systemd-tmpfiles.py test: move test-systemd-tmpfiles.py from src/test to test 2021-01-19 07:04:19 +09:00
test-sysusers.sh.in sysusers: look at login.defs when setting the default range to allocate users 2020-10-01 19:53:45 +02:00
testdata
udev-dmi-memory-id-test.sh meson: make each dmidecode a separate test 2020-12-17 09:21:29 +01:00
udev-test.pl test/udev-test: gracefully exit when imports fail 2020-11-18 03:50:17 +09:00

The extended testsuite only works with UID=0. It contains of several
subdirectories named "test/TEST-??-*", which are run one by one.

To run the extended testsuite do the following:

$ ninja -C build  # Avoid building anything as root later
$ sudo test/run-integration-tests.sh
ninja: Entering directory `/home/zbyszek/src/systemd/build'
ninja: no work to do.
--x-- Running TEST-01-BASIC --x--
+ make -C TEST-01-BASIC clean setup run
make: Entering directory '/home/zbyszek/src/systemd/test/TEST-01-BASIC'
TEST-01-BASIC CLEANUP: Basic systemd setup
TEST-01-BASIC SETUP: Basic systemd setup
...
TEST-01-BASIC RUN: Basic systemd setup [OK]
make: Leaving directory '/home/zbyszek/src/systemd/test/TEST-01-BASIC'
--x-- Result of TEST-01-BASIC: 0 --x--
--x-- Running TEST-02-CRYPTSETUP --x--
+ make -C TEST-02-CRYPTSETUP clean setup run

If one of the tests fails, then $subdir/test.log contains the log file of
the test.

To run just one of the cases:

$ sudo make -C test/TEST-01-BASIC clean setup run

Specifying the build directory
==============================

If the build directory is not detected automatically, it can be specified
with BUILD_DIR=:

$ sudo BUILD_DIR=some-other-build/ test/run-integration-tests

or

$ sudo make -C test/TEST-01-BASIC BUILD_DIR=../../some-other-build/ ...

Note that in the second case, the path is relative to the test case directory.
An absolute path may also be used in both cases.

Testing installed binaries instead of built
===========================================

To run the extended testsuite using the systemd installed on the system instead
of the systemd from a build, use the NO_BUILD=1:

$ sudo NO_BUILD=1 test/run-integration-tests

Configuration variables
=======================

TEST_NO_QEMU=1
    Don't run tests under QEMU

TEST_QEMU_ONLY=1
    Run only tests that require QEMU

TEST_NO_NSPAWN=1
    Don't run tests under systemd-nspawn

TEST_PREFER_NSPAWN=1
    Run all tests that do not require qemu under systemd-nspawn

TEST_NO_KVM=1
    Disable QEMU KVM auto-detection (may be necessary when you're trying to run the
    *vanilla* QEMU and have both qemu and qemu-kvm installed)

TEST_NESTED_KVM=1
    Allow tests to run with nested KVM. By default, the testsuite disables
    nested KVM if the host machine already runs under KVM. Setting this
    variable disables such checks

QEMU_MEM=512M
    Configure amount of memory for QEMU VMs (defaults to 512M)

QEMU_SMP=1
    Configure number of CPUs for QEMU VMs (defaults to 1)

KERNEL_APPEND='...'
    Append additional parameters to the kernel command line

NSPAWN_ARGUMENTS='...'
    Specify additional arguments for systemd-nspawn

QEMU_TIMEOUT=infinity
    Set a timeout for tests under QEMU (defaults to infinity)

NSPAWN_TIMEOUT=infinity
    Set a timeout for tests under systemd-nspawn (defaults to infinity)

INTERACTIVE_DEBUG=1
    Configure the machine to be more *user-friendly* for interactive debuggung
    (e.g. by setting a usable default terminal, suppressing the shutdown after
    the test, etc.)

The kernel and initramfs can be specified with $KERNEL_BIN and $INITRD.
(Fedora's or Debian's default kernel path and initramfs are used by default)

A script will try to find your QEMU binary. If you want to specify a different
one with $QEMU_BIN.

Debugging the qemu image
========================

If you want to log in the testsuite virtual machine, you can specify additional
kernel command line parameter with $KERNEL_APPEND and then log in as root.

$ sudo make -C test/TEST-01-BASIC KERNEL_APPEND="systemd.unit=multi-user.target" run

Root password is empty.

Ubuntu CI
=========

New PR submitted to the project are run through regression tests, and one set
of those is the 'autopkgtest' runs for several different architectures, called
'Ubuntu CI'.  Part of that testing is to run all these tests.  Sometimes these
tests are temporarily deny-listed from running in the 'autopkgtest' tests while
debugging a flaky test; that is done by creating a file in the test directory
named 'deny-list-ubuntu-ci', for example to prevent the TEST-01-BASIC test from
running in the 'autopkgtest' runs, create the file
'TEST-01-BASIC/deny-list-ubuntu-ci'.

The tests may be disabled only for specific archs, by creating a deny-list file
with the arch name at the end, e.g.
'TEST-01-BASIC/deny-list-ubuntu-ci-arm64' to disable the TEST-01-BASIC test
only on test runs for the 'arm64' architecture.

Note the arch naming is not from 'uname -m', it is Debian arch names:
https://wiki.debian.org/ArchitectureSpecificsMemo

For PRs that fix a currently deny-listed test, the PR should include removal
of the deny-list file.

In case a test fails, the full set of artifacts, including the journal of the
failed run, can be downloaded from the artifacts.tar.gz archive which will be
reachable in the same URL parent directory as the logs.gz that gets linked on
the Github CI status.

To add new dependencies or new binaries to the packages used during the tests,
a merge request can be sent to: https://salsa.debian.org/systemd-team/systemd
targeting the 'upstream-ci' branch.

The cloud-side infrastructure, that is hooked into the Github interface, is
located at:

https://git.launchpad.net/autopkgtest-cloud/