mirror of
https://github.com/containers/podman.git
synced 2025-05-21 00:56:36 +08:00
42fb942a6f
Add a new `podman machine cp` subcommand to allow users to copy files or directories between a running Podman Machine and their host. Tests cover the following cases: - Copy a file from the host machine to the VM - Copy a directory from the host machine to the VM - Copy a file from the VM to the host machine - Copy a directory from the VM to the host machine - Copy a file to a directory - Copy a directory to a file Signed-off-by: Jake Correnti <jakecorrenti+github@proton.me>
52 lines
3.7 KiB
Markdown
52 lines
3.7 KiB
Markdown
% podman-machine 1
|
|
|
|
## NAME
|
|
podman\-machine - Manage Podman's virtual machine
|
|
|
|
## SYNOPSIS
|
|
**podman machine** *subcommand*
|
|
|
|
## DESCRIPTION
|
|
`podman machine` is a set of subcommands that manage Podman's virtual machine.
|
|
|
|
Podman on MacOS and Windows 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. Podman machine must be used to manage MacOS and Windows machines,
|
|
but can be optionally used on Linux.
|
|
|
|
All `podman machine` commands are rootless only.
|
|
|
|
NOTE: The podman-machine configuration file is managed under the
|
|
`$XDG_CONFIG_HOME/containers/podman/machine/` directory. Changing the `$XDG_CONFIG_HOME`
|
|
environment variable while the machines are running can lead to unexpected behavior.
|
|
|
|
Podman machine behaviour can be modified via the [machine] section in the containers.conf(5) file.
|
|
|
|
## SUBCOMMANDS
|
|
|
|
| Command | Man Page | Description |
|
|
|---------|----------------------------------------------------------|-----------------------------------------------------------------|
|
|
| cp | [podman-machine-cp(1)](podman-machine-cp.1.md) | Securely copy contents between the host and the virtual machine |
|
|
| info | [podman-machine-info(1)](podman-machine-info.1.md) | Display machine host info |
|
|
| init | [podman-machine-init(1)](podman-machine-init.1.md) | Initialize a new virtual machine |
|
|
| inspect | [podman-machine-inspect(1)](podman-machine-inspect.1.md) | Inspect one or more virtual machines |
|
|
| list | [podman-machine-list(1)](podman-machine-list.1.md) | List virtual machines |
|
|
| os | [podman-machine-os(1)](podman-machine-os.1.md) | Manage a Podman virtual machine's OS |
|
|
| reset | [podman-machine-reset(1)](podman-machine-reset.1.md) | Reset Podman machines and environment |
|
|
| rm | [podman-machine-rm(1)](podman-machine-rm.1.md) | Remove a virtual machine |
|
|
| set | [podman-machine-set(1)](podman-machine-set.1.md) | Set a virtual machine setting |
|
|
| ssh | [podman-machine-ssh(1)](podman-machine-ssh.1.md) | SSH into a virtual machine |
|
|
| start | [podman-machine-start(1)](podman-machine-start.1.md) | Start a virtual machine |
|
|
| stop | [podman-machine-stop(1)](podman-machine-stop.1.md) | Stop a virtual machine |
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-machine-cp(1)](podman-machine-cp.1.md)**, **[podman-machine-info(1)](podman-machine-info.1.md)**, **[podman-machine-init(1)](podman-machine-init.1.md)**, **[podman-machine-list(1)](podman-machine-list.1.md)**, **[podman-machine-os(1)](podman-machine-os.1.md)**, **[podman-machine-rm(1)](podman-machine-rm.1.md)**, **[podman-machine-ssh(1)](podman-machine-ssh.1.md)**, **[podman-machine-start(1)](podman-machine-start.1.md)**, **[podman-machine-stop(1)](podman-machine-stop.1.md)**, **[podman-machine-inspect(1)](podman-machine-inspect.1.md)**, **[podman-machine-reset(1)](podman-machine-reset.1.md)**, **containers.conf(5)**
|
|
|
|
### Troubleshooting
|
|
|
|
See [podman-troubleshooting(7)](https://github.com/containers/podman/blob/main/troubleshooting.md)
|
|
for solutions to common issues.
|
|
|
|
## HISTORY
|
|
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>
|