Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-03-01 11:21:20 -05:00
Code Issues Packages Projects Releases Wiki Activity

AssigningDevices changed

Browse Source 
Minor spelling/typo corrections
This commit is contained in:
Joanna Rutkowska 2013-02-20 09:22:46 +00:00
parent 27687d256f
commit 5ebcf0eb27
1 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
AssigningDevices.md
View File

@ -4,7 +4,10 @@ title: AssigningDevices
permalink: /wiki/AssigningDevices/ permalink: /wiki/AssigningDevices/
--- ---
In order to assign a whole PCI/e device to a VM one should use ```qvm-pci``` tool. E.g. Assigning Devices to VMs
========================
In order to assign a whole PCI(e) device to a VM, one should use `qvm-pci` tool. E.g.
``` {.wiki} ``` {.wiki}
lspci lspci
@ -16,7 +19,7 @@ Find the BDF address of the device you want to assign, and then:
qvm-pci -a <vmname> <bdf> qvm-pci -a <vmname> <bdf>
``` ```
E.g. assuming 00:1a.0 is a BDF of the device I want to assign to "personal" domain: E.g. assuming 00:1a.0 is a BDF of the device I want to assign to the "personal" domain:
``` {.wiki} ``` {.wiki}
qvm-pci -a personal 00:1a.0 qvm-pci -a personal 00:1a.0
@ -31,22 +34,22 @@ TODO
\<screenshot\> \<screenshot\>
Finding right USB controller Finding the right USB controller
---------------------------- --------------------------------
If you want assign certain USB device to VM (by attaching whole USB controller), you need to figure out which PCI device is the right controller. First check to which USB bus device is connected: If you want assign certain USB device to a VM (by attaching a whole USB controller), you need to figure out which PCI device is the right controller. First check to which USB bus the device is connected:
``` {.wiki} ``` {.wiki}
lsusb lsusb
``` ```
For example I want assign broadband modem to netvm. In lsusb output it can be something like (in this case device isn't fully identified): For example I want assign a broadband modem to the netvm. In lsusb output it can be listed as something like this (in this case device isn't fully identified):
``` {.wiki} ``` {.wiki}
Bus 003 Device 003: ID 413c:818d Dell Computer Corp. Bus 003 Device 003: ID 413c:818d Dell Computer Corp.
``` ```
The device is connected to USB bus 3. Then check which other devices are connected to the same bus - all of them will be assigned to the same VM. Now is the time to find right USB controller: The device is connected to the USB bus \#3. Then check which other devices are connected to the same bus - all of them will be assigned to the same VM. Now is the time to find right USB controller:
``` {.wiki} ``` {.wiki}
readlink /sys/bus/usb/devices/usb3 readlink /sys/bus/usb/devices/usb3
@ -67,7 +70,7 @@ qvm-pci -a netvm 00:1a.0
Possible issues Possible issues
--------------- ---------------
VM with PCI device in Qubes have allocated small buffer for DMA operations (called swiotlb). By default it is 2MB, but some devices needs a larger space. To change this allocation, edit VM kernel parameters (this is expressed in 512B chunks): VMs with assigned PCI devices in Qubes have allocated a small buffer for DMA operations (called swiotlb). By default it is 2MB, but some devices need a larger buffer. To change this allocation, edit VM's kernel parameters (this is expressed in 512B chunks):
``` {.wiki} ``` {.wiki}
# qvm-prefs netvm |grep kernelopts # qvm-prefs netvm |grep kernelopts
@ -75,4 +78,4 @@ kernelopts : iommu=soft swiotlb=2048 (default)
# qvm-prefs -s netvm kernelopts "iommu=soft swiotlb=4096" # qvm-prefs -s netvm kernelopts "iommu=soft swiotlb=4096"
``` ```
This is [​know to be needed](https://groups.google.com/group/qubes-devel/browse_thread/thread/631c4a3a9d1186e3) for Realtek RTL8111DL Gigabit Ethernet Controller. This is [​known to be needed](https://groups.google.com/group/qubes-devel/browse_thread/thread/631c4a3a9d1186e3) for Realtek RTL8111DL Gigabit Ethernet Controller.