diff options
author | baude <bbaude@redhat.com> | 2021-03-22 13:29:25 -0500 |
---|---|---|
committer | baude <bbaude@redhat.com> | 2021-03-25 11:02:33 -0500 |
commit | 4ab8a6f67eb9de0de40d478cb0cbec05b1b725c0 (patch) | |
tree | 00743bf608cc5700fe8a7fca1bb3b0f3a4457b7d /docs/source/markdown/podman-machine-remove.1.md | |
parent | e7661137373b5f87bf6ec45e32326821b172ce7b (diff) | |
download | podman-4ab8a6f67eb9de0de40d478cb0cbec05b1b725c0.tar.gz podman-4ab8a6f67eb9de0de40d478cb0cbec05b1b725c0.tar.bz2 podman-4ab8a6f67eb9de0de40d478cb0cbec05b1b725c0.zip |
Improvements for machine
clean up ci failures and add appropriate arch,os exclusion tags
Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/source/markdown/podman-machine-remove.1.md')
-rw-r--r-- | docs/source/markdown/podman-machine-remove.1.md | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-machine-remove.1.md b/docs/source/markdown/podman-machine-remove.1.md new file mode 100644 index 000000000..07763741d --- /dev/null +++ b/docs/source/markdown/podman-machine-remove.1.md @@ -0,0 +1,65 @@ +% podman-machine-remove(1) + +## NAME +podman\-machine\-remove - Remove a virtual machine + +## SYNOPSIS +**podman machine remove** [*options*] *name* + +## DESCRIPTION + +Remove a virtual machine and its related files. What is actually deleted +depends on the virtual machine type. For all virtual machines, the generated +SSH keys and the podman system connection are deleted. The ignition files +generated for that VM are also removeed as is its image file on the filesystem. + +Users get a display of what will be deleted and are required to confirm unless the option `--force` +is used. + + +## OPTIONS + +#### **--help** + +Print usage statement. + +#### **--force** + +Delete without confirmation + +#### **--save-ignition** + +Do not delete the generated ignition file + +#### **--save-image** + +Do not delete the VM image + +#### **--save-keys** + +Do not delete the SSH keys for the VM. The system connection is always +deleted. + +## EXAMPLES + +Remove a VM named "test1" + +``` +$ podman machine remove test1 + +The following files will be deleted: + +/home/user/.ssh/test1 +/home/user/.ssh/test1.pub +/home/user/.config/containers/podman/machine/qemu/test1.ign +/home/user/.local/share/containers/podman/machine/qemu/test1_fedora-coreos-33.20210315.1.0-qemu.x86_64.qcow2 +/home/user/.config/containers/podman/machine/qemu/test1.json + +Are you sure you want to continue? [y/N] y +``` + +## SEE ALSO +podman-machine (1) + +## HISTORY +March 2021, Originally compiled by Ashley Cui <acui@redhat.com> |