From nobody Fri Jul 24 05:22:03 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=1784782299; cv=none; d=zohomail.com; s=zohoarc; b=Eb+uFskP8Nr1wWKnJFFZDxiwELuVeecevBQkzH5Y2VC7mteOeZP9O/BegVLjT/B0KUVSAGH9bCKLahLkpRe6Wi5JuHll4tJWy8g/36ZeEWFvuiFyyw2RUcwpU7WF32raVF0c2DRzqnXsb1laSetYYNsYoDjVtqD2lc5J5aVvw5w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782299; 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=RnxXR0CXNShNd1Gbm33+Jbw/gGOP7gGinetdejrs1tA=; b=if/xTwfGPlpjhW+sHepihDA/dQM/JJeu0sBt1U1TV/Mcpx3FfUHe9Y5oQjWLH13+G14yqyDiKfLIXdJfja5nGfmBpZc3F7YmYyugCCTuVHBQJNeh7zYBwO5BxLADTwr8n2BQZomlI6yawRF9fpc4/aMvgc+BQfGlPwtRewkW3Ko= 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 1784782299188644.4581005560101; Wed, 22 Jul 2026 21:51:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlMX-0007f4-Vb; Thu, 23 Jul 2026 00:48:49 -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 1wmlMW-0007dn-JD for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48: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 1wmlMO-0003wu-BC for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48:46 -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-639-MBeTa54gPAuQa6IncaWvdg-1; Thu, 23 Jul 2026 00:48: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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 30B1D195D02A; Thu, 23 Jul 2026 04:48:30 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id C0F6E18002B4; Thu, 23 Jul 2026 04:48:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782119; 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=RnxXR0CXNShNd1Gbm33+Jbw/gGOP7gGinetdejrs1tA=; b=h8HGafp3gYLzkjiNOVpjTS1IedpCAOpEQts5OG5EHlzHBRtrjmpMUcj93EQIrHwLG7FW3z BPFGS026bGNVQKubQBpCQYHcjJx8kEZR7rnrRsxzpEiFawdosKa5eGqNxS8xUOsTu+d3tl w95fykjQLFeYZVpLtyw40cS4gARWcIQ= X-MC-Unique: MBeTa54gPAuQa6IncaWvdg-1 X-Mimecast-MFC-AGG-ID: MBeTa54gPAuQa6IncaWvdg_1784782111 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 01/44] qapi: convert intro sections for error.json Date: Thu, 23 Jul 2026 00:47:22 -0400 Message-ID: <20260723044805.527643-2-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782299735158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782174; cv=none; d=zohomail.com; s=zohoarc; b=D38iF75+io02FbgMqNylmb9u7KzmpMjC7knH7EfJGDKWHbF5hAXzxD95yZ0x17kvQg4hP6gyd8wVT2imB8WdDZ+deYQG5E1MKlr6dE9+TcHX0pWc6+7bQs7oUKLFBQTVk+qHW2ZQ+J2PzHzd/1LnT4N4wmYUH24R786y8uZD9KA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782174; 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=5vOiO01WF9e6a7qGQTH5ORT8i146iPJx0lQOpzsSDPY=; b=QjwVX7iXaHFfhRO1rdCgMmUiqbWZ6QImt8aL034Tkfkw0050TvpfycelhHQNrIb2sW17TpYzfL2lVXhlerKQ1l7V7IIHXkH4gHBV/VATUoUm5jkF1pv3TmyKF8o22SKYLlvlDk2If1pcmcVMpOmPzB4+GiAtSrfT/I2evIgGyxU= 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 1784782174607563.0470520722577; Wed, 22 Jul 2026 21:49:34 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlMa-0007kk-RB; Thu, 23 Jul 2026 00:48: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 1wmlMZ-0007jQ-58 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48: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 1wmlMX-0003xw-1n for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48:50 -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-163-hk_oHJISNBSAnP_EJeW1YA-1; Thu, 23 Jul 2026 00:48:43 -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 A5A1F195606B; Thu, 23 Jul 2026 04:48:39 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 50663180029D; Thu, 23 Jul 2026 04:48:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782128; 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=5vOiO01WF9e6a7qGQTH5ORT8i146iPJx0lQOpzsSDPY=; b=dKBSNoopQJoWIuWCpmiNmBESmfUjW5WJc9Fos3t4U27MszR3gX3GYcMcGVkBbHsD+8vtyI X64RVncI9TYavkXJ1CGCvrJG5VKr2S0AXhPzEWeGji/XpB7+0/nHfdEAk/uAz8Ziw6vAQX YRMsQ++4TnE+0ZduFumTsVqOu/6KwRc= X-MC-Unique: hk_oHJISNBSAnP_EJeW1YA-1 X-Mimecast-MFC-AGG-ID: hk_oHJISNBSAnP_EJeW1YA_1784782121 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 02/44] qapi: convert intro sections for acpi-hest.json Date: Thu, 23 Jul 2026 00:47:23 -0400 Message-ID: <20260723044805.527643-3-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782176971158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow Acked-by: Mauro Carvalho Chehab --- 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 Fri Jul 24 05:22:03 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=1784782176; cv=none; d=zohomail.com; s=zohoarc; b=l4xfP0lhSDCp/pVEc1vV9vf/wW8mjv7v64vDGKX7rPGeWEPn9OHPRfmDfwvjjpo7a4jXW9/+nn/NgWQXzfZ+kUXpLl1AT2kQ1IwrJzUKiodl7N8psyzNyFCv6auYd9JZhWql1zoHKJZqLv7QPGL2BxdtnsJMZTigJ4bwES2pTVo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782176; 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=NSEF3Y3+ufb+xLGwy5XyD2M1KREl2XGjKup2Cecdxwg=; b=a35dPT01uNqOAauabEwAUdmk3pFILOc28KHmd5xmsRIOQLeqJVe57X8JeX7Ks8qFB2IqTb2B1CWCQRDp7L/THfFBb30K7/3ZIF5Ij9mazG/t2x712T+612SH6Vm6ANxONOTKzUIi0HnmXhlbHtfp0sI5Wbm5tmpO3KZkK9AFq5E= 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 1784782176486934.1327530585775; Wed, 22 Jul 2026 21:49:36 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlMi-0007oK-6I; Thu, 23 Jul 2026 00:49:00 -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 1wmlMg-0007nI-Pp for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48:58 -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 1wmlMf-0003z0-BU for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:48:58 -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-235-5koa4SSgPwmIuwVIehVJAA-1; Thu, 23 Jul 2026 00:48: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 895981800759; Thu, 23 Jul 2026 04:48:49 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E8BB018002AE; Thu, 23 Jul 2026 04:48:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782136; 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=NSEF3Y3+ufb+xLGwy5XyD2M1KREl2XGjKup2Cecdxwg=; b=ZnF1L2mJSDP+83YuLv6sk2Ge68yeCm50YgHR7Ewh+NXA3t6lVBK/NB0aS/9ldJnvpgcF9B kh5GLSro2QhubJYkX4MiMy19U4JJd1dhtD7McZZBHvbypzYHSmuvbF8wH/piDsnCvORdOL Ul49x8QM9VF4XEJLQWE1NObfi2o4rfU= X-MC-Unique: 5koa4SSgPwmIuwVIehVJAA-1 X-Mimecast-MFC-AGG-ID: 5koa4SSgPwmIuwVIehVJAA_1784782130 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 03/44] qapi: convert intro sections for ebpf.json Date: Thu, 23 Jul 2026 00:47:24 -0400 Message-ID: <20260723044805.527643-4-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782178760158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/ebpf.json | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/qapi/ebpf.json b/qapi/ebpf.json index f0257955fa2..1f7a4d5c126 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 @@ -49,10 +47,10 @@ =20 ## # @request-ebpf: -# -# Retrieve an eBPF object that can be loaded with libbpf. Management -# applications (e.g. libvirt) may load it and pass file descriptors to -# QEMU, so they can run running QEMU without BPF capabilities. +# Retrieve an eBPF object that can be loaded with libbpf. +# Management applications (e.g. libvirt) may load it and pass file +# descriptors to QEMU, so they can run running QEMU without BPF +# capabilities. # # @id: The ID of the program to return. # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782240; cv=none; d=zohomail.com; s=zohoarc; b=Xanj4Ac0kjiq9m5ffRUP9xZySDeaNLQxH5AilUPXqJMb9vF3pNeNf1bjhcsQ6FkT9typcl3tVk5zZXHAMr+9LZOKrjYZXM6dKZvxGBGH6dV4mbGAQCixLWU/w5HSN6yfprpQQQbZYILhSjLTPB4+z64wV+11OlweS5iz+htdHEM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782240; 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=o+bQR//T6yQ1PPsE5y6DgGjYaFx3qqyzrYEDUIB8MPE=; b=Xa/LOqwr/NzpomJae6DVvuh/VKx98EAVotlmN3Iq1J0XZ7IzbSN4WrL9ihHFtPjwZrFGIr4boYCTsgcJFvir+nTeL0gWluP+usphHUFSPYBhs54QvDMWyUcvkGCsTo+Zrz+SnN5UkJRd1fgt6xHDaXJkHjIsXPdHp9JK39mBQaU= 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 1784782240617630.2655706507244; Wed, 22 Jul 2026 21:50:40 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlMr-00081A-RL; Thu, 23 Jul 2026 00:49:09 -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 1wmlMq-0007yP-Gr for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:08 -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 1wmlMp-0003zg-3X for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:08 -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-100-eQm3yPQvNnmtw7CwDzAuJA-1; Thu, 23 Jul 2026 00:49: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EA336182E6BA; Thu, 23 Jul 2026 04:48:58 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id AA0BD18002B4; Thu, 23 Jul 2026 04:48:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782146; 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=o+bQR//T6yQ1PPsE5y6DgGjYaFx3qqyzrYEDUIB8MPE=; b=hG2vVzEUPWEk/9RB55I9HOiMG38WxgneD0tjGdl4eC17INA++/90rs0iZ6GJgcbIs8rxEM aqthAKG8snzpGLhx/Z8M2I4K/sL8cZJ8fJtU7Gt3s+EBUjPZLAZSrF/faMugXvFgzlGsNf +FEf6qSEO4IU9PSmqXGzzAT+dj3WZ5g= X-MC-Unique: eQm3yPQvNnmtw7CwDzAuJA-1 X-Mimecast-MFC-AGG-ID: eQm3yPQvNnmtw7CwDzAuJA_1784782140 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 04/44] qapi: convert intro sections for uefi.json Date: Thu, 23 Jul 2026 00:47:25 -0400 Message-ID: <20260723044805.527643-5-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782241026158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/uefi.json | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/qapi/uefi.json b/qapi/uefi.json index 86f33b234ba..cb2b5e1f531 100644 --- a/qapi/uefi.json +++ b/qapi/uefi.json @@ -17,9 +17,8 @@ =20 ## # @UefiVariable: -# -# UEFI Variable. Check the UEFI specification for more detailed -# information on the fields. +# UEFI Variable. Check the UEFI specification for more detailed +# information on the fields. # # @guid: variable namespace GUID # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782205; cv=none; d=zohomail.com; s=zohoarc; b=ICvtdaIqwdHdlXWCvNntnDfV7wgVsUF0zamJO9nwyseu640TtatvsdF6OBZFLXUXSmTGSPfI252RX+gxAh1fNeK/2EXT2dowS1AF1gfW129BJSEQhkV2YDgceE89ZsTgNHzGNIfR5gzAvgjBENWXoK3r7b0dWCniqewmgUVFEu8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782205; 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=iGdX1GJR2Qah9+ZqUdZhwLE3xHpIag0UoFWVx3hHcVM=; b=JUYe65TVzu+I019ynpcb6zvPkUYbtn7of7YWhLQ8n9SzUeCH96lGUWmJUnbrbiw9ctVKHQ8V3JsKqfVOQB0ilgFfUTCtRcerN8u23qc4EJ1Ok4OCG1AuRQZVpStTmIKCsjz91FSTX1LeXjDNhPa0y5u1F2QipBMuGSU+mB++tvk= 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 1784782205204320.27849970289094; Wed, 22 Jul 2026 21:50:05 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlN1-0008IR-Od; Thu, 23 Jul 2026 00:49:19 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlN0-0008EW-AC for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49: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 1wmlMy-00040h-OP for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:17 -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-416-CIkMi2ezMjCikp1RLXCdqQ-1; Thu, 23 Jul 2026 00:49: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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AD9FC1955F7C; Thu, 23 Jul 2026 04:49:09 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5F299180029D; Thu, 23 Jul 2026 04:48:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782156; 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=iGdX1GJR2Qah9+ZqUdZhwLE3xHpIag0UoFWVx3hHcVM=; b=VA7lYtscYGOM+iA/MkoqTIrmfGEawm16rre5pDm961BLV1xjIEdCICfjLy7UTfa0m1kMYs EcqhXIthSXW6wZ5gE6GRW8wZ9uwFtUFRxhWbbVThuNQi55kHe+ztGqGt157E1krKrng2oS xtG7c9Q9x1PkQk/IPaOaJ2kib+43klk= X-MC-Unique: CIkMi2ezMjCikp1RLXCdqQ-1 X-Mimecast-MFC-AGG-ID: CIkMi2ezMjCikp1RLXCdqQ_1784782149 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 05/44] qapi: convert trivial intro sections for compat.json Date: Thu, 23 Jul 2026 00:47:26 -0400 Message-ID: <20260723044805.527643-6-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782207113158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782211; cv=none; d=zohomail.com; s=zohoarc; b=jmZdJ3iwLvWfFV3mV0b06DKpRSEFrYa2Lx8mTciu2UbVhfKYuvloaOrzN8uWhyZ+pch2iXTitrrV73zaxrsWWpPx2jjWzUAStEh1yuUDpxp8x3m2AGnyoU3fnR5ErrwO50PMo+1wlKuomLwpOW8IACThH0vzAFVC7qdXmlWHzw0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782211; 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=9YsSN3/iGxSVcvdhM8+DcbeqiCtrl9C1vt5VQz7+650=; b=fRY54LvwqG/6SrBNoHlJm0BpTqVoa1K6AtcoqWo6Wv3KM7aFX8mWgWblMRzSCSILML7vUYnpeoNw2m4uk1fPwVvKSb0RyVQolspV94W9WHmV7N6+H7hhd6O1voorONaavNPccYZd5t9br6lbQKUnhzw8iVDZRTl2kgJq7cc9b5A= 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 1784782211417485.1449515450839; Wed, 22 Jul 2026 21:50:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNC-0008Ql-4t; Thu, 23 Jul 2026 00:49:30 -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 1wmlNA-0008OO-Eg for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:28 -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 1wmlN9-00041V-3k for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:28 -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-66-UqXSW5nBMtCY2XisYh-prQ-1; Thu, 23 Jul 2026 00:49:22 -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 AE5EC1800764; Thu, 23 Jul 2026 04:49:19 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 1B23D18002AE; Thu, 23 Jul 2026 04:49:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782166; 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=9YsSN3/iGxSVcvdhM8+DcbeqiCtrl9C1vt5VQz7+650=; b=IBqvMjtCcWeEFyV6wKlW+rtX7U7tsSve4pfwP8zStLPN5o1wIimjEtgvIEfpTujtVj9FnW vKqc1TAi6+6aY4AwrsWJ2wSt0hxEBZ1gqrAAmDCXDFV45LBG5fPJv9l2x34MqAdVowtwo9 /dUTqoTSjejA22tao2KS+rWZTLO3X84= X-MC-Unique: UqXSW5nBMtCY2XisYh-prQ-1 X-Mimecast-MFC-AGG-ID: UqXSW5nBMtCY2XisYh-prQ_1784782159 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 06/44] qapi: convert intro sections for vfio.json Date: Thu, 23 Jul 2026 00:47:27 -0400 Message-ID: <20260723044805.527643-7-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782212918158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/vfio.json | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/qapi/vfio.json b/qapi/vfio.json index 17b60468712..47fff8b979d 100644 --- a/qapi/vfio.json +++ b/qapi/vfio.json @@ -10,14 +10,13 @@ =20 ## # @QapiVfioMigrationState: -# -# An enumeration of the VFIO device migration states. In addition to -# the regular states, there are prepare states (with 'prepare' suffix) -# which indicate that the device is just about to transition to the -# corresponding state. Note that seeing a prepare state for state X -# doesn't guarantee that the next state will be X, as the state -# transition can fail and the device may transition to a different -# state instead. +# An enumeration of the VFIO device migration states. In addition +# to the regular states, there are prepare states (with 'prepare' +# suffix) which indicate that the device is just about to +# transition to the corresponding state. Note that seeing a +# prepare state for state X doesn't guarantee that the next state +# will be X, as the state transition can fail and the device may +# transition to a different state instead. # # @stop: The device is stopped. # @@ -49,8 +48,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 Fri Jul 24 05:22:03 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=1784782222; cv=none; d=zohomail.com; s=zohoarc; b=Kn97Xz8poXdVvsBn5hJHkIX/8kE83Tl+4CeG61pJ48I4XaGjy7Bzt1AEMxJwwC/q1VOM36QmJPFKjeOTJTIWpW9sGbnAKp1VaH5V2iYXD9K9oCLmOKmVDH8E6eKmRPCAH223b/PPftLDKnfaOpjo/8r6A7ci7AL8/17kJgo5K2s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782222; 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=IqN+pz/6fcmsONkCRkuffRAAiopB88H75SjiniCSIHM=; b=dJPB42JFR5P3gSdwQduqk9AmAkw0XQVq3scvWgrf3Orz1jctLXJStuk42lcYes992sHyZfCbuXa7YeCuUNmPKGe8SAe0pBK/X/hUWSYVWmob0FMuZ9OzFKvESpzv3WscYFLUEKDZveMo5ahs7YE2I03DKIFskU+ice/s4S48rQk= 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 1784782222561833.1102747501302; Wed, 22 Jul 2026 21:50:22 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNK-0000F6-CR; Thu, 23 Jul 2026 00:49:38 -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 1wmlNI-0000E3-4J for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49: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 1wmlNF-00042K-6g for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:35 -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-504-fnqsRcTpMmexNk4oM6rNiQ-1; Thu, 23 Jul 2026 00:49:30 -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 E34B91800A33; Thu, 23 Jul 2026 04:49:27 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id F3C5718002AE; Thu, 23 Jul 2026 04:49:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782172; 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=IqN+pz/6fcmsONkCRkuffRAAiopB88H75SjiniCSIHM=; b=gnInSpdCwE751X+JcC6jGkO0RUAlp/11BvGFhqPjv/Q+xfgtEudSFIidquLwsz3bWOoDZI KmTiHbSe7vcQRTnAFCR+sjSl9l8MmwoaRDJEVkl0S9RX+gdX+I4G8rB0bR3bzl84/m2u2l dkELhtJOe9MebcvommTa+iU+yJZ/k/A= X-MC-Unique: fnqsRcTpMmexNk4oM6rNiQ-1 X-Mimecast-MFC-AGG-ID: fnqsRcTpMmexNk4oM6rNiQ_1784782168 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 07/44] qapi: convert intro sections for trace.json Date: Thu, 23 Jul 2026 00:47:28 -0400 Message-ID: <20260723044805.527643-8-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782223181158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782285; cv=none; d=zohomail.com; s=zohoarc; b=ZfMuC8i4M0N3lN4OVAPrdMXNU1sW9M5VT43yUM37GTRQ09mGmW+WISpA/GEAmm6jTZpOwUrVajLjvJEg2tZGe6IRVaysEUoK44ilt2o+fKL6tkyccJg0K1lNtgqdUL7iBHpnv/xJ8DMJPkC5I+Rejp/Dv5HgBHObMCCd+wjfAmk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782285; 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=Ye3PMO0BcG5/sMMpltL1f7W/lGgNiDmYNE87s2b0G5s=; b=SZa17f6BIY4H62KnDQ3Q3SAxYYS6P8VL7S0bPiSNvrW32VMeUDjjmKNCOmiIqJxskG7H7z31yqxmn9BXunZbXY0OHhHzfo0vLTmLcRT1xF1JlWvJn7lm+C8lswC0lZDqM1q91scgPeUJ+kBvxxPynAXcBb2lt0Sffto8FVOWPlw= 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 1784782285163497.1091441302161; Wed, 22 Jul 2026 21:51:25 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNW-0000oy-M6; Thu, 23 Jul 2026 00:49: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 1wmlNS-0000S4-IO for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49: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 1wmlNQ-00043l-UQ for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:46 -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-564-GsPbBZ2_Ou-Y7VbJ9TXBEA-1; Thu, 23 Jul 2026 00:49:40 -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 C2C641955DC2; Thu, 23 Jul 2026 04:49:37 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 62CA918002AE; Thu, 23 Jul 2026 04:49:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782184; 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=Ye3PMO0BcG5/sMMpltL1f7W/lGgNiDmYNE87s2b0G5s=; b=OnWgdYOXVuAvChN9SEzWOaM+bYq3i4lGgr+Ay2klg12bGkclO3FmKm35AvTCMcgUKGd9fp XXcKJbx2mbH9C05IhQrfraODAcLSD8fZ1pV84wtnEB/Nbl2OHL5c5JJ/22WyTdzlvMsRPb miotcVvch2akjaotftDieFC1bxwh/4Y= X-MC-Unique: GsPbBZ2_Ou-Y7VbJ9TXBEA-1 X-Mimecast-MFC-AGG-ID: GsPbBZ2_Ou-Y7VbJ9TXBEA_1784782177 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 08/44] qapi: convert trivial intro sections for misc-arm.json Date: Thu, 23 Jul 2026 00:47:29 -0400 Message-ID: <20260723044805.527643-9-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782285826158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/misc-arm.json | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index 4dc66d00e5c..8cb2ea77951 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -5,11 +5,10 @@ =20 ## # @GICCapability: -# -# The struct describes capability for a specific GIC (Generic -# Interrupt Controller) version. These bits are not only decided by -# QEMU/KVM software version, but also decided by the hardware that the -# program is running upon. +# The struct describes capability for a specific GIC (Generic +# Interrupt Controller) version. These bits are not only decided +# by QEMU/KVM software version, but also decided by the hardware +# that the program is running upon. # # @version: version of GIC to be described. Currently, only 2 and 3 # are supported. @@ -48,8 +47,7 @@ =20 ## # @SsidSizeMode: -# -# SMMUv3 SubstreamID size configuration mode. +# SMMUv3 SubstreamID size configuration mode. # # @auto: derive from host IOMMU capabilities # @@ -64,8 +62,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 Fri Jul 24 05:22:03 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=1784782272; cv=none; d=zohomail.com; s=zohoarc; b=ekxocYQCR17WNhEsSjHPjAekiyH2ULd/ShqP0nmGlXGAhynvGNNYa78gh2VTwg7khk5gOrLq38SxVRqr1d3xZL+ssHRmGfDXjZ8M1uou6b+XfkdXjyEhMyQpXea07FnRZ9SLiwD+Qkpk+YnX7eeCjh/ZGLGfL56urrh/lQXA+CM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782272; 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=6MfiGs1YvmhhCQ9TR9AVXMB0jZQk3iPwALbaJBp3oPY=; b=hVjsPxEQlCVTkjClLw+Cof8NNxPxzmpLXU/PRkgt1dHql7wtiNou476CJls8AxuuVLfOQSvwGyfuC7/P35EiUJQjs+zRVNOhGz8i5JsVObiIxUBnsUKHTkQUq/FkNn+T84s2PAV9oz/n4+Xa9whMcHs69G/fy8WwKdPVUfK6IEM= 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 1784782272253287.1557573757792; Wed, 22 Jul 2026 21:51:12 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNg-000246-5G; Thu, 23 Jul 2026 00:50:00 -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 1wmlNd-0001qU-NP for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49: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 1wmlNc-00045I-7F for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:49:57 -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-375-xhXlp8GRPZOFmCouSsprUg-1; Thu, 23 Jul 2026 00:49: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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 55B31195D027; Thu, 23 Jul 2026 04:49:46 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 031C4180029D; Thu, 23 Jul 2026 04:49:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782195; 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=6MfiGs1YvmhhCQ9TR9AVXMB0jZQk3iPwALbaJBp3oPY=; b=YhBTFEYOIbXPs2Lgsh1gGZQbQRCn0HfcAlt/etDr8g+Q81Sx2/jOIhvVyHuO4ryd6jNXL1 qfUeFjdyGXnLUyXr1fyDBrcavkB4lwqiBk0ib6zOxCCtm7/OuADd/oVZNExs/kaPp9bm7S 1DiBBTKHlvyHMMkmuXV/UMstG9VSFLs= X-MC-Unique: xhXlp8GRPZOFmCouSsprUg-1 X-Mimecast-MFC-AGG-ID: xhXlp8GRPZOFmCouSsprUg_1784782186 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 09/44] qapi: convert intro sections for cryptodev.json Date: Thu, 23 Jul 2026 00:47:30 -0400 Message-ID: <20260723044805.527643-10-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782273144158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow Acked-by: zhenwei pi --- 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 Fri Jul 24 05:22:03 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=1784782270; cv=none; d=zohomail.com; s=zohoarc; b=mTFlnOcJANKiQUeczmEGx0+pq+/cLhzMMBtfJewxVVQLEv3KgcJcwzyuiMvcXRk79Z+rXbptCxr9TS9efMxZ+BpNVUfj+lsupN7ZEgHtfTBZFu79uIffHC0cnzOlNl65U/YuTE7wY8G9YTJz6B8njtoUbszkn3Im1QZQiC420yU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782270; 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=JUM+22WxDywCXikFEUBWpOnNWjGENT0mgqCEYZkslcs=; b=EFvU01r4GuljnLPk+jfhcYJ0XsBgaZD8Ujy12VkBrq9JO4EGtnN9T4z2p/qPMMNBx8n87gYhAXIrOOtyis2hjrWbQqDJVmVVl/Cywz0qq4mIsLj0oSQfvvVvliHhZMYxaPh/Pbhg6ne5eTMk3v+3/A/7WMpTlP+cn31QZKTIFqQ= 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 1784782270407875.8283788384571; Wed, 22 Jul 2026 21:51:10 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNo-0002Uz-Me; Thu, 23 Jul 2026 00:50:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlNm-0002O4-Kg for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:06 -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 1wmlNk-0004Il-VV for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:06 -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-193-RSTknKbGMyOtFjgmvGgSGw-1; Thu, 23 Jul 2026 00:49:59 -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 4AAAB195FE1B; Thu, 23 Jul 2026 04:49:56 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id AF08318002B5; Thu, 23 Jul 2026 04:49:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782204; 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=JUM+22WxDywCXikFEUBWpOnNWjGENT0mgqCEYZkslcs=; b=iYK/JzQI++N/8DpIG7h54ARsy2v6tFO7DW504WYTyzB2yc8yGC3dfxr5SZWspx2zghHKTk wF8Nn2nfmCaOr60enE0gJdHcxDEpePRMXrJ4lj5J8iStoZ6p5OoI0oauR/nQreEL9JUkYz vPEq1LAsLTMdnai6yYGt7wPgYQ4qLS0= X-MC-Unique: RSTknKbGMyOtFjgmvGgSGw-1 X-Mimecast-MFC-AGG-ID: RSTknKbGMyOtFjgmvGgSGw_1784782196 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 10/44] qapi: convert intro sections for machine-common.json Date: Thu, 23 Jul 2026 00:47:31 -0400 Message-ID: <20260723044805.527643-11-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782271349158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/machine-common.json | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/qapi/machine-common.json b/qapi/machine-common.json index aca98e994af..0b07811df07 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 @@ -65,9 +63,8 @@ =20 ## # @CacheLevelAndType: -# -# Caches a system may have. The enumeration value here is the -# combination of cache level and cache type. +# Caches a system may have. The enumeration value here is the +# combination of cache level and cache type. # # @l1d: L1 data cache. # @@ -84,8 +81,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 +99,7 @@ =20 ## # @SmpCachePropertiesWrapper: -# -# List wrapper of `SmpCacheProperties`. +# List wrapper of `SmpCacheProperties`. # # @caches: the list of `SmpCacheProperties`. # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782243; cv=none; d=zohomail.com; s=zohoarc; b=QrIM1t9ls/FxBeHaJ//c1wMFpV31up+ync04T5jkVWgnOMD7aKjZsqfLfwdmGNO8qVE/Zy+czuDKaP3iYrXSg0F5SANQZqAQ+oBeStp9Q6MFn0PZRb7BdNVzDANwu0TFPlC+qPakV4xJhZ2dATIOwhpcFJNfEG7/APsSyKkq+GE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782243; 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=/m9oOcbWUoOnQCUdpT8YuW9QMaUcjKrgB4Bi5ODd0yI=; b=hKhRcW0TLQrG4vE/341lhjeWauNaumthFNH21HXWyXM91fy8N8OreZ0cDBu62FLLzerk2vG1d43BOH0SHydm/wL+vbXUVtrlbiPluViM+uDlKyhYiFaXHplFFFxuSzEpQB0JVtAk+wpNPIG6JMc8A/JLkBs++J74Hi46cDQDWYE= 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 17847822436041023.2320257624922; Wed, 22 Jul 2026 21:50:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlNx-00032j-41; Thu, 23 Jul 2026 00:50: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 1wmlNv-00031Q-Fi for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:15 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlNt-0004LR-IH for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50: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-378-UXDzHo2gP9SY12M-UaSCgA-1; Thu, 23 Jul 2026 00:50: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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 710CE1955E92; Thu, 23 Jul 2026 04:50:05 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 85D01180059C; Thu, 23 Jul 2026 04:49:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782213; 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=/m9oOcbWUoOnQCUdpT8YuW9QMaUcjKrgB4Bi5ODd0yI=; b=TztP/wQsDLTBh83LvjR9DHXjr0RKEtrJaVFTTTxN7tjpypaqZHCmnpOB8a5NShkxiPFWsa 84dCasci1OQB+sbcNqk1+NN16NPDbKteOG5fZF3dv17D70H0rK6yV+YsD/qSc40vh2oRiC cZt1XUIFsLHTm73Mx8guMnrXqqr96i0= X-MC-Unique: UXDzHo2gP9SY12M-UaSCgA-1 X-Mimecast-MFC-AGG-ID: UXDzHo2gP9SY12M-UaSCgA_1784782205 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 11/44] qapi: convert intro sections for accelerator.json Date: Thu, 23 Jul 2026 00:47:32 -0400 Message-ID: <20260723044805.527643-12-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782245385158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782232; cv=none; d=zohomail.com; s=zohoarc; b=Flsu+iOr3hu/+hd0kPeHXcUpmT7r2j4yxzZxKWmqghw2HHNelVbsk5Yqxi2wY3NaFNWwhUKcIIgCINDC/pnl8rIYAPuYGyXH9P81e8sL4PF2eExW1IjLn604yZ+OW2vuUlWRgbx+NSQAZvqRLjGrGpM+OC3VSPhHdo6TcLrMFOk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782232; 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=TdL4XpFKkJHBP7qXMmxL4imk9A4iFnUzHbovAddFeL0=; b=VIrU+g4oykgWtr6iCD0g1+3xEbzlvk2l864AEBYuug5tNMa7//xenVDDrsCDyKr6l5qStylj+vqKEKuFF+vyxjtD/rn1H90AP78N+TVuYDOcOW6CIn416+7VsK2jLmqrhfj9IHVZbv6rVrrE698c0MdVcfER0olU1clSiwfLDJg= 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 178478223242148.37067683676207; Wed, 22 Jul 2026 21:50:32 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlO9-0003PF-KQ; Thu, 23 Jul 2026 00:50:29 -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 1wmlO7-0003Lt-9O for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:27 -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 1wmlO5-0004Mx-AK for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:27 -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-225-fkxXG0Z7OBCzAwn_mng0dg-1; Thu, 23 Jul 2026 00:50: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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AE9AA1955F7C; Thu, 23 Jul 2026 04:50:15 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 07486180029D; Thu, 23 Jul 2026 04:50:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782224; 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=TdL4XpFKkJHBP7qXMmxL4imk9A4iFnUzHbovAddFeL0=; b=VKvn2e2dyWT6Vu0CgFb68nxF+0L2zALxX6R39B0RllWD1u5yiWYE/zxwj7nielEIFcSVLK tleS3O2sa/DERPYeT5hDFYBDli8ZaH5ok+roBaAeXhXasEh1AgI7ypVX5BCufbRioQZzG6 HUuGyoGHoT4D9up5rlW/HK/QNzIM1/k= X-MC-Unique: fkxXG0Z7OBCzAwn_mng0dg-1 X-Mimecast-MFC-AGG-ID: fkxXG0Z7OBCzAwn_mng0dg_1784782215 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 12/44] qapi: convert intro sections for authz.json Date: Thu, 23 Jul 2026 00:47:33 -0400 Message-ID: <20260723044805.527643-13-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782233094158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782325; cv=none; d=zohomail.com; s=zohoarc; b=bxpcmYBPkyv05VD5+bE+L07N3GIbIzIP3Tzyk7so61QohxrEmt+jMEx2arDlmBFGe0tggKHChdnpTY8g4h0XSDNAxx/55mPOQUGaWKIcDzbUBf0aFdBmWEdiufkX7IRcTDSuLuVYLZYvwP+hR0g+6j/gB11Am69A9tjNqO7khzQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782325; 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=3S3HWop+zR66RgFI+ulHeqmicEzYN7TvQjZvmrL1hCo=; b=d67RQISRGcEt+O3FOvBlh5aNtN7QsGZ6oN9Z4YerIRlmxnRYgnO1qIZHD44Xpgk4O2GEHdEgIgq+HuDPcOB3m1JsV4MuHRcznrg/pjd608OQ6MUO3aHi27LlVDUXACUW1g6DdSQk3p7MS+xPE8Hgyf145Slm2o5s4/Rq3UsvCvk= 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 1784782325696220.11583795042816; Wed, 22 Jul 2026 21:52:05 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlOK-0004HE-5I; Thu, 23 Jul 2026 00:50: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 1wmlOI-00040U-8v for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:38 -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 1wmlOG-0004Nk-4D for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:37 -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-433-nXey0MRTM7WZ5yuVyDRzBA-1; Thu, 23 Jul 2026 00:50: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 0E6381800764; Thu, 23 Jul 2026 04:50:26 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3207218002AE; Thu, 23 Jul 2026 04:50:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782235; 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=3S3HWop+zR66RgFI+ulHeqmicEzYN7TvQjZvmrL1hCo=; b=U4VGFcIMcFG6yOZn5vUO+vq13d9tT3LVfSCLIHsrt/a8/xX5ezCs1G3JHR8ZeYYWCkfejB T7Kh9hx/LULxJjrZd2r122yoDv4ZTcpoLY93eyS5aG+ZpSaEqIwjCQR9O2NVvs0VJ+WOkx HkKuGrSBNHZr4e56wx1t37qbFcXBWLY= X-MC-Unique: nXey0MRTM7WZ5yuVyDRzBA-1 X-Mimecast-MFC-AGG-ID: nXey0MRTM7WZ5yuVyDRzBA_1784782226 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 13/44] qapi: convert trivial intro sections for yank.json Date: Thu, 23 Jul 2026 00:47:34 -0400 Message-ID: <20260723044805.527643-14-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782325918158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow Acked-by: Lukas Straub --- qapi/yank.json | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/qapi/yank.json b/qapi/yank.json index f3cd5c15d60..8ac4b773653 100644 --- a/qapi/yank.json +++ b/qapi/yank.json @@ -10,9 +10,8 @@ =20 ## # @YankInstanceType: -# -# An enumeration of yank instance types. See `YankInstance` for more -# information. +# An enumeration of yank instance types. See `YankInstance` for +# more information. # # Since: 6.0 ## @@ -21,9 +20,8 @@ =20 ## # @YankInstanceBlockNode: -# -# Specifies which block graph node to yank. See `YankInstance` for -# more information. +# Specifies which block graph node to yank. See `YankInstance` +# for more information. # # @node-name: the name of the block graph node # @@ -34,9 +32,8 @@ =20 ## # @YankInstanceChardev: -# -# Specifies which character device to yank. See `YankInstance` for -# more information. +# Specifies which character device to yank. See `YankInstance` +# for more information. # # @id: the chardev's ID # @@ -47,9 +44,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 # @@ -74,9 +70,8 @@ =20 ## # @yank: -# -# Try to recover from hanging QEMU by yanking the specified instances. -# See `YankInstance` for more information. +# Try to recover from hanging QEMU by yanking the specified +# instances. See `YankInstance` for more information. # # @instances: the instances to be yanked # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782341; cv=none; d=zohomail.com; s=zohoarc; b=ATh5sNtFEfqqufOSjl0CXqq/GYNRY7gvvYLKGflvS4gzQwt1t9Z2PmtMJWfyI+YwXiuYkIfYP2vmmbbDLVc0QNk9rQ6TgioiB6/mdJf+Y9r/b6AV5yKnSZeCV5Ue3IML776aath3oXuR+29HH1xxRjt1ctWR+dIjBSP2ubBGa18= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782341; 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=TMsbmtwIJsHsJ64Y/awhARhEChYJf52hplBgthhLPFc=; b=Nuy2BclVCaGuTSr/EboaEnJil1PIa2s8Tjs43qSrCREgrIKCj6045gKyaUm0ClWK4Gere7nOF4f10pqXvFYyJ7w3XjM8sUFnXFy/YPsr64Zvxt/xg5ByRY8NZTq5nB5Wioi7Majb+TqjT+p0JwGh8U4f9NzHO0kzc8I3tDj6IMo= 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 1784782341300564.3796945685071; Wed, 22 Jul 2026 21:52:21 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlOV-0004ts-57; Thu, 23 Jul 2026 00:50: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 1wmlOQ-0004q2-Mz for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:46 -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 1wmlOO-0004OO-Mp for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:50:46 -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-42-H7AG1BgiOSiid6wo1RwJ1A-1; Thu, 23 Jul 2026 00:50:40 -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 219EA1954B26; Thu, 23 Jul 2026 04:50:37 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 4599F18002AE; Thu, 23 Jul 2026 04:50:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782244; 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=TMsbmtwIJsHsJ64Y/awhARhEChYJf52hplBgthhLPFc=; b=D+n4M83m87Ccho133qdsiMwNDvHpb3MJIhxbynrX1UxqkczQ7lD5gUwvBj1NmlRGQCxb4Z VHuysBJKDPbjLr7HrxR8O6O0/Ln7jZD3iUvnEmfHnOqj2RzMOP2dcO23YRVP5L9M6AaP/M w8Gckv6PSiJkOU0XzQhfplMZ9nneFOY= X-MC-Unique: H7AG1BgiOSiid6wo1RwJ1A-1 X-Mimecast-MFC-AGG-ID: H7AG1BgiOSiid6wo1RwJ1A_1784782237 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 14/44] qapi: convert intro sections for replay.json Date: Thu, 23 Jul 2026 00:47:35 -0400 Message-ID: <20260723044805.527643-15-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782341947158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/replay.json | 45 ++++++++++++++++++++------------------------- 1 file changed, 20 insertions(+), 25 deletions(-) diff --git a/qapi/replay.json b/qapi/replay.json index ccf84da68ef..db1440c09a6 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. # @@ -47,10 +45,9 @@ =20 ## # @query-replay: -# -# Retrieve the record/replay information. It includes current -# instruction count which may be used for `replay-break` and -# `replay-seek` commands. +# Retrieve the record/replay information. It includes current +# instruction count which may be used for `replay-break` and +# `replay-seek` commands. # # Returns: record/replay information. # @@ -66,13 +63,13 @@ =20 ## # @replay-break: -# -# Set replay breakpoint at instruction count @icount. Execution stops -# when the specified instruction is reached. There can be at most one -# breakpoint. When breakpoint is set, any prior one is removed. The -# breakpoint may be set only in replay mode and only "in the future", -# i.e. at instruction counts greater than the current one. The -# current instruction count can be observed with `query-replay`. +# Set replay breakpoint at instruction count @icount. Execution +# stops when the specified instruction is reached. There can be +# at most one breakpoint. When breakpoint is set, any prior one +# is removed. The breakpoint may be set only in replay mode and +# only "in the future", i.e. at instruction counts greater than +# the current one. The current instruction count can be observed +# with `query-replay`. # # @icount: instruction count to stop at # @@ -87,9 +84,8 @@ =20 ## # @replay-delete-break: -# -# Remove replay breakpoint which was set with `replay-break`. The -# command is ignored when there are no replay breakpoints. +# Remove replay breakpoint which was set with `replay-break`. The +# command is ignored when there are no replay breakpoints. # # Since: 5.2 # @@ -102,13 +98,12 @@ =20 ## # @replay-seek: -# -# Automatically proceed to the instruction count @icount, when -# replaying the execution. The command automatically loads nearest -# snapshot and replays the execution to find the desired instruction. -# When there is no preceding snapshot or the execution is not -# replayed, then the command fails. Instruction count can be obtained -# with the `query-replay` command. +# Automatically proceed to the instruction count @icount, when +# replaying the execution. The command automatically loads +# nearest snapshot and replays the execution to find the desired +# instruction. When there is no preceding snapshot or the +# execution is not replayed, then the command fails. Instruction +# count can be obtained with the `query-replay` command. # # @icount: target instruction count # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782345; cv=none; d=zohomail.com; s=zohoarc; b=ZmigUwRMKfNK4VvLYB/Bc5qQAx5W5ZiHT5MqFLOJhPJdJ4I4rAY67oDqnLHjtQntCSVIOWXFVbgXAahNONDixuhnMblqJNa2mVC3j143XIi5EFQ7P/5OT9zlziackUWTjL1PamPv1AdCzaJg8QP/x44LjP/hpfNGRiVikbtY6ls= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782345; 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=XX0MM67l2hTQkl3T1X4vh6I9bh96PpfSjiv2H/lU8Zg=; b=fQfN/zY8arz8uNrwiiq/UmF8INXykHVe6dargiCqWE6k1PeTX9w1S9dTogmWWYIvXCMAzXLZDoJANngcZuA0djV3lG0lfjwPqxCfy8/adDfTmbpeIdmq3e182TJsE2bVfZT9dxJ08CGrjPY3BgZ6vX0t0KN6fW9UbMcJbU1LeNc= 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 17847823454981010.617068719987; Wed, 22 Jul 2026 21:52:25 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPk-0007GK-4d; Thu, 23 Jul 2026 00:52:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlPf-0006pJ-60 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:03 -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 1wmlPd-0004VZ-OK for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:02 -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-589-BCZ7n0D3Ptumtz7syo7Jjw-1; Thu, 23 Jul 2026 00:50:50 -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 6C45F1800759; Thu, 23 Jul 2026 04:50:47 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 823A018002AE; Thu, 23 Jul 2026 04:50:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782321; 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=XX0MM67l2hTQkl3T1X4vh6I9bh96PpfSjiv2H/lU8Zg=; b=fZhKtdVMHvfezCeF9NtAxC0B81PC/XiKr/o5jXJX86JQuF2drTqoslMzdJUw4D1FcukdI7 C7iHHc/b3WWd3jbJHqVp/0gS0RVq6HMCdXYQ1ZA0YkWeRc/a7UO2I4Pj3zuMeJvDUTY7DU WNIkuDMn5CyZXDqqArv4CotCv5u7Ayg= X-MC-Unique: BCZ7n0D3Ptumtz7syo7Jjw-1 X-Mimecast-MFC-AGG-ID: BCZ7n0D3Ptumtz7syo7Jjw_1784782247 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 15/44] qapi: convert trivial intro sections for machine-s390x.json Date: Thu, 23 Jul 2026 00:47:36 -0400 Message-ID: <20260723044805.527643-16-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782345919158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/machine-s390x.json | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index ea430e1b889..2d40629683f 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 ## @@ -21,10 +20,9 @@ =20 ## # @set-cpu-topology: -# -# Modify the topology by moving the CPU inside the topology tree, or -# by changing a modifier attribute of a CPU. Absent values will not -# be modified. +# Modify the topology by moving the CPU inside the topology tree, +# or by changing a modifier attribute of a CPU. Absent values +# will not be modified. # # @core-id: the vCPU ID to be moved # @@ -94,8 +92,7 @@ =20 ## # @CpuPolarizationInfo: -# -# The result of a CPU polarization query. +# The result of a CPU polarization query. # # @polarization: the CPU polarization # @@ -122,9 +119,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 Fri Jul 24 05:22:03 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=1784782289; cv=none; d=zohomail.com; s=zohoarc; b=NLYZcPk6GCr4p4CCOl/nF8FJttUsMe0l8F4//tNAhvFG9R4av+iyZcY3IxASpjKVdmR6o+bS00SaycWtFnoKrpMGIRiJCiKepehAVyTuHTnCzSEHFsG4R2wJ/fqgL0UHUyPy/TzFfp3Qn510SmPjAmcfa4rguP6n3oMDimWzcQ8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782289; 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=9YoGAoaYe1zPbiR9886orVUbPO3VRJkQv0eqUa1lksA=; b=LLkb2IQMs8b2yyyPlhyKfuNSFqrubngdLctB1wHaKBaH86EgPtVk8vaid9p2Z51/H7m4DlaMHz3bRc9243fQUDlz4p0/qEmzbQO/tLiJlZqwVrPIsSYpv0Gl6QMmgOXu82L3K/Yhto8knAe2SwMWbcPvhuHikf5doPvDezJCwos= 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 178478228916959.552701422620316; Wed, 22 Jul 2026 21:51:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlP2-0005g7-4I; Thu, 23 Jul 2026 00:51: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 1wmlOo-0005Wn-4v for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51: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 1wmlOm-0004QM-D5 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:09 -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-270-4z4sKMMpPoyuzGxko269Sw-1; Thu, 23 Jul 2026 00:51: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E5A9F1954B26; Thu, 23 Jul 2026 04:50:58 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id D053618002B5; Thu, 23 Jul 2026 04:50:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782267; 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=9YoGAoaYe1zPbiR9886orVUbPO3VRJkQv0eqUa1lksA=; b=DdnPqvvDwfsNXU9juQW5skiLepm4KkliuZrRYkMPw1LP21AoWvsl5Z+W+/rIyLwV5raJoA gCJ0ecAdhaqD3ztmvvsO9CvqPwTGFTt2XvPoNQZaOXkZ8fYdmZ2eyys7D7LScMYHneozcJ FMiogDIYEXodzbaC28hSdmxzhNSM9Qs= X-MC-Unique: 4z4sKMMpPoyuzGxko269Sw-1 X-Mimecast-MFC-AGG-ID: 4z4sKMMpPoyuzGxko269Sw_1784782259 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 16/44] qapi: convert trivial intro sections for acpi.json Date: Thu, 23 Jul 2026 00:47:37 -0400 Message-ID: <20260723044805.527643-17-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782289690158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/acpi.json | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/qapi/acpi.json b/qapi/acpi.json index 906b3687a55..291a04a7ea4 100644 --- a/qapi/acpi.json +++ b/qapi/acpi.json @@ -81,10 +81,9 @@ =20 ## # @ACPIOSTInfo: -# -# OSPM Status Indication for a device. For description of possible -# values of @source and @status fields see "_OST (OSPM Status -# Indication)" chapter of ACPI5.0 spec. +# OSPM Status Indication for a device. For description +# of possible values of @source and @status fields see "_OST (OSPM +# Status Indication)" chapter of ACPI5.0 spec. # # @device: device ID associated with slot # @@ -107,9 +106,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 +124,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 Fri Jul 24 05:22:03 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=1784782321; cv=none; d=zohomail.com; s=zohoarc; b=RAgaIGwJFmyvWCK1+IEBqeMop9Qs3Zf6/yYDWvruV4hQ5FoC6rTncHnTew+DQFY1l+C3mzeGhNZLOraZ+HJ58+mITyJrWskAMiaJBGHad2rqtCTm80ZChi5LN5wIepBBALdoE36NA43GGfRKJUeoG9pJEqJmOkdv3s3KseS3RFA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782321; 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=BLReHKiKZLrcMhTJHEtDrbs61uxUo1HyBJxoZBg4t+Q=; b=aG6/jgG02h44EHLz2S0Wha2TumjgfYk4VgTmTDLGS0B+XGbc1vQTBso7nRHUaETwbLfVgvqKwPXt0IcdQNuJUz3nuweo9vjGtKUTiXBwYFWgePHRsn+YcMloZSX1plld6EFzprvQJnPXgpeMR+K76+US+KX3eyS9bZfUq/+p6H8= 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 1784782321004178.98971237386274; Wed, 22 Jul 2026 21:52:01 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlP4-0005l1-F5; Thu, 23 Jul 2026 00:51:26 -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 1wmlOw-0005fV-MU for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51: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 1wmlOv-0004R1-3G for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:18 -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-593-BZq-vpapOaiUMw0l_FqGng-1; Thu, 23 Jul 2026 00:51: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id DD7811944F05; Thu, 23 Jul 2026 04:51:08 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 679A6180029D; Thu, 23 Jul 2026 04:50:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782276; 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=BLReHKiKZLrcMhTJHEtDrbs61uxUo1HyBJxoZBg4t+Q=; b=b9BEo+sZNHg57Qgsiw/ijFg/s7StU0VEsCfLHWwGAKpA2HkabIUyoR66SKtgtFT0DOMvz+ Yaa25cr0uozTeylM02Rofn0eOo7P2009a7AjwJOor5SW5RnTCRNlNWzCKRyea663NzY+rA wh58Gjabv2b7O2tY4yrEzqol7e3xfAA= X-MC-Unique: BZq-vpapOaiUMw0l_FqGng-1 X-Mimecast-MFC-AGG-ID: BZq-vpapOaiUMw0l_FqGng_1784782269 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 17/44] qapi: convert intro sections for tpm.json Date: Thu, 23 Jul 2026 00:47:38 -0400 Message-ID: <20260723044805.527643-18-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782321852158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow Reviewed-by: Stefan Berger --- 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 Fri Jul 24 05:22:03 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=1784782359; cv=none; d=zohomail.com; s=zohoarc; b=d2jiQcwN5t0aexZNN4gp9LqtNj9aP6XNhGBe8y/BCokqH0/LRpBKkALcjLVmGizEgbBp5IA2b3HkTfBOSt4YASFhlsFZG6QlGYV9gFcHKvixwmRJ4ivIrckXj+Li6SDARJ+9otkyrKsQn3PgqB8kBURAR7qmEcidHKSRVFJOUFA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782359; 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=uK3gVanDkZsjvvgE0Rg1w4gDzuwAaXDx8DZDiRphsfQ=; b=HGm4zuvDu5gMJWBAyktkoPGY8F8riNTU3x9v5+g9RyCiTD8SRtENEndptHv0P2M6ySNoMiEwpZiwkSqxshfRJG/cTQTlux1yrO8BxL/jNpSmAJG7RSnfSEobRVQUB8Uv/pKd09LebOLknz3x3/dGdEarUYubet5BFHG2LG2MdpY= 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 1784782359925445.4272010935148; Wed, 22 Jul 2026 21:52:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPA-0005wp-2E; Thu, 23 Jul 2026 00:51:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlP5-0005rg-9p for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:28 -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 1wmlP3-0004Rp-TI for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:27 -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-44-1zGTlrKaO5G6JF2UIT2urw-1; Thu, 23 Jul 2026 00:51:22 -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 5A3101954B26; Thu, 23 Jul 2026 04:51:19 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5531018002AE; Thu, 23 Jul 2026 04:51:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782285; 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=uK3gVanDkZsjvvgE0Rg1w4gDzuwAaXDx8DZDiRphsfQ=; b=RdU9YdhNnA3mmmuLTnmizB43z4aqOm6c6VX7nRkRCiId03jnSsYrqP6BXSzmtX/t3iM1Wl H3tT0N9LSfeWhJ/nVJe1LHj6POpLCiGtLpgTxuJLeBKIDAUNjzGwKlpMk3jsYAVHkMaojo AkWikKEXR3VYEJYYG5K+RbbDbgIm6fU= X-MC-Unique: 1zGTlrKaO5G6JF2UIT2urw-1 X-Mimecast-MFC-AGG-ID: 1zGTlrKaO5G6JF2UIT2urw_1784782279 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 18/44] qapi: convert trivial intro sections for qdev.json Date: Thu, 23 Jul 2026 00:47:39 -0400 Message-ID: <20260723044805.527643-19-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782361986158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/qdev.json | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/qapi/qdev.json b/qapi/qdev.json index 974cf9c5830..a35321d2fd1 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 # @@ -121,11 +118,10 @@ =20 ## # @DEVICE_DELETED: -# -# Emitted whenever the device removal completion is acknowledged by -# the guest. At this point, it's safe to reuse the specified device -# ID. Device removal can be initiated by the guest or by HMP/QMP -# commands. +# Emitted whenever the device removal completion is acknowledged +# by the guest. At this point, it's safe to reuse the specified +# device ID. Device removal can be initiated by the guest or by +# HMP/QMP commands. # # @device: the device's ID if it has one # @@ -145,9 +141,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 Fri Jul 24 05:22:03 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=1784782319; cv=none; d=zohomail.com; s=zohoarc; b=SaXAIcVnDeMuUQtUW0Tu7CWFJDAG8e327WslQIrR8pPaEhf1fEf8lr9+4na9tJKcLgNd8CD1t60t4uQtPFFFdjsYk5qBmoi9hg/BS7+CkZNgG6ZrF8+tB0jUW49CpDb8/1ZNIl6fvMeIpksGfJrKzsUi0lDwxz+TqXJY7W6t++w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782319; 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=RQBoRfguD8OLDOwj7R7RrWifXT5ev1UlWkcynySt+sw=; b=d9dWKyvsELwHS69342cYpASqG2iVPGd1Yy03f5MzZqJhVaTjh3k4SDfTevuZwHVB27zbI2zK0D2OosEn4mi8lRXn2bx9eQkEM5aT9KGXHVg7iDDYQSW57RJKzBUJ+pmzqTrt3YV/ABm5GM5T+VFD4F/BTOrfU79tRnmxdZ/ue9E= 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 1784782319229714.7538028439852; Wed, 22 Jul 2026 21:51:59 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPW-0006Vb-Aa; Thu, 23 Jul 2026 00:51:56 -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 1wmlPH-0006Iw-DZ for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:41 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlPF-0004Sq-Km for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51: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-516-bvW1v_QYP0e3J7-uD-0_Kg-1; Thu, 23 Jul 2026 00:51: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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EA0CF18007FB; Thu, 23 Jul 2026 04:51:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id DAFF318002B5; Thu, 23 Jul 2026 04:51:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782296; 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=RQBoRfguD8OLDOwj7R7RrWifXT5ev1UlWkcynySt+sw=; b=PIiMJDftbsqaKSrg9KDTsqRYZ4fTuv3UonJ3dqNYa4x/cinhw6zktbKnFpWa9cYw9LdRde fvygJfbmOrRYIMbdI7KZXYI+r8k3zqWbWrxwAOZMWdIA9qu7/g0/3GXZSkbIYaguPL2LDP 1PE3kI3RM2OFR6Cz8wkTi1RR/hY194I= X-MC-Unique: bvW1v_QYP0e3J7-uD-0_Kg-1 X-Mimecast-MFC-AGG-ID: bvW1v_QYP0e3J7-uD-0_Kg_1784782290 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 19/44] qapi: convert trivial intro sections for control.json Date: Thu, 23 Jul 2026 00:47:40 -0400 Message-ID: <20260723044805.527643-20-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782319881158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782350; cv=none; d=zohomail.com; s=zohoarc; b=jOwNzyeGluAiLOedTd3nMWJ08Vu+l8jEWP0K3Vt3YJodGlx46BNykFsiaPhLPh2q14hhRQwYftqbQGbk4bxuSqLj2HynsZ3zxmjUf/wKbzk2Eq8QrYq8dD/aeRbNgII1GUJgIqXUZBN+k9COAN4U2RhCBYfgC+Pw8rDnzLnrZGE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782350; 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=U2M2DNHzDsbrmW/HGNuaaemkcJAWL2ZJ96wipo50CoA=; b=SSlQfSFWKaPPImiGxpo4TYP84bfLFr9CUoMhk1cA9k4o89Md2KfE1Pp7iU+4OaWyE4NpX6+vjiGRAv4/BM5UEQcxgFjMlicu9LHLFV6dUQq0BLJmdsz6KqKlnlI7rve0yfsmIz42fW0PValmoQQg+SkUL/B0qoASBE8nTad/p/M= 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 1784782350774241.15480562743062; Wed, 22 Jul 2026 21:52:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPh-0006yk-EF; Thu, 23 Jul 2026 00:52:05 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlPR-0006Xl-HJ for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:52 -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 1wmlPQ-0004UD-3z for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:49 -0400 Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-664-DTqSLi1KOLirIKpVr7DHyA-1; Thu, 23 Jul 2026 00:51:43 -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 9B5ED1800578; Thu, 23 Jul 2026 04:51:40 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 3BB8318002AE; Thu, 23 Jul 2026 04:51:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782307; 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=U2M2DNHzDsbrmW/HGNuaaemkcJAWL2ZJ96wipo50CoA=; b=Ir8iVi9tTxclNfP1RniJ2Q1WQn26Zl+UEhoWsXeWEJxG9sfhSZCerEd4MZgX2Oxpbkw9PW U9sIskwZcRuAV951iJxEYrVVHpIcTfT3OJJEGHw/jP5TJLsnPdCUsA05ElKGeDOW/dzPJl M+Aw4J1c6G9JsKzgmxvl61IckuEWNWE= X-MC-Unique: DTqSLi1KOLirIKpVr7DHyA-1 X-Mimecast-MFC-AGG-ID: DTqSLi1KOLirIKpVr7DHyA_1784782300 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 20/44] qapi: convert intro sections for dump.json Date: Thu, 23 Jul 2026 00:47:41 -0400 Message-ID: <20260723044805.527643-21-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782351948158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/dump.json | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) diff --git a/qapi/dump.json b/qapi/dump.json index 726b5208703..c96dd2364bb 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 # @@ -49,9 +48,8 @@ =20 ## # @dump-guest-memory: -# -# Dump guest's memory to vmcore. It is a synchronous operation that -# can take very long depending on the amount of guest memory. +# Dump guest's memory to vmcore. It is a synchronous operation +# that can take very long depending on the amount of guest memory. # # @paging: if true, do paging to get guest's memory mapping. This # allows using gdb to process the core file. @@ -109,8 +107,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. # @@ -127,8 +125,7 @@ =20 ## # @DumpQueryResult: -# -# The result format for `query-dump`. +# The result format for `query-dump`. # # @status: enum of `DumpStatus`, which shows current dump status # @@ -145,8 +142,7 @@ =20 ## # @query-dump: -# -# Query latest dump status. +# Query latest dump status. # # Returns: An object showing the dump status. # @@ -162,8 +158,7 @@ =20 ## # @DUMP_COMPLETED: -# -# Emitted when background dump has completed +# Emitted when background dump has completed # # @result: final dump status # @@ -196,8 +191,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 Fri Jul 24 05:22:03 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=1784782347; cv=none; d=zohomail.com; s=zohoarc; b=nNVLNdD60GwgXTZkArcSPh8wEuTQU88JZjEX6IY+9O0Q6gmgwTPe4kkQHRkp9jRDiYRz2lDyEcoBoLvXlnnSSDk4IwXa7Dg3eTEvDtqkKMXAvLp2zvOrNs1pd9ewuJlln1m5b/ZztMlHgnJg7fl53rlIjc8RQMBcmQpsdleCrNI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782347; 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=ZZOkkDNzF4ftv+zU7W2icMZeYcFhXLiIhUIZUaO7VTU=; b=INe/PLmks4T7fZV9PvHciWlVpS2xOynbk5z/CgOnsa4pRRQ3UvrwkLd3uj+k2SsJVVkKerm6xwHHLs04KQwrByk9HfmscHmD/TSKesahPyOXZoC6Ic6T7enYjDxCsJbzb685eo20yscYV0laQPm7Yq5RKs6+jgbUQ332yz2CdRM= 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 1784782347291348.6498999968137; Wed, 22 Jul 2026 21:52:27 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPi-00077m-BC; Thu, 23 Jul 2026 00:52:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlPb-0006lv-Bk for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:01 -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 1wmlPZ-0004V6-D0 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:51:59 -0400 Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-99-yocJQpmlO5mJYrFHv20kUQ-1; Thu, 23 Jul 2026 00:51: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4E423190C40C; Thu, 23 Jul 2026 04:51:49 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id F275E180029D; Thu, 23 Jul 2026 04:51:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782316; 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=ZZOkkDNzF4ftv+zU7W2icMZeYcFhXLiIhUIZUaO7VTU=; b=MVRsC6JETh/C3uAOdzSGg9jFxUU9abNU9Ax4DkrblzJ8gJG6/2+rOJftE0dFcIzz0fFAjW FEESNMY8xG8RiYaeOyfsBjsCanTsG6GejCu4y+8koawgWjc2pq8YswcVx5hE1t7D88+wKK dB4tphCOnuXghyys2k945nNH46x3MxI= X-MC-Unique: yocJQpmlO5mJYrFHv20kUQ-1 X-Mimecast-MFC-AGG-ID: yocJQpmlO5mJYrFHv20kUQ_1784782309 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 21/44] qapi: convert intro sections for common.json Date: Thu, 23 Jul 2026 00:47:42 -0400 Message-ID: <20260723044805.527643-22-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782348032158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/common.json | 36 +++++++++++++----------------------- 1 file changed, 13 insertions(+), 23 deletions(-) diff --git a/qapi/common.json b/qapi/common.json index af7e3d618a7..1352e664b23 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 # @@ -55,10 +52,9 @@ =20 ## # @StrOrNull: -# -# This is a string value or the explicit lack of a string (null -# pointer in C). Intended for cases when 'optional absent' already -# has a different meaning. +# This is a string value or the explicit lack of a string (null +# pointer in C). Intended for cases when 'optional absent' +# already has a different meaning. # # @s: the string value # @@ -72,8 +68,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 +93,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 +114,7 @@ =20 ## # @PCIELinkWidth: -# -# An enumeration of PCIe link width +# An enumeration of PCIe link width # # @1: x1 # @@ -144,8 +137,7 @@ =20 ## # @HostMemPolicy: -# -# Host memory policy types +# Host memory policy types # # @default: restore default policy, remove any nondefault policy # @@ -164,9 +156,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 +175,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 Fri Jul 24 05:22:03 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=1784782347; cv=none; d=zohomail.com; s=zohoarc; b=aubC92W14GOHElBb6lWU0FfMGk9ZoP3Pk5VFC5mUx1nPmel+CICb7rQS7U8YC6wYBLuP5qZhYEB7oWBTWBRxEjUo3jcJFlle9GGy2ifX0SV5T+0AgV140tHfRqxwhr6lUT/2WawA8nnE8eXPLWwoXOEfaaq5akuse5oqMGM8PI4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782347; 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=IyTl9kx/Ys42L67iPX5XzMmfFhlEjbDrKuvT6ahrYho=; b=A/q9JxE0Qi0cLuwjlx082u/udnhfYZG6EGg6/UbXQ1acn234z+e+n4HWoyYk/FcztaOd5r4vqmvBO2gyZJ720tH0VekY3eysdVTPFtSxubsD+CwEi3c9SLJsnLH4dL/Z+DmNWIO51GdK2/wP7qxPDiW6eDtlUkziw+rIZbpziNs= 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 1784782347196405.03942300582787; Wed, 22 Jul 2026 21:52:27 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPo-0007qB-N0; Thu, 23 Jul 2026 00:52:12 -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 1wmlPm-0007Yx-Mq for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52: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 1wmlPl-0004WF-1S for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:10 -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-211-J48cmPRvPPiUaFUWwiqSjA-1; Thu, 23 Jul 2026 00:52: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id C16351944EBC; Thu, 23 Jul 2026 04:52:01 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id DD19D180029D; Thu, 23 Jul 2026 04:51:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782328; 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=IyTl9kx/Ys42L67iPX5XzMmfFhlEjbDrKuvT6ahrYho=; b=DILziwr+SfEKGwAbKEz4eOEnXcc+bpZy06t2klqwWpiNoNIgaUPUaXJkpB5PzlhuolvSMp zdLfdQjc2ZROiWtRKhkROZyhn7ioN/CMSiOIVXQI2LfV94nttfm1JIskw+1vxyAdhnoLir dyv1zl9YW9QkWFx1p84HQ4iEmoInejY= X-MC-Unique: J48cmPRvPPiUaFUWwiqSjA-1 X-Mimecast-MFC-AGG-ID: J48cmPRvPPiUaFUWwiqSjA_1784782322 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 22/44] qapi: convert intro sections for sockets.json Date: Thu, 23 Jul 2026 00:47:43 -0400 Message-ID: <20260723044805.527643-23-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782348043158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782358; cv=none; d=zohomail.com; s=zohoarc; b=DojydqVIugUTdlTBpuCE5PcBZ7ep9Nrp4Lc3iHFU8EzEc/IWXAnj5dw3HRrqg9yyfDOQoXllMM+pszyVDhjqC19FxqNFz5Z4QTYfBFXIp6E2mOqq3MSRXo+o08hXTsjpAZ6PERBmteciueHVsPyx8QYH2aOFw2lRqoOGzyypZEY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782358; 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=T5pYNtwR7SG5TiuFxq7Ubuc04yN+erb8vLnytfXqXS8=; b=R2nj7jSkDvxzGP00OybeSkbOK+sFwKxfb+KTbOzTYs/2rizgsj8VKFdB3l1tsKhLWenFE96IgOoWbKK5h91fRcXP7nzOAZgVayOVLOQSuQMMU78z9gTOD45G1eutGAd4D4WxS0qms0OITuDbvCX9wxZfZiMyQjTs8rz3Auxi7DA= 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 1784782358123173.79575855989356; Wed, 22 Jul 2026 21:52:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlPz-0000gG-MF; Thu, 23 Jul 2026 00:52:23 -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 1wmlPx-0000Rm-49 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:21 -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 1wmlPv-0004fs-Dz for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:20 -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-207-ZTt86k4uOE2IyN07IoWtvA-1; Thu, 23 Jul 2026 00:52: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 372A61800759; Thu, 23 Jul 2026 04:52:11 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 0A5E1180029D; Thu, 23 Jul 2026 04:52:01 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782338; 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=T5pYNtwR7SG5TiuFxq7Ubuc04yN+erb8vLnytfXqXS8=; b=WtZM0vA+OHzHe2xEkI197lSR4kCmaLqXNHKpi48GXEoR6tH/lAQX5wqsUZwvVAToKqRbhx OR3GB47ckTW3SBmyhvyFU+mBspq0+KLp8IYAHktYE7/ErP4ZilHxfJPIM5apatAoJF4WEI iMfID1aQgSbyBX2xuPu+mL1XeZy14jY= X-MC-Unique: ZTt86k4uOE2IyN07IoWtvA-1 X-Mimecast-MFC-AGG-ID: ZTt86k4uOE2IyN07IoWtvA_1784782331 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 23/44] qapi: convert trivial intro sections for transaction.json Date: Thu, 23 Jul 2026 00:47:44 -0400 Message-ID: <20260723044805.527643-24-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782360004158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782354; cv=none; d=zohomail.com; s=zohoarc; b=YbMuRQCm4IefN4ZdFuJUt+2h1yiZOFyXUW1jSlhMdERLNPG68mtoEonK91ZpTZ5pu/mVzINrNw7ne7gPqQbioK8seTHzDGEk3PEH2jdKzJ077EEZKbRVUtIEiYTAUNWPqHuXXaz+iKXyf8iwpXV/0zV5aoQmRHZX9sIrnDVPWGs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782354; 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=Qna4Kk34qAEZX+aFniaTwQbeBYZCyqG8FCN8r26Wd5s=; b=CIn8iU4uciPbOWGzxbP7IyYoU733DlS/ZnRGZIV8b4ywoxTD7+lxBe/kHV5tipiwNzRfvL+lRlnLkzMcQ5DxFOuhL2+Ndz0QXXfsablNPcxBdYxmblnmaAZZKBP4tJMKzApdsZKzeioQ0dOO+6WUvLI5+xsNIxcOTYGWFhQygrI= 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 17847823548558.9744605553675; Wed, 22 Jul 2026 21:52:34 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlQ6-0001ad-NX; Thu, 23 Jul 2026 00:52:30 -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 1wmlQ5-0001WS-TM for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:29 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlQ4-0004hA-Ab for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:29 -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-41-SIM3_0RqMgO2nvYLk4Ic4Q-1; Thu, 23 Jul 2026 00:52: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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 12CB8180A8E0; Thu, 23 Jul 2026 04:52:21 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 63B04180029D; Thu, 23 Jul 2026 04:52:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782347; 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=Qna4Kk34qAEZX+aFniaTwQbeBYZCyqG8FCN8r26Wd5s=; b=RCNXpRY2z9cRdom6pBwKudyx90GZFUPgRXVD99/eMyaZINmtQYqpxGOjFwX9DlbMhVs6er V91/bLEv7ViJ9y+otdydSLvJVtHuSV+GLLd6ALGvL8GFkavoTUqZmpOjN0liAEIuihEjw+ eoai/ypHMRRA2q9yDTLfHayqCEivbzU= X-MC-Unique: SIM3_0RqMgO2nvYLk4Ic4Q-1 X-Mimecast-MFC-AGG-ID: SIM3_0RqMgO2nvYLk4Ic4Q_1784782341 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 24/44] qapi: convert trivial intro sections for stats.json Date: Thu, 23 Jul 2026 00:47:45 -0400 Message-ID: <20260723044805.527643-25-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782355964158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782384; cv=none; d=zohomail.com; s=zohoarc; b=nXKoI8H7gWikWBT5sv11ukGoFXU0heY6cDXTsfEi83gB1uqFzxRoL+L4Kag4pNjHJUJVL5N0NIaPvxUvSaD1fAgCLnkRpani91pr6bYmuQCYSBLBvCfDFpnOlHyOAPFGed0MmQA2rXK9C0kBxDqCdb8Ersttms9M+4BCYF98T3g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782384; 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=ieD8d7uIFceTxEjKltR0VJrAkmqKTvXxTTZUmuZaZws=; b=jFKBeWjtY3IcuRQzIC0AJTrJowcgiSSRMQn4kB3Qe5qXBQD+kkyGFFaBVSX8io5IE4Ic8OdbiSLzDLsQ5qzcvU6gqBzdtDzyPfv+Ma3oKeWvVtM29McfjpQEtStdJVxd06ItZafjgyi6acMNs5XPCv3sHL8MRPjhAVg8pDznesM= 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 1784782384380738.9106169510812; Wed, 22 Jul 2026 21:53:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlQF-0002TS-59; Thu, 23 Jul 2026 00:52: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 1wmlQD-0002AD-3Y for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:37 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlQB-0004iF-KR for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:36 -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-684-eeCSOB1aOsS8UW4jt6eH7w-1; Thu, 23 Jul 2026 00:52: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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id C89AB19775B0; Thu, 23 Jul 2026 04:52:28 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 4947318002B5; Thu, 23 Jul 2026 04:52:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782355; 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=ieD8d7uIFceTxEjKltR0VJrAkmqKTvXxTTZUmuZaZws=; b=TO5OYDRSHQWavSbSDVbtWcKlV0Eres4pQt23N71X/1sfa8msbi+arT0T8oZN9YHVNxyDFy 85pOV8PLy2YX3XINp3KnzESxpX/Tfbi/MaKMWtWuCmuh+GLq2anT4W2mkpIJReD0131xua 6jmVAUjEnjLEHZ7vEymBeYfvharbzHs= X-MC-Unique: eeCSOB1aOsS8UW4jt6eH7w-1 X-Mimecast-MFC-AGG-ID: eeCSOB1aOsS8UW4jt6eH7w_1784782348 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 25/44] qapi: convert trivial intro sections for job.json Date: Thu, 23 Jul 2026 00:47:46 -0400 Message-ID: <20260723044805.527643-26-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782386081158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782421; cv=none; d=zohomail.com; s=zohoarc; b=URBpuxd6W1t6PnFgS/8yQoHq3+GZcqv9f9UNNGVm4yIdvEoLRe0QVIq7cLJzjymepa1AocsbNsdFJFB8zqe++UhnqM49Ga0E+Ps+ON8qm6ra9T9Q++ou+0cQ1mICwGHXNIgwnsCofkuuKlJTJk4+ZUugqJuzXZ1BBOS2teJJEQ4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782421; 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=pvnZrfXGzB4HFIplW/5U/ErhFdiu8ZVe2fFge+4xFIc=; b=bBf7RmtGcXseQjVOUa9V9tS8uuvYZE4k8rBoNdBxDi6PxM6GBI/7AlwXFcuzUEbYtmLDAWQC52JxCy2DYGQH+UBUV1WiiriG1JI7giLJ6NI1FyzeA4NcaqXYXg1RNvjTOMNz08hVufb0vQQDKD/4K6Ye6OD1vKG3qk1sTlx0q1A= 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 1784782421497342.5515648572583; Wed, 22 Jul 2026 21:53:41 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlQf-00038P-HI; Thu, 23 Jul 2026 00:53:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlQO-0002vr-2P for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:51 -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 1wmlQL-0004jM-SR for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:47 -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-664-wd4iwakjORKRG7QDMyIIYw-1; Thu, 23 Jul 2026 00:52: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 D070D190C40C; Thu, 23 Jul 2026 04:52:38 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 0C3AB18002B6; Thu, 23 Jul 2026 04:52:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782365; 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=pvnZrfXGzB4HFIplW/5U/ErhFdiu8ZVe2fFge+4xFIc=; b=YBFZryQ/7f8WBFb+SgYeYmeVHjEaNHmeF9DUw5nULXxUBlWqhV0/qAHIA62hWSQtkOPLfX z9A4rVMQJzFmgjfl3njJPY7pMrXvl5EwWnSDFiNZtH5lV3e4pOBESifB8oXWqHiLNhwQHB WS2kI6tEn5w0fO74OlOKXKMFiABShpo= X-MC-Unique: wd4iwakjORKRG7QDMyIIYw-1 X-Mimecast-MFC-AGG-ID: wd4iwakjORKRG7QDMyIIYw_1784782359 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 26/44] qapi: convert intro sections for pci.json Date: Thu, 23 Jul 2026 00:47:47 -0400 Message-ID: <20260723044805.527643-27-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782422246158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782489; cv=none; d=zohomail.com; s=zohoarc; b=Yg/9oysHqM2TB7amSnR5ksP763desaCW9STpj2Y7BxkbTYiEbbfnV5+vZClOI4vGOUsKWc2V84O8Vw3qFeFCL81QQNMaCnkcXnOQKVfza5v0MYpiF3LLPi1SdzsGhK9fMD/XB8hTfe6O7ZeM3LZmhRb2B9yEUA2u6vt5GOUA/1U= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782489; 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=94ztoHJSekPaBu9gQO06nFEY6BVwCOp3ZmuxtD8vWVs=; b=QvXfsxPY+AtCvlvYmQQ/WRnfBExJ0LR9DGjnTn2/n8H9r2pGlfDuinp6E5/LFEphp1DXmI8fql7sLdBsEMtxiNHgUPrk3mkHMCeosXKsJi+eNYmFedDfKkqutWPmacTrnRq56QOnwkCh8N9u581cYLtEcwQ+5qI0Vv+gd1ZUizk= 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 1784782489923996.6001671117765; Wed, 22 Jul 2026 21:54:49 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlQi-0003Nj-Gv; Thu, 23 Jul 2026 00:53:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlQW-0002zW-3p for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52: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 1wmlQU-0004mX-Ib for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:52:55 -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-28-eyNaZrN6Oli8Es0NTKYNFQ-1; Thu, 23 Jul 2026 00:52:50 -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 3D7A21977517; Thu, 23 Jul 2026 04:52:47 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 528D3180029D; Thu, 23 Jul 2026 04:52:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782374; 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=94ztoHJSekPaBu9gQO06nFEY6BVwCOp3ZmuxtD8vWVs=; b=ZebUIa4HBqrHwgySKQ6LICxR7hQLUo43pTBiQYivbX49KFP2Z3yte2gP9cmF3iKa1kGu2b q6+dVBqz3UCGeJxvGP6eyENKtKUh3s78zNgxUe37PSbP3AQA5gMseFT9nA7z++l9eP4Um0 L7zKc4DIaJnhVxFHVqbZ7ksWgU9FuXI= X-MC-Unique: eyNaZrN6Oli8Es0NTKYNFQ-1 X-Mimecast-MFC-AGG-ID: eyNaZrN6Oli8Es0NTKYNFQ_1784782367 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 27/44] qapi: convert trivial intro sections for introspect.json Date: Thu, 23 Jul 2026 00:47:48 -0400 Message-ID: <20260723044805.527643-28-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782490659158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/introspect.json | 45 ++++++++++++++++---------------------------- 1 file changed, 16 insertions(+), 29 deletions(-) diff --git a/qapi/introspect.json b/qapi/introspect.json index c8432c8ed8e..bd42aac3358 100644 --- a/qapi/introspect.json +++ b/qapi/introspect.json @@ -55,9 +55,8 @@ =20 ## # @SchemaMetaType: -# -# This is a `SchemaInfo`'s meta type, i.e. the kind of entity it -# describes. +# This is a `SchemaInfo`'s meta type, i.e. the kind of entity it +# describes. # # @builtin: a predefined type such as 'int' or 'bool'. # @@ -112,8 +111,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 +122,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 +150,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 +174,7 @@ =20 ## # @SchemaInfoEnumMember: -# -# An object member. +# An object member. # # @name: the member's name, as defined in the QAPI schema. # @@ -193,8 +188,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 +201,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 +225,7 @@ =20 ## # @SchemaInfoObjectMember: -# -# An object member. +# An object member. # # @name: the member's name, as defined in the QAPI schema. # @@ -257,8 +249,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 +263,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 +278,7 @@ =20 ## # @SchemaInfoAlternateMember: -# -# An alternate member. +# An alternate member. # # @type: the name of the member's type. # @@ -300,8 +289,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 +310,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 Fri Jul 24 05:22:03 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=1784782392; cv=none; d=zohomail.com; s=zohoarc; b=XUTjNWedGqU8wMGZLkLY3oT2OYvrZ1bINcMkXWQXWTCe4N9SNSD8P4Klp2pP5hv16dLsN1YcdgSAO8FG8ToTFyrXTYw6kX7Pn9MBmSyHqnuUTwBxI376d8AMme1O5NIUKMoHvudxal/8gMQIG71+wfUk+SWNqHU2xSJu8xbr8Ms= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782392; 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=BuLUJmRQbdL+tiBVb/y3st603k+nuJ/NK2BP1mGjFEM=; b=hdaxFWYh2H65UGCW+BMFjuf0GbMNEVu/QqhPEpQxpddqzamEPbtQjB02h8HGH070pulu5+e8WWot/ZNoXcjWaIUws2ICyHfTl6/nizAjvw/sPL49iPMHkPK72ETEqR6LKZ1b8NnJTtT8wfUAEeGdnrtXIqoxOggJouF0/gWULWY= 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 1784782392776696.6573091189158; Wed, 22 Jul 2026 21:53:12 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlQj-0003RS-8H; Thu, 23 Jul 2026 00:53:09 -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 1wmlQg-0003Ej-Pu for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:07 -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 1wmlQf-0004qJ-7c for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53: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-205-CFvqc4DOO3CwZcM_zo-wjQ-1; Thu, 23 Jul 2026 00:53:00 -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 3B2AC1805F18; Thu, 23 Jul 2026 04:52:57 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id B996F18002B5; Thu, 23 Jul 2026 04:52:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782384; 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=BuLUJmRQbdL+tiBVb/y3st603k+nuJ/NK2BP1mGjFEM=; b=ONgIDb4VlLxw/7kqvnMpADr39d6WbmQ9M+B+Eu6S0DIZwvh4eoL6UywZqtZBwFgCFcJs/9 SpIJqbVOff8nyAE02mgIA+7v21y05q6tC2Q3YWURyUOABiPU/UKLKRbtD0KmNsaBZKsn69 BDUY3Q81lzJjIktIYfnkFlgYrP3yBoA= X-MC-Unique: CFvqc4DOO3CwZcM_zo-wjQ-1 X-Mimecast-MFC-AGG-ID: CFvqc4DOO3CwZcM_zo-wjQ_1784782377 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 28/44] qapi: convert intro sections for rocker.json Date: Thu, 23 Jul 2026 00:47:49 -0400 Message-ID: <20260723044805.527643-29-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782394103158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782549; cv=none; d=zohomail.com; s=zohoarc; b=ZSV/a0sS2s+HpthAE2tOJu60x2moco8+/yjnw59dmmQwhPSPSrMmzPNNhRn35hTEikOowML8H8VDo/tY+B2PZBk1T+dKHHKQACCIEjzltFSibnTZNSQlzMkggvWgn4SmIj+G8h6/InTMDdhMKKiFkIDpY7NoQ49DCvFFP/5AaHc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782549; 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=TZNZu5l6HDHHmDozotlg5GKJJCb4xlZSAIjE4YcKWdo=; b=Vq7qf5wAeIA8W0L9ZIBwQwf29Hl4BFDvVrMnQ2YDJM6i6c/Ts1+zP5VdjSHwOJ8iGxnRl+rxJWs99JMCNX22u+iaLMdrhW3o1JnEaz4qeNs0/qqSO7c62j2NqYt9XvpzxRVh9xWz2S9od0XRu/isHwnkyWhckj8D2JbrnKJwjog= 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 1784782549162973.0403563096523; Wed, 22 Jul 2026 21:55:49 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlR7-0004B2-Ue; Thu, 23 Jul 2026 00:53:35 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlQr-0003yf-Jl for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:21 -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 1wmlQo-0004rf-Py for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:16 -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-634-JDYUe2VaNfGJJkoGCkgShQ-1; Thu, 23 Jul 2026 00:53: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id CD0971944DCE; Thu, 23 Jul 2026 04:53:05 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A71CC18002AE; Thu, 23 Jul 2026 04:52:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782394; 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=TZNZu5l6HDHHmDozotlg5GKJJCb4xlZSAIjE4YcKWdo=; b=IGyC/fQ6cIurI8L5TMpF7cv9g2meaCbTn5HQADu5JVjFq0LnGWl+9jR8PbLs2TaSmkaA1s b3I2vt1ixhhE8HCOXY0iSYUszUJLbcYC6vncfeo/7Rx9ygiPAfrR/hsHC5zUhfgyEpe/th 37an6vKnvGzbaWrHBuE8VA2n15jeuWY= X-MC-Unique: JDYUe2VaNfGJJkoGCkgShQ-1 X-Mimecast-MFC-AGG-ID: JDYUe2VaNfGJJkoGCkgShQ_1784782385 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 29/44] qapi: convert trivial intro sections for misc-i386.json Date: Thu, 23 Jul 2026 00:47:50 -0400 Message-ID: <20260723044805.527643-30-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782553005158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782528; cv=none; d=zohomail.com; s=zohoarc; b=T8TdV05sTfo93anW58lNr+1cxJ0s2fqAwhva80jTi21js+S6zj6T2cMoLN0JXcfMHhog6W6LlndE/FqOswuSpu+0dzK2y4ZyQB+HYDMVm0so5xuBKk6FKmCnPmqrpRaoc9lFbecV4hLCEW0vdASgZrPlUKWDz/ViubFHKrWJlm4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782528; 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=CqpQURYzqagcZw6PUEaGQX94Y2bhPgrE5ybIwr9ASNk=; b=etoooh2ERRlrQVsw5wBwlLjVnFcLMVkqMy6n25zAxN9vXxwSpEm6S5EOFxMd6XKpxw/XDEd1AvN17s8qp4XkE3HNc0awYJl/dty5v9Wk8GsB0cpJByEm5yLDQEmZyC9tiXx+qQcUMZI3bPzLBwySYitbilDUG1madne+A47nqYk= 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 178478252802997.2616481353108; Wed, 22 Jul 2026 21:55:28 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlRE-0004P8-LM; Thu, 23 Jul 2026 00:53: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 1wmlR2-0004CF-Vl for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53: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 1wmlQz-0004su-F5 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:28 -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-694-2u3NbkSaOaqH6BtjDhRcyA-1; Thu, 23 Jul 2026 00:53:19 -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 77ED41805F05; Thu, 23 Jul 2026 04:53:16 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EDD4918002AE; Thu, 23 Jul 2026 04:53:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782404; 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=CqpQURYzqagcZw6PUEaGQX94Y2bhPgrE5ybIwr9ASNk=; b=hapXdTNTYf8mV+OG32ChQe1Et+utbyvW1H2Fv3tA1+uYWxXAX03519gSW1eQvBSuXMkA8D IfREduCmV5LYZ4Y5Uxm4hBhhtugrqC5j1BFI47i0qJaP3SRntBZQ+IJh7OoNWgLnh0DE2t FPTWzVAxHGGJTZlUiRvHZABR4HGeePQ= X-MC-Unique: 2u3NbkSaOaqH6BtjDhRcyA-1 X-Mimecast-MFC-AGG-ID: 2u3NbkSaOaqH6BtjDhRcyA_1784782396 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 30/44] qapi: convert trivial intro sections for block-export.json Date: Thu, 23 Jul 2026 00:47:51 -0400 Message-ID: <20260723044805.527643-31-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782528713158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/block-export.json | 87 +++++++++++++++++------------------------- 1 file changed, 35 insertions(+), 52 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index dd724acf1cb..e9f7e72c8ee 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -37,10 +37,9 @@ =20 ## # @NbdServerOptions: -# -# Keep this type consistent with the `NbdServerOptionsLegacy` type. -# The only intended difference is using `SocketAddress` instead of -# `SocketAddressLegacy`. +# Keep this type consistent with the `NbdServerOptionsLegacy` +# type. The only intended difference is using `SocketAddress` +# instead of `SocketAddressLegacy`. # # @addr: Address on which to listen (since 4.2). ## @@ -50,10 +49,9 @@ =20 ## # @NbdServerOptionsLegacy: -# -# Keep this type consistent with the `NbdServerOptions` type. The -# only intended difference is using `SocketAddressLegacy` instead of -# `SocketAddress`. +# Keep this type consistent with the `NbdServerOptions` type. The +# only intended difference is using `SocketAddressLegacy` instead +# of `SocketAddress`. # # @addr: Address on which to listen (since 1.3). ## @@ -63,11 +61,11 @@ =20 ## # @nbd-server-start: -# -# Start an NBD server listening on the given host and port. Block -# devices can then be exported using `nbd-server-add`. The NBD server -# will present them as named exports; for example, another QEMU -# instance could refer to them as "nbd:HOST:PORT:exportname=3DNAME". +# Start an NBD server listening on the given host and port. Block +# devices can then be exported using `nbd-server-add`. The NBD +# server will present them as named exports; for example, another +# QEMU instance could refer to them as +# "nbd:HOST:PORT:exportname=3DNAME". # # Errors: # - if the server is already running @@ -80,9 +78,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 +94,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 +117,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 +138,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 +189,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 +214,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 +258,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 +280,7 @@ =20 ## # @nbd-server-remove: -# -# Remove NBD export by name. +# Remove NBD export by name. # # @name: Block export id. # @@ -316,9 +306,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 +316,7 @@ =20 ## # @BlockExportType: -# -# An enumeration of block export types +# An enumeration of block export types # # @nbd: NBD export # @@ -349,9 +337,8 @@ =20 ## # @BlockExportOptions: -# -# Describes a block export, i.e. how single node should be exported on -# an external interface. +# Describes a block export, i.e. how single node should be +# exported on an external interface. # # @type: Block export type # @@ -412,9 +399,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 +422,7 @@ =20 ## # @block-export-add: -# -# Creates a new block export. +# Creates a new block export. # # Since: 5.2 ## @@ -447,10 +432,10 @@ =20 ## # @block-export-del: -# -# Request to remove a block export. This drops the user's reference -# to the export, but the export may still stay around after this -# command returns until the shutdown of the export has completed. +# Request to remove a block export. This drops the user's +# reference to the export, but the export may still stay around +# after this command returns until the shutdown of the export has +# completed. # # @id: Block export id. # @@ -470,8 +455,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 +466,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 Fri Jul 24 05:22:03 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=1784782642; cv=none; d=zohomail.com; s=zohoarc; b=idlXYXX8sUSY++1u2w2K3tmHCNFwHjQZkz0kQR6jmHGNACRDSzk/grzEcBpSzkEd6TF8GgSNR0OXzMX0RtIa/S4TbT9CKcPvkzZVyHc/aMMy5MqxehDzyf3TeDiyZ0Ewk1jiSbBCqhx4xneNGgP23YN9fSZapKn6DDJhV4DmuUA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782642; 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=5/2uhrWWVYdwPSV/13kr7Ak4m/dnZp9BNOXlkV3GBQo=; b=Tuuzf6ZJSY6vjQPwPg70xdnfkaaBLpuLr/ILh2NQ43+lY2fnw2kA4nDOZrgfaoyJFe3hMZ9+q/sdGz69t/W8VM7Wrfnkd0DhkDx8Bzs5qddbKiHI8yvdGYLPRfmJb8ERjKZLh7Rt0Ej7im2fW/JXmP4kFxVTGoJFlJi1VlvK/QE= 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 1784782642448268.7781888594375; Wed, 22 Jul 2026 21:57:22 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlRD-0004N2-Um; Thu, 23 Jul 2026 00:53: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 1wmlRA-0004FK-CL for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:36 -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 1wmlR7-0004vo-IU for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:36 -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-141-yJMV-JLBMomuOkDWls3wDg-1; Thu, 23 Jul 2026 00:53: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AFAF71800759; Thu, 23 Jul 2026 04:53:26 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5BFBC18002AE; Thu, 23 Jul 2026 04:53:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782411; 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=5/2uhrWWVYdwPSV/13kr7Ak4m/dnZp9BNOXlkV3GBQo=; b=O2qXmxAg5FNUKEIF1jsv1SqqomSK5Ytr7sHQgqlwPABk3ss5BD9BrL5/IQSATaB9gCxQj7 5uOdEs38BMUch5kBKSdqOxCR+23Rq3KksX2qejhuGP60tNhUzaMppg7QS/f7hFxNi1xDAE Yweu9y2qOENg77HETjTyTvClrHtZwLg= X-MC-Unique: yJMV-JLBMomuOkDWls3wDg-1 X-Mimecast-MFC-AGG-ID: yJMV-JLBMomuOkDWls3wDg_1784782406 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 31/44] qapi: convert intro sections for audio.json Date: Thu, 23 Jul 2026 00:47:52 -0400 Message-ID: <20260723044805.527643-32-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782643238158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782573; cv=none; d=zohomail.com; s=zohoarc; b=lJAhf15RxzmeLDx+QplKx8ifW+CVtNCjakvRAv53sjKgdDFoR7TUVceSJnRTJc2xw6JhrcJhugSX9UIDqHVfIL7e475Y7uEPM8562y4KjJQPWSqa2YTE+lAOakXZnQPK2sHuMyNs7Mmuk0r5TrE2/fTEYnOjPXPbgy/9iZpEPyA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782573; 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=WvVNT9FP84PI//trYRCoAZS9q9GdrG1oeUvWQayikpo=; b=bwpbpyVH71SaweA/RDDKHgHWEpAajl1vVwfwxhvrhFtPtmMfHv+S1EvUPhQibQk4qBYE4eKFjsNY8hk90YDstEKikiKvRoCDvGvVpdE+0Y7+UdBYz2IGqaufJH7fdt9YwFlKXOa2YIKfN5paLcr8f9MdqjZutZlGDZ8rq7vkZnk= 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 1784782573167100.8637811364872; Wed, 22 Jul 2026 21:56:13 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlRd-0004r1-Ad; Thu, 23 Jul 2026 00:54:10 -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 1wmlRM-0004YD-LZ for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:52 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlRK-0004xc-7V for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53: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-193-Z0nYtQrROaGc1WxEnAlu_g-1; Thu, 23 Jul 2026 00:53:40 -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 009F61977539; Thu, 23 Jul 2026 04:53:36 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5DE9318002B4; Thu, 23 Jul 2026 04:53:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782425; 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=WvVNT9FP84PI//trYRCoAZS9q9GdrG1oeUvWQayikpo=; b=UEtELHgYSfgLcfWXxBzrsPL3ArzJR1pLdVIEJkdpjFaiRncOQJ5h+7kWc5kywivbi6fctQ QVCW6AbFwrxWD9zmI5gBVvr5h40NEfw+Nebrp3dZPqZ7MqgdQJV308E2eGh3lGEaer+4En 3K1bajn7fThp2Fk2y00W+xdS5z0WKXc= X-MC-Unique: Z0nYtQrROaGc1WxEnAlu_g-1 X-Mimecast-MFC-AGG-ID: Z0nYtQrROaGc1WxEnAlu_g_1784782416 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 32/44] qapi: convert trivial intro sections for block.json Date: Thu, 23 Jul 2026 00:47:53 -0400 Message-ID: <20260723044805.527643-33-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782575000158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/block.json | 58 +++++++++++++++++++++---------------------------- 1 file changed, 25 insertions(+), 33 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 46955bbb3e3..e47592d5500 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -16,11 +16,10 @@ =20 ## # @BiosAtaTranslation: -# -# Policy that BIOS should use to interpret cylinder/head/sector -# addresses. Note that Bochs BIOS and SeaBIOS will not actually -# translate logical CHS to physical; instead, they will use logical -# block addressing. +# Policy that BIOS should use to interpret cylinder/head/sector +# addresses. Note that Bochs BIOS and SeaBIOS will not actually +# translate logical CHS to physical; instead, they will use +# logical block addressing. # # @auto: If cylinder/heads/sizes are passed, choose between none and # LBA depending on the size of the disk. If they are not passed, @@ -50,8 +49,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 +69,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 +83,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 +96,7 @@ =20 ## # @eject: -# -# Ejects the medium from a removable drive. +# Ejects the medium from a removable drive. # # @device: Block device name # @@ -264,10 +260,10 @@ =20 ## # @blockdev-insert-medium: -# -# Inserts a medium (a block driver state tree) into a block device. -# That block device's tray must currently be open (unless there is no -# attached guest device) and there must be no medium inserted already. +# Inserts a medium (a block driver state tree) into a block +# device. That block device's tray must currently be open (unless +# there is no attached guest device) and there must be no medium +# inserted already. # # @id: The name or QOM path of the guest device # @@ -297,9 +293,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 +309,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 +379,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 +407,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 Fri Jul 24 05:22:03 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=1784782494; cv=none; d=zohomail.com; s=zohoarc; b=XBgfWO1pwt+2ugQa6G32qSJIfOYA6KCNy8r+NDdCRIRT9CkGLOeo04ej4C8XlWfBlbsszZqncXe7vnbFuSwyIZDfD+8pe4MGxBOnERrchA6meJByBHwf2SJUXfqNN07di/GfU4G2/m5t34sItp2yMMHL5bE7ZoiRF+Q6CLYtWkc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782494; 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=C5ZFK317af8k7vK41sqW9/bk4KqnTjOp+hPzob9LuBos+Sw7oFY/gKuttO/etVgeblviaiQkEE7oASMVnwuGKoVIhXLJ2bEQAtVsnbQX0Ksk2/0HnuVRVoKrDtA3VZWhG0nq84lDx52kboRnlT3uT28c32LynPQ3Gr/8UB2i+E0= 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 1784782494928381.75126423732036; Wed, 22 Jul 2026 21:54:54 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlRw-00050C-3d; Thu, 23 Jul 2026 00:54: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 1wmlRU-0004qm-WA for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53: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 1wmlRS-0004yK-B2 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:53:56 -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-5-lplzGk48Ne-oI1ZVlthRcg-1; Thu, 23 Jul 2026 00:53: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 910711955DC2; Thu, 23 Jul 2026 04:53:45 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id AC9F918002B4; Thu, 23 Jul 2026 04:53:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782433; 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=hpmKaK99oEAaWNwzsim00n/qPwvcvzDHQbI6jvQFYrm58J4D1g+R6ZBsCwR3LuJhkWEgvj oQMTxidpWMpKESqyB7TxFNiuG3X/Txr0e9dw+4yFGFU+c2mhZ+YzUuKlOF78zQdJntt4cb Mea5dp1z15l5Ja87tiLz9dls+jZOjN4= X-MC-Unique: lplzGk48Ne-oI1ZVlthRcg-1 X-Mimecast-MFC-AGG-ID: lplzGk48Ne-oI1ZVlthRcg_1784782425 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 33/44] qapi: convert trivial intro sections for misc.json Date: Thu, 23 Jul 2026 00:47:54 -0400 Message-ID: <20260723044805.527643-34-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782496538158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782596; cv=none; d=zohomail.com; s=zohoarc; b=IPaXPhc5eslZT9hDvBarzyW87mENKOA+pHJF5HKpA1WfWGjVoKeXU6iKGEjJOkKueFMUdHCbpTYVLCweCt8hRyMEWIwafOT5RBnXRk8RWOObd1NKi6zVVlYIOOOVyn2jtb03gGcrOpKMN0Fo4dr/ktI+cpCLRxBS8IjyEvFBPm4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782596; 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=lCYDP6Hrj8CzePr1mYVT3Ek4VxvkfuHjDMXZ3o0GlI0=; b=NouTtC+KHQ6/FuHHp7YnTaU6d3mJTfUmYJcUOeOGw0IJdgS0DwwIpYHuBk0otnNB1mTpdtAPcv3tP0m6JFmHJf3PjKeMHuqIOqi1oMVwel4SgRxEEvgN1qqjdzDsCp/rlQ06G49bNsqGt11UklfV/ogarto/dwhKUjzIXEwMIf8= 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 1784782596873133.42818192488096; Wed, 22 Jul 2026 21:56:36 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlS0-0005EF-8e; Thu, 23 Jul 2026 00:54: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 1wmlRf-0004uz-ET for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:10 -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 1wmlRc-0004z2-6U for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:05 -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-186-flsMf9TDOHOS0HUxRx7iBg-1; Thu, 23 Jul 2026 00:53:59 -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 EE8051955DEA; Thu, 23 Jul 2026 04:53:55 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id D62A618002AE; Thu, 23 Jul 2026 04:53:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782443; 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=lCYDP6Hrj8CzePr1mYVT3Ek4VxvkfuHjDMXZ3o0GlI0=; b=QKGOCh2fdZh8KX2S0D2Bp7BBu5n49blqs/3chiJ/CPhWYXp+uKWkyN8QhOkNCKRdPvOAX4 bF5ZIEpSm3FE5djCcp+6MNdWeZiHbQTh5775gFaUY48Y26Qq/+gA64H9oc6oRL3c1AUQ+M rr1O3PYYAMuwrrDYBM2Gd7QNqOtYWD4= X-MC-Unique: flsMf9TDOHOS0HUxRx7iBg-1 X-Mimecast-MFC-AGG-ID: flsMf9TDOHOS0HUxRx7iBg_1784782436 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 34/44] qapi: convert trivial intro sections for crypto.json Date: Thu, 23 Jul 2026 00:47:55 -0400 Message-ID: <20260723044805.527643-35-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782599066158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/crypto.json | 118 ++++++++++++++++++----------------------------- 1 file changed, 45 insertions(+), 73 deletions(-) diff --git a/qapi/crypto.json b/qapi/crypto.json index 2b55befef97..5c821be1a33 100644 --- a/qapi/crypto.json +++ b/qapi/crypto.json @@ -10,10 +10,10 @@ =20 ## # @QCryptoTLSCredsEndpoint: -# -# The type of network endpoint that will be using the credentials. -# Most types of credential require different setup / structures -# depending on whether they will be used in a server versus a client. +# The type of network endpoint that will be using the credentials. +# Most types of credential require different setup / structures +# depending on whether they will be used in a server versus a +# client. # # @client: the network endpoint is acting as the client # @@ -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 # @@ -128,11 +124,11 @@ =20 ## # @QCryptoIVGenAlgo: -# -# The supported algorithms for generating initialization vectors for -# full disk encryption. The 'plain' generator should not be used for -# disks with sector numbers larger than 2^32, except where -# compatibility with pre-existing Linux dm-crypt volumes is required. +# The supported algorithms for generating initialization vectors +# for full disk encryption. The 'plain' generator should not be +# used for disks with sector numbers larger than 2^32, except +# where compatibility with pre-existing Linux dm-crypt volumes is +# required. # # @plain: 64-bit sector number truncated to 32-bits # @@ -148,8 +144,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. @@ -163,8 +158,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 # @@ -175,8 +170,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 @@ -189,8 +183,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 @@ -203,8 +196,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'. @@ -237,9 +229,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 ## @@ -251,9 +242,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 ## @@ -265,9 +255,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 # @@ -278,8 +267,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 # @@ -299,8 +287,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 # @@ -338,8 +325,7 @@ =20 ## # @QCryptoBlockInfo: -# -# Information about the block encryption options +# Information about the block encryption options # # Since: 2.7 ## @@ -350,8 +336,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 # @@ -365,9 +350,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 # @@ -407,9 +391,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 ## @@ -421,8 +404,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) @@ -463,8 +445,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 # @@ -477,8 +458,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 @@ -503,8 +483,7 @@ =20 ## # @TlsCredsAnonProperties: -# -# Properties for tls-creds-anon objects. +# Properties for tls-creds-anon objects. # # Since: 2.5 ## @@ -514,8 +493,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 @@ -529,8 +507,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) @@ -550,8 +527,7 @@ =20 ## # @QCryptoAkCipherAlgo: -# -# The supported algorithms for asymmetric encryption ciphers +# The supported algorithms for asymmetric encryption ciphers # # @rsa: RSA algorithm # @@ -562,8 +538,7 @@ =20 ## # @QCryptoAkCipherKeyType: -# -# The type of asymmetric keys. +# The type of asymmetric keys. # # @public: public key # @@ -576,8 +551,7 @@ =20 ## # @QCryptoRSAPaddingAlgo: -# -# The padding algorithm for RSA. +# The padding algorithm for RSA. # # @raw: no padding used # @@ -590,8 +564,7 @@ =20 ## # @QCryptoAkCipherOptionsRSA: -# -# Specific parameters for RSA algorithm. +# Specific parameters for RSA algorithm. # # @hash-alg: `QCryptoHashAlgo` # @@ -605,9 +578,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 Fri Jul 24 05:22:03 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=1784782630; cv=none; d=zohomail.com; s=zohoarc; b=IiTqmjogbY2ISBc1JAeYzcvRIM6+CKWD+U0vaSxTsEbdqLLlObEWTIBSgHqYh4SS+8EFG8ipR9OHu0uAVPvZSaoUUXmt4VV+Nr7VXYBNRGsyAXWsoKMvxouOSINvmJZ1n2I+92Xi6RTNwYSMmNlbVJobSBMvJZs5LOccVgAMcBM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782630; 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=QarlhGnhBJh2uFLeYPSVEUbavGwmNcs8TuDveYf+Ky0=; b=nDZoj1iO556MaWzCvAbfzBiu2ZiXKiPUm3WRhiD18yYl3E6FVljayjvvuyq0FlK9LFH7c5xt45jWIxKsvUFHkBUuuWrn13R7XnEASF73b+yqhyxAudveW5Xb2D4PaF9nAOBgKDBudB+78R7LenQ7JDcengnLw0aXuamyl9gTB/U= 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 1784782630316461.53506171799074; Wed, 22 Jul 2026 21:57:10 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlS5-0005U2-HI; Thu, 23 Jul 2026 00:54: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 1wmlRp-0004zG-SP for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:20 -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 1wmlRm-0004zi-Oz for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:17 -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-645-ZDwcKhefPIqMArqUkbP7BQ-1; Thu, 23 Jul 2026 00:54: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 5DF79182E6BB; Thu, 23 Jul 2026 04:54:06 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6D89C18002AE; Thu, 23 Jul 2026 04:53:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782454; 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=QarlhGnhBJh2uFLeYPSVEUbavGwmNcs8TuDveYf+Ky0=; b=TFUAF7PqptZ/XiXTeJ+x92b/f5i/ExEZZzuxmHlhv6crOhjkysw+BBi8+M172Euccdp6fL nUT4LRscKGDLGrhLjxRXBTdMGRNl011Cq4zihBxszESfewhUWlpjJSBaMZ7w0tQ17BeYw2 3LrxYQANyCUA9MRN/KMm1GZKOCWRTBY= X-MC-Unique: ZDwcKhefPIqMArqUkbP7BQ-1 X-Mimecast-MFC-AGG-ID: ZDwcKhefPIqMArqUkbP7BQ_1784782446 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 35/44] qapi: convert intro sections for cxl.json Date: Thu, 23 Jul 2026 00:47:56 -0400 Message-ID: <20260723044805.527643-36-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782631057158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/cxl.json | 128 ++++++++++++++++++++++---------------------------- 1 file changed, 56 insertions(+), 72 deletions(-) diff --git a/qapi/cxl.json b/qapi/cxl.json index 81d6198ba03..9422d5a0e2d 100644 --- a/qapi/cxl.json +++ b/qapi/cxl.json @@ -9,9 +9,9 @@ =20 ## # @CxlEventLog: -# -# CXL has a number of separate event logs for different types of -# events. Each such event log is handled and signaled independently. +# CXL has a number of separate event logs for different types of +# events. Each such event log is handled and signaled +# independently. # # @informational: Information Event Log # @@ -32,9 +32,8 @@ =20 ## # @CXLCommonEventBase: -# -# Common event base for a CXL Event (CXL r3.2 8.2.10.2.1 -# Table 8-55 Common Event Record Format). +# Common event base for a CXL Event (CXL r3.2 8.2.10.2.1 Table +# 8-55 Common Event Record Format). # # @path: CXL type 3 device canonical QOM path # @@ -63,8 +62,7 @@ =20 ## # @CXLGeneralMediaEvent: -# -# Event record for a General Media Event (CXL r3.2 8.2.10.2.1.1). +# Event record for a General Media Event (CXL r3.2 8.2.10.2.1.1). # # @dpa: Device Physical Address (relative to @path device). Note # lower bits include some flags. See CXL r3.2 Table 8-57 General @@ -118,10 +116,9 @@ =20 ## # @cxl-inject-general-media-event: -# -# Inject an event record for a General Media Event (CXL r3.2 -# 8.2.10.2.1.1). This event type is reported via one of the event -# logs specified via the log parameter. +# Inject an event record for a General Media Event (CXL r3.2 +# 8.2.10.2.1.1). This event type is reported via one of the event +# logs specified via the log parameter. # # Since: 8.1 ## @@ -130,8 +127,7 @@ =20 ## # @CXLDRAMEvent: -# -# Event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). +# Event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). # # @dpa: Device Physical Address (relative to @path device). Note # lower bits include some flags. See CXL r3.2 Table 8-58 DRAM @@ -201,10 +197,9 @@ =20 ## # @cxl-inject-dram-event: -# -# Inject an event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). -# This event type is reported via one of the event logs -# specified via the log parameter. +# Inject an event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). +# This event type is reported via one of the event logs specified +# via the log parameter. # # Since: 8.1 ## @@ -213,8 +208,7 @@ =20 ## # @CXLMemModuleEvent: -# -# Event record for a Memory Module Event (CXL r3.2 8.2.10.2.1.3). +# Event record for a Memory Module Event (CXL r3.2 8.2.10.2.1.3). # # @type: Device Event Type. See CXL r3.2 Table 8-59 Memory Module # Event Record for bit definitions for bit definiions. @@ -267,10 +261,9 @@ =20 ## # @cxl-inject-memory-module-event: -# -# Inject an event record for a Memory Module Event (CXL r3.2 -# 8.2.10.2.1.3). This event includes a copy of the Device Health info -# at the time of the event. +# Inject an event record for a Memory Module Event (CXL r3.2 +# 8.2.10.2.1.3). This event includes a copy of the Device Health +# info at the time of the event. # # Since: 8.1 ## @@ -279,13 +272,12 @@ =20 ## # @cxl-inject-poison: -# -# Poison records indicate that a CXL memory device knows that a -# particular memory region may be corrupted. This may be because of -# locally detected errors (e.g. ECC failure) or poisoned writes -# received from other components in the system. This injection -# mechanism enables testing of the OS handling of poison records which -# may be queried via the CXL mailbox. +# Poison records indicate that a CXL memory device knows that a +# particular memory region may be corrupted. This may be because +# of locally detected errors (e.g. ECC failure) or poisoned writes +# received from other components in the system. This injection +# mechanism enables testing of the OS handling of poison records +# which may be queried via the CXL mailbox. # # @path: CXL type 3 device canonical QOM path # @@ -300,10 +292,9 @@ =20 ## # @CxlUncorErrorType: -# -# Type of uncorrectable CXL error to inject. These errors are -# reported via an AER uncorrectable internal error with additional -# information logged at the CXL device. +# Type of uncorrectable CXL error to inject. These errors are +# reported via an AER uncorrectable internal error with additional +# information logged at the CXL device. # # @cache-data-parity: Data error such as data parity or data ECC error # CXL.cache @@ -365,8 +356,7 @@ =20 ## # @CXLUncorErrorRecord: -# -# Record of a single error including header log. +# Record of a single error including header log. # # @type: Type of error # @@ -383,9 +373,8 @@ =20 ## # @cxl-inject-uncorrectable-errors: -# -# Command to allow injection of multiple errors in one go. This -# allows testing of multiple header log handling in the OS. +# Command to allow injection of multiple errors in one go. This +# allows testing of multiple header log handling in the OS. # # @path: CXL Type 3 device canonical QOM path # @@ -399,8 +388,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 # @@ -432,12 +420,11 @@ =20 ## # @cxl-inject-correctable-error: -# -# Command to inject a single correctable error. Multiple error -# injection of this error type is not interesting as there is no -# associated header log. These errors are reported via AER as a -# correctable internal error, with additional detail available from -# the CXL device. +# Command to inject a single correctable error. Multiple error +# injection of this error type is not interesting as there is no +# associated header log. These errors are reported via AER as a +# correctable internal error, with additional detail available +# from the CXL device. # # @path: CXL Type 3 device canonical QOM path # @@ -450,10 +437,9 @@ =20 ## # @CxlDynamicCapacityExtent: -# -# A single dynamic capacity extent. This is a contiguous allocation -# of memory by Device Physical Address within a single Dynamic -# Capacity Region on a CXL Type 3 Device. +# A single dynamic capacity extent. This is a contiguous +# allocation of memory by Device Physical Address within a single +# Dynamic Capacity Region on a CXL Type 3 Device. # # @offset: The offset (in bytes) to the start of the region where the # extent belongs to. @@ -471,10 +457,9 @@ =20 ## # @CxlExtentSelectionPolicy: -# -# The policy to use for selecting which extents comprise the added -# capacity, as defined in Compute Express Link (CXL) Specification, -# Revision 3.1, Table 7-70. +# The policy to use for selecting which extents comprise the added +# capacity, as defined in Compute Express Link (CXL) +# Specification, Revision 3.1, Table 7-70. # # @free: Device is responsible for allocating the requested memory # capacity and is free to do this using any combination of @@ -512,12 +497,12 @@ =20 ## # @cxl-add-dynamic-capacity: -# -# Initiate adding dynamic capacity extents to a host. This simulates -# operations defined in Compute Express Link (CXL) Specification, -# Revision 3.1, Section 7.6.7.6.5. Note that, currently, establishing -# success or failure of the full Add Dynamic Capacity flow requires -# out of band communication with the OS of the CXL host. +# Initiate adding dynamic capacity extents to a host. This +# simulates operations defined in Compute Express Link (CXL) +# Specification, Revision 3.1, Section 7.6.7.6.5. Note that, +# currently, establishing success or failure of the full Add +# Dynamic Capacity flow requires out of band communication with +# the OS of the CXL host. # # @path: path to the CXL Dynamic Capacity Device in the QOM tree. # @@ -558,10 +543,9 @@ =20 ## # @CxlExtentRemovalPolicy: -# -# The policy to use for selecting which extents comprise the released -# capacity, defined in the "Flags" field in Compute Express Link (CXL) -# Specification, Revision 3.1, Table 7-71. +# The policy to use for selecting which extents comprise the +# released capacity, defined in the "Flags" field in Compute +# Express Link (CXL) Specification, Revision 3.1, Table 7-71. # # @tag-based: Extents are selected by the device based on tag, with # no requirement for contiguous extents. @@ -578,12 +562,12 @@ =20 ## # @cxl-release-dynamic-capacity: -# -# Initiate release of dynamic capacity extents from a host. This -# simulates operations defined in Compute Express Link (CXL) -# Specification, Revision 3.1, Section 7.6.7.6.6. Note that, -# currently, success or failure of the full Release Dynamic Capacity -# flow requires out of band communication with the OS of the CXL host. +# Initiate release of dynamic capacity extents from a host. This +# simulates operations defined in Compute Express Link (CXL) +# Specification, Revision 3.1, Section 7.6.7.6.6. Note that, +# currently, success or failure of the full Release Dynamic +# Capacity flow requires out of band communication with the OS of +# the CXL host. # # @path: path to the CXL Dynamic Capacity Device in the QOM tree. # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782575; cv=none; d=zohomail.com; s=zohoarc; b=Q8OCcYOd+0SsfREEGLYq0tlH7EjHOubsyXKbnuqriOvufy9dOE2WlhQNaIKpVgjTsYdCAzKx1xVM/kCO8SO05T3rd1qSvNsJk7pynvTPbJrVbUEqLlq6zbrpdrZ2PYDAwkkjQIESygGrTptc4Wve5f2/u02LAEp/CtlPFQ98QNU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782575; 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=j66gSEdJekh31Cxv+QGs8EBkjEmWE9xovj2bAgh349I=; b=EkTB1Rxcz3816HSFnixgRndES08szndb4r/lH+jFnFpkfQMGid9J9fxPzQARboK+8P+PNiBGjXJ5YyCSHi3Tofau7moDtLV3iOkL8MoGxlkneq8+4PcqGoXE+RwzuO+jVibYqahXngvyO01SEgXOBK5Er+SkfGp9ef/PPkIbF3s= 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 1784782575913350.69178758897976; Wed, 22 Jul 2026 21:56:15 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlS0-0005Fe-Ay; Thu, 23 Jul 2026 00:54: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 1wmlRw-00052w-Ey for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:25 -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 1wmlRt-00050F-IH for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54: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-45-7i0Fa4lFPKK6BNYhHf8-hA-1; Thu, 23 Jul 2026 00:54:19 -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 CF1A51805F13; Thu, 23 Jul 2026 04:54:15 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id CE7E918002AE; Thu, 23 Jul 2026 04:54:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782460; 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=j66gSEdJekh31Cxv+QGs8EBkjEmWE9xovj2bAgh349I=; b=YcWffXW7cGIo36H/lvB3yEOjtVVt4alPyC4dRwvMpDjtz1/qZ6eWNPeKl/z32B9Uwuolcr gbAa5pb5cwpAsCiBcoIrhpI2WnlR4huN3xkkrNcbvHipsndsQ5Tr/EcriOmaNklUSQ1rd8 CMYuTVm29Ujbzv/zo54o9ZutvofIUKI= X-MC-Unique: 7i0Fa4lFPKK6BNYhHf8-hA-1 X-Mimecast-MFC-AGG-ID: 7i0Fa4lFPKK6BNYhHf8-hA_1784782456 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 36/44] qapi: convert trivial intro sections for run-state.json Date: Thu, 23 Jul 2026 00:47:57 -0400 Message-ID: <20260723044805.527643-37-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782576839158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/run-state.json | 120 +++++++++++++++++--------------------------- 1 file changed, 45 insertions(+), 75 deletions(-) diff --git a/qapi/run-state.json b/qapi/run-state.json index a5771ad4681..bc8c17477e2 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 # @@ -328,8 +315,7 @@ =20 ## # @RebootAction: -# -# Possible QEMU actions upon guest reboot +# Possible QEMU actions upon guest reboot # # @reset: Reset the VM # @@ -343,8 +329,7 @@ =20 ## # @ShutdownAction: -# -# Possible QEMU actions upon guest shutdown +# Possible QEMU actions upon guest shutdown # # @poweroff: Shutdown the VM and exit # @@ -375,8 +360,7 @@ =20 ## # @watchdog-set-action: -# -# Set watchdog action. +# Set watchdog action. # # @action: `WatchdogAction` action taken when watchdog timer expires. # @@ -392,9 +376,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. # @@ -425,8 +408,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" # @@ -445,8 +427,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" # @@ -465,8 +446,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 # @@ -479,8 +460,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 # @@ -495,8 +476,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 # @@ -513,8 +493,7 @@ =20 ## # @GuestPanicInformation: -# -# Information about a guest panic +# Information about a guest panic # # @type: Crash type that defines the hypervisor specific information # @@ -530,8 +509,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. @@ -560,8 +538,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 # @@ -586,8 +563,7 @@ =20 ## # @GuestPanicInformationS390: -# -# S390 specific guest panic information (PSW) +# S390 specific guest panic information (PSW) # # @core: core id of the CPU that crashed # @@ -607,10 +583,9 @@ =20 ## # @GuestPanicInformationTdx: -# -# TDX Guest panic information specific to TDX, as specified in the -# "Guest-Hypervisor Communication Interface (GHCI) Specification", -# section TDG.VP.VMCALL. +# TDX Guest panic information specific to TDX, as specified in the +# "Guest-Hypervisor Communication Interface (GHCI) Specification", +# section TDG.VP.VMCALL. # # @error-code: TD-specific error code # @@ -630,9 +605,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 # @@ -646,8 +620,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`. # @@ -673,8 +646,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). @@ -689,8 +661,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. @@ -717,8 +688,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). @@ -734,8 +704,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 Fri Jul 24 05:22:03 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=1784782580; cv=none; d=zohomail.com; s=zohoarc; b=G9aNFPiU0MfeyWSM2GMj9UPjRKgGLQNvpF0Bvl8/y6sUyj7Z8rVAjCsaidgEAubBDzjyViAb9LvJrmDLYQlv8KZeKuw/Li9wGcMQzor8YMuHSl91ZonZk2QIBR7ci4NyE2JMs6sg2z6W12l6OGYhoBSKjaR0ab/XudNF9XjDdm8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782580; 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=Y2l6GvJOHZN3iItpA5ipqrT2gVM1c+L15Fe47ufdVcE=; b=FnhkD3F2PJ82ULCP2z+mGcDkGmRey8MJIN2u+8Gk37MJJ1684G9rne/GhjjdmUvnuXpPO5bEkeCphmuksdjATNZvNr3ftjA9dg4eDBIyymhta/pyzAstJgj+GwoiReqWey9G6MgA9q3PshbVGIgPkNH4/HqIdD8lxsFLLM+gECg= 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 1784782580069641.3113150044064; Wed, 22 Jul 2026 21:56:20 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlS6-0005ZK-6n; Thu, 23 Jul 2026 00:54:34 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlS4-0005TY-G3 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54: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 1wmlS2-00054O-Nh for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54: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-441-cP_UqyUjPW6VzT4_S0CN1A-1; Thu, 23 Jul 2026 00:54:26 -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 CF1FC1944F10; Thu, 23 Jul 2026 04:54:23 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 2B26918002AE; Thu, 23 Jul 2026 04:54:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782470; 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=Y2l6GvJOHZN3iItpA5ipqrT2gVM1c+L15Fe47ufdVcE=; b=UcaKIhL3HaCq5N0Ni3mgAuoewYKu6wEE9qD0k+WHbSx6+sMUcPYYLihpqjkHnRqzyI+Lvc g2iUfCGGuPO6vYIylJZ16udpTpRDu5HsfY1ubotYyEWZdSwRc0vFQkpbYPTNCsbPFMZe5Z QUmZjuIKmSBVcm8HLW8TkEuH3+lZTNQ= X-MC-Unique: cP_UqyUjPW6VzT4_S0CN1A-1 X-Mimecast-MFC-AGG-ID: cP_UqyUjPW6VzT4_S0CN1A_1784782464 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 37/44] qapi: convert intro sections for char.json Date: Thu, 23 Jul 2026 00:47:58 -0400 Message-ID: <20260723044805.527643-38-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782580818158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- 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 Fri Jul 24 05:22:03 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=1784782561; cv=none; d=zohomail.com; s=zohoarc; b=fROlTywT5YLjTkY+ramSNzZkwko3GlIma8rbDaLHq7nfvVhITA87TvLB0I+pG4P3vzvhkK1C3bBuo9VX0+GGjnd8SEIGqG+1jPuJ0xWulYOkrQ+Wf5DZVj5Zz4nRlEpCa81A3XIi7JdajE5fQDY+IXCCIMN1UjeekXwSsWHMDJw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782561; 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=pYJwMcbrtQiolDG35OJu9PXoTbvWWWpVq26QLgHqBgg=; b=PdPvIs8NREvNKXrsa5bg7sRbmylPQ+44dSokoiMBOy//Q6PaogVc/1QTWKpI5ST4YJe0T6LiYlaG3sGMzSitBPqJPCqjlD1Tua8EsPSCOiZpjfLjxTJ5zc3mvAmOLvpRYva27efUeyCaz+dT40Q5ZotkvOZ0ZbHkVXOQM8bqOrM= 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 1784782561465613.0188553464927; Wed, 22 Jul 2026 21:56:01 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlSE-00061K-92; Thu, 23 Jul 2026 00:54: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 1wmlSC-0005wB-ER for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54: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 1wmlSA-00055P-H4 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:40 -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-221-olmRqzpzNQO5IiURxRhHVA-1; Thu, 23 Jul 2026 00:54: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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 0E00118E6A47; Thu, 23 Jul 2026 04:54:33 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 61D61180029D; Thu, 23 Jul 2026 04:54:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782477; 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=pYJwMcbrtQiolDG35OJu9PXoTbvWWWpVq26QLgHqBgg=; b=JX8wSrif111I2Qrz5cMXEdH71lTpbkbukYBo8KvSW54XzONzab3NuE8q22puX3he3fFYoB 6ezACqy34SMWRBJOm9C1BF4WylHTwlZ62HhVqILCfZ19oiCMEgixJ0VwzgVSRIJJyJKO8Z V32gu1oyfkRfktfpOSHuA+5OItjw4+g= X-MC-Unique: olmRqzpzNQO5IiURxRhHVA-1 X-Mimecast-MFC-AGG-ID: olmRqzpzNQO5IiURxRhHVA_1784782473 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 38/44] qapi: convert intro sections for virtio.json Date: Thu, 23 Jul 2026 00:47:59 -0400 Message-ID: <20260723044805.527643-39-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782562896158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/virtio.json | 91 +++++++++++++++++++----------------------------- 1 file changed, 36 insertions(+), 55 deletions(-) diff --git a/qapi/virtio.json b/qapi/virtio.json index 1fc4e38a44d..0a4753cc343 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: # @@ -69,9 +67,8 @@ =20 ## # @VhostStatus: -# -# Information about a vhost device. This information will only be -# displayed if the vhost device is active. +# Information about a vhost device. This information will only be +# displayed if the vhost device is active. # # @n-mem-sections: vhost_dev n_mem_sections # @@ -112,10 +109,9 @@ =20 ## # @VirtioStatus: -# -# Full status of the virtio device with most VirtIODevice members. -# Also includes the full status of the corresponding vhost device if -# the vhost device is active. +# Full status of the virtio device with most VirtIODevice members. +# Also includes the full status of the corresponding vhost device +# if the vhost device is active. # # @name: VirtIODevice name # @@ -189,8 +185,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 +437,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 +454,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 @@ -478,9 +471,9 @@ =20 ## # @VirtioDeviceFeatures: -# -# The common fields that apply to most Virtio devices. Some devices -# may not have their own device-specific features (e.g. virtio-rng). +# The common fields that apply to most Virtio devices. Some +# devices may not have their own device-specific features +# (e.g. virtio-rng). # # @transports: List of transport features of the virtio device # @@ -503,9 +496,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 +548,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 +631,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 +672,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 +735,7 @@ =20 ## # @VirtioRingDesc: -# -# Information regarding the vring descriptor area +# Information regarding the vring descriptor area # # @addr: Guest physical address of the descriptor area # @@ -764,8 +752,7 @@ =20 ## # @VirtioRingAvail: -# -# Information regarding the avail vring (a.k.a. driver area) +# Information regarding the avail vring (a.k.a. driver area) # # @flags: VRingAvail flags # @@ -782,8 +769,7 @@ =20 ## # @VirtioRingUsed: -# -# Information regarding the used vring (a.k.a. device area) +# Information regarding the used vring (a.k.a. device area) # # @flags: VRingUsed flags # @@ -797,9 +783,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 +807,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 +917,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 # @@ -951,13 +934,12 @@ =20 ## # @VirtIOGPUOutput: -# -# Describes configuration of a VirtIO GPU output. If both @xres and -# @yres are set, they take precedence over root virtio-gpu resolution -# configuration and enable the corresponding output. If none of @xres -# and @yres are set, root virtio-gpu resolution configuration takes -# precedence and only the first output is enabled. Only setting one -# of @xres or @yres is an error. +# Describes configuration of a VirtIO GPU output. If both @xres +# and @yres are set, they take precedence over root virtio-gpu +# resolution configuration and enable the corresponding output. +# If none of @xres and @yres are set, root virtio-gpu resolution +# configuration takes precedence and only the first output is +# enabled. Only setting one of @xres or @yres is an error. # # @name: the name of the output # @@ -973,9 +955,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 Fri Jul 24 05:22:03 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=1784782627; cv=none; d=zohomail.com; s=zohoarc; b=KeNHkP4CEAQeRFxBXQ719fAk+pwcC+wjCtKNHl4OLSKoZ16/dypcOjLGzBFWztENjkqROiDWUyHOppFBWBv4kXHS8s3OH90AO4RRC8vN9V1uyq6v6RuB6wdRNVyL2JiqYXtD/m9c2JzyRQLjuSynjsPL5+0/4GU72ZCCSt12p3Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782627; 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=b6kt5HzL/dcb4GOtdYVxgWwilYqwRVX6SLi3+dLQtEE=; b=bXuHr9j6XZKB9KxXebxUw7lmpighLiu2VdgMaGrySd0mhGBYBuBpmx013eRQcW0itdv8ClPM6ELEAkhpkHJr7w0LRR1CNh4HN8b3MU/IOZ1nWBUs7eO5BbjVlVrmRdlKpyGE58FXPJ7H1nSTgdOEWV/Zuz2rQXBfTqCaG+II8zM= 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 1784782627815274.0515423864829; Wed, 22 Jul 2026 21:57:07 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlSR-0006XB-LJ; Thu, 23 Jul 2026 00:54:55 -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 1wmlSP-0006St-Qr for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:53 -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 1wmlSN-00056h-P2 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:54:53 -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-413-LODP7NitOBe99UrCJyb4Mw-1; Thu, 23 Jul 2026 00:54:45 -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 5754118E6A73; Thu, 23 Jul 2026 04:54:42 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 87386180029D; Thu, 23 Jul 2026 04:54:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782491; 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=b6kt5HzL/dcb4GOtdYVxgWwilYqwRVX6SLi3+dLQtEE=; b=O+BUXRiQWKxdfJpbgE4iEvDMVBC7oP0olSE9d2nQzmsZXjVHuE8yZ6tQC1NgC0LPGecbIB MwHKuMMOt/oF4HAryC3Xe2cag2PhP6Jhb6eI7sshd3IpbfQh8vxTEtWhrT8R23kkSe/lt6 hhiOm5GxjSv4JPy3JclZxec9ZJU12gY= X-MC-Unique: LODP7NitOBe99UrCJyb4Mw-1 X-Mimecast-MFC-AGG-ID: LODP7NitOBe99UrCJyb4Mw_1784782482 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 39/44] qapi: convert trivial intro sections for net.json Date: Thu, 23 Jul 2026 00:48:00 -0400 Message-ID: <20260723044805.527643-40-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782629046158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/net.json | 101 ++++++++++++++++++-------------------------------- 1 file changed, 37 insertions(+), 64 deletions(-) diff --git a/qapi/net.json b/qapi/net.json index 1a6382825c5..7aabd8b9260 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 @@ -1157,11 +1135,10 @@ =20 ## # @FAILOVER_NEGOTIATED: -# -# Emitted when VIRTIO_NET_F_STANDBY was enabled during feature -# negotiation. Failover primary devices which were hidden (not -# hotplugged when requested) before will now be hotplugged by the -# virtio-net standby device. +# Emitted when VIRTIO_NET_F_STANDBY was enabled during feature +# negotiation. Failover primary devices which were hidden (not +# hotplugged when requested) before will now be hotplugged by the +# virtio-net standby device. # # @device-id: QEMU device id of the unplugged device # @@ -1178,8 +1155,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 +1184,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 +1201,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 +1220,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 Fri Jul 24 05:22:03 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=1784782564; cv=none; d=zohomail.com; s=zohoarc; b=cvNUwwV4qQf98Gp58JN8yzlODuQ46VG6yvJ3pO6sGJEU1jPNXq081KHrmiX8I1O1t4PMeJ8vhCWGLa8UGDriMz5bjREh/TwrBhK2D+Smfl6EQhlYnt1pBrTFHMVQ8x0UpuwIJuXo8/3786N302I37wOfAbyuy0loCgONJWFg9Sc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782564; 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=hNmusmT7xnM0b/0JCI4RAh4alzg3iNDUGcYnsg1i8pU=; b=diJfPczlhgiqrWfzasv7pItbYpligvjY5wvD+M1elLNbtZ3u0rfCcn5XhReEOQFXrS/rMta5PBvl57b+HjsSpQIF6HTq1WaQXLRBsUlNKuZsNJPjD+boUZ1pn4+aosOC+5Rod+mZplyQ/y0FLSCCF1wDLFpysD9+Eq+exPFcwag= 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 178478256444982.13757378606078; Wed, 22 Jul 2026 21:56:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlSc-0006o4-6r; Thu, 23 Jul 2026 00:55:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlSa-0006mo-1p for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:04 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlSX-00057q-09 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:03 -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-262-Myvp0vgVPnu7sFHAcBWdWQ-1; Thu, 23 Jul 2026 00:54: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-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 89253195D02D; Thu, 23 Jul 2026 04:54:52 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 86D71180029D; Thu, 23 Jul 2026 04:54:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782500; 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=hNmusmT7xnM0b/0JCI4RAh4alzg3iNDUGcYnsg1i8pU=; b=Y0xzwyYDic05yvNYkmCeBwQ/2yfdfT8ZCmGhqvEGAQ4zmnyXhHv5tqAXir+rGmWE/M4jtI DUVaZitsQ7f9m7cWtOGPp6Br/3dk/AFa4zN2j3KkzBc8ynmHvHn277P7uQud/OBthVdvk1 eadhmE1JUZ/jeLeo+2sUwFeA7glLNrI= X-MC-Unique: Myvp0vgVPnu7sFHAcBWdWQ-1 X-Mimecast-MFC-AGG-ID: Myvp0vgVPnu7sFHAcBWdWQ_1784782492 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 40/44] qapi: convert trivial intro sections for qom.json Date: Thu, 23 Jul 2026 00:48:01 -0400 Message-ID: <20260723044805.527643-41-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782564804158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/qom.json | 138 +++++++++++++++++--------------------------------- 1 file changed, 47 insertions(+), 91 deletions(-) diff --git a/qapi/qom.json b/qapi/qom.json index c55776af7d3..79ac8c2add0 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") # @@ -1033,8 +995,7 @@ =20 ## # @SevGuestProperties: -# -# Properties for sev-guest objects. +# Properties for sev-guest objects. # # @dh-cert-file: guest owners DH certificate (encoded with base64) # @@ -1123,8 +1084,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 @@ -1168,8 +1128,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 @@ -1325,8 +1284,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 # @@ -1403,8 +1361,7 @@ =20 ## # @object-add: -# -# Create a QOM object. +# Create a QOM object. # # Errors: # - If @qom-type is not a valid class name @@ -1423,8 +1380,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 Fri Jul 24 05:22:03 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=1784782540; cv=none; d=zohomail.com; s=zohoarc; b=X2fGRATgMT9di7lCsnMJVI1sylVvhMPF/gT+145XFDPRKIDWy6D7eehIdD7bgmvA6j9jQ6dilKkfR1IV6gbcFOOYfqXe3FlspPwPFQwiXDnliT640UrnAQaxyi7c57Eo2kDcpqjmo2bCSbL8FWBMG2pg/3PJRm0fcpf8hx0kjio= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782540; 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=5mqCvm2ktjlYMsJL+/1197LnuW9YBvA42lCVgEVbiMk=; b=S8xktbtb/CCMCX04+e8gHm02yyaGAI/mJ8GXQHsuqtseQGq8GsUQwIA0KV3XEkNgyqXHLpRkQLHsHPc6W3t2pmiufmltKP9x5/0bmORbUFOfKfoE65v4xA9M9/+QE+fQVg7Mvsj2O4FJj9R3H0Z2dyGVa/aBv67e12I9xgfOQQc= 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 178478254095559.836975498603124; Wed, 22 Jul 2026 21:55:40 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlSj-0007Tt-S6; Thu, 23 Jul 2026 00:55: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 1wmlSi-0007O8-EB for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:12 -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 1wmlSf-0005Kj-M0 for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:12 -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-178-onnmSIaEMbqeSBBvoArGhA-1; Thu, 23 Jul 2026 00:55: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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 607581800578; Thu, 23 Jul 2026 04:55:02 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id BEA13180029D; Thu, 23 Jul 2026 04:54:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782509; 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=5mqCvm2ktjlYMsJL+/1197LnuW9YBvA42lCVgEVbiMk=; b=ZDv1VCT4adbBmHNb5p/YyEhwAIIFaT0V1LfyazlSV/vqXtM/XRbe4Bx05jzCqW3ZwTSOFl 5K0h+MdorLQQcclrTwIBwdjfC0Tgj7kleAqX7HT3zAX1rcGiT6KSfr5IkWp1cGZBMunlJp oljZjfnQI4JJMoX8aG/UnbzsuyCJXWw= X-MC-Unique: onnmSIaEMbqeSBBvoArGhA-1 X-Mimecast-MFC-AGG-ID: onnmSIaEMbqeSBBvoArGhA_1784782502 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 41/44] qapi: convert trivial intro sections for ui.json Date: Thu, 23 Jul 2026 00:48:02 -0400 Message-ID: <20260723044805.527643-42-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782542804158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/ui.json | 215 ++++++++++++++++++--------------------------------- 1 file changed, 75 insertions(+), 140 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index b2c42a7f578..b4122b2fa9f 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 # @@ -685,8 +656,7 @@ =20 ## # @query-vnc-servers: -# -# Return a list of vnc servers. The list can be empty. +# Return a list of vnc servers. The list can be empty. # # Since: 2.3 ## @@ -695,8 +665,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 +681,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 +709,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 +735,7 @@ =20 ## # @VNC_DISCONNECTED: -# -# Emitted when the connection is closed +# Emitted when the connection is closed # # @server: server information # @@ -800,8 +766,7 @@ =20 ## # @MouseInfo: -# -# Information about a mouse device. +# Information about a mouse device. # # @name: the name of the mouse device # @@ -820,8 +785,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 # @@ -850,10 +814,9 @@ =20 ## # @QKeyCode: +# An enumeration of key name. # -# An enumeration of key name. -# -# This is used by the `send-key` command. +# This is used by the `send-key` command. # # @unmapped: since 2.0 # @@ -1005,8 +968,7 @@ =20 ## # @KeyValue: -# -# Represents a keyboard key. +# Represents a keyboard key. # # @type: key encoding # @@ -1021,8 +983,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 +1011,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 +1027,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 +1036,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 +1055,7 @@ =20 ## # @InputKeyEvent: -# -# Keyboard input event. +# Keyboard input event. # # @key: Which key this event is for. # @@ -1112,8 +1069,7 @@ =20 ## # @InputBtnEvent: -# -# Pointer button input event. +# Pointer button input event. # # @button: Which button this event is for. # @@ -1127,8 +1083,7 @@ =20 ## # @InputMoveEvent: -# -# Pointer motion input event. +# Pointer motion input event. # # @axis: Which axis is referenced by @value. # @@ -1143,8 +1098,7 @@ =20 ## # @InputMultiTouchEvent: -# -# MultiTouch input event. +# MultiTouch input event. # # @type: The type of multi-touch event. # @@ -1226,8 +1180,7 @@ =20 ## # @InputEvent: -# -# Input event union. +# Input event union. # # @type: the type of input event # @@ -1316,8 +1269,7 @@ =20 ## # @DisplayGTK: -# -# GTK display options. +# GTK display options. # # @clipboard: Enable host-guest clipboard sharing. Defaults to "off". # (Since 11.1) @@ -1357,8 +1309,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 +1321,7 @@ =20 ## # @DisplayDBus: -# -# DBus display options. +# DBus display options. # # @addr: The D-Bus bus address (default to the session bus). # @@ -1393,8 +1343,7 @@ =20 ## # @DisplayGLMode: -# -# Display OpenGL mode. +# Display OpenGL mode. # # @off: Disable OpenGL (default). # @@ -1413,8 +1362,7 @@ =20 ## # @DisplayCurses: -# -# Curses display options. +# Curses display options. # # @charset: Font charset used by guest (default: CP437). # @@ -1425,8 +1373,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 +1408,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 +1418,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 +1430,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 +1480,7 @@ =20 ## # @DisplayOptions: -# -# Display (user interface) options. +# Display (user interface) options. # # @type: Which `DisplayType` QEMU should use. # @@ -1573,8 +1517,7 @@ =20 ## # @query-display-options: -# -# Return information about display configuration +# Return information about display configuration # # Since: 3.1 ## @@ -1583,8 +1526,7 @@ =20 ## # @DisplayReloadType: -# -# Available DisplayReload types. +# Available DisplayReload types. # # @vnc: VNC display # @@ -1595,8 +1537,7 @@ =20 ## # @DisplayReloadOptionsVNC: -# -# Specify the VNC reload options. +# Specify the VNC reload options. # # @tls-certs: reload tls certs or not. # @@ -1607,8 +1548,7 @@ =20 ## # @DisplayReloadOptions: -# -# Options of the display configuration reload. +# Options of the display configuration reload. # # @type: Specify the display type. # @@ -1621,8 +1561,7 @@ =20 ## # @display-reload: -# -# Reload display configuration. +# Reload display configuration. # # Since: 6.0 # @@ -1638,8 +1577,7 @@ =20 ## # @DisplayUpdateType: -# -# Available DisplayUpdate types. +# Available DisplayUpdate types. # # @vnc: VNC display # @@ -1650,8 +1588,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 +1601,7 @@ =20 ## # @DisplayUpdateOptions: -# -# Options of the display configuration reload. +# Options of the display configuration reload. # # @type: Specify the display type. # @@ -1678,8 +1614,7 @@ =20 ## # @display-update: -# -# Update display configuration. +# Update display configuration. # # Since: 7.1 # @@ -1697,10 +1632,10 @@ =20 ## # @client_migrate_info: -# -# Set migration information for remote display. This makes the server -# ask the client to automatically reconnect using the new parameters -# once migration finished successfully. Only implemented for SPICE. +# Set migration information for remote display. This makes the +# server ask the client to automatically reconnect using the new +# parameters once migration finished successfully. Only +# implemented for SPICE. # # @protocol: must be "spice" # --=20 2.55.0 From nobody Fri Jul 24 05:22:03 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=1784782546; cv=none; d=zohomail.com; s=zohoarc; b=aCoOqak8gsj3EAQ35ZtaJ2RPfOx4UhE5ACZLwNMxFCZnUKqIMNXCqaOdQdTTEKDDA5cG1dbGRSQ4Ezz6rShIGlrZ/5YCgX6M4Zha5GSznHx3rePAmYfVEz1tTT2MHqdEl2TFe5POA4uiIHbgpaR0zhIxGP0PIH3WcLDZLshHGgw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782546; 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=50CZod/iUePAFwxf+WZghW/YZKa0XPt7IqYHe7UOp5g=; b=ZlqbprL/k21qYRAVm1YHKVvtlmtSkK4L3tP6UNAyYDJDFES1C/0vAKmCVekAsTUjBN3HKkI1i3wMBFDP9IQqibNtMGUKe4USEBYeZ9pArfwU7D7Cl9cr3v1W0RF0S7jHM+E07PfezGZGAKr4sAp26xWIzYxHdiWPZD9nqGCz7eg= 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 1784782546594368.9663295060798; Wed, 22 Jul 2026 21:55:46 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlT2-00080v-T4; Thu, 23 Jul 2026 00:55:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wmlSu-0007sa-5X for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55: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 1wmlSr-0005Mz-Fa for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:23 -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-564-6KLshGhfPWKysXqy8wvqgw-1; Thu, 23 Jul 2026 00:55: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 8F355195FE0B; Thu, 23 Jul 2026 04:55:12 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EE85918002AE; Thu, 23 Jul 2026 04:55:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782520; 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=50CZod/iUePAFwxf+WZghW/YZKa0XPt7IqYHe7UOp5g=; b=cV4vLV6pCWCNCKyc+pPHcaxJkdZmxLl+AjxyGUjTDx64j6Ew3M3yZInTlL5POl4n0Ulm+J R4zL2chxYbWSnkJFjHsiH/bN1z288QDIashMzg7G8lI2+JiwtXdSacwuFgqA5Rgg0aDZGq Cg5iL8Mp0w+Rnlr9km2ISynq5AjU+Y0= X-MC-Unique: 6KLshGhfPWKysXqy8wvqgw-1 X-Mimecast-MFC-AGG-ID: 6KLshGhfPWKysXqy8wvqgw_1784782512 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 42/44] qapi: convert trivial intro sections for migration.json Date: Thu, 23 Jul 2026 00:48:03 -0400 Message-ID: <20260723044805.527643-43-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782548888158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/migration.json | 201 +++++++++++++++++--------------------------- 1 file changed, 78 insertions(+), 123 deletions(-) diff --git a/qapi/migration.json b/qapi/migration.json index 66bd900465a..f9300c9e329 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 @@ -339,9 +333,9 @@ =20 ## # @query-migrate: -# -# Return information about current migration process. If migration is -# active there will be another json-object with RAM migration status. +# Return information about current migration process. If +# migration is active there will be another json-object with RAM +# migration status. # # Since: 0.14 # @@ -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. # @@ -798,9 +788,8 @@ =20 ## # @MigrationParameter: -# -# Migration parameters enumeration. The enumeration values mirror the -# members of @MigrationParameters. +# Migration parameters enumeration. The enumeration values mirror +# the members of @MigrationParameters. # # Features: # @@ -834,8 +823,7 @@ =20 ## # @migrate-set-parameters: -# -# Set migration parameters. All arguments are optional. +# Set migration parameters. All arguments are optional. # # Since: 2.4 # @@ -1057,11 +1045,10 @@ =20 ## # @query-migrate-parameters: -# -# Return information about the current migration parameters. Optional -# members of the return value are always present, except -# @block-bitmap-mapping, which is only present if it has been -# previously set. +# Return information about the current migration parameters. +# Optional members of the return value are always present, except +# @block-bitmap-mapping, which is only present if it has been +# previously set. # # Since: 2.4 # @@ -1082,10 +1069,9 @@ =20 ## # @migrate-start-postcopy: -# -# Followup to a migration command to switch the migration to postcopy -# mode. The postcopy-ram capability must be set on both source and -# destination before the original migration command. +# Followup to a migration command to switch the migration to +# postcopy mode. The postcopy-ram capability must be set on both +# source and destination before the original migration command. # # Since: 2.5 # @@ -1098,8 +1084,7 @@ =20 ## # @MIGRATION: -# -# Emitted when a migration event happens +# Emitted when a migration event happens # # @status: `MigrationStatus` describing the current migration status. # @@ -1116,9 +1101,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 +1118,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 +1145,7 @@ =20 ## # @COLOMode: -# -# The COLO current mode. +# The COLO current mode. # # @none: COLO is disabled. # @@ -1177,8 +1160,7 @@ =20 ## # @FailoverStatus: -# -# An enumeration of COLO failover status +# An enumeration of COLO failover status # # @none: no failover has ever happened # @@ -1198,9 +1180,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 +1199,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 @@ -1238,12 +1218,11 @@ =20 ## # @x-colo-lost-heartbeat: -# -# Tell QEMU that heartbeat is lost, request it to do takeover -# procedures. If this command is sent to the PVM, the Primary side -# will exit COLO mode. If sent to the Secondary, the Secondary side -# will run failover work, then takes over server operation to become -# the service VM. +# Tell QEMU that heartbeat is lost, request it to do takeover +# procedures. If this command is sent to the PVM, the Primary +# side will exit COLO mode. If sent to the Secondary, the +# Secondary side will run failover work, then takes over server +# operation to become the service VM. # # Features: # @@ -1281,8 +1260,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 +1276,7 @@ =20 ## # @MigrationAddressType: -# -# The migration stream transport mechanisms. +# The migration stream transport mechanisms. # # @socket: Migrate via socket. # @@ -1339,8 +1316,7 @@ =20 ## # @MigrationAddress: -# -# Migration endpoint configuration. +# Migration endpoint configuration. # # @transport: The migration stream transport mechanism # @@ -1357,8 +1333,7 @@ =20 ## # @MigrationChannelType: -# -# The migration channel-type request options. +# The migration channel-type request options. # # @main: Main outbound migration channel. # @@ -1371,8 +1346,7 @@ =20 ## # @MigrationChannel: -# -# Migration stream channel parameters. +# Migration stream channel parameters. # # @channel-type: Channel type for transferring packet information. # @@ -1387,8 +1361,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 # @@ -1464,9 +1437,8 @@ =20 ## # @migrate-incoming: -# -# Start an incoming migration. QEMU must have been started with -# -incoming defer. +# Start an incoming migration. QEMU must have been started with +# -incoming defer. # # @uri: The Uniform Resource Identifier identifying the source or # address to listen on @@ -1536,9 +1508,8 @@ =20 ## # @xen-save-devices-state: -# -# Save the state of all devices to file. The RAM and the block -# devices of the VM are not saved by this command. +# Save the state of all devices to file. The RAM and the block +# devices of the VM are not saved by this command. # # @filename: the file to save the state of the devices to as binary # data. See `xen-save-devices-state`.txt for a description of the @@ -1560,8 +1531,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. # @@ -1577,9 +1547,8 @@ =20 ## # @xen-load-devices-state: -# -# Load the state of all devices from file. The RAM and the block -# devices of the VM are not loaded by this command. +# Load the state of all devices from file. The RAM and the block +# devices of the VM are not loaded by this command. # # @filename: the file to load the state of the devices from as binary # data. See `xen-save-devices-state`.txt for a description of the @@ -1597,8 +1566,7 @@ =20 ## # @xen-set-replication: -# -# Enable or disable replication. +# Enable or disable replication. # # @enable: true to enable, false to disable. # @@ -1621,8 +1589,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 +1637,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 +1675,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. # @@ -1742,11 +1707,10 @@ =20 ## # @UNPLUG_PRIMARY: -# -# Emitted from source side of a migration when migration state is -# WAIT_UNPLUG. Device was unplugged by guest operating system. -# Device resources in QEMU are kept on standby to be able to re-plug -# it in case of migration failure. +# Emitted from source side of a migration when migration state is +# WAIT_UNPLUG. Device was unplugged by guest operating system. +# Device resources in QEMU are kept on standby to be able to +# re-plug it in case of migration failure. # # @device-id: QEMU device id of the unplugged device # @@ -1763,8 +1727,7 @@ =20 ## # @DirtyRateVcpu: -# -# Dirty rate of vcpu. +# Dirty rate of vcpu. # # @id: vcpu index. # @@ -1777,8 +1740,7 @@ =20 ## # @DirtyRateStatus: -# -# Dirty page rate measurement status. +# Dirty page rate measurement status. # # @unstarted: measuring thread has not been started yet # @@ -1793,9 +1755,8 @@ =20 ## # @DirtyRateMeasureMode: -# -# Method used to measure dirty page rate. Differences between -# available methods are explained in `calc-dirty-rate`. +# Method used to measure dirty page rate. Differences between +# available methods are explained in `calc-dirty-rate`. # # @page-sampling: use page sampling # @@ -1810,8 +1771,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 +1784,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 +1894,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 +1921,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 +1987,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 +2004,7 @@ =20 ## # @snapshot-save: -# -# Save a VM snapshot +# Save a VM snapshot # # @job-id: identifier for the newly created job # @@ -2118,8 +2075,7 @@ =20 ## # @snapshot-load: -# -# Load a VM snapshot +# Load a VM snapshot # # @job-id: identifier for the newly created job # @@ -2188,8 +2144,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 Fri Jul 24 05:22:03 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=1784782624; cv=none; d=zohomail.com; s=zohoarc; b=kOuR63lWd7rJqGYZPMdmzwSI7akkjJ8j6wsRwEDaHtO2E3/j/IOp91jCCEBLha2UAfE8MP23TwH6h7whB6snhZdVtsQGulHmulnhYxK3fr0EpVo6cs75kg5NNYXwlD8fWpJx0ITe8GJ3Wxo0emj+iqspCqOqDt6fC7OAxMlabiY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782624; 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=l2vKKJq9p+mRJI1PvhlBj7i1Hep84eZpyfHuN/CbTtk=; b=BJ3B6098UdmYK6t1lHXKOH5KaHEeL3QWUev0k2JNEMSaZRZUeteJS82zHbbq82KUPbwoBMG978LD/H/uimzlFavhkVJg/ryLrFS2NK6dfKrqGjxEbeOAIAOMQdH75apCvWz0fKUzn/Hgzg0KkfTm3ns5/mSlrF+/jP0JZ9FBitM= 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 1784782624864696.5153778258306; Wed, 22 Jul 2026 21:57:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlT6-0008DY-AQ; Thu, 23 Jul 2026 00:55: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 1wmlT5-00086e-5w for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55: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 1wmlT1-0005QY-0h for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:33 -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-235-klbCYKTsOI62KJTINKYHXg-1; Thu, 23 Jul 2026 00:55:26 -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 5C8301955DC2; Thu, 23 Jul 2026 04:55:23 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5329518002AE; Thu, 23 Jul 2026 04:55:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782530; 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=l2vKKJq9p+mRJI1PvhlBj7i1Hep84eZpyfHuN/CbTtk=; b=dIDelB9FRgXHdq+A0TaQHgaEX853ZFhitKqy9WlCEjI5PXsGOw7YPUrga19Qb0Jvun8zkZ UpwfobpCHbXoyYOQZO1blsTuMEiJXBEVx8c6PFoeO0v3Ad7oOsZQTZF2rc0ZPB6G46qSh9 i0w9lCZt6FXpwpwdo5/HVxixRYasBo4= X-MC-Unique: klbCYKTsOI62KJTINKYHXg-1 X-Mimecast-MFC-AGG-ID: klbCYKTsOI62KJTINKYHXg_1784782523 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 43/44] qapi: convert trivial intro sections for machine.json Date: Thu, 23 Jul 2026 00:48:04 -0400 Message-ID: <20260723044805.527643-44-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782627135158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/machine.json | 261 +++++++++++++++++----------------------------- 1 file changed, 96 insertions(+), 165 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 9b2248038fc..2b0b9757641 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -15,12 +15,11 @@ =20 ## # @SysEmuTarget: -# -# The comprehensive enumeration of QEMU system emulation ("softmmu") -# targets. Run "./configure --help" in the project root directory, -# and look for the \*-softmmu targets near the "--target-list" option. -# The individual target constants are not documented here, for the -# time being. +# The comprehensive enumeration of QEMU system emulation +# ("softmmu") targets. Run "./configure --help" in the project +# root directory, and look for the \*-softmmu targets near the +# "--target-list" option. The individual target constants are not +# documented here, for the time being. # # @rx: since 5.0 # @@ -46,9 +45,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 +55,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 +72,7 @@ =20 ## # @CpuInfoFast: -# -# Information about a virtual CPU +# Information about a virtual CPU # # @cpu-index: index of the virtual CPU # @@ -105,8 +101,7 @@ =20 ## # @query-cpus-fast: -# -# Return information about all virtual CPUs. +# Return information about all virtual CPUs. # # Since: 2.12 # @@ -143,9 +138,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 +157,7 @@ =20 ## # @MachineInfo: -# -# Information describing a machine. +# Information describing a machine. # # @name: the name of the machine # @@ -213,8 +206,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 +247,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 +259,7 @@ =20 ## # @query-current-machine: -# -# Return information on the current virtual machine. +# Return information on the current virtual machine. # # Since: 4.0 ## @@ -277,8 +267,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 +279,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 +287,7 @@ =20 ## # @UuidInfo: -# -# Guest UUID information (Universally Unique Identifier). +# Guest UUID information (Universally Unique Identifier). # # @UUID: the UUID of the guest # @@ -312,8 +300,7 @@ =20 ## # @query-uuid: -# -# Query the guest UUID information. +# Query the guest UUID information. # # Since: 0.14 # @@ -326,8 +313,7 @@ =20 ## # @GuidInfo: -# -# GUID information. +# GUID information. # # @guid: the globally unique identifier # @@ -337,8 +323,7 @@ =20 ## # @query-vm-generation-id: -# -# Show Virtual Machine Generation ID +# Show Virtual Machine Generation ID # # Since: 2.9 ## @@ -346,8 +331,7 @@ =20 ## # @system_reset: -# -# Performs a hard reset of a guest. +# Performs a hard reset of a guest. # # Since: 0.14 # @@ -360,8 +344,7 @@ =20 ## # @system_powerdown: -# -# Requests that a guest perform a powerdown operation. +# Requests that a guest perform a powerdown operation. # # Since: 0.14 # @@ -379,11 +362,10 @@ =20 ## # @system_wakeup: -# -# Wake up guest from suspend. If the guest has wake-up from suspend -# support enabled (wakeup-suspend-support flag from -# `query-current-machine`), wake-up guest from suspend if the guest is -# in SUSPENDED state. Return an error otherwise. +# Wake up guest from suspend. If the guest has wake-up from +# suspend support enabled (wakeup-suspend-support flag from +# `query-current-machine`), wake-up guest from suspend if the +# guest is in SUSPENDED state. Return an error otherwise. # # Since: 1.1 # @@ -399,9 +381,8 @@ =20 ## # @LostTickPolicy: -# -# Policy for handling lost ticks in timer devices. Ticks end up -# getting lost when, for example, the guest is paused. +# Policy for handling lost ticks in timer devices. Ticks end up +# getting lost when, for example, the guest is paused. # # @discard: throw away the missed ticks and continue with future # injection normally. The guest OS will see the timer jump ahead @@ -431,10 +412,9 @@ =20 ## # @inject-nmi: -# -# Injects a Non-Maskable Interrupt into the default CPU (x86/s390) or -# all CPUs (ppc64). The command fails when the guest doesn't support -# injecting. +# Injects a Non-Maskable Interrupt into the default CPU (x86/s390) +# or all CPUs (ppc64). The command fails when the guest doesn't +# support injecting. # # Since: 0.14 # @@ -468,8 +448,7 @@ =20 ## # @NumaOptions: -# -# A discriminated record of NUMA options. (for OptsVisitor) +# A discriminated record of NUMA options. (for OptsVisitor) # # @type: NUMA option type # @@ -487,8 +466,7 @@ =20 ## # @NumaNodeOptions: -# -# Create a guest NUMA node. (for OptsVisitor) +# Create a guest NUMA node. (for OptsVisitor) # # @nodeid: NUMA node ID (increase by 1 from 0 if omitted) # @@ -520,8 +498,7 @@ =20 ## # @NumaDistOptions: -# -# Set the distance between 2 NUMA nodes. +# Set the distance between 2 NUMA nodes. # # @src: source NUMA node. # @@ -541,8 +518,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. @@ -564,8 +540,7 @@ =20 ## # @CXLFMWProperties: -# -# List of CXL Fixed Memory Windows. +# List of CXL Fixed Memory Windows. # # @cxl-fmw: List of `CXLFixedMemoryWindowOptions` # @@ -577,8 +552,7 @@ =20 ## # @X86CPURegister32: -# -# A X86 32-bit register +# A X86 32-bit register # # Since: 1.5 ## @@ -587,8 +561,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 @@ -610,9 +583,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 ## @@ -621,11 +593,10 @@ =20 ## # @NumaCpuOptions: -# -# Option "-numa cpu" overrides default cpu to node mapping. It -# accepts the same set of cpu properties as returned by -# `query-hotpluggable-cpus[].props `, where -# node-id could be used to override default node mapping. +# Option "-numa cpu" overrides default cpu to node mapping. It +# accepts the same set of cpu properties as returned by +# `query-hotpluggable-cpus[].props `, +# where node-id could be used to override default node mapping. # # Since: 2.10 ## @@ -794,8 +765,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 # @@ -827,8 +797,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 # @@ -856,8 +825,7 @@ =20 ## # @Memdev: -# -# Information about memory backend +# Information about memory backend # # @id: backend's ID if backend has 'id' property (since 2.9) # @@ -897,8 +865,7 @@ =20 ## # @query-memdev: -# -# Return information for all memory backends. +# Return information for all memory backends. # # Since: 2.1 # @@ -1073,9 +1040,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 ## @@ -1086,8 +1053,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: @@ -1121,8 +1087,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 @@ -1133,8 +1098,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 @@ -1155,10 +1119,9 @@ =20 ## # @BALLOON_CHANGE: -# -# Emitted when the guest changes the actual BALLOON level. This value -# is equivalent to the @actual field return by the `query-balloon` -# command +# Emitted when the guest changes the actual BALLOON level. This +# value is equivalent to the @actual field return by the +# `query-balloon` command # # @actual: the logical size of the VM in bytes. Formula used: # logical_vm_size =3D vm_ram_size - balloon_size @@ -1178,8 +1141,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, @@ -1195,9 +1157,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 @@ -1238,8 +1199,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. @@ -1272,8 +1232,7 @@ =20 ## # @PCDIMMDeviceInfo: -# -# PCDIMMDevice state information +# PCDIMMDevice state information # # @id: device's ID # @@ -1308,8 +1267,7 @@ =20 ## # @VirtioPMEMDeviceInfo: -# -# VirtioPMEM state information +# VirtioPMEM state information # # @id: device's ID # @@ -1331,8 +1289,7 @@ =20 ## # @VirtioMEMDeviceInfo: -# -# VirtioMEMDevice state information +# VirtioMEMDevice state information # # @id: device's ID # @@ -1366,8 +1323,7 @@ =20 ## # @SgxEPCDeviceInfo: -# -# Sgx EPC state information +# Sgx EPC state information # # @id: device's ID # @@ -1392,8 +1348,7 @@ =20 ## # @HvBalloonDeviceInfo: -# -# hv-balloon provided memory state information +# hv-balloon provided memory state information # # @id: device's ID # @@ -1522,8 +1477,7 @@ =20 ## # @MemoryDeviceInfo: -# -# Union containing information about a memory device +# Union containing information about a memory device # # @type: memory device type # @@ -1544,8 +1498,7 @@ =20 ## # @SgxEPC: -# -# Sgx EPC cmdline information +# Sgx EPC cmdline information # # @memdev: memory backend linked with device # @@ -1561,8 +1514,7 @@ =20 ## # @SgxEPCProperties: -# -# SGX properties of machine types. +# SGX properties of machine types. # # @sgx-epc: list of ids of memory-backend-epc objects. # @@ -1574,8 +1526,7 @@ =20 ## # @query-memory-devices: -# -# Lists available memory devices and their state +# Lists available memory devices and their state # # Since: 2.1 # @@ -1598,10 +1549,9 @@ =20 ## # @MEMORY_DEVICE_SIZE_CHANGE: -# -# Emitted when the size of a memory device changes. Only emitted for -# memory devices that can actually change the size (e.g., virtio-mem -# due to guest action). +# Emitted when the size of a memory device changes. Only emitted +# for memory devices that can actually change the size (e.g., +# virtio-mem due to guest action). # # @id: device's ID # @@ -1625,8 +1575,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) # @@ -1710,8 +1659,7 @@ =20 ## # @x-query-irq: -# -# Query interrupt statistics +# Query interrupt statistics # # Features: # @@ -1727,8 +1675,7 @@ =20 ## # @x-query-jit: -# -# Query TCG compiler statistics +# Query TCG compiler statistics # # Features: # @@ -1745,8 +1692,7 @@ =20 ## # @x-query-numa: -# -# Query NUMA topology information +# Query NUMA topology information # # Features: # @@ -1762,8 +1708,7 @@ =20 ## # @x-query-ramblock: -# -# Query system ramblock information +# Query system ramblock information # # Features: # @@ -1779,8 +1724,7 @@ =20 ## # @x-query-roms: -# -# Query information on the registered ROMS +# Query information on the registered ROMS # # Features: # @@ -1796,8 +1740,7 @@ =20 ## # @x-query-usb: -# -# Query information on the USB devices +# Query information on the USB devices # # Features: # @@ -1828,8 +1771,7 @@ =20 ## # @MemorySizeConfiguration: -# -# Schema for memory size configuration. +# Schema for memory size configuration. # # @size: memory size in bytes # @@ -1846,8 +1788,7 @@ =20 ## # @dumpdtb: -# -# Save the FDT in dtb format. +# Save the FDT in dtb format. # # @filename: name of the dtb file to be created # @@ -1865,8 +1806,7 @@ =20 ## # @x-query-interrupt-controllers: -# -# Query information on interrupt controller devices +# Query information on interrupt controller devices # # Features: # @@ -1896,8 +1836,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 @@ -1911,8 +1850,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 # @@ -1950,8 +1888,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 @@ -1983,9 +1920,8 @@ =20 ## # @CpuModelCompareResult: -# -# An enumeration of CPU model comparison results. The result is -# usually calculated using e.g. CPU features or CPU generations. +# An enumeration of CPU model comparison results. The result is +# usually calculated using e.g. CPU features or CPU generations. # # @incompatible: If model A is incompatible to model B, model A is not # guaranteed to run where model B runs and the other way around. @@ -2008,8 +1944,7 @@ =20 ## # @CpuModelBaselineInfo: -# -# The result of a CPU model baseline. +# The result of a CPU model baseline. # # @model: the baselined `CpuModelInfo`. # @@ -2020,8 +1955,7 @@ =20 ## # @CpuModelCompareInfo: -# -# The result of a CPU model comparison. +# The result of a CPU model comparison. # # @result: The result of the compare operation. # @@ -2152,8 +2086,7 @@ =20 ## # @CpuModelExpansionInfo: -# -# The result of a cpu model expansion. +# The result of a cpu model expansion. # # @model: the expanded `CpuModelInfo`. # @@ -2222,8 +2155,7 @@ =20 ## # @CpuDefinitionInfo: -# -# Virtual CPU definition. +# Virtual CPU definition. # # @name: the name of the CPU definition # @@ -2284,8 +2216,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 Fri Jul 24 05:22:03 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=1784782635; cv=none; d=zohomail.com; s=zohoarc; b=NCPu59Wy+xTKI3XLUA7TL63aL2tFzZK189JHjU1FpstRxUeIhICmK2rKBt3CqrB/HQyHLuMUre53Ivii81bkAw1JYzYcNaGcxfRLMGiMdCEma4fX+AO5iWDean4TXAPYX23cypfqHrsfxtRpZUM+Xo328KX80MrkLiNZ1CJvDWA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1784782635; 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=x+QDeFBwgjejev9Us3uKchsWQc+5y6CyBFG5cfqQApw=; b=Y51qiCQ1Cl08Rbyw3aylQhq4DwHfrKzZRvs0jXaFzL/zqERQPR+ryzujWtGKuTZts5L8c8v6WNVRIhK5Se860FF4cUsTFOz+g3z3ZW6EOpmXS27GKAFO825jxaNZ79pXDiEJ3ikdp85y2l9WBoqCkd6OdPXsZYMlADg1FDAuF9M= 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 1784782635524328.26180729181306; Wed, 22 Jul 2026 21:57:15 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wmlTK-0000cE-92; Thu, 23 Jul 2026 00:55: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 1wmlTH-0000Oe-Md for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55: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 1wmlTC-0005Sd-Mc for qemu-devel@nongnu.org; Thu, 23 Jul 2026 00:55:47 -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-118-5VjhXeaENGKb1wMnUtpGgg-1; Thu, 23 Jul 2026 00:55:38 -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 B1B781805F17; Thu, 23 Jul 2026 04:55:35 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 95AAF180029D; Thu, 23 Jul 2026 04:55:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782542; 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=x+QDeFBwgjejev9Us3uKchsWQc+5y6CyBFG5cfqQApw=; b=fiA/mqN4FCnLtZDf1uZHkI5cW/5FMNqxUI1WWhvvNuzy3id9ifjIUVH7w7If6f/bKwB9PK QZUnppUsTdXu0sxj5XibMZ8GIxDrLFE8SKTAmF2yDUw/NeDUN0OSvA/ujM0RH76BeyvV5N gBtsD1FXLvNx0ygeD7OR0U0MeY0IvDY= X-MC-Unique: 5VjhXeaENGKb1wMnUtpGgg-1 X-Mimecast-MFC-AGG-ID: 5VjhXeaENGKb1wMnUtpGgg_1784782535 From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 44/44] qapi: convert trivial intro sections for block-core.json Date: Thu, 23 Jul 2026 00:48:05 -0400 Message-ID: <20260723044805.527643-45-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-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: permerror 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.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, T_SPF_PERMERROR=0.01 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: 1784782637096158500 Content-Type: text/plain; charset="utf-8" (Trivial) Signed-off-by: John Snow --- qapi/block-core.json | 646 +++++++++++++++++-------------------------- 1 file changed, 255 insertions(+), 391 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index 1f87b078505..bd98af2f298 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 @@ -422,10 +417,9 @@ =20 ## # @BlockGraphInfo: -# -# Information about all nodes in a block (sub)graph in the form of -# `BlockNodeInfo` data. The base `BlockNodeInfo` struct contains the -# information for the (sub)graph's root node. +# Information about all nodes in a block (sub)graph in the form of +# `BlockNodeInfo` data. The base `BlockNodeInfo` struct contains +# the information for the (sub)graph's root node. # # @children: Array of links to this node's child nodes' information # @@ -437,8 +431,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 +474,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 +513,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 +543,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 +659,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 +674,7 @@ =20 ## # @BlockDirtyInfo: -# -# Block dirty bitmap information. +# Block dirty bitmap information. # # @name: the name of the dirty bitmap (Since 2.4) # @@ -717,8 +706,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 +724,7 @@ =20 ## # @Qcow2BitmapInfo: -# -# Qcow2 bitmap information. +# Qcow2 bitmap information. # # @name: the name of the bitmap # @@ -753,8 +740,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 @@ -781,9 +767,8 @@ =20 ## # @BlockInfo: -# -# Block device information. This structure describes a virtual device -# and the backing device associated with it. +# Block device information. This structure describes a virtual +# device and the backing device associated with it. # # @device: The device name associated with the virtual device. # @@ -852,8 +837,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 +938,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 +1004,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 +1142,7 @@ =20 ## # @BlockStatsSpecificFile: -# -# File driver statistics +# File driver statistics # # @discard-nb-ok: The number of successful discard operations # performed by the driver. @@ -1181,8 +1162,7 @@ =20 ## # @BlockStatsSpecificNvme: -# -# NVMe driver statistics +# NVMe driver statistics # # @completion-errors: The number of completion errors. # @@ -1202,8 +1182,7 @@ =20 ## # @BlockStatsSpecific: -# -# Block driver specific statistics +# Block driver specific statistics # # @driver: block driver name # @@ -1220,8 +1199,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 +1232,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" @@ -1378,10 +1355,9 @@ =20 ## # @BlockdevOnError: -# -# An enumeration of possible behaviors for errors on I/O operations. -# The exact meaning depends on whether the I/O was initiated by a -# guest or by a block job +# An enumeration of possible behaviors for errors on I/O +# operations. The exact meaning depends on whether the I/O was +# initiated by a guest or by a block job # # @report: for guest operations, report the error to the guest; for # jobs, cancel the job @@ -1406,9 +1382,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 +1404,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 +1424,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 +1440,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 +1453,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 +1505,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 +1547,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. # @@ -1636,9 +1605,8 @@ =20 ## # @BackupPerf: -# -# Optional parameters for backup. These parameters don't affect -# functionality, but may significantly affect performance. +# Optional parameters for backup. These parameters don't affect +# functionality, but may significantly affect performance. # # @use-copy-range: Use copy offloading. Default false. # @@ -1782,8 +1750,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 @@ -1845,12 +1812,12 @@ =20 ## # @change-backing-file: -# -# Change the backing file in the image file metadata. This does not -# cause QEMU to reopen the image file to reparse the backing filename -# (it may, however, perform a reopen to change permissions from r/o -> -# r/w -> r/o, if needed). The new backing file string is written into -# the image file metadata, and the QEMU internal strings are updated. +# Change the backing file in the image file metadata. This does +# not cause QEMU to reopen the image file to reparse the backing +# filename (it may, however, perform a reopen to change +# permissions from r/o -> r/w -> r/o, if needed). The new backing +# file string is written into the image file metadata, and the +# QEMU internal strings are updated. # # @image-node-name: The name of the block driver state node of the # image to modify. The "device" argument is used to verify @@ -1986,12 +1953,12 @@ =20 ## # @drive-backup: -# -# Start a point-in-time copy of a block device to a new destination. -# The status of ongoing `drive-backup` operations can be checked with -# `query-block-jobs` where the `BlockJobInfo`.type field has the value -# 'backup'. The operation can be stopped before it has completed -# using the `job-cancel` or `block-job-cancel` command. +# Start a point-in-time copy of a block device to a new +# destination. The status of ongoing `drive-backup` operations +# can be checked with `query-block-jobs` where the +# `BlockJobInfo`.type field has the value 'backup'. The operation +# can be stopped before it has completed using the `job-cancel` or +# `block-job-cancel` command. # # Features: # @@ -2017,12 +1984,12 @@ =20 ## # @blockdev-backup: -# -# Start a point-in-time copy of a block device to a new destination. -# The status of ongoing `blockdev-backup` operations can be checked -# with `query-block-jobs` where the `BlockJobInfo`.type field has the -# value 'backup'. The operation can be stopped before it has -# completed using the `job-cancel` or `block-job-cancel` command. +# Start a point-in-time copy of a block device to a new +# destination. The status of ongoing `blockdev-backup` operations +# can be checked with `query-block-jobs` where the +# `BlockJobInfo`.type field has the value 'backup'. The operation +# can be stopped before it has completed using the `job-cancel` or +# `block-job-cancel` command. # # Errors: # - If @device is not a valid block device, DeviceNotFound @@ -2043,8 +2010,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 +2106,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 +2136,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 +2158,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 +2167,7 @@ =20 ## # @x-debug-query-block-graph: -# -# Get the block graph. +# Get the block graph. # # Features: # @@ -2219,13 +2181,13 @@ =20 ## # @drive-mirror: -# -# Start mirroring a block device's writes to a new destination. -# target specifies the target of the new image. If the file exists, -# or if it is a device, it will be used as the new destination for -# writes. If it does not exist, a new file will be created. @format -# specifies the format of the mirror image, default is to probe if -# mode=3D'existing', else the format of the source. +# Start mirroring a block device's writes to a new destination. +# target specifies the target of the new image. If the file +# exists, or if it is a device, it will be used as the new +# destination for writes. If it does not exist, a new file will +# be created. @format specifies the format of the mirror image, +# default is to probe if mode=3D'existing', else the format of the +# source. # # Errors: # - If @device is not a valid block device, GenericError @@ -2247,8 +2209,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) @@ -2399,9 +2360,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 @@ -2421,10 +2381,9 @@ =20 ## # @block-dirty-bitmap-remove: -# -# Stop write tracking and remove the dirty bitmap that was created -# with `block-dirty-bitmap-add`. If the bitmap is persistent, remove -# it from its storage too. +# Stop write tracking and remove the dirty bitmap that was created +# with `block-dirty-bitmap-add`. If the bitmap is persistent, +# remove it from its storage too. # # Errors: # - If @node is not a valid block device or node, DeviceNotFound @@ -2445,10 +2404,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 @@ -2468,8 +2426,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 @@ -2489,8 +2447,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 @@ -2543,8 +2501,7 @@ =20 ## # @BlockDirtyBitmapSha256: -# -# SHA256 hash of dirty bitmap data +# SHA256 hash of dirty bitmap data # # @sha256: ASCII representation of SHA256 bitmap hash # @@ -2555,8 +2512,7 @@ =20 ## # @x-debug-block-dirty-bitmap-sha256: -# -# Get bitmap SHA256. +# Get bitmap SHA256. # # Features: # @@ -2575,8 +2531,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) @@ -2662,8 +2617,7 @@ =20 ## # @BlockIOThrottle: -# -# A set of parameters describing block throttling. +# A set of parameters describing block throttling. # # @device: Block device name # @@ -2746,11 +2700,10 @@ =20 ## # @ThrottleLimits: -# -# Limit parameters for throttling. Since some limit combinations are -# illegal, limits should always be set in one transaction. All fields -# are optional. When setting limits, if a field is missing the -# current value is not changed. +# Limit parameters for throttling. Since some limit combinations +# are illegal, limits should always be set in one transaction. +# All fields are optional. When setting limits, if a field is +# missing the current value is not changed. # # @iops-total: limit total I/O operations per second # @@ -2814,8 +2767,7 @@ =20 ## # @ThrottleGroupProperties: -# -# Properties for throttle-group objects. +# Properties for throttle-group objects. # # @limits: limits to apply for this throttle group # @@ -3222,8 +3174,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 # @@ -3238,8 +3189,7 @@ =20 ## # @block-job-change: -# -# Change the block job's options. +# Change the block job's options. # # Since: 8.2 ## @@ -3248,8 +3198,7 @@ =20 ## # @BlockdevDiscardOptions: -# -# Determines how to handle discard requests. +# Determines how to handle discard requests. # # @ignore: Ignore the request # @@ -3262,10 +3211,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) # @@ -3282,8 +3230,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 # @@ -3299,8 +3246,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) @@ -3315,8 +3261,7 @@ =20 ## # @BlockdevDriver: -# -# Drivers that are supported in block device operations. +# Drivers that are supported in block device operations. # # @throttle: Since 2.11 # @@ -3358,8 +3303,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 # @@ -3418,8 +3362,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. # @@ -3438,8 +3381,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) @@ -3456,8 +3398,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 # @@ -3481,9 +3422,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 # @@ -3494,8 +3434,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 @@ -3512,9 +3451,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 @@ -3528,8 +3467,7 @@ =20 ## # @Qcow2OverlapCheckMode: -# -# General overlap check modes. +# General overlap check modes. # # @none: Do not perform any checks # @@ -3548,12 +3486,11 @@ =20 ## # @Qcow2OverlapCheckFlags: -# -# Structure of flags for each metadata structure. Setting a field to -# 'true' makes QEMU guard that Qcow2 format structure against -# unintended overwriting. See Qcow2 format specification for detailed -# information on these structures. The default value is chosen -# according to the template given. +# Structure of flags for each metadata structure. Setting a field +# to 'true' makes QEMU guard that Qcow2 format structure against +# unintended overwriting. See Qcow2 format specification for +# detailed information on these structures. The default value is +# chosen according to the template given. # # @template: Specifies a template mode which can be adjusted using the # other flags, defaults to 'cached' @@ -3592,9 +3529,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 @@ -3631,8 +3567,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. @@ -3668,9 +3603,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) @@ -3685,8 +3619,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) @@ -3839,8 +3772,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) @@ -3876,8 +3808,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() # @@ -3899,8 +3830,7 @@ =20 ## # @BlkdebugInjectErrorOptions: -# -# Describes a single error injection for blkdebug. +# Describes a single error injection for blkdebug. # # @event: trigger event # @@ -3938,8 +3868,7 @@ =20 ## # @BlkdebugSetStateOptions: -# -# Describes a single state-change event for blkdebug. +# Describes a single state-change event for blkdebug. # # @event: trigger event # @@ -3958,8 +3887,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) # @@ -4020,8 +3948,7 @@ =20 ## # @BlockdevOptionsBlklogwrites: -# -# Driver specific block device options for blklogwrites. +# Driver specific block device options for blklogwrites. # # @file: block device # @@ -4047,8 +3974,7 @@ =20 ## # @BlockdevOptionsBlkverify: -# -# Driver specific block device options for blkverify. +# Driver specific block device options for blkverify. # # @test: block device to be tested # @@ -4062,8 +3988,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 # @@ -4074,8 +3999,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 # @@ -4087,8 +4011,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 @@ -4114,8 +4037,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 # @@ -4127,8 +4049,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). @@ -4141,9 +4063,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). @@ -4156,9 +4077,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. # @@ -4170,9 +4090,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. # @@ -4191,8 +4110,7 @@ =20 ## # @IscsiTransport: -# -# An enumeration of libiscsi transport types +# An enumeration of libiscsi transport types # # Since: 2.9 ## @@ -4201,8 +4119,7 @@ =20 ## # @IscsiHeaderDigest: -# -# An enumeration of header digests supported by libiscsi +# An enumeration of header digests supported by libiscsi # # Since: 2.9 ## @@ -4212,8 +4129,7 @@ =20 ## # @BlockdevOptionsIscsi: -# -# Driver specific block device options for iscsi +# Driver specific block device options for iscsi # # @transport: The iscsi transport type # @@ -4415,8 +4331,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. @@ -4431,8 +4346,7 @@ =20 ## # @BlockdevOptionsReplication: -# -# Driver specific block device options for replication +# Driver specific block device options for replication # # @mode: the replication mode # @@ -4450,8 +4364,7 @@ =20 ## # @NFSTransport: -# -# An enumeration of NFS transport types +# An enumeration of NFS transport types # # @inet: TCP transport # @@ -4462,8 +4375,7 @@ =20 ## # @NFSServer: -# -# Captures the address of the socket +# Captures the address of the socket # # @type: transport type used for NFS (only TCP supported) # @@ -4477,8 +4389,7 @@ =20 ## # @BlockdevOptionsNfs: -# -# Driver specific block device option for NFS +# Driver specific block device option for NFS # # @server: host address # @@ -4515,9 +4426,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 # @@ -4550,9 +4460,8 @@ =20 ## # @BlockdevOptionsCurlHttp: -# -# Driver specific block device options for HTTP connections over the -# curl backend. URLs must start with "http://". +# Driver specific block device options for HTTP connections over +# the curl backend. URLs must start with "http://". # # @cookie: List of cookies to set; format is "name1=3Dcontent1; # name2=3Dcontent2;" as explained by CURLOPT_COOKIE(3). Defaults to @@ -4576,9 +4485,8 @@ =20 ## # @BlockdevOptionsCurlHttps: -# -# Driver specific block device options for HTTPS connections over the -# curl backend. URLs must start with "https://". +# Driver specific block device options for HTTPS connections over +# the curl backend. URLs must start with "https://". # # @sslverify: Whether to verify the SSL certificate's validity # (defaults to true) @@ -4591,9 +4499,8 @@ =20 ## # @BlockdevOptionsCurlFtp: -# -# Driver specific block device options for FTP connections over the -# curl backend. URLs must start with "ftp://". +# Driver specific block device options for FTP connections over +# the curl backend. URLs must start with "ftp://". # # Since: 2.9 ## @@ -4603,9 +4510,8 @@ =20 ## # @BlockdevOptionsCurlFtps: -# -# Driver specific block device options for FTPS connections over the -# curl backend. URLs must start with "ftps://". +# Driver specific block device options for FTPS connections over +# the curl backend. URLs must start with "ftps://". # # @sslverify: Whether to verify the SSL certificate's validity # (defaults to true) @@ -4618,8 +4524,7 @@ =20 ## # @BlockdevOptionsNbd: -# -# Driver specific block device options for NBD. +# Driver specific block device options for NBD. # # @server: NBD server address # @@ -4667,8 +4572,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 # @@ -4682,8 +4586,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. @@ -4699,8 +4602,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), @@ -4716,9 +4619,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 @@ -4735,14 +4637,13 @@ =20 ## # @BlockdevOptionsCbw: -# -# Driver specific block device options for the copy-before-write -# driver, which does so called copy-before-write operations: when data -# is written to the filter, the filter first reads corresponding -# blocks from its file child and copies them to @target child. After -# successfully copying, the write request is propagated to file child. -# If copying fails, the original write request is failed too and no -# data is written to file child. +# Driver specific block device options for the copy-before-write +# driver, which does so called copy-before-write operations: when +# data is written to the filter, the filter first reads +# corresponding blocks from its file child and copies them to +# @target child. After successfully copying, the write request is +# propagated to file child. If copying fails, the original write +# request is failed too and no data is written to file child. # # @target: The target for copy-before-write operations. # @@ -4778,9 +4679,8 @@ =20 ## # @BlockdevOptions: -# -# Options for creating a block device. Many options are available for -# all block devices, independent of the block driver: +# Options for creating a block device. Many options are available +# for all block devices, independent of the block driver: # # @driver: block driver name # @@ -4893,8 +4793,7 @@ =20 ## # @BlockdevRef: -# -# Reference to a block device. +# Reference to a block device. # # @definition: defines a new block device inline # @@ -4908,8 +4807,7 @@ =20 ## # @BlockdevRefOrNull: -# -# Reference to a block device. +# Reference to a block device. # # @definition: defines a new block device inline # @@ -4928,8 +4826,7 @@ =20 ## # @blockdev-add: -# -# Creates a new block device. +# Creates a new block device. # # Since: 2.9 # @@ -5025,10 +4922,9 @@ =20 ## # @blockdev-del: -# -# Deletes a block device that has been added using `blockdev-add`. -# The command will fail if the node is attached to a device or is -# otherwise being used. +# Deletes a block device that has been added using `blockdev-add`. +# The command will fail if the node is attached to a device or is +# otherwise being used. # # @node-name: Name of the graph node to delete. # @@ -5090,8 +4986,7 @@ =20 ## # @BlockdevCreateOptionsFile: -# -# Driver specific image creation options for file. +# Driver specific image creation options for file. # # @filename: Filename for the new image file # @@ -5117,8 +5012,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 @@ -5141,8 +5035,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 # @@ -5156,8 +5049,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 # @@ -5174,8 +5066,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 # @@ -5209,8 +5100,7 @@ =20 ## # @Qcow2CompressionType: -# -# Compression type used in qcow2 image file +# Compression type used in qcow2 image file # # @zlib: zlib compression, see # @@ -5223,8 +5113,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 # @@ -5283,8 +5172,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 # @@ -5311,8 +5199,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. @@ -5333,8 +5220,7 @@ =20 ## # @BlockdevVmdkSubformat: -# -# Subformat options for VMDK images +# Subformat options for VMDK images # # @monolithicSparse: Single file image with sparse cluster allocation # @@ -5357,8 +5243,7 @@ =20 ## # @BlockdevVmdkAdapterType: -# -# Adapter type info for VMDK images +# Adapter type info for VMDK images # # Since: 4.0 ## @@ -5367,8 +5252,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 @@ -5416,8 +5300,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 # @@ -5431,8 +5314,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 # @@ -5462,8 +5344,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 # @@ -5506,8 +5387,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 # @@ -5529,8 +5409,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 # @@ -5558,9 +5437,9 @@ =20 ## # @blockdev-create: -# -# Starts a job to create an image format on a given node. The job is -# automatically finalized, but a manual `job-dismiss` is required. +# Starts a job to create an image format on a given node. The job +# is automatically finalized, but a manual `job-dismiss` is +# required. # # @job-id: Identifier for the newly created job. # @@ -5575,8 +5454,7 @@ =20 ## # @BlockdevAmendOptionsLUKS: -# -# Driver specific image amend options for LUKS. +# Driver specific image amend options for LUKS. # # Since: 5.1 ## @@ -5587,9 +5465,8 @@ =20 ## # @BlockdevAmendOptionsQcow2: -# -# Driver specific image amend options for qcow2. For now, only -# encryption options can be amended +# Driver specific image amend options for qcow2. For now, only +# encryption options can be amended # # @encrypt: Encryption options to be amended # @@ -5600,8 +5477,7 @@ =20 ## # @BlockdevAmendOptions: -# -# Options for amending an image format +# Options for amending an image format # # @driver: Block driver of the node to amend. # @@ -5617,10 +5493,9 @@ =20 ## # @x-blockdev-amend: -# -# Starts a job to amend format specific options of an existing open -# block device. The job is automatically finalized, but a manual -# `job-dismiss` is required. +# Starts a job to amend format specific options of an existing +# open block device. The job is automatically finalized, but a +# manual `job-dismiss` is required. # # @job-id: Identifier for the newly created job. # @@ -5649,8 +5524,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 # @@ -5665,11 +5540,10 @@ =20 ## # @BLOCK_IMAGE_CORRUPTED: -# -# Emitted when a disk image is being marked corrupt. The image can be -# identified by its device or node name. The 'device' field is always -# present for compatibility reasons, but it can be empty ("") if the -# image does not have a device name associated. +# Emitted when a disk image is being marked corrupt. The image +# can be identified by its device or node name. The 'device' +# field is always present for compatibility reasons, but it can be +# empty ("") if the image does not have a device name associated. # # @device: device name. This is always present for compatibility # reasons, but it can be empty ("") if the image does not have a @@ -5713,8 +5587,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) # @@ -5766,8 +5639,7 @@ =20 ## # @BLOCK_JOB_COMPLETED: -# -# Emitted when a block job has completed +# Emitted when a block job has completed # # @type: job type # @@ -5806,8 +5678,7 @@ =20 ## # @BLOCK_JOB_CANCELLED: -# -# Emitted when a block job has been cancelled +# Emitted when a block job has been cancelled # # @type: job type # @@ -5840,8 +5711,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 @@ -5867,8 +5737,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 # @@ -5903,11 +5772,10 @@ =20 ## # @BLOCK_JOB_PENDING: -# -# Emitted when a block job is awaiting explicit authorization to -# finalize graph changes via `job-finalize`. If this job is part of a -# transaction, it will not emit this event until the transaction has -# converged first. +# Emitted when a block job is awaiting explicit authorization to +# finalize graph changes via `job-finalize`. If this job is part +# of a transaction, it will not emit this event until the +# transaction has converged first. # # @type: job type # @@ -5927,8 +5795,7 @@ =20 ## # @PreallocMode: -# -# Preallocation mode of QEMU image file +# Preallocation mode of QEMU image file # # @off: no preallocation # @@ -5949,12 +5816,12 @@ =20 ## # @BLOCK_WRITE_THRESHOLD: -# -# Emitted when writes on block device reaches or exceeds the -# configured write threshold. For thin-provisioned devices, this -# means the device should be extended to avoid pausing for disk -# exhaustion. The event is one shot. Once triggered, it needs to be -# re-registered with another `block-set-write-threshold` command. +# Emitted when writes on block device reaches or exceeds the +# configured write threshold. For thin-provisioned devices, this +# means the device should be extended to avoid pausing for disk +# exhaustion. The event is one shot. Once triggered, it needs to +# be re-registered with another `block-set-write-threshold` +# command. # # @node-name: graph node name on which the threshold was exceeded. # @@ -6107,8 +5974,7 @@ =20 ## # @QuorumOpType: -# -# An enumeration of the quorum operation types +# An enumeration of the quorum operation types # # @read: read operation # @@ -6123,8 +5989,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 # @@ -6147,8 +6013,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) # @@ -6202,11 +6067,10 @@ =20 ## # @blockdev-snapshot-internal-sync: -# -# Synchronously take an internal snapshot of a block device, when the -# format of the image used supports it. If the name is an empty -# string, or a snapshot with name already exists, the operation will -# fail. +# Synchronously take an internal snapshot of a block device, when +# the format of the image used supports it. If the name is an +# empty string, or a snapshot with name already exists, the +# operation will fail. # # Errors: # - If @device is not a valid block device, GenericError @@ -6234,11 +6098,11 @@ =20 ## # @blockdev-snapshot-delete-internal-sync: -# -# Synchronously delete an internal snapshot of a block device, when -# the format of the image used support it. The snapshot is identified -# by name or id or both. One of the name or id is required. Return -# `SnapshotInfo` for the successfully deleted snapshot. +# Synchronously delete an internal snapshot of a block device, +# when the format of the image used support it. The snapshot is +# identified by name or id or both. One of the name or id is +# required. Return `SnapshotInfo` for the successfully deleted +# snapshot. # # @device: the device name or node-name of a root node to delete the # snapshot from @@ -6281,8 +6145,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