1 /* 2 * Copyright (c) 2002, 2020, 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.bsd; 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 BsdDebugger extends JVMDebugger { addressValueToString(long address)36 public String addressValueToString(long address) throws DebuggerException; readJBoolean(long address)37 public boolean readJBoolean(long address) throws DebuggerException; readJByte(long address)38 public byte readJByte(long address) throws DebuggerException; readJChar(long address)39 public char readJChar(long address) throws DebuggerException; readJDouble(long address)40 public double readJDouble(long address) throws DebuggerException; readJFloat(long address)41 public float readJFloat(long address) throws DebuggerException; readJInt(long address)42 public int readJInt(long address) throws DebuggerException; readJLong(long address)43 public long readJLong(long address) throws DebuggerException; readJShort(long address)44 public short readJShort(long address) throws DebuggerException; readCInteger(long address, long numBytes, boolean isUnsigned)45 public long readCInteger(long address, long numBytes, boolean isUnsigned) 46 throws DebuggerException; readAddress(long address)47 public BsdAddress readAddress(long address) throws DebuggerException; readCompOopAddress(long address)48 public BsdAddress readCompOopAddress(long address) throws DebuggerException; readCompKlassAddress(long address)49 public BsdAddress readCompKlassAddress(long address) throws DebuggerException; readOopHandle(long address)50 public BsdOopHandle readOopHandle(long address) throws DebuggerException; readCompOopHandle(long address)51 public BsdOopHandle readCompOopHandle(long address) throws DebuggerException; getThreadIntegerRegisterSet(long unique_thread_id)52 public long[] getThreadIntegerRegisterSet(long unique_thread_id) throws DebuggerException; getAddressValue(Address addr)53 public long getAddressValue(Address addr) throws DebuggerException; newAddress(long value)54 public Address newAddress(long value) throws DebuggerException; findLibPtrByAddress(Address pc)55 public Address findLibPtrByAddress(Address pc); 56 57 // For BsdCDebugger getThreadList()58 public List<ThreadProxy> getThreadList(); getLoadObjectList()59 public List<LoadObject> getLoadObjectList(); lookup(long address)60 public ClosestSymbol lookup(long address); demangle(String sym)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 } 86