From nobody Sat Sep 26 22:13:59 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=1789158690; cv=none; d=zohomail.com; s=zohoarc; b=aOIDZFgVl2kIfnF7bPp1XZbhGFAm0uT6a2oQvJDPHRarkg1uoxryCT3sJjiMklqOH2RRiLzjEZeStqxdH2i/AkXYMjtzr6Js7i2NNbPMOz9zbFsdzQx5i0KT64UpwBzCezftQWjdeMp6LHJAIZvVM/M7xMzYhHIl1cD6zsoylD4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158690; 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=6rV63i5zLz4J/LUzf54w3p9IiUX+skDQOv9c6EGZuIE=; b=lnJGTZpSr1jp9xqwoQgUoFPMZePwzvQJSInZeQB1dFh8TVSGimlbRrMqNx8ob0tMvtN2UhL1B/9dJiDBaSmAm1MrK3tMU+WD1u81SbwciRenMuvGKyoiK0T8oEUHL+P6QLg8yNjwApjSZUPRDtnViwmD6E3pOu44IsHtVWgr7CM= 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 1789158690199181.83392915828483; Fri, 11 Sep 2026 13:31:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57tT-0001Ki-LX; Fri, 11 Sep 2026 16:30:43 -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 1x57tM-0001Jj-7Y for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:37 -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 1x57tC-000545-Hr for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:30 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-551-0qt_zxZlNKq3tz1MfZc0ow-1; Fri, 11 Sep 2026 16:30:19 -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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id D0AD318009DE; Fri, 11 Sep 2026 20:30:16 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 9169E5C0; Fri, 11 Sep 2026 20:30:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158622; 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=6rV63i5zLz4J/LUzf54w3p9IiUX+skDQOv9c6EGZuIE=; b=WOtYkt3DGYNr36SEPBR7Rx3y4TGWLEa0cE4XjNL4+ABAFVWvUie/xfhvOk9tpy2Pvx7I4N zjU4fksaM/cNIh0X/26/Wg6aH9Ox2IupwhR/Ppz7e2A5A4OYXM6os8pXpV9iRp1GbcNen5 t2VGXIWYAKY7OFHGXFfmwIrd0mLviHg= X-MC-Unique: 0qt_zxZlNKq3tz1MfZc0ow-1 X-Mimecast-MFC-AGG-ID: 0qt_zxZlNKq3tz1MfZc0ow_1789158617 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 1/9] qapi: convert remaining simple intros for block-export.json Date: Fri, 11 Sep 2026 16:29:54 -0400 Message-ID: <20260911203002.305316-2-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable 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: 1789158693855158500 Content-Type: text/plain; charset="utf-8" These are either structs or unions that are used in an inlinable context: i.e. the generated documentation is likely to feature a version of this documentation block that does not include the intro in context of another command, event, or structure. Signed-off-by: John Snow --- qapi/block-export.json | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index 2893c6456d5..e9f7e72c8ee 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -37,10 +37,9 @@ =20 ## # @NbdServerOptions: -# -# Keep this type consistent with the `NbdServerOptionsLegacy` type. -# The only intended difference is using `SocketAddress` instead of -# `SocketAddressLegacy`. +# Keep this type consistent with the `NbdServerOptionsLegacy` +# type. The only intended difference is using `SocketAddress` +# instead of `SocketAddressLegacy`. # # @addr: Address on which to listen (since 4.2). ## @@ -50,10 +49,9 @@ =20 ## # @NbdServerOptionsLegacy: -# -# Keep this type consistent with the `NbdServerOptions` type. The -# only intended difference is using `SocketAddressLegacy` instead of -# `SocketAddress`. +# Keep this type consistent with the `NbdServerOptions` type. The +# only intended difference is using `SocketAddressLegacy` instead +# of `SocketAddress`. # # @addr: Address on which to listen (since 1.3). ## @@ -339,9 +337,8 @@ =20 ## # @BlockExportOptions: -# -# Describes a block export, i.e. how single node should be exported on -# an external interface. +# Describes a block export, i.e. how single node should be +# exported on an external interface. # # @type: Block export type # --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158690; cv=none; d=zohomail.com; s=zohoarc; b=UOa/w/RM3QcTwKy2rF18Sny5nRmmEkje/twvwtEi++I75PsBhI3XegrorqFR4v8ecMU8Go/TEQA3tT1OJ3pmZmzRhiBfpCDFPHh+nqQheXPIzD9XF/geHVdsoeU0lK/Hh+74jB9PHqCjfuIcyUDYOHCgKpI7wLaWihX5Dgpjb2Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158690; 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=zmDWgqMA466KBmRXKNBu7VpdocFww0XxxuHkKsNs8Aw=; b=d0YsrceahBBJEc0pb7LjZHC9yesCnT2Kj54rQR0IbQPwt1T0y1xMKiNigoy50koE1FXnPn0qhay8fBtZw19MM+9mPFWg4PQK3rub/e+aBeYld+9pxIr+R58U8fKoiAQdiFjnGtwzXfsYYJnQoRZT0DRJlg2CUGEvYmWEPx2E93Q= 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 178915869027633.957171729403285; Fri, 11 Sep 2026 13:31:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57tX-0001M9-Fk; Fri, 11 Sep 2026 16:30:51 -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 1x57tR-0001Ka-Kt for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:41 -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 1x57tE-000556-Q8 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:34 -0400 Received: from mx-prod-mc-05.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-386-uttjgL19NS-MIlTSVF1B5w-1; Fri, 11 Sep 2026 16:30:23 -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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 8109E1954AC8; Fri, 11 Sep 2026 20:30:21 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3CCDD41B; Fri, 11 Sep 2026 20:30:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158627; 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=zmDWgqMA466KBmRXKNBu7VpdocFww0XxxuHkKsNs8Aw=; b=Aqc3vpbWI9dhS9N/rBxiFBEm3kySygw63kQyohpNj00l+2S8cDcw7HoELZ1zpjcwDdmPk4 9KjCeEBe47/c2gCv80gbtJ1YAvdBvilSCwRbf2uR3kYrJ6ItLe9Zxq/QOls7MyKm9LK1sT pKFvOeIpUNgP9bjLAxYlRCXVuZ0onA4= X-MC-Unique: uttjgL19NS-MIlTSVF1B5w-1 X-Mimecast-MFC-AGG-ID: uttjgL19NS-MIlTSVF1B5w_1789158622 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 2/9] qapi: convert multi-paragraph intros (commands) Date: Fri, 11 Sep 2026 16:29:55 -0400 Message-ID: <20260911203002.305316-3-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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=jsnow@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: 1789158693924158500 Content-Type: text/plain; charset="utf-8" This patch converts some slightly-non-trivial intros with more than one paragraph, but doesn't create any new intro/details splits. Review notes: Some of these possibly could be split, but as they are comman= ds (not eligible as an inlining source) and the additional information in the intro is not terribly long, I opted to leave them alone instead of laboring on prose rewrites. Signed-off-by: John Snow --- qapi/block-core.json | 49 +++++++++++++++++++++----------------------- qapi/block.json | 29 +++++++++++++------------- qapi/migration.json | 9 ++++---- qapi/misc-arm.json | 9 ++++---- qapi/misc.json | 13 ++++++------ qapi/qdev.json | 14 ++++++------- 6 files changed, 58 insertions(+), 65 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index 1ca147285e7..c505369aeb2 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -1772,13 +1772,12 @@ =20 ## # @blockdev-snapshot: +# Takes a snapshot of a block device. # -# Takes a snapshot of a block device. -# -# Take a snapshot, by installing 'node' as the backing image of -# 'overlay'. Additionally, if 'node' is associated with a block -# device, the block device changes to using 'overlay' as its new -# active image. +# Take a snapshot, by installing 'node' as the backing image of +# 'overlay'. Additionally, if 'node' is associated with a block +# device, the block device changes to using 'overlay' as its new +# active image. # # Features: # @@ -2471,15 +2470,15 @@ ## # @block-dirty-bitmap-merge: # -# Merge dirty bitmaps listed in @bitmaps to the @target dirty bitmap. -# Dirty bitmaps in @bitmaps will be unchanged, except if it also -# appears as the @target bitmap. Any bits already set in @target will -# still be set after the merge, i.e., this operation does not clear -# the target. On error, @target is unchanged. +# Merge dirty bitmaps listed in @bitmaps to the @target dirty +# bitmap. Dirty bitmaps in @bitmaps will be unchanged, except if +# it also appears as the @target bitmap. Any bits already set in +# @target will still be set after the merge, i.e., this operation +# does not clear the target. On error, @target is unchanged. # -# The resulting bitmap will count as dirty any clusters that were -# dirty in any of the source bitmaps. This can be used to achieve -# backup checkpoints, or in simpler usages, to copy bitmaps. +# The resulting bitmap will count as dirty any clusters that were +# dirty in any of the source bitmaps. This can be used to achieve +# backup checkpoints, or in simpler usages, to copy bitmaps. # # Errors: # - If @node is not a valid block device, DeviceNotFound @@ -5848,15 +5847,14 @@ =20 ## # @block-set-write-threshold: +# Change the write threshold for a block drive. An event will be +# delivered if a write to this block drive crosses the configured +# threshold. The threshold is an offset, thus must be +# non-negative. Default is no write threshold. Setting the +# threshold to zero disables it. # -# Change the write threshold for a block drive. An event will be -# delivered if a write to this block drive crosses the configured -# threshold. The threshold is an offset, thus must be non-negative. -# Default is no write threshold. Setting the threshold to zero -# disables it. -# -# This is useful to transparently resize thin-provisioned drives -# without the guest OS noticing. +# This is useful to transparently resize thin-provisioned drives +# without the guest OS noticing. # # @node-name: graph node name on which the threshold must be set. # @@ -5938,11 +5936,10 @@ =20 ## # @x-blockdev-set-iothread: +# Move @node and its children into the @iothread. If @iothread is +# null then move @node and its children into the main loop. # -# Move @node and its children into the @iothread. If @iothread is -# null then move @node and its children into the main loop. -# -# The node must not be attached to a BlockBackend. +# The node must not be attached to a BlockBackend. # # @node-name: the name of the block driver node # diff --git a/qapi/block.json b/qapi/block.json index e47592d5500..15f08372564 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -181,12 +181,13 @@ =20 ## # @blockdev-close-tray: +# Closes a block device's tray. # -# Closes a block device's tray. If there is a block driver state tree -# associated with the block device (which is currently ejected), that -# tree will be loaded as the medium. +# If there is a block driver state tree associated with the block +# device (which is currently ejected), that tree will be loaded as +# the medium. # -# If the tray was already closed before, this will be a no-op. +# If the tray was already closed before, this will be a no-op. # # @device: Block device name # @@ -218,13 +219,12 @@ =20 ## # @blockdev-remove-medium: +# Removes a medium (a block driver state tree) from a block +# device. That block device's tray must currently be open +# (unless there is no attached guest device). # -# Removes a medium (a block driver state tree) from a block device. -# That block device's tray must currently be open (unless there is no -# attached guest device). -# -# If the tray is open and there is no medium inserted, this will be a -# no-op. +# If the tray is open and there is no medium inserted, this will +# be a no-op. # # @id: The name or QOM path of the guest device # @@ -504,12 +504,11 @@ =20 ## # @block-latency-histogram-set: +# Manage read, write and flush latency histograms for the device. # -# Manage read, write and flush latency histograms for the device. -# -# If only @id parameter is specified, remove all present latency -# histograms for the device. Otherwise, add/reset some of (or all) -# latency histograms. +# If only @id parameter is specified, remove all present latency +# histograms for the device. Otherwise, add/reset some of (or +# all) latency histograms. # # @id: The name or QOM path of the guest device. # diff --git a/qapi/migration.json b/qapi/migration.json index 8096ef64682..13c446b922f 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -1965,12 +1965,11 @@ =20 ## # @cancel-vcpu-dirty-limit: +# Cancel the upper limit of dirty page rate for virtual CPUs. # -# Cancel the upper limit of dirty page rate for virtual CPUs. -# -# Cancel the dirty page limit for the vCPU which has been set with -# `set-vcpu-dirty-limit` command. Note that this command requires -# support from dirty ring, same as the `set-vcpu-dirty-limit`. +# Cancel the dirty page limit for the vCPU which has been set with +# `set-vcpu-dirty-limit` command. Note that this command requires +# support from dirty ring, same as the `set-vcpu-dirty-limit`. # # @cpu-index: index of a virtual CPU, default is all. # diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index 8cb2ea77951..64059b5688d 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -28,12 +28,11 @@ =20 ## # @query-gic-capabilities: +# It will return a list of `GICCapability` objects that describe +# its capability bits. # -# It will return a list of `GICCapability` objects that describe its -# capability bits. -# -# On non-ARM targets this command will report an error as the GIC -# technology is not applicable. +# On non-ARM targets this command will report an error as the GIC +# technology is not applicable. # # Since: 2.6 # diff --git a/qapi/misc.json b/qapi/misc.json index b3c2a1421f3..374711ac6c7 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -178,14 +178,13 @@ =20 ## # @x-exit-preconfig: +# Exit from "preconfig" state # -# Exit from "preconfig" state -# -# This command makes QEMU exit the preconfig state and proceed with VM -# initialization using configuration data provided on the command line -# and via the QMP monitor during the preconfig state. The command is -# only available during the preconfig state (i.e. when the --preconfig -# command line option was in use). +# This command makes QEMU exit the preconfig state and proceed +# with VM initialization using configuration data provided on the +# command line and via the QMP monitor during the preconfig state. +# The command is only available during the preconfig state +# (i.e. when the --preconfig command line option was in use). # # Features: # diff --git a/qapi/qdev.json b/qapi/qdev.json index a35321d2fd1..e19a92a44e8 100644 --- a/qapi/qdev.json +++ b/qapi/qdev.json @@ -163,14 +163,14 @@ ## # @device-sync-config: # -# Synchronize device configuration from host to guest part. First, -# copy the configuration from the host part (backend) to the guest -# part (frontend). Then notify guest software that device -# configuration changed. +# Synchronize device configuration from host to guest part. +# First, copy the configuration from the host part (backend) to +# the guest part (frontend). Then notify guest software that +# device configuration changed. # -# The command may be used to notify the guest about block device -# capacity change. Currently only vhost-user-blk device supports -# this. +# The command may be used to notify the guest about block device +# capacity change. Currently only vhost-user-blk device supports +# this. # # @id: the device's ID or QOM path # --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158772; cv=none; d=zohomail.com; s=zohoarc; b=PSa3lLg/t6cYTtn2BibksopzhW9bHON0m+anEkG33cml1sjByr+XUYaW66iJQvqSTgs4q6s1fB10rSUffbi71a+DQREhSiFLbAVr4cJ6THGCPTkRPttnRU9r8VUvIdjHcf3CGfrngdlYrWkR+ZesMUbLAwwNz7mS/pbZ/uQ3LFs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158772; 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=4wUqdsl2O9IhVLvQX3iGqy2/Ch7Q/OmKIjKQAdl2Qs0=; b=Uyih8sL3MZtywx4xMwq/WKraJY4bjQxfYAOFWtX/A/guQLO5p93nSleS+NIanZjRzQy6xsbPuNJdZaOzQ3l9lOSxTIuK/9lblHTL6oal09H9IKdveUX090wzfrkrfENYqB4mTUHJmopIJVDCb00oxcnfbn3lmOSlr25LzudM+ng= 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 1789158772315511.29162244796237; Fri, 11 Sep 2026 13:32:52 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57u3-0001RA-Jg; Fri, 11 Sep 2026 16:31:19 -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 1x57tU-0001LP-Sf for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:45 -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 1x57tR-00056A-Ky for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:44 -0400 Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-59-Ej4HSaMsP8mvs-kwGRXxug-1; Fri, 11 Sep 2026 16:30:28 -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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 6FFD818015C3; Fri, 11 Sep 2026 20:30:27 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id DC2C15C0; Fri, 11 Sep 2026 20:30:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158633; 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=4wUqdsl2O9IhVLvQX3iGqy2/Ch7Q/OmKIjKQAdl2Qs0=; b=IKiFlbKQgA/SkA0GkCBREpx1ezbXgy9uA6G5G+IoselfNg50ipWV59bQ/9EPh5Ljr5RPUU /RIQWh1w1gpsh9thwZMc80PCvO5y7CFHrwBNJ+/8WFIszfr2a3ZE3DYxq0m1nZ6n3wDGzv G+1Mlt6vx0t4FT9oV4cgHWkboYljcWE= X-MC-Unique: Ej4HSaMsP8mvs-kwGRXxug-1 X-Mimecast-MFC-AGG-ID: Ej4HSaMsP8mvs-kwGRXxug_1789158627 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 3/9] qapi: convert multi-paragraph intros (enums) Date: Fri, 11 Sep 2026 16:29:56 -0400 Message-ID: <20260911203002.305316-4-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable 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: 1789158773589158500 Content-Type: text/plain; charset="utf-8" This patch converts some slightly-non-trivial intros with more than one paragraph, but doesn't create any new intro/details splits. Review notes: The "See also ..." texts here are prime candidates for moving into the details section with a ".. seealso::", but like the last patch, as these are for enums and not candidates as an inline source, I left them alone for now to keep patch sizes and motion down until after initial review. Signed-off-by: John Snow --- qapi/machine.json | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 0516112f8e8..710b638b3bf 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -608,12 +608,12 @@ =20 ## # @HmatLBMemoryHierarchy: +# The memory hierarchy in the System Locality Latency and +# Bandwidth Information Structure of HMAT (Heterogeneous Memory +# Attribute Table) # -# The memory hierarchy in the System Locality Latency and Bandwidth -# Information Structure of HMAT (Heterogeneous Memory Attribute Table) -# -# For more information about `HmatLBMemoryHierarchy`, see chapter -# 5.2.27.4: Table 5-146: Field "Flags" of ACPI 6.3 spec. +# For more information about `HmatLBMemoryHierarchy`, see chapter +# 5.2.27.4: Table 5-146: Field "Flags" of ACPI 6.3 spec. # # @memory: the structure represents the memory performance # @@ -630,12 +630,12 @@ =20 ## # @HmatLBDataType: +# Data type in the System Locality Latency and Bandwidth +# Information Structure of HMAT (Heterogeneous Memory Attribute +# Table) # -# Data type in the System Locality Latency and Bandwidth Information -# Structure of HMAT (Heterogeneous Memory Attribute Table) -# -# For more information about `HmatLBDataType`, see chapter 5.2.27.4: -# Table 5-146: Field "Data Type" of ACPI 6.3 spec. +# For more information about `HmatLBDataType`, see chapter +# 5.2.27.4: Table 5-146: Field "Data Type" of ACPI 6.3 spec. # # @access-latency: access latency (nanoseconds) # @@ -693,12 +693,11 @@ =20 ## # @HmatCacheAssociativity: +# Cache associativity in the Memory Side Cache Information +# Structure of HMAT # -# Cache associativity in the Memory Side Cache Information Structure -# of HMAT -# -# For more information of `HmatCacheAssociativity`, see chapter -# 5.2.27.5: Table 5-147 of ACPI 6.3 spec. +# For more information of `HmatCacheAssociativity`, see chapter +# 5.2.27.5: Table 5-147 of ACPI 6.3 spec. # # @none: None (no memory side cache in this proximity domain, or cache # associativity unknown) @@ -714,12 +713,12 @@ =20 ## # @HmatCacheWritePolicy: +# Cache write policy in the Memory Side Cache Information +# Structure of HMAT # -# Cache write policy in the Memory Side Cache Information Structure of -# HMAT -# -# For more information of `HmatCacheWritePolicy`, see chapter -# 5.2.27.5: Table 5-147: Field "Cache Attributes" of ACPI 6.3 spec. +# For more information of `HmatCacheWritePolicy`, see chapter +# 5.2.27.5: Table 5-147: Field "Cache Attributes" of ACPI 6.3 +# spec. # # @none: None (no memory side cache in this proximity domain, or cache # write policy unknown) --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158780; cv=none; d=zohomail.com; s=zohoarc; b=UCTGG0eu4qvp9yjvbK4X207XRiCUdowGFJo82U6R4Q6Nbv2H42jelGwlR0vEnAbgWQb15GykMD/rXjbCebTXZmasOossL8X9nuLByEUjQ1HWfCSC5uWO5a4jD67tx47oz8185K70awugcwQYoDkn0YWod+3eTqy7XWRpmRnE+N0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158780; 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=4j5x+zHcMcWnQDIHgjrGifJeCHeIkjIz2iqGNtVg/1k=; b=jyL4ZPRDk9zUdgQr30aVje5Z+FgeRB+s6iOQt2lQNBU3gY5S5676cZZYtZHdBy4FpDc0YMdCi04Mh0R4vogEkFV/0GjC7vcF1AX1YX/0oFX6OCnKfOIbJ28RXoq+9Gkq7ch+eAFeAN6Tzu6TgG5khoreTlsSs4/Wks3GpHt3Brg= 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 1789158780067162.28136000185236; Fri, 11 Sep 2026 13:33:00 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57tx-0001Pc-6q; Fri, 11 Sep 2026 16:31:13 -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 1x57tT-0001L1-PW for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:43 -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 1x57tR-00057W-KS for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:43 -0400 Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-255-ZHGXpqHiOeurOildHJwObQ-1; Fri, 11 Sep 2026 16:30:35 -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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 312A31802676; Fri, 11 Sep 2026 20:30:34 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E21D641B; Fri, 11 Sep 2026 20:30:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158639; 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=4j5x+zHcMcWnQDIHgjrGifJeCHeIkjIz2iqGNtVg/1k=; b=aTd+SghYECi//aJHKcln4TTQctqyxREvE6RlpbqWkCk4I426RnBjMAZdA0+gPsE6KiAheZ dUYUYs6yXUYwZ4jfX+UIMYN7hrcewOCvaNGXsFjn4l4YW6mSC5upOyqfNIGKztGg77wi8X Yu4AOzHQNfFT4aDFKPWL+Occ3Qj80Lc= X-MC-Unique: ZHGXpqHiOeurOildHJwObQ-1 X-Mimecast-MFC-AGG-ID: ZHGXpqHiOeurOildHJwObQ_1789158634 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 4/9] qapi: convert multi-paragraph intros (structs) Date: Fri, 11 Sep 2026 16:29:57 -0400 Message-ID: <20260911203002.305316-5-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham 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: 1789158781392158500 Content-Type: text/plain; charset="utf-8" This patch converts some slightly-non-trivial intros with more than one paragraph, but doesn't create any new intro/details splits. Review notes: Again, the Numa Hmat options have text that are prime candidates for a ".. seealso::" admonition, but I was uncertain as to whether this information was principally for developers or for users. If it's for developers, it can stay in the intro where it will be dropped when inlined. If it is for users, they should be moved into the details region. The remaining structs have an awful lot of text, but I was not immediately sure of which information we wanted to preserve when inlined or not; these structures tend to be written as if they are describing a command, but they actually only define a set of arguments. Advice? Opinions? Signed-off-by: John Snow --- qapi/machine.json | 17 ++++++++--------- qapi/net.json | 34 +++++++++++++++------------------- qapi/qom.json | 18 +++++++++--------- 3 files changed, 32 insertions(+), 37 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 710b638b3bf..aaecd151407 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -657,12 +657,11 @@ =20 ## # @NumaHmatLBOptions: +# Set the system locality latency and bandwidth information +# between Initiator and Target proximity Domains. # -# Set the system locality latency and bandwidth information between -# Initiator and Target proximity Domains. -# -# For more information about `NumaHmatLBOptions`, see chapter -# 5.2.27.4: Table 5-146 of ACPI 6.3 spec. +# For more information about `NumaHmatLBOptions`, see chapter +# 5.2.27.4: Table 5-146 of ACPI 6.3 spec. # # @initiator: the Initiator Proximity Domain. # @@ -734,11 +733,11 @@ =20 ## # @NumaHmatCacheOptions: +# Set the memory side cache information for a given memory domain. # -# Set the memory side cache information for a given memory domain. -# -# For more information of `NumaHmatCacheOptions`, see chapter -# 5.2.27.5: Table 5-147: Field "Cache Attributes" of ACPI 6.3 spec. +# For more information of `NumaHmatCacheOptions`, see chapter +# 5.2.27.5: Table 5-147: Field "Cache Attributes" of ACPI 6.3 +# spec. # # @node-id: the memory proximity domain to which the memory belongs. # diff --git a/qapi/net.json b/qapi/net.json index 7aabd8b9260..50dc3137182 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -681,11 +681,10 @@ =20 ## # @NetdevVhostVDPAOptions: +# Vhost-vdpa network backend # -# Vhost-vdpa network backend -# -# vDPA device is a device that uses a datapath which complies with the -# virtio specifications with a vendor specific control path. +# vDPA device is a device that uses a datapath which complies with +# the virtio specifications with a vendor specific control path. # # @vhostdev: path of vhost-vdpa device (default:'/dev/vhost-vdpa-0') # @@ -712,11 +711,10 @@ =20 ## # @NetdevVmnetHostOptions: +# vmnet (host mode) network backend. # -# vmnet (host mode) network backend. -# -# Allows the vmnet interface to communicate with other vmnet -# interfaces that are in host mode and also with the host. +# Allows the vmnet interface to communicate with other vmnet +# interfaces that are in host mode and also with the host. # # @start-address: The starting IPv4 address to use for the interface. # Must be in the private IP range (RFC 1918). Must be specified @@ -755,15 +753,14 @@ =20 ## # @NetdevVmnetSharedOptions: +# vmnet (shared mode) network backend. # -# vmnet (shared mode) network backend. -# -# Allows traffic originating from the vmnet interface to reach the -# Internet through a network address translator (NAT). The vmnet -# interface can communicate with the host and with other shared mode -# interfaces on the same subnet. If no DHCP settings, subnet mask and -# IPv6 prefix specified, the interface can communicate with any of -# other interfaces in shared mode. +# Allows traffic originating from the vmnet interface to reach the +# Internet through a network address translator (NAT). The vmnet +# interface can communicate with the host and with other shared +# mode interfaces on the same subnet. If no DHCP settings, subnet +# mask and IPv6 prefix specified, the interface can communicate +# with any of other interfaces in shared mode. # # @start-address: The starting IPv4 address to use for the interface. # Must be in the private IP range (RFC 1918). Must be specified @@ -800,10 +797,9 @@ =20 ## # @NetdevVmnetBridgedOptions: +# vmnet (bridged mode) network backend. # -# vmnet (bridged mode) network backend. -# -# Bridges the vmnet interface with a physical network interface. +# Bridges the vmnet interface with a physical network interface. # # @ifname: The name of the physical interface to be bridged. # diff --git a/qapi/qom.json b/qapi/qom.json index 51af9485e6d..3de06488768 100644 --- a/qapi/qom.json +++ b/qapi/qom.json @@ -1033,16 +1033,16 @@ =20 ## # @SevSnpGuestProperties: +# Properties for sev-snp-guest objects. Most of these are direct +# arguments for the KVM_SNP_* interfaces documented in the Linux +# kernel source under +# Documentation/arch/x86/amd-memory-encryption.rst, which are in +# turn closely coupled with the SNP_INIT/SNP_LAUNCH_* firmware +# commands documented in the SEV-SNP Firmware ABI Specification +# (Rev 0.9). # -# Properties for sev-snp-guest objects. Most of these are direct -# arguments for the KVM_SNP_* interfaces documented in the Linux -# kernel source under -# Documentation/arch/x86/amd-memory-encryption.rst, which are in turn -# closely coupled with the SNP_INIT/SNP_LAUNCH_* firmware commands -# documented in the SEV-SNP Firmware ABI Specification (Rev 0.9). -# -# More usage information is also available in the QEMU source tree -# under docs/amd-memory-encryption. +# More usage information is also available in the QEMU source tree +# under docs/amd-memory-encryption. # # @policy: the 'POLICY' parameter to the SNP_LAUNCH_START command, as # defined in the SEV-SNP firmware ABI (default: 0x30000) --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158767; cv=none; d=zohomail.com; s=zohoarc; b=MILNKLx9RBLk86Pp/yADHG4FnbYxjl0JhQrm51dSM2zkKyNdQpo6Y/XyOD/0mBun5+PVzmIQVUTpmoOinMwTDd2CfL/clQLWifodARafA18akEZIVzGsh54E5ZVHX/ZvUSv/c+BFn4TbGlJzUTbzZYIT7/ZA0QZEStPJVuKQleU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158767; 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=NqBqMGiKbrsHNyp8kl+Jbo3UWVW23oLGDfjdz49nmX8=; b=AW8/kYPt3ZnZvDc2TxEzUvlgiG2wmnMzn8hZqjCM1efQvcP0cuMBhuxziA4VPq/+/csnc39f/K52JVjFndeEUyEMefIrS5UqGPGBGQsfBBRKaoponBTTaVyHXyueGw1AKAWjmtOxr0cX5VBRUe3BnFHUzUG1hZql8Jdg9OKQrRI= 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 1789158767355595.9824439858884; Fri, 11 Sep 2026 13:32:47 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57uF-0001YJ-Hx; Fri, 11 Sep 2026 16:31:31 -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 1x57tb-0001Mk-GO for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:52 -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 1x57tV-00059S-0u for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:49 -0400 Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-191-xi5VbkQ5PmOtz07BqSIT2w-1; Fri, 11 Sep 2026 16:30:42 -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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4F73B1802676; Fri, 11 Sep 2026 20:30:41 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6BF955C0; Fri, 11 Sep 2026 20:30:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158644; 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=NqBqMGiKbrsHNyp8kl+Jbo3UWVW23oLGDfjdz49nmX8=; b=GapLao/Zexn/2Z8qTuaeNrxDDl2fvdc7jsOpcURu5mLVVmOkuXR9RlNPROgRN9l1EOMUtJ OYCciMBQDydxYWqOQKfGu6glnNX5RaxmS9NK+Ge88UCYUaSSWhzr2miyCeugCbtazOkOEK 3Gn+N9oU1AmQW3eEeXkvSqgr4mopWR4= X-MC-Unique: xi5VbkQ5PmOtz07BqSIT2w-1 X-Mimecast-MFC-AGG-ID: xi5VbkQ5PmOtz07BqSIT2w_1789158641 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 5/9] qapi: split intro sections for commands Date: Fri, 11 Sep 2026 16:29:58 -0400 Message-ID: <20260911203002.305316-6-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham 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: 1789158769288158500 Content-Type: text/plain; charset="utf-8" For commands, the primary difference between "intro" and "details" is that the intro will appear "above the fold" on generated HTML documentation (i.e. before argument/features tables), and "details" will appear afterwards. Review notes: As these are commands, the split is more arbitrary. These commands all have quite a bit of text, so I tended to split off just the first sentence or maybe the first paragraph. Some of these are likely candidates for writing a new one-sentence synopsis and shuffling most, if not all, of the existing prose down into the details. As an artifact from when these patches were part of a much, much larger set of changes, the details split is not physically relocated in these patches to keep the diffs simple and obvious to read. This can be changed if desired, but it does produce uglier diffs and can obscure prose changes where they arise. Signed-off-by: John Snow --- qapi/block-core.json | 76 ++++++++++++++++++------------------------ qapi/block-export.json | 3 +- qapi/block.json | 42 +++++++++++------------ qapi/control.json | 3 +- qapi/introspect.json | 16 ++++----- qapi/job.json | 43 +++++++++++------------- qapi/machine.json | 30 ++++++++--------- qapi/migration.json | 9 +++-- qapi/misc-i386.json | 22 +++++------- qapi/misc.json | 5 ++- qapi/net.json | 3 +- qapi/stats.json | 5 ++- qapi/transaction.json | 6 ++-- qapi/ui.json | 3 +- 14 files changed, 118 insertions(+), 148 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index c505369aeb2..ec052f6bd2d 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -1516,8 +1516,7 @@ =20 ## # @block_resize: -# -# Resize a block image while a guest is running. +# Resize a block image while a guest is running. # # Either @device or @node-name must be set but not both. # @@ -1842,9 +1841,8 @@ =20 ## # @block-commit: -# -# Live commit of data from overlay image nodes into backing nodes - -# i.e., writes data between 'top' and 'base' into 'base'. +# Live commit of data from overlay image nodes into backing nodes +# - i.e., writes data between 'top' and 'base' into 'base'. # # If top =3D=3D base, that is an error. If top has no overlays on top of # it, or if it is in use by a writer, the job will not be completed by @@ -2824,8 +2822,7 @@ =20 ## # @block-stream: -# -# Copy data from a backing file into a block device. +# Copy data from a backing file into a block device. # # The block streaming operation is performed in the background until # the entire backing file has been copied. This command returns @@ -2936,8 +2933,7 @@ =20 ## # @block-job-set-speed: -# -# Set maximum speed for a background block operation. +# Set maximum speed for a background block operation. # # This command can only be issued when there is an active block job. # @@ -2962,8 +2958,7 @@ =20 ## # @block-job-cancel: -# -# Stop an active background block operation. +# Stop an active background block operation. # # This command returns immediately after marking the active background # block operation for cancellation. It is an error to call this @@ -3005,8 +3000,7 @@ =20 ## # @block-job-pause: -# -# Pause an active background block operation. +# Pause an active background block operation. # # This command returns immediately after marking the active job for # pausing. Pausing an already paused job is an error. @@ -3038,8 +3032,7 @@ =20 ## # @block-job-resume: -# -# Resume an active background block operation. +# Resume an active background block operation. # # This command returns immediately after resuming a paused job. # Resuming an already running job is an error. @@ -3067,9 +3060,9 @@ =20 ## # @block-job-complete: -# -# Manually trigger completion of an active job in the READY or STANDBY -# state. Completing the job in any other state is an error. +# Manually trigger completion of an active job in the READY or +# STANDBY state. Completing the job in any other state is an +# error. # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive @@ -3107,14 +3100,13 @@ =20 ## # @block-job-dismiss: -# -# Deletes a job that is in the CONCLUDED state. This command only -# needs to be run explicitly for jobs that don't have automatic -# dismiss enabled. In turn, automatic dismiss may be enabled only for -# jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` -# and `block-stream`. @auto-dismiss is enabled by default for these -# jobs. +# Deletes a job that is in the CONCLUDED state. This command only +# needs to be run explicitly for jobs that don't have automatic +# dismiss enabled. In turn, automatic dismiss may be enabled only +# for jobs that have @auto-dismiss option, which are +# `drive-backup`, `blockdev-backup`, `drive-mirror`, +# `blockdev-mirror`, `block-commit` and `block-stream`. +# @auto-dismiss is enabled by default for these jobs. # # This command will refuse to operate on any job that has not yet # reached its terminal state, CONCLUDED. For jobs that make use of @@ -3136,11 +3128,10 @@ =20 ## # @block-job-finalize: -# -# Instructs all jobs in a transaction (or a single job if it is not -# part of any transaction) to finalize any graph changes and do any -# necessary cleanup. This command requires that all involved jobs are -# in the PENDING state. +# Instructs all jobs in a transaction (or a single job if it is +# not part of any transaction) to finalize any graph changes and +# do any necessary cleanup. This command requires that all +# involved jobs are in the PENDING state. # # For jobs in a transaction, instructing one job to finalize will # force ALL jobs in the transaction to finalize, so it is only @@ -4882,14 +4873,13 @@ =20 ## # @blockdev-reopen: -# -# Reopens one or more block devices using the given set of options. -# Any option not specified will be reset to its default value -# regardless of its previous status. If an option cannot be changed -# or a particular driver does not support reopening then the command -# will return an error. All devices in the list are reopened in one -# transaction, so if one of them fails then the whole transaction is -# cancelled. +# Reopens one or more block devices using the given set of +# options. Any option not specified will be reset to its default +# value regardless of its previous status. If an option cannot be +# changed or a particular driver does not support reopening then +# the command will return an error. All devices in the list are +# reopened in one transaction, so if one of them fails then the +# whole transaction is cancelled. # # The command receives a list of block devices to reopen. For each # one of them, the top-level @node-name option (from @@ -4961,9 +4951,8 @@ =20 ## # @blockdev-set-active: -# -# Activate or deactivate a block device. Use this to manage the -# handover of block devices on migration with qemu-storage-daemon. +# Activate or deactivate a block device. Use this to manage the +# handover of block devices on migration with qemu-storage-daemon. # # Activating a node automatically activates all of its child nodes # first. Deactivating a node automatically deactivates any of its @@ -5876,8 +5865,7 @@ =20 ## # @x-blockdev-change: -# -# Dynamically reconfigure the block driver state graph. +# Dynamically reconfigure the block driver state graph. # # Currently only supports adding and deleting quorum children. A # child will be added at the end of the list of children. Its diff --git a/qapi/block-export.json b/qapi/block-export.json index e9f7e72c8ee..77459f6321b 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -235,8 +235,7 @@ =20 ## # @nbd-server-add: -# -# Export a block node to QEMU's embedded NBD server. +# Export a block node to QEMU's embedded NBD server. # # The export name will be used as the id for the resulting block # export. diff --git a/qapi/block.json b/qapi/block.json index 15f08372564..73aad7f4f2b 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -128,11 +128,25 @@ =20 ## # @blockdev-open-tray: +# Opens a block device's tray. # -# Opens a block device's tray. If there is a block driver state tree -# inserted as a medium, it will become inaccessible to the guest (but -# it will remain associated to the block device, so closing the tray -# will make it accessible again). +# @device: Block device name +# +# @id: The name or QOM path of the guest device (since: 2.8) +# +# @force: if false (the default), an eject request will be sent to the +# guest if it has locked the tray (and the tray will not be opened +# immediately); if true, the tray will be opened regardless of +# whether it is locked +# +# Features: +# +# @deprecated: Member @device is deprecated. Use @id instead. +# +# If there is a block driver state tree inserted as a medium, it will +# become inaccessible to the guest (but it will remain associated to +# the block device, so closing the tray will make it accessible +# again). # # If the tray was already open before, this will be a no-op. # @@ -145,19 +159,6 @@ # device attached to it # - if the guest device does not have an actual tray # -# @device: Block device name -# -# @id: The name or QOM path of the guest device (since: 2.8) -# -# @force: if false (the default), an eject request will be sent to the -# guest if it has locked the tray (and the tray will not be opened -# immediately); if true, the tray will be opened regardless of -# whether it is locked -# -# Features: -# -# @deprecated: Member @device is deprecated. Use @id instead. -# # Since: 2.5 # # .. qmp-example:: @@ -429,8 +430,10 @@ =20 ## # @block_set_io_throttle: +# Change I/O throttle limits for a block drive. # -# Change I/O throttle limits for a block drive. +# Errors: +# - If @device is not a valid block device, DeviceNotFound # # Since QEMU 2.4, each device with I/O limits is member of a throttle # group. @@ -453,9 +456,6 @@ # case the device will be removed from its group and the rest of its # members will not be affected. The 'group' parameter is ignored. # -# Errors: -# - If @device is not a valid block device, DeviceNotFound -# # Since: 1.1 # # .. qmp-example:: diff --git a/qapi/control.json b/qapi/control.json index 0fc465936d8..b19ca910d5f 100644 --- a/qapi/control.json +++ b/qapi/control.json @@ -152,8 +152,7 @@ =20 ## # @quit: -# -# Request graceful QEMU process termination. +# Request graceful QEMU process termination. # # While every attempt is made to send the QMP response before # terminating, this is not guaranteed. When using this interface, a diff --git a/qapi/introspect.json b/qapi/introspect.json index bd42aac3358..d579e5c8554 100644 --- a/qapi/introspect.json +++ b/qapi/introspect.json @@ -17,15 +17,15 @@ =20 ## # @query-qmp-schema: +# Command `query-qmp-schema` exposes the QMP wire ABI as an array +# of `SchemaInfo`. This lets QMP clients figure out what commands +# and events are available in this QEMU, and their parameters and +# results. # -# Command `query-qmp-schema` exposes the QMP wire ABI as an array of -# `SchemaInfo`. This lets QMP clients figure out what commands and -# events are available in this QEMU, and their parameters and results. -# -# However, the `SchemaInfo` can't reflect all the rules and -# restrictions that apply to QMP. It's interface introspection -# (figuring out what's there), not interface specification. The -# specification is in the QAPI schema. +# The `SchemaInfo` can't reflect all the rules and restrictions that +# apply to QMP. It's interface introspection (figuring out what's +# there), not interface specification. The specification is in the +# QAPI schema. # # Furthermore, while we strive to keep the QMP wire format # backwards-compatible across QEMU versions, the introspection output diff --git a/qapi/job.json b/qapi/job.json index b68d7292423..1aec4ceb9f1 100644 --- a/qapi/job.json +++ b/qapi/job.json @@ -128,8 +128,7 @@ =20 ## # @job-pause: -# -# Pause an active job. +# Pause an active job. # # This command returns immediately after marking the active job for # pausing. Pausing an already paused job is an error. @@ -148,8 +147,7 @@ =20 ## # @job-resume: -# -# Resume a paused job. +# Resume a paused job. # # This command returns immediately after resuming a paused job. # Resuming an already running job is an error. @@ -165,10 +163,9 @@ =20 ## # @job-cancel: -# -# Instruct an active background job to cancel at the next opportunity. -# This command returns immediately after marking the active job for -# cancellation. +# Instruct an active background job to cancel at the next +# opportunity. This command returns immediately after marking the +# active job for cancellation. # # The job will cancel as soon as possible and then emit a # `JOB_STATUS_CHANGE` event. Usually, the status will change to @@ -184,9 +181,9 @@ =20 ## # @job-complete: -# -# Manually trigger completion of an active job in the READY or STANDBY -# state. Completing the job in any other state is an error. +# Manually trigger completion of an active job in the READY or +# STANDBY state. Completing the job in any other state is an +# error. # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive @@ -211,14 +208,13 @@ =20 ## # @job-dismiss: -# -# Deletes a job that is in the CONCLUDED state. This command only -# needs to be run explicitly for jobs that don't have automatic -# dismiss enabled. In turn, automatic dismiss may be enabled only for -# jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` -# and `block-stream`. @auto-dismiss is enabled by default for these -# jobs. +# Deletes a job that is in the CONCLUDED state. This command only +# needs to be run explicitly for jobs that don't have automatic +# dismiss enabled. In turn, automatic dismiss may be enabled only +# for jobs that have @auto-dismiss option, which are +# `drive-backup`, `blockdev-backup`, `drive-mirror`, +# `blockdev-mirror`, `block-commit` and `block-stream`. +# @auto-dismiss is enabled by default for these jobs. # # This command will refuse to operate on any job that has not yet # reached its terminal state, CONCLUDED. For jobs that make use of @@ -233,11 +229,10 @@ =20 ## # @job-finalize: -# -# Instructs all jobs in a transaction (or a single job if it is not -# part of any transaction) to finalize any graph changes and do any -# necessary cleanup. This command requires that all involved jobs are -# in the PENDING state. +# Instructs all jobs in a transaction (or a single job if it is +# not part of any transaction) to finalize any graph changes and +# do any necessary cleanup. This command requires that all +# involved jobs are in the PENDING state. # # For jobs in a transaction, instructing one job to finalize will # force ALL jobs in the transaction to finalize, so it is only diff --git a/qapi/machine.json b/qapi/machine.json index aaecd151407..45e79c18b09 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1978,12 +1978,12 @@ ## # @query-cpu-model-comparison: # -# Compares two CPU models, @modela and @modelb, returning how they -# compare in a specific configuration. The results indicates how both -# models compare regarding runnability. This result can be used by -# tooling to make decisions if a certain CPU model will run in a -# certain configuration or if a compatible CPU model has to be created -# by baselining. +# Compares two CPU models, @modela and @modelb, returning how they +# compare in a specific configuration. The results indicates how +# both models compare regarding runnability. This result can be +# used by tooling to make decisions if a certain CPU model will +# run in a certain configuration or if a compatible CPU model has +# to be created by baselining. # # Usually, a CPU model is compared against the maximum possible CPU # model of a certain configuration (e.g. the "host" model for KVM). @@ -2034,10 +2034,10 @@ ## # @query-cpu-model-baseline: # -# Baseline two CPU models, @modela and @modelb, creating a compatible -# third model. The created model will always be a static, -# migration-safe CPU model (see "static" CPU model expansion for -# details). +# Baseline two CPU models, @modela and @modelb, creating a +# compatible third model. The created model will always be a +# static, migration-safe CPU model (see "static" CPU model +# expansion for details). # # This interface can be used by tooling to create a compatible CPU # model out two CPU models. The created CPU model will be identical @@ -2105,11 +2105,11 @@ =20 ## # @query-cpu-model-expansion: -# -# Expands a given CPU model, @model, (or a combination of CPU model + -# additional options) to different granularities, specified by @type, -# allowing tooling to get an understanding what a specific CPU model -# looks like in QEMU under a certain configuration. +# Expands a given CPU model, @model, (or a combination of CPU +# model + additional options) to different granularities, +# specified by @type, allowing tooling to get an understanding +# what a specific CPU model looks like in QEMU under a certain +# configuration. # # This interface can be used to query the "host" CPU model. # diff --git a/qapi/migration.json b/qapi/migration.json index 13c446b922f..2c490736019 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -1820,9 +1820,9 @@ =20 ## # @calc-dirty-rate: -# -# Start measuring dirty page rate of the VM. Results can be retrieved -# with `query-dirty-rate` after measurements are completed. +# Start measuring dirty page rate of the VM. Results can be +# retrieved with `query-dirty-rate` after measurements are +# completed. # # Dirty page rate is the number of pages changed in a given time # period expressed in MiB/s. The following methods of calculation are @@ -1939,8 +1939,7 @@ =20 ## # @set-vcpu-dirty-limit: -# -# Set the upper limit of dirty page rate for virtual CPUs. +# Set the upper limit of dirty page rate for virtual CPUs. # # Requires KVM with accelerator property "dirty-ring-size" set. A # virtual CPU's dirty page rate is a measure of its memory load. To diff --git a/qapi/misc-i386.json b/qapi/misc-i386.json index 78ec9aec647..6e0ab46b8ea 100644 --- a/qapi/misc-i386.json +++ b/qapi/misc-i386.json @@ -5,10 +5,9 @@ =20 ## # @rtc-reset-reinjection: -# -# Reset the RTC interrupt reinjection backlog. Can be used if another -# mechanism to synchronize guest time is in effect, for example QEMU -# guest agent's `guest-set-time` command. +# Reset the RTC interrupt reinjection backlog. Can be used if +# another mechanism to synchronize guest time is in effect, for +# example QEMU guest agent's `guest-set-time` command. # # Use of this command is only applicable for x86 machines with an RTC, # and on other machines will silently return without performing any @@ -119,8 +118,7 @@ =20 ## # @query-sev: -# -# Return information about SEV/SEV-ES/SEV-SNP. +# Return information about SEV/SEV-ES/SEV-SNP. # # If unavailable due to an incompatible configuration the returned # @enabled field is set to 'false' and the state of all other fields @@ -149,8 +147,7 @@ =20 ## # @query-sev-launch-measure: -# -# Query the SEV/SEV-ES guest launch information. +# Query the SEV/SEV-ES guest launch information. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. The launch @@ -199,8 +196,7 @@ =20 ## # @query-sev-capabilities: -# -# Get SEV capabilities. +# Get SEV capabilities. # # This is only supported on AMD X86 platforms with KVM enabled. # @@ -220,8 +216,7 @@ =20 ## # @sev-inject-launch-secret: -# -# Inject a secret blob into a SEV/SEV-ES guest's memory. +# Inject a secret blob into a SEV/SEV-ES guest's memory. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. SEV-SNP guests do @@ -257,8 +252,7 @@ =20 ## # @query-sev-attestation-report: -# -# Get the SEV attestation report. +# Get the SEV attestation report. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. The attestation diff --git a/qapi/misc.json b/qapi/misc.json index 374711ac6c7..44f38b60448 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -12,9 +12,8 @@ =20 ## # @add_client: -# -# Allow client connections for VNC, Spice and socket based character -# devices to be passed in to QEMU via SCM_RIGHTS. +# Allow client connections for VNC, Spice and socket based +# character devices to be passed in to QEMU via SCM_RIGHTS. # # If the FD associated with @fdname is not a socket, the command will # fail and the FD will be closed. diff --git a/qapi/net.json b/qapi/net.json index 50dc3137182..6beabc0e9dd 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -37,8 +37,7 @@ =20 ## # @netdev_add: -# -# Add a network backend. +# Add a network backend. # # Additional arguments depend on the type. # diff --git a/qapi/stats.json b/qapi/stats.json index af57ec08546..e9d05390c31 100644 --- a/qapi/stats.json +++ b/qapi/stats.json @@ -175,9 +175,8 @@ =20 ## # @query-stats: -# -# Return runtime-collected statistics for objects such as the VM or -# its vCPUs. +# Return runtime-collected statistics for objects such as the VM +# or its vCPUs. # # The arguments are a `StatsFilter` and specify the provider and # objects to return statistics about. diff --git a/qapi/transaction.json b/qapi/transaction.json index c0dc811ba61..02e1d072c63 100644 --- a/qapi/transaction.json +++ b/qapi/transaction.json @@ -198,9 +198,9 @@ ## # @transaction: # -# Executes a number of transactionable QMP commands atomically. If -# any operation fails, then the entire set of actions will be -# abandoned and the appropriate error returned. +# Executes a number of transactionable QMP commands atomically. +# If any operation fails, then the entire set of actions will be +# abandoned and the appropriate error returned. # # For external snapshots, the dictionary contains the device, the file # to use for the new snapshot, and the format. The default format, if diff --git a/qapi/ui.json b/qapi/ui.json index a59cd635774..73ee2cb2056 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -1198,8 +1198,7 @@ =20 ## # @input-send-event: -# -# Send input event(s) to guest. +# Send input event(s) to guest. # # The @device and @head parameters can be used to send the input event # to specific input devices in case (a) multiple input devices of the --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158751; cv=none; d=zohomail.com; s=zohoarc; b=cPQY1oLTvHT+xYAfKLDeF/ac/UucnHewuYUSoQQJOwvgb46/3g7U2se4Mg3xZ2uTA1/O+GcRxMvApma01lAgrGHxgJaxRU9q683ke8zOXEjjy5hPhv98N+7ua3ODohgcm2sOWOwh9lLNT7tE29Z4BGc9QYWChFYLDG0vnvnssIE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158751; 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=gGr/UWXR8QBt7azgEUBob2p3J6+ruyHNYDqTJ5iERoQ=; b=cbwS9gvgpO3IwEh4hqBUJziZ++kE9ThOnU6LrPBLwkShyCbXJDOsYATUe3UZcPiL/hmWeg+Q5TyAcoaXJilM6cEgkl0XgWjdtuHC1n87VfKx+0sRU9UuBgMOGwkv0yUJRa5g4MsoNeTnzQyx/KYLeEdTbhU2ppXZPdhME/Y9u7M= 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 1789158751922158.55819942717255; Fri, 11 Sep 2026 13:32:31 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57uG-0001aG-0g; Fri, 11 Sep 2026 16:31:32 -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 1x57tm-0001OG-HL for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:04 -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 1x57tc-0005B2-9C for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:30:53 -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-664-Q6l4SDNhNr6nmtKDzizGZQ-1; Fri, 11 Sep 2026 16:30:48 -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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id B7B41195422A; Fri, 11 Sep 2026 20:30:46 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 9847E41B; Fri, 11 Sep 2026 20:30:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158651; 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=gGr/UWXR8QBt7azgEUBob2p3J6+ruyHNYDqTJ5iERoQ=; b=BtpSu3wlElzkKft9bDQ35fmYDK1q7aKsGFxUinib7tgmDCyb3REkZSFhpap9Fc12BSYK1O tECusK6PRpCftJ1x65axq04Vb4yIisd+0ssPBVKZGhav70rkOpP+sgrp7ZtvdGlHh6sg00 Un3D2K7bMZP4PaFSB6swlbuu9PmWZlE= X-MC-Unique: Q6l4SDNhNr6nmtKDzizGZQ-1 X-Mimecast-MFC-AGG-ID: Q6l4SDNhNr6nmtKDzizGZQ_1789158646 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 6/9] qapi: split intro sections for events Date: Fri, 11 Sep 2026 16:29:59 -0400 Message-ID: <20260911203002.305316-7-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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=jsnow@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: 1789158753074158500 Content-Type: text/plain; charset="utf-8" Review notes: Only one event; as in the command splitting patch, the details section is not physically relocated; I will change this if requested - but as we are not finished review, I prefer to keep it this way to ensure mechanical ease of separating "changes" from "motion" as is customary in our lands. (Hint: relocating "Since:" and "Details" sections is a colossal amount of purely mechanical motion, so I recommend we simply deal with it all at once when we are done agreeing on the splits.) Signed-off-by: John Snow --- qapi/machine-s390x.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index dcbad9b4039..670a1f9d926 100644 --- a/qapi/machine-s390x.json +++ b/qapi/machine-s390x.json @@ -57,8 +57,7 @@ =20 ## # @CPU_POLARIZATION_CHANGE: -# -# Emitted when the guest asks to change the polarization. +# Emitted when the guest asks to change the polarization. # # The guest can tell the host (via the PTF instruction) whether the # CPUs should be provisioned using horizontal or vertical --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158770; cv=none; d=zohomail.com; s=zohoarc; b=Fqxx0PBwrH+mWGVjItIzhx67tZisQ4yE4/KxlvbUA0DrGJX2SGUiW6ebaqz6r7/5UaHObM0mWcwFZn/eobPBDe6oXMpUKmhu8Pkkus7nwJEypYq1Hsg2MoPRLDyvONQLythCs+NacClxpWcELUY1BgjqVnfbPOycW9rKYmHEDng= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158770; 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=Y75EKOL//SeKRg4epcc8Gwig3KC5nLPbkfyHHKYGReo=; b=HK+73+nO6W3FA5vQncAK7tvqR7sdiSgGh2BDbsS7qNmaYQCSqv9JoS2nfXy7Y6bb1r5VqV+EcNpf5yDm9+EaEJa1mAOftDQ2LQWB93J7pB3wQ5eh7OJgdw7IG1x9K2GfEQUMglTe1ZP+ATeiVApQa7TO/PvDeYKZ3oCtePrWj/Q= 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 17891587706641010.4113279006622; Fri, 11 Sep 2026 13:32:50 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57uG-0001bw-M2; Fri, 11 Sep 2026 16:31:33 -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 1x57tn-0001OJ-TC for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:04 -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 1x57tm-0005Da-Ah for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:03 -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-671-LkvrA6AfNa-Mf6KsTLOVyw-1; Fri, 11 Sep 2026 16:30:55 -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 B310D1956056; Fri, 11 Sep 2026 20:30:53 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 4EFBA5C0; Fri, 11 Sep 2026 20:30:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158658; 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=Y75EKOL//SeKRg4epcc8Gwig3KC5nLPbkfyHHKYGReo=; b=PC/2c043lE06GqzwDp8+6rP4Pi49rlmiMBWBFyryUfWbQ5s5ti8PkTJnVfUBYv4zK5oacB 2oC3iv9vT6RNq88o4F0hoaaLVejoBtsQigmOCi2jZWg7eP5OnG4rh8IXm4cf+cXFim61Af vx8gwxrXWU7sdLzNP43gKusKAu+tarU= X-MC-Unique: LkvrA6AfNa-Mf6KsTLOVyw-1 X-Mimecast-MFC-AGG-ID: LkvrA6AfNa-Mf6KsTLOVyw_1789158653 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 7/9] qapi: split intro sections for enums Date: Fri, 11 Sep 2026 16:30:00 -0400 Message-ID: <20260911203002.305316-8-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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.129.124; envelope-from=jsnow@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: 1789158771587158500 Content-Type: text/plain; charset="utf-8" Review notes: Only one enum in this category, and it's fairly trivial. Signed-off-by: John Snow --- qapi/ui.json | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index 73ee2cb2056..9e3e80a3d70 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -814,10 +814,9 @@ =20 ## # @QKeyCode: +# An enumeration of key name. # -# An enumeration of key name. -# -# This is used by the `send-key` command. +# This is used by the `send-key` command. # # @unmapped: since 2.0 # --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158749; cv=none; d=zohomail.com; s=zohoarc; b=XLrioOY7eBai4FXH/S1pWSJCMaoUUFK8N7dYSeR8rTKbKANAKFyBqU34AJ6YuLSvT0jHuz8oXo1GmwNpuL2I+bX0nxGN4eYp6gaVpt/h3+f3ZsVSfd1vioeD6N7yk5MVnS+uyeQVe+GRGlyEQeOJ0MqJ/iaiSQD6zUK/1clG5W0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158749; 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=4BcsrOVOcLy3tNZJNmTmhb9jPpeDp9PEH0h5IkATk9M=; b=IrLGa3cABn0i/ItfWmEcBNDh0b4UWZBIYArRQZfXc0u3ZDcQEhWWTdn1kORSylPdvRI3OBt73qOe37Er5iXcPPP1kq3SpTDAI2h8jzX55b4iTolKq+lmRlSF9F6+8ZhtiyOkBkfv7lMnt7HNzO0Uh9D9qNCOC3n+sZ9EXvQ1mgw= 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 1789158749825807.0702086091057; Fri, 11 Sep 2026 13:32:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57um-00028n-UL; Fri, 11 Sep 2026 16:32:05 -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 1x57ts-0001Pd-6E for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:11 -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 1x57tp-0005EV-Vd for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:07 -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-684-o-_EiFy2MO-cgoXVK8kqsQ-1; Fri, 11 Sep 2026 16:31:00 -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 C10031955BF8; Fri, 11 Sep 2026 20:30:58 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EA02626D; Fri, 11 Sep 2026 20:30:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158665; 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=4BcsrOVOcLy3tNZJNmTmhb9jPpeDp9PEH0h5IkATk9M=; b=Kuw39ShZofuhmuSK6jHQw1s71oBUHNmZRFBcFEGDS1Tbc0Nmf+d8Do3vMsJTFqFX3htTN3 ++he4H2pmre/TxCIqSkGF5sb88Def3Ylz2716zO/YRueT24ZkwfTy4qqJRDN86ab3icbFa EW/4B1qMoUG9Vel+Mkgywa+tR+1Crt8= X-MC-Unique: o-_EiFy2MO-cgoXVK8kqsQ-1 X-Mimecast-MFC-AGG-ID: o-_EiFy2MO-cgoXVK8kqsQ_1789158658 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 8/9] qapi: split intro sections for data structs Date: Fri, 11 Sep 2026 16:30:01 -0400 Message-ID: <20260911203002.305316-9-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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=jsnow@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: 1789158751743158500 Content-Type: text/plain; charset="utf-8" The structs of concern in this patch are those for which no other QAPI definition uses as a data type to describe its own arguments or as a branch of a union: i.e. they are not currently inlined and as such the precise semantics of their intro/details split is *currently* of less concern. Of course, they could be inlined in the future, so the semantics of this split are still worth investigating. Review notes: Similar notes as previous patches in this series with respect to how splits were determined, and why details were not physically relocated. Signed-off-by: John Snow --- qapi/acpi.json | 3 +-- qapi/block-core.json | 5 ++--- qapi/compat.json | 3 +-- qapi/machine.json | 9 ++++----- 4 files changed, 8 insertions(+), 12 deletions(-) diff --git a/qapi/acpi.json b/qapi/acpi.json index 291a04a7ea4..82e82d7cf89 100644 --- a/qapi/acpi.json +++ b/qapi/acpi.json @@ -13,8 +13,7 @@ =20 ## # @AcpiTableOptions: -# -# Specify an ACPI table on the command line to load. +# Specify an ACPI table on the command line to load. # # At most one of @file and @data can be specified. The list of files # specified by any one of them is loaded and concatenated in order. diff --git a/qapi/block-core.json b/qapi/block-core.json index ec052f6bd2d..80f6c41c381 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -803,9 +803,8 @@ =20 ## # @BlockMeasureInfo: -# -# Image file size calculation information. This structure describes -# the size requirements for creating a new image file. +# Image file size calculation information. This structure +# describes the size requirements for creating a new image file. # # The size requirements depend on the new image file format. File # size always equals virtual disk size for the 'raw' format, even for diff --git a/qapi/compat.json b/qapi/compat.json index ef1853b9acd..b42d142ddcc 100644 --- a/qapi/compat.json +++ b/qapi/compat.json @@ -37,8 +37,7 @@ =20 ## # @CompatPolicy: -# -# Policy for handling deprecated management interfaces. +# Policy for handling deprecated management interfaces. # # This is intended for testing users of the management interfaces. # diff --git a/qapi/machine.json b/qapi/machine.json index 45e79c18b09..05a2851c0fc 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1606,9 +1606,9 @@ =20 ## # @SMPConfiguration: -# -# Schema for CPU topology configuration. A missing value lets QEMU -# figure out a suitable value based on the ones that are provided. +# Schema for CPU topology configuration. A missing value lets +# QEMU figure out a suitable value based on the ones that are +# provided. # # The members other than @cpus and @maxcpus define a topology of # containers. @@ -1867,8 +1867,7 @@ =20 ## # @CpuModelInfo: -# -# Virtual CPU model. +# Virtual CPU model. # # A CPU model consists of the name of a CPU definition, to which delta # changes are applied (e.g. features added/removed). Most magic --=20 2.55.0 From nobody Sat Sep 26 22:13:59 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=1789158749; cv=none; d=zohomail.com; s=zohoarc; b=k6sdURDBZrU6Z4reo1C/F4jFA7ZFZFmhfBu5F5KSppti/LWuQgysVQ/flTA79hvF/NAzy7tD7Cvqa/k60tqC8bqwie7T0C/vOXZcZePtIMpnemd/Fm/4xDCy8yQaRAIr551K1uC7l3AstJ7m7TGRPSGEVFpScU9gwaD7OxH92fs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789158749; 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=ojJHZabKSohJ/qkXkEV6skUgdylBLdnUiEREoGq4xMk=; b=OIDV8DaPIytiaXkr31aWAhMisWYHHlLazNXmymBiMnULSnMV7j50ObiqcInvuEwE75QkoFC4hE3NTsmDiG2QToByWhcXjv1T6ReySAHmZBkaAiLezvcPJYEVkLy0Kep7LsCBz/zq+utZLyBodyCFnjdP+4nfLoXbZlgSuxpJz2o= 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 1789158749889454.427580071698; Fri, 11 Sep 2026 13:32:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x57un-0002DC-KI; Fri, 11 Sep 2026 16:32:06 -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 1x57tx-0001Qd-E2 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:15 -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 1x57tv-0005FW-EV for qemu-devel@nongnu.org; Fri, 11 Sep 2026 16:31:12 -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-450-waxcx1QCOWCyqs56XWxSOw-1; Fri, 11 Sep 2026 16:31:06 -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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 7394319540E2; Fri, 11 Sep 2026 20:31:04 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.45]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 04BB826D; Fri, 11 Sep 2026 20:30:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789158670; 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=ojJHZabKSohJ/qkXkEV6skUgdylBLdnUiEREoGq4xMk=; b=IX82CkJ/9+j+71pYGDjV1SB/7UVc4pzOuIRF/UM+VLNny6U6z9fgd/7bmcyev13jd61DYZ KGU3aeOOnoSKGO+XFw06GhDoBSdnCJHAT0I97XE4BuRPeWI5FU3L49OY/3TlGuvYDWV64Q 1KNQlPsmHGjpVPWcoNve3bb3eFEcsAs= X-MC-Unique: waxcx1QCOWCyqs56XWxSOw-1 X-Mimecast-MFC-AGG-ID: waxcx1QCOWCyqs56XWxSOw_1789158664 From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Jason Wang , Paolo Bonzini , Fabiano Rosas , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Hanna Reitz , Kevin Wolf , Markus Armbruster , Vladimir Sementsov-Ogievskiy , qemu-block@nongnu.org, John Snow , Eric Blake , Igor Mammedov , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , "Michael S. Tsirkin" , Peter Xu , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Ani Sinha Subject: [PATCH 9/9] qapi: split intro sections for inlinable structs Date: Fri, 11 Sep 2026 16:30:02 -0400 Message-ID: <20260911203002.305316-10-jsnow@redhat.com> In-Reply-To: <20260911203002.305316-1-jsnow@redhat.com> References: <20260911203002.305316-1-jsnow@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=jsnow@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: 1789158751752158500 Content-Type: text/plain; charset="utf-8" This patch splits the intro/details section for structs which are used in an inlinable context; i.e. structs used either as arguments for a command/event, or used as a branch of a union. The QAPI documentation block for these entities will have their "intro" section removed when inlined into other contexts, but may still display the intro section on generated documentation *IF* these structs are also used as an argument or return type. Review notes: Same ol' Same ol'. Signed-off-by: John Snow --- qapi/block-export.json | 5 ++--- qapi/crypto.json | 3 +-- qapi/machine.json | 3 +-- qapi/qom.json | 9 +++------ 4 files changed, 7 insertions(+), 13 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index 77459f6321b..e3cee2fb5ce 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -154,9 +154,8 @@ =20 ## # @BlockExportOptionsFuse: -# -# Options for exporting a block graph node on some (file) mountpoint -# as a raw image. +# Options for exporting a block graph node on some (file) +# mountpoint as a raw image. # # Multi-threading note: The FUSE export supports multi-threading. # Currently, requests are distributed across these threads in a diff --git a/qapi/crypto.json b/qapi/crypto.json index f85d1cebed3..5ae07d650a6 100644 --- a/qapi/crypto.json +++ b/qapi/crypto.json @@ -429,8 +429,7 @@ =20 ## # @SecretProperties: -# -# Properties for secret objects. +# Properties for secret objects. # # Either @data or @file must be provided, but not both. # diff --git a/qapi/machine.json b/qapi/machine.json index 05a2851c0fc..b1064b53ae3 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -899,8 +899,7 @@ =20 ## # @CpuInstanceProperties: -# -# Properties identifying a CPU. +# Properties identifying a CPU. # # Which members are optional and which mandatory depends on the # architecture and board. diff --git a/qapi/qom.json b/qapi/qom.json index 3de06488768..d80dd5976ed 100644 --- a/qapi/qom.json +++ b/qapi/qom.json @@ -456,8 +456,7 @@ =20 ## # @FilterRedirectorProperties: -# -# Properties for filter-redirector objects. +# Properties for filter-redirector objects. # # At least one of @indev or @outdev must be present. If both are # present, they must not refer to the same character device backend. @@ -756,8 +755,7 @@ =20 ## # @MemoryBackendShmProperties: -# -# Properties for memory-backend-shm objects. +# Properties for memory-backend-shm objects. # # This memory backend supports only shared memory, which is the # default. @@ -771,8 +769,7 @@ =20 ## # @MemoryBackendEpcProperties: -# -# Properties for memory-backend-epc objects. +# Properties for memory-backend-epc objects. # # The @merge boolean option is false by default with epc # --=20 2.55.0