1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
|
/* $Id: DisasmInternal.h $ */
/** @file
* VBox disassembler - Internal header.
*/
/*
* Copyright (C) 2006-2023 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, in version 3 of the
* License.
*
* This program 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 for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* SPDX-License-Identifier: GPL-3.0-only
*/
#ifndef VBOX_INCLUDED_SRC_DisasmInternal_h
#define VBOX_INCLUDED_SRC_DisasmInternal_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include <VBox/types.h>
#include <VBox/dis.h>
/** @defgroup grp_dis_int Internals.
* @ingroup grp_dis
* @{
*/
/** @name Index into g_apfnCalcSize and g_apfnFullDisasm.
* @{ */
enum IDX_Parse
{
IDX_ParseNop = 0,
IDX_ParseModRM,
IDX_UseModRM,
IDX_ParseImmByte,
IDX_ParseImmBRel,
IDX_ParseImmUshort,
IDX_ParseImmV,
IDX_ParseImmVRel,
IDX_ParseImmAddr,
IDX_ParseFixedReg,
IDX_ParseImmUlong,
IDX_ParseImmQword,
IDX_ParseTwoByteEsc,
IDX_ParseGrp1,
IDX_ParseShiftGrp2,
IDX_ParseGrp3,
IDX_ParseGrp4,
IDX_ParseGrp5,
IDX_Parse3DNow,
IDX_ParseGrp6,
IDX_ParseGrp7,
IDX_ParseGrp8,
IDX_ParseGrp9,
IDX_ParseGrp10,
IDX_ParseGrp12,
IDX_ParseGrp13,
IDX_ParseGrp14,
IDX_ParseGrp15,
IDX_ParseGrp16,
IDX_ParseGrp17,
IDX_ParseModFence,
IDX_ParseYv,
IDX_ParseYb,
IDX_ParseXv,
IDX_ParseXb,
IDX_ParseEscFP,
IDX_ParseNopPause,
IDX_ParseImmByteSX,
IDX_ParseImmZ,
IDX_ParseThreeByteEsc4,
IDX_ParseThreeByteEsc5,
IDX_ParseImmAddrF,
IDX_ParseInvOpModRM,
IDX_ParseVex2b,
IDX_ParseVex3b,
IDX_ParseVexDest,
IDX_ParseMax
};
AssertCompile(IDX_ParseMax < 64 /* Packed DISOPCODE assumption. */);
/** @} */
/**
* Opcode map descriptor.
*
* This is used a number of places to save storage space where there are lots of
* invalid instructions and the beginning or end of the map.
*/
typedef struct DISOPMAPDESC
{
/** Pointer to the opcodes described by this structure. */
PCDISOPCODE papOpcodes;
#if ARCH_BITS <= 32
uint16_t
#else
uint32_t
#endif
/** The map index corresponding to the first papOpcodes entry. */
idxFirst,
/** Number of opcodes in the map. */
cOpcodes;
} DISOPMAPDESC;
/** Pointer to a const opcode map descriptor. */
typedef DISOPMAPDESC const *PCDISOPMAPDESC;
/** @name Opcode maps.
* @{ */
extern const DISOPCODE g_InvalidOpcode[1];
extern const DISOPCODE g_aOneByteMapX86[256];
extern const DISOPCODE g_aOneByteMapX64[256];
extern const DISOPCODE g_aTwoByteMapX86[256];
/** Two byte opcode map with prefix 0x66 */
extern const DISOPCODE g_aTwoByteMapX86_PF66[256];
/** Two byte opcode map with prefix 0xF2 */
extern const DISOPCODE g_aTwoByteMapX86_PFF2[256];
/** Two byte opcode map with prefix 0xF3 */
extern const DISOPCODE g_aTwoByteMapX86_PFF3[256];
/** Three byte opcode map (0xF 0x38) */
extern PCDISOPCODE const g_apThreeByteMapX86_0F38[16];
/** Three byte opcode map with prefix 0x66 (0xF 0x38) */
extern PCDISOPCODE const g_apThreeByteMapX86_660F38[16];
/** Three byte opcode map with prefix 0xF2 (0xF 0x38) */
extern PCDISOPCODE const g_apThreeByteMapX86_F20F38[16];
/** Three byte opcode map with prefix 0xF3 (0xF 0x38) */
extern PCDISOPCODE const g_apThreeByteMapX86_F30F38[16];
extern PCDISOPCODE const g_apThreeByteMapX86_0F3A[16];
/** Three byte opcode map with prefix 0x66 (0xF 0x3A) */
extern PCDISOPCODE const g_apThreeByteMapX86_660F3A[16];
/** Three byte opcode map with prefixes 0x66 0xF2 (0xF 0x38) */
extern PCDISOPCODE const g_apThreeByteMapX86_66F20F38[16];
/** VEX opcodes table defined by [VEX.m-mmmm - 1].
* 0Fh, 0F38h, 0F3Ah correspondingly, VEX.pp = 00b */
extern PCDISOPMAPDESC const g_apVexOpcodesMapRanges_None[3];
/** VEX opcodes table defined by [VEX.m-mmmm - 1].
* 0Fh, 0F38h, 0F3Ah correspondingly, VEX.pp = 01b (66h) */
extern PCDISOPMAPDESC const g_apVexOpcodesMapRanges_66H[3];
/** 0Fh, 0F38h, 0F3Ah correspondingly, VEX.pp = 10b (F3h) */
extern PCDISOPMAPDESC const g_apVexOpcodesMapRanges_F3H[3];
/** 0Fh, 0F38h, 0F3Ah correspondingly, VEX.pp = 11b (F2h) */
extern PCDISOPMAPDESC const g_apVexOpcodesMapRanges_F2H[3];
/** Two dimmentional map descriptor array: first index is by VEX.pp (prefix),
* second by the VEX.mmmm (map).
* The latter has to be bounced checked as we only have the first 4 maps. */
extern PCDISOPMAPDESC const g_aapVexOpcodesMapRanges[4][4];
/** @} */
/** @name Opcode extensions (Group tables)
* @{ */
extern const DISOPCODE g_aMapX86_Group1[8*4];
extern const DISOPCODE g_aMapX86_Group2[8*6];
extern const DISOPCODE g_aMapX86_Group3[8*2];
extern const DISOPCODE g_aMapX86_Group4[8];
extern const DISOPCODE g_aMapX86_Group5[8];
extern const DISOPCODE g_aMapX86_Group6[8];
extern const DISOPCODE g_aMapX86_Group7_mem[8];
extern const DISOPCODE g_aMapX86_Group7_mod11_rm000[8];
extern const DISOPCODE g_aMapX86_Group7_mod11_rm001[8];
extern const DISOPCODE g_aMapX86_Group8[8];
extern const DISOPCODE g_aMapX86_Group9[8];
extern const DISOPCODE g_aMapX86_Group10[8];
extern const DISOPCODE g_aMapX86_Group11[8*2];
extern const DISOPCODE g_aMapX86_Group12[8*2];
extern const DISOPCODE g_aMapX86_Group13[8*2];
extern const DISOPCODE g_aMapX86_Group14[8*2];
extern const DISOPCODE g_aMapX86_Group15_mem[8];
extern const DISOPCODE g_aMapX86_Group15_mod11_rm000[8];
extern const DISOPCODE g_aMapX86_Group16[8];
extern const DISOPCODE g_aMapX86_Group17[8*2];
extern const DISOPCODE g_aMapX86_NopPause[2];
/** @} */
/** 3DNow! map (0x0F 0x0F prefix) */
extern const DISOPCODE g_aTwoByteMapX86_3DNow[256];
/** Floating point opcodes starting with escape byte 0xDF
* @{ */
extern const DISOPCODE g_aMapX86_EscF0_Low[8];
extern const DISOPCODE g_aMapX86_EscF0_High[16*4];
extern const DISOPCODE g_aMapX86_EscF1_Low[8];
extern const DISOPCODE g_aMapX86_EscF1_High[16*4];
extern const DISOPCODE g_aMapX86_EscF2_Low[8];
extern const DISOPCODE g_aMapX86_EscF2_High[16*4];
extern const DISOPCODE g_aMapX86_EscF3_Low[8];
extern const DISOPCODE g_aMapX86_EscF3_High[16*4];
extern const DISOPCODE g_aMapX86_EscF4_Low[8];
extern const DISOPCODE g_aMapX86_EscF4_High[16*4];
extern const DISOPCODE g_aMapX86_EscF5_Low[8];
extern const DISOPCODE g_aMapX86_EscF5_High[16*4];
extern const DISOPCODE g_aMapX86_EscF6_Low[8];
extern const DISOPCODE g_aMapX86_EscF6_High[16*4];
extern const DISOPCODE g_aMapX86_EscF7_Low[8];
extern const DISOPCODE g_aMapX86_EscF7_High[16*4];
extern const PCDISOPCODE g_apMapX86_FP_Low[8];
extern const PCDISOPCODE g_apMapX86_FP_High[8];
/** @} */
/** @def OP
* Wrapper which initializes an DISOPCODE.
* We must use this so that we can exclude unused fields in order
* to save precious bytes in the GC version.
*
* @internal
*/
#if DISOPCODE_FORMAT == 0
# define OP(pszOpcode, idxParse1, idxParse2, idxParse3, opcode, param1, param2, param3, optype) \
{ pszOpcode, idxParse1, idxParse2, idxParse3, 0, opcode, param1, param2, param3, 0, 0, optype }
# define OPVEX(pszOpcode, idxParse1, idxParse2, idxParse3, idxParse4, opcode, param1, param2, param3, param4, optype) \
{ pszOpcode, idxParse1, idxParse2, idxParse3, idxParse4, opcode, param1, param2, param3, param4, 0, optype | DISOPTYPE_SSE }
#elif DISOPCODE_FORMAT == 16
# define OP(pszOpcode, idxParse1, idxParse2, idxParse3, opcode, param1, param2, param3, optype) \
{ optype, opcode, idxParse1, idxParse2, param1, param2, idxParse3, param3, 0, 0 }
# define OPVEX(pszOpcode, idxParse1, idxParse2, idxParse3, idxParse4, opcode, param1, param2, param3, param4, optype) \
{ optype | DISOPTYPE_SSE, opcode, idxParse1, idxParse2, param1, param2, idxParse3, param3, param4, idxParse4 }
#elif DISOPCODE_FORMAT == 15
# define OP(pszOpcode, idxParse1, idxParse2, idxParse3, opcode, param1, param2, param3, optype) \
{ opcode, idxParse1, idxParse2, idxParse3, param1, param2, param3, optype, 0, 0 }
# define OPVEX(pszOpcode, idxParse1, idxParse2, idxParse3, idxParse4, opcode, param1, param2, param3, param4, optype) \
{ opcode, idxParse1, idxParse2, idxParse3, param1, param2, param3, optype | DISOPTYPE_SSE, param4, idxParse4 }
#else
# error Unsupported DISOPCODE_FORMAT value
#endif
size_t disFormatBytes(PCDISSTATE pDis, char *pszDst, size_t cchDst, uint32_t fFlags);
/** @} */
#endif /* !VBOX_INCLUDED_SRC_DisasmInternal_h */
|
