nixpkgs/pkgs/development/compilers/llvm
2025-06-08 20:27:25 -07:00
..
12 llvmPackages_12.compiler-rt: move codesign patch into versioned dir 2024-11-30 15:11:09 +01:00
13 llvmPackages.lldb: remove code for macOS < 11 2024-11-18 00:14:00 +00:00
14 compiler-rt: apply armv6l patches to llvm >= 15 where applicable 2024-09-14 12:00:00 +00:00
15 compiler-rt: apply armv6l patches to llvm >= 15 where applicable 2024-09-14 12:00:00 +00:00
16 llvmPackages_{13,15,16,17,18,19,git}.llvm: commonify patches 2024-08-09 14:11:56 -07:00
17 llvmPackages_17.{clang,tblgen}: fix builds on aarch64 2025-03-09 11:53:33 +01:00
18 llvmPackages.libcxx: remove code for macOS < 11 2024-11-18 00:14:00 +00:00
19 Merge master into staging-next 2024-10-10 18:04:46 +00:00
20/llvm llvmPackages_20: 20.1.0-rc1 -> 20.1.0-rc2 2025-02-14 09:36:39 +01:00
21/llvm llvmPackages_git: 21.0.0-unstable-2025-04-13 -> 21.0.0-unstable-2025-04-27 2025-04-27 22:37:41 -07:00
common Revert "Revert "llvmPackages_20: 20.1.5 -> 20.1.6"" 2025-06-08 20:27:25 -07:00
default.nix Revert "Revert "llvmPackages_20: 20.1.5 -> 20.1.6"" 2025-06-08 20:27:25 -07:00
multi.nix treewide: format all inactive Nix files 2024-12-10 20:26:33 +01:00
README.md llvmPackages: document adding a patch 2025-05-17 12:21:53 +02:00
update-git.py llvmPackages: Fix update-git.py 2024-11-17 16:28:32 +00:00
update.sh

How to upgrade llvm_git

  • Run update-git.py. This will set the github revision and sha256 for llvmPackages_git.llvm to whatever the latest chromium build is using. For a more recent, commit run nix-prefetch-github and change the rev and sha256 accordingly.

  • That was the easy part. The hard part is updating the patch files.

    The general process is:

    1. Try to build llvmPackages_git.llvm and associated packages such as clang and compiler-rt. You can use the -L and --keep-failed flags to make debugging patch errors easy, e.g., nix build .#llvmPackages_git.clang -L --keep-failed

    2. The build will error out with something similar to this:

      ...
      clang-unstable> patching sources
      clang-unstable> applying patch /nix/store/nndv6gq6w608n197fndvv5my4a5zg2qi-purity.patch
      clang-unstable> patching file lib/Driver/ToolChains/Gnu.cpp
      clang-unstable> Hunk #1 FAILED at 487.
      clang-unstable> 1 out of 1 hunk FAILED -- saving rejects to file lib/Driver/ToolChains/Gnu.cpp.rej
      note: keeping build directory '/tmp/nix-build-clang-unstable-2022-25-07.drv-17'
      error: builder for '/nix/store/zwi123kpkyz52fy7p6v23azixd807r8c-clang-unstable-2022-25-07.drv' failed with exit code 1;
             last 8 log lines:
             > unpacking sources
             > unpacking source archive /nix/store/mrxadx11wv1ckjr2208qgxp472pmmg6g-clang-src-unstable-2022-25-07
             > source root is clang-src-unstable-2022-25-07/clang
             > patching sources
             > applying patch /nix/store/nndv6gq6w608n197fndvv5my4a5zg2qi-purity.patch
             > patching file lib/Driver/ToolChains/Gnu.cpp
             > Hunk #1 FAILED at 487.
             > 1 out of 1 hunk FAILED -- saving rejects to file lib/Driver/ToolChains/Gnu.cpp.rej
             For full logs, run 'nix log /nix/store/zwi123kpkyz52fy7p6v23azixd807r8c-clang-unstable-2022-25-07.drv'.
      note: keeping build directory '/tmp/nix-build-compiler-rt-libc-unstable-2022-25-07.drv-20'
      error: 1 dependencies of derivation '/nix/store/ndbbh3wrl0l39b22azf46f1n7zlqwmag-clang-wrapper-unstable-2022-25-07.drv' failed to build
      

      Notice the Hunk #1 Failed at 487 line. The lines above show us that the purity.patch failed on lib/Driver/ToolChains/Gnu.cpp when compiling clang.

  1. The task now is to cross reference the hunks in the purity patch with lib/Driver/ToolCahins/Gnu.cpp.orig to see why the patch failed. The .orig file will be in the build directory referenced in the line note: keeping build directory ...; this message results from the --keep-failed flag.

  2. Now you should be able to open whichever patch failed, and the foo.orig file that it failed on. Correct the patch by adapting it to the new code and be mindful of whitespace; which can be an easily missed reason for failures. For cases where the hunk is no longer needed you can simply remove it from the patch.

This is fine for small corrections, but when more serious changes are needed its better to use git.

  1. Clone the LLVM monorepo at https://github.com/llvm/llvm-project/

  2. Check out the revision we were using before.

  3. Use patch -p1 < path/to-path in the project subdirectories to apply the patches and commit.

  4. Use git rebase HEAD^ --onto <dest> to rebase the patches onto the new revision we are trying to build, and fix all conflicts.

  5. Use git diff HEAD^:<project> HEAD:<project> to get subdir diff to write back to Nixpkgs.

Information on our current patch sets

"GNU Install Dirs" patches

Use CMake's GNUInstallDirs to support multiple outputs.

Previously, LLVM Just hard-coded bin, include, and lib${LLVM_TARGET_PREFIX}. We are making it use these variables.

For the older LLVM versions, these patches live in https://github.com/Ericson2314/llvm-project branches split-prefix. Instead of applying the patches to the worktree per the above instructions, one can checkout those directly and rebase those instead.

For newer LLVM versions, enough has has been upstreamed, (see https://reviews.llvm.org/differential/query/5UAfpj_9zHwY/ for my progress upstreaming), that I have just assembled new gnu-install-dirs patches from the remaining unmerged patches instead of rebasing from the prior LLVM's gnu install dirs patch.

Adding a patch

To add an LLVM patch in the Nixpkgs tree,

  1. Put the patch in the corresponding directory (<VERSION>/<PACKAGE>).

    Example: If you want your patch to apply to clang version 12 (and, optionally, later versions), put it in ./12/clang.

  2. Add the patch to the patches argument of the corresponding package in ./common, guarded by a lib.optionals with the desired version constraints, passed through the getVersionFile function.

    Example: If you want the patch ./12/llvm/fix-llvm-issue-49955.patch to apply to LLVM 12, add lib.optional (lib.versions.major release_version == "12") (getVersionFile "llvm/fix-llvm-issue-49955.patch") to ./common/llvm/default.nix.

  3. If you wish for this single patch to apply to multiple versions of the package, extend the conditions in the lib.optional guard and add the corresponding constraints to ./common/patches.nix; note that after is inclusive and before is exclusive.

    Example: If you want the patch ./12/clang/purity.patch to apply to versions 12, 13 and 14, you have to

    • Modify the guard in ./common/clang/default.nix as follows: lib.optional (lib.versionAtLeast release_version "12" && lib.versionOlder release_version "15")
    • Add { "clang/purity.patch" = [ { after = 12; before = 15; path = ../12; } ]; } to common/patches.nix. You may have multiple different patches with the same name that would apply to different versions; in that case, add the necessary constraints to common/patches.nix.