| <!-- This document is written in Markdown and uses extra directives provided by |
| MyST (https://myst-parser.readthedocs.io/en/latest/). --> |
| |
| <!-- If you want to modify sections/contents permanently, you should modify both |
| ReleaseNotes.md and ReleaseNotesTemplate.txt. --> |
| |
| LLVM {{env.config.release}} Release Notes |
| ========================================= |
| |
| ```{contents} |
| ``` |
| |
| ````{only} PreRelease |
| ```{warning} These are in-progress notes for the upcoming LLVM {{env.config.release}} |
| release. Release notes for previous releases can be found on |
| [the Download Page](https://releases.llvm.org/download.html). |
| ``` |
| ```` |
| |
| Introduction |
| ============ |
| |
| This document contains the release notes for the LLVM Compiler Infrastructure, |
| release {{env.config.release}}. 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](https://llvm.org/releases/). |
| |
| For more information about LLVM, including information about the latest |
| release, please check out the [main LLVM web site](https://llvm.org/). If you |
| have questions or comments, the [Discourse forums](https://discourse.llvm.org) |
| 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](https://llvm.org/releases/). |
| |
| Non-comprehensive list of changes in this release |
| ================================================= |
| |
| <!-- For small 1-3 sentence descriptions, just add an entry at the end of |
| this list. If your description won't fit comfortably in one bullet |
| point (e.g. maybe you would like to give an example of the |
| functionality, or simply have a lot to talk about), see the comment below |
| for adding a new subsection. --> |
| |
| * ... |
| |
| <!-- If you would like to document a larger change, then you can add a |
| subsection about it right here. You can copy the following boilerplate: |
| |
| Special New Feature |
| ------------------- |
| |
| Makes programs 10x faster by doing Special New Thing. |
| --> |
| |
| Changes to the LLVM IR |
| ---------------------- |
| |
| * The `ptrtoaddr` instruction was introduced. This instruction returns the |
| address component of a pointer type variable but unlike `ptrtoint` does not |
| capture provenance ([#125687](https://github.com/llvm/llvm-project/pull/125687)). |
| |
| Changes to LLVM infrastructure |
| ------------------------------ |
| |
| Changes to building LLVM |
| ------------------------ |
| |
| Changes to TableGen |
| ------------------- |
| |
| Changes to Interprocedural Optimizations |
| ---------------------------------------- |
| |
| * Added `-enable-machine-outliner={optimistic-pgo,conservative-pgo}` to read |
| profile data to guide the machine outliner |
| ([#154437](https://github.com/llvm/llvm-project/pull/154437)). |
| |
| Changes to Vectorizers |
| ---------------------------------------- |
| |
| * Added initial support for copyable elements in SLP, which models copyable |
| elements as add <element>, 0, i.e. uses identity constants for missing lanes. |
| * SLP vectorizer supports initial recognition of FMA/FMAD pattern |
| |
| Changes to the AArch64 Backend |
| ------------------------------ |
| |
| Changes to the AMDGPU Backend |
| ----------------------------- |
| |
| Changes to the ARM Backend |
| -------------------------- |
| |
| Changes to the AVR Backend |
| -------------------------- |
| |
| Changes to the DirectX Backend |
| ------------------------------ |
| |
| Changes to the Hexagon Backend |
| ------------------------------ |
| |
| Changes to the LoongArch Backend |
| -------------------------------- |
| |
| Changes to the MIPS Backend |
| --------------------------- |
| |
| Changes to the PowerPC Backend |
| ------------------------------ |
| |
| Changes to the RISC-V Backend |
| ----------------------------- |
| |
| * The loop vectorizer now performs tail folding by default on RISC-V, which |
| removes the need for a scalar epilogue loop. To restore the previous behaviour |
| use `-prefer-predicate-over-epilogue=scalar-epilogue`. |
| * `llvm-objdump` now has basic support for switching between disassembling code |
| and data using mapping symbols such as `$x` and `$d`. Switching architectures |
| using `$x` with an architecture string suffix is not yet supported. |
| * Ssctr and Smctr extensions are no longer experimental. |
| * Add support for Zvfbfa (Additional BF16 vector compute support) |
| * Adds experimental support for the 'Zibi` (Branch with Immediate) extension. |
| * Add support for Zvfofp8min (OFP8 conversion extension) |
| * Adds assembler support for the Andes `XAndesvsinth` (Andes Vector Small Int Handling Extension). |
| |
| Changes to the WebAssembly Backend |
| ---------------------------------- |
| |
| Changes to the Windows Target |
| ----------------------------- |
| |
| Changes to the X86 Backend |
| -------------------------- |
| |
| Changes to the OCaml bindings |
| ----------------------------- |
| |
| Changes to the Python bindings |
| ------------------------------ |
| |
| Changes to the C API |
| -------------------- |
| |
| Changes to the CodeGen infrastructure |
| ------------------------------------- |
| |
| Changes to the Metadata Info |
| --------------------------------- |
| |
| Changes to the Debug Info |
| --------------------------------- |
| |
| Changes to the LLVM tools |
| --------------------------------- |
| |
| * `llvm-readelf` now dumps all hex format values in lower-case mode. |
| * Some code paths for supporting Python 2.7 in `llvm-lit` have been removed. |
| * Support for `%T` in lit has been removed. |
| |
| Changes to LLDB |
| --------------------------------- |
| |
| * LLDB can now set breakpoints, show backtraces, and display variables when |
| debugging Wasm with supported runtimes (WAMR and V8). |
| |
| Changes to BOLT |
| --------------------------------- |
| |
| Changes to Sanitizers |
| --------------------- |
| |
| Other Changes |
| ------------- |
| |
| External Open Source Projects Using LLVM {{env.config.release}} |
| =============================================================== |
| |
| * A project... |
| |
| Additional Information |
| ====================== |
| |
| A wide variety of additional information is available on the |
| [LLVM web page](https://llvm.org/), in particular in the |
| [documentation](https://llvm.org/docs/) section. The web page also contains |
| versions of the API documentation which is up-to-date with the Git version of |
| the source code. You can access versions of these documents specific to this |
| release by going into the `llvm/docs/` directory in the LLVM tree. |
| |
| If you have any questions or comments about LLVM, please feel free to contact |
| us via the [Discourse forums](https://discourse.llvm.org). |