doc/guides/rel_notes/release_2_2.rst

   1 DPDK Release 2.2
   2 ================
   3
   4 New Features
   5 ------------
   6
   7 * **Introduce ARMv7 and ARMv8 architectures**
   8
   9   * It is now possible to build DPDK for the ARMv7 and ARMv8 platforms.
  10   * ARMv7 can be tested with virtual PMD drivers.
  11   * ARMv8 can be tested with virtual and physical PMD drivers.
  12
  13 * **Enabled freeing of ring.**
  14
  15   New function rte_ring_free() allows the user to free a ring
  16   if it was created with rte_ring_create().
  17
  18 * **Added keepalive support to EAL and example application.**
  19
  20 * **Added ethdev API to support IEEE1588.**
  21
  22   Added functions to read, write and adjust system time in the NIC.
  23
  24 * **Extended Statistics**
  25
  26   Define extended statistics naming scheme to store metadata in the name
  27   string name of each statistic, refer to the Extended Statistics section
  28   of the programmers guide. Implemented the extended stats API for these
  29   PMDs:
  30
  31   * igb
  32   * igbvf
  33   * i40e
  34   * i40evf
  35   * fm10k
  36   * virtio
  37
  38 * **Added API in ethdev to retrieve RX/TX queue information.**
  39
  40   *  Add the ability for the upper layer to query RX/TX queue information.
  41   *  Add into rte_eth_dev_info new fields to represent information about
  42      RX/TX descriptors min/max/align numbers per queue for the device.
  43
  44 * **Added RSS dynamic configuration to bonding.**
  45
  46 * **Added e1000 Rx interrupt support.**
  47
  48 * **Added igb TSO support for both PF and VF.**
  49
  50 * **RSS enhancement on Intel x550 NIC**
  51
  52   * Support 512 entries RSS redirection table.
  53   * Support per VF RSS redirection table.
  54
  55 * **Flow director enhancement on Intel x550 NIC**
  56
  57   * Add 2 new flow director modes on x550.
  58   * One is MAC VLAN mode, the other is tunnel mode.
  59
  60 * **Added i40e vector RX/TX.**
  61
  62 * **Added i40e Rx interrupt support.**
  63
  64 * **Added i40e flow control support.**
  65
  66 * **Added DCB support to i40e PF driver.**
  67
  68 * **Added RSS/FD input set granularity on Intel X710/XL710.**
  69
  70 * **Added different GRE key length for input set on Intel X710/XL710.**
  71
  72 * **Added flow director support in i40e VF.**
  73
  74 * **Added fm10k vector RX/TX.**
  75
  76 * **Added fm10k TSO support for both PF and VF.**
  77
  78 * **Added fm10k VMDQ support.**
  79
  80 * **New NIC Boulder Rapid support.**
  81
  82   Boulder Rapid is a new NIC of Intel's fm10k family.
  83
  84 * **Enhanced support for the Chelsio CXGBE driver.**
  85
  86   *  Added support for Jumbo Frames.
  87   *  Optimize forwarding performance for Chelsio T5 40GbE cards.
  88
  89 * **Improved enic Tx packet rate.**
  90
  91   Reduced frequency of Tx tail pointer updates to the NIC.
  92
  93 * **Added support for Mellanox ConnectX-4 adapters (mlx5).**
  94
  95   The mlx5 poll-mode driver implements support for Mellanox ConnectX-4 EN
  96   and Mellanox ConnectX-4 Lx EN families of 10/25/40/50/100 Gb/s adapters.
  97
  98   Like mlx4, this PMD is only available for Linux and is disabled by default
  99   due to external dependencies (libibverbs and libmlx5).
 100
 101 * **Added virtual szedata2 driver for COMBO cards.**
 102
 103   Added virtual PMD for COMBO-100G and COMBO-80G cards.
 104   PMD is disabled in default configuration.
 105
 106 * **Enhanced support for virtio driver.**
 107
 108   * Virtio ring layout optimization (fixed avail ring)
 109   * Vector RX
 110   * Simple TX
 111
 112 * **Added vhost-user multiple queue support.**
 113
 114 * **Added port hotplug support to vmxnet3.**
 115
 116 * **Added port hotplug support to xenvirt.**
 117
 118
 119 Resolved Issues
 120 ---------------
 121
 122 EAL
 123 ~~~
 124
 125 * **eal/linux: Fixed epoll timeout.**
 126
 127   Fixed issue where the ``rte_epoll_wait()`` function didn't return when the
 128   underlying call to ``epoll_wait()`` timed out.
 129
 130
 131 Drivers
 132 ~~~~~~~
 133
 134 * **igb: Fixed IEEE1588 frame identification in I210.**
 135
 136   Fixed issue where the flag PKT_RX_IEEE1588_PTP was not being set
 137   in Intel I210 NIC, as EtherType in RX descriptor is in bits 8:10 of
 138   Packet Type and not in the default bits 0:2.
 139
 140 * **igb: Fixed VF start with PF stopped.**
 141
 142   VF needs the PF interrupt support initialized even if not started.
 143
 144 * **ixgbe: Fixed issue with X550 DCB.**
 145
 146   Fixed a DCB issue with x550 where for 8 TCs (Traffic Classes), if a packet
 147   with user priority 6 or 7 was injected to the NIC, then the NIC would only
 148   put 3 packets into the queue. There was also a similar issue for 4 TCs.
 149
 150 * **ixgbe: Removed burst size restriction of vector RX.**
 151
 152   Fixed issue where a burst size less than 32 didn't receive anything.
 153
 154 * **ixgbe: Fixed VF start with PF stopped.**
 155
 156   VF needs the PF interrupt support initialized even if not started.
 157
 158 * **ixgbe: Fixed TX hang when RS distance exceeds HW limit.**
 159
 160   Fixed an issue when TX queue can hang when a lot of highly fragmented
 161   packets have to be sent.
 162   As part of that fix, tx_rs_thresh for ixgbe PMD is not allowed to be greater
 163   then to 32 to comply with HW restrictions.
 164
 165 * **i40e: Fixed base driver allocation when not using first numa node.**
 166
 167   Fixed i40e issue that occurred when a DPDK application didn't initialize
 168   ports if memory wasn't available on socket 0.
 169
 170 * **i40e: Fixed maximum of 64 queues per port.**
 171
 172   Fixed the issue in i40e of cannot supporting more than 64 queues per port,
 173   though hardware actually supports that. The real number of queues may vary,
 174   as long as the total number of queues used in PF, VFs, VMDq and FD does not
 175   exceeds the hardware maximum.
 176
 177 * **i40e: Fixed statistics of packets.**
 178
 179   Added discarding packets on VSI to the stats and rectify the old statistics.
 180
 181 * **i40e: Fixed issue of not freeing memzone.**
 182
 183   Fixed the issue of not freeing memzone in the call to free the memory for
 184   adminq DMA.
 185
 186 * **vhost: Fixed Qemu shutdown.**
 187
 188   Fixed issue with libvirt ``virsh destroy`` not killing the VM.
 189
 190 * **virtio: Fixed crash after changing link state.**
 191
 192   Fixed io permission in the interrupt handler.
 193
 194 * **virtio: Fixed crash when releasing queue.**
 195
 196   Fixed issue when releasing null control queue.
 197
 198
 199 Libraries
 200 ~~~~~~~~~
 201
 202 * **hash: Fixed memory allocation of Cuckoo Hash key table.**
 203
 204   Fixed issue where an incorrect Cuckoo Hash key table size could be
 205   calculated limiting the size to 4GB.
 206
 207 * **hash: Fixed incorrect lookup if key is all zero.**
 208
 209   Fixed issue in hash library that occurred if an all zero
 210   key was not added in the table and the key was looked up,
 211   resulting in an incorrect hit.
 212
 213 * **hash: Fixed thread scaling by reducing contention.**
 214
 215   Fixed issue in hash library where, using multiple cores with
 216   hardware transactional memory support, thread scaling did not work,
 217   due to the global ring that is shared by all cores.
 218
 219
 220 Examples
 221 ~~~~~~~~
 222
 223
 224 Other
 225 ~~~~~
 226
 227
 228 Known Issues
 229 ------------
 230
 231 * Some drivers do not fill the packet type when receiving.
 232   As the l3fwd example application requires this info, the i40e vector
 233   driver must be disabled to benefit of the packet type with i40e.
 234
 235
 236 API Changes
 237 -----------
 238
 239 * The deprecated flow director API is removed.
 240   It was replaced by rte_eth_dev_filter_ctrl().
 241
 242 * The dcb_queue is renamed to dcb_tc in following dcb configuration
 243   structures: rte_eth_dcb_rx_conf, rte_eth_dcb_tx_conf,
 244   rte_eth_vmdq_dcb_conf, rte_eth_vmdq_dcb_tx_conf.
 245
 246 * The function rte_eal_pci_close_one() is removed.
 247   It was replaced by rte_eal_pci_detach().
 248
 249 * The deprecated ACL API ipv4vlan is removed.
 250
 251 * The deprecated hash function rte_jhash2() is removed.
 252   It was replaced by rte_jhash_32b().
 253
 254 * The deprecated KNI functions are removed:
 255   rte_kni_create(), rte_kni_get_port_id() and rte_kni_info_get().
 256
 257 * The deprecated ring PMD functions are removed:
 258   rte_eth_ring_pair_create() and rte_eth_ring_pair_attach().
 259
 260 * The devargs union field virtual is renamed to virt for C++ compatibility.
 261
 262
 263 ABI Changes
 264 -----------
 265
 266 * The EAL and ethdev structures rte_intr_handle and rte_eth_conf were changed
 267   to support Rx interrupt. It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 268
 269 * The ethdev flow director entries for SCTP were changed.
 270   It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 271
 272 * The ethdev flow director structure rte_eth_fdir_flow_ext structure is changed.
 273   New fields are added to support flow director filtering in VF.
 274
 275 * The size of the ethdev structure rte_eth_hash_filter_info is changed
 276   by adding a new element rte_eth_input_set_conf in an union.
 277
 278 * The new fields rx_desc_lim and tx_desc_lim are added into rte_eth_dev_info
 279   structure.
 280
 281 * The maximum number of queues per port CONFIG_RTE_MAX_QUEUES_PER_PORT is
 282   increased to 1024.
 283
 284 * The mbuf structure was changed to support unified packet type.
 285   It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 286
 287 * The dummy malloc library is removed. The content was moved into EAL in 2.1.
 288
 289 * The LPM structure is changed. The deprecated field mem_location is removed.
 290
 291 * librte_table LPM: A new parameter to hold the table name will be added to
 292   the LPM table parameter structure.
 293
 294 * librte_port: Macros to access the packet meta-data stored within the packet
 295   buffer has been adjusted to cover the packet mbuf structure.
 296
 297 * librte_cfgfile: Allow longer names and values by increasing the constants
 298   CFG_NAME_LEN and CFG_VALUE_LEN to 64 and 256 respectively.
 299
 300
 301 Shared Library Versions
 302 -----------------------
 303
 304 The libraries prepended with a plus sign were incremented in this version.
 305
 306 .. code-block:: diff
 307
 308    + libethdev.so.2
 309    + librte_acl.so.2
 310    + librte_cfgfile.so.2
 311      librte_cmdline.so.1
 312      librte_distributor.so.1
 313    + librte_eal.so.2
 314    + librte_hash.so.2
 315      librte_ip_frag.so.1
 316      librte_ivshmem.so.1
 317      librte_jobstats.so.1
 318    + librte_kni.so.2
 319      librte_kvargs.so.1
 320    + librte_lpm.so.2
 321    + librte_mbuf.so.2
 322      librte_mempool.so.1
 323      librte_meter.so.1
 324      librte_pipeline.so.1
 325      librte_pmd_bond.so.1
 326    + librte_pmd_ring.so.2
 327    + librte_port.so.2
 328      librte_power.so.1
 329      librte_reorder.so.1
 330      librte_ring.so.1
 331      librte_sched.so.1
 332    + librte_table.so.2
 333      librte_timer.so.1
 334      librte_vhost.so.1