2012-05-14 13:53:54 +00:00
---
2015-04-10 20:17:45 +00:00
layout: doc
2015-10-14 03:31:03 +00:00
title: qvm-block
2018-02-04 17:32:30 -06:00
permalink: /doc/tools/3.2/dom0/qvm-block/
2015-10-11 07:04:59 +00:00
redirect_from:
2018-02-04 17:32:30 -06:00
- /doc/dom0-tools/qvm-block/
- /doc/dom0-tools/qvm-block/
2015-10-28 22:14:40 +00:00
- /en/doc/dom0-tools/qvm-block/
2015-10-11 07:04:59 +00:00
- /doc/Dom0Tools/QvmBlock/
- /wiki/Dom0Tools/QvmBlock/
2012-05-14 13:53:54 +00:00
---
2018-02-11 19:15:10 -06:00
```
=========
2015-05-05 17:24:29 +00:00
qvm-block
=========
NAME
2018-02-11 19:15:10 -06:00
====
2018-03-18 14:46:10 -05:00
qvm-block - list/set VM block devices.
2015-05-05 17:24:29 +00:00
SYNOPSIS
2018-02-11 19:15:10 -06: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 17:24:29 +00:00
OPTIONS
2018-02-11 19:15:10 -06: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 17:24:29 +00:00
AUTHORS
2018-02-11 19:15:10 -06:00
=======
| Joanna Rutkowska < joanna at invisiblethingslab dot com >
| Rafal Wojtczuk < rafal at invisiblethingslab dot com >
| Marek Marczykowski < marmarek at invisiblethingslab dot com >
```
2018-02-11 23:37:47 -06:00
-----
2018-03-18 16:04:33 -05: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-11 23:37:47 -06:00
[`qubes-doc` ]: https://github.com/QubesOS/qubes-doc/
2018-03-18 16:04:33 -05:00
[`update-manpages-3-2` ]: https://github.com/QubesOS/qubesos.github.io/blob/master/_utils/update-manpages-3-2
2018-02-11 23:37:47 -06:00
