'\" t
.nh
.TH podman-system-df 1
.SH NAME
.PP
podman-system-df - Show podman disk usage

.SH SYNOPSIS
.PP
\fBpodman system df\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
Show podman disk usage

.SH OPTIONS
.SS \fB--format\fP=\fIformat\fP
.PP
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
.PP
Show detailed information on space usage

.SH EXAMPLE
.PP
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
.PP
\fBpodman(1)\fP, \fBpodman-system(1)\fP

.SH HISTORY
.PP
March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)