BFD (Binary File Descriptor)

A Ruby C extension (and gem) for the GNU Binutils libbfd library.

Note: this is not a complete implementation of the BFD API; it is only intended for use with the Opcodes or Opdis Ruby extensions.

BUILD

---

The standard C extension build process is used:

bash# ruby extconf.rb bash# make

Note that the Ruby headers must be installed. On Ubuntu, these are in the ruby-dev or ruby1.9-dev package.

The gem is built using the standard gem build command:

bash# gem build Bfd.gemspec

The top-level Makefile supports each of these builds with the commands ‘make’ and ‘make gem’.

bash# make # builds C extension bash# make gem # builds the gem

EXAMPLES

Extended examples are provided in the ‘examples’ directory. The following code snippets give a brief overview of using the BFD extension.

require ‘BFD’

t = Bfd::Target.new(‘/tmp/a.out’) t.symbols.values.each { |sym| puts sym }

Bfd::Target.new(‘/tmp/a.out’) do |tgt| tgt.sections.each { |name, sec| puts sec } end