[Xen-changelog] [xen master] docs: Add some words describing xen-pvdevice

[patchbot@xxxxxxx]

commit 5743de0269cfec9ad65ce12dce80745fa7b3b669
Author:     Paul Durrant <paul.durrant@xxxxxxxxxx>
AuthorDate: Wed Nov 13 16:09:32 2013 +0000
Commit:     Ian Campbell <ian.campbell@xxxxxxxxxx>
CommitDate: Fri Nov 29 10:29:05 2013 +0000

    docs: Add some words describing xen-pvdevice
    
    This patch adds a short description of xen-pvdevice to
    pci-device-reservations.txt, which contains the canonical list
    of device IDs that may be used to create xen-pvdevice instances.
    
    Signed-off-by: Paul Durrant <paul.durrant@xxxxxxxxxx>
    Acked-by: Ian Campbell <ian.campbell@xxxxxxxxxx>
    [ ijc -- ran expand to de-tabbify ]
---
 docs/misc/pci-device-reservations.txt |   31 +++++++++++++++++++++++++++++--
 1 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/docs/misc/pci-device-reservations.txt 
b/docs/misc/pci-device-reservations.txt
index 19bd9d5..9d6d780 100644
--- a/docs/misc/pci-device-reservations.txt
+++ b/docs/misc/pci-device-reservations.txt
@@ -6,8 +6,8 @@ System (subject to the availability of suitable drivers) to 
make use of
 paravirtualisation features such as disk and network devices etc.
 
 Some Xen vendors wish to provide alternative and/or additional guest drivers
-that can bind to virtual devices. This may be done using the Xen PCI vendor
-ID of 0x5853 and Xen-vendor/device specific PCI device IDs. This file
+that can bind to virtual devices[1]. This may be done using the Xen PCI
+vendor ID of 0x5853 and Xen-vendor/device specific PCI device IDs. This file
 records reservations made within the device ID range in order to avoid
 multiple Xen vendors using conflicting IDs.
 
@@ -29,3 +29,30 @@ Reservations
 0x0002        | Citrix XenServer (grandfathered allocation for XenServer 6.1)
 0xc000-0xc0ff | Citrix XenServer
 0xc100-0xc1ff | Citrix XenClient
+
+[1] Upstream QEMU provides a parameterized device called xen-pvdevice that
+    can be used to host guest drivers. Execute:
+
+    qemu-system-i386 -device xen-pvdevice,help
+
+    for a list of all parameters. The following parameters are relevant to
+    driver binding:
+
+    vendor-id (default 0x5853):     The PCI vendor ID and subsystem vendor
+                                    ID of the device.
+    device-id (must be specified):  The PCI device ID and subsystem device
+                                    ID of the device.
+    revision (default 0x01):        The PCI revision of the device
+
+    Also the size parameter (default 0x400000) can be used to specify the
+    size of the single MMIO BAR that the device exposes. This area may be
+    used by drivers for mapping grant tables, etc.
+
+    Note that the presence of the Xen Platform PCI device is generally a
+    pre-requisite for an additional xen-pvdevice as it is the platform
+    device that provides that IO ports necessary for unplugging emulated
+    devices. See hvm-emulated-unplug.markdown for details of the IO ports
+    and unplug protocol.
+
+    libxl provides support for creation of a single additional xen-pvdevice.
+    See the vendor_device parameter in xl.cfg(5).
--
generated by git-patchbot for /home/xen/git/xen.git#master

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxx
http://lists.xensource.com/xen-changelog