summaryrefslogtreecommitdiff
path: root/support/dktools/dk-pwg-rnd.h
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/dktools/dk-pwg-rnd.h
Initial commit
Diffstat (limited to 'support/dktools/dk-pwg-rnd.h')
-rw-r--r--support/dktools/dk-pwg-rnd.h129
1 files changed, 129 insertions, 0 deletions
diff --git a/support/dktools/dk-pwg-rnd.h b/support/dktools/dk-pwg-rnd.h
new file mode 100644
index 0000000000..4140297103
--- /dev/null
+++ b/support/dktools/dk-pwg-rnd.h
@@ -0,0 +1,129 @@
+/*
+ WARNING: This file was generated by dkct.
+ Changes you make here will be lost if dkct is run again!
+ You should modify the original source and run dkct on it.
+ Original source: dk-pwg-rnd.ctr
+*/
+
+/*
+Copyright (C) 2015-2017, Dirk Krause
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+ this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above opyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+* Neither the name of the author nor the names of contributors may be used
+ to endorse or promote products derived from this software without specific
+ prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef DK_PWG_RND_H_INCLUDED
+/** Avoid multiple inclusions. */
+#define DK_PWG_RND_H_INCLUDED 1
+
+
+#line 10 "dk-pwg-rnd.ctr"
+
+/** @file dk4rnd.h Random number generation.
+
+NOT A GOOD IDEA: WE EITHER NEED CRYPTOGRAPHICALLY STRONG RANDOM DATA
+OR LIGHTWEIGHT RANDOM DATA FOR GAMES OR SIMULATIONS.
+ONE SIZE DOESN'T FIT ALL!
+*/
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Retrieve PRNG type.
+ @return PRNG type.
+*/
+int
+dk4rnd_get_prng_type(void);
+
+/** Initialize (seed) PRNG.
+ @param erp Error report, may be NULL.
+ @return 1 on success, 0 on error.
+
+ Error codes:
+ - DK4_E_NOT_FOUND<br>
+ if the function failed to obtain seed data.
+*/
+int
+dk4rnd_init(dk4_er_t *erp);
+
+/** Retrieve random bytes.
+ @param bptr Pointer to destination buffer.
+ @param bs Destination buffer size.
+ @param erp Error report, may be NULL.
+ @return 1 on success, 0 on error.
+
+ Error codes:
+ - DK4_E_INVALID_ARGUMENTS<br>
+ if bptr is NULL or bs is either 0 or too large,
+ - DK4_E_SYNTAX<br>
+ if the PRNG was not yet initialized successfully,
+ - DK4_E_NOT_FOUND<br>
+ if the function failed to obtain random data.
+*/
+int
+dk4rnd_get_data(void *bptr, size_t bs, dk4_er_t *erp);
+
+/** Clean up PRNG.
+*/
+void
+dk4rnd_cleanup(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+/** Random number generators.
+*/
+enum {
+ /** Use rand() function.
+ */
+ DK4_PRNG_SIMPLE = 1,
+
+ /** Use nrand48() function.
+ */
+ DK4_PRNG_RAND48 = 2,
+
+ /** Use initstate()/setstate() functions.
+ */
+ DK4_PRNG_STATE = 4,
+
+ /** Use OpenSSL PRNG.
+ */
+ DK4_PRNG_OPENSSL = 8,
+
+ /** All the PRNGs above.
+ */
+ DK4_PRNG_ALL = (
+ DK4_PRNG_SIMPLE
+ | DK4_PRNG_RAND48
+ | DK4_PRNG_STATE
+ | DK4_PRNG_OPENSSL
+ )
+
+};
+
+
+#endif