f9558da89b6126f98296ee6a0667b938d8df1927
[deb_dpdk.git] / doc / guides / nics / mlx5.rst
1 ..  BSD LICENSE
2     Copyright 2015 6WIND S.A.
3     Copyright 2015 Mellanox
4
5     Redistribution and use in source and binary forms, with or without
6     modification, are permitted provided that the following conditions
7     are met:
8
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
14     distribution.
15     * Neither the name of 6WIND S.A. 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.
18
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.
30
31 MLX5 poll mode driver
32 =====================
33
34 The MLX5 poll mode driver library (**librte_pmd_mlx5**) provides support
35 for **Mellanox ConnectX-4**, **Mellanox ConnectX-4 Lx** and **Mellanox
36 ConnectX-5** families of 10/25/40/50/100 Gb/s adapters as well as their
37 virtual functions (VF) in SR-IOV context.
38
39 Information and documentation about these adapters can be found on the
40 `Mellanox website <http://www.mellanox.com>`__. Help is also provided by the
41 `Mellanox community <http://community.mellanox.com/welcome>`__.
42
43 There is also a `section dedicated to this poll mode driver
44 <http://www.mellanox.com/page/products_dyn?product_family=209&mtag=pmd_for_dpdk>`__.
45
46 .. note::
47
48    Due to external dependencies, this driver is disabled by default. It must
49    be enabled manually by setting ``CONFIG_RTE_LIBRTE_MLX5_PMD=y`` and
50    recompiling DPDK.
51
52 Implementation details
53 ----------------------
54
55 Besides its dependency on libibverbs (that implies libmlx5 and associated
56 kernel support), librte_pmd_mlx5 relies heavily on system calls for control
57 operations such as querying/updating the MTU and flow control parameters.
58
59 For security reasons and robustness, this driver only deals with virtual
60 memory addresses. The way resources allocations are handled by the kernel
61 combined with hardware specifications that allow it to handle virtual memory
62 addresses directly ensure that DPDK applications cannot access random
63 physical memory (or memory that does not belong to the current process).
64
65 This capability allows the PMD to coexist with kernel network interfaces
66 which remain functional, although they stop receiving unicast packets as
67 long as they share the same MAC address.
68 This means legacy linux control tools (for example: ethtool, ifconfig and
69 more) can operate on the same network interfaces that owned by the DPDK
70 application.
71
72 Enabling librte_pmd_mlx5 causes DPDK applications to be linked against
73 libibverbs.
74
75 Features
76 --------
77
78 - Multi arch support: x86_64, POWER8, ARMv8.
79 - Multiple TX and RX queues.
80 - Support for scattered TX and RX frames.
81 - IPv4, IPv6, TCPv4, TCPv6, UDPv4 and UDPv6 RSS on any number of queues.
82 - Several RSS hash keys, one for each flow type.
83 - Configurable RETA table.
84 - Support for multiple MAC addresses.
85 - VLAN filtering.
86 - RX VLAN stripping.
87 - TX VLAN insertion.
88 - RX CRC stripping configuration.
89 - Promiscuous mode.
90 - Multicast promiscuous mode.
91 - Hardware checksum offloads.
92 - Flow director (RTE_FDIR_MODE_PERFECT, RTE_FDIR_MODE_PERFECT_MAC_VLAN and
93   RTE_ETH_FDIR_REJECT).
94 - Flow API.
95 - Multiple process.
96 - KVM and VMware ESX SR-IOV modes are supported.
97 - RSS hash result is supported.
98 - Hardware TSO.
99 - Hardware checksum TX offload for VXLAN and GRE.
100 - RX interrupts.
101 - Statistics query including Basic, Extended and per queue.
102 - Rx HW timestamp.
103
104 Limitations
105 -----------
106
107 - Inner RSS for VXLAN frames is not supported yet.
108 - Port statistics through software counters only. Flow statistics are
109   supported by hardware counters.
110 - Hardware checksum RX offloads for VXLAN inner header are not supported yet.
111 - Forked secondary process not supported.
112 - Flow pattern without any specific vlan will match for vlan packets as well:
113
114   When VLAN spec is not specified in the pattern, the matching rule will be created with VLAN as a wild card.
115   Meaning, the flow rule::
116
117         flow create 0 ingress pattern eth / vlan vid is 3 / ipv4 / end ...
118
119   Will only match vlan packets with vid=3. and the flow rules::
120
121         flow create 0 ingress pattern eth / ipv4 / end ...
122
123   Or::
124
125         flow create 0 ingress pattern eth / vlan / ipv4 / end ...
126
127   Will match any ipv4 packet (VLAN included).
128
129 - A multi segment packet must have less than 6 segments in case the Tx burst function
130   is set to multi-packet send or Enhanced multi-packet send. Otherwise it must have
131   less than 50 segments.
132 - Count action for RTE flow is only supported in Mellanox OFED 4.2.
133 - Flows with a VXLAN Network Identifier equal (or ends to be equal)
134   to 0 are not supported.
135 - VXLAN TSO and checksum offloads are not supported on VM.
136
137 Configuration
138 -------------
139
140 Compilation options
141 ~~~~~~~~~~~~~~~~~~~
142
143 These options can be modified in the ``.config`` file.
144
145 - ``CONFIG_RTE_LIBRTE_MLX5_PMD`` (default **n**)
146
147   Toggle compilation of librte_pmd_mlx5 itself.
148
149 - ``CONFIG_RTE_LIBRTE_MLX5_DEBUG`` (default **n**)
150
151   Toggle debugging code and stricter compilation flags. Enabling this option
152   adds additional run-time checks and debugging messages at the cost of
153   lower performance.
154
155 - ``CONFIG_RTE_LIBRTE_MLX5_TX_MP_CACHE`` (default **8**)
156
157   Maximum number of cached memory pools (MPs) per TX queue. Each MP from
158   which buffers are to be transmitted must be associated to memory regions
159   (MRs). This is a slow operation that must be cached.
160
161   This value is always 1 for RX queues since they use a single MP.
162
163 Environment variables
164 ~~~~~~~~~~~~~~~~~~~~~
165
166 - ``MLX5_PMD_ENABLE_PADDING``
167
168   Enables HW packet padding in PCI bus transactions.
169
170   When packet size is cache aligned and CRC stripping is enabled, 4 fewer
171   bytes are written to the PCI bus. Enabling padding makes such packets
172   aligned again.
173
174   In cases where PCI bandwidth is the bottleneck, padding can improve
175   performance by 10%.
176
177   This is disabled by default since this can also decrease performance for
178   unaligned packet sizes.
179
180 - ``MLX5_SHUT_UP_BF``
181
182   Configures HW Tx doorbell register as IO-mapped.
183
184   By default, the HW Tx doorbell is configured as a write-combining register.
185   The register would be flushed to HW usually when the write-combining buffer
186   becomes full, but it depends on CPU design.
187
188   Except for vectorized Tx burst routines, a write memory barrier is enforced
189   after updating the register so that the update can be immediately visible to
190   HW.
191
192   When vectorized Tx burst is called, the barrier is set only if the burst size
193   is not aligned to MLX5_VPMD_TX_MAX_BURST. However, setting this environmental
194   variable will bring better latency even though the maximum throughput can
195   slightly decline.
196
197 Run-time configuration
198 ~~~~~~~~~~~~~~~~~~~~~~
199
200 - librte_pmd_mlx5 brings kernel network interfaces up during initialization
201   because it is affected by their state. Forcing them down prevents packets
202   reception.
203
204 - **ethtool** operations on related kernel interfaces also affect the PMD.
205
206 - ``rxq_cqe_comp_en`` parameter [int]
207
208   A nonzero value enables the compression of CQE on RX side. This feature
209   allows to save PCI bandwidth and improve performance. Enabled by default.
210
211   Supported on:
212
213   - x86_64 with ConnectX-4, ConnectX-4 LX and ConnectX-5.
214   - POWER8 and ARMv8 with ConnectX-4 LX and ConnectX-5.
215
216 - ``txq_inline`` parameter [int]
217
218   Amount of data to be inlined during TX operations. Improves latency.
219   Can improve PPS performance when PCI back pressure is detected and may be
220   useful for scenarios involving heavy traffic on many queues.
221
222   Because additional software logic is necessary to handle this mode, this
223   option should be used with care, as it can lower performance when back
224   pressure is not expected.
225
226 - ``txqs_min_inline`` parameter [int]
227
228   Enable inline send only when the number of TX queues is greater or equal
229   to this value.
230
231   This option should be used in combination with ``txq_inline`` above.
232
233   On ConnectX-4, ConnectX-4 LX and ConnectX-5 without Enhanced MPW:
234
235         - Disabled by default.
236         - In case ``txq_inline`` is set recommendation is 4.
237
238   On ConnectX-5 with Enhanced MPW:
239
240         - Set to 8 by default.
241
242 - ``txq_mpw_en`` parameter [int]
243
244   A nonzero value enables multi-packet send (MPS) for ConnectX-4 Lx and
245   enhanced multi-packet send (Enhanced MPS) for ConnectX-5. MPS allows the
246   TX burst function to pack up multiple packets in a single descriptor
247   session in order to save PCI bandwidth and improve performance at the
248   cost of a slightly higher CPU usage. When ``txq_inline`` is set along
249   with ``txq_mpw_en``, TX burst function tries to copy entire packet data
250   on to TX descriptor instead of including pointer of packet only if there
251   is enough room remained in the descriptor. ``txq_inline`` sets
252   per-descriptor space for either pointers or inlined packets. In addition,
253   Enhanced MPS supports hybrid mode - mixing inlined packets and pointers
254   in the same descriptor.
255
256   This option cannot be used in conjunction with ``tso`` below. When ``tso``
257   is set, ``txq_mpw_en`` is disabled.
258
259   It is currently only supported on the ConnectX-4 Lx and ConnectX-5
260   families of adapters. Enabled by default.
261
262 - ``txq_mpw_hdr_dseg_en`` parameter [int]
263
264   A nonzero value enables including two pointers in the first block of TX
265   descriptor. This can be used to lessen CPU load for memory copy.
266
267   Effective only when Enhanced MPS is supported. Disabled by default.
268
269 - ``txq_max_inline_len`` parameter [int]
270
271   Maximum size of packet to be inlined. This limits the size of packet to
272   be inlined. If the size of a packet is larger than configured value, the
273   packet isn't inlined even though there's enough space remained in the
274   descriptor. Instead, the packet is included with pointer.
275
276   Effective only when Enhanced MPS is supported. The default value is 256.
277
278 - ``tso`` parameter [int]
279
280   A nonzero value enables hardware TSO.
281   When hardware TSO is enabled, packets marked with TCP segmentation
282   offload will be divided into segments by the hardware. Disabled by default.
283
284 - ``tx_vec_en`` parameter [int]
285
286   A nonzero value enables Tx vector on ConnectX-5 only NIC if the number of
287   global Tx queues on the port is lesser than MLX5_VPMD_MIN_TXQS.
288
289   Enabled by default on ConnectX-5.
290
291 - ``rx_vec_en`` parameter [int]
292
293   A nonzero value enables Rx vector if the port is not configured in
294   multi-segment otherwise this parameter is ignored.
295
296   Enabled by default.
297
298 Prerequisites
299 -------------
300
301 This driver relies on external libraries and kernel drivers for resources
302 allocations and initialization. The following dependencies are not part of
303 DPDK and must be installed separately:
304
305 - **libibverbs**
306
307   User space Verbs framework used by librte_pmd_mlx5. This library provides
308   a generic interface between the kernel and low-level user space drivers
309   such as libmlx5.
310
311   It allows slow and privileged operations (context initialization, hardware
312   resources allocations) to be managed by the kernel and fast operations to
313   never leave user space.
314
315 - **libmlx5**
316
317   Low-level user space driver library for Mellanox ConnectX-4/ConnectX-5
318   devices, it is automatically loaded by libibverbs.
319
320   This library basically implements send/receive calls to the hardware
321   queues.
322
323 - **Kernel modules**
324
325   They provide the kernel-side Verbs API and low level device drivers that
326   manage actual hardware initialization and resources sharing with user
327   space processes.
328
329   Unlike most other PMDs, these modules must remain loaded and bound to
330   their devices:
331
332   - mlx5_core: hardware driver managing Mellanox ConnectX-4/ConnectX-5
333     devices and related Ethernet kernel network devices.
334   - mlx5_ib: InifiniBand device driver.
335   - ib_uverbs: user space driver for Verbs (entry point for libibverbs).
336
337 - **Firmware update**
338
339   Mellanox OFED releases include firmware updates for ConnectX-4/ConnectX-5
340   adapters.
341
342   Because each release provides new features, these updates must be applied to
343   match the kernel modules and libraries they come with.
344
345 .. note::
346
347    Both libraries are BSD and GPL licensed. Linux kernel modules are GPL
348    licensed.
349
350 Installation
351 ~~~~~~~~~~~~
352
353 Either RDMA Core library with a recent enough Linux kernel release
354 (recommended) or Mellanox OFED, which provides compatibility with older
355 releases.
356
357 RMDA Core with Linux Kernel
358 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
359
360 - Minimal kernel version : v4.14 or the most recent 4.14-rc (see `Linux installation documentation`_)
361 - Minimal rdma-core version: v15+ commit 0c5f5765213a ("Merge pull request #227 from yishaih/tm")
362   (see `RDMA Core installation documentation`_)
363
364 .. _`Linux installation documentation`: https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/plain/Documentation/admin-guide/README.rst
365 .. _`RDMA Core installation documentation`: https://raw.githubusercontent.com/linux-rdma/rdma-core/master/README.md
366
367 Mellanox OFED
368 ^^^^^^^^^^^^^
369
370 - Mellanox OFED version: **4.2**.
371 - firmware version:
372
373   - ConnectX-4: **12.21.1000** and above.
374   - ConnectX-4 Lx: **14.21.1000** and above.
375   - ConnectX-5: **16.21.1000** and above.
376   - ConnectX-5 Ex: **16.21.1000** and above.
377
378 While these libraries and kernel modules are available on OpenFabrics
379 Alliance's `website <https://www.openfabrics.org/>`__ and provided by package
380 managers on most distributions, this PMD requires Ethernet extensions that
381 may not be supported at the moment (this is a work in progress).
382
383 `Mellanox OFED
384 <http://www.mellanox.com/page/products_dyn?product_family=26&mtag=linux>`__
385 includes the necessary support and should be used in the meantime. For DPDK,
386 only libibverbs, libmlx5, mlnx-ofed-kernel packages and firmware updates are
387 required from that distribution.
388
389 .. note::
390
391    Several versions of Mellanox OFED are available. Installing the version
392    this DPDK release was developed and tested against is strongly
393    recommended. Please check the `prerequisites`_.
394
395 Supported NICs
396 --------------
397
398 * Mellanox(R) ConnectX(R)-4 10G MCX4111A-XCAT (1x10G)
399 * Mellanox(R) ConnectX(R)-4 10G MCX4121A-XCAT (2x10G)
400 * Mellanox(R) ConnectX(R)-4 25G MCX4111A-ACAT (1x25G)
401 * Mellanox(R) ConnectX(R)-4 25G MCX4121A-ACAT (2x25G)
402 * Mellanox(R) ConnectX(R)-4 40G MCX4131A-BCAT (1x40G)
403 * Mellanox(R) ConnectX(R)-4 40G MCX413A-BCAT (1x40G)
404 * Mellanox(R) ConnectX(R)-4 40G MCX415A-BCAT (1x40G)
405 * Mellanox(R) ConnectX(R)-4 50G MCX4131A-GCAT (1x50G)
406 * Mellanox(R) ConnectX(R)-4 50G MCX413A-GCAT (1x50G)
407 * Mellanox(R) ConnectX(R)-4 50G MCX414A-BCAT (2x50G)
408 * Mellanox(R) ConnectX(R)-4 50G MCX415A-GCAT (2x50G)
409 * Mellanox(R) ConnectX(R)-4 50G MCX416A-BCAT (2x50G)
410 * Mellanox(R) ConnectX(R)-4 50G MCX416A-GCAT (2x50G)
411 * Mellanox(R) ConnectX(R)-4 50G MCX415A-CCAT (1x100G)
412 * Mellanox(R) ConnectX(R)-4 100G MCX416A-CCAT (2x100G)
413 * Mellanox(R) ConnectX(R)-4 Lx 10G MCX4121A-XCAT (2x10G)
414 * Mellanox(R) ConnectX(R)-4 Lx 25G MCX4121A-ACAT (2x25G)
415 * Mellanox(R) ConnectX(R)-5 100G MCX556A-ECAT (2x100G)
416 * Mellanox(R) ConnectX(R)-5 Ex EN 100G MCX516A-CDAT (2x100G)
417
418 Quick Start Guide on OFED
419 -------------------------
420
421 1. Download latest Mellanox OFED. For more info check the  `prerequisites`_.
422
423
424 2. Install the required libraries and kernel modules either by installing
425    only the required set, or by installing the entire Mellanox OFED:
426
427    .. code-block:: console
428
429         ./mlnxofedinstall --upstream-libs --dpdk
430
431 3. Verify the firmware is the correct one:
432
433    .. code-block:: console
434
435         ibv_devinfo
436
437 4. Verify all ports links are set to Ethernet:
438
439    .. code-block:: console
440
441         mlxconfig -d <mst device> query | grep LINK_TYPE
442         LINK_TYPE_P1                        ETH(2)
443         LINK_TYPE_P2                        ETH(2)
444
445    Link types may have to be configured to Ethernet:
446
447    .. code-block:: console
448
449         mlxconfig -d <mst device> set LINK_TYPE_P1/2=1/2/3
450
451         * LINK_TYPE_P1=<1|2|3> , 1=Infiniband 2=Ethernet 3=VPI(auto-sense)
452
453    For hypervisors verify SR-IOV is enabled on the NIC:
454
455    .. code-block:: console
456
457         mlxconfig -d <mst device> query | grep SRIOV_EN
458         SRIOV_EN                            True(1)
459
460    If needed, set enable the set the relevant fields:
461
462    .. code-block:: console
463
464         mlxconfig -d <mst device> set SRIOV_EN=1 NUM_OF_VFS=16
465         mlxfwreset -d <mst device> reset
466
467 5. Restart the driver:
468
469    .. code-block:: console
470
471         /etc/init.d/openibd restart
472
473    or:
474
475    .. code-block:: console
476
477         service openibd restart
478
479    If link type was changed, firmware must be reset as well:
480
481    .. code-block:: console
482
483         mlxfwreset -d <mst device> reset
484
485    For hypervisors, after reset write the sysfs number of virtual functions
486    needed for the PF.
487
488    To dynamically instantiate a given number of virtual functions (VFs):
489
490    .. code-block:: console
491
492         echo [num_vfs] > /sys/class/infiniband/mlx5_0/device/sriov_numvfs
493
494 6. Compile DPDK and you are ready to go. See instructions on
495    :ref:`Development Kit Build System <Development_Kit_Build_System>`
496
497 Performance tuning
498 ------------------
499
500 1. Configure aggressive CQE Zipping for maximum performance:
501
502   .. code-block:: console
503
504         mlxconfig -d <mst device> s CQE_COMPRESSION=1
505
506   To set it back to the default CQE Zipping mode use:
507
508   .. code-block:: console
509
510         mlxconfig -d <mst device> s CQE_COMPRESSION=0
511
512 2. In case of virtualization:
513
514    - Make sure that hypervisor kernel is 3.16 or newer.
515    - Configure boot with ``iommu=pt``.
516    - Use 1G huge pages.
517    - Make sure to allocate a VM on huge pages.
518    - Make sure to set CPU pinning.
519
520 3. Use the CPU near local NUMA node to which the PCIe adapter is connected,
521    for better performance. For VMs, verify that the right CPU
522    and NUMA node are pinned according to the above. Run:
523
524    .. code-block:: console
525
526         lstopo-no-graphics
527
528    to identify the NUMA node to which the PCIe adapter is connected.
529
530 4. If more than one adapter is used, and root complex capabilities allow
531    to put both adapters on the same NUMA node without PCI bandwidth degradation,
532    it is recommended to locate both adapters on the same NUMA node.
533    This in order to forward packets from one to the other without
534    NUMA performance penalty.
535
536 5. Disable pause frames:
537
538    .. code-block:: console
539
540         ethtool -A <netdev> rx off tx off
541
542 6. Verify IO non-posted prefetch is disabled by default. This can be checked
543    via the BIOS configuration. Please contact you server provider for more
544    information about the settings.
545
546 .. note::
547
548         On some machines, depends on the machine integrator, it is beneficial
549         to set the PCI max read request parameter to 1K. This can be
550         done in the following way:
551
552         To query the read request size use:
553
554         .. code-block:: console
555
556                 setpci -s <NIC PCI address> 68.w
557
558         If the output is different than 3XXX, set it by:
559
560         .. code-block:: console
561
562                 setpci -s <NIC PCI address> 68.w=3XXX
563
564         The XXX can be different on different systems. Make sure to configure
565         according to the setpci output.
566
567 Notes for testpmd
568 -----------------
569
570 Compared to librte_pmd_mlx4 that implements a single RSS configuration per
571 port, librte_pmd_mlx5 supports per-protocol RSS configuration.
572
573 Since ``testpmd`` defaults to IP RSS mode and there is currently no
574 command-line parameter to enable additional protocols (UDP and TCP as well
575 as IP), the following commands must be entered from its CLI to get the same
576 behavior as librte_pmd_mlx4:
577
578 .. code-block:: console
579
580    > port stop all
581    > port config all rss all
582    > port start all
583
584 Usage example
585 -------------
586
587 This section demonstrates how to launch **testpmd** with Mellanox
588 ConnectX-4/ConnectX-5 devices managed by librte_pmd_mlx5.
589
590 #. Load the kernel modules:
591
592    .. code-block:: console
593
594       modprobe -a ib_uverbs mlx5_core mlx5_ib
595
596    Alternatively if MLNX_OFED is fully installed, the following script can
597    be run:
598
599    .. code-block:: console
600
601       /etc/init.d/openibd restart
602
603    .. note::
604
605       User space I/O kernel modules (uio and igb_uio) are not used and do
606       not have to be loaded.
607
608 #. Make sure Ethernet interfaces are in working order and linked to kernel
609    verbs. Related sysfs entries should be present:
610
611    .. code-block:: console
612
613       ls -d /sys/class/net/*/device/infiniband_verbs/uverbs* | cut -d / -f 5
614
615    Example output:
616
617    .. code-block:: console
618
619       eth30
620       eth31
621       eth32
622       eth33
623
624 #. Optionally, retrieve their PCI bus addresses for whitelisting:
625
626    .. code-block:: console
627
628       {
629           for intf in eth2 eth3 eth4 eth5;
630           do
631               (cd "/sys/class/net/${intf}/device/" && pwd -P);
632           done;
633       } |
634       sed -n 's,.*/\(.*\),-w \1,p'
635
636    Example output:
637
638    .. code-block:: console
639
640       -w 0000:05:00.1
641       -w 0000:06:00.0
642       -w 0000:06:00.1
643       -w 0000:05:00.0
644
645 #. Request huge pages:
646
647    .. code-block:: console
648
649       echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages
650
651 #. Start testpmd with basic parameters:
652
653    .. code-block:: console
654
655       testpmd -l 8-15 -n 4 -w 05:00.0 -w 05:00.1 -w 06:00.0 -w 06:00.1 -- --rxq=2 --txq=2 -i
656
657    Example output:
658
659    .. code-block:: console
660
661       [...]
662       EAL: PCI device 0000:05:00.0 on NUMA socket 0
663       EAL:   probe driver: 15b3:1013 librte_pmd_mlx5
664       PMD: librte_pmd_mlx5: PCI information matches, using device "mlx5_0" (VF: false)
665       PMD: librte_pmd_mlx5: 1 port(s) detected
666       PMD: librte_pmd_mlx5: port 1 MAC address is e4:1d:2d:e7:0c:fe
667       EAL: PCI device 0000:05:00.1 on NUMA socket 0
668       EAL:   probe driver: 15b3:1013 librte_pmd_mlx5
669       PMD: librte_pmd_mlx5: PCI information matches, using device "mlx5_1" (VF: false)
670       PMD: librte_pmd_mlx5: 1 port(s) detected
671       PMD: librte_pmd_mlx5: port 1 MAC address is e4:1d:2d:e7:0c:ff
672       EAL: PCI device 0000:06:00.0 on NUMA socket 0
673       EAL:   probe driver: 15b3:1013 librte_pmd_mlx5
674       PMD: librte_pmd_mlx5: PCI information matches, using device "mlx5_2" (VF: false)
675       PMD: librte_pmd_mlx5: 1 port(s) detected
676       PMD: librte_pmd_mlx5: port 1 MAC address is e4:1d:2d:e7:0c:fa
677       EAL: PCI device 0000:06:00.1 on NUMA socket 0
678       EAL:   probe driver: 15b3:1013 librte_pmd_mlx5
679       PMD: librte_pmd_mlx5: PCI information matches, using device "mlx5_3" (VF: false)
680       PMD: librte_pmd_mlx5: 1 port(s) detected
681       PMD: librte_pmd_mlx5: port 1 MAC address is e4:1d:2d:e7:0c:fb
682       Interactive-mode selected
683       Configuring Port 0 (socket 0)
684       PMD: librte_pmd_mlx5: 0x8cba80: TX queues number update: 0 -> 2
685       PMD: librte_pmd_mlx5: 0x8cba80: RX queues number update: 0 -> 2
686       Port 0: E4:1D:2D:E7:0C:FE
687       Configuring Port 1 (socket 0)
688       PMD: librte_pmd_mlx5: 0x8ccac8: TX queues number update: 0 -> 2
689       PMD: librte_pmd_mlx5: 0x8ccac8: RX queues number update: 0 -> 2
690       Port 1: E4:1D:2D:E7:0C:FF
691       Configuring Port 2 (socket 0)
692       PMD: librte_pmd_mlx5: 0x8cdb10: TX queues number update: 0 -> 2
693       PMD: librte_pmd_mlx5: 0x8cdb10: RX queues number update: 0 -> 2
694       Port 2: E4:1D:2D:E7:0C:FA
695       Configuring Port 3 (socket 0)
696       PMD: librte_pmd_mlx5: 0x8ceb58: TX queues number update: 0 -> 2
697       PMD: librte_pmd_mlx5: 0x8ceb58: RX queues number update: 0 -> 2
698       Port 3: E4:1D:2D:E7:0C:FB
699       Checking link statuses...
700       Port 0 Link Up - speed 40000 Mbps - full-duplex
701       Port 1 Link Up - speed 40000 Mbps - full-duplex
702       Port 2 Link Up - speed 10000 Mbps - full-duplex
703       Port 3 Link Up - speed 10000 Mbps - full-duplex
704       Done
705       testpmd>