1 /*
2 +----------------------------------------------------------------------+
3 | Zend OPcache |
4 +----------------------------------------------------------------------+
5 | Copyright (c) The PHP Group |
6 +----------------------------------------------------------------------+
7 | This source file is subject to version 3.01 of the PHP 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 | https://www.php.net/license/3_01.txt |
11 | If you did not receive a copy of the PHP license and are unable to |
12 | obtain it through the world-wide-web, please send a note to |
13 | license@php.net so we can mail you a copy immediately. |
14 +----------------------------------------------------------------------+
15 | Authors: Andi Gutmans <andi@php.net> |
16 | Zeev Suraski <zeev@php.net> |
17 | Stanislav Malyshev <stas@zend.com> |
18 | Dmitry Stogov <dmitry@php.net> |
19 +----------------------------------------------------------------------+
20 */
21
22 #ifndef ZEND_ACCELERATOR_HASH_H
23 #define ZEND_ACCELERATOR_HASH_H
24
25 #include "zend.h"
26
27 /*
28 zend_accel_hash - is a hash table allocated in shared memory and
29 distributed across simultaneously running processes. The hash tables have
30 fixed sizen selected during construction by zend_accel_hash_init(). All the
31 hash entries are preallocated in the 'hash_entries' array. 'num_entries' is
32 initialized by zero and grows when new data is added.
33 zend_accel_hash_update() just takes the next entry from 'hash_entries'
34 array and puts it into appropriate place of 'hash_table'.
35 Hash collisions are resolved by separate chaining with linked lists,
36 however, entries are still taken from the same 'hash_entries' array.
37 'key' and 'data' passed to zend_accel_hash_update() must be already
38 allocated in shared memory. Few keys may be resolved to the same data.
39 using 'indirect' entries, that point to other entries ('data' is actually
40 a pointer to another zend_accel_hash_entry).
41 zend_accel_hash_update() requires exclusive lock, however,
42 zend_accel_hash_find() does not.
43 */
44
45 typedef struct _zend_accel_hash_entry zend_accel_hash_entry;
46
47 struct _zend_accel_hash_entry {
48 zend_ulong hash_value;
49 zend_string *key;
50 zend_accel_hash_entry *next;
51 void *data;
52 bool indirect;
53 };
54
55 typedef struct _zend_accel_hash {
56 zend_accel_hash_entry **hash_table;
57 zend_accel_hash_entry *hash_entries;
58 uint32_t num_entries;
59 uint32_t max_num_entries;
60 uint32_t num_direct_entries;
61 } zend_accel_hash;
62
63 void zend_accel_hash_init(zend_accel_hash *accel_hash, uint32_t hash_size);
64 void zend_accel_hash_clean(zend_accel_hash *accel_hash);
65
66 zend_accel_hash_entry* zend_accel_hash_update(
67 zend_accel_hash *accel_hash,
68 zend_string *key,
69 bool indirect,
70 void *data);
71
72 void* zend_accel_hash_find(
73 zend_accel_hash *accel_hash,
74 zend_string *key);
75
76 zend_accel_hash_entry* zend_accel_hash_find_entry(
77 zend_accel_hash *accel_hash,
78 zend_string *key);
79
80 int zend_accel_hash_unlink(
81 zend_accel_hash *accel_hash,
82 zend_string *key);
83
zend_accel_hash_is_full(zend_accel_hash * accel_hash)84 static inline bool zend_accel_hash_is_full(zend_accel_hash *accel_hash)
85 {
86 if (accel_hash->num_entries == accel_hash->max_num_entries) {
87 return 1;
88 } else {
89 return 0;
90 }
91 }
92
93 #endif /* ZEND_ACCELERATOR_HASH_H */
94