From: Peter Krempa <pkrempa@redhat.com>
Date: Thu, 19 Aug 2021 12:54:18 +0000 (+0200)
Subject: qemuDomainObjPrivate: Annotate 'allowReboot' field
X-Git-Tag: v7.7.0-rc1~15
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6ab6d3f0740746e72b9271f8d186eeca0fa60195;p=thirdparty%2Flibvirt.git

qemuDomainObjPrivate: Annotate 'allowReboot' field

Save further readers the headache of determining what it actually does
and note that it's not used with qemu version supporting the
'set-action' command.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
---

diff --git a/src/qemu/qemu_domain.h b/src/qemu/qemu_domain.h
index abc3c7158d..f3c6bb3390 100644
--- a/src/qemu/qemu_domain.h
+++ b/src/qemu/qemu_domain.h
@@ -154,6 +154,14 @@ struct _qemuDomainObjPrivate {
 
     bool fakeReboot;
     bool pausedShutdown;
+    /* allowReboot:
+     *
+     * Unused with new QEMU versions which have QEMU_CAPS_SET_ACTION.
+     *
+     * Otherwise if it's set to VIR_TRISTATE_BOOL_YES, QEMU was started with
+     * -no-shutdown, and if set to VIR_TRISTATE_BOOL_NO qemu was started with
+     * -no-reboot instead.
+     */
     virTristateBool allowReboot;
 
     int jobs_queued;