Coverage Report

Created: 2026-09-01 06:39

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/FreeRDP/winpr/libwinpr/utils/stream.c
Line
Count
Source
1
/*
2
 * WinPR: Windows Portable Runtime
3
 * Stream Utils
4
 *
5
 * Copyright 2011 Vic Lee
6
 * Copyright 2012 Marc-Andre Moreau <marcandre.moreau@gmail.com>
7
 *
8
 * Licensed under the Apache License, Version 2.0 (the "License");
9
 * you may not use this file except in compliance with the License.
10
 * You may obtain a copy of the License at
11
 *
12
 *     http://www.apache.org/licenses/LICENSE-2.0
13
 *
14
 * Unless required by applicable law or agreed to in writing, software
15
 * distributed under the License is distributed on an "AS IS" BASIS,
16
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17
 * See the License for the specific language governing permissions and
18
 * limitations under the License.
19
 */
20
21
#include <winpr/config.h>
22
23
#include <winpr/assert.h>
24
#include <winpr/crt.h>
25
#include <winpr/stream.h>
26
27
#include "stream.h"
28
#include "../log.h"
29
30
2.92M
#define STREAM_TAG WINPR_TAG("wStream")
31
32
#define STREAM_ASSERT(cond)                                                            \
33
454k
  do                                                                                 \
34
454k
  {                                                                                  \
35
454k
    if (!(cond))                                                                   \
36
454k
    {                                                                              \
37
0
      WLog_FATAL(STREAM_TAG, "%s [%s:%s:%" PRIuz "]", #cond, __FILE__, __func__, \
38
0
                 (size_t)__LINE__);                                              \
39
0
      winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);                           \
40
0
      abort();                                                                   \
41
0
    }                                                                              \
42
454k
  } while (0)
43
44
BOOL Stream_EnsureCapacity(wStream* s, size_t size)
45
3.92k
{
46
3.92k
  WINPR_ASSERT(s);
47
3.92k
  if (s->capacity >= size)
48
0
    return TRUE;
49
50
3.92k
  const size_t increment = 128ull;
51
3.92k
  if (size > SIZE_MAX - increment)
52
0
    return FALSE;
53
54
3.92k
  const size_t old_capacity = s->capacity;
55
3.92k
  const size_t new_capacity = size + increment - size % increment;
56
3.92k
  const size_t position = Stream_GetPosition(s);
57
58
3.92k
  BYTE* new_buf = nullptr;
59
3.92k
  if (!s->isOwner)
60
0
  {
61
0
    new_buf = (BYTE*)malloc(new_capacity);
62
0
    if (!new_buf)
63
0
      return FALSE;
64
65
0
    CopyMemory(new_buf, s->buffer, s->capacity);
66
0
    s->isOwner = TRUE;
67
0
  }
68
3.92k
  else
69
3.92k
  {
70
3.92k
    new_buf = (BYTE*)realloc(s->buffer, new_capacity);
71
3.92k
    if (!new_buf)
72
0
      return FALSE;
73
3.92k
  }
74
75
3.92k
  s->buffer = new_buf;
76
3.92k
  s->capacity = new_capacity;
77
3.92k
  s->length = new_capacity;
78
3.92k
  ZeroMemory(&s->buffer[old_capacity], s->capacity - old_capacity);
79
80
3.92k
  return Stream_SetPosition(s, position);
81
3.92k
}
82
83
BOOL Stream_EnsureRemainingCapacity(wStream* s, size_t size)
84
364k
{
85
364k
  const size_t pos = Stream_GetPosition(s);
86
364k
  if (pos > SIZE_MAX - size)
87
0
    return FALSE;
88
364k
  if (pos + size > Stream_Capacity(s))
89
3.92k
    return Stream_EnsureCapacity(s, Stream_Capacity(s) + size);
90
360k
  return TRUE;
91
364k
}
92
93
wStream* Stream_New(BYTE* buffer, size_t size)
94
95.4k
{
95
95.4k
  wStream* s = nullptr;
96
97
95.4k
  if (!buffer && !size)
98
0
    return nullptr;
99
100
95.4k
  s = calloc(1, sizeof(wStream));
101
95.4k
  if (!s)
102
0
    return nullptr;
103
104
95.4k
  if (buffer)
105
0
    s->buffer = buffer;
106
95.4k
  else
107
95.4k
    s->buffer = (BYTE*)calloc(size, sizeof(BYTE));
108
109
95.4k
  if (!s->buffer)
110
0
  {
111
0
    free(s);
112
0
    return nullptr;
113
0
  }
114
115
95.4k
  s->pointer = s->buffer;
116
95.4k
  s->capacity = size;
117
95.4k
  s->length = size;
118
119
95.4k
  s->pool = nullptr;
120
95.4k
  s->count = 1;
121
95.4k
  s->isAllocatedStream = TRUE;
122
95.4k
  s->isOwner = TRUE;
123
95.4k
  return s;
124
95.4k
}
125
126
wStream* Stream_StaticConstInit(wStream* s, const BYTE* buffer, size_t size)
127
138k
{
128
138k
  union
129
138k
  {
130
138k
    BYTE* b;
131
138k
    const BYTE* cb;
132
138k
  } cnv;
133
134
138k
  cnv.cb = buffer;
135
138k
  return Stream_StaticInit(s, cnv.b, size);
136
138k
}
137
138
wStream* Stream_StaticInit(wStream* s, BYTE* buffer, size_t size)
139
307k
{
140
307k
  const wStream empty = WINPR_C_ARRAY_INIT;
141
142
307k
  WINPR_ASSERT(s);
143
307k
  WINPR_ASSERT(buffer);
144
145
307k
  *s = empty;
146
307k
  s->buffer = s->pointer = buffer;
147
307k
  s->capacity = s->length = size;
148
307k
  s->pool = nullptr;
149
307k
  s->count = 1;
150
307k
  s->isAllocatedStream = FALSE;
151
307k
  s->isOwner = FALSE;
152
307k
  return s;
153
307k
}
154
155
void Stream_EnsureValidity(wStream* s)
156
113k
{
157
113k
  size_t cur = 0;
158
159
113k
  STREAM_ASSERT(s);
160
113k
  STREAM_ASSERT(s->pointer >= s->buffer);
161
162
113k
  cur = (size_t)(s->pointer - s->buffer);
163
113k
  STREAM_ASSERT(cur <= s->capacity);
164
113k
  STREAM_ASSERT(s->length <= s->capacity);
165
113k
}
166
167
void Stream_Free(wStream* s, BOOL bFreeBuffer)
168
96.7k
{
169
96.7k
  if (s)
170
95.4k
  {
171
95.4k
    Stream_EnsureValidity(s);
172
95.4k
    if (bFreeBuffer && s->isOwner)
173
95.1k
      free(s->buffer);
174
175
95.4k
    if (s->isAllocatedStream)
176
95.4k
      free(s);
177
95.4k
  }
178
96.7k
}
179
180
BOOL Stream_SetLength(wStream* _s, size_t _l)
181
0
{
182
0
  if ((_l) > Stream_Capacity(_s))
183
0
  {
184
0
    _s->length = 0;
185
0
    return FALSE;
186
0
  }
187
0
  _s->length = _l;
188
0
  return TRUE;
189
0
}
190
191
BOOL Stream_SetPosition(wStream* _s, size_t _p)
192
189k
{
193
189k
  if ((_p) > Stream_Capacity(_s))
194
0
  {
195
0
    _s->pointer = _s->buffer;
196
0
    return FALSE;
197
0
  }
198
189k
  _s->pointer = _s->buffer + (_p);
199
189k
  return TRUE;
200
189k
}
201
202
void Stream_SealLength(wStream* _s)
203
61.9k
{
204
61.9k
  size_t cur = 0;
205
61.9k
  WINPR_ASSERT(_s);
206
61.9k
  WINPR_ASSERT(_s->buffer <= _s->pointer);
207
61.9k
  cur = (size_t)(_s->pointer - _s->buffer);
208
61.9k
  WINPR_ASSERT(cur <= _s->capacity);
209
61.9k
  if (cur <= _s->capacity)
210
61.9k
    _s->length = cur;
211
0
  else
212
0
  {
213
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was written out of bounds");
214
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
215
0
    _s->length = 0;
216
0
  }
217
61.9k
}
218
219
#if defined(WITH_WINPR_DEPRECATED)
220
BOOL Stream_SetPointer(wStream* _s, BYTE* _p)
221
{
222
  WINPR_ASSERT(_s);
223
  if (!_p || (_s->buffer > _p) || (_s->buffer + _s->capacity < _p))
224
  {
225
    _s->pointer = _s->buffer;
226
    return FALSE;
227
  }
228
  _s->pointer = _p;
229
  return TRUE;
230
}
231
232
BOOL Stream_SetBuffer(wStream* _s, BYTE* _b)
233
{
234
  WINPR_ASSERT(_s);
235
  WINPR_ASSERT(_b);
236
237
  _s->buffer = _b;
238
  _s->pointer = _b;
239
  return _s->buffer != nullptr;
240
}
241
242
void Stream_SetCapacity(wStream* _s, size_t _c)
243
{
244
  WINPR_ASSERT(_s);
245
  _s->capacity = _c;
246
}
247
248
#endif
249
250
size_t Stream_GetRemainingCapacity(const wStream* _s)
251
18.0M
{
252
18.0M
  size_t cur = 0;
253
18.0M
  WINPR_ASSERT(_s);
254
18.0M
  WINPR_ASSERT(_s->buffer <= _s->pointer);
255
18.0M
  cur = (size_t)(_s->pointer - _s->buffer);
256
18.0M
  WINPR_ASSERT(cur <= _s->capacity);
257
18.0M
  if (cur > _s->capacity)
258
0
  {
259
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was written out of bounds");
260
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
261
0
    return 0;
262
0
  }
263
18.0M
  return (_s->capacity - cur);
264
18.0M
}
265
266
size_t Stream_GetRemainingLength(const wStream* _s)
267
30.0M
{
268
30.0M
  size_t cur = 0;
269
30.0M
  WINPR_ASSERT(_s);
270
30.0M
  WINPR_ASSERT(_s->buffer <= _s->pointer);
271
30.0M
  WINPR_ASSERT(_s->length <= _s->capacity);
272
30.0M
  cur = (size_t)(_s->pointer - _s->buffer);
273
30.0M
  WINPR_ASSERT(cur <= _s->length);
274
30.0M
  if (cur > _s->length)
275
0
  {
276
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was read out of bounds");
277
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
278
0
    return 0;
279
0
  }
280
30.0M
  return (_s->length - cur);
281
30.0M
}
282
283
BOOL Stream_Write_UTF16_String(wStream* s, const WCHAR* src, size_t length)
284
0
{
285
0
  WINPR_ASSERT(s);
286
0
  WINPR_ASSERT(src || (length == 0));
287
0
  if (!s || !src)
288
0
    return FALSE;
289
290
0
  if (!Stream_CheckAndLogRequiredCapacityOfSize(STREAM_TAG, (s), length, sizeof(WCHAR)))
291
0
    return FALSE;
292
293
0
  for (size_t x = 0; x < length; x++)
294
0
    Stream_Write_UINT16(s, src[x]);
295
296
0
  return TRUE;
297
0
}
298
299
BOOL Stream_Read_UTF16_String(wStream* s, WCHAR* dst, size_t length)
300
29.1k
{
301
29.1k
  WINPR_ASSERT(s);
302
29.1k
  WINPR_ASSERT(dst);
303
304
29.1k
  if (!Stream_CheckAndLogRequiredLengthOfSize(STREAM_TAG, s, length, sizeof(WCHAR)))
305
39
    return FALSE;
306
307
1.01M
  for (size_t x = 0; x < length; x++)
308
987k
    Stream_Read_UINT16(s, dst[x]);
309
310
29.1k
  return TRUE;
311
29.1k
}
312
313
BOOL Stream_CheckAndLogRequiredCapacityEx(const char* tag, DWORD level, wStream* s, size_t nmemb,
314
                                          size_t size, const char* fmt, ...)
315
25.9k
{
316
25.9k
  WINPR_ASSERT(size != 0);
317
25.9k
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
318
319
25.9k
  if (actual < nmemb)
320
82
  {
321
82
    va_list args = WINPR_C_ARRAY_INIT;
322
323
82
    va_start(args, fmt);
324
82
    const BOOL rc =
325
82
        Stream_CheckAndLogRequiredCapacityExVa(tag, level, s, nmemb, size, fmt, args);
326
82
    va_end(args);
327
82
    return rc;
328
82
  }
329
25.9k
  return TRUE;
330
25.9k
}
331
332
BOOL Stream_CheckAndLogRequiredCapacityExVa(const char* tag, DWORD level, wStream* s, size_t nmemb,
333
                                            size_t size, const char* fmt, va_list args)
334
82
{
335
82
  WINPR_ASSERT(size != 0);
336
82
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
337
338
82
  if (actual < nmemb)
339
82
    return Stream_CheckAndLogRequiredCapacityWLogExVa(WLog_Get(tag), level, s, nmemb, size, fmt,
340
82
                                                      args);
341
0
  return TRUE;
342
82
}
343
344
WINPR_ATTR_FORMAT_ARG(6, 0)
345
BOOL Stream_CheckAndLogRequiredCapacityWLogExVa(wLog* log, DWORD level, wStream* s, size_t nmemb,
346
                                                size_t size, WINPR_FORMAT_ARG const char* fmt,
347
                                                va_list args)
348
82
{
349
350
82
  WINPR_ASSERT(size != 0);
351
82
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
352
353
82
  if (actual < nmemb)
354
82
  {
355
82
    char prefix[1024] = WINPR_C_ARRAY_INIT;
356
357
82
    (void)vsnprintf(prefix, sizeof(prefix), fmt, args);
358
359
82
    WLog_Print(log, level,
360
82
               "[%s] invalid remaining capacity, got %" PRIuz ", require at least %" PRIuz
361
82
               " [element size=%" PRIuz "]",
362
82
               prefix, actual, nmemb, size);
363
82
    winpr_log_backtrace_ex(log, level, 20);
364
82
    return FALSE;
365
82
  }
366
0
  return TRUE;
367
82
}
368
369
WINPR_ATTR_FORMAT_ARG(6, 7)
370
BOOL Stream_CheckAndLogRequiredCapacityWLogEx(wLog* log, DWORD level, wStream* s, size_t nmemb,
371
                                              size_t size, WINPR_FORMAT_ARG const char* fmt, ...)
372
0
{
373
374
0
  WINPR_ASSERT(size != 0);
375
0
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
376
377
0
  if (actual < nmemb)
378
0
  {
379
0
    va_list args = WINPR_C_ARRAY_INIT;
380
381
0
    va_start(args, fmt);
382
0
    const BOOL rc =
383
0
        Stream_CheckAndLogRequiredCapacityWLogExVa(log, level, s, nmemb, size, fmt, args);
384
0
    va_end(args);
385
0
    return rc;
386
0
  }
387
0
  return TRUE;
388
0
}
389
390
WINPR_ATTR_FORMAT_ARG(6, 7)
391
BOOL Stream_CheckAndLogRequiredLengthEx(const char* tag, DWORD level, wStream* s, size_t nmemb,
392
                                        size_t size, WINPR_FORMAT_ARG const char* fmt, ...)
393
5.69M
{
394
5.69M
  WINPR_ASSERT(size > 0);
395
5.69M
  const size_t actual = Stream_GetRemainingLength(s) / size;
396
397
5.69M
  if (actual < nmemb)
398
336k
  {
399
336k
    va_list args = WINPR_C_ARRAY_INIT;
400
401
336k
    va_start(args, fmt);
402
336k
    const BOOL rc = Stream_CheckAndLogRequiredLengthExVa(tag, level, s, nmemb, size, fmt, args);
403
336k
    va_end(args);
404
336k
    return rc;
405
336k
  }
406
5.35M
  return TRUE;
407
5.69M
}
408
409
BOOL Stream_CheckAndLogRequiredLengthExVa(const char* tag, DWORD level, wStream* s, size_t nmemb,
410
                                          size_t size, const char* fmt, va_list args)
411
336k
{
412
336k
  WINPR_ASSERT(size > 0);
413
336k
  const size_t actual = Stream_GetRemainingLength(s) / size;
414
415
336k
  if (actual < nmemb)
416
336k
    return Stream_CheckAndLogRequiredLengthWLogExVa(WLog_Get(tag), level, s, nmemb, size, fmt,
417
336k
                                                    args);
418
0
  return TRUE;
419
336k
}
420
421
BOOL Stream_CheckAndLogRequiredLengthWLogEx(wLog* log, DWORD level, wStream* s, size_t nmemb,
422
                                            size_t size, const char* fmt, ...)
423
6.80M
{
424
6.80M
  WINPR_ASSERT(size > 0);
425
6.80M
  const size_t actual = Stream_GetRemainingLength(s) / size;
426
427
6.80M
  if (actual < nmemb)
428
89.6k
  {
429
89.6k
    va_list args = WINPR_C_ARRAY_INIT;
430
431
89.6k
    va_start(args, fmt);
432
89.6k
    const BOOL rc =
433
89.6k
        Stream_CheckAndLogRequiredLengthWLogExVa(log, level, s, nmemb, size, fmt, args);
434
89.6k
    va_end(args);
435
89.6k
    return rc;
436
89.6k
  }
437
6.71M
  return TRUE;
438
6.80M
}
439
440
WINPR_ATTR_FORMAT_ARG(6, 0)
441
BOOL Stream_CheckAndLogRequiredLengthWLogExVa(wLog* log, DWORD level, wStream* s, size_t nmemb,
442
                                              size_t size, WINPR_FORMAT_ARG const char* fmt,
443
                                              va_list args)
444
425k
{
445
425k
  WINPR_ASSERT(size > 0);
446
425k
  const size_t actual = Stream_GetRemainingLength(s) / size;
447
448
425k
  if (actual < nmemb)
449
425k
  {
450
425k
    char prefix[1024] = WINPR_C_ARRAY_INIT;
451
452
425k
    (void)vsnprintf(prefix, sizeof(prefix), fmt, args);
453
454
425k
    WLog_Print(log, level,
455
425k
               "[%s] invalid length, got %" PRIuz ", require at least %" PRIuz
456
425k
               " [element size=%" PRIuz "]",
457
425k
               prefix, actual, nmemb, size);
458
425k
    winpr_log_backtrace_ex(log, level, 20);
459
425k
    return FALSE;
460
425k
  }
461
0
  return TRUE;
462
425k
}
463
464
SSIZE_T Stream_Write_UTF16_String_From_UTF8(wStream* s, size_t wcharLength, const char* src,
465
                                            size_t length, BOOL fill)
466
0
{
467
0
  SSIZE_T rc = 0;
468
0
  WCHAR* str = Stream_PointerAs(s, WCHAR);
469
470
0
  if (length != 0)
471
0
  {
472
0
    if (!Stream_CheckAndLogRequiredCapacityOfSize(STREAM_TAG, s, wcharLength, sizeof(WCHAR)))
473
0
      return -1;
474
475
0
    rc = ConvertUtf8NToWChar(src, length, str, wcharLength);
476
0
    if (rc < 0)
477
0
      return -1;
478
479
0
    Stream_Seek(s, (size_t)rc * sizeof(WCHAR));
480
0
  }
481
482
0
  if (fill)
483
0
    Stream_Zero(s, (wcharLength - (size_t)rc) * sizeof(WCHAR));
484
0
  return rc;
485
0
}
486
487
char* Stream_Read_UTF16_String_As_UTF8(wStream* s, size_t wcharLength, size_t* pUtfCharLength)
488
0
{
489
0
  const WCHAR* str = Stream_ConstPointer(s);
490
0
  if (wcharLength > SIZE_MAX / sizeof(WCHAR))
491
0
    return nullptr;
492
493
0
  if (!Stream_CheckAndLogRequiredLength(STREAM_TAG, s, wcharLength * sizeof(WCHAR)))
494
0
    return nullptr;
495
496
0
  Stream_Seek(s, wcharLength * sizeof(WCHAR));
497
0
  return ConvertWCharNToUtf8Alloc(str, wcharLength, pUtfCharLength);
498
0
}
499
500
SSIZE_T Stream_Read_UTF16_String_As_UTF8_Buffer(wStream* s, size_t wcharLength, char* utfBuffer,
501
                                                size_t utfBufferCharLength)
502
609
{
503
609
  const WCHAR* ptr = Stream_ConstPointer(s);
504
609
  if (wcharLength > SIZE_MAX / sizeof(WCHAR))
505
0
    return -1;
506
507
609
  if (!Stream_CheckAndLogRequiredLength(STREAM_TAG, s, wcharLength * sizeof(WCHAR)))
508
0
    return -1;
509
510
609
  Stream_Seek(s, wcharLength * sizeof(WCHAR));
511
609
  return ConvertWCharNToUtf8(ptr, wcharLength, utfBuffer, utfBufferCharLength);
512
609
}
513
514
BOOL Stream_SafeSeekEx(wStream* s, size_t size, const char* file, size_t line, const char* fkt)
515
2.91M
{
516
2.91M
  if (!Stream_CheckAndLogRequiredLengthEx(STREAM_TAG, WLOG_WARN, s, size, 1, "%s(%s:%" PRIuz ")",
517
2.91M
                                          fkt, file, line))
518
49.4k
    return FALSE;
519
520
2.86M
  Stream_Seek(s, size);
521
2.86M
  return TRUE;
522
2.91M
}
523
524
BOOL Stream_SafeZeroEx(wStream* s, size_t size, const char* file, size_t line, const char* fkt)
525
6.06k
{
526
6.06k
  if (!Stream_CheckAndLogRequiredCapacityEx(STREAM_TAG, WLOG_WARN, s, size, 1,
527
6.06k
                                            "%s(%s:%" PRIuz ")", fkt, file, line))
528
0
    return FALSE;
529
530
6.06k
  Stream_Zero(s, size);
531
6.06k
  return TRUE;
532
6.06k
}