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 #***********************************************************************
11 # This file implements regression tests for SQLite library. The
12 # focus of this script is extension loading.
14 # $Id: loadext.test,v 1.17 2009/03/20 09:09:37 danielk1977 Exp $
16 set testdir [file dirname $argv0]
17 source $testdir/tester.tcl
24 # The name of the test extension varies by operating system.
26 if {$::tcl_platform(platform) eq "windows"} {
27 set testextension ./testloadext.dll
29 set testextension ./libtestloadext.so
31 set gcc_shared "-shared -fPIC"
32 if {$::tcl_platform(os) eq "Darwin"} {
33 set gcc_shared -dynamiclib
36 # The error messages tested by this file are operating system dependent
37 # (because they are returned by sqlite3OsDlError()). For now, they only
38 # work with UNIX (and probably only certain kinds of UNIX).
40 # When a shared-object cannot be opened because it does not exist, the
41 # format of the message returned is:
43 # [format $dlerror_nosuchfile <shared-object-name>]
45 # When a shared-object cannot be opened because it consists of the 4
46 # characters "blah" only, we expect the error message to be:
48 # [format $dlerror_notadll <shared-object-name>]
50 # When a symbol cannot be found within an open shared-object, the error
53 # [format $dlerror_nosymbol <shared-object-name> <symbol-name>]
55 # The exact error messages are not important. The important bit is
56 # that SQLite is correctly copying the message from xDlError().
58 set dlerror_nosuchfile \
59 {%s: cannot open shared object file: No such file or directory}
60 set dlerror_notadll {%s: file too short}
61 set dlerror_nosymbol {%s: undefined symbol: %s}
63 if {$::tcl_platform(os) eq "Darwin"} {
64 set dlerror_nosuchfile {dlopen(%s, 10): image not found}
65 set dlerror_notadll {dlopen(%1$s, 10): no suitable image found.*}
66 set dlerror_nosymbol {dlsym(XXX, %2$s): symbol not found}
69 if {$::tcl_platform(platform) eq "windows"} {
70 set dlerror_nosuchfile {The specified module could not be found.*}
71 set dlerror_notadll {%%1 is not a valid Win32 application.*}
72 set dlerror_nosymbol {The specified procedure could not be found.*}
75 # Make sure the test extension actually exists. If it does not
76 # exist, try to create it. If unable to create it, then skip this
79 if {![file exists $testextension]} {
80 set srcdir [file dir $testdir]/src
81 set testextsrc $srcdir/test_loadext.c
83 set cmdline [concat exec gcc $gcc_shared]
84 lappend cmdline -Wall -I$srcdir -I. -g $testextsrc -o $testextension
86 if {[catch $cmdline msg]} {
87 puts "Skipping loadext tests: Test extension not built..."
94 # Test that loading the extension produces the expected results - adding
95 # the half() function to the specified database handle.
101 } {1 {no such function: half}}
102 do_test loadext-1.2 {
103 db enable_load_extension 1
104 sqlite3_load_extension db $testextension testloadext_init
110 # Test that a second database connection (db2) can load the extension also.
112 do_test loadext-1.3 {
114 sqlite3_enable_load_extension db2 1
118 } {1 {no such function: half}}
119 do_test loadext-1.4 {
120 sqlite3_load_extension db2 $testextension testloadext_init
126 # Close the first database connection. Then check that the second database
127 # can still use the half() function without a problem.
129 do_test loadext-1.5 {
138 sqlite3_enable_load_extension db 1
140 # Try to load an extension for which the file does not exist.
142 do_test loadext-2.1 {
143 forcedelete ${testextension}xx
145 sqlite3_load_extension db "${testextension}xx"
148 } /[list 1 [format $dlerror_nosuchfile ${testextension}xx.*]]/
150 # Try to load an extension for which the file is not a shared object
152 do_test loadext-2.2 {
153 set fd [open "./notasharedlib.so" w]
156 set fd [open "./notasharedlib.dll" w]
160 sqlite3_load_extension db "./notasharedlib"
163 } /[list 1 [format $dlerror_notadll ./notasharedlib.*]]/
165 # Try to load an extension for which the file is present but the
166 # entry point is not.
168 do_test loadext-2.3 {
170 sqlite3_load_extension db $testextension icecream
172 if {$::tcl_platform(os) eq "Darwin"} {
173 regsub {0x[1234567890abcdefABCDEF]*} $msg XXX msg
176 } /[list 1 [format $dlerror_nosymbol $testextension icecream]]/
178 # Try to load an extension for which the entry point fails (returns non-zero)
180 do_test loadext-2.4 {
182 sqlite3_load_extension db $testextension testbrokenext_init
185 } {1 {error during initialization: broken!}}
187 ############################################################################
188 # Tests for the load_extension() SQL function
193 sqlite3_enable_load_extension db 1
194 do_test loadext-3.1 {
198 } {1 {no such function: half}}
199 do_test loadext-3.2 {
201 SELECT load_extension($::testextension)
203 if {$::tcl_platform(os) eq "Darwin"} {
204 regsub {0x[1234567890abcdefABCDEF]*} $res XXX res
207 } /[list 1 [format $dlerror_nosymbol $testextension sqlite3_.*_init]]/
208 do_test loadext-3.3 {
210 SELECT load_extension($::testextension,'testloadext_init')
213 do_test loadext-3.4 {
218 do_test loadext-3.5 {
220 SELECT sqlite3_status('MEMORY_USED') AS mused
222 puts -nonewline " (memory_used=$mused) "
225 do_test loadext-3.6 {
227 SELECT sqlite3_status('MEMORY_USED_X') AS mused
229 } {1 {unknown status property: MEMORY_USED_X}}
230 do_test loadext-3.7 {
232 SELECT sqlite3_status(4.53) AS mused
234 } {1 {unknown status type}}
235 do_test loadext-3.8 {
237 SELECT sqlite3_status(23) AS mused
239 } {1 {sqlite3_status(23,...) returns 21}}
242 # Make sure the extension loading mechanism will not work unless it
243 # is explicitly enabled.
247 do_test loadext-4.1 {
249 SELECT load_extension($::testextension,'testloadext_init')
251 } {1 {not authorized}}
252 do_test loadext-4.2 {
253 sqlite3_enable_load_extension db 1
255 SELECT load_extension($::testextension,'testloadext_init')
259 do_test loadext-4.3 {
260 sqlite3_enable_load_extension db 0
262 SELECT load_extension($::testextension,'testloadext_init')
264 } {1 {not authorized}}
266 source $testdir/malloc_common.tcl
269 # Malloc failure in sqlite3_auto_extension and sqlite3_load_extension
271 do_malloc_test loadext-5 -tclprep {
272 sqlite3_reset_auto_extension
274 if {[autoinstall_test_functions]==7} {error "out of memory"}
277 # On Windows, this malloc test must be skipped because the winDlOpen
278 # function itself can fail due to "out of memory" conditions.
280 if {$::tcl_platform(platform) ne "windows"} {
281 do_malloc_test loadext-6 -tclbody {
282 db enable_load_extension 1
283 sqlite3_load_extension db $::testextension testloadext_init
287 autoinstall_test_functions