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

FreeBSD Manual Pages

  
 
  

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

NAME
       podman-system-connection-list  -	 List  the  destination	for the	Podman
       service(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
       below:

       +-------------+------------------------------+
       | 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 con-   |
       |	     | taining	the   certificate   |
       |	     | authority bundle	to verify   |
       |	     | the  server's  certificate   |
       |	     | against.			    |
       +-------------+------------------------------+
       | .TLSCert    | Path to a  PEM  file  con-   |
       |	     | taining	 the  certificate   |
       |	     | authority bundle	to verify   |
       |	     | the  server's  certificate   |
       |	     | against.			    |
       +-------------+------------------------------+
       | .TLSKey     | Path  to	 a  PEM	file con-   |
       |	     | taining	the  private  key   |
       |	     | matching	.TLSCA		    |
       +-------------+------------------------------+
       | .URI	     | URI   to	 podman	 service.   |
       |	     | Valid	 schemes      are   |
       |	     | ssh://[user@]host[:port]Unix |
       |	     | domain	      socket[?se-   |
       |	     | cure=True],    unix://Unix   |
       |	     | domain	  socket,     and   |
       |	     | tcp://localhost[: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.0.quarterly>

home | help