Coverage Report

Created: 2026-04-12 07:03

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