Provided by: sdcc_4.2.0+dfsg-1_amd64 
NAME
sdobjcopy - copy and translate object files. A part of SDCC
SYNOPSIS
sdobjcopy [option(s)] in-file [out-file]
DESCRIPTION
Copies a binary file, possibly transforming it in the process The options are:
-I --input-target <bfdname>
Assume input file is in format <bfdname>
-O --output-target <bfdname>
Create an output file in format <bfdname>
-B --binary-architecture <arch>
Set output arch, when input is arch-less
-F --target <bfdname>
Set both input and output format to <bfdname>
--debugging
Convert debugging information, if possible
-p --preserve-dates
Copy modified/access timestamps to the output
-D --enable-deterministic-archives
Produce deterministic output when stripping archives
-U --disable-deterministic-archives
Disable -D behavior (default)
-j --only-section <name>
Only copy section <name> into the output
--add-gnu-debuglink=<file>
Add section .gnu_debuglink linking to <file>
-R --remove-section <name>
Remove section <name> from the output
-S --strip-all
Remove all symbol and relocation information
-g --strip-debug
Remove all debugging symbols & sections
--strip-dwo
Remove all DWO sections
--strip-unneeded
Remove all symbols not needed by relocations
-N --strip-symbol <name>
Do not copy symbol <name>
--strip-unneeded-symbol <name>
Do not copy symbol <name> unless needed by
relocations
--only-keep-debug
Strip everything but the debug information
--extract-dwo
Copy only DWO sections
--extract-symbol
Remove section contents but keep symbols
-K --keep-symbol <name>
Do not strip symbol <name>
--keep-file-symbols
Do not strip file symbol(s)
--localize-hidden
Turn all ELF hidden symbols into locals
-L --localize-symbol <name>
Force symbol <name> to be marked as a local
--globalize-symbol <name>
Force symbol <name> to be marked as a global
-G --keep-global-symbol <name>
Localize all symbols except <name>
-W --weaken-symbol <name>
Force symbol <name> to be marked as a weak
--weaken
Force all global symbols to be marked as weak
-w --wildcard
Permit wildcard in symbol comparison
-x --discard-all
Remove all non-global symbols
-X --discard-locals
Remove any compiler-generated symbols
-i --interleave [<number>]
Only copy N out of every <number> bytes
--interleave-width <number>
Set N for --interleave
-b --byte <num>
Select byte <num> in every interleaved block
--gap-fill <val>
Fill gaps between sections with <val>
--pad-to <addr>
Pad the last section up to address <addr>
--set-start <addr>
Set the start address to <addr>
{--change-start|--adjust-start} <incr>
Add <incr> to the start address
{--change-addresses|--adjust-vma} <incr>
Add <incr> to LMA, VMA and start addresses
{--change-section-address|--adjust-section-vma} <name>{=|+|-}<val>
Change LMA and VMA of section <name> by <val>
--change-section-lma <name>{=|+|-}<val>
Change the LMA of section <name> by <val>
--change-section-vma <name>{=|+|-}<val>
Change the VMA of section <name> by <val>
{--[no-]change-warnings|--[no-]adjust-warnings}
Warn if a named section does not exist
--set-section-flags <name>=<flags>
Set section <name>'s properties to <flags>
--add-section <name>=<file>
Add section <name> found in <file> to output
--rename-section <old>=<new>[,<flags>] Rename section <old> to <new>
--long-section-names {enable|disable|keep}
Handle long section names in Coff objects.
--change-leading-char
Force output format's leading character style
--remove-leading-char
Remove leading character from global symbols
--reverse-bytes=<num>
Reverse <num> bytes at a time, in output sections with content
--redefine-sym <old>=<new>
Redefine symbol name <old> to <new>
--redefine-syms <file> --redefine-sym for all symbol pairs
listed in <file>
--srec-len <number>
Restrict the length of generated Srecords
--srec-forceS3
Restrict the type of generated Srecords to S3
--strip-symbols <file> -N for all symbols listed in <file>
--strip-unneeded-symbols <file>
--strip-unneeded-symbol for all symbols listed
in <file>
--keep-symbols <file> -K for all symbols listed in <file>
--localize-symbols <file> -L for all symbols listed in <file>
--globalize-symbols <file> --globalize-symbol for all in <file>
--keep-global-symbols <file> -G for all symbols listed in <file>
--weaken-symbols <file> -W for all symbols listed in <file>
--alt-machine-code <index>
Use the target's <index>'th alternative machine
--writable-text
Mark the output text as writable
--readonly-text
Make the output text write protected
--pure Mark the output file as demand paged
--impure
Mark the output file as impure
--prefix-symbols <prefix>
Add <prefix> to start of every symbol name
--prefix-sections <prefix>
Add <prefix> to start of every section name
--prefix-alloc-sections <prefix>
Add <prefix> to start of every allocatable
section name
--file-alignment <num>
Set PE file alignment to <num>
--heap <reserve>[,<commit>]
Set PE reserve/commit heap to <reserve>/ <commit>
--image-base <address>
Set PE image base to <address>
--section-alignment <num>
Set PE section alignment to <num>
--stack <reserve>[,<commit>]
Set PE reserve/commit stack to <reserve>/ <commit>
--subsystem <name>[:<version>]
Set PE subsystem to <name> [& <version>]
--compress-debug-sections
Compress DWARF debug sections using zlib
--decompress-debug-sections
Decompress DWARF debug sections using zlib
-v --verbose
List all object files modified
@<file>
Read options from <file>
-V --version
Display this program's version number
-h --help
Display this output
--info List object formats & architectures supported
/usr/bin/sdobjcopy: supported targets: asxxxx srec symbolsrec binary ihex
REPORTING BUGS
Report bugs to <http://sourceforge.net/tracker/?group_id=599@report_bugs_to@atid=100599>
COPYRIGHT
Copyright 2012 Free Software Foundation, Inc. This program is free software; you may
redistribute it under the terms of the GNU General Public License version 3 or (at your
option) any later version. This program has absolutely no warranty.
SEE ALSO
The full documentation for objcopy is maintained as a Texinfo manual. If the info and
objcopy programs are properly installed at your site, the command
info objcopy
should give you access to the complete manual.
OBJCOPY(1)