xref: /qemu/meson_options.txt (revision d201cf7a)
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 : 'doc',
8       description: 'Base directory for documentation installation (can be empty)')
9option('qemu_firmwarepath', type : 'string', value : '',
10       description: 'search PATH for firmware files')
11option('sphinx_build', type : 'string', value : '',
12       description: 'Use specified sphinx-build [$sphinx_build] for building document (default to be empty)')
13option('default_devices', type : 'boolean', value : true,
14       description: 'Include a default selection of devices in emulators')
15option('audio_drv_list', type: 'array', value: ['default'],
16       choices: ['alsa', 'coreaudio', 'default', 'dsound', 'jack', 'oss', 'pa', 'sdl'],
17       description: 'Set audio driver list')
18option('fuzzing_engine', type : 'string', value : '',
19       description: 'fuzzing engine library for OSS-Fuzz')
20option('trace_file', type: 'string', value: 'trace',
21       description: 'Trace file prefix for simple backend')
22
23# Everything else can be set via --enable/--disable-* option
24# on the configure script command line.  After adding an option
25# here make sure to run "make update-buildoptions".
26
27option('docs', type : 'feature', value : 'auto',
28       description: 'Documentations build support')
29option('fuzzing', type : 'boolean', value: false,
30       description: 'build fuzzing targets')
31option('gettext', type : 'feature', value : 'auto',
32       description: 'Localization of the GTK+ user interface')
33option('install_blobs', type : 'boolean', value : true,
34       description: 'install provided firmware blobs')
35option('sparse', type : 'feature', value : 'auto',
36       description: 'sparse checker')
37option('guest_agent_msi', type : 'feature', value : 'auto',
38       description: 'Build MSI package for the QEMU Guest Agent')
39
40option('malloc_trim', type : 'feature', value : 'auto',
41       description: 'enable libc malloc_trim() for memory optimization')
42option('malloc', type : 'combo', choices : ['system', 'tcmalloc', 'jemalloc'],
43       value: 'system', description: 'choose memory allocator to use')
44
45option('kvm', type: 'feature', value: 'auto',
46       description: 'KVM acceleration support')
47option('hax', type: 'feature', value: 'auto',
48       description: 'HAX acceleration support')
49option('whpx', type: 'feature', value: 'auto',
50       description: 'WHPX acceleration support')
51option('hvf', type: 'feature', value: 'auto',
52       description: 'HVF acceleration support')
53option('nvmm', type: 'feature', value: 'auto',
54       description: 'NVMM acceleration support')
55option('xen', type: 'feature', value: 'auto',
56       description: 'Xen backend support')
57option('xen_pci_passthrough', type: 'feature', value: 'auto',
58       description: 'Xen PCI passthrough support')
59option('tcg', type: 'feature', value: 'auto',
60       description: 'TCG support')
61option('tcg_interpreter', type: 'boolean', value: false,
62       description: 'TCG with bytecode interpreter (slow)')
63option('cfi', type: 'boolean', value: 'false',
64       description: 'Control-Flow Integrity (CFI)')
65option('cfi_debug', type: 'boolean', value: 'false',
66       description: 'Verbose errors in case of CFI violation')
67option('multiprocess', type: 'feature', value: 'auto',
68       description: 'Out of process device emulation support')
69option('dbus_display', type: 'feature', value: 'auto',
70       description: '-display dbus support')
71
72option('attr', type : 'feature', value : 'auto',
73       description: 'attr/xattr support')
74option('auth_pam', type : 'feature', value : 'auto',
75       description: 'PAM access control')
76option('brlapi', type : 'feature', value : 'auto',
77       description: 'brlapi character device driver')
78option('bzip2', type : 'feature', value : 'auto',
79       description: 'bzip2 support for DMG images')
80option('cap_ng', type : 'feature', value : 'auto',
81       description: 'cap_ng support')
82option('bpf', type : 'feature', value : 'auto',
83        description: 'eBPF support')
84option('cocoa', type : 'feature', value : 'auto',
85       description: 'Cocoa user interface (macOS only)')
86option('curl', type : 'feature', value : 'auto',
87       description: 'CURL block device driver')
88option('glusterfs', type : 'feature', value : 'auto',
89       description: 'Glusterfs block device driver')
90option('libiscsi', type : 'feature', value : 'auto',
91       description: 'libiscsi userspace initiator')
92option('libnfs', type : 'feature', value : 'auto',
93       description: 'libnfs block device driver')
94option('mpath', type : 'feature', value : 'auto',
95       description: 'Multipath persistent reservation passthrough')
96option('iconv', type : 'feature', value : 'auto',
97       description: 'Font glyph conversion support')
98option('curses', type : 'feature', value : 'auto',
99       description: 'curses UI')
100option('gnutls', type : 'feature', value : 'auto',
101       description: 'GNUTLS cryptography support')
102option('nettle', type : 'feature', value : 'auto',
103       description: 'nettle cryptography support')
104option('gcrypt', type : 'feature', value : 'auto',
105       description: 'libgcrypt cryptography support')
106option('libdaxctl', type : 'feature', value : 'auto',
107       description: 'libdaxctl support')
108option('libpmem', type : 'feature', value : 'auto',
109       description: 'libpmem support')
110option('libssh', type : 'feature', value : 'auto',
111       description: 'ssh block device support')
112option('libudev', type : 'feature', value : 'auto',
113       description: 'Use libudev to enumerate host devices')
114option('libusb', type : 'feature', value : 'auto',
115       description: 'libusb support for USB passthrough')
116option('linux_aio', type : 'feature', value : 'auto',
117       description: 'Linux AIO support')
118option('linux_io_uring', type : 'feature', value : 'auto',
119       description: 'Linux io_uring support')
120option('lzfse', type : 'feature', value : 'auto',
121       description: 'lzfse support for DMG images')
122option('lzo', type : 'feature', value : 'auto',
123       description: 'lzo compression support')
124option('rbd', type : 'feature', value : 'auto',
125       description: 'Ceph block device driver')
126option('gtk', type : 'feature', value : 'auto',
127       description: 'GTK+ user interface')
128option('sdl', type : 'feature', value : 'auto',
129       description: 'SDL user interface')
130option('sdl_image', type : 'feature', value : 'auto',
131       description: 'SDL Image support for icons')
132option('seccomp', type : 'feature', value : 'auto',
133       description: 'seccomp support')
134option('smartcard', type : 'feature', value : 'auto',
135       description: 'CA smartcard emulation support')
136option('snappy', type : 'feature', value : 'auto',
137       description: 'snappy compression support')
138option('spice', type : 'feature', value : 'auto',
139       description: 'Spice server support')
140option('spice_protocol', type : 'feature', value : 'auto',
141       description: 'Spice protocol support')
142option('u2f', type : 'feature', value : 'auto',
143       description: 'U2F emulation support')
144option('usb_redir', type : 'feature', value : 'auto',
145       description: 'libusbredir support')
146option('l2tpv3', type : 'feature', value : 'auto',
147       description: 'l2tpv3 network backend support')
148option('netmap', type : 'feature', value : 'auto',
149       description: 'netmap network backend support')
150option('vde', type : 'feature', value : 'auto',
151       description: 'vde network backend support')
152option('virglrenderer', type : 'feature', value : 'auto',
153       description: 'virgl rendering support')
154option('vnc', type : 'feature', value : 'auto',
155       description: 'VNC server')
156option('vnc_jpeg', type : 'feature', value : 'auto',
157       description: 'JPEG lossy compression for VNC server')
158option('vnc_png', type : 'feature', value : 'auto',
159       description: 'PNG compression for VNC server')
160option('vnc_sasl', type : 'feature', value : 'auto',
161       description: 'SASL authentication for VNC server')
162option('vte', type : 'feature', value : 'auto',
163       description: 'vte support for the gtk UI')
164option('xkbcommon', type : 'feature', value : 'auto',
165       description: 'xkbcommon support')
166option('zstd', type : 'feature', value : 'auto',
167       description: 'zstd compression support')
168option('fuse', type: 'feature', value: 'auto',
169       description: 'FUSE block device export')
170option('fuse_lseek', type : 'feature', value : 'auto',
171       description: 'SEEK_HOLE/SEEK_DATA support for FUSE exports')
172
173option('trace_backends', type: 'array', value: ['log'],
174       choices: ['dtrace', 'ftrace', 'log', 'nop', 'simple', 'syslog', 'ust'],
175       description: 'Set available tracing backends')
176
177option('alsa', type: 'feature', value: 'auto',
178       description: 'ALSA sound support')
179option('coreaudio', type: 'feature', value: 'auto',
180       description: 'CoreAudio sound support')
181option('dsound', type: 'feature', value: 'auto',
182       description: 'DirectSound sound support')
183option('jack', type: 'feature', value: 'auto',
184       description: 'JACK sound support')
185option('oss', type: 'feature', value: 'auto',
186       description: 'OSS sound support')
187option('pa', type: 'feature', value: 'auto',
188       description: 'PulseAudio sound support')
189
190option('vhost_user_blk_server', type: 'feature', value: 'auto',
191       description: 'build vhost-user-blk server')
192option('virtfs', type: 'feature', value: 'auto',
193       description: 'virtio-9p support')
194option('virtiofsd', type: 'feature', value: 'auto',
195       description: 'build virtiofs daemon (virtiofsd)')
196
197option('capstone', type: 'combo', value: 'auto',
198       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
199       description: 'Whether and how to find the capstone library')
200option('slirp', type: 'combo', value: 'auto',
201       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
202       description: 'Whether and how to find the slirp library')
203option('fdt', type: 'combo', value: 'auto',
204       choices: ['disabled', 'enabled', 'auto', 'system', 'internal'],
205       description: 'Whether and how to find the libfdt library')
206
207option('selinux', type: 'feature', value: 'auto',
208       description: 'SELinux support in qemu-nbd')
209