rel_notes: announce 24.11 ipv6 api breakage

Message ID 20240722173936.24303-2-rjarry@redhat.com (mailing list archive)
State Superseded, archived
Delegated to: Thomas Monjalon
Headers
Series rel_notes: announce 24.11 ipv6 api breakage |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/loongarch-compilation success Compilation OK
ci/loongarch-unit-testing success Unit Testing PASS
ci/Intel-compilation success Compilation OK
ci/intel-Testing success Testing PASS
ci/intel-Functional success Functional PASS
ci/github-robot: build success github build: passed
ci/iol-intel-Performance success Performance Testing PASS
ci/iol-mellanox-Performance success Performance Testing PASS
ci/iol-marvell-Functional success Functional Testing PASS
ci/iol-abi-testing success Testing PASS
ci/iol-broadcom-Performance success Performance Testing PASS
ci/iol-unit-arm64-testing success Testing PASS
ci/iol-intel-Functional success Functional Testing PASS
ci/iol-unit-amd64-testing success Testing PASS
ci/iol-compile-amd64-testing pending Testing pending
ci/iol-broadcom-Functional success Functional Testing PASS
ci/iol-compile-arm64-testing success Testing PASS
ci/iol-sample-apps-testing success Testing PASS

Commit Message

Robin Jarry July 22, 2024, 5:39 p.m. UTC
In 24.11, all IPv6 public APIs will be modified to use a structure
instead of fixed size arrays.

Cc: Bruce Richardson <bruce.richardson@intel.com>
Cc: Morten Brørup <mb@smartsharesystems.com>
Cc: Stephen Hemminger <stephen@networkplumber.org>
Cc: Vladimir Medvedkin <vladimir.medvedkin@intel.com>
Cc: Konstantin Ananyev <konstantin.ananyev@huawei.com>
Signed-off-by: Robin Jarry <rjarry@redhat.com>
---
 doc/guides/rel_notes/deprecation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
  

Comments

Morten Brørup July 22, 2024, 7:19 p.m. UTC | #1
> From: Robin Jarry [mailto:rjarry@redhat.com]
> Sent: Monday, 22 July 2024 19.40
> 
> In 24.11, all IPv6 public APIs will be modified to use a structure
> instead of fixed size arrays.

[...]

> +  - lpm (

Remove "(" or add something here.

With that fixed,
Acked-by: Morten Brørup <mb@smartsharesystems.com>
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 6948641ff69b..0d7da802382e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -147,3 +147,19 @@  Deprecation Notices
   will be deprecated and subsequently removed in DPDK 24.11 release.
   Before this, the new port library API (functions rte_swx_port_*)
   will gradually transition from experimental to stable status.
+
+* net: A new IPv6 address structure will be introduced in DPDK 24.11.
+  It will replace all ad-hoc ``uint8_t[16]`` arrays in all public APIs and structures.
+  The following libraries are expected to be affected:
+
+  - ethdev (rte_flow)
+  - fib
+  - gro (tcp6_flow_key)
+  - hash (rte_ipv6_tuple)
+  - ipsec (rte_ipsec_sadv6_key)
+  - lpm (
+  - net (rte_ipv6_hdr)
+  - node
+  - pipeline (rte_table_action_ipv6_header)
+  - rib
+  - table (rte_table_lpm_ipv6_key)