docs: document gallium-rusticl-enable-drivers

Reviewed-by: David Heidelberg <david@ixit.cz>
Acked-by: Eric Engestrom <eric@igalia.com>
Reviewed-by: Alyssa Rosenzweig <alyssa@rosenzweig.io>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/31202>
This commit is contained in:
Karol Herbst
2024-09-17 11:17:11 +02:00
committed by Marge Bot
parent 1301d61de4
commit f3f4f0fb83

View File

@@ -11,6 +11,23 @@ In order to use Rusticl on any platform the environment variable
for any driver by default yet as doing so can impact system stability until
remaining core issues are ironed out.
Enabling drivers by default
---------------------------
Distributions and everybody building rusticl themselves can opt-in or opt-out
certain drivers from being enabled by default. The
``gallium-rusticl-enable-drivers`` takes a list of drivers to enable by
default. The environment variable :envvar:`RUSTICL_ENABLE` will overwrite this
list at runtime.
Not all drivers are supported to be enabled by default, because that should
require opt-in by the driver maintainers. Check out the meson option
documentation to see for which drivers this option is supported.
The ``auto`` option might not enable all drivers supported by this flag, but
for distribution it's recommended to use that one unless they get an ack from
driver maintainers to expand the list.
Building
--------