opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-07-15 03:02:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add podman machine list

Browse Source 
podman machine list lists all virtual machines & indicates the default VM
connection, if it exists. it also can take a --format flag arg as a go
template.

[NO TESTS NEEDED]

Signed-off-by: Ashley Cui <acui@redhat.com>
This commit is contained in:
Ashley Cui
2021-03-30 02:30:28 -04:00
parent 5e28b35aa5
commit ef4e91a59e
7 changed files with 262 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/source/machine.rst
View File

@ -3,6 +3,7 @@ Machine
:doc:`init <markdown/podman-machine-init.1>` Initialize a new virtual machine
:doc:`list <markdown/podman-machine-list.1>` List virtual machines
:doc:`rm <markdown/podman-machine-rm.1>` Remove a virtual machine
:doc:`ssh <markdown/podman-machine-ssh.1>` SSH into a virtual machine
:doc:`start <markdown/podman-machine-start.1>` Start a virtual machine

1
docs/source/markdown/links/podman-machine-ls.1 Normal file
View File

@ -0,0 +1 @@
.so man1/podman-machine-list.1

50
docs/source/markdown/podman-machine-list.1.md Normal file
View File

@ -0,0 +1,50 @@
% podman-machine-ls(1)
## NAME
podman\-machine\-list - List virtual machines
## SYNOPSIS
**podman machine list** [*options*]
**podman machine ls** [*options*]
## DESCRIPTION
List Podman managed virtual machines.
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 is
tied to the Linux kernel.
## OPTIONS
#### **\-\-format**=*format*
Format list output using a Go template.
Valid placeholders for the Go template are listed below:
| **Placeholder** | **Description** |
| --------------- | ------------------------------- |
| .Name | VM name |
| .Created | Time since VM creation |
| .LastUp | Time since the VM was last run |
| .VMType | VM type |
#### **\-\-help**
Print usage statement.
## EXAMPLES
```
$ podman machine list
$ podman machine ls --format {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}\n
```
## SEE ALSO
podman-machine(1)
## HISTORY
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>

11
docs/source/markdown/podman-machine.1.md
View File

@ -14,13 +14,14 @@ podman\-machine - Manage Podman's virtual machine
| Command | Man Page | Description |
| ------- | ------------------------------------------------------- | --------------------------------- |
| init | [podman-machine-init(1)](podman-machine-init.1.md) | Initialize a new virtual machine |
| rm | [podman-machine-rm(1)](podman-machine-rm.1.md)| Remove a virtual machine |
| 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 |
| list | [podman-machine-list(1)](podman-machine-list.1.md) | List virtual machines |
| rm | [podman-machine-rm(1)](podman-machine-rm.1.md) | Remove a virtual machine |
| 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), podman-machine-init(1), podman-machine-list(1), podman-machine-rm(1), podman-machine-ssh(1), podman-machine-start(1), podman-machine-stop(1)
## HISTORY
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>