1========================
2lld 14.0.0 Release Notes
3========================
4
5.. contents::
6    :local:
7
8.. warning::
9   These are in-progress notes for the upcoming LLVM 14.0.0 release.
10   Release notes for previous releases can be found on
11   `the Download Page <https://releases.llvm.org/download.html>`_.
12
13Introduction
14============
15
16This document contains the release notes for the lld linker, release 14.0.0.
17Here we describe the status of lld, including major improvements
18from the previous release. All lld releases may be downloaded
19from the `LLVM releases web site <https://llvm.org/releases/>`_.
20
21Non-comprehensive list of changes in this release
22=================================================
23
24ELF Improvements
25----------------
26
27* ``--export-dynamic-symbol-list`` has been added.
28  (`D107317 <https://reviews.llvm.org/D107317>`_)
29* ``--why-extract`` has been added to query why archive members/lazy object files are extracted.
30  (`D109572 <https://reviews.llvm.org/D109572>`_)
31* ``e_entry`` no longer falls back to the address of ``.text`` if the entry symbol does not exist.
32  Instead, a value of 0 will be written.
33  (`D110014 <https://reviews.llvm.org/D110014>`_)
34* If ``-Map`` is specified, ``--cref`` will be printed to the specified file.
35  (`D114663 <https://reviews.llvm.org/D114663>`_)
36
37Architecture specific changes:
38
39* The x86-32 port now supports TLSDESC (``-mtls-dialect=gnu2``).
40  (`D112582 <https://reviews.llvm.org/D112582>`_)
41* The x86-64 port now handles non-RAX/non-adjacent ``R_X86_64_GOTPC32_TLSDESC``
42  and ``R_X86_64_TLSDESC_CALL`` (``-mtls-dialect=gnu2``).
43  (`D114416 <https://reviews.llvm.org/D114416>`_)
44* For x86-64, ``--no-relax`` now suppresses ``R_X86_64_GOTPCRELX`` and
45  ``R_X86_64_REX_GOTPCRELX`` GOT optimization
46  (`D113615 <https://reviews.llvm.org/D113615>`_)
47
48Breaking changes
49----------------
50
51* ...
52
53COFF Improvements
54-----------------
55
56* ...
57
58MinGW Improvements
59------------------
60
61* ...
62
63MachO Improvements
64------------------
65
66* Item 1.
67
68WebAssembly Improvements
69------------------------
70
71