aboutsummaryrefslogtreecommitdiff
path: root/binutils/objcopy.1
diff options
context:
space:
mode:
authorDavid MacKenzie <djm@cygnus>1994-01-26 22:11:18 +0000
committerDavid MacKenzie <djm@cygnus>1994-01-26 22:11:18 +0000
commitf7b839f7cd992eb8f017aea438f161c2463299fe (patch)
tree92eb235a9e8b8f3afabd8da8e00a9d2e15d54fbf /binutils/objcopy.1
parentd6d4e4c3d094eb34d807fa6d94bd04859ca003ff (diff)
downloadgdb-f7b839f7cd992eb8f017aea438f161c2463299fe.zip
gdb-f7b839f7cd992eb8f017aea438f161c2463299fe.tar.gz
gdb-f7b839f7cd992eb8f017aea438f161c2463299fe.tar.bz2
* objcopy.c (filter_bytes): New function.
(copy_section): Call it. (copy_options, copy_usage, copy_main): Add --byte option to activate it. Appropriate the -b option (which was an undocumented synonym for -F) for it, also. Add --interleave, -i option for additional control. (setup_section, copy_section, mangle_section): Renamed with no `s' on the end. * objcopy.1, binutils.texi: Document the new options. * objdump.c (display_target_tables, display_target_list): New functions broken out of display_info. Eliminate some magic constants. Use more meaningful variable names. (dump_bfd_header): New function broken out of display_bfd. (dump_section_header): New function broken out of dump_headers. (remove_useless_symbols): Don't shadow global variable name with parameter. (objdump_print_address): Fix backward test.
Diffstat (limited to 'binutils/objcopy.1')
-rw-r--r--binutils/objcopy.115
1 files changed, 14 insertions, 1 deletions
diff --git a/binutils/objcopy.1 b/binutils/objcopy.1
index 74e718e..4ba1164 100644
--- a/binutils/objcopy.1
+++ b/binutils/objcopy.1
@@ -8,7 +8,7 @@
..
.SH NAME
-objcopy\(em\&copy and translate object files
+objcopy \- copy and translate object files
.SH SYNOPSIS
.hy 0
@@ -22,6 +22,8 @@ objcopy\(em\&copy and translate object files
.RB "[\|" \-g\ |\ \-\-strip\-debug\fR "\|]"
.RB "[\|" \-x\ |\ \-\-discard\-all\fR "\|]"
.RB "[\|" \-X\ |\ \-\-discard\-locals\fR "\|]"
+.RB "[\|" \-b\ \fIbyte\fP |\ \-\-byte=\fIbyte\fP "\|]"
+.RB "[\|" \-i\ \fIinterleave\fP |\ \-\-interleave=\fIinterleave\fP "\|]"
.RB "[\|" \-v\ |\ \-\-verbose\fR "\|]"
.RB "[\|" \-V\ |\ \-\-version\fR "\|]"
.RB "[\|" \-\-help\fR "\|]"
@@ -85,6 +87,17 @@ Do not copy non-global symbols from the source file.
Do not copy compiler-generated local symbols. (These usually start
with "L" or ".").
.TP
+.B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte
+Keep only every \fIbyte\fPth byte of the input file (header data is
+not affected). \fIbyte\fP can be in the range from 0 to the
+interleave-1. This option is useful for creating files to program
+ROMs. It is typically used with an srec output target.
+.TP
+.B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave
+Only copy one out of every \fIinterleave\fP bytes. Which one to copy is
+selected by the \fB\-b\fP or \fB\-\-byte\fP option. The default is 4.
+The interleave is ignored if neither \fB\-b\fP nor \fB\-\-byte\fP is given.
+.TP
.B \-v\fR, \fB\-\-verbose
Verbose output: list all object files modified. In the case of
archives, "\fBobjcopy \-V\fR" lists all members of the archive.