2 * Simple random number generator for testing.
3 * Copyright © 2022-2023 Nick Bowler
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <https://www.gnu.org/licenses/>.
18 * The RNG implementation is adapted from xoshiro256+ and splitmix64
19 * by David Blackman and Sebastiano Vigna, originally distributed under
20 * the Creative Commons Zero public domain dedication.
33 #define B64(x) ((x) & 0xffffffffffffffff)
36 unsigned long long state[4];
39 /* Rotate val left by n bits. The behaviour is undefined if n is zero. */
40 static unsigned long long rot_left64(unsigned long long val, int n)
42 return B64( (val << n) | (val >> (64 - n)) );
45 static unsigned long long xoshiro256p(unsigned long long *s)
47 unsigned long long tmp, ret;
49 ret = B64(s[0] + s[3]);
50 tmp = B64(s[1] << 17);
57 s[3] = rot_left64(s[3], 45);
62 static unsigned long long splitmix64(unsigned long long *state)
66 z = B64(*state += 0x9e3779b97f4a7c15);
67 z = B64((z ^ (z >> 30)) * 0xbf58476d1ce4e5b9);
68 z = B64((z ^ (z >> 27)) * 0x94d049bb133111eb);
74 # define STRTOULL strtoull
76 /* HP-UX 11 has __strtoull in <inttypes.h> */
77 # define STRTOULL __strtoull
80 * Just fall back to strtoul -- in the worst case we just lose the ability
81 * to set all 64 bits of the seed.
83 # define STRTOULL strtoul
86 struct test_rng *test_rng_alloc(const char *seed_str)
88 unsigned long long seed;
93 seed = STRTOULL(seed_str, &end, 0);
95 fprintf(stderr, "%s: invalid seed\n", seed_str);
97 } else if (errno != 0) {
98 fprintf(stderr, "%s: invalid seed: %s\n",
99 seed_str, strerror(errno));
103 rng = malloc_nofail(sizeof *rng);
104 rng->state[0] = splitmix64(&seed);
105 rng->state[1] = splitmix64(&seed);
106 rng->state[2] = splitmix64(&seed);
107 rng->state[3] = splitmix64(&seed);
112 void test_rng_free(struct test_rng *rng)
117 /* Calculate the least power of two greater than val, minus 1. */
118 static unsigned rng_mask(unsigned val)
125 if (UINT_MAX >= 65536)
131 unsigned test_rng_uniform_int(struct test_rng *rng, unsigned max)
133 unsigned mask = rng_mask(max-1);
134 unsigned long long val;
137 val = ( xoshiro256p(rng->state) >> 32 ) & mask;
138 } while (val >= max);