annotate agent/src/share/classes/sun/jvm/hotspot/debugger/win32/Win32Debugger.java @ 196:d1605aabd0a1 jdk7-b30

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