xref: /qemu/meson_options.txt (revision c4b8ffcb)
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
5option('qemu_suffix', type : 'string', value: 'qemu',
6       description: 'Suffix for QEMU data/modules/config directories (can be empty)')
7option('docdir', type : 'string', value : 'share/doc',
8       description: 'Base directory for documentation installation (can be empty)')
9option('qemu_firmwarepath', type : 'string', value : 'qemu-firmware',
10       description: 'search PATH for firmware files')
11option('pkgversion', type : 'string', value : '',
12       description: 'use specified string as sub-version of the package')
13option('smbd', type : 'string', value : '',
14       description: 'Path to smbd for slirp networking')
15option('sphinx_build', type : 'string', value : '',
16       description: 'Use specified sphinx-build for building document')
17option('iasl', type : 'string', value : '',
18       description: 'Path to ACPI disassembler')
19option('tls_priority', type : 'string', value : 'NORMAL',
20       description: 'Default TLS protocol/cipher priority string')
21option('default_devices', type : 'boolean', value : true,
22       description: 'Include a default selection of devices in emulators')
23option('audio_drv_list', type: 'array', value: ['default'],
24       choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'sdl'],
25       description: 'Set audio driver list')
26option('block_drv_rw_whitelist', type : 'string', value : '',
27       description: 'set block driver read-write whitelist (by default affects only QEMU, not tools like qemu-img)')
28option('block_drv_ro_whitelist', type : 'string', value : '',
29       description: 'set block driver read-only whitelist (by default affects only QEMU, not tools like qemu-img)')
30option('interp_prefix', type : 'string', value : '/usr/gnemul/qemu-%M',
31       description: 'where to find shared libraries etc., use %M for cpu name')
32option('fuzzing_engine', type : 'string', value : '',
33       description: 'fuzzing engine library for OSS-Fuzz')
34option('trace_file', type: 'string', value: 'trace',
35       description: 'Trace file prefix for simple backend')
36
37# Everything else can be set via --enable/--disable-* option
38# on the configure script command line.  After adding an option
39# here make sure to run "make update-buildoptions".
40
41option('docs', type : 'feature', value : 'auto',
42       description: 'Documentations build support')
43option('fuzzing', type : 'boolean', value: false,
44       description: 'build fuzzing targets')
45option('gettext', type : 'feature', value : 'auto',
46       description: 'Localization of the GTK+ user interface')
47option('module_upgrades', type : 'boolean', value : false,
48       description: 'try to load modules from alternate paths for upgrades')
49option('install_blobs', type : 'boolean', value : true,
50       description: 'install provided firmware blobs')
51option('sparse', type : 'feature', value : 'auto',
52       description: 'sparse checker')
53option('guest_agent', type : 'feature', value : 'auto',
54       description: 'Build QEMU Guest Agent')
55option('guest_agent_msi', type : 'feature', value : 'auto',
56       description: 'Build MSI package for the QEMU Guest Agent')
57option('tools', type : 'feature', value : 'auto',
58       description: 'build support utilities that come with QEMU')
59option('qga_vss', type : 'feature', value: 'auto',
60       description: 'build QGA VSS support (broken with MinGW)')
61
62option('malloc_trim', type : 'feature', value : 'auto',
63       description: 'enable libc malloc_trim() for memory optimization')
64option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'],
65       value: 'system', description: 'choose memory allocator to use')
66
67option('kvm', type: 'feature', value: 'auto',
68       description: 'KVM acceleration support')
69option('hax', type: 'feature', value: 'auto',
70       description: 'HAX acceleration support')
71option('whpx', type: 'feature', value: 'auto',
72       description: 'WHPX acceleration support')
73option('hvf', type: 'feature', value: 'auto',
74       description: 'HVF acceleration support')
75option('nvmm', type: 'feature', value: 'auto',
76       description: 'NVMM acceleration support')
77option('xen', type: 'feature', value: 'auto',
78       description: 'Xen backend support')
79option('xen_pci_passthrough', type: 'feature', value: 'auto',
80       description: 'Xen PCI passthrough support')
81option('tcg', type: 'feature', value: 'enabled',
82       description: 'TCG support')
83option('tcg_interpreter', type: 'boolean', value: false,
84       description: 'TCG with bytecode interpreter (slow)')
85option('cfi', type: 'boolean', value: 'false',
86       description: 'Control-Flow Integrity (CFI)')
87option('cfi_debug', type: 'boolean', value: 'false',
88       description: 'Verbose errors in case of CFI violation')
89option('multiprocess', type: 'feature', value: 'auto',
90       description: 'Out of process device emulation support')
91option('dbus_display', type: 'feature', value: 'auto',
92       description: '-display dbus support')
93option('tpm', type : 'feature', value : 'auto',
94       description: 'TPM support')
95
96# Do not enable it by default even for Mingw32, because it doesn't
97# work on Wine.
98option('membarrier', type: 'feature', value: 'disabled',
99       description: 'membarrier system call (for Linux 4.14+ or Windows')
100
101option('avx2', type: 'feature', value: 'auto',
102       description: 'AVX2 optimizations')
103option('avx512f', type: 'feature', value: 'disabled',
104       description: 'AVX512F optimizations')
105option('keyring', type: 'feature', value: 'auto',
106       description: 'Linux keyring support')
107
108option('attr', type : 'feature', value : 'auto',
109       description: 'attr/xattr support')
110option('auth_pam', type : 'feature', value : 'auto',
111       description: 'PAM access control')
112option('brlapi', type : 'feature', value : 'auto',
113       description: 'brlapi character device driver')
114option('bzip2', type : 'feature', value : 'auto',
115       description: 'bzip2 support for DMG images')
116option('cap_ng', type : 'feature', value : 'auto',
117       description: 'cap_ng support')
118option('bpf', type : 'feature', value : 'auto',
119        description: 'eBPF support')
120option('cocoa', type : 'feature', value : 'auto',
121       description: 'Cocoa user interface (macOS only)')
122option('curl', type : 'feature', value : 'auto',
123       description: 'CURL block device driver')
124option('gio', type : 'feature', value : 'auto',
125       description: 'use libgio for D-Bus support')
126option('glusterfs', type : 'feature', value : 'auto',
127       description: 'Glusterfs block device driver')
128option('libiscsi', type : 'feature', value : 'auto',
129       description: 'libiscsi userspace initiator')
130option('libnfs', type : 'feature', value : 'auto',
131       description: 'libnfs block device driver')
132option('mpath', type : 'feature', value : 'auto',
133       description: 'Multipath persistent reservation passthrough')
134option('numa', type : 'feature', value : 'auto',
135       description: 'libnuma support')
136option('iconv', type : 'feature', value : 'auto',
137       description: 'Font glyph conversion support')
138option('curses', type : 'feature', value : 'auto',
139       description: 'curses UI')
140option('gnutls', type : 'feature', value : 'auto',
141       description: 'GNUTLS cryptography support')
142option('nettle', type : 'feature', value : 'auto',
143       description: 'nettle cryptography support')
144option('gcrypt', type : 'feature', value : 'auto',
145       description: 'libgcrypt cryptography support')
146option('crypto_afalg', type : 'feature', value : 'disabled',
147       description: 'Linux AF_ALG crypto backend driver')
148option('libdaxctl', type : 'feature', value : 'auto',
149       description: 'libdaxctl support')
150option('libpmem', type : 'feature', value : 'auto',
151       description: 'libpmem support')
152option('libssh', type : 'feature', value : 'auto',
153       description: 'ssh block device support')
154option('libudev', type : 'feature', value : 'auto',
155       description: 'Use libudev to enumerate host devices')
156option('libusb', type : 'feature', value : 'auto',
157       description: 'libusb support for USB passthrough')
158option('linux_aio', type : 'feature', value : 'auto',
159       description: 'Linux AIO support')
160option('linux_io_uring', type : 'feature', value : 'auto',
161       description: 'Linux io_uring support')
162option('lzfse', type : 'feature', value : 'auto',
163       description: 'lzfse support for DMG images')
164option('lzo', type : 'feature', value : 'auto',
165       description: 'lzo compression support')
166option('rbd', type : 'feature', value : 'auto',
167       description: 'Ceph block device driver')
168option('opengl', type : 'feature', value : 'auto',
169       description: 'OpenGL support')
170option('rdma', type : 'feature', value : 'auto',
171       description: 'Enable RDMA-based migration')
172option('pvrdma', type : 'feature', value : 'auto',
173       description: 'Enable PVRDMA support')
174option('gtk', type : 'feature', value : 'auto',
175       description: 'GTK+ user interface')
176option('sdl', type : 'feature', value : 'auto',
177       description: 'SDL user interface')
178option('sdl_image', type : 'feature', value : 'auto',
179       description: 'SDL Image support for icons')
180option('seccomp', type : 'feature', value : 'auto',
181       description: 'seccomp support')
182option('smartcard', type : 'feature', value : 'auto',
183       description: 'CA smartcard emulation support')
184option('snappy', type : 'feature', value : 'auto',
185       description: 'snappy compression support')
186option('spice', type : 'feature', value : 'auto',
187       description: 'Spice server support')
188option('spice_protocol', type : 'feature', value : 'auto',
189       description: 'Spice protocol support')
190option('u2f', type : 'feature', value : 'auto',
191       description: 'U2F emulation support')
192option('usb_redir', type : 'feature', value : 'auto',
193       description: 'libusbredir support')
194option('l2tpv3', type : 'feature', value : 'auto',
195       description: 'l2tpv3 network backend support')
196option('netmap', type : 'feature', value : 'auto',
197       description: 'netmap network backend support')
198option('vde', type : 'feature', value : 'auto',
199       description: 'vde network backend support')
200option('vmnet', type : 'feature', value : 'auto',
201       description: 'vmnet.framework network backend support')
202option('virglrenderer', type : 'feature', value : 'auto',
203       description: 'virgl rendering support')
204option('png', type : 'feature', value : 'auto',
205       description: 'PNG support with libpng')
206option('vnc', type : 'feature', value : 'auto',
207       description: 'VNC server')
208option('vnc_jpeg', type : 'feature', value : 'auto',
209       description: 'JPEG lossy compression for VNC server')
210option('vnc_sasl', type : 'feature', value : 'auto',
211       description: 'SASL authentication for VNC server')
212option('vte', type : 'feature', value : 'auto',
213       description: 'vte support for the gtk UI')
214option('xkbcommon', type : 'feature', value : 'auto',
215       description: 'xkbcommon support')
216option('zstd', type : 'feature', value : 'auto',
217       description: 'zstd compression support')
218option('fuse', type: 'feature', value: 'auto',
219       description: 'FUSE block device export')
220option('fuse_lseek', type : 'feature', value : 'auto',
221       description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports')
222
223option('trace_backends', type: 'array', value: ['log'],
224       choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'],
225       description: 'Set available tracing backends')
226
227option('alsa', type: 'feature', value: 'auto',
228       description: 'ALSA sound support')
229option('coreaudio', type: 'feature', value: 'auto',
230       description: 'CoreAudio sound support')
231option('dsound', type: 'feature', value: 'auto',
232       description: 'DirectSound sound support')
233option('jack', type: 'feature', value: 'auto',
234       description: 'JACK sound support')
235option('oss', type: 'feature', value: 'auto',
236       description: 'OSS sound support')
237option('pa', type: 'feature', value: 'auto',
238       description: 'PulseAudio sound support')
239
240option('vhost_kernel', type: 'feature', value: 'auto',
241       description: 'vhost kernel backend support')
242option('vhost_net', type: 'feature', value: 'auto',
243       description: 'vhost-net kernel acceleration support')
244option('vhost_user', type: 'feature', value: 'auto',
245       description: 'vhost-user backend support')
246option('vhost_crypto', type: 'feature', value: 'auto',
247       description: 'vhost-user crypto backend support')
248option('vhost_vdpa', type: 'feature', value: 'auto',
249       description: 'vhost-vdpa kernel backend support')
250option('vhost_user_blk_server', type: 'feature', value: 'auto',
251       description: 'build vhost-user-blk server')
252option('virtfs', type: 'feature', value: 'auto',
253       description: 'virtio-9p support')
254option('virtiofsd', type: 'feature', value: 'auto',
255       description: 'build virtiofs daemon (virtiofsd)')
256
257option('capstone', type: 'feature', value: 'auto',
258       description: 'Whether and how to find the capstone library')
259option('slirp', type: 'combo', value: 'auto',
260       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
261       description: 'Whether and how to find the slirp library')
262option('fdt', type: 'combo', value: 'auto',
263       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
264       description: 'Whether and how to find the libfdt library')
265
266option('selinux', type: 'feature', value: 'auto',
267       description: 'SELinux support in qemu-nbd')
268option('live_block_migration', type: 'feature', value: 'auto',
269       description: 'block migration in the main migration stream')
270option('replication', type: 'feature', value: 'auto',
271       description: 'replication support')
272option('bochs', type: 'feature', value: 'auto',
273       description: 'bochs image format support')
274option('cloop', type: 'feature', value: 'auto',
275       description: 'cloop image format support')
276option('dmg', type: 'feature', value: 'auto',
277       description: 'dmg image format support')
278option('qcow1', type: 'feature', value: 'auto',
279       description: 'qcow1 image format support')
280option('vdi', type: 'feature', value: 'auto',
281       description: 'vdi image format support')
282option('vvfat', type: 'feature', value: 'auto',
283       description: 'vvfat image format support')
284option('qed', type: 'feature', value: 'auto',
285       description: 'qed image format support')
286option('parallels', type: 'feature', value: 'auto',
287       description: 'parallels image format support')
288option('block_drv_whitelist_in_tools', type: 'boolean', value: false,
289       description: 'use block whitelist also in tools instead of only QEMU')
290option('rng_none', type: 'boolean', value: false,
291       description: 'dummy RNG, avoid using /dev/(u)random and getrandom()')
292option('coroutine_pool', type: 'boolean', value: true,
293       description: 'coroutine freelist (better performance)')
294option('debug_mutex', type: 'boolean', value: false,
295       description: 'mutex debugging support')
296option('debug_stack_usage', type: 'boolean', value: false,
297       description: 'measure coroutine stack usage')
298option('qom_cast_debug', type: 'boolean', value: false,
299       description: 'cast debugging support')
300option('gprof', type: 'boolean', value: false,
301       description: 'QEMU profiling with gprof')
302option('profiler', type: 'boolean', value: false,
303       description: 'profiler support')
304option('slirp_smbd', type : 'feature', value : 'auto',
305       description: 'use smbd (at path --smbd=*) in slirp networking')
306