Wojciech Zygmunt Porczyk 42d8e67556 doc: Add autogenerated qubes.xml documentation há 9 anos atrás
..
_static 6df316378b doc: Fix docutils table column width há 9 anos atrás
_templates 6df316378b doc: Fix docutils table column width há 9 anos atrás
qubes-tools 2835238a87 doc: manpage formatting há 9 anos atrás
qubes-vm 56092073e9 doc: add hyphens to module page titles há 9 anos atrás
qvm-tools 2835238a87 doc: manpage formatting há 9 anos atrás
.gitignore 42d8e67556 doc: Add autogenerated qubes.xml documentation há 9 anos atrás
Makefile 42d8e67556 doc: Add autogenerated qubes.xml documentation há 9 anos atrás
README.pvusb 20b3fdedb8 rename netvm -> sys-net, firewallvm -> sys-firewall há 9 anos atrás
conf.py 41fef46db2 core3 move: QubesVM há 9 anos atrás
example.xml 42d8e67556 doc: Add autogenerated qubes.xml documentation há 9 anos atrás
index.rst 42d8e67556 doc: Add autogenerated qubes.xml documentation há 9 anos atrás
qubes-dochelpers.rst 56092073e9 doc: add hyphens to module page titles há 9 anos atrás
qubes-events.rst 0a94762508 doc: Tutorial for qubes.events and fix há 9 anos atrás
qubes-ext.rst 56092073e9 doc: add hyphens to module page titles há 9 anos atrás
qubes-log.rst 56092073e9 doc: add hyphens to module page titles há 9 anos atrás
qubes-plugins.rst 56092073e9 doc: add hyphens to module page titles há 9 anos atrás
qubes-tests.rst b442fb0fab qubes/doc: Test's documentation improvement há 9 anos atrás
qubes.rst 56092073e9 doc: add hyphens to module page titles há 9 anos atrás

README.pvusb

Dedicated usbvm (optional)
~~~~~~~~~~~~~~~~~~~~~~~~~~

In dom0, once:
qvm-create -l red usbvm

# FIXME: use your own PCI device IDs
qvm-pci -a usbvm 00:1d.0
qvm-pci -a usbvm 00:1d.1
qvm-pci -a usbvm 00:1d.2
qvm-pci -a usbvm 00:1d.7

After each dom0 reboot:
qvm-start usbvm

List
~~~~

In dom0:
qvm-usb -l

Example output:
dom0:7-4 0718:061a TDKMedia_Trans-It_Drive_070326AE8AF92D95 (attached to qdvp:0-1)
dom0:7-5 0b05:1706 ASUS_802.11g_WLAN_Drive (attached to sys-net:0-1)
dom0:1-1 045e:0084 Microsoft_Basic_Optical_Mouse
usbvm:4-6 05e3:0723 Generic_USB_Storage (attached to qdvp:1-1)

Attach
~~~~~~

In dom0:
qvm-usb -a [--no-auto-detach] :-

Example:
qvm-usb -a sys-net usbvm:4-1

Detach
~~~~~~

In dom0:
qvm-usb -d :-

Example:
qvm-usb -d sys-net:0-1

Known issues
~~~~~~~~~~~~

List/attach/detach operations seem to work ok, devices are recognized by the target VM etc.
But actual usage of the attached devices is unstable at best. In fact the only working device
I saw was one USB stick (and this only after it took a minute to time out and reset the bus
couple times). Kernel crashes are normal as well. I have not investigated these issues yet,
I had similar experience with Marek's scripts.

* System keyboard / mouse are listed and can be detached away
* Virtual USB devices (ones created by PVUSB frontend) may be listed
* The installation/configuration is not persistent, not retained between reboots
* No debugging / logging / audit trail
* When an attached device is physically unplugged, USB port remains mapped but not displayed
in the list. If device is plugged back it continues to work. Unlisted device cannot be detached.
* We are not attaching actual devices, but USB ports (different behavior from VMWare, might be confusing)
* After device is detached from the frontend and returned back to the backend it is not alwayws usable there
* Code changing configuration of pvusb fe/be and vusb bind/unbind helper are located
misc/xl-qvm-usb-attach.py misc/xl-qvm-usb-detach.py misc/vusb-ctl.py. These helpers are
deployed into the backend domain. The initialization code is qubesutils.py in usb_setup(),
should probably also be moved into an external helper. Perhaps the functionality of these
external helpers should be merged into libxl? The is one catch is invokation of vusb helper
in the backend domain -- now it relies on qubes-specific API.
* After reboot attached USB devices are not listed by 'qvm-usb -l' until replugged.