1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
===========================
lld |release| Release Notes
===========================
.. contents::
:local:
.. only:: PreRelease
.. warning::
These are in-progress notes for the upcoming LLVM |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 lld linker, release |release|.
Here we describe the status of lld, including major improvements
from the previous release. All lld releases may be downloaded
from the `LLVM releases web site <https://llvm.org/releases/>`_.
Non-comprehensive list of changes in this release
=================================================
ELF Improvements
----------------
* Added ``-z dynamic-undefined-weak`` to make undefined weak symbols dynamic
when the dynamic symbol table is present.
(`#143831 <https://github.com/llvm/llvm-project/pull/143831>`_)
* For ``-z undefs`` (default for ``-shared``), relocations referencing undefined
strong symbols now behave like relocations referencing undefined weak symbols.
* ``--why-live=<glob>`` prints for each symbol matching ``<glob>`` a chain of
items that kept it live during garbage collection. This is inspired by the
Mach-O LLD feature of the same name.
* ``--thinlto-distributor=`` and ``--thinlto-remote-compiler=`` options are
added to support Integrated Distributed ThinLTO.
(`#142757 <https://github.com/llvm/llvm-project/pull/142757>`_)
* Linker script ``OVERLAY`` descriptions now support virtual memory regions
(e.g. ``>region``) and ``NOCROSSREFS``.
* When the last ``PT_LOAD`` segment is executable and includes BSS sections,
its ``p_memsz`` member is now correct.
(`#139207 <https://github.com/llvm/llvm-project/pull/139207>`_)
* Spurious ``ASSERT`` errors before the layout converges are now fixed.
* For ARM and AArch64, ``--xosegment`` and ``--no-xosegment`` control whether
to place executable-only and readable-executable sections in the same
segment. The default option is ``--no-xosegment``.
(`#132412 <https://github.com/llvm/llvm-project/pull/132412>`_)
* For AArch64, added support for the ``SHF_AARCH64_PURECODE`` section flag,
which indicates that the section only contains program code and no data.
An output section will only have this flag set if all input sections also
have it set. (`#125689 <https://github.com/llvm/llvm-project/pull/125689>`_,
`#134798 <https://github.com/llvm/llvm-project/pull/134798>`_)
* For AArch64 and ARM, added ``-zexecute-only-report``, which checks for
missing ``SHF_AARCH64_PURECODE`` and ``SHF_ARM_PURECODE`` section flags
on executable sections.
(`#128883 <https://github.com/llvm/llvm-project/pull/128883>`_)
* For AArch64, ``-z nopac-plt`` has been added.
* For AArch64 and X86_64, added ``--branch-to-branch``, which rewrites branches
that point to another branch instruction to instead branch directly to the
target of the second instruction. Enabled by default at ``-O2``.
* For AArch64, added support for ``-zgcs-report-dynamic``, enabling checks for
GNU GCS Attribute Flags in Dynamic Objects when GCS is enabled. Inherits value
from ``-zgcs-report`` (capped at ``warning`` level) unless user-defined,
ensuring compatibility with GNU ld linker.
* The default Hexagon architecture version in ELF object files produced by
lld is changed to v68. This change is only effective when the version is
not provided in the command line by the user and cannot be inferred from
inputs.
* For LoongArch, the initial-exec to local-exec TLS optimization has been implemented.
* For LoongArch, several relaxation optimizations are supported, including relaxation for
``R_LARCH_PCALA_HI20/LO12`` and ``R_LARCH_GOT_PC_HI20/LO12`` relocations, instruction
relaxation for ``R_LARCH_CALL36``, TLS local-exec (``LE``)/global dynamic (``GD``)/
local dynamic (``LD``) model relaxation, and TLSDESC code sequence relaxation.
* For RISCV, an oscillation bug due to call relaxation is now fixed.
(`#142899 <https://github.com/llvm/llvm-project/pull/142899>`_)
* For x86-64, the ``.ltext`` section is now placed before ``.rodata``.
Breaking changes
----------------
* Executable-only and readable-executable sections are now allowed to be placed
in the same segment by default. Pass ``--xosegment`` to lld in order to get
the old behavior back.
* When using ``--no-pie`` without a ``SECTIONS`` command, the linker uses the
target's default image base. If ``-Ttext=`` or ``--section-start`` specifies
an output section address below this base, there will now be an error.
``--image-base`` can be set at a lower address to fix the error.
(`#140187 <https://github.com/llvm/llvm-project/pull/140187>`_)
COFF Improvements
-----------------
MinGW Improvements
------------------
MachO Improvements
------------------
WebAssembly Improvements
------------------------
Fixes
#####
|
