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 -------------