[PATCH qemu-server 4/4] api: human monitor: warn about deprecated commands

[Fiona Ebner <f.ebner@proxmox.com>]

The 'stopcapture' and 'wavcapture' HMP commands are deprecated since
QEMU 10.2.

Reference:
https://qemu-project.gitlab.io/qemu/about/deprecated.html#human-machine-protocol-hmp-commands

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
---
 src/PVE/API2/Qemu.pm          | 4 ++++
 src/PVE/API2/Qemu/HMPPerms.pm | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/src/PVE/API2/Qemu.pm b/src/PVE/API2/Qemu.pm
index d762401b..7f042f98 100644
--- a/src/PVE/API2/Qemu.pm
+++ b/src/PVE/API2/Qemu.pm
@@ -5841,6 +5841,10 @@ __PACKAGE__->register_method({
             die "unexpected required permission '$required_perm' for command '$command_name'\n";
         }
 
+        if ($command_name eq 'stopcapture' || $command_name eq 'wavcapture') {
+            warn "command '$command_name' is deprecated and will be dropped in a future release\n";
+        }
+
         my $vmid = $param->{vmid};
 
         my $conf = PVE::QemuConfig->load_config($vmid); # check if VM exists
diff --git a/src/PVE/API2/Qemu/HMPPerms.pm b/src/PVE/API2/Qemu/HMPPerms.pm
index 5d5609d4..4763ca15 100644
--- a/src/PVE/API2/Qemu/HMPPerms.pm
+++ b/src/PVE/API2/Qemu/HMPPerms.pm
@@ -205,6 +205,8 @@ sub generate_description() {
 
     $text .= "The following commands are root-only: " . join(', ', $root_only_cmds->@*) . "\n";
 
+    $text .= "\nThe following commands are deprecated: stopcapture, wavcapture\n";
+
     return $text;
 }
 
-- 
2.47.3