llvm.org GIT mirror llvm / b70b8c3
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 Bill Wendling 6 years ago
1 changed file(s) with 6 addition(s) and 14 deletion(s). Raw diff Collapse all Expand all
0 The LLVM Gold LTO Plugin
1 ========================
2
3 This directory contains a plugin that is designed to work with binutils
14 gold linker. At present time, this is not the default linker in
25 binutils, and the default build of gold does not support plugins.
36
4 Obtaining binutils:
7 See docs/GoldPlugin.html for complete build and usage instructions.
58
6 cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src login
7 {enter "anoncvs" as the password}
8 cvs -z 9 -d :pserver:anoncvs@sourceware.org:/cvs/src co binutils
9
10 This will create a src/ directory. Make a build/ directory and from
11 there configure binutils with "../src/configure --enable-gold --enable-plugins".
12 Then build binutils with "make all-gold".
13
14 To build the LLVMgold plugin, configure LLVM with the option
15 --with-binutils-include=/path/to/binutils/src/include/ --enable-pic. To use the
16 plugin, run "ld-new --plugin /path/to/LLVMgold.so".
17 Without PIC libLTO and LLVMgold are not being built (because they would fail
18 link on x86-64 with a relocation error: PIC and non-PIC can't be combined).
9 NOTE: libLTO and LLVMgold aren't built without PIC because they would fail
10 to link on x86-64 with a relocation error: PIC and non-PIC can't be combined.
1911 As an alternative to passing --enable-pic, you can use 'make ENABLE_PIC=1' in
2012 your entire LLVM build.