From nobody Mon Feb 9 17:37:05 2026 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.zohomail.com; dkim=fail; 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 1501604527508574.826528316294; Tue, 1 Aug 2017 09:22:07 -0700 (PDT) Received: from localhost ([::1]:43603 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dcZvq-0007ul-4E for importer@patchew.org; Tue, 01 Aug 2017 12:22:06 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59583) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dcZrY-0004La-8a for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dcZrW-0007D0-PQ for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:40 -0400 Received: from mail-wm0-x22d.google.com ([2a00:1450:400c:c09::22d]:37947) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dcZrW-0007CR-FQ for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:38 -0400 Received: by mail-wm0-x22d.google.com with SMTP id m85so19435526wma.1 for ; Tue, 01 Aug 2017 09:17:38 -0700 (PDT) Received: from 640k.lan (94-39-192-75.adsl-ull.clienti.tiscali.it. [94.39.192.75]) by smtp.gmail.com with ESMTPSA id u187sm1724160wmd.26.2017.08.01.09.17.35 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 01 Aug 2017 09:17:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=LJZKQyPPgJQfR0t3TcR2ICXvyDzrutO5IlwY/WZIvrg=; b=dCz9OZZ2wcNpxa7GV27xCxUQwfNbVzyW98bKvsBCwjKvkRmqI8jQcB3bWIEEIyi6ae grT2Xx82785JfiOiKCFgTuZDtJwoD+TD8CPdacn9ESDh/CgwVovAtHuP4tlfWnIZZJ+z qI9nBHZYF068O9SdvnOWiOvZVg/jXqkMMk9CU+1NBMEIAn98oUTFNXWa18kawD2h+pWr aBa+vuHPFqpZvXix3NcYwAR7gFhj7M/j5ucWa7VLofzJIwkjd318Wmf1tMH5ar8nCNxs FS4uJhkDjszLWqp2nM+rA258v3LpCyQlsBB2C2K+aq1VDmpvYLGlZEVYtOzjZ7KmVyS1 m/Jg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=LJZKQyPPgJQfR0t3TcR2ICXvyDzrutO5IlwY/WZIvrg=; b=OfJFsUe5IXMUDYlk4kNxX/SJ2LoaWEwys7FIO+34u9ay9w0kN4RJau/4xXwQb0/pVZ a8PqnLz7WKhe+HNKwErpq4V5uXj4AJwCYF+898O5vYIWMeWSX03SRtEbJO+4EEHLL3jF IFnExNzKCsZwwyuKd1S6e8/KFmj8dK83EDP5PXXX/iqDXjerx0/HQJxW01yfl93lbsaW Jac8ek5bS3odBBxAWvRcS6qdHdbyXJ66f+7z/JZRZm88skkioCcsLfU0qVjje1C+FyGj PLDh7HKREb2cQXv7UHW3yyZtiZxLwmKEjiRGWKUQ6oHd48Pg3GdU8WXDjXXk8iZ2ziTq AvmQ== X-Gm-Message-State: AIVw110woYGMajrw5YPvHnH3CsQXpzIURwcah0oVh10RLYzMWMEPgqsk C7+TJW6bXvxsqfVB+AM= X-Received: by 10.28.186.198 with SMTP id k189mr1951119wmf.181.1501604256931; Tue, 01 Aug 2017 09:17:36 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Date: Tue, 1 Aug 2017 18:17:14 +0200 Message-Id: <1501604245-33460-7-git-send-email-pbonzini@redhat.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1501604245-33460-1-git-send-email-pbonzini@redhat.com> References: <1501604245-33460-1-git-send-email-pbonzini@redhat.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:400c:c09::22d Subject: [Qemu-devel] [PULL 06/17] docs: document deprecation policy & 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: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: "Daniel P. Berrange" 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 was made and provides text explaining what to use instead, if anything. Since there has been no formal policy around removal of deprecated features in the past, any deprecations prior to 2.10.0 are to be treated as if they had been made at the 2.10.0 release. Thus the earliest that existing deprecations will be deleted is the start of the 2.12.0 cycle. Signed-off-by: Daniel P. Berrange Message-Id: <20170725113638.7019-1-berrange@redhat.com> Reviewed-by: Thomas Huth Reviewed-by: Stefan Hajnoczi Signed-off-by: Paolo Bonzini --- qemu-doc.texi | 175 ++++++++++++++++++++++++++++++++++++++++++++++++++++++= ++++ 1 file changed, 175 insertions(+) diff --git a/qemu-doc.texi b/qemu-doc.texi index 48af515..aeb7bc5 100644 --- a/qemu-doc.texi +++ b/qemu-doc.texi @@ -38,6 +38,7 @@ * QEMU Guest Agent:: * QEMU User space emulator:: * Implementation notes:: +* Deprecated features:: * License:: * Index:: @end menu @@ -3128,6 +3129,180 @@ Run the emulation in single step mode. =20 @include qemu-tech.texi =20 +@node Deprecated features +@appendix Deprecated features + +In general features are intended to be supported indefinitely once +introduced into QEMU. In the event that a feature needs to be removed, +it will be listed in this appendix. The feature will remain functional +for 2 releases prior to actual removal. Deprecated features may also +generate warnings on the console when QEMU starts up, or if activated +via a monitor command, however, this is not a mandatory requirement. + +Prior to the 2.10.0 release there was no official policy on how +long features would be deprecated prior to their removal, nor +any documented list of which features were deprecated. Thus +any features deprecated prior to 2.10.0 will be treated as if +they were first deprecated in the 2.10.0 release. + +What follows is a list of all features currently marked as +deprecated. + +@section System emulator command line arguments + +@subsection -drive boot=3Don|off (since 1.3.0) + +The ``boot=3Don|off'' option to the ``-drive'' argument is +ignored. Applications should use the ``bootindex=3DN'' parameter +to set an absolute ordering between devices instead. + +@subsection -tdf (since 1.3.0) + +The ``-tdf'' argument is ignored. The behaviour implemented +by this argument is now the default when using the KVM PIT, +but can be requested explicitly using +``-global kvm-pit.lost_tick_policy=3Dslew''. + +@subsection -no-kvm-pit-reinjection (since 1.3.0) + +The ``-no-kvm-pit-reinjection'' argument is now a +synonym for setting ``-global kvm-pit.lost_tick_policy=3Ddiscard''. + +@subsection -no-kvm-irqchip (since 1.3.0) + +The ``-no-kvm-irqchip'' argument is now a synonym for +setting ``-machine kernel_irqchip=3Doff''. + +@subsection -no-kvm-pit (since 1.3.0) + +The ``-no-kvm-pit'' argument is ignored. It is no longer +possible to disable the KVM PIT directly. + +@subsection -no-kvm (since 1.3.0) + +The ``-no-kvm'' argument is now a synonym for setting +``-machine accel=3Dtcg''. + +@subsection -mon default=3Don (since 2.4.0) + +The ``default'' option to the ``-mon'' argument is +now ignored. When multiple monitors were enabled, it +indicated which monitor would receive log messages +from the various subsystems. This feature is no longer +required as messages are now only sent to the monitor +in response to explicitly monitor commands. + +@subsection -vnc tls (since 2.5.0) + +The ``-vnc tls'' argument is now a synonym for setting +``-object tls-creds-anon,id=3Dtls0'' combined with +``-vnc tls-creds=3Dtls0' + +@subsection -vnc x509 (since 2.5.0) + +The ``-vnc x509=3D/path/to/certs'' argument is now a +synonym for setting +``-object tls-creds-x509,dir=3D/path/to/certs,id=3Dtls0,verify-peer=3Dno'' +combined with ``-vnc tls-creds=3Dtls0' + +@subsection -vnc x509verify (since 2.5.0) + +The ``-vnc x509verify=3D/path/to/certs'' argument is now a +synonym for setting +``-object tls-creds-x509,dir=3D/path/to/certs,id=3Dtls0,verify-peer=3Dyes'' +combined with ``-vnc tls-creds=3Dtls0' + +@subsection -tftp (since 2.6.0) + +The ``-tftp /some/dir'' argument is now a synonym for setting +the ``-netdev user,tftp=3D/some/dir' argument. The new syntax +allows different settings to be provided per NIC. + +@subsection -bootp (since 2.6.0) + +The ``-bootp /some/file'' argument is now a synonym for setting +the ``-netdev user,bootp=3D/some/file' argument. The new syntax +allows different settings to be provided per NIC. + +@subsection -redir (since 2.6.0) + +The ``-redir ARGS'' argument is now a synonym for setting +the ``-netdev user,hostfwd=3DARGS'' argument instead. The new +syntax allows different settings to be provided per NIC. + +@subsection -smb (since 2.6.0) + +The ``-smb /some/dir'' argument is now a synonym for setting +the ``-netdev user,smb=3D/some/dir'' argument instead. The new +syntax allows different settings to be provided per NIC. + +@subsection -net channel (since 2.6.0) + +The ``--net channel,ARGS'' argument is now a synonym for setting +the ``-netdev user,guestfwd=3DARGS'' argument instead. + +@subsection -net vlan (since 2.9.0) + +The ``-net van=3DNN'' argument is partially replaced with the +new ``-netdev'' argument. The remaining use cases will no +longer be directly supported in QEMU. + +@subsection -drive if=3Dscsi (since 2.9.0) + +The ``-drive if=3Dscsi'' argument is replaced by the the +``-device BUS-TYPE'' argument combined with ``-drive if=3Dnone''. + +@subsection -net dump (since 2.10.0) + +The ``--net dump'' argument is now replaced with the +``-object filter-dump'' argument which works in combination +with the modern ``-netdev`` backends instead. + +@subsection -hdachs (since 2.10.0) + +The ``-hdachs'' argument is now a synonym for setting +the ``cyls'', ``heads'', ``secs'', and ``trans'' properties +on the ``ide-hd'' device using the ``-device'' argument. +The new syntax allows different settings to be provided +per disk. + +@subsection -usbdevice (since 2.10.0) + +The ``-usbdevice DEV'' argument is now a synonym for setting +the ``-device usb-DEV'' argument instead. The deprecated syntax +would automatically enable USB support on the machine type. +If using the new syntax, USB support must be explicitly +enabled via the ``-machine usb=3Don'' argument. + +@section qemu-img command line arguments + +@subsection convert -s (since 2.0.0) + +The ``convert -s snapshot_id_or_name'' argument is obsoleted +by the ``convert -l snapshot_param'' argument instead. + +@section System emulator human monitor commands + +@subsection usb_add (since 2.10.0) + +The ``usb_add'' command is replaced by the ``device_add'' command. + +@subsection usb_del (since 2.10.0) + +The ``usb_del'' command is replaced by the ``device_del'' command. + +@section System emulator devices + +@subsection ivshmem (since 2.6.0) + +The ``ivshmem'' device type is replaced by either the ``ivshmem-plain'' +or ``ivshmem-doorbell`` device types. + +@subsection spapr-pci-vfio-host-bridge (since 2.6.0) + +The ``spapr-pci-vfio-host-bridge'' device type is replaced by +the ``spapr-pci-host-bridge'' device type. + @node License @appendix License =20 --=20 1.8.3.1