56 
  57   /** Parse an address from a hex string in the format "0xFFFFFFFF".
  58       The length of the address (i.e., 32 or 64 bits) is platform
  59       dependent. This method should ONLY be used by routines which
  60       need to interact with the user and parse a string entered by
  61       hand; for example, a graphical user interface. This routine
  62       should NOT be used to subvert the current safety mechanisms in
  63       the system which prevent arbitrary conversion from Address to
  64       long and back. */
  65   public Address parseAddress(String addressString)
  66     throws NumberFormatException, DebuggerException;
  67 
  68   /** Returns the 64-bit value of an Address. This method should ONLY
  69       be used when implementing a debugger which needs to interface to
  70       C and which needs a unique identifier for certain objects. */
  71   public long getAddressValue(Address addr) throws DebuggerException;
  72 
  73   /** Support for remote debugging. Get the name of the operating
  74       system on which this debugger is running (to be able to properly
  75       configure the local system). Typical return values are
  76       "solaris", "linux", "win32"; see utilities/PlatformInfo.java. */
  77   public String getOS() throws DebuggerException;
  78 
  79   /** Support for remote debugging. Get the name of the CPU type on
  80       which this debugger is running (to be able to properly configure
  81       the local system). Typical return values are "sparc", "x86"; see
  82       utilities/PlatformInfo.java. */
  83   public String getCPU() throws DebuggerException;
  84 
  85   /** Retrieve the machine description for the underlying hardware for
  86       the cases in which we need to do, for example, machine-dependent
  87       byte swapping */
  88   public MachineDescription getMachineDescription() throws DebuggerException;
  89 
  90   /** Find out whether this debugger has a console available on which
  91       commands can be executed; see executeCommandOnConsole, below.
  92       This is an interim routine designed to allow access to the
  93       underlying dbx process on Solaris until we have disassembly,
  94       etc. in the SA. */
  95   public boolean hasConsole() throws DebuggerException;
  96 
  97   /** If the underlying debugger has a console (as dbx does), this
  98       provides access to it. Takes in a platform-dependent String,
  99       executes it on the debugger's console, and returns any output as
 100       a String. */
 101   public String consoleExecuteCommand(String cmd) throws DebuggerException;

  56 
  57   /** Parse an address from a hex string in the format "0xFFFFFFFF".
  58       The length of the address (i.e., 32 or 64 bits) is platform
  59       dependent. This method should ONLY be used by routines which
  60       need to interact with the user and parse a string entered by
  61       hand; for example, a graphical user interface. This routine
  62       should NOT be used to subvert the current safety mechanisms in
  63       the system which prevent arbitrary conversion from Address to
  64       long and back. */
  65   public Address parseAddress(String addressString)
  66     throws NumberFormatException, DebuggerException;
  67 
  68   /** Returns the 64-bit value of an Address. This method should ONLY
  69       be used when implementing a debugger which needs to interface to
  70       C and which needs a unique identifier for certain objects. */
  71   public long getAddressValue(Address addr) throws DebuggerException;
  72 
  73   /** Support for remote debugging. Get the name of the operating
  74       system on which this debugger is running (to be able to properly
  75       configure the local system). Typical return values are
  76       "linux", "win32"; see utilities/PlatformInfo.java. */
  77   public String getOS() throws DebuggerException;
  78 
  79   /** Support for remote debugging. Get the name of the CPU type on
  80       which this debugger is running (to be able to properly configure
  81       the local system). Typical return value is "x86"; see
  82       utilities/PlatformInfo.java. */
  83   public String getCPU() throws DebuggerException;
  84 
  85   /** Retrieve the machine description for the underlying hardware for
  86       the cases in which we need to do, for example, machine-dependent
  87       byte swapping */
  88   public MachineDescription getMachineDescription() throws DebuggerException;
  89 
  90   /** Find out whether this debugger has a console available on which
  91       commands can be executed; see executeCommandOnConsole, below.
  92       This is an interim routine designed to allow access to the
  93       underlying dbx process on Solaris until we have disassembly,
  94       etc. in the SA. */
  95   public boolean hasConsole() throws DebuggerException;
  96 
  97   /** If the underlying debugger has a console (as dbx does), this
  98       provides access to it. Takes in a platform-dependent String,
  99       executes it on the debugger's console, and returns any output as
 100       a String. */
 101   public String consoleExecuteCommand(String cmd) throws DebuggerException;