doc: consolidate VFIO content on Linux drivers page
[dpdk.git] / doc / guides / rel_notes / release_18_11.rst
1 ..  SPDX-License-Identifier: BSD-3-Clause
2     Copyright 2018 The DPDK contributors
3
4 DPDK Release 18.11
5 ==================
6
7 New Features
8 ------------
9
10 * **Added support for using externally allocated memory in DPDK.**
11
12   DPDK has added support for creating new ``rte_malloc`` heaps referencing
13   memory that was created outside of DPDK's own page allocator, and using that
14   memory natively with any other DPDK library or data structure.
15
16 * **Added check for ensuring allocated memory is addressable by devices.**
17
18   Some devices can have addressing limitations so a new function,
19   ``rte_mem_check_dma_mask()``, has been added for checking that allocated
20   memory is not out of the device range. Since memory can now be allocated
21   dynamically after initialization, a DMA mask is stored and any new allocated
22   memory will be checked against it and rejected if it is out of range. If
23   more than one device has addressing limitations, the DMA mask is the more
24   restrictive one.
25
26 * **Updated the C11 memory model version of the ring library.**
27
28   Added changes to decrease latency for architectures using the C11 memory
29   model version of the ring library.
30
31   On Cavium ThunderX2 platform, the changes decreased latency by 27-29%
32   and 3-15% for MPMC and SPSC cases respectively (with 2 lcores). The
33   real improvements may vary with the number of contending lcores and
34   the size of the ring.
35
36 * **Added hot-unplug handle mechanism.**
37
38   Added ``rte_dev_hotplug_handle_enable()`` and
39   ``rte_dev_hotplug_handle_disable()`` for enabling or disabling the hotplug
40   handle mechanism.
41
42 * **Added support for device multi-process hotplug.**
43
44   Added support for hotplug and hot-unplug in a multiprocessing scenario. Any
45   ethdev devices created in the primary process will be regarded as shared and
46   will be available for all DPDK processes. Synchronization between processes
47   will be done using DPDK IPC.
48
49 * **Added new Flow API actions to rewrite fields in packet headers.**
50
51   Added new Flow API actions to:
52
53   * Modify source and destination IP addresses in the outermost IPv4/IPv6
54     headers.
55   * Modify source and destination port numbers in the outermost TCP/UDP
56     headers.
57
58 * **Added new Flow API action to swap MAC addresses in Ethernet header.**
59
60   Added new Flow API action to swap the source and destination MAC
61   addresses in the outermost Ethernet header.
62
63 * **Add support to offload more flow match and actions for CXGBE PMD.**
64
65   The Flow API support has been enhanced for the CXGBE Poll Mode Driver to
66   offload:
67
68   * Match items: destination MAC address.
69   * Action items: push/pop/rewrite vlan header,
70     rewrite IP addresses in outermost IPv4/IPv6 header,
71     rewrite port numbers in outermost TCP/UDP header,
72     swap MAC addresses in outermost Ethernet header.
73
74 * **Added a devarg to use the latest supported vector path in i40e.**
75
76   A new devarg ``use-latest-supported-vec`` was introduced to allow users to
77   choose the latest vector path that the platform supported. For example, users
78   can use AVX2 vector path on BDW/HSW to get better performance.
79
80 * **Added support for SR-IOV in netvsc PMD.**
81
82   The ``netvsc`` poll mode driver now supports the Accelerated Networking
83   SR-IOV option in Hyper-V and Azure. This is an alternative to the previous
84   vdev_netvsc, tap, and failsafe drivers combination.
85
86 * **Added a new net driver for Marvell Armada 3k device.**
87
88   Added the new ``mvneta`` net driver for Marvell Armada 3k device. See the
89   :doc:`../nics/mvneta` NIC guide for more details on this new driver.
90
91 * **Added NXP ENETC PMD.**
92
93   Added the new enetc driver for the NXP enetc platform. See the
94   :doc:`../nics/enetc` NIC driver guide for more details on this new driver.
95
96 * **Added Ethernet poll mode driver for Aquantia aQtion family of 10G devices.**
97
98   Added the new ``atlantic`` ethernet poll mode driver for Aquantia XGBE devices.
99   See the :doc:`../nics/atlantic` NIC driver guide for more details on this
100   driver.
101
102 * **Updated mlx5 driver.**
103
104   Updated the mlx5 driver including the following changes:
105
106   * Improved security of PMD to prevent the NIC from getting stuck when
107     the application misbehaves.
108   * Reworked flow engine to supported e-switch flow rules (transfer attribute).
109   * Added support for header re-write(L2-L4), VXLAN encap/decap, count, match
110     on TCP flags and multiple flow groups with e-switch flow rules.
111   * Added support for match on metadata, VXLAN and MPLS encap/decap with flow
112     rules.
113   * Added support for ``RTE_ETH_DEV_CLOSE_REMOVE`` flag to provide better
114     support for representors.
115   * Added support for meson build.
116   * Fixed build issue with PPC.
117   * Added support for BlueField VF.
118   * Added support for externally allocated static memory for DMA.
119
120 * **Updated Solarflare network PMD.**
121
122   Updated the sfc_efx driver including the following changes:
123
124   * Added support for Rx scatter in EF10 datapath implementation.
125   * Added support for Rx descriptor status API in EF10 datapath implementation.
126   * Added support for TSO in EF10 datapath implementation.
127   * Added support for Tx descriptor status API in EF10 (ef10 and ef10_simple)
128     datapaths implementation.
129
130 * **Updated the enic driver.**
131
132   * Added AVX2-based vectorized Rx handler.
133   * Added VLAN and checksum offloads to the simple Tx handler.
134   * Added the "count" flow action.
135   * Enabled the virtual address IOVA mode.
136
137 * **Updated the failsafe driver.**
138
139   Updated the failsafe driver including the following changes:
140
141   * Added support for Rx and Tx queues start and stop.
142   * Added support for Rx and Tx queues deferred start.
143   * Added support for runtime Rx and Tx queues setup.
144   * Added support multicast MAC address set.
145
146 * **Added a devarg to use a PCAP interface physical MAC address.**
147
148   A new devarg ``phy_mac`` was introduced to allow users to use the physical
149   MAC address of the selected PCAP interface.
150
151 * **Added TAP Rx/Tx queues sharing with a secondary process.**
152
153   Added support to allow a secondary process to attach a TAP device created
154   in the primary process, probe the queues, and process Rx/Tx in a secondary
155   process.
156
157 * **Added classification and metering support to SoftNIC PMD.**
158
159   Added support for flow classification (rte_flow API), and metering and
160   policing (rte_mtr API) to the SoftNIC PMD.
161
162 * **Added Crypto support to the Softnic PMD.**
163
164   The Softnic is now capable of processing symmetric crypto workloads such
165   as cipher, cipher-authentication chaining, and AEAD encryption and
166   decryption. This is achieved by calling DPDK Cryptodev APIs.
167
168 * **Added cryptodev port to port library.**
169
170   Cryptodev port is a shim layer in the port library that interacts with DPDK
171   Cryptodev PMDs including burst enqueuing and dequeuing crypto operations.
172
173 * **Added symmetric cryptographic actions to the pipeline library.**
174
175   In the pipeline library support was added for symmetric crypto action
176   parsing and an action handler was implemented. The action allows automatic
177   preparation of the crypto operation with the rules specified such as
178   algorithm, key, and IV, etc. for the cryptodev port to process.
179
180 * **Updated the AESNI MB PMD.**
181
182   The AESNI MB PMD has been updated with additional support for the AES-GCM
183   algorithm.
184
185 * **Added NXP CAAM JR PMD.**
186
187   Added the new caam job ring driver for NXP platforms. See the
188   :doc:`../cryptodevs/caam_jr` guide for more details on this new driver.
189
190 * **Added support for GEN3 devices to Intel QAT driver.**
191
192   Added support for the third generation of Intel QuickAssist devices.
193
194 * **Updated the QAT PMD.**
195
196   The QAT PMD was updated with additional support for:
197
198   * The AES-CMAC algorithm.
199
200 * **Added support for Dynamic Huffman Encoding to Intel QAT comp PMD.**
201
202   The Intel QuickAssist (QAT) compression PMD has been updated with support
203   for Dynamic Huffman Encoding for the Deflate algorithm.
204
205 * **Added Event Ethernet Tx Adapter.**
206
207   Added event ethernet Tx adapter library that provides configuration and
208   data path APIs for the ethernet transmit stage of an event driven packet
209   processing application. These APIs abstract the implementation of the
210   transmit stage and allow the application to use eventdev PMD support or
211   a common implementation.
212
213 * **Added Distributed Software Eventdev PMD.**
214
215   Added the new Distributed Software Event Device (DSW), which is a
216   pure-software eventdev driver distributing the work of scheduling
217   among all eventdev ports and the lcores using them. DSW, compared to
218   the SW eventdev PMD, sacrifices load balancing performance to
219   gain better event scheduling throughput and scalability.
220
221 * **Added extendable bucket feature to hash library (rte_hash).**
222
223   This new "extendable bucket" feature provides 100% insertion guarantee to
224   the capacity specified by the user by extending hash table with extra
225   buckets when needed to accommodate the unlikely event of intensive hash
226   collisions. In addition, the internal hashing algorithm was changed to use
227   partial-key hashing to improve memory efficiency and lookup performance.
228
229 * **Added lock free reader/writer concurrency to hash library (rte_hash).**
230
231   Lock free reader/writer concurrency prevents the readers from getting
232   blocked due to a preempted writer thread. This allows the hash library
233   to be used in scenarios where the writer thread runs on the control plane.
234
235 * **Added Traffic Pattern Aware Power Control Library.**
236
237   Added an experimental library that extends the Power Library and provides
238   empty_poll APIs. This feature measures how many times empty_polls are
239   executed per core and uses the number of empty polls as a hint for system
240   power management.
241
242   See the :doc:`../prog_guide/power_man` section of the DPDK Programmers
243   Guide document for more information.
244
245 * **Added JSON power policy interface for containers.**
246
247   Extended the Power Library and vm_power_manager sample app to allow power
248   policies to be submitted via a FIFO using JSON formatted strings. Previously
249   limited to Virtual Machines, this feature extends power policy functionality
250   to containers and host applications that need to have their cores frequency
251   controlled based on the rules contained in the policy.
252
253 * **Added Telemetry API.**
254
255   Added a new telemetry API which allows applications to transparently expose
256   their telemetry in JSON via a UNIX socket. The JSON can be consumed by any
257   Service Assurance agent, such as CollectD.
258
259 * **Updated KNI kernel module, rte_kni library, and KNI sample application.**
260
261   Updated the KNI kernel module with a new kernel module parameter,
262   ``carrier=[on|off]`` to allow the user to control the default carrier
263   state of the KNI kernel network interfaces. The default carrier state
264   is now set to ``off``, so the interfaces cannot be used until the
265   carrier state is set to ``on`` via ``rte_kni_update_link`` or
266   by writing ``1`` to ``/sys/devices/virtual/net/<iface>/carrier``.
267   In previous versions the default carrier state was left undefined.
268   See :doc:`../prog_guide/kernel_nic_interface` for more information.
269
270   Also added the new API function ``rte_kni_update_link()`` to allow the user
271   to set the carrier state of the KNI kernel network interface.
272
273   Also added a new command line flag ``-m`` to the KNI sample application to
274   monitor and automatically reflect the physical NIC carrier state to the
275   KNI kernel network interface with the new ``rte_kni_update_link()`` API.
276   See :doc:`../sample_app_ug/kernel_nic_interface` for more information.
277
278 * **Added ability to switch queue deferred start flag on testpmd app.**
279
280   Added a console command to testpmd app, giving ability to switch
281   ``rx_deferred_start`` or ``tx_deferred_start`` flag of the specified queue of
282   the specified port. The port must be stopped before the command call in order
283   to reconfigure queues.
284
285 * **Add a new sample application for vDPA.**
286
287   The vdpa sample application creates vhost-user sockets by using the
288   vDPA backend. vDPA stands for vhost Data Path Acceleration which utilizes
289   virtio ring compatible devices to serve virtio driver directly to enable
290   datapath acceleration. As vDPA driver can help to set up vhost datapath,
291   this application doesn't need to launch dedicated worker threads for vhost
292   enqueue/dequeue operations.
293
294 * **Added cryptodev FIPS validation example application.**
295
296   Added an example application to parse and perform symmetric cryptography
297   computation to the NIST Cryptographic Algorithm Validation Program (CAVP)
298   test vectors.
299
300 * **Allow unit test binary to take parameters from the environment.**
301
302   The unit test "test", or "dpdk-test", binary is often called from scripts,
303   which can make passing additional parameters, such as a coremask,
304   difficult. Support has been added to the application to allow it to take
305   additional command-line parameter values from the ``DPDK_TEST_PARAMS``
306   environment variable to make this application easier to use.
307
308
309 API Changes
310 -----------
311
312 * eal: ``rte_memseg_list`` structure now has an additional flag indicating
313   whether the memseg list is externally allocated. This will have implications
314   for any users of memseg-walk-related functions, as they will now have to skip
315   externally allocated segments in most cases if the intent is to only iterate
316   over internal DPDK memory.
317
318   In addition the ``socket_id`` parameter across the entire DPDK has gained
319   additional meaning, as some socket ID's will now be representing externally
320   allocated memory. No changes will be required for existing code as backwards
321   compatibility will be kept, and those who do not use this feature will not
322   see these extra socket ID's. Any new API's must not check socket ID
323   parameters themselves, and must instead leave it to the memory subsystem to
324   decide whether socket ID is a valid one.
325
326 * eal: The following devargs functions, which were deprecated in 18.05,
327   were removed in 18.11:
328   ``rte_eal_parse_devargs_str()``, ``rte_eal_devargs_add()``,
329   ``rte_eal_devargs_type_count()``, and ``rte_eal_devargs_dump()``.
330
331 * eal: The parameters of the function ``rte_devargs_remove()`` have changed
332   from bus and device names to ``struct rte_devargs``.
333
334 * eal: The deprecated functions attach/detach were removed in 18.11.
335   ``rte_eal_dev_attach`` can be replaced by
336   ``rte_dev_probe`` or ``rte_eal_hotplug_add``.
337   ``rte_eal_dev_detach`` can be replaced by
338   ``rte_dev_remove`` or ``rte_eal_hotplug_remove``.
339
340 * eal: The scope of ``rte_eal_hotplug_add()``/``rte_dev_probe()``
341   and ``rte_eal_hotplug_remove()``/``rte_dev_remove()`` has been extended.
342   In the multi-process model, they will guarantee that the device is
343   attached or detached on all processes.
344
345 * mbuf: The ``__rte_mbuf_raw_free()`` and ``__rte_pktmbuf_prefree_seg()``
346   functions were deprecated since 17.05 and are replaced by
347   ``rte_mbuf_raw_free()`` and ``rte_pktmbuf_prefree_seg()``.
348
349 * ethdev: The deprecated functions attach/detach were removed in 18.11.
350   ``rte_eth_dev_attach()`` can be replaced by ``RTE_ETH_FOREACH_MATCHING_DEV``
351   and ``rte_dev_probe()`` or ``rte_eal_hotplug_add()``.
352   ``rte_eth_dev_detach()`` can be replaced by
353   ``rte_dev_remove()`` or ``rte_eal_hotplug_remove()``.
354
355 * ethdev: A call to ``rte_eth_dev_release_port()`` has been added in
356   ``rte_eth_dev_close()``. As a consequence, a closed port is freed
357   and seen as invalid because of its state ``RTE_ETH_DEV_UNUSED``.
358   This new behavior is enabled per driver for a migration period.
359
360 * A new device flag, ``RTE_ETH_DEV_NOLIVE_MAC_ADDR``, changes the order of
361   actions inside ``rte_eth_dev_start()`` regarding MAC set. Some NICs do not
362   support MAC changes once the port has started and with this new device
363   flag the MAC can be properly configured in any case. This is particularly
364   important for bonding.
365
366 * The default behavior of CRC strip offload has changed in this
367   release. Without any specific Rx offload flag, default behavior by a PMD is
368   now to strip CRC. ``DEV_RX_OFFLOAD_CRC_STRIP`` offload flag has been removed.
369   To request keeping CRC, application should set ``DEV_RX_OFFLOAD_KEEP_CRC``
370   Rx offload.
371
372 * eventdev: The type of the second parameter to
373   ``rte_event_eth_rx_adapter_caps_get()`` has been changed from uint8_t to
374   uint16_t.
375
376 * kni: By default, interface carrier status is ``off`` which means there won't
377   be any traffic. It can be set to ``on`` via ``rte_kni_update_link()`` API or
378   via ``sysfs`` interface: ``echo 1 > /sys/class/net/vEth0/carrier``.
379
380   Note interface should be ``up`` to be able to read/write sysfs interface.
381   When KNI sample application is used, ``-m`` parameter can be used to
382   automatically update the carrier status for the interface.
383
384 * kni: When ethtool support is enabled (``CONFIG_RTE_KNI_KMOD_ETHTOOL=y``)
385   ethtool commands ``ETHTOOL_GSET & ETHTOOL_SSET`` are no longer supported for
386   kernels that have ``ETHTOOL_GLINKSETTINGS & ETHTOOL_SLINKSETTINGS`` support.
387   This means ``ethtool "-a|--show-pause", "-s|--change"`` won't work, and
388   ``ethtool <iface>`` output will have less information.
389
390
391 ABI Changes
392 -----------
393
394 * eal: added ``legacy_mem`` and ``single_file_segments`` values to
395   ``rte_config`` structure on account of improving DPDK usability when
396   using either ``--legacy-mem`` or ``--single-file-segments`` flags.
397
398 * eal: EAL library ABI version was changed due to previously announced work on
399   supporting external memory in DPDK:
400
401   - Structure ``rte_memseg_list`` now has a new field indicating length
402     of memory addressed by the segment list
403   - Structure ``rte_memseg_list`` now has a new flag indicating whether
404     the memseg list refers to external memory
405   - Structure ``rte_malloc_heap`` now has a new field indicating socket
406     ID the malloc heap belongs to
407   - Structure ``rte_mem_config`` has had its ``malloc_heaps`` array
408     resized from ``RTE_MAX_NUMA_NODES`` to ``RTE_MAX_HEAPS`` value
409   - Structure ``rte_malloc_heap`` now has a ``heap_name`` member
410   - Structure ``rte_eal_memconfig`` has been extended to contain next
411     socket ID for externally allocated segments
412
413 * eal: Added ``dma_maskbits`` to ``rte_mem_config`` for keeping the most
414   restrictive DMA mask based on the devices addressing limitations.
415
416 * eal: The structure ``rte_device`` has a new field to reference a
417   ``rte_bus``.  It thus changes the size of the ``struct rte_device`` and the
418   inherited device structures of all buses.
419
420
421 Shared Library Versions
422 -----------------------
423
424 The libraries prepended with a plus sign were incremented in this version.
425
426 .. code-block:: diff
427
428      librte_acl.so.2
429      librte_bbdev.so.1
430      librte_bitratestats.so.2
431      librte_bpf.so.1
432    + librte_bus_dpaa.so.2
433    + librte_bus_fslmc.so.2
434    + librte_bus_ifpga.so.2
435    + librte_bus_pci.so.2
436    + librte_bus_vdev.so.2
437    + librte_bus_vmbus.so.2
438      librte_cfgfile.so.2
439      librte_cmdline.so.2
440      librte_compressdev.so.1
441      librte_cryptodev.so.5
442      librte_distributor.so.1
443    + librte_eal.so.9
444      librte_efd.so.1
445    + librte_ethdev.so.11
446    + librte_eventdev.so.6
447      librte_flow_classify.so.1
448      librte_gro.so.1
449      librte_gso.so.1
450      librte_hash.so.2
451      librte_ip_frag.so.1
452      librte_jobstats.so.1
453      librte_kni.so.2
454      librte_kvargs.so.1
455      librte_latencystats.so.1
456      librte_lpm.so.2
457      librte_mbuf.so.4
458      librte_member.so.1
459      librte_mempool.so.5
460      librte_meter.so.2
461      librte_metrics.so.1
462      librte_net.so.1
463      librte_pci.so.1
464      librte_pdump.so.2
465      librte_pipeline.so.3
466      librte_pmd_bnxt.so.2
467      librte_pmd_bond.so.2
468      librte_pmd_i40e.so.2
469      librte_pmd_ixgbe.so.2
470      librte_pmd_dpaa2_qdma.so.1
471      librte_pmd_ring.so.2
472      librte_pmd_softnic.so.1
473      librte_pmd_vhost.so.2
474      librte_port.so.3
475      librte_power.so.1
476      librte_rawdev.so.1
477      librte_reorder.so.1
478      librte_ring.so.2
479      librte_sched.so.1
480      librte_security.so.1
481      librte_table.so.3
482      librte_timer.so.1
483      librte_vhost.so.4
484
485
486 Known Issues
487 ------------
488
489 * When using SR-IOV (VF) support with netvsc PMD and the Mellanox mlx5
490   bifurcated driver the Linux netvsc device must be brought up before the
491   netvsc device is unbound and passed to the DPDK.
492
493 * IBM Power8 is not supported in this release of DPDK. IBM Power9 is
494   supported.
495
496 * ``AVX-512`` support has been disabled for ``GCC`` builds [1] because of a
497   crash [2]. This can affect ``native`` machine type build targets on the
498   platforms that support ``AVX512F`` like ``Intel Skylake`` processors, and
499   can cause a possible performance drop. The immediate workaround is to use
500   ``clang`` compiler on these platforms. The issue has been identified as a
501   GCC defect and reported to the GCC community [3]. Further actions will be
502   taken based on the GCC defect result.
503
504   - [1]: Commit 8d07c82b239f ("mk: disable gcc AVX512F support")
505   - [2]: https://bugs.dpdk.org/show_bug.cgi?id=97
506   - [3]: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=88096
507
508
509 Tested Platforms
510 ----------------
511
512 * Intel(R) platforms with Intel(R) NICs combinations
513
514    * CPU
515
516      * Intel(R) Atom(TM) CPU C3758 @ 2.20GHz
517      * Intel(R) Xeon(R) CPU D-1541 @ 2.10GHz
518      * Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz
519      * Intel(R) Xeon(R) CPU E5-2699 v3 @ 2.30GHz
520      * Intel(R) Xeon(R) CPU E5-2699 v4 @ 2.20GHz
521      * Intel(R) Xeon(R) Platinum 8180 CPU @ 2.50GHz
522
523    * OS:
524
525      * CentOS 7.5
526      * Fedora 25
527      * Fedora 28
528      * FreeBSD 11.2
529      * Red Hat Enterprise Linux Server release 7.5
530      * Open SUSE 15
531      * Wind River Linux 8
532      * Ubuntu 14.04
533      * Ubuntu 16.04
534      * Ubuntu 16.10
535      * Ubuntu 17.10
536      * Ubuntu 18.04
537
538    * NICs:
539
540      * Intel(R) 82599ES 10 Gigabit Ethernet Controller
541
542        * Firmware version: 0x61bf0001
543        * Device id (pf/vf): 8086:10fb / 8086:10ed
544        * Driver version: 5.2.3 (ixgbe)
545
546      * Intel(R) Corporation Ethernet Connection X552/X557-AT 10GBASE-T
547
548        * Firmware version: 0x800003e7
549        * Device id (pf/vf): 8086:15ad / 8086:15a8
550        * Driver version: 4.4.6 (ixgbe)
551
552      * Intel(R) Ethernet Converged Network Adapter X710-DA4 (4x10G)
553
554        * Firmware version: 6.01 0x80003221
555        * Device id (pf/vf): 8086:1572 / 8086:154c
556        * Driver version: 2.4.6 (i40e)
557
558      * Intel(R) Corporation Ethernet Connection X722 for 10GbE SFP+ (4x10G)
559
560        * Firmware version: 3.33 0x80000fd5 0.0.0
561        * Device id (pf/vf): 8086:37d0 / 8086:37cd
562        * Driver version: 2.4.6 (i40e)
563
564      * Intel(R) Ethernet Converged Network Adapter XXV710-DA2 (2x25G)
565
566        * Firmware version: 6.01 0x80003221
567        * Device id (pf/vf): 8086:158b / 8086:154c
568        * Driver version: 2.4.6 (i40e)
569
570      * Intel(R) Ethernet Converged Network Adapter XL710-QDA2 (2X40G)
571
572        * Firmware version: 6.01 0x8000321c
573        * Device id (pf/vf): 8086:1583 / 8086:154c
574        * Driver version: 2.4.6 (i40e)
575
576      * Intel(R) Corporation I350 Gigabit Network Connection
577
578        * Firmware version: 1.63, 0x80000dda
579        * Device id (pf/vf): 8086:1521 / 8086:1520
580        * Driver version: 5.4.0-k (igb)
581
582 * Intel(R) platforms with Mellanox(R) NICs combinations
583
584    * CPU:
585
586      * Intel(R) Xeon(R) Gold 6154 CPU @ 3.00GHz
587      * Intel(R) Xeon(R) CPU E5-2697A v4 @ 2.60GHz
588      * Intel(R) Xeon(R) CPU E5-2697 v3 @ 2.60GHz
589      * Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz
590      * Intel(R) Xeon(R) CPU E5-2650 v4 @ 2.20GHz
591      * Intel(R) Xeon(R) CPU E5-2640 @ 2.50GHz
592      * Intel(R) Xeon(R) CPU E5-2620 v4 @ 2.10GHz
593
594    * OS:
595
596      * Red Hat Enterprise Linux Server release 7.6 (Maipo)
597      * Red Hat Enterprise Linux Server release 7.5 (Maipo)
598      * Red Hat Enterprise Linux Server release 7.4 (Maipo)
599      * Red Hat Enterprise Linux Server release 7.3 (Maipo)
600      * Red Hat Enterprise Linux Server release 7.2 (Maipo)
601      * Ubuntu 18.10
602      * Ubuntu 18.04
603      * Ubuntu 17.10
604      * Ubuntu 16.04
605      * SUSE Linux Enterprise Server 15
606
607    * MLNX_OFED: 4.4-2.0.1.0
608    * MLNX_OFED: 4.5-0.3.1.0
609
610    * NICs:
611
612      * Mellanox(R) ConnectX(R)-3 Pro 40G MCX354A-FCC_Ax (2x40G)
613
614        * Host interface: PCI Express 3.0 x8
615        * Device ID: 15b3:1007
616        * Firmware version: 2.42.5000
617
618      * Mellanox(R) ConnectX(R)-4 10G MCX4111A-XCAT (1x10G)
619
620        * Host interface: PCI Express 3.0 x8
621        * Device ID: 15b3:1013
622        * Firmware version: 12.23.8022 and above
623
624      * Mellanox(R) ConnectX(R)-4 10G MCX4121A-XCAT (2x10G)
625
626        * Host interface: PCI Express 3.0 x8
627        * Device ID: 15b3:1013
628        * Firmware version: 12.23.8022 and above
629
630      * Mellanox(R) ConnectX(R)-4 25G MCX4111A-ACAT (1x25G)
631
632        * Host interface: PCI Express 3.0 x8
633        * Device ID: 15b3:1013
634        * Firmware version: 12.23.8022 and above
635
636      * Mellanox(R) ConnectX(R)-4 25G MCX4121A-ACAT (2x25G)
637
638        * Host interface: PCI Express 3.0 x8
639        * Device ID: 15b3:1013
640        * Firmware version: 12.23.8022 and above
641
642      * Mellanox(R) ConnectX(R)-4 40G MCX4131A-BCAT/MCX413A-BCAT (1x40G)
643
644        * Host interface: PCI Express 3.0 x8
645        * Device ID: 15b3:1013
646        * Firmware version: 12.23.8022 and above
647
648      * Mellanox(R) ConnectX(R)-4 40G MCX415A-BCAT (1x40G)
649
650        * Host interface: PCI Express 3.0 x16
651        * Device ID: 15b3:1013
652        * Firmware version: 12.23.8022 and above
653
654      * Mellanox(R) ConnectX(R)-4 50G MCX4131A-GCAT/MCX413A-GCAT (1x50G)
655
656        * Host interface: PCI Express 3.0 x8
657        * Device ID: 15b3:1013
658        * Firmware version: 12.23.8022 and above
659
660      * Mellanox(R) ConnectX(R)-4 50G MCX414A-BCAT (2x50G)
661
662        * Host interface: PCI Express 3.0 x8
663        * Device ID: 15b3:1013
664        * Firmware version: 12.23.8022 and above
665
666      * Mellanox(R) ConnectX(R)-4 50G MCX415A-GCAT/MCX416A-BCAT/MCX416A-GCAT (2x50G)
667
668        * Host interface: PCI Express 3.0 x16
669        * Device ID: 15b3:1013
670        * Firmware version: 12.23.8022 and above
671        * Firmware version: 12.23.8022 and above
672
673      * Mellanox(R) ConnectX(R)-4 50G MCX415A-CCAT (1x100G)
674
675        * Host interface: PCI Express 3.0 x16
676        * Device ID: 15b3:1013
677        * Firmware version: 12.23.8022 and above
678
679      * Mellanox(R) ConnectX(R)-4 100G MCX416A-CCAT (2x100G)
680
681        * Host interface: PCI Express 3.0 x16
682        * Device ID: 15b3:1013
683        * Firmware version: 12.23.8022 and above
684
685      * Mellanox(R) ConnectX(R)-4 Lx 10G MCX4121A-XCAT (2x10G)
686
687        * Host interface: PCI Express 3.0 x8
688        * Device ID: 15b3:1015
689        * Firmware version: 14.23.8022 and above
690
691      * Mellanox(R) ConnectX(R)-4 Lx 25G MCX4121A-ACAT (2x25G)
692
693        * Host interface: PCI Express 3.0 x8
694        * Device ID: 15b3:1015
695        * Firmware version: 14.23.8022 and above
696
697      * Mellanox(R) ConnectX(R)-5 100G MCX556A-ECAT (2x100G)
698
699        * Host interface: PCI Express 3.0 x16
700        * Device ID: 15b3:1017
701        * Firmware version: 16.23.8022 and above
702
703      * Mellanox(R) ConnectX(R)-5 Ex EN 100G MCX516A-CDAT (2x100G)
704
705        * Host interface: PCI Express 4.0 x16
706        * Device ID: 15b3:1019
707        * Firmware version: 16.23.8022 and above
708
709 * ARM platforms with Mellanox(R) NICs combinations
710
711    * CPU:
712
713      * Qualcomm ARM 1.1 2500MHz
714
715    * OS:
716
717      * Red Hat Enterprise Linux Server release 7.5 (Maipo)
718
719    * NICs:
720
721      * Mellanox(R) ConnectX(R)-4 Lx 25G MCX4121A-ACAT (2x25G)
722
723        * Host interface: PCI Express 3.0 x8
724        * Device ID: 15b3:1015
725        * Firmware version: 14.24.0220
726
727      * Mellanox(R) ConnectX(R)-5 100G MCX556A-ECAT (2x100G)
728
729        * Host interface: PCI Express 3.0 x16
730        * Device ID: 15b3:1017
731        * Firmware version: 16.24.0220
732
733 * Mellanox(R) BlueField SmartNIC
734
735    * Mellanox(R) BlueField SmartNIC MT416842 (2x25G)
736
737        * Host interface: PCI Express 3.0 x16
738        * Device ID: 15b3:a2d2
739        * Firmware version: 18.24.0246
740
741    * SoC ARM cores running OS:
742
743      * CentOS Linux release 7.4.1708 (AltArch)
744      * MLNX_OFED 4.4-2.5.3.0
745
746   * DPDK application running on ARM cores inside SmartNIC
747
748 * ARM SoC combinations from NXP (with integrated NICs)
749
750    * SoC:
751
752      * NXP/Freescale QorIQ LS1046A with ARM Cortex A72
753      * NXP/Freescale QorIQ LS2088A with ARM Cortex A72
754
755    * OS:
756
757      * Ubuntu 18.04.1 LTS with NXP QorIQ LSDK 1809 support packages
758      * Ubuntu 16.04.3 LTS with NXP QorIQ LSDK 1803 support packages