4 log /var/log/vpp/vpp.log
6 cli-listen /run/vpp/cli.sock
9 ## run vpp in the interactive mode
12 ## do not use colors in terminal output
15 ## do not display banner
20 ## This stanza controls binary API tracing. Unless there is a very strong reason,
21 ## please leave this feature enabled.
23 ## Additional parameters:
25 ## To set the number of binary API trace records in the circular buffer, configure nitems
29 ## To save the api message table decode tables, configure a filename. Results in /tmp/<filename>
30 ## Very handy for understanding api message changes between versions, identifying missing
31 ## plugins, and so forth.
33 ## save-api-table <filename>
45 ## Set the main heap size, default is 1G
48 ## Set the main heap page size. Default page size is OS default page
49 ## which is in most cases 4K. if different page size is specified VPP
50 ## will try to allocate main heap by using specified page size.
51 ## special keyword 'default-hugepage' will use system default hugepage
53 # main-heap-page-size 1G
54 ## Set the default huge page size.
55 # default-hugepage-size 1G
59 ## In the VPP there is one main thread and optionally the user can create worker(s)
60 ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
62 ## Manual pinning of thread(s) to CPU core(s)
64 ## Set logical CPU core where main thread runs, if main core is not set
65 ## VPP will use core 1 if available
68 ## Set logical CPU core(s) where worker threads are running
69 # corelist-workers 2-3,18-19
71 ## Automatic pinning of thread(s) to CPU core(s)
73 ## Sets number of CPU core(s) to be skipped (1 ... N-1)
74 ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
75 ## The main thread is automatically pinned to the first available CPU core and worker(s)
76 ## are pinned to next free CPU core(s) after core assigned to main thread
79 ## Specify a number of workers to be created
80 ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
81 ## and main thread's CPU core
84 ## Set scheduling policy and priority of main and worker threads
86 ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
87 ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
88 # scheduler-policy fifo
90 ## Scheduling priority is used only for "real-time policies (fifo and rr),
91 ## and has to be in the range of priorities supported for a particular policy
92 # scheduler-priority 50
96 ## Increase number of buffers allocated, needed only in scenarios with
97 ## large number of interfaces and worker threads. Value is per numa node.
98 ## Default is 16384 (8192 if running unpriviledged)
99 # buffers-per-numa 128000
101 ## Size of buffer data area
103 # default data-size 2048
105 ## Size of the memory pages allocated for buffer data
106 ## Default will try 'default-hugepage' then 'default'
107 ## you can also pass a size in K/M/G e.g. '8M'
108 # page-size default-hugepage
112 ## DSA work queue address
118 ## Change default settings for all interfaces
120 ## Number of receive queues, enables RSS
124 ## Number of transmit queues, Default is equal
125 ## to number of worker threads or 1 if no workers treads
128 ## Number of descriptors in transmit and receive rings
129 ## increasing or reducing number can impact performance
130 ## Default is 1024 for both rx and tx
134 ## TCP Segment Offload
136 ## To enable TSO, 'enable-tcp-udp-checksum' must be set
140 ## device specific init args
142 # devargs safe-mode-support=1,pipeline-mode-support=1
145 ## set valid rss steering queues
149 ## Whitelist specific interface by specifying PCI address
152 ## Blacklist specific device type by specifying PCI vendor:device
153 ## Whitelist entries take precedence
154 # blacklist 8086:10fb
156 ## Set interface name
161 ## Whitelist specific interface by specifying PCI address and in
162 ## addition specify custom parameters for this interface
167 ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
168 ## uio_pci_generic or auto (default)
169 # uio-driver vfio-pci
171 ## Disable multi-segment buffers, improves performance but
172 ## disables Jumbo MTU support
175 ## Change hugepages allocation per-socket, needed only if there is need for
176 ## larger number of mbufs. Default is 256M on each detected CPU socket
177 # socket-mem 2048,2048
179 ## Disables UDP / TCP TX checksum offload. Typically needed for use
180 ## faster vector PMDs (together with no-multi-seg)
181 # no-tx-checksum-offload
183 ## Enable UDP / TCP TX checksum offload
184 ## This is the reversed option of 'no-tx-checksum-offload'
185 # enable-tcp-udp-checksum
187 ## Enable/Disable AVX-512 vPMDs
188 # max-simd-bitwidth <256|512>
191 ## node variant defaults
194 ## specify the preferred default variant
195 # default { variant avx512 }
197 ## specify the preferred variant, for a given node
198 # ip4-rewrite { variant avx2 }
204 ## Adjusting the plugin path depending on where the VPP plugins are
205 # path /ws/vpp/build-root/install-vpp-native/vpp/lib/vpp_plugins
206 ## Add additional directory to the plugin path
207 # add-path /tmp/vpp_plugins
209 ## Disable all plugins by default and then selectively enable specific plugins
210 # plugin default { disable }
211 # plugin dpdk_plugin.so { enable }
212 # plugin acl_plugin.so { enable }
214 ## Enable all plugins by default and then selectively disable specific plugins
215 # plugin dpdk_plugin.so { disable }
216 # plugin acl_plugin.so { disable }
219 ## Statistics Segment
221 # socket-name <filename>, name of the stats segment socket
222 # defaults to /run/vpp/stats.sock
223 # size <nnn>[KMG], size of the stats segment, defaults to 32mb
224 # page-size <nnn>, page size, ie. 2m, defaults to 4k
225 # per-node-counters on | off, defaults to none
226 # update-interval <f64-seconds>, sets the segment scrape / update interval
231 ## l2fib hash table size.
234 ## l2fib hash table number of buckets. Must be power of 2.
241 ## ipsec for ipv4 tunnel lookup hash number of buckets.
245 ## ipsec for ipv6 tunnel lookup hash number of buckets.
251 ## set default logging level for logging buffer
252 ## logging levels: emerg, alert,crit, error, warn, notice, info, debug, disabled
253 # default-log-level debug
254 ## set default logging level for syslog or stderr output
255 # default-syslog-log-level info
256 ## Set per-class configuration
257 # class dpdk/cryptodev { rate-limit 100 level debug syslog-level error }