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