/src/php-src/Zend/zend_modules.h
Line | Count | Source (jump to first uncovered line) |
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 | | #ifndef MODULES_H |
21 | | #define MODULES_H |
22 | | |
23 | | #include "zend.h" |
24 | | #include "zend_compile.h" |
25 | | #include "zend_build.h" |
26 | | |
27 | | #define INIT_FUNC_ARGS int type, int module_number |
28 | 4.13M | #define INIT_FUNC_ARGS_PASSTHRU type, module_number |
29 | | #define SHUTDOWN_FUNC_ARGS int type, int module_number |
30 | 3.84M | #define SHUTDOWN_FUNC_ARGS_PASSTHRU type, module_number |
31 | | #define ZEND_MODULE_INFO_FUNC_ARGS zend_module_entry *zend_module |
32 | 96 | #define ZEND_MODULE_INFO_FUNC_ARGS_PASSTHRU zend_module |
33 | | |
34 | 24 | #define ZEND_MODULE_API_NO 20200804 |
35 | | #ifdef ZTS |
36 | | #define USING_ZTS 1 |
37 | | #else |
38 | | #define USING_ZTS 0 |
39 | | #endif |
40 | | |
41 | | #define STANDARD_MODULE_HEADER_EX sizeof(zend_module_entry), ZEND_MODULE_API_NO, ZEND_DEBUG, USING_ZTS |
42 | | #define STANDARD_MODULE_HEADER \ |
43 | | STANDARD_MODULE_HEADER_EX, NULL, NULL |
44 | | #define ZE2_STANDARD_MODULE_HEADER \ |
45 | | STANDARD_MODULE_HEADER_EX, ini_entries, NULL |
46 | | |
47 | 24 | #define ZEND_MODULE_BUILD_ID "API" ZEND_TOSTR(ZEND_MODULE_API_NO) ZEND_BUILD_TS ZEND_BUILD_DEBUG ZEND_BUILD_SYSTEM ZEND_BUILD_EXTRA |
48 | | |
49 | | #define STANDARD_MODULE_PROPERTIES_EX 0, 0, NULL, 0, ZEND_MODULE_BUILD_ID |
50 | | |
51 | | #define NO_MODULE_GLOBALS 0, NULL, NULL, NULL |
52 | | |
53 | | #ifdef ZTS |
54 | | # define ZEND_MODULE_GLOBALS(module_name) sizeof(zend_##module_name##_globals), &module_name##_globals_id |
55 | | #else |
56 | | # define ZEND_MODULE_GLOBALS(module_name) sizeof(zend_##module_name##_globals), &module_name##_globals |
57 | | #endif |
58 | | |
59 | | #define STANDARD_MODULE_PROPERTIES \ |
60 | | NO_MODULE_GLOBALS, NULL, STANDARD_MODULE_PROPERTIES_EX |
61 | | |
62 | 0 | #define NO_VERSION_YET NULL |
63 | | |
64 | 14.0M | #define MODULE_PERSISTENT 1 |
65 | 0 | #define MODULE_TEMPORARY 2 |
66 | | |
67 | | struct _zend_ini_entry; |
68 | | typedef struct _zend_module_entry zend_module_entry; |
69 | | typedef struct _zend_module_dep zend_module_dep; |
70 | | |
71 | | struct _zend_module_entry { |
72 | | unsigned short size; |
73 | | unsigned int zend_api; |
74 | | unsigned char zend_debug; |
75 | | unsigned char zts; |
76 | | const struct _zend_ini_entry *ini_entry; |
77 | | const struct _zend_module_dep *deps; |
78 | | const char *name; |
79 | | const struct _zend_function_entry *functions; |
80 | | zend_result (*module_startup_func)(INIT_FUNC_ARGS); |
81 | | zend_result (*module_shutdown_func)(SHUTDOWN_FUNC_ARGS); |
82 | | zend_result (*request_startup_func)(INIT_FUNC_ARGS); |
83 | | zend_result (*request_shutdown_func)(SHUTDOWN_FUNC_ARGS); |
84 | | void (*info_func)(ZEND_MODULE_INFO_FUNC_ARGS); |
85 | | const char *version; |
86 | | size_t globals_size; |
87 | | #ifdef ZTS |
88 | | ts_rsrc_id* globals_id_ptr; |
89 | | #else |
90 | | void* globals_ptr; |
91 | | #endif |
92 | | void (*globals_ctor)(void *global); |
93 | | void (*globals_dtor)(void *global); |
94 | | int (*post_deactivate_func)(void); |
95 | | int module_started; |
96 | | unsigned char type; |
97 | | void *handle; |
98 | | int module_number; |
99 | | const char *build_id; |
100 | | }; |
101 | | |
102 | 82.9k | #define MODULE_DEP_REQUIRED 1 |
103 | 22.6k | #define MODULE_DEP_CONFLICTS 2 |
104 | 15.0k | #define MODULE_DEP_OPTIONAL 3 |
105 | | |
106 | | #define ZEND_MOD_REQUIRED_EX(name, rel, ver) { name, rel, ver, MODULE_DEP_REQUIRED }, |
107 | | #define ZEND_MOD_CONFLICTS_EX(name, rel, ver) { name, rel, ver, MODULE_DEP_CONFLICTS }, |
108 | | #define ZEND_MOD_OPTIONAL_EX(name, rel, ver) { name, rel, ver, MODULE_DEP_OPTIONAL }, |
109 | | |
110 | | #define ZEND_MOD_REQUIRED(name) ZEND_MOD_REQUIRED_EX(name, NULL, NULL) |
111 | | #define ZEND_MOD_CONFLICTS(name) ZEND_MOD_CONFLICTS_EX(name, NULL, NULL) |
112 | | #define ZEND_MOD_OPTIONAL(name) ZEND_MOD_OPTIONAL_EX(name, NULL, NULL) |
113 | | |
114 | | #define ZEND_MOD_END { NULL, NULL, NULL, 0 } |
115 | | |
116 | | struct _zend_module_dep { |
117 | | const char *name; /* module name */ |
118 | | const char *rel; /* version relationship: NULL (exists), lt|le|eq|ge|gt (to given version) */ |
119 | | const char *version; /* version */ |
120 | | unsigned char type; /* dependency type */ |
121 | | }; |
122 | | |
123 | | BEGIN_EXTERN_C() |
124 | | extern ZEND_API HashTable module_registry; |
125 | | |
126 | | void module_destructor(zend_module_entry *module); |
127 | | int module_registry_request_startup(zend_module_entry *module); |
128 | | int module_registry_unload_temp(const zend_module_entry *module); |
129 | | END_EXTERN_C() |
130 | | |
131 | | #endif |