From nobody Fri Nov 14 21:05:55 2025 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=none dis=none) header.from=yandex-team.ru ARC-Seal: i=1; a=rsa-sha256; t=1760192875; cv=none; d=zohomail.com; s=zohoarc; b=ZAF2E6WYZrWsLyE9ceGgywx3fO7i5HVbAQPmj3xBOuUoN7Jbq2oudwx88hglN+az8XNrlha3Gq53Tt29GIQ5kwLNNpTE7hcSFjTEcF1ZG0k20R0czdhf9fTkKYVkvU/OuRemGG4g9FKK+vS6f9MLVTKmCgxiUrrWNgayudSTkrI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192875; 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=h6Ea4/j5Ei56p6QrRogXcVDfqdofZLzefU6CuONpdcs=; b=VSLlxH4bwUGqx0MzqGgFXTJbTm7GIQitD7rtfL2Hha9AHG9DB0VoF0kDIxmvxGMuzHhWdROR7Gnr3zup162dSg448TPypLl2qdjE9mQKgmbNhfOOnXAUOSIFaOveUt+t5NUgSA61HPNhNffpRtrJxHbji/PQUZ4CUupQJs183t8= 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=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1760192875484201.47813018386512; Sat, 11 Oct 2025 07:27:55 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7a-0006Fy-7c; Sat, 11 Oct 2025 09:58:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7Y-0006FI-BE for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:52 -0400 Received: from forwardcorp1a.mail.yandex.net ([2a02:6b8:c0e:500:1:45:d181:df01]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7I-0004iq-FQ for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:51 -0400 Received: from mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net [IPv6:2a02:6b8:c1f:3a87:0:640:845c:0]) by forwardcorp1a.mail.yandex.net (Yandex) with ESMTPS id 65752C016B; Sat, 11 Oct 2025 16:58:09 +0300 (MSK) Received: from vsementsov-lin.. (unknown [2a02:6bf:8080:a4b::1:3c]) by mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id uvMPBZ1FEOs0-QqXrfCoP; Sat, 11 Oct 2025 16:58:08 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191088; bh=h6Ea4/j5Ei56p6QrRogXcVDfqdofZLzefU6CuONpdcs=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=dZURX5Qrk/+Ye9d/reE4vYWunWdnpwN5/WwHx2zMnL2knZiFb0lskGeCisDslAcTO ZmTQKmH5sYX+87ff+ONCaGn5NqGjWLRWNOGgqSCpDHNrqqrQ6GpoGPBbDJyQxbp/ZF WyBrzzRDDsmRqRhQQnO/oFHOFdnz/uswMCFc+K6s= Authentication-Results: mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net; dkim=pass header.i=@yandex-team.ru From: Vladimir Sementsov-Ogievskiy To: armbru@redhat.com Cc: qemu-devel@nongnu.org, vsementsov@yandex-team.ru, eblake@redhat.com, Eduardo Habkost , Marcel Apfelbaum , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Yanan Wang , Zhao Liu Subject: [PATCH 13/33] qapi/machine.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:05 +0300 Message-ID: <20251011135754.294521-25-vsementsov@yandex-team.ru> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20251011135754.294521-1-vsementsov@yandex-team.ru> References: <20251011135754.294521-1-vsementsov@yandex-team.ru> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable 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=lists.gnu.org; Received-SPF: pass client-ip=2a02:6b8:c0e:500:1:45:d181:df01; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001, T_SPF_HELO_TEMPERROR=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: 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 @yandex-team.ru) X-ZM-MESSAGEID: 1760192877086154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/machine.json | 59 ++++++++++++++++++++++++++++++----------------- 1 file changed, 38 insertions(+), 21 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 038eab281c..4d36cd35c3 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -225,7 +225,8 @@ # # .. qmp-example:: # -# -> { "execute": "query-machines", "arguments": { "compat-props": tru= e } } +# -> { "execute": "query-machines", "arguments": { "compat-props": +# true } } # <- { "return": [ # { # "hotpluggable-cpus": true, @@ -318,7 +319,8 @@ # .. qmp-example:: # # -> { "execute": "query-uuid" } -# <- { "return": { "UUID": "550e8400-e29b-41d4-a716-446655440000" } } +# <- { "return": { "UUID": "550e8400-e29b-41d4-a716- +# 446655440000" } } ## { 'command': 'query-uuid', 'returns': 'UuidInfo', 'allow-preconfig': true } =20 @@ -620,7 +622,8 @@ ## # @NumaCpuOptions: # -# Option "-numa cpu" overrides default cpu to node mapping. It accepts +# 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. @@ -686,7 +689,8 @@ # Set the system locality latency and bandwidth information between # Initiator and Target proximity Domains. # -# For more information about `NumaHmatLBOptions`, see chapter 5.2.27.4: +# For more information about `NumaHmatLBOptions`, see chapter +# 5.2.27.4: # Table 5-146 of ACPI 6.3 spec. # # @initiator: the Initiator Proximity Domain. @@ -743,7 +747,8 @@ # Cache write policy in the Memory Side Cache Information Structure of # HMAT # -# For more information of `HmatCacheWritePolicy`, see chapter 5.2.27.5: +# For more information of `HmatCacheWritePolicy`, see chapter +# 5.2.27.5: # Table 5-147: Field "Cache Attributes" of ACPI 6.3 spec. # # @none: None (no memory side cache in this proximity domain, or cache @@ -763,8 +768,8 @@ # # Set the memory side cache information for a given memory domain. # -# For more information of `NumaHmatCacheOptions`, see chapter 5.2.27.5: -# Table 5-147: Field "Cache Attributes" of ACPI 6.3 spec. +# For more information of `NumaHmatCacheOptions`, see chapter +# 5.2.27.5: Table 5-147: Field "Cache Attributes" of ACPI 6.3 spec. # # @node-id: the memory proximity domain to which the memory belongs. # @@ -1023,10 +1028,13 @@ # # -> { "execute": "query-hotpluggable-cpus" } # <- {"return": [ -# { "props": { "core-id": 8 }, "type": "POWER8-spapr-cpu-core", +# { "props": { "core-id": 8 }, +# "type": "POWER8-spapr-cpu-core", # "vcpus-count": 1 }, -# { "props": { "core-id": 0 }, "type": "POWER8-spapr-cpu-core", -# "vcpus-count": 1, "qom-path": "/machine/unattached/device[0]"} +# { "props": { "core-id": 0 }, +# "type": "POWER8-spapr-cpu-core", +# "vcpus-count": 1, +# "qom-path": "/machine/unattached/device[0]"} # ]} # # .. qmp-example:: @@ -1110,7 +1118,8 @@ # # :: # -# -> { "execute": "balloon", "arguments": { "value": 536870912 } } +# -> { "execute": "balloon", +# "arguments": { "value": 536870912 } } # <- { "return": {} } # # With a 2.5GiB guest this command inflated the ballon to 3GiB. @@ -1169,7 +1178,8 @@ # # <- { "event": "BALLOON_CHANGE", # "data": { "actual": 944766976 }, -# "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } +# "timestamp": { "seconds": 1267020223, +# "microseconds": 435656 } } ## { 'event': 'BALLOON_CHANGE', 'data': { 'actual': 'int' } } @@ -1228,8 +1238,10 @@ # .. qmp-example:: # # <- { "event": "HV_BALLOON_STATUS_REPORT", -# "data": { "committed": 816640000, "available": 3333054464 }, -# "timestamp": { "seconds": 1600295492, "microseconds": 661044 } } +# "data": { "committed": 816640000, +# "available": 3333054464 }, +# "timestamp": { "seconds": 1600295492, +# "microseconds": 661044 } } ## { 'event': 'HV_BALLOON_STATUS_REPORT', 'data': 'HvBalloonInfo' } @@ -1262,7 +1274,8 @@ # .. qmp-example:: # # -> { "execute": "query-memory-size-summary" } -# <- { "return": { "base-memory": 4294967296, "plugged-memory": 0 } } +# <- { "return": { "base-memory": 4294967296, +# "plugged-memory": 0 } } # # Since: 2.11 ## @@ -1577,7 +1590,8 @@ # <- { "event": "MEMORY_DEVICE_SIZE_CHANGE", # "data": { "id": "vm0", "size": 1073741824, # "qom-path": "/machine/unattached/device[2]" }, -# "timestamp": { "seconds": 1588168529, "microseconds": 201316 } } +# "timestamp": { "seconds": 1588168529, +# "microseconds": 201316 } } ## { 'event': 'MEMORY_DEVICE_SIZE_CHANGE', 'data': { '*id': 'str', 'size': 'size', 'qom-path' : 'str'} } @@ -2000,7 +2014,8 @@ # `query-cpu-definitions`.) # * "-cpu" arguments and global properties: arguments to the -cpu # option and global properties may affect expansion of CPU models. -# Using `query-cpu-model-expansion` while using these is not advised. +# Using `query-cpu-model-expansion` while using these is not +# advised. # # Some architectures may not support comparing CPU models. s390x # supports comparing CPU models. @@ -2054,7 +2069,8 @@ # `query-cpu-definitions`.) # * "-cpu" arguments and global properties: arguments to the -cpu # option and global properties may affect expansion of CPU models. -# Using `query-cpu-model-expansion` while using these is not advised. +# Using `query-cpu-model-expansion` while using these is not +# advised. # # Some architectures may not support baselining CPU models. s390x # supports baselining CPU models. @@ -2085,8 +2101,8 @@ # # @model: the expanded `CpuModelInfo`. # -# @deprecated-props: an optional list of properties that are flagged as -# deprecated by the CPU vendor. The list depends on the +# @deprecated-props: an optional list of properties that are flagged +# as deprecated by the CPU vendor. The list depends on the # `CpuModelExpansionType`: "static" properties are a subset of the # enabled-properties for the expanded model; "full" properties are # a set of properties that are deprecated across all models for @@ -2122,7 +2138,8 @@ # `query-cpu-definitions`.) # * "-cpu" arguments and global properties: arguments to the -cpu # option and global properties may affect expansion of CPU models. -# Using `query-cpu-model-expansion` while using these is not advised. +# Using `query-cpu-model-expansion` while using these is not +# advised. # # Some architectures may not support all expansion types. s390x # supports "full" and "static". Arm only supports "full". --=20 2.48.1