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

FreeBSD Manual Pages

  
 
  

home | help
podman-sys...ection-list(1)  General Commands Manual podman-sys...ection-list(1)

NAME
     podman-system-connection-list  -  List  the destination for the Podman ser-
     vice(s)

SYNOPSIS
     podman system connection list [options]

     podman system connection ls [options]

DESCRIPTION
     List ssh destination(s) for podman service(s).

OPTIONS
   --format, -f=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 listed be-
     low:

     +-------------+------------------------------+
     | Placeholder | Description		  |
     +-------------+------------------------------+
     | .Default    | Indicates	whether  connec-  |
     |		   | tion is the default	  |
     +-------------+------------------------------+
     | .Identity   | Path to file containing SSH  |
     |		   | identity			  |
     +-------------+------------------------------+
     | .Name	   | Connection Name/Identifier   |
     +-------------+------------------------------+
     | .ReadWrite  | Indicates if  this  connec-  |
     |		   | tion  can be modified using  |
     |		   | the system connection  com-  |
     |		   | mands			  |
     +-------------+------------------------------+
     | .TLSCA	   | Path to a PEM file contain-  |
     |		   | ing the certificate author-  |
     |		   | ity  bundle  to  verify the  |
     |		   | server's	     certificate  |
     |		   | against.			  |
     +-------------+------------------------------+
     | .TLSCert    | Path to a PEM file contain-  |
     |		   | ing the certificate author-  |
     |		   | ity  bundle  to  verify the  |
     |		   | server's	     certificate  |
     |		   | against.			  |
     +-------------+------------------------------+
     | .TLSKey	   | Path to a PEM file contain-  |
     |		   | ing  the private key match-  |
     |		   | ing .TLSCA 		  |
     +-------------+------------------------------+
     | .URI	   | URI  to   podman	service.  |
     |		   | Valid	schemes      are  |
     |		   | ssh://[user@]host[:port]Unix |
     |		   | domain	     socket[?se-  |
     |		   | cure=True], unix://Unix do-  |
     |		   | main  socket, and tcp://lo-  |
     |		   | calhost[:port]		  |
     +-------------+------------------------------+

   --quiet, -q
     Only show connection names

EXAMPLE
     List system connections:

     $ podman system connection list
     Name URI							   Identity	    Default  ReadWrite
     deva ssh://root@example.com:/run/podman/podman.sock	   ~/.ssh/id_rsa true	  true
     devb ssh://user@example.com:/run/user/1000/podman/podman.sock ~/.ssh/id_rsa false	  true

     Show connections in JSON format:

     $ podman system connection list --format json
     [
	 {
	     "Name": "podman-machine-default",
	     "URI": "ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock",
	     "Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
	     "IsMachine": true,
	     "Default": true,
	     "ReadWrite": true
	 },
	 {
	     "Name": "podman-machine-default-root",
	     "URI": "ssh://root@127.0.0.1:53298/run/podman/podman.sock",
	     "Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
	     "IsMachine": true,
	     "Default": false,
	     "ReadWrite": true
	 }
     ]

     Show connection names and URIs:

     $ podman system connection list --format "{{.Name}}\t{{.URI}}"
     podman-machine-default   ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
     podman-machine-default-root   ssh://root@127.0.0.1:53298/run/podman/podman.sock

     Show all connection details in a comprehensive format:

     $ podman system connection list --format "Name: {{.Name}}\nURI: {{.URI}}\nIdentity: {{.Identity}}\nDefault: {{.Default}}\nReadWrite: {{.ReadWrite}}\n---"
     Name: podman-machine-default
     URI: ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
     Identity: /Users/ragm/.local/share/containers/podman/machine/machine
     Default: true
     ReadWrite: true
     ---
     Name: podman-machine-default-root
     URI: ssh://root@127.0.0.1:53298/run/podman/podman.sock
     Identity: /Users/ragm/.local/share/containers/podman/machine/machine
     Default: false
     ReadWrite: true
     ---

SEE ALSO
     podman(1), podman-system(1), podman-system-connection(1)

HISTORY
     July 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)

						     podman-sys...ection-list(1)

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

home | help