mirror of
https://github.com/containers/podman.git
synced 2025-05-17 06:59:07 +08:00
69dc0720b9
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 <pholzing@redhat.com>
2.9 KiB
2.9 KiB
% podman-system-df 1
NAME
podman-system-df - Show podman disk usage
SYNOPSIS
podman system df [options]
DESCRIPTION
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
Pretty-print images using a Go template or JSON. This flag is not allowed in combination with --verbose
Valid placeholders for the Go template are listed below:
| Placeholder | Description |
|---|---|
| .Active | Indicates whether volume is in use |
| .RawReclaimable | Raw reclaimable size of each Type |
| .RawSize | Raw size of each type |
| .Reclaimable | Reclaimable size or each type (human-readable) |
| .Size | Size of each type (human-readable) |
| .Total | Total items for each type |
| .Type | Type of data |
--verbose, -v
Show detailed information on space usage
EXAMPLE
Show disk usage:
$ 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%)
Show disk usage in verbose mode:
$ 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
SEE ALSO
HISTORY
March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)