Coverage Report

Created: 2025-08-28 07:07

/src/openssl34/fuzz/hashtable.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2024 The OpenSSL Project Authors. All Rights Reserved.
3
 *
4
 * Licensed under the Apache License 2.0 (the "License");
5
 * you may not use this file except in compliance with the License.
6
 * You may obtain a copy of the License at
7
 * https://www.openssl.org/source/license.html
8
 * or in the file LICENSE in the source distribution.
9
 */
10
11
/*
12
 * Test hashtable operation.
13
 */
14
#include <limits.h>
15
#include <openssl/err.h>
16
#include <openssl/bio.h>
17
#include <internal/common.h>
18
#include <internal/hashtable.h>
19
#include "fuzzer.h"
20
21
/*
22
 * Make the key space very small here to make lookups
23
 * easy to predict for the purposes of validation
24
 * A two byte key gives us 65536 possible entries
25
 * so we can allocate a flat table to compare to
26
 */
27
HT_START_KEY_DEFN(fuzzer_key)
28
HT_DEF_KEY_FIELD(fuzzkey, uint16_t)
29
HT_END_KEY_DEFN(FUZZER_KEY)
30
31
279
#define FZ_FLAG_ALLOCATED (1 << 0)
32
typedef struct fuzzer_value_st {
33
    uint64_t flags;
34
    uint64_t value;
35
} FUZZER_VALUE;
36
37
IMPLEMENT_HT_VALUE_TYPE_FNS(FUZZER_VALUE, fz, static)
38
39
static size_t skipped_values = 0;
40
static size_t inserts = 0;
41
static size_t replacements = 0;
42
static size_t deletes = 0;
43
static size_t flushes = 0;
44
static size_t lookups = 0;
45
static size_t foreaches = 0;
46
static size_t filters = 0;
47
static int valfound;
48
49
static FUZZER_VALUE *prediction_table = NULL;
50
static HT *fuzzer_table = NULL;
51
52
/*
53
 * Operational values
54
 */
55
57
#define OP_INSERT  0
56
28
#define OP_DELETE  1
57
39
#define OP_LOOKUP  2
58
13
#define OP_FLUSH   3
59
33
#define OP_FOREACH 4
60
26
#define OP_FILTER  5
61
196
#define OP_END     6 
62
63
196
#define OP_MASK 0x3f
64
117
#define INSERT_REPLACE_MASK 0x40
65
196
#define OPERATION(x) (((x) & OP_MASK) % OP_END)
66
117
#define IS_REPLACE(x) ((x) & INSERT_REPLACE_MASK)
67
68
static int table_iterator(HT_VALUE *v, void *arg)
69
256
{
70
256
    uint16_t keyval = (*(uint16_t *)arg);
71
256
    FUZZER_VALUE *f = ossl_ht_fz_FUZZER_VALUE_from_value(v);
72
73
256
    if (f != NULL && f == &prediction_table[keyval]) {
74
4
        valfound = 1;
75
4
        return 0;
76
4
    }
77
78
252
    return 1;
79
256
}
80
81
static int filter_iterator(HT_VALUE *v, void *arg)
82
157
{
83
157
    uint16_t keyval = (*(uint16_t *)arg);
84
157
    FUZZER_VALUE *f = ossl_ht_fz_FUZZER_VALUE_from_value(v);
85
86
157
    if (f != NULL && f == &prediction_table[keyval])
87
2
        return 1;
88
89
155
    return 0;
90
157
}
91
92
static void fuzz_free_cb(HT_VALUE *v)
93
39
{
94
39
    FUZZER_VALUE *f = ossl_ht_fz_FUZZER_VALUE_from_value(v);
95
96
39
    if (f != NULL)
97
39
        f->flags &= ~FZ_FLAG_ALLOCATED;
98
39
}
99
100
int FuzzerInitialize(int *argc, char ***argv)
101
6
{
102
6
    HT_CONFIG fuzz_conf = {NULL, fuzz_free_cb, NULL, 0, 1};
103
104
6
    OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CRYPTO_STRINGS, NULL);
105
6
    ERR_clear_error();
106
6
    prediction_table = OPENSSL_zalloc(sizeof(FUZZER_VALUE) * 65537);
107
6
    if (prediction_table == NULL)
108
0
        return -1;
109
6
    fuzzer_table = ossl_ht_new(&fuzz_conf);
110
6
    if (fuzzer_table == NULL) {
111
0
        OPENSSL_free(prediction_table);
112
0
        return -1;
113
0
    }
114
115
6
    return 0;
116
6
}
117
118
int FuzzerTestOneInput(const uint8_t *buf, size_t len)
119
208
{
120
208
    uint8_t op_flags;
121
208
    uint16_t keyval;
122
208
    int rc;
123
208
    int rc_prediction = 1;
124
208
    size_t i;
125
208
    FUZZER_VALUE *valptr, *lval;
126
208
    FUZZER_KEY key;
127
208
    HT_VALUE *v = NULL;
128
208
    HT_VALUE tv;
129
208
    HT_VALUE_LIST *htvlist;
130
131
    /*
132
     * We need at least 11 bytes to be able to do anything here
133
     * 1 byte to detect the operation to perform, 2 bytes
134
     * for the lookup key, and 8 bytes of value
135
     */
136
208
    if (len < 11) {
137
12
        skipped_values++;
138
12
        return -1;
139
12
    }
140
141
    /*
142
     * parse out our operation flags and key
143
     */
144
196
    op_flags = buf[0];
145
196
    memcpy(&keyval, &buf[1], sizeof(uint16_t));
146
147
    /*
148
     * Initialize our key
149
     */
150
196
    HT_INIT_KEY(&key);
151
152
    /*
153
     * Now do our operation
154
     */
155
196
    switch(OPERATION(op_flags)) {
156
57
    case OP_INSERT:
157
57
        valptr = &prediction_table[keyval];
158
159
        /* reset our key */
160
57
        HT_KEY_RESET(&key);
161
162
        /* set the proper key value */
163
57
        HT_SET_KEY_FIELD(&key, fuzzkey, keyval);
164
165
        /* lock the table */
166
57
        ossl_ht_write_lock(fuzzer_table);
167
168
        /*
169
         * If the value to insert is already allocated
170
         * then we expect a conflict in the insert
171
         * i.e. we predict a return code of 0 instead
172
         * of 1. On replacement, we expect it to succeed
173
         * always
174
         */
175
57
        if (valptr->flags & FZ_FLAG_ALLOCATED) {
176
10
            if (!IS_REPLACE(op_flags))
177
7
                rc_prediction = 0;
178
10
        }
179
180
57
        memcpy(&valptr->value, &buf[3], sizeof(uint64_t));
181
        /*
182
         * do the insert/replace
183
         */
184
57
        if (IS_REPLACE(op_flags))
185
17
            rc = ossl_ht_fz_FUZZER_VALUE_insert(fuzzer_table, TO_HT_KEY(&key),
186
17
                                                valptr, &lval);
187
40
        else
188
40
            rc = ossl_ht_fz_FUZZER_VALUE_insert(fuzzer_table, TO_HT_KEY(&key),
189
40
                                                valptr, NULL);
190
191
57
        if (rc == -1)
192
            /* failed to grow the hash table due to too many collisions */
193
0
            break;
194
195
        /*
196
         * mark the entry as being allocated
197
         */
198
57
        valptr->flags |= FZ_FLAG_ALLOCATED;
199
200
        /*
201
         * unlock the table
202
         */
203
57
        ossl_ht_write_unlock(fuzzer_table);
204
205
        /*
206
         * Now check to make sure we did the right thing
207
         */
208
57
        OPENSSL_assert(rc == rc_prediction);
209
210
        /*
211
         * successful insertion if there wasn't a conflict
212
         */
213
57
        if (rc_prediction == 1)
214
50
            IS_REPLACE(op_flags) ? replacements++ : inserts++;
215
57
        break;
216
217
28
    case OP_DELETE:
218
28
        valptr = &prediction_table[keyval];
219
220
        /* reset our key */
221
28
        HT_KEY_RESET(&key);
222
223
        /* set the proper key value */
224
28
        HT_SET_KEY_FIELD(&key, fuzzkey, keyval);
225
226
        /* lock the table */
227
28
        ossl_ht_write_lock(fuzzer_table);
228
229
        /*
230
         * If the value to delete is not already allocated
231
         * then we expect a miss in the delete
232
         * i.e. we predict a return code of 0 instead
233
         * of 1
234
         */
235
28
        if (!(valptr->flags & FZ_FLAG_ALLOCATED))
236
20
            rc_prediction = 0;
237
238
        /*
239
         * do the delete
240
         */
241
28
        rc = ossl_ht_delete(fuzzer_table, TO_HT_KEY(&key));
242
243
        /*
244
         * unlock the table
245
         */
246
28
        ossl_ht_write_unlock(fuzzer_table);
247
248
        /*
249
         * Now check to make sure we did the right thing
250
         */
251
28
        OPENSSL_assert(rc == rc_prediction);
252
253
        /*
254
         * once the unlock is done, the table rcu will have synced
255
         * meaning the free function has run, so we can confirm now
256
         * that the valptr is no longer allocated
257
         */
258
28
        OPENSSL_assert(!(valptr->flags & FZ_FLAG_ALLOCATED));
259
260
        /*
261
         * successful deletion if there wasn't a conflict
262
         */
263
28
        if (rc_prediction == 1)
264
8
            deletes++;
265
266
28
        break;
267
268
39
    case OP_LOOKUP:
269
39
        valptr = &prediction_table[keyval];
270
39
        lval = NULL;
271
272
        /* reset our key */
273
39
        HT_KEY_RESET(&key);
274
275
        /* set the proper key value */
276
39
        HT_SET_KEY_FIELD(&key, fuzzkey, keyval);
277
278
        /* lock the table for reading */
279
39
        ossl_ht_read_lock(fuzzer_table);
280
281
        /*
282
         * If the value to find is not already allocated
283
         * then we expect a miss in the lookup
284
         * i.e. we predict a return code of NULL instead
285
         * of a pointer
286
         */
287
39
        if (!(valptr->flags & FZ_FLAG_ALLOCATED))
288
36
            valptr = NULL;
289
290
        /*
291
         * do the lookup
292
         */
293
39
        lval = ossl_ht_fz_FUZZER_VALUE_get(fuzzer_table, TO_HT_KEY(&key), &v);
294
295
        /*
296
         * unlock the table
297
         */
298
39
        ossl_ht_read_unlock(fuzzer_table);
299
300
        /*
301
         * Now check to make sure we did the right thing
302
         */
303
39
        OPENSSL_assert(lval == valptr);
304
305
        /*
306
         * if we expect a positive lookup, make sure that
307
         * we can use the _type and to_value functions
308
         */
309
39
        if (valptr != NULL) {
310
3
            OPENSSL_assert(ossl_ht_fz_FUZZER_VALUE_type(v) == 1);
311
312
3
            v = ossl_ht_fz_FUZZER_VALUE_to_value(lval, &tv);
313
3
            OPENSSL_assert(v->value == lval);
314
3
        }
315
316
        /*
317
         * successful lookup if we didn't expect a miss
318
         */
319
39
        if (valptr != NULL)
320
3
            lookups++;
321
322
39
        break;
323
324
13
    case OP_FLUSH:
325
        /*
326
         * only flush the table rarely 
327
         */
328
13
        if ((flushes % 100000) != 1) {
329
11
            skipped_values++;
330
11
            flushes++;
331
11
            return 0;
332
11
        }
333
334
        /*
335
         * lock the table
336
         */
337
2
        ossl_ht_write_lock(fuzzer_table);
338
2
        ossl_ht_flush(fuzzer_table);
339
2
        ossl_ht_write_unlock(fuzzer_table);
340
341
        /*
342
         * now check to make sure everything is free
343
         */
344
131k
       for (i = 0; i < USHRT_MAX; i++)
345
131k
            OPENSSL_assert((prediction_table[i].flags & FZ_FLAG_ALLOCATED) == 0);
346
347
        /* good flush */
348
2
        flushes++;
349
2
        break;
350
351
33
    case OP_FOREACH:
352
33
        valfound = 0;
353
33
        valptr = &prediction_table[keyval];
354
355
33
        rc_prediction = 0;
356
33
        if (valptr->flags & FZ_FLAG_ALLOCATED)
357
1
            rc_prediction = 1;
358
359
33
        ossl_ht_foreach_until(fuzzer_table, table_iterator, &keyval);
360
361
33
        OPENSSL_assert(valfound == rc_prediction);
362
363
33
        foreaches++;
364
33
        break;
365
366
26
    case OP_FILTER:
367
26
        valptr = &prediction_table[keyval];
368
369
26
        rc_prediction = 0;
370
26
        if (valptr->flags & FZ_FLAG_ALLOCATED)
371
1
            rc_prediction = 1;
372
373
26
        htvlist = ossl_ht_filter(fuzzer_table, 1, filter_iterator, &keyval);
374
375
26
        OPENSSL_assert(htvlist->list_len == (size_t)rc_prediction);
376
377
26
        ossl_ht_value_list_free(htvlist);
378
26
        filters++;
379
26
        break;
380
381
0
    default:
382
0
        return -1;
383
196
    }
384
385
185
    return 0;
386
196
}
387
388
void FuzzerCleanup(void)
389
0
{
390
0
    ossl_ht_free(fuzzer_table);
391
0
    OPENSSL_free(prediction_table);
392
0
    OPENSSL_cleanup();
393
0
}