summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-machine-list.1.md
blob: cad7e614bbd9302521af3dccff48c334c6bf476e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
% 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.

#### **--noheading**

Omit the table headings from the listing of pods.

## 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>