d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
91bc12c522
numam-dpdk/doc/guides/rel_notes/release_22_03.rst

215 lines
7.1 KiB
ReStructuredText
Raw Normal View History

version: 22.03-rc0 Start a new release cycle with empty release notes. Bump version and ABI minor. Enable ABI checks. Signed-off-by: David Marchand <david.marchand@redhat.com> Acked-by: Thomas Monjalon <thomas@monjalon.net>
2021-12-02 18:11:21 +00:00
.. SPDX-License-Identifier: BSD-3-Clause
Copyright 2021 The DPDK contributors
.. include:: <isonum.txt>
DPDK Release 22.03
==================
.. **Read this first.**
The text in the sections below explains how to update the release notes.
Use proper spelling, capitalization and punctuation in all sections.
Variable and config names should be quoted as fixed width text:
``LIKE_THIS``.
Build the docs and view the output file to ensure the changes are correct::
ninja -C build doc
xdg-open build/doc/guides/html/rel_notes/release_22_03.html
New Features
------------
.. This section should contain new features added in this release.
Sample format:
* **Add a title in the past tense with a full stop.**
Add a short 1-2 sentence description in the past tense.
The description should be enough to allow someone scanning
the release notes to understand the new feature.
If the feature adds a lot of sub-features you can use a bullet list
like this:
* Added feature foo to do something.
* Enhanced feature bar to do something else.
Refer to the previous release notes for examples.
Suggested order in release notes items:
* Core libs (EAL, mempool, ring, mbuf, buses)
* Device abstraction libs and PMDs (ordered alphabetically by vendor name)
- ethdev (lib, PMDs)
- cryptodev (lib, PMDs)
- eventdev (lib, PMDs)
- etc
* Other libs
* Apps, Examples, Tools (if significant)
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
eal: extend --huge-unlink for hugepage file reuse Expose Linux EAL ability to reuse existing hugepage files via --huge-unlink=never switch. Default behavior is unchanged, it can also be specified using --huge-unlink=existing for consistency. Old --huge-unlink switch is kept, it is an alias for --huge-unlink=always. Add a test case for the --huge-unlink=never mode. Signed-off-by: Dmitry Kozlyuk <dkozlyuk@nvidia.com> Acked-by: Thomas Monjalon <thomas@monjalon.net> Acked-by: Anatoly Burakov <anatoly.burakov@intel.com>
2022-02-03 18:13:36 +00:00
* **Added ability to reuse hugepages in Linux.**
It is possible to reuse files in hugetlbfs to speed up hugepage mapping,
which may be useful for fast restart and large allocations.
The new mode is activated with ``--huge-unlink=never``
and has security implications, refer to the user and programmer guides.
net: add UDP/TCP checksum in mbuf segments Add functions to call rte_raw_cksum_mbuf() to calculate IPv4/6 UDP/TCP checksum in mbuf which can be over multi-segments. Signed-off-by: Xiaoyun Li <xiaoyun.li@intel.com> Acked-by: Aman Singh <aman.deep.singh@intel.com> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com> Tested-by: Sunil Pai G <sunil.pai.g@intel.com>
2022-01-24 12:28:56 +00:00
* **Added functions to calculate UDP/TCP checksum in mbuf.**
* Added the following functions to calculate UDP/TCP checksum of packets
which can be over multi-segments:
- ``rte_ipv4_udptcp_cksum_mbuf()``
- ``rte_ipv4_udptcp_cksum_mbuf_verify()``
- ``rte_ipv6_udptcp_cksum_mbuf()``
- ``rte_ipv6_udptcp_cksum_mbuf_verify()``
ethdev: add L2TPv2 RSS offload type This patch defines new RSS offload type for L2TPv2, which is required when users want to distribute packets based on the L2TPv2 session ID field. Signed-off-by: Jie Wang <jie1x.wang@intel.com> Reviewed-by: Ferruh Yigit <ferruh.yigit@intel.com>
2022-02-09 09:38:52 +00:00
* **Added new RSS offload types for L2TPv2 in RSS flow.**
Added macro RTE_ETH_RSS_L2TPV2, now L2TPv2 session ID field can be used as
input set for RSS.
ethdev: introduce IP reassembly offload IP Reassembly is a costly operation if it is done in software. The operation becomes even more costlier if IP fragments are encrypted. However, if it is offloaded to HW, it can considerably save application cycles. Hence, a new offload feature is exposed in eth_dev ops for devices which can attempt IP reassembly of packets in hardware. - rte_eth_ip_reassembly_capability_get() - to get the maximum values of reassembly configuration which can be set. - rte_eth_ip_reassembly_conf_set() - to set IP reassembly configuration and to enable the feature in the PMD (to be called before rte_eth_dev_start()). - rte_eth_ip_reassembly_conf_get() - to get the current configuration set in PMD. Now when the offload is enabled using rte_eth_ip_reassembly_conf_set(), the resulting reassembled IP packet would be a typical segmented mbuf in case of success. And if reassembly of IP fragments is failed or is incomplete (if fragments do not come before the reass_timeout, overlap, etc), the mbuf dynamic flags can be updated by the PMD. This is updated in a subsequent patch. Signed-off-by: Akhil Goyal <gakhil@marvell.com>
2022-02-08 22:20:25 +00:00
* **Added IP reassembly Ethernet offload API, to get and set config.**
Added IP reassembly offload APIs which provide functions to query IP
reassembly capabilities, to set configuration and to get currently set
reassembly configuration.
ethdev: support queue-based priority flow control Based on device support and use-case need, there are two different ways to enable PFC. The first case is the port level PFC configuration, in this case, rte_eth_dev_priority_flow_ctrl_set() API shall be used to configure the PFC, and PFC frames will be generated using based on VLAN TC value. The second case is the queue level PFC configuration, in this case, Any packet field content can be used to steer the packet to the specific queue using rte_flow or RSS and then use rte_eth_dev_priority_flow_ctrl_queue_configure() to configure the TC mapping on each queue. Based on congestion selected on the specific queue, configured TC shall be used to generate PFC frames. Signed-off-by: Jerin Jacob <jerinj@marvell.com> Signed-off-by: Sunil Kumar Kori <skori@marvell.com> Reviewed-by: Ferruh Yigit <ferruh.yigit@intel.com>
2022-02-08 08:50:48 +00:00
* **Added an API to enable queue based priority flow ctrl(PFC).**
New APIs, ``rte_eth_dev_priority_flow_ctrl_queue_info_get()`` and
``rte_eth_dev_priority_flow_ctrl_queue_configure()``, was added.
ethdev: introduce dump API Added the ethdev dump API which provides querying private info from device. There exists many private properties in different PMD drivers, such as adapter state, Rx/Tx func algorithm in hns3 PMD. The information of these properties is important for debug. As the information is private, the new API is introduced. Signed-off-by: Min Hu (Connor) <humin29@huawei.com> Acked-by: Morten Brørup <mb@smartsharesystems.com> Acked-by: Ray Kinsella <mdr@ashroe.eu> Acked-by: Ajit Khaparde <ajit.khaparde@broadcom.com> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
2022-02-11 04:49:22 +00:00
* **Added a private dump API, to dump private info from device.**
Added the private dump API which provides querying private info from device.
There exists many private properties in different PMD drivers.
The information of these properties is important for debug.
As the information is private, a dump function is introduced.
net/af_xdp: use libxdp if available AF_XDP support is deprecated in libbpf since v0.7.0 [1]. The libxdp library now provides the functionality which once was in libbpf and which the AF_XDP PMD relies on. This commit updates the AF_XDP meson build to use the libxdp library if a version >= v1.2.2 is available. If it is not available, only versions of libbpf prior to v0.7.0 are allowed, as they still contain the required AF_XDP functionality. libbpf still remains a dependency even if libxdp is present, as we use libbpf APIs for program loading. The minimum required kernel version for libxdp for use with AF_XDP is v5.3. For the library to be fully-featured, a kernel v5.10 or newer is recommended. The full compatibility information can be found in the libxdp README. v1.2.2 of libxdp includes an important fix required for linking with DPDK which is why this version or greater is required. Meson uses pkg-config to verify the version of libxdp on the system, so it is necessary that the library is discoverable using pkg-config in order for the PMD to use it. To verify this, you can run: pkg-config --modversion libxdp [1] https://github.com/libbpf/libbpf/commit/277846bc6c15 Signed-off-by: Ciara Loftus <ciara.loftus@intel.com>
2022-01-28 09:50:29 +00:00
* **Updated AF_XDP PMD**
* Added support for libxdp >=v1.2.2.
net/enic: support GENEVE flow item Recent VIC models can parse GENEVE, including options, and inner packet headers. Enable GENEVE header and option flow items. Currently, only the first option that follows the GENEVE header can be matched, and the GENEVE header item must specify option length. Signed-off-by: Hyong Youb Kim <hyonkim@cisco.com> Reviewed-by: John Daley <johndale@cisco.com>
2022-01-20 14:26:37 +00:00
* **Updated Cisco enic driver.**
* Added rte_flow support for matching GENEVE packets.
net/enic: support eCPRI matching eCPRI message can be over Ethernet layer (.1Q supported also) or over UDP layer. Message header formats are the same in these two variants. Only up though the first packet header in the PDU can be matched. RSS on the eCPRI payload is not supported. Signed-off-by: John Daley <johndale@cisco.com> Reviewed-by: Hyong Youb Kim <hyonkim@cisco.com>
2022-01-28 17:58:11 +00:00
* Added rte_flow support for matching eCPRI packets.
net/enic: support GENEVE flow item Recent VIC models can parse GENEVE, including options, and inner packet headers. Enable GENEVE header and option flow items. Currently, only the first option that follows the GENEVE header can be matched, and the GENEVE header item must specify option length. Signed-off-by: Hyong Youb Kim <hyonkim@cisco.com> Reviewed-by: John Daley <johndale@cisco.com>
2022-01-20 14:26:37 +00:00
crypto/cnxk: support lookaside IPsec AES-CBC-HMAC-SHA256 Adding AES-CBC-HMAC-SHA256 support to lookaside IPsec PMD. Signed-off-by: Tejasree Kondoj <ktejasree@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:19:50 +00:00
* **Updated Marvell cnxk crypto PMD.**
* Added SHA256-HMAC support in lookaside protocol (IPsec) for CN10K.
crypto/cnxk: support lookaside IPsec HMAC-SHA384/512 Adding HMAC-SHA384/512 support to cnxk lookaside IPsec. Signed-off-by: Tejasree Kondoj <ktejasree@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:19:54 +00:00
* Added SHA384-HMAC support in lookaside protocol (IPsec) for CN9K & CN10K.
* Added SHA512-HMAC support in lookaside protocol (IPsec) for CN9K & CN10K.
crypto/cnxk: support lookaside IPsec AES-CTR Adding AES-CTR support to cnxk CPT in lookaside IPsec mode. Signed-off-by: Tejasree Kondoj <ktejasree@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:20:04 +00:00
* Added AES-CTR support in lookaside protocol (IPsec) for CN9K & CN10K.
crypto/cnxk: support AES-XCBC and null cipher Add support for AES XCBC and NULL cipher. Signed-off-by: Anoob Joseph <anoobj@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:20:06 +00:00
* Added NULL cipher support in lookaside protocol (IPsec) for CN9K & CN10K.
* Added AES-XCBC support in lookaside protocol (IPsec) for CN9K & CN10K.
crypto/cnxk: support AES-CMAC Add support for AES CMAC auth algorithm. Signed-off-by: Anoob Joseph <anoobj@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:20:08 +00:00
* Added AES-CMAC support in CN9K & CN10K.
crypto/cnxk: support lookaside IPsec AES-CBC-HMAC-SHA256 Adding AES-CBC-HMAC-SHA256 support to lookaside IPsec PMD. Signed-off-by: Tejasree Kondoj <ktejasree@marvell.com> Acked-by: Akhil Goyal <gakhil@marvell.com>
2021-12-17 09:19:50 +00:00
eventdev/eth_rx: add event port get API This patch introduces new api for retrieving event port id of eth rx adapter. Signed-off-by: Naga Harish K S V <s.v.naga.harish.k@intel.com> Acked-by: Jay Jayatheerthan <jay.jayatheerthan@intel.com>
2022-01-22 17:14:20 +00:00
* **Added an API to retrieve event port id of ethdev Rx adapter.**
The new API ``rte_event_eth_rx_adapter_event_port_get()`` was added.
app/testpmd: add SW L4 checksum in multi-segments Csum forwarding mode only supports software UDP/TCP csum calculation for single segment packets when hardware offload is not enabled. This patch enables software UDP/TCP csum calculation over multiple segments. Signed-off-by: Xiaoyun Li <xiaoyun.li@intel.com> Tested-by: Sunil Pai G <sunil.pai.g@intel.com> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
2022-01-24 12:28:57 +00:00
* **Updated testpmd.**
* Called ``rte_ipv4/6_udptcp_cksum_mbuf()`` functions in testpmd csum mode
to support software UDP/TCP checksum over multiple segments.
version: 22.03-rc0 Start a new release cycle with empty release notes. Bump version and ABI minor. Enable ABI checks. Signed-off-by: David Marchand <david.marchand@redhat.com> Acked-by: Thomas Monjalon <thomas@monjalon.net>
2021-12-02 18:11:21 +00:00
Removed Items
-------------
.. This section should contain removed items in this release. Sample format:
* Add a short 1-2 sentence description of the removed item
in the past tense.
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
examples/performance-thread: remove Remove sample application which is not clear if it is still relevant. Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
2021-12-17 13:15:26 +00:00
* **Removed experimental performance thread example application.**
version: 22.03-rc0 Start a new release cycle with empty release notes. Bump version and ABI minor. Enable ABI checks. Signed-off-by: David Marchand <david.marchand@redhat.com> Acked-by: Thomas Monjalon <thomas@monjalon.net>
2021-12-02 18:11:21 +00:00
API Changes
-----------
.. This section should contain API changes. Sample format:
* sample: Add a short 1-2 sentence description of the API change
which was announced in the previous releases and made in this release.
Start with a scope label like "ethdev:".
Use fixed width quotes for ``function_names`` or ``struct_names``.
Use the past tense.
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
net: add UDP/TCP checksum in mbuf segments Add functions to call rte_raw_cksum_mbuf() to calculate IPv4/6 UDP/TCP checksum in mbuf which can be over multi-segments. Signed-off-by: Xiaoyun Li <xiaoyun.li@intel.com> Acked-by: Aman Singh <aman.deep.singh@intel.com> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com> Tested-by: Sunil Pai G <sunil.pai.g@intel.com>
2022-01-24 12:28:56 +00:00
* net: added experimental functions ``rte_ipv4_udptcp_cksum_mbuf()``,
``rte_ipv4_udptcp_cksum_mbuf_verify()``, ``rte_ipv6_udptcp_cksum_mbuf()``,
``rte_ipv6_udptcp_cksum_mbuf_verify()``
ethdev: mark old macros as deprecated Old macros kept for backward compatibility, but this cause old macro usage to sneak in silently. Marking old macros as deprecated. Downside is this will cause some noise for applications that are using old macros. Fixes: 295968d17407 ("ethdev: add namespace") Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com> Acked-by: Stephen Hemminger <stephen@networkplumber.org>
2022-01-12 14:36:23 +00:00
* ethdev: Old public macros and enumeration constants without ``RTE_ETH_`` prefix,
which are kept for backward compatibility, are marked as deprecated.
version: 22.03-rc0 Start a new release cycle with empty release notes. Bump version and ABI minor. Enable ABI checks. Signed-off-by: David Marchand <david.marchand@redhat.com> Acked-by: Thomas Monjalon <thomas@monjalon.net>
2021-12-02 18:11:21 +00:00
ABI Changes
-----------
.. This section should contain ABI changes. Sample format:
* sample: Add a short 1-2 sentence description of the ABI change
which was announced in the previous releases and made in this release.
Start with a scope label like "ethdev:".
Use fixed width quotes for ``function_names`` or ``struct_names``.
Use the past tense.
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
* No ABI change that would break compatibility with 21.11.
Known Issues
------------
.. This section should contain new known issues in this release. Sample format:
* **Add title in present tense with full stop.**
Add a short 1-2 sentence description of the known issue
in the present tense. Add information on any known workarounds.
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
Tested Platforms
----------------
.. This section should contain a list of platforms that were tested
with this release.
The format is:
* <vendor> platform with <vendor> <type of devices> combinations
* List of CPU
* List of OS
* List of devices
* Other relevant details...
This section is a comment. Do not overwrite or remove it.
Also, make sure to start the actual text at the margin.
=======================================================
Reference in New Issue Copy Permalink