From nobody Sat Sep 26 20:50:47 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=1788207684; cv=none; d=zohomail.com; s=zohoarc; b=eVPPzOROJZhs5gepIlLvrZfwJAyjNJ0IpuOZFcVSoZV26GpIsT98pGric2+OSKFyqsbxIwc/eYseOccUDhJxgxW85cVxSPG5NiBY7Uo9xGQ5H9x0LeNkoYkTyyHBN7+iFiwQSjbWxf/SHRF+62bgTprKRvdgA1tTaKB6QThswCU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207684; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=BMPxC80TfJ3XPuZvHUAm20UCy61t3gJQmqci80rUMX0=; b=lAafHt2ysJvHrioitocxnoqpjeJrb6Goq6WmpFWYLQEgBwn8U1iAAW3O+ZYt5ChKoFsoNxZ1yzgI/muPPT0t/aSk/eHSKswBPeSd72SdF1Opjyq2b9HJ2hjpByubI9jdgSikqXPR1gLCJbPcV5nzIVRV9Uqd19YdxC4ckRsySeg= 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 1788207684618499.08566211312495; Mon, 31 Aug 2026 13:21:24 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18UQ-0007Wk-4L; Mon, 31 Aug 2026 16:20: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 1x18UN-0007Vs-Eh for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:19 -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 1x18UM-0007HC-2Q for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:19 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-297-PdZhTx3JNiC0CLDHkissGQ-1; Mon, 31 Aug 2026 16:20:13 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 6F57B187E5CD; Mon, 31 Aug 2026 20:20:08 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6B4721800347; Mon, 31 Aug 2026 20:19:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207617; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=BMPxC80TfJ3XPuZvHUAm20UCy61t3gJQmqci80rUMX0=; b=WOq3PJuWY5oZUF7Nah4mpHVRBQF1MIW/I6JnSmyK0PztTZ8TM/Uzz/W+LiFdrbe8j+rIWM inV2o4vwiZH9P8KpgP4o3oi/jRCNi06JRWS3k4IAupfVgC/6GeGOMHS2aQcsl7QA5LDklF KIO6aTiEp9Pdrm/q5QXhJbR1AS2O7bU= X-MC-Unique: PdZhTx3JNiC0CLDHkissGQ-1 X-Mimecast-MFC-AGG-ID: PdZhTx3JNiC0CLDHkissGQ_1788207609 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 01/43] qapi: convert trivial intro sections for error.json Date: Mon, 31 Aug 2026 16:19:03 -0400 Message-ID: <20260831201945.287730-2-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1788207685947158500 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/error.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/qapi/error.json b/qapi/error.json index 54cb02fb880..a53b13e55c9 100644 --- a/qapi/error.json +++ b/qapi/error.json @@ -9,8 +9,7 @@ =20 ## # @QapiErrorClass: -# -# QEMU error classes +# QEMU error classes # # @GenericError: this is used for errors that don't require a specific # error class. This should be the default case for most errors --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207686; cv=none; d=zohomail.com; s=zohoarc; b=mJg7lDrONBAmuxh7JymkLOQ39IyG7OebQlZn9oGMb51n4yt4uVOoVS/6uoRmAhXaUxWjUtYx7MUp4ycyJ8bHJFee+ptjwW4nALR51qvDBSdRCxNkCyfFLmDi8e6aqRGlQ5Bd80PLAc0HIy2eN0k2qRD5LbGFheAt/DNyng+Ohpc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207686; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=anz2t9BFt0L27a1+w3KFmtX2Yur1ocqcJJFRnKyPZho=; b=lY+FlYSxMvHTlOiXl0ZSMBDgfhh2Ctf2Qsu8yQ6905ZvjOcAuydRee5UgPhu+ZKPzTM9bLGmwxDr5hGa+Kpj2g+Lt7MKxAA3HS7ZS34dR8kuklufhdeVHu7LRb2Ljg0h+Y2W5/PfM9MYp1NOvk1s82bvflOadlumj3dYI+JtJXM= 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 1788207686508706.0946543370151; Mon, 31 Aug 2026 13:21:26 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18UZ-0007b6-Ll; Mon, 31 Aug 2026 16:20: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 1x18UY-0007aR-8o for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:30 -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 1x18UW-0007Jh-J8 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:30 -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-118-1qSihBPXN2SD3BJRMBBajA-1; Mon, 31 Aug 2026 16:20:25 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 87881184B3BA; Mon, 31 Aug 2026 20:20:19 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 0822D18005B0; Mon, 31 Aug 2026 20:20:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207627; 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=anz2t9BFt0L27a1+w3KFmtX2Yur1ocqcJJFRnKyPZho=; b=cOUuyVktpnxIOxOtJ+avjGohFIkKwzgEv/rdUcK7djmZf6jMdYSaPZeImx5fFCdw+C8eQx wPSRM1fuVNwng4S6xNXvqSVgKJlFb2yp4XZ4i68UTyobwkQVBb1wVVwI11DTqQWggz8GkI VnqUs5w7yQY11y5y062WOCpCdntSs/E= X-MC-Unique: 1qSihBPXN2SD3BJRMBBajA-1 X-Mimecast-MFC-AGG-ID: 1qSihBPXN2SD3BJRMBBajA_1788207621 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 02/43] qapi: convert trivial intro sections for acpi-hest.json Date: Mon, 31 Aug 2026 16:19:04 -0400 Message-ID: <20260831201945.287730-3-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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=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: 1788207688359158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/acpi-hest.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/acpi-hest.json b/qapi/acpi-hest.json index a01f1dee095..8db804df197 100644 --- a/qapi/acpi-hest.json +++ b/qapi/acpi-hest.json @@ -13,8 +13,8 @@ =20 ## # @inject-ghes-v2-error: -# -# Inject an error with additional ACPI 6.1 GHESv2 error information +# Inject an error with additional ACPI 6.1 GHESv2 error +# information # # @cper: contains a base64 encoded string with raw data for a single # CPER record with Generic Error Status Block, Generic Error Data --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207677; cv=none; d=zohomail.com; s=zohoarc; b=FyxDz3sXawA8xVsYg2LcBhjgEEzs9075CzhGsUHiq+dKqsYjahiE3Ks9oo04gI0ptQKOEdBfz5XmDwCOc27t6JMaDqnAsGp1zddDvtLZPyinjZaXdlvPyDxpfqtv2afisy0WHpYimVXOFDSjZYcvo2t/OcVbrUdnh7tmuxSe338= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207677; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=mlhVSIuYfO98pyz9Sq3hbEesOQSLV/LUPwoZZKF//5o=; b=PKdoyQdM58L1onYBi94itcDIMp20AUQrpZh8oV2oqD1GtIihy/Yxm8c3Jg2O+wy6BoRLX/xZMgCUU/2dU4XQ5oaAFi/EHd6LTIit2vlgBZ7Kawhi4B6E47yfzKO/feHG6WOSvaMVaM6jbK6++xVaN69lGRc5nV7AAthGKPfUcLk= 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 1788207676918621.894460346734; Mon, 31 Aug 2026 13:21:16 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Uk-0007il-5A; Mon, 31 Aug 2026 16:20:42 -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 1x18Uh-0007h4-Uj for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:39 -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 1x18Ug-0007M0-JU for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:39 -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-594-8yp1Es01NOaqFcSoLze1ZQ-1; Mon, 31 Aug 2026 16:20:32 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 1B5F91921EFB; Mon, 31 Aug 2026 20:20:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BFFF71800577; Mon, 31 Aug 2026 20:20:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207638; 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=mlhVSIuYfO98pyz9Sq3hbEesOQSLV/LUPwoZZKF//5o=; b=fUR+c7fNQRU/jqugE/Sv8DtxSfiQu8Eruf4GqXizBMegonpR/N3jNtGxOMQCuKUFRjMkQY lz4UfSfCjwjAdLDNaM8vbWynE6iEAd/cx3JN440tKJwj1s9vqcZUg3Xu6kZbSSAyVoSLlj rIFmHjC4I7FLWRLZ1BeuLAPLa8DuteA= X-MC-Unique: 8yp1Es01NOaqFcSoLze1ZQ-1 X-Mimecast-MFC-AGG-ID: 8yp1Es01NOaqFcSoLze1ZQ_1788207629 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 03/43] qapi: convert trivial intro sections for ebpf.json Date: Mon, 31 Aug 2026 16:19:05 -0400 Message-ID: <20260831201945.287730-4-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207680807158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/ebpf.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/qapi/ebpf.json b/qapi/ebpf.json index f0257955fa2..951516b121f 100644 --- a/qapi/ebpf.json +++ b/qapi/ebpf.json @@ -20,8 +20,7 @@ =20 ## # @EbpfObject: -# -# An eBPF ELF object. +# An eBPF ELF object. # # @object: the eBPF object encoded in base64 # @@ -33,8 +32,7 @@ =20 ## # @EbpfProgramID: -# -# The eBPF programs that can be gotten with `request-ebpf`. +# The eBPF programs that can be gotten with `request-ebpf`. # # @rss: Receive side scaling, technology that allows steering traffic # between queues by calculation hash. Users may set up --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207676; cv=none; d=zohomail.com; s=zohoarc; b=dXMP467pmYWjIwssjMrrehCBJ+I+oeGq2NKX3Ls94KlRavBEDhQaSZLiAveoTrsjVxEz7yT0HLKM3fEGZtcBAO0fAiNItHQfRpi/ZrI7zx0E4SMgv1vyh9gFCSModV6gwBottlx+jRsS8OJBvTdgmn9s8ZnT7NXbgNsdX5arsGU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207676; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=wffPVCvszX/U31azigwXEqCRZFarXIHCtsWE3o10AB0=; b=M+nXq+TdEUExuSTyJFpKzt4IPWzsUNo3zhjrGEJTKecIXy/BUaxwL2Xa6XJhs25ImgCt5S+91DL1DsL0Ipu4WthmT8xQ8xnWs/yK4Z8omHkC1xwOkoJAlDOHXyFtMQ2wNybP8CMILbr5twEvthPVG6Uvtx8geNkw6yepgXFZipg= 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 1788207676596567.6529559847477; Mon, 31 Aug 2026 13:21:16 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Us-0007np-N9; Mon, 31 Aug 2026 16:20:50 -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 1x18Uq-0007lt-Rl for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:48 -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 1x18Up-0007Ng-Br for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:48 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-272-oZyXUQrLMW-IzbvWwxCjYA-1; Mon, 31 Aug 2026 16:20:42 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4A8801945CB1; Mon, 31 Aug 2026 20:20:39 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 52C2B1800347; Mon, 31 Aug 2026 20:20:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207646; 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=wffPVCvszX/U31azigwXEqCRZFarXIHCtsWE3o10AB0=; b=iUn0iJHduJRb7rFXZUJazQKAMEmSFj0MRrXCFb6Nde2xFJn13+6cw/pmn6NMGR8PUcPrxs zuHMocXSvs3zD1UMxxF7u3S7r+yu4jj+R0GE7QWw6bVcrAlqxOl749rnLi1cNT6NH7OXQY U1OitOKPPmI+Mh+KAsTL/raKaZpcQVE= X-MC-Unique: oZyXUQrLMW-IzbvWwxCjYA-1 X-Mimecast-MFC-AGG-ID: oZyXUQrLMW-IzbvWwxCjYA_1788207639 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 04/43] qapi: convert trivial intro sections for compat.json Date: Mon, 31 Aug 2026 16:19:06 -0400 Message-ID: <20260831201945.287730-5-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207680733158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/compat.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/qapi/compat.json b/qapi/compat.json index 90b8d51cf27..ef1853b9acd 100644 --- a/qapi/compat.json +++ b/qapi/compat.json @@ -9,8 +9,7 @@ =20 ## # @CompatPolicyInput: -# -# Policy for handling "funny" input. +# Policy for handling "funny" input. # # @accept: Accept silently # @@ -25,8 +24,7 @@ =20 ## # @CompatPolicyOutput: -# -# Policy for handling "funny" output. +# Policy for handling "funny" output. # # @accept: Pass on unchanged # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207707; cv=none; d=zohomail.com; s=zohoarc; b=KjgisoO/VoOpgdWP1ZKuc1vjvn8cg2EGePGWrjhbWSSY2zPG2ry3bhPV8QDnOOrfFG99X/bMZJhy8NGTSmMhwpcPJkMUPPAywAiOFobZJWNoWLSQHgniLkg/LvS6KByOu6pXsPj4b6Kopk0Ly2pde6/s4/LgnACX53P5UgLBQtg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207707; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=51mw7vepOrhvYl06ZXUhguULRghvJmoF2wY1rlb44PU=; b=NSwoettxfqjoqAaUy5LAnikJ4UW5IKIzoH7v6n6UiGx7mTdlE3tYPXyouWV74aRurOpg/na/Tv9SIxlA2F4YBx2ukatZoUynVffwl7p/j2j/22cT7qlynVJBIwkQQFlYDgWD96kGFmXELcT/2QtYIa06SESiq4z62nLhJ02MYcA= 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 1788207707967406.1984262108755; Mon, 31 Aug 2026 13:21:47 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18V3-0007yO-3f; Mon, 31 Aug 2026 16:21:01 -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 1x18V1-0007vv-MU for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:59 -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 1x18Uz-0007aU-Cd for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:20:59 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-248-5sW6Nih8NgmdFACvicVlww-1; Mon, 31 Aug 2026 16:20:52 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 8181818707B3; Mon, 31 Aug 2026 20:20:48 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id B93751800347; Mon, 31 Aug 2026 20:20:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207656; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=51mw7vepOrhvYl06ZXUhguULRghvJmoF2wY1rlb44PU=; b=aRCanCr4wmmDX4PYUh4B2pkREC3zqSXKmJEwevJUcvg7YMItj+WhdYHYj7y6Tgpdb7Lcd3 IGvZAgZGA3LdVzXEfIb0JQFk73/jZR5u+J9+A1pUzBsxbeyrNjkoYLFxyT1NxP7olYc3JX YEBrLaVhWKrm5fD8x/RI7fbRGKiWtcU= X-MC-Unique: 5sW6Nih8NgmdFACvicVlww-1 X-Mimecast-MFC-AGG-ID: 5sW6Nih8NgmdFACvicVlww_1788207649 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 05/43] qapi: convert trivial intro sections for vfio.json Date: Mon, 31 Aug 2026 16:19:07 -0400 Message-ID: <20260831201945.287730-6-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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=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: 1788207710050154100 Signed-off-by: John Snow Reviewed-by: C=C3=A9dric Le Goater Reviewed-by: Markus Armbruster --- qapi/vfio.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/vfio.json b/qapi/vfio.json index 17b60468712..3d61fc38ecd 100644 --- a/qapi/vfio.json +++ b/qapi/vfio.json @@ -49,8 +49,8 @@ =20 ## # @VFIO_MIGRATION: -# -# This event is emitted when a VFIO device migration state is changed. +# This event is emitted when a VFIO device migration state is +# changed. # # @device-id: The device's id, if it has one. # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207710; cv=none; d=zohomail.com; s=zohoarc; b=m4HOxHzKSe+oGMileRL5qBHooYEbmMUc6gKyx3gvTOK+G53pcrLhtuVWN8w50UAnkdY28Ec2L8g4edOQrWntLxfu93vTfmbIFX/k0CZ24fx4ikzJBGNozwc55yarXC9y3xBLS39CN81YbIdU20oMWSwmSt82rt1D96h3le2NuyE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207710; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=9ndidgXfI+j62GEABZBVr0fCVINjLQ7F7fcSx52FMCI=; b=hjZy1DhsZIC+5TvvBfMN3jS0b8D3E/4SFgz20cyqymI0yliilJwYG/12Os0ADo8glB2KDBPN05F+/QWfhfaacRm2h3rvoc5EuIssya360tnAzqrxftpeXEoghWYXNKE22gOsFT9EUSUjlgsBhtLVxt0dchpOR4vpDyBmvXL1iBQ= 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 1788207710551896.5976976283188; Mon, 31 Aug 2026 13:21:50 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Ve-000067-BT; Mon, 31 Aug 2026 16:21:39 -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 1x18VX-0008Sg-Nk for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:21:32 -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 1x18VU-0007fP-I7 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:21:31 -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-594-0XZ7qSRmMZuYfKeQ-vSbDA-1; Mon, 31 Aug 2026 16:21:21 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EAF2218AB303; Mon, 31 Aug 2026 20:20:58 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id C205D18005AC; Mon, 31 Aug 2026 20:20:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207687; 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=9ndidgXfI+j62GEABZBVr0fCVINjLQ7F7fcSx52FMCI=; b=h+bwV0FiWSTAkxmD8Z1u0vH1LYTbF7t15wWbVadjcHT8lQB5nCPJIC1fbuj9mgAuCPtpM8 ZJpgGEwl5RlSNmZZZJeEedcueDkKkLTo7GuFJ0pFDuPHVmFWbO01BPaxcL7O5MpS3zYfOr zghBRz94snzpu5tCtCmxGoUAXVxlo0U= X-MC-Unique: 0XZ7qSRmMZuYfKeQ-vSbDA-1 X-Mimecast-MFC-AGG-ID: 0XZ7qSRmMZuYfKeQ-vSbDA_1788207659 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 06/43] qapi: convert trivial intro sections for trace.json Date: Mon, 31 Aug 2026 16:19:08 -0400 Message-ID: <20260831201945.287730-7-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207711998154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/trace.json | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/qapi/trace.json b/qapi/trace.json index de369dae6b5..29c76256055 100644 --- a/qapi/trace.json +++ b/qapi/trace.json @@ -14,8 +14,7 @@ =20 ## # @TraceEventState: -# -# State of a tracing event. +# State of a tracing event. # # @unavailable: The event is statically disabled. # @@ -30,8 +29,7 @@ =20 ## # @TraceEventInfo: -# -# Information of a tracing event. +# Information of a tracing event. # # @name: Event name. # @@ -44,8 +42,7 @@ =20 ## # @trace-event-get-state: -# -# Query the state of events. +# Query the state of events. # # @name: Event name pattern (case-sensitive glob). # @@ -65,8 +62,7 @@ =20 ## # @trace-event-set-state: -# -# Set the dynamic tracing state of events. +# Set the dynamic tracing state of events. # # @name: Event name pattern (case-sensitive glob). # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207741; cv=none; d=zohomail.com; s=zohoarc; b=OCnEjhYnRHwEQJr3I7sLF8YxpJZI0cBpdRZVt6KTuR5eDQGbJm6oyLfNTFyoweZ6QhSTlYVDHcrhW6wgmIBWfqXAhhxxtMU9SdGHb9SkKheB+HGBzgSeddWQ+/7ApAqZ541k+m0SoUh+GBj7I6lsBT0MlC2dfyzq7Xm411tQARE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207741; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=zSlSwxOgzm2zCxGI4LaQEBpjOYn5iLa1KBJ6Ly1YGHg=; b=QbyXz16IUUV1yz0MqYFle2rDm7KtrbeRhy3dbHhVo1miVrvX1ccWUkTE7448gD4vEKIpdJRV0BxGpk2zhexuESKck+KMZ0Flr/NMfFUsuu+Y3R/QYR0Fkc5cwecuXE5xaH7hQZb5s8JNtrahIS5ZU5HK0iaOni9XXF+PGL0oo0A= 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 1788207741518718.3458631408422; Mon, 31 Aug 2026 13:22:21 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Vr-0000bA-3m; Mon, 31 Aug 2026 16:21:51 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18Va-0008Ut-5T for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:21:35 -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 1x18VX-0007fo-Fb for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:21:32 -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-79-553q7kN-OT-Mt6wlYOusMQ-1; Mon, 31 Aug 2026 16:21:24 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 71EFC1896E0E; Mon, 31 Aug 2026 20:21:08 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 4400F1800347; Mon, 31 Aug 2026 20:20:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207689; 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=zSlSwxOgzm2zCxGI4LaQEBpjOYn5iLa1KBJ6Ly1YGHg=; b=CIDpYEjuTdH/SPYnhpetfOtUP0g6YsLon3T3S08/P5GxN4tX32bZfrtq5SOo3vytVzaTLC XYSGSY7c+MfGi7YZlgXUa1CCCAbR5Dms6bcemtiLblCit/4wc1oPxWj1MukRm7+u/kaDtD PxI9Ods+sGi3+Ah74Pn4lWeiiD9cgy4= X-MC-Unique: 553q7kN-OT-Mt6wlYOusMQ-1 X-Mimecast-MFC-AGG-ID: 553q7kN-OT-Mt6wlYOusMQ_1788207677 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 07/43] qapi: convert trivial intro sections for misc-arm.json Date: Mon, 31 Aug 2026 16:19:09 -0400 Message-ID: <20260831201945.287730-8-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207742166158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/misc-arm.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index 4dc66d00e5c..a7b5498d2d3 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -48,8 +48,7 @@ =20 ## # @SsidSizeMode: -# -# SMMUv3 SubstreamID size configuration mode. +# SMMUv3 SubstreamID size configuration mode. # # @auto: derive from host IOMMU capabilities # @@ -64,8 +63,7 @@ =20 ## # @OasMode: -# -# SMMUv3 Output Address Size configuration mode. +# SMMUv3 Output Address Size configuration mode. # # @auto: derive from host IOMMU capabilities # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207762; cv=none; d=zohomail.com; s=zohoarc; b=KwIfKa1LiTGybF1i3zTGuLaWQKbzjfpPhc+EExNKIgBhNL7sUDgiQFy61watu0Nle85atpUiXBWZtUEpfJy/gHi9TFlvkIKHXtqOEwsroAgoPVKtxuU2Owvz6nQ+R45sIaHd/1KTxgeLis34HR1My0hPGK4HlQVkrPzI54k4K8k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207762; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=lt8Io7cWByPIErcfVsv8eiRTyjtcP7E9KBqJ4x3KU5A=; b=cBpwbtsalYYScXyic6ZFLPYZWlut3hRSUaSWfa6B/CPM7EjPHCCRExQbdoGX5+DUikI2PVG5zIlF/3Z46DTO2k9z2Nnb+wziqBs5c9v+M3QQscyZ/HjHtD8DLS6Hlsm8RUaPgED5aEHtlh4fBRWOJ39JLPdKeanw7Im0f9dzHPA= 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 1788207762341660.8607905335206; Mon, 31 Aug 2026 13:22:42 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18WW-0001U5-PZ; Mon, 31 Aug 2026 16:22:36 -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 1x18Vy-0000wy-2H for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22: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 1x18Vu-0007k0-3u for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:21:56 -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-692-JbaarNQYNFqYxJioJR3jNg-1; Mon, 31 Aug 2026 16:21:47 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 26558190B19F; Mon, 31 Aug 2026 20:21:24 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 0496B180063D; Mon, 31 Aug 2026 20:21:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207713; 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=lt8Io7cWByPIErcfVsv8eiRTyjtcP7E9KBqJ4x3KU5A=; b=YvEPsdAL4tJmWjMR3j2eoVYXg6wXECijLCVojngKWbpO0gTytKtqh8Htfec6V/TSQyQTHk T4vMvkCq0qXzFJXsm9NqUZlWCyiNRTlA36iig15ULdlm0icWDt+dwLThoVj/IJLC3cLZmD tdVCKu9Le/Ipdc7mvokxJgnAB9kBDqY= X-MC-Unique: JbaarNQYNFqYxJioJR3jNg-1 X-Mimecast-MFC-AGG-ID: JbaarNQYNFqYxJioJR3jNg_1788207704 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 08/43] qapi: convert trivial intro sections for cryptodev.json Date: Mon, 31 Aug 2026 16:19:10 -0400 Message-ID: <20260831201945.287730-9-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207764568158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/cryptodev.json | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/qapi/cryptodev.json b/qapi/cryptodev.json index eb309c22f86..d0c1e6c8944 100644 --- a/qapi/cryptodev.json +++ b/qapi/cryptodev.json @@ -12,8 +12,7 @@ =20 ## # @QCryptodevBackendAlgoType: -# -# The supported algorithm types of a crypto device. +# The supported algorithm types of a crypto device. # # @sym: symmetric encryption # @@ -26,8 +25,7 @@ =20 ## # @QCryptodevBackendServiceType: -# -# The supported service types of a crypto device. +# The supported service types of a crypto device. # # @cipher: Symmetric Key Cipher service # @@ -46,8 +44,7 @@ =20 ## # @QCryptodevBackendType: -# -# The crypto device backend type +# The crypto device backend type # # @builtin: the QEMU builtin support # @@ -62,8 +59,7 @@ =20 ## # @QCryptodevBackendClient: -# -# Information about a queue of crypto device. +# Information about a queue of crypto device. # # @queue: the queue index of the crypto device # @@ -77,8 +73,7 @@ =20 ## # @QCryptodevInfo: -# -# Information about a crypto device. +# Information about a crypto device. # # @id: the id of the crypto device # @@ -95,8 +90,7 @@ =20 ## # @query-cryptodev: -# -# Return information about current crypto devices. +# Return information about current crypto devices. # # Since: 8.0 ## --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207766; cv=none; d=zohomail.com; s=zohoarc; b=d7n1yaiTKhgb5wJXNM6S4+u5MWNMmJOppNl1kLV+0sfhQ1okPobN2JC4b84cXWIjJQ3/mPyc8ul2WfbGpruz0CmB6oMjZN2JUEsBMnPFXCbBUZoVB3HqgWcu7jwgATX97Zdbjdrzzm1KSPwQUIzja+AHO3QJxp8SxmdFYmT7AUM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207766; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=yKAT3AByQqAPEWNoFggUat7b+8Hak/kL/bR6Gv1FXr8=; b=U8iUay4uWrTfCc5mzyamPbyRIWfBfzzXAz9e0iwrVjgCViTEiucFvPwAJgTXtL4CTRTbE6f3MjsO/A0O6prejc5xtaGcBUOUyrSNW2Mubiokg5JEaXBRzztw2F72VO6ZTAv6W30gLCWRbQRxv9X2fv4oCPry6WAg8s2gk0g2g+g= 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 1788207766600651.6847085317432; Mon, 31 Aug 2026 13:22:46 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Wb-0001bG-Kg; Mon, 31 Aug 2026 16:22:39 -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 1x18W9-0001Eu-5c for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22:11 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18W7-0007nk-MZ for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22:08 -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-54-GluYs3xHMN-gr1CQ6mS6dA-1; Mon, 31 Aug 2026 16:22:03 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E77E5182C496; Mon, 31 Aug 2026 20:21:35 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 1B0ED1800DB9; Mon, 31 Aug 2026 20:21:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207727; 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=yKAT3AByQqAPEWNoFggUat7b+8Hak/kL/bR6Gv1FXr8=; b=duU6ga0RB69Ov0Q5zSKw6tOCozJ4Dhofa15o3rkQhfO+Yj9ln6z4kbGJNGhVIfD4sWUnnd GaDUQiLSgQBkIJqlhew0Qf1aJq8+IE2ySlz+B82rXwl7O3xUwQ8C+XVtTfnaO0roqr3X+M TXuj4+R7CrgWGZuOevSCpTJB1TdR1ns= X-MC-Unique: GluYs3xHMN-gr1CQ6mS6dA-1 X-Mimecast-MFC-AGG-ID: GluYs3xHMN-gr1CQ6mS6dA_1788207720 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 09/43] qapi: convert trivial intro sections for machine-common.json Date: Mon, 31 Aug 2026 16:19:11 -0400 Message-ID: <20260831201945.287730-10-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207768466158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine-common.json | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/qapi/machine-common.json b/qapi/machine-common.json index aca98e994af..fdb0e68d9e6 100644 --- a/qapi/machine-common.json +++ b/qapi/machine-common.json @@ -12,9 +12,8 @@ =20 ## # @S390CpuEntitlement: -# -# An enumeration of CPU entitlements that can be assumed by a virtual -# S390 CPU +# An enumeration of CPU entitlements that can be assumed by a +# virtual S390 CPU # # Since: 8.2 ## @@ -23,8 +22,7 @@ =20 ## # @CpuTopologyLevel: -# -# An enumeration of CPU topology levels. +# An enumeration of CPU topology levels. # # @thread: thread level, which would also be called SMT level or # logical processor level. The @threads option in @@ -84,8 +82,7 @@ =20 ## # @SmpCacheProperties: -# -# Cache information for SMP system. +# Cache information for SMP system. # # @cache: Cache name, which is the combination of cache level and # cache type. @@ -103,8 +100,7 @@ =20 ## # @SmpCachePropertiesWrapper: -# -# List wrapper of `SmpCacheProperties`. +# List wrapper of `SmpCacheProperties`. # # @caches: the list of `SmpCacheProperties`. # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207793; cv=none; d=zohomail.com; s=zohoarc; b=kEJyG5iS6VOE2xq+wAORolF+jX/gVAVgC9Qf1ljbRaBFTGNxoRR3MrYIYKlxzTmBuB2dzCeU+djBMnpmUckQAhDHzQPxhTSbyCQXEZ/+CbzaBSeA5g2GffSbMe7OgZjGCsDf3cBDX/UHXU6fXc/LX1DQ6IDP/PBNhkcJEpZbbV4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207793; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=CJj1tpPE8OM93bqYjizhdyFRUwlcEtSIS5cPqNRF9cY=; b=IxghUOBpfwLjzNHh1EhFn/f/rmYbAgZ3YAQj4eIIbeOhmDAqSC+JYgC9WWhZ5fe+1gPEpGvhikxJt0hgEwGRYyomjuAwKvnHjmzUPnzKP9wuQi9FpCCyK3+1uAASnir17DeYUeQAsaQeXfhtoZjawgLl9ceJJccTIHaVrJouug4= 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 1788207793006249.79531398825247; Mon, 31 Aug 2026 13:23:13 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18X0-0002II-QM; Mon, 31 Aug 2026 16:23:04 -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 1x18WR-0001b9-Hw for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22: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 1x18WO-0007rk-C8 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22:27 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-131--hYo-e0KPKGM2YvaRZ_4EQ-1; Mon, 31 Aug 2026 16:22:18 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 88313192013B; Mon, 31 Aug 2026 20:21:44 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 88D89180176D; Mon, 31 Aug 2026 20:21:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207743; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=CJj1tpPE8OM93bqYjizhdyFRUwlcEtSIS5cPqNRF9cY=; b=IyVRTlBi8lE07dFYy2MPEHCjWeY0As323SYBNX+bmT2OSao0RENGo+0tEOhgfrUw5H0T8Y MQOp8AbRI2zMrAZ1BBigllG3bLlEFvpxjXueWBwGmuRHmabEJnXdzR0RbJ56v4Wh24ivo7 udcFh5DwMsbo9xgF198mBEMKDFCL+0c= X-MC-Unique: -hYo-e0KPKGM2YvaRZ_4EQ-1 X-Mimecast-MFC-AGG-ID: -hYo-e0KPKGM2YvaRZ_4EQ_1788207735 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 10/43] qapi: convert trivial intro sections for accelerator.json Date: Mon, 31 Aug 2026 16:19:12 -0400 Message-ID: <20260831201945.287730-11-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1788207797197154100 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/accelerator.json | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/qapi/accelerator.json b/qapi/accelerator.json index b59df378664..efc0fa81418 100644 --- a/qapi/accelerator.json +++ b/qapi/accelerator.json @@ -13,8 +13,7 @@ =20 ## # @KvmInfo: -# -# Information about support for KVM acceleration +# Information about support for KVM acceleration # # @enabled: true if KVM acceleration is active # @@ -26,8 +25,7 @@ =20 ## # @query-kvm: -# -# Return information about KVM acceleration +# Return information about KVM acceleration # # Features: # @@ -46,8 +44,7 @@ =20 ## # @x-accel-stats: -# -# Query accelerator statistics +# Query accelerator statistics # # Features: # @@ -63,8 +60,7 @@ =20 ## # @Accelerator: -# -# Information about support for MSHV acceleration +# Information about support for MSHV acceleration # # @hvf: Apple Hypervisor.framework # @@ -88,8 +84,7 @@ =20 ## # @AcceleratorInfo: -# -# Information about support for various accelerators +# Information about support for various accelerators # # @enabled: the accelerator that is in use # @@ -102,8 +97,7 @@ =20 ## # @query-accelerators: -# -# Return information about accelerators +# Return information about accelerators # # Returns: @AcceleratorInfo # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207822; cv=none; d=zohomail.com; s=zohoarc; b=BEvDNCvnZogK8bIWrvaX1pv7op41l5VgS4c5PPZDMPdZAI0pkxYod2kFaFVa1UhQwoYt+b6eaxuG3zrVLMSSwvH9S+gcZqIJWvQ3+rXfMraezedpvsJxJEAE8eJmB5U813EarH/wuVXLpqPP6URHZnkjgQzWx8P9pdg3kqqb0EU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207822; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=YyMOc6fNO8ZdqDV2gIzSN+VkTBXIJrB1icvyY+sOx3Y=; b=WOqpkWDz9WlzVpTtalsRcr7H2pk+oxOteT+JBOcniaVvF+87WGheAr1Yq/s5Ox/4S7mmIc/oMYUgUaCyuLRp1t1n0gG3en/jWHk773XtwS9irYIMs3Vo2Aqze4nohDA0HFoT+CfowqHhuYdlBIIvUHzPtmbsw1nS5lbzdRFVi4w= 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 1788207822046481.87998090982774; Mon, 31 Aug 2026 13:23:42 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18X3-0002Rr-Mi; Mon, 31 Aug 2026 16:23:07 -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 1x18Wl-0001yS-Us for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22:48 -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 1x18Wg-0007vD-8L for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:22:47 -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-494-NqWVYzucPsitsaQxtuwhYw-1; Mon, 31 Aug 2026 16:22:37 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 064C41863EC8; Mon, 31 Aug 2026 20:21:53 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3461F18009BC; Mon, 31 Aug 2026 20:21:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207761; 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=YyMOc6fNO8ZdqDV2gIzSN+VkTBXIJrB1icvyY+sOx3Y=; b=RSrBKfYYKXDOiFNwzg7bc3tBdylESsqNOFrczyRenHsdPhXcUhd4/hw1sw2cliWNx9i6un a+936WEe66CUDmZERSik2+YkGrqihGDAC1XsrVkyPfTyQoD/vHGVkVp344i0Kl/WucyCdp 6Zx6d9ZjX44zAWOFXMEYaKHL70CjI7U= X-MC-Unique: NqWVYzucPsitsaQxtuwhYw-1 X-Mimecast-MFC-AGG-ID: NqWVYzucPsitsaQxtuwhYw_1788207753 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 11/43] qapi: convert trivial intro sections for authz.json Date: Mon, 31 Aug 2026 16:19:13 -0400 Message-ID: <20260831201945.287730-12-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207824893158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/authz.json | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/qapi/authz.json b/qapi/authz.json index bc1123cc053..b76c39c53af 100644 --- a/qapi/authz.json +++ b/qapi/authz.json @@ -9,8 +9,7 @@ =20 ## # @QAuthZListPolicy: -# -# The authorization policy result +# The authorization policy result # # @deny: deny access # @@ -24,8 +23,7 @@ =20 ## # @QAuthZListFormat: -# -# The authorization policy match format +# The authorization policy match format # # @exact: an exact string match # @@ -39,8 +37,7 @@ =20 ## # @QAuthZListRule: -# -# A single authorization rule. +# A single authorization rule. # # @match: a string or glob to match against a user identity # @@ -57,8 +54,7 @@ =20 ## # @AuthZListProperties: -# -# Properties for authz-list objects. +# Properties for authz-list objects. # # @policy: Default policy to apply when no rule matches (default: # deny) @@ -73,8 +69,7 @@ =20 ## # @AuthZListFileProperties: -# -# Properties for authz-listfile objects. +# Properties for authz-listfile objects. # # @filename: File name to load the configuration from. The file must # contain valid JSON for `AuthZListProperties`. @@ -93,8 +88,7 @@ =20 ## # @AuthZPAMProperties: -# -# Properties for authz-pam objects. +# Properties for authz-pam objects. # # @service: PAM service name to use for authorization # @@ -105,8 +99,7 @@ =20 ## # @AuthZSimpleProperties: -# -# Properties for authz-simple objects. +# Properties for authz-simple objects. # # @identity: Identifies the allowed user. Its format depends on the # network service that authorization object is associated with. --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207872; cv=none; d=zohomail.com; s=zohoarc; b=N20aLVtB/xHMceb2QrB2nViSHSzLjzBbZu1D8LYNH+BQhUmeIPrFCAXKkO13hP4RevC6euEw3Zo29RFE4kMU7v6UCtpNlimPRdjcaBSZ+wCPqVHuO6YtlzFvw1nkWWo8ERD20fsUKv6ij+qFkq54ky1OS/IzVgcLJTXyOJNoZBw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207872; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=zcTS1HQZTCGQkOmaZVLm63YpWlWjzjsxUTYZiN2QcLg=; b=ajmTQ2MY26c7X7zTEp22gO2zCrpmFm3RzWJEPI0J6UFIzdVjYvqp/W3zhgyepRCkVxjPKjMEVwlg624T4KlLN/crWf9oyx/rcv3NK6TO07mcLmwpV7dUv/0RYhdpvzSvI/U0ZJph02rlyEN9RsdhzqIxou1bbkqPHsx6ITN2Kd0= 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 1788207872102702.5084888127144; Mon, 31 Aug 2026 13:24:32 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YA-0005J4-69; Mon, 31 Aug 2026 16:24:14 -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 1x18XC-0002kH-1Z for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:16 -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 1x18X9-0007zd-Ef for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:13 -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-551-8xpiNybIMh6eNQ63wHnIhQ-1; Mon, 31 Aug 2026 16:23:05 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2C64A1891BAC; Mon, 31 Aug 2026 20:22:09 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 76C5418005B6; Mon, 31 Aug 2026 20:21:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207789; 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=zcTS1HQZTCGQkOmaZVLm63YpWlWjzjsxUTYZiN2QcLg=; b=IKUIlOIm/8tEUcGdySdXOP/ZhKHcM9xKZPZLFWfecZ3u73vSHZyLkqHzRdVJgJSxl9NnPg kiUxdUfp5FRs5clKiml0iKbKUXHqpNMsjQyEPonSYHyQUm1pv+EogYJ+DIjnmTk8m190R0 lCCw5k2jmT7U1/fossRGiLS0ZwJLOuI= X-MC-Unique: 8xpiNybIMh6eNQ63wHnIhQ-1 X-Mimecast-MFC-AGG-ID: 8xpiNybIMh6eNQ63wHnIhQ_1788207781 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 12/43] qapi: convert trivial intro sections for yank.json Date: Mon, 31 Aug 2026 16:19:14 -0400 Message-ID: <20260831201945.287730-13-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207872811158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/yank.json | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/qapi/yank.json b/qapi/yank.json index f3cd5c15d60..bc8c52bda74 100644 --- a/qapi/yank.json +++ b/qapi/yank.json @@ -47,9 +47,8 @@ =20 ## # @YankInstance: -# -# A yank instance can be yanked with the `yank` qmp command to recover -# from a hanging QEMU. +# A yank instance can be yanked with the `yank` qmp command to +# recover from a hanging QEMU. # # @type: yank instance type # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207834; cv=none; d=zohomail.com; s=zohoarc; b=gHTIqvPJy9qIzjCqZrudFpxjxZWxrWxn3mG8OGxoRSwQrYFoTyyYl8+GRUscAgR7k9B2aETghEk4HyvfGJBtYEG9gybRFmj1OwAIM9Je6C2DOaN4aX1Bj8CJrkd7rwWQjW+u6DnOOzun7i2t2pkNQPKtI9IMnact/kKDq82M2aw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207834; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=rLnw42K1+V+Fl4KQBW783G0VH8D6uwH+UAZ7SFG2AyA=; b=C4Uwl9hkEZVEgfiafAaxUGd7So1d8r2agqOe/U/d/J5rjQ3/tq6SyP2IaeHmzRqBtmwMK2GzAWLRmavrISIUqNi0vsq8PxWgFBhqGZ4snC/ciHS1tExKddXZE9m9f8eJI+QMb+yN/clwaeLG6Rupy10nF+BsIhEMA7i1QQB0vXM= 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 1788207834198218.05351297167726; Mon, 31 Aug 2026 13:23:54 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xi-0003GL-HS; Mon, 31 Aug 2026 16:23:46 -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 1x18XC-0002kG-1c for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:17 -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 1x18X9-0007zx-HW for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:13 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-359-TzF6fO6QNbSEh8CEQsUTuQ-1; Mon, 31 Aug 2026 16:23:04 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 925FA18E021F; Mon, 31 Aug 2026 20:22:17 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 633DD1800577; Mon, 31 Aug 2026 20:22:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207790; 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=rLnw42K1+V+Fl4KQBW783G0VH8D6uwH+UAZ7SFG2AyA=; b=JjR+zPROi2N29eM6k8byIejB5IqB1R7xjq/ejCy4eEXhFxXbtWObc7VGLJyPlbLYiWPyFf rtJfCxgibSWt6109TlwMNEidYKsr4A6NyS3UsyVuQ67Vna1PLGM/L2nhw0rTMCBLUyeXYa MBWFva6MC2VoVcIf5AciBCg93Gxrvow= X-MC-Unique: TzF6fO6QNbSEh8CEQsUTuQ-1 X-Mimecast-MFC-AGG-ID: TzF6fO6QNbSEh8CEQsUTuQ_1788207781 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 13/43] qapi: convert trivial intro sections for replay.json Date: Mon, 31 Aug 2026 16:19:15 -0400 Message-ID: <20260831201945.287730-14-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1788207835719154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/replay.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/qapi/replay.json b/qapi/replay.json index ccf84da68ef..66dff797553 100644 --- a/qapi/replay.json +++ b/qapi/replay.json @@ -12,8 +12,7 @@ =20 ## # @ReplayMode: -# -# Mode of the replay subsystem. +# Mode of the replay subsystem. # # @none: normal execution mode. Replay or record are not enabled. # @@ -30,8 +29,7 @@ =20 ## # @ReplayInfo: -# -# Record/replay information. +# Record/replay information. # # @mode: current mode. # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207840; cv=none; d=zohomail.com; s=zohoarc; b=AwpikT4GFnttpcv+bQ4UAbI5OgMae9QsBbyzLHyvdXfA2DsQmXR53p2GMXS6p6huLvGt9c1S3fzAwDLJTnDn/00TWGQC582Z9sJs2BctawXGsbVwSJ/7m3tOJEKqu3bjOf8KLogLrYqNjDSIrmy45//GmxZAEjoc7YZ5QQMDvKA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207840; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=OUbeK+L1hQxvyWPr/IkVmjVqdE8Y4kF2825fESMfeOk=; b=GiXPfZKN3M1tvQPP2U2YAF5UjZT7401vW6cjnuB7yh5fAempDbnc5+P6wLMhbG5JlJewUeLE05mt0Dt9Hn3Hzebe6l2wckRgKIIVF2GNI3E4XxcueZ9elNeAymKNSOUpidtO8I0r807DX7i4GsCPa+Bf9rCUP7NPOL8nso4AktE= 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 1788207840378737.3045033509204; Mon, 31 Aug 2026 13:24:00 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xm-0003zJ-TB; Mon, 31 Aug 2026 16:23:50 -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 1x18XF-0002lU-F3 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:20 -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 1x18XC-00081C-TV for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:16 -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-32-f5u4uEFvNSyYwOmZwu5hog-1; Mon, 31 Aug 2026 16:23:10 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 261511860657; Mon, 31 Aug 2026 20:22:26 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id D691E1800347; Mon, 31 Aug 2026 20:22:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207794; 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=OUbeK+L1hQxvyWPr/IkVmjVqdE8Y4kF2825fESMfeOk=; b=XT12nIc198nqfX6EGGI54TomqRz0ZH+qJ5lGDRTYiaN20Q+G4DOik42SFbOzaT5nmZswRA hYdwpfXnBxuf4rXDaOvveNKHFiRH7bTlpWsnHGqNWtz8OH2bTBIZfa8uSj3NkRloacX6W9 wimC/jrAjS+jAOAmHOaXuybM8sgu77Y= X-MC-Unique: f5u4uEFvNSyYwOmZwu5hog-1 X-Mimecast-MFC-AGG-ID: f5u4uEFvNSyYwOmZwu5hog_1788207787 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 14/43] qapi: convert trivial intro sections for machine-s390x.json Date: Mon, 31 Aug 2026 16:19:16 -0400 Message-ID: <20260831201945.287730-15-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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=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: 1788207841821154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine-s390x.json | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index f79864f417b..a83a258d6ce 100644 --- a/qapi/machine-s390x.json +++ b/qapi/machine-s390x.json @@ -9,9 +9,8 @@ =20 ## # @S390CpuPolarization: -# -# An enumeration of CPU polarization that can be assumed by a virtual -# S390 CPU +# An enumeration of CPU polarization that can be assumed by a +# virtual S390 CPU # # Since: 8.2 ## @@ -94,8 +93,7 @@ =20 ## # @CpuPolarizationInfo: -# -# The result of a CPU polarization query. +# The result of a CPU polarization query. # # @polarization: the CPU polarization # @@ -122,9 +120,8 @@ =20 ## # @SCLP_CPI_INFO_AVAILABLE: -# -# Emitted when the Control-Program Identification data is available in -# the QOM tree. +# Emitted when the Control-Program Identification data is +# available in the QOM tree. # # Features: # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207831; cv=none; d=zohomail.com; s=zohoarc; b=IIjYf911QKXOCaCwIIQH88EpdXcT8tNOjopRJXREAjXdrwQGaP08RKPo3hl5c13e1Pq63NNUsk1L3rGwx74Xi9kJfAsahqFmkCc6OkzDCEJ8dCURFaPih2tTm9xeBbDnb/UuLtfHMe/sYkrJSei1n5xVK7Bw5jGv5WRBRTsWdXY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207831; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Q7ddRUc8gUI3lDxdCUKNaV59MC9hJW515QAIptbgtpY=; b=IcBkrgoLTY6hYUTnSyq03m1EwO9KfV2C1UbRy6RWNh7Uw39cFo//+h4r1rBOTCOeIEN/hUF+9skFDq75NSJEFpSPCGM5WcW8BDLNS1QNBx0IC+BPINfPGIvNC0V72Pn58b31Fhu7p1VIM9/LC57/nP1QkWdQs5FfcxB5e+prm9c= 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 1788207831121386.5087589883467; Mon, 31 Aug 2026 13:23:51 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xj-0003PX-6S; Mon, 31 Aug 2026 16:23: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 1x18XH-0002lr-BG for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:22 -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 1x18XG-00081z-1r for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:19 -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-677-DJIE_Tr-N2-WBdBQfDKuIA-1; Mon, 31 Aug 2026 16:23:12 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 59E1618AB30E; Mon, 31 Aug 2026 20:22:34 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 878681800577; Mon, 31 Aug 2026 20:22:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207796; 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=Q7ddRUc8gUI3lDxdCUKNaV59MC9hJW515QAIptbgtpY=; b=BRSPnTHKszBNwelzkXit38VJKPTxEWc9LKXFybf5Xwv4zVzIbkHThbUlTu4sp53z3ECL4e l3QriU4EEpD+JStPVp8cZ0lw91nB/OoVPhVs1QOor1NCnmwXPO3xFqknUOBIHZZGQukjXx Lu4CLKjn/n0AiNb6spi7RjlCKHuRyRI= X-MC-Unique: DJIE_Tr-N2-WBdBQfDKuIA-1 X-Mimecast-MFC-AGG-ID: DJIE_Tr-N2-WBdBQfDKuIA_1788207788 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 15/43] qapi: convert trivial intro sections for acpi.json Date: Mon, 31 Aug 2026 16:19:17 -0400 Message-ID: <20260831201945.287730-16-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207832821158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/acpi.json | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/qapi/acpi.json b/qapi/acpi.json index 906b3687a55..d2c59df30b2 100644 --- a/qapi/acpi.json +++ b/qapi/acpi.json @@ -107,9 +107,8 @@ =20 ## # @query-acpi-ospm-status: -# -# Return a list of `ACPIOSTInfo` for devices that support status -# reporting via ACPI _OST method. +# Return a list of `ACPIOSTInfo` for devices +# that support status reporting via ACPI _OST method. # # Since: 2.1 # @@ -126,8 +125,7 @@ =20 ## # @ACPI_DEVICE_OST: -# -# Emitted when guest executes ACPI _OST method. +# Emitted when guest executes ACPI _OST method. # # @info: OSPM Status Indication # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207855; cv=none; d=zohomail.com; s=zohoarc; b=ba4X9XTGNsMj8zDZD/kLrQALDEghgMyi1gW7FFpoE5BRHhemKJeDNyxw9jhZlIAbtdHhaWXWCcm8jDDVlpoaQJp5gjL5NvwHa6j+holD8ZwLW9+EhNcDMFMFQ0TJMdUdxXJNgAxb6v1k0Owy8mt1y+l99A7oYYwf+ZH3AUt6ObA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207855; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=53kJeaXAGXWbWgaUWrPPbMnvvgjeb4ogml1Llx3Dmyw=; b=bBlQc7qmXje+uTMQpKB0BRiMN6i3pN7sBC7MVO324Meo15TRnjtPuMKlddToqTRwdcQT7IJMjOZa2k/QUCZztjNg4MSsklMWIFqhsMW/2bk+wh+UTnh9a+xNbiXMJsl+22JfAEZQ4O+wwV8PjUSdh2uEwTdyUusngjhFOMNKmKU= 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 1788207855943573.4042070260624; Mon, 31 Aug 2026 13:24:15 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xk-0003fi-QS; Mon, 31 Aug 2026 16:23:48 -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 1x18XD-0002kx-VC for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:19 -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 1x18XB-00080P-QX for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:15 -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-629-DTlpBjCDMkiOuYikMIMyJg-1; Mon, 31 Aug 2026 16:23:09 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4AE9218D7268; Mon, 31 Aug 2026 20:22:43 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BB1E61800577; Mon, 31 Aug 2026 20:22:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207792; 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=53kJeaXAGXWbWgaUWrPPbMnvvgjeb4ogml1Llx3Dmyw=; b=R2XQRq92p1y6TqlwTRdnNaDpOYNAyxKlkTqE3Z+814WvxuANXX9UDxZNFbSrzY2Cojjnop br63qjjv4VVKxd/j9fUi25bBvG+55Kq5EGLZqZBeFGyyHorPTuyGIJn1th1GQ8DXL3Z7ac LciqP7lGdOM6E8L/k4+nW1k3udPwXUc= X-MC-Unique: DTlpBjCDMkiOuYikMIMyJg-1 X-Mimecast-MFC-AGG-ID: DTlpBjCDMkiOuYikMIMyJg_1788207787 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 16/43] qapi: convert trivial intro sections for tpm.json Date: Mon, 31 Aug 2026 16:19:18 -0400 Message-ID: <20260831201945.287730-17-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207856730158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/tpm.json | 29 ++++++++++------------------- 1 file changed, 10 insertions(+), 19 deletions(-) diff --git a/qapi/tpm.json b/qapi/tpm.json index 3f2850a5733..6d94be656ae 100644 --- a/qapi/tpm.json +++ b/qapi/tpm.json @@ -10,8 +10,7 @@ =20 ## # @TpmModel: -# -# An enumeration of TPM models +# An enumeration of TPM models # # @tpm-tis: TPM TIS model # @@ -26,8 +25,7 @@ =20 ## # @query-tpm-models: -# -# Return a list of supported TPM models +# Return a list of supported TPM models # # Since: 1.5 # @@ -41,8 +39,7 @@ =20 ## # @TpmType: -# -# An enumeration of TPM types +# An enumeration of TPM types # # @passthrough: TPM passthrough type # @@ -55,8 +52,7 @@ =20 ## # @query-tpm-types: -# -# Return a list of supported TPM types +# Return a list of supported TPM types # # Since: 1.5 # @@ -70,8 +66,7 @@ =20 ## # @TPMPassthroughOptions: -# -# Information about the TPM passthrough type +# Information about the TPM passthrough type # # @path: string describing the path used for accessing the TPM device # @@ -87,8 +82,7 @@ =20 ## # @TPMEmulatorOptions: -# -# Information about the TPM emulator type +# Information about the TPM emulator type # # @chardev: Name of a unix socket chardev # @@ -121,9 +115,8 @@ =20 ## # @TpmTypeOptions: -# -# A union referencing different TPM backend types' configuration -# options +# A union referencing different TPM backend types' configuration +# options # # @type: # - 'passthrough' The configuration options for the TPM @@ -142,8 +135,7 @@ =20 ## # @TPMInfo: -# -# Information about the TPM +# Information about the TPM # # @id: The Id of the TPM # @@ -161,8 +153,7 @@ =20 ## # @query-tpm: -# -# Return information about the TPM device +# Return information about the TPM device # # Since: 1.5 # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207898; cv=none; d=zohomail.com; s=zohoarc; b=hFwY33gY9lQik1SHoQMzG3YohWbR7JL7y7TrVTHWqzi5yoPIZZDQ0GG4v+ddIP6wMRTMOSvS5jz01NGLJioAEOmgUamqQrR1gQd/avVquE6Dfyip9h2E3wqq1L1FdOqEEtx7xvzDio3kQSks6eZNlSDpA6EL5QIV5MWY3f8EIwM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207898; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ZxLS1A1Q/a8oNO8QBx5OtbcL4KDpeJ6pmBHML3XgByc=; b=HWw3lAOFP7eTryOJ9JIcBW/EMYCGleTPDKKQLwapM1TXndVk7TlxdoUdBm9/Vap9ZOxU5XolaCV46DqS+lm+VdfCctobTs36+nTcChd/kYGhYnkbyhWMf7zCP2Da/uhHTknHZvroQ3mJhVEIbbcPsr5YBRSVyj9KudUeviZEh5s= 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 1788207898362838.7755507028598; Mon, 31 Aug 2026 13:24:58 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xp-0004Jm-It; Mon, 31 Aug 2026 16:23:53 -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 1x18XJ-0002o6-Eq for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:22 -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 1x18XI-00083E-3x for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:21 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-306-fvFCewIxNqmxsskZhPUyNw-1; Mon, 31 Aug 2026 16:23:15 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 6B01D1936139; Mon, 31 Aug 2026 20:22:52 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 8A5DB1800577; Mon, 31 Aug 2026 20:22:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207799; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZxLS1A1Q/a8oNO8QBx5OtbcL4KDpeJ6pmBHML3XgByc=; b=c5mTg27YuOz9M/4dA+XBSuUAi4ciEoik+dXSoxH0ndoEJKRdsF+F+prD0opMLVuKo7KC+C y7ESpB6CL20kGjpciARL5XeQTiZItjAXOwCd7FSBAcmSuXIWzsH8QmG5bqnJmi/eq13WKH hoMMNLfiLIyycBghrn3CuOewATGAndI= X-MC-Unique: fvFCewIxNqmxsskZhPUyNw-1 X-Mimecast-MFC-AGG-ID: fvFCewIxNqmxsskZhPUyNw_1788207791 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 17/43] qapi: convert trivial intro sections for qdev.json Date: Mon, 31 Aug 2026 16:19:19 -0400 Message-ID: <20260831201945.287730-18-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207900621154100 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/qdev.json | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/qapi/qdev.json b/qapi/qdev.json index 974cf9c5830..2f951e5ef8d 100644 --- a/qapi/qdev.json +++ b/qapi/qdev.json @@ -14,8 +14,7 @@ =20 ## # @device-list-properties: -# -# List properties associated with a device. +# List properties associated with a device. # # @typename: the type name of a device # @@ -33,8 +32,7 @@ =20 ## # @device_add: -# -# Add a device. +# Add a device. # # @driver: the name of the new device's driver # @@ -85,8 +83,7 @@ =20 ## # @device_del: -# -# Remove a device from a guest +# Remove a device from a guest # # @id: the device's ID or QOM path # @@ -145,9 +142,8 @@ =20 ## # @DEVICE_UNPLUG_GUEST_ERROR: -# -# Emitted when a device hot unplug fails due to a guest reported -# error. +# Emitted when a device hot unplug fails due to a guest reported +# error. # # @device: the device's ID if it has one # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207876; cv=none; d=zohomail.com; s=zohoarc; b=HvZ9rbUWS6cLtHn7FUFmU+x6rCgPXvgoatHaqTJ5/IhfrNSWTqxKiialqS8m3wlR7peBAMH+ELy/LFqj9CWSp89wlE3Ea1a9chFSsXtJAnLPVuuu0bwrc/8Cl50KJGfEuy/H29PIHh+SFDaHv4Jvn1zM50IJ1DckBQS0JC2l3jc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207876; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Rrr0aq5qW3Bpm6ENGOJu7B6TQXjJHrQBrFBPuknWGuk=; b=YGrXs7TgYFSSNSfdQY6CgtPCc/WuMSklRLjiGjqtHh9XMtp5MQIIlyxCJiI/a9GRB5ponqAS2dK08HDOZahkn+vy7GvKklA4nXrk822ublcW5rXX7A8sITrnTNG3Q3jQDErVhANLCjisr240Y+vCtzftLZVSbpiz619lumt+EF0= 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 1788207876239356.9301894434291; Mon, 31 Aug 2026 13:24:36 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xm-0003vI-Kx; Mon, 31 Aug 2026 16:23:50 -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 1x18XK-0002pQ-RM for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:28 -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 1x18XI-00083N-Pf for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:22 -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-97-6TbzN62tNNmcROpOQ73Krw-1; Mon, 31 Aug 2026 16:23:16 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2413C189D617; Mon, 31 Aug 2026 20:23:02 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BE3251800347; Mon, 31 Aug 2026 20:22:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207799; 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=Rrr0aq5qW3Bpm6ENGOJu7B6TQXjJHrQBrFBPuknWGuk=; b=XfRM3M8430cP7ixg8XTUu4kYz+9umbr7xXX/FsWvy4s+P8A/5gN85z7bFKVuqutF3Oac7o VRJ10lxRvg0wRx8DKz3ypzZ3OGqE2ZUVGn/cCitttMxM6wp/yCrS9fyEKmOI6+vD0T2O9B R+E5DPfkTeyYUFaq+BcaVW7VXkCO5NA= X-MC-Unique: 6TbzN62tNNmcROpOQ73Krw-1 X-Mimecast-MFC-AGG-ID: 6TbzN62tNNmcROpOQ73Krw_1788207793 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 18/43] qapi: convert trivial intro sections for control.json Date: Mon, 31 Aug 2026 16:19:20 -0400 Message-ID: <20260831201945.287730-19-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207878814158501 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/control.json | 30 +++++++++++------------------- 1 file changed, 11 insertions(+), 19 deletions(-) diff --git a/qapi/control.json b/qapi/control.json index 9a5302193d6..0fc465936d8 100644 --- a/qapi/control.json +++ b/qapi/control.json @@ -10,8 +10,7 @@ =20 ## # @qmp_capabilities: -# -# Enable QMP capabilities. +# Enable QMP capabilities. # # @enable: An optional list of `QMPCapability` values to enable. The # client must not enable any capability that is not mentioned in @@ -41,9 +40,9 @@ =20 ## # @QMPCapability: -# -# Enumeration of capabilities to be advertised during initial client -# connection, used for agreeing on particular QMP extension behaviors. +# Enumeration of capabilities to be advertised during initial +# client connection, used for agreeing on particular QMP extension +# behaviors. # # @oob: QMP ability to support out-of-band requests. (Please refer to # qmp-spec.rst for more information on OOB) @@ -55,8 +54,7 @@ =20 ## # @VersionTriple: -# -# A three-part version number. +# A three-part version number. # # @major: The major version number. # @@ -71,8 +69,7 @@ =20 ## # @VersionInfo: -# -# A description of QEMU's version. +# A description of QEMU's version. # # @qemu: The version of QEMU. By current convention, a micro version # of 50 signifies a development branch. A micro version greater @@ -92,8 +89,7 @@ =20 ## # @query-version: -# -# Return the current version of QEMU. +# Return the current version of QEMU. # # Returns: An object describing the current version of QEMU. # @@ -118,8 +114,7 @@ =20 ## # @CommandInfo: -# -# Information about a QMP command +# Information about a QMP command # # @name: The command name # @@ -129,8 +124,7 @@ =20 ## # @query-commands: -# -# Return a list of supported QMP commands by this server +# Return a list of supported QMP commands by this server # # Returns: A list of all supported commands # @@ -177,8 +171,7 @@ =20 ## # @MonitorMode: -# -# An enumeration of monitor modes. +# An enumeration of monitor modes. # # @readline: HMP monitor (human-oriented command line interface) # @@ -190,8 +183,7 @@ =20 ## # @MonitorOptions: -# -# Options to be used for adding a new monitor. +# Options to be used for adding a new monitor. # # @id: Name of the monitor # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207871; cv=none; d=zohomail.com; s=zohoarc; b=Wg4nKLFnrnLGTHGKdxwMCKj1EylLtLCHUKalPIp/DCK8nsucq0K4gMKyfGTUJSmTZR6f8SHab/O2oOSJjYWkBH5v+tspbMGz3dBh8QSDbNLmOJxzALM3u4fFsgnVrnJGypee38lO0e/CeSEpqQdVi1ZExpqiivX0NLyg9M+3hzU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207871; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=5E80AYcJQq1AFb1blKcFRy9kxc8JKyis50TCaxBSCf8=; b=HITxDuvv07qGPQg75kDXwy0cP1b8uJRk+R6jYtyxWKvFveYXf0jjTXtyMtrNwz+YEr7MlUZ7aMBEjPxrHy6kM1rilGWtHYsGGvKt+23laA+aF4jkdMQ4Nu/3mLtp4AACHmSDq1kdOlcSC4fljUfD3Fgtdu11AtI25AuAaCGg0DA= 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 1788207871193511.6285132248946; Mon, 31 Aug 2026 13:24:31 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xo-0004AW-8m; Mon, 31 Aug 2026 16:23:52 -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 1x18XU-00032J-Ub for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:34 -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 1x18XR-00085Z-92 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:31 -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-54-Zx6s5-VSNwO8wSYOGXLPyQ-1; Mon, 31 Aug 2026 16:23:25 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id C1A5D18BC411; Mon, 31 Aug 2026 20:23:09 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 59A2418005B7; Mon, 31 Aug 2026 20:23:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207808; 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=5E80AYcJQq1AFb1blKcFRy9kxc8JKyis50TCaxBSCf8=; b=NskfwxASSB/j556grYhpiZu4YLvOinI5ilZShvA2veHTph1xohSMlhUz5sb6ih3M7qEk+c tbNUkOFKsQ7xsz5NgZm0sEgBum40st8hSYq0KuET1hyCyOHFjkalJ7vMuVtIjrMwRNjrXG 8w3iT9F3l8Tsnk/QQ3PtylGtYUKJegg= X-MC-Unique: Zx6s5-VSNwO8wSYOGXLPyQ-1 X-Mimecast-MFC-AGG-ID: Zx6s5-VSNwO8wSYOGXLPyQ_1788207802 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 19/43] qapi: convert trivial intro sections for dump.json Date: Mon, 31 Aug 2026 16:19:21 -0400 Message-ID: <20260831201945.287730-20-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207874218154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/dump.json | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/qapi/dump.json b/qapi/dump.json index 690f3963fe1..520c58cbcd8 100644 --- a/qapi/dump.json +++ b/qapi/dump.json @@ -12,8 +12,7 @@ =20 ## # @DumpGuestMemoryFormat: -# -# An enumeration of guest-memory-dump's format. +# An enumeration of guest-memory-dump's format. # # @elf: elf format # @@ -116,8 +115,8 @@ =20 ## # @DumpStatus: -# -# Describe the status of a long-running background guest memory dump. +# Describe the status of a long-running background guest memory +# dump. # # @none: no `dump-guest-memory` has started yet. # @@ -134,8 +133,7 @@ =20 ## # @DumpQueryResult: -# -# The result format for `query-dump`. +# The result format for `query-dump`. # # @status: enum of `DumpStatus`, which shows current dump status # @@ -152,8 +150,7 @@ =20 ## # @query-dump: -# -# Query latest dump status. +# Query latest dump status. # # Returns: An object showing the dump status. # @@ -169,8 +166,7 @@ =20 ## # @DUMP_COMPLETED: -# -# Emitted when background dump has completed +# Emitted when background dump has completed # # @result: final dump status # @@ -203,8 +199,7 @@ =20 ## # @query-dump-guest-memory-capability: -# -# Return the available formats for `dump-guest-memory` +# Return the available formats for `dump-guest-memory` # # Returns: An object listing available formats for `dump-guest-memory` # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207887; cv=none; d=zohomail.com; s=zohoarc; b=ibBw7FFi5LnoGUxCDkSzW4ge9jcVu5jdRaUM3u9KTU/I2oYol5l7XSlT9+6iQl+2a+mbuhddsGisPd00lXh1HE9wFND6EwZGxH6yaC6N6R9zHjbH0pnPHsGYcjPiKMIKU4Xr9gtiC2IIP+myi6g8pUmPmjDoHBJ922AgpMIk7kg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207887; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=paUL78gCdpaCrvbsmed4HTHvmj42cb8WXYX01ka0V0s=; b=mb68FvjVJCETbLEcN9Zz7TpHsKAHzzH8beDZUbuKoKuLTAm923oFyCRo9meggDvrsQYJy4fu3FcvABjJzFOZf9szNaF3wyN2t/w53xxI9D62IsPVoYmvjZBGazyEm5MhVWSzZbkJC/cswHyiHSOVzRheBVhVamflT8w9kVj/+a0= 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 1788207887421578.6171631958154; Mon, 31 Aug 2026 13:24:47 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Xp-0004O0-NW; Mon, 31 Aug 2026 16:23:53 -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 1x18XW-00035N-TZ for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:36 -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 1x18XT-000866-90 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:33 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-680-1POLMyqEOI2R_KshbGM8_A-1; Mon, 31 Aug 2026 16:23:28 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 24F14196F741; Mon, 31 Aug 2026 20:23:16 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 2DA391800347; Mon, 31 Aug 2026 20:23:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207810; 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=paUL78gCdpaCrvbsmed4HTHvmj42cb8WXYX01ka0V0s=; b=gUg7U4JYt5q0v4GU017ap33bRCRKb46tchXqFfgbqYHcI/OWX0T9A+7ZGlGtba+e+i5O74 Rv/vMPI6rS5OAsf2Ps65VyuQWSn4SsclxeiZK5WgUQSYdYfuiqLku0UvkPAfhHqzuI1Nju xcQsmHlWy5g+id3FY1je4h3Vta6XGAs= X-MC-Unique: 1POLMyqEOI2R_KshbGM8_A-1 X-Mimecast-MFC-AGG-ID: 1POLMyqEOI2R_KshbGM8_A_1788207804 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 20/43] qapi: convert trivial intro sections for common.json Date: Mon, 31 Aug 2026 16:19:22 -0400 Message-ID: <20260831201945.287730-21-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207890464154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/common.json | 29 ++++++++++------------------- 1 file changed, 10 insertions(+), 19 deletions(-) diff --git a/qapi/common.json b/qapi/common.json index af7e3d618a7..c1bbed21e7f 100644 --- a/qapi/common.json +++ b/qapi/common.json @@ -9,8 +9,7 @@ =20 ## # @IoOperationType: -# -# An enumeration of the I/O operation types +# An enumeration of the I/O operation types # # @read: read operation # @@ -23,8 +22,7 @@ =20 ## # @OnOffAuto: -# -# An enumeration of three options: on, off, and auto +# An enumeration of three options: on, off, and auto # # @auto: QEMU selects the value between on and off # @@ -39,8 +37,7 @@ =20 ## # @OnOffSplit: -# -# An enumeration of three values: on, off, and split +# An enumeration of three values: on, off, and split # # @on: Enabled # @@ -72,8 +69,7 @@ =20 ## # @OffAutoPCIBAR: -# -# An enumeration of options for specifying a PCI BAR +# An enumeration of options for specifying a PCI BAR # # @off: The specified feature is disabled # @@ -98,8 +94,7 @@ =20 ## # @PCIELinkSpeed: -# -# An enumeration of PCIe link speeds in units of GT/s +# An enumeration of PCIe link speeds in units of GT/s # # @2_5: 2.5GT/s # @@ -120,8 +115,7 @@ =20 ## # @PCIELinkWidth: -# -# An enumeration of PCIe link width +# An enumeration of PCIe link width # # @1: x1 # @@ -144,8 +138,7 @@ =20 ## # @HostMemPolicy: -# -# Host memory policy types +# Host memory policy types # # @default: restore default policy, remove any nondefault policy # @@ -164,9 +157,8 @@ =20 ## # @NetFilterDirection: -# -# Indicates whether a netfilter is attached to a netdev's transmit -# queue or receive queue or both. +# Indicates whether a netfilter is attached to a netdev's transmit +# queue or receive queue or both. # # @all: the filter is attached both to the receive and the transmit # queue of the netdev (default). @@ -184,8 +176,7 @@ =20 ## # @GrabToggleKeys: -# -# Key combinations to toggle input-linux between host and guest. +# Key combinations to toggle input-linux between host and guest. # # @ctrl-ctrl: left and right control key # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207912; cv=none; d=zohomail.com; s=zohoarc; b=MpCAnGVNNri1lvZRGsV+bIbEdiaLzYzJQfpGARe6TGLZ6t2SmpnvaDLmC0uCg3bwFSJEMoNRdKufMvJNMJNCnGNlC86aG16gbBZjMr+pA8T7MsjWFH30o6e2U0RzXpQTIq6vQFXat423tu0wSsNiQZzZIXRyx064mElfQ3QJLv4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207912; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=QP7QUbGEfuohezFKRNTIokfJyo/v9qvglGiwlHcfMr4=; b=mCm5BzFVtt6EXDTv6Ii3kMHit306QHiL2+S3XDL9heytSQOBpdy8O7NxVVogXANibu/DcUhofrdT5JcmP4xaYzNu3eS/PniLy9murIR4VtaBKe6+4mw8/XrS2AMPO7vAzP+8UtJ8Ha24xAe6JnGnn2ryH2AUwwGBPraV0q1usa4= 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 1788207912182761.832889591967; Mon, 31 Aug 2026 13:25:12 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Y9-0005He-QE; Mon, 31 Aug 2026 16:24:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18Xc-0003B8-Fd for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:42 -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 1x18XX-00087d-BT for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:38 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-17-2TTsUxsyMkqDJl8al62dtg-1; Mon, 31 Aug 2026 16:23:29 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EAC601945106; Mon, 31 Aug 2026 20:23:23 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 692CB1800577; Mon, 31 Aug 2026 20:23:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207814; 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=QP7QUbGEfuohezFKRNTIokfJyo/v9qvglGiwlHcfMr4=; b=OtvQGf5thTtXeB3yiq0aD20Zb4oTniAhksWsIAfZoHzEBVqNb00jE4mqKvuIz8J5jGBO1C 4jabNCk3bSQDWn+5IOwPM3bjAhlvL4wwdWsqXMPj4CAWiuvA+ljBbXi6LL/lI14IyJ7FSY KTlM1Pm7Q+IeaQlg+emlKnp8eITNgjs= X-MC-Unique: 2TTsUxsyMkqDJl8al62dtg-1 X-Mimecast-MFC-AGG-ID: 2TTsUxsyMkqDJl8al62dtg_1788207807 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 21/43] qapi: convert trivial intro sections for sockets.json Date: Mon, 31 Aug 2026 16:19:23 -0400 Message-ID: <20260831201945.287730-22-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207912952158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/sockets.json | 31 ++++++++++++------------------- 1 file changed, 12 insertions(+), 19 deletions(-) diff --git a/qapi/sockets.json b/qapi/sockets.json index 473be2ac58a..210d07b5ef2 100644 --- a/qapi/sockets.json +++ b/qapi/sockets.json @@ -9,8 +9,7 @@ =20 ## # @NetworkAddressFamily: -# -# The network address family +# The network address family # # @ipv4: IPV4 family # @@ -41,9 +40,8 @@ =20 ## # @InetSocketAddress: -# -# Captures a socket address or address range in the Internet -# namespace. +# Captures a socket address or address range in the Internet +# namespace. # # @numeric: true if the host/port are guaranteed to be numeric, false # if name resolution should be attempted. Defaults to false. @@ -98,8 +96,8 @@ =20 ## # @UnixSocketAddress: -# -# Captures a socket address in the local ("Unix socket") namespace. +# Captures a socket address in the local ("Unix socket") +# namespace. # # @path: filesystem path to use # @@ -121,8 +119,7 @@ =20 ## # @VsockSocketAddress: -# -# Captures a socket address in the vsock namespace. +# Captures a socket address in the vsock namespace. # # @cid: unique host identifier # @@ -140,8 +137,7 @@ =20 ## # @FdSocketAddress: -# -# A file descriptor name or number. +# A file descriptor name or number. # # @str: decimal is for file descriptor number, otherwise it's a file # descriptor name. Named file descriptors are permitted in @@ -197,9 +193,8 @@ =20 ## # @SocketAddressLegacy: -# -# Captures the address of a socket, which could also be a named file -# descriptor +# Captures the address of a socket, which could also be a named +# file descriptor # # @type: Transport type # @@ -219,8 +214,7 @@ =20 ## # @SocketAddressType: -# -# Available `SocketAddress` types +# Available `SocketAddress` types # # @inet: Internet address # @@ -237,9 +231,8 @@ =20 ## # @SocketAddress: -# -# Captures the address of a socket, which could also be a socket file -# descriptor +# Captures the address of a socket, which could also be a socket +# file descriptor # # @type: Transport type # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207883; cv=none; d=zohomail.com; s=zohoarc; b=jPQP3BvCuUqtxy2oiuW4xdufoToD9UfZABqruoideaBfQCy7Aoe8h8GQposI6JhrUnngayLk8FcFX61drrN4m76SwrDscZ6bGyiTsdlA5Pa95sdWUm6nMGG2fppr70eZM+EHEVG6Dj+j3SkBuoRfejBFWke6cKn2EgHBg2LLJy0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207883; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=K8AG+94F77edoTiPAI8IPsNpOPrIzUtI0R/Rih5SccE=; b=WKMj8DywqS/1Xtim8o/fXg05bjWSN0fK6tlkegKM9H1V0/bFZOUmUJ0vd7JleS1a9LZfTch3qFgrY4ZW7YMu0NXzlAwl8lQHWxkHOvNzlyc0N7U3Qn7aRUU19G4uxQePBTP7o28Bgrv3m+HgSKeIHAZ8wQ0w9rNfG6KkEAV74VE= 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 1788207883206964.932526909314; Mon, 31 Aug 2026 13:24:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YK-0005v9-7Q; Mon, 31 Aug 2026 16:24:24 -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 1x18Xd-0003Dh-U8 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:42 -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 1x18Xc-000891-8H for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:41 -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-66-3a7aqxNSMtKAQ5-ch_pvGQ-1; Mon, 31 Aug 2026 16:23:34 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 817AB191FCE2; Mon, 31 Aug 2026 20:23:31 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3DD3B1800577; Mon, 31 Aug 2026 20:23:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207819; 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=K8AG+94F77edoTiPAI8IPsNpOPrIzUtI0R/Rih5SccE=; b=VAN/S0k8X9XaNV7F51DifZuZcryNNTz7MD1Zn2vKMKuMPJjN7vqPMAtviUO5VrfxPN6RKR P3O1f6t3L+6IYLRB0xR+ub6c6TnM2ZOPoJzAsJjPTT8NICoqM2EUvOzkMESl5n0VBPqLvN r1E+Un7zw7vtVcsBJoH3AIy6+D1H4FA= X-MC-Unique: 3a7aqxNSMtKAQ5-ch_pvGQ-1 X-Mimecast-MFC-AGG-ID: 3a7aqxNSMtKAQ5-ch_pvGQ_1788207811 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 22/43] qapi: convert trivial intro sections for transaction.json Date: Mon, 31 Aug 2026 16:19:24 -0400 Message-ID: <20260831201945.287730-23-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207884938158501 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/transaction.json | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/qapi/transaction.json b/qapi/transaction.json index 4b4eb09bf38..c0dc811ba61 100644 --- a/qapi/transaction.json +++ b/qapi/transaction.json @@ -12,8 +12,7 @@ =20 ## # @Abort: -# -# This action can be used to test transaction failure. +# This action can be used to test transaction failure. # # Since: 1.6 ## @@ -22,8 +21,7 @@ =20 ## # @ActionCompletionMode: -# -# An enumeration of transactional completion modes. +# An enumeration of transactional completion modes. # # @individual: Do not attempt to cancel any other Actions if any # Actions fail after the Transaction request succeeds. All @@ -156,9 +154,8 @@ =20 ## # @TransactionAction: -# -# A discriminated record of operations that can be performed with -# `transaction`. +# A discriminated record of operations that can be performed with +# `transaction`. # # @type: the operation to be performed # @@ -184,8 +181,7 @@ =20 ## # @TransactionProperties: -# -# Optional arguments to modify the behavior of a Transaction. +# Optional arguments to modify the behavior of a Transaction. # # @completion-mode: Controls how jobs launched asynchronously by # Actions will complete or fail as a group. See --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207874; cv=none; d=zohomail.com; s=zohoarc; b=I3Vd3+6+ac2t6MXufBM41SJcRBq0Jbk/mm+m0jR2NYKgGPCX9t90QLsN0HOcRipkoV5yl+gEhINTDGux90zLckZxgkn7N5HUFgHrXvgK6kFZ5jmTVy/jezqLHwXGGwnz1VGzmdxPWowXIkSfQku/VgKkVHaKlh/NCvQKhYGJpok= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207874; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=+b4OT3j/K4d4s6nmaAGr51pQkyEJxm8NVd9Otcg/Ht8=; b=Ju9abkJUkaSKhpu9uuxTWZzw8nTFRkl6kCpDZFBv8goSAtrCc75WlSKVCVA7dSR6I9HbWuoFJw6W99KGaJq9vaUtPGjm/hxt2zvCmLUPYfFb0JMdpw2Q+WE3mB9hLoTiXDv+F1xYBYZrK3lFknLzKmEgHiPxORlyRC8bXjLQIB4= 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 1788207874564603.6936631084192; Mon, 31 Aug 2026 13:24:34 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YC-0005bG-Uv; Mon, 31 Aug 2026 16:24:17 -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 1x18Xk-0003db-66 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:48 -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 1x18Xh-0008B4-Sh for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:47 -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-509-fi7_7dcPOnmEuSBF7Mybhg-1; Mon, 31 Aug 2026 16:23:41 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E711F1921EF9; Mon, 31 Aug 2026 20:23:38 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id DF5461800347; Mon, 31 Aug 2026 20:23:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207825; 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=+b4OT3j/K4d4s6nmaAGr51pQkyEJxm8NVd9Otcg/Ht8=; b=B8IKyZuY+RpZvopsIfuhRwvXt+38hTajeFWRMX2a7JRq4e1/tF4B/bIBoiQ8pc927B6cHb c6rRfMzqo3hR7Wruvb3RR3nvZfXM3RDYMUXOOZox0pvckuOsPyCPtCi0aqwh4U2MtrQNc7 ZFN2hxJR0bk7yAJIHnd3Bq26z9R48NI= X-MC-Unique: fi7_7dcPOnmEuSBF7Mybhg-1 X-Mimecast-MFC-AGG-ID: fi7_7dcPOnmEuSBF7Mybhg_1788207819 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 23/43] qapi: convert trivial intro sections for stats.json Date: Mon, 31 Aug 2026 16:19:25 -0400 Message-ID: <20260831201945.287730-24-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207874803158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/stats.json | 34 +++++++++++++--------------------- 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/qapi/stats.json b/qapi/stats.json index a98624531c3..af57ec08546 100644 --- a/qapi/stats.json +++ b/qapi/stats.json @@ -16,8 +16,7 @@ =20 ## # @StatsType: -# -# Enumeration of statistics types +# Enumeration of statistics types # # @cumulative: stat is cumulative; value can only increase. # @@ -38,8 +37,7 @@ =20 ## # @StatsUnit: -# -# Enumeration of unit of measurement for statistics +# Enumeration of unit of measurement for statistics # # @bytes: stat reported in bytes. # @@ -56,8 +54,7 @@ =20 ## # @StatsProvider: -# -# Enumeration of statistics providers. +# Enumeration of statistics providers. # # @kvm: since 7.1 # @@ -70,8 +67,7 @@ =20 ## # @StatsTarget: -# -# The kinds of objects on which one can request statistics. +# The kinds of objects on which one can request statistics. # # @vm: statistics that apply to the entire virtual machine or the # entire QEMU process. @@ -87,9 +83,8 @@ =20 ## # @StatsRequest: -# -# Indicates a set of statistics that should be returned by -# `query-stats`. +# Indicates a set of statistics that should be returned by +# `query-stats`. # # @provider: provider for which to return statistics. # @@ -113,10 +108,9 @@ =20 ## # @StatsFilter: -# -# The arguments to the `query-stats` command; specifies a target for -# which to request statistics and optionally the required subset of -# information for that target. +# The arguments to the `query-stats` command; specifies a target +# for which to request statistics and optionally the required +# subset of information for that target. # # @target: the kind of objects to query. Note that each possible # target may enable additional filtering options @@ -200,8 +194,7 @@ =20 ## # @StatsSchemaValue: -# -# Schema for a single statistic. +# Schema for a single statistic. # # @name: name of the statistic; each element of the schema is uniquely # identified by a target, a provider (both available in @@ -236,8 +229,7 @@ =20 ## # @StatsSchema: -# -# Schema for all available statistics for a provider and target. +# Schema for all available statistics for a provider and target. # # @provider: provider for this set of statistics. # @@ -255,8 +247,8 @@ =20 ## # @query-stats-schemas: -# -# Return the schema for all available runtime-collected statistics. +# Return the schema for all available runtime-collected +# statistics. # # @provider: a provider to restrict the query to. # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207911; cv=none; d=zohomail.com; s=zohoarc; b=WCrQLK/Pl85W0mFLHUr4RQXetIA1rRzGYjzybrC8gxQ77vN+05AjwezZAKNmPGlWgHFsenAUcVqbnNpFSEY5la986VRaVyG8n37WnXBx8WUuZpc/hYDplTgAD1FTSl4hXva3ueV9q7GKiO9fYpF1xk4DJMOBNlrUM+SedsDUspA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207911; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=FOyryAyUvVmwl4/qZOf0d22k1z8DeAksa2FdV0gP0NE=; b=F8+u+fsn8Yin6ssLIt7ldYZF1+5cDDSZEX8vVa+ow1gkwGT3ECIjCuU3u9ddpvEnzFgOPCkeQMiIBQPdocDuFnSci4IchNPi7qNthtF9QSYVHsZPeIY4GkcS3Y86hv9fh2TnGiD22berGf5XD0/yN3cApEXRTBKGYtdGcW0nxx8= 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 178820791120940.649665661833865; Mon, 31 Aug 2026 13:25:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YH-0005mF-Ea; Mon, 31 Aug 2026 16:24:21 -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 1x18Xs-0004kq-0o for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:57 -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 1x18Xp-0008D4-Eg for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:23:55 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-686-w-lcO4n8Mj6-CCwfhOzqTw-1; Mon, 31 Aug 2026 16:23:49 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 10326184A083; Mon, 31 Aug 2026 20:23:46 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 470D51800577; Mon, 31 Aug 2026 20:23:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207832; 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=FOyryAyUvVmwl4/qZOf0d22k1z8DeAksa2FdV0gP0NE=; b=eeRHPhl/saaRIdvcO38F42dl/4HVHV4oZOkAPeTDN50XFx+MJ0vHQ17+HkneAvB3XqRc4O S1IEhGod4qmsXLJtwnmUYSGxxxXi4LdPuQquW3hL2mbYWoEHKdqu6ZCFLzmAn7fFew7bNS NOd5atb3AHXnhL2Pkb1TfoTqyfj2pfo= X-MC-Unique: w-lcO4n8Mj6-CCwfhOzqTw-1 X-Mimecast-MFC-AGG-ID: w-lcO4n8Mj6-CCwfhOzqTw_1788207826 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 24/43] qapi: convert trivial intro sections for job.json Date: Mon, 31 Aug 2026 16:19:26 -0400 Message-ID: <20260831201945.287730-25-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207913177158501 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/job.json | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/qapi/job.json b/qapi/job.json index 31618e6ebcc..b68d7292423 100644 --- a/qapi/job.json +++ b/qapi/job.json @@ -9,8 +9,7 @@ =20 ## # @JobType: -# -# Type of a background job. +# Type of a background job. # # @commit: block commit job type, see `block-commit` # @@ -42,8 +41,7 @@ =20 ## # @JobStatus: -# -# Indicates the present state of a given job in its lifetime. +# Indicates the present state of a given job in its lifetime. # # @undefined: Erroneous, default state. Should not ever be visible. # @@ -90,8 +88,7 @@ =20 ## # @JobVerb: -# -# Represents command verbs that can be applied to a job. +# Represents command verbs that can be applied to a job. # # @cancel: see `job-cancel` # @@ -117,8 +114,7 @@ =20 ## # @JOB_STATUS_CHANGE: -# -# Emitted when a job transitions to a different status. +# Emitted when a job transitions to a different status. # # @id: The job identifier # @@ -259,8 +255,7 @@ =20 ## # @JobInfo: -# -# Information about a job. +# Information about a job. # # @id: The job identifier # @@ -294,8 +289,7 @@ =20 ## # @query-jobs: -# -# Return information about jobs. +# Return information about jobs. # # Returns: a list with info for each active job # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207891; cv=none; d=zohomail.com; s=zohoarc; b=AA/kWH6R0tdHJfu+DkFHHSR0TJFadKPWZZwtIA2wseoCq38JDc3ZMnm6KFdorLMv52G4Twjm+kNmTes/AvmnrWvKKrz3znasXrMia7KLW+w7EH4B5L0E1trlaBrTwU1qd4r5aTZjXQi2kltWQqdLlI0ekmhawOZWMymHAmAfqBs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207891; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=4l91jyPAAO7hilD1RJ8+HNLPzBoV65DoCBpgH8pqK0g=; b=f3YrmGJijNksGodONqdaWzyndxLOQrayGzc8aLUm5SY1K+HKTHMW96Z1TbQmgXv+aLlqv1DYuJbTWmiDHbHOy+SmOkfxMZbBV55LIm2hx9ouutgLYG/kpOFerCBaOgJbpF2HW9ntmRn6spubjeMokG+Y429CKstOvdOQXdmGxXo= 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 1788207891531350.13761145532794; Mon, 31 Aug 2026 13:24:51 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YI-0005qk-Oo; Mon, 31 Aug 2026 16:24: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 1x18Xz-0004xY-CK for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:05 -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 1x18Xx-0008Et-QK for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:03 -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-41--Cv9VqWIOBa22A9uM2LAFg-1; Mon, 31 Aug 2026 16:23:55 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 76CFC1921ECF; Mon, 31 Aug 2026 20:23:52 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 460EC18005AC; Mon, 31 Aug 2026 20:23:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207841; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=4l91jyPAAO7hilD1RJ8+HNLPzBoV65DoCBpgH8pqK0g=; b=Eygl2A8QcnvrQDi2T3TPmk0Iy1i7E9xuoSjmzIlvUMr/rqlvfn9v+x3f5GAoppVAakzaqA DIkK5ajzbbIHN0IZ2wvhMc8oTxvZCsv4ltZbW6GwemqPVkVuGkh6xK6NOqibXsb95M79ei Uvr5az02ULfxO+IzQ25seG2V07f4ung= X-MC-Unique: -Cv9VqWIOBa22A9uM2LAFg-1 X-Mimecast-MFC-AGG-ID: -Cv9VqWIOBa22A9uM2LAFg_1788207832 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 25/43] qapi: convert trivial intro sections for pci.json Date: Mon, 31 Aug 2026 16:19:27 -0400 Message-ID: <20260831201945.287730-26-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207892914158500 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/pci.json | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/qapi/pci.json b/qapi/pci.json index 694c741e420..a6a79f91afc 100644 --- a/qapi/pci.json +++ b/qapi/pci.json @@ -13,8 +13,7 @@ =20 ## # @PciMemoryRange: -# -# A PCI device memory region +# A PCI device memory region # # @base: the starting address (guest physical) # @@ -26,8 +25,7 @@ =20 ## # @PciMemoryRegion: -# -# Information about a PCI device I/O region. +# Information about a PCI device I/O region. # # @bar: the index of the Base Address Register for this region # @@ -51,8 +49,7 @@ =20 ## # @PciBusInfo: -# -# Information about a bus of a PCI Bridge device +# Information about a bus of a PCI Bridge device # # @number: primary bus interface number. This should be the number of # the bus the device resides on. @@ -80,8 +77,7 @@ =20 ## # @PciBridgeInfo: -# -# Information about a PCI Bridge device +# Information about a PCI Bridge device # # @bus: information about the bus the device resides on # @@ -94,8 +90,7 @@ =20 ## # @PciDeviceClass: -# -# Information about the Class of a PCI device +# Information about the Class of a PCI device # # @desc: a string description of the device's class (not stable, and # should only be treated as informational) @@ -109,8 +104,7 @@ =20 ## # @PciDeviceId: -# -# Information about the Id of a PCI device +# Information about the Id of a PCI device # # @device: the PCI device id # @@ -128,8 +122,7 @@ =20 ## # @PciDeviceInfo: -# -# Information about a PCI device +# Information about a PCI device # # @bus: the bus number of the device # @@ -161,8 +154,7 @@ =20 ## # @PciInfo: -# -# Information about a PCI bus +# Information about a PCI bus # # @bus: the bus index # @@ -174,8 +166,7 @@ =20 ## # @query-pci: -# -# Return information about the PCI bus topology of the guest. +# Return information about the PCI bus topology of the guest. # # Returns: a list of info for each PCI bus. Each bus is # represented by a json-object, which has a key with a json-array --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207932; cv=none; d=zohomail.com; s=zohoarc; b=OgA7/MJcnKa6r/Hx3FprMvKWOw1dP6Sn4W1RdxknBuE/b/3EyX3+Tgp+rUu7M6CFYXhXcMqpRcenZc2wh7F3lDDR0FXylNvLdtpkPwOXvcFHDMAA24AsaZhZ0yhSWjpBnKwgMXYoDttGPzN9ADDCR9c9gyR5ay6jjyvSX8woLNU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207932; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=RQLl9Fz/e90VKbZH8iPZEXrmE8EWsrDRt4hVfZ8Hrwo=; b=eScUbNfUTkbF/KUPvvkBjFWh+zPAvHSV9RsxRoRz4nug7uheIyYRD3uPJbLjoAzycucOonmltzCeLg7+7lk4z4nZ23JuaAKdba+blxqME0Vfk5QFqBpNimF0NrrV3uMD6BKZlFCX88x5I958kS5WfkHdEnAU6IjgZWXyaDzy7pc= 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 1788207932041162.35775943684678; Mon, 31 Aug 2026 13:25:32 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YL-0005yL-Kl; Mon, 31 Aug 2026 16:24:25 -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 1x18Y6-0005Hz-Lb for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:13 -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 1x18Y4-0008GF-1b for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:10 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-31-hiXyKAF_Np2tW4fGQR2WHA-1; Mon, 31 Aug 2026 16:24:02 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 1CFC1184A08F; Mon, 31 Aug 2026 20:24:00 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A60101800577; Mon, 31 Aug 2026 20:23:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207847; 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=RQLl9Fz/e90VKbZH8iPZEXrmE8EWsrDRt4hVfZ8Hrwo=; b=RELPYFe13Je12KnPkIevC/B+YLCDIe/zJkJOGja54QJLDx8n3p8vGOmaHj2Q2TR/J++ype OPG2MNh/8YvOpWE1LJoIxioQ5x+/+Win1RE6yhG5lhwQv2X2cNngryHCeQqsIuKij3ZPyO AvUdsJDMF1vbJmnxGYnbxzA1uwIUEvM= X-MC-Unique: hiXyKAF_Np2tW4fGQR2WHA-1 X-Mimecast-MFC-AGG-ID: hiXyKAF_Np2tW4fGQR2WHA_1788207840 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 26/43] qapi: convert trivial intro sections for introspect.json Date: Mon, 31 Aug 2026 16:19:28 -0400 Message-ID: <20260831201945.287730-27-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1788207955566154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/introspect.json | 40 ++++++++++++++-------------------------- 1 file changed, 14 insertions(+), 26 deletions(-) diff --git a/qapi/introspect.json b/qapi/introspect.json index c8432c8ed8e..172ed389997 100644 --- a/qapi/introspect.json +++ b/qapi/introspect.json @@ -112,8 +112,7 @@ =20 ## # @SchemaInfoBuiltin: -# -# Additional `SchemaInfo` members for meta-type 'builtin'. +# Additional `SchemaInfo` members for meta-type 'builtin'. # # @json-type: the JSON type used for this type on the wire. # @@ -124,10 +123,9 @@ =20 ## # @JSONType: -# -# The four primitive and two structured types according to RFC 8259 -# section 1, plus 'int' (split off 'number'), plus the obvious top -# type 'value'. +# The four primitive and two structured types according to RFC +# 8259 section 1, plus 'int' (split off 'number'), plus the +# obvious top type 'value'. # # @string: JSON string # @@ -153,8 +151,7 @@ =20 ## # @SchemaInfoEnum: -# -# Additional `SchemaInfo` members for meta-type 'enum'. +# Additional `SchemaInfo` members for meta-type 'enum'. # # @members: the enum type's members, in no particular order. # (since 6.2) @@ -178,8 +175,7 @@ =20 ## # @SchemaInfoEnumMember: -# -# An object member. +# An object member. # # @name: the member's name, as defined in the QAPI schema. # @@ -193,8 +189,7 @@ =20 ## # @SchemaInfoArray: -# -# Additional `SchemaInfo` members for meta-type 'array'. +# Additional `SchemaInfo` members for meta-type 'array'. # # @element-type: the array type's element type. # @@ -207,8 +202,7 @@ =20 ## # @SchemaInfoObject: -# -# Additional `SchemaInfo` members for meta-type 'object'. +# Additional `SchemaInfo` members for meta-type 'object'. # # @members: the object type's (non-variant) members, in no particular # order. @@ -232,8 +226,7 @@ =20 ## # @SchemaInfoObjectMember: -# -# An object member. +# An object member. # # @name: the member's name, as defined in the QAPI schema. # @@ -257,8 +250,7 @@ =20 ## # @SchemaInfoObjectVariant: -# -# The variant members for a value of the type tag. +# The variant members for a value of the type tag. # # @case: a value of the type tag. # @@ -272,8 +264,7 @@ =20 ## # @SchemaInfoAlternate: -# -# Additional `SchemaInfo` members for meta-type 'alternate'. +# Additional `SchemaInfo` members for meta-type 'alternate'. # # @members: the alternate type's members, in no particular order. The # members' wire encoding is distinct, see @@ -288,8 +279,7 @@ =20 ## # @SchemaInfoAlternateMember: -# -# An alternate member. +# An alternate member. # # @type: the name of the member's type. # @@ -300,8 +290,7 @@ =20 ## # @SchemaInfoCommand: -# -# Additional `SchemaInfo` members for meta-type 'command'. +# Additional `SchemaInfo` members for meta-type 'command'. # # @arg-type: the name of the object type that provides the command's # parameters. @@ -322,8 +311,7 @@ =20 ## # @SchemaInfoEvent: -# -# Additional `SchemaInfo` members for meta-type 'event'. +# Additional `SchemaInfo` members for meta-type 'event'. # # @arg-type: the name of the object type that provides the event's # parameters. --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207886; cv=none; d=zohomail.com; s=zohoarc; b=nmtkERWkbKrxcJOSa34rXNWVgI/xfM6uAAebg2by2NPpA5PDMFz8XrRmlSEwaWgk3QUeBy4XlPD7u8U0kHM9ldzalp/OEl2KPBfc5VjAD+oAN9PxKfS+iyAQr2UVO6rgBl3iLQq7O+znRSO9vlAccQAjPAFXcMJ/ubNIrzY+Ow0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207886; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=y8wW2V1gmq4U2oGifMr03OEbp6q8ZFZvEQ5q6kHXpZc=; b=K/RdKkkFOCj7NbSUPKpMHpUhuRY8bXHZTciyXQN18S2gdsDJyHhhPPTLblXrVA2fsSpTMkITeSfzDjiKCCLToYt1GR0vGeu1+kA8UxVmrheulVG2cjeUEy/Jfb6UfMtoz89rXCWwFHrTPvFxM5wyH7TBYAW1dxiy2UOeUTsjP14= 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 1788207886441156.99854173453912; Mon, 31 Aug 2026 13:24:46 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YO-0006EX-Fp; Mon, 31 Aug 2026 16:24:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18YC-0005b3-Jz for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:16 -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 1x18YA-0008Hl-Sn for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:16 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-580-g8KQFvfPNuKhBNzurCJSLA-1; Mon, 31 Aug 2026 16:24:11 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 794B8195FE07; Mon, 31 Aug 2026 20:24:08 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3CD0A1800347; Mon, 31 Aug 2026 20:24:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207854; 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=y8wW2V1gmq4U2oGifMr03OEbp6q8ZFZvEQ5q6kHXpZc=; b=OxNdgEoEZ2T7vCPQ+DZ6THvXFXPCaZooBIg2tQdEjMy3LBBvDhxFYGxXigpDeye34Jk8vM WC1AVWxXQChc5UO7kdXphkmSJIofFhBhkD9MZNullJktzPm5uJIq7Mb9zSV6kqf0CBPb81 sbQ/a0xFSl4ODNN5Sa0hoRpC44BEb3U= X-MC-Unique: g8KQFvfPNuKhBNzurCJSLA-1 X-Mimecast-MFC-AGG-ID: g8KQFvfPNuKhBNzurCJSLA_1788207848 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 27/43] qapi: convert trivial intro sections for rocker.json Date: Mon, 31 Aug 2026 16:19:29 -0400 Message-ID: <20260831201945.287730-28-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207888846158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/rocker.json | 39 +++++++++++++-------------------------- 1 file changed, 13 insertions(+), 26 deletions(-) diff --git a/qapi/rocker.json b/qapi/rocker.json index 5d2dbd26034..7eb0a88dafd 100644 --- a/qapi/rocker.json +++ b/qapi/rocker.json @@ -9,8 +9,7 @@ =20 ## # @RockerSwitch: -# -# Rocker switch information. +# Rocker switch information. # # @name: switch name # @@ -25,8 +24,7 @@ =20 ## # @query-rocker: -# -# Return rocker switch information. +# Return rocker switch information. # # @name: switch name # @@ -43,8 +41,7 @@ =20 ## # @RockerPortDuplex: -# -# An enumeration of port duplex states. +# An enumeration of port duplex states. # # @half: half duplex # @@ -56,8 +53,7 @@ =20 ## # @RockerPortAutoneg: -# -# An enumeration of port autoneg states. +# An enumeration of port autoneg states. # # @off: autoneg is off # @@ -69,8 +65,7 @@ =20 ## # @RockerPort: -# -# Rocker switch port information. +# Rocker switch port information. # # @name: port name # @@ -93,8 +88,7 @@ =20 ## # @query-rocker-ports: -# -# Return rocker switch port information. +# Return rocker switch port information. # # @name: port name # @@ -115,8 +109,7 @@ =20 ## # @RockerOfDpaFlowKey: -# -# Rocker switch OF-DPA flow key +# Rocker switch OF-DPA flow key # # @priority: key priority, 0 being lowest priority # @@ -153,8 +146,7 @@ =20 ## # @RockerOfDpaFlowMask: -# -# Rocker switch OF-DPA flow mask +# Rocker switch OF-DPA flow mask # # @in-pport: physical input port # @@ -182,8 +174,7 @@ =20 ## # @RockerOfDpaFlowAction: -# -# Rocker switch OF-DPA flow action +# Rocker switch OF-DPA flow action # # @goto-tbl: next table ID # @@ -209,8 +200,7 @@ =20 ## # @RockerOfDpaFlow: -# -# Rocker switch OF-DPA flow +# Rocker switch OF-DPA flow # # @cookie: flow unique cookie ID # @@ -230,8 +220,7 @@ =20 ## # @query-rocker-of-dpa-flows: -# -# Return rocker OF-DPA flow information. +# Return rocker OF-DPA flow information. # # @name: switch name # @@ -261,8 +250,7 @@ =20 ## # @RockerOfDpaGroup: -# -# Rocker switch OF-DPA group +# Rocker switch OF-DPA group # # @id: group unique ID # @@ -305,8 +293,7 @@ =20 ## # @query-rocker-of-dpa-groups: -# -# Return rocker OF-DPA group information. +# Return rocker OF-DPA group information. # # @name: switch name # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207874; cv=none; d=zohomail.com; s=zohoarc; b=d9wd5jBDkghmJgtRKn6bH5URWHTypovNDPLpIY5n+tHYuyd85MeQoOHmdq+W0cwZwmsLJF7Oz+nIvj3dZFlDl8smIl/UfTIUPeHh3h7Mjh5/EyR0PBtySs+WepMklY27TCP841pMqbSQs2FhGvVS6infSzT5WvZViz14yVw89Yk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207874; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=cMeGh8F13Z46uyER7y88/d0ISiPeR9CDwXqnRAPj7ik=; b=HRcMaixLkcvFv1PA2BUcd9HKKzybHm00zgalV7kwaB8fYnIxyb17Au6C7xVLbYAGGAi+RzdMqpUOSZQlFKwcqUItnJVauNjNqODhZponWuZu5ilW01Dls0bqH/TErsgu2/xwtQwVLGXzvrkdPdUilTUPFuw2btQ8ORwgw0HtgcA= 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 1788207874172190.02243340658094; Mon, 31 Aug 2026 13:24:34 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YO-0006Em-Fm; Mon, 31 Aug 2026 16:24:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18YK-0005yw-Qz for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:25 -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 1x18YI-0008Ja-4d for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:24 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-690-GwxeO3OwOjOJ7UZHycldOg-1; Mon, 31 Aug 2026 16:24:17 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 20EE4180131D; Mon, 31 Aug 2026 20:24:15 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EC09B1800347; Mon, 31 Aug 2026 20:24:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207861; 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=cMeGh8F13Z46uyER7y88/d0ISiPeR9CDwXqnRAPj7ik=; b=HrFhH2UAh/Xz0ymmlG04H91HHjDR5DpLfb0q6Rp/H1DfRqhGSeKdS8soXMKF1wp7P/6q9X P6chT7AqSDnNKwo0RRCNN/0Le6sWNjsidGrH8L+VtpF4VQjVSnuCHjP2bNMjIdfVz+T+re rZG5ST4TPXcMJQhqXPKZF3rjyhYT2dM= X-MC-Unique: GwxeO3OwOjOJ7UZHycldOg-1 X-Mimecast-MFC-AGG-ID: GwxeO3OwOjOJ7UZHycldOg_1788207855 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 28/43] qapi: convert trivial intro sections for misc-i386.json Date: Mon, 31 Aug 2026 16:19:30 -0400 Message-ID: <20260831201945.287730-29-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207876294154101 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/misc-i386.json | 52 ++++++++++++++++----------------------------- 1 file changed, 18 insertions(+), 34 deletions(-) diff --git a/qapi/misc-i386.json b/qapi/misc-i386.json index 05a94d6c416..78ec9aec647 100644 --- a/qapi/misc-i386.json +++ b/qapi/misc-i386.json @@ -25,8 +25,7 @@ =20 ## # @SevState: -# -# An enumeration of SEV state information used during `query-sev`. +# An enumeration of SEV state information used during `query-sev`. # # @uninit: The guest is uninitialized. # @@ -52,8 +51,7 @@ =20 ## # @SevGuestType: -# -# An enumeration indicating the type of SEV guest being run. +# An enumeration indicating the type of SEV guest being run. # # @sev: The guest is a legacy SEV or SEV-ES guest. # @@ -66,8 +64,7 @@ =20 ## # @SevGuestInfo: -# -# Information specific to legacy SEV/SEV-ES guests. +# Information specific to legacy SEV/SEV-ES guests. # # @policy: SEV policy value # @@ -81,8 +78,7 @@ =20 ## # @SevSnpGuestInfo: -# -# Information specific to SEV-SNP guests. +# Information specific to SEV-SNP guests. # # @snp-policy: SEV-SNP policy value # @@ -93,8 +89,7 @@ =20 ## # @SevInfo: -# -# Information about Secure Encrypted Virtualization (SEV) support +# Information about Secure Encrypted Virtualization (SEV) support # # @enabled: true if SEV is active # @@ -144,8 +139,7 @@ =20 ## # @SevLaunchMeasureInfo: -# -# SEV Guest Launch measurement information +# SEV Guest Launch measurement information # # @data: the measurement value encoded in base64 # @@ -180,9 +174,8 @@ =20 ## # @SevCapability: -# -# The struct describes capability for a Secure Encrypted -# Virtualization feature. +# The struct describes capability for a Secure Encrypted +# Virtualization feature. # # @pdh: Platform Diffie-Hellman key (base64 encoded) # @@ -252,9 +245,8 @@ =20 ## # @SevAttestationReport: -# -# The struct describes attestation report for a Secure Encrypted -# Virtualization feature. +# The struct describes attestation report for a Secure Encrypted +# Virtualization feature. # # @data: guest attestation report (base64 encoded) # @@ -294,8 +286,7 @@ =20 ## # @SgxEpcSection: -# -# Information about intel SGX EPC section +# Information about intel SGX EPC section # # @node: the numa node # @@ -309,8 +300,7 @@ =20 ## # @SgxInfo: -# -# Information about intel Safe Guard eXtension (SGX) support +# Information about intel Safe Guard eXtension (SGX) support # # @sgx: true if SGX is supported # @@ -333,8 +323,7 @@ =20 ## # @query-sgx: -# -# Return information about configured SGX capabilities of guest +# Return information about configured SGX capabilities of guest # # Since: 6.2 # @@ -350,8 +339,7 @@ =20 ## # @query-sgx-capabilities: -# -# Return information about SGX capabilities of host +# Return information about SGX capabilities of host # # Since: 6.2 # @@ -367,8 +355,7 @@ =20 ## # @EvtchnPortType: -# -# An enumeration of Xen event channel port types. +# An enumeration of Xen event channel port types. # # @closed: The port is unused. # @@ -389,8 +376,7 @@ =20 ## # @EvtchnInfo: -# -# Information about a Xen event channel port +# Information about a Xen event channel port # # @port: the port number # @@ -419,8 +405,7 @@ =20 ## # @xen-event-list: -# -# Query the Xen event channels opened by the guest. +# Query the Xen event channels opened by the guest. # # Returns: list of open event channel ports. # @@ -456,8 +441,7 @@ =20 ## # @xen-event-inject: -# -# Inject a Xen event channel port (interrupt) to the guest. +# Inject a Xen event channel port (interrupt) to the guest. # # @port: The port number # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207911; cv=none; d=zohomail.com; s=zohoarc; b=U7F31ZfJQDwU5GPemyOcNptrtsrG/mUY1WRqfkA74L8HOMqkBEWCrbjI33sTzbICt+HPDvSXdrb1Q1sOnz73IVRdVHYLfTpR8P8Rh0ciLlAxYA2EWApAgP1ITMU/ChyqaTgrlxEobUsjA6/XCC0vpbQXtTKtpPMmRd/lOPWn2jc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207911; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=BCn/Ycwrut66144uUrLT80zpCgg+RoqrOgG6fdXeCGY=; b=UAWjMLxJW4FfLnodELSolGe+ak0fZj2f9XreDzdbUZBy8vrKYnvGDLS7CgIJV7SBxErf8tzIdnyr9luWVuy6H3yLXrMmftC0iteJfnzowAQ2HaHZK9843PdzknIvWYJuGSy4+y/xKDjbBV0aI4ZWrguUXpF6WYTUDnu8JMLQhEo= 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 1788207911923663.7463667294797; Mon, 31 Aug 2026 13:25:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18YT-0006xV-7Q; Mon, 31 Aug 2026 16:24:33 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x18YR-0006gR-DX for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:31 -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 1x18YP-0008Lp-Ko for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:31 -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-440-w_h5KMCUOy67bYeZnNAPSA-1; Mon, 31 Aug 2026 16:24:25 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 6427A18E678F; Mon, 31 Aug 2026 20:24:22 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 597B21800347; Mon, 31 Aug 2026 20:24:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207869; 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=BCn/Ycwrut66144uUrLT80zpCgg+RoqrOgG6fdXeCGY=; b=iL0vPIVM9jZyZQpHJgqd/UbjhtMdk5qEf5/2S8N8Jwx9Lq1CbwDZKFJO3hrAGfLMNTsEdE Plffu04Wqe+SbvkKgxlNmQgTk2MfUJA/u28vIJNgqutR/P8c2sdExnVh4Vqc9vcDYyk06I rrp8Pp0NGyEW2kYvJ2G1SvBJOfkIjkw= X-MC-Unique: w_h5KMCUOy67bYeZnNAPSA-1 X-Mimecast-MFC-AGG-ID: w_h5KMCUOy67bYeZnNAPSA_1788207862 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 29/43] qapi: convert trivial intro sections for block-export.json Date: Mon, 31 Aug 2026 16:19:31 -0400 Message-ID: <20260831201945.287730-30-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207912993158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block-export.json | 50 +++++++++++++++--------------------------- 1 file changed, 18 insertions(+), 32 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index dd724acf1cb..154f07b0b95 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -80,9 +80,8 @@ =20 ## # @BlockExportOptionsNbdBase: -# -# An NBD block export (common options shared between `nbd-server-add` -# and the NBD branch of `block-export-add`). +# An NBD block export (common options shared between +# `nbd-server-add` and the NBD branch of `block-export-add`). # # @name: Export name. If unspecified, the @device parameter is used # as the export name. (Since 2.12) @@ -97,9 +96,8 @@ =20 ## # @BlockExportOptionsNbd: -# -# An NBD block export (distinct options used in the NBD branch of -# `block-export-add`). +# An NBD block export (distinct options used in the NBD branch of +# `block-export-add`). # # @bitmaps: Also export each of the named dirty bitmaps reachable from # @device, so the NBD client can use NBD_OPT_SET_META_CONTEXT with @@ -121,8 +119,7 @@ =20 ## # @BlockExportOptionsVhostUserBlk: -# -# A vhost-user-blk block export. +# A vhost-user-blk block export. # # @addr: The vhost-user socket on which to listen. Both 'unix' and # 'fd' `SocketAddress` types are supported. Passed fds must be @@ -143,8 +140,7 @@ =20 ## # @FuseExportAllowOther: -# -# Possible allow_other modes for FUSE exports. +# Possible allow_other modes for FUSE exports. # # @off: Do not pass allow_other as a mount option. # @@ -195,8 +191,7 @@ =20 ## # @BlockExportOptionsVduseBlk: -# -# A vduse-blk block export. +# A vduse-blk block export. # # @name: the name of VDUSE device (must be unique across the host). # @@ -221,8 +216,7 @@ =20 ## # @NbdServerAddOptions: -# -# An NBD block export, per legacy `nbd-server-add` command. +# An NBD block export, per legacy `nbd-server-add` command. # # @device: The device name or node name of the node to be exported # @@ -266,8 +260,7 @@ =20 ## # @BlockExportRemoveMode: -# -# Mode for removing a block export. +# Mode for removing a block export. # # @safe: Remove export if there are no existing connections, fail # otherwise. @@ -289,8 +282,7 @@ =20 ## # @nbd-server-remove: -# -# Remove NBD export by name. +# Remove NBD export by name. # # @name: Block export id. # @@ -316,9 +308,8 @@ =20 ## # @nbd-server-stop: -# -# Stop QEMU's embedded NBD server, and unregister all devices -# previously added via `nbd-server-add`. +# Stop QEMU's embedded NBD server, and unregister all devices +# previously added via `nbd-server-add`. # # Since: 1.3 ## @@ -327,8 +318,7 @@ =20 ## # @BlockExportType: -# -# An enumeration of block export types +# An enumeration of block export types # # @nbd: NBD export # @@ -412,9 +402,8 @@ =20 ## # @BlockExportIothreads: -# -# Specify a single or multiple I/O threads in which to run a block -# export's I/O. +# Specify a single or multiple I/O threads in which to run a block +# export's I/O. # # @single: Run the export's I/O in the given single I/O thread. # @@ -436,8 +425,7 @@ =20 ## # @block-export-add: -# -# Creates a new block export. +# Creates a new block export. # # Since: 5.2 ## @@ -470,8 +458,7 @@ =20 ## # @BLOCK_EXPORT_DELETED: -# -# Emitted when a block export is removed and its id can be reused. +# Emitted when a block export is removed and its id can be reused. # # @id: Block export id. # @@ -482,8 +469,7 @@ =20 ## # @BlockExportInfo: -# -# Information about a single block export. +# Information about a single block export. # # @id: The unique identifier for the block export # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207944; cv=none; d=zohomail.com; s=zohoarc; b=bg5ZOPgnqHONBmVlpEi8Gj/c8sJN1CWudICIns+duJWCELnDCMzEUzcwV0wNkkICQsHmep38BdoInSHYNJK1Zem3j9Mf4U+WceSV/VATLVADFWzdx2izZepAMrryOcoRAd9ngZFvW/j0pIzKWcEQPdl/nUJJk2qMFz552uHafVA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207944; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Z3E4l/9ZBojjapKTPoc2rkBnvoRHsP4FarABuj8M8OA=; b=Rboo8jLMoT4WUA0Y2ZyknTblUDiCUfq4DBmO+Y0cBUp/HViQcpRHIkGraWxqeKfPoLD1Ospd7zq2n+mouOLFJrQS5PqllK7U/Iz28H/ewWMaV0b0mGxxkp0Lbt9f+u+sWQvndYOPEiYrZQLVwNieZo43AkKWAAf8+a95A9KmGRc= 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 1788207944195212.16256725806534; Mon, 31 Aug 2026 13:25:44 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Yc-0008Dp-09; Mon, 31 Aug 2026 16:24:42 -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 1x18Ya-000823-7c for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:40 -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 1x18YY-0008OQ-5s for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:39 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-113-oZbFfP_-PC-tN--Gv2Rq1Q-1; Mon, 31 Aug 2026 16:24:31 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 277AE184A08C; Mon, 31 Aug 2026 20:24:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 818D11800577; Mon, 31 Aug 2026 20:24:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207877; 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=Z3E4l/9ZBojjapKTPoc2rkBnvoRHsP4FarABuj8M8OA=; b=HpU9GQQBhlg/zeyqZx/DyfSrSRW3qyePy4MR9Nn1jfsbDC1vXO/h/aSWd1FTSOVP1Z1aSb yPOvVEg9Jl0sTJt+hw2arq4mIa0Pbp2nRcDYVYlgGS1ylaDKpKywYWJYgvxQvA7V5tlaQK BnQBm6mB+kYBvpul48dcGxlv3dQ92oE= X-MC-Unique: oZbFfP_-PC-tN--Gv2Rq1Q-1 X-Mimecast-MFC-AGG-ID: oZbFfP_-PC-tN--Gv2Rq1Q_1788207869 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 30/43] qapi: convert trivial intro sections for audio.json Date: Mon, 31 Aug 2026 16:19:32 -0400 Message-ID: <20260831201945.287730-31-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207945330158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/audio.json | 88 ++++++++++++++++++------------------------------- 1 file changed, 32 insertions(+), 56 deletions(-) diff --git a/qapi/audio.json b/qapi/audio.json index 2df87b97101..72190f20993 100644 --- a/qapi/audio.json +++ b/qapi/audio.json @@ -14,9 +14,8 @@ =20 ## # @AudiodevPerDirectionOptions: -# -# General audio backend options that are used for both playback and -# recording. +# General audio backend options that are used for both playback +# and recording. # # @mixing-engine: use QEMU's mixing engine to mix all streams inside # QEMU and convert audio formats when not supported by the @@ -53,8 +52,7 @@ =20 ## # @AudiodevGenericOptions: -# -# Generic driver-specific options. +# Generic driver-specific options. # # @in: options of the capture stream # @@ -69,8 +67,7 @@ =20 ## # @AudiodevDBusOptions: -# -# Options of the D-Bus audio backend. +# Options of the D-Bus audio backend. # # @in: options of the capture stream # @@ -89,9 +86,8 @@ =20 ## # @AudiodevAlsaPerDirectionOptions: -# -# Options of the ALSA backend that are used for both playback and -# recording. +# Options of the ALSA backend that are used for both playback and +# recording. # # @dev: the name of the ALSA device to use (default 'default') # @@ -111,8 +107,7 @@ =20 ## # @AudiodevAlsaOptions: -# -# Options of the ALSA audio backend. +# Options of the ALSA audio backend. # # @in: options of the capture stream # @@ -130,8 +125,7 @@ =20 ## # @AudiodevSndioOptions: -# -# Options of the sndio audio backend. +# Options of the sndio audio backend. # # @in: options of the capture stream # @@ -152,9 +146,8 @@ =20 ## # @AudiodevCoreaudioPerDirectionOptions: -# -# Options of the Core Audio backend that are used for both playback -# and recording. +# Options of the Core Audio backend that are used for both +# playback and recording. # # @buffer-count: number of buffers # @@ -167,8 +160,7 @@ =20 ## # @AudiodevCoreaudioOptions: -# -# Options of the coreaudio audio backend. +# Options of the coreaudio audio backend. # # @in: options of the capture stream # @@ -183,8 +175,7 @@ =20 ## # @AudiodevDsoundOptions: -# -# Options of the DirectSound audio backend. +# Options of the DirectSound audio backend. # # @in: options of the capture stream # @@ -203,9 +194,8 @@ =20 ## # @AudiodevJackPerDirectionOptions: -# -# Options of the JACK backend that are used for both playback and -# recording. +# Options of the JACK backend that are used for both playback and +# recording. # # @server-name: select from among several possible concurrent server # instances (default: environment variable $JACK_DEFAULT_SERVER if @@ -237,8 +227,7 @@ =20 ## # @AudiodevJackOptions: -# -# Options of the JACK audio backend. +# Options of the JACK audio backend. # # @in: options of the capture stream # @@ -253,9 +242,8 @@ =20 ## # @AudiodevOssPerDirectionOptions: -# -# Options of the OSS backend that are used for both playback and -# recording. +# Options of the OSS backend that are used for both playback and +# recording. # # @dev: file name of the OSS device (default '/dev/dsp') # @@ -275,8 +263,7 @@ =20 ## # @AudiodevOssOptions: -# -# Options of the OSS audio backend. +# Options of the OSS audio backend. # # @in: options of the capture stream # @@ -305,9 +292,8 @@ =20 ## # @AudiodevPaPerDirectionOptions: -# -# Options of the Pulseaudio backend that are used for both playback -# and recording. +# Options of the Pulseaudio backend that are used for both +# playback and recording. # # @name: name of the sink/source to use # @@ -330,8 +316,7 @@ =20 ## # @AudiodevPaOptions: -# -# Options of the PulseAudio audio backend. +# Options of the PulseAudio audio backend. # # @in: options of the capture stream # @@ -349,9 +334,8 @@ =20 ## # @AudiodevPipewirePerDirectionOptions: -# -# Options of the PipeWire backend that are used for both playback and -# recording. +# Options of the PipeWire backend that are used for both playback +# and recording. # # @name: name of the sink/source to use # @@ -374,8 +358,7 @@ =20 ## # @AudiodevPipewireOptions: -# -# Options of the PipeWire audio backend. +# Options of the PipeWire audio backend. # # @in: options of the capture stream # @@ -390,9 +373,8 @@ =20 ## # @AudiodevSdlPerDirectionOptions: -# -# Options of the SDL audio backend that are used for both playback and -# recording. +# Options of the SDL audio backend that are used for both playback +# and recording. # # @buffer-count: number of buffers (default 4) # @@ -405,8 +387,7 @@ =20 ## # @AudiodevSdlOptions: -# -# Options of the SDL audio backend. +# Options of the SDL audio backend. # # @in: options of the recording stream # @@ -421,8 +402,7 @@ =20 ## # @AudiodevWavOptions: -# -# Options of the wav audio backend. +# Options of the wav audio backend. # # @in: options of the capture stream # @@ -440,8 +420,7 @@ =20 ## # @AudioFormat: -# -# An enumeration of possible audio formats. +# An enumeration of possible audio formats. # # @u8: unsigned 8 bit integer # @@ -464,8 +443,7 @@ =20 ## # @AudiodevDriver: -# -# An enumeration of possible audio backend drivers. +# An enumeration of possible audio backend drivers. # # @jack: JACK audio backend (since 5.1) # @@ -488,8 +466,7 @@ =20 ## # @Audiodev: -# -# Options of an audio backend. +# Options of an audio backend. # # @id: identifier of the backend # @@ -534,8 +511,7 @@ =20 ## # @query-audiodevs: -# -# Return information about audiodev configuration +# Return information about audiodev configuration # # Since: 8.0 ## --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207898; cv=none; d=zohomail.com; s=zohoarc; b=cMWfVRG+Nj6AgHy0REw/SoYv3tNlJ5YXjmaMMQ0z+sAsGhoTyupW9nujxa1e9vQi8K45hwCyB8V1BEAF5SBL6ybaLA7toGXImBBB0feW3YQnyNXrKxuwI+PMwcmvNx3lHCBkkdOQQeW8V80Wu4ynJLQYR9Gg69NEC+aAYjaJvx8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207898; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ZBjfSrh5PfkhhEWxcRNzfkVdUgV/WtbECn/x1oGAF6I=; b=FHLZQXmCOqfu4gZrubt2nWaUKrqOzFotvmih4EypFQnulDx0Mi1DeZO2O2sA6hosUPAPZ2EPgFkkh6KSAZOmofKdLc7ruSxVy/yWsqAWXPZY4xMScidp28fIS+1t3YX6p5KEUz0nJsAkcwVND0+sC2Yy24ia7sRTV1e/g045Vnc= 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 1788207898425883.1878100401176; Mon, 31 Aug 2026 13:24:58 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Yi-0000wV-L9; Mon, 31 Aug 2026 16:24:48 -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 1x18Yh-0000ih-FW for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:47 -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 1x18Yf-0008Qv-Jx for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:47 -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-460-f-JqxZ-2NoeIBG-X0cV6gg-1; Mon, 31 Aug 2026 16:24:39 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EA845191FCE9; Mon, 31 Aug 2026 20:24:35 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5D7681800347; Mon, 31 Aug 2026 20:24:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207884; 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=ZBjfSrh5PfkhhEWxcRNzfkVdUgV/WtbECn/x1oGAF6I=; b=S2sDUFMJhIVBt2+jYPCXIqSSXJWqPg98bI3fA248GQSuepO3QLTLl+4rZvZLOt+GMlJOeL xVke20/iu20TmBjC2oB4ETj5Ss5pdpQsdXozZnA9AixUIY7zDVfWSnGYlVV9PT8YQ0ExdC 2c61HnO+5+4zwkgqAWlTAVVee5JQals= X-MC-Unique: f-JqxZ-2NoeIBG-X0cV6gg-1 X-Mimecast-MFC-AGG-ID: f-JqxZ-2NoeIBG-X0cV6gg_1788207876 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 31/43] qapi: convert trivial intro sections for block.json Date: Mon, 31 Aug 2026 16:19:33 -0400 Message-ID: <20260831201945.287730-32-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207898905158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block.json | 41 +++++++++++++++++------------------------ 1 file changed, 17 insertions(+), 24 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 46955bbb3e3..189f2e28204 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -50,8 +50,8 @@ =20 ## # @FloppyDriveType: -# -# Type of floppy drive to be emulated by the Floppy Disk Controller. +# Type of floppy drive to be emulated by the +# Floppy Disk Controller. # # @144: 1.44MB 3.5" drive # @@ -70,8 +70,7 @@ =20 ## # @PRManagerInfo: -# -# Information about a persistent reservation manager +# Information about a persistent reservation manager # # @id: the identifier of the persistent reservation manager # @@ -85,9 +84,8 @@ =20 ## # @query-pr-managers: -# -# Return a list of information about each persistent reservation -# manager. +# Return a list of information about each persistent reservation +# manager. # # Returns: a list of manager info for each persistent reservation # manager @@ -99,8 +97,7 @@ =20 ## # @eject: -# -# Ejects the medium from a removable drive. +# Ejects the medium from a removable drive. # # @device: Block device name # @@ -297,9 +294,8 @@ =20 ## # @BlockdevChangeReadOnlyMode: -# -# Specifies the new read-only mode of a block device subject to the -# `blockdev-change-medium` command. +# Specifies the new read-only mode of a block device subject to +# the `blockdev-change-medium` command. # # @retain: Retains the current read-only mode # @@ -314,12 +310,11 @@ =20 ## # @blockdev-change-medium: -# -# Changes the medium inserted into a block device by ejecting the -# current medium and loading a new image file which is inserted as the -# new medium (this command combines `blockdev-open-tray`, -# `blockdev-remove-medium`, `blockdev-insert-medium` and -# `blockdev-close-tray`). +# Changes the medium inserted into a block device by ejecting the +# current medium and loading a new image file which is inserted as +# the new medium (this command combines `blockdev-open-tray`, +# `blockdev-remove-medium`, `blockdev-insert-medium` and +# `blockdev-close-tray`). # # @device: Block device name # @@ -385,9 +380,8 @@ =20 ## # @DEVICE_TRAY_MOVED: -# -# Emitted whenever the tray of a removable device is moved by the -# guest or by HMP/QMP commands +# Emitted whenever the tray of a removable device is moved by the +# guest or by HMP/QMP commands # # @device: Block device name. This is always present for # compatibility reasons, but it can be empty ("") if the image @@ -414,9 +408,8 @@ =20 ## # @PR_MANAGER_STATUS_CHANGED: -# -# Emitted whenever the connected status of a persistent reservation -# manager changes. +# Emitted whenever the connected status of a persistent +# reservation manager changes. # # @id: The id of the PR manager object # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207937; cv=none; d=zohomail.com; s=zohoarc; b=VAscVvrUOqw2IleKcgDGhbe66sTu+1CbsonZMF8xC50qnl3HRq8PuoNuQFrbw4Zy3oIfYhzkuVVBD6idZYBTqIUkqQ3RgkOnpNx6AvXfRgjDoXzlAv7gQIQuUfhhkNrJXWu9Q8s4sf5HGdOR6zW3SWkKFtPQXE1PcvrJNhr2Djw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207937; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Y8pqXrIvr/yRTQ3rsO16r+lqlJjBRU1uvUFq6p7chi8=; b=UCEUSO1GdDGIFeNF/Y9Ul8b/PTNK4+qJu2Yy0fA8DOZRgCfNzS41WRQFWJzoIV+opx8uSnHMqApiIh1xbvbNST5HOrB7IXkAd+k4Mj0NIWr8RXGLbry0vg4ACafb9oIMX+3hAqU48H1VdyOwKMeEW0F0WYIMhh7YCr7XCaH3MGg= 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 1788207937138462.71836235326145; Mon, 31 Aug 2026 13:25:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Yn-0001kG-6n; Mon, 31 Aug 2026 16:24:53 -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 1x18Yl-0001Ti-Kh for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:51 -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 1x18Yj-0008Sn-HG for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:24:51 -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-685-VgiO1ekmMsm3UUxhDdvEcg-1; Mon, 31 Aug 2026 16:24:47 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4E1A61843AD9; Mon, 31 Aug 2026 20:24:44 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 2D9041800577; Mon, 31 Aug 2026 20:24:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207888; 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=Y8pqXrIvr/yRTQ3rsO16r+lqlJjBRU1uvUFq6p7chi8=; b=hgNIxOFxZraSOsYVZ5+Eh2/BNjdZ+ZDoAZFLt5ulex+K1LENRxjE6MIcR/IH2SooqTSUah tkYvQGTPNPGJPlsnOV571bqdjP9+lhu+EH3SV8B4AMnGjfZ+++xtcRn9+N3tuhQOtJEFoK qbzr2vvw4O9BLcEpt4m7GW9zX0pijiA= X-MC-Unique: VgiO1ekmMsm3UUxhDdvEcg-1 X-Mimecast-MFC-AGG-ID: VgiO1ekmMsm3UUxhDdvEcg_1788207884 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 32/43] qapi: convert trivial intro sections for misc.json Date: Mon, 31 Aug 2026 16:19:34 -0400 Message-ID: <20260831201945.287730-33-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207939296154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/misc.json | 74 ++++++++++++++++++-------------------------------- 1 file changed, 27 insertions(+), 47 deletions(-) diff --git a/qapi/misc.json b/qapi/misc.json index 22b7afed9f6..b3c2a1421f3 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -44,8 +44,7 @@ =20 ## # @NameInfo: -# -# Guest name information. +# Guest name information. # # @name: The name of the guest # @@ -55,8 +54,7 @@ =20 ## # @query-name: -# -# Return the name information of a guest. +# Return the name information of a guest. # # Since: 0.14 # @@ -69,8 +67,7 @@ =20 ## # @IOThreadInfo: -# -# Information about an iothread +# Information about an iothread # # @id: the identifier of the iothread # @@ -137,8 +134,7 @@ =20 ## # @stop: -# -# Stop guest VM execution. +# Stop guest VM execution. # # Since: 0.14 # @@ -159,8 +155,7 @@ =20 ## # @cont: -# -# Resume guest VM execution. +# Resume guest VM execution. # # Since: 0.14 # @@ -208,8 +203,7 @@ =20 ## # @human-monitor-command: -# -# Execute a command on the human monitor and return the output. +# Execute a command on the human monitor and return the output. # # @command-line: the command to execute in the human monitor # @@ -251,8 +245,7 @@ =20 ## # @getfd: -# -# Receive a file descriptor via SCM rights and assign it a name +# Receive a file descriptor via SCM rights and assign it a name # # @fdname: file descriptor name # @@ -273,11 +266,10 @@ =20 ## # @get-win32-socket: -# -# Add a socket that was duplicated to QEMU process with -# WSADuplicateSocketW() via WSASocket() & WSAPROTOCOL_INFOW structure -# and assign it a name (the SOCKET is associated with a CRT file -# descriptor) +# Add a socket that was duplicated to QEMU process with +# WSADuplicateSocketW() via WSASocket() & WSAPROTOCOL_INFOW +# structure and assign it a name (the SOCKET is associated with a +# CRT file descriptor) # # @info: the WSAPROTOCOL_INFOW structure (encoded in base64) # @@ -301,8 +293,7 @@ =20 ## # @closefd: -# -# Close a file descriptor previously passed via SCM rights +# Close a file descriptor previously passed via SCM rights # # @fdname: file descriptor name # @@ -317,8 +308,7 @@ =20 ## # @AddfdInfo: -# -# Information about a file descriptor that was added to an fd set. +# Information about a file descriptor that was added to an fd set. # # @fdset-id: The ID of the fd set that @fd was added to. # @@ -331,8 +321,8 @@ =20 ## # @add-fd: -# -# Add a file descriptor, that was passed via SCM rights, to an fd set. +# Add a file descriptor, that was passed via SCM rights, to an fd +# set. # # @fdset-id: The ID of the fd set to add the file descriptor to. # @@ -361,8 +351,7 @@ =20 ## # @remove-fd: -# -# Remove a file descriptor from an fd set. +# Remove a file descriptor from an fd set. # # @fdset-id: The ID of the fd set that the file descriptor belongs to. # @@ -387,8 +376,7 @@ =20 ## # @FdsetFdInfo: -# -# Information about a file descriptor that belongs to an fd set. +# Information about a file descriptor that belongs to an fd set. # # @fd: The file descriptor value. # @@ -401,8 +389,7 @@ =20 ## # @FdsetInfo: -# -# Information about an fd set. +# Information about an fd set. # # @fdset-id: The ID of the fd set. # @@ -415,8 +402,7 @@ =20 ## # @query-fdsets: -# -# Return information describing all fd sets. +# Return information describing all fd sets. # # Since: 1.2 # @@ -457,8 +443,7 @@ =20 ## # @CommandLineParameterType: -# -# Possible types for an option parameter. +# Possible types for an option parameter. # # @string: accepts a character string # @@ -476,8 +461,7 @@ =20 ## # @CommandLineParameterInfo: -# -# Details about a single parameter of a command line option. +# Details about a single parameter of a command line option. # # @name: parameter name # @@ -497,9 +481,8 @@ =20 ## # @CommandLineOptionInfo: -# -# Details about a command line option, including its list of parameter -# details +# Details about a command line option, including its list of +# parameter details # # @option: option name # @@ -512,8 +495,7 @@ =20 ## # @query-command-line-options: -# -# Query command line option schema. +# Query command line option schema. # # @option: option name # @@ -552,8 +534,7 @@ =20 ## # @RTC_CHANGE: -# -# Emitted when the guest changes the RTC time. +# Emitted when the guest changes the RTC time. # # @offset: offset in seconds between base RTC clock (as specified by # -rtc base), and new RTC clock value @@ -577,9 +558,8 @@ =20 ## # @VFU_CLIENT_HANGUP: -# -# Emitted when the client of a TYPE_VFIO_USER_SERVER closes the -# communication channel +# Emitted when the client of a TYPE_VFIO_USER_SERVER closes the +# communication channel # # @vfu-id: ID of the TYPE_VFIO_USER_SERVER object. It is the last # component of @vfu-qom-path referenced below --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788208024; cv=none; d=zohomail.com; s=zohoarc; b=hE+UWDtptQd03jcg1PHJSKqHyRAnBEUUl2P2/jcZQo8uSQLd1oJiG4E1gayxXoLOc+plXZkFFTKPwkr/NLwaJdpABEsndSoik2xEihIUv7fMuCSUEhNgKtepGHM/i10UZHAk5FPD5OTWD/0YZBkRToIHp/rKHWd8iy15J13fM0c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788208024; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=UCP7UVj7lY6yPKsok5GRRYDTHAJpEfy9IihCRm+r6Qo=; b=M4tROjzclSJKL62juA+DHkrHZVc25heklQPBhC88X1f2SPXY5K8sGvpCtBmMVE+Kpm2wNMLXFyhpSwEDvP46fSYtdmp2qyMRtbJgdn/Ha5I5UOIY6QWauMnBXOcR2s4s/oszzYEEcd/5P6TSSQWW/u+PNfgrgMaIV/M2wxDSG20= 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 1788208024685943.1356025642395; Mon, 31 Aug 2026 13:27:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Yw-0002M1-JV; Mon, 31 Aug 2026 16:25:02 -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 1x18Yu-0002GT-Km for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25: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 1x18Ys-0008WJ-P2 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:00 -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-692-RVxOMb3bPMe3ej89Z94FQg-1; Mon, 31 Aug 2026 16:24:54 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AC9C7191FCCC; Mon, 31 Aug 2026 20:24:51 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 8290B1800347; Mon, 31 Aug 2026 20:24:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207898; 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=UCP7UVj7lY6yPKsok5GRRYDTHAJpEfy9IihCRm+r6Qo=; b=Vbef/zPispNDYJdMb6MYFWnZD7LA1fqv03e3xChXtx2kYgrAffMv2lMaiyzdJcd3k2lIQo 9lW7amw7cqqNqpPSbN13N7AiTQBTnjW73NCKnxyh8/SygNkR8oVEDLgfL1CCD3no5TOFBb amqOd0tjtYNCUYUpsA/U3amKvjBzxVA= X-MC-Unique: RVxOMb3bPMe3ej89Z94FQg-1 X-Mimecast-MFC-AGG-ID: RVxOMb3bPMe3ej89Z94FQg_1788207891 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 33/43] qapi: convert trivial intro sections for crypto.json Date: Mon, 31 Aug 2026 16:19:35 -0400 Message-ID: <20260831201945.287730-34-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788208026608154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/crypto.json | 100 +++++++++++++++++------------------------------ 1 file changed, 36 insertions(+), 64 deletions(-) diff --git a/qapi/crypto.json b/qapi/crypto.json index 6e3a98ff68b..5e395bc10c7 100644 --- a/qapi/crypto.json +++ b/qapi/crypto.json @@ -26,8 +26,7 @@ =20 ## # @QCryptoSecretFormat: -# -# The data format that the secret is provided in +# The data format that the secret is provided in # # @raw: raw bytes. When encoded in JSON only valid UTF-8 sequences # can be used @@ -41,8 +40,7 @@ =20 ## # @QCryptoHashAlgo: -# -# The supported algorithms for computing content digests +# The supported algorithms for computing content digests # # @md5: MD5. Should not be used in any new code, legacy compat only # @@ -68,8 +66,7 @@ =20 ## # @QCryptoCipherAlgo: -# -# The supported algorithms for content encryption ciphers +# The supported algorithms for content encryption ciphers # # @aes-128: AES with 128 bit / 16 byte keys # @@ -110,8 +107,7 @@ =20 ## # @QCryptoCipherMode: -# -# The supported modes for content encryption ciphers +# The supported modes for content encryption ciphers # # @ecb: Electronic Code Book # @@ -150,8 +146,7 @@ =20 ## # @QCryptoBlockFormat: -# -# The supported full disk encryption formats +# The supported full disk encryption formats # # @qcow: QCow/QCow2 built-in AES-CBC encryption. Use only for # liberating data from old images. @@ -165,8 +160,8 @@ =20 ## # @QCryptoBlockOptionsBase: -# -# The common options that apply to all full disk encryption formats +# The common options that apply to all full disk encryption +# formats # # @format: the encryption format # @@ -177,8 +172,7 @@ =20 ## # @QCryptoBlockOptionsQCow: -# -# The options that apply to QCow/QCow2 AES-CBC encryption format +# The options that apply to QCow/QCow2 AES-CBC encryption format # # @key-secret: the ID of a QCryptoSecret object providing the # decryption key. Mandatory except when probing image for @@ -191,8 +185,7 @@ =20 ## # @QCryptoBlockOptionsLUKS: -# -# The options that apply to LUKS encryption format +# The options that apply to LUKS encryption format # # @key-secret: the ID of a QCryptoSecret object providing the # decryption key. Mandatory except when probing image for @@ -205,8 +198,7 @@ =20 ## # @QCryptoBlockCreateOptionsLUKS: -# -# The options that apply to LUKS encryption format initialization +# The options that apply to LUKS encryption format initialization # # @cipher-alg: the cipher algorithm for data encryption. Currently # defaults to 'aes-256'. @@ -239,9 +231,8 @@ =20 ## # @QCryptoBlockOpenOptions: -# -# The options that are available for all encryption formats when -# opening an existing volume +# The options that are available for all encryption formats when +# opening an existing volume # # Since: 2.6 ## @@ -253,9 +244,8 @@ =20 ## # @QCryptoBlockCreateOptions: -# -# The options that are available for all encryption formats when -# initializing a new volume +# The options that are available for all encryption formats when +# initializing a new volume # # Since: 2.6 ## @@ -267,9 +257,8 @@ =20 ## # @QCryptoBlockInfoBase: -# -# The common information that applies to all full disk encryption -# formats +# The common information that applies to all full disk encryption +# formats # # @format: the encryption format # @@ -280,8 +269,7 @@ =20 ## # @QCryptoBlockInfoLUKSSlot: -# -# Information about the LUKS block encryption key slot options +# Information about the LUKS block encryption key slot options # # @active: whether the key slot is currently in use # @@ -301,8 +289,7 @@ =20 ## # @QCryptoBlockInfoLUKS: -# -# Information about the LUKS block encryption options +# Information about the LUKS block encryption options # # @cipher-alg: the cipher algorithm for data encryption # @@ -340,8 +327,7 @@ =20 ## # @QCryptoBlockInfo: -# -# Information about the block encryption options +# Information about the block encryption options # # Since: 2.7 ## @@ -352,8 +338,7 @@ =20 ## # @QCryptoBlockLUKSKeyslotState: -# -# Defines state of keyslots that are affected by the update +# Defines state of keyslots that are affected by the update # # @active: The slots contain the given password and marked as active # @@ -367,9 +352,8 @@ =20 ## # @QCryptoBlockAmendOptionsLUKS: -# -# This struct defines the update parameters that activate/de-activate -# set of keyslots +# This struct defines the update parameters that +# activate/de-activate set of keyslots # # @state: the desired state of the keyslots # @@ -409,9 +393,8 @@ =20 ## # @QCryptoBlockAmendOptions: -# -# The options that are available for all encryption formats when -# amending encryption settings +# The options that are available for all encryption formats when +# amending encryption settings # # Since: 5.1 ## @@ -423,8 +406,7 @@ =20 ## # @SecretCommonProperties: -# -# Properties for objects of classes derived from secret-common. +# Properties for objects of classes derived from secret-common. # # @format: the data format that the secret is provided in # (default: raw) @@ -465,8 +447,7 @@ =20 ## # @SecretKeyringProperties: -# -# Properties for secret_keyring objects. +# Properties for secret_keyring objects. # # @serial: serial number that identifies a key to get from the kernel # @@ -479,8 +460,7 @@ =20 ## # @TlsCredsProperties: -# -# Properties for objects of classes derived from tls-creds. +# Properties for objects of classes derived from tls-creds. # # @verify-peer: if true the peer credentials will be verified once the # handshake is completed. This is a no-op for anonymous @@ -505,8 +485,7 @@ =20 ## # @TlsCredsAnonProperties: -# -# Properties for tls-creds-anon objects. +# Properties for tls-creds-anon objects. # # Since: 2.5 ## @@ -516,8 +495,7 @@ =20 ## # @TlsCredsPskProperties: -# -# Properties for tls-creds-psk objects. +# Properties for tls-creds-psk objects. # # @username: the username which will be sent to the server. For # clients only. If absent, "qemu" is sent and the property will @@ -531,8 +509,7 @@ =20 ## # @TlsCredsX509Properties: -# -# Properties for tls-creds-x509 objects. +# Properties for tls-creds-x509 objects. # # @sanity-check: if true, perform some sanity checks before using the # credentials (default: true) @@ -552,8 +529,7 @@ =20 ## # @QCryptoAkCipherAlgo: -# -# The supported algorithms for asymmetric encryption ciphers +# The supported algorithms for asymmetric encryption ciphers # # @rsa: RSA algorithm # @@ -564,8 +540,7 @@ =20 ## # @QCryptoAkCipherKeyType: -# -# The type of asymmetric keys. +# The type of asymmetric keys. # # @public: public key # @@ -578,8 +553,7 @@ =20 ## # @QCryptoRSAPaddingAlgo: -# -# The padding algorithm for RSA. +# The padding algorithm for RSA. # # @raw: no padding used # @@ -592,8 +566,7 @@ =20 ## # @QCryptoAkCipherOptionsRSA: -# -# Specific parameters for RSA algorithm. +# Specific parameters for RSA algorithm. # # @hash-alg: `QCryptoHashAlgo` # @@ -607,9 +580,8 @@ =20 ## # @QCryptoAkCipherOptions: -# -# The options that are available for all asymmetric key algorithms -# when creating a new QCryptoAkCipher. +# The options that are available for all asymmetric key algorithms +# when creating a new QCryptoAkCipher. # # @alg: encryption cipher algorithm # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788208003; cv=none; d=zohomail.com; s=zohoarc; b=dfLnHWuM3U4BUqWAVqRr3mpkP4DhFSSAP5OEHbU+mDnBzylRY9rpJyFY6g6BlDcsM/1HB1+AbOAArLvc6/PzCj5Ld6DZpSFWPUE+JmcLJYQAZrBj/An5RhBTB1/adCh5Az5vTkf55yasIqjTNOyrH+2M4pOmbJXJwOszNQGIu5g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788208003; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ld5g/j6L0lxSwaRZjY3pcA3TM2VpEohq25svIVL3ldM=; b=CwPlHPfkL3Jn6Fu0V9iz+/NSKP1b8WVe5/ioUzvP00vG9H9MnZgusKQ8N+jGFD9cTruIEv2LgH9RpbhuShjQBHbiM+ZTMdH9LiJoLZSZNHBHjFJMfUtwTkkzEsCvIbxXwkFVazLoz7kqMEFezg1Pd5xWsG+4G0ZvxkoUbyPbG4c= 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 1788208003855859.2272270641047; Mon, 31 Aug 2026 13:26:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18ZE-00032d-J3; Mon, 31 Aug 2026 16:25: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 1x18Z2-0002TU-FQ for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:10 -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 1x18Z0-000075-QH for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:07 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-471-p1RpSxUbM7urPmhdWjBNnQ-1; Mon, 31 Aug 2026 16:25:01 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 422B9184A090; Mon, 31 Aug 2026 20:24:58 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EBF4B1800577; Mon, 31 Aug 2026 20:24:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207904; 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=ld5g/j6L0lxSwaRZjY3pcA3TM2VpEohq25svIVL3ldM=; b=I4trDYXob9QYT7JF2PB7CfgNhXHBUjZc+NAHLx9l6ysDaViEdJ00KUKOzrhW9pIAzLZnm+ QecSf/bG7TOhAevv+7uXC9umS01HkGH40ZSl8rnA9JJgmhyCG03eytk3GjtN/Q0sA6k2n/ fYaFLMb+0vlc2XEDwSxbLlycFHMn06E= X-MC-Unique: p1RpSxUbM7urPmhdWjBNnQ-1 X-Mimecast-MFC-AGG-ID: p1RpSxUbM7urPmhdWjBNnQ_1788207898 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 34/43] qapi: convert trivial intro sections for cxl.json Date: Mon, 31 Aug 2026 16:19:36 -0400 Message-ID: <20260831201945.287730-35-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788208006093154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/cxl.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/qapi/cxl.json b/qapi/cxl.json index 81d6198ba03..aef849a4c2a 100644 --- a/qapi/cxl.json +++ b/qapi/cxl.json @@ -365,8 +365,7 @@ =20 ## # @CXLUncorErrorRecord: -# -# Record of a single error including header log. +# Record of a single error including header log. # # @type: Type of error # @@ -399,8 +398,7 @@ =20 ## # @CxlCorErrorType: -# -# Type of CXL correctable error to inject +# Type of CXL correctable error to inject # # @cache-data-ecc: Data ECC error on CXL.cache # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207979; cv=none; d=zohomail.com; s=zohoarc; b=RAoBfm9NSn08rmWdnuB3hTcwYMomiF1dmUga1E0ieAgK4HiibYI8r3Wndn4/BAtxCENlxnJj84KBxzSa0ahfkBZHadD9vddBphlUvWcjLEYdc/sYt6oW9Xwq/fPcNQg6R0FMZWhOD1w9MLWUfSpp4eoh4ClgG9sySndSZCnbWdE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207979; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=xv5Hc3Epjp7PUpL8zcU32FN49lioPMZa3oxVmw1Jn+I=; b=b1DeE8XPPtTN+D0+x9nOIDAzvJsybEeW3+Dv+miGhgbYM8N5f1vVlFFWqImEC5fpQyyh/W5+AwSiG/igib1ItEfUfxTswjTkzQ7hceB8+aKsOjcAMl9gL1ikbff9l1qnwTLKHA4Q+Rt/fuVC0qhltW4G9OgChPGR/1crli/uEiY= 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 1788207979528926.1788156136826; Mon, 31 Aug 2026 13:26:19 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18ZE-00031V-FM; Mon, 31 Aug 2026 16:25: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 1x18ZA-0002j3-8l for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:18 -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 1x18Z7-0000A6-NU for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:15 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-558-UL8-StDYOTihKjq8V3Pgeg-1; Mon, 31 Aug 2026 16:25:08 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 653E5184A082; Mon, 31 Aug 2026 20:25:05 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id B180B1800577; Mon, 31 Aug 2026 20:24:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207913; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=xv5Hc3Epjp7PUpL8zcU32FN49lioPMZa3oxVmw1Jn+I=; b=B9TOkmMBW8rmgTb7YK9aZZNp5Nu6C5wvzTp3Eu/SDeSk7vZj7shI/RlhLTRE59hCXPpPLI jbHs9Peh9PVD88I4qSjDCpQ8Og8wX/wjCRU7t6AYgF9wjAQ44UdOVpyJr1EQDvIIckgHdn 412IT9NoLp3P/iRSV0v4MwsJIH3lPMw= X-MC-Unique: UL8-StDYOTihKjq8V3Pgeg-1 X-Mimecast-MFC-AGG-ID: UL8-StDYOTihKjq8V3Pgeg_1788207905 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 35/43] qapi: convert trivial intro sections for run-state.json Date: Mon, 31 Aug 2026 16:19:37 -0400 Message-ID: <20260831201945.287730-36-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207981882154100 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/run-state.json | 113 ++++++++++++++++---------------------------- 1 file changed, 42 insertions(+), 71 deletions(-) diff --git a/qapi/run-state.json b/qapi/run-state.json index e4fdead1e0b..2a968a6bc0b 100644 --- a/qapi/run-state.json +++ b/qapi/run-state.json @@ -10,8 +10,7 @@ =20 ## # @RunState: -# -# An enumeration of VM run states. +# An enumeration of VM run states. # # @debug: QEMU is running on a debugger # @@ -63,8 +62,7 @@ =20 ## # @ShutdownCause: -# -# An enumeration of reasons for a shutdown. +# An enumeration of reasons for a shutdown. # # @none: No shutdown request pending # @@ -103,8 +101,7 @@ =20 ## # @StatusInfo: -# -# Information about VM run state +# Information about VM run state # # @running: true if all VCPUs are runnable, false if not runnable # @@ -118,8 +115,7 @@ =20 ## # @query-status: -# -# Query the run status of the VM +# Query the run status of the VM # # Since: 0.14 # @@ -134,9 +130,8 @@ =20 ## # @SHUTDOWN: -# -# Emitted when the virtual machine has shut down, indicating that QEMU -# is about to exit. +# Emitted when the virtual machine has shut down, indicating that +# QEMU is about to exit. # # @guest: If true, the shutdown was triggered by a guest request (such # as a guest-initiated ACPI shutdown request or other @@ -162,9 +157,8 @@ =20 ## # @POWERDOWN: -# -# Emitted when the virtual machine is powered down through the power -# control system, such as via ACPI. +# Emitted when the virtual machine is powered down through the +# power control system, such as via ACPI. # # Since: 0.12 # @@ -177,8 +171,7 @@ =20 ## # @RESET: -# -# Emitted when the virtual machine is reset +# Emitted when the virtual machine is reset # # @guest: If true, the reset was triggered by a guest request (such as # a guest-initiated ACPI reboot request or other hardware-specific @@ -199,8 +192,7 @@ =20 ## # @STOP: -# -# Emitted when the virtual machine is stopped +# Emitted when the virtual machine is stopped # # Since: 0.12 # @@ -213,8 +205,7 @@ =20 ## # @RESUME: -# -# Emitted when the virtual machine resumes execution +# Emitted when the virtual machine resumes execution # # Since: 0.12 # @@ -227,9 +218,8 @@ =20 ## # @SUSPEND: -# -# Emitted when guest enters a hardware suspension state, for example, -# S3 state, which is sometimes called standby state +# Emitted when guest enters a hardware suspension state, for +# example, S3 state, which is sometimes called standby state # # Since: 1.1 # @@ -261,9 +251,8 @@ =20 ## # @WAKEUP: -# -# Emitted when the guest has woken up from suspend state and is -# running +# Emitted when the guest has woken up from suspend state and is +# running # # Since: 1.1 # @@ -276,8 +265,7 @@ =20 ## # @WATCHDOG: -# -# Emitted when the watchdog device's timer is expired +# Emitted when the watchdog device's timer is expired # # @action: action that has been taken # @@ -300,9 +288,8 @@ =20 ## # @WatchdogAction: -# -# An enumeration of the actions taken when the watchdog device's timer -# is expired +# An enumeration of the actions taken when the watchdog device's +# timer is expired # # @reset: system resets # @@ -330,8 +317,7 @@ =20 ## # @RebootAction: -# -# Possible QEMU actions upon guest reboot +# Possible QEMU actions upon guest reboot # # @reset: Reset the VM # @@ -345,8 +331,7 @@ =20 ## # @ShutdownAction: -# -# Possible QEMU actions upon guest shutdown +# Possible QEMU actions upon guest shutdown # # @poweroff: Shutdown the VM and exit # @@ -377,8 +362,7 @@ =20 ## # @watchdog-set-action: -# -# Set watchdog action. +# Set watchdog action. # # @action: `WatchdogAction` action taken when watchdog timer expires. # @@ -394,9 +378,8 @@ =20 ## # @set-action: -# -# Set the actions that will be taken by the emulator in response to -# guest events. +# Set the actions that will be taken by the emulator in response +# to guest events. # # @reboot: `RebootAction` action taken on guest reboot. # @@ -427,8 +410,7 @@ =20 ## # @GUEST_PANICKED: -# -# Emitted when guest OS panic is detected +# Emitted when guest OS panic is detected # # @action: action that has been taken, currently always "pause" # @@ -447,8 +429,7 @@ =20 ## # @GUEST_CRASHLOADED: -# -# Emitted when guest OS crash loaded is detected +# Emitted when guest OS crash loaded is detected # # @action: action that has been taken, currently always "run" # @@ -467,8 +448,8 @@ =20 ## # @GUEST_PVSHUTDOWN: -# -# Emitted when guest submits a shutdown request via pvpanic interface +# Emitted when guest submits a shutdown request via pvpanic +# interface # # Since: 9.1 # @@ -481,8 +462,8 @@ =20 ## # @GuestPanicAction: -# -# An enumeration of the actions taken when guest OS panic is detected +# An enumeration of the actions taken when guest OS panic is +# detected # # @pause: system pauses # @@ -497,8 +478,7 @@ =20 ## # @GuestPanicInformationType: -# -# An enumeration of the guest panic information types +# An enumeration of the guest panic information types # # @hyper-v: hyper-v guest panic information type # @@ -515,8 +495,7 @@ =20 ## # @GuestPanicInformation: -# -# Information about a guest panic +# Information about a guest panic # # @type: Crash type that defines the hypervisor specific information # @@ -532,8 +511,7 @@ =20 ## # @GuestPanicInformationHyperV: -# -# Hyper-V specific guest panic information (HV crash MSRs) +# Hyper-V specific guest panic information (HV crash MSRs) # # @arg1: for Windows, `STOP` code for the guest crash. For Linux, # an error code. @@ -562,8 +540,7 @@ =20 ## # @S390CrashReason: -# -# Reason why the CPU is in a crashed state. +# Reason why the CPU is in a crashed state. # # @unknown: no crash reason was set # @@ -588,8 +565,7 @@ =20 ## # @GuestPanicInformationS390: -# -# S390 specific guest panic information (PSW) +# S390 specific guest panic information (PSW) # # @core: core id of the CPU that crashed # @@ -632,9 +608,8 @@ =20 ## # @GuestPanicInformationSev: -# -# Information for AMD SEV-specific termination request (GHCB MSR -# contents) +# Information for AMD SEV-specific termination request (GHCB MSR +# contents) # # @set: The reason code set provided by the guest # @@ -648,8 +623,7 @@ =20 ## # @MEMORY_FAILURE: -# -# Emitted when a memory failure occurs on host side. +# Emitted when a memory failure occurs on host side. # # @recipient: recipient is defined as `MemoryFailureRecipient`. # @@ -675,8 +649,7 @@ =20 ## # @MemoryFailureRecipient: -# -# Hardware memory failure occurs, handled by recipient. +# Hardware memory failure occurs, handled by recipient. # # @hypervisor: memory failure at QEMU process address space. (none # guest memory, but used by QEMU itself). @@ -691,8 +664,7 @@ =20 ## # @MemoryFailureAction: -# -# Actions taken by QEMU in response to a hardware memory failure. +# Actions taken by QEMU in response to a hardware memory failure. # # @ignore: the memory failure could be ignored. This will only be the # case for action-optional failures. @@ -719,8 +691,7 @@ =20 ## # @MemoryFailureFlags: -# -# Additional information on memory failures. +# Additional information on memory failures. # # @action-required: whether a memory failure event is action-required # or action-optional (e.g. a failure during memory scrub). @@ -736,8 +707,8 @@ =20 ## # @NotifyVmexitOption: -# -# An enumeration of the options specified when enabling notify VM exit +# An enumeration of the options specified when enabling notify VM +# exit # # @run: enable the feature, do nothing and continue if the notify VM # exit happens. --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207926; cv=none; d=zohomail.com; s=zohoarc; b=HpUvZdFW0xZFFY9LJiJFYR5Yh2xaLd9sIVYSACtxwimDbv/jjclFgZcNJg8dtHvNPaOaB47lEqtutUAzzsoCUBrty8np8jmsucBcAjdeX4tzmHK+1YSLCaXneNcXfSmD9s8w/Il1cz/DNc1JFsR+zNJE8hcfeldZU6i9RuoX2SQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207926; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=gbbbHuvMBl3KhDhnR1d/E0FiTkXcZ8dsOcmbpvowW8U=; b=iiMTPKuhTNUYWmOYGKgnnNEN6wKGHxsEkCBTVklSgFdkjYVamUPKrs7jHMom/Tss6S2YkUUJI0FoS4G7BH6cBZTGnM4v3M34t2ppE376++NPWyL5GLDCt7KrF500jtXYI2bWTloILF0qWj5yn6tHEbWOkCQvssrB5m9SFsXwxv0= 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 1788207926125738.4848003500142; Mon, 31 Aug 2026 13:25:26 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18ZG-0003AX-H3; Mon, 31 Aug 2026 16:25: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 1x18ZC-0002q8-Jc for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:18 -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 1x18ZA-0000B6-NA for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:18 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-320-xQ22YuS6OLOSlcEGZCvDTg-1; Mon, 31 Aug 2026 16:25:14 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 47781195FE38; Mon, 31 Aug 2026 20:25:11 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id C14B71800577; Mon, 31 Aug 2026 20:25:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207916; 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=gbbbHuvMBl3KhDhnR1d/E0FiTkXcZ8dsOcmbpvowW8U=; b=eZ1KVL/z0WHj0NM5C8DRdAfSA4Uc94evbmT3Q5FEsZGXGEzuYMTFPM+K9JKyPdJOf5Yz2z 5afJRupAJ02K2Q7Ip1MVJaRymesD6GlvRmp5PJiG9cDHF9jPYxfgshd3AAY2hU1x/DezWi 2r+kEAOntElGs11vQmyBDbhujoT4/1c= X-MC-Unique: xQ22YuS6OLOSlcEGZCvDTg-1 X-Mimecast-MFC-AGG-ID: xQ22YuS6OLOSlcEGZCvDTg_1788207911 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 36/43] qapi: convert trivial intro sections for char.json Date: Mon, 31 Aug 2026 16:19:38 -0400 Message-ID: <20260831201945.287730-37-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207929100154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/char.json | 90 +++++++++++++++++--------------------------------- 1 file changed, 30 insertions(+), 60 deletions(-) diff --git a/qapi/char.json b/qapi/char.json index abaccefa97e..7ae67eedff8 100644 --- a/qapi/char.json +++ b/qapi/char.json @@ -12,8 +12,7 @@ =20 ## # @ChardevInfo: -# -# Information about a character device. +# Information about a character device. # # @label: the label of the character device # @@ -35,8 +34,7 @@ =20 ## # @query-chardev: -# -# Return information about current character devices. +# Return information about current character devices. # # Since: 0.14 # @@ -68,8 +66,7 @@ =20 ## # @ChardevBackendInfo: -# -# Information about a character device backend +# Information about a character device backend # # @name: The backend name # @@ -79,8 +76,7 @@ =20 ## # @query-chardev-backends: -# -# Return information about character device backends. +# Return information about character device backends. # # Since: 2.0 # @@ -108,8 +104,7 @@ =20 ## # @DataFormat: -# -# An enumeration of data format. +# An enumeration of data format. # # @utf8: Data is a UTF-8 string (RFC 3629) # @@ -122,8 +117,7 @@ =20 ## # @ringbuf-write: -# -# Write to a ring buffer character device. +# Write to a ring buffer character device. # # @device: the ring buffer character device name # @@ -154,8 +148,7 @@ =20 ## # @ringbuf-read: -# -# Read from a ring buffer character device. +# Read from a ring buffer character device. # # @device: the ring buffer character device name # @@ -189,8 +182,7 @@ =20 ## # @ChardevCommon: -# -# Configuration shared across all chardev backends +# Configuration shared across all chardev backends # # @logfile: The name of a logfile to save output # @@ -209,8 +201,7 @@ =20 ## # @ChardevFile: -# -# Configuration info for file chardevs. +# Configuration info for file chardevs. # # @in: The name of the input file # @@ -229,8 +220,7 @@ =20 ## # @ChardevHostdev: -# -# Configuration info for device and pipe chardevs. +# Configuration info for device and pipe chardevs. # # @device: The name of the special file for the device, i.e. # /dev/ttyS0 on Unix or COM1: on Windows @@ -243,8 +233,7 @@ =20 ## # @ChardevSocket: -# -# Configuration info for (stream) socket chardevs. +# Configuration info for (stream) socket chardevs. # # @addr: socket address to listen on (server=3Dtrue) or connect to # (server=3Dfalse) @@ -295,8 +284,7 @@ =20 ## # @ChardevUdp: -# -# Configuration info for datagram socket chardevs. +# Configuration info for datagram socket chardevs. # # @remote: remote address # @@ -311,8 +299,7 @@ =20 ## # @ChardevMux: -# -# Configuration info for mux chardevs. +# Configuration info for mux chardevs. # # @chardev: name of the base chardev. # @@ -324,8 +311,7 @@ =20 ## # @ChardevHub: -# -# Configuration info for hub chardevs. +# Configuration info for hub chardevs. # # @chardevs: IDs to be added to this hub (maximum 4 devices). # @@ -337,8 +323,7 @@ =20 ## # @ChardevStdio: -# -# Configuration info for stdio chardevs. +# Configuration info for stdio chardevs. # # @signal: Allow signals (such as SIGINT triggered by ^C) be delivered # to QEMU. Default: true. @@ -351,8 +336,7 @@ =20 ## # @ChardevSpiceChannel: -# -# Configuration info for spice vm channel chardevs. +# Configuration info for spice vm channel chardevs. # # @type: kind of channel (for example vdagent). # @@ -365,8 +349,7 @@ =20 ## # @ChardevSpicePort: -# -# Configuration info for spice port chardevs. +# Configuration info for spice port chardevs. # # @fqdn: name of the channel (see docs/spice-port-fqdn.txt) # @@ -379,8 +362,7 @@ =20 ## # @ChardevVCEncoding: -# -# Character encoding expected from the guest on a virtual console. +# Character encoding expected from the guest on a virtual console. # # @cp437: CP437 (8-bit Extended ASCII / VGA). Every byte maps # directly to a glyph; suitable for DOS or other guests that @@ -397,8 +379,7 @@ =20 ## # @ChardevDBus: -# -# Configuration info for DBus chardevs. +# Configuration info for DBus chardevs. # # @name: name of the channel (following docs/spice-port-fqdn.txt) # @@ -415,8 +396,7 @@ =20 ## # @ChardevVC: -# -# Configuration info for virtual console chardevs. +# Configuration info for virtual console chardevs. # # @width: console width, in pixels # @@ -445,8 +425,7 @@ =20 ## # @ChardevRingbuf: -# -# Configuration info for ring buffer chardevs. +# Configuration info for ring buffer chardevs. # # @size: ring buffer size, must be power of two, default is 65536 # @@ -458,8 +437,7 @@ =20 ## # @ChardevQemuVDAgent: -# -# Configuration info for QEMU vdagent implementation. +# Configuration info for QEMU vdagent implementation. # # @mouse: enable/disable mouse, default is enabled. # @@ -475,8 +453,7 @@ =20 ## # @ChardevPty: -# -# Configuration info for pty implementation. +# Configuration info for pty implementation. # # @path: optional path to create a symbolic link that points to the # allocated PTY @@ -723,8 +700,7 @@ =20 ## # @ChardevBackend: -# -# Configuration info for the new chardev backend. +# Configuration info for the new chardev backend. # # @type: backend type # @@ -767,8 +743,7 @@ =20 ## # @ChardevReturn: -# -# Return info about the chardev backend just created. +# Return info about the chardev backend just created. # # @pty: name of the slave pseudoterminal device, present if and only # if a chardev of type 'pty' was created @@ -780,8 +755,7 @@ =20 ## # @chardev-add: -# -# Add a character device backend +# Add a character device backend # # @id: the chardev's ID, must be unique # @@ -818,8 +792,7 @@ =20 ## # @chardev-change: -# -# Change a character device backend +# Change a character device backend # # @id: the chardev's ID # @@ -859,8 +832,7 @@ =20 ## # @chardev-remove: -# -# Remove a character device backend +# Remove a character device backend # # @id: the chardev's ID, must not be in use # @@ -876,8 +848,7 @@ =20 ## # @chardev-send-break: -# -# Send a break to a character device +# Send a break to a character device # # @id: the chardev's ID # @@ -893,8 +864,7 @@ =20 ## # @VSERPORT_CHANGE: -# -# Emitted when the guest opens or closes a virtio-serial port. +# Emitted when the guest opens or closes a virtio-serial port. # # @id: device identifier of the virtio-serial port # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788208014; cv=none; d=zohomail.com; s=zohoarc; b=E9idYfNAdmunUBZ18dGIgsEjhol2KHFFaaTz8R0e6YseMzWunPP1TMRAuS5cbumKuf+bqlJ8v+nEi/cIvKuFtwLFd0YKxcy6XPZ1UjhPjchLRRLr4D2q985AKa+20hAd0jeGhmwKv90B8UAE0O1UhZ8P4BPKBX8QtbpproZODxY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788208014; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=pS3gWzM2OpSimpBSFZGIbBPCkdQIT5l3gW1iVRp02q8=; b=EejjnV/lZZEVsJt2Ko2eT4klS2GvLnlrLLr3vtyDvr/nOgBYWlUwwUUFZYafnKtO+PgoADl1TbZCgMpkap1h7x7MMCwR3w0WNKh1FlA8olz5XFWk1R6rSS/lyLapNr5rVR5TXhNlL/b1xHXBZlH/1ygMNEnT24E4URsHe0OQm0k= 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 1788208014854274.82951885852674; Mon, 31 Aug 2026 13:26:54 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18ZZ-0004ub-JV; Mon, 31 Aug 2026 16:25: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 1x18ZL-0003dD-5Z for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:27 -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 1x18ZJ-0000HR-9A for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:26 -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-136-uMc_VPINMpqQiIXR6qSURQ-1; Mon, 31 Aug 2026 16:25:21 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 0335D18E6780; Mon, 31 Aug 2026 20:25:18 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 7D9EB1800347; Mon, 31 Aug 2026 20:25:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207924; 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=pS3gWzM2OpSimpBSFZGIbBPCkdQIT5l3gW1iVRp02q8=; b=M0eZOr+XCGKErJ9zQ4JBGjQMHA15hOOrpBiCbGATp+4hX7hAbmqdiSIVFTAAIeUWWTpexB G3LZkluvu3DfFWUPk4L2L476bmkLaF9MnC/45K2GJaev4+Pin6mXrhEux37Oc8iSUi3bdF NG2Z+uBbzZAhGXQSgsV1dDHC0qSA00k= X-MC-Unique: uMc_VPINMpqQiIXR6qSURQ-1 X-Mimecast-MFC-AGG-ID: uMc_VPINMpqQiIXR6qSURQ_1788207918 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 37/43] qapi: convert trivial intro sections for virtio.json Date: Mon, 31 Aug 2026 16:19:39 -0400 Message-ID: <20260831201945.287730-38-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788208016595154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/virtio.json | 54 ++++++++++++++++++------------------------------ 1 file changed, 20 insertions(+), 34 deletions(-) diff --git a/qapi/virtio.json b/qapi/virtio.json index 1fc4e38a44d..9aafc3a212f 100644 --- a/qapi/virtio.json +++ b/qapi/virtio.json @@ -10,8 +10,7 @@ =20 ## # @VirtioInfo: -# -# Basic information about a given VirtIODevice +# Basic information about a given VirtIODevice # # @path: The VirtIODevice's canonical QOM path # @@ -25,8 +24,7 @@ =20 ## # @x-query-virtio: -# -# Return a list of all realized VirtIODevices +# Return a list of all realized VirtIODevices # # Features: # @@ -189,8 +187,7 @@ =20 ## # @x-query-virtio-status: -# -# Poll for a comprehensive status of a given virtio device +# Poll for a comprehensive status of a given virtio device # # @path: Canonical QOM path of the VirtIODevice # @@ -442,9 +439,8 @@ =20 ## # @VirtioDeviceStatus: -# -# A structure defined to list the configuration statuses of a virtio -# device +# A structure defined to list the configuration statuses of a +# virtio device # # @statuses: List of decoded configuration statuses of the virtio # device @@ -460,9 +456,8 @@ =20 ## # @VhostDeviceProtocols: -# -# A structure defined to list the vhost user protocol features of a -# Vhost User device +# A structure defined to list the vhost user protocol features of +# a Vhost User device # # @protocols: List of decoded vhost user protocol features of a vhost # user device @@ -503,9 +498,8 @@ =20 ## # @VirtQueueStatus: -# -# Information of a VirtIODevice VirtQueue, including most members of -# the VirtQueue data structure. +# Information of a VirtIODevice VirtQueue, including most members +# of the VirtQueue data structure. # # @name: Name of the VirtIODevice that uses this VirtQueue # @@ -556,8 +550,7 @@ =20 ## # @x-query-virtio-queue-status: -# -# Return the status of a given VirtIODevice's VirtQueue +# Return the status of a given VirtIODevice's VirtQueue # # @path: VirtIODevice canonical QOM path # @@ -640,9 +633,8 @@ =20 ## # @VirtVhostQueueStatus: -# -# Information of a vhost device's vhost_virtqueue, including most -# members of the vhost_dev vhost_virtqueue data structure. +# Information of a vhost device's vhost_virtqueue, including most +# members of the vhost_dev vhost_virtqueue data structure. # # @name: Name of the VirtIODevice that uses this vhost_virtqueue # @@ -682,8 +674,7 @@ =20 ## # @x-query-virtio-vhost-queue-status: -# -# Return information of a given vhost device's vhost_virtqueue +# Return information of a given vhost device's vhost_virtqueue # # @path: VirtIODevice canonical QOM path # @@ -746,8 +737,7 @@ =20 ## # @VirtioRingDesc: -# -# Information regarding the vring descriptor area +# Information regarding the vring descriptor area # # @addr: Guest physical address of the descriptor area # @@ -797,9 +787,8 @@ =20 ## # @VirtioQueueElement: -# -# Information regarding a VirtQueue's VirtQueueElement including -# descriptor, driver, and device areas +# Information regarding a VirtQueue's VirtQueueElement including +# descriptor, driver, and device areas # # @name: Name of the VirtIODevice that uses this VirtQueue # @@ -822,8 +811,7 @@ =20 ## # @x-query-virtio-queue-element: -# -# Return the information about a VirtQueue's VirtQueueElement +# Return the information about a VirtQueue's VirtQueueElement # # @path: VirtIODevice canonical QOM path # @@ -933,8 +921,7 @@ =20 ## # @IOThreadVirtQueueMapping: -# -# Describes the subset of virtqueues assigned to an IOThread. +# Describes the subset of virtqueues assigned to an IOThread. # # @iothread: the id of IOThread object # @@ -973,9 +960,8 @@ =20 ## # @DummyVirtioForceArrays: -# -# Not used by QMP; hack to let us use IOThreadVirtQueueMappingList and -# VirtIOGPUOutputList internally +# Not used by QMP; hack to let us use IOThreadVirtQueueMappingList +# and VirtIOGPUOutputList internally # # Since: 9.0 ## --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207943; cv=none; d=zohomail.com; s=zohoarc; b=CPAEUQ4zQdGRDALRX7hXhMO1DyTq7T1helCerT6Uite6NwDA5joQqzjWGzFaSe7v7lW1szggIdwxnRuqV2LePH8Q7q4J1wrT9mssKuSxwZZhEADTRgVeGGvLt27Otn546IMVjWOsVVhzZCKdKsm04oFDl6mq31emwuZAgU5NvoQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207943; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=U/qXQ7y8j8vRIuhHXNBGEntkR65K80MZ6kjFW8kUyKM=; b=OWxGxYDpxfkEdzPSumfv/ARqjm+AEUrjk/0zwmkQv3J/b9vwcu/7D8FqO+dZsvrqkglsVotxClPmDODe0Tti2TCithF0J5XJ7qhTP1wopse3gWJBbiEtvojKUs5IgqqBgNpu/IHL2cnn2GHSWmkHWvro/WUVFWrnl+MTUEic9Wo= 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 1788207943563543.7020303389264; Mon, 31 Aug 2026 13:25:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18ZY-0004mj-IZ; Mon, 31 Aug 2026 16:25:40 -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 1x18ZU-0004QO-Fp for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:36 -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 1x18ZR-0000VN-Dc for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:36 -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-642-XNahUdQTN_etkX5G4gySqQ-1; Mon, 31 Aug 2026 16:25:28 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2AAB018E6789; Mon, 31 Aug 2026 20:25:25 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6064018005AC; Mon, 31 Aug 2026 20:25:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207932; 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=U/qXQ7y8j8vRIuhHXNBGEntkR65K80MZ6kjFW8kUyKM=; b=M/EB5kqLSDHI8U5do8FncgQHsCBI9jubyWLmYTtbOdFuxb5r1SXMuGv0y/V6Ryo9OgKBmB rbWz8gjCt7MpW2U4HEVaOC2vPWnxx6Kj2y04bQTiIbX6V/Y197P99q4dh2RVO2HfiZ8/ZV OwKKcgDRxC6aiTurA8IaPssi6D/UQ2s= X-MC-Unique: XNahUdQTN_etkX5G4gySqQ-1 X-Mimecast-MFC-AGG-ID: XNahUdQTN_etkX5G4gySqQ_1788207925 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 38/43] qapi: convert trivial intro sections for net.json Date: Mon, 31 Aug 2026 16:19:40 -0400 Message-ID: <20260831201945.287730-39-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207945464158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/net.json | 92 ++++++++++++++++++--------------------------------- 1 file changed, 33 insertions(+), 59 deletions(-) diff --git a/qapi/net.json b/qapi/net.json index 1a6382825c5..4ea4bd1bc72 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -12,8 +12,7 @@ =20 ## # @set_link: -# -# Sets the link status of a virtual network adapter. +# Sets the link status of a virtual network adapter. # # @name: the device name of the virtual network adapter # @@ -60,8 +59,7 @@ =20 ## # @netdev_del: -# -# Remove a network backend. +# Remove a network backend. # # @id: the name of the network backend to remove # @@ -80,8 +78,7 @@ =20 ## # @NetLegacyNicOptions: -# -# Create a new Network Interface Card. +# Create a new Network Interface Card. # # @netdev: id of -netdev to connect to # @@ -140,8 +137,7 @@ =20 ## # @NetdevPasstOptions: -# -# Unprivileged user-mode network connectivity using passt +# Unprivileged user-mode network connectivity using passt # # @path: Filename of the passt program to run (by default 'passt', and # use PATH) @@ -301,9 +297,8 @@ =20 ## # @NetdevUserOptions: -# -# Use the user mode network stack which requires no administrator -# privilege to run. +# Use the user mode network stack which requires no administrator +# privilege to run. # # @hostname: client hostname reported by the builtin DHCP server # @@ -389,8 +384,7 @@ =20 ## # @NetdevTapOptions: -# -# Used to configure a host TAP network interface backend. +# Used to configure a host TAP network interface backend. # # @ifname: interface name # @@ -447,9 +441,8 @@ =20 ## # @NetdevSocketOptions: -# -# Socket netdevs are used to establish a network connection to another -# QEMU virtual machine via a TCP socket. +# Socket netdevs are used to establish a network connection to +# another QEMU virtual machine via a TCP socket. # # @fd: file descriptor of an already opened socket # @@ -476,8 +469,7 @@ =20 ## # @NetdevL2TPv3Options: -# -# Configure an Ethernet over L2TPv3 tunnel. +# Configure an Ethernet over L2TPv3 tunnel. # # @src: source address # @@ -531,8 +523,7 @@ =20 ## # @NetdevVdeOptions: -# -# Connect to a vde switch running on the host. +# Connect to a vde switch running on the host. # # @sock: socket path # @@ -553,8 +544,7 @@ =20 ## # @NetdevBridgeOptions: -# -# Connect a host TAP network interface to a host bridge device. +# Connect a host TAP network interface to a host bridge device. # # @br: bridge name # @@ -569,8 +559,7 @@ =20 ## # @NetdevHubPortOptions: -# -# Connect two or more net clients through a software hub. +# Connect two or more net clients through a software hub. # # @hubid: hub identifier number # @@ -586,8 +575,8 @@ =20 ## # @NetdevNetmapOptions: -# -# Connect a client to a netmap-enabled NIC or to a VALE switch port +# Connect a client to a netmap-enabled NIC or to a VALE switch +# port # # @ifname: Either the name of an existing network interface supported # by netmap, or the name of a VALE port (created on the fly). A @@ -607,8 +596,7 @@ =20 ## # @AFXDPMode: -# -# Attach mode for a default XDP program +# Attach mode for a default XDP program # # @skb: generic mode, no driver support necessary # @@ -623,8 +611,7 @@ =20 ## # @NetdevAFXDPOptions: -# -# AF_XDP network backend +# AF_XDP network backend # # @ifname: The name of an existing network interface. # @@ -675,8 +662,7 @@ =20 ## # @NetdevVhostUserOptions: -# -# Vhost-user network backend +# Vhost-user network backend # # @chardev: name of a unix socket chardev # @@ -836,8 +822,7 @@ =20 ## # @NetdevStreamOptions: -# -# Configuration info for stream socket netdev +# Configuration info for stream socket netdev # # @addr: socket address to listen on (server=3Dtrue) or connect to # (server=3Dfalse) @@ -861,8 +846,7 @@ =20 ## # @NetdevDgramOptions: -# -# Configuration info for datagram socket netdev. +# Configuration info for datagram socket netdev. # # @remote: remote address # @@ -898,8 +882,7 @@ =20 ## # @NetClientDriver: -# -# Available netdev drivers. +# Available netdev drivers. # # @l2tpv3: since 2.1 # @@ -933,8 +916,7 @@ =20 ## # @Netdev: -# -# Captures the configuration of a network device. +# Captures the configuration of a network device. # # @id: identifier for monitor commands. # @@ -972,8 +954,7 @@ =20 ## # @RxState: -# -# Packets receiving state +# Packets receiving state # # @normal: filter assigned packets according to the mac-table # @@ -987,8 +968,7 @@ =20 ## # @RxFilterInfo: -# -# Rx-filter information for a NIC. +# Rx-filter information for a NIC. # # @name: net client name # @@ -1033,8 +1013,8 @@ =20 ## # @query-rx-filter: -# -# Return rx-filter information for all NICs (or for the given NIC). +# Return rx-filter information for all NICs (or for the given +# NIC). # # @name: net client name # @@ -1082,9 +1062,8 @@ =20 ## # @NIC_RX_FILTER_CHANGED: -# -# Emitted once until the `query-rx-filter` command is executed, the -# first event will always be emitted +# Emitted once until the `query-rx-filter` command is executed, +# the first event will always be emitted # # @name: net client name # @@ -1104,8 +1083,7 @@ =20 ## # @AnnounceParameters: -# -# Parameters for self-announce timers +# Parameters for self-announce timers # # @initial: Initial delay (in ms) before sending the first GARP/RARP # announcement @@ -1178,8 +1156,7 @@ =20 ## # @NETDEV_STREAM_CONNECTED: -# -# Emitted when the netdev stream backend is connected +# Emitted when the netdev stream backend is connected # # @netdev-id: QEMU netdev id that is connected # @@ -1208,8 +1185,7 @@ =20 ## # @NETDEV_STREAM_DISCONNECTED: -# -# Emitted when the netdev stream backend is disconnected +# Emitted when the netdev stream backend is disconnected # # @netdev-id: QEMU netdev id that is disconnected # @@ -1226,8 +1202,7 @@ =20 ## # @NETDEV_VHOST_USER_CONNECTED: -# -# Emitted when the vhost-user chardev is connected +# Emitted when the vhost-user chardev is connected # # @netdev-id: QEMU netdev id that is connected # @@ -1246,8 +1221,7 @@ =20 ## # @NETDEV_VHOST_USER_DISCONNECTED: -# -# Emitted when the vhost-user chardev is disconnected +# Emitted when the vhost-user chardev is disconnected # # @netdev-id: QEMU netdev id that is disconnected # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207951; cv=none; d=zohomail.com; s=zohoarc; b=F1JIQ4SuuUpA9rQBTVh4uwo6mXggtWs+b9a+KtzNUss3J6UFQ/q1duGEh3wcOt1chl0YeMQI194+41CyKM9pbOktmXi/zthQucMSoPjkOE0mRrqtKJpI005KZPxGWYVdjL/gLFdW9kuIoAw6IiYg+ziO18rhxqFmQD5I5xitHN0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207951; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=2QuKO15oyZt8iK9uQrm37D00LC/3KnAtcu6Y6GzPK/U=; b=Qjs6/W0YjKr5waSurwezM1z8b9BC9wSSYPhbzkDc2OAc50BkdQu8jKxUfFTbsLRvtLuUoYG2eLsTAMk6wvhge2XaJOFKi/PNuZSbJCyu4sRlszUyDrOdTz7lLnwQO0ovhUvFAoZKH2DBBnBYr6s6eUIA+OpIM2c/ya6ckfSU9sQ= 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 1788207951308488.61797606511027; Mon, 31 Aug 2026 13:25:51 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Zc-0005HV-VA; Mon, 31 Aug 2026 16:25:45 -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 1x18Za-0004zc-Bs for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:42 -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 1x18ZX-0000Xj-O6 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:41 -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-158-YBUzUfduNf-jSrGGnvQSyA-1; Mon, 31 Aug 2026 16:25:35 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E2ABA1954212; Mon, 31 Aug 2026 20:25:31 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 60CF01800347; Mon, 31 Aug 2026 20:25:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207939; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=2QuKO15oyZt8iK9uQrm37D00LC/3KnAtcu6Y6GzPK/U=; b=QMUlRGt812nR5PqqP6Ck/7ehUUFNWLPT/YB8SlO6qKS398xhuU+oTHcmVINFLnyZQeWF2b BKePUIkwUih7izjKPTe190aqpR0tAkopoFglIPWMDHIGrb3y1NKMkKWS92GRzUX9BxgBhr rwSDK9VXLuxZCSBgPXEc0+P7JeZvlNg= X-MC-Unique: YBUzUfduNf-jSrGGnvQSyA-1 X-Mimecast-MFC-AGG-ID: YBUzUfduNf-jSrGGnvQSyA_1788207932 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v4 39/43] qapi: convert trivial intro sections for qom.json Date: Mon, 31 Aug 2026 16:19:41 -0400 Message-ID: <20260831201945.287730-40-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788207953543154100 Signed-off-by: John Snow Reviewed-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Markus Armbruster --- qapi/qom.json | 150 +++++++++++++++++--------------------------------- 1 file changed, 51 insertions(+), 99 deletions(-) diff --git a/qapi/qom.json b/qapi/qom.json index 4a9b7f90884..51af9485e6d 100644 --- a/qapi/qom.json +++ b/qapi/qom.json @@ -77,8 +77,7 @@ =20 ## # @qom-list: -# -# List properties of a object given a path in the object model. +# List properties of a object given a path in the object model. # # @path: the path within the object model. See `qom-get` for a # description of this parameter. @@ -103,8 +102,7 @@ =20 ## # @qom-get: -# -# Get a property value. +# Get a property value. # # @path: The path within the object model. There are two forms of # supported paths--absolute and partial paths. @@ -154,9 +152,8 @@ =20 ## # @qom-list-get: -# -# List properties and their values for each object path in the input -# list. +# List properties and their values for each object path in the +# input list. # # @paths: The absolute or partial path for each object, as described # in `qom-get`. @@ -176,8 +173,7 @@ =20 ## # @qom-set: -# -# Set a property value. +# Set a property value. # # @path: see `qom-get` for a description of this parameter # @@ -202,8 +198,7 @@ =20 ## # @ObjectTypeInfo: -# -# This structure describes a search result from `qom-list-types` +# This structure describes a search result from `qom-list-types` # # @name: the type name found in the search # @@ -219,8 +214,7 @@ =20 ## # @qom-list-types: -# -# Return a list of types given search parameters. +# Return a list of types given search parameters. # # @implements: if specified, only return types that implement this # type name @@ -238,8 +232,7 @@ =20 ## # @qom-list-properties: -# -# List properties associated with a QOM object. +# List properties associated with a QOM object. # # @typename: the type name of an object # @@ -258,8 +251,7 @@ =20 ## # @CanHostSocketcanProperties: -# -# Properties for can-host-socketcan objects. +# Properties for can-host-socketcan objects. # # @if: interface name of the host system CAN bus to connect to # @@ -275,8 +267,7 @@ =20 ## # @ColoCompareProperties: -# -# Properties for colo-compare objects. +# Properties for colo-compare objects. # # @primary_in: name of the character device backend to use for the # primary input (incoming packets are redirected to @outdev) @@ -323,9 +314,8 @@ =20 ## # @CryptodevBackendProperties: -# -# Properties for cryptodev-backend and cryptodev-backend-builtin -# objects. +# Properties for cryptodev-backend and cryptodev-backend-builtin +# objects. # # @queues: the number of queues for the cryptodev backend. Ignored # for cryptodev-backend and must be 1 for @@ -344,8 +334,7 @@ =20 ## # @CryptodevVhostUserProperties: -# -# Properties for cryptodev-vhost-user objects. +# Properties for cryptodev-vhost-user objects. # # @chardev: the name of a Unix domain socket character device that # connects to the vhost-user server @@ -359,8 +348,7 @@ =20 ## # @DBusVMStateProperties: -# -# Properties for dbus-vmstate objects. +# Properties for dbus-vmstate objects. # # @addr: the name of the DBus bus to connect to # @@ -375,9 +363,8 @@ =20 ## # @NetfilterInsert: -# -# Indicates where to insert a netfilter relative to a given other -# filter. +# Indicates where to insert a netfilter relative to a given other +# filter. # # @before: insert before the specified filter # @@ -390,8 +377,7 @@ =20 ## # @NetfilterProperties: -# -# Properties for objects of classes derived from netfilter. +# Properties for objects of classes derived from netfilter. # # @netdev: id of the network device backend to filter # @@ -423,8 +409,7 @@ =20 ## # @FilterBufferProperties: -# -# Properties for filter-buffer objects. +# Properties for filter-buffer objects. # # @interval: a non-zero interval in microseconds. All packets # arriving in the given interval are delayed until the end of the @@ -438,8 +423,7 @@ =20 ## # @FilterDumpProperties: -# -# Properties for filter-dump objects. +# Properties for filter-dump objects. # # @file: the filename where the dumped packets should be stored # @@ -455,8 +439,7 @@ =20 ## # @FilterMirrorProperties: -# -# Properties for filter-mirror objects. +# Properties for filter-mirror objects. # # @outdev: the name of a character device backend to which all # incoming packets are mirrored @@ -498,8 +481,7 @@ =20 ## # @FilterRewriterProperties: -# -# Properties for filter-rewriter objects. +# Properties for filter-rewriter objects. # # @vnet_hdr_support: if true, vnet header support is enabled # (default: false) @@ -512,8 +494,7 @@ =20 ## # @InputBarrierProperties: -# -# Properties for input-barrier objects. +# Properties for input-barrier objects. # # @name: the screen name as declared in the screens section of # barrier.conf @@ -545,8 +526,7 @@ =20 ## # @InputLinuxProperties: -# -# Properties for input-linux objects. +# Properties for input-linux objects. # # @evdev: the path of the host evdev device to use # @@ -569,8 +549,7 @@ =20 ## # @EventLoopBaseProperties: -# -# Common properties for event loops +# Common properties for event loops # # @aio-max-batch: maximum number of requests in a batch for the AIO # engine, 0 means that the engine will use its default. @@ -591,8 +570,7 @@ =20 ## # @IothreadProperties: -# -# Properties for iothread objects. +# Properties for iothread objects. # # @poll-max-ns: the maximum number of nanoseconds to busy wait for # events. 0 means polling is disabled (default: 32768 on POSIX @@ -626,8 +604,7 @@ =20 ## # @MainLoopProperties: -# -# Properties for the main-loop object. +# Properties for the main-loop object. # # Since: 7.1 ## @@ -637,8 +614,7 @@ =20 ## # @MemoryBackendProperties: -# -# Properties for objects of classes derived from memory-backend. +# Properties for objects of classes derived from memory-backend. # # @merge: if true, mark the memory as mergeable (default depends on # the machine type) @@ -696,8 +672,7 @@ =20 ## # @MemoryBackendFileProperties: -# -# Properties for memory-backend-file objects. +# Properties for memory-backend-file objects. # # @align: the base address alignment when QEMU mmap(2)s @mem-path. # Some backend stores specified by @mem-path require an alignment @@ -757,8 +732,7 @@ =20 ## # @MemoryBackendMemfdProperties: -# -# Properties for memory-backend-memfd objects. +# Properties for memory-backend-memfd objects. # # @hugetlb: if true, the file to be created resides in the hugetlbfs # filesystem (default: false) @@ -813,8 +787,7 @@ =20 ## # @PrManagerHelperProperties: -# -# Properties for pr-manager-helper objects. +# Properties for pr-manager-helper objects. # # @path: the path to a Unix domain socket for connecting to the # external helper @@ -827,8 +800,7 @@ =20 ## # @QtestProperties: -# -# Properties for qtest objects. +# Properties for qtest objects. # # @chardev: the chardev to be used to receive qtest commands on. # @@ -842,8 +814,7 @@ =20 ## # @RemoteObjectProperties: -# -# Properties for x-remote-object objects. +# Properties for x-remote-object objects. # # @fd: file descriptor name previously passed via `getfd` command # @@ -857,8 +828,7 @@ =20 ## # @VfioUserServerProperties: -# -# Properties for x-vfio-user-server objects. +# Properties for x-vfio-user-server objects. # # @socket: socket to be used by the libvfio-user library # @@ -871,8 +841,7 @@ =20 ## # @IOMMUFDProperties: -# -# Properties for iommufd objects. +# Properties for iommufd objects. # # @fd: file descriptor name previously passed via `getfd` command, # which represents a pre-opened /dev/iommu. This allows the @@ -887,8 +856,7 @@ =20 ## # @AcpiGenericInitiatorProperties: -# -# Properties for acpi-generic-initiator objects. +# Properties for acpi-generic-initiator objects. # # @pci-dev: PCI device ID to be associated with the node # @@ -902,8 +870,7 @@ =20 ## # @AcpiGenericPortProperties: -# -# Properties for acpi-generic-port objects. +# Properties for acpi-generic-port objects. # # @pci-bus: QOM path of the PCI bus of the hostbridge associated with # this SRAT Generic Port Affinity Structure. This is the same as @@ -941,8 +908,7 @@ =20 ## # @RngProperties: -# -# Properties for objects of classes derived from rng. +# Properties for objects of classes derived from rng. # # @opened: if true, the device is opened immediately when applying # this option and will probably fail when processing the next @@ -961,8 +927,7 @@ =20 ## # @RngEgdProperties: -# -# Properties for rng-egd objects. +# Properties for rng-egd objects. # # @chardev: the name of a character device backend that provides the # connection to the RNG daemon @@ -975,8 +940,7 @@ =20 ## # @RngRandomProperties: -# -# Properties for rng-random objects. +# Properties for rng-random objects. # # @filename: the filename of the device on the host to obtain entropy # from (default: "/dev/urandom") @@ -990,8 +954,7 @@ =20 ## # @IgvmCfgProperties: -# -# Properties common to objects that handle IGVM files. +# Properties common to objects that handle IGVM files. # # @file: IGVM file to use to configure guest # @@ -1003,8 +966,7 @@ =20 ## # @SevCommonProperties: -# -# Properties common to objects that are derivatives of sev-common. +# Properties common to objects that are derivatives of sev-common. # # @sev-device: SEV device to use (default: "/dev/sev") # @@ -1038,8 +1000,7 @@ =20 ## # @SevGuestProperties: -# -# Properties for sev-guest objects. +# Properties for sev-guest objects. # # @dh-cert-file: guest owners DH certificate (encoded with base64) # @@ -1136,8 +1097,7 @@ =20 ## # @TdxGuestProperties: -# -# Properties for tdx-guest objects. +# Properties for tdx-guest objects. # # @attributes: The 'attributes' of a TD guest that is passed to # KVM_TDX_INIT_VM @@ -1181,8 +1141,7 @@ =20 ## # @ThreadContextProperties: -# -# Properties for thread context objects. +# Properties for thread context objects. # # @cpu-affinity: the list of host CPU numbers used as CPU affinity for # all threads created in the thread context (default: QEMU main @@ -1202,8 +1161,7 @@ =20 ## # @MonitorProperties: -# -# Properties for all monitors +# Properties for all monitors # # @chardev: ID of the character device providing the monitor transport # @@ -1214,8 +1172,7 @@ =20 ## # @MonitorHMPProperties: -# -# Properties for the HMP monitor +# Properties for the HMP monitor # # @readline: whether to enable readline for line editing # (default: true) @@ -1229,8 +1186,7 @@ =20 ## # @MonitorQMPCloseAction: -# -# Action to take when the character device backend is closed. +# Action to take when the character device backend is closed. # # @none: take no action # @@ -1244,8 +1200,7 @@ =20 ## # @MonitorQMPProperties: -# -# Properties for the QMP monitor +# Properties for the QMP monitor # # @pretty: whether to pretty print JSON responses (default: false) # @@ -1338,8 +1293,7 @@ =20 ## # @ObjectOptions: -# -# Describes the options of a user creatable QOM object. +# Describes the options of a user creatable QOM object. # # @qom-type: the class name for the object to be created # @@ -1416,8 +1370,7 @@ =20 ## # @object-add: -# -# Create a QOM object. +# Create a QOM object. # # Errors: # - If @qom-type is not a valid class name @@ -1436,8 +1389,7 @@ =20 ## # @object-del: -# -# Remove a QOM object. +# Remove a QOM object. # # @id: the name of the QOM object to remove # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207959; cv=none; d=zohomail.com; s=zohoarc; b=mONiJAWzh3BMkIvoC7fz7/cUUqh2nuEf6uny5NwgdW4pRrcNoe6aEi1oQKJLWKroFkdkdH0Q9GBRZ/7TdozVMaMsNqy91/FSVSNyeoFFl9R2Ch2j9uM8+0zGIhs9wYzgg0C5/oo1gzKDD9q4qyCQ1MGFE82GHWbREGh7xU6Mn3c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207959; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=GT4vbniYPu2T0an15X/kc4fJpS4Ogad+KYFFAMad4RM=; b=bU0wtMQlnMOXAvUu/ESdQ8M1G3vnFXe56fwgTMS6WH/dYitxZTCzvMfeI8yWH7n2JiSutA8kaXXi6edh7TZM4lwbqrBrLUp2X7CV/8Jh+yK01bjCOyb5ID+T62tSzdqr7f5X8hX3dwOWr5P3hoIERaaQSYfaNZ2Y/BR1DeXqlBs= 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 1788207959541563.6502793681574; Mon, 31 Aug 2026 13:25:59 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Zk-0005tx-RD; Mon, 31 Aug 2026 16:25:52 -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 1x18Zi-0005gm-33 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25: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 1x18Zf-0000ao-LS for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25: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-489-YD3I1q7EOtmx6X9TRg2puw-1; Mon, 31 Aug 2026 16:25:41 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 971111944DF1; Mon, 31 Aug 2026 20:25:38 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 23D741800577; Mon, 31 Aug 2026 20:25:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207946; 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=GT4vbniYPu2T0an15X/kc4fJpS4Ogad+KYFFAMad4RM=; b=T8QojIZxN+Rk+jepm0AS+w8fKGb+KhxSXgqkaJzkwqzItMJin4x6iGpOdKDPw+IU05T3YL 0hvbiYV4X8gZJshnaOIaCyN8I5CIrV1PWUvSZn9AjpL6FYj9uaeR3fP//qMxGrpEsTvqyK S4WLydKM+yavoEzhIuusnPr5QbpV/iU= X-MC-Unique: YD3I1q7EOtmx6X9TRg2puw-1 X-Mimecast-MFC-AGG-ID: YD3I1q7EOtmx6X9TRg2puw_1788207938 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 40/43] qapi: convert trivial intro sections for ui.json Date: Mon, 31 Aug 2026 16:19:42 -0400 Message-ID: <20260831201945.287730-41-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207961588154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/ui.json | 199 ++++++++++++++++++--------------------------------- 1 file changed, 68 insertions(+), 131 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index b2c42a7f578..960d02d1429 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -13,8 +13,7 @@ =20 ## # @DisplayProtocol: -# -# Display protocols which support changing password options. +# Display protocols which support changing password options. # # Since: 7.0 ## @@ -23,9 +22,8 @@ =20 ## # @SetPasswordAction: -# -# An action to take on changing a password on a connection with active -# clients. +# An action to take on changing a password on a connection with +# active clients. # # @keep: maintain existing clients # @@ -40,8 +38,7 @@ =20 ## # @SetPasswordOptions: -# -# Options for `set_password`. +# Options for `set_password`. # # @protocol: # - 'vnc' to modify the VNC server password @@ -64,8 +61,7 @@ =20 ## # @SetPasswordOptionsVnc: -# -# Options for `set_password` specific to the VNC protocol. +# Options for `set_password` specific to the VNC protocol. # # @display: The id of the display where the password should be # changed. Defaults to the first. @@ -77,8 +73,7 @@ =20 ## # @set_password: -# -# Set the password of a remote display server. +# Set the password of a remote display server. # # Errors: # - If Spice is not enabled, DeviceNotFound @@ -95,8 +90,7 @@ =20 ## # @ExpirePasswordOptions: -# -# General options for `expire_password`. +# General options for `expire_password`. # # @protocol: # - 'vnc' to modify the VNC server expiration @@ -125,8 +119,7 @@ =20 ## # @ExpirePasswordOptionsVnc: -# -# Options for `expire_password` specific to the VNC protocol. +# Options for `expire_password` specific to the VNC protocol. # # @display: The id of the display where the expiration should be # changed. Defaults to the first. @@ -138,8 +131,7 @@ =20 ## # @expire_password: -# -# Expire the password of a remote display server. +# Expire the password of a remote display server. # # Errors: # - If @protocol is 'spice' and Spice is not active, @@ -157,8 +149,7 @@ =20 ## # @ImageFormat: -# -# Supported image format types. +# Supported image format types. # # @png: PNG format # @@ -171,8 +162,7 @@ =20 ## # @screendump: -# -# Capture the contents of a screen and write it to a file. +# Capture the contents of a screen and write it to a file. # # @filename: the path of a new file to store the image # @@ -208,8 +198,7 @@ =20 ## # @SpiceBasicInfo: -# -# The basic information for SPICE network connection +# The basic information for SPICE network connection # # @host: IP address # @@ -227,8 +216,7 @@ =20 ## # @SpiceServerInfo: -# -# Information about a SPICE server +# Information about a SPICE server # # @auth: authentication method # @@ -241,8 +229,7 @@ =20 ## # @SpiceChannel: -# -# Information about a SPICE client channel. +# Information about a SPICE client channel. # # @connection-id: SPICE connection id number. All channels with the # same id belong to the same SPICE session. @@ -267,8 +254,7 @@ =20 ## # @SpiceQueryMouseMode: -# -# An enumeration of Spice mouse states. +# An enumeration of Spice mouse states. # # @client: Mouse cursor position is determined by the client. # @@ -285,8 +271,7 @@ =20 ## # @SpiceInfo: -# -# Information about the SPICE session. +# Information about the SPICE session. # # @enabled: true if the SPICE server is enabled, false otherwise # @@ -325,8 +310,7 @@ =20 ## # @query-spice: -# -# Return information about the current SPICE server +# Return information about the current SPICE server # # Since: 0.14 # @@ -370,8 +354,7 @@ =20 ## # @SPICE_CONNECTED: -# -# Emitted when a SPICE client establishes a connection +# Emitted when a SPICE client establishes a connection # # @server: server information # @@ -395,9 +378,8 @@ =20 ## # @SPICE_INITIALIZED: -# -# Emitted after initial handshake and authentication takes place (if -# any) and the SPICE channel is up and running +# Emitted after initial handshake and authentication takes place +# (if any) and the SPICE channel is up and running # # @server: server information # @@ -423,8 +405,7 @@ =20 ## # @SPICE_DISCONNECTED: -# -# Emitted when the SPICE connection is closed +# Emitted when the SPICE connection is closed # # @server: server information # @@ -448,8 +429,7 @@ =20 ## # @SPICE_MIGRATE_COMPLETED: -# -# Emitted when SPICE migration has completed +# Emitted when SPICE migration has completed # # Since: 1.3 # @@ -468,8 +448,7 @@ =20 ## # @VncBasicInfo: -# -# The basic information for vnc network connection +# The basic information for vnc network connection # # @host: IP address # @@ -492,8 +471,7 @@ =20 ## # @VncServerInfo: -# -# The network connection information for server +# The network connection information for server # # @auth: authentication method used for the plain (non-websocket) VNC # server @@ -507,8 +485,7 @@ =20 ## # @VncClientInfo: -# -# Information about a connected VNC client. +# Information about a connected VNC client. # # @x509_dname: If x509 authentication is in use, the Distinguished # Name of the client. @@ -525,8 +502,7 @@ =20 ## # @VncInfo: -# -# Information about the VNC session. +# Information about the VNC session. # # @enabled: true if the VNC server is enabled, false otherwise # @@ -576,8 +552,7 @@ =20 ## # @VncPrimaryAuth: -# -# vnc primary authentication method. +# vnc primary authentication method. # # Since: 2.3 ## @@ -588,8 +563,7 @@ =20 ## # @VncVencryptSubAuth: -# -# vnc sub authentication method with vencrypt. +# vnc sub authentication method with vencrypt. # # Since: 2.3 ## @@ -603,8 +577,7 @@ =20 ## # @VncServerInfo2: -# -# The network connection information for server +# The network connection information for server # # @auth: The current authentication type used by the servers # @@ -621,8 +594,7 @@ =20 ## # @VncInfo2: -# -# Information about a vnc server +# Information about a vnc server # # @id: vnc server name. # @@ -655,8 +627,7 @@ =20 ## # @query-vnc: -# -# Return information about the current VNC server +# Return information about the current VNC server # # Since: 0.14 # @@ -695,8 +666,7 @@ =20 ## # @change-vnc-password: -# -# Change the VNC server password. +# Change the VNC server password. # # @password: the new password to use with VNC authentication # @@ -712,8 +682,7 @@ =20 ## # @VNC_CONNECTED: -# -# Emitted when a VNC client establishes a connection +# Emitted when a VNC client establishes a connection # # @server: server information # @@ -741,9 +710,8 @@ =20 ## # @VNC_INITIALIZED: -# -# Emitted after authentication takes place (if any) and the VNC -# session is made active +# Emitted after authentication takes place (if any) and the VNC +# session is made active # # @server: server information # @@ -768,8 +736,7 @@ =20 ## # @VNC_DISCONNECTED: -# -# Emitted when the connection is closed +# Emitted when the connection is closed # # @server: server information # @@ -800,8 +767,7 @@ =20 ## # @MouseInfo: -# -# Information about a mouse device. +# Information about a mouse device. # # @name: the name of the mouse device # @@ -820,8 +786,7 @@ =20 ## # @query-mice: -# -# Return information about each active mouse device +# Return information about each active mouse device # # Returns: a list of info for each device # @@ -1005,8 +970,7 @@ =20 ## # @KeyValue: -# -# Represents a keyboard key. +# Represents a keyboard key. # # @type: key encoding # @@ -1021,8 +985,7 @@ =20 ## # @send-key: -# -# Send keys to guest. +# Send keys to guest. # # @keys: An array of `KeyValue` elements. All @KeyValues in this # array are simultaneously sent to the guest. A `KeyValue`.number @@ -1050,8 +1013,7 @@ =20 ## # @InputButton: -# -# Button of a pointer input device (mouse, tablet). +# Button of a pointer input device (mouse, tablet). # # @side: front side button of a 5-button mouse (since 2.9) # @@ -1067,8 +1029,7 @@ =20 ## # @InputAxis: -# -# Position axis of a pointer input device (mouse, tablet). +# Position axis of a pointer input device (mouse, tablet). # # Since: 2.0 ## @@ -1077,8 +1038,7 @@ =20 ## # @InputMultiTouchType: -# -# Type of a multi-touch event. +# Type of a multi-touch event. # # @begin: A new touch event sequence has just started. # @@ -1097,8 +1057,7 @@ =20 ## # @InputKeyEvent: -# -# Keyboard input event. +# Keyboard input event. # # @key: Which key this event is for. # @@ -1112,8 +1071,7 @@ =20 ## # @InputBtnEvent: -# -# Pointer button input event. +# Pointer button input event. # # @button: Which button this event is for. # @@ -1127,8 +1085,7 @@ =20 ## # @InputMoveEvent: -# -# Pointer motion input event. +# Pointer motion input event. # # @axis: Which axis is referenced by @value. # @@ -1143,8 +1100,7 @@ =20 ## # @InputMultiTouchEvent: -# -# MultiTouch input event. +# MultiTouch input event. # # @type: The type of multi-touch event. # @@ -1226,8 +1182,7 @@ =20 ## # @InputEvent: -# -# Input event union. +# Input event union. # # @type: the type of input event # @@ -1316,8 +1271,7 @@ =20 ## # @DisplayGTK: -# -# GTK display options. +# GTK display options. # # @clipboard: Enable host-guest clipboard sharing. Defaults to "off". # (Since 11.1) @@ -1357,8 +1311,7 @@ =20 ## # @DisplayEGLHeadless: -# -# EGL headless display options. +# EGL headless display options. # # @rendernode: Which DRM render node should be used. Default is the # first available node on the host. @@ -1370,8 +1323,7 @@ =20 ## # @DisplayDBus: -# -# DBus display options. +# DBus display options. # # @addr: The D-Bus bus address (default to the session bus). # @@ -1393,8 +1345,7 @@ =20 ## # @DisplayGLMode: -# -# Display OpenGL mode. +# Display OpenGL mode. # # @off: Disable OpenGL (default). # @@ -1413,8 +1364,7 @@ =20 ## # @DisplayCurses: -# -# Curses display options. +# Curses display options. # # @charset: Font charset used by guest (default: CP437). # @@ -1425,8 +1375,7 @@ =20 ## # @DisplayCocoa: -# -# Cocoa display options. +# Cocoa display options. # # @left-command-key: Enable/disable forwarding of left command key to # guest. Allows command-tab window switching on the host without @@ -1461,8 +1410,8 @@ =20 ## # @HotKeyMod: -# -# Set of modifier keys that need to be held for shortcut key actions. +# Set of modifier keys that need to be held for shortcut key +# actions. # # Since: 7.1 ## @@ -1471,8 +1420,7 @@ =20 ## # @DisplaySDL: -# -# SDL2 display options. +# SDL2 display options. # # @grab-mod: Modifier keys that should be pressed together with the # "G" key to release the mouse grab. @@ -1484,8 +1432,7 @@ =20 ## # @DisplayType: -# -# Display (user interface) type. +# Display (user interface) type. # # @default: The default user interface, selecting from the first # available of gtk, sdl, cocoa, and vnc. @@ -1535,8 +1482,7 @@ =20 ## # @DisplayOptions: -# -# Display (user interface) options. +# Display (user interface) options. # # @type: Which `DisplayType` QEMU should use. # @@ -1573,8 +1519,7 @@ =20 ## # @query-display-options: -# -# Return information about display configuration +# Return information about display configuration # # Since: 3.1 ## @@ -1583,8 +1528,7 @@ =20 ## # @DisplayReloadType: -# -# Available DisplayReload types. +# Available DisplayReload types. # # @vnc: VNC display # @@ -1595,8 +1539,7 @@ =20 ## # @DisplayReloadOptionsVNC: -# -# Specify the VNC reload options. +# Specify the VNC reload options. # # @tls-certs: reload tls certs or not. # @@ -1607,8 +1550,7 @@ =20 ## # @DisplayReloadOptions: -# -# Options of the display configuration reload. +# Options of the display configuration reload. # # @type: Specify the display type. # @@ -1621,8 +1563,7 @@ =20 ## # @display-reload: -# -# Reload display configuration. +# Reload display configuration. # # Since: 6.0 # @@ -1638,8 +1579,7 @@ =20 ## # @DisplayUpdateType: -# -# Available DisplayUpdate types. +# Available DisplayUpdate types. # # @vnc: VNC display # @@ -1650,8 +1590,7 @@ =20 ## # @DisplayUpdateOptionsVNC: -# -# Specify the VNC reload options. +# Specify the VNC reload options. # # @addresses: If specified, change set of addresses to listen for # connections. Addresses configured for websockets are not @@ -1664,8 +1603,7 @@ =20 ## # @DisplayUpdateOptions: -# -# Options of the display configuration reload. +# Options of the display configuration reload. # # @type: Specify the display type. # @@ -1678,8 +1616,7 @@ =20 ## # @display-update: -# -# Update display configuration. +# Update display configuration. # # Since: 7.1 # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788207985; cv=none; d=zohomail.com; s=zohoarc; b=jtkmLz8qBw9iFeaXOPF32UMxcBvaO9JR9C61+20BD9D3gzf9qm/ZiJVN7FqP25mgEyDd7ErcqgekOCpGz2DoHnN794jiuXHEwM6VOy13BJ0pPYpXjaufXaA0gNfqtv2YtP8WoLEB9pA2mgZC7NkprlHBWJDiaiCBN3qXxXCTQWg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788207985; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=guCLIzVmZrZpBJXqrS2tsFbY+MWTzN+mPMblZhwoDNA=; b=bCOZfs2IpLt6Xtp8fokMzsWrr5pbeZaZDuLJRKsxTYFY8USRpm5pHnAL+qed9JNxWbyt/9Qnz1+J0Aolgdz3Upr7Cu9S5lTRX4otdxUSYfTyE4rzxKUhJ3VGw3Ef/4o8Fqz9JmMvhk/uw7B0rcDml37hJuMNA073g14ce1Qg/Dg= 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 1788207985354824.5035782783785; Mon, 31 Aug 2026 13:26:25 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18Zr-0006Ls-Kx; Mon, 31 Aug 2026 16:25:59 -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 1x18Zp-0006Bh-BM for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:57 -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 1x18Zl-0000cI-H1 for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:25:57 -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-653-pdRSia-wNCWdmBDW_X-1mw-1; Mon, 31 Aug 2026 16:25:48 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2E08C19792FE; Mon, 31 Aug 2026 20:25:46 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id CAD251800577; Mon, 31 Aug 2026 20:25:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207952; 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=guCLIzVmZrZpBJXqrS2tsFbY+MWTzN+mPMblZhwoDNA=; b=Z39rWj4Xz2Zdcm8SAWOqIAhZ1XsamsumnPeAwI2YWVsY43ZzZfdA7w1sW2jbshbF2py3QD mSADJ7l36oG5XEghrsJYZUC7xVgDdG/pNMyIAXo1NgJNaKMEQmUfHLvDYGb0K0z2AE5X7R 9qGda0/MklP+vQJxu6nPkdTKVM8DO4k= X-MC-Unique: pdRSia-wNCWdmBDW_X-1mw-1 X-Mimecast-MFC-AGG-ID: pdRSia-wNCWdmBDW_X-1mw_1788207946 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 41/43] qapi: convert trivial intro sections for migration.json Date: Mon, 31 Aug 2026 16:19:43 -0400 Message-ID: <20260831201945.287730-42-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=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: 1788207985986154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/migration.json | 131 ++++++++++++++++---------------------------- 1 file changed, 48 insertions(+), 83 deletions(-) diff --git a/qapi/migration.json b/qapi/migration.json index b1eaf7b0545..8b6abcee2ca 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -13,8 +13,7 @@ =20 ## # @MigrationRAMStats: -# -# Detailed migration status. +# Detailed migration status. # # @transferred: amount of bytes already transferred to the target VM # @@ -78,8 +77,7 @@ =20 ## # @XBZRLECacheStats: -# -# Detailed XBZRLE migration cache statistics +# Detailed XBZRLE migration cache statistics # # @cache-size: XBZRLE cache size # @@ -104,8 +102,7 @@ =20 ## # @CompressionStats: -# -# Detailed migration compression statistics +# Detailed migration compression statistics # # @pages: amount of pages compressed and transferred to the target VM # @@ -126,8 +123,7 @@ =20 ## # @MigrationStatus: -# -# An enumeration of migration status. +# An enumeration of migration status. # # @none: no migration has ever happened. # @@ -189,8 +185,7 @@ =20 ## # @VfioStats: -# -# Detailed VFIO devices migration statistics +# Detailed VFIO devices migration statistics # # @transferred: amount of bytes transferred to the target VM by VFIO # devices @@ -202,8 +197,7 @@ =20 ## # @MigrationInfo: -# -# Information about current migration process. +# Information about current migration process. # # @status: `MigrationStatus` describing the current migration status. # If this field is not returned, no migration process has been @@ -435,8 +429,7 @@ =20 ## # @MigrationCapability: -# -# Migration capabilities enumeration +# Migration capabilities enumeration # # @xbzrle: Migration supports xbzrle (Xor Based Zero Run Length # Encoding). This feature allows us to minimize migration traffic @@ -545,8 +538,7 @@ =20 ## # @MigrationCapabilityStatus: -# -# Migration capability information +# Migration capability information # # @capability: capability enum # @@ -559,8 +551,8 @@ =20 ## # @migrate-set-capabilities: -# -# Enable/Disable the following migration capabilities (like xbzrle) +# Enable/Disable the following migration capabilities (like +# xbzrle) # # @capabilities: json array of capability modifications to make # @@ -577,8 +569,8 @@ =20 ## # @query-migrate-capabilities: -# -# Return information about the current migration capabilities status +# Return information about the current migration capabilities +# status # # Since: 1.2 # @@ -598,8 +590,7 @@ =20 ## # @MultiFDCompression: -# -# An enumeration of multifd compression methods. +# An enumeration of multifd compression methods. # # @none: no compression. # @@ -776,9 +767,8 @@ =20 ## # @BitmapMigrationNodeAlias: -# -# Maps a block node name and the bitmaps it has to aliases for dirty -# bitmap migration. +# Maps a block node name and the bitmaps it has to aliases for +# dirty bitmap migration. # # @node-name: A block node name. # @@ -1098,8 +1088,7 @@ =20 ## # @MIGRATION: -# -# Emitted when a migration event happens +# Emitted when a migration event happens # # @status: `MigrationStatus` describing the current migration status. # @@ -1116,9 +1105,8 @@ =20 ## # @MIGRATION_PASS: -# -# Emitted from the source side of a migration at the start of each -# pass (when it syncs the dirty bitmap) +# Emitted from the source side of a migration at the start of each +# pass (when it syncs the dirty bitmap) # # @pass: An incrementing count (starting at 1 on the first pass) # @@ -1134,8 +1122,8 @@ =20 ## # @COLOMessage: -# -# The message transmission between Primary side and Secondary side. +# The message transmission between Primary side and Secondary +# side. # # @checkpoint-ready: Secondary VM (SVM) is ready for checkpointing # @@ -1161,8 +1149,7 @@ =20 ## # @COLOMode: -# -# The COLO current mode. +# The COLO current mode. # # @none: COLO is disabled. # @@ -1177,8 +1164,7 @@ =20 ## # @FailoverStatus: -# -# An enumeration of COLO failover status +# An enumeration of COLO failover status # # @none: no failover has ever happened # @@ -1198,9 +1184,8 @@ =20 ## # @COLO_EXIT: -# -# Emitted when VM finishes COLO mode due to some errors happening or -# at the request of users. +# Emitted when VM finishes COLO mode due to some errors happening +# or at the request of users. # # @mode: report COLO mode when COLO exited. # @@ -1218,8 +1203,7 @@ =20 ## # @COLOExitReason: -# -# The reason for a COLO exit. +# The reason for a COLO exit. # # @none: failover has never happened. This state does not occur in # the `COLO_EXIT` event, and is only visible in the result of @@ -1281,8 +1265,7 @@ =20 ## # @migrate-continue: -# -# Continue migration when it's in a paused state. +# Continue migration when it's in a paused state. # # @state: The state the migration is currently expected to be in # @@ -1298,8 +1281,7 @@ =20 ## # @MigrationAddressType: -# -# The migration stream transport mechanisms. +# The migration stream transport mechanisms. # # @socket: Migrate via socket. # @@ -1339,8 +1321,7 @@ =20 ## # @MigrationAddress: -# -# Migration endpoint configuration. +# Migration endpoint configuration. # # @transport: The migration stream transport mechanism # @@ -1357,8 +1338,7 @@ =20 ## # @MigrationChannelType: -# -# The migration channel-type request options. +# The migration channel-type request options. # # @main: Main outbound migration channel. # @@ -1371,8 +1351,7 @@ =20 ## # @MigrationChannel: -# -# Migration stream channel parameters. +# Migration stream channel parameters. # # @channel-type: Channel type for transferring packet information. # @@ -1387,8 +1366,7 @@ =20 ## # @migrate: -# -# Migrates the current running guest to another Virtual Machine. +# Migrates the current running guest to another Virtual Machine. # # @uri: the Uniform Resource Identifier of the destination VM # @@ -1560,8 +1538,7 @@ =20 ## # @xen-set-global-dirty-log: -# -# Enable or disable the global dirty log mode. +# Enable or disable the global dirty log mode. # # @enable: true to enable, false to disable. # @@ -1597,8 +1574,7 @@ =20 ## # @xen-set-replication: -# -# Enable or disable replication. +# Enable or disable replication. # # @enable: true to enable, false to disable. # @@ -1621,8 +1597,7 @@ =20 ## # @ReplicationStatus: -# -# The result format for `query-xen-replication-status`. +# The result format for `query-xen-replication-status`. # # @error: true if an error happened, false if replication is normal. # @@ -1670,8 +1645,7 @@ =20 ## # @COLOStatus: -# -# The result format for `query-colo-status`. +# The result format for `query-colo-status`. # # @mode: COLO running mode. If COLO is running, this field will # return 'primary' or 'secondary'. @@ -1709,8 +1683,7 @@ =20 ## # @migrate-recover: -# -# Provide a recovery migration stream URI. +# Provide a recovery migration stream URI. # # @uri: the URI to be used for the recovery of migration stream. # @@ -1763,8 +1736,7 @@ =20 ## # @DirtyRateVcpu: -# -# Dirty rate of vcpu. +# Dirty rate of vcpu. # # @id: vcpu index. # @@ -1777,8 +1749,7 @@ =20 ## # @DirtyRateStatus: -# -# Dirty page rate measurement status. +# Dirty page rate measurement status. # # @unstarted: measuring thread has not been started yet # @@ -1810,8 +1781,7 @@ =20 ## # @TimeUnit: -# -# Specifies unit in which time-related value is specified. +# Specifies unit in which time-related value is specified. # # @second: value is in seconds # @@ -1824,8 +1794,7 @@ =20 ## # @DirtyRateInfo: -# -# Information about measured dirty page rate. +# Information about measured dirty page rate. # # @dirty-rate: an estimate of the dirty page rate of the VM in units # of MiB/s. Value is present only when @status is 'measured'. @@ -1935,8 +1904,8 @@ =20 ## # @query-dirty-rate: -# -# Query results of the most recent invocation of `calc-dirty-rate`. +# Query results of the most recent invocation of +# `calc-dirty-rate`. # # @calc-time-unit: time unit in which to report calculation time. # By default it is reported in seconds. (Since 8.2) @@ -1962,8 +1931,7 @@ =20 ## # @DirtyLimitInfo: -# -# Dirty page rate limit information of a virtual CPU. +# Dirty page rate limit information of a virtual CPU. # # @cpu-index: index of a virtual CPU. # @@ -2029,8 +1997,8 @@ =20 ## # @query-vcpu-dirty-limit: -# -# Return information about virtual CPU dirty page rate limits, if any. +# Return information about virtual CPU dirty page rate limits, if +# any. # # Since: 7.1 # @@ -2046,8 +2014,7 @@ =20 ## # @snapshot-save: -# -# Save a VM snapshot +# Save a VM snapshot # # @job-id: identifier for the newly created job # @@ -2118,8 +2085,7 @@ =20 ## # @snapshot-load: -# -# Load a VM snapshot +# Load a VM snapshot # # @job-id: identifier for the newly created job # @@ -2188,8 +2154,7 @@ =20 ## # @snapshot-delete: -# -# Delete a VM snapshot +# Delete a VM snapshot # # @job-id: identifier for the newly created job # --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788208000; cv=none; d=zohomail.com; s=zohoarc; b=Px0uxaZd99aeXCyX/JgEn2v3ubyG9ZKQ7E7q0mY/N36O7BYiwMr363KuJaFhwfhi152Nr5gsEzMgb00vca4wsOmL9NjidYXSenuj/kHwJl5Nggz6PwkYMozKtOmu2bg5u5QgG3lIDqPaqX2VSLNzD2S1UaEEemSl0Q8ohCGjC3s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788208000; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=2Qki3202jzB0uNmrJ8G0JeNCMEhWZDtvlbuFVuOEQck=; b=YnZpQKVwuRoiTN+tx56iyqpbFez4yajVkzHC+zs893cLtvBT1DQZklIBbBFiSs932pmVumDjfJNoVbhyrw+3slcJJq7ce2QGmc0AatvGmw+9fpanj19ooKN1tP/MIGv3xgeMcgzhrnl9Dr78fiSVnwRy/Lq5BP5AKQVzOOz8ymg= 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 1788208000360877.0477658526564; Mon, 31 Aug 2026 13:26:40 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18a6-0006oQ-IF; Mon, 31 Aug 2026 16:26:14 -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 1x18Zz-0006hC-8I for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:26:07 -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 1x18Zv-0000f7-3k for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:26:06 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-674-MuUPaqfNOUOTxF0dYeKCsQ-1; Mon, 31 Aug 2026 16:25:56 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 5B299184A09B; Mon, 31 Aug 2026 20:25:53 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6340018005AC; Mon, 31 Aug 2026 20:25:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207962; 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=2Qki3202jzB0uNmrJ8G0JeNCMEhWZDtvlbuFVuOEQck=; b=icHkrofQwWTNA32Xh+o+NxF3aIVp+UVpCqDsDzw4tir6bqnleIKL42miPvIPMp6SvMKTiV 8ODBwCWo9IlwpT8TJUBd5BKAsQ/02ytRjAGSqAPOP7I/xGLNqBk/9SAyK5HGAhpXl7qxQ6 uZzgqgwHzd1GKNkUYIUsu6QbzTURy4s= X-MC-Unique: MuUPaqfNOUOTxF0dYeKCsQ-1 X-Mimecast-MFC-AGG-ID: MuUPaqfNOUOTxF0dYeKCsQ_1788207953 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 42/43] qapi: convert trivial intro sections for machine.json Date: Mon, 31 Aug 2026 16:19:44 -0400 Message-ID: <20260831201945.287730-43-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788208001524158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine.json | 195 ++++++++++++++++------------------------------ 1 file changed, 68 insertions(+), 127 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 2d63c1bac3b..8ef12504d65 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -46,9 +46,8 @@ =20 ## # @S390CpuState: -# -# An enumeration of cpu states that can be assumed by a virtual S390 -# CPU +# An enumeration of cpu states that can be assumed by a virtual +# S390 CPU # # Since: 2.12 ## @@ -57,8 +56,7 @@ =20 ## # @CpuInfoS390: -# -# Additional information about a virtual S390 CPU +# Additional information about a virtual S390 CPU # # @cpu-state: the virtual CPU's state # @@ -75,8 +73,7 @@ =20 ## # @CpuInfoFast: -# -# Information about a virtual CPU +# Information about a virtual CPU # # @cpu-index: index of the virtual CPU # @@ -105,8 +102,7 @@ =20 ## # @query-cpus-fast: -# -# Return information about all virtual CPUs. +# Return information about all virtual CPUs. # # Since: 2.12 # @@ -143,9 +139,8 @@ =20 ## # @CompatProperty: -# -# Property default values specific to a machine type, for use by -# scripts/compare-machine-types. +# Property default values specific to a machine type, for use by +# scripts/compare-machine-types. # # @qom-type: name of the QOM type to which the default applies # @@ -163,8 +158,7 @@ =20 ## # @MachineInfo: -# -# Information describing a machine. +# Information describing a machine. # # @name: the name of the machine # @@ -213,8 +207,7 @@ =20 ## # @query-machines: -# -# Return a list of supported machines +# Return a list of supported machines # # @compat-props: if true, also return compatibility properties. # (default: false) (since 9.1) @@ -255,8 +248,7 @@ =20 ## # @CurrentMachineParams: -# -# Information describing the running machine parameters. +# Information describing the running machine parameters. # # @wakeup-suspend-support: true if the machine supports wake up from # suspend @@ -268,8 +260,7 @@ =20 ## # @query-current-machine: -# -# Return information on the current virtual machine. +# Return information on the current virtual machine. # # Since: 4.0 ## @@ -277,8 +268,8 @@ =20 ## # @QemuTargetInfo: -# -# Information on the target configuration built into the QEMU binary. +# Information on the target configuration built into the QEMU +# binary. # # @arch: the target architecture # @@ -289,8 +280,7 @@ =20 ## # @query-target: -# -# Return information about the target for this QEMU +# Return information about the target for this QEMU # # Since: 1.2 ## @@ -298,8 +288,7 @@ =20 ## # @UuidInfo: -# -# Guest UUID information (Universally Unique Identifier). +# Guest UUID information (Universally Unique Identifier). # # @UUID: the UUID of the guest # @@ -312,8 +301,7 @@ =20 ## # @query-uuid: -# -# Query the guest UUID information. +# Query the guest UUID information. # # Since: 0.14 # @@ -326,8 +314,7 @@ =20 ## # @GuidInfo: -# -# GUID information. +# GUID information. # # @guid: the globally unique identifier # @@ -337,8 +324,7 @@ =20 ## # @query-vm-generation-id: -# -# Show Virtual Machine Generation ID +# Show Virtual Machine Generation ID # # Since: 2.9 ## @@ -346,8 +332,7 @@ =20 ## # @system_reset: -# -# Performs a hard reset of a guest. +# Performs a hard reset of a guest. # # Since: 0.14 # @@ -360,8 +345,7 @@ =20 ## # @system_powerdown: -# -# Requests that a guest perform a powerdown operation. +# Requests that a guest perform a powerdown operation. # # Since: 0.14 # @@ -521,8 +505,7 @@ =20 ## # @NumaDistOptions: -# -# Set the distance between 2 NUMA nodes. +# Set the distance between 2 NUMA nodes. # # @src: source NUMA node. # @@ -542,8 +525,7 @@ =20 ## # @CXLFixedMemoryWindowOptions: -# -# Create a CXL Fixed Memory Window +# Create a CXL Fixed Memory Window # # @size: Size of the Fixed Memory Window in bytes. Must be a multiple # of 256MiB. @@ -565,8 +547,7 @@ =20 ## # @CXLFMWProperties: -# -# List of CXL Fixed Memory Windows. +# List of CXL Fixed Memory Windows. # # @cxl-fmw: List of `CXLFixedMemoryWindowOptions` # @@ -578,8 +559,7 @@ =20 ## # @X86CPURegister32: -# -# A X86 32-bit register +# A X86 32-bit register # # Since: 1.5 ## @@ -588,8 +568,7 @@ =20 ## # @X86CPUFeatureWordInfo: -# -# Information about a X86 CPU feature word +# Information about a X86 CPU feature word # # @cpuid-input-eax: Input EAX value for CPUID instruction for that # feature word @@ -611,9 +590,8 @@ =20 ## # @DummyForceArrays: -# -# Not used by QMP; hack to let us use X86CPUFeatureWordInfoList -# internally +# Not used by QMP; hack to let us use X86CPUFeatureWordInfoList +# internally # # Since: 2.5 ## @@ -795,8 +773,7 @@ =20 ## # @memsave: -# -# Save a portion of guest memory to a file. +# Save a portion of guest memory to a file. # # @val: the virtual address of the guest to start from # @@ -828,8 +805,7 @@ =20 ## # @pmemsave: -# -# Save a portion of guest physical memory to a file. +# Save a portion of guest physical memory to a file. # # @val: the physical address of the guest to start from # @@ -857,8 +833,7 @@ =20 ## # @Memdev: -# -# Information about memory backend +# Information about memory backend # # @id: backend's ID if backend has 'id' property (since 2.9) # @@ -898,8 +873,7 @@ =20 ## # @query-memdev: -# -# Return information for all memory backends. +# Return information for all memory backends. # # Since: 2.1 # @@ -1074,9 +1048,9 @@ =20 ## # @set-numa-node: -# -# Runtime equivalent of '-numa' CLI option, available at preconfigure -# stage to configure numa mapping before initializing machine. +# Runtime equivalent of '-numa' CLI option, available at +# preconfigure stage to configure numa mapping before initializing +# machine. # # Since: 3.0 ## @@ -1087,8 +1061,7 @@ =20 ## # @balloon: -# -# Request the balloon driver to change its balloon size. +# Request the balloon driver to change its balloon size. # # @value: the target logical size of the VM in bytes. We can deduce # the size of the balloon using this formula: @@ -1122,8 +1095,7 @@ =20 ## # @BalloonInfo: -# -# Information about the guest balloon device. +# Information about the guest balloon device. # # @actual: the logical size of the VM in bytes. Formula used: # logical_vm_size =3D vm_ram_size - balloon_size @@ -1134,8 +1106,7 @@ =20 ## # @query-balloon: -# -# Return information about the balloon device. +# Return information about the balloon device. # # Errors: # - If the balloon driver is enabled but not functional because @@ -1179,8 +1150,7 @@ =20 ## # @HvBalloonInfo: -# -# hv-balloon guest-provided memory status information. +# hv-balloon guest-provided memory status information. # # @committed: the amount of memory in use inside the guest plus the # amount of the memory unusable inside the guest (ballooned out, @@ -1196,9 +1166,8 @@ =20 ## # @query-hv-balloon-status-report: -# -# Return the hv-balloon driver data contained in the last received -# "STATUS" message from the guest. +# Return the hv-balloon driver data contained in the last received +# "STATUS" message from the guest. # # Errors: # - If no hv-balloon device is present, guest memory status @@ -1239,8 +1208,7 @@ =20 ## # @MemoryInfo: -# -# Actual memory information in bytes. +# Actual memory information in bytes. # # @base-memory: size of "base" memory specified with command line # option -m. @@ -1273,8 +1241,7 @@ =20 ## # @PCDIMMDeviceInfo: -# -# PCDIMMDevice state information +# PCDIMMDevice state information # # @id: device's ID # @@ -1309,8 +1276,7 @@ =20 ## # @VirtioPMEMDeviceInfo: -# -# VirtioPMEM state information +# VirtioPMEM state information # # @id: device's ID # @@ -1332,8 +1298,7 @@ =20 ## # @VirtioMEMDeviceInfo: -# -# VirtioMEMDevice state information +# VirtioMEMDevice state information # # @id: device's ID # @@ -1367,8 +1332,7 @@ =20 ## # @SgxEPCDeviceInfo: -# -# Sgx EPC state information +# Sgx EPC state information # # @id: device's ID # @@ -1393,8 +1357,7 @@ =20 ## # @HvBalloonDeviceInfo: -# -# hv-balloon provided memory state information +# hv-balloon provided memory state information # # @id: device's ID # @@ -1523,8 +1486,7 @@ =20 ## # @MemoryDeviceInfo: -# -# Union containing information about a memory device +# Union containing information about a memory device # # @type: memory device type # @@ -1545,8 +1507,7 @@ =20 ## # @SgxEPC: -# -# Sgx EPC cmdline information +# Sgx EPC cmdline information # # @memdev: memory backend linked with device # @@ -1562,8 +1523,7 @@ =20 ## # @SgxEPCProperties: -# -# SGX properties of machine types. +# SGX properties of machine types. # # @sgx-epc: list of ids of memory-backend-epc objects. # @@ -1575,8 +1535,7 @@ =20 ## # @query-memory-devices: -# -# Lists available memory devices and their state +# Lists available memory devices and their state # # Since: 2.1 # @@ -1626,8 +1585,7 @@ =20 ## # @BootConfiguration: -# -# Schema for virtual machine boot configuration. +# Schema for virtual machine boot configuration. # # @order: Boot order (a=3Dfloppy, c=3Dhard disk, d=3DCD-ROM, n=3Dnetwork) # @@ -1711,8 +1669,7 @@ =20 ## # @x-query-irq: -# -# Query interrupt statistics +# Query interrupt statistics # # Features: # @@ -1728,8 +1685,7 @@ =20 ## # @x-query-jit: -# -# Query TCG compiler statistics +# Query TCG compiler statistics # # Features: # @@ -1746,8 +1702,7 @@ =20 ## # @x-query-numa: -# -# Query NUMA topology information +# Query NUMA topology information # # Features: # @@ -1763,8 +1718,7 @@ =20 ## # @x-query-ramblock: -# -# Query system ramblock information +# Query system ramblock information # # Features: # @@ -1780,8 +1734,7 @@ =20 ## # @x-query-roms: -# -# Query information on the registered ROMS +# Query information on the registered ROMS # # Features: # @@ -1797,8 +1750,7 @@ =20 ## # @x-query-usb: -# -# Query information on the USB devices +# Query information on the USB devices # # Features: # @@ -1829,8 +1781,7 @@ =20 ## # @MemorySizeConfiguration: -# -# Schema for memory size configuration. +# Schema for memory size configuration. # # @size: memory size in bytes # @@ -1847,8 +1798,7 @@ =20 ## # @dumpdtb: -# -# Save the FDT in dtb format. +# Save the FDT in dtb format. # # @filename: name of the dtb file to be created # @@ -1866,8 +1816,7 @@ =20 ## # @x-query-interrupt-controllers: -# -# Query information on interrupt controller devices +# Query information on interrupt controller devices # # Features: # @@ -1897,8 +1846,7 @@ =20 ## # @query-firmware-log: -# -# Find firmware memory log buffer in guest memory, return content. +# Find firmware memory log buffer in guest memory, return content. # # @max-size: limit the amount of log data returned. Up to 1 MiB of # log data is allowed. In case the amount of log data is larger @@ -1912,8 +1860,7 @@ =20 ## # @dump-skeys: -# -# Dump the storage keys for an s390x guest +# Dump the storage keys for an s390x guest # # @filename: the path to the file to dump to # @@ -1951,8 +1898,7 @@ =20 ## # @CpuModelExpansionType: -# -# An enumeration of CPU model expansion types. +# An enumeration of CPU model expansion types. # # @static: Expand to a static CPU model, a combination of a static # base model name and property delta changes. As the static base @@ -2009,8 +1955,7 @@ =20 ## # @CpuModelBaselineInfo: -# -# The result of a CPU model baseline. +# The result of a CPU model baseline. # # @model: the baselined `CpuModelInfo`. # @@ -2021,8 +1966,7 @@ =20 ## # @CpuModelCompareInfo: -# -# The result of a CPU model comparison. +# The result of a CPU model comparison. # # @result: The result of the compare operation. # @@ -2153,8 +2097,7 @@ =20 ## # @CpuModelExpansionInfo: -# -# The result of a cpu model expansion. +# The result of a cpu model expansion. # # @model: the expanded `CpuModelInfo`. # @@ -2223,8 +2166,7 @@ =20 ## # @CpuDefinitionInfo: -# -# Virtual CPU definition. +# Virtual CPU definition. # # @name: the name of the CPU definition # @@ -2285,8 +2227,7 @@ =20 ## # @query-cpu-definitions: -# -# Return a list of supported virtual CPU definitions +# Return a list of supported virtual CPU definitions # # Since: 1.2 ## --=20 2.55.0 From nobody Sat Sep 26 20:50:47 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=1788208024; cv=none; d=zohomail.com; s=zohoarc; b=DYOdHLuPy5hatLwdGCVPHqBmYZcNhXyrRxw+N0fnd9fNLxH4FEizyWzBlbkZWT2NxaXNNjpEYa4x5pB4EeWs9F+wgRr2dptY/HKseh4t2S/DXsqxPEQQNcN76K+GysgcmhFQY9QEqWCmrD6UjabKtg+UxSckGVIOjdpl7ccs/2s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1788208024; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=6dmwLJ1r1XAn3heZnC7B+Oex/p3Q4OgxwaiHszUOaHE=; b=N5MilNOhZHaSACm1atpQhMCZUeaaA0bLzOWW+sBBvXOscVIIcFCyxicW6rqOIqQhZ0ArAWvkxDwMkCco/s0dh8j8d1VG5Bpk0GPAwZb52wiCrPdCaaSmvPxS21/gxIViiLiI4Er475sxVFI5QbikZSWodUGu7jJffOodGK+/Y/o= 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 178820802410428.99845709891747; Mon, 31 Aug 2026 13:27:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x18aE-0007Dd-40; Mon, 31 Aug 2026 16:26: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 1x18a6-0006xI-NN for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:26:14 -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 1x18a1-0000gu-TP for qemu-devel@nongnu.org; Mon, 31 Aug 2026 16:26:13 -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-78-Hps4sIpBP-K7zo0bGUVsYA-1; Mon, 31 Aug 2026 16:26:05 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 077AC1955F13; Mon, 31 Aug 2026 20:26:02 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.63]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 78BF918005AD; Mon, 31 Aug 2026 20:25:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1788207969; 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=6dmwLJ1r1XAn3heZnC7B+Oex/p3Q4OgxwaiHszUOaHE=; b=W05KGBX5W5MVmWDSQhPQkjy6aa5nIDZC30Q7SgtvhWT6M6JfcsRpXtv4AdmUhuk/Zg95Hj OwUAFbugi2xNYSAfjvbPdhKOWbi2p3Uyw8W2n9C7Qomcq3Mu0iIri2k3eFGA016FHh3lKl dgPNiWfJS1DfFKTop5l923dgRDAPjjo= X-MC-Unique: Hps4sIpBP-K7zo0bGUVsYA-1 X-Mimecast-MFC-AGG-ID: Hps4sIpBP-K7zo0bGUVsYA_1788207962 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Lukas Straub , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Richard Henderson , zhenwei pi , Jonathan Cameron , Paolo Bonzini , Stefan Hajnoczi , Markus Armbruster , Vladimir Sementsov-Ogievskiy , Jiri Pirko , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, Ani Sinha , Jason Wang , linux-cxl@vger.kernel.org, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Igor Mammedov , Hanna Reitz , Alex Williamson , Stefan Berger , "Michael S. Tsirkin" , Laurent Vivier , linux-edac@vger.kernel.org, Michael Tokarev , John Snow , Fabiano Rosas , Zhao Liu , "Gonglei (Arei)" , Eric Blake , Peter Xu , Gerd Hoffmann , Kevin Wolf , Mauro Carvalho Chehab , qemu-trivial@nongnu.org, =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v4 43/43] qapi: convert trivial intro sections for block-core.json Date: Mon, 31 Aug 2026 16:19:45 -0400 Message-ID: <20260831201945.287730-44-jsnow@redhat.com> In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com> References: <20260831201945.287730-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.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: 1788208026602154101 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block-core.json | 431 ++++++++++++++++--------------------------- 1 file changed, 157 insertions(+), 274 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index 199efc1e008..33e1147792b 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -132,8 +132,7 @@ =20 ## # @VmdkExtentInfo: -# -# Information about a VMDK extent file +# Information about a VMDK extent file # # @filename: Name of the extent file # @@ -257,9 +256,8 @@ =20 ## # @ImageInfoSpecific: -# -# A discriminated record of image format specific information -# structures. +# A discriminated record of image format specific information +# structures. # # @type: block driver name # @@ -341,8 +339,7 @@ =20 ## # @BlockNodeInfo: -# -# Information about a QEMU image file +# Information about a QEMU image file # # @filename: name of the image file # @@ -386,9 +383,8 @@ =20 ## # @ImageInfo: -# -# Information about a QEMU image file, and potentially its backing -# image +# Information about a QEMU image file, and potentially its backing +# image # # @backing-image: info of the backing image # @@ -402,10 +398,9 @@ =20 ## # @BlockChildInfo: -# -# Information about all nodes in the block graph starting at some -# node, annotated with information about that node in relation to its -# parent. +# Information about all nodes in the block graph starting at some +# node, annotated with information about that node in relation to +# its parent. # # @name: Child name of the root node in the `BlockGraphInfo` struct, # in its role as the child of some undescribed parent node @@ -437,8 +432,7 @@ =20 ## # @ImageCheck: -# -# Information about a QEMU image file check +# Information about a QEMU image file check # # @filename: name of the image file checked # @@ -481,8 +475,8 @@ =20 ## # @MapEntry: -# -# Mapping information from a virtual block range to a host file range +# Mapping information from a virtual block range to a host file +# range # # @start: virtual (guest) offset of the first byte described by this # entry @@ -520,8 +514,7 @@ =20 ## # @BlockdevCacheInfo: -# -# Cache mode information for a block device +# Cache mode information for a block device # # @writeback: true if writeback mode is enabled # @@ -551,8 +544,7 @@ =20 ## # @BlockDeviceInfo: -# -# Information about the backing device for a block device. +# Information about the backing device for a block device. # # @file: the filename of the backing device # @@ -668,8 +660,7 @@ =20 ## # @BlockDeviceIoStatus: -# -# An enumeration of block device I/O status. +# An enumeration of block device I/O status. # # @ok: The last I/O operation has succeeded # @@ -684,8 +675,7 @@ =20 ## # @BlockDirtyInfo: -# -# Block dirty bitmap information. +# Block dirty bitmap information. # # @name: the name of the dirty bitmap (Since 2.4) # @@ -717,8 +707,7 @@ =20 ## # @Qcow2BitmapInfoFlags: -# -# An enumeration of flags that a bitmap can report to the user. +# An enumeration of flags that a bitmap can report to the user. # # @in-use: This flag is set by any process actively modifying the # qcow2 file, and cleared when the updated bitmap is flushed to @@ -736,8 +725,7 @@ =20 ## # @Qcow2BitmapInfo: -# -# Qcow2 bitmap information. +# Qcow2 bitmap information. # # @name: the name of the bitmap # @@ -753,8 +741,7 @@ =20 ## # @BlockLatencyHistogramInfo: -# -# Block latency histogram. +# Block latency histogram. # # @boundaries: list of interval boundary values in nanoseconds, all # greater than zero and in ascending order. For example, the list @@ -852,8 +839,7 @@ =20 ## # @query-block: -# -# Get a list of `BlockInfo` for all virtual block devices. +# Get a list of `BlockInfo` for all virtual block devices. # # @flat: Omit nested data about the backing image, i.e. `BlockInfo` # member 'inserted.image.backing-image' will be absent. @@ -954,8 +940,7 @@ =20 ## # @BlockDeviceTimedStats: -# -# Statistics of a block device during a given interval of time. +# Statistics of a block device during a given interval of time. # # @interval_length: Interval used for calculating the statistics, in # seconds. @@ -1021,8 +1006,7 @@ =20 ## # @BlockDeviceStats: -# -# Statistics of a virtual block device or a block backing device. +# Statistics of a virtual block device or a block backing device. # # @rd_bytes: The number of bytes read by the device. # @@ -1160,8 +1144,7 @@ =20 ## # @BlockStatsSpecificFile: -# -# File driver statistics +# File driver statistics # # @discard-nb-ok: The number of successful discard operations # performed by the driver. @@ -1181,8 +1164,7 @@ =20 ## # @BlockStatsSpecificNvme: -# -# NVMe driver statistics +# NVMe driver statistics # # @completion-errors: The number of completion errors. # @@ -1202,8 +1184,7 @@ =20 ## # @BlockStatsSpecific: -# -# Block driver specific statistics +# Block driver specific statistics # # @driver: block driver name # @@ -1220,8 +1201,7 @@ =20 ## # @BlockStats: -# -# Statistics of a virtual block device or a block backing device. +# Statistics of a virtual block device or a block backing device. # # @device: If the stats are for a virtual block device, the name # corresponding to the virtual block device. @@ -1254,8 +1234,7 @@ =20 ## # @query-blockstats: -# -# Query the `BlockStats` for all virtual block devices. +# Query the `BlockStats` for all virtual block devices. # # @query-nodes: If true, the command will query all the block nodes # that have a node name, in a list which will include "parent" @@ -1406,9 +1385,8 @@ =20 ## # @MirrorSyncMode: -# -# An enumeration of possible behaviors for the initial synchronization -# phase of storage mirroring. +# An enumeration of possible behaviors for the initial +# synchronization phase of storage mirroring. # # @top: copies data in the topmost image to the destination # @@ -1429,9 +1407,8 @@ =20 ## # @BitmapSyncMode: -# -# An enumeration of possible behaviors for the synchronization of a -# bitmap when used for data copy operations. +# An enumeration of possible behaviors for the synchronization of +# a bitmap when used for data copy operations. # # @on-success: The bitmap is only synced when the operation is # successful. This is the behavior always used for incremental @@ -1450,9 +1427,8 @@ =20 ## # @MirrorCopyMode: -# -# An enumeration whose values tell the mirror block job when to -# trigger writes to the target. +# An enumeration whose values tell the mirror block job when to +# trigger writes to the target. # # @background: copy data in background only. # @@ -1467,8 +1443,7 @@ =20 ## # @BlockJobInfoMirror: -# -# Information specific to mirror block jobs. +# Information specific to mirror block jobs. # # @actively-synced: Whether the source is actively synced to the # target, i.e. same data and new writes are done synchronously to @@ -1481,8 +1456,7 @@ =20 ## # @BlockJobInfo: -# -# Information about a long-running block device operation. +# Information about a long-running block device operation. # # @type: the job type ('stream' for image streaming) # @@ -1534,8 +1508,7 @@ =20 ## # @query-block-jobs: -# -# Return information about long-running block device operations. +# Return information about long-running block device operations. # # Returns: a list of job info for each active block job # @@ -1577,9 +1550,8 @@ =20 ## # @NewImageMode: -# -# An enumeration that tells QEMU how to set the backing file path in a -# new image file. +# An enumeration that tells QEMU how to set the backing file path +# in a new image file. # # @existing: QEMU should look for an existing image file. # @@ -1782,8 +1754,7 @@ =20 ## # @blockdev-snapshot-sync: -# -# Takes a synchronous snapshot of a block device. +# Takes a synchronous snapshot of a block device. # # Errors: # - If @device is not a valid block device, DeviceNotFound @@ -2043,8 +2014,7 @@ =20 ## # @query-named-block-nodes: -# -# Get the named block driver list +# Get the named block driver list # # @flat: Omit the nested data about backing image ("backing-image" # key) if true. Default is false (Since 5.0) @@ -2140,8 +2110,7 @@ =20 ## # @BlockPermission: -# -# Enum of base block permissions. +# Enum of base block permissions. # # @consistent-read: A user that has the "permission" of consistent # reads is guaranteed that their view of the contents of the block @@ -2171,8 +2140,7 @@ =20 ## # @XDbgBlockGraphEdge: -# -# Block Graph edge description for `x-debug-query-block-graph`. +# Block Graph edge description for `x-debug-query-block-graph`. # # @parent: parent id # @@ -2194,8 +2162,7 @@ =20 ## # @XDbgBlockGraph: -# -# Block Graph - list of nodes and list of edges. +# Block Graph - list of nodes and list of edges. # # Since: 4.0 ## @@ -2204,8 +2171,7 @@ =20 ## # @x-debug-query-block-graph: -# -# Get the block graph. +# Get the block graph. # # Features: # @@ -2247,8 +2213,7 @@ =20 ## # @DriveMirror: -# -# A set of parameters describing drive mirror setup. +# A set of parameters describing drive mirror setup. # # @job-id: identifier for the newly-created block job. If omitted, # the device name will be used. (Since 2.7) @@ -2401,9 +2366,8 @@ =20 ## # @block-dirty-bitmap-add: -# -# Create a dirty bitmap with a name on the node, and start tracking -# the writes. +# Create a dirty bitmap with a name on the node, and start +# tracking the writes. # # Errors: # - If @node is not a valid block device or node, DeviceNotFound @@ -2447,10 +2411,9 @@ =20 ## # @block-dirty-bitmap-clear: -# -# Clear (reset) a dirty bitmap on the device, so that an incremental -# backup from this point in time forward will only backup clusters -# modified after this clear operation. +# Clear (reset) a dirty bitmap on the device, so that an +# incremental backup from this point in time forward will only +# backup clusters modified after this clear operation. # # Errors: # - If @node is not a valid block device, DeviceNotFound @@ -2470,8 +2433,8 @@ =20 ## # @block-dirty-bitmap-enable: -# -# Enables a dirty bitmap so that it will begin tracking disk changes. +# Enables a dirty bitmap so that it will begin tracking disk +# changes. # # Errors: # - If @node is not a valid block device, DeviceNotFound @@ -2491,8 +2454,8 @@ =20 ## # @block-dirty-bitmap-disable: -# -# Disables a dirty bitmap so that it will stop tracking disk changes. +# Disables a dirty bitmap so that it will stop tracking disk +# changes. # # Errors: # - If @node is not a valid block device, DeviceNotFound @@ -2545,8 +2508,7 @@ =20 ## # @BlockDirtyBitmapSha256: -# -# SHA256 hash of dirty bitmap data +# SHA256 hash of dirty bitmap data # # @sha256: ASCII representation of SHA256 bitmap hash # @@ -2557,8 +2519,7 @@ =20 ## # @x-debug-block-dirty-bitmap-sha256: -# -# Get bitmap SHA256. +# Get bitmap SHA256. # # Features: # @@ -2577,8 +2538,7 @@ =20 ## # @blockdev-mirror: -# -# Start mirroring a block device's writes to a new destination. +# Start mirroring a block device's writes to a new destination. # # @job-id: identifier for the newly-created block job. If omitted, # the device name will be used. (Since 2.7) @@ -2664,8 +2624,7 @@ =20 ## # @BlockIOThrottle: -# -# A set of parameters describing block throttling. +# A set of parameters describing block throttling. # # @device: Block device name # @@ -2816,8 +2775,7 @@ =20 ## # @ThrottleGroupProperties: -# -# Properties for throttle-group objects. +# Properties for throttle-group objects. # # @limits: limits to apply for this throttle group # @@ -3224,8 +3182,7 @@ =20 ## # @BlockJobChangeOptions: -# -# Block job options that can be changed after job creation. +# Block job options that can be changed after job creation. # # @id: The job identifier # @@ -3240,8 +3197,7 @@ =20 ## # @block-job-change: -# -# Change the block job's options. +# Change the block job's options. # # Since: 8.2 ## @@ -3250,8 +3206,7 @@ =20 ## # @BlockdevDiscardOptions: -# -# Determines how to handle discard requests. +# Determines how to handle discard requests. # # @ignore: Ignore the request # @@ -3264,10 +3219,9 @@ =20 ## # @BlockdevDetectZeroesOptions: -# -# Describes the operation mode for the automatic conversion of plain -# zero writes by the OS to driver specific optimized zero write -# commands. +# Describes the operation mode for the automatic conversion of +# plain zero writes by the OS to driver specific optimized zero +# write commands. # # @off: Disabled (default) # @@ -3284,8 +3238,7 @@ =20 ## # @BlockdevAioOptions: -# -# Selects the AIO backend to handle I/O requests +# Selects the AIO backend to handle I/O requests # # @threads: Use QEMU's thread pool # @@ -3301,8 +3254,7 @@ =20 ## # @BlockdevCacheOptions: -# -# Includes cache-related options for block devices +# Includes cache-related options for block devices # # @direct: enables use of O_DIRECT (bypass the host page cache; # default: false) @@ -3317,8 +3269,7 @@ =20 ## # @BlockdevDriver: -# -# Drivers that are supported in block device operations. +# Drivers that are supported in block device operations. # # @throttle: Since 2.11 # @@ -3360,8 +3311,7 @@ =20 ## # @BlockdevOptionsFile: -# -# Driver specific block device options for the file backend. +# Driver specific block device options for the file backend. # # @filename: path to the image file # @@ -3420,8 +3370,7 @@ =20 ## # @BlockdevOptionsNull: -# -# Driver specific block device options for the null backend. +# Driver specific block device options for the null backend. # # @size: size of the device in bytes. # @@ -3440,8 +3389,7 @@ =20 ## # @BlockdevOptionsNVMe: -# -# Driver specific block device options for the NVMe backend. +# Driver specific block device options for the NVMe backend. # # @device: PCI controller address of the NVMe device in format # hhhh:bb:ss.f (host:bus:slot.function) @@ -3458,8 +3406,7 @@ =20 ## # @BlockdevOptionsVVFAT: -# -# Driver specific block device options for the vvfat protocol. +# Driver specific block device options for the vvfat protocol. # # @dir: directory to be exported as FAT image # @@ -3483,9 +3430,8 @@ =20 ## # @BlockdevOptionsGenericFormat: -# -# Driver specific block device options for image format that have no -# option besides their data source. +# Driver specific block device options for image format that have +# no option besides their data source. # # @file: reference to or definition of the data source block device # @@ -3496,8 +3442,7 @@ =20 ## # @BlockdevOptionsLUKS: -# -# Driver specific block device options for LUKS. +# Driver specific block device options for LUKS. # # @key-secret: the ID of a QCryptoSecret object providing the # decryption key. Mandatory except when doing a metadata-only @@ -3514,9 +3459,9 @@ =20 ## # @BlockdevOptionsGenericCOWFormat: -# -# Driver specific block device options for image format that have no -# option besides their data source and an optional backing file. +# Driver specific block device options for image format that have +# no option besides their data source and an optional backing +# file. # # @backing: reference to or definition of the backing file block # device, null disables the backing file entirely. Defaults to @@ -3530,8 +3475,7 @@ =20 ## # @Qcow2OverlapCheckMode: -# -# General overlap check modes. +# General overlap check modes. # # @none: Do not perform any checks # @@ -3594,9 +3538,8 @@ =20 ## # @Qcow2OverlapChecks: -# -# Specifies which metadata structures should be guarded against -# unintended overwriting. +# Specifies which metadata structures should be guarded against +# unintended overwriting. # # @flags: set of flags for separate specification of each metadata # structure type @@ -3633,8 +3576,7 @@ =20 ## # @BlockdevOptionsQcow: -# -# Driver specific block device options for qcow. +# Driver specific block device options for qcow. # # @encrypt: Image decryption options. Mandatory for encrypted images, # except when doing a metadata-only probe of the image. @@ -3670,9 +3612,8 @@ =20 ## # @BlockdevOptionsPreallocate: -# -# Filter driver intended to be inserted between format and protocol -# node and do preallocation in protocol node on write. +# Filter driver intended to be inserted between format and +# protocol node and do preallocation in protocol node on write. # # @prealloc-align: on preallocation, align file length to this number, # default 1048576 (1M) @@ -3687,8 +3628,7 @@ =20 ## # @BlockdevOptionsQcow2: -# -# Driver specific block device options for qcow2. +# Driver specific block device options for qcow2. # # @lazy-refcounts: whether to enable the lazy refcounts feature # (default is taken from the image file) @@ -3841,8 +3781,7 @@ =20 ## # @BlkdebugEvent: -# -# Trigger events supported by blkdebug. +# Trigger events supported by blkdebug. # # @l1_shrink_write_table: write zeros to the l1 table to shrink image. # (since 2.11) @@ -3878,8 +3817,7 @@ =20 ## # @BlkdebugIOType: -# -# Kinds of I/O that blkdebug can inject errors in. +# Kinds of I/O that blkdebug can inject errors in. # # @read: .bdrv_co_preadv() # @@ -3901,8 +3839,7 @@ =20 ## # @BlkdebugInjectErrorOptions: -# -# Describes a single error injection for blkdebug. +# Describes a single error injection for blkdebug. # # @event: trigger event # @@ -3940,8 +3877,7 @@ =20 ## # @BlkdebugSetStateOptions: -# -# Describes a single state-change event for blkdebug. +# Describes a single state-change event for blkdebug. # # @event: trigger event # @@ -3960,8 +3896,7 @@ =20 ## # @BlockdevOptionsBlkdebug: -# -# Driver specific block device options for blkdebug. +# Driver specific block device options for blkdebug. # # @image: underlying raw block device (or image file) # @@ -4022,8 +3957,7 @@ =20 ## # @BlockdevOptionsBlklogwrites: -# -# Driver specific block device options for blklogwrites. +# Driver specific block device options for blklogwrites. # # @file: block device # @@ -4049,8 +3983,7 @@ =20 ## # @BlockdevOptionsBlkverify: -# -# Driver specific block device options for blkverify. +# Driver specific block device options for blkverify. # # @test: block device to be tested # @@ -4064,8 +3997,7 @@ =20 ## # @BlockdevOptionsBlkreplay: -# -# Driver specific block device options for blkreplay. +# Driver specific block device options for blkreplay. # # @image: disk image which should be controlled with blkreplay # @@ -4076,8 +4008,7 @@ =20 ## # @QuorumReadPattern: -# -# An enumeration of quorum read patterns. +# An enumeration of quorum read patterns. # # @quorum: read all the children and do a quorum vote on reads # @@ -4089,8 +4020,7 @@ =20 ## # @BlockdevOptionsQuorum: -# -# Driver specific block device options for Quorum +# Driver specific block device options for Quorum # # @blkverify: true if the driver must print content mismatch set to # false by default @@ -4116,8 +4046,7 @@ =20 ## # @BlockdevOptionsIoUring: -# -# Driver specific block device options for the io_uring backend. +# Driver specific block device options for the io_uring backend. # # @filename: path to the image file # @@ -4129,8 +4058,8 @@ =20 ## # @BlockdevOptionsNvmeIoUring: -# -# Driver specific block device options for the nvme-io_uring backend. +# Driver specific block device options for the nvme-io_uring +# backend. # # @path: path to the NVMe namespace's character device (e.g. # /dev/ng0n1). @@ -4143,9 +4072,8 @@ =20 ## # @BlockdevOptionsVirtioBlkVfioPci: -# -# Driver specific block device options for the virtio-blk-vfio-pci -# backend. +# Driver specific block device options for the virtio-blk-vfio-pci +# backend. # # @path: path to the PCI device's sysfs directory (e.g. # /sys/bus/pci/devices/0000:00:01.0). @@ -4158,9 +4086,8 @@ =20 ## # @BlockdevOptionsVirtioBlkVhostUser: -# -# Driver specific block device options for the virtio-blk-vhost-user -# backend. +# Driver specific block device options for the +# virtio-blk-vhost-user backend. # # @path: path to the vhost-user UNIX domain socket. # @@ -4172,9 +4099,8 @@ =20 ## # @BlockdevOptionsVirtioBlkVhostVdpa: -# -# Driver specific block device options for the virtio-blk-vhost-vdpa -# backend. +# Driver specific block device options for the +# virtio-blk-vhost-vdpa backend. # # @path: path to the vhost-vdpa character device. # @@ -4193,8 +4119,7 @@ =20 ## # @IscsiTransport: -# -# An enumeration of libiscsi transport types +# An enumeration of libiscsi transport types # # Since: 2.9 ## @@ -4203,8 +4128,7 @@ =20 ## # @IscsiHeaderDigest: -# -# An enumeration of header digests supported by libiscsi +# An enumeration of header digests supported by libiscsi # # Since: 2.9 ## @@ -4214,8 +4138,7 @@ =20 ## # @BlockdevOptionsIscsi: -# -# Driver specific block device options for iscsi +# Driver specific block device options for iscsi # # @transport: The iscsi transport type # @@ -4417,8 +4340,7 @@ =20 ## # @ReplicationMode: -# -# An enumeration of replication modes. +# An enumeration of replication modes. # # @primary: Primary mode, the vm's state will be sent to secondary # QEMU. @@ -4433,8 +4355,7 @@ =20 ## # @BlockdevOptionsReplication: -# -# Driver specific block device options for replication +# Driver specific block device options for replication # # @mode: the replication mode # @@ -4452,8 +4373,7 @@ =20 ## # @NFSTransport: -# -# An enumeration of NFS transport types +# An enumeration of NFS transport types # # @inet: TCP transport # @@ -4464,8 +4384,7 @@ =20 ## # @NFSServer: -# -# Captures the address of the socket +# Captures the address of the socket # # @type: transport type used for NFS (only TCP supported) # @@ -4479,8 +4398,7 @@ =20 ## # @BlockdevOptionsNfs: -# -# Driver specific block device option for NFS +# Driver specific block device option for NFS # # @server: host address # @@ -4517,9 +4435,8 @@ =20 ## # @BlockdevOptionsCurlBase: -# -# Driver specific block device options shared by all protocols -# supported by the curl backend. +# Driver specific block device options shared by all protocols +# supported by the curl backend. # # @url: URL of the image file # @@ -4620,8 +4537,7 @@ =20 ## # @BlockdevOptionsNbd: -# -# Driver specific block device options for NBD. +# Driver specific block device options for NBD. # # @server: NBD server address # @@ -4669,8 +4585,7 @@ =20 ## # @BlockdevOptionsRaw: -# -# Driver specific block device options for the raw driver. +# Driver specific block device options for the raw driver. # # @offset: position where the block device starts # @@ -4684,8 +4599,7 @@ =20 ## # @BlockdevOptionsThrottle: -# -# Driver specific block device options for the throttle driver +# Driver specific block device options for the throttle driver # # @throttle-group: the name of the throttle-group object to use. It # must already exist. @@ -4701,8 +4615,8 @@ =20 ## # @BlockdevOptionsCor: -# -# Driver specific block device options for the copy-on-read driver. +# Driver specific block device options for the copy-on-read +# driver. # # @bottom: The name of a non-filter node (allocation-bearing layer) # that limits the COR operations in the backing chain (inclusive), @@ -4718,9 +4632,8 @@ =20 ## # @OnCbwError: -# -# An enumeration of possible behaviors for copy-before-write operation -# failures. +# An enumeration of possible behaviors for copy-before-write +# operation failures. # # @break-guest-write: report the error to the guest. This way, the # guest will not be able to overwrite areas that cannot be backed @@ -4895,8 +4808,7 @@ =20 ## # @BlockdevRef: -# -# Reference to a block device. +# Reference to a block device. # # @definition: defines a new block device inline # @@ -4910,8 +4822,7 @@ =20 ## # @BlockdevRefOrNull: -# -# Reference to a block device. +# Reference to a block device. # # @definition: defines a new block device inline # @@ -4930,8 +4841,7 @@ =20 ## # @blockdev-add: -# -# Creates a new block device. +# Creates a new block device. # # Since: 2.9 # @@ -5092,8 +5002,7 @@ =20 ## # @BlockdevCreateOptionsFile: -# -# Driver specific image creation options for file. +# Driver specific image creation options for file. # # @filename: Filename for the new image file # @@ -5119,8 +5028,7 @@ =20 ## # @BlockdevCreateOptionsLUKS: -# -# Driver specific image creation options for LUKS. +# Driver specific image creation options for LUKS. # # @file: Node to create the image format on, mandatory except when # 'preallocation' is not requested @@ -5143,8 +5051,7 @@ =20 ## # @BlockdevCreateOptionsNfs: -# -# Driver specific image creation options for NFS. +# Driver specific image creation options for NFS. # # @location: Where to store the new image file # @@ -5158,8 +5065,7 @@ =20 ## # @BlockdevCreateOptionsParallels: -# -# Driver specific image creation options for parallels. +# Driver specific image creation options for parallels. # # @file: Node to create the image format on # @@ -5176,8 +5082,7 @@ =20 ## # @BlockdevCreateOptionsQcow: -# -# Driver specific image creation options for qcow. +# Driver specific image creation options for qcow. # # @file: Node to create the image format on # @@ -5211,8 +5116,7 @@ =20 ## # @Qcow2CompressionType: -# -# Compression type used in qcow2 image file +# Compression type used in qcow2 image file # # @zlib: zlib compression, see # @@ -5225,8 +5129,7 @@ =20 ## # @BlockdevCreateOptionsQcow2: -# -# Driver specific image creation options for qcow2. +# Driver specific image creation options for qcow2. # # @file: Node to create the image format on # @@ -5285,8 +5188,7 @@ =20 ## # @BlockdevCreateOptionsQed: -# -# Driver specific image creation options for qed. +# Driver specific image creation options for qed. # # @file: Node to create the image format on # @@ -5313,8 +5215,7 @@ =20 ## # @BlockdevCreateOptionsRbd: -# -# Driver specific image creation options for rbd/Ceph. +# Driver specific image creation options for rbd/Ceph. # # @location: Where to store the new image file. This location cannot # point to a snapshot. @@ -5335,8 +5236,7 @@ =20 ## # @BlockdevVmdkSubformat: -# -# Subformat options for VMDK images +# Subformat options for VMDK images # # @monolithicSparse: Single file image with sparse cluster allocation # @@ -5359,8 +5259,7 @@ =20 ## # @BlockdevVmdkAdapterType: -# -# Adapter type info for VMDK images +# Adapter type info for VMDK images # # Since: 4.0 ## @@ -5369,8 +5268,7 @@ =20 ## # @BlockdevCreateOptionsVmdk: -# -# Driver specific image creation options for VMDK. +# Driver specific image creation options for VMDK. # # @file: Where to store the new image file. This refers to the image # file for monolithcSparse and streamOptimized format, or the @@ -5418,8 +5316,7 @@ =20 ## # @BlockdevCreateOptionsSsh: -# -# Driver specific image creation options for SSH. +# Driver specific image creation options for SSH. # # @location: Where to store the new image file # @@ -5433,8 +5330,7 @@ =20 ## # @BlockdevCreateOptionsVdi: -# -# Driver specific image creation options for VDI. +# Driver specific image creation options for VDI. # # @file: Node to create the image format on # @@ -5464,8 +5360,7 @@ =20 ## # @BlockdevCreateOptionsVhdx: -# -# Driver specific image creation options for vhdx. +# Driver specific image creation options for vhdx. # # @file: Node to create the image format on # @@ -5508,8 +5403,7 @@ =20 ## # @BlockdevCreateOptionsVpc: -# -# Driver specific image creation options for vpc (VHD). +# Driver specific image creation options for vpc (VHD). # # @file: Node to create the image format on # @@ -5531,8 +5425,7 @@ =20 ## # @BlockdevCreateOptions: -# -# Options for creating an image format on a given node. +# Options for creating an image format on a given node. # # @driver: block driver to create the image format # @@ -5577,8 +5470,7 @@ =20 ## # @BlockdevAmendOptionsLUKS: -# -# Driver specific image amend options for LUKS. +# Driver specific image amend options for LUKS. # # Since: 5.1 ## @@ -5602,8 +5494,7 @@ =20 ## # @BlockdevAmendOptions: -# -# Options for amending an image format +# Options for amending an image format # # @driver: Block driver of the node to amend. # @@ -5651,8 +5542,8 @@ =20 ## # @BlockErrorAction: -# -# An enumeration of action that has been taken when a DISK I/O occurs +# An enumeration of action that has been taken when a DISK I/O +# occurs # # @ignore: error has been ignored # @@ -5715,8 +5606,7 @@ =20 ## # @BLOCK_IO_ERROR: -# -# Emitted when a disk I/O error occurs +# Emitted when a disk I/O error occurs # # @qom-path: path to the device object in the QOM tree (since 9.2) # @@ -5768,8 +5658,7 @@ =20 ## # @BLOCK_JOB_COMPLETED: -# -# Emitted when a block job has completed +# Emitted when a block job has completed # # @type: job type # @@ -5808,8 +5697,7 @@ =20 ## # @BLOCK_JOB_CANCELLED: -# -# Emitted when a block job has been cancelled +# Emitted when a block job has been cancelled # # @type: job type # @@ -5842,8 +5730,7 @@ =20 ## # @BLOCK_JOB_ERROR: -# -# Emitted when a block job encounters an error +# Emitted when a block job encounters an error # # @device: The job identifier. Originally the device name but other # values are allowed since QEMU 2.7 @@ -5869,8 +5756,7 @@ =20 ## # @BLOCK_JOB_READY: -# -# Emitted when a block job is ready to complete +# Emitted when a block job is ready to complete # # @type: job type # @@ -5929,8 +5815,7 @@ =20 ## # @PreallocMode: -# -# Preallocation mode of QEMU image file +# Preallocation mode of QEMU image file # # @off: no preallocation # @@ -6109,8 +5994,7 @@ =20 ## # @QuorumOpType: -# -# An enumeration of the quorum operation types +# An enumeration of the quorum operation types # # @read: read operation # @@ -6125,8 +6009,8 @@ =20 ## # @QUORUM_FAILURE: -# -# Emitted by the Quorum block driver if it fails to establish a quorum +# Emitted by the Quorum block driver if it fails to establish a +# quorum # # @reference: device name if defined else node name # @@ -6149,8 +6033,7 @@ =20 ## # @QUORUM_REPORT_BAD: -# -# Emitted to report a corruption of a Quorum file +# Emitted to report a corruption of a Quorum file # # @type: quorum operation type (Since 2.6) # @@ -6283,8 +6166,8 @@ =20 ## # @DummyBlockCoreForceArrays: -# -# Not used by QMP; hack to let us use BlockGraphInfoList internally +# Not used by QMP; hack to let us use BlockGraphInfoList +# internally # # Since: 8.0 ## --=20 2.55.0