From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4E11237F001 for ; Thu, 23 Jul 2026 04:53:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.129.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784782442; cv=none; b=rFZBttUpw7+fLSYCLgiEtbDB4riLFvcwjGTWR7DH+qclXKD0jM6hTqF6/BB2YMR7qs90P1UA2vxvamD/V+Hz1gQ4q9hAqy01BVMh5tkyC6VXqzLIvTFT66B3vHHlP7uGPkjlNhY2iwCmZZMvhqA8PmByQdme514Zwxn0wQhXJps= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784782442; c=relaxed/simple; bh=lhIIdV7zdqpQ8sjRLqguRT+Tax+kWZ9Qu/4l0dlfwm4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WwFaIpe7pJSvyDbUlUa8YbH2y2nzZrjRIpYKpQcK1KcGdphmUumHqYbUXVZhy2oPdYWL0kusgAXEbeOEjQ7lFUFnlKJmVoBfT2agQt+gCVqIYw3an1Q4XRwzEe6HzUpHQoxm7jkJGAbOIrhBcISKiRwFjVHRs/wztJKHJmavbLg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=KEI5ils+; arc=none smtp.client-ip=170.10.129.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="KEI5ils+" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1784782426; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=WvVNT9FP84PI//trYRCoAZS9q9GdrG1oeUvWQayikpo=; b=KEI5ils+fIwbQGbDdyOkvivqrTsViKJInodu1c0gMu9pYM7Yghzek4ev6Bzw2t06Mds0X9 e2F5d7jQ9jgSADo+vJD5saIpE2bRsRyufFYPapA2esCb5TkmQXsmTYtvDElhxfiwB4bSZg jGPNyY+8zRp7Tf3pFTYikGUB5pJJSD4= Received: from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-193-Z0nYtQrROaGc1WxEnAlu_g-1; Thu, 23 Jul 2026 00:53:40 -0400 X-MC-Unique: Z0nYtQrROaGc1WxEnAlu_g-1 X-Mimecast-MFC-AGG-ID: Z0nYtQrROaGc1WxEnAlu_g_1784782416 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 009F61977539; Thu, 23 Jul 2026 04:53:36 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.44]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5DE9318002B4; Thu, 23 Jul 2026 04:53:27 +0000 (UTC) From: John Snow To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Alex=20Benn=C3=A9e?= , Lukas Straub , Vladimir Sementsov-Ogievskiy , Zhao Liu , Laurent Vivier , Markus Armbruster , "Gonglei (Arei)" , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Alex Williamson , zhenwei pi , Hanna Reitz , Ani Sinha , qemu-block@nongnu.org, Paolo Bonzini , Peter Xu , Kevin Wolf , linux-cxl@vger.kernel.org, Jiri Pirko , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Stefan Berger , Fabiano Rosas , John Snow , Stefan Hajnoczi , Michael Tokarev , Igor Mammedov , "Michael S. Tsirkin" , Gerd Hoffmann , Mauro Carvalho Chehab , linux-edac@vger.kernel.org, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , Richard Henderson , Eric Blake , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= , Jason Wang , qemu-trivial@nongnu.org, Jonathan Cameron Subject: [PATCH v2 32/44] qapi: convert trivial intro sections for block.json Date: Thu, 23 Jul 2026 00:47:53 -0400 Message-ID: <20260723044805.527643-33-jsnow@redhat.com> In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com> References: <20260723044805.527643-1-jsnow@redhat.com> Precedence: bulk X-Mailing-List: linux-edac@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 (Trivial) Signed-off-by: John Snow --- qapi/block.json | 58 +++++++++++++++++++++---------------------------- 1 file changed, 25 insertions(+), 33 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 46955bbb3e3..e47592d5500 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -16,11 +16,10 @@ ## # @BiosAtaTranslation: -# -# Policy that BIOS should use to interpret cylinder/head/sector -# addresses. Note that Bochs BIOS and SeaBIOS will not actually -# translate logical CHS to physical; instead, they will use logical -# block addressing. +# Policy that BIOS should use to interpret cylinder/head/sector +# addresses. Note that Bochs BIOS and SeaBIOS will not actually +# translate logical CHS to physical; instead, they will use +# logical block addressing. # # @auto: If cylinder/heads/sizes are passed, choose between none and # LBA depending on the size of the disk. If they are not passed, @@ -50,8 +49,8 @@ ## # @FloppyDriveType: -# -# Type of floppy drive to be emulated by the Floppy Disk Controller. +# Type of floppy drive to be emulated by the +# Floppy Disk Controller. # # @144: 1.44MB 3.5" drive # @@ -70,8 +69,7 @@ ## # @PRManagerInfo: -# -# Information about a persistent reservation manager +# Information about a persistent reservation manager # # @id: the identifier of the persistent reservation manager # @@ -85,9 +83,8 @@ ## # @query-pr-managers: -# -# Return a list of information about each persistent reservation -# manager. +# Return a list of information about each persistent reservation +# manager. # # Returns: a list of manager info for each persistent reservation # manager @@ -99,8 +96,7 @@ ## # @eject: -# -# Ejects the medium from a removable drive. +# Ejects the medium from a removable drive. # # @device: Block device name # @@ -264,10 +260,10 @@ ## # @blockdev-insert-medium: -# -# Inserts a medium (a block driver state tree) into a block device. -# That block device's tray must currently be open (unless there is no -# attached guest device) and there must be no medium inserted already. +# Inserts a medium (a block driver state tree) into a block +# device. That block device's tray must currently be open (unless +# there is no attached guest device) and there must be no medium +# inserted already. # # @id: The name or QOM path of the guest device # @@ -297,9 +293,8 @@ ## # @BlockdevChangeReadOnlyMode: -# -# Specifies the new read-only mode of a block device subject to the -# `blockdev-change-medium` command. +# Specifies the new read-only mode of a block device subject to +# the `blockdev-change-medium` command. # # @retain: Retains the current read-only mode # @@ -314,12 +309,11 @@ ## # @blockdev-change-medium: -# -# Changes the medium inserted into a block device by ejecting the -# current medium and loading a new image file which is inserted as the -# new medium (this command combines `blockdev-open-tray`, -# `blockdev-remove-medium`, `blockdev-insert-medium` and -# `blockdev-close-tray`). +# Changes the medium inserted into a block device by ejecting the +# current medium and loading a new image file which is inserted as +# the new medium (this command combines `blockdev-open-tray`, +# `blockdev-remove-medium`, `blockdev-insert-medium` and +# `blockdev-close-tray`). # # @device: Block device name # @@ -385,9 +379,8 @@ ## # @DEVICE_TRAY_MOVED: -# -# Emitted whenever the tray of a removable device is moved by the -# guest or by HMP/QMP commands +# Emitted whenever the tray of a removable device is moved by the +# guest or by HMP/QMP commands # # @device: Block device name. This is always present for # compatibility reasons, but it can be empty ("") if the image @@ -414,9 +407,8 @@ ## # @PR_MANAGER_STATUS_CHANGED: -# -# Emitted whenever the connected status of a persistent reservation -# manager changes. +# Emitted whenever the connected status of a persistent +# reservation manager changes. # # @id: The id of the PR manager object # -- 2.55.0