1 /* 2 * Copyright (c) 2002, 2019, 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 public long findLibPtrByAddress(Address pc); 56 57 // For LinuxCDebugger 58 public List getThreadList(); 59 public List getLoadObjectList(); 60 public ClosestSymbol lookup(long address); 61 public String demangle(String sym); 62 63 // NOTE: this interface implicitly contains the following methods: 64 // From the Debugger interface via JVMDebugger 65 // public void attach(int processID) throws DebuggerException; 66 // public void attach(String executableName, String coreFileName) throws DebuggerException; 67 // public boolean detach(); 68 // public Address parseAddress(String addressString) throws NumberFormatException; 69 // public String getOS(); 70 // public String getCPU(); 71 // From the SymbolLookup interface via Debugger and JVMDebugger 72 // public Address lookup(String objectName, String symbol); 73 // public OopHandle lookupOop(String objectName, String symbol); 74 // From the JVMDebugger interface 75 // public void configureJavaPrimitiveTypeSizes(long jbooleanSize, 76 // long jbyteSize, 77 // long jcharSize, 78 // long jdoubleSize, 79 // long jfloatSize, 80 // long jintSize, 81 // long jlongSize, 82 // long jshortSize); 83 // From the ThreadAccess interface via Debugger and JVMDebugger 84 // public ThreadProxy getThreadForIdentifierAddress(Address addr); 85 }