From 61d1abd5f11cadaf2ac7548e1a42e112bc49ed7e Mon Sep 17 00:00:00 2001
From: Peter Krempa <pkrempa@redhat.com>
Date: Mon, 18 Mar 2019 08:08:57 +0100
Subject: [PATCH] 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>
---
 tools/virsh.pod | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

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.