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