mirror of
https://github.com/containers/podman.git
synced 2025-05-20 00:27:03 +08:00
91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
% podman-network-ls(1)
|
|
|
|
## NAME
|
|
podman\-network\-ls - Display a summary of CNI networks
|
|
|
|
## SYNOPSIS
|
|
**podman network ls** [*options*]
|
|
|
|
## DESCRIPTION
|
|
Displays a list of existing podman networks.
|
|
|
|
## OPTIONS
|
|
#### **--filter**, **-f**
|
|
|
|
Filter output based on conditions given.
|
|
Multiple filters can be given with multiple uses of the --filter option.
|
|
Filters with the same key work inclusive with the only exception being
|
|
`label` which is exclusive. Filters with different keys always work exclusive.
|
|
|
|
Valid filters are listed below:
|
|
|
|
| **Filter** | **Description** |
|
|
| ---------- | ------------------------------------------------------------------------------------- |
|
|
| name | [Name] Network name (accepts regex) |
|
|
| id | [ID] Full or partial network ID |
|
|
| label | [Key] or [Key=Value] Label assigned to a network |
|
|
| plugin | [Plugin] CNI plugins included in a network (e.g `bridge`,`portmap`,`firewall`,`tuning`,`dnsname`,`macvlan`) |
|
|
| driver | [Driver] Only `bridge` is supported |
|
|
|
|
#### **--format**
|
|
|
|
Change the default output format. This can be of a supported type like 'json'
|
|
or a Go template.
|
|
Valid placeholders for the Go template are listed below:
|
|
|
|
| **Placeholder** | **Description** |
|
|
| --------------- | --------------------------------|
|
|
| .ID | Network ID |
|
|
| .Name | Network name |
|
|
| .Plugins | Network Plugins |
|
|
| .Labels | Network labels |
|
|
| .Version | CNI Version of the config file |
|
|
|
|
#### **--noheading**
|
|
|
|
Omit the table headings from the listing of networks.
|
|
|
|
#### **--no-trunc**
|
|
|
|
Do not truncate the network ID. The network ID is not displayed by default and must be specified with **--format**.
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
The `quiet` option will restrict the output to only the network names.
|
|
|
|
## EXAMPLE
|
|
|
|
Display networks
|
|
|
|
```
|
|
# podman network ls
|
|
NAME VERSION PLUGINS
|
|
podman 0.3.0 bridge,portmap
|
|
podman2 0.3.0 bridge,portmap
|
|
outside 0.3.0 bridge
|
|
podman9 0.3.0 bridge,portmap
|
|
```
|
|
|
|
Display only network names
|
|
```
|
|
# podman network ls -q
|
|
podman
|
|
podman2
|
|
outside
|
|
podman9
|
|
```
|
|
|
|
Display name of network which support bridge plugin
|
|
```
|
|
# podman network ls --filter plugin=portmap --format {{.Name}}
|
|
podman
|
|
podman2
|
|
podman9
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-network(1), podman-network-inspect(1)
|
|
|
|
## HISTORY
|
|
August 2019, Originally compiled by Brent Baude <bbaude@redhat.com>
|