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