[libvirt] [PATCH 2/2] virsh: man: Document asynchronous behaviour of detach-device-alias

Peter Krempa pkrempa at redhat.com
Mon Mar 18 07:19:50 UTC 2019


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 at redhat.com>
---
 tools/virsh.pod | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 39ff8cd7c9..2889e17531 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.
-- 
2.20.1




More information about the libvir-list mailing list