Coverage Report

Created: 2026-01-10 06:34

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/capstonenext/arch/X86/X86Disassembler.c
Line
Count
Source
1
//===-- X86Disassembler.cpp - Disassembler for x86 and x86_64 -------------===//
2
//
3
//                     The LLVM Compiler Infrastructure
4
//
5
// This file is distributed under the University of Illinois Open Source
6
// License. See LICENSE.TXT for details.
7
//
8
//===----------------------------------------------------------------------===//
9
//
10
// This file is part of the X86 Disassembler.
11
// It contains code to translate the data produced by the decoder into
12
//  MCInsts.
13
//
14
// The X86 disassembler is a table-driven disassembler for the 16-, 32-, and
15
// 64-bit X86 instruction sets.  The main decode sequence for an assembly
16
// instruction in this disassembler is:
17
//
18
// 1. Read the prefix bytes and determine the attributes of the instruction.
19
//    These attributes, recorded in enum attributeBits
20
//    (X86DisassemblerDecoderCommon.h), form a bitmask.  The table CONTEXTS_SYM
21
//    provides a mapping from bitmasks to contexts, which are represented by
22
//    enum InstructionContext (ibid.).
23
//
24
// 2. Read the opcode, and determine what kind of opcode it is.  The
25
//    disassembler distinguishes four kinds of opcodes, which are enumerated in
26
//    OpcodeType (X86DisassemblerDecoderCommon.h): one-byte (0xnn), two-byte
27
//    (0x0f 0xnn), three-byte-38 (0x0f 0x38 0xnn), or three-byte-3a
28
//    (0x0f 0x3a 0xnn).  Mandatory prefixes are treated as part of the context.
29
//
30
// 3. Depending on the opcode type, look in one of four ClassDecision structures
31
//    (X86DisassemblerDecoderCommon.h).  Use the opcode class to determine which
32
//    OpcodeDecision (ibid.) to look the opcode in.  Look up the opcode, to get
33
//    a ModRMDecision (ibid.).
34
//
35
// 4. Some instructions, such as escape opcodes or extended opcodes, or even
36
//    instructions that have ModRM*Reg / ModRM*Mem forms in LLVM, need the
37
//    ModR/M byte to complete decode.  The ModRMDecision's type is an entry from
38
//    ModRMDecisionType (X86DisassemblerDecoderCommon.h) that indicates if the
39
//    ModR/M byte is required and how to interpret it.
40
//
41
// 5. After resolving the ModRMDecision, the disassembler has a unique ID
42
//    of type InstrUID (X86DisassemblerDecoderCommon.h).  Looking this ID up in
43
//    INSTRUCTIONS_SYM yields the name of the instruction and the encodings and
44
//    meanings of its operands.
45
//
46
// 6. For each operand, its encoding is an entry from OperandEncoding
47
//    (X86DisassemblerDecoderCommon.h) and its type is an entry from
48
//    OperandType (ibid.).  The encoding indicates how to read it from the
49
//    instruction; the type indicates how to interpret the value once it has
50
//    been read.  For example, a register operand could be stored in the R/M
51
//    field of the ModR/M byte, the REG field of the ModR/M byte, or added to
52
//    the main opcode.  This is orthogonal from its meaning (an GPR or an XMM
53
//    register, for instance).  Given this information, the operands can be
54
//    extracted and interpreted.
55
//
56
// 7. As the last step, the disassembler translates the instruction information
57
//    and operands into a format understandable by the client - in this case, an
58
//    MCInst for use by the MC infrastructure.
59
//
60
// The disassembler is broken broadly into two parts: the table emitter that
61
// emits the instruction decode tables discussed above during compilation, and
62
// the disassembler itself.  The table emitter is documented in more detail in
63
// utils/TableGen/X86DisassemblerEmitter.h.
64
//
65
// X86Disassembler.cpp contains the code responsible for step 7, and for
66
//   invoking the decoder to execute steps 1-6.
67
// X86DisassemblerDecoderCommon.h contains the definitions needed by both the
68
//   table emitter and the disassembler.
69
// X86DisassemblerDecoder.h contains the public interface of the decoder,
70
//   factored out into C for possible use by other projects.
71
// X86DisassemblerDecoder.c contains the source code of the decoder, which is
72
//   responsible for steps 1-6.
73
//
74
//===----------------------------------------------------------------------===//
75
76
/* Capstone Disassembly Engine */
77
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */
78
79
#ifdef CAPSTONE_HAS_X86
80
81
#ifdef _MSC_VER
82
// disable MSVC's warning on strncpy()
83
#pragma warning(disable : 4996)
84
// disable MSVC's warning on strncpy()
85
#pragma warning(disable : 28719)
86
#endif
87
88
#include <capstone/platform.h>
89
90
#if defined(CAPSTONE_HAS_OSXKERNEL)
91
#include <Availability.h>
92
#endif
93
94
#include <string.h>
95
96
#include "../../cs_priv.h"
97
98
#include "X86BaseInfo.h"
99
#include "X86Disassembler.h"
100
#include "X86DisassemblerDecoderCommon.h"
101
#include "X86DisassemblerDecoder.h"
102
#include "../../MCInst.h"
103
#include "../../utils.h"
104
#include "X86Mapping.h"
105
106
#define GET_REGINFO_ENUM
107
#define GET_REGINFO_MC_DESC
108
#include "X86GenRegisterInfo.inc"
109
110
#define GET_INSTRINFO_ENUM
111
#ifdef CAPSTONE_X86_REDUCE
112
#include "X86GenInstrInfo_reduce.inc"
113
#else
114
#include "X86GenInstrInfo.inc"
115
#endif
116
117
// Fill-ins to make the compiler happy.  These constants are never actually
118
//   assigned; they are just filler to make an automatically-generated switch
119
//   statement work.
120
enum {
121
  X86_BX_SI = 500,
122
  X86_BX_DI = 501,
123
  X86_BP_SI = 502,
124
  X86_BP_DI = 503,
125
  X86_sib = 504,
126
  X86_sib64 = 505
127
};
128
129
//
130
// Private code that translates from struct InternalInstructions to MCInsts.
131
//
132
133
/// translateRegister - Translates an internal register to the appropriate LLVM
134
///   register, and appends it as an operand to an MCInst.
135
///
136
/// @param mcInst     - The MCInst to append to.
137
/// @param reg        - The Reg to append.
138
static void translateRegister(MCInst *mcInst, Reg reg)
139
940k
{
140
209M
#define ENTRY(x) X86_##x,
141
940k
  static const uint16_t llvmRegnums[] = { ALL_REGS 0 };
142
940k
#undef ENTRY
143
144
940k
  uint16_t llvmRegnum = llvmRegnums[reg];
145
940k
  MCOperand_CreateReg0(mcInst, llvmRegnum);
146
940k
}
147
148
static const uint8_t segmentRegnums[SEG_OVERRIDE_max] = {
149
  0, // SEG_OVERRIDE_NONE
150
  X86_CS, X86_SS, X86_DS, X86_ES, X86_FS, X86_GS
151
};
152
153
/// translateSrcIndex   - Appends a source index operand to an MCInst.
154
///
155
/// @param mcInst       - The MCInst to append to.
156
/// @param insn         - The internal instruction.
157
static bool translateSrcIndex(MCInst *mcInst, InternalInstruction *insn)
158
58.5k
{
159
58.5k
  unsigned baseRegNo;
160
161
58.5k
  if (insn->mode == MODE_64BIT)
162
18.8k
    baseRegNo = insn->hasAdSize ? X86_ESI : X86_RSI;
163
39.7k
  else if (insn->mode == MODE_32BIT)
164
17.3k
    baseRegNo = insn->hasAdSize ? X86_SI : X86_ESI;
165
22.3k
  else {
166
    // assert(insn->mode == MODE_16BIT);
167
22.3k
    baseRegNo = insn->hasAdSize ? X86_ESI : X86_SI;
168
22.3k
  }
169
170
58.5k
  MCOperand_CreateReg0(mcInst, baseRegNo);
171
172
58.5k
  MCOperand_CreateReg0(mcInst, segmentRegnums[insn->segmentOverride]);
173
174
58.5k
  return false;
175
58.5k
}
176
177
/// translateDstIndex   - Appends a destination index operand to an MCInst.
178
///
179
/// @param mcInst       - The MCInst to append to.
180
/// @param insn         - The internal instruction.
181
static bool translateDstIndex(MCInst *mcInst, InternalInstruction *insn)
182
69.0k
{
183
69.0k
  unsigned baseRegNo;
184
185
69.0k
  if (insn->mode == MODE_64BIT)
186
22.3k
    baseRegNo = insn->hasAdSize ? X86_EDI : X86_RDI;
187
46.7k
  else if (insn->mode == MODE_32BIT)
188
20.1k
    baseRegNo = insn->hasAdSize ? X86_DI : X86_EDI;
189
26.5k
  else {
190
    // assert(insn->mode == MODE_16BIT);
191
26.5k
    baseRegNo = insn->hasAdSize ? X86_EDI : X86_DI;
192
26.5k
  }
193
194
69.0k
  MCOperand_CreateReg0(mcInst, baseRegNo);
195
196
69.0k
  return false;
197
69.0k
}
198
199
/// translateImmediate  - Appends an immediate operand to an MCInst.
200
///
201
/// @param mcInst       - The MCInst to append to.
202
/// @param immediate    - The immediate value to append.
203
/// @param operand      - The operand, as stored in the descriptor table.
204
/// @param insn         - The internal instruction.
205
static void translateImmediate(MCInst *mcInst, uint64_t immediate,
206
             const OperandSpecifier *operand,
207
             InternalInstruction *insn)
208
358k
{
209
358k
  OperandType type;
210
211
358k
  type = (OperandType)operand->type;
212
358k
  if (type == TYPE_REL) {
213
    //isBranch = true;
214
    //pcrel = insn->startLocation + insn->immediateOffset + insn->immediateSize;
215
83.8k
    switch (operand->encoding) {
216
0
    default:
217
0
      break;
218
5.82k
    case ENCODING_Iv:
219
5.82k
      switch (insn->displacementSize) {
220
0
      default:
221
0
        break;
222
0
      case 1:
223
0
        if (immediate & 0x80)
224
0
          immediate |= ~(0xffull);
225
0
        break;
226
2.60k
      case 2:
227
2.60k
        if (immediate & 0x8000)
228
2.06k
          immediate |= ~(0xffffull);
229
2.60k
        break;
230
3.21k
      case 4:
231
3.21k
        if (immediate & 0x80000000)
232
1.62k
          immediate |= ~(0xffffffffull);
233
3.21k
        break;
234
0
      case 8:
235
0
        break;
236
5.82k
      }
237
5.82k
      break;
238
74.6k
    case ENCODING_IB:
239
74.6k
      if (immediate & 0x80)
240
26.3k
        immediate |= ~(0xffull);
241
74.6k
      break;
242
1.46k
    case ENCODING_IW:
243
1.46k
      if (immediate & 0x8000)
244
778
        immediate |= ~(0xffffull);
245
1.46k
      break;
246
1.94k
    case ENCODING_ID:
247
1.94k
      if (immediate & 0x80000000)
248
1.16k
        immediate |= ~(0xffffffffull);
249
1.94k
      break;
250
83.8k
    }
251
83.8k
  } // By default sign-extend all X86 immediates based on their encoding.
252
275k
  else if (type == TYPE_IMM) {
253
149k
    switch (operand->encoding) {
254
45.3k
    default:
255
45.3k
      break;
256
85.0k
    case ENCODING_IB:
257
85.0k
      if (immediate & 0x80)
258
31.5k
        immediate |= ~(0xffull);
259
85.0k
      break;
260
14.3k
    case ENCODING_IW:
261
14.3k
      if (immediate & 0x8000)
262
7.70k
        immediate |= ~(0xffffull);
263
14.3k
      break;
264
3.86k
    case ENCODING_ID:
265
3.86k
      if (immediate & 0x80000000)
266
2.15k
        immediate |= ~(0xffffffffull);
267
3.86k
      break;
268
916
    case ENCODING_IO:
269
916
      break;
270
149k
    }
271
149k
  } else if (type == TYPE_IMM3) {
272
17.7k
#ifndef CAPSTONE_X86_REDUCE
273
    // Check for immediates that printSSECC can't handle.
274
17.7k
    if (immediate >= 8) {
275
10.6k
      unsigned NewOpc = 0;
276
277
10.6k
      switch (MCInst_getOpcode(mcInst)) {
278
0
      default:
279
0
        break; // never reach
280
330
      case X86_CMPPDrmi:
281
330
        NewOpc = X86_CMPPDrmi_alt;
282
330
        break;
283
987
      case X86_CMPPDrri:
284
987
        NewOpc = X86_CMPPDrri_alt;
285
987
        break;
286
933
      case X86_CMPPSrmi:
287
933
        NewOpc = X86_CMPPSrmi_alt;
288
933
        break;
289
1.65k
      case X86_CMPPSrri:
290
1.65k
        NewOpc = X86_CMPPSrri_alt;
291
1.65k
        break;
292
975
      case X86_CMPSDrm:
293
975
        NewOpc = X86_CMPSDrm_alt;
294
975
        break;
295
224
      case X86_CMPSDrr:
296
224
        NewOpc = X86_CMPSDrr_alt;
297
224
        break;
298
773
      case X86_CMPSSrm:
299
773
        NewOpc = X86_CMPSSrm_alt;
300
773
        break;
301
349
      case X86_CMPSSrr:
302
349
        NewOpc = X86_CMPSSrr_alt;
303
349
        break;
304
115
      case X86_VPCOMBri:
305
115
        NewOpc = X86_VPCOMBri_alt;
306
115
        break;
307
169
      case X86_VPCOMBmi:
308
169
        NewOpc = X86_VPCOMBmi_alt;
309
169
        break;
310
212
      case X86_VPCOMWri:
311
212
        NewOpc = X86_VPCOMWri_alt;
312
212
        break;
313
252
      case X86_VPCOMWmi:
314
252
        NewOpc = X86_VPCOMWmi_alt;
315
252
        break;
316
286
      case X86_VPCOMDri:
317
286
        NewOpc = X86_VPCOMDri_alt;
318
286
        break;
319
306
      case X86_VPCOMDmi:
320
306
        NewOpc = X86_VPCOMDmi_alt;
321
306
        break;
322
329
      case X86_VPCOMQri:
323
329
        NewOpc = X86_VPCOMQri_alt;
324
329
        break;
325
363
      case X86_VPCOMQmi:
326
363
        NewOpc = X86_VPCOMQmi_alt;
327
363
        break;
328
282
      case X86_VPCOMUBri:
329
282
        NewOpc = X86_VPCOMUBri_alt;
330
282
        break;
331
332
      case X86_VPCOMUBmi:
332
332
        NewOpc = X86_VPCOMUBmi_alt;
333
332
        break;
334
148
      case X86_VPCOMUWri:
335
148
        NewOpc = X86_VPCOMUWri_alt;
336
148
        break;
337
197
      case X86_VPCOMUWmi:
338
197
        NewOpc = X86_VPCOMUWmi_alt;
339
197
        break;
340
546
      case X86_VPCOMUDri:
341
546
        NewOpc = X86_VPCOMUDri_alt;
342
546
        break;
343
219
      case X86_VPCOMUDmi:
344
219
        NewOpc = X86_VPCOMUDmi_alt;
345
219
        break;
346
241
      case X86_VPCOMUQri:
347
241
        NewOpc = X86_VPCOMUQri_alt;
348
241
        break;
349
457
      case X86_VPCOMUQmi:
350
457
        NewOpc = X86_VPCOMUQmi_alt;
351
457
        break;
352
10.6k
      }
353
354
      // Switch opcode to the one that doesn't get special printing.
355
10.6k
      if (NewOpc != 0) {
356
10.6k
        MCInst_setOpcode(mcInst, NewOpc);
357
10.6k
      }
358
10.6k
    }
359
17.7k
#endif
360
107k
  } else if (type == TYPE_IMM5) {
361
25.4k
#ifndef CAPSTONE_X86_REDUCE
362
    // Check for immediates that printAVXCC can't handle.
363
25.4k
    if (immediate >= 32) {
364
20.7k
      unsigned NewOpc = 0;
365
366
20.7k
      switch (MCInst_getOpcode(mcInst)) {
367
8.05k
      default:
368
8.05k
        break; // unexpected opcode
369
8.05k
      case X86_VCMPPDrmi:
370
506
        NewOpc = X86_VCMPPDrmi_alt;
371
506
        break;
372
234
      case X86_VCMPPDrri:
373
234
        NewOpc = X86_VCMPPDrri_alt;
374
234
        break;
375
652
      case X86_VCMPPSrmi:
376
652
        NewOpc = X86_VCMPPSrmi_alt;
377
652
        break;
378
262
      case X86_VCMPPSrri:
379
262
        NewOpc = X86_VCMPPSrri_alt;
380
262
        break;
381
418
      case X86_VCMPSDrm:
382
418
        NewOpc = X86_VCMPSDrm_alt;
383
418
        break;
384
549
      case X86_VCMPSDrr:
385
549
        NewOpc = X86_VCMPSDrr_alt;
386
549
        break;
387
378
      case X86_VCMPSSrm:
388
378
        NewOpc = X86_VCMPSSrm_alt;
389
378
        break;
390
480
      case X86_VCMPSSrr:
391
480
        NewOpc = X86_VCMPSSrr_alt;
392
480
        break;
393
322
      case X86_VCMPPDYrmi:
394
322
        NewOpc = X86_VCMPPDYrmi_alt;
395
322
        break;
396
174
      case X86_VCMPPDYrri:
397
174
        NewOpc = X86_VCMPPDYrri_alt;
398
174
        break;
399
247
      case X86_VCMPPSYrmi:
400
247
        NewOpc = X86_VCMPPSYrmi_alt;
401
247
        break;
402
281
      case X86_VCMPPSYrri:
403
281
        NewOpc = X86_VCMPPSYrri_alt;
404
281
        break;
405
407
      case X86_VCMPPDZrmi:
406
407
        NewOpc = X86_VCMPPDZrmi_alt;
407
407
        break;
408
238
      case X86_VCMPPDZrri:
409
238
        NewOpc = X86_VCMPPDZrri_alt;
410
238
        break;
411
451
      case X86_VCMPPDZrrib:
412
451
        NewOpc = X86_VCMPPDZrrib_alt;
413
451
        break;
414
468
      case X86_VCMPPSZrmi:
415
468
        NewOpc = X86_VCMPPSZrmi_alt;
416
468
        break;
417
239
      case X86_VCMPPSZrri:
418
239
        NewOpc = X86_VCMPPSZrri_alt;
419
239
        break;
420
595
      case X86_VCMPPSZrrib:
421
595
        NewOpc = X86_VCMPPSZrrib_alt;
422
595
        break;
423
120
      case X86_VCMPPDZ128rmi:
424
120
        NewOpc = X86_VCMPPDZ128rmi_alt;
425
120
        break;
426
169
      case X86_VCMPPDZ128rri:
427
169
        NewOpc = X86_VCMPPDZ128rri_alt;
428
169
        break;
429
382
      case X86_VCMPPSZ128rmi:
430
382
        NewOpc = X86_VCMPPSZ128rmi_alt;
431
382
        break;
432
419
      case X86_VCMPPSZ128rri:
433
419
        NewOpc = X86_VCMPPSZ128rri_alt;
434
419
        break;
435
147
      case X86_VCMPPDZ256rmi:
436
147
        NewOpc = X86_VCMPPDZ256rmi_alt;
437
147
        break;
438
1.20k
      case X86_VCMPPDZ256rri:
439
1.20k
        NewOpc = X86_VCMPPDZ256rri_alt;
440
1.20k
        break;
441
159
      case X86_VCMPPSZ256rmi:
442
159
        NewOpc = X86_VCMPPSZ256rmi_alt;
443
159
        break;
444
651
      case X86_VCMPPSZ256rri:
445
651
        NewOpc = X86_VCMPPSZ256rri_alt;
446
651
        break;
447
859
      case X86_VCMPSDZrm_Int:
448
859
        NewOpc = X86_VCMPSDZrmi_alt;
449
859
        break;
450
355
      case X86_VCMPSDZrr_Int:
451
355
        NewOpc = X86_VCMPSDZrri_alt;
452
355
        break;
453
525
      case X86_VCMPSDZrrb_Int:
454
525
        NewOpc = X86_VCMPSDZrrb_alt;
455
525
        break;
456
229
      case X86_VCMPSSZrm_Int:
457
229
        NewOpc = X86_VCMPSSZrmi_alt;
458
229
        break;
459
156
      case X86_VCMPSSZrr_Int:
460
156
        NewOpc = X86_VCMPSSZrri_alt;
461
156
        break;
462
414
      case X86_VCMPSSZrrb_Int:
463
414
        NewOpc = X86_VCMPSSZrrb_alt;
464
414
        break;
465
20.7k
      }
466
467
      // Switch opcode to the one that doesn't get special printing.
468
20.7k
      if (NewOpc != 0) {
469
12.6k
        MCInst_setOpcode(mcInst, NewOpc);
470
12.6k
      }
471
20.7k
    }
472
25.4k
#endif
473
82.2k
  } else if (type == TYPE_AVX512ICC) {
474
25.9k
#ifndef CAPSTONE_X86_REDUCE
475
25.9k
    if (immediate >= 8 || ((immediate & 0x3) == 3)) {
476
17.7k
      unsigned NewOpc = 0;
477
17.7k
      switch (MCInst_getOpcode(mcInst)) {
478
0
      default: // llvm_unreachable("unexpected opcode");
479
374
      case X86_VPCMPBZ128rmi:
480
374
        NewOpc = X86_VPCMPBZ128rmi_alt;
481
374
        break;
482
79
      case X86_VPCMPBZ128rmik:
483
79
        NewOpc = X86_VPCMPBZ128rmik_alt;
484
79
        break;
485
68
      case X86_VPCMPBZ128rri:
486
68
        NewOpc = X86_VPCMPBZ128rri_alt;
487
68
        break;
488
42
      case X86_VPCMPBZ128rrik:
489
42
        NewOpc = X86_VPCMPBZ128rrik_alt;
490
42
        break;
491
53
      case X86_VPCMPBZ256rmi:
492
53
        NewOpc = X86_VPCMPBZ256rmi_alt;
493
53
        break;
494
36
      case X86_VPCMPBZ256rmik:
495
36
        NewOpc = X86_VPCMPBZ256rmik_alt;
496
36
        break;
497
163
      case X86_VPCMPBZ256rri:
498
163
        NewOpc = X86_VPCMPBZ256rri_alt;
499
163
        break;
500
211
      case X86_VPCMPBZ256rrik:
501
211
        NewOpc = X86_VPCMPBZ256rrik_alt;
502
211
        break;
503
109
      case X86_VPCMPBZrmi:
504
109
        NewOpc = X86_VPCMPBZrmi_alt;
505
109
        break;
506
102
      case X86_VPCMPBZrmik:
507
102
        NewOpc = X86_VPCMPBZrmik_alt;
508
102
        break;
509
111
      case X86_VPCMPBZrri:
510
111
        NewOpc = X86_VPCMPBZrri_alt;
511
111
        break;
512
206
      case X86_VPCMPBZrrik:
513
206
        NewOpc = X86_VPCMPBZrrik_alt;
514
206
        break;
515
44
      case X86_VPCMPDZ128rmi:
516
44
        NewOpc = X86_VPCMPDZ128rmi_alt;
517
44
        break;
518
76
      case X86_VPCMPDZ128rmib:
519
76
        NewOpc = X86_VPCMPDZ128rmib_alt;
520
76
        break;
521
137
      case X86_VPCMPDZ128rmibk:
522
137
        NewOpc = X86_VPCMPDZ128rmibk_alt;
523
137
        break;
524
337
      case X86_VPCMPDZ128rmik:
525
337
        NewOpc = X86_VPCMPDZ128rmik_alt;
526
337
        break;
527
33
      case X86_VPCMPDZ128rri:
528
33
        NewOpc = X86_VPCMPDZ128rri_alt;
529
33
        break;
530
46
      case X86_VPCMPDZ128rrik:
531
46
        NewOpc = X86_VPCMPDZ128rrik_alt;
532
46
        break;
533
168
      case X86_VPCMPDZ256rmi:
534
168
        NewOpc = X86_VPCMPDZ256rmi_alt;
535
168
        break;
536
81
      case X86_VPCMPDZ256rmib:
537
81
        NewOpc = X86_VPCMPDZ256rmib_alt;
538
81
        break;
539
132
      case X86_VPCMPDZ256rmibk:
540
132
        NewOpc = X86_VPCMPDZ256rmibk_alt;
541
132
        break;
542
111
      case X86_VPCMPDZ256rmik:
543
111
        NewOpc = X86_VPCMPDZ256rmik_alt;
544
111
        break;
545
64
      case X86_VPCMPDZ256rri:
546
64
        NewOpc = X86_VPCMPDZ256rri_alt;
547
64
        break;
548
318
      case X86_VPCMPDZ256rrik:
549
318
        NewOpc = X86_VPCMPDZ256rrik_alt;
550
318
        break;
551
83
      case X86_VPCMPDZrmi:
552
83
        NewOpc = X86_VPCMPDZrmi_alt;
553
83
        break;
554
81
      case X86_VPCMPDZrmib:
555
81
        NewOpc = X86_VPCMPDZrmib_alt;
556
81
        break;
557
438
      case X86_VPCMPDZrmibk:
558
438
        NewOpc = X86_VPCMPDZrmibk_alt;
559
438
        break;
560
72
      case X86_VPCMPDZrmik:
561
72
        NewOpc = X86_VPCMPDZrmik_alt;
562
72
        break;
563
268
      case X86_VPCMPDZrri:
564
268
        NewOpc = X86_VPCMPDZrri_alt;
565
268
        break;
566
188
      case X86_VPCMPDZrrik:
567
188
        NewOpc = X86_VPCMPDZrrik_alt;
568
188
        break;
569
25
      case X86_VPCMPQZ128rmi:
570
25
        NewOpc = X86_VPCMPQZ128rmi_alt;
571
25
        break;
572
457
      case X86_VPCMPQZ128rmib:
573
457
        NewOpc = X86_VPCMPQZ128rmib_alt;
574
457
        break;
575
441
      case X86_VPCMPQZ128rmibk:
576
441
        NewOpc = X86_VPCMPQZ128rmibk_alt;
577
441
        break;
578
12
      case X86_VPCMPQZ128rmik:
579
12
        NewOpc = X86_VPCMPQZ128rmik_alt;
580
12
        break;
581
25
      case X86_VPCMPQZ128rri:
582
25
        NewOpc = X86_VPCMPQZ128rri_alt;
583
25
        break;
584
26
      case X86_VPCMPQZ128rrik:
585
26
        NewOpc = X86_VPCMPQZ128rrik_alt;
586
26
        break;
587
34
      case X86_VPCMPQZ256rmi:
588
34
        NewOpc = X86_VPCMPQZ256rmi_alt;
589
34
        break;
590
613
      case X86_VPCMPQZ256rmib:
591
613
        NewOpc = X86_VPCMPQZ256rmib_alt;
592
613
        break;
593
129
      case X86_VPCMPQZ256rmibk:
594
129
        NewOpc = X86_VPCMPQZ256rmibk_alt;
595
129
        break;
596
153
      case X86_VPCMPQZ256rmik:
597
153
        NewOpc = X86_VPCMPQZ256rmik_alt;
598
153
        break;
599
361
      case X86_VPCMPQZ256rri:
600
361
        NewOpc = X86_VPCMPQZ256rri_alt;
601
361
        break;
602
138
      case X86_VPCMPQZ256rrik:
603
138
        NewOpc = X86_VPCMPQZ256rrik_alt;
604
138
        break;
605
49
      case X86_VPCMPQZrmi:
606
49
        NewOpc = X86_VPCMPQZrmi_alt;
607
49
        break;
608
85
      case X86_VPCMPQZrmib:
609
85
        NewOpc = X86_VPCMPQZrmib_alt;
610
85
        break;
611
294
      case X86_VPCMPQZrmibk:
612
294
        NewOpc = X86_VPCMPQZrmibk_alt;
613
294
        break;
614
235
      case X86_VPCMPQZrmik:
615
235
        NewOpc = X86_VPCMPQZrmik_alt;
616
235
        break;
617
185
      case X86_VPCMPQZrri:
618
185
        NewOpc = X86_VPCMPQZrri_alt;
619
185
        break;
620
71
      case X86_VPCMPQZrrik:
621
71
        NewOpc = X86_VPCMPQZrrik_alt;
622
71
        break;
623
4
      case X86_VPCMPUBZ128rmi:
624
4
        NewOpc = X86_VPCMPUBZ128rmi_alt;
625
4
        break;
626
107
      case X86_VPCMPUBZ128rmik:
627
107
        NewOpc = X86_VPCMPUBZ128rmik_alt;
628
107
        break;
629
83
      case X86_VPCMPUBZ128rri:
630
83
        NewOpc = X86_VPCMPUBZ128rri_alt;
631
83
        break;
632
119
      case X86_VPCMPUBZ128rrik:
633
119
        NewOpc = X86_VPCMPUBZ128rrik_alt;
634
119
        break;
635
80
      case X86_VPCMPUBZ256rmi:
636
80
        NewOpc = X86_VPCMPUBZ256rmi_alt;
637
80
        break;
638
136
      case X86_VPCMPUBZ256rmik:
639
136
        NewOpc = X86_VPCMPUBZ256rmik_alt;
640
136
        break;
641
374
      case X86_VPCMPUBZ256rri:
642
374
        NewOpc = X86_VPCMPUBZ256rri_alt;
643
374
        break;
644
36
      case X86_VPCMPUBZ256rrik:
645
36
        NewOpc = X86_VPCMPUBZ256rrik_alt;
646
36
        break;
647
56
      case X86_VPCMPUBZrmi:
648
56
        NewOpc = X86_VPCMPUBZrmi_alt;
649
56
        break;
650
120
      case X86_VPCMPUBZrmik:
651
120
        NewOpc = X86_VPCMPUBZrmik_alt;
652
120
        break;
653
224
      case X86_VPCMPUBZrri:
654
224
        NewOpc = X86_VPCMPUBZrri_alt;
655
224
        break;
656
196
      case X86_VPCMPUBZrrik:
657
196
        NewOpc = X86_VPCMPUBZrrik_alt;
658
196
        break;
659
35
      case X86_VPCMPUDZ128rmi:
660
35
        NewOpc = X86_VPCMPUDZ128rmi_alt;
661
35
        break;
662
250
      case X86_VPCMPUDZ128rmib:
663
250
        NewOpc = X86_VPCMPUDZ128rmib_alt;
664
250
        break;
665
73
      case X86_VPCMPUDZ128rmibk:
666
73
        NewOpc = X86_VPCMPUDZ128rmibk_alt;
667
73
        break;
668
10
      case X86_VPCMPUDZ128rmik:
669
10
        NewOpc = X86_VPCMPUDZ128rmik_alt;
670
10
        break;
671
44
      case X86_VPCMPUDZ128rri:
672
44
        NewOpc = X86_VPCMPUDZ128rri_alt;
673
44
        break;
674
159
      case X86_VPCMPUDZ128rrik:
675
159
        NewOpc = X86_VPCMPUDZ128rrik_alt;
676
159
        break;
677
48
      case X86_VPCMPUDZ256rmi:
678
48
        NewOpc = X86_VPCMPUDZ256rmi_alt;
679
48
        break;
680
361
      case X86_VPCMPUDZ256rmib:
681
361
        NewOpc = X86_VPCMPUDZ256rmib_alt;
682
361
        break;
683
142
      case X86_VPCMPUDZ256rmibk:
684
142
        NewOpc = X86_VPCMPUDZ256rmibk_alt;
685
142
        break;
686
81
      case X86_VPCMPUDZ256rmik:
687
81
        NewOpc = X86_VPCMPUDZ256rmik_alt;
688
81
        break;
689
136
      case X86_VPCMPUDZ256rri:
690
136
        NewOpc = X86_VPCMPUDZ256rri_alt;
691
136
        break;
692
80
      case X86_VPCMPUDZ256rrik:
693
80
        NewOpc = X86_VPCMPUDZ256rrik_alt;
694
80
        break;
695
286
      case X86_VPCMPUDZrmi:
696
286
        NewOpc = X86_VPCMPUDZrmi_alt;
697
286
        break;
698
518
      case X86_VPCMPUDZrmib:
699
518
        NewOpc = X86_VPCMPUDZrmib_alt;
700
518
        break;
701
498
      case X86_VPCMPUDZrmibk:
702
498
        NewOpc = X86_VPCMPUDZrmibk_alt;
703
498
        break;
704
202
      case X86_VPCMPUDZrmik:
705
202
        NewOpc = X86_VPCMPUDZrmik_alt;
706
202
        break;
707
179
      case X86_VPCMPUDZrri:
708
179
        NewOpc = X86_VPCMPUDZrri_alt;
709
179
        break;
710
51
      case X86_VPCMPUDZrrik:
711
51
        NewOpc = X86_VPCMPUDZrrik_alt;
712
51
        break;
713
14
      case X86_VPCMPUQZ128rmi:
714
14
        NewOpc = X86_VPCMPUQZ128rmi_alt;
715
14
        break;
716
195
      case X86_VPCMPUQZ128rmib:
717
195
        NewOpc = X86_VPCMPUQZ128rmib_alt;
718
195
        break;
719
217
      case X86_VPCMPUQZ128rmibk:
720
217
        NewOpc = X86_VPCMPUQZ128rmibk_alt;
721
217
        break;
722
20
      case X86_VPCMPUQZ128rmik:
723
20
        NewOpc = X86_VPCMPUQZ128rmik_alt;
724
20
        break;
725
30
      case X86_VPCMPUQZ128rri:
726
30
        NewOpc = X86_VPCMPUQZ128rri_alt;
727
30
        break;
728
69
      case X86_VPCMPUQZ128rrik:
729
69
        NewOpc = X86_VPCMPUQZ128rrik_alt;
730
69
        break;
731
88
      case X86_VPCMPUQZ256rmi:
732
88
        NewOpc = X86_VPCMPUQZ256rmi_alt;
733
88
        break;
734
8
      case X86_VPCMPUQZ256rmib:
735
8
        NewOpc = X86_VPCMPUQZ256rmib_alt;
736
8
        break;
737
170
      case X86_VPCMPUQZ256rmibk:
738
170
        NewOpc = X86_VPCMPUQZ256rmibk_alt;
739
170
        break;
740
81
      case X86_VPCMPUQZ256rmik:
741
81
        NewOpc = X86_VPCMPUQZ256rmik_alt;
742
81
        break;
743
228
      case X86_VPCMPUQZ256rri:
744
228
        NewOpc = X86_VPCMPUQZ256rri_alt;
745
228
        break;
746
27
      case X86_VPCMPUQZ256rrik:
747
27
        NewOpc = X86_VPCMPUQZ256rrik_alt;
748
27
        break;
749
83
      case X86_VPCMPUQZrmi:
750
83
        NewOpc = X86_VPCMPUQZrmi_alt;
751
83
        break;
752
365
      case X86_VPCMPUQZrmib:
753
365
        NewOpc = X86_VPCMPUQZrmib_alt;
754
365
        break;
755
199
      case X86_VPCMPUQZrmibk:
756
199
        NewOpc = X86_VPCMPUQZrmibk_alt;
757
199
        break;
758
222
      case X86_VPCMPUQZrmik:
759
222
        NewOpc = X86_VPCMPUQZrmik_alt;
760
222
        break;
761
113
      case X86_VPCMPUQZrri:
762
113
        NewOpc = X86_VPCMPUQZrri_alt;
763
113
        break;
764
112
      case X86_VPCMPUQZrrik:
765
112
        NewOpc = X86_VPCMPUQZrrik_alt;
766
112
        break;
767
53
      case X86_VPCMPUWZ128rmi:
768
53
        NewOpc = X86_VPCMPUWZ128rmi_alt;
769
53
        break;
770
191
      case X86_VPCMPUWZ128rmik:
771
191
        NewOpc = X86_VPCMPUWZ128rmik_alt;
772
191
        break;
773
71
      case X86_VPCMPUWZ128rri:
774
71
        NewOpc = X86_VPCMPUWZ128rri_alt;
775
71
        break;
776
188
      case X86_VPCMPUWZ128rrik:
777
188
        NewOpc = X86_VPCMPUWZ128rrik_alt;
778
188
        break;
779
56
      case X86_VPCMPUWZ256rmi:
780
56
        NewOpc = X86_VPCMPUWZ256rmi_alt;
781
56
        break;
782
142
      case X86_VPCMPUWZ256rmik:
783
142
        NewOpc = X86_VPCMPUWZ256rmik_alt;
784
142
        break;
785
135
      case X86_VPCMPUWZ256rri:
786
135
        NewOpc = X86_VPCMPUWZ256rri_alt;
787
135
        break;
788
151
      case X86_VPCMPUWZ256rrik:
789
151
        NewOpc = X86_VPCMPUWZ256rrik_alt;
790
151
        break;
791
286
      case X86_VPCMPUWZrmi:
792
286
        NewOpc = X86_VPCMPUWZrmi_alt;
793
286
        break;
794
64
      case X86_VPCMPUWZrmik:
795
64
        NewOpc = X86_VPCMPUWZrmik_alt;
796
64
        break;
797
250
      case X86_VPCMPUWZrri:
798
250
        NewOpc = X86_VPCMPUWZrri_alt;
799
250
        break;
800
212
      case X86_VPCMPUWZrrik:
801
212
        NewOpc = X86_VPCMPUWZrrik_alt;
802
212
        break;
803
56
      case X86_VPCMPWZ128rmi:
804
56
        NewOpc = X86_VPCMPWZ128rmi_alt;
805
56
        break;
806
92
      case X86_VPCMPWZ128rmik:
807
92
        NewOpc = X86_VPCMPWZ128rmik_alt;
808
92
        break;
809
25
      case X86_VPCMPWZ128rri:
810
25
        NewOpc = X86_VPCMPWZ128rri_alt;
811
25
        break;
812
194
      case X86_VPCMPWZ128rrik:
813
194
        NewOpc = X86_VPCMPWZ128rrik_alt;
814
194
        break;
815
75
      case X86_VPCMPWZ256rmi:
816
75
        NewOpc = X86_VPCMPWZ256rmi_alt;
817
75
        break;
818
116
      case X86_VPCMPWZ256rmik:
819
116
        NewOpc = X86_VPCMPWZ256rmik_alt;
820
116
        break;
821
225
      case X86_VPCMPWZ256rri:
822
225
        NewOpc = X86_VPCMPWZ256rri_alt;
823
225
        break;
824
245
      case X86_VPCMPWZ256rrik:
825
245
        NewOpc = X86_VPCMPWZ256rrik_alt;
826
245
        break;
827
72
      case X86_VPCMPWZrmi:
828
72
        NewOpc = X86_VPCMPWZrmi_alt;
829
72
        break;
830
168
      case X86_VPCMPWZrmik:
831
168
        NewOpc = X86_VPCMPWZrmik_alt;
832
168
        break;
833
151
      case X86_VPCMPWZrri:
834
151
        NewOpc = X86_VPCMPWZrri_alt;
835
151
        break;
836
2
      case X86_VPCMPWZrrik:
837
2
        NewOpc = X86_VPCMPWZrrik_alt;
838
2
        break;
839
17.7k
      }
840
841
      // Switch opcode to the one that doesn't get special printing.
842
17.7k
      if (NewOpc != 0) {
843
17.7k
        MCInst_setOpcode(mcInst, NewOpc);
844
17.7k
      }
845
17.7k
    }
846
25.9k
#endif
847
25.9k
  }
848
849
358k
  switch (type) {
850
697
  case TYPE_XMM:
851
697
    MCOperand_CreateReg0(mcInst,
852
697
             X86_XMM0 + ((uint32_t)immediate >> 4));
853
697
    return;
854
1.75k
  case TYPE_YMM:
855
1.75k
    MCOperand_CreateReg0(mcInst,
856
1.75k
             X86_YMM0 + ((uint32_t)immediate >> 4));
857
1.75k
    return;
858
0
  case TYPE_ZMM:
859
0
    MCOperand_CreateReg0(mcInst,
860
0
             X86_ZMM0 + ((uint32_t)immediate >> 4));
861
0
    return;
862
356k
  default:
863
    // operand is 64 bits wide.  Do nothing.
864
356k
    break;
865
358k
  }
866
867
356k
  MCOperand_CreateImm0(mcInst, immediate);
868
869
356k
  if (type == TYPE_MOFFS) {
870
13.0k
    MCOperand_CreateReg0(mcInst,
871
13.0k
             segmentRegnums[insn->segmentOverride]);
872
13.0k
  }
873
356k
}
874
875
/// translateRMRegister - Translates a register stored in the R/M field of the
876
///   ModR/M byte to its LLVM equivalent and appends it to an MCInst.
877
/// @param mcInst       - The MCInst to append to.
878
/// @param insn         - The internal instruction to extract the R/M field
879
///                       from.
880
/// @return             - 0 on success; -1 otherwise
881
static bool translateRMRegister(MCInst *mcInst, InternalInstruction *insn)
882
261k
{
883
261k
  if (insn->eaBase == EA_BASE_sib || insn->eaBase == EA_BASE_sib64) {
884
    //debug("A R/M register operand may not have a SIB byte");
885
0
    return true;
886
0
  }
887
888
261k
  switch (insn->eaBase) {
889
0
  case EA_BASE_NONE:
890
    //debug("EA_BASE_NONE for ModR/M base");
891
0
    return true;
892
0
#define ENTRY(x) case EA_BASE_##x:
893
0
    ALL_EA_BASES
894
0
#undef ENTRY
895
    //debug("A R/M register operand may not have a base; "
896
    //      "the operand must be a register.");
897
0
    return true;
898
0
#define ENTRY(x) \
899
261k
  case EA_REG_##x: \
900
261k
    MCOperand_CreateReg0(mcInst, X86_##x); \
901
261k
    break;
902
0
    ALL_REGS
903
0
#undef ENTRY
904
0
  default:
905
    //debug("Unexpected EA base register");
906
0
    return true;
907
261k
  }
908
909
261k
  return false;
910
261k
}
911
912
/// translateRMMemory - Translates a memory operand stored in the Mod and R/M
913
///   fields of an internal instruction (and possibly its SIB byte) to a memory
914
///   operand in LLVM's format, and appends it to an MCInst.
915
///
916
/// @param mcInst       - The MCInst to append to.
917
/// @param insn         - The instruction to extract Mod, R/M, and SIB fields
918
///                       from.
919
/// @return             - 0 on success; nonzero otherwise
920
static bool translateRMMemory(MCInst *mcInst, InternalInstruction *insn)
921
518k
{
922
  // Addresses in an MCInst are represented as five operands:
923
  //   1. basereg       (register)  The R/M base, or (if there is a SIB) the
924
  //                                SIB base
925
  //   2. scaleamount   (immediate) 1, or (if there is a SIB) the specified
926
  //                                scale amount
927
  //   3. indexreg      (register)  x86_registerNONE, or (if there is a SIB)
928
  //                                the index (which is multiplied by the
929
  //                                scale amount)
930
  //   4. displacement  (immediate) 0, or the displacement if there is one
931
  //   5. segmentreg    (register)  x86_registerNONE for now, but could be set
932
  //                                if we have segment overrides
933
518k
  int scaleAmount, indexReg;
934
935
518k
  if (insn->eaBase == EA_BASE_sib || insn->eaBase == EA_BASE_sib64) {
936
43.2k
    if (insn->sibBase != SIB_BASE_NONE) {
937
41.2k
      switch (insn->sibBase) {
938
0
#define ENTRY(x) \
939
41.2k
  case SIB_BASE_##x: \
940
41.2k
    MCOperand_CreateReg0(mcInst, X86_##x); \
941
41.2k
    break;
942
0
        ALL_SIB_BASES
943
0
#undef ENTRY
944
0
      default:
945
        //debug("Unexpected sibBase");
946
0
        return true;
947
41.2k
      }
948
41.2k
    } else {
949
2.02k
      MCOperand_CreateReg0(mcInst, 0);
950
2.02k
    }
951
952
43.2k
    if (insn->sibIndex != SIB_INDEX_NONE) {
953
35.9k
      switch (insn->sibIndex) {
954
0
      default:
955
        //debug("Unexpected sibIndex");
956
0
        return true;
957
0
#define ENTRY(x) \
958
35.9k
  case SIB_INDEX_##x: \
959
35.9k
    indexReg = X86_##x; \
960
35.9k
    break;
961
0
        EA_BASES_32BIT
962
136
        EA_BASES_64BIT
963
538
        REGS_XMM
964
110
        REGS_YMM
965
35.9k
        REGS_ZMM
966
35.9k
#undef ENTRY
967
35.9k
      }
968
35.9k
    } else {
969
      // Use EIZ/RIZ for a few ambiguous cases where the SIB byte is present,
970
      // but no index is used and modrm alone should have been enough.
971
      // -No base register in 32-bit mode. In 64-bit mode this is used to
972
      //  avoid rip-relative addressing.
973
      // -Any base register used other than ESP/RSP/R12D/R12. Using these as a
974
      //  base always requires a SIB byte.
975
      // -A scale other than 1 is used.
976
7.29k
      if (insn->sibScale != 1 ||
977
5.39k
          (insn->sibBase == SIB_BASE_NONE &&
978
937
           insn->mode != MODE_64BIT) ||
979
5.08k
          (insn->sibBase != SIB_BASE_NONE &&
980
4.45k
           insn->sibBase != SIB_BASE_ESP &&
981
3.43k
           insn->sibBase != SIB_BASE_RSP &&
982
2.72k
           insn->sibBase != SIB_BASE_R12D &&
983
3.28k
           insn->sibBase != SIB_BASE_R12)) {
984
3.28k
        indexReg = insn->addressSize == 4 ? X86_EIZ :
985
3.28k
                    X86_RIZ;
986
3.28k
      } else
987
4.01k
        indexReg = 0;
988
7.29k
    }
989
990
43.2k
    scaleAmount = insn->sibScale;
991
475k
  } else {
992
475k
    switch (insn->eaBase) {
993
11.6k
    case EA_BASE_NONE:
994
11.6k
      if (insn->eaDisplacement == EA_DISP_NONE) {
995
        //debug("EA_BASE_NONE and EA_DISP_NONE for ModR/M base");
996
0
        return true;
997
0
      }
998
11.6k
      if (insn->mode == MODE_64BIT) {
999
2.48k
        if (insn->prefix3 ==
1000
2.48k
            0x67) // address-size prefix overrides RIP relative addressing
1001
289
          MCOperand_CreateReg0(mcInst, X86_EIP);
1002
2.19k
        else
1003
          // Section 2.2.1.6
1004
2.19k
          MCOperand_CreateReg0(
1005
2.19k
            mcInst, insn->addressSize == 4 ?
1006
0
                X86_EIP :
1007
2.19k
                X86_RIP);
1008
9.20k
      } else {
1009
9.20k
        MCOperand_CreateReg0(mcInst, 0);
1010
9.20k
      }
1011
1012
11.6k
      indexReg = 0;
1013
11.6k
      break;
1014
56.9k
    case EA_BASE_BX_SI:
1015
56.9k
      MCOperand_CreateReg0(mcInst, X86_BX);
1016
56.9k
      indexReg = X86_SI;
1017
56.9k
      break;
1018
25.7k
    case EA_BASE_BX_DI:
1019
25.7k
      MCOperand_CreateReg0(mcInst, X86_BX);
1020
25.7k
      indexReg = X86_DI;
1021
25.7k
      break;
1022
21.4k
    case EA_BASE_BP_SI:
1023
21.4k
      MCOperand_CreateReg0(mcInst, X86_BP);
1024
21.4k
      indexReg = X86_SI;
1025
21.4k
      break;
1026
17.7k
    case EA_BASE_BP_DI:
1027
17.7k
      MCOperand_CreateReg0(mcInst, X86_BP);
1028
17.7k
      indexReg = X86_DI;
1029
17.7k
      break;
1030
341k
    default:
1031
341k
      indexReg = 0;
1032
341k
      switch (insn->eaBase) {
1033
0
      default:
1034
        //debug("Unexpected eaBase");
1035
0
        return true;
1036
        // Here, we will use the fill-ins defined above.  However,
1037
        //   BX_SI, BX_DI, BP_SI, and BP_DI are all handled above and
1038
        //   sib and sib64 were handled in the top-level if, so they're only
1039
        //   placeholders to keep the compiler happy.
1040
0
#define ENTRY(x) \
1041
341k
  case EA_BASE_##x: \
1042
341k
    MCOperand_CreateReg0(mcInst, X86_##x); \
1043
341k
    break;
1044
0
        ALL_EA_BASES
1045
0
#undef ENTRY
1046
7.12k
#define ENTRY(x) case EA_REG_##x:
1047
2.37k
        ALL_REGS
1048
0
#undef ENTRY
1049
        //debug("A R/M memory operand may not be a register; "
1050
        //      "the base field must be a base.");
1051
0
        return true;
1052
341k
      }
1053
475k
    }
1054
1055
475k
    scaleAmount = 1;
1056
475k
  }
1057
1058
518k
  MCOperand_CreateImm0(mcInst, scaleAmount);
1059
518k
  MCOperand_CreateReg0(mcInst, indexReg);
1060
518k
  MCOperand_CreateImm0(mcInst, insn->displacement);
1061
1062
518k
  MCOperand_CreateReg0(mcInst, segmentRegnums[insn->segmentOverride]);
1063
1064
518k
  return false;
1065
518k
}
1066
1067
/// translateRM - Translates an operand stored in the R/M (and possibly SIB)
1068
///   byte of an instruction to LLVM form, and appends it to an MCInst.
1069
///
1070
/// @param mcInst       - The MCInst to append to.
1071
/// @param operand      - The operand, as stored in the descriptor table.
1072
/// @param insn         - The instruction to extract Mod, R/M, and SIB fields
1073
///                       from.
1074
/// @return             - 0 on success; nonzero otherwise
1075
static bool translateRM(MCInst *mcInst, const OperandSpecifier *operand,
1076
      InternalInstruction *insn)
1077
779k
{
1078
779k
  switch (operand->type) {
1079
0
  default:
1080
    //debug("Unexpected type for a R/M operand");
1081
0
    return true;
1082
89.3k
  case TYPE_R8:
1083
90.8k
  case TYPE_R16:
1084
92.3k
  case TYPE_R32:
1085
111k
  case TYPE_R64:
1086
192k
  case TYPE_Rv:
1087
196k
  case TYPE_MM64:
1088
222k
  case TYPE_XMM:
1089
239k
  case TYPE_YMM:
1090
257k
  case TYPE_ZMM:
1091
260k
  case TYPE_VK:
1092
260k
  case TYPE_DEBUGREG:
1093
260k
  case TYPE_CONTROLREG:
1094
261k
  case TYPE_BNDR:
1095
261k
    return translateRMRegister(mcInst, insn);
1096
504k
  case TYPE_M:
1097
509k
  case TYPE_MVSIBX:
1098
513k
  case TYPE_MVSIBY:
1099
518k
  case TYPE_MVSIBZ:
1100
518k
    return translateRMMemory(mcInst, insn);
1101
779k
  }
1102
779k
}
1103
1104
/// translateFPRegister - Translates a stack position on the FPU stack to its
1105
///   LLVM form, and appends it to an MCInst.
1106
///
1107
/// @param mcInst       - The MCInst to append to.
1108
/// @param stackPos     - The stack position to translate.
1109
static void translateFPRegister(MCInst *mcInst, uint8_t stackPos)
1110
5.10k
{
1111
5.10k
  MCOperand_CreateReg0(mcInst, X86_ST0 + stackPos);
1112
5.10k
}
1113
1114
/// translateMaskRegister - Translates a 3-bit mask register number to
1115
///   LLVM form, and appends it to an MCInst.
1116
///
1117
/// @param mcInst       - The MCInst to append to.
1118
/// @param maskRegNum   - Number of mask register from 0 to 7.
1119
/// @return             - false on success; true otherwise.
1120
static bool translateMaskRegister(MCInst *mcInst, uint8_t maskRegNum)
1121
86.2k
{
1122
86.2k
  if (maskRegNum >= 8) {
1123
    // debug("Invalid mask register number");
1124
0
    return true;
1125
0
  }
1126
1127
86.2k
  MCOperand_CreateReg0(mcInst, X86_K0 + maskRegNum);
1128
1129
86.2k
  return false;
1130
86.2k
}
1131
1132
/// translateOperand - Translates an operand stored in an internal instruction
1133
///   to LLVM's format and appends it to an MCInst.
1134
///
1135
/// @param mcInst       - The MCInst to append to.
1136
/// @param operand      - The operand, as stored in the descriptor table.
1137
/// @param insn         - The internal instruction.
1138
/// @return             - false on success; true otherwise.
1139
static bool translateOperand(MCInst *mcInst, const OperandSpecifier *operand,
1140
           InternalInstruction *insn)
1141
2.59M
{
1142
2.59M
  switch (operand->encoding) {
1143
655k
  case ENCODING_REG:
1144
655k
    translateRegister(mcInst, insn->reg);
1145
655k
    return false;
1146
86.2k
  case ENCODING_WRITEMASK:
1147
86.2k
    return translateMaskRegister(mcInst, insn->writemask);
1148
4.96M
CASE_ENCODING_RM:
1149
4.96M
CASE_ENCODING_VSIB:
1150
779k
    return translateRM(mcInst, operand, insn);
1151
272k
  case ENCODING_IB:
1152
287k
  case ENCODING_IW:
1153
293k
  case ENCODING_ID:
1154
294k
  case ENCODING_IO:
1155
345k
  case ENCODING_Iv:
1156
358k
  case ENCODING_Ia:
1157
358k
    translateImmediate(
1158
358k
      mcInst,
1159
358k
      insn->immediates[insn->numImmediatesTranslated++],
1160
358k
      operand, insn);
1161
358k
    return false;
1162
4.22k
  case ENCODING_IRC:
1163
4.22k
    MCOperand_CreateImm0(mcInst, insn->RC);
1164
4.22k
    return false;
1165
58.5k
  case ENCODING_SI:
1166
58.5k
    return translateSrcIndex(mcInst, insn);
1167
69.0k
  case ENCODING_DI:
1168
69.0k
    return translateDstIndex(mcInst, insn);
1169
14.0k
  case ENCODING_RB:
1170
14.0k
  case ENCODING_RW:
1171
14.0k
  case ENCODING_RD:
1172
35.6k
  case ENCODING_RO:
1173
181k
  case ENCODING_Rv:
1174
181k
    translateRegister(mcInst, insn->opcodeRegister);
1175
181k
    return false;
1176
5.10k
  case ENCODING_FP:
1177
5.10k
    translateFPRegister(mcInst, insn->modRM & 7);
1178
5.10k
    return false;
1179
103k
  case ENCODING_VVVV:
1180
103k
    translateRegister(mcInst, insn->vvvv);
1181
103k
    return false;
1182
291k
  case ENCODING_DUP:
1183
291k
    return translateOperand(
1184
291k
      mcInst, &insn->operands[operand->type - TYPE_DUP0],
1185
291k
      insn);
1186
0
  default:
1187
    //debug("Unhandled operand encoding during translation");
1188
0
    return true;
1189
2.59M
  }
1190
2.59M
}
1191
1192
static bool translateInstruction(MCInst *mcInst, InternalInstruction *insn)
1193
1.27M
{
1194
1.27M
  int index;
1195
1196
1.27M
  if (!insn->spec) {
1197
    //debug("Instruction has no specification");
1198
0
    return true;
1199
0
  }
1200
1201
1.27M
  MCInst_clear(mcInst);
1202
1.27M
  MCInst_setOpcode(mcInst, insn->instructionID);
1203
1204
  // If when reading the prefix bytes we determined the overlapping 0xf2 or 0xf3
1205
  // prefix bytes should be disassembled as xrelease and xacquire then set the
1206
  // opcode to those instead of the rep and repne opcodes.
1207
1.27M
#ifndef CAPSTONE_X86_REDUCE
1208
1.27M
  if (insn->xAcquireRelease) {
1209
8.49k
    if (MCInst_getOpcode(mcInst) == X86_REP_PREFIX)
1210
0
      MCInst_setOpcode(mcInst, X86_XRELEASE_PREFIX);
1211
8.49k
    else if (MCInst_getOpcode(mcInst) == X86_REPNE_PREFIX)
1212
0
      MCInst_setOpcode(mcInst, X86_XACQUIRE_PREFIX);
1213
8.49k
  }
1214
1.27M
#endif
1215
1216
1.27M
  insn->numImmediatesTranslated = 0;
1217
1218
8.91M
  for (index = 0; index < X86_MAX_OPERANDS; ++index) {
1219
7.64M
    if (insn->operands[index].encoding != ENCODING_NONE) {
1220
2.30M
      if (translateOperand(mcInst, &insn->operands[index],
1221
2.30M
               insn)) {
1222
0
        return true;
1223
0
      }
1224
2.30M
    }
1225
7.64M
  }
1226
1227
1.27M
  return false;
1228
1.27M
}
1229
1230
static int reader(const struct reader_info *info, uint8_t *byte,
1231
      uint64_t address)
1232
5.99M
{
1233
5.99M
  if (address - info->offset >= info->size)
1234
    // out of buffer range
1235
6.54k
    return -1;
1236
1237
5.98M
  *byte = info->code[address - info->offset];
1238
1239
5.98M
  return 0;
1240
5.99M
}
1241
1242
// copy x86 detail information from internal structure to public structure
1243
static void update_pub_insn(cs_insn *pub, InternalInstruction *inter)
1244
1.27M
{
1245
1.27M
  if (inter->vectorExtensionType != 0) {
1246
140k
    memcpy(pub->detail->x86.opcode, inter->vectorExtensionPrefix,
1247
140k
           sizeof(pub->detail->x86.opcode));
1248
1.13M
  } else {
1249
1.13M
    if (inter->twoByteEscape) {
1250
68.4k
      if (inter->threeByteEscape) {
1251
0
        pub->detail->x86.opcode[0] =
1252
0
          inter->twoByteEscape;
1253
0
        pub->detail->x86.opcode[1] =
1254
0
          inter->threeByteEscape;
1255
0
        pub->detail->x86.opcode[2] = inter->opcode;
1256
68.4k
      } else {
1257
68.4k
        pub->detail->x86.opcode[0] =
1258
68.4k
          inter->twoByteEscape;
1259
68.4k
        pub->detail->x86.opcode[1] = inter->opcode;
1260
68.4k
      }
1261
1.06M
    } else {
1262
1.06M
      pub->detail->x86.opcode[0] = inter->opcode;
1263
1.06M
    }
1264
1.13M
  }
1265
1266
1.27M
  pub->detail->x86.rex = inter->rexPrefix;
1267
1268
1.27M
  pub->detail->x86.addr_size = inter->addressSize;
1269
1270
1.27M
  pub->detail->x86.modrm = inter->orgModRM;
1271
1.27M
  pub->detail->x86.encoding.modrm_offset = inter->modRMOffset;
1272
1273
1.27M
  pub->detail->x86.sib = inter->sib;
1274
1.27M
  pub->detail->x86.sib_index = x86_map_sib_index(inter->sibIndex);
1275
1.27M
  pub->detail->x86.sib_scale = inter->sibScale;
1276
1.27M
  pub->detail->x86.sib_base = x86_map_sib_base(inter->sibBase);
1277
1278
1.27M
  pub->detail->x86.disp = inter->displacement;
1279
1.27M
  if (inter->consumedDisplacement) {
1280
167k
    pub->detail->x86.encoding.disp_offset =
1281
167k
      inter->displacementOffset;
1282
167k
    pub->detail->x86.encoding.disp_size = inter->displacementSize;
1283
167k
  }
1284
1285
1.27M
  pub->detail->x86.encoding.imm_offset = inter->immediateOffset;
1286
1.27M
  if (pub->detail->x86.encoding.imm_size == 0 &&
1287
1.27M
      inter->immediateOffset != 0)
1288
337k
    pub->detail->x86.encoding.imm_size = inter->immediateSize;
1289
1.27M
}
1290
1291
void X86_init(MCRegisterInfo *MRI)
1292
19.5k
{
1293
  // InitMCRegisterInfo(), X86GenRegisterInfo.inc
1294
  // RI->InitMCRegisterInfo(X86RegDesc, 277,
1295
  //                        RA, PC,
1296
  //                        X86MCRegisterClasses, 86,
1297
  //                        X86RegUnitRoots, 162, X86RegDiffLists, X86LaneMaskLists, X86RegStrings,
1298
  //                        X86RegClassStrings,
1299
  //                        X86SubRegIdxLists, 9,
1300
  //                        X86SubRegIdxRanges, X86RegEncodingTable);
1301
  /*
1302
     InitMCRegisterInfo(X86RegDesc, 234,
1303
     RA, PC,
1304
     X86MCRegisterClasses, 79,
1305
     X86RegUnitRoots, 119, X86RegDiffLists, X86RegStrings,
1306
     X86SubRegIdxLists, 7,
1307
     X86SubRegIdxRanges, X86RegEncodingTable);
1308
  */
1309
1310
19.5k
  MCRegisterInfo_InitMCRegisterInfo(MRI, X86RegDesc, 277, 0, 0,
1311
19.5k
            X86MCRegisterClasses, 86, 0, 0,
1312
19.5k
            X86RegDiffLists, 0, X86SubRegIdxLists,
1313
19.5k
            9, 0);
1314
19.5k
}
1315
1316
// Public interface for the disassembler
1317
bool X86_getInstruction(csh ud, const uint8_t *code, size_t code_len,
1318
      MCInst *instr, uint16_t *size, uint64_t address,
1319
      void *_info)
1320
1.28M
{
1321
1.28M
  cs_struct *handle = (cs_struct *)(uintptr_t)ud;
1322
1.28M
  InternalInstruction insn = { 0 };
1323
1.28M
  struct reader_info info;
1324
1.28M
  int ret;
1325
1.28M
  bool result;
1326
1327
1.28M
  info.code = code;
1328
1.28M
  info.size = code_len;
1329
1.28M
  info.offset = address;
1330
1331
1.28M
  if (instr->flat_insn->detail) {
1332
    // instr->flat_insn->detail initialization: 3 alternatives
1333
1334
    // 1. The whole structure, this is how it's done in other arch disassemblers
1335
    // Probably overkill since cs_detail is huge because of the 36 operands of ARM
1336
1337
    //memset(instr->flat_insn->detail, 0, sizeof(cs_detail));
1338
1339
    // 2. Only the part relevant to x86
1340
1.28M
    memset(instr->flat_insn->detail, 0,
1341
1.28M
           offsetof(cs_detail, x86) + sizeof(cs_x86));
1342
1343
    // 3. The relevant part except for x86.operands
1344
    // sizeof(cs_x86) is 0x1c0, sizeof(x86.operands) is 0x180
1345
    // marginally faster, should be okay since x86.op_count is set to 0
1346
1347
    //memset(instr->flat_insn->detail, 0, offsetof(cs_detail, x86)+offsetof(cs_x86, operands));
1348
1.28M
  }
1349
1350
1.28M
  if (handle->mode & CS_MODE_16)
1351
430k
    ret = decodeInstruction(&insn, reader, &info, address,
1352
430k
          MODE_16BIT);
1353
852k
  else if (handle->mode & CS_MODE_32)
1354
400k
    ret = decodeInstruction(&insn, reader, &info, address,
1355
400k
          MODE_32BIT);
1356
451k
  else
1357
451k
    ret = decodeInstruction(&insn, reader, &info, address,
1358
451k
          MODE_64BIT);
1359
1360
1.28M
  if (ret) {
1361
    // *size = (uint16_t)(insn.readerCursor - address);
1362
9.39k
    return false;
1363
1.27M
  } else {
1364
1.27M
    *size = (uint16_t)insn.length;
1365
1366
1.27M
    result = (!translateInstruction(instr, &insn)) ? true : false;
1367
1.27M
    if (result) {
1368
1.27M
      unsigned Flags = X86_IP_NO_PREFIX;
1369
1.27M
      instr->imm_size = insn.immSize;
1370
1371
      // copy all prefixes
1372
1.27M
      instr->x86_prefix[0] = insn.prefix0;
1373
1.27M
      instr->x86_prefix[1] = insn.prefix1;
1374
1.27M
      instr->x86_prefix[2] = insn.prefix2;
1375
1.27M
      instr->x86_prefix[3] = insn.prefix3;
1376
1.27M
      instr->xAcquireRelease = insn.xAcquireRelease;
1377
1378
1.27M
      if (handle->detail_opt) {
1379
1.27M
        update_pub_insn(instr->flat_insn, &insn);
1380
1.27M
      }
1381
1382
1.27M
      if (insn.hasAdSize)
1383
14.0k
        Flags |= X86_IP_HAS_AD_SIZE;
1384
1385
1.27M
      if (!insn.mandatoryPrefix) {
1386
1.25M
        if (insn.hasOpSize)
1387
27.7k
          Flags |= X86_IP_HAS_OP_SIZE;
1388
1389
1.25M
        if (insn.repeatPrefix == 0xf2)
1390
37.2k
          Flags |= X86_IP_HAS_REPEAT_NE;
1391
1.21M
        else if (insn.repeatPrefix == 0xf3 &&
1392
           // It should not be 'pause' f3 90
1393
32.3k
           insn.opcode != 0x90)
1394
32.0k
          Flags |= X86_IP_HAS_REPEAT;
1395
1.25M
        if (insn.hasLockPrefix)
1396
57.6k
          Flags |= X86_IP_HAS_LOCK;
1397
1.25M
      }
1398
1399
1.27M
      instr->flags = Flags;
1400
1.27M
    }
1401
1402
1.27M
    return result;
1403
1.27M
  }
1404
1.28M
}
1405
1406
#endif