| 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('iasl', type : 'string', value : '', |
| 16 | description: 'Path to ACPI disassembler') |
| 17 | option('tls_priority', type : 'string', value : 'NORMAL', |
| 18 | description: 'Default TLS protocol/cipher priority string') |
| 19 | option('default_devices', type : 'boolean', value : true, |
| 20 | description: 'Include a default selection of devices in emulators') |
| 21 | option('audio_drv_list', type: 'array', value: ['default'], |
| 22 | choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'pipewire', 'sdl', 'sndio'], |
| 23 | description: 'Set audio driver list') |
| 24 | option('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)') |
| 26 | option('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)') |
| 28 | option('interp_prefix', type : 'string', value : '/usr/gnemul/qemu-%M', |
| 29 | description: 'where to find shared libraries etc., use %M for cpu name') |
| 30 | option('rtsig_map', type : 'string', value : 'NULL', |
| 31 | description: 'default value of QEMU_RTSIG_MAP') |
| 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 | option('coroutine_backend', type: 'combo', |
| 37 | choices: ['ucontext', 'sigaltstack', 'windows', 'wasm', 'auto'], |
| 38 | value: 'auto', description: 'coroutine backend to use') |
| 39 | option('gdb', type: 'string', value: '', |
| 40 | description: 'Path to GDB') |
| 41 | |
| 42 | # Everything else can be set via --enable/--disable-* option |
| 43 | # on the configure script command line. After adding an option |
| 44 | # here make sure to run "make update-buildoptions". |
| 45 | |
| 46 | option('docs', type : 'feature', value : 'auto', |
| 47 | description: 'Documentations build support') |
| 48 | option('fuzzing', type : 'boolean', value: false, |
| 49 | description: 'build fuzzing targets') |
| 50 | option('gettext', type : 'feature', value : 'auto', |
| 51 | description: 'Localization of the GTK+ user interface') |
| 52 | option('modules', type : 'feature', value : 'disabled', |
| 53 | description: 'modules support (non Windows)') |
| 54 | option('module_upgrades', type : 'boolean', value : false, |
| 55 | description: 'try to load modules from alternate paths for upgrades') |
| 56 | option('install_blobs', type : 'boolean', value : true, |
| 57 | description: 'install provided firmware blobs') |
| 58 | option('sparse', type : 'feature', value : 'auto', |
| 59 | description: 'sparse checker') |
| 60 | option('guest_agent', type : 'feature', value : 'auto', |
| 61 | description: 'Build QEMU Guest Agent') |
| 62 | option('guest_agent_msi', type : 'feature', value : 'auto', |
| 63 | description: 'Build MSI package for the QEMU Guest Agent') |
| 64 | option('tools', type : 'feature', value : 'auto', |
| 65 | description: 'build support utilities that come with QEMU') |
| 66 | option('qga_vss', type : 'feature', value: 'auto', |
| 67 | description: 'build QGA VSS support (broken with MinGW)') |
| 68 | |
| 69 | option('malloc_trim', type : 'feature', value : 'auto', |
| 70 | description: 'enable libc malloc_trim() for memory optimization') |
| 71 | option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'], |
| 72 | value: 'system', description: 'choose memory allocator to use') |
| 73 | |
| 74 | option('kvm', type: 'feature', value: 'auto', |
| 75 | description: 'KVM acceleration support') |
| 76 | option('mshv', type: 'feature', value: 'auto', |
| 77 | description: 'MSHV acceleration support') |
| 78 | option('whpx', type: 'feature', value: 'auto', |
| 79 | description: 'WHPX acceleration support') |
| 80 | option('hvf', type: 'feature', value: 'auto', |
| 81 | description: 'HVF acceleration support') |
| 82 | option('nitro', type: 'feature', value: 'auto', |
| 83 | description: 'Nitro acceleration support') |
| 84 | option('nvmm', type: 'feature', value: 'auto', |
| 85 | description: 'NVMM acceleration support') |
| 86 | option('xen', type: 'feature', value: 'auto', |
| 87 | description: 'Xen backend support') |
| 88 | option('xen_pci_passthrough', type: 'feature', value: 'auto', |
| 89 | description: 'Xen PCI passthrough support') |
| 90 | option('tcg', type: 'feature', value: 'enabled', |
| 91 | description: 'TCG support') |
| 92 | option('plugins', type: 'boolean', value: false, |
| 93 | description: 'TCG plugins via shared library loading') |
| 94 | option('debug_tcg', type: 'boolean', value: false, |
| 95 | description: 'TCG debugging') |
| 96 | option('debug_remap', type: 'boolean', value: false, |
| 97 | description: 'syscall buffer debugging support') |
| 98 | option('tcg_interpreter', type: 'boolean', value: false, |
| 99 | description: 'TCG with bytecode interpreter (slow)') |
| 100 | option('safe_stack', type: 'boolean', value: false, |
| 101 | description: 'SafeStack Stack Smash Protection (requires clang/llvm and coroutine backend ucontext)') |
| 102 | option('asan', type: 'boolean', value: false, |
| 103 | description: 'enable address sanitizer') |
| 104 | option('ubsan', type: 'boolean', value: false, |
| 105 | description: 'enable undefined behaviour sanitizer') |
| 106 | option('tsan', type: 'boolean', value: false, |
| 107 | description: 'enable thread sanitizer') |
| 108 | option('stack_protector', type: 'feature', value: 'auto', |
| 109 | description: 'compiler-provided stack protection') |
| 110 | option('cfi', type: 'boolean', value: false, |
| 111 | description: 'Control-Flow Integrity (CFI)') |
| 112 | option('cfi_debug', type: 'boolean', value: false, |
| 113 | description: 'Verbose errors in case of CFI violation') |
| 114 | option('hmp', type : 'feature', value : 'auto', |
| 115 | description: 'HMP monitor support') |
| 116 | option('multiprocess', type: 'feature', value: 'auto', |
| 117 | description: 'Out of process device emulation support') |
| 118 | option('relocatable', type : 'boolean', value : true, |
| 119 | description: 'toggle relocatable install') |
| 120 | option('vfio_user_server', type: 'feature', value: 'disabled', |
| 121 | description: 'vfio-user server support') |
| 122 | option('dbus_display', type: 'feature', value: 'auto', |
| 123 | description: '-display dbus support') |
| 124 | option('qemu_vnc', type: 'feature', value: 'auto', |
| 125 | description: 'standalone VNC server over D-Bus') |
| 126 | option('tpm', type : 'feature', value : 'auto', |
| 127 | description: 'TPM support') |
| 128 | option('valgrind', type : 'feature', value: 'auto', |
| 129 | description: 'valgrind debug support for coroutine stacks') |
| 130 | option('igvm', type: 'feature', value: 'auto', |
| 131 | description: 'Independent Guest Virtual Machine (IGVM) file support') |
| 132 | |
| 133 | # Do not enable it by default even for Mingw32, because it doesn't |
| 134 | # work on Wine. |
| 135 | option('membarrier', type: 'feature', value: 'disabled', |
| 136 | description: 'membarrier system call (for Linux 4.14+ or Windows') |
| 137 | |
| 138 | option('keyring', type: 'feature', value: 'auto', |
| 139 | description: 'Linux keyring support') |
| 140 | option('libkeyutils', type: 'feature', value: 'auto', |
| 141 | description: 'Linux keyutils support') |
| 142 | |
| 143 | option('af_xdp', type : 'feature', value : 'auto', |
| 144 | description: 'AF_XDP network backend support') |
| 145 | option('attr', type : 'feature', value : 'auto', |
| 146 | description: 'attr/xattr support') |
| 147 | option('auth_pam', type : 'feature', value : 'auto', |
| 148 | description: 'PAM access control') |
| 149 | option('brlapi', type : 'feature', value : 'auto', |
| 150 | description: 'brlapi character device driver') |
| 151 | option('bzip2', type : 'feature', value : 'auto', |
| 152 | description: 'bzip2 support for DMG images') |
| 153 | option('cap_ng', type : 'feature', value : 'auto', |
| 154 | description: 'cap_ng support') |
| 155 | option('blkio', type : 'feature', value : 'auto', |
| 156 | description: 'libblkio block device driver') |
| 157 | option('bpf', type : 'feature', value : 'auto', |
| 158 | description: 'eBPF support') |
| 159 | option('cocoa', type : 'feature', value : 'auto', |
| 160 | description: 'Cocoa user interface (macOS only)') |
| 161 | option('curl', type : 'feature', value : 'auto', |
| 162 | description: 'CURL block device driver') |
| 163 | option('gio', type : 'feature', value : 'auto', |
| 164 | description: 'use libgio for D-Bus support') |
| 165 | option('hv_balloon', type : 'feature', value : 'auto', |
| 166 | description: 'hv-balloon driver (requires Glib 2.68+ GTree API)') |
| 167 | option('libdw', type : 'feature', value : 'auto', |
| 168 | description: 'debuginfo support') |
| 169 | option('libiscsi', type : 'feature', value : 'auto', |
| 170 | description: 'libiscsi userspace initiator') |
| 171 | option('libnfs', type : 'feature', value : 'auto', |
| 172 | description: 'libnfs block device driver') |
| 173 | option('mpath', type : 'feature', value : 'auto', |
| 174 | description: 'Multipath persistent reservation passthrough') |
| 175 | option('numa', type : 'feature', value : 'auto', |
| 176 | description: 'libnuma support') |
| 177 | option('iconv', type : 'feature', value : 'auto', |
| 178 | description: 'Font glyph conversion support') |
| 179 | option('curses', type : 'feature', value : 'auto', |
| 180 | description: 'curses UI') |
| 181 | option('libcbor', type : 'feature', value : 'auto', |
| 182 | description: 'libcbor support') |
| 183 | option('gnutls', type : 'feature', value : 'auto', |
| 184 | description: 'GNUTLS cryptography support') |
| 185 | option('nettle', type : 'feature', value : 'auto', |
| 186 | description: 'nettle cryptography support') |
| 187 | option('gcrypt', type : 'feature', value : 'auto', |
| 188 | description: 'libgcrypt cryptography support') |
| 189 | option('crypto_afalg', type : 'feature', value : 'disabled', |
| 190 | description: 'Linux AF_ALG crypto backend driver') |
| 191 | option('libdaxctl', type : 'feature', value : 'auto', |
| 192 | description: 'libdaxctl support') |
| 193 | option('libpmem', type : 'feature', value : 'auto', |
| 194 | description: 'libpmem support') |
| 195 | option('libssh', type : 'feature', value : 'auto', |
| 196 | description: 'ssh block device support') |
| 197 | option('libudev', type : 'feature', value : 'auto', |
| 198 | description: 'Use libudev to enumerate host devices') |
| 199 | option('libusb', type : 'feature', value : 'auto', |
| 200 | description: 'libusb support for USB passthrough') |
| 201 | option('linux_aio', type : 'feature', value : 'auto', |
| 202 | description: 'Linux AIO support') |
| 203 | option('linux_io_uring', type : 'feature', value : 'auto', |
| 204 | description: 'Linux io_uring support') |
| 205 | option('lzfse', type : 'feature', value : 'auto', |
| 206 | description: 'lzfse support for DMG images') |
| 207 | option('lzo', type : 'feature', value : 'auto', |
| 208 | description: 'lzo compression support') |
| 209 | option('pvg', type: 'feature', value: 'auto', |
| 210 | description: 'macOS paravirtualized graphics support') |
| 211 | option('rbd', type : 'feature', value : 'auto', |
| 212 | description: 'Ceph block device driver') |
| 213 | option('opengl', type : 'feature', value : 'auto', |
| 214 | description: 'OpenGL support') |
| 215 | option('rdma', type : 'feature', value : 'auto', |
| 216 | description: 'Enable RDMA-based migration') |
| 217 | option('gtk', type : 'feature', value : 'auto', |
| 218 | description: 'GTK+ user interface') |
| 219 | option('sdl', type : 'feature', value : 'auto', |
| 220 | description: 'SDL user interface') |
| 221 | option('sdl_image', type : 'feature', value : 'auto', |
| 222 | description: 'SDL Image support for icons') |
| 223 | option('seccomp', type : 'feature', value : 'auto', |
| 224 | description: 'seccomp support') |
| 225 | option('smartcard', type : 'feature', value : 'auto', |
| 226 | description: 'CA smartcard emulation support') |
| 227 | option('snappy', type : 'feature', value : 'auto', |
| 228 | description: 'snappy compression support') |
| 229 | option('spice', type : 'feature', value : 'auto', |
| 230 | description: 'Spice server support') |
| 231 | option('spice_protocol', type : 'feature', value : 'auto', |
| 232 | description: 'Spice protocol support') |
| 233 | option('u2f', type : 'feature', value : 'auto', |
| 234 | description: 'U2F emulation support') |
| 235 | option('canokey', type : 'feature', value : 'auto', |
| 236 | description: 'CanoKey support') |
| 237 | option('usb_redir', type : 'feature', value : 'auto', |
| 238 | description: 'libusbredir support') |
| 239 | option('l2tpv3', type : 'feature', value : 'auto', |
| 240 | description: 'l2tpv3 network backend support') |
| 241 | option('netmap', type : 'feature', value : 'auto', |
| 242 | description: 'netmap network backend support') |
| 243 | option('pixman', type : 'feature', value : 'auto', |
| 244 | description: 'pixman support') |
| 245 | option('slirp', type: 'feature', value: 'auto', |
| 246 | description: 'libslirp user mode network backend support') |
| 247 | option('passt', type: 'feature', value: 'auto', |
| 248 | description: 'passt network backend support') |
| 249 | option('vde', type : 'feature', value : 'auto', |
| 250 | description: 'vde network backend support') |
| 251 | option('vmnet', type : 'feature', value : 'auto', |
| 252 | description: 'vmnet.framework network backend support') |
| 253 | option('virglrenderer', type : 'feature', value : 'auto', |
| 254 | description: 'virgl rendering support') |
| 255 | option('rutabaga_gfx', type : 'feature', value : 'auto', |
| 256 | description: 'rutabaga_gfx support') |
| 257 | option('png', type : 'feature', value : 'auto', |
| 258 | description: 'PNG support with libpng') |
| 259 | option('vnc', type : 'feature', value : 'auto', |
| 260 | description: 'VNC server') |
| 261 | option('vnc_jpeg', type : 'feature', value : 'auto', |
| 262 | description: 'JPEG lossy compression for VNC server') |
| 263 | option('vnc_sasl', type : 'feature', value : 'auto', |
| 264 | description: 'SASL authentication for VNC server') |
| 265 | option('vte', type : 'feature', value : 'auto', |
| 266 | description: 'vte support for the gtk UI') |
| 267 | option('xkbcommon', type : 'feature', value : 'auto', |
| 268 | description: 'xkbcommon support') |
| 269 | option('zstd', type : 'feature', value : 'auto', |
| 270 | description: 'zstd compression support') |
| 271 | option('qpl', type : 'feature', value : 'auto', |
| 272 | description: 'Query Processing Library support') |
| 273 | option('uadk', type : 'feature', value : 'auto', |
| 274 | description: 'UADK Library support') |
| 275 | option('qatzip', type: 'feature', value: 'auto', |
| 276 | description: 'QATzip compression support') |
| 277 | option('fuse', type: 'feature', value: 'auto', |
| 278 | description: 'FUSE block device export') |
| 279 | option('fuse_lseek', type : 'feature', value : 'auto', |
| 280 | description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports') |
| 281 | |
| 282 | option('trace_backends', type: 'array', value: ['log'], |
| 283 | choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'], |
| 284 | description: 'Set available tracing backends') |
| 285 | |
| 286 | option('alsa', type: 'feature', value: 'auto', |
| 287 | description: 'ALSA sound support') |
| 288 | option('coreaudio', type: 'feature', value: 'auto', |
| 289 | description: 'CoreAudio sound support') |
| 290 | option('dsound', type: 'feature', value: 'auto', |
| 291 | description: 'DirectSound sound support') |
| 292 | option('jack', type: 'feature', value: 'auto', |
| 293 | description: 'JACK sound support') |
| 294 | option('oss', type: 'feature', value: 'auto', |
| 295 | description: 'OSS sound support') |
| 296 | option('pa', type: 'feature', value: 'auto', |
| 297 | description: 'PulseAudio sound support') |
| 298 | option('pipewire', type: 'feature', value: 'auto', |
| 299 | description: 'PipeWire sound support') |
| 300 | option('sndio', type: 'feature', value: 'auto', |
| 301 | description: 'sndio sound support') |
| 302 | |
| 303 | option('vhost_kernel', type: 'feature', value: 'auto', |
| 304 | description: 'vhost kernel backend support') |
| 305 | option('vhost_net', type: 'feature', value: 'auto', |
| 306 | description: 'vhost-net kernel acceleration support') |
| 307 | option('vhost_user', type: 'feature', value: 'auto', |
| 308 | description: 'vhost-user backend support') |
| 309 | option('vhost_crypto', type: 'feature', value: 'auto', |
| 310 | description: 'vhost-user crypto backend support') |
| 311 | option('vhost_vdpa', type: 'feature', value: 'auto', |
| 312 | description: 'vhost-vdpa kernel backend support') |
| 313 | option('vhost_user_blk_server', type: 'feature', value: 'auto', |
| 314 | description: 'build vhost-user-blk server') |
| 315 | option('virtfs', type: 'feature', value: 'auto', |
| 316 | description: 'virtio-9p support') |
| 317 | option('libvduse', type: 'feature', value: 'auto', |
| 318 | description: 'build VDUSE Library') |
| 319 | option('vduse_blk_export', type: 'feature', value: 'auto', |
| 320 | description: 'VDUSE block export support') |
| 321 | |
| 322 | option('capstone', type: 'feature', value: 'auto', |
| 323 | description: 'Whether and how to find the capstone library') |
| 324 | option('fdt', type: 'combo', value: 'auto', |
| 325 | choices: ['disabled', 'enabled', 'auto', 'system', 'internal'], |
| 326 | description: 'Whether and how to find the libfdt library') |
| 327 | |
| 328 | option('selinux', type: 'feature', value: 'auto', |
| 329 | description: 'SELinux support in qemu-nbd') |
| 330 | option('replication', type: 'feature', value: 'auto', |
| 331 | description: 'replication support') |
| 332 | option('colo_proxy', type: 'feature', value: 'auto', |
| 333 | description: 'colo-proxy support') |
| 334 | option('bochs', type: 'feature', value: 'auto', |
| 335 | description: 'bochs image format support') |
| 336 | option('cloop', type: 'feature', value: 'auto', |
| 337 | description: 'cloop image format support') |
| 338 | option('dmg', type: 'feature', value: 'auto', |
| 339 | description: 'dmg image format support') |
| 340 | option('qcow1', type: 'feature', value: 'auto', |
| 341 | description: 'qcow1 image format support') |
| 342 | option('vdi', type: 'feature', value: 'auto', |
| 343 | description: 'vdi image format support') |
| 344 | option('vhdx', type: 'feature', value: 'auto', |
| 345 | description: 'vhdx image format support') |
| 346 | option('vmdk', type: 'feature', value: 'auto', |
| 347 | description: 'vmdk image format support') |
| 348 | option('vpc', type: 'feature', value: 'auto', |
| 349 | description: 'vpc image format support') |
| 350 | option('vvfat', type: 'feature', value: 'auto', |
| 351 | description: 'vvfat image format support') |
| 352 | option('qed', type: 'feature', value: 'auto', |
| 353 | description: 'qed image format support') |
| 354 | option('parallels', type: 'feature', value: 'auto', |
| 355 | description: 'parallels image format support') |
| 356 | option('block_drv_whitelist_in_tools', type: 'boolean', value: false, |
| 357 | description: 'use block whitelist also in tools instead of only QEMU') |
| 358 | option('rng_none', type: 'boolean', value: false, |
| 359 | description: 'dummy RNG, avoid using /dev/(u)random and getrandom()') |
| 360 | option('coroutine_pool', type: 'boolean', value: true, |
| 361 | description: 'coroutine freelist (better performance)') |
| 362 | option('debug_graph_lock', type: 'boolean', value: false, |
| 363 | description: 'graph lock debugging support') |
| 364 | option('debug_mutex', type: 'boolean', value: false, |
| 365 | description: 'mutex debugging support') |
| 366 | option('debug_stack_usage', type: 'boolean', value: false, |
| 367 | description: 'measure coroutine stack usage') |
| 368 | option('qom_cast_debug', type: 'boolean', value: true, |
| 369 | description: 'cast debugging support') |
| 370 | option('slirp_smbd', type : 'feature', value : 'auto', |
| 371 | description: 'use smbd (at path --smbd=*) in slirp networking') |
| 372 | |
| 373 | option('qemu_ga_manufacturer', type: 'string', value: 'QEMU', |
| 374 | description: '"manufacturer" name for qemu-ga registry entries') |
| 375 | option('qemu_ga_distro', type: 'string', value: 'Linux', |
| 376 | description: 'second path element in qemu-ga registry entries') |
| 377 | option('qemu_ga_version', type: 'string', value: '', |
| 378 | description: 'version number for qemu-ga installer') |
| 379 | |
| 380 | option('hexagon_idef_parser', type : 'boolean', value : true, |
| 381 | description: 'use idef-parser to automatically generate TCG code for the Hexagon frontend') |
| 382 | |
| 383 | option('x86_version', type : 'combo', choices : ['0', '1', '2', '3', '4'], value: '1', |
| 384 | description: 'tweak required x86_64 architecture version beyond compiler default') |
| 385 | |
| 386 | option('rust', type: 'feature', value: 'disabled', |
| 387 | description: 'Rust support') |
| 388 | option('strict_rust_lints', type: 'boolean', value: false, |
| 389 | description: 'Enable stricter set of Rust warnings') |