From nobody Fri Nov 14 18:23:26 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=1760191715; cv=none; d=zohomail.com; s=zohoarc; b=Jgv8EOmuXpj0gkKYARcd0srGtQj+hephajv94eFoymJ6rqKA52917NCb82VLNj0PCSoAHKRzMOxyZceBdLKAI6DH1Ua976iqFKOOW2B8+SVEbhBKv3YYHNLiHcuM/u1oIVgg6ZrbUiFqorI+r2ek4YhB1e0uDJP53105MZPTGFU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191715; 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=sM4YrvUNO+2zghtH3aLu00wsMr94BOpnclkexE7YIug=; b=f5e7a7IxF0sp7YJQVin+43p/zFfkOaW2ATYDiqBagIHeYs5Pj06OoVVHv5mjOrjb54l0G2rJuRDA3W89piZTKfDpganiu6q61r07JP6cX6ZPupJk6hjJJOETQznBHdBDlZAIYrjkxtiLOOyDvF1HiJAN1xihk5iZ6MZa7WdvAxs= 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 1760191715723785.8063853867689; Sat, 11 Oct 2025 07:08:35 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a70-00061A-UC; Sat, 11 Oct 2025 09:58:19 -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 1v7a6x-00060w-W5 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:16 -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 1v7a6r-0004cN-Cs for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:15 -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 666D4C0193; Sat, 11 Oct 2025 16:57:57 +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-V3WhyNtC; Sat, 11 Oct 2025 16:57:57 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191077; bh=sM4YrvUNO+2zghtH3aLu00wsMr94BOpnclkexE7YIug=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=hAw6yIMPaMEPLtOYm+bIhh+ZtNH2iwUkeRmw+iEQ/9+s8JRYkYhdVdvd8rxG7IZVn hiheKZStbSbjqYrBGlbmfJTG3eQTafOsn0bMWY1XEDtiX4zyco8qt1W8DHgGXDOZRu VGgatDdKiKJBMGCD0HSUDhj7r1U0jhWE01EuKDQg= 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, Michael Roth Subject: [PATCH 01/33] qapi: Add documentation format validation Date: Sat, 11 Oct 2025 16:56:42 +0300 Message-ID: <20251011135754.294521-2-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191717550154100 Content-Type: text/plain; charset="utf-8" Add explicit validation for QAPI documentation formatting rules: 1. Lines must not exceed 70 columns in width (including '# ' prefix) 2. Sentences must be separated by two spaces Signed-off-by: Vladimir Sementsov-Ogievskiy --- scripts/qapi/parser.py | 39 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/scripts/qapi/parser.py b/scripts/qapi/parser.py index 9fbf80a541..2c76686fc4 100644 --- a/scripts/qapi/parser.py +++ b/scripts/qapi/parser.py @@ -428,7 +428,44 @@ def get_doc_line(self) -> Optional[str]: return '' if self.val[1] !=3D ' ': raise QAPIParseError(self, "missing space after #") - return self.val[2:].rstrip() + + line =3D self.val[2:].rstrip() + + self._validate_doc_line_format(line) + + return line + + def _validate_doc_line_format(self, line: str) -> None: + """ + Validate documentation format rules for a single line: + 1. Lines should not exceed 70 columns + 2. Sentences should be separated by two spaces + """ + # Check 70-column width rule + full_line_length =3D len(line) + 2 # "# " =3D 2 characters + if full_line_length > 70: + # Skip URL lines - they can't be broken + stripped_line =3D line.strip() + if (stripped_line.startswith(('http://', 'https://', 'ftp://')= ) and + ' ' not in stripped_line): + pass + else: + raise QAPIParseError( + self, f"documentation line exceeds 70 columns " + f"({full_line_length} columns): {line[:50]}..." + ) + + single_space_pattern =3D r'[.!?] [A-Z0-9]' + for m in list(re.finditer(single_space_pattern, line)): + left =3D line[0:m.start() + 1] + # Ignore abbreviations and numbered lists + if left.endswith('e.g.') or re.fullmatch(r' *\d\.', left): + continue + raise QAPIParseError( + self, f"documentation has single space after sentence " + f"ending. Use two spaces between sentences: " + f"...{line[m.start()-5:m.end()+5]}..." + ) =20 @staticmethod def _match_at_name_colon(string: str) -> Optional[Match[str]]: --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192669; cv=none; d=zohomail.com; s=zohoarc; b=eIWDuZdfal7Ra/dUzuAfvsZu3Tjp3Ue+G/k1wooobNXTDsNfx162bMsg/Ct122CahAIWTZ4AtwIIjZgl8jyreYnFVeUu4DN2+j2qvQECRnlVwYbcLn+b50y7/7Qpqf0V6wbq+2S9Sn0d38Fasybl67qSgGttbI32v1czsacqCqU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192669; 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=GwUGObk/skOiLvkKNiWNa/3LsaS2Qb5Akmk/NJK1Uw0=; b=AQanr5Tz653xfLB3ju3IPuFu78QLbBV+fk1T17TfeoDwbrzQZvNRy+CLZHG05YQCu802fGuRZLaA/WzLPob3uk+jLiBanSCZWQVetHRvN/nJGpTtCy1uu5cjX+LJtz6gG8X3yZOq+UIL7SX4qgyKJKJpoxA7BMhCgmQnFRvDNik= 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 1760192669197273.3625825933002; Sat, 11 Oct 2025 07:24:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a77-00064Z-EX; Sat, 11 Oct 2025 09:58:26 -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 1v7a72-00061R-NR for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:20 -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 1v7a6r-0004cF-Bt for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:20 -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 D1578C0194; Sat, 11 Oct 2025 16:57:57 +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-l9rAYjNU; Sat, 11 Oct 2025 16:57:57 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191077; bh=GwUGObk/skOiLvkKNiWNa/3LsaS2Qb5Akmk/NJK1Uw0=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=PSNNzBHyQIfqvjS29EPIJ5QzTr75OdobwUZOJQV2rR36E8L+IA9LHUc60UGaNUY4A 1mJvGj7zRgAiOVmAVyQhSVekpDOz6GRA+6VJW5s8xMhzda3OGnRuMafZv+CDgdiYKU Al/PJ1WBV13R0C5kUsVsrtX917mAKOYFhpZAQltc= 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, "Michael S. Tsirkin" , Igor Mammedov , Ani Sinha Subject: [PATCH 02/33] qapi/acpi.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:43 +0300 Message-ID: <20251011135754.294521-3-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_HELO_NONE=0.001, T_SPF_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: 1760192672793154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/acpi.json | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/qapi/acpi.json b/qapi/acpi.json index 906b3687a5..601271607b 100644 --- a/qapi/acpi.json +++ b/qapi/acpi.json @@ -116,10 +116,16 @@ # .. qmp-example:: # # -> { "execute": "query-acpi-ospm-status" } -# <- { "return": [ { "device": "d1", "slot": "0", "slot-type": "DIMM",= "source": 1, "status": 0}, -# { "slot": "1", "slot-type": "DIMM", "source": 0, "s= tatus": 0}, -# { "slot": "2", "slot-type": "DIMM", "source": 0, "s= tatus": 0}, -# { "slot": "3", "slot-type": "DIMM", "source": 0, "s= tatus": 0} +# <- { "return": [ +# { "device": "d1", "slot": "0", +# "slot-type": "DIMM", "source": 1, +# "status": 0 }, +# { "slot": "1", "slot-type": "DIMM", "source": 0, +# "status": 0 }, +# { "slot": "2", "slot-type": "DIMM", "source": 0, +# "status": 0 }, +# { "slot": "3", "slot-type": "DIMM", "source": 0, +# "status": 0 } # ]} ## { 'command': 'query-acpi-ospm-status', 'returns': ['ACPIOSTInfo'] } @@ -137,8 +143,10 @@ # # <- { "event": "ACPI_DEVICE_OST", # "data": { "info": { "device": "d1", "slot": "0", -# "slot-type": "DIMM", "source": 1, "status":= 0 } }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "slot-type": "DIMM", "source": 1, +# "status": 0 } }, +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'ACPI_DEVICE_OST', 'data': { 'info': 'ACPIOSTInfo' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191204; cv=none; d=zohomail.com; s=zohoarc; b=aHCqV3tDicG3MRUN3bMvkelPzbWwTTnYd/29iwZPbD94aOXasaLeuxPvHiqA2KqNXyVzO159YS4zkUDzZ7WyM0GJw9qq6rfCbXdFoiy7nRd7ofjhDMzE1MKE3z/7erm3NpYJ/+FhRZ9L2qvsmSQkQmn3Cqv09/xfvcUnroWVXHI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191204; 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=GwUGObk/skOiLvkKNiWNa/3LsaS2Qb5Akmk/NJK1Uw0=; b=XyQnggbn3/7+xR/PNRB8Ey6bZx3EKXZvcLrSGGu6KHNhL6tewkPvMRXTAqR5gQGhvkuOp9o2xBJaPEpKedrZo3z285Ev+zxRq3/HrgB2sXmcVFv87/X8qSuwmT9l4s7DkV2vMrvQXb+o4WfyOPiBCwCn+OrijEXVd3d7CynmV9o= 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 1760191204886959.4978146590533; Sat, 11 Oct 2025 07:00:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a75-00062M-OQ; Sat, 11 Oct 2025 09:58:24 -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 1v7a72-00061T-OW for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:20 -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 1v7a6t-0004cL-69 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:19 -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 7846AC0195; Sat, 11 Oct 2025 16:57:58 +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-7cVsqjmc; Sat, 11 Oct 2025 16:57:58 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191078; bh=GwUGObk/skOiLvkKNiWNa/3LsaS2Qb5Akmk/NJK1Uw0=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=G/zNsj7+ZfX+WRwLAZwtTnglibCaJRUCNyKtFlMrL2sRN7xFzSceAS3RPL4olmO93 IBhNjZJSfJBcMuUWgnqJGEtNs1nE71yMDHUiEcKxemTycTJqEtEjj7nCQ2ZIRRQU+k tKXPSfmr/vvwic5GDf1HQALa6vpRJTDHLdIusSVo= 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, "Michael S. Tsirkin" , Igor Mammedov , Ani Sinha Subject: [PATCH 02/33] qapi/acpi.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:44 +0300 Message-ID: <20251011135754.294521-4-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191208915154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/acpi.json | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/qapi/acpi.json b/qapi/acpi.json index 906b3687a5..601271607b 100644 --- a/qapi/acpi.json +++ b/qapi/acpi.json @@ -116,10 +116,16 @@ # .. qmp-example:: # # -> { "execute": "query-acpi-ospm-status" } -# <- { "return": [ { "device": "d1", "slot": "0", "slot-type": "DIMM",= "source": 1, "status": 0}, -# { "slot": "1", "slot-type": "DIMM", "source": 0, "s= tatus": 0}, -# { "slot": "2", "slot-type": "DIMM", "source": 0, "s= tatus": 0}, -# { "slot": "3", "slot-type": "DIMM", "source": 0, "s= tatus": 0} +# <- { "return": [ +# { "device": "d1", "slot": "0", +# "slot-type": "DIMM", "source": 1, +# "status": 0 }, +# { "slot": "1", "slot-type": "DIMM", "source": 0, +# "status": 0 }, +# { "slot": "2", "slot-type": "DIMM", "source": 0, +# "status": 0 }, +# { "slot": "3", "slot-type": "DIMM", "source": 0, +# "status": 0 } # ]} ## { 'command': 'query-acpi-ospm-status', 'returns': ['ACPIOSTInfo'] } @@ -137,8 +143,10 @@ # # <- { "event": "ACPI_DEVICE_OST", # "data": { "info": { "device": "d1", "slot": "0", -# "slot-type": "DIMM", "source": 1, "status":= 0 } }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "slot-type": "DIMM", "source": 1, +# "status": 0 } }, +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'ACPI_DEVICE_OST', 'data': { 'info': 'ACPIOSTInfo' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191328; cv=none; d=zohomail.com; s=zohoarc; b=cOo0LvAgJ+amtUV+xPGTAtrWJsvux5FEZ7CgQb2HL1/xPjj/k+JSCSeN2xoS3anvx+7eH3JsMnyJN70VTwR/cVOIDGX4vPULsQPGIL2Cn6p+VQgrDqCS9ZTjeYDjlNMRBA0KIKgr8sEnKKbkrzpVlI2C+veUt/b8JKjU022KIaY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191328; 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=KrogRysMTqgdyPfx+7Zf3fqdEHX2+3XH4e/2Zkq2+08=; b=i+eRHm44eyhuo87LoXB52EAADqhWqdnIoR/6E6o1XDL7dG3rWkiNPwrCMZsdmJNoaCvuK9mYFRSOajl0kOwBOJ9ca54ToC86GMC5EoppruhhrW7WOpNqTm6H0rVzr/pPs2WzoX4NFeaWYGtaRm0xllQ90ZNAZp6J6Nj4zBLNzEo= 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 1760191328471915.9830402172389; Sat, 11 Oct 2025 07:02:08 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a75-000638-Ic; Sat, 11 Oct 2025 09:58:23 -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 1v7a73-00061s-2i for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:21 -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 1v7a6r-0004cS-Bj for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:20 -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 682BAC0197; Sat, 11 Oct 2025 16:57:59 +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-bkkvsntb; Sat, 11 Oct 2025 16:57:59 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191079; bh=KrogRysMTqgdyPfx+7Zf3fqdEHX2+3XH4e/2Zkq2+08=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=xzUMS6ku2MF/muLzS6LZ9+Kyi4VFHO+S3uKkS8C1rtkryHeFxm0CSalZKldiMtYHu izA/0Cse1scY2htAbUmNcwU8xPm/v0iXNpePXtKjyDH30fw5eGvogdGwq68s3gyGYr VZ0xINTfWYm5atUltF/XxlDKG3nacyJzYkQCxZvc= 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, Gerd Hoffmann , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= Subject: [PATCH 03/33] qapi/audio.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:46 +0300 Message-ID: <20251011135754.294521-6-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191331066154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/audio.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/audio.json b/qapi/audio.json index 53142080f7..2df87b9710 100644 --- a/qapi/audio.json +++ b/qapi/audio.json @@ -76,8 +76,8 @@ # # @out: options of the playback stream # -# @nsamples: set the number of samples per read/write calls (default to 48= 0, -# 10ms at 48kHz). +# @nsamples: set the number of samples per read/write calls +# (default to 480, 10ms at 48kHz). # # Since: 10.0 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191206; cv=none; d=zohomail.com; s=zohoarc; b=T/w6JJrdJxuGYewp+GOpRK/V5ZMjqv8D8rfCxX9bN4o98wW4LFntEfhCf57QWxWIznpu67IaUEBfsbcqLUUtBP/fLYIU+5Aw2rmEAs7/KOT9EYFa7QKjtzUznFEGXWcPZ94Sd7KlgW6m6aap3QpFgXAsn7oI6koBbsnGGkRE8qE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191206; 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=KrogRysMTqgdyPfx+7Zf3fqdEHX2+3XH4e/2Zkq2+08=; b=JLzBJGtk3J+8VSs/li0lGg6pPz+aOCSG+zaimV+ZyUFS7+4MDNI/41zb3u+gdUMTKQNBJKICUmJbTeiOZ1UnHSBiu6dBsjVJXbJU0THl2RCLmNH7jlol4WSPkFTu5cOBuPDN09H8CFVk96iAEyQnlThxAaiTfmJa6g69UXMQaiY= 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 176019120651616.274240522473747; Sat, 11 Oct 2025 07:00:06 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a76-00063e-EM; Sat, 11 Oct 2025 09:58:24 -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 1v7a74-000628-41 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:22 -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 1v7a6u-0004cO-2l for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:21 -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 ECD19C0196; Sat, 11 Oct 2025 16:57:58 +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-mSMzA6ac; Sat, 11 Oct 2025 16:57:58 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191078; bh=KrogRysMTqgdyPfx+7Zf3fqdEHX2+3XH4e/2Zkq2+08=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=rroOtsQRM3SIiYJGW08fFtri/CQGvzZzpieRGvxVLCm+6Q9MJLWD82S20ScvRudfl 2Gbs3w/fo4y5o4hAI8Uk1xEHI5UPzqWhS2UXOKjLR8T1csIFbDCRmQAIspjkcutHEz AzBzNuLy0/qO4aldqQruHc4x9YMbcjC38YznY11Y= 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, Gerd Hoffmann , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= Subject: [PATCH 03/33] qapi/audio.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:45 +0300 Message-ID: <20251011135754.294521-5-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191213930158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/audio.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/audio.json b/qapi/audio.json index 53142080f7..2df87b9710 100644 --- a/qapi/audio.json +++ b/qapi/audio.json @@ -76,8 +76,8 @@ # # @out: options of the playback stream # -# @nsamples: set the number of samples per read/write calls (default to 48= 0, -# 10ms at 48kHz). +# @nsamples: set the number of samples per read/write calls +# (default to 480, 10ms at 48kHz). # # Since: 10.0 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191336; cv=none; d=zohomail.com; s=zohoarc; b=XijiwPOmLPGbqDdfVrFknNYY38ZunOPWToOE5Ju4NR3BHIdI9Zqg9SRxN9dHqhsckjVaEJ/M1MLxgsDeRBc7nYpFR3Ig42rLlj6H1y10a29+b3MCWseq8Ic6FP5RjToJPgesAjqBusdlUuT0rPRmdd/F6sbz9jHxDIu6Uh+B67A= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191336; 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=rkyf7rGbhwFt5gk0ynFY+SGn3DOMn5p/CpXqqwTOTto=; b=A7u1Ch0jVgpOle8nC24erg18tRNvA1ogEhjllAwbn1UDpc5kZnxLQqUWt6qoBU8Zf9hts9y7MhuoM59t468rDL+NIQT8tHkGj3LerHVG1FbdEDGeQXNntYYARi/WVOTWLar657NJD9uzKbWHTPeZYSafWO+Rf54TaaPFNi5qe6E= 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 1760191336887839.9064522282081; Sat, 11 Oct 2025 07:02:16 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a78-00064o-Ny; Sat, 11 Oct 2025 09:58:26 -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 1v7a75-00062G-Cv; Sat, 11 Oct 2025 09:58:23 -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 1v7a6t-0004cW-5y; Sat, 11 Oct 2025 09:58:22 -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 E79EFC0198; Sat, 11 Oct 2025 16:58:00 +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-F3t8WBj3; Sat, 11 Oct 2025 16:58:00 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191080; bh=rkyf7rGbhwFt5gk0ynFY+SGn3DOMn5p/CpXqqwTOTto=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=e30KV+maUc8ToLrHBMTBP6NotQoYxqlpV/gmg5cTJUUcLJqy3EqMTEQ2QnMhNC3Wk sAmT2QCjkoxIMTqIBhRGby/XOmrSaW+WYrvG0iDiQxU1x6p23jEtosdTv63+boNQl5 mpMbHQ4anftY6NI/uQ4jT/ynaWuoKG//fF6lJe70= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 04/33] qapi/block-core.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:48 +0300 Message-ID: <20251011135754.294521-8-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191339409154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block-core.json | 191 ++++++++++++++++++++++++------------------- 1 file changed, 106 insertions(+), 85 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index dc6eb4ae23..4828a78371 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -159,14 +159,15 @@ ## # @ImageInfoSpecificRbd: # -# @encryption-format: Image encryption format. If encryption is enabled fo= r the -# image (see encrypted in BlockNodeInfo), this is the actual format in= which the -# image is accessed. If encryption is not enabled, this is the result = of -# probing when the image was opened, to give a suggestion which encryp= tion -# format could be enabled. Note that probing results can be changed by= the -# guest by writing a (possibly partial) encryption format header to the -# image, so don't treat this information as trusted if the guest is not -# trusted. +# @encryption-format: Image encryption format. If encryption is +# enabled for the image (see encrypted in BlockNodeInfo), this is +# the actual format in which the image is accessed. If encryption +# is not enabled, this is the result of probing when the image was +# opened, to give a suggestion which encryption format could be +# enabled. Note that probing results can be changed by the guest +# by writing a (possibly partial) encryption format header to the +# image, so don't treat this information as trusted if the guest +# is not trusted. # # Since: 6.1 ## @@ -340,8 +341,8 @@ # 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 +# @name: Child name of the root node in the `BlockGraphInfo` struct, +# in its role as the child of some undescribed parent node # # @info: Block graph information starting at this node # @@ -507,11 +508,12 @@ # @backing_file_depth: number of files in the backing file chain # (since: 1.2) # -# @children: Information about child block nodes. (since: 10.1) +# @children: Information about child block nodes. (since: 10.1) # -# @active: true if the backend is active; typical cases for inactive backe= nds -# are on the migration source instance after migration completes and o= n the -# destination before it completes. (since: 10.0) +# @active: true if the backend is active; typical cases for inactive +# backends are on the migration source instance after migration +# completes and on the destination before it completes. +# (since: 10.0) # # @encrypted: true if the backing device is encrypted # @@ -1627,11 +1629,12 @@ # different block device than @device). # # @on-cbw-error: policy defining behavior on I/O errors in -# copy-before-write jobs; defaults to break-guest-write. (Since 10.1) +# copy-before-write jobs; defaults to break-guest-write. +# (Since 10.1) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 2.12) # @@ -1743,7 +1746,8 @@ # # @allow-write-only-overlay: If present, the check whether this # operation is safe was relaxed so that it can be used to change -# backing file of a destination of a `blockdev-mirror`. (since 5.0) +# backing file of a destination of a `blockdev-mirror`. +# (since 5.0) # # Since: 2.5 # @@ -1870,8 +1874,8 @@ # autogenerated. (Since: 2.9) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -1944,10 +1948,10 @@ # @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. +# 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 @@ -2005,7 +2009,8 @@ # "format":"qcow2", # "virtual-size":2048000, # "backing_file":"base.qcow2", -# "full-backing-filename":"disks/base.qcow2", +# "full-backing-filename": +# "disks/base.qcow2", # "backing-filename-format":"qcow2", # "snapshots":[ # { @@ -2231,8 +2236,8 @@ # 'background' (Since: 3.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -2282,7 +2287,8 @@ # # @disabled: the bitmap is created in the disabled state, which means # that it will not track drive changes. The bitmap may be enabled -# with `block-dirty-bitmap-enable`. Default is false. (Since: 4.0) +# with `block-dirty-bitmap-enable`. Default is false. +# (Since: 4.0) # # Since: 2.4 ## @@ -2347,8 +2353,8 @@ # @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. +# 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 @@ -2546,8 +2552,8 @@ # 'background' (Since: 3.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -2873,8 +2879,8 @@ # autogenerated. (Since: 6.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -3044,16 +3050,16 @@ # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive -# mirroring includes `drive-mirror`, `blockdev-mirror` and `block-commit` -# job (only in case of "active commit", when the node being commited -# is used by the guest). The ability to complete is signaled with a -# `BLOCK_JOB_READY` event. +# mirroring includes `drive-mirror`, `blockdev-mirror` and +# `block-commit` job (only in case of "active commit", when the node +# being commited is used by the guest). The ability to complete is +# signaled with a `BLOCK_JOB_READY` event. # # This command completes an active background block operation # synchronously. The ordering of this command's return with the -# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O error -# occurs during the processing of this command: 1) the command itself -# will fail; 2) the error will be processed according to the +# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O +# error occurs during the processing of this command: 1) the command +# itself will fail; 2) the error will be processed according to the # rerror/werror arguments that were specified when starting the # operation. # @@ -3083,8 +3089,8 @@ # needs to be run explicitly for jobs that don't have automatic # dismiss enabled. In turn, automatic dismiss may be enabled only # for jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` and -# `block-stream`. @auto-dismiss is enabled by default for these +# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` +# and `block-stream`. @auto-dismiss is enabled by default for these # jobs. # # This command will refuse to operate on any job that has not yet @@ -3117,8 +3123,8 @@ # force ALL jobs in the transaction to finalize, so it is only # necessary to instruct a single member job to finalize. # -# The command is applicable only to jobs which have @auto-finalize option -# and only when this option is set to false. +# The command is applicable only to jobs which have @auto-finalize +# option and only when this option is set to false. # # @id: The job identifier. # @@ -4748,9 +4754,9 @@ # @cache: cache-related options # # @active: whether the block node should be activated (default: true). -# Having inactive block nodes is useful primarily for migration becaus= e it -# allows opening an image on the destination while the source is still -# holding locks for it. (Since 10.0) +# Having inactive block nodes is useful primarily for migration +# because it allows opening an image on the destination while the +# source is still holding locks for it. (Since 10.0) # # @read-only: whether the block device should be read-only (default: # false). Note that some block drivers support only read-only @@ -4942,11 +4948,12 @@ # cancelled. # # The command receives a list of block devices to reopen. For each -# one of them, the top-level @node-name option (from `BlockdevOptions`) -# must be specified and is used to select the block device to be -# reopened. Other @node-name options must be either omitted or set to -# the current name of the appropriate node. This command won't change -# any node name and any attempt to do it will result in an error. +# one of them, the top-level @node-name option (from +# `BlockdevOptions`) must be specified and is used to select the block +# device to be reopened. Other @node-name options must be either +# omitted or set to the current name of the appropriate node. This +# command won't change any node name and any attempt to do it will +# result in an error. # # In the case of options that refer to child nodes, the behavior of # this command depends on the value: @@ -4965,10 +4972,10 @@ # Options (1) and (2) are supported in all cases. Option (3) is # supported for @file and @backing, and option (4) for @backing only. # -# Unlike with `blockdev-add`, the @backing option must always be present -# unless the node being reopened does not have a backing file and its -# image does not have a default backing file name as part of its -# metadata. +# Unlike with `blockdev-add`, the @backing option must always be +# present unless the node being reopened does not have a backing file +# and its image does not have a default backing file name as part of +# its metadata. # # Since: 6.1 ## @@ -4979,8 +4986,8 @@ ## # @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 +# 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. @@ -5012,18 +5019,18 @@ ## # @blockdev-set-active: # -# Activate or inactivate a block device. Use this to manage the handover = of -# block devices on migration with qemu-storage-daemon. +# Activate or inactivate a block device. Use this to manage the +# handover of block devices on migration with qemu-storage-daemon. # -# Activating a node automatically activates all of its child nodes first. -# Inactivating a node automatically inactivates any of its child nodes tha= t are -# not in use by a still active node. +# Activating a node automatically activates all of its child nodes +# first. Inactivating a node automatically inactivates any of its +# child nodes that are not in use by a still active node. # -# @node-name: Name of the graph node to activate or inactivate. By defaul= t, all -# nodes are affected by the operation. +# @node-name: Name of the graph node to activate or inactivate. By +# default, all nodes are affected by the operation. # -# @active: true if the nodes should be active when the command returns suc= cess, -# false if they should be inactive. +# @active: true if the nodes should be active when the command returns +# success, false if they should be inactive. # # Since: 10.0 # @@ -5671,9 +5678,12 @@ # .. qmp-example:: # # <- { "event": "BLOCK_IMAGE_CORRUPTED", -# "data": { "device": "", "node-name": "drive", "fatal": false, -# "msg": "L2 table offset 0x2a2a2a00 unaligned (L1 inde= x: 0)" }, -# "timestamp": { "seconds": 1648243240, "microseconds": 906060 } } +# "data": { +# "device": "", "node-name": "drive", "fatal": false, +# "msg": +# "L2 table offset 0x2a2a2a00 unaligned (L1 index: 0)" }, +# "timestamp": { "seconds": 1648243240, +# "microseconds": 906060 } } # # Since: 1.7 ## @@ -5730,7 +5740,8 @@ # "operation": "write", # "action": "stop", # "reason": "No space left on device" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_IO_ERROR', 'data': { 'qom-path': 'str', 'device': 'str', '*node-name': 'str', @@ -5768,7 +5779,8 @@ # "data": { "type": "stream", "device": "virtio-disk0", # "len": 10737418240, "offset": 10737418240, # "speed": 0 }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'BLOCK_JOB_COMPLETED', 'data': { 'type' : 'JobType', @@ -5803,7 +5815,8 @@ # "data": { "type": "stream", "device": "virtio-disk0", # "len": 10737418240, "offset": 134217728, # "speed": 0 }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'BLOCK_JOB_CANCELLED', 'data': { 'type' : 'JobType', @@ -5832,7 +5845,8 @@ # "data": { "device": "ide0-hd1", # "operation": "write", # "action": "stop" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_ERROR', 'data': { 'device' : 'str', @@ -5866,7 +5880,8 @@ # <- { "event": "BLOCK_JOB_READY", # "data": { "device": "drive0", "type": "mirror", "speed": 0, # "len": 2097152, "offset": 2097152 }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_READY', 'data': { 'type' : 'JobType', @@ -5893,7 +5908,8 @@ # # <- { "event": "BLOCK_JOB_PENDING", # "data": { "type": "mirror", "id": "backup_1" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_PENDING', 'data': { 'type' : 'JobType', @@ -6113,8 +6129,10 @@ # .. qmp-example:: # # <- { "event": "QUORUM_FAILURE", -# "data": { "reference": "usr1", "sector-num": 345435, "sectors-c= ount": 5 }, -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "data": { "reference": "usr1", "sector-num": 345435, +# "sectors-count": 5 }, +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } ## { 'event': 'QUORUM_FAILURE', 'data': { 'reference': 'str', 'sector-num': 'int', 'sectors-count': 'int= ' } } @@ -6145,17 +6163,20 @@ # :title: Read operation # # <- { "event": "QUORUM_REPORT_BAD", -# "data": { "node-name": "node0", "sector-num": 345435, "sectors-= count": 5, -# "type": "read" }, -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "data": { "node-name": "node0", "sector-num": 345435, +# "sectors-count": 5, "type": "read" }, +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } # # .. qmp-example:: # :title: Flush operation # # <- { "event": "QUORUM_REPORT_BAD", -# "data": { "node-name": "node0", "sector-num": 0, "sectors-count= ": 2097120, -# "type": "flush", "error": "Broken pipe" }, -# "timestamp": { "seconds": 1456406829, "microseconds": 291763 } } +# "data": { "node-name": "node0", "sector-num": 0, +# "sectors-count": 2097120, "type": "flush", +# "error": "Broken pipe" }, +# "timestamp": { "seconds": 1456406829, +# "microseconds": 291763 } } ## { 'event': 'QUORUM_REPORT_BAD', 'data': { 'type': 'QuorumOpType', '*error': 'str', 'node-name': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192818; cv=none; d=zohomail.com; s=zohoarc; b=M+ogqcjKpZZfar6DhRPdaPNQ9FsHtTSAn157eVG1SP0nCCgaQzueW6nGjEspPpL1XoDbTj4Zn1yjBD7QHokDuzVZSbhGq++OEfMP1j+wknkDdQLqyleV9GHHv90GM+rV2bSyQpJCNrRT7E0mfgZA4zjkJyBDHzGc7ynIoeYkQ/4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192818; 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=rkyf7rGbhwFt5gk0ynFY+SGn3DOMn5p/CpXqqwTOTto=; b=L9l8S2+RvFj/4ydauREG6Y9uzC8N2rzp37tJ9Xz7toqCMx9MRDpv7L5MIHX9yUfBPwTxa5zPr109FvUj2rC455d6PO8SmYPh/QZwUw3S1ARf6yvaMx/tpet5RTZNwfEGvJQU1168t1gxxGdQuFZbWA2yt6DfJHKy03fiInBi4FE= 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 1760192818684797.6651735741264; Sat, 11 Oct 2025 07:26:58 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7D-00065n-H6; Sat, 11 Oct 2025 09:58:32 -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 1v7a7B-00064x-Ar; Sat, 11 Oct 2025 09:58:29 -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 1v7a6t-0004cV-Ix; Sat, 11 Oct 2025 09:58:27 -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 2658CC0199; Sat, 11 Oct 2025 16:58:00 +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-EGShGhYw; Sat, 11 Oct 2025 16:57:59 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191079; bh=rkyf7rGbhwFt5gk0ynFY+SGn3DOMn5p/CpXqqwTOTto=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=Zj5qwqN1LSLiffLtliXXUknI01sPoYPBCEjVXgK1QGafati8dh+/NcLJJh+IVCE1c NEOOuWR7kUr3iwg95J49NFVT9mTyI6gDYZDgDaS5TxGIiLT92ZMh4d1S+Nxcf/GmeQ wrXG1CJVzmpzs+1MYd4W0efAd+R+7SHmV0Vq1lWE= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 04/33] qapi/block-core.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:47 +0300 Message-ID: <20251011135754.294521-7-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192823228158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block-core.json | 191 ++++++++++++++++++++++++------------------- 1 file changed, 106 insertions(+), 85 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index dc6eb4ae23..4828a78371 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -159,14 +159,15 @@ ## # @ImageInfoSpecificRbd: # -# @encryption-format: Image encryption format. If encryption is enabled fo= r the -# image (see encrypted in BlockNodeInfo), this is the actual format in= which the -# image is accessed. If encryption is not enabled, this is the result = of -# probing when the image was opened, to give a suggestion which encryp= tion -# format could be enabled. Note that probing results can be changed by= the -# guest by writing a (possibly partial) encryption format header to the -# image, so don't treat this information as trusted if the guest is not -# trusted. +# @encryption-format: Image encryption format. If encryption is +# enabled for the image (see encrypted in BlockNodeInfo), this is +# the actual format in which the image is accessed. If encryption +# is not enabled, this is the result of probing when the image was +# opened, to give a suggestion which encryption format could be +# enabled. Note that probing results can be changed by the guest +# by writing a (possibly partial) encryption format header to the +# image, so don't treat this information as trusted if the guest +# is not trusted. # # Since: 6.1 ## @@ -340,8 +341,8 @@ # 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 +# @name: Child name of the root node in the `BlockGraphInfo` struct, +# in its role as the child of some undescribed parent node # # @info: Block graph information starting at this node # @@ -507,11 +508,12 @@ # @backing_file_depth: number of files in the backing file chain # (since: 1.2) # -# @children: Information about child block nodes. (since: 10.1) +# @children: Information about child block nodes. (since: 10.1) # -# @active: true if the backend is active; typical cases for inactive backe= nds -# are on the migration source instance after migration completes and o= n the -# destination before it completes. (since: 10.0) +# @active: true if the backend is active; typical cases for inactive +# backends are on the migration source instance after migration +# completes and on the destination before it completes. +# (since: 10.0) # # @encrypted: true if the backing device is encrypted # @@ -1627,11 +1629,12 @@ # different block device than @device). # # @on-cbw-error: policy defining behavior on I/O errors in -# copy-before-write jobs; defaults to break-guest-write. (Since 10.1) +# copy-before-write jobs; defaults to break-guest-write. +# (Since 10.1) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 2.12) # @@ -1743,7 +1746,8 @@ # # @allow-write-only-overlay: If present, the check whether this # operation is safe was relaxed so that it can be used to change -# backing file of a destination of a `blockdev-mirror`. (since 5.0) +# backing file of a destination of a `blockdev-mirror`. +# (since 5.0) # # Since: 2.5 # @@ -1870,8 +1874,8 @@ # autogenerated. (Since: 2.9) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -1944,10 +1948,10 @@ # @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. +# 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 @@ -2005,7 +2009,8 @@ # "format":"qcow2", # "virtual-size":2048000, # "backing_file":"base.qcow2", -# "full-backing-filename":"disks/base.qcow2", +# "full-backing-filename": +# "disks/base.qcow2", # "backing-filename-format":"qcow2", # "snapshots":[ # { @@ -2231,8 +2236,8 @@ # 'background' (Since: 3.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -2282,7 +2287,8 @@ # # @disabled: the bitmap is created in the disabled state, which means # that it will not track drive changes. The bitmap may be enabled -# with `block-dirty-bitmap-enable`. Default is false. (Since: 4.0) +# with `block-dirty-bitmap-enable`. Default is false. +# (Since: 4.0) # # Since: 2.4 ## @@ -2347,8 +2353,8 @@ # @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. +# 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 @@ -2546,8 +2552,8 @@ # 'background' (Since: 3.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -2873,8 +2879,8 @@ # autogenerated. (Since: 6.0) # # @auto-finalize: When false, this job will wait in a PENDING state -# after it has finished its work, waiting for `job-finalize` before -# making any block graph changes. When true, this job will +# after it has finished its work, waiting for `job-finalize` +# before making any block graph changes. When true, this job will # automatically perform its abort or commit actions. Defaults to # true. (Since 3.1) # @@ -3044,16 +3050,16 @@ # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive -# mirroring includes `drive-mirror`, `blockdev-mirror` and `block-commit` -# job (only in case of "active commit", when the node being commited -# is used by the guest). The ability to complete is signaled with a -# `BLOCK_JOB_READY` event. +# mirroring includes `drive-mirror`, `blockdev-mirror` and +# `block-commit` job (only in case of "active commit", when the node +# being commited is used by the guest). The ability to complete is +# signaled with a `BLOCK_JOB_READY` event. # # This command completes an active background block operation # synchronously. The ordering of this command's return with the -# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O error -# occurs during the processing of this command: 1) the command itself -# will fail; 2) the error will be processed according to the +# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O +# error occurs during the processing of this command: 1) the command +# itself will fail; 2) the error will be processed according to the # rerror/werror arguments that were specified when starting the # operation. # @@ -3083,8 +3089,8 @@ # needs to be run explicitly for jobs that don't have automatic # dismiss enabled. In turn, automatic dismiss may be enabled only # for jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` and -# `block-stream`. @auto-dismiss is enabled by default for these +# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` +# and `block-stream`. @auto-dismiss is enabled by default for these # jobs. # # This command will refuse to operate on any job that has not yet @@ -3117,8 +3123,8 @@ # force ALL jobs in the transaction to finalize, so it is only # necessary to instruct a single member job to finalize. # -# The command is applicable only to jobs which have @auto-finalize option -# and only when this option is set to false. +# The command is applicable only to jobs which have @auto-finalize +# option and only when this option is set to false. # # @id: The job identifier. # @@ -4748,9 +4754,9 @@ # @cache: cache-related options # # @active: whether the block node should be activated (default: true). -# Having inactive block nodes is useful primarily for migration becaus= e it -# allows opening an image on the destination while the source is still -# holding locks for it. (Since 10.0) +# Having inactive block nodes is useful primarily for migration +# because it allows opening an image on the destination while the +# source is still holding locks for it. (Since 10.0) # # @read-only: whether the block device should be read-only (default: # false). Note that some block drivers support only read-only @@ -4942,11 +4948,12 @@ # cancelled. # # The command receives a list of block devices to reopen. For each -# one of them, the top-level @node-name option (from `BlockdevOptions`) -# must be specified and is used to select the block device to be -# reopened. Other @node-name options must be either omitted or set to -# the current name of the appropriate node. This command won't change -# any node name and any attempt to do it will result in an error. +# one of them, the top-level @node-name option (from +# `BlockdevOptions`) must be specified and is used to select the block +# device to be reopened. Other @node-name options must be either +# omitted or set to the current name of the appropriate node. This +# command won't change any node name and any attempt to do it will +# result in an error. # # In the case of options that refer to child nodes, the behavior of # this command depends on the value: @@ -4965,10 +4972,10 @@ # Options (1) and (2) are supported in all cases. Option (3) is # supported for @file and @backing, and option (4) for @backing only. # -# Unlike with `blockdev-add`, the @backing option must always be present -# unless the node being reopened does not have a backing file and its -# image does not have a default backing file name as part of its -# metadata. +# Unlike with `blockdev-add`, the @backing option must always be +# present unless the node being reopened does not have a backing file +# and its image does not have a default backing file name as part of +# its metadata. # # Since: 6.1 ## @@ -4979,8 +4986,8 @@ ## # @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 +# 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. @@ -5012,18 +5019,18 @@ ## # @blockdev-set-active: # -# Activate or inactivate a block device. Use this to manage the handover = of -# block devices on migration with qemu-storage-daemon. +# Activate or inactivate a block device. Use this to manage the +# handover of block devices on migration with qemu-storage-daemon. # -# Activating a node automatically activates all of its child nodes first. -# Inactivating a node automatically inactivates any of its child nodes tha= t are -# not in use by a still active node. +# Activating a node automatically activates all of its child nodes +# first. Inactivating a node automatically inactivates any of its +# child nodes that are not in use by a still active node. # -# @node-name: Name of the graph node to activate or inactivate. By defaul= t, all -# nodes are affected by the operation. +# @node-name: Name of the graph node to activate or inactivate. By +# default, all nodes are affected by the operation. # -# @active: true if the nodes should be active when the command returns suc= cess, -# false if they should be inactive. +# @active: true if the nodes should be active when the command returns +# success, false if they should be inactive. # # Since: 10.0 # @@ -5671,9 +5678,12 @@ # .. qmp-example:: # # <- { "event": "BLOCK_IMAGE_CORRUPTED", -# "data": { "device": "", "node-name": "drive", "fatal": false, -# "msg": "L2 table offset 0x2a2a2a00 unaligned (L1 inde= x: 0)" }, -# "timestamp": { "seconds": 1648243240, "microseconds": 906060 } } +# "data": { +# "device": "", "node-name": "drive", "fatal": false, +# "msg": +# "L2 table offset 0x2a2a2a00 unaligned (L1 index: 0)" }, +# "timestamp": { "seconds": 1648243240, +# "microseconds": 906060 } } # # Since: 1.7 ## @@ -5730,7 +5740,8 @@ # "operation": "write", # "action": "stop", # "reason": "No space left on device" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_IO_ERROR', 'data': { 'qom-path': 'str', 'device': 'str', '*node-name': 'str', @@ -5768,7 +5779,8 @@ # "data": { "type": "stream", "device": "virtio-disk0", # "len": 10737418240, "offset": 10737418240, # "speed": 0 }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'BLOCK_JOB_COMPLETED', 'data': { 'type' : 'JobType', @@ -5803,7 +5815,8 @@ # "data": { "type": "stream", "device": "virtio-disk0", # "len": 10737418240, "offset": 134217728, # "speed": 0 }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'BLOCK_JOB_CANCELLED', 'data': { 'type' : 'JobType', @@ -5832,7 +5845,8 @@ # "data": { "device": "ide0-hd1", # "operation": "write", # "action": "stop" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_ERROR', 'data': { 'device' : 'str', @@ -5866,7 +5880,8 @@ # <- { "event": "BLOCK_JOB_READY", # "data": { "device": "drive0", "type": "mirror", "speed": 0, # "len": 2097152, "offset": 2097152 }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_READY', 'data': { 'type' : 'JobType', @@ -5893,7 +5908,8 @@ # # <- { "event": "BLOCK_JOB_PENDING", # "data": { "type": "mirror", "id": "backup_1" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'BLOCK_JOB_PENDING', 'data': { 'type' : 'JobType', @@ -6113,8 +6129,10 @@ # .. qmp-example:: # # <- { "event": "QUORUM_FAILURE", -# "data": { "reference": "usr1", "sector-num": 345435, "sectors-c= ount": 5 }, -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "data": { "reference": "usr1", "sector-num": 345435, +# "sectors-count": 5 }, +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } ## { 'event': 'QUORUM_FAILURE', 'data': { 'reference': 'str', 'sector-num': 'int', 'sectors-count': 'int= ' } } @@ -6145,17 +6163,20 @@ # :title: Read operation # # <- { "event": "QUORUM_REPORT_BAD", -# "data": { "node-name": "node0", "sector-num": 345435, "sectors-= count": 5, -# "type": "read" }, -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "data": { "node-name": "node0", "sector-num": 345435, +# "sectors-count": 5, "type": "read" }, +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } # # .. qmp-example:: # :title: Flush operation # # <- { "event": "QUORUM_REPORT_BAD", -# "data": { "node-name": "node0", "sector-num": 0, "sectors-count= ": 2097120, -# "type": "flush", "error": "Broken pipe" }, -# "timestamp": { "seconds": 1456406829, "microseconds": 291763 } } +# "data": { "node-name": "node0", "sector-num": 0, +# "sectors-count": 2097120, "type": "flush", +# "error": "Broken pipe" }, +# "timestamp": { "seconds": 1456406829, +# "microseconds": 291763 } } ## { 'event': 'QUORUM_REPORT_BAD', 'data': { 'type': 'QuorumOpType', '*error': 'str', 'node-name': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191599; cv=none; d=zohomail.com; s=zohoarc; b=dMwPkusKukb2hp7khb5CaSf+FVFALZE8SZnlxlv3n8U+ZzxA0DSDHi/8YOsp4VkTjIg2gOWfwVOH80WWeuzwFvEJDRJiYFj1LnNR1RHSo4T+DPN2leqLGL1YYrQCFpFGjtWLYCU2eeTA1pxjwAs+UieACR8WDRLYQqGKQKwjvfQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191599; 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=0thFphHwZBRGYyoK4iTbQ6WBNY93AwWkUFuAz/JTb9E=; b=k627g721oFqS2bgHqTz0DyKqTRqc58k2i6L1EhuOee+sp00qQt4DL8/y9XTFz3Kj0fFgvxU3nEFhwgQbYrlcCwY9bsLYrWh2dmlLFGP/e0q+iFX50KGiJvv899kMkg5ab+1SG61LT3hNUu/kPwrdtRTMiB6UGWhyg8lLfl3QeVI= 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 176019159941348.26900396173505; Sat, 11 Oct 2025 07:06:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7L-00068e-I7; Sat, 11 Oct 2025 09:58:39 -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 1v7a7G-00066a-OP; Sat, 11 Oct 2025 09:58:35 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a6x-0004cZ-Kc; Sat, 11 Oct 2025 09:58:31 -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 68C02C019B; Sat, 11 Oct 2025 16:58:01 +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-ESYgHuXl; Sat, 11 Oct 2025 16:58:01 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191081; bh=0thFphHwZBRGYyoK4iTbQ6WBNY93AwWkUFuAz/JTb9E=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=Uj8Vs/f8PCOKQXAvue9jIrtDpyiiwtRk0sWUwGk7phfZTTKoXz3ejBhKn3DVCiJX7 J82uxzhrD6k1csCw7AwqR7O1fNPPd3wYfvNdlyOm7YWyrdGUtvnfidvTuJakNRcHaD DgNZTHUEnaEZLHGwiSfgO4HDdPD9y3GqpgRXGy4Y= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 05/33] qapi/block-export.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:49 +0300 Message-ID: <20251011135754.294521-9-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191601644154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block-export.json | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index 6878b89dcf..076954ef1a 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -38,8 +38,8 @@ ## # @NbdServerOptions: # -# Keep this type consistent with the `NbdServerOptionsLegacy` type. The -# only intended difference is using `SocketAddress` instead of +# 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). @@ -51,8 +51,8 @@ ## # @NbdServerOptionsLegacy: # -# Keep this type consistent with the `NbdServerOptions` type. The only -# intended difference is using `SocketAddressLegacy` instead of +# 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). @@ -125,8 +125,8 @@ # 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 UNIX -# domain sockets. +# 'fd' `SocketAddress` types are supported. Passed fds must be +# UNIX domain sockets. # # @logical-block-size: Logical block size in bytes. Defaults to 512 # bytes. @@ -373,11 +373,12 @@ # cannot be moved to the iothread. The default is false. # (since: 5.2) # -# @allow-inactive: If true, the export allows the exported node to be inac= tive. -# If it is created for an inactive block node, the node remains inacti= ve. If -# the export type doesn't support running on an inactive node, an erro= r is -# returned. If false, inactive block nodes are automatically activate= d before -# creating the export and trying to inactivate them later fails. +# @allow-inactive: If true, the export allows the exported node to be +# inactive. If it is created for an inactive block node, the node +# remains inactive. If the export type doesn't support running on +# an inactive node, an error is returned. If false, inactive +# block nodes are automatically activated before creating the +# export and trying to inactivate them later fails. # (since: 10.0; default: false) # # Since: 4.2 @@ -460,7 +461,8 @@ # @node-name: The node name of the block node that is exported # # @shutting-down: True if the export is shutting down (e.g. after a -# `block-export-del` command, but before the shutdown has completed) +# `block-export-del` command, but before the shutdown has +# completed) # # Since: 5.2 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191274; cv=none; d=zohomail.com; s=zohoarc; b=Uagpy7HLVI3E+yQYFbji6HI2WukdjN3flaOzkat58DGVQTSKTqng3wbHGCsHAGubkuXO93sPyxGg+IUSR8VVyqou2JvarAO7YtDqxhgfWd9yD7RM5Qzx9pnI4QLCiLgq+5vQ1EqLpS51rxuDz5nlQpxPO61o5QD3tyyfzCSD+HM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191274; 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=0thFphHwZBRGYyoK4iTbQ6WBNY93AwWkUFuAz/JTb9E=; b=lCUW6RwwdMfGX5mLIeBz3Q7EuewV/hc8bT/fx+BSImqlkhJgjbuhx88/sxVQPFmd4XCELmQHSWXRP2CLqscUKrfU5m4cxuYFoTBKoHyKWk6XmMffc9v+Uw9JBORl0qzQNcLqP+4kNjSXK57icokxiXkUKjlACCwlZwBV8UTjRPM= 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 1760191274003387.35124883383094; Sat, 11 Oct 2025 07:01:14 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7B-00064w-QK; Sat, 11 Oct 2025 09:58:29 -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 1v7a72-00061Q-My; Sat, 11 Oct 2025 09:58:20 -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 1v7a6t-0004ck-5v; Sat, 11 Oct 2025 09:58:18 -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 DDBD3C00BE; Sat, 11 Oct 2025 16:58:01 +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-Z0wZYiqX; Sat, 11 Oct 2025 16:58:01 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191081; bh=0thFphHwZBRGYyoK4iTbQ6WBNY93AwWkUFuAz/JTb9E=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=RZzlmxoRXVD2NcxwdYhT+j6WCf8DPTIcfHr+Vv0pxxYNEBvYf7uW44+u54mcYu5qd k0zlLAtuiFUExFAglWgyzTGCDfEdnJb+JmrR6FkmJfqcnKpykCuI09jKMyXTIvAoY7 bbTzfOWkUDKvTBfU8gu/iuNa5damlk7AvGOkqItc= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 05/33] qapi/block-export.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:50 +0300 Message-ID: <20251011135754.294521-10-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191276872154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block-export.json | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index 6878b89dcf..076954ef1a 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -38,8 +38,8 @@ ## # @NbdServerOptions: # -# Keep this type consistent with the `NbdServerOptionsLegacy` type. The -# only intended difference is using `SocketAddress` instead of +# 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). @@ -51,8 +51,8 @@ ## # @NbdServerOptionsLegacy: # -# Keep this type consistent with the `NbdServerOptions` type. The only -# intended difference is using `SocketAddressLegacy` instead of +# 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). @@ -125,8 +125,8 @@ # 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 UNIX -# domain sockets. +# 'fd' `SocketAddress` types are supported. Passed fds must be +# UNIX domain sockets. # # @logical-block-size: Logical block size in bytes. Defaults to 512 # bytes. @@ -373,11 +373,12 @@ # cannot be moved to the iothread. The default is false. # (since: 5.2) # -# @allow-inactive: If true, the export allows the exported node to be inac= tive. -# If it is created for an inactive block node, the node remains inacti= ve. If -# the export type doesn't support running on an inactive node, an erro= r is -# returned. If false, inactive block nodes are automatically activate= d before -# creating the export and trying to inactivate them later fails. +# @allow-inactive: If true, the export allows the exported node to be +# inactive. If it is created for an inactive block node, the node +# remains inactive. If the export type doesn't support running on +# an inactive node, an error is returned. If false, inactive +# block nodes are automatically activated before creating the +# export and trying to inactivate them later fails. # (since: 10.0; default: false) # # Since: 4.2 @@ -460,7 +461,8 @@ # @node-name: The node name of the block node that is exported # # @shutting-down: True if the export is shutting down (e.g. after a -# `block-export-del` command, but before the shutdown has completed) +# `block-export-del` command, but before the shutdown has +# completed) # # Since: 5.2 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191368; cv=none; d=zohomail.com; s=zohoarc; b=AU29e107AVbktj/7DN7c5kEawVVRyeJkWZfBafzOkgK5IxW6OIOxzKSaLDSbMvET7NrcejLFnvrhY7gSmi8oCChZy5gy1yzUAqdPZ6ACW3Gna9bGD2ZAhEluABOpdLshQJxGl0kV/3jx5ZwxrKNKVSWjjXO+zULv1LDqgPbdrL0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191368; 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=XaNPKEYFvprDxxt9TryZMmnN05KO5P9DtdGM+QisyJ4=; b=M0VvHIAB/Bg+a3edN70ftoWcJe92fs5WsppjbXaxC4ICGZW+nkp66rmMH56pumcvscVurw3D28lFK9zFsBuVHHSCi0z0FYiFhEChWn2cZwDHmTl9xWQfho5jsjaeH8AaC9W4IdFdCf4sBeGvI78O2izPNsGzWV9pA/faL3SAXdk= 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 1760191368656442.4474967650191; Sat, 11 Oct 2025 07:02:48 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7M-00069H-C8; Sat, 11 Oct 2025 09:58:40 -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 1v7a7H-00066K-AD; Sat, 11 Oct 2025 09:58:35 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a76-0004hD-NY; Sat, 11 Oct 2025 09:58:32 -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 707E4C00D5; Sat, 11 Oct 2025 16:58:02 +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-FQFeaP6r; Sat, 11 Oct 2025 16:58:02 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191082; bh=XaNPKEYFvprDxxt9TryZMmnN05KO5P9DtdGM+QisyJ4=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=p6If2h7oeJp8yJdRugkJdi8J82c3PJWLSgzC9gTh12QKna9Y6L312ZonK3MQbugyR JdoJPXe9sEh4ewWofYje9mvyivDNpCjAmCRCzzQJJqJPjR1/A/CcKiXVLdeGkFkUIL HyiO7xXTG79TSnESax1TxEkTaZy+7akGoTMG9qXM= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 06/33] qapi/block.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:51 +0300 Message-ID: <20251011135754.294521-11-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191371016158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block.json | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 46955bbb3e..4398c801ee 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -240,7 +240,8 @@ # "arguments": { "id": "ide0-1-0" } } # # <- { "error": { "class": "GenericError", -# "desc": "Tray of device 'ide0-1-0' is not open" } } +# "desc": "Tray of device 'ide0-1-0' is not open" +# } } # # -> { "execute": "blockdev-open-tray", # "arguments": { "id": "ide0-1-0" } } @@ -350,7 +351,8 @@ # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "ide0-1-0", -# "filename": "/srv/images/Fedora-12-x86_64-DVD.is= o", +# "filename": +# "/srv/images/Fedora-12-x86_64-DVD.iso", # "format": "raw" } } # <- { "return": {} } # @@ -359,17 +361,17 @@ # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "floppyA", -# "filename": "/srv/images/ro.img", +# "filename": "ro.img", # "format": "raw", # "read-only-mode": "retain" } } # # <- { "error": # { "class": "GenericError", -# "desc": "Could not open '/srv/images/ro.img': Permission deni= ed" } } +# "desc": "Could not open 'ro.img': Permission denied" } } # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "floppyA", -# "filename": "/srv/images/ro.img", +# "filename": "ro.img", # "format": "raw", # "read-only-mode": "read-only" } } # @@ -407,7 +409,8 @@ # "id": "/machine/unattached/device[22]", # "tray-open": true # }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'DEVICE_TRAY_MOVED', 'data': { 'device': 'str', 'id': 'str', 'tray-open': 'bool' } } @@ -430,7 +433,8 @@ # "data": { "id": "pr-helper0", # "connected": true # }, -# "timestamp": { "seconds": 1519840375, "microseconds": 450486 } } +# "timestamp": { "seconds": 1519840375, +# "microseconds": 450486 } } ## { 'event': 'PR_MANAGER_STATUS_CHANGED', 'data': { 'id': 'str', 'connected': 'bool' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192198; cv=none; d=zohomail.com; s=zohoarc; b=QSlhZ+bLxoi1Me1Jo/pJ8/Bety7nq8Hv26x5Iwl0RPMYLDlcUogaXSlqJnv98FQcot0FH9gjJUrGsI9Vil0ThSc8+XMYq7pg5Aj6n/HYbw5jIIa96fhpaxIWf8XV2VnkUDMtMGeXSaLvLL/QjNZr7lLYFUdqj5GA8KXgfct+7kw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192198; 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=XaNPKEYFvprDxxt9TryZMmnN05KO5P9DtdGM+QisyJ4=; b=Eps1T1pX1sUMgauh8VjxhzFZoNA8jJAknoOXwfL7OuU9i3dBgOzbpR2cPFtGY4ov4u0p13SwS5TS6n4HuviXm3/YLdCameTmkeERWSwwijXgpsZ563OdVybnpXWTM767zuK4B1S1vWBLePlsFpiZ1m3GyjBvsQkYPJn5kgiPmIo= 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 1760192198110221.88156100441074; Sat, 11 Oct 2025 07:16:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7X-0006Ez-BA; Sat, 11 Oct 2025 09:58:51 -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 1v7a7P-0006B3-MX; Sat, 11 Oct 2025 09:58:43 -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 1v7a78-0004hC-1q; Sat, 11 Oct 2025 09:58:42 -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 E07D1C00D6; Sat, 11 Oct 2025 16:58:02 +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-si4h6nqr; Sat, 11 Oct 2025 16:58:02 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191082; bh=XaNPKEYFvprDxxt9TryZMmnN05KO5P9DtdGM+QisyJ4=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=mwOKmVgJPR/s0LkPlyYL9bvDTeW9k9eVzvJkhqBRZ8wOWgsAMVKaPp0EWs7sp1BV3 IVKfVGgcWQmLln1ABFLBUmI8U0JDHsGD5FNyC3elnfq7RhfTNyTMUb4EDhHd+pv4uZ JdGp7zhSqZVrjXtl93r7wGEnvIwxw8lywAK5NeeE= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 06/33] qapi/block.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:52 +0300 Message-ID: <20251011135754.294521-12-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: 1760192199264154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/block.json | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 46955bbb3e..4398c801ee 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -240,7 +240,8 @@ # "arguments": { "id": "ide0-1-0" } } # # <- { "error": { "class": "GenericError", -# "desc": "Tray of device 'ide0-1-0' is not open" } } +# "desc": "Tray of device 'ide0-1-0' is not open" +# } } # # -> { "execute": "blockdev-open-tray", # "arguments": { "id": "ide0-1-0" } } @@ -350,7 +351,8 @@ # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "ide0-1-0", -# "filename": "/srv/images/Fedora-12-x86_64-DVD.is= o", +# "filename": +# "/srv/images/Fedora-12-x86_64-DVD.iso", # "format": "raw" } } # <- { "return": {} } # @@ -359,17 +361,17 @@ # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "floppyA", -# "filename": "/srv/images/ro.img", +# "filename": "ro.img", # "format": "raw", # "read-only-mode": "retain" } } # # <- { "error": # { "class": "GenericError", -# "desc": "Could not open '/srv/images/ro.img': Permission deni= ed" } } +# "desc": "Could not open 'ro.img': Permission denied" } } # # -> { "execute": "blockdev-change-medium", # "arguments": { "id": "floppyA", -# "filename": "/srv/images/ro.img", +# "filename": "ro.img", # "format": "raw", # "read-only-mode": "read-only" } } # @@ -407,7 +409,8 @@ # "id": "/machine/unattached/device[22]", # "tray-open": true # }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'DEVICE_TRAY_MOVED', 'data': { 'device': 'str', 'id': 'str', 'tray-open': 'bool' } } @@ -430,7 +433,8 @@ # "data": { "id": "pr-helper0", # "connected": true # }, -# "timestamp": { "seconds": 1519840375, "microseconds": 450486 } } +# "timestamp": { "seconds": 1519840375, +# "microseconds": 450486 } } ## { 'event': 'PR_MANAGER_STATUS_CHANGED', 'data': { 'id': 'str', 'connected': 'bool' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191205; cv=none; d=zohomail.com; s=zohoarc; b=jql0Xe+EOnbaM+RYX5jT6VT2FJj2eXhjKlCBDNGmMeSy/mlXW9gQvOBER4XE8txWr+scd10R1cTMAEZeUGwnLgP/JkmICKbooda2ONWtd4XfYa5iaxze3y1cRaXdRmg7Ho2v0eld2RnbZ0NwgWAanx9fTyDxTc0whjbZz3as/Wg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191205; 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=SMshwY7iNroE9KHjRmndU4fpWnM0HeoNxchRExZSkZ0=; b=GBqFK8grBH5SZBGDoDh8P2WIegnCV4IZpIuUGHmz68ZFugT4yrAf8CiT3jocWJNCbw3iWDbplvr/wFZtfy0e1CuKPwui6eotlTk32EUEWYs+1QekNiHkIeXFcLx9DzowwWwNzycAoCzCehxW6CkWVtVEzroA7HLzNhwXKY+qCZo= 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 176019120575371.78287671917883; Sat, 11 Oct 2025 07:00:05 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7F-000662-TX; Sat, 11 Oct 2025 09:58:33 -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 1v7a7C-000659-1p for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:30 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a75-0004hy-GB for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:29 -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 DE05BC0139; Sat, 11 Oct 2025 16:58:03 +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-MRMBCQk0; Sat, 11 Oct 2025 16:58:03 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191083; bh=SMshwY7iNroE9KHjRmndU4fpWnM0HeoNxchRExZSkZ0=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=Iuu/TflwCJsgqfL+GoBNqANGtO8bWVJnTATpDi2TSMoH52q7+01ldIVmuK8O0SPkX HzpPa4EkGry/6zy7bM1f2LA5E4qx2LUbz7YdIXMgDzwIvfYRGpVzdePKnFonBM8zmZ 7e7zz+HCW2QzZgh2Nip4YfeOgMJFWrKqTri+lh5s= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Paolo Bonzini Subject: [PATCH 07/33] qapi/char.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:54 +0300 Message-ID: <20251011135754.294521-14-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191208915154101 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/char.json | 34 ++++++++++++++++++++++------------ 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/qapi/char.json b/qapi/char.json index f0a53f742c..52cca8da67 100644 --- a/qapi/char.json +++ b/qapi/char.json @@ -47,12 +47,14 @@ # "return": [ # { # "label": "charchannel0", -# "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.ag= ent,server=3Don", +# "filename": +# "unix:/.../seabios.rhel6.agent,server=3Don", # "frontend-open": false # }, # { # "label": "charmonitor", -# "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.mo= nitor,server=3Don", +# "filename": +# "unix:/.../seabios.rhel6.monitor,server=3Don", # "frontend-open": true # }, # { @@ -272,7 +274,8 @@ # @reconnect: For a client socket, if a socket is disconnected, then # attempt a reconnect after the given number of seconds. Setting # this to zero disables this function. The use of this member is -# deprecated, use @reconnect-ms instead. (default: 0) (Since: 2.2) +# deprecated, use @reconnect-ms instead. +# (default: 0) (Since: 2.2) # # @reconnect-ms: For a client socket, if a socket is disconnected, # then attempt a reconnect after the given number of milliseconds. @@ -776,22 +779,25 @@ # # -> { "execute" : "chardev-add", # "arguments" : { "id" : "foo", -# "backend" : { "type" : "null", "data" : {} } } } +# "backend" : { "type" : "null", +# "data" : {} } } } # <- { "return": {} } # # .. qmp-example:: # # -> { "execute" : "chardev-add", -# "arguments" : { "id" : "bar", -# "backend" : { "type" : "file", -# "data" : { "out" : "/tmp/bar.log"= } } } } +# "arguments" : { +# "id" : "bar", +# "backend" : { "type" : "file", +# "data" : { "out" : "/tmp/bar.log" } } } } # <- { "return": {} } # # .. qmp-example:: # # -> { "execute" : "chardev-add", # "arguments" : { "id" : "baz", -# "backend" : { "type" : "pty", "data" : {} } } } +# "backend" : { "type" : "pty", +# "data" : {} } } } # <- { "return": { "pty" : "/dev/pty/42" } } ## { 'command': 'chardev-add', @@ -814,7 +820,8 @@ # # -> { "execute" : "chardev-change", # "arguments" : { "id" : "baz", -# "backend" : { "type" : "pty", "data" : {} } } } +# "backend" : { "type" : "pty", +# "data" : {} } } } # <- { "return": { "pty" : "/dev/pty/42" } } # # .. qmp-example:: @@ -851,7 +858,8 @@ # # .. qmp-example:: # -# -> { "execute": "chardev-remove", "arguments": { "id" : "foo" } } +# -> { "execute": "chardev-remove", +# "arguments": { "id" : "foo" } } # <- { "return": {} } ## { 'command': 'chardev-remove', @@ -868,7 +876,8 @@ # # .. qmp-example:: # -# -> { "execute": "chardev-send-break", "arguments": { "id" : "foo" } } +# -> { "execute": "chardev-send-break", +# "arguments": { "id" : "foo" } } # <- { "return": {} } ## { 'command': 'chardev-send-break', @@ -891,7 +900,8 @@ # # <- { "event": "VSERPORT_CHANGE", # "data": { "id": "channel0", "open": true }, -# "timestamp": { "seconds": 1401385907, "microseconds": 422329 } } +# "timestamp": { "seconds": 1401385907, +# "microseconds": 422329 } } ## { 'event': 'VSERPORT_CHANGE', 'data': { 'id': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191779; cv=none; d=zohomail.com; s=zohoarc; b=WckayIBAvnAtv7eNxL4+WH4yTDgjwDePtEUsD4s1bkMVqkJFMS6FDu3lyx1fmxO5pQkFBhZJF+3Bf74xEASKrdFJgC/xiVoP/bvCqIIPsVhNM/wt0lED8f8OmCbNzj+A5ngbYLVyNgZWSvuU61oVwfIRxigC3sm4H6jn08wa+GQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191779; 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=SMshwY7iNroE9KHjRmndU4fpWnM0HeoNxchRExZSkZ0=; b=A6rx0mXevEigso8h2q1o8VXyupQfmSYkJ/xFj4jG23Dn+WB0bkI5HbmhKtvyrsqsAh+5pQJNRtoZGdRZUoDgrZY8vgOpvZQtVrv/0qnaUrMLvWpqujWlsZFMsR0oNCWCk+UJkpcBvLt3wbWWtjT073LTbhv0OcBoAZYTKgvZaqs= 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 17601917799201009.5199819576789; Sat, 11 Oct 2025 07:09:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7Q-0006B2-SE; Sat, 11 Oct 2025 09:58:44 -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 1v7a7O-0006A7-2z for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:42 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a76-0004hx-By for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:41 -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 63E4FC0117; Sat, 11 Oct 2025 16:58:03 +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-5Y5qp5w7; Sat, 11 Oct 2025 16:58:03 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191083; bh=SMshwY7iNroE9KHjRmndU4fpWnM0HeoNxchRExZSkZ0=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=pdVEqC+Tu82Tlda1ayTWBRtPeW8Krtfscsrr/XFbu6YlFk9mizbrHxGqRgoe68Lo1 4SG20771RQsfO8m3oUoq4FhVt5GaUVUldjIg2VzmiLH2DQv2cTH2MUKIQtnyukuLAm yuI/RopdI7Ed+4vF9id0mz5/QXMFhe3+q9S+goMw= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Paolo Bonzini Subject: [PATCH 07/33] qapi/char.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:53 +0300 Message-ID: <20251011135754.294521-13-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, T_SPF_HELO_TEMPERROR=0.01, T_SPF_TEMPERROR=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: 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: 1760191782906158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/char.json | 34 ++++++++++++++++++++++------------ 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/qapi/char.json b/qapi/char.json index f0a53f742c..52cca8da67 100644 --- a/qapi/char.json +++ b/qapi/char.json @@ -47,12 +47,14 @@ # "return": [ # { # "label": "charchannel0", -# "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.ag= ent,server=3Don", +# "filename": +# "unix:/.../seabios.rhel6.agent,server=3Don", # "frontend-open": false # }, # { # "label": "charmonitor", -# "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.mo= nitor,server=3Don", +# "filename": +# "unix:/.../seabios.rhel6.monitor,server=3Don", # "frontend-open": true # }, # { @@ -272,7 +274,8 @@ # @reconnect: For a client socket, if a socket is disconnected, then # attempt a reconnect after the given number of seconds. Setting # this to zero disables this function. The use of this member is -# deprecated, use @reconnect-ms instead. (default: 0) (Since: 2.2) +# deprecated, use @reconnect-ms instead. +# (default: 0) (Since: 2.2) # # @reconnect-ms: For a client socket, if a socket is disconnected, # then attempt a reconnect after the given number of milliseconds. @@ -776,22 +779,25 @@ # # -> { "execute" : "chardev-add", # "arguments" : { "id" : "foo", -# "backend" : { "type" : "null", "data" : {} } } } +# "backend" : { "type" : "null", +# "data" : {} } } } # <- { "return": {} } # # .. qmp-example:: # # -> { "execute" : "chardev-add", -# "arguments" : { "id" : "bar", -# "backend" : { "type" : "file", -# "data" : { "out" : "/tmp/bar.log"= } } } } +# "arguments" : { +# "id" : "bar", +# "backend" : { "type" : "file", +# "data" : { "out" : "/tmp/bar.log" } } } } # <- { "return": {} } # # .. qmp-example:: # # -> { "execute" : "chardev-add", # "arguments" : { "id" : "baz", -# "backend" : { "type" : "pty", "data" : {} } } } +# "backend" : { "type" : "pty", +# "data" : {} } } } # <- { "return": { "pty" : "/dev/pty/42" } } ## { 'command': 'chardev-add', @@ -814,7 +820,8 @@ # # -> { "execute" : "chardev-change", # "arguments" : { "id" : "baz", -# "backend" : { "type" : "pty", "data" : {} } } } +# "backend" : { "type" : "pty", +# "data" : {} } } } # <- { "return": { "pty" : "/dev/pty/42" } } # # .. qmp-example:: @@ -851,7 +858,8 @@ # # .. qmp-example:: # -# -> { "execute": "chardev-remove", "arguments": { "id" : "foo" } } +# -> { "execute": "chardev-remove", +# "arguments": { "id" : "foo" } } # <- { "return": {} } ## { 'command': 'chardev-remove', @@ -868,7 +876,8 @@ # # .. qmp-example:: # -# -> { "execute": "chardev-send-break", "arguments": { "id" : "foo" } } +# -> { "execute": "chardev-send-break", +# "arguments": { "id" : "foo" } } # <- { "return": {} } ## { 'command': 'chardev-send-break', @@ -891,7 +900,8 @@ # # <- { "event": "VSERPORT_CHANGE", # "data": { "id": "channel0", "open": true }, -# "timestamp": { "seconds": 1401385907, "microseconds": 422329 } } +# "timestamp": { "seconds": 1401385907, +# "microseconds": 422329 } } ## { 'event': 'VSERPORT_CHANGE', 'data': { 'id': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191204; cv=none; d=zohomail.com; s=zohoarc; b=UHuMoqImJ+2xoAzyiKwyFY4q8Rff0nNTH8fQ/ZbKCiv2bupALgTAT4jmfdIn+P9BTAvMIj3n5HM08IwBi9715n3c423NQSH9T33fX6ZEMdrOvyDV8iZu7rfbj4b5ZfhJfu41SaEjTtUuq4NHLJzsVORYyTqxCacdOK3thzPXqNI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191204; 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=rFXBB96E86A3fQSXCMSSZzegEJGUuPqsnG2ic46PLlc=; b=iIqC185Jhz0IpLOh7xtSXfFe5PjzQrFB7bZDyGIkZcPLUSIu2lZYs3IcdacQSnFGUvfbrY6SwTOACVtSnmKHkvWWjQlRDEjktvWjgBAfIOJvLgtYYIWSblWk2EvvHHRY4p3eHT1rxTlvdz38f6duf/47TWrHumUYqt2FthzqSKE= 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 17601912036605.295437733289191; Sat, 11 Oct 2025 07:00:03 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7J-00067L-V1; Sat, 11 Oct 2025 09:58:37 -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 1v7a7H-00066c-0u for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:35 -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 1v7a76-0004hw-BY for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:34 -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 51F3CC013E; Sat, 11 Oct 2025 16:58:04 +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-C2SkLvZw; Sat, 11 Oct 2025 16:58:04 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191084; bh=rFXBB96E86A3fQSXCMSSZzegEJGUuPqsnG2ic46PLlc=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=XHSPSoYIppfS4HurSlGNQs4jleTYlhbYRWKTY0d4bVKp7myGfPVJdFpC/p3xBBhHv 7IeZ3shLA8PksJfxu1njJjBKRIaHp24J78rc6NyEoJc3x997cuIXF7pjuliq14Phco kCw8aKJ5/i+YplUPTSaT9Ml4YhPgWx5wEhSj71Cs= 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, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH 08/33] qapi/crypto.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:55 +0300 Message-ID: <20251011135754.294521-15-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191211206154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/crypto.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/qapi/crypto.json b/qapi/crypto.json index ab6eda4c2f..72ac718147 100644 --- a/qapi/crypto.json +++ b/qapi/crypto.json @@ -46,7 +46,8 @@ # # @md5: MD5. Should not be used in any new code, legacy compat only # -# @sha1: SHA-1. Should not be used in any new code, legacy compat only +# @sha1: SHA-1. Should not be used in any new code, legacy compat +# only # # @sha224: SHA-224. (since 2.7) # @@ -377,8 +378,8 @@ # deactivate all keyslots that match password located in # QCryptoSecret with this ID # -# @iter-time: Optional (for activation only). Number of milliseconds to -# spend in PBKDF passphrase processing for the newly activated +# @iter-time: Optional (for activation only). Number of milliseconds +# to spend in PBKDF passphrase processing for the newly activated # keyslot. Currently defaults to 2000. # # @keyslot: Optional. ID of the keyslot to activate/deactivate. For --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191650; cv=none; d=zohomail.com; s=zohoarc; b=XhumIfgzKOAnPbKZ9oPwhNHHCT1wnzFMhttzgIKmF44ucRrXpSHGFrtfpCmknhsVBpFL+mut1nIpQubE2PI1mwz0jDW5FctYS5Hk79T07dTFl6zdOiP1kBGCWAoMxwunuSVsteRvn5Gl/TZ/N1OoYuGCTYi7N/VWiKRidy/RJCQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191650; 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=rFXBB96E86A3fQSXCMSSZzegEJGUuPqsnG2ic46PLlc=; b=koEo/OWO4fvl6JvgXkclvvFFVXBs7SnamiD++o+xrhgdUaFn/KndvzdIO4644AB+rFsWGE9sgA4c8+llH/VeLQaFkAhL7QKw/mo1ccnZhdwmU+xrG3HrPuXgeUDga+Fk8mEycDkuK7TpAMij4DEgnX9lkbAZfw7gK4St01X2CTk= 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 1760191650918208.42692150266112; Sat, 11 Oct 2025 07:07:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7T-0006Ce-VU; Sat, 11 Oct 2025 09:58:48 -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 1v7a7P-0006AB-7T for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:43 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a77-0004i4-OO for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:41 -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 B3633C013F; Sat, 11 Oct 2025 16:58:04 +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-uxZdfCGt; Sat, 11 Oct 2025 16:58:04 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191084; bh=rFXBB96E86A3fQSXCMSSZzegEJGUuPqsnG2ic46PLlc=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=Zd221rI53NXaRYPJk3w5twC941H9ZMD0mDi/E/8h7ZYambYx4XYsDAtcQdrg+AAMO wFxKZv2ZqJEU1aFqP7/VpuyWeWPZjfKna7PBcNw+jEHFtlqjQU9gb6uQBoamsPSUQD POxwPb1GNkULlkA9U6/VhImPiPPZcwTtG/g2iXNY= 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, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH 08/33] qapi/crypto.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:56 +0300 Message-ID: <20251011135754.294521-16-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191652802154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/crypto.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/qapi/crypto.json b/qapi/crypto.json index ab6eda4c2f..72ac718147 100644 --- a/qapi/crypto.json +++ b/qapi/crypto.json @@ -46,7 +46,8 @@ # # @md5: MD5. Should not be used in any new code, legacy compat only # -# @sha1: SHA-1. Should not be used in any new code, legacy compat only +# @sha1: SHA-1. Should not be used in any new code, legacy compat +# only # # @sha224: SHA-224. (since 2.7) # @@ -377,8 +378,8 @@ # deactivate all keyslots that match password located in # QCryptoSecret with this ID # -# @iter-time: Optional (for activation only). Number of milliseconds to -# spend in PBKDF passphrase processing for the newly activated +# @iter-time: Optional (for activation only). Number of milliseconds +# to spend in PBKDF passphrase processing for the newly activated # keyslot. Currently defaults to 2000. # # @keyslot: Optional. ID of the keyslot to activate/deactivate. For --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191968; cv=none; d=zohomail.com; s=zohoarc; b=NUNsdEtT538H8XcziZxtSilsE9IY60bxKq706to8INAgP7X960bqovNtfO5p2D4P3tI2L8kwWZXCNO5jrT9e7U4cyYNDb9lKijPrilpxZPRixhrNwzuUcNilN54yI1y6hDG2FfDLI00OL61W0SpNICd0TTmZPHmdP1BSsBCyK3I= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191968; 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=f2E8t138+1ErXT8tRAi99mF/Qqtq/L1b5hlUxr3dG8M=; b=J0K/UM5v7rQFx+aPddaWPU+bb2xPRHcfhtvpc79MFFv/0Sl4TC55aNdPnHNuZuHI53P31guVPuISvI+mt3FwGdH2D6qRborbfM+8KjFmBTCy+ZjS0GAHBNUq7vyYSI2xRQXIBbn0a9NoX8aC4DUfen9jqAmALiqzVqydozKFF14= 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 1760191968374896.3440113224403; Sat, 11 Oct 2025 07:12:48 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7T-0006DK-0H; Sat, 11 Oct 2025 09:58:47 -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 1v7a7I-00067N-Sn for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:37 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a77-0004i3-Bz for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:36 -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 97BB9C014C; Sat, 11 Oct 2025 16:58:05 +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-7mZjzXeI; Sat, 11 Oct 2025 16:58:05 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191085; bh=f2E8t138+1ErXT8tRAi99mF/Qqtq/L1b5hlUxr3dG8M=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=RwEwdKXbgKJVmZdiv6D81BmQjS0HYlvNndRmOAfXHTozQtKlY1DeML8qnBGesN+v3 sK6KwDy0A2DzspyZjm8XMkkSl5WkE0mfNab3GIoBx6J95ulXrL9X6h2fki0PnM3PsQ CzOXp5YO+dqk1YxGazwjMZ/QKS3kih/HeHtxXkzE= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Ani Sinha Subject: [PATCH 09/33] qapi/dump.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:58 +0300 Message-ID: <20251011135754.294521-18-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760191969177158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/dump.json | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/qapi/dump.json b/qapi/dump.json index 726b520870..96265cd925 100644 --- a/qapi/dump.json +++ b/qapi/dump.json @@ -176,9 +176,11 @@ # .. qmp-example:: # # <- { "event": "DUMP_COMPLETED", -# "data": { "result": { "total": 1090650112, "status": "completed= ", +# "data": { "result": { "total": 1090650112, +# "status": "completed", # "completed": 1090650112 } }, -# "timestamp": { "seconds": 1648244171, "microseconds": 950316 } } +# "timestamp": { "seconds": 1648244171, +# "microseconds": 950316 } } ## { 'event': 'DUMP_COMPLETED' , 'data': { 'result': 'DumpQueryResult', '*error': 'str' } } @@ -207,7 +209,8 @@ # # -> { "execute": "query-dump-guest-memory-capability" } # <- { "return": { "formats": -# ["elf", "kdump-zlib", "kdump-lzo", "kdump-snappy"] = } } +# [ "elf", "kdump-zlib", "kdump-lzo", +# "kdump-snappy" ] } } ## { 'command': 'query-dump-guest-memory-capability', 'returns': 'DumpGuestMemoryCapability' } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191590; cv=none; d=zohomail.com; s=zohoarc; b=Nx46qWep8v8vtybRCcbg8IMJeOkygCq5/KTN+JOQTKHxcabC8gCtmbUTUhnGS4svRwExnSoeKCyxVMMtdGmUcgEaivAS3bwnF8pXBBEKFQLaeCTGB8ZM3AhN5nAWnFgVVz8QFZCamiMxeAE5Cl1IiC9voU2oB3YMZfvDZ9F7uik= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191590; 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=f2E8t138+1ErXT8tRAi99mF/Qqtq/L1b5hlUxr3dG8M=; b=VYgo19kwt3HjbMmEVS9gveuhSeS/hTYbf7MELZ6CankIqNG6J2tEFNytwdo7eFXFWB9k3HFkTM61t3coFB+Melv+dG7q9im+hvI9pDE8irUULArXiFK2A7jMc+xEwth/gOSr3XutPaP+aES+CKAnGfIzGtHZEQQbxqZm2b76cQc= 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 1760191590761401.85596888465864; Sat, 11 Oct 2025 07:06:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7G-00066L-9o; Sat, 11 Oct 2025 09:58:34 -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 1v7a7D-00065l-6J for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:32 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a76-0004i0-NY for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:30 -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 2AD71C0140; Sat, 11 Oct 2025 16:58:05 +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-g492KjEG; Sat, 11 Oct 2025 16:58:04 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191084; bh=f2E8t138+1ErXT8tRAi99mF/Qqtq/L1b5hlUxr3dG8M=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=U7Tf2dsflx35KN2MQrSxM7MVPmFNBzN2eYh81cd1freCurSVVDFX4SVZDPsqh+VMM PSMC+wIWaPr0zuJTVALlY9LKY2xHnltUUEppHFffKNguq3dcxcVMiYZlKAjv8NjJ3M bkVXfGTFos9AFtsalDD5cpX94Ahu5aEJDpssNKoY= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Ani Sinha Subject: [PATCH 09/33] qapi/dump.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:57 +0300 Message-ID: <20251011135754.294521-17-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191592067154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/dump.json | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/qapi/dump.json b/qapi/dump.json index 726b520870..96265cd925 100644 --- a/qapi/dump.json +++ b/qapi/dump.json @@ -176,9 +176,11 @@ # .. qmp-example:: # # <- { "event": "DUMP_COMPLETED", -# "data": { "result": { "total": 1090650112, "status": "completed= ", +# "data": { "result": { "total": 1090650112, +# "status": "completed", # "completed": 1090650112 } }, -# "timestamp": { "seconds": 1648244171, "microseconds": 950316 } } +# "timestamp": { "seconds": 1648244171, +# "microseconds": 950316 } } ## { 'event': 'DUMP_COMPLETED' , 'data': { 'result': 'DumpQueryResult', '*error': 'str' } } @@ -207,7 +209,8 @@ # # -> { "execute": "query-dump-guest-memory-capability" } # <- { "return": { "formats": -# ["elf", "kdump-zlib", "kdump-lzo", "kdump-snappy"] = } } +# [ "elf", "kdump-zlib", "kdump-lzo", +# "kdump-snappy" ] } } ## { 'command': 'query-dump-guest-memory-capability', 'returns': 'DumpGuestMemoryCapability' } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191278; cv=none; d=zohomail.com; s=zohoarc; b=aI7P0fEEb4J72elTrlSr1NXn8obTVr+nwsw2TEWdeIr9IG5lgo1SPHjn8sN4BilZy+MB0N0bjQ12qdilmWJkKOIqfKx+p6SaMTDZ1b7BLG06TyUSeh65759oczbskinfxNQeGG580BieMP1kiU1Bz8M8jwbeUFDRr5PVBohVqg0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191278; 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=1uUca7a6+MkNXsTvw98aS79VCYXTlBA27mbsctANXQw=; b=XqAfHw72f3z7fFZjr59uUn1POi83EmvsalWojpTsFdTG07X102cpWG3H62ea9iYCzONxuElPXuEqteO7XNjsXTnPgq/Dn7MitsIASAlkB2gFirm3DPPxOKwFNRt3jvKuCylT4jpkCIjCpJW7iPQneA/bYalJ9zRI+YUizadXa5Q= 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 1760191278846171.5938435485191; Sat, 11 Oct 2025 07:01:18 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7b-0006G2-VN; Sat, 11 Oct 2025 09:58:56 -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-0006FJ-AQ 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 1v7a7K-0004i5-HB for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:50 -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 5ABF9C0161; Sat, 11 Oct 2025 16:58:06 +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-qThKcBPY; Sat, 11 Oct 2025 16:58:06 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191086; bh=1uUca7a6+MkNXsTvw98aS79VCYXTlBA27mbsctANXQw=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=mCbvyaBQjBSP0o4mA91k8vgXaOw8M0cmUGAiDgEtSE4VmCjbsrNg+BOdHNrrJX6+k mfsMROrSyYc0NRHzzBOVfV+NHyp18vrD33kKDhNjvAZkGnSjV25vVNGfXdYKLeNwWG GxtDnr2h/elWEZHwjhB2i/cLVSByl9Q5bQ502n20= 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 Subject: [PATCH 10/33] qapi/introspect.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:00 +0300 Message-ID: <20251011135754.294521-20-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: -23 X-Spam_score: -2.4 X-Spam_bar: -- X-Spam_report: (-2.4 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191283701158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/introspect.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/qapi/introspect.json b/qapi/introspect.json index 53100714a8..c8432c8ed8 100644 --- a/qapi/introspect.json +++ b/qapi/introspect.json @@ -22,10 +22,10 @@ # `SchemaInfo`. This lets QMP clients figure out what commands and # events are available in this QEMU, and their parameters and results. # -# However, the `SchemaInfo` can't reflect all the rules and restrictions -# that apply to QMP. It's interface introspection (figuring out -# what's there), not interface specification. The specification is in -# the QAPI schema. +# However, the `SchemaInfo` can't reflect all the rules and +# restrictions that apply to QMP. It's interface introspection +# (figuring out what's there), not interface specification. The +# specification is in the QAPI schema. # # Furthermore, while we strive to keep the QMP wire format # backwards-compatible across QEMU versions, the introspection output --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191762; cv=none; d=zohomail.com; s=zohoarc; b=PNcIURPTY1GD2zvooOh+ZbK8EU0rI0BAZVCfiDeV1PmEdraeI/oBg8r93x22+URuWfhtfLH2dMDqG/G0GTpUpOqw3zcgKGFscUZFXqwsPjCpZu3FawyHvwcoZxdWJch3Jh2ErllZS5d0oASS4rSi1y4XwMJJtZuUhFBf6atyZ0Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191762; 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=1uUca7a6+MkNXsTvw98aS79VCYXTlBA27mbsctANXQw=; b=jhMjL1zjroQ+evPmrabJbYwiUjvKY2nvXPNvvogWo+YgszLFedthPQ7a3glos8eNwKNNSGJdUzUySwKtZiWRGD8W55i5LiBjShWNH0aZVKKRDu1GvvhNCCSa8V/kad4c7e4/OTkoG/mvGcYPlPTlwFPhKObT9myAu9I88HqXkhU= 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 1760191762409483.83625479601926; Sat, 11 Oct 2025 07:09:22 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7U-0006E8-6N; Sat, 11 Oct 2025 09:58:48 -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 1v7a7K-00067w-Vd for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:39 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a77-0004i8-KG for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:36 -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 00A3AC0150; Sat, 11 Oct 2025 16:58:06 +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-pZJw0ZO2; Sat, 11 Oct 2025 16:58:05 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191085; bh=1uUca7a6+MkNXsTvw98aS79VCYXTlBA27mbsctANXQw=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=ghfqPefw+C9Ck8roNWU7TlC8OkkXx3ewZi05pdgLZ/1jo0mnuaT1Y+7qt6L0Y5ft9 supR+riU1JWQyeHKOxGt9c4SLbgniN4xHy2ZhfZgjV4FwIYd/FlQ1ep7jrQcp5wOTe BXEy/QZojZ4l6NjbSrz5SbER0umowexZX7T15p98= 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 Subject: [PATCH 10/33] qapi/introspect.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:56:59 +0300 Message-ID: <20251011135754.294521-19-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191764707158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/introspect.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/qapi/introspect.json b/qapi/introspect.json index 53100714a8..c8432c8ed8 100644 --- a/qapi/introspect.json +++ b/qapi/introspect.json @@ -22,10 +22,10 @@ # `SchemaInfo`. This lets QMP clients figure out what commands and # events are available in this QEMU, and their parameters and results. # -# However, the `SchemaInfo` can't reflect all the rules and restrictions -# that apply to QMP. It's interface introspection (figuring out -# what's there), not interface specification. The specification is in -# the QAPI schema. +# However, the `SchemaInfo` can't reflect all the rules and +# restrictions that apply to QMP. It's interface introspection +# (figuring out what's there), not interface specification. The +# specification is in the QAPI schema. # # Furthermore, while we strive to keep the QMP wire format # backwards-compatible across QEMU versions, the introspection output --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192178; cv=none; d=zohomail.com; s=zohoarc; b=BJp/SQWXZ160h5bvHIPhj7WkYXev76OBQBdAs/tmB36BEIQkAfJ6hosvp4MlsqIGiZmAtOC3y1KiUbEFUDZo9r7dXnhVYImQ0AIz9phGTtYM8tc8ovXyAynwhGhRq1YEsB3h73y5uogqFWIilGUMYN+X2EVTxs6psKZtCIrffA4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192178; 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=wx/I6VtVDwoWBi0b5ijZlX7Un2UFdYPB/5MJo7VWM0k=; b=JosQKdQ6N4kklomnHic/rKXsGvbVPWg3LnFFYI3/Q4CjVUWICGcwU9Aa7sTrxOMWVtubpAOBwtMmisbp+H0ba9wzxMb/ThHx+2Ir+JF9P8l/k6wIm4MtrUbxxUwFzd7NuN1xLNmdZJNTZuloOY371+L7CRCa4kBZuKBkpamu+k4= 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 1760192178825346.3960046626645; Sat, 11 Oct 2025 07:16:18 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7S-0006BV-53; Sat, 11 Oct 2025 09:58:46 -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 1v7a7I-00067M-Rw; Sat, 11 Oct 2025 09:58:36 -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 1v7a78-0004iL-1K; Sat, 11 Oct 2025 09:58:36 -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 D61CCC0162; Sat, 11 Oct 2025 16:58:06 +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-MeDTcm6s; Sat, 11 Oct 2025 16:58:06 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191086; bh=wx/I6VtVDwoWBi0b5ijZlX7Un2UFdYPB/5MJo7VWM0k=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=Tu0OpRsewlekNojtLqweBGFSqWM6RM87GVLW+IEROwtjKh5YBbShd+t7gv2ST78qz PWKzovmSL3om+ON2nQufgGmOYJY3b7da2qmuYyAE7tyFkpcmA0+y/1hVo4uuk4vQAf GCincEiaHQ0fCQ6oiOXkCJA/8w+pO7zKg/nSvQcc= 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, John Snow , qemu-block@nongnu.org (open list:Block Jobs) Subject: [PATCH 11/33] qapi/job.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:01 +0300 Message-ID: <20251011135754.294521-21-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192181759158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/job.json | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/qapi/job.json b/qapi/job.json index 8b08350af2..887777b973 100644 --- a/qapi/job.json +++ b/qapi/job.json @@ -194,16 +194,16 @@ # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive -# mirroring includes `drive-mirror`, `blockdev-mirror` and `block-commit` -# job (only in case of "active commit", when the node being commited -# is used by the guest). The ability to complete is signaled with a -# `BLOCK_JOB_READY` event. +# mirroring includes `drive-mirror`, `blockdev-mirror` and +# `block-commit` job (only in case of "active commit", when the node +# being commited is used by the guest). The ability to complete is +# signaled with a `BLOCK_JOB_READY` event. # # This command completes an active background block operation # synchronously. The ordering of this command's return with the -# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O error -# occurs during the processing of this command: 1) the command itself -# will fail; 2) the error will be processed according to the +# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O +# error occurs during the processing of this command: 1) the command +# itself will fail; 2) the error will be processed according to the # rerror/werror arguments that were specified when starting the # operation. # @@ -220,14 +220,14 @@ # needs to be run explicitly for jobs that don't have automatic # dismiss enabled. In turn, automatic dismiss may be enabled only # for jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` and -# `block-stream`. @auto-dismiss is enabled by default for these +# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` +# and `block-stream`. @auto-dismiss is enabled by default for these # jobs. # # This command will refuse to operate on any job that has not yet # reached its terminal state, CONCLUDED. For jobs that make use of -# the JOB_READY event, `job-cancel` or `job-complete` will still need to -# be used as appropriate. +# the JOB_READY event, `job-cancel` or `job-complete` will still need +# to be used as appropriate. # # @id: The job identifier. # @@ -247,8 +247,8 @@ # force ALL jobs in the transaction to finalize, so it is only # necessary to instruct a single member job to finalize. # -# The command is applicable only to jobs which have @auto-finalize option -# and only when this option is set to false. +# The command is applicable only to jobs which have @auto-finalize +# option and only when this option is set to false. # # @id: The identifier of any job in the transaction, or of a job that # is not part of any transaction. --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192837; cv=none; d=zohomail.com; s=zohoarc; b=MGb9xnmq5RmQluC4ENrAWCk76lA3iJA+Ub4XoZFgBzmftPDkRv12iGUqgBCYn2LRY9nuwKRTXfs3rUdY3+gxn63mI7FEZMdKfs6QQAh4sZjR5BgErrGK8BPFbDujHqW7Cg6QT+E8LE7twoIzhMGHv2zqXY9VjSreAMaRRsog1To= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192837; 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=wx/I6VtVDwoWBi0b5ijZlX7Un2UFdYPB/5MJo7VWM0k=; b=eGaION2rt5S8kaFrgH36QjWj70MYIPy7VtO9uUMBwhjoJatVWrw4SabqcdnxQiGJ1gHR2i/3vxC4htAhY3ZiBPzDjhLqmw3dCvE3bmBTeJeWQ5eA8PH5LdK3/sWOHOZIEN42rqIURRE6T0pYgmyhNYp5QNBVp38dL1C+0BsAbHs= 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 1760192837408893.5814717644355; Sat, 11 Oct 2025 07:27:17 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7O-0006AZ-EE; Sat, 11 Oct 2025 09:58:42 -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 1v7a7M-00069C-CS; Sat, 11 Oct 2025 09:58:40 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a78-0004iM-Kc; Sat, 11 Oct 2025 09:58:38 -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 5B7C6C0163; Sat, 11 Oct 2025 16:58:07 +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-UqexzGof; Sat, 11 Oct 2025 16:58:07 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191087; bh=wx/I6VtVDwoWBi0b5ijZlX7Un2UFdYPB/5MJo7VWM0k=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=0JmlY/nr2yPX91cmGGkAThtzao15Z1C8N7lZW3dTQstJcVzvFAbCLGESFr2v8W1t4 qutDW/TEGi91WXg+vyt6rLJjZTxKpDL4AQWV7UlG24fM661FcZbwp29LR2Hlbbsz2p S2Yi9sYIXFcMkd9xGSlQUlaqTR6AMW3yt8xznWhI= 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, John Snow , qemu-block@nongnu.org (open list:Block Jobs) Subject: [PATCH 11/33] qapi/job.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:02 +0300 Message-ID: <20251011135754.294521-22-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192838770154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/job.json | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/qapi/job.json b/qapi/job.json index 8b08350af2..887777b973 100644 --- a/qapi/job.json +++ b/qapi/job.json @@ -194,16 +194,16 @@ # # This is supported only for drive mirroring, where it also switches # the device to write to the target path only. Note that drive -# mirroring includes `drive-mirror`, `blockdev-mirror` and `block-commit` -# job (only in case of "active commit", when the node being commited -# is used by the guest). The ability to complete is signaled with a -# `BLOCK_JOB_READY` event. +# mirroring includes `drive-mirror`, `blockdev-mirror` and +# `block-commit` job (only in case of "active commit", when the node +# being commited is used by the guest). The ability to complete is +# signaled with a `BLOCK_JOB_READY` event. # # This command completes an active background block operation # synchronously. The ordering of this command's return with the -# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O error -# occurs during the processing of this command: 1) the command itself -# will fail; 2) the error will be processed according to the +# `BLOCK_JOB_COMPLETED` event is not defined. Note that if an I/O +# error occurs during the processing of this command: 1) the command +# itself will fail; 2) the error will be processed according to the # rerror/werror arguments that were specified when starting the # operation. # @@ -220,14 +220,14 @@ # needs to be run explicitly for jobs that don't have automatic # dismiss enabled. In turn, automatic dismiss may be enabled only # for jobs that have @auto-dismiss option, which are `drive-backup`, -# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` and -# `block-stream`. @auto-dismiss is enabled by default for these +# `blockdev-backup`, `drive-mirror`, `blockdev-mirror`, `block-commit` +# and `block-stream`. @auto-dismiss is enabled by default for these # jobs. # # This command will refuse to operate on any job that has not yet # reached its terminal state, CONCLUDED. For jobs that make use of -# the JOB_READY event, `job-cancel` or `job-complete` will still need to -# be used as appropriate. +# the JOB_READY event, `job-cancel` or `job-complete` will still need +# to be used as appropriate. # # @id: The job identifier. # @@ -247,8 +247,8 @@ # force ALL jobs in the transaction to finalize, so it is only # necessary to instruct a single member job to finalize. # -# The command is applicable only to jobs which have @auto-finalize option -# and only when this option is set to false. +# The command is applicable only to jobs which have @auto-finalize +# option and only when this option is set to false. # # @id: The identifier of any job in the transaction, or of a job that # is not part of any transaction. --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191934; cv=none; d=zohomail.com; s=zohoarc; b=A/Yx01e0bNGHNBp2LrBacyGIJE4744SK4goY/Lv5spexoe6rGbGX5BlOyVtD2YMwykYlMyqpOn7iBVlXZIWVLp1yd+PqgO3FakehG+FqOCTbkKZhPDvdlUx0bgb1pzOt8JMd+ekXElEDK4vdzEtWOTePnCWMjR+7u21ke2wuhrA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191934; 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=gKfac8l+k6HXx+GuiQXKB7Cy06ACRmzu41QCBlDfSCA=; b=TEX0VZhTsKGtLKI6ozWmFfEHQfErl+iwvURpXwf/N6l1UaQPy8Zoo/9HjOEBgI8aaYMm7bGOa0o6axjaq4E1FXHe/RxHo1PDjTH8dMEqurdz6E4UPMp1hA5wraWvXnH606GaZ3f1ddGddE2K+FgdZGr0oMJBdKaE0U/nWuV2Okw= 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 1760191934388363.66915362485804; Sat, 11 Oct 2025 07:12:14 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8l-0006fW-B9; Sat, 11 Oct 2025 10:00:09 -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 1v7a7u-0006JK-4Y; Sat, 11 Oct 2025 09:59:14 -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 1v7a7Z-0004iX-2c; Sat, 11 Oct 2025 09:59:12 -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 40B3BC0167; Sat, 11 Oct 2025 16:58:08 +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-4nzf6pYE; Sat, 11 Oct 2025 16:58:07 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191087; bh=gKfac8l+k6HXx+GuiQXKB7Cy06ACRmzu41QCBlDfSCA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=tC/MNK++q9GqK0vAJbmKNH07h6KXi+il7mpykVo1HI37kzOIMFEkL5AgF8vDiJW/B jfpVjyF38KdDgMuJM+NuMRNOyEZlhKDAhSNZDepNQg37ggpUhemKfU9g35H2w5JU9m Y1pXGgf1P3Tfmh8Ikw5/gzhtllGRmQCKqvpTatTg= 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, Thomas Huth , qemu-s390x@nongnu.org (open list:S390 general arch...) Subject: [PATCH 12/33] qapi/machine-s390x.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:04 +0300 Message-ID: <20251011135754.294521-24-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191936796158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/machine-s390x.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index 966dbd61d2..f8ddc0ff8a 100644 --- a/qapi/machine-s390x.json +++ b/qapi/machine-s390x.json @@ -85,7 +85,8 @@ # # <- { "event": "CPU_POLARIZATION_CHANGE", # "data": { "polarization": "horizontal" }, -# "timestamp": { "seconds": 1401385907, "microseconds": 422329 } } +# "timestamp": { "seconds": 1401385907, +# "microseconds": 422329 } } ## { 'event': 'CPU_POLARIZATION_CHANGE', 'data': { 'polarization': 'S390CpuPolarization' }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191943; cv=none; d=zohomail.com; s=zohoarc; b=akKsrX+fQAGXt3KYMi7fl44oGSHOUZyZF5NCbYZ4K7Ggn17+lUuHlPUBPKG2jiiJn9+pmTmMgL3nl11kZ8Z+nY97biDDqekA69GLTdWO4suzsbkwYfi079a41o9ldK3EYZfJH83hJdHFNyn6tl82/z7TEy5xgfVweVB9xcgZ8AY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191943; 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=gKfac8l+k6HXx+GuiQXKB7Cy06ACRmzu41QCBlDfSCA=; b=MuuwyGDO1rY8NXRnv36U9PnKOi5TPUHD14T/qgzx3cB61wFuDzuTkM1XoCkKRLXlT6tVyBS5fm1J5iejV4RzAhen7LDkrCtIxsrGJ/6JE/WBx4LOpjY5SRt+euRLKPGIlcQZALBy0gdej/mlipli+F5W5Cl1g2UX3OQIFgXoGKs= 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 1760191943038187.07239866152497; Sat, 11 Oct 2025 07:12:23 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7V-0006E6-3S; Sat, 11 Oct 2025 09:58:49 -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 1v7a7S-0006Cv-Ch; Sat, 11 Oct 2025 09:58:46 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7D-0004iY-L6; Sat, 11 Oct 2025 09:58:45 -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 CA515C0166; Sat, 11 Oct 2025 16:58:07 +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-gzisR4Gs; Sat, 11 Oct 2025 16:58:07 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191087; bh=gKfac8l+k6HXx+GuiQXKB7Cy06ACRmzu41QCBlDfSCA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=BlQjMkX6KEY4kjqc6cCByIY8eAgUKFludFiajwzSEg9V+065lTn7XZc/hoxx/L4Ir oSJmqsh0DAaunH6S+KmshD5UgVWUpg+h224/a5xxkb4RqOBlzV5PWBeALY4pH2JJLf wzbG8R2H7I9Cmjaaiz31aXsUU4vTS/CvV/mk4rug= 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, Thomas Huth , qemu-s390x@nongnu.org (open list:S390 general arch...) Subject: [PATCH 12/33] qapi/machine-s390x.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:03 +0300 Message-ID: <20251011135754.294521-23-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760191948828158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/machine-s390x.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index 966dbd61d2..f8ddc0ff8a 100644 --- a/qapi/machine-s390x.json +++ b/qapi/machine-s390x.json @@ -85,7 +85,8 @@ # # <- { "event": "CPU_POLARIZATION_CHANGE", # "data": { "polarization": "horizontal" }, -# "timestamp": { "seconds": 1401385907, "microseconds": 422329 } } +# "timestamp": { "seconds": 1401385907, +# "microseconds": 422329 } } ## { 'event': 'CPU_POLARIZATION_CHANGE', 'data': { 'polarization': 'S390CpuPolarization' }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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 From nobody Fri Nov 14 18:23:26 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=1760192506; cv=none; d=zohomail.com; s=zohoarc; b=PGPPojxxK0PydIBYzs59uUeM0SSg9AHPbFz3vlKw+WG9sNRhckizcwmeztRlQ1mwZFoAUiVd2Ua5YI2ISn9BFL8AwRxLM/Lu/Wrp2uxRJrhwHZDU3WbTtPKuy7c6NbEpFtPQZp4qOJ2xgETAxncTZa7yffta113nmscgu+omLdE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192506; 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=Z2DQC2R2YNTIV5Mrx8BccylAdXhAY9b746GGTm0x4rv5zvDLF4LqhBWAbieaWCFANRZsNXwuiWArkOlhYB03QktcEen06lXudWYd+PC9aKmzoOQ+c2zVb/G82BYupVcpHM1LOFScoskpaOZEnYz21AfE/Qh23d4+d5+Etzarouc= 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 1760192506846985.7931588101097; Sat, 11 Oct 2025 07:21:46 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a81-0006KM-EM; Sat, 11 Oct 2025 09:59:22 -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 1v7a7d-0006GC-4X for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:57 -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 1v7a7K-0004ir-HB for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:55 -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 013F4C0170; Sat, 11 Oct 2025 16:58:10 +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-HLK3ykEO; Sat, 11 Oct 2025 16:58:09 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191089; bh=h6Ea4/j5Ei56p6QrRogXcVDfqdofZLzefU6CuONpdcs=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=hfI4Yqj6uPxnjoM2W1CqMPBprJEig9XVMFEUJNU54Etb/4xl0m+QAbq70GG+IKTbz vfggZ7mUdynsDyDj7K4YQR6IdxGtwanLRV2HW4Orn6ugitapQZxty5o78EpT8GmQY3 0qv7hV/ZEMYcgfyMGk9hknwwFYkYQbCjJlVa2qno= 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: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:06 +0300 Message-ID: <20251011135754.294521-26-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192507639158500 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 From nobody Fri Nov 14 18:23:26 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=1760192476; cv=none; d=zohomail.com; s=zohoarc; b=EMnd0wXCDGIiOibMpHHq8MGiBVQOWv53KG6ozp1RiBPZBL8RlqPBi/YyrzIX38x85PDwm1WAeFGBycG+rY6Wf21GEkBQOYUy6L+Th6hGPAaLq0WYGLdcvTNYt2qM0t2sVJZa3GxP8iysvyh5qkcMBWB9kcTPLyDg3CwvTI3qk2Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192476; 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=Rud6N/8EOaRmexXfDpe6yvJ3eRpDftouptgpBJ3O2Yg=; b=adxYL19SuDcXQCryAPv86e3dqgIsNYKv2ktXC/r3ri6gOpZTwMBrztE07hmad3/dNUAzEoWuZni0VOKJssGI/JWyNS1iuBwZsRp/3pgbUN4n2gNf1Z3iby6iTIPMQ/Umn7r0WOOlnn+Lj73TqhrVz3TeGm7/Tctf/QvzfNtD1nk= 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 1760192476370393.47780122243125; Sat, 11 Oct 2025 07:21:16 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7X-0006Ey-3y; Sat, 11 Oct 2025 09:58:51 -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 1v7a7S-0006D8-H1 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:46 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7E-0004jm-W4 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:46 -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 15100C0172; Sat, 11 Oct 2025 16:58:12 +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-7NspYFyh; Sat, 11 Oct 2025 16:58:11 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191091; bh=Rud6N/8EOaRmexXfDpe6yvJ3eRpDftouptgpBJ3O2Yg=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=jHONAfMYPQOtG/er6Sna1Os8NOLp3Z+c8gXESJLBoh5bZdxszlPdHfp04tM9kkwbR JOSu4lWgvSDCJZx/mxJL49TtDTx4hHjDiiPf7NwIBpuL0oBE3eGu0oxN20geVTNEqk sIe1dUTqrsWvKroA/I2pWBbhK7fTX3kIAz9xcsh4= 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, Peter Xu , Fabiano Rosas Subject: [PATCH 14/33] qapi/migration.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:08 +0300 Message-ID: <20251011135754.294521-28-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760192478493154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/migration.json | 209 ++++++++++++++++++++++++++------------------ 1 file changed, 124 insertions(+), 85 deletions(-) diff --git a/qapi/migration.json b/qapi/migration.json index be0f3fcc12..74b9db1a51 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -160,11 +160,11 @@ # # @pre-switchover: Paused before device serialisation. (since 2.11) # -# @device: During device serialisation (also known as switchover phase). -# Before 9.2, this is only used when (1) in precopy, and (2) when -# pre-switchover capability is enabled. After 10.0, this state will -# always be present for every migration procedure as the switchover -# phase. (since 2.11) +# @device: During device serialisation (also known as switchover +# phase). Before 9.2, this is only used when (1) in precopy, and +# (2) when pre-switchover capability is enabled. After 10.0, this +# state will always be present for every migration procedure as +# the switchover phase. (since 2.11) # # @wait-unplug: wait for device unplug request by guest OS to be # completed. (since 4.2) @@ -238,30 +238,33 @@ # This is only present when the postcopy-blocktime migration # capability is enabled. (Since 3.0) # -# @postcopy-latency: average remote page fault latency (in ns). Note that -# this doesn't include all faults, but only the ones that require a -# remote page request. So it should be always bigger than the real -# average page fault latency. This is only present when the -# postcopy-blocktime migration capability is enabled. (Since 10.1) -# -# @postcopy-latency-dist: remote page fault latency distributions. Each -# element of the array is the number of faults that fall into the -# bucket period. For the N-th bucket (N>=3D0), the latency window is -# [2^Nus, 2^(N+1)us). For example, the 8th element stores how many -# remote faults got resolved within [256us, 512us) window. This is only -# present when the postcopy-blocktime migration capability is enabled. +# @postcopy-latency: average remote page fault latency (in ns). +# Note that this doesn't include all faults, but only the ones +# that require a remote page request. So it should be always +# bigger than the real average page fault latency. This is only +# present when the postcopy-blocktime migration capability is +# enabled. (Since 10.1) +# +# @postcopy-latency-dist: remote page fault latency distributions. +# Each element of the array is the number of faults that fall into +# the bucket period. For the N-th bucket (N>=3D0), the latency +# window is [2^Nus, 2^(N+1)us). For example, the 8th element +# stores how many remote faults got resolved within [256us, 512us) +# window. This is only present when the postcopy-blocktime +# migration capability is enabled. (Since 10.1) +# +# @postcopy-vcpu-latency: average remote page fault latency per vCPU +# (in ns). It has the same definition of @postcopy-latency, but +# instead this is the per-vCPU statistics. This is only present +# when the postcopy-blocktime migration capability is enabled. # (Since 10.1) # -# @postcopy-vcpu-latency: average remote page fault latency per vCPU (in -# ns). It has the same definition of @postcopy-latency, but instead -# this is the per-vCPU statistics. This is only present when the -# postcopy-blocktime migration capability is enabled. (Since 10.1) -# -# @postcopy-non-vcpu-latency: average remote page fault latency for all -# faults happend in non-vCPU threads (in ns). It has the same -# definition of @postcopy-latency but this only provides statistics to -# non-vCPU faults. This is only present when the postcopy-blocktime -# migration capability is enabled. (Since 10.1) +# @postcopy-non-vcpu-latency: average remote page fault latency for +# all faults happend in non-vCPU threads (in ns). It has the same +# definition of @postcopy-latency but this only provides +# statistics to non-vCPU faults. This is only present when the +# postcopy-blocktime migration capability is enabled. +# (Since 10.1) # # @socket-address: Only used for tcp, to know what the real port is # (Since 4.0) @@ -290,7 +293,8 @@ # Features: # # @unstable: Members @postcopy-latency, @postcopy-vcpu-latency, -# @postcopy-latency-dist, @postcopy-non-vcpu-latency are experimental. +# @postcopy-latency-dist, @postcopy-non-vcpu-latency are +# experimental. # # Since: 0.14 ## @@ -564,7 +568,8 @@ # .. qmp-example:: # # -> { "execute": "migrate-set-capabilities" , "arguments": -# { "capabilities": [ { "capability": "xbzrle", "state": true } ]= } } +# { "capabilities": [ { "capability": "xbzrle", +# "state": true } ] } } # <- { "return": {} } ## { 'command': 'migrate-set-capabilities', @@ -627,8 +632,8 @@ # # @normal: the original form of migration. (since 8.2) # -# @cpr-reboot: The `migrate` command stops the VM and saves state to the -# URI. After quitting QEMU, the user resumes by running QEMU +# @cpr-reboot: The `migrate` command stops the VM and saves state to +# the URI. After quitting QEMU, the user resumes by running QEMU # -incoming. # # This mode allows the user to quit QEMU, optionally update and @@ -903,9 +908,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1089,9 +1095,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1304,9 +1311,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1442,7 +1450,8 @@ # # .. qmp-example:: # -# <- {"timestamp": {"seconds": 1432121972, "microseconds": 744001}, +# <- {"timestamp": {"seconds": 1432121972, +# "microseconds": 744001}, # "event": "MIGRATION", # "data": {"status": "completed"} } ## @@ -1461,7 +1470,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1449669631, "microseconds": 239225}, +# <- { "timestamp": {"seconds": 1449669631, +# "microseconds": 239225}, # "event": "MIGRATION_PASS", "data": {"pass": 2} } ## { 'event': 'MIGRATION_PASS', @@ -1545,8 +1555,10 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 2032141960, "microseconds": 417172}, -# "event": "COLO_EXIT", "data": {"mode": "primary", "reason": "re= quest" } } +# <- { "timestamp": {"seconds": 2032141960, +# "microseconds": 417172}, +# "event": "COLO_EXIT", +# "data": { "mode": "primary", "reason": "request" } } ## { 'event': 'COLO_EXIT', 'data': {'mode': 'COLOMode', 'reason': 'COLOExitReason' } } @@ -1758,7 +1770,8 @@ # # .. qmp-example:: # -# -> { "execute": "migrate", "arguments": { "uri": "tcp:0:4446" } } +# -> { "execute": "migrate", +# "arguments": { "uri": "tcp:0:4446" } } # <- { "return": {} } # # -> { "execute": "migrate", @@ -1774,8 +1787,9 @@ # "arguments": { # "channels": [ { "channel-type": "main", # "addr": { "transport": "exec", -# "args": [ "/bin/nc", "-p", "6000", -# "/some/sock" ] } } ] } } +# "args": [ +# "/bin/nc", "-p", "6000", +# "/some/sock" ] } } ] } } # <- { "return": {} } # # -> { "execute": "migrate", @@ -1813,9 +1827,9 @@ # list connected to a destination interface endpoint. # # @exit-on-error: Exit on incoming migration failure. Default true. -# When set to false, the failure triggers a :qapi:event:`MIGRATION` -# event, and error details could be retrieved with `query-migrate`. -# (since 9.1) +# When set to false, the failure triggers a +# :qapi:event:`MIGRATION` event, and error details could be +# retrieved with `query-migrate`. (since 9.1) # # Since: 2.3 # @@ -1855,8 +1869,9 @@ # "arguments": { # "channels": [ { "channel-type": "main", # "addr": { "transport": "exec", -# "args": [ "/bin/nc", "-p", "6000", -# "/some/sock" ] } } ] } } +# "args": [ +# "/bin/nc", "-p", "6000", +# "/some/sock" ] } } ] } } # <- { "return": {} } # # -> { "execute": "migrate-incoming", @@ -2037,7 +2052,8 @@ # .. qmp-example:: # # -> { "execute": "query-colo-status" } -# <- { "return": { "mode": "primary", "last-mode": "none", "reason": "= request" } } +# <- { "return": { "mode": "primary", "last-mode": "none", +# "reason": "request" } } # # Since: 3.1 ## @@ -2094,7 +2110,8 @@ # # <- { "event": "UNPLUG_PRIMARY", # "data": { "device-id": "hostdev0" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'UNPLUG_PRIMARY', 'data': { 'device-id': 'str' } } @@ -2252,8 +2269,8 @@ # # .. qmp-example:: # -# -> {"execute": "calc-dirty-rate", "arguments": {"calc-time": 1, -# "sample-pages": 512}= } +# -> { "execute": "calc-dirty-rate", +# "arguments": {"calc-time": 1, "sample-pages": 512} } # <- { "return": {} } # # .. qmp-example:: @@ -2261,8 +2278,10 @@ # # Measure dirty rate using dirty bitmap for 500 milliseconds:: # -# -> {"execute": "calc-dirty-rate", "arguments": {"calc-time": 500, -# "calc-time-unit": "millisecond", "mode": "dirty-bitmap"} } +# -> { "execute": "calc-dirty-rate", +# "arguments": { "calc-time": 500, +# "calc-time-unit": "millisecond", +# "mode": "dirty-bitmap"} } # # <- { "return": {} } ## @@ -2284,16 +2303,17 @@ # .. qmp-example:: # :title: Measurement is in progress # -# <- {"status": "measuring", "sample-pages": 512, -# "mode": "page-sampling", "start-time": 1693900454, "calc-time": = 10, -# "calc-time-unit": "second"} +# <- { "status": "measuring", "sample-pages": 512, +# "mode": "page-sampling", "start-time": 1693900454, +# "calc-time": 10, "calc-time-unit": "second" } # # .. qmp-example:: # :title: Measurement has been completed # -# <- {"status": "measured", "sample-pages": 512, "dirty-rate": 108, -# "mode": "page-sampling", "start-time": 1693900454, "calc-time": = 10, -# "calc-time-unit": "second"} +# <- { "status": "measured", "sample-pages": 512, +# "dirty-rate": 108, "mode": "page-sampling", +# "start-time": 1693900454, +# "calc-time": 10, "calc-time-unit": "second" } ## { 'command': 'query-dirty-rate', 'data': {'*calc-time-unit': 'TimeUnit' }, 'returns': 'DirtyRateInfo' } @@ -2452,23 +2472,30 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432121972, "microseconds": 744001}, +# "timestamp": {"seconds": 1432121972, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122172, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapsave0"}} # <- {"event": "STOP", -# "timestamp": {"seconds": 1432122372, "microseconds": 744001} } +# "timestamp": {"seconds": 1432122372, +# "microseconds": 744001} } # <- {"event": "RESUME", -# "timestamp": {"seconds": 1432122572, "microseconds": 744001} } +# "timestamp": {"seconds": 1432122572, +# "microseconds": 744001} } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122772, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122772, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122972, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122972, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432123172, "microseconds": 744001}, +# "timestamp": {"seconds": 1432123172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapsave0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, @@ -2507,8 +2534,8 @@ # time it takes to load the snapshot. # # It is strongly recommended that @devices contain all writable block -# device nodes that can have changed since the original `snapshot-save` -# command execution. +# device nodes that can have changed since the original +# `snapshot-save` command execution. # # .. qmp-example:: # @@ -2522,23 +2549,30 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472124172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472124172, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472125172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472125172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapload0"}} # <- {"event": "STOP", -# "timestamp": {"seconds": 1472125472, "microseconds": 744001} } +# "timestamp": {"seconds": 1472125472, +# "microseconds": 744001} } # <- {"event": "RESUME", -# "timestamp": {"seconds": 1472125872, "microseconds": 744001} } +# "timestamp": {"seconds": 1472125872, +# "microseconds": 744001} } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472126172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472126172, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472127172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472127172, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472128172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472128172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapload0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, @@ -2582,19 +2616,24 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442124172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442124172, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442125172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442125172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442126172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442126172, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442127172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442127172, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442128172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442128172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapdelete0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191549; cv=none; d=zohomail.com; s=zohoarc; b=EJjnNgRvls5jI0+4DLTN3SmtXOhft/00aSotxMXqO+qThXU93uRB+p4+zvQ4Y97Ecpb1Tpn+Mtz9Tl4dBkPlgim3f2sDfZW/VxEkuvrtHmlaynBIxFy8EwdPo6oK7abYJcyKyCdV2r9WU1QO6z15MeEXPiBrASZgF0LygZw8xNE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191549; 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=Rud6N/8EOaRmexXfDpe6yvJ3eRpDftouptgpBJ3O2Yg=; b=AwRuKZA3aN/XaOJr7z03lsEgPAJIWRN3Vz/QJUutZMghzpiQ9b3N9NcbmY573hLOgekYwK7HZPFME1a2zd0lrzk6k4sLrkPW+IayrJepHTPmuXtc8rsWhXhzPYBfONDY9l8hb0K1OLjX8xx7I5AgE6JfNjZ0SJf9CNHr+KiJAIk= 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 1760191549559499.3901722042235; Sat, 11 Oct 2025 07:05:49 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7Z-0006F2-DN; Sat, 11 Oct 2025 09:58:53 -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 1v7a7W-0006Ec-FP for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:50 -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 1v7a7M-0004jl-Uq for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:50 -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 F0457C0171; Sat, 11 Oct 2025 16:58:10 +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-SiaDTMna; Sat, 11 Oct 2025 16:58:10 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191090; bh=Rud6N/8EOaRmexXfDpe6yvJ3eRpDftouptgpBJ3O2Yg=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=CLoVsDaoCzMrA+mO8kSokdXN7n2kedbGbrHNNJvRHsPenJYH1Wi0x104IclzgKptY FWZ5I2eNqPyA7i8XgSBgd6Np+SBCE1MVvFJYcXWK9U/z6SpNwJUg5DBeNleX7lpHOh F7VXH23XQqldVdBUTTcUyMdSU+GgwXV2WLU+hmG8= 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, Peter Xu , Fabiano Rosas Subject: [PATCH 14/33] qapi/migration.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:07 +0300 Message-ID: <20251011135754.294521-27-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191551722154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/migration.json | 209 ++++++++++++++++++++++++++------------------ 1 file changed, 124 insertions(+), 85 deletions(-) diff --git a/qapi/migration.json b/qapi/migration.json index be0f3fcc12..74b9db1a51 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -160,11 +160,11 @@ # # @pre-switchover: Paused before device serialisation. (since 2.11) # -# @device: During device serialisation (also known as switchover phase). -# Before 9.2, this is only used when (1) in precopy, and (2) when -# pre-switchover capability is enabled. After 10.0, this state will -# always be present for every migration procedure as the switchover -# phase. (since 2.11) +# @device: During device serialisation (also known as switchover +# phase). Before 9.2, this is only used when (1) in precopy, and +# (2) when pre-switchover capability is enabled. After 10.0, this +# state will always be present for every migration procedure as +# the switchover phase. (since 2.11) # # @wait-unplug: wait for device unplug request by guest OS to be # completed. (since 4.2) @@ -238,30 +238,33 @@ # This is only present when the postcopy-blocktime migration # capability is enabled. (Since 3.0) # -# @postcopy-latency: average remote page fault latency (in ns). Note that -# this doesn't include all faults, but only the ones that require a -# remote page request. So it should be always bigger than the real -# average page fault latency. This is only present when the -# postcopy-blocktime migration capability is enabled. (Since 10.1) -# -# @postcopy-latency-dist: remote page fault latency distributions. Each -# element of the array is the number of faults that fall into the -# bucket period. For the N-th bucket (N>=3D0), the latency window is -# [2^Nus, 2^(N+1)us). For example, the 8th element stores how many -# remote faults got resolved within [256us, 512us) window. This is only -# present when the postcopy-blocktime migration capability is enabled. +# @postcopy-latency: average remote page fault latency (in ns). +# Note that this doesn't include all faults, but only the ones +# that require a remote page request. So it should be always +# bigger than the real average page fault latency. This is only +# present when the postcopy-blocktime migration capability is +# enabled. (Since 10.1) +# +# @postcopy-latency-dist: remote page fault latency distributions. +# Each element of the array is the number of faults that fall into +# the bucket period. For the N-th bucket (N>=3D0), the latency +# window is [2^Nus, 2^(N+1)us). For example, the 8th element +# stores how many remote faults got resolved within [256us, 512us) +# window. This is only present when the postcopy-blocktime +# migration capability is enabled. (Since 10.1) +# +# @postcopy-vcpu-latency: average remote page fault latency per vCPU +# (in ns). It has the same definition of @postcopy-latency, but +# instead this is the per-vCPU statistics. This is only present +# when the postcopy-blocktime migration capability is enabled. # (Since 10.1) # -# @postcopy-vcpu-latency: average remote page fault latency per vCPU (in -# ns). It has the same definition of @postcopy-latency, but instead -# this is the per-vCPU statistics. This is only present when the -# postcopy-blocktime migration capability is enabled. (Since 10.1) -# -# @postcopy-non-vcpu-latency: average remote page fault latency for all -# faults happend in non-vCPU threads (in ns). It has the same -# definition of @postcopy-latency but this only provides statistics to -# non-vCPU faults. This is only present when the postcopy-blocktime -# migration capability is enabled. (Since 10.1) +# @postcopy-non-vcpu-latency: average remote page fault latency for +# all faults happend in non-vCPU threads (in ns). It has the same +# definition of @postcopy-latency but this only provides +# statistics to non-vCPU faults. This is only present when the +# postcopy-blocktime migration capability is enabled. +# (Since 10.1) # # @socket-address: Only used for tcp, to know what the real port is # (Since 4.0) @@ -290,7 +293,8 @@ # Features: # # @unstable: Members @postcopy-latency, @postcopy-vcpu-latency, -# @postcopy-latency-dist, @postcopy-non-vcpu-latency are experimental. +# @postcopy-latency-dist, @postcopy-non-vcpu-latency are +# experimental. # # Since: 0.14 ## @@ -564,7 +568,8 @@ # .. qmp-example:: # # -> { "execute": "migrate-set-capabilities" , "arguments": -# { "capabilities": [ { "capability": "xbzrle", "state": true } ]= } } +# { "capabilities": [ { "capability": "xbzrle", +# "state": true } ] } } # <- { "return": {} } ## { 'command': 'migrate-set-capabilities', @@ -627,8 +632,8 @@ # # @normal: the original form of migration. (since 8.2) # -# @cpr-reboot: The `migrate` command stops the VM and saves state to the -# URI. After quitting QEMU, the user resumes by running QEMU +# @cpr-reboot: The `migrate` command stops the VM and saves state to +# the URI. After quitting QEMU, the user resumes by running QEMU # -incoming. # # This mode allows the user to quit QEMU, optionally update and @@ -903,9 +908,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1089,9 +1095,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1304,9 +1311,10 @@ # more CPU. Defaults to 1. (Since 5.0) # # @multifd-qatzip-level: Set the compression level to be used in live -# migration. The level is an integer between 1 and 9, where 1 means -# the best compression speed, and 9 means the best compression -# ratio which will consume more CPU. Defaults to 1. (Since 9.2) +# migration. The level is an integer between 1 and 9, where 1 +# means the best compression speed, and 9 means the best +# compression ratio which will consume more CPU. Defaults to 1. +# (Since 9.2) # # @multifd-zstd-level: Set the compression level to be used in live # migration, the compression level is an integer between 0 and 20, @@ -1442,7 +1450,8 @@ # # .. qmp-example:: # -# <- {"timestamp": {"seconds": 1432121972, "microseconds": 744001}, +# <- {"timestamp": {"seconds": 1432121972, +# "microseconds": 744001}, # "event": "MIGRATION", # "data": {"status": "completed"} } ## @@ -1461,7 +1470,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1449669631, "microseconds": 239225}, +# <- { "timestamp": {"seconds": 1449669631, +# "microseconds": 239225}, # "event": "MIGRATION_PASS", "data": {"pass": 2} } ## { 'event': 'MIGRATION_PASS', @@ -1545,8 +1555,10 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 2032141960, "microseconds": 417172}, -# "event": "COLO_EXIT", "data": {"mode": "primary", "reason": "re= quest" } } +# <- { "timestamp": {"seconds": 2032141960, +# "microseconds": 417172}, +# "event": "COLO_EXIT", +# "data": { "mode": "primary", "reason": "request" } } ## { 'event': 'COLO_EXIT', 'data': {'mode': 'COLOMode', 'reason': 'COLOExitReason' } } @@ -1758,7 +1770,8 @@ # # .. qmp-example:: # -# -> { "execute": "migrate", "arguments": { "uri": "tcp:0:4446" } } +# -> { "execute": "migrate", +# "arguments": { "uri": "tcp:0:4446" } } # <- { "return": {} } # # -> { "execute": "migrate", @@ -1774,8 +1787,9 @@ # "arguments": { # "channels": [ { "channel-type": "main", # "addr": { "transport": "exec", -# "args": [ "/bin/nc", "-p", "6000", -# "/some/sock" ] } } ] } } +# "args": [ +# "/bin/nc", "-p", "6000", +# "/some/sock" ] } } ] } } # <- { "return": {} } # # -> { "execute": "migrate", @@ -1813,9 +1827,9 @@ # list connected to a destination interface endpoint. # # @exit-on-error: Exit on incoming migration failure. Default true. -# When set to false, the failure triggers a :qapi:event:`MIGRATION` -# event, and error details could be retrieved with `query-migrate`. -# (since 9.1) +# When set to false, the failure triggers a +# :qapi:event:`MIGRATION` event, and error details could be +# retrieved with `query-migrate`. (since 9.1) # # Since: 2.3 # @@ -1855,8 +1869,9 @@ # "arguments": { # "channels": [ { "channel-type": "main", # "addr": { "transport": "exec", -# "args": [ "/bin/nc", "-p", "6000", -# "/some/sock" ] } } ] } } +# "args": [ +# "/bin/nc", "-p", "6000", +# "/some/sock" ] } } ] } } # <- { "return": {} } # # -> { "execute": "migrate-incoming", @@ -2037,7 +2052,8 @@ # .. qmp-example:: # # -> { "execute": "query-colo-status" } -# <- { "return": { "mode": "primary", "last-mode": "none", "reason": "= request" } } +# <- { "return": { "mode": "primary", "last-mode": "none", +# "reason": "request" } } # # Since: 3.1 ## @@ -2094,7 +2110,8 @@ # # <- { "event": "UNPLUG_PRIMARY", # "data": { "device-id": "hostdev0" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'UNPLUG_PRIMARY', 'data': { 'device-id': 'str' } } @@ -2252,8 +2269,8 @@ # # .. qmp-example:: # -# -> {"execute": "calc-dirty-rate", "arguments": {"calc-time": 1, -# "sample-pages": 512}= } +# -> { "execute": "calc-dirty-rate", +# "arguments": {"calc-time": 1, "sample-pages": 512} } # <- { "return": {} } # # .. qmp-example:: @@ -2261,8 +2278,10 @@ # # Measure dirty rate using dirty bitmap for 500 milliseconds:: # -# -> {"execute": "calc-dirty-rate", "arguments": {"calc-time": 500, -# "calc-time-unit": "millisecond", "mode": "dirty-bitmap"} } +# -> { "execute": "calc-dirty-rate", +# "arguments": { "calc-time": 500, +# "calc-time-unit": "millisecond", +# "mode": "dirty-bitmap"} } # # <- { "return": {} } ## @@ -2284,16 +2303,17 @@ # .. qmp-example:: # :title: Measurement is in progress # -# <- {"status": "measuring", "sample-pages": 512, -# "mode": "page-sampling", "start-time": 1693900454, "calc-time": = 10, -# "calc-time-unit": "second"} +# <- { "status": "measuring", "sample-pages": 512, +# "mode": "page-sampling", "start-time": 1693900454, +# "calc-time": 10, "calc-time-unit": "second" } # # .. qmp-example:: # :title: Measurement has been completed # -# <- {"status": "measured", "sample-pages": 512, "dirty-rate": 108, -# "mode": "page-sampling", "start-time": 1693900454, "calc-time": = 10, -# "calc-time-unit": "second"} +# <- { "status": "measured", "sample-pages": 512, +# "dirty-rate": 108, "mode": "page-sampling", +# "start-time": 1693900454, +# "calc-time": 10, "calc-time-unit": "second" } ## { 'command': 'query-dirty-rate', 'data': {'*calc-time-unit': 'TimeUnit' }, 'returns': 'DirtyRateInfo' } @@ -2452,23 +2472,30 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432121972, "microseconds": 744001}, +# "timestamp": {"seconds": 1432121972, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122172, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapsave0"}} # <- {"event": "STOP", -# "timestamp": {"seconds": 1432122372, "microseconds": 744001} } +# "timestamp": {"seconds": 1432122372, +# "microseconds": 744001} } # <- {"event": "RESUME", -# "timestamp": {"seconds": 1432122572, "microseconds": 744001} } +# "timestamp": {"seconds": 1432122572, +# "microseconds": 744001} } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122772, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122772, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432122972, "microseconds": 744001}, +# "timestamp": {"seconds": 1432122972, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapsave0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1432123172, "microseconds": 744001}, +# "timestamp": {"seconds": 1432123172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapsave0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, @@ -2507,8 +2534,8 @@ # time it takes to load the snapshot. # # It is strongly recommended that @devices contain all writable block -# device nodes that can have changed since the original `snapshot-save` -# command execution. +# device nodes that can have changed since the original +# `snapshot-save` command execution. # # .. qmp-example:: # @@ -2522,23 +2549,30 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472124172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472124172, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472125172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472125172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapload0"}} # <- {"event": "STOP", -# "timestamp": {"seconds": 1472125472, "microseconds": 744001} } +# "timestamp": {"seconds": 1472125472, +# "microseconds": 744001} } # <- {"event": "RESUME", -# "timestamp": {"seconds": 1472125872, "microseconds": 744001} } +# "timestamp": {"seconds": 1472125872, +# "microseconds": 744001} } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472126172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472126172, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472127172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472127172, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapload0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1472128172, "microseconds": 744001}, +# "timestamp": {"seconds": 1472128172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapload0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, @@ -2582,19 +2616,24 @@ # } # <- { "return": { } } # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442124172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442124172, +# "microseconds": 744001}, # "data": {"status": "created", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442125172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442125172, +# "microseconds": 744001}, # "data": {"status": "running", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442126172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442126172, +# "microseconds": 744001}, # "data": {"status": "waiting", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442127172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442127172, +# "microseconds": 744001}, # "data": {"status": "pending", "id": "snapdelete0"}} # <- {"event": "JOB_STATUS_CHANGE", -# "timestamp": {"seconds": 1442128172, "microseconds": 744001}, +# "timestamp": {"seconds": 1442128172, +# "microseconds": 744001}, # "data": {"status": "concluded", "id": "snapdelete0"}} # -> {"execute": "query-jobs"} # <- {"return": [{"current-progress": 1, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191803; cv=none; d=zohomail.com; s=zohoarc; b=dN/uSUjxENpeTOaPhNGS2GaAxbuM92R/3Z38YCn1SemST4bt9U5EWNGJR8dWDHjXHSWvno++NjXo79Bhu3luzl/MAQP4xPEWaxiFJvqrq395mMVggujLftJAulz+1PLLwPCqh4xpcEnIhZmLRwGQdjqRrCnED5Le9oLfGeOy/LY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191803; 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=R97QVgggHJt0TYErv0pdM9bM0qLtHf2/4vw/YTVLSiA=; b=l0VvsJGaEIK3CQulU4HTdwwDyc05D2SiR4iHAMjG641RYLm+EjTi1HKFx8ZGR2G6Wm+jv04W5gL9j3S3bwb1VwUzGTQlWihy6baCKsphm8UhgsAGiU4GB/jE9m9pastmyjn+VJp3gH/Ee+p/52ISG7T1N6SYirszjzzC6NOkqAY= 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 176019180374228.843808310623217; Sat, 11 Oct 2025 07:10:03 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7l-0006HW-Gy; Sat, 11 Oct 2025 09:59:07 -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 1v7a7d-0006Gj-Mn for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:57 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7R-0004k4-IT for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:57 -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 6B17EC0173; Sat, 11 Oct 2025 16:58:12 +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-ryPMK0wm; Sat, 11 Oct 2025 16:58:12 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191092; bh=R97QVgggHJt0TYErv0pdM9bM0qLtHf2/4vw/YTVLSiA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=py0sJ6yYHqO1j6IjrgikwRN9FZMAnlLEDin8yxACe6UJWWhXJn7blX5jx4GZ4F6NI XRcgzve74I2PDQ6qkX70bb6Eq5qrsmSqyCfY8A6K3oCajbEKDyRX2utaIpeX5mQOdV zoDOoyxZnxL5i65QoasCQS2WKevEqV4louHohFa8= 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 Subject: [PATCH 15/33] qapi/misc-arm.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:09 +0300 Message-ID: <20251011135754.294521-29-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760191807163158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc-arm.json | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index f921d740f1..a7e0649b25 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -41,7 +41,9 @@ # .. qmp-example:: # # -> { "execute": "query-gic-capabilities" } -# <- { "return": [{ "version": 2, "emulated": true, "kernel": false }, -# { "version": 3, "emulated": false, "kernel": true } = ] } +# <- { "return": [{ "version": 2, "emulated": true, +# "kernel": false }, +# { "version": 3, "emulated": false, +# "kernel": true } ] } ## { 'command': 'query-gic-capabilities', 'returns': ['GICCapability'] } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191538; cv=none; d=zohomail.com; s=zohoarc; b=SmXk087aeheVpqC7ZiwNLdJFIhd6kDqPHNMjjRIGiikSEYw7xvisbouF3hwe/gqbG9HjC2Arz+8TScO8ChDDYXVOcdnYTOstlSmKeqVEzp0LQrjs/025ZHGrcOMVoOLHbz3cMMxNUw7u0zFtwSpSmoJGuhNDZ7BW6NgROJNSaw8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191538; 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=R97QVgggHJt0TYErv0pdM9bM0qLtHf2/4vw/YTVLSiA=; b=E2lLWWSNGZStV1DLjaTAQgDz/ggVjl5j8QviWLUi6p/HLxG/LTDiMCQ6tlOHlTVcgh/OpuYfUNioy+jIcrILMLvC06jD+8r5C2+Ed/0kROFDmUDK78SkE+w9/sNgzAGWQl99aFSTXbf26JQiuBISlXyLo+lB8ZKg6aYPpsugvl4= 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 1760191538591189.64425110972604; Sat, 11 Oct 2025 07:05:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a90-00071B-Ss; Sat, 11 Oct 2025 10:00:23 -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 1v7a7m-0006Ib-4B for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:07 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7T-0004k5-5q for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -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 C4BBCC0174; Sat, 11 Oct 2025 16:58:12 +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-1SDyyl0j; Sat, 11 Oct 2025 16:58:12 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191092; bh=R97QVgggHJt0TYErv0pdM9bM0qLtHf2/4vw/YTVLSiA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=XXG6DdIwgQ5/ckk/ZOsuwAHFjeMmL/2l+vOeZleWBbqjLgdm0r8TrjDTnV9yXwVCg PBJBXd3uLgL8SiHZGqYQcGRXOqGMkrAAfT+jyzm5srg4/KaADAaFlOxeN3UIUxGtYS gi3MkmhCQINZt+C34MG1FqozYulBxPIJ3dEgFCjc= 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 Subject: [PATCH 15/33] qapi/misc-arm.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:10 +0300 Message-ID: <20251011135754.294521-30-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191539720154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc-arm.json | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/qapi/misc-arm.json b/qapi/misc-arm.json index f921d740f1..a7e0649b25 100644 --- a/qapi/misc-arm.json +++ b/qapi/misc-arm.json @@ -41,7 +41,9 @@ # .. qmp-example:: # # -> { "execute": "query-gic-capabilities" } -# <- { "return": [{ "version": 2, "emulated": true, "kernel": false }, -# { "version": 3, "emulated": false, "kernel": true } = ] } +# <- { "return": [{ "version": 2, "emulated": true, +# "kernel": false }, +# { "version": 3, "emulated": false, +# "kernel": true } ] } ## { 'command': 'query-gic-capabilities', 'returns': ['GICCapability'] } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192280; cv=none; d=zohomail.com; s=zohoarc; b=GWb8GBNvebwCegMm0QJf9W5HZWNJxNHsC9143+PH4o9ouJ1X3KpLCx3l/9WdS5nQwm3B7siKePefc+kDx99MhQf9loRQp01J5MMLfkfeA2PYukxRHGfZh3aT+HyOkcDyo4jeb2aPJAlcUxeh2WmmB6lwjkN/r/8PbKHT8r2fDdA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192280; 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=Va9tPsZdzTxRbSPf8QsoAdULO2YTnBK/t9JKeUkaz0c=; b=HJhS5pNycUrnVlHHkelcSZMJjh3j5AnvcJ6ksByQ+tioiRqYXvpzpnsHvnhjV1nzzzDm0lFLBlKRakiGGT8CHBzFmA9Y/jFxEDWMiIr6gGl3fFEfTCczFFAsrS8XZHpo2LkZVBnF8CQRH5nrQ8rlgdIevRHNNKawOIiXsID9fFU= 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 1760192279997142.87859207028453; Sat, 11 Oct 2025 07:17:59 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7q-0006I5-HD; Sat, 11 Oct 2025 09:59:14 -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 1v7a7e-0006H6-Cz for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:58 -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 1v7a7R-0004kF-Pm for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:58 -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 841E5C0178; Sat, 11 Oct 2025 16:58:13 +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-Uq0HgRMR; Sat, 11 Oct 2025 16:58:13 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191093; bh=Va9tPsZdzTxRbSPf8QsoAdULO2YTnBK/t9JKeUkaz0c=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=y1soZKe1+dRD99RxJZvOInvn+TLo9TudtlqmIYbSXiGm9+S2dviHp6foApLEJZ9YA W8OP7kbRbxohCjN4KNVavk5qI4sOC54KqmdkIcfHcqqc9nK6fU7K5PXE1taU5Y9V05 yEqx4ITKSweFLv8gKL3vwcFAaPtyaVgPED1LLdOo= 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 Subject: [PATCH 16/33] qapi/misc-i386.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:12 +0300 Message-ID: <20251011135754.294521-32-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192282726158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc-i386.json | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/qapi/misc-i386.json b/qapi/misc-i386.json index d1ce8caf25..3783202674 100644 --- a/qapi/misc-i386.json +++ b/qapi/misc-i386.json @@ -137,9 +137,9 @@ # .. qmp-example:: # # -> { "execute": "query-sev" } -# <- { "return": { "enabled": true, "api-major" : 0, "api-minor" : 0, -# "build-id" : 0, "policy" : 0, "state" : "running", -# "handle" : 1 } } +# <- { "return": { "enabled": true, "api-major" : 0, +# "api-minor" : 0, "build-id" : 0, "policy" : 0, +# "state" : "running", "handle" : 1 } } ## { 'command': 'query-sev', 'returns': 'SevInfo' } =20 @@ -220,7 +220,8 @@ # .. qmp-example:: # # -> { "execute": "query-sev-capabilities" } -# <- { "return": { "pdh": "8CCDD8DDD", "cert-chain": "888CCCDDDEE", +# <- { "return": { "pdh": "8CCDD8DDD", +# "cert-chain": "888CCCDDDEE", # "cpu0-id": "2lvmGwo+...61iEinw=3D=3D", # "cbitpos": 47, "reduced-phys-bits": 1}} ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191241; cv=none; d=zohomail.com; s=zohoarc; b=kUj0+RIEnt4fqQwHZtIyp0LPrguM6xm1MbkNCP0rCi+zeZyGMmo2HeE1tPszFXXGYIxVZx4iQz+B73U4YS+GQJVJM9fx1Bb17sjQ+JpBVvvfiKZzjdluuPag6+SaqYCxExzytnK88mrcNhDtF4sGpguITJo1ty6dLC32jCx2BZA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191241; 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=Va9tPsZdzTxRbSPf8QsoAdULO2YTnBK/t9JKeUkaz0c=; b=fdtWvnB0hl9o8OX1m5IpqLQ2/Qz/ePAlarX7l13BENEiDjYyqaoy+t7HlNazIVNgt+m1mO6PQoT83Iov069EUk/xyQwU0A0aC+URbDHce9LFHzYCLrT00Wi6xWC/5w8LSfUwhEGxjPFFQ5yTsukD+Z47IlO02efKtuvUuQyXlV0= 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 1760191240749408.56750579680124; Sat, 11 Oct 2025 07:00:40 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7h-0006HU-He; Sat, 11 Oct 2025 09:59:01 -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 1v7a7b-0006G0-Mw for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:56 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7P-0004kE-7g for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:55 -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 2AF73C0175; Sat, 11 Oct 2025 16:58:13 +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-HD2JQ03I; Sat, 11 Oct 2025 16:58:12 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191092; bh=Va9tPsZdzTxRbSPf8QsoAdULO2YTnBK/t9JKeUkaz0c=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=NRqaAvPX88zVowxi6ke7bzsik8xBRKBjb+2p/KNl3fHDR6rFUGjbsRdWl3nQxFFg9 HDXg1KKSvTAhVoqre6WDyXImdcJcLl4O+lTeQ3o5VAiJly47QtohzaqWAHnxDXocOR ZRkVewy36OCG6jRvw/loG7g4El8stJQl215ztf9c= 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 Subject: [PATCH 16/33] qapi/misc-i386.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:11 +0300 Message-ID: <20251011135754.294521-31-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, 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: 1760191243672158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc-i386.json | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/qapi/misc-i386.json b/qapi/misc-i386.json index d1ce8caf25..3783202674 100644 --- a/qapi/misc-i386.json +++ b/qapi/misc-i386.json @@ -137,9 +137,9 @@ # .. qmp-example:: # # -> { "execute": "query-sev" } -# <- { "return": { "enabled": true, "api-major" : 0, "api-minor" : 0, -# "build-id" : 0, "policy" : 0, "state" : "running", -# "handle" : 1 } } +# <- { "return": { "enabled": true, "api-major" : 0, +# "api-minor" : 0, "build-id" : 0, "policy" : 0, +# "state" : "running", "handle" : 1 } } ## { 'command': 'query-sev', 'returns': 'SevInfo' } =20 @@ -220,7 +220,8 @@ # .. qmp-example:: # # -> { "execute": "query-sev-capabilities" } -# <- { "return": { "pdh": "8CCDD8DDD", "cert-chain": "888CCCDDDEE", +# <- { "return": { "pdh": "8CCDD8DDD", +# "cert-chain": "888CCCDDDEE", # "cpu0-id": "2lvmGwo+...61iEinw=3D=3D", # "cbitpos": 47, "reduced-phys-bits": 1}} ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192123; cv=none; d=zohomail.com; s=zohoarc; b=WDECDN65ZFcDJ69zPFx2uvBp969q+8kGK+CeM8Zm5Qv9SFFJWGp9+Vvp6hL8OFo9KTnptL5yDiPK4cbnm1eeMB8jaS/2vrHXStFyfRKJTUEQLNnoM+2gcZKigLYGr3aKK2O1Iy9mgprQU0rZUXu9Skr0F0HxFFBS/aTZktS3YPA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192123; 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=9E/JVW0uw8uTCppIO66nEpAS+hp8/t959JvxxH++TCk=; b=Z35vETxH+shlAHRudgF0JbAOtMQtrmnVGC52XDsMD6BLTB4XU4TztuWtFySqdTRsrF6Qv1D4tN31WvOC+tJMahYjQcYNlF3Iqc4SDKjCHIGCG+dQUSm2Cs/dv4JjOSkjapHLV9m/+7rxduYOrKqX4EiTTQe75MlhnRpkxeGkH/A= 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 1760192123522518.8754577613279; Sat, 11 Oct 2025 07:15:23 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a88-0006OI-Da; Sat, 11 Oct 2025 09:59:28 -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 1v7a7h-0006HY-PL for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7R-0004kN-Lh for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:59 -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 52700C017A; Sat, 11 Oct 2025 16:58:14 +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-4yAO3J29; Sat, 11 Oct 2025 16:58:14 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191094; bh=9E/JVW0uw8uTCppIO66nEpAS+hp8/t959JvxxH++TCk=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=0PlzVlFDhb+uhkqDDbI825FM8hCPh07EH3qb4u4IWeyEpGDaZFyOoNB5cDU45VmLN uktzQcOqPBpHxvG9tX8zb4vANPURc8dtOUwJiCooSroAtdMYZtb5NDdWx6m45ufVYX WZBw29ebHhIcYQDdbQthIchtQHYb13DzqibpA9CQ= 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 Subject: [PATCH 17/33] qapi/misc.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:14 +0300 Message-ID: <20251011135754.294521-34-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192128935158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc.json | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/qapi/misc.json b/qapi/misc.json index 28c641fe2f..456241bcfd 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -34,8 +34,8 @@ # # .. qmp-example:: # -# -> { "execute": "add_client", "arguments": { "protocol": "vnc", -# "fdname": "myclient" } } +# -> { "execute": "add_client", +# "arguments": { "protocol": "vnc", "fdname": "myclient" } } # <- { "return": {} } ## { 'command': 'add_client', @@ -288,7 +288,8 @@ # .. qmp-example:: # # -> { "execute": "get-win32-socket", -# "arguments": { "info": "abcd123..", "fdname": "skclient" } } +# "arguments": { "info": "abcd123..", +# "fdname": "skclient" } } # <- { "return": {} } ## { 'command': 'get-win32-socket', 'data': {'info': 'str', 'fdname': 'str'},= 'if': 'CONFIG_WIN32' } @@ -374,7 +375,8 @@ # # .. qmp-example:: # -# -> { "execute": "remove-fd", "arguments": { "fdset-id": 1, "fd": 3 }= } +# -> { "execute": "remove-fd", +# "arguments": { "fdset-id": 1, "fd": 3 } } # <- { "return": {} } ## { 'command': 'remove-fd', 'data': {'fdset-id': 'int', '*fd': 'int'} } @@ -564,7 +566,8 @@ # # <- { "event": "RTC_CHANGE", # "data": { "offset": 78 }, -# "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } +# "timestamp": { "seconds": 1267020223, +# "microseconds": 435656 } } ## { 'event': 'RTC_CHANGE', 'data': { 'offset': 'int', 'qom-path': 'str' } } @@ -594,7 +597,8 @@ # "vfu-qom-path": "/objects/vfu1", # "dev-id": "sas1", # "dev-qom-path": "/machine/peripheral/sas1" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'VFU_CLIENT_HANGUP', 'data': { 'vfu-id': 'str', 'vfu-qom-path': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192910; cv=none; d=zohomail.com; s=zohoarc; b=fOBGmC7N2KgeTEDqcHKpZtKi/ZZYpaPDNbeYDkPqpQGQ01pj6+U+435+DA9SF6wFVrzqIBFGq1u8s0eO5f70bZGzQesCwQcMD1I5OyfEOgZQq4alBmcDf3VdgrvxTlE2jOioPtI7jZ92tIpZ291T1BaMtYmyiBf4NRrHq9gURPU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192910; 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=9E/JVW0uw8uTCppIO66nEpAS+hp8/t959JvxxH++TCk=; b=YYujVomjJNyAZuY4yldWMtEwoZcC/dzrvq6OYedAFApeuqO5XK9EGOeHLN4ApGimvi+M0g45WqVAL07sUGKgODRBWnKPrYgCvawWZxe0un5cQ6CbDJgVlpn8U0jzVuUMerqOpMPX4XnUO/Sp+uo2RPG6pkHcei/inuwRY7vaHSU= 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 1760192910346879.0713147067437; Sat, 11 Oct 2025 07:28:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a7d-0006GT-Q2; Sat, 11 Oct 2025 09:58:57 -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 1v7a7c-0006GH-8T for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:56 -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 1v7a7P-0004kM-OV for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:58:55 -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 EA6E0C0179; Sat, 11 Oct 2025 16:58:13 +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-rwVWiBqK; Sat, 11 Oct 2025 16:58:13 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191093; bh=9E/JVW0uw8uTCppIO66nEpAS+hp8/t959JvxxH++TCk=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=L8NPrUw/i9KhZC7v8DR+jcSaQwI7yICzXEOqZQi4U3WFGLR5oB0oFaZPWMETulmDS KWulKpzwF43q2XtoCYDL+IAsMp8ptf3A8OlZPzzQGa4O/ROC5ESW313tJ2SQTIfHnM LoWLa5tdo0cBhNj6V0zONTnNJcrPP0jZCKEES2bk= 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 Subject: [PATCH 17/33] qapi/misc.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:13 +0300 Message-ID: <20251011135754.294521-33-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: -23 X-Spam_score: -2.4 X-Spam_bar: -- X-Spam_report: (-2.4 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192911360154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/misc.json | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/qapi/misc.json b/qapi/misc.json index 28c641fe2f..456241bcfd 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -34,8 +34,8 @@ # # .. qmp-example:: # -# -> { "execute": "add_client", "arguments": { "protocol": "vnc", -# "fdname": "myclient" } } +# -> { "execute": "add_client", +# "arguments": { "protocol": "vnc", "fdname": "myclient" } } # <- { "return": {} } ## { 'command': 'add_client', @@ -288,7 +288,8 @@ # .. qmp-example:: # # -> { "execute": "get-win32-socket", -# "arguments": { "info": "abcd123..", "fdname": "skclient" } } +# "arguments": { "info": "abcd123..", +# "fdname": "skclient" } } # <- { "return": {} } ## { 'command': 'get-win32-socket', 'data': {'info': 'str', 'fdname': 'str'},= 'if': 'CONFIG_WIN32' } @@ -374,7 +375,8 @@ # # .. qmp-example:: # -# -> { "execute": "remove-fd", "arguments": { "fdset-id": 1, "fd": 3 }= } +# -> { "execute": "remove-fd", +# "arguments": { "fdset-id": 1, "fd": 3 } } # <- { "return": {} } ## { 'command': 'remove-fd', 'data': {'fdset-id': 'int', '*fd': 'int'} } @@ -564,7 +566,8 @@ # # <- { "event": "RTC_CHANGE", # "data": { "offset": 78 }, -# "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } +# "timestamp": { "seconds": 1267020223, +# "microseconds": 435656 } } ## { 'event': 'RTC_CHANGE', 'data': { 'offset': 'int', 'qom-path': 'str' } } @@ -594,7 +597,8 @@ # "vfu-qom-path": "/objects/vfu1", # "dev-id": "sas1", # "dev-qom-path": "/machine/peripheral/sas1" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'VFU_CLIENT_HANGUP', 'data': { 'vfu-id': 'str', 'vfu-qom-path': 'str', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191517; cv=none; d=zohomail.com; s=zohoarc; b=BwR6K1sORayrVc/cb6oCthWZC0HeULXTqVSRcUNGHm8px1dMq1ADsaQJziwbQ8jC4imz/q9HafOy7Q/AY+WCOlphT4kF5REVcR0szs10YrI3VMXrmKQiO1IMvKmF7BvYXeBq4W+6+L73+pulytjUhNLIkDyxvQuo4ayYZ7XKNQc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191517; 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=UIcniQdwd/ae/0mlqDqWCCJREenQAzGUtQQWDB4sJo8=; b=da4nLkOQeyPc+sG2gDNm5veCpnS5i3xY1d5k5LbTO3iOVkDUKessrND9Af5/akBjJd+iqe+KsUEOvtvZHN8xR9iKFsBtVNqWzbT0T4Inmj2QQRuespM5+WPuzQOMArjsDwQAidUVUwKkgdATV993xAkchvDKG8MPckvg0EXWMEA= 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 1760191517509762.0904462886299; Sat, 11 Oct 2025 07:05:17 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8A-0006QE-65; Sat, 11 Oct 2025 09:59:31 -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 1v7a7h-0006HX-Ld for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:03 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7T-0004kb-HQ for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:01 -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 65D1FC017D; Sat, 11 Oct 2025 16:58:15 +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-Jj6xlju8; Sat, 11 Oct 2025 16:58:14 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191094; bh=UIcniQdwd/ae/0mlqDqWCCJREenQAzGUtQQWDB4sJo8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=ygULDRxNhi8oUmD1Z7AB6iyFrjFZ21exdxg0HgJQYfV8zQ7pAokuUnuYNCIXdme3T tAT2sPjSeIkOC7X1QWBg57hG8IlWJeerTqBWN5yn0HYA6yEdmnVwsdcIm1PaVhoVq5 bhT0/KHELCZx06SuhjgYeN3wZvU7+zf1O04lO3Rk= 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, Jason Wang Subject: [PATCH 18/33] qapi/net.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:16 +0300 Message-ID: <20251011135754.294521-36-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191518761158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/net.json | 61 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 38 insertions(+), 23 deletions(-) diff --git a/qapi/net.json b/qapi/net.json index 60d196afe5..834a9abb9d 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -51,8 +51,9 @@ # .. qmp-example:: # # -> { "execute": "netdev_add", -# "arguments": { "type": "user", "id": "netdev1", -# "dnssearch": [ { "str": "example.org" } ] } } +# "arguments": { +# "type": "user", "id": "netdev1", +# "dnssearch": [ { "str": "example.org" } ] } } # <- { "return": {} } ## { 'command': 'netdev_add', 'data': 'Netdev', 'boxed': true, @@ -119,9 +120,11 @@ # # Unprivileged user-mode network connectivity using passt # -# @path: Filename of the passt program to run (by default 'passt', and use= PATH) +# @path: Filename of the passt program to run (by default 'passt', +# and use PATH) # -# @quiet: don't print informational messages (default, passed as '--quiet') +# @quiet: don't print informational messages +# (default, passed as '--quiet') # # @vhost-user: enable vhost-user # @@ -281,8 +284,8 @@ # # @smbserver: IP address of the built-in SMB server # -# @hostfwd: redirect incoming TCP, UDP or UNIX host connections to guest -# endpoints +# @hostfwd: redirect incoming TCP, UDP or UNIX host connections to +# guest endpoints # # @guestfwd: forward guest TCP connections # @@ -569,7 +572,8 @@ # (default: 0). # # @inhibit: Don't load a default XDP program, use one already loaded -# to the interface (default: false). Requires @sock-fds or @map-path. +# to the interface (default: false). Requires @sock-fds or +# @map-path. # # @sock-fds: A colon (:) separated list of file descriptors for # already open but not bound AF_XDP sockets in the queue order. @@ -582,7 +586,8 @@ # mutually exclusive. Requires @inhibit. (Since 10.1) # # @map-start-index: Use @map-path to insert xsk sockets starting from -# this index number (default: 0). Requires @map-path. (Since 10.1) +# this index number (default: 0). Requires @map-path. +# (Since 10.1) # # Since: 8.2 ## @@ -774,10 +779,10 @@ # attempt a reconnect after the given number of seconds. Setting # this to zero disables this function. (default: 0) (since 8.0) # -# @reconnect-ms: For a client socket, if a socket is disconnected, then -# attempt a reconnect after the given number of milliseconds. Setting -# this to zero disables this function. This member is mutually -# exclusive with @reconnect. (default: 0) (Since: 9.2) +# @reconnect-ms: For a client socket, if a socket is disconnected, +# then attempt a reconnect after the given number of milliseconds. +# Setting this to zero disables this function. This member is +# mutually exclusive with @reconnect. (default: 0) (Since: 9.2) # # Only `SocketAddress` types 'unix', 'inet' and 'fd' are supported. # @@ -985,7 +990,8 @@ # # .. qmp-example:: # -# -> { "execute": "query-rx-filter", "arguments": { "name": "vnet0" } } +# -> { "execute": "query-rx-filter", +# "arguments": { "name": "vnet0" } } # <- { "return": [ # { # "promiscuous": true, @@ -1031,9 +1037,11 @@ # .. qmp-example:: # # <- { "event": "NIC_RX_FILTER_CHANGED", -# "data": { "name": "vnet0", -# "path": "/machine/peripheral/vnet0/virtio-backend" }, -# "timestamp": { "seconds": 1368697518, "microseconds": 326866 } } +# "data": { +# "name": "vnet0", +# "path": "/machine/peripheral/vnet0/virtio-backend" }, +# "timestamp": { "seconds": 1368697518, +# "microseconds": 326866 } } ## { 'event': 'NIC_RX_FILTER_CHANGED', 'data': { '*name': 'str', 'path': 'str' } } @@ -1108,7 +1116,8 @@ # # <- { "event": "FAILOVER_NEGOTIATED", # "data": { "device-id": "net1" }, -# "timestamp": { "seconds": 1368697518, "microseconds": 326866 } } +# "timestamp": { "seconds": 1368697518, +# "microseconds": 326866 } } ## { 'event': 'FAILOVER_NEGOTIATED', 'data': {'device-id': 'str'} } @@ -1130,14 +1139,17 @@ # "data": { "netdev-id": "netdev0", # "addr": { "port": "47666", "ipv6": true, # "host": "::1", "type": "inet" } }, -# "timestamp": { "seconds": 1666269863, "microseconds": 311222 } } +# "timestamp": { "seconds": 1666269863, +# "microseconds": 311222 } } # # .. qmp-example:: # # <- { "event": "NETDEV_STREAM_CONNECTED", # "data": { "netdev-id": "netdev0", -# "addr": { "path": "/tmp/qemu0", "type": "unix" } }, -# "timestamp": { "seconds": 1666269706, "microseconds": 413651 } } +# "addr": { "path": "/tmp/qemu0", +# "type": "unix" } }, +# "timestamp": { "seconds": 1666269706, +# "microseconds": 413651 } } ## { 'event': 'NETDEV_STREAM_CONNECTED', 'data': { 'netdev-id': 'str', @@ -1156,7 +1168,8 @@ # # <- { "event": "NETDEV_STREAM_DISCONNECTED", # "data": {"netdev-id": "netdev0"}, -# "timestamp": {"seconds": 1663330937, "microseconds": 526695} } +# "timestamp": {"seconds": 1663330937, +# "microseconds": 526695} } ## { 'event': 'NETDEV_STREAM_DISCONNECTED', 'data': { 'netdev-id': 'str' } } @@ -1174,7 +1187,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1739538638, "microseconds": 354181 }, +# <- { "timestamp": {"seconds": 1739538638, +# "microseconds": 354181 }, # "event": "NETDEV_VHOST_USER_CONNECTED", # "data": { "netdev-id": "netdev0", "chardev-id": "chr0" } } # @@ -1193,7 +1207,8 @@ # # .. qmp-example:: # -# <- { "timestamp": { "seconds": 1739538634, "microseconds": 920450 }, +# <- { "timestamp": { "seconds": 1739538634, +# "microseconds": 920450 }, # "event": "NETDEV_VHOST_USER_DISCONNECTED", # "data": { "netdev-id": "netdev0" } } # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192472; cv=none; d=zohomail.com; s=zohoarc; b=CMxgLdIWFgzcCVvEv6EvNOKo/+6jNZrnO1Ugb2MYYy+MjdTbhKY/qeL4HzG6fhMAlcVQR1Z3w9XXNPpS95EC9J7SuT1uJrA8mq29LFOLlxRrxORMyRBe8YHPJMap9tJTFkvFsdmvNXdz20jGsP4i7umVlKHYrjKxO9hOJvo6IpM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192472; 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=UIcniQdwd/ae/0mlqDqWCCJREenQAzGUtQQWDB4sJo8=; b=XazDABUhlJvIOcQsSReElI1WG9opaEqHhZP4lwLRnGGnPw39YXQ3175SYdCDU0honLaeCOV/2nwQmEGG9QtkShLOfSEzlBr75Wi/G1owSqyFD9SxCBqGduo+RWT/S0cQ1x5IpXegNWu5P/QML094kXvgTGdU0EnMFdjJG2cKiVY= 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 1760192472942719.7019343951897; Sat, 11 Oct 2025 07:21:12 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8c-0006aY-GF; Sat, 11 Oct 2025 09:59:58 -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 1v7a7j-0006Hj-P1 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7R-0004ka-N3 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:02 -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 D5F20C017C; Sat, 11 Oct 2025 16:58:14 +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-lGMoqtto; Sat, 11 Oct 2025 16:58:14 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191094; bh=UIcniQdwd/ae/0mlqDqWCCJREenQAzGUtQQWDB4sJo8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=kzshfE5fK608B1QzZF9q5f92pCyYfdxJ90ZO3hoH0yMZxzzRMm6puQ06fXazO+oKv ykzjd1lPT3CjXAnw2iYO/bEPzr43WvVfv9BIk9mXCfV4YZdbUeksnTgVQBpciw5MjN SV5utXptHvyX+XFwd/FD6ZO/x/xeLGidehCy/o+o= 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, Jason Wang Subject: [PATCH 18/33] qapi/net.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:15 +0300 Message-ID: <20251011135754.294521-35-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192479062158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/net.json | 61 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 38 insertions(+), 23 deletions(-) diff --git a/qapi/net.json b/qapi/net.json index 60d196afe5..834a9abb9d 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -51,8 +51,9 @@ # .. qmp-example:: # # -> { "execute": "netdev_add", -# "arguments": { "type": "user", "id": "netdev1", -# "dnssearch": [ { "str": "example.org" } ] } } +# "arguments": { +# "type": "user", "id": "netdev1", +# "dnssearch": [ { "str": "example.org" } ] } } # <- { "return": {} } ## { 'command': 'netdev_add', 'data': 'Netdev', 'boxed': true, @@ -119,9 +120,11 @@ # # Unprivileged user-mode network connectivity using passt # -# @path: Filename of the passt program to run (by default 'passt', and use= PATH) +# @path: Filename of the passt program to run (by default 'passt', +# and use PATH) # -# @quiet: don't print informational messages (default, passed as '--quiet') +# @quiet: don't print informational messages +# (default, passed as '--quiet') # # @vhost-user: enable vhost-user # @@ -281,8 +284,8 @@ # # @smbserver: IP address of the built-in SMB server # -# @hostfwd: redirect incoming TCP, UDP or UNIX host connections to guest -# endpoints +# @hostfwd: redirect incoming TCP, UDP or UNIX host connections to +# guest endpoints # # @guestfwd: forward guest TCP connections # @@ -569,7 +572,8 @@ # (default: 0). # # @inhibit: Don't load a default XDP program, use one already loaded -# to the interface (default: false). Requires @sock-fds or @map-path. +# to the interface (default: false). Requires @sock-fds or +# @map-path. # # @sock-fds: A colon (:) separated list of file descriptors for # already open but not bound AF_XDP sockets in the queue order. @@ -582,7 +586,8 @@ # mutually exclusive. Requires @inhibit. (Since 10.1) # # @map-start-index: Use @map-path to insert xsk sockets starting from -# this index number (default: 0). Requires @map-path. (Since 10.1) +# this index number (default: 0). Requires @map-path. +# (Since 10.1) # # Since: 8.2 ## @@ -774,10 +779,10 @@ # attempt a reconnect after the given number of seconds. Setting # this to zero disables this function. (default: 0) (since 8.0) # -# @reconnect-ms: For a client socket, if a socket is disconnected, then -# attempt a reconnect after the given number of milliseconds. Setting -# this to zero disables this function. This member is mutually -# exclusive with @reconnect. (default: 0) (Since: 9.2) +# @reconnect-ms: For a client socket, if a socket is disconnected, +# then attempt a reconnect after the given number of milliseconds. +# Setting this to zero disables this function. This member is +# mutually exclusive with @reconnect. (default: 0) (Since: 9.2) # # Only `SocketAddress` types 'unix', 'inet' and 'fd' are supported. # @@ -985,7 +990,8 @@ # # .. qmp-example:: # -# -> { "execute": "query-rx-filter", "arguments": { "name": "vnet0" } } +# -> { "execute": "query-rx-filter", +# "arguments": { "name": "vnet0" } } # <- { "return": [ # { # "promiscuous": true, @@ -1031,9 +1037,11 @@ # .. qmp-example:: # # <- { "event": "NIC_RX_FILTER_CHANGED", -# "data": { "name": "vnet0", -# "path": "/machine/peripheral/vnet0/virtio-backend" }, -# "timestamp": { "seconds": 1368697518, "microseconds": 326866 } } +# "data": { +# "name": "vnet0", +# "path": "/machine/peripheral/vnet0/virtio-backend" }, +# "timestamp": { "seconds": 1368697518, +# "microseconds": 326866 } } ## { 'event': 'NIC_RX_FILTER_CHANGED', 'data': { '*name': 'str', 'path': 'str' } } @@ -1108,7 +1116,8 @@ # # <- { "event": "FAILOVER_NEGOTIATED", # "data": { "device-id": "net1" }, -# "timestamp": { "seconds": 1368697518, "microseconds": 326866 } } +# "timestamp": { "seconds": 1368697518, +# "microseconds": 326866 } } ## { 'event': 'FAILOVER_NEGOTIATED', 'data': {'device-id': 'str'} } @@ -1130,14 +1139,17 @@ # "data": { "netdev-id": "netdev0", # "addr": { "port": "47666", "ipv6": true, # "host": "::1", "type": "inet" } }, -# "timestamp": { "seconds": 1666269863, "microseconds": 311222 } } +# "timestamp": { "seconds": 1666269863, +# "microseconds": 311222 } } # # .. qmp-example:: # # <- { "event": "NETDEV_STREAM_CONNECTED", # "data": { "netdev-id": "netdev0", -# "addr": { "path": "/tmp/qemu0", "type": "unix" } }, -# "timestamp": { "seconds": 1666269706, "microseconds": 413651 } } +# "addr": { "path": "/tmp/qemu0", +# "type": "unix" } }, +# "timestamp": { "seconds": 1666269706, +# "microseconds": 413651 } } ## { 'event': 'NETDEV_STREAM_CONNECTED', 'data': { 'netdev-id': 'str', @@ -1156,7 +1168,8 @@ # # <- { "event": "NETDEV_STREAM_DISCONNECTED", # "data": {"netdev-id": "netdev0"}, -# "timestamp": {"seconds": 1663330937, "microseconds": 526695} } +# "timestamp": {"seconds": 1663330937, +# "microseconds": 526695} } ## { 'event': 'NETDEV_STREAM_DISCONNECTED', 'data': { 'netdev-id': 'str' } } @@ -1174,7 +1187,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1739538638, "microseconds": 354181 }, +# <- { "timestamp": {"seconds": 1739538638, +# "microseconds": 354181 }, # "event": "NETDEV_VHOST_USER_CONNECTED", # "data": { "netdev-id": "netdev0", "chardev-id": "chr0" } } # @@ -1193,7 +1207,8 @@ # # .. qmp-example:: # -# <- { "timestamp": { "seconds": 1739538634, "microseconds": 920450 }, +# <- { "timestamp": { "seconds": 1739538634, +# "microseconds": 920450 }, # "event": "NETDEV_VHOST_USER_DISCONNECTED", # "data": { "netdev-id": "netdev0" } } # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192259; cv=none; d=zohomail.com; s=zohoarc; b=mPbjbtz/qPK8bmPuN28pRNLm+d8JJDdKbFHNDe4lPh3hFC/Hc9Ln8LZV+ZPnPK45RQoNZl/H7ehxk2HiSIXS5mqkV9RGRJDb1cSEazDWEQUjf77rQxOLOMfIbxXmcXBR0ZMrJYExJofdTIz92R1yV3q5AClw0fbLXiW/oKD4dSw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192259; 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=/q6rjoxdfB/1Xm73ZxRH85WAZxNcGltDxx8lvKX3FXI=; b=azYuIbrb6ser/s6E2p7U5haNf7UvQt2cNq7E5OhigUCJYJZE9iaB1LjvNO0dXr0uoSnq8kS6hOLXBTkqGR4c/iH+uS8BSoZNI6PAaBqqO6Z6bcpwO9zEr+v6QvQRWtdZ3izXfT2vbT5zvArXzQonpz0FfTkjTeK1IdGu2oohVGs= 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 1760192259026690.0806335846329; Sat, 11 Oct 2025 07:17:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8X-0006Wi-6e; Sat, 11 Oct 2025 09:59: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 1v7a7i-0006Hh-GK for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7U-0004kw-VS for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:02 -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 0E4EEC017E; Sat, 11 Oct 2025 16:58:16 +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-jI08XM7C; Sat, 11 Oct 2025 16:58:15 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191095; bh=/q6rjoxdfB/1Xm73ZxRH85WAZxNcGltDxx8lvKX3FXI=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=HOqN6UYW+8/hVC6CbhnTKueFh5WVx+dl4dHBWxlsEEuz9benNs+ssnCDWAEFg4QlQ AKjtFcSBxw3t8AlslM66cM2Ur8a4lH1cArAhPCJlFpD5b56Z6MFcHslzJb8ChFhhqt UTMrSu17vLMYdPN48wxCrWOgtywW0KQbzXZxNku0= 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, Paolo Bonzini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Eduardo Habkost Subject: [PATCH 19/33] qapi/qdev.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:17 +0300 Message-ID: <20251011135754.294521-37-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192262495158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/qdev.json | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/qapi/qdev.json b/qapi/qdev.json index e14a0c9259..9c4b498319 100644 --- a/qapi/qdev.json +++ b/qapi/qdev.json @@ -100,8 +100,8 @@ # process is signaled with a `DEVICE_DELETED` event. Guest reset # will automatically complete removal for all devices. If a # guest-side error in the hot removal process is detected, the -# device will not be removed and a `DEVICE_UNPLUG_GUEST_ERROR` event -# is sent. Some errors cannot be detected. +# device will not be removed and a `DEVICE_UNPLUG_GUEST_ERROR` +# event is sent. Some errors cannot be detected. # # Since: 0.14 # @@ -114,7 +114,8 @@ # .. qmp-example:: # # -> { "execute": "device_del", -# "arguments": { "id": "/machine/peripheral-anon/device[0]" } } +# "arguments": { +# "id": "/machine/peripheral-anon/device[0]" } } # <- { "return": {} } ## { 'command': 'device_del', 'data': {'id': 'str'} } @@ -138,7 +139,8 @@ # <- { "event": "DEVICE_DELETED", # "data": { "device": "virtio-net-pci-0", # "path": "/machine/peripheral/virtio-net-pci-0" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'DEVICE_DELETED', 'data': { '*device': 'str', 'path': 'str' } } @@ -160,7 +162,8 @@ # <- { "event": "DEVICE_UNPLUG_GUEST_ERROR", # "data": { "device": "core1", # "path": "/machine/peripheral/core1" }, -# "timestamp": { "seconds": 1615570772, "microseconds": 202844 } } +# "timestamp": { "seconds": 1615570772, +# "microseconds": 202844 } } ## { 'event': 'DEVICE_UNPLUG_GUEST_ERROR', 'data': { '*device': 'str', 'path': 'str' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191729; cv=none; d=zohomail.com; s=zohoarc; b=bwpYUuxvOQZiNt+QlWf8BVyoJgg4s5YcX8zWQr7HykXFcBPVD5vLT2jQwhtZ+LMLwABvpiJGfpuA5ZK3kY3tq7kSHxEn6ALr6EmwjDI/4mwMcRtm/umPoqSYh5eB42/Kb/PKqcsHe6f9ZR7y7OxK/ZgkQVv4oHvzqh7kcPFmjn4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191729; 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=/q6rjoxdfB/1Xm73ZxRH85WAZxNcGltDxx8lvKX3FXI=; b=Dwlfrx+vRpSkK5krrreWHL5f4VfC7TKT5OcWyU3fAWcBJOZy37Iq+YwZ0TyNrK/+dXD76LH67jCgmwAYRAWRTvefS4p9uCq+KULR8pXJ2O/Z62SzFYTcr5bixnurIINpTptDHNclegNu45OpVq8lmHe+zezXpumq9+9tpaSlv08= 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 1760191729579156.3833100157583; Sat, 11 Oct 2025 07:08:49 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8P-0006Ub-I4; Sat, 11 Oct 2025 09:59:45 -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 1v7a7j-0006Hi-Bs for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7U-0004kv-E4 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:03 -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 7F6DCC0180; Sat, 11 Oct 2025 16:58:16 +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-u5lAW2Oa; Sat, 11 Oct 2025 16:58:16 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191096; bh=/q6rjoxdfB/1Xm73ZxRH85WAZxNcGltDxx8lvKX3FXI=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=SEZ1A8qGnQMmMeI5ezt8FoSEr4ec8lU2xvhkpgbu31xzQCpIn7B/+lrwz4kToGoa1 +wIScZvWuV8cfaFYs7HoJgNNstyCSprpNH3EABiN/HptbJRnUb76fsip8qT8diYZAR jZEg+3GXXnoIqEHsDPNZ+H3FJ12q4s/pOiRnds9s= 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, Paolo Bonzini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Eduardo Habkost Subject: [PATCH 19/33] qapi/qdev.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:18 +0300 Message-ID: <20251011135754.294521-38-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191732366158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/qdev.json | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/qapi/qdev.json b/qapi/qdev.json index e14a0c9259..9c4b498319 100644 --- a/qapi/qdev.json +++ b/qapi/qdev.json @@ -100,8 +100,8 @@ # process is signaled with a `DEVICE_DELETED` event. Guest reset # will automatically complete removal for all devices. If a # guest-side error in the hot removal process is detected, the -# device will not be removed and a `DEVICE_UNPLUG_GUEST_ERROR` event -# is sent. Some errors cannot be detected. +# device will not be removed and a `DEVICE_UNPLUG_GUEST_ERROR` +# event is sent. Some errors cannot be detected. # # Since: 0.14 # @@ -114,7 +114,8 @@ # .. qmp-example:: # # -> { "execute": "device_del", -# "arguments": { "id": "/machine/peripheral-anon/device[0]" } } +# "arguments": { +# "id": "/machine/peripheral-anon/device[0]" } } # <- { "return": {} } ## { 'command': 'device_del', 'data': {'id': 'str'} } @@ -138,7 +139,8 @@ # <- { "event": "DEVICE_DELETED", # "data": { "device": "virtio-net-pci-0", # "path": "/machine/peripheral/virtio-net-pci-0" }, -# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } +# "timestamp": { "seconds": 1265044230, +# "microseconds": 450486 } } ## { 'event': 'DEVICE_DELETED', 'data': { '*device': 'str', 'path': 'str' } } @@ -160,7 +162,8 @@ # <- { "event": "DEVICE_UNPLUG_GUEST_ERROR", # "data": { "device": "core1", # "path": "/machine/peripheral/core1" }, -# "timestamp": { "seconds": 1615570772, "microseconds": 202844 } } +# "timestamp": { "seconds": 1615570772, +# "microseconds": 202844 } } ## { 'event': 'DEVICE_UNPLUG_GUEST_ERROR', 'data': { '*device': 'str', 'path': 'str' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192803; cv=none; d=zohomail.com; s=zohoarc; b=KbgxC+3b7Q+lpDbw+Z2hAdO41h0zhIFobptqxA+0fV5Q17/l/6B9KUmVdoctm4zdw+unDaJDUOdfVFShUAWCkHzaNuvr7YjWmMp7uU+nQqRZWahrzS4Eadk8Upd2dkrCWL8Y8wVQr/H56mZz15/CvEGski0iP5ExYwMY4vLoR6w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192803; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=83Si4n9Xifa8e3/o2G6/CFeqpWDDkQPsyg5kZnGHXPo=; b=SJVBbo0fg3/bw2dwvMLCd0A9ZkRhKfnh82a+xi2wiDDv+qETt0akY4N7pZ6Yh3bW49N8+jy086n99RV0yU3n6tzFGlc01hoxivf6SGgW++DgRyo9gG8owCdMkIaTVHfkGoGBLyqKU26Wo2xw6AK1QLyQUagOSEah0L+zjIGIGZo= 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 1760192803603331.4324000932247; Sat, 11 Oct 2025 07:26:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a93-00072n-5n; Sat, 11 Oct 2025 10:00:25 -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 1v7a7s-0006J2-AH for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:14 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7Z-0004lF-7W for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:10 -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 05D25C0181; Sat, 11 Oct 2025 16:58:17 +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-p0j0iPDo; Sat, 11 Oct 2025 16:58:16 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191096; bh=83Si4n9Xifa8e3/o2G6/CFeqpWDDkQPsyg5kZnGHXPo=; h=Cc:Message-ID:References:Date:In-Reply-To:Subject:To:From; b=BNvP1iIZwdQjL5geP+4/V3b9ObJGjxH4iQk5SR1MtqN90UywpToRfi316EsCNQNst OpR3MqiHpyE+Np6d3mwPg8fy/ZzvbDMOnzZEvadj3yBB+5h0/pOj9oR3o7yTSPM78/ 2RZK2mEXa5y+EYusdANS3eDJ0aCrvj0ek5oj3WkI= 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, Paolo Bonzini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Eduardo Habkost Subject: [PATCH 20/33] qapi/qom.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:19 +0300 Message-ID: <20251011135754.294521-39-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-Type: text/plain; charset="utf-8" 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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, 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: 1760192804191154100 Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/qom.json | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/qapi/qom.json b/qapi/qom.json index 830cb2ffe7..99cdd0f60c 100644 --- a/qapi/qom.json +++ b/qapi/qom.json @@ -52,7 +52,8 @@ # # @name: the name of the property. # -# @type: the type of the property, as described in `ObjectPropertyInfo`. +# @type: the type of the property, as described in +# `ObjectPropertyInfo`. # # @value: the value of the property. Absent when the property cannot # be read. @@ -92,9 +93,12 @@ # -> { "execute": "qom-list", # "arguments": { "path": "/chardevs" } } # <- { "return": [ { "name": "type", "type": "string" }, -# { "name": "parallel0", "type": "child" = }, -# { "name": "serial0", "type": "child" }, -# { "name": "mon0", "type": "child" } = ] } +# { "name": "parallel0", "type": +# "child" }, +# { "name": "serial0", "type": "child" }, +# { "name": "mon0", "type": "child" } ] } ## { 'command': 'qom-list', 'data': { 'path': 'str' }, @@ -1082,7 +1086,8 @@ # Authentication Information Structure' for the SNP_LAUNCH_FINISH # command defined in the SEV-SNP firmware ABI (default: all-zero) # -# @author-key-enabled: true if 'id-auth' blob contains the 'AUTHOR_KEY' +# @author-key-enabled: true if 'id-auth' blob contains the +# 'AUTHOR_KEY' # field defined SEV-SNP firmware ABI (default: false) # # @host-data: 32-byte, base64-encoded, user-defined blob to provide to @@ -1117,17 +1122,17 @@ # @attributes: The 'attributes' of a TD guest that is passed to # KVM_TDX_INIT_VM # -# @sept-ve-disable: toggle bit 28 of TD attributes to control disabling -# of EPT violation conversion to #VE on guest TD access of PENDING -# pages. Some guest OS (e.g., Linux TD guest) may require this to -# be set, otherwise they refuse to boot. +# @sept-ve-disable: toggle bit 28 of TD attributes to control +# disabling of EPT violation conversion to #VE on guest TD access +# of PENDING pages. Some guest OS (e.g., Linux TD guest) may +# require this to be set, otherwise they refuse to boot. # # @mrconfigid: ID for non-owner-defined configuration of the guest TD, -# e.g., run-time or OS configuration (base64 encoded SHA384 digest). -# Defaults to all zeros. +# e.g., run-time or OS configuration (base64 encoded SHA384 +# digest). Defaults to all zeros. # -# @mrowner: ID for the guest TD=E2=80=99s owner (base64 encoded SHA384 dig= est). -# Defaults to all zeros. +# @mrowner: ID for the guest TD=E2=80=99s owner (base64 encoded SHA384 +# digest). Defaults to all zeros. # # @mrownerconfig: ID for owner-defined configuration of the guest TD, # e.g., specific to the workload rather than the run-time or OS --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191597; cv=none; d=zohomail.com; s=zohoarc; b=KU/M3iRnMD1HfIX+EMGZN8EVrVW7zutBy3mF0veGCbdUBFeIG+E4s6i901Jt2Do5Jzp6EruXOCPJRZUVFgjdwgbWx4Yif6jufJa+KSmciTxVRz1UANXq7w14O0GaDq6+vivtKCGiPiHEe/GeMUJSqO3DXPl3O/dvJTO3oYHuOsE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191597; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=83Si4n9Xifa8e3/o2G6/CFeqpWDDkQPsyg5kZnGHXPo=; b=gdBvOyrzH5xqLgolXQ4MgjaFAa7KOe4UxAtG2X19CgJsxx/co90zc41DxgP2h3dzu9jpwztD4LXMmMbmBBq1fe0qdCdHK2XIpv9QcmNVxPb3EtaBG2EbQyeRMhtXZHA816IahtghGorPi9KJvUliQiph9C3j2ea18llw0fDrqRg= 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 1760191597570835.1606860609933; Sat, 11 Oct 2025 07:06:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a85-0006NP-W1; Sat, 11 Oct 2025 09:59:26 -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 1v7a7s-0006J9-DD for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:14 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7X-0004lG-Ep for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:11 -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 7A77CC0182; Sat, 11 Oct 2025 16:58:17 +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-GCfTdvn5; Sat, 11 Oct 2025 16:58:17 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191097; bh=83Si4n9Xifa8e3/o2G6/CFeqpWDDkQPsyg5kZnGHXPo=; h=Cc:Message-ID:References:Date:In-Reply-To:Subject:To:From; b=bX+V2w+F760alYzl/e1pjD2r0n64XZLIJBvuloM6jng7LyIOR5f4YOqe61s7UIOYp E8iaG4ESW6+aN6ynDK6iEgBw7sw90BX2jZ2p4WiN7taI8YL6g2FIEMWKTJ1RI1Qgr1 QegjYZRWDUzJ4SQojbMX4oA/Q9sYXkSuBpG7Y9Oc= 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, Paolo Bonzini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Eduardo Habkost Subject: [PATCH 20/33] qapi/qom.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:20 +0300 Message-ID: <20251011135754.294521-40-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-Type: text/plain; charset="utf-8" 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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191598871158501 Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/qom.json | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/qapi/qom.json b/qapi/qom.json index 830cb2ffe7..99cdd0f60c 100644 --- a/qapi/qom.json +++ b/qapi/qom.json @@ -52,7 +52,8 @@ # # @name: the name of the property. # -# @type: the type of the property, as described in `ObjectPropertyInfo`. +# @type: the type of the property, as described in +# `ObjectPropertyInfo`. # # @value: the value of the property. Absent when the property cannot # be read. @@ -92,9 +93,12 @@ # -> { "execute": "qom-list", # "arguments": { "path": "/chardevs" } } # <- { "return": [ { "name": "type", "type": "string" }, -# { "name": "parallel0", "type": "child" = }, -# { "name": "serial0", "type": "child" }, -# { "name": "mon0", "type": "child" } = ] } +# { "name": "parallel0", "type": +# "child" }, +# { "name": "serial0", "type": "child" }, +# { "name": "mon0", "type": "child" } ] } ## { 'command': 'qom-list', 'data': { 'path': 'str' }, @@ -1082,7 +1086,8 @@ # Authentication Information Structure' for the SNP_LAUNCH_FINISH # command defined in the SEV-SNP firmware ABI (default: all-zero) # -# @author-key-enabled: true if 'id-auth' blob contains the 'AUTHOR_KEY' +# @author-key-enabled: true if 'id-auth' blob contains the +# 'AUTHOR_KEY' # field defined SEV-SNP firmware ABI (default: false) # # @host-data: 32-byte, base64-encoded, user-defined blob to provide to @@ -1117,17 +1122,17 @@ # @attributes: The 'attributes' of a TD guest that is passed to # KVM_TDX_INIT_VM # -# @sept-ve-disable: toggle bit 28 of TD attributes to control disabling -# of EPT violation conversion to #VE on guest TD access of PENDING -# pages. Some guest OS (e.g., Linux TD guest) may require this to -# be set, otherwise they refuse to boot. +# @sept-ve-disable: toggle bit 28 of TD attributes to control +# disabling of EPT violation conversion to #VE on guest TD access +# of PENDING pages. Some guest OS (e.g., Linux TD guest) may +# require this to be set, otherwise they refuse to boot. # # @mrconfigid: ID for non-owner-defined configuration of the guest TD, -# e.g., run-time or OS configuration (base64 encoded SHA384 digest). -# Defaults to all zeros. +# e.g., run-time or OS configuration (base64 encoded SHA384 +# digest). Defaults to all zeros. # -# @mrowner: ID for the guest TD=E2=80=99s owner (base64 encoded SHA384 dig= est). -# Defaults to all zeros. +# @mrowner: ID for the guest TD=E2=80=99s owner (base64 encoded SHA384 +# digest). Defaults to all zeros. # # @mrownerconfig: ID for owner-defined configuration of the guest TD, # e.g., specific to the workload rather than the run-time or OS --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192737; cv=none; d=zohomail.com; s=zohoarc; b=DTJo1acHAQc3fj1I3l/j3zUkKtLMsMdL8mIcIhT6Peyx1ChdX7SYJFdXtOWNCGd574R/6L1Cb9wekXTJuKzwfeIT1MRiEiCAX0JwzM94E1Bk3QRai059K4ebRAtFG2lG+8pBTeP1qdwsFH0bpDR1s79wnAgVH627kFc1VoyuJ00= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192737; 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=IB5WctOaaDS5QjV9UsCfoJSKTXKFLtlmFJsXAiDAbRw=; b=Lnw8cbFPigRXHesSCsa3vxW40Q5n0Yo9lOK9xKSe116QfAcbnjYVxPn5beHaaAHHYMRK6gL+H1RYza+j6Cm95vzr7/3oiGmbnmgGjVMz8xG8vvuyX2XvKEaS2TtrlqN6HhZQeQphzyn+uLSjy9x7RJJkKA4G0s+osU4b6rv2A+A= 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 1760192737771683.360464952428; Sat, 11 Oct 2025 07:25:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8H-0006RV-87; Sat, 11 Oct 2025 09:59:37 -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 1v7a7m-0006Ic-UT for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:09 -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 1v7a7W-0004lK-LH for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:06 -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 75183C0186; Sat, 11 Oct 2025 16:58:18 +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-Jp0luZXp; Sat, 11 Oct 2025 16:58:18 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191098; bh=IB5WctOaaDS5QjV9UsCfoJSKTXKFLtlmFJsXAiDAbRw=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=J+c+pozX4909M0LTzfphx387wLmsd2IAQNAevdUEYPcyT/uHIGUly56pOOOfqf93q 1ngEY9y1GyV5vItCPIWpgYC3Z8MRGQ97OHJ6IRuwQsj8YOCd7IGcPyuo1o9O/g4Lp8 rwcxzDMdndksi8J0xT4uWVNHEEjossHoLjdQwaV8= 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, Paolo Bonzini , =?UTF-8?q?Alex=20Benn=C3=A9e?= Subject: [PATCH 21/33] qapi/replay.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:22 +0300 Message-ID: <20251011135754.294521-42-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192740022158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/replay.json | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/qapi/replay.json b/qapi/replay.json index ccf84da68e..0f1398e9b6 100644 --- a/qapi/replay.json +++ b/qapi/replay.json @@ -59,7 +59,8 @@ # .. qmp-example:: # # -> { "execute": "query-replay" } -# <- { "return": { "mode": "play", "filename": "log.rr", "icount": 220= 414 } } +# <- { "return": { "mode": "play", "filename": "log.rr", +# "icount": 220414 } } ## { 'command': 'query-replay', 'returns': 'ReplayInfo' } @@ -80,7 +81,8 @@ # # .. qmp-example:: # -# -> { "execute": "replay-break", "arguments": { "icount": 220414 } } +# -> { "execute": "replay-break", +# "arguments": { "icount": 220414 } } # <- { "return": {} } ## { 'command': 'replay-break', 'data': { 'icount': 'int' } } @@ -116,7 +118,8 @@ # # .. qmp-example:: # -# -> { "execute": "replay-seek", "arguments": { "icount": 220414 } } +# -> { "execute": "replay-seek", +# "arguments": { "icount": 220414 } } # <- { "return": {} } ## { 'command': 'replay-seek', 'data': { 'icount': 'int' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192711; cv=none; d=zohomail.com; s=zohoarc; b=A1nosmVxJy8BL+Gzos9voqj9qBq3pL/MVLy6hc5sgdQbQ9dmvP+fvOWCXry8DO6tjrTOq7h6RNkcWULohtuu63VQEhVlsB+TVZ4UApu+oBNjztbzI97lY4zqwN1Yur2yn80mdMYoDohe/glYFbu+MoaTjW9ftmQy9KwmysTog2c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192711; 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=IB5WctOaaDS5QjV9UsCfoJSKTXKFLtlmFJsXAiDAbRw=; b=IavzBhSHvFNGUX8JqCy5rC37OuV8TzHPQpXI9Hv9MVFVbEnqeR6gWFrD9TvtBhn54wKjslVoeS/dVPn/EBAk0jQayjlNo9FivKnz5JdtEMMLyjaHlJABCdeR/b658mpSpUS6OcT5cxmEVxqYhvhsKbjTpC123Yjh8X6oL2yzkFE= 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 1760192711073593.1738970128097; Sat, 11 Oct 2025 07:25:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a93-00072m-6b; Sat, 11 Oct 2025 10:00:25 -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 1v7a7p-0006Il-Ad for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:14 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7X-0004lL-W0 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:08 -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 F09C4C0183; Sat, 11 Oct 2025 16:58:17 +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-0IBV8t43; Sat, 11 Oct 2025 16:58:17 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191097; bh=IB5WctOaaDS5QjV9UsCfoJSKTXKFLtlmFJsXAiDAbRw=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=BGC3XI3pY/+XtiCrsOViV1CH9Yzzm3kxn8cpzfAfrX5XOKxb0vyNx6K08LQsN0+Lp zKB7y0PhzvHU6RC+s/uK+mIJtokS+1gj9CVNJEeDGSUcSDFdETdMppXTDwwH3/mfa3 ngi7zbe6Uf+QLr09zu8GebdHW07Jjxhn28zSLBrk= 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, Paolo Bonzini , =?UTF-8?q?Alex=20Benn=C3=A9e?= Subject: [PATCH 21/33] qapi/replay.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:21 +0300 Message-ID: <20251011135754.294521-41-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192713073154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/replay.json | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/qapi/replay.json b/qapi/replay.json index ccf84da68e..0f1398e9b6 100644 --- a/qapi/replay.json +++ b/qapi/replay.json @@ -59,7 +59,8 @@ # .. qmp-example:: # # -> { "execute": "query-replay" } -# <- { "return": { "mode": "play", "filename": "log.rr", "icount": 220= 414 } } +# <- { "return": { "mode": "play", "filename": "log.rr", +# "icount": 220414 } } ## { 'command': 'query-replay', 'returns': 'ReplayInfo' } @@ -80,7 +81,8 @@ # # .. qmp-example:: # -# -> { "execute": "replay-break", "arguments": { "icount": 220414 } } +# -> { "execute": "replay-break", +# "arguments": { "icount": 220414 } } # <- { "return": {} } ## { 'command': 'replay-break', 'data': { 'icount': 'int' } } @@ -116,7 +118,8 @@ # # .. qmp-example:: # -# -> { "execute": "replay-seek", "arguments": { "icount": 220414 } } +# -> { "execute": "replay-seek", +# "arguments": { "icount": 220414 } } # <- { "return": {} } ## { 'command': 'replay-seek', 'data': { 'icount': 'int' } } --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192674; cv=none; d=zohomail.com; s=zohoarc; b=aXGTZZOFiF+uZnU3bJg+zSkZZoa6mzoyxa3t284WBZ9uK7/seajIFL4R1iHRgj/Ty2d7KWzOEMyQDLIhNgyBiU9Sy385Yeng1ukGOaX0kUAyKpgXx7cvgygFZcHHyBg7+QD5YxX3FOmJ5zydgplOGNyuclqUYaaaK4SCgjwaCTA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192674; 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=Pr3uaR7nVBEcKHlMi3k1Ky1Na2jMyU9B8ylURYPa8/g=; b=RAQwSkmh+GsMs13Q+IkLH7dxB2HU/GpKf7JSfq+K55MowJ++sHPveP/6MHA7C5Jx/LRmxwAGntMZjgkQizq4ia9fYinqhRmptxKqC39Mp/QcN4CquhS3lby4ck3o1Q+SuzmDK9U15r6MCvpNgp1XZ2quu/4iS4NbAgLlqQrrMDE= 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 1760192674273112.22563233562119; Sat, 11 Oct 2025 07:24:34 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8D-0006RB-T0; Sat, 11 Oct 2025 09:59:34 -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 1v7a7s-0006JA-HQ for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:14 -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 1v7a7V-0004lX-Uk for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:12 -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 67D2FC0187; Sat, 11 Oct 2025 16:58:19 +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-CogJkkIv; Sat, 11 Oct 2025 16:58:19 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191099; bh=Pr3uaR7nVBEcKHlMi3k1Ky1Na2jMyU9B8ylURYPa8/g=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=mJ0MYAY7FUJplkoFqu+Jc6Qs3zUyuUVcS0QimIHVAelkL6FC1pBt2jXezMxrtxMOj 1Zqd9ePJixyI8sw1C5TVsI/0nXLpsv3YJqtjVtHq8WQEYT5btQP430vh9XCgS4NBzP ALqQcnfGZHFLLNC3Rp6zHpZ5eQfpkHwbXuBElfh8= 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, Jiri Pirko Subject: [PATCH 22/33] qapi/rocker.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:24 +0300 Message-ID: <20251011135754.294521-44-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_HELO_NONE=0.001, T_SPF_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: 1760192677370158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/rocker.json | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/qapi/rocker.json b/qapi/rocker.json index 5d2dbd2603..0b211d787e 100644 --- a/qapi/rocker.json +++ b/qapi/rocker.json @@ -102,11 +102,16 @@ # # .. qmp-example:: # -# -> { "execute": "query-rocker-ports", "arguments": { "name": "sw1" }= } -# <- { "return": [ {"duplex": "full", "enabled": true, "name": "sw1.1", -# "autoneg": "off", "link-up": true, "speed": 10000}, -# {"duplex": "full", "enabled": true, "name": "sw1.2", -# "autoneg": "off", "link-up": true, "speed": 10000} +# -> { "execute": "query-rocker-ports", "arguments": { "name": +# "sw1" } } +# <- { "return": [ {"duplex": "full", "enabled": true, "name": +# "sw1.1", +# "autoneg": "off", "link-up": true, "speed": +# 10000}, +# {"duplex": "full", "enabled": true, "name": +# "sw1.2", +# "autoneg": "off", "link-up": true, "speed": +# 10000} # ]} ## { 'command': 'query-rocker-ports', @@ -246,7 +251,8 @@ # # -> { "execute": "query-rocker-of-dpa-flows", # "arguments": { "name": "sw1" } } -# <- { "return": [ {"key": {"in-pport": 0, "priority": 1, "tbl-id": 0}, +# <- { "return": [ {"key": { "in-pport": 0, "priority": 1, +# "tbl-id": 0}, # "hits": 138, # "cookie": 0, # "action": {"goto-tbl": 10}, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191617; cv=none; d=zohomail.com; s=zohoarc; b=EZLlc4uNHCF5rOEPGT1glmHsqZ8S/iqusP9ckMjnXUZdYxugxj78KXqrMuy4TWmKID8ILOuJK0pIfNa9cFcdVBNUMpmXxmWQF7VWcWFWoRAJJfG/Ko/5Oh2EhQ5RKLnrKenFOOR0upxS0lFxfo0C2/KtWNz46b+a9nLKHT1/Vq8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191617; 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=Pr3uaR7nVBEcKHlMi3k1Ky1Na2jMyU9B8ylURYPa8/g=; b=f4uk+Py7K9mulB4Oxa0YsV9oRAhHBIsWivOmWIh3CuJ5EWc9Ndt8yq4M21sJhJxpNiqWLazW5wW2ChONSWyqQ+H6dPaXJ/lWaWtVvxEjK8N/ZkFD3cKfvDUvE19skEJT54Rl4gqfPqo8BY6Z4+IWa47z8j5du7UMXiVc399MwzE= 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 1760191617978137.0254714605553; Sat, 11 Oct 2025 07:06:57 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8C-0006QZ-GP; Sat, 11 Oct 2025 09:59:32 -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 1v7a7l-0006Hl-9d for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:05 -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 1v7a7W-0004lW-US for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:04 -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 0062CC0185; Sat, 11 Oct 2025 16:58:19 +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-ydRg3cVa; Sat, 11 Oct 2025 16:58:18 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191098; bh=Pr3uaR7nVBEcKHlMi3k1Ky1Na2jMyU9B8ylURYPa8/g=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=u9hYk32YGI8AsZJjTct8evSqCDIz8VT1OBUPLGrKgPJHl3pxlvGslOZCGE/0eTfZJ qu1UgMtf9gWi6Wkt5Yd2kSzE+0gDVVHxT16R7XUiDgXf91qo5Jo+736BIJvOx0oJHA LUrwdhVCjfK41kUgTzTUPNeK0Gs70KES9sIQtFBo= 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, Jiri Pirko Subject: [PATCH 22/33] qapi/rocker.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:23 +0300 Message-ID: <20251011135754.294521-43-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191620449154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/rocker.json | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/qapi/rocker.json b/qapi/rocker.json index 5d2dbd2603..0b211d787e 100644 --- a/qapi/rocker.json +++ b/qapi/rocker.json @@ -102,11 +102,16 @@ # # .. qmp-example:: # -# -> { "execute": "query-rocker-ports", "arguments": { "name": "sw1" }= } -# <- { "return": [ {"duplex": "full", "enabled": true, "name": "sw1.1", -# "autoneg": "off", "link-up": true, "speed": 10000}, -# {"duplex": "full", "enabled": true, "name": "sw1.2", -# "autoneg": "off", "link-up": true, "speed": 10000} +# -> { "execute": "query-rocker-ports", "arguments": { "name": +# "sw1" } } +# <- { "return": [ {"duplex": "full", "enabled": true, "name": +# "sw1.1", +# "autoneg": "off", "link-up": true, "speed": +# 10000}, +# {"duplex": "full", "enabled": true, "name": +# "sw1.2", +# "autoneg": "off", "link-up": true, "speed": +# 10000} # ]} ## { 'command': 'query-rocker-ports', @@ -246,7 +251,8 @@ # # -> { "execute": "query-rocker-of-dpa-flows", # "arguments": { "name": "sw1" } } -# <- { "return": [ {"key": {"in-pport": 0, "priority": 1, "tbl-id": 0}, +# <- { "return": [ {"key": { "in-pport": 0, "priority": 1, +# "tbl-id": 0}, # "hits": 138, # "cookie": 0, # "action": {"goto-tbl": 10}, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191730; cv=none; d=zohomail.com; s=zohoarc; b=HitxH8W6bXp8rNxBw4/eNgR4f4oYxUAB/7klbidbky5vNwzcTvi/p4Z2Jm+tj0VhnzwfCuopHXMSWTnfmcEduFBcyVS+2V1hOpsLZ46sGuOJhAIcMOoeN6mSC9DgYTuU1b16ceUCrd03E5STRqPdQr7WJwC1AMklIev4Mc6w6N8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191730; 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=cqJGFcUL6Rzua6pAruHETR88Uz0MgIGITTJfyEQeeIA=; b=mLhEI3tXTlxypunYnszHrLbOqRwNKnwvg/kwTi/rUhSDhdBsfsOwkNMMN4AAPR7F8CjS2JlGCudiWeQdvxRHBCZNoDDw2hQTelM0Z6okq5U9Ev/G4H5WJJpZcKbtGSc/NiO2mWm64OC8BARQssFAgAFezXmxfWLR3w2NQ16Mv2w= 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 1760191730615940.8377782518246; Sat, 11 Oct 2025 07:08:50 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a95-00073j-VA; Sat, 11 Oct 2025 10:00:28 -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 1v7a7u-0006K2-Rd for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:16 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7Z-0004lp-6i for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:14 -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 E832FC0189; Sat, 11 Oct 2025 16:58:19 +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-Je3KqKLW; Sat, 11 Oct 2025 16:58:19 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191099; bh=cqJGFcUL6Rzua6pAruHETR88Uz0MgIGITTJfyEQeeIA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=JXJuE8DjPxwPhl3q3RzYTyTe9jFI1z6f51vr2dtcJ1eM1GLxbaGHk06Ll0d3BUXXS tQdgjhtqfmFsH9qwLgkriGDKGQ+xSH9Y+X0SvGdG4ROMIMAw4Rkg+wa4lsd4b9THKA Iwj0c+7OJ9NailfklLrE92oo8OpQDKxpEKgSFlYA= 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, Paolo Bonzini Subject: [PATCH 23/33] qapi/run-state.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:25 +0300 Message-ID: <20251011135754.294521-45-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760191731731154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/run-state.json | 60 ++++++++++++++++++++++++++++----------------- 1 file changed, 37 insertions(+), 23 deletions(-) diff --git a/qapi/run-state.json b/qapi/run-state.json index 4757947ca6..b72fbf2579 100644 --- a/qapi/run-state.json +++ b/qapi/run-state.json @@ -156,7 +156,8 @@ # # <- { "event": "SHUTDOWN", # "data": { "guest": true, "reason": "guest-shutdown" }, -# "timestamp": { "seconds": 1267040730, "microseconds": 682951 } } +# "timestamp": { "seconds": 1267040730, +# "microseconds": 682951 } } ## { 'event': 'SHUTDOWN', 'data': { 'guest': 'bool', 'reason': 'ShutdownCause= ' } } =20 @@ -171,7 +172,8 @@ # .. qmp-example:: # # <- { "event": "POWERDOWN", -# "timestamp": { "seconds": 1267040730, "microseconds": 682951 } } +# "timestamp": { "seconds": 1267040730, +# "microseconds": 682951 } } ## { 'event': 'POWERDOWN' } =20 @@ -193,7 +195,8 @@ # # <- { "event": "RESET", # "data": { "guest": false, "reason": "guest-reset" }, -# "timestamp": { "seconds": 1267041653, "microseconds": 9518 } } +# "timestamp": { "seconds": 1267041653, +# "microseconds": 9518 } } ## { 'event': 'RESET', 'data': { 'guest': 'bool', 'reason': 'ShutdownCause' }= } =20 @@ -207,7 +210,8 @@ # .. qmp-example:: # # <- { "event": "STOP", -# "timestamp": { "seconds": 1267041730, "microseconds": 281295 } } +# "timestamp": { "seconds": 1267041730, +# "microseconds": 281295 } } ## { 'event': 'STOP' } =20 @@ -221,7 +225,8 @@ # .. qmp-example:: # # <- { "event": "RESUME", -# "timestamp": { "seconds": 1271770767, "microseconds": 582542 } } +# "timestamp": { "seconds": 1271770767, +# "microseconds": 582542 } } ## { 'event': 'RESUME' } =20 @@ -236,7 +241,8 @@ # .. qmp-example:: # # <- { "event": "SUSPEND", -# "timestamp": { "seconds": 1344456160, "microseconds": 309119 } } +# "timestamp": { "seconds": 1344456160, +# "microseconds": 309119 } } ## { 'event': 'SUSPEND' } =20 @@ -247,15 +253,16 @@ # saved on disk, for example, S4 state, which is sometimes called # hibernate state # -# .. note:: QEMU shuts down (similar to event `SHUTDOWN`) when entering -# this state. +# .. note:: QEMU shuts down (similar to event `SHUTDOWN`) when +# entering this state. # # Since: 1.2 # # .. qmp-example:: # # <- { "event": "SUSPEND_DISK", -# "timestamp": { "seconds": 1344456160, "microseconds": 309119 } } +# "timestamp": { "seconds": 1344456160, +# "microseconds": 309119 } } ## { 'event': 'SUSPEND_DISK' } =20 @@ -270,7 +277,8 @@ # .. qmp-example:: # # <- { "event": "WAKEUP", -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } ## { 'event': 'WAKEUP' } =20 @@ -281,9 +289,9 @@ # # @action: action that has been taken # -# .. note:: If action is "reset", "shutdown", or "pause" the `WATCHDOG` -# event is followed respectively by the `RESET`, `SHUTDOWN`, or `STOP` -# events. +# .. note:: If action is "reset", "shutdown", or "pause" the +# `WATCHDOG` event is followed respectively by the `RESET`, +# `SHUTDOWN`, or `STOP` events. # # .. note:: This event is rate-limited. # @@ -293,7 +301,8 @@ # # <- { "event": "WATCHDOG", # "data": { "action": "reset" }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'WATCHDOG', 'data': { 'action': 'WatchdogAction' } } @@ -402,7 +411,8 @@ # # @panic: `PanicAction` action taken on guest panic. # -# @watchdog: `WatchdogAction` action taken when watchdog timer expires. +# @watchdog: `WatchdogAction` action taken when watchdog timer +# expires. # # Since: 6.0 # @@ -437,7 +447,8 @@ # # <- { "event": "GUEST_PANICKED", # "data": { "action": "pause" }, -# "timestamp": { "seconds": 1648245231, "microseconds": 900001 } } +# "timestamp": { "seconds": 1648245231, +# "microseconds": 900001 } } ## { 'event': 'GUEST_PANICKED', 'data': { 'action': 'GuestPanicAction', '*info': 'GuestPanicInformation'= } } @@ -457,7 +468,8 @@ # # <- { "event": "GUEST_CRASHLOADED", # "data": { "action": "run" }, -# "timestamp": { "seconds": 1648245259, "microseconds": 893771 } } +# "timestamp": { "seconds": 1648245259, +# "microseconds": 893771 } } ## { 'event': 'GUEST_CRASHLOADED', 'data': { 'action': 'GuestPanicAction', '*info': 'GuestPanicInformation'= } } @@ -472,7 +484,8 @@ # .. qmp-example:: # # <- { "event": "GUEST_PVSHUTDOWN", -# "timestamp": { "seconds": 1648245259, "microseconds": 893771 } } +# "timestamp": { "seconds": 1648245259, +# "microseconds": 893771 } } ## { 'event': 'GUEST_PVSHUTDOWN' } =20 @@ -542,8 +555,8 @@ # @arg4: for Windows, third argument of the `STOP`. For Linux, the # RAX register (x86) or the stack pointer (aarch64) of the guest. # -# @arg5: for Windows, fourth argument of the `STOP`. For x86 Linux, the -# stack pointer of the guest. +# @arg5: for Windows, fourth argument of the `STOP`. For x86 Linux, +# the stack pointer of the guest. # # Since: 2.9 ## @@ -610,7 +623,7 @@ # # @error-code: TD-specific error code # -# @message: Human-readable error message provided by the guest. Not +# @message: Human-readable error message provided by the guest. Not # to be trusted. # # @gpa: guest-physical address of a page that contains more verbose @@ -644,8 +657,9 @@ # "data": { "recipient": "hypervisor", # "action": "fatal", # "flags": { "action-required": false, -# "recursive": false } }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "recursive": false } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'MEMORY_FAILURE', 'data': { 'recipient': 'MemoryFailureRecipient', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192360; cv=none; d=zohomail.com; s=zohoarc; b=YmXpVcTWqCxDVfKJPioy5mSmYZNiN0EdMqYso/1olHX1neEdYj5gux3znAANYGuxUOwzTq4XU91WFDLlCjyfR/WPhcrSoCQJ9OnXEskaZfrd+0iWA+SPhltpKQEEk1Wh1DfLDzWTo8u6t2ZT0n4CfrsX0lk24DCWCAXmQsuEMF4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192360; 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=cqJGFcUL6Rzua6pAruHETR88Uz0MgIGITTJfyEQeeIA=; b=O2S+n6gQThWjc1Vk30xSnw5PU+HKfiSbFHlOA+x9nYYhFwQbi6kZGuAbJmDX4qvwgewmMIhL1TyNwXXPHQTXEbJqxGr0Zq20EPfUMnHwAxBJJZnTOo8c/bf9Cfd+5qC5yRbXfeXxJ5pgy6rwZPNySUUFrkAgqXlOedRTFokQbYY= 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 17601923604791002.0267037950429; Sat, 11 Oct 2025 07:19:20 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a86-0006Nq-VD; Sat, 11 Oct 2025 09:59:28 -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 1v7a7w-0006K5-Cu for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:17 -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 1v7a7Z-0004lo-5R for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:15 -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 77C0BC018B; Sat, 11 Oct 2025 16:58:20 +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-eAXfuh7z; Sat, 11 Oct 2025 16:58:20 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191100; bh=cqJGFcUL6Rzua6pAruHETR88Uz0MgIGITTJfyEQeeIA=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=mn/rwx/y/F2M30V0ToFQ/9MGisnmzocxjCsCkq0ofITtkSzPr6NSAoQyTjrC8WHlE Q7R/PQ72yoINSezifwuvbZIkgG4kWuZiLnGgEemiYWClTvu1+usMDu+/osrCqAYz9H Fpcfo7viythP29sQhOf9GmlIgF8o/lk7aSLLk5oY= 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, Paolo Bonzini Subject: [PATCH 23/33] qapi/run-state.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:26 +0300 Message-ID: <20251011135754.294521-46-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192363217154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/run-state.json | 60 ++++++++++++++++++++++++++++----------------- 1 file changed, 37 insertions(+), 23 deletions(-) diff --git a/qapi/run-state.json b/qapi/run-state.json index 4757947ca6..b72fbf2579 100644 --- a/qapi/run-state.json +++ b/qapi/run-state.json @@ -156,7 +156,8 @@ # # <- { "event": "SHUTDOWN", # "data": { "guest": true, "reason": "guest-shutdown" }, -# "timestamp": { "seconds": 1267040730, "microseconds": 682951 } } +# "timestamp": { "seconds": 1267040730, +# "microseconds": 682951 } } ## { 'event': 'SHUTDOWN', 'data': { 'guest': 'bool', 'reason': 'ShutdownCause= ' } } =20 @@ -171,7 +172,8 @@ # .. qmp-example:: # # <- { "event": "POWERDOWN", -# "timestamp": { "seconds": 1267040730, "microseconds": 682951 } } +# "timestamp": { "seconds": 1267040730, +# "microseconds": 682951 } } ## { 'event': 'POWERDOWN' } =20 @@ -193,7 +195,8 @@ # # <- { "event": "RESET", # "data": { "guest": false, "reason": "guest-reset" }, -# "timestamp": { "seconds": 1267041653, "microseconds": 9518 } } +# "timestamp": { "seconds": 1267041653, +# "microseconds": 9518 } } ## { 'event': 'RESET', 'data': { 'guest': 'bool', 'reason': 'ShutdownCause' }= } =20 @@ -207,7 +210,8 @@ # .. qmp-example:: # # <- { "event": "STOP", -# "timestamp": { "seconds": 1267041730, "microseconds": 281295 } } +# "timestamp": { "seconds": 1267041730, +# "microseconds": 281295 } } ## { 'event': 'STOP' } =20 @@ -221,7 +225,8 @@ # .. qmp-example:: # # <- { "event": "RESUME", -# "timestamp": { "seconds": 1271770767, "microseconds": 582542 } } +# "timestamp": { "seconds": 1271770767, +# "microseconds": 582542 } } ## { 'event': 'RESUME' } =20 @@ -236,7 +241,8 @@ # .. qmp-example:: # # <- { "event": "SUSPEND", -# "timestamp": { "seconds": 1344456160, "microseconds": 309119 } } +# "timestamp": { "seconds": 1344456160, +# "microseconds": 309119 } } ## { 'event': 'SUSPEND' } =20 @@ -247,15 +253,16 @@ # saved on disk, for example, S4 state, which is sometimes called # hibernate state # -# .. note:: QEMU shuts down (similar to event `SHUTDOWN`) when entering -# this state. +# .. note:: QEMU shuts down (similar to event `SHUTDOWN`) when +# entering this state. # # Since: 1.2 # # .. qmp-example:: # # <- { "event": "SUSPEND_DISK", -# "timestamp": { "seconds": 1344456160, "microseconds": 309119 } } +# "timestamp": { "seconds": 1344456160, +# "microseconds": 309119 } } ## { 'event': 'SUSPEND_DISK' } =20 @@ -270,7 +277,8 @@ # .. qmp-example:: # # <- { "event": "WAKEUP", -# "timestamp": { "seconds": 1344522075, "microseconds": 745528 } } +# "timestamp": { "seconds": 1344522075, +# "microseconds": 745528 } } ## { 'event': 'WAKEUP' } =20 @@ -281,9 +289,9 @@ # # @action: action that has been taken # -# .. note:: If action is "reset", "shutdown", or "pause" the `WATCHDOG` -# event is followed respectively by the `RESET`, `SHUTDOWN`, or `STOP` -# events. +# .. note:: If action is "reset", "shutdown", or "pause" the +# `WATCHDOG` event is followed respectively by the `RESET`, +# `SHUTDOWN`, or `STOP` events. # # .. note:: This event is rate-limited. # @@ -293,7 +301,8 @@ # # <- { "event": "WATCHDOG", # "data": { "action": "reset" }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'WATCHDOG', 'data': { 'action': 'WatchdogAction' } } @@ -402,7 +411,8 @@ # # @panic: `PanicAction` action taken on guest panic. # -# @watchdog: `WatchdogAction` action taken when watchdog timer expires. +# @watchdog: `WatchdogAction` action taken when watchdog timer +# expires. # # Since: 6.0 # @@ -437,7 +447,8 @@ # # <- { "event": "GUEST_PANICKED", # "data": { "action": "pause" }, -# "timestamp": { "seconds": 1648245231, "microseconds": 900001 } } +# "timestamp": { "seconds": 1648245231, +# "microseconds": 900001 } } ## { 'event': 'GUEST_PANICKED', 'data': { 'action': 'GuestPanicAction', '*info': 'GuestPanicInformation'= } } @@ -457,7 +468,8 @@ # # <- { "event": "GUEST_CRASHLOADED", # "data": { "action": "run" }, -# "timestamp": { "seconds": 1648245259, "microseconds": 893771 } } +# "timestamp": { "seconds": 1648245259, +# "microseconds": 893771 } } ## { 'event': 'GUEST_CRASHLOADED', 'data': { 'action': 'GuestPanicAction', '*info': 'GuestPanicInformation'= } } @@ -472,7 +484,8 @@ # .. qmp-example:: # # <- { "event": "GUEST_PVSHUTDOWN", -# "timestamp": { "seconds": 1648245259, "microseconds": 893771 } } +# "timestamp": { "seconds": 1648245259, +# "microseconds": 893771 } } ## { 'event': 'GUEST_PVSHUTDOWN' } =20 @@ -542,8 +555,8 @@ # @arg4: for Windows, third argument of the `STOP`. For Linux, the # RAX register (x86) or the stack pointer (aarch64) of the guest. # -# @arg5: for Windows, fourth argument of the `STOP`. For x86 Linux, the -# stack pointer of the guest. +# @arg5: for Windows, fourth argument of the `STOP`. For x86 Linux, +# the stack pointer of the guest. # # Since: 2.9 ## @@ -610,7 +623,7 @@ # # @error-code: TD-specific error code # -# @message: Human-readable error message provided by the guest. Not +# @message: Human-readable error message provided by the guest. Not # to be trusted. # # @gpa: guest-physical address of a page that contains more verbose @@ -644,8 +657,9 @@ # "data": { "recipient": "hypervisor", # "action": "fatal", # "flags": { "action-required": false, -# "recursive": false } }, -# "timestamp": { "seconds": 1267061043, "microseconds": 959568 } } +# "recursive": false } } +# "timestamp": { "seconds": 1267061043, +# "microseconds": 959568 } } ## { 'event': 'MEMORY_FAILURE', 'data': { 'recipient': 'MemoryFailureRecipient', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192739; cv=none; d=zohomail.com; s=zohoarc; b=clKzJrGOwlc8ZPgriDxFxOO8M+gkKeo4v+SAwO3sa0taWLhKdXU8t7ZKLgAz1gPjSLb7IIU3rv/LUeBE74DWIg88z6H9P/is12ryQs5o/RmOlhYBOnSP2bC1m9PhJgT0UuNkauNPKYVMAsAbzB60BLP7l/wlHugGDXwoOw6uAb8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192739; 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=4ZFS7VeU5sKpFc5IFb6anQVAn3TG0buI2JtzIiCbrd4=; b=Ylv+VDG/V8cefViWyihznZgz/12SKfrwCOYo5Eb8jUz7vQyQqImYMPbTascORVofKdf92rpgcfwJP6JQdFSPEklkMqFayJqoJV5kOKYm4NMxuRFq5jNtcD2Q22127tqxl9hJp/o2q7tPp1ngud5jWbIf7tBrD6Sctq9+3OjMwc0= 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 1760192739768833.118935405032; Sat, 11 Oct 2025 07:25:39 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8O-0006T9-Ap; Sat, 11 Oct 2025 09:59:44 -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 1v7a84-0006NR-Oj for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:25 -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 1v7a7c-0004mH-8r for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:24 -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 E8184C00BE; Sat, 11 Oct 2025 16:58:20 +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-EnKTwD6O; Sat, 11 Oct 2025 16:58:20 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191100; bh=4ZFS7VeU5sKpFc5IFb6anQVAn3TG0buI2JtzIiCbrd4=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=qr4IMI9g5RGC7kuFfmcD70Qe40FXjowDQMuXsJ/qVdaiHIBlLkjK6+YfVsOnl+PsG IxnvtGxZHpMmAKrtTP3hGE/XKQNK9QCqAojKOETk1TLReHGhGwWC8GVFUadHLsWmOo cW/IhkYws/skdBTlNJy9zr2Ekrw2MBywHS86V140= 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, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH 24/33] qapi/sockets.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:27 +0300 Message-ID: <20251011135754.294521-47-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192742069158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/sockets.json | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/qapi/sockets.json b/qapi/sockets.json index 32fac51728..473be2ac58 100644 --- a/qapi/sockets.json +++ b/qapi/sockets.json @@ -58,24 +58,26 @@ # @ipv6: whether to accept IPv6 addresses, default try both IPv4 and # IPv6 # -# @keep-alive: enable keep-alive when connecting to/listening on this sock= et. +# @keep-alive: enable keep-alive when connecting to/listening on this +# socket. # (Since 4.2, not supported for listening sockets until 10.1) # -# @keep-alive-count: number of keep-alive packets sent before the connecti= on is -# closed. Only supported for TCP sockets on systems where TCP_KEEPCNT -# socket option is defined (this includes Linux, Windows, macOS, FreeB= SD, -# but not OpenBSD). When set to 0, system setting is used. (Since 10= .1) -# -# @keep-alive-idle: time in seconds the connection needs to be idle before -# sending a keepalive packet. Only supported for TCP sockets on syste= ms -# where TCP_KEEPIDLE socket option is defined (this includes Linux, -# Windows, macOS, FreeBSD, but not OpenBSD). When set to 0, system se= tting -# is used. (Since 10.1) -# -# @keep-alive-interval: time in seconds between keep-alive packets. Only -# supported for TCP sockets on systems where TCP_KEEPINTVL is defined = (this -# includes Linux, Windows, macOS, FreeBSD, but not OpenBSD). When set= to -# 0, system setting is used. (Since 10.1) +# @keep-alive-count: number of keep-alive packets sent before the +# connection is closed. Only supported for TCP sockets on systems +# where TCP_KEEPCNT socket option is defined (this includes Linux, +# Windows, macOS, FreeBSD, but not OpenBSD). When set to 0, +# system setting is used. (Since 10.1) +# +# @keep-alive-idle: time in seconds the connection needs to be idle +# before sending a keepalive packet. Only supported for TCP +# sockets on systems where TCP_KEEPIDLE socket option is defined +# (this includes Linux, Windows, macOS, FreeBSD, but not OpenBSD). +# When set to 0, system setting is used. (Since 10.1) +# +# @keep-alive-interval: time in seconds between keep-alive packets. +# Only supported for TCP sockets on systems where TCP_KEEPINTVL is +# defined (this includes Linux, Windows, macOS, FreeBSD, but not +# OpenBSD). When set to 0, system setting is used. (Since 10.1) # # @mptcp: enable multi-path TCP. (Since 6.1) # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191289; cv=none; d=zohomail.com; s=zohoarc; b=FvxPVmj5F+Fg7415aRkdRSZMChF1njSuxjC9HVMHBa/qOIPbLEkTVy3esR4w6uje4TU8eWyl0ZyTRQC8ZBILSK7FE1VhXmHygOroRDBd9j8aDQ6w2Eb6/4qdNMjCSF6bdhD9VUCh7xPxbFx748tILgLXLtiXqeyHrmwcFuoV8ko= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191289; 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=4ZFS7VeU5sKpFc5IFb6anQVAn3TG0buI2JtzIiCbrd4=; b=IGpIpgHVR9IpCmsW6UBtuFfDqdcvxeCbntYfPctoVCwT9aeVcaEftvFwq5aCBGT8OLzEly34V7PxKwAnqta+K2F0mQDBtFrkAQn5N8p81bWraz8dUzBqTm2xTF+SwsCvkM/paOaBDAuUMW+/Q5brAJHiYFCAYX4rqaNi2Ubq8dA= 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 1760191288996223.690433169548; Sat, 11 Oct 2025 07:01:28 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8J-0006SF-5s; Sat, 11 Oct 2025 09:59:41 -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-0006KP-A3 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:19 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7e-0004mI-1i for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:17 -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 6828AC018A; Sat, 11 Oct 2025 16:58:21 +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-tUoPADV2; Sat, 11 Oct 2025 16:58:21 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191101; bh=4ZFS7VeU5sKpFc5IFb6anQVAn3TG0buI2JtzIiCbrd4=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=T59l/AogPiShWsVS7QWnlEPlyAjf7bSKemA3EcC86/UhA5bpnkdoBGv8aB788d29T qU7K5/D8GzUlS/+nSYJJMxeFvDU5rx0ePCdaLdSX77h3AyH9g0Y5fNTrAel3WEQCgP 9HgWWcscmDVZBwuT5w7Gl+wIoSY8JVVNlfv/6Pyw= 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, =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH 24/33] qapi/sockets.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:28 +0300 Message-ID: <20251011135754.294521-48-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191290817154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/sockets.json | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/qapi/sockets.json b/qapi/sockets.json index 32fac51728..473be2ac58 100644 --- a/qapi/sockets.json +++ b/qapi/sockets.json @@ -58,24 +58,26 @@ # @ipv6: whether to accept IPv6 addresses, default try both IPv4 and # IPv6 # -# @keep-alive: enable keep-alive when connecting to/listening on this sock= et. +# @keep-alive: enable keep-alive when connecting to/listening on this +# socket. # (Since 4.2, not supported for listening sockets until 10.1) # -# @keep-alive-count: number of keep-alive packets sent before the connecti= on is -# closed. Only supported for TCP sockets on systems where TCP_KEEPCNT -# socket option is defined (this includes Linux, Windows, macOS, FreeB= SD, -# but not OpenBSD). When set to 0, system setting is used. (Since 10= .1) -# -# @keep-alive-idle: time in seconds the connection needs to be idle before -# sending a keepalive packet. Only supported for TCP sockets on syste= ms -# where TCP_KEEPIDLE socket option is defined (this includes Linux, -# Windows, macOS, FreeBSD, but not OpenBSD). When set to 0, system se= tting -# is used. (Since 10.1) -# -# @keep-alive-interval: time in seconds between keep-alive packets. Only -# supported for TCP sockets on systems where TCP_KEEPINTVL is defined = (this -# includes Linux, Windows, macOS, FreeBSD, but not OpenBSD). When set= to -# 0, system setting is used. (Since 10.1) +# @keep-alive-count: number of keep-alive packets sent before the +# connection is closed. Only supported for TCP sockets on systems +# where TCP_KEEPCNT socket option is defined (this includes Linux, +# Windows, macOS, FreeBSD, but not OpenBSD). When set to 0, +# system setting is used. (Since 10.1) +# +# @keep-alive-idle: time in seconds the connection needs to be idle +# before sending a keepalive packet. Only supported for TCP +# sockets on systems where TCP_KEEPIDLE socket option is defined +# (this includes Linux, Windows, macOS, FreeBSD, but not OpenBSD). +# When set to 0, system setting is used. (Since 10.1) +# +# @keep-alive-interval: time in seconds between keep-alive packets. +# Only supported for TCP sockets on systems where TCP_KEEPINTVL is +# defined (this includes Linux, Windows, macOS, FreeBSD, but not +# OpenBSD). When set to 0, system setting is used. (Since 10.1) # # @mptcp: enable multi-path TCP. (Since 6.1) # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192574; cv=none; d=zohomail.com; s=zohoarc; b=ERsxq5W9kwKiUA9B0nY8bYhlxTI0MlRcQ3knChHhDZ/ngSDJwtYi9iuSNzRy0nP6eoTThzkXEPHbjawSExhJi9dif1FuQpiKVoTgi1CNQVO/ZjS/RQF8JBTgxqcroeZZvyohHgB4eEQA6jEhHey2wD2Z/reGuXghHgeD+3DRWpY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192574; 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=sM3USFOOrxTlF7/x0EAEtw5iQZvkoMmmbScXBN35Ioo=; b=GoNslk2M7biNkHlGKtZh/Dhk21dV7KXf7tOqsPtiG5eNB3P16+BFxnk7kMgSga9+ke5qB9vrgpIOurVAZ/h2AU5bCJRQeAIUTnviuRu/wI2F0CWBjr/e2w9TtL6KJ8ajnUBGJq7ADLgteTrqeccBBqjblkrHsX3r3JoDfsJF17I= 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 1760192574284719.9769254767677; Sat, 11 Oct 2025 07:22:54 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8U-0006WY-Jb; Sat, 11 Oct 2025 09:59:51 -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 1v7a7x-0006K9-8G for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:18 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7b-0004mO-EJ for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:16 -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 30197C018D; Sat, 11 Oct 2025 16:58:22 +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-jSiq0bIA; Sat, 11 Oct 2025 16:58:21 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191101; bh=sM3USFOOrxTlF7/x0EAEtw5iQZvkoMmmbScXBN35Ioo=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=u6U9krt82KDx6ekTgSf1eDeowt8vC8n7JVbVEHfT433/r0C5HLVgDiU5Dr8Ps6S2r eDsmGzsP1RI5RVBnl06+Gu3+PyymdXouamcES0tjdx1pUBFblbLJVLWgaefCuctfh4 Sy9nOoiNCopY86Mn1l/NLox7J8qn/ZZ7Yxw8iCsc= 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 Subject: [PATCH 25/33] qapi/stats.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:30 +0300 Message-ID: <20251011135754.294521-50-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760192580692158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/stats.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/stats.json b/qapi/stats.json index 151ac43c48..b7c61af0ca 100644 --- a/qapi/stats.json +++ b/qapi/stats.json @@ -185,7 +185,8 @@ # Return runtime-collected statistics for objects such as the VM or # its vCPUs. # -# The arguments are a `StatsFilter` and specify the provider and objects +# The arguments are a `StatsFilter` and specify the provider and +# objects # to return statistics about. # # Returns: a list of statistics, one for each provider and object --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191546; cv=none; d=zohomail.com; s=zohoarc; b=HZwbEQrMfe+8QaKEtVX1cov88G/8b7r/tzUmZlyXqb6CV19PnDxBzuhqT8jnBb3/s9w+7AqxdBNoWSURMLCYMfOf+3HW5H/GtYdFllS4qN2xNNnwl4/AzBj5W2wrdt2KEcHrgzfwADiy5dGA3hJDFY/DcmUwAbMCTWKDXEO5P8U= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191546; 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=sM3USFOOrxTlF7/x0EAEtw5iQZvkoMmmbScXBN35Ioo=; b=bRwrVLo1GYWSrZr3N0zxoEt4FQtdsa+fgHP2lNvVFrc2N1/cKvhtxeDQIzVok1Jr1H/aPeDgHzO246zYnD+/6mYCgLqcEHF60nFD7n/vB9Xtg9O17c6pW9Ouagws1yHNzm3E1UQWYp/4k3l5GMns9qcX6fO/oDmgmS2jlpu5tcI= 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 1760191546742995.2600910352625; Sat, 11 Oct 2025 07:05:46 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8t-0006v5-Ro; Sat, 11 Oct 2025 10:00:16 -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 1v7a87-0006Nv-Ic for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:28 -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 1v7a7f-0004mM-O4 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:25 -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 C5530C018C; Sat, 11 Oct 2025 16:58:21 +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-dCyiIPTy; Sat, 11 Oct 2025 16:58:21 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191101; bh=sM3USFOOrxTlF7/x0EAEtw5iQZvkoMmmbScXBN35Ioo=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=o2fsydCaEwB9z7lmOM/EYxH+/fRZrwrgkMhutri8+W+LiC/mQ0EmIVONhbzjug8cb RyLfTZGw0ny5UH4Ixyrcpkk2YGPS9FlCow4oSnpKgH7ijFIT3KpAO3Xu4NaAHXw9EL /Vxxav8cxNbIUg67JEyNOn2wo/lKfw43/bCVmmHI= 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 Subject: [PATCH 25/33] qapi/stats.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:29 +0300 Message-ID: <20251011135754.294521-49-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191548786158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/stats.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/stats.json b/qapi/stats.json index 151ac43c48..b7c61af0ca 100644 --- a/qapi/stats.json +++ b/qapi/stats.json @@ -185,7 +185,8 @@ # Return runtime-collected statistics for objects such as the VM or # its vCPUs. # -# The arguments are a `StatsFilter` and specify the provider and objects +# The arguments are a `StatsFilter` and specify the provider and +# objects # to return statistics about. # # Returns: a list of statistics, one for each provider and object --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191350; cv=none; d=zohomail.com; s=zohoarc; b=SVsqXp4lIBJtaL8y5Ce2PVBnjKNykDSkdivJu4wszhxDFyXTcY8ETQHdFJY6V8OkeiWJ1m48HkDc/vXQyML9uokt6vniMeLfCUV4t1Ek/MgouSfAsqDpd2NagoKgyUkQtg0RgOArE44EHum2bBgrxq6B5Wwfz4pC+sBbjYYJ+mk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191350; 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=rK/+G9hpA6fAo+LzVNCj2d73nJK3eoEO5+jb4Tdcr/8=; b=WIbfzwY0YREghmRKheKUFNUIPV6derP+KlyTHUKA1XfPjWO2c1DjpCZLewMVma72QRzjlHuuQF/4bh/asezE2iI1gV32wcB5JsXxyr3yO3GwI/wdjBZWahs9kVtbM8KayHPVMW+shB/wjmjTGJqOLXAcR/njcZj5GHtBE/SUYOU= 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 1760191350887982.8359313468878; Sat, 11 Oct 2025 07:02:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a9t-00082q-TM; Sat, 11 Oct 2025 10:01:18 -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 1v7a82-0006Lu-2N for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:22 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7e-0004mY-B8 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:21 -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 34840C018F; Sat, 11 Oct 2025 16:58:23 +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-Qcgq0aOv; Sat, 11 Oct 2025 16:58:22 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191102; bh=rK/+G9hpA6fAo+LzVNCj2d73nJK3eoEO5+jb4Tdcr/8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=ljJiKjg6tGkhiqBnMGjnYE+ZzO1oyM916x/Yo6QzRSIn50umoIWGRAvEFNUOJwTyv Oeq6rkvasfYHmhKBqZCCPL34q9htpwxpfddvUiYX6C3PL03hBodb0oGFNUkQw4+a/C z4Ad1XzinP94BKEiC6beWiuXwDPnyTzW1OBFXENc= 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, Stefan Berger Subject: [PATCH 26/33] qapi/tpm.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:32 +0300 Message-ID: <20251011135754.294521-52-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191353739154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy Reviewed-by; Stefan Berger --- qapi/tpm.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/tpm.json b/qapi/tpm.json index 3f2850a573..efa7addd78 100644 --- a/qapi/tpm.json +++ b/qapi/tpm.json @@ -175,7 +175,8 @@ # "options": # { "type": "passthrough", # "data": -# { "cancel-path": "/sys/class/misc/tpm0/device/cancel", +# { "cancel-path": +# "/sys/class/misc/tpm0/device/cancel", # "path": "/dev/tpm0" # } # }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192408; cv=none; d=zohomail.com; s=zohoarc; b=AayiKHmUtvI8mKsws/Z9mS5/JGc7iKyykdukldwByWr990FfZH1y5jbH+4Poy9OvmZnbS61RZUJ6KdkcBoX+R1+1MeP3H+dJrr7EaZnN8KrTYksaJAqUbWSyurzKofcG+Pu3F5/c9wKUgiHWb6/0Jy0kidbOmY5xOXfyhDPgqUc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192408; 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=rK/+G9hpA6fAo+LzVNCj2d73nJK3eoEO5+jb4Tdcr/8=; b=WMRnchjjatBXSy63ITAOpmTZ/Re3cQ5ttJAdkH/lnl7yFJ9pbLyunA2WtC5nMdi6f02yE376FlS6UjUIR1Sp17mfZPNmI3Q7Jsb0nO7wsxdph6bNP4UNSOZyInZdEst4fKVVCIPkFbq0XFr4EyDvMSKxizXb5OoSP1OJUMq42QY= 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 1760192408311873.1612455184998; Sat, 11 Oct 2025 07:20:08 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a9X-00073i-Gy; Sat, 11 Oct 2025 10:00:57 -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 1v7a7z-0006KR-Bf for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:19 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7f-0004mZ-AG for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:19 -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 BCDC5C018E; Sat, 11 Oct 2025 16:58:22 +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-UguUhM7R; Sat, 11 Oct 2025 16:58:22 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191102; bh=rK/+G9hpA6fAo+LzVNCj2d73nJK3eoEO5+jb4Tdcr/8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=1TwBN4b7f0zHkVBWqJAglBzsZtsgwlGZ3hfmrBZIlBjHe3RZZiUucdhjgDpW79rfB MYaacWtWdSLfD4xY91upE5ZnVqTcUFRRqojxpbG6tebA2gaeGpW4aNGDkGq34WS6wz qlnnEVcmyXZ04sYx4mSn1YeuxUgaw3GkSnOy3+YU= 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, Stefan Berger Subject: [PATCH 26/33] qapi/tpm.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:31 +0300 Message-ID: <20251011135754.294521-51-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192416276158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/tpm.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/tpm.json b/qapi/tpm.json index 3f2850a573..efa7addd78 100644 --- a/qapi/tpm.json +++ b/qapi/tpm.json @@ -175,7 +175,8 @@ # "options": # { "type": "passthrough", # "data": -# { "cancel-path": "/sys/class/misc/tpm0/device/cancel", +# { "cancel-path": +# "/sys/class/misc/tpm0/device/cancel", # "path": "/dev/tpm0" # } # }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192267; cv=none; d=zohomail.com; s=zohoarc; b=ectyySJrdA4Xy9Gpje8gkzph2aUEbpdpxldo25ZHiY9AdhfQkSYjdgkwNNOgsR2p7UKiJJMH7VGf8BZvyPPhpEGhxvHZLuRFHOuXc0JeP2y2fo94D9GAxhncEd5LhxkEKEjG6TGJwAk+ZJSWTqon7Jj59pgJIeq0C7Rp5DN1XYk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192267; 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=5laPx8DQitkjjYv24YWNmXSF2GTnWZhXXAkNWY7GqhI=; b=CRaIq7+tMoEGv6liqoM6kwgl9eVFej/vbVgbTfmi5cwd+pgUeMYHPGi6pRkoh9jkzmj0T91Xhm2jRai4n59WU9GPRSQT7yi6mQrzKXcm3FioimjYERT9ot/YD5f+XEtXNBq6M6rKTxaOjTXai+JGnlMhXCxecd7Ff7saYBnj6OI= 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 1760192267147732.0919158489924; Sat, 11 Oct 2025 07:17:47 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a9h-0007j8-OB; Sat, 11 Oct 2025 10:01:07 -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 1v7a84-0006NQ-7N for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:25 -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 1v7a7g-0004nH-P5 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:23 -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 3A271C0193; Sat, 11 Oct 2025 16:58:24 +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-B3CZbFxj; Sat, 11 Oct 2025 16:58:23 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191103; bh=5laPx8DQitkjjYv24YWNmXSF2GTnWZhXXAkNWY7GqhI=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=rk+lAWxtymsaJGJk5vgtgidLdDgTaC6sAHtUyzHRHE2hynFIKWit2aIVrsH1yxsez i2/BnhQY8R2joSIRq/Z1UjCBsJJ9Ki/rr88c8TSUxBZFpqj6Q/YoUpEjhLCpYVpI1d ZBFanHD01W35QCQ9825VVVJqyoCSxhFNBPmO2uO8= 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, Stefan Hajnoczi , Mads Ynddal Subject: [PATCH 27/33] qapi/trace.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:34 +0300 Message-ID: <20251011135754.294521-54-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_HELO_NONE=0.001, T_SPF_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: 1760192270763158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/trace.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/trace.json b/qapi/trace.json index de369dae6b..6162a9aa71 100644 --- a/qapi/trace.json +++ b/qapi/trace.json @@ -57,7 +57,8 @@ # # -> { "execute": "trace-event-get-state", # "arguments": { "name": "qemu_memalign" } } -# <- { "return": [ { "name": "qemu_memalign", "state": "disabled", "vc= pu": false } ] } +# <- { "return": [ { "name": "qemu_memalign", "state": "disabled", +# "vcpu": false } ] } ## { 'command': 'trace-event-get-state', 'data': {'name': 'str' }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192047; cv=none; d=zohomail.com; s=zohoarc; b=ePoITCwGZIbtXq11DAf0ra40FSJhbr9DZLwsaGRnSaZBTw/j1Q4J6NpAmz3EVefjCot0kVMzQw0ZmavqAgMEg9v/chq16E2kcycL8AbdN8hktavm1M6D462hMfbOnKRgMTv8S0W15duceYj9tQo4g2X0BEwKIM2ewxqPlBhs/+4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192047; 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=5laPx8DQitkjjYv24YWNmXSF2GTnWZhXXAkNWY7GqhI=; b=jLHf7Syrp1ocRHALD+4K5VQl6b/WDQMFL5ZPu1rlQExzG/eMNCzsvJ2gy9mkAMtOPeayyIuYHOFbN3Q0JhAzLBBF+ELshyuY3DuQ0wjeZd31IG1rcU7GTB7NgzNQtlLRpM9vGzVy5r+a8bKGlEQ3A//fBiIcAtZy9Q2UYmYxByk= 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 1760192047964530.3803014648515; Sat, 11 Oct 2025 07:14:07 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a88-0006Pe-U4; Sat, 11 Oct 2025 09:59:29 -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 1v7a85-0006NS-48 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:25 -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 1v7a7g-0004nI-0U for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:24 -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 B3B70C0192; Sat, 11 Oct 2025 16:58:23 +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-IKFi5wA0; Sat, 11 Oct 2025 16:58:23 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191103; bh=5laPx8DQitkjjYv24YWNmXSF2GTnWZhXXAkNWY7GqhI=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=crGHy9TagZfAlcIEwfGQyXrBobG2YA7qmKVNz/IWKNpji3a7hd+jtO8tjGOntbExF EsXZ3xRp8IctKTohdgCeo0T+IUXEIRk3t71wDSeHMKgdwVjUoBhF3mxPbFoeHmCHpV lnZ21ySpbuEnCfi+1y4pFS/SdtvZkoRPDt3wRAm8= 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, Stefan Hajnoczi , Mads Ynddal Subject: [PATCH 27/33] qapi/trace.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:33 +0300 Message-ID: <20251011135754.294521-53-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192050126158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/trace.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/trace.json b/qapi/trace.json index de369dae6b..6162a9aa71 100644 --- a/qapi/trace.json +++ b/qapi/trace.json @@ -57,7 +57,8 @@ # # -> { "execute": "trace-event-get-state", # "arguments": { "name": "qemu_memalign" } } -# <- { "return": [ { "name": "qemu_memalign", "state": "disabled", "vc= pu": false } ] } +# <- { "return": [ { "name": "qemu_memalign", "state": "disabled", +# "vcpu": false } ] } ## { 'command': 'trace-event-get-state', 'data': {'name': 'str' }, --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192017; cv=none; d=zohomail.com; s=zohoarc; b=k9cpHXIuLFj/E5GGp//UboQ+DAUcZS1Tl/iROIztCSxLLUl31Y4S+GmqV6SevMtuni6mlD3VFfE54S8w6R04+JNy2q8iAUWjcUIeVbYTFWZzLsYZWTLxSqyOjlq9wt8D+KvCRfR+AQaJgxntrBKq9V1RRuAz6dG9LelE7meTnkA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192017; 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=EjDlYN/YV/1Al0fTsGpd9EuPX946XXrIIrx4bLAmmms=; b=f+Q3PcMnA/frBmNKfwqXTBMGN20Zva8i7iI0nVi9MC5CtsWBPMvohNhOlMPhbp8c6MA6vLt8Dn89shh1nJqD05DYT57AZsR/9BTtPRe3qXI9rqKjpoCOe6hkamBhR5odb/DwsmDVHTvLi4Dniz9E6B2+MCST0I7WGhkmDn6oCnk= 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 1760192017896745.8976094876307; Sat, 11 Oct 2025 07:13:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aAS-0001KQ-Hn; Sat, 11 Oct 2025 10:01:52 -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 1v7a8P-0006VB-S5; Sat, 11 Oct 2025 09:59:46 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a81-0004nL-72; Sat, 11 Oct 2025 09:59:45 -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 A83CBC0196; Sat, 11 Oct 2025 16:58:24 +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-9ZXnbFjJ; Sat, 11 Oct 2025 16:58:24 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191104; bh=EjDlYN/YV/1Al0fTsGpd9EuPX946XXrIIrx4bLAmmms=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=k+EuZkrq3qIUBvHC4Iv9LGb6ZHou/5GJvEBk4QUnoMo59eUV2oFsPsXQemA7UCzfZ br1Gdd220lALcfo/j1ZHHpyGHr4h7XCsAIYsYbBd2fMvg75nrUm6AN9Yx/db8X9m70 5FD0ixNc3T6+RdNo7mUdxV97Mxug5yYl6ObBWm/o= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 28/33] qapi/transaction.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:35 +0300 Message-ID: <20251011135754.294521-55-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192019341154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/transaction.json | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/qapi/transaction.json b/qapi/transaction.json index 4b4eb09bf3..f43da7f30d 100644 --- a/qapi/transaction.json +++ b/qapi/transaction.json @@ -250,21 +250,24 @@ # # -> { "execute": "transaction", # "arguments": { "actions": [ -# { "type": "blockdev-snapshot-sync", "data" : { "device": "i= de-hd0", -# "snapshot-file": "/some/place/m= y-image", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-sync", "data" : { "node-name":= "myfile", -# "snapshot-file": "/some/place/m= y-image2", -# "snapshot-node-name": "node3432= ", -# "mode": "existing", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-sync", "data" : { "device": "i= de-hd1", -# "snapshot-file": "/some/place/m= y-image2", -# "mode": "existing", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-internal-sync", "data" : { -# "device": "ide-hd2", -# "name": "snapshot0" } } ] } } +# { "type": "blockdev-snapshot-sync", +# "data" : { "device": "ide-hd0", +# "snapshot-file": "/some/place/my-image", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-sync", +# "data" : { "node-name": "myfile", +# "snapshot-file": "/some/place/my-image2", +# "snapshot-node-name": "node3432", +# "mode": "existing", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-sync", +# "data" : { "device": "ide-hd1", +# "snapshot-file": "/some/place/my-image2", +# "mode": "existing", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-internal-sync", +# "data" : { "device": "ide-hd2", +# "name": "snapshot0" } } ] } } # <- { "return": {} } ## { 'command': 'transaction', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192764; cv=none; d=zohomail.com; s=zohoarc; b=gAqhdMCWbjF6Btdyo6F6GerzQD1PbXmKDoZblDGVQ5T5f4cWvnMTv9ciUhTduypPoktlDqZEMMH/V8ovYyJ7VKXFPKy2Xy+VFgs9WcEHrqY3U0jVtnWLIqRNDfmScnoG/hCuanlKeH2YwL8/D9Tz2Ie8G2yuyPFHNzsCOM02Z3w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192764; 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=EjDlYN/YV/1Al0fTsGpd9EuPX946XXrIIrx4bLAmmms=; b=heNQcg2agNqht/2i4D0h3dU8S7m0OV3r4aim3DIHsjMhTB3P0PNIfxuuOCsmS50+VoxnFZjZvd0DqNFDZR3D5MxKlASX52d5QBuO2xfoQgkCccS/PaUXVsqotg5Qe21N3FgpJDFgEEPMJ9n31xSgrHL5v22/m8cifBahZ8BPNAM= 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 1760192764287891.8930839425506; Sat, 11 Oct 2025 07:26:04 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aAD-0000Er-FM; Sat, 11 Oct 2025 10:01:37 -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 1v7a8K-0006SO-MF; Sat, 11 Oct 2025 09:59:41 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7t-0004nM-MK; Sat, 11 Oct 2025 09:59:38 -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 2562DC0197; Sat, 11 Oct 2025 16:58:25 +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-ZPCPUo2i; Sat, 11 Oct 2025 16:58:24 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191104; bh=EjDlYN/YV/1Al0fTsGpd9EuPX946XXrIIrx4bLAmmms=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=DZQXMLtVt17T+XS9uw2e109/Ws0b3M09ZkbeHU3qv9wwimy0iUDEh+d5hhdffWBTC dtFhuRDQ/OQsWW+OM5agyW9aUsRE659AEpum+2KRo+swEHjLLw3Eq+1KZlazHwVUzX /t1z7m9Wy/9iRGJ/l8Y3kA5p3MNMwjYk5CK0cR98= 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, Kevin Wolf , Hanna Reitz , qemu-block@nongnu.org (open list:Block layer core) Subject: [PATCH 28/33] qapi/transaction.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:36 +0300 Message-ID: <20251011135754.294521-56-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192765706154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/transaction.json | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/qapi/transaction.json b/qapi/transaction.json index 4b4eb09bf3..f43da7f30d 100644 --- a/qapi/transaction.json +++ b/qapi/transaction.json @@ -250,21 +250,24 @@ # # -> { "execute": "transaction", # "arguments": { "actions": [ -# { "type": "blockdev-snapshot-sync", "data" : { "device": "i= de-hd0", -# "snapshot-file": "/some/place/m= y-image", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-sync", "data" : { "node-name":= "myfile", -# "snapshot-file": "/some/place/m= y-image2", -# "snapshot-node-name": "node3432= ", -# "mode": "existing", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-sync", "data" : { "device": "i= de-hd1", -# "snapshot-file": "/some/place/m= y-image2", -# "mode": "existing", -# "format": "qcow2" } }, -# { "type": "blockdev-snapshot-internal-sync", "data" : { -# "device": "ide-hd2", -# "name": "snapshot0" } } ] } } +# { "type": "blockdev-snapshot-sync", +# "data" : { "device": "ide-hd0", +# "snapshot-file": "/some/place/my-image", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-sync", +# "data" : { "node-name": "myfile", +# "snapshot-file": "/some/place/my-image2", +# "snapshot-node-name": "node3432", +# "mode": "existing", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-sync", +# "data" : { "device": "ide-hd1", +# "snapshot-file": "/some/place/my-image2", +# "mode": "existing", +# "format": "qcow2" } }, +# { "type": "blockdev-snapshot-internal-sync", +# "data" : { "device": "ide-hd2", +# "name": "snapshot0" } } ] } } # <- { "return": {} } ## { 'command': 'transaction', --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192120; cv=none; d=zohomail.com; s=zohoarc; b=ELfLgcbjeKwHbAOFHuPYASjLQW0dq231duNA9ag2yLE1V9nWqpSDRyQ6MNSyVmsNJ1u3rCot7y0c/G8Q9pe+RtHkqCcRo2twCC/2z4ZqS/O66UUeIDG28woIuWx92flFrTwtAHif9GC7r7Ygbn2ZLe+DlIfwaJ6BYc7xXfgOosQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192120; 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=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; b=h/Dg5S/+p7Z6k8gDyftySajtCRXdJnarapc8ty9gBWs+Mvvs28HRtdnLgx62Pa1OHrSQjcVQfFr3+DO1rd7J6Fy2BNO+ajnB8KH/JnVgx3XP6l9/iYzHNznpsaJVCrWU0eo3njgUAJpyWDcrHF+UxYJpldQU62PsP6dWXx7vaW0= 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 1760192120411407.52511648281427; Sat, 11 Oct 2025 07:15:20 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8X-0006Xp-8o; Sat, 11 Oct 2025 09:59: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 1v7a87-0006PA-8x for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:28 -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 1v7a7k-0004np-SN for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:26 -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 A7FABC0198; Sat, 11 Oct 2025 16:58:25 +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-2nADVqBZ; Sat, 11 Oct 2025 16:58:25 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191105; bh=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=AX/qoVWMes11zaoUystNEGsACoHuRuwkD+J1CtlRiq89qC0woiyCugOPxVg0b46KU ptET/fsj6z+7yEZSeWbPQubToz9OMClbXnYU56X8al0xM9vF2lm9OWoewMrsNqa4Lw dcwDUVX1s66LGuy1v1078ZsBDQ/rWVv6qXGf0PVQ= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= Subject: [PATCH 29/33] qapi/ui.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:37 +0300 Message-ID: <20251011135754.294521-57-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760192122478154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/ui.json | 108 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 67 insertions(+), 41 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index 1b2f4a4769..ab64c6372a 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -87,8 +87,8 @@ # # .. qmp-example:: # -# -> { "execute": "set_password", "arguments": { "protocol": "vnc", -# "password": "secret" = } } +# -> { "execute": "set_password", +# "arguments": { "protocol": "vnc", "password": "secret" } } # <- { "return": {} } ## { 'command': 'set_password', 'boxed': true, 'data': 'SetPasswordOptions' } @@ -149,8 +149,8 @@ # # .. qmp-example:: # -# -> { "execute": "expire_password", "arguments": { "protocol": "vnc", -# "time": "+60" } } +# -> { "execute": "expire_password", +# "arguments": { "protocol": "vnc", "time": "+60" } } # <- { "return": {} } ## { 'command': 'expire_password', 'boxed': true, 'data': 'ExpirePasswordOpti= ons' } @@ -381,11 +381,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": { "seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_CONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1" }, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1" } # }} ## { 'event': 'SPICE_CONNECTED', @@ -407,13 +410,16 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_INITIALIZED", # "data": {"server": {"auth": "spice", "port": "5921", # "family": "ipv4", "host": "127.0.0.1"}, -# "client": {"port": "49004", "family": "ipv4", "channel= -type": 3, -# "connection-id": 1804289383, "host": "127.0= .0.1", -# "channel-id": 0, "tls": true} +# "client": { "port": "49004", "family": "ipv4", +# "channel-type": 3, +# "connection-id": 1804289383, +# "host": "127.0.0.1", +# "channel-id": 0, "tls": true} # }} ## { 'event': 'SPICE_INITIALIZED', @@ -434,11 +440,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_DISCONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1"}, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1"} # }} ## { 'event': 'SPICE_DISCONNECTED', @@ -455,7 +464,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_MIGRATE_COMPLETED" } ## { 'event': 'SPICE_MIGRATE_COMPLETED', @@ -727,11 +737,14 @@ # # <- { "event": "VNC_CONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0" }, # "client": { "family": "ipv4", "service": "58425", -# "host": "127.0.0.1", "websocket": false } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "host": "127.0.0.1", +# "websocket": false } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_CONNECTED', 'data': { 'server': 'VncServerInfo', @@ -754,11 +767,15 @@ # # <- { "event": "VNC_INITIALIZED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0"}, -# "client": { "family": "ipv4", "service": "46089", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1263475302, "microseconds": 150772 }= } +# "client": { "family": "ipv4", "service": "46089", +# "websocket": false, +# "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1263475302, +# "microseconds": 150772 } } ## { 'event': 'VNC_INITIALIZED', 'data': { 'server': 'VncServerInfo', @@ -780,11 +797,14 @@ # # <- { "event": "VNC_DISCONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, -# "service": "5901", "host": "0.0.0.0" }, -# "client": { "family": "ipv4", "service": "58425", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, "service": "5901", +# "host": "0.0.0.0" }, +# "client": { "family": "ipv4", "service": "58425", +# "websocket": false, "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_DISCONNECTED', 'data': { 'server': 'VncServerInfo', @@ -1023,10 +1043,10 @@ # # Send keys to guest. # -# @keys: An array of `KeyValue` elements. All @KeyValues in this array -# are simultaneously sent to the guest. A `KeyValue`.number value -# is sent directly to the guest, while `KeyValue`.qcode must be a -# valid `QKeyCode` value +# @keys: An array of `KeyValue` elements. All @KeyValues in this +# array are simultaneously sent to the guest. A `KeyValue`.number +# value is sent directly to the guest, while `KeyValue`.qcode must +# be a valid `QKeyCode` value # # @hold-time: time to delay key up events, milliseconds. Defaults to # 100 @@ -1039,9 +1059,10 @@ # .. qmp-example:: # # -> { "execute": "send-key", -# "arguments": { "keys": [ { "type": "qcode", "data": "ctrl" }, -# { "type": "qcode", "data": "alt" }, -# { "type": "qcode", "data": "delete" } = ] } } +# "arguments": { "keys": [ +# { "type": "qcode", "data": "ctrl" }, +# { "type": "qcode", "data": "alt" }, +# { "type": "qcode", "data": "delete" } ] } } # <- { "return": {} } ## { 'command': 'send-key', @@ -1278,13 +1299,15 @@ # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": true, "button": "left" } } ] }= } +# "data" : { "down": true, +# "button": "left" } } ] } } # <- { "return": {} } # # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": false, "button": "left" } } ] = } } +# "data" : { "down": false, +# "button": "left" } } ] } } # <- { "return": {} } # # .. qmp-example:: @@ -1305,8 +1328,10 @@ # # -> { "execute": "input-send-event" , # "arguments": { "events": [ -# { "type": "abs", "data" : { "axis": "x", "value" : 20= 000 } }, -# { "type": "abs", "data" : { "axis": "y", "value" : 40= 0 } } ] } } +# { "type": "abs", +# "data" : { "axis": "x", "value" : 20000 } }, +# { "type": "abs", +# "data" : { "axis": "y", "value" : 400 } } ] } } # <- { "return": {} } ## { 'command': 'input-send-event', @@ -1335,10 +1360,11 @@ # @show-menubar: Display the main window menubar. Defaults to "on". # (Since 8.0) # -# @keep-aspect-ratio: Keep width/height aspect ratio of guest content when -# resizing host window. Defaults to "on". (Since 10.1) +# @keep-aspect-ratio: Keep width/height aspect ratio of guest content +# when resizing host window. Defaults to "on". (Since 10.1) # -# @scale: Set preferred scale of the display. Defaults to 1.0. (Since 10= .1) +# @scale: Set preferred scale of the display. Defaults to 1.0. +# (Since 10.1) # # Since: 2.12 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192409; cv=none; d=zohomail.com; s=zohoarc; b=E736+r6+bIgWmQlpSq2jYS888DPRrVrKYJRnub+iMe0buOF+TrHvHcxoMaeSQpDi5G4vOwX2DXj65PXNteh08OFZjVrIDbbX2XGu/H60FXUx8HI+0DTmMeCi8yfX/o1qJl/gbgsCW3tqVAGkiNM8KVHhgRB+14PvOI8BGAsZY1s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192409; 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=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; b=Pt1SDRVGANfc4xRZp7hT0eaU2RIYdEhnuVwEgVxZxqDBsAfocfyYStOXnN7GPtS+cU5VfResG6LBQs+qMTT8dRRroWnNWrQBOXyJDgEs0+7Uz5ByRdjjXlZfw5fSTdbEkzU7ZLjRuO9+X/3nteB5jm6ZBZlCeyxsvuPgLlPIsLY= 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 176019240964946.781017116232306; Sat, 11 Oct 2025 07:20:09 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8c-0006aZ-Fl; Sat, 11 Oct 2025 09:59:58 -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 1v7a8A-0006QQ-Jy for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:31 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7k-0004nr-H5 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:29 -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 39BF8C019A; Sat, 11 Oct 2025 16:58:26 +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-p6dRlyvf; Sat, 11 Oct 2025 16:58:25 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191105; bh=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=zQ5SJyohe3WoJXhV3ARJi3MVj32kYiuUOutIrQ41kB4XP+TBjsWsE2xjGLsYXSoOI jP/10PJzajosHQL/HtfozPs4QJpmITmQi6K5H6FAZoYjH3IiQhmh1hFtcMX5UpXXFF sXekc3MjaX2Xmo+LG5XRA6oJXTzjXF8NPMLyO0gM= 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, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= Subject: [PATCH 29/33] qapi/ui.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:38 +0300 Message-ID: <20251011135754.294521-58-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_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: 1760192416386158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/ui.json | 108 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 67 insertions(+), 41 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index 1b2f4a4769..ab64c6372a 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -87,8 +87,8 @@ # # .. qmp-example:: # -# -> { "execute": "set_password", "arguments": { "protocol": "vnc", -# "password": "secret" = } } +# -> { "execute": "set_password", +# "arguments": { "protocol": "vnc", "password": "secret" } } # <- { "return": {} } ## { 'command': 'set_password', 'boxed': true, 'data': 'SetPasswordOptions' } @@ -149,8 +149,8 @@ # # .. qmp-example:: # -# -> { "execute": "expire_password", "arguments": { "protocol": "vnc", -# "time": "+60" } } +# -> { "execute": "expire_password", +# "arguments": { "protocol": "vnc", "time": "+60" } } # <- { "return": {} } ## { 'command': 'expire_password', 'boxed': true, 'data': 'ExpirePasswordOpti= ons' } @@ -381,11 +381,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": { "seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_CONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1" }, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1" } # }} ## { 'event': 'SPICE_CONNECTED', @@ -407,13 +410,16 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_INITIALIZED", # "data": {"server": {"auth": "spice", "port": "5921", # "family": "ipv4", "host": "127.0.0.1"}, -# "client": {"port": "49004", "family": "ipv4", "channel= -type": 3, -# "connection-id": 1804289383, "host": "127.0= .0.1", -# "channel-id": 0, "tls": true} +# "client": { "port": "49004", "family": "ipv4", +# "channel-type": 3, +# "connection-id": 1804289383, +# "host": "127.0.0.1", +# "channel-id": 0, "tls": true} # }} ## { 'event': 'SPICE_INITIALIZED', @@ -434,11 +440,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_DISCONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1"}, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1"} # }} ## { 'event': 'SPICE_DISCONNECTED', @@ -455,7 +464,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_MIGRATE_COMPLETED" } ## { 'event': 'SPICE_MIGRATE_COMPLETED', @@ -727,11 +737,14 @@ # # <- { "event": "VNC_CONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0" }, # "client": { "family": "ipv4", "service": "58425", -# "host": "127.0.0.1", "websocket": false } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "host": "127.0.0.1", +# "websocket": false } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_CONNECTED', 'data': { 'server': 'VncServerInfo', @@ -754,11 +767,15 @@ # # <- { "event": "VNC_INITIALIZED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0"}, -# "client": { "family": "ipv4", "service": "46089", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1263475302, "microseconds": 150772 }= } +# "client": { "family": "ipv4", "service": "46089", +# "websocket": false, +# "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1263475302, +# "microseconds": 150772 } } ## { 'event': 'VNC_INITIALIZED', 'data': { 'server': 'VncServerInfo', @@ -780,11 +797,14 @@ # # <- { "event": "VNC_DISCONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, -# "service": "5901", "host": "0.0.0.0" }, -# "client": { "family": "ipv4", "service": "58425", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, "service": "5901", +# "host": "0.0.0.0" }, +# "client": { "family": "ipv4", "service": "58425", +# "websocket": false, "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_DISCONNECTED', 'data': { 'server': 'VncServerInfo', @@ -1023,10 +1043,10 @@ # # Send keys to guest. # -# @keys: An array of `KeyValue` elements. All @KeyValues in this array -# are simultaneously sent to the guest. A `KeyValue`.number value -# is sent directly to the guest, while `KeyValue`.qcode must be a -# valid `QKeyCode` value +# @keys: An array of `KeyValue` elements. All @KeyValues in this +# array are simultaneously sent to the guest. A `KeyValue`.number +# value is sent directly to the guest, while `KeyValue`.qcode must +# be a valid `QKeyCode` value # # @hold-time: time to delay key up events, milliseconds. Defaults to # 100 @@ -1039,9 +1059,10 @@ # .. qmp-example:: # # -> { "execute": "send-key", -# "arguments": { "keys": [ { "type": "qcode", "data": "ctrl" }, -# { "type": "qcode", "data": "alt" }, -# { "type": "qcode", "data": "delete" } = ] } } +# "arguments": { "keys": [ +# { "type": "qcode", "data": "ctrl" }, +# { "type": "qcode", "data": "alt" }, +# { "type": "qcode", "data": "delete" } ] } } # <- { "return": {} } ## { 'command': 'send-key', @@ -1278,13 +1299,15 @@ # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": true, "button": "left" } } ] }= } +# "data" : { "down": true, +# "button": "left" } } ] } } # <- { "return": {} } # # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": false, "button": "left" } } ] = } } +# "data" : { "down": false, +# "button": "left" } } ] } } # <- { "return": {} } # # .. qmp-example:: @@ -1305,8 +1328,10 @@ # # -> { "execute": "input-send-event" , # "arguments": { "events": [ -# { "type": "abs", "data" : { "axis": "x", "value" : 20= 000 } }, -# { "type": "abs", "data" : { "axis": "y", "value" : 40= 0 } } ] } } +# { "type": "abs", +# "data" : { "axis": "x", "value" : 20000 } }, +# { "type": "abs", +# "data" : { "axis": "y", "value" : 400 } } ] } } # <- { "return": {} } ## { 'command': 'input-send-event', @@ -1335,10 +1360,11 @@ # @show-menubar: Display the main window menubar. Defaults to "on". # (Since 8.0) # -# @keep-aspect-ratio: Keep width/height aspect ratio of guest content when -# resizing host window. Defaults to "on". (Since 10.1) +# @keep-aspect-ratio: Keep width/height aspect ratio of guest content +# when resizing host window. Defaults to "on". (Since 10.1) # -# @scale: Set preferred scale of the display. Defaults to 1.0. (Since 10= .1) +# @scale: Set preferred scale of the display. Defaults to 1.0. +# (Since 10.1) # # Since: 2.12 ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191446; cv=none; d=zohomail.com; s=zohoarc; b=T/UbJ/P3jRp3NH7Eo6voLFWMb9jySl+VrKeBSEYmmk1itl1lKz6Xq53Z2MrYmPeVsn7MerTT7WtxpK4qR0/jU7GYE2R4uH+jJZEUa+rCl0dEFuh4SyJstfONtWfA4aoMNlQB+cLi/m9hLNpmOP6M07r8eU6fOqmKL01O0SlwumA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191446; 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=1CGq7RsxQNTob5PhDegp7KkfmxrZTsn1VhnQAdpWyDk=; b=CoaFT/MGpgCLzkILcSzMiaWGBW3oI+1zUk1FIWCLlhVham2fvvBJftmKxTnFmY8MtnlhTYvr7WxgX3w88OOj6WQw4qk3vmTiMVjjwhhWow5XVg50W2zFLmMChOmz0Kf+7KA4J3dzTlM3atvyIsVrfDqyHdK5tRF+X2pxbkoHqjo= 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 1760191446501812.7712766422178; Sat, 11 Oct 2025 07:04:06 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8Q-0006V8-4O; Sat, 11 Oct 2025 09:59:46 -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 1v7a86-0006Nu-QW for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:26 -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 1v7a7k-0004o4-R2 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:25 -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 A8221C019C; Sat, 11 Oct 2025 16:58:26 +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-A43yEn5P; Sat, 11 Oct 2025 16:58:26 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191106; bh=1CGq7RsxQNTob5PhDegp7KkfmxrZTsn1VhnQAdpWyDk=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=ycHhq5qseOyfw3SqWIixHgjuhlUOdTgW8j7OS9NpPBvw6J1ArRYysB7qDRL4CwnxC c4/duDwhKRj/Hcm3/rrMe5LdRW26mXVggZDDQ9mu9qGuWZ7j8cU5FBG/ySRlXLl2jm IafQtVOmiPGyD2XaDNXSo/BscCzKu+RyqDOWVkdo= 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, Alex Williamson , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH 30/33] qapi/vfio.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:39 +0300 Message-ID: <20251011135754.294521-59-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191448834154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/vfio.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/vfio.json b/qapi/vfio.json index a1a9c5b673..a4c4f9f91c 100644 --- a/qapi/vfio.json +++ b/qapi/vfio.json @@ -53,7 +53,8 @@ # # .. qmp-example:: # -# <- { "timestamp": { "seconds": 1713771323, "microseconds": 212268 }, +# <- { "timestamp": { "seconds": 1713771323, +# "microseconds": 212268 }, # "event": "VFIO_MIGRATION", # "data": { # "device-id": "vfio_dev1", --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191897; cv=none; d=zohomail.com; s=zohoarc; b=I2q+eQbO7Q4FUj7VtdReHqAwzDetcrjfVO1eUcU/27zITxJivZcT5it27eM+OI+reOyRE3dcUWnGMT3vaUbY23K9gHptPkyMEahcdo1q9PEe+2Wa18J7KoerBiDVOyxj8PLSFCr8ZQ9E1nMOvtgRb9b1BQ92Yny14iyKRJEtmLY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191897; 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=1CGq7RsxQNTob5PhDegp7KkfmxrZTsn1VhnQAdpWyDk=; b=f2X4DR8wSscCnAWN4TPRtI3VH+aYMMyI4PTI6uXL5a6Tm3xftgI3yUJ26+KInTWwNZV+bev+3Gw389hkqK8eyMPFCcCadMoFhNKHnrqkZ6HqoIy3Q1cgJY+IXjuAdKgZMIGb+/x6PDSez+PAQxGo6gmOTa1E1LCP8WcNDHAKU8Y= 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 1760191897018746.1671125671952; Sat, 11 Oct 2025 07:11:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8l-0006fV-5s; Sat, 11 Oct 2025 10:00:07 -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 1v7a8A-0006QA-Um for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:31 -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 1v7a7m-0004o3-3f for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:29 -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 21392C019D; Sat, 11 Oct 2025 16:58:27 +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-xjX6MjeU; Sat, 11 Oct 2025 16:58:26 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191106; bh=1CGq7RsxQNTob5PhDegp7KkfmxrZTsn1VhnQAdpWyDk=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=L2cKJLKTbsebslxNq5K5FzT98uYN4P9njCKT4Q1ZrGmrWhpxWMyVqYYJ0rAai1P70 GMQkomuwSnW+OWhjqqM7ovfwyp/iiSZF0mNiv08OIahBIWLTs0dmblmu/Luy7wxjnz TZOvRFFkp9TXJPVKTs842+IzFg4gMdOVZTQEJGQM= 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, Alex Williamson , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH 30/33] qapi/vfio.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:40 +0300 Message-ID: <20251011135754.294521-60-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191900522154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/vfio.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/qapi/vfio.json b/qapi/vfio.json index a1a9c5b673..a4c4f9f91c 100644 --- a/qapi/vfio.json +++ b/qapi/vfio.json @@ -53,7 +53,8 @@ # # .. qmp-example:: # -# <- { "timestamp": { "seconds": 1713771323, "microseconds": 212268 }, +# <- { "timestamp": { "seconds": 1713771323, +# "microseconds": 212268 }, # "event": "VFIO_MIGRATION", # "data": { # "device-id": "vfio_dev1", --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192624; cv=none; d=zohomail.com; s=zohoarc; b=YQsGDt8M+XA4ufVy4eS/7Rbeh7qlqeSDouDjRvWt9RQWv2Q4kVI1h/mTHYSyjniSrVV7vbtRhgOxUauc96f/Hn7yPXiahqNPsONwuTPLYC/6TaMjqUB4DDdLONo6ajwwEJyRf7pvTUDaaQnKyqZeqjZsRkiweToiSl1VQqNXpdo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192624; 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=Bgh0I22tjtIDyexIumg/uvSCP31Lm0cC6x+V9gfgWiY=; b=PBKYr5OQHvswGHO1iRdEal2Mk38iE/kvnWxS5ZeBGk3xCJ0ksFA6W/ch5m67wkMf9pWLR/sRAGu6T11+cdOwsDa4PshgwX2j6RCmSmZ+m/LDgw/lzJWAoLBUxofyQCRuY2ZFJ0rUSr+ccD0+5ouK3UiCSRO5sU7JF+3QpmU0Nhc= 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 1760192624219798.604072764912; Sat, 11 Oct 2025 07:23:44 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8y-0006zH-2G; Sat, 11 Oct 2025 10:00:20 -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 1v7a8J-0006SN-VW for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:40 -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 1v7a7l-0004oD-Pm for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:39 -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 675F6C0199; Sat, 11 Oct 2025 16:58:28 +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-fFzbGR0B; Sat, 11 Oct 2025 16:58:27 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191107; bh=Bgh0I22tjtIDyexIumg/uvSCP31Lm0cC6x+V9gfgWiY=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=YeuHnBMM2RjEuCD6R2bOp+SLuSmW+nJVRXs61F2MqIj2WomVlNQiRVcyLv9WKxcGd +nonKC2G83L01bA/2zfvS0oKJ+ZI1n7n/lPzG4SmHeJtooR6OA1CuEP/cjDAXzCBKe wuLRTcNgUn67mOmIYoPz24QtyuTrT6mT8C+gVsAs= 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, "Michael S. Tsirkin" Subject: [PATCH 31/33] qapi/virtio.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:42 +0300 Message-ID: <20251011135754.294521-62-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, T_SPF_HELO_TEMPERROR=0.01, T_SPF_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: 1760192633181158500 Content-Type: text/plain; charset="utf-8" For x-query-virtio-status just drop the examples. No idea how to bring them into 70 columns width. And the command is unstable anyway. Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/virtio.json | 269 ++++------------------------------------------- 1 file changed, 20 insertions(+), 249 deletions(-) diff --git a/qapi/virtio.json b/qapi/virtio.json index 05295ab665..5e5250944c 100644 --- a/qapi/virtio.json +++ b/qapi/virtio.json @@ -42,23 +42,23 @@ # <- { "return": [ # { # "name": "virtio-input", -# "path": "/machine/peripheral-anon/device[4]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[4]/vir..." # }, # { # "name": "virtio-crypto", -# "path": "/machine/peripheral/crypto0/virtio-backend" +# "path": "/machine/peripheral/crypto0/virtio-bac..." # }, # { # "name": "virtio-scsi", -# "path": "/machine/peripheral-anon/device[2]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[2]/vir..." # }, # { # "name": "virtio-net", -# "path": "/machine/peripheral-anon/device[1]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[1]/vir..." # }, # { # "name": "virtio-serial", -# "path": "/machine/peripheral-anon/device[0]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[0]/vir..." # } # ] # } @@ -204,239 +204,6 @@ # Returns: Status of the virtio device # # Since: 7.2 -# -# .. qmp-example:: -# :annotated: -# -# Poll for the status of virtio-crypto (no vhost-crypto active) -# :: -# -# -> { "execute": "x-query-virtio-status", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end" } -# } -# <- { "return": { -# "device-endian": "little", -# "bus-name": "", -# "disable-legacy-check": false, -# "name": "virtio-crypto", -# "started": true, -# "device-id": 20, -# "backend-features": { -# "transports": [], -# "dev-features": [] -# }, -# "start-on-kick": false, -# "isr": 1, -# "broken": false, -# "status": { -# "statuses": [ -# "VIRTIO_CONFIG_S_ACKNOWLEDGE: Valid virtio device f= ound", -# "VIRTIO_CONFIG_S_DRIVER: Guest OS compatible with d= evice", -# "VIRTIO_CONFIG_S_FEATURES_OK: Feature negotiation c= omplete", -# "VIRTIO_CONFIG_S_DRIVER_OK: Driver setup and ready" -# ] -# }, -# "num-vqs": 2, -# "guest-features": { -# "dev-features": [], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)" -# ] -# }, -# "host-features": { -# "unknown-dev-features": 1073741824, -# "unknown-dev-features2": 0, -# "dev-features": [], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "use-guest-notifier-mask": true, -# "vm-running": true, -# "queue-sel": 1, -# "disabled": false, -# "vhost-started": false, -# "use-started": true -# } -# } -# -# .. qmp-example:: -# :annotated: -# -# Poll for the status of virtio-net (vhost-net is active) -# :: -# -# -> { "execute": "x-query-virtio-status", -# "arguments": { "path": "/machine/peripheral-anon/device[1]/virt= io-backend" } -# } -# <- { "return": { -# "device-endian": "little", -# "bus-name": "", -# "disabled-legacy-check": false, -# "name": "virtio-net", -# "started": true, -# "device-id": 1, -# "vhost-dev": { -# "n-tmp-sections": 4, -# "n-mem-sections": 4, -# "max-queues": 1, -# "backend-cap": 2, -# "log-size": 0, -# "backend-features": { -# "dev-features": [], -# "transports": [] -# }, -# "nvqs": 2, -# "protocol-features": { -# "protocols": [] -# }, -# "vq-index": 0, -# "log-enabled": false, -# "acked-features": { -# "dev-features": [ -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge recei= ve buffers" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event f= ields enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descript= ors supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 sp= ec (legacy)" -# ] -# }, -# "features": { -# "dev-features": [ -# "VHOST_F_LOG_ALL: Logging write descriptors sup= ported", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge recei= ve buffers" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event f= ields enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descript= ors supported", -# "VIRTIO_F_IOMMU_PLATFORM: Device can be used on= IOMMU platform", -# "VIRTIO_F_VERSION_1: Device compliant for v1 sp= ec (legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary = desc. layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device r= uns out of avail. descs. on VQ" -# ] -# } -# }, -# "backend-features": { -# "dev-features": [ -# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protoco= l features negotiation supported", -# "VIRTIO_NET_F_GSO: Handling GSO-type packets suppor= ted", -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_RX_EXTRA: Extra RX mode control = supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "start-on-kick": false, -# "isr": 1, -# "broken": false, -# "status": { -# "statuses": [ -# "VIRTIO_CONFIG_S_ACKNOWLEDGE: Valid virtio device f= ound", -# "VIRTIO_CONFIG_S_DRIVER: Guest OS compatible with d= evice", -# "VIRTIO_CONFIG_S_FEATURES_OK: Feature negotiation c= omplete", -# "VIRTIO_CONFIG_S_DRIVER_OK: Driver setup and ready" -# ] -# }, -# "num-vqs": 3, -# "guest-features": { -# "dev-features": [ -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)" -# ] -# }, -# "host-features": { -# "dev-features": [ -# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protoco= l features negotiation supported", -# "VIRTIO_NET_F_GSO: Handling GSO-type packets suppor= ted", -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_RX_EXTRA: Extra RX mode control = supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "use-guest-notifier-mask": true, -# "vm-running": true, -# "queue-sel": 2, -# "disabled": false, -# "vhost-started": true, -# "use-started": true -# } -# } ## { 'command': 'x-query-virtio-status', 'data': { 'path': 'str' }, @@ -588,8 +355,9 @@ # :: # # -> { "execute": "x-query-virtio-queue-status", -# "arguments": { "path": "/machine/peripheral/vsock0/virtio-backe= nd", -# "queue": 1 } +# "arguments": { +# "path": "/machine/peripheral/vsock0/virtio-backend", +# "queue": 1 } # } # <- { "return": { # "signalled-used": 0, @@ -615,8 +383,9 @@ # :: # # -> { "execute": "x-query-virtio-queue-status", -# "arguments": { "path": "/machine/peripheral-anon/device[0]/virt= io-backend", -# "queue": 20 } +# "arguments": { +# "path": "/machine/peripheral-anon/device[0]/virtio-b...", +# "queue": 20 } # } # <- { "return": { # "signalled-used": 0, @@ -713,8 +482,9 @@ # :title: Get vhost_virtqueue status for vhost-crypto # # -> { "execute": "x-query-virtio-vhost-queue-status", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end", -# "queue": 0 } +# "arguments": { +# "path": "/machine/peripheral/crypto0/virtio-backend", +# "queue": 0 } # } # <- { "return": { # "avail-phys": 5216124928, @@ -737,8 +507,9 @@ # :title: Get vhost_virtqueue status for vhost-vsock # # -> { "execute": "x-query-virtio-vhost-queue-status", -# "arguments": { "path": "/machine/peripheral/vsock0/virtio-backe= nd", -# "queue": 0 } +# "arguments": { +# "path": "/machine/peripheral/vsock0/virtio-backend", +# "queue": 0 } # } # <- { "return": { # "avail-phys": 5182261248, @@ -860,7 +631,7 @@ # :title: Introspect on virtio-net's VirtQueue 0 at index 5 # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral-anon/device[1]/virt= io-backend", +# "arguments": { "path": "/machine/peripheral-anon/...", # "queue": 0, # "index": 5 } # } @@ -890,7 +661,7 @@ # :title: Introspect on virtio-crypto's VirtQueue 1 at head # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end", +# "arguments": { "path": "/machine/peripheral/crypto0/...", # "queue": 1 } # } # <- { "return": { @@ -919,7 +690,7 @@ # :title: Introspect on virtio-scsi's VirtQueue 2 at head # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral-anon/device[2]/virt= io-backend", +# "arguments": { "path": "/machine/peripheral-anon/...", # "queue": 2 } # } # <- { "return": { --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191664; cv=none; d=zohomail.com; s=zohoarc; b=K5JgqL5qByRiVOZpaO+gZeuBdt2BpfitcrHQF89j4YGmHeGyn0oJq4+t+/ZIqFCXd8wFdIzS34+s6OCWGZiS2bokteOfvHUdjrTJ1569j35DOFJJtcibxJxQVkltPECv0NPCM8FgSUfu/ydnR8tEcYbpN8Ggv2K04yleLHuFaQ4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191664; 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=Bgh0I22tjtIDyexIumg/uvSCP31Lm0cC6x+V9gfgWiY=; b=Wp9OEWtGiphLnul5gQKqAO2e2Q62S3ZISjnedALPwlosBO0bPzwqYtQp501DcIcKM1ds0eeHlglSafgvmOjvbfOqkDuVjH8Ny6cwZCnLBIxnrr/OCWWdFEThzXsoEHrFsxLtN+kX1pKfoC/4ixXce74q2dG44vfm0qZWtDfIatw= 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 1760191664091998.0272613940305; Sat, 11 Oct 2025 07:07:44 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aA5-0008KR-DY; Sat, 11 Oct 2025 10:01:30 -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 1v7a8B-0006QR-0I for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:32 -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 1v7a7l-0004oE-G1 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:30 -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 BF038C019E; Sat, 11 Oct 2025 16:58:27 +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-XgPtueZF; Sat, 11 Oct 2025 16:58:27 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191107; bh=Bgh0I22tjtIDyexIumg/uvSCP31Lm0cC6x+V9gfgWiY=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=PaWigYbaCeYDGghuUqA+0kQEl0yO2RbcSfZImm6EdAxMw6EMusf5p57HoOp4wvTOh i4hq9nhy1WzhhpfoxL9sTn/6rUssLq/8DFem/BK80X7PvUh/FCVsu9lDzlf2nN8rg6 NWSYX8v0tQiHXUSzkijGrhHdenv7UmQanZfNGcrA= 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, "Michael S. Tsirkin" Subject: [PATCH 31/33] qapi/virtio.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:41 +0300 Message-ID: <20251011135754.294521-61-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_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191665716158500 Content-Type: text/plain; charset="utf-8" For x-query-virtio-status just drop the examples. No idea how to bring them into 70 columns width. And the command is unstable anyway. Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/virtio.json | 269 ++++------------------------------------------- 1 file changed, 20 insertions(+), 249 deletions(-) diff --git a/qapi/virtio.json b/qapi/virtio.json index 05295ab665..5e5250944c 100644 --- a/qapi/virtio.json +++ b/qapi/virtio.json @@ -42,23 +42,23 @@ # <- { "return": [ # { # "name": "virtio-input", -# "path": "/machine/peripheral-anon/device[4]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[4]/vir..." # }, # { # "name": "virtio-crypto", -# "path": "/machine/peripheral/crypto0/virtio-backend" +# "path": "/machine/peripheral/crypto0/virtio-bac..." # }, # { # "name": "virtio-scsi", -# "path": "/machine/peripheral-anon/device[2]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[2]/vir..." # }, # { # "name": "virtio-net", -# "path": "/machine/peripheral-anon/device[1]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[1]/vir..." # }, # { # "name": "virtio-serial", -# "path": "/machine/peripheral-anon/device[0]/virtio-back= end" +# "path": "/machine/peripheral-anon/device[0]/vir..." # } # ] # } @@ -204,239 +204,6 @@ # Returns: Status of the virtio device # # Since: 7.2 -# -# .. qmp-example:: -# :annotated: -# -# Poll for the status of virtio-crypto (no vhost-crypto active) -# :: -# -# -> { "execute": "x-query-virtio-status", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end" } -# } -# <- { "return": { -# "device-endian": "little", -# "bus-name": "", -# "disable-legacy-check": false, -# "name": "virtio-crypto", -# "started": true, -# "device-id": 20, -# "backend-features": { -# "transports": [], -# "dev-features": [] -# }, -# "start-on-kick": false, -# "isr": 1, -# "broken": false, -# "status": { -# "statuses": [ -# "VIRTIO_CONFIG_S_ACKNOWLEDGE: Valid virtio device f= ound", -# "VIRTIO_CONFIG_S_DRIVER: Guest OS compatible with d= evice", -# "VIRTIO_CONFIG_S_FEATURES_OK: Feature negotiation c= omplete", -# "VIRTIO_CONFIG_S_DRIVER_OK: Driver setup and ready" -# ] -# }, -# "num-vqs": 2, -# "guest-features": { -# "dev-features": [], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)" -# ] -# }, -# "host-features": { -# "unknown-dev-features": 1073741824, -# "unknown-dev-features2": 0, -# "dev-features": [], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "use-guest-notifier-mask": true, -# "vm-running": true, -# "queue-sel": 1, -# "disabled": false, -# "vhost-started": false, -# "use-started": true -# } -# } -# -# .. qmp-example:: -# :annotated: -# -# Poll for the status of virtio-net (vhost-net is active) -# :: -# -# -> { "execute": "x-query-virtio-status", -# "arguments": { "path": "/machine/peripheral-anon/device[1]/virt= io-backend" } -# } -# <- { "return": { -# "device-endian": "little", -# "bus-name": "", -# "disabled-legacy-check": false, -# "name": "virtio-net", -# "started": true, -# "device-id": 1, -# "vhost-dev": { -# "n-tmp-sections": 4, -# "n-mem-sections": 4, -# "max-queues": 1, -# "backend-cap": 2, -# "log-size": 0, -# "backend-features": { -# "dev-features": [], -# "transports": [] -# }, -# "nvqs": 2, -# "protocol-features": { -# "protocols": [] -# }, -# "vq-index": 0, -# "log-enabled": false, -# "acked-features": { -# "dev-features": [ -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge recei= ve buffers" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event f= ields enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descript= ors supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 sp= ec (legacy)" -# ] -# }, -# "features": { -# "dev-features": [ -# "VHOST_F_LOG_ALL: Logging write descriptors sup= ported", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge recei= ve buffers" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event f= ields enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descript= ors supported", -# "VIRTIO_F_IOMMU_PLATFORM: Device can be used on= IOMMU platform", -# "VIRTIO_F_VERSION_1: Device compliant for v1 sp= ec (legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary = desc. layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device r= uns out of avail. descs. on VQ" -# ] -# } -# }, -# "backend-features": { -# "dev-features": [ -# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protoco= l features negotiation supported", -# "VIRTIO_NET_F_GSO: Handling GSO-type packets suppor= ted", -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_RX_EXTRA: Extra RX mode control = supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "start-on-kick": false, -# "isr": 1, -# "broken": false, -# "status": { -# "statuses": [ -# "VIRTIO_CONFIG_S_ACKNOWLEDGE: Valid virtio device f= ound", -# "VIRTIO_CONFIG_S_DRIVER: Guest OS compatible with d= evice", -# "VIRTIO_CONFIG_S_FEATURES_OK: Feature negotiation c= omplete", -# "VIRTIO_CONFIG_S_DRIVER_OK: Driver setup and ready" -# ] -# }, -# "num-vqs": 3, -# "guest-features": { -# "dev-features": [ -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)" -# ] -# }, -# "host-features": { -# "dev-features": [ -# "VHOST_USER_F_PROTOCOL_FEATURES: Vhost-user protoco= l features negotiation supported", -# "VIRTIO_NET_F_GSO: Handling GSO-type packets suppor= ted", -# "VIRTIO_NET_F_CTRL_MAC_ADDR: MAC address set throug= h control channel", -# "VIRTIO_NET_F_GUEST_ANNOUNCE: Driver sending gratui= tous packets supported", -# "VIRTIO_NET_F_CTRL_RX_EXTRA: Extra RX mode control = supported", -# "VIRTIO_NET_F_CTRL_VLAN: Control channel VLAN filte= ring supported", -# "VIRTIO_NET_F_CTRL_RX: Control channel RX mode supp= orted", -# "VIRTIO_NET_F_CTRL_VQ: Control channel available", -# "VIRTIO_NET_F_STATUS: Configuration status field av= ailable", -# "VIRTIO_NET_F_MRG_RXBUF: Driver can merge receive b= uffers", -# "VIRTIO_NET_F_HOST_UFO: Device can receive UFO", -# "VIRTIO_NET_F_HOST_ECN: Device can receive TSO with= ECN", -# "VIRTIO_NET_F_HOST_TSO6: Device can receive TSOv6", -# "VIRTIO_NET_F_HOST_TSO4: Device can receive TSOv4", -# "VIRTIO_NET_F_GUEST_UFO: Driver can receive UFO", -# "VIRTIO_NET_F_GUEST_ECN: Driver can receive TSO wit= h ECN", -# "VIRTIO_NET_F_GUEST_TSO6: Driver can receive TSOv6", -# "VIRTIO_NET_F_GUEST_TSO4: Driver can receive TSOv4", -# "VIRTIO_NET_F_MAC: Device has given MAC address", -# "VIRTIO_NET_F_CTRL_GUEST_OFFLOADS: Control channel = offloading reconfig. supported", -# "VIRTIO_NET_F_GUEST_CSUM: Driver handling packets w= ith partial checksum supported", -# "VIRTIO_NET_F_CSUM: Device handling packets with pa= rtial checksum supported" -# ], -# "transports": [ -# "VIRTIO_RING_F_EVENT_IDX: Used & avail. event field= s enabled", -# "VIRTIO_RING_F_INDIRECT_DESC: Indirect descriptors = supported", -# "VIRTIO_F_VERSION_1: Device compliant for v1 spec (= legacy)", -# "VIRTIO_F_ANY_LAYOUT: Device accepts arbitrary desc= . layouts", -# "VIRTIO_F_NOTIFY_ON_EMPTY: Notify when device runs = out of avail. descs. on VQ" -# ] -# }, -# "use-guest-notifier-mask": true, -# "vm-running": true, -# "queue-sel": 2, -# "disabled": false, -# "vhost-started": true, -# "use-started": true -# } -# } ## { 'command': 'x-query-virtio-status', 'data': { 'path': 'str' }, @@ -588,8 +355,9 @@ # :: # # -> { "execute": "x-query-virtio-queue-status", -# "arguments": { "path": "/machine/peripheral/vsock0/virtio-backe= nd", -# "queue": 1 } +# "arguments": { +# "path": "/machine/peripheral/vsock0/virtio-backend", +# "queue": 1 } # } # <- { "return": { # "signalled-used": 0, @@ -615,8 +383,9 @@ # :: # # -> { "execute": "x-query-virtio-queue-status", -# "arguments": { "path": "/machine/peripheral-anon/device[0]/virt= io-backend", -# "queue": 20 } +# "arguments": { +# "path": "/machine/peripheral-anon/device[0]/virtio-b...", +# "queue": 20 } # } # <- { "return": { # "signalled-used": 0, @@ -713,8 +482,9 @@ # :title: Get vhost_virtqueue status for vhost-crypto # # -> { "execute": "x-query-virtio-vhost-queue-status", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end", -# "queue": 0 } +# "arguments": { +# "path": "/machine/peripheral/crypto0/virtio-backend", +# "queue": 0 } # } # <- { "return": { # "avail-phys": 5216124928, @@ -737,8 +507,9 @@ # :title: Get vhost_virtqueue status for vhost-vsock # # -> { "execute": "x-query-virtio-vhost-queue-status", -# "arguments": { "path": "/machine/peripheral/vsock0/virtio-backe= nd", -# "queue": 0 } +# "arguments": { +# "path": "/machine/peripheral/vsock0/virtio-backend", +# "queue": 0 } # } # <- { "return": { # "avail-phys": 5182261248, @@ -860,7 +631,7 @@ # :title: Introspect on virtio-net's VirtQueue 0 at index 5 # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral-anon/device[1]/virt= io-backend", +# "arguments": { "path": "/machine/peripheral-anon/...", # "queue": 0, # "index": 5 } # } @@ -890,7 +661,7 @@ # :title: Introspect on virtio-crypto's VirtQueue 1 at head # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral/crypto0/virtio-back= end", +# "arguments": { "path": "/machine/peripheral/crypto0/...", # "queue": 1 } # } # <- { "return": { @@ -919,7 +690,7 @@ # :title: Introspect on virtio-scsi's VirtQueue 2 at head # # -> { "execute": "x-query-virtio-queue-element", -# "arguments": { "path": "/machine/peripheral-anon/device[2]/virt= io-backend", +# "arguments": { "path": "/machine/peripheral-anon/...", # "queue": 2 } # } # <- { "return": { --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191655; cv=none; d=zohomail.com; s=zohoarc; b=JFqTTxT+7ZvQf/O53MUpAMtGwNPROQXl1PVpACgt17bRFVu/CYk5HMlwTU7IrCRLCMTrDadcQPSH/kAzf4NyUtEuSl+0e2naZIRyhxohng/aOoVG+W1z7CVMgzoMYqGzYjb44b7hZ/KXPP717Htf+Ek59YjoBzOTv3Guv0RT3v4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191655; 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=jF5DMz7FK770rPiy+6De6nFoweGddyCi1itUtDW1KO8=; b=GcYvFhqdiVHC6Kxpw+iBUWlr/sZ5hp/uQNm7FWW7EjS8N3QmtA57iMZDf2fEf1Mfw19xF4WJTkF0CCCHHnhLcNp0RI5xZ1PvR5fncJB5YzEhHDAndQyCQ513wjtY3rIUESqDu85tV293c+pGRsOJB/x8NIv+wBvq+OAqLFsQDqA= 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 1760191655890370.12748626348673; Sat, 11 Oct 2025 07:07:35 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a90-00071C-LP; Sat, 11 Oct 2025 10:00:22 -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 1v7a8E-0006Ra-3z for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:34 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7p-0004oh-JG for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:33 -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 0506CC019F; Sat, 11 Oct 2025 16:58:29 +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-gqjyLuHv; Sat, 11 Oct 2025 16:58:28 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191108; bh=jF5DMz7FK770rPiy+6De6nFoweGddyCi1itUtDW1KO8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=XHuTFzoG3/IytAsH91wE0tLgA1DvbPrNEwvUJdr3Omx3Z2o+OGC1bjxXdneZViHDP uSUvxgxtosZOAJN8FMSAsp45O7v4Po3bKp2ZI0lf299zmeeAhSCjrraUPOuADUM8XX NODoX0URFhVqXUy6kX+H1dTtGL0z0bPmEzL36Y14= 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, Michael Roth , Kostiantyn Kostiuk Subject: [PATCH 32/33] qga/qapi-schema.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:43 +0300 Message-ID: <20251011135754.294521-63-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191659602158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qga/qapi-schema.json | 83 ++++++++++++++++++++++++-------------------- 1 file changed, 45 insertions(+), 38 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index 8162d888bb..9e3fd1eee5 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -96,8 +96,8 @@ # In cases where a partial stale response was previously received by # the client, this cannot always be done reliably. One particular # scenario being if qemu-ga responses are fed character-by-character -# into a JSON parser. In these situations, using `guest-sync-delimited` -# may be optimal. +# into a JSON parser. In these situations, using +# `guest-sync-delimited` may be optimal. # # For clients that fetch responses line by line and convert them to # JSON objects, `guest-sync` should be sufficient, but note that in @@ -153,9 +153,9 @@ # This command tries to set guest's System Time to the given value, # then sets the Hardware Clock (RTC) to the current System Time. This # will make it easier for a guest to resynchronize without waiting for -# NTP. If no @time is specified, then the time to set is read from -# RTC. However, this may not be supported on all platforms (i.e. -# Windows). If that's the case users are advised to always pass a +# NTP. If no @time is specified, then the time to set is read from +# RTC. However, this may not be supported on all platforms (i.e. +# Windows). If that's the case users are advised to always pass a # value. # # @time: time of nanoseconds, relative to the Epoch of 1970-01-01 in @@ -444,8 +444,8 @@ # Returns: Number of file systems currently frozen. # # .. note:: On Windows, the command is implemented with the help of a -# Volume Shadow-copy Service DLL helper. The frozen state is limited -# for up to 10 seconds by VSS. +# Volume Shadow-copy Service DLL helper. The frozen state is +# limited for up to 10 seconds by VSS. # # Since: 0.15.0 ## @@ -482,9 +482,9 @@ # Returns: Number of file systems thawed by this call # # .. note:: If the return value does not match the previous call to -# `guest-fsfreeze-freeze`, this likely means some freezable filesystems -# were unfrozen before this call, and that the filesystem state may -# have changed before issuing this command. +# `guest-fsfreeze-freeze`, this likely means some freezable +# filesystems were unfrozen before this call, and that the +# filesystem state may have changed before issuing this command. # # Since: 0.15.0 ## @@ -513,7 +513,8 @@ ## # @GuestFilesystemTrimResponse: # -# @paths: list of `GuestFilesystemTrimResult` per path that was trimmed +# @paths: list of `GuestFilesystemTrimResult` per path that was +# trimmed # # Since: 2.4 ## @@ -557,16 +558,16 @@ # # This command does NOT return a response on success. There is a high # chance the command succeeded if the VM exits with a zero exit status -# or, when running with --no-shutdown, by issuing the `query-status` QMP -# command to to confirm the VM status is "shutdown". However, the VM -# could also exit (or set its status to "shutdown") due to other +# or, when running with --no-shutdown, by issuing the `query-status` +# QMP command to to confirm the VM status is "shutdown". However, the +# VM could also exit (or set its status to "shutdown") due to other # reasons. # # Errors: # - If suspend to disk is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -586,7 +587,7 @@ # - manual write into sysfs # # IMPORTANT: `guest-suspend-ram` requires working wakeup support in -# QEMU. You should check QMP command `query-current-machine` returns +# QEMU. You should check QMP command `query-current-machine` returns # wakeup-suspend-support: true before issuing this command. Failure # in doing so can result in a suspended guest that QEMU will not be # able to awaken, forcing the user to power cycle the guest to bring @@ -602,8 +603,8 @@ # Errors: # - If suspend to ram is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -622,7 +623,7 @@ # - pm-utils (via pm-suspend-hybrid) # # IMPORTANT: `guest-suspend-hybrid` requires working wakeup support in -# QEMU. You should check QMP command `query-current-machine` returns +# QEMU. You should check QMP command `query-current-machine` returns # wakeup-suspend-support: true before issuing this command. Failure # in doing so can result in a suspended guest that QEMU will not be # able to awaken, forcing the user to power cycle the guest to bring @@ -638,8 +639,8 @@ # Errors: # - If hybrid suspend is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -1048,10 +1049,11 @@ # # @used-bytes: file system used bytes (since 3.0) # -# @total-bytes: filesystem capacity in bytes for unprivileged users (since= 3.0) +# @total-bytes: filesystem capacity in bytes for unprivileged users +# (since 3.0) # -# @total-bytes-privileged: filesystem capacity in bytes for privileged use= rs -# (since 9.1) +# @total-bytes-privileged: filesystem capacity in bytes for privileged +# users (since 9.1) # # @disk: an array of disk hardware information that the volume lies # on, which may be empty if the disk type is not supported @@ -1171,7 +1173,8 @@ ## # @GuestMemoryBlockResponse: # -# @phys-index: same with the 'phys-index' member of `GuestMemoryBlock`. +# @phys-index: same with the 'phys-index' member of +# `GuestMemoryBlock`. # # @response: the result of memory block operation. # @@ -1491,10 +1494,11 @@ # # .. note:: On POSIX systems the fields @id, @name, @pretty-name, # @version, @version-id, @variant and @variant-id follow the -# definition specified in os-release(5). Refer to the manual page for -# exact description of the fields. Their values are taken from the -# os-release file. If the file is not present in the system, or the -# values are not present in the file, the fields are not included. +# definition specified in os-release(5). Refer to the manual page +# for exact description of the fields. Their values are taken from +# the os-release file. If the file is not present in the system, +# or the values are not present in the file, the fields are not +# included. # # On Windows the values are filled from information gathered from # the system. @@ -1639,7 +1643,7 @@ # @guest-ssh-remove-authorized-keys: # # Remove public keys from the user .ssh/authorized_keys on Unix -# systems (not implemented for other systems). It's not an error if +# systems (not implemented for other systems). It's not an error if # the key is already missing. # # @username: the user account to remove the authorized keys @@ -1862,10 +1866,10 @@ # # Retrieve CPU process load information # -# .. note:: Windows does not have load average API, so QGA emulates it by -# calculating the average CPU usage in the last 1, 5, 15 minutes -# similar as Linux does this. -# Calculation starts from the first time this command is called. +# .. note:: Windows does not have load average API, so QGA emulates it +# by calculating the average CPU usage in the last 1, 5, 15 +# minutes similar as Linux does this. Calculation starts from the +# first time this command is called. # # Returns: load information # @@ -1881,9 +1885,11 @@ # # Route information, currently, only linux supported. # -# @iface: The destination network or host's egress network interface in th= e routing table +# @iface: The destination network or host's egress network interface +# in the routing table # -# @destination: The IP address of the target network or host, The final de= stination of the packet +# @destination: The IP address of the target network or host, The +# final destination of the packet # # @metric: Route metric # @@ -1899,7 +1905,8 @@ # # @use: Route usage count (not for windows) # -# @window: TCP window size, used for flow control (not for windows, IPv4 o= nly) +# @window: TCP window size, used for flow control (not for windows, +# IPv4 only) # # @mtu: Data link layer maximum packet size (not for windows) # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191676; cv=none; d=zohomail.com; s=zohoarc; b=eSZze0iLmRaUZXcDFqQGp1gFvOzoT4Uxe51870qxIp8p1MHSHkuRCJpqq9SAyuC8jVcLY86O24EnEdDK5vOlWIziMvn5I2EIhPmW+374UeqUaXoaU40UFYHmSRMyuhRidONnt2jLUvoZ0Q0zJVIovQJUtmoE1z16c9RBSFbtZn8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191676; 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=jF5DMz7FK770rPiy+6De6nFoweGddyCi1itUtDW1KO8=; b=jfty1eFejLY5oF8ZcZl+WYCsiIwnADS+8YQp8ok2c4udYgG6DjQjXEkx57Y82zPxhebcoBaS+/o6QlO8H5D2tS4geJJk7UyjIC9TvlomeHeaYyrucGH9zpy7NFoiM1qiqNwEQyFW0nbiqgc1HxrlJgcEtIN/h41HzTIEJvwH/Fk= 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 176019167596779.76509355016049; Sat, 11 Oct 2025 07:07:55 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aAP-00010N-28; Sat, 11 Oct 2025 10:01:49 -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 1v7a8N-0006Tz-S0 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:43 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7q-0004oy-20 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:43 -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 9B3F5C01A0; Sat, 11 Oct 2025 16:58:29 +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-ODzUNXSf; Sat, 11 Oct 2025 16:58:29 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191109; bh=jF5DMz7FK770rPiy+6De6nFoweGddyCi1itUtDW1KO8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=zRO3/jRVNNTpcy3R1wuFkj/u8k2kxL6lOgdKS0nMyy8cMrXN31B4V29FenuNb15BW Lu8mtS/myiMot4c8lykeVv/SFsVPB0HbDfJLmPACp0HsTwix9Kcjj0Nvk8cKlH/yWh patOyMp9KVdm0W0KFczXipnbq+7puLA6tGxUA7Js= 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, Michael Roth , Kostiantyn Kostiuk Subject: [PATCH 32/33] qga/qapi-schema.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:44 +0300 Message-ID: <20251011135754.294521-64-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, 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: 1760191679814158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qga/qapi-schema.json | 83 ++++++++++++++++++++++++-------------------- 1 file changed, 45 insertions(+), 38 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index 8162d888bb..9e3fd1eee5 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -96,8 +96,8 @@ # In cases where a partial stale response was previously received by # the client, this cannot always be done reliably. One particular # scenario being if qemu-ga responses are fed character-by-character -# into a JSON parser. In these situations, using `guest-sync-delimited` -# may be optimal. +# into a JSON parser. In these situations, using +# `guest-sync-delimited` may be optimal. # # For clients that fetch responses line by line and convert them to # JSON objects, `guest-sync` should be sufficient, but note that in @@ -153,9 +153,9 @@ # This command tries to set guest's System Time to the given value, # then sets the Hardware Clock (RTC) to the current System Time. This # will make it easier for a guest to resynchronize without waiting for -# NTP. If no @time is specified, then the time to set is read from -# RTC. However, this may not be supported on all platforms (i.e. -# Windows). If that's the case users are advised to always pass a +# NTP. If no @time is specified, then the time to set is read from +# RTC. However, this may not be supported on all platforms (i.e. +# Windows). If that's the case users are advised to always pass a # value. # # @time: time of nanoseconds, relative to the Epoch of 1970-01-01 in @@ -444,8 +444,8 @@ # Returns: Number of file systems currently frozen. # # .. note:: On Windows, the command is implemented with the help of a -# Volume Shadow-copy Service DLL helper. The frozen state is limited -# for up to 10 seconds by VSS. +# Volume Shadow-copy Service DLL helper. The frozen state is +# limited for up to 10 seconds by VSS. # # Since: 0.15.0 ## @@ -482,9 +482,9 @@ # Returns: Number of file systems thawed by this call # # .. note:: If the return value does not match the previous call to -# `guest-fsfreeze-freeze`, this likely means some freezable filesystems -# were unfrozen before this call, and that the filesystem state may -# have changed before issuing this command. +# `guest-fsfreeze-freeze`, this likely means some freezable +# filesystems were unfrozen before this call, and that the +# filesystem state may have changed before issuing this command. # # Since: 0.15.0 ## @@ -513,7 +513,8 @@ ## # @GuestFilesystemTrimResponse: # -# @paths: list of `GuestFilesystemTrimResult` per path that was trimmed +# @paths: list of `GuestFilesystemTrimResult` per path that was +# trimmed # # Since: 2.4 ## @@ -557,16 +558,16 @@ # # This command does NOT return a response on success. There is a high # chance the command succeeded if the VM exits with a zero exit status -# or, when running with --no-shutdown, by issuing the `query-status` QMP -# command to to confirm the VM status is "shutdown". However, the VM -# could also exit (or set its status to "shutdown") due to other +# or, when running with --no-shutdown, by issuing the `query-status` +# QMP command to to confirm the VM status is "shutdown". However, the +# VM could also exit (or set its status to "shutdown") due to other # reasons. # # Errors: # - If suspend to disk is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -586,7 +587,7 @@ # - manual write into sysfs # # IMPORTANT: `guest-suspend-ram` requires working wakeup support in -# QEMU. You should check QMP command `query-current-machine` returns +# QEMU. You should check QMP command `query-current-machine` returns # wakeup-suspend-support: true before issuing this command. Failure # in doing so can result in a suspended guest that QEMU will not be # able to awaken, forcing the user to power cycle the guest to bring @@ -602,8 +603,8 @@ # Errors: # - If suspend to ram is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -622,7 +623,7 @@ # - pm-utils (via pm-suspend-hybrid) # # IMPORTANT: `guest-suspend-hybrid` requires working wakeup support in -# QEMU. You should check QMP command `query-current-machine` returns +# QEMU. You should check QMP command `query-current-machine` returns # wakeup-suspend-support: true before issuing this command. Failure # in doing so can result in a suspended guest that QEMU will not be # able to awaken, forcing the user to power cycle the guest to bring @@ -638,8 +639,8 @@ # Errors: # - If hybrid suspend is not supported, Unsupported # -# .. note:: It's strongly recommended to issue the `guest-sync` command -# before sending commands when the guest resumes. +# .. note:: It's strongly recommended to issue the `guest-sync` +# command before sending commands when the guest resumes. # # Since: 1.1 ## @@ -1048,10 +1049,11 @@ # # @used-bytes: file system used bytes (since 3.0) # -# @total-bytes: filesystem capacity in bytes for unprivileged users (since= 3.0) +# @total-bytes: filesystem capacity in bytes for unprivileged users +# (since 3.0) # -# @total-bytes-privileged: filesystem capacity in bytes for privileged use= rs -# (since 9.1) +# @total-bytes-privileged: filesystem capacity in bytes for privileged +# users (since 9.1) # # @disk: an array of disk hardware information that the volume lies # on, which may be empty if the disk type is not supported @@ -1171,7 +1173,8 @@ ## # @GuestMemoryBlockResponse: # -# @phys-index: same with the 'phys-index' member of `GuestMemoryBlock`. +# @phys-index: same with the 'phys-index' member of +# `GuestMemoryBlock`. # # @response: the result of memory block operation. # @@ -1491,10 +1494,11 @@ # # .. note:: On POSIX systems the fields @id, @name, @pretty-name, # @version, @version-id, @variant and @variant-id follow the -# definition specified in os-release(5). Refer to the manual page for -# exact description of the fields. Their values are taken from the -# os-release file. If the file is not present in the system, or the -# values are not present in the file, the fields are not included. +# definition specified in os-release(5). Refer to the manual page +# for exact description of the fields. Their values are taken from +# the os-release file. If the file is not present in the system, +# or the values are not present in the file, the fields are not +# included. # # On Windows the values are filled from information gathered from # the system. @@ -1639,7 +1643,7 @@ # @guest-ssh-remove-authorized-keys: # # Remove public keys from the user .ssh/authorized_keys on Unix -# systems (not implemented for other systems). It's not an error if +# systems (not implemented for other systems). It's not an error if # the key is already missing. # # @username: the user account to remove the authorized keys @@ -1862,10 +1866,10 @@ # # Retrieve CPU process load information # -# .. note:: Windows does not have load average API, so QGA emulates it by -# calculating the average CPU usage in the last 1, 5, 15 minutes -# similar as Linux does this. -# Calculation starts from the first time this command is called. +# .. note:: Windows does not have load average API, so QGA emulates it +# by calculating the average CPU usage in the last 1, 5, 15 +# minutes similar as Linux does this. Calculation starts from the +# first time this command is called. # # Returns: load information # @@ -1881,9 +1885,11 @@ # # Route information, currently, only linux supported. # -# @iface: The destination network or host's egress network interface in th= e routing table +# @iface: The destination network or host's egress network interface +# in the routing table # -# @destination: The IP address of the target network or host, The final de= stination of the packet +# @destination: The IP address of the target network or host, The +# final destination of the packet # # @metric: Route metric # @@ -1899,7 +1905,8 @@ # # @use: Route usage count (not for windows) # -# @window: TCP window size, used for flow control (not for windows, IPv4 o= nly) +# @window: TCP window size, used for flow control (not for windows, +# IPv4 only) # # @mtu: Data link layer maximum packet size (not for windows) # --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760192718; cv=none; d=zohomail.com; s=zohoarc; b=WXVY5gJdFp9lUlhI9KZ5pKk6h9GQNwiyvkJTDdxdYdvv/41oY+3XEjNzC2JA+93Wi1Unx18yn7IJJfQlPi6JlmNadEqwZCwdVdMTYF9S5J1UTDUu5RySUeATwvfoEkdvEmRWMk+pfoMfGc5MC+9/PB4w9XcO/9p74CpuHgiCpXA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192718; 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=5V8+nPe1WDxsELTvlJ8cDdkGQXkPP96lZ8aVheUJlJU=; b=GHExGR8ZMYADeAM3wLgvLkDKVHap4HpawRd3/d/ENTczCZwAsltMGFdmeMWqdVbPvwWsubJb9cBTVMyTeNQefUJ+O0byXw1f7qKAqxkxXsL1eq1SYpfxudLa/5sXXp9btEXipyQlcVdd0y5SmyNJU9/9i+nUJ5IE4xTYvX+aLYY= 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 1760192718468721.2734827546861; Sat, 11 Oct 2025 07:25:18 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aAK-0000fI-Ns; Sat, 11 Oct 2025 10:01:44 -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 1v7a8M-0006St-D3 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:42 -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 1v7a7s-0004os-Pq for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:40 -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 0F6AAC01A2; Sat, 11 Oct 2025 16:58:31 +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-Z6RCjMKG; Sat, 11 Oct 2025 16:58:30 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191110; bh=5V8+nPe1WDxsELTvlJ8cDdkGQXkPP96lZ8aVheUJlJU=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=VArfVC4awRzvSlnPicaielsJ0qWcFQ9SpTi4kNO/9CuPMtE+wkY/rdBvZpzLzgC2X hRQ3xIpxY7XIzOr7tYM8Ew8FFMcnmLW7KI2NSWVb7kJlyOUKPr4iBiYMJIY/IFA6sU BVXMS6uCrF9nDPQZUQqqgf2e6SlKv4u4M3cOumiQ= 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, Mauro Carvalho Chehab Subject: [PATCH 33/33] qapi/acpi-hest.json: reflow docs to width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:46 +0300 Message-ID: <20251011135754.294521-66-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_HELO_NONE=0.001, T_SPF_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: 1760192719799158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/acpi-hest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qapi/acpi-hest.json b/qapi/acpi-hest.json index 28af1266a7..22a28b2199 100644 --- a/qapi/acpi-hest.json +++ b/qapi/acpi-hest.json @@ -6,7 +6,7 @@ # =3D=3D GHESv2 CPER Error Injection # # Defined since ACPI Specification 6.1, -# section 18.3.2.8 Generic Hardware Error Source version 2. See: +# section 18.3.2.8 Generic Hardware Error Source version 2. See: # # https://uefi.org/sites/default/files/resources/ACPI_6_1.pdf ## --=20 2.48.1 From nobody Fri Nov 14 18:23:26 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=1760191498; cv=none; d=zohomail.com; s=zohoarc; b=WXN+RoOojltq+cxa+H1XxGBV36inNCJKLFSWlSdwLa4g9MaoDIJBG1XsrT5wziQvRv5r/p5e1oL1GfMdm+Oog02c5+zLMYU8G9b5vbAJ+7jD+2b2CCDFjHlAg19JnXWdWAMpbYGDDnFFHvIWGt/k5DYspJFs+XN9YrVHTjin6Gg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191498; 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=5V8+nPe1WDxsELTvlJ8cDdkGQXkPP96lZ8aVheUJlJU=; b=hiMvNsWeUP3qVTLCbgdaZKfwy8Bjs6JyxL56fzCl+AlqbTlzIcaEzT1n1bGgig0G+rG+kQte+8XvtIuJRc8DmQHyHgKyRibkPf82szYsLC/i2K8betmHwY0Aail/AxlMTFimsjFqBPdgD5/UTvzJS7TY62Ao2JQir0RmHoOqtX8= 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 17601914980971004.6473591737657; Sat, 11 Oct 2025 07:04:58 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8t-0006uh-Qm; Sat, 11 Oct 2025 10:00:16 -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 1v7a8E-0006Rb-IS for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:34 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7q-0004or-20 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:33 -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 624ABC0139; Sat, 11 Oct 2025 16:58:30 +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-TMoyELd9; Sat, 11 Oct 2025 16:58:29 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191110; bh=5V8+nPe1WDxsELTvlJ8cDdkGQXkPP96lZ8aVheUJlJU=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=V2OsHldxQjphbXCQvbmUR65ai8zGj8aRWnRcq2iByp+m+qijINaLBez2V9/cQZT2M DDyPDSLdgwfdm869fT3PkpWQ0et/v7aiHVzONyWSpsHbSBf0/23eLS+lPpmO1pqAy4 A2G4Xen8mEahcNUkzloiUOlht+pTstGtEuyTT4MM= 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, Mauro Carvalho Chehab Subject: [PATCH 33/33] qapi/acpi-hest.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:45 +0300 Message-ID: <20251011135754.294521-65-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net 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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: 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: 1760191501250154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/acpi-hest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qapi/acpi-hest.json b/qapi/acpi-hest.json index 28af1266a7..22a28b2199 100644 --- a/qapi/acpi-hest.json +++ b/qapi/acpi-hest.json @@ -6,7 +6,7 @@ # =3D=3D GHESv2 CPER Error Injection # # Defined since ACPI Specification 6.1, -# section 18.3.2.8 Generic Hardware Error Source version 2. See: +# section 18.3.2.8 Generic Hardware Error Source version 2. See: # # https://uefi.org/sites/default/files/resources/ACPI_6_1.pdf ## --=20 2.48.1