LLVM 24.0.0git Release Notes - LLVM
Hide navigation sidebar Hide table of contents sidebar Back to top Edit this page Toggle table of contents sidebar LLVM 24.0.0git Release Notes # Warning These are in-progress notes for the upcoming LLVM 24.0.0git release. Release notes for previous releases can be found on the Download Page . Introduction # This document contains the release notes for the LLVM Compiler Infrastructure, release 24.0.0git. Here we describe the status of LLVM, including major improvements from the previous release, improvements in various subprojects of LLVM, and some of the current users of the code.
All LLVM releases may be downloaded from the LLVM releases web site . For more information about LLVM, including information about the latest release, please check out the main LLVM web site . If you have questions or comments, the Discourse forums is a good place to ask them. Note that if you are reading this file from a Git checkout or the main LLVM web page, this document applies to the next release, not the current one.
To see the release notes for a specific release, please see the releases page . Non-comprehensive list of changes in this release # … Changes to the LLVM IR # LLVM now assigns persistent print IDs to metadata nodes. Reusing these IDs avoids repeated module-wide scans to rebuild metadata numbering, which can significantly speed up debug and pass printing on large modules. Keeping the IDs stable also makes repeated output easier to compare: unchanged metadata keeps the same number as passes modify the module.
The numbering and definition order can differ from earlier releases, so tests of intermediate output may need updated expectations. LLVM’s standard final-output paths renumber metadata in canonical order. This gives consecutive IDs with no gaps and makes the final IR easier to read. C++ clients that call Module::print() directly do not renumber automatically. For final IR output, these clients should call Module::renumberMetadataForAssembly() immediately before printing.
Keep persistent IDs for intermediate dumps so their numbering remains stable. Standalone metadata printing now uses numbered definitions such as !1 = !DIFile(...) instead of pointer-based forms such as <0x...> = !DIFile(...) . Tools and tests that compare such output may need updating. Added llvm.vector.reduce.fmaximumnum and llvm.vector.reduce.fminimumnum intrinsics, the reduction variants of llvm.maximumnum and llvm.minimumnum .
Added llvm.smulh and llvm.umulh intrinsics for signed and unsigned multiply returning the high-order half of the 2N-bit product of iN operands. Added nofreeobj attribute for attributes and returns, which forbids freeing the underlying object (as opposed to only frees through that specific pointer). Renamed !nofree metadata to !nofreeobj , as it has the same semantics. The following VP intrinsics have been removed: llvm.vp.select.* llvm.vp.add.* llvm.vp.sub.* llvm.vp.mul.* llvm.vp.ashr.* llvm.vp.lshr.* llvm.vp.shl.* llvm.vp.or.* llvm.vp.and.* llvm.vp.xor.* llvm.vp.abs.* llvm.vp.smax.* llvm.vp.smin.* llvm.vp.umax.* llvm.vp.umin.* llvm.vp.copysign.* llvm.vp.minnum.* llvm.vp.maxnum.* llvm.vp.minimum.* llvm.vp.maximum.* llvm.vp.fadd.* llvm.vp.fsub.* llvm.vp.fmul.* llvm.vp.fdiv.* llvm.vp.frem.* llvm.vp.fneg.* llvm.vp.fabs.* llvm.vp.sqrt.* llvm.vp.fma.* llvm.vp.fmuladd.* llvm.vp.trunc.* llvm.vp.zext.* llvm.vp.sext.* llvm.vp.fptrunc.* llvm.vp.fpext.* llvm.vp.fptoui.* llvm.vp.fptosi.* llvm.vp.uitofp.* llvm.vp.sitofp.* llvm.vp.ptrtoint.* llvm.vp.inttoptr.* llvm.vp.fcmp.* llvm.vp.icmp.* llvm.vp.ceil.* llvm.vp.floor.* llvm.vp.rint.* llvm.vp.nearbyint.* llvm.vp.round.* llvm.vp.roundeven.* llvm.vp.roundtozero.* llvm.vp.lrint.* llvm.vp.llrint.* llvm.vp.bitreverse.* llvm.vp.bswap.* llvm.vp.ctpop.* llvm.vp.ctlz.* llvm.vp.cttz.* llvm.vp.sadd.sat.* llvm.vp.uadd.sat.* llvm.vp.ssub.sat.* llvm.vp.usub.sat.* llvm.vp.fshl.* llvm.vp.fshr.* llvm.vp.is.fpclass.* These intrinsics previously only set masked-off lanes to poison, and will be automatically upgraded to their non-VP equivalent.
On RISC-V the VL optimizer should automatically infer vl in most cases from a store or reduction instruction, so passing around an explicit EVL operand shouldn’t be required. If needed a “root” EVL can be synthesized with llvm.vp.merge , e.g: %x = add < vscale x 2 x i32 > %y , %z %res = call < vscale x 2 x i32 > @llvm.vp.merge (< vscale x 2 x i32 > %x , < vscale x 2 x i32 > poison , < vscale x 2 x i1 > splat ( i1 true ), i32 %evl ) The llvm.vp.merge will be folded away but the %evl will be propagated to the add instruction.
The llvm.strip.invariant.group intrinsic has been removed. It existed to work around a bug relating to replacement of pointers with different provenance based on dominating equality conditions, and is no longer needed. Introduced the generic !atomic.ignore.denormal.mode metadata for floating-point atomicrmw instructions, generalizing the previously AMDGPU-specific !amdgpu.ignore.denormal.mode . Added the bitinsert and bitextract instructions for bit-range manipulation on byte type values.
Changes to LLVM infrastructure # Removed TargetOptions::FloatABIType . The soft float ABI should be controlled by setting the "float-abi" module flag. Removed TargetOptions::EABIVersion and the llc / opt -meabi flag. The GNU-vs-EABI distinction is now derived entirely from the target triple’s environment (e.g. arm-none-gnueabi vs arm-none-eabi ). Replaced TargetOptions::EnableMachineFunctionSplitter with TargetOptions::FunctionSplitting , and the -split-machine-functions and -enable-split-machine-functions flags with -function-splitting={none,bbsections,all} .
Backend tools ( llc , opt , LTO plugin options and libLTO debug options): use -function-splitting=all for the previous behavior. Clang and Flang: -fsplit-machine-functions is unchanged and remains the recommended spelling. -mllvm -enable-split-machine-functions should be replaced with -fsplit-machine-functions or -mllvm -function-splitting=all . Changes to building LLVM # A new LLVM_ENABLE_LZMA option ( ON , OFF or FORCE_ON ; default ON ) controls whether LLVM links liblzma for xz decompression.
It replaces LLDB’s LLDB_ENABLE_LZMA , which is deprecated: a monorepo build maps it onto LLVM_ENABLE_LZMA , and it has no effect in a standalone LLDB build. The DirectX backend is now an official target and has moved from LLVM_ALL_EXPERIMENTAL_TARGETS to LLVM_ALL_TARGETS . It is now built by default and no longer requires LLVM_EXPERIMENTAL_TARGETS_TO_BUILD . Clang and MLIR projects enabled implicitly as Flang dependencies now omit unrelated build and test targets.
Installation retains the dependency libraries, headers, resources, and CMake targets needed by Flang. Explicitly enabling Clang or MLIR retains the project’s complete build, test, and install behavior. With CLANG_ENABLE_CIR=ON and mlir in LLVM_ENABLE_PROJECTS , find_package(Clang) now looks for the associated MLIR CMake package before importing Clang’s targets, so consumers no longer need to call find_package(MLIR) themselves and can do so in either order.
As a consequence the consumer’s project also sees the MLIR_* variables and targets, as it already does for Flang. When MLIR is only an implicit ClangIR dependency, its build-tree MLIRConfig.cmake now reports the package as not found with an explanatory message instead of succeeding with no targets; such a build never provided a usable MLIR SDK. LLVM’s documentation has largely been rewritten from reStructuredText to Markdown, and our Sphinx documentation build now has a hard dependency on the [ myst-parser package].
Vendors packaging LLVM will need to install myst-parser to generate HTML or man page documentation. For convenience, we now release a llvm_man_pages-${VER}.tar.xz tarball if you need man page docs on a minimal system without Sphinx or myst-parser . Changes to the Windows installer # The project has migrated to MSI installers. Previous installations of LLVM, prior (and including) 23.1.0, must be manuall
The rest of this page is on the live site.