DPDK EAL parameters(DPDK环境抽象层参数)-原始版本(F-Stack配置文件的配置参数)


7. EAL parameters

7.1. Common EAL parameters

7.1.1. Lcore-related options

7.1.2. Device-related options

7.1.3. Multiprocessing-related options

7.1.4. Memory-related options

7.1.5. Debugging options

7.1.6. Other options

7.2. Linux-specific EAL parameters

7.2.1. Device-related options

7.2.2. Multiprocessing-related options

7.2.3. Memory-related options

7.2.4. Other options

7. EAL parameters

This document contains a list of all EAL parameters. These parameters can be used by any DPDK application running on Linux.

7.1. Common EAL parameters

The following EAL parameters are common to all platforms supported by DPDK.

7.1.1. Lcore-related options

  • -c <core mask>

    Set the hexadecimal bitmask of the cores to run on.

  • -l <core list>

    List of cores to run on

    The argument format is <c1>[-c2][,c3[-c4],...] where c1c2, etc are core indexes between 0 and 128.

  • --lcores <core map>

    Map lcore set to physical cpu set

    The argument format is:


    Lcore and CPU lists are grouped by ( and ) Within the group. The - character is used as a range separator and , is used as a single number separator. The grouping () can be omitted for single element group. The @ can be omitted if cpus and lcores have the same value.


At a given instance only one core option --lcores-l or -c can be used.

  • --master-lcore <core ID>

    Core ID that is used as master.

  • -s <service core mask>

    Hexadecimal bitmask of cores to be used as service cores.

7.1.2. Device-related options

  • -b, --pci-blacklist <[domain:]bus:devid.func>

    Blacklist a PCI device to prevent EAL from using it. Multiple -b options are allowed.


PCI blacklist cannot be used with -w option.

  • -w, --pci-whitelist <[domain:]bus:devid.func>

    Add a PCI device in white list.


PCI whitelist cannot be used with -b option.

  • --vdev <device arguments>

    Add a virtual device using the format:

    <driver><id>[,key=val, ...]

    For example:

    --vdev 'net_pcap0,rx_pcap=input.pcap,tx_pcap=output.pcap'
  • -d <path to shared object or directory>

    Load external drivers. An argument can be a single shared object file, or a directory containing multiple driver shared objects. Multiple -d options are allowed.

  • --no-pci

    Disable PCI bus.

7.1.3. Multiprocessing-related options

  • --proc-type <primary|secondary|auto>

    Set the type of the current process.

  • --base-virtaddr <address>

    Attempt to use a different starting address for all memory maps of the primary DPDK process. This can be helpful if secondary processes cannot start due to conflicts in address map.

7.1.4. Memory-related options

  • -n <number of channels>

    Set the number of memory channels to use.

  • -r <number of ranks>

    Set the number of memory ranks (auto-detected by default).

  • -m <megabytes>

    Amount of memory to preallocate at startup.

  • --in-memory

    Do not create any shared data structures and run entirely in memory. Implies --no-shconf and (if applicable) --huge-unlink.

  • --iova-mode <pa|va>

    Force IOVA mode to a specific value.

7.1.5. Debugging options

  • --no-shconf

    No shared files created (implies no secondary process support).

  • --no-huge

    Use anonymous memory instead of hugepages (implies no secondary process support).

  • --log-level <type:val>

    Specify log level for a specific component. For example:

    --log-level lib.eal:debug

    Can be specified multiple times.

  • --trace=<regex-match>

    Enable trace based on regular expression trace name. By default, the trace is disabled. User must specify this option to enable trace. For example:

    Global trace configuration for EAL only:


    Global trace configuration for ALL the components:


    Can be specified multiple times up to 32 times.

  • --trace-dir=<directory path>

    Specify trace directory for trace output. For example:

    Configuring /tmp/ as a trace output directory:


    By default, trace output will created at home directory and parameter must be specified once only.

  • --trace-bufsz=<val>

    Specify maximum size of allocated memory for trace output for each thread. Valid unit can be either B or K or M for BytesKBytes and MBytes respectively. For example:

    Configuring 2MB as a maximum size for trace output file:


    By default, size of trace output file is 1MB and parameter must be specified once only.

  • --trace-mode=<o[verwrite] | d[iscard] >

    Specify the mode of update of trace output file. Either update on a file can be wrapped or discarded when file size reaches its maximum limit. For example:

    To discard update on trace output file:

    --trace-mode=d or --trace-mode=discard

    Default mode is overwrite and parameter must be specified once only.

7.1.6. Other options

  • -h--help

    Display help message listing all EAL parameters.

  • -v

    Display the version information on startup.

  • mbuf-pool-ops-name:

    Pool ops name for mbuf to use.

  • --telemetry:

Enable telemetry (enabled by default).

  • --no-telemetry:

Disable telemetry.

7.2. Linux-specific EAL parameters

In addition to common EAL parameters, there are also Linux-specific EAL parameters.

7.2.1. Device-related options

  • --create-uio-dev

    Create /dev/uioX files for devices bound to igb_uio kernel driver (usually done by the igb_uio driver itself).

  • --vmware-tsc-map

    Use VMware TSC map instead of native RDTSC.

  • --no-hpet

    Do not use the HPET timer.

  • --vfio-intr <legacy|msi|msix>

    Use specified interrupt mode for devices bound to VFIO kernel driver.

  • --vfio-vf-token <uuid>

    Use specified VF token for devices bound to VFIO kernel driver.

7.2.2. Multiprocessing-related options

  • --file-prefix <prefix name>

    Use a different shared data file prefix for a DPDK process. This option allows running multiple independent DPDK primary/secondary processes under different prefixes.

7.2.3. Memory-related options

  • --legacy-mem

    Use legacy DPDK memory allocation mode.

  • --socket-mem <amounts of memory per socket>

    Preallocate specified amounts of memory per socket. The parameter is a comma-separated list of values. For example:

    --socket-mem 1024,2048

    This will allocate 1 gigabyte of memory on socket 0, and 2048 megabytes of memory on socket 1.

  • --socket-limit <amounts of memory per socket>

    Place a per-socket upper limit on memory use (non-legacy memory mode only). 0 will disable the limit for a particular socket.

  • --single-file-segments

    Create fewer files in hugetlbfs (non-legacy mode only).

  • --huge-dir <path to hugetlbfs directory>

    Use specified hugetlbfs directory instead of autodetected ones.

  • --huge-unlink

    Unlink hugepage files after creating them (implies no secondary process support).

  • --match-allocations

    Free hugepages back to system exactly as they were originally allocated.

7.2.4. Other options

  • --syslog <syslog facility>

    Set syslog facility. Valid syslog facilities are:

已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 酷酷鲨 设计师:CSDN官方博客 返回首页