wolfssl: Add wolfSSL plugin for cryptographic implementations
[strongswan.git] / src / libstrongswan / plugins / wolfssl / wolfssl_rng.h
1 /*
2 * Copyright (C) 2019 Sean Parkinson, wolfSSL Inc.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a copy
5 * of this software and associated documentation files (the "Software"), to deal
6 * in the Software without restriction, including without limitation the rights
7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 * copies of the Software, and to permit persons to whom the Software is
9 * furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20 * THE SOFTWARE.
21 */
22
23 /**
24 * @defgroup wolfssl_rng wolfssl_rng
25 * @{ @ingroup wolfssl_p
26 */
27
28 #ifndef WOLFSSL_RNG_H_
29 #define WOLFSSL_RNG_H_
30
31 #include <library.h>
32
33 typedef struct wolfssl_rng_t wolfssl_rng_t;
34
35 /**
36 * Implementation of random number using wolfSSL.
37 */
38 struct wolfssl_rng_t {
39
40 /**
41 * Implements rng_t interface.
42 */
43 rng_t rng;
44 };
45
46 /**
47 * Constructor to create wolfssl_rng_t.
48 *
49 * @param quality quality of randomness
50 * @return wolfssl_rng_t
51 */
52 wolfssl_rng_t *wolfssl_rng_create(rng_quality_t quality);
53
54 /**
55 * Initializes the global random number generator.
56 *
57 * @return TRUE on success and FALSE on failure.
58 */
59 int wolfssl_rng_global_init();
60
61 /**
62 * Finalizes the global random number generator.
63 */
64 void wolfssl_rng_global_final();
65
66 #endif /** WOLFSSL_RNG_H_ @}*/