Coverage Report

Created: 2026-03-04 06:14

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/FreeRDP/winpr/libwinpr/pool/work.c
Line
Count
Source
1
/**
2
 * WinPR: Windows Portable Runtime
3
 * Thread Pool API (Work)
4
 *
5
 * Copyright 2012 Marc-Andre Moreau <marcandre.moreau@gmail.com>
6
 *
7
 * Licensed under the Apache License, Version 2.0 (the "License");
8
 * you may not use this file except in compliance with the License.
9
 * You may obtain a copy of the License at
10
 *
11
 *     http://www.apache.org/licenses/LICENSE-2.0
12
 *
13
 * Unless required by applicable law or agreed to in writing, software
14
 * distributed under the License is distributed on an "AS IS" BASIS,
15
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
 * See the License for the specific language governing permissions and
17
 * limitations under the License.
18
 */
19
20
#include <winpr/config.h>
21
22
#include <winpr/assert.h>
23
#include <winpr/crt.h>
24
#include <winpr/pool.h>
25
#include <winpr/library.h>
26
27
#include "pool.h"
28
#include "../log.h"
29
#define TAG WINPR_TAG("pool")
30
31
#ifdef WINPR_THREAD_POOL
32
33
#ifdef _WIN32
34
static INIT_ONCE init_once_module = INIT_ONCE_STATIC_INIT;
35
static PTP_WORK(WINAPI* pCreateThreadpoolWork)(PTP_WORK_CALLBACK pfnwk, PVOID pv,
36
                                               PTP_CALLBACK_ENVIRON pcbe);
37
static VOID(WINAPI* pCloseThreadpoolWork)(PTP_WORK pwk);
38
static VOID(WINAPI* pSubmitThreadpoolWork)(PTP_WORK pwk);
39
static BOOL(WINAPI* pTrySubmitThreadpoolCallback)(PTP_SIMPLE_CALLBACK pfns, PVOID pv,
40
                                                  PTP_CALLBACK_ENVIRON pcbe);
41
static VOID(WINAPI* pWaitForThreadpoolWorkCallbacks)(PTP_WORK pwk, BOOL fCancelPendingCallbacks);
42
43
static BOOL CALLBACK init_module(PINIT_ONCE once, PVOID param, PVOID* context)
44
{
45
  HMODULE kernel32 = LoadLibraryA("kernel32.dll");
46
47
  if (kernel32)
48
  {
49
    pCreateThreadpoolWork = GetProcAddressAs(kernel32, "CreateThreadpoolWork", void*);
50
    pCloseThreadpoolWork = GetProcAddressAs(kernel32, "CloseThreadpoolWork", void*);
51
    pSubmitThreadpoolWork = GetProcAddressAs(kernel32, "SubmitThreadpoolWork", void*);
52
    pTrySubmitThreadpoolCallback =
53
        GetProcAddressAs(kernel32, "TrySubmitThreadpoolCallback", void*);
54
    pWaitForThreadpoolWorkCallbacks =
55
        GetProcAddressAs(kernel32, "WaitForThreadpoolWorkCallbacks", void*);
56
  }
57
58
  return TRUE;
59
}
60
#endif
61
62
static TP_CALLBACK_ENVIRON DEFAULT_CALLBACK_ENVIRONMENT = {
63
  1,       /* Version */
64
  nullptr, /* Pool */
65
  nullptr, /* CleanupGroup */
66
  nullptr, /* CleanupGroupCancelCallback */
67
  nullptr, /* RaceDll */
68
  nullptr, /* FinalizationCallback */
69
  { 0 }    /* Flags */
70
};
71
72
PTP_WORK winpr_CreateThreadpoolWork(PTP_WORK_CALLBACK pfnwk, PVOID pv, PTP_CALLBACK_ENVIRON pcbe)
73
0
{
74
0
  PTP_WORK work = nullptr;
75
#ifdef _WIN32
76
  if (!InitOnceExecuteOnce(&init_once_module, init_module, nullptr, nullptr))
77
    return nullptr;
78
79
  if (pCreateThreadpoolWork)
80
    return pCreateThreadpoolWork(pfnwk, pv, pcbe);
81
82
#endif
83
0
  work = (PTP_WORK)calloc(1, sizeof(TP_WORK));
84
85
0
  if (work)
86
0
  {
87
0
    if (!pcbe)
88
0
    {
89
0
      pcbe = &DEFAULT_CALLBACK_ENVIRONMENT;
90
0
      pcbe->Pool = GetDefaultThreadpool();
91
0
    }
92
93
0
    work->CallbackEnvironment = pcbe;
94
0
    work->WorkCallback = pfnwk;
95
0
    work->CallbackParameter = pv;
96
0
#ifndef _WIN32
97
98
0
    if (pcbe->CleanupGroup)
99
0
      ArrayList_Append(pcbe->CleanupGroup->groups, work);
100
101
0
#endif
102
0
  }
103
104
0
  return work;
105
0
}
106
107
VOID winpr_CloseThreadpoolWork(PTP_WORK pwk)
108
0
{
109
#ifdef _WIN32
110
  if (!InitOnceExecuteOnce(&init_once_module, init_module, nullptr, nullptr))
111
    return;
112
113
  if (pCloseThreadpoolWork)
114
  {
115
    pCloseThreadpoolWork(pwk);
116
    return;
117
  }
118
119
#else
120
121
0
  WINPR_ASSERT(pwk);
122
0
  WINPR_ASSERT(pwk->CallbackEnvironment);
123
0
  if (pwk->CallbackEnvironment->CleanupGroup)
124
0
    ArrayList_Remove(pwk->CallbackEnvironment->CleanupGroup->groups, pwk);
125
126
0
#endif
127
0
  free(pwk);
128
0
}
129
130
VOID winpr_SubmitThreadpoolWork(PTP_WORK pwk)
131
0
{
132
0
  PTP_POOL pool = nullptr;
133
0
  PTP_CALLBACK_INSTANCE callbackInstance = nullptr;
134
#ifdef _WIN32
135
  if (!InitOnceExecuteOnce(&init_once_module, init_module, nullptr, nullptr))
136
    return;
137
138
  if (pSubmitThreadpoolWork)
139
  {
140
    pSubmitThreadpoolWork(pwk);
141
    return;
142
  }
143
144
#endif
145
146
0
  WINPR_ASSERT(pwk);
147
0
  WINPR_ASSERT(pwk->CallbackEnvironment);
148
0
  pool = pwk->CallbackEnvironment->Pool;
149
0
  callbackInstance = (PTP_CALLBACK_INSTANCE)calloc(1, sizeof(TP_CALLBACK_INSTANCE));
150
151
0
  if (callbackInstance)
152
0
  {
153
0
    callbackInstance->Work = pwk;
154
0
    CountdownEvent_AddCount(pool->WorkComplete, 1);
155
0
    if (!Queue_Enqueue(pool->PendingQueue, callbackInstance))
156
0
      free(callbackInstance);
157
0
  }
158
  // NOLINTNEXTLINE(clang-analyzer-unix.Malloc): Queue_Enqueue takes ownership of callbackInstance
159
0
}
160
161
BOOL winpr_TrySubmitThreadpoolCallback(WINPR_ATTR_UNUSED PTP_SIMPLE_CALLBACK pfns,
162
                                       WINPR_ATTR_UNUSED PVOID pv,
163
                                       WINPR_ATTR_UNUSED PTP_CALLBACK_ENVIRON pcbe)
164
0
{
165
#ifdef _WIN32
166
  if (!InitOnceExecuteOnce(&init_once_module, init_module, nullptr, nullptr))
167
    return FALSE;
168
169
  if (pTrySubmitThreadpoolCallback)
170
    return pTrySubmitThreadpoolCallback(pfns, pv, pcbe);
171
172
#endif
173
0
  WLog_ERR(TAG, "TrySubmitThreadpoolCallback is not implemented");
174
0
  return FALSE;
175
0
}
176
177
VOID winpr_WaitForThreadpoolWorkCallbacks(PTP_WORK pwk,
178
                                          WINPR_ATTR_UNUSED BOOL fCancelPendingCallbacks)
179
0
{
180
0
  HANDLE event = nullptr;
181
0
  PTP_POOL pool = nullptr;
182
183
#ifdef _WIN32
184
  if (!InitOnceExecuteOnce(&init_once_module, init_module, nullptr, nullptr))
185
    return;
186
187
  if (pWaitForThreadpoolWorkCallbacks)
188
  {
189
    pWaitForThreadpoolWorkCallbacks(pwk, fCancelPendingCallbacks);
190
    return;
191
  }
192
193
#endif
194
0
  WINPR_ASSERT(pwk);
195
0
  WINPR_ASSERT(pwk->CallbackEnvironment);
196
197
0
  pool = pwk->CallbackEnvironment->Pool;
198
0
  WINPR_ASSERT(pool);
199
200
0
  event = CountdownEvent_WaitHandle(pool->WorkComplete);
201
202
0
  if (WaitForSingleObject(event, INFINITE) != WAIT_OBJECT_0)
203
0
    WLog_ERR(TAG, "error waiting on work completion");
204
0
}
205
206
#endif /* WINPR_THREAD_POOL defined */