sun.jvm.hotspot.debugger.dummy

Class DummyDebugger

java.lang.Object

sun.jvm.hotspot.debugger.DebuggerBase

sun.jvm.hotspot.debugger.dummy.DummyDebugger

All Implemented Interfaces:

Debugger, SymbolLookup, ThreadAccess

public class DummyDebugger
extends DebuggerBase

For testing purposes

Field Summary

Fields inherited from class sun.jvm.hotspot.debugger.DebuggerBase

heapOopSize, javaPrimitiveTypesConfigured, jbooleanSize, jbyteSize, jcharSize, jdoubleSize, jfloatSize, jintSize, jlongSize, jshortSize, klassPtrSize, narrowKlassBase, narrowKlassShift, narrowOopBase, narrowOopShift, oopSize, utils

Constructor Summary

Constructors

Constructor and Description
DummyDebugger(MachineDescription machDesc)

Method Summary

Modifier and Type	Method and Description
void	attach(int processID) If an error occurs during attachment (i.e., "no such process"), the thrown DebuggerException will contain a description of the error in its message string.
void	attach(java.lang.String executableName, java.lang.String coreFileName) This attaches the debugger to the given coreFileName, which is assumed to have been generated from the specified executableName.
java.lang.String	consoleExecuteCommand(java.lang.String cmd) If the underlying debugger has a console (as dbx does), this provides access to it.
boolean	detach() Detach from the remote process.
long	getAddressValue(Address addr) Returns the 64-bit value of an Address.
CDebugger	getCDebugger() If this platform supports C/C++ debugging via the CDebugger interface, returns a CDebugger object; otherwise returns null.
java.lang.String	getConsolePrompt() If the underlying debugger has a console, this returns the debugger-specific prompt which should be displayed.
java.lang.String	getCPU() Support for remote debugging.
MachineDescription	getMachineDescription() Retrieve the machine description for the underlying hardware for the cases in which we need to do, for example, machine-dependent byte swapping
java.lang.String	getOS() Support for remote debugging.
java.util.List	getProcessList() Provide a snapshot of the list of currently-running processes in the form of a List of ProcessInfo objects.
ThreadProxy	getThreadForIdentifierAddress(Address addr) Gets an abstract ThreadProxy object for the thread identified by the contents of the memory location pointed to by addr.
ThreadProxy	getThreadForThreadId(long id) Gets an abstract ThreadProxy object for the thread identified by id or handle that is platform dependent
boolean	hasConsole() Find out whether this debugger has a console available on which commands can be executed; see executeCommandOnConsole, below.
boolean	hasProcessList() Indicates whether this underlying debugger can provide a list of currently-running processes.
Address	lookup(java.lang.String objectName, java.lang.String symbol) Looks up the given symbol in the context of the given object.
OopHandle	lookupOop(java.lang.String objectName, java.lang.String symbol) Looks up the given symbol in the context of the given object, assuming that symbol refers to a Java object.
Address	parseAddress(java.lang.String addrStr) Parse an address from a hex string in the format "0xFFFFFFFF".
ReadResult	readBytesFromProcess(long address, long numBytes)
void	writeBytesToProcess(long a, long b, byte[] buf)

Methods inherited from class sun.jvm.hotspot.debugger.DebuggerBase

checkConfigured, checkJavaConfigured, clearCache, configureJavaPrimitiveTypeSizes, disableCache, enableCache, getHeapOopSize, getJBooleanSize, getJByteSize, getJCharSize, getJDoubleSize, getJFloatSize, getJIntSize, getJLongSize, getJShortSize, getKlassPtrSize, getNarrowKlassBase, getNarrowKlassShift, getNarrowOopBase, getNarrowOopShift, initCache, invalidatePageCache, parseCacheNumPagesProperty, putHeapConst, readAddressValue, readBytes, readCInteger, readCompKlassAddressValue, readCompOopAddressValue, readJBoolean, readJByte, readJChar, readJDouble, readJFloat, readJInt, readJLong, readJShort, setBigEndian, writeAddressValue, writeBytes, writeCInteger, writeJBoolean, writeJByte, writeJChar, writeJDouble, writeJFloat, writeJInt, writeJLong, writeJShort

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DummyDebugger

public DummyDebugger(MachineDescription machDesc)

Method Detail

hasProcessList

public boolean hasProcessList()
                       throws DebuggerException

Description copied from interface: Debugger

Indicates whether this underlying debugger can provide a list of currently-running processes.

Throws:

DebuggerException

getProcessList

public java.util.List getProcessList()
                              throws DebuggerException

Description copied from interface: Debugger

Provide a snapshot of the list of currently-running processes in the form of a List of ProcessInfo objects. Must only be called if hasProcessList(), above, returns true.

Throws:

DebuggerException

attach

public void attach(int processID)
            throws DebuggerException

Description copied from interface: Debugger

If an error occurs during attachment (i.e., "no such process"), the thrown DebuggerException will contain a description of the error in its message string.

Throws:

DebuggerException

attach

public void attach(java.lang.String executableName,
                   java.lang.String coreFileName)
            throws DebuggerException

Description copied from interface: Debugger

This attaches the debugger to the given coreFileName, which is assumed to have been generated from the specified executableName. If an error occurs during loading of the core file (i.e., "no such file"), the thrown DebuggerException will contain a description of the error in its message string.

Throws:

DebuggerException

detach

public boolean detach()

Description copied from interface: Debugger

Detach from the remote process. Returns false if not currently attached.

parseAddress

public Address parseAddress(java.lang.String addrStr)

Description copied from interface: Debugger

Parse an address from a hex string in the format "0xFFFFFFFF". The length of the address (i.e., 32 or 64 bits) is platform dependent. This method should ONLY be used by routines which need to interact with the user and parse a string entered by hand; for example, a graphical user interface. This routine should NOT be used to subvert the current safety mechanisms in the system which prevent arbitrary conversion from Address to long and back.

getAddressValue

public long getAddressValue(Address addr)

Description copied from interface: Debugger

Returns the 64-bit value of an Address. This method should ONLY be used when implementing a debugger which needs to interface to C and which needs a unique identifier for certain objects.

getOS

public java.lang.String getOS()

Description copied from interface: Debugger

Support for remote debugging. Get the name of the operating system on which this debugger is running (to be able to properly configure the local system). Typical return values are "solaris", "linux", "win32"; see utilities/PlatformInfo.java.

getCPU

public java.lang.String getCPU()

Description copied from interface: Debugger

Support for remote debugging. Get the name of the CPU type on which this debugger is running (to be able to properly configure the local system). Typical return values are "sparc", "x86"; see utilities/PlatformInfo.java.

getMachineDescription

public MachineDescription getMachineDescription()
                                         throws DebuggerException

Description copied from interface: Debugger

Retrieve the machine description for the underlying hardware for the cases in which we need to do, for example, machine-dependent byte swapping

Throws:

DebuggerException

hasConsole

public boolean hasConsole()

Description copied from interface: Debugger

Find out whether this debugger has a console available on which commands can be executed; see executeCommandOnConsole, below. This is an interim routine designed to allow access to the underlying dbx process on Solaris until we have disassembly, etc. in the SA.

consoleExecuteCommand

public java.lang.String consoleExecuteCommand(java.lang.String cmd)
                                       throws DebuggerException

Description copied from interface: Debugger

If the underlying debugger has a console (as dbx does), this provides access to it. Takes in a platform-dependent String, executes it on the debugger's console, and returns any output as a String.

Throws:

DebuggerException

getConsolePrompt

public java.lang.String getConsolePrompt()
                                  throws DebuggerException

Description copied from interface: Debugger

If the underlying debugger has a console, this returns the debugger-specific prompt which should be displayed.

Throws:

DebuggerException

getCDebugger

public CDebugger getCDebugger()
                       throws DebuggerException

Description copied from interface: Debugger

If this platform supports C/C++ debugging via the CDebugger interface, returns a CDebugger object; otherwise returns null.

Throws:

DebuggerException

lookup

public Address lookup(java.lang.String objectName,
                      java.lang.String symbol)

Description copied from interface: SymbolLookup

Looks up the given symbol in the context of the given object.

FIXME: we may want to hide the objectName so the user does not have to specify it, but it isn't clear whether this will work transparently with dbx.

FIXME: what happens if the address is not found? Throw exception? Currently returns null.

lookupOop

public OopHandle lookupOop(java.lang.String objectName,
                           java.lang.String symbol)

Description copied from interface: SymbolLookup

Looks up the given symbol in the context of the given object, assuming that symbol refers to a Java object. FIXME: still not sure whether this will be necessary. Seems that lookup of static fields with type "oop" already works, since the lookup routine returns the address of the oop (i.e., an oopDesc**).

FIXME: we may want to hide the objectName so the user does not have to specify it, but it isn't clear whether this will work transparently with dbx.

FIXME: what happens if the address is not found? Throw exception? Currently returns null.

getThreadForIdentifierAddress

public ThreadProxy getThreadForIdentifierAddress(Address addr)

Description copied from interface: ThreadAccess

Gets an abstract ThreadProxy object for the thread identified by the contents of the memory location pointed to by addr. The contents at location addr are inherently platform-dependent; see the documentation for this class for more information. FIXME: what exception, if any, should this throw?

getThreadForThreadId

public ThreadProxy getThreadForThreadId(long id)

Description copied from interface: ThreadAccess

Gets an abstract ThreadProxy object for the thread identified by id or handle that is platform dependent

readBytesFromProcess

public ReadResult readBytesFromProcess(long address,
                                       long numBytes)
                                throws DebuggerException

Throws:

DebuggerException

writeBytesToProcess

public void writeBytesToProcess(long a,
                                long b,
                                byte[] buf)
                         throws DebuggerException

Throws:

DebuggerException