diff options
Diffstat (limited to 'contrib/llvm/tools/gold/README.txt')
-rw-r--r-- | contrib/llvm/tools/gold/README.txt | 21 |
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. |