OBJCOPY(1)

📦 version 4.5.0, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ OBJCOPY(1) — the sdobjcopy glow-up ✨

okay bestie, gather round 🫶 this is OBJCOPY(1) from the General Commands Manual, section 1, and yes it's giving very much "SDCC side quest" energy.

💖 NAME 💖

sdobjcopy — copy and translate object files. A part of SDCC.

like, it takes your object files and it copies them, and it translates them, and honestly? iconic. 👑

🦋 SYNOPSIS 🦋

sdobjcopy [option(s)] in-file [out-file]

🌸 DESCRIPTION 🌸

Copies a binary file, possibly transforming it in the process ✨ (and yes, we're doing the transformation mid-copy, main character energy fr fr).

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>. two birds, one slay 💅
  • --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 (this is the default, bestie).
  • -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.

and look at this lil receipt, it's literally the program telling you what it can do:

/usr/bin/sdobjcopy: supported targets: asxxxx srec symbolsrec binary ihex

🎀 REPORTING BUGS 🎀

Found a bug? first of all, no cap, sorry bestie 😭 Report bugs to:

<http://sourceforge.net/tracker/?group_id=599@report_bugs_to@atid=100599>

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.

⚠️ okay so "absolutely no warranty" is not a vibe, it's a fact — no warranty, periodt. don't come for them.

🌈 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. ✨ go read it, iykyk.

and that's the whole page, bestie — this is the OBJCOPY(1) page from the General Commands Manual (section 1), part of SDCC, © 2012 Free Software Foundation, Inc. 🦋💅 stay iconic, stay stripped, bye!! 🫶

📦 where this page comes from