Mercurial > hg > truffle
annotate src/share/tools/hsdis/hsdis.h @ 20787:4206e725d584 jdk8u31-b13
Added tag jdk8u31-b12 for changeset e13839545238
author | asaha |
---|---|
date | Mon, 08 Dec 2014 12:28:35 -0800 |
parents | 3d701c802d01 |
children |
rev | line source |
---|---|
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
1 /* |
6782 | 2 * Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved. |
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
4 * |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
5 * This code is free software; you can redistribute it and/or modify it |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
6 * under the terms of the GNU General Public License version 2 only, as |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
7 * published by the Free Software Foundation. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
8 * |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
9 * This code is distributed in the hope that it will be useful, but WITHOUT |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
12 * version 2 for more details (a copy is included in the LICENSE file that |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
13 * accompanied this code). |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
14 * |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
15 * You should have received a copy of the GNU General Public License version |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
16 * 2 along with this work; if not, write to the Free Software Foundation, |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
18 * |
1552
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
100
diff
changeset
|
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
100
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:
100
diff
changeset
|
21 * questions. |
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
22 * |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
23 */ |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
24 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
25 /* decode_instructions -- dump a range of addresses as native instructions |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
26 This implements the protocol required by the HotSpot PrintAssembly option. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
27 |
6782 | 28 The start_va, end_va is the virtual address the region of memory to |
29 disasemble and buffer contains the instructions to decode, | |
30 Disassembling instructions in the current address space is done by | |
31 having start_va == buffer. | |
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
32 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
33 The option string, if not empty, is interpreted by the disassembler implementation. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
34 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
35 The printf callback is 'fprintf' or any other workalike. |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
36 It is called as (*printf_callback)(printf_stream, "some format...", some, format, args). |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
37 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
38 The event callback receives an event tag (a string) and an argument (a void*). |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
39 It is called as (*event_callback)(event_stream, "tag", arg). |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
40 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
41 Events: |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
42 <insn pc='%p'> begin an instruction, at a given location |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
43 </insn pc='%d'> end an instruction, at a given location |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
44 <addr value='%p'/> emit the symbolic value of an address |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
45 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
46 A tag format is one of three basic forms: "tag", "/tag", "tag/", |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
47 where tag is a simple identifier, signifying (as in XML) a element start, |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
48 element end, and standalone element. (To render as XML, add angle brackets.) |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
49 */ |
6933
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
50 #ifndef SHARED_TOOLS_HSDIS_H |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
51 #define SHARED_TOOLS_HSDIS_H |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
52 |
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
53 extern |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
54 #ifdef DLL_EXPORT |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
55 DLL_EXPORT |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
56 #endif |
6782 | 57 void* decode_instructions_virtual(uintptr_t start_va, uintptr_t end_va, |
58 unsigned char* buffer, uintptr_t length, | |
59 void* (*event_callback)(void*, const char*, void*), | |
60 void* event_stream, | |
61 int (*printf_callback)(void*, const char*, ...), | |
62 void* printf_stream, | |
6933
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
63 const char* options, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
64 int newline /* bool value for nice new line */); |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
65 |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
66 /* This is the compatability interface for older versions of hotspot */ |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
67 extern |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
68 #ifdef DLL_ENTRY |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
69 DLL_ENTRY |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
70 #endif |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
71 void* decode_instructions(void* start_pv, void* end_pv, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
72 void* (*event_callback)(void*, const char*, void*), |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
73 void* event_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
74 int (*printf_callback)(void*, const char*, ...), |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
75 void* printf_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
76 const char* options); |
100
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
77 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
78 /* convenience typedefs */ |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
79 |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
80 typedef void* (*decode_instructions_event_callback_ftype) (void*, const char*, void*); |
c7c777385a15
6667042: PrintAssembly option does not work without special plugin
jrose
parents:
diff
changeset
|
81 typedef int (*decode_instructions_printf_callback_ftype) (void*, const char*, ...); |
6933
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
82 typedef void* (*decode_func_vtype) (uintptr_t start_va, uintptr_t end_va, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
83 unsigned char* buffer, uintptr_t length, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
84 decode_instructions_event_callback_ftype event_callback, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
85 void* event_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
86 decode_instructions_printf_callback_ftype printf_callback, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
87 void* printf_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
88 const char* options, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
89 int newline); |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
90 typedef void* (*decode_func_stype) (void* start_pv, void* end_pv, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
91 decode_instructions_event_callback_ftype event_callback, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
92 void* event_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
93 decode_instructions_printf_callback_ftype printf_callback, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
94 void* printf_stream, |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
95 const char* options); |
3d701c802d01
8000489: older builds of hsdis don't work anymore after 6879063
minqi
parents:
6782
diff
changeset
|
96 #endif /* SHARED_TOOLS_HSDIS_H */ |