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 file is testing the operation of the library in
13 # "PRAGMA journal_mode=WAL" mode.
16 set testdir [file dirname $argv0]
17 source $testdir/tester.tcl
18 source $testdir/lock_common.tcl
19 source $testdir/malloc_common.tcl
20 source $testdir/wal_common.tcl
24 ifcapable !wal {finish_test ; return }
26 set sqlite_sync_count 0
27 proc cond_incr_sync_count {adj} {
28 global sqlite_sync_count
29 if {$::tcl_platform(platform) == "windows"} {
30 incr sqlite_sync_count $adj
33 incr sqlite_sync_count $adj
38 proc set_tvfs_hdr {file args} {
40 # Set $nHdr to the number of bytes in the wal-index header:
42 set nInt [expr {$nHdr/4}]
44 if {[llength $args]>2} {
45 error {wrong # args: should be "set_tvfs_hdr fileName ?val1? ?val2?"}
48 set blob [tvfs shm $file]
49 if {$::tcl_platform(byteOrder)=="bigEndian"} {set fmt I} {set fmt i}
51 if {[llength $args]} {
52 set ia [lindex $args 0]
54 if {[llength $args]==2} {
55 set ib [lindex $args 1]
57 binary scan $blob a[expr $nHdr*2]a* dummy tail
58 set blob [binary format ${fmt}${nInt}${fmt}${nInt}a* $ia $ib $tail]
62 binary scan $blob ${fmt}${nInt} ints
66 proc incr_tvfs_hdr {file idx incrval} {
67 set ints [set_tvfs_hdr $file]
68 set v [lindex $ints $idx]
71 set_tvfs_hdr $file $ints
75 #-------------------------------------------------------------------------
78 # Set up a small database containing a single table. The database is not
79 # checkpointed during the test - all content resides in the log file.
81 # Two connections are established to the database file - a writer ([db])
82 # and a reader ([db2]). For each of the 8 integer fields in the wal-index
83 # header (6 fields and 2 checksum values), do the following:
85 # 1. Modify the database using the writer.
87 # 2. Attempt to read the database using the reader. Before the reader
88 # has a chance to snapshot the wal-index header, increment one
89 # of the integer fields (so that the reader ends up with a corrupted
92 # 3. Check that the reader recovers the wal-index and reads the correct
96 proc tvfs_cb {method filename args} {
97 set ::filename $filename
105 sqlite3 db test.db -vfs tvfs
106 sqlite3 db2 test.db -vfs tvfs
109 PRAGMA journal_mode = WAL;
113 INSERT INTO t1 VALUES(1);
114 INSERT INTO t1 VALUES(2);
115 INSERT INTO t1 VALUES(3);
116 INSERT INTO t1 VALUES(4);
117 SELECT count(a), sum(a) FROM t1;
121 execsql { SELECT count(a), sum(a) FROM t1 } db2
125 {0 1 lock exclusive} {1 7 lock exclusive} \
126 {1 7 unlock exclusive} {0 1 unlock exclusive} \
129 {4 1 lock shared} {4 1 unlock shared} \
132 {4 1 lock exclusive} {4 1 unlock exclusive} \
135 foreach {tn iInsert res wal_index_hdr_mod wal_locks} "
136 2 5 {5 15} 0 {$RECOVER $READ}
137 3 6 {6 21} 1 {$RECOVER $READ}
138 4 7 {7 28} 2 {$RECOVER $READ}
139 5 8 {8 36} 3 {$RECOVER $READ}
140 6 9 {9 45} 4 {$RECOVER $READ}
141 7 10 {10 55} 5 {$RECOVER $READ}
142 8 11 {11 66} 6 {$RECOVER $READ}
143 9 12 {12 78} 7 {$RECOVER $READ}
144 10 13 {13 91} 8 {$RECOVER $READ}
145 11 14 {14 105} 9 {$RECOVER $READ}
146 12 15 {15 120} -1 {$INITSLOT $READ}
149 do_test wal2-1.$tn.1 {
150 execsql { INSERT INTO t1 VALUES($iInsert) }
152 proc tvfs_cb {method args} {
153 lappend ::locks [lindex $args 2]
157 if {$::wal_index_hdr_mod >= 0} {
158 incr_tvfs_hdr $::filename $::wal_index_hdr_mod 1
160 execsql { SELECT count(a), sum(a) FROM t1 } db2
163 do_test wal2-1.$tn.2 {
170 forcedelete test.db test.db-wal test.db-journal
172 #-------------------------------------------------------------------------
173 # This test case is very similar to the previous one, except, after
174 # the reader reads the corrupt wal-index header, but before it has
175 # a chance to re-read it under the cover of the RECOVER lock, the
176 # wal-index header is replaced with a valid, but out-of-date, header.
178 # Because the header checksum looks Ok, the reader does not run recovery,
179 # it simply drops back to a READ lock and proceeds. But because the
180 # header is out-of-date, the reader reads the out-of-date snapshot.
182 # After this, the header is corrupted again and the reader is allowed
183 # to run recovery. This time, it sees an up-to-date snapshot of the
186 set WRITER [list 0 1 lock exclusive]
188 {0 1 lock exclusive} {0 1 unlock exclusive} \
189 {4 1 lock exclusive} {4 1 unlock exclusive} \
190 {4 1 lock shared} {4 1 unlock shared} \
197 proc tvfs_cb {method args} {
198 set ::filename [lindex $args 0]
202 sqlite3 db test.db -vfs tvfs
203 sqlite3 db2 test.db -vfs tvfs
206 PRAGMA journal_mode = WAL;
210 INSERT INTO t1 VALUES(1);
211 INSERT INTO t1 VALUES(2);
212 INSERT INTO t1 VALUES(3);
213 INSERT INTO t1 VALUES(4);
214 SELECT count(a), sum(a) FROM t1;
218 execsql { SELECT count(a), sum(a) FROM t1 } db2
221 foreach {tn iInsert res0 res1 wal_index_hdr_mod} {
227 7 10 {9 45} {10 55} 5
228 8 11 {10 55} {11 66} 6
229 9 12 {11 66} {12 78} 7
233 do_test wal2-2.$tn.1 {
234 set oldhdr [set_tvfs_hdr $::filename]
235 execsql { INSERT INTO t1 VALUES($iInsert) }
236 execsql { SELECT count(a), sum(a) FROM t1 }
239 do_test wal2-2.$tn.2 {
241 proc tvfs_cb {method args} {
242 set lock [lindex $args 2]
243 lappend ::locks $lock
244 if {$lock == $::WRITER} {
245 set_tvfs_hdr $::filename $::oldhdr
250 if {$::wal_index_hdr_mod >= 0} {
251 incr_tvfs_hdr $::filename $::wal_index_hdr_mod 1
253 execsql { SELECT count(a), sum(a) FROM t1 } db2
256 do_test wal2-2.$tn.3 {
260 do_test wal2-2.$tn.4 {
262 proc tvfs_cb {method args} {
263 set lock [lindex $args 2]
264 lappend ::locks $lock
268 if {$::wal_index_hdr_mod >= 0} {
269 incr_tvfs_hdr $::filename $::wal_index_hdr_mod 1
271 execsql { SELECT count(a), sum(a) FROM t1 } db2
277 forcedelete test.db test.db-wal test.db-journal
281 #-------------------------------------------------------------------------
282 # This test case - wal2-3.* - tests the response of the library to an
283 # SQLITE_BUSY when attempting to obtain a READ or RECOVER lock.
285 # wal2-3.0 - 2: SQLITE_BUSY when obtaining a READ lock
286 # wal2-3.3 - 6: SQLITE_BUSY when obtaining a RECOVER lock
289 proc tvfs_cb {method args} {
290 if {$method == "xShmLock"} {
291 if {[info exists ::locked]} { return SQLITE_BUSY }
297 if {$x>3} { unset -nocomplain ::locked }
303 sqlite3 db test.db -vfs tvfs
307 PRAGMA journal_mode = WAL;
309 INSERT INTO t1 VALUES(1);
310 INSERT INTO t1 VALUES(2);
311 INSERT INTO t1 VALUES(3);
312 INSERT INTO t1 VALUES(4);
319 execsql { SELECT count(a), sum(a) FROM t1 }
326 proc tvfs_cb {method args} {
327 if {$method == "xShmLock"} {
328 if {[info exists ::sabotage]} {
329 unset -nocomplain ::sabotage
330 incr_tvfs_hdr [lindex $args 0] 1 1
332 if {[info exists ::locked] && [lindex $args 2] == "RECOVER"} {
340 list [info exists ::sabotage] [info exists ::locked]
343 execsql { SELECT count(a), sum(a) FROM t1 }
346 list [info exists ::sabotage] [info exists ::locked]
350 forcedelete test.db test.db-wal test.db-journal
354 #-------------------------------------------------------------------------
355 # Test that a database connection using a VFS that does not support the
356 # xShmXXX interfaces cannot open a WAL database.
361 PRAGMA auto_vacuum = 0;
362 PRAGMA journal_mode = WAL;
363 CREATE TABLE data(x);
364 INSERT INTO data VALUES('need xShmOpen to see this');
365 PRAGMA wal_checkpoint;
367 # Three pages in the WAL file at this point: One copy of page 1 and two
368 # of the root page for table "data".
372 testvfs tvfs -noshm 1
373 sqlite3 db test.db -vfs tvfs
374 catchsql { SELECT * FROM data }
375 } {1 {unable to open database file}}
379 sqlite3 db test.db -vfs tvfs
380 catchsql { SELECT * FROM data }
381 } {0 {{need xShmOpen to see this}}}
385 #-------------------------------------------------------------------------
386 # Test that if a database connection is forced to run recovery before it
387 # can perform a checkpoint, it does not transition into RECOVER state.
389 # UPDATE: This has now changed. When running a checkpoint, if recovery is
390 # required the client grabs all exclusive locks (just as it would for a
391 # recovery performed as a pre-cursor to a normal database transaction).
393 set expected_locks [list]
394 lappend expected_locks {1 1 lock exclusive} ;# Lock checkpoint
395 lappend expected_locks {0 1 lock exclusive} ;# Lock writer
396 lappend expected_locks {2 6 lock exclusive} ;# Lock recovery & all aReadMark[]
397 lappend expected_locks {2 6 unlock exclusive} ;# Unlock recovery & aReadMark[]
398 lappend expected_locks {0 1 unlock exclusive} ;# Unlock writer
399 lappend expected_locks {3 1 lock exclusive} ;# Lock aReadMark[0]
400 lappend expected_locks {3 1 unlock exclusive} ;# Unlock aReadMark[0]
401 lappend expected_locks {1 1 unlock exclusive} ;# Unlock checkpoint
403 proc tvfs_cb {method args} {
404 set ::shm_file [lindex $args 0]
405 if {$method == "xShmLock"} { lappend ::locks [lindex $args 2] }
406 return $::tvfs_cb_return
408 set tvfs_cb_return SQLITE_OK
413 sqlite3 db test.db -vfs tvfs
415 PRAGMA journal_mode = WAL;
417 INSERT INTO x VALUES(1);
420 incr_tvfs_hdr $::shm_file 1 1
422 execsql { PRAGMA wal_checkpoint }
428 #-------------------------------------------------------------------------
429 # This block, test cases wal2-6.*, tests the operation of WAL with
430 # "PRAGMA locking_mode=EXCLUSIVE" set.
432 # wal2-6.1.*: Changing to WAL mode before setting locking_mode=exclusive.
434 # wal2-6.2.*: Changing to WAL mode after setting locking_mode=exclusive.
436 # wal2-6.3.*: Changing back to rollback mode from WAL mode after setting
437 # locking_mode=exclusive.
439 # wal2-6.4.*: Check that xShmLock calls are omitted in exclusive locking
444 # wal2-6.6.*: Check that if the xShmLock() to reaquire a WAL read-lock when
445 # exiting exclusive mode fails (i.e. SQLITE_IOERR), then the
446 # connection silently remains in exclusive mode.
449 forcedelete test.db test.db-wal test.db-journal
452 Pragma Journal_Mode = Wal;
456 execsql { PRAGMA lock_status }
457 } {main unlocked temp closed}
460 SELECT * FROM sqlite_master;
461 Pragma Locking_Mode = Exclusive;
465 CREATE TABLE t1(a, b);
466 INSERT INTO t1 VALUES(1, 2);
470 } {main exclusive temp closed}
473 PRAGMA locking_mode = normal;
476 } {normal main exclusive temp closed}
482 } {1 2 main shared temp closed}
485 INSERT INTO t1 VALUES(3, 4);
488 } {main shared temp closed}
492 forcedelete test.db test.db-wal test.db-journal
495 Pragma Locking_Mode = Exclusive;
496 Pragma Journal_Mode = Wal;
499 } {exclusive wal main exclusive temp closed}
503 CREATE TABLE t1(a, b);
504 INSERT INTO t1 VALUES(1, 2);
508 } {main exclusive temp closed}
512 execsql { SELECT * FROM sqlite_master }
513 execsql { PRAGMA LOCKING_MODE = EXCLUSIVE }
520 } {1 2 main shared temp closed}
523 INSERT INTO t1 VALUES(3, 4);
526 } {main exclusive temp closed}
529 PRAGMA locking_mode = NORMAL;
532 } {normal main exclusive temp closed}
535 BEGIN IMMEDIATE; COMMIT;
538 } {main shared temp closed}
541 PRAGMA locking_mode = EXCLUSIVE;
542 BEGIN IMMEDIATE; COMMIT;
543 PRAGMA locking_mode = NORMAL;
549 } {1 2 3 4 main shared temp closed}
552 INSERT INTO t1 VALUES(5, 6);
556 } {1 2 3 4 5 6 main shared temp closed}
560 forcedelete test.db test.db-wal test.db-journal
563 PRAGMA journal_mode = WAL;
564 PRAGMA locking_mode = exclusive;
567 INSERT INTO t1 VALUES('Chico');
568 INSERT INTO t1 VALUES('Harpo');
571 list [file exists test.db-wal] [file exists test.db-journal]
574 execsql { PRAGMA journal_mode = DELETE }
575 file exists test.db-wal
578 execsql { PRAGMA lock_status }
579 } {main exclusive temp closed}
583 INSERT INTO t1 VALUES('Groucho');
585 list [file exists test.db-wal] [file exists test.db-journal]
588 execsql { PRAGMA lock_status }
589 } {main exclusive temp closed}
592 list [file exists test.db-wal] [file exists test.db-journal]
595 execsql { PRAGMA lock_status }
596 } {main exclusive temp closed}
600 # This test - wal2-6.4.* - uses a single database connection and the
601 # [testvfs] instrumentation to test that xShmLock() is being called
602 # as expected when a WAL database is used with locking_mode=exclusive.
605 forcedelete test.db test.db-wal test.db-journal
606 proc tvfs_cb {method args} {
607 set ::shm_file [lindex $args 0]
608 if {$method == "xShmLock"} { lappend ::locks [lindex $args 2] }
613 sqlite3 db test.db -vfs tvfs
618 {0 1 lock exclusive} {1 7 lock exclusive}
619 {1 7 unlock exclusive} {0 1 unlock exclusive}
622 {3 1 lock shared} {3 1 unlock shared}
624 set READMARK0_WRITE {
626 {0 1 lock exclusive} {3 1 unlock shared}
627 {4 1 lock exclusive} {4 1 unlock exclusive} {4 1 lock shared}
628 {0 1 unlock exclusive} {4 1 unlock shared}
631 {4 1 lock exclusive} {4 1 unlock exclusive}
634 {4 1 lock shared} {4 1 unlock shared}
636 set READMARK1_WRITE {
638 {0 1 lock exclusive} {0 1 unlock exclusive}
642 foreach {tn sql res expected_locks} {
644 PRAGMA auto_vacuum = 0;
645 PRAGMA journal_mode = WAL;
648 INSERT INTO t1 VALUES('Leonard');
649 INSERT INTO t1 VALUES('Arthur');
657 # This test should do the READMARK1_SET locking to populate the
658 # aReadMark[1] slot with the current mxFrame value. Followed by
659 # READMARK1_READ to read the database.
668 # aReadMark[1] is already set to mxFrame. So just READMARK1_READ
669 # this time, not READMARK1_SET.
671 SELECT * FROM t1 ORDER BY x
677 PRAGMA locking_mode = exclusive
681 INSERT INTO t1 VALUES('Julius Henry');
683 } {Leonard Arthur {Julius Henry}} {
688 INSERT INTO t1 VALUES('Karl');
690 } {Leonard Arthur {Julius Henry} Karl} { }
693 PRAGMA locking_mode = normal
697 SELECT * FROM t1 ORDER BY x
698 } {Arthur {Julius Henry} Karl Leonard} $READMARK1_READ
700 10 { DELETE FROM t1 } {} $READMARK1_WRITE
711 foreach el [subst $expected_locks] { lappend L $el }
714 foreach sq [split $sql "\n"] {
715 set sq [string trim $sq]
716 if {[string match {#*} $sq]==0} {append S "$sq\n"}
720 do_test wal2-6.4.$tn.1 { execsql $S } $res
721 do_test wal2-6.4.$tn.2 { set ::locks } $L
730 PRAGMA auto_vacuum = 0;
731 PRAGMA journal_mode = wal;
732 PRAGMA locking_mode = exclusive;
733 CREATE TABLE t2(a, b);
734 PRAGMA wal_checkpoint;
735 INSERT INTO t2 VALUES('I', 'II');
738 } {wal exclusive 0 2 2 wal}
741 PRAGMA locking_mode = normal;
742 INSERT INTO t2 VALUES('III', 'IV');
743 PRAGMA locking_mode = exclusive;
746 } {normal exclusive I II III IV}
748 execsql { PRAGMA wal_checkpoint }
752 proc lock_control {method filename handle spec} {
753 foreach {start n op type} $spec break
754 if {$op == "lock"} { return SQLITE_IOERR }
759 T script lock_control
761 sqlite3 db test.db -vfs T
762 execsql { SELECT * FROM sqlite_master }
763 execsql { PRAGMA locking_mode = exclusive }
764 execsql { INSERT INTO t2 VALUES('V', 'VI') }
767 execsql { PRAGMA locking_mode = normal }
769 execsql { INSERT INTO t2 VALUES('VII', 'VIII') }
772 # At this point the connection should still be in exclusive-mode, even
773 # though it tried to exit exclusive-mode when committing the INSERT
774 # statement above. To exit exclusive mode, SQLite has to take a read-lock
775 # on the WAL file using xShmLock(). Since that call failed, it remains
778 sqlite3 db2 test.db -vfs T
779 catchsql { SELECT * FROM t2 } db2
780 } {1 {database is locked}}
784 execsql { INSERT INTO t2 VALUES('IX', 'X') }
787 # This time, we have successfully exited exclusive mode. So the second
788 # connection can read the database.
789 sqlite3 db2 test.db -vfs T
790 catchsql { SELECT * FROM t2 } db2
791 } {0 {I II III IV V VI VII VIII IX X}}
797 #-------------------------------------------------------------------------
798 # Test a theory about the checksum algorithm. Theory was false and this
799 # test did not provoke a bug.
801 forcedelete test.db test.db-wal test.db-journal
805 PRAGMA page_size = 4096;
806 PRAGMA journal_mode = WAL;
807 CREATE TABLE t1(a, b);
812 forcecopy test.db test2.db
813 forcecopy test.db-wal test2.db-wal
814 # The first 32 bytes of the WAL file contain the WAL header. Offset 48
815 # is the first byte of the checksum for the first frame in the WAL.
816 # The following three lines replaces the contents of that byte with
819 if {$newval == [hexio_read test2.db-wal 48 1]} { set newval 00 }
820 hexio_write test2.db-wal 48 $newval
824 execsql { PRAGMA wal_checkpoint } db2
825 execsql { SELECT * FROM sqlite_master } db2
829 forcedelete test.db test.db-wal test.db-journal
833 PRAGMA auto_vacuum=OFF;
834 PRAGMA page_size = 1024;
835 PRAGMA journal_mode = WAL;
837 INSERT INTO t1 VALUES(zeroblob(8188*1020));
839 PRAGMA wal_checkpoint;
842 SELECT rootpage>=8192 FROM sqlite_master WHERE tbl_name = 't2';
847 PRAGMA cache_size = 10;
850 INSERT INTO t3 VALUES(randomblob(900));
851 INSERT INTO t3 SELECT randomblob(900) FROM t3;
852 INSERT INTO t2 VALUES('hello');
853 INSERT INTO t3 SELECT randomblob(900) FROM t3;
854 INSERT INTO t3 SELECT randomblob(900) FROM t3;
855 INSERT INTO t3 SELECT randomblob(900) FROM t3;
856 INSERT INTO t3 SELECT randomblob(900) FROM t3;
857 INSERT INTO t3 SELECT randomblob(900) FROM t3;
858 INSERT INTO t3 SELECT randomblob(900) FROM t3;
862 INSERT INTO t2 VALUES('goodbye');
863 INSERT INTO t3 SELECT randomblob(900) FROM t3;
864 INSERT INTO t3 SELECT randomblob(900) FROM t3;
869 execsql { SELECT * FROM t2 }
874 #-------------------------------------------------------------------------
875 # Test that even if the checksums for both are valid, if the two copies
876 # of the wal-index header in the wal-index do not match, the client
877 # runs (or at least tries to run) database recovery.
880 proc get_name {method args} { set ::filename [lindex $args 0] ; tvfs filter {} }
885 forcedelete test.db test.db-wal test.db-journal
887 sqlite3 db test.db -vfs tvfs
889 PRAGMA journal_mode = WAL;
891 INSERT INTO x VALUES('Barton');
892 INSERT INTO x VALUES('Deakin');
895 # Set $wih(1) to the contents of the wal-index header after
896 # the frames associated with the first two rows in table 'x' have
897 # been inserted. Then insert one more row and set $wih(2)
898 # to the new value of the wal-index header.
900 # If the $wih(1) is written into the wal-index before running
901 # a read operation, the client will see only the first two rows. If
902 # $wih(2) is written into the wal-index, the client will see
903 # three rows. If an invalid header is written into the wal-index, then
904 # the client will run recovery and see three rows.
906 set wih(1) [set_tvfs_hdr $::filename]
907 execsql { INSERT INTO x VALUES('Watson') }
908 set wih(2) [set_tvfs_hdr $::filename]
910 sqlite3 db2 test.db -vfs tvfs
911 execsql { SELECT * FROM x } db2
912 } {Barton Deakin Watson}
914 foreach {tn hdr1 hdr2 res} [list \
915 3 $wih(1) $wih(1) {Barton Deakin} \
916 4 $wih(1) $wih(2) {Barton Deakin Watson} \
917 5 $wih(2) $wih(1) {Barton Deakin Watson} \
918 6 $wih(2) $wih(2) {Barton Deakin Watson} \
919 7 $wih(1) $wih(1) {Barton Deakin} \
920 8 {0 0 0 0 0 0 0 0 0 0 0 0} {0 0 0 0 0 0 0 0 0 0 0 0} {Barton Deakin Watson}
923 set_tvfs_hdr $::filename $hdr1 $hdr2
924 execsql { SELECT * FROM x } db2
931 #-------------------------------------------------------------------------
932 # This block of tests - wal2-10.* - focus on the libraries response to
933 # new versions of the wal or wal-index formats.
935 # wal2-10.1.*: Test that the library refuses to "recover" a new WAL
938 # wal2-10.2.*: Test that the library refuses to read or write a database
939 # if the wal-index version is newer than it understands.
941 # At time of writing, the only versions of the wal and wal-index formats
942 # that exist are versions 3007000 (corresponding to SQLite version 3.7.0,
943 # the first version of SQLite to feature wal mode).
945 do_test wal2-10.1.1 {
946 faultsim_delete_and_reopen
948 PRAGMA journal_mode = WAL;
949 CREATE TABLE t1(a, b);
950 PRAGMA wal_checkpoint;
951 INSERT INTO t1 VALUES(1, 2);
952 INSERT INTO t1 VALUES(3, 4);
954 faultsim_save_and_close
956 do_test wal2-10.1.2 {
957 faultsim_restore_and_reopen
958 execsql { SELECT * FROM t1 }
960 do_test wal2-10.1.3 {
961 faultsim_restore_and_reopen
962 set hdr [wal_set_walhdr test.db-wal]
965 do_test wal2-10.1.4 {
967 wal_set_walhdr test.db-wal $hdr
968 catchsql { SELECT * FROM t1 }
969 } {1 {unable to open database file}}
971 testvfs tvfs -default 1
972 do_test wal2-10.2.1 {
973 faultsim_restore_and_reopen
974 execsql { SELECT * FROM t1 }
976 do_test wal2-10.2.2 {
977 set hdr [set_tvfs_hdr $::filename]
980 do_test wal2-10.2.3 {
982 wal_fix_walindex_cksum hdr
983 set_tvfs_hdr $::filename $hdr
984 catchsql { SELECT * FROM t1 }
985 } {1 {unable to open database file}}
989 #-------------------------------------------------------------------------
990 # This block of tests - wal2-11.* - tests that it is not possible to put
991 # the library into an infinite loop by presenting it with a corrupt
992 # hash table (one that appears to contain a single chain of infinite
995 # wal2-11.1.*: While reading the hash-table.
997 # wal2-11.2.*: While writing the hash-table.
999 testvfs tvfs -default 1
1001 faultsim_delete_and_reopen
1003 PRAGMA journal_mode = WAL;
1004 CREATE TABLE t1(a, b, c);
1005 INSERT INTO t1 VALUES(1, 2, 3);
1006 INSERT INTO t1 VALUES(4, 5, 6);
1007 INSERT INTO t1 VALUES(7, 8, 9);
1010 } {wal 1 2 3 4 5 6 7 8 9}
1012 do_test wal2-11.1.1 {
1014 execsql { SELECT name FROM sqlite_master } db2
1017 if {$::tcl_version>=8.5} {
1018 # Set all zeroed slots in the first hash table to invalid values.
1020 set blob [string range [tvfs shm $::filename] 0 16383]
1021 set I [string range [tvfs shm $::filename] 16384 end]
1025 lappend I [expr $p ? $p : 400]
1027 append blob [binary format t* $I]
1028 tvfs shm $::filename $blob
1030 catchsql { INSERT INTO t1 VALUES(10, 11, 12) }
1031 } {1 {database disk image is malformed}}
1033 # Fill up the hash table on the first page of shared memory with 0x55 bytes.
1035 set blob [string range [tvfs shm $::filename] 0 16383]
1036 append blob [string repeat [binary format c 55] 16384]
1037 tvfs shm $::filename $blob
1039 catchsql { SELECT * FROM t1 } db2
1040 } {1 {database disk image is malformed}}
1047 #-------------------------------------------------------------------------
1048 # If a connection is required to create a WAL or SHM file, it creates
1049 # the new files with the same file-system permissions as the database
1050 # file itself. Test this.
1052 if {$::tcl_platform(platform) == "unix"} {
1053 faultsim_delete_and_reopen
1054 # Changed on 2012-02-13: umask is deliberately ignored for -wal files.
1055 #set umask [exec /bin/sh -c umask]
1062 CREATE TABLE tx(y, z);
1063 PRAGMA journal_mode = WAL;
1066 list [file exists test.db-wal] [file exists test.db-shm]
1069 foreach {tn permissions} {
1075 set effective [format %.5o [expr $permissions & ~$umask]]
1076 do_test wal2-12.2.$tn.1 {
1077 file attributes test.db -permissions $permissions
1078 file attributes test.db -permissions
1080 do_test wal2-12.2.$tn.2 {
1081 list [file exists test.db-wal] [file exists test.db-shm]
1083 do_test wal2-12.2.$tn.3 {
1085 execsql { INSERT INTO tx DEFAULT VALUES }
1086 list [file exists test.db-wal] [file exists test.db-shm]
1088 do_test wal2-12.2.$tn.4 {
1089 list [file attr test.db-wal -perm] [file attr test.db-shm -perm]
1090 } [list $effective $effective]
1091 do_test wal2-12.2.$tn.5 {
1093 list [file exists test.db-wal] [file exists test.db-shm]
1098 #-------------------------------------------------------------------------
1099 # Test the libraries response to discovering that one or more of the
1100 # database, wal or shm files cannot be opened, or can only be opened
1103 if {$::tcl_platform(platform) == "unix"} {
1106 foreach f {test.db test.db-wal test.db-shm} {
1107 if {[file exists $f]} {
1108 lappend L [file attr $f -perm]
1116 faultsim_delete_and_reopen
1118 PRAGMA journal_mode = WAL;
1119 CREATE TABLE t1(a, b);
1120 PRAGMA wal_checkpoint;
1121 INSERT INTO t1 VALUES('3.14', '2.72');
1123 do_test wal2-13.1.1 {
1124 list [file exists test.db-shm] [file exists test.db-wal]
1126 faultsim_save_and_close
1128 foreach {tn db_perm wal_perm shm_perm can_open can_read can_write} {
1129 2 00644 00644 00644 1 1 1
1130 3 00644 00400 00644 1 1 0
1131 4 00644 00644 00400 1 0 0
1132 5 00400 00644 00644 1 1 0
1134 7 00644 00000 00644 1 0 0
1135 8 00644 00644 00000 1 0 0
1136 9 00000 00644 00644 0 0 0
1139 do_test wal2-13.$tn.1 {
1140 file attr test.db -perm $db_perm
1141 file attr test.db-wal -perm $wal_perm
1142 file attr test.db-shm -perm $shm_perm
1144 set L [file attr test.db -perm]
1145 lappend L [file attr test.db-wal -perm]
1146 lappend L [file attr test.db-shm -perm]
1147 } [list $db_perm $wal_perm $shm_perm]
1149 # If $can_open is true, then it should be possible to open a database
1150 # handle. Otherwise, if $can_open is 0, attempting to open the db
1151 # handle throws an "unable to open database file" exception.
1154 set r(0) {1 {unable to open database file}}
1155 do_test wal2-13.$tn.2 {
1156 list [catch {sqlite3 db test.db ; set {} ok} msg] $msg
1161 # If $can_read is true, then the client should be able to read from
1162 # the database file. If $can_read is false, attempting to read should
1163 # throw the "unable to open database file" exception.
1165 set a(0) {1 {unable to open database file}}
1166 set a(1) {0 {3.14 2.72}}
1167 do_test wal2-13.$tn.3 {
1168 catchsql { SELECT * FROM t1 }
1171 # Now try to write to the db file. If the client can read but not
1172 # write, then it should throw the familiar "unable to open db file"
1173 # exception. If it can read but not write, the exception should
1174 # be "attempt to write a read only database".
1176 # If the client can read and write, the operation should succeed.
1178 set b(0,0) {1 {unable to open database file}}
1179 set b(1,0) {1 {attempt to write a readonly database}}
1181 do_test wal2-13.$tn.4 {
1182 catchsql { INSERT INTO t1 DEFAULT VALUES }
1183 } $b($can_read,$can_write)
1189 #-------------------------------------------------------------------------
1190 # Test that "PRAGMA checkpoint_fullsync" appears to be working.
1192 foreach {tn sql reslist} {
1193 1 { } {10 0 4 0 6 0}
1194 2 { PRAGMA checkpoint_fullfsync = 1 } {10 4 4 2 6 2}
1195 3 { PRAGMA checkpoint_fullfsync = 0 } {10 0 4 0 6 0}
1197 ifcapable default_ckptfullfsync {
1198 if {[string trim $sql]==""} continue
1200 faultsim_delete_and_reopen
1202 execsql {PRAGMA auto_vacuum = 0; PRAGMA synchronous = FULL;}
1204 do_execsql_test wal2-14.$tn.0 { PRAGMA page_size = 4096 } {}
1205 do_execsql_test wal2-14.$tn.1 { PRAGMA journal_mode = WAL } {wal}
1207 set sqlite_sync_count 0
1208 set sqlite_fullsync_count 0
1210 do_execsql_test wal2-14.$tn.2 {
1211 PRAGMA wal_autocheckpoint = 10;
1212 CREATE TABLE t1(a, b); -- 2 wal syncs
1213 INSERT INTO t1 VALUES(1, 2); -- 2 wal sync
1214 PRAGMA wal_checkpoint; -- 1 wal sync, 1 db sync
1216 INSERT INTO t1 VALUES(3, 4);
1217 INSERT INTO t1 VALUES(5, 6);
1218 COMMIT; -- 2 wal sync
1219 PRAGMA wal_checkpoint; -- 1 wal sync, 1 db sync
1222 do_test wal2-14.$tn.3 {
1223 cond_incr_sync_count 1
1224 list $sqlite_sync_count $sqlite_fullsync_count
1225 } [lrange $reslist 0 1]
1227 set sqlite_sync_count 0
1228 set sqlite_fullsync_count 0
1230 do_test wal2-14.$tn.4 {
1231 execsql { INSERT INTO t1 VALUES(7, zeroblob(12*4096)) }
1232 list $sqlite_sync_count $sqlite_fullsync_count
1233 } [lrange $reslist 2 3]
1235 set sqlite_sync_count 0
1236 set sqlite_fullsync_count 0
1238 do_test wal2-14.$tn.5 {
1239 execsql { PRAGMA wal_autocheckpoint = 1000 }
1240 execsql { INSERT INTO t1 VALUES(9, 10) }
1241 execsql { INSERT INTO t1 VALUES(11, 12) }
1242 execsql { INSERT INTO t1 VALUES(13, 14) }
1244 list $sqlite_sync_count $sqlite_fullsync_count
1245 } [lrange $reslist 4 5]
1250 # PRAGMA checkpoint_fullsync
1252 # PRAGMA synchronous
1254 foreach {tn settings restart_sync commit_sync ckpt_sync} {
1255 1 {0 0 off} {0 0} {0 0} {0 0}
1256 2 {0 0 normal} {1 0} {0 0} {2 0}
1257 3 {0 0 full} {2 0} {1 0} {2 0}
1259 4 {0 1 off} {0 0} {0 0} {0 0}
1260 5 {0 1 normal} {0 1} {0 0} {0 2}
1261 6 {0 1 full} {0 2} {0 1} {0 2}
1263 7 {1 0 off} {0 0} {0 0} {0 0}
1264 8 {1 0 normal} {1 0} {0 0} {0 2}
1265 9 {1 0 full} {2 0} {1 0} {0 2}
1267 10 {1 1 off} {0 0} {0 0} {0 0}
1268 11 {1 1 normal} {0 1} {0 0} {0 2}
1269 12 {1 1 full} {0 2} {0 1} {0 2}
1273 testvfs tvfs -default 1
1276 proc xSyncCb {method file fileid flags} {
1281 do_execsql_test 15.$tn.1 "
1282 PRAGMA page_size = 4096;
1284 PRAGMA wal_autocheckpoint = OFF;
1285 PRAGMA journal_mode = WAL;
1286 PRAGMA checkpoint_fullfsync = [lindex $settings 0];
1287 PRAGMA fullfsync = [lindex $settings 1];
1288 PRAGMA synchronous = [lindex $settings 2];
1294 execsql { INSERT INTO t1 VALUES('abc') }
1295 list $::sync(normal) $::sync(full)
1301 execsql { INSERT INTO t1 VALUES('abc') }
1302 list $::sync(normal) $::sync(full)
1308 execsql { INSERT INTO t1 VALUES('def') }
1309 list $::sync(normal) $::sync(full)
1315 execsql { PRAGMA wal_checkpoint }
1316 list $::sync(normal) $::sync(full)