qemu/meson_options.txt
<<
>>
Prefs
   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 : 'array', value : ['share/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', 'sndio'],
  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('vfio_user_server', type: 'feature', value: 'disabled',
  92       description: 'vfio-user server support')
  93option('dbus_display', type: 'feature', value: 'auto',
  94       description: '-display dbus support')
  95option('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.
 100option('membarrier', type: 'feature', value: 'disabled',
 101       description: 'membarrier system call (for Linux 4.14+ or Windows')
 102
 103option('avx2', type: 'feature', value: 'auto',
 104       description: 'AVX2 optimizations')
 105option('avx512f', type: 'feature', value: 'disabled',
 106       description: 'AVX512F optimizations')
 107option('keyring', type: 'feature', value: 'auto',
 108       description: 'Linux keyring support')
 109
 110option('attr', type : 'feature', value : 'auto',
 111       description: 'attr/xattr support')
 112option('auth_pam', type : 'feature', value : 'auto',
 113       description: 'PAM access control')
 114option('brlapi', type : 'feature', value : 'auto',
 115       description: 'brlapi character device driver')
 116option('bzip2', type : 'feature', value : 'auto',
 117       description: 'bzip2 support for DMG images')
 118option('cap_ng', type : 'feature', value : 'auto',
 119       description: 'cap_ng support')
 120option('blkio', type : 'feature', value : 'auto',
 121       description: 'libblkio block device driver')
 122option('bpf', type : 'feature', value : 'auto',
 123        description: 'eBPF support')
 124option('cocoa', type : 'feature', value : 'auto',
 125       description: 'Cocoa user interface (macOS only)')
 126option('curl', type : 'feature', value : 'auto',
 127       description: 'CURL block device driver')
 128option('gio', type : 'feature', value : 'auto',
 129       description: 'use libgio for D-Bus support')
 130option('glusterfs', type : 'feature', value : 'auto',
 131       description: 'Glusterfs block device driver')
 132option('libiscsi', type : 'feature', value : 'auto',
 133       description: 'libiscsi userspace initiator')
 134option('libnfs', type : 'feature', value : 'auto',
 135       description: 'libnfs block device driver')
 136option('mpath', type : 'feature', value : 'auto',
 137       description: 'Multipath persistent reservation passthrough')
 138option('numa', type : 'feature', value : 'auto',
 139       description: 'libnuma support')
 140option('iconv', type : 'feature', value : 'auto',
 141       description: 'Font glyph conversion support')
 142option('curses', type : 'feature', value : 'auto',
 143       description: 'curses UI')
 144option('gnutls', type : 'feature', value : 'auto',
 145       description: 'GNUTLS cryptography support')
 146option('nettle', type : 'feature', value : 'auto',
 147       description: 'nettle cryptography support')
 148option('gcrypt', type : 'feature', value : 'auto',
 149       description: 'libgcrypt cryptography support')
 150option('crypto_afalg', type : 'feature', value : 'disabled',
 151       description: 'Linux AF_ALG crypto backend driver')
 152option('libdaxctl', type : 'feature', value : 'auto',
 153       description: 'libdaxctl support')
 154option('libpmem', type : 'feature', value : 'auto',
 155       description: 'libpmem support')
 156option('libssh', type : 'feature', value : 'auto',
 157       description: 'ssh block device support')
 158option('libudev', type : 'feature', value : 'auto',
 159       description: 'Use libudev to enumerate host devices')
 160option('libusb', type : 'feature', value : 'auto',
 161       description: 'libusb support for USB passthrough')
 162option('linux_aio', type : 'feature', value : 'auto',
 163       description: 'Linux AIO support')
 164option('linux_io_uring', type : 'feature', value : 'auto',
 165       description: 'Linux io_uring support')
 166option('lzfse', type : 'feature', value : 'auto',
 167       description: 'lzfse support for DMG images')
 168option('lzo', type : 'feature', value : 'auto',
 169       description: 'lzo compression support')
 170option('rbd', type : 'feature', value : 'auto',
 171       description: 'Ceph block device driver')
 172option('opengl', type : 'feature', value : 'auto',
 173       description: 'OpenGL support')
 174option('rdma', type : 'feature', value : 'auto',
 175       description: 'Enable RDMA-based migration')
 176option('pvrdma', type : 'feature', value : 'auto',
 177       description: 'Enable PVRDMA support')
 178option('gtk', type : 'feature', value : 'auto',
 179       description: 'GTK+ user interface')
 180option('sdl', type : 'feature', value : 'auto',
 181       description: 'SDL user interface')
 182option('sdl_image', type : 'feature', value : 'auto',
 183       description: 'SDL Image support for icons')
 184option('seccomp', type : 'feature', value : 'auto',
 185       description: 'seccomp support')
 186option('smartcard', type : 'feature', value : 'auto',
 187       description: 'CA smartcard emulation support')
 188option('snappy', type : 'feature', value : 'auto',
 189       description: 'snappy compression support')
 190option('spice', type : 'feature', value : 'auto',
 191       description: 'Spice server support')
 192option('spice_protocol', type : 'feature', value : 'auto',
 193       description: 'Spice protocol support')
 194option('u2f', type : 'feature', value : 'auto',
 195       description: 'U2F emulation support')
 196option('canokey', type : 'feature', value : 'auto',
 197       description: 'CanoKey support')
 198option('usb_redir', type : 'feature', value : 'auto',
 199       description: 'libusbredir support')
 200option('l2tpv3', type : 'feature', value : 'auto',
 201       description: 'l2tpv3 network backend support')
 202option('netmap', type : 'feature', value : 'auto',
 203       description: 'netmap network backend support')
 204option('slirp', type: 'feature', value: 'auto',
 205       description: 'libslirp user mode network backend support')
 206option('vde', type : 'feature', value : 'auto',
 207       description: 'vde network backend support')
 208option('vmnet', type : 'feature', value : 'auto',
 209       description: 'vmnet.framework network backend support')
 210option('virglrenderer', type : 'feature', value : 'auto',
 211       description: 'virgl rendering support')
 212option('png', type : 'feature', value : 'auto',
 213       description: 'PNG support with libpng')
 214option('vnc', type : 'feature', value : 'auto',
 215       description: 'VNC server')
 216option('vnc_jpeg', type : 'feature', value : 'auto',
 217       description: 'JPEG lossy compression for VNC server')
 218option('vnc_sasl', type : 'feature', value : 'auto',
 219       description: 'SASL authentication for VNC server')
 220option('vte', type : 'feature', value : 'auto',
 221       description: 'vte support for the gtk UI')
 222
 223# GTK Clipboard implementation is disabled by default, since it may cause hangs
 224# of the guest VCPUs. See gitlab issue 1150:
 225# https://gitlab.com/qemu-project/qemu/-/issues/1150
 226
 227option('gtk_clipboard', type: 'feature', value : 'disabled',
 228       description: 'clipboard support for the gtk UI (EXPERIMENTAL, MAY HANG)')
 229option('xkbcommon', type : 'feature', value : 'auto',
 230       description: 'xkbcommon support')
 231option('zstd', type : 'feature', value : 'auto',
 232       description: 'zstd compression support')
 233option('fuse', type: 'feature', value: 'auto',
 234       description: 'FUSE block device export')
 235option('fuse_lseek', type : 'feature', value : 'auto',
 236       description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports')
 237
 238option('trace_backends', type: 'array', value: ['log'],
 239       choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'],
 240       description: 'Set available tracing backends')
 241
 242option('alsa', type: 'feature', value: 'auto',
 243       description: 'ALSA sound support')
 244option('coreaudio', type: 'feature', value: 'auto',
 245       description: 'CoreAudio sound support')
 246option('dsound', type: 'feature', value: 'auto',
 247       description: 'DirectSound sound support')
 248option('jack', type: 'feature', value: 'auto',
 249       description: 'JACK sound support')
 250option('oss', type: 'feature', value: 'auto',
 251       description: 'OSS sound support')
 252option('pa', type: 'feature', value: 'auto',
 253       description: 'PulseAudio sound support')
 254option('sndio', type: 'feature', value: 'auto',
 255       description: 'sndio sound support')
 256
 257option('vhost_kernel', type: 'feature', value: 'auto',
 258       description: 'vhost kernel backend support')
 259option('vhost_net', type: 'feature', value: 'auto',
 260       description: 'vhost-net kernel acceleration support')
 261option('vhost_user', type: 'feature', value: 'auto',
 262       description: 'vhost-user backend support')
 263option('vhost_crypto', type: 'feature', value: 'auto',
 264       description: 'vhost-user crypto backend support')
 265option('vhost_vdpa', type: 'feature', value: 'auto',
 266       description: 'vhost-vdpa kernel backend support')
 267option('vhost_user_blk_server', type: 'feature', value: 'auto',
 268       description: 'build vhost-user-blk server')
 269option('virtfs', type: 'feature', value: 'auto',
 270       description: 'virtio-9p support')
 271option('virtiofsd', type: 'feature', value: 'auto',
 272       description: 'build virtiofs daemon (virtiofsd)')
 273option('libvduse', type: 'feature', value: 'auto',
 274       description: 'build VDUSE Library')
 275option('vduse_blk_export', type: 'feature', value: 'auto',
 276       description: 'VDUSE block export support')
 277
 278option('capstone', type: 'feature', value: 'auto',
 279       description: 'Whether and how to find the capstone library')
 280option('fdt', type: 'combo', value: 'auto',
 281       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
 282       description: 'Whether and how to find the libfdt library')
 283
 284option('selinux', type: 'feature', value: 'auto',
 285       description: 'SELinux support in qemu-nbd')
 286option('live_block_migration', type: 'feature', value: 'auto',
 287       description: 'block migration in the main migration stream')
 288option('replication', type: 'feature', value: 'auto',
 289       description: 'replication support')
 290option('bochs', type: 'feature', value: 'auto',
 291       description: 'bochs image format support')
 292option('cloop', type: 'feature', value: 'auto',
 293       description: 'cloop image format support')
 294option('dmg', type: 'feature', value: 'auto',
 295       description: 'dmg image format support')
 296option('qcow1', type: 'feature', value: 'auto',
 297       description: 'qcow1 image format support')
 298option('vdi', type: 'feature', value: 'auto',
 299       description: 'vdi image format support')
 300option('vvfat', type: 'feature', value: 'auto',
 301       description: 'vvfat image format support')
 302option('qed', type: 'feature', value: 'auto',
 303       description: 'qed image format support')
 304option('parallels', type: 'feature', value: 'auto',
 305       description: 'parallels image format support')
 306option('block_drv_whitelist_in_tools', type: 'boolean', value: false,
 307       description: 'use block whitelist also in tools instead of only QEMU')
 308option('rng_none', type: 'boolean', value: false,
 309       description: 'dummy RNG, avoid using /dev/(u)random and getrandom()')
 310option('coroutine_pool', type: 'boolean', value: true,
 311       description: 'coroutine freelist (better performance)')
 312option('debug_mutex', type: 'boolean', value: false,
 313       description: 'mutex debugging support')
 314option('debug_stack_usage', type: 'boolean', value: false,
 315       description: 'measure coroutine stack usage')
 316option('qom_cast_debug', type: 'boolean', value: false,
 317       description: 'cast debugging support')
 318option('gprof', type: 'boolean', value: false,
 319       description: 'QEMU profiling with gprof')
 320option('profiler', type: 'boolean', value: false,
 321       description: 'profiler support')
 322option('slirp_smbd', type : 'feature', value : 'auto',
 323       description: 'use smbd (at path --smbd=*) in slirp networking')
 324