From cb5450af70c6ab1706a6a18c3d509872739b5dcd Mon Sep 17 00:00:00 2001 From: Ygal Blum Date: Mon, 24 Jul 2023 10:17:16 +0300 Subject: [PATCH] [CI:DOCS] Add note about QUADLET_UNIT_DIRS to simplify quadlet debug Signed-off-by: Ygal Blum --- docs/source/markdown/podman-systemd.unit.5.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/source/markdown/podman-systemd.unit.5.md b/docs/source/markdown/podman-systemd.unit.5.md index 087c630329..fbe210cc25 100644 --- a/docs/source/markdown/podman-systemd.unit.5.md +++ b/docs/source/markdown/podman-systemd.unit.5.md @@ -83,6 +83,18 @@ View the generated files and/or error messages with: /usr/lib/systemd/system-generators/podman-system-generator {--user} --dryrun ``` +#### Debugging a limited set of unit files + +If you would like to debug a limited set of unit files, you can copy them to a separate directory and set the +`QUADLET_UNIT_DIRS` environment variable to this directory when running the command below: + +``` +QUADLET_UNIT_DIRS= /usr/lib/systemd/system-generators/podman-system-generator {--user} --dryrun +``` + +This will instruct quadlet to look for units in this directory instead of the common ones and by +that limit the output to only the units you are debugging. + ## Container units [Container] Container units are named with a `.container` extension and contain a `[Container]` section describing