This is an archive of the discontinued LLVM Phabricator instance.

Differential D52567

Add an explanation about cross linking.
ClosedPublic

Authored by ruiu on Sep 26 2018, 11:33 AM.

Details

Reviewers
emaste
mstorsjo
Commits
rG1e591d807ba4: Add an explanation about cross linking.
rLLD343495: Add an explanation about cross linking.
rL343495: Add an explanation about cross linking.
Summary

Add an explanation about cross linking.

Diff Detail

Event Timeline

ruiu created this revision.Sep 26 2018, 11:33 AM
Herald added a subscriber: fedor.sergeev. · View Herald TranscriptSep 26 2018, 11:33 AM
Harbormaster completed remote builds in B23159: Diff 167169.Sep 26 2018, 11:33 AM
kristina added a subscriber: kristina.Sep 28 2018, 3:38 PM

LGTM. Makes sense considering the confusion of some from ld.lld only saying it can handle ELF files.

mstorsjo accepted this revision.Sep 29 2018, 10:56 AM
mstorsjo added a subscriber: mstorsjo.

LGTM too

This revision is now accepted and ready to land.Sep 29 2018, 10:56 AM
Closed by commit rL343495: Add an explanation about cross linking. (authored by ruiu). · Explain WhyOct 1 2018, 9:43 AM
This revision was automatically updated to reflect the committed changes.

Revision Contents

PathSize
lld/
docs/
19 lines

Diff 167169

lld/docs/ld.lld.1

.\" This file is distributed under the University of Illinois Open Source .\" This file is distributed under the University of Illinois Open Source
.\" License. See LICENSE.TXT for details. .\" License. See LICENSE.TXT for details.
.\" .\"
.\" This man page documents only lld's ELF linking support, obtained originally .\" This man page documents only lld's ELF linking support, obtained originally
.\" from FreeBSD. .\" from FreeBSD.
.Dd September 14, 2018 .Dd September 26, 2018
.Dt LD.LLD 1 .Dt LD.LLD 1
.Os .Os
.Sh NAME .Sh NAME
.Nm ld.lld .Nm ld.lld
.Nd ELF linker from the LLVM project .Nd ELF linker from the LLVM project
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm ld.lld .Nm ld.lld
.Op Ar options .Op Ar options
.Ar objfile ... .Ar objfile ...
.Sh DESCRIPTION .Sh DESCRIPTION
A linker takes one or more object, archive, and library files, and combines A linker takes one or more object, archive, and library files, and combines
them into an output file (an executable, a shared library, or another object them into an output file (an executable, a shared library, or another object
file). file).
It relocates code and data from the input files and resolves symbol It relocates code and data from the input files and resolves symbol
references between them. references between them.
.Pp .Pp
.Nm .Nm
is a drop-in replacement for the GNU BFD and gold linkers. is a drop-in replacement for the GNU BFD and gold linkers.
It accepts most of the same command line arguments and linker scripts It accepts most of the same command line arguments and linker scripts
as GNU linkers. as GNU linkers.
.Pp .Pp
These options are available: .Nm
currently supports i386, x86-64, ARM, AArch64, PowerPC32, PowerPC64,
MIPS32, MIPS64, RISC-V, AMDGPU, Hexagon and SPARC V9 targets.
.Nm
acts as a Microsoft link.exe-compatible linker if invoked as
.Nm lld-link
and as macOS's ld if invoked as
.Nm ld.ld64.
All these targets are always supported however
.Nm
was built, so you can always use
.Nm
as a native linker as well as a cross linker.
.Sh OPTIONS
.Bl -tag -width indent .Bl -tag -width indent
.It Fl -allow-multiple-definition .It Fl -allow-multiple-definition
Do not error if a symbol is defined multiple times. Do not error if a symbol is defined multiple times.
The first definition will be used. The first definition will be used.
.It Fl -apply-dynamic-relocs .It Fl -apply-dynamic-relocs
Apply link-time values for dynamic relocations. Apply link-time values for dynamic relocations.
.It Fl -as-needed .It Fl -as-needed
Only set Only set
▲ Show 20 Lines • Show All 540 Lines • Show Last 20 Lines