ruby-elf 1.0.0

data/tools/nm.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+# Copyright © 2007-2010 Diego E. "Flameeyes" Pettenò <flameeyes@gmail.com>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this generator; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+# bsd-nm implementation based on elf.rb (very limited)
+
+require 'elf'
+require 'getoptlong'
+
+opts = GetoptLong.new(
+  ["--dynamic", "-D", GetoptLong::NO_ARGUMENT],
+  ["--demangle", "-C", GetoptLong::NO_ARGUMENT]
+)
+
+scan_section = '.symtab'
+demangle = false
+
+opts.each do |opt, arg|
+  case opt
+  when '--dynamic'
+    scan_section = '.dynsym'
+  when '--demangle'
+    demangle = true
+  end
+end
+
+exitval = 0
+
+files = ARGV.length > 0 ? ARGV : ['a.out']
+
+files.each do |file|
+  begin
+    Elf::File.open(file) do |elf|
+      addrsize = (elf.elf_class == Elf::Class::Elf32 ? 8 : 16)
+
+      if not elf.has_section? scan_section
+        $stderr.puts "nm.rb: #{elf.path}: No symbols"
+        exitval = 1
+        next
+      end
+
+      elf[scan_section].each do |sym|
+        next if sym.name == ''
+        begin
+          flag = sym.nm_code
+        rescue Elf::Symbol::UnknownNMCode => e
+          $stderr.puts e.message
+          flag = "?"
+        end
+
+        version_name = sym.version
+        version_name = version_name ? "@#{sym.version_default? ? '@' : ''}#{version_name}" : ""
+
+        name = demangle ? sym.demangle : sym.name
+
+        puts "#{sym.address_string} #{flag} #{name}#{version_name}"
+      end
+    end
+  rescue Errno::ENOENT
+    $stderr.puts "nm.rb: #{file}: No such file"
+  end
+end
+
+exit exitval

data/tools/rbelf-lddtree.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+# Copyright © 2007-2010 Diego E. "Flameeyes" Pettenò <flameeyes@gmail.com>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this generator; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+# Proof of Concept tool to implement ldd-like dependency scan with
+# dependency tree. It is similar to lddtree.sh script as provided by
+# scanelf, but not the same thing.
+
+require 'elf'
+require 'elf/utils/loader'
+
+require 'set'
+
+$seen_libraries = Set.new
+
+def print_dependency_list(elf, indent_level)
+  elf[".dynamic"].needed_libraries.each_pair do |soname, lib|
+    case
+    when lib.nil?
+      puts "#{"  "*indent_level}#{soname} => not found"
+    when $seen_libraries.include?(lib.path)
+      puts "#{"  "*indent_level}#{soname} => #{lib.path} +"
+    else
+      puts "#{"  "*indent_level}#{soname} => #{lib.path}"
+      print_dependency_list(lib, indent_level+1)
+      
+      $seen_libraries |= lib.path
+    end
+  end
+end
+
+Elf::File.open(ARGV[0]) do |elf|
+  puts ARGV[0]
+  print_dependency_list(elf, 1)
+end

data/tools/readelf-d.rb

@@ -0,0 +1,76 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+# Copyright © 2007-2010 Diego E. "Flameeyes" Pettenò <flameeyes@gmail.com>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this generator; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+# readelf -d implementation based on elf.rb (very limited)
+
+require 'elf'
+require 'getoptlong'
+
+files = ARGV.length > 0 ? ARGV : ['a.out']
+
+files.each do |file|
+  puts
+  begin
+    Elf::File.open(file) do |elf|
+      dynsection = elf['.dynamic']
+
+      unless dynsection
+        puts "There is no dynamic section in this file."
+        next
+      end
+      
+      addrsize = (elf.elf_class == Elf::Class::Elf32 ? 8 : 16)
+
+      puts "Dynamic section at offset 0x#{dynsection.offset.hex} contains #{dynsection.size} entries"
+      puts "  Tag        Type                         Name/Value"
+
+      dynsection.each_entry do |entry|
+
+        case entry.type
+        when Elf::Dynamic::Type::Needed
+          val = "Shared library: [#{entry.parsed}]"
+        when Elf::Dynamic::Type::Auxiliary
+          val = "Auxiliary library: [#{entry.parsed}]"
+        when Elf::Dynamic::Type::SoName
+          val = "Library soname: [#{entry.parsed}]"
+        when Elf::Dynamic::Type::StrSz, Elf::Dynamic::Type::SymEnt,
+          Elf::Dynamic::Type::PltRelSz, Elf::Dynamic::Type::RelASz,
+          Elf::Dynamic::Type::RelAEnt
+
+          val = "#{entry.value} (bytes)"
+        when Elf::Dynamic::Type::VerDefNum, Elf::Dynamic::Type::VerNeedNum, Elf::Dynamic::Type::RelACount
+          val = entry.value
+        when Elf::Dynamic::Type::GNUPrelinked
+          val = entry.parsed.getutc.strftime('%Y-%m-%dT%H:%M:%S')
+        else
+          val = sprintf "0x%0#{addrsize}x", entry.value
+        end
+
+        printf " 0x%08x %-28s %s\n", entry.type.to_i, "(#{entry.type.to_s})", val
+
+        break if entry.type == Elf::Dynamic::Type::Null
+      end
+    end
+  rescue Errno::ENOENT
+    $stderr.puts "readelf-d.rb: '#{file}': No such file"
+    exit 1
+  end
+end
+
+exit 0
+

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-elf
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- "Diego Elio Petten\xC3\xB2"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-26 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: |
+  Ruby-Elf is a pure-Ruby library for parse and fetch information about
+  ELF format used by Linux, FreeBSD, Solaris and other Unix-like
+  operating systems, and include a set of analysis tools helpful for
+  both optimisations and verification of compiled ELF files.
+
+email: flameeyes@gmail.com
+executables: 
+- elfgrep
+- cowstats
+- verify-lfs
+- rbelf-size
+- missingstatic
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- COPYING
+- DONATING
+- bin/cowstats
+- bin/elfgrep
+- bin/missingstatic
+- bin/rbelf-size
+- bin/verify-lfs
+- extras/README.extras
+- extras/bindings-parsers.rb
+- lib/bytestream-reader.rb
+- lib/elf.rb
+- lib/elf/dynamic.rb
+- lib/elf/file.rb
+- lib/elf/gnu.rb
+- lib/elf/section.rb
+- lib/elf/stringtable.rb
+- lib/elf/sunw.rb
+- lib/elf/symbol.rb
+- lib/elf/symboltable.rb
+- lib/elf/tools.rb
+- lib/elf/utils/loader.rb
+- lib/elf/utils/pool.rb
+- lib/elf/value.rb
+- tools/assess_duplicate_save.rb
+- tools/link-collisions/analyse.rb
+- tools/link-collisions/harvest.rb
+- tools/link-collisions/known-broken
+- tools/link-collisions/multimplementations
+- tools/link-collisions/suppress.rb
+- tools/link-collisions/suppressions
+- tools/nm.rb
+- tools/rbelf-lddtree.rb
+- tools/readelf-d.rb
+- lib/elf/symbol/demangler_gcc3.rb
+- manpages/verify-lfs.1
+- manpages/elfgrep.1
+- manpages/missingstatic.1
+- manpages/cowstats.1
+- manpages/rbelf-size.1
+has_rdoc: true
+homepage: http://www.flameeyes.eu/projects/ruby-elf
+licenses: 
+- GPL-2 or later
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- none
+rubyforge_project: ruby-elf
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Pure Ruby ELF file parser and utilities
+test_files: []
+