Sync usage with man page.
[netbsd-mini2440.git] / external / bsd / ntp / dist / lib / isc / random.c
blobbd30530a1e87474def5b9806d6cdf97a006c1ea6
1 /* $NetBSD$ */
3 /*
4 * Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
5 * Copyright (C) 1999-2003 Internet Software Consortium.
7 * Permission to use, copy, modify, and/or distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
11 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
12 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
13 * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
14 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
16 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17 * PERFORMANCE OF THIS SOFTWARE.
20 /* Id: random.c,v 1.25 2007/06/19 23:47:17 tbox Exp */
22 /*! \file */
24 #include <config.h>
26 #include <stdlib.h>
27 #include <time.h> /* Required for time(). */
28 #ifdef HAVE_SYS_TYPES_H
29 #include <sys/types.h>
30 #endif
31 #ifdef HAVE_UNISTD_H
32 #include <unistd.h>
33 #endif
35 #include <isc/mutex.h>
36 #include <isc/once.h>
37 #include <isc/random.h>
38 #include <isc/string.h>
39 #include <isc/util.h>
41 static isc_once_t once = ISC_ONCE_INIT;
43 static void
44 initialize_rand(void)
46 #ifndef HAVE_ARC4RANDOM
47 unsigned int pid = getpid();
50 * The low bits of pid generally change faster.
51 * Xor them with the high bits of time which change slowly.
53 pid = ((pid << 16) & 0xffff0000) | ((pid >> 16) & 0xffff);
55 srand(time(NULL) ^ pid);
56 #endif
59 static void
60 initialize(void)
62 RUNTIME_CHECK(isc_once_do(&once, initialize_rand) == ISC_R_SUCCESS);
65 void
66 isc_random_seed(isc_uint32_t seed)
68 initialize();
70 #ifndef HAVE_ARC4RANDOM
71 srand(seed);
72 #else
73 arc4random_addrandom((u_char *) &seed, sizeof(isc_uint32_t));
74 #endif
77 void
78 isc_random_get(isc_uint32_t *val)
80 REQUIRE(val != NULL);
82 initialize();
84 #ifndef HAVE_ARC4RANDOM
86 * rand()'s lower bits are not random.
87 * rand()'s upper bit is zero.
89 *val = ((rand() >> 4) & 0xffff) | ((rand() << 12) & 0xffff0000);
90 #else
91 *val = arc4random();
92 #endif
95 isc_uint32_t
96 isc_random_jitter(isc_uint32_t max, isc_uint32_t jitter) {
97 REQUIRE(jitter < max);
98 if (jitter == 0)
99 return (max);
100 else
101 #ifndef HAVE_ARC4RANDOM
102 return (max - rand() % jitter);
103 #else
104 return (max - arc4random() % jitter);
105 #endif