From 7f652770e364dff1d8e9eff779959c8f3127fa58 Mon Sep 17 00:00:00 2001 From: Joachim Wiberg Date: Thu, 19 Nov 2026 19:29:17 +0100 Subject: [PATCH] test: list what to install to run the test suite A new machine lacks more than the build dependencies. Without the uidmap package every test fails: unshare: failed to execute newuidmap: No such file or directory List the packages for Debian, Ubuntu, and Linux Mint, and what each is used for. The build instructions asked for libite and libuEv v2.2.0, configure wants v2.6.1 and v2.4.1. Signed-off-by: Joachim Wiberg --- doc/build.md | 4 ++-- test/README.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+), 2 deletions(-) diff --git a/doc/build.md b/doc/build.md index e789200d..13a4b6f7 100644 --- a/doc/build.md +++ b/doc/build.md @@ -37,8 +37,8 @@ too, since libpam loads its modules with `dlopen()`. The configure script checks for all dependencies, including the correct version of the above mentioned libraries. Currently required versions: -- libite v2.2.0, or later -- libuEv v2.2.0, or later +- libite v2.6.1, or later +- libuEv v2.4.1, or later - libConfuse v3.3, or later - libblkid, any version, when keventd is enabled - libcap, any version, unless `--disable-libcap` is given diff --git a/test/README.md b/test/README.md index 5c5f8fbe..017d8a44 100644 --- a/test/README.md +++ b/test/README.md @@ -11,6 +11,42 @@ directory it will be able to function properly without having any super user privileges in the host environment. +Requirements +------------ + +On Debian, Ubuntu, and Linux Mint, install the build dependencies and +the tools the tests use: + + sudo apt install build-essential autoconf automake libtool pkg-config \ + libconfuse-dev libblkid-dev libcap-dev libpam0g-dev \ + uidmap jq wget dbus shellcheck + + * `uidmap` has `newuidmap` and `newgidmap`, which `unshare` needs to + set up the namespace of each test. Without it every test fails with + `unshare: failed to execute newuidmap`. Your user also needs a range + in `/etc/subuid` and `/etc/subgid`, which `adduser` sets up + * `jq` is used by the tests that read `initctl -j` + * `wget` fetches the BusyBox binary for the test root, on the first run + * `dbus` has the `dbus-daemon` and `dbus-send` that the D-Bus broker + test stages in the test root, without them that test is skipped + * `shellcheck` is used by the `checkself.sh` test, which checks the + test scripts themselves + * `libcap-dev` and `libpam0g-dev` are optional for Finit. Without + the latter the PAM session test is skipped + +Finit also needs [libuEv][] v2.4.1 and [libite][] v2.6.1, or later. The +`libuev-dev` and `libite-dev` packages may be older, check with: + + apt-cache policy libuev-dev libite-dev + +In Ubuntu 24.04, `libuev-dev` is new enough but `libite-dev` is not, so +libite has to be built and installed from source, see the [build +instructions](../doc/build.md). + +[libuEv]: https://github.com/troglobit/libuev +[libite]: https://github.com/troglobit/libite + + Running tests -------------