aboutsummaryrefslogtreecommitdiff
path: root/share/info/binutils.info
diff options
context:
space:
mode:
authorDanny <danny@kdrag0n.dev>2021-01-09 23:34:32 +0000
committermosimchah <mosimchah@gmail.com>2021-01-22 03:35:20 -0800
commit783d21ff74759076d2fc503685ca47d2c29baea3 (patch)
treed650cc46cbf7ca53f15c77ced2682e97d492c068 /share/info/binutils.info
parentfdbc6f7102056fb52d26bfb2cbc6ea317890ee34 (diff)
Update to 20210109 buildHEADmaster
LLVM commit: https://github.com/llvm/llvm-project/commit/b02eab9058e58782fca32dd8b1e53c27ed93f866 binutils version: 2.35.1 Builder commit: https://github.com/kdrag0n/proton-clang-build/commit/ba42f701467c9103f23fbb90aca4b23858221ee2
Diffstat (limited to 'share/info/binutils.info')
-rw-r--r--share/info/binutils.info442
1 files changed, 275 insertions, 167 deletions
diff --git a/share/info/binutils.info b/share/info/binutils.info
index 756f3e6..d63a072 100644
--- a/share/info/binutils.info
+++ b/share/info/binutils.info
@@ -1,7 +1,7 @@
-This is binutils.info, produced by makeinfo version 6.5 from
+This is binutils.info, produced by makeinfo version 6.6 from
binutils.texi.
-Copyright (C) 1991-2019 Free Software Foundation, Inc.
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -42,7 +42,7 @@ Introduction
************
This brief manual contains documentation for the GNU binary utilities
-(GNU Binutils) version 2.33.1:
+(GNU Binutils) version 2.35.1:
This document is distributed under the terms of the GNU Free
Documentation License version 1.3. A copy of the license is included in
@@ -68,6 +68,7 @@ the section entitled "GNU Free Documentation License".
* elfedit:: Update ELF header and property of ELF files
* Common Options:: Command-line options for all utilities
* Selecting the Target System:: How these utilities determine the target
+* debuginfod:: Using binutils with debuginfod
* Reporting Bugs:: Reporting Bugs
* GNU Free Documentation License:: GNU Free Documentation License
* Binutils Index:: Binutils Index
@@ -78,7 +79,7 @@ File: binutils.info, Node: ar, Next: nm, Prev: Top, Up: Top
1 ar
****
- ar [-]P[MOD] [--plugin NAME] [--target BFDNAME] [RELPOS] [COUNT] ARCHIVE [MEMBER...]
+ ar [-]P[MOD] [--plugin NAME] [--target BFDNAME] [--output DIRNAME] [RELPOS] [COUNT] ARCHIVE [MEMBER...]
ar -M [ <mri-script ]
The GNU 'ar' program creates, modifies, and extracts from archives.
@@ -149,7 +150,7 @@ File: binutils.info, Node: ar cmdline, Next: ar scripts, Up: ar
1.1 Controlling 'ar' on the Command Line
========================================
- ar [-X32_64] [-]P[MOD] [--plugin NAME] [--target BFDNAME] [RELPOS] [COUNT] ARCHIVE [MEMBER...]
+ ar [-X32_64] [-]P[MOD] [--plugin NAME] [--target BFDNAME] [--output DIRNAME] [RELPOS] [COUNT] ARCHIVE [MEMBER...]
When you use 'ar' in the Unix style, 'ar' insists on at least two
arguments to execute: one keyletter specifying the _operation_
@@ -264,7 +265,12 @@ the following, but you must specify only one of them:
If you do not specify a MEMBER, all files in the archive are
extracted.
- Files cannot be extracted from a thin archive.
+ Files cannot be extracted from a thin archive, and there are
+ restrictions on extracting from archives created with 'P': The
+ paths must not be absolute, may not contain '..', and any
+ subdirectories in the paths must exist. If it is desired to avoid
+ these restrictions then used the '--output' option to specify an
+ output directory.
A number of modifiers (MOD) may immediately follow the P keyletter,
to specify variations on an operation's behavior:
@@ -330,12 +336,18 @@ to specify variations on an operation's behavior:
't' option.
'P'
- Use the full path name when matching names in the archive. GNU
- 'ar' can not create an archive with a full path name (such archives
- are not POSIX compliant), but other archive creators can. This
- option will cause GNU 'ar' to match file names using a complete
- path name, which can be convenient when extracting a single file
- from an archive created by another tool.
+ Use the full path name when matching or storing names in the
+ archive. Archives created with full path names are not POSIX
+ compliant, and thus may not work with tools other than up to date
+ GNU tools. Modifying such archives with GNU 'ar' without using 'P'
+ will remove the full path names unless the archive is a thin
+ archive. Note that 'P' may be useful when adding files to a thin
+ archive since 'r' without 'P' ignores the path when choosing which
+ element to replace. Thus
+ ar rcST archive.a subdir/file1 subdir/file2 file1
+ will result in the first 'subdir/file1' being replaced with 'file1'
+ from the current directory. Adding 'P' will prevent this
+ replacement.
's'
Write an object-file index into the archive, or update an existing
@@ -392,7 +404,7 @@ specific ways:
Displays the version information of 'ar' and then exits.
'-X32_64'
- 'ar' ignores an initial option spelt '-X32_64', for compatibility
+ 'ar' ignores an initial option spelled '-X32_64', for compatibility
with AIX. The behaviour produced by this option is the default for
GNU 'ar'. 'ar' does not support any of the other '-X' options; in
particular, it does not support '-X32' which is the default for AIX
@@ -427,6 +439,15 @@ specific ways:
your system's default format. See *Note Target Selection::, for
more information.
+'--output DIRNAME'
+ The '--output' option can be used to specify a path to a directory
+ into which archive members should be extracted. If this option is
+ not specified then the current directory will be used.
+
+ Note - although the presence of this option does imply a 'x'
+ extraction operation that option must still be included on the
+ command line.
+

File: binutils.info, Node: ar scripts, Prev: ar cmdline, Up: ar
@@ -935,6 +956,7 @@ File: binutils.info, Node: objcopy, Next: objdump, Prev: nm, Up: Top
[--interleave-width=WIDTH]
[-j SECTIONPATTERN|--only-section=SECTIONPATTERN]
[-R SECTIONPATTERN|--remove-section=SECTIONPATTERN]
+ [--keep-section=SECTIONPATTERN]
[--remove-relocations=SECTIONPATTERN]
[-p|--preserve-dates]
[-D|--enable-deterministic-archives]
@@ -1106,6 +1128,10 @@ the '--reverse-bytes' option.)
will remove all sections matching the pattern '.text.*', but will
not remove the section '.text.foo'.
+'--keep-section=SECTIONPATTERN'
+ When removing sections from the output file, keep sections that
+ match SECTIONPATTERN.
+
'--remove-relocations=SECTIONPATTERN'
Remove non-dynamic relocations from the output file for any section
matching SECTIONPATTERN. This option may be given more than once.
@@ -1290,13 +1316,15 @@ the '--reverse-bytes' option.)
filled in with the value specified by '--gap-fill' (default zero).
'--set-start VAL'
- Set the start address of the new file to VAL. Not all object file
- formats support setting the start address.
+ Set the start address (also known as the entry address) of the new
+ file to VAL. Not all object file formats support setting the start
+ address.
'--change-start INCR'
'--adjust-start INCR'
- Change the start address by adding INCR. Not all object file
- formats support setting the start address.
+ Change the start address (also known as the entry address) by
+ adding INCR. Not all object file formats support setting the start
+ address.
'--change-addresses INCR'
'--adjust-vma INCR'
@@ -1360,11 +1388,13 @@ the '--reverse-bytes' option.)
Set the flags for any sections matching SECTIONPATTERN. The FLAGS
argument is a comma separated string of flag names. The recognized
names are 'alloc', 'contents', 'load', 'noload', 'readonly',
- 'code', 'data', 'rom', 'share', and 'debug'. You can set the
- 'contents' flag for a section which does not have contents, but it
- is not meaningful to clear the 'contents' flag of a section which
- does have contents-just remove the section instead. Not all flags
- are meaningful for all object file formats.
+ 'code', 'data', 'rom', 'exclude', 'share', and 'debug'. You can
+ set the 'contents' flag for a section which does not have contents,
+ but it is not meaningful to clear the 'contents' flag of a section
+ which does have contents-just remove the section instead. Not all
+ flags are meaningful for all object file formats. In particular
+ the 'share' flag is only meaningful for COFF format files and not
+ for ELF format files.
'--set-section-alignment SECTIONPATTERN=ALIGN'
Set the alignment for any sections matching SECTIONPATTERN. ALIGN
@@ -1421,6 +1451,8 @@ the '--reverse-bytes' option.)
section's flags to FLAGS in the process. This has the advantage
over using a linker script to perform the rename in that the output
stays as an object file and does not become a linked executable.
+ This option accepts the same set of flags as the
+ '--sect-section-flags' option.
This option is particularly helpful when the input format is
binary, since this will always create a section called .data. If
@@ -1836,8 +1868,8 @@ File: binutils.info, Node: objdump, Next: ranlib, Prev: objcopy, Up: Top
[-r|--reloc]
[-R|--dynamic-reloc]
[-s|--full-contents]
- [-W[lLiaprmfFsoRtUuTgAckK]|
- --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]
+ [-W[lLiaprmfFsoORtUuTgAckK]|
+ --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]
[--ctf=SECTION]
[-G|--stabs]
[-t|--syms]
@@ -1846,19 +1878,19 @@ File: binutils.info, Node: objdump, Next: ranlib, Prev: objcopy, Up: Top
[-w|--wide]
[--start-address=ADDRESS]
[--stop-address=ADDRESS]
+ [--no-addresses]
[--prefix-addresses]
[--[no-]show-raw-insn]
[--adjust-vma=OFFSET]
[--dwarf-depth=N]
[--dwarf-start=N]
[--ctf-parent=SECTION]
- [--ctf-symbols=SECTION]
- [--ctf-strings=SECTION]
[--no-recurse-limit|--recurse-limit]
[--special-syms]
[--prefix=PREFIX]
[--prefix-strip=LEVEL]
[--insn-width=WIDTH]
+ [--visualize-jumps[=color|=extended-color|=off]
[-V|--version]
[-H|--help]
OBJFILE...
@@ -1937,7 +1969,7 @@ given.
'--debugging'
Display debugging information. This attempts to parse STABS
debugging format information stored in the file and print it out
- using a C like syntax. If no STABS debuging was found this option
+ using a C like syntax. If no STABS debugging was found this option
falls back on the '-W' option to print any DWARF information in the
file.
@@ -1984,6 +2016,12 @@ given.
then any symbol tables in linked debug info files will be read in
and used when disassembling.
+'--no-addresses'
+ When disassembling, don't print addresses on each line or for
+ symbols and relocation offsets. In combination with
+ '--no-show-raw-insn' this may be useful for comparing compiler
+ output.
+
'--prefix-addresses'
When disassembling, print the complete address on each line. This
is the older disassembly format.
@@ -2125,8 +2163,7 @@ given.
generated as comments in the disasssembly using '-M notes'.
For the x86, some of the options duplicate functions of the '-m'
- switch, but allow finer grained control. Multiple selections from
- the following may be specified as a comma separated string.
+ switch, but allow finer grained control.
'x86-64'
'i386'
'i8086'
@@ -2156,9 +2193,11 @@ given.
appear later in the option string.
'suffix'
- When in AT&T mode, instructs the disassembler to print a
+ When in AT&T mode and also for a limited set of instructions
+ when in Intel mode, instructs the disassembler to print a
mnemonic suffix even when the suffix could be inferred by the
- operands.
+ operands or, for certain instructions, the execution mode's
+ defaults.
For PowerPC, the '-M' argument 'raw' selects disasssembly of
hardware insns rather than aliases. For example, you will see
@@ -2168,19 +2207,19 @@ given.
'620', '7400', '7410', '7450', '7455', '750cl', '821', '850',
'860', 'a2', 'booke', 'booke32', 'cell', 'com', 'e200z4', 'e300',
'e500', 'e500mc', 'e500mc64', 'e500x2', 'e5500', 'e6500', 'efs',
- 'power4', 'power5', 'power6', 'power7', 'power8', 'power9', 'ppc',
- 'ppc32', 'ppc64', 'ppc64bridge', 'ppcps', 'pwr', 'pwr2', 'pwr4',
- 'pwr5', 'pwr5x', 'pwr6', 'pwr7', 'pwr8', 'pwr9', 'pwrx', 'titan',
- and 'vle'. '32' and '64' modify the default or a prior CPU
- selection, disabling and enabling 64-bit insns respectively. In
- addition, 'altivec', 'any', 'htm', 'vsx', and 'spe' add
- capabilities to a previous _or later_ CPU selection. 'any' will
- disassemble any opcode known to binutils, but in cases where an
- opcode has two different meanings or different arguments, you may
- not see the disassembly you expect. If you disassemble without
- giving a CPU selection, a default will be chosen from information
- gleaned by BFD from the object files headers, but the result again
- may not be as you expect.
+ 'power4', 'power5', 'power6', 'power7', 'power8', 'power9',
+ 'power10', 'ppc', 'ppc32', 'ppc64', 'ppc64bridge', 'ppcps', 'pwr',
+ 'pwr2', 'pwr4', 'pwr5', 'pwr5x', 'pwr6', 'pwr7', 'pwr8', 'pwr9',
+ 'pwr10', 'pwrx', 'titan', and 'vle'. '32' and '64' modify the
+ default or a prior CPU selection, disabling and enabling 64-bit
+ insns respectively. In addition, 'altivec', 'any', 'htm', 'vsx',
+ and 'spe' add capabilities to a previous _or later_ CPU selection.
+ 'any' will disassemble any opcode known to binutils, but in cases
+ where an opcode has two different meanings or different arguments,
+ you may not see the disassembly you expect. If you disassemble
+ without giving a CPU selection, a default will be chosen from
+ information gleaned by BFD from the object files headers, but the
+ result again may not be as you expect.
For MIPS, this option controls the printing of instruction mnemonic
names and register names in disassembled instructions. Multiple
@@ -2323,8 +2362,18 @@ given.
Display WIDTH bytes on a single line when disassembling
instructions.
-'-W[lLiaprmfFsoRtUuTgAckK]'
-'--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]'
+'--visualize-jumps[=color|=extended-color|=off]'
+ Visualize jumps that stay inside a function by drawing ASCII art
+ between the start and target addresses. The optional '=color'
+ argument adds color to the output using simple terminal colors.
+ Alternatively the '=extended-color' argument will add color using
+ 8bit colors, but these might not work on all terminals.
+
+ If it is necessary to disable the 'visualize-jumps' option after it
+ has previously been enabled then use 'visualize-jumps=off'.
+
+'-W[lLiaprmfFsoORtUuTgAckK]'
+'--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]'
Displays the contents of the DWARF debug sections in the file, if
any are present. Compressed debug sections are automatically
@@ -2404,6 +2453,10 @@ given.
Displays the contents of the '.debug_loc' and/or
'.debug_loclists' sections.
+ 'O'
+ '=str-offsets'
+ Displays the contents of the '.debug_str_offsets' section.
+
'p'
'=pubnames'
Displays the contents of the '.debug_pubnames' and/or
@@ -2473,8 +2526,10 @@ given.
'--ctf-parent=SECTION'
- Specify the name of another section from which the CTF file can
- inherit types.
+ Specify the name of another section from which the CTF dictionary
+ can inherit types. (If none is specified, we assume the CTF
+ dictionary inherits types from the default-named member of the
+ archive contained within this section.)
'-G'
'--stabs'
@@ -2801,7 +2856,7 @@ the options below) and are followed by an unprintable character.
Depending upon how the strings program was configured it will default
to either displaying all the printable sequences that it can find in
each file, or only those sequences that are in loadable, initialized
-data sections. If the file type in unrecognizable, or if strings is
+data sections. If the file type is unrecognizable, or if strings is
reading from stdin then it will always display all of the printable
sequences that it can find.
@@ -2913,6 +2968,7 @@ File: binutils.info, Node: strip, Next: c++filt, Prev: strings, Up: Top
[-w|--wildcard]
[-x|--discard-all] [-X |--discard-locals]
[-R SECTIONNAME |--remove-section=SECTIONNAME]
+ [--keep-section=SECTIONPATTERN]
[--remove-relocations=SECTIONPATTERN]
[-o FILE] [-p|--preserve-dates]
[-D|--enable-deterministic-archives]
@@ -2972,6 +3028,10 @@ modified copies under different names.
will remove all sections matching the pattern '.text.*', but will
not remove the section '.text.foo'.
+'--keep-section=SECTIONPATTERN'
+ When removing sections from the output file, keep sections that
+ match SECTIONPATTERN.
+
'--remove-relocations=SECTIONPATTERN'
Remove relocations from the output file for any section matching
SECTIONPATTERN. This option may be given more than once. Note
@@ -4163,13 +4223,14 @@ File: binutils.info, Node: readelf, Next: elfedit, Prev: dlltool, Up: Top
[-V|--version-info]
[-A|--arch-specific]
[-D|--use-dynamic]
+ [-L|--lint|--enable-checks]
[-x <number or name>|--hex-dump=<number or name>]
[-p <number or name>|--string-dump=<number or name>]
[-R <number or name>|--relocated-dump=<number or name>]
[-z|--decompress]
[-c|--archive-index]
- [-w[lLiaprmfFsoRtUuTgAckK]|
- --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]
+ [-w[lLiaprmfFsoORtUuTgAckK]|
+ --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]
[--dwarf-depth=N]
[--dwarf-start=N]
[--ctf=SECTION]
@@ -4179,6 +4240,7 @@ File: binutils.info, Node: readelf, Next: elfedit, Prev: dlltool, Up: Top
[-I|--histogram]
[-v|--version]
[-W|--wide]
+ [-T|--silent-truncation]
[-H|--help]
ELFFILE...
@@ -4294,6 +4356,15 @@ equivalent. At least one option besides '-v' or '-H' must be given.
When displaying relocations, this option makes 'readelf' display
the dynamic relocations rather than the static relocations.
+'-L'
+'--lint'
+'--enable-checks'
+ Displays warning messages about possible problems with the file(s)
+ being examined. If used on its own then all of the contents of the
+ file(s) will be examined. If used with one of the dumping options
+ then the warning messages will only be produced for the things
+ being displayed.
+
'-x <number or name>'
'--hex-dump=<number or name>'
Displays the contents of the indicated section as a hexadecimal
@@ -4328,8 +4399,8 @@ equivalent. At least one option besides '-v' or '-H' must be given.
part of binary archives. Performs the same function as the 't'
command to 'ar', but without using the BFD library. *Note ar::.
-'-w[lLiaprmfFsoRtUuTgAckK]'
-'--debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]'
+'-w[lLiaprmfFsOoRtUuTgAckK]'
+'--debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]'
Displays the contents of the DWARF debug sections in the file, if
any are present. Compressed debug sections are automatically
@@ -4409,6 +4480,10 @@ equivalent. At least one option besides '-v' or '-H' must be given.
Displays the contents of the '.debug_loc' and/or
'.debug_loclists' sections.
+ 'O'
+ '=str-offsets'
+ Displays the contents of the '.debug_str_offsets' section.
+
'p'
'=pubnames'
Displays the contents of the '.debug_pubnames' and/or
@@ -4475,12 +4550,15 @@ equivalent. At least one option besides '-v' or '-H' must be given.
'--ctf-parent=SECTION'
- Specify the name of another section from which the CTF file can
- inherit types.
+ Specify the name of another section from which the CTF dictionary
+ can inherit types. (If none is specified, we assume the CTF
+ dictionary inherits types from the default-named member of the
+ archive contained within this section.)
'--ctf-symbols=SECTION'
'--ctf-strings=SECTION'
Specify the name of another section from which the CTF file can
- inherit strings and symbols.
+ inherit strings and symbols. By default, the '.symtab' and its
+ linked string table are used.
If either of '--ctf-symbols' or '--ctf-strings' is specified, the
other must be specified as well.
@@ -4503,6 +4581,15 @@ equivalent. At least one option besides '-v' or '-H' must be given.
one a single line, which is far more readable on terminals wider
than 80 columns.
+'-T'
+'--silent-truncation'
+ Normally when readelf is displaying a symbol name, and it has to
+ truncate the name to fit into an 80 column display, it will add a
+ suffix of '[...]' to the name. This command line option disables
+ this behaviour, allowing 5 more characters of the name to be
+ displayed and restoring the old behaviour of readelf (prior to
+ release 2.35).
+
'-H'
'--help'
Display the command-line options understood by 'readelf'.
@@ -4622,7 +4709,7 @@ described in this manual.
Display the version number of the program.

-File: binutils.info, Node: Selecting the Target System, Next: Reporting Bugs, Prev: Common Options, Up: Top
+File: binutils.info, Node: Selecting the Target System, Next: debuginfod, Prev: Common Options, Up: Top
17 Selecting the Target System
******************************
@@ -4757,9 +4844,28 @@ Ways to specify:
1. deduced from the input file

-File: binutils.info, Node: Reporting Bugs, Next: GNU Free Documentation License, Prev: Selecting the Target System, Up: Top
+File: binutils.info, Node: debuginfod, Next: Reporting Bugs, Prev: Selecting the Target System, Up: Top
+
+18 debuginfod
+*************
+
+debuginfod is a web service that indexes ELF/DWARF debugging resources
+by build-id and serves them over HTTP.
+
+ Binutils can be built with the debuginfod client library
+'libdebuginfod' using the '--with-debuginfod' configure option. This
+option is enabled by default if 'libdebuginfod' is installed and found
+at configure time. This allows 'objdump' and 'readelf' to automatically
+query debuginfod servers for separate debug files when the files are
+otherwise not found.
+
+ debuginfod is packaged with elfutils, starting with version 0.178.
+You can get the latest version from 'https://sourceware.org/elfutils/'.
+
+
+File: binutils.info, Node: Reporting Bugs, Next: GNU Free Documentation License, Prev: debuginfod, Up: Top
-18 Reporting Bugs
+19 Reporting Bugs
*****************
Your bug reports play an essential role in making the binary utilities
@@ -4782,7 +4888,7 @@ information that enables us to fix the bug.

File: binutils.info, Node: Bug Criteria, Next: Bug Reporting, Up: Reporting Bugs
-18.1 Have You Found a Bug?
+19.1 Have You Found a Bug?
==========================
If you are not sure whether you have found a bug, here are some
@@ -4800,7 +4906,7 @@ guidelines:

File: binutils.info, Node: Bug Reporting, Prev: Bug Criteria, Up: Reporting Bugs
-18.2 How to Report Bugs
+19.2 How to Report Bugs
=======================
A number of companies and individuals offer support for GNU products.
@@ -5436,25 +5542,25 @@ Binutils Index
* Menu:
-* -enable-deterministic-archives: ar cmdline. (line 145)
-* -enable-deterministic-archives <1>: ar cmdline. (line 222)
-* -enable-deterministic-archives <2>: objcopy. (line 350)
-* -enable-deterministic-archives <3>: objcopy. (line 360)
+* -enable-deterministic-archives: ar cmdline. (line 150)
+* -enable-deterministic-archives <1>: ar cmdline. (line 233)
+* -enable-deterministic-archives <2>: objcopy. (line 355)
+* -enable-deterministic-archives <3>: objcopy. (line 365)
* -enable-deterministic-archives <4>: ranlib. (line 32)
* -enable-deterministic-archives <5>: ranlib. (line 44)
-* -enable-deterministic-archives <6>: strip. (line 150)
-* -enable-deterministic-archives <7>: strip. (line 160)
-* .stab: objdump. (line 673)
-* Add prefix to absolute paths: objdump. (line 498)
+* -enable-deterministic-archives <6>: strip. (line 155)
+* -enable-deterministic-archives <7>: strip. (line 165)
+* .stab: objdump. (line 696)
+* Add prefix to absolute paths: objdump. (line 505)
* addr2line: addr2line. (line 6)
* address to file name and line number: addr2line. (line 6)
-* all header information, object file: objdump. (line 795)
+* all header information, object file: objdump. (line 818)
* ar: ar. (line 6)
* ar compatibility: ar. (line 60)
-* architecture: objdump. (line 251)
-* architectures available: objdump. (line 236)
+* architecture: objdump. (line 257)
+* architectures available: objdump. (line 242)
* archive contents: ranlib. (line 6)
-* Archive file symbol index information: readelf. (line 183)
+* Archive file symbol index information: readelf. (line 194)
* archive headers: objdump. (line 75)
* archives: ar. (line 6)
* base files: dlltool. (line 124)
@@ -5463,65 +5569,65 @@ Binutils Index
* bugs: Reporting Bugs. (line 6)
* bugs, reporting: Bug Reporting. (line 6)
* c++filt: c++filt. (line 6)
-* changing object addresses: objcopy. (line 395)
-* changing section address: objcopy. (line 405)
-* changing section LMA: objcopy. (line 414)
-* changing section VMA: objcopy. (line 427)
-* changing start address: objcopy. (line 390)
+* changing object addresses: objcopy. (line 402)
+* changing section address: objcopy. (line 412)
+* changing section LMA: objcopy. (line 421)
+* changing section VMA: objcopy. (line 434)
+* changing start address: objcopy. (line 396)
* collections of files: ar. (line 6)
-* Compact Type Format: objdump. (line 661)
-* Compact Type Format <1>: readelf. (line 327)
+* Compact Type Format: objdump. (line 682)
+* Compact Type Format <1>: readelf. (line 342)
* compatibility, ar: ar. (line 60)
* contents of archive: ar cmdline. (line 97)
* crash: Bug Criteria. (line 9)
-* creating archives: ar cmdline. (line 139)
-* creating thin archive: ar cmdline. (line 208)
-* CTF: objdump. (line 661)
-* CTF <1>: readelf. (line 327)
+* creating archives: ar cmdline. (line 144)
+* creating thin archive: ar cmdline. (line 219)
+* CTF: objdump. (line 682)
+* CTF <1>: readelf. (line 342)
* cxxfilt: c++filt. (line 16)
-* dates in archive: ar cmdline. (line 178)
-* debug symbols: objdump. (line 673)
+* dates in archive: ar cmdline. (line 183)
+* debug symbols: objdump. (line 696)
* debugging symbols: nm. (line 153)
* deleting from archive: ar cmdline. (line 26)
* demangling C++ symbols: c++filt. (line 6)
* demangling in nm: nm. (line 161)
* demangling in objdump: objdump. (line 103)
* demangling in objdump <1>: addr2line. (line 86)
-* deterministic archives: ar cmdline. (line 145)
-* deterministic archives <1>: ar cmdline. (line 222)
-* deterministic archives <2>: objcopy. (line 350)
-* deterministic archives <3>: objcopy. (line 360)
+* deterministic archives: ar cmdline. (line 150)
+* deterministic archives <1>: ar cmdline. (line 233)
+* deterministic archives <2>: objcopy. (line 355)
+* deterministic archives <3>: objcopy. (line 365)
* deterministic archives <4>: ranlib. (line 32)
* deterministic archives <5>: ranlib. (line 44)
-* deterministic archives <6>: strip. (line 150)
-* deterministic archives <7>: strip. (line 160)
+* deterministic archives <6>: strip. (line 155)
+* deterministic archives <7>: strip. (line 165)
* disassembling object code: objdump. (line 144)
-* disassembly architecture: objdump. (line 251)
-* disassembly endianness: objdump. (line 186)
-* disassembly, with source: objdump. (line 487)
-* disassembly, with source <1>: objdump. (line 491)
+* disassembly architecture: objdump. (line 257)
+* disassembly endianness: objdump. (line 192)
+* disassembly, with source: objdump. (line 494)
+* disassembly, with source <1>: objdump. (line 498)
* discarding symbols: strip. (line 6)
* DLL: dlltool. (line 6)
* dlltool: dlltool. (line 6)
-* dynamic relocation entries, in object file: objdump. (line 475)
-* dynamic symbol table entries, printing: objdump. (line 772)
+* dynamic relocation entries, in object file: objdump. (line 482)
+* dynamic symbol table entries, printing: objdump. (line 795)
* dynamic symbols: nm. (line 191)
-* ELF dynamic section information: readelf. (line 132)
-* ELF dynamic symbol table information: readelf. (line 104)
-* ELF file header information: readelf. (line 67)
+* ELF dynamic section information: readelf. (line 134)
+* ELF dynamic symbol table information: readelf. (line 106)
+* ELF file header information: readelf. (line 69)
* ELF file information: readelf. (line 6)
-* ELF notes: readelf. (line 114)
-* ELF object file format: objdump. (line 673)
-* ELF program header information: readelf. (line 73)
-* ELF reloc information: readelf. (line 118)
-* ELF section group information: readelf. (line 84)
-* ELF section information: readelf. (line 79)
-* ELF section information <1>: readelf. (line 89)
-* ELF segment information: readelf. (line 73)
-* ELF symbol table information: readelf. (line 94)
-* ELF version sections information: readelf. (line 136)
+* ELF notes: readelf. (line 116)
+* ELF object file format: objdump. (line 696)
+* ELF program header information: readelf. (line 75)
+* ELF reloc information: readelf. (line 120)
+* ELF section group information: readelf. (line 86)
+* ELF section information: readelf. (line 81)
+* ELF section information <1>: readelf. (line 91)
+* ELF segment information: readelf. (line 75)
+* ELF symbol table information: readelf. (line 96)
+* ELF version sections information: readelf. (line 138)
* elfedit: elfedit. (line 6)
-* endianness: objdump. (line 186)
+* endianness: objdump. (line 192)
* error on valid input: Bug Criteria. (line 12)
* external symbols: nm. (line 203)
* external symbols <1>: nm. (line 267)
@@ -5529,10 +5635,10 @@ Binutils Index
* extract from archive: ar cmdline. (line 114)
* fatal signal: Bug Criteria. (line 9)
* file name: nm. (line 147)
-* header information, all: objdump. (line 795)
+* header information, all: objdump. (line 818)
* input .def file: dlltool. (line 120)
* input file name: nm. (line 147)
-* Instruction width: objdump. (line 515)
+* Instruction width: objdump. (line 522)
* libraries: ar. (line 25)
* listings strings: strings. (line 6)
* machine instructions: objdump. (line 144)
@@ -5545,7 +5651,7 @@ Binutils Index
* nm compatibility <1>: nm. (line 197)
* nm format: nm. (line 157)
* nm format <1>: nm. (line 197)
-* not writing archive index: ar cmdline. (line 201)
+* not writing archive index: ar cmdline. (line 212)
* objdump: objdump. (line 6)
* objdump inlines: nm. (line 219)
* object code format: nm. (line 333)
@@ -5553,14 +5659,14 @@ Binutils Index
* object code format <2>: size. (line 103)
* object code format <3>: strings. (line 94)
* object code format <4>: addr2line. (line 81)
-* object file header: objdump. (line 192)
+* object file header: objdump. (line 198)
* object file information: objdump. (line 6)
-* object file offsets: objdump. (line 197)
-* object file sections: objdump. (line 482)
-* object formats available: objdump. (line 236)
-* offsets of files: ar cmdline. (line 183)
+* object file offsets: objdump. (line 203)
+* object file sections: objdump. (line 489)
+* object formats available: objdump. (line 242)
+* offsets of files: ar cmdline. (line 188)
* operations on archive: ar cmdline. (line 22)
-* plugins: ar cmdline. (line 256)
+* plugins: ar cmdline. (line 267)
* plugins <1>: nm. (line 284)
* printing from archive: ar cmdline. (line 46)
* printing strings: strings. (line 6)
@@ -5569,84 +5675,86 @@ Binutils Index
* ranlib: ranlib. (line 6)
* ranlib <1>: ar cmdline. (line 91)
* readelf: readelf. (line 6)
-* relative placement in archive: ar cmdline. (line 127)
-* relocation entries, in object file: objdump. (line 469)
+* relative placement in archive: ar cmdline. (line 132)
+* relocation entries, in object file: objdump. (line 476)
* removing symbols: strip. (line 6)
* repeated names in archive: ar cmdline. (line 108)
* replacement in archive: ar cmdline. (line 73)
* reporting bugs: Reporting Bugs. (line 6)
* scripts, ar: ar scripts. (line 8)
* section addresses in objdump: objdump. (line 81)
-* section headers: objdump. (line 213)
-* section information: objdump. (line 241)
+* section headers: objdump. (line 219)
+* section information: objdump. (line 247)
* section sizes: size. (line 6)
-* sections, full contents: objdump. (line 482)
+* sections, full contents: objdump. (line 489)
+* separate debug files: debuginfod. (line 6)
* size: size. (line 6)
* size display format: size. (line 28)
* size number format: size. (line 85)
* sorting symbols: nm. (line 234)
-* source code context: objdump. (line 206)
-* source disassembly: objdump. (line 487)
-* source disassembly <1>: objdump. (line 491)
+* source code context: objdump. (line 212)
+* source disassembly: objdump. (line 494)
+* source disassembly <1>: objdump. (line 498)
* source file name: nm. (line 147)
-* source filenames for object files: objdump. (line 245)
-* stab: objdump. (line 673)
-* start-address: objdump. (line 682)
-* stop-address: objdump. (line 686)
+* source filenames for object files: objdump. (line 251)
+* stab: objdump. (line 696)
+* start-address: objdump. (line 705)
+* stop-address: objdump. (line 709)
* strings: strings. (line 6)
* strings, printing: strings. (line 6)
* strip: strip. (line 6)
-* Strip absolute paths: objdump. (line 501)
+* Strip absolute paths: objdump. (line 508)
* symbol index: ar. (line 28)
* symbol index <1>: ranlib. (line 6)
* symbol index, listing: nm. (line 256)
* symbol line numbers: nm. (line 211)
-* symbol table entries, printing: objdump. (line 691)
+* symbol table entries, printing: objdump. (line 714)
* symbols: nm. (line 6)
* symbols, discarding: strip. (line 6)
* thin archives: ar. (line 40)
* undefined symbols: nm. (line 267)
* undefined symbols <1>: nm. (line 281)
* Unix compatibility, ar: ar cmdline. (line 8)
-* unwind information: readelf. (line 123)
+* unwind information: readelf. (line 125)
* Update ELF header: elfedit. (line 6)
-* updating an archive: ar cmdline. (line 213)
+* updating an archive: ar cmdline. (line 224)
* version: Top. (line 6)
* VMA in objdump: objdump. (line 81)
-* wide output, printing: objdump. (line 801)
-* writing archive index: ar cmdline. (line 195)
+* wide output, printing: objdump. (line 824)
+* writing archive index: ar cmdline. (line 206)

Tag Table:
Node: Top1834
-Node: ar3490
-Node: ar cmdline6624
-Node: ar scripts18206
-Node: nm23892
-Node: objcopy36516
-Node: objdump76543
-Node: ranlib108440
-Node: size110039
-Node: strings114008
-Node: strip118380
-Node: c++filt127733
-Ref: c++filt-Footnote-1133595
-Node: addr2line133701
-Node: windmc139380
-Node: windres143039
-Node: dlltool149398
-Node: def file format162395
-Node: readelf164925
-Node: elfedit177268
-Node: Common Options180224
-Node: Selecting the Target System181258
-Node: Target Selection182190
-Node: Architecture Selection184171
-Node: Reporting Bugs184999
-Node: Bug Criteria185778
-Node: Bug Reporting186331
-Node: GNU Free Documentation License193201
-Node: Binutils Index218361
+Node: ar3553
+Node: ar cmdline6706
+Node: ar scripts19332
+Node: nm25018
+Node: objcopy37642
+Node: objdump78135
+Node: ranlib111160
+Node: size112759
+Node: strings116728
+Node: strip121100
+Node: c++filt130625
+Ref: c++filt-Footnote-1136487
+Node: addr2line136593
+Node: windmc142272
+Node: windres145931
+Node: dlltool152290
+Node: def file format165287
+Node: readelf167817
+Node: elfedit181331
+Node: Common Options184287
+Node: Selecting the Target System185321
+Node: Target Selection186249
+Node: Architecture Selection188230
+Node: debuginfod189058
+Node: Reporting Bugs189817
+Node: Bug Criteria190579
+Node: Bug Reporting191132
+Node: GNU Free Documentation License198002
+Node: Binutils Index223162

End Tag Table