mirror of
https://github.com/containers/podman.git
synced 2025-08-06 11:32:07 +08:00

Somewhere in the CIv2 migration we lost the man page vs --help cross-checker. Add it back, by adding it into the man-page-check Makefile target; this is part of 'make validate', which is run in CI even on CI:DOCS PRs. As happens when CI doesn't run, things broke. Man pages got out of sync with --help. This PR: 1) Fixes hack/xref-helpmsgs-manpages to deal with the new "Options" (instead of "Flags") form of podman help. #8034 did part of that, but one of my review comments was accidentally left out. 2) Fixes hack/xref-helpmsgs-manpages to deal with the new option syntax in man pages, post- #8292, in which each option is preceded by four hashes so as to make them HTML <h4> elements with named anchors. 3) Fixes man pages that #8292 accidentally missed. 4) Adds man page entries for two flags that got added to podman but not documented (pod create --network-alias, play kube --log-driver) Fixes: #8296 Signed-off-by: Ed Santiago <santiago@redhat.com>
1.7 KiB
1.7 KiB
% podman-system-df(1)
NAME
podman-system-df - Show podman disk usage
SYNOPSIS
podman system df [options]
DESCRIPTION
Show podman disk usage
OPTIONS
--format=format
Pretty-print images using a Go template
-v, --verbose[=true|false]
Show detailed information on space usage
EXAMPLE
$ 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%)
$ 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-system(1)
HISTORY
March 2019, Originally compiled by Qi Wang (qiwan at redhat dot com)