libvirt/libvirt-include-libvirt-domain-Reword-documentation-for-reason-of-VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON.patch
Jiri Denemark 62c343d5fa libvirt-10.10.0-6.el10
- build: Bump minimum glib2 version to 2.66.0 (RHEL-76802)
- qemuProcessHandleIOError: Refactor to extract 'priv' instead of 'driver' (RHEL-76802)
- qemu: Handle quirks of 'device' field of BLOCK_IO_ERROR event in monitor code (RHEL-76802)
- qemu: Rename 'diskAlias' to 'device' in qemu IO error event handling (RHEL-76802)
- qemuProcessHandleIOError: Rename local variables (RHEL-76802)
- qemuMonitorJSONHandleIOError: Do not munge 'reason' field of IO error event (RHEL-76802)
- qemuProcessHandleIOError: Prefer lookup by node name (RHEL-76802)
- qemuMonitorJSONHandleIOError: Propagate new 'qom-path' field (RHEL-76802)
- virStorageSource: Add fields for storing last I/O error message (RHEL-76802)
- qemuProcessHandleIOError: Populate I/O error reason to virStorageSource (RHEL-76802)
- qemuProcessHandleIOError: Log IO errors in the VM log file (RHEL-76802)
- libxlDomainGetMessages: Add existing flags to 'virCheckFlags' (RHEL-76802)
- virDomainObjGetMessages: Refactor using GPtrArray (RHEL-76802)
- virDomainGetMessages: Introduce VIR_DOMAIN_MESSAGE_IOERRORS (RHEL-76802)
- include: libvirt-domain: Reword documentation for @reason of VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON (RHEL-76802)
- include: libvirt-domain: Add 'message' @reason of VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON (RHEL-76802)
- qemuSnapshotForEachQcow2: Don't initialize 'nrollback' (RHEL-78186)
- qemu: process: Export qemuPrepareNVRAM for use in snapshot code (RHEL-78186)
- qemu: snapshot: Ensure that NVRAM image exists when taking inactive internal snapshot (RHEL-78186)
- qemuxmlconftest: Allow testing of the 'writable' flag for passed FDs for disks (RHEL-78353)
- qemuxmlconftest: Add testing of FDs with 'writable' flag in 'disk-source-fd' (RHEL-78353)
- qemu: domain: Initialize FD passthrough for a virStorageSource before using it (RHEL-78353)

Resolves: RHEL-76802, RHEL-78186, RHEL-78353
2025-02-07 15:07:04 +01:00

48 lines
2.0 KiB
Diff

From 5ce72113702e5b48bde5234c0d6b9c951d998a1d Mon Sep 17 00:00:00 2001
Message-ID: <5ce72113702e5b48bde5234c0d6b9c951d998a1d.1738937224.git.jdenemar@redhat.com>
From: Peter Krempa <pkrempa@redhat.com>
Date: Mon, 27 Jan 2025 15:50:34 +0100
Subject: [PATCH] include: libvirt-domain: Reword documentation for @reason of
VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Emphasise that it's an enumeration and convert the possibilities to a
list of values with explanation.
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
(cherry picked from commit 3a3c5616eb2c50a58896f99f30d887937dab297a)
https://issues.redhat.com/browse/RHEL-76802
---
include/libvirt/libvirt-domain.h | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index 92a32f1cde..1dc7b417c9 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -4775,11 +4775,13 @@ typedef void (*virConnectDomainEventIOErrorCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON with virConnectDomainEventRegisterAny()
*
- * If the I/O error is known to be caused by an ENOSPC condition in
- * the host (where resizing the disk to be larger will allow the guest
- * to be resumed as if nothing happened), @reason will be "enospc".
- * Otherwise, @reason will be "", although future strings may be added
- * if determination of other error types becomes possible.
+ * Although @reason is a string, it is considered to be an enumeration of the
+ * following values:
+ *
+ * - "" (empty string): unknown I/O error reason
+ * - "enospc": The I/O error is known to be caused by an ENOSPC condition in
+ * the host. Resizing the disk source to be larger will allow the
+ * guest to be resumed as if nothing happened.
*
* Since: 0.8.1
*/
--
2.48.1