qubes-doc/reference/tools/3.2/dom0/qvm-ls.md

---
layout: doc
title: qvm-ls
permalink: /doc/tools/3.2/dom0/qvm-ls/
redirect_from:
- /doc/dom0-tools/qvm-ls/
- /en/doc/dom0-tools/qvm-ls/
- /doc/Dom0Tools/QvmLs/
- /wiki/Dom0Tools/QvmLs/
---

```
======
qvm-ls
======

NAME
====
qvm-ls - list VMs and various information about their state

SYNOPSIS
========
| qvm-ls [options] <vm-name>

OPTIONS
=======
-h, --help
    Show help message and exit
-n, --network
    Show network addresses assigned to VMs
-c, --cpu
    Show CPU load
-m, --mem
    Show memory usage
-d, --disk
    Show VM disk utilization statistics
-i, --ids
    Show Qubes and Xen id
-k, --kernel
    Show VM kernel options
-b, --last-backup
    Show date of last VM backup
--raw-list
    List only VM names one per line
--raw-data
    Display specify data of specified VMs. Intended for bash-parsing.
--list-fields
    List field names valid for --raw-data

AUTHORS
=======
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
```

-----

**Note:** The Markdown source of this page in [`qubes-doc`] was generated by running the [`update-manpages-3-2`] script on `qubes-core-admin/doc/qvm-tools/`.
If you wish to update the contents of this page as it appears on the Qubes OS website, please submit a pull request to change the appropriate file in `qubes-core-admin/doc/qvm-tools/`.
Do not attempt to change the Markdown source of this page in [`qubes-doc`] directly.
All direct changes to the Markdown file will be overwritten the next time this page is regenerated.

[`qubes-doc`]: https://github.com/QubesOS/qubes-doc/
[`update-manpages-3-2`]: https://github.com/QubesOS/qubesos.github.io/blob/master/_utils/update-manpages-3-2