Index: docs/formatdomain.html =================================================================== RCS file: /data/cvs/libxen/docs/formatdomain.html,v retrieving revision 1.16 diff -u -r1.16 formatdomain.html --- docs/formatdomain.html 6 Jan 2009 08:48:48 -0000 1.16 +++ docs/formatdomain.html 12 Jan 2009 10:23:02 -0000 @@ -140,7 +140,7 @@
- USB devices attached to the host can be passed through to the guest using
- the hostdev element. since after 0.4.4
+ USB and PCI devices attached to the host can be passed through to the guest using
+ the hostdev element. since after
+ 0.4.4 for USB and 0.6.0 for PCI (KVM only):
...
@@ -479,20 +480,38 @@
</source>
</hostdev>
...
+ or:
++ ... + <hostdev mode='subsystem' type='pci'> + <source> + <address>bus='0x06' slot='0x02' function='0x0'</address> + </source> + </hostdev> + ...
hostdevhostdev element is the main container for describing
host devices. For usb device passthrough mode is always
- "subsystem" and type is "usb".
+ "subsystem" and type is "usb" for an USB device and "pci"
+ for a PCI device..
sourcevendor and product elements or by the device's
- address on the hosts using the address element.vendor, productvendor and product elements each have an
+ address on the hosts using the address element.
+ PCI devices on the other hand can only be described by their
+ addressvendor, productvendor and product elements each have an
id attribute that specifies the USB vendor and product id.
The ids can be given in decimal, hexadecimal (starting with 0x) or
- octal (starting with 0) form.addressaddress element has a bus and
- device attribute to specify the USB bus and device number
- the device appears at on the host. The values of these attributes can
- be given in decimal, hexadecimal (starting with 0x) or octal (starting
- with 0) form.addressaddress element for USB devices has a
+ bus and device attribute to specify the
+ USB bus and device number the device appears at on the host.
+ The values of these attributes can be given in decimal, hexadecimal
+ (starting with 0x) or octal (starting with 0) form.
+ For PCI devices the element carries 3 attributes allowing to designate
+ the device as can be found with the lspci command, the
+ bus attribute allows the hexadecimal values 0 to ff, the
+ slot attribute allows the hexadecimal values 0 to 1f, and
+ the function attribute allows the hexadecimal values 0 to
+ 7.
- USB devices attached to the host can be passed through to the guest using
- the hostdev element. since after 0.4.4
+ USB and PCI devices attached to the host can be passed through to the guest using
+ the hostdev element. since after
+ 0.4.4 for USB and 0.6.0 for PCI (KVM only):
@@ -391,28 +392,46 @@ </source> </hostdev> ...+
or:
++ ... + <hostdev mode='subsystem' type='pci'> + <source> + <address>bus='0x06' slot='0x02' function='0x0'</address> + </source> + </hostdev> + ...
hostdevhostdev element is the main container for describing
host devices. For usb device passthrough mode is always
- "subsystem" and type is "usb".
+ "subsystem" and type is "usb" for an USB device and "pci"
+ for a PCI device..
sourcevendor and product elements or by the device's
- address on the hosts using the address element.address element.
+ PCI devices on the other hand can only be described by their
+ address
vendor, productvendor and product elements each have an
id attribute that specifies the USB vendor and product id.
The ids can be given in decimal, hexadecimal (starting with 0x) or
octal (starting with 0) form.addressaddress element has a bus and
- device attribute to specify the USB bus and device number
- the device appears at on the host. The values of these attributes can
- be given in decimal, hexadecimal (starting with 0x) or octal (starting
- with 0) form.address element for USB devices has a
+ bus and device attribute to specify the
+ USB bus and device number the device appears at on the host.
+ The values of these attributes can be given in decimal, hexadecimal
+ (starting with 0x) or octal (starting with 0) form.
+ For PCI devices the element carries 3 attributes allowing to designate
+ the device as can be found with the lspci command, the
+ bus attribute allows the hexadecimal values 0 to ff, the
+ slot attribute allows the hexadecimal values 0 to 1f, and
+ the function attribute allows the hexadecimal values 0 to
+ 7.