1 .. SPDX-License-Identifier: BSD-3-Clause
2 Copyright 2020 The DPDK contributors
4 .. include:: <isonum.txt>
9 .. **Read this first.**
11 The text in the sections below explains how to update the release notes.
13 Use proper spelling, capitalization and punctuation in all sections.
15 Variable and config names should be quoted as fixed width text:
18 Build the docs and view the output file to ensure the changes are correct::
21 xdg-open build/doc/html/guides/rel_notes/release_21_02.html
25 A **dependency** has been added for building DPDK on Linux or FreeBSD:
26 the Python module **pyelftools** (version **0.22** or greater),
27 often packaged as python3-pyelftools, is required.
29 If not available as a distribution package, it can be installed with::
31 pip3 install pyelftools
37 .. This section should contain new features added in this release.
40 * **Add a title in the past tense with a full stop.**
42 Add a short 1-2 sentence description in the past tense.
43 The description should be enough to allow someone scanning
44 the release notes to understand the new feature.
46 If the feature adds a lot of sub-features you can use a bullet list
49 * Added feature foo to do something.
50 * Enhanced feature bar to do something else.
52 Refer to the previous release notes for examples.
54 Suggested order in release notes items:
55 * Core libs (EAL, mempool, ring, mbuf, buses)
56 * Device abstraction libs and PMDs
58 - cryptodev (lib, PMDs)
59 - eventdev (lib, PMDs)
62 * Apps, Examples, Tools (if significant)
64 This section is a comment. Do not overwrite or remove it.
65 Also, make sure to start the actual text at the margin.
66 =======================================================
68 * **Added new ethdev API for PMD power management.**
70 Added ``rte_eth_get_monitor_addr()``, to be used in conjunction with
71 ``rte_power_monitor()`` to enable automatic power management for PMDs.
73 * **Added Ethernet PMD power management helper API.**
75 A new helper API has been added to make using Ethernet PMD power management
76 easier for the user: ``rte_power_ethdev_pmgmt_queue_enable()``. Three power
77 management schemes are supported initially:
79 * Power saving based on UMWAIT instruction (x86 only)
80 * Power saving based on ``rte_pause()`` (generic) or TPAUSE instruction (x86 only)
81 * Power saving based on frequency scaling through the ``librte_power`` library
83 * **Added GENEVE TLV option in rte_flow.**
85 Added support for matching and raw encap/decap of GENEVE TLV option.
87 * **Added support for Modify field action in the flow API.**
89 Added "modify" action support to rte_flow to perform various operations on
90 any arbitrary header field (as well as mark, metadata or tag values):
91 ``RTE_FLOW_ACTION_TYPE_MODIFY_FIELD``.
92 Supported operations are: overwriting a field with the content from
93 another field, addition and subtraction using an immediate value.
95 * **Updated Broadcom bnxt driver.**
97 Updated the Broadcom bnxt driver with fixes and improvements, including:
99 * Added support for Stingray2 device.
101 * **Updated Cisco enic driver.**
103 * Added support for 64B completion queue entries.
105 * **Updated Hisilicon hns3 driver.**
107 * Added support for traffic management.
109 * **Updated Intel i40e driver.**
111 * Added Intel i40e support on Windows.
113 * **Updated Intel ice driver.**
115 Updated the Intel ice driver with new features and improvements, including:
117 * Added Double VLAN support for DCF switch QinQ filtering.
118 * Added support for UDP dynamic port assignment for eCPRI tunnels in DCF.
120 * **Updated Intel iavf driver.**
122 Updated iavf PMD with new features and improvements, including:
124 * Added support for FDIR/RSS packet steering for eCPRI flow.
125 * Added support for FDIR TCP/UDP pattern without input set.
127 * **Updated Mellanox mlx5 driver.**
129 Updated the Mellanox mlx5 driver with new features and improvements, including:
131 * Introduced basic support on Windows.
132 * Added GTP PDU session container matching and raw encap/decap.
133 * Added support for a RSS action in the sample sub-actions list.
134 * Added support for E-Switch mirroring and jump action in the same flow.
135 * Added support to handle the modify action in correct order regarding the
136 mirroring action on E-Switch.
137 * Enlarged the number of flow priorities to 21844 (0 - 21843) for ingress or
138 egress flow groups greater than 0 and for any transfer flow group.
139 * Added support for the Tx mbuf fast free offload.
140 * Added support for flow modify field action.
142 * **Updated the Pensando ionic driver.**
144 Updated the Pensando ionic driver with new features and improvements, including:
146 * Fixed bugs related to link autonegotiation.
147 * Fixed bugs related to port start/stop and queue start/stop.
148 * Added support for probing the supported queue versions. Note that
149 extremely old (pre-1.0) firmware will no longer be usable with the PMD.
150 * Removed unused code.
151 * Reduced device startup time.
153 * **Updated Wangxun txgbe driver.**
155 Updated the Wangxun txgbe driver with new features and improvements, including:
157 * Add support for generic flow API.
158 * Add support for traffic manager.
159 * Add support for IPsec.
161 * **Updated GSO support.**
163 * Added inner UDP/IPv4 support for VXLAN IPv4 GSO.
165 * **Added enqueue and dequeue callback APIs for cryptodev library.**
167 The Cryptodev library has been enhanced with enqueue and dequeue callback APIs to
168 enable applications to add/remove user callbacks which get called
169 for every enqueue/dequeue operation.
171 * **Updated the OCTEON TX2 crypto PMD.**
173 * Updated the OCTEON TX2 crypto PMD lookaside protocol offload for IPsec with
174 ESN and anti-replay support.
175 * Updated the OCTEON TX2 crypto PMD with CN98xx support.
176 * Added support for aes-cbc sha1-hmac cipher combination in OCTEON TX2 crypto
177 PMD lookaside protocol offload for IPsec.
178 * Added support for aes-cbc sha256-128-hmac cipher combination in OCTEON TX2
179 crypto PMD lookaside protocol offload for IPsec.
181 * **Added mlx5 compress PMD.**
183 Added a new compress PMD driver for Bluefield 2 adapters.
185 See the :doc:`../compressdevs/mlx5` for more details.
187 * **Added python script to run crypto perf tests and graph the results.**
189 A new Python script has been added to automate running crypto performance
190 tests and output graphed results to PDF files.
191 See the :doc:`../tools/cryptoperf` guide for more details.
193 * **Added Windows support to pmdinfogen.**
195 PMD information strings were added for Windows as well as for other OS.
196 Extracting them from Windows DLL is not yet supported.
197 The build-time tool pmdinfogen was rewritten in Python,
198 thus libelf dependency was replaced with pyelftools as new build dependency.
200 * **Added support for build-time checking of header includes.**
202 A new build option ``check_includes`` has been added, which, when enabled,
203 will perform build-time checking on DPDK public header files, to ensure none
204 are missing dependent header includes. This feature, disabled by default, is
205 intended for use by developers contributing to the DPDK SDK itself, and is
206 integrated into the build scripts and automated CI for patch contributions.
212 .. This section should contain removed items in this release. Sample format:
214 * Add a short 1-2 sentence description of the removed item
217 This section is a comment. Do not overwrite or remove it.
218 Also, make sure to start the actual text at the margin.
219 =======================================================
221 * The internal header files ``rte_ethdev_driver.h``, ``rte_ethdev_vdev.h`` and
222 ``rte_ethdev_pci.h`` are no longer installed as part of the DPDK
223 ``ninja install`` action and are renamed to ``ethdev_driver.h``,
224 ``ethdev_vdev.h`` and ``ethdev_pci.h`` respectively in the source tree, to
225 reflect the fact that they are non-public headers.
227 * The internal header files ``rte_eventdev_pmd.h``, ``rte_eventdev_pmd_vdev.h``
228 and ``rte_eventdev_pmd_pci.h`` are no longer installed as part of the DPDK
229 ``ninja install`` action and are renamed to ``eventdev_pmd.h``,
230 ``eventdev_pmd_vdev.h`` and ``eventdev_pmd_pci.h`` respectively in the source
231 tree, to reflect the fact that they are non-public headers.
233 * Removed support for NetXtreme devices belonging to ``BCM573xx and
234 BCM5740x`` families. Specifically the support for the following Broadcom
235 PCI device IDs ``0x16c8, 0x16c9, 0x16ca, 0x16ce, 0x16cf, 0x16df, 0x16d0,``
236 ``0x16d1, 0x16d2, 0x16d4, 0x16d5, 0x16e7, 0x16e8, 0x16e9`` has been removed.
238 * The ``check-includes.sh`` script for checking DPDK header files has been
239 removed, being replaced by the ``check_includes`` build option described
246 .. This section should contain API changes. Sample format:
248 * sample: Add a short 1-2 sentence description of the API change
249 which was announced in the previous releases and made in this release.
250 Start with a scope label like "ethdev:".
251 Use fixed width quotes for ``function_names`` or ``struct_names``.
254 This section is a comment. Do not overwrite or remove it.
255 Also, make sure to start the actual text at the margin.
256 =======================================================
258 * config: Removed the old macros, included in ``rte_config.h``,
259 to indicate which DPDK libraries and drivers are built.
260 The new macros are generated by meson in a standardized format:
261 ``RTE_LIB_<NAME>`` and ``RTE_<CLASS>_<NAME>``, where ``NAME`` is
262 the upper-case component name, e.g. ``EAL``, ``ETHDEV``, ``VIRTIO``,
263 and ``CLASS`` is the upper-case driver class, e.g. ``NET``, ``CRYPTO``.
265 * cryptodev: The structure ``rte_cryptodev`` has been updated with pointers
266 for adding enqueue and dequeue callbacks.
272 .. This section should contain ABI changes. Sample format:
274 * sample: Add a short 1-2 sentence description of the ABI change
275 which was announced in the previous releases and made in this release.
276 Start with a scope label like "ethdev:".
277 Use fixed width quotes for ``function_names`` or ``struct_names``.
280 This section is a comment. Do not overwrite or remove it.
281 Also, make sure to start the actual text at the margin.
282 =======================================================
284 * No ABI change that would break compatibility with 20.11.
286 * The experimental function ``rte_telemetry_init`` has been removed from the
287 public API and is now an internal-only function. Where telemetry library is
288 available, it is called automatically from ``rte_eal_init()`` and so no end
289 application need use it.
295 .. This section should contain a list of platforms that were tested
300 * <vendor> platform with <vendor> <type of devices> combinations
305 * Other relevant details...
307 This section is a comment. Do not overwrite or remove it.
308 Also, make sure to start the actual text at the margin.
309 =======================================================
311 * Intel\ |reg| platforms with Intel\ |reg| NICs combinations
315 * Intel\ |reg| Atom\ |trade| CPU C3758 @ 2.20GHz
316 * Intel\ |reg| Atom\ |trade| CPU C3858 @ 2.00GHz
317 * Intel\ |reg| Atom\ |trade| CPU C3958 @ 2.00GHz
318 * Intel\ |reg| Xeon\ |reg| CPU D-1541 @ 2.10GHz
319 * Intel\ |reg| Xeon\ |reg| CPU D-1553N @ 2.30GHz
320 * Intel\ |reg| Xeon\ |reg| CPU E5-2680 0 @ 2.70GHz
321 * Intel\ |reg| Xeon\ |reg| CPU E5-2680 v2 @ 2.80GHz
322 * Intel\ |reg| Xeon\ |reg| CPU E5-2699 v3 @ 2.30GHz
323 * Intel\ |reg| Xeon\ |reg| CPU E5-2699 v4 @ 2.20GHz
324 * Intel\ |reg| Xeon\ |reg| Gold 5218N CPU @ 2.30GHz
325 * Intel\ |reg| Xeon\ |reg| Gold 6139 CPU @ 2.30GHz
326 * Intel\ |reg| Xeon\ |reg| Gold 6252N CPU @ 2.30GHz
327 * Intel\ |reg| Xeon\ |reg| Platinum 8180 CPU @ 2.50GHz
328 * Intel\ |reg| Xeon\ |reg| Platinum 8280M CPU @ 2.70GHz
337 * Red Hat Enterprise Linux Server release 8.3
344 * Intel\ |reg| Ethernet Controller E810-C for SFP (4x25G)
346 * Firmware version: 2.40
347 * Device id (pf/vf): 8086:1593 / 8086:1889
348 * Driver version: 1.4.5 (ice)
349 * OS Default DDP: 1.3.21.0
350 * COMMS DDP: 1.3.25.0
351 * Wireless Edge DDP: 1.3.1.0
353 * Intel\ |reg| Ethernet Controller E810-C for QSFP (2x100G)
355 * Firmware version: 2.40
356 * Device id (pf/vf): 8086:1592 / 8086:1889
357 * Driver version: 1.4.5 (ice)
358 * OS Default DDP: 1.3.21.0
359 * COMMS DDP: 1.3.25.0
360 * Wireless Edge DDP: 1.3.1.0
362 * Intel\ |reg| 82599ES 10 Gigabit Ethernet Controller
364 * Firmware version: 0x61bf0001
365 * Device id (pf/vf): 8086:10fb / 8086:10ed
366 * Driver version: 5.10.2 (ixgbe)
368 * Intel\ |reg| Corporation Ethernet Connection X552/X557-AT 10GBASE-T
370 * Firmware version: 0x800003e7
371 * Device id (pf/vf): 8086:15ad / 8086:15a8
372 * Driver version: 5.1.0-k (ixgbe)
374 * Intel\ |reg| Corporation Ethernet Controller 10G X550T
376 * Firmware version: 0x80000482
377 * Device id (pf): 8086:1563
378 * Driver version: 5.10.2 (ixgbe)
380 * Intel\ |reg| Ethernet Converged Network Adapter X710-DA4 (4x10G)
382 * Firmware version: 8.00 0x80008b82 1.2766.0
383 * Device id (pf/vf): 8086:1572 / 8086:154c
384 * Driver version: 2.14.13 (i40e)
386 * Intel\ |reg| Corporation Ethernet Connection X722 for 10GbE SFP+ (4x10G)
388 * Firmware version: 5.00 0x800023c3 1.2766.0
389 * Device id (pf/vf): 8086:37d0 / 8086:37cd
390 * Driver version: 2.14.13 (i40e)
392 * Intel\ |reg| Corporation Ethernet Connection X722 for 10GBASE-T (2x10G)
394 * Firmware version: 4.10 0x80001a7a
395 * Device id (pf/vf): 8086:37d2 / 8086:37cd
396 * Driver version: 2.14.13 (i40e)
398 * Intel\ |reg| Ethernet Converged Network Adapter XXV710-DA2 (2x25G)
400 * Firmware version: 8.00 0x80008c1a 1.2766.0
401 * Device id (pf/vf): 8086:158b / 8086:154c
402 * Driver version: 2.14.13 (i40e)
404 * Intel\ |reg| Ethernet Converged Network Adapter XL710-QDA2 (2X40G)
406 * Firmware version: 8.00 0x80008b82 1.2766.0
407 * Device id (pf/vf): 8086:1583 / 8086:154c
408 * Driver version: 2.14.13 (i40e)
410 * Intel\ |reg| Corporation I350 Gigabit Network Connection
412 * Firmware version: 1.63, 0x80000cbc
413 * Device id (pf/vf): 8086:1521 / 8086:1520
414 * Driver version: 5.6.0-k (igb)
416 * Intel\ |reg| Corporation I210 Gigabit Network Connection
418 * Firmware version: 3.25, 0x800006eb
419 * Device id (pf): 8086:1533
420 * Driver version: 5.6.0-k (igb)
422 * Intel\ |reg| Ethernet Controller 10-Gigabit X540-AT2
424 * Firmware version: 0x800005f9
425 * Device id (pf): 8086:1528
426 * Driver version: 5.1.0-k (ixgbe)
428 * Intel\ |reg| Ethernet Converged Network Adapter X710-T2L
430 * Firmware version: 8.00 0x80008d10 1.2766.0
431 * Device id (pf): 8086:15ff
432 * Driver version: 2.14.13 (i40e)
434 * Intel\ |reg| platforms with Mellanox\ |reg| NICs combinations
438 * Intel\ |reg| Xeon\ |reg| Gold 6154 CPU @ 3.00GHz
439 * Intel\ |reg| Xeon\ |reg| CPU E5-2697A v4 @ 2.60GHz
440 * Intel\ |reg| Xeon\ |reg| CPU E5-2697 v3 @ 2.60GHz
441 * Intel\ |reg| Xeon\ |reg| CPU E5-2680 v2 @ 2.80GHz
442 * Intel\ |reg| Xeon\ |reg| CPU E5-2670 0 @ 2.60GHz
443 * Intel\ |reg| Xeon\ |reg| CPU E5-2650 v4 @ 2.20GHz
444 * Intel\ |reg| Xeon\ |reg| CPU E5-2640 @ 2.50GHz
445 * Intel\ |reg| Xeon\ |reg| CPU E5-2650 0 @ 2.00GHz
446 * Intel\ |reg| Xeon\ |reg| CPU E5-2620 v4 @ 2.10GHz
450 * Red Hat Enterprise Linux release 8.2 (Ootpa)
451 * Red Hat Enterprise Linux Server release 7.8 (Maipo)
452 * Red Hat Enterprise Linux Server release 7.6 (Maipo)
453 * Red Hat Enterprise Linux Server release 7.5 (Maipo)
454 * Red Hat Enterprise Linux Server release 7.4 (Maipo)
455 * Red Hat Enterprise Linux Server release 7.3 (Maipo)
456 * Red Hat Enterprise Linux Server release 7.2 (Maipo)
460 * SUSE Enterprise Linux 15 SP2
461 * SUSE Enterprise Linux 12 SP4
465 * MLNX_OFED 5.2-2.2.0.0 and above
466 * MLNX_OFED 5.1-2.5.8.0
470 * Linux 5.11.0-rc7 and above
474 * rdma-core-33.1-1 and above
478 * Mellanox\ |reg| ConnectX\ |reg|-3 Pro 40G MCX354A-FCC_Ax (2x40G)
480 * Host interface: PCI Express 3.0 x8
481 * Device ID: 15b3:1007
482 * Firmware version: 2.42.5000
484 * Mellanox\ |reg| ConnectX\ |reg|-3 Pro 40G MCX354A-FCCT (2x40G)
486 * Host interface: PCI Express 3.0 x8
487 * Device ID: 15b3:1007
488 * Firmware version: 2.42.5000
490 * Mellanox\ |reg| ConnectX\ |reg|-4 Lx 25G MCX4121A-ACAT (2x25G)
492 * Host interface: PCI Express 3.0 x8
493 * Device ID: 15b3:1015
494 * Firmware version: 14.29.2002 and above
496 * Mellanox\ |reg| ConnectX\ |reg|-4 Lx 50G MCX4131A-GCAT (1x50G)
498 * Host interface: PCI Express 3.0 x8
499 * Device ID: 15b3:1015
500 * Firmware version: 14.29.2002 and above
502 * Mellanox\ |reg| ConnectX\ |reg|-5 100G MCX516A-CCAT (2x100G)
504 * Host interface: PCI Express 3.0 x16
505 * Device ID: 15b3:1017
506 * Firmware version: 16.29.2002 and above
508 * Mellanox\ |reg| ConnectX\ |reg|-5 100G MCX556A-ECAT (2x100G)
510 * Host interface: PCI Express 3.0 x16
511 * Device ID: 15b3:1017
512 * Firmware version: 16.29.2002 and above
514 * Mellanox\ |reg| ConnectX\ |reg|-5 100G MCX556A-EDAT (2x100G)
516 * Host interface: PCI Express 3.0 x16
517 * Device ID: 15b3:1017
518 * Firmware version: 16.29.2002 and above
520 * Mellanox\ |reg| ConnectX\ |reg|-5 Ex EN 100G MCX516A-CDAT (2x100G)
522 * Host interface: PCI Express 4.0 x16
523 * Device ID: 15b3:1019
524 * Firmware version: 16.29.2002 and above
526 * Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 100G MCX623106AN-CDAT (2x100G)
528 * Host interface: PCI Express 4.0 x16
529 * Device ID: 15b3:101d
530 * Firmware version: 22.29.2002 and above
532 * Mellanox\ |reg| ConnectX\ |reg|-6 Lx EN 25G MCX631102AN-ADAT (2x25G)
534 * Host interface: PCI Express 4.0 x8
535 * Device ID: 15b3:101f
536 * Firmware version: 26.29.2002 and above
538 * Mellanox\ |reg| BlueField\ |reg| SmartNIC
540 * Mellanox\ |reg| BlueField\ |reg| 2 SmartNIC MT41686 - MBF2H332A-AEEOT (2x25G)
542 * Host interface: PCI Express 3.0 x16
543 * Device ID: 15b3:a2d2
544 * Firmware version: 24.29.2002 and above
548 * CentOS Linux release 7.6.1810 (AltArch)
549 * MLNX_OFED 5.2-2.2.0 and above
550 * DPDK application running on Arm cores
552 * Intel\ |reg| platforms with Broadcom\ |reg| NICs combinations
556 * Intel\ |reg| Xeon\ |reg| Gold 6154 CPU @ 3.00GHz
557 * Intel\ |reg| Xeon\ |reg| CPU E5-2667 v3 @ 3.20GHz
558 * Intel\ |reg| Xeon\ |reg| CPU E5-2650 v2 @ 2.60GHz
559 * Intel\ |reg| Xeon\ |reg| Gold 6142 CPU @ 2.60GHz
560 * Intel\ |reg| Xeon\ |reg| CPU E3-1270 v3 @ 3.50GHz
561 * Intel\ |reg| Xeon\ |reg| Gold 6134M CPU @ 3.20GHz
565 * Red Hat Enterprise Linux Server release 8.1
566 * Red Hat Enterprise Linux Server release 7.6
577 * Broadcom\ |reg| NetXtreme-E\ |reg| Series P225p (2x25G)
579 * Host interface: PCI Express 3.0 x8
580 * Firmware version: 214.4.114.0 and above
582 * Broadcom\ |reg| NetXtreme-E\ |reg| Series P425p (4x25G)
584 * Host interface: PCI Express 3.0 x16
585 * Firmware version: 218.0.124.0 and above
587 * Broadcom\ |reg| NetXtreme-E\ |reg| Series P2100G (2x100G)
589 * Host interface: PCI Express 3.0 x16
590 * Firmware version: 218.0.124.0 and above
592 * Broadcom\ |reg| NetXtreme-E\ |reg| Series P425p (4x25G)
594 * Host interface: PCI Express 4.0 x16
595 * Firmware version: 218.0.124.0 and above
597 * Broadcom\ |reg| NetXtreme-E\ |reg| Series P2100G (2x100G)
599 * Host interface: PCI Express 4.0 x16
600 * Firmware version: 218.0.124.0 and above
602 * Broadcom\ |reg| NetXtreme-S\ |reg| Series SmartNIC
604 * Broadcom\ |reg| NetXtreme-S\ |reg| Series PS225-H16 SmartNIC (2x25G)
606 * Host interface: PCI Express 3.0 x8
607 * Firmware version: 218.1.143.0
611 * Broadcom Yocto Linux
612 * Kernel version: 4.14.196
613 * DPDK application running on 8 Arm Cortex-A72 cores
615 * NXP ARMv8 SoCs (with integrated NICs)
619 * LX2xxx, LS2xxx, LS10xx
621 * OS (based on NXP LSDK-20.04):
623 * Kernel version: 4.19.90
624 * Kernel version: 5.4.47