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 flag.  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 │
32       │                    │ (accepts 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 │
41       │                    │ included 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   --no-trunc
86       Do  not  truncate  the  network  ID. The network ID is not displayed by
87       default and must be specified with --format.
88
89
90   --quiet, -q
91       The quiet option will restrict the output to only the network names.
92
93

EXAMPLE

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

SEE ALSO

129       podman(1), podman-network(1), podman-network-inspect(1)
130
131

HISTORY

133       August 2019,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
134       ⟨mailto:bbaude@redhat.com⟩
135
136
137
138                                                        podman-network-ls(1)()