Coverage Report

Created: 2026-07-16 06:55

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/capstonenext/arch/RISCV/RISCVDisassembler.c
Line
Count
Source
1
/* Capstone Disassembly Engine, http://www.capstone-engine.org */
2
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2022, */
3
/*    Rot127 <unisono@quyllur.org> 2022-2023 */
4
/* Automatically translated source file from LLVM. */
5
6
/* LLVM-commit: <commit> */
7
/* LLVM-tag: <tag> */
8
9
/* Only small edits allowed. */
10
/* For multiple similar edits, please create a Patch for the translator. */
11
12
/* Capstone's C++ file translator: */
13
/* https://github.com/capstone-engine/capstone/tree/next/suite/auto-sync */
14
15
//===-- RISCVDisassembler.cpp - Disassembler for RISC-V -------------------===//
16
//
17
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
18
// See https://llvm.org/LICENSE.txt for license information.
19
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
20
//
21
//===----------------------------------------------------------------------===//
22
//
23
// This file implements the RISCVDisassembler class.
24
//
25
//===----------------------------------------------------------------------===//
26
27
#include <stdio.h>
28
#include <string.h>
29
#include <stdlib.h>
30
#include <capstone/platform.h>
31
32
#include "../../MCInst.h"
33
#include "../../MathExtras.h"
34
#include "../../MCInstPrinter.h"
35
#include "../../MCDisassembler.h"
36
#include "../../MCFixedLenDisassembler.h"
37
#include "../../cs_priv.h"
38
#include "../../utils.h"
39
#include "RISCVDisassemblerExtension.h"
40
#include "RISCVBaseInfo.h"
41
#include "RISCVMapping.h"
42
43
#define GET_SUBTARGETINFO_ENUM
44
#include "RISCVGenSubtargetInfo.inc"
45
46
#define GET_REGINFO_ENUM
47
#include "RISCVGenRegisterInfo.inc"
48
49
#define GET_INSTRINFO_ENUM
50
#define GET_INSTRINFO_MC_DESC
51
#include "RISCVGenInstrInfo.inc"
52
53
10.9k
#define CONCAT(a, b) CONCAT_(a, b)
54
10.9k
#define CONCAT_(a, b) a##_##b
55
56
#define DEBUG_TYPE "riscv-disassembler"
57
58
DecodeStatus RISCV_getInstruction(MCInst *Instr, uint16_t *Size,
59
          const uint8_t *Bytes, size_t BytesLen,
60
          uint64_t Address, SStream *CStream);
61
void addSPOperands(MCInst *MI);
62
;
63
// end anonymous namespace
64
65
static DecodeStatus DecodeGPRRegisterClass(MCInst *Inst, uint32_t RegNo,
66
             uint64_t Address,
67
             const void *Decoder)
68
78.9k
{
69
78.9k
  bool IsRVE = RISCV_getFeatureBits(Inst->csh->mode, RISCV_FeatureRVE);
70
71
78.9k
  if (RegNo >= 32 || (IsRVE && RegNo >= 16))
72
0
    return MCDisassembler_Fail;
73
74
78.9k
  MCRegister Reg = RISCV_X0 + RegNo;
75
78.9k
  MCOperand_CreateReg0(Inst, (Reg));
76
78.9k
  return MCDisassembler_Success;
77
78.9k
}
78
79
static DecodeStatus DecodeGPRX1X5RegisterClass(MCInst *Inst, uint32_t RegNo,
80
                 uint64_t Address,
81
                 const void *Decoder)
82
0
{
83
0
  MCRegister Reg = RISCV_X0 + RegNo;
84
0
  if (Reg != RISCV_X1 && Reg != RISCV_X5)
85
0
    return MCDisassembler_Fail;
86
87
0
  MCOperand_CreateReg0(Inst, (Reg));
88
0
  return MCDisassembler_Success;
89
0
}
90
91
static DecodeStatus DecodeFPR16RegisterClass(MCInst *Inst, uint32_t RegNo,
92
               uint64_t Address,
93
               const void *Decoder)
94
6.14k
{
95
6.14k
  if (RegNo >= 32)
96
0
    return MCDisassembler_Fail;
97
98
6.14k
  MCRegister Reg = RISCV_F0_H + RegNo;
99
6.14k
  MCOperand_CreateReg0(Inst, (Reg));
100
6.14k
  return MCDisassembler_Success;
101
6.14k
}
102
103
static DecodeStatus DecodeFPR32RegisterClass(MCInst *Inst, uint32_t RegNo,
104
               uint64_t Address,
105
               const void *Decoder)
106
4.33k
{
107
4.33k
  if (RegNo >= 32)
108
0
    return MCDisassembler_Fail;
109
110
4.33k
  MCRegister Reg = RISCV_F0_F + RegNo;
111
4.33k
  MCOperand_CreateReg0(Inst, (Reg));
112
4.33k
  return MCDisassembler_Success;
113
4.33k
}
114
115
static DecodeStatus DecodeFPR32CRegisterClass(MCInst *Inst, uint32_t RegNo,
116
                uint64_t Address,
117
                const void *Decoder)
118
0
{
119
0
  if (RegNo >= 8) {
120
0
    return MCDisassembler_Fail;
121
0
  }
122
0
  MCRegister Reg = RISCV_F8_F + RegNo;
123
0
  MCOperand_CreateReg0(Inst, (Reg));
124
0
  return MCDisassembler_Success;
125
0
}
126
127
static DecodeStatus DecodeFPR64RegisterClass(MCInst *Inst, uint32_t RegNo,
128
               uint64_t Address,
129
               const void *Decoder)
130
0
{
131
0
  if (RegNo >= 32)
132
0
    return MCDisassembler_Fail;
133
134
0
  MCRegister Reg = RISCV_F0_D + RegNo;
135
0
  MCOperand_CreateReg0(Inst, (Reg));
136
0
  return MCDisassembler_Success;
137
0
}
138
139
static DecodeStatus DecodeFPR64CRegisterClass(MCInst *Inst, uint32_t RegNo,
140
                uint64_t Address,
141
                const void *Decoder)
142
0
{
143
0
  if (RegNo >= 8) {
144
0
    return MCDisassembler_Fail;
145
0
  }
146
0
  MCRegister Reg = RISCV_F8_D + RegNo;
147
0
  MCOperand_CreateReg0(Inst, (Reg));
148
0
  return MCDisassembler_Success;
149
0
}
150
151
static DecodeStatus DecodeGPRNoX0RegisterClass(MCInst *Inst, uint32_t RegNo,
152
                 uint64_t Address,
153
                 const void *Decoder)
154
36.7k
{
155
36.7k
  if (RegNo == 0) {
156
7
    return MCDisassembler_Fail;
157
7
  }
158
159
36.7k
  return DecodeGPRRegisterClass(Inst, RegNo, Address, Decoder);
160
36.7k
}
161
162
static DecodeStatus DecodeGPRNoX0X2RegisterClass(MCInst *Inst, uint64_t RegNo,
163
             uint32_t Address,
164
             const void *Decoder)
165
2.91k
{
166
2.91k
  if (RegNo == 2) {
167
0
    return MCDisassembler_Fail;
168
0
  }
169
170
2.91k
  return DecodeGPRNoX0RegisterClass(Inst, RegNo, Address, Decoder);
171
2.91k
}
172
173
static DecodeStatus DecodeGPRCRegisterClass(MCInst *Inst, uint32_t RegNo,
174
              uint64_t Address,
175
              const void *Decoder)
176
43.5k
{
177
43.5k
  if (RegNo >= 8)
178
0
    return MCDisassembler_Fail;
179
180
43.5k
  MCRegister Reg = RISCV_X8 + RegNo;
181
43.5k
  MCOperand_CreateReg0(Inst, (Reg));
182
43.5k
  return MCDisassembler_Success;
183
43.5k
}
184
185
static DecodeStatus DecodeGPRPairRegisterClass(MCInst *Inst, uint32_t RegNo,
186
                 uint64_t Address,
187
                 const void *Decoder)
188
61
{
189
61
  if (RegNo >= 32 || RegNo & 1)
190
2
    return MCDisassembler_Fail;
191
192
59
  MCRegister Reg = RISCV_X0 + RegNo;
193
59
  MCOperand_CreateReg0(Inst, (Reg));
194
59
  return MCDisassembler_Success;
195
61
}
196
197
static DecodeStatus DecodeSR07RegisterClass(MCInst *Inst, uint64_t RegNo,
198
              uint64_t Address,
199
              const void *Decoder)
200
0
{
201
0
  if (RegNo >= 8)
202
0
    return MCDisassembler_Fail;
203
204
0
  MCRegister Reg = (RegNo < 2) ? (RegNo + RISCV_X8) :
205
0
               (RegNo - 2 + RISCV_X18);
206
0
  MCOperand_CreateReg0(Inst, (Reg));
207
0
  return MCDisassembler_Success;
208
0
}
209
210
static DecodeStatus DecodeVRRegisterClass(MCInst *Inst, uint32_t RegNo,
211
            uint64_t Address, const void *Decoder)
212
15.3k
{
213
15.3k
  if (RegNo >= 32)
214
0
    return MCDisassembler_Fail;
215
216
15.3k
  MCRegister Reg = RISCV_V0 + RegNo;
217
15.3k
  MCOperand_CreateReg0(Inst, (Reg));
218
15.3k
  return MCDisassembler_Success;
219
15.3k
}
220
221
static DecodeStatus DecodeVRM2RegisterClass(MCInst *Inst, uint32_t RegNo,
222
              uint64_t Address,
223
              const void *Decoder)
224
501
{
225
501
  if (RegNo >= 32 || RegNo % 2)
226
3
    return MCDisassembler_Fail;
227
228
498
  MCRegister Reg = MCRegisterInfo_getMatchingSuperReg(
229
498
    Inst->MRI, RISCV_V0 + RegNo, RISCV_sub_vrm1_0,
230
498
    MCRegisterInfo_getRegClass(Inst->MRI, RISCV_VRM2RegClassID));
231
232
498
  MCOperand_CreateReg0(Inst, (Reg));
233
498
  return MCDisassembler_Success;
234
501
}
235
236
static DecodeStatus DecodeVRM4RegisterClass(MCInst *Inst, uint32_t RegNo,
237
              uint64_t Address,
238
              const void *Decoder)
239
62
{
240
62
  if (RegNo >= 32 || RegNo % 4)
241
4
    return MCDisassembler_Fail;
242
243
58
  MCRegister Reg = MCRegisterInfo_getMatchingSuperReg(
244
58
    Inst->MRI, RISCV_V0 + RegNo, RISCV_sub_vrm1_0,
245
58
    MCRegisterInfo_getRegClass(Inst->MRI, RISCV_VRM4RegClassID));
246
247
58
  MCOperand_CreateReg0(Inst, (Reg));
248
58
  return MCDisassembler_Success;
249
62
}
250
251
static DecodeStatus DecodeVRM8RegisterClass(MCInst *Inst, uint32_t RegNo,
252
              uint64_t Address,
253
              const void *Decoder)
254
580
{
255
580
  if (RegNo >= 32 || RegNo % 8)
256
3
    return MCDisassembler_Fail;
257
258
577
  MCRegister Reg = MCRegisterInfo_getMatchingSuperReg(
259
577
    Inst->MRI, RISCV_V0 + RegNo, RISCV_sub_vrm1_0,
260
577
    MCRegisterInfo_getRegClass(Inst->MRI, RISCV_VRM8RegClassID));
261
262
577
  MCOperand_CreateReg0(Inst, (Reg));
263
577
  return MCDisassembler_Success;
264
580
}
265
266
static DecodeStatus decodeVMaskReg(MCInst *Inst, uint64_t RegNo,
267
           uint64_t Address, const void *Decoder)
268
5.56k
{
269
5.56k
  if (RegNo > 2) {
270
0
    return MCDisassembler_Fail;
271
0
  }
272
5.56k
  MCRegister Reg = (RegNo == 0) ? RISCV_V0 : RISCV_NoRegister;
273
274
5.56k
  MCOperand_CreateReg0(Inst, (Reg));
275
5.56k
  return MCDisassembler_Success;
276
5.56k
}
277
278
#define DEFINE_decodeUImmOperand(N) \
279
  static DecodeStatus CONCAT(decodeUImmOperand, \
280
           N)(MCInst * Inst, uint32_t Imm, \
281
              int64_t Address, const void *Decoder) \
282
34.8k
  { \
283
34.8k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
34.8k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
34.8k
    return MCDisassembler_Success; \
286
34.8k
  }
RISCVDisassembler.c:decodeUImmOperand_8
Line
Count
Source
282
6.93k
  { \
283
6.93k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
6.93k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
6.93k
    return MCDisassembler_Success; \
286
6.93k
  }
RISCVDisassembler.c:decodeUImmOperand_9
Line
Count
Source
282
1.66k
  { \
283
1.66k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
1.66k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
1.66k
    return MCDisassembler_Success; \
286
1.66k
  }
RISCVDisassembler.c:decodeUImmOperand_7
Line
Count
Source
282
6.07k
  { \
283
6.07k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
6.07k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
6.07k
    return MCDisassembler_Success; \
286
6.07k
  }
RISCVDisassembler.c:decodeUImmOperand_2
Line
Count
Source
282
2.61k
  { \
283
2.61k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
2.61k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
2.61k
    return MCDisassembler_Success; \
286
2.61k
  }
RISCVDisassembler.c:decodeUImmOperand_4
Line
Count
Source
282
1.77k
  { \
283
1.77k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
1.77k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
1.77k
    return MCDisassembler_Success; \
286
1.77k
  }
RISCVDisassembler.c:decodeUImmOperand_20
Line
Count
Source
282
856
  { \
283
856
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
856
    MCOperand_CreateImm0(Inst, (Imm)); \
285
856
    return MCDisassembler_Success; \
286
856
  }
RISCVDisassembler.c:decodeUImmOperand_5
Line
Count
Source
282
4.78k
  { \
283
4.78k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
4.78k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
4.78k
    return MCDisassembler_Success; \
286
4.78k
  }
RISCVDisassembler.c:decodeUImmOperand_6
Line
Count
Source
282
1.32k
  { \
283
1.32k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
1.32k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
1.32k
    return MCDisassembler_Success; \
286
1.32k
  }
RISCVDisassembler.c:decodeUImmOperand_11
Line
Count
Source
282
2.52k
  { \
283
2.52k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
2.52k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
2.52k
    return MCDisassembler_Success; \
286
2.52k
  }
RISCVDisassembler.c:decodeUImmOperand_10
Line
Count
Source
282
4.01k
  { \
283
4.01k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
4.01k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
4.01k
    return MCDisassembler_Success; \
286
4.01k
  }
RISCVDisassembler.c:decodeUImmOperand_12
Line
Count
Source
282
2.22k
  { \
283
2.22k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
2.22k
    MCOperand_CreateImm0(Inst, (Imm)); \
285
2.22k
    return MCDisassembler_Success; \
286
2.22k
  }
RISCVDisassembler.c:decodeUImmOperand_3
Line
Count
Source
282
83
  { \
283
83
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
284
83
    MCOperand_CreateImm0(Inst, (Imm)); \
285
83
    return MCDisassembler_Success; \
286
83
  }
Unexecuted instantiation: RISCVDisassembler.c:decodeUImmOperand_1
287
DEFINE_decodeUImmOperand(6);
288
DEFINE_decodeUImmOperand(2);
289
DEFINE_decodeUImmOperand(8);
290
DEFINE_decodeUImmOperand(9);
291
DEFINE_decodeUImmOperand(7);
292
DEFINE_decodeUImmOperand(4);
293
DEFINE_decodeUImmOperand(20);
294
DEFINE_decodeUImmOperand(5);
295
DEFINE_decodeUImmOperand(11);
296
DEFINE_decodeUImmOperand(10);
297
DEFINE_decodeUImmOperand(12);
298
DEFINE_decodeUImmOperand(3);
299
DEFINE_decodeUImmOperand(1);
300
301
#define DEFINE_decodeUImmNonZeroOperand(N) \
302
  static DecodeStatus CONCAT(decodeUImmNonZeroOperand, \
303
           N)(MCInst * Inst, uint32_t Imm, \
304
              int64_t Address, const void *Decoder) \
305
3.62k
  { \
306
3.62k
    if (Imm == 0) \
307
3.62k
      return MCDisassembler_Fail; \
308
3.62k
    return CONCAT(decodeUImmOperand, N)(Inst, Imm, Address, \
309
3.61k
                Decoder); \
310
3.62k
  }
311
DEFINE_decodeUImmNonZeroOperand(10);
312
313
#define DEFINE_decodeSImmOperand(N) \
314
  static DecodeStatus CONCAT(decodeSImmOperand, \
315
           N)(MCInst * Inst, uint32_t Imm, \
316
              int64_t Address, const void *Decoder) \
317
17.8k
  { \
318
17.8k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
319
17.8k
\
320
17.8k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm), N))); \
321
17.8k
    return MCDisassembler_Success; \
322
17.8k
  }
RISCVDisassembler.c:decodeSImmOperand_6
Line
Count
Source
317
11.6k
  { \
318
11.6k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
319
11.6k
\
320
11.6k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm), N))); \
321
11.6k
    return MCDisassembler_Success; \
322
11.6k
  }
RISCVDisassembler.c:decodeSImmOperand_10
Line
Count
Source
317
553
  { \
318
553
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
319
553
\
320
553
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm), N))); \
321
553
    return MCDisassembler_Success; \
322
553
  }
RISCVDisassembler.c:decodeSImmOperand_12
Line
Count
Source
317
4.59k
  { \
318
4.59k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
319
4.59k
\
320
4.59k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm), N))); \
321
4.59k
    return MCDisassembler_Success; \
322
4.59k
  }
RISCVDisassembler.c:decodeSImmOperand_5
Line
Count
Source
317
1.03k
  { \
318
1.03k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
319
1.03k
\
320
1.03k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm), N))); \
321
1.03k
    return MCDisassembler_Success; \
322
1.03k
  }
323
DEFINE_decodeSImmOperand(6);
324
DEFINE_decodeSImmOperand(12);
325
DEFINE_decodeSImmOperand(5);
326
DEFINE_decodeSImmOperand(10);
327
328
#define DEFINE_decodeSImmNonZeroOperand(N) \
329
  static DecodeStatus CONCAT(decodeSImmNonZeroOperand, \
330
           N)(MCInst * Inst, uint32_t Imm, \
331
              int64_t Address, const void *Decoder) \
332
6.45k
  { \
333
6.45k
    if (Imm == 0) \
334
6.45k
      return MCDisassembler_Fail; \
335
6.45k
    return CONCAT(decodeSImmOperand, N)(Inst, Imm, Address, \
336
6.45k
                Decoder); \
337
6.45k
  }
RISCVDisassembler.c:decodeSImmNonZeroOperand_6
Line
Count
Source
332
5.89k
  { \
333
5.89k
    if (Imm == 0) \
334
5.89k
      return MCDisassembler_Fail; \
335
5.89k
    return CONCAT(decodeSImmOperand, N)(Inst, Imm, Address, \
336
5.89k
                Decoder); \
337
5.89k
  }
RISCVDisassembler.c:decodeSImmNonZeroOperand_10
Line
Count
Source
332
554
  { \
333
554
    if (Imm == 0) \
334
554
      return MCDisassembler_Fail; \
335
554
    return CONCAT(decodeSImmOperand, N)(Inst, Imm, Address, \
336
553
                Decoder); \
337
554
  }
338
DEFINE_decodeSImmNonZeroOperand(6);
339
DEFINE_decodeSImmNonZeroOperand(10);
340
341
#define DEFINE_decodeSImmOperandAndLsl1(N) \
342
  static DecodeStatus CONCAT(decodeSImmOperandAndLsl1, \
343
           N)(MCInst * Inst, uint32_t Imm, \
344
              int64_t Address, const void *Decoder) \
345
6.85k
  { \
346
6.85k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
347
6.85k
\
348
6.85k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm << 1), N))); \
349
6.85k
    return MCDisassembler_Success; \
350
6.85k
  }
RISCVDisassembler.c:decodeSImmOperandAndLsl1_12
Line
Count
Source
345
2.28k
  { \
346
2.28k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
347
2.28k
\
348
2.28k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm << 1), N))); \
349
2.28k
    return MCDisassembler_Success; \
350
2.28k
  }
RISCVDisassembler.c:decodeSImmOperandAndLsl1_9
Line
Count
Source
345
3.52k
  { \
346
3.52k
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
347
3.52k
\
348
3.52k
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm << 1), N))); \
349
3.52k
    return MCDisassembler_Success; \
350
3.52k
  }
RISCVDisassembler.c:decodeSImmOperandAndLsl1_13
Line
Count
Source
345
632
  { \
346
632
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
347
632
\
348
632
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm << 1), N))); \
349
632
    return MCDisassembler_Success; \
350
632
  }
RISCVDisassembler.c:decodeSImmOperandAndLsl1_21
Line
Count
Source
345
408
  { \
346
408
    CS_ASSERT(isUIntN(N, Imm) && "Invalid immediate"); \
347
408
\
348
408
    MCOperand_CreateImm0(Inst, (SignExtend64((Imm << 1), N))); \
349
408
    return MCDisassembler_Success; \
350
408
  }
351
DEFINE_decodeSImmOperandAndLsl1(12);
352
DEFINE_decodeSImmOperandAndLsl1(9);
353
DEFINE_decodeSImmOperandAndLsl1(13);
354
DEFINE_decodeSImmOperandAndLsl1(21);
355
356
static DecodeStatus decodeCLUIImmOperand(MCInst *Inst, uint32_t Imm,
357
           int64_t Address, const void *Decoder)
358
2.91k
{
359
2.91k
  CS_ASSERT(isUIntN(6, Imm) && "Invalid immediate");
360
2.91k
  if (Imm > 31) {
361
1.28k
    Imm = (SignExtend64((Imm), 6) & 0xfffff);
362
1.28k
  }
363
2.91k
  MCOperand_CreateImm0(Inst, (Imm));
364
2.91k
  return MCDisassembler_Success;
365
2.91k
}
366
367
static DecodeStatus decodeFRMArg(MCInst *Inst, uint32_t Imm, int64_t Address,
368
         const void *Decoder)
369
3.46k
{
370
3.46k
  CS_ASSERT(isUIntN(3, Imm) && "Invalid immediate");
371
3.46k
  if (!RISCVFPRndMode_isValidRoundingMode(Imm))
372
13
    return MCDisassembler_Fail;
373
374
3.45k
  MCOperand_CreateImm0(Inst, (Imm));
375
3.45k
  return MCDisassembler_Success;
376
3.46k
}
377
378
static DecodeStatus decodeRVCInstrRdRs1ImmZero(MCInst *Inst, uint32_t Insn,
379
                 uint64_t Address,
380
                 const void *Decoder);
381
382
static DecodeStatus decodeRVCInstrRdSImm(MCInst *Inst, uint32_t Insn,
383
           uint64_t Address, const void *Decoder);
384
385
static DecodeStatus decodeRVCInstrRdRs1UImm(MCInst *Inst, uint32_t Insn,
386
              uint64_t Address,
387
              const void *Decoder);
388
389
static DecodeStatus decodeRVCInstrRdRs2(MCInst *Inst, uint32_t Insn,
390
          uint64_t Address, const void *Decoder);
391
392
static DecodeStatus decodeRVCInstrRdRs1Rs2(MCInst *Inst, uint32_t Insn,
393
             uint64_t Address,
394
             const void *Decoder);
395
396
static DecodeStatus decodeXTHeadMemPair(MCInst *Inst, uint32_t Insn,
397
          uint64_t Address, const void *Decoder);
398
399
static DecodeStatus decodeZcmpRlist(MCInst *Inst, unsigned Imm,
400
            uint64_t Address, const void *Decoder);
401
402
static DecodeStatus decodeRegReg(MCInst *Inst, uint32_t Insn, uint64_t Address,
403
         const void *Decoder);
404
405
static DecodeStatus decodeZcmpSpimm(MCInst *Inst, unsigned Imm,
406
            uint64_t Address, const void *Decoder);
407
408
static DecodeStatus decodeCSSPushPopchk(MCInst *Inst, uint32_t Insn,
409
          uint64_t Address, const void *Decoder);
410
411
static DecodeStatus decodeUImmLog2XLenOperand(MCInst *Inst, uint32_t Imm,
412
                int64_t Address,
413
                const void *Decoder)
414
3.97k
{
415
3.97k
  CS_ASSERT(isUIntN(6, Imm) && "Invalid immediate");
416
417
3.97k
  if (!RISCV_getFeatureBits(Inst->csh->mode, RISCV_Feature64Bit) &&
418
1.05k
      !isUIntN(5, Imm))
419
9
    return MCDisassembler_Fail;
420
421
3.96k
  MCOperand_CreateImm0(Inst, (Imm));
422
3.96k
  return MCDisassembler_Success;
423
3.97k
}
424
425
static DecodeStatus decodeUImmLog2XLenNonZeroOperand(MCInst *Inst, uint32_t Imm,
426
                 int64_t Address,
427
                 const void *Decoder)
428
3.85k
{
429
3.85k
  if (Imm == 0)
430
0
    return MCDisassembler_Fail;
431
3.85k
  return decodeUImmLog2XLenOperand(Inst, Imm, Address, Decoder);
432
3.85k
}
433
434
#include "RISCVGenDisassemblerTables.inc"
435
436
static DecodeStatus decodeRVCInstrRdRs1ImmZero(MCInst *Inst, uint32_t Insn,
437
                 uint64_t Address,
438
                 const void *Decoder)
439
689
{
440
689
  uint32_t Rd = fieldFromInstruction_4(Insn, 7, 5);
441
689
  DecodeStatus Result =
442
689
    DecodeGPRNoX0RegisterClass(Inst, Rd, Address, Decoder);
443
689
  (void)Result;
444
689
  CS_ASSERT(Result == MCDisassembler_Success && "Invalid register");
445
689
  MCInst_addOperand2(Inst, (MCInst_getOperand(Inst, (0))));
446
689
  MCOperand_CreateImm0(Inst, (0));
447
689
  return MCDisassembler_Success;
448
689
}
449
450
static DecodeStatus decodeCSSPushPopchk(MCInst *Inst, uint32_t Insn,
451
          uint64_t Address, const void *Decoder)
452
0
{
453
0
  uint32_t Rs1 = fieldFromInstruction_4(Insn, 7, 5);
454
0
  DecodeStatus Result =
455
0
    DecodeGPRX1X5RegisterClass(Inst, Rs1, Address, Decoder);
456
0
  (void)Result;
457
0
  CS_ASSERT(Result == MCDisassembler_Success && "Invalid register");
458
0
  return MCDisassembler_Success;
459
0
}
460
461
static DecodeStatus decodeRVCInstrRdSImm(MCInst *Inst, uint32_t Insn,
462
           uint64_t Address, const void *Decoder)
463
295
{
464
295
  MCOperand_CreateReg0(Inst, (RISCV_X0));
465
295
  uint32_t SImm6 = fieldFromInstruction_4(Insn, 12, 1) << 5 |
466
295
       fieldFromInstruction_4(Insn, 2, 5);
467
295
  DecodeStatus Result =
468
295
    CONCAT(decodeSImmOperand, 6)(Inst, SImm6, Address, Decoder);
469
295
  (void)Result;
470
295
  CS_ASSERT(Result == MCDisassembler_Success && "Invalid immediate");
471
295
  return MCDisassembler_Success;
472
295
}
473
474
static DecodeStatus decodeRVCInstrRdRs1UImm(MCInst *Inst, uint32_t Insn,
475
              uint64_t Address,
476
              const void *Decoder)
477
551
{
478
551
  MCOperand_CreateReg0(Inst, (RISCV_X0));
479
551
  MCInst_addOperand2(Inst, (MCInst_getOperand(Inst, (0))));
480
551
  uint32_t UImm6 = fieldFromInstruction_4(Insn, 12, 1) << 5 |
481
551
       fieldFromInstruction_4(Insn, 2, 5);
482
551
  DecodeStatus Result =
483
551
    CONCAT(decodeUImmOperand, 6)(Inst, UImm6, Address, Decoder);
484
551
  (void)Result;
485
551
  CS_ASSERT(Result == MCDisassembler_Success && "Invalid immediate");
486
551
  return MCDisassembler_Success;
487
551
}
488
489
static DecodeStatus decodeRVCInstrRdRs2(MCInst *Inst, uint32_t Insn,
490
          uint64_t Address, const void *Decoder)
491
102
{
492
102
  uint32_t Rd = fieldFromInstruction_4(Insn, 7, 5);
493
102
  uint32_t Rs2 = fieldFromInstruction_4(Insn, 2, 5);
494
102
  DecodeGPRRegisterClass(Inst, Rd, Address, Decoder);
495
102
  DecodeGPRRegisterClass(Inst, Rs2, Address, Decoder);
496
102
  return MCDisassembler_Success;
497
102
}
498
499
static DecodeStatus decodeRVCInstrRdRs1Rs2(MCInst *Inst, uint32_t Insn,
500
             uint64_t Address,
501
             const void *Decoder)
502
86
{
503
86
  uint32_t Rd = fieldFromInstruction_4(Insn, 7, 5);
504
86
  uint32_t Rs2 = fieldFromInstruction_4(Insn, 2, 5);
505
86
  DecodeGPRRegisterClass(Inst, Rd, Address, Decoder);
506
86
  MCInst_addOperand2(Inst, (MCInst_getOperand(Inst, (0))));
507
86
  DecodeGPRRegisterClass(Inst, Rs2, Address, Decoder);
508
86
  return MCDisassembler_Success;
509
86
}
510
511
static DecodeStatus decodeXTHeadMemPair(MCInst *Inst, uint32_t Insn,
512
          uint64_t Address, const void *Decoder)
513
0
{
514
0
  uint32_t Rd1 = fieldFromInstruction_4(Insn, 7, 5);
515
0
  uint32_t Rs1 = fieldFromInstruction_4(Insn, 15, 5);
516
0
  uint32_t Rd2 = fieldFromInstruction_4(Insn, 20, 5);
517
0
  uint32_t UImm2 = fieldFromInstruction_4(Insn, 25, 2);
518
0
  DecodeGPRRegisterClass(Inst, Rd1, Address, Decoder);
519
0
  DecodeGPRRegisterClass(Inst, Rd2, Address, Decoder);
520
0
  DecodeGPRRegisterClass(Inst, Rs1, Address, Decoder);
521
0
  DecodeStatus Result =
522
0
    CONCAT(decodeUImmOperand, 2)(Inst, UImm2, Address, Decoder);
523
0
  (void)Result;
524
0
  CS_ASSERT(Result == MCDisassembler_Success && "Invalid immediate");
525
526
  // Disassemble the final operand which is implicit.
527
0
  unsigned Opcode = MCInst_getOpcode(Inst);
528
0
  bool IsWordOp = (Opcode == RISCV_TH_LWD || Opcode == RISCV_TH_LWUD ||
529
0
       Opcode == RISCV_TH_SWD);
530
0
  if (IsWordOp)
531
0
    MCOperand_CreateImm0(Inst, (3));
532
0
  else
533
0
    MCOperand_CreateImm0(Inst, (4));
534
535
0
  return MCDisassembler_Success;
536
0
}
537
538
static DecodeStatus decodeZcmpRlist(MCInst *Inst, unsigned Imm,
539
            uint64_t Address, const void *Decoder)
540
0
{
541
0
  if (Imm <= 3)
542
0
    return MCDisassembler_Fail;
543
0
  MCOperand_CreateImm0(Inst, (Imm));
544
0
  return MCDisassembler_Success;
545
0
}
546
547
static DecodeStatus decodeRegReg(MCInst *Inst, uint32_t Insn, uint64_t Address,
548
         const void *Decoder)
549
198
{
550
198
  uint32_t Rs1 = fieldFromInstruction_4(Insn, 0, 5);
551
198
  uint32_t Rs2 = fieldFromInstruction_4(Insn, 5, 5);
552
198
  DecodeGPRRegisterClass(Inst, Rs1, Address, Decoder);
553
198
  DecodeGPRRegisterClass(Inst, Rs2, Address, Decoder);
554
198
  return MCDisassembler_Success;
555
198
}
556
557
static DecodeStatus decodeZcmpSpimm(MCInst *Inst, unsigned Imm,
558
            uint64_t Address, const void *Decoder)
559
0
{
560
0
  MCOperand_CreateImm0(Inst, (Imm));
561
0
  return MCDisassembler_Success;
562
0
}
563
564
// Add implied SP operand for C.*SP compressed instructions. The SP operand
565
// isn't explicitly encoded in the instruction.
566
void addSPOperands(MCInst *MI)
567
60.6k
{
568
60.6k
  const MCInstrDesc *MCID = MCInstrDesc_get(MCInst_getOpcode(MI),
569
60.6k
              RISCVDescs.Insts,
570
60.6k
              ARR_SIZE(RISCVDescs.Insts));
571
60.6k
  MCOperand SPReg;
572
60.6k
  SPReg.MachineOperandType = kRegister;
573
60.6k
  SPReg.Kind = kRegister;
574
60.6k
  SPReg.RegVal = RISCV_X2;
575
202k
  for (unsigned i = 0; i < MCID->NumOperands; i++)
576
141k
    if (MCID->OpInfo[i].RegClass == RISCV_SPRegClassID)
577
9.26k
      MCInst_insert0(MI, i, &SPReg);
578
60.6k
}
579
580
DecodeStatus RISCV_getInstruction(MCInst *MI, uint16_t *Size,
581
          const uint8_t *Bytes, size_t BytesLen,
582
          uint64_t Address, SStream *CS)
583
93.1k
{
584
  // TODO: This will need modification when supporting instruction set
585
  // extensions with instructions > 32-bits (up to 176 bits wide).
586
93.1k
  uint32_t Insn;
587
93.1k
  DecodeStatus Result;
588
589
93.1k
#define TRY_TO_DECODE_WITH_ADDITIONAL_OPERATION( \
590
93.1k
  width, FEATURE_CHECKS, DECODER_TABLE, DESC, ADDITIONAL_OPERATION) \
591
1.17M
  do { \
592
1.26M
    if (FEATURE_CHECKS) { \
593
305k
      Result = decodeInstruction_##width( \
594
305k
        DECODER_TABLE, MI, Insn, Address, NULL); \
595
305k
      if (Result != MCDisassembler_Fail) { \
596
91.8k
        ADDITIONAL_OPERATION; \
597
91.8k
        return Result; \
598
91.8k
      } \
599
305k
    } \
600
1.17M
  } while (false)
601
93.1k
#define TRY_TO_DECODE_AND_ADD_SP(width, FEATURE_CHECKS, DECODER_TABLE, DESC) \
602
120k
  TRY_TO_DECODE_WITH_ADDITIONAL_OPERATION( \
603
120k
    width, FEATURE_CHECKS, DECODER_TABLE, DESC, addSPOperands(MI))
604
93.1k
#define TRY_TO_DECODE(width, FEATURE_CHECKS, DECODER_TABLE, DESC) \
605
1.05M
  TRY_TO_DECODE_WITH_ADDITIONAL_OPERATION( \
606
1.05M
    width, FEATURE_CHECKS, DECODER_TABLE, DESC, (void)NULL)
607
93.1k
#define TRY_TO_DECODE_FEATURE(width, FEATURE, DECODER_TABLE, DESC) \
608
959k
  TRY_TO_DECODE(width, RISCV_getFeatureBits(MI->csh->mode, FEATURE), \
609
959k
          DECODER_TABLE, DESC)
610
611
  // It's a 32 bit instruction if bit 0 and 1 are 1.
612
93.1k
  if ((Bytes[0] & 0x3) == 0x3) {
613
31.8k
    if (BytesLen < 4) {
614
211
      *Size = 0;
615
211
      return MCDisassembler_Fail;
616
211
    }
617
31.6k
    *Size = 4;
618
619
31.6k
    Insn = readBytes32(MI, Bytes);
620
621
31.6k
    TRY_TO_DECODE(4,
622
31.6k
            RISCV_getFeatureBits(MI->csh->mode,
623
31.6k
               RISCV_FeatureStdExtZdinx) &&
624
31.6k
              !RISCV_getFeatureBits(MI->csh->mode,
625
31.6k
                  RISCV_Feature64Bit),
626
31.6k
            DecoderTableRV32Zdinx32,
627
31.6k
            "RV32Zdinx table (Double in Integer and rv32)");
628
31.6k
    TRY_TO_DECODE(4,
629
31.6k
            RISCV_getFeatureBits(MI->csh->mode,
630
31.6k
               RISCV_FeatureStdExtZacas) &&
631
31.6k
              !RISCV_getFeatureBits(MI->csh->mode,
632
31.6k
                  RISCV_Feature64Bit),
633
31.6k
            DecoderTableRV32Zacas32,
634
31.6k
            "RV32Zacas table (Compare-And-Swap and rv32)");
635
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureStdExtZfinx,
636
31.6k
              DecoderTableRVZfinx32,
637
31.6k
              "RVZfinx table (Float in Integer)");
638
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXVentanaCondOps,
639
31.6k
              DecoderTableXVentana32,
640
31.6k
              "Ventana custom opcode table");
641
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadBa,
642
31.6k
              DecoderTableXTHeadBa32,
643
31.6k
              "XTHeadBa custom opcode table");
644
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadBb,
645
31.6k
              DecoderTableXTHeadBb32,
646
31.6k
              "XTHeadBb custom opcode table");
647
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadBs,
648
31.6k
              DecoderTableXTHeadBs32,
649
31.6k
              "XTHeadBs custom opcode table");
650
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadCondMov,
651
31.6k
              DecoderTableXTHeadCondMov32,
652
31.6k
              "XTHeadCondMov custom opcode table");
653
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadCmo,
654
31.6k
              DecoderTableXTHeadCmo32,
655
31.6k
              "XTHeadCmo custom opcode table");
656
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadFMemIdx,
657
31.6k
              DecoderTableXTHeadFMemIdx32,
658
31.6k
              "XTHeadFMemIdx custom opcode table");
659
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadMac,
660
31.6k
              DecoderTableXTHeadMac32,
661
31.6k
              "XTHeadMac custom opcode table");
662
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadMemIdx,
663
31.6k
              DecoderTableXTHeadMemIdx32,
664
31.6k
              "XTHeadMemIdx custom opcode table");
665
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadMemPair,
666
31.6k
              DecoderTableXTHeadMemPair32,
667
31.6k
              "XTHeadMemPair custom opcode table");
668
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadSync,
669
31.6k
              DecoderTableXTHeadSync32,
670
31.6k
              "XTHeadSync custom opcode table");
671
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXTHeadVdot,
672
31.6k
              DecoderTableXTHeadVdot32,
673
31.6k
              "XTHeadVdot custom opcode table");
674
31.6k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXSfvcp,
675
31.6k
              DecoderTableXSfvcp32,
676
31.6k
              "SiFive VCIX custom opcode table");
677
31.6k
    TRY_TO_DECODE_FEATURE(
678
31.6k
      4, RISCV_FeatureVendorXSfvqmaccdod,
679
31.6k
      DecoderTableXSfvqmaccdod32,
680
31.6k
      "SiFive Matrix Multiplication (2x8 and 8x2) Instruction opcode table");
681
31.6k
    TRY_TO_DECODE_FEATURE(
682
31.6k
      4, RISCV_FeatureVendorXSfvqmaccqoq,
683
31.6k
      DecoderTableXSfvqmaccqoq32,
684
31.6k
      "SiFive Matrix Multiplication (4x8 and 8x4) Instruction opcode table");
685
31.6k
    TRY_TO_DECODE_FEATURE(
686
31.6k
      4, RISCV_FeatureVendorXSfvfwmaccqqq,
687
31.6k
      DecoderTableXSfvfwmaccqqq32,
688
31.6k
      "SiFive Matrix Multiplication Instruction opcode table");
689
31.6k
    TRY_TO_DECODE_FEATURE(
690
31.6k
      4, RISCV_FeatureVendorXSfvfnrclipxfqf,
691
31.6k
      DecoderTableXSfvfnrclipxfqf32,
692
31.6k
      "SiFive FP32-to-int8 Ranged Clip Instructions opcode table");
693
31.6k
    TRY_TO_DECODE_FEATURE(
694
31.1k
      4, RISCV_FeatureVendorXCVbitmanip,
695
31.1k
      DecoderTableXCVbitmanip32,
696
31.1k
      "CORE-V Bit Manipulation custom opcode table");
697
31.1k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXCVelw,
698
31.1k
              DecoderTableXCVelw32,
699
31.1k
              "CORE-V Event load custom opcode table");
700
31.1k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXCVmac,
701
30.5k
              DecoderTableXCVmac32,
702
30.5k
              "CORE-V MAC custom opcode table");
703
30.5k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXCVmem,
704
29.7k
              DecoderTableXCVmem32,
705
29.7k
              "CORE-V MEM custom opcode table");
706
29.7k
    TRY_TO_DECODE_FEATURE(4, RISCV_FeatureVendorXCValu,
707
29.4k
              DecoderTableXCValu32,
708
29.4k
              "CORE-V ALU custom opcode table");
709
29.4k
    TRY_TO_DECODE_FEATURE(
710
28.4k
      4, RISCV_FeatureVendorXCVsimd, DecoderTableXCVsimd32,
711
28.4k
      "CORE-V SIMD extensions custom opcode table");
712
28.4k
    TRY_TO_DECODE_FEATURE(
713
28.3k
      4, RISCV_FeatureVendorXCVbi, DecoderTableXCVbi32,
714
28.3k
      "CORE-V Immediate Branching custom opcode table");
715
28.3k
    TRY_TO_DECODE(4, true, DecoderTable32, "RISCV32 table");
716
717
398
    return MCDisassembler_Fail;
718
28.3k
  }
719
720
61.2k
  if (BytesLen < 2) {
721
266
    *Size = 0;
722
266
    return MCDisassembler_Fail;
723
266
  }
724
60.9k
  *Size = 2;
725
726
60.9k
  Insn = readBytes16(MI, Bytes);
727
60.9k
  TRY_TO_DECODE_AND_ADD_SP(
728
59.3k
    2, !RISCV_getFeatureBits(MI->csh->mode, RISCV_Feature64Bit),
729
59.3k
    DecoderTableRISCV32Only_16,
730
59.3k
    "RISCV32Only_16 table (16-bit Instruction)");
731
59.3k
  TRY_TO_DECODE_FEATURE(2, RISCV_FeatureStdExtZicfiss,
732
59.3k
            DecoderTableZicfiss16,
733
59.3k
            "RVZicfiss table (Shadow Stack)");
734
59.3k
  TRY_TO_DECODE_FEATURE(2, RISCV_FeatureStdExtZcmt, DecoderTableRVZcmt16,
735
59.3k
            "Zcmt table (16-bit Table Jump Instructions)");
736
59.3k
  TRY_TO_DECODE_FEATURE(
737
59.3k
    2, RISCV_FeatureStdExtZcmp, DecoderTableRVZcmp16,
738
59.3k
    "Zcmp table (16-bit Push/Pop & Double Move Instructions)");
739
59.3k
  TRY_TO_DECODE_AND_ADD_SP(2, true, DecoderTable16,
740
343
         "RISCV_C table (16-bit Instruction)");
741
742
343
  return MCDisassembler_Fail;
743
59.3k
}
744
745
bool RISCV_LLVM_getInstruction(csh handle, const uint8_t *Bytes, size_t ByteLen,
746
             MCInst *MI, uint16_t *Size, uint64_t Address,
747
             void *Info)
748
93.1k
{
749
93.1k
  RISCV_init_cs_detail(MI);
750
93.1k
  MI->MRI = (MCRegisterInfo *)Info;
751
93.1k
  DecodeStatus ret =
752
93.1k
    RISCV_getInstruction(MI, Size, Bytes, ByteLen, Address, NULL);
753
754
93.1k
  MCInst_handleWriteback(MI, RISCVDescs.Insts,
755
93.1k
             ARR_SIZE(RISCVDescs.Insts));
756
757
93.1k
  return ret != MCDisassembler_Fail;
758
93.1k
}