diff options
Diffstat (limited to 'binutils/doc')
| -rw-r--r-- | binutils/doc/binutils.texi | 67 |
1 files changed, 59 insertions, 8 deletions
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index 5bf5d80..2c9a94d 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -879,7 +879,7 @@ symbol is defined anywhere, the common symbols are treated as undefined references. @ifclear man For more details on common symbols, see the discussion of ---warn-common in @ref{Options,,Linker options,ld.info,The GNU linker}. +--warn-common in @ref{Options,,Linker options,ld,The GNU linker}. @end ifclear The lower case @var{c} character is used when the symbol is in a special section for small commons. @@ -1315,6 +1315,7 @@ objcopy [@option{-F} @var{bfdname}|@option{--target=}@var{bfdname}] [@option{--keep-global-symbols=}@var{filename}] [@option{--localize-symbols=}@var{filename}] [@option{--weaken-symbols=}@var{filename}] + [@option{--binary-symbol-prefix}@var{string}] [@option{--add-symbol} @var{name}=[@var{section}:]@var{value}[,@var{flags}]] [@option{--alt-machine-code=}@var{index}] [@option{--prefix-symbols=}@var{string}] @@ -1362,7 +1363,7 @@ between any two formats may not work as expected. deletes them afterward. @command{objcopy} uses @sc{bfd} to do all its translation work; it has access to all the formats described in @sc{bfd} and thus is able to recognize most formats without being told -explicitly. @xref{BFD,,BFD,ld.info,Using LD}. +explicitly. @xref{BFD,,BFD,ld,Using LD}. @command{objcopy} can be used to generate S-records by using an output target of @samp{srec} (e.g., use @samp{-O srec}). @@ -1554,6 +1555,20 @@ given more than once. Note - unique symbols are not converted. @itemx --weaken-symbol=@var{symbolname} Make symbol @var{symbolname} weak. This option may be given more than once. +@item --binary-symbol-prefix=@var{string} +When used with @option{--input-target=binary}, sets @var{string} as the +base name for the symbols generated for the input file. These symbols are: + +@example +@var{string}_start +@var{string}_end +@var{string}_size +@end example + +By default, the binary input handler derives the prefix symbol name from a +mangled version of the input file name and _binary prefix. This option +allows specifying it explicitly. + @item --globalize-symbol=@var{symbolname} Give symbol @var{symbolname} global scoping so that it is visible outside of the file in which it is defined. This option may be given @@ -2146,9 +2161,6 @@ Sets the section alignment field in the PE header - if one is present in the binary. Sections in memory will always begin at addresses which are a multiple of this number. Defaults to 0x1000. -Note - this option will also set the alignment field in each section's -flags. - Note - if a section's LMA or VMA addresses are no longer aligned, and those addresses have not been set via the @option{--set-section-lma} or @option{--set-section-vma} options, and the file has been fully @@ -2704,6 +2716,14 @@ but the result again may not be as you expect. For RISC-V, the following options are supported: @table @code +@item max +Disassemble without checking architecture string. This is a best effort mode, so +for overlapping ISA extensions the first match (possibly incorrect in a given +context) will be used to decode the instruction. It's useful, if the ELF file +doesn't expose ISA string, preventing automatic ISA subset deduction, and the +default fallback ISA string (@code{rv64gc}) doesn't cover all instructions in +the binary. + @item numeric Print numeric register names, rather than ABI names (e.g., print @code{x2} instead of @code{sp}). @@ -2715,7 +2735,7 @@ instructions will be represented as such (@code{addi sp,sp,-128} will be @item priv-spec=@var{SPEC} Print the CSR according to the chosen privilege spec version (e.g., -@code{1.10}, @code{1.11}, @code{1.12}). +@code{1.10}, @code{1.11}, @code{1.12}, @code{1.13}). @end table For MIPS, this option controls the printing of instruction mnemonic @@ -3561,6 +3581,7 @@ strip [@option{-F} @var{bfdname} |@option{--target=}@var{bfdname}] [@option{--keep-section-symbols}] [@option{--keep-file-symbols}] [@option{--only-keep-debug}] + [@option{--plugin} @var{name}] [@option{-v} |@option{--verbose}] [@option{-V}|@option{--version}] [@option{--help}] [@option{--info}] @var{objfile}@dots{} @@ -3820,6 +3841,26 @@ currently only supports the presence of one filename containing debugging information, not multiple filenames on a one-per-object-file basis. +@item --plugin @var{name} +@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{strip} 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{strip} 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 -V @itemx --version Show the version number for @command{strip}. @@ -5050,6 +5091,7 @@ readelf [@option{-a}|@option{--all}] [@option{--ctf-strings=}@var{section}] [@option{--sframe=}@var{section}] [@option{-I}|@option{--histogram}] + [@option{--got-contents}] [@option{-v}|@option{--version}] [@option{-W}|@option{--wide}] [@option{-T}|@option{--silent-truncation}] @@ -5085,7 +5127,8 @@ given. Equivalent to specifying @option{--file-header}, @option{--program-headers}, @option{--sections}, @option{--symbols}, @option{--relocs}, @option{--dynamic}, @option{--notes}, -@option{--version-info}, @option{--arch-specific}, @option{--unwind}, +@option{--got-contents}, @option{--version-info}, +@option{--arch-specific}, @option{--unwind}, @option{--section-groups} and @option{--histogram}. Note - this option does not enable @option{--use-dynamic} itself, so @@ -5260,7 +5303,7 @@ Displays the contents of the file's dynamic section, if it has one. @item -V @itemx --version-info @cindex ELF version sections information -Displays the contents of the version sections in the file, it they +Displays the contents of the version sections in the file, if they exist. @item -A @@ -5361,6 +5404,14 @@ string table are used. If either of @option{--ctf-symbols} or @option{--ctf-strings} is specified, the other must be specified as well. +@item --got-contents +@cindex ELF section information +@cindex ELF reloc information +Displays the contents of the file's Global Offset Table (GOT) sections, +if it has any. For MIPS, this option is similar to +@option{--arch-specific}, but it only displays the GOT related contents +and it is ignored when @option{--arch-specific} is used. + @item -I @itemx --histogram Display a histogram of bucket list lengths when displaying the contents |