1 /* 2 * Copyright (c) 2002, 2009, 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.remote; 26 27 import java.rmi.*; 28 29 import sun.jvm.hotspot.debugger.*; 30 31 /** <P> This interface describes the methods which are used in a 32 remote debugging scenario. It is only necessary because RMI 33 requires that all such methods throw RemoteException, which is a 34 checked (i.e., not a Runtime) exception. Since we already have a 35 suitable runtime exception (DebuggerException) present in the 36 signatures for all of the debugger-related methods, we would like 37 to repurpose this to wrap RemoteExceptions. This is done by 38 wrapping the actual remote debugger object 39 </P> 40 41 <P> NOTE that this interface currently assumes that the debugger 42 on the remote machine has already been attached to the target 43 process or has opened the desired core file. This implies that the 44 machine hosting the user interface can not effect 45 attaching/detaching. Currently this restriction has been enforced 46 to make the user interface less confusing, but there will also be 47 security concerns with allowing clients to attach to arbitrary 48 remote processes. </P> 49 */ 50 51 public interface RemoteDebugger extends Remote { getOS()52 public String getOS() throws RemoteException; getCPU()53 public String getCPU() throws RemoteException; getMachineDescription()54 public MachineDescription getMachineDescription() throws RemoteException; lookupInProcess(String objectName, String symbol)55 public long lookupInProcess(String objectName, String symbol) throws RemoteException; readBytesFromProcess(long address, long numBytes)56 public ReadResult readBytesFromProcess(long address, long numBytes) throws RemoteException; hasConsole()57 public boolean hasConsole() throws RemoteException; getConsolePrompt()58 public String getConsolePrompt() throws RemoteException; consoleExecuteCommand(String cmd)59 public String consoleExecuteCommand(String cmd) throws RemoteException; getJBooleanSize()60 public long getJBooleanSize() throws RemoteException; getJByteSize()61 public long getJByteSize() throws RemoteException; getJCharSize()62 public long getJCharSize() throws RemoteException; getJDoubleSize()63 public long getJDoubleSize() throws RemoteException; getJFloatSize()64 public long getJFloatSize() throws RemoteException; getJIntSize()65 public long getJIntSize() throws RemoteException; getJLongSize()66 public long getJLongSize() throws RemoteException; getJShortSize()67 public long getJShortSize() throws RemoteException; getHeapOopSize()68 public long getHeapOopSize() throws RemoteException; getNarrowOopBase()69 public long getNarrowOopBase() throws RemoteException; getNarrowOopShift()70 public int getNarrowOopShift() throws RemoteException; getKlassPtrSize()71 public long getKlassPtrSize() throws RemoteException; getNarrowKlassBase()72 public long getNarrowKlassBase() throws RemoteException; getNarrowKlassShift()73 public int getNarrowKlassShift() throws RemoteException; 74 areThreadsEqual(long addrOrId1, boolean isAddress1, long addrOrId2, boolean isAddress2)75 public boolean areThreadsEqual(long addrOrId1, boolean isAddress1, 76 long addrOrId2, boolean isAddress2) throws RemoteException; getThreadHashCode(long addrOrId, boolean isAddress)77 public int getThreadHashCode(long addrOrId, boolean isAddress) throws RemoteException; getThreadIntegerRegisterSet(long addrOrId, boolean isAddress)78 public long[] getThreadIntegerRegisterSet(long addrOrId, boolean isAddress) throws RemoteException; 79 } 80