github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-machine-list.1.md (about)

     1  % podman-machine-ls(1)
     2  
     3  ## NAME
     4  podman\-machine\-list - List virtual machines
     5  
     6  ## SYNOPSIS
     7  **podman machine list** [*options*]
     8  
     9  **podman machine ls** [*options*]
    10  
    11  ## DESCRIPTION
    12  
    13  List Podman managed virtual machines.
    14  
    15  Podman on macOS requires a virtual machine. This is because containers are Linux -
    16  containers do not run on any other OS because containers' core functionality is
    17  tied to the Linux kernel.
    18  
    19  ## OPTIONS
    20  
    21  #### **--format**=*format*
    22  
    23  Change the default output format.  This can be of a supported type like 'json'
    24  or a Go template.
    25  Valid placeholders for the Go template are listed below:
    26  
    27  | **Placeholder** | **Description**                 |
    28  | --------------- | ------------------------------- |
    29  | .CPUs           | Number of CPUs                  |
    30  | .Created        | Time since VM creation          |
    31  | .Default        | Is default machine              |
    32  | .DiskSize       | Disk size of machine            |
    33  | .LastUp         | Time machine was last up        |
    34  | .LastUp         | Time since the VM was last run  |
    35  | .Memory         | Allocated memory for machine   |
    36  | .Name           | VM name                         |
    37  | .Running        | Is machine running              |
    38  | .Stream         | Stream name                     |
    39  | .VMType         | VM type                         |
    40  | .Port           | SSH Port to use to connect to VM|
    41  | .RemoteUsername | VM Username for rootless Podman |
    42  | .IdentityPath   | Path to ssh identity file       |
    43  
    44  #### **--help**
    45  
    46  Print usage statement.
    47  
    48  #### **--noheading**
    49  
    50  Omit the table headings from the listing of machines
    51  
    52  #### **--quiet**, **-q**
    53  
    54  Only print the name of the machine. This also implies no table heading
    55  is printed.
    56  
    57  ## EXAMPLES
    58  
    59  ```
    60  $ podman machine list
    61  NAME                    VM TYPE     CREATED      LAST UP      CPUS        MEMORY      DISK SIZE
    62  podman-machine-default  qemu        2 weeks ago  2 weeks ago  1           2.147GB     10.74GB
    63  
    64  $ podman machine ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}"
    65  NAME                    VM TYPE     CREATED      LAST UP
    66  podman-machine-default  qemu        2 weeks ago  2 weeks ago
    67  
    68  $ podman machine ls --format json
    69  [
    70      {
    71          "Name": "podman-machine-default",
    72          "Default": false,
    73          "Created": "2021-12-27T10:36:14.373347492-05:00",
    74          "Running": false,
    75          "LastUp": "2021-12-27T11:22:50.17333371-05:00",
    76          "Stream": "default",
    77          "VMType": "qemu",
    78          "CPUs": 1,
    79          "Memory": "2147483648",
    80          "DiskSize": "10737418240"
    81      }
    82  ]
    83  ```
    84  
    85  ## SEE ALSO
    86  **[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**
    87  
    88  ## HISTORY
    89  March 2021, Originally compiled by Ashley Cui <acui@redhat.com>