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>
36 ## Set the main heap size, default is 1G
39 ## Set the main heap page size. Default page size is OS default page
40 ## which is in most cases 4K. if different page size is specified VPP
41 ## will try to allocate main heap by using specified page size.
42 ## special keyword 'default-hugepage' will use system default hugepage
44 # main-heap-page-size 1G
48 ## In the VPP there is one main thread and optionally the user can create worker(s)
49 ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
51 ## Manual pinning of thread(s) to CPU core(s)
53 ## Set logical CPU core where main thread runs, if main core is not set
54 ## VPP will use core 1 if available
57 ## Set logical CPU core(s) where worker threads are running
58 # corelist-workers 2-3,18-19
60 ## Automatic pinning of thread(s) to CPU core(s)
62 ## Sets number of CPU core(s) to be skipped (1 ... N-1)
63 ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
64 ## The main thread is automatically pinned to the first available CPU core and worker(s)
65 ## are pinned to next free CPU core(s) after core assigned to main thread
68 ## Specify a number of workers to be created
69 ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
70 ## and main thread's CPU core
73 ## Set scheduling policy and priority of main and worker threads
75 ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
76 ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
77 # scheduler-policy fifo
79 ## Scheduling priority is used only for "real-time policies (fifo and rr),
80 ## and has to be in the range of priorities supported for a particular policy
81 # scheduler-priority 50
85 ## Increase number of buffers allocated, needed only in scenarios with
86 ## large number of interfaces and worker threads. Value is per numa node.
87 ## Default is 16384 (8192 if running unpriviledged)
88 # buffers-per-numa 128000
90 ## Size of buffer data area
92 # default data-size 2048
96 ## Change default settings for all interfaces
98 ## Number of receive queues, enables RSS
102 ## Number of transmit queues, Default is equal
103 ## to number of worker threads or 1 if no workers treads
106 ## Number of descriptors in transmit and receive rings
107 ## increasing or reducing number can impact performance
108 ## Default is 1024 for both rx and tx
112 ## VLAN strip offload mode for interface
114 # vlan-strip-offload on
116 ## TCP Segment Offload
118 ## To enable TSO, 'enable-tcp-udp-checksum' must be set
122 ## device specific init args
124 # devargs safe-mode-support=1,pipeline-mode-support=1
127 ## set valid rss steering queues
131 ## Whitelist specific interface by specifying PCI address
134 ## Blacklist specific device type by specifying PCI vendor:device
135 ## Whitelist entries take precedence
136 # blacklist 8086:10fb
138 ## Set interface name
143 ## Whitelist specific interface by specifying PCI address and in
144 ## addition specify custom parameters for this interface
149 ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
150 ## uio_pci_generic or auto (default)
151 # uio-driver vfio-pci
153 ## Disable multi-segment buffers, improves performance but
154 ## disables Jumbo MTU support
157 ## Change hugepages allocation per-socket, needed only if there is need for
158 ## larger number of mbufs. Default is 256M on each detected CPU socket
159 # socket-mem 2048,2048
161 ## Disables UDP / TCP TX checksum offload. Typically needed for use
162 ## faster vector PMDs (together with no-multi-seg)
163 # no-tx-checksum-offload
165 ## Enable UDP / TCP TX checksum offload
166 ## This is the reversed option of 'no-tx-checksum-offload'
167 # enable-tcp-udp-checksum
170 ## node variant defaults
173 ## specify the preferred default variant
174 # default { variant avx512 }
176 ## specify the preferred variant, for a given node
177 # ip4-rewrite { variant avx2 }
183 ## Adjusting the plugin path depending on where the VPP plugins are
184 # path /ws/vpp/build-root/install-vpp-native/vpp/lib/vpp_plugins
186 ## Disable all plugins by default and then selectively enable specific plugins
187 # plugin default { disable }
188 # plugin dpdk_plugin.so { enable }
189 # plugin acl_plugin.so { enable }
191 ## Enable all plugins by default and then selectively disable specific plugins
192 # plugin dpdk_plugin.so { disable }
193 # plugin acl_plugin.so { disable }
196 ## Statistics Segment
198 # socket-name <filename>, name of the stats segment socket
199 # defaults to /run/vpp/stats.sock
200 # size <nnn>[KMG], size of the stats segment, defaults to 32mb
201 # page-size <nnn>, page size, ie. 2m, defaults to 4k
202 # per-node-counters on | off, defaults to none
203 # update-interval <f64-seconds>, sets the segment scrape / update interval
208 ## l2fib hash table size.
211 ## l2fib hash table number of buckets. Must be power of 2.
218 ## ipsec for ipv4 tunnel lookup hash number of buckets.
222 ## ipsec for ipv6 tunnel lookup hash number of buckets.