Skip to contentSkip to conversation

rel_notes: announce 24.11 ipv6 api breakage

PATCH Superseded Robin Jarry 6 participants 7 messages Jul 22, 2024 – Jul 31, 2024

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 rel_notes: announce 24.11 ipv6 api breakage

In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays.

Cc Bruce Richardson <[email protected]>
Cc Morten Brørup <[email protected]>
Cc Stephen Hemminger <[email protected]>
Cc Vladimir Medvedkin <[email protected]>
Cc Konstantin Ananyev <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
doc/guides/rel_notes/deprecation.rst +16 -0
index 6948641ff69b..0d7da802382e 100644
@@ -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)
Signature · 1 line
2.45.2
#2 lore raw

PATCH v2 1/1 rel_notes: announce 24.11 ipv6 api breakage

In reply to Robin Jarry

In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays.

---

Notes:
v2: updated with the exhaustive list of symbols

 doc/guides/rel_notes/deprecation.rst | 42 ++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
doc/guides/rel_notes/deprecation.rst +42 -0
index 6948641ff69b..bb17b78d193a 100644
@@ -147,3 +147,45 @@ 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 and symbols are expected to be affected:
+
+  ethdev
+    - ``struct rte_flow_item_icmp6_nd_ns``
+    - ``struct rte_flow_item_icmp6_nd_na``
+    - ``struct rte_flow_action_set_ipv6``
+    - ``struct rte_flow_tunnel``
+  fib
+    - ``rte_fib6_add()``
+    - ``rte_fib6_delete()``
+    - ``rte_fib6_lookup_bulk()``
+  gro
+    - ``struct tcp6_flow_key``
+  hash
+    - ``struct rte_ipv6_tuple``
+  ipsec
+    - ``struct rte_ipsec_sadv6_key``
+  lpm
+    - ``rte_lpm6_add()``
+    - ``rte_lpm6_is_rule_present()``
+    - ``rte_lpm6_delete()``
+    - ``rte_lpm6_delete_bulk_func()``
+    - ``rte_lpm6_lookup()``
+    - ``rte_lpm6_lookup_bulk_func()``
+  net
+    - ``struct rte_ipv6_hdr``
+  node
+    - ``rte_node_ip6_route_add()``
+  pipeline
+    - ``struct rte_table_action_ipv6_header``
+  rib
+    - ``rte_rib6_lookup()``
+    - ``rte_rib6_lookup_exact()``
+    - ``rte_rib6_get_nxt()``
+    - ``rte_rib6_insert()``
+    - ``rte_rib6_remove()``
+    - ``rte_rib6_get_ip()``
+  table
+    - ``struct rte_table_lpm_ipv6_key``
Signature · 1 line
2.45.2
Acked-by on v2 1/1
#4 lore raw
In reply to Robin Jarry
Quoted 55 lines

In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays.

---

Notes:
v2: updated with the exhaustive list of symbols

 doc/guides/rel_notes/deprecation.rst | 42 ++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
doc/guides/rel_notes/deprecation.rst +33 -0
index 6948641ff69b..bb17b78d193a 100644
@@ -147,3 +147,45 @@ 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 and symbols are expected to be affected:
+
+  ethdev
+    - ``struct rte_flow_item_icmp6_nd_ns``
+    - ``struct rte_flow_item_icmp6_nd_na``
+    - ``struct rte_flow_action_set_ipv6``
+    - ``struct rte_flow_tunnel``
+  fib
+    - ``rte_fib6_add()``
+    - ``rte_fib6_delete()``
+    - ``rte_fib6_lookup_bulk()``
+  gro
+    - ``struct tcp6_flow_key``
+  hash
+    - ``struct rte_ipv6_tuple``
+  ipsec
+    - ``struct rte_ipsec_sadv6_key``
+  lpm
+    - ``rte_lpm6_add()``
+    - ``rte_lpm6_is_rule_present()``
+    - ``rte_lpm6_delete()``
+    - ``rte_lpm6_delete_bulk_func()``
+    - ``rte_lpm6_lookup()``
+    - ``rte_lpm6_lookup_bulk_func()``
+  net
+    - ``struct rte_ipv6_hdr``
+  node
+    - ``rte_node_ip6_route_add()``
+  pipeline
+    - ``struct rte_table_action_ipv6_header``

doc/guides/rel_notes/deprecation.rst Deprecation Notices

Quoted 10 lines
doc/guides/rel_notes/deprecation.rst +9 -1
+  rib
+    - ``rte_rib6_lookup()``
+    - ``rte_rib6_lookup_exact()``
+    - ``rte_rib6_get_nxt()``
+    - ``rte_rib6_insert()``
+    - ``rte_rib6_remove()``
+    - ``rte_rib6_get_ip()``
+  table
+    - ``struct rte_table_lpm_ipv6_key``
--
Quoted 2 lines

2.45.2

Acked-by on v2 1/1
#5 lore raw
In reply to Robin Jarry
Quoted 63 lines · Robin Jarry

In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays.

---

Notes:
v2: updated with the exhaustive list of symbols

  doc/guides/rel_notes/deprecation.rst | 42 ++++++++++++++++++++++++++++
  1 file changed, 42 insertions(+)
doc/guides/rel_notes/deprecation.rst +42 -0
index 6948641ff69b..bb17b78d193a 100644
@@ -147,3 +147,45 @@ 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 and symbols are expected to be affected:
+
+  ethdev
+    - ``struct rte_flow_item_icmp6_nd_ns``
+    - ``struct rte_flow_item_icmp6_nd_na``
+    - ``struct rte_flow_action_set_ipv6``
+    - ``struct rte_flow_tunnel``
+  fib
+    - ``rte_fib6_add()``
+    - ``rte_fib6_delete()``
+    - ``rte_fib6_lookup_bulk()``
+  gro
+    - ``struct tcp6_flow_key``
+  hash
+    - ``struct rte_ipv6_tuple``
+  ipsec
+    - ``struct rte_ipsec_sadv6_key``
+  lpm
+    - ``rte_lpm6_add()``
+    - ``rte_lpm6_is_rule_present()``
+    - ``rte_lpm6_delete()``
+    - ``rte_lpm6_delete_bulk_func()``
+    - ``rte_lpm6_lookup()``
+    - ``rte_lpm6_lookup_bulk_func()``
+  net
+    - ``struct rte_ipv6_hdr``
+  node
+    - ``rte_node_ip6_route_add()``
+  pipeline
+    - ``struct rte_table_action_ipv6_header``
+  rib
+    - ``rte_rib6_lookup()``
+    - ``rte_rib6_lookup_exact()``
+    - ``rte_rib6_get_nxt()``
+    - ``rte_rib6_insert()``
+    - ``rte_rib6_remove()``
+    - ``rte_rib6_get_ip()``
+  table
+    - ``struct rte_table_lpm_ipv6_key``
Signature · 2 lines
Regards,
Vladimir
Acked-by Bruce Richardson Acked-by Konstantin Ananyev Acked-by Vladimir Medvedkin on v2 1/1 Applied
#6 lore raw
In reply to Robin Jarry

23/07/2024 10:27, Robin Jarry:

Quoted 5 lines

In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays.

Applied, thanks.