From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628671343707232.60751172205266; Wed, 11 Aug 2021 01:42:23 -0700 (PDT) Received: from localhost ([::1]:36036 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjoc-0007QZ-KE for importer@patchew.org; Wed, 11 Aug 2021 04:42:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37218) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnU-0004lm-Lc for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:12 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:59422) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnT-0007cV-2T for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:12 -0400 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-191-kN4VIsBkOpylhIA4AWwc2Q-1; Wed, 11 Aug 2021 04:41:09 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 43B20760C0; Wed, 11 Aug 2021 08:41:08 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id 088381B5C0; Wed, 11 Aug 2021 08:41:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671270; h=from:from: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; bh=bkJuGuEEXYqH2gGhPDMUKGJlcidQ9cI8jMRXKc9FdPg=; b=TyUBxXSgrHRW96TaP912Vv6qOgusyDvB9mtzx6sNJ64zXTY0MJ2CuMZIIndERRgq/yTMAr EkIdqW8MH4vWk6O1Lnw6l8v+LwiE4WqUXPL10i5n7SDXSspDlxafc8f9sYWg9CNCo1r7vk Vl/sTn3Nj0p7IhL6KAcHUH7VEF2r0sI= X-MC-Unique: kN4VIsBkOpylhIA4AWwc2Q-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 1/6] docs/about/removed-features: Document removed CLI options from QEMU v2.12 Date: Wed, 11 Aug 2021 10:40:58 +0200 Message-Id: <20210811084103.74832-2-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671344525100001 Content-Type: text/plain; charset="utf-8" These CLI options had been removed/replaced in QEMU v2.12. Still, some people might want to update from older versions to the recent QEMU version, so we should give some recommendations for the replacements in our documentation. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 39 +++++++++++++++++++++++++++++++-- 1 file changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index 07d597847c..c18af3c76f 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -9,8 +9,43 @@ trouble after a recent upgrade. System emulator command line arguments -------------------------------------- =20 -``-net ...,name=3D``\ *name* (removed in 5.1) -''''''''''''''''''''''''''''''''''''''''''' +``-hdachs`` (removed in 2.12) +''''''''''''''''''''''''''''' + +The geometry defined by ``-hdachs c,h,s,t`` should now be specified via +``-device ide-hd,drive=3Ddr,cyls=3Dc,heads=3Dh,secs=3Ds,bios-chs-trans=3Dt= `` +(together with ``-drive if=3Dnone,id=3Ddr,...``). + +``-net channel`` (removed in 2.12) +'''''''''''''''''''''''''''''''''' + +This option has been replaced by ``-net user,guestfwd=3D...``. + +``-net dump`` (removed in 2.12) +''''''''''''''''''''''''''''''' + +``-net dump[,vlan=3Dn][,file=3Dfilename][,len=3Dmaxlen]`` has been replace= d by +``-object filter-dump,id=3Did,netdev=3Ddev[,file=3Dfilename][,maxlen=3Dmax= len]``. +Note that the new syntax works with netdev IDs instead of the old "vlan" h= ubs. + +``-no-kvm-pit`` (removed in 2.12) +''''''''''''''''''''''''''''''''' + +This was just a dummy option that has been ignored, since the in-kernel PIT +cannot be disabled separately from the irqchip anymore. A similar effect +(which also disables the KVM IOAPIC) can be obtained with +``-M kernel_irqchip=3Dsplit``. + +``-tdf`` (removed in 2.12) +'''''''''''''''''''''''''' + +There is no replacement, the ``-tdf`` option has just been ignored since t= he +behaviour that could be changed by this option in qemu-kvm is now the defa= ult +when using the KVM PIT. It still can be requested explicitly using +``-global kvm-pit.lost_tick_policy=3Ddelay``. + +``-net ...,name=3D...`` (removed in 5.1) +'''''''''''''''''''''''''''''''''''''' =20 The ``name`` parameter of the ``-net`` option was a synonym for the ``id`` parameter, which should now be used instead. --=20 2.27.0 From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628671345227901.1712888867079; Wed, 11 Aug 2021 01:42:25 -0700 (PDT) Received: from localhost ([::1]:36228 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjoe-0007Yj-5J for importer@patchew.org; Wed, 11 Aug 2021 04:42:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37254) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjna-0004rV-KJ for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:20 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:56322) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnZ-0007j1-6G for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:18 -0400 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-585-hQ7zSfY8MkWHS6dblXuXzw-1; Wed, 11 Aug 2021 04:41:15 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 5136B760C6; Wed, 11 Aug 2021 08:41:14 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id 942D01B5C0; Wed, 11 Aug 2021 08:41:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671276; h=from:from: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; bh=pO3xDS+0bKTlpFZXa5xfkT92ntTTkFzXdsZJVZ6q+xE=; b=WGGhcyIoi2UTbvmLmkyWALzNMoRB4le+D8QidEot/YObzIwn1ibxA4OzCv9IPYUHfU3STz wI+A5y0xYePoTspO8+EJtV3yim+n+N1RJBmhvMYXhSmREsEhZziEUdf7RS4Ugr3PrrAWBD vmCcn5u1k1AyV0ZZbJzS/dqqD2m3zkg= X-MC-Unique: hQ7zSfY8MkWHS6dblXuXzw-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 2/6] docs/about/removed-features: Document removed CLI options from QEMU v3.0 Date: Wed, 11 Aug 2021 10:40:59 +0200 Message-Id: <20210811084103.74832-3-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671346610100001 Content-Type: text/plain; charset="utf-8" These CLI options had been removed/replaced in QEMU v3.0. Still, some people might want to update from older versions to the recent QEMU version, so we should give some recommendations for the replacements in our documentation. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index c18af3c76f..c4b702968e 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -44,6 +44,41 @@ behaviour that could be changed by this option in qemu-k= vm is now the default when using the KVM PIT. It still can be requested explicitly using ``-global kvm-pit.lost_tick_policy=3Ddelay``. =20 +``-drive secs=3Ds``, ``-drive heads=3Dh`` & ``-drive cyls=3Dc`` (removed i= n 3.0) +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +The drive geometry should now be specified via +``-device ...,drive=3Ddr,cyls=3Dc,heads=3Dh,secs=3Ds`` (together with +``-drive if=3Dnone,id=3Ddr,...``). + +``-drive serial=3D``, ``-drive trans=3D`` & ``-drive addr=3D`` (removed in= 3.0) +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +Use ``-device ...,drive=3Ddr,serial=3Dr,bios-chs-trans=3Dt,addr=3Da`` inst= ead +(together with ``-drive if=3Dnone,id=3Ddr,...``). + +``-net ...,vlan=3Dx`` (removed in 3.0) +'''''''''''''''''''''''''''''''''''' + +The term "vlan" was very confusing for most users in this context (it's ab= out +specifying a hub ID, not about IEEE 802.1Q or something similar), so this +has been removed. To connect one NIC frontend with a network backend, eith= er +use ``-nic ...`` (e.g. for on-board NICs) or use ``-netdev ...,id=3Dn`` to= gether +with ``-device ...,netdev=3Dn`` (for full control over pluggable NICs). To +connect multiple NICs or network backends via a hub device (which is what +vlan did), use ``-nic hubport,hubid=3Dx,...`` or +``-netdev hubport,id=3Dn,hubid=3Dx,...`` (with ``-device ...,netdev=3Dn``)= instead. + +``-no-kvm-irqchip`` (removed in 3.0) +'''''''''''''''''''''''''''''''''''' + +Use ``-machine kernel_irqchip=3Doff`` instead. + +``-no-kvm-pit-reinjection`` (removed in 3.0) +'''''''''''''''''''''''''''''''''''''''''''' + +Use ``-global kvm-pit.lost_tick_policy=3Ddiscard`` instead. + ``-net ...,name=3D...`` (removed in 5.1) '''''''''''''''''''''''''''''''''''''' =20 --=20 2.27.0 From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 162867134609746.9234735241547; Wed, 11 Aug 2021 01:42:26 -0700 (PDT) Received: from localhost ([::1]:36354 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjoe-0007dW-VO for importer@patchew.org; Wed, 11 Aug 2021 04:42:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37276) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjne-0004tK-HL for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:23 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]:51762) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnd-0007lA-22 for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:22 -0400 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-286-1B4VDxd4P9mCFFlIR0BZbA-1; Wed, 11 Aug 2021 04:41:16 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E2F5C1009619; Wed, 11 Aug 2021 08:41:15 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id A67D41B5C0; Wed, 11 Aug 2021 08:41:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671279; h=from:from: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; bh=jADfkjEAA3fsDum2milPA/hn7YsInUd01WCJ4HY1SLE=; b=XqTT1LYX/nnDQeh6ED1Y9AbCRvXhIHVMj4jvdXJBl57eZ/lvthuXzjbQLiPenf2NfsUAgi zoesQiRy9Ol9PM75xLuLhrHudShbC9Fk4fDoyaJpsgzz59NCbqpBDygCpLO3uQDnRYeMnF D8OEBYSP6O9DnmrUFgwOs0CSIbGLDwo= X-MC-Unique: 1B4VDxd4P9mCFFlIR0BZbA-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 3/6] docs/about/removed-features: Document removed CLI options from QEMU v3.1 Date: Wed, 11 Aug 2021 10:41:00 +0200 Message-Id: <20210811084103.74832-4-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671346666100003 Content-Type: text/plain; charset="utf-8" These CLI options had been removed/replaced in QEMU v3.1. Still, some people might want to update from older versions to the recent QEMU version, so we should give some recommendations for the replacements in our documentation. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 67 +++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index c4b702968e..40d2cc4ffa 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -79,6 +79,73 @@ Use ``-machine kernel_irqchip=3Doff`` instead. =20 Use ``-global kvm-pit.lost_tick_policy=3Ddiscard`` instead. =20 +``-balloon`` (removed in 3.1) +''''''''''''''''''''''''''''' + +The ``-balloon virtio`` option has been replaced by ``-device virtio-ballo= on``. +The ``-balloon none`` option was a no-op and has no replacement. + +``-bootp`` (removed in 3.1) +''''''''''''''''''''''''''' + +The ``-bootp /some/file`` argument is replaced by either +``-netdev user,id=3Dx,bootp=3D/some/file`` (for pluggable NICs, accompanie= d with +``-device ...,netdev=3Dx``), or ``-nic user,bootp=3D/some/file`` (for on-b= oard NICs). +The new syntax allows different settings to be provided per NIC. + +``-redir`` (removed in 3.1) +''''''''''''''''''''''''''' + +The ``-redir [tcp|udp]:hostport:[guestaddr]:guestport`` option is replaced +by either ``-netdev +user,id=3Dx,hostfwd=3D[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport`` +(for pluggable NICs, accompanied with ``-device ...,netdev=3Dx``) or by th= e option +``-nic user,hostfwd=3D[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport`` +(for on-board NICs). The new syntax allows different settings to be provid= ed +per NIC. + +``-smb`` (removed in 3.1) +''''''''''''''''''''''''' + +The ``-smb /some/dir`` argument is replaced by either +``-netdev user,id=3Dx,smb=3D/some/dir`` (for pluggable NICs, accompanied w= ith +``-device ...,netdev=3Dx``), or ``-nic user,smb=3D/some/dir`` (for on-boar= d NICs). +The new syntax allows different settings to be provided per NIC. + +``-tftp`` (removed in 3.1) +'''''''''''''''''''''''''' + +The ``-tftp /some/dir`` argument is replaced by either +``-netdev user,id=3Dx,tftp=3D/some/dir`` (for pluggable NICs, accompanied = with +``-device ...,netdev=3Dx``), or ``-nic user,tftp=3D/some/dir`` (for embedd= ed NICs). +The new syntax allows different settings to be provided per NIC. + +``-localtime`` (removed in 3.1) +''''''''''''''''''''''''''''''' + +Replaced by ``-rtc base=3Dlocaltime``. + +``-nodefconfig`` (removed in 3.1) +''''''''''''''''''''''''''''''''' + +Use ``-no-user-config`` instead. + +``-rtc-td-hack`` (removed in 3.1) +''''''''''''''''''''''''''''''''' + +Use ``-rtc driftfix=3Dslew`` instead. + +``-startdate`` (removed in 3.1) +''''''''''''''''''''''''''''''' + +Replaced by ``-rtc base=3Ddate``. + +``-vnc ...,tls=3D...``, ``-vnc ...,x509=3D...`` & ``-vnc ...,x509verify=3D= ...`` +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +The "tls-creds" option should be used instead to point to a "tls-creds-x50= 9" +object created using "-object". + ``-net ...,name=3D...`` (removed in 5.1) '''''''''''''''''''''''''''''''''''''' =20 --=20 2.27.0 From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628671570522407.3510257072089; Wed, 11 Aug 2021 01:46:10 -0700 (PDT) Received: from localhost ([::1]:48868 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjsH-0007g0-7n for importer@patchew.org; Wed, 11 Aug 2021 04:46:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37384) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjoI-0007PV-Qz for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:42:02 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:56514) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjoG-00089C-1g for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:42:02 -0400 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-13-FRfMI--eMIWZ2VLEF_oVAA-1; Wed, 11 Aug 2021 04:41:18 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 71CE3760C1; Wed, 11 Aug 2021 08:41:17 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id 4E4011B5C0; Wed, 11 Aug 2021 08:41:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671319; h=from:from: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; bh=bRLRlwCoW/dtPClSvtzWqcb032Rf5AxPv989TdYF59U=; b=INFMhXYUmmY0tJh+FvGHu8qapa51MqMS8U7OYBDdCfjgSYY9JWBr4I6nQcG+5c7jFGRwaJ LVWJV8rYR7pGVeATVmSk9ovi2tX8pFKAQj6hJyMNquglke8o7C1UrHSN14WPaBkj7NhnYq oub/2Fj92AwvRD6DlqZRWVzZtOItvEk= X-MC-Unique: FRfMI--eMIWZ2VLEF_oVAA-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 4/6] docs/about/removed-features: Document removed HMP commands from QEMU v2.12 Date: Wed, 11 Aug 2021 10:41:01 +0200 Message-Id: <20210811084103.74832-5-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671571303100001 Content-Type: text/plain; charset="utf-8" These HMP commands had been removed/replaced in QEMU v2.12. Still, some people might want to update from older versions to the recent QEMU version, so we should give some recommendations for the replacements in our documentation. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index 40d2cc4ffa..8bf3ebecab 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -356,6 +356,17 @@ Specify the properties for the object as top-level arg= uments instead. Human Monitor Protocol (HMP) commands ------------------------------------- =20 +``usb_add`` and ``usb_remove`` (removed in 2.12) +'''''''''''''''''''''''''''''''''''''''''''''''' + +Replaced by ``device_add`` and ``device_del`` (use ``device_add help`` for= a +list of available devices). + +``host_net_add`` and ``host_net_remove`` (removed in 2.12) +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +Replaced by ``netdev_add`` and ``netdev_del``. + The ``hub_id`` parameter of ``hostfwd_add`` / ``hostfwd_remove`` (removed = in 5.0) ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''= ''''''' =20 --=20 2.27.0 From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628671447743567.7214295651347; Wed, 11 Aug 2021 01:44:07 -0700 (PDT) Received: from localhost ([::1]:42758 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjqI-0003Sg-OO for importer@patchew.org; Wed, 11 Aug 2021 04:44:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37278) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjne-0004tQ-NT for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:23 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:59670) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnd-0007lo-D3 for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:22 -0400 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-511-DaniughCMLWTU6U-lciUfw-1; Wed, 11 Aug 2021 04:41:19 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id CD5BC801AE7; Wed, 11 Aug 2021 08:41:18 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id D14831B5C0; Wed, 11 Aug 2021 08:41:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671280; h=from:from: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; bh=L3b8W9mX+LitMkKcv2tZkOffIICDBzKBgt3FMaLEEJE=; b=JjUc4Zn3S2vZgJxMCSvB7tFdD42uAvdzrZ+QIAcCi3K6wKA+td5TMVQCVgnc3MwHdV4UyP +28v0IKok2dh0hEsxcfMChy8pvz7JrDKcvRGqFltMLyDcG/EC6ICuaa89QrmtBCb2VsKxV 1TnBPdEOykxcycl7bESedV7m0IeWFPE= X-MC-Unique: DaniughCMLWTU6U-lciUfw-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 5/6] docs/about/removed-features: Document removed devices from older QEMU versions Date: Wed, 11 Aug 2021 10:41:02 +0200 Message-Id: <20210811084103.74832-6-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671449935100005 Content-Type: text/plain; charset="utf-8" These devices had been removed/replaced in QEMU v2.12 and v4.0. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index 8bf3ebecab..0c860be62d 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -513,6 +513,17 @@ running the old binaries, you can use older versions o= f QEMU. System emulator devices ----------------------- =20 +``spapr-pci-vfio-host-bridge`` (removed in 2.12) +''''''''''''''''''''''''''''''''''''''''''''''''' + +The ``spapr-pci-vfio-host-bridge`` device type has been replaced by the +``spapr-pci-host-bridge`` device type. + +``ivshmem`` (removed in 4.0) +'''''''''''''''''''''''''''' + +Replaced by either the ``ivshmem-plain`` or ``ivshmem-doorbell``. + ``ide-drive`` (removed in 6.0) '''''''''''''''''''''''''''''' =20 --=20 2.27.0 From nobody Sun May 19 20:29:53 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628671481243720.5965017792229; Wed, 11 Aug 2021 01:44:41 -0700 (PDT) Received: from localhost ([::1]:44680 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDjqq-0004mM-9T for importer@patchew.org; Wed, 11 Aug 2021 04:44:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37290) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnh-0004wl-SH for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:25 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:41463) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDjnf-0007mr-1M for qemu-devel@nongnu.org; Wed, 11 Aug 2021 04:41:24 -0400 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-145-Is2GZ4EuPAWmYypfMmWVAA-1; Wed, 11 Aug 2021 04:41:21 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 6BEC3760C8; Wed, 11 Aug 2021 08:41:20 +0000 (UTC) Received: from thuth.com (reserved-198-128.str.redhat.com [10.33.198.128]) by smtp.corp.redhat.com (Postfix) with ESMTP id 3A18F1B5C0; Wed, 11 Aug 2021 08:41:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628671282; h=from:from: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; bh=7D/171oJBqPQGXTp07oB06EzENowvLpm1eRT9JsHv2s=; b=ZEqyRIyzKU5TZrNrZhB3fFt8LCL5yKBSz3qoukATxtFVmd4U4OZ7TJnWxBvR8seF5zwNuv Z5doqVdnngZTNA338bpipTTAKDmwpU7NnRuCxhIhwweHq9k1GsCtlUT6Q1L0HQkP/DXqP8 bWgcWemJJnUU2Rdu9ZL9T7CQxYN1bzQ= X-MC-Unique: Is2GZ4EuPAWmYypfMmWVAA-1 From: Thomas Huth To: qemu-devel@nongnu.org, pbonzini@redhat.com Subject: [PATCH v2 6/6] docs/about/removed-features: Document removed machines from older QEMU versions Date: Wed, 11 Aug 2021 10:41:03 +0200 Message-Id: <20210811084103.74832-7-thuth@redhat.com> In-Reply-To: <20210811084103.74832-1-thuth@redhat.com> References: <20210811084103.74832-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=thuth@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.704, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , "Daniel P . Berrange" Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628671482356100003 Content-Type: text/plain; charset="utf-8" These machines had been removed in the QEMU v2.6 up to 4.0 time frame. Signed-off-by: Thomas Huth --- docs/about/removed-features.rst | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index 0c860be62d..cbfa1a8e31 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -473,6 +473,22 @@ Removed without replacement. System emulator machines ------------------------ =20 +``s390-virtio`` (removed in 2.6) +'''''''''''''''''''''''''''''''' + +Use the ``s390-ccw-virtio`` machine instead. + +The m68k ``dummy`` machine (removed in 2.9) +''''''''''''''''''''''''''''''''''''''''''' + +Use the ``none`` machine with the ``loader`` device instead. + +``xlnx-ep108`` (removed in 3.0) +''''''''''''''''''''''''''''''' + +The EP108 was an early access development board that is no longer used. +Use the ``xlnx-zcu102`` machine instead. + ``spike_v1.9.1`` and ``spike_v1.10`` (removed in 5.1) ''''''''''''''''''''''''''''''''''''''''''''''''''''' =20 @@ -491,8 +507,8 @@ mips ``fulong2e`` machine alias (removed in 6.0) =20 This machine has been renamed ``fuloong2e``. =20 -``pc-1.0``, ``pc-1.1``, ``pc-1.2`` and ``pc-1.3`` (removed in 6.0) -'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' +``pc-0.10`` up to ``pc-1.3`` (removed in 4.0 up to 6.0) +''''''''''''''''''''''''''''''''''''''''''''''''''''''' =20 These machine types were very old and likely could not be used for live migration from old QEMU versions anymore. Use a newer machine type instead. --=20 2.27.0