/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 0a939262ccb0b87449f98d8780396a4c293831b0:


0000: 23 20 32 30 30 31 20 53 65 70 74 65 6d 62 65 72  # 2001 September
0010: 20 31 35 0a 23 0a 23 20 54 68 65 20 61 75 74 68   15.#.# The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 23 20 61 20 6c 65 67  place of.# a leg
0060: 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 20  al notice, here 
0070: 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a 23  is a blessing:.#
0080: 0a 23 20 20 20 20 4d 61 79 20 79 6f 75 20 64 6f  .#    May you do
0090: 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 20 65 76   good and not ev
00a0: 69 6c 2e 0a 23 20 20 20 20 4d 61 79 20 79 6f 75  il..#    May you
00b0: 20 66 69 6e 64 20 66 6f 72 67 69 76 65 6e 65 73   find forgivenes
00c0: 73 20 66 6f 72 20 79 6f 75 72 73 65 6c 66 20 61  s for yourself a
00d0: 6e 64 20 66 6f 72 67 69 76 65 20 6f 74 68 65 72  nd forgive other
00e0: 73 2e 0a 23 20 20 20 20 4d 61 79 20 79 6f 75 20  s..#    May you 
00f0: 73 68 61 72 65 20 66 72 65 65 6c 79 2c 20 6e 65  share freely, ne
0100: 76 65 72 20 74 61 6b 69 6e 67 20 6d 6f 72 65 20  ver taking more 
0110: 74 68 61 6e 20 79 6f 75 20 67 69 76 65 2e 0a 23  than you give..#
0120: 0a 23 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .#**************
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 23 20 54 68 69 73  *********.# This
0170: 20 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73   file implements
0180: 20 73 6f 6d 65 20 63 6f 6d 6d 6f 6e 20 54 43 4c   some common TCL
0190: 20 72 6f 75 74 69 6e 65 73 20 75 73 65 64 20 66   routines used f
01a0: 6f 72 20 72 65 67 72 65 73 73 69 6f 6e 0a 23 20  or regression.# 
01b0: 74 65 73 74 69 6e 67 20 74 68 65 20 53 51 4c 69  testing the SQLi
01c0: 74 65 20 6c 69 62 72 61 72 79 0a 23 0a 23 20 24  te library.#.# $
01d0: 49 64 3a 20 74 65 73 74 65 72 2e 74 63 6c 2c 76  Id: tester.tcl,v
01e0: 20 31 2e 36 33 20 32 30 30 36 2f 30 31 2f 32 31   1.63 2006/01/21
01f0: 20 31 32 3a 30 38 3a 35 35 20 64 61 6e 69 65 6c   12:08:55 daniel
0200: 6b 31 39 37 37 20 45 78 70 20 24 0a 0a 23 20 4d  k1977 Exp $..# M
0210: 61 6b 65 20 73 75 72 65 20 74 63 6c 73 71 6c 69  ake sure tclsqli
0220: 74 65 33 20 77 61 73 20 63 6f 6d 70 69 6c 65 64  te3 was compiled
0230: 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 41 62 6f   correctly.  Abo
0240: 72 74 20 6e 6f 77 20 77 69 74 68 20 61 6e 0a 23  rt now with an.#
0250: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69   error message i
0260: 66 20 6e 6f 74 2e 0a 23 0a 69 66 20 7b 5b 73 71  f not..#.if {[sq
0270: 6c 69 74 65 33 20 2d 74 63 6c 2d 75 73 65 73 2d  lite3 -tcl-uses-
0280: 75 74 66 5d 7d 20 7b 0a 20 20 69 66 20 7b 22 5c  utf]} {.  if {"\
0290: 75 31 32 33 34 22 3d 3d 22 75 31 32 33 34 22 7d  u1234"=="u1234"}
02a0: 20 7b 0a 20 20 20 20 70 75 74 73 20 73 74 64 65   {.    puts stde
02b0: 72 72 20 22 2a 2a 2a 2a 2a 20 42 55 49 4c 44 20  rr "***** BUILD 
02c0: 50 52 4f 42 4c 45 4d 20 2a 2a 2a 2a 2a 22 0a 20  PROBLEM *****". 
02d0: 20 20 20 70 75 74 73 20 73 74 64 65 72 72 20 22     puts stderr "
02e0: 24 61 72 67 76 30 20 77 61 73 20 6c 69 6e 6b 65  $argv0 was linke
02f0: 64 20 61 67 61 69 6e 73 74 20 61 6e 20 6f 6c 64  d against an old
0300: 65 72 20 76 65 72 73 69 6f 6e 22 0a 20 20 20 20  er version".    
0310: 70 75 74 73 20 73 74 64 65 72 72 20 22 6f 66 20  puts stderr "of 
0320: 54 43 4c 20 74 68 61 74 20 64 6f 65 73 20 6e 6f  TCL that does no
0330: 74 20 73 75 70 70 6f 72 74 20 55 6e 69 63 6f 64  t support Unicod
0340: 65 2c 20 62 75 74 20 75 73 65 73 20 61 20 68 65  e, but uses a he
0350: 61 64 65 72 22 0a 20 20 20 20 70 75 74 73 20 73  ader".    puts s
0360: 74 64 65 72 72 20 22 66 69 6c 65 20 28 5c 22 74  tderr "file (\"t
0370: 63 6c 2e 68 5c 22 29 20 66 72 6f 6d 20 61 20 6e  cl.h\") from a n
0380: 65 77 20 54 43 4c 20 76 65 72 73 69 6f 6e 20 74  ew TCL version t
0390: 68 61 74 20 64 6f 65 73 20 73 75 70 70 6f 72 74  hat does support
03a0: 22 0a 20 20 20 20 70 75 74 73 20 73 74 64 65 72  ".    puts stder
03b0: 72 20 22 55 6e 69 63 6f 64 65 2e 20 20 54 68 69  r "Unicode.  Thi
03c0: 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 63 61  s combination ca
03d0: 75 73 65 73 20 69 6e 74 65 72 6e 61 6c 20 65 72  uses internal er
03e0: 72 6f 72 73 2e 22 0a 20 20 20 20 70 75 74 73 20  rors.".    puts 
03f0: 73 74 64 65 72 72 20 22 52 65 63 6f 6d 70 69 6c  stderr "Recompil
0400: 65 20 75 73 69 6e 67 20 61 20 54 43 4c 20 6c 69  e using a TCL li
0410: 62 72 61 72 79 20 61 6e 64 20 68 65 61 64 65 72  brary and header
0420: 20 66 69 6c 65 20 74 68 61 74 20 6d 61 74 63 68   file that match
0430: 22 0a 20 20 20 20 70 75 74 73 20 73 74 64 65 72  ".    puts stder
0440: 72 20 22 61 6e 64 20 74 72 79 20 61 67 61 69 6e  r "and try again
0450: 2e 5c 6e 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .\n*************
0460: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 22 0a 20  *************". 
0470: 20 20 20 65 78 69 74 20 31 0a 20 20 7d 0a 7d 20     exit 1.  }.} 
0480: 65 6c 73 65 20 7b 0a 20 20 69 66 20 7b 22 5c 75  else {.  if {"\u
0490: 31 32 33 34 22 21 3d 22 75 31 32 33 34 22 7d 20  1234"!="u1234"} 
04a0: 7b 0a 20 20 20 20 70 75 74 73 20 73 74 64 65 72  {.    puts stder
04b0: 72 20 22 2a 2a 2a 2a 2a 20 42 55 49 4c 44 20 50  r "***** BUILD P
04c0: 52 4f 42 4c 45 4d 20 2a 2a 2a 2a 2a 22 0a 20 20  ROBLEM *****".  
04d0: 20 20 70 75 74 73 20 73 74 64 65 72 72 20 22 24    puts stderr "$
04e0: 61 72 67 76 30 20 77 61 73 20 6c 69 6e 6b 65 64  argv0 was linked
04f0: 20 61 67 61 69 6e 73 74 20 61 6e 20 6e 65 77 65   against an newe
0500: 72 20 76 65 72 73 69 6f 6e 22 0a 20 20 20 20 70  r version".    p
0510: 75 74 73 20 73 74 64 65 72 72 20 22 6f 66 20 54  uts stderr "of T
0520: 43 4c 20 74 68 61 74 20 73 75 70 70 6f 72 74 73  CL that supports
0530: 20 55 6e 69 63 6f 64 65 2c 20 62 75 74 20 75 73   Unicode, but us
0540: 65 73 20 61 20 68 65 61 64 65 72 20 66 69 6c 65  es a header file
0550: 22 0a 20 20 20 20 70 75 74 73 20 73 74 64 65 72  ".    puts stder
0560: 72 20 22 28 5c 22 74 63 6c 2e 68 5c 22 29 20 66  r "(\"tcl.h\") f
0570: 72 6f 6d 20 61 20 6f 6c 64 20 54 43 4c 20 76 65  rom a old TCL ve
0580: 72 73 69 6f 6e 20 74 68 61 74 20 64 6f 65 73 20  rsion that does 
0590: 6e 6f 74 20 73 75 70 70 6f 72 74 22 0a 20 20 20  not support".   
05a0: 20 70 75 74 73 20 73 74 64 65 72 72 20 22 55 6e   puts stderr "Un
05b0: 69 63 6f 64 65 2e 20 20 54 68 69 73 20 63 6f 6d  icode.  This com
05c0: 62 69 6e 61 74 69 6f 6e 20 63 61 75 73 65 73 20  bination causes 
05d0: 69 6e 74 65 72 6e 61 6c 20 65 72 72 6f 72 73 2e  internal errors.
05e0: 22 0a 20 20 20 20 70 75 74 73 20 73 74 64 65 72  ".    puts stder
05f0: 72 20 22 52 65 63 6f 6d 70 69 6c 65 20 75 73 69  r "Recompile usi
0600: 6e 67 20 61 20 54 43 4c 20 6c 69 62 72 61 72 79  ng a TCL library
0610: 20 61 6e 64 20 68 65 61 64 65 72 20 66 69 6c 65   and header file
0620: 20 74 68 61 74 20 6d 61 74 63 68 22 0a 20 20 20   that match".   
0630: 20 70 75 74 73 20 73 74 64 65 72 72 20 22 61 6e   puts stderr "an
0640: 64 20 74 72 79 20 61 67 61 69 6e 2e 5c 6e 2a 2a  d try again.\n**
0650: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0660: 2a 2a 2a 2a 2a 2a 2a 2a 22 0a 20 20 20 20 65 78  ********".    ex
0670: 69 74 20 31 0a 20 20 7d 0a 7d 0a 0a 73 65 74 20  it 1.  }.}..set 
0680: 74 63 6c 5f 70 72 65 63 69 73 69 6f 6e 20 31 35  tcl_precision 15
0690: 0a 73 65 74 20 73 71 6c 69 74 65 5f 70 65 6e 64  .set sqlite_pend
06a0: 69 6e 67 5f 62 79 74 65 20 30 78 30 30 31 30 30  ing_byte 0x00100
06b0: 30 30 0a 0a 23 20 55 73 65 20 74 68 65 20 70 61  00..# Use the pa
06c0: 67 65 72 20 63 6f 64 65 63 20 69 66 20 69 74 20  ger codec if it 
06d0: 69 73 20 61 76 61 69 6c 61 62 6c 65 0a 23 0a 69  is available.#.i
06e0: 66 20 7b 5b 73 71 6c 69 74 65 33 20 2d 68 61 73  f {[sqlite3 -has
06f0: 2d 63 6f 64 65 63 5d 20 26 26 20 5b 69 6e 66 6f  -codec] && [info
0700: 20 63 6f 6d 6d 61 6e 64 20 73 71 6c 69 74 65 5f   command sqlite_
0710: 6f 72 69 67 5d 3d 3d 22 22 7d 20 7b 0a 20 20 72  orig]==""} {.  r
0720: 65 6e 61 6d 65 20 73 71 6c 69 74 65 33 20 73 71  ename sqlite3 sq
0730: 6c 69 74 65 5f 6f 72 69 67 0a 20 20 70 72 6f 63  lite_orig.  proc
0740: 20 73 71 6c 69 74 65 33 20 7b 61 72 67 73 7d 20   sqlite3 {args} 
0750: 7b 0a 20 20 20 20 69 66 20 7b 5b 6c 6c 65 6e 67  {.    if {[lleng
0760: 74 68 20 24 61 72 67 73 5d 3d 3d 32 20 26 26 20  th $args]==2 && 
0770: 5b 73 74 72 69 6e 67 20 69 6e 64 65 78 20 5b 6c  [string index [l
0780: 69 6e 64 65 78 20 24 61 72 67 73 20 30 5d 20 30  index $args 0] 0
0790: 5d 21 3d 22 2d 22 7d 20 7b 0a 20 20 20 20 20 20  ]!="-"} {.      
07a0: 6c 61 70 70 65 6e 64 20 61 72 67 73 20 2d 6b 65  lappend args -ke
07b0: 79 20 7b 78 79 7a 7a 79 7d 0a 20 20 20 20 7d 0a  y {xyzzy}.    }.
07c0: 20 20 20 20 75 70 6c 65 76 65 6c 20 31 20 73 71      uplevel 1 sq
07d0: 6c 69 74 65 5f 6f 72 69 67 20 24 61 72 67 73 0a  lite_orig $args.
07e0: 20 20 7d 0a 7d 0a 0a 0a 23 20 43 72 65 61 74 65    }.}...# Create
07f0: 20 61 20 74 65 73 74 20 64 61 74 61 62 61 73 65   a test database
0800: 0a 23 0a 63 61 74 63 68 20 7b 64 62 20 63 6c 6f  .#.catch {db clo
0810: 73 65 7d 0a 66 69 6c 65 20 64 65 6c 65 74 65 20  se}.file delete 
0820: 2d 66 6f 72 63 65 20 74 65 73 74 2e 64 62 0a 66  -force test.db.f
0830: 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f 72 63  ile delete -forc
0840: 65 20 74 65 73 74 2e 64 62 2d 6a 6f 75 72 6e 61  e test.db-journa
0850: 6c 0a 73 71 6c 69 74 65 33 20 64 62 20 2e 2f 74  l.sqlite3 db ./t
0860: 65 73 74 2e 64 62 0a 73 65 74 20 3a 3a 44 42 20  est.db.set ::DB 
0870: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 6e 65 63 74  [sqlite3_connect
0880: 69 6f 6e 5f 70 6f 69 6e 74 65 72 20 64 62 5d 0a  ion_pointer db].
0890: 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73  if {[info exists
08a0: 20 3a 3a 53 45 54 55 50 5f 53 51 4c 5d 7d 20 7b   ::SETUP_SQL]} {
08b0: 0a 20 20 64 62 20 65 76 61 6c 20 24 3a 3a 53 45  .  db eval $::SE
08c0: 54 55 50 5f 53 51 4c 0a 7d 0a 0a 23 20 41 62 6f  TUP_SQL.}..# Abo
08d0: 72 74 20 65 61 72 6c 79 20 69 66 20 74 68 69 73  rt early if this
08e0: 20 73 63 72 69 70 74 20 68 61 73 20 62 65 65 6e   script has been
08f0: 20 72 75 6e 20 62 65 66 6f 72 65 2e 0a 23 0a 69   run before..#.i
0900: 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20  f {[info exists 
0910: 6e 54 65 73 74 5d 7d 20 72 65 74 75 72 6e 0a 0a  nTest]} return..
0920: 23 20 53 65 74 20 74 68 65 20 74 65 73 74 20 63  # Set the test c
0930: 6f 75 6e 74 65 72 73 20 74 6f 20 7a 65 72 6f 0a  ounters to zero.
0940: 23 0a 73 65 74 20 6e 45 72 72 20 30 0a 73 65 74  #.set nErr 0.set
0950: 20 6e 54 65 73 74 20 30 0a 73 65 74 20 6e 50 72   nTest 0.set nPr
0960: 6f 62 20 30 0a 73 65 74 20 73 6b 69 70 5f 74 65  ob 0.set skip_te
0970: 73 74 20 30 0a 73 65 74 20 66 61 69 6c 4c 69 73  st 0.set failLis
0980: 74 20 7b 7d 0a 73 65 74 20 6d 61 78 45 72 72 20  t {}.set maxErr 
0990: 31 30 30 30 0a 0a 23 20 49 6e 76 6f 6b 65 20 74  1000..# Invoke t
09a0: 68 65 20 64 6f 5f 74 65 73 74 20 70 72 6f 63 65  he do_test proce
09b0: 64 75 72 65 20 74 6f 20 72 75 6e 20 61 20 73 69  dure to run a si
09c0: 6e 67 6c 65 20 74 65 73 74 20 0a 23 0a 70 72 6f  ngle test .#.pro
09d0: 63 20 64 6f 5f 74 65 73 74 20 7b 6e 61 6d 65 20  c do_test {name 
09e0: 63 6d 64 20 65 78 70 65 63 74 65 64 7d 20 7b 0a  cmd expected} {.
09f0: 20 20 67 6c 6f 62 61 6c 20 61 72 67 76 20 6e 45    global argv nE
0a00: 72 72 20 6e 54 65 73 74 20 73 6b 69 70 5f 74 65  rr nTest skip_te
0a10: 73 74 20 6d 61 78 45 72 72 0a 20 20 73 65 74 20  st maxErr.  set 
0a20: 3a 3a 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f  ::sqlite_malloc_
0a30: 69 64 20 24 6e 61 6d 65 0a 20 20 69 66 20 7b 24  id $name.  if {$
0a40: 73 6b 69 70 5f 74 65 73 74 7d 20 7b 0a 20 20 20  skip_test} {.   
0a50: 20 73 65 74 20 73 6b 69 70 5f 74 65 73 74 20 30   set skip_test 0
0a60: 0a 20 20 20 20 72 65 74 75 72 6e 0a 20 20 7d 0a  .    return.  }.
0a70: 20 20 69 66 20 7b 5b 6c 6c 65 6e 67 74 68 20 24    if {[llength $
0a80: 61 72 67 76 5d 3d 3d 30 7d 20 7b 20 0a 20 20 20  argv]==0} { .   
0a90: 20 73 65 74 20 67 6f 20 31 0a 20 20 7d 20 65 6c   set go 1.  } el
0aa0: 73 65 20 7b 0a 20 20 20 20 73 65 74 20 67 6f 20  se {.    set go 
0ab0: 30 0a 20 20 20 20 66 6f 72 65 61 63 68 20 70 61  0.    foreach pa
0ac0: 74 74 65 72 6e 20 24 61 72 67 76 20 7b 0a 20 20  ttern $argv {.  
0ad0: 20 20 20 20 69 66 20 7b 5b 73 74 72 69 6e 67 20      if {[string 
0ae0: 6d 61 74 63 68 20 24 70 61 74 74 65 72 6e 20 24  match $pattern $
0af0: 6e 61 6d 65 5d 7d 20 7b 0a 20 20 20 20 20 20 20  name]} {.       
0b00: 20 73 65 74 20 67 6f 20 31 0a 20 20 20 20 20 20   set go 1.      
0b10: 20 20 62 72 65 61 6b 0a 20 20 20 20 20 20 7d 0a    break.      }.
0b20: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 20 7b      }.  }.  if {
0b30: 21 24 67 6f 7d 20 72 65 74 75 72 6e 0a 20 20 69  !$go} return.  i
0b40: 6e 63 72 20 6e 54 65 73 74 0a 20 20 70 75 74 73  ncr nTest.  puts
0b50: 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24 6e 61 6d   -nonewline $nam
0b60: 65 2e 2e 2e 0a 20 20 66 6c 75 73 68 20 73 74 64  e....  flush std
0b70: 6f 75 74 0a 20 20 69 66 20 7b 5b 63 61 74 63 68  out.  if {[catch
0b80: 20 7b 75 70 6c 65 76 65 6c 20 23 30 20 22 24 63   {uplevel #0 "$c
0b90: 6d 64 3b 5c 6e 22 7d 20 72 65 73 75 6c 74 5d 7d  md;\n"} result]}
0ba0: 20 7b 0a 20 20 20 20 70 75 74 73 20 22 5c 6e 45   {.    puts "\nE
0bb0: 72 72 6f 72 3a 20 24 72 65 73 75 6c 74 22 0a 20  rror: $result". 
0bc0: 20 20 20 69 6e 63 72 20 6e 45 72 72 0a 20 20 20     incr nErr.   
0bd0: 20 6c 61 70 70 65 6e 64 20 3a 3a 66 61 69 6c 4c   lappend ::failL
0be0: 69 73 74 20 24 6e 61 6d 65 0a 20 20 20 20 69 66  ist $name.    if
0bf0: 20 7b 24 6e 45 72 72 3e 24 6d 61 78 45 72 72 7d   {$nErr>$maxErr}
0c00: 20 7b 70 75 74 73 20 22 2a 2a 2a 20 47 69 76 69   {puts "*** Givi
0c10: 6e 67 20 75 70 2e 2e 2e 22 3b 20 66 69 6e 61 6c  ng up..."; final
0c20: 69 7a 65 5f 74 65 73 74 69 6e 67 7d 0a 20 20 7d  ize_testing}.  }
0c30: 20 65 6c 73 65 69 66 20 7b 5b 73 74 72 69 6e 67   elseif {[string
0c40: 20 63 6f 6d 70 61 72 65 20 24 72 65 73 75 6c 74   compare $result
0c50: 20 24 65 78 70 65 63 74 65 64 5d 7d 20 7b 0a 20   $expected]} {. 
0c60: 20 20 20 70 75 74 73 20 22 5c 6e 45 78 70 65 63     puts "\nExpec
0c70: 74 65 64 3a 20 5c 5b 24 65 78 70 65 63 74 65 64  ted: \[$expected
0c80: 5c 5d 5c 6e 20 20 20 20 20 47 6f 74 3a 20 5c 5b  \]\n     Got: \[
0c90: 24 72 65 73 75 6c 74 5c 5d 22 0a 20 20 20 20 69  $result\]".    i
0ca0: 6e 63 72 20 6e 45 72 72 0a 20 20 20 20 6c 61 70  ncr nErr.    lap
0cb0: 70 65 6e 64 20 3a 3a 66 61 69 6c 4c 69 73 74 20  pend ::failList 
0cc0: 24 6e 61 6d 65 0a 20 20 20 20 69 66 20 7b 24 6e  $name.    if {$n
0cd0: 45 72 72 3e 3d 24 6d 61 78 45 72 72 7d 20 7b 70  Err>=$maxErr} {p
0ce0: 75 74 73 20 22 2a 2a 2a 20 47 69 76 69 6e 67 20  uts "*** Giving 
0cf0: 75 70 2e 2e 2e 22 3b 20 66 69 6e 61 6c 69 7a 65  up..."; finalize
0d00: 5f 74 65 73 74 69 6e 67 7d 0a 20 20 7d 20 65 6c  _testing}.  } el
0d10: 73 65 20 7b 0a 20 20 20 20 70 75 74 73 20 22 20  se {.    puts " 
0d20: 4f 6b 22 0a 20 20 7d 0a 7d 0a 0a 23 20 54 68 65  Ok".  }.}..# The
0d30: 20 70 72 6f 63 65 64 75 72 65 20 75 73 65 73 20   procedure uses 
0d40: 74 68 65 20 73 70 65 63 69 61 6c 20 22 73 71 6c  the special "sql
0d50: 69 74 65 5f 6d 61 6c 6c 6f 63 5f 73 74 61 74 22  ite_malloc_stat"
0d60: 20 63 6f 6d 6d 61 6e 64 0a 23 20 28 77 68 69 63   command.# (whic
0d70: 68 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61  h is only availa
0d80: 62 6c 65 20 69 66 20 53 51 4c 69 74 65 20 69 73  ble if SQLite is
0d90: 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 2d   compiled with -
0da0: 44 53 51 4c 49 54 45 5f 44 45 42 55 47 3d 31 29  DSQLITE_DEBUG=1)
0db0: 0a 23 20 74 6f 20 73 65 65 20 68 6f 77 20 6d 61  .# to see how ma
0dc0: 6e 79 20 6d 61 6c 6c 6f 63 28 29 73 20 68 61 76  ny malloc()s hav
0dd0: 65 20 6e 6f 74 20 62 65 65 6e 20 66 72 65 65 28  e not been free(
0de0: 29 65 64 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  )ed.  The number
0df0: 0a 23 20 6f 66 20 73 75 72 70 6c 75 73 20 6d 61  .# of surplus ma
0e00: 6c 6c 6f 63 28 29 73 20 69 73 20 73 74 6f 72 65  lloc()s is store
0e10: 64 20 69 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20  d in the global 
0e20: 76 61 72 69 61 62 6c 65 20 24 3a 3a 4c 65 61 6b  variable $::Leak
0e30: 2e 0a 23 20 49 66 20 74 68 65 20 76 61 6c 75 65  ..# If the value
0e40: 20 69 6e 20 24 3a 3a 4c 65 61 6b 20 67 72 6f 77   in $::Leak grow
0e50: 73 2c 20 69 74 20 6d 61 79 20 6d 65 61 6e 20 74  s, it may mean t
0e60: 68 65 72 65 20 69 73 20 61 20 6d 65 6d 6f 72 79  here is a memory
0e70: 20 6c 65 61 6b 0a 23 20 69 6e 20 74 68 65 20 6c   leak.# in the l
0e80: 69 62 72 61 72 79 2e 0a 23 0a 70 72 6f 63 20 6d  ibrary..#.proc m
0e90: 65 6d 6c 65 61 6b 5f 63 68 65 63 6b 20 7b 7d 20  emleak_check {} 
0ea0: 7b 0a 20 20 69 66 20 7b 5b 69 6e 66 6f 20 63 6f  {.  if {[info co
0eb0: 6d 6d 61 6e 64 20 73 71 6c 69 74 65 5f 6d 61 6c  mmand sqlite_mal
0ec0: 6c 6f 63 5f 73 74 61 74 5d 21 3d 22 22 7d 20 7b  loc_stat]!=""} {
0ed0: 0a 20 20 20 20 73 65 74 20 72 20 5b 73 71 6c 69  .    set r [sqli
0ee0: 74 65 5f 6d 61 6c 6c 6f 63 5f 73 74 61 74 5d 0a  te_malloc_stat].
0ef0: 20 20 20 20 73 65 74 20 3a 3a 4c 65 61 6b 20 5b      set ::Leak [
0f00: 65 78 70 72 20 7b 5b 6c 69 6e 64 65 78 20 24 72  expr {[lindex $r
0f10: 20 30 5d 2d 5b 6c 69 6e 64 65 78 20 24 72 20 31   0]-[lindex $r 1
0f20: 5d 7d 5d 0a 20 20 7d 0a 7d 0a 0a 23 20 52 75 6e  ]}].  }.}..# Run
0f30: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6c 61   this routine la
0f40: 73 74 0a 23 0a 70 72 6f 63 20 66 69 6e 69 73 68  st.#.proc finish
0f50: 5f 74 65 73 74 20 7b 7d 20 7b 0a 20 20 66 69 6e  _test {} {.  fin
0f60: 61 6c 69 7a 65 5f 74 65 73 74 69 6e 67 0a 7d 0a  alize_testing.}.
0f70: 70 72 6f 63 20 66 69 6e 61 6c 69 7a 65 5f 74 65  proc finalize_te
0f80: 73 74 69 6e 67 20 7b 7d 20 7b 0a 20 20 67 6c 6f  sting {} {.  glo
0f90: 62 61 6c 20 6e 54 65 73 74 20 6e 45 72 72 20 6e  bal nTest nErr n
0fa0: 50 72 6f 62 20 73 71 6c 69 74 65 5f 6f 70 65 6e  Prob sqlite_open
0fb0: 5f 66 69 6c 65 5f 63 6f 75 6e 74 0a 20 20 69 66  _file_count.  if
0fc0: 20 7b 24 6e 45 72 72 3d 3d 30 7d 20 6d 65 6d 6c   {$nErr==0} meml
0fd0: 65 61 6b 5f 63 68 65 63 6b 0a 0a 20 20 63 61 74  eak_check..  cat
0fe0: 63 68 20 7b 64 62 20 63 6c 6f 73 65 7d 0a 20 20  ch {db close}.  
0ff0: 63 61 74 63 68 20 7b 64 62 32 20 63 6c 6f 73 65  catch {db2 close
1000: 7d 0a 20 20 63 61 74 63 68 20 7b 64 62 33 20 63  }.  catch {db3 c
1010: 6c 6f 73 65 7d 0a 0a 20 20 63 61 74 63 68 20 7b  lose}..  catch {
1020: 0a 20 20 20 20 70 70 5f 63 68 65 63 6b 5f 66 6f  .    pp_check_fo
1030: 72 5f 6c 65 61 6b 73 0a 20 20 7d 0a 20 20 73 71  r_leaks.  }.  sq
1040: 6c 69 74 65 33 20 64 62 20 7b 7d 0a 20 20 23 20  lite3 db {}.  # 
1050: 73 71 6c 69 74 65 33 5f 63 6c 65 61 72 5f 74 73  sqlite3_clear_ts
1060: 64 5f 6d 65 6d 64 65 62 75 67 0a 20 20 64 62 20  d_memdebug.  db 
1070: 63 6c 6f 73 65 0a 20 20 69 66 20 7b 24 3a 3a 73  close.  if {$::s
1080: 71 6c 69 74 65 33 5f 74 73 64 5f 63 6f 75 6e 74  qlite3_tsd_count
1090: 7d 20 7b 0a 20 20 20 20 20 70 75 74 73 20 22 54  } {.     puts "T
10a0: 68 72 65 61 64 2d 73 70 65 63 69 66 69 63 20 64  hread-specific d
10b0: 61 74 61 20 6c 65 61 6b 3a 20 24 3a 3a 73 71 6c  ata leak: $::sql
10c0: 69 74 65 33 5f 74 73 64 5f 63 6f 75 6e 74 20 69  ite3_tsd_count i
10d0: 6e 73 74 61 6e 63 65 73 22 0a 20 20 20 20 20 69  nstances".     i
10e0: 6e 63 72 20 6e 45 72 72 0a 20 20 7d 20 65 6c 73  ncr nErr.  } els
10f0: 65 20 7b 0a 20 20 20 20 20 70 75 74 73 20 22 54  e {.     puts "T
1100: 68 72 65 61 64 2d 73 70 65 63 69 66 69 63 20 64  hread-specific d
1110: 61 74 61 20 64 65 61 6c 6c 6f 63 61 74 65 64 20  ata deallocated 
1120: 70 72 6f 70 65 72 6c 79 22 0a 20 20 7d 0a 20 20  properly".  }.  
1130: 69 6e 63 72 20 6e 54 65 73 74 0a 20 20 70 75 74  incr nTest.  put
1140: 73 20 22 24 6e 45 72 72 20 65 72 72 6f 72 73 20  s "$nErr errors 
1150: 6f 75 74 20 6f 66 20 24 6e 54 65 73 74 20 74 65  out of $nTest te
1160: 73 74 73 22 0a 20 20 70 75 74 73 20 22 46 61 69  sts".  puts "Fai
1170: 6c 75 72 65 73 20 6f 6e 20 74 68 65 73 65 20 74  lures on these t
1180: 65 73 74 73 3a 20 24 3a 3a 66 61 69 6c 4c 69 73  ests: $::failLis
1190: 74 22 0a 20 20 69 66 20 7b 24 6e 50 72 6f 62 3e  t".  if {$nProb>
11a0: 30 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22 24  0} {.    puts "$
11b0: 6e 50 72 6f 62 20 70 72 6f 62 61 62 69 6c 69 73  nProb probabilis
11c0: 74 69 63 20 74 65 73 74 73 20 61 6c 73 6f 20 66  tic tests also f
11d0: 61 69 6c 65 64 2c 20 62 75 74 20 74 68 69 73 20  ailed, but this 
11e0: 64 6f 65 73 22 0a 20 20 20 20 70 75 74 73 20 22  does".    puts "
11f0: 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20  not necessarily 
1200: 69 6e 64 69 63 61 74 65 20 61 20 6d 61 6c 66 75  indicate a malfu
1210: 6e 63 74 69 6f 6e 2e 22 0a 20 20 7d 0a 20 20 69  nction.".  }.  i
1220: 66 20 30 20 7b 0a 20 20 69 66 20 7b 24 73 71 6c  f 0 {.  if {$sql
1230: 69 74 65 5f 6f 70 65 6e 5f 66 69 6c 65 5f 63 6f  ite_open_file_co
1240: 75 6e 74 7d 20 7b 0a 20 20 20 20 70 75 74 73 20  unt} {.    puts 
1250: 22 24 73 71 6c 69 74 65 5f 6f 70 65 6e 5f 66 69  "$sqlite_open_fi
1260: 6c 65 5f 63 6f 75 6e 74 20 66 69 6c 65 73 20 77  le_count files w
1270: 65 72 65 20 6c 65 66 74 20 6f 70 65 6e 22 0a 20  ere left open". 
1280: 20 20 20 69 6e 63 72 20 6e 45 72 72 0a 20 20 7d     incr nErr.  }
1290: 0a 20 20 7d 0a 20 20 65 78 69 74 20 5b 65 78 70  .  }.  exit [exp
12a0: 72 20 7b 24 6e 45 72 72 3e 30 7d 5d 0a 7d 0a 0a  r {$nErr>0}].}..
12b0: 23 20 41 20 70 72 6f 63 65 64 75 72 65 20 74 6f  # A procedure to
12c0: 20 65 78 65 63 75 74 65 20 53 51 4c 0a 23 0a 70   execute SQL.#.p
12d0: 72 6f 63 20 65 78 65 63 73 71 6c 20 7b 73 71 6c  roc execsql {sql
12e0: 20 7b 64 62 20 64 62 7d 7d 20 7b 0a 20 20 23 20   {db db}} {.  # 
12f0: 70 75 74 73 20 22 53 51 4c 20 3d 20 24 73 71 6c  puts "SQL = $sql
1300: 22 0a 20 20 75 70 6c 65 76 65 6c 20 5b 6c 69 73  ".  uplevel [lis
1310: 74 20 24 64 62 20 65 76 61 6c 20 24 73 71 6c 5d  t $db eval $sql]
1320: 0a 7d 0a 0a 23 20 45 78 65 63 75 74 65 20 53 51  .}..# Execute SQ
1330: 4c 20 61 6e 64 20 63 61 74 63 68 20 65 78 63 65  L and catch exce
1340: 70 74 69 6f 6e 73 2e 0a 23 0a 70 72 6f 63 20 63  ptions..#.proc c
1350: 61 74 63 68 73 71 6c 20 7b 73 71 6c 20 7b 64 62  atchsql {sql {db
1360: 20 64 62 7d 7d 20 7b 0a 20 20 23 20 70 75 74 73   db}} {.  # puts
1370: 20 22 53 51 4c 20 3d 20 24 73 71 6c 22 0a 20 20   "SQL = $sql".  
1380: 73 65 74 20 72 20 5b 63 61 74 63 68 20 7b 24 64  set r [catch {$d
1390: 62 20 65 76 61 6c 20 24 73 71 6c 7d 20 6d 73 67  b eval $sql} msg
13a0: 5d 0a 20 20 6c 61 70 70 65 6e 64 20 72 20 24 6d  ].  lappend r $m
13b0: 73 67 0a 20 20 72 65 74 75 72 6e 20 24 72 0a 7d  sg.  return $r.}
13c0: 0a 0a 23 20 44 6f 20 61 6e 20 56 44 42 45 20 63  ..# Do an VDBE c
13d0: 6f 64 65 20 64 75 6d 70 20 6f 6e 20 74 68 65 20  ode dump on the 
13e0: 53 51 4c 20 67 69 76 65 6e 0a 23 0a 70 72 6f 63  SQL given.#.proc
13f0: 20 65 78 70 6c 61 69 6e 20 7b 73 71 6c 20 7b 64   explain {sql {d
1400: 62 20 64 62 7d 7d 20 7b 0a 20 20 70 75 74 73 20  b db}} {.  puts 
1410: 22 22 0a 20 20 70 75 74 73 20 22 61 64 64 72 20  "".  puts "addr 
1420: 20 6f 70 63 6f 64 65 20 20 20 20 20 20 20 20 70   opcode        p
1430: 31 20 20 20 20 20 20 20 70 32 20 20 20 20 20 70  1       p2     p
1440: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 22 0a  3             ".
1450: 20 20 70 75 74 73 20 22 2d 2d 2d 2d 20 20 2d 2d    puts "----  --
1460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d  ----------  ----
1470: 2d 2d 20 20 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d  --  ------  ----
1480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 22 0a 20 20 24  -----------".  $
1490: 64 62 20 65 76 61 6c 20 22 65 78 70 6c 61 69 6e  db eval "explain
14a0: 20 24 73 71 6c 22 20 7b 7d 20 7b 0a 20 20 20 20   $sql" {} {.    
14b0: 70 75 74 73 20 5b 66 6f 72 6d 61 74 20 7b 25 2d  puts [format {%-
14c0: 34 64 20 20 25 2d 31 32 2e 31 32 73 20 20 25 2d  4d  %-12.12s  %-
14d0: 36 64 20 20 25 2d 36 64 20 20 25 73 7d 20 24 61  6d  %-6d  %s} $a
14e0: 64 64 72 20 24 6f 70 63 6f 64 65 20 24 70 31 20  ddr $opcode $p1 
14f0: 24 70 32 20 24 70 33 5d 0a 20 20 7d 0a 7d 0a 0a  $p2 $p3].  }.}..
1500: 23 20 41 6e 6f 74 68 65 72 20 70 72 6f 63 65 64  # Another proced
1510: 75 72 65 20 74 6f 20 65 78 65 63 75 74 65 20 53  ure to execute S
1520: 51 4c 2e 20 20 54 68 69 73 20 6f 6e 65 20 69 6e  QL.  This one in
1530: 63 6c 75 64 65 73 20 74 68 65 20 66 69 65 6c 64  cludes the field
1540: 0a 23 20 6e 61 6d 65 73 20 69 6e 20 74 68 65 20  .# names in the 
1550: 72 65 74 75 72 6e 65 64 20 6c 69 73 74 2e 0a 23  returned list..#
1560: 0a 70 72 6f 63 20 65 78 65 63 73 71 6c 32 20 7b  .proc execsql2 {
1570: 73 71 6c 7d 20 7b 0a 20 20 73 65 74 20 72 65 73  sql} {.  set res
1580: 75 6c 74 20 7b 7d 0a 20 20 64 62 20 65 76 61 6c  ult {}.  db eval
1590: 20 24 73 71 6c 20 64 61 74 61 20 7b 0a 20 20 20   $sql data {.   
15a0: 20 66 6f 72 65 61 63 68 20 66 20 24 64 61 74 61   foreach f $data
15b0: 28 2a 29 20 7b 0a 20 20 20 20 20 20 6c 61 70 70  (*) {.      lapp
15c0: 65 6e 64 20 72 65 73 75 6c 74 20 24 66 20 24 64  end result $f $d
15d0: 61 74 61 28 24 66 29 0a 20 20 20 20 7d 0a 20 20  ata($f).    }.  
15e0: 7d 0a 20 20 72 65 74 75 72 6e 20 24 72 65 73 75  }.  return $resu
15f0: 6c 74 0a 7d 0a 0a 23 20 55 73 65 20 74 68 65 20  lt.}..# Use the 
1600: 6e 6f 6e 2d 63 61 6c 6c 62 61 63 6b 20 41 50 49  non-callback API
1610: 20 74 6f 20 65 78 65 63 75 74 65 20 6d 75 6c 74   to execute mult
1620: 69 70 6c 65 20 53 51 4c 20 73 74 61 74 65 6d 65  iple SQL stateme
1630: 6e 74 73 0a 23 0a 70 72 6f 63 20 73 74 65 70 73  nts.#.proc steps
1640: 71 6c 20 7b 64 62 70 74 72 20 73 71 6c 7d 20 7b  ql {dbptr sql} {
1650: 0a 20 20 73 65 74 20 73 71 6c 20 5b 73 74 72 69  .  set sql [stri
1660: 6e 67 20 74 72 69 6d 20 24 73 71 6c 5d 0a 20 20  ng trim $sql].  
1670: 73 65 74 20 72 20 30 0a 20 20 77 68 69 6c 65 20  set r 0.  while 
1680: 7b 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20  {[string length 
1690: 24 73 71 6c 5d 3e 30 7d 20 7b 0a 20 20 20 20 69  $sql]>0} {.    i
16a0: 66 20 7b 5b 63 61 74 63 68 20 7b 73 71 6c 69 74  f {[catch {sqlit
16b0: 65 33 5f 70 72 65 70 61 72 65 20 24 64 62 70 74  e3_prepare $dbpt
16c0: 72 20 24 73 71 6c 20 2d 31 20 73 71 6c 74 61 69  r $sql -1 sqltai
16d0: 6c 7d 20 76 6d 5d 7d 20 7b 0a 20 20 20 20 20 20  l} vm]} {.      
16e0: 72 65 74 75 72 6e 20 5b 6c 69 73 74 20 31 20 24  return [list 1 $
16f0: 76 6d 5d 0a 20 20 20 20 7d 0a 20 20 20 20 73 65  vm].    }.    se
1700: 74 20 73 71 6c 20 5b 73 74 72 69 6e 67 20 74 72  t sql [string tr
1710: 69 6d 20 24 73 71 6c 74 61 69 6c 5d 0a 23 20 20  im $sqltail].#  
1720: 20 20 77 68 69 6c 65 20 7b 5b 73 71 6c 69 74 65    while {[sqlite
1730: 5f 73 74 65 70 20 24 76 6d 20 4e 20 56 41 4c 20  _step $vm N VAL 
1740: 43 4f 4c 5d 3d 3d 22 53 51 4c 49 54 45 5f 52 4f  COL]=="SQLITE_RO
1750: 57 22 7d 20 7b 0a 23 20 20 20 20 20 20 66 6f 72  W"} {.#      for
1760: 65 61 63 68 20 76 20 24 56 41 4c 20 7b 6c 61 70  each v $VAL {lap
1770: 70 65 6e 64 20 72 20 24 76 7d 0a 23 20 20 20 20  pend r $v}.#    
1780: 7d 0a 20 20 20 20 77 68 69 6c 65 20 7b 5b 73 71  }.    while {[sq
1790: 6c 69 74 65 33 5f 73 74 65 70 20 24 76 6d 5d 3d  lite3_step $vm]=
17a0: 3d 22 53 51 4c 49 54 45 5f 52 4f 57 22 7d 20 7b  ="SQLITE_ROW"} {
17b0: 0a 20 20 20 20 20 20 66 6f 72 20 7b 73 65 74 20  .      for {set 
17c0: 69 20 30 7d 20 7b 24 69 3c 5b 73 71 6c 69 74 65  i 0} {$i<[sqlite
17d0: 33 5f 64 61 74 61 5f 63 6f 75 6e 74 20 24 76 6d  3_data_count $vm
17e0: 5d 7d 20 7b 69 6e 63 72 20 69 7d 20 7b 0a 20 20  ]} {incr i} {.  
17f0: 20 20 20 20 20 20 6c 61 70 70 65 6e 64 20 72 20        lappend r 
1800: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
1810: 74 65 78 74 20 24 76 6d 20 24 69 5d 0a 20 20 20  text $vm $i].   
1820: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69     }.    }.    i
1830: 66 20 7b 5b 63 61 74 63 68 20 7b 73 71 6c 69 74  f {[catch {sqlit
1840: 65 33 5f 66 69 6e 61 6c 69 7a 65 20 24 76 6d 7d  e3_finalize $vm}
1850: 20 65 72 72 6d 73 67 5d 7d 20 7b 0a 20 20 20 20   errmsg]} {.    
1860: 20 20 72 65 74 75 72 6e 20 5b 6c 69 73 74 20 31    return [list 1
1870: 20 24 65 72 72 6d 73 67 5d 0a 20 20 20 20 7d 0a   $errmsg].    }.
1880: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 24 72 0a    }.  return $r.
1890: 7d 0a 0a 23 20 44 65 6c 65 74 65 20 61 20 66 69  }..# Delete a fi
18a0: 6c 65 20 6f 72 20 64 69 72 65 63 74 6f 72 79 0a  le or directory.
18b0: 23 0a 70 72 6f 63 20 66 6f 72 63 65 64 65 6c 65  #.proc forcedele
18c0: 74 65 20 7b 66 69 6c 65 6e 61 6d 65 7d 20 7b 0a  te {filename} {.
18d0: 20 20 69 66 20 7b 5b 63 61 74 63 68 20 7b 66 69    if {[catch {fi
18e0: 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f 72 63 65  le delete -force
18f0: 20 24 66 69 6c 65 6e 61 6d 65 7d 5d 7d 20 7b 0a   $filename}]} {.
1900: 20 20 20 20 65 78 65 63 20 72 6d 20 2d 72 66 20      exec rm -rf 
1910: 24 66 69 6c 65 6e 61 6d 65 0a 20 20 7d 0a 7d 0a  $filename.  }.}.
1920: 0a 23 20 44 6f 20 61 6e 20 69 6e 74 65 67 72 69  .# Do an integri
1930: 74 79 20 63 68 65 63 6b 20 6f 66 20 74 68 65 20  ty check of the 
1940: 65 6e 74 69 72 65 20 64 61 74 61 62 61 73 65 0a  entire database.
1950: 23 0a 70 72 6f 63 20 69 6e 74 65 67 72 69 74 79  #.proc integrity
1960: 5f 63 68 65 63 6b 20 7b 6e 61 6d 65 7d 20 7b 0a  _check {name} {.
1970: 20 20 69 66 63 61 70 61 62 6c 65 20 69 6e 74 65    ifcapable inte
1980: 67 72 69 74 79 63 6b 20 7b 0a 20 20 20 20 64 6f  grityck {.    do
1990: 5f 74 65 73 74 20 24 6e 61 6d 65 20 7b 0a 20 20  _test $name {.  
19a0: 20 20 20 20 65 78 65 63 73 71 6c 20 7b 50 52 41      execsql {PRA
19b0: 47 4d 41 20 69 6e 74 65 67 72 69 74 79 5f 63 68  GMA integrity_ch
19c0: 65 63 6b 7d 0a 20 20 20 20 7d 20 7b 6f 6b 7d 0a  eck}.    } {ok}.
19d0: 20 20 7d 0a 7d 0a 0a 23 20 45 76 61 6c 75 61 74    }.}..# Evaluat
19e0: 65 20 61 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72  e a boolean expr
19f0: 65 73 73 69 6f 6e 20 6f 66 20 63 61 70 61 62 69  ession of capabi
1a00: 6c 69 74 69 65 73 2e 20 20 49 66 20 74 72 75 65  lities.  If true
1a10: 2c 20 65 78 65 63 75 74 65 20 74 68 65 0a 23 20  , execute the.# 
1a20: 63 6f 64 65 2e 20 20 4f 6d 69 74 20 74 68 65 20  code.  Omit the 
1a30: 63 6f 64 65 20 69 66 20 66 61 6c 73 65 2e 0a 23  code if false..#
1a40: 0a 70 72 6f 63 20 69 66 63 61 70 61 62 6c 65 20  .proc ifcapable 
1a50: 7b 65 78 70 72 20 63 6f 64 65 20 7b 65 6c 73 65  {expr code {else
1a60: 20 22 22 7d 20 7b 65 6c 73 65 63 6f 64 65 20 22   ""} {elsecode "
1a70: 22 7d 7d 20 7b 0a 20 20 72 65 67 73 75 62 20 2d  "}} {.  regsub -
1a80: 61 6c 6c 20 7b 5b 61 2d 7a 5f 30 2d 39 5d 2b 7d  all {[a-z_0-9]+}
1a90: 20 24 65 78 70 72 20 7b 24 3a 3a 73 71 6c 69 74   $expr {$::sqlit
1aa0: 65 5f 6f 70 74 69 6f 6e 73 28 26 29 7d 20 65 32  e_options(&)} e2
1ab0: 0a 20 20 69 66 20 28 24 65 32 29 20 7b 0a 20 20  .  if ($e2) {.  
1ac0: 20 20 73 65 74 20 63 20 5b 63 61 74 63 68 20 7b    set c [catch {
1ad0: 75 70 6c 65 76 65 6c 20 31 20 24 63 6f 64 65 7d  uplevel 1 $code}
1ae0: 20 72 5d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20   r].  } else {. 
1af0: 20 20 20 73 65 74 20 63 20 5b 63 61 74 63 68 20     set c [catch 
1b00: 7b 75 70 6c 65 76 65 6c 20 31 20 24 65 6c 73 65  {uplevel 1 $else
1b10: 63 6f 64 65 7d 20 72 5d 0a 20 20 7d 0a 20 20 72  code} r].  }.  r
1b20: 65 74 75 72 6e 20 2d 63 6f 64 65 20 24 63 20 24  eturn -code $c $
1b30: 72 0a 7d 0a 0a 23 20 54 68 69 73 20 70 72 6f 63  r.}..# This proc
1b40: 20 65 78 65 63 73 20 61 20 73 65 70 65 72 61 74   execs a seperat
1b50: 65 20 70 72 6f 63 65 73 73 20 74 68 61 74 20 63  e process that c
1b60: 72 61 73 68 65 73 20 6d 69 64 77 61 79 20 74 68  rashes midway th
1b70: 72 6f 75 67 68 20 65 78 65 63 75 74 69 6e 67 0a  rough executing.
1b80: 23 20 74 68 65 20 53 51 4c 20 73 63 72 69 70 74  # the SQL script
1b90: 20 24 73 71 6c 20 6f 6e 20 64 61 74 61 62 61 73   $sql on databas
1ba0: 65 20 74 65 73 74 2e 64 62 2e 0a 23 0a 23 20 54  e test.db..#.# T
1bb0: 68 65 20 63 72 61 73 68 20 6f 63 63 75 72 73 20  he crash occurs 
1bc0: 64 75 72 69 6e 67 20 61 20 73 79 6e 63 28 29 20  during a sync() 
1bd0: 6f 66 20 66 69 6c 65 20 24 63 72 61 73 68 66 69  of file $crashfi
1be0: 6c 65 2e 20 57 68 65 6e 20 74 68 65 20 63 72 61  le. When the cra
1bf0: 73 68 0a 23 20 6f 63 63 75 72 73 20 61 20 72 61  sh.# occurs a ra
1c00: 6e 64 6f 6d 20 73 75 62 73 65 74 20 6f 66 20 61  ndom subset of a
1c10: 6c 6c 20 75 6e 73 79 6e 63 65 64 20 77 72 69 74  ll unsynced writ
1c20: 65 73 20 6d 61 64 65 20 62 79 20 74 68 65 20 70  es made by the p
1c30: 72 6f 63 65 73 73 20 61 72 65 0a 23 20 77 72 69  rocess are.# wri
1c40: 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 66 69  tten into the fi
1c50: 6c 65 73 20 6f 6e 20 64 69 73 6b 2e 20 41 72 67  les on disk. Arg
1c60: 75 6d 65 6e 74 20 24 63 72 61 73 68 64 65 6c 61  ument $crashdela
1c70: 79 20 69 6e 64 69 63 61 74 65 73 20 74 68 65 0a  y indicates the.
1c80: 23 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 6c 65  # number of file
1c90: 20 73 79 6e 63 73 20 74 6f 20 77 61 69 74 20 62   syncs to wait b
1ca0: 65 66 6f 72 65 20 63 72 61 73 68 69 6e 67 2e 0a  efore crashing..
1cb0: 23 0a 23 20 54 68 65 20 72 65 74 75 72 6e 20 76  #.# The return v
1cc0: 61 6c 75 65 20 69 73 20 61 20 6c 69 73 74 20 6f  alue is a list o
1cd0: 66 20 74 77 6f 20 65 6c 65 6d 65 6e 74 73 2e 20  f two elements. 
1ce0: 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e  The first elemen
1cf0: 74 20 69 73 20 61 0a 23 20 62 6f 6f 6c 65 61 6e  t is a.# boolean
1d00: 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 77 68 65  , indicating whe
1d10: 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20  ther or not the 
1d20: 70 72 6f 63 65 73 73 20 61 63 74 75 61 6c 6c 79  process actually
1d30: 20 63 72 61 73 68 65 64 20 6f 72 0a 23 20 72 65   crashed or.# re
1d40: 70 6f 72 74 65 64 20 73 6f 6d 65 20 6f 74 68 65  ported some othe
1d50: 72 20 65 72 72 6f 72 2e 20 54 68 65 20 73 65 63  r error. The sec
1d60: 6f 6e 64 20 65 6c 65 6d 65 6e 74 20 69 6e 20 74  ond element in t
1d70: 68 65 20 72 65 74 75 72 6e 65 64 20 6c 69 73 74  he returned list
1d80: 20 69 73 20 74 68 65 0a 23 20 65 72 72 6f 72 20   is the.# error 
1d90: 6d 65 73 73 61 67 65 2e 20 54 68 69 73 20 69 73  message. This is
1da0: 20 22 63 68 69 6c 64 20 70 72 6f 63 65 73 73 20   "child process 
1db0: 65 78 69 74 65 64 20 61 62 6e 6f 72 6d 61 6c 6c  exited abnormall
1dc0: 79 22 20 69 66 20 74 68 65 20 63 72 61 73 68 0a  y" if the crash.
1dd0: 23 20 6f 63 63 75 72 65 64 2e 0a 23 0a 70 72 6f  # occured..#.pro
1de0: 63 20 63 72 61 73 68 73 71 6c 20 7b 63 72 61 73  c crashsql {cras
1df0: 68 64 65 6c 61 79 20 63 72 61 73 68 66 69 6c 65  hdelay crashfile
1e00: 20 73 71 6c 7d 20 7b 0a 20 20 69 66 20 7b 24 3a   sql} {.  if {$:
1e10: 3a 74 63 6c 5f 70 6c 61 74 66 6f 72 6d 28 70 6c  :tcl_platform(pl
1e20: 61 74 66 6f 72 6d 29 21 3d 22 75 6e 69 78 22 7d  atform)!="unix"}
1e30: 20 7b 0a 20 20 20 20 65 72 72 6f 72 20 22 63 72   {.    error "cr
1e40: 61 73 68 73 71 6c 20 73 68 6f 75 6c 64 20 6f 6e  ashsql should on
1e50: 6c 79 20 62 65 20 75 73 65 64 20 6f 6e 20 75 6e  ly be used on un
1e60: 69 78 22 0a 20 20 7d 0a 20 20 73 65 74 20 63 66  ix".  }.  set cf
1e70: 69 6c 65 20 5b 66 69 6c 65 20 6a 6f 69 6e 20 5b  ile [file join [
1e80: 70 77 64 5d 20 24 63 72 61 73 68 66 69 6c 65 5d  pwd] $crashfile]
1e90: 0a 0a 20 20 73 65 74 20 66 20 5b 6f 70 65 6e 20  ..  set f [open 
1ea0: 63 72 61 73 68 2e 74 63 6c 20 77 5d 0a 20 20 70  crash.tcl w].  p
1eb0: 75 74 73 20 24 66 20 22 73 71 6c 69 74 65 33 5f  uts $f "sqlite3_
1ec0: 63 72 61 73 68 70 61 72 61 6d 73 20 24 63 72 61  crashparams $cra
1ed0: 73 68 64 65 6c 61 79 20 24 63 66 69 6c 65 22 0a  shdelay $cfile".
1ee0: 20 20 70 75 74 73 20 24 66 20 22 73 71 6c 69 74    puts $f "sqlit
1ef0: 65 33 20 64 62 20 74 65 73 74 2e 64 62 22 0a 20  e3 db test.db". 
1f00: 20 70 75 74 73 20 24 66 20 22 64 62 20 65 76 61   puts $f "db eva
1f10: 6c 20 7b 70 72 61 67 6d 61 20 63 61 63 68 65 5f  l {pragma cache_
1f20: 73 69 7a 65 20 3d 20 31 30 7d 22 0a 20 20 70 75  size = 10}".  pu
1f30: 74 73 20 24 66 20 22 64 62 20 65 76 61 6c 20 7b  ts $f "db eval {
1f40: 22 0a 20 20 70 75 74 73 20 24 66 20 20 20 22 24  ".  puts $f   "$
1f50: 73 71 6c 22 0a 20 20 70 75 74 73 20 24 66 20 22  sql".  puts $f "
1f60: 7d 22 0a 20 20 63 6c 6f 73 65 20 24 66 0a 0a 20  }".  close $f.. 
1f70: 20 73 65 74 20 72 20 5b 63 61 74 63 68 20 7b 0a   set r [catch {.
1f80: 20 20 20 20 65 78 65 63 20 5b 69 6e 66 6f 20 6e      exec [info n
1f90: 61 6d 65 6f 66 65 78 65 63 5d 20 63 72 61 73 68  ameofexec] crash
1fa0: 2e 74 63 6c 20 3e 40 73 74 64 6f 75 74 0a 20 20  .tcl >@stdout.  
1fb0: 7d 20 6d 73 67 5d 0a 20 20 6c 61 70 70 65 6e 64  } msg].  lappend
1fc0: 20 72 20 24 6d 73 67 0a 7d 0a 0a 23 20 55 73 61   r $msg.}..# Usa
1fd0: 67 65 3a 20 64 6f 5f 69 6f 65 72 72 5f 74 65 73  ge: do_ioerr_tes
1fe0: 74 20 3c 74 65 73 74 20 6e 75 6d 62 65 72 3e 20  t <test number> 
1ff0: 3c 6f 70 74 69 6f 6e 73 2e 2e 2e 3e 0a 23 0a 23  <options...>.#.#
2000: 20 54 68 69 73 20 70 72 6f 63 20 69 73 20 75 73   This proc is us
2010: 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20  ed to implement 
2020: 74 65 73 74 20 63 61 73 65 73 20 74 68 61 74 20  test cases that 
2030: 63 68 65 63 6b 20 74 68 61 74 20 49 4f 20 65 72  check that IO er
2040: 72 6f 72 73 0a 23 20 61 72 65 20 63 6f 72 72 65  rors.# are corre
2050: 63 74 6c 79 20 68 61 6e 64 6c 65 64 2e 20 54 68  ctly handled. Th
2060: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
2070: 2c 20 3c 74 65 73 74 20 6e 75 6d 62 65 72 3e 2c  , <test number>,
2080: 20 69 73 20 61 6e 20 69 6e 74 65 67 65 72 20 0a   is an integer .
2090: 23 20 75 73 65 64 20 74 6f 20 6e 61 6d 65 20 74  # used to name t
20a0: 68 65 20 74 65 73 74 73 20 65 78 65 63 75 74 65  he tests execute
20b0: 64 20 62 79 20 74 68 69 73 20 70 72 6f 63 2e 20  d by this proc. 
20c0: 4f 70 74 69 6f 6e 73 20 61 72 65 20 61 73 20 66  Options are as f
20d0: 6f 6c 6c 6f 77 73 3a 0a 23 0a 23 20 20 20 20 20  ollows:.#.#     
20e0: 2d 74 63 6c 70 72 65 70 20 20 20 20 20 20 20 20  -tclprep        
20f0: 20 20 54 43 4c 20 73 63 72 69 70 74 20 74 6f 20    TCL script to 
2100: 72 75 6e 20 74 6f 20 70 72 65 70 61 72 65 20 74  run to prepare t
2110: 65 73 74 2e 0a 23 20 20 20 20 20 2d 73 71 6c 70  est..#     -sqlp
2120: 72 65 70 20 20 20 20 20 20 20 20 20 20 53 51 4c  rep          SQL
2130: 20 73 63 72 69 70 74 20 74 6f 20 72 75 6e 20 74   script to run t
2140: 6f 20 70 72 65 70 61 72 65 20 74 65 73 74 2e 0a  o prepare test..
2150: 23 20 20 20 20 20 2d 74 63 6c 62 6f 64 79 20 20  #     -tclbody  
2160: 20 20 20 20 20 20 20 20 54 43 4c 20 73 63 72 69          TCL scri
2170: 70 74 20 74 6f 20 72 75 6e 20 77 69 74 68 20 49  pt to run with I
2180: 4f 20 65 72 72 6f 72 20 73 69 6d 75 6c 61 74 69  O error simulati
2190: 6f 6e 2e 0a 23 20 20 20 20 20 2d 73 71 6c 62 6f  on..#     -sqlbo
21a0: 64 79 20 20 20 20 20 20 20 20 20 20 54 43 4c 20  dy          TCL 
21b0: 73 63 72 69 70 74 20 74 6f 20 72 75 6e 20 77 69  script to run wi
21c0: 74 68 20 49 4f 20 65 72 72 6f 72 20 73 69 6d 75  th IO error simu
21d0: 6c 61 74 69 6f 6e 2e 0a 23 20 20 20 20 20 2d 65  lation..#     -e
21e0: 78 63 6c 75 64 65 20 20 20 20 20 20 20 20 20 20  xclude          
21f0: 4c 69 73 74 20 6f 66 20 27 4e 27 20 76 61 6c 75  List of 'N' valu
2200: 65 73 20 6e 6f 74 20 74 6f 20 74 65 73 74 2e 0a  es not to test..
2210: 23 20 20 20 20 20 2d 73 74 61 72 74 20 20 20 20  #     -start    
2220: 20 20 20 20 20 20 20 20 56 61 6c 75 65 20 6f 66          Value of
2230: 20 27 4e 27 20 74 6f 20 62 65 67 69 6e 20 77 69   'N' to begin wi
2240: 74 68 20 28 64 65 66 61 75 6c 74 20 31 29 0a 23  th (default 1).#
2250: 0a 23 20 20 20 20 20 2d 63 6b 73 75 6d 20 20 20  .#     -cksum   
2260: 20 20 20 20 20 20 20 20 20 42 6f 6f 6c 65 61 6e           Boolean
2270: 2e 20 49 66 20 74 72 75 65 2c 20 74 65 73 74 20  . If true, test 
2280: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73  that the databas
2290: 65 20 64 6f 65 73 0a 23 20 20 20 20 20 20 20 20  e does.#        
22a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e                 n
22b0: 6f 74 20 63 68 61 6e 67 65 20 64 75 72 69 6e 67  ot change during
22c0: 20 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f   the execution o
22d0: 66 20 74 68 65 20 74 65 73 74 20 63 61 73 65 2e  f the test case.
22e0: 0a 23 0a 70 72 6f 63 20 64 6f 5f 69 6f 65 72 72  .#.proc do_ioerr
22f0: 5f 74 65 73 74 20 7b 74 65 73 74 6e 61 6d 65 20  _test {testname 
2300: 61 72 67 73 7d 20 7b 0a 0a 20 20 73 65 74 20 3a  args} {..  set :
2310: 3a 69 6f 65 72 72 6f 70 74 73 28 2d 73 74 61 72  :ioerropts(-star
2320: 74 29 20 31 0a 20 20 73 65 74 20 3a 3a 69 6f 65  t) 1.  set ::ioe
2330: 72 72 6f 70 74 73 28 2d 63 6b 73 75 6d 29 20 30  rropts(-cksum) 0
2340: 0a 0a 20 20 61 72 72 61 79 20 73 65 74 20 3a 3a  ..  array set ::
2350: 69 6f 65 72 72 6f 70 74 73 20 24 61 72 67 73 0a  ioerropts $args.
2360: 0a 20 20 73 65 74 20 3a 3a 67 6f 20 31 0a 20 20  .  set ::go 1.  
2370: 66 6f 72 20 7b 73 65 74 20 6e 20 24 3a 3a 69 6f  for {set n $::io
2380: 65 72 72 6f 70 74 73 28 2d 73 74 61 72 74 29 7d  erropts(-start)}
2390: 20 7b 24 3a 3a 67 6f 7d 20 7b 69 6e 63 72 20 6e   {$::go} {incr n
23a0: 7d 20 7b 0a 20 0a 20 20 20 20 23 20 53 6b 69 70  } {. .    # Skip
23b0: 20 74 68 69 73 20 49 4f 20 65 72 72 6f 72 20 69   this IO error i
23c0: 66 20 69 74 20 77 61 73 20 73 70 65 63 69 66 69  f it was specifi
23d0: 65 64 20 77 69 74 68 20 74 68 65 20 22 2d 65 78  ed with the "-ex
23e0: 63 6c 75 64 65 22 20 6f 70 74 69 6f 6e 2e 0a 20  clude" option.. 
23f0: 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69     if {[info exi
2400: 73 74 73 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28  sts ::ioerropts(
2410: 2d 65 78 63 6c 75 64 65 29 5d 7d 20 7b 0a 20 20  -exclude)]} {.  
2420: 20 20 20 20 69 66 20 7b 5b 6c 73 65 61 72 63 68      if {[lsearch
2430: 20 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 65   $::ioerropts(-e
2440: 78 63 6c 75 64 65 29 20 24 6e 5d 21 3d 2d 31 7d  xclude) $n]!=-1}
2450: 20 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20 7d 0a   continue.    }.
2460: 0a 20 20 20 20 23 20 44 65 6c 65 74 65 20 74 68  .    # Delete th
2470: 65 20 66 69 6c 65 73 20 74 65 73 74 2e 64 62 20  e files test.db 
2480: 61 6e 64 20 74 65 73 74 32 2e 64 62 2c 20 74 68  and test2.db, th
2490: 65 6e 20 65 78 65 63 75 74 65 20 74 68 65 20 54  en execute the T
24a0: 43 4c 20 61 6e 64 20 0a 20 20 20 20 23 20 53 51  CL and .    # SQ
24b0: 4c 20 28 69 6e 20 74 68 61 74 20 6f 72 64 65 72  L (in that order
24c0: 29 20 74 6f 20 70 72 65 70 61 72 65 20 66 6f 72  ) to prepare for
24d0: 20 74 68 65 20 74 65 73 74 20 63 61 73 65 2e 0a   the test case..
24e0: 20 20 20 20 64 6f 5f 74 65 73 74 20 24 74 65 73      do_test $tes
24f0: 74 6e 61 6d 65 2e 24 6e 2e 31 20 7b 0a 20 20 20  tname.$n.1 {.   
2500: 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65 5f     set ::sqlite_
2510: 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67  io_error_pending
2520: 20 30 0a 20 20 20 20 20 20 63 61 74 63 68 20 7b   0.      catch {
2530: 64 62 20 63 6c 6f 73 65 7d 0a 20 20 20 20 20 20  db close}.      
2540: 63 61 74 63 68 20 7b 66 69 6c 65 20 64 65 6c 65  catch {file dele
2550: 74 65 20 2d 66 6f 72 63 65 20 74 65 73 74 2e 64  te -force test.d
2560: 62 7d 0a 20 20 20 20 20 20 63 61 74 63 68 20 7b  b}.      catch {
2570: 66 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f 72  file delete -for
2580: 63 65 20 74 65 73 74 2e 64 62 2d 6a 6f 75 72 6e  ce test.db-journ
2590: 61 6c 7d 0a 20 20 20 20 20 20 63 61 74 63 68 20  al}.      catch 
25a0: 7b 66 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f  {file delete -fo
25b0: 72 63 65 20 74 65 73 74 32 2e 64 62 7d 0a 20 20  rce test2.db}.  
25c0: 20 20 20 20 63 61 74 63 68 20 7b 66 69 6c 65 20      catch {file 
25d0: 64 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 74 65  delete -force te
25e0: 73 74 32 2e 64 62 2d 6a 6f 75 72 6e 61 6c 7d 0a  st2.db-journal}.
25f0: 20 20 20 20 20 20 73 65 74 20 3a 3a 44 42 20 5b        set ::DB [
2600: 73 71 6c 69 74 65 33 20 64 62 20 74 65 73 74 2e  sqlite3 db test.
2610: 64 62 3b 20 73 71 6c 69 74 65 33 5f 63 6f 6e 6e  db; sqlite3_conn
2620: 65 63 74 69 6f 6e 5f 70 6f 69 6e 74 65 72 20 64  ection_pointer d
2630: 62 5d 0a 20 20 20 20 20 20 69 66 20 7b 5b 69 6e  b].      if {[in
2640: 66 6f 20 65 78 69 73 74 73 20 3a 3a 69 6f 65 72  fo exists ::ioer
2650: 72 6f 70 74 73 28 2d 74 63 6c 70 72 65 70 29 5d  ropts(-tclprep)]
2660: 7d 20 7b 0a 20 20 20 20 20 20 20 20 65 76 61 6c  } {.        eval
2670: 20 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 74   $::ioerropts(-t
2680: 63 6c 70 72 65 70 29 0a 20 20 20 20 20 20 7d 0a  clprep).      }.
2690: 20 20 20 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20        if {[info 
26a0: 65 78 69 73 74 73 20 3a 3a 69 6f 65 72 72 6f 70  exists ::ioerrop
26b0: 74 73 28 2d 73 71 6c 70 72 65 70 29 5d 7d 20 7b  ts(-sqlprep)]} {
26c0: 0a 20 20 20 20 20 20 20 20 65 78 65 63 73 71 6c  .        execsql
26d0: 20 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 73   $::ioerropts(-s
26e0: 71 6c 70 72 65 70 29 0a 20 20 20 20 20 20 7d 0a  qlprep).      }.
26f0: 20 20 20 20 20 20 65 78 70 72 20 30 0a 20 20 20        expr 0.   
2700: 20 7d 20 7b 30 7d 0a 0a 20 20 20 20 23 20 52 65   } {0}..    # Re
2710: 61 64 20 74 68 65 20 27 63 68 65 63 6b 73 75 6d  ad the 'checksum
2720: 27 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  ' of the databas
2730: 65 2e 0a 20 20 20 20 69 66 20 7b 24 3a 3a 69 6f  e..    if {$::io
2740: 65 72 72 6f 70 74 73 28 2d 63 6b 73 75 6d 29 7d  erropts(-cksum)}
2750: 20 7b 0a 20 20 20 20 20 20 73 65 74 20 63 68 65   {.      set che
2760: 63 6b 73 75 6d 20 5b 63 6b 73 75 6d 5d 0a 20 20  cksum [cksum].  
2770: 20 20 7d 0a 20 20 0a 20 20 20 20 23 20 53 65 74    }.  .    # Set
2780: 20 74 68 65 20 4e 74 68 20 49 4f 20 65 72 72 6f   the Nth IO erro
2790: 72 20 74 6f 20 66 61 69 6c 2e 0a 20 20 20 20 64  r to fail..    d
27a0: 6f 5f 74 65 73 74 20 24 74 65 73 74 6e 61 6d 65  o_test $testname
27b0: 2e 24 6e 2e 32 20 5b 73 75 62 73 74 20 7b 0a 20  .$n.2 [subst {. 
27c0: 20 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74       set ::sqlit
27d0: 65 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69  e_io_error_pendi
27e0: 6e 67 20 24 6e 0a 20 20 20 20 7d 5d 20 24 6e 0a  ng $n.    }] $n.
27f0: 20 20 0a 20 20 20 20 23 20 43 72 65 61 74 65 20    .    # Create 
2800: 61 20 73 69 6e 67 6c 65 20 54 43 4c 20 73 63 72  a single TCL scr
2810: 69 70 74 20 66 72 6f 6d 20 74 68 65 20 54 43 4c  ipt from the TCL
2820: 20 61 6e 64 20 53 51 4c 20 73 70 65 63 69 66 69   and SQL specifi
2830: 65 64 0a 20 20 20 20 23 20 61 73 20 74 68 65 20  ed.    # as the 
2840: 62 6f 64 79 20 6f 66 20 74 68 65 20 74 65 73 74  body of the test
2850: 2e 0a 20 20 20 20 73 65 74 20 3a 3a 69 6f 65 72  ..    set ::ioer
2860: 72 6f 72 62 6f 64 79 20 7b 7d 0a 20 20 20 20 69  rorbody {}.    i
2870: 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20  f {[info exists 
2880: 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 74 63 6c  ::ioerropts(-tcl
2890: 62 6f 64 79 29 5d 7d 20 7b 0a 20 20 20 20 20 20  body)]} {.      
28a0: 61 70 70 65 6e 64 20 3a 3a 69 6f 65 72 72 6f 72  append ::ioerror
28b0: 62 6f 64 79 20 22 24 3a 3a 69 6f 65 72 72 6f 70  body "$::ioerrop
28c0: 74 73 28 2d 74 63 6c 62 6f 64 79 29 5c 6e 22 0a  ts(-tclbody)\n".
28d0: 20 20 20 20 7d 0a 20 20 20 20 69 66 20 7b 5b 69      }.    if {[i
28e0: 6e 66 6f 20 65 78 69 73 74 73 20 3a 3a 69 6f 65  nfo exists ::ioe
28f0: 72 72 6f 70 74 73 28 2d 73 71 6c 62 6f 64 79 29  rropts(-sqlbody)
2900: 5d 7d 20 7b 0a 20 20 20 20 20 20 61 70 70 65 6e  ]} {.      appen
2910: 64 20 3a 3a 69 6f 65 72 72 6f 72 62 6f 64 79 20  d ::ioerrorbody 
2920: 22 64 62 20 65 76 61 6c 20 7b 24 3a 3a 69 6f 65  "db eval {$::ioe
2930: 72 72 6f 70 74 73 28 2d 73 71 6c 62 6f 64 79 29  rropts(-sqlbody)
2940: 7d 22 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20  }".    }..    # 
2950: 45 78 65 63 75 74 65 20 74 68 65 20 54 43 4c 20  Execute the TCL 
2960: 53 63 72 69 70 74 20 63 72 65 61 74 65 64 20 69  Script created i
2970: 6e 20 74 68 65 20 61 62 6f 76 65 20 62 6c 6f 63  n the above bloc
2980: 6b 2e 20 49 66 0a 20 20 20 20 23 20 74 68 65 72  k. If.    # ther
2990: 65 20 61 72 65 20 61 74 20 6c 65 61 73 74 20 4e  e are at least N
29a0: 20 49 4f 20 6f 70 65 72 61 74 69 6f 6e 73 20 70   IO operations p
29b0: 65 72 66 6f 72 6d 65 64 20 62 79 20 53 51 4c 69  erformed by SQLi
29c0: 74 65 20 61 73 0a 20 20 20 20 23 20 61 20 72 65  te as.    # a re
29d0: 73 75 6c 74 20 6f 66 20 74 68 65 20 73 63 72 69  sult of the scri
29e0: 70 74 2c 20 74 68 65 20 4e 74 68 20 77 69 6c 6c  pt, the Nth will
29f0: 20 66 61 69 6c 2e 0a 20 20 20 20 64 6f 5f 74 65   fail..    do_te
2a00: 73 74 20 24 74 65 73 74 6e 61 6d 65 2e 24 6e 2e  st $testname.$n.
2a10: 33 20 7b 0a 20 20 20 20 20 20 73 65 74 20 72 20  3 {.      set r 
2a20: 5b 63 61 74 63 68 20 24 3a 3a 69 6f 65 72 72 6f  [catch $::ioerro
2a30: 72 62 6f 64 79 20 6d 73 67 5d 0a 20 20 20 20 20  rbody msg].     
2a40: 20 73 65 74 20 3a 3a 67 6f 20 5b 65 78 70 72 20   set ::go [expr 
2a50: 7b 24 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f 65 72  {$::sqlite_io_er
2a60: 72 6f 72 5f 70 65 6e 64 69 6e 67 3c 3d 30 7d 5d  ror_pending<=0}]
2a70: 0a 20 20 20 20 20 20 73 65 74 20 73 20 5b 65 78  .      set s [ex
2a80: 70 72 20 24 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f  pr $::sqlite_io_
2a90: 65 72 72 6f 72 5f 68 69 74 3d 3d 30 5d 0a 20 20  error_hit==0].  
2aa0: 20 20 20 20 23 20 70 75 74 73 20 22 24 3a 3a 73      # puts "$::s
2ab0: 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f 70  qlite_io_error_p
2ac0: 65 6e 64 69 6e 67 20 24 72 20 24 6d 73 67 22 0a  ending $r $msg".
2ad0: 20 20 20 20 20 20 23 20 70 75 74 73 20 22 72 3d        # puts "r=
2ae0: 24 72 20 73 3d 24 73 20 6d 73 67 3d 5c 22 24 6d  $r s=$s msg=\"$m
2af0: 73 67 5c 22 22 0a 20 20 20 20 20 20 65 78 70 72  sg\"".      expr
2b00: 20 7b 20 28 24 73 20 26 26 20 21 24 72 29 20 7c   { ($s && !$r) |
2b10: 7c 20 28 21 24 73 20 26 26 20 24 72 29 20 7d 0a  | (!$s && $r) }.
2b20: 20 20 20 20 20 20 23 20 65 78 70 72 20 7b 24 3a        # expr {$:
2b30: 3a 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72  :sqlite_io_error
2b40: 5f 70 65 6e 64 69 6e 67 3e 30 20 7c 7c 20 24 72  _pending>0 || $r
2b50: 21 3d 30 7d 0a 20 20 20 20 7d 20 7b 31 7d 0a 0a  !=0}.    } {1}..
2b60: 20 20 20 20 23 20 49 66 20 61 6e 20 49 4f 20 65      # If an IO e
2b70: 72 72 6f 72 20 6f 63 63 75 72 65 64 2c 20 74 68  rror occured, th
2b80: 65 6e 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20  en the checksum 
2b90: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  of the database 
2ba0: 73 68 6f 75 6c 64 0a 20 20 20 20 23 20 62 65 20  should.    # be 
2bb0: 74 68 65 20 73 61 6d 65 20 61 73 20 62 65 66 6f  the same as befo
2bc0: 72 65 20 74 68 65 20 73 63 72 69 70 74 20 74 68  re the script th
2bd0: 61 74 20 63 61 75 73 65 64 20 74 68 65 20 49 4f  at caused the IO
2be0: 20 65 72 72 6f 72 20 77 61 73 20 72 75 6e 2e 0a   error was run..
2bf0: 20 20 20 20 69 66 20 7b 24 3a 3a 67 6f 20 26 26      if {$::go &&
2c00: 20 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 63   $::ioerropts(-c
2c10: 6b 73 75 6d 29 7d 20 7b 0a 20 20 20 20 20 20 64  ksum)} {.      d
2c20: 6f 5f 74 65 73 74 20 24 74 65 73 74 6e 61 6d 65  o_test $testname
2c30: 2e 24 6e 2e 34 20 7b 0a 20 20 20 20 20 20 20 20  .$n.4 {.        
2c40: 63 61 74 63 68 20 7b 64 62 20 63 6c 6f 73 65 7d  catch {db close}
2c50: 0a 20 20 20 20 20 20 20 20 73 65 74 20 3a 3a 44  .        set ::D
2c60: 42 20 5b 73 71 6c 69 74 65 33 20 64 62 20 74 65  B [sqlite3 db te
2c70: 73 74 2e 64 62 3b 20 73 71 6c 69 74 65 33 5f 63  st.db; sqlite3_c
2c80: 6f 6e 6e 65 63 74 69 6f 6e 5f 70 6f 69 6e 74 65  onnection_pointe
2c90: 72 20 64 62 5d 0a 20 20 20 20 20 20 20 20 63 6b  r db].        ck
2ca0: 73 75 6d 0a 20 20 20 20 20 20 7d 20 24 63 68 65  sum.      } $che
2cb0: 63 6b 73 75 6d 0a 20 20 20 20 7d 0a 0a 20 20 20  cksum.    }..   
2cc0: 20 73 65 74 20 3a 3a 73 71 6c 69 74 65 5f 69 6f   set ::sqlite_io
2cd0: 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20 30  _error_pending 0
2ce0: 0a 20 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65  .    if {[info e
2cf0: 78 69 73 74 73 20 3a 3a 69 6f 65 72 72 6f 70 74  xists ::ioerropt
2d00: 73 28 2d 63 6c 65 61 6e 75 70 29 5d 7d 20 7b 0a  s(-cleanup)]} {.
2d10: 20 20 20 20 20 20 63 61 74 63 68 20 24 3a 3a 69        catch $::i
2d20: 6f 65 72 72 6f 70 74 73 28 2d 63 6c 65 61 6e 75  oerropts(-cleanu
2d30: 70 29 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73  p).    }.  }.  s
2d40: 65 74 20 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f 65  et ::sqlite_io_e
2d50: 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20 30 0a 20  rror_pending 0. 
2d60: 20 75 6e 73 65 74 20 3a 3a 69 6f 65 72 72 6f 70   unset ::ioerrop
2d70: 74 73 0a 7d 0a 0a 23 20 52 65 74 75 72 6e 20 61  ts.}..# Return a
2d80: 20 63 68 65 63 6b 73 75 6d 20 62 61 73 65 64 20   checksum based 
2d90: 6f 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20  on the contents 
2da0: 6f 66 20 64 61 74 61 62 61 73 65 20 27 64 62 27  of database 'db'
2db0: 2e 0a 23 0a 70 72 6f 63 20 63 6b 73 75 6d 20 7b  ..#.proc cksum {
2dc0: 7b 64 62 20 64 62 7d 7d 20 7b 0a 20 20 73 65 74  {db db}} {.  set
2dd0: 20 74 78 74 20 5b 24 64 62 20 65 76 61 6c 20 7b   txt [$db eval {
2de0: 0a 20 20 20 20 20 20 53 45 4c 45 43 54 20 6e 61  .      SELECT na
2df0: 6d 65 2c 20 74 79 70 65 2c 20 73 71 6c 20 46 52  me, type, sql FR
2e00: 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  OM sqlite_master
2e10: 20 6f 72 64 65 72 20 62 79 20 6e 61 6d 65 0a 20   order by name. 
2e20: 20 7d 5d 5c 6e 0a 20 20 66 6f 72 65 61 63 68 20   }]\n.  foreach 
2e30: 74 62 6c 20 5b 24 64 62 20 65 76 61 6c 20 7b 0a  tbl [$db eval {.
2e40: 20 20 20 20 20 20 53 45 4c 45 43 54 20 6e 61 6d        SELECT nam
2e50: 65 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61  e FROM sqlite_ma
2e60: 73 74 65 72 20 57 48 45 52 45 20 74 79 70 65 3d  ster WHERE type=
2e70: 27 74 61 62 6c 65 27 20 6f 72 64 65 72 20 62 79  'table' order by
2e80: 20 6e 61 6d 65 0a 20 20 7d 5d 20 7b 0a 20 20 20   name.  }] {.   
2e90: 20 61 70 70 65 6e 64 20 74 78 74 20 5b 24 64 62   append txt [$db
2ea0: 20 65 76 61 6c 20 22 53 45 4c 45 43 54 20 2a 20   eval "SELECT * 
2eb0: 46 52 4f 4d 20 24 74 62 6c 22 5d 5c 6e 0a 20 20  FROM $tbl"]\n.  
2ec0: 7d 0a 20 20 66 6f 72 65 61 63 68 20 70 72 61 67  }.  foreach prag
2ed0: 20 7b 64 65 66 61 75 6c 74 5f 73 79 6e 63 68 72   {default_synchr
2ee0: 6f 6e 6f 75 73 20 64 65 66 61 75 6c 74 5f 63 61  onous default_ca
2ef0: 63 68 65 5f 73 69 7a 65 7d 20 7b 0a 20 20 20 20  che_size} {.    
2f00: 61 70 70 65 6e 64 20 74 78 74 20 24 70 72 61 67  append txt $prag
2f10: 2d 5b 24 64 62 20 65 76 61 6c 20 22 50 52 41 47  -[$db eval "PRAG
2f20: 4d 41 20 24 70 72 61 67 22 5d 5c 6e 0a 20 20 7d  MA $prag"]\n.  }
2f30: 0a 20 20 73 65 74 20 63 6b 73 75 6d 20 5b 73 74  .  set cksum [st
2f40: 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 74 78 74  ring length $txt
2f50: 5d 2d 5b 6d 64 35 20 24 74 78 74 5d 0a 20 20 23  ]-[md5 $txt].  #
2f60: 20 70 75 74 73 20 24 63 6b 73 75 6d 2d 5b 66 69   puts $cksum-[fi
2f70: 6c 65 20 73 69 7a 65 20 74 65 73 74 2e 64 62 5d  le size test.db]
2f80: 0a 20 20 72 65 74 75 72 6e 20 24 63 6b 73 75 6d  .  return $cksum
2f90: 0a 7d 0a 0a 23 20 43 6f 70 79 20 66 69 6c 65 20  .}..# Copy file 
2fa0: 24 66 72 6f 6d 20 69 6e 74 6f 20 24 74 6f 2e 20  $from into $to. 
2fb0: 54 68 69 73 20 69 73 20 75 73 65 64 20 62 65 63  This is used bec
2fc0: 61 75 73 65 20 73 6f 6d 65 20 76 65 72 73 69 6f  ause some versio
2fd0: 6e 73 20 6f 66 0a 23 20 54 43 4c 20 66 6f 72 20  ns of.# TCL for 
2fe0: 77 69 6e 64 6f 77 73 20 28 6e 6f 74 61 62 6c 79  windows (notably
2ff0: 20 74 68 65 20 38 2e 34 2e 31 20 62 69 6e 61 72   the 8.4.1 binar
3000: 79 20 70 61 63 6b 61 67 65 20 73 68 69 70 70 65  y package shippe
3010: 64 20 77 69 74 68 20 74 68 65 0a 23 20 63 75 72  d with the.# cur
3020: 72 65 6e 74 20 6d 69 6e 67 77 20 72 65 6c 65 61  rent mingw relea
3030: 73 65 29 20 68 61 76 65 20 61 20 62 72 6f 6b 65  se) have a broke
3040: 6e 20 22 66 69 6c 65 20 63 6f 70 79 22 20 63 6f  n "file copy" co
3050: 6d 6d 61 6e 64 2e 0a 23 0a 70 72 6f 63 20 63 6f  mmand..#.proc co
3060: 70 79 5f 66 69 6c 65 20 7b 66 72 6f 6d 20 74 6f  py_file {from to
3070: 7d 20 7b 0a 20 20 69 66 20 7b 24 3a 3a 74 63 6c  } {.  if {$::tcl
3080: 5f 70 6c 61 74 66 6f 72 6d 28 70 6c 61 74 66 6f  _platform(platfo
3090: 72 6d 29 3d 3d 22 75 6e 69 78 22 7d 20 7b 0a 20  rm)=="unix"} {. 
30a0: 20 20 20 66 69 6c 65 20 63 6f 70 79 20 2d 66 6f     file copy -fo
30b0: 72 63 65 20 24 66 72 6f 6d 20 24 74 6f 0a 20 20  rce $from $to.  
30c0: 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 65 74  } else {.    set
30d0: 20 66 20 5b 6f 70 65 6e 20 24 66 72 6f 6d 5d 0a   f [open $from].
30e0: 20 20 20 20 66 63 6f 6e 66 69 67 75 72 65 20 24      fconfigure $
30f0: 66 20 2d 74 72 61 6e 73 6c 61 74 69 6f 6e 20 62  f -translation b
3100: 69 6e 61 72 79 0a 20 20 20 20 73 65 74 20 74 20  inary.    set t 
3110: 5b 6f 70 65 6e 20 24 74 6f 20 77 5d 0a 20 20 20  [open $to w].   
3120: 20 66 63 6f 6e 66 69 67 75 72 65 20 24 74 20 2d   fconfigure $t -
3130: 74 72 61 6e 73 6c 61 74 69 6f 6e 20 62 69 6e 61  translation bina
3140: 72 79 0a 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e  ry.    puts -non
3150: 65 77 6c 69 6e 65 20 24 74 20 5b 72 65 61 64 20  ewline $t [read 
3160: 24 66 20 5b 66 69 6c 65 20 73 69 7a 65 20 24 66  $f [file size $f
3170: 72 6f 6d 5d 5d 0a 20 20 20 20 63 6c 6f 73 65 20  rom]].    close 
3180: 24 74 0a 20 20 20 20 63 6c 6f 73 65 20 24 66 0a  $t.    close $f.
3190: 20 20 7d 0a 7d 0a 0a 23 20 54 68 69 73 20 63 6f    }.}..# This co
31a0: 6d 6d 61 6e 64 20 63 68 65 63 6b 73 20 66 6f 72  mmand checks for
31b0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 61 6c   outstanding cal
31c0: 6c 73 20 74 6f 20 73 71 6c 69 74 65 4d 61 6c 6c  ls to sqliteMall
31d0: 6f 63 28 29 20 66 72 6f 6d 20 77 69 74 68 69 6e  oc() from within
31e0: 0a 23 20 74 68 65 20 63 75 72 72 65 6e 74 20 74  .# the current t
31f0: 68 72 65 61 64 2e 20 41 20 6c 69 73 74 20 69 73  hread. A list is
3200: 20 72 65 74 75 72 6e 65 64 20 77 69 74 68 20 6f   returned with o
3210: 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63  ne entry for eac
3220: 68 20 6f 75 74 73 74 61 6e 64 69 6e 67 0a 23 20  h outstanding.# 
3230: 6d 61 6c 6c 6f 63 2e 20 45 61 63 68 20 6c 69 73  malloc. Each lis
3240: 74 20 65 6e 74 72 79 20 69 73 20 69 74 73 65 6c  t entry is itsel
3250: 66 20 61 20 6c 69 73 74 20 6f 66 20 35 20 69 74  f a list of 5 it
3260: 65 6d 73 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a  ems, as follows:
3270: 0a 23 0a 23 20 20 20 20 20 7b 20 3c 6e 75 6d 62  .#.#     { <numb
3280: 65 72 2d 62 79 74 65 73 3e 20 3c 66 69 6c 65 2d  er-bytes> <file-
3290: 6e 61 6d 65 3e 20 3c 6c 69 6e 65 2d 6e 75 6d 62  name> <line-numb
32a0: 65 72 3e 20 3c 74 65 73 74 2d 63 61 73 65 3e 20  er> <test-case> 
32b0: 3c 73 74 61 63 6b 2d 64 75 6d 70 3e 20 7d 0a 23  <stack-dump> }.#
32c0: 0a 70 72 6f 63 20 63 68 65 63 6b 5f 66 6f 72 5f  .proc check_for_
32d0: 6c 65 61 6b 73 20 7b 7d 20 7b 0a 20 20 73 65 74  leaks {} {.  set
32e0: 20 72 65 74 20 5b 6c 69 73 74 5d 0a 20 20 73 65   ret [list].  se
32f0: 74 20 63 6e 74 20 30 0a 20 20 66 6f 72 65 61 63  t cnt 0.  foreac
3300: 68 20 61 6c 6c 6f 63 20 5b 73 71 6c 69 74 65 5f  h alloc [sqlite_
3310: 6d 61 6c 6c 6f 63 5f 6f 75 74 73 74 61 6e 64 69  malloc_outstandi
3320: 6e 67 5d 20 7b 0a 20 20 20 20 66 6f 72 65 61 63  ng] {.    foreac
3330: 68 20 7b 6e 42 79 74 65 73 20 66 69 6c 65 20 69  h {nBytes file i
3340: 4c 69 6e 65 20 75 73 65 72 73 74 72 69 6e 67 20  Line userstring 
3350: 62 61 63 6b 74 72 61 63 65 7d 20 24 61 6c 6c 6f  backtrace} $allo
3360: 63 20 7b 7d 0a 20 20 20 20 73 65 74 20 73 74 61  c {}.    set sta
3370: 63 6b 20 5b 6c 69 73 74 5d 0a 20 20 20 20 73 65  ck [list].    se
3380: 74 20 73 6b 69 70 20 30 0a 0a 20 20 20 20 23 20  t skip 0..    # 
3390: 54 68 65 20 66 69 72 73 74 20 63 6f 6d 6d 61 6e  The first comman
33a0: 64 20 69 6e 20 74 68 69 73 20 62 6c 6f 63 6b 20  d in this block 
33b0: 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 66 61  will probably fa
33c0: 69 6c 20 6f 6e 20 77 69 6e 64 6f 77 73 2e 20 54  il on windows. T
33d0: 68 69 73 0a 20 20 20 20 23 20 6d 65 61 6e 73 20  his.    # means 
33e0: 74 68 65 72 65 20 77 69 6c 6c 20 62 65 20 6e 6f  there will be no
33f0: 20 73 74 61 63 6b 20 64 75 6d 70 20 61 76 61 69   stack dump avai
3400: 6c 61 62 6c 65 2e 0a 20 20 20 20 69 66 20 7b 24  lable..    if {$
3410: 63 6e 74 20 3c 20 32 35 20 26 26 20 24 62 61 63  cnt < 25 && $bac
3420: 6b 74 72 61 63 65 21 3d 22 22 7d 20 7b 0a 20 20  ktrace!=""} {.  
3430: 20 20 20 20 63 61 74 63 68 20 7b 0a 20 20 20 20      catch {.    
3440: 20 20 20 20 73 65 74 20 73 74 75 66 66 20 5b 65      set stuff [e
3450: 76 61 6c 20 22 65 78 65 63 20 61 64 64 72 32 6c  val "exec addr2l
3460: 69 6e 65 20 2d 65 20 2e 2f 74 65 73 74 66 69 78  ine -e ./testfix
3470: 74 75 72 65 20 2d 66 20 24 62 61 63 6b 74 72 61  ture -f $backtra
3480: 63 65 22 5d 0a 20 20 20 20 20 20 20 20 66 6f 72  ce"].        for
3490: 65 61 63 68 20 7b 66 75 6e 63 20 6c 69 6e 65 7d  each {func line}
34a0: 20 24 73 74 75 66 66 20 7b 0a 20 20 20 20 20 20   $stuff {.      
34b0: 20 20 20 20 69 66 20 7b 24 66 75 6e 63 20 21 3d      if {$func !=
34c0: 20 22 3f 3f 22 20 7c 7c 20 24 6c 69 6e 65 20 21   "??" || $line !
34d0: 3d 20 22 3f 3f 3a 30 22 7d 20 7b 0a 20 20 20 20  = "??:0"} {.    
34e0: 20 20 20 20 20 20 20 20 72 65 67 65 78 70 20 7b          regexp {
34f0: 2e 2a 2f 28 2e 2a 29 7d 20 24 6c 69 6e 65 20 64  .*/(.*)} $line d
3500: 75 6d 6d 79 20 6c 69 6e 65 0a 20 20 20 20 20 20  ummy line.      
3510: 20 20 20 20 20 20 6c 61 70 70 65 6e 64 20 73 74        lappend st
3520: 61 63 6b 20 22 24 7b 66 75 6e 63 7d 28 29 20 24  ack "${func}() $
3530: 6c 69 6e 65 22 0a 20 20 20 20 20 20 20 20 20 20  line".          
3540: 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 20  } else {.       
3550: 20 20 20 20 20 69 66 20 7b 5b 6c 69 6e 64 65 78       if {[lindex
3560: 20 24 73 74 61 63 6b 20 65 6e 64 5d 20 21 3d 20   $stack end] != 
3570: 22 2e 2e 2e 22 7d 20 7b 0a 20 20 20 20 20 20 20  "..."} {.       
3580: 20 20 20 20 20 20 20 6c 61 70 70 65 6e 64 20 73         lappend s
3590: 74 61 63 6b 20 22 2e 2e 2e 22 0a 20 20 20 20 20  tack "...".     
35a0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
35b0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20     }.        }. 
35c0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 6e 63       }.      inc
35d0: 72 20 63 6e 74 0a 20 20 20 20 7d 0a 0a 20 20 20  r cnt.    }..   
35e0: 20 69 66 20 7b 21 24 73 6b 69 70 7d 20 7b 0a 20   if {!$skip} {. 
35f0: 20 20 20 20 20 6c 61 70 70 65 6e 64 20 72 65 74       lappend ret
3600: 20 5b 6c 69 73 74 20 24 6e 42 79 74 65 73 20 24   [list $nBytes $
3610: 66 69 6c 65 20 24 69 4c 69 6e 65 20 24 75 73 65  file $iLine $use
3620: 72 73 74 72 69 6e 67 20 24 73 74 61 63 6b 5d 0a  rstring $stack].
3630: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
3640: 72 6e 20 24 72 65 74 0a 7d 0a 0a 23 20 50 72 65  rn $ret.}..# Pre
3650: 74 74 79 20 70 72 69 6e 74 20 61 20 72 65 70 6f  tty print a repo
3660: 72 74 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20  rt based on the 
3670: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20  return value of 
3680: 5b 63 68 65 63 6b 5f 66 6f 72 5f 6c 65 61 6b 73  [check_for_leaks
3690: 5d 20 74 6f 0a 23 20 73 74 64 6f 75 74 2e 0a 70  ] to.# stdout..p
36a0: 72 6f 63 20 70 70 5f 63 68 65 63 6b 5f 66 6f 72  roc pp_check_for
36b0: 5f 6c 65 61 6b 73 20 7b 7d 20 7b 0a 20 20 73 65  _leaks {} {.  se
36c0: 74 20 6c 20 5b 63 68 65 63 6b 5f 66 6f 72 5f 6c  t l [check_for_l
36d0: 65 61 6b 73 5d 0a 20 20 73 65 74 20 6e 20 30 0a  eaks].  set n 0.
36e0: 20 20 66 6f 72 65 61 63 68 20 6c 65 61 6b 20 24    foreach leak $
36f0: 6c 20 7b 0a 20 20 20 20 66 6f 72 65 61 63 68 20  l {.    foreach 
3700: 7b 6e 42 79 74 65 73 20 66 69 6c 65 20 69 4c 69  {nBytes file iLi
3710: 6e 65 20 75 73 65 72 73 74 72 69 6e 67 20 73 74  ne userstring st
3720: 61 63 6b 7d 20 24 6c 65 61 6b 20 7b 7d 0a 20 20  ack} $leak {}.  
3730: 20 20 70 75 74 73 20 22 24 6e 42 79 74 65 73 20    puts "$nBytes 
3740: 62 79 74 65 73 20 6c 65 61 6b 65 64 20 61 74 20  bytes leaked at 
3750: 24 66 69 6c 65 3a 24 69 4c 69 6e 65 20 28 24 75  $file:$iLine ($u
3760: 73 65 72 73 74 72 69 6e 67 29 22 0a 20 20 20 20  serstring)".    
3770: 66 6f 72 65 61 63 68 20 66 72 61 6d 65 20 24 73  foreach frame $s
3780: 74 61 63 6b 20 7b 0a 20 20 20 20 20 20 70 75 74  tack {.      put
3790: 73 20 22 20 20 20 20 20 20 20 20 24 66 72 61 6d  s "        $fram
37a0: 65 22 0a 20 20 20 20 7d 0a 20 20 20 20 69 6e 63  e".    }.    inc
37b0: 72 20 6e 20 24 6e 42 79 74 65 73 0a 20 20 7d 0a  r n $nBytes.  }.
37c0: 20 20 70 75 74 73 20 22 4d 65 6d 6f 72 79 20 6c    puts "Memory l
37d0: 65 61 6b 65 64 3a 20 24 6e 20 62 79 74 65 73 20  eaked: $n bytes 
37e0: 69 6e 20 5b 6c 6c 65 6e 67 74 68 20 24 6c 5d 20  in [llength $l] 
37f0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 22 0a 20 20 70  allocations".  p
3800: 75 74 73 20 22 22 0a 7d 0a 0a 23 20 49 66 20 74  uts "".}..# If t
3810: 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 63 6f  he library is co
3820: 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 20  mpiled with the 
3830: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41  SQLITE_DEFAULT_A
3840: 55 54 4f 56 41 43 55 55 4d 20 6d 61 63 72 6f 20  UTOVACUUM macro 
3850: 73 65 74 0a 23 20 74 6f 20 6e 6f 6e 2d 7a 65 72  set.# to non-zer
3860: 6f 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65 20  o, then set the 
3870: 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20  global variable 
3880: 24 41 55 54 4f 56 41 43 55 55 4d 20 74 6f 20 31  $AUTOVACUUM to 1
3890: 2e 0a 73 65 74 20 41 55 54 4f 56 41 43 55 55 4d  ..set AUTOVACUUM
38a0: 20 24 73 71 6c 69 74 65 5f 6f 70 74 69 6f 6e 73   $sqlite_options
38b0: 28 64 65 66 61 75 6c 74 5f 61 75 74 6f 76 61 63  (default_autovac
38c0: 75 75 6d 29 0a                                   uum).