From c5b5bd910507520f7974a156a1de9d187f23bc2f Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sun, 8 Jan 2017 15:28:37 -0800 Subject: New ISAAC pRNG. This replaces other local hacks for random data. Platforms must seed the pRNGs by offering an nni_plat_seed_prng() routine. Implementations for POSIX using various options (including the /dev/urandom device) are supplied. --- src/core/random.h | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 src/core/random.h (limited to 'src/core/random.h') diff --git a/src/core/random.h b/src/core/random.h new file mode 100644 index 00000000..cf365380 --- /dev/null +++ b/src/core/random.h @@ -0,0 +1,26 @@ +// +// Copyright 2017 Garrett D'Amore +// +// This software is supplied under the terms of the MIT License, a +// copy of which should be located in the distribution where this +// file was obtained (LICENSE.txt). A copy of the license may also be +// found online at https://opensource.org/licenses/MIT. +// + +#ifndef CORE_RANDOM_H +#define CORE_RANDOM_H + +// nni_random_init initializes the pRNG subsystem. This includes obtaining +// suitable seeding material from the platform. +extern int nni_random_init(void); + +// nni_random_fini destroys the pRNG subsystem. +extern void nni_random_fini(void); + +// nni_random returns a random 32-bit integer. Note that this routine is +// thread-safe/reentrant. The pRNG is very robust, should be of crypto +// quality. However, its usefulness for cryptography will be determined +// by the quality of the seeding material provided by the platform. +extern uint32_t nni_random(void); + +#endif // CORE_RANDOM_H -- cgit v1.2.3-70-g09d2