crash-watch 1.1.12 → 1.2.0

data/bin/crash-watch

@@ -1,88 +1,25 @@
 #!/usr/bin/env ruby
-# encoding: binary
-require 'optparse'
+# Copyright (c) 2010-2016 Phusion Holding B.V.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-options = {}
-parser = OptionParser.new do |opts|
-	opts.banner = "Usage: crash-watch [options] PID"
-	opts.separator ""
-	
-	opts.separator "Options:"
-	opts.on("-d", "--debug", "Show GDB commands that crash-watch sends.") do
-		options[:debug] = true
-	end
-	opts.on("--dump", "Dump current process backtrace and exit immediately.") do
-		options[:dump] = true
-	end
-	opts.on("-v", "--version", "Show version number.") do
-		options[:version] = true
-	end
-	opts.on("-h", "--help", "Show this help message.") do
-		options[:help] = true
-	end
-end
-begin
-	parser.parse!
-rescue OptionParser::ParseError => e
-	puts e
-	puts
-	puts "Please see '--help' for valid options."
-	exit 1
-end
-
-if options[:help]
-	puts parser
-	exit
-elsif options[:version]
-	require 'crash_watch/version'
-	puts "crash-watch version #{CrashWatch::VERSION_STRING}"
-	exit
-elsif ARGV.size != 1
-	puts parser
-	exit 1
-end
-
-$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
-require 'crash_watch/gdb_controller'
-begin
-	gdb = CrashWatch::GdbController.new
-rescue CrashWatch::Error => e
-	abort e.message
-end
-begin
-	gdb.debug = options[:debug]
-	
-	# Ruby sometimes uses SIGVTARLM for thread scheduling.
-	gdb.execute("handle SIGVTALRM noprint pass")
-	
-	if gdb.attach(ARGV[0])
-		if options[:dump]
-			puts "Current thread (#{gdb.current_thread}) backtrace:"
-			puts "    " << gdb.current_thread_backtrace.gsub(/\n/, "\n    ")
-			puts
-			puts "All thread backtraces:"
-			puts "    " << gdb.all_threads_backtraces.gsub(/\n/, "\n    ")
-		else
-			puts "Monitoring PID #{ARGV[0]}..."
-			exit_info = gdb.wait_until_exit
-			puts "Process exited at #{Time.now}."
-			puts "Exit code: #{exit_info.exit_code}" if exit_info.exit_code
-			puts "Signal: #{exit_info.signal}" if exit_info.signaled?
-			if exit_info.backtrace
-				puts "Backtrace:"
-				puts "    " << exit_info.backtrace.gsub(/\n/, "\n    ")
-			end
-		end
-	else
-		puts "ERROR: Cannot attach to process."
-		if File.exist?("/proc/sys/kernel/yama/ptrace_scope")
-			puts
-			puts "This may be the result of kernel ptrace() hardening. Try disabling it with:"
-			puts "  sudo sh -c 'echo 0 > /proc/sys/kernel/yama/ptrace_scope'"
-			puts "See http://askubuntu.com/questions/41629/after-upgrade-gdb-wont-attach-to-process for more information."
-		end
-		exit 2
-	end
-ensure
-	gdb.close
-end
+$LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), "..", "lib")))
+require 'crash_watch/app'
+CrashWatch::App.new.run(ARGV)

data/crash-watch.gemspec

@@ -2,18 +2,16 @@ require File.expand_path('lib/crash_watch/version', File.dirname(__FILE__))
 require File.expand_path('lib/crash_watch/packaging', File.dirname(__FILE__))
 
 Gem::Specification.new do |s|
-	s.name = "crash-watch"
-	s.version = CrashWatch::VERSION_STRING
-	s.authors = ["Hongli Lai"]
-	s.description = "Monitor processes and display useful information when they crash."
-	s.summary = "Monitor processes and display useful information when they crash"
-	s.email = "software-signing@phusion.nl"
-	s.files = Dir[*CRASH_WATCH_FILES]
-	s.homepage = "https://github.com/FooBarWidget/crash-watch"
-	s.rdoc_options = ["--charset=UTF-8"]
-	s.executables = ["crash-watch"]
-	s.require_paths = ["lib"]
-	s.add_development_dependency("ffi")
-	s.add_development_dependency("rspec")
+  s.name = "crash-watch"
+  s.version = CrashWatch::VERSION_STRING
+  s.authors = ["Hongli Lai"]
+  s.description = "Monitor processes and display useful information when they crash."
+  s.summary = "Monitor processes and display useful information when they crash"
+  s.email = "software-signing@phusion.nl"
+  s.files = Dir[*CRASH_WATCH_FILES]
+  s.homepage = "https://github.com/FooBarWidget/crash-watch"
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.executables = ["crash-watch"]
+  s.require_paths = ["lib"]
 end
 

data/lib/crash_watch/app.rb

@@ -0,0 +1,138 @@
+# encoding: binary
+#
+# Copyright (c) 2010-2016 Phusion Holding B.V.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'optparse'
+require 'crash_watch/gdb_controller'
+require 'crash_watch/lldb_controller'
+require 'crash_watch/version'
+
+module CrashWatch
+  class App
+    def run(argv)
+      options = {}
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: crash-watch [options] PID"
+        opts.separator ""
+
+        opts.separator "Options:"
+        opts.on("-d", "--debug", "Show GDB commands that crash-watch sends.") do
+          options[:debug] = true
+        end
+        opts.on("--dump", "Dump current process backtrace and exit immediately.") do
+          options[:dump] = true
+        end
+        opts.on("-v", "--version", "Show version number.") do
+          options[:version] = true
+        end
+        opts.on("-h", "--help", "Show this help message.") do
+          options[:help] = true
+        end
+      end
+      begin
+        parser.parse!(argv)
+      rescue OptionParser::ParseError => e
+        puts e
+        puts
+        puts "Please see '--help' for valid options."
+        exit 1
+      end
+
+      if options[:help]
+        puts parser
+        exit
+      elsif options[:version]
+        puts "crash-watch version #{CrashWatch::VERSION_STRING}"
+        exit
+      elsif argv.size != 1
+        puts parser
+        exit 1
+      end
+
+      begin
+        if !CrashWatch::Utils.gdb_installed? && CrashWatch::Utils.lldb_installed?
+          gdb = CrashWatch::LldbController.new
+        else
+          gdb = CrashWatch::GdbController.new
+        end
+      rescue CrashWatch::Error => e
+        abort e.message
+      end
+      begin
+        gdb.debug = options[:debug]
+
+        # Ruby sometimes uses SIGVTARLM for thread scheduling.
+        gdb.execute("handle SIGVTALRM noprint pass")
+
+        if gdb.attach(argv[0])
+          if options[:dump]
+            puts "*******************************************************"
+            puts "*"
+            puts "*    Current thread (#{gdb.current_thread}) backtrace"
+            puts "*"
+            puts "*******************************************************"
+            puts
+            puts "    " << gdb.current_thread_backtrace.gsub(/\n/, "\n    ")
+            puts
+            puts
+            puts "*******************************************************"
+            puts "*"
+            puts "*    All thread backtraces"
+            puts "*"
+            puts "*******************************************************"
+            puts
+            output = gdb.all_threads_backtraces
+            output.gsub!(/\n/, "\n    ")
+            output.insert(0, "    ")
+            output.gsub!(/^    (Thread .*):$/, "########### \\1 ###########\n")
+            puts output
+          else
+            if gdb.respond_to?(:wait_until_exit)
+              puts "Monitoring PID #{argv[0]}..."
+              exit_info = gdb.wait_until_exit
+              puts "Process exited at #{Time.now}."
+              puts "Exit code: #{exit_info.exit_code}" if exit_info.exit_code
+              puts "Signal: #{exit_info.signal}" if exit_info.signaled?
+              if exit_info.backtrace
+                puts "Backtrace:"
+                puts "    " << exit_info.backtrace.gsub(/\n/, "\n    ")
+              end
+            else
+              abort "ERROR: monitoring not supported with LLDB"
+            end
+          end
+        else
+          puts "ERROR: Cannot attach to process."
+          if File.exist?("/proc/sys/kernel/yama/ptrace_scope")
+            puts
+            puts "This may be the result of kernel ptrace() hardening. Try disabling it with:"
+            puts "  sudo sh -c 'echo 0 > /proc/sys/kernel/yama/ptrace_scope'"
+            puts "See http://askubuntu.com/questions/41629/after-upgrade-gdb-wont-attach-to-process for more information."
+          end
+          exit 2
+        end
+      ensure
+        gdb.close
+      end
+    end
+  end
+end

data/lib/crash_watch/base.rb

@@ -0,0 +1,25 @@
+# Copyright (c) 2016 Phusion Holding B.V.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+module CrashWatch
+  class Error < StandardError
+  end
+end

data/lib/crash_watch/gdb_controller.rb

@@ -1,321 +1,277 @@
 # encoding: binary
+#
+# Copyright (c) 2010-2016 Phusion Holding B.V.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
 require 'rbconfig'
+require 'crash_watch/base'
+require 'crash_watch/utils'
 
 module CrashWatch
+  class GdbNotFound < Error
+  end
 
-class Error < StandardError
-end
+  class GdbBroken < Error
+  end
 
-class GdbNotFound < Error
-end
+  class GdbController
+    class ExitInfo
+      attr_reader :exit_code, :signal, :backtrace, :snapshot
 
-class GdbBroken < Error
-end
+      def initialize(exit_code, signal, backtrace, snapshot)
+        @exit_code = exit_code
+        @signal = signal
+        @backtrace = backtrace
+        @snapshot = snapshot
+      end
 
-class GdbController
-	class ExitInfo
-		attr_reader :exit_code, :signal, :backtrace, :snapshot
-		
-		def initialize(exit_code, signal, backtrace, snapshot)
-			@exit_code = exit_code
-			@signal = signal
-			@backtrace = backtrace
-			@snapshot = snapshot
-		end
-		
-		def signaled?
-			!!@signal
-		end
-	end
-	
-	END_OF_RESPONSE_MARKER = '--------END_OF_RESPONSE--------'
-	
-	attr_accessor :debug
+      def signaled?
+        !!@signal
+      end
+    end
 
-	def initialize
-		@pid, @in, @out = popen_command(find_gdb, "-n", "-q")
-		execute("set prompt ")
-	end
-	
-	def execute(command_string, timeout = nil)
-		raise "GDB session is already closed" if !@pid
-		puts "gdb write #{command_string.inspect}" if @debug
-		@in.puts(command_string)
-		@in.puts("echo \\n#{END_OF_RESPONSE_MARKER}\\n")
-		done = false
-		result = ""
-		while !done
-			begin
-				if select([@out], nil, nil, timeout)
-					line = @out.readline
-					puts "gdb read #{line.inspect}" if @debug
-					if line == "#{END_OF_RESPONSE_MARKER}\n"
-						done = true
-					else
-						result << line
-					end
-				else
-					close!
-					done = true
-					result = nil
-				end
-			rescue EOFError
-				done = true
-			end
-		end
-		return result
-	end
-	
-	def closed?
-		return !@pid
-	end
-	
-	def close
-		if !closed?
-			begin
-				execute("detach", 5)
-				execute("quit", 5) if !closed?
-			rescue Errno::EPIPE
-			end
-			if !closed?
-				@in.close
-				@out.close
-				Process.waitpid(@pid)
-				@pid = nil
-			end
-		end
-	end
-	
-	def close!
-		if !closed?
-			@in.close
-			@out.close
-			Process.kill('KILL', @pid)
-			Process.waitpid(@pid)
-			@pid = nil
-		end
-	end
-	
-	def attach(pid)
-		pid = pid.to_s.strip
-		raise ArgumentError if pid.empty?
-		result = execute("attach #{pid}")
-		return result !~ /(No such process|Unable to access task|Operation not permitted)/
-	end
-	
-	def call(code)
-		result = execute("call #{code}")
-		result =~ /= (.*)$/
-		return $1
-	end
-	
-	def program_counter
-		return execute("p/x $pc").gsub(/.* = /, '')
-	end
-	
-	def current_thread
-		execute("thread") =~ /Current thread is (.+?) /
-		return $1
-	end
-	
-	def current_thread_backtrace
-		return execute("bt full").strip
-	end
-	
-	def all_threads_backtraces
-		return execute("thread apply all bt full").strip
-	end
-	
-	def ruby_backtrace
-		filename = "/tmp/gdb-capture.#{@pid}.txt"
-		
-		orig_stdout_fd_copy = call("(int) dup(1)")
-		new_stdout = call(%Q{(void *) fopen("#{filename}", "w")})
-		new_stdout_fd = call("(int) fileno(#{new_stdout})")
-		call("(int) dup2(#{new_stdout_fd}, 1)")
-		
-		# Let's hope stdout is set to line buffered or unbuffered mode...
-		call("(void) rb_backtrace()")
-		
-		call("(int) dup2(#{orig_stdout_fd_copy}, 1)")
-		call("(int) fclose(#{new_stdout})")
-		call("(int) close(#{orig_stdout_fd_copy})")
-		
-		if File.exist?(filename)
-			result = File.read(filename)
-			result.strip!
-			if result.empty?
-				return nil
-			else
-				return result
-			end
-		else
-			return nil
-		end
-	ensure
-		if filename
-			File.unlink(filename) rescue nil
-		end
-	end
-	
-	def wait_until_exit
-		execute("break _exit")
-		
-		signal = nil
-		backtraces = nil
-		snapshot = nil
-		
-		while true
-			result = execute("continue")
-			if result =~ /^Program received signal (.+?),/
-				signal = $1
-				backtraces = execute("thread apply all bt full").strip
-				if backtraces.empty?
-					backtraces = execute("bt full").strip
-				end
-				snapshot = yield(self) if block_given?
-				
-				# This signal may or may not be immediately fatal; the
-				# signal might be ignored by the process, or the process
-				# has some clever signal handler that fixes the state,
-				# or maybe the signal handler must run some cleanup code
-				# before killing the process. Let's find out by running
-				# the next machine instruction.
-				old_program_counter = program_counter
-				result = execute("stepi")
-				if result =~ /^Program received signal .+?,/
-					# Yes, it was fatal. Here we don't care whether the
-					# instruction caused a different signal. The last
-					# one is probably what we're interested in.
-					return ExitInfo.new(nil, signal, backtraces, snapshot)
-				elsif result =~ /^Program (terminated|exited)/ || result =~ /^Breakpoint .*? _exit/
-					# Running the next instruction causes the program to terminate.
-					# Not sure what's going on but the previous signal and
-					# backtrace is probably what we're interested in.
-					return ExitInfo.new(nil, signal, backtraces, snapshot)
-				elsif old_program_counter == program_counter
-					# The process cannot continue but we're not sure what GDB
-					# is telling us.
-					raise "Unexpected GDB output: #{result}"
-				end
-				# else:
-				# The signal doesn't isn't immediately fatal, so save current
-				# status, continue, and check whether the process exits later.
-			elsif result =~ /^Program terminated with signal (.+?),/
-				if $1 == signal
-					# Looks like the signal we trapped earlier
-					# caused an exit.
-					return ExitInfo.new(nil, signal, backtraces, snapshot)
-				else
-					return ExitInfo.new(nil, signal, nil, snapshot)
-				end
-			elsif result =~ /^Breakpoint .*? _exit /
-				backtraces = execute("thread apply all bt full").strip
-				if backtraces.empty?
-					backtraces = execute("bt full").strip
-				end
-				snapshot = yield(self) if block_given?
-				# On OS X, gdb may fail to return from the 'continue' command
-				# even though the process exited. Kernel bug? In any case,
-				# we put a timeout here so that we don't wait indefinitely.
-				result = execute("continue", 10)
-				if result =~ /^Program exited with code (\d+)\.$/
-					return ExitInfo.new($1.to_i, nil, backtraces, snapshot)
-				elsif result =~ /^Program exited normally/
-					return ExitInfo.new(0, nil, backtraces, snapshot)
-				else
-					return ExitInfo.new(nil, nil, backtraces, snapshot)
-				end
-			elsif result =~ /^Program exited with code (\d+)\.$/
-				return ExitInfo.new($1.to_i, nil, nil, nil)
-			elsif result =~ /^Program exited normally/
-				return ExitInfo.new(0, nil, nil, nil)
-			else
-				return ExitInfo.new(nil, nil, nil, nil)
-			end
-		end
-	end
-	
-private
-	def popen_command(*command)
-		a, b = IO.pipe
-		c, d = IO.pipe
-		if Process.respond_to?(:spawn)
-			args = command.dup
-			args << {
-				STDIN  => a,
-				STDOUT => d,
-				STDERR => d,
-				:close_others => true
-			}
-			pid = Process.spawn(*args)
-		else
-			pid = fork do
-				STDIN.reopen(a)
-				STDOUT.reopen(d)
-				STDERR.reopen(d)
-				b.close
-				c.close
-				exec(*command)
-			end
-		end
-		a.close
-		d.close
-		b.binmode
-		c.binmode
-		return [pid, b, c]
-	end
+    END_OF_RESPONSE_MARKER = '--------END_OF_RESPONSE--------'
 
-	def find_gdb
-		result = nil
-		if ENV['GDB'] && File.executable?(ENV['GDB'])
-			result = ENV['GDB']
-		else
-			ENV['PATH'].to_s.split(/:+/).each do |path|
-				filename = "#{path}/gdb"
-				if File.file?(filename) && File.executable?(filename)
-					result = filename
-					break
-				end
-			end
-		end
+    attr_accessor :debug
 
-		puts "Found gdb at: #{result}" if result
+    def initialize
+      @pid, @in, @out = Utils.popen_command(find_gdb, "-n", "-q")
+      execute("set prompt ")
+    end
 
-		config = defined?(RbConfig) ? RbConfig::CONFIG : Config::CONFIG
-		if config['target_os'] =~ /freebsd/ && result == "/usr/bin/gdb"
-			# /usr/bin/gdb on FreeBSD is broken:
-			# https://github.com/FooBarWidget/crash-watch/issues/1
-			# Look for a newer one that's installed from ports.
-			puts "#{result} is broken on FreeBSD. Looking for an alternative..."
-			result = nil
-			["/usr/local/bin/gdb76", "/usr/local/bin/gdb66"].each do |candidate|
-				if File.executable?(candidate)
-					result = candidate
-					break
-				end
-			end
+    def execute(command_string, timeout = nil)
+      raise "GDB session is already closed" if !@pid
+      puts "gdb write #{command_string.inspect}" if @debug
+      @in.puts(command_string)
+      @in.puts("echo \\n#{END_OF_RESPONSE_MARKER}\\n")
+      done = false
+      result = ""
+      while !done
+        begin
+          if select([@out], nil, nil, timeout)
+            line = @out.readline
+            puts "gdb read #{line.inspect}" if @debug
+            if line == "#{END_OF_RESPONSE_MARKER}\n"
+              done = true
+            else
+              result << line
+            end
+          else
+            close!
+            done = true
+            result = nil
+          end
+        rescue EOFError
+          done = true
+        end
+      end
+      result
+    end
 
-			if result.nil?
-				raise GdbBroken,
-					"*** ERROR ***: '/usr/bin/gdb' is broken on FreeBSD. " +
-					"Please install the one from the devel/gdb port instead. " +
-					"If you want to use another gdb"
-			else
-				puts "Found gdb at: #{result}" if result
-				return result
-			end
-		elsif result.nil?
-			raise GdbNotFound,
-				"*** ERROR ***: 'gdb' isn't installed. Please install it first.\n" +
-				"       Debian/Ubuntu: sudo apt-get install gdb\n" +
-				"RedHat/CentOS/Fedora: sudo yum install gdb\n" +
-				"            Mac OS X: please install the Developer Tools or XCode\n" +
-				"             FreeBSD: use the devel/gdb port\n"
-		else
-			return result
-		end
-	end
-end
+    def closed?
+      !@pid
+    end
+
+    def close
+      if !closed?
+        begin
+          execute("detach", 5)
+          execute("quit", 5) if !closed?
+        rescue Errno::EPIPE
+        end
+        if !closed?
+          @in.close
+          @out.close
+          Process.waitpid(@pid)
+          @pid = nil
+        end
+      end
+    end
+
+    def close!
+      if !closed?
+        @in.close
+        @out.close
+        Process.kill('KILL', @pid)
+        Process.waitpid(@pid)
+        @pid = nil
+      end
+    end
+
+    def attach(pid)
+      pid = pid.to_s.strip
+      raise ArgumentError if pid.empty?
+      result = execute("attach #{pid}")
+      result !~ /(No such process|Unable to access task|Operation not permitted)/
+    end
+
+    def program_counter
+      execute("p/x $pc").gsub(/.* = /, '')
+    end
+
+    def current_thread
+      execute("thread") =~ /Current thread is (.+?) /
+      $1
+    end
 
-end
+    def current_thread_backtrace
+      execute("bt full").strip
+    end
+
+    def all_threads_backtraces
+      execute("thread apply all bt full").strip
+    end
+
+    def wait_until_exit
+      execute("break _exit")
+
+      signal = nil
+      backtraces = nil
+      snapshot = nil
+
+      while true
+        result = execute("continue")
+        if result =~ /^(Program|Thread .*) received signal (.+?),/
+          signal = $2
+          backtraces = execute("thread apply all bt full").strip
+          if backtraces.empty?
+            backtraces = execute("bt full").strip
+          end
+          snapshot = yield(self) if block_given?
+
+          # This signal may or may not be immediately fatal; the
+          # signal might be ignored by the process, or the process
+          # has some clever signal handler that fixes the state,
+          # or maybe the signal handler must run some cleanup code
+          # before killing the process. Let's find out by running
+          # the next machine instruction.
+          old_program_counter = program_counter
+          result = execute("stepi")
+          if result =~ /^(Program|Thread .*) received signal .+?,/
+            # Yes, it was fatal. Here we don't care whether the
+            # instruction caused a different signal. The last
+            # one is probably what we're interested in.
+            return ExitInfo.new(nil, signal, backtraces, snapshot)
+          elsif result =~ /^Program (terminated|exited)/ || result =~ /^Breakpoint .*? (__GI_)?_exit/
+            # Running the next instruction causes the program to terminate.
+            # Not sure what's going on but the previous signal and
+            # backtrace is probably what we're interested in.
+            return ExitInfo.new(nil, signal, backtraces, snapshot)
+          elsif old_program_counter == program_counter
+            # The process cannot continue but we're not sure what GDB
+            # is telling us.
+            raise "Unexpected GDB output: #{result}"
+          end
+          # else:
+          # The signal doesn't isn't immediately fatal, so save current
+          # status, continue, and check whether the process exits later.
+        elsif result =~ /^Program terminated with signal (.+?),/
+          if $1 == signal
+            # Looks like the signal we trapped earlier
+            # caused an exit.
+            return ExitInfo.new(nil, signal, backtraces, snapshot)
+          else
+            return ExitInfo.new(nil, signal, nil, snapshot)
+          end
+        elsif result =~ /Breakpoint .*? (__GI_)?_exit (\(status=(\d+)\))?/
+          status_param = $3
+          backtraces = execute("thread apply all bt full").strip
+          if backtraces.empty?
+            backtraces = execute("bt full").strip
+          end
+          snapshot = yield(self) if block_given?
+          # On OS X, gdb may fail to return from the 'continue' command
+          # even though the process exited. Kernel bug? In any case,
+          # we put a timeout here so that we don't wait indefinitely.
+          result = execute("continue", 10)
+          if result =~ /^(Program|.*process .*) exited with code (\d+)/
+            return ExitInfo.new($2.to_i, nil, backtraces, snapshot)
+          elsif result =~ /^(Program|.*process .*) exited normally/
+            return ExitInfo.new(0, nil, backtraces, snapshot)
+          elsif status_param.nil? || status_param.empty?
+            return ExitInfo.new(nil, nil, backtraces, snapshot)
+          else
+            return ExitInfo.new(status_param.to_i, nil, backtraces, snapshot)
+          end
+        elsif result =~ /^(Program|.*process .*) exited with code (\d+)\.$/
+          return ExitInfo.new($2.to_i, nil, nil, nil)
+        elsif result =~ /^(Program|.*process .*) exited normally/
+          return ExitInfo.new(0, nil, nil, nil)
+        else
+          return ExitInfo.new(nil, nil, nil, nil)
+        end
+      end
+    end
+
+  private
+    def find_gdb
+      result = nil
+      if ENV['GDB'] && File.executable?(ENV['GDB'])
+        result = ENV['GDB']
+      else
+        ENV['PATH'].to_s.split(/:+/).each do |path|
+          filename = "#{path}/gdb"
+          if File.file?(filename) && File.executable?(filename)
+            result = filename
+            break
+          end
+        end
+      end
+
+      puts "Found gdb at: #{result}" if result
+
+      config = defined?(RbConfig) ? RbConfig::CONFIG : Config::CONFIG
+      if config['target_os'] =~ /freebsd/ && result == "/usr/bin/gdb"
+        # /usr/bin/gdb on FreeBSD is broken:
+        # https://github.com/FooBarWidget/crash-watch/issues/1
+        # Look for a newer one that's installed from ports.
+        puts "#{result} is broken on FreeBSD. Looking for an alternative..."
+        result = nil
+        ["/usr/local/bin/gdb76", "/usr/local/bin/gdb66"].each do |candidate|
+          if File.executable?(candidate)
+            result = candidate
+            break
+          end
+        end
+
+        if result.nil?
+          raise GdbBroken,
+            "*** ERROR ***: '/usr/bin/gdb' is broken on FreeBSD. " +
+            "Please install the one from the devel/gdb port instead. " +
+            "If you want to use another gdb"
+        else
+          puts "Found gdb at: #{result}" if result
+          result
+        end
+      elsif result.nil?
+        raise GdbNotFound,
+          "*** ERROR ***: 'gdb' not found. Please install it (and if using Nginx " +
+          "ensure that PATH isn't filtered out, see also its \"env\" option).\n" +
+          "       Debian/Ubuntu: sudo apt-get install gdb\n" +
+          "RedHat/CentOS/Fedora: sudo yum install gdb\n" +
+          "            Mac OS X: please install the Developer Tools or XCode\n" +
+          "             FreeBSD: use the devel/gdb port\n"
+      else
+        result
+      end
+    end
+  end
+end