Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
podman-network-ls(1)	     General Commands Manual	    podman-network-ls(1)

NAME
     podman-network-ls - Display a summary of networks

SYNOPSIS
     podman network ls	[options]

DESCRIPTION
     Displays a list of existing podman networks.

OPTIONS
   --filter, -f=filter=value
     Provide filter values.

     The filters argument format is of key=value. If there is more than one fil-
     ter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.

     Supported filters:

     +----------+-----------------------------+
     | Filter	| Description		      |
     +----------+-----------------------------+
     | driver	| Filter by driver type.      |
     +----------+-----------------------------+
     | id	| Filter  by  full or partial |
     |		| network ID.		      |
     +----------+-----------------------------+
     | label	| Filter by network with  (or |
     |		| without, in the case of la- |
     |		| bel!=[...]   is  used)  the |
     |		| specified labels.	      |
     +----------+-----------------------------+
     | name	| Filter by network name (ac- |
     |		| cepts regex). 	      |
     +----------+-----------------------------+
     | until	| Filter by networks  created |
     |		| before given timestamp.     |
     +----------+-----------------------------+
     | dangling | Filter  by networks with no |
     |		| containers attached.	      |
     +----------+-----------------------------+

     The driver filter accepts values: bridge, macvlan, ipvlan.

     The label	filter	accepts  two  formats.	One  is  the  label=key  or  la-
     bel=key=value,  which  shows  networks with the specified labels. The other
     format is the label!=key or label!=key=value, which shows networks  without
     the specified labels.

     The  until  filter can be Unix timestamps, date formatted timestamps, or Go
     duration strings (e.g. 10m, 1h30m) computed relative to the machine's time.

     The dangling filter accepts values true or false.

   --format=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 		  |
     +--------------------+-------------------------------+
     | .Created ...	  | Timestamp  when  the  network |
     |			  | was created 		  |
     +--------------------+-------------------------------+
     | .DNSEnabled	  | Network   has   dns   enabled |
     |			  | (boolean)			  |
     +--------------------+-------------------------------+
     | .Driver		  | Network driver		  |
     +--------------------+-------------------------------+
     | .ID		  | Network ID			  |
     +--------------------+-------------------------------+
     | .Internal	  | Network is internal (boolean) |
     +--------------------+-------------------------------+
     | .IPAMOptions ...   | Network ipam options	  |
     +--------------------+-------------------------------+
     | .IPv6Enabled	  | Network   has   ipv6   subnet |
     |			  | (boolean)			  |
     +--------------------+-------------------------------+
     | .Labels		  | Network labels		  |
     +--------------------+-------------------------------+
     | .Name		  | Network name		  |
     +--------------------+-------------------------------+
     | .NetworkDNSServers | Array of DNS servers used  in |
     |			  | this network		  |
     +--------------------+-------------------------------+
     | .NetworkInterface  | Name of the network interface |
     |			  | on the host 		  |
     +--------------------+-------------------------------+
     | .Options ...	  | Network options		  |
     +--------------------+-------------------------------+
     | .Routes		  | List  of  static  routes  for |
     |			  | this network		  |
     +--------------------+-------------------------------+
     | .Subnets 	  | List of subnets on this  net- |
     |			  | work			  |
     +--------------------+-------------------------------+

   --no-trunc
     Do not truncate the network ID.

   --noheading, -n
     Omit the table headings from the listing.

   --quiet, -q
     The quiet option restricts the output to only the network names.

EXAMPLE
     Display networks:

     $ podman network ls
     NETWORK ID    NAME 	DRIVER
     88a7120ee19d  podman	bridge
     6dd508dbf8cd  podman6  bridge
     8e35c2cd3bf6  podman5  macvlan

     Display only network names:

     $ podman network ls -q
     podman
     podman2
     outside
     podman9

     Display name of network which support bridge plugin:

     $ podman network ls --filter driver=bridge --format {{.Name}}
     podman
     podman2
     podman9

     List networks with their subnets:

     $ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
     podman: 10.88.0.0/16
     podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
     macvlan:

SEE ALSO
     podman(1),  podman-network(1),  podman-network-inspect(1),  podman-network-
     create(1)

HISTORY
     August 2021, Updated with the new network format by Paul  Holzinger  pholz-
     ing@redhat.com <mailto:pholzing@redhat.com>

     August   2019,   Originally   compiled  by  Brent	Baude  bbaude@redhat.com
     <mailto:bbaude@redhat.com>

							    podman-network-ls(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-network-ls&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help