From patchwork Tue Aug 4 09:20:14 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 75178 Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 9413DA053A; Tue, 4 Aug 2020 11:20:34 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id D7BD71BFFA; Tue, 4 Aug 2020 11:20:33 +0200 (CEST) Received: from new3-smtp.messagingengine.com (new3-smtp.messagingengine.com [66.111.4.229]) by dpdk.org (Postfix) with ESMTP id 169F8255 for ; Tue, 4 Aug 2020 11:20:32 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id AEF1F5803F4; Tue, 4 Aug 2020 05:20:29 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Tue, 04 Aug 2020 05:20:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=fm1; bh=IslyFSDeD8DmeaNKizCi19g4Mr JpFqRkpLBWOX4X9Xs=; b=KOPOCQpkENNhDIFSBxOjfx3pYNW477HAaNAPBQE6oL if2CIYqcjAW8BQlSb76uCTHEkeHYm/AydUfnq2O4zzANOFnT7YZi0KpGHCaU5MRt 20vnssNh7o2Wl0rrrGoKYIzW2hmCwJ+vLCjVBq6NKgjm3om2IN+JKV5zg6uIP8Ba mytqSNtDR0vrAemfCkE+x+eZt7fblL/6/OH/C0ChJLyuGxWS30rCS+ZB5YBCGuZH ykygoAZ4rI+a5km+8zq3KEvs8hKS9d50yBjhZ3N+fWznqaTNR9POm+NSNaspx8E4 hjC3n+ps+2IMDr7ki7/QM9PQ6SqIha5NhU13TroBSeVQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=IslyFSDeD8DmeaNKi zCi19g4MrJpFqRkpLBWOX4X9Xs=; b=bWTfVbODiD/cLpeKPTG59nTwaFv7DNqra R8y6u9fw72i+SlfyNeoGUVSsZdtoiZS3Pmb/9R2gIMNr1VIjZhuqAoBdGMoWBafp 2bU/6MClNR1SdIuhvNBVvpTllhr6C5tDza0jcYxFbfVKYUalsxIxBLRiiF6VuuMm CCdPM8QiyIImRDBcJNbK7l9RDheysBFkaV5Rld20Qndf4APQ3+o4GCOYcrZ5/dHZ pp0SkoYRhSFe+qDVmq9jYf+mChalx6B7NuYQdrkHsrtRNZL9kR6KcuhF3EhsBW0K JkwKl63grI1P8d4k4ECmudr3WzDdoTnp0KqUf+Rb/aNhwYg+c6qIw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrjeeigdduhecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkffoggfgsedtkeertdertd dtnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghssehmohhn jhgrlhhonhdrnhgvtheqnecuggftrfgrthhtvghrnhepueejhfelffefvddvjeelgeelie etiedtveejfedvueeiueehtdeihfehhfevgfetnecuffhomhgrihhnpeguphgukhdrohhr ghenucfkphepjeejrddufeegrddvtdefrddukeegnecuvehluhhsthgvrhfuihiivgeptd enucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgv th X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id E4C0C328005D; Tue, 4 Aug 2020 05:20:25 -0400 (EDT) From: Thomas Monjalon To: dev@dpdk.org Cc: david.marchand@redhat.com, jerinj@marvell.com, arybchenko@solarflare.com, ferruh.yigit@intel.com, stephen@networkplumber.org, ajit.khaparde@broadcom.com, matan@mellanox.com, linville@tuxdriver.com, qi.z.zhang@intel.com, shepard.siegel@atomicrules.com, igor.russkikh@aquantia.com, rmody@marvell.com, chas3@att.com, rahul.lakkireddy@chelsio.com, hemant.agrawal@nxp.com, g.singh@nxp.com, grive@u256.net, cristian.dumitrescu@intel.com, keith.wiles@intel.com, beilei.xing@intel.com, jingjing.wu@intel.com, cardigliano@ntop.org, rosen.xu@intel.com, sthotton@marvell.com, heinrich.kuhn@netronome.com Date: Tue, 4 Aug 2020 11:20:14 +0200 Message-Id: <20200804092014.3335076-1-thomas@monjalon.net> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: announce ethdev port freeing on close operation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Since DPDK 18.11, some drivers are migrating to a new behaviour, releasing port resources on close. The temporary flag RTE_ETH_DEV_CLOSE_REMOVE triggers this new mode in the migrated drivers. After 2 years, the flag and the old behaviour will be removed. Last drivers not migrated will have to complete the switch. Signed-off-by: Thomas Monjalon Acked-by: Jerin Jacob Acked-by: Hemant Agrawal Acked-by: Ajit Khaparde Acked-by: Andrew Rybchenko Acked-by: Jerin Jacob --- doc/guides/rel_notes/deprecation.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index ea4cfa7a48..b5e8045d00 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -91,6 +91,12 @@ Deprecation Notices - ``rte_eth_dev_stop`` - ``rte_eth_dev_close`` +* ethdev: The temporary flag RTE_ETH_DEV_CLOSE_REMOVE will be removed in 20.11. + As a consequence, the new behaviour introduced in 18.11 will be effective + for all drivers: generic port resources are freed on close operation. + Private resources are expected to be released in the ``dev_close`` callback. + More details in http://inbox.dpdk.org/dev/5248162.j6AOsuQRmx@thomas/ + * ethdev: New offload flags ``DEV_RX_OFFLOAD_FLOW_MARK`` will be added in 19.11. This will allow application to enable or disable PMDs from updating ``rte_mbuf::hash::fdir``.