podman-build/docs/build/man/podman-system-df.1
2025-10-11 12:30:35 +09:00

96 lines
2.6 KiB
Groff

'\" t
.nh
.TH podman-system-df 1
.SH NAME
podman-system-df \- Show podman disk usage
.SH SYNOPSIS
\fBpodman system df\fP [\fIoptions\fP]
.SH DESCRIPTION
Show podman disk usage for images, containers and volumes.
.PP
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.
.SH OPTIONS
.SS \fB--format\fP=\fIformat\fP
Pretty-print images using a Go template or JSON. This flag is not allowed in combination with \fB--verbose\fP
.PP
Valid placeholders for the Go template are listed below:
.TS
allbox;
l l
l l .
\fB\fBPlaceholder\fP\fP \fB\fBDescription\fP\fP
\&.Active T{
Indicates whether volume is in use
T}
\&.RawReclaimable T{
Raw reclaimable size of each Type
T}
\&.RawSize Raw size of each type
\&.Reclaimable T{
Reclaimable size or each type (human-readable)
T}
\&.Size T{
Size of each type (human-readable)
T}
\&.Total Total items for each type
\&.Type Type of data
.TE
.SS \fB--verbose\fP, \fB-v\fP
Show detailed information on space usage
.SH EXAMPLE
Show disk usage:
.EX
$ podman system df
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 6 2 281MB 168MB (59%)
Containers 3 1 0B 0B (0%)
Local Volumes 1 1 22B 0B (0%)
.EE
.PP
Show disk usage in verbose mode:
.EX
$ podman system df -v
Images space usage:
REPOSITORY TAG IMAGE ID CREATED SIZE SHARED SIZE UNIQUE SIZE CONTAINERS
docker.io/library/alpine latest 5cb3aa00f899 2 weeks ago 5.79MB 0B 5.79MB 5
Containers space usage:
CONTAINER ID IMAGE COMMAND LOCAL VOLUMES SIZE CREATED STATUS NAMES
073f7e62812d 5cb3 sleep 100 1 0B 20 hours ago exited zen_joliot
3f19f5bba242 5cb3 sleep 100 0 5.52kB 22 hours ago exited pedantic_archimedes
8cd89bf645cc 5cb3 ls foodir 0 58B 21 hours ago configured agitated_hamilton
a1d948a4b61d 5cb3 ls foodir 0 12B 21 hours ago exited laughing_wing
eafe3e3c5bb3 5cb3 sleep 10000 0 72B 21 hours ago exited priceless_liskov
Local Volumes space usage:
VOLUME NAME LINKS SIZE
data 1 0B
$ podman system df --format "{{.Type}}\\t{{.Total}}"
Images 1
Containers 5
Local Volumes 1
.EE
.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-system(1)\fP
.SH HISTORY
March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)