/*
* Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*
*/
package sun.jvm.hotspot.debugger.cdbg;
import sun.jvm.hotspot.debugger.*;
/** A LoadObject models a DSO/DLL/EXE; that is, an entity relocated by
the run-time linker. */
public interface LoadObject {
/** Base address at which this loadobject was relocated at run-time */
public Address getBase();
/** Full path name of this loadobject */
public String getName();
/** Size of the loadobject in bytes (determines the range of program
counters and data contained within this loadobject) */
public long getSize();
/** Returns a debug info database for this loadobject if debug info
is present; otherwise, returns null. */
public CDebugInfoDataBase getDebugInfoDataBase() throws DebuggerException;
/** Get debug information for the given program counter. PC must be
contained within this loadobject or a DebuggerException is
thrown. Returns null if there is no debug information available
(i.e., because this is not a debug build). */
public BlockSym debugInfoForPC(Address pc) throws DebuggerException;
/** Fetch the name of the closest exported symbol and the distance
of the PC to that symbol. Returns null if the PC was not within
this loadobject or if a symbol could not be found before this
PC. FIXME: specify whether this is mangled/demangled. */
public ClosestSymbol closestSymbolToPC(Address pc) throws DebuggerException;
/** Returns line number information for the given PC, including
/**代码未完, 请加载全部代码(NowJava.com).**/