From: Peter Krempa <pkrempa@redhat.com>
Date: Thu, 20 Mar 2025 15:10:18 +0000 (+0100)
Subject: lib: error: Introduce 'VIR_ERR_AGENT_COMMAND_FAILED'
X-Git-Tag: v11.2.0-rc1~9
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c3a92081c871794a7d153301d042b1f0765979bb;p=thirdparty%2Flibvirt.git

lib: error: Introduce 'VIR_ERR_AGENT_COMMAND_FAILED'

Add a special error code for when the guest agent returned a failure
message.

Allow management applications to deterministically detect failure of the
guest agent command.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
---

diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h
index 7a2cc2b4bd..f02da046a3 100644
--- a/include/libvirt/virterror.h
+++ b/include/libvirt/virterror.h
@@ -351,6 +351,8 @@ typedef enum {
     VIR_ERR_NO_NETWORK_METADATA = 111,  /* Network metadata is not present (Since: 9.7.0) */
     VIR_ERR_AGENT_COMMAND_TIMEOUT = 112,/* guest agent didn't respond to a non-sync
                                            command within timeout (Since: 11.2.0) */
+    VIR_ERR_AGENT_COMMAND_FAILED = 113, /* guest agent responded with failure
+                                           to a command (Since: 11.2.0) */
 
 # ifdef VIR_ENUM_SENTINELS
     VIR_ERR_NUMBER_LAST /* (Since: 5.0.0) */
diff --git a/src/util/virerror.c b/src/util/virerror.c
index f89bfbc530..abb014b522 100644
--- a/src/util/virerror.c
+++ b/src/util/virerror.c
@@ -1293,6 +1293,9 @@ static const virErrorMsgTuple virErrorMsgStrings[] = {
     [VIR_ERR_AGENT_COMMAND_TIMEOUT] = {
         N_("guest agent command timed out"),
         N_("guest agent command timed out: %1$s") },
+    [VIR_ERR_AGENT_COMMAND_FAILED] = {
+        N_("guest agent command failed"),
+        N_("guest agent command failed: %1$s") },
 };
 
 G_STATIC_ASSERT(G_N_ELEMENTS(virErrorMsgStrings) == VIR_ERR_NUMBER_LAST);