mirror of
https://github.com/containers/podman.git
synced 2025-05-21 09:05:56 +08:00
d9ff0fd15d
Podman Machine crashes if run as root. When creating the machine, we write the ignition so that the UID of the core user matches the UID of the user on the host. We by default, create the root user on the machine with UID 0. If the user on the host is root, the core UID and the Root UID collide, causing a the VM not to boot. [NO NEW TESTS NEEDED] Signed-off-by: Ashley Cui <acui@redhat.com>
88 lines
2.1 KiB
Markdown
88 lines
2.1 KiB
Markdown
% podman-machine-ssh(1)
|
|
|
|
## NAME
|
|
podman\-machine\-ssh - SSH into a virtual machine
|
|
|
|
## SYNOPSIS
|
|
**podman machine ssh** [*options*] [*name*] [*command* [*arg* ...]]
|
|
|
|
## DESCRIPTION
|
|
|
|
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.
|
|
|
|
The exit code from ssh command will be forwarded to the podman machine ssh caller, see [Exit Codes](#Exit-Codes).
|
|
|
|
Rootless only.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--help**
|
|
|
|
Print usage statement.
|
|
|
|
#### **--username**=*name*
|
|
|
|
Username to use when SSH-ing into the VM.
|
|
|
|
## Exit Codes
|
|
|
|
The exit code from `podman machine ssh` gives information about why the command failed.
|
|
When `podman machine ssh` commands exit with a non-zero code,
|
|
the exit codes follow the `chroot` standard, see below:
|
|
|
|
**125** The error is with podman **_itself_**
|
|
|
|
$ podman machine ssh --foo; echo $?
|
|
Error: unknown flag: --foo
|
|
125
|
|
|
|
**126** Executing a _contained command_ and the _command_ cannot be invoked
|
|
|
|
$ podman machine ssh /etc; echo $?
|
|
Error: fork/exec /etc: permission denied
|
|
126
|
|
|
|
**127** Executing a _contained command_ and the _command_ cannot be found
|
|
|
|
$ podman machine ssh foo; echo $?
|
|
Error: fork/exec /usr/bin/bogus: no such file or directory
|
|
127
|
|
|
|
**Exit code** _contained command_ exit code
|
|
|
|
$ podman machine ssh /bin/sh -c 'exit 3'; echo $?
|
|
3
|
|
|
|
## 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 myvm rpm -q podman
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**
|
|
|
|
## HISTORY
|
|
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>
|