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 25 package sun.jvm.hotspot.debugger.linux; 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 LinuxDebugger 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 LinuxAddress readAddress(long address) throws DebuggerException; 48 public LinuxAddress readCompOopAddress(long address) throws DebuggerException; 49 public LinuxAddress readCompKlassAddress(long address) throws DebuggerException; 50 public LinuxOopHandle readOopHandle(long address) throws DebuggerException; 51 public LinuxOopHandle readCompOopHandle(long address) throws DebuggerException; 52 public long[] getThreadIntegerRegisterSet(int lwp_id) throws DebuggerException; 53 public long getAddressValue(Address addr) throws DebuggerException; 54 public Address newAddress(long value) throws DebuggerException; 55 56 // For LinuxCDebugger 57 public List getThreadList(); 58 public List getLoadObjectList(); 59 public ClosestSymbol lookup(long address); 60 public String demangle(String sym); 61 62 // NOTE: this interface implicitly contains the following methods: 63 // From the Debugger interface via JVMDebugger 64 // public void attach(int processID) throws DebuggerException; 65 // public void attach(String executableName, String coreFileName) throws DebuggerException; 66 // public boolean detach(); 67 // public Address parseAddress(String addressString) throws NumberFormatException; 68 // public String getOS(); 69 // public String getCPU(); 70 // From the SymbolLookup interface via Debugger and JVMDebugger 71 // public Address lookup(String objectName, String symbol); 72 // public OopHandle lookupOop(String objectName, String symbol); 73 // From the JVMDebugger interface 74 // public void configureJavaPrimitiveTypeSizes(long jbooleanSize, 75 // long jbyteSize, 76 // long jcharSize, 77 // long jdoubleSize, 78 // long jfloatSize, 79 // long jintSize, 80 // long jlongSize, 81 // long jshortSize); 82 // From the ThreadAccess interface via Debugger and JVMDebugger 83 // public ThreadProxy getThreadForIdentifierAddress(Address addr); 84 }