2022-02-02 15:13:01 +08:00
|
|
|
============================
|
|
|
|
|
LLVM |release| Release Notes
|
|
|
|
|
============================
|
2012-12-10 07:14:26 +08:00
|
|
|
|
|
|
|
|
.. contents::
|
|
|
|
|
:local:
|
|
|
|
|
|
2022-02-02 15:13:01 +08:00
|
|
|
.. only:: PreRelease
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
These are in-progress notes for the upcoming LLVM |version| release.
|
|
|
|
|
Release notes for previous releases can be found on
|
|
|
|
|
`the Download Page <https://releases.llvm.org/download.html>`_.
|
2012-12-10 07:14:26 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Introduction
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
This document contains the release notes for the LLVM Compiler Infrastructure,
|
2022-02-02 15:13:01 +08:00
|
|
|
release |release|. Here we describe the status of LLVM, including major improvements
|
2012-12-10 07:14:26 +08:00
|
|
|
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
|
2018-09-10 16:50:31 +08:00
|
|
|
from the `LLVM releases web site <https://llvm.org/releases/>`_.
|
2012-12-10 07:14:26 +08:00
|
|
|
|
|
|
|
|
For more information about LLVM, including information about the latest
|
2018-09-10 16:50:31 +08:00
|
|
|
release, please check out the `main LLVM web site <https://llvm.org/>`_. If you
|
2012-12-10 07:14:26 +08:00
|
|
|
have questions or comments, the `LLVM Developer's Mailing List
|
2018-09-10 16:50:31 +08:00
|
|
|
<https://lists.llvm.org/mailman/listinfo/llvm-dev>`_ is a good place to send
|
2012-12-10 07:14:26 +08:00
|
|
|
them.
|
|
|
|
|
|
2020-01-15 17:02:56 +08:00
|
|
|
Note that if you are reading this file from a Git checkout or the main
|
2012-12-10 07:14:26 +08:00
|
|
|
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
|
2018-09-10 16:50:31 +08:00
|
|
|
page <https://llvm.org/releases/>`_.
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2013-01-20 11:29:50 +08:00
|
|
|
Non-comprehensive list of changes in this release
|
|
|
|
|
=================================================
|
|
|
|
|
.. NOTE
|
|
|
|
|
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 `NOTE` below
|
|
|
|
|
for adding a new subsection.
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2022-04-02 22:26:14 +08:00
|
|
|
* ...
|
2019-11-09 02:05:37 +08:00
|
|
|
|
2022-04-02 22:26:14 +08:00
|
|
|
Update on required toolchains to build LLVM
|
2022-04-08 19:11:40 +08:00
|
|
|
-------------------------------------------
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2022-04-02 22:26:14 +08:00
|
|
|
With LLVM 15.x we will raise the version requirements of the toolchain used
|
|
|
|
|
to build LLVM. The new requirements are as follows:
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2022-04-02 22:26:14 +08:00
|
|
|
* GCC >= 7.1
|
|
|
|
|
* Clang >= 5.0
|
|
|
|
|
* Apple Clang >= 9.3
|
|
|
|
|
* Visual Studio 2019 >= 16.7
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2022-04-02 22:26:14 +08:00
|
|
|
In LLVM 15.x these requirements will be "soft" requirements and the version
|
|
|
|
|
check can be skipped by passing -DLLVM_TEMPORARILY_ALLOW_OLD_TOOLCHAIN=ON
|
|
|
|
|
to CMake.
|
|
|
|
|
|
|
|
|
|
With the release of LLVM 16.x these requirements will be hard and LLVM developers
|
|
|
|
|
can start using C++17 features, making it impossible to build with older
|
|
|
|
|
versions of these toolchains.
|
2019-12-25 10:12:15 +08:00
|
|
|
|
2016-03-29 14:55:56 +08:00
|
|
|
Changes to the LLVM IR
|
|
|
|
|
----------------------
|
|
|
|
|
|
2019-07-09 18:10:48 +08:00
|
|
|
Changes to building LLVM
|
|
|
|
|
------------------------
|
|
|
|
|
|
2022-04-29 17:42:06 +08:00
|
|
|
* Omitting ``CMAKE_BUILD_TYPE`` when using a single configuration generator is now
|
|
|
|
|
an error. You now have to pass ``-DCMAKE_BUILD_TYPE=<type>`` in order to configure
|
|
|
|
|
LLVM. This is done to help new users of LLVM select the correct type: since building
|
|
|
|
|
LLVM in Debug mode is very resource intensive, we want to make sure that new users
|
|
|
|
|
make the choice that lines up with their usage. We have also improved documentation
|
|
|
|
|
around this setting that should help new users. You can find this documentation
|
|
|
|
|
`here <https://llvm.org/docs/CMake.html#cmake-build-type>`_.
|
|
|
|
|
|
2020-08-22 05:22:06 +08:00
|
|
|
Changes to TableGen
|
|
|
|
|
-------------------
|
|
|
|
|
|
2021-06-22 23:43:36 +08:00
|
|
|
Changes to the AArch64 Backend
|
2021-06-28 20:51:27 +08:00
|
|
|
------------------------------
|
2021-06-22 23:43:36 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the AMDGPU Backend
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
* ...
|
|
|
|
|
|
2014-03-18 18:16:15 +08:00
|
|
|
Changes to the ARM Backend
|
|
|
|
|
--------------------------
|
|
|
|
|
|
2022-01-24 18:39:03 +08:00
|
|
|
* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
|
|
|
|
|
* Added support for the Armv8.1-M PACBTI-M extension.
|
|
|
|
|
* Added support for the Armv9-A, Armv9.1-A and Armv9.2-A architectures.
|
|
|
|
|
* Added support for the Armv8.1-M PACBTI-M extension.
|
|
|
|
|
* Removed the deprecation of ARMv8-A T32 Complex IT blocks. No deprecation
|
|
|
|
|
warnings will be generated and -mrestrict-it is now always off by default.
|
|
|
|
|
Previously it was on by default for Armv8 and off for all other architecture
|
|
|
|
|
versions.
|
|
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the AVR Backend
|
2014-07-23 20:59:26 +08:00
|
|
|
--------------------------
|
|
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
* ...
|
2015-01-11 18:34:52 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the Hexagon Backend
|
|
|
|
|
------------------------------
|
2021-05-13 21:25:04 +08:00
|
|
|
|
2021-07-28 12:51:07 +08:00
|
|
|
* ...
|
2014-07-23 20:59:26 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the MIPS Backend
|
|
|
|
|
---------------------------
|
2014-07-31 22:38:17 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
* ...
|
2014-07-31 22:38:17 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the PowerPC Backend
|
|
|
|
|
------------------------------
|
2015-12-21 10:37:23 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
* ...
|
2020-01-15 17:02:56 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the RISC-V Backend
|
2016-01-26 12:29:15 +08:00
|
|
|
-----------------------------
|
|
|
|
|
|
2022-03-18 01:12:09 +08:00
|
|
|
* The Zvfh extension was added.
|
2019-11-01 14:32:31 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the WebAssembly Backend
|
|
|
|
|
----------------------------------
|
2016-11-18 06:26:09 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
* ...
|
2016-11-18 06:26:09 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
Changes to the X86 Backend
|
|
|
|
|
--------------------------
|
2019-01-15 02:20:30 +08:00
|
|
|
|
2022-02-21 03:42:07 +08:00
|
|
|
* ...
|
2019-01-15 02:20:30 +08:00
|
|
|
|
2015-01-13 17:48:02 +08:00
|
|
|
Changes to the OCaml bindings
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
|
2017-06-30 09:17:45 +08:00
|
|
|
Changes to the C API
|
|
|
|
|
--------------------
|
2019-12-03 11:59:54 +08:00
|
|
|
|
2022-05-01 06:40:04 +08:00
|
|
|
* Add ``LLVMGetCastOpcode`` function to aid users of ``LLVMBuildCast`` in
|
|
|
|
|
resolving the best cast operation given a source value and destination type.
|
|
|
|
|
This function is a direct wrapper of ``CastInst::getCastOpcode``.
|
|
|
|
|
|
2019-12-03 11:59:54 +08:00
|
|
|
Changes to the Go bindings
|
|
|
|
|
--------------------------
|
2017-06-30 09:17:45 +08:00
|
|
|
|
2017-06-30 15:09:08 +08:00
|
|
|
|
2021-03-10 04:04:03 +08:00
|
|
|
Changes to the FastISel infrastructure
|
|
|
|
|
--------------------------------------
|
|
|
|
|
|
2021-07-28 12:51:07 +08:00
|
|
|
* ...
|
2021-03-10 04:04:03 +08:00
|
|
|
|
Set ADDE/ADDC/SUBE/SUBC to expand by default
Summary:
They've been deprecated in favor of UADDO/ADDCARRY or USUBO/SUBCARRY for a while.
Target that uses these opcodes are changed in order to ensure their behavior doesn't change.
Reviewers: efriedma, craig.topper, dblaikie, bkramer
Subscribers: jholewinski, arsenm, jyknight, sdardis, nemanjai, nhaehnle, kbarton, fedor.sergeev, asb, rbar, johnrusso, simoncook, jordy.potman.lists, apazos, sabuasal, niosHD, jrtc27, zzheng, edward-jones, mgrang, atanasyan, llvm-commits
Differential Revision: https://reviews.llvm.org/D47422
llvm-svn: 333748
2018-06-01 21:21:33 +08:00
|
|
|
Changes to the DAG infrastructure
|
|
|
|
|
---------------------------------
|
2018-06-05 02:36:22 +08:00
|
|
|
|
2020-04-07 18:05:22 +08:00
|
|
|
|
|
|
|
|
Changes to the Debug Info
|
|
|
|
|
---------------------------------
|
|
|
|
|
|
2020-07-15 17:40:53 +08:00
|
|
|
During this release ...
|
2020-04-07 18:05:22 +08:00
|
|
|
|
2020-04-10 16:33:33 +08:00
|
|
|
Changes to the LLVM tools
|
|
|
|
|
---------------------------------
|
|
|
|
|
|
2019-07-06 01:58:30 +08:00
|
|
|
Changes to LLDB
|
2020-07-17 01:07:12 +08:00
|
|
|
---------------------------------
|
2019-07-06 01:58:30 +08:00
|
|
|
|
2020-08-15 05:05:57 +08:00
|
|
|
Changes to Sanitizers
|
|
|
|
|
---------------------
|
|
|
|
|
|
2022-04-27 20:14:39 +08:00
|
|
|
|
|
|
|
|
Other Changes
|
|
|
|
|
-------------
|
|
|
|
|
* The code for the `LLVM Visual Studio integration
|
|
|
|
|
<https://marketplace.visualstudio.com/items?itemName=LLVMExtensions.llvm-toolchain>`_
|
|
|
|
|
has been removed. This had been obsolete and abandoned since Visual Studio
|
|
|
|
|
started including an integration by default in 2019.
|
|
|
|
|
|
2022-02-02 15:29:29 +08:00
|
|
|
External Open Source Projects Using LLVM 15
|
2019-07-18 19:51:05 +08:00
|
|
|
===========================================
|
2015-01-13 17:48:02 +08:00
|
|
|
|
2016-07-19 02:02:23 +08:00
|
|
|
* A project...
|
2013-11-14 13:57:40 +08:00
|
|
|
|
2012-12-10 07:14:26 +08:00
|
|
|
Additional Information
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
A wide variety of additional information is available on the `LLVM web page
|
2018-09-10 16:50:31 +08:00
|
|
|
<https://llvm.org/>`_, in particular in the `documentation
|
|
|
|
|
<https://llvm.org/docs/>`_ section. The web page also contains versions of the
|
2020-01-15 17:02:56 +08:00
|
|
|
API documentation which is up-to-date with the Git version of the source
|
2012-12-10 07:14:26 +08:00
|
|
|
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
|
2018-09-10 16:50:31 +08:00
|
|
|
us via the `mailing lists <https://llvm.org/docs/#mailing-lists>`_.
|
