Mercurial > hg > truffle
comparison 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 |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:a61af66fc99e |
---|---|
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 } |