rb8-trepanning 0.1.3-universal-ruby-1.9.2

data/processor/mock.rb

@@ -0,0 +1,136 @@
+# Copyright (C) 2010, 2011 Rocky Bernstein <rockyb@rubyforge.net>
+# Mock setup for commands.
+require 'rubygems'; require 'require_relative'
+require_relative 'virtual'
+
+# require_relative '../app/core'
+require_relative '../app/default'
+require_relative '../interface/user'  # user interface (includes I/O)
+
+require 'ruby-debug-base'; Debugger.start(:init => true)
+require_relative 'processor'
+
+module MockDebugger
+  class MockDebugger
+    attr_accessor :trace_filter # Procs/Methods we ignore.
+
+    attr_accessor :frame        # Actually a "Rubinius::Location object
+    attr_accessor :core         # access to Debugger::Core instance
+    attr_accessor :intf         # The way the outside world interfaces with us.
+    attr_reader   :initial_dir  # String. Current directory when program
+                                # started. Used in restart program.
+    attr_accessor :restart_argv # How to restart us, empty or nil. 
+                                # Note restart[0] is typically $0.
+    attr_reader   :settings     # Hash[:symbol] of things you can configure
+    attr_accessor :processor
+
+    # FIXME: move more stuff of here and into Trepan::CmdProcessor
+    # These below should go into Trepan::CmdProcessor.
+    attr_reader :cmd_argstr, :cmd_name, :current_frame, :completion_proc
+
+    def initialize(settings={:start_frame=>1})
+      @before_cmdloop_hooks = []
+      @settings             = Trepan::DEFAULT_SETTINGS.merge(settings)
+      @intf                 = [Trepan::UserInterface.new(nil, nil,
+                                                         :history_save=>false)]
+      # @current_frame        = Trepan::Frame.new(context)
+      @frames               = []
+
+      @trace_filter         = []
+
+      @completion_proc = Proc.new{|str| str}
+
+      # Don't allow user commands in mocks.
+      ## @core.processor.settings[:user_cmd_dir] = nil 
+
+    end
+
+    def frame(num)
+      @frames[num] ||= caller
+    end
+  end
+
+  # Common Mock debugger setup 
+  def setup(name=nil, show_constants=true)
+    unless name
+      file = caller.first.split(/:\d/,2).first
+      name = File.basename(File.basename(file), '.rb')
+    end
+
+    if ARGV.size > 0 && ARGV[0] == 'debug'
+      require_relative '../lib/trepanning'
+      dbgr = Trepan.new
+      dbgr.debugger
+    else
+      dbgr = MockDebugger.new(:start_frame=>2)
+    end
+
+    cmdproc = Trepan::CmdProcessor.new(dbgr.intf)
+    state = Trepan::CommandProcessor::State.new(self) do |s|
+      s.context = Debugger.current_context
+      s.binding = binding
+    end
+    cmdproc.frame_setup(state.context, state)
+    dbgr.processor = cmdproc
+    
+    cmdproc.interfaces = dbgr.intf
+    cmdproc.load_cmds_initialize
+    cmds = cmdproc.commands
+    cmd  = cmds[name]
+    ## cmd.proc.frame_setup
+    ## cmd.proc.event = 'debugger-call'
+    show_special_class_constants(cmd) if show_constants
+
+    def cmd.confirm(prompt, default)
+      true
+    end
+    def cmd.msg_nocr(message, opts={})
+      print message
+    end
+
+    return dbgr, cmd
+  end
+  module_function :setup
+
+  def sub_setup(sub_class, run=true)
+    sub_name = sub_class.const_get('PREFIX')
+    dbgr, cmd = setup(sub_name[0], false)
+    sub_cmd = sub_class.new(cmd)
+    sub_cmd.summary_help(sub_cmd.name)
+    puts
+    sub_cmd.run([cmd.name]) if run
+    return sub_cmd
+  end
+  module_function :sub_setup
+
+  def subsub_setup(sub_class, subsub_class, run=true)
+    subsub_name = subsub_class.const_get('PREFIX')
+    dbgr, cmd = setup(subsub_name[0], false)
+    sub_cmd = sub_class.new(dbgr.processor, cmd)
+    subsub_cmd = subsub_class.new(cmd.proc, sub_cmd, subsub_name.join(''))
+    subsub_cmd.run([subsub_cmd.name]) if run
+    return subsub_cmd
+  end
+  module_function :subsub_setup
+
+  def show_special_class_constants(cmd)
+    puts 'ALIASES: %s' % [cmd.class.const_get('ALIASES').inspect] if
+      cmd.class.constants.member?(:ALIASES)
+    %w(CATEGORY MIN_ARGS MAX_ARGS 
+       NAME NEED_STACK SHORT_HELP).each do |name|
+      puts '%s: %s' % [name, cmd.class.const_get(name).inspect]
+    end
+    puts '-' * 30
+    puts cmd.class.const_get('HELP')
+    puts '=' * 30
+  end
+  module_function :show_special_class_constants
+
+end
+
+if __FILE__ == $0
+  dbgr = MockDebugger::MockDebugger.new
+  p dbgr.settings
+  puts '=' * 10
+  # p dbgr.core.processor.settings
+end

data/processor/msg.rb

@@ -0,0 +1,61 @@
+# Copyright (C) 2010, 2011 Rocky Bernstein <rockyb@rubyforge.net>
+# I/O related command processor methods
+require 'rubygems'; require 'require_relative'
+require_relative '../app/util'
+require_relative 'virtual'
+module Trepan
+  class CmdProcessor < VirtualCmdProcessor
+    attr_accessor :ruby_highlighter
+
+    def errmsg(message, opts={})
+      message = safe_rep(message) unless opts[:unlimited]
+      if @settings[:highlight] && defined?(Term::ANSIColor)
+        message = 
+          Term::ANSIColor.italic + message + Term::ANSIColor.reset 
+      end
+      @intf.errmsg(message)
+    end
+
+    def msg(message, opts={})
+      message = safe_rep(message) unless opts[:unlimited]
+      @intf.msg(message)
+    end
+
+    def msg_nocr(message, opts={})
+      message = safe_rep(message) unless opts[:unlimited]
+      @intf.msg_nocr(message)
+    end
+
+    def read_command()
+      @intf.read_command(@prompt)
+    end
+
+    def ruby_format(text)
+      return text unless settings[:highlight]
+      unless @ruby_highlighter
+        begin
+          require 'coderay'
+          require 'term/ansicolor'
+          @ruby_highlighter = CodeRay::Duo[:ruby, :term]
+        rescue LoadError
+          return text
+        end
+      end
+      return @ruby_highlighter.encode(text)
+    end
+
+    def safe_rep(str)
+      Util::safe_repr(str, @settings[:maxstring])
+    end
+
+    def section(message, opts={})
+      message = safe_rep(message) unless opts[:unlimited]
+      if @settings[:highlight] && defined?(Term::ANSIColor)
+        message = 
+          Term::ANSIColor.bold + message + Term::ANSIColor.reset 
+      end
+      @intf.msg(message)
+    end
+
+  end
+end

data/processor/processor.rb

@@ -0,0 +1,674 @@
+require 'rubygems'
+require 'ruby-debug-base'
+require 'require_relative'
+require_relative '../interface/user'
+require_relative './command'
+require_relative './default'
+require_relative './main'
+require_relative '../app/frame'
+
+# _Trepan_ is the module name space for this debugger.
+module Trepan
+
+  # A processor handles the kind of front-end to program interaction.
+  # Debugger::Processor is the the base class with subclasses
+  # Debugger::CommandProcessor and Debugger::ControlCommandProcessor.
+  class Processor
+    attr_accessor :interface
+    attr_reader   :processor
+    attr_reader   :commands
+
+    attr_accessor :frame   # FIXME: move to frame.rb
+
+    # optional argument passed passed in callback. For catchpoints it is
+    # the catch object. For breakpoints it is the breakpoint object.
+    attr_reader   :event_arg
+
+    # Format _msg_ with gdb-style annotation header.
+    def afmt(msg, newline="\n")
+      "\032\032#{msg}#{newline}"
+    end
+    
+    # Print "annotation" message _msg_. Annotation messages are used
+    # by the GNU-Emacs front-end to get status about stacks and
+    # the state of the debugger without having to poll it for information
+    def aprint(msg)
+      print afmt(msg) if Trepan.annotate.to_i > 2
+    end
+
+    # Print a debugger error message; _args_ should be compatible
+    # with something you would pass to Kernel::print.
+    def errmsg(*args)
+      @interface.errmsg(*args)
+      @interface.print("\n")
+    end
+
+    # Print a normal debugger message; _args_ should be compatible
+    # with something you would pass to Kernel::print.
+    # 
+    # Callers of this routine should make sure to use comma to
+    # separate format argments rather than %. Otherwise it seems that
+    # if the string you want to print has format specifier, which
+    # could happen if you are trying to show say a source-code line
+    # with "puts" or "print" in it, this print routine will give an
+    # error saying it is looking for more arguments.
+    def print(*args)
+      @interface.msg(*args)
+    end
+    
+  end
+
+  # A Debugger::CommandProcessor is the kind of Debugger::Processor
+  # used when you are running inside the same process as the debugged
+  # program.
+  class CommandProcessor < Processor 
+    attr_reader   :display
+    attr_accessor :frame
+    attr_reader   :cmdproc
+
+    # FIXME: get from Command regexp method.
+    @@Show_breakpoints_postcmd = [
+                                  /^\s*b(?:reak)?/, 
+                                  /^\s* cond(?:ition)? (?:\s+(\d+)\s*(.*))?$/ix,
+                                  /^\s*del(?:ete)?(?:\s+(.*))?$/ix,
+                                  /^\s* dis(?:able)? (?:\s+(.*))?$/ix,
+                                  /^\s* en(?:able)? (?:\s+(.*))?$/ix,
+                                  # "tbreak", "clear", 
+                                 ]
+    @@Show_annotations_run     = [
+                                  /^\s*c(?:ont(?:inue)?)?(?:\s+(.*))?$/,
+                                  /^\s*fin(?:ish)?$/,
+                                  /^\s*n(?:ext)?([+-])?(?:\s+(.*))?$/,
+                                  /^\s*s(?:tep)?([+-])?(?:\s+(.*))?$/
+                                ]
+
+    @@Show_annotations_postcmd = [
+                                  /^\s* down (?:\s+(.*))? .*$/x,
+                                  /^\s* f(?:rame)? (?:\s+ (.*))? \s*$/x,
+                                  /^\s* u(?:p)? (?:\s+(.*))?$/x
+                                 ]
+    
+    def initialize(interfaces = [Trepan::UserInterface.new], settings={})
+      @interface = interfaces.first
+      @commands  = []
+      @display   = []
+      
+      @mutex = Mutex.new
+      @last_cmd = nil
+      @last_file = nil   # Filename the last time we stopped
+      @last_line = nil   # line number the last time we stopped
+      @debugger_breakpoints_were_empty = false # Show breakpoints 1st time
+      @debugger_displays_were_empty = true # No display 1st time
+      @debugger_context_was_dead = true # Assume we haven't started.
+      @cmdproc = CmdProcessor.new(interfaces, settings)
+    end
+    
+    def interface=(interface)
+      @mutex.synchronize do
+        @interface.close if @interface
+        @interface = interface
+      end
+    end
+    
+    require 'pathname'  # For cleanpath
+    
+    # Regularize or "canonicalize" file name _filename_.
+    # This is also used as a common funnel place if basename is 
+    # desired or if we are working remotely and want to change the 
+    # basename. Or we are eliding filenames.
+    def self.canonic_file(filename)
+      # For now we want resolved filenames 
+      if OldCommand.settings[:basename]
+        File.basename(filename)
+      else
+        # Cache this?
+        Pathname.new(filename).cleanpath.to_s
+      end
+    end
+
+    def self.print_location_and_text(file, line)
+      file_line = "%s:%s\n%s" % [canonic_file(file), line, 
+                                 Debugger.line_at(file, line)]
+      # FIXME: use annotations routines
+      if Trepan.annotate.to_i > 2
+        file_line = "\032\032source #{file_line}"
+      elsif Trepan.inside_emacs?
+        file_line = "\032\032#{file_line}"
+      end
+      print file_line
+    end
+
+    # Create a "protected" version of method _mname_. A protected
+    # method handles all unhandled exceptions that would cause the
+    # program to terminate.
+    def self.protect(mname)
+      alias_method "__#{mname}", mname
+      module_eval %{
+        def #{mname}(*args)
+          @mutex.synchronize do
+            return unless @interface
+            __#{mname}(*args)
+          end
+        rescue IOError, Errno::EPIPE
+          self.interface = nil
+        rescue SignalException
+          raise
+        rescue Exception
+          print "INTERNAL ERROR!!! #\{$!\}\n" rescue nil
+          print $!.backtrace.map{|l| "\t#\{l\}"}.join("\n") rescue nil
+        end
+      }
+    end
+
+    # This is a callback routine when the debugged program hits a 
+    # breakpoint event. For example ruby-debug-base calls this method.
+    def at_breakpoint(context, breakpoint)
+      @event_arg = breakpoint
+      @cmdproc.event = 'brkpt'
+      aprint 'stopped' if Trepan.annotate.to_i > 2
+      n = Debugger.breakpoints.index(breakpoint) + 1
+      file = @cmdproc.canonic_file(breakpoint.source)
+      line = breakpoint.pos
+      if Trepan.annotate.to_i > 2
+        print afmt("source #{file}:#{line}")
+      end
+      @cmdproc.msg 'Breakpoint %d at %s:%s' % [n, file, line]
+    end
+    protect :at_breakpoint
+    
+    # This is a callback routine when the debugged program raises an
+    # unhandled exception that we have arranged to catch. 
+    # In particular, ruby-debug-base calls this method
+    def at_catchpoint(context, excpt)
+      @event_arg = excpt
+      @cmdproc.event = 'raise'
+      file = @cmdproc.canonic_file(context.frame_file(0))
+      line = context.frame_line(0)
+      @cmdproc.msg("Catchpoint at %s:%d: `%s' (%s)" % 
+                   [file, line, excpt, excpt.class])
+      process_commands(context, file, line)
+    end
+    protect :at_catchpoint
+    
+    def at_tracing(context, file, line)
+      @cmdproc.event = 'tracing'
+      return if defined?(Debugger::RDEBUG_FILE) && 
+        Debugger::RDEBUG_FILE == file # Don't trace ourself
+      @last_file = CommandProcessor.canonic_file(file)
+      canonic_file = CommandProcessor.canonic_file(file)
+      unless canonic_file == @last_file and @last_line == line and 
+          Command.settings[:tracing_plus]
+        print "Tracing(%d):%s:%s %s",
+        context.thnum, canonic_file, line, Debugger.line_at(file, line)
+        @last_file = canonic_file
+        @last_line = line
+      end
+      always_run(context, file, line, 2)
+    end
+    protect :at_tracing
+
+    # This is a callback routine when the debugged program hits a
+    # "line" (or statement boundary) event. For example
+    # ruby-debug-base calls this.
+    def at_line(context, file, line)
+      @cmdproc.event = 'line'
+      process_commands(context, file, line)
+    end
+    protect :at_line
+    
+    # This is a callback routine when the debugged program hits a
+    # "return" event. For example ruby-debug-base calls this.
+    # Note: right now ruby-debug-base does not call this. Perhaps 
+    # other bases routines such as the one in JRuby do.
+    def at_return(context, file, line)
+      @cmdproc.event = 'return'
+      context.stop_frame = -1
+      process_commands(context, file, line)
+    end
+
+    # Return the command object to run given input string _input_.
+    def lookup(input)
+      ###########################################
+      ## Test the waters with new-style commands
+      args = input.split
+      cmd_name = args[0]
+      run_cmd_name = 
+        if @cmdproc.aliases.member?(cmd_name)
+          @cmdproc.aliases[cmd_name] 
+        else
+          cmd_name
+        end
+            
+      if @cmdproc.commands.member?(run_cmd_name)
+        cmd = @cmdproc.commands[run_cmd_name]
+        if @cmdproc.ok_for_running(cmd, run_cmd_name, args.size-1)
+          return cmd
+        end
+      end
+      ###########################################
+      
+      @commands.find{ |c| c.match(input) }
+    end
+
+    # Run a single command specified by string _input_; _commands_ is and 
+    # Array of possible debugger command objects and _context_ is
+    # a Debugger::Context object.
+    def one_cmd(commands, context, input)
+      if cmd = lookup(input)
+        if cmd.kind_of?(Command)
+          if context.dead? && cmd.class.need_context
+            p cmd
+            print "Command is unavailable\n"
+          else
+            args = input.split
+            cmd_name = args[0]
+            @cmdproc.instance_variable_set('@cmd_argstr', input[cmd_name.size..-1].lstrip)
+            @cmdproc.instance_variable_set('@cmd_name', cmd_name)
+            begin
+            cmd.run(args)
+            rescue Exception
+              print "INTERNAL ERROR running command: #{cmd_name}\n"
+              print "#{$!}\n"
+              print $!.backtrace.map{|l| "\t#{l}"}.join("\n"), "\n" rescue nil
+            end
+          end
+        elsif context.dead? && cmd.class.need_context
+          p cmd
+          msg "Command is unavailable"
+        else
+          puts "Using old-style command" unless
+            @cmdproc.settings[:debuggertesting]
+          cmd.execute
+        end
+      else
+        unknown_cmd = commands.find{|cmd| cmd.class.unknown }
+        if unknown_cmd
+            unknown_cmd.execute
+        else
+          if @cmdproc.settings[:autoeval]
+            begin
+              @cmdproc.eval_code(input, @cmdproc.settings[:maxstring])
+              return
+            rescue NameError
+            end
+          end
+          errmsg "Unknown command: \"#{input.chomp}\".  Try \"help\"."
+        end
+      end
+    end
+    
+    private
+
+    # Return a prompt string to show before reading a command.
+    def prompt(context)
+      p = '(rdb:%s) ' % (context.dead?  ? 'post-mortem' : context.thnum)
+      p = afmt("pre-prompt")+p+"\n"+afmt("prompt") if 
+        Trepan.annotate.to_i > 2
+      return p
+    end
+
+    # Run commands that we always have to run before a entering a
+    # command loop.  For example commands registered via debugger "set
+    # display", "set autolist", or set "autoirb".  We return a list of
+    # commands that are acceptable to run bound to the current state.
+    def always_run(context, file, line, run_level)
+      event_cmds = OldCommand.commands.select{|cmd| cmd.event }
+
+      # Remove some commands if we are post mortem.
+      event_cmds = event_cmds.find_all do |cmd| 
+        cmd.allow_in_post_mortem
+      end if !context || context.dead?
+
+      state = State.new(self) do |s|
+        s.context = context
+        s.file    = file
+        s.line    = line
+        s.display = display
+        s.commands = event_cmds
+      end
+      @interface.state = state if @interface.respond_to?('state=')
+      
+      # Bind commands to the current state.
+      commands = event_cmds.map{|cmd| cmd.new(state)}
+
+      commands.select do |cmd| 
+        cmd.class.always_run >= run_level
+      end.each {|cmd| cmd.execute}
+      return state, commands
+    end
+
+    # This the main debugger command-line loop. Here we read a
+    # debugger command, perform it, and ask for another one unless we
+    # are told to continue execution or terminate.
+    def process_commands(context, file, line)
+      @state, @commands = always_run(context, file, line, 1)
+      $rdebug_state = @state if @cmdproc.settings[:debuggertesting]
+      @cmdproc.process_commands(context, @state)
+
+      # @cmdproc.frame_setup(context, @state)
+      # splitter = lambda do |str|
+      #   str.split(/;/).inject([]) do |m, v|
+      #     if m.empty?
+      #       m << v
+      #     else
+      #       if m.last[-1] == ?\\
+      #         m.last[-1,1] = ''
+      #         m.last << ';' << v
+      #       else
+      #         m << v
+      #       end
+      #     end
+      #     m
+      #   end
+      # end
+      
+      # preloop(@commands, context)
+      # CommandProcessor.print_location_and_text(file, line)
+      # while !@state.proceed? 
+      #   input = if @interface.command_queue.empty?
+      #             @interface.read_command(prompt(context))
+      #           else
+      #             @interface.command_queue.shift
+      #           end
+      #   break unless input
+      #   next if input =~ /^\s*#/
+      #   catch(:debug_error) do
+      #     if input == ""
+      #       next unless @last_cmd
+      #       input = @last_cmd
+      #     else
+      #       @last_cmd = input
+      #     end
+      #     splitter[input].each do |cmd|
+      #       one_cmd(@commands, context, cmd)
+      #       postcmd(@commands, context, cmd)
+      #     end
+      #   end
+      # end
+      # postloop(@commands, context)
+    end # process_commands
+
+    # Things we do before entering the debugger command loop.
+    # Note: in the trepanning debuggers this and always_run have been
+    # merged. To do this and get the order right we add a priority level
+    # for each hook.
+    def preloop(commands, context)
+      aprint('stopped') if Trepan.annotate.to_i > 2
+      if context.dead?
+        unless @debugger_context_was_dead
+          if Trepan.annotate.to_i > 2
+            aprint('exited') 
+            print "The program finished.\n" 
+          end
+          @debugger_context_was_dead = true
+        end
+      end
+
+      if Trepan.annotate.to_i > 2
+        # if we are here, the stack frames have changed outside the
+        # command loop (e.g. after a "continue" command), so we show
+        # the annotations again
+        breakpoint_annotations(commands, context)
+        display_annotations(commands, context)
+        annotation('stack', commands, context, "where")
+        annotation('variables', commands, context, "info variables") unless
+          context.dead?
+      end
+    end
+    
+    # Things we do after leaving the debugger command loop.
+    def postcmd(commands, context, cmd)
+      if Trepan.annotate.to_i > 0
+        cmd = @last_cmd unless cmd
+        breakpoint_annotations(commands, context) if
+          @@Show_breakpoints_postcmd.find{|pat| cmd =~ pat}
+        display_annotations(commands, context)
+        if @@Show_annotations_postcmd.find{|pat| cmd =~ pat}
+          annotation('stack', commands, context, "where") if 
+            context.stack_size > 0
+          annotation('variables', commands, context, "info variables") unless
+            context.dead?
+        end
+        if not context.dead? and @@Show_annotations_run.find{|pat| cmd =~ pat}
+          aprint 'starting'  if Trepan.annotate.to_i > 2
+
+          @debugger_context_was_dead = false
+        end
+      end
+    end
+
+    # Things we do after leaving the debugger command loop.
+    def postloop(commands, context)
+    end
+
+    # Run a command in String _cmd_, but tag output with annotation
+    # specified in String _label+. +commands_ is an Array of all
+    # possible debugger command objects, and _context_ is a
+    # Debugger::Context object.
+    def annotation(label, commands, context, cmd)
+      print afmt(label)
+      one_cmd(commands, context, cmd)
+      ### FIXME ANNOTATE: the following line should be deleted
+      print "\032\032\n"
+    end
+
+    def breakpoint_annotations(commands, context)
+      unless Debugger.breakpoints.empty? and @debugger_breakpoints_were_empty
+        annotation('breakpoints', commands, context, "info breakpoints") 
+        @debugger_breakpoints_were_empty = Debugger.breakpoints.empty?
+      end
+    end
+
+    def display_annotations(commands, context)
+      return if display.empty?
+#       have_display = display.find{|d| d[0]} 
+#       return unless have_display and @debugger_displays_were_empty
+#       @debugger_displays_were_empty = have_display
+      annotation('display', commands, context, "display")
+    end
+
+    class State # :nodoc:
+      attr_accessor :context, :file, :line, :binding
+      attr_accessor :frame_pos, :previous_line, :display
+      attr_accessor :interface, :commands, :processor
+
+      def initialize(processor=nil)
+        super()
+        @frame_pos     = 0
+        @previous_line = nil
+        @proceed       = false
+        @processor     = processor
+        yield self
+      end
+
+    # Print a debugger error message; _args_ should be compatible
+    # with something you would pass to Kernel::print.
+      def errmsg(*args)
+        @interface.errmsg(*args)
+        @interface.msg("\n")
+      end
+
+      # Print a normal debugger message; _args_ should be compatible
+      # with something you would pass to Kernel::print.
+      # 
+      # Callers of this routine should make sure to use comma to
+      # separate format argments rather than %. Otherwise it seems that
+      # if the string you want to print has format specifier, which
+      # could happen if you are trying to show say a source-code line
+      # with "puts" or "print" in it, this print routine will give an
+      # error saying it is looking for more arguments.
+      def print(*args)
+        @interface.print(*args)
+      end
+
+      # confirm is called before performing a dangerous action. 
+      def confirm(*args)
+        @interface.confirm(*args)
+      end
+
+      def proceed?
+        @proceed
+      end
+
+      def proceed
+        @proceed = true
+      end
+    end
+  end
+  
+  # A Debugger::ControlCommandProcessor is the kind of Debugger::Processor
+  # used the debugged program is running remotely. It is also entered
+  # after the debugged program has terminated.
+  class ControlCommandProcessor < Processor
+    def initialize(interface)
+      super()
+      @interface = interface
+      @cmdproc   = CmdProcessor.new([interface])
+      @debugger_context_was_dead = true # Assume we haven't started.
+    end
+
+    # Return the command object to run given input string _input_.
+    def lookup(input)
+      ###########################################
+      ## Test the waters with new-style commands
+      args = input.split
+      cmd_name = args[0]
+      run_cmd_name = 
+        if @cmdproc.aliases.member?(cmd_name)
+          @cmdproc.aliases[cmd_name] 
+        else
+          cmd_name
+        end
+            
+      if @cmdproc.commands.member?(run_cmd_name)
+        cmd = @cmdproc.commands[run_cmd_name]
+        if @cmdproc.ok_for_running(cmd, run_cmd_name, args.size-1)
+          return cmd
+        end
+      end
+      ###########################################
+      
+      @commands.find{ |c| c.match(input) }
+    end
+
+    # This the main debugger command-line loop. Here we read a
+    # debugger command, perform it, and ask for another one unless we
+    # are told to continue execution or terminate.
+    def process_commands(verbose=false)
+      control_cmds = OldCommand.commands.select do |cmd| 
+        cmd.allow_in_control 
+      end
+      context = Debugger.current_context
+      @state = State.new(@interface, control_cmds)
+      @cmdproc.frame_setup(context, @state)
+      @commands = control_cmds.map{|cmd| cmd.new(@state) }
+
+      unless @debugger_context_was_dead
+        if Trepan.annotate.to_i > 2
+          aprint 'exited'  
+          print "The program finished.\n" 
+        end
+        @debugger_context_was_dead = true
+      end
+
+      while input = @interface.read_command(prompt(nil))
+        print "+#{input}\n" if true # verbose
+        catch(:debug_error) do
+          if cmd = lookup(input)
+            if cmd.kind_of?(Command)
+              args = input.split
+              cmd_name = args[0]
+              @cmdproc.instance_variable_set('@cmd_argstr', input[cmd_name.size..-1].lstrip)
+              @cmdproc.instance_variable_set('@cmd_name', cmd_name)
+              begin
+                cmd.run(args)
+              rescue Exception
+                print "INTERNAL ERROR running command: #{cmd_name}\n"
+                print "#{$!}\n"
+                print $!.backtrace.map{|l| "\t#{l}"}.join("\n"), "\n" rescue nil
+              end
+            else
+              puts "Using old-style command" unless
+                @cmdproc.settings[:debuggertesting]
+              cmd.execute
+            end
+          else
+            if @cmdproc.settings[:autoeval]
+              begin
+                @cmdproc.eval_code(input, @cmdproc.settings[:maxstring])
+                return
+              rescue NameError
+              end
+            end
+            errmsg "Unknown command: \"#{input.chomp}\".  Try \"help\"."
+          end
+        end
+      end
+    rescue IOError, Errno::EPIPE
+    # rescue Exception
+    #   print "INTERNAL ERROR!!! #{$!}\n" rescue nil
+    #   print $!.backtrace.map{|l| "\t#{l}"}.join("\n") rescue nil
+    ensure
+      @interface.close
+    end
+
+    # Return a prompt string to show before reading a command.  Note: The 
+    # _context_ parameter is not used. It must be provided so that the 
+    # interface matches Debugger::CommandProcessor#prompt.
+    def prompt(context)
+      p = '(rdb:ctrl) '
+      p = afmt("pre-prompt")+p+"\n"+afmt("prompt") if 
+        Trepan.annotate.to_i > 2
+      return p
+    end
+
+    class State # :nodoc:
+      attr_reader :commands, :interface, :frame_pos
+      
+      def initialize(interface, commands)
+        @interface = interface
+        @commands  = commands
+        @frame_pos = 0
+      end
+      
+      def proceed
+      end
+      
+      # Print a debugger error message; _args_ should be compatible
+      # with something you would pass to Kernel::print.
+      def errmsg(*args)
+        @interface.print(*args)
+        @interface.print "\n"
+      end
+      
+    # Print a normal debugger message; _args_ should be compatible
+    # with something you would pass to Kernel::print.
+    # 
+    # Callers of this routine should make sure to use comma to
+    # separate format argments rather than %. Otherwise it seems that
+    # if the string you want to print has format specifier, which
+    # could happen if you are trying to show say a source-code line
+    # with "puts" or "print" in it, this print routine will give an
+    # error saying it is looking for more arguments.
+      def print(*args)
+        @interface.print(*args)
+        @interface.print "\n"
+      end
+
+      # confirm is called before performing a dangerous action. In
+      # control processor we always return "yes" or "y".
+      def confirm(*args)
+        'y'
+      end
+      
+      def context
+        nil
+      end
+
+      def file
+        errmsg "No filename given."
+        throw :debug_error
+      end
+    end # State
+  end
+end