From patchwork Mon Aug 3 15:33:09 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 75148 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 B1993A052A; Mon, 3 Aug 2020 17:33:18 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 9BBEF2C12; Mon, 3 Aug 2020 17:33:18 +0200 (CEST) Received: from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id 502312BE1 for ; Mon, 3 Aug 2020 17:33:17 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id 8FE8658027D; Mon, 3 Aug 2020 11:33:16 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Mon, 03 Aug 2020 11:33:16 -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=yygPFo4bEMMYSPdP6q2xZfcPpv Eu9aBZXKRma675C3k=; b=nS7Be+IbrVGjqa4XlNoUzJluB6fmY/6ejjUf6qba5x 1sVszNPA8WHTN/nm8ITer5vPLpEheLUMLLYIx2NI+04U5xrmsxLLxPOSOafutesk wroFIqmzHXlA+UmfGL9196zYu48VFVngtRacnKohDfpODPmvh53RZCgvMvbHNGRx P7Qa8/G/C25WL1+7KGCBHDfFT3EtlyWzOrC8fApN1wJ0oWk3smAqy2GLAbWBFS5v 3WQUpH8p5KkgNhAnXojASIESeZActyPjtoVu2S5Us1WrxAnfVcvGOpIWut7OfZax vl9RmufECx2gogWbG40HdW48MD0aydrHRpNPDM6SV+Cg== 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=yygPFo4bEMMYSPdP6 q2xZfcPpvEu9aBZXKRma675C3k=; b=Vva7m9Nw5BQYDbXveFAbb9HTtZzfDT2zJ PhudoaVcySXf9C6b/RyN2HKZ/+nfxyABRKSW7L0dvwOW7QtZeW0Fzb4RB2ZZt59p jSgDIYPqZoRR/sXewuItzbeK9s9nHC2APgJwALeDNVy66TnxA7kTJagvHUqukjpf 3W8EKALqVgqi+hPG5dm5fDAjez+UzmoRNRIUA69rG0k+OgZCDA9Hh8XsvyNhFEs4 JphLxO7Z4iMJD3YgckiUuiEas+0smk4PlGYYhV8OrvKIoXQ6kHUPQ0g0bh6Bu3Cy bjeeQT7ULxPteeqvgGuggGIQ7xmmwjwIPDW2sjlRbwqYbkphd/GMg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrjeeggdeklecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkffoggfgsedtkeertdertd dtnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghssehmohhn jhgrlhhonhdrnhgvtheqnecuggftrfgrthhtvghrnhepvdelvdduhedvudduveeuvdevhe egudelgeeigfejheduhedttdegudffjeeihffgnecukfhppeejjedrudefgedrvddtfedr udekgeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpe hthhhomhgrshesmhhonhhjrghlohhnrdhnvght 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 A9356328005E; Mon, 3 Aug 2020 11:33:14 -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, wei.zhao1@intel.com, jiaweiw@mellanox.com, orika@mellanox.com, viacheslavo@mellanox.com, matan@mellanox.com Date: Mon, 3 Aug 2020 17:33:09 +0200 Message-Id: <20200803153309.3274969-1-thomas@monjalon.net> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: announce deprecation of port mirroring API 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" A new API is planned to be introduced for sampling and mirroring with rte_flow. It should be more generic and allow more use cases. This deprecation is to show the direction, avoiding overlapping APIs. Signed-off-by: Thomas Monjalon Acked-by: Jerin Jacob Acked-by: Andrew Rybchenko Acked-by: Ajit Khaparde Acked-by: David Marchand --- 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 6e12e57a13..ca0d8af96a 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -103,6 +103,12 @@ Deprecation Notices Existing ``rte_eth_rx_descriptor_status`` and ``rte_eth_tx_descriptor_status`` APIs can be used as replacement. +* ethdev: The port mirroring API can be replaced with a more fine grain flow API. + The structs ``rte_eth_mirror_conf``, ``rte_eth_vlan_mirror`` and the functions + ``rte_eth_mirror_rule_set``, ``rte_eth_mirror_rule_reset`` will be marked + as deprecated in DPDK 20.11, along with the associated macros ``ETH_MIRROR_*``. + This API will be fully removed in DPDK 21.11. + * ethdev: Some internal APIs for driver usage are exported in the .map file. Now DPDK has ``__rte_internal`` marker so we can mark internal APIs and move them to the INTERNAL block in .map. Although these APIs are internal it will