1*ff825849SDag-Erling Smørgrav /* $OpenBSD: arc4random_uniform.c,v 1.1 2014/07/12 13:24:54 deraadt Exp $ */
2*ff825849SDag-Erling Smørgrav
3*ff825849SDag-Erling Smørgrav /*
4*ff825849SDag-Erling Smørgrav * Copyright (c) 2008, Damien Miller <djm@openbsd.org>
5*ff825849SDag-Erling Smørgrav *
6*ff825849SDag-Erling Smørgrav * Permission to use, copy, modify, and distribute this software for any
7*ff825849SDag-Erling Smørgrav * purpose with or without fee is hereby granted, provided that the above
8*ff825849SDag-Erling Smørgrav * copyright notice and this permission notice appear in all copies.
9*ff825849SDag-Erling Smørgrav *
10*ff825849SDag-Erling Smørgrav * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11*ff825849SDag-Erling Smørgrav * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12*ff825849SDag-Erling Smørgrav * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13*ff825849SDag-Erling Smørgrav * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14*ff825849SDag-Erling Smørgrav * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15*ff825849SDag-Erling Smørgrav * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16*ff825849SDag-Erling Smørgrav * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17*ff825849SDag-Erling Smørgrav */
18*ff825849SDag-Erling Smørgrav
19*ff825849SDag-Erling Smørgrav #include "config.h"
20*ff825849SDag-Erling Smørgrav #include <sys/types.h>
21*ff825849SDag-Erling Smørgrav #include <stdlib.h>
22*ff825849SDag-Erling Smørgrav
23*ff825849SDag-Erling Smørgrav /*
24*ff825849SDag-Erling Smørgrav * Calculate a uniformly distributed random number less than upper_bound
25*ff825849SDag-Erling Smørgrav * avoiding "modulo bias".
26*ff825849SDag-Erling Smørgrav *
27*ff825849SDag-Erling Smørgrav * Uniformity is achieved by generating new random numbers until the one
28*ff825849SDag-Erling Smørgrav * returned is outside the range [0, 2**32 % upper_bound). This
29*ff825849SDag-Erling Smørgrav * guarantees the selected random number will be inside
30*ff825849SDag-Erling Smørgrav * [2**32 % upper_bound, 2**32) which maps back to [0, upper_bound)
31*ff825849SDag-Erling Smørgrav * after reduction modulo upper_bound.
32*ff825849SDag-Erling Smørgrav */
33*ff825849SDag-Erling Smørgrav uint32_t
arc4random_uniform(uint32_t upper_bound)34*ff825849SDag-Erling Smørgrav arc4random_uniform(uint32_t upper_bound)
35*ff825849SDag-Erling Smørgrav {
36*ff825849SDag-Erling Smørgrav uint32_t r, min;
37*ff825849SDag-Erling Smørgrav
38*ff825849SDag-Erling Smørgrav if (upper_bound < 2)
39*ff825849SDag-Erling Smørgrav return 0;
40*ff825849SDag-Erling Smørgrav
41*ff825849SDag-Erling Smørgrav /* 2**32 % x == (2**32 - x) % x */
42*ff825849SDag-Erling Smørgrav min = -upper_bound % upper_bound;
43*ff825849SDag-Erling Smørgrav
44*ff825849SDag-Erling Smørgrav /*
45*ff825849SDag-Erling Smørgrav * This could theoretically loop forever but each retry has
46*ff825849SDag-Erling Smørgrav * p > 0.5 (worst case, usually far better) of selecting a
47*ff825849SDag-Erling Smørgrav * number inside the range we need, so it should rarely need
48*ff825849SDag-Erling Smørgrav * to re-roll.
49*ff825849SDag-Erling Smørgrav */
50*ff825849SDag-Erling Smørgrav for (;;) {
51*ff825849SDag-Erling Smørgrav r = arc4random();
52*ff825849SDag-Erling Smørgrav if (r >= min)
53*ff825849SDag-Erling Smørgrav break;
54*ff825849SDag-Erling Smørgrav }
55*ff825849SDag-Erling Smørgrav
56*ff825849SDag-Erling Smørgrav return r % upper_bound;
57*ff825849SDag-Erling Smørgrav }
58