https://sourceware.org/bugzilla/show_bug.cgi?id=20343
--- Comment #11 from dilyan.palauzov at aegee dot org <dilyan.palauzov at aegee
dot org> ---
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 0a2c4c6ab4..d7b3657aa0 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -534,9 +534,17 @@ default for @sc{gnu} @command{ar}. @command{ar} does not
support any of the oth
which is the default for AIX @command{ar}.
The optional command line switch @option{--plugin} @var{name} causes
-@command{ar} to load the plugin called @var{name} which adds support
-for more file formats. This option is only available if the toolchain
-has been built with plugin support enabled.
+@command{ar} to load the plugin called @var{name} which adds support for more
+file formats, including object files with link-time optimization information.
+This option is only available if the toolchain has been built with plugin
+support enabled. If @option{--plugin} is not provided, @command{ar} iterates
+over the files in $@{libdir@}/bfd-plugins in alphabetic order and the first
+plugin that claims the object in question is used. Please note, that the
+implicit search path is not identical to the one used by @command{ld}
+@option{-plugin}. To make @command{ar} consider implicitly the linker plugin,
+copy it to $@{libdir@}/bfd-plugins. For GCC the plugin is
+@file{liblto_plugin.so.0.0.0}, for Clang - @file{LLVMgold.so}. The GCC plugin
+is backwards compatible, so it is sufficient to have just the newest one.
The optional command line switch @option{--target} @var{bfdname}
specifies that the archive members are in an object code format
@@ -1009,7 +1017,14 @@ Display only defined symbols for each object file.
@cindex load plugin
Load the plugin called @var{name} to add support for extra target
types. This option is only available if the toolchain has been built
-with plugin support enabled.
+with plugin support enabled. If @option{--plugin} is not provided,
+@command{nm} iterates over the files in $@{libdir@}/bfd-plugins in
alphabetical
+order and the first plugin that claims the object is used. Please note, that
+the plugin path is not identical to the one used by @command{ld}
+@option{-plugin}. To make @command{nm} consider implicitly the linker plugin,
+copy it to $@{libdir@}/bfd-plugins. For GCC the plugin is
@file{liblto_plugin.so.0.0.0}, for Clang - @file{LLVMgold.so}. The
+GCC plugin is backwards compatible, so it is sufficient to have just the
newest
+one.
@item --size-sort
Sort symbols by size. For ELF objects symbol sizes are read from the
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 29c2131a2b..ce2137c209 100644
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -828,6 +828,16 @@ the linker may make more use of this option. Also
currently there is
no difference in the linker's behaviour for different non-zero values
of this option. Again this may change with future releases.
+@kindex -plugin @var{linker-plugin}
+@item -plugin @var{linker-plugin}
+Involve a plugin in the linking process. This parameter is automatically
added
+by the complier, when using link time optimization, and contains the absolute
+file name the the plugin, where the installation process has put it. Note,
that
+the path is different from the place, where
+@command{ar}/@command{nm}/@command{ranlib} search implicitly for the linker
+plugin. All gcc linker plugins are backward compatible, it is sufficient to
+have just the newest one.
+
@kindex --push-state
@cindex push state governing input file handling
@item --push-state
--
You are receiving this mail because:
You are on the CC list for the bug.
_______________________________________________
bug-binutils mailing list
bug-binutils@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-binutils
