diff agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/CDebugInfoDataBase.java @ 0:a61af66fc99e jdk7-b24

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children c18cbe5936b8
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/CDebugInfoDataBase.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,64 @@
+/*
+ * 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.*;
+
+/** Database for C and C++ debug information. This is being kept as
+    minimal as possible for now. It is not complete; for example, it
+    will have to be extended to support scoped information (module
+    scope, namespace scope). */
+
+public interface CDebugInfoDataBase {
+  /** Name-to-type mapping */
+  public Type lookupType(String name);
+
+  /** Name-to-type mapping with const/volatile qualifications */
+  public Type lookupType(String name, int cvAttributes);
+
+  /** Iteration through all types */
+  public void iterate(TypeVisitor t);
+
+  /** Return debug info (closest lexically-enclosing block) for
+      current program counter. Returns null if no debug information
+      found or available. */
+  public BlockSym debugInfoForPC(Address pc);
+
+  /** Look up global or module-local symbol by name. FIXME: need some
+      way to identify modules -- has not been thought through yet
+      because it isn't clear exactly how these are represented in the
+      Visual C++ debug info. */
+  public GlobalSym lookupSym(String name);
+
+  /** 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. */
+  public LineNumberInfo lineNumberForPC(Address pc) throws DebuggerException;
+
+  /** Iteration through all line number information in this
+      database. */
+  public void iterate(LineNumberVisitor v);
+}