From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Alex Bennée" <alex.bennee@linaro.org>,
"Lukas Straub" <lukasstraub2@web.de>,
"Vladimir Sementsov-Ogievskiy" <vsementsov@yandex-team.ru>,
"Zhao Liu" <zhao1.liu@intel.com>,
"Laurent Vivier" <laurent@vivier.eu>,
"Markus Armbruster" <armbru@redhat.com>,
"Gonglei (Arei)" <arei.gonglei@huawei.com>,
"Philippe Mathieu-Daudé" <philmd@mailo.com>,
"Alex Williamson" <alex@shazbot.org>,
"zhenwei pi" <zhenwei.pi@linux.dev>,
"Hanna Reitz" <hreitz@redhat.com>,
"Ani Sinha" <anisinha@redhat.com>,
qemu-block@nongnu.org, "Paolo Bonzini" <pbonzini@redhat.com>,
"Peter Xu" <peterx@redhat.com>, "Kevin Wolf" <kwolf@redhat.com>,
linux-cxl@vger.kernel.org, "Jiri Pirko" <jiri@resnulli.us>,
"Daniel P. Berrangé" <berrange@redhat.com>,
"Stefan Berger" <stefanb@linux.vnet.ibm.com>,
"Fabiano Rosas" <farosas@suse.de>, "John Snow" <jsnow@redhat.com>,
"Stefan Hajnoczi" <stefanha@redhat.com>,
"Michael Tokarev" <mjt@tls.msk.ru>,
"Igor Mammedov" <imammedo@redhat.com>,
"Michael S. Tsirkin" <mst@redhat.com>,
"Gerd Hoffmann" <kraxel@redhat.com>,
"Mauro Carvalho Chehab" <mchehab+huawei@kernel.org>,
linux-edac@vger.kernel.org,
"Marc-André Lureau" <marcandre.lureau@redhat.com>,
"Richard Henderson" <richard.henderson@linaro.org>,
"Eric Blake" <eblake@redhat.com>,
"Cédric Le Goater" <clg@redhat.com>,
"Jason Wang" <jasowangio@gmail.com>,
qemu-trivial@nongnu.org, "Jonathan Cameron" <jic23@kernel.org>
Subject: [PATCH v2 30/44] qapi: convert trivial intro sections for block-export.json
Date: Thu, 23 Jul 2026 00:47:51 -0400 [thread overview]
Message-ID: <20260723044805.527643-31-jsnow@redhat.com> (raw)
In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com>
(Trivial)
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/block-export.json | 87 +++++++++++++++++-------------------------
1 file changed, 35 insertions(+), 52 deletions(-)
diff --git a/qapi/block-export.json b/qapi/block-export.json
index dd724acf1cb..e9f7e72c8ee 100644
--- a/qapi/block-export.json
+++ b/qapi/block-export.json
@@ -37,10 +37,9 @@
##
# @NbdServerOptions:
-#
-# Keep this type consistent with the `NbdServerOptionsLegacy` type.
-# The only intended difference is using `SocketAddress` instead of
-# `SocketAddressLegacy`.
+# Keep this type consistent with the `NbdServerOptionsLegacy`
+# type. The only intended difference is using `SocketAddress`
+# instead of `SocketAddressLegacy`.
#
# @addr: Address on which to listen (since 4.2).
##
@@ -50,10 +49,9 @@
##
# @NbdServerOptionsLegacy:
-#
-# Keep this type consistent with the `NbdServerOptions` type. The
-# only intended difference is using `SocketAddressLegacy` instead of
-# `SocketAddress`.
+# Keep this type consistent with the `NbdServerOptions` type. The
+# only intended difference is using `SocketAddressLegacy` instead
+# of `SocketAddress`.
#
# @addr: Address on which to listen (since 1.3).
##
@@ -63,11 +61,11 @@
##
# @nbd-server-start:
-#
-# Start an NBD server listening on the given host and port. Block
-# devices can then be exported using `nbd-server-add`. The NBD server
-# will present them as named exports; for example, another QEMU
-# instance could refer to them as "nbd:HOST:PORT:exportname=NAME".
+# Start an NBD server listening on the given host and port. Block
+# devices can then be exported using `nbd-server-add`. The NBD
+# server will present them as named exports; for example, another
+# QEMU instance could refer to them as
+# "nbd:HOST:PORT:exportname=NAME".
#
# Errors:
# - if the server is already running
@@ -80,9 +78,8 @@
##
# @BlockExportOptionsNbdBase:
-#
-# An NBD block export (common options shared between `nbd-server-add`
-# and the NBD branch of `block-export-add`).
+# An NBD block export (common options shared between
+# `nbd-server-add` and the NBD branch of `block-export-add`).
#
# @name: Export name. If unspecified, the @device parameter is used
# as the export name. (Since 2.12)
@@ -97,9 +94,8 @@
##
# @BlockExportOptionsNbd:
-#
-# An NBD block export (distinct options used in the NBD branch of
-# `block-export-add`).
+# An NBD block export (distinct options used in the NBD branch of
+# `block-export-add`).
#
# @bitmaps: Also export each of the named dirty bitmaps reachable from
# @device, so the NBD client can use NBD_OPT_SET_META_CONTEXT with
@@ -121,8 +117,7 @@
##
# @BlockExportOptionsVhostUserBlk:
-#
-# A vhost-user-blk block export.
+# A vhost-user-blk block export.
#
# @addr: The vhost-user socket on which to listen. Both 'unix' and
# 'fd' `SocketAddress` types are supported. Passed fds must be
@@ -143,8 +138,7 @@
##
# @FuseExportAllowOther:
-#
-# Possible allow_other modes for FUSE exports.
+# Possible allow_other modes for FUSE exports.
#
# @off: Do not pass allow_other as a mount option.
#
@@ -195,8 +189,7 @@
##
# @BlockExportOptionsVduseBlk:
-#
-# A vduse-blk block export.
+# A vduse-blk block export.
#
# @name: the name of VDUSE device (must be unique across the host).
#
@@ -221,8 +214,7 @@
##
# @NbdServerAddOptions:
-#
-# An NBD block export, per legacy `nbd-server-add` command.
+# An NBD block export, per legacy `nbd-server-add` command.
#
# @device: The device name or node name of the node to be exported
#
@@ -266,8 +258,7 @@
##
# @BlockExportRemoveMode:
-#
-# Mode for removing a block export.
+# Mode for removing a block export.
#
# @safe: Remove export if there are no existing connections, fail
# otherwise.
@@ -289,8 +280,7 @@
##
# @nbd-server-remove:
-#
-# Remove NBD export by name.
+# Remove NBD export by name.
#
# @name: Block export id.
#
@@ -316,9 +306,8 @@
##
# @nbd-server-stop:
-#
-# Stop QEMU's embedded NBD server, and unregister all devices
-# previously added via `nbd-server-add`.
+# Stop QEMU's embedded NBD server, and unregister all devices
+# previously added via `nbd-server-add`.
#
# Since: 1.3
##
@@ -327,8 +316,7 @@
##
# @BlockExportType:
-#
-# An enumeration of block export types
+# An enumeration of block export types
#
# @nbd: NBD export
#
@@ -349,9 +337,8 @@
##
# @BlockExportOptions:
-#
-# Describes a block export, i.e. how single node should be exported on
-# an external interface.
+# Describes a block export, i.e. how single node should be
+# exported on an external interface.
#
# @type: Block export type
#
@@ -412,9 +399,8 @@
##
# @BlockExportIothreads:
-#
-# Specify a single or multiple I/O threads in which to run a block
-# export's I/O.
+# Specify a single or multiple I/O threads in which to run a block
+# export's I/O.
#
# @single: Run the export's I/O in the given single I/O thread.
#
@@ -436,8 +422,7 @@
##
# @block-export-add:
-#
-# Creates a new block export.
+# Creates a new block export.
#
# Since: 5.2
##
@@ -447,10 +432,10 @@
##
# @block-export-del:
-#
-# Request to remove a block export. This drops the user's reference
-# to the export, but the export may still stay around after this
-# command returns until the shutdown of the export has completed.
+# Request to remove a block export. This drops the user's
+# reference to the export, but the export may still stay around
+# after this command returns until the shutdown of the export has
+# completed.
#
# @id: Block export id.
#
@@ -470,8 +455,7 @@
##
# @BLOCK_EXPORT_DELETED:
-#
-# Emitted when a block export is removed and its id can be reused.
+# Emitted when a block export is removed and its id can be reused.
#
# @id: Block export id.
#
@@ -482,8 +466,7 @@
##
# @BlockExportInfo:
-#
-# Information about a single block export.
+# Information about a single block export.
#
# @id: The unique identifier for the block export
#
--
2.55.0
next prev parent reply other threads:[~2026-07-23 4:53 UTC|newest]
Thread overview: 47+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-23 4:47 [PATCH v2 00/44] qapi: convert trivial intro sections John Snow
2026-07-23 4:47 ` [PATCH v2 01/44] qapi: convert intro sections for error.json John Snow
2026-07-23 4:47 ` [PATCH v2 02/44] qapi: convert intro sections for acpi-hest.json John Snow
2026-07-23 7:29 ` Mauro Carvalho Chehab
2026-07-23 4:47 ` [PATCH v2 03/44] qapi: convert intro sections for ebpf.json John Snow
2026-07-23 4:47 ` [PATCH v2 04/44] qapi: convert intro sections for uefi.json John Snow
2026-07-23 4:47 ` [PATCH v2 05/44] qapi: convert trivial intro sections for compat.json John Snow
2026-07-23 4:47 ` [PATCH v2 06/44] qapi: convert intro sections for vfio.json John Snow
2026-07-23 4:47 ` [PATCH v2 07/44] qapi: convert intro sections for trace.json John Snow
2026-07-23 4:47 ` [PATCH v2 08/44] qapi: convert trivial intro sections for misc-arm.json John Snow
2026-07-23 4:47 ` [PATCH v2 09/44] qapi: convert intro sections for cryptodev.json John Snow
2026-07-23 9:11 ` zhenwei pi
2026-07-23 4:47 ` [PATCH v2 10/44] qapi: convert intro sections for machine-common.json John Snow
2026-07-23 4:47 ` [PATCH v2 11/44] qapi: convert intro sections for accelerator.json John Snow
2026-07-23 4:47 ` [PATCH v2 12/44] qapi: convert intro sections for authz.json John Snow
2026-07-23 4:47 ` [PATCH v2 13/44] qapi: convert trivial intro sections for yank.json John Snow
2026-07-23 4:47 ` [PATCH v2 14/44] qapi: convert intro sections for replay.json John Snow
2026-07-23 4:47 ` [PATCH v2 15/44] qapi: convert trivial intro sections for machine-s390x.json John Snow
2026-07-23 4:47 ` [PATCH v2 16/44] qapi: convert trivial intro sections for acpi.json John Snow
2026-07-23 4:47 ` [PATCH v2 17/44] qapi: convert intro sections for tpm.json John Snow
2026-07-23 4:47 ` [PATCH v2 18/44] qapi: convert trivial intro sections for qdev.json John Snow
2026-07-23 4:47 ` [PATCH v2 19/44] qapi: convert trivial intro sections for control.json John Snow
2026-07-23 4:47 ` [PATCH v2 20/44] qapi: convert intro sections for dump.json John Snow
2026-07-23 4:47 ` [PATCH v2 21/44] qapi: convert intro sections for common.json John Snow
2026-07-23 4:47 ` [PATCH v2 22/44] qapi: convert intro sections for sockets.json John Snow
2026-07-23 4:47 ` [PATCH v2 23/44] qapi: convert trivial intro sections for transaction.json John Snow
2026-07-23 4:47 ` [PATCH v2 24/44] qapi: convert trivial intro sections for stats.json John Snow
2026-07-23 4:47 ` [PATCH v2 25/44] qapi: convert trivial intro sections for job.json John Snow
2026-07-23 4:47 ` [PATCH v2 26/44] qapi: convert intro sections for pci.json John Snow
2026-07-23 4:47 ` [PATCH v2 27/44] qapi: convert trivial intro sections for introspect.json John Snow
2026-07-23 4:47 ` [PATCH v2 28/44] qapi: convert intro sections for rocker.json John Snow
2026-07-23 4:47 ` [PATCH v2 29/44] qapi: convert trivial intro sections for misc-i386.json John Snow
2026-07-23 4:47 ` John Snow [this message]
2026-07-23 4:47 ` [PATCH v2 31/44] qapi: convert intro sections for audio.json John Snow
2026-07-23 4:47 ` [PATCH v2 32/44] qapi: convert trivial intro sections for block.json John Snow
2026-07-23 4:47 ` [PATCH v2 33/44] qapi: convert trivial intro sections for misc.json John Snow
2026-07-23 4:47 ` [PATCH v2 34/44] qapi: convert trivial intro sections for crypto.json John Snow
2026-07-23 4:47 ` [PATCH v2 35/44] qapi: convert intro sections for cxl.json John Snow
2026-07-23 4:47 ` [PATCH v2 36/44] qapi: convert trivial intro sections for run-state.json John Snow
2026-07-23 4:47 ` [PATCH v2 37/44] qapi: convert intro sections for char.json John Snow
2026-07-23 4:47 ` [PATCH v2 38/44] qapi: convert intro sections for virtio.json John Snow
2026-07-23 4:48 ` [PATCH v2 39/44] qapi: convert trivial intro sections for net.json John Snow
2026-07-23 4:48 ` [PATCH v2 40/44] qapi: convert trivial intro sections for qom.json John Snow
2026-07-23 4:48 ` [PATCH v2 41/44] qapi: convert trivial intro sections for ui.json John Snow
2026-07-23 4:48 ` [PATCH v2 42/44] qapi: convert trivial intro sections for migration.json John Snow
2026-07-23 4:48 ` [PATCH v2 43/44] qapi: convert trivial intro sections for machine.json John Snow
2026-07-23 4:48 ` [PATCH v2 44/44] qapi: convert trivial intro sections for block-core.json John Snow
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260723044805.527643-31-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=alex.bennee@linaro.org \
--cc=alex@shazbot.org \
--cc=anisinha@redhat.com \
--cc=arei.gonglei@huawei.com \
--cc=armbru@redhat.com \
--cc=berrange@redhat.com \
--cc=clg@redhat.com \
--cc=eblake@redhat.com \
--cc=farosas@suse.de \
--cc=hreitz@redhat.com \
--cc=imammedo@redhat.com \
--cc=jasowangio@gmail.com \
--cc=jic23@kernel.org \
--cc=jiri@resnulli.us \
--cc=kraxel@redhat.com \
--cc=kwolf@redhat.com \
--cc=laurent@vivier.eu \
--cc=linux-cxl@vger.kernel.org \
--cc=linux-edac@vger.kernel.org \
--cc=lukasstraub2@web.de \
--cc=marcandre.lureau@redhat.com \
--cc=mchehab+huawei@kernel.org \
--cc=mjt@tls.msk.ru \
--cc=mst@redhat.com \
--cc=pbonzini@redhat.com \
--cc=peterx@redhat.com \
--cc=philmd@mailo.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=qemu-trivial@nongnu.org \
--cc=richard.henderson@linaro.org \
--cc=stefanb@linux.vnet.ibm.com \
--cc=stefanha@redhat.com \
--cc=vsementsov@yandex-team.ru \
--cc=zhao1.liu@intel.com \
--cc=zhenwei.pi@linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox