From nobody Mon Feb 9 08:29:18 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 1628262721142679.9606220725037; Fri, 6 Aug 2021 08:12:01 -0700 (PDT) Received: from localhost ([::1]:35208 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mC1Vv-0002BW-DU for importer@patchew.org; Fri, 06 Aug 2021 11:11:59 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:43024) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mC1UT-00087W-GG for qemu-devel@nongnu.org; Fri, 06 Aug 2021 11:10:29 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:23304) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mC1UQ-0008Hm-83 for qemu-devel@nongnu.org; Fri, 06 Aug 2021 11:10:29 -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-453-kXvtvysYNbiQ4tg-zW7QzQ-1; Fri, 06 Aug 2021 11:10:24 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 7B46187D543; Fri, 6 Aug 2021 15:10:23 +0000 (UTC) Received: from thuth.com (unknown [10.39.192.26]) by smtp.corp.redhat.com (Postfix) with ESMTP id 3A5CF18AD4; Fri, 6 Aug 2021 15:10:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628262625; 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=QSJpCCVCACvs8DuaXuAokghDC4zrPbG/gHLGWiqPBPo=; b=NJgtAAzu1kcu2bVZKdIstCbNuHg6wT0l1VpDQSwl0lJPkPzWq5xUxUcG891ePQkSwnz1yg MBrakdlQQVeQcEdfKogR2jnK1GSOduoJRAEvygsTNYZLqQRNUchcjJ5QhtuDeeLWi9VNec OT5CB3Wlt9yNvHKam5VXpOtf0fpvdwc= X-MC-Unique: kXvtvysYNbiQ4tg-zW7QzQ-1 From: Thomas Huth To: qemu-devel@nongnu.org Subject: [PATCH 1/6] docs/about/removed-features: Document removed CLI options from QEMU v2.12 Date: Fri, 6 Aug 2021 17:10:07 +0200 Message-Id: <20210806151012.103108-2-thuth@redhat.com> In-Reply-To: <20210806151012.103108-1-thuth@redhat.com> References: <20210806151012.103108-1-thuth@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.7, 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: 1628262723382100001 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 | 37 +++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.= rst index 07d597847c..2b5cebfe08 100644 --- a/docs/about/removed-features.rst +++ b/docs/about/removed-features.rst @@ -9,8 +9,41 @@ 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) +''''''''''''''''''''''''''''''''' + +There is no replacement, since this was just a dummy option that has been +ignored. + +``-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=3Ddiscard``. + +``-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