Coverage Report

Created: 2026-08-14 06:51

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/capstonenext/MCInst.c
Line
Count
Source
1
/* Capstone Disassembly Engine */
2
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */
3
#if defined(CAPSTONE_HAS_OSXKERNEL)
4
#include <Availability.h>
5
#include <libkern/libkern.h>
6
#else
7
#include <stdio.h>
8
#include <stdlib.h>
9
#endif
10
#include <string.h>
11
#include <assert.h>
12
13
#include "MCInstrDesc.h"
14
#include "MCInst.h"
15
#include "utils.h"
16
17
2.76M
#define MCINST_CACHE (ARR_SIZE(mcInst->Operands) - 1)
18
19
void MCInst_Init(MCInst *inst, cs_arch arch)
20
3.27M
{
21
3.27M
  memset(inst, 0, sizeof(MCInst));
22
  // unnecessary to initialize in loop . its expensive and inst->size should be honored
23
3.27M
  inst->Operands[0].Kind = kInvalid;
24
3.27M
  inst->Operands[0].ImmVal = 0;
25
26
3.27M
  inst->Opcode = 0;
27
3.27M
  inst->OpcodePub = 0;
28
3.27M
  inst->size = 0;
29
3.27M
  inst->has_imm = false;
30
3.27M
  inst->op1_size = 0;
31
3.27M
  inst->ac_idx = 0;
32
3.27M
  inst->popcode_adjust = 0;
33
3.27M
  inst->assembly[0] = '\0';
34
3.27M
  inst->wasm_data.type = WASM_OP_INVALID;
35
3.27M
  inst->xAcquireRelease = 0;
36
160M
  for (int i = 0; i < MAX_MC_OPS; ++i)
37
157M
    inst->tied_op_idx[i] = -1;
38
3.27M
  inst->isAliasInstr = false;
39
3.27M
  inst->fillDetailOps = false;
40
3.27M
  memset(&inst->hppa_ext, 0, sizeof(inst->hppa_ext));
41
42
  // Set default assembly dialect.
43
3.27M
  switch (arch) {
44
3.15M
  default:
45
3.15M
    break;
46
3.15M
  case CS_ARCH_SYSTEMZ:
47
123k
    inst->MAI.assemblerDialect = SYSTEMZASMDIALECT_AD_HLASM;
48
123k
    break;
49
3.27M
  }
50
3.27M
}
51
52
void MCInst_clear(MCInst *inst)
53
6.05M
{
54
6.05M
  inst->size = 0;
55
6.05M
}
56
57
// does not free @Op
58
void MCInst_insert0(MCInst *inst, int index, MCOperand *Op)
59
1.78M
{
60
1.78M
  CS_ASSERT_RET(index < MAX_MC_OPS && inst->size < MAX_MC_OPS);
61
1.78M
  int i;
62
63
3.20M
  for (i = inst->size; i > index; i--)
64
    //memcpy(&(inst->Operands[i]), &(inst->Operands[i-1]), sizeof(MCOperand));
65
1.42M
    inst->Operands[i] = inst->Operands[i - 1];
66
67
1.78M
  inst->Operands[index] = *Op;
68
1.78M
  inst->size++;
69
1.78M
}
70
71
void MCInst_setOpcode(MCInst *inst, unsigned Op)
72
5.84M
{
73
5.84M
  inst->Opcode = Op;
74
5.84M
}
75
76
void MCInst_setOpcodePub(MCInst *inst, unsigned Op)
77
158k
{
78
158k
  inst->OpcodePub = Op;
79
158k
}
80
81
unsigned MCInst_getOpcode(const MCInst *inst)
82
43.2M
{
83
43.2M
  return inst->Opcode;
84
43.2M
}
85
86
unsigned MCInst_getOpcodePub(const MCInst *inst)
87
6.04M
{
88
6.04M
  return inst->OpcodePub;
89
6.04M
}
90
91
MCOperand *MCInst_getOperand(MCInst *inst, unsigned i)
92
29.0M
{
93
29.0M
  assert(i < MAX_MC_OPS);
94
29.0M
  return &inst->Operands[i];
95
29.0M
}
96
97
unsigned MCInst_getNumOperands(const MCInst *inst)
98
11.0M
{
99
11.0M
  return inst->size;
100
11.0M
}
101
102
// This addOperand2 function doesn't free Op
103
void MCInst_addOperand2(MCInst *inst, MCOperand *Op)
104
91.6k
{
105
91.6k
  CS_ASSERT_RET(inst->size < MAX_MC_OPS);
106
91.6k
  inst->Operands[inst->size] = *Op;
107
108
91.6k
  inst->size++;
109
91.6k
}
110
111
bool MCOperand_isValid(const MCOperand *op)
112
0
{
113
0
  return op->Kind != kInvalid;
114
0
}
115
116
bool MCOperand_isReg(const MCOperand *op)
117
10.1M
{
118
10.1M
  return op->Kind == kRegister || op->MachineOperandType == kRegister;
119
10.1M
}
120
121
bool MCOperand_isImm(const MCOperand *op)
122
3.09M
{
123
3.09M
  return op->Kind == kImmediate || op->MachineOperandType == kImmediate;
124
3.09M
}
125
126
bool MCOperand_isFPImm(const MCOperand *op)
127
1.44k
{
128
1.44k
  return op->Kind == kFPImmediate;
129
1.44k
}
130
131
bool MCOperand_isDFPImm(const MCOperand *op)
132
1.47k
{
133
1.47k
  return op->Kind == kDFPImmediate;
134
1.47k
}
135
136
bool MCOperand_isExpr(const MCOperand *op)
137
153k
{
138
153k
  return op->Kind == kExpr;
139
153k
}
140
141
bool MCOperand_isInst(const MCOperand *op)
142
0
{
143
0
  return op->Kind == kInst;
144
0
}
145
146
/// getReg - Returns the register number.
147
unsigned MCOperand_getReg(const MCOperand *op)
148
19.4M
{
149
19.4M
  return op->RegVal;
150
19.4M
}
151
152
/// setReg - Set the register number.
153
void MCOperand_setReg(MCOperand *op, unsigned Reg)
154
19.8k
{
155
19.8k
  op->RegVal = Reg;
156
19.8k
}
157
158
int64_t MCOperand_getImm(const MCOperand *op)
159
9.87M
{
160
9.87M
  return op->ImmVal;
161
9.87M
}
162
163
int64_t MCOperand_getExpr(const MCOperand *op)
164
0
{
165
0
  return op->ImmVal;
166
0
}
167
168
void MCOperand_setImm(MCOperand *op, int64_t Val)
169
26.5k
{
170
26.5k
  op->ImmVal = Val;
171
26.5k
}
172
173
double MCOperand_getFPImm(const MCOperand *op)
174
0
{
175
0
  return op->FPImmVal;
176
0
}
177
178
void MCOperand_setFPImm(MCOperand *op, double Val)
179
0
{
180
0
  op->FPImmVal = Val;
181
0
}
182
183
MCOperand *MCOperand_CreateReg1(MCInst *mcInst, unsigned Reg)
184
1.58M
{
185
1.58M
  MCOperand *op = &(mcInst->Operands[MCINST_CACHE]);
186
187
1.58M
  op->MachineOperandType = kRegister;
188
1.58M
  op->Kind = kRegister;
189
1.58M
  op->RegVal = Reg;
190
191
1.58M
  return op;
192
1.58M
}
193
194
void MCOperand_CreateReg0(MCInst *mcInst, unsigned Reg)
195
5.88M
{
196
5.88M
  CS_ASSERT_RET(mcInst->size < MAX_MC_OPS);
197
5.88M
  MCOperand *op = &(mcInst->Operands[mcInst->size]);
198
5.88M
  mcInst->size++;
199
200
5.88M
  op->MachineOperandType = kRegister;
201
5.88M
  op->Kind = kRegister;
202
5.88M
  op->RegVal = Reg;
203
5.88M
}
204
205
MCOperand *MCOperand_CreateImm1(MCInst *mcInst, int64_t Val)
206
1.17M
{
207
1.17M
  MCOperand *op = &(mcInst->Operands[MCINST_CACHE]);
208
209
1.17M
  op->MachineOperandType = kImmediate;
210
1.17M
  op->Kind = kImmediate;
211
1.17M
  op->ImmVal = Val;
212
213
1.17M
  return op;
214
1.17M
}
215
216
void MCOperand_CreateImm0(MCInst *mcInst, int64_t Val)
217
2.76M
{
218
2.76M
  CS_ASSERT_RET(mcInst->size < MAX_MC_OPS);
219
2.76M
  MCOperand *op = &(mcInst->Operands[mcInst->size]);
220
2.76M
  mcInst->size++;
221
222
2.76M
  op->MachineOperandType = kImmediate;
223
2.76M
  op->Kind = kImmediate;
224
2.76M
  op->ImmVal = Val;
225
2.76M
}
226
227
/// Check if any operand of the MCInstrDesc is predicable
228
bool MCInst_isPredicable(const MCInstrDesc *MIDesc)
229
900k
{
230
900k
  const MCOperandInfo *OpInfo = MIDesc->OpInfo;
231
900k
  unsigned NumOps = MIDesc->NumOperands;
232
3.94M
  for (unsigned i = 0; i < NumOps; ++i) {
233
3.88M
    if (MCOperandInfo_isPredicate(&OpInfo[i])) {
234
845k
      return true;
235
845k
    }
236
3.88M
  }
237
54.2k
  return false;
238
900k
}
239
240
/// Checks if tied operands exist in the instruction and sets
241
/// - The writeback flag in detail
242
/// - Saves the indices of the tied destination operands.
243
void MCInst_handleWriteback(MCInst *MI, const MCInstrDesc *InstDescTable,
244
          unsigned tbl_size)
245
1.34M
{
246
1.34M
  const MCInstrDesc *InstDesc = NULL;
247
1.34M
  const MCOperandInfo *OpInfo = NULL;
248
1.34M
  unsigned short NumOps = 0;
249
1.34M
  InstDesc =
250
1.34M
    MCInstrDesc_get(MCInst_getOpcode(MI), InstDescTable, tbl_size);
251
1.34M
  OpInfo = InstDesc->OpInfo;
252
1.34M
  NumOps = InstDesc->NumOperands;
253
254
7.57M
  for (unsigned i = 0; i < NumOps; ++i) {
255
6.23M
    if (MCOperandInfo_isTiedToOp(&OpInfo[i])) {
256
297k
      int idx = MCOperandInfo_getOperandConstraint(
257
297k
        InstDesc, i, MCOI_TIED_TO);
258
259
297k
      if (idx == -1)
260
0
        continue;
261
262
297k
      if (i >= MAX_MC_OPS) {
263
0
        assert(0 &&
264
0
               "Maximum number of MC operands reached.");
265
0
      }
266
297k
      MI->tied_op_idx[i] = idx;
267
268
297k
      if (MI->flat_insn->detail)
269
297k
        MI->flat_insn->detail->writeback = true;
270
297k
    }
271
6.23M
  }
272
1.34M
}
273
274
/// Check if operand with OpNum is tied by another operand
275
/// (operand is tying destination).
276
bool MCInst_opIsTied(const MCInst *MI, unsigned OpNum)
277
5.24M
{
278
5.24M
  assert(OpNum < MAX_MC_OPS && "Maximum number of MC operands exceeded.");
279
248M
  for (int i = 0; i < MAX_MC_OPS; ++i) {
280
243M
    if (MI->tied_op_idx[i] == OpNum)
281
186k
      return true;
282
243M
  }
283
5.05M
  return false;
284
5.24M
}
285
286
/// Check if operand with OpNum is tying another operand
287
/// (operand is tying src).
288
bool MCInst_opIsTying(const MCInst *MI, unsigned OpNum)
289
5.24M
{
290
5.24M
  assert(OpNum < MAX_MC_OPS && "Maximum number of MC operands exceeded.");
291
5.24M
  return MI->tied_op_idx[OpNum] != -1;
292
5.24M
}
293
294
/// Returns the value of the @MCInst operand at index @OpNum.
295
uint64_t MCInst_getOpVal(MCInst *MI, unsigned OpNum)
296
4.92M
{
297
4.92M
  assert(OpNum < MAX_MC_OPS);
298
4.92M
  MCOperand *op = MCInst_getOperand(MI, OpNum);
299
4.92M
  if (MCOperand_isReg(op))
300
3.47M
    return MCOperand_getReg(op);
301
1.44M
  else if (MCOperand_isImm(op))
302
1.44M
    return MCOperand_getImm(op);
303
0
  else
304
1.44M
    assert(0 && "Operand type not handled in this getter.");
305
0
  return MCOperand_getImm(op);
306
4.92M
}
307
308
void MCInst_setIsAlias(MCInst *MI, bool Flag)
309
1.45M
{
310
1.45M
  assert(MI);
311
1.45M
  MI->isAliasInstr = Flag;
312
1.45M
  MI->flat_insn->is_alias = Flag;
313
1.45M
}
314
315
/// @brief Copies the relevant members of a temporary MCInst to
316
/// the main MCInst. This is used if TryDecode was run on a temporary MCInst.
317
/// @param MI The main MCInst
318
/// @param TmpMI The temporary MCInst.
319
void MCInst_updateWithTmpMI(MCInst *MI, MCInst *TmpMI)
320
0
{
321
0
  MI->size = TmpMI->size;
322
0
  MI->Opcode = TmpMI->Opcode;
323
0
  assert(MI->size < MAX_MC_OPS);
324
0
  memcpy(MI->Operands, TmpMI->Operands,
325
0
         sizeof(MI->Operands[0]) * MI->size);
326
0
}
327
328
/// @brief Sets the softfail/illegal flag in the cs_insn.
329
/// Setting it indicates the instruction can be decoded, but is invalid
330
/// due to not allowed operands or an illegal context.
331
///
332
/// @param MI The MCInst holding the cs_insn currently decoded.
333
void MCInst_setSoftFail(MCInst *MI)
334
91.9k
{
335
91.9k
  assert(MI && MI->flat_insn);
336
91.9k
  MI->flat_insn->illegal = true;
337
91.9k
}