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