--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/LoadObject.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,65 @@
+/*
+ * Copyright 2001 Sun Microsystems, Inc.  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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.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
+      source file name (not specified whether this is an absolute or
+      relative path) and start and end PCs for this line. Returns null
+      if no line number information is available or if the given PC is
+      not in this loadobject. */
+  public LineNumberInfo lineNumberForPC(Address pc) throws DebuggerException;
+}