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