summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRui Ueyama <ruiu@google.com>2018-10-01 16:41:58 +0000
committerRui Ueyama <ruiu@google.com>2018-10-01 16:41:58 +0000
commit27255ebc496aa32d9c94be47a1c7d204591157b1 (patch)
treec4d94d4a98b012298650783b683ad81fdc781bbc
parent63bfd2ff43142fa36bdecd005fe6f705b0e2e625 (diff)
Add an explanation about cross linking.
Differential Revision: https://reviews.llvm.org/D52567
-rw-r--r--lld/docs/ld.lld.119
1 files changed, 17 insertions, 2 deletions
diff --git a/lld/docs/ld.lld.1 b/lld/docs/ld.lld.1
index 91d6ddfa074..5094253419d 100644
--- a/lld/docs/ld.lld.1
+++ b/lld/docs/ld.lld.1
@@ -3,7 +3,7 @@
.\"
.\" This man page documents only lld's ELF linking support, obtained originally
.\" from FreeBSD.
-.Dd September 14, 2018
+.Dd September 26, 2018
.Dt LD.LLD 1
.Os
.Sh NAME
@@ -13,6 +13,7 @@
.Nm ld.lld
.Op Ar options
.Ar objfile ...
+
.Sh DESCRIPTION
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
@@ -25,7 +26,21 @@ is a drop-in replacement for the GNU BFD and gold linkers.
It accepts most of the same command line arguments and linker scripts
as GNU linkers.
.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
.It Fl -allow-multiple-definition
Do not error if a symbol is defined multiple times.