89 lines
1.9 KiB
ReStructuredText
89 lines
1.9 KiB
ReStructuredText
|
.. program:: qvm-device
|
||
|
|
||
|
=============================================
|
||
|
:program:`qvm-device` -- List/set VM devices
|
||
|
=============================================
|
||
|
|
||
|
Synopsis
|
||
|
========
|
||
|
| :command:`qvm-device` [*options*] *DEVICE_CLASS* {list,ls,l} <*vm-name*>
|
||
|
| :command:`qvm-device` [*options*] *DEVICE_CLASS* {attach,at,a} <*vm-name*> <*device*>
|
||
|
| :command:`qvm-device` [*options*] *DEVICE_CLASS* {detach,dt,d} <*vm-name*> <*device*>
|
||
|
|
||
|
Options
|
||
|
=======
|
||
|
|
||
|
.. option:: --help, -h
|
||
|
|
||
|
Show this help message and exit
|
||
|
|
||
|
.. option:: --verbose, -v
|
||
|
|
||
|
increase verbosity
|
||
|
|
||
|
.. option:: --quiet, -q
|
||
|
|
||
|
decrease verbosity
|
||
|
|
||
|
Commands
|
||
|
========
|
||
|
|
||
|
list
|
||
|
^^^^
|
||
|
|
||
|
| :command:`qvm-device` *DEVICE_CLASS* list [-h] [--verbose] [--quiet] [*VMNAME* [*VMNAME* ...]]
|
||
|
|
||
|
List devices.
|
||
|
|
||
|
.. option:: --all
|
||
|
|
||
|
List devices from all qubes. You can use :option:`--exclude` to limit the
|
||
|
qubes set.
|
||
|
|
||
|
.. option:: --exclude
|
||
|
|
||
|
Exclude the qube from :option:`--all`.
|
||
|
|
||
|
aliases: ls, l
|
||
|
|
||
|
attach
|
||
|
^^^^^^
|
||
|
|
||
|
| :command:`qvm-volume attach` [-h] [--verbose] [--quiet] [--ro] *VMNAME* *BACKEND_DOMAIN:DEVICE_ID*
|
||
|
|
||
|
Attach the device with *DEVICE_ID* from *BACKEND_DOMAIN* to the domain *VMNAME*
|
||
|
|
||
|
.. option:: --option, -o
|
||
|
|
||
|
Specify device-class specific option, use `name=value` format. You can
|
||
|
specify this option multiple times.
|
||
|
|
||
|
.. option:: --persistent, -p
|
||
|
|
||
|
Attach device persistently, which means have it attached also after qube restart.
|
||
|
|
||
|
aliases: a, at
|
||
|
|
||
|
detach
|
||
|
^^^^^^
|
||
|
|
||
|
| :command:`qvm-volume detach` [-h] [--verbose] [--quiet] *VMNAME* *BACKEND_DOMAIN:DEVICE_ID*
|
||
|
|
||
|
Detach the device with *BACKEND_DOMAIN:DEVICE_ID* from domain *VMNAME*
|
||
|
|
||
|
aliases: d, dt
|
||
|
|
||
|
|
||
|
Device classes
|
||
|
==============
|
||
|
|
||
|
* block - block devices
|
||
|
* usb - USB devices
|
||
|
* pci - PCI devices
|
||
|
|
||
|
Authors
|
||
|
=======
|
||
|
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
|
||
|
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
|
||
|
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
|