Mercurial > hg > truffle

comparison agent/src/share/classes/sun/jvm/hotspot/debugger/win32/Win32Debugger.java @ 0:a61af66fc99e jdk7-b24

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 }