From nobody Fri Nov 14 21:04:53 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=1760192061; cv=none; d=zohomail.com; s=zohoarc; b=MQ2i6OoEiV6OrdW/bPNJmomoGaHeaEa6b1II/arIE7uiJSX6o1MFosghAkwUn3JLPEOd6oYkF6jFZx4gLl6gDyiiZ2GQsxnmjQON8qj55USxgEEk2rBJYMtlIOKjLVgsHY0RlpsjDc3sD+90yViGyrIqP05tZxb2YTat4oXazvA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192061; 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=I4mlmDYgLz/A2xq6uiydRvdcXOX8BGcA8Bw1MP/LyqZ2PhPgSLP1CFk4pg8GLS+ErwC60u0Y8ECQze8B/1+bpwE+bS1PFrAzrflTaNYErXZNjFnJ5xh6M9ryib7E9fFMTLBVGKYm18F/o/qIt0FZizc8bphNpcyH4ho1DwrcdaQ= 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 1760192061976148.56936902521306; Sat, 11 Oct 2025 07:14:21 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aEE-0005PV-PN; Sat, 11 Oct 2025 10:05: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 1v7aDp-0004g1-1f for qemu-devel@nongnu.org; Sat, 11 Oct 2025 10:05: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 1v7aDc-0005an-Oe for qemu-devel@nongnu.org; Sat, 11 Oct 2025 10:05:20 -0400 Received: from mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net [IPv6:2a02:6b8:c2d:7394:0:640:5a8a:0]) by forwardcorp1a.mail.yandex.net (Yandex) with ESMTPS id 8C6E9C01A0; Sat, 11 Oct 2025 17:04:54 +0300 (MSK) Received: from vsementsov-lin.. (unknown [2a02:6bf:8080:a4b::1:3c]) by mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id h4NOTl1FrqM0-vVT1swlq; Sat, 11 Oct 2025 17:04:54 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191494; bh=UIcniQdwd/ae/0mlqDqWCCJREenQAzGUtQQWDB4sJo8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=qWmdSolmqLXyU6V4E6bFkur++Jvlcl/67grFE6ZNO8wEnsnFKJWeaJW4Xt5C73AaH vUvo+E+e0cBI89mPjwKU6o22Qzd86uRjhVSQEm2NR0LSjE0EEONrcxmflw7QV7JPuH G9eIKmcwOEvnsbXfSg5L+K635sU6p14Jy3xBmYnY= Authentication-Results: mail-nwsmtp-smtp-corp-main-83.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 v2 18/33] qapi/net.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 17:04:24 +0300 Message-ID: <20251011140441.297246-19-vsementsov@yandex-team.ru> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20251011140441.297246-1-vsementsov@yandex-team.ru> References: <20251011140441.297246-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: 1760192063757154100 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