docs: document shortcomings of running QEMU as non-root

Running QEMU as non-root causes migration and PCI passthrough not to
work properly. Migration can be fixed rather easily
(http://marc.info/?l=xen-devel&m=145382864118600), but PCI passthrough
cannot (http://marc.info/?l=xen-devel&m=145286946113964).

Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com>
Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>

diff --git a/docs/man/xl.cfg.pod.5 b/docs/man/xl.cfg.pod.5
index 8899f7568d25c5c3a5d8fbdd209169e76742660d..40690bdcea7cba4f211c8876c37c84f5779723ea 100644 (file)
--- a/docs/man/xl.cfg.pod.5
+++ b/docs/man/xl.cfg.pod.5
@@ -1840,6 +1840,8 @@ option to the device-model.
 
 Run the device model as user "username", instead of
 xen-qemudepriv-domid$domid or xen-qemudepriv-shared or root.
+Please note that running QEMU as non-root causes migration and PCI
+passthrough not to work properly.
 
 =back
 

diff --git a/docs/misc/qemu-deprivilege.txt b/docs/misc/qemu-deprivilege.txt
index dde74ab13571690a3dddc9e7f380efd1f88f69bd..879a98eee615e398c11ce69c099351727e9b3479 100644 (file)
--- a/docs/misc/qemu-deprivilege.txt
+++ b/docs/misc/qemu-deprivilege.txt
@@ -29,3 +29,7 @@ adduser --no-create-home --system xen-qemuuser-shared
 
 3) root
 As a last resort, libxl will start QEMU as root.
+
+
+Please note that running QEMU as non-root causes migration and PCI
+passthrough not to work properly.