From nobody Mon Feb 9 10:33:17 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; 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; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1520433044289787.1302138704407; Wed, 7 Mar 2018 06:30:44 -0800 (PST) Received: from localhost ([::1]:33755 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eta5b-0006J7-EP for importer@patchew.org; Wed, 07 Mar 2018 09:30:43 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:49240) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eta46-0005U4-0L for qemu-devel@nongnu.org; Wed, 07 Mar 2018 09:29:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eta42-0007Vf-PD for qemu-devel@nongnu.org; Wed, 07 Mar 2018 09:29:10 -0500 Received: from mx3-rdu2.redhat.com ([66.187.233.73]:49708 helo=mx1.redhat.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eta42-0007VI-Gw for qemu-devel@nongnu.org; Wed, 07 Mar 2018 09:29:06 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id CAF7040252F0 for ; Wed, 7 Mar 2018 14:29:02 +0000 (UTC) Received: from donizetti.redhat.com (unknown [10.36.118.61]) by smtp.corp.redhat.com (Postfix) with ESMTP id 007B07C47; Wed, 7 Mar 2018 14:28:57 +0000 (UTC) From: Paolo Bonzini To: qemu-devel@nongnu.org Date: Wed, 7 Mar 2018 15:28:57 +0100 Message-Id: <20180307142857.28438-1-pbonzini@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.6]); Wed, 07 Mar 2018 14:29:02 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.6]); Wed, 07 Mar 2018 14:29:02 +0000 (UTC) for IP:'10.11.54.5' DOMAIN:'int-mx05.intmail.prod.int.rdu2.redhat.com' HELO:'smtp.corp.redhat.com' FROM:'pbonzini@redhat.com' RCPT:'' X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 66.187.233.73 Subject: [Qemu-devel] [PATCH] qemu-doc: update deprecation section to use -nic and -netdev hubport 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: Thomas Huth , Jason Wang 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 deprecated SLIRP options -tftp, -bootp, -redir, -smb provide sample replacements that use "-net nic". Suggest "-nic" instead, since we finally have a path towards getting rid of "-net". For "-net vlan" the replacement involves hubport network devices, so mention that too. Cc: Thomas Huth Cc: Jason Wang Signed-off-by: Paolo Bonzini Acked-by: Thomas Huth --- qemu-doc.texi | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/qemu-doc.texi b/qemu-doc.texi index 39e38c87ec..918d97c18b 100644 --- a/qemu-doc.texi +++ b/qemu-doc.texi @@ -2643,42 +2643,46 @@ combined with ``-vnc tls-creds=3Dtls0' =20 @subsection -tftp (since 2.6.0) =20 -The ``-tftp /some/dir'' argument is replaced by -``-netdev user,id=3Dx,tftp=3D/some/dir'', either accompanied with -``-device ...,netdev=3Dx'' (for pluggable NICs) or ``-net nic,netdev=3Dx'' +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 embedded NICs). The new syntax allows different settings to be provided per NIC. =20 @subsection -bootp (since 2.6.0) =20 -The ``-bootp /some/file'' argument is replaced by -``-netdev user,id=3Dx,bootp=3D/some/file'', either accompanied with -``-device ...,netdev=3Dx'' (for pluggable NICs) or ``-net nic,netdev=3Dx'' +The ``-bootp /some/file'' argument is replaced by either +``-netdev user,id=3Dx,bootp=3D/some/file '' (for pluggable NICs, accompani= ed +with ``-device ...,netdev=3Dx''), or ``-nic user,bootp=3D/some/file'' (for embedded NICs). The new syntax allows different settings to be provided per NIC. =20 @subsection -redir (since 2.6.0) =20 The ``-redir [tcp|udp]:hostport:[guestaddr]:guestport'' argument is -replaced by ``-netdev -user,id=3Dx,hostfwd=3D[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport'= ', -either accompanied with ``-device ...,netdev=3Dx'' (for pluggable NICs) or -``-net nic,netdev=3Dx'' (for embedded NICs). The new syntax allows differe= nt -settings to be provided per NIC. +replaced by either +``-netdev user,id=3Dx,hostfwd=3D[tcp|udp]:[hostaddr]:hostport-[guestaddr]:= guestport'' +(for pluggable NICs, accompanied with ``-device ...,netdev=3Dx'') or +``-nic user,hostfwd=3D[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport'' +(for embedded NICs). The new syntax allows different settings to be +provided per NIC. =20 @subsection -smb (since 2.6.0) =20 -The ``-smb /some/dir'' argument is replaced by -``-netdev user,id=3Dx,smb=3D/some/dir'', either accompanied with -``-device ...,netdev=3Dx'' (for pluggable NICs) or ``-net nic,netdev=3Dx'' +The ``-smb /some/dir'' argument is replaced by either +``-netdev user,id=3Dx,smb=3D/some/dir '' (for pluggable NICs, accompanied +with ``-device ...,netdev=3Dx''), or ``-nic user,smb=3D/some/dir'' (for embedded NICs). The new syntax allows different settings to be provided per NIC. =20 @subsection -net vlan (since 2.9.0) =20 -The ``-net vlan=3DNN'' argument is partially replaced with the -new ``-netdev'' argument. The remaining use cases will no -longer be directly supported in QEMU. +The ``-net vlan=3DNN'' argument was mostly used to attach separate +network backends to different virtual NICs. This is the default +behavior for ``-netdev'' and ``-nic''. You can connect multiple +``-netdev'' and ``-nic'' devices to the same network using the +"hubport" network backend, created with ``-netdev hubport,hubid=3DNN,...'' +and ``-nic hubport,hubid=3DNN''. =20 @subsection -drive cyls=3D...,heads=3D...,secs=3D...,trans=3D... (since 2.= 10.0) =20 --=20 2.14.3