render / rpms / libvirt

Forked from rpms/libvirt 9 months ago
Clone
99cbc7
From 3b632d86e7a45ba4ae07fd655340505a144bf942 Mon Sep 17 00:00:00 2001
99cbc7
Message-Id: <3b632d86e7a45ba4ae07fd655340505a144bf942@dist-git>
99cbc7
From: Peter Krempa <pkrempa@redhat.com>
99cbc7
Date: Wed, 3 Apr 2019 16:35:45 +0200
99cbc7
Subject: [PATCH] virsh: man: Document asynchronous behaviour of
99cbc7
 detach-device-alias
99cbc7
99cbc7
This command is fully async. Note that users can use virsh event to be
99cbc7
notified of the guest actually removing the device.
99cbc7
99cbc7
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
99cbc7
Reviewed-by: Erik Skultety <eskultet@redhat.com>
99cbc7
(cherry picked from commit 61d1abd5f11cadaf2ac7548e1a42e112bc49ed7e)
99cbc7
99cbc7
https: //bugzilla.redhat.com/show_bug.cgi?id=1688961
99cbc7
Message-Id: <50540ced50cfffa59367bf8d026222fe006cd58d.1554302031.git.pkrempa@redhat.com>
99cbc7
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
99cbc7
---
99cbc7
 tools/virsh.pod | 5 ++++-
99cbc7
 1 file changed, 4 insertions(+), 1 deletion(-)
99cbc7
99cbc7
diff --git a/tools/virsh.pod b/tools/virsh.pod
99cbc7
index 5321f6806a..79d1efa955 100644
99cbc7
--- a/tools/virsh.pod
99cbc7
+++ b/tools/virsh.pod
99cbc7
@@ -3214,7 +3214,10 @@ I<--persistent>.
99cbc7
 =item B<detach-device-alias> I<domain> I<alias>
99cbc7
 [[[I<--live>] [I<--config>] | [I<--current>]]]]
99cbc7
 
99cbc7
-Detach a device with given I<alias> from the I<domain>.
99cbc7
+Detach a device with given I<alias> from the I<domain>. This command returns
99cbc7
+successfully after the unplug request was sent to the hypervisor. The actual
99cbc7
+removal of the device is notified asynchronously via libvirt events
99cbc7
+(see virsh event).
99cbc7
 
99cbc7
 If I<--live> is specified, affect a running domain.
99cbc7
 If I<--config> is specified, affect the next startup of a persistent domain.
99cbc7
-- 
99cbc7
2.21.0
99cbc7