2012-05-14 09:53:54 -04:00
---
2015-04-10 16:17:45 -04:00
layout: doc
2015-10-13 23:31:03 -04:00
title: qvm-block
2018-02-04 18:32:30 -05:00
permalink: /doc/tools/3.2/dom0/qvm-block/
2015-10-11 03:04:59 -04:00
redirect_from:
2018-02-04 18:32:30 -05:00
- /doc/dom0-tools/qvm-block/
- /doc/dom0-tools/qvm-block/
2015-10-28 18:14:40 -04:00
- /en/doc/dom0-tools/qvm-block/
2015-10-11 03:04:59 -04:00
- /doc/Dom0Tools/QvmBlock/
- /wiki/Dom0Tools/QvmBlock/
2012-05-14 09:53:54 -04:00
---
2018-02-11 20:15:10 -05:00
```
=========
2015-05-05 13:24:29 -04:00
qvm-block
=========
NAME
2018-02-11 20:15:10 -05:00
====
2018-03-18 15:46:10 -04:00
qvm-block - list/set VM block devices.
2015-05-05 13:24:29 -04:00
SYNOPSIS
2018-02-11 20:15:10 -05:00
========
| qvm-block -l [options]
| qvm-block -a [options] < vm-name > < device-vm-name > :< device >
| qvm-block -A [options] < vm-name > < file-vm-name > :< file >
| qvm-block -d [options] < device-vm-name > :< device >
| qvm-block -d [options] < vm-name >
2015-05-05 13:24:29 -04:00
OPTIONS
2018-02-11 20:15:10 -05:00
=======
-h, --help
Show this help message and exit
-l, --list
List block devices
-A, --attach-file
Attach specified file instead of physical device
-a, --attach
Attach block device to specified VM
-d, --detach
Detach block device
-f FRONTEND, --frontend=FRONTEND
Specify device name at destination VM [default: xvdi]
--ro
Force read-only mode
--no-auto-detach
Fail when device already connected to other VM
--show-system-disks
List also system disks
--force-root
Force to run, even with root privileges
2015-05-05 13:24:29 -04:00
AUTHORS
2018-02-11 20:15:10 -05:00
=======
| Joanna Rutkowska < joanna at invisiblethingslab dot com >
| Rafal Wojtczuk < rafal at invisiblethingslab dot com >
| Marek Marczykowski < marmarek at invisiblethingslab dot com >
```
2018-02-12 00:37:47 -05:00
-----
2018-03-18 17:04:33 -04:00
**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.
2018-02-12 00:37:47 -05:00
[`qubes-doc`]: https://github.com/QubesOS/qubes-doc/
2018-03-18 17:04:33 -04:00
[`update-manpages-3-2`]: https://github.com/QubesOS/qubesos.github.io/blob/master/_utils/update-manpages-3-2
2018-02-12 00:37:47 -05:00
