1
|
1 |
/*
|
|
2 |
* Copyright 2000-2002 Sun Microsystems, Inc. All Rights Reserved.
|
|
3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
4 |
*
|
|
5 |
* This code is free software; you can redistribute it and/or modify it
|
|
6 |
* under the terms of the GNU General Public License version 2 only, as
|
|
7 |
* published by the Free Software Foundation.
|
|
8 |
*
|
|
9 |
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
10 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
11 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
12 |
* version 2 for more details (a copy is included in the LICENSE file that
|
|
13 |
* accompanied this code).
|
|
14 |
*
|
|
15 |
* You should have received a copy of the GNU General Public License version
|
|
16 |
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
17 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
18 |
*
|
|
19 |
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
|
|
20 |
* CA 95054 USA or visit www.sun.com if you need additional information or
|
|
21 |
* have any questions.
|
|
22 |
*
|
|
23 |
*/
|
|
24 |
|
|
25 |
package sun.jvm.hotspot.debugger.win32;
|
|
26 |
|
|
27 |
import java.util.List;
|
|
28 |
import sun.jvm.hotspot.debugger.*;
|
|
29 |
import sun.jvm.hotspot.debugger.cdbg.*;
|
|
30 |
|
|
31 |
/** An extension of the JVMDebugger interface with a few additions to
|
|
32 |
support 32-bit vs. 64-bit debugging as well as features required
|
|
33 |
by the architecture-specific subpackages. */
|
|
34 |
|
|
35 |
public interface Win32Debugger extends JVMDebugger {
|
|
36 |
public String addressValueToString(long address) throws DebuggerException;
|
|
37 |
public boolean readJBoolean(long address) throws DebuggerException;
|
|
38 |
public byte readJByte(long address) throws DebuggerException;
|
|
39 |
public char readJChar(long address) throws DebuggerException;
|
|
40 |
public double readJDouble(long address) throws DebuggerException;
|
|
41 |
public float readJFloat(long address) throws DebuggerException;
|
|
42 |
public int readJInt(long address) throws DebuggerException;
|
|
43 |
public long readJLong(long address) throws DebuggerException;
|
|
44 |
public short readJShort(long address) throws DebuggerException;
|
|
45 |
public long readCInteger(long address, long numBytes, boolean isUnsigned)
|
|
46 |
throws DebuggerException;
|
|
47 |
public Win32Address readAddress(long address) throws DebuggerException;
|
|
48 |
public Win32OopHandle readOopHandle(long address) throws DebuggerException;
|
|
49 |
public void writeJBoolean(long address, boolean value) throws DebuggerException;
|
|
50 |
public void writeJByte(long address, byte value) throws DebuggerException;
|
|
51 |
public void writeJChar(long address, char value) throws DebuggerException;
|
|
52 |
public void writeJDouble(long address, double value) throws DebuggerException;
|
|
53 |
public void writeJFloat(long address, float value) throws DebuggerException;
|
|
54 |
public void writeJInt(long address, int value) throws DebuggerException;
|
|
55 |
public void writeJLong(long address, long value) throws DebuggerException;
|
|
56 |
public void writeJShort(long address, short value) throws DebuggerException;
|
|
57 |
public void writeCInteger(long address, long numBytes, long value) throws DebuggerException;
|
|
58 |
public void writeAddress(long address, Win32Address value) throws DebuggerException;
|
|
59 |
public void writeOopHandle(long address, Win32OopHandle value) throws DebuggerException;
|
|
60 |
|
|
61 |
// On Windows the int is actually the value of a HANDLE which
|
|
62 |
// currently must be read from the target process; that is, the
|
|
63 |
// target process must maintain its own thread list, each element of
|
|
64 |
// which holds a HANDLE to its underlying OS thread. FIXME: should
|
|
65 |
// add access to the OS-level thread list, but there are too many
|
|
66 |
// limitations imposed by Windows to usefully do so; see
|
|
67 |
// src/os/win32/agent/README-commands.txt, command "duphandle".
|
|
68 |
//
|
|
69 |
// The returned array of register contents is guaranteed to be in
|
|
70 |
// the same order as in the DbxDebugger for Solaris/x86; that is,
|
|
71 |
// the indices match those in debugger/x86/X86ThreadContext.java.
|
|
72 |
public long[] getThreadIntegerRegisterSet(int threadHandleValue,
|
|
73 |
boolean mustDuplicateHandle) throws DebuggerException;
|
|
74 |
// Implmentation of setContext
|
|
75 |
public void setThreadIntegerRegisterSet(int threadHandleValue,
|
|
76 |
boolean mustDuplicateHandle,
|
|
77 |
long[] contents) throws DebuggerException;
|
|
78 |
|
|
79 |
public Address newAddress(long value) throws DebuggerException;
|
|
80 |
|
|
81 |
// Routine supporting the ThreadProxy implementation, in particular
|
|
82 |
// the ability to get a thread ID from a thread handle via
|
|
83 |
// examination of the Thread Information Block. Fetch the LDT entry
|
|
84 |
// for a given selector.
|
|
85 |
public Win32LDTEntry getThreadSelectorEntry(int threadHandleValue,
|
|
86 |
boolean mustDuplicateHandle,
|
|
87 |
int selector) throws DebuggerException;
|
|
88 |
|
|
89 |
// Support for the CDebugger interface. Retrieves the thread list of
|
|
90 |
// the target process as a List of ThreadProxy objects.
|
|
91 |
public List/*<ThreadProxy>*/ getThreadList() throws DebuggerException;
|
|
92 |
|
|
93 |
// Support for the CDebugger interface. Retrieves a List of the
|
|
94 |
// loadobjects in the target process.
|
|
95 |
public List/*<LoadObject>*/ getLoadObjectList() throws DebuggerException;
|
|
96 |
|
|
97 |
// Support for the ProcessControl interface
|
|
98 |
public void writeBytesToProcess(long startAddress, long numBytes, byte[] data) throws UnmappedAddressException, DebuggerException;
|
|
99 |
public void suspend() throws DebuggerException;
|
|
100 |
public void resume() throws DebuggerException;
|
|
101 |
public boolean isSuspended() throws DebuggerException;
|
|
102 |
public void setBreakpoint(Address addr) throws DebuggerException;
|
|
103 |
public void clearBreakpoint(Address addr) throws DebuggerException;
|
|
104 |
public boolean isBreakpointSet(Address addr) throws DebuggerException;
|
|
105 |
// FIXME: do not want to expose complicated data structures (like
|
|
106 |
// the DebugEvent) in this interface due to serialization issues
|
|
107 |
public DebugEvent debugEventPoll() throws DebuggerException;
|
|
108 |
public void debugEventContinue() throws DebuggerException;
|
|
109 |
|
|
110 |
// NOTE: this interface implicitly contains the following methods:
|
|
111 |
// From the Debugger interface via JVMDebugger
|
|
112 |
// public void attach(int processID) throws DebuggerException;
|
|
113 |
// public void attach(String executableName, String coreFileName) throws DebuggerException;
|
|
114 |
// public boolean detach();
|
|
115 |
// public Address parseAddress(String addressString) throws NumberFormatException;
|
|
116 |
// public long getAddressValue(Address addr) throws DebuggerException;
|
|
117 |
// public String getOS();
|
|
118 |
// public String getCPU();
|
|
119 |
// From the SymbolLookup interface via Debugger and JVMDebugger
|
|
120 |
// public Address lookup(String objectName, String symbol);
|
|
121 |
// public OopHandle lookupOop(String objectName, String symbol);
|
|
122 |
// From the JVMDebugger interface
|
|
123 |
// public void configureJavaPrimitiveTypeSizes(long jbooleanSize,
|
|
124 |
// long jbyteSize,
|
|
125 |
// long jcharSize,
|
|
126 |
// long jdoubleSize,
|
|
127 |
// long jfloatSize,
|
|
128 |
// long jintSize,
|
|
129 |
// long jlongSize,
|
|
130 |
// long jshortSize);
|
|
131 |
// From the ThreadAccess interface via Debugger and JVMDebugger
|
|
132 |
// public ThreadProxy getThreadForIdentifierAddress(Address addr);
|
|
133 |
}
|