annotate agent/src/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java @ 3944:35c656d0b685

7090654: nightly failures after 7086585 Reviewed-by: kvn
author never
date Wed, 14 Sep 2011 13:57:32 -0700
parents c18cbe5936b8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
2 * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
0
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 *
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
21 * questions.
0
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.win32.coff;
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 /** Models an entry in the Debug Directory, which is an entry in the
a61af66fc99e Initial load
duke
parents:
diff changeset
28 image optional header. This directory indicates where in the image
a61af66fc99e Initial load
duke
parents:
diff changeset
29 the CodeView debug information appears, if enabled using /Z7
a61af66fc99e Initial load
duke
parents:
diff changeset
30 /PDB:NONE. (Some of the descriptions are taken directly from
a61af66fc99e Initial load
duke
parents:
diff changeset
31 Microsoft's documentation and are copyrighted by Microsoft.) */
a61af66fc99e Initial load
duke
parents:
diff changeset
32
a61af66fc99e Initial load
duke
parents:
diff changeset
33 public interface DebugDirectoryEntry {
a61af66fc99e Initial load
duke
parents:
diff changeset
34 /** A reserved field intended to be used for flags, set to zero for
a61af66fc99e Initial load
duke
parents:
diff changeset
35 now. */
a61af66fc99e Initial load
duke
parents:
diff changeset
36 public int getCharacteristics();
a61af66fc99e Initial load
duke
parents:
diff changeset
37
a61af66fc99e Initial load
duke
parents:
diff changeset
38 /** Time and date the debug data was created. */
a61af66fc99e Initial load
duke
parents:
diff changeset
39 public int getTimeDateStamp();
a61af66fc99e Initial load
duke
parents:
diff changeset
40
a61af66fc99e Initial load
duke
parents:
diff changeset
41 /** Major version number of the debug data format. */
a61af66fc99e Initial load
duke
parents:
diff changeset
42 public short getMajorVersion();
a61af66fc99e Initial load
duke
parents:
diff changeset
43
a61af66fc99e Initial load
duke
parents:
diff changeset
44 /** Minor version number of the debug data format. */
a61af66fc99e Initial load
duke
parents:
diff changeset
45 public short getMinorVersion();
a61af66fc99e Initial load
duke
parents:
diff changeset
46
a61af66fc99e Initial load
duke
parents:
diff changeset
47 /** Format of debugging information: this field enables support of
a61af66fc99e Initial load
duke
parents:
diff changeset
48 multiple debuggers. See
a61af66fc99e Initial load
duke
parents:
diff changeset
49 @link{sun.jvm.hotspot.debugger.win32.coff.DebugTypes}. */
a61af66fc99e Initial load
duke
parents:
diff changeset
50 public int getType();
a61af66fc99e Initial load
duke
parents:
diff changeset
51
a61af66fc99e Initial load
duke
parents:
diff changeset
52 /** Size of the debug data (not including the debug directory itself). */
a61af66fc99e Initial load
duke
parents:
diff changeset
53 public int getSizeOfData();
a61af66fc99e Initial load
duke
parents:
diff changeset
54
a61af66fc99e Initial load
duke
parents:
diff changeset
55 /** Address of the debug data when loaded, relative to the image base. */
a61af66fc99e Initial load
duke
parents:
diff changeset
56 public int getAddressOfRawData();
a61af66fc99e Initial load
duke
parents:
diff changeset
57
a61af66fc99e Initial load
duke
parents:
diff changeset
58 /** File pointer to the debug data. */
a61af66fc99e Initial load
duke
parents:
diff changeset
59 public int getPointerToRawData();
a61af66fc99e Initial load
duke
parents:
diff changeset
60
a61af66fc99e Initial load
duke
parents:
diff changeset
61 /** If this debug directory entry is of type
a61af66fc99e Initial load
duke
parents:
diff changeset
62 IMAGE_DEBUG_TYPE_CODEVIEW (see
a61af66fc99e Initial load
duke
parents:
diff changeset
63 @link{sun.jvm.hotspot.debugger.win32.coff.DebugTypes}), returns
a61af66fc99e Initial load
duke
parents:
diff changeset
64 the contents as a DebugVC50 object; otherwise, returns null. */
a61af66fc99e Initial load
duke
parents:
diff changeset
65 public DebugVC50 getDebugVC50();
a61af66fc99e Initial load
duke
parents:
diff changeset
66
a61af66fc99e Initial load
duke
parents:
diff changeset
67 /** Placeholder */
a61af66fc99e Initial load
duke
parents:
diff changeset
68 public byte getRawDataByte(int i);
a61af66fc99e Initial load
duke
parents:
diff changeset
69 }