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
57 ## In the VPP there is one main thread and optionally the user can create worker(s)
58 ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
60 ## Manual pinning of thread(s) to CPU core(s)
62 ## Set logical CPU core where main thread runs, if main core is not set
63 ## VPP will use core 1 if available
66 ## Set logical CPU core(s) where worker threads are running
67 # corelist-workers 2-3,18-19
69 ## Automatic pinning of thread(s) to CPU core(s)
71 ## Sets number of CPU core(s) to be skipped (1 ... N-1)
72 ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
73 ## The main thread is automatically pinned to the first available CPU core and worker(s)
74 ## are pinned to next free CPU core(s) after core assigned to main thread
77 ## Specify a number of workers to be created
78 ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
79 ## and main thread's CPU core
82 ## Set scheduling policy and priority of main and worker threads
84 ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
85 ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
86 # scheduler-policy fifo
88 ## Scheduling priority is used only for "real-time policies (fifo and rr),
89 ## and has to be in the range of priorities supported for a particular policy
90 # scheduler-priority 50
94 ## Increase number of buffers allocated, needed only in scenarios with
95 ## large number of interfaces and worker threads. Value is per numa node.
96 ## Default is 16384 (8192 if running unpriviledged)
97 # buffers-per-numa 128000
99 ## Size of buffer data area
101 # default data-size 2048
103 ## Size of the memory pages allocated for buffer data
104 ## Default will try 'default-hugepage' then 'default'
105 ## you can also pass a size in K/M/G e.g. '8M'
106 # page-size default-hugepage
110 ## Change default settings for all interfaces
112 ## Number of receive queues, enables RSS
116 ## Number of transmit queues, Default is equal
117 ## to number of worker threads or 1 if no workers treads
120 ## Number of descriptors in transmit and receive rings
121 ## increasing or reducing number can impact performance
122 ## Default is 1024 for both rx and tx
126 ## VLAN strip offload mode for interface
128 # vlan-strip-offload on
130 ## TCP Segment Offload
132 ## To enable TSO, 'enable-tcp-udp-checksum' must be set
136 ## device specific init args
138 # devargs safe-mode-support=1,pipeline-mode-support=1
141 ## set valid rss steering queues
145 ## Whitelist specific interface by specifying PCI address
148 ## Blacklist specific device type by specifying PCI vendor:device
149 ## Whitelist entries take precedence
150 # blacklist 8086:10fb
152 ## Set interface name
157 ## Whitelist specific interface by specifying PCI address and in
158 ## addition specify custom parameters for this interface
163 ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
164 ## uio_pci_generic or auto (default)
165 # uio-driver vfio-pci
167 ## Disable multi-segment buffers, improves performance but
168 ## disables Jumbo MTU support
171 ## Change hugepages allocation per-socket, needed only if there is need for
172 ## larger number of mbufs. Default is 256M on each detected CPU socket
173 # socket-mem 2048,2048
175 ## Disables UDP / TCP TX checksum offload. Typically needed for use
176 ## faster vector PMDs (together with no-multi-seg)
177 # no-tx-checksum-offload
179 ## Enable UDP / TCP TX checksum offload
180 ## This is the reversed option of 'no-tx-checksum-offload'
181 # enable-tcp-udp-checksum
184 ## node variant defaults
187 ## specify the preferred default variant
188 # default { variant avx512 }
190 ## specify the preferred variant, for a given node
191 # ip4-rewrite { variant avx2 }
197 ## Adjusting the plugin path depending on where the VPP plugins are
198 # path /ws/vpp/build-root/install-vpp-native/vpp/lib/vpp_plugins
200 ## Disable all plugins by default and then selectively enable specific plugins
201 # plugin default { disable }
202 # plugin dpdk_plugin.so { enable }
203 # plugin acl_plugin.so { enable }
205 ## Enable all plugins by default and then selectively disable specific plugins
206 # plugin dpdk_plugin.so { disable }
207 # plugin acl_plugin.so { disable }
210 ## Statistics Segment
212 # socket-name <filename>, name of the stats segment socket
213 # defaults to /run/vpp/stats.sock
214 # size <nnn>[KMG], size of the stats segment, defaults to 32mb
215 # page-size <nnn>, page size, ie. 2m, defaults to 4k
216 # per-node-counters on | off, defaults to none
217 # update-interval <f64-seconds>, sets the segment scrape / update interval
222 ## l2fib hash table size.
225 ## l2fib hash table number of buckets. Must be power of 2.
232 ## ipsec for ipv4 tunnel lookup hash number of buckets.
236 ## ipsec for ipv6 tunnel lookup hash number of buckets.
242 ## set default logging level for logging buffer
243 ## logging levels: emerg, alert,crit, error, warn, notice, info, debug, disabled
244 # default-log-level debug
245 ## set default logging level for syslog or stderr output
246 # default-syslog-log-level info
247 ## Set per-class configuration
248 # class dpdk/cryptodev { rate-limit 100 level debug syslog-level error }