doc/guides/rel_notes/release_22_07.rst

   1 .. SPDX-License-Identifier: BSD-3-Clause
   2    Copyright 2022 The DPDK contributors
   3
   4 .. include:: <isonum.txt>
   5
   6 DPDK Release 22.07
   7 ==================
   8
   9 .. **Read this first.**
  10
  11    The text in the sections below explains how to update the release notes.
  12
  13    Use proper spelling, capitalization and punctuation in all sections.
  14
  15    Variable and config names should be quoted as fixed width text:
  16    ``LIKE_THIS``.
  17
  18    Build the docs and view the output file to ensure the changes are correct::
  19
  20       ninja -C build doc
  21       xdg-open build/doc/guides/html/rel_notes/release_22_07.html
  22
  23
  24 New Features
  25 ------------
  26
  27 .. This section should contain new features added in this release.
  28    Sample format:
  29
  30    * **Add a title in the past tense with a full stop.**
  31
  32      Add a short 1-2 sentence description in the past tense.
  33      The description should be enough to allow someone scanning
  34      the release notes to understand the new feature.
  35
  36      If the feature adds a lot of sub-features you can use a bullet list
  37      like this:
  38
  39      * Added feature foo to do something.
  40      * Enhanced feature bar to do something else.
  41
  42      Refer to the previous release notes for examples.
  43
  44      Suggested order in release notes items:
  45      * Core libs (EAL, mempool, ring, mbuf, buses)
  46      * Device abstraction libs and PMDs (ordered alphabetically by vendor name)
  47        - ethdev (lib, PMDs)
  48        - cryptodev (lib, PMDs)
  49        - eventdev (lib, PMDs)
  50        - etc
  51      * Other libs
  52      * Apps, Examples, Tools (if significant)
  53
  54      This section is a comment. Do not overwrite or remove it.
  55      Also, make sure to start the actual text at the margin.
  56      =======================================================
  57
  58 * **Added protocol based input color selection for meter.**
  59
  60   Added new functions ``rte_mtr_color_in_protocol_set()``,
  61   ``rte_mtr_color_in_protocol_get()``,
  62   ``rte_mtr_color_in_protocol_priority_get()``,
  63   ``rte_mtr_meter_vlan_table_update()``
  64   and updated ``struct rte_mtr_params`` and ``struct rte_mtr_capabilities`` to
  65   support protocol based input color selection for meter.
  66
  67 * **Added telemetry for module EEPROM.**
  68
  69   Added telemetry command to dump module EEPROM.
  70   Added support for module EEPROM information format defined in:
  71
  72     * SFF-8079 revision 1.7
  73     * SFF-8472 revision 12.0
  74     * SFF-8636 revision 2.7
  75
  76 * **Added vhost API to get the number of in-flight packets.**
  77
  78   Added an API which can get the number of in-flight packets in
  79   vhost async data path without using lock.
  80
  81 * **Added vhost async dequeue API to receive packets from guest.**
  82
  83   Added vhost async dequeue API which can leverage DMA devices to
  84   accelerate receiving packets from guest.
  85
  86 * **Added vhost API to get the device type of a vDPA device.**
  87
  88   Added an API which can get the device type of vDPA device.
  89
  90 * **Updated Intel iavf driver.**
  91
  92   * Added Tx QoS queue rate limitation support.
  93   * Added quanta size configuration support.
  94   * Added ``DEV_RX_OFFLOAD_TIMESTAMP`` support.
  95   * Added Protocol Agnostic Flow Offloading support in AVF FDIR and RSS.
  96
  97 * **Updated Intel ice driver.**
  98
  99  * Added support for RSS RETA configure in DCF mode.
 100  * Added support for RSS HASH configure in DCF mode.
 101  * Added support for MTU configure in DCF mode.
 102  * Added support for promisc configuration in DCF mode.
 103  * Added support for MAC configuration in DCF mode.
 104  * Added support for VLAN filter and offload configuration in DCF mode.
 105  * Added Tx QoS queue / queue group rate limitation configure support.
 106  * Added Tx QoS queue / queue group priority configuration support.
 107  * Added Tx QoS queue weight configuration support.
 108
 109 * **Updated Intel igc driver.**
 110
 111   Added Intel Foxville I226 devices in ``igc`` driver.
 112   See the doc:`../nics/igc` NIC guide for more details.
 113
 114 * **Updated Mellanox mlx5 driver.**
 115
 116   * Added support for promiscuous mode on Windows.
 117   * Added support for MTU on Windows.
 118   * Added matching and RSS on IPsec ESP.
 119
 120 * **Updated VMware vmxnet3 networking driver.**
 121
 122   * Added version 5 support.
 123   * Added RETA query and RETA update support.
 124   * Added version 6 support with some new features:
 125
 126     * Increased maximum MTU up to 9190;
 127     * Increased maximum number of Rx and Tx queues;
 128     * Removed power-of-two limitations on Rx and Tx queue size;
 129     * Extended interrupt structures (required for additional queues).
 130
 131 * **Updated Wangxun ngbe driver.**
 132
 133   * Added support for yt8531s PHY.
 134
 135 * **Added Elliptic Curve Diffie-Hellman (ECDH) algorithm in cryptodev.**
 136
 137   Added support for Elliptic Curve Diffie Hellman (ECDH) asymmetric
 138   algorithm in cryptodev.
 139
 140 * **Updated Marvell cnxk crypto driver.**
 141
 142   * Added AH mode support in lookaside protocol (IPsec) for CN9K & CN10K.
 143   * Added AES-GMAC support in lookaside protocol (IPsec) for CN9K & CN10K.
 144
 145 * **Updated Intel QuickAssist Technology (QAT) crypto PMD.**
 146
 147   * Added support for secp384r1 elliptic curve.
 148
 149 * **Added eventdev API to quiesce an event port.**
 150
 151   Added the function ``rte_event_port_quiesce()``
 152   to quiesce any lcore-specific resources consumed by the event port,
 153   when the lcore is no more associated with an event port.
 154
 155 * **Added support for setting queue attributes at runtime in eventdev.**
 156
 157   Added new API ``rte_event_queue_attr_set()``, to set event queue attributes
 158   at runtime.
 159
 160 * **Added new queues attributes weight and affinity in eventdev.**
 161
 162   Defined new event queue attributes weight and affinity as below:
 163
 164   * ``RTE_EVENT_QUEUE_ATTR_WEIGHT``
 165   * ``RTE_EVENT_QUEUE_ATTR_AFFINITY``
 166
 167 * **Added scalar version of the LPM library.**
 168
 169   Added scalar implementation of ``rte_lpm_lookupx4``.
 170   This is a fall-back implementation for platforms that
 171   don't support vector operations.
 172
 173
 174 Removed Items
 175 -------------
 176
 177 .. This section should contain removed items in this release. Sample format:
 178
 179    * Add a short 1-2 sentence description of the removed item
 180      in the past tense.
 181
 182    This section is a comment. Do not overwrite or remove it.
 183    Also, make sure to start the actual text at the margin.
 184    =======================================================
 185
 186
 187 API Changes
 188 -----------
 189
 190 .. This section should contain API changes. Sample format:
 191
 192    * sample: Add a short 1-2 sentence description of the API change
 193      which was announced in the previous releases and made in this release.
 194      Start with a scope label like "ethdev:".
 195      Use fixed width quotes for ``function_names`` or ``struct_names``.
 196      Use the past tense.
 197
 198    This section is a comment. Do not overwrite or remove it.
 199    Also, make sure to start the actual text at the margin.
 200    =======================================================
 201
 202 * The DPDK header file ``rte_altivec.h``,
 203   which is a wrapper for the PPC header file ``altivec.h``,
 204   undefines the AltiVec keyword ``vector``.
 205   The alternative keyword ``__vector`` should be used instead.
 206
 207 * Experimental structures ``struct rte_mtr_params``
 208   and ``struct rte_mtr_capabilities`` updated to support
 209   protocol based input color for meter.
 210
 211
 212 ABI Changes
 213 -----------
 214
 215 .. This section should contain ABI changes. Sample format:
 216
 217    * sample: Add a short 1-2 sentence description of the ABI change
 218      which was announced in the previous releases and made in this release.
 219      Start with a scope label like "ethdev:".
 220      Use fixed width quotes for ``function_names`` or ``struct_names``.
 221      Use the past tense.
 222
 223    This section is a comment. Do not overwrite or remove it.
 224    Also, make sure to start the actual text at the margin.
 225    =======================================================
 226
 227 * No ABI change that would break compatibility with 21.11.
 228
 229
 230 Known Issues
 231 ------------
 232
 233 .. This section should contain new known issues in this release. Sample format:
 234
 235    * **Add title in present tense with full stop.**
 236
 237      Add a short 1-2 sentence description of the known issue
 238      in the present tense. Add information on any known workarounds.
 239
 240    This section is a comment. Do not overwrite or remove it.
 241    Also, make sure to start the actual text at the margin.
 242    =======================================================
 243
 244
 245 Tested Platforms
 246 ----------------
 247
 248 .. This section should contain a list of platforms that were tested
 249    with this release.
 250
 251    The format is:
 252
 253    * <vendor> platform with <vendor> <type of devices> combinations
 254
 255      * List of CPU
 256      * List of OS
 257      * List of devices
 258      * Other relevant details...
 259
 260    This section is a comment. Do not overwrite or remove it.
 261    Also, make sure to start the actual text at the margin.
 262    =======================================================