aboutsummaryrefslogtreecommitdiff
path: root/share/man
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/man
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/man')
-rw-r--r--share/man/man1/aarch64-linux-gnu-addr2line.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-ar.146
-rw-r--r--share/man/man1/aarch64-linux-gnu-as.1305
-rw-r--r--share/man/man1/aarch64-linux-gnu-c++filt.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-dlltool.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-elfedit.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-gprof.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-ld.1186
-rw-r--r--share/man/man1/aarch64-linux-gnu-nm.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-objcopy.134
-rw-r--r--share/man/man1/aarch64-linux-gnu-objdump.169
-rw-r--r--share/man/man1/aarch64-linux-gnu-ranlib.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-readelf.160
-rw-r--r--share/man/man1/aarch64-linux-gnu-size.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-strings.16
-rw-r--r--share/man/man1/aarch64-linux-gnu-strip.19
-rw-r--r--share/man/man1/aarch64-linux-gnu-windmc.14
-rw-r--r--share/man/man1/aarch64-linux-gnu-windres.14
-rw-r--r--share/man/man1/addr2line.14
-rw-r--r--share/man/man1/ar.146
-rw-r--r--share/man/man1/arm-linux-gnueabi-addr2line.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-ar.146
-rw-r--r--share/man/man1/arm-linux-gnueabi-as.1305
-rw-r--r--share/man/man1/arm-linux-gnueabi-c++filt.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-dlltool.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-elfedit.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-gprof.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-ld.1186
-rw-r--r--share/man/man1/arm-linux-gnueabi-nm.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-objcopy.134
-rw-r--r--share/man/man1/arm-linux-gnueabi-objdump.169
-rw-r--r--share/man/man1/arm-linux-gnueabi-ranlib.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-readelf.160
-rw-r--r--share/man/man1/arm-linux-gnueabi-size.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-strings.16
-rw-r--r--share/man/man1/arm-linux-gnueabi-strip.19
-rw-r--r--share/man/man1/arm-linux-gnueabi-windmc.14
-rw-r--r--share/man/man1/arm-linux-gnueabi-windres.14
-rw-r--r--share/man/man1/as.1305
-rw-r--r--share/man/man1/c++filt.14
-rw-r--r--share/man/man1/dlltool.14
-rw-r--r--share/man/man1/elfedit.14
-rw-r--r--share/man/man1/gprof.14
-rw-r--r--share/man/man1/ld.1186
-rw-r--r--share/man/man1/nm.14
-rw-r--r--share/man/man1/objcopy.134
-rw-r--r--share/man/man1/objdump.169
-rw-r--r--share/man/man1/ranlib.14
-rw-r--r--share/man/man1/readelf.160
-rw-r--r--share/man/man1/size.14
-rw-r--r--share/man/man1/strings.16
-rw-r--r--share/man/man1/strip.19
-rw-r--r--share/man/man1/windmc.14
-rw-r--r--share/man/man1/windres.14
54 files changed, 1758 insertions, 507 deletions
diff --git a/share/man/man1/aarch64-linux-gnu-addr2line.1 b/share/man/man1/aarch64-linux-gnu-addr2line.1
index a0d4beb..975e4d0 100644
--- a/share/man/man1/aarch64-linux-gnu-addr2line.1
+++ b/share/man/man1/aarch64-linux-gnu-addr2line.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ADDR2LINE 1"
-.TH ADDR2LINE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ADDR2LINE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -339,7 +339,7 @@ with a backslash. The \fIfile\fR may itself contain additional
Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-ar.1 b/share/man/man1/aarch64-linux-gnu-ar.1
index 9409643..48a8086 100644
--- a/share/man/man1/aarch64-linux-gnu-ar.1
+++ b/share/man/man1/aarch64-linux-gnu-ar.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AR 1"
-.TH AR 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AR 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -142,7 +142,7 @@
ar \- create, modify, and extract from archives
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
+ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fB\-\-output\fR \fIdirname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \s-1GNU\s0 \fBar\fR program creates, modifies, and extracts from
@@ -310,7 +310,12 @@ use the \fBv\fR modifier with this operation, to request that
If you do not specify a \fImember\fR, all files in the archive
are extracted.
.Sp
-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 \fBP\fR: The
+paths must not be absolute, may not contain \f(CW\*(C`..\*(C'\fR, and any
+subdirectories in the paths must exist. If it is desired to avoid
+these restrictions then used the \fB\-\-output\fR option to specify
+an output directory.
.PP
A number of modifiers (\fImod\fR) may immediately follow the \fIp\fR
keyletter, to specify variations on an operation's behavior:
@@ -376,12 +381,22 @@ Display member offsets inside the archive. Use together with the \fBt\fR
option.
.IP "\fBP\fR" 4
.IX Item "P"
-Use the full path name when matching names in the archive. \s-1GNU\s0
-\&\fBar\fR can not create an archive with a full path name (such archives
-are not \s-1POSIX\s0 compliant), but other archive creators can. This option
-will cause \s-1GNU\s0 \fBar\fR 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 \s-1POSIX\s0 compliant, and
+thus may not work with tools other than up to date \s-1GNU\s0 tools.
+Modifying such archives with \s-1GNU\s0 \fBar\fR without using
+\&\fBP\fR will remove the full path names unless the archive is a
+thin archive. Note that \fBP\fR may be useful when adding files to
+a thin archive since \fBr\fR without \fBP\fR ignores the path
+when choosing which element to replace. Thus
+.Sp
+.Vb 1
+\& ar rcST archive.a subdir/file1 subdir/file2 file1
+.Ve
+.Sp
+will result in the first \f(CW\*(C`subdir/file1\*(C'\fR being replaced with
+\&\f(CW\*(C`file1\*(C'\fR from the current directory. Adding \fBP\fR will
+prevent this replacement.
.IP "\fBs\fR" 4
.IX Item "s"
Write an object-file index into the archive, or update an existing one,
@@ -438,7 +453,7 @@ and then exits.
Displays the version information of \fBar\fR and then exits.
.IP "\fB\-X32_64\fR" 4
.IX Item "-X32_64"
-\&\fBar\fR ignores an initial option spelt \fB\-X32_64\fR, for
+\&\fBar\fR ignores an initial option spelled \fB\-X32_64\fR, for
compatibility with \s-1AIX.\s0 The behaviour produced by this option is the
default for \s-1GNU\s0 \fBar\fR. \fBar\fR does not support any
of the other \fB\-X\fR options; in particular, it does not support
@@ -471,6 +486,15 @@ sufficient to just copy the newest one.
The optional command-line switch \fB\-\-target\fR \fIbfdname\fR
specifies that the archive members are in an object code format
different from your system's default format. See
+.IP "\fB\-\-output\fR \fIdirname\fR" 4
+.IX Item "--output dirname"
+The \fB\-\-output\fR 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.
+.Sp
+Note \- although the presence of this option does imply a \fBx\fR
+extraction operation that option must still be included on the command
+line.
.IP "\fB@\fR\fIfile\fR" 4
.IX Item "@file"
Read command-line options from \fIfile\fR. The options read are
@@ -489,7 +513,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-as.1 b/share/man/man1/aarch64-linux-gnu-as.1
index 9d8fb44..7413481 100644
--- a/share/man/man1/aarch64-linux-gnu-as.1
+++ b/share/man/man1/aarch64-linux-gnu-as.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AS 1"
-.TH AS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -146,7 +146,8 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-compress\-debug\-sections\fR] [\fB\-\-nocompress\-debug\-sections\fR]
[\fB\-\-debug\-prefix\-map\fR \fIold\fR=\fInew\fR]
[\fB\-\-defsym\fR \fIsym\fR=\fIval\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-\-gstabs\fR]
- [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-2\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-<N>\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gdwarf\-cie\-version\fR=\fI\s-1VERSION\s0\fR]
[\fB\-\-help\fR] [\fB\-I\fR \fIdir\fR] [\fB\-J\fR]
[\fB\-K\fR] [\fB\-L\fR] [\fB\-\-listing\-lhs\-width\fR=\fI\s-1NUM\s0\fR]
[\fB\-\-listing\-lhs\-width2\fR=\fI\s-1NUM\s0\fR] [\fB\-\-listing\-rhs\-width\fR=\fI\s-1NUM\s0\fR]
@@ -442,15 +443,15 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-[no\-]transform\fR]
[\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR]
[\fB\-\-[no\-]trampolines\fR]
+ [\fB\-\-abi\-windowed\fR|\fB\-\-abi\-call0\fR]
.PP
\&\fITarget Z80 options:\fR
- [\fB\-z80\fR] [\fB\-r800\fR]
- [ \fB\-ignore\-undocumented\-instructions\fR] [\fB\-Wnud\fR]
- [ \fB\-ignore\-unportable\-instructions\fR] [\fB\-Wnup\fR]
- [ \fB\-warn\-undocumented\-instructions\fR] [\fB\-Wud\fR]
- [ \fB\-warn\-unportable\-instructions\fR] [\fB\-Wup\fR]
- [ \fB\-forbid\-undocumented\-instructions\fR] [\fB\-Fud\fR]
- [ \fB\-forbid\-unportable\-instructions\fR] [\fB\-Fup\fR]
+ [\fB\-march=\fR\fI\s-1CPU\s0\fR\fI[\-EXT]\fR\fI[+EXT]\fR]
+ [\fB\-local\-prefix=\fR\fI\s-1PREFIX\s0\fR]
+ [\fB\-colonless\fR]
+ [\fB\-sdcc\fR]
+ [\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR]
+ [\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1GNU\s0 \fBas\fR is really a family of assemblers.
@@ -628,7 +629,9 @@ compiler output).
.PD
Generate debugging information for each assembler source line using whichever
debug format is preferred by the target. This currently means either \s-1STABS,
-ECOFF\s0 or \s-1DWARF2.\s0
+ECOFF\s0 or \s-1DWARF2.\s0 When the debug format is \s-1DWARF\s0 then a \f(CW\*(C`.debug_info\*(C'\fR and
+\&\f(CW\*(C`.debug_line\*(C'\fR section is only emitted when the assembly file doesn't
+generate one itself.
.IP "\fB\-\-gstabs\fR" 4
.IX Item "--gstabs"
Generate stabs debugging information for each assembler line. This
@@ -645,6 +648,27 @@ the location of the current working directory at assembling time.
Generate \s-1DWARF2\s0 debugging information for each assembler line. This
may help debugging assembler code, if the debugger can handle it. Note\-\-\-this
option is only supported by some targets, not all of them.
+.IP "\fB\-\-gdwarf\-3\fR" 4
+.IX Item "--gdwarf-3"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 3 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-4\fR" 4
+.IX Item "--gdwarf-4"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 4 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-5\fR" 4
+.IX Item "--gdwarf-5"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 5 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
.IP "\fB\-\-gdwarf\-sections\fR" 4
.IX Item "--gdwarf-sections"
Instead of creating a .debug_line section, create a series of
@@ -654,6 +678,11 @@ will have its dwarf line number information placed into a section called
\&\fI.debug_line.text.func\fR. If the code section is just called \fI.text\fR
then debug line section will still be called just \fI.debug_line\fR without any
suffix.
+.IP "\fB\-\-gdwarf\-cie\-version=\fR\fIversion\fR" 4
+.IX Item "--gdwarf-cie-version=version"
+Control which version of \s-1DWARF\s0 Common Information Entries (CIEs) are produced.
+When this flag is not specificed the default is version 1, though some targets
+can modify this default. Other possible values for \fIversion\fR are 3 or 4.
.IP "\fB\-\-size\-check=error\fR" 4
.IX Item "--size-check=error"
.PD 0
@@ -853,7 +882,7 @@ issue an error message if an attempt is made to assemble an
instruction which will not execute on the target architecture. The
following architecture names are recognized: \f(CW\*(C`armv8\-a\*(C'\fR,
\&\f(CW\*(C`armv8.1\-a\*(C'\fR, \f(CW\*(C`armv8.2\-a\*(C'\fR, \f(CW\*(C`armv8.3\-a\*(C'\fR, \f(CW\*(C`armv8.4\-a\*(C'\fR
-and \f(CW\*(C`armv8.5\-a\*(C'\fR.
+\&\f(CW\*(C`armv8.5\-a\*(C'\fR, and \f(CW\*(C`armv8.6\-a\*(C'\fR.
.Sp
If both \fB\-mcpu\fR and \fB\-march\fR are specified, the
assembler will use the setting for \fB\-mcpu\fR. If neither are
@@ -1349,6 +1378,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`sse\*(C'\fR,
\&\f(CW\*(C`sse2\*(C'\fR,
\&\f(CW\*(C`sse3\*(C'\fR,
+\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`ssse3\*(C'\fR,
\&\f(CW\*(C`sse4.1\*(C'\fR,
\&\f(CW\*(C`sse4.2\*(C'\fR,
@@ -1356,6 +1386,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`nosse\*(C'\fR,
\&\f(CW\*(C`nosse2\*(C'\fR,
\&\f(CW\*(C`nosse3\*(C'\fR,
+\&\f(CW\*(C`nosse4a\*(C'\fR,
\&\f(CW\*(C`nossse3\*(C'\fR,
\&\f(CW\*(C`nosse4.1\*(C'\fR,
\&\f(CW\*(C`nosse4.2\*(C'\fR,
@@ -1383,6 +1414,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movdiri\*(C'\fR,
\&\f(CW\*(C`movdir64b\*(C'\fR,
\&\f(CW\*(C`enqcmd\*(C'\fR,
+\&\f(CW\*(C`serialize\*(C'\fR,
+\&\f(CW\*(C`tsxldtrk\*(C'\fR,
\&\f(CW\*(C`avx512f\*(C'\fR,
\&\f(CW\*(C`avx512cd\*(C'\fR,
\&\f(CW\*(C`avx512er\*(C'\fR,
@@ -1398,6 +1431,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`avx512_vbmi2\*(C'\fR,
\&\f(CW\*(C`avx512_vnni\*(C'\fR,
\&\f(CW\*(C`avx512_bitalg\*(C'\fR,
+\&\f(CW\*(C`avx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`avx512_bf16\*(C'\fR,
\&\f(CW\*(C`noavx512f\*(C'\fR,
\&\f(CW\*(C`noavx512cd\*(C'\fR,
@@ -1417,6 +1451,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`noavx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`noavx512_bf16\*(C'\fR,
\&\f(CW\*(C`noenqcmd\*(C'\fR,
+\&\f(CW\*(C`noserialize\*(C'\fR,
+\&\f(CW\*(C`notsxldtrk\*(C'\fR,
\&\f(CW\*(C`vmx\*(C'\fR,
\&\f(CW\*(C`vmfunc\*(C'\fR,
\&\f(CW\*(C`smx\*(C'\fR,
@@ -1434,6 +1470,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movbe\*(C'\fR,
\&\f(CW\*(C`ept\*(C'\fR,
\&\f(CW\*(C`lzcnt\*(C'\fR,
+\&\f(CW\*(C`popcnt\*(C'\fR,
\&\f(CW\*(C`hle\*(C'\fR,
\&\f(CW\*(C`rtm\*(C'\fR,
\&\f(CW\*(C`invpcid\*(C'\fR,
@@ -1444,6 +1481,9 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`pconfig\*(C'\fR,
\&\f(CW\*(C`waitpkg\*(C'\fR,
\&\f(CW\*(C`cldemote\*(C'\fR,
+\&\f(CW\*(C`rdpru\*(C'\fR,
+\&\f(CW\*(C`mcommit\*(C'\fR,
+\&\f(CW\*(C`sev_es\*(C'\fR,
\&\f(CW\*(C`lwp\*(C'\fR,
\&\f(CW\*(C`fma4\*(C'\fR,
\&\f(CW\*(C`xop\*(C'\fR,
@@ -1454,8 +1494,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`3dnowa\*(C'\fR,
\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`sse5\*(C'\fR,
-\&\f(CW\*(C`svme\*(C'\fR,
-\&\f(CW\*(C`abm\*(C'\fR and
+\&\f(CW\*(C`svme\*(C'\fR and
\&\f(CW\*(C`padlock\*(C'\fR.
Note that rather than extending a basic instruction set, the extension
mnemonics starting with \f(CW\*(C`no\*(C'\fR revoke the respective functionality.
@@ -1579,7 +1618,7 @@ slightly bigger. This option only affects the handling of branch
instructions.
.IP "\fB\-mbig\-obj\fR" 4
.IX Item "-mbig-obj"
-On x86\-64 \s-1PE/COFF\s0 target this option forces the use of big object file
+On \s-1PE/COFF\s0 target this option forces the use of big object file
format, which allows more than 32768 sections.
.IP "\fB\-momit\-lock\-prefix=\fR\fIno\fR" 4
.IX Item "-momit-lock-prefix=no"
@@ -1620,6 +1659,90 @@ R_X86_64_REX_GOTPCRELX, in 64\-bit mode.
\&\fB\-mrelax\-relocations=\fR\fIno\fR will not generate relax
relocations. The default can be controlled by a configure option
\&\fB\-\-enable\-x86\-relax\-relocations\fR.
+.IP "\fB\-malign\-branch\-boundary=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-boundary=NUM"
+This option controls how the assembler should align branches with segment
+prefixes or \s-1NOP.\s0 \fI\s-1NUM\s0\fR must be a power of 2. It should be 0 or
+no less than 16. Branches will be aligned within \fI\s-1NUM\s0\fR byte
+boundary. \fB\-malign\-branch\-boundary=0\fR, which is the default,
+doesn't align branches.
+.IP "\fB\-malign\-branch=\fR\fI\s-1TYPE\s0\fR\fB[+\fR\fI\s-1TYPE\s0\fR\fB...]\fR" 4
+.IX Item "-malign-branch=TYPE[+TYPE...]"
+This option specifies types of branches to align. \fI\s-1TYPE\s0\fR is
+combination of \fBjcc\fR, which aligns conditional jumps,
+\&\fBfused\fR, which aligns fused conditional jumps, \fBjmp\fR,
+which aligns unconditional jumps, \fBcall\fR which aligns calls,
+\&\fBret\fR, which aligns rets, \fBindirect\fR, which aligns indirect
+jumps and calls. The default is \fB\-malign\-branch=jcc+fused+jmp\fR.
+.IP "\fB\-malign\-branch\-prefix\-size=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-prefix-size=NUM"
+This option specifies the maximum number of prefixes on an instruction
+to align branches. \fI\s-1NUM\s0\fR should be between 0 and 5. The default
+\&\fI\s-1NUM\s0\fR is 5.
+.IP "\fB\-mbranches\-within\-32B\-boundaries\fR" 4
+.IX Item "-mbranches-within-32B-boundaries"
+This option aligns conditional jumps, fused conditional jumps and
+unconditional jumps within 32 byte boundary with up to 5 segment prefixes
+on an instruction. It is equivalent to
+\&\fB\-malign\-branch\-boundary=32\fR
+\&\fB\-malign\-branch=jcc+fused+jmp\fR
+\&\fB\-malign\-branch\-prefix\-size=5\fR.
+The default doesn't align branches.
+.IP "\fB\-mlfence\-after\-load=\fR\fIno\fR" 4
+.IX Item "-mlfence-after-load=no"
+.PD 0
+.IP "\fB\-mlfence\-after\-load=\fR\fIyes\fR" 4
+.IX Item "-mlfence-after-load=yes"
+.PD
+These options control whether the assembler should generate lfence
+after load instructions. \fB\-mlfence\-after\-load=\fR\fIyes\fR will
+generate lfence. \fB\-mlfence\-after\-load=\fR\fIno\fR will not generate
+lfence, which is the default.
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-indirect-branch=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR" 4
+.IX Item "-mlfence-before-indirect-branch=all"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR" 4
+.IX Item "-mlfence-before-indirect-branch=register"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR" 4
+.IX Item "-mlfence-before-indirect-branch=memory"
+.PD
+These options control whether the assembler should generate lfence
+before indirect near branch instructions.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR will generate lfence
+before indirect near branch via register and issue a warning before
+indirect near branch via memory.
+It also implicitly sets \fB\-mlfence\-before\-ret=\fR\fIshl\fR when
+there's no explict \fB\-mlfence\-before\-ret=\fR.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR will generate
+lfence before indirect near branch via register.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR will issue a
+warning before indirect near branch via memory.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR will not generate
+lfence nor issue warning, which is the default. Note that lfence won't
+be generated before indirect near branch via register with
+\&\fB\-mlfence\-after\-load=\fR\fIyes\fR since lfence will be generated
+after loading branch target register.
+.IP "\fB\-mlfence\-before\-ret=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-ret=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-ret=\fR\fIshl\fR" 4
+.IX Item "-mlfence-before-ret=shl"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIor\fR" 4
+.IX Item "-mlfence-before-ret=or"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIyes\fR" 4
+.IX Item "-mlfence-before-ret=yes"
+.IP "\fB\-mlfence\-before\-ret=\fR\fInot\fR" 4
+.IX Item "-mlfence-before-ret=not"
+.PD
+These options control whether the assembler should generate lfence
+before ret. \fB\-mlfence\-before\-ret=\fR\fIor\fR will generate
+generate or instruction with lfence.
+\&\fB\-mlfence\-before\-ret=\fR\fIshl/yes\fR will generate shl instruction
+with lfence. \fB\-mlfence\-before\-ret=\fR\fInot\fR will generate not
+instruction with lfence. \fB\-mlfence\-before\-ret=\fR\fInone\fR will not
+generate lfence, which is the default.
.IP "\fB\-mx86\-used\-note=\fR\fIno\fR" 4
.IX Item "-mx86-used-note=no"
.PD 0
@@ -1653,7 +1776,8 @@ with 01, 10 and 11 \s-1RC\s0 bits, respectively.
.IX Item "-mintel64"
.PD
This option specifies that the assembler should accept only \s-1AMD64\s0 or
-Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept both.
+Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept common, Intel64
+only and \s-1AMD64\s0 ISAs.
.IP "\fB\-O0 | \-O | \-O1 | \-O2 | \-Os\fR" 4
.IX Item "-O0 | -O | -O1 | -O2 | -Os"
Optimize instruction encoding with smaller instruction size. \fB\-O\fR
@@ -2455,6 +2579,9 @@ Generate code for Power8 architecture.
.IP "\fB\-mpower9, \-mpwr9\fR" 4
.IX Item "-mpower9, -mpwr9"
Generate code for Power9 architecture.
+.IP "\fB\-mpower10, \-mpwr10\fR" 4
+.IX Item "-mpower10, -mpwr10"
+Generate code for Power10 architecture.
.IP "\fB\-mcell\fR" 4
.IX Item "-mcell"
.PD 0
@@ -2515,6 +2642,20 @@ Don't generate position-independent code (default)
.IP "\fB\-march=ISA\fR" 4
.IX Item "-march=ISA"
Select the base isa, as specified by \s-1ISA.\s0 For example \-march=rv32ima.
+If this option and the architecture attributes aren't set, then assembler
+will check the default configure setting \-\-with\-arch=ISA.
+.IP "\fB\-misa\-spec=ISAspec\fR" 4
+.IX Item "-misa-spec=ISAspec"
+Select the default isa spec version. If the version of \s-1ISA\s0 isn't set
+by \-march, then assembler helps to set the version according to
+the default chosen spec. If this option isn't set, then assembler will
+check the default configure setting \-\-with\-isa\-spec=ISAspec.
+.IP "\fB\-mpriv\-spec=PRIVspec\fR" 4
+.IX Item "-mpriv-spec=PRIVspec"
+Select the privileged spec version. We can decide whether the \s-1CSR\s0 is valid or
+not according to the chosen spec. If this option and the privilege attributes
+aren't set, then assembler will check the default configure setting
+\&\-\-with\-priv\-spec=PRIVspec.
.IP "\fB\-mabi=ABI\fR" 4
.IX Item "-mabi=ABI"
Selects the \s-1ABI,\s0 which is either \*(L"ilp32\*(R" or \*(L"lp64\*(R", optionally followed
@@ -2529,6 +2670,26 @@ required to materialize symbol addresses. (default)
.IP "\fB\-mno\-relax\fR" 4
.IX Item "-mno-relax"
Don't do linker relaxations.
+.IP "\fB\-march\-attr\fR" 4
+.IX Item "-march-attr"
+Generate the default contents for the riscv elf attribute section if the
+\&.attribute directives are not set. This section is used to record the
+information that a linker or runtime loader needs to check compatibility.
+This information includes \s-1ISA\s0 string, stack alignment requirement, unaligned
+memory accesses, and the major, minor and revision version of privileged
+specification.
+.IP "\fB\-mno\-arch\-attr\fR" 4
+.IX Item "-mno-arch-attr"
+Don't generate the default riscv elf attribute section if the .attribute
+directives are not set.
+.IP "\fB\-mcsr\-check\fR" 4
+.IX Item "-mcsr-check"
+Enable the \s-1CSR\s0 checking for the ISA-dependent \s-1CRS\s0 and the read-only \s-1CSR.\s0
+The ISA-dependent \s-1CSR\s0 are only valid when the specific \s-1ISA\s0 is set. The
+read-only \s-1CSR\s0 can not be written by the \s-1CSR\s0 instructions.
+.IP "\fB\-mno\-csr\-check\fR" 4
+.IX Item "-mno-csr-check"
+Don't do \s-1CSR\s0 cheching.
.PP
See the info pages for documentation of the RX-specific options.
.PP
@@ -2555,7 +2716,8 @@ Specify which s390 processor variant is the target, \fBg5\fR (or
\&\fBarch3\fR), \fBg6\fR, \fBz900\fR (or \fBarch5\fR), \fBz990\fR (or
\&\fBarch6\fR), \fBz9\-109\fR, \fBz9\-ec\fR (or \fBarch7\fR), \fBz10\fR (or
\&\fBarch8\fR), \fBz196\fR (or \fBarch9\fR), \fBzEC12\fR (or \fBarch10\fR),
-\&\fBz13\fR (or \fBarch11\fR), or \fBz14\fR (or \fBarch12\fR).
+\&\fBz13\fR (or \fBarch11\fR), \fBz14\fR (or \fBarch12\fR), or \fBz15\fR
+(or \fBarch13\fR).
.IP "\fB\-mregnames\fR" 4
.IX Item "-mregnames"
.PD 0
@@ -2723,63 +2885,72 @@ across a greater range of addresses. This option should be used when jump tar
potentially be out of range. In the absence of such jumps this option
does not affect code size or performance. The default is
\&\fB\-\-trampolines\fR.
+.IP "\fB\-\-abi\-windowed | \-\-abi\-call0\fR" 4
+.IX Item "--abi-windowed | --abi-call0"
+Choose \s-1ABI\s0 tag written to the \f(CW\*(C`.xtensa.info\*(C'\fR section. \s-1ABI\s0 tag
+indicates \s-1ABI\s0 of the assembly code. A warning is issued by the linker
+on an attempt to link object files with inconsistent \s-1ABI\s0 tags.
+Default \s-1ABI\s0 is chosen by the Xtensa core configuration.
.PP
-The following options are available when as is configured for
-a Z80 family processor.
-.IP "\fB\-z80\fR" 4
-.IX Item "-z80"
-Assemble for Z80 processor.
-.IP "\fB\-r800\fR" 4
-.IX Item "-r800"
-Assemble for R800 processor.
-.IP "\fB\-ignore\-undocumented\-instructions\fR" 4
-.IX Item "-ignore-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wnud\fR" 4
-.IX Item "-Wnud"
-.PD
-Assemble undocumented Z80 instructions that also work on R800 without warning.
-.IP "\fB\-ignore\-unportable\-instructions\fR" 4
-.IX Item "-ignore-unportable-instructions"
-.PD 0
-.IP "\fB\-Wnup\fR" 4
-.IX Item "-Wnup"
-.PD
-Assemble all undocumented Z80 instructions without warning.
-.IP "\fB\-warn\-undocumented\-instructions\fR" 4
-.IX Item "-warn-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wud\fR" 4
-.IX Item "-Wud"
-.PD
-Issue a warning for undocumented Z80 instructions that also work on R800.
-.IP "\fB\-warn\-unportable\-instructions\fR" 4
-.IX Item "-warn-unportable-instructions"
-.PD 0
-.IP "\fB\-Wup\fR" 4
-.IX Item "-Wup"
-.PD
-Issue a warning for undocumented Z80 instructions that do not work on R800.
-.IP "\fB\-forbid\-undocumented\-instructions\fR" 4
-.IX Item "-forbid-undocumented-instructions"
-.PD 0
-.IP "\fB\-Fud\fR" 4
-.IX Item "-Fud"
-.PD
-Treat all undocumented instructions as errors.
-.IP "\fB\-forbid\-unportable\-instructions\fR" 4
-.IX Item "-forbid-unportable-instructions"
-.PD 0
-.IP "\fB\-Fup\fR" 4
-.IX Item "-Fup"
-.PD
-Treat undocumented Z80 instructions that do not work on R800 as errors.
+The following options are available when as is configured for an
+Z80 processor.
+.PP
+\&\f(CW@chapter\fR Z80 Dependent Features
+.SS "Command-line Options"
+.IX Subsection "Command-line Options"
+.IP "\fB\-march=\fR\fI\s-1CPU\s0\fR\fB[\-\fR\fI\s-1EXT\s0\fR\fB...][+\fR\fI\s-1EXT\s0\fR\fB...]\fR" 4
+.IX Item "-march=CPU[-EXT...][+EXT...]"
+This option specifies the target processor. The assembler will issue
+an error message if an attempt is made to assemble an instruction which
+will not execute on the target processor. The following processor names
+are recognized:
+\&\f(CW\*(C`z80\*(C'\fR,
+\&\f(CW\*(C`z180\*(C'\fR,
+\&\f(CW\*(C`ez80\*(C'\fR,
+\&\f(CW\*(C`gbz80\*(C'\fR,
+\&\f(CW\*(C`z80n\*(C'\fR,
+\&\f(CW\*(C`r800\*(C'\fR.
+In addition to the basic instruction set, the assembler can be told to
+accept some extention mnemonics. For example,
+\&\f(CW\*(C`\-march=z180+sli+infc\*(C'\fR extends \fIz180\fR with \fI\s-1SLI\s0\fR instructions and
+\&\fI\s-1IN F,\s0(C)\fR. The following extentions are currently supported:
+\&\f(CW\*(C`full\*(C'\fR (all known instructions),
+\&\f(CW\*(C`adl\*(C'\fR (\s-1ADL CPU\s0 mode by default, eZ80 only),
+\&\f(CW\*(C`sli\*(C'\fR (instruction known as \fI\s-1SLI\s0\fR, \fI\s-1SLL\s0\fR or \fI\s-1SL1\s0\fR),
+\&\f(CW\*(C`xyhl\*(C'\fR (instructions with halves of index registers: \fI\s-1IXL\s0\fR, \fI\s-1IXH\s0\fR,
+\&\fI\s-1IYL\s0\fR, \fI\s-1IYH\s0\fR),
+\&\f(CW\*(C`xdcb\*(C'\fR (instructions like \fIRotOp (II+d),R\fR and \fIBitOp n,(II+d),R\fR),
+\&\f(CW\*(C`infc\*(C'\fR (instruction \fI\s-1IN F,\s0(C)\fR or \fI\s-1IN\s0 (C)\fR),
+\&\f(CW\*(C`outc0\*(C'\fR (instruction \fI\s-1OUT\s0 (C),0\fR).
+Note that rather than extending a basic instruction set, the extention
+mnemonics starting with \f(CW\*(C`\-\*(C'\fR revoke the respective functionality:
+\&\f(CW\*(C`\-march=z80\-full+xyhl\*(C'\fR first removes all default extentions and adds
+support for index registers halves only.
+.Sp
+If this option is not specified then \f(CW\*(C`\-march=z80+xyhl+infc\*(C'\fR is assumed.
+.IP "\fB\-local\-prefix=\fR\fIprefix\fR" 4
+.IX Item "-local-prefix=prefix"
+Mark all labels with specified prefix as local. But such label can be
+marked global explicitly in the code. This option do not change default
+local label prefix \f(CW\*(C`.L\*(C'\fR, it is just adds new one.
+.IP "\fB\-colonless\fR" 4
+.IX Item "-colonless"
+Accept colonless labels. All symbols at line begin are treated as labels.
+.IP "\fB\-sdcc\fR" 4
+.IX Item "-sdcc"
+Accept assembler code produced by \s-1SDCC.\s0
+.IP "\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-s=FORMAT"
+Single precision floating point numbers format. Default: ieee754 (32 bit).
+.IP "\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-d=FORMAT"
+Double precision floating point numbers format. Default: ieee754 (64 bit).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBgcc\fR\|(1), \fBld\fR\|(1), and the Info entries for \fIbinutils\fR and \fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-c++filt.1 b/share/man/man1/aarch64-linux-gnu-c++filt.1
index 1939a69..00e65a7 100644
--- a/share/man/man1/aarch64-linux-gnu-c++filt.1
+++ b/share/man/man1/aarch64-linux-gnu-c++filt.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "C++FILT 1"
-.TH C++FILT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH C++FILT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -366,7 +366,7 @@ MS-DOS this program is named \fB\s-1CXXFILT\s0\fR.
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-dlltool.1 b/share/man/man1/aarch64-linux-gnu-dlltool.1
index a3eae27..986c76c 100644
--- a/share/man/man1/aarch64-linux-gnu-dlltool.1
+++ b/share/man/man1/aarch64-linux-gnu-dlltool.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "DLLTOOL 1"
-.TH DLLTOOL 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH DLLTOOL 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -532,7 +532,7 @@ with a backslash. The \fIfile\fR may itself contain additional
The Info pages for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-elfedit.1 b/share/man/man1/aarch64-linux-gnu-elfedit.1
index db0efe9..c583e22 100644
--- a/share/man/man1/aarch64-linux-gnu-elfedit.1
+++ b/share/man/man1/aarch64-linux-gnu-elfedit.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ELFEDIT 1"
-.TH ELFEDIT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ELFEDIT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -250,7 +250,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-gprof.1 b/share/man/man1/aarch64-linux-gnu-gprof.1
index 1b892b0..6f081c6 100644
--- a/share/man/man1/aarch64-linux-gnu-gprof.1
+++ b/share/man/man1/aarch64-linux-gnu-gprof.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "GPROF 1"
-.TH GPROF 1 "2019-10-12" "binutils-2.33.1" "GNU"
+.TH GPROF 1 "2020-09-19" "binutils-2.35.1" "GNU"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -762,7 +762,7 @@ Proceedings of the \s-1SIGPLAN\s0 '82 Symposium on Compiler Construction,
\&\s-1SIGPLAN\s0 Notices, Vol. 17, No 6, pp. 120\-126, June 1982.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1988\-2019 Free Software Foundation, Inc.
+Copyright (c) 1988\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-ld.1 b/share/man/man1/aarch64-linux-gnu-ld.1
index 9e77e89..ef33aa2 100644
--- a/share/man/man1/aarch64-linux-gnu-ld.1
+++ b/share/man/man1/aarch64-linux-gnu-ld.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "LD 1"
-.TH LD 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH LD 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -362,6 +362,46 @@ specified in the library. If specified multiple times \f(CW\*(C`DT_DEPAUDIT\*(C
will contain a colon separated list of audit interfaces to use. This
option is only meaningful on \s-1ELF\s0 platforms supporting the rtld-audit interface.
The \-P option is provided for Solaris compatibility.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\fR" 4
+.IX Item "--enable-non-contiguous-regions"
+This option avoids generating an error if an input section does not
+fit a matching output section. The linker tries to allocate the input
+section to subseque nt matching output sections, and generates an
+error only if no output section is large enough. This is useful when
+several non-contiguous memory regions are available and the input
+section does not require a particular one. The order in which input
+sections are evaluated does not change, for instance:
+.Sp
+.Vb 10
+\& MEMORY {
+\& MEM1 (rwx) : ORIGIN : 0x1000, LENGTH = 0x14
+\& MEM2 (rwx) : ORIGIN : 0x1000, LENGTH = 0x40
+\& MEM3 (rwx) : ORIGIN : 0x2000, LENGTH = 0x40
+\& }
+\& SECTIONS {
+\& mem1 : { *(.data.*); } > MEM1
+\& mem2 : { *(.data.*); } > MEM2
+\& mem3 : { *(.data.*); } > MEM2
+\& }
+\&
+\& with input sections:
+\& .data.1: size 8
+\& .data.2: size 0x10
+\& .data.3: size 4
+\&
+\& results in .data.1 affected to mem1, and .data.2 and .data.3
+\& affected to mem2, even though .data.3 would fit in mem3.
+.Ve
+.Sp
+This option is incompatible with \s-1INSERT\s0 statements because it changes
+the way input sections are mapped to output sections.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\-warnings\fR" 4
+.IX Item "--enable-non-contiguous-regions-warnings"
+This option enables warnings when
+\&\f(CW\*(C`\-\-enable\-non\-contiguous\-regions\*(C'\fR allows possibly unexpected
+matches in sections mapping, potentially leading to silently
+discarding a section instead of failing because it does not fit any
+output region.
.IP "\fB\-e\fR \fIentry\fR" 4
.IX Item "-e entry"
.PD 0
@@ -426,6 +466,20 @@ See the description of \fB\-\-dynamic\-list\fR.
Note that this option is specific to \s-1ELF\s0 targeted ports. \s-1PE\s0 targets
support a similar function to export all symbols from a \s-1DLL\s0 or \s-1EXE\s0; see
the description of \fB\-\-export\-all\-symbols\fR below.
+.IP "\fB\-\-export\-dynamic\-symbol=\fR\fIglob\fR" 4
+.IX Item "--export-dynamic-symbol=glob"
+When creating a dynamically linked executable, symbols matching
+\&\fIglob\fR will be added to the dynamic symbol table. When creating a
+shared library, references to symbols matching \fIglob\fR will not be
+bound to the definitions within the shared library. This option is a
+no-op when creating a shared library and \fB\-Bsymbolic\fR or
+\&\fB\-\-dynamic\-list\fR are not specified. This option is only meaningful
+on \s-1ELF\s0 platforms which support shared libraries.
+.IP "\fB\-\-export\-dynamic\-symbol\-list=\fR\fIfile\fR" 4
+.IX Item "--export-dynamic-symbol-list=file"
+Specify a \fB\-\-export\-dynamic\-symbol\fR for each pattern in the file.
+The format of the file is the same as the version node without
+scope and node name. See \fB\s-1VERSION\s0\fR for more information.
.IP "\fB\-EB\fR" 4
.IX Item "-EB"
Link big-endian objects. This affects the default output format.
@@ -708,6 +762,17 @@ shared libraries. Use \fB\-Bdynamic\fR for this.
Use \fIoutput\fR as the name for the program produced by \fBld\fR; if this
option is not specified, the name \fIa.out\fR is used by default. The
script command \f(CW\*(C`OUTPUT\*(C'\fR can also specify the output file name.
+.IP "\fB\-\-dependency\-file=\fR\fIdepfile\fR" 4
+.IX Item "--dependency-file=depfile"
+Write a \fIdependency file\fR to \fIdepfile\fR. This file contains a rule
+suitable for \f(CW\*(C`make\*(C'\fR describing the output file and all the input files
+that were read to produce it. The output is similar to the compiler's
+output with \fB\-M \-MP\fR. Note that there is no option like the compiler's \fB\-MM\fR,
+to exclude \*(L"system files\*(R" (which is not a well-specified concept in the
+linker, unlike \*(L"system headers\*(R" in the compiler). So the output from
+\&\fB\-\-dependency\-file\fR is always specific to the exact state of the
+installation where it was produced, and should not be copied into
+distributed makefiles without careful editing.
.IP "\fB\-O\fR \fIlevel\fR" 4
.IX Item "-O level"
If \fIlevel\fR is a numeric values greater than zero \fBld\fR optimizes
@@ -1197,6 +1262,16 @@ Linux/i386 and Linux/x86_64.
Specify a stack size for an \s-1ELF\s0 \f(CW\*(C`PT_GNU_STACK\*(C'\fR segment.
Specifying zero will override any default non-zero sized
\&\f(CW\*(C`PT_GNU_STACK\*(C'\fR segment creation.
+.IP "\fBstart\-stop\-visibility=\fR\fIvalue\fR" 4
+.IX Item "start-stop-visibility=value"
+Specify the \s-1ELF\s0 symbol visibility for synthesized
+\&\f(CW\*(C`_\|_start_SECNAME\*(C'\fR and \f(CW\*(C`_\|_stop_SECNAME\*(C'\fR symbols. \fIvalue\fR must be exactly \fBdefault\fR,
+\&\fBinternal\fR, \fBhidden\fR, or \fBprotected\fR. If no \fB\-z
+start-stop-visibility\fR option is given, \fBprotected\fR is used for
+compatibility with historical practice. However, it's highly
+recommended to use \fB\-z start\-stop\-visibility=hidden\fR in new
+programs and shared libraries so that these symbols are not exported
+between shared objects, which is not usually what's intended.
.IP "\fBtext\fR" 4
.IX Item "text"
.PD 0
@@ -1205,9 +1280,9 @@ Specifying zero will override any default non-zero sized
.IP "\fBtextoff\fR" 4
.IX Item "textoff"
.PD
-Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the binary has dynamic
-relocations in read-only sections. Don't report an error if
-\&\fBnotext\fR or \fBtextoff\fR.
+Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the position-independent
+or shared object has dynamic relocations in read-only sections. Don't
+report an error if \fBnotext\fR or \fBtextoff\fR.
.IP "\fBundefs\fR" 4
.IX Item "undefs"
Do not report unresolved symbol references from regular object files,
@@ -1330,20 +1405,14 @@ libraries.
When creating a shared library, bind references to global symbols to the
definition within the shared library, if any. Normally, it is possible
for a program linked against a shared library to override the definition
-within the shared library. This option can also be used with the
-\&\fB\-\-export\-dynamic\fR option, when creating a position independent
-executable, to bind references to global symbols to the definition within
-the executable. This option is only meaningful on \s-1ELF\s0 platforms which
-support shared libraries and position independent executables.
+within the shared library. This option is only meaningful on \s-1ELF\s0
+platforms which support shared libraries.
.IP "\fB\-Bsymbolic\-functions\fR" 4
.IX Item "-Bsymbolic-functions"
When creating a shared library, bind references to global function
symbols to the definition within the shared library, if any.
-This option can also be used with the \fB\-\-export\-dynamic\fR option,
-when creating a position independent executable, to bind references
-to global function symbols to the definition within the executable.
This option is only meaningful on \s-1ELF\s0 platforms which support shared
-libraries and position independent executables.
+libraries.
.IP "\fB\-\-dynamic\-list=\fR\fIdynamic-list-file\fR" 4
.IX Item "--dynamic-list=dynamic-list-file"
Specify the name of a dynamic list file to the linker. This is
@@ -1589,7 +1658,10 @@ Print a summary of all target-specific options on the standard output and exit.
.IP "\fB\-Map=\fR\fImapfile\fR" 4
.IX Item "-Map=mapfile"
Print a link map to the file \fImapfile\fR. See the description of the
-\&\fB\-M\fR option, above.
+\&\fB\-M\fR option, above. Specifying a directory as \fImapfile\fR
+causes the linker map to be written into a file inside the directory.
+The name of the file is based upon the \fIoutput\fR filename with
+\&\f(CW\*(C`.map\*(C'\fR appended.
.IP "\fB\-\-no\-keep\-memory\fR" 4
.IX Item "--no-keep-memory"
\&\fBld\fR normally optimizes for speed over memory usage by caching the
@@ -1863,8 +1935,18 @@ libraries needed by it. The \f(CW\*(C`DT_RPATH\*(C'\fR entries are ignored if
.IP "7." 4
The default directories, normally \fI/lib\fR and \fI/usr/lib\fR.
.IP "8." 4
-For a native linker on an \s-1ELF\s0 system, if the file \fI/etc/ld.so.conf\fR
-exists, the list of directories found in that file.
+For a linker for a Linux system, if the file \fI/etc/ld.so.conf\fR
+exists, the list of directories found in that file. Note: the path
+to this file is prefixed with the \f(CW\*(C`sysroot\*(C'\fR value, if that is
+defined, and then any \f(CW\*(C`prefix\*(C'\fR string if the linker was
+configured with the \fB\-\-prefix=<path>\fR option.
+.IP "9." 4
+For a native linker on a FreeBSD system, any directories specified by
+the \f(CW\*(C`_PATH_ELF_HINTS\*(C'\fR macro defined in the \fIelf\-hints.h\fR
+header file.
+.IP "10." 4
+Any directories specifed by a \f(CW\*(C`SEARCH_DIR\*(C'\fR command in the
+linker script being used.
.RE
.RS 4
.Sp
@@ -2148,9 +2230,10 @@ alignment. Typically, the alignment will be set by an input section.
The address will only be changed if it not explicitly specified; that
is, if the \f(CW\*(C`SECTIONS\*(C'\fR command does not specify a start address for
the section.
-.IP "\fB\-\-warn\-shared\-textrel\fR" 4
-.IX Item "--warn-shared-textrel"
-Warn if the linker adds a \s-1DT_TEXTREL\s0 to a shared object.
+.IP "\fB\-\-warn\-textrel\fR" 4
+.IX Item "--warn-textrel"
+Warn if the linker adds \s-1DT_TEXTREL\s0 to a position-independent executable
+or shared object.
.IP "\fB\-\-warn\-alternate\-em\fR" 4
.IX Item "--warn-alternate-em"
Warn if an object has alternate \s-1ELF\s0 machine code.
@@ -2758,11 +2841,14 @@ of the \s-1PE\s0 file header:
.IX Item "--high-entropy-va"
Image is compatible with 64\-bit address space layout randomization
(\s-1ASLR\s0).
+This option also implies \fB\-\-dynamicbase\fR and
+\&\fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-dynamicbase\fR" 4
.IX Item "--dynamicbase"
The image base address may be relocated using address space layout
randomization (\s-1ASLR\s0). This feature was introduced with \s-1MS\s0 Windows
Vista for i386 \s-1PE\s0 targets.
+This option also implies \fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-forceinteg\fR" 4
.IX Item "--forceinteg"
Code integrity checks are enforced.
@@ -2800,6 +2886,10 @@ same sources are linked. The option \fB\-\-no\-insert\-timestamp\fR
can be used to insert a zero value for the timestamp, this ensuring
that binaries produced from identical sources will compare
identically.
+.IP "\fB\-\-enable\-reloc\-section\fR" 4
+.IX Item "--enable-reloc-section"
+Create the base relocation table, which is necessary if the image
+is loaded at a different image base than specified in the \s-1PE\s0 header.
.PP
The C6X uClinux target uses a binary format called \s-1DSBT\s0 to support shared
libraries. Each shared library in the system needs to have a unique index;
@@ -2891,11 +2981,63 @@ an error.
.IP "\fB\-\-compact\-branches\fR" 4
.IX Item "--compact-branches"
.PD 0
-.IP "\fB\-\-compact\-branches\fR" 4
-.IX Item "--compact-branches"
+.IP "\fB\-\-no\-compact\-branches\fR" 4
+.IX Item "--no-compact-branches"
.PD
These options control the generation of compact instructions by the linker
in the \s-1PLT\s0 entries for \s-1MIPS R6.\s0
+.PP
+For the pdp11\-aout target, three variants of the output format can be
+produced as selected by the following options. The default variant
+for pdp11\-aout is the \fB\-\-omagic\fR option, whereas for other
+targets \fB\-\-nmagic\fR is the default. The \fB\-\-imagic\fR option is
+defined only for the pdp11\-aout target, while the others are described
+here as they apply to the pdp11\-aout target.
+.IP "\fB\-N\fR" 4
+.IX Item "-N"
+.PD 0
+.IP "\fB\-\-omagic\fR" 4
+.IX Item "--omagic"
+.PD
+Mark the output as \f(CW\*(C`OMAGIC\*(C'\fR (0407) in the \fIa.out\fR header to
+indicate that the text segment is not to be write-protected and
+shared. Since the text and data sections are both readable and
+writable, the data section is allocated immediately contiguous after
+the text segment. This is the oldest format for \s-1PDP11\s0 executable
+programs and is the default for \fBld\fR on \s-1PDP11\s0 Unix systems
+from the beginning through 2.11BSD.
+.IP "\fB\-n\fR" 4
+.IX Item "-n"
+.PD 0
+.IP "\fB\-\-nmagic\fR" 4
+.IX Item "--nmagic"
+.PD
+Mark the output as \f(CW\*(C`NMAGIC\*(C'\fR (0410) in the \fIa.out\fR header to
+indicate that when the output file is executed, the text portion will
+be read-only and shareable among all processes executing the same
+file. This involves moving the data areas up to the first possible 8K
+byte page boundary following the end of the text. This option creates
+a \fIpure executable\fR format.
+.IP "\fB\-z\fR" 4
+.IX Item "-z"
+.PD 0
+.IP "\fB\-\-imagic\fR" 4
+.IX Item "--imagic"
+.PD
+Mark the output as \f(CW\*(C`IMAGIC\*(C'\fR (0411) in the \fIa.out\fR header to
+indicate that when the output file is executed, the program text and
+data areas will be loaded into separate address spaces using the split
+instruction and data space feature of the memory management unit in
+larger models of the \s-1PDP11.\s0 This doubles the address space available
+to the program. The text segment is again pure, write-protected, and
+shareable. The only difference in the output format between this
+option and the others, besides the magic number, is that both the text
+and data sections start at location 0. The \fB\-z\fR option selected
+this format in 2.11BSD. This option creates a \fIseparate
+executable\fR format.
+.IP "\fB\-\-no\-omagic\fR" 4
+.IX Item "--no-omagic"
+Equivalent to \fB\-\-nmagic\fR for pdp11\-aout.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
You can change the behaviour of \fBld\fR with the environment variables
@@ -2935,7 +3077,7 @@ the Info entries for \fIbinutils\fR and
\&\fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-nm.1 b/share/man/man1/aarch64-linux-gnu-nm.1
index 6811de2..e37a0a1 100644
--- a/share/man/man1/aarch64-linux-gnu-nm.1
+++ b/share/man/man1/aarch64-linux-gnu-nm.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "NM 1"
-.TH NM 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH NM 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -592,7 +592,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-objcopy.1 b/share/man/man1/aarch64-linux-gnu-objcopy.1
index 974655e..09814c0 100644
--- a/share/man/man1/aarch64-linux-gnu-objcopy.1
+++ b/share/man/man1/aarch64-linux-gnu-objcopy.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJCOPY 1"
-.TH OBJCOPY 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJCOPY 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -166,6 +166,7 @@ objcopy [\fB\-F\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-\-interleave\-width=\fR\fIwidth\fR]
[\fB\-j\fR \fIsectionpattern\fR|\fB\-\-only\-section=\fR\fIsectionpattern\fR]
[\fB\-R\fR \fIsectionpattern\fR|\fB\-\-remove\-section=\fR\fIsectionpattern\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -363,6 +364,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove non-dynamic relocations from the output file for any section
@@ -600,16 +605,18 @@ done by increasing the size of the last section. The extra space is
filled in with the value specified by \fB\-\-gap\-fill\fR (default zero).
.IP "\fB\-\-set\-start\fR \fIval\fR" 4
.IX Item "--set-start val"
-Set the start address of the new file to \fIval\fR. 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 \fIval\fR. Not all object file formats support setting the
+start address.
.IP "\fB\-\-change\-start\fR \fIincr\fR" 4
.IX Item "--change-start incr"
.PD 0
.IP "\fB\-\-adjust\-start\fR \fIincr\fR" 4
.IX Item "--adjust-start incr"
.PD
-Change the start address by adding \fIincr\fR. Not all object file
-formats support setting the start address.
+Change the start address (also known as the entry address) by adding
+\&\fIincr\fR. Not all object file formats support setting the start
+address.
.IP "\fB\-\-change\-addresses\fR \fIincr\fR" 4
.IX Item "--change-addresses incr"
.PD 0
@@ -686,11 +693,13 @@ Set the flags for any sections matching \fIsectionpattern\fR. The
\&\fIflags\fR argument is a comma separated string of flag names. The
recognized names are \fBalloc\fR, \fBcontents\fR, \fBload\fR,
\&\fBnoload\fR, \fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR,
-\&\fBshare\fR, and \fBdebug\fR. You can set the \fBcontents\fR flag
-for a section which does not have contents, but it is not meaningful
-to clear the \fBcontents\fR flag of a section which does have
-contents\*(--just remove the section instead. Not all flags are
-meaningful for all object file formats.
+\&\fBexclude\fR, \fBshare\fR, and \fBdebug\fR. You can set the
+\&\fBcontents\fR flag for a section which does not have contents, but it
+is not meaningful to clear the \fBcontents\fR 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
+\&\fBshare\fR flag is only meaningful for \s-1COFF\s0 format files and not for
+\&\s-1ELF\s0 format files.
.IP "\fB\-\-set\-section\-alignment\fR \fIsectionpattern\fR\fB=\fR\fIalign\fR" 4
.IX Item "--set-section-alignment sectionpattern=align"
Set the alignment for any sections matching \fIsectionpattern\fR.
@@ -746,7 +755,8 @@ Rename a section from \fIoldname\fR to \fInewname\fR, optionally
changing the section's flags to \fIflags\fR 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.
+executable. This option accepts the same set of flags as the
+\&\fB\-\-sect\-section\-flags\fR option.
.Sp
This option is particularly helpful when the input format is binary,
since this will always create a section called .data. If for example,
@@ -1218,7 +1228,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBld\fR\|(1), \fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-objdump.1 b/share/man/man1/aarch64-linux-gnu-objdump.1
index 65acc7b..c2209fb 100644
--- a/share/man/man1/aarch64-linux-gnu-objdump.1
+++ b/share/man/man1/aarch64-linux-gnu-objdump.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJDUMP 1"
-.TH OBJDUMP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJDUMP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -167,8 +167,8 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-r\fR|\fB\-\-reloc\fR]
[\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
[\fB\-s\fR|\fB\-\-full\-contents\fR]
- [\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-dwarf\fR[=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]]
+ [\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-dwarf\fR[=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]]
[\fB\-\-ctf=\fR\fIsection\fR]
[\fB\-G\fR|\fB\-\-stabs\fR]
[\fB\-t\fR|\fB\-\-syms\fR]
@@ -177,19 +177,19 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-w\fR|\fB\-\-wide\fR]
[\fB\-\-start\-address=\fR\fIaddress\fR]
[\fB\-\-stop\-address=\fR\fIaddress\fR]
+ [\fB\-\-no\-addresses\fR]
[\fB\-\-prefix\-addresses\fR]
[\fB\-\-[no\-]show\-raw\-insn\fR]
[\fB\-\-adjust\-vma=\fR\fIoffset\fR]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf\-parent=\fR\fIsection\fR]
- [\fB\-\-ctf\-symbols=\fR\fIsection\fR]
- [\fB\-\-ctf\-strings=\fR\fIsection\fR]
[\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]
[\fB\-\-special\-syms\fR]
[\fB\-\-prefix=\fR\fIprefix\fR]
[\fB\-\-prefix\-strip=\fR\fIlevel\fR]
[\fB\-\-insn\-width=\fR\fIwidth\fR]
+ [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR
[\fB\-V\fR|\fB\-\-version\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIobjfile\fR...
@@ -286,7 +286,7 @@ possible and any bug reports about such an event will be rejected.
.PD
Display debugging information. This attempts to parse \s-1STABS\s0
debugging format information stored in the file and print it out using
-a C like syntax. If no \s-1STABS\s0 debuging was found this option
+a C like syntax. If no \s-1STABS\s0 debugging was found this option
falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
the file.
.IP "\fB\-e\fR" 4
@@ -342,6 +342,11 @@ sections as if they were instructions.
Note if the \fB\-\-dwarf=follow\-links\fR option has also been enabled
then any symbol tables in linked debug info files will be read in and
used when disassembling.
+.IP "\fB\-\-no\-addresses\fR" 4
+.IX Item "--no-addresses"
+When disassembling, don't print addresses on each line or for symbols
+and relocation offsets. In combination with \fB\-\-no\-show\-raw\-insn\fR
+this may be useful for comparing compiler output.
.IP "\fB\-\-prefix\-addresses\fR" 4
.IX Item "--prefix-addresses"
When disassembling, print the complete address on each line. This is
@@ -512,8 +517,7 @@ option or whether instruction notes should be generated as comments in the
disasssembly using \fB\-M notes\fR.
.Sp
For the x86, some of the options duplicate functions of the \fB\-m\fR
-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.
.RS 4
.ie n .IP """x86\-64""" 4
.el .IP "\f(CWx86\-64\fR" 4
@@ -579,8 +583,10 @@ appear later in the option string.
.ie n .IP """suffix""" 4
.el .IP "\f(CWsuffix\fR" 4
.IX Item "suffix"
-When in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic
-suffix even when the suffix could be inferred by the operands.
+When in \s-1AT&T\s0 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 or, for certain instructions, the
+execution mode's defaults.
.RE
.RS 4
.Sp
@@ -597,10 +603,10 @@ rather than \f(CW\*(C`li\*(C'\fR. All of the \fB\-m\fR arguments for
\&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR,
\&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR,
\&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR,
-\&\fBpower8\fR, \fBpower9\fR, \fBppc\fR, \fBppc32\fR,
-\&\fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR, \fBpwr\fR,
-\&\fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
-\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR,
+\&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBppc\fR,
+\&\fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR,
+\&\fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
+\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, \fBpwr10\fR,
\&\fBpwrx\fR, \fBtitan\fR, and \fBvle\fR.
\&\fB32\fR and \fB64\fR modify the default or a prior \s-1CPU\s0
selection, disabling and enabling 64\-bit insns respectively. In
@@ -815,11 +821,22 @@ This is the default when \fB\-\-prefix\-addresses\fR is used.
.IX Item "--insn-width=width"
Display \fIwidth\fR bytes on a single line when disassembling
instructions.
-.IP "\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-W[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR" 4
+.IX Item "--visualize-jumps[=color|=extended-color|=off]"
+Visualize jumps that stay inside a function by drawing \s-1ASCII\s0 art between
+the start and target addresses. The optional \fB=color\fR argument
+adds color to the output using simple terminal colors. Alternatively
+the \fB=extended\-color\fR argument will add color using 8bit
+colors, but these might not work on all terminals.
+.Sp
+If it is necessary to disable the \fBvisualize-jumps\fR option
+after it has previously been enabled then use
+\&\fBvisualize\-jumps=off\fR.
+.IP "\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR" 4
+.IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -963,6 +980,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -1074,8 +1100,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-G\fR" 4
.IX Item "-G"
.PD 0
@@ -1289,7 +1316,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-ranlib.1 b/share/man/man1/aarch64-linux-gnu-ranlib.1
index 8623176..2770eae 100644
--- a/share/man/man1/aarch64-linux-gnu-ranlib.1
+++ b/share/man/man1/aarch64-linux-gnu-ranlib.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "RANLIB 1"
-.TH RANLIB 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH RANLIB 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -217,7 +217,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBnm\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-readelf.1 b/share/man/man1/aarch64-linux-gnu-readelf.1
index 50c95fa..cd38f61 100644
--- a/share/man/man1/aarch64-linux-gnu-readelf.1
+++ b/share/man/man1/aarch64-linux-gnu-readelf.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "READELF 1"
-.TH READELF 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH READELF 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -158,13 +158,14 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-V\fR|\fB\-\-version\-info\fR]
[\fB\-A\fR|\fB\-\-arch\-specific\fR]
[\fB\-D\fR|\fB\-\-use\-dynamic\fR]
+ [\fB\-L\fR|\fB\-\-lint\fR|\fB\-\-enable\-checks\fR]
[\fB\-x\fR <number or name>|\fB\-\-hex\-dump=\fR<number or name>]
[\fB\-p\fR <number or name>|\fB\-\-string\-dump=\fR<number or name>]
[\fB\-R\fR <number or name>|\fB\-\-relocated\-dump=\fR<number or name>]
[\fB\-z\fR|\fB\-\-decompress\fR]
[\fB\-c\fR|\fB\-\-archive\-index\fR]
- [\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-debug\-dump\fR[=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]]
+ [\fB\-w[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-debug\-dump\fR[=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]]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf=\fR\fIsection\fR]
@@ -174,6 +175,7 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-I\fR|\fB\-\-histogram\fR]
[\fB\-v\fR|\fB\-\-version\fR]
[\fB\-W\fR|\fB\-\-wide\fR]
+ [\fB\-T\fR|\fB\-\-silent\-truncation\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIelffile\fR...
.SH "DESCRIPTION"
@@ -341,6 +343,19 @@ symbol table sections.
.Sp
When displaying relocations, this option makes \fBreadelf\fR
display the dynamic relocations rather than the static relocations.
+.IP "\fB\-L\fR" 4
+.IX Item "-L"
+.PD 0
+.IP "\fB\-\-lint\fR" 4
+.IX Item "--lint"
+.IP "\fB\-\-enable\-checks\fR" 4
+.IX Item "--enable-checks"
+.PD
+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.
.IP "\fB\-x <number or name>\fR" 4
.IX Item "-x <number or name>"
.PD 0
@@ -388,11 +403,11 @@ section(s) are not compressed then they are displayed as is.
Displays the file symbol index information contained in the header part
of binary archives. Performs the same function as the \fBt\fR
command to \fBar\fR, but without using the \s-1BFD\s0 library.
-.IP "\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-w[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-w[lLiaprmfFsOoRtUuTgAckK]\fR" 4
+.IX Item "-w[lLiaprmfFsOoRtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -536,6 +551,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -644,8 +668,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-\-ctf\-symbols=\fR\fIsection\fR" 4
.IX Item "--ctf-symbols=section"
.PD 0
@@ -653,7 +678,8 @@ types.
.IX Item "--ctf-strings=section"
.PD
Specify the name of another section from which the \s-1CTF\s0 file can inherit
-strings and symbols.
+strings and symbols. By default, the \f(CW\*(C`.symtab\*(C'\fR and its linked
+string table are used.
.Sp
If either of \fB\-\-ctf\-symbols\fR or \fB\-\-ctf\-strings\fR is specified, the
other must be specified as well.
@@ -683,6 +709,18 @@ Don't break output lines to fit into 80 columns. By default
64\-bit \s-1ELF\s0 files, so that they fit into 80 columns. This option causes
\&\fBreadelf\fR to print each section header resp. each segment one a
single line, which is far more readable on terminals wider than 80 columns.
+.IP "\fB\-T\fR" 4
+.IX Item "-T"
+.PD 0
+.IP "\fB\-\-silent\-truncation\fR" 4
+.IX Item "--silent-truncation"
+.PD
+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 \f(CW\*(C`[...]\*(C'\fR 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).
.IP "\fB\-H\fR" 4
.IX Item "-H"
.PD 0
@@ -708,7 +746,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-size.1 b/share/man/man1/aarch64-linux-gnu-size.1
index 4dd5230..7421ee1 100644
--- a/share/man/man1/aarch64-linux-gnu-size.1
+++ b/share/man/man1/aarch64-linux-gnu-size.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "SIZE 1"
-.TH SIZE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH SIZE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -287,7 +287,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-strings.1 b/share/man/man1/aarch64-linux-gnu-strings.1
index d8a1961..7903164 100644
--- a/share/man/man1/aarch64-linux-gnu-strings.1
+++ b/share/man/man1/aarch64-linux-gnu-strings.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRINGS 1"
-.TH STRINGS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRINGS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -161,7 +161,7 @@ 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.
.PP
@@ -305,7 +305,7 @@ with a backslash. The \fIfile\fR may itself contain additional
and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-strip.1 b/share/man/man1/aarch64-linux-gnu-strip.1
index d554f85..42abc91 100644
--- a/share/man/man1/aarch64-linux-gnu-strip.1
+++ b/share/man/man1/aarch64-linux-gnu-strip.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRIP 1"
-.TH STRIP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRIP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -154,6 +154,7 @@ strip [\fB\-F\fR \fIbfdname\fR |\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-w\fR|\fB\-\-wildcard\fR]
[\fB\-x\fR|\fB\-\-discard\-all\fR] [\fB\-X\fR |\fB\-\-discard\-locals\fR]
[\fB\-R\fR \fIsectionname\fR |\fB\-\-remove\-section=\fR\fIsectionname\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-o\fR \fIfile\fR] [\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -226,6 +227,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove relocations from the output file for any section matching
@@ -487,7 +492,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-windmc.1 b/share/man/man1/aarch64-linux-gnu-windmc.1
index 7cb9850..0c6a5d6 100644
--- a/share/man/man1/aarch64-linux-gnu-windmc.1
+++ b/share/man/man1/aarch64-linux-gnu-windmc.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDMC 1"
-.TH WINDMC 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDMC 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -350,7 +350,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/aarch64-linux-gnu-windres.1 b/share/man/man1/aarch64-linux-gnu-windres.1
index 2253ab3..00650cc 100644
--- a/share/man/man1/aarch64-linux-gnu-windres.1
+++ b/share/man/man1/aarch64-linux-gnu-windres.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDRES 1"
-.TH WINDRES 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDRES 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -358,7 +358,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/addr2line.1 b/share/man/man1/addr2line.1
index a0d4beb..975e4d0 100644
--- a/share/man/man1/addr2line.1
+++ b/share/man/man1/addr2line.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ADDR2LINE 1"
-.TH ADDR2LINE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ADDR2LINE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -339,7 +339,7 @@ with a backslash. The \fIfile\fR may itself contain additional
Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/ar.1 b/share/man/man1/ar.1
index 9409643..48a8086 100644
--- a/share/man/man1/ar.1
+++ b/share/man/man1/ar.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AR 1"
-.TH AR 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AR 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -142,7 +142,7 @@
ar \- create, modify, and extract from archives
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
+ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fB\-\-output\fR \fIdirname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \s-1GNU\s0 \fBar\fR program creates, modifies, and extracts from
@@ -310,7 +310,12 @@ use the \fBv\fR modifier with this operation, to request that
If you do not specify a \fImember\fR, all files in the archive
are extracted.
.Sp
-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 \fBP\fR: The
+paths must not be absolute, may not contain \f(CW\*(C`..\*(C'\fR, and any
+subdirectories in the paths must exist. If it is desired to avoid
+these restrictions then used the \fB\-\-output\fR option to specify
+an output directory.
.PP
A number of modifiers (\fImod\fR) may immediately follow the \fIp\fR
keyletter, to specify variations on an operation's behavior:
@@ -376,12 +381,22 @@ Display member offsets inside the archive. Use together with the \fBt\fR
option.
.IP "\fBP\fR" 4
.IX Item "P"
-Use the full path name when matching names in the archive. \s-1GNU\s0
-\&\fBar\fR can not create an archive with a full path name (such archives
-are not \s-1POSIX\s0 compliant), but other archive creators can. This option
-will cause \s-1GNU\s0 \fBar\fR 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 \s-1POSIX\s0 compliant, and
+thus may not work with tools other than up to date \s-1GNU\s0 tools.
+Modifying such archives with \s-1GNU\s0 \fBar\fR without using
+\&\fBP\fR will remove the full path names unless the archive is a
+thin archive. Note that \fBP\fR may be useful when adding files to
+a thin archive since \fBr\fR without \fBP\fR ignores the path
+when choosing which element to replace. Thus
+.Sp
+.Vb 1
+\& ar rcST archive.a subdir/file1 subdir/file2 file1
+.Ve
+.Sp
+will result in the first \f(CW\*(C`subdir/file1\*(C'\fR being replaced with
+\&\f(CW\*(C`file1\*(C'\fR from the current directory. Adding \fBP\fR will
+prevent this replacement.
.IP "\fBs\fR" 4
.IX Item "s"
Write an object-file index into the archive, or update an existing one,
@@ -438,7 +453,7 @@ and then exits.
Displays the version information of \fBar\fR and then exits.
.IP "\fB\-X32_64\fR" 4
.IX Item "-X32_64"
-\&\fBar\fR ignores an initial option spelt \fB\-X32_64\fR, for
+\&\fBar\fR ignores an initial option spelled \fB\-X32_64\fR, for
compatibility with \s-1AIX.\s0 The behaviour produced by this option is the
default for \s-1GNU\s0 \fBar\fR. \fBar\fR does not support any
of the other \fB\-X\fR options; in particular, it does not support
@@ -471,6 +486,15 @@ sufficient to just copy the newest one.
The optional command-line switch \fB\-\-target\fR \fIbfdname\fR
specifies that the archive members are in an object code format
different from your system's default format. See
+.IP "\fB\-\-output\fR \fIdirname\fR" 4
+.IX Item "--output dirname"
+The \fB\-\-output\fR 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.
+.Sp
+Note \- although the presence of this option does imply a \fBx\fR
+extraction operation that option must still be included on the command
+line.
.IP "\fB@\fR\fIfile\fR" 4
.IX Item "@file"
Read command-line options from \fIfile\fR. The options read are
@@ -489,7 +513,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-addr2line.1 b/share/man/man1/arm-linux-gnueabi-addr2line.1
index a0d4beb..975e4d0 100644
--- a/share/man/man1/arm-linux-gnueabi-addr2line.1
+++ b/share/man/man1/arm-linux-gnueabi-addr2line.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ADDR2LINE 1"
-.TH ADDR2LINE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ADDR2LINE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -339,7 +339,7 @@ with a backslash. The \fIfile\fR may itself contain additional
Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-ar.1 b/share/man/man1/arm-linux-gnueabi-ar.1
index 9409643..48a8086 100644
--- a/share/man/man1/arm-linux-gnueabi-ar.1
+++ b/share/man/man1/arm-linux-gnueabi-ar.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AR 1"
-.TH AR 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AR 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -142,7 +142,7 @@
ar \- create, modify, and extract from archives
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
+ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fB\-\-output\fR \fIdirname\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \s-1GNU\s0 \fBar\fR program creates, modifies, and extracts from
@@ -310,7 +310,12 @@ use the \fBv\fR modifier with this operation, to request that
If you do not specify a \fImember\fR, all files in the archive
are extracted.
.Sp
-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 \fBP\fR: The
+paths must not be absolute, may not contain \f(CW\*(C`..\*(C'\fR, and any
+subdirectories in the paths must exist. If it is desired to avoid
+these restrictions then used the \fB\-\-output\fR option to specify
+an output directory.
.PP
A number of modifiers (\fImod\fR) may immediately follow the \fIp\fR
keyletter, to specify variations on an operation's behavior:
@@ -376,12 +381,22 @@ Display member offsets inside the archive. Use together with the \fBt\fR
option.
.IP "\fBP\fR" 4
.IX Item "P"
-Use the full path name when matching names in the archive. \s-1GNU\s0
-\&\fBar\fR can not create an archive with a full path name (such archives
-are not \s-1POSIX\s0 compliant), but other archive creators can. This option
-will cause \s-1GNU\s0 \fBar\fR 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 \s-1POSIX\s0 compliant, and
+thus may not work with tools other than up to date \s-1GNU\s0 tools.
+Modifying such archives with \s-1GNU\s0 \fBar\fR without using
+\&\fBP\fR will remove the full path names unless the archive is a
+thin archive. Note that \fBP\fR may be useful when adding files to
+a thin archive since \fBr\fR without \fBP\fR ignores the path
+when choosing which element to replace. Thus
+.Sp
+.Vb 1
+\& ar rcST archive.a subdir/file1 subdir/file2 file1
+.Ve
+.Sp
+will result in the first \f(CW\*(C`subdir/file1\*(C'\fR being replaced with
+\&\f(CW\*(C`file1\*(C'\fR from the current directory. Adding \fBP\fR will
+prevent this replacement.
.IP "\fBs\fR" 4
.IX Item "s"
Write an object-file index into the archive, or update an existing one,
@@ -438,7 +453,7 @@ and then exits.
Displays the version information of \fBar\fR and then exits.
.IP "\fB\-X32_64\fR" 4
.IX Item "-X32_64"
-\&\fBar\fR ignores an initial option spelt \fB\-X32_64\fR, for
+\&\fBar\fR ignores an initial option spelled \fB\-X32_64\fR, for
compatibility with \s-1AIX.\s0 The behaviour produced by this option is the
default for \s-1GNU\s0 \fBar\fR. \fBar\fR does not support any
of the other \fB\-X\fR options; in particular, it does not support
@@ -471,6 +486,15 @@ sufficient to just copy the newest one.
The optional command-line switch \fB\-\-target\fR \fIbfdname\fR
specifies that the archive members are in an object code format
different from your system's default format. See
+.IP "\fB\-\-output\fR \fIdirname\fR" 4
+.IX Item "--output dirname"
+The \fB\-\-output\fR 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.
+.Sp
+Note \- although the presence of this option does imply a \fBx\fR
+extraction operation that option must still be included on the command
+line.
.IP "\fB@\fR\fIfile\fR" 4
.IX Item "@file"
Read command-line options from \fIfile\fR. The options read are
@@ -489,7 +513,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-as.1 b/share/man/man1/arm-linux-gnueabi-as.1
index 9d8fb44..7413481 100644
--- a/share/man/man1/arm-linux-gnueabi-as.1
+++ b/share/man/man1/arm-linux-gnueabi-as.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AS 1"
-.TH AS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -146,7 +146,8 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-compress\-debug\-sections\fR] [\fB\-\-nocompress\-debug\-sections\fR]
[\fB\-\-debug\-prefix\-map\fR \fIold\fR=\fInew\fR]
[\fB\-\-defsym\fR \fIsym\fR=\fIval\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-\-gstabs\fR]
- [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-2\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-<N>\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gdwarf\-cie\-version\fR=\fI\s-1VERSION\s0\fR]
[\fB\-\-help\fR] [\fB\-I\fR \fIdir\fR] [\fB\-J\fR]
[\fB\-K\fR] [\fB\-L\fR] [\fB\-\-listing\-lhs\-width\fR=\fI\s-1NUM\s0\fR]
[\fB\-\-listing\-lhs\-width2\fR=\fI\s-1NUM\s0\fR] [\fB\-\-listing\-rhs\-width\fR=\fI\s-1NUM\s0\fR]
@@ -442,15 +443,15 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-[no\-]transform\fR]
[\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR]
[\fB\-\-[no\-]trampolines\fR]
+ [\fB\-\-abi\-windowed\fR|\fB\-\-abi\-call0\fR]
.PP
\&\fITarget Z80 options:\fR
- [\fB\-z80\fR] [\fB\-r800\fR]
- [ \fB\-ignore\-undocumented\-instructions\fR] [\fB\-Wnud\fR]
- [ \fB\-ignore\-unportable\-instructions\fR] [\fB\-Wnup\fR]
- [ \fB\-warn\-undocumented\-instructions\fR] [\fB\-Wud\fR]
- [ \fB\-warn\-unportable\-instructions\fR] [\fB\-Wup\fR]
- [ \fB\-forbid\-undocumented\-instructions\fR] [\fB\-Fud\fR]
- [ \fB\-forbid\-unportable\-instructions\fR] [\fB\-Fup\fR]
+ [\fB\-march=\fR\fI\s-1CPU\s0\fR\fI[\-EXT]\fR\fI[+EXT]\fR]
+ [\fB\-local\-prefix=\fR\fI\s-1PREFIX\s0\fR]
+ [\fB\-colonless\fR]
+ [\fB\-sdcc\fR]
+ [\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR]
+ [\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1GNU\s0 \fBas\fR is really a family of assemblers.
@@ -628,7 +629,9 @@ compiler output).
.PD
Generate debugging information for each assembler source line using whichever
debug format is preferred by the target. This currently means either \s-1STABS,
-ECOFF\s0 or \s-1DWARF2.\s0
+ECOFF\s0 or \s-1DWARF2.\s0 When the debug format is \s-1DWARF\s0 then a \f(CW\*(C`.debug_info\*(C'\fR and
+\&\f(CW\*(C`.debug_line\*(C'\fR section is only emitted when the assembly file doesn't
+generate one itself.
.IP "\fB\-\-gstabs\fR" 4
.IX Item "--gstabs"
Generate stabs debugging information for each assembler line. This
@@ -645,6 +648,27 @@ the location of the current working directory at assembling time.
Generate \s-1DWARF2\s0 debugging information for each assembler line. This
may help debugging assembler code, if the debugger can handle it. Note\-\-\-this
option is only supported by some targets, not all of them.
+.IP "\fB\-\-gdwarf\-3\fR" 4
+.IX Item "--gdwarf-3"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 3 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-4\fR" 4
+.IX Item "--gdwarf-4"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 4 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-5\fR" 4
+.IX Item "--gdwarf-5"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 5 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
.IP "\fB\-\-gdwarf\-sections\fR" 4
.IX Item "--gdwarf-sections"
Instead of creating a .debug_line section, create a series of
@@ -654,6 +678,11 @@ will have its dwarf line number information placed into a section called
\&\fI.debug_line.text.func\fR. If the code section is just called \fI.text\fR
then debug line section will still be called just \fI.debug_line\fR without any
suffix.
+.IP "\fB\-\-gdwarf\-cie\-version=\fR\fIversion\fR" 4
+.IX Item "--gdwarf-cie-version=version"
+Control which version of \s-1DWARF\s0 Common Information Entries (CIEs) are produced.
+When this flag is not specificed the default is version 1, though some targets
+can modify this default. Other possible values for \fIversion\fR are 3 or 4.
.IP "\fB\-\-size\-check=error\fR" 4
.IX Item "--size-check=error"
.PD 0
@@ -853,7 +882,7 @@ issue an error message if an attempt is made to assemble an
instruction which will not execute on the target architecture. The
following architecture names are recognized: \f(CW\*(C`armv8\-a\*(C'\fR,
\&\f(CW\*(C`armv8.1\-a\*(C'\fR, \f(CW\*(C`armv8.2\-a\*(C'\fR, \f(CW\*(C`armv8.3\-a\*(C'\fR, \f(CW\*(C`armv8.4\-a\*(C'\fR
-and \f(CW\*(C`armv8.5\-a\*(C'\fR.
+\&\f(CW\*(C`armv8.5\-a\*(C'\fR, and \f(CW\*(C`armv8.6\-a\*(C'\fR.
.Sp
If both \fB\-mcpu\fR and \fB\-march\fR are specified, the
assembler will use the setting for \fB\-mcpu\fR. If neither are
@@ -1349,6 +1378,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`sse\*(C'\fR,
\&\f(CW\*(C`sse2\*(C'\fR,
\&\f(CW\*(C`sse3\*(C'\fR,
+\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`ssse3\*(C'\fR,
\&\f(CW\*(C`sse4.1\*(C'\fR,
\&\f(CW\*(C`sse4.2\*(C'\fR,
@@ -1356,6 +1386,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`nosse\*(C'\fR,
\&\f(CW\*(C`nosse2\*(C'\fR,
\&\f(CW\*(C`nosse3\*(C'\fR,
+\&\f(CW\*(C`nosse4a\*(C'\fR,
\&\f(CW\*(C`nossse3\*(C'\fR,
\&\f(CW\*(C`nosse4.1\*(C'\fR,
\&\f(CW\*(C`nosse4.2\*(C'\fR,
@@ -1383,6 +1414,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movdiri\*(C'\fR,
\&\f(CW\*(C`movdir64b\*(C'\fR,
\&\f(CW\*(C`enqcmd\*(C'\fR,
+\&\f(CW\*(C`serialize\*(C'\fR,
+\&\f(CW\*(C`tsxldtrk\*(C'\fR,
\&\f(CW\*(C`avx512f\*(C'\fR,
\&\f(CW\*(C`avx512cd\*(C'\fR,
\&\f(CW\*(C`avx512er\*(C'\fR,
@@ -1398,6 +1431,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`avx512_vbmi2\*(C'\fR,
\&\f(CW\*(C`avx512_vnni\*(C'\fR,
\&\f(CW\*(C`avx512_bitalg\*(C'\fR,
+\&\f(CW\*(C`avx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`avx512_bf16\*(C'\fR,
\&\f(CW\*(C`noavx512f\*(C'\fR,
\&\f(CW\*(C`noavx512cd\*(C'\fR,
@@ -1417,6 +1451,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`noavx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`noavx512_bf16\*(C'\fR,
\&\f(CW\*(C`noenqcmd\*(C'\fR,
+\&\f(CW\*(C`noserialize\*(C'\fR,
+\&\f(CW\*(C`notsxldtrk\*(C'\fR,
\&\f(CW\*(C`vmx\*(C'\fR,
\&\f(CW\*(C`vmfunc\*(C'\fR,
\&\f(CW\*(C`smx\*(C'\fR,
@@ -1434,6 +1470,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movbe\*(C'\fR,
\&\f(CW\*(C`ept\*(C'\fR,
\&\f(CW\*(C`lzcnt\*(C'\fR,
+\&\f(CW\*(C`popcnt\*(C'\fR,
\&\f(CW\*(C`hle\*(C'\fR,
\&\f(CW\*(C`rtm\*(C'\fR,
\&\f(CW\*(C`invpcid\*(C'\fR,
@@ -1444,6 +1481,9 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`pconfig\*(C'\fR,
\&\f(CW\*(C`waitpkg\*(C'\fR,
\&\f(CW\*(C`cldemote\*(C'\fR,
+\&\f(CW\*(C`rdpru\*(C'\fR,
+\&\f(CW\*(C`mcommit\*(C'\fR,
+\&\f(CW\*(C`sev_es\*(C'\fR,
\&\f(CW\*(C`lwp\*(C'\fR,
\&\f(CW\*(C`fma4\*(C'\fR,
\&\f(CW\*(C`xop\*(C'\fR,
@@ -1454,8 +1494,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`3dnowa\*(C'\fR,
\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`sse5\*(C'\fR,
-\&\f(CW\*(C`svme\*(C'\fR,
-\&\f(CW\*(C`abm\*(C'\fR and
+\&\f(CW\*(C`svme\*(C'\fR and
\&\f(CW\*(C`padlock\*(C'\fR.
Note that rather than extending a basic instruction set, the extension
mnemonics starting with \f(CW\*(C`no\*(C'\fR revoke the respective functionality.
@@ -1579,7 +1618,7 @@ slightly bigger. This option only affects the handling of branch
instructions.
.IP "\fB\-mbig\-obj\fR" 4
.IX Item "-mbig-obj"
-On x86\-64 \s-1PE/COFF\s0 target this option forces the use of big object file
+On \s-1PE/COFF\s0 target this option forces the use of big object file
format, which allows more than 32768 sections.
.IP "\fB\-momit\-lock\-prefix=\fR\fIno\fR" 4
.IX Item "-momit-lock-prefix=no"
@@ -1620,6 +1659,90 @@ R_X86_64_REX_GOTPCRELX, in 64\-bit mode.
\&\fB\-mrelax\-relocations=\fR\fIno\fR will not generate relax
relocations. The default can be controlled by a configure option
\&\fB\-\-enable\-x86\-relax\-relocations\fR.
+.IP "\fB\-malign\-branch\-boundary=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-boundary=NUM"
+This option controls how the assembler should align branches with segment
+prefixes or \s-1NOP.\s0 \fI\s-1NUM\s0\fR must be a power of 2. It should be 0 or
+no less than 16. Branches will be aligned within \fI\s-1NUM\s0\fR byte
+boundary. \fB\-malign\-branch\-boundary=0\fR, which is the default,
+doesn't align branches.
+.IP "\fB\-malign\-branch=\fR\fI\s-1TYPE\s0\fR\fB[+\fR\fI\s-1TYPE\s0\fR\fB...]\fR" 4
+.IX Item "-malign-branch=TYPE[+TYPE...]"
+This option specifies types of branches to align. \fI\s-1TYPE\s0\fR is
+combination of \fBjcc\fR, which aligns conditional jumps,
+\&\fBfused\fR, which aligns fused conditional jumps, \fBjmp\fR,
+which aligns unconditional jumps, \fBcall\fR which aligns calls,
+\&\fBret\fR, which aligns rets, \fBindirect\fR, which aligns indirect
+jumps and calls. The default is \fB\-malign\-branch=jcc+fused+jmp\fR.
+.IP "\fB\-malign\-branch\-prefix\-size=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-prefix-size=NUM"
+This option specifies the maximum number of prefixes on an instruction
+to align branches. \fI\s-1NUM\s0\fR should be between 0 and 5. The default
+\&\fI\s-1NUM\s0\fR is 5.
+.IP "\fB\-mbranches\-within\-32B\-boundaries\fR" 4
+.IX Item "-mbranches-within-32B-boundaries"
+This option aligns conditional jumps, fused conditional jumps and
+unconditional jumps within 32 byte boundary with up to 5 segment prefixes
+on an instruction. It is equivalent to
+\&\fB\-malign\-branch\-boundary=32\fR
+\&\fB\-malign\-branch=jcc+fused+jmp\fR
+\&\fB\-malign\-branch\-prefix\-size=5\fR.
+The default doesn't align branches.
+.IP "\fB\-mlfence\-after\-load=\fR\fIno\fR" 4
+.IX Item "-mlfence-after-load=no"
+.PD 0
+.IP "\fB\-mlfence\-after\-load=\fR\fIyes\fR" 4
+.IX Item "-mlfence-after-load=yes"
+.PD
+These options control whether the assembler should generate lfence
+after load instructions. \fB\-mlfence\-after\-load=\fR\fIyes\fR will
+generate lfence. \fB\-mlfence\-after\-load=\fR\fIno\fR will not generate
+lfence, which is the default.
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-indirect-branch=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR" 4
+.IX Item "-mlfence-before-indirect-branch=all"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR" 4
+.IX Item "-mlfence-before-indirect-branch=register"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR" 4
+.IX Item "-mlfence-before-indirect-branch=memory"
+.PD
+These options control whether the assembler should generate lfence
+before indirect near branch instructions.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR will generate lfence
+before indirect near branch via register and issue a warning before
+indirect near branch via memory.
+It also implicitly sets \fB\-mlfence\-before\-ret=\fR\fIshl\fR when
+there's no explict \fB\-mlfence\-before\-ret=\fR.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR will generate
+lfence before indirect near branch via register.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR will issue a
+warning before indirect near branch via memory.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR will not generate
+lfence nor issue warning, which is the default. Note that lfence won't
+be generated before indirect near branch via register with
+\&\fB\-mlfence\-after\-load=\fR\fIyes\fR since lfence will be generated
+after loading branch target register.
+.IP "\fB\-mlfence\-before\-ret=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-ret=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-ret=\fR\fIshl\fR" 4
+.IX Item "-mlfence-before-ret=shl"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIor\fR" 4
+.IX Item "-mlfence-before-ret=or"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIyes\fR" 4
+.IX Item "-mlfence-before-ret=yes"
+.IP "\fB\-mlfence\-before\-ret=\fR\fInot\fR" 4
+.IX Item "-mlfence-before-ret=not"
+.PD
+These options control whether the assembler should generate lfence
+before ret. \fB\-mlfence\-before\-ret=\fR\fIor\fR will generate
+generate or instruction with lfence.
+\&\fB\-mlfence\-before\-ret=\fR\fIshl/yes\fR will generate shl instruction
+with lfence. \fB\-mlfence\-before\-ret=\fR\fInot\fR will generate not
+instruction with lfence. \fB\-mlfence\-before\-ret=\fR\fInone\fR will not
+generate lfence, which is the default.
.IP "\fB\-mx86\-used\-note=\fR\fIno\fR" 4
.IX Item "-mx86-used-note=no"
.PD 0
@@ -1653,7 +1776,8 @@ with 01, 10 and 11 \s-1RC\s0 bits, respectively.
.IX Item "-mintel64"
.PD
This option specifies that the assembler should accept only \s-1AMD64\s0 or
-Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept both.
+Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept common, Intel64
+only and \s-1AMD64\s0 ISAs.
.IP "\fB\-O0 | \-O | \-O1 | \-O2 | \-Os\fR" 4
.IX Item "-O0 | -O | -O1 | -O2 | -Os"
Optimize instruction encoding with smaller instruction size. \fB\-O\fR
@@ -2455,6 +2579,9 @@ Generate code for Power8 architecture.
.IP "\fB\-mpower9, \-mpwr9\fR" 4
.IX Item "-mpower9, -mpwr9"
Generate code for Power9 architecture.
+.IP "\fB\-mpower10, \-mpwr10\fR" 4
+.IX Item "-mpower10, -mpwr10"
+Generate code for Power10 architecture.
.IP "\fB\-mcell\fR" 4
.IX Item "-mcell"
.PD 0
@@ -2515,6 +2642,20 @@ Don't generate position-independent code (default)
.IP "\fB\-march=ISA\fR" 4
.IX Item "-march=ISA"
Select the base isa, as specified by \s-1ISA.\s0 For example \-march=rv32ima.
+If this option and the architecture attributes aren't set, then assembler
+will check the default configure setting \-\-with\-arch=ISA.
+.IP "\fB\-misa\-spec=ISAspec\fR" 4
+.IX Item "-misa-spec=ISAspec"
+Select the default isa spec version. If the version of \s-1ISA\s0 isn't set
+by \-march, then assembler helps to set the version according to
+the default chosen spec. If this option isn't set, then assembler will
+check the default configure setting \-\-with\-isa\-spec=ISAspec.
+.IP "\fB\-mpriv\-spec=PRIVspec\fR" 4
+.IX Item "-mpriv-spec=PRIVspec"
+Select the privileged spec version. We can decide whether the \s-1CSR\s0 is valid or
+not according to the chosen spec. If this option and the privilege attributes
+aren't set, then assembler will check the default configure setting
+\&\-\-with\-priv\-spec=PRIVspec.
.IP "\fB\-mabi=ABI\fR" 4
.IX Item "-mabi=ABI"
Selects the \s-1ABI,\s0 which is either \*(L"ilp32\*(R" or \*(L"lp64\*(R", optionally followed
@@ -2529,6 +2670,26 @@ required to materialize symbol addresses. (default)
.IP "\fB\-mno\-relax\fR" 4
.IX Item "-mno-relax"
Don't do linker relaxations.
+.IP "\fB\-march\-attr\fR" 4
+.IX Item "-march-attr"
+Generate the default contents for the riscv elf attribute section if the
+\&.attribute directives are not set. This section is used to record the
+information that a linker or runtime loader needs to check compatibility.
+This information includes \s-1ISA\s0 string, stack alignment requirement, unaligned
+memory accesses, and the major, minor and revision version of privileged
+specification.
+.IP "\fB\-mno\-arch\-attr\fR" 4
+.IX Item "-mno-arch-attr"
+Don't generate the default riscv elf attribute section if the .attribute
+directives are not set.
+.IP "\fB\-mcsr\-check\fR" 4
+.IX Item "-mcsr-check"
+Enable the \s-1CSR\s0 checking for the ISA-dependent \s-1CRS\s0 and the read-only \s-1CSR.\s0
+The ISA-dependent \s-1CSR\s0 are only valid when the specific \s-1ISA\s0 is set. The
+read-only \s-1CSR\s0 can not be written by the \s-1CSR\s0 instructions.
+.IP "\fB\-mno\-csr\-check\fR" 4
+.IX Item "-mno-csr-check"
+Don't do \s-1CSR\s0 cheching.
.PP
See the info pages for documentation of the RX-specific options.
.PP
@@ -2555,7 +2716,8 @@ Specify which s390 processor variant is the target, \fBg5\fR (or
\&\fBarch3\fR), \fBg6\fR, \fBz900\fR (or \fBarch5\fR), \fBz990\fR (or
\&\fBarch6\fR), \fBz9\-109\fR, \fBz9\-ec\fR (or \fBarch7\fR), \fBz10\fR (or
\&\fBarch8\fR), \fBz196\fR (or \fBarch9\fR), \fBzEC12\fR (or \fBarch10\fR),
-\&\fBz13\fR (or \fBarch11\fR), or \fBz14\fR (or \fBarch12\fR).
+\&\fBz13\fR (or \fBarch11\fR), \fBz14\fR (or \fBarch12\fR), or \fBz15\fR
+(or \fBarch13\fR).
.IP "\fB\-mregnames\fR" 4
.IX Item "-mregnames"
.PD 0
@@ -2723,63 +2885,72 @@ across a greater range of addresses. This option should be used when jump tar
potentially be out of range. In the absence of such jumps this option
does not affect code size or performance. The default is
\&\fB\-\-trampolines\fR.
+.IP "\fB\-\-abi\-windowed | \-\-abi\-call0\fR" 4
+.IX Item "--abi-windowed | --abi-call0"
+Choose \s-1ABI\s0 tag written to the \f(CW\*(C`.xtensa.info\*(C'\fR section. \s-1ABI\s0 tag
+indicates \s-1ABI\s0 of the assembly code. A warning is issued by the linker
+on an attempt to link object files with inconsistent \s-1ABI\s0 tags.
+Default \s-1ABI\s0 is chosen by the Xtensa core configuration.
.PP
-The following options are available when as is configured for
-a Z80 family processor.
-.IP "\fB\-z80\fR" 4
-.IX Item "-z80"
-Assemble for Z80 processor.
-.IP "\fB\-r800\fR" 4
-.IX Item "-r800"
-Assemble for R800 processor.
-.IP "\fB\-ignore\-undocumented\-instructions\fR" 4
-.IX Item "-ignore-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wnud\fR" 4
-.IX Item "-Wnud"
-.PD
-Assemble undocumented Z80 instructions that also work on R800 without warning.
-.IP "\fB\-ignore\-unportable\-instructions\fR" 4
-.IX Item "-ignore-unportable-instructions"
-.PD 0
-.IP "\fB\-Wnup\fR" 4
-.IX Item "-Wnup"
-.PD
-Assemble all undocumented Z80 instructions without warning.
-.IP "\fB\-warn\-undocumented\-instructions\fR" 4
-.IX Item "-warn-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wud\fR" 4
-.IX Item "-Wud"
-.PD
-Issue a warning for undocumented Z80 instructions that also work on R800.
-.IP "\fB\-warn\-unportable\-instructions\fR" 4
-.IX Item "-warn-unportable-instructions"
-.PD 0
-.IP "\fB\-Wup\fR" 4
-.IX Item "-Wup"
-.PD
-Issue a warning for undocumented Z80 instructions that do not work on R800.
-.IP "\fB\-forbid\-undocumented\-instructions\fR" 4
-.IX Item "-forbid-undocumented-instructions"
-.PD 0
-.IP "\fB\-Fud\fR" 4
-.IX Item "-Fud"
-.PD
-Treat all undocumented instructions as errors.
-.IP "\fB\-forbid\-unportable\-instructions\fR" 4
-.IX Item "-forbid-unportable-instructions"
-.PD 0
-.IP "\fB\-Fup\fR" 4
-.IX Item "-Fup"
-.PD
-Treat undocumented Z80 instructions that do not work on R800 as errors.
+The following options are available when as is configured for an
+Z80 processor.
+.PP
+\&\f(CW@chapter\fR Z80 Dependent Features
+.SS "Command-line Options"
+.IX Subsection "Command-line Options"
+.IP "\fB\-march=\fR\fI\s-1CPU\s0\fR\fB[\-\fR\fI\s-1EXT\s0\fR\fB...][+\fR\fI\s-1EXT\s0\fR\fB...]\fR" 4
+.IX Item "-march=CPU[-EXT...][+EXT...]"
+This option specifies the target processor. The assembler will issue
+an error message if an attempt is made to assemble an instruction which
+will not execute on the target processor. The following processor names
+are recognized:
+\&\f(CW\*(C`z80\*(C'\fR,
+\&\f(CW\*(C`z180\*(C'\fR,
+\&\f(CW\*(C`ez80\*(C'\fR,
+\&\f(CW\*(C`gbz80\*(C'\fR,
+\&\f(CW\*(C`z80n\*(C'\fR,
+\&\f(CW\*(C`r800\*(C'\fR.
+In addition to the basic instruction set, the assembler can be told to
+accept some extention mnemonics. For example,
+\&\f(CW\*(C`\-march=z180+sli+infc\*(C'\fR extends \fIz180\fR with \fI\s-1SLI\s0\fR instructions and
+\&\fI\s-1IN F,\s0(C)\fR. The following extentions are currently supported:
+\&\f(CW\*(C`full\*(C'\fR (all known instructions),
+\&\f(CW\*(C`adl\*(C'\fR (\s-1ADL CPU\s0 mode by default, eZ80 only),
+\&\f(CW\*(C`sli\*(C'\fR (instruction known as \fI\s-1SLI\s0\fR, \fI\s-1SLL\s0\fR or \fI\s-1SL1\s0\fR),
+\&\f(CW\*(C`xyhl\*(C'\fR (instructions with halves of index registers: \fI\s-1IXL\s0\fR, \fI\s-1IXH\s0\fR,
+\&\fI\s-1IYL\s0\fR, \fI\s-1IYH\s0\fR),
+\&\f(CW\*(C`xdcb\*(C'\fR (instructions like \fIRotOp (II+d),R\fR and \fIBitOp n,(II+d),R\fR),
+\&\f(CW\*(C`infc\*(C'\fR (instruction \fI\s-1IN F,\s0(C)\fR or \fI\s-1IN\s0 (C)\fR),
+\&\f(CW\*(C`outc0\*(C'\fR (instruction \fI\s-1OUT\s0 (C),0\fR).
+Note that rather than extending a basic instruction set, the extention
+mnemonics starting with \f(CW\*(C`\-\*(C'\fR revoke the respective functionality:
+\&\f(CW\*(C`\-march=z80\-full+xyhl\*(C'\fR first removes all default extentions and adds
+support for index registers halves only.
+.Sp
+If this option is not specified then \f(CW\*(C`\-march=z80+xyhl+infc\*(C'\fR is assumed.
+.IP "\fB\-local\-prefix=\fR\fIprefix\fR" 4
+.IX Item "-local-prefix=prefix"
+Mark all labels with specified prefix as local. But such label can be
+marked global explicitly in the code. This option do not change default
+local label prefix \f(CW\*(C`.L\*(C'\fR, it is just adds new one.
+.IP "\fB\-colonless\fR" 4
+.IX Item "-colonless"
+Accept colonless labels. All symbols at line begin are treated as labels.
+.IP "\fB\-sdcc\fR" 4
+.IX Item "-sdcc"
+Accept assembler code produced by \s-1SDCC.\s0
+.IP "\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-s=FORMAT"
+Single precision floating point numbers format. Default: ieee754 (32 bit).
+.IP "\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-d=FORMAT"
+Double precision floating point numbers format. Default: ieee754 (64 bit).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBgcc\fR\|(1), \fBld\fR\|(1), and the Info entries for \fIbinutils\fR and \fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-c++filt.1 b/share/man/man1/arm-linux-gnueabi-c++filt.1
index 1939a69..00e65a7 100644
--- a/share/man/man1/arm-linux-gnueabi-c++filt.1
+++ b/share/man/man1/arm-linux-gnueabi-c++filt.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "C++FILT 1"
-.TH C++FILT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH C++FILT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -366,7 +366,7 @@ MS-DOS this program is named \fB\s-1CXXFILT\s0\fR.
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-dlltool.1 b/share/man/man1/arm-linux-gnueabi-dlltool.1
index a3eae27..986c76c 100644
--- a/share/man/man1/arm-linux-gnueabi-dlltool.1
+++ b/share/man/man1/arm-linux-gnueabi-dlltool.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "DLLTOOL 1"
-.TH DLLTOOL 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH DLLTOOL 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -532,7 +532,7 @@ with a backslash. The \fIfile\fR may itself contain additional
The Info pages for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-elfedit.1 b/share/man/man1/arm-linux-gnueabi-elfedit.1
index db0efe9..c583e22 100644
--- a/share/man/man1/arm-linux-gnueabi-elfedit.1
+++ b/share/man/man1/arm-linux-gnueabi-elfedit.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ELFEDIT 1"
-.TH ELFEDIT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ELFEDIT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -250,7 +250,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-gprof.1 b/share/man/man1/arm-linux-gnueabi-gprof.1
index 1b892b0..6f081c6 100644
--- a/share/man/man1/arm-linux-gnueabi-gprof.1
+++ b/share/man/man1/arm-linux-gnueabi-gprof.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "GPROF 1"
-.TH GPROF 1 "2019-10-12" "binutils-2.33.1" "GNU"
+.TH GPROF 1 "2020-09-19" "binutils-2.35.1" "GNU"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -762,7 +762,7 @@ Proceedings of the \s-1SIGPLAN\s0 '82 Symposium on Compiler Construction,
\&\s-1SIGPLAN\s0 Notices, Vol. 17, No 6, pp. 120\-126, June 1982.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1988\-2019 Free Software Foundation, Inc.
+Copyright (c) 1988\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-ld.1 b/share/man/man1/arm-linux-gnueabi-ld.1
index 9e77e89..ef33aa2 100644
--- a/share/man/man1/arm-linux-gnueabi-ld.1
+++ b/share/man/man1/arm-linux-gnueabi-ld.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "LD 1"
-.TH LD 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH LD 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -362,6 +362,46 @@ specified in the library. If specified multiple times \f(CW\*(C`DT_DEPAUDIT\*(C
will contain a colon separated list of audit interfaces to use. This
option is only meaningful on \s-1ELF\s0 platforms supporting the rtld-audit interface.
The \-P option is provided for Solaris compatibility.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\fR" 4
+.IX Item "--enable-non-contiguous-regions"
+This option avoids generating an error if an input section does not
+fit a matching output section. The linker tries to allocate the input
+section to subseque nt matching output sections, and generates an
+error only if no output section is large enough. This is useful when
+several non-contiguous memory regions are available and the input
+section does not require a particular one. The order in which input
+sections are evaluated does not change, for instance:
+.Sp
+.Vb 10
+\& MEMORY {
+\& MEM1 (rwx) : ORIGIN : 0x1000, LENGTH = 0x14
+\& MEM2 (rwx) : ORIGIN : 0x1000, LENGTH = 0x40
+\& MEM3 (rwx) : ORIGIN : 0x2000, LENGTH = 0x40
+\& }
+\& SECTIONS {
+\& mem1 : { *(.data.*); } > MEM1
+\& mem2 : { *(.data.*); } > MEM2
+\& mem3 : { *(.data.*); } > MEM2
+\& }
+\&
+\& with input sections:
+\& .data.1: size 8
+\& .data.2: size 0x10
+\& .data.3: size 4
+\&
+\& results in .data.1 affected to mem1, and .data.2 and .data.3
+\& affected to mem2, even though .data.3 would fit in mem3.
+.Ve
+.Sp
+This option is incompatible with \s-1INSERT\s0 statements because it changes
+the way input sections are mapped to output sections.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\-warnings\fR" 4
+.IX Item "--enable-non-contiguous-regions-warnings"
+This option enables warnings when
+\&\f(CW\*(C`\-\-enable\-non\-contiguous\-regions\*(C'\fR allows possibly unexpected
+matches in sections mapping, potentially leading to silently
+discarding a section instead of failing because it does not fit any
+output region.
.IP "\fB\-e\fR \fIentry\fR" 4
.IX Item "-e entry"
.PD 0
@@ -426,6 +466,20 @@ See the description of \fB\-\-dynamic\-list\fR.
Note that this option is specific to \s-1ELF\s0 targeted ports. \s-1PE\s0 targets
support a similar function to export all symbols from a \s-1DLL\s0 or \s-1EXE\s0; see
the description of \fB\-\-export\-all\-symbols\fR below.
+.IP "\fB\-\-export\-dynamic\-symbol=\fR\fIglob\fR" 4
+.IX Item "--export-dynamic-symbol=glob"
+When creating a dynamically linked executable, symbols matching
+\&\fIglob\fR will be added to the dynamic symbol table. When creating a
+shared library, references to symbols matching \fIglob\fR will not be
+bound to the definitions within the shared library. This option is a
+no-op when creating a shared library and \fB\-Bsymbolic\fR or
+\&\fB\-\-dynamic\-list\fR are not specified. This option is only meaningful
+on \s-1ELF\s0 platforms which support shared libraries.
+.IP "\fB\-\-export\-dynamic\-symbol\-list=\fR\fIfile\fR" 4
+.IX Item "--export-dynamic-symbol-list=file"
+Specify a \fB\-\-export\-dynamic\-symbol\fR for each pattern in the file.
+The format of the file is the same as the version node without
+scope and node name. See \fB\s-1VERSION\s0\fR for more information.
.IP "\fB\-EB\fR" 4
.IX Item "-EB"
Link big-endian objects. This affects the default output format.
@@ -708,6 +762,17 @@ shared libraries. Use \fB\-Bdynamic\fR for this.
Use \fIoutput\fR as the name for the program produced by \fBld\fR; if this
option is not specified, the name \fIa.out\fR is used by default. The
script command \f(CW\*(C`OUTPUT\*(C'\fR can also specify the output file name.
+.IP "\fB\-\-dependency\-file=\fR\fIdepfile\fR" 4
+.IX Item "--dependency-file=depfile"
+Write a \fIdependency file\fR to \fIdepfile\fR. This file contains a rule
+suitable for \f(CW\*(C`make\*(C'\fR describing the output file and all the input files
+that were read to produce it. The output is similar to the compiler's
+output with \fB\-M \-MP\fR. Note that there is no option like the compiler's \fB\-MM\fR,
+to exclude \*(L"system files\*(R" (which is not a well-specified concept in the
+linker, unlike \*(L"system headers\*(R" in the compiler). So the output from
+\&\fB\-\-dependency\-file\fR is always specific to the exact state of the
+installation where it was produced, and should not be copied into
+distributed makefiles without careful editing.
.IP "\fB\-O\fR \fIlevel\fR" 4
.IX Item "-O level"
If \fIlevel\fR is a numeric values greater than zero \fBld\fR optimizes
@@ -1197,6 +1262,16 @@ Linux/i386 and Linux/x86_64.
Specify a stack size for an \s-1ELF\s0 \f(CW\*(C`PT_GNU_STACK\*(C'\fR segment.
Specifying zero will override any default non-zero sized
\&\f(CW\*(C`PT_GNU_STACK\*(C'\fR segment creation.
+.IP "\fBstart\-stop\-visibility=\fR\fIvalue\fR" 4
+.IX Item "start-stop-visibility=value"
+Specify the \s-1ELF\s0 symbol visibility for synthesized
+\&\f(CW\*(C`_\|_start_SECNAME\*(C'\fR and \f(CW\*(C`_\|_stop_SECNAME\*(C'\fR symbols. \fIvalue\fR must be exactly \fBdefault\fR,
+\&\fBinternal\fR, \fBhidden\fR, or \fBprotected\fR. If no \fB\-z
+start-stop-visibility\fR option is given, \fBprotected\fR is used for
+compatibility with historical practice. However, it's highly
+recommended to use \fB\-z start\-stop\-visibility=hidden\fR in new
+programs and shared libraries so that these symbols are not exported
+between shared objects, which is not usually what's intended.
.IP "\fBtext\fR" 4
.IX Item "text"
.PD 0
@@ -1205,9 +1280,9 @@ Specifying zero will override any default non-zero sized
.IP "\fBtextoff\fR" 4
.IX Item "textoff"
.PD
-Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the binary has dynamic
-relocations in read-only sections. Don't report an error if
-\&\fBnotext\fR or \fBtextoff\fR.
+Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the position-independent
+or shared object has dynamic relocations in read-only sections. Don't
+report an error if \fBnotext\fR or \fBtextoff\fR.
.IP "\fBundefs\fR" 4
.IX Item "undefs"
Do not report unresolved symbol references from regular object files,
@@ -1330,20 +1405,14 @@ libraries.
When creating a shared library, bind references to global symbols to the
definition within the shared library, if any. Normally, it is possible
for a program linked against a shared library to override the definition
-within the shared library. This option can also be used with the
-\&\fB\-\-export\-dynamic\fR option, when creating a position independent
-executable, to bind references to global symbols to the definition within
-the executable. This option is only meaningful on \s-1ELF\s0 platforms which
-support shared libraries and position independent executables.
+within the shared library. This option is only meaningful on \s-1ELF\s0
+platforms which support shared libraries.
.IP "\fB\-Bsymbolic\-functions\fR" 4
.IX Item "-Bsymbolic-functions"
When creating a shared library, bind references to global function
symbols to the definition within the shared library, if any.
-This option can also be used with the \fB\-\-export\-dynamic\fR option,
-when creating a position independent executable, to bind references
-to global function symbols to the definition within the executable.
This option is only meaningful on \s-1ELF\s0 platforms which support shared
-libraries and position independent executables.
+libraries.
.IP "\fB\-\-dynamic\-list=\fR\fIdynamic-list-file\fR" 4
.IX Item "--dynamic-list=dynamic-list-file"
Specify the name of a dynamic list file to the linker. This is
@@ -1589,7 +1658,10 @@ Print a summary of all target-specific options on the standard output and exit.
.IP "\fB\-Map=\fR\fImapfile\fR" 4
.IX Item "-Map=mapfile"
Print a link map to the file \fImapfile\fR. See the description of the
-\&\fB\-M\fR option, above.
+\&\fB\-M\fR option, above. Specifying a directory as \fImapfile\fR
+causes the linker map to be written into a file inside the directory.
+The name of the file is based upon the \fIoutput\fR filename with
+\&\f(CW\*(C`.map\*(C'\fR appended.
.IP "\fB\-\-no\-keep\-memory\fR" 4
.IX Item "--no-keep-memory"
\&\fBld\fR normally optimizes for speed over memory usage by caching the
@@ -1863,8 +1935,18 @@ libraries needed by it. The \f(CW\*(C`DT_RPATH\*(C'\fR entries are ignored if
.IP "7." 4
The default directories, normally \fI/lib\fR and \fI/usr/lib\fR.
.IP "8." 4
-For a native linker on an \s-1ELF\s0 system, if the file \fI/etc/ld.so.conf\fR
-exists, the list of directories found in that file.
+For a linker for a Linux system, if the file \fI/etc/ld.so.conf\fR
+exists, the list of directories found in that file. Note: the path
+to this file is prefixed with the \f(CW\*(C`sysroot\*(C'\fR value, if that is
+defined, and then any \f(CW\*(C`prefix\*(C'\fR string if the linker was
+configured with the \fB\-\-prefix=<path>\fR option.
+.IP "9." 4
+For a native linker on a FreeBSD system, any directories specified by
+the \f(CW\*(C`_PATH_ELF_HINTS\*(C'\fR macro defined in the \fIelf\-hints.h\fR
+header file.
+.IP "10." 4
+Any directories specifed by a \f(CW\*(C`SEARCH_DIR\*(C'\fR command in the
+linker script being used.
.RE
.RS 4
.Sp
@@ -2148,9 +2230,10 @@ alignment. Typically, the alignment will be set by an input section.
The address will only be changed if it not explicitly specified; that
is, if the \f(CW\*(C`SECTIONS\*(C'\fR command does not specify a start address for
the section.
-.IP "\fB\-\-warn\-shared\-textrel\fR" 4
-.IX Item "--warn-shared-textrel"
-Warn if the linker adds a \s-1DT_TEXTREL\s0 to a shared object.
+.IP "\fB\-\-warn\-textrel\fR" 4
+.IX Item "--warn-textrel"
+Warn if the linker adds \s-1DT_TEXTREL\s0 to a position-independent executable
+or shared object.
.IP "\fB\-\-warn\-alternate\-em\fR" 4
.IX Item "--warn-alternate-em"
Warn if an object has alternate \s-1ELF\s0 machine code.
@@ -2758,11 +2841,14 @@ of the \s-1PE\s0 file header:
.IX Item "--high-entropy-va"
Image is compatible with 64\-bit address space layout randomization
(\s-1ASLR\s0).
+This option also implies \fB\-\-dynamicbase\fR and
+\&\fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-dynamicbase\fR" 4
.IX Item "--dynamicbase"
The image base address may be relocated using address space layout
randomization (\s-1ASLR\s0). This feature was introduced with \s-1MS\s0 Windows
Vista for i386 \s-1PE\s0 targets.
+This option also implies \fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-forceinteg\fR" 4
.IX Item "--forceinteg"
Code integrity checks are enforced.
@@ -2800,6 +2886,10 @@ same sources are linked. The option \fB\-\-no\-insert\-timestamp\fR
can be used to insert a zero value for the timestamp, this ensuring
that binaries produced from identical sources will compare
identically.
+.IP "\fB\-\-enable\-reloc\-section\fR" 4
+.IX Item "--enable-reloc-section"
+Create the base relocation table, which is necessary if the image
+is loaded at a different image base than specified in the \s-1PE\s0 header.
.PP
The C6X uClinux target uses a binary format called \s-1DSBT\s0 to support shared
libraries. Each shared library in the system needs to have a unique index;
@@ -2891,11 +2981,63 @@ an error.
.IP "\fB\-\-compact\-branches\fR" 4
.IX Item "--compact-branches"
.PD 0
-.IP "\fB\-\-compact\-branches\fR" 4
-.IX Item "--compact-branches"
+.IP "\fB\-\-no\-compact\-branches\fR" 4
+.IX Item "--no-compact-branches"
.PD
These options control the generation of compact instructions by the linker
in the \s-1PLT\s0 entries for \s-1MIPS R6.\s0
+.PP
+For the pdp11\-aout target, three variants of the output format can be
+produced as selected by the following options. The default variant
+for pdp11\-aout is the \fB\-\-omagic\fR option, whereas for other
+targets \fB\-\-nmagic\fR is the default. The \fB\-\-imagic\fR option is
+defined only for the pdp11\-aout target, while the others are described
+here as they apply to the pdp11\-aout target.
+.IP "\fB\-N\fR" 4
+.IX Item "-N"
+.PD 0
+.IP "\fB\-\-omagic\fR" 4
+.IX Item "--omagic"
+.PD
+Mark the output as \f(CW\*(C`OMAGIC\*(C'\fR (0407) in the \fIa.out\fR header to
+indicate that the text segment is not to be write-protected and
+shared. Since the text and data sections are both readable and
+writable, the data section is allocated immediately contiguous after
+the text segment. This is the oldest format for \s-1PDP11\s0 executable
+programs and is the default for \fBld\fR on \s-1PDP11\s0 Unix systems
+from the beginning through 2.11BSD.
+.IP "\fB\-n\fR" 4
+.IX Item "-n"
+.PD 0
+.IP "\fB\-\-nmagic\fR" 4
+.IX Item "--nmagic"
+.PD
+Mark the output as \f(CW\*(C`NMAGIC\*(C'\fR (0410) in the \fIa.out\fR header to
+indicate that when the output file is executed, the text portion will
+be read-only and shareable among all processes executing the same
+file. This involves moving the data areas up to the first possible 8K
+byte page boundary following the end of the text. This option creates
+a \fIpure executable\fR format.
+.IP "\fB\-z\fR" 4
+.IX Item "-z"
+.PD 0
+.IP "\fB\-\-imagic\fR" 4
+.IX Item "--imagic"
+.PD
+Mark the output as \f(CW\*(C`IMAGIC\*(C'\fR (0411) in the \fIa.out\fR header to
+indicate that when the output file is executed, the program text and
+data areas will be loaded into separate address spaces using the split
+instruction and data space feature of the memory management unit in
+larger models of the \s-1PDP11.\s0 This doubles the address space available
+to the program. The text segment is again pure, write-protected, and
+shareable. The only difference in the output format between this
+option and the others, besides the magic number, is that both the text
+and data sections start at location 0. The \fB\-z\fR option selected
+this format in 2.11BSD. This option creates a \fIseparate
+executable\fR format.
+.IP "\fB\-\-no\-omagic\fR" 4
+.IX Item "--no-omagic"
+Equivalent to \fB\-\-nmagic\fR for pdp11\-aout.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
You can change the behaviour of \fBld\fR with the environment variables
@@ -2935,7 +3077,7 @@ the Info entries for \fIbinutils\fR and
\&\fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-nm.1 b/share/man/man1/arm-linux-gnueabi-nm.1
index 6811de2..e37a0a1 100644
--- a/share/man/man1/arm-linux-gnueabi-nm.1
+++ b/share/man/man1/arm-linux-gnueabi-nm.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "NM 1"
-.TH NM 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH NM 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -592,7 +592,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-objcopy.1 b/share/man/man1/arm-linux-gnueabi-objcopy.1
index 974655e..09814c0 100644
--- a/share/man/man1/arm-linux-gnueabi-objcopy.1
+++ b/share/man/man1/arm-linux-gnueabi-objcopy.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJCOPY 1"
-.TH OBJCOPY 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJCOPY 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -166,6 +166,7 @@ objcopy [\fB\-F\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-\-interleave\-width=\fR\fIwidth\fR]
[\fB\-j\fR \fIsectionpattern\fR|\fB\-\-only\-section=\fR\fIsectionpattern\fR]
[\fB\-R\fR \fIsectionpattern\fR|\fB\-\-remove\-section=\fR\fIsectionpattern\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -363,6 +364,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove non-dynamic relocations from the output file for any section
@@ -600,16 +605,18 @@ done by increasing the size of the last section. The extra space is
filled in with the value specified by \fB\-\-gap\-fill\fR (default zero).
.IP "\fB\-\-set\-start\fR \fIval\fR" 4
.IX Item "--set-start val"
-Set the start address of the new file to \fIval\fR. 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 \fIval\fR. Not all object file formats support setting the
+start address.
.IP "\fB\-\-change\-start\fR \fIincr\fR" 4
.IX Item "--change-start incr"
.PD 0
.IP "\fB\-\-adjust\-start\fR \fIincr\fR" 4
.IX Item "--adjust-start incr"
.PD
-Change the start address by adding \fIincr\fR. Not all object file
-formats support setting the start address.
+Change the start address (also known as the entry address) by adding
+\&\fIincr\fR. Not all object file formats support setting the start
+address.
.IP "\fB\-\-change\-addresses\fR \fIincr\fR" 4
.IX Item "--change-addresses incr"
.PD 0
@@ -686,11 +693,13 @@ Set the flags for any sections matching \fIsectionpattern\fR. The
\&\fIflags\fR argument is a comma separated string of flag names. The
recognized names are \fBalloc\fR, \fBcontents\fR, \fBload\fR,
\&\fBnoload\fR, \fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR,
-\&\fBshare\fR, and \fBdebug\fR. You can set the \fBcontents\fR flag
-for a section which does not have contents, but it is not meaningful
-to clear the \fBcontents\fR flag of a section which does have
-contents\*(--just remove the section instead. Not all flags are
-meaningful for all object file formats.
+\&\fBexclude\fR, \fBshare\fR, and \fBdebug\fR. You can set the
+\&\fBcontents\fR flag for a section which does not have contents, but it
+is not meaningful to clear the \fBcontents\fR 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
+\&\fBshare\fR flag is only meaningful for \s-1COFF\s0 format files and not for
+\&\s-1ELF\s0 format files.
.IP "\fB\-\-set\-section\-alignment\fR \fIsectionpattern\fR\fB=\fR\fIalign\fR" 4
.IX Item "--set-section-alignment sectionpattern=align"
Set the alignment for any sections matching \fIsectionpattern\fR.
@@ -746,7 +755,8 @@ Rename a section from \fIoldname\fR to \fInewname\fR, optionally
changing the section's flags to \fIflags\fR 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.
+executable. This option accepts the same set of flags as the
+\&\fB\-\-sect\-section\-flags\fR option.
.Sp
This option is particularly helpful when the input format is binary,
since this will always create a section called .data. If for example,
@@ -1218,7 +1228,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBld\fR\|(1), \fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-objdump.1 b/share/man/man1/arm-linux-gnueabi-objdump.1
index 65acc7b..c2209fb 100644
--- a/share/man/man1/arm-linux-gnueabi-objdump.1
+++ b/share/man/man1/arm-linux-gnueabi-objdump.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJDUMP 1"
-.TH OBJDUMP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJDUMP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -167,8 +167,8 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-r\fR|\fB\-\-reloc\fR]
[\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
[\fB\-s\fR|\fB\-\-full\-contents\fR]
- [\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-dwarf\fR[=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]]
+ [\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-dwarf\fR[=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]]
[\fB\-\-ctf=\fR\fIsection\fR]
[\fB\-G\fR|\fB\-\-stabs\fR]
[\fB\-t\fR|\fB\-\-syms\fR]
@@ -177,19 +177,19 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-w\fR|\fB\-\-wide\fR]
[\fB\-\-start\-address=\fR\fIaddress\fR]
[\fB\-\-stop\-address=\fR\fIaddress\fR]
+ [\fB\-\-no\-addresses\fR]
[\fB\-\-prefix\-addresses\fR]
[\fB\-\-[no\-]show\-raw\-insn\fR]
[\fB\-\-adjust\-vma=\fR\fIoffset\fR]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf\-parent=\fR\fIsection\fR]
- [\fB\-\-ctf\-symbols=\fR\fIsection\fR]
- [\fB\-\-ctf\-strings=\fR\fIsection\fR]
[\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]
[\fB\-\-special\-syms\fR]
[\fB\-\-prefix=\fR\fIprefix\fR]
[\fB\-\-prefix\-strip=\fR\fIlevel\fR]
[\fB\-\-insn\-width=\fR\fIwidth\fR]
+ [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR
[\fB\-V\fR|\fB\-\-version\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIobjfile\fR...
@@ -286,7 +286,7 @@ possible and any bug reports about such an event will be rejected.
.PD
Display debugging information. This attempts to parse \s-1STABS\s0
debugging format information stored in the file and print it out using
-a C like syntax. If no \s-1STABS\s0 debuging was found this option
+a C like syntax. If no \s-1STABS\s0 debugging was found this option
falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
the file.
.IP "\fB\-e\fR" 4
@@ -342,6 +342,11 @@ sections as if they were instructions.
Note if the \fB\-\-dwarf=follow\-links\fR option has also been enabled
then any symbol tables in linked debug info files will be read in and
used when disassembling.
+.IP "\fB\-\-no\-addresses\fR" 4
+.IX Item "--no-addresses"
+When disassembling, don't print addresses on each line or for symbols
+and relocation offsets. In combination with \fB\-\-no\-show\-raw\-insn\fR
+this may be useful for comparing compiler output.
.IP "\fB\-\-prefix\-addresses\fR" 4
.IX Item "--prefix-addresses"
When disassembling, print the complete address on each line. This is
@@ -512,8 +517,7 @@ option or whether instruction notes should be generated as comments in the
disasssembly using \fB\-M notes\fR.
.Sp
For the x86, some of the options duplicate functions of the \fB\-m\fR
-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.
.RS 4
.ie n .IP """x86\-64""" 4
.el .IP "\f(CWx86\-64\fR" 4
@@ -579,8 +583,10 @@ appear later in the option string.
.ie n .IP """suffix""" 4
.el .IP "\f(CWsuffix\fR" 4
.IX Item "suffix"
-When in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic
-suffix even when the suffix could be inferred by the operands.
+When in \s-1AT&T\s0 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 or, for certain instructions, the
+execution mode's defaults.
.RE
.RS 4
.Sp
@@ -597,10 +603,10 @@ rather than \f(CW\*(C`li\*(C'\fR. All of the \fB\-m\fR arguments for
\&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR,
\&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR,
\&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR,
-\&\fBpower8\fR, \fBpower9\fR, \fBppc\fR, \fBppc32\fR,
-\&\fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR, \fBpwr\fR,
-\&\fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
-\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR,
+\&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBppc\fR,
+\&\fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR,
+\&\fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
+\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, \fBpwr10\fR,
\&\fBpwrx\fR, \fBtitan\fR, and \fBvle\fR.
\&\fB32\fR and \fB64\fR modify the default or a prior \s-1CPU\s0
selection, disabling and enabling 64\-bit insns respectively. In
@@ -815,11 +821,22 @@ This is the default when \fB\-\-prefix\-addresses\fR is used.
.IX Item "--insn-width=width"
Display \fIwidth\fR bytes on a single line when disassembling
instructions.
-.IP "\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-W[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR" 4
+.IX Item "--visualize-jumps[=color|=extended-color|=off]"
+Visualize jumps that stay inside a function by drawing \s-1ASCII\s0 art between
+the start and target addresses. The optional \fB=color\fR argument
+adds color to the output using simple terminal colors. Alternatively
+the \fB=extended\-color\fR argument will add color using 8bit
+colors, but these might not work on all terminals.
+.Sp
+If it is necessary to disable the \fBvisualize-jumps\fR option
+after it has previously been enabled then use
+\&\fBvisualize\-jumps=off\fR.
+.IP "\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR" 4
+.IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -963,6 +980,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -1074,8 +1100,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-G\fR" 4
.IX Item "-G"
.PD 0
@@ -1289,7 +1316,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-ranlib.1 b/share/man/man1/arm-linux-gnueabi-ranlib.1
index 8623176..2770eae 100644
--- a/share/man/man1/arm-linux-gnueabi-ranlib.1
+++ b/share/man/man1/arm-linux-gnueabi-ranlib.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "RANLIB 1"
-.TH RANLIB 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH RANLIB 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -217,7 +217,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBnm\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-readelf.1 b/share/man/man1/arm-linux-gnueabi-readelf.1
index 50c95fa..cd38f61 100644
--- a/share/man/man1/arm-linux-gnueabi-readelf.1
+++ b/share/man/man1/arm-linux-gnueabi-readelf.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "READELF 1"
-.TH READELF 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH READELF 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -158,13 +158,14 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-V\fR|\fB\-\-version\-info\fR]
[\fB\-A\fR|\fB\-\-arch\-specific\fR]
[\fB\-D\fR|\fB\-\-use\-dynamic\fR]
+ [\fB\-L\fR|\fB\-\-lint\fR|\fB\-\-enable\-checks\fR]
[\fB\-x\fR <number or name>|\fB\-\-hex\-dump=\fR<number or name>]
[\fB\-p\fR <number or name>|\fB\-\-string\-dump=\fR<number or name>]
[\fB\-R\fR <number or name>|\fB\-\-relocated\-dump=\fR<number or name>]
[\fB\-z\fR|\fB\-\-decompress\fR]
[\fB\-c\fR|\fB\-\-archive\-index\fR]
- [\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-debug\-dump\fR[=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]]
+ [\fB\-w[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-debug\-dump\fR[=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]]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf=\fR\fIsection\fR]
@@ -174,6 +175,7 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-I\fR|\fB\-\-histogram\fR]
[\fB\-v\fR|\fB\-\-version\fR]
[\fB\-W\fR|\fB\-\-wide\fR]
+ [\fB\-T\fR|\fB\-\-silent\-truncation\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIelffile\fR...
.SH "DESCRIPTION"
@@ -341,6 +343,19 @@ symbol table sections.
.Sp
When displaying relocations, this option makes \fBreadelf\fR
display the dynamic relocations rather than the static relocations.
+.IP "\fB\-L\fR" 4
+.IX Item "-L"
+.PD 0
+.IP "\fB\-\-lint\fR" 4
+.IX Item "--lint"
+.IP "\fB\-\-enable\-checks\fR" 4
+.IX Item "--enable-checks"
+.PD
+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.
.IP "\fB\-x <number or name>\fR" 4
.IX Item "-x <number or name>"
.PD 0
@@ -388,11 +403,11 @@ section(s) are not compressed then they are displayed as is.
Displays the file symbol index information contained in the header part
of binary archives. Performs the same function as the \fBt\fR
command to \fBar\fR, but without using the \s-1BFD\s0 library.
-.IP "\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-w[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-w[lLiaprmfFsOoRtUuTgAckK]\fR" 4
+.IX Item "-w[lLiaprmfFsOoRtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -536,6 +551,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -644,8 +668,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-\-ctf\-symbols=\fR\fIsection\fR" 4
.IX Item "--ctf-symbols=section"
.PD 0
@@ -653,7 +678,8 @@ types.
.IX Item "--ctf-strings=section"
.PD
Specify the name of another section from which the \s-1CTF\s0 file can inherit
-strings and symbols.
+strings and symbols. By default, the \f(CW\*(C`.symtab\*(C'\fR and its linked
+string table are used.
.Sp
If either of \fB\-\-ctf\-symbols\fR or \fB\-\-ctf\-strings\fR is specified, the
other must be specified as well.
@@ -683,6 +709,18 @@ Don't break output lines to fit into 80 columns. By default
64\-bit \s-1ELF\s0 files, so that they fit into 80 columns. This option causes
\&\fBreadelf\fR to print each section header resp. each segment one a
single line, which is far more readable on terminals wider than 80 columns.
+.IP "\fB\-T\fR" 4
+.IX Item "-T"
+.PD 0
+.IP "\fB\-\-silent\-truncation\fR" 4
+.IX Item "--silent-truncation"
+.PD
+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 \f(CW\*(C`[...]\*(C'\fR 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).
.IP "\fB\-H\fR" 4
.IX Item "-H"
.PD 0
@@ -708,7 +746,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-size.1 b/share/man/man1/arm-linux-gnueabi-size.1
index 4dd5230..7421ee1 100644
--- a/share/man/man1/arm-linux-gnueabi-size.1
+++ b/share/man/man1/arm-linux-gnueabi-size.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "SIZE 1"
-.TH SIZE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH SIZE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -287,7 +287,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-strings.1 b/share/man/man1/arm-linux-gnueabi-strings.1
index d8a1961..7903164 100644
--- a/share/man/man1/arm-linux-gnueabi-strings.1
+++ b/share/man/man1/arm-linux-gnueabi-strings.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRINGS 1"
-.TH STRINGS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRINGS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -161,7 +161,7 @@ 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.
.PP
@@ -305,7 +305,7 @@ with a backslash. The \fIfile\fR may itself contain additional
and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-strip.1 b/share/man/man1/arm-linux-gnueabi-strip.1
index d554f85..42abc91 100644
--- a/share/man/man1/arm-linux-gnueabi-strip.1
+++ b/share/man/man1/arm-linux-gnueabi-strip.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRIP 1"
-.TH STRIP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRIP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -154,6 +154,7 @@ strip [\fB\-F\fR \fIbfdname\fR |\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-w\fR|\fB\-\-wildcard\fR]
[\fB\-x\fR|\fB\-\-discard\-all\fR] [\fB\-X\fR |\fB\-\-discard\-locals\fR]
[\fB\-R\fR \fIsectionname\fR |\fB\-\-remove\-section=\fR\fIsectionname\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-o\fR \fIfile\fR] [\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -226,6 +227,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove relocations from the output file for any section matching
@@ -487,7 +492,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-windmc.1 b/share/man/man1/arm-linux-gnueabi-windmc.1
index 7cb9850..0c6a5d6 100644
--- a/share/man/man1/arm-linux-gnueabi-windmc.1
+++ b/share/man/man1/arm-linux-gnueabi-windmc.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDMC 1"
-.TH WINDMC 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDMC 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -350,7 +350,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/arm-linux-gnueabi-windres.1 b/share/man/man1/arm-linux-gnueabi-windres.1
index 2253ab3..00650cc 100644
--- a/share/man/man1/arm-linux-gnueabi-windres.1
+++ b/share/man/man1/arm-linux-gnueabi-windres.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDRES 1"
-.TH WINDRES 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDRES 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -358,7 +358,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/as.1 b/share/man/man1/as.1
index 9d8fb44..7413481 100644
--- a/share/man/man1/as.1
+++ b/share/man/man1/as.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AS 1"
-.TH AS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH AS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -146,7 +146,8 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-compress\-debug\-sections\fR] [\fB\-\-nocompress\-debug\-sections\fR]
[\fB\-\-debug\-prefix\-map\fR \fIold\fR=\fInew\fR]
[\fB\-\-defsym\fR \fIsym\fR=\fIval\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-\-gstabs\fR]
- [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-2\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gstabs+\fR] [\fB\-\-gdwarf\-<N>\fR] [\fB\-\-gdwarf\-sections\fR]
+ [\fB\-\-gdwarf\-cie\-version\fR=\fI\s-1VERSION\s0\fR]
[\fB\-\-help\fR] [\fB\-I\fR \fIdir\fR] [\fB\-J\fR]
[\fB\-K\fR] [\fB\-L\fR] [\fB\-\-listing\-lhs\-width\fR=\fI\s-1NUM\s0\fR]
[\fB\-\-listing\-lhs\-width2\fR=\fI\s-1NUM\s0\fR] [\fB\-\-listing\-rhs\-width\fR=\fI\s-1NUM\s0\fR]
@@ -442,15 +443,15 @@ as [\fB\-a\fR[\fBcdghlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-[no\-]transform\fR]
[\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR]
[\fB\-\-[no\-]trampolines\fR]
+ [\fB\-\-abi\-windowed\fR|\fB\-\-abi\-call0\fR]
.PP
\&\fITarget Z80 options:\fR
- [\fB\-z80\fR] [\fB\-r800\fR]
- [ \fB\-ignore\-undocumented\-instructions\fR] [\fB\-Wnud\fR]
- [ \fB\-ignore\-unportable\-instructions\fR] [\fB\-Wnup\fR]
- [ \fB\-warn\-undocumented\-instructions\fR] [\fB\-Wud\fR]
- [ \fB\-warn\-unportable\-instructions\fR] [\fB\-Wup\fR]
- [ \fB\-forbid\-undocumented\-instructions\fR] [\fB\-Fud\fR]
- [ \fB\-forbid\-unportable\-instructions\fR] [\fB\-Fup\fR]
+ [\fB\-march=\fR\fI\s-1CPU\s0\fR\fI[\-EXT]\fR\fI[+EXT]\fR]
+ [\fB\-local\-prefix=\fR\fI\s-1PREFIX\s0\fR]
+ [\fB\-colonless\fR]
+ [\fB\-sdcc\fR]
+ [\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR]
+ [\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1GNU\s0 \fBas\fR is really a family of assemblers.
@@ -628,7 +629,9 @@ compiler output).
.PD
Generate debugging information for each assembler source line using whichever
debug format is preferred by the target. This currently means either \s-1STABS,
-ECOFF\s0 or \s-1DWARF2.\s0
+ECOFF\s0 or \s-1DWARF2.\s0 When the debug format is \s-1DWARF\s0 then a \f(CW\*(C`.debug_info\*(C'\fR and
+\&\f(CW\*(C`.debug_line\*(C'\fR section is only emitted when the assembly file doesn't
+generate one itself.
.IP "\fB\-\-gstabs\fR" 4
.IX Item "--gstabs"
Generate stabs debugging information for each assembler line. This
@@ -645,6 +648,27 @@ the location of the current working directory at assembling time.
Generate \s-1DWARF2\s0 debugging information for each assembler line. This
may help debugging assembler code, if the debugger can handle it. Note\-\-\-this
option is only supported by some targets, not all of them.
+.IP "\fB\-\-gdwarf\-3\fR" 4
+.IX Item "--gdwarf-3"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 3 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-4\fR" 4
+.IX Item "--gdwarf-4"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 4 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
+.IP "\fB\-\-gdwarf\-5\fR" 4
+.IX Item "--gdwarf-5"
+This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
+allows for the possibility of the generation of extra debug information as per
+version 5 of the \s-1DWARF\s0 specification. Note \- enabling this option does not
+guarantee the generation of any extra infortmation, the choice to do so is on a
+per target basis.
.IP "\fB\-\-gdwarf\-sections\fR" 4
.IX Item "--gdwarf-sections"
Instead of creating a .debug_line section, create a series of
@@ -654,6 +678,11 @@ will have its dwarf line number information placed into a section called
\&\fI.debug_line.text.func\fR. If the code section is just called \fI.text\fR
then debug line section will still be called just \fI.debug_line\fR without any
suffix.
+.IP "\fB\-\-gdwarf\-cie\-version=\fR\fIversion\fR" 4
+.IX Item "--gdwarf-cie-version=version"
+Control which version of \s-1DWARF\s0 Common Information Entries (CIEs) are produced.
+When this flag is not specificed the default is version 1, though some targets
+can modify this default. Other possible values for \fIversion\fR are 3 or 4.
.IP "\fB\-\-size\-check=error\fR" 4
.IX Item "--size-check=error"
.PD 0
@@ -853,7 +882,7 @@ issue an error message if an attempt is made to assemble an
instruction which will not execute on the target architecture. The
following architecture names are recognized: \f(CW\*(C`armv8\-a\*(C'\fR,
\&\f(CW\*(C`armv8.1\-a\*(C'\fR, \f(CW\*(C`armv8.2\-a\*(C'\fR, \f(CW\*(C`armv8.3\-a\*(C'\fR, \f(CW\*(C`armv8.4\-a\*(C'\fR
-and \f(CW\*(C`armv8.5\-a\*(C'\fR.
+\&\f(CW\*(C`armv8.5\-a\*(C'\fR, and \f(CW\*(C`armv8.6\-a\*(C'\fR.
.Sp
If both \fB\-mcpu\fR and \fB\-march\fR are specified, the
assembler will use the setting for \fB\-mcpu\fR. If neither are
@@ -1349,6 +1378,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`sse\*(C'\fR,
\&\f(CW\*(C`sse2\*(C'\fR,
\&\f(CW\*(C`sse3\*(C'\fR,
+\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`ssse3\*(C'\fR,
\&\f(CW\*(C`sse4.1\*(C'\fR,
\&\f(CW\*(C`sse4.2\*(C'\fR,
@@ -1356,6 +1386,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`nosse\*(C'\fR,
\&\f(CW\*(C`nosse2\*(C'\fR,
\&\f(CW\*(C`nosse3\*(C'\fR,
+\&\f(CW\*(C`nosse4a\*(C'\fR,
\&\f(CW\*(C`nossse3\*(C'\fR,
\&\f(CW\*(C`nosse4.1\*(C'\fR,
\&\f(CW\*(C`nosse4.2\*(C'\fR,
@@ -1383,6 +1414,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movdiri\*(C'\fR,
\&\f(CW\*(C`movdir64b\*(C'\fR,
\&\f(CW\*(C`enqcmd\*(C'\fR,
+\&\f(CW\*(C`serialize\*(C'\fR,
+\&\f(CW\*(C`tsxldtrk\*(C'\fR,
\&\f(CW\*(C`avx512f\*(C'\fR,
\&\f(CW\*(C`avx512cd\*(C'\fR,
\&\f(CW\*(C`avx512er\*(C'\fR,
@@ -1398,6 +1431,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`avx512_vbmi2\*(C'\fR,
\&\f(CW\*(C`avx512_vnni\*(C'\fR,
\&\f(CW\*(C`avx512_bitalg\*(C'\fR,
+\&\f(CW\*(C`avx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`avx512_bf16\*(C'\fR,
\&\f(CW\*(C`noavx512f\*(C'\fR,
\&\f(CW\*(C`noavx512cd\*(C'\fR,
@@ -1417,6 +1451,8 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`noavx512_vp2intersect\*(C'\fR,
\&\f(CW\*(C`noavx512_bf16\*(C'\fR,
\&\f(CW\*(C`noenqcmd\*(C'\fR,
+\&\f(CW\*(C`noserialize\*(C'\fR,
+\&\f(CW\*(C`notsxldtrk\*(C'\fR,
\&\f(CW\*(C`vmx\*(C'\fR,
\&\f(CW\*(C`vmfunc\*(C'\fR,
\&\f(CW\*(C`smx\*(C'\fR,
@@ -1434,6 +1470,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`movbe\*(C'\fR,
\&\f(CW\*(C`ept\*(C'\fR,
\&\f(CW\*(C`lzcnt\*(C'\fR,
+\&\f(CW\*(C`popcnt\*(C'\fR,
\&\f(CW\*(C`hle\*(C'\fR,
\&\f(CW\*(C`rtm\*(C'\fR,
\&\f(CW\*(C`invpcid\*(C'\fR,
@@ -1444,6 +1481,9 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`pconfig\*(C'\fR,
\&\f(CW\*(C`waitpkg\*(C'\fR,
\&\f(CW\*(C`cldemote\*(C'\fR,
+\&\f(CW\*(C`rdpru\*(C'\fR,
+\&\f(CW\*(C`mcommit\*(C'\fR,
+\&\f(CW\*(C`sev_es\*(C'\fR,
\&\f(CW\*(C`lwp\*(C'\fR,
\&\f(CW\*(C`fma4\*(C'\fR,
\&\f(CW\*(C`xop\*(C'\fR,
@@ -1454,8 +1494,7 @@ accept various extension mnemonics. For example,
\&\f(CW\*(C`3dnowa\*(C'\fR,
\&\f(CW\*(C`sse4a\*(C'\fR,
\&\f(CW\*(C`sse5\*(C'\fR,
-\&\f(CW\*(C`svme\*(C'\fR,
-\&\f(CW\*(C`abm\*(C'\fR and
+\&\f(CW\*(C`svme\*(C'\fR and
\&\f(CW\*(C`padlock\*(C'\fR.
Note that rather than extending a basic instruction set, the extension
mnemonics starting with \f(CW\*(C`no\*(C'\fR revoke the respective functionality.
@@ -1579,7 +1618,7 @@ slightly bigger. This option only affects the handling of branch
instructions.
.IP "\fB\-mbig\-obj\fR" 4
.IX Item "-mbig-obj"
-On x86\-64 \s-1PE/COFF\s0 target this option forces the use of big object file
+On \s-1PE/COFF\s0 target this option forces the use of big object file
format, which allows more than 32768 sections.
.IP "\fB\-momit\-lock\-prefix=\fR\fIno\fR" 4
.IX Item "-momit-lock-prefix=no"
@@ -1620,6 +1659,90 @@ R_X86_64_REX_GOTPCRELX, in 64\-bit mode.
\&\fB\-mrelax\-relocations=\fR\fIno\fR will not generate relax
relocations. The default can be controlled by a configure option
\&\fB\-\-enable\-x86\-relax\-relocations\fR.
+.IP "\fB\-malign\-branch\-boundary=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-boundary=NUM"
+This option controls how the assembler should align branches with segment
+prefixes or \s-1NOP.\s0 \fI\s-1NUM\s0\fR must be a power of 2. It should be 0 or
+no less than 16. Branches will be aligned within \fI\s-1NUM\s0\fR byte
+boundary. \fB\-malign\-branch\-boundary=0\fR, which is the default,
+doesn't align branches.
+.IP "\fB\-malign\-branch=\fR\fI\s-1TYPE\s0\fR\fB[+\fR\fI\s-1TYPE\s0\fR\fB...]\fR" 4
+.IX Item "-malign-branch=TYPE[+TYPE...]"
+This option specifies types of branches to align. \fI\s-1TYPE\s0\fR is
+combination of \fBjcc\fR, which aligns conditional jumps,
+\&\fBfused\fR, which aligns fused conditional jumps, \fBjmp\fR,
+which aligns unconditional jumps, \fBcall\fR which aligns calls,
+\&\fBret\fR, which aligns rets, \fBindirect\fR, which aligns indirect
+jumps and calls. The default is \fB\-malign\-branch=jcc+fused+jmp\fR.
+.IP "\fB\-malign\-branch\-prefix\-size=\fR\fI\s-1NUM\s0\fR" 4
+.IX Item "-malign-branch-prefix-size=NUM"
+This option specifies the maximum number of prefixes on an instruction
+to align branches. \fI\s-1NUM\s0\fR should be between 0 and 5. The default
+\&\fI\s-1NUM\s0\fR is 5.
+.IP "\fB\-mbranches\-within\-32B\-boundaries\fR" 4
+.IX Item "-mbranches-within-32B-boundaries"
+This option aligns conditional jumps, fused conditional jumps and
+unconditional jumps within 32 byte boundary with up to 5 segment prefixes
+on an instruction. It is equivalent to
+\&\fB\-malign\-branch\-boundary=32\fR
+\&\fB\-malign\-branch=jcc+fused+jmp\fR
+\&\fB\-malign\-branch\-prefix\-size=5\fR.
+The default doesn't align branches.
+.IP "\fB\-mlfence\-after\-load=\fR\fIno\fR" 4
+.IX Item "-mlfence-after-load=no"
+.PD 0
+.IP "\fB\-mlfence\-after\-load=\fR\fIyes\fR" 4
+.IX Item "-mlfence-after-load=yes"
+.PD
+These options control whether the assembler should generate lfence
+after load instructions. \fB\-mlfence\-after\-load=\fR\fIyes\fR will
+generate lfence. \fB\-mlfence\-after\-load=\fR\fIno\fR will not generate
+lfence, which is the default.
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-indirect-branch=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR" 4
+.IX Item "-mlfence-before-indirect-branch=all"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR" 4
+.IX Item "-mlfence-before-indirect-branch=register"
+.IP "\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR" 4
+.IX Item "-mlfence-before-indirect-branch=memory"
+.PD
+These options control whether the assembler should generate lfence
+before indirect near branch instructions.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR will generate lfence
+before indirect near branch via register and issue a warning before
+indirect near branch via memory.
+It also implicitly sets \fB\-mlfence\-before\-ret=\fR\fIshl\fR when
+there's no explict \fB\-mlfence\-before\-ret=\fR.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR will generate
+lfence before indirect near branch via register.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR will issue a
+warning before indirect near branch via memory.
+\&\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR will not generate
+lfence nor issue warning, which is the default. Note that lfence won't
+be generated before indirect near branch via register with
+\&\fB\-mlfence\-after\-load=\fR\fIyes\fR since lfence will be generated
+after loading branch target register.
+.IP "\fB\-mlfence\-before\-ret=\fR\fInone\fR" 4
+.IX Item "-mlfence-before-ret=none"
+.PD 0
+.IP "\fB\-mlfence\-before\-ret=\fR\fIshl\fR" 4
+.IX Item "-mlfence-before-ret=shl"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIor\fR" 4
+.IX Item "-mlfence-before-ret=or"
+.IP "\fB\-mlfence\-before\-ret=\fR\fIyes\fR" 4
+.IX Item "-mlfence-before-ret=yes"
+.IP "\fB\-mlfence\-before\-ret=\fR\fInot\fR" 4
+.IX Item "-mlfence-before-ret=not"
+.PD
+These options control whether the assembler should generate lfence
+before ret. \fB\-mlfence\-before\-ret=\fR\fIor\fR will generate
+generate or instruction with lfence.
+\&\fB\-mlfence\-before\-ret=\fR\fIshl/yes\fR will generate shl instruction
+with lfence. \fB\-mlfence\-before\-ret=\fR\fInot\fR will generate not
+instruction with lfence. \fB\-mlfence\-before\-ret=\fR\fInone\fR will not
+generate lfence, which is the default.
.IP "\fB\-mx86\-used\-note=\fR\fIno\fR" 4
.IX Item "-mx86-used-note=no"
.PD 0
@@ -1653,7 +1776,8 @@ with 01, 10 and 11 \s-1RC\s0 bits, respectively.
.IX Item "-mintel64"
.PD
This option specifies that the assembler should accept only \s-1AMD64\s0 or
-Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept both.
+Intel64 \s-1ISA\s0 in 64\-bit mode. The default is to accept common, Intel64
+only and \s-1AMD64\s0 ISAs.
.IP "\fB\-O0 | \-O | \-O1 | \-O2 | \-Os\fR" 4
.IX Item "-O0 | -O | -O1 | -O2 | -Os"
Optimize instruction encoding with smaller instruction size. \fB\-O\fR
@@ -2455,6 +2579,9 @@ Generate code for Power8 architecture.
.IP "\fB\-mpower9, \-mpwr9\fR" 4
.IX Item "-mpower9, -mpwr9"
Generate code for Power9 architecture.
+.IP "\fB\-mpower10, \-mpwr10\fR" 4
+.IX Item "-mpower10, -mpwr10"
+Generate code for Power10 architecture.
.IP "\fB\-mcell\fR" 4
.IX Item "-mcell"
.PD 0
@@ -2515,6 +2642,20 @@ Don't generate position-independent code (default)
.IP "\fB\-march=ISA\fR" 4
.IX Item "-march=ISA"
Select the base isa, as specified by \s-1ISA.\s0 For example \-march=rv32ima.
+If this option and the architecture attributes aren't set, then assembler
+will check the default configure setting \-\-with\-arch=ISA.
+.IP "\fB\-misa\-spec=ISAspec\fR" 4
+.IX Item "-misa-spec=ISAspec"
+Select the default isa spec version. If the version of \s-1ISA\s0 isn't set
+by \-march, then assembler helps to set the version according to
+the default chosen spec. If this option isn't set, then assembler will
+check the default configure setting \-\-with\-isa\-spec=ISAspec.
+.IP "\fB\-mpriv\-spec=PRIVspec\fR" 4
+.IX Item "-mpriv-spec=PRIVspec"
+Select the privileged spec version. We can decide whether the \s-1CSR\s0 is valid or
+not according to the chosen spec. If this option and the privilege attributes
+aren't set, then assembler will check the default configure setting
+\&\-\-with\-priv\-spec=PRIVspec.
.IP "\fB\-mabi=ABI\fR" 4
.IX Item "-mabi=ABI"
Selects the \s-1ABI,\s0 which is either \*(L"ilp32\*(R" or \*(L"lp64\*(R", optionally followed
@@ -2529,6 +2670,26 @@ required to materialize symbol addresses. (default)
.IP "\fB\-mno\-relax\fR" 4
.IX Item "-mno-relax"
Don't do linker relaxations.
+.IP "\fB\-march\-attr\fR" 4
+.IX Item "-march-attr"
+Generate the default contents for the riscv elf attribute section if the
+\&.attribute directives are not set. This section is used to record the
+information that a linker or runtime loader needs to check compatibility.
+This information includes \s-1ISA\s0 string, stack alignment requirement, unaligned
+memory accesses, and the major, minor and revision version of privileged
+specification.
+.IP "\fB\-mno\-arch\-attr\fR" 4
+.IX Item "-mno-arch-attr"
+Don't generate the default riscv elf attribute section if the .attribute
+directives are not set.
+.IP "\fB\-mcsr\-check\fR" 4
+.IX Item "-mcsr-check"
+Enable the \s-1CSR\s0 checking for the ISA-dependent \s-1CRS\s0 and the read-only \s-1CSR.\s0
+The ISA-dependent \s-1CSR\s0 are only valid when the specific \s-1ISA\s0 is set. The
+read-only \s-1CSR\s0 can not be written by the \s-1CSR\s0 instructions.
+.IP "\fB\-mno\-csr\-check\fR" 4
+.IX Item "-mno-csr-check"
+Don't do \s-1CSR\s0 cheching.
.PP
See the info pages for documentation of the RX-specific options.
.PP
@@ -2555,7 +2716,8 @@ Specify which s390 processor variant is the target, \fBg5\fR (or
\&\fBarch3\fR), \fBg6\fR, \fBz900\fR (or \fBarch5\fR), \fBz990\fR (or
\&\fBarch6\fR), \fBz9\-109\fR, \fBz9\-ec\fR (or \fBarch7\fR), \fBz10\fR (or
\&\fBarch8\fR), \fBz196\fR (or \fBarch9\fR), \fBzEC12\fR (or \fBarch10\fR),
-\&\fBz13\fR (or \fBarch11\fR), or \fBz14\fR (or \fBarch12\fR).
+\&\fBz13\fR (or \fBarch11\fR), \fBz14\fR (or \fBarch12\fR), or \fBz15\fR
+(or \fBarch13\fR).
.IP "\fB\-mregnames\fR" 4
.IX Item "-mregnames"
.PD 0
@@ -2723,63 +2885,72 @@ across a greater range of addresses. This option should be used when jump tar
potentially be out of range. In the absence of such jumps this option
does not affect code size or performance. The default is
\&\fB\-\-trampolines\fR.
+.IP "\fB\-\-abi\-windowed | \-\-abi\-call0\fR" 4
+.IX Item "--abi-windowed | --abi-call0"
+Choose \s-1ABI\s0 tag written to the \f(CW\*(C`.xtensa.info\*(C'\fR section. \s-1ABI\s0 tag
+indicates \s-1ABI\s0 of the assembly code. A warning is issued by the linker
+on an attempt to link object files with inconsistent \s-1ABI\s0 tags.
+Default \s-1ABI\s0 is chosen by the Xtensa core configuration.
.PP
-The following options are available when as is configured for
-a Z80 family processor.
-.IP "\fB\-z80\fR" 4
-.IX Item "-z80"
-Assemble for Z80 processor.
-.IP "\fB\-r800\fR" 4
-.IX Item "-r800"
-Assemble for R800 processor.
-.IP "\fB\-ignore\-undocumented\-instructions\fR" 4
-.IX Item "-ignore-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wnud\fR" 4
-.IX Item "-Wnud"
-.PD
-Assemble undocumented Z80 instructions that also work on R800 without warning.
-.IP "\fB\-ignore\-unportable\-instructions\fR" 4
-.IX Item "-ignore-unportable-instructions"
-.PD 0
-.IP "\fB\-Wnup\fR" 4
-.IX Item "-Wnup"
-.PD
-Assemble all undocumented Z80 instructions without warning.
-.IP "\fB\-warn\-undocumented\-instructions\fR" 4
-.IX Item "-warn-undocumented-instructions"
-.PD 0
-.IP "\fB\-Wud\fR" 4
-.IX Item "-Wud"
-.PD
-Issue a warning for undocumented Z80 instructions that also work on R800.
-.IP "\fB\-warn\-unportable\-instructions\fR" 4
-.IX Item "-warn-unportable-instructions"
-.PD 0
-.IP "\fB\-Wup\fR" 4
-.IX Item "-Wup"
-.PD
-Issue a warning for undocumented Z80 instructions that do not work on R800.
-.IP "\fB\-forbid\-undocumented\-instructions\fR" 4
-.IX Item "-forbid-undocumented-instructions"
-.PD 0
-.IP "\fB\-Fud\fR" 4
-.IX Item "-Fud"
-.PD
-Treat all undocumented instructions as errors.
-.IP "\fB\-forbid\-unportable\-instructions\fR" 4
-.IX Item "-forbid-unportable-instructions"
-.PD 0
-.IP "\fB\-Fup\fR" 4
-.IX Item "-Fup"
-.PD
-Treat undocumented Z80 instructions that do not work on R800 as errors.
+The following options are available when as is configured for an
+Z80 processor.
+.PP
+\&\f(CW@chapter\fR Z80 Dependent Features
+.SS "Command-line Options"
+.IX Subsection "Command-line Options"
+.IP "\fB\-march=\fR\fI\s-1CPU\s0\fR\fB[\-\fR\fI\s-1EXT\s0\fR\fB...][+\fR\fI\s-1EXT\s0\fR\fB...]\fR" 4
+.IX Item "-march=CPU[-EXT...][+EXT...]"
+This option specifies the target processor. The assembler will issue
+an error message if an attempt is made to assemble an instruction which
+will not execute on the target processor. The following processor names
+are recognized:
+\&\f(CW\*(C`z80\*(C'\fR,
+\&\f(CW\*(C`z180\*(C'\fR,
+\&\f(CW\*(C`ez80\*(C'\fR,
+\&\f(CW\*(C`gbz80\*(C'\fR,
+\&\f(CW\*(C`z80n\*(C'\fR,
+\&\f(CW\*(C`r800\*(C'\fR.
+In addition to the basic instruction set, the assembler can be told to
+accept some extention mnemonics. For example,
+\&\f(CW\*(C`\-march=z180+sli+infc\*(C'\fR extends \fIz180\fR with \fI\s-1SLI\s0\fR instructions and
+\&\fI\s-1IN F,\s0(C)\fR. The following extentions are currently supported:
+\&\f(CW\*(C`full\*(C'\fR (all known instructions),
+\&\f(CW\*(C`adl\*(C'\fR (\s-1ADL CPU\s0 mode by default, eZ80 only),
+\&\f(CW\*(C`sli\*(C'\fR (instruction known as \fI\s-1SLI\s0\fR, \fI\s-1SLL\s0\fR or \fI\s-1SL1\s0\fR),
+\&\f(CW\*(C`xyhl\*(C'\fR (instructions with halves of index registers: \fI\s-1IXL\s0\fR, \fI\s-1IXH\s0\fR,
+\&\fI\s-1IYL\s0\fR, \fI\s-1IYH\s0\fR),
+\&\f(CW\*(C`xdcb\*(C'\fR (instructions like \fIRotOp (II+d),R\fR and \fIBitOp n,(II+d),R\fR),
+\&\f(CW\*(C`infc\*(C'\fR (instruction \fI\s-1IN F,\s0(C)\fR or \fI\s-1IN\s0 (C)\fR),
+\&\f(CW\*(C`outc0\*(C'\fR (instruction \fI\s-1OUT\s0 (C),0\fR).
+Note that rather than extending a basic instruction set, the extention
+mnemonics starting with \f(CW\*(C`\-\*(C'\fR revoke the respective functionality:
+\&\f(CW\*(C`\-march=z80\-full+xyhl\*(C'\fR first removes all default extentions and adds
+support for index registers halves only.
+.Sp
+If this option is not specified then \f(CW\*(C`\-march=z80+xyhl+infc\*(C'\fR is assumed.
+.IP "\fB\-local\-prefix=\fR\fIprefix\fR" 4
+.IX Item "-local-prefix=prefix"
+Mark all labels with specified prefix as local. But such label can be
+marked global explicitly in the code. This option do not change default
+local label prefix \f(CW\*(C`.L\*(C'\fR, it is just adds new one.
+.IP "\fB\-colonless\fR" 4
+.IX Item "-colonless"
+Accept colonless labels. All symbols at line begin are treated as labels.
+.IP "\fB\-sdcc\fR" 4
+.IX Item "-sdcc"
+Accept assembler code produced by \s-1SDCC.\s0
+.IP "\fB\-fp\-s=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-s=FORMAT"
+Single precision floating point numbers format. Default: ieee754 (32 bit).
+.IP "\fB\-fp\-d=\fR\fI\s-1FORMAT\s0\fR" 4
+.IX Item "-fp-d=FORMAT"
+Double precision floating point numbers format. Default: ieee754 (64 bit).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBgcc\fR\|(1), \fBld\fR\|(1), and the Info entries for \fIbinutils\fR and \fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/c++filt.1 b/share/man/man1/c++filt.1
index 1939a69..00e65a7 100644
--- a/share/man/man1/c++filt.1
+++ b/share/man/man1/c++filt.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "C++FILT 1"
-.TH C++FILT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH C++FILT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -366,7 +366,7 @@ MS-DOS this program is named \fB\s-1CXXFILT\s0\fR.
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/dlltool.1 b/share/man/man1/dlltool.1
index a3eae27..986c76c 100644
--- a/share/man/man1/dlltool.1
+++ b/share/man/man1/dlltool.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "DLLTOOL 1"
-.TH DLLTOOL 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH DLLTOOL 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -532,7 +532,7 @@ with a backslash. The \fIfile\fR may itself contain additional
The Info pages for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/elfedit.1 b/share/man/man1/elfedit.1
index db0efe9..c583e22 100644
--- a/share/man/man1/elfedit.1
+++ b/share/man/man1/elfedit.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ELFEDIT 1"
-.TH ELFEDIT 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH ELFEDIT 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -250,7 +250,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/gprof.1 b/share/man/man1/gprof.1
index 1b892b0..6f081c6 100644
--- a/share/man/man1/gprof.1
+++ b/share/man/man1/gprof.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "GPROF 1"
-.TH GPROF 1 "2019-10-12" "binutils-2.33.1" "GNU"
+.TH GPROF 1 "2020-09-19" "binutils-2.35.1" "GNU"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -762,7 +762,7 @@ Proceedings of the \s-1SIGPLAN\s0 '82 Symposium on Compiler Construction,
\&\s-1SIGPLAN\s0 Notices, Vol. 17, No 6, pp. 120\-126, June 1982.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1988\-2019 Free Software Foundation, Inc.
+Copyright (c) 1988\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/ld.1 b/share/man/man1/ld.1
index 9e77e89..ef33aa2 100644
--- a/share/man/man1/ld.1
+++ b/share/man/man1/ld.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "LD 1"
-.TH LD 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH LD 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -362,6 +362,46 @@ specified in the library. If specified multiple times \f(CW\*(C`DT_DEPAUDIT\*(C
will contain a colon separated list of audit interfaces to use. This
option is only meaningful on \s-1ELF\s0 platforms supporting the rtld-audit interface.
The \-P option is provided for Solaris compatibility.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\fR" 4
+.IX Item "--enable-non-contiguous-regions"
+This option avoids generating an error if an input section does not
+fit a matching output section. The linker tries to allocate the input
+section to subseque nt matching output sections, and generates an
+error only if no output section is large enough. This is useful when
+several non-contiguous memory regions are available and the input
+section does not require a particular one. The order in which input
+sections are evaluated does not change, for instance:
+.Sp
+.Vb 10
+\& MEMORY {
+\& MEM1 (rwx) : ORIGIN : 0x1000, LENGTH = 0x14
+\& MEM2 (rwx) : ORIGIN : 0x1000, LENGTH = 0x40
+\& MEM3 (rwx) : ORIGIN : 0x2000, LENGTH = 0x40
+\& }
+\& SECTIONS {
+\& mem1 : { *(.data.*); } > MEM1
+\& mem2 : { *(.data.*); } > MEM2
+\& mem3 : { *(.data.*); } > MEM2
+\& }
+\&
+\& with input sections:
+\& .data.1: size 8
+\& .data.2: size 0x10
+\& .data.3: size 4
+\&
+\& results in .data.1 affected to mem1, and .data.2 and .data.3
+\& affected to mem2, even though .data.3 would fit in mem3.
+.Ve
+.Sp
+This option is incompatible with \s-1INSERT\s0 statements because it changes
+the way input sections are mapped to output sections.
+.IP "\fB\-\-enable\-non\-contiguous\-regions\-warnings\fR" 4
+.IX Item "--enable-non-contiguous-regions-warnings"
+This option enables warnings when
+\&\f(CW\*(C`\-\-enable\-non\-contiguous\-regions\*(C'\fR allows possibly unexpected
+matches in sections mapping, potentially leading to silently
+discarding a section instead of failing because it does not fit any
+output region.
.IP "\fB\-e\fR \fIentry\fR" 4
.IX Item "-e entry"
.PD 0
@@ -426,6 +466,20 @@ See the description of \fB\-\-dynamic\-list\fR.
Note that this option is specific to \s-1ELF\s0 targeted ports. \s-1PE\s0 targets
support a similar function to export all symbols from a \s-1DLL\s0 or \s-1EXE\s0; see
the description of \fB\-\-export\-all\-symbols\fR below.
+.IP "\fB\-\-export\-dynamic\-symbol=\fR\fIglob\fR" 4
+.IX Item "--export-dynamic-symbol=glob"
+When creating a dynamically linked executable, symbols matching
+\&\fIglob\fR will be added to the dynamic symbol table. When creating a
+shared library, references to symbols matching \fIglob\fR will not be
+bound to the definitions within the shared library. This option is a
+no-op when creating a shared library and \fB\-Bsymbolic\fR or
+\&\fB\-\-dynamic\-list\fR are not specified. This option is only meaningful
+on \s-1ELF\s0 platforms which support shared libraries.
+.IP "\fB\-\-export\-dynamic\-symbol\-list=\fR\fIfile\fR" 4
+.IX Item "--export-dynamic-symbol-list=file"
+Specify a \fB\-\-export\-dynamic\-symbol\fR for each pattern in the file.
+The format of the file is the same as the version node without
+scope and node name. See \fB\s-1VERSION\s0\fR for more information.
.IP "\fB\-EB\fR" 4
.IX Item "-EB"
Link big-endian objects. This affects the default output format.
@@ -708,6 +762,17 @@ shared libraries. Use \fB\-Bdynamic\fR for this.
Use \fIoutput\fR as the name for the program produced by \fBld\fR; if this
option is not specified, the name \fIa.out\fR is used by default. The
script command \f(CW\*(C`OUTPUT\*(C'\fR can also specify the output file name.
+.IP "\fB\-\-dependency\-file=\fR\fIdepfile\fR" 4
+.IX Item "--dependency-file=depfile"
+Write a \fIdependency file\fR to \fIdepfile\fR. This file contains a rule
+suitable for \f(CW\*(C`make\*(C'\fR describing the output file and all the input files
+that were read to produce it. The output is similar to the compiler's
+output with \fB\-M \-MP\fR. Note that there is no option like the compiler's \fB\-MM\fR,
+to exclude \*(L"system files\*(R" (which is not a well-specified concept in the
+linker, unlike \*(L"system headers\*(R" in the compiler). So the output from
+\&\fB\-\-dependency\-file\fR is always specific to the exact state of the
+installation where it was produced, and should not be copied into
+distributed makefiles without careful editing.
.IP "\fB\-O\fR \fIlevel\fR" 4
.IX Item "-O level"
If \fIlevel\fR is a numeric values greater than zero \fBld\fR optimizes
@@ -1197,6 +1262,16 @@ Linux/i386 and Linux/x86_64.
Specify a stack size for an \s-1ELF\s0 \f(CW\*(C`PT_GNU_STACK\*(C'\fR segment.
Specifying zero will override any default non-zero sized
\&\f(CW\*(C`PT_GNU_STACK\*(C'\fR segment creation.
+.IP "\fBstart\-stop\-visibility=\fR\fIvalue\fR" 4
+.IX Item "start-stop-visibility=value"
+Specify the \s-1ELF\s0 symbol visibility for synthesized
+\&\f(CW\*(C`_\|_start_SECNAME\*(C'\fR and \f(CW\*(C`_\|_stop_SECNAME\*(C'\fR symbols. \fIvalue\fR must be exactly \fBdefault\fR,
+\&\fBinternal\fR, \fBhidden\fR, or \fBprotected\fR. If no \fB\-z
+start-stop-visibility\fR option is given, \fBprotected\fR is used for
+compatibility with historical practice. However, it's highly
+recommended to use \fB\-z start\-stop\-visibility=hidden\fR in new
+programs and shared libraries so that these symbols are not exported
+between shared objects, which is not usually what's intended.
.IP "\fBtext\fR" 4
.IX Item "text"
.PD 0
@@ -1205,9 +1280,9 @@ Specifying zero will override any default non-zero sized
.IP "\fBtextoff\fR" 4
.IX Item "textoff"
.PD
-Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the binary has dynamic
-relocations in read-only sections. Don't report an error if
-\&\fBnotext\fR or \fBtextoff\fR.
+Report an error if \s-1DT_TEXTREL\s0 is set, i.e., if the position-independent
+or shared object has dynamic relocations in read-only sections. Don't
+report an error if \fBnotext\fR or \fBtextoff\fR.
.IP "\fBundefs\fR" 4
.IX Item "undefs"
Do not report unresolved symbol references from regular object files,
@@ -1330,20 +1405,14 @@ libraries.
When creating a shared library, bind references to global symbols to the
definition within the shared library, if any. Normally, it is possible
for a program linked against a shared library to override the definition
-within the shared library. This option can also be used with the
-\&\fB\-\-export\-dynamic\fR option, when creating a position independent
-executable, to bind references to global symbols to the definition within
-the executable. This option is only meaningful on \s-1ELF\s0 platforms which
-support shared libraries and position independent executables.
+within the shared library. This option is only meaningful on \s-1ELF\s0
+platforms which support shared libraries.
.IP "\fB\-Bsymbolic\-functions\fR" 4
.IX Item "-Bsymbolic-functions"
When creating a shared library, bind references to global function
symbols to the definition within the shared library, if any.
-This option can also be used with the \fB\-\-export\-dynamic\fR option,
-when creating a position independent executable, to bind references
-to global function symbols to the definition within the executable.
This option is only meaningful on \s-1ELF\s0 platforms which support shared
-libraries and position independent executables.
+libraries.
.IP "\fB\-\-dynamic\-list=\fR\fIdynamic-list-file\fR" 4
.IX Item "--dynamic-list=dynamic-list-file"
Specify the name of a dynamic list file to the linker. This is
@@ -1589,7 +1658,10 @@ Print a summary of all target-specific options on the standard output and exit.
.IP "\fB\-Map=\fR\fImapfile\fR" 4
.IX Item "-Map=mapfile"
Print a link map to the file \fImapfile\fR. See the description of the
-\&\fB\-M\fR option, above.
+\&\fB\-M\fR option, above. Specifying a directory as \fImapfile\fR
+causes the linker map to be written into a file inside the directory.
+The name of the file is based upon the \fIoutput\fR filename with
+\&\f(CW\*(C`.map\*(C'\fR appended.
.IP "\fB\-\-no\-keep\-memory\fR" 4
.IX Item "--no-keep-memory"
\&\fBld\fR normally optimizes for speed over memory usage by caching the
@@ -1863,8 +1935,18 @@ libraries needed by it. The \f(CW\*(C`DT_RPATH\*(C'\fR entries are ignored if
.IP "7." 4
The default directories, normally \fI/lib\fR and \fI/usr/lib\fR.
.IP "8." 4
-For a native linker on an \s-1ELF\s0 system, if the file \fI/etc/ld.so.conf\fR
-exists, the list of directories found in that file.
+For a linker for a Linux system, if the file \fI/etc/ld.so.conf\fR
+exists, the list of directories found in that file. Note: the path
+to this file is prefixed with the \f(CW\*(C`sysroot\*(C'\fR value, if that is
+defined, and then any \f(CW\*(C`prefix\*(C'\fR string if the linker was
+configured with the \fB\-\-prefix=<path>\fR option.
+.IP "9." 4
+For a native linker on a FreeBSD system, any directories specified by
+the \f(CW\*(C`_PATH_ELF_HINTS\*(C'\fR macro defined in the \fIelf\-hints.h\fR
+header file.
+.IP "10." 4
+Any directories specifed by a \f(CW\*(C`SEARCH_DIR\*(C'\fR command in the
+linker script being used.
.RE
.RS 4
.Sp
@@ -2148,9 +2230,10 @@ alignment. Typically, the alignment will be set by an input section.
The address will only be changed if it not explicitly specified; that
is, if the \f(CW\*(C`SECTIONS\*(C'\fR command does not specify a start address for
the section.
-.IP "\fB\-\-warn\-shared\-textrel\fR" 4
-.IX Item "--warn-shared-textrel"
-Warn if the linker adds a \s-1DT_TEXTREL\s0 to a shared object.
+.IP "\fB\-\-warn\-textrel\fR" 4
+.IX Item "--warn-textrel"
+Warn if the linker adds \s-1DT_TEXTREL\s0 to a position-independent executable
+or shared object.
.IP "\fB\-\-warn\-alternate\-em\fR" 4
.IX Item "--warn-alternate-em"
Warn if an object has alternate \s-1ELF\s0 machine code.
@@ -2758,11 +2841,14 @@ of the \s-1PE\s0 file header:
.IX Item "--high-entropy-va"
Image is compatible with 64\-bit address space layout randomization
(\s-1ASLR\s0).
+This option also implies \fB\-\-dynamicbase\fR and
+\&\fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-dynamicbase\fR" 4
.IX Item "--dynamicbase"
The image base address may be relocated using address space layout
randomization (\s-1ASLR\s0). This feature was introduced with \s-1MS\s0 Windows
Vista for i386 \s-1PE\s0 targets.
+This option also implies \fB\-\-enable\-reloc\-section\fR.
.IP "\fB\-\-forceinteg\fR" 4
.IX Item "--forceinteg"
Code integrity checks are enforced.
@@ -2800,6 +2886,10 @@ same sources are linked. The option \fB\-\-no\-insert\-timestamp\fR
can be used to insert a zero value for the timestamp, this ensuring
that binaries produced from identical sources will compare
identically.
+.IP "\fB\-\-enable\-reloc\-section\fR" 4
+.IX Item "--enable-reloc-section"
+Create the base relocation table, which is necessary if the image
+is loaded at a different image base than specified in the \s-1PE\s0 header.
.PP
The C6X uClinux target uses a binary format called \s-1DSBT\s0 to support shared
libraries. Each shared library in the system needs to have a unique index;
@@ -2891,11 +2981,63 @@ an error.
.IP "\fB\-\-compact\-branches\fR" 4
.IX Item "--compact-branches"
.PD 0
-.IP "\fB\-\-compact\-branches\fR" 4
-.IX Item "--compact-branches"
+.IP "\fB\-\-no\-compact\-branches\fR" 4
+.IX Item "--no-compact-branches"
.PD
These options control the generation of compact instructions by the linker
in the \s-1PLT\s0 entries for \s-1MIPS R6.\s0
+.PP
+For the pdp11\-aout target, three variants of the output format can be
+produced as selected by the following options. The default variant
+for pdp11\-aout is the \fB\-\-omagic\fR option, whereas for other
+targets \fB\-\-nmagic\fR is the default. The \fB\-\-imagic\fR option is
+defined only for the pdp11\-aout target, while the others are described
+here as they apply to the pdp11\-aout target.
+.IP "\fB\-N\fR" 4
+.IX Item "-N"
+.PD 0
+.IP "\fB\-\-omagic\fR" 4
+.IX Item "--omagic"
+.PD
+Mark the output as \f(CW\*(C`OMAGIC\*(C'\fR (0407) in the \fIa.out\fR header to
+indicate that the text segment is not to be write-protected and
+shared. Since the text and data sections are both readable and
+writable, the data section is allocated immediately contiguous after
+the text segment. This is the oldest format for \s-1PDP11\s0 executable
+programs and is the default for \fBld\fR on \s-1PDP11\s0 Unix systems
+from the beginning through 2.11BSD.
+.IP "\fB\-n\fR" 4
+.IX Item "-n"
+.PD 0
+.IP "\fB\-\-nmagic\fR" 4
+.IX Item "--nmagic"
+.PD
+Mark the output as \f(CW\*(C`NMAGIC\*(C'\fR (0410) in the \fIa.out\fR header to
+indicate that when the output file is executed, the text portion will
+be read-only and shareable among all processes executing the same
+file. This involves moving the data areas up to the first possible 8K
+byte page boundary following the end of the text. This option creates
+a \fIpure executable\fR format.
+.IP "\fB\-z\fR" 4
+.IX Item "-z"
+.PD 0
+.IP "\fB\-\-imagic\fR" 4
+.IX Item "--imagic"
+.PD
+Mark the output as \f(CW\*(C`IMAGIC\*(C'\fR (0411) in the \fIa.out\fR header to
+indicate that when the output file is executed, the program text and
+data areas will be loaded into separate address spaces using the split
+instruction and data space feature of the memory management unit in
+larger models of the \s-1PDP11.\s0 This doubles the address space available
+to the program. The text segment is again pure, write-protected, and
+shareable. The only difference in the output format between this
+option and the others, besides the magic number, is that both the text
+and data sections start at location 0. The \fB\-z\fR option selected
+this format in 2.11BSD. This option creates a \fIseparate
+executable\fR format.
+.IP "\fB\-\-no\-omagic\fR" 4
+.IX Item "--no-omagic"
+Equivalent to \fB\-\-nmagic\fR for pdp11\-aout.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
You can change the behaviour of \fBld\fR with the environment variables
@@ -2935,7 +3077,7 @@ the Info entries for \fIbinutils\fR and
\&\fIld\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/nm.1 b/share/man/man1/nm.1
index 6811de2..e37a0a1 100644
--- a/share/man/man1/nm.1
+++ b/share/man/man1/nm.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "NM 1"
-.TH NM 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH NM 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -592,7 +592,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/objcopy.1 b/share/man/man1/objcopy.1
index 974655e..09814c0 100644
--- a/share/man/man1/objcopy.1
+++ b/share/man/man1/objcopy.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJCOPY 1"
-.TH OBJCOPY 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJCOPY 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -166,6 +166,7 @@ objcopy [\fB\-F\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-\-interleave\-width=\fR\fIwidth\fR]
[\fB\-j\fR \fIsectionpattern\fR|\fB\-\-only\-section=\fR\fIsectionpattern\fR]
[\fB\-R\fR \fIsectionpattern\fR|\fB\-\-remove\-section=\fR\fIsectionpattern\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -363,6 +364,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove non-dynamic relocations from the output file for any section
@@ -600,16 +605,18 @@ done by increasing the size of the last section. The extra space is
filled in with the value specified by \fB\-\-gap\-fill\fR (default zero).
.IP "\fB\-\-set\-start\fR \fIval\fR" 4
.IX Item "--set-start val"
-Set the start address of the new file to \fIval\fR. 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 \fIval\fR. Not all object file formats support setting the
+start address.
.IP "\fB\-\-change\-start\fR \fIincr\fR" 4
.IX Item "--change-start incr"
.PD 0
.IP "\fB\-\-adjust\-start\fR \fIincr\fR" 4
.IX Item "--adjust-start incr"
.PD
-Change the start address by adding \fIincr\fR. Not all object file
-formats support setting the start address.
+Change the start address (also known as the entry address) by adding
+\&\fIincr\fR. Not all object file formats support setting the start
+address.
.IP "\fB\-\-change\-addresses\fR \fIincr\fR" 4
.IX Item "--change-addresses incr"
.PD 0
@@ -686,11 +693,13 @@ Set the flags for any sections matching \fIsectionpattern\fR. The
\&\fIflags\fR argument is a comma separated string of flag names. The
recognized names are \fBalloc\fR, \fBcontents\fR, \fBload\fR,
\&\fBnoload\fR, \fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR,
-\&\fBshare\fR, and \fBdebug\fR. You can set the \fBcontents\fR flag
-for a section which does not have contents, but it is not meaningful
-to clear the \fBcontents\fR flag of a section which does have
-contents\*(--just remove the section instead. Not all flags are
-meaningful for all object file formats.
+\&\fBexclude\fR, \fBshare\fR, and \fBdebug\fR. You can set the
+\&\fBcontents\fR flag for a section which does not have contents, but it
+is not meaningful to clear the \fBcontents\fR 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
+\&\fBshare\fR flag is only meaningful for \s-1COFF\s0 format files and not for
+\&\s-1ELF\s0 format files.
.IP "\fB\-\-set\-section\-alignment\fR \fIsectionpattern\fR\fB=\fR\fIalign\fR" 4
.IX Item "--set-section-alignment sectionpattern=align"
Set the alignment for any sections matching \fIsectionpattern\fR.
@@ -746,7 +755,8 @@ Rename a section from \fIoldname\fR to \fInewname\fR, optionally
changing the section's flags to \fIflags\fR 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.
+executable. This option accepts the same set of flags as the
+\&\fB\-\-sect\-section\-flags\fR option.
.Sp
This option is particularly helpful when the input format is binary,
since this will always create a section called .data. If for example,
@@ -1218,7 +1228,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBld\fR\|(1), \fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/objdump.1 b/share/man/man1/objdump.1
index 65acc7b..c2209fb 100644
--- a/share/man/man1/objdump.1
+++ b/share/man/man1/objdump.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "OBJDUMP 1"
-.TH OBJDUMP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH OBJDUMP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -167,8 +167,8 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-r\fR|\fB\-\-reloc\fR]
[\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
[\fB\-s\fR|\fB\-\-full\-contents\fR]
- [\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-dwarf\fR[=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]]
+ [\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-dwarf\fR[=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]]
[\fB\-\-ctf=\fR\fIsection\fR]
[\fB\-G\fR|\fB\-\-stabs\fR]
[\fB\-t\fR|\fB\-\-syms\fR]
@@ -177,19 +177,19 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
[\fB\-w\fR|\fB\-\-wide\fR]
[\fB\-\-start\-address=\fR\fIaddress\fR]
[\fB\-\-stop\-address=\fR\fIaddress\fR]
+ [\fB\-\-no\-addresses\fR]
[\fB\-\-prefix\-addresses\fR]
[\fB\-\-[no\-]show\-raw\-insn\fR]
[\fB\-\-adjust\-vma=\fR\fIoffset\fR]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf\-parent=\fR\fIsection\fR]
- [\fB\-\-ctf\-symbols=\fR\fIsection\fR]
- [\fB\-\-ctf\-strings=\fR\fIsection\fR]
[\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]
[\fB\-\-special\-syms\fR]
[\fB\-\-prefix=\fR\fIprefix\fR]
[\fB\-\-prefix\-strip=\fR\fIlevel\fR]
[\fB\-\-insn\-width=\fR\fIwidth\fR]
+ [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR
[\fB\-V\fR|\fB\-\-version\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIobjfile\fR...
@@ -286,7 +286,7 @@ possible and any bug reports about such an event will be rejected.
.PD
Display debugging information. This attempts to parse \s-1STABS\s0
debugging format information stored in the file and print it out using
-a C like syntax. If no \s-1STABS\s0 debuging was found this option
+a C like syntax. If no \s-1STABS\s0 debugging was found this option
falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
the file.
.IP "\fB\-e\fR" 4
@@ -342,6 +342,11 @@ sections as if they were instructions.
Note if the \fB\-\-dwarf=follow\-links\fR option has also been enabled
then any symbol tables in linked debug info files will be read in and
used when disassembling.
+.IP "\fB\-\-no\-addresses\fR" 4
+.IX Item "--no-addresses"
+When disassembling, don't print addresses on each line or for symbols
+and relocation offsets. In combination with \fB\-\-no\-show\-raw\-insn\fR
+this may be useful for comparing compiler output.
.IP "\fB\-\-prefix\-addresses\fR" 4
.IX Item "--prefix-addresses"
When disassembling, print the complete address on each line. This is
@@ -512,8 +517,7 @@ option or whether instruction notes should be generated as comments in the
disasssembly using \fB\-M notes\fR.
.Sp
For the x86, some of the options duplicate functions of the \fB\-m\fR
-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.
.RS 4
.ie n .IP """x86\-64""" 4
.el .IP "\f(CWx86\-64\fR" 4
@@ -579,8 +583,10 @@ appear later in the option string.
.ie n .IP """suffix""" 4
.el .IP "\f(CWsuffix\fR" 4
.IX Item "suffix"
-When in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic
-suffix even when the suffix could be inferred by the operands.
+When in \s-1AT&T\s0 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 or, for certain instructions, the
+execution mode's defaults.
.RE
.RS 4
.Sp
@@ -597,10 +603,10 @@ rather than \f(CW\*(C`li\*(C'\fR. All of the \fB\-m\fR arguments for
\&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR,
\&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR,
\&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR,
-\&\fBpower8\fR, \fBpower9\fR, \fBppc\fR, \fBppc32\fR,
-\&\fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR, \fBpwr\fR,
-\&\fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
-\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR,
+\&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBppc\fR,
+\&\fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR,
+\&\fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
+\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, \fBpwr10\fR,
\&\fBpwrx\fR, \fBtitan\fR, and \fBvle\fR.
\&\fB32\fR and \fB64\fR modify the default or a prior \s-1CPU\s0
selection, disabling and enabling 64\-bit insns respectively. In
@@ -815,11 +821,22 @@ This is the default when \fB\-\-prefix\-addresses\fR is used.
.IX Item "--insn-width=width"
Display \fIwidth\fR bytes on a single line when disassembling
instructions.
-.IP "\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-W[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR" 4
+.IX Item "--visualize-jumps[=color|=extended-color|=off]"
+Visualize jumps that stay inside a function by drawing \s-1ASCII\s0 art between
+the start and target addresses. The optional \fB=color\fR argument
+adds color to the output using simple terminal colors. Alternatively
+the \fB=extended\-color\fR argument will add color using 8bit
+colors, but these might not work on all terminals.
+.Sp
+If it is necessary to disable the \fBvisualize-jumps\fR option
+after it has previously been enabled then use
+\&\fBvisualize\-jumps=off\fR.
+.IP "\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR" 4
+.IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -963,6 +980,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -1074,8 +1100,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-G\fR" 4
.IX Item "-G"
.PD 0
@@ -1289,7 +1316,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/ranlib.1 b/share/man/man1/ranlib.1
index 8623176..2770eae 100644
--- a/share/man/man1/ranlib.1
+++ b/share/man/man1/ranlib.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "RANLIB 1"
-.TH RANLIB 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH RANLIB 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -217,7 +217,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBnm\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/readelf.1 b/share/man/man1/readelf.1
index 50c95fa..cd38f61 100644
--- a/share/man/man1/readelf.1
+++ b/share/man/man1/readelf.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "READELF 1"
-.TH READELF 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH READELF 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -158,13 +158,14 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-V\fR|\fB\-\-version\-info\fR]
[\fB\-A\fR|\fB\-\-arch\-specific\fR]
[\fB\-D\fR|\fB\-\-use\-dynamic\fR]
+ [\fB\-L\fR|\fB\-\-lint\fR|\fB\-\-enable\-checks\fR]
[\fB\-x\fR <number or name>|\fB\-\-hex\-dump=\fR<number or name>]
[\fB\-p\fR <number or name>|\fB\-\-string\-dump=\fR<number or name>]
[\fB\-R\fR <number or name>|\fB\-\-relocated\-dump=\fR<number or name>]
[\fB\-z\fR|\fB\-\-decompress\fR]
[\fB\-c\fR|\fB\-\-archive\-index\fR]
- [\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR|
- \fB\-\-debug\-dump\fR[=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]]
+ [\fB\-w[lLiaprmfFsoORtUuTgAckK]\fR|
+ \fB\-\-debug\-dump\fR[=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]]
[\fB\-\-dwarf\-depth=\fR\fIn\fR]
[\fB\-\-dwarf\-start=\fR\fIn\fR]
[\fB\-\-ctf=\fR\fIsection\fR]
@@ -174,6 +175,7 @@ readelf [\fB\-a\fR|\fB\-\-all\fR]
[\fB\-I\fR|\fB\-\-histogram\fR]
[\fB\-v\fR|\fB\-\-version\fR]
[\fB\-W\fR|\fB\-\-wide\fR]
+ [\fB\-T\fR|\fB\-\-silent\-truncation\fR]
[\fB\-H\fR|\fB\-\-help\fR]
\fIelffile\fR...
.SH "DESCRIPTION"
@@ -341,6 +343,19 @@ symbol table sections.
.Sp
When displaying relocations, this option makes \fBreadelf\fR
display the dynamic relocations rather than the static relocations.
+.IP "\fB\-L\fR" 4
+.IX Item "-L"
+.PD 0
+.IP "\fB\-\-lint\fR" 4
+.IX Item "--lint"
+.IP "\fB\-\-enable\-checks\fR" 4
+.IX Item "--enable-checks"
+.PD
+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.
.IP "\fB\-x <number or name>\fR" 4
.IX Item "-x <number or name>"
.PD 0
@@ -388,11 +403,11 @@ section(s) are not compressed then they are displayed as is.
Displays the file symbol index information contained in the header part
of binary archives. Performs the same function as the \fBt\fR
command to \fBar\fR, but without using the \s-1BFD\s0 library.
-.IP "\fB\-w[lLiaprmfFsoRtUuTgAckK]\fR" 4
-.IX Item "-w[lLiaprmfFsoRtUuTgAckK]"
+.IP "\fB\-w[lLiaprmfFsOoRtUuTgAckK]\fR" 4
+.IX Item "-w[lLiaprmfFsOoRtUuTgAckK]"
.PD 0
-.IP "\fB\-\-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]\fR" 4
-.IX Item "--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]"
+.IP "\fB\-\-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]\fR" 4
+.IX Item "--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]"
.PD
Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
are present. Compressed debug sections are automatically decompressed
@@ -536,6 +551,15 @@ Displays the contents of the \fB.debug_macro\fR and/or
.PD
Displays the contents of the \fB.debug_loc\fR and/or
\&\fB.debug_loclists\fR sections.
+.ie n .IP """O""" 4
+.el .IP "\f(CWO\fR" 4
+.IX Item "O"
+.PD 0
+.ie n .IP """=str\-offsets""" 4
+.el .IP "\f(CW=str\-offsets\fR" 4
+.IX Item "=str-offsets"
+.PD
+Displays the contents of the \fB.debug_str_offsets\fR section.
.ie n .IP """p""" 4
.el .IP "\f(CWp\fR" 4
.IX Item "p"
@@ -644,8 +668,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t
contain many subsections, all of which are displayed in order.
.IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4
.IX Item "--ctf-parent=section"
-Specify the name of another section from which the \s-1CTF\s0 file can inherit
-types.
+Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit
+types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types
+from the default-named member of the archive contained within this section.)
.IP "\fB\-\-ctf\-symbols=\fR\fIsection\fR" 4
.IX Item "--ctf-symbols=section"
.PD 0
@@ -653,7 +678,8 @@ types.
.IX Item "--ctf-strings=section"
.PD
Specify the name of another section from which the \s-1CTF\s0 file can inherit
-strings and symbols.
+strings and symbols. By default, the \f(CW\*(C`.symtab\*(C'\fR and its linked
+string table are used.
.Sp
If either of \fB\-\-ctf\-symbols\fR or \fB\-\-ctf\-strings\fR is specified, the
other must be specified as well.
@@ -683,6 +709,18 @@ Don't break output lines to fit into 80 columns. By default
64\-bit \s-1ELF\s0 files, so that they fit into 80 columns. This option causes
\&\fBreadelf\fR to print each section header resp. each segment one a
single line, which is far more readable on terminals wider than 80 columns.
+.IP "\fB\-T\fR" 4
+.IX Item "-T"
+.PD 0
+.IP "\fB\-\-silent\-truncation\fR" 4
+.IX Item "--silent-truncation"
+.PD
+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 \f(CW\*(C`[...]\*(C'\fR 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).
.IP "\fB\-H\fR" 4
.IX Item "-H"
.PD 0
@@ -708,7 +746,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/size.1 b/share/man/man1/size.1
index 4dd5230..7421ee1 100644
--- a/share/man/man1/size.1
+++ b/share/man/man1/size.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "SIZE 1"
-.TH SIZE 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH SIZE 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -287,7 +287,7 @@ with a backslash. The \fIfile\fR may itself contain additional
\&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/strings.1 b/share/man/man1/strings.1
index d8a1961..7903164 100644
--- a/share/man/man1/strings.1
+++ b/share/man/man1/strings.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRINGS 1"
-.TH STRINGS 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRINGS 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -161,7 +161,7 @@ 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.
.PP
@@ -305,7 +305,7 @@ with a backslash. The \fIfile\fR may itself contain additional
and the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/strip.1 b/share/man/man1/strip.1
index d554f85..42abc91 100644
--- a/share/man/man1/strip.1
+++ b/share/man/man1/strip.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "STRIP 1"
-.TH STRIP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH STRIP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -154,6 +154,7 @@ strip [\fB\-F\fR \fIbfdname\fR |\fB\-\-target=\fR\fIbfdname\fR]
[\fB\-w\fR|\fB\-\-wildcard\fR]
[\fB\-x\fR|\fB\-\-discard\-all\fR] [\fB\-X\fR |\fB\-\-discard\-locals\fR]
[\fB\-R\fR \fIsectionname\fR |\fB\-\-remove\-section=\fR\fIsectionname\fR]
+ [\fB\-\-keep\-section=\fR\fIsectionpattern\fR]
[\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR]
[\fB\-o\fR \fIfile\fR] [\fB\-p\fR|\fB\-\-preserve\-dates\fR]
[\fB\-D\fR|\fB\-\-enable\-deterministic\-archives\fR]
@@ -226,6 +227,10 @@ would otherwise remove it. For example:
.Sp
will remove all sections matching the pattern '.text.*', but will not
remove the section '.text.foo'.
+.IP "\fB\-\-keep\-section=\fR\fIsectionpattern\fR" 4
+.IX Item "--keep-section=sectionpattern"
+When removing sections from the output file, keep sections that match
+\&\fIsectionpattern\fR.
.IP "\fB\-\-remove\-relocations=\fR\fIsectionpattern\fR" 4
.IX Item "--remove-relocations=sectionpattern"
Remove relocations from the output file for any section matching
@@ -487,7 +492,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/windmc.1 b/share/man/man1/windmc.1
index 7cb9850..0c6a5d6 100644
--- a/share/man/man1/windmc.1
+++ b/share/man/man1/windmc.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDMC 1"
-.TH WINDMC 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDMC 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -350,7 +350,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
diff --git a/share/man/man1/windres.1 b/share/man/man1/windres.1
index 2253ab3..00650cc 100644
--- a/share/man/man1/windres.1
+++ b/share/man/man1/windres.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "WINDRES 1"
-.TH WINDRES 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools"
+.TH WINDRES 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -358,7 +358,7 @@ with a backslash. The \fIfile\fR may itself contain additional
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (c) 1991\-2019 Free Software Foundation, Inc.
+Copyright (c) 1991\-2020 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3