annotate sqlite/random.c @ 1597:2685ac3bd8f6 trunk

[svn] CXXFLAGS fixes by Mike Frysinger (Gentoo).
author chainsaw
date Sat, 26 Aug 2006 12:00:05 -0700
parents b6b61becdf4e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1434
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
1 /*
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
2 ** 2001 September 15
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
3 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
4 ** The author disclaims copyright to this source code. In place of
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
5 ** a legal notice, here is a blessing:
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
6 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
7 ** May you do good and not evil.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
8 ** May you find forgiveness for yourself and forgive others.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
9 ** May you share freely, never taking more than you give.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
10 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
11 *************************************************************************
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
12 ** This file contains code to implement a pseudo-random number
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
13 ** generator (PRNG) for SQLite.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
14 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
15 ** Random numbers are used by some of the database backends in order
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
16 ** to generate random integer keys for tables or random filenames.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
17 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
18 ** $Id: random.c,v 1.15 2006/01/06 14:32:20 drh Exp $
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
19 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
20 #include "sqliteInt.h"
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
21 #include "os.h"
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
22
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
23
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
24 /*
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
25 ** Get a single 8-bit random value from the RC4 PRNG. The Mutex
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
26 ** must be held while executing this routine.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
27 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
28 ** Why not just use a library random generator like lrand48() for this?
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
29 ** Because the OP_NewRowid opcode in the VDBE depends on having a very
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
30 ** good source of random numbers. The lrand48() library function may
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
31 ** well be good enough. But maybe not. Or maybe lrand48() has some
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
32 ** subtle problems on some systems that could cause problems. It is hard
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
33 ** to know. To minimize the risk of problems due to bad lrand48()
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
34 ** implementations, SQLite uses this random number generator based
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
35 ** on RC4, which we know works very well.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
36 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
37 ** (Later): Actually, OP_NewRowid does not depend on a good source of
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
38 ** randomness any more. But we will leave this code in all the same.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
39 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
40 static int randomByte(){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
41 unsigned char t;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
42
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
43 /* All threads share a single random number generator.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
44 ** This structure is the current state of the generator.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
45 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
46 static struct {
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
47 unsigned char isInit; /* True if initialized */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
48 unsigned char i, j; /* State variables */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
49 unsigned char s[256]; /* State variables */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
50 } prng;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
51
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
52 /* Initialize the state of the random number generator once,
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
53 ** the first time this routine is called. The seed value does
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
54 ** not need to contain a lot of randomness since we are not
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
55 ** trying to do secure encryption or anything like that...
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
56 **
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
57 ** Nothing in this file or anywhere else in SQLite does any kind of
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
58 ** encryption. The RC4 algorithm is being used as a PRNG (pseudo-random
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
59 ** number generator) not as an encryption device.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
60 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
61 if( !prng.isInit ){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
62 int i;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
63 char k[256];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
64 prng.j = 0;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
65 prng.i = 0;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
66 sqlite3OsRandomSeed(k);
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
67 for(i=0; i<256; i++){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
68 prng.s[i] = i;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
69 }
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
70 for(i=0; i<256; i++){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
71 prng.j += prng.s[i] + k[i];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
72 t = prng.s[prng.j];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
73 prng.s[prng.j] = prng.s[i];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
74 prng.s[i] = t;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
75 }
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
76 prng.isInit = 1;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
77 }
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
78
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
79 /* Generate and return single random byte
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
80 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
81 prng.i++;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
82 t = prng.s[prng.i];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
83 prng.j += t;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
84 prng.s[prng.i] = prng.s[prng.j];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
85 prng.s[prng.j] = t;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
86 t += prng.s[prng.i];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
87 return prng.s[t];
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
88 }
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
89
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
90 /*
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
91 ** Return N random bytes.
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
92 */
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
93 void sqlite3Randomness(int N, void *pBuf){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
94 unsigned char *zBuf = pBuf;
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
95 sqlite3OsEnterMutex();
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
96 while( N-- ){
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
97 *(zBuf++) = randomByte();
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
98 }
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
99 sqlite3OsLeaveMutex();
b6b61becdf4e [svn] - add sqlite/ directory
nenolod
parents:
diff changeset
100 }