]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
docs: Add note on packages produced by mkosi builds
authorDaan De Meyer <daan.j.demeyer@gmail.com>
Wed, 17 Apr 2024 21:38:14 +0000 (23:38 +0200)
committerDaan De Meyer <daan.j.demeyer@gmail.com>
Thu, 18 Apr 2024 07:58:50 +0000 (09:58 +0200)
docs/HACKING.md

index 82b64349847133e3bf6e9628ddc4a6c56645c881..f95d191b80dd719214403fefd2ba561f1cfecdb1 100644 (file)
@@ -88,6 +88,26 @@ and optionally restart the daemon(s) you're working on using
 `systemctl restart <units>` or `systemctl daemon-reexec` if you're working on pid1
 or `systemctl soft-reboot` to restart everything.
 
+Aside from the image, the `mkosi.output` directory will also be populated with a
+set of distribution packages. Assuming you're running the same distribution and
+release as the mkosi image, you can install these rpms on your host or test
+system as well for any testing or debugging that cannot easily be performed in a
+VM or container.
+
+By default, no debuginfo packages are produced. To produce debuginfo packages,
+run mkosi with the `WITH_DEBUG` environment variable set to `1`:
+
+```sh
+$ mkosi -E WITH_DEBUG=1 -f
+```
+
+or configure it in `mkosi.local.conf`:
+
+```conf
+[Content]
+Environment=WITH_DEBUG=1
+```
+
 Putting this all together, here's a series of commands for preparing a patch for systemd:
 
 ```sh