summaryrefslogtreecommitdiffstats
path: root/docs/HACKING.md
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2024-04-17 23:38:14 +0200
committerDaan De Meyer <daan.j.demeyer@gmail.com>2024-04-18 09:58:50 +0200
commit9fede461ca07eee2fdaf04b729e43377ca95328f (patch)
tree47c76b2a5fc4fc4a6d9dfc491f6622b998c6f7f5 /docs/HACKING.md
parentudev: fix assignment of ret_truncated (diff)
downloadsystemd-9fede461ca07eee2fdaf04b729e43377ca95328f.tar.xz
systemd-9fede461ca07eee2fdaf04b729e43377ca95328f.zip
docs: Add note on packages produced by mkosi builds
Diffstat (limited to 'docs/HACKING.md')
-rw-r--r--docs/HACKING.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/HACKING.md b/docs/HACKING.md
index 82b6434984..f95d191b80 100644
--- a/docs/HACKING.md
+++ b/docs/HACKING.md
@@ -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