Coverage Report

Created: 2026-10-15 06:31

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
4.30M
#define STREAM_TAG WINPR_TAG("wStream")
31
32
#define STREAM_ASSERT(cond)                                                            \
33
896k
  do                                                                                 \
34
896k
  {                                                                                  \
35
896k
    if (!(cond))                                                                   \
36
896k
    {                                                                              \
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
896k
  } while (0)
43
44
BOOL Stream_ResizeToCapacity(wStream* s, size_t size)
45
119k
{
46
119k
  const size_t old_capacity = s->capacity;
47
119k
  const size_t new_capacity = size;
48
119k
  size_t position = Stream_GetPosition(s);
49
50
119k
  BYTE* new_buf = nullptr;
51
119k
  if (!s->isOwner)
52
0
  {
53
0
    new_buf = (BYTE*)malloc(new_capacity);
54
0
    if (!new_buf)
55
0
      return FALSE;
56
57
0
    CopyMemory(new_buf, s->buffer, s->capacity);
58
0
    s->isOwner = TRUE;
59
0
  }
60
119k
  else
61
119k
  {
62
119k
    new_buf = (BYTE*)realloc(s->buffer, new_capacity);
63
119k
    if (!new_buf)
64
0
      return FALSE;
65
119k
  }
66
67
119k
  s->buffer = new_buf;
68
119k
  s->capacity = new_capacity;
69
119k
  s->length = new_capacity;
70
119k
  if (old_capacity < new_capacity)
71
119k
    ZeroMemory(&s->buffer[old_capacity], s->capacity - old_capacity);
72
73
119k
  if (position > new_capacity)
74
0
    position = new_capacity;
75
119k
  return Stream_SetPosition(s, position);
76
119k
}
77
78
BOOL Stream_EnsureCapacity(wStream* s, size_t size)
79
119k
{
80
119k
  WINPR_ASSERT(s);
81
119k
  if (s->capacity >= size)
82
0
    return TRUE;
83
84
119k
  const size_t increment = 128ull;
85
119k
  if (size > SIZE_MAX - increment)
86
0
    return FALSE;
87
88
119k
  const size_t new_capacity = size + increment - size % increment;
89
119k
  return Stream_ResizeToCapacity(s, new_capacity);
90
119k
}
91
92
BOOL Stream_EnsureRemainingCapacity(wStream* s, size_t size)
93
22.0M
{
94
22.0M
  const size_t pos = Stream_GetPosition(s);
95
22.0M
  if (pos > SIZE_MAX - size)
96
0
    return FALSE;
97
22.0M
  if (pos + size > Stream_Capacity(s))
98
119k
    return Stream_EnsureCapacity(s, Stream_Capacity(s) + size);
99
21.8M
  return TRUE;
100
22.0M
}
101
102
wStream* Stream_New(BYTE* buffer, size_t size)
103
185k
{
104
185k
  wStream* s = nullptr;
105
106
185k
  if (!buffer && !size)
107
0
    return nullptr;
108
109
185k
  s = calloc(1, sizeof(wStream));
110
185k
  if (!s)
111
0
    return nullptr;
112
113
185k
  if (buffer)
114
1.15k
    s->buffer = buffer;
115
184k
  else
116
184k
    s->buffer = (BYTE*)calloc(size, sizeof(BYTE));
117
118
185k
  if (!s->buffer)
119
0
  {
120
0
    free(s);
121
0
    return nullptr;
122
0
  }
123
124
185k
  s->pointer = s->buffer;
125
185k
  s->capacity = size;
126
185k
  s->length = size;
127
128
185k
  s->pool = nullptr;
129
185k
  s->count = 1;
130
185k
  s->isAllocatedStream = TRUE;
131
185k
  s->isOwner = TRUE;
132
185k
  return s;
133
185k
}
134
135
wStream* Stream_StaticConstInit(wStream* s, const BYTE* buffer, size_t size)
136
161k
{
137
161k
  union
138
161k
  {
139
161k
    BYTE* b;
140
161k
    const BYTE* cb;
141
161k
  } cnv;
142
143
161k
  cnv.cb = buffer;
144
161k
  return Stream_StaticInit(s, cnv.b, size);
145
161k
}
146
147
wStream* Stream_StaticInit(wStream* s, BYTE* buffer, size_t size)
148
278k
{
149
278k
  const wStream empty = WINPR_C_ARRAY_INIT;
150
151
278k
  WINPR_ASSERT(s);
152
278k
  WINPR_ASSERT(buffer);
153
154
278k
  *s = empty;
155
278k
  s->buffer = s->pointer = buffer;
156
278k
  s->capacity = s->length = size;
157
278k
  s->pool = nullptr;
158
278k
  s->count = 1;
159
278k
  s->isAllocatedStream = FALSE;
160
278k
  s->isOwner = FALSE;
161
278k
  return s;
162
278k
}
163
164
void Stream_EnsureValidity(wStream* s)
165
224k
{
166
224k
  size_t cur = 0;
167
168
224k
  STREAM_ASSERT(s);
169
224k
  STREAM_ASSERT(s->pointer >= s->buffer);
170
171
224k
  cur = (size_t)(s->pointer - s->buffer);
172
224k
  STREAM_ASSERT(cur <= s->capacity);
173
224k
  STREAM_ASSERT(s->length <= s->capacity);
174
224k
}
175
176
void Stream_Free(wStream* s, BOOL bFreeBuffer)
177
186k
{
178
186k
  if (s)
179
185k
  {
180
185k
    Stream_EnsureValidity(s);
181
185k
    if (bFreeBuffer && s->isOwner)
182
179k
      free(s->buffer);
183
184
185k
    if (s->isAllocatedStream)
185
185k
      free(s);
186
185k
  }
187
186k
}
188
189
BOOL Stream_SetLength(wStream* _s, size_t _l)
190
264k
{
191
264k
  if ((_l) > Stream_Capacity(_s))
192
0
  {
193
0
    _s->length = 0;
194
0
    return FALSE;
195
0
  }
196
264k
  _s->length = _l;
197
264k
  return TRUE;
198
264k
}
199
200
BOOL Stream_SetPosition(wStream* _s, size_t _p)
201
461k
{
202
461k
  if ((_p) > Stream_Capacity(_s))
203
0
  {
204
0
    _s->pointer = _s->buffer;
205
0
    return FALSE;
206
0
  }
207
461k
  _s->pointer = _s->buffer + (_p);
208
461k
  return TRUE;
209
461k
}
210
211
void Stream_SealLength(wStream* _s)
212
101k
{
213
101k
  size_t cur = 0;
214
101k
  WINPR_ASSERT(_s);
215
101k
  WINPR_ASSERT(_s->buffer <= _s->pointer);
216
101k
  cur = (size_t)(_s->pointer - _s->buffer);
217
101k
  WINPR_ASSERT(cur <= _s->capacity);
218
101k
  if (cur <= _s->capacity)
219
101k
    _s->length = cur;
220
0
  else
221
0
  {
222
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was written out of bounds");
223
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
224
0
    _s->length = 0;
225
0
  }
226
101k
}
227
228
#if defined(WITH_WINPR_DEPRECATED)
229
BOOL Stream_SetPointer(wStream* _s, BYTE* _p)
230
{
231
  WINPR_ASSERT(_s);
232
  if (!_p || (_s->buffer > _p) || (_s->buffer + _s->capacity < _p))
233
  {
234
    _s->pointer = _s->buffer;
235
    return FALSE;
236
  }
237
  _s->pointer = _p;
238
  return TRUE;
239
}
240
241
BOOL Stream_SetBuffer(wStream* _s, BYTE* _b)
242
{
243
  WINPR_ASSERT(_s);
244
  WINPR_ASSERT(_b);
245
246
  _s->buffer = _b;
247
  _s->pointer = _b;
248
  return _s->buffer != nullptr;
249
}
250
251
void Stream_SetCapacity(wStream* _s, size_t _c)
252
{
253
  WINPR_ASSERT(_s);
254
  _s->capacity = _c;
255
}
256
257
#endif
258
259
size_t Stream_GetRemainingCapacity(const wStream* _s)
260
80.7M
{
261
80.7M
  size_t cur = 0;
262
80.7M
  WINPR_ASSERT(_s);
263
80.7M
  WINPR_ASSERT(_s->buffer <= _s->pointer);
264
80.7M
  cur = (size_t)(_s->pointer - _s->buffer);
265
80.7M
  WINPR_ASSERT(cur <= _s->capacity);
266
80.7M
  if (cur > _s->capacity)
267
0
  {
268
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was written out of bounds");
269
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
270
0
    return 0;
271
0
  }
272
80.7M
  return (_s->capacity - cur);
273
80.7M
}
274
275
size_t Stream_GetRemainingLength(const wStream* _s)
276
60.3M
{
277
60.3M
  size_t cur = 0;
278
60.3M
  WINPR_ASSERT(_s);
279
60.3M
  WINPR_ASSERT(_s->buffer <= _s->pointer);
280
60.3M
  WINPR_ASSERT(_s->length <= _s->capacity);
281
60.3M
  cur = (size_t)(_s->pointer - _s->buffer);
282
60.3M
  WINPR_ASSERT(cur <= _s->length);
283
60.3M
  if (cur > _s->length)
284
0
  {
285
0
    WLog_FATAL(STREAM_TAG, "wStream API misuse: stream was read out of bounds");
286
0
    winpr_log_backtrace(STREAM_TAG, WLOG_FATAL, 20);
287
0
    return 0;
288
0
  }
289
60.3M
  return (_s->length - cur);
290
60.3M
}
291
292
BOOL Stream_Write_UTF16_String(wStream* s, const WCHAR* src, size_t length)
293
0
{
294
0
  WINPR_ASSERT(s);
295
0
  WINPR_ASSERT(src || (length == 0));
296
0
  if (!s || !src)
297
0
    return FALSE;
298
299
0
  if (!Stream_CheckAndLogRequiredCapacityOfSize(STREAM_TAG, (s), length, sizeof(WCHAR)))
300
0
    return FALSE;
301
302
0
  for (size_t x = 0; x < length; x++)
303
0
    Stream_Write_UINT16(s, src[x]);
304
305
0
  return TRUE;
306
0
}
307
308
BOOL Stream_Read_UTF16_String(wStream* s, WCHAR* dst, size_t length)
309
4.70k
{
310
4.70k
  WINPR_ASSERT(s);
311
4.70k
  WINPR_ASSERT(dst);
312
313
4.70k
  if (!Stream_CheckAndLogRequiredLengthOfSize(STREAM_TAG, s, length, sizeof(WCHAR)))
314
26
    return FALSE;
315
316
206k
  for (size_t x = 0; x < length; x++)
317
201k
    Stream_Read_UINT16(s, dst[x]);
318
319
4.67k
  return TRUE;
320
4.70k
}
321
322
BOOL Stream_CheckAndLogRequiredCapacityEx(const char* tag, DWORD level, wStream* s, size_t nmemb,
323
                                          size_t size, const char* fmt, ...)
324
28.7k
{
325
28.7k
  WINPR_ASSERT(size != 0);
326
28.7k
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
327
328
28.7k
  if (actual < nmemb)
329
95
  {
330
95
    va_list args = WINPR_C_ARRAY_INIT;
331
332
95
    va_start(args, fmt);
333
95
    const BOOL rc =
334
95
        Stream_CheckAndLogRequiredCapacityExVa(tag, level, s, nmemb, size, fmt, args);
335
95
    va_end(args);
336
95
    return rc;
337
95
  }
338
28.6k
  return TRUE;
339
28.7k
}
340
341
BOOL Stream_CheckAndLogRequiredCapacityExVa(const char* tag, DWORD level, wStream* s, size_t nmemb,
342
                                            size_t size, const char* fmt, va_list args)
343
95
{
344
95
  WINPR_ASSERT(size != 0);
345
95
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
346
347
95
  if (actual < nmemb)
348
95
    return Stream_CheckAndLogRequiredCapacityWLogExVa(WLog_Get(tag), level, s, nmemb, size, fmt,
349
95
                                                      args);
350
0
  return TRUE;
351
95
}
352
353
WINPR_ATTR_FORMAT_ARG(6, 0)
354
BOOL Stream_CheckAndLogRequiredCapacityWLogExVa(wLog* log, DWORD level, wStream* s, size_t nmemb,
355
                                                size_t size, WINPR_FORMAT_ARG const char* fmt,
356
                                                va_list args)
357
95
{
358
359
95
  WINPR_ASSERT(size != 0);
360
95
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
361
362
95
  if (actual < nmemb)
363
95
  {
364
95
    char prefix[1024] = WINPR_C_ARRAY_INIT;
365
366
95
    (void)vsnprintf(prefix, sizeof(prefix), fmt, args);
367
368
95
    WLog_Print(log, level,
369
95
               "[%s] invalid remaining capacity, got %" PRIuz ", require at least %" PRIuz
370
95
               " [element size=%" PRIuz "]",
371
95
               prefix, actual, nmemb, size);
372
95
    winpr_log_backtrace_ex(log, level, 20);
373
95
    return FALSE;
374
95
  }
375
0
  return TRUE;
376
95
}
377
378
WINPR_ATTR_FORMAT_ARG(6, 7)
379
BOOL Stream_CheckAndLogRequiredCapacityWLogEx(wLog* log, DWORD level, wStream* s, size_t nmemb,
380
                                              size_t size, WINPR_FORMAT_ARG const char* fmt, ...)
381
0
{
382
383
0
  WINPR_ASSERT(size != 0);
384
0
  const size_t actual = Stream_GetRemainingCapacity(s) / size;
385
386
0
  if (actual < nmemb)
387
0
  {
388
0
    va_list args = WINPR_C_ARRAY_INIT;
389
390
0
    va_start(args, fmt);
391
0
    const BOOL rc =
392
0
        Stream_CheckAndLogRequiredCapacityWLogExVa(log, level, s, nmemb, size, fmt, args);
393
0
    va_end(args);
394
0
    return rc;
395
0
  }
396
0
  return TRUE;
397
0
}
398
399
WINPR_ATTR_FORMAT_ARG(6, 7)
400
BOOL Stream_CheckAndLogRequiredLengthEx(const char* tag, DWORD level, wStream* s, size_t nmemb,
401
                                        size_t size, WINPR_FORMAT_ARG const char* fmt, ...)
402
10.0M
{
403
10.0M
  WINPR_ASSERT(size > 0);
404
10.0M
  const size_t actual = Stream_GetRemainingLength(s) / size;
405
406
10.0M
  if (actual < nmemb)
407
270k
  {
408
270k
    va_list args = WINPR_C_ARRAY_INIT;
409
410
270k
    va_start(args, fmt);
411
270k
    const BOOL rc = Stream_CheckAndLogRequiredLengthExVa(tag, level, s, nmemb, size, fmt, args);
412
270k
    va_end(args);
413
270k
    return rc;
414
270k
  }
415
9.81M
  return TRUE;
416
10.0M
}
417
418
BOOL Stream_CheckAndLogRequiredLengthExVa(const char* tag, DWORD level, wStream* s, size_t nmemb,
419
                                          size_t size, const char* fmt, va_list args)
420
270k
{
421
270k
  WINPR_ASSERT(size > 0);
422
270k
  const size_t actual = Stream_GetRemainingLength(s) / size;
423
424
270k
  if (actual < nmemb)
425
270k
    return Stream_CheckAndLogRequiredLengthWLogExVa(WLog_Get(tag), level, s, nmemb, size, fmt,
426
270k
                                                    args);
427
0
  return TRUE;
428
270k
}
429
430
BOOL Stream_CheckAndLogRequiredLengthWLogEx(wLog* log, DWORD level, wStream* s, size_t nmemb,
431
                                            size_t size, const char* fmt, ...)
432
10.6M
{
433
10.6M
  WINPR_ASSERT(size > 0);
434
10.6M
  const size_t actual = Stream_GetRemainingLength(s) / size;
435
436
10.6M
  if (actual < nmemb)
437
76.1k
  {
438
76.1k
    va_list args = WINPR_C_ARRAY_INIT;
439
440
76.1k
    va_start(args, fmt);
441
76.1k
    const BOOL rc =
442
76.1k
        Stream_CheckAndLogRequiredLengthWLogExVa(log, level, s, nmemb, size, fmt, args);
443
76.1k
    va_end(args);
444
76.1k
    return rc;
445
76.1k
  }
446
10.5M
  return TRUE;
447
10.6M
}
448
449
WINPR_ATTR_FORMAT_ARG(6, 0)
450
BOOL Stream_CheckAndLogRequiredLengthWLogExVa(wLog* log, DWORD level, wStream* s, size_t nmemb,
451
                                              size_t size, WINPR_FORMAT_ARG const char* fmt,
452
                                              va_list args)
453
347k
{
454
347k
  WINPR_ASSERT(size > 0);
455
347k
  const size_t actual = Stream_GetRemainingLength(s) / size;
456
457
347k
  if (actual < nmemb)
458
347k
  {
459
347k
    if (WLog_IsLevelActive(log, level))
460
347k
    {
461
347k
      char prefix[1024] = WINPR_C_ARRAY_INIT;
462
463
347k
      (void)vsnprintf(prefix, sizeof(prefix), fmt, args);
464
465
347k
      WLog_Print(log, level,
466
347k
                 "[%s] invalid length, got %" PRIuz ", require at least %" PRIuz
467
347k
                 " [element size=%" PRIuz "]",
468
347k
                 prefix, actual, nmemb, size);
469
347k
      winpr_log_backtrace_ex(log, level, 20);
470
347k
    }
471
347k
    return FALSE;
472
347k
  }
473
0
  return TRUE;
474
347k
}
475
476
SSIZE_T Stream_Write_UTF16_String_From_UTF8(wStream* s, size_t wcharLength, const char* src,
477
                                            size_t length, BOOL fill)
478
0
{
479
0
  SSIZE_T rc = 0;
480
0
  if (!Stream_CheckAndLogRequiredCapacityOfSize(STREAM_TAG, s, wcharLength, sizeof(WCHAR)))
481
0
    return -1;
482
483
0
  if (length != 0)
484
0
  {
485
0
    size_t wlen = 0;
486
0
    WCHAR* str = ConvertUtf8NToWCharAlloc(src, length, &wlen);
487
0
    if (!str)
488
0
      return -1;
489
490
0
    if (wlen > wcharLength)
491
0
      wlen = wcharLength;
492
0
    Stream_Write(s, str, wlen * sizeof(WCHAR));
493
0
    free(str);
494
0
    rc = WINPR_ASSERTING_INT_CAST(SSIZE_T, wlen);
495
0
  }
496
497
0
  if (fill)
498
0
    Stream_Zero(s, (wcharLength - WINPR_ASSERTING_INT_CAST(size_t, rc)) * sizeof(WCHAR));
499
0
  return rc;
500
0
}
501
502
char* Stream_Read_UTF16_String_As_UTF8(wStream* s, size_t wcharLength, size_t* pUtfCharLength)
503
0
{
504
0
  const WCHAR* str = Stream_ConstPointer(s);
505
0
  if (wcharLength > SIZE_MAX / sizeof(WCHAR))
506
0
    return nullptr;
507
508
0
  if (!Stream_CheckAndLogRequiredLength(STREAM_TAG, s, wcharLength * sizeof(WCHAR)))
509
0
    return nullptr;
510
511
0
  Stream_Seek(s, wcharLength * sizeof(WCHAR));
512
0
  return ConvertWCharNToUtf8Alloc(str, wcharLength, pUtfCharLength);
513
0
}
514
515
SSIZE_T Stream_Read_UTF16_String_As_UTF8_Buffer(wStream* s, size_t wcharLength, char* utfBuffer,
516
                                                size_t utfBufferCharLength)
517
934
{
518
934
  const WCHAR* ptr = Stream_ConstPointer(s);
519
934
  if (wcharLength > SIZE_MAX / sizeof(WCHAR))
520
0
    return -1;
521
522
934
  if (!Stream_CheckAndLogRequiredLength(STREAM_TAG, s, wcharLength * sizeof(WCHAR)))
523
0
    return -1;
524
525
934
  Stream_Seek(s, wcharLength * sizeof(WCHAR));
526
934
  return ConvertWCharNToUtf8(ptr, wcharLength, utfBuffer, utfBufferCharLength);
527
934
}
528
529
BOOL Stream_SafeSeekEx(wStream* s, size_t size, const char* file, size_t line, const char* fkt)
530
4.30M
{
531
4.30M
  if (!Stream_CheckAndLogRequiredLengthEx(STREAM_TAG, WLOG_WARN, s, size, 1, "%s(%s:%" PRIuz ")",
532
4.30M
                                          fkt, file, line))
533
16.4k
    return FALSE;
534
535
4.28M
  Stream_Seek(s, size);
536
4.28M
  return TRUE;
537
4.30M
}
538
539
BOOL Stream_SafeZeroEx(wStream* s, size_t size, const char* file, size_t line, const char* fkt)
540
7.61k
{
541
7.61k
  if (!Stream_CheckAndLogRequiredCapacityEx(STREAM_TAG, WLOG_WARN, s, size, 1,
542
7.61k
                                            "%s(%s:%" PRIuz ")", fkt, file, line))
543
0
    return FALSE;
544
545
7.61k
  Stream_Zero(s, size);
546
7.61k
  return TRUE;
547
7.61k
}