- 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
48 lines
2.0 KiB
Diff
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
|