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