diff options
author | baude <bbaude@redhat.com> | 2021-03-30 13:06:58 -0500 |
---|---|---|
committer | baude <bbaude@redhat.com> | 2021-03-31 12:51:33 -0500 |
commit | f6438d36f3e52eb721f4223e767fd67b4c274d08 (patch) | |
tree | 50ecb0b5c4d1bbbb9742657742cec4f0b835ef01 /docs/source | |
parent | 2e72b13823f1be199e483f34899723819d1dc474 (diff) | |
download | podman-f6438d36f3e52eb721f4223e767fd67b4c274d08.tar.gz podman-f6438d36f3e52eb721f4223e767fd67b4c274d08.tar.bz2 podman-f6438d36f3e52eb721f4223e767fd67b4c274d08.zip |
Remove --execute from podman machine ssh
The --execute flag ended up serving no purpose. It was removed and
documentation was updated.
Fixed a panic when no VM name was provided.
[NO TESTS NEEDED]
Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/source')
-rw-r--r-- | docs/source/markdown/podman-machine-ssh.1.md | 28 |
1 files changed, 18 insertions, 10 deletions
diff --git a/docs/source/markdown/podman-machine-ssh.1.md b/docs/source/markdown/podman-machine-ssh.1.md index fa78f876a..30cbaf4bd 100644 --- a/docs/source/markdown/podman-machine-ssh.1.md +++ b/docs/source/markdown/podman-machine-ssh.1.md @@ -4,36 +4,44 @@ podman\-machine\-ssh - SSH into a virtual machine ## SYNOPSIS -**podman machine ssh** [*options*] [*name*] [*command* [*arg* ...]] +**podman machine ssh** [*name*] [*command* [*arg* ...]] ## DESCRIPTION -SSH into a Podman-managed virtual machine. +SSH into a Podman-managed virtual machine and optionally execute a command +on the virtual machine. Unless using the default virtual machine, the +first argument must be the virtual machine name. The optional command to +execute can then follow. If no command is provided, an interactive session +with the virtual machine is established. -Podman on MacOS requires a virtual machine. This is because containers are Linux - -containers do not run on any other OS because containers' core functionality are -tied to the Linux kernel. ## OPTIONS -#### **\-\-execute**, **-e** - -Execute the given command on the VM - #### **\-\-help** Print usage statement. ## EXAMPLES +To get an interactive session with the default virtual machine: + +``` +$ podman machine ssh +``` + To get an interactive session with a VM called `myvm`: ``` $ podman machine ssh myvm ``` +To run a command on the default virtual machine: +``` +$ podman machine ssh rpm -q podman +``` + To run a command on a VM called `myvm`: ``` -$ podman machine ssh -e myvm -- rpm -q podman +$ podman machine ssh myvm rpm -q podman ``` ## SEE ALSO |