4 log /var/log/vpp/vpp.log
6 cli-listen /run/vpp/cli.sock
11 ## This stanza controls binary API tracing. Unless there is a very strong reason,
12 ## please leave this feature enabled.
14 ## Additional parameters:
16 ## To set the number of binary API trace records in the circular buffer, configure nitems
20 ## To save the api message table decode tables, configure a filename. Results in /tmp/<filename>
21 ## Very handy for understanding api message changes between versions, identifying missing
22 ## plugins, and so forth.
24 ## save-api-table <filename>
33 ## In the VPP there is one main thread and optionally the user can create worker(s)
34 ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
36 ## Manual pinning of thread(s) to CPU core(s)
38 ## Set logical CPU core where main thread runs, if main core is not set
39 ## VPP will use core 1 if available
42 ## Set logical CPU core(s) where worker threads are running
43 # corelist-workers 2-3,18-19
45 ## Automatic pinning of thread(s) to CPU core(s)
47 ## Sets number of CPU core(s) to be skipped (1 ... N-1)
48 ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
49 ## The main thread is automatically pinned to the first available CPU core and worker(s)
50 ## are pinned to next free CPU core(s) after core assigned to main thread
53 ## Specify a number of workers to be created
54 ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
55 ## and main thread's CPU core
58 ## Set scheduling policy and priority of main and worker threads
60 ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
61 ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
62 # scheduler-policy fifo
64 ## Scheduling priority is used only for "real-time policies (fifo and rr),
65 ## and has to be in the range of priorities supported for a particular policy
66 # scheduler-priority 50
72 ## Increase number of buffers allocated, needed only in scenarios with
73 ## large number of interfaces and worker threads. Value is per numa node.
74 ## Default is 16384 (8192 if running unpriviledged)
75 # buffers-per-numa 128000
77 ## Size of buffer data area
79 # default data-size 2048
85 ## Change default settings for all interfaces
87 ## Number of receive queues, enables RSS
91 ## Number of transmit queues, Default is equal
92 ## to number of worker threads or 1 if no workers treads
95 ## Number of descriptors in transmit and receive rings
96 ## increasing or reducing number can impact performance
97 ## Default is 1024 for both rx and tx
101 ## VLAN strip offload mode for interface
103 # vlan-strip-offload on
105 ## TCP Segment Offload
107 ## To enable TSO, 'enable-tcp-udp-checksum' must be set
111 ## device specific init args
113 # devargs safe-mode-support=1,pipeline-mode-support=1
116 ## Whitelist specific interface by specifying PCI address
119 ## Blacklist specific device type by specifying PCI vendor:device
120 ## Whitelist entries take precedence
121 # blacklist 8086:10fb
123 ## Set interface name
124 # dev 0000:02:00.1 {{
128 ## Whitelist specific interface by specifying PCI address and in
129 ## addition specify custom parameters for this interface
130 # dev 0000:02:00.1 {{
134 ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
135 ## uio_pci_generic or auto (default)
136 # uio-driver vfio-pci
138 ## Disable multi-segment buffers, improves performance but
139 ## disables Jumbo MTU support
142 ## Change hugepages allocation per-socket, needed only if there is need for
143 ## larger number of mbufs. Default is 256M on each detected CPU socket
144 # socket-mem 2048,2048
146 ## Disables UDP / TCP TX checksum offload. Typically needed for use
147 ## faster vector PMDs (together with no-multi-seg)
148 # no-tx-checksum-offload
150 ## Enable UDP / TCP TX checksum offload
151 ## This is the reversed option of 'no-tx-checksum-offload'
152 # enable-tcp-udp-checksum
155 ## node variant defaults
158 ## specify the preferred default variant
159 # default {{ variant icl }}
161 ## specify the preferred variant, for a given node
162 # ip4-rewrite {{ variant skx }}
168 ## Adjusting the plugin path depending on where the VPP plugins are
169 # path /ws/vpp/build-root/install-vpp-native/vpp/lib/vpp_plugins
171 ## Disable all plugins by default and then selectively enable specific plugins
172 # plugin default {{ disable }}
173 # plugin dpdk_plugin.so {{ enable }}
174 # plugin acl_plugin.so {{ enable }}
176 ## Enable all plugins by default and then selectively disable specific plugins
177 # plugin dpdk_plugin.so {{ disable }}
178 # plugin acl_plugin.so {{ disable }}
181 ## Statistics Segment
183 # socket-name <filename>, name of the stats segment socket
184 # defaults to /run/vpp/stats.sock
185 # size <nnn>[KMG], size of the stats segment, defaults to 32mb
186 # per-node-counters on | off, defaults to none
187 # update-interval <f64-seconds>, sets the segment scrape / update interval