meson_options.txt (16476B)
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('sphinx_build', type : 'string', value : '', 16 description: 'Use specified sphinx-build for building document') 17 option('iasl', type : 'string', value : '', 18 description: 'Path to ACPI disassembler') 19 option('tls_priority', type : 'string', value : 'NORMAL', 20 description: 'Default TLS protocol/cipher priority string') 21 option('default_devices', type : 'boolean', value : true, 22 description: 'Include a default selection of devices in emulators') 23 option('audio_drv_list', type: 'array', value: ['default'], 24 choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'sdl', 'sndio'], 25 description: 'Set audio driver list') 26 option('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)') 28 option('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)') 30 option('interp_prefix', type : 'string', value : '/usr/gnemul/qemu-%M', 31 description: 'where to find shared libraries etc., use %M for cpu name') 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 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 41 option('docs', type : 'feature', value : 'auto', 42 description: 'Documentations build support') 43 option('fuzzing', type : 'boolean', value: false, 44 description: 'build fuzzing targets') 45 option('gettext', type : 'feature', value : 'auto', 46 description: 'Localization of the GTK+ user interface') 47 option('module_upgrades', type : 'boolean', value : false, 48 description: 'try to load modules from alternate paths for upgrades') 49 option('install_blobs', type : 'boolean', value : true, 50 description: 'install provided firmware blobs') 51 option('sparse', type : 'feature', value : 'auto', 52 description: 'sparse checker') 53 option('guest_agent', type : 'feature', value : 'auto', 54 description: 'Build QEMU Guest Agent') 55 option('guest_agent_msi', type : 'feature', value : 'auto', 56 description: 'Build MSI package for the QEMU Guest Agent') 57 option('tools', type : 'feature', value : 'auto', 58 description: 'build support utilities that come with QEMU') 59 option('qga_vss', type : 'feature', value: 'auto', 60 description: 'build QGA VSS support (broken with MinGW)') 61 62 option('malloc_trim', type : 'feature', value : 'auto', 63 description: 'enable libc malloc_trim() for memory optimization') 64 option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'], 65 value: 'system', description: 'choose memory allocator to use') 66 67 option('kvm', type: 'feature', value: 'auto', 68 description: 'KVM acceleration support') 69 option('hax', type: 'feature', value: 'auto', 70 description: 'HAX acceleration support') 71 option('whpx', type: 'feature', value: 'auto', 72 description: 'WHPX acceleration support') 73 option('hvf', type: 'feature', value: 'auto', 74 description: 'HVF acceleration support') 75 option('nvmm', type: 'feature', value: 'auto', 76 description: 'NVMM acceleration support') 77 option('xen', type: 'feature', value: 'auto', 78 description: 'Xen backend support') 79 option('xen_pci_passthrough', type: 'feature', value: 'auto', 80 description: 'Xen PCI passthrough support') 81 option('tcg', type: 'feature', value: 'enabled', 82 description: 'TCG support') 83 option('tcg_interpreter', type: 'boolean', value: false, 84 description: 'TCG with bytecode interpreter (slow)') 85 option('cfi', type: 'boolean', value: false, 86 description: 'Control-Flow Integrity (CFI)') 87 option('cfi_debug', type: 'boolean', value: false, 88 description: 'Verbose errors in case of CFI violation') 89 option('multiprocess', type: 'feature', value: 'auto', 90 description: 'Out of process device emulation support') 91 option('vfio_user_server', type: 'feature', value: 'disabled', 92 description: 'vfio-user server support') 93 option('dbus_display', type: 'feature', value: 'auto', 94 description: '-display dbus support') 95 option('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. 100 option('membarrier', type: 'feature', value: 'disabled', 101 description: 'membarrier system call (for Linux 4.14+ or Windows') 102 103 option('avx2', type: 'feature', value: 'auto', 104 description: 'AVX2 optimizations') 105 option('avx512f', type: 'feature', value: 'disabled', 106 description: 'AVX512F optimizations') 107 option('keyring', type: 'feature', value: 'auto', 108 description: 'Linux keyring support') 109 110 option('attr', type : 'feature', value : 'auto', 111 description: 'attr/xattr support') 112 option('auth_pam', type : 'feature', value : 'auto', 113 description: 'PAM access control') 114 option('brlapi', type : 'feature', value : 'auto', 115 description: 'brlapi character device driver') 116 option('bzip2', type : 'feature', value : 'auto', 117 description: 'bzip2 support for DMG images') 118 option('cap_ng', type : 'feature', value : 'auto', 119 description: 'cap_ng support') 120 option('blkio', type : 'feature', value : 'auto', 121 description: 'libblkio block device driver') 122 option('bpf', type : 'feature', value : 'auto', 123 description: 'eBPF support') 124 option('cocoa', type : 'feature', value : 'auto', 125 description: 'Cocoa user interface (macOS only)') 126 option('curl', type : 'feature', value : 'auto', 127 description: 'CURL block device driver') 128 option('gio', type : 'feature', value : 'auto', 129 description: 'use libgio for D-Bus support') 130 option('glusterfs', type : 'feature', value : 'auto', 131 description: 'Glusterfs block device driver') 132 option('libiscsi', type : 'feature', value : 'auto', 133 description: 'libiscsi userspace initiator') 134 option('libnfs', type : 'feature', value : 'auto', 135 description: 'libnfs block device driver') 136 option('mpath', type : 'feature', value : 'auto', 137 description: 'Multipath persistent reservation passthrough') 138 option('numa', type : 'feature', value : 'auto', 139 description: 'libnuma support') 140 option('iconv', type : 'feature', value : 'auto', 141 description: 'Font glyph conversion support') 142 option('curses', type : 'feature', value : 'auto', 143 description: 'curses UI') 144 option('gnutls', type : 'feature', value : 'auto', 145 description: 'GNUTLS cryptography support') 146 option('nettle', type : 'feature', value : 'auto', 147 description: 'nettle cryptography support') 148 option('gcrypt', type : 'feature', value : 'auto', 149 description: 'libgcrypt cryptography support') 150 option('crypto_afalg', type : 'feature', value : 'disabled', 151 description: 'Linux AF_ALG crypto backend driver') 152 option('libdaxctl', type : 'feature', value : 'auto', 153 description: 'libdaxctl support') 154 option('libpmem', type : 'feature', value : 'auto', 155 description: 'libpmem support') 156 option('libssh', type : 'feature', value : 'auto', 157 description: 'ssh block device support') 158 option('libudev', type : 'feature', value : 'auto', 159 description: 'Use libudev to enumerate host devices') 160 option('libusb', type : 'feature', value : 'auto', 161 description: 'libusb support for USB passthrough') 162 option('linux_aio', type : 'feature', value : 'auto', 163 description: 'Linux AIO support') 164 option('linux_io_uring', type : 'feature', value : 'auto', 165 description: 'Linux io_uring support') 166 option('lzfse', type : 'feature', value : 'auto', 167 description: 'lzfse support for DMG images') 168 option('lzo', type : 'feature', value : 'auto', 169 description: 'lzo compression support') 170 option('rbd', type : 'feature', value : 'auto', 171 description: 'Ceph block device driver') 172 option('opengl', type : 'feature', value : 'auto', 173 description: 'OpenGL support') 174 option('rdma', type : 'feature', value : 'auto', 175 description: 'Enable RDMA-based migration') 176 option('pvrdma', type : 'feature', value : 'auto', 177 description: 'Enable PVRDMA support') 178 option('gtk', type : 'feature', value : 'auto', 179 description: 'GTK+ user interface') 180 option('sdl', type : 'feature', value : 'auto', 181 description: 'SDL user interface') 182 option('sdl_image', type : 'feature', value : 'auto', 183 description: 'SDL Image support for icons') 184 option('seccomp', type : 'feature', value : 'auto', 185 description: 'seccomp support') 186 option('smartcard', type : 'feature', value : 'auto', 187 description: 'CA smartcard emulation support') 188 option('snappy', type : 'feature', value : 'auto', 189 description: 'snappy compression support') 190 option('spice', type : 'feature', value : 'auto', 191 description: 'Spice server support') 192 option('spice_protocol', type : 'feature', value : 'auto', 193 description: 'Spice protocol support') 194 option('u2f', type : 'feature', value : 'auto', 195 description: 'U2F emulation support') 196 option('canokey', type : 'feature', value : 'auto', 197 description: 'CanoKey support') 198 option('usb_redir', type : 'feature', value : 'auto', 199 description: 'libusbredir support') 200 option('l2tpv3', type : 'feature', value : 'auto', 201 description: 'l2tpv3 network backend support') 202 option('netmap', type : 'feature', value : 'auto', 203 description: 'netmap network backend support') 204 option('slirp', type: 'feature', value: 'auto', 205 description: 'libslirp user mode network backend support') 206 option('vde', type : 'feature', value : 'auto', 207 description: 'vde network backend support') 208 option('vmnet', type : 'feature', value : 'auto', 209 description: 'vmnet.framework network backend support') 210 option('virglrenderer', type : 'feature', value : 'auto', 211 description: 'virgl rendering support') 212 option('png', type : 'feature', value : 'auto', 213 description: 'PNG support with libpng') 214 option('vnc', type : 'feature', value : 'auto', 215 description: 'VNC server') 216 option('vnc_jpeg', type : 'feature', value : 'auto', 217 description: 'JPEG lossy compression for VNC server') 218 option('vnc_sasl', type : 'feature', value : 'auto', 219 description: 'SASL authentication for VNC server') 220 option('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 227 option('gtk_clipboard', type: 'feature', value : 'disabled', 228 description: 'clipboard support for the gtk UI (EXPERIMENTAL, MAY HANG)') 229 option('xkbcommon', type : 'feature', value : 'auto', 230 description: 'xkbcommon support') 231 option('zstd', type : 'feature', value : 'auto', 232 description: 'zstd compression support') 233 option('fuse', type: 'feature', value: 'auto', 234 description: 'FUSE block device export') 235 option('fuse_lseek', type : 'feature', value : 'auto', 236 description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports') 237 238 option('trace_backends', type: 'array', value: ['log'], 239 choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'], 240 description: 'Set available tracing backends') 241 242 option('alsa', type: 'feature', value: 'auto', 243 description: 'ALSA sound support') 244 option('coreaudio', type: 'feature', value: 'auto', 245 description: 'CoreAudio sound support') 246 option('dsound', type: 'feature', value: 'auto', 247 description: 'DirectSound sound support') 248 option('jack', type: 'feature', value: 'auto', 249 description: 'JACK sound support') 250 option('oss', type: 'feature', value: 'auto', 251 description: 'OSS sound support') 252 option('pa', type: 'feature', value: 'auto', 253 description: 'PulseAudio sound support') 254 option('sndio', type: 'feature', value: 'auto', 255 description: 'sndio sound support') 256 257 option('vhost_kernel', type: 'feature', value: 'auto', 258 description: 'vhost kernel backend support') 259 option('vhost_net', type: 'feature', value: 'auto', 260 description: 'vhost-net kernel acceleration support') 261 option('vhost_user', type: 'feature', value: 'auto', 262 description: 'vhost-user backend support') 263 option('vhost_crypto', type: 'feature', value: 'auto', 264 description: 'vhost-user crypto backend support') 265 option('vhost_vdpa', type: 'feature', value: 'auto', 266 description: 'vhost-vdpa kernel backend support') 267 option('vhost_user_blk_server', type: 'feature', value: 'auto', 268 description: 'build vhost-user-blk server') 269 option('virtfs', type: 'feature', value: 'auto', 270 description: 'virtio-9p support') 271 option('virtiofsd', type: 'feature', value: 'auto', 272 description: 'build virtiofs daemon (virtiofsd)') 273 option('libvduse', type: 'feature', value: 'auto', 274 description: 'build VDUSE Library') 275 option('vduse_blk_export', type: 'feature', value: 'auto', 276 description: 'VDUSE block export support') 277 278 option('capstone', type: 'feature', value: 'auto', 279 description: 'Whether and how to find the capstone library') 280 option('fdt', type: 'combo', value: 'auto', 281 choices: ['disabled', 'enabled', 'auto', 'system', 'internal'], 282 description: 'Whether and how to find the libfdt library') 283 284 option('selinux', type: 'feature', value: 'auto', 285 description: 'SELinux support in qemu-nbd') 286 option('live_block_migration', type: 'feature', value: 'auto', 287 description: 'block migration in the main migration stream') 288 option('replication', type: 'feature', value: 'auto', 289 description: 'replication support') 290 option('bochs', type: 'feature', value: 'auto', 291 description: 'bochs image format support') 292 option('cloop', type: 'feature', value: 'auto', 293 description: 'cloop image format support') 294 option('dmg', type: 'feature', value: 'auto', 295 description: 'dmg image format support') 296 option('qcow1', type: 'feature', value: 'auto', 297 description: 'qcow1 image format support') 298 option('vdi', type: 'feature', value: 'auto', 299 description: 'vdi image format support') 300 option('vvfat', type: 'feature', value: 'auto', 301 description: 'vvfat image format support') 302 option('qed', type: 'feature', value: 'auto', 303 description: 'qed image format support') 304 option('parallels', type: 'feature', value: 'auto', 305 description: 'parallels image format support') 306 option('block_drv_whitelist_in_tools', type: 'boolean', value: false, 307 description: 'use block whitelist also in tools instead of only QEMU') 308 option('rng_none', type: 'boolean', value: false, 309 description: 'dummy RNG, avoid using /dev/(u)random and getrandom()') 310 option('coroutine_pool', type: 'boolean', value: true, 311 description: 'coroutine freelist (better performance)') 312 option('debug_mutex', type: 'boolean', value: false, 313 description: 'mutex debugging support') 314 option('debug_stack_usage', type: 'boolean', value: false, 315 description: 'measure coroutine stack usage') 316 option('qom_cast_debug', type: 'boolean', value: false, 317 description: 'cast debugging support') 318 option('gprof', type: 'boolean', value: false, 319 description: 'QEMU profiling with gprof') 320 option('profiler', type: 'boolean', value: false, 321 description: 'profiler support') 322 option('slirp_smbd', type : 'feature', value : 'auto', 323 description: 'use smbd (at path --smbd=*) in slirp networking')