Mercurial > hg > truffle
view agent/src/share/classes/sun/jvm/hotspot/debugger/win32/Win32Debugger.java @ 0:a61af66fc99e jdk7-b24
Initial load
author | duke |
---|---|
date | Sat, 01 Dec 2007 00:00:00 +0000 |
parents | |
children | ba764ed4b6f2 |
line wrap: on
line source
/* * Copyright 2000-2002 Sun Microsystems, Inc. All Rights Reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, * CA 95054 USA or visit www.sun.com if you need additional information or * have any questions. * */ package sun.jvm.hotspot.debugger.win32; import java.util.List; import sun.jvm.hotspot.debugger.*; import sun.jvm.hotspot.debugger.cdbg.*; /** An extension of the JVMDebugger interface with a few additions to support 32-bit vs. 64-bit debugging as well as features required by the architecture-specific subpackages. */ public interface Win32Debugger extends JVMDebugger { public String addressValueToString(long address) throws DebuggerException; public boolean readJBoolean(long address) throws DebuggerException; public byte readJByte(long address) throws DebuggerException; public char readJChar(long address) throws DebuggerException; public double readJDouble(long address) throws DebuggerException; public float readJFloat(long address) throws DebuggerException; public int readJInt(long address) throws DebuggerException; public long readJLong(long address) throws DebuggerException; public short readJShort(long address) throws DebuggerException; public long readCInteger(long address, long numBytes, boolean isUnsigned) throws DebuggerException; public Win32Address readAddress(long address) throws DebuggerException; public Win32OopHandle readOopHandle(long address) throws DebuggerException; public void writeJBoolean(long address, boolean value) throws DebuggerException; public void writeJByte(long address, byte value) throws DebuggerException; public void writeJChar(long address, char value) throws DebuggerException; public void writeJDouble(long address, double value) throws DebuggerException; public void writeJFloat(long address, float value) throws DebuggerException; public void writeJInt(long address, int value) throws DebuggerException; public void writeJLong(long address, long value) throws DebuggerException; public void writeJShort(long address, short value) throws DebuggerException; public void writeCInteger(long address, long numBytes, long value) throws DebuggerException; public void writeAddress(long address, Win32Address value) throws DebuggerException; public void writeOopHandle(long address, Win32OopHandle value) throws DebuggerException; // On Windows the int is actually the value of a HANDLE which // currently must be read from the target process; that is, the // target process must maintain its own thread list, each element of // which holds a HANDLE to its underlying OS thread. FIXME: should // add access to the OS-level thread list, but there are too many // limitations imposed by Windows to usefully do so; see // src/os/win32/agent/README-commands.txt, command "duphandle". // // The returned array of register contents is guaranteed to be in // the same order as in the DbxDebugger for Solaris/x86; that is, // the indices match those in debugger/x86/X86ThreadContext.java. public long[] getThreadIntegerRegisterSet(int threadHandleValue, boolean mustDuplicateHandle) throws DebuggerException; // Implmentation of setContext public void setThreadIntegerRegisterSet(int threadHandleValue, boolean mustDuplicateHandle, long[] contents) throws DebuggerException; public Address newAddress(long value) throws DebuggerException; // Routine supporting the ThreadProxy implementation, in particular // the ability to get a thread ID from a thread handle via // examination of the Thread Information Block. Fetch the LDT entry // for a given selector. public Win32LDTEntry getThreadSelectorEntry(int threadHandleValue, boolean mustDuplicateHandle, int selector) throws DebuggerException; // Support for the CDebugger interface. Retrieves the thread list of // the target process as a List of ThreadProxy objects. public List/*<ThreadProxy>*/ getThreadList() throws DebuggerException; // Support for the CDebugger interface. Retrieves a List of the // loadobjects in the target process. public List/*<LoadObject>*/ getLoadObjectList() throws DebuggerException; // Support for the ProcessControl interface public void writeBytesToProcess(long startAddress, long numBytes, byte[] data) throws UnmappedAddressException, DebuggerException; public void suspend() throws DebuggerException; public void resume() throws DebuggerException; public boolean isSuspended() throws DebuggerException; public void setBreakpoint(Address addr) throws DebuggerException; public void clearBreakpoint(Address addr) throws DebuggerException; public boolean isBreakpointSet(Address addr) throws DebuggerException; // FIXME: do not want to expose complicated data structures (like // the DebugEvent) in this interface due to serialization issues public DebugEvent debugEventPoll() throws DebuggerException; public void debugEventContinue() throws DebuggerException; // NOTE: this interface implicitly contains the following methods: // From the Debugger interface via JVMDebugger // public void attach(int processID) throws DebuggerException; // public void attach(String executableName, String coreFileName) throws DebuggerException; // public boolean detach(); // public Address parseAddress(String addressString) throws NumberFormatException; // public long getAddressValue(Address addr) throws DebuggerException; // public String getOS(); // public String getCPU(); // From the SymbolLookup interface via Debugger and JVMDebugger // public Address lookup(String objectName, String symbol); // public OopHandle lookupOop(String objectName, String symbol); // From the JVMDebugger interface // public void configureJavaPrimitiveTypeSizes(long jbooleanSize, // long jbyteSize, // long jcharSize, // long jdoubleSize, // long jfloatSize, // long jintSize, // long jlongSize, // long jshortSize); // From the ThreadAccess interface via Debugger and JVMDebugger // public ThreadProxy getThreadForIdentifierAddress(Address addr); }