qubes-doc/developers/building/pvusb.md

---
layout: doc
title: PVUSB
permalink: /doc/pvusb/
---

USB Pass through: USBVM
-----------------------

**WARNING:** This is experimental and very broken.

Source: [https://groups.google.com/d/msg/qubes-devel/4AKulABh2Jc/\_R7SRSC4peYJ](https://groups.google.com/d/msg/qubes-devel/4AKulABh2Jc/_R7SRSC4peYJ)

You'll need the patch tagged abb\_e58b432 from [git://github.com/grwl/qubes-core.git](git://github.com/grwl/qubes-core.git).

The rest is in RPMs, yes. I roughly follow this procedure to have pvusb on Qubes 1.0:

-   rebuild kernel, core, and xen from marmarek's repo (devel-3.4 branch for kernel),
-   make dedicated usbvm domain, passthrough USB controller PCI devices there
-   in usbvm: "rpm -Uhv qubes-core-vm-2.1.1-1.fc17.x86\_64.rpm xen-libs-2000:4.1.3-18.fc17.x86\_64.rpm xen-qubes-vm-essentials-2000:4.1.3-18.fc17.x86\_64.rpm"
-   in appvm where you want to attach the device to: "rpm -Uhv qubes-core-vm-2.1.1-1.fc17.x86\_64.rpm"
-   in dom0 I think the following packages need to be updated, don't have exact list now.qubes-core-dom0 is actually important, the rest are dependencies:

> kernel-qubes-vm-3.4.18-1.pvops.qubes.x86\_64.rpm
>  qubes-core-dom0-2.1.1-1.fc13.x86\_64.rpm
>  xen-4.1.3-18.fc13.x86\_64.rpm
>  xen-hvm-4.1.3gui2.0.9-18.fc13.x86\_64.rpm
>  xen-hypervisor-4.1.3-18.fc13.x86\_64.rpm
>  xen-libs-4.1.3-18.fc13.x86\_64.rpm
>  xen-licenses-4.1.3-18.fc13.x86\_64.rpm
>  xen-runtime-4.1.3-18.fc13.x86\_64.rpm

-   plug or replug some USB device -- it will be picked up by usbvm, and in dom0 it will appear in the output of qvm-usb
USBVM changed rough instructions for building USBVM support 2012-11-21 03:44:54 -05:00			`---`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`layout: doc`
Reorganize USB-related information This commit creates a single, central page (/doc/usb/) for all USB-related information by combining stick-mounting.md with the manual USB qube (formerly known as "USBVM") creation procedure from security-guidelines.md. It rewrites the content from both of those and adds the content requested in QubesOS/qubes-issues#1690. It also redirects /doc/usbvm/ away from the ancient page on PVUSB. 2016-01-28 07:02:39 -05:00			`title: PVUSB`
			`permalink: /doc/pvusb/`
USBVM changed rough instructions for building USBVM support 2012-11-21 03:44:54 -05:00			`---`

			`USB Pass through: USBVM`
			`-----------------------`

USBVM changed add warning 2012-11-21 03:46:51 -05:00			`WARNING: This is experimental and very broken.`

Remove zero-width spaces (U+200B) left by trac 2015-05-08 09:17:21 -04:00			`Source: [https://groups.google.com/d/msg/qubes-devel/4AKulABh2Jc/\_R7SRSC4peYJ](https://groups.google.com/d/msg/qubes-devel/4AKulABh2Jc/_R7SRSC4peYJ)`
USBVM changed rough instructions for building USBVM support 2012-11-21 03:44:54 -05:00
Remove zero-width spaces (U+200B) left by trac 2015-05-08 09:17:21 -04:00			`You'll need the patch tagged abb\_e58b432 from [git://github.com/grwl/qubes-core.git](git://github.com/grwl/qubes-core.git).`
USBVM changed rough instructions for building USBVM support 2012-11-21 03:44:54 -05:00
			`The rest is in RPMs, yes. I roughly follow this procedure to have pvusb on Qubes 1.0:`

			`- rebuild kernel, core, and xen from marmarek's repo (devel-3.4 branch for kernel),`
			`- make dedicated usbvm domain, passthrough USB controller PCI devices there`
			`- in usbvm: "rpm -Uhv qubes-core-vm-2.1.1-1.fc17.x86\_64.rpm xen-libs-2000:4.1.3-18.fc17.x86\_64.rpm xen-qubes-vm-essentials-2000:4.1.3-18.fc17.x86\_64.rpm"`
			`- in appvm where you want to attach the device to: "rpm -Uhv qubes-core-vm-2.1.1-1.fc17.x86\_64.rpm"`
			`- in dom0 I think the following packages need to be updated, don't have exact list now.qubes-core-dom0 is actually important, the rest are dependencies:`

			`> kernel-qubes-vm-3.4.18-1.pvops.qubes.x86\_64.rpm`
			`> qubes-core-dom0-2.1.1-1.fc13.x86\_64.rpm`
			`> xen-4.1.3-18.fc13.x86\_64.rpm`
			`> xen-hvm-4.1.3gui2.0.9-18.fc13.x86\_64.rpm`
			`> xen-hypervisor-4.1.3-18.fc13.x86\_64.rpm`
			`> xen-libs-4.1.3-18.fc13.x86\_64.rpm`
			`> xen-licenses-4.1.3-18.fc13.x86\_64.rpm`
			`> xen-runtime-4.1.3-18.fc13.x86\_64.rpm`

			`- plug or replug some USB device -- it will be picked up by usbvm, and in dom0 it will appear in the output of qvm-usb`