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