Improve the documentation of quadlet

Users fail to realize that they can use other systemd options within the quadlet files, like ExecStartPre. This change should make it clearer to the users. #20642 Signed-off-by: Daniel J Walsh <[email protected]>
containers · Nov 10, 2023 · 956c0d6 · 956c0d6
1 parent 7d107b9
commit 956c0d6
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/source/markdown/podman-systemd.unit.5.md b/docs/source/markdown/podman-systemd.unit.5.md
@@ -25,6 +25,9 @@ Podman supports starting containers (and creating volumes) via systemd by using
 [systemd generator](https://www.freedesktop.org/software/systemd/man/systemd.generator.html).
 These files are read during boot (and when `systemctl daemon-reload` is run) and generate
 corresponding regular systemd service unit files. Both system and user systemd units are supported.
+All options and tables available in standard systemd unit files are supported. For example, options defined in
+the [Service] table and [Install] tables pass directly to systemd and are handled by it.
+See systemd.unit(5) man page for more information.
 
 The Podman generator reads the search paths above and reads files with the extensions `.container`
 `.volume` and `*.kube`, and for each file generates a similarly named `.service` file. Be aware that
@@ -1219,6 +1222,8 @@ Exec=sleep 60
 Restart=always
 # Extend Timeout to allow time to pull the image
 TimeoutStartSec=900
+# ExecStartPre flag and other systemd commands can go here, see systemd.unit(5) man page.
+ExecStartPre=/usr/share/mincontainer/setup.sh
 
 [Install]
 # Start by default on boot
@@ -1263,3 +1268,4 @@ Label=org.test.Key=value
 **[podman-run(1)](podman-run.1.md)**,
 **[podman-network-create(1)](podman-network-create.1.md)**,
 **[podman-auto-update(1)](podman-auto-update.1.md)**
+**[systemd.unit(5)]**