1podman-network-ls(1)()                                  podman-network-ls(1)()
2
3
4

NAME

6       podman-network-ls - Display a summary of CNI networks
7
8

SYNOPSIS

10       podman network ls  [options]
11
12

DESCRIPTION

14       Displays a list of existing podman networks.
15
16

OPTIONS

18   --filter, -f
19       Filter output based on conditions given.  Multiple filters can be given
20       with multiple uses of the --filter option.  Filters with the  same  key
21       work  inclusive with the only exception being label which is exclusive.
22       Filters with different keys always work exclusive.
23
24
25       Valid filters are listed below:
26
27
28       ┌────────────────────┬────────────────────────────┐
29       │Filter              │ Description                │
30       ├────────────────────┼────────────────────────────┤
31       │name                │ [Name] Network  name  (ac‐ │
32       │                    │ cepts regex)               │
33       ├────────────────────┼────────────────────────────┤
34       │id                  │ [ID]  Full or partial net‐ │
35       │                    │ work ID                    │
36       ├────────────────────┼────────────────────────────┤
37       │label               │ [Key] or [Key=Value] Label │
38       │                    │ assigned to a network      │
39       ├────────────────────┼────────────────────────────┤
40       │plugin              │ [Plugin]  CNI  plugins in‐ │
41       │                    │ cluded in a network (e.g   │
42       ├────────────────────┼────────────────────────────┤
43       │bridge,             │                            │
44       ├────────────────────┼────────────────────────────┤
45       │portmap,            │                            │
46       ├────────────────────┼────────────────────────────┤
47       │firewall,           │                            │
48       ├────────────────────┼────────────────────────────┤
49       │tuning,             │                            │
50       ├────────────────────┼────────────────────────────┤
51       │dnsname,            │                            │
52       ├────────────────────┼────────────────────────────┤
53       │macvlan)            │                            │
54       ├────────────────────┼────────────────────────────┤
55       │driver              │ [Driver] Only              │
56       ├────────────────────┼────────────────────────────┤
57       │bridge is supported │                            │
58       ├────────────────────┼────────────────────────────┤
59       │                    │                            │
60       └────────────────────┴────────────────────────────┘
61
62   --format
63       Change the default output format.  This can be of a supported type like
64       'json'  or  a  Go template.  Valid placeholders for the Go template are
65       listed below:
66
67
68       ┌────────────┬────────────────────────────┐
69       │Placeholder │ Description                │
70       ├────────────┼────────────────────────────┤
71       │.ID         │ Network ID                 │
72       ├────────────┼────────────────────────────┤
73       │.Name       │ Network name               │
74       ├────────────┼────────────────────────────┤
75       │.Plugins    │ Network Plugins            │
76       ├────────────┼────────────────────────────┤
77       │.Labels     │ Network labels             │
78       ├────────────┼────────────────────────────┤
79       │.Version    │ CNI Version of the  config │
80       │            │ file                       │
81       ├────────────┼────────────────────────────┤
82       │            │                            │
83       └────────────┴────────────────────────────┘
84
85   --noheading
86       Omit the table headings from the listing of networks.
87
88
89   --no-trunc
90       Do  not truncate the network ID. The network ID is not displayed by de‐
91       fault and must be specified with --format.
92
93
94   --quiet, -q
95       The quiet option will restrict the output to only the network names.
96
97

EXAMPLE

99       Display networks
100
101
102              # podman network ls
103              NAME      VERSION   PLUGINS
104              podman    0.3.0     bridge,portmap
105              podman2   0.3.0     bridge,portmap
106              outside   0.3.0     bridge
107              podman9   0.3.0     bridge,portmap
108
109
110
111       Display only network names
112
113
114              # podman network ls -q
115              podman
116              podman2
117              outside
118              podman9
119
120
121
122       Display name of network which support bridge plugin
123
124
125              # podman network ls --filter plugin=portmap --format {{.Name}}
126              podman
127              podman2
128              podman9
129
130
131

SEE ALSO

133       podman(1), podman-network(1), podman-network-inspect(1)
134
135

HISTORY

137       August 2019,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
138       ⟨mailto:bbaude@redhat.com⟩
139
140
141
142                                                        podman-network-ls(1)()
Impressum