diff options
Diffstat (limited to 'binutils/doc/binutils.texi')
| -rw-r--r-- | binutils/doc/binutils.texi | 75 |
1 files changed, 57 insertions, 18 deletions
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index 0a2c4c6..534560a 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -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. - -The optional command line switch @option{--target} @var{bfdname} +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, 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 |