From 69dc0720b917d96a175ef6e482896ca17c8e018c Mon Sep 17 00:00:00 2001 From: Paul Holzinger Date: Fri, 7 Mar 2025 16:18:54 +0100 Subject: [PATCH] docs: add note about systemd df RECLAIMABLE bug Our calculation is just wrong and the way the entire API is designed it cannot work. This is the same interface as docker is using and they have the same bug there. So simply document this as known problem, in case users complain we at least have something to point to. An actual fix might be possible but not without reworking the full API and because this is exposed in the docker compat and libpod REST API we cannot really change it. Signed-off-by: Paul Holzinger --- docs/source/markdown/podman-system-df.1.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/source/markdown/podman-system-df.1.md b/docs/source/markdown/podman-system-df.1.md index a2dc5c6f39..740a41199d 100644 --- a/docs/source/markdown/podman-system-df.1.md +++ b/docs/source/markdown/podman-system-df.1.md @@ -7,7 +7,11 @@ podman\-system\-df - Show podman disk usage **podman system df** [*options*] ## DESCRIPTION -Show podman disk usage +Show podman disk usage for images, containers and volumes. + +Note: The RECLAIMABLE size that is reported for images can be incorrect. It might +report that it can reclaim more than a prune would actually free. This will happen +if you are using different images that share some layers. ## OPTIONS #### **--format**=*format*