From ee6c9722cc6d6af26ac2ddf09497fb5da35980df Mon Sep 17 00:00:00 2001
From: drh <drh@noemail.net>
Date: Mon, 3 Sep 2007 12:34:57 +0000
Subject: [PATCH] Document the fact that xRandomness is only called once from
 the default VFS. Ticket #2614. (CVS 4373)

FossilOrigin-Name: e89d4131a1b55da1a7f226d7f7b416f02f5e2c6e
---
 manifest       | 14 +++++++-------
 manifest.uuid  |  2 +-
 www/34to35.tcl | 18 ++++++++++++------
 3 files changed, 20 insertions(+), 14 deletions(-)

diff --git a/manifest b/manifest
index bbad0fc96b..d753db2f27 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Add\sa\smodule-destructor\sto\sthe\secho\smodule\s(test8.c)\sto\simprove\scode\scoverage.\s(CVS\s4372)
-D 2007-09-03T11:51:50
+C Document\sthe\sfact\sthat\sxRandomness\sis\sonly\scalled\sonce\sfrom\sthe\sdefault\sVFS.\nTicket\s#2614.\s(CVS\s4373)
+D 2007-09-03T12:34:57
 F Makefile.in bfcc303429a5d9dcd552d807ee016c77427418c3
 F Makefile.linux-gcc 65241babba6faf1152bf86574477baab19190499
 F README 9c4e2d6706bdcc3efdd773ce752a8cdab4f90028
@@ -510,7 +510,7 @@ F tool/space_used.tcl f714c41a59e326b8b9042f415b628b561bafa06b
 F tool/spaceanal.tcl f60a242a996a79d59cad6615cec83a9203e17911
 F tool/speedtest.tcl 06c76698485ccf597b9e7dbb1ac70706eb873355
 F tool/speedtest2.tcl ee2149167303ba8e95af97873c575c3e0fab58ff
-F www/34to35.tcl 5a477bf9210b324ee16bd26fc04ddd578b63b395
+F www/34to35.tcl 4f624758651931952dd6f23d0856758c8babe3b2
 F www/arch.fig d5f9752a4dbf242e9cfffffd3f5762b6c63b3bcf
 F www/arch.gif f845a64772062e82d17980a349f95f1f0b4c8054
 F www/arch.png 82ef36db1143828a7abc88b1e308a5f55d4336f4
@@ -568,7 +568,7 @@ F www/tclsqlite.tcl 8be95ee6dba05eabcd27a9d91331c803f2ce2130
 F www/vdbe.tcl 87a31ace769f20d3627a64fa1fade7fed47b90d0
 F www/version3.tcl 890248cf7b70e60c383b0e84d77d5132b3ead42b
 F www/whentouse.tcl fc46eae081251c3c181bd79c5faef8195d7991a5
-P c0ce63196458c81e0859fc8a38f2dd2145a580bc
-R e4b27aa117d92ab923ab170f9a80b4a8
-U danielk1977
-Z 8ba1b1c43d2e7301aebcb9fd4022cc57
+P e3dd3651421ee723f9b7550fc333a308a83b276d
+R e5bbccd4e7ccaddc79e4352e0f90298b
+U drh
+Z 5e24864e26a2ac7181c9f9ec2eeb72f5
diff --git a/manifest.uuid b/manifest.uuid
index dabab8615c..f865dc0339 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-e3dd3651421ee723f9b7550fc333a308a83b276d
\ No newline at end of file
+e89d4131a1b55da1a7f226d7f7b416f02f5e2c6e
\ No newline at end of file
diff --git a/www/34to35.tcl b/www/34to35.tcl
index 83c8c12f69..449ed35e46 100644
--- a/www/34to35.tcl
+++ b/www/34to35.tcl
@@ -1,7 +1,7 @@
 #
 # Run this TCL script to generate HTML for the goals.html file.
 #
-set rcsid {$Id: 34to35.tcl,v 1.1 2007/08/27 21:10:36 drh Exp $}
+set rcsid {$Id: 34to35.tcl,v 1.2 2007/09/03 12:34:57 drh Exp $}
 source common.tcl
 header {SQLite Changes From Version 3.4.2 To 3.5.0}
 
@@ -458,14 +458,20 @@ PARAGRAPH {
 }
 
 PARAGRAPH {
-  The xRandomness method is used once by the first database connection
-  that is opened.  xRandomness should return high-quality randomness
-  that SQLite will used to seeds its internal pseudo-random number
-  generator (PRNG).  The routine requests that nByte bytes of randomness
+  The xRandomness method is used exactly once to initialize the 
+  pseudo-random number generator (PRNG) inside of SQLite.  Only
+  the xRandomness method on the default VFS is used.  The xRandomness
+  methods on other VFSes are never accessed by SQLite.
+  The xRandomness routine requests that nByte bytes of randomness
   be written into zOut.  The routine returns the actual number of
   bytes of randomness obtained.  The quality of the randomness so obtained
   will determine the quality of the randomness generated by built-in 
-  SQLite functions such as random() and randomblob().
+  SQLite functions such as random() and randomblob().  SQLite also
+  uses its PRNG to generate temporary file names..  On some platforms
+  (ex: windows) SQLite assumes that temporary file names are unique
+  without actually testing for collisions, so it is important to have
+  good-quality randomness even if the random() and randomblob() 
+  functions are never used.
 }
 
 PARAGRAPH {
-- 
2.47.3