From nobody Sat Sep 26 20:50:57 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1789120602; cv=none; d=zohomail.com; s=zohoarc; b=B8LaMUH5GMzojeERfnzzZNoRLq0LSTbSn9EPYdFskXBp6wqILfInqoT+dqQVcrD2Lo1i5WPrX7e4C2hZCLgMouAbXENNDR9dQNvt1RohrZjmws5Zq41u7vVo1NdjhkoFpsyocCE1MksX5lW0TDJKQPt22m3RKZurFgJxcVObK0c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789120602; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=6HdTKagfO8JjKw1KXN2pn9l/2dFfUqr4nR2djugGQE4=; b=SW+HgjGYUrthGWtFw3wP0t0C9jptxHRbUsAY6KgQAODi8+RG6E999pT0PwZBRN0sB/NH/12WbAibB/YztngB4r7Y47FnqGD9G5hkXirsj2vqV5Ori62nUwXt98K16GPtBXoxLsDb/qptu7xnK0X/v99ILmX4T9crf+1eMlGEv3E= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 178912060229969.67685377325347; Fri, 11 Sep 2026 02:56:42 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x4xzL-0007nj-BF; Fri, 11 Sep 2026 05:56:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x4xxI-0005nU-3w for qemu-devel@nongnu.org; Fri, 11 Sep 2026 05:54:00 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x4xxG-000293-Ep for qemu-devel@nongnu.org; Fri, 11 Sep 2026 05:53:59 -0400 Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-470-6fPrSDTINpCsNdODDtu80w-1; Fri, 11 Sep 2026 05:53:54 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4C8261955E70; Fri, 11 Sep 2026 09:53:53 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.44.22.5]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id CE921418; Fri, 11 Sep 2026 09:53:52 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 2A1BF21E692D; Fri, 11 Sep 2026 11:53:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789120437; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=6HdTKagfO8JjKw1KXN2pn9l/2dFfUqr4nR2djugGQE4=; b=C9t7WAV0aT9ZOwfeNMTHeGgD4VHuWwkan0XQMQ7cPg1Y8KHSpMIBZ8T2n54TXZNtGjf3XE VFEMTKVrtYmY+D9kVnpsuR/CC6A9xKhveJ+fGlAHvHsXAQW0ygzmQRcNFUhGEzQDpkTqHn 4Ny6svSEfgEhCsOaBs7J67jic8TbydM= X-MC-Unique: 6fPrSDTINpCsNdODDtu80w-1 X-Mimecast-MFC-AGG-ID: 6fPrSDTINpCsNdODDtu80w_1789120433 From: Markus Armbruster To: qemu-devel@nongnu.org Cc: jsnow@redhat.com, eblake@redhat.com, philmd@oss.qualcomm.com, zhao1.liu@intel.com Subject: [PATCH 1/2] qapi/machine: Drop misleading (for OptsVisitor) doc Date: Fri, 11 Sep 2026 11:53:49 +0200 Message-ID: <20260911095350.2020964-2-armbru@redhat.com> In-Reply-To: <20260911095350.2020964-1-armbru@redhat.com> References: <20260911095350.2020964-1-armbru@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=armbru@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1789120604167158500 Content-Type: text/plain; charset="utf-8" The QMP Reference Manual describes NumaOptions and NumaNodeOptions as "(for OptsVisitor)". This makes no sense; the OptsVisitor is a purely internal thing. When commit 0042109a6a (NUMA: convert -numa option to use OptsVisitor) added these QAPI types, both "(for OptsVisitor)" were correct and merely schema comments. They have since become wrong (both types are part of QMP according to query-qmp-schema) and reference documentation. Delete both instances. Signed-off-by: Markus Armbruster Reviewed-by: Daniel P. Berrang=C3=A9 --- qapi/machine.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 2d63c1bac3..2fd4861616 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -470,7 +470,7 @@ ## # @NumaOptions: # -# A discriminated record of NUMA options. (for OptsVisitor) +# A discriminated record of NUMA options. # # @type: NUMA option type # @@ -489,7 +489,7 @@ ## # @NumaNodeOptions: # -# Create a guest NUMA node. (for OptsVisitor) +# Create a guest NUMA node. # # @nodeid: NUMA node ID (increase by 1 from 0 if omitted) # --=20 2.55.0 From nobody Sat Sep 26 20:50:57 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1789120603; cv=none; d=zohomail.com; s=zohoarc; b=VM7wDZSZdfzcAuUM+fi4gIWlJn3WD6+yRQUeGXXPrgXJQ4mO9vbx7cYnQBdUQUZutOSboqHXyaCH6C9vPY/cBMyBWKvuikQYUqpdT0AKGDLdFuqiL3RyQnfoCSyWfMyM4wmpFWwc2CwTPMbvKbBevP6hYy6B4SlKWqBoiDCJgaQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789120603; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=yDhtyS45HZx1Ywrfz6zY+BH9lH9qIacmZrasU50TPDM=; b=fErdRotdYxmBdb/mSWTnd/R2ZdvYKnAkXFpc5oBbXG5bFsTQxO02WmHdIhWXzAvBZWEiJJtDdjdFI1XjKuaIVKxAC0wKlQ9FG9MKVamiyzU7Hu2fU98utjmDYwJWpSwEG/d19kxNpOgnsZIsBB82IJCb2bmRvUQsjDuxsRKNNhw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1789120602954615.9953527715907; Fri, 11 Sep 2026 02:56:42 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x4xzg-0008Mj-3u; Fri, 11 Sep 2026 05:56:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x4xxH-0005mf-Pf for qemu-devel@nongnu.org; Fri, 11 Sep 2026 05:54:00 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x4xxG-00028s-DD for qemu-devel@nongnu.org; Fri, 11 Sep 2026 05:53:59 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-209-Hj0EYa-_MKuTj8Ynmul26Q-1; Fri, 11 Sep 2026 05:53:54 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EE957195423B; Fri, 11 Sep 2026 09:53:52 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.44.22.5]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 90D63180029C; Fri, 11 Sep 2026 09:53:52 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 2EC6721E6880; Fri, 11 Sep 2026 11:53:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789120437; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=yDhtyS45HZx1Ywrfz6zY+BH9lH9qIacmZrasU50TPDM=; b=YmteLm+Ju6Os45du7IJnO9aYtkYt52W4GoRTiqEleNYhPzHH6zc+4AAxi24gUf8Cwspg1k /7c3+MQX0rTCdnlfag6XMX8HLzWQspPIwxvz6Gkz6NLoZd89EiswzKbw4XrR1RNOKUyZ4l RjFQECK2Vuazjqr6/cr9+FKMzhT8rQc= X-MC-Unique: Hj0EYa-_MKuTj8Ynmul26Q-1 X-Mimecast-MFC-AGG-ID: Hj0EYa-_MKuTj8Ynmul26Q_1789120433 From: Markus Armbruster To: qemu-devel@nongnu.org Cc: jsnow@redhat.com, eblake@redhat.com, philmd@oss.qualcomm.com, zhao1.liu@intel.com Subject: [PATCH 2/2] qapi/compat: Belatedly update description of CompatPolicy Date: Fri, 11 Sep 2026 11:53:50 +0200 Message-ID: <20260911095350.2020964-3-armbru@redhat.com> In-Reply-To: <20260911095350.2020964-1-armbru@redhat.com> References: <20260911095350.2020964-1-armbru@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=armbru@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1789120605806158500 Content-Type: text/plain; charset="utf-8" Fixes: 57df0dff1a (qapi: Extend -compat to set policy for unstable interfaces) Signed-off-by: Markus Armbruster Reviewed-by: Daniel P. Berrang=C3=A9 --- qapi/compat.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qapi/compat.json b/qapi/compat.json index 90b8d51cf2..e4728424de 100644 --- a/qapi/compat.json +++ b/qapi/compat.json @@ -40,7 +40,7 @@ ## # @CompatPolicy: # -# Policy for handling deprecated management interfaces. +# Policy for handling deprecated and unstable management interfaces. # # This is intended for testing users of the management interfaces. # --=20 2.55.0