Coverage Report

Created: 2025-10-14 06:42

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/capstonenext/arch/ARM/ARMDisassemblerExtension.c
Line
Count
Source
1
/* Capstone Disassembly Engine */
2
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */
3
/*    Rot127 <unisono@quyllur.org>, 2022-2023 */
4
5
#include "ARMDisassemblerExtension.h"
6
#include "ARMBaseInfo.h"
7
8
bool ITBlock_push_back(ARM_ITBlock *it, char v)
9
41.8k
{
10
41.8k
  if (it->size >= sizeof(it->ITStates)) {
11
    // TODO: consider warning user.
12
1.66k
    it->size = 0;
13
1.66k
  }
14
41.8k
  it->ITStates[it->size] = v;
15
41.8k
  it->size++;
16
17
41.8k
  return true;
18
41.8k
}
19
20
// Returns true if the current instruction is in an IT block
21
bool ITBlock_instrInITBlock(ARM_ITBlock *it)
22
1.38M
{
23
1.38M
  return (it->size > 0);
24
1.38M
}
25
26
// Returns true if current instruction is the last instruction in an IT block
27
bool ITBlock_instrLastInITBlock(ARM_ITBlock *it)
28
1.40k
{
29
1.40k
  return (it->size == 1);
30
1.40k
}
31
32
// Returns the condition code for instruction in IT block
33
unsigned ITBlock_getITCC(ARM_ITBlock *it)
34
40.8k
{
35
40.8k
  unsigned CC = ARMCC_AL;
36
37
40.8k
  if (ITBlock_instrInITBlock(it))
38
27.8k
    CC = it->ITStates[it->size - 1];
39
40
40.8k
  return CC;
41
40.8k
}
42
43
// Advances the IT block state to the next T or E
44
void ITBlock_advanceITState(ARM_ITBlock *it)
45
27.8k
{
46
27.8k
  it->size--;
47
27.8k
}
48
49
// Called when decoding an IT instruction. Sets the IT state for the following
50
// instructions that for the IT block. Firstcond and Mask correspond to the
51
// fields in the IT instruction encoding.
52
void ITBlock_setITState(ARM_ITBlock *it, char Firstcond, char Mask)
53
11.8k
{
54
  // (3 - the number of trailing zeros) is the number of then / else.
55
11.8k
  unsigned NumTZ = CountTrailingZeros_8(Mask);
56
11.8k
  unsigned char CCBits = (unsigned char)(Firstcond & 0xf);
57
11.8k
  CS_ASSERT_RET(NumTZ <= 3 && "Invalid IT mask!");
58
  // push condition codes onto the stack the correct order for the pops
59
41.8k
  for (unsigned Pos = NumTZ + 1; Pos <= 3; ++Pos) {
60
29.9k
    unsigned Else = (Mask >> Pos) & 1;
61
29.9k
    ITBlock_push_back(it, CCBits ^ Else);
62
29.9k
  }
63
11.8k
  ITBlock_push_back(it, CCBits);
64
11.8k
}
65
66
bool VPTBlock_push_back(ARM_VPTBlock *it, char v)
67
28.0k
{
68
28.0k
  if (it->size >= sizeof(it->VPTStates)) {
69
    // TODO: consider warning user.
70
642
    it->size = 0;
71
642
  }
72
28.0k
  it->VPTStates[it->size] = v;
73
28.0k
  it->size++;
74
75
28.0k
  return true;
76
28.0k
}
77
78
bool VPTBlock_instrInVPTBlock(ARM_VPTBlock *VPT)
79
1.76M
{
80
1.76M
  return VPT->size > 0;
81
1.76M
}
82
83
unsigned VPTBlock_getVPTPred(ARM_VPTBlock *VPT)
84
22.3k
{
85
22.3k
  unsigned Pred = ARMVCC_None;
86
22.3k
  if (VPTBlock_instrInVPTBlock(VPT))
87
22.3k
    Pred = VPT->VPTStates[VPT->size - 1];
88
22.3k
  return Pred;
89
22.3k
}
90
91
void VPTBlock_advanceVPTState(ARM_VPTBlock *VPT)
92
22.3k
{
93
22.3k
  VPT->size--;
94
22.3k
}
95
96
void VPTBlock_setVPTState(ARM_VPTBlock *VPT, char Mask)
97
7.81k
{
98
  // (3 - the number of trailing zeros) is the number of then / else.
99
7.81k
  unsigned NumTZ = CountTrailingZeros_8(Mask);
100
7.81k
  CS_ASSERT_RET(NumTZ <= 3 && "Invalid VPT mask!");
101
  // push predicates onto the stack the correct order for the pops
102
28.0k
  for (unsigned Pos = NumTZ + 1; Pos <= 3; ++Pos) {
103
20.2k
    bool T = ((Mask >> Pos) & 1) == 0;
104
20.2k
    if (T)
105
10.7k
      VPTBlock_push_back(VPT, ARMVCC_Then);
106
9.48k
    else
107
9.48k
      VPTBlock_push_back(VPT, ARMVCC_Else);
108
20.2k
  }
109
7.81k
  VPTBlock_push_back(VPT, ARMVCC_Then);
110
7.81k
}
111
112
// Imported from ARMBaseInstrInfo.h
113
//
114
/// isValidCoprocessorNumber - decide whether an explicit coprocessor
115
/// number is legal in generic instructions like CDP. The answer can
116
/// vary with the subtarget.
117
bool isValidCoprocessorNumber(MCInst *Inst, unsigned Num)
118
38.0k
{
119
  // In Armv7 and Armv8-M CP10 and CP11 clash with VFP/NEON, however, the
120
  // coprocessor is still valid for CDP/MCR/MRC and friends. Allowing it is
121
  // useful for code which is shared with older architectures which do not
122
  // know the new VFP/NEON mnemonics.
123
124
  // Armv8-A disallows everything *other* than 111x (CP14 and CP15).
125
38.0k
  if (ARM_getFeatureBits(Inst->csh->mode, ARM_HasV8Ops) &&
126
42
      (Num & 0xE) != 0xE)
127
34
    return false;
128
129
  // Armv8.1-M disallows 100x (CP8,CP9) and 111x (CP14,CP15)
130
  // which clash with MVE.
131
37.9k
  if (ARM_getFeatureBits(Inst->csh->mode, ARM_HasV8_1MMainlineOps) &&
132
8
      ((Num & 0xE) == 0x8 || (Num & 0xE) == 0xE))
133
8
    return false;
134
135
37.9k
  return true;
136
37.9k
}
137
138
// Imported from ARMMCTargetDesc.h
139
bool ARM_isVpred(arm_op_type op)
140
18.7M
{
141
18.7M
  return op == ARM_OP_VPRED_R || op == ARM_OP_VPRED_N;
142
18.7M
}
143
144
// Imported from ARMBaseInstrInfo.h
145
//
146
// This table shows the VPT instruction variants, i.e. the different
147
// mask field encodings, see also B5.6. Predication/conditional execution in
148
// the ArmARM.
149
bool isVPTOpcode(int Opc)
150
95.7k
{
151
95.7k
  return Opc == ARM_MVE_VPTv16i8 || Opc == ARM_MVE_VPTv16u8 ||
152
95.2k
         Opc == ARM_MVE_VPTv16s8 || Opc == ARM_MVE_VPTv8i16 ||
153
94.3k
         Opc == ARM_MVE_VPTv8u16 || Opc == ARM_MVE_VPTv8s16 ||
154
93.5k
         Opc == ARM_MVE_VPTv4i32 || Opc == ARM_MVE_VPTv4u32 ||
155
92.3k
         Opc == ARM_MVE_VPTv4s32 || Opc == ARM_MVE_VPTv4f32 ||
156
91.3k
         Opc == ARM_MVE_VPTv8f16 || Opc == ARM_MVE_VPTv16i8r ||
157
89.8k
         Opc == ARM_MVE_VPTv16u8r || Opc == ARM_MVE_VPTv16s8r ||
158
87.2k
         Opc == ARM_MVE_VPTv8i16r || Opc == ARM_MVE_VPTv8u16r ||
159
85.7k
         Opc == ARM_MVE_VPTv8s16r || Opc == ARM_MVE_VPTv4i32r ||
160
84.1k
         Opc == ARM_MVE_VPTv4u32r || Opc == ARM_MVE_VPTv4s32r ||
161
82.2k
         Opc == ARM_MVE_VPTv4f32r || Opc == ARM_MVE_VPTv8f16r ||
162
80.2k
         Opc == ARM_MVE_VPST;
163
95.7k
}
164
165
// Imported from ARMMCTargetDesc.cpp
166
bool ARM_isCDECoproc(size_t Coproc, const MCInst *MI)
167
52.9k
{
168
  // Unfortunately we don't have ARMTargetInfo in the disassembler, so we have
169
  // to rely on feature bits.
170
52.9k
  if (Coproc >= 8)
171
35.3k
    return false;
172
173
17.6k
  return ARM_getFeatureBits(MI->csh->mode,
174
17.6k
          ARM_FeatureCoprocCDE0 + Coproc);
175
52.9k
}
176
177
// Hacky: enable all features for disassembler
178
bool ARM_getFeatureBits(unsigned int mode, unsigned int feature)
179
3.74M
{
180
3.74M
  if (feature == ARM_ModeThumb) {
181
1.97M
    if (mode & CS_MODE_THUMB)
182
1.75M
      return true;
183
217k
    return false;
184
1.97M
  }
185
186
1.76M
  if (feature == ARM_FeatureDFB)
187
345
    return false;
188
189
1.76M
  if (feature == ARM_FeatureRAS)
190
593
    return false;
191
192
1.76M
  if (feature == ARM_FeatureMClass && (mode & CS_MODE_MCLASS) == 0)
193
69.4k
    return false;
194
195
1.69M
  if ((feature == ARM_HasMVEIntegerOps || feature == ARM_HasMVEFloatOps ||
196
1.59M
       feature == ARM_FeatureMVEVectorCostFactor1 ||
197
1.59M
       feature == ARM_FeatureMVEVectorCostFactor2 ||
198
1.59M
       feature == ARM_FeatureMVEVectorCostFactor4) &&
199
106k
      (mode & CS_MODE_MCLASS) == 0)
200
10.9k
    return false;
201
202
1.68M
  if ((feature == ARM_HasV8Ops || feature == ARM_HasV8_1MMainlineOps ||
203
1.42M
       feature == ARM_HasV8_1aOps || feature == ARM_HasV8_2aOps ||
204
1.42M
       feature == ARM_HasV8_3aOps || feature == ARM_HasV8_4aOps ||
205
1.42M
       feature == ARM_HasV8_5aOps || feature == ARM_HasV8_6aOps ||
206
1.42M
       feature == ARM_HasV8_7aOps || feature == ARM_HasV8_8aOps ||
207
1.42M
       feature == ARM_HasV8_9aOps) &&
208
267k
      (mode & CS_MODE_V8) == 0)
209
238k
    return false;
210
211
1.44M
  if (feature >= ARM_FeatureCoprocCDE0 &&
212
1.43M
      feature <= ARM_FeatureCoprocCDE7)
213
    // We currently have no way to detect CDE (Custom-Datapath-Extension)
214
    // coprocessors.
215
17.6k
    return false;
216
217
  // we support everything
218
1.43M
  return true;
219
1.44M
}