3b4da13293
Right now meson_options.txt lists about 90 options. Each option
needs code in configure to parse it and pass the option down to Meson as
a -D command-line argument; in addition the default must be duplicated
between configure and meson_options.txt. This series tries to remove
the code duplication by generating the case statement for those --enable
and --disable options, as well as the corresponding help text.
About 80% of the options can be handled completely by the new mechanism.
Eight meson options are not of the --enable/--disable kind. Six more need
to be parsed in configure for various reasons documented in the patch,
but they still have their help automatically generated.
The advantages are:
- less code in configure
- parsing and help is more consistent (for example --enable-blobs was
not supported)
- options are described entirely in one place, meson_options.txt.
This make it more attractive to use Meson options instead of
hand-crafted configure options and config-host.mak
A few options change name: --enable-tcmalloc and --enable-jemalloc
become --enable-malloc={tcmalloc,jemalloc}; --disable-blobs becomes
--disable-install-blobs; --enable-trace-backend becomes
--enable-trace-backends. However, the old names are allowed
for backwards compatibility.
Message-Id: <20211007130829.632254-19-pbonzini@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
202 lines
9.9 KiB
Meson
202 lines
9.9 KiB
Meson
# These options do not correspond to a --enable/--disable-* option
|
|
# on the configure script command line. If you add more, list them in
|
|
# scripts/meson-buildoptions.py's SKIP_OPTIONS constant too.
|
|
|
|
option('qemu_suffix', type : 'string', value: 'qemu',
|
|
description: 'Suffix for QEMU data/modules/config directories (can be empty)')
|
|
option('docdir', type : 'string', value : 'doc',
|
|
description: 'Base directory for documentation installation (can be empty)')
|
|
option('qemu_firmwarepath', type : 'string', value : '',
|
|
description: 'search PATH for firmware files')
|
|
option('sphinx_build', type : 'string', value : '',
|
|
description: 'Use specified sphinx-build [$sphinx_build] for building document (default to be empty)')
|
|
option('default_devices', type : 'boolean', value : true,
|
|
description: 'Include a default selection of devices in emulators')
|
|
option('audio_drv_list', type: 'array', value: ['default'],
|
|
choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'sdl'],
|
|
description: 'Set audio driver list')
|
|
option('fuzzing_engine', type : 'string', value : '',
|
|
description: 'fuzzing engine library for OSS-Fuzz')
|
|
option('trace_file', type: 'string', value: 'trace',
|
|
description: 'Trace file prefix for simple backend')
|
|
|
|
# Everything else can be set via --enable/--disable-* option
|
|
# on the configure script command line. After adding an option
|
|
# here make sure to run "make update-buildoptions".
|
|
|
|
option('docs', type : 'feature', value : 'auto',
|
|
description: 'Documentations build support')
|
|
option('fuzzing', type : 'boolean', value: false,
|
|
description: 'build fuzzing targets')
|
|
option('gettext', type : 'feature', value : 'auto',
|
|
description: 'Localization of the GTK+ user interface')
|
|
option('install_blobs', type : 'boolean', value : true,
|
|
description: 'install provided firmware blobs')
|
|
option('sparse', type : 'feature', value : 'auto',
|
|
description: 'sparse checker')
|
|
option('guest_agent_msi', type : 'feature', value : 'auto',
|
|
description: 'Build MSI package for the QEMU Guest Agent')
|
|
|
|
option('malloc_trim', type : 'feature', value : 'auto',
|
|
description: 'enable libc malloc_trim() for memory optimization')
|
|
option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'],
|
|
value: 'system', description: 'choose memory allocator to use')
|
|
|
|
option('kvm', type: 'feature', value: 'auto',
|
|
description: 'KVM acceleration support')
|
|
option('hax', type: 'feature', value: 'auto',
|
|
description: 'HAX acceleration support')
|
|
option('whpx', type: 'feature', value: 'auto',
|
|
description: 'WHPX acceleration support')
|
|
option('hvf', type: 'feature', value: 'auto',
|
|
description: 'HVF acceleration support')
|
|
option('nvmm', type: 'feature', value: 'auto',
|
|
description: 'NVMM acceleration support')
|
|
option('xen', type: 'feature', value: 'auto',
|
|
description: 'Xen backend support')
|
|
option('xen_pci_passthrough', type: 'feature', value: 'auto',
|
|
description: 'Xen PCI passthrough support')
|
|
option('tcg', type: 'feature', value: 'auto',
|
|
description: 'TCG support')
|
|
option('tcg_interpreter', type: 'boolean', value: false,
|
|
description: 'TCG with bytecode interpreter (experimental and slow)')
|
|
option('cfi', type: 'boolean', value: 'false',
|
|
description: 'Control-Flow Integrity (CFI)')
|
|
option('cfi_debug', type: 'boolean', value: 'false',
|
|
description: 'Verbose errors in case of CFI violation')
|
|
option('multiprocess', type: 'feature', value: 'auto',
|
|
description: 'Out of process device emulation support')
|
|
|
|
option('attr', type : 'feature', value : 'auto',
|
|
description: 'attr/xattr support')
|
|
option('auth_pam', type : 'feature', value : 'auto',
|
|
description: 'PAM access control')
|
|
option('brlapi', type : 'feature', value : 'auto',
|
|
description: 'brlapi character device driver')
|
|
option('bzip2', type : 'feature', value : 'auto',
|
|
description: 'bzip2 support for DMG images')
|
|
option('cap_ng', type : 'feature', value : 'auto',
|
|
description: 'cap_ng support')
|
|
option('bpf', type : 'feature', value : 'auto',
|
|
description: 'eBPF support')
|
|
option('cocoa', type : 'feature', value : 'auto',
|
|
description: 'Cocoa user interface (macOS only)')
|
|
option('curl', type : 'feature', value : 'auto',
|
|
description: 'CURL block device driver')
|
|
option('glusterfs', type : 'feature', value : 'auto',
|
|
description: 'Glusterfs block device driver')
|
|
option('libiscsi', type : 'feature', value : 'auto',
|
|
description: 'libiscsi userspace initiator')
|
|
option('libnfs', type : 'feature', value : 'auto',
|
|
description: 'libnfs block device driver')
|
|
option('mpath', type : 'feature', value : 'auto',
|
|
description: 'Multipath persistent reservation passthrough')
|
|
option('iconv', type : 'feature', value : 'auto',
|
|
description: 'Font glyph conversion support')
|
|
option('curses', type : 'feature', value : 'auto',
|
|
description: 'curses UI')
|
|
option('gnutls', type : 'feature', value : 'auto',
|
|
description: 'GNUTLS cryptography support')
|
|
option('nettle', type : 'feature', value : 'auto',
|
|
description: 'nettle cryptography support')
|
|
option('gcrypt', type : 'feature', value : 'auto',
|
|
description: 'libgcrypt cryptography support')
|
|
option('libdaxctl', type : 'feature', value : 'auto',
|
|
description: 'libdaxctl support')
|
|
option('libpmem', type : 'feature', value : 'auto',
|
|
description: 'libpmem support')
|
|
option('libudev', type : 'feature', value : 'auto',
|
|
description: 'Use libudev to enumerate host devices')
|
|
option('libusb', type : 'feature', value : 'auto',
|
|
description: 'libusb support for USB passthrough')
|
|
option('libxml2', type : 'feature', value : 'auto',
|
|
description: 'libxml2 support for Parallels image format')
|
|
option('linux_aio', type : 'feature', value : 'auto',
|
|
description: 'Linux AIO support')
|
|
option('linux_io_uring', type : 'feature', value : 'auto',
|
|
description: 'Linux io_uring support')
|
|
option('lzfse', type : 'feature', value : 'auto',
|
|
description: 'lzfse support for DMG images')
|
|
option('lzo', type : 'feature', value : 'auto',
|
|
description: 'lzo compression support')
|
|
option('rbd', type : 'feature', value : 'auto',
|
|
description: 'Ceph block device driver')
|
|
option('gtk', type : 'feature', value : 'auto',
|
|
description: 'GTK+ user interface')
|
|
option('sdl', type : 'feature', value : 'auto',
|
|
description: 'SDL user interface')
|
|
option('sdl_image', type : 'feature', value : 'auto',
|
|
description: 'SDL Image support for icons')
|
|
option('seccomp', type : 'feature', value : 'auto',
|
|
description: 'seccomp support')
|
|
option('smartcard', type : 'feature', value : 'auto',
|
|
description: 'CA smartcard emulation support')
|
|
option('snappy', type : 'feature', value : 'auto',
|
|
description: 'snappy compression support')
|
|
option('spice', type : 'feature', value : 'auto',
|
|
description: 'Spice server support')
|
|
option('spice_protocol', type : 'feature', value : 'auto',
|
|
description: 'Spice protocol support')
|
|
option('u2f', type : 'feature', value : 'auto',
|
|
description: 'U2F emulation support')
|
|
option('usb_redir', type : 'feature', value : 'auto',
|
|
description: 'libusbredir support')
|
|
option('netmap', type : 'feature', value : 'auto',
|
|
description: 'netmap network backend support')
|
|
option('vde', type : 'feature', value : 'auto',
|
|
description: 'vde network backend support')
|
|
option('virglrenderer', type : 'feature', value : 'auto',
|
|
description: 'virgl rendering support')
|
|
option('vnc', type : 'feature', value : 'auto',
|
|
description: 'VNC server')
|
|
option('vnc_jpeg', type : 'feature', value : 'auto',
|
|
description: 'JPEG lossy compression for VNC server')
|
|
option('vnc_png', type : 'feature', value : 'auto',
|
|
description: 'PNG compression for VNC server')
|
|
option('vnc_sasl', type : 'feature', value : 'auto',
|
|
description: 'SASL authentication for VNC server')
|
|
option('vte', type : 'feature', value : 'auto',
|
|
description: 'vte support for the gtk UI')
|
|
option('xkbcommon', type : 'feature', value : 'auto',
|
|
description: 'xkbcommon support')
|
|
option('zstd', type : 'feature', value : 'auto',
|
|
description: 'zstd compression support')
|
|
option('fuse', type: 'feature', value: 'auto',
|
|
description: 'FUSE block device export')
|
|
option('fuse_lseek', type : 'feature', value : 'auto',
|
|
description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports')
|
|
|
|
option('trace_backends', type: 'array', value: ['log'],
|
|
choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'],
|
|
description: 'Set available tracing backends')
|
|
|
|
option('alsa', type: 'feature', value: 'auto',
|
|
description: 'ALSA sound support')
|
|
option('coreaudio', type: 'feature', value: 'auto',
|
|
description: 'CoreAudio sound support')
|
|
option('dsound', type: 'feature', value: 'auto',
|
|
description: 'DirectSound sound support')
|
|
option('jack', type: 'feature', value: 'auto',
|
|
description: 'JACK sound support')
|
|
option('oss', type: 'feature', value: 'auto',
|
|
description: 'OSS sound support')
|
|
option('pa', type: 'feature', value: 'auto',
|
|
description: 'PulseAudio sound support')
|
|
|
|
option('vhost_user_blk_server', type: 'feature', value: 'auto',
|
|
description: 'build vhost-user-blk server')
|
|
option('virtfs', type: 'feature', value: 'auto',
|
|
description: 'virtio-9p support')
|
|
option('virtiofsd', type: 'feature', value: 'auto',
|
|
description: 'build virtiofs daemon (virtiofsd)')
|
|
|
|
option('capstone', type: 'combo', value: 'auto',
|
|
choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
|
|
description: 'Whether and how to find the capstone library')
|
|
option('slirp', type: 'combo', value: 'auto',
|
|
choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
|
|
description: 'Whether and how to find the slirp library')
|
|
option('fdt', type: 'combo', value: 'auto',
|
|
choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
|
|
description: 'Whether and how to find the libfdt library')
|