mirror of
https://github.com/containers/podman.git
synced 2025-06-05 22:31:06 +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>
80 lines
2.9 KiB
Markdown
80 lines
2.9 KiB
Markdown
% 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
|
|
**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**
|
|
|
|
## HISTORY
|
|
March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)
|