1 /*  uECC_platform_specific.h - Interface to platform specific functions*/
2 
3 /* Copyright (c) 2014, Kenneth MacKay
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions are met:
8  *  * Redistributions of source code must retain the above copyright notice,
9  *    this list of conditions and the following disclaimer.
10  *  * Redistributions in binary form must reproduce the above copyright notice,
11  *    this list of conditions and the following disclaimer in the documentation
12  *    and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
15  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
18  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24  * POSSIBILITY OF SUCH DAMAGE.*/
25 
26 /*
27  *  Copyright (C) 2017 by Intel Corporation, All Rights Reserved.
28  *
29  *  Redistribution and use in source and binary forms, with or without
30  *  modification, are permitted provided that the following conditions are met:
31  *
32  *    - Redistributions of source code must retain the above copyright notice,
33  *     this list of conditions and the following disclaimer.
34  *
35  *    - Redistributions in binary form must reproduce the above copyright
36  *    notice, this list of conditions and the following disclaimer in the
37  *    documentation and/or other materials provided with the distribution.
38  *
39  *    - Neither the name of Intel Corporation nor the names of its contributors
40  *    may be used to endorse or promote products derived from this software
41  *    without specific prior written permission.
42  *
43  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
44  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46  *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
47  *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
48  *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
49  *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
50  *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
51  *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
52  *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
53  *  POSSIBILITY OF SUCH DAMAGE.
54  *
55  *  uECC_platform_specific.h -- Interface to platform specific functions
56  */
57 
58 #ifndef __UECC_PLATFORM_SPECIFIC_H_
59 #define __UECC_PLATFORM_SPECIFIC_H_
60 
61 /*
62  * The RNG function should fill 'size' random bytes into 'dest'. It should
63  * return 1 if 'dest' was filled with random data, or 0 if the random data could
64  * not be generated. The filled-in values should be either truly random, or from
65  * a cryptographically-secure PRNG.
66  *
67  * A cryptographically-secure PRNG function must be set (using uECC_set_rng())
68  * before calling uECC_make_key() or uECC_sign().
69  *
70  * Setting a cryptographically-secure PRNG function improves the resistance to
71  * side-channel attacks for uECC_shared_secret().
72  *
73  * A correct PRNG function is set by default (default_RNG_defined = 1) and works
74  * for some platforms, such as Unix and Linux. For other platforms, you may need
75  * to provide another PRNG function.
76 */
77 #define default_RNG_defined 1
78 
79 int default_CSPRNG(uint8_t *dest, unsigned int size);
80 
81 #endif /* __UECC_PLATFORM_SPECIFIC_H_ */
82