From nobody Tue Dec 16 07:06:23 2025 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; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (208.118.235.17 [208.118.235.17]) by mx.zohomail.com with SMTPS id 1520981742769724.582143873132; Tue, 13 Mar 2018 15:55:42 -0700 (PDT) Received: from localhost ([::1]:43311 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evspS-0003P9-UW for importer@patchew.org; Tue, 13 Mar 2018 18:55:34 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:57789) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1evshe-0005M5-9U for qemu-devel@nongnu.org; Tue, 13 Mar 2018 18:47:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1evshd-0002kL-4p for qemu-devel@nongnu.org; Tue, 13 Mar 2018 18:47:30 -0400 Received: from mail-wr0-x232.google.com ([2a00:1450:400c:c0c::232]:42068) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1evshc-0002jE-UA for qemu-devel@nongnu.org; Tue, 13 Mar 2018 18:47:29 -0400 Received: by mail-wr0-x232.google.com with SMTP id s18so2505294wrg.9 for ; Tue, 13 Mar 2018 15:47:28 -0700 (PDT) Received: from donizetti.lan (94-36-191-219.adsl-ull.clienti.tiscali.it. [94.36.191.219]) by smtp.gmail.com with ESMTPSA id x107sm1557951wrb.97.2018.03.13.15.47.26 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 13 Mar 2018 15:47:26 -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=5htEyYqNHN1AEPzoCfrK2HEQwz6w2gP2makGzdzNhUA=; b=ej/EttEIo+NP0XNHpkufpEVfuWBkZIcWKIKZ8FF/SBe3APQifcosn4EsUNEzR3cL7z ACWa9THZDb7+YRqiKvBMsXebNZhI4w/lkyXQ9L+dl9AffL54Rgx/RfMvtR48qpCf/YZH bsuoqrH/XAfjQtYDfqDU0UnnK1UHXbyRFQuU8KFGw3EZEU6cCG0vRAlqcW4e/NZFs9re K+pFDHFYGMfSziDFdwnpcDed1fyPwXBUZh5sOwLLQMKPMZqEnyb79duzGTEctwUtr0F7 FmGvMqwgr8nqg9bOpD18XOB0t8W/O65ytODhinwbeqUoAqbKwp/vlFZJcnb9EwnA7vN3 8BNQ== 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=5htEyYqNHN1AEPzoCfrK2HEQwz6w2gP2makGzdzNhUA=; b=BZvvb/8aimSw/4DUCF2j11oa+fB9V5+vvFu+ySl3iaAJ/HAvqLlFsIMXSFiNuqDRn6 Os4XEGhf7fDXSATtdVLX1KHhljXqZI6Xf/qTM7pdzp4qRkSEbymcMx1WZLOJe7D2hL/R aNoY5b73MFFQVqcfsy0oxdpUYh/TQiN5aup3v+1AyjUoV7cx+JFbRuifllU3Q+krGZ6t tXO6Vl6RfgZv6QtIDNoKCsCtX/2DGAIiZEuYZ3Ef/mkXrJCqmi3XxfVOsFMFC/eTHp2F QqzcWvqVGLnJKUIR+0YP/AMcVYyEPxk9Av+Oon9A0gpmRBn3bbJc5YXvAFSZJjvDDBmC 8cjA== X-Gm-Message-State: AElRT7H4cyJ65amA/qk0KzYDEsRVX6+l3JvVWPjbEd4PlrBDpQQPqkBS EGBTDs4EKWvnKdU8ot2mu5qIEVEt X-Google-Smtp-Source: AG47ELsnxE9V7qlejiw8l+KpjxGD6+MrfKVqSE5CbDHEQfcrM2Y0M1rUs85amh3WFoqvxsLunpnEsA== X-Received: by 10.223.129.203 with SMTP id 69mr1989409wra.45.1520981247424; Tue, 13 Mar 2018 15:47:27 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Date: Tue, 13 Mar 2018 23:46:15 +0100 Message-Id: <20180313224719.4954-6-pbonzini@redhat.com> X-Mailer: git-send-email 2.14.3 In-Reply-To: <20180313224719.4954-1-pbonzini@redhat.com> References: <20180313224719.4954-1-pbonzini@redhat.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:400c:c0c::232 Subject: [Qemu-devel] [PULL 05/69] 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: Jason Wang 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" 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: Jason Wang Acked-by: Thomas Huth Signed-off-by: Paolo Bonzini --- 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