From patchwork Wed Oct 5 11:32:21 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ivan Malov X-Patchwork-Id: 117383 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 5EF8BA0542; Wed, 5 Oct 2022 13:32:26 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id F33A940A7D; Wed, 5 Oct 2022 13:32:25 +0200 (CEST) Received: from shelob.oktetlabs.ru (shelob.oktetlabs.ru [91.220.146.113]) by mails.dpdk.org (Postfix) with ESMTP id 53A4040694 for ; Wed, 5 Oct 2022 13:32:24 +0200 (CEST) Received: from bree.oktetlabs.ru (bree.oktetlabs.ru [192.168.34.5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by shelob.oktetlabs.ru (Postfix) with ESMTPS id 8D5D85D; Wed, 5 Oct 2022 14:32:23 +0300 (MSK) DKIM-Filter: OpenDKIM Filter v2.11.0 shelob.oktetlabs.ru 8D5D85D Authentication-Results: shelob.oktetlabs.ru/8D5D85D; dkim=none; dkim-atps=neutral From: Ivan Malov To: dev@dpdk.org Cc: Yuying Zhang , Beilei Xing , Qiming Yang , Wenjun Wu , Jiawen Wu , Jian Wang , Qi Zhang , Nithin Dabilpuram , Kiran Kumar K , Sunil Kumar Kori , Satha Rao , Ajit Khaparde , Somnath Kotur , Andrew Rybchenko , Ray Kinsella Subject: [PATCH] doc: clarify deprecation status for flow actions PF and VF Date: Wed, 5 Oct 2022 14:32:21 +0300 Message-Id: <20221005113221.3433890-1-ivan.malov@oktetlabs.ru> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org These actions have been deprecated since DPDK 21.11 as ambiguous and hard-to-use, but their removal might not be popular because net drivers i40e, ixgbe and txgbe employ these actions in complicated "PF/VF + QUEUE" tunnel rule support. Maintainers of these drivers should voice their attitude to the said problem. For now, document the status in deprecation notes. Signed-off-by: Ivan Malov Reviewed-by: Andrew Rybchenko --- doc/guides/rel_notes/deprecation.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index c31b92a41f..12867dc3cf 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -83,8 +83,13 @@ Deprecation Notices will be limited to maximum 256 queues. Also compile time flag ``RTE_ETHDEV_QUEUE_STAT_CNTRS`` will be removed. -* ethdev: Items and actions ``PF``, ``VF``, ``PHY_PORT``, ``PORT_ID`` are - deprecated as hard-to-use / ambiguous and will be removed in DPDK 22.11. +* ethdev: Flow actions ``PF`` and ``VF`` have been deprecated since DPDK 21.11 + and are yet to be removed. That still has not happened because there are net + drivers which support combined use of either action ``PF`` or action ``VF`` + with action ``QUEUE``, namely, i40e, ixgbe and txgbe (L2 tunnel rule). + It is unclear whether it is acceptable to just drop support for + such a complex use case, so maintainers of the said drivers + should take a closer look at this and provide assistance. * ethdev: Actions ``OF_DEC_NW_TTL``, ``SET_IPV4_SRC``, ``SET_IPV4_DST``, ``SET_IPV6_SRC``, ``SET_IPV6_DST``, ``SET_TP_SRC``, ``SET_TP_DST``,