]> git.proxmox.com Git - mirror_qemu.git/blame - meson_options.txt
projects / mirror_qemu.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Merge tag 'xen-virtio-2-tag' of https://gitlab.com/sstabellini/qemu into staging
[mirror_qemu.git] / meson_options.txt
CommitLineData
3b4da132
PB		 1# These options do not correspond to a --enable/--disable-* option
2# on the configure script command line. If you add more, list them in
3# scripts/meson-buildoptions.py's SKIP_OPTIONS constant too.
4
ab4c0996 5option('qemu_suffix', type : 'string', value: 'qemu',
73f3aa37 6 description: 'Suffix for QEMU data/modules/config directories (can be empty)')
c09c1ce7 7option('docdir', type : 'string', value : 'share/doc',
491e74c1 8 description: 'Base directory for documentation installation (can be empty)')
8154f5e6 9option('qemu_firmwarepath', type : 'array', value : ['share/qemu-firmware'],
16bf7a33 10 description: 'search PATH for firmware files')
b0b4323e
PB		 11option('pkgversion', type : 'string', value : '',
12 description: 'use specified string as sub-version of the package')
35acbb30
PB		 13option('smbd', type : 'string', value : '',
14 description: 'Path to smbd for slirp networking')
5dc4618e
PB		 15option('iasl', type : 'string', value : '',
16 description: 'Path to ACPI disassembler')
41f2ae28
PB		 17option('tls_priority', type : 'string', value : 'NORMAL',
18 description: 'Default TLS protocol/cipher priority string')
7bc3ca7f
PB		 19option('default_devices', type : 'boolean', value : true,
20 description: 'Include a default selection of devices in emulators')
87430d5b 21option('audio_drv_list', type: 'array', value: ['default'],
c2d3d1c2 22 choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'pipewire', 'sdl', 'sndio'],
87430d5b 23 description: 'Set audio driver list')
622d64ff
PB		 24option('block_drv_rw_whitelist', type : 'string', value : '',
25 description: 'set block driver read-write whitelist (by default affects only QEMU, not tools like qemu-img)')
26option('block_drv_ro_whitelist', type : 'string', value : '',
27 description: 'set block driver read-only whitelist (by default affects only QEMU, not tools like qemu-img)')
ce6119dc
PB		 28option('interp_prefix', type : 'string', value : '/usr/gnemul/qemu-%M',
29 description: 'where to find shared libraries etc., use %M for cpu name')
537b7248
PB		 30option('fuzzing_engine', type : 'string', value : '',
31 description: 'fuzzing engine library for OSS-Fuzz')
9c29b741
PB		 32option('trace_file', type: 'string', value: 'trace',
33 description: 'Trace file prefix for simple backend')
6739825a
PB		 34option('coroutine_backend', type: 'combo',
35 choices: ['ucontext', 'sigaltstack', 'windows', 'auto'],
36 value: 'auto', description: 'coroutine backend to use')
87430d5b 37
3b4da132
PB		 38# Everything else can be set via --enable/--disable-* option
39# on the configure script command line. After adding an option
40# here make sure to run "make update-buildoptions".
41
e3667660
YL		 42option('docs', type : 'feature', value : 'auto',
43 description: 'Documentations build support')
537b7248
PB		 44option('fuzzing', type : 'boolean', value: false,
45 description: 'build fuzzing targets')
0e8e77d4 46option('gettext', type : 'feature', value : 'auto',
cb572714 47 description: 'Localization of the GTK+ user interface')
6002711c
PB		 48option('modules', type : 'feature', value : 'disabled',
49 description: 'modules support (non Windows)')
2cb2f580
PB		 50option('module_upgrades', type : 'boolean', value : false,
51 description: 'try to load modules from alternate paths for upgrades')
c8d5450b
PB		 52option('install_blobs', type : 'boolean', value : true,
53 description: 'install provided firmware blobs')
deb62371
PB		 54option('sparse', type : 'feature', value : 'auto',
55 description: 'sparse checker')
20cf5cb4
PB		 56option('guest_agent', type : 'feature', value : 'auto',
57 description: 'Build QEMU Guest Agent')
b846ab7c
PB		 58option('guest_agent_msi', type : 'feature', value : 'auto',
59 description: 'Build MSI package for the QEMU Guest Agent')
20cf5cb4
PB		 60option('tools', type : 'feature', value : 'auto',
61 description: 'build support utilities that come with QEMU')
8821a389
MAL		 62option('qga_vss', type : 'feature', value: 'auto',
63 description: 'build QGA VSS support (broken with MinGW)')
cb572714 64
aa087962
PB		 65option('malloc_trim', type : 'feature', value : 'auto',
66 description: 'enable libc malloc_trim() for memory optimization')
67option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'],
68 value: 'system', description: 'choose memory allocator to use')
69
1badb709
PB		 70option('kvm', type: 'feature', value: 'auto',
71 description: 'KVM acceleration support')
72option('hax', type: 'feature', value: 'auto',
73 description: 'HAX acceleration support')
74option('whpx', type: 'feature', value: 'auto',
75 description: 'WHPX acceleration support')
76option('hvf', type: 'feature', value: 'auto',
77 description: 'HVF acceleration support')
74a414a1
RZ		 78option('nvmm', type: 'feature', value: 'auto',
79 description: 'NVMM acceleration support')
1badb709
PB		 80option('xen', type: 'feature', value: 'auto',
81 description: 'Xen backend support')
82option('xen_pci_passthrough', type: 'feature', value: 'auto',
83 description: 'Xen PCI passthrough support')
0a31e3a0 84option('tcg', type: 'feature', value: 'enabled',
1badb709 85 description: 'TCG support')
23a77b2d 86option('tcg_interpreter', type: 'boolean', value: false,
f1f727ac 87 description: 'TCG with bytecode interpreter (slow)')
721fa5e5
PB		 88option('safe_stack', type: 'boolean', value: false,
89 description: 'SafeStack Stack Smash Protection (requires clang/llvm and coroutine backend ucontext)')
34f983d8
PB		 90option('sanitizers', type: 'boolean', value: false,
91 description: 'enable default sanitizers')
92option('tsan', type: 'boolean', value: false,
93 description: 'enable thread sanitizer')
911d4caa
PB		 94option('stack_protector', type: 'feature', value: 'auto',
95 description: 'compiler-provided stack protection')
0169815b 96option('cfi', type: 'boolean', value: false,
9e62ba48 97 description: 'Control-Flow Integrity (CFI)')
0169815b 98option('cfi_debug', type: 'boolean', value: false,
9e62ba48 99 description: 'Verbose errors in case of CFI violation')
106ad1f9
PB		 100option('multiprocess', type: 'feature', value: 'auto',
101 description: 'Out of process device emulation support')
55116968
JR		 102option('vfio_user_server', type: 'feature', value: 'disabled',
103 description: 'vfio-user server support')
142ca628
MAL		 104option('dbus_display', type: 'feature', value: 'auto',
105 description: '-display dbus support')
0d04c4c9
PB		 106option('tpm', type : 'feature', value : 'auto',
107 description: 'TPM support')
b87df904
PB		 108
109# Do not enable it by default even for Mingw32, because it doesn't
110# work on Wine.
111option('membarrier', type: 'feature', value: 'disabled',
112 description: 'membarrier system call (for Linux 4.14+ or Windows')
113
622753d2
PB		 114option('avx2', type: 'feature', value: 'auto',
115 description: 'AVX2 optimizations')
116option('avx512f', type: 'feature', value: 'disabled',
117 description: 'AVX512F optimizations')
04ffce13 118option('avx512bw', type: 'feature', value: 'auto',
119 description: 'AVX512BW optimizations')
2edd2c04
PB		 120option('keyring', type: 'feature', value: 'auto',
121 description: 'Linux keyring support')
1badb709 122
f7f2d651
PB		 123option('attr', type : 'feature', value : 'auto',
124 description: 'attr/xattr support')
05e391ae
PB		 125option('auth_pam', type : 'feature', value : 'auto',
126 description: 'PAM access control')
8c6d4ff4
PB		 127option('brlapi', type : 'feature', value : 'auto',
128 description: 'brlapi character device driver')
29ba6116
PB		 129option('bzip2', type : 'feature', value : 'auto',
130 description: 'bzip2 support for DMG images')
727c8bb8
PB		 131option('cap_ng', type : 'feature', value : 'auto',
132 description: 'cap_ng support')
fd66dbd4
SH		 133option('blkio', type : 'feature', value : 'auto',
134 description: 'libblkio block device driver')
46627f41
AM		 135option('bpf', type : 'feature', value : 'auto',
136 description: 'eBPF support')
b4e312e9
PB		 137option('cocoa', type : 'feature', value : 'auto',
138 description: 'Cocoa user interface (macOS only)')
f9cd86fe
PB		 139option('curl', type : 'feature', value : 'auto',
140 description: 'CURL block device driver')
7544060e
PB		 141option('gio', type : 'feature', value : 'auto',
142 description: 'use libgio for D-Bus support')
08821ca2
PB		 143option('glusterfs', type : 'feature', value : 'auto',
144 description: 'Glusterfs block device driver')
bc71d58f
IL		 145option('libdw', type : 'feature', value : 'auto',
146 description: 'debuginfo support')
9db405a3
PB		 147option('libiscsi', type : 'feature', value : 'auto',
148 description: 'libiscsi userspace initiator')
30045c05
PB		 149option('libnfs', type : 'feature', value : 'auto',
150 description: 'libnfs block device driver')
6ec0e15d
PB		 151option('mpath', type : 'feature', value : 'auto',
152 description: 'Multipath persistent reservation passthrough')
488a8c73
PB		 153option('numa', type : 'feature', value : 'auto',
154 description: 'libnuma support')
5285e593
YL		 155option('iconv', type : 'feature', value : 'auto',
156 description: 'Font glyph conversion support')
157option('curses', type : 'feature', value : 'auto',
158 description: 'curses UI')
57612511
PB		 159option('gnutls', type : 'feature', value : 'auto',
160 description: 'GNUTLS cryptography support')
161option('nettle', type : 'feature', value : 'auto',
162 description: 'nettle cryptography support')
163option('gcrypt', type : 'feature', value : 'auto',
164 description: 'libgcrypt cryptography support')
34b52615
PB		 165option('crypto_afalg', type : 'feature', value : 'disabled',
166 description: 'Linux AF_ALG crypto backend driver')
83ef1682
PB		 167option('libdaxctl', type : 'feature', value : 'auto',
168 description: 'libdaxctl support')
e36e8c70
PB		 169option('libpmem', type : 'feature', value : 'auto',
170 description: 'libpmem support')
e6a52b36
TH		 171option('libssh', type : 'feature', value : 'auto',
172 description: 'ssh block device support')
5c53015a
PB		 173option('libudev', type : 'feature', value : 'auto',
174 description: 'Use libudev to enumerate host devices')
90540f32
PB		 175option('libusb', type : 'feature', value : 'auto',
176 description: 'libusb support for USB passthrough')
ff66f3e5
PB		 177option('linux_aio', type : 'feature', value : 'auto',
178 description: 'Linux AIO support')
53c22b68
PB		 179option('linux_io_uring', type : 'feature', value : 'auto',
180 description: 'Linux io_uring support')
ecea3696
PB		 181option('lzfse', type : 'feature', value : 'auto',
182 description: 'lzfse support for DMG images')
0c32a0ae
PB		 183option('lzo', type : 'feature', value : 'auto',
184 description: 'lzo compression support')
fabd1e93
PB		 185option('rbd', type : 'feature', value : 'auto',
186 description: 'Ceph block device driver')
88b6e618
PB		 187option('opengl', type : 'feature', value : 'auto',
188 description: 'OpenGL support')
3730a734
PB		 189option('rdma', type : 'feature', value : 'auto',
190 description: 'Enable RDMA-based migration')
191option('pvrdma', type : 'feature', value : 'auto',
192 description: 'Enable PVRDMA support')
1b695471
PB		 193option('gtk', type : 'feature', value : 'auto',
194 description: 'GTK+ user interface')
cb572714
PB		 195option('sdl', type : 'feature', value : 'auto',
196 description: 'SDL user interface')
197option('sdl_image', type : 'feature', value : 'auto',
198 description: 'SDL Image support for icons')
90835c2b
PB		 199option('seccomp', type : 'feature', value : 'auto',
200 description: 'seccomp support')
5f364c57
PB		 201option('smartcard', type : 'feature', value : 'auto',
202 description: 'CA smartcard emulation support')
241611ea
PB		 203option('snappy', type : 'feature', value : 'auto',
204 description: 'snappy compression support')
3f0a5d55
MAL		 205option('spice', type : 'feature', value : 'auto',
206 description: 'Spice server support')
207option('spice_protocol', type : 'feature', value : 'auto',
208 description: 'Spice protocol support')
cb572714
PB		 209option('u2f', type : 'feature', value : 'auto',
210 description: 'U2F emulation support')
8caef850
HZZ		 211option('canokey', type : 'feature', value : 'auto',
212 description: 'CanoKey support')
18f31e60
PB		 213option('usb_redir', type : 'feature', value : 'auto',
214 description: 'libusbredir support')
eea9453a
TH		 215option('l2tpv3', type : 'feature', value : 'auto',
216 description: 'l2tpv3 network backend support')
837b84b1
PB		 217option('netmap', type : 'feature', value : 'auto',
218 description: 'netmap network backend support')
5890258a
TH		 219option('slirp', type: 'feature', value: 'auto',
220 description: 'libslirp user mode network backend support')
e1723999
PB		 221option('vde', type : 'feature', value : 'auto',
222 description: 'vde network backend support')
e2c1d78d
VY		 223option('vmnet', type : 'feature', value : 'auto',
224 description: 'vmnet.framework network backend support')
587d59d6
PB		 225option('virglrenderer', type : 'feature', value : 'auto',
226 description: 'virgl rendering support')
95f8510e
KS		 227option('png', type : 'feature', value : 'auto',
228 description: 'PNG support with libpng')
c1de5858 229option('vnc', type : 'feature', value : 'auto',
cb572714
PB		 230 description: 'VNC server')
231option('vnc_jpeg', type : 'feature', value : 'auto',
232 description: 'JPEG lossy compression for VNC server')
cb572714
PB		 233option('vnc_sasl', type : 'feature', value : 'auto',
234 description: 'SASL authentication for VNC server')
c23d7b4e
PB		 235option('vte', type : 'feature', value : 'auto',
236 description: 'vte support for the gtk UI')
29e0bfff
CF		 237
238# GTK Clipboard implementation is disabled by default, since it may cause hangs
239# of the guest VCPUs. See gitlab issue 1150:
240# https://gitlab.com/qemu-project/qemu/-/issues/1150
241
242option('gtk_clipboard', type: 'feature', value : 'disabled',
243 description: 'clipboard support for the gtk UI (EXPERIMENTAL, MAY HANG)')
cb572714
PB		 244option('xkbcommon', type : 'feature', value : 'auto',
245 description: 'xkbcommon support')
b1def33d
PB		 246option('zstd', type : 'feature', value : 'auto',
247 description: 'zstd compression support')
a484a719
HR		 248option('fuse', type: 'feature', value: 'auto',
249 description: 'FUSE block device export')
df4ea709
HR		 250option('fuse_lseek', type : 'feature', value : 'auto',
251 description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports')
8b18cdbf 252
9c29b741
PB		 253option('trace_backends', type: 'array', value: ['log'],
254 choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'],
255 description: 'Set available tracing backends')
256
87430d5b
PB		 257option('alsa', type: 'feature', value: 'auto',
258 description: 'ALSA sound support')
259option('coreaudio', type: 'feature', value: 'auto',
260 description: 'CoreAudio sound support')
261option('dsound', type: 'feature', value: 'auto',
262 description: 'DirectSound sound support')
263option('jack', type: 'feature', value: 'auto',
264 description: 'JACK sound support')
265option('oss', type: 'feature', value: 'auto',
266 description: 'OSS sound support')
267option('pa', type: 'feature', value: 'auto',
268 description: 'PulseAudio sound support')
c2d3d1c2 269option('pipewire', type: 'feature', value: 'auto',
20c51248 270 description: 'PipeWire sound support')
663df1cc
AR		 271option('sndio', type: 'feature', value: 'auto',
272 description: 'sndio sound support')
87430d5b 273
2df89d54
PB		 274option('vhost_kernel', type: 'feature', value: 'auto',
275 description: 'vhost kernel backend support')
276option('vhost_net', type: 'feature', value: 'auto',
277 description: 'vhost-net kernel acceleration support')
278option('vhost_user', type: 'feature', value: 'auto',
279 description: 'vhost-user backend support')
280option('vhost_crypto', type: 'feature', value: 'auto',
281 description: 'vhost-user crypto backend support')
282option('vhost_vdpa', type: 'feature', value: 'auto',
283 description: 'vhost-vdpa kernel backend support')
69202b40
PB		 284option('vhost_user_blk_server', type: 'feature', value: 'auto',
285 description: 'build vhost-user-blk server')
286option('virtfs', type: 'feature', value: 'auto',
287 description: 'virtio-9p support')
1a67e07f
PF		 288option('virtfs_proxy_helper', type: 'feature', value: 'auto',
289 description: 'virtio-9p proxy helper support')
a6caeee8
XY		 290option('libvduse', type: 'feature', value: 'auto',
291 description: 'build VDUSE Library')
2a2359b8
XY		 292option('vduse_blk_export', type: 'feature', value: 'auto',
293 description: 'VDUSE block export support')
69202b40 294
83602083 295option('capstone', type: 'feature', value: 'auto',
8b18cdbf 296 description: 'Whether and how to find the capstone library')
fbb4121d
PB		 297option('fdt', type: 'combo', value: 'auto',
298 choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
299 description: 'Whether and how to find the libfdt library')
3d212b41
RJ		 300
301option('selinux', type: 'feature', value: 'auto',
302 description: 'SELinux support in qemu-nbd')
406523f6
PB		 303option('live_block_migration', type: 'feature', value: 'auto',
304 description: 'block migration in the main migration stream')
305option('replication', type: 'feature', value: 'auto',
306 description: 'replication support')
6c1e3906
VSO		 307option('colo_proxy', type: 'feature', value: 'auto',
308 description: 'colo-proxy support')
ed793c2c
PB		 309option('bochs', type: 'feature', value: 'auto',
310 description: 'bochs image format support')
311option('cloop', type: 'feature', value: 'auto',
312 description: 'cloop image format support')
313option('dmg', type: 'feature', value: 'auto',
314 description: 'dmg image format support')
315option('qcow1', type: 'feature', value: 'auto',
316 description: 'qcow1 image format support')
317option('vdi', type: 'feature', value: 'auto',
318 description: 'vdi image format support')
11cea42e
VSO		 319option('vhdx', type: 'feature', value: 'auto',
320 description: 'vhdx image format support')
321option('vmdk', type: 'feature', value: 'auto',
322 description: 'vmdk image format support')
323option('vpc', type: 'feature', value: 'auto',
324 description: 'vpc image format support')
ed793c2c
PB		 325option('vvfat', type: 'feature', value: 'auto',
326 description: 'vvfat image format support')
327option('qed', type: 'feature', value: 'auto',
328 description: 'qed image format support')
329option('parallels', type: 'feature', value: 'auto',
330 description: 'parallels image format support')
c55cf6ab
PB		 331option('block_drv_whitelist_in_tools', type: 'boolean', value: false,
332 description: 'use block whitelist also in tools instead of only QEMU')
333option('rng_none', type: 'boolean', value: false,
334 description: 'dummy RNG, avoid using /dev/(u)random and getrandom()')
728c0a2f
PB		 335option('coroutine_pool', type: 'boolean', value: true,
336 description: 'coroutine freelist (better performance)')
58a2e3f5
SH		 337option('debug_graph_lock', type: 'boolean', value: false,
338 description: 'graph lock debugging support')
c55cf6ab
PB		 339option('debug_mutex', type: 'boolean', value: false,
340 description: 'mutex debugging support')
728c0a2f
PB		 341option('debug_stack_usage', type: 'boolean', value: false,
342 description: 'measure coroutine stack usage')
0f220121 343option('qom_cast_debug', type: 'boolean', value: true,
c55cf6ab
PB		 344 description: 'cast debugging support')
345option('gprof', type: 'boolean', value: false,
bb9ecae7
AB		 346 description: 'QEMU profiling with gprof',
347 deprecated: true)
35acbb30
PB		 348option('slirp_smbd', type : 'feature', value : 'auto',
349 description: 'use smbd (at path --smbd=*) in slirp networking')
7c19dcc5
ADF		 350
351option('hexagon_idef_parser', type : 'boolean', value : true,
352 description: 'use idef-parser to automatically generate TCG code for the Hexagon frontend')
QEMU mirror