.nh
.TH podman\-network\-ls(1)
.SH NAME
.PP
podman\-network\-ls \- Display a summary of CNI networks

.SH SYNOPSIS
.PP
\fBpodman network ls\fP  [\fIoptions\fP]

.SH DESCRIPTION
.PP
Displays a list of existing podman networks.

.SH OPTIONS
.SS \fB\-\-filter\fP, \fB\-f\fP
.PP
Filter output based on conditions given.
Multiple filters can be given with multiple uses of the \-\-filter flag.
Filters with the same key work inclusive with the only exception being
\fB\fClabel\fR which is exclusive. Filters with different keys always work exclusive.

.PP
Valid filters are listed below:

.TS
allbox;
l l 
l l .
\fB\fC\fBFilter\fP\fR	\fB\fC\fBDescription\fP\fR
name	T{
[Name] Network name (accepts regex)
T}
id	T{
[ID] Full or partial network ID
T}
label	T{
[Key] or [Key=Value] Label assigned to a network
T}
plugin	T{
[Plugin] CNI plugins included in a network (e.g 
T}
\fB\fCbridge\fR,
\fB\fCportmap\fR,
\fB\fCfirewall\fR,
\fB\fCtuning\fR,
\fB\fCdnsname\fR,
\fB\fCmacvlan\fR)
driver	[Driver] Only 
\fB\fCbridge\fR is supported
.TE

.SS \fB\-\-format\fP
.PP
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:

.TS
allbox;
l l 
l l .
\fB\fC\fBPlaceholder\fP\fR	\fB\fC\fBDescription\fP\fR
\&.ID	Network ID
\&.Name	Network name
\&.Plugins	Network Plugins
\&.Labels	Network labels
\&.Version	T{
CNI Version of the config file	
T}
.TE

.SS \fB\-\-no\-trunc\fP
.PP
Do not truncate the network ID. The network ID is not displayed by default and must be specified with \fB\-\-format\fP\&.

.SS \fB\-\-quiet\fP, \fB\-q\fP
.PP
The \fB\fCquiet\fR option will restrict the output to only the network names.

.SH EXAMPLE
.PP
Display networks

.PP
.RS

.nf
# 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

.fi
.RE

.PP
Display only network names

.PP
.RS

.nf
# podman network ls \-q
podman
podman2
outside
podman9

.fi
.RE

.PP
Display name of network which support bridge plugin

.PP
.RS

.nf
# podman network ls \-\-filter plugin=portmap \-\-format {{.Name}}
podman
podman2
podman9

.fi
.RE

.SH SEE ALSO
.PP
podman(1), podman\-network(1), podman\-network\-inspect(1)

.SH HISTORY
.PP
August 2019, Originally compiled by Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]