]> git.ipfire.org Git - thirdparty/libvirt.git/commitdiff
docs: Lift restriction on running API from the event loop thread
authorMichal Privoznik <mprivozn@redhat.com>
Thu, 25 Feb 2021 14:29:16 +0000 (15:29 +0100)
committerMichal Privoznik <mprivozn@redhat.com>
Fri, 12 Mar 2021 14:40:13 +0000 (15:40 +0100)
Since v6.2.0-rc1~238 (and friends) QMP processing was moved to a
per-domain thread. Therefore, it is now safe to call APIs from
the event loop thread (e.g. just like qemu shim is doing in
qemuShimEventLoop(). However, it is still important to let the
event loop run after each API call (obviously).

Signed-off-by: Michal Privoznik <mprivozn@redhat.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
docs/drvqemu.html.in

index a784f5768c1103932d8d6ebc07de1c8f67f46ab2..375c1b03524c6da5684707bf859c33ce2b444582 100644 (file)
@@ -158,8 +158,10 @@ qemu+ssh://root@example.com/system   (remote access, SSH tunnelled)
       in mind, applications must <strong>NEVER</strong> invoke API
       calls from the event loop thread itself, only other threads.
       Not following this rule will lead to deadlocks in the API.
-      This restriction is intended to be lifted in a future release
-      of libvirt, once QMP processing moves to a dedicated thread.
+      This restriction was lifted starting from 6.2.0 release, when
+      QMP processing moved to a dedicated thread. However, it is
+      important to let the event loop run after each API call, even
+      the ones made from the event loop thread itself.
     </p>
 
     <h2><a id="configFiles">Location of configuration files</a></h2>