Provided by: sdcc_4.2.0+dfsg-1_amd64 bug

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)