drm-shim: Let the driver choose to overwrite the first render node.
[mesa.git] / meson_options.txt
1 # Copyright © 2017-2019 Intel Corporation
2
3 # Permission is hereby granted, free of charge, to any person obtaining a copy
4 # of this software and associated documentation files (the "Software"), to deal
5 # in the Software without restriction, including without limitation the rights
6 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7 # copies of the Software, and to permit persons to whom the Software is
8 # furnished to do so, subject to the following conditions:
9
10 # The above copyright notice and this permission notice shall be included in
11 # all copies or substantial portions of the Software.
12
13 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
19 # SOFTWARE.
20
21 option(
22 'platforms',
23 type : 'array',
24 value : ['auto'],
25 choices : [
26 '', 'auto', 'x11', 'wayland', 'drm', 'surfaceless', 'haiku', 'android',
27 'windows',
28 ],
29 description : 'window systems to support. If this is set to `auto`, all platforms applicable will be enabled.'
30 )
31 option(
32 'dri3',
33 type : 'combo',
34 value : 'auto',
35 choices : ['auto', 'true', 'false'],
36 description : 'enable support for dri3'
37 )
38 option(
39 'dri-drivers',
40 type : 'array',
41 value : ['auto'],
42 choices : ['', 'auto', 'i915', 'i965', 'r100', 'r200', 'nouveau', 'swrast'],
43 description : 'List of dri drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
44 )
45 option(
46 'dri-drivers-path',
47 type : 'string',
48 value : '',
49 description : 'Location to install dri drivers. Default: $libdir/dri.'
50 )
51 option(
52 'dri-search-path',
53 type : 'string',
54 value : '',
55 description : 'Locations to search for dri drivers, passed as colon separated list. Default: dri-drivers-path.'
56 )
57 option(
58 'gallium-drivers',
59 type : 'array',
60 value : ['auto'],
61 choices : [
62 '', 'auto', 'kmsro', 'radeonsi', 'r300', 'r600', 'nouveau', 'freedreno',
63 'swrast', 'v3d', 'vc4', 'etnaviv', 'tegra', 'i915', 'svga', 'virgl',
64 'swr', 'panfrost', 'iris', 'lima', 'zink'
65 ],
66 description : 'List of gallium drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
67 )
68 option(
69 'gallium-extra-hud',
70 type : 'boolean',
71 value : false,
72 description : 'Enable HUD block/NIC I/O HUD status support',
73 )
74 option(
75 'gallium-vdpau',
76 type : 'combo',
77 value : 'auto',
78 choices : ['auto', 'true', 'false'],
79 description : 'enable gallium vdpau state tracker.',
80 )
81 option(
82 'vdpau-libs-path',
83 type : 'string',
84 value : '',
85 description : 'path to put vdpau libraries. defaults to $libdir/vdpau.'
86 )
87 option(
88 'gallium-xvmc',
89 type : 'combo',
90 value : 'auto',
91 choices : ['auto', 'true', 'false'],
92 description : 'enable gallium xvmc state tracker.',
93 )
94 option(
95 'xvmc-libs-path',
96 type : 'string',
97 value : '',
98 description : 'path to put xvmc libraries. defaults to $libdir.'
99 )
100 option(
101 'gallium-omx',
102 type : 'combo',
103 value : 'auto',
104 choices : ['auto', 'disabled', 'bellagio', 'tizonia'],
105 description : 'enable gallium omx state tracker.',
106 )
107 option(
108 'omx-libs-path',
109 type : 'string',
110 value : '',
111 description : 'path to put omx libraries. defaults to omx-bellagio pkg-config pluginsdir.'
112 )
113 option(
114 'gallium-va',
115 type : 'combo',
116 value : 'auto',
117 choices : ['auto', 'true', 'false'],
118 description : 'enable gallium va state tracker.',
119 )
120 option(
121 'va-libs-path',
122 type : 'string',
123 value : '',
124 description : 'path to put va libraries. defaults to $libdir/dri.'
125 )
126 option(
127 'gallium-xa',
128 type : 'combo',
129 value : 'auto',
130 choices : ['auto', 'true', 'false'],
131 description : 'enable gallium xa state tracker.',
132 )
133 option(
134 'gallium-nine',
135 type : 'boolean',
136 value : false,
137 description : 'build gallium "nine" Direct3D 9.x state tracker.',
138 )
139 option(
140 'gallium-opencl',
141 type : 'combo',
142 choices : ['icd', 'standalone', 'disabled'],
143 value : 'disabled',
144 description : 'build gallium "clover" OpenCL state tracker.',
145 )
146 option(
147 'opencl-spirv',
148 type : 'boolean',
149 value : false,
150 description : 'build gallium "clover" OpenCL state tracker with SPIR-V binary support.',
151 )
152 option(
153 'd3d-drivers-path',
154 type : 'string',
155 value : '',
156 description : 'Location of D3D drivers. Default: $libdir/d3d',
157 )
158 option(
159 'vulkan-drivers',
160 type : 'array',
161 value : ['auto'],
162 choices : ['', 'auto', 'amd', 'freedreno', 'intel'],
163 description : 'List of vulkan drivers to build. If this is set to auto all drivers applicable to the target OS/architecture will be built'
164 )
165 option(
166 'shader-cache',
167 type : 'combo',
168 value : 'auto',
169 choices : ['auto', 'true', 'false'],
170 description : 'Build with on-disk shader cache support'
171 )
172 option(
173 'vulkan-icd-dir',
174 type : 'string',
175 value : '',
176 description : 'Location relative to prefix to put vulkan icds on install. Default: $datadir/vulkan/icd.d'
177 )
178 option(
179 'vulkan-overlay-layer',
180 type : 'boolean',
181 value : false,
182 description : 'Whether to build the vulkan overlay layer'
183 )
184 option(
185 'shared-glapi',
186 type : 'combo',
187 value : 'auto',
188 choices : ['auto', 'true', 'false'],
189 description : 'Whether to build a shared or static glapi. Defaults to false on Windows, true elsewhere'
190 )
191 option(
192 'gles1',
193 type : 'combo',
194 value : 'auto',
195 choices : ['auto', 'true', 'false'],
196 description : 'Build support for OpenGL ES 1.x'
197 )
198 option(
199 'gles2',
200 type : 'combo',
201 value : 'auto',
202 choices : ['auto', 'true', 'false'],
203 description : 'Build support for OpenGL ES 2.x and 3.x'
204 )
205 option(
206 'opengl',
207 type : 'boolean',
208 value : true,
209 description : 'Build support for OpenGL (all versions)'
210 )
211 option(
212 'gbm',
213 type : 'combo',
214 value : 'auto',
215 choices : ['auto', 'true', 'false'],
216 description : 'Build support for gbm platform'
217 )
218 option(
219 'glx',
220 type : 'combo',
221 value : 'auto',
222 choices : ['auto', 'disabled', 'dri', 'xlib', 'gallium-xlib'],
223 description : 'Build support for GLX platform'
224 )
225 option(
226 'egl',
227 type : 'combo',
228 value : 'auto',
229 choices : ['auto', 'true', 'false'],
230 description : 'Build support for EGL platform'
231 )
232 option(
233 'glvnd',
234 type : 'boolean',
235 value : false,
236 description : 'Enable GLVND support.'
237 )
238 option(
239 'glx-read-only-text',
240 type : 'boolean',
241 value : false,
242 description : 'Disable writable .text section on x86 (decreases performance)'
243 )
244 option(
245 'llvm',
246 type : 'combo',
247 value : 'auto',
248 choices : ['auto', 'true', 'false'],
249 description : 'Build with LLVM support.'
250 )
251 option(
252 'shared-llvm',
253 type : 'combo',
254 value : 'auto',
255 choices : ['auto', 'true', 'false'],
256 description : 'Whether to link LLVM shared or statically.'
257 )
258 option(
259 'valgrind',
260 type : 'combo',
261 value : 'auto',
262 choices : ['auto', 'true', 'false'],
263 description : 'Build with valgrind support'
264 )
265 option(
266 'libunwind',
267 type : 'combo',
268 value : 'auto',
269 choices : ['auto', 'true', 'false'],
270 description : 'Use libunwind for stack-traces'
271 )
272 option(
273 'lmsensors',
274 type : 'combo',
275 value : 'auto',
276 choices : ['auto', 'true', 'false'],
277 description : 'Enable HUD lmsensors support.'
278 )
279 option(
280 'build-tests',
281 type : 'boolean',
282 value : false,
283 description : 'Build unit tests. Currently this will build *all* unit tests, which may build more than expected.'
284 )
285 option(
286 'install-intel-gpu-tests',
287 type : 'boolean',
288 value : false,
289 description : 'Build and install Intel unit tests which require the GPU. This option is for developers and the Intel CI system only.'
290 )
291 option(
292 'selinux',
293 type : 'boolean',
294 value : false,
295 description : 'Build an SELinux-aware Mesa'
296 )
297 option(
298 'osmesa',
299 type : 'combo',
300 value : 'none',
301 choices : ['none', 'classic', 'gallium'],
302 description : 'Build OSmesa.'
303 )
304 option(
305 'osmesa-bits',
306 type : 'combo',
307 value : '8',
308 choices : ['8', '16', '32'],
309 description : 'Number of channel bits for OSMesa.'
310 )
311 option(
312 'swr-arches',
313 type : 'array',
314 value : ['avx', 'avx2'],
315 choices : ['avx', 'avx2', 'knl', 'skx'],
316 description : 'Architectures to build SWR support for.',
317 )
318 option(
319 'shared-swr',
320 type : 'boolean',
321 value : true,
322 description : 'Whether to link SWR shared or statically.',
323 )
324
325 option(
326 'tools',
327 type : 'array',
328 value : [],
329 choices : ['drm-shim', 'etnaviv', 'freedreno', 'glsl', 'intel', 'intel-ui', 'nir', 'nouveau', 'xvmc', 'lima', 'all'],
330 description : 'List of tools to build. (Note: `intel-ui` selects `intel`)',
331 )
332 option(
333 'power8',
334 type : 'combo',
335 value : 'auto',
336 choices : ['auto', 'true', 'false'],
337 description : 'Enable power8 optimizations.',
338 )
339 option(
340 'xlib-lease',
341 type : 'combo',
342 value : 'auto',
343 choices : ['auto', 'true', 'false'],
344 description : 'Enable VK_EXT_acquire_xlib_display.'
345 )
346 option(
347 'glx-direct',
348 type : 'boolean',
349 value : true,
350 description : 'Enable direct rendering in GLX and EGL for DRI',
351 )
352 option(
353 'prefer-iris',
354 type : 'boolean',
355 value : true,
356 description : 'Prefer new Intel iris driver over older i965 driver'
357 )
358 option('egl-lib-suffix',
359 type : 'string',
360 value : '',
361 description : 'Suffix to append to EGL library name. Default: none.'
362 )
363 option(
364 'gles-lib-suffix',
365 type : 'string',
366 value : '',
367 description : 'Suffix to append to GLES library names. Default: none.'
368 )
369 option(
370 'platform-sdk-version',
371 type : 'integer',
372 min : 25,
373 max : 28,
374 value : 25,
375 description : 'Android Platform SDK version. Default: Nougat version.'
376 )
377 option(
378 'zstd',
379 type : 'combo',
380 choices : ['auto', 'true', 'false'],
381 value : 'auto',
382 description : 'Use ZSTD instead of ZLIB in some cases.'
383 )