#elf #macho #symbol #static #download #object #tables #tool #latest #operating-system

app symtool

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

1 unstable release

✓ Uses Rust 2018 edition

0.1.2 Nov 8, 2019

#64 in Build Utils

MIT/Apache

13KB
269 lines

symtool

Static symbol manipulation tool for ELF and Mach-O objects

Build Status

Installation

Download the latest release for your operating system.

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

~3MB
~69K SLoC