From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 2DEB24568F; Tue, 23 Jul 2024 10:31:51 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3C41E42E24; Tue, 23 Jul 2024 10:31:15 +0200 (CEST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id D120A40150 for ; Tue, 23 Jul 2024 10:27:56 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1721723276; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=HYP2briJPSGi6bl0cKUBv/nKhDr61xTXQweRHhQv48w=; b=QcR2Kf934eXTbpy7J4Gr4P2KeeuYKSS/4M8ElxRQX8UkKlaSJw5YwCJ+nXc1agMPn0tFEB dOLZSS+rndPfw+kfSymwWTERKRHzCTCIPzVlzobbpkWz57NtSQ9U26XkimQ8ZKaY07xryi pSL+j9iucGoLPrZT+du6x58NvKgTFT4= Received: from mx-prod-mc-04.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-646-CDLT-9XsM6iKnG8yV7bqaA-1; Tue, 23 Jul 2024 04:27:54 -0400 X-MC-Unique: CDLT-9XsM6iKnG8yV7bqaA-1 Received: from mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2442E19560B3; Tue, 23 Jul 2024 08:27:52 +0000 (UTC) Received: from ringo.redhat.com (unknown [10.39.208.36]) by mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 353413000194; Tue, 23 Jul 2024 08:27:48 +0000 (UTC) From: Robin Jarry To: dev@dpdk.org Cc: Bruce Richardson , Stephen Hemminger , Vladimir Medvedkin , Konstantin Ananyev , =?UTF-8?q?Morten=20Br=C3=B8rup?= Subject: [PATCH dpdk v2] rel_notes: announce 24.11 ipv6 api breakage Date: Tue, 23 Jul 2024 10:27:46 +0200 Message-ID: <20240723082745.31072-2-rjarry@redhat.com> In-Reply-To: <20240722173936.24303-2-rjarry@redhat.com> References: <20240722173936.24303-2-rjarry@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.4 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 In 24.11, all IPv6 public APIs will be modified to use a structure instead of fixed size arrays. Signed-off-by: Robin Jarry Acked-by: Morten Brørup --- Notes: v2: updated with the exhaustive list of symbols doc/guides/rel_notes/deprecation.rst | 42 ++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 6948641ff69b..bb17b78d193a 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -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`` -- 2.45.2