1/*
2 * Copyright (c) 2002, 2008, Oracle and/or its affiliates. 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25package sun.jvm.hotspot.debugger.windbg;
26
27import java.util.List;
28import sun.jvm.hotspot.debugger.*;
29import 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
35public interface WindbgDebugger 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 WindbgAddress readAddress(long address) throws DebuggerException;
48  public WindbgAddress readCompOopAddress(long address) throws DebuggerException;
49  public WindbgAddress readCompKlassAddress(long address) throws DebuggerException;
50  public WindbgOopHandle readOopHandle(long address) throws DebuggerException;
51  public WindbgOopHandle readCompOopHandle(long address) throws DebuggerException;
52
53  // The returned array of register contents is guaranteed to be in
54  // the same order as in the DbxDebugger for Solaris/x86 or amd64; that is,
55  // the indices match those in debugger/x86/X86ThreadContext.java or
56  // debugger/amd64/AMD64ThreadContext.java.
57  public long[]       getThreadIntegerRegisterSet(long threadId) throws DebuggerException;
58  public Address      newAddress(long value) throws DebuggerException;
59
60  public long         getThreadIdFromSysId(long sysId) throws DebuggerException;
61  // Support for the CDebugger interface. Retrieves the thread list of
62  // the target process as a List of ThreadProxy objects.
63  public List/*<ThreadProxy>*/ getThreadList() throws DebuggerException;
64
65  // Support for the CDebugger interface. Retrieves a List of the
66  // loadobjects in the target process.
67  public List/*<LoadObject>*/ getLoadObjectList() throws DebuggerException;
68
69  // NOTE: this interface implicitly contains the following methods:
70  // From the Debugger interface via JVMDebugger
71  //   public void attach(int processID) throws DebuggerException;
72  //   public void attach(String executableName, String coreFileName) throws DebuggerException;
73  //   public boolean detach();
74  //   public Address parseAddress(String addressString) throws NumberFormatException;
75  //   public long getAddressValue(Address addr) throws DebuggerException;
76  //   public String getOS();
77  //   public String getCPU();
78  // From the SymbolLookup interface via Debugger and JVMDebugger
79  //   public Address lookup(String objectName, String symbol);
80  //   public OopHandle lookupOop(String objectName, String symbol);
81  // From the JVMDebugger interface
82  //   public void configureJavaPrimitiveTypeSizes(long jbooleanSize,
83  //                                               long jbyteSize,
84  //                                               long jcharSize,
85  //                                               long jdoubleSize,
86  //                                               long jfloatSize,
87  //                                               long jintSize,
88  //                                               long jlongSize,
89  //                                               long jshortSize);
90  // From the ThreadAccess interface via Debugger and JVMDebugger
91  //   public ThreadProxy getThreadForIdentifierAddress(Address addr);
92
93  public int getAddressSize();
94}
95