mirror of
https://github.com/containers/podman.git
synced 2025-12-04 12:17:34 +08:00
a80a908df7
Some --filter descriptions listed the filters with asterisks, i.e. markdown italics. There were 60+ of those, 250+ without asterisks, so I choose to de-asterisk them all. Update the xref script to remove the allow-asterisk exception. (Except for the column title, which is sometimes written with two asterisks--boldface--and sometimes plain). Signed-off-by: Ed Santiago <santiago@redhat.com>
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
% podman-network-prune 1
|
||
|
||
## NAME
|
||
podman\-network\-prune - Remove all unused networks
|
||
|
||
## SYNOPSIS
|
||
**podman network prune** [*options*]
|
||
|
||
## DESCRIPTION
|
||
Remove all unused networks. An unused network is defined by a network which
|
||
has no containers connected or configured to connect to it. It does not remove
|
||
the so-called default network which goes by the name of *podman*.
|
||
|
||
## OPTIONS
|
||
|
||
#### **--filter**
|
||
|
||
Provide filter values.
|
||
|
||
The *filters* argument format is of `key=value`. If there is more than one *filter*, then pass multiple OPTIONS: **--filter** *foo=bar* **--filter** *bif=baz*.
|
||
|
||
Supported filters:
|
||
|
||
| Filter | Description |
|
||
|:------:|----------------------------------------------------------------------------------------------------|
|
||
| label | Only remove networks, with (or without, in the case of label!=[...] is used) the specified labels. |
|
||
| until | Only remove networks created before given timestamp. |
|
||
|
||
The `label` *filter* accepts two formats. One is the `label`=*key* or `label`=*key*=*value*, which removes networks with the specified labels. The other format is the `label!`=*key* or `label!`=*key*=*value*, which removes networks without 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.
|
||
|
||
#### **--force**, **-f**
|
||
|
||
Do not prompt for confirmation
|
||
|
||
## EXAMPLE
|
||
Prune networks
|
||
```
|
||
podman network prune
|
||
```
|
||
|
||
Prune all networks created before 2h
|
||
```
|
||
podman network prune --filter until=2h
|
||
```
|
||
|
||
## SEE ALSO
|
||
**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-rm(1)](podman-network-rm.1.md)**
|
||
|
||
## HISTORY
|
||
February 2021, Originally compiled by Brent Baude <bbaude@redhat.com>
|