From f5bf427cd3f237a5d52549431bad79c0463a688d Mon Sep 17 00:00:00 2001 From: Keir Fraser Date: Thu, 8 Jan 2009 11:27:11 +0000 Subject: passthough: MSI-INTx translation documentation Signed-off-by: Qing He --- tools/examples/xmexample.hvm | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) (limited to 'tools/examples/xmexample.hvm') diff --git a/tools/examples/xmexample.hvm b/tools/examples/xmexample.hvm index aa014b529b..b4d849f72f 100644 --- a/tools/examples/xmexample.hvm +++ b/tools/examples/xmexample.hvm @@ -288,6 +288,39 @@ serial='pty' # 'x' -> we don't care (do not check) # 's' -> the bit must be the same as on the host that started this VM +#----------------------------------------------------------------------------- +# Configure passthrough PCI{,-X,e} devices: +# +# pci=[ '[SSSS:]BB:DD.F[,option1[,option2[...]]]', ... ] +# +# [SSSS]:BB:DD.F "bus segment:bus:device.function"(1) of the device to +# be assigned, bus segment is optional. All fields are +# in hexadecimal and no field should be longer than that +# as shown in the pattern. Successful assignment may need +# certain hardware support and additional configurations +# (e.g. VT-d, see docs/misc/vtd.txt for more details). +# +# (1) bus segment is sometimes also referred to as the PCI "domain", +# not to be confused with Xen domain. +# +# +# optionN per-device options in "key=val" format. Current +# available options are: +# - msitranslate=0|1 +# per-device overriden of pci_msitranslate, see below +# +#pci=[ '07:00.0', '07:00.1' ] + +# MSI-INTx translation for MSI capable devices: +# +# If it's set, Xen will enable MSI for the device that supports it even +# if the guest don't use MSI. In the case, an IO-APIC type interrupt will +# be injected to the guest every time a corresponding MSI message is +# received. +# If the guest enables MSI or MSI-X, the translation is automatically +# turned off. +# +#pci_msitranslate=1 #----------------------------------------------------------------------------- # Configure PVSCSI devices: -- cgit v1.2.3