An implementation of the JVMDebugger interface. The basic debug facilities are implemented through ptrace interface in the JNI code (libsaproc.so). Library maps and symbol table management are done in JNI.
Note
that since we have the notion of fetching "Java primitive types" from the remote process (which might have different sizes than we expect) we have a bootstrapping problem. We need to know the sizes of these types before we can fetch them. The current implementation solves this problem by requiring that it be configured with these type sizes before they can be fetched. The readJ(Type) routines here will throw a RuntimeException if they are called before the debugger is configured with the Java primitive type sizes.
| Modifier and Type | Class and Description |
|---|---|
| pack-priv class | |
| pack-priv static interface |
| Modifier and Type | Field and Description |
|---|---|
| private boolean | |
| private BsdCDebugger | |
| private boolean | |
| private boolean | |
| private List | |
| private long | |
| private long | |
| private long | |
| private List | |
| private boolean | |
| private BsdDebuggerLocal. |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public String | addressValueToString(long address)
Implements sun. From the BsdDebugger interface |
| public synchronized void | attach(int processID)
Implements sun. From the Debugger interface via JVMDebugger |
| public synchronized void | attach(String execName, String coreName)
Implements sun. From the Debugger interface via JVMDebugger |
| private native void | |
| private native void | |
| private void | |
| public String | consoleExecuteCommand(String cmd)
Implements sun. If the underlying debugger has a console (as dbx does), this provides access to it. |
| private ClosestSymbol | |
| private LoadObject | |
| public synchronized boolean | detach()
Implements sun. From the Debugger interface via JVMDebugger |
| private native void | |
| private void | |
| public static native int | |
| public long | getAddressValue(Address addr)
Implements sun. From the BsdDebugger interface |
| public CDebugger | getCDebugger()
Implements sun. If this platform supports C/C++ debugging via the CDebugger interface, returns a CDebugger object; otherwise returns null. |
| public String | getConsolePrompt()
Implements sun. If the underlying debugger has a console, this returns the debugger-specific prompt which should be displayed. |
| public String | getCPU()
Implements sun. From the Debugger interface via JVMDebugger |
| public long[] | getJavaThreadsInfo()
this functions used for core file reading and called from native attach0, it returns an array of long integers as [thread_id, stack_start, stack_end, thread_id, stack_start, stack_end, ....] for all java threads recorded in Threads. |
| public List | getLoadObjectList()
Implements sun. From the BsdCDebugger interface |
| public MachineDescription | getMachineDescription()
Implements sun. From the Debugger interface |
| public String | getOS()
Implements sun. From the Debugger interface via JVMDebugger |
| public List | getProcessList()
Implements sun. From the Debugger interface via JVMDebugger |
| public ThreadProxy | getThreadForIdentifierAddress(Address threadIdAddr, Address uniqueThreadIdAddr)
From the ThreadAccess interface via Debugger and JVMDebugger |
| public ThreadProxy | getThreadForIdentifierAddress(Address addr)
Implements sun. Gets an abstract ThreadProxy object for the thread identified by the contents of the memory location pointed to by addr. |
| public ThreadProxy | getThreadForThreadId(long id)
Implements sun. From the ThreadAccess interface via Debugger and JVMDebugger |
| public synchronized long[] | getThreadIntegerRegisterSet(long unique_thread_id)
Implements sun.
|
| private native long[] | |
| public List | getThreadList()
Implements sun. From the BsdCDebugger interface |
| private long | |
| public boolean | hasConsole()
Implements sun. Find out whether this debugger has a console available on which commands can be executed; see executeCommandOnConsole, below. |
| public boolean | hasProcessList()
Implements sun. From the Debugger interface via JVMDebugger |
| private static native void | |
| public synchronized Address | lookup(String objectName, String symbol)
Implements sun. From the SymbolLookup interface via Debugger and JVMDebugger |
| public synchronized ClosestSymbol | lookup(long addr)
Implements sun. From the BsdCDebugger interface |
| private native ClosestSymbol | |
| private native long | |
| public synchronized OopHandle | lookupOop(String objectName, String symbol)
Implements sun. From the SymbolLookup interface via Debugger and JVMDebugger |
| public Address | newAddress(long value)
Implements sun. From the BsdDebugger interface |
| public Address | parseAddress(String addressString)
Implements sun. From the Debugger interface via JVMDebugger |
| public BsdAddress | readAddress(long address)
Implements sun. From the BsdDebugger interface |
| public synchronized ReadResult | readBytesFromProcess(long address, long numBytes)
Implements sun. This reads bytes from the remote process. |
| private native byte[] | |
| public BsdAddress | readCompKlassAddress(long address)
Implements sun.
|
| public BsdAddress | readCompOopAddress(long address)
Implements sun.
|
| public BsdOopHandle | readCompOopHandle(long address)
Implements sun.
|
| public BsdOopHandle | readOopHandle(long address)
Implements sun. From the BsdDebugger interface |
| private void |
| attached | back to summary |
|---|---|
| private boolean attached | |
| cdbg | back to summary |
|---|---|
| private BsdCDebugger cdbg | |
| isCore | back to summary |
|---|---|
| private boolean isCore | |
| isDarwin | back to summary |
|---|---|
| private boolean isDarwin | |
| loadObjectList | back to summary |
|---|---|
| private List<LoadObject> loadObjectList | |
| p_ps_prochandle | back to summary |
|---|---|
| private long p_ps_prochandle | |
| symbolicator | back to summary |
|---|---|
| private long symbolicator | |
| task | back to summary |
|---|---|
| private long task | |
| threadList | back to summary |
|---|---|
| private List<ThreadProxy> threadList | |
| useGCC32ABI | back to summary |
|---|---|
| private boolean useGCC32ABI | |
| workerThread | back to summary |
|---|---|
| private BsdDebuggerLocal. | |
| BsdDebuggerLocal | back to summary |
|---|---|
| public BsdDebuggerLocal(MachineDescription machDesc, boolean useCache) throws DebuggerException machDesc may not be null. useCache should be set to true if debugging is being done locally, and to false if the debugger is being created for the purpose of supporting remote debugging. | |
| addressValueToString | back to summary |
|---|---|
| public String addressValueToString(long address) Implements sun. From the BsdDebugger interface | |
| attach | back to summary |
|---|---|
| public synchronized void attach(int processID) throws DebuggerException Implements sun. From the Debugger interface via JVMDebugger | |
| attach | back to summary |
|---|---|
| public synchronized void attach(String execName, String coreName) Implements sun. From the Debugger interface via JVMDebugger | |
| attach0 | back to summary |
|---|---|
| private native void attach0(int pid) throws DebuggerException | |
| attach0 | back to summary |
|---|---|
| private native void attach0(String execName, String coreName) throws DebuggerException | |
| checkAttached | back to summary |
|---|---|
| private void checkAttached() throws DebuggerException | |
| consoleExecuteCommand | back to summary |
|---|---|
| public String consoleExecuteCommand(String cmd) throws DebuggerException Implements sun. Doc from sun. If the underlying debugger has a console (as dbx does), this provides access to it. Takes in a platform-dependent String, executes it on the debugger's console, and returns any output as a String. | |
| createClosestSymbol | back to summary |
|---|---|
| private ClosestSymbol createClosestSymbol(String name, long offset) | |
| createLoadObject | back to summary |
|---|---|
| private LoadObject createLoadObject(String fileName, long size, long base) | |
| detach | back to summary |
|---|---|
| public synchronized boolean detach() Implements sun. From the Debugger interface via JVMDebugger | |
| detach0 | back to summary |
|---|---|
| private native void detach0() throws DebuggerException | |
| findABIVersion | back to summary |
|---|---|
| private void findABIVersion() throws DebuggerException | |
| getAddressSize | back to summary |
|---|---|
| public static native int getAddressSize() | |
| getAddressValue | back to summary |
|---|---|
| public long getAddressValue(Address addr) Implements sun. From the BsdDebugger interface | |
| getCDebugger | back to summary |
|---|---|
| public CDebugger getCDebugger() Implements sun. Doc from sun. If this platform supports C/C++ debugging via the CDebugger interface, returns a CDebugger object; otherwise returns null. | |
| getConsolePrompt | back to summary |
|---|---|
| public String getConsolePrompt() throws DebuggerException Implements sun. Doc from sun. If the underlying debugger has a console, this returns the debugger-specific prompt which should be displayed. | |
| getCPU | back to summary |
|---|---|
| public String getCPU() Implements sun. From the Debugger interface via JVMDebugger | |
| getJavaThreadsInfo | back to summary |
|---|---|
| public long[] getJavaThreadsInfo() this functions used for core file reading and called from native attach0, it returns an array of long integers as [thread_id, stack_start, stack_end, thread_id, stack_start, stack_end, ....] for all java threads recorded in Threads. Also adds the ThreadProxy to threadList | |
| getLoadObjectList | back to summary |
|---|---|
| public List Implements sun. From the BsdCDebugger interface | |
| getMachineDescription | back to summary |
|---|---|
| public MachineDescription getMachineDescription() Implements sun. From the Debugger interface | |
| getOS | back to summary |
|---|---|
| public String getOS() Implements sun. From the Debugger interface via JVMDebugger | |
| getProcessList | back to summary |
|---|---|
| public List Implements sun. From the Debugger interface via JVMDebugger | |
| getThreadForIdentifierAddress | back to summary |
|---|---|
| public ThreadProxy getThreadForIdentifierAddress(Address threadIdAddr, Address uniqueThreadIdAddr) From the ThreadAccess interface via Debugger and JVMDebugger | |
| getThreadForIdentifierAddress | back to summary |
|---|---|
| public ThreadProxy getThreadForIdentifierAddress(Address addr) Implements sun. Doc from sun. Gets an abstract ThreadProxy object for the thread identified by the contents of the memory location pointed to by addr. The contents at location addr are inherently platform-dependent; see the documentation for this class for more information. FIXME: what exception, if any, should this throw?
| |
| getThreadForThreadId | back to summary |
|---|---|
| public ThreadProxy getThreadForThreadId(long id) Implements sun. From the ThreadAccess interface via Debugger and JVMDebugger | |
| getThreadIntegerRegisterSet | back to summary |
|---|---|
| public synchronized long[] getThreadIntegerRegisterSet(long unique_thread_id) throws DebuggerException Implements sun. | |
| getThreadIntegerRegisterSet0 | back to summary |
|---|---|
| private native long[] getThreadIntegerRegisterSet0(long unique_thread_id) throws DebuggerException | |
| getThreadList | back to summary |
|---|---|
| public List Implements sun. From the BsdCDebugger interface | |
| handleGCC32ABI | back to summary |
|---|---|
| private long handleGCC32ABI(long addr, String symbol) throws DebuggerException | |
| hasConsole | back to summary |
|---|---|
| public boolean hasConsole() throws DebuggerException Implements sun. Doc from sun. Find out whether this debugger has a console available on which commands can be executed; see executeCommandOnConsole, below. This is an interim routine designed to allow access to the underlying dbx process on Solaris until we have disassembly, etc. in the SA. | |
| hasProcessList | back to summary |
|---|---|
| public boolean hasProcessList() throws DebuggerException Implements sun. From the Debugger interface via JVMDebugger | |
| init0 | back to summary |
|---|---|
| private static native void init0() throws DebuggerException | |
| lookup | back to summary |
|---|---|
| public synchronized Address lookup(String objectName, String symbol) Implements sun. From the SymbolLookup interface via Debugger and JVMDebugger | |
| lookup | back to summary |
|---|---|
| public synchronized ClosestSymbol lookup(long addr) Implements sun. From the BsdCDebugger interface | |
| lookupByAddress0 | back to summary |
|---|---|
| private native ClosestSymbol lookupByAddress0(long address) throws DebuggerException | |
| lookupByName0 | back to summary |
|---|---|
| private native long lookupByName0(String objectName, String symbol) throws DebuggerException | |
| lookupOop | back to summary |
|---|---|
| public synchronized OopHandle lookupOop(String objectName, String symbol) Implements sun. From the SymbolLookup interface via Debugger and JVMDebugger | |
| newAddress | back to summary |
|---|---|
| public Address newAddress(long value) Implements sun. From the BsdDebugger interface | |
| parseAddress | back to summary |
|---|---|
| public Address parseAddress(String addressString) throws NumberFormatException Implements sun. From the Debugger interface via JVMDebugger | |
| readAddress | back to summary |
|---|---|
| public BsdAddress readAddress(long address) throws UnmappedAddressException, UnalignedAddressException Implements sun. From the BsdDebugger interface | |
| readBytesFromProcess | back to summary |
|---|---|
| public synchronized ReadResult readBytesFromProcess(long address, long numBytes) throws UnmappedAddressException, DebuggerException Implements sun. This reads bytes from the remote process. | |
| readBytesFromProcess0 | back to summary |
|---|---|
| private native byte[] readBytesFromProcess0(long address, long numBytes) throws DebuggerException | |
| readCompKlassAddress | back to summary |
|---|---|
| public BsdAddress readCompKlassAddress(long address) throws UnmappedAddressException, UnalignedAddressException Implements sun. | |
| readCompOopAddress | back to summary |
|---|---|
| public BsdAddress readCompOopAddress(long address) throws UnmappedAddressException, UnalignedAddressException Implements sun. | |
| readCompOopHandle | back to summary |
|---|---|
| public BsdOopHandle readCompOopHandle(long address) throws UnmappedAddressException, UnalignedAddressException, NotInHeapException Implements sun. | |
| readOopHandle | back to summary |
|---|---|
| public BsdOopHandle readOopHandle(long address) throws UnmappedAddressException, UnalignedAddressException, NotInHeapException Implements sun. From the BsdDebugger interface | |
| requireAttach | back to summary |
|---|---|
| private void requireAttach() | |
| Modifier and Type | Field and Description |
|---|---|
| pack-priv BsdDebuggerLocal | |
| pack-priv DebuggerException | |
| pack-priv BsdDebuggerLocal. |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public BsdDebuggerLocal. | |
| public void | run()
Overrides java. Implements java. This method is run by the thread when it executes. |
| debugger | back to summary |
|---|---|
| pack-priv BsdDebuggerLocal debugger | |
| lastException | back to summary |
|---|---|
| pack-priv DebuggerException lastException | |
| task | back to summary |
|---|---|
| pack-priv BsdDebuggerLocal. | |
| BsdDebuggerLocalWorkerThread | back to summary |
|---|---|
| public BsdDebuggerLocalWorkerThread(BsdDebuggerLocal debugger) | |
| execute | back to summary |
|---|---|
| public BsdDebuggerLocal. | |
| run | back to summary |
|---|---|
| public void run() Overrides java. Implements java. Doc from java. This method is run by the thread when it executes. Subclasses of This method is not intended to be invoked directly. If this thread is a
platform thread created with a | |
| Modifier and Type | Method and Description |
|---|---|
| public void |
| doit | back to summary |
|---|---|
| public void doit(BsdDebuggerLocal debugger) throws DebuggerException | |