Coverage Report

Created: 2026-03-03 06:14

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/capstonenext/SStream.c
Line
Count
Source
1
/* Capstone Disassembly Engine */
2
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */
3
4
#include <stdarg.h>
5
#if defined(CAPSTONE_HAS_OSXKERNEL)
6
#include <Availability.h>
7
#include <libkern/libkern.h>
8
#include <i386/limits.h>
9
#else
10
#include <stdio.h>
11
#include <limits.h>
12
#endif
13
#include <string.h>
14
15
#include <capstone/platform.h>
16
17
#include "SStream.h"
18
#include "cs_priv.h"
19
#include "utils.h"
20
21
void SStream_Init(SStream *ss)
22
1.50M
{
23
1.50M
  assert(ss);
24
1.50M
  ss->index = 0;
25
1.50M
  memset(ss->buffer, 0, sizeof(ss->buffer));
26
1.50M
  ss->is_closed = false;
27
1.50M
  ss->markup_stream = false;
28
1.50M
  ss->prefixed_by_markup = false;
29
1.50M
  ss->unsigned_num = false;
30
1.50M
}
31
32
void SStream_opt_unum(SStream *ss, bool print_unsigned_numbers)
33
1.47M
{
34
1.47M
  assert(ss);
35
1.47M
  ss->unsigned_num = print_unsigned_numbers;
36
1.47M
}
37
38
/// Returns the a pointer to the internal string buffer of the stream.
39
/// For reading only.
40
const char *SStream_rbuf(const SStream *ss)
41
46.0k
{
42
46.0k
  assert(ss);
43
46.0k
  return ss->buffer;
44
46.0k
}
45
46
/// Searches in the stream for the first (from the left) occurrence of @elem and replaces
47
/// it with @repl. It returns the pointer *after* the replaced character
48
/// or NULL if no character was replaced.
49
///
50
/// It will never replace the final \0 byte in the stream buffer.
51
const char *SStream_replc(const SStream *ss, char elem, char repl)
52
46.4k
{
53
46.4k
  assert(ss);
54
46.4k
  char *found = strchr(ss->buffer, elem);
55
46.4k
  if (!found || found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
56
46.4k
    return NULL;
57
46.4k
  }
58
0
  *found = repl;
59
0
  found++;
60
0
  return found;
61
46.4k
}
62
63
/// Searches in the stream for the first (from the left) occurrence of @chr and replaces
64
/// it with @rstr.
65
void SStream_replc_str(SStream *ss, char chr, const char *rstr)
66
11.4k
{
67
11.4k
  assert(ss && rstr);
68
11.4k
  char *found = strchr(ss->buffer, chr);
69
11.4k
  if (!found || found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
70
0
    return;
71
0
  }
72
11.4k
  size_t post_len = strlen(found + 1);
73
11.4k
  size_t buf_str_len = strlen(ss->buffer);
74
11.4k
  size_t repl_len = strlen(rstr);
75
11.4k
  if (repl_len - 1 + buf_str_len >= SSTREAM_BUF_LEN) {
76
0
    return;
77
0
  }
78
11.4k
  memmove(found + repl_len, found + 1, post_len);
79
11.4k
  memcpy(found, rstr, repl_len);
80
11.4k
  ss->index = strlen(ss->buffer);
81
11.4k
}
82
83
/// Removes the space characters '\t' and ' ' from the beginning of the stream buffer.
84
void SStream_trimls(SStream *ss)
85
1.52M
{
86
1.52M
  assert(ss);
87
1.52M
  size_t buf_off = 0;
88
  /// Remove leading spaces
89
1.54M
  while (ss->buffer[buf_off] == ' ' || ss->buffer[buf_off] == '\t') {
90
27.3k
    buf_off++;
91
27.3k
  }
92
1.52M
  if (buf_off > 0) {
93
27.3k
    memmove(ss->buffer, ss->buffer + buf_off,
94
27.3k
      SSTREAM_BUF_LEN - buf_off);
95
27.3k
    ss->index -= buf_off;
96
27.3k
  }
97
1.52M
}
98
99
/// Extract the mnemonic to @mnem_buf and the operand string into @op_str_buf from the stream buffer.
100
/// The mnemonic is everything up until the first ' ' or '\t' character.
101
/// The operand string is everything after the first ' ' or '\t' sequence.
102
void SStream_extract_mnem_opstr(const SStream *ss, char *mnem_buf,
103
        size_t mnem_buf_size, char *op_str_buf,
104
        size_t op_str_buf_size)
105
1.47M
{
106
1.47M
  assert(ss && mnem_buf && mnem_buf_size > 0 && op_str_buf &&
107
1.47M
         op_str_buf_size > 0);
108
1.47M
  size_t off = 0;
109
  // Copy all non space chars to as mnemonic.
110
8.15M
  while (ss->buffer[off] && ss->buffer[off] != ' ' &&
111
7.77M
         ss->buffer[off] != '\t') {
112
6.67M
    if (off < mnem_buf_size - 1) {
113
      // Only copy if there is space left.
114
6.67M
      mnem_buf[off] = ss->buffer[off];
115
6.67M
    }
116
6.67M
    off++;
117
6.67M
  }
118
1.47M
  if (!ss->buffer[off]) {
119
71.3k
    return;
120
71.3k
  }
121
122
  // Iterate until next non space char.
123
1.40M
  do {
124
1.40M
    off++;
125
1.40M
  } while (ss->buffer[off] &&
126
1.37M
     (ss->buffer[off] == ' ' || ss->buffer[off] == '\t'));
127
128
1.40M
  if (!ss->buffer[off]) {
129
35.2k
    return;
130
35.2k
  }
131
132
  // Copy all follow up characters as op_str
133
1.36M
  const char *ss_op_str = ss->buffer + off;
134
1.36M
  off = 0;
135
19.9M
  while (ss_op_str[off] && off < op_str_buf_size - 1) {
136
18.5M
    op_str_buf[off] = ss_op_str[off];
137
18.5M
    off++;
138
18.5M
  }
139
1.36M
}
140
141
/// Empty the stream @ss to given @file (stdin/stderr).
142
/// @file can be NULL. Then the buffer content is not emitted.
143
void SStream_Flush(SStream *ss, FILE *file)
144
11.5k
{
145
11.5k
  assert(ss);
146
11.5k
  if (file) {
147
0
    fprintf(file, "%s\n", ss->buffer);
148
0
  }
149
11.5k
  SStream_Init(ss);
150
11.5k
}
151
152
/**
153
 * Open the output stream. Every write attempt is accepted again.
154
 */
155
void SStream_Open(SStream *ss)
156
0
{
157
0
  assert(ss);
158
0
  ss->is_closed = false;
159
0
}
160
161
/**
162
 * Closes the output stream. Every write attempt is ignored.
163
 */
164
void SStream_Close(SStream *ss)
165
0
{
166
0
  assert(ss);
167
0
  ss->is_closed = true;
168
0
}
169
170
/**
171
 * Copy the string \p s to the buffer of \p ss and terminate it with a '\\0' byte.
172
 */
173
void SStream_concat0(SStream *ss, const char *s)
174
8.78M
{
175
8.78M
#ifndef CAPSTONE_DIET
176
8.78M
  assert(ss && s);
177
8.78M
  SSTREAM_RETURN_IF_CLOSED(ss);
178
8.78M
  if (s[0] == '\0')
179
2.74M
    return;
180
6.04M
  unsigned int len = (unsigned int)strlen(s);
181
182
6.04M
  SSTREAM_OVERFLOW_CHECK(ss, len);
183
184
6.04M
  memcpy(ss->buffer + ss->index, s, len);
185
6.04M
  ss->index += len;
186
6.04M
  ss->buffer[ss->index] = '\0';
187
6.04M
  if (ss->markup_stream && ss->prefixed_by_markup) {
188
0
    SSTREAM_OVERFLOW_CHECK(ss, 1);
189
0
    ss->buffer[ss->index] = '>';
190
0
    ss->index += 1;
191
0
    ss->buffer[ss->index] = '\0';
192
0
  }
193
#else
194
  ss->buffer[ss->index] = '\0';
195
#endif
196
6.04M
}
197
198
/**
199
 * Copy the single char \p c to the buffer of \p ss.
200
 */
201
void SStream_concat1(SStream *ss, const char c)
202
1.04M
{
203
1.04M
#ifndef CAPSTONE_DIET
204
1.04M
  assert(ss);
205
1.04M
  SSTREAM_RETURN_IF_CLOSED(ss);
206
1.04M
  if (c == '\0')
207
13.3k
    return;
208
209
1.02M
  SSTREAM_OVERFLOW_CHECK(ss, 1);
210
211
1.02M
  ss->buffer[ss->index] = c;
212
1.02M
  ss->index++;
213
1.02M
  ss->buffer[ss->index] = '\0';
214
1.02M
  if (ss->markup_stream && ss->prefixed_by_markup) {
215
0
    SSTREAM_OVERFLOW_CHECK(ss, 1);
216
0
    ss->buffer[ss->index] = '>';
217
0
    ss->index++;
218
0
  }
219
#else
220
  ss->buffer[ss->index] = '\0';
221
#endif
222
1.02M
}
223
224
/**
225
 * Copy all strings given to the buffer of \p ss according to formatting \p fmt.
226
 */
227
void SStream_concat(SStream *ss, const char *fmt, ...)
228
3.78M
{
229
3.78M
#ifndef CAPSTONE_DIET
230
3.78M
  assert(ss && fmt);
231
3.78M
  SSTREAM_RETURN_IF_CLOSED(ss);
232
3.78M
  va_list ap;
233
3.78M
  int ret;
234
235
3.78M
  va_start(ap, fmt);
236
3.78M
  ret = cs_vsnprintf(ss->buffer + ss->index,
237
3.78M
         sizeof(ss->buffer) - (ss->index + 1), fmt, ap);
238
3.78M
  va_end(ap);
239
3.78M
  if (ret < 0) {
240
0
    return;
241
0
  }
242
3.78M
  SSTREAM_OVERFLOW_CHECK(ss, ret);
243
3.78M
  ss->index += ret;
244
3.78M
  if (ss->markup_stream && ss->prefixed_by_markup) {
245
0
    SSTREAM_OVERFLOW_CHECK(ss, 1);
246
0
    ss->buffer[ss->index] = '>';
247
0
    ss->index += 1;
248
0
  }
249
#else
250
  ss->buffer[ss->index] = '\0';
251
#endif
252
3.78M
}
253
254
// print number with prefix #
255
void printInt64Bang(SStream *ss, int64_t val)
256
45.3k
{
257
45.3k
  assert(ss);
258
45.3k
  if (ss->unsigned_num) {
259
0
    printUInt64Bang(ss, val);
260
0
    return;
261
0
  }
262
45.3k
  SSTREAM_RETURN_IF_CLOSED(ss);
263
45.3k
  SStream_concat1(ss, '#');
264
45.3k
  printInt64(ss, val);
265
45.3k
}
266
267
void printUInt64Bang(SStream *ss, uint64_t val)
268
4.20k
{
269
4.20k
  assert(ss);
270
4.20k
  SSTREAM_RETURN_IF_CLOSED(ss);
271
4.20k
  SStream_concat1(ss, '#');
272
4.20k
  printUInt64(ss, val);
273
4.20k
}
274
275
// print number
276
void printInt64(SStream *ss, int64_t val)
277
336k
{
278
336k
  assert(ss);
279
336k
  if (ss->unsigned_num) {
280
0
    printUInt64(ss, val);
281
0
    return;
282
0
  }
283
336k
  SSTREAM_RETURN_IF_CLOSED(ss);
284
336k
  if (val >= 0) {
285
308k
    if (val > HEX_THRESHOLD)
286
188k
      SStream_concat(ss, "0x%" PRIx64, val);
287
120k
    else
288
120k
      SStream_concat(ss, "%" PRIu64, val);
289
308k
  } else {
290
27.4k
    if (val < -HEX_THRESHOLD) {
291
24.2k
      if (val == INT64_MIN)
292
86
        SStream_concat(ss, "-0x%" PRIx64,
293
86
                 (uint64_t)INT64_MAX + 1);
294
24.1k
      else
295
24.1k
        SStream_concat(ss, "-0x%" PRIx64,
296
24.1k
                 (uint64_t)-val);
297
24.2k
    } else
298
3.16k
      SStream_concat(ss, "-%" PRIu64, -val);
299
27.4k
  }
300
336k
}
301
302
void printUInt64(SStream *ss, uint64_t val)
303
95.8k
{
304
95.8k
  assert(ss);
305
95.8k
  SSTREAM_RETURN_IF_CLOSED(ss);
306
95.8k
  if (val > HEX_THRESHOLD)
307
60.0k
    SStream_concat(ss, "0x%" PRIx64, val);
308
35.8k
  else
309
35.8k
    SStream_concat(ss, "%" PRIu64, val);
310
95.8k
}
311
312
// print number in decimal mode
313
void printInt32BangDec(SStream *ss, int32_t val)
314
0
{
315
0
  assert(ss);
316
0
  SSTREAM_RETURN_IF_CLOSED(ss);
317
0
  if (val >= 0)
318
0
    SStream_concat(ss, "#%" PRIu32, val);
319
0
  else {
320
0
    if (val == INT32_MIN)
321
0
      SStream_concat(ss, "#-%" PRIu32, val);
322
0
    else
323
0
      SStream_concat(ss, "#-%" PRIu32, (uint32_t)-val);
324
0
  }
325
0
}
326
327
void printInt32Bang(SStream *ss, int32_t val)
328
100k
{
329
100k
  assert(ss);
330
100k
  if (ss->unsigned_num) {
331
0
    printUInt32Bang(ss, val);
332
0
    return;
333
0
  }
334
100k
  SSTREAM_RETURN_IF_CLOSED(ss);
335
100k
  SStream_concat1(ss, '#');
336
100k
  printInt32(ss, val);
337
100k
}
338
339
void printUInt8(SStream *ss, uint8_t val)
340
0
{
341
0
  assert(ss);
342
0
  if (val > HEX_THRESHOLD)
343
0
    SStream_concat(ss, "0x%" PRIx8, val);
344
0
  else
345
0
    SStream_concat(ss, "%" PRIu8, val);
346
0
}
347
348
void printUInt16(SStream *ss, uint16_t val)
349
0
{
350
0
  assert(ss);
351
0
  if (val > HEX_THRESHOLD)
352
0
    SStream_concat(ss, "0x%" PRIx16, val);
353
0
  else
354
0
    SStream_concat(ss, "%" PRIu16, val);
355
0
}
356
357
void printInt8(SStream *ss, int8_t val)
358
1.05k
{
359
1.05k
  assert(ss);
360
1.05k
  if (ss->unsigned_num) {
361
0
    printUInt8(ss, val);
362
0
    return;
363
0
  }
364
1.05k
  SSTREAM_RETURN_IF_CLOSED(ss);
365
1.05k
  if (val >= 0) {
366
609
    if (val > HEX_THRESHOLD)
367
437
      SStream_concat(ss, "0x%" PRIx8, val);
368
172
    else
369
172
      SStream_concat(ss, "%" PRId8, val);
370
609
  } else {
371
446
    if (val < -HEX_THRESHOLD) {
372
223
      if (val == INT8_MIN)
373
124
        SStream_concat(ss, "-0x%" PRIx8,
374
124
                 (uint8_t)INT8_MAX + 1);
375
99
      else
376
99
        SStream_concat(ss, "-0x%" PRIx8, (int8_t)-val);
377
223
    } else
378
223
      SStream_concat(ss, "-%" PRIu8, -val);
379
446
  }
380
1.05k
}
381
382
void printInt16(SStream *ss, int16_t val)
383
1.08k
{
384
1.08k
  assert(ss);
385
1.08k
  if (ss->unsigned_num) {
386
0
    printUInt16(ss, val);
387
0
    return;
388
0
  }
389
1.08k
  SSTREAM_RETURN_IF_CLOSED(ss);
390
1.08k
  if (val >= 0) {
391
815
    if (val > HEX_THRESHOLD)
392
644
      SStream_concat(ss, "0x%" PRIx16, val);
393
171
    else
394
171
      SStream_concat(ss, "%" PRId16, val);
395
815
  } else {
396
265
    if (val < -HEX_THRESHOLD) {
397
221
      if (val == INT16_MIN)
398
60
        SStream_concat(ss, "-0x%" PRIx16,
399
60
                 (uint16_t)INT16_MAX + 1);
400
161
      else
401
161
        SStream_concat(ss, "-0x%" PRIx16,
402
161
                 (int16_t)-val);
403
221
    } else
404
44
      SStream_concat(ss, "-%" PRIu16, -val);
405
265
  }
406
1.08k
}
407
408
void printInt16HexOffset(SStream *ss, int16_t val)
409
2.12k
{
410
2.12k
  assert(ss);
411
2.12k
  if (ss->unsigned_num) {
412
0
    printUInt16(ss, val);
413
0
    return;
414
0
  }
415
2.12k
  SSTREAM_RETURN_IF_CLOSED(ss);
416
2.12k
  if (val >= 0) {
417
1.63k
    SStream_concat(ss, "+0x%" PRIx16, val);
418
1.63k
  } else {
419
495
    if (val == INT16_MIN)
420
2
      SStream_concat(ss, "-0x%" PRIx16,
421
2
               (uint16_t)INT16_MAX + 1);
422
493
    else
423
493
      SStream_concat(ss, "-0x%" PRIx16, (int16_t)-val);
424
495
  }
425
2.12k
}
426
427
void printInt32(SStream *ss, int32_t val)
428
131k
{
429
131k
  assert(ss);
430
131k
  if (ss->unsigned_num) {
431
0
    printUInt32(ss, val);
432
0
    return;
433
0
  }
434
131k
  SSTREAM_RETURN_IF_CLOSED(ss);
435
131k
  if (val >= 0) {
436
102k
    if (val > HEX_THRESHOLD)
437
55.7k
      SStream_concat(ss, "0x%" PRIx32, val);
438
46.4k
    else
439
46.4k
      SStream_concat(ss, "%" PRId32, val);
440
102k
  } else {
441
29.4k
    if (val < -HEX_THRESHOLD) {
442
28.2k
      if (val == INT32_MIN)
443
89
        SStream_concat(ss, "-0x%" PRIx32,
444
89
                 (uint32_t)INT32_MAX + 1);
445
28.1k
      else
446
28.1k
        SStream_concat(ss, "-0x%" PRIx32,
447
28.1k
                 (int32_t)-val);
448
28.2k
    } else {
449
1.22k
      SStream_concat(ss, "-%" PRIu32, (uint32_t)-val);
450
1.22k
    }
451
29.4k
  }
452
131k
}
453
454
void printInt32HexOffset(SStream *ss, int32_t val)
455
789
{
456
789
  assert(ss);
457
789
  if (ss->unsigned_num) {
458
0
    printUInt32(ss, val);
459
0
    return;
460
0
  }
461
789
  SSTREAM_RETURN_IF_CLOSED(ss);
462
789
  if (val >= 0) {
463
721
    SStream_concat(ss, "+0x%" PRIx32, val);
464
721
  } else {
465
68
    if (val == INT32_MIN)
466
0
      SStream_concat(ss, "-0x%" PRIx32,
467
0
               (uint32_t)INT32_MAX + 1);
468
68
    else
469
68
      SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
470
68
  }
471
789
}
472
473
void printInt32Hex(SStream *ss, int32_t val)
474
1.49k
{
475
1.49k
  assert(ss);
476
1.49k
  SSTREAM_RETURN_IF_CLOSED(ss);
477
1.49k
  if (val >= 0) {
478
998
    SStream_concat(ss, "0x%" PRIx32, val);
479
998
  } else {
480
492
    if (val == INT32_MIN)
481
1
      SStream_concat(ss, "-0x%" PRIx32,
482
1
               (uint32_t)INT32_MAX + 1);
483
491
    else
484
491
      SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
485
492
  }
486
1.49k
}
487
488
void printUInt32Bang(SStream *ss, uint32_t val)
489
96.2k
{
490
96.2k
  assert(ss);
491
96.2k
  SSTREAM_RETURN_IF_CLOSED(ss);
492
96.2k
  SStream_concat1(ss, '#');
493
96.2k
  printUInt32(ss, val);
494
96.2k
}
495
496
void printUInt32(SStream *ss, uint32_t val)
497
140k
{
498
140k
  assert(ss);
499
140k
  SSTREAM_RETURN_IF_CLOSED(ss);
500
140k
  if (val > HEX_THRESHOLD)
501
108k
    SStream_concat(ss, "0x%x", val);
502
32.1k
  else
503
32.1k
    SStream_concat(ss, "%u", val);
504
140k
}
505
506
void printFloat(SStream *ss, float val)
507
0
{
508
0
  assert(ss);
509
0
  SSTREAM_RETURN_IF_CLOSED(ss);
510
0
  SStream_concat(ss, "%e", val);
511
0
}
512
513
void printfFloat(SStream *ss, const char *fmt, float val)
514
2
{
515
2
  assert(ss);
516
2
  SSTREAM_RETURN_IF_CLOSED(ss);
517
2
  SStream_concat(ss, fmt, val);
518
2
}
519
520
void printFloatBang(SStream *ss, float val)
521
479
{
522
479
  assert(ss);
523
479
  SSTREAM_RETURN_IF_CLOSED(ss);
524
479
  SStream_concat(ss, "#%e", val);
525
479
}
526
527
void printExpr(SStream *ss, uint64_t val)
528
0
{
529
0
  assert(ss);
530
0
  SSTREAM_RETURN_IF_CLOSED(ss);
531
0
  SStream_concat(ss, "%" PRIu64, val);
532
0
}
533
534
SStream *markup_OS(SStream *OS, SStreamMarkup style)
535
315k
{
536
315k
  assert(OS);
537
538
315k
  if (OS->is_closed || !OS->markup_stream) {
539
315k
    return OS;
540
315k
  }
541
0
  OS->markup_stream = false; // Disable temporarily.
542
0
  switch (style) {
543
0
  default:
544
0
    SStream_concat0(OS, "<UNKNOWN:");
545
0
    return OS;
546
0
  case Markup_Immediate:
547
0
    SStream_concat0(OS, "<imm:");
548
0
    break;
549
0
  case Markup_Register:
550
0
    SStream_concat0(OS, "<reg:");
551
0
    break;
552
0
  case Markup_Target:
553
0
    SStream_concat0(OS, "<tar:");
554
0
    break;
555
0
  case Markup_Memory:
556
0
    SStream_concat0(OS, "<mem:");
557
0
    break;
558
0
  }
559
0
  OS->markup_stream = true;
560
  OS->prefixed_by_markup = true;
561
0
  return OS;
562
0
}