llvm-capstone/lld
Fangrui Song 4bbcd63eea [ELF] Add -z start-stop-gc to let __start_/__stop_ not retain C identifier name sections
For one metadata section usage, each text section references a metadata section.
The metadata sections have a C identifier name to allow the runtime to collect them via `__start_/__stop_` symbols.

Since `__start_`/`__stop_` references are always present from live sections, the
C identifier name sections appear like GC roots, which means they cannot be
discarded by `ld --gc-sections`.

To make such sections GCable, either SHF_LINK_ORDER or a section group is needed.

SHF_LINK_ORDER is not suitable for the references can be inlined into other functions
(See D97430:
Function A (in the section .text.A) references its `__sancov_guard` section.
Function B inlines A (so now .text.B references `__sancov_guard` - this is invalid with the semantics of SHF_LINK_ORDER).

In the linking stage,
if `.text.A` gets discarded, and `__sancov_guard` is retained via the reference from `.text.B`,
the output will be invalid because `__sancov_guard` references the discarded `.text.A`.
LLD errors "sh_link points to discarded section".
)

A section group have size overhead, and is cumbersome when there is just one metadata section.

Add `-z start-stop-gc` to drop the "__start_/__stop_ references retain
non-SHF_LINK_ORDER non-SHF_GROUP C identifier name sections" rule.
We reserve the rights to switch the default in the future.

Reviewed By: phosek, jrtc27

Differential Revision: https://reviews.llvm.org/D96914
2021-02-25 15:46:37 -08:00
..
cmake/modules
COFF [LLD] [COFF] Allow invoking lib.exe mode via -lib in addition to /lib 2021-02-24 11:16:12 +02:00
Common [lld/mac] Add --reproduce option 2020-11-30 08:40:21 -05:00
docs [ELF] Add -z start-stop-gc to let __start_/__stop_ not retain C identifier name sections 2021-02-25 15:46:37 -08:00
ELF [ELF] Add -z start-stop-gc to let __start_/__stop_ not retain C identifier name sections 2021-02-25 15:46:37 -08:00
include/lld fix comment typo to cycle bots 2021-02-17 11:49:23 -05:00
lib [MachO] Fix enum-int mismatch warning 2020-12-28 17:39:41 +01:00
MachO [lld-macho] Basic support for linkage and visibility attributes in LTO 2021-02-25 13:27:40 -05:00
MinGW [LLD] [MinGW] Pass the --demangle and --no-demangle options to the COFF linker 2021-01-07 10:02:19 +02:00
test [ELF] Add -z start-stop-gc to let __start_/__stop_ not retain C identifier name sections 2021-02-25 15:46:37 -08:00
tools/lld lld: Fix darwinnew symlink name added in e16c0a9a68 2020-11-24 11:06:51 -05:00
unittests
utils
wasm [lld][WebAssembly] Fix resolveIndirectFunctionTable for relocatable output 2021-02-18 09:33:54 +01:00
.clang-format
.clang-tidy
.gitignore
CMakeLists.txt Revert "[CMake] Actually require python 3.6 or greater" 2021-01-29 12:03:32 -08:00
CODE_OWNERS.TXT
LICENSE.TXT
README.md [doc] Place sha256 in lld/README.md into backticks 2021-01-12 10:19:40 -08:00

LLVM Linker (lld)

This directory and its subdirectories contain source code for the LLVM Linker, a modular cross platform linker which is built as part of the LLVM compiler infrastructure project.

lld is open source software. You may freely distribute it under the terms of the license agreement found in LICENSE.txt.

Benchmarking

In order to make sure various developers can evaluate patches over the same tests, we create a collection of self contained programs.

It is hosted at https://s3-us-west-2.amazonaws.com/linker-tests/lld-speed-test.tar.xz

The current sha256 is 10eec685463d5a8bbf08d77f4ca96282161d396c65bd97dc99dbde644a31610f.