From nobody Sat Sep 26 20:00:46 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=1790024357; cv=none; d=zohomail.com; s=zohoarc; b=ckESzB7rscnFtrybx2NPh1TjhAuPLzZGf8Y+jDG7C9p5iC3SSEBho8W5LQu8CfNyaayaPZ71sITvm+MEfyyzMt2UHY7S6DOgsxJ26SnsxED2EmPYOII+1pWZq4z7ZDomY3SelWB0xdS4wO3MDI2Ladb1UwsqgjBCC8uG4XPNswg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024357; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=646PQsEKIk89d13v0jhgd3QeHbBDbSRs3ZeePM5f+fE=; b=PRbA+9pkUNJhAJS9E09jOMEm9lbMSe4tVvTc9m3igyluO7bRzsjudlD8SzWnvp35WWIB8XPczw4F1YenhcLzVARgCfptqYM2/Vid0RawrT4ekWCyO3LPa225Erixlhc1Hy4dfdrijaDmeqEXz5yhm1iP1oG6nydMCOpHAU1i7A0= 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 1790024357219774.4780856415981; Mon, 21 Sep 2026 13:59:17 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l4t-0005BZ-Ma; Mon, 21 Sep 2026 16:57: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 1x8l4q-00059t-90 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:29 -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 1x8l4o-0003Un-Ov for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:28 -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-617-fqAr-OUKPoW_4LnkDi_Aog-1; Mon, 21 Sep 2026 16:57:22 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 1728819540DA; Mon, 21 Sep 2026 20:57:21 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 17DF51956042; Mon, 21 Sep 2026 20:57:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024246; 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=646PQsEKIk89d13v0jhgd3QeHbBDbSRs3ZeePM5f+fE=; b=i9M3+Ta8cAzldSfv0NmEJmjzZo55YTjFHzrfF37Lw8tB44LujKJDdjmx+50Yr6KJsl/M/s 1ZeN9AfISCOP01Nb8jnzIH3Ah1p5MFjI1JDuvey3kgGgn9XH7BBaoRDXKvVwdK8/e55rik DKaqXS6yZcFkg2OmjA1KigKzRVVgNdA= X-MC-Unique: fqAr-OUKPoW_4LnkDi_Aog-1 X-Mimecast-MFC-AGG-ID: fqAr-OUKPoW_4LnkDi_Aog_1790024241 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 01/10] qapi: split intro for HV_BALLOON_STATUS_REPORT Date: Mon, 21 Sep 2026 16:57:03 -0400 Message-ID: <20260921205712.1862167-2-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024357751158500 Content-Type: text/plain; charset="utf-8" This changes the rendering for this event by adding a new insertion point right after the introductory paragraph, before the ".. note::". Because this event features auto-inserted member documentation ("The members of "HvBalloonInfo"), creating this new split point changes the rendered documentation - the ".. note::" now appears below the generated member documentation instead of above it. Signed-off-by: John Snow --- qapi/machine.json | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 84d95c8d87f..276258d9e5c 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1209,9 +1209,8 @@ =20 ## # @HV_BALLOON_STATUS_REPORT: -# -# Emitted when the hv-balloon driver receives a "STATUS" message from -# the guest. +# Emitted when the hv-balloon driver receives a "STATUS" message +# from the guest. # # .. note:: This event is rate-limited. # --=20 2.55.0 From nobody Sat Sep 26 20:00:46 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=1790024268; cv=none; d=zohomail.com; s=zohoarc; b=USCT+1G6cfqWXfgPYix9PJ6Tf+ebKGhDbbRKqL61CrkcqP80FpEPukeOKogHnJUMAkPzRYLt2OBq2MZl1ZAvdVha8hZto2eZdMnOG6s1HVrueWXb6lVTM1fiM9G/JbEEZQbbAdeLiIW4t4yme5a40qP2psBDOy9XZp/BDtXgl2Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024268; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=CT6/gXNbFAojbYEnwwznDu12ElaNbWuWVrzBHmX1X2Y=; b=UhFHDvA2s5+C9hXYmuJRGP3VfsedU8hQs2Qus8dBIW0EIAPAyFlo0zfOWqu2am4I3fDlDDFgZ25li9O+M4qBpelIKQp4L5catQtjFe+LniVYcDt954afNqWX4b7OnSr3ifBZx2OrX02wIspn7a7lPkiCfS+f9rgcxnj08aeb7lA= 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 1790024268586726.1607418888589; Mon, 21 Sep 2026 13:57:48 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l4w-0005Fm-Qv; Mon, 21 Sep 2026 16:57:34 -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 1x8l4v-0005Da-Bt for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:33 -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 1x8l4s-0003VV-0t for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:33 -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-691-8Ff406DQP_W8q8tVNMLzUw-1; Mon, 21 Sep 2026 16:57:25 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 6F4441953976; Mon, 21 Sep 2026 20:57:24 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 4E8491956047; Mon, 21 Sep 2026 20:57:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024249; 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=CT6/gXNbFAojbYEnwwznDu12ElaNbWuWVrzBHmX1X2Y=; b=h1sPiipg1dfj35fqyoYc8KoC1Quj9U7ERobo5U1nZAOvGL/JqFhpGyttjOHf+X0mzS24Hc 5lF1/gP2zgvvMna4mhbHiAskm9aICAqPxbGahAXQbMNvo/u1JRJFAQ5wrCDlgXDfznuB7/ mXa4HO807mqvSLeunEd8VcJ4B3t7mH4= X-MC-Unique: 8Ff406DQP_W8q8tVNMLzUw-1 X-Mimecast-MFC-AGG-ID: 8Ff406DQP_W8q8tVNMLzUw_1790024244 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 02/10] qapi: convert/split intros for block-core.json commands Date: Mon, 21 Sep 2026 16:57:04 -0400 Message-ID: <20260921205712.1862167-3-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024270057158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- qapi/block-core.json | 126 +++++++++++++++++++------------------------ 1 file changed, 55 insertions(+), 71 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index 802a4af74ed..13981d7e69d 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -1556,8 +1556,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. # @@ -1812,13 +1811,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: # @@ -1883,9 +1881,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 @@ -2510,16 +2507,15 @@ =20 ## # @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 @@ -2865,8 +2861,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 @@ -2977,8 +2972,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. # @@ -3003,8 +2997,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 @@ -3046,8 +3039,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. @@ -3079,8 +3071,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. @@ -3108,9 +3099,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 @@ -3148,14 +3139,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 @@ -3177,11 +3167,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 @@ -4917,14 +4906,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 @@ -4996,9 +4984,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 @@ -5881,15 +5868,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. # @@ -5911,8 +5897,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 @@ -5971,11 +5956,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 # --=20 2.55.0 From nobody Sat Sep 26 20:00:46 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=1790024325; cv=none; d=zohomail.com; s=zohoarc; b=Nvkh6HUIRTZ28Lingvk+uq9egmV9XvUC94pzMBfNQN0zt480l+qZ4loTPqvrzMovDOsPJEeSnMW6iYMPs7jb81HgUPcpvfgP4JqCrFT5GFPHUxvcxk/+GYB/nWIPw7tDrvNYslAO0+zP00vKcnWHEhDDwoYWx7LZgIr2jLM6ql0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024325; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=kt2t3zSPoxXONQm23d5YW0VfdMmgbSssIDojekZC8YY=; b=cR+oU8s+p+ZVvG769BNF1t5HraOG5puVDGTyQGVWOmI8kTqtTUT5O6g9jDJyUbNGkHjNWOQE7FxUVZXfx5RzVZV4Nm8HUtiMpQuZeqXxwFDpiVs890Y7EOE0aRtptCmYasunNI4apDsFAL+hfYZii/F8jFtiY6htdBNnQJdT63A= 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 1790024325487276.1773373259633; Mon, 21 Sep 2026 13:58:45 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l4z-0005JI-BW; Mon, 21 Sep 2026 16:57:37 -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 1x8l4x-0005GF-6F for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:35 -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 1x8l4v-0003WI-KB for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57: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-346-QaKoRXiOOzSxQMr68J0sLA-1; Mon, 21 Sep 2026 16:57:29 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 7963519541AA; Mon, 21 Sep 2026 20:57:27 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A581D1956042; Mon, 21 Sep 2026 20:57:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024252; 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=kt2t3zSPoxXONQm23d5YW0VfdMmgbSssIDojekZC8YY=; b=XIc2IxL9Yidv0gNVP1oydPLFhlOLitBFP2kiocZfzFXk0wM7SJ2vhOL+e8supQagYkNJgb 7R0yvnUh232Qzwi4++LiRwDU3y1OMUs9A1tg4DfW/OGfMMatfphL9jI9xQKVL3Mz18KPXI viZ/Sr0cfNE34JZhTUhY6f0TMClJ0jU= X-MC-Unique: QaKoRXiOOzSxQMr68J0sLA-1 X-Mimecast-MFC-AGG-ID: QaKoRXiOOzSxQMr68J0sLA_1790024248 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 03/10] qapi: convert/split intros for block commands Date: Mon, 21 Sep 2026 16:57:05 -0400 Message-ID: <20260921205712.1862167-4-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024327811158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- qapi/block-export.json | 3 +-- qapi/block.json | 33 ++++++++++++++++----------------- 2 files changed, 17 insertions(+), 19 deletions(-) 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 bb222da3e25..13c47e1eb44 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -128,11 +128,12 @@ =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). +# 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. # @@ -181,10 +182,11 @@ =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. # @@ -218,13 +220,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 # @@ -429,8 +430,7 @@ =20 ## # @block_set_io_throttle: -# -# Change I/O throttle limits for a block drive. +# Change I/O throttle limits for a block drive. # # Since QEMU 2.4, each device with I/O limits is member of a throttle # group. @@ -504,8 +504,7 @@ =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) --=20 2.55.0 From nobody Sat Sep 26 20:00:46 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=1790024356; cv=none; d=zohomail.com; s=zohoarc; b=DEbA2fO8N9D5nxa9Ov9bXlpXzpZNk4YI1mu8yeW7HyWfbTltC4aeQni/M7SoY0O49gE95zIvPBT2/9doGy/j5cSaS/RqEiQ5VhyaLVIbRr0f/BP8yajhGmiI0IGXvqLA5QCxz8bfH2bIXlaxV8TIN3tmumzFN9qWe+FMpqG3+N0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024356; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=tvxpNyORierNGQUOqwuOaHgR/j0WTOhNPJNjkzjFekY=; b=nHrYXtUDb1VZ0TbluvI3wWfv/tDHDtdkJEQ9CU9oPGDjmq/EehaO58n80+FGyR0Jcikmcy+08baeNZzO/HlGOLAMUKSICY1rAxy8FRhfFeS/qGlcWz+BZF9xlKyggtPF9rVDTaGvAVAoh5WRIlDZiHoCgNKBWkMCxxwzFxL71lA= 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 1790024356056467.85165734050406; Mon, 21 Sep 2026 13:59:16 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l53-0005M7-0L; Mon, 21 Sep 2026 16:57:41 -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 1x8l4z-0005Kw-RA for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:37 -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 1x8l4x-0003YG-Sl for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:37 -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-456-PahojPbzPVeMzo_hyNIuag-1; Mon, 21 Sep 2026 16:57:31 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 7112C1933E3A; Mon, 21 Sep 2026 20:57:30 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id B07051956047; Mon, 21 Sep 2026 20:57:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024255; 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=tvxpNyORierNGQUOqwuOaHgR/j0WTOhNPJNjkzjFekY=; b=UgdlxE2XnQlMdkXDFOKYfk8ssEY4l0GW7qE4yEpLYdEJMbRrl50JRh4AXb2Jdo3kkjNjsZ VeTHyFFjobmAq1kn9loli8Yg/m8pJJQEmCtAo0LdeEeGIKj1gaen6uxHB1B1hJMyu6PUid xps4bbVEsnOuhHP3ufvOATgm9wuA82o= X-MC-Unique: PahojPbzPVeMzo_hyNIuag-1 X-Mimecast-MFC-AGG-ID: PahojPbzPVeMzo_hyNIuag_1790024250 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 04/10] qapi: convert/split intros for job.json commands Date: Mon, 21 Sep 2026 16:57:06 -0400 Message-ID: <20260921205712.1862167-5-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024357790158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- qapi/job.json | 42 +++++++++++++++++++----------------------- 1 file changed, 19 insertions(+), 23 deletions(-) diff --git a/qapi/job.json b/qapi/job.json index b68d7292423..aa75a8efa24 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,14 @@ =20 ## # @job-dismiss: +# Deletes a job that is in the CONCLUDED state. # -# 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 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 +230,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 --=20 2.55.0 From nobody Sat Sep 26 20:00:46 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=1790024349; cv=none; d=zohomail.com; s=zohoarc; b=BCgp/UwlwTFxa7LJyPUVlT5WjIYx/473RZX/W+cNRC5QXyK3mYJ9LFcVvLnT/Fs29T0tz0IRuVpf5e3vBurGHDhsSLXDORHCipQOmkerjS9zgXJiZ0hGT7s/dI4UgPnNdwVrCFvoCZ9vlDa2FhRWe/obhqhdErsMYC7ZdeQViao= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024349; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=vpoX4RSy+aP1zt1DUP+o9Dpt1K2FdILE+1ynIhz8ck4=; b=kq0HAF0ZrC5yIla0VD9NNFitH+6CVfGoM3B4VR2So7U2N37nbgrnT91nuCFEaXqrMG4ZvkUO/DgYb2pqr+lgygzS3Xbum4YC9zLPqbUlRl4oVCMl4HktWfN7hr8d9RCOCeCnDQCslYKO/jfb0IWSvF1GbvYOQMBiqC5g5hYsZ7k= 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 1790024349571942.079720087425; Mon, 21 Sep 2026 13:59:09 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l56-0005NV-I7; Mon, 21 Sep 2026 16:57:44 -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 1x8l53-0005Me-PK for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:41 -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 1x8l51-0003ZU-Qs for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:41 -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-501--v94nCkxOq2MdtbN7BYFfw-1; Mon, 21 Sep 2026 16:57:35 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 637591850D0B; Mon, 21 Sep 2026 20:57:34 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A656C1956042; Mon, 21 Sep 2026 20:57:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024259; 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=vpoX4RSy+aP1zt1DUP+o9Dpt1K2FdILE+1ynIhz8ck4=; b=XdSOEOsvUzY+d45bMYaKqjaDGcaEj9+vOSjtjACjntGcakczZZPxjhWZ6GYlGCGRD2+7XT 25i+CoSejg3PioPT5MSv5C37akZ+w/T0l+TJJ7knekcVPKK5PljAWAaLH+KpntPMuiZlm0 DItRfSXCZ27muR7aPf7ljrk6FwzjP5A= X-MC-Unique: -v94nCkxOq2MdtbN7BYFfw-1 X-Mimecast-MFC-AGG-ID: -v94nCkxOq2MdtbN7BYFfw_1790024254 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 05/10] qapi: convert/split intros for misc-i386.json commands Date: Mon, 21 Sep 2026 16:57:07 -0400 Message-ID: <20260921205712.1862167-6-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024352220158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- qapi/misc-i386.json | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) 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 --=20 2.55.0 From nobody Sat Sep 26 20:00:46 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=1790024287; cv=none; d=zohomail.com; s=zohoarc; b=T0b6WsEfdQ2IYJr+eRR+A7x7thjoTuquiXAwFllc9GBvvh0BG4IBtyOYftu3ShmgcGvORH4mKkj4z7vz4gD/PR9vn1twMC469norLOI88xqDLckB9Sb1TZh5AB87lkP7o8BGGGyesTh2qs5SF8hFG1DtvDCGA9eVDtNzQ14NHKQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024287; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=akpMxJqY/YX3lbLfFuudMfj4hb9Ch6XjPL6Yh/mpVo8=; b=jYdZlq3qLEfyvJBo/MqZ85YRTHQG25iCxGsIlfpgy2GQOnjp7N+PsVZlEo8mhso2OndGqSffg65LClinX6sghmichXujSSHk07ryyzfCCzqm3uQXlQSPd5fSO3yN0qq2Wyoi/2h80kUoLCZgR9l/BhK07cZlUtE2akGdi3duVok= 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 1790024287673840.7340917917849; Mon, 21 Sep 2026 13:58:07 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l58-0005Of-RO; Mon, 21 Sep 2026 16:57:47 -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 1x8l55-0005N0-KR for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:43 -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 1x8l53-0003Zr-IL for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:43 -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-250-ROCw8HI2Myq22v6owZ-fPQ-1; Mon, 21 Sep 2026 16:57:39 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 54F161955D63; Mon, 21 Sep 2026 20:57:37 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 99F1E1956042; Mon, 21 Sep 2026 20:57:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024261; 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=akpMxJqY/YX3lbLfFuudMfj4hb9Ch6XjPL6Yh/mpVo8=; b=OxuwZLxOMJY2itZg2fylygRW2TDrhaVJ3UUx7tyD8kOGJ18sCjwBMw6hjKJ5vtLvoSEFWW QY1x9SK1Q5VJVXZhs0sjPrCvzmTGeDI/kUN/ub+h+szzb+k+xXb5ubkyGORIpwuRm9D8BB K8yc7tYmyaYpWAP1g7JYr661byBHkYA= X-MC-Unique: ROCw8HI2Myq22v6owZ-fPQ-1 X-Mimecast-MFC-AGG-ID: ROCw8HI2Myq22v6owZ-fPQ_1790024257 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 06/10] qapi: convert/split intros for commands Date: Mon, 21 Sep 2026 16:57:08 -0400 Message-ID: <20260921205712.1862167-7-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024289722158500 Content-Type: text/plain; charset="utf-8" This patch converts or splits intro sections for commands with more than one paragraph of text. Signed-off-by: John Snow --- qapi/control.json | 3 +-- qapi/introspect.json | 16 ++++++++-------- qapi/machine.json | 31 +++++++++++++++---------------- qapi/migration.json | 12 +++++------- qapi/misc-arm.json | 5 ++--- qapi/misc.json | 8 +++----- qapi/net.json | 3 +-- qapi/qdev.json | 9 ++++----- qapi/stats.json | 5 ++--- qapi/transaction.json | 6 +++--- qapi/ui.json | 3 +-- 11 files changed, 45 insertions(+), 56 deletions(-) diff --git a/qapi/control.json b/qapi/control.json index 2788ce32e2f..ef63a8a261b 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/machine.json b/qapi/machine.json index 276258d9e5c..2d5c7c36ad9 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -2002,13 +2002,13 @@ =20 ## # @query-cpu-model-comparison: +# Compares two CPU models, @modela and @modelb, returning how they +# compare in a specific configuration. # -# 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. +# 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). @@ -2058,11 +2058,10 @@ =20 ## # @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 @@ -2130,11 +2129,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 a272e701385..8d3951ae429 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -1826,9 +1826,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 @@ -1945,8 +1945,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 @@ -1971,8 +1970,7 @@ =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 diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index 8cb2ea77951..9b018b29e2c 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -28,9 +28,8 @@ =20 ## # @query-gic-capabilities: -# -# It will return a list of `GICCapability` objects that describe its -# capability bits. +# Returns 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. diff --git a/qapi/misc.json b/qapi/misc.json index b62cabc2b79..b4bb8a662e6 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. @@ -185,8 +184,7 @@ =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 diff --git a/qapi/net.json b/qapi/net.json index d0bacb4dcfe..b0a15fd53e2 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/qdev.json b/qapi/qdev.json index a35321d2fd1..f390354d68e 100644 --- a/qapi/qdev.json +++ b/qapi/qdev.json @@ -162,11 +162,10 @@ =20 ## # @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 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 20:00:46 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=1790024316; cv=none; d=zohomail.com; s=zohoarc; b=PntesleXej+hfQbDI4eRwAgESLh+1GyoG9xkcHddlyEnfe532izM6aTC22HIoM9v3dCtwBwHGz5R1Y2v1o6Wg/p735+U2qIB8khZBTGlEGNPgGurUDoA9CutDWKko9w4eoAZqq2SBNFjSJ3V0kHI0e1Eeaw88jrRPLl7w/EM0nA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024316; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=kc/XYdzpCPM/opmKH3Ag10Q3HD+29JW99WZKro8Frp4=; b=NGEo4vzpu55g4JDbMp8WvLbJCCN9FTuSVrHkdBULql3/KY3j+TvuuSpROqt2GmgN2vNBmlNyPChIfi2J69p4IpLrDlhwA8ZDlRbXVhxnJ46lY0ZnZD2Myi1QasmnZmBoqIAuqKz18n2RY4+vp7T6UrDlD/CMz9zi5Q2G5A4HkzY= 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 1790024316443162.27490493388348; Mon, 21 Sep 2026 13:58:36 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l5N-0005Yx-Qw; Mon, 21 Sep 2026 16:58: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 1x8l5A-0005VB-0S for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:50 -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 1x8l58-0003be-Ao for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:47 -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-448-GBr_MBs5Ntq4EnOxu4Av4Q-1; Mon, 21 Sep 2026 16:57:42 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 89C18180AE0F; Mon, 21 Sep 2026 20:57:40 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 8C0671956042; Mon, 21 Sep 2026 20:57:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024265; 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=kc/XYdzpCPM/opmKH3Ag10Q3HD+29JW99WZKro8Frp4=; b=bSQMWQeNzqkzhO33pVv7ot0pwdflkBQe063JiCwBZ84ZSEeHjY2sUOG1ZrGVzFfNYnyl+8 6xbYSSLIj47D58ab4qPPoiU6js0s604qyHHoKGZLShkm8xPOVwnIyxKlPB38fYRIf9NIHS 196j4V2q+azt34BxZALCnxeYdVN8Glc= X-MC-Unique: GBr_MBs5Ntq4EnOxu4Av4Q-1 X-Mimecast-MFC-AGG-ID: GBr_MBs5Ntq4EnOxu4Av4Q_1790024260 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 07/10] qapi: convert/split intros for enums Date: Mon, 21 Sep 2026 16:57:09 -0400 Message-ID: <20260921205712.1862167-8-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: -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_H3=0.001, RCVD_IN_MSPIKE_WL=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: 1790024317873158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- qapi/machine.json | 22 ++++++++++------------ qapi/ui.json | 5 ++--- 2 files changed, 12 insertions(+), 15 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 2d5c7c36ad9..00a03e57b98 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -635,9 +635,9 @@ =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. @@ -657,9 +657,9 @@ =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. @@ -720,9 +720,8 @@ =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. @@ -741,9 +740,8 @@ =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. 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 20:00:46 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=1790024310; cv=none; d=zohomail.com; s=zohoarc; b=hxwzlV4QaI/QOvI4hORvtZbXujJYUGdWaFhhGvfaQHC7la+lVQF8KdJ60/tfpq9kssaxwQLFhtDUNP2Rdn7mtwIKmT17nXzIbeiUvhN50wN25iTk0PkoE1lSRi2sLb9FSA/EiLZLnYh0tNGpiVu9Zksd0TjnICzBpM4wsiKidTE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024310; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=KxcHGJFXJiHwesgizmX7pcWAT7Hzolyo0UNFYpJjAVQ=; b=VDTgDV5gBWizgNqO+/ImQNqM5oz647QPpksbV622C6KLmR26goLneHNqA4ADZNxFypkplHDDkS6gJf294IMM5BeOn1kFikHTAeLU8qzdS/7MI954oETJsAOttUTqp9ATjlL4+b8selmedcmlkB6WQQ3oLf/14VJNyXC0NzrwoX0= 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 1790024310820285.6005931622801; Mon, 21 Sep 2026 13:58:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l5b-0005j8-UA; Mon, 21 Sep 2026 16:58:20 -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 1x8l5C-0005WY-Ir for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:50 -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 1x8l5A-0003bw-IL for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:49 -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-199--9tOA-L2OmqyhhVxNg6IHg-1; Mon, 21 Sep 2026 16:57:45 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 AD0D719331B8; Mon, 21 Sep 2026 20:57:43 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BFE451956042; Mon, 21 Sep 2026 20:57:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024267; 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=KxcHGJFXJiHwesgizmX7pcWAT7Hzolyo0UNFYpJjAVQ=; b=AFUXiP/gQvYEr8QzHB/L1me6LxKmIINrTox6ul1SGghHiMMm8uMvN5n1tgbCZrn3jyFIWZ xWSmhaE9a0lvVzO403+HMrufXT4ao29zUhRaEB+EHKhPy+Zb3WzfCklLDWseMigsac7XRp hCEiyAYR78U/miW2Oei9UycHjSMYBuc= X-MC-Unique: -9tOA-L2OmqyhhVxNg6IHg-1 X-Mimecast-MFC-AGG-ID: -9tOA-L2OmqyhhVxNg6IHg_1790024263 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 08/10] qapi: split intro sections for events Date: Mon, 21 Sep 2026 16:57:10 -0400 Message-ID: <20260921205712.1862167-9-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024313605158500 Content-Type: text/plain; charset="utf-8" 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 20:00:46 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=1790024316; cv=none; d=zohomail.com; s=zohoarc; b=YHv3FPUBln3GvujRIyl+f7XFo/JlqctXHY9iqRb3e6x4nQtLRLDn3Jp08GrT5W+Cisvd2ZZL1p4Vvd5zEJD+z1vhB8/INzPe5hb3bKbXAjqddyEZnM00tTKTp9YCiJabeM5GxBySxQoVRd6vnquhfTVhca5cz346F9NOIXKGNyM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024316; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=FhC9+EyQuQfdNCJkMIalX3nmZlPTjCLuc8ixrTiDyYU=; b=hbj4J46x3sF7lvxbUhe/o0GEfkEdG67SWXKab6LO00j81cmthcG2yX4+3OABrZMZsYATzJVPZu2YetzXDeDO3+ww50l+gi7grt2dSG8KVJvPf9jYeozgjF6vHHCmJUPYh8fDOSfbdfHjdx300WzNAteuQeI14G8E/hEj6FjyfDc= 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 17900243163840.7508769292626312; Mon, 21 Sep 2026 13:58:36 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l5g-0005jx-SF; Mon, 21 Sep 2026 16:58:22 -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 1x8l5K-0005bn-3U for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:58:00 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x8l5G-0003d5-0J for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:55 -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-361-YR8IM5GcPYy8eeg5TXudZg-1; Mon, 21 Sep 2026 16:57:48 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 A22AB1933E27; Mon, 21 Sep 2026 20:57:46 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BE7921956042; Mon, 21 Sep 2026 20:57:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024272; 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=FhC9+EyQuQfdNCJkMIalX3nmZlPTjCLuc8ixrTiDyYU=; b=NysDXK7KF1pjO8pvo+8D24ghxysVMFy43r+s0TUMgasTUUNxy1Jd9WmEh0bpV0jWliAWF+ o7GN3fTjs3JIKLhnDdIT7un+cn2YMmH20jleBULGZJP6Oyqly6sWzyvLtedtnjIEwHngdd eZSFj5zGTL/wabr0A2Y96689tTFqGlM= X-MC-Unique: YR8IM5GcPYy8eeg5TXudZg-1 X-Mimecast-MFC-AGG-ID: YR8IM5GcPYy8eeg5TXudZg_1790024266 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 09/10] qapi: split intro sections for data structs Date: Mon, 21 Sep 2026 16:57:11 -0400 Message-ID: <20260921205712.1862167-10-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024317862158500 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 13981d7e69d..741c8165c06 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -843,9 +843,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 00a03e57b98..b18c6d94a38 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1629,9 +1629,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. @@ -1890,8 +1890,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 20:00:46 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=1790024454; cv=none; d=zohomail.com; s=zohoarc; b=oL3cSN6ApU83L2I/BoRMJRVl+YkI4i2J//vafRYxkgZftyk8Eyrx8wUtmZtlqii5byZzAJNE+OQA150ok9D/1fn6DYcRBRiO7Px4KbhBP2UQWOhKsdnQugI3rYas31tCb6o9omGUAzKUDnDr0gLPJ6g934ZrZ6DGEB4IGGFpsW0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024454; 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:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=3OcKAVzNSosvgaJJQ9NSF540owN/x61zRhy/lSKvQ24=; b=agyC/XA5lPaaoSwv9Rdoxqc6XOCn45R8LsSdAjK+WGPSQLx4vaWRcoN76FxdMCkYmjwnUwBA03XAeyld+qThBc1wly5MHwUjIZ+qPgHJqcuQzcl+uFzHniJ55BpVTR6BA01Tc5K8hGr9VdKLt4V1hX/SUFclIY7lJX6Ipg9EClY= 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 1790024454855158.90620485992804; Mon, 21 Sep 2026 14:00:54 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l5u-0005yh-VK; Mon, 21 Sep 2026 16:58:35 -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 1x8l5K-0005bm-2l for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:58:00 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x8l5G-0003dF-37 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:57:56 -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-652-P_oBXvExOXKsmkTNyG8LQw-1; Mon, 21 Sep 2026 16:57:51 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (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 50BDE19560BB; Mon, 21 Sep 2026 20:57:50 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id D86EB1956042; Mon, 21 Sep 2026 20:57:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790024273; 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=3OcKAVzNSosvgaJJQ9NSF540owN/x61zRhy/lSKvQ24=; b=JTmp/VvJmmdwg7Xl71hlj8Cx65r08qhD68iYNX9HrNcUJwEVcfsvjbY87H1Yyoe5OLxDl0 V8iV/Hf5a3F3NHKzkHPpYpEPhc4nXYsylCkNwpzzLSVjbhot01jztq7INx3zDKkHqzmJJh Gk+E0Au1hFTyEnTjh1RAKRB0znjpRlo= X-MC-Unique: P_oBXvExOXKsmkTNyG8LQw-1 X-Mimecast-MFC-AGG-ID: P_oBXvExOXKsmkTNyG8LQw_1790024270 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Fabiano Rosas , Hanna Reitz , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , Vladimir Sementsov-Ogievskiy , Paolo Bonzini , Zhao Liu , Jason Wang , Eric Blake , qemu-block@nongnu.org, Igor Mammedov , Ani Sinha , "Michael S. Tsirkin" , John Snow , Peter Xu , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH v2 10/10] qapi: split intro sections for inlinable structs Date: Mon, 21 Sep 2026 16:57:12 -0400 Message-ID: <20260921205712.1862167-11-jsnow@redhat.com> In-Reply-To: <20260921205712.1862167-1-jsnow@redhat.com> References: <20260921205712.1862167-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 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: 1790024456819158500 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. Signed-off-by: John Snow --- qapi/block-export.json | 5 ++--- qapi/crypto.json | 3 +-- qapi/machine.json | 11 ++++------- qapi/net.json | 34 +++++++++++++++------------------- qapi/qom.json | 9 +++------ 5 files changed, 25 insertions(+), 37 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 7b4c80edae2..a8d753d360f 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 b18c6d94a38..1220116bf7d 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -684,9 +684,8 @@ =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. @@ -760,8 +759,7 @@ =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. @@ -926,8 +924,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/net.json b/qapi/net.json index b0a15fd53e2..2a186a71b93 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -719,11 +719,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') # @@ -750,11 +749,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 @@ -793,15 +791,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 @@ -838,10 +835,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..e67cd0cd54d 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