aboutsummaryrefslogtreecommitdiffstats
path: root/tools
diff options
context:
space:
mode:
authorBill Wendling <isanbard@gmail.com>2013-12-02 19:20:45 +0000
committerBill Wendling <isanbard@gmail.com>2013-12-02 19:20:45 +0000
commitb70b8c3a931ad81256f193c81be6487f936357a8 (patch)
tree3b9c48ffd745eac780cc8dda54fd160bc861e538 /tools
parentf204272976c23aa801043393417a1de47253c194 (diff)
downloadexternal_llvm-b70b8c3a931ad81256f193c81be6487f936357a8.zip
external_llvm-b70b8c3a931ad81256f193c81be6487f936357a8.tar.gz
external_llvm-b70b8c3a931ad81256f193c81be6487f936357a8.tar.bz2
Merging r196100:
------------------------------------------------------------------------ r196100 | alp | 2013-12-02 06:17:47 -0800 (Mon, 02 Dec 2013) | 4 lines Cut the gold plugin README down to size This file hasn't been updated in years. Remove old information and point to the current documentation at GoldPlugin.rst. ------------------------------------------------------------------------ git-svn-id: https://llvm.org/svn/llvm-project/llvm/branches/release_34@196135 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'tools')
-rw-r--r--tools/gold/README.txt20
1 files changed, 6 insertions, 14 deletions
diff --git a/tools/gold/README.txt b/tools/gold/README.txt
index a906a90..286d9af 100644
--- a/tools/gold/README.txt
+++ b/tools/gold/README.txt
@@ -1,21 +1,13 @@
+The LLVM Gold LTO Plugin
+========================
+
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".
+See docs/GoldPlugin.html for complete build and usage instructions.
-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).
+NOTE: libLTO and LLVMgold aren't built without PIC because they would fail
+to 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.