aboutsummaryrefslogtreecommitdiff
path: root/share/man/man1/objcopy.1
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/man1/objcopy.1
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/man1/objcopy.1')
-rw-r--r--share/man/man1/objcopy.134
1 files changed, 22 insertions, 12 deletions
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