Document the fact that xRandomness is only called once from the default VFS.

Ticket #2614. (CVS 4373)

FossilOrigin-Name: e89d4131a1b55da1a7f226d7f7b416f02f5e2c6e

diff --git a/manifest b/manifest
index bbad0fc96b8ab0f5f2c7e75490070712f54b4b0d..d753db2f2779c8c8bc95f9d96ce36f758c8abef7 100644 (file)
--- 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 dabab8615c4cc01278e413c4e3c4f4c9107b1359..f865dc0339f0ce26b10131a49fbdcc837a8b27ae 100644 (file)
--- 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 83c8c12f6994e53cf81313dfe3e39182668e4d64..449ed35e46b62214820abd986b447d521c72744c 100644 (file)
--- 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 {