2 Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
5 Redistribution and use in source and binary forms, with or without
6 modification, are permitted provided that the following conditions
9 * Redistributions of source code must retain the above copyright
10 notice, this list of conditions and the following disclaimer.
11 * Redistributions in binary form must reproduce the above copyright
12 notice, this list of conditions and the following disclaimer in
13 the documentation and/or other materials provided with the
15 * Neither the name of Intel Corporation nor the names of its
16 contributors may be used to endorse or promote products derived
17 from this software without specific prior written permission.
19 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 Known Issues and Limitations
32 ============================
34 This section describes known issues with the Intel® DPDK software, Release 1.6.0.
36 Pause Frame Forwarding does not work properly on igb
37 ----------------------------------------------------
39 +--------------------------------+--------------------------------------------------------------------------------------+
40 | Title | Pause Frame forwarding does not work properly on igb |
42 +================================+======================================================================================+
43 | Reference # | IXA00384637 |
45 +--------------------------------+--------------------------------------------------------------------------------------+
46 | Description | For igb devices rte_eth_flow_ctrl_set is not working as expected. |
47 | | Pause frames are always forwarded on igb, regardless of the RFCE, MPMCF and DPF |
50 +--------------------------------+--------------------------------------------------------------------------------------+
51 | Implication | Pause frames will never be rejected by the host on 1G NICs and they will always be |
54 +--------------------------------+--------------------------------------------------------------------------------------+
55 | Resolution/ Workaround | There is no workaround available. |
57 +--------------------------------+--------------------------------------------------------------------------------------+
58 | Affected Environment/ Platform | All |
60 +--------------------------------+--------------------------------------------------------------------------------------+
61 | Driver/Module | Poll Mode Driver (PMD) |
63 +--------------------------------+--------------------------------------------------------------------------------------+
65 Running TestPMD with SRIOV in Domain U may cause it to hang when XENVIRT switch is on
66 -------------------------------------------------------------------------------------
68 +--------------------------------+--------------------------------------------------------------------------------------+
69 | Title | Running TestPMD with SRIOV in Domain U may cause it to hang when XENVIRT switch is on|
71 +================================+======================================================================================+
72 | Reference # | IXA00168949 |
74 +--------------------------------+--------------------------------------------------------------------------------------+
75 | Description | When TestPMD is run with only SRIOV port “./testpmd -c f -n 4 -- -i” , the following |
78 | | PMD: gntalloc: ioctl error |
80 | | EAL: Error - exiting with code: 1 |
82 | | Cause: Creation of mbuf pool for socket 0 failed |
84 | | Then, alternately run SRIOV port and virtIO with testpmd: |
86 | | testpmd -c f -n 4 -- -i |
88 | | testpmd -c f -n 4 --use-dev="eth_xenvirt0" -- -i |
90 +--------------------------------+--------------------------------------------------------------------------------------+
91 | Implication | DomU will not be accessible after you repeat this action some times |
93 +--------------------------------+--------------------------------------------------------------------------------------+
94 | Resolution/ Workaround | Run testpmd with a "--total-num-mbufs=N(N<=3500)" |
96 +--------------------------------+--------------------------------------------------------------------------------------+
97 | Affected Environment/ Platform | Fedora 16, 64 bits + Xen hypervisor 4.2.3 + Domain 0 kernel 3.10.0 |
98 | | +Domain U kernel 3.6.11 |
100 +--------------------------------+--------------------------------------------------------------------------------------+
101 | Driver/Module | TestPMD Sample Application |
103 +--------------------------------+--------------------------------------------------------------------------------------+
105 Vhost-xen cannot detect Domain U application exit on Xen version 4.0.1
106 ----------------------------------------------------------------------
108 +--------------------------------+--------------------------------------------------------------------------------------+
109 | Title | Vhost-xen cannot detect Domain U application exit on Xen 4.0.1. |
111 +================================+======================================================================================+
112 | Reference # | IXA00168947 |
114 +--------------------------------+--------------------------------------------------------------------------------------+
115 | Description | When using Intel® DPDK applications on Xen 4.0.1, e.g. TestPMD Sample Application, |
116 | | on killing the application (e.g. killall testmd) vhost-switch cannot detect |
117 | | the domain U exited and does not free the Virtio device. |
119 +--------------------------------+--------------------------------------------------------------------------------------+
120 | Implication | Virtio device not freed after application is killed when using vhost-switch on Xen |
123 +--------------------------------+--------------------------------------------------------------------------------------+
126 +--------------------------------+--------------------------------------------------------------------------------------+
127 | Affected Environment/ Platform | Xen 4.0.1 |
129 +--------------------------------+--------------------------------------------------------------------------------------+
130 | Driver/Module | Vhost-switch |
132 +--------------------------------+--------------------------------------------------------------------------------------+
134 Virtio incorrect header length used if MSI-X is disabled by kernel driver
135 -------------------------------------------------------------------------
137 +--------------------------------+--------------------------------------------------------------------------------------+
138 | Title | Virtio incorrect header length used if MSI-X is disabled by kernel driver or |
139 | | if VIRTIO_NET_F_MAC is not negotiated. |
141 +================================+======================================================================================+
142 | Reference # | IXA00384256 |
144 +--------------------------------+--------------------------------------------------------------------------------------+
145 | Description | The Virtio header for host-guest communication is of variable length and |
146 | | is dependent on whether MSI-X has been enabled by the kernel driver for the network |
149 | | The base header length of 20 bytes will be extended by 4 bytes to accommodate MSI-X |
150 | | vectors and the Virtio Network Device header will appear at byte offset 24. |
152 | | The Userspace Virtio Poll Mode Driver tests the guest feature bits for the presence |
153 | | of VIRTIO_PCI_FLAG_MISIX, however this bit field is not part of the Virtio |
154 | | specification and resolves to the VIRTIO_NET_F_MAC feature instead. |
156 +--------------------------------+--------------------------------------------------------------------------------------+
157 | Implication | The Intel® DPDK kernel driver will enable MSI-X by default, |
158 | | however if loaded with “intr_mode=legacy” on a guest with a Virtio Network Device, |
159 | | a KVM-Qemu guest may crash with the following error: “virtio-net header not in first |
162 | | If VIRTIO_NET_F_MAC feature has not been negotiated, then the Userspace Poll Mode |
163 | | Driver will assume that MSI-X has been disabled and will prevent the proper |
164 | | functioning of the driver. |
166 +--------------------------------+--------------------------------------------------------------------------------------+
167 | Resolution | Ensure #define VIRTIO_PCI_CONFIG(hw) returns the correct offset (20 or 24 bytes) for |
168 | | the devices where in rare cases MSI-X is disabled or VIRTIO_NET_F_MAC has not been |
171 +--------------------------------+--------------------------------------------------------------------------------------+
172 | Affected Environment/ Platform | Virtio devices where MSI-X is disabled or VIRTIO_NET_F_MAC feature has not been |
175 +--------------------------------+--------------------------------------------------------------------------------------+
176 | Driver/Module | librte_pmd_virtio |
178 +--------------------------------+--------------------------------------------------------------------------------------+
180 gmake clean may silently fail for some example applications
181 -----------------------------------------------------------
183 +--------------------------------+--------------------------------------------------------------------------------------+
184 | Title | When using Free BSD* 9.2 gmake clean may silently fail for some sample applications |
186 +================================+======================================================================================+
187 | Reference # | IXA00834605 |
189 +--------------------------------+--------------------------------------------------------------------------------------+
190 | Description | gmake clean may silently fail leaving the source object files intact. |
192 +--------------------------------+--------------------------------------------------------------------------------------+
193 | Implication | Application object files are not removed. |
195 +--------------------------------+--------------------------------------------------------------------------------------+
196 | Resolution | Manually remove ./build folders or rebuild application source after editing. |
198 +--------------------------------+--------------------------------------------------------------------------------------+
199 | Affected Environment/ Platform | FreeBSD* 9.2 and below |
201 +--------------------------------+--------------------------------------------------------------------------------------+
202 | Driver/Module | Example Applications |
204 +--------------------------------+--------------------------------------------------------------------------------------+
206 In packets provided by the PMD, some flags are missing
207 ------------------------------------------------------
209 +--------------------------------+--------------------------------------------------------------------------------------+
210 | Title | In packets provided by the PMD, some flags are missing |
212 +================================+======================================================================================+
215 +--------------------------------+--------------------------------------------------------------------------------------+
216 | Description | In packets provided by the PMD, some flags are missing. |
217 | | The application does not have access to information provided by the hardware |
218 | | (packet is broadcast, packet is multicast, packet is IPv4 and so on). |
220 +--------------------------------+--------------------------------------------------------------------------------------+
221 | Implication | The “ol_flags” field in the “rte_mbuf” structure is not correct and should not be |
224 +--------------------------------+--------------------------------------------------------------------------------------+
225 | Resolution | The application has to parse the Ethernet header itself to get the information, |
226 | | which is slower. |
228 +--------------------------------+--------------------------------------------------------------------------------------+
229 | Affected Environment/ Platform | All |
231 +--------------------------------+--------------------------------------------------------------------------------------+
232 | Driver/Module | Poll Mode Driver (PMD) |
234 +--------------------------------+--------------------------------------------------------------------------------------+
236 The rte_malloc library is not fully implemented
237 -----------------------------------------------
239 +--------------------------------+--------------------------------------------------------------------------------------+
240 | Title | The rte_malloc library is not fully implemented |
242 +================================+======================================================================================+
245 +--------------------------------+--------------------------------------------------------------------------------------+
246 | Description | The rte_malloc library is not fully implemented. |
248 +--------------------------------+--------------------------------------------------------------------------------------+
249 | Implication | All debugging features of rte_malloc library described in architecture documentation |
250 | | are not yet implemented. |
252 +--------------------------------+--------------------------------------------------------------------------------------+
253 | Resolution | No workaround available. |
255 +--------------------------------+--------------------------------------------------------------------------------------+
256 | Affected Environment/ Platform | All |
258 +--------------------------------+--------------------------------------------------------------------------------------+
259 | Driver/Module | rte_malloc |
261 +--------------------------------+--------------------------------------------------------------------------------------+
266 +--------------------------------+--------------------------------------------------------------------------------------+
267 | Title | HPET reading is slow |
269 +================================+======================================================================================+
272 +--------------------------------+--------------------------------------------------------------------------------------+
273 | Description | Reading the HPET chip is slow. |
275 +--------------------------------+--------------------------------------------------------------------------------------+
276 | Implication | An application that calls “rte_get_hpet_cycles()” or “rte_timer_manage()” runs |
279 +--------------------------------+--------------------------------------------------------------------------------------+
280 | Resolution | The application should not call these functions too often in the main loop. |
281 | | An alternative is to use the TSC register through “rte_rdtsc()” which is faster, |
282 | | but specific to an lcore and is a cycle reference, not a time reference. |
284 +--------------------------------+--------------------------------------------------------------------------------------+
285 | Affected Environment/ Platform | All |
287 +--------------------------------+--------------------------------------------------------------------------------------+
288 | Driver/Module | Environment Abstraction Layer (EAL) |
290 +--------------------------------+--------------------------------------------------------------------------------------+
292 HPET timers do not work on the Osage customer reference platform
293 ----------------------------------------------------------------
295 +--------------------------------+--------------------------------------------------------------------------------------+
296 | Title | HPET timers do not work on the Osage customer reference platform |
298 +================================+======================================================================================+
301 +--------------------------------+--------------------------------------------------------------------------------------+
302 | Description | HPET timers do not work on the Osage customer reference platform |
303 | | which includes an Intel® Xeon® processor 5500 series processor) using the |
304 | | released BIOS from Intel. |
306 +--------------------------------+--------------------------------------------------------------------------------------+
307 | Implication | On Osage boards, the implementation of the “rte_delay_us()” function must be changed |
308 | | to not use the HPET timer. |
310 +--------------------------------+--------------------------------------------------------------------------------------+
311 | Resolution | This can be addressed by building the system with the “CONFIG_RTE_LIBEAL_USE_HPET=n” |
312 | | configuration option or by using the --no-hpet EAL option. |
314 +--------------------------------+--------------------------------------------------------------------------------------+
315 | Affected Environment/ Platform | The Osage customer reference platform. |
317 | | Other vendor platforms with Intel® Xeon® processor 5500 series processors should |
318 | | work correctly, provided the BIOS supports HPET. |
320 +--------------------------------+--------------------------------------------------------------------------------------+
321 | Driver/Module | lib/librte_eal/common/include/rte_cycles.h |
323 +--------------------------------+--------------------------------------------------------------------------------------+
325 Not all variants of supported NIC types have been used in testing
326 -----------------------------------------------------------------
328 +--------------------------------+--------------------------------------------------------------------------------------+
329 | Title | Not all variants of supported NIC types have been used in testing |
331 +================================+======================================================================================+
334 +--------------------------------+--------------------------------------------------------------------------------------+
335 | Description | The supported network interface cards can come in a number of variants with |
336 | | different device ID's. Not all of these variants have been tested with the Intel® |
339 | | The NIC device identifiers used during testing: |
341 | | * Intel® 82576 Gigabit Ethernet Controller [8086:10c9] |
343 | | * Intel® 82576 Quad Copper Gigabit Ethernet Controller [8086:10e8] |
345 | | * Intel® 82580 Dual Copper Gigabit Ethernet Controller [8086:150e] |
347 | | * Intel® I350 Quad Copper Gigabit Ethernet Controller [8086:1521] |
349 | | * Intel® 82599 Dual Fibre 10 Gigabit Ethernet Controller [8086:10fb] |
351 | | * Intel® Ethernet Server Adapter X520-T2 [8086: 151c] |
353 | | * Intel® Ethernet Controller X540-T2 [8086:1528] |
355 | | * Intel® 82574L Gigabit Network Connection [8086:10d3] |
357 | | * Emulated Intel® 82540EM Gigabit Ethernet Controller [8086:100e] |
359 | | * Emulated Intel® 82545EM Gigabit Ethernet Controller [8086:100f] |
361 | | * Intel® Ethernet Server Adapter X520-4 [8086:154a] |
363 | | * Intel® Ethernet Controller I210 [8086:1533] |
365 +--------------------------------+--------------------------------------------------------------------------------------+
366 | Implication | Risk of issues with untested variants. |
368 +--------------------------------+--------------------------------------------------------------------------------------+
369 | Resolution | Use tested NIC variants. For those supported Ethernet controllers, additional device |
370 | | IDs may be added to the software if required. |
372 +--------------------------------+--------------------------------------------------------------------------------------+
373 | Affected Environment/ Platform | All |
375 +--------------------------------+--------------------------------------------------------------------------------------+
376 | Driver/Module | Poll-mode drivers |
378 +--------------------------------+--------------------------------------------------------------------------------------+
380 Multi-process sample app requires exact memory mapping
381 ------------------------------------------------------
383 +--------------------------------+--------------------------------------------------------------------------------------+
384 | Title | Multi-process sample app requires exact memory mapping |
386 +================================+======================================================================================+
389 +--------------------------------+--------------------------------------------------------------------------------------+
390 | Description | The multi-process example application assumes that |
391 | | it is possible to map the hugepage memory to the same virtual addresses in client |
392 | | and server applications. Occasionally, very rarely with 64-bit, this does not occur |
393 | | and a client application will fail on startup. The Linux |
394 | | “address-space layout randomization” security feature can sometimes cause this to |
397 +--------------------------------+--------------------------------------------------------------------------------------+
398 | Implication | A multi-process client application fails to initialize. |
400 +--------------------------------+--------------------------------------------------------------------------------------+
401 | Resolution | See the “Multi-process Limitations” section in the Intel® DPDK Programmer’s Guide |
402 | | for more information. |
404 +--------------------------------+--------------------------------------------------------------------------------------+
405 | Affected Environment/ Platform | All |
407 +--------------------------------+--------------------------------------------------------------------------------------+
408 | Driver/Module | Multi-process example application |
410 +--------------------------------+--------------------------------------------------------------------------------------+
412 Unstable system performance across application executions with 2MB pages
413 ------------------------------------------------------------------------
415 +--------------------------------+--------------------------------------------------------------------------------------+
416 | Title | Unstable system performance across application executions with 2MB pages |
418 +================================+======================================================================================+
419 | Reference # | IXA00372346 |
421 +--------------------------------+--------------------------------------------------------------------------------------+
422 | Description | The performance of an Intel® DPDK application may vary across executions of an |
423 | | application due to a varying number of TLB misses depending on the location of |
424 | | accessed structures in memory. |
425 | | This situation occurs on rare occasions. |
427 +--------------------------------+--------------------------------------------------------------------------------------+
428 | Implication | Occasionally, relatively poor performance of Intel® DPDK applications is encountered.|
430 +--------------------------------+--------------------------------------------------------------------------------------+
431 | Resolution/ Workaround | Using 1 GB pages results in lower usage of TLB entries, resolving this issue. |
433 +--------------------------------+--------------------------------------------------------------------------------------+
434 | Affected Environment/ Platform | Systems using 2 MB pages |
436 +--------------------------------+--------------------------------------------------------------------------------------+
437 | Driver/Module | All |
439 +--------------------------------+--------------------------------------------------------------------------------------+
441 Packets are not sent by the 1 GbE/10 GbE SR-IOV driver when the source MAC address is not the MAC address assigned to the VF NIC
442 --------------------------------------------------------------------------------------------------------------------------------
444 +--------------------------------+--------------------------------------------------------------------------------------+
445 | Title | Packets are not sent by the 1 GbE/10 GbE SR-IOV driver when the source MAC address |
446 | | is not the MAC address assigned to the VF NIC |
448 +================================+======================================================================================+
449 | Reference # | IXA00168379 |
451 +--------------------------------+--------------------------------------------------------------------------------------+
452 | Description | The 1 GbE/10 GbE SR-IOV driver can only send packets when the Ethernet header’s |
453 | | source MAC address is the same as that of the VF NIC. The reason for this is that |
454 | | the Linux “ixgbe” driver module in the host OS has its anti-spoofing feature enabled.|
456 +--------------------------------+--------------------------------------------------------------------------------------+
457 | Implication | Packets sent using the 1 GbE/10 GbE SR-IOV driver must have the source MAC address |
458 | | correctly set to that of the VF NIC. Packets with other source address values are |
459 | | dropped by the NIC if the application attempts to transmit them. |
461 +--------------------------------+--------------------------------------------------------------------------------------+
462 | Resolution/ Workaround | Configure the Ethernet source address in each packet to match that of the VF NIC. |
464 +--------------------------------+--------------------------------------------------------------------------------------+
465 | Affected Environment/ Platform | All |
467 +--------------------------------+--------------------------------------------------------------------------------------+
468 | Driver/Module | 1 GbE/10 GbE VF Poll Mode Driver (PMD) |
470 +--------------------------------+--------------------------------------------------------------------------------------+
472 SR-IOV drivers do not fully implement the rte_ethdev API
473 --------------------------------------------------------
475 +--------------------------------+--------------------------------------------------------------------------------------+
476 | Title | SR-IOV drivers do not fully implement the rte_ethdev API |
478 +================================+======================================================================================+
481 +--------------------------------+--------------------------------------------------------------------------------------+
482 | Description | The SR-IOV drivers only supports the following rte_ethdev API functions: |
484 | | * rte_eth_dev_configure() |
486 | | * rte_eth_tx_queue_setup() |
488 | | * rte_eth_rx_queue_setup() |
490 | | * rte_eth_dev_info_get() |
492 | | * rte_eth_dev_start() |
494 | | * rte_eth_tx_burst() |
496 | | * rte_eth_rx_burst() |
498 | | * rte_eth_dev_stop() |
500 | | * rte_eth_stats_get() |
502 | | * rte_eth_stats_reset() |
504 | | * rte_eth_link_get() |
506 | | * rte_eth_link_get_no_wait() |
508 +--------------------------------+--------------------------------------------------------------------------------------+
509 | Implication | Calling an unsupported function will result in an application error. |
511 +--------------------------------+--------------------------------------------------------------------------------------+
512 | Resolution/ Workaround | Do not use other rte_ethdev API functions in applications that use the SR-IOV |
515 +--------------------------------+--------------------------------------------------------------------------------------+
516 | Affected Environment/ Platform | All |
518 +--------------------------------+--------------------------------------------------------------------------------------+
519 | Driver/Module | VF Poll Mode Driver (PMD) |
521 +--------------------------------+--------------------------------------------------------------------------------------+
523 PMD does not work with --no-huge EAL command line parameter
524 -----------------------------------------------------------
526 +--------------------------------+--------------------------------------------------------------------------------------+
527 | Title | PMD does not work with --no-huge EAL command line parameter |
529 +================================+======================================================================================+
530 | Reference # | IXA00373461 |
532 +--------------------------------+--------------------------------------------------------------------------------------+
533 | Description | Currently, the Intel® DPDK does not store any information about memory allocated by |
534 | | malloc() (for example, NUMA node, physical address), hence PMD drivers do not work |
535 | | when the --no-huge command line parameter is supplied to EAL. |
537 +--------------------------------+--------------------------------------------------------------------------------------+
538 | Implication | Sending and receiving data with PMD will not work. |
540 +--------------------------------+--------------------------------------------------------------------------------------+
541 | Resolution/ Workaround | Use huge page memory or use VFIO to map devices. |
543 +--------------------------------+--------------------------------------------------------------------------------------+
544 | Affected Environment/ Platform | Systems running the Intel® DPDK on Linux |
546 +--------------------------------+--------------------------------------------------------------------------------------+
547 | Driver/Module | Poll Mode Driver (PMD) |
549 +--------------------------------+--------------------------------------------------------------------------------------+
551 Some hardware off-load functions are not supported by the VF Driver
552 -------------------------------------------------------------------
554 +--------------------------------+--------------------------------------------------------------------------------------+
555 | Title | Some hardware off-load functions are not supported by the VF Driver |
557 +================================+======================================================================================+
558 | Reference # | IXA00378813 |
560 +--------------------------------+--------------------------------------------------------------------------------------+
561 | Description | Currently, configuration of the following items is not supported by the VF driver: |
563 | | * IP/UDP/TCP checksum offload |
565 | | * Jumbo Frame Receipt |
569 +--------------------------------+--------------------------------------------------------------------------------------+
570 | Implication | Any configuration for these items in the VF register will be ignored. The behavior |
571 | | is dependant on the current PF setting. |
573 +--------------------------------+--------------------------------------------------------------------------------------+
574 | Resolution/ Workaround | For the PF (Physical Function) status on which the VF driver depends, there is an |
575 | | option item under PMD in the config file. For others, the VF will keep the same |
576 | | behavior as PF setting. |
578 +--------------------------------+--------------------------------------------------------------------------------------+
579 | Affected Environment/ Platform | All |
581 +--------------------------------+--------------------------------------------------------------------------------------+
582 | Driver/Module | VF (SR-IOV) Poll Mode Driver (PMD) |
584 +--------------------------------+--------------------------------------------------------------------------------------+
586 Kernel crash on IGB port unbinding
587 ----------------------------------
589 +--------------------------------+--------------------------------------------------------------------------------------+
590 | Title | Kernel crash on IGB port unbinding |
592 +================================+======================================================================================+
595 +--------------------------------+--------------------------------------------------------------------------------------+
596 | Description | Kernel crash may occur |
597 | | when unbinding 1G ports from the igb_uio driver, on 2.6.3x kernels such as shipped |
598 | | with Fedora 14. |
600 +--------------------------------+--------------------------------------------------------------------------------------+
601 | Implication | Kernel crash occurs. |
603 +--------------------------------+--------------------------------------------------------------------------------------+
604 | Resolution/ Workaround | Use newer kernels or do not unbind ports. |
606 +--------------------------------+--------------------------------------------------------------------------------------+
607 | Affected Environment/ Platform | 2.6.3x kernels such as shipped with Fedora 14 |
609 +--------------------------------+--------------------------------------------------------------------------------------+
610 | Driver/Module | IGB Poll Mode Driver (PMD) |
612 +--------------------------------+--------------------------------------------------------------------------------------+
614 Link status change not working with MSI interrupts
615 --------------------------------------------------
617 +--------------------------------+--------------------------------------------------------------------------------------+
618 | Title | Link status change not working with MSI interrupts |
620 +================================+======================================================================================+
621 | Reference # | IXA00378191 |
623 +--------------------------------+--------------------------------------------------------------------------------------+
624 | Description | MSI interrupts are not supported by the PMD. |
626 +--------------------------------+--------------------------------------------------------------------------------------+
627 | Implication | Link status change will only work with legacy or MSI-X interrupts. |
629 +--------------------------------+--------------------------------------------------------------------------------------+
630 | Resolution/ Workaround | The igb_uio driver can now be loaded with either legacy or MSI-X interrupt support. |
631 | | However, this configuration is not tested. |
633 +--------------------------------+--------------------------------------------------------------------------------------+
634 | Affected Environment/ Platform | All |
636 +--------------------------------+--------------------------------------------------------------------------------------+
637 | Driver/Module | Poll Mode Driver (PMD) |
639 +--------------------------------+--------------------------------------------------------------------------------------+
641 Twinpond and Ironpond NICs do not report link status correctly
642 --------------------------------------------------------------
644 +--------------------------------+--------------------------------------------------------------------------------------+
645 | Title | Twinpond and Ironpond NICs do not report link status correctly |
647 +================================+======================================================================================+
648 | Reference # | IXA00378800 |
650 +--------------------------------+--------------------------------------------------------------------------------------+
651 | Description | Twin Pond/Iron Pond NICs do not bring the physical link down when shutting down the |
654 +--------------------------------+--------------------------------------------------------------------------------------+
655 | Implication | The link is reported as up even after issuing "shutdown" command unless the cable is |
656 | | physically disconnected. |
658 +--------------------------------+--------------------------------------------------------------------------------------+
659 | Resolution/ Workaround | None. |
661 +--------------------------------+--------------------------------------------------------------------------------------+
662 | Affected Environment/ Platform | Twin Pond and Iron Pond NICs |
664 +--------------------------------+--------------------------------------------------------------------------------------+
665 | Driver/Module | Poll Mode Driver (PMD) |
667 +--------------------------------+--------------------------------------------------------------------------------------+
669 Discrepancies between statistics reported by different NICs
670 -----------------------------------------------------------
672 +--------------------------------+--------------------------------------------------------------------------------------+
673 | Title | Discrepancies between statistics reported by different NICs |
675 +================================+======================================================================================+
676 | Reference # | IXA00378113 |
678 +--------------------------------+--------------------------------------------------------------------------------------+
679 | Description | Gigabit Ethernet devices from Intel include CRC bytes when calculating packet |
680 | | reception statistics regardless of hardware CRC stripping state, while 10-Gigabit |
681 | | Ethernet devices from Intel do so only when hardware CRC stripping is disabled. |
683 +--------------------------------+--------------------------------------------------------------------------------------+
684 | Implication | There may be a discrepancy in how different NICs display packet reception |
687 +--------------------------------+--------------------------------------------------------------------------------------+
688 | Resolution/ Workaround | None |
690 +--------------------------------+--------------------------------------------------------------------------------------+
691 | Affected Environment/ Platform | All |
693 +--------------------------------+--------------------------------------------------------------------------------------+
694 | Driver/Module | Poll Mode Driver (PMD) |
696 +--------------------------------+--------------------------------------------------------------------------------------+
698 Error reported opening files on Intel® DPDK initialization
699 ----------------------------------------------------------
702 +--------------------------------+--------------------------------------------------------------------------------------+
703 | Title | Error reported opening files on Intel® DPDK initialization |
705 +================================+======================================================================================+
708 +--------------------------------+--------------------------------------------------------------------------------------+
709 | Description | On Intel® DPDK application startup, errors may be reported when opening files as |
710 | | part of the initialization process. This occurs if a large number, for example, 500 |
711 | | or more, or if hugepages are used, due to the per-process limit on the number of |
714 +--------------------------------+--------------------------------------------------------------------------------------+
715 | Implication | The Intel® DPDK application may fail to run. |
717 +--------------------------------+--------------------------------------------------------------------------------------+
718 | Resolution/ Workaround | If using 2 MB hugepages, consider switching to a fewer number of 1 GB pages. |
719 | | Alternatively, use the “ulimit” command to increase the number of files which can be |
720 | | opened by a process. |
722 +--------------------------------+--------------------------------------------------------------------------------------+
723 | Affected Environment/ Platform | All |
725 +--------------------------------+--------------------------------------------------------------------------------------+
726 | Driver/Module | Environment Abstraction Layer (EAL) |
728 +--------------------------------+--------------------------------------------------------------------------------------+
730 Intel® QuickAssist Technology sample application does not work on a 32-bit OS on Shumway
731 ----------------------------------------------------------------------------------------
733 +--------------------------------+--------------------------------------------------------------------------------------+
734 | Title | Intel® QuickAssist Technology sample applications does not work on a 32- bit OS on |
737 +================================+======================================================================================+
740 +--------------------------------+--------------------------------------------------------------------------------------+
741 | Description | The Intel® Communications Chipset 89xx Series device does not fully support NUMA on |
742 | | a 32-bit OS. Consequently, the sample application cannot work properly on Shumway, |
743 | | since it requires NUMA on both nodes. |
745 +--------------------------------+--------------------------------------------------------------------------------------+
746 | Implication | The sample application cannot work in 32-bit mode with emulated NUMA, on |
747 | | multi-socket boards. |
749 +--------------------------------+--------------------------------------------------------------------------------------+
750 | Resolution/ Workaround | There is no workaround available. |
752 +--------------------------------+--------------------------------------------------------------------------------------+
753 | Affected Environment/ Platform | Shumway |
755 +--------------------------------+--------------------------------------------------------------------------------------+
756 | Driver/Module | All |
758 +--------------------------------+--------------------------------------------------------------------------------------+
760 IEEE1588 support possibly not working with an Intel® Ethernet Controller I210 NIC
761 ---------------------------------------------------------------------------------
763 +--------------------------------+--------------------------------------------------------------------------------------+
764 | Title | IEEE1588 support may not work with an Intel® Ethernet Controller I210 NIC |
766 +================================+======================================================================================+
767 | Reference # | IXA00380285 |
769 +--------------------------------+--------------------------------------------------------------------------------------+
770 | Description | IEEE1588 support is not working with an Intel® Ethernet Controller I210 NIC. |
772 +--------------------------------+--------------------------------------------------------------------------------------+
773 | Implication | IEEE1588 packets are not forwarded correctly by the Intel® Ethernet Controller I210 |
776 +--------------------------------+--------------------------------------------------------------------------------------+
777 | Resolution/ Workaround | There is no workaround available. |
779 +--------------------------------+--------------------------------------------------------------------------------------+
780 | Affected Environment/ Platform | All |
782 +--------------------------------+--------------------------------------------------------------------------------------+
783 | Driver/Module | IGB Poll Mode Driver |
785 +--------------------------------+--------------------------------------------------------------------------------------+
787 Differences in how different Intel NICs handle maximum packet length for jumbo frame
788 ------------------------------------------------------------------------------------
790 +--------------------------------+--------------------------------------------------------------------------------------+
791 | Title | Differences in how different Intel NICs handle maximum packet length for jumbo frame |
793 +================================+======================================================================================+
796 +--------------------------------+--------------------------------------------------------------------------------------+
797 | Description | 10 Gigabit Ethernet devices from Intel do not take VLAN tags into account when |
798 | | calculating packet size while Gigabit Ethernet devices do so for jumbo frames. |
800 +--------------------------------+--------------------------------------------------------------------------------------+
801 | Implication | When receiving packets with VLAN tags, the actual maximum size of useful payload |
802 | | that Intel Gigabit Ethernet devices are able to receive is 4 bytes (or 8 bytes in |
803 | | the case of packets with extended VLAN tags) less than that of Intel 10 Gigabit |
804 | | Ethernet devices. |
806 +--------------------------------+--------------------------------------------------------------------------------------+
807 | Resolution/ Workaround | Increase the configured maximum packet size when using Intel Gigabit Ethernet |
810 +--------------------------------+--------------------------------------------------------------------------------------+
811 | Affected Environment/ Platform | All |
813 +--------------------------------+--------------------------------------------------------------------------------------+
814 | Driver/Module | Poll Mode Driver (PMD) |
816 +--------------------------------+--------------------------------------------------------------------------------------+
818 Link status interrupt not working in VF drivers
819 -----------------------------------------------
821 +--------------------------------+--------------------------------------------------------------------------------------+
822 | Title | Link status interrupts not working in the VF drivers |
824 +================================+======================================================================================+
825 | Reference | IXA00381312 |
828 +--------------------------------+--------------------------------------------------------------------------------------+
829 | Description | Due to the driver not setting up interrupts for VF drivers, the NIC does not report |
830 | | link status change to VF devices. |
832 +--------------------------------+--------------------------------------------------------------------------------------+
833 | Implication | Link status interrupts will not work in VM guests. |
835 +--------------------------------+--------------------------------------------------------------------------------------+
836 | Resolution/ Workaround | There is no workaround available. |
838 +--------------------------------+--------------------------------------------------------------------------------------+
839 | Affected Environment/ Platform | All |
841 +--------------------------------+--------------------------------------------------------------------------------------+
842 | Driver/Module | VF (SR-IOV) Poll Mode Driver (PMD) |
844 +--------------------------------+--------------------------------------------------------------------------------------+
846 Binding PCI devices to igb_uio fails on Linux* kernel 3.9 when more than one device is used
847 -------------------------------------------------------------------------------------------
849 +--------------------------------+--------------------------------------------------------------------------------------+
850 | Title | Binding PCI devices to igb_uio fails on Linux* kernel 3.9 when more than one device |
853 +================================+======================================================================================+
856 +--------------------------------+--------------------------------------------------------------------------------------+
857 | Description | A known bug in the uio driver included in Linux* kernel version 3.9 prevents more |
858 | | than one PCI device to be bound to the igb_uio driver. |
860 +--------------------------------+--------------------------------------------------------------------------------------+
861 | Implication | The Poll Mode Driver (PMD) will crash on initialization. |
863 +--------------------------------+--------------------------------------------------------------------------------------+
864 | Resolution/ Workaround | Use earlier or later kernel versions, or apply the following |
866 | | <https://github.com/torvalds/linux/commit/5ed0505c713805f89473cdc0bbfb5110dfd840cb>`_|
869 +--------------------------------+--------------------------------------------------------------------------------------+
870 | Affected Environment/ Platform | Linux* systems with kernel version 3.9 |
872 +--------------------------------+--------------------------------------------------------------------------------------+
873 | Driver/Module | igb_uio module |
875 +--------------------------------+--------------------------------------------------------------------------------------+
877 GCC might generate Intel® AVX instructions forprocessors without Intel® AVX support
878 -----------------------------------------------------------------------------------
880 +--------------------------------+--------------------------------------------------------------------------------------+
881 | Title | Gcc might generate Intel® AVX instructions for processors without Intel® AVX support |
883 +================================+======================================================================================+
884 | Reference # | IXA00382439 |
886 +--------------------------------+--------------------------------------------------------------------------------------+
887 | Description | When compiling Intel® DPDK (and any Intel® DPDK app), gcc may generate Intel® AVX |
888 | | instructions, even when the processor does not support Intel® AVX. |
890 +--------------------------------+--------------------------------------------------------------------------------------+
891 | Implication | Any Intel® DPDK app might crash while starting up. |
893 +--------------------------------+--------------------------------------------------------------------------------------+
894 | Resolution/ Workaround | Either compile using icc or set EXTRA_CFLAGS=’-O3’ prior to compilation. |
896 +--------------------------------+--------------------------------------------------------------------------------------+
897 | Affected Environment/ Platform | Platforms which processor does not support Intel® AVX. |
899 +--------------------------------+--------------------------------------------------------------------------------------+
900 | Driver/Module | Environment Abstraction Layer (EAL) |
902 +--------------------------------+--------------------------------------------------------------------------------------+
904 Ethertype filter could receive other packets (non-assigned) in Niantic
905 ----------------------------------------------------------------------
907 +--------------------------------+--------------------------------------------------------------------------------------+
908 | Title | Ethertype filter could receive other packets (non-assigned) in Niantic |
910 +================================+======================================================================================+
911 | Reference # | IXA00169017 |
913 +--------------------------------+--------------------------------------------------------------------------------------+
914 | Description | On Intel® Ethernet Controller 82599EB: |
916 | | When Ethertype filter (priority enable) was set, unmatched packets also could be |
917 | | received on the assigned queue, such as ARP packets without 802.1q tags or with the |
918 | | user priority not equal to set value. |
920 | | Launch the testpmd by disabling RSS and with multiply queues, then add the ethertype |
921 | | filter like: “add_ethertype_filter 0 ethertype 0x0806 priority enable 3 queue 2 |
922 | | index 1”, and then start forwarding. |
924 | | When sending ARP packets without 802.1q tag and with user priority as non-3 by |
925 | | tester, all the ARP packets can be received on the assigned queue. |
927 +--------------------------------+--------------------------------------------------------------------------------------+
928 | Implication | The user priority comparing in Ethertype filter cannot work probably. |
929 | | It is the NIC's issue due to the response from PAE: “In fact, ETQF.UP is not |
930 | | functional, and the information will be added in errata of 82599 and X540.” |
932 +--------------------------------+--------------------------------------------------------------------------------------+
933 | Resolution/ Workaround | None |
935 +--------------------------------+--------------------------------------------------------------------------------------+
936 | Affected Environment/ Platform | All |
938 +--------------------------------+--------------------------------------------------------------------------------------+
939 | Driver/Module | Poll Mode Driver (PMD) |
941 +--------------------------------+--------------------------------------------------------------------------------------+
943 Double VLAN does not work on Intel® 40G ethernet controller
944 -----------------------------------------------------------
946 +--------------------------------+--------------------------------------------------------------------------------------+
947 | Title | Double VLAN does not work on Intel® 40G ethernet controller |
949 +================================+======================================================================================+
950 | Reference # | IXA00386480 |
952 +--------------------------------+--------------------------------------------------------------------------------------+
953 | Description | On Intel® 40G Ethernet Controller: |
955 | | Double VLAN does not work. This was confirmed a firmware issue which will be fixed |
956 | | in later versions of firmware. |
958 +--------------------------------+--------------------------------------------------------------------------------------+
959 | Implication | After setting double vlan to be enabled on a port, no packets can be transmitted out |
962 +--------------------------------+--------------------------------------------------------------------------------------+
963 | Resolution/ Workaround | None |
965 +--------------------------------+--------------------------------------------------------------------------------------+
966 | Affected Environment/ Platform | All |
968 +--------------------------------+--------------------------------------------------------------------------------------+
969 | Driver/Module | Poll Mode Driver (PMD) |
971 +--------------------------------+--------------------------------------------------------------------------------------+
973 Cannot set link speed on Intel® 40G ethernet controller
974 -------------------------------------------------------
976 +--------------------------------+--------------------------------------------------------------------------------------+
977 | Title | Cannot set link speed on Intel® 40G ethernet controller |
979 +================================+======================================================================================+
980 | Reference # | IXA00386379 |
982 +--------------------------------+--------------------------------------------------------------------------------------+
983 | Description | On Intel® 40G Ethernet Controller: |
985 | | It cannot set the link to specific speed. |
987 +--------------------------------+--------------------------------------------------------------------------------------+
988 | Implication | The link speed cannot be changed forcedly, though it can be configured by |
991 +--------------------------------+--------------------------------------------------------------------------------------+
992 | Resolution/ Workaround | None |
994 +--------------------------------+--------------------------------------------------------------------------------------+
995 | Affected Environment/ Platform | All |
997 +--------------------------------+--------------------------------------------------------------------------------------+
998 | Driver/Module | Poll Mode Driver (PMD) |
1000 +--------------------------------+--------------------------------------------------------------------------------------+
1002 Stopping the port does not down the link on Intel® 40G ethernet controller
1003 --------------------------------------------------------------------------
1005 +--------------------------------+--------------------------------------------------------------------------------------+
1006 | Title | Stopping the port does not down the link on Intel® 40G ethernet controller |
1008 +================================+======================================================================================+
1009 | Reference # | IXA00386380 |
1011 +--------------------------------+--------------------------------------------------------------------------------------+
1012 | Description | On Intel® 40G Ethernet Controller: |
1014 | | Stopping the port does not really down the port link. |
1016 +--------------------------------+--------------------------------------------------------------------------------------+
1017 | Implication | The port link will be still up after stopping the port. |
1019 +--------------------------------+--------------------------------------------------------------------------------------+
1020 | Resolution/ Workaround | None |
1022 +--------------------------------+--------------------------------------------------------------------------------------+
1023 | Affected Environment/ Platform | All |
1025 +--------------------------------+--------------------------------------------------------------------------------------+
1026 | Driver/Module | Poll Mode Driver (PMD) |
1028 +--------------------------------+--------------------------------------------------------------------------------------+
git.droids-corp.org / dpdk.git / blob