llvm-project

History

Rafael Espindola ece7c9c282 If present, use gold's support for getting a file view. This prevents having to map the file both in the linker and in the plugin. llvm-svn: 129109		2011-04-07 21:11:00 +00:00
..
CMakeLists.txt	Force re-linking of LLVMgold.so when its exports file changes.	2011-03-11 18:27:13 +00:00
Makefile	Now to chant the magical incantation that will exorcise the System library	2010-11-29 19:44:50 +00:00
README.txt	s/libLLVMgold/LLVMgold/g	2010-08-08 21:14:26 +00:00
gold-plugin.cpp	If present, use gold's support for getting a file view. This prevents having	2011-04-07 21:11:00 +00:00
gold.exports	Create an exports file, so that the plugin only exports the onload symbol.	2010-04-16 00:43:25 +00:00

README.txt

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.