From 26e7f72a2034a86d24e5a6cb84c2a6858b9674c1 Mon Sep 17 00:00:00 2001 From: WillyPillow Date: Sat, 23 May 2020 23:56:50 +0800 Subject: [PATCH 1/3] Move the requirement for a USB qube to be more visible. --- user/common-tasks/usb-devices.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/user/common-tasks/usb-devices.md b/user/common-tasks/usb-devices.md index 8882f2e2..6204f16e 100644 --- a/user/common-tasks/usb-devices.md +++ b/user/common-tasks/usb-devices.md @@ -12,6 +12,8 @@ redirect_from: If you are looking to handle USB *storage* devices (thumbdrives or USB-drives), please have a look at the [block device] page. +**Note:** you cannot pass through devices from dom0 (in other words: a [USB qube][USB-qube howto] is required). + **Important security warning:** USB passthrough comes with many security implications. Please make sure you carefully read and understand the **[security considerations]**. Whenever possible, attach a [block device] instead. @@ -98,7 +100,6 @@ This section exists for reference or in case something broke and you need to rei Under normal conditions, `qubes-usb-proxy` should already be installed and good to go. If you receive this error: `ERROR: qubes-usb-proxy not installed in the VM`, you can install the `qubes-usb-proxy` with the package manager in the VM you want to attach the USB device to. -Note: you cannot pass through devices from dom0 (in other words: a [USB qube][USB-qube howto] is required). `qubes-usb-proxy` should be installed by default in the template VM. - Fedora: `sudo dnf install qubes-usb-proxy` From 384b60c657548703dc3d32ce91f0b9d6ebf04a6a Mon Sep 17 00:00:00 2001 From: WillyPillow Date: Sat, 23 May 2020 23:58:16 +0800 Subject: [PATCH 2/3] Remove duplicate sentence re. qubes-usb-proxy being installed by default. --- user/common-tasks/usb-devices.md | 1 - 1 file changed, 1 deletion(-) diff --git a/user/common-tasks/usb-devices.md b/user/common-tasks/usb-devices.md index 6204f16e..a676c2a4 100644 --- a/user/common-tasks/usb-devices.md +++ b/user/common-tasks/usb-devices.md @@ -100,7 +100,6 @@ This section exists for reference or in case something broke and you need to rei Under normal conditions, `qubes-usb-proxy` should already be installed and good to go. If you receive this error: `ERROR: qubes-usb-proxy not installed in the VM`, you can install the `qubes-usb-proxy` with the package manager in the VM you want to attach the USB device to. -`qubes-usb-proxy` should be installed by default in the template VM. - Fedora: `sudo dnf install qubes-usb-proxy` - Debian/Ubuntu: `sudo apt-get install qubes-usb-proxy` From af50164e66cfe4aa738bf010a3797d64df031078 Mon Sep 17 00:00:00 2001 From: WillyPillow Date: Tue, 26 May 2020 01:54:15 +0800 Subject: [PATCH 3/3] Rephrase the requirement for a USB qube. --- user/common-tasks/usb-devices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/common-tasks/usb-devices.md b/user/common-tasks/usb-devices.md index a676c2a4..cef9db0b 100644 --- a/user/common-tasks/usb-devices.md +++ b/user/common-tasks/usb-devices.md @@ -12,7 +12,7 @@ redirect_from: If you are looking to handle USB *storage* devices (thumbdrives or USB-drives), please have a look at the [block device] page. -**Note:** you cannot pass through devices from dom0 (in other words: a [USB qube][USB-qube howto] is required). +**Note:** Attaching USB devices to VMs requires a [USB qube][USB-qube howto]. **Important security warning:** USB passthrough comes with many security implications. Please make sure you carefully read and understand the **[security considerations]**.