summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2024-07-11 16:09:47 +0200
committerDaan De Meyer <daan.j.demeyer@gmail.com>2024-07-18 11:39:07 +0200
commitd279ec4a50d83ab44200ea410fa09d7ba2e5c824 (patch)
treee1b87b316d7fda520bc552657771bdbdc30b6182 /docs
parentmkosi: Skip sync script if NO_BUILD is enabled (diff)
downloadsystemd-d279ec4a50d83ab44200ea410fa09d7ba2e5c824.tar.xz
systemd-d279ec4a50d83ab44200ea410fa09d7ba2e5c824.zip
mkosi: Streamline running the integration tests without building systemd
Let's document in detail how to build the integration test image and run the integration tests without building systemd. To streamline the process, we stop automatically using binaries from build/ when invoking mkosi directly and don't automatically use a tools tree anymore if systemd on the host is too old. Instead, we document these options in HACKING.md and change the mkosi meson target to automatically use the current build directory as an extra binary search path for mkosi.
Diffstat (limited to 'docs')
-rw-r--r--docs/HACKING.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/HACKING.md b/docs/HACKING.md
index 670cbb9dea..2e964f4178 100644
--- a/docs/HACKING.md
+++ b/docs/HACKING.md
@@ -44,6 +44,24 @@ or:
$ mkosi qemu
```
+By default, the tools from your host system are used to build the image. To have
+`mkosi` use the systemd tools from the `build/` directory, add the following to
+`mkosi.local.conf`:
+
+```conf
+[Host]
+ExtraSearchPaths=build/
+```
+
+And if you want `mkosi` to build a tools image and use the tools from there
+instead of looking for tools on the host, add the following to
+`mkosi.local.conf`:
+
+```conf
+[Host]
+ToolsTree=default
+```
+
Every time you rerun the `mkosi` command a fresh image is built, incorporating
all current changes you made to the project tree. To avoid having to build a new
image all the time when iterating on a patch, add the following to