annotate agent/src/share/classes/sun/jvm/hotspot/debugger/MachineDescription.java @ 0:a61af66fc99e jdk7-b24

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children ba764ed4b6f2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
a61af66fc99e Initial load
duke
parents:
diff changeset
2 * Copyright 2000-2001 Sun Microsystems, Inc. All Rights Reserved.
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
a61af66fc99e Initial load
duke
parents:
diff changeset
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
a61af66fc99e Initial load
duke
parents:
diff changeset
20 * CA 95054 USA or visit www.sun.com if you need additional information or
a61af66fc99e Initial load
duke
parents:
diff changeset
21 * have any questions.
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 package sun.jvm.hotspot.debugger;
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 import java.io.Serializable;
a61af66fc99e Initial load
duke
parents:
diff changeset
28
a61af66fc99e Initial load
duke
parents:
diff changeset
29 /** Encapsulates machine-specific information that currently must be
a61af66fc99e Initial load
duke
parents:
diff changeset
30 exported up to the Java level. Implementations must be
a61af66fc99e Initial load
duke
parents:
diff changeset
31 serializable. */
a61af66fc99e Initial load
duke
parents:
diff changeset
32
a61af66fc99e Initial load
duke
parents:
diff changeset
33 public interface MachineDescription extends Serializable {
a61af66fc99e Initial load
duke
parents:
diff changeset
34 /** Returns the size of an address in bytes. Currently needed to be
a61af66fc99e Initial load
duke
parents:
diff changeset
35 able to traverse arrays of pointers or oops. */
a61af66fc99e Initial load
duke
parents:
diff changeset
36 public long getAddressSize();
a61af66fc99e Initial load
duke
parents:
diff changeset
37
a61af66fc99e Initial load
duke
parents:
diff changeset
38 /** Returns the size of an address in bytes. Currently needed to be
a61af66fc99e Initial load
duke
parents:
diff changeset
39 able to traverse arrays of pointers or oops. (FIXME: since we're
a61af66fc99e Initial load
duke
parents:
diff changeset
40 already reading the Java primitive types' sizes from the remote
a61af66fc99e Initial load
duke
parents:
diff changeset
41 VM, it would be nice to remove this routine, using a similar
a61af66fc99e Initial load
duke
parents:
diff changeset
42 mechanism to how the TypeDataBase deals with primitive types.) */
a61af66fc99e Initial load
duke
parents:
diff changeset
43 public long getOopSize();
a61af66fc99e Initial load
duke
parents:
diff changeset
44
a61af66fc99e Initial load
duke
parents:
diff changeset
45 /** Returns the maximum value of the C integer type with the given
a61af66fc99e Initial load
duke
parents:
diff changeset
46 size in bytes and signedness. Throws IllegalArgumentException if
a61af66fc99e Initial load
duke
parents:
diff changeset
47 the size in bytes is not legal for a C type (or can not be
a61af66fc99e Initial load
duke
parents:
diff changeset
48 handled by this system). Note that the current implementation
a61af66fc99e Initial load
duke
parents:
diff changeset
49 does not currently handle unsigned 8-byte longs properly. */
a61af66fc99e Initial load
duke
parents:
diff changeset
50 public long cIntegerTypeMaxValue(long sizeInBytes, boolean isUnsigned);
a61af66fc99e Initial load
duke
parents:
diff changeset
51
a61af66fc99e Initial load
duke
parents:
diff changeset
52 /** Returns the minimum value of the C integer type with the given
a61af66fc99e Initial load
duke
parents:
diff changeset
53 size in bytes and signedness. Throws IllegalArgumentException if
a61af66fc99e Initial load
duke
parents:
diff changeset
54 the size in bytes is not legal for a C type (or can not be
a61af66fc99e Initial load
duke
parents:
diff changeset
55 handled by this system). */
a61af66fc99e Initial load
duke
parents:
diff changeset
56 public long cIntegerTypeMinValue(long sizeInBytes, boolean isUnsigned);
a61af66fc99e Initial load
duke
parents:
diff changeset
57
a61af66fc99e Initial load
duke
parents:
diff changeset
58 /** Indicates whether the CPU is big- or little-endian. This
a61af66fc99e Initial load
duke
parents:
diff changeset
59 information is typically only needed by the Debugger
a61af66fc99e Initial load
duke
parents:
diff changeset
60 implementation. */
a61af66fc99e Initial load
duke
parents:
diff changeset
61 public boolean isBigEndian();
a61af66fc99e Initial load
duke
parents:
diff changeset
62
a61af66fc99e Initial load
duke
parents:
diff changeset
63 /** Indicates whether the underlying machine supports the LP64 data
a61af66fc99e Initial load
duke
parents:
diff changeset
64 model (currently only SPARC/64). */
a61af66fc99e Initial load
duke
parents:
diff changeset
65 public boolean isLP64();
a61af66fc99e Initial load
duke
parents:
diff changeset
66 }