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