3 # The author disclaims copyright to this source code. In place of
4 # a legal notice, here is a blessing:
6 # May you do good and not evil.
7 # May you find forgiveness for yourself and forgive others.
8 # May you share freely, never taking more than you give.
10 #***********************************************************************
12 # This file implements a program that produces scripts (either shell scripts
13 # or batch files) to implement a particular test that is part of the SQLite
14 # release testing procedure. For example, to run veryquick.test with a
15 # specified set of -D compiler switches.
17 # A "configuration" is a set of options passed to [./configure] and [make]
18 # to build the SQLite library in a particular fashion. A "platform" is a
19 # list of tests; most platforms are named after the hardware/OS platform
20 # that the tests will be run on as part of the release procedure. Each
21 # "test" is a combination of a configuration and a makefile target (e.g.
22 # "fulltest"). The program may be invoked as follows:
25 $argv0 script ?
-msvc? CONFIGURATION TARGET
26 Given a configuration and make target
, return a bash
(or
, if -msvc
27 is specified
, batch
) script to execute the test. The first argument
28 passed to the script must be a directory containing SQLite
source code.
31 List available configurations.
34 List available platforms.
36 $argv0 tests ?
-nodebug? PLATFORM
37 List tests in a specified platform. If the
-nodebug switch is
38 specified
, synthetic debug
/ndebug configurations are omitted. Each
39 test is a combination of a configuration and a makefile target.
42 # Omit comments (text between # and \n) in a long multi-line string.
44 proc strip_comments
{in
} {
45 regsub -all {#[^\n]*\n} $in {} out
49 array set ::Configs [strip_comments
{
52 --disable-amalgamation
--disable-shared
56 CC
=clang
-fsanitize=address
,undefined
58 -DCONFIG_SLOWDOWN_FACTOR=5.0
67 # The "Have-Not" configuration sets all possible -UHAVE_feature options
68 # in order to verify that the code works even on platforms that lack
69 # these support services.
75 -DHAVE_MALLOC_USABLE_SIZE=0
82 -DSQLITE_ENABLE_UNLOCK_NOTIFY
84 -DSQLITE_TCL_DEFAULT_FULLMUTEX=1
88 -DSQLITE_USER_AUTHENTICATION=1
92 -DSQLITE_SECURE_DELETE=1
95 "Update-Delete-Limit" {
97 -DSQLITE_DEFAULT_FILE_FORMAT=4
98 -DSQLITE_ENABLE_UPDATE_DELETE_LIMIT=1
99 -DSQLITE_ENABLE_STMT_SCANSTATUS
100 -DSQLITE_LIKE_DOESNT_MATCH_BLOBS
101 -DSQLITE_ENABLE_CURSOR_HINTS
105 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1
106 -DSQLITE_ENABLE_FTS3=1
107 -DSQLITE_ENABLE_RTREE=1
108 -DSQLITE_ENABLE_MEMSYS5=1
109 -DSQLITE_ENABLE_MEMSYS3=1
110 -DSQLITE_ENABLE_COLUMN_METADATA=1
111 -DSQLITE_ENABLE_UPDATE_DELETE_LIMIT=1
112 -DSQLITE_SECURE_DELETE=1
114 -DSQLITE_ENABLE_ATOMIC_WRITE=1
115 -DSQLITE_ENABLE_MEMORY_MANAGEMENT=1
116 -DSQLITE_ENABLE_OVERSIZE_CELL_CHECK=1
117 -DSQLITE_ENABLE_STAT4
118 -DSQLITE_ENABLE_STMT_SCANSTATUS
119 --enable-fts
5 --enable-session
126 -DSQLITE_MUTEX_NOOP=1
127 -DSQLITE_TCL_DEFAULT_FULLMUTEX=1
128 -DSQLITE_ENABLE_FTS3=1
129 -DSQLITE_ENABLE_RTREE=1
130 -DSQLITE_ENABLE_MEMSYS5=1
131 -DSQLITE_ENABLE_COLUMN_METADATA=1
132 -DSQLITE_ENABLE_STAT4
133 -DSQLITE_ENABLE_HIDDEN_COLUMNS
134 -DSQLITE_MAX_ATTACHED=125
135 -DSQLITE_MUTATION_TEST
139 -DSQLITE_DEFAULT_MEMSTATUS=0
140 -DSQLITE_MAX_EXPR_DEPTH=0
145 -DSQLITE_ENABLE_FTS4=1
146 -DSQLITE_ENABLE_RTREE=1
147 -DSQLITE_ENABLE_STAT4
149 -DSQLITE_MAX_ATTACHED=125
150 -DSQLITE_MAX_MMAP_SIZE=12884901888
151 -DSQLITE_ENABLE_SORTER_MMAP=1
152 -DLONGDOUBLE_TYPE=double
158 -DSQLITE_DEFAULT_AUTOVACUUM=1
159 -DSQLITE_DEFAULT_CACHE_SIZE=64
160 -DSQLITE_DEFAULT_PAGE_SIZE=1024
161 -DSQLITE_DEFAULT_TEMP_CACHE_SIZE=32
162 -DSQLITE_DISABLE_LFS=1
163 -DSQLITE_ENABLE_ATOMIC_WRITE=1
164 -DSQLITE_ENABLE_IOTRACE=1
165 -DSQLITE_ENABLE_MEMORY_MANAGEMENT=1
166 -DSQLITE_MAX_PAGE_SIZE=4096
167 -DSQLITE_OMIT_LOAD_EXTENSION=1
168 -DSQLITE_OMIT_PROGRESS_CALLBACK=1
169 -DSQLITE_OMIT_VIRTUALTABLE=1
170 -DSQLITE_ENABLE_HIDDEN_COLUMNS
171 -DSQLITE_TEMP_STORE=3
174 -DSQLITE_4_BYTE_ALIGNED_MALLOC=1
175 -DSQLITE_DEFAULT_AUTOVACUUM=1
176 -DSQLITE_DEFAULT_CACHE_SIZE=1000
177 -DSQLITE_DEFAULT_LOCKING_MODE=0
178 -DSQLITE_DEFAULT_PAGE_SIZE=1024
179 -DSQLITE_DEFAULT_TEMP_CACHE_SIZE=1000
180 -DSQLITE_DISABLE_LFS=1
181 -DSQLITE_ENABLE_FTS3=1
182 -DSQLITE_ENABLE_MEMORY_MANAGEMENT=1
183 -DSQLITE_ENABLE_RTREE=1
184 -DSQLITE_MAX_COMPOUND_SELECT=50
185 -DSQLITE_MAX_PAGE_SIZE=32768
186 -DSQLITE_OMIT_TRACE=1
187 -DSQLITE_TEMP_STORE=3
188 -DSQLITE_THREADSAFE=2
189 --enable-fts
5 --enable-session
193 -DSQLITE_ENABLE_LOCKING_STYLE=1
203 -DSQLITE_DEFAULT_CACHE_SIZE=1000
204 -DSQLITE_DEFAULT_CKPTFULLFSYNC=1
205 -DSQLITE_DEFAULT_MEMSTATUS=1
206 -DSQLITE_DEFAULT_PAGE_SIZE=1024
207 -DSQLITE_DISABLE_PAGECACHE_OVERFLOW_STATS=1
208 -DSQLITE_ENABLE_API_ARMOR=1
209 -DSQLITE_ENABLE_AUTO_PROFILE=1
210 -DSQLITE_ENABLE_FLOCKTIMEOUT=1
211 -DSQLITE_ENABLE_FTS3=1
212 -DSQLITE_ENABLE_FTS3_PARENTHESIS=1
213 -DSQLITE_ENABLE_FTS3_TOKENIZER=1
214 -DSQLITE_ENABLE_PERSIST_WAL=1
215 -DSQLITE_ENABLE_PURGEABLE_PCACHE=1
216 -DSQLITE_ENABLE_RTREE=1
217 -DSQLITE_ENABLE_SNAPSHOT=1
218 # -DSQLITE_ENABLE_SQLLOG=1
219 -DSQLITE_ENABLE_UPDATE_DELETE_LIMIT=1
220 -DSQLITE_MAX_LENGTH=2147483645
221 -DSQLITE_MAX_VARIABLE_NUMBER=500000
222 # -DSQLITE_MEMDEBUG=1
224 -DSQLITE_OMIT_AUTORESET=1
225 -DSQLITE_OMIT_LOAD_EXTENSION=1
226 -DSQLITE_PREFER_PROXY_LOCKING=1
227 -DSQLITE_SERIES_CONSTRAINT_VERIFY=1
228 -DSQLITE_THREADSAFE=2
230 -DSQLITE_WRITE_WALFRAME_PREBUFFERED=1
236 -DSQLITE_ENABLE_OVERSIZE_CELL_CHECK=1
237 -DSQLITE_MAX_ATTACHED=62
240 -DSQLITE_DEFAULT_FILE_FORMAT=4
241 -DSQLITE_MAX_ATTACHED=30
242 -DSQLITE_ENABLE_COLUMN_METADATA
245 -DSQLITE_ENABLE_FTS4_PARENTHESIS
246 -DSQLITE_DISABLE_FTS4_DEFERRED
247 -DSQLITE_ENABLE_RTREE
251 -DSQLITE_TEST_REALLOC_STRESS=1
252 -DSQLITE_OMIT_LOOKASIDE=1
255 -DSQLITE_ENABLE_STAT4
257 -DSQLITE_ENABLE_RTREE
258 -DSQLITE_ENABLE_HIDDEN_COLUMNS
259 -DCONFIG_SLOWDOWN_FACTOR=8.0
266 "Windows-Win32Heap" {
271 # The next group of configurations are used only by the
272 # Failure-Detection platform. They are all the same, but we need
273 # different names for them all so that they results appear in separate
283 if {$tcl_platform(os
)=="Darwin"} {
284 lappend Configs
(Apple
) -DSQLITE_ENABLE_LOCKING_STYLE=1
287 array set ::Platforms [strip_comments
{
289 "Check-Symbols*" "" checksymbols
290 "Fast-One" QUICKTEST_INCLUDE
=rbu.test
"fuzztest test"
291 "Debug-One" "" "mptest test"
294 "Secure-Delete" "" test
295 "Unlock-Notify" QUICKTEST_INCLUDE
=notify2.test test
296 "User-Auth" "" tcltest
297 "Update-Delete-Limit" "" test
298 "Extra-Robustness" "" test
299 "Device-Two" "" "threadtest test"
300 "No-lookaside" "" test
304 "Device-One" "" alltest
305 "Default" "" "threadtest fuzztest alltest"
306 "Valgrind*" "" valgrindtest
311 "Unlock-Notify" QUICKTEST_INCLUDE
=notify2.test test
314 "Default" "" "threadtest fuzztest alltest"
317 "Locking-Style" "" "mptest test"
319 "Apple" "" "threadtest fuzztest alltest"
322 "Locking-Style" "" "mptest test"
324 "Apple" "" "threadtest fuzztest alltest"
327 "Locking-Style" "" "mptest test"
329 "Apple" "" "threadtest fuzztest alltest"
334 "Windows-Memdebug*" "" test
335 "Windows-Win32Heap*" "" test
336 "Default" "" "mptest fulltestonly"
341 "Windows-Memdebug*" "" test
342 "Windows-Win32Heap*" "" test
343 "Default" "" "mptest fulltestonly"
346 # The Failure-Detection platform runs various tests that deliberately
347 # fail. This is used as a test of this script to verify that this script
348 # correctly identifies failures.
351 Fail0
* "TEST_FAILURE=0" test
352 Sanitize
* "TEST_FAILURE=1" test
353 Fail2
* "TEST_FAILURE=2" valgrindtest
354 Fail3
* "TEST_FAILURE=3" valgrindtest
355 Fail4
* "TEST_FAILURE=4" test
356 FuzzFail1
* "TEST_FAILURE=5" test
357 FuzzFail2
* "TEST_FAILURE=5" valgrindtest
361 #--------------------------------------------------------------------------
362 #--------------------------------------------------------------------------
363 #--------------------------------------------------------------------------
364 # End of configuration section.
365 #--------------------------------------------------------------------------
366 #--------------------------------------------------------------------------
367 #--------------------------------------------------------------------------
369 # Configuration verification: Check that each entry in the list of configs
370 # specified for each platforms exists.
372 foreach {key value
} [array get
::Platforms] {
373 foreach {v vars t
} $value {
374 if {[string range
$v end end
]=="*"} {
375 set v
[string range
$v 0 end-1
]
377 if {0==[info exists
::Configs($v)]} {
378 puts stderr
"No such configuration: \"$v\""
386 puts stderr
[subst $::USAGE]
390 proc is_prefix
{p str min
} {
391 set n
[string length
$p]
392 if {$n<$min} { return 0 }
393 if {[string range
$str 0 [expr $n-1]]!=$p} { return 0 }
397 proc main_configurations
{} {
398 foreach k
[lsort [array names
::Configs]] {
403 proc main_platforms
{} {
404 foreach k
[lsort [array names
::Platforms]] {
409 proc main_script
{args
} {
411 set nArg
[llength $args]
413 if {![is_prefix
[lindex $args 0] -msvc 2]} usage
415 } elseif
{$nArg<2 ||
$nArg>3} {
418 set config
[lindex $args end-1
]
419 set target
[lindex $args end
]
421 set opts
[list] ;# OPTS value
422 set cflags
[expr {$bMsvc ?
"-Zi" : "-g"}] ;# CFLAGS value
423 set makeOpts
[list] ;# Extra args for [make]
424 set configOpts
[list] ;# Extra args for [configure]
426 if {$::tcl_platform(platform
)=="windows" ||
$bMsvc} {
427 lappend opts
-DSQLITE_OS_WIN=1
429 lappend opts
-DSQLITE_OS_UNIX=1
432 # Figure out if this is a synthetic ndebug or debug configuration.
435 if {[string match
*-ndebug $config]} {
437 set config
[string range
$config 0 end-7
]
439 if {[string match
*-debug $config]} {
440 lappend opts
-DSQLITE_DEBUG
441 lappend opts
-DSQLITE_EXTRA_IFNULLROW
442 set config
[string range
$config 0 end-6
]
444 regexp {^
(.
*)-[0-9]+} $config -> config
446 # Ensure that the named configuration exists.
448 if {![info exists
::Configs($config)]} {
449 puts stderr
"No such config: $config"
453 # Loop through the parameters of the nominated configuration, updating
454 # $opts, $cflags, $makeOpts and $configOpts along the way. Rules are as
457 # 1. If the parameter begins with a "*", discard it.
459 # 2. If $bRemoveDebug is set and the parameter is -DSQLITE_DEBUG or
460 # -DSQLITE_DEBUG=1, discard it
462 # 3. If the parameter begins with "-D", add it to $opts.
464 # 4. If the parameter begins with "--" add it to $configOpts. Unless
465 # this command is preparing a script for MSVC - then add an
466 # equivalent to $makeOpts or $opts.
468 # 5. If the parameter begins with "-" add it to $cflags. If in MSVC
469 # mode and the parameter is an -O<integer> option, instead add
470 # an OPTIMIZATIONS=<integer> switch to $makeOpts.
472 # 6. If none of the above apply, add the parameter to $makeOpts
474 foreach param
$::Configs($config) {
475 if {[string range
$param 0 0]=="*"} continue
478 if {$param=="-DSQLITE_DEBUG" ||
$param=="-DSQLITE_DEBUG=1"
479 ||
$param=="-DSQLITE_MEMDEBUG" ||
$param=="-DSQLITE_MEMDEBUG=1"
480 ||
$param=="--enable-debug"
486 if {[string range
$param 0 1]=="-D"} {
491 if {[string range
$param 0 1]=="--"} {
494 --disable-amalgamation
{
495 lappend makeOpts USE_AMALGAMATION
=0
498 lappend makeOpts USE_CRT_DLL
=0 DYNAMIC_SHELL
=0
501 lappend opts
-DSQLITE_ENABLE_FTS5
504 lappend makeOpts USE_CRT_DLL
=1 DYNAMIC_SHELL
=1
507 lappend opts
-DSQLITE_ENABLE_PREUPDATE_HOOK
508 lappend opts
-DSQLITE_ENABLE_SESSION
511 error "Cannot translate $param for MSVC"
515 lappend configOpts
$param
521 if {[string range
$param 0 0]=="-"} {
522 if {$bMsvc && [regexp -- {^
-O(\d
+)$} $param -> level
]} {
523 lappend makeOpts OPTIMIZATIONS
=$level
525 lappend cflags
$param
530 lappend makeOpts
$param
533 # Some configurations specify -DHAVE_USLEEP=0. For all others, add
536 if {[lsearch $opts "-DHAVE_USLEEP=0"]<0} {
537 lappend opts
-DHAVE_USLEEP=1
543 puts {if [ "$#" -ne 1 ] ; then
}
544 puts { echo
"Usage: $0 <sqlite-src-dir>" }
549 puts "TCL=\"[::tcl::pkgconfig get libdir,install]\""
551 puts "\$SRCDIR/configure --with-tcl=\$TCL $configOpts"
553 puts {OPTS
=" -DSQLITE_NO_SYNC=1"}
555 puts "OPTS=\"\$OPTS $o\""
558 puts "CFLAGS=\"$cflags\""
560 puts "make $target \"CFLAGS=\$CFLAGS\" \"OPTS=\$OPTS\" $makeOpts"
564 set makecmd
"nmake /f %SRCDIR%\\Makefile.msc TOP=%SRCDIR% $target "
565 append makecmd
"\"CFLAGS=$cflags\" \"OPTS=$opts\" $makeOpts"
572 proc main_tests
{args
} {
574 set nArg
[llength $args]
576 if {[is_prefix
[lindex $args 0] -nodebug 2]} {
578 } elseif
{[is_prefix
[lindex $args 0] -debug 2]} {
581 } elseif
{$nArg==0 ||
$nArg>2} {
584 set p
[lindex $args end
]
585 if {![info exists
::Platforms($p)]} {
586 puts stderr
"No such platform: $p"
592 foreach {config vars target
} $::Platforms($p) {
593 if {[string range
$config end end
]=="*"} {
594 set config
[string range
$config 0 end-1
]
595 } elseif
{$bNodebug==0} {
597 if {[lsearch $target fuzztest
]<0 && [lsearch $target test
]<0} {
600 if {$vars!=""} { set dtarget
"$vars $dtarget" }
602 if {[string first SQLITE_DEBUG
$::Configs($config)]>=0
603 ||
[string first
--enable-debug
$::Configs($config)]>=0
605 lappend lTest
"$config-ndebug \"$dtarget\""
607 lappend lTest
"$config-debug \"$dtarget\""
611 if {[llength $target]==1 && ([string match
"*TEST_FAILURE*" $vars] ||
(
612 [lsearch $target "valgrindtest"]<0
613 && [lsearch $target "alltest"]<0
614 && [lsearch $target "fulltestonly"]<0
615 && ![string match Sanitize
* $config]
617 if {$vars!=""} { set target
"$vars $target" }
618 lappend lTest
"$config \"$target\""
622 if {$t=="valgrindtest" ||
$t=="alltest" ||
$t=="fulltestonly"
623 ||
[string match Sanitize
* $config]
625 if {$vars!=""} { set t
"$vars $t" }
626 for {set ii
1} {$ii<=4} {incr ii
} {
627 lappend lTest
"$config-[incr idir] \"TCLTEST_PART=$ii/4 $t\""
630 if {$vars!=""} { set t
"$vars $t" }
631 lappend lTest
"$config-[incr idir] \"$t\""
643 if {[llength $argv]==0} { usage
}
644 set cmd
[lindex $argv 0]
645 set n
[expr [llength $argv]-1]
646 if {[string match
${cmd
}* configurations
] && $n==0} {
648 } elseif
{[string match
${cmd
}* script
]} {
649 main_script
{*}[lrange $argv 1 end
]
650 } elseif
{[string match
${cmd
}* platforms
] && $n==0} {
652 } elseif
{[string match
${cmd
}* tests
]} {
653 main_tests
{*}[lrange $argv 1 end
]