mirror of
https://github.com/containers/podman.git
synced 2025-06-06 06:44:53 +08:00
bc48211924
Escape the two dashes, otherwise they are combined into one long dash. I tested that this change is safe and still renders correctly on github and with the man pages. This commit also contains a small change to make it build locally. Assuming you have the dependencies installed you can do: ``` cd docs make html ``` Preview the html files in docs/build/html with `python -m http.server 8000 --directory build/html`. Fixes containers/podman.io#373 Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
78 lines
2.9 KiB
Markdown
78 lines
2.9 KiB
Markdown
% podman-container-prune(1)
|
||
|
||
## NAME
|
||
podman-container-prune - Remove all stopped containers from local storage
|
||
|
||
## SYNOPSIS
|
||
**podman container prune** [*options*]
|
||
|
||
## DESCRIPTION
|
||
**podman container prune** removes all stopped containers from local storage.
|
||
|
||
## OPTIONS
|
||
|
||
#### **\-\-filter**=*filters*
|
||
|
||
Provide filter values.
|
||
|
||
The --filter flag format is of “key=value”. If there is more than one filter, then pass multiple flags (e.g., --filter "foo=bar" --filter "bif=baz")
|
||
|
||
Supported filters:
|
||
|
||
- `until` (_timestamp_) - only remove containers and images created before given timestamp
|
||
- `label` (label=_key_, label=_key=value_, label!=_key_, or label!=_key=value_) - only remove containers and images, with (or without, in case label!=... is used) the specified labels.
|
||
|
||
The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.
|
||
|
||
The label filter accepts two formats. One is the label=... (label=_key_ or label=_key=value_), which removes containers with the specified labels. The other format is the label!=... (label!=_key_ or label!=_key=value_), which removes containers without the specified labels.
|
||
|
||
#### **\-\-force**, **-f**
|
||
|
||
Do not provide an interactive prompt for container removal.
|
||
|
||
**-h**, **\-\-help**
|
||
|
||
Print usage statement
|
||
|
||
## EXAMPLES
|
||
|
||
Remove all stopped containers from local storage
|
||
```
|
||
$ sudo podman container prune
|
||
WARNING! This will remove all stopped containers.
|
||
Are you sure you want to continue? [y/N] y
|
||
878392adf2e6c5c9bb1fc19b69d37d2e98c8abf9d539c0bce4b15b46bbcce471
|
||
37664467fbe3618bf9479c34393ac29c02696675addf1750f9e346581636cde7
|
||
ed0c6468b8e1cb641b4621d1fe30cb477e1fefc5c0bceb66feaf2f7cb50e5962
|
||
6ac6c8f0067b7a4682e6b8e18902665b57d1a0e07e885d9abcd382232a543ccd
|
||
fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
|
||
602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5
|
||
```
|
||
|
||
Remove all stopped containers from local storage without confirmation.
|
||
```
|
||
$ sudo podman container prune -f
|
||
878392adf2e6c5c9bb1fc19b69d37d2e98c8abf9d539c0bce4b15b46bbcce471
|
||
37664467fbe3618bf9479c34393ac29c02696675addf1750f9e346581636cde7
|
||
ed0c6468b8e1cb641b4621d1fe30cb477e1fefc5c0bceb66feaf2f7cb50e5962
|
||
6ac6c8f0067b7a4682e6b8e18902665b57d1a0e07e885d9abcd382232a543ccd
|
||
fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
|
||
602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5
|
||
|
||
```
|
||
|
||
Remove all stopped containers from local storage created within last 10 minutes
|
||
```
|
||
$ sudo podman container prune --filter until="10m"
|
||
WARNING! This will remove all stopped containers.
|
||
Are you sure you want to continue? [y/N] y
|
||
3d366295e33d8cc612c4d873199bacadd55088d90d17dcafaa9a2d317ad50b4e
|
||
```
|
||
|
||
## SEE ALSO
|
||
podman(1), podman-ps
|
||
|
||
## HISTORY
|
||
December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)
|
||
December 2020, converted filter information from docs.docker.com documentation by Dan Walsh (dwalsh at redhat dot com)
|