ileitch-hijack 0.1.2

data/README.rdoc

@@ -0,0 +1,26 @@
+= Hijack: Provides an irb session to an existing ruby process.
+
+== WARNING
+
+Hijack is new code, I'd think twice about trying it out on your critical production systems. I'd love to get some feedback though so if you have any staging systems to try it out on then please do... ;)
+
+== Intro
+
+Hijack allows you to connect to any ruby process and execute code as if it were a normal Irb session. Hijack does not require your target process to require any hijack code, Hijack is able to connect to any ruby process. It achieves this by using gdb to inject a payload into the process which starts up a DRb server, Hijack then detaches gdb and reconnects via DRb. Please note that gdb will halt your target process while it is attached, though the injection process is very quick and your process should only be halted for a few milliseconds.
+
+Hijack uses DRb over a unix socket file, so you need to be on the same machine as the process you want to hijack. This is by design for security reasons. You also need to run the hijack client as the same user as the remote process.
+
+== Using Hijack
+
+	$ ruby hijack 16451
+	=> Hijacking...
+	=> Mirroring: 100%
+	=> Hijacked 16451 (my_script.rb) (ruby 1.8.7 [i686-darwin9])
+	>>
+
+== Process Mirroring
+
+DRb cannot dump objects to the Hijack client for types that are not loaded in the client process. E.g if the remote process had required ActiveRecord and you tried to dump ActiveRecord::Base back to the client, DRb would instead return a DRb::Unknown object as ActiveRecord
+isn't loaded in the Hijack client.
+
+To work around this, when Hijack connects to a remote process it will inspect all the files required by the process and also attempt to require them itself. This may not work for all object types however so you may still get a warning when an object cannot be dumped.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+spec = eval(File.read('hijack.gemspec'))
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+

data/TODO

@@ -0,0 +1,6 @@
+* Use thread local stdout & stderr capture.
+* assigning a variable doesn't work
+* Improve startup experience
+* Check if attached process is in fact a ruby process
+* Require actual remote script if possible so that if it defines any classes we can dump those too.
+* (eval):211: [BUG] object allocation during garbage collection phase

data/bin/hijack

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+require 'optparse'
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'hijack'
+
+options = {}
+ARGV.clone.options do |opts|
+  opts.banner = 'Usage: hijack [options] <PID>'
+  opts.on("--gdb-debug", "Print gdb activity to the console.") { |v| options[:gdb_debug] = v }
+  opts.on("-h", "--help", "Show this help message.") { puts opts; exit }
+  opts.parse!
+end
+
+Hijack.start(ARGV.last, options)

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification 
+name: ileitch-hijack
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Ian Leitch
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Provides an irb session to an existing ruby process.
+email: ian.leitch@systino.net
+executables: 
+- hijack
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- TODO
+files: 
+- README.rdoc
+- Rakefile
+- TODO
+has_rdoc: true
+homepage: http://github.com/ileitch/hijack
+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: 2
+summary: Provides an irb session to an existing ruby process.
+test_files: []
+