#elf #object #symbols #mach-o #symbol-table #archive #static

build symtool

symtool edits static symbol tables of MachO and ELF object files and archives

3 releases

0.1.4 Apr 30, 2021
0.1.3 Apr 20, 2020
0.1.2 Nov 8, 2019

#616 in Build Utils

MIT/Apache

34KB
733 lines

symtool

Static symbol manipulation tool for ELF and Mach-O objects

Build Status

Installation

Manual installation

Download the latest release for your operating system.

Homebrew (macOS, Linux, Windows Subsystem for Linux)

brew tap calebzulawski/symtool http://github.com/calebzulawski/symtool.git
brew install symtool

Cargo

cargo install symtool

File type support

Supports ELF and Mach-O objects, and archives of objects.

Capability

  • Changing symbol visibility
  • Renaming symbols
  • Actions are performed in-place, leaving the rest of the binary untouched

Examples

Change symbol visibility

Hide all symbols starting with foo and expose all symbols ending in bar.

symtool --hidden "^foo" --default "bar$" input.o output.o

Rename a symbol

Rename the symbol foo to bar.

symtool --rename foo bar input.o output.o

Note: symbols are renamed in-place so the new name cannot be longer than the original.

Why use symtool?

  • Pretty fast (objects are simply patched, no regeneration or relocations necessary)
  • Supports a wide variety of unusual object formats (for example, Intel's ICC merges string tables)
  • Cross-platform method of adjusting symbol visibility of existing objects and archives (GNU ld can do this when linking, but Apple's ld64 cannot)

License

symtool is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.

Dependencies

~4–5MB
~78K SLoC