[RFC,v3,0/9] mesa: lighten up target's libclc dependencies and fix panfrost support

@Otavio, can I add the new mesa-tools-native recipe under your
maintainership in meta/conf/distro/include/maintainers.inc, it is after
all still mesa?

Panfrost support has been broken for a while already because it now
requires libclc which isn't enforced by default. This fixes this
oversight.

While re-adding support for panfrost, the build time for libclc were a
bit too much to my taste and I tried to figure out if we could lighten
up the dependencies for the target recipe and it seems to be the case.

libclc brings very expensive dependencies such as llvm and clang.
Building clang and llvm for each target architecture is very expensive,
but mesa allows to depend on prebuilt host binaries (mesa-clc and
precomp-compiler). Those are built by mesa as well, but can be compiled
in mesa-native instead of mesa, making the dependency expensive but only
once regardless of the number of target architectures to build for.
Ideally the mesa-clc and precomp-compiler would only be compiled in
mesa-native if target mesa requires libclc support, however this is not
possible as a target recipe cannot impact or depend on a native recipe's
configuration. We thus have two choices, always build libclc in
mesa-native with its heavy dependencies and impact every build or force
the user to modify the mesa-native recipe in a custom layer (as a native
recipe cannot use target's OVERRIDES). The latter is unacceptable so the
former seems to be the only option. Another big downside is that
mesa-native currently builds drivers (amd, nouveau, svga) which we may
have absolutely no interest in building, increasing the build time and
possibly dependencies list).

A third choice is to spin-off the native mesa recipe with libclc support
into a new recipe without drivers and only what's necessary to build
mesa-clc and precomp-compiler binaries.
This allows to keep a "clean" mesa-native recipe for whoever needs those
drivers built-in (e.g. for testing, for qemu-native, or whatever else)
and only bring the libclc dependency when required by the target recipe.

Because libclc is now only built for the host, opencl support now needs
to explicitly bring libclc and others to build as libclc won't bring it
in the build environment anymore.

Note that this was essentially only build tested (run tested on RK3588
with panfrost though).

I tried to enable OpenCL support but it triggers a buildpaths QA error,
which can be worked around with the following patch:

  commit f5508086477eb900bb0bcfa1a65f46c8d853595a
  Author: Quentin Schulz <quentin.schulz@cherry.de>
  Date:   Mon Jul 21 11:15:54 2025 +0200
  
      clc: avoid host path poisoning
      
      LLVM_LIB_DIR is derived from llvm_libdir meson variable. The latter is
      required to figure out where the clang/llvm libraries are for the
      cross-compiler but the former is only useful for debugging purposes
      while running on the target. When in a cross-compiling environment,
      LLVM_LIB_DIR would actually point at a non-existing path (the sysroot
      path on the build host) instead of the target path.
      
      I don't know how to fix this properly so I just hardcode it for now to
      silence build warnings.
      
      Upstream-Status: Inappropriate [proper fix sent to mesa stripping the sysroot would be much better]
      Signed-off-by: Quentin Schulz <quentin.schulz@cherry.de>
  
  diff --git a/src/compiler/clc/clc_helpers.cpp b/src/compiler/clc/clc_helpers.cpp
  index 3c0c9db653f..fbc3b2b3d21 100644
  --- a/src/compiler/clc/clc_helpers.cpp
  +++ b/src/compiler/clc/clc_helpers.cpp
  @@ -936,7 +936,7 @@ clc_compile_to_llvm_module(LLVMContext &llvm_ctx,
                                       false, false);
   
      auto clang_install_res_path =
  -      fs::path(LLVM_LIB_DIR) / "clang" / std::to_string(LLVM_VERSION_MAJOR) / "include";
  +      fs::path("/usr/lib/clang") / std::to_string(LLVM_VERSION_MAJOR) / "include";
      c->getHeaderSearchOpts().AddPath(clang_install_res_path.string(),
                                       clang::frontend::Angled,
                                       false, false);

However, building OpenCL support with Asahi enabled triggers a bunch of
other buildpaths QA errors and I believe those are triggered by:
https://gitlab.freedesktop.org/mesa/mesa/-/blob/main/src/compiler/libcl/assert.h#L33
with __FILE__ pointing at the path on the build host. This should have
been mitigated by DEBUG_PREFIX_MAP (-ffile-prefix-map=) but it probably
isn't propagated by mesa's build system to the LLVM-only parts of the
build?

Signed-off-by: Quentin Schulz <quentin.schulz@cherry.de>
---
Changes in v3:
- added patch to move S into mesa.inc,
- added patch to remove egl/gles from mesa-gl,
- added patch to make mesa-gl a target-only recipe,
- updated comment for PACKAGECONFIG[opencl] dependency on other
  PACKAGECONFIG,
- added clarification in commit log of commit adding asahi to TOOLS,
- Link to v2: https://lore.kernel.org/r/20250721-mesa-libclc-panfrost-v2-0-f713d0858949@cherry.de

Changes in v2:
- spin-off mesa-clc/precomp-compiler host binary building into a
  mesa-tools-native recipe to lighten the dependency even more (no
  native mesa drivers to build),
- make libclc's target mesa depend on mesa-tools-native instead of
  mesa-native,
- Link to v1: https://lore.kernel.org/r/20250624-mesa-libclc-panfrost-v1-0-9ed8ca980e21@cherry.de

---
Quentin Schulz (8):
      mesa: move PACKAGECONFIG defaults to recipes
      mesa: move PROVIDES out of include file
      mesa: move BBCLASSEXTEND out of the include file
      mesa-gl: make recipe target only
      mesa-gl: drop egl/gles from default PACKAGECONFIG
      mesa: add asahi to TOOLS when selected in PACKAGECONFIG
      mesa: use simpler mesa-tools-native recipe as dependency for libclc
      mesa: fix panfrost driver build

Ross Burton (1):
      mesa: assign S in include file

 meta/recipes-graphics/mesa/mesa-gl.bb           | 16 ++++++---
 meta/recipes-graphics/mesa/mesa-tools-native.bb | 19 ++++++++++
 meta/recipes-graphics/mesa/mesa.bb              | 25 +++++++++++++
 meta/recipes-graphics/mesa/mesa.inc             | 47 +++++--------------------
 4 files changed, 65 insertions(+), 42 deletions(-)
---
base-commit: bd4625cd4db0f02162092d85aeab3023914f768a
change-id: 20250624-mesa-libclc-panfrost-108d62e1899b

Best regards,