1 .. SPDX-License-Identifier: BSD-3-Clause
2 Copyright(c) 2018 Intel Corporation.
9 Set the hexadecimal bitmask of the cores to run on.
13 List of cores to run on
15 The argument format is ``<c1>[-c2][,c3[-c4],...]``
16 where ``c1``, ``c2``, etc are core indexes between 0 and 128.
18 * ``--lcores <core map>``
20 Map lcore set to physical cpu set
22 The argument format is::
24 <lcores[@cpus]>[<,lcores[@cpus]>...]
26 Lcore and CPU lists are grouped by ``(`` and ``)`` Within the group.
27 The ``-`` character is used as a range separator and ``,`` is used as a
28 single number separator.
29 The grouping ``()`` can be omitted for single element group.
30 The ``@`` can be omitted if cpus and lcores have the same value.
33 At a given instance only one core option ``--lcores``, ``-l`` or ``-c`` can
36 * ``--master-lcore <core ID>``
38 Core ID that is used as master.
40 * ``-s <service core mask>``
42 Hexadecimal bitmask of cores to be used as service cores.
44 Device-related options
45 ~~~~~~~~~~~~~~~~~~~~~~
47 * ``-b, --pci-blacklist <[domain:]bus:devid.func>``
49 Blacklist a PCI device to prevent EAL from using it. Multiple -b options are
53 PCI blacklist cannot be used with ``-w`` option.
55 * ``-w, --pci-whitelist <[domain:]bus:devid.func>``
57 Add a PCI device in white list.
60 PCI whitelist cannot be used with ``-b`` option.
62 * ``--vdev <device arguments>``
64 Add a virtual device using the format::
66 <driver><id>[,key=val, ...]
70 --vdev 'net_pcap0,rx_pcap=input.pcap,tx_pcap=output.pcap'
72 * ``-d <path to shared object or directory>``
74 Load external drivers. An argument can be a single shared object file, or a
75 directory containing multiple driver shared objects. Multiple -d options are
82 Multiprocessing-related options
83 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
85 * ``--proc-type <primary|secondary|auto>``
87 Set the type of the current process.
89 * ``--base-virtaddr <address>``
91 Attempt to use a different starting address for all memory maps of the
92 primary DPDK process. This can be helpful if secondary processes cannot
93 start due to conflicts in address map.
95 Memory-related options
96 ~~~~~~~~~~~~~~~~~~~~~~
98 * ``-n <number of channels>``
100 Set the number of memory channels to use.
102 * ``-r <number of ranks>``
104 Set the number of memory ranks (auto-detected by default).
108 Amount of memory to preallocate at startup.
112 Do not create any shared data structures and run entirely in memory. Implies
113 ``--no-shconf`` and (if applicable) ``--huge-unlink``.
115 * ``--iova-mode <pa|va>``
117 Force IOVA mode to a specific value.
124 No shared files created (implies no secondary process support).
128 Use anonymous memory instead of hugepages (implies no secondary process
131 * ``--log-level <type:val>``
133 Specify log level for a specific component. For example::
137 Can be specified multiple times.
144 Display help message listing all EAL parameters.
148 Display the version information on startup.
150 * ``mbuf-pool-ops-name``:
152 Pool ops name for mbuf to use.