2020-02-25 16:32:00 +00:00
|
|
|
.. SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
Copyright 2020 The DPDK contributors
|
|
|
|
|
|
|
|
.. include:: <isonum.txt>
|
|
|
|
|
|
|
|
DPDK Release 20.05
|
|
|
|
==================
|
|
|
|
|
|
|
|
.. **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::
|
|
|
|
|
|
|
|
make doc-guides-html
|
|
|
|
|
|
|
|
xdg-open build/doc/html/guides/rel_notes/release_20_05.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
|
|
|
|
- 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.
|
|
|
|
=========================================================
|
|
|
|
|
2020-04-22 19:03:49 +00:00
|
|
|
* **Added Trace Library and Tracepoints**
|
|
|
|
|
|
|
|
A native implementation of ``common trace format(CTF)`` based trace library
|
|
|
|
has been added to provide the ability to add tracepoints in
|
|
|
|
application/library to get runtime trace/debug information for control and
|
|
|
|
fast APIs with minimum impact on fast path performance.
|
|
|
|
Typical trace overhead is ~20 cycles and instrumentation overhead is 1 cycle.
|
|
|
|
Added tracepoints in ``EAL``, ``ethdev``, ``cryptodev``, ``eventdev`` and
|
|
|
|
``mempool`` libraries for important functions.
|
|
|
|
|
2020-04-20 12:28:28 +00:00
|
|
|
* **Added new API for rte_ring.**
|
|
|
|
|
|
|
|
* New synchronization modes for rte_ring.
|
2020-04-20 12:28:24 +00:00
|
|
|
|
2020-04-20 12:28:26 +00:00
|
|
|
Introduced new optional MT synchronization modes for rte_ring:
|
|
|
|
Relaxed Tail Sync (RTS) mode and Head/Tail Sync (HTS) mode.
|
|
|
|
With these mode selected, rte_ring shows significant improvements for
|
|
|
|
average enqueue/dequeue times on overcommitted systems.
|
2020-04-20 12:28:24 +00:00
|
|
|
|
2020-04-20 12:28:28 +00:00
|
|
|
* Added peek style API for rte_ring.
|
|
|
|
|
|
|
|
For rings with producer/consumer in RTE_RING_SYNC_ST, RTE_RING_SYNC_MT_HTS
|
|
|
|
mode, provide an ability to split enqueue/dequeue operation into two phases
|
|
|
|
(enqueue/dequeue start; enqueue/dequeue finish). That allows user to inspect
|
|
|
|
objects in the ring without removing them from it (aka MT safe peek).
|
|
|
|
|
2020-04-21 10:11:38 +00:00
|
|
|
* **Added flow aging support.**
|
|
|
|
|
|
|
|
Added flow aging support to detect and report aged-out flows, including:
|
|
|
|
|
|
|
|
* Added new action: ``RTE_FLOW_ACTION_TYPE_AGE`` to set the timeout
|
|
|
|
and the application flow context for each flow.
|
|
|
|
* Added new event: ``RTE_ETH_EVENT_FLOW_AGED`` for the driver to report
|
|
|
|
that there are new aged-out flows.
|
|
|
|
* Added new query: ``rte_flow_get_aged_flows`` to get the aged-out flows
|
|
|
|
contexts from the port.
|
|
|
|
|
2020-05-06 12:22:08 +00:00
|
|
|
* **ethdev: Added a new value to link speed for 200Gbps**
|
|
|
|
|
2020-04-08 08:29:10 +00:00
|
|
|
* **Updated Amazon ena driver.**
|
|
|
|
|
|
|
|
Updated ena PMD with new features and improvements, including:
|
|
|
|
|
|
|
|
* Added support for large LLQ (Low-latency queue) headers.
|
2020-04-08 08:29:12 +00:00
|
|
|
* Added Tx drops as new extended driver statistic.
|
2020-04-08 08:29:13 +00:00
|
|
|
* Added support for accelerated LLQ mode.
|
2020-04-08 08:29:19 +00:00
|
|
|
* Handling of the 0 length descriptors on the Rx path.
|
2020-04-08 08:29:10 +00:00
|
|
|
|
2020-04-02 07:58:47 +00:00
|
|
|
* **Updated Intel i40e driver.**
|
|
|
|
|
|
|
|
Updated i40e PMD with new features and improvements, including:
|
|
|
|
|
|
|
|
* Enable MAC address as FDIR input set for ipv4-other, ipv4-udp and ipv4-tcp.
|
2020-04-15 08:46:09 +00:00
|
|
|
* Added support for RSS using L3/L4 source/destination only.
|
|
|
|
* Added support for setting hash function in rte flow.
|
2020-04-02 07:58:47 +00:00
|
|
|
|
2020-04-03 05:42:41 +00:00
|
|
|
* **Updated the Intel iavf driver.**
|
|
|
|
|
|
|
|
Update the Intel iavf driver with new features and improvements, including:
|
|
|
|
|
|
|
|
* Added generic filter support.
|
2020-04-21 06:19:26 +00:00
|
|
|
* Added advanced iavf with FDIR capability.
|
2020-04-22 01:02:54 +00:00
|
|
|
* Added advanced RSS configuration for VFs.
|
2020-04-03 05:42:41 +00:00
|
|
|
|
2020-03-27 02:56:36 +00:00
|
|
|
* **Updated the Intel ice driver.**
|
|
|
|
|
|
|
|
Updated the Intel ice driver with new features and improvements, including:
|
|
|
|
|
|
|
|
* Added support for DCF (Device Config Function) feature.
|
2020-04-03 04:45:57 +00:00
|
|
|
* Added switch filter support for intel DCF.
|
2020-03-27 02:56:36 +00:00
|
|
|
|
2020-04-05 21:16:57 +00:00
|
|
|
* **Updated Marvell OCTEON TX2 ethdev driver.**
|
|
|
|
|
|
|
|
Updated Marvell OCTEON TX2 ethdev driver with traffic manager support with
|
|
|
|
below features.
|
|
|
|
|
|
|
|
* Hierarchial Scheduling with DWRR and SP.
|
|
|
|
* Single rate - Two color, Two rate - Three color shaping.
|
|
|
|
|
2020-03-03 12:37:31 +00:00
|
|
|
* **Updated Mellanox mlx5 driver.**
|
|
|
|
|
|
|
|
Updated Mellanox mlx5 driver with new features and improvements, including:
|
|
|
|
|
|
|
|
* Added support for matching on IPv4 Time To Live and IPv6 Hop Limit.
|
2020-03-24 11:39:39 +00:00
|
|
|
* Added support for creating Relaxed Ordering Memory Regions.
|
2020-04-22 03:11:20 +00:00
|
|
|
* Added support for configuring Hairpin queue data buffer size.
|
2020-04-09 22:23:51 +00:00
|
|
|
* Added support for jumbo frame size (9K MTU) in Multi-Packet RQ mode.
|
2020-04-22 15:27:15 +00:00
|
|
|
* Removed flow rules caching for memory saving and compliance with ethdev API.
|
2020-04-20 06:53:44 +00:00
|
|
|
* Optimized the memory consumption of flow.
|
2020-04-29 02:25:09 +00:00
|
|
|
* Added support for flow aging based on hardware counter.
|
2020-05-05 12:57:54 +00:00
|
|
|
* Added support for flow pattern with wildcard VLAN item (without VID value).
|
2020-05-06 17:13:38 +00:00
|
|
|
* Updated support for matching on GTP header, added match on GTP flags.
|
2020-03-03 12:37:31 +00:00
|
|
|
|
2020-05-07 10:57:02 +00:00
|
|
|
* **Added Chacha20-Poly1305 algorithm to Cryptodev API.**
|
|
|
|
|
|
|
|
Chacha20-Poly1305 AEAD algorithm can now be supported in Cryptodev.
|
|
|
|
|
2020-04-15 11:51:35 +00:00
|
|
|
* **Updated the AESNI MB crypto PMD.**
|
|
|
|
|
2020-04-17 22:00:37 +00:00
|
|
|
* Added support for intel-ipsec-mb version 0.54.
|
2020-04-15 11:51:35 +00:00
|
|
|
* Updated the AESNI MB PMD with AES-256 DOCSIS algorithm.
|
2020-04-17 15:03:48 +00:00
|
|
|
* Added support for synchronous Crypto burst API.
|
2020-04-15 11:51:35 +00:00
|
|
|
|
2020-04-17 22:00:37 +00:00
|
|
|
* **Updated the AESNI GCM crypto PMD.**
|
|
|
|
|
|
|
|
* Added support for intel-ipsec-mb version 0.54.
|
|
|
|
|
2020-05-11 09:14:20 +00:00
|
|
|
* **Updated the ZUC crypto PMD.**
|
|
|
|
|
|
|
|
* Added support for intel-ipsec-mb version 0.54.
|
|
|
|
* Updated the PMD to support Multi-buffer ZUC-EIA3,
|
|
|
|
improving performance significantly, when using
|
|
|
|
intel-ipsec-mb version 0.54
|
|
|
|
|
2020-05-11 09:14:21 +00:00
|
|
|
* **Updated the SNOW3G crypto PMD.**
|
|
|
|
|
|
|
|
* Added support for intel-ipsec-mb version 0.54.
|
|
|
|
|
|
|
|
* **Updated the KASUMI crypto PMD.**
|
|
|
|
|
|
|
|
* Added support for intel-ipsec-mb version 0.54.
|
|
|
|
|
2020-04-15 08:48:00 +00:00
|
|
|
* **Added a new driver for Intel Foxville I225 devices.**
|
|
|
|
|
|
|
|
Added the new ``igc`` net driver for Intel Foxville I225 devices. See the
|
|
|
|
:doc:`../nics/igc` NIC guide for more details on this new driver.
|
|
|
|
|
2020-04-15 08:19:11 +00:00
|
|
|
* **Updated Broadcom bnxt driver.**
|
|
|
|
|
|
|
|
Updated Broadcom bnxt driver with new features and improvements, including:
|
|
|
|
|
|
|
|
* Added support for host based flow table management
|
2020-04-16 04:27:01 +00:00
|
|
|
* Added flow counters to extended stats
|
2020-04-02 05:26:29 +00:00
|
|
|
* Added PCI function stats to extended stats
|
2020-04-15 08:19:11 +00:00
|
|
|
|
2020-03-26 16:22:08 +00:00
|
|
|
* **Added handling of mixed crypto algorithms in QAT PMD for GEN2.**
|
|
|
|
|
|
|
|
Enabled handling of mixed algorithms in encrypted digest hash-cipher
|
|
|
|
(generation) and cipher-hash (verification) requests in QAT PMD
|
|
|
|
when running on GEN2 QAT hardware with particular firmware versions
|
|
|
|
(GEN3 support was added in DPDK 20.02).
|
|
|
|
|
2020-04-16 12:24:38 +00:00
|
|
|
* **Added plain SHA-1,224,256,384,512 support to QAT PMD.**
|
|
|
|
|
|
|
|
Added support for plain SHA-1, SHA-224, SHA-256, SHA-384 and SHA-512 hashes
|
|
|
|
to QAT PMD.
|
|
|
|
|
2020-05-07 09:19:49 +00:00
|
|
|
* **Added AES-GCM/GMAC J0 support to QAT PMD.**
|
|
|
|
|
|
|
|
Added support for AES-GCM/GMAC J0 to Intel QuickAssist Technology PMD. User can
|
|
|
|
use this feature by passing zero length IV in appropriate xform. For more
|
|
|
|
info please refer to rte_crypto_sym.h J0 comments.
|
|
|
|
|
2020-04-17 15:44:03 +00:00
|
|
|
* **Added QAT intermediate buffer too small handling in QAT compression PMD.**
|
|
|
|
|
|
|
|
Added a special way of buffer handling when internal QAT intermediate buffer
|
|
|
|
is too small for Huffman dynamic compression operation. Instead of falling
|
|
|
|
back to fixed compression, the operation is now split into multiple smaller
|
|
|
|
dynamic compression requests (possible to execute on QAT) and their results
|
|
|
|
are then combined and copied into the output buffer. This is not possible if
|
|
|
|
any checksum calculation was requested - in such case the code falls back to
|
|
|
|
fixed compression as before.
|
|
|
|
|
2020-03-26 03:27:42 +00:00
|
|
|
* **Updated the turbo_sw bbdev PMD.**
|
|
|
|
|
|
|
|
Supported large size code blocks which does not fit in one mbuf segment.
|
|
|
|
|
2020-04-18 22:46:38 +00:00
|
|
|
* **Added Intel FPGA_5GNR_FEC bbdev PMD.**
|
|
|
|
|
|
|
|
Added a new ``fpga_5gnr_fec`` bbdev driver for the Intel\ |reg| FPGA PAC
|
|
|
|
(Programmable Acceleration Card) N3000. See the
|
|
|
|
:doc:`../bbdevs/fpga_5gnr_fec` BBDEV guide for more details on this new driver.
|
|
|
|
|
2020-04-07 06:30:42 +00:00
|
|
|
* **Updated ipsec-secgw sample application with following features.**
|
2020-02-27 16:18:36 +00:00
|
|
|
|
2020-04-07 06:30:42 +00:00
|
|
|
* Updated ipsec-secgw application to add event based packet processing.
|
|
|
|
The worker thread(s) would receive events and submit them back to the
|
|
|
|
event device after the processing. This way, multicore scaling and HW
|
|
|
|
assisted scheduling is achieved by making use of the event device
|
|
|
|
capabilities. The event mode currently supports only inline IPsec
|
|
|
|
protocol offload.
|
|
|
|
|
|
|
|
* Updated ipsec-secgw application to support key sizes for AES-192-CBC,
|
|
|
|
AES-192-GCM, AES-256-GCM algorithms.
|
2020-02-27 16:18:36 +00:00
|
|
|
|
2020-04-16 16:47:29 +00:00
|
|
|
* Added IPsec inbound load-distribution support for ipsec-secgw application
|
|
|
|
using NIC load distribution feature(Flow Director).
|
|
|
|
|
2020-04-30 16:01:37 +00:00
|
|
|
* **Updated Telemetry Library.**
|
|
|
|
|
|
|
|
The updated Telemetry library has many improvements on the original version
|
|
|
|
to make it more accessible and scalable:
|
|
|
|
|
|
|
|
* It enables DPDK libraries and applications provide their own specific
|
|
|
|
telemetry information, rather than being limited to what could be reported
|
|
|
|
through the metrics library.
|
|
|
|
|
|
|
|
* It is no longer dependent on the external Jansson library, which allows
|
|
|
|
Telemetry be enabled by default.
|
|
|
|
|
|
|
|
* The socket handling has been simplified making it easier for clients to
|
|
|
|
connect and retrieve information.
|
|
|
|
|
2020-04-11 14:14:27 +00:00
|
|
|
* **Added rte_graph library.**
|
|
|
|
|
|
|
|
Graph architecture abstracts the data processing functions as a ``node`` and
|
|
|
|
``links`` them together to create a complex ``graph`` to enable reusable/modular
|
|
|
|
data processing functions. The graph library provides API to enable graph
|
|
|
|
framework operations such as create, lookup, dump and destroy on graph and node
|
|
|
|
operations such as clone, edge update, and edge shrink, etc.
|
|
|
|
The API also allows to create the stats cluster to monitor per graph and per node stats.
|
|
|
|
|
|
|
|
* **Added rte_node library which consists of a set of packet processing nodes.**
|
|
|
|
|
|
|
|
The rte_node library that consists of nodes used by rte_graph library. Each
|
|
|
|
node performs a specific packet processing function based on application
|
|
|
|
configuration. The following nodes are added:
|
|
|
|
|
|
|
|
* Null node: Skeleton node that defines the general structure of a node.
|
|
|
|
* Ethernet device node: Consists of ethernet Rx/Tx nodes as well as ethernet
|
|
|
|
control APIs.
|
|
|
|
* IPv4 lookup node: Consists of ipv4 extract and lpm lookup node. Routes can
|
|
|
|
be configured by the application through ``rte_node_ip4_route_add`` function.
|
|
|
|
* IPv4 rewrite node: Consists of ipv4 and ethernet header rewrite functionality
|
|
|
|
that can be configured through ``rte_node_ip4_rewrite_add`` function.
|
|
|
|
* Packet drop node: Frees the packets received to their respective mempool.
|
|
|
|
|
2020-04-11 14:14:28 +00:00
|
|
|
* **Added new l3fwd-graph sample application.**
|
|
|
|
|
|
|
|
Added an example application ``l3fwd-graph``. It demonstrates the usage of graph
|
|
|
|
library and node library for packet processing. In addition to the library usage
|
|
|
|
demonstration, this application can use for performance comparison with existing
|
|
|
|
``l3fwd`` (The static code without any nodes) with the modular ``l3fwd-graph``
|
|
|
|
approach.
|
|
|
|
|
2020-05-07 00:51:59 +00:00
|
|
|
* **Updated testpmd application.**
|
|
|
|
|
|
|
|
* Added a new cmdline option ``--rx-mq-mode`` which can be used to test PMD's
|
|
|
|
behaviour on handling Rx mq mode.
|
|
|
|
|
2020-02-25 16:32:00 +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.
|
|
|
|
=========================================================
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
=========================================================
|
|
|
|
|
2020-05-04 12:49:18 +00:00
|
|
|
* mempool: The API of ``rte_mempool_populate_iova()`` and
|
|
|
|
``rte_mempool_populate_virt()`` changed to return 0 instead of -EINVAL
|
|
|
|
when there is not enough room to store one object.
|
|
|
|
|
2020-02-25 16:32:00 +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 DPDK 20.02 and 19.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.
|
|
|
|
=========================================================
|