2016-07-19 02:02:23 +08:00
|
|
|
========================
|
2018-01-03 23:45:32 +08:00
|
|
|
LLVM 7.0.0 Release Notes
|
2016-07-19 02:02:23 +08:00
|
|
|
========================
|
2012-12-10 07:14:26 +08:00
|
|
|
|
|
|
|
.. contents::
|
|
|
|
:local:
|
|
|
|
|
2013-01-20 11:29:50 +08:00
|
|
|
.. warning::
|
2018-01-03 23:45:32 +08:00
|
|
|
These are in-progress notes for the upcoming LLVM 7 release.
|
2017-02-10 07:03:34 +08:00
|
|
|
Release notes for previous releases can be found on
|
|
|
|
`the Download Page <http://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,
|
2018-01-03 23:45:32 +08:00
|
|
|
release 7.0.0. 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
|
|
|
|
from the `LLVM releases web site <http://llvm.org/releases/>`_.
|
|
|
|
|
|
|
|
For more information about LLVM, including information about the latest
|
|
|
|
release, please check out the `main LLVM web site <http://llvm.org/>`_. If you
|
|
|
|
have questions or comments, the `LLVM Developer's Mailing List
|
2015-08-05 11:51:17 +08:00
|
|
|
<http://lists.llvm.org/mailman/listinfo/llvm-dev>`_ is a good place to send
|
2012-12-10 07:14:26 +08:00
|
|
|
them.
|
|
|
|
|
|
|
|
Note that if you are reading this file from a Subversion 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 <http://llvm.org/releases/>`_.
|
|
|
|
|
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
|
|
|
|
2018-03-29 17:44:09 +08:00
|
|
|
* Libraries have been renamed from 7.0 to 7. This change also impacts
|
|
|
|
downstream libraries like lldb.
|
|
|
|
|
2018-03-13 04:49:42 +08:00
|
|
|
* The LoopInstSimplify pass (-loop-instsimplify) has been removed.
|
|
|
|
|
2018-03-17 04:13:32 +08:00
|
|
|
* Symbols starting with ``?`` are no longer mangled by LLVM when using the
|
|
|
|
Windows ``x`` or ``w`` IR mangling schemes.
|
|
|
|
|
2018-04-04 19:37:06 +08:00
|
|
|
* A new tool named :doc:`llvm-exegesis <CommandGuide/llvm-exegesis>` has been
|
|
|
|
added. :program:`llvm-exegesis` automatically measures instruction scheduling
|
|
|
|
properties (latency/uops) and provides a principled way to edit scheduling
|
|
|
|
models.
|
|
|
|
|
2018-03-20 18:25:36 +08:00
|
|
|
* A new tool named :doc:`llvm-mca <CommandGuide/llvm-mca>` has been added.
|
|
|
|
:program:`llvm-mca` is a static performance analysis tool that uses
|
|
|
|
information available in LLVM to statically predict the performance of
|
|
|
|
machine code for a specific CPU.
|
|
|
|
|
2018-04-07 05:11:09 +08:00
|
|
|
* The optimization flag to merge constants (-fmerge-all-constants) is no longer
|
|
|
|
applied by default.
|
|
|
|
|
2018-04-20 23:07:55 +08:00
|
|
|
* Optimization of floating-point casts is improved. This may cause surprising
|
2018-04-28 00:33:35 +08:00
|
|
|
results for code that is relying on the undefined behavior of overflowing
|
|
|
|
casts. The optimization can be disabled by specifying a function attribute:
|
2018-05-01 02:20:33 +08:00
|
|
|
"strict-float-cast-overflow"="false". This attribute may be created by the
|
|
|
|
clang option :option:`-fno-strict-float-cast-overflow`.
|
2018-04-28 00:33:35 +08:00
|
|
|
Code sanitizers can be used to detect affected patterns. The option for
|
|
|
|
detecting this problem alone is "-fsanitize=float-cast-overflow":
|
2018-04-20 23:07:55 +08:00
|
|
|
|
|
|
|
.. code-block:: c
|
|
|
|
|
|
|
|
int main() {
|
|
|
|
float x = 4294967296.0f;
|
|
|
|
x = (float)((int)x);
|
|
|
|
printf("junk in the ftrunc: %f\n", x);
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
2018-04-27 01:04:07 +08:00
|
|
|
clang -O1 ftrunc.c -fsanitize=float-cast-overflow ; ./a.out
|
2018-04-20 23:07:55 +08:00
|
|
|
ftrunc.c:5:15: runtime error: 4.29497e+09 is outside the range of representable values of type 'int'
|
|
|
|
junk in the ftrunc: 0.000000
|
|
|
|
|
2018-05-01 04:19:48 +08:00
|
|
|
* ``LLVM_ON_WIN32`` is no longer set by ``llvm/Config/config.h`` and
|
|
|
|
``llvm/Config/llvm-config.h``. If you used this macro, use the compiler-set
|
|
|
|
``_WIN32`` instead which is set exactly when ``LLVM_ON_WIN32`` used to be set.
|
2018-04-20 23:07:55 +08:00
|
|
|
|
2018-06-04 21:55:09 +08:00
|
|
|
* The ``DEBUG`` macro has been renamed to ``LLVM_DEBUG``. The interface remains
|
|
|
|
the same. If you used this macro you need to migrate to the new one, you can
|
|
|
|
do this with the following bash command:
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
git grep -l 'DEBUG' | xargs perl -pi -e 's/\bDEBUG\s?\(/LLVM_DEBUG(/g'
|
|
|
|
|
|
|
|
Additionally, you can clang-format your code to make it easier to integrate
|
|
|
|
future changes locally. This can be done with the following bash command:
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
git diff -U0 master | ../clang/tools/clang-format/clang-format-diff.py -i -p1 -style LLVM
|
|
|
|
|
2017-07-19 22:09:16 +08:00
|
|
|
* Note..
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2013-01-20 11:29:50 +08:00
|
|
|
.. NOTE
|
|
|
|
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
|
|
|
|
and un-indent it (the indentation causes it to be inside this comment).
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2013-01-20 11:29:50 +08:00
|
|
|
Special New Feature
|
|
|
|
-------------------
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2013-01-20 11:29:50 +08:00
|
|
|
Makes programs 10x faster by doing Special New Thing.
|
2012-12-10 07:14:26 +08:00
|
|
|
|
2016-03-29 14:55:56 +08:00
|
|
|
Changes to the LLVM IR
|
|
|
|
----------------------
|
|
|
|
|
2018-02-06 03:39:38 +08:00
|
|
|
* The signatures for the builtins @llvm.memcpy, @llvm.memmove, and @llvm.memset
|
|
|
|
have changed. Alignment is no longer an argument, and are instead conveyed as
|
|
|
|
parameter attributes.
|
|
|
|
|
2018-05-03 19:03:01 +08:00
|
|
|
* invariant.group.barrier has been renamed to launder.invariant.group.
|
|
|
|
|
2018-05-19 07:53:46 +08:00
|
|
|
* invariant.group metadata can now refer only empty metadata nodes.
|
|
|
|
|
2014-03-18 18:16:15 +08:00
|
|
|
Changes to the ARM Backend
|
|
|
|
--------------------------
|
|
|
|
|
2014-08-23 05:57:38 +08:00
|
|
|
During this release ...
|
|
|
|
|
2014-03-18 18:16:15 +08:00
|
|
|
|
2014-07-23 20:59:26 +08:00
|
|
|
Changes to the MIPS Target
|
|
|
|
--------------------------
|
|
|
|
|
2015-01-15 02:07:30 +08:00
|
|
|
During this release ...
|
2015-01-11 18:34:52 +08:00
|
|
|
|
2014-07-23 20:59:26 +08:00
|
|
|
|
2014-07-31 22:38:17 +08:00
|
|
|
Changes to the PowerPC Target
|
2014-07-31 23:20:30 +08:00
|
|
|
-----------------------------
|
2014-07-31 22:38:17 +08:00
|
|
|
|
2016-07-19 02:02:23 +08:00
|
|
|
During this release ...
|
2014-07-31 22:38:17 +08:00
|
|
|
|
2015-12-21 10:37:23 +08:00
|
|
|
Changes to the X86 Target
|
2016-03-29 14:55:56 +08:00
|
|
|
-------------------------
|
2015-12-21 10:37:23 +08:00
|
|
|
|
2016-07-19 02:02:23 +08:00
|
|
|
During this release ...
|
2015-12-21 10:37:23 +08:00
|
|
|
|
2016-01-26 12:29:15 +08:00
|
|
|
Changes to the AMDGPU Target
|
|
|
|
-----------------------------
|
|
|
|
|
2016-07-19 02:02:23 +08:00
|
|
|
During this release ...
|
2015-12-21 10:37:23 +08:00
|
|
|
|
2016-11-18 06:26:09 +08:00
|
|
|
Changes to the AVR Target
|
|
|
|
-----------------------------
|
|
|
|
|
2017-01-13 05:50:22 +08:00
|
|
|
During this release ...
|
2016-11-18 06:26:09 +08:00
|
|
|
|
2015-01-13 17:48:02 +08:00
|
|
|
Changes to the OCaml bindings
|
|
|
|
-----------------------------
|
|
|
|
|
2018-05-29 00:58:10 +08:00
|
|
|
* Remove ``add_bb_vectorize``.
|
2015-01-13 17:48:02 +08:00
|
|
|
|
2016-02-18 03:35:47 +08:00
|
|
|
|
2017-06-30 09:17:45 +08:00
|
|
|
Changes to the C API
|
|
|
|
--------------------
|
|
|
|
|
2018-05-29 00:58:10 +08:00
|
|
|
* Remove ``LLVMAddBBVectorizePass``. The implementation was removed and the C
|
|
|
|
interface was made a deprecated no-op in LLVM 5. Use
|
|
|
|
``LLVMAddSLPVectorizePass`` instead to get the supported SLP vectorizer.
|
2017-06-30 15:09:08 +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
|
|
|
|
---------------------------------
|
|
|
|
* ADDC/ADDE/SUBC/SUBE are now deprecated and will default to expand. Backends
|
|
|
|
that wish to continue to use these opcodes should explicitely request so
|
|
|
|
using ``setOperationAction`` in their ``TargetLowering``. New backends
|
|
|
|
should use UADDO/ADDCARRY/USUBO/SUBCARRY instead of the deprecated opcodes.
|
2017-06-30 09:17:45 +08:00
|
|
|
|
2018-01-03 23:45:32 +08:00
|
|
|
External Open Source Projects Using LLVM 7
|
2017-01-13 05:50:22 +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
|
|
|
|
<http://llvm.org/>`_, in particular in the `documentation
|
|
|
|
<http://llvm.org/docs/>`_ section. The web page also contains versions of the
|
|
|
|
API documentation which is up-to-date with the Subversion 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 `mailing lists <http://llvm.org/docs/#maillist>`_.
|