Toolchain/binutils-gdb
1
0
Fork 0
forked from Imagelibrary/binutils-gdb
Code Pull Requests Activity

Update description of the -plugin option used by the linker, ar and nm.

Browse Source 
PR 20343
ld	* ld.texinfo (Options): Extend documentation of the --plugin
	option.  Include a description of where the plugins should be
	located.

binutils* doc/binutils.texi (ar): Extend documentation of the --plugin
	option.  Include a description of where the plugins should be
	located.
	(nm): Likewise.
This commit is contained in:
Dilyan Palauzov
2017-01-27 13:20:24 +00:00
committed by Nick Clifton
parent 8ec5cf65a8
commit 387dd77738
4 changed files with 89 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

73
binutils/doc/binutils.texi
View File

@@ -392,14 +392,6 @@ If you do not specify a @var{member}, all files in the archive
are extracted.
Files cannot be extracted from a thin archive.
@item --help
Displays the list of command line options supported by @command{ar}
and then exits.
@item --version
Displays the version information of @command{ar} and then exits.
@end table
A number of modifiers (@var{mod}) may immediately follow the @var{p}
@@ -527,22 +519,55 @@ when the modifier @samp{v} is appended.
This modifier shows the version number of @command{ar}.
@end table
The @command{ar} program also supports some command line options which
are neither modifiers nor actions, but which do change its behaviour
in specific ways:
@table @samp
@item --help
Displays the list of command line options supported by @command{ar}
and then exits.
@item --version
Displays the version information of @command{ar} and then exits.
@item -X32_64
@command{ar} ignores an initial option spelt @samp{-X32_64}, for
compatibility with AIX. The behaviour produced by this option is the
default for @sc{gnu} @command{ar}. @command{ar} does not support any of the other
@samp{-X} options; in particular, it does not support @option{-X32}
which is the default for AIX @command{ar}.
default for @sc{gnu} @command{ar}. @command{ar} does not support any
of the other @samp{-X} options; in particular, it does not support
@option{-X32} which is the default for AIX @command{ar}.
The optional command line switch @option{--plugin} @var{name} causes
@item --plugin @var{name}
@cindex plugins
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.
for more file formats, including object files with link-time
optimization information.
The optional command line switch @option{--target} @var{bfdname}
This option is only available if the toolchain has been built with
plugin support enabled.
If @option{--plugin} is not provided, but plugin support has been
enabled then @command{ar} iterates over the files in
@file{$@{libdir@}/bfd-plugins} in alphabetic order and the first
plugin that claims the object in question is used.
Please note that this plugin search directory is @emph{not} the one
used by @command{ld}'s @option{-plugin} option. In order to make
@command{ar} use the linker plugin it must be copied into the
@file{$@{libdir@}/bfd-plugins} directory. For GCC based compilations
the linker plugin is called @file{liblto_plugin.so.0.0.0}. For Clang
based compilations it is called @file{LLVMgold.so}. The GCC plugin
is always backwards compatible with earlier versions, so it is
sufficient to just copy the newest one.
@item --target @var{target}
The optional command line switch @option{--target @var{bfdname}}
specifies that the archive members are in an object code format
different from your system's default format. See
@xref{Target Selection}, for more information.
@end table
@c man end
@ignore
@@ -1006,11 +1031,25 @@ to @option{-X 32}, which is not supported by @sc{gnu} @command{nm}.
Display only defined symbols for each object file.
@item --plugin @var{name}
@cindex load plugin
@cindex plugins
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.
If @option{--plugin} is not provided, but plugin support has been
enabled then @command{nm} iterates over the files in
@file{$@{libdir@}/bfd-plugins} in alphabetic order and the first
plugin that claims the object in question is used.
Please note that this plugin search directory is @emph{not} the one
used by @command{ld}'s @option{-plugin} option. In order to make
@command{nm} use the linker plugin it must be copied into the
@file{$@{libdir@}/bfd-plugins} directory. For GCC based compilations
the linker plugin is called @file{liblto_plugin.so.0.0.0}. For Clang
based compilations it is called @file{LLVMgold.so}. The GCC plugin
is always backwards compatible with earlier versions, so it is
sufficient to just copy the newest one.
@item --size-sort
Sort symbols by size. For ELF objects symbol sizes are read from the
ELF, for other object types the symbol sizes are computed as the