aboutsummaryrefslogtreecommitdiffstats
path: root/doc/guides/linux_gsg/linux_eal_parameters.rst
blob: 28aebfbda2093968d441164d3ff98df1f3d6103f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
..  SPDX-License-Identifier: BSD-3-Clause
    Copyright(c) 2018 Intel Corporation.

EAL parameters
==============

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

Common EAL parameters
---------------------

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

.. include:: eal_args.include.rst

Linux-specific EAL parameters
-----------------------------

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

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.

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.

*   ``--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.

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).

Other options
~~~~~~~~~~~~~

*   ``--syslog <syslog facility>``

    Set syslog facility. Valid syslog facilities are::

        auth
        cron
        daemon
        ftp
        kern
        lpr
        mail
        news
        syslog
        user
        uucp
        local0
        local1
        local2
        local3
        local4
        local5
        local6
        local7