aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
author_ov4 <ov4@ov4.org>2026-10-16 09:28:39 +0000
committer_ov4 <ov4@ov4.org>2026-10-16 09:28:39 +0000
commit7ee2b877cf396e680582b4a2d6094d4f3ad89abb (patch)
tree28c322e69b49948f5b0d68735b9fb283f03aba73 /doc
parentb6f0bf2df0f6baadc345a9d146599197a5b46e9f (diff)
fix(ci): upgrade macOS LLVM to avoid corrupted driver archives
Update Homebrew metadata and upgrade LLVM 23 before building static LLD. Check the AMDGPU driver symbol early to reject incomplete archives. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/build.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/doc/build.md b/doc/build.md
index dce9d7c..5aaff51 100644
--- a/doc/build.md
+++ b/doc/build.md
@@ -138,9 +138,13 @@ relocation tools with `xcode-select --install` if needed. The LLVM bottle below
provides Clang 23. Install the build tools and LLVM SDK with Homebrew:
```bash
+brew update
brew install cmake python llvm@23
+brew upgrade llvm@23
```
+Use an updated Homebrew LLVM 23 bottle. The original 23.1.0 bottle could lose one of the two `AMDGPU.cpp.o` members in `libclangDriver.a` during LTO conversion, causing an undefined `AMDGPU::setArchNameInTriple` at link time. Homebrew [fixed the archive conversion](https://github.com/Homebrew/homebrew-core/commit/7dd3210dd39afab6bad379cff8348a7c048119d1); updating formula metadata and upgrading LLVM avoids reusing the broken runner installation. Refresh any downloaded LLVM bottle too.
+
Recommended binary-bottle downloads to the build directory:
```bash