doc/guides/rel_notes/release_2_2.rst

   1 DPDK Release 2.2
   2 ================
   3
   4 New Features
   5 ------------
   6
   7 * **Added API in ethdev to retrieve RX/TX queue information.**
   8
   9   *  Add the ability for the upper layer to query RX/TX queue information.
  10   *  Add into rte_eth_dev_info new fields to represent information about
  11      RX/TX descriptors min/max/align numbers per queue for the device.
  12
  13 * **Added RSS dynamic configuration to bonding.**
  14
  15 * **Added e1000 Rx interrupt support.**
  16
  17 * **Added igb TSO support for both PF and VF.**
  18
  19 * **RSS enhancement on Intel x550 NIC**
  20
  21   * Support 512 entries RSS redirection table.
  22   * Support per VF RSS redirection table.
  23
  24 * **Flow director enhancement on Intel x550 NIC**
  25
  26   * Add 2 new flow director modes on x550.
  27   * One is MAC VLAN mode, the other is tunnel mode.
  28
  29 * **Added i40e vector RX/TX.**
  30
  31 * **Added i40e flow control support.**
  32
  33 * **Added DCB support to i40e PF driver.**
  34
  35 * **Added fm10k TSO support for both PF and VF.**
  36
  37 * **Added fm10k VMDQ support.**
  38
  39 * **New NIC Boulder Rapid support.**
  40
  41   Boulder Rapid is a new NIC of Intel's fm10k family.
  42
  43 * **Enhanced support for the Chelsio CXGBE driver.**
  44
  45   *  Added support for Jumbo Frames.
  46   *  Optimize forwarding performance for Chelsio T5 40GbE cards.
  47
  48 * **Added support for Mellanox ConnectX-4 adapters (mlx5).**
  49
  50   The mlx5 poll-mode driver implements support for Mellanox ConnectX-4 EN
  51   and Mellanox ConnectX-4 Lx EN families of 10/25/40/50/100 Gb/s adapters.
  52
  53   Like mlx4, this PMD is only available for Linux and is disabled by default
  54   due to external dependencies (libibverbs and libmlx5).
  55
  56 * **Added vhost-user multiple queue support.**
  57
  58 * **Added port hotplug support to xenvirt.**
  59
  60
  61 Resolved Issues
  62 ---------------
  63
  64 EAL
  65 ~~~
  66
  67 * **eal/linux: Fixed epoll timeout.**
  68
  69   Fixed issue where the ``rte_epoll_wait()`` function didn't return when the
  70   underlying call to ``epoll_wait()`` timed out.
  71
  72
  73 Drivers
  74 ~~~~~~~
  75
  76 * **igb: Fixed IEEE1588 frame identification in I210.**
  77
  78   Fixed issue where the flag PKT_RX_IEEE1588_PTP was not being set
  79   in Intel I210 NIC, as EtherType in RX descriptor is in bits 8:10 of
  80   Packet Type and not in the default bits 0:2.
  81
  82 * **ixgbe: Fixed issue with X550 DCB.**
  83
  84   Fixed a DCB issue with x550 where for 8 TCs (Traffic Classes), if a packet
  85   with user priority 6 or 7 was injected to the NIC, then the NIC would only
  86   put 3 packets into the queue. There was also a similar issue for 4 TCs.
  87
  88 * **ixgbe: Removed burst size restriction of vector RX.**
  89
  90   Fixed issue where a burst size less than 32 didn't receive anything.
  91
  92 * **i40e: Fixed base driver allocation when not using first numa node.**
  93
  94   Fixed i40e issue that occurred when a DPDK application didn't initialize
  95   ports if memory wasn't available on socket 0.
  96
  97 * **vhost: Fixed Qemu shutdown.**
  98
  99   Fixed issue with libvirt ``virsh destroy`` not killing the VM.
 100
 101 * **virtio: Fixed crash after changing link state.**
 102
 103   Fixed io permission in the interrupt handler.
 104
 105 * **virtio: Fixed crash when releasing queue.**
 106
 107   Fixed issue when releasing null control queue.
 108
 109
 110 Libraries
 111 ~~~~~~~~~
 112
 113 * **hash: Fixed memory allocation of Cuckoo Hash key table.**
 114
 115   Fixed issue where an incorrect Cuckoo Hash key table size could be
 116   calculated limiting the size to 4GB.
 117
 118
 119 Examples
 120 ~~~~~~~~
 121
 122
 123 Other
 124 ~~~~~
 125
 126
 127 Known Issues
 128 ------------
 129
 130
 131 API Changes
 132 -----------
 133
 134 * The deprecated flow director API is removed.
 135   It was replaced by rte_eth_dev_filter_ctrl().
 136
 137 * The dcb_queue is renamed to dcb_tc in following dcb configuration
 138   structures: rte_eth_dcb_rx_conf, rte_eth_dcb_tx_conf,
 139   rte_eth_vmdq_dcb_conf, rte_eth_vmdq_dcb_tx_conf.
 140
 141 * The function rte_eal_pci_close_one() is removed.
 142   It was replaced by rte_eal_pci_detach().
 143
 144 * The deprecated ACL API ipv4vlan is removed.
 145
 146 * The deprecated hash function rte_jhash2() is removed.
 147   It was replaced by rte_jhash_32b().
 148
 149 * The deprecated KNI functions are removed:
 150   rte_kni_create(), rte_kni_get_port_id() and rte_kni_info_get().
 151
 152 * The deprecated ring PMD functions are removed:
 153   rte_eth_ring_pair_create() and rte_eth_ring_pair_attach().
 154
 155 * The devargs union field virtual is renamed to virt for C++ compatibility.
 156
 157
 158 ABI Changes
 159 -----------
 160
 161 * The EAL and ethdev structures rte_intr_handle and rte_eth_conf were changed
 162   to support Rx interrupt. It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 163
 164 * The ethdev flow director entries for SCTP were changed.
 165   It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 166
 167 * The new fields rx_desc_lim and tx_desc_lim are added into rte_eth_dev_info
 168   structure.
 169
 170 * The mbuf structure was changed to support unified packet type.
 171   It was already done in 2.1 for CONFIG_RTE_NEXT_ABI.
 172
 173 * The dummy malloc library is removed. The content was moved into EAL in 2.1.
 174
 175 * The LPM structure is changed. The deprecated field mem_location is removed.
 176
 177 * librte_table LPM: A new parameter to hold the table name will be added to
 178   the LPM table parameter structure.
 179
 180 * librte_port: Macros to access the packet meta-data stored within the packet
 181   buffer has been adjusted to cover the packet mbuf structure.
 182
 183 * librte_cfgfile: Allow longer names and values by increasing the constants
 184   CFG_NAME_LEN and CFG_VALUE_LEN to 64 and 256 respectively.
 185
 186
 187 Shared Library Versions
 188 -----------------------
 189
 190 The libraries prepended with a plus sign were incremented in this version.
 191
 192 .. code-block:: diff
 193
 194    + libethdev.so.2
 195    + librte_acl.so.2
 196    + librte_cfgfile.so.2
 197      librte_cmdline.so.1
 198      librte_distributor.so.1
 199    + librte_eal.so.2
 200    + librte_hash.so.2
 201      librte_ip_frag.so.1
 202      librte_ivshmem.so.1
 203      librte_jobstats.so.1
 204    + librte_kni.so.2
 205      librte_kvargs.so.1
 206    + librte_lpm.so.2
 207    + librte_mbuf.so.2
 208      librte_mempool.so.1
 209      librte_meter.so.1
 210      librte_pipeline.so.1
 211      librte_pmd_bond.so.1
 212    + librte_pmd_ring.so.2
 213    + librte_port.so.2
 214      librte_power.so.1
 215      librte_reorder.so.1
 216      librte_ring.so.1
 217      librte_sched.so.1
 218    + librte_table.so.2
 219      librte_timer.so.1
 220      librte_vhost.so.1