README.txt
1This directory contains a plugin that is designed to work with binutils
2gold linker. At present time, this is not the default linker in
3binutils, and the default build of gold does not support plugins.
4
5Obtaining binutils:
6
7 cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src login
8 {enter "anoncvs" as the password}
9 cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src co binutils
10
11This will create a src/ directory. Make a build/ directory and from
12there configure binutils with "../src/configure --enable-gold --enable-plugins".
13Then build binutils with "make all-gold".
14
15To build the LLVMgold plugin, configure LLVM with the option
16--with-binutils-include=/path/to/binutils/src/include/ --enable-pic. To use the
17plugin, run "ld-new --plugin /path/to/LLVMgold.so".
18Without PIC libLTO and LLVMgold are not being built (because they would fail
19link on x86-64 with a relocation error: PIC and non-PIC can't be combined).
20As an alternative to passing --enable-pic, you can use 'make ENABLE_PIC=1' in
21your entire LLVM build.
22