From nobody Thu Nov 13 23:22:55 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) client-ip=205.139.110.61; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1583253344; cv=none; d=zohomail.com; s=zohoarc; b=iuQ8205TzjeqKqQRWrxtNklJLYU2q4CjYN3rsUpYYq0hnOMnQknn6qTOjHmFx0x+MgY3eu1vJ9Sx6GtzQ6XMty+ciOaKQ4SOiEVa8aK4TZmvwqCZ50EHtTkKYSWKNelw1QAKlfUI9Sv13VI9Ce8jNxKpcBRRQzt1v0cb4h6HNyY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1583253344; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=iQ4eJHnp2DxKvrJF29stLYX3uThsxgfJxa46sj2Ia6g=; b=GbD4GXpU01bMx77wKc1PvX2WAHmtiyMVzBs6qTLwPUzlO2wSXFY6hM85QJJbh94kP1S4Qevhr24SvjvRekvTSvicZoBPDhJXvrjSp4asrtEgQ8Lx813fwif7iScnJtPIop+wvjlmEDRWQ+u+f1YSKR7nE0fTycIl+usDQ2MZojI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) by mx.zohomail.com with SMTPS id 1583253344608936.4464090456851; Tue, 3 Mar 2020 08:35:44 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-120-QGgv40bmPd-nAErcZd738g-1; Tue, 03 Mar 2020 11:35:41 -0500 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4FF82801FC5; Tue, 3 Mar 2020 16:35:35 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 2206C39B; Tue, 3 Mar 2020 16:35:35 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id BC64418089D5; Tue, 3 Mar 2020 16:35:34 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 023GZAbh001153 for ; Tue, 3 Mar 2020 11:35:10 -0500 Received: by smtp.corp.redhat.com (Postfix) id 54C7010027AB; Tue, 3 Mar 2020 16:35:10 +0000 (UTC) Received: from blackfin.pond.sub.org (ovpn-116-129.ams2.redhat.com [10.36.116.129]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 3C3B710013A1; Tue, 3 Mar 2020 16:35:07 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id B293C11385ED; Tue, 3 Mar 2020 17:35:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1583253343; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=iQ4eJHnp2DxKvrJF29stLYX3uThsxgfJxa46sj2Ia6g=; b=URwD5mFO/u7TICNn9tzdTHYpLL+ZZSDpa+FKemaHUpoCBgQzm9hHg/VPpUS0rnX6JaI5n+ irztNvD2t/IemmXHQFLAKsFEaahGzg1Urvi74rBqRDnc5QsLS8dz1DZIdfqz0WpFBwN3WF khkOv8yRc0z79a9HsXS6Dw03aQcgwr8= X-MC-Unique: QGgv40bmPd-nAErcZd738g-1 From: Markus Armbruster To: qemu-devel@nongnu.org Subject: [PATCH v2 01/30] qemu-doc: Belatedly document QMP command arg & result deprecation Date: Tue, 3 Mar 2020 17:34:36 +0100 Message-Id: <20200303163505.32041-2-armbru@redhat.com> In-Reply-To: <20200303163505.32041-1-armbru@redhat.com> References: <20200303163505.32041-1-armbru@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-loop: libvir-list@redhat.com Cc: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" A number of deprecated QMP arguments and results were missed in commit eb22aeca65 "docs: document deprecation policy & deprecated features in appendix" (v2.10.0): * Commit b33945cfff "block: Accept device model name for blockdev-open/close-tray" (v2.8.0) deprecated blockdev-open-tray, blockdev-close-tray argument @device. * Commit fbe2d8163e "block: Accept device model name for eject" (v2.8.0) deprecated eject argument @device. * Commit 70e2cb3bd7 "block: Accept device model name for blockdev-change-medium" (v2.8.0) deprecated blockdev-change-medium argument @device. * Commit 7a9877a026 "block: Accept device model name for block_set_io_throttle" (v2.8.0) deprecated block_set_io_throttle argument @device. * Commit c01c214b69 "block: remove all encryption handling APIs" (v2.10.0) deprecated query-named-block-nodes result @encryption_key_missing and query-block result @inserted member @encryption_key_missing. * Commit c42e8742f5 "block: Use JSON null instead of "" to disable backing file" (v2.10.0) deprecated blockdev-add empty string argument @backing. Since then, we missed a few more: * Commit 3c605f4074 "commit: Add top-node/base-node options" (v3.1.0) deprecated block-commit arguments @base and @top. * Commit 4db6ceb0b5 "block/dirty-bitmap: add recording and busy properties" (v4.0.0) deprecated query-named-block-nodes result @dirty-bitmaps member @status, not just query-block. Make up for all that. Signed-off-by: Markus Armbruster --- qemu-deprecated.texi | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/qemu-deprecated.texi b/qemu-deprecated.texi index 66eca3a1de..b9ef56fd97 100644 --- a/qemu-deprecated.texi +++ b/qemu-deprecated.texi @@ -150,19 +150,51 @@ Use @option{-display sdl,show-cursor=3Don} or =20 Use ``blockdev-change-medium'' or ``change-vnc-password'' instead. =20 +@subsection blockdev-open-tray, blockdev-close-tray argument device (since= 2.8.0) + +Use argument ``id'' instead. + +@subsection eject argument device (since 2.8.0) + +Use argument ``id'' instead. + +@subsection blockdev-change-medium argument device (since 2.8.0) + +Use argument ``id'' instead. + +@subsection block_set_io_throttle argument device (since 2.8.0) + +Use argument ``id'' instead. + @subsection migrate_set_downtime and migrate_set_speed (since 2.8.0) =20 Use ``migrate-set-parameters'' instead. =20 +@subsection query-named-block-nodes result encryption_key_missing (since 2= .10.0) + +Always false. + +@subsection query-block result inserted.encryption_key_missing (since 2.10= .0) + +Always false. + +@subsection blockdev-add empty string argument backing (since 2.10.0) + +Use argument ``null'' instead. + @subsection migrate-set-cache-size and query-migrate-cache-size (since 2.1= 1.0) =20 Use ``migrate-set-parameters'' and ``query-migrate-parameters'' instead. =20 -@subsection query-block result field dirty-bitmaps[i].status (since 4.0) +@subsection block-commit arguments base and top (since 3.1.0) + +Use arguments ``base-node'' and ``top-node'' instead. + +@subsection query-named-block-nodes and query-block result dirty-bitmaps[i= ].status (since 4.0) =20 The ``status'' field of the ``BlockDirtyInfo'' structure, returned by -the query-block command is deprecated. Two new boolean fields, -``recording'' and ``busy'' effectively replace it. +these commands is deprecated. Two new boolean fields, ``recording'' and +``busy'' effectively replace it. =20 @subsection query-block result field dirty-bitmaps (Since 4.2) =20 --=20 2.21.1