diff options
Diffstat (limited to 'share/man/man1/aarch64-linux-gnu-objcopy.1')
| -rw-r--r-- | share/man/man1/aarch64-linux-gnu-objcopy.1 | 34 |
1 files changed, 22 insertions, 12 deletions
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 |
