From nobody Sun Feb 8 22:58:04 2026 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