From nobody Wed Nov 5 15:50:44 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zoho.com; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1496747375076252.11586056437773; Tue, 6 Jun 2017 04:09:35 -0700 (PDT) Received: from localhost ([::1]:37544 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dICMa-0000BA-IX for importer@patchew.org; Tue, 06 Jun 2017 07:09:28 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38572) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dICJO-0005hA-56 for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dICJL-0002wl-Fe for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:10 -0400 Received: from mx1.redhat.com ([209.132.183.28]:38174) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dICJL-0002wW-9q for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:07 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 634CBC0467CB; Tue, 6 Jun 2017 11:06:06 +0000 (UTC) Received: from localhost.localdomain.com (unknown [10.42.22.189]) by smtp.corp.redhat.com (Postfix) with ESMTP id 88A9117561; Tue, 6 Jun 2017 11:06:05 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 634CBC0467CB Authentication-Results: ext-mx07.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx07.extmail.prod.ext.phx2.redhat.com; spf=pass smtp.mailfrom=berrange@redhat.com DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com 634CBC0467CB From: "Daniel P. Berrange" To: qemu-devel@nongnu.org Date: Tue, 6 Jun 2017 12:05:55 +0100 Message-Id: <20170606110556.12922-2-berrange@redhat.com> In-Reply-To: <20170606110556.12922-1-berrange@redhat.com> References: <20170606110556.12922-1-berrange@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.31]); Tue, 06 Jun 2017 11:06:06 +0000 (UTC) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.132.183.28 Subject: [Qemu-devel] [PATCH v2 1/2] docs: document deprecated features in appendix X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Stefan Hajnoczi Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" The deprecation of features in QEMU is totally adhoc currently, with no way for the user to get a list of what is deprecated in each release. This adds an appendix to the doc that records when each deprecation[1] was made and provides text explaining what to use instead. Signed-off-by: Daniel P. Berrange [1] This is a lie. I've only listed one deprecated feature. Once we agree on the general concept, we can fill out the doc with the rest of the currently deprecated features. Reviewed-by: Stefan Hajnoczi --- qemu-doc.texi | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/qemu-doc.texi b/qemu-doc.texi index 965ba59..29f89d8 100644 --- a/qemu-doc.texi +++ b/qemu-doc.texi @@ -37,6 +37,7 @@ * QEMU Guest Agent:: * QEMU User space emulator:: * Implementation notes:: +* Deprecations:: * License:: * Index:: @end menu @@ -3016,6 +3017,19 @@ Run the emulation in single step mode. =20 @include qemu-tech.texi =20 +@node Deprecations +@appendix Deprecations + +The following is a list of features which have been marked as deprecated, +pending removal in a future release: + +@section -drive boot=3Don|off (since v1.3.0) +Since release 1.3.0, the ``boot=3Don|off'' parameter to ``-drive'' +is no longer honoured. It is currently ignored, but a future verson +will reject this parameter with an error. Applications should use +the ``bootindex=3DN'' parameter to set an absolute ordering between +devices instead. + @node License @appendix License =20 --=20 2.9.3 From nobody Wed Nov 5 15:50:44 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zoho.com; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 14967474754351004.9262098085537; Tue, 6 Jun 2017 04:11:15 -0700 (PDT) Received: from localhost ([::1]:37553 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dICOH-0001Y7-3F for importer@patchew.org; Tue, 06 Jun 2017 07:11:13 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38574) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dICJO-0005hN-CB for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:11 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dICJN-0002x4-4q for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:10 -0400 Received: from mx1.redhat.com ([209.132.183.28]:45662) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dICJM-0002wz-Uc for qemu-devel@nongnu.org; Tue, 06 Jun 2017 07:06:09 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id F27EE83F3A; Tue, 6 Jun 2017 11:06:07 +0000 (UTC) Received: from localhost.localdomain.com (unknown [10.42.22.189]) by smtp.corp.redhat.com (Postfix) with ESMTP id C5DEE174B4; Tue, 6 Jun 2017 11:06:06 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com F27EE83F3A Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com; spf=pass smtp.mailfrom=berrange@redhat.com DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com F27EE83F3A From: "Daniel P. Berrange" To: qemu-devel@nongnu.org Date: Tue, 6 Jun 2017 12:05:56 +0100 Message-Id: <20170606110556.12922-3-berrange@redhat.com> In-Reply-To: <20170606110556.12922-1-berrange@redhat.com> References: <20170606110556.12922-1-berrange@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.27]); Tue, 06 Jun 2017 11:06:08 +0000 (UTC) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.132.183.28 Subject: [Qemu-devel] [PATCH v2 2/2] docs: document support lifetime for features X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Stefan Hajnoczi Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" There is currently no explicit guidance on the duration of support for features such as versioned machine types, which have a finite useful lifespan. Thus apps / users cannot predict how much time they might be able to use a feature for, before it is removed (if ever). This adds a new appendix that lists items which have finite lifecycles, such as machine types. For items which are generally expected to be supported indefinitely, it sets out the policy around deprecation and removal, should it be needed. Signed-off-by: Daniel P. Berrange Reviewed-by: Stefan Hajnoczi --- qemu-doc.texi | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/qemu-doc.texi b/qemu-doc.texi index 29f89d8..e3c6400 100644 --- a/qemu-doc.texi +++ b/qemu-doc.texi @@ -37,6 +37,7 @@ * QEMU Guest Agent:: * QEMU User space emulator:: * Implementation notes:: +* Support lifetime:: * Deprecations:: * License:: * Index:: @@ -3017,6 +3018,39 @@ Run the emulation in single step mode. =20 @include qemu-tech.texi =20 +@node Support lifetime +@appendix Support lifetime + +Features provided by QEMU are subject to varying support lifetimes. + +In general features are intended to be supported indefinitely once +introduced. In the event that a feature needs to be removed, there +will be some period in which it will be marked as deprecated before +eventual removal. All deprecated features will be listed in the +``Deprecations'' appendix of this document. They may also generate +warnings on the console when QEMU starts up, or if activated via +a monitor command. + +Certain features will have an inherently finite lifetime, and thus +will be removed on a fixed schedule. + +@node Machine types +@section Machine types + +For architectures which aim to support live migration compatibility +across releases, each release will introduce a new versioned machine +type. For example, the 2.8.0 release introduced machine types +``pc-i440fx-2.8'' and ``pc-q35-2.8' 'for the x86_64/i686 architectures. + +To allow live migration of a guest running on a 2.8.0 release to a +2.9.0, the QEMU 2.9.0 version must support the ``pc-i440fx-2.8'' and +``pc-q35-2.8''. To allow users live migrating VMs to skip multiple +intermediate releases when upgrading, new releases of QEMU will +support machine types from many previous versions. + +The supported lifetime for machine types is 12 releases, which is +equivalent to 4 years worth of previous QEMU releases. + @node Deprecations @appendix Deprecations =20 --=20 2.9.3