diff agent/src/share/classes/sun/jvm/hotspot/types/basic/VtblAccess.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/types/basic/VtblAccess.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2000-2002 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.types.basic;
+
+import sun.jvm.hotspot.debugger.*;
+import sun.jvm.hotspot.types.*;
+
+/** This interface is designed to allow a platform-specific
+    implementation of the TypeDataBase.isOfType() method, while
+    leaving the rest of the basic.* package platform independent. */
+
+public interface VtblAccess {
+  /** This is the necessarily platform-specific implementation.
+      Attempt to return the address of the vtbl for the given
+      polymorphic C++ type. This value will be used when searching
+      nearby memory to implement isOfType() in as platform-independent
+      a manner as possible. Returns null if this value was not
+      available for the given type, which might indicate that the type
+      was not polymorphic or that an error occurred while trying to
+      find the symbol. Note that this method does not support multiple
+      inheritance. */
+  public Address getVtblForType(Type type);
+
+  /** Clear any cached values from symbol lookups in the target
+      process. It is important that this mechanism be fast and for
+      that reason the default implementation memoizes type-to-vtbl
+      mappings. However, if the target process is resumed, these
+      mappings may become invalid. */
+  public void clearCaches();
+}