Coverage Report

Created: 2025-07-18 06:43

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