|
0
|
1 /*
|
|
|
2 * Copyright 2000-2007 Sun Microsystems, Inc. All Rights Reserved.
|
|
|
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
|
4 *
|
|
|
5 * This code is free software; you can redistribute it and/or modify it
|
|
|
6 * under the terms of the GNU General Public License version 2 only, as
|
|
|
7 * published by the Free Software Foundation.
|
|
|
8 *
|
|
|
9 * This code is distributed in the hope that it will be useful, but WITHOUT
|
|
|
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
12 * version 2 for more details (a copy is included in the LICENSE file that
|
|
|
13 * accompanied this code).
|
|
|
14 *
|
|
|
15 * You should have received a copy of the GNU General Public License version
|
|
|
16 * 2 along with this work; if not, write to the Free Software Foundation,
|
|
|
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
18 *
|
|
|
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
|
|
|
20 * CA 95054 USA or visit www.sun.com if you need additional information or
|
|
|
21 * have any questions.
|
|
|
22 *
|
|
|
23 */
|
|
|
24
|
|
|
25 package sun.jvm.hotspot.debugger;
|
|
|
26
|
|
|
27 /** <P> This is a tag interface (similar to Cloneable) which indicates
|
|
|
28 that the contained address is "special" and is updated under the
|
|
|
29 hood by the VM. The purpose is to support implementation of
|
|
|
30 reflection on the current VM with these interfaces; if the Java
|
|
|
31 code implementing parts of the VM requires proxies for objects in
|
|
|
32 the heap, it must be the case that those proxies are updated if GC
|
|
|
33 occurs. This is the level at which this updating is handled. The
|
|
|
34 VM (and specifically the GC code) must have intimate knowledge of
|
|
|
35 the VM-specific implementation of this interface. </P>
|
|
|
36
|
|
|
37 <P> Note that in the case of debugging a remote VM, it is not
|
|
|
38 workable to handle the automatic updating of these handles.
|
|
|
39 If the debugger allows the VM to resume running, it will have to
|
|
|
40 look up once again any object references via the path they were
|
|
|
41 found (i.e., the activation on the stack as the root, etc.) </P>
|
|
|
42 */
|
|
|
43
|
|
|
44 public interface OopHandle extends Address {
|
|
|
45 }
|
