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   (accepts │
32       │       │ regex)                            │
33       ├───────┼───────────────────────────────────┤
34       │id     │ [ID] Full or partial network ID   │
35       ├───────┼───────────────────────────────────┤
36       │label  │ [Key]  or  [Key=Value]  Label as‐ │
37       │       │ signed to a network               │
38       ├───────┼───────────────────────────────────┤
39       │plugin │ [Plugin] CNI plugins included  in │
40       │       │ a           network          (e.g │
41       │       │ bridge,portmap,firewall,tun‐      │
42       │       │ ing,dnsname,macvlan)              │
43       ├───────┼───────────────────────────────────┤
44       │driver │ [Driver] Only bridge is supported │
45       └───────┴───────────────────────────────────┘
46
47   --format
48       Change the default output format.  This can be of a supported type like
49       'json' or a Go template.  Valid placeholders for the  Go  template  are
50       listed below:
51
52
53       ┌────────────┬────────────────────────────┐
54       │Placeholder │ Description                │
55       ├────────────┼────────────────────────────┤
56       │.ID         │ Network ID                 │
57       ├────────────┼────────────────────────────┤
58       │.Name       │ Network name               │
59       ├────────────┼────────────────────────────┤
60       │.Plugins    │ Network Plugins            │
61       ├────────────┼────────────────────────────┤
62       │.Labels     │ Network labels             │
63       ├────────────┼────────────────────────────┤
64       │.Version    │ CNI  Version of the config │
65       │            │ file                       │
66       └────────────┴────────────────────────────┘
67
68   --noheading
69       Omit the table headings from the listing of networks.
70
71
72   --no-trunc
73       Do not truncate the network ID. The network ID is not displayed by  de‐
74       fault and must be specified with --format.
75
76
77   --quiet, -q
78       The quiet option will restrict the output to only the network names.
79
80

EXAMPLE

82       Display networks
83
84
85              # podman network ls
86              NAME      VERSION   PLUGINS
87              podman    0.3.0     bridge,portmap
88              podman2   0.3.0     bridge,portmap
89              outside   0.3.0     bridge
90              podman9   0.3.0     bridge,portmap
91
92
93
94       Display only network names
95
96
97              # podman network ls -q
98              podman
99              podman2
100              outside
101              podman9
102
103
104
105       Display name of network which support bridge plugin
106
107
108              # podman network ls --filter plugin=portmap --format {{.Name}}
109              podman
110              podman2
111              podman9
112
113
114

SEE ALSO

116       podman(1), podman-network(1), podman-network-inspect(1)
117
118

HISTORY

120       August  2019,  Originally  compiled  by  Brent  Baude bbaude@redhat.com
121       ⟨mailto:bbaude@redhat.com⟩
122
123
124
125                                                        podman-network-ls(1)()
Impressum