1
0
mirror of https://github.com/sqlite/sqlite.git synced 2025-11-15 11:41:13 +03:00

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

Ticket #2614. (CVS 4373)

FossilOrigin-Name: e89d4131a1b55da1a7f226d7f7b416f02f5e2c6e
This commit is contained in:
drh
2007-09-03 12:34:57 +00:00
parent 860b6cd2b9
commit ee6c9722cc
3 changed files with 20 additions and 14 deletions

View File

@@ -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

View File

@@ -1 +1 @@
e3dd3651421ee723f9b7550fc333a308a83b276d
e89d4131a1b55da1a7f226d7f7b416f02f5e2c6e

View File

@@ -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 {