ruby-cymbol 0.2.0

data/AUTHORS

@@ -0,0 +1,4 @@
+ruby-cymbol de tario <rseminara@hotmail.com>
+
+
+

data/CHANGELOG

@@ -0,0 +1 @@
+0.2.0	Optimized Cymbol::resolv by using a singleton of Cymbol::Resolv

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'ruby-cymbol'
+  s.version = '0.2.0'
+  s.author = 'Dario Seminara'
+  s.email = 'robertodarioseminara@gmail.com'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'Resolv libruby.so exports and debug symbols to relative offsets'
+  s.homepage = "http://github.com/tario/ruby-cymbol"
+  s.has_rdoc = true
+  s.extra_rdoc_files = [ 'README' ]
+#  s.rdoc_options << '--main' << 'README'
+  s.files = Dir.glob("{examples,lib,test}/**/*") +
+    [ 'AUTHORS', 'CHANGELOG', 'README', 'Rakefile', 'TODO' ]
+end
+
+desc 'Run tests'
+task :default => [ :test ]
+
+Rake::TestTask.new('test') do |t|
+  t.libs << 'test'
+  t.pattern = '{test}/test_*.rb'
+  t.verbose = true
+end
+
+desc 'Generate RDoc'
+Rake::RDocTask.new :rdoc do |rd|
+  rd.rdoc_dir = 'doc'
+  rd.rdoc_files.add 'lib', 'README'
+  rd.main = 'README'
+end
+
+desc 'Build Gem'
+Rake::GemPackageTask.new spec do |pkg|
+  pkg.need_tar = true
+end
+
+desc 'Clean up'
+task :clean => [ :clobber_rdoc, :clobber_package ]
+
+desc 'Clean up'
+task :clobber => [ :clean ]

data/lib/ruby-cymbol.rb

@@ -0,0 +1,108 @@
+=begin
+
+This file is part of the http://github.com/tario/ruby-cymbol project, ruby-cymbol
+
+Copyright (c) 2009-2010 Roberto Dario Seminara <robertodarioseminara@gmail.com>
+
+http://github.com/tario/ruby-cymbol 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 3 of the license, or
+(at your option) any later version.
+
+http://github.com/tario/ruby-cymbol 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 http://github.com/tario/ruby-cymbol.  if not, see <http://www.gnu.org/licenses/>.
+
+=end
+
+require "ruby-cymbol/shared"
+require "ruby-cymbol/objdump"
+require "singleton"
+
+module Cymbol
+
+  class SymbolNotFound < Exception
+
+    attr_accessor :symbol_name
+
+    def initialize( symbol_name_ )
+      self.symbol_name = symbol_name_
+    end
+  end
+
+  class ObjdumpNotFoundInSystem < Exception
+
+  end
+
+  class RubyDebugInfoNotFoundInSystem < Exception
+
+  end
+
+
+  def self.check
+    # existence of objdump
+    unless system("objdump -H > /dev/null")
+      raise ObjdumpNotFoundInSystem.new
+    end
+
+    shared_name = Cymbol.ruby_shared_name
+    debug_info_name = "/usr/lib/debug/" + shared_name
+    if File.exist?(debug_info_name)
+      shared_name = debug_info_name
+    end
+
+    unless shared_name =~ /debug/
+      raise RubyDebugInfoNotFoundInSystem.new
+    end
+
+    begin
+      Cymbol.resolv("ruby_init")
+    rescue SymbolNotFound
+      raise RubyDebugInfoNotFoundInSystem.new
+    end
+
+
+  end
+
+  class Resolv
+
+    include Singleton
+
+    def initialize
+      shared_name = Cymbol.ruby_shared_name
+
+      # Use debug info of libruby if exists
+      debug_info_name = "/usr/lib/debug/" + shared_name
+
+      if File.exist?(debug_info_name)
+        shared_name = debug_info_name
+      end
+
+      @objdump = Cymbol::Objdump.new( shared_name )
+    end
+
+    def resolv( symbol_name )
+      match_symbols = @objdump.symbols.select{|s| s.name == symbol_name }
+
+      first_symbol = match_symbols.first
+
+      unless first_symbol
+        raise SymbolNotFound.new(symbol_name)
+      end
+
+      match_symbols.first.offset
+    end
+  end
+
+  def self.resolv( symbol_name )
+    Cymbol::Resolv.instance.resolv( symbol_name )
+  end
+
+  # Check conditions at module load
+  Cymbol.check
+
+end

data/lib/ruby-cymbol/objdump.rb

@@ -0,0 +1,58 @@
+=begin
+
+This file is part of the http://github.com/tario/ruby-cymbol project, ruby-cymbol
+
+Copyright (c) 2009-2010 Roberto Dario Seminara <robertodarioseminara@gmail.com>
+
+http://github.com/tario/ruby-cymbol 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 3 of the license, or
+(at your option) any later version.
+
+http://github.com/tario/ruby-cymbol 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 http://github.com/tario/ruby-cymbol.  if not, see <http://www.gnu.org/licenses/>.
+
+=end
+
+module Cymbol
+  class Objdump
+
+    attr_accessor :symbols
+
+    class DebugSymbol
+      def initialize(name_, offset_)
+        @name = name_
+        @offset = offset_
+      end
+
+      def name
+        @name
+      end
+
+      def offset
+        @offset
+      end
+    end
+
+    def initialize(path)
+
+      self.symbols = Array.new
+  	  #build objdump command
+    	# eclipse crash with the \x60 character :S
+      objdump_output = eval("\x60objdump -t #{path}\x60")
+
+      # parse objdump output
+      objdump_output.each_line do |line|
+        words = line.split(" ")
+        if words.size > 1 then
+          self.symbols << DebugSymbol.new( words[-1], words[0].to_i(16) )
+        end
+      end
+    end
+	end
+end

data/lib/ruby-cymbol/shared.rb

@@ -0,0 +1,48 @@
+=begin
+
+This file is part of the http://github.com/tario/ruby-cymbol project, ruby-cymbol
+
+Copyright (c) 2009-2010 Roberto Dario Seminara <robertodarioseminara@gmail.com>
+
+http://github.com/tario/ruby-cymbol 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 3 of the license, or
+(at your option) any later version.
+
+http://github.com/tario/ruby-cymbol 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 http://github.com/tario/ruby-cymbol.  if not, see <http://www.gnu.org/licenses/>.
+
+=end
+
+module Cymbol
+
+  module ModuleMethods
+
+    def proc_maps
+      File.open("/proc/#{$$}/maps").each_line do |line|
+        name = line.split(" ")[-1]
+        yield(name)
+      end
+    end
+
+    def ruby_shared_name
+      proc_maps do |shared_name|
+        if shared_name =~ /libruby/
+          return shared_name
+        end
+      end
+
+      nil
+    end
+  end
+
+  class << self
+    include ModuleMethods
+  end
+
+end

data/test/test_resolv.rb

@@ -0,0 +1,25 @@
+require "test/unit"
+require "ruby-cymbol"
+
+class TestResolv < Test::Unit::TestCase
+  def test_resolv
+    # functions like rb_funcall, rb_ary_new, rb_define_module, rb_define_class must exists
+
+    ["rb_funcall", "rb_ary_new", "rb_define_module", "rb_define_class"].each do |str|
+      assert Cymbol.resolv(str).instance_of? Fixnum
+    end
+  end
+
+  def test_not_found
+    # functions like "01010101", "foo" ar NOT defined and must raise SymbolNotFound
+
+    ["010101010","foo"].each do |str|
+      assert_raise Cymbol::SymbolNotFound do
+        Cymbol.resolv(str)
+      end
+    end
+
+  end
+
+end
+

data/test/test_shared.rb

@@ -0,0 +1,17 @@
+require "test/unit"
+require "ruby-cymbol/shared"
+
+class TestSharedRead < Test::Unit::TestCase
+	def test_shared
+		assert_not_nil Cymbol.ruby_shared_name
+
+    unless Cymbol.ruby_shared_name =~ /libruby/
+      flunk "The library returned by ruby_shared_name isnt libruby"
+    end
+
+    unless File.exist?(Cymbol.ruby_shared_name)
+      flunk "The library returned by ruby_shared_name doesn't exists in the system"
+    end
+
+	end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-cymbol
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Dario Seminara
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-20 00:00:00 -03:00
+default_executable: 
+dependencies: []
+
+description: 
+email: robertodarioseminara@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- lib/ruby-cymbol/shared.rb
+- lib/ruby-cymbol/objdump.rb
+- lib/ruby-cymbol.rb
+- test/test_resolv.rb
+- test/test_shared.rb
+- AUTHORS
+- CHANGELOG
+- README
+- Rakefile
+- TODO
+has_rdoc: true
+homepage: http://github.com/tario/ruby-cymbol
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Resolv libruby.so exports and debug symbols to relative offsets
+test_files: []
+