[llvm] r306102 - [docs] As of binutils 2.21.51.0.2, ld.bfd supports plugins too, represent this in docs

Ekaterina Vaartis via llvm-commits llvm-commits at lists.llvm.org
Fri Jun 23 06:54:11 PDT 2017


Author: vaartis
Date: Fri Jun 23 08:54:10 2017
New Revision: 306102

URL: http://llvm.org/viewvc/llvm-project?rev=306102&view=rev
Log:
[docs] As of binutils 2.21.51.0.2, ld.bfd supports plugins too, represent this in docs

PR#32760


Modified:
    llvm/trunk/docs/GoldPlugin.rst

Modified: llvm/trunk/docs/GoldPlugin.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GoldPlugin.rst?rev=306102&r1=306101&r2=306102&view=diff
==============================================================================
--- llvm/trunk/docs/GoldPlugin.rst (original)
+++ llvm/trunk/docs/GoldPlugin.rst Fri Jun 23 08:54:10 2017
@@ -7,7 +7,7 @@ Introduction
 
 Building with link time optimization requires cooperation from
 the system linker. LTO support on Linux systems requires that you use the
-`gold linker`_ which supports LTO via plugins. This is the same mechanism
+`gold linker`_ or ld.bfd from binutils >= 2.21.51.0.2, as they support LTO via plugins. This is the same mechanism
 used by the `GCC LTO`_ project.
 
 The LLVM gold plugin implements the gold plugin interface on top of
@@ -23,24 +23,22 @@ The LLVM gold plugin implements the gold
 How to build it
 ===============
 
-You need to have gold with plugin support and build the LLVMgold plugin.
-Check whether you have gold running ``/usr/bin/ld -v``. It will report "GNU
-gold" or else "GNU ld" if not. If you have gold, check for plugin support
-by running ``/usr/bin/ld -plugin``. If it complains "missing argument" then
-you have plugin support. If not, such as an "unknown option" error then you
-will either need to build gold or install a version with plugin support.
+Check for plugin support by running ``/usr/bin/ld -plugin``. If it complains
+"missing argument" then you have plugin support. If not, such as an "unknown option"
+error then you will either need to build gold or install a recent version
+of ld.bfd with plugin support and then build gold plugin.
 
-* Download, configure and build gold with plugin support:
+* Download, configure and build ld.bfd with plugin support:
 
   .. code-block:: bash
 
      $ git clone --depth 1 git://sourceware.org/git/binutils-gdb.git binutils
      $ mkdir build
      $ cd build
-     $ ../binutils/configure --enable-gold --enable-plugins --disable-werror
-     $ make all-gold
+     $ ../binutils/configure --disable-werror # ld.bfd includes plugin support by default
+     $ make all-ld
 
-  That should leave you with ``build/gold/ld-new`` which supports
+  That should leave you with ``build/ld/ld-new`` which supports
   the ``-plugin`` option. Running ``make`` will additionally build
   ``build/binutils/ar`` and ``nm-new`` binaries supporting plugins.
 




More information about the llvm-commits mailing list