From: Wei Liu <wei.liu2@citrix.com>
Date: Mon, 23 May 2016 11:07:20 +0000 (+0100)
Subject: docs: update xl manpage about {block,network}-attach command
X-Git-Tag: archive/raspbian/4.8.0-1+rpi1~1^2~1087
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=8478c9409a2c6726208e8dbc9f3e455b76725a33;p=xen.git

docs: update xl manpage about {block,network}-attach command

State that only attaching PV interface is supported.

Signed-off-by: Wei Liu <wei.liu2@citrix.com>
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
Release-acked-by: Wei Liu <wei.liu2@citrix.com>
---

diff --git a/docs/man/xl.pod.1 b/docs/man/xl.pod.1
index 9887f1b0c9..f4dc32ce8c 100644
--- a/docs/man/xl.pod.1
+++ b/docs/man/xl.pod.1
@@ -1286,6 +1286,10 @@ effect to the guest OS is much the same as any hotplug event.
 Create a new virtual block device.  This will trigger a hotplug event
 for the guest.
 
+Note that only PV block devices are supported by block-attach.
+Requests to attach emulated devices (eg, vdev=hdc) will result in only
+the PV view being available to the guest.
+
 B<OPTIONS>
 
 =over 4
@@ -1369,6 +1373,8 @@ B<vif> string in the domain config file. See L<xl.cfg> and
 L<http://xenbits.xen.org/docs/unstable/misc/xl-network-configuration.html>
 for more informations.
 
+Note that only attaching PV network interface is supported.
+
 =item B<network-detach> I<domain-id> I<devid|mac>
 
 Removes the network device from the domain specified by I<domain-id>.