summaryrefslogtreecommitdiffstats
path: root/contrib/llvm/tools/gold/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/llvm/tools/gold/README.txt')
-rw-r--r--contrib/llvm/tools/gold/README.txt21
1 files changed, 21 insertions, 0 deletions
diff --git a/contrib/llvm/tools/gold/README.txt b/contrib/llvm/tools/gold/README.txt
new file mode 100644
index 0000000..a906a90
--- /dev/null
+++ b/contrib/llvm/tools/gold/README.txt
@@ -0,0 +1,21 @@
+This directory contains a plugin that is designed to work with binutils
+gold linker. At present time, this is not the default linker in
+binutils, and the default build of gold does not support plugins.
+
+Obtaining binutils:
+
+ cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src login
+ {enter "anoncvs" as the password}
+ cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src co binutils
+
+This will create a src/ directory. Make a build/ directory and from
+there configure binutils with "../src/configure --enable-gold --enable-plugins".
+Then build binutils with "make all-gold".
+
+To build the LLVMgold plugin, configure LLVM with the option
+--with-binutils-include=/path/to/binutils/src/include/ --enable-pic. To use the
+plugin, run "ld-new --plugin /path/to/LLVMgold.so".
+Without PIC libLTO and LLVMgold are not being built (because they would fail
+link on x86-64 with a relocation error: PIC and non-PIC can't be combined).
+As an alternative to passing --enable-pic, you can use 'make ENABLE_PIC=1' in
+your entire LLVM build.
OpenPOWER on IntegriCloud