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 Memory-related options
90 ~~~~~~~~~~~~~~~~~~~~~~
92 * ``-n <number of channels>``
94 Set the number of memory channels to use.
96 * ``-r <number of ranks>``
98 Set the number of memory ranks (auto-detected by default).
102 Amount of memory to preallocate at startup.
106 Do not create any shared data structures and run entirely in memory. Implies
107 ``--no-shconf`` and (if applicable) ``--huge-unlink``.
109 * ``--iova-mode <pa|va>``
111 Force IOVA mode to a specific value.
118 No shared files created (implies no secondary process support).
122 Use anonymous memory instead of hugepages (implies no secondary process
125 * ``--log-level <type:val>``
127 Specify log level for a specific component. For example::
131 Can be specified multiple times.
138 Display help message listing all EAL parameters.
142 Display the version information on startup.
144 * ``mbuf-pool-ops-name``:
146 Pool ops name for mbuf to use.