doc/guides/rel_notes/release_2_2.rst

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