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> + ...
hostdev
hostdev
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..
source
vendor
and product
elements or by the device's
- address on the hosts using the address
element.vendor
, product
vendor
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
+ address
vendor
, product
vendor
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.address
address
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
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.
- 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> + ...
hostdev
hostdev
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..
source
vendor
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
, product
vendor
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.address
address
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.