Coverage Report

Created: 2025-07-01 07:03

/src/capstonev5/arch/M68K/M68KInstPrinter.c
Line
Count
Source (jump to first uncovered line)
1
/* Capstone Disassembly Engine */
2
/* M68K Backend by Daniel Collin <daniel@collin.com> 2015-2016 */
3
4
#ifdef _MSC_VER
5
// Disable security warnings for strcat & sprintf
6
#ifndef _CRT_SECURE_NO_WARNINGS
7
#define _CRT_SECURE_NO_WARNINGS
8
#endif
9
10
//Banned API Usage : strcat / sprintf is a Banned API as listed in dontuse.h for
11
//security purposes.
12
#pragma warning(disable:28719)
13
#endif
14
15
#include <stdio.h>  // DEBUG
16
#include <stdlib.h>
17
#include <string.h>
18
19
#include "M68KInstPrinter.h"
20
21
#include "M68KDisassembler.h"
22
23
#include "../../cs_priv.h"
24
#include "../../utils.h"
25
26
#include "../../MCInst.h"
27
#include "../../MCInstrDesc.h"
28
#include "../../MCRegisterInfo.h"
29
30
#ifndef CAPSTONE_DIET
31
static const char s_spacing[] = " ";
32
33
static const char* const s_reg_names[] = {
34
  "invalid",
35
  "d0", "d1", "d2", "d3", "d4", "d5", "d6", "d7",
36
  "a0", "a1", "a2", "a3", "a4", "a5", "a6", "a7",
37
  "fp0", "fp1", "fp2", "fp3", "fp4", "fp5", "fp6", "fp7",
38
  "pc",
39
  "sr", "ccr", "sfc", "dfc", "usp", "vbr", "cacr",
40
  "caar", "msp", "isp", "tc", "itt0", "itt1", "dtt0",
41
  "dtt1", "mmusr", "urp", "srp",
42
43
  "fpcr", "fpsr", "fpiar",
44
};
45
46
static const char* const s_instruction_names[] = {
47
  "invalid",
48
  "abcd", "add", "adda", "addi", "addq", "addx", "and", "andi", "asl", "asr", "bhs", "blo", "bhi", "bls", "bcc", "bcs", "bne", "beq", "bvc",
49
  "bvs", "bpl", "bmi", "bge", "blt", "bgt", "ble", "bra", "bsr", "bchg", "bclr", "bset", "btst", "bfchg", "bfclr", "bfexts", "bfextu", "bfffo", "bfins",
50
  "bfset", "bftst", "bkpt", "callm", "cas", "cas2", "chk", "chk2", "clr", "cmp", "cmpa", "cmpi", "cmpm", "cmp2", "cinvl", "cinvp", "cinva", "cpushl", "cpushp",
51
  "cpusha", "dbt", "dbf", "dbhi", "dbls", "dbcc", "dbcs", "dbne", "dbeq", "dbvc", "dbvs", "dbpl", "dbmi", "dbge", "dblt", "dbgt", "dble", "dbra",
52
  "divs", "divsl", "divu", "divul", "eor", "eori", "exg", "ext", "extb", "fabs", "fsabs", "fdabs", "facos", "fadd", "fsadd", "fdadd", "fasin",
53
  "fatan", "fatanh", "fbf", "fbeq", "fbogt", "fboge", "fbolt", "fbole", "fbogl", "fbor", "fbun", "fbueq", "fbugt", "fbuge", "fbult", "fbule", "fbne", "fbt",
54
  "fbsf", "fbseq", "fbgt", "fbge", "fblt", "fble", "fbgl", "fbgle", "fbngle", "fbngl", "fbnle", "fbnlt", "fbnge", "fbngt", "fbsne", "fbst", "fcmp", "fcos",
55
  "fcosh", "fdbf", "fdbeq", "fdbogt", "fdboge", "fdbolt", "fdbole", "fdbogl", "fdbor", "fdbun", "fdbueq", "fdbugt", "fdbuge", "fdbult", "fdbule", "fdbne",
56
  "fdbt", "fdbsf", "fdbseq", "fdbgt", "fdbge", "fdblt", "fdble", "fdbgl", "fdbgle", "fdbngle", "fdbngl", "fdbnle", "fdbnlt", "fdbnge", "fdbngt", "fdbsne",
57
  "fdbst", "fdiv", "fsdiv", "fddiv", "fetox", "fetoxm1", "fgetexp", "fgetman", "fint", "fintrz", "flog10", "flog2", "flogn", "flognp1", "fmod", "fmove",
58
  "fsmove", "fdmove", "fmovecr", "fmovem", "fmul", "fsmul", "fdmul", "fneg", "fsneg", "fdneg", "fnop", "frem", "frestore", "fsave", "fscale", "fsgldiv",
59
  "fsglmul", "fsin", "fsincos", "fsinh", "fsqrt", "fssqrt", "fdsqrt", "fsf", "fseq", "fsogt", "fsoge", "fsolt", "fsole", "fsogl", "fsor", "fsun", "fsueq",
60
  "fsugt", "fsuge", "fsult", "fsule", "fsne", "fst", "fssf", "fsseq", "fsgt", "fsge", "fslt", "fsle", "fsgl", "fsgle", "fsngle",
61
  "fsngl", "fsnle", "fsnlt", "fsnge", "fsngt", "fssne", "fsst", "fsub", "fssub", "fdsub", "ftan", "ftanh", "ftentox", "ftrapf", "ftrapeq", "ftrapogt",
62
  "ftrapoge", "ftrapolt", "ftrapole", "ftrapogl", "ftrapor", "ftrapun", "ftrapueq", "ftrapugt", "ftrapuge", "ftrapult", "ftrapule", "ftrapne", "ftrapt",
63
  "ftrapsf", "ftrapseq", "ftrapgt", "ftrapge", "ftraplt", "ftraple", "ftrapgl", "ftrapgle", "ftrapngle", "ftrapngl", "ftrapnle", "ftrapnlt", "ftrapnge",
64
  "ftrapngt", "ftrapsne", "ftrapst", "ftst", "ftwotox", "halt", "illegal", "jmp", "jsr", "lea", "link", "lpstop", "lsl", "lsr", "move", "movea", "movec",
65
  "movem", "movep", "moveq", "moves", "move16", "muls", "mulu", "nbcd", "neg", "negx", "nop", "not", "or", "ori", "pack", "pea", "pflush", "pflusha",
66
  "pflushan", "pflushn", "ploadr", "ploadw", "plpar", "plpaw", "pmove", "pmovefd", "ptestr", "ptestw", "pulse", "rems", "remu", "reset", "rol", "ror",
67
  "roxl", "roxr", "rtd", "rte", "rtm", "rtr", "rts", "sbcd", "st", "sf", "shi", "sls", "scc", "shs", "scs", "slo", "sne", "seq", "svc", "svs", "spl", "smi",
68
  "sge", "slt", "sgt", "sle", "stop", "sub", "suba", "subi", "subq", "subx", "swap", "tas", "trap", "trapv", "trapt", "trapf", "traphi", "trapls",
69
  "trapcc", "traphs", "trapcs", "traplo", "trapne", "trapeq", "trapvc", "trapvs", "trappl", "trapmi", "trapge", "traplt", "trapgt", "traple", "tst", "unlk", "unpk",
70
};
71
#endif
72
73
74
#ifndef CAPSTONE_DIET
75
static const char* getRegName(m68k_reg reg)
76
52.3k
{
77
52.3k
  return s_reg_names[(int)reg];
78
52.3k
}
79
80
static void printRegbitsRange(char* buffer, uint32_t data, const char* prefix)
81
19.2k
{
82
19.2k
  unsigned int first = 0;
83
19.2k
  unsigned int run_length = 0;
84
19.2k
  int i;
85
86
154k
  for (i = 0; i < 8; ++i) {
87
134k
    if (data & (1 << i)) {
88
22.0k
      first = i;
89
22.0k
      run_length = 0;
90
91
41.0k
      while (i < 7 && (data & (1 << (i + 1)))) {
92
19.0k
        i++;
93
19.0k
        run_length++;
94
19.0k
      }
95
96
22.0k
      if (buffer[0] != 0)
97
15.5k
        strcat(buffer, "/");
98
99
22.0k
      sprintf(buffer + strlen(buffer), "%s%d", prefix, first);
100
22.0k
      if (run_length > 0)
101
10.3k
        sprintf(buffer + strlen(buffer), "-%s%d", prefix, first + run_length);
102
22.0k
    }
103
134k
  }
104
19.2k
}
105
106
static void registerBits(SStream* O, const cs_m68k_op* op)
107
6.85k
{
108
6.85k
  char buffer[128];
109
6.85k
  unsigned int data = op->register_bits;
110
111
6.85k
  buffer[0] = 0;
112
113
6.85k
  if (!data) {
114
440
    SStream_concat(O, "%s", "#$0");
115
440
    return;
116
440
  }
117
118
6.41k
  printRegbitsRange(buffer, data & 0xff, "d");
119
6.41k
  printRegbitsRange(buffer, (data >> 8) & 0xff, "a");
120
6.41k
  printRegbitsRange(buffer, (data >> 16) & 0xff, "fp");
121
122
6.41k
  SStream_concat(O, "%s", buffer);
123
6.41k
}
124
125
static void registerPair(SStream* O, const cs_m68k_op* op)
126
1.66k
{
127
1.66k
  SStream_concat(O, "%s:%s", s_reg_names[op->reg_pair.reg_0],
128
1.66k
      s_reg_names[op->reg_pair.reg_1]);
129
1.66k
}
130
131
static void printAddressingMode(SStream* O, unsigned int pc, const cs_m68k* inst, const cs_m68k_op* op)
132
639k
{
133
639k
  switch (op->address_mode) {
134
45.6k
    case M68K_AM_NONE:
135
45.6k
      switch (op->type) {
136
6.85k
        case M68K_OP_REG_BITS:
137
6.85k
          registerBits(O, op);
138
6.85k
          break;
139
1.66k
        case M68K_OP_REG_PAIR:
140
1.66k
          registerPair(O, op);
141
1.66k
          break;
142
36.6k
        case M68K_OP_REG:
143
36.6k
          SStream_concat(O, "%s", s_reg_names[op->reg]);
144
36.6k
          break;
145
461
        default:
146
461
          break;
147
45.6k
      }
148
45.6k
      break;
149
150
217k
    case M68K_AM_REG_DIRECT_DATA: SStream_concat(O, "d%d", (op->reg - M68K_REG_D0)); break;
151
33.2k
    case M68K_AM_REG_DIRECT_ADDR: SStream_concat(O, "a%d", (op->reg - M68K_REG_A0)); break;
152
36.1k
    case M68K_AM_REGI_ADDR: SStream_concat(O, "(a%d)", (op->reg - M68K_REG_A0)); break;
153
35.6k
    case M68K_AM_REGI_ADDR_POST_INC: SStream_concat(O, "(a%d)+", (op->reg - M68K_REG_A0)); break;
154
64.3k
    case M68K_AM_REGI_ADDR_PRE_DEC: SStream_concat(O, "-(a%d)", (op->reg - M68K_REG_A0)); break;
155
25.2k
    case M68K_AM_REGI_ADDR_DISP: SStream_concat(O, "%s$%x(a%d)", op->mem.disp < 0 ? "-" : "", abs(op->mem.disp), (op->mem.base_reg - M68K_REG_A0)); break;
156
3.78k
    case M68K_AM_PCI_DISP: SStream_concat(O, "$%x(pc)", pc + 2 + op->mem.disp); break;
157
4.29k
    case M68K_AM_ABSOLUTE_DATA_SHORT: SStream_concat(O, "$%x.w", op->imm); break;
158
2.98k
    case M68K_AM_ABSOLUTE_DATA_LONG: SStream_concat(O, "$%x.l", op->imm); break;
159
100k
    case M68K_AM_IMMEDIATE:
160
100k
       if (inst->op_size.type == M68K_SIZE_TYPE_FPU) {
161
#if defined(_KERNEL_MODE)
162
         // Issue #681: Windows kernel does not support formatting float point
163
         SStream_concat(O, "#<float_point_unsupported>");
164
         break;
165
#else
166
282
         if (inst->op_size.fpu_size == M68K_FPU_SIZE_SINGLE)
167
125
           SStream_concat(O, "#%f", op->simm);
168
157
         else if (inst->op_size.fpu_size == M68K_FPU_SIZE_DOUBLE)
169
157
           SStream_concat(O, "#%f", op->dimm);
170
0
         else
171
0
           SStream_concat(O, "#<unsupported>");
172
282
         break;
173
282
#endif
174
282
       }
175
100k
       SStream_concat(O, "#$%x", op->imm);
176
100k
       break;
177
1.97k
    case M68K_AM_PCI_INDEX_8_BIT_DISP:
178
1.97k
      SStream_concat(O, "$%x(pc,%s%s.%c)", pc + 2 + op->mem.disp, s_spacing, getRegName(op->mem.index_reg), op->mem.index_size ? 'l' : 'w');
179
1.97k
      break;
180
16.0k
    case M68K_AM_AREGI_INDEX_8_BIT_DISP:
181
16.0k
      SStream_concat(O, "%s$%x(%s,%s%s.%c)", op->mem.disp < 0 ? "-" : "", abs(op->mem.disp), getRegName(op->mem.base_reg), s_spacing, getRegName(op->mem.index_reg), op->mem.index_size ? 'l' : 'w');
182
16.0k
      break;
183
383
    case M68K_AM_PCI_INDEX_BASE_DISP:
184
5.47k
    case M68K_AM_AREGI_INDEX_BASE_DISP:
185
186
5.47k
      if (op->address_mode == M68K_AM_PCI_INDEX_BASE_DISP) {
187
383
        SStream_concat(O, "$%x", pc + 2 + op->mem.in_disp);
188
5.09k
      } else {
189
5.09k
        if (op->mem.in_disp > 0)
190
1.82k
          SStream_concat(O, "$%x", op->mem.in_disp);
191
5.09k
      }
192
193
5.47k
      SStream_concat0(O, "(");
194
195
5.47k
      if (op->address_mode == M68K_AM_PCI_INDEX_BASE_DISP) {
196
383
          SStream_concat(O, "pc,%s.%c", getRegName(op->mem.index_reg), op->mem.index_size ? 'l' : 'w');
197
5.09k
      } else {
198
5.09k
        if (op->mem.base_reg != M68K_REG_INVALID)
199
3.76k
          SStream_concat(O, "a%d,%s", op->mem.base_reg - M68K_REG_A0, s_spacing);
200
5.09k
        SStream_concat(O, "%s.%c", getRegName(op->mem.index_reg), op->mem.index_size ? 'l' : 'w');
201
5.09k
      }
202
203
5.47k
      if (op->mem.scale > 0)
204
2.68k
          SStream_concat(O, "%s*%s%d)", s_spacing, s_spacing, op->mem.scale);
205
2.79k
      else
206
2.79k
          SStream_concat0(O, ")");
207
5.47k
      break;
208
      // It's ok to just use PCMI here as is as we set base_reg to PC in the disassembler. While this is not strictly correct it makes the code
209
      // easier and that is what actually happens when the code is executed anyway.
210
211
384
    case M68K_AM_PC_MEMI_POST_INDEX:
212
1.56k
    case M68K_AM_PC_MEMI_PRE_INDEX:
213
5.41k
    case M68K_AM_MEMI_PRE_INDEX:
214
10.1k
    case M68K_AM_MEMI_POST_INDEX:
215
10.1k
      SStream_concat0(O, "([");
216
217
10.1k
      if (op->address_mode == M68K_AM_PC_MEMI_POST_INDEX || op->address_mode == M68K_AM_PC_MEMI_PRE_INDEX) {
218
1.56k
        SStream_concat(O, "$%x", pc + 2 + op->mem.in_disp);
219
8.53k
      } else {
220
8.53k
        if (op->mem.in_disp > 0)
221
5.36k
          SStream_concat(O, "$%x", op->mem.in_disp);
222
8.53k
      }
223
224
10.1k
      if (op->mem.base_reg != M68K_REG_INVALID) {
225
6.10k
        if (op->mem.in_disp > 0)
226
3.77k
          SStream_concat(O, ",%s%s", s_spacing, getRegName(op->mem.base_reg));
227
2.33k
        else
228
2.33k
          SStream_concat(O, "%s", getRegName(op->mem.base_reg));
229
6.10k
      }
230
231
10.1k
      if (op->address_mode == M68K_AM_MEMI_POST_INDEX || op->address_mode == M68K_AM_PC_MEMI_POST_INDEX)
232
5.07k
          SStream_concat0(O, "]");
233
234
10.1k
      if (op->mem.index_reg != M68K_REG_INVALID)
235
6.64k
          SStream_concat(O, ",%s%s.%c", s_spacing, getRegName(op->mem.index_reg), op->mem.index_size ? 'l' : 'w');
236
237
10.1k
      if (op->mem.scale > 0)
238
4.82k
          SStream_concat(O, "%s*%s%d", s_spacing, s_spacing, op->mem.scale);
239
240
10.1k
      if (op->address_mode == M68K_AM_MEMI_PRE_INDEX || op->address_mode == M68K_AM_PC_MEMI_PRE_INDEX)
241
5.03k
          SStream_concat0(O, "]");
242
243
10.1k
      if (op->mem.out_disp > 0)
244
3.91k
          SStream_concat(O, ",%s$%x", s_spacing, op->mem.out_disp);
245
246
10.1k
      SStream_concat0(O, ")");
247
10.1k
      break;
248
36.4k
    case M68K_AM_BRANCH_DISPLACEMENT:
249
36.4k
      SStream_concat(O, "$%x", pc + 2 + op->br_disp.disp);
250
36.4k
    default:
251
36.4k
      break;
252
639k
  }
253
254
639k
  if (op->mem.bitfield)
255
2.89k
    SStream_concat(O, "{%d:%d}", op->mem.offset, op->mem.width);
256
639k
}
257
#endif
258
259
#define m68k_sizeof_array(array) (int)(sizeof(array)/sizeof(array[0]))
260
1.24M
#define m68k_min(a, b) (a < b) ? a : b
261
262
void M68K_printInst(MCInst* MI, SStream* O, void* PrinterInfo)
263
413k
{
264
413k
#ifndef CAPSTONE_DIET
265
413k
  m68k_info *info = (m68k_info *)PrinterInfo;
266
413k
  cs_m68k *ext = &info->extension;
267
413k
  cs_detail *detail = NULL;
268
413k
  int i = 0;
269
270
413k
  detail = MI->flat_insn->detail;
271
413k
  if (detail) {
272
413k
    int regs_read_count = m68k_min(m68k_sizeof_array(detail->regs_read), info->regs_read_count);
273
413k
    int regs_write_count = m68k_min(m68k_sizeof_array(detail->regs_write), info->regs_write_count);
274
413k
    int groups_count = m68k_min(m68k_sizeof_array(detail->groups), info->groups_count);
275
276
413k
    memcpy(&detail->m68k, ext, sizeof(cs_m68k));
277
278
413k
    memcpy(&detail->regs_read, &info->regs_read, regs_read_count * sizeof(uint16_t));
279
413k
    detail->regs_read_count = regs_read_count;
280
281
413k
    memcpy(&detail->regs_write, &info->regs_write, regs_write_count * sizeof(uint16_t));
282
413k
    detail->regs_write_count = regs_write_count;
283
284
413k
    memcpy(&detail->groups, &info->groups, groups_count);
285
413k
    detail->groups_count = groups_count;
286
413k
  }
287
288
413k
  if (MI->Opcode == M68K_INS_INVALID) {
289
55.1k
    if (ext->op_count)
290
55.1k
      SStream_concat(O, "dc.w $%x", ext->operands[0].imm);
291
0
    else
292
0
      SStream_concat(O, "dc.w $<unknown>");
293
55.1k
    return;
294
55.1k
  }
295
296
358k
  SStream_concat0(O, (char*)s_instruction_names[MI->Opcode]);
297
298
358k
  switch (ext->op_size.type) {
299
0
    case M68K_SIZE_TYPE_INVALID :
300
0
      break;
301
302
355k
    case M68K_SIZE_TYPE_CPU :
303
355k
      switch (ext->op_size.cpu_size) {
304
111k
        case M68K_CPU_SIZE_BYTE: SStream_concat0(O, ".b"); break;
305
102k
        case M68K_CPU_SIZE_WORD: SStream_concat0(O, ".w"); break;
306
93.3k
        case M68K_CPU_SIZE_LONG: SStream_concat0(O, ".l"); break;
307
47.8k
        case M68K_CPU_SIZE_NONE: break;
308
355k
      }
309
355k
      break;
310
311
355k
    case M68K_SIZE_TYPE_FPU :
312
3.05k
      switch (ext->op_size.fpu_size) {
313
732
        case M68K_FPU_SIZE_SINGLE: SStream_concat0(O, ".s"); break;
314
1.37k
        case M68K_FPU_SIZE_DOUBLE: SStream_concat0(O, ".d"); break;
315
952
        case M68K_FPU_SIZE_EXTENDED: SStream_concat0(O, ".x"); break;
316
0
        case M68K_FPU_SIZE_NONE: break;
317
3.05k
      }
318
3.05k
      break;
319
358k
  }
320
321
358k
  SStream_concat0(O, " ");
322
323
  // this one is a bit spacial so we do special things
324
325
358k
  if (MI->Opcode == M68K_INS_CAS2) {
326
488
    int reg_value_0, reg_value_1;
327
488
    printAddressingMode(O, info->pc, ext, &ext->operands[0]); SStream_concat0(O, ",");
328
488
    printAddressingMode(O, info->pc, ext, &ext->operands[1]); SStream_concat0(O, ",");
329
488
    reg_value_0 = ext->operands[2].register_bits >> 4;
330
488
    reg_value_1 = ext->operands[2].register_bits & 0xf;
331
488
    SStream_concat(O, "(%s):(%s)", s_reg_names[M68K_REG_D0 + reg_value_0], s_reg_names[M68K_REG_D0 + reg_value_1]);
332
488
    return;
333
488
  }
334
335
996k
  for (i  = 0; i < ext->op_count; ++i) {
336
638k
    printAddressingMode(O, info->pc, ext, &ext->operands[i]);
337
638k
    if ((i + 1) != ext->op_count)
338
282k
      SStream_concat(O, ",%s", s_spacing);
339
638k
  }
340
357k
#endif
341
357k
}
342
343
const char* M68K_reg_name(csh handle, unsigned int reg)
344
516k
{
345
#ifdef CAPSTONE_DIET
346
  return NULL;
347
#else
348
516k
  if (reg >= ARR_SIZE(s_reg_names)) {
349
0
    return NULL;
350
0
  }
351
516k
  return s_reg_names[(int)reg];
352
516k
#endif
353
516k
}
354
355
void M68K_get_insn_id(cs_struct* h, cs_insn* insn, unsigned int id)
356
413k
{
357
413k
  insn->id = id; // These id's matches for 68k
358
413k
}
359
360
const char* M68K_insn_name(csh handle, unsigned int id)
361
413k
{
362
#ifdef CAPSTONE_DIET
363
  return NULL;
364
#else
365
413k
  return s_instruction_names[id];
366
413k
#endif
367
413k
}
368
369
#ifndef CAPSTONE_DIET
370
static const name_map group_name_maps[] = {
371
  { M68K_GRP_INVALID , NULL },
372
  { M68K_GRP_JUMP, "jump" },
373
  { M68K_GRP_RET , "ret" },
374
  { M68K_GRP_IRET, "iret" },
375
  { M68K_GRP_BRANCH_RELATIVE, "branch_relative" },
376
};
377
#endif
378
379
const char *M68K_group_name(csh handle, unsigned int id)
380
81.7k
{
381
81.7k
#ifndef CAPSTONE_DIET
382
81.7k
  return id2name(group_name_maps, ARR_SIZE(group_name_maps), id);
383
#else
384
  return NULL;
385
#endif
386
81.7k
}
387