From: Peter Krempa <pkrempa@redhat.com>
Date: Mon, 18 Mar 2019 07:08:57 +0000 (+0100)
Subject: virsh: man: Document asynchronous behaviour of detach-device-alias
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=61d1abd5f11cadaf2ac7548e1a42e112bc49ed7e;p=libvirt.git

virsh: man: Document asynchronous behaviour of detach-device-alias

This command is fully async. Note that users can use virsh event to be
notified of the guest actually removing the device.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Erik Skultety <eskultet@redhat.com>
---

diff --git a/tools/virsh.pod b/tools/virsh.pod
index cad6b6bdf3..db72343159 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -3290,7 +3290,10 @@ I<--persistent>.
 =item B<detach-device-alias> I<domain> I<alias>
 [[[I<--live>] [I<--config>] | [I<--current>]]]]
 
-Detach a device with given I<alias> from the I<domain>.
+Detach a device with given I<alias> from the I<domain>. This command returns
+successfully after the unplug request was sent to the hypervisor. The actual
+removal of the device is notified asynchronously via libvirt events
+(see virsh event).
 
 If I<--live> is specified, affect a running domain.
 If I<--config> is specified, affect the next startup of a persistent domain.