mirror of
https://github.com/containers/podman.git
synced 2025-05-28 21:46:51 +08:00

We now no longer write containers.conf, instead system connections and farms are written to a new file called podman-connections.conf. This is a major rework and I had to change a lot of things to get this to compile again with my c/common changes. It is a breaking change for users as connections/farms added before this commit can now no longer be removed or modified directly. However because the logic keeps reading from containers.conf the old connections can still be used to connect to a remote host. Signed-off-by: Paul Holzinger <pholzing@redhat.com>
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
% podman-system-connection-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 connection is the default |
|
|
| .Identity | Path to file containing SSH identity |
|
|
| .Name | Connection Name/Identifier |
|
|
| .ReadWrite | Indicates if this connection can be modified using the system connection commands |
|
|
| .URI | URI to podman service. Valid schemes are ssh://[user@]*host*[:port]*Unix domain socket*[?secure=True], unix://*Unix domain socket*, and tcp://localhost[:*port*] |
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Only show connection names
|
|
|
|
## EXAMPLE
|
|
```
|
|
$ 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
|
|
```
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **[podman-system-connection(1)](podman-system-connection.1.md)**
|
|
|
|
## HISTORY
|
|
July 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)
|