Coverage Report

Created: 2025-12-31 07:28

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/php-src/Zend/zend_list.c
Line
Count
Source
1
/*
2
   +----------------------------------------------------------------------+
3
   | Zend Engine                                                          |
4
   +----------------------------------------------------------------------+
5
   | Copyright (c) Zend Technologies Ltd. (http://www.zend.com)           |
6
   +----------------------------------------------------------------------+
7
   | This source file is subject to version 2.00 of the Zend license,     |
8
   | that is bundled with this package in the file LICENSE, and is        |
9
   | available through the world-wide-web at the following url:           |
10
   | http://www.zend.com/license/2_00.txt.                                |
11
   | If you did not receive a copy of the Zend license and are unable to  |
12
   | obtain it through the world-wide-web, please send a note to          |
13
   | license@zend.com so we can mail you a copy immediately.              |
14
   +----------------------------------------------------------------------+
15
   | Authors: Andi Gutmans <andi@php.net>                                 |
16
   |          Zeev Suraski <zeev@php.net>                                 |
17
   +----------------------------------------------------------------------+
18
*/
19
20
/* resource lists */
21
22
#include "zend.h"
23
#include "zend_list.h"
24
#include "zend_API.h"
25
#include "zend_globals.h"
26
27
ZEND_API int le_index_ptr;
28
29
/* true global */
30
static HashTable list_destructors;
31
32
ZEND_API zval* ZEND_FASTCALL zend_list_insert(void *ptr, int type)
33
2.54k
{
34
2.54k
  zval zv;
35
36
2.54k
  zend_long index = zend_hash_next_free_element(&EG(regular_list));
37
2.54k
  if (index == 0) {
38
1.87k
    index = 1;
39
1.87k
  } else if (index == ZEND_LONG_MAX) {
40
0
    zend_error_noreturn(E_ERROR, "Resource ID space overflow");
41
0
  }
42
2.54k
  ZVAL_NEW_RES(&zv, index, ptr, type);
43
2.54k
  return zend_hash_index_add_new(&EG(regular_list), index, &zv);
44
2.54k
}
45
46
ZEND_API zend_result ZEND_FASTCALL zend_list_delete(zend_resource *res)
47
24
{
48
24
  if (GC_DELREF(res) <= 0) {
49
19
    return zend_hash_index_del(&EG(regular_list), res->handle);
50
19
  } else {
51
5
    return SUCCESS;
52
5
  }
53
24
}
54
55
ZEND_API void ZEND_FASTCALL zend_list_free(zend_resource *res)
56
1.84k
{
57
1.84k
  ZEND_ASSERT(GC_REFCOUNT(res) == 0);
58
1.84k
  zend_hash_index_del(&EG(regular_list), res->handle);
59
1.84k
}
60
61
static void zend_resource_dtor(zend_resource *res)
62
2.54k
{
63
2.54k
  zend_rsrc_list_dtors_entry *ld;
64
2.54k
  zend_resource r = *res;
65
66
2.54k
  res->type = -1;
67
2.54k
  res->ptr = NULL;
68
69
2.54k
  ld = zend_hash_index_find_ptr(&list_destructors, r.type);
70
2.54k
  ZEND_ASSERT(ld && "Unknown list entry type");
71
72
2.54k
  if (ld->list_dtor_ex) {
73
2.54k
    ld->list_dtor_ex(&r);
74
2.54k
  }
75
2.54k
}
76
77
78
ZEND_API void ZEND_FASTCALL zend_list_close(zend_resource *res)
79
18
{
80
18
  if (GC_REFCOUNT(res) <= 0) {
81
0
    zend_list_free(res);
82
18
  } else if (res->type >= 0) {
83
18
    zend_resource_dtor(res);
84
18
  }
85
18
}
86
87
ZEND_API zend_resource* zend_register_resource(void *rsrc_pointer, int rsrc_type)
88
2.54k
{
89
2.54k
  zval *zv;
90
91
2.54k
  zv = zend_list_insert(rsrc_pointer, rsrc_type);
92
93
2.54k
  return Z_RES_P(zv);
94
2.54k
}
95
96
ZEND_API void *zend_fetch_resource2(zend_resource *res, const char *resource_type_name, int resource_type1, int resource_type2)
97
1.84k
{
98
1.84k
  if (res) {
99
1.84k
    if (resource_type1 == res->type) {
100
1.84k
      return res->ptr;
101
1.84k
    }
102
103
0
    if (resource_type2 == res->type) {
104
0
      return res->ptr;
105
0
    }
106
0
  }
107
108
0
  if (resource_type_name) {
109
0
    const char *space;
110
0
    const char *class_name = get_active_class_name(&space);
111
0
    zend_type_error("%s%s%s(): supplied resource is not a valid %s resource", class_name, space, get_active_function_name(), resource_type_name);
112
0
  }
113
114
0
  return NULL;
115
1.84k
}
116
117
ZEND_API void *zend_fetch_resource(zend_resource *res, const char *resource_type_name, int resource_type)
118
0
{
119
0
  if (resource_type == res->type) {
120
0
    return res->ptr;
121
0
  }
122
123
0
  if (resource_type_name) {
124
0
    const char *space;
125
0
    const char *class_name = get_active_class_name(&space);
126
0
    zend_type_error("%s%s%s(): supplied resource is not a valid %s resource", class_name, space, get_active_function_name(), resource_type_name);
127
0
  }
128
129
0
  return NULL;
130
0
}
131
132
ZEND_API void *zend_fetch_resource_ex(zval *res, const char *resource_type_name, int resource_type)
133
0
{
134
0
  const char *space, *class_name;
135
0
  if (res == NULL) {
136
0
    if (resource_type_name) {
137
0
      class_name = get_active_class_name(&space);
138
0
      zend_type_error("%s%s%s(): no %s resource supplied", class_name, space, get_active_function_name(), resource_type_name);
139
0
    }
140
0
    return NULL;
141
0
  }
142
0
  if (Z_TYPE_P(res) != IS_RESOURCE) {
143
0
    if (resource_type_name) {
144
0
      class_name = get_active_class_name(&space);
145
0
      zend_type_error("%s%s%s(): supplied argument is not a valid %s resource", class_name, space, get_active_function_name(), resource_type_name);
146
0
    }
147
0
    return NULL;
148
0
  }
149
150
0
  return zend_fetch_resource(Z_RES_P(res), resource_type_name, resource_type);
151
0
}
152
153
ZEND_API void *zend_fetch_resource2_ex(zval *res, const char *resource_type_name, int resource_type1, int resource_type2)
154
0
{
155
0
  const char *space, *class_name;
156
0
  if (res == NULL) {
157
0
    if (resource_type_name) {
158
0
      class_name = get_active_class_name(&space);
159
0
      zend_type_error("%s%s%s(): no %s resource supplied", class_name, space, get_active_function_name(), resource_type_name);
160
0
    }
161
0
    return NULL;
162
0
  }
163
0
  if (Z_TYPE_P(res) != IS_RESOURCE) {
164
0
    if (resource_type_name) {
165
0
      class_name = get_active_class_name(&space);
166
0
      zend_type_error("%s%s%s(): supplied argument is not a valid %s resource", class_name, space, get_active_function_name(), resource_type_name);
167
0
    }
168
0
    return NULL;
169
0
  }
170
171
0
  return zend_fetch_resource2(Z_RES_P(res), resource_type_name, resource_type1, resource_type2);
172
0
}
173
174
void list_entry_destructor(zval *zv)
175
2.54k
{
176
2.54k
  zend_resource *res = Z_RES_P(zv);
177
178
2.54k
  ZVAL_UNDEF(zv);
179
2.54k
  if (res->type >= 0) {
180
1.84k
    zend_resource_dtor(res);
181
1.84k
  }
182
2.54k
  efree_size(res, sizeof(zend_resource));
183
2.54k
}
184
185
void plist_entry_destructor(zval *zv)
186
0
{
187
0
  zend_resource *res = Z_RES_P(zv);
188
189
0
  if (res->type >= 0) {
190
0
    zend_rsrc_list_dtors_entry *ld;
191
192
0
    ld = zend_hash_index_find_ptr(&list_destructors, res->type);
193
0
    ZEND_ASSERT(ld && "Unknown list entry type");
194
195
0
    if (ld->plist_dtor_ex) {
196
0
      ld->plist_dtor_ex(res);
197
0
    }
198
0
  }
199
0
  free(res);
200
0
}
201
202
ZEND_API void zend_init_rsrc_list(void)
203
222k
{
204
222k
  zend_hash_init(&EG(regular_list), 8, NULL, list_entry_destructor, 0);
205
222k
  EG(regular_list).nNextFreeElement = 0;
206
222k
}
207
208
209
void zend_init_rsrc_plist(void)
210
14
{
211
14
  zend_hash_init(&EG(persistent_list), 8, NULL, plist_entry_destructor, 1);
212
14
}
213
214
215
void zend_close_rsrc_list(HashTable *ht)
216
222k
{
217
222k
  uint32_t i = ht->nNumUsed;
218
222k
  uint32_t num = ht->nNumUsed;
219
220
223k
retry:
221
223k
  zend_try {
222
333k
    while (i-- > 0) {
223
      /* Reload ht->arData on each iteration, as it may be reallocated. */
224
110k
      zval *p = ZEND_HASH_ELEMENT(ht, i);
225
110k
      if (Z_TYPE_P(p) != IS_UNDEF) {
226
110k
        zend_resource *res = Z_PTR_P(p);
227
110k
        if (res->type >= 0) {
228
686
          zend_resource_dtor(res);
229
230
686
          if (UNEXPECTED(ht->nNumUsed != num)) {
231
            /* New resources were added, reloop from the start.
232
             * We need to keep the top->down order to avoid freeing resources
233
             * in use by the newly created resources. */
234
0
            i = num = ht->nNumUsed;
235
0
          }
236
686
        }
237
110k
      }
238
110k
    }
239
223k
  } zend_catch {
240
0
    if (UNEXPECTED(ht->nNumUsed != num)) {
241
      /* See above */
242
0
      i = num = ht->nNumUsed;
243
0
    }
244
245
    /* If we have bailed, we probably executed user code (e.g. user stream
246
     * API). Keep closing resources so they don't leak. User handlers must be
247
     * called now so they aren't called in zend_deactivate() on
248
     * zend_destroy_rsrc_list(&EG(regular_list)). At that point, the executor
249
     * has already shut down and the process would crash. */
250
0
    goto retry;
251
223k
  } zend_end_try();
252
223k
}
253
254
255
void zend_destroy_rsrc_list(HashTable *ht)
256
222k
{
257
222k
  zend_hash_graceful_reverse_destroy(ht);
258
222k
}
259
260
/* int return due to HashTable API */
261
static int clean_module_resource(zval *zv, void *arg)
262
0
{
263
0
  int resource_id = *(int *)arg;
264
265
0
  return Z_RES_TYPE_P(zv) == resource_id;
266
0
}
267
268
/* int return due to HashTable API */
269
static int zend_clean_module_rsrc_dtors_cb(zval *zv, void *arg)
270
0
{
271
0
  zend_rsrc_list_dtors_entry *ld = (zend_rsrc_list_dtors_entry *)Z_PTR_P(zv);
272
0
  int module_number = *(int *)arg;
273
0
  if (ld->module_number == module_number) {
274
0
    zend_hash_apply_with_argument(&EG(persistent_list), clean_module_resource, (void *) &(ld->resource_id));
275
0
    return 1;
276
0
  } else {
277
0
    return 0;
278
0
  }
279
0
}
280
281
282
void zend_clean_module_rsrc_dtors(int module_number)
283
0
{
284
0
  zend_hash_apply_with_argument(&list_destructors, zend_clean_module_rsrc_dtors_cb, (void *) &module_number);
285
0
}
286
287
288
ZEND_API int zend_register_list_destructors_ex(rsrc_dtor_func_t ld, rsrc_dtor_func_t pld, const char *type_name, int module_number)
289
126
{
290
126
  zend_rsrc_list_dtors_entry *lde;
291
126
  zval zv;
292
293
126
  lde = malloc(sizeof(zend_rsrc_list_dtors_entry));
294
126
  lde->list_dtor_ex = ld;
295
126
  lde->plist_dtor_ex = pld;
296
126
  lde->module_number = module_number;
297
126
  lde->resource_id = list_destructors.nNextFreeElement;
298
126
  lde->type_name = type_name;
299
126
  ZVAL_PTR(&zv, lde);
300
301
126
  if (zend_hash_next_index_insert(&list_destructors, &zv) == NULL) {
302
0
    free(lde);
303
0
    return FAILURE;
304
0
  }
305
126
  return list_destructors.nNextFreeElement-1;
306
126
}
307
308
ZEND_API int zend_fetch_list_dtor_id(const char *type_name)
309
0
{
310
0
  zend_rsrc_list_dtors_entry *lde;
311
312
0
  ZEND_HASH_PACKED_FOREACH_PTR(&list_destructors, lde) {
313
0
    if (lde->type_name && (strcmp(type_name, lde->type_name) == 0)) {
314
0
      return lde->resource_id;
315
0
    }
316
0
  } ZEND_HASH_FOREACH_END();
317
318
0
  return 0;
319
0
}
320
321
static void list_destructors_dtor(zval *zv)
322
0
{
323
0
  free(Z_PTR_P(zv));
324
0
}
325
326
void zend_init_rsrc_list_dtors(void)
327
14
{
328
14
  zend_hash_init(&list_destructors, 64, NULL, list_destructors_dtor, 1);
329
14
  list_destructors.nNextFreeElement=1;  /* we don't want resource type 0 */
330
14
}
331
332
333
void zend_destroy_rsrc_list_dtors(void)
334
0
{
335
0
  zend_hash_destroy(&list_destructors);
336
0
}
337
338
339
const char *zend_rsrc_list_get_rsrc_type(zend_resource *res)
340
0
{
341
0
  zend_rsrc_list_dtors_entry *lde;
342
343
0
  lde = zend_hash_index_find_ptr(&list_destructors, res->type);
344
0
  if (lde) {
345
0
    return lde->type_name;
346
0
  } else {
347
0
    return NULL;
348
0
  }
349
0
}
350
351
ZEND_API zend_resource* zend_register_persistent_resource_ex(zend_string *key, void *rsrc_pointer, int rsrc_type)
352
0
{
353
0
  zval *zv;
354
0
  zval tmp;
355
356
0
  ZVAL_NEW_PERSISTENT_RES(&tmp, -1, rsrc_pointer, rsrc_type);
357
0
  GC_MAKE_PERSISTENT_LOCAL(Z_COUNTED(tmp));
358
0
  GC_MAKE_PERSISTENT_LOCAL(key);
359
360
0
  zv = zend_hash_update(&EG(persistent_list), key, &tmp);
361
362
0
  return Z_RES_P(zv);
363
0
}
364
365
ZEND_API zend_resource* zend_register_persistent_resource(const char *key, size_t key_len, void *rsrc_pointer, int rsrc_type)
366
0
{
367
0
  zend_string *str = zend_string_init(key, key_len, 1);
368
0
  zend_resource *ret  = zend_register_persistent_resource_ex(str, rsrc_pointer, rsrc_type);
369
370
0
  zend_string_release_ex(str, 1);
371
0
  return ret;
372
0
}