/ Hex Artifact Content
Login

Artifact d0c7b39c374156f3a37eeeb83af279c41c60ecbc:


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 31 34 33 20 32 30 30 39 2f 30 34 2f 30   1.143 2009/04/0
01f0: 39 20 30 31 3a 32 33 3a 34 39 20 64 72 68 20 45  9 01:23:49 drh E
0200: 78 70 20 24 0a 0a 23 2d 2d 2d 2d 2d 2d 2d 2d 2d  xp $..#---------
0210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0220: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0250: 0a 23 20 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20  .# The commands 
0260: 70 72 6f 76 69 64 65 64 20 62 79 20 74 68 65 20  provided by the 
0270: 63 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c  code in this fil
0280: 65 20 74 6f 20 68 65 6c 70 20 77 69 74 68 20 63  e to help with c
0290: 72 65 61 74 69 6e 67 20 0a 23 20 74 65 73 74 20  reating .# test 
02a0: 63 61 73 65 73 20 61 72 65 20 61 73 20 66 6f 6c  cases are as fol
02b0: 6c 6f 77 73 3a 0a 23 0a 23 20 43 6f 6d 6d 61 6e  lows:.#.# Comman
02c0: 64 73 20 74 6f 20 6d 61 6e 69 70 75 6c 61 74 65  ds to manipulate
02d0: 20 74 68 65 20 64 62 20 61 6e 64 20 74 68 65 20   the db and the 
02e0: 66 69 6c 65 2d 73 79 73 74 65 6d 20 61 74 20 61  file-system at a
02f0: 20 68 69 67 68 20 6c 65 76 65 6c 3a 0a 23 0a 23   high level:.#.#
0300: 20 20 20 20 20 20 63 6f 70 79 5f 66 69 6c 65 20        copy_file 
0310: 20 20 20 20 20 20 20 20 20 20 20 20 20 46 52 4f               FRO
0320: 4d 20 54 4f 0a 23 20 20 20 20 20 20 64 72 6f 70  M TO.#      drop
0330: 5f 61 6c 6c 5f 74 61 62 6c 65 20 20 20 20 20 20  _all_table      
0340: 20 20 20 3f 44 42 3f 0a 23 20 20 20 20 20 20 66     ?DB?.#      f
0350: 6f 72 63 65 64 65 6c 65 74 65 20 20 20 20 20 20  orcedelete      
0360: 20 20 20 20 20 20 46 49 4c 45 4e 41 4d 45 0a 23        FILENAME.#
0370: 0a 23 20 54 65 73 74 20 74 68 65 20 63 61 70 61  .# Test the capa
0380: 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 53 51  bility of the SQ
0390: 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 62 75 69  Lite version bui
03a0: 6c 74 20 69 6e 74 6f 20 74 68 65 20 69 6e 74 65  lt into the inte
03b0: 72 70 72 65 74 65 72 20 74 6f 0a 23 20 64 65 74  rpreter to.# det
03c0: 65 72 6d 69 6e 65 20 69 66 20 61 20 73 70 65 63  ermine if a spec
03d0: 69 66 69 63 20 74 65 73 74 20 63 61 6e 20 62 65  ific test can be
03e0: 20 72 75 6e 3a 0a 23 0a 23 20 20 20 20 20 20 69   run:.#.#      i
03f0: 66 63 61 70 61 62 6c 65 20 20 20 20 20 20 20 20  fcapable        
0400: 20 20 20 20 20 20 45 58 50 52 0a 23 0a 23 20 43        EXPR.#.# C
0410: 61 6c 75 6c 61 74 65 20 63 68 65 63 6b 73 75 6d  alulate checksum
0420: 73 20 62 61 73 65 64 20 6f 6e 20 64 61 74 61 62  s based on datab
0430: 61 73 65 20 63 6f 6e 74 65 6e 74 73 3a 0a 23 0a  ase contents:.#.
0440: 23 20 20 20 20 20 20 64 62 63 6b 73 75 6d 20 20  #      dbcksum  
0450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 44 42                DB
0460: 20 44 42 4e 41 4d 45 0a 23 20 20 20 20 20 20 61   DBNAME.#      a
0470: 6c 6c 63 6b 73 75 6d 20 20 20 20 20 20 20 20 20  llcksum         
0480: 20 20 20 20 20 20 3f 44 42 3f 0a 23 20 20 20 20        ?DB?.#    
0490: 20 20 63 6b 73 75 6d 20 20 20 20 20 20 20 20 20    cksum         
04a0: 20 20 20 20 20 20 20 20 20 3f 44 42 3f 0a 23 0a           ?DB?.#.
04b0: 23 20 43 6f 6d 6d 61 6e 64 73 20 74 6f 20 65 78  # Commands to ex
04c0: 65 63 75 74 65 2f 65 78 70 6c 61 69 6e 20 53 51  ecute/explain SQ
04d0: 4c 20 73 74 61 74 65 6d 65 6e 74 73 3a 0a 23 0a  L statements:.#.
04e0: 23 20 20 20 20 20 20 73 74 65 70 73 71 6c 20 20  #      stepsql  
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 44 42                DB
0500: 20 53 51 4c 0a 23 20 20 20 20 20 20 65 78 65 63   SQL.#      exec
0510: 73 71 6c 32 20 20 20 20 20 20 20 20 20 20 20 20  sql2            
0520: 20 20 20 53 51 4c 0a 23 20 20 20 20 20 20 65 78     SQL.#      ex
0530: 70 6c 61 69 6e 5f 6e 6f 5f 74 72 61 63 65 20 20  plain_no_trace  
0540: 20 20 20 20 20 53 51 4c 0a 23 20 20 20 20 20 20       SQL.#      
0550: 65 78 70 6c 61 69 6e 20 20 20 20 20 20 20 20 20  explain         
0560: 20 20 20 20 20 20 20 53 51 4c 20 3f 44 42 3f 0a         SQL ?DB?.
0570: 23 20 20 20 20 20 20 63 61 74 63 68 73 71 6c 20  #      catchsql 
0580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51                SQ
0590: 4c 20 3f 44 42 3f 0a 23 20 20 20 20 20 20 65 78  L ?DB?.#      ex
05a0: 65 63 73 71 6c 20 20 20 20 20 20 20 20 20 20 20  ecsql           
05b0: 20 20 20 20 20 53 51 4c 20 3f 44 42 3f 0a 23 0a       SQL ?DB?.#.
05c0: 23 20 43 6f 6d 6d 61 6e 64 73 20 74 6f 20 72 75  # Commands to ru
05d0: 6e 20 74 65 73 74 20 63 61 73 65 73 3a 0a 23 0a  n test cases:.#.
05e0: 23 20 20 20 20 20 20 64 6f 5f 69 6f 65 72 72 5f  #      do_ioerr_
05f0: 74 65 73 74 20 20 20 20 20 20 20 20 20 20 54 45  test          TE
0600: 53 54 4e 41 4d 45 20 41 52 47 53 2e 2e 2e 0a 23  STNAME ARGS....#
0610: 20 20 20 20 20 20 63 72 61 73 68 73 71 6c 20 20        crashsql  
0620: 20 20 20 20 20 20 20 20 20 20 20 20 20 41 52 47               ARG
0630: 53 2e 2e 2e 0a 23 20 20 20 20 20 20 69 6e 74 65  S....#      inte
0640: 67 72 69 74 79 5f 63 68 65 63 6b 20 20 20 20 20  grity_check     
0650: 20 20 20 54 45 53 54 4e 41 4d 45 20 3f 44 42 3f     TESTNAME ?DB?
0660: 0a 23 20 20 20 20 20 20 64 6f 5f 74 65 73 74 20  .#      do_test 
0670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54                 T
0680: 45 53 54 4e 41 4d 45 20 53 43 52 49 50 54 20 45  ESTNAME SCRIPT E
0690: 58 50 45 43 54 45 44 0a 23 20 20 20 20 20 20 64  XPECTED.#      d
06a0: 6f 5f 65 78 65 63 73 71 6c 5f 74 65 73 74 20 20  o_execsql_test  
06b0: 20 20 20 20 20 20 54 45 53 54 4e 41 4d 45 20 53        TESTNAME S
06c0: 51 4c 20 45 58 50 45 43 54 45 44 0a 23 20 20 20  QL EXPECTED.#   
06d0: 20 20 20 64 6f 5f 63 61 74 63 68 73 71 6c 5f 74     do_catchsql_t
06e0: 65 73 74 20 20 20 20 20 20 20 54 45 53 54 4e 41  est       TESTNA
06f0: 4d 45 20 53 51 4c 20 45 58 50 45 43 54 45 44 0a  ME SQL EXPECTED.
0700: 23 0a 23 20 43 6f 6d 6d 61 6e 64 73 20 70 72 6f  #.# Commands pro
0710: 76 69 64 69 6e 67 20 61 20 6c 6f 77 65 72 20 6c  viding a lower l
0720: 65 76 65 6c 20 69 6e 74 65 72 66 61 63 65 20 74  evel interface t
0730: 6f 20 74 68 65 20 67 6c 6f 62 61 6c 20 74 65 73  o the global tes
0740: 74 20 63 6f 75 6e 74 65 72 73 3a 0a 23 0a 23 20  t counters:.#.# 
0750: 20 20 20 20 20 73 65 74 5f 74 65 73 74 5f 63 6f       set_test_co
0760: 75 6e 74 65 72 20 20 20 20 20 20 20 43 4f 55 4e  unter       COUN
0770: 54 45 52 20 3f 56 41 4c 55 45 3f 0a 23 20 20 20  TER ?VALUE?.#   
0780: 20 20 20 6f 6d 69 74 5f 74 65 73 74 20 20 20 20     omit_test    
0790: 20 20 20 20 20 20 20 20 20 20 54 45 53 54 4e 41            TESTNA
07a0: 4d 45 20 52 45 41 53 4f 4e 0a 23 20 20 20 20 20  ME REASON.#     
07b0: 20 66 61 69 6c 5f 74 65 73 74 20 20 20 20 20 20   fail_test      
07c0: 20 20 20 20 20 20 20 20 54 45 53 54 4e 41 4d 45          TESTNAME
07d0: 0a 23 20 20 20 20 20 20 69 6e 63 72 5f 6e 74 65  .#      incr_nte
07e0: 73 74 0a 23 0a 23 20 43 6f 6d 6d 61 6e 64 20 72  st.#.# Command r
07f0: 75 6e 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66  un at the end of
0800: 20 65 61 63 68 20 74 65 73 74 20 66 69 6c 65 3a   each test file:
0810: 0a 23 0a 23 20 20 20 20 20 20 66 69 6e 69 73 68  .#.#      finish
0820: 5f 74 65 73 74 0a 23 0a 23 20 43 6f 6d 6d 61 6e  _test.#.# Comman
0830: 64 73 20 74 6f 20 68 65 6c 70 20 63 72 65 61 74  ds to help creat
0840: 65 20 74 65 73 74 20 66 69 6c 65 73 20 74 68 61  e test files tha
0850: 74 20 72 75 6e 20 77 69 74 68 20 74 68 65 20 22  t run with the "
0860: 57 41 4c 22 20 61 6e 64 20 6f 74 68 65 72 0a 23  WAL" and other.#
0870: 20 70 65 72 6d 75 74 61 74 69 6f 6e 73 20 28 73   permutations (s
0880: 65 65 20 66 69 6c 65 20 70 65 72 6d 75 74 61 74  ee file permutat
0890: 69 6f 6e 73 2e 74 65 73 74 29 3a 0a 23 0a 23 20  ions.test):.#.# 
08a0: 20 20 20 20 20 77 61 6c 5f 69 73 5f 77 61 6c 5f       wal_is_wal_
08b0: 6d 6f 64 65 0a 23 20 20 20 20 20 20 77 61 6c 5f  mode.#      wal_
08c0: 73 65 74 5f 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65  set_journal_mode
08d0: 20 20 20 3f 44 42 3f 0a 23 20 20 20 20 20 20 77     ?DB?.#      w
08e0: 61 6c 5f 63 68 65 63 6b 5f 6a 6f 75 72 6e 61 6c  al_check_journal
08f0: 5f 6d 6f 64 65 20 54 45 53 54 4e 41 4d 45 3f 44  _mode TESTNAME?D
0900: 42 3f 0a 23 20 20 20 20 20 20 70 65 72 6d 75 74  B?.#      permut
0910: 61 74 69 6f 6e 0a 23 20 20 20 20 20 20 70 72 65  ation.#      pre
0920: 73 71 6c 0a 23 0a 0a 23 20 53 65 74 20 74 68 65  sql.#..# Set the
0930: 20 70 72 65 63 69 73 69 6f 6e 20 6f 66 20 46 50   precision of FP
0940: 20 61 72 69 74 68 6d 61 74 69 63 20 75 73 65 64   arithmatic used
0950: 20 62 79 20 74 68 65 20 69 6e 74 65 72 70 72 65   by the interpre
0960: 74 65 72 2e 20 41 6e 64 20 0a 23 20 63 6f 6e 66  ter. And .# conf
0970: 69 67 75 72 65 20 53 51 4c 69 74 65 20 74 6f 20  igure SQLite to 
0980: 74 61 6b 65 20 64 61 74 61 62 61 73 65 20 66 69  take database fi
0990: 6c 65 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 20  le locks on the 
09a0: 70 61 67 65 20 74 68 61 74 20 62 65 67 69 6e 73  page that begins
09b0: 0a 23 20 36 34 4b 42 20 69 6e 74 6f 20 74 68 65  .# 64KB into the
09c0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69   database file i
09d0: 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 6f 6e  nstead of the on
09e0: 65 20 31 47 42 20 69 6e 2e 20 54 68 69 73 20 6d  e 1GB in. This m
09f0: 65 61 6e 73 0a 23 20 74 68 65 20 63 6f 64 65 20  eans.# the code 
0a00: 74 68 61 74 20 68 61 6e 64 6c 65 73 20 74 68 61  that handles tha
0a10: 74 20 73 70 65 63 69 61 6c 20 63 61 73 65 20 63  t special case c
0a20: 61 6e 20 62 65 20 74 65 73 74 65 64 20 77 69 74  an be tested wit
0a30: 68 6f 75 74 20 63 72 65 61 74 69 6e 67 0a 23 20  hout creating.# 
0a40: 76 65 72 79 20 6c 61 72 67 65 20 64 61 74 61 62  very large datab
0a50: 61 73 65 20 66 69 6c 65 73 2e 0a 23 0a 73 65 74  ase files..#.set
0a60: 20 74 63 6c 5f 70 72 65 63 69 73 69 6f 6e 20 31   tcl_precision 1
0a70: 35 0a 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63  5.sqlite3_test_c
0a80: 6f 6e 74 72 6f 6c 5f 70 65 6e 64 69 6e 67 5f 62  ontrol_pending_b
0a90: 79 74 65 20 30 78 30 30 31 30 30 30 30 0a 0a 0a  yte 0x0010000...
0aa0: 23 20 49 66 20 74 68 65 20 70 61 67 65 72 20 63  # If the pager c
0ab0: 6f 64 65 63 20 69 73 20 61 76 61 69 6c 61 62 6c  odec is availabl
0ac0: 65 2c 20 63 72 65 61 74 65 20 61 20 77 72 61 70  e, create a wrap
0ad0: 70 65 72 20 66 6f 72 20 74 68 65 20 5b 73 71 6c  per for the [sql
0ae0: 69 74 65 33 5d 20 0a 23 20 63 6f 6d 6d 61 6e 64  ite3] .# command
0af0: 20 74 68 61 74 20 61 70 70 65 6e 64 73 20 22 2d   that appends "-
0b00: 6b 65 79 20 7b 78 79 7a 7a 79 7d 22 20 74 6f 20  key {xyzzy}" to 
0b10: 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65  the command line
0b20: 2e 20 69 2e 65 2e 20 74 68 69 73 3a 0a 23 0a 23  . i.e. this:.#.#
0b30: 20 20 20 20 20 73 71 6c 69 74 65 33 20 64 62 20       sqlite3 db 
0b40: 74 65 73 74 2e 64 62 0a 23 0a 23 20 62 65 63 6f  test.db.#.# beco
0b50: 6d 65 73 0a 23 0a 23 20 20 20 20 20 73 71 6c 69  mes.#.#     sqli
0b60: 74 65 33 20 64 62 20 74 65 73 74 2e 64 62 20 2d  te3 db test.db -
0b70: 6b 65 79 20 7b 78 79 7a 7a 79 7d 0a 23 0a 69 66  key {xyzzy}.#.if
0b80: 20 7b 5b 69 6e 66 6f 20 63 6f 6d 6d 61 6e 64 20   {[info command 
0b90: 73 71 6c 69 74 65 5f 6f 72 69 67 5d 3d 3d 22 22  sqlite_orig]==""
0ba0: 7d 20 7b 0a 20 20 72 65 6e 61 6d 65 20 73 71 6c  } {.  rename sql
0bb0: 69 74 65 33 20 73 71 6c 69 74 65 5f 6f 72 69 67  ite3 sqlite_orig
0bc0: 0a 20 20 70 72 6f 63 20 73 71 6c 69 74 65 33 20  .  proc sqlite3 
0bd0: 7b 61 72 67 73 7d 20 7b 0a 20 20 20 20 69 66 20  {args} {.    if 
0be0: 7b 5b 6c 6c 65 6e 67 74 68 20 24 61 72 67 73 5d  {[llength $args]
0bf0: 3e 3d 32 20 26 26 20 5b 73 74 72 69 6e 67 20 69  >=2 && [string i
0c00: 6e 64 65 78 20 5b 6c 69 6e 64 65 78 20 24 61 72  ndex [lindex $ar
0c10: 67 73 20 30 5d 20 30 5d 21 3d 22 2d 22 7d 20 7b  gs 0] 0]!="-"} {
0c20: 0a 20 20 20 20 20 20 23 20 54 68 69 73 20 63 6f  .      # This co
0c30: 6d 6d 61 6e 64 20 69 73 20 6f 70 65 6e 69 6e 67  mmand is opening
0c40: 20 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 20   a new database 
0c50: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 20 20 20 20  connection..    
0c60: 20 20 23 0a 20 20 20 20 20 20 69 66 20 7b 5b 69    #.      if {[i
0c70: 6e 66 6f 20 65 78 69 73 74 73 20 3a 3a 47 28 70  nfo exists ::G(p
0c80: 65 72 6d 3a 73 71 6c 69 74 65 33 5f 61 72 67 73  erm:sqlite3_args
0c90: 29 5d 7d 20 7b 0a 20 20 20 20 20 20 20 20 73 65  )]} {.        se
0ca0: 74 20 61 72 67 73 20 5b 63 6f 6e 63 61 74 20 24  t args [concat $
0cb0: 61 72 67 73 20 24 3a 3a 47 28 70 65 72 6d 3a 73  args $::G(perm:s
0cc0: 71 6c 69 74 65 33 5f 61 72 67 73 29 5d 0a 20 20  qlite3_args)].  
0cd0: 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 20 7b      }.      if {
0ce0: 5b 73 71 6c 69 74 65 5f 6f 72 69 67 20 2d 68 61  [sqlite_orig -ha
0cf0: 73 2d 63 6f 64 65 63 5d 20 26 26 20 21 5b 69 6e  s-codec] && ![in
0d00: 66 6f 20 65 78 69 73 74 73 20 3a 3a 64 6f 5f 6e  fo exists ::do_n
0d10: 6f 74 5f 75 73 65 5f 63 6f 64 65 63 5d 7d 20 7b  ot_use_codec]} {
0d20: 0a 20 20 20 20 20 20 20 20 6c 61 70 70 65 6e 64  .        lappend
0d30: 20 61 72 67 73 20 2d 6b 65 79 20 7b 78 79 7a 7a   args -key {xyzz
0d40: 79 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20  y}.      }..    
0d50: 20 20 73 65 74 20 72 65 73 20 5b 75 70 6c 65 76    set res [uplev
0d60: 65 6c 20 31 20 73 71 6c 69 74 65 5f 6f 72 69 67  el 1 sqlite_orig
0d70: 20 24 61 72 67 73 5d 0a 20 20 20 20 20 20 69 66   $args].      if
0d80: 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 3a   {[info exists :
0d90: 3a 47 28 70 65 72 6d 3a 70 72 65 73 71 6c 29 5d  :G(perm:presql)]
0da0: 7d 20 7b 0a 20 20 20 20 20 20 20 20 5b 6c 69 6e  } {.        [lin
0db0: 64 65 78 20 24 61 72 67 73 20 30 5d 20 65 76 61  dex $args 0] eva
0dc0: 6c 20 24 3a 3a 47 28 70 65 72 6d 3a 70 72 65 73  l $::G(perm:pres
0dd0: 71 6c 29 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ql).      }.    
0de0: 20 20 73 65 74 20 72 65 73 0a 20 20 20 20 7d 20    set res.    } 
0df0: 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 23 20 54  else {.      # T
0e00: 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e  his command is n
0e10: 6f 74 20 6f 70 65 6e 69 6e 67 20 61 20 6e 65 77  ot opening a new
0e20: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
0e30: 74 69 6f 6e 2e 20 50 61 73 73 20 74 68 65 20 0a  tion. Pass the .
0e40: 20 20 20 20 20 20 23 20 61 72 67 75 6d 65 6e 74        # argument
0e50: 73 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65  s through to the
0e60: 20 43 20 69 6d 70 6c 65 6d 65 6e 61 74 69 6f 6e   C implemenation
0e70: 20 61 73 20 74 68 65 20 61 72 65 2e 0a 20 20 20   as the are..   
0e80: 20 20 20 23 0a 20 20 20 20 20 20 75 70 6c 65 76     #.      uplev
0e90: 65 6c 20 31 20 73 71 6c 69 74 65 5f 6f 72 69 67  el 1 sqlite_orig
0ea0: 20 24 61 72 67 73 0a 20 20 20 20 7d 0a 20 20 7d   $args.    }.  }
0eb0: 0a 7d 0a 0a 70 72 6f 63 20 65 78 65 63 70 72 65  .}..proc execpre
0ec0: 73 71 6c 20 7b 68 61 6e 64 6c 65 20 61 72 67 73  sql {handle args
0ed0: 7d 20 7b 0a 20 20 74 72 61 63 65 20 72 65 6d 6f  } {.  trace remo
0ee0: 76 65 20 65 78 65 63 75 74 69 6f 6e 20 24 68 61  ve execution $ha
0ef0: 6e 64 6c 65 20 65 6e 74 65 72 20 5b 6c 69 73 74  ndle enter [list
0f00: 20 65 78 65 63 70 72 65 73 71 6c 20 24 68 61 6e   execpresql $han
0f10: 64 6c 65 5d 0a 20 20 69 66 20 7b 5b 69 6e 66 6f  dle].  if {[info
0f20: 20 65 78 69 73 74 73 20 3a 3a 47 28 70 65 72 6d   exists ::G(perm
0f30: 3a 70 72 65 73 71 6c 29 5d 7d 20 7b 0a 20 20 20  :presql)]} {.   
0f40: 20 24 68 61 6e 64 6c 65 20 65 76 61 6c 20 24 3a   $handle eval $:
0f50: 3a 47 28 70 65 72 6d 3a 70 72 65 73 71 6c 29 0a  :G(perm:presql).
0f60: 20 20 7d 0a 7d 0a 0a 23 20 54 68 69 73 20 63 6f    }.}..# This co
0f70: 6d 6d 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20  mmand should be 
0f80: 63 61 6c 6c 65 64 20 61 66 74 65 72 20 6c 6f 61  called after loa
0f90: 64 69 6e 67 20 74 65 73 74 65 72 2e 74 63 6c 20  ding tester.tcl 
0fa0: 66 72 6f 6d 20 77 69 74 68 69 6e 0a 23 20 61 6c  from within.# al
0fb0: 6c 20 74 65 73 74 20 73 63 72 69 70 74 73 20 74  l test scripts t
0fc0: 68 61 74 20 61 72 65 20 69 6e 63 6f 6d 70 61 74  hat are incompat
0fd0: 69 62 6c 65 20 77 69 74 68 20 65 6e 63 72 79 70  ible with encryp
0fe0: 74 69 6f 6e 20 63 6f 64 65 63 73 2e 0a 23 0a 70  tion codecs..#.p
0ff0: 72 6f 63 20 64 6f 5f 6e 6f 74 5f 75 73 65 5f 63  roc do_not_use_c
1000: 6f 64 65 63 20 7b 7d 20 7b 0a 20 20 73 65 74 20  odec {} {.  set 
1010: 3a 3a 64 6f 5f 6e 6f 74 5f 75 73 65 5f 63 6f 64  ::do_not_use_cod
1020: 65 63 20 31 0a 20 20 72 65 73 65 74 5f 64 62 0a  ec 1.  reset_db.
1030: 7d 0a 0a 23 20 54 68 65 20 66 6f 6c 6c 6f 77 69  }..# The followi
1040: 6e 67 20 62 6c 6f 63 6b 20 6f 6e 6c 79 20 72 75  ng block only ru
1050: 6e 73 20 74 68 65 20 66 69 72 73 74 20 74 69 6d  ns the first tim
1060: 65 20 74 68 69 73 20 66 69 6c 65 20 69 73 20 73  e this file is s
1070: 6f 75 72 63 65 64 2e 20 49 74 0a 23 20 64 6f 65  ourced. It.# doe
1080: 73 20 6e 6f 74 20 72 75 6e 20 69 6e 20 73 6c 61  s not run in sla
1090: 76 65 20 69 6e 74 65 72 70 72 65 74 65 72 73 20  ve interpreters 
10a0: 28 73 69 6e 63 65 20 74 68 65 20 3a 3a 63 6d 64  (since the ::cmd
10b0: 6c 69 6e 65 61 72 67 20 61 72 72 61 79 20 69 73  linearg array is
10c0: 0a 23 20 70 6f 70 75 6c 61 74 65 64 20 62 65 66  .# populated bef
10d0: 6f 72 65 20 74 68 65 20 74 65 73 74 20 73 63 72  ore the test scr
10e0: 69 70 74 20 69 73 20 72 75 6e 20 69 6e 20 73 6c  ipt is run in sl
10f0: 61 76 65 20 69 6e 74 65 72 70 72 65 74 65 72 73  ave interpreters
1100: 29 2e 0a 23 0a 69 66 20 7b 5b 69 6e 66 6f 20 65  )..#.if {[info e
1110: 78 69 73 74 73 20 63 6d 64 6c 69 6e 65 61 72 67  xists cmdlinearg
1120: 5d 3d 3d 30 7d 20 7b 0a 0a 20 20 23 20 50 61 72  ]==0} {..  # Par
1130: 73 65 20 61 6e 79 20 6f 70 74 69 6f 6e 73 20 73  se any options s
1140: 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20  pecified in the 
1150: 24 61 72 67 76 20 61 72 72 61 79 2e 20 54 68 69  $argv array. Thi
1160: 73 20 73 63 72 69 70 74 20 61 63 63 65 70 74 73  s script accepts
1170: 20 74 68 65 20 0a 20 20 23 20 66 6f 6c 6c 6f 77   the .  # follow
1180: 69 6e 67 20 6f 70 74 69 6f 6e 73 3a 20 0a 20 20  ing options: .  
1190: 23 0a 20 20 23 20 20 20 2d 2d 70 61 75 73 65 0a  #.  #   --pause.
11a0: 20 20 23 20 20 20 2d 2d 73 6f 66 74 2d 68 65 61    #   --soft-hea
11b0: 70 2d 6c 69 6d 69 74 3d 4e 4e 0a 20 20 23 20 20  p-limit=NN.  #  
11c0: 20 2d 2d 6d 61 78 65 72 72 6f 72 3d 4e 4e 0a 20   --maxerror=NN. 
11d0: 20 23 20 20 20 2d 2d 6d 61 6c 6c 6f 63 74 72 61   #   --malloctra
11e0: 63 65 3d 4e 0a 20 20 23 20 20 20 2d 2d 62 61 63  ce=N.  #   --bac
11f0: 6b 74 72 61 63 65 3d 4e 0a 20 20 23 20 20 20 2d  ktrace=N.  #   -
1200: 2d 62 69 6e 61 72 79 6c 6f 67 3d 4e 0a 20 20 23  -binarylog=N.  #
1210: 20 20 20 2d 2d 73 6f 61 6b 3d 4e 0a 20 20 23 0a     --soak=N.  #.
1220: 20 20 73 65 74 20 63 6d 64 6c 69 6e 65 61 72 67    set cmdlinearg
1230: 28 73 6f 66 74 2d 68 65 61 70 2d 6c 69 6d 69 74  (soft-heap-limit
1240: 29 20 20 20 20 30 0a 20 20 73 65 74 20 63 6d 64  )    0.  set cmd
1250: 6c 69 6e 65 61 72 67 28 6d 61 78 65 72 72 6f 72  linearg(maxerror
1260: 29 20 20 20 20 20 20 20 20 31 30 30 30 0a 20 20  )        1000.  
1270: 73 65 74 20 63 6d 64 6c 69 6e 65 61 72 67 28 6d  set cmdlinearg(m
1280: 61 6c 6c 6f 63 74 72 61 63 65 29 20 20 20 20 20  alloctrace)     
1290: 20 20 20 30 0a 20 20 73 65 74 20 63 6d 64 6c 69     0.  set cmdli
12a0: 6e 65 61 72 67 28 62 61 63 6b 74 72 61 63 65 29  nearg(backtrace)
12b0: 20 20 20 20 20 20 20 20 20 31 30 0a 20 20 73 65           10.  se
12c0: 74 20 63 6d 64 6c 69 6e 65 61 72 67 28 62 69 6e  t cmdlinearg(bin
12d0: 61 72 79 6c 6f 67 29 20 20 20 20 20 20 20 20 20  arylog)         
12e0: 20 30 0a 20 20 73 65 74 20 63 6d 64 6c 69 6e 65   0.  set cmdline
12f0: 61 72 67 28 73 6f 61 6b 29 20 20 20 20 20 20 20  arg(soak)       
1300: 20 20 20 20 20 20 20 20 30 0a 0a 20 20 73 65 74          0..  set
1310: 20 6c 65 66 74 6f 76 65 72 20 5b 6c 69 73 74 5d   leftover [list]
1320: 0a 20 20 66 6f 72 65 61 63 68 20 61 20 24 61 72  .  foreach a $ar
1330: 67 76 20 7b 0a 20 20 20 20 73 77 69 74 63 68 20  gv {.    switch 
1340: 2d 72 65 67 65 78 70 20 2d 2d 20 24 61 20 7b 0a  -regexp -- $a {.
1350: 20 20 20 20 20 20 7b 5e 2d 2b 70 61 75 73 65 24        {^-+pause$
1360: 7d 20 7b 0a 20 20 20 20 20 20 20 20 23 20 57 61  } {.        # Wa
1370: 69 74 20 66 6f 72 20 75 73 65 72 20 69 6e 70 75  it for user inpu
1380: 74 20 62 65 66 6f 72 65 20 63 6f 6e 74 69 6e 75  t before continu
1390: 69 6e 67 2e 20 54 68 69 73 20 69 73 20 74 6f 20  ing. This is to 
13a0: 67 69 76 65 20 74 68 65 20 75 73 65 72 20 61 6e  give the user an
13b0: 20 0a 20 20 20 20 20 20 20 20 23 20 6f 70 70 6f   .        # oppo
13c0: 72 74 75 6e 69 74 79 20 74 6f 20 63 6f 6e 6e 65  rtunity to conne
13d0: 63 74 20 70 72 6f 66 69 6c 69 6e 67 20 74 6f 6f  ct profiling too
13e0: 6c 73 20 74 6f 20 74 68 65 20 70 72 6f 63 65 73  ls to the proces
13f0: 73 2e 0a 20 20 20 20 20 20 20 20 70 75 74 73 20  s..        puts 
1400: 2d 6e 6f 6e 65 77 6c 69 6e 65 20 22 50 72 65 73  -nonewline "Pres
1410: 73 20 52 45 54 55 52 4e 20 74 6f 20 62 65 67 69  s RETURN to begi
1420: 6e 2e 2e 2e 22 0a 20 20 20 20 20 20 20 20 66 6c  n...".        fl
1430: 75 73 68 20 73 74 64 6f 75 74 0a 20 20 20 20 20  ush stdout.     
1440: 20 20 20 67 65 74 73 20 73 74 64 69 6e 0a 20 20     gets stdin.  
1450: 20 20 20 20 7d 0a 20 20 20 20 20 20 7b 5e 2d 2b      }.      {^-+
1460: 73 6f 66 74 2d 68 65 61 70 2d 6c 69 6d 69 74 3d  soft-heap-limit=
1470: 2e 2b 24 7d 20 7b 0a 20 20 20 20 20 20 20 20 66  .+$} {.        f
1480: 6f 72 65 61 63 68 20 7b 64 75 6d 6d 79 20 63 6d  oreach {dummy cm
1490: 64 6c 69 6e 65 61 72 67 28 73 6f 66 74 2d 68 65  dlinearg(soft-he
14a0: 61 70 2d 6c 69 6d 69 74 29 7d 20 5b 73 70 6c 69  ap-limit)} [spli
14b0: 74 20 24 61 20 3d 5d 20 62 72 65 61 6b 0a 20 20  t $a =] break.  
14c0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7b 5e 2d 2b      }.      {^-+
14d0: 6d 61 78 65 72 72 6f 72 3d 2e 2b 24 7d 20 7b 0a  maxerror=.+$} {.
14e0: 20 20 20 20 20 20 20 20 66 6f 72 65 61 63 68 20          foreach 
14f0: 7b 64 75 6d 6d 79 20 63 6d 64 6c 69 6e 65 61 72  {dummy cmdlinear
1500: 67 28 6d 61 78 65 72 72 6f 72 29 7d 20 5b 73 70  g(maxerror)} [sp
1510: 6c 69 74 20 24 61 20 3d 5d 20 62 72 65 61 6b 0a  lit $a =] break.
1520: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7b 5e        }.      {^
1530: 2d 2b 6d 61 6c 6c 6f 63 74 72 61 63 65 3d 2e 2b  -+malloctrace=.+
1540: 24 7d 20 7b 0a 20 20 20 20 20 20 20 20 66 6f 72  $} {.        for
1550: 65 61 63 68 20 7b 64 75 6d 6d 79 20 63 6d 64 6c  each {dummy cmdl
1560: 69 6e 65 61 72 67 28 6d 61 6c 6c 6f 63 74 72 61  inearg(malloctra
1570: 63 65 29 7d 20 5b 73 70 6c 69 74 20 24 61 20 3d  ce)} [split $a =
1580: 5d 20 62 72 65 61 6b 0a 20 20 20 20 20 20 20 20  ] break.        
1590: 69 66 20 7b 24 63 6d 64 6c 69 6e 65 61 72 67 28  if {$cmdlinearg(
15a0: 6d 61 6c 6c 6f 63 74 72 61 63 65 29 7d 20 7b 0a  malloctrace)} {.
15b0: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
15c0: 33 5f 6d 65 6d 64 65 62 75 67 5f 6c 6f 67 20 73  3_memdebug_log s
15d0: 74 61 72 74 0a 20 20 20 20 20 20 20 20 7d 0a 20  tart.        }. 
15e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7b 5e 2d       }.      {^-
15f0: 2b 62 61 63 6b 74 72 61 63 65 3d 2e 2b 24 7d 20  +backtrace=.+$} 
1600: 7b 0a 20 20 20 20 20 20 20 20 66 6f 72 65 61 63  {.        foreac
1610: 68 20 7b 64 75 6d 6d 79 20 63 6d 64 6c 69 6e 65  h {dummy cmdline
1620: 61 72 67 28 62 61 63 6b 74 72 61 63 65 29 7d 20  arg(backtrace)} 
1630: 5b 73 70 6c 69 74 20 24 61 20 3d 5d 20 62 72 65  [split $a =] bre
1640: 61 6b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ak.        sqlit
1650: 65 33 5f 6d 65 6d 64 65 62 75 67 5f 62 61 63 6b  e3_memdebug_back
1660: 74 72 61 63 65 20 24 76 61 6c 75 65 0a 20 20 20  trace $value.   
1670: 20 20 20 7d 0a 20 20 20 20 20 20 7b 5e 2d 2b 62     }.      {^-+b
1680: 69 6e 61 72 79 6c 6f 67 3d 2e 2b 24 7d 20 7b 0a  inarylog=.+$} {.
1690: 20 20 20 20 20 20 20 20 66 6f 72 65 61 63 68 20          foreach 
16a0: 7b 64 75 6d 6d 79 20 63 6d 64 6c 69 6e 65 61 72  {dummy cmdlinear
16b0: 67 28 62 69 6e 61 72 79 6c 6f 67 29 7d 20 5b 73  g(binarylog)} [s
16c0: 70 6c 69 74 20 24 61 20 3d 5d 20 62 72 65 61 6b  plit $a =] break
16d0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7b  .      }.      {
16e0: 5e 2d 2b 73 6f 61 6b 3d 2e 2b 24 7d 20 7b 0a 20  ^-+soak=.+$} {. 
16f0: 20 20 20 20 20 20 20 66 6f 72 65 61 63 68 20 7b         foreach {
1700: 64 75 6d 6d 79 20 63 6d 64 6c 69 6e 65 61 72 67  dummy cmdlinearg
1710: 28 73 6f 61 6b 29 7d 20 5b 73 70 6c 69 74 20 24  (soak)} [split $
1720: 61 20 3d 5d 20 62 72 65 61 6b 0a 20 20 20 20 20  a =] break.     
1730: 20 20 20 73 65 74 20 3a 3a 47 28 69 73 73 6f 61     set ::G(issoa
1740: 6b 29 20 24 63 6d 64 6c 69 6e 65 61 72 67 28 73  k) $cmdlinearg(s
1750: 6f 61 6b 29 0a 20 20 20 20 20 20 7d 0a 20 20 20  oak).      }.   
1760: 20 20 20 64 65 66 61 75 6c 74 20 7b 0a 20 20 20     default {.   
1770: 20 20 20 20 20 6c 61 70 70 65 6e 64 20 6c 65 66       lappend lef
1780: 74 6f 76 65 72 20 24 61 0a 20 20 20 20 20 20 7d  tover $a.      }
1790: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 65 74  .    }.  }.  set
17a0: 20 61 72 67 76 20 24 6c 65 66 74 6f 76 65 72 0a   argv $leftover.
17b0: 0a 20 20 23 20 49 6e 73 74 61 6c 6c 20 74 68 65  .  # Install the
17c0: 20 6d 61 6c 6c 6f 63 20 6c 61 79 65 72 20 75 73   malloc layer us
17d0: 65 64 20 74 6f 20 69 6e 6a 65 63 74 20 4f 4f 4d  ed to inject OOM
17e0: 20 65 72 72 6f 72 73 2e 20 41 6e 64 20 74 68 65   errors. And the
17f0: 20 27 61 75 74 6f 6d 61 74 69 63 27 0a 20 20 23   'automatic'.  #
1800: 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 54 68 69   extensions. Thi
1810: 73 20 6f 6e 6c 79 20 6e 65 65 64 73 20 74 6f 20  s only needs to 
1820: 62 65 20 64 6f 6e 65 20 6f 6e 63 65 20 66 6f 72  be done once for
1830: 20 74 68 65 20 70 72 6f 63 65 73 73 2e 0a 20 20   the process..  
1840: 23 0a 20 20 73 71 6c 69 74 65 33 5f 73 68 75 74  #.  sqlite3_shut
1850: 64 6f 77 6e 20 0a 20 20 69 6e 73 74 61 6c 6c 5f  down .  install_
1860: 6d 61 6c 6c 6f 63 5f 66 61 75 6c 74 73 69 6d 20  malloc_faultsim 
1870: 31 20 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 69  1 .  sqlite3_ini
1880: 74 69 61 6c 69 7a 65 0a 20 20 61 75 74 6f 69 6e  tialize.  autoin
1890: 73 74 61 6c 6c 5f 74 65 73 74 5f 66 75 6e 63 74  stall_test_funct
18a0: 69 6f 6e 73 0a 0a 20 20 23 20 49 66 20 74 68 65  ions..  # If the
18b0: 20 2d 2d 62 69 6e 61 72 79 6c 6f 67 20 6f 70 74   --binarylog opt
18c0: 69 6f 6e 20 77 61 73 20 73 70 65 63 69 66 69 65  ion was specifie
18d0: 64 2c 20 63 72 65 61 74 65 20 74 68 65 20 6c 6f  d, create the lo
18e0: 67 67 69 6e 67 20 56 46 53 2e 20 54 68 69 73 0a  gging VFS. This.
18f0: 20 20 23 20 63 61 6c 6c 20 69 6e 73 74 61 6c 6c    # call install
1900: 73 20 74 68 65 20 6e 65 77 20 56 46 53 20 61 73  s the new VFS as
1910: 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6f 72   the default for
1920: 20 61 6c 6c 20 53 51 4c 69 74 65 20 63 6f 6e 6e   all SQLite conn
1930: 65 63 74 69 6f 6e 73 2e 0a 20 20 23 0a 20 20 69  ections..  #.  i
1940: 66 20 7b 24 63 6d 64 6c 69 6e 65 61 72 67 28 62  f {$cmdlinearg(b
1950: 69 6e 61 72 79 6c 6f 67 29 7d 20 7b 0a 20 20 20  inarylog)} {.   
1960: 20 76 66 73 6c 6f 67 20 6e 65 77 20 62 69 6e 61   vfslog new bina
1970: 72 79 6c 6f 67 20 7b 7d 20 76 66 73 6c 6f 67 2e  rylog {} vfslog.
1980: 62 69 6e 0a 20 20 7d 0a 0a 20 20 23 20 53 65 74  bin.  }..  # Set
1990: 20 74 68 65 20 62 61 63 6b 74 72 61 63 65 20 64   the backtrace d
19a0: 65 70 74 68 2c 20 69 66 20 6d 61 6c 6c 6f 63 20  epth, if malloc 
19b0: 74 72 61 63 69 6e 67 20 69 73 20 65 6e 61 62 6c  tracing is enabl
19c0: 65 64 2e 0a 20 20 23 0a 20 20 69 66 20 7b 24 63  ed..  #.  if {$c
19d0: 6d 64 6c 69 6e 65 61 72 67 28 6d 61 6c 6c 6f 63  mdlinearg(malloc
19e0: 74 72 61 63 65 29 7d 20 7b 0a 20 20 20 20 73 71  trace)} {.    sq
19f0: 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 62  lite3_memdebug_b
1a00: 61 63 6b 74 72 61 63 65 20 24 63 6d 64 6c 69 6e  acktrace $cmdlin
1a10: 65 61 72 67 28 62 61 63 6b 74 72 61 63 65 29 0a  earg(backtrace).
1a20: 20 20 7d 0a 7d 0a 0a 23 20 55 70 64 61 74 65 20    }.}..# Update 
1a30: 74 68 65 20 73 6f 66 74 2d 68 65 61 70 2d 6c 69  the soft-heap-li
1a40: 6d 69 74 20 65 61 63 68 20 74 69 6d 65 20 74 68  mit each time th
1a50: 69 73 20 73 63 72 69 70 74 20 69 73 20 72 75 6e  is script is run
1a60: 2e 20 49 6e 20 74 68 61 74 0a 23 20 77 61 79 20  . In that.# way 
1a70: 69 66 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c  if an individual
1a80: 20 74 65 73 74 20 66 69 6c 65 20 63 68 61 6e 67   test file chang
1a90: 65 73 20 74 68 65 20 73 6f 66 74 2d 68 65 61 70  es the soft-heap
1aa0: 2d 6c 69 6d 69 74 2c 20 69 74 0a 23 20 77 69 6c  -limit, it.# wil
1ab0: 6c 20 62 65 20 72 65 73 65 74 20 61 74 20 74 68  l be reset at th
1ac0: 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 6e  e start of the n
1ad0: 65 78 74 20 74 65 73 74 20 66 69 6c 65 2e 0a 23  ext test file..#
1ae0: 0a 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65  .sqlite3_soft_he
1af0: 61 70 5f 6c 69 6d 69 74 20 24 63 6d 64 6c 69 6e  ap_limit $cmdlin
1b00: 65 61 72 67 28 73 6f 66 74 2d 68 65 61 70 2d 6c  earg(soft-heap-l
1b10: 69 6d 69 74 29 0a 0a 23 20 43 72 65 61 74 65 20  imit)..# Create 
1b20: 61 20 74 65 73 74 20 64 61 74 61 62 61 73 65 0a  a test database.
1b30: 23 0a 70 72 6f 63 20 72 65 73 65 74 5f 64 62 20  #.proc reset_db 
1b40: 7b 7d 20 7b 0a 20 20 63 61 74 63 68 20 7b 64 62  {} {.  catch {db
1b50: 20 63 6c 6f 73 65 7d 0a 20 20 66 69 6c 65 20 64   close}.  file d
1b60: 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 74 65 73  elete -force tes
1b70: 74 2e 64 62 0a 20 20 66 69 6c 65 20 64 65 6c 65  t.db.  file dele
1b80: 74 65 20 2d 66 6f 72 63 65 20 74 65 73 74 2e 64  te -force test.d
1b90: 62 2d 6a 6f 75 72 6e 61 6c 0a 20 20 66 69 6c 65  b-journal.  file
1ba0: 20 64 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 74   delete -force t
1bb0: 65 73 74 2e 64 62 2d 77 61 6c 0a 20 20 73 71 6c  est.db-wal.  sql
1bc0: 69 74 65 33 20 64 62 20 2e 2f 74 65 73 74 2e 64  ite3 db ./test.d
1bd0: 62 0a 20 20 73 65 74 20 3a 3a 44 42 20 5b 73 71  b.  set ::DB [sq
1be0: 6c 69 74 65 33 5f 63 6f 6e 6e 65 63 74 69 6f 6e  lite3_connection
1bf0: 5f 70 6f 69 6e 74 65 72 20 64 62 5d 0a 20 20 69  _pointer db].  i
1c00: 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20  f {[info exists 
1c10: 3a 3a 53 45 54 55 50 5f 53 51 4c 5d 7d 20 7b 0a  ::SETUP_SQL]} {.
1c20: 20 20 20 20 64 62 20 65 76 61 6c 20 24 3a 3a 53      db eval $::S
1c30: 45 54 55 50 5f 53 51 4c 0a 20 20 7d 0a 7d 0a 72  ETUP_SQL.  }.}.r
1c40: 65 73 65 74 5f 64 62 0a 0a 23 20 41 62 6f 72 74  eset_db..# Abort
1c50: 20 65 61 72 6c 79 20 69 66 20 74 68 69 73 20 73   early if this s
1c60: 63 72 69 70 74 20 68 61 73 20 62 65 65 6e 20 72  cript has been r
1c70: 75 6e 20 62 65 66 6f 72 65 2e 0a 23 0a 69 66 20  un before..#.if 
1c80: 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 54 43  {[info exists TC
1c90: 28 63 6f 75 6e 74 29 5d 7d 20 72 65 74 75 72 6e  (count)]} return
1ca0: 0a 0a 23 20 4d 61 6b 65 20 73 75 72 65 20 6d 65  ..# Make sure me
1cb0: 6d 6f 72 79 20 73 74 61 74 69 73 74 69 63 73 20  mory statistics 
1cc0: 61 72 65 20 65 6e 61 62 6c 65 64 2e 0a 23 0a 73  are enabled..#.s
1cd0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5f 6d 65  qlite3_config_me
1ce0: 6d 73 74 61 74 75 73 20 31 0a 0a 23 20 49 6e 69  mstatus 1..# Ini
1cf0: 74 69 61 6c 69 7a 65 20 74 68 65 20 74 65 73 74  tialize the test
1d00: 20 63 6f 75 6e 74 65 72 73 20 61 6e 64 20 73 65   counters and se
1d10: 74 20 75 70 20 63 6f 6d 6d 61 6e 64 73 20 74 6f  t up commands to
1d20: 20 61 63 63 65 73 73 20 74 68 65 6d 2e 0a 23 20   access them..# 
1d30: 4f 72 2c 20 69 66 20 74 68 69 73 20 69 73 20 61  Or, if this is a
1d40: 20 73 6c 61 76 65 20 69 6e 74 65 72 70 72 65 74   slave interpret
1d50: 65 72 2c 20 73 65 74 20 75 70 20 61 6c 69 61 73  er, set up alias
1d60: 65 73 20 74 6f 20 77 72 69 74 65 20 74 68 65 0a  es to write the.
1d70: 23 20 63 6f 75 6e 74 65 72 73 20 69 6e 20 74 68  # counters in th
1d80: 65 20 70 61 72 65 6e 74 20 69 6e 74 65 72 70 72  e parent interpr
1d90: 65 74 65 72 2e 0a 23 0a 69 66 20 7b 30 3d 3d 5b  eter..#.if {0==[
1da0: 69 6e 66 6f 20 65 78 69 73 74 73 20 3a 3a 53 4c  info exists ::SL
1db0: 41 56 45 5d 7d 20 7b 0a 20 20 73 65 74 20 54 43  AVE]} {.  set TC
1dc0: 28 65 72 72 6f 72 73 29 20 20 20 20 30 0a 20 20  (errors)    0.  
1dd0: 73 65 74 20 54 43 28 63 6f 75 6e 74 29 20 20 20  set TC(count)   
1de0: 20 20 30 0a 20 20 73 65 74 20 54 43 28 66 61 69    0.  set TC(fai
1df0: 6c 5f 6c 69 73 74 29 20 5b 6c 69 73 74 5d 0a 20  l_list) [list]. 
1e00: 20 73 65 74 20 54 43 28 6f 6d 69 74 5f 6c 69 73   set TC(omit_lis
1e10: 74 29 20 5b 6c 69 73 74 5d 0a 0a 20 20 70 72 6f  t) [list]..  pro
1e20: 63 20 73 65 74 5f 74 65 73 74 5f 63 6f 75 6e 74  c set_test_count
1e30: 65 72 20 7b 63 6f 75 6e 74 65 72 20 61 72 67 73  er {counter args
1e40: 7d 20 7b 0a 20 20 20 20 69 66 20 7b 5b 6c 6c 65  } {.    if {[lle
1e50: 6e 67 74 68 20 24 61 72 67 73 5d 7d 20 7b 0a 20  ngth $args]} {. 
1e60: 20 20 20 20 20 73 65 74 20 3a 3a 54 43 28 24 63       set ::TC($c
1e70: 6f 75 6e 74 65 72 29 20 5b 6c 69 6e 64 65 78 20  ounter) [lindex 
1e80: 24 61 72 67 73 20 30 5d 0a 20 20 20 20 7d 0a 20  $args 0].    }. 
1e90: 20 20 20 73 65 74 20 3a 3a 54 43 28 24 63 6f 75     set ::TC($cou
1ea0: 6e 74 65 72 29 0a 20 20 7d 0a 7d 0a 0a 23 20 52  nter).  }.}..# R
1eb0: 65 63 6f 72 64 20 74 68 65 20 66 61 63 74 20 74  ecord the fact t
1ec0: 68 61 74 20 61 20 73 65 71 75 65 6e 63 65 20 6f  hat a sequence o
1ed0: 66 20 74 65 73 74 73 20 77 65 72 65 20 6f 6d 69  f tests were omi
1ee0: 74 74 65 64 2e 0a 23 0a 70 72 6f 63 20 6f 6d 69  tted..#.proc omi
1ef0: 74 5f 74 65 73 74 20 7b 6e 61 6d 65 20 72 65 61  t_test {name rea
1f00: 73 6f 6e 7d 20 7b 0a 20 20 73 65 74 20 6f 6d 69  son} {.  set omi
1f10: 74 4c 69 73 74 20 5b 73 65 74 5f 74 65 73 74 5f  tList [set_test_
1f20: 63 6f 75 6e 74 65 72 20 6f 6d 69 74 5f 6c 69 73  counter omit_lis
1f30: 74 5d 0a 20 20 6c 61 70 70 65 6e 64 20 6f 6d 69  t].  lappend omi
1f40: 74 4c 69 73 74 20 5b 6c 69 73 74 20 24 6e 61 6d  tList [list $nam
1f50: 65 20 24 72 65 61 73 6f 6e 5d 0a 20 20 73 65 74  e $reason].  set
1f60: 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 6f 6d  _test_counter om
1f70: 69 74 5f 6c 69 73 74 20 24 6f 6d 69 74 4c 69 73  it_list $omitLis
1f80: 74 0a 7d 0a 0a 23 20 52 65 63 6f 72 64 20 74 68  t.}..# Record th
1f90: 65 20 66 61 63 74 20 74 68 61 74 20 61 20 74 65  e fact that a te
1fa0: 73 74 20 66 61 69 6c 65 64 2e 0a 23 0a 70 72 6f  st failed..#.pro
1fb0: 63 20 66 61 69 6c 5f 74 65 73 74 20 7b 6e 61 6d  c fail_test {nam
1fc0: 65 7d 20 7b 0a 20 20 73 65 74 20 66 20 5b 73 65  e} {.  set f [se
1fd0: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 66  t_test_counter f
1fe0: 61 69 6c 5f 6c 69 73 74 5d 0a 20 20 6c 61 70 70  ail_list].  lapp
1ff0: 65 6e 64 20 66 20 24 6e 61 6d 65 0a 20 20 73 65  end f $name.  se
2000: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 66  t_test_counter f
2010: 61 69 6c 5f 6c 69 73 74 20 24 66 0a 20 20 73 65  ail_list $f.  se
2020: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 65  t_test_counter e
2030: 72 72 6f 72 73 20 5b 65 78 70 72 20 5b 73 65 74  rrors [expr [set
2040: 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 65 72  _test_counter er
2050: 72 6f 72 73 5d 20 2b 20 31 5d 0a 0a 20 20 73 65  rors] + 1]..  se
2060: 74 20 6e 46 61 69 6c 20 5b 73 65 74 5f 74 65 73  t nFail [set_tes
2070: 74 5f 63 6f 75 6e 74 65 72 20 65 72 72 6f 72 73  t_counter errors
2080: 5d 0a 20 20 69 66 20 7b 24 6e 46 61 69 6c 3e 3d  ].  if {$nFail>=
2090: 24 3a 3a 63 6d 64 6c 69 6e 65 61 72 67 28 6d 61  $::cmdlinearg(ma
20a0: 78 65 72 72 6f 72 29 7d 20 7b 0a 20 20 20 20 70  xerror)} {.    p
20b0: 75 74 73 20 22 2a 2a 2a 20 47 69 76 69 6e 67 20  uts "*** Giving 
20c0: 75 70 2e 2e 2e 22 0a 20 20 20 20 66 69 6e 61 6c  up...".    final
20d0: 69 7a 65 5f 74 65 73 74 69 6e 67 0a 20 20 7d 0a  ize_testing.  }.
20e0: 7d 0a 0a 23 20 49 6e 63 72 65 6d 65 6e 74 20 74  }..# Increment t
20f0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 65 73  he number of tes
2100: 74 73 20 72 75 6e 0a 23 0a 70 72 6f 63 20 69 6e  ts run.#.proc in
2110: 63 72 5f 6e 74 65 73 74 20 7b 7d 20 7b 0a 20 20  cr_ntest {} {.  
2120: 73 65 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72  set_test_counter
2130: 20 63 6f 75 6e 74 20 5b 65 78 70 72 20 5b 73 65   count [expr [se
2140: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 63  t_test_counter c
2150: 6f 75 6e 74 5d 20 2b 20 31 5d 0a 7d 0a 0a 0a 23  ount] + 1].}...#
2160: 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 6f 5f 74   Invoke the do_t
2170: 65 73 74 20 70 72 6f 63 65 64 75 72 65 20 74 6f  est procedure to
2180: 20 72 75 6e 20 61 20 73 69 6e 67 6c 65 20 74 65   run a single te
2190: 73 74 20 0a 23 0a 70 72 6f 63 20 64 6f 5f 74 65  st .#.proc do_te
21a0: 73 74 20 7b 6e 61 6d 65 20 63 6d 64 20 65 78 70  st {name cmd exp
21b0: 65 63 74 65 64 7d 20 7b 0a 0a 20 20 67 6c 6f 62  ected} {..  glob
21c0: 61 6c 20 61 72 67 76 20 63 6d 64 6c 69 6e 65 61  al argv cmdlinea
21d0: 72 67 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 65  rg..  sqlite3_me
21e0: 6d 64 65 62 75 67 5f 73 65 74 74 69 74 6c 65 20  mdebug_settitle 
21f0: 24 6e 61 6d 65 0a 0a 23 20 20 69 66 20 7b 5b 6c  $name..#  if {[l
2200: 6c 65 6e 67 74 68 20 24 61 72 67 76 5d 3d 3d 30  length $argv]==0
2210: 7d 20 7b 20 0a 23 20 20 20 20 73 65 74 20 67 6f  } { .#    set go
2220: 20 31 0a 23 20 20 7d 20 65 6c 73 65 20 7b 0a 23   1.#  } else {.#
2230: 20 20 20 20 73 65 74 20 67 6f 20 30 0a 23 20 20      set go 0.#  
2240: 20 20 66 6f 72 65 61 63 68 20 70 61 74 74 65 72    foreach patter
2250: 6e 20 24 61 72 67 76 20 7b 0a 23 20 20 20 20 20  n $argv {.#     
2260: 20 69 66 20 7b 5b 73 74 72 69 6e 67 20 6d 61 74   if {[string mat
2270: 63 68 20 24 70 61 74 74 65 72 6e 20 24 6e 61 6d  ch $pattern $nam
2280: 65 5d 7d 20 7b 0a 23 20 20 20 20 20 20 20 20 73  e]} {.#        s
2290: 65 74 20 67 6f 20 31 0a 23 20 20 20 20 20 20 20  et go 1.#       
22a0: 20 62 72 65 61 6b 0a 23 20 20 20 20 20 20 7d 0a   break.#      }.
22b0: 23 20 20 20 20 7d 0a 23 20 20 7d 0a 0a 20 20 69  #    }.#  }..  i
22c0: 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20  f {[info exists 
22d0: 3a 3a 47 28 70 65 72 6d 3a 70 72 65 66 69 78 29  ::G(perm:prefix)
22e0: 5d 7d 20 7b 0a 20 20 20 20 73 65 74 20 6e 61 6d  ]} {.    set nam
22f0: 65 20 22 24 3a 3a 47 28 70 65 72 6d 3a 70 72 65  e "$::G(perm:pre
2300: 66 69 78 29 24 6e 61 6d 65 22 0a 20 20 7d 0a 0a  fix)$name".  }..
2310: 20 20 69 6e 63 72 5f 6e 74 65 73 74 0a 20 20 70    incr_ntest.  p
2320: 75 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24  uts -nonewline $
2330: 6e 61 6d 65 2e 2e 2e 0a 20 20 66 6c 75 73 68 20  name....  flush 
2340: 73 74 64 6f 75 74 0a 20 20 69 66 20 7b 5b 63 61  stdout.  if {[ca
2350: 74 63 68 20 7b 75 70 6c 65 76 65 6c 20 23 30 20  tch {uplevel #0 
2360: 22 24 63 6d 64 3b 5c 6e 22 7d 20 72 65 73 75 6c  "$cmd;\n"} resul
2370: 74 5d 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22  t]} {.    puts "
2380: 5c 6e 45 72 72 6f 72 3a 20 24 72 65 73 75 6c 74  \nError: $result
2390: 22 0a 20 20 20 20 66 61 69 6c 5f 74 65 73 74 20  ".    fail_test 
23a0: 24 6e 61 6d 65 0a 20 20 7d 20 65 6c 73 65 69 66  $name.  } elseif
23b0: 20 7b 5b 73 74 72 69 6e 67 20 63 6f 6d 70 61 72   {[string compar
23c0: 65 20 24 72 65 73 75 6c 74 20 24 65 78 70 65 63  e $result $expec
23d0: 74 65 64 5d 7d 20 7b 0a 20 20 20 20 70 75 74 73  ted]} {.    puts
23e0: 20 22 5c 6e 45 78 70 65 63 74 65 64 3a 20 5c 5b   "\nExpected: \[
23f0: 24 65 78 70 65 63 74 65 64 5c 5d 5c 6e 20 20 20  $expected\]\n   
2400: 20 20 47 6f 74 3a 20 5c 5b 24 72 65 73 75 6c 74    Got: \[$result
2410: 5c 5d 22 0a 20 20 20 20 66 61 69 6c 5f 74 65 73  \]".    fail_tes
2420: 74 20 24 6e 61 6d 65 0a 20 20 7d 20 65 6c 73 65  t $name.  } else
2430: 20 7b 0a 20 20 20 20 70 75 74 73 20 22 20 4f 6b   {.    puts " Ok
2440: 22 0a 20 20 7d 0a 20 20 66 6c 75 73 68 20 73 74  ".  }.  flush st
2450: 64 6f 75 74 0a 7d 0a 20 20 20 20 0a 70 72 6f 63  dout.}.    .proc
2460: 20 64 6f 5f 65 78 65 63 73 71 6c 5f 74 65 73 74   do_execsql_test
2470: 20 7b 74 65 73 74 6e 61 6d 65 20 73 71 6c 20 72   {testname sql r
2480: 65 73 75 6c 74 7d 20 7b 0a 20 20 75 70 6c 65 76  esult} {.  uplev
2490: 65 6c 20 64 6f 5f 74 65 73 74 20 24 74 65 73 74  el do_test $test
24a0: 6e 61 6d 65 20 5b 6c 69 73 74 20 22 65 78 65 63  name [list "exec
24b0: 73 71 6c 20 7b 24 73 71 6c 7d 22 5d 20 5b 6c 69  sql {$sql}"] [li
24c0: 73 74 20 24 72 65 73 75 6c 74 5d 0a 7d 0a 70 72  st $result].}.pr
24d0: 6f 63 20 64 6f 5f 63 61 74 63 68 73 71 6c 5f 74  oc do_catchsql_t
24e0: 65 73 74 20 7b 74 65 73 74 6e 61 6d 65 20 73 71  est {testname sq
24f0: 6c 20 72 65 73 75 6c 74 7d 20 7b 0a 20 20 75 70  l result} {.  up
2500: 6c 65 76 65 6c 20 64 6f 5f 74 65 73 74 20 24 74  level do_test $t
2510: 65 73 74 6e 61 6d 65 20 5b 6c 69 73 74 20 22 63  estname [list "c
2520: 61 74 63 68 73 71 6c 20 7b 24 73 71 6c 7d 22 5d  atchsql {$sql}"]
2530: 20 5b 6c 69 73 74 20 24 72 65 73 75 6c 74 5d 0a   [list $result].
2540: 7d 0a 0a 0a 23 20 52 75 6e 20 61 6e 20 53 51 4c  }...# Run an SQL
2550: 20 73 63 72 69 70 74 2e 20 20 0a 23 20 52 65 74   script.  .# Ret
2560: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
2570: 66 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 20 70  f microseconds p
2580: 65 72 20 73 74 61 74 65 6d 65 6e 74 2e 0a 23 0a  er statement..#.
2590: 70 72 6f 63 20 73 70 65 65 64 5f 74 72 69 61 6c  proc speed_trial
25a0: 20 7b 6e 61 6d 65 20 6e 75 6d 73 74 6d 74 20 75   {name numstmt u
25b0: 6e 69 74 73 20 73 71 6c 7d 20 7b 0a 20 20 70 75  nits sql} {.  pu
25c0: 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 5b 66  ts -nonewline [f
25d0: 6f 72 6d 61 74 20 7b 25 2d 32 31 2e 32 31 73 20  ormat {%-21.21s 
25e0: 7d 20 24 6e 61 6d 65 2e 2e 2e 5d 0a 20 20 66 6c  } $name...].  fl
25f0: 75 73 68 20 73 74 64 6f 75 74 0a 20 20 73 65 74  ush stdout.  set
2600: 20 73 70 65 65 64 20 5b 74 69 6d 65 20 7b 73 71   speed [time {sq
2610: 6c 69 74 65 33 5f 65 78 65 63 5f 6e 72 20 64 62  lite3_exec_nr db
2620: 20 24 73 71 6c 7d 5d 0a 20 20 73 65 74 20 74 6d   $sql}].  set tm
2630: 20 5b 6c 69 6e 64 65 78 20 24 73 70 65 65 64 20   [lindex $speed 
2640: 30 5d 0a 20 20 69 66 20 7b 24 74 6d 20 3d 3d 20  0].  if {$tm == 
2650: 30 7d 20 7b 0a 20 20 20 20 73 65 74 20 72 61 74  0} {.    set rat
2660: 65 20 5b 66 6f 72 6d 61 74 20 25 32 30 73 20 22  e [format %20s "
2670: 6d 61 6e 79 22 5d 0a 20 20 7d 20 65 6c 73 65 20  many"].  } else 
2680: 7b 0a 20 20 20 20 73 65 74 20 72 61 74 65 20 5b  {.    set rate [
2690: 66 6f 72 6d 61 74 20 25 32 30 2e 35 66 20 5b 65  format %20.5f [e
26a0: 78 70 72 20 7b 31 30 30 30 30 30 30 2e 30 2a 24  xpr {1000000.0*$
26b0: 6e 75 6d 73 74 6d 74 2f 24 74 6d 7d 5d 5d 0a 20  numstmt/$tm}]]. 
26c0: 20 7d 0a 20 20 73 65 74 20 75 32 20 24 75 6e 69   }.  set u2 $uni
26d0: 74 73 2f 73 0a 20 20 70 75 74 73 20 5b 66 6f 72  ts/s.  puts [for
26e0: 6d 61 74 20 7b 25 31 32 64 20 75 53 20 25 73 20  mat {%12d uS %s 
26f0: 25 73 7d 20 24 74 6d 20 24 72 61 74 65 20 24 75  %s} $tm $rate $u
2700: 32 5d 0a 20 20 67 6c 6f 62 61 6c 20 74 6f 74 61  2].  global tota
2710: 6c 5f 74 69 6d 65 0a 20 20 73 65 74 20 74 6f 74  l_time.  set tot
2720: 61 6c 5f 74 69 6d 65 20 5b 65 78 70 72 20 7b 24  al_time [expr {$
2730: 74 6f 74 61 6c 5f 74 69 6d 65 2b 24 74 6d 7d 5d  total_time+$tm}]
2740: 0a 7d 0a 70 72 6f 63 20 73 70 65 65 64 5f 74 72  .}.proc speed_tr
2750: 69 61 6c 5f 74 63 6c 20 7b 6e 61 6d 65 20 6e 75  ial_tcl {name nu
2760: 6d 73 74 6d 74 20 75 6e 69 74 73 20 73 63 72 69  mstmt units scri
2770: 70 74 7d 20 7b 0a 20 20 70 75 74 73 20 2d 6e 6f  pt} {.  puts -no
2780: 6e 65 77 6c 69 6e 65 20 5b 66 6f 72 6d 61 74 20  newline [format 
2790: 7b 25 2d 32 31 2e 32 31 73 20 7d 20 24 6e 61 6d  {%-21.21s } $nam
27a0: 65 2e 2e 2e 5d 0a 20 20 66 6c 75 73 68 20 73 74  e...].  flush st
27b0: 64 6f 75 74 0a 20 20 73 65 74 20 73 70 65 65 64  dout.  set speed
27c0: 20 5b 74 69 6d 65 20 7b 65 76 61 6c 20 24 73 63   [time {eval $sc
27d0: 72 69 70 74 7d 5d 0a 20 20 73 65 74 20 74 6d 20  ript}].  set tm 
27e0: 5b 6c 69 6e 64 65 78 20 24 73 70 65 65 64 20 30  [lindex $speed 0
27f0: 5d 0a 20 20 69 66 20 7b 24 74 6d 20 3d 3d 20 30  ].  if {$tm == 0
2800: 7d 20 7b 0a 20 20 20 20 73 65 74 20 72 61 74 65  } {.    set rate
2810: 20 5b 66 6f 72 6d 61 74 20 25 32 30 73 20 22 6d   [format %20s "m
2820: 61 6e 79 22 5d 0a 20 20 7d 20 65 6c 73 65 20 7b  any"].  } else {
2830: 0a 20 20 20 20 73 65 74 20 72 61 74 65 20 5b 66  .    set rate [f
2840: 6f 72 6d 61 74 20 25 32 30 2e 35 66 20 5b 65 78  ormat %20.5f [ex
2850: 70 72 20 7b 31 30 30 30 30 30 30 2e 30 2a 24 6e  pr {1000000.0*$n
2860: 75 6d 73 74 6d 74 2f 24 74 6d 7d 5d 5d 0a 20 20  umstmt/$tm}]].  
2870: 7d 0a 20 20 73 65 74 20 75 32 20 24 75 6e 69 74  }.  set u2 $unit
2880: 73 2f 73 0a 20 20 70 75 74 73 20 5b 66 6f 72 6d  s/s.  puts [form
2890: 61 74 20 7b 25 31 32 64 20 75 53 20 25 73 20 25  at {%12d uS %s %
28a0: 73 7d 20 24 74 6d 20 24 72 61 74 65 20 24 75 32  s} $tm $rate $u2
28b0: 5d 0a 20 20 67 6c 6f 62 61 6c 20 74 6f 74 61 6c  ].  global total
28c0: 5f 74 69 6d 65 0a 20 20 73 65 74 20 74 6f 74 61  _time.  set tota
28d0: 6c 5f 74 69 6d 65 20 5b 65 78 70 72 20 7b 24 74  l_time [expr {$t
28e0: 6f 74 61 6c 5f 74 69 6d 65 2b 24 74 6d 7d 5d 0a  otal_time+$tm}].
28f0: 7d 0a 70 72 6f 63 20 73 70 65 65 64 5f 74 72 69  }.proc speed_tri
2900: 61 6c 5f 69 6e 69 74 20 7b 6e 61 6d 65 7d 20 7b  al_init {name} {
2910: 0a 20 20 67 6c 6f 62 61 6c 20 74 6f 74 61 6c 5f  .  global total_
2920: 74 69 6d 65 0a 20 20 73 65 74 20 74 6f 74 61 6c  time.  set total
2930: 5f 74 69 6d 65 20 30 0a 20 20 73 71 6c 69 74 65  _time 0.  sqlite
2940: 33 20 76 65 72 73 64 62 20 3a 6d 65 6d 6f 72 79  3 versdb :memory
2950: 3a 0a 20 20 73 65 74 20 76 65 72 73 20 5b 76 65  :.  set vers [ve
2960: 72 73 64 62 20 6f 6e 65 20 7b 53 45 4c 45 43 54  rsdb one {SELECT
2970: 20 73 71 6c 69 74 65 5f 73 6f 75 72 63 65 5f 69   sqlite_source_i
2980: 64 28 29 7d 5d 0a 20 20 76 65 72 73 64 62 20 63  d()}].  versdb c
2990: 6c 6f 73 65 0a 20 20 70 75 74 73 20 22 53 51 4c  lose.  puts "SQL
29a0: 69 74 65 20 24 76 65 72 73 22 0a 7d 0a 70 72 6f  ite $vers".}.pro
29b0: 63 20 73 70 65 65 64 5f 74 72 69 61 6c 5f 73 75  c speed_trial_su
29c0: 6d 6d 61 72 79 20 7b 6e 61 6d 65 7d 20 7b 0a 20  mmary {name} {. 
29d0: 20 67 6c 6f 62 61 6c 20 74 6f 74 61 6c 5f 74 69   global total_ti
29e0: 6d 65 0a 20 20 70 75 74 73 20 5b 66 6f 72 6d 61  me.  puts [forma
29f0: 74 20 7b 25 2d 32 31 2e 32 31 73 20 25 31 32 64  t {%-21.21s %12d
2a00: 20 75 53 20 54 4f 54 41 4c 7d 20 24 6e 61 6d 65   uS TOTAL} $name
2a10: 20 24 74 6f 74 61 6c 5f 74 69 6d 65 5d 0a 7d 0a   $total_time].}.
2a20: 0a 23 20 52 75 6e 20 74 68 69 73 20 72 6f 75 74  .# Run this rout
2a30: 69 6e 65 20 6c 61 73 74 0a 23 0a 70 72 6f 63 20  ine last.#.proc 
2a40: 66 69 6e 69 73 68 5f 74 65 73 74 20 7b 7d 20 7b  finish_test {} {
2a50: 0a 20 20 63 61 74 63 68 20 7b 64 62 20 63 6c 6f  .  catch {db clo
2a60: 73 65 7d 0a 20 20 63 61 74 63 68 20 7b 64 62 32  se}.  catch {db2
2a70: 20 63 6c 6f 73 65 7d 0a 20 20 63 61 74 63 68 20   close}.  catch 
2a80: 7b 64 62 33 20 63 6c 6f 73 65 7d 0a 20 20 69 66  {db3 close}.  if
2a90: 20 7b 30 3d 3d 5b 69 6e 66 6f 20 65 78 69 73 74   {0==[info exist
2aa0: 73 20 3a 3a 53 4c 41 56 45 5d 7d 20 7b 20 66 69  s ::SLAVE]} { fi
2ab0: 6e 61 6c 69 7a 65 5f 74 65 73 74 69 6e 67 20 7d  nalize_testing }
2ac0: 0a 7d 0a 70 72 6f 63 20 66 69 6e 61 6c 69 7a 65  .}.proc finalize
2ad0: 5f 74 65 73 74 69 6e 67 20 7b 7d 20 7b 0a 20 20  _testing {} {.  
2ae0: 67 6c 6f 62 61 6c 20 73 71 6c 69 74 65 5f 6f 70  global sqlite_op
2af0: 65 6e 5f 66 69 6c 65 5f 63 6f 75 6e 74 0a 0a 20  en_file_count.. 
2b00: 20 73 65 74 20 6f 6d 69 74 4c 69 73 74 20 5b 73   set omitList [s
2b10: 65 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20  et_test_counter 
2b20: 6f 6d 69 74 5f 6c 69 73 74 5d 0a 0a 20 20 63 61  omit_list]..  ca
2b30: 74 63 68 20 7b 64 62 20 63 6c 6f 73 65 7d 0a 20  tch {db close}. 
2b40: 20 63 61 74 63 68 20 7b 64 62 32 20 63 6c 6f 73   catch {db2 clos
2b50: 65 7d 0a 20 20 63 61 74 63 68 20 7b 64 62 33 20  e}.  catch {db3 
2b60: 63 6c 6f 73 65 7d 0a 0a 20 20 76 66 73 5f 75 6e  close}..  vfs_un
2b70: 6c 69 6e 6b 5f 74 65 73 74 0a 20 20 73 71 6c 69  link_test.  sqli
2b80: 74 65 33 20 64 62 20 7b 7d 0a 20 20 23 20 73 71  te3 db {}.  # sq
2b90: 6c 69 74 65 33 5f 63 6c 65 61 72 5f 74 73 64 5f  lite3_clear_tsd_
2ba0: 6d 65 6d 64 65 62 75 67 0a 20 20 64 62 20 63 6c  memdebug.  db cl
2bb0: 6f 73 65 0a 20 20 73 71 6c 69 74 65 33 5f 72 65  ose.  sqlite3_re
2bc0: 73 65 74 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69  set_auto_extensi
2bd0: 6f 6e 0a 0a 20 20 73 71 6c 69 74 65 33 5f 73 6f  on..  sqlite3_so
2be0: 66 74 5f 68 65 61 70 5f 6c 69 6d 69 74 20 30 0a  ft_heap_limit 0.
2bf0: 20 20 73 65 74 20 6e 54 65 73 74 20 5b 69 6e 63    set nTest [inc
2c00: 72 5f 6e 74 65 73 74 5d 0a 20 20 73 65 74 20 6e  r_ntest].  set n
2c10: 45 72 72 20 5b 73 65 74 5f 74 65 73 74 5f 63 6f  Err [set_test_co
2c20: 75 6e 74 65 72 20 65 72 72 6f 72 73 5d 0a 0a 20  unter errors].. 
2c30: 20 70 75 74 73 20 22 24 6e 45 72 72 20 65 72 72   puts "$nErr err
2c40: 6f 72 73 20 6f 75 74 20 6f 66 20 24 6e 54 65 73  ors out of $nTes
2c50: 74 20 74 65 73 74 73 22 0a 20 20 69 66 20 7b 24  t tests".  if {$
2c60: 6e 45 72 72 3e 30 7d 20 7b 0a 20 20 20 20 70 75  nErr>0} {.    pu
2c70: 74 73 20 22 46 61 69 6c 75 72 65 73 20 6f 6e 20  ts "Failures on 
2c80: 74 68 65 73 65 20 74 65 73 74 73 3a 20 5b 73 65  these tests: [se
2c90: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 66  t_test_counter f
2ca0: 61 69 6c 5f 6c 69 73 74 5d 22 0a 20 20 7d 0a 20  ail_list]".  }. 
2cb0: 20 72 75 6e 5f 74 68 72 65 61 64 5f 74 65 73 74   run_thread_test
2cc0: 73 20 31 0a 20 20 69 66 20 7b 5b 6c 6c 65 6e 67  s 1.  if {[lleng
2cd0: 74 68 20 24 6f 6d 69 74 4c 69 73 74 5d 3e 30 7d  th $omitList]>0}
2ce0: 20 7b 0a 20 20 20 20 70 75 74 73 20 22 4f 6d 69   {.    puts "Omi
2cf0: 74 74 65 64 20 74 65 73 74 20 63 61 73 65 73 3a  tted test cases:
2d00: 22 0a 20 20 20 20 73 65 74 20 70 72 65 63 20 7b  ".    set prec {
2d10: 7d 0a 20 20 20 20 66 6f 72 65 61 63 68 20 7b 72  }.    foreach {r
2d20: 65 63 7d 20 5b 6c 73 6f 72 74 20 24 6f 6d 69 74  ec} [lsort $omit
2d30: 4c 69 73 74 5d 20 7b 0a 20 20 20 20 20 20 69 66  List] {.      if
2d40: 20 7b 24 72 65 63 3d 3d 24 70 72 65 63 7d 20 63   {$rec==$prec} c
2d50: 6f 6e 74 69 6e 75 65 0a 20 20 20 20 20 20 73 65  ontinue.      se
2d60: 74 20 70 72 65 63 20 24 72 65 63 0a 20 20 20 20  t prec $rec.    
2d70: 20 20 70 75 74 73 20 5b 66 6f 72 6d 61 74 20 7b    puts [format {
2d80: 20 20 25 2d 31 32 73 20 25 73 7d 20 5b 6c 69 6e    %-12s %s} [lin
2d90: 64 65 78 20 24 72 65 63 20 30 5d 20 5b 6c 69 6e  dex $rec 0] [lin
2da0: 64 65 78 20 24 72 65 63 20 31 5d 5d 0a 20 20 20  dex $rec 1]].   
2db0: 20 7d 0a 20 20 7d 0a 20 20 69 66 20 7b 24 6e 45   }.  }.  if {$nE
2dc0: 72 72 3e 30 20 26 26 20 21 5b 77 6f 72 6b 69 6e  rr>0 && ![workin
2dd0: 67 5f 36 34 62 69 74 5f 69 6e 74 5d 7d 20 7b 0a  g_64bit_int]} {.
2de0: 20 20 20 20 70 75 74 73 20 22 2a 2a 2a 2a 2a 2a      puts "******
2df0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2e20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 22 0a 20 20  ************".  
2e30: 20 20 70 75 74 73 20 22 4e 2e 42 2e 3a 20 20 54    puts "N.B.:  T
2e40: 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 54 43  he version of TC
2e50: 4c 20 74 68 61 74 20 79 6f 75 20 75 73 65 64 20  L that you used 
2e60: 74 6f 20 62 75 69 6c 64 20 74 68 69 73 20 74 65  to build this te
2e70: 73 74 20 68 61 72 6e 65 73 73 22 0a 20 20 20 20  st harness".    
2e80: 70 75 74 73 20 22 69 73 20 64 65 66 65 63 74 69  puts "is defecti
2e90: 76 65 20 69 6e 20 74 68 61 74 20 69 74 20 64 6f  ve in that it do
2ea0: 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 36  es not support 6
2eb0: 34 2d 62 69 74 20 69 6e 74 65 67 65 72 73 2e 20  4-bit integers. 
2ec0: 20 53 6f 6d 65 20 6f 72 22 0a 20 20 20 20 70 75   Some or".    pu
2ed0: 74 73 20 22 61 6c 6c 20 6f 66 20 74 68 65 20 74  ts "all of the t
2ee0: 65 73 74 20 66 61 69 6c 75 72 65 73 20 61 62 6f  est failures abo
2ef0: 76 65 20 6d 69 67 68 74 20 62 65 20 61 20 72 65  ve might be a re
2f00: 73 75 6c 74 20 66 72 6f 6d 20 74 68 69 73 20 64  sult from this d
2f10: 65 66 65 63 74 22 0a 20 20 20 20 70 75 74 73 20  efect".    puts 
2f20: 22 69 6e 20 79 6f 75 72 20 54 43 4c 20 62 75 69  "in your TCL bui
2f30: 6c 64 2e 22 0a 20 20 20 20 70 75 74 73 20 22 2a  ld.".    puts "*
2f40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2f80: 2a 22 0a 20 20 7d 0a 20 20 69 66 20 7b 24 3a 3a  *".  }.  if {$::
2f90: 63 6d 64 6c 69 6e 65 61 72 67 28 62 69 6e 61 72  cmdlinearg(binar
2fa0: 79 6c 6f 67 29 7d 20 7b 0a 20 20 20 20 76 66 73  ylog)} {.    vfs
2fb0: 6c 6f 67 20 66 69 6e 61 6c 69 7a 65 20 62 69 6e  log finalize bin
2fc0: 61 72 79 6c 6f 67 0a 20 20 7d 0a 20 20 69 66 20  arylog.  }.  if 
2fd0: 7b 24 73 71 6c 69 74 65 5f 6f 70 65 6e 5f 66 69  {$sqlite_open_fi
2fe0: 6c 65 5f 63 6f 75 6e 74 7d 20 7b 0a 20 20 20 20  le_count} {.    
2ff0: 70 75 74 73 20 22 24 73 71 6c 69 74 65 5f 6f 70  puts "$sqlite_op
3000: 65 6e 5f 66 69 6c 65 5f 63 6f 75 6e 74 20 66 69  en_file_count fi
3010: 6c 65 73 20 77 65 72 65 20 6c 65 66 74 20 6f 70  les were left op
3020: 65 6e 22 0a 20 20 20 20 69 6e 63 72 20 6e 45 72  en".    incr nEr
3030: 72 0a 20 20 7d 0a 20 20 69 66 20 7b 5b 6c 69 6e  r.  }.  if {[lin
3040: 64 65 78 20 5b 73 71 6c 69 74 65 33 5f 73 74 61  dex [sqlite3_sta
3050: 74 75 73 20 53 51 4c 49 54 45 5f 53 54 41 54 55  tus SQLITE_STATU
3060: 53 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 20 30  S_MALLOC_COUNT 0
3070: 5d 20 31 5d 3e 30 20 7c 7c 0a 20 20 20 20 20 20  ] 1]>0 ||.      
3080: 20 20 20 20 20 20 20 20 5b 73 71 6c 69 74 65 33          [sqlite3
3090: 5f 6d 65 6d 6f 72 79 5f 75 73 65 64 5d 3e 30 7d  _memory_used]>0}
30a0: 20 7b 0a 20 20 20 20 70 75 74 73 20 22 55 6e 66   {.    puts "Unf
30b0: 72 65 65 64 20 6d 65 6d 6f 72 79 3a 20 5b 73 71  reed memory: [sq
30c0: 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 75 73 65  lite3_memory_use
30d0: 64 5d 20 62 79 74 65 73 20 69 6e 5c 0a 20 20 20  d] bytes in\.   
30e0: 20 20 20 20 20 20 5b 6c 69 6e 64 65 78 20 5b 73        [lindex [s
30f0: 71 6c 69 74 65 33 5f 73 74 61 74 75 73 20 53 51  qlite3_status SQ
3100: 4c 49 54 45 5f 53 54 41 54 55 53 5f 4d 41 4c 4c  LITE_STATUS_MALL
3110: 4f 43 5f 43 4f 55 4e 54 20 30 5d 20 31 5d 20 61  OC_COUNT 0] 1] a
3120: 6c 6c 6f 63 61 74 69 6f 6e 73 22 0a 20 20 20 20  llocations".    
3130: 69 6e 63 72 20 6e 45 72 72 0a 20 20 20 20 69 66  incr nErr.    if
3140: 63 61 70 61 62 6c 65 20 6d 65 6d 64 65 62 75 67  capable memdebug
3150: 7c 7c 6d 65 6d 35 7c 7c 28 6d 65 6d 33 26 26 64  ||mem5||(mem3&&d
3160: 65 62 75 67 29 20 7b 0a 20 20 20 20 20 20 70 75  ebug) {.      pu
3170: 74 73 20 22 57 72 69 74 69 6e 67 20 75 6e 66 72  ts "Writing unfr
3180: 65 65 64 20 6d 65 6d 6f 72 79 20 6c 6f 67 20 74  eed memory log t
3190: 6f 20 5c 22 2e 2f 6d 65 6d 6c 65 61 6b 2e 74 78  o \"./memleak.tx
31a0: 74 5c 22 22 0a 20 20 20 20 20 20 73 71 6c 69 74  t\"".      sqlit
31b0: 65 33 5f 6d 65 6d 64 65 62 75 67 5f 64 75 6d 70  e3_memdebug_dump
31c0: 20 2e 2f 6d 65 6d 6c 65 61 6b 2e 74 78 74 0a 20   ./memleak.txt. 
31d0: 20 20 20 7d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a     }.  } else {.
31e0: 20 20 20 20 70 75 74 73 20 22 41 6c 6c 20 6d 65      puts "All me
31f0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73  mory allocations
3200: 20 66 72 65 65 64 20 2d 20 6e 6f 20 6c 65 61 6b   freed - no leak
3210: 73 22 0a 20 20 20 20 69 66 63 61 70 61 62 6c 65  s".    ifcapable
3220: 20 6d 65 6d 64 65 62 75 67 7c 7c 6d 65 6d 35 20   memdebug||mem5 
3230: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
3240: 6d 65 6d 64 65 62 75 67 5f 64 75 6d 70 20 2e 2f  memdebug_dump ./
3250: 6d 65 6d 75 73 61 67 65 2e 74 78 74 0a 20 20 20  memusage.txt.   
3260: 20 7d 0a 20 20 7d 0a 20 20 73 68 6f 77 5f 6d 65   }.  }.  show_me
3270: 6d 73 74 61 74 73 0a 20 20 70 75 74 73 20 22 4d  mstats.  puts "M
3280: 61 78 69 6d 75 6d 20 6d 65 6d 6f 72 79 20 75 73  aximum memory us
3290: 61 67 65 3a 20 5b 73 71 6c 69 74 65 33 5f 6d 65  age: [sqlite3_me
32a0: 6d 6f 72 79 5f 68 69 67 68 77 61 74 65 72 20 31  mory_highwater 1
32b0: 5d 20 62 79 74 65 73 22 0a 20 20 70 75 74 73 20  ] bytes".  puts 
32c0: 22 43 75 72 72 65 6e 74 20 6d 65 6d 6f 72 79 20  "Current memory 
32d0: 75 73 61 67 65 3a 20 5b 73 71 6c 69 74 65 33 5f  usage: [sqlite3_
32e0: 6d 65 6d 6f 72 79 5f 68 69 67 68 77 61 74 65 72  memory_highwater
32f0: 5d 20 62 79 74 65 73 22 0a 20 20 69 66 20 7b 5b  ] bytes".  if {[
3300: 69 6e 66 6f 20 63 6f 6d 6d 61 6e 64 73 20 73 71  info commands sq
3310: 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 6d  lite3_memdebug_m
3320: 61 6c 6c 6f 63 5f 63 6f 75 6e 74 5d 20 6e 65 20  alloc_count] ne 
3330: 22 22 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22  ""} {.    puts "
3340: 4e 75 6d 62 65 72 20 6f 66 20 6d 61 6c 6c 6f 63  Number of malloc
3350: 28 29 20 20 3a 20 5b 73 71 6c 69 74 65 33 5f 6d  ()  : [sqlite3_m
3360: 65 6d 64 65 62 75 67 5f 6d 61 6c 6c 6f 63 5f 63  emdebug_malloc_c
3370: 6f 75 6e 74 5d 20 63 61 6c 6c 73 22 0a 20 20 7d  ount] calls".  }
3380: 0a 20 20 69 66 20 7b 24 3a 3a 63 6d 64 6c 69 6e  .  if {$::cmdlin
3390: 65 61 72 67 28 6d 61 6c 6c 6f 63 74 72 61 63 65  earg(malloctrace
33a0: 29 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22 57  )} {.    puts "W
33b0: 72 69 74 69 6e 67 20 6d 61 6c 6c 6f 63 73 2e 73  riting mallocs.s
33c0: 71 6c 2e 2e 2e 22 0a 20 20 20 20 6d 65 6d 64 65  ql...".    memde
33d0: 62 75 67 5f 6c 6f 67 5f 73 71 6c 0a 20 20 20 20  bug_log_sql.    
33e0: 73 71 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67  sqlite3_memdebug
33f0: 5f 6c 6f 67 20 73 74 6f 70 0a 20 20 20 20 73 71  _log stop.    sq
3400: 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 6c  lite3_memdebug_l
3410: 6f 67 20 63 6c 65 61 72 0a 0a 20 20 20 20 69 66  og clear..    if
3420: 20 7b 5b 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72   {[sqlite3_memor
3430: 79 5f 75 73 65 64 5d 3e 30 7d 20 7b 0a 20 20 20  y_used]>0} {.   
3440: 20 20 20 70 75 74 73 20 22 57 72 69 74 69 6e 67     puts "Writing
3450: 20 6c 65 61 6b 73 2e 73 71 6c 2e 2e 2e 22 0a 20   leaks.sql...". 
3460: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d       sqlite3_mem
3470: 64 65 62 75 67 5f 6c 6f 67 20 73 79 6e 63 0a 20  debug_log sync. 
3480: 20 20 20 20 20 6d 65 6d 64 65 62 75 67 5f 6c 6f       memdebug_lo
3490: 67 5f 73 71 6c 20 6c 65 61 6b 73 2e 73 71 6c 0a  g_sql leaks.sql.
34a0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 65      }.  }.  fore
34b0: 61 63 68 20 66 20 5b 67 6c 6f 62 20 2d 6e 6f 63  ach f [glob -noc
34c0: 6f 6d 70 6c 61 69 6e 20 74 65 73 74 2e 64 62 2d  omplain test.db-
34d0: 2a 2d 6a 6f 75 72 6e 61 6c 5d 20 7b 0a 20 20 20  *-journal] {.   
34e0: 20 66 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f   file delete -fo
34f0: 72 63 65 20 24 66 0a 20 20 7d 0a 20 20 66 6f 72  rce $f.  }.  for
3500: 65 61 63 68 20 66 20 5b 67 6c 6f 62 20 2d 6e 6f  each f [glob -no
3510: 63 6f 6d 70 6c 61 69 6e 20 74 65 73 74 2e 64 62  complain test.db
3520: 2d 6d 6a 2a 5d 20 7b 0a 20 20 20 20 66 69 6c 65  -mj*] {.    file
3530: 20 64 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 24   delete -force $
3540: 66 0a 20 20 7d 0a 20 20 65 78 69 74 20 5b 65 78  f.  }.  exit [ex
3550: 70 72 20 7b 24 6e 45 72 72 3e 30 7d 5d 0a 7d 0a  pr {$nErr>0}].}.
3560: 0a 23 20 44 69 73 70 6c 61 79 20 6d 65 6d 6f 72  .# Display memor
3570: 79 20 73 74 61 74 69 73 74 69 63 73 20 66 6f 72  y statistics for
3580: 20 61 6e 61 6c 79 73 69 73 20 61 6e 64 20 64 65   analysis and de
3590: 62 75 67 67 69 6e 67 20 70 75 72 70 6f 73 65 73  bugging purposes
35a0: 2e 0a 23 0a 70 72 6f 63 20 73 68 6f 77 5f 6d 65  ..#.proc show_me
35b0: 6d 73 74 61 74 73 20 7b 7d 20 7b 0a 20 20 73 65  mstats {} {.  se
35c0: 74 20 78 20 5b 73 71 6c 69 74 65 33 5f 73 74 61  t x [sqlite3_sta
35d0: 74 75 73 20 53 51 4c 49 54 45 5f 53 54 41 54 55  tus SQLITE_STATU
35e0: 53 5f 4d 45 4d 4f 52 59 5f 55 53 45 44 20 30 5d  S_MEMORY_USED 0]
35f0: 0a 20 20 73 65 74 20 79 20 5b 73 71 6c 69 74 65  .  set y [sqlite
3600: 33 5f 73 74 61 74 75 73 20 53 51 4c 49 54 45 5f  3_status SQLITE_
3610: 53 54 41 54 55 53 5f 4d 41 4c 4c 4f 43 5f 53 49  STATUS_MALLOC_SI
3620: 5a 45 20 30 5d 0a 20 20 73 65 74 20 76 61 6c 20  ZE 0].  set val 
3630: 5b 66 6f 72 6d 61 74 20 7b 6e 6f 77 20 25 31 30  [format {now %10
3640: 64 20 20 6d 61 78 20 25 31 30 64 20 20 6d 61 78  d  max %10d  max
3650: 2d 73 69 7a 65 20 25 31 30 64 7d 20 5c 0a 20 20  -size %10d} \.  
3660: 20 20 20 20 20 20 20 20 20 20 20 20 5b 6c 69 6e              [lin
3670: 64 65 78 20 24 78 20 31 5d 20 5b 6c 69 6e 64 65  dex $x 1] [linde
3680: 78 20 24 78 20 32 5d 20 5b 6c 69 6e 64 65 78 20  x $x 2] [lindex 
3690: 24 79 20 32 5d 5d 0a 20 20 70 75 74 73 20 22 4d  $y 2]].  puts "M
36a0: 65 6d 6f 72 79 20 75 73 65 64 3a 20 20 20 20 20  emory used:     
36b0: 20 20 20 20 20 24 76 61 6c 22 0a 20 20 73 65 74       $val".  set
36c0: 20 78 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74   x [sqlite3_stat
36d0: 75 73 20 53 51 4c 49 54 45 5f 53 54 41 54 55 53  us SQLITE_STATUS
36e0: 5f 4d 41 4c 4c 4f 43 5f 43 4f 55 4e 54 20 30 5d  _MALLOC_COUNT 0]
36f0: 0a 20 20 73 65 74 20 76 61 6c 20 5b 66 6f 72 6d  .  set val [form
3700: 61 74 20 7b 6e 6f 77 20 25 31 30 64 20 20 6d 61  at {now %10d  ma
3710: 78 20 25 31 30 64 7d 20 5b 6c 69 6e 64 65 78 20  x %10d} [lindex 
3720: 24 78 20 31 5d 20 5b 6c 69 6e 64 65 78 20 24 78  $x 1] [lindex $x
3730: 20 32 5d 5d 0a 20 20 70 75 74 73 20 22 41 6c 6c   2]].  puts "All
3740: 6f 63 61 74 69 6f 6e 20 63 6f 75 6e 74 3a 20 20  ocation count:  
3750: 20 20 20 24 76 61 6c 22 0a 20 20 73 65 74 20 78     $val".  set x
3760: 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74 75 73   [sqlite3_status
3770: 20 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50   SQLITE_STATUS_P
3780: 41 47 45 43 41 43 48 45 5f 55 53 45 44 20 30 5d  AGECACHE_USED 0]
3790: 0a 20 20 73 65 74 20 79 20 5b 73 71 6c 69 74 65  .  set y [sqlite
37a0: 33 5f 73 74 61 74 75 73 20 53 51 4c 49 54 45 5f  3_status SQLITE_
37b0: 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45  STATUS_PAGECACHE
37c0: 5f 53 49 5a 45 20 30 5d 0a 20 20 73 65 74 20 76  _SIZE 0].  set v
37d0: 61 6c 20 5b 66 6f 72 6d 61 74 20 7b 6e 6f 77 20  al [format {now 
37e0: 25 31 30 64 20 20 6d 61 78 20 25 31 30 64 20 20  %10d  max %10d  
37f0: 6d 61 78 2d 73 69 7a 65 20 25 31 30 64 7d 20 5c  max-size %10d} \
3800: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b  .              [
3810: 6c 69 6e 64 65 78 20 24 78 20 31 5d 20 5b 6c 69  lindex $x 1] [li
3820: 6e 64 65 78 20 24 78 20 32 5d 20 5b 6c 69 6e 64  ndex $x 2] [lind
3830: 65 78 20 24 79 20 32 5d 5d 0a 20 20 70 75 74 73  ex $y 2]].  puts
3840: 20 22 50 61 67 65 2d 63 61 63 68 65 20 75 73 65   "Page-cache use
3850: 64 3a 20 20 20 20 20 20 24 76 61 6c 22 0a 20 20  d:      $val".  
3860: 73 65 74 20 78 20 5b 73 71 6c 69 74 65 33 5f 73  set x [sqlite3_s
3870: 74 61 74 75 73 20 53 51 4c 49 54 45 5f 53 54 41  tatus SQLITE_STA
3880: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 4f 56  TUS_PAGECACHE_OV
3890: 45 52 46 4c 4f 57 20 30 5d 0a 20 20 73 65 74 20  ERFLOW 0].  set 
38a0: 76 61 6c 20 5b 66 6f 72 6d 61 74 20 7b 6e 6f 77  val [format {now
38b0: 20 25 31 30 64 20 20 6d 61 78 20 25 31 30 64 7d   %10d  max %10d}
38c0: 20 5b 6c 69 6e 64 65 78 20 24 78 20 31 5d 20 5b   [lindex $x 1] [
38d0: 6c 69 6e 64 65 78 20 24 78 20 32 5d 5d 0a 20 20  lindex $x 2]].  
38e0: 70 75 74 73 20 22 50 61 67 65 2d 63 61 63 68 65  puts "Page-cache
38f0: 20 6f 76 65 72 66 6c 6f 77 3a 20 20 24 76 61 6c   overflow:  $val
3900: 22 0a 20 20 73 65 74 20 78 20 5b 73 71 6c 69 74  ".  set x [sqlit
3910: 65 33 5f 73 74 61 74 75 73 20 53 51 4c 49 54 45  e3_status SQLITE
3920: 5f 53 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f  _STATUS_SCRATCH_
3930: 55 53 45 44 20 30 5d 0a 20 20 73 65 74 20 76 61  USED 0].  set va
3940: 6c 20 5b 66 6f 72 6d 61 74 20 7b 6e 6f 77 20 25  l [format {now %
3950: 31 30 64 20 20 6d 61 78 20 25 31 30 64 7d 20 5b  10d  max %10d} [
3960: 6c 69 6e 64 65 78 20 24 78 20 31 5d 20 5b 6c 69  lindex $x 1] [li
3970: 6e 64 65 78 20 24 78 20 32 5d 5d 0a 20 20 70 75  ndex $x 2]].  pu
3980: 74 73 20 22 53 63 72 61 74 63 68 20 6d 65 6d 6f  ts "Scratch memo
3990: 72 79 20 75 73 65 64 3a 20 20 24 76 61 6c 22 0a  ry used:  $val".
39a0: 20 20 73 65 74 20 78 20 5b 73 71 6c 69 74 65 33    set x [sqlite3
39b0: 5f 73 74 61 74 75 73 20 53 51 4c 49 54 45 5f 53  _status SQLITE_S
39c0: 54 41 54 55 53 5f 53 43 52 41 54 43 48 5f 4f 56  TATUS_SCRATCH_OV
39d0: 45 52 46 4c 4f 57 20 30 5d 0a 20 20 73 65 74 20  ERFLOW 0].  set 
39e0: 79 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74 75  y [sqlite3_statu
39f0: 73 20 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f  s SQLITE_STATUS_
3a00: 53 43 52 41 54 43 48 5f 53 49 5a 45 20 30 5d 0a  SCRATCH_SIZE 0].
3a10: 20 20 73 65 74 20 76 61 6c 20 5b 66 6f 72 6d 61    set val [forma
3a20: 74 20 7b 6e 6f 77 20 25 31 30 64 20 20 6d 61 78  t {now %10d  max
3a30: 20 25 31 30 64 20 20 6d 61 78 2d 73 69 7a 65 20   %10d  max-size 
3a40: 25 31 30 64 7d 20 5c 0a 20 20 20 20 20 20 20 20  %10d} \.        
3a50: 20 20 20 20 20 20 20 5b 6c 69 6e 64 65 78 20 24         [lindex $
3a60: 78 20 31 5d 20 5b 6c 69 6e 64 65 78 20 24 78 20  x 1] [lindex $x 
3a70: 32 5d 20 5b 6c 69 6e 64 65 78 20 24 79 20 32 5d  2] [lindex $y 2]
3a80: 5d 0a 20 20 70 75 74 73 20 22 53 63 72 61 74 63  ].  puts "Scratc
3a90: 68 20 6f 76 65 72 66 6c 6f 77 3a 20 20 20 20 20  h overflow:     
3aa0: 24 76 61 6c 22 0a 20 20 69 66 63 61 70 61 62 6c  $val".  ifcapabl
3ab0: 65 20 79 79 74 72 61 63 6b 6d 61 78 73 74 61 63  e yytrackmaxstac
3ac0: 6b 64 65 70 74 68 20 7b 0a 20 20 20 20 73 65 74  kdepth {.    set
3ad0: 20 78 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74   x [sqlite3_stat
3ae0: 75 73 20 53 51 4c 49 54 45 5f 53 54 41 54 55 53  us SQLITE_STATUS
3af0: 5f 50 41 52 53 45 52 5f 53 54 41 43 4b 20 30 5d  _PARSER_STACK 0]
3b00: 0a 20 20 20 20 73 65 74 20 76 61 6c 20 5b 66 6f  .    set val [fo
3b10: 72 6d 61 74 20 7b 20 20 20 20 20 20 20 20 20 20  rmat {          
3b20: 20 20 20 20 20 6d 61 78 20 25 31 30 64 7d 20 5b       max %10d} [
3b30: 6c 69 6e 64 65 78 20 24 78 20 32 5d 5d 0a 20 20  lindex $x 2]].  
3b40: 20 20 70 75 74 73 20 22 50 61 72 73 65 72 20 73    puts "Parser s
3b50: 74 61 63 6b 20 64 65 70 74 68 3a 20 20 20 20 24  tack depth:    $
3b60: 76 61 6c 22 0a 20 20 7d 0a 7d 0a 0a 23 20 41 20  val".  }.}..# A 
3b70: 70 72 6f 63 65 64 75 72 65 20 74 6f 20 65 78 65  procedure to exe
3b80: 63 75 74 65 20 53 51 4c 0a 23 0a 70 72 6f 63 20  cute SQL.#.proc 
3b90: 65 78 65 63 73 71 6c 20 7b 73 71 6c 20 7b 64 62  execsql {sql {db
3ba0: 20 64 62 7d 7d 20 7b 0a 20 20 23 20 70 75 74 73   db}} {.  # puts
3bb0: 20 22 53 51 4c 20 3d 20 24 73 71 6c 22 0a 20 20   "SQL = $sql".  
3bc0: 75 70 6c 65 76 65 6c 20 5b 6c 69 73 74 20 24 64  uplevel [list $d
3bd0: 62 20 65 76 61 6c 20 24 73 71 6c 5d 0a 7d 0a 0a  b eval $sql].}..
3be0: 23 20 45 78 65 63 75 74 65 20 53 51 4c 20 61 6e  # Execute SQL an
3bf0: 64 20 63 61 74 63 68 20 65 78 63 65 70 74 69 6f  d catch exceptio
3c00: 6e 73 2e 0a 23 0a 70 72 6f 63 20 63 61 74 63 68  ns..#.proc catch
3c10: 73 71 6c 20 7b 73 71 6c 20 7b 64 62 20 64 62 7d  sql {sql {db db}
3c20: 7d 20 7b 0a 20 20 23 20 70 75 74 73 20 22 53 51  } {.  # puts "SQ
3c30: 4c 20 3d 20 24 73 71 6c 22 0a 20 20 73 65 74 20  L = $sql".  set 
3c40: 72 20 5b 63 61 74 63 68 20 5b 6c 69 73 74 20 75  r [catch [list u
3c50: 70 6c 65 76 65 6c 20 5b 6c 69 73 74 20 24 64 62  plevel [list $db
3c60: 20 65 76 61 6c 20 24 73 71 6c 5d 5d 20 6d 73 67   eval $sql]] msg
3c70: 5d 0a 20 20 6c 61 70 70 65 6e 64 20 72 20 24 6d  ].  lappend r $m
3c80: 73 67 0a 20 20 72 65 74 75 72 6e 20 24 72 0a 7d  sg.  return $r.}
3c90: 0a 0a 23 20 44 6f 20 61 6e 20 56 44 42 45 20 63  ..# Do an VDBE c
3ca0: 6f 64 65 20 64 75 6d 70 20 6f 6e 20 74 68 65 20  ode dump on the 
3cb0: 53 51 4c 20 67 69 76 65 6e 0a 23 0a 70 72 6f 63  SQL given.#.proc
3cc0: 20 65 78 70 6c 61 69 6e 20 7b 73 71 6c 20 7b 64   explain {sql {d
3cd0: 62 20 64 62 7d 7d 20 7b 0a 20 20 70 75 74 73 20  b db}} {.  puts 
3ce0: 22 22 0a 20 20 70 75 74 73 20 22 61 64 64 72 20  "".  puts "addr 
3cf0: 20 6f 70 63 6f 64 65 20 20 20 20 20 20 20 20 70   opcode        p
3d00: 31 20 20 20 20 20 20 70 32 20 20 20 20 20 20 70  1      p2      p
3d10: 33 20 20 20 20 20 20 70 34 20 20 20 20 20 20 20  3      p4       
3d20: 20 20 20 20 20 20 20 20 70 35 20 20 23 22 0a 20          p5  #". 
3d30: 20 70 75 74 73 20 22 2d 2d 2d 2d 20 20 2d 2d 2d   puts "----  ---
3d40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d 2d  ---------  -----
3d50: 2d 20 20 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d 2d  -  ------  -----
3d60: 2d 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  -  -------------
3d70: 2d 2d 20 20 2d 2d 20 20 2d 22 0a 20 20 24 64 62  --  --  -".  $db
3d80: 20 65 76 61 6c 20 22 65 78 70 6c 61 69 6e 20 24   eval "explain $
3d90: 73 71 6c 22 20 7b 7d 20 7b 0a 20 20 20 20 70 75  sql" {} {.    pu
3da0: 74 73 20 5b 66 6f 72 6d 61 74 20 7b 25 2d 34 64  ts [format {%-4d
3db0: 20 20 25 2d 31 32 2e 31 32 73 20 20 25 2d 36 64    %-12.12s  %-6d
3dc0: 20 20 25 2d 36 64 20 20 25 2d 36 64 20 20 25 20    %-6d  %-6d  % 
3dd0: 2d 31 37 73 20 25 73 20 20 25 73 7d 20 5c 0a 20  -17s %s  %s} \. 
3de0: 20 20 20 20 20 24 61 64 64 72 20 24 6f 70 63 6f       $addr $opco
3df0: 64 65 20 24 70 31 20 24 70 32 20 24 70 33 20 24  de $p1 $p2 $p3 $
3e00: 70 34 20 24 70 35 20 24 63 6f 6d 6d 65 6e 74 0a  p4 $p5 $comment.
3e10: 20 20 20 20 5d 0a 20 20 7d 0a 7d 0a 0a 23 20 53      ].  }.}..# S
3e20: 68 6f 77 20 74 68 65 20 56 44 42 45 20 70 72 6f  how the VDBE pro
3e30: 67 72 61 6d 20 66 6f 72 20 61 6e 20 53 51 4c 20  gram for an SQL 
3e40: 73 74 61 74 65 6d 65 6e 74 20 62 75 74 20 6f 6d  statement but om
3e50: 69 74 20 74 68 65 20 54 72 61 63 65 0a 23 20 6f  it the Trace.# o
3e60: 70 63 6f 64 65 20 61 74 20 74 68 65 20 62 65 67  pcode at the beg
3e70: 69 6e 6e 69 6e 67 2e 20 20 54 68 69 73 20 70 72  inning.  This pr
3e80: 6f 63 65 64 75 72 65 20 63 61 6e 20 62 65 20 75  ocedure can be u
3e90: 73 65 64 20 74 6f 20 70 72 6f 76 65 0a 23 20 74  sed to prove.# t
3ea0: 68 61 74 20 64 69 66 66 65 72 65 6e 74 20 53 51  hat different SQ
3eb0: 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 67 65 6e  L statements gen
3ec0: 65 72 61 74 65 20 65 78 61 63 74 6c 79 20 74 68  erate exactly th
3ed0: 65 20 73 61 6d 65 20 56 44 42 45 20 63 6f 64 65  e same VDBE code
3ee0: 2e 0a 23 0a 70 72 6f 63 20 65 78 70 6c 61 69 6e  ..#.proc explain
3ef0: 5f 6e 6f 5f 74 72 61 63 65 20 7b 73 71 6c 7d 20  _no_trace {sql} 
3f00: 7b 0a 20 20 73 65 74 20 74 72 20 5b 64 62 20 65  {.  set tr [db e
3f10: 76 61 6c 20 22 45 58 50 4c 41 49 4e 20 24 73 71  val "EXPLAIN $sq
3f20: 6c 22 5d 0a 20 20 72 65 74 75 72 6e 20 5b 6c 72  l"].  return [lr
3f30: 61 6e 67 65 20 24 74 72 20 37 20 65 6e 64 5d 0a  ange $tr 7 end].
3f40: 7d 0a 0a 23 20 41 6e 6f 74 68 65 72 20 70 72 6f  }..# Another pro
3f50: 63 65 64 75 72 65 20 74 6f 20 65 78 65 63 75 74  cedure to execut
3f60: 65 20 53 51 4c 2e 20 20 54 68 69 73 20 6f 6e 65  e SQL.  This one
3f70: 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 66 69   includes the fi
3f80: 65 6c 64 0a 23 20 6e 61 6d 65 73 20 69 6e 20 74  eld.# names in t
3f90: 68 65 20 72 65 74 75 72 6e 65 64 20 6c 69 73 74  he returned list
3fa0: 2e 0a 23 0a 70 72 6f 63 20 65 78 65 63 73 71 6c  ..#.proc execsql
3fb0: 32 20 7b 73 71 6c 7d 20 7b 0a 20 20 73 65 74 20  2 {sql} {.  set 
3fc0: 72 65 73 75 6c 74 20 7b 7d 0a 20 20 64 62 20 65  result {}.  db e
3fd0: 76 61 6c 20 24 73 71 6c 20 64 61 74 61 20 7b 0a  val $sql data {.
3fe0: 20 20 20 20 66 6f 72 65 61 63 68 20 66 20 24 64      foreach f $d
3ff0: 61 74 61 28 2a 29 20 7b 0a 20 20 20 20 20 20 6c  ata(*) {.      l
4000: 61 70 70 65 6e 64 20 72 65 73 75 6c 74 20 24 66  append result $f
4010: 20 24 64 61 74 61 28 24 66 29 0a 20 20 20 20 7d   $data($f).    }
4020: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 24 72  .  }.  return $r
4030: 65 73 75 6c 74 0a 7d 0a 0a 23 20 55 73 65 20 74  esult.}..# Use t
4040: 68 65 20 6e 6f 6e 2d 63 61 6c 6c 62 61 63 6b 20  he non-callback 
4050: 41 50 49 20 74 6f 20 65 78 65 63 75 74 65 20 6d  API to execute m
4060: 75 6c 74 69 70 6c 65 20 53 51 4c 20 73 74 61 74  ultiple SQL stat
4070: 65 6d 65 6e 74 73 0a 23 0a 70 72 6f 63 20 73 74  ements.#.proc st
4080: 65 70 73 71 6c 20 7b 64 62 70 74 72 20 73 71 6c  epsql {dbptr sql
4090: 7d 20 7b 0a 20 20 73 65 74 20 73 71 6c 20 5b 73  } {.  set sql [s
40a0: 74 72 69 6e 67 20 74 72 69 6d 20 24 73 71 6c 5d  tring trim $sql]
40b0: 0a 20 20 73 65 74 20 72 20 30 0a 20 20 77 68 69  .  set r 0.  whi
40c0: 6c 65 20 7b 5b 73 74 72 69 6e 67 20 6c 65 6e 67  le {[string leng
40d0: 74 68 20 24 73 71 6c 5d 3e 30 7d 20 7b 0a 20 20  th $sql]>0} {.  
40e0: 20 20 69 66 20 7b 5b 63 61 74 63 68 20 7b 73 71    if {[catch {sq
40f0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 20 24 64  lite3_prepare $d
4100: 62 70 74 72 20 24 73 71 6c 20 2d 31 20 73 71 6c  bptr $sql -1 sql
4110: 74 61 69 6c 7d 20 76 6d 5d 7d 20 7b 0a 20 20 20  tail} vm]} {.   
4120: 20 20 20 72 65 74 75 72 6e 20 5b 6c 69 73 74 20     return [list 
4130: 31 20 24 76 6d 5d 0a 20 20 20 20 7d 0a 20 20 20  1 $vm].    }.   
4140: 20 73 65 74 20 73 71 6c 20 5b 73 74 72 69 6e 67   set sql [string
4150: 20 74 72 69 6d 20 24 73 71 6c 74 61 69 6c 5d 0a   trim $sqltail].
4160: 23 20 20 20 20 77 68 69 6c 65 20 7b 5b 73 71 6c  #    while {[sql
4170: 69 74 65 5f 73 74 65 70 20 24 76 6d 20 4e 20 56  ite_step $vm N V
4180: 41 4c 20 43 4f 4c 5d 3d 3d 22 53 51 4c 49 54 45  AL COL]=="SQLITE
4190: 5f 52 4f 57 22 7d 20 7b 0a 23 20 20 20 20 20 20  _ROW"} {.#      
41a0: 66 6f 72 65 61 63 68 20 76 20 24 56 41 4c 20 7b  foreach v $VAL {
41b0: 6c 61 70 70 65 6e 64 20 72 20 24 76 7d 0a 23 20  lappend r $v}.# 
41c0: 20 20 20 7d 0a 20 20 20 20 77 68 69 6c 65 20 7b     }.    while {
41d0: 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 20 24 76  [sqlite3_step $v
41e0: 6d 5d 3d 3d 22 53 51 4c 49 54 45 5f 52 4f 57 22  m]=="SQLITE_ROW"
41f0: 7d 20 7b 0a 20 20 20 20 20 20 66 6f 72 20 7b 73  } {.      for {s
4200: 65 74 20 69 20 30 7d 20 7b 24 69 3c 5b 73 71 6c  et i 0} {$i<[sql
4210: 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e 74 20  ite3_data_count 
4220: 24 76 6d 5d 7d 20 7b 69 6e 63 72 20 69 7d 20 7b  $vm]} {incr i} {
4230: 0a 20 20 20 20 20 20 20 20 6c 61 70 70 65 6e 64  .        lappend
4240: 20 72 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75   r [sqlite3_colu
4250: 6d 6e 5f 74 65 78 74 20 24 76 6d 20 24 69 5d 0a  mn_text $vm $i].
4260: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
4270: 20 20 69 66 20 7b 5b 63 61 74 63 68 20 7b 73 71    if {[catch {sq
4280: 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 20 24  lite3_finalize $
4290: 76 6d 7d 20 65 72 72 6d 73 67 5d 7d 20 7b 0a 20  vm} errmsg]} {. 
42a0: 20 20 20 20 20 72 65 74 75 72 6e 20 5b 6c 69 73       return [lis
42b0: 74 20 31 20 24 65 72 72 6d 73 67 5d 0a 20 20 20  t 1 $errmsg].   
42c0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
42d0: 24 72 0a 7d 0a 0a 23 20 44 65 6c 65 74 65 20 61  $r.}..# Delete a
42e0: 20 66 69 6c 65 20 6f 72 20 64 69 72 65 63 74 6f   file or directo
42f0: 72 79 0a 23 0a 70 72 6f 63 20 66 6f 72 63 65 64  ry.#.proc forced
4300: 65 6c 65 74 65 20 7b 66 69 6c 65 6e 61 6d 65 7d  elete {filename}
4310: 20 7b 0a 20 20 23 20 4f 6e 20 77 69 6e 64 6f 77   {.  # On window
4320: 73 2c 20 73 6f 6d 65 74 69 6d 65 73 20 65 76 65  s, sometimes eve
4330: 6e 20 61 20 5b 66 69 6c 65 20 64 65 6c 65 74 65  n a [file delete
4340: 20 2d 66 6f 72 63 65 5d 20 63 61 6e 20 66 61 69   -force] can fai
4350: 6c 20 6a 75 73 74 20 61 66 74 65 72 0a 20 20 23  l just after.  #
4360: 20 61 20 66 69 6c 65 20 69 73 20 63 6c 6f 73 65   a file is close
4370: 64 2e 20 54 68 65 20 63 61 75 73 65 20 69 73 20  d. The cause is 
4380: 75 73 75 61 6c 6c 79 20 22 74 61 67 2d 61 6c 6f  usually "tag-alo
4390: 6e 67 73 22 20 2d 20 70 72 6f 67 72 61 6d 73 20  ngs" - programs 
43a0: 6c 69 6b 65 0a 20 20 23 20 61 6e 74 69 2d 76 69  like.  # anti-vi
43b0: 72 75 73 20 73 6f 66 74 77 61 72 65 2c 20 61 75  rus software, au
43c0: 74 6f 6d 61 74 69 63 20 62 61 63 6b 75 70 20 74  tomatic backup t
43d0: 6f 6f 6c 73 20 61 6e 64 20 76 61 72 69 6f 75 73  ools and various
43e0: 20 65 78 70 6c 6f 72 65 72 0a 20 20 23 20 65 78   explorer.  # ex
43f0: 74 65 6e 73 69 6f 6e 73 20 74 68 61 74 20 6b 65  tensions that ke
4400: 65 70 20 61 20 66 69 6c 65 20 6f 70 65 6e 20 61  ep a file open a
4410: 20 6c 69 74 74 6c 65 20 6c 6f 6e 67 65 72 20 74   little longer t
4420: 68 61 6e 20 77 65 20 65 78 70 65 63 74 2c 20 63  han we expect, c
4430: 61 75 73 69 6e 67 0a 20 20 23 20 74 68 65 20 64  ausing.  # the d
4440: 65 6c 65 74 65 20 74 6f 20 66 61 69 6c 2e 0a 20  elete to fail.. 
4450: 20 23 0a 20 20 23 20 54 68 65 20 73 6f 6c 75 74   #.  # The solut
4460: 69 6f 6e 20 69 73 20 74 6f 20 77 61 69 74 20 61  ion is to wait a
4470: 20 73 68 6f 72 74 20 61 6d 6f 75 6e 74 20 6f 66   short amount of
4480: 20 74 69 6d 65 20 62 65 66 6f 72 65 20 72 65 74   time before ret
4490: 72 79 69 6e 67 20 74 68 65 20 64 65 6c 65 74 65  rying the delete
44a0: 2e 0a 20 20 23 0a 20 20 73 65 74 20 6e 52 65 74  ..  #.  set nRet
44b0: 72 79 20 20 35 30 20 20 20 20 20 20 20 20 20 20  ry  50          
44c0: 20 20 20 20 20 20 20 20 3b 23 20 4d 61 78 69 6d          ;# Maxim
44d0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 74  um number of ret
44e0: 72 69 65 73 2e 0a 20 20 73 65 74 20 6e 44 65 6c  ries..  set nDel
44f0: 61 79 20 31 30 30 20 20 20 20 20 20 20 20 20 20  ay 100          
4500: 20 20 20 20 20 20 20 20 3b 23 20 44 65 6c 61 79          ;# Delay
4510: 20 69 6e 20 6d 73 20 62 65 66 6f 72 65 20 72 65   in ms before re
4520: 74 72 79 69 6e 67 2e 0a 20 20 73 65 74 20 72 63  trying..  set rc
4530: 20 31 0a 20 20 66 6f 72 20 7b 73 65 74 20 69 20   1.  for {set i 
4540: 30 7d 20 7b 24 69 3c 24 6e 52 65 74 72 79 20 26  0} {$i<$nRetry &
4550: 26 20 24 72 63 7d 20 7b 69 6e 63 72 20 69 7d 20  & $rc} {incr i} 
4560: 7b 0a 20 20 20 20 73 65 74 20 72 63 20 5b 63 61  {.    set rc [ca
4570: 74 63 68 20 7b 66 69 6c 65 20 64 65 6c 65 74 65  tch {file delete
4580: 20 2d 66 6f 72 63 65 20 24 66 69 6c 65 6e 61 6d   -force $filenam
4590: 65 7d 20 6d 73 67 5d 0a 20 20 7d 0a 20 20 69 66  e} msg].  }.  if
45a0: 20 7b 24 72 63 7d 20 7b 20 65 72 72 6f 72 20 24   {$rc} { error $
45b0: 6d 73 67 20 7d 0a 7d 0a 0a 23 20 44 6f 20 61 6e  msg }.}..# Do an
45c0: 20 69 6e 74 65 67 72 69 74 79 20 63 68 65 63 6b   integrity check
45d0: 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20 64   of the entire d
45e0: 61 74 61 62 61 73 65 0a 23 0a 70 72 6f 63 20 69  atabase.#.proc i
45f0: 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b 20 7b  ntegrity_check {
4600: 6e 61 6d 65 20 7b 64 62 20 64 62 7d 7d 20 7b 0a  name {db db}} {.
4610: 20 20 69 66 63 61 70 61 62 6c 65 20 69 6e 74 65    ifcapable inte
4620: 67 72 69 74 79 63 6b 20 7b 0a 20 20 20 20 64 6f  grityck {.    do
4630: 5f 74 65 73 74 20 24 6e 61 6d 65 20 5b 6c 69 73  _test $name [lis
4640: 74 20 65 78 65 63 73 71 6c 20 7b 50 52 41 47 4d  t execsql {PRAGM
4650: 41 20 69 6e 74 65 67 72 69 74 79 5f 63 68 65 63  A integrity_chec
4660: 6b 7d 20 24 64 62 5d 20 7b 6f 6b 7d 0a 20 20 7d  k} $db] {ok}.  }
4670: 0a 7d 0a 0a 70 72 6f 63 20 66 69 78 5f 69 66 63  .}..proc fix_ifc
4680: 61 70 61 62 6c 65 5f 65 78 70 72 20 7b 65 78 70  apable_expr {exp
4690: 72 7d 20 7b 0a 20 20 73 65 74 20 72 65 74 20 22  r} {.  set ret "
46a0: 22 0a 20 20 73 65 74 20 73 74 61 74 65 20 30 0a  ".  set state 0.
46b0: 20 20 66 6f 72 20 7b 73 65 74 20 69 20 30 7d 20    for {set i 0} 
46c0: 7b 24 69 20 3c 20 5b 73 74 72 69 6e 67 20 6c 65  {$i < [string le
46d0: 6e 67 74 68 20 24 65 78 70 72 5d 7d 20 7b 69 6e  ngth $expr]} {in
46e0: 63 72 20 69 7d 20 7b 0a 20 20 20 20 73 65 74 20  cr i} {.    set 
46f0: 63 68 61 72 20 5b 73 74 72 69 6e 67 20 72 61 6e  char [string ran
4700: 67 65 20 24 65 78 70 72 20 24 69 20 24 69 5d 0a  ge $expr $i $i].
4710: 20 20 20 20 73 65 74 20 6e 65 77 73 74 61 74 65      set newstate
4720: 20 5b 65 78 70 72 20 7b 5b 73 74 72 69 6e 67 20   [expr {[string 
4730: 69 73 20 61 6c 6e 75 6d 20 24 63 68 61 72 5d 20  is alnum $char] 
4740: 7c 7c 20 24 63 68 61 72 20 65 71 20 22 5f 22 7d  || $char eq "_"}
4750: 5d 0a 20 20 20 20 69 66 20 7b 24 6e 65 77 73 74  ].    if {$newst
4760: 61 74 65 20 26 26 20 21 24 73 74 61 74 65 7d 20  ate && !$state} 
4770: 7b 0a 20 20 20 20 20 20 61 70 70 65 6e 64 20 72  {.      append r
4780: 65 74 20 7b 24 3a 3a 73 71 6c 69 74 65 5f 6f 70  et {$::sqlite_op
4790: 74 69 6f 6e 73 28 7d 0a 20 20 20 20 7d 0a 20 20  tions(}.    }.  
47a0: 20 20 69 66 20 7b 21 24 6e 65 77 73 74 61 74 65    if {!$newstate
47b0: 20 26 26 20 24 73 74 61 74 65 7d 20 7b 0a 20 20   && $state} {.  
47c0: 20 20 20 20 61 70 70 65 6e 64 20 72 65 74 20 29      append ret )
47d0: 0a 20 20 20 20 7d 0a 20 20 20 20 61 70 70 65 6e  .    }.    appen
47e0: 64 20 72 65 74 20 24 63 68 61 72 0a 20 20 20 20  d ret $char.    
47f0: 73 65 74 20 73 74 61 74 65 20 24 6e 65 77 73 74  set state $newst
4800: 61 74 65 0a 20 20 7d 0a 20 20 69 66 20 7b 24 73  ate.  }.  if {$s
4810: 74 61 74 65 7d 20 7b 61 70 70 65 6e 64 20 72 65  tate} {append re
4820: 74 20 29 7d 0a 20 20 72 65 74 75 72 6e 20 24 72  t )}.  return $r
4830: 65 74 0a 7d 0a 0a 23 20 45 76 61 6c 75 61 74 65  et.}..# Evaluate
4840: 20 61 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72 65   a boolean expre
4850: 73 73 69 6f 6e 20 6f 66 20 63 61 70 61 62 69 6c  ssion of capabil
4860: 69 74 69 65 73 2e 20 20 49 66 20 74 72 75 65 2c  ities.  If true,
4870: 20 65 78 65 63 75 74 65 20 74 68 65 0a 23 20 63   execute the.# c
4880: 6f 64 65 2e 20 20 4f 6d 69 74 20 74 68 65 20 63  ode.  Omit the c
4890: 6f 64 65 20 69 66 20 66 61 6c 73 65 2e 0a 23 0a  ode if false..#.
48a0: 70 72 6f 63 20 69 66 63 61 70 61 62 6c 65 20 7b  proc ifcapable {
48b0: 65 78 70 72 20 63 6f 64 65 20 7b 65 6c 73 65 20  expr code {else 
48c0: 22 22 7d 20 7b 65 6c 73 65 63 6f 64 65 20 22 22  ""} {elsecode ""
48d0: 7d 7d 20 7b 0a 20 20 23 72 65 67 73 75 62 20 2d  }} {.  #regsub -
48e0: 61 6c 6c 20 7b 5b 61 2d 7a 5f 30 2d 39 5d 2b 7d  all {[a-z_0-9]+}
48f0: 20 24 65 78 70 72 20 7b 24 3a 3a 73 71 6c 69 74   $expr {$::sqlit
4900: 65 5f 6f 70 74 69 6f 6e 73 28 26 29 7d 20 65 32  e_options(&)} e2
4910: 0a 20 20 73 65 74 20 65 32 20 5b 66 69 78 5f 69  .  set e2 [fix_i
4920: 66 63 61 70 61 62 6c 65 5f 65 78 70 72 20 24 65  fcapable_expr $e
4930: 78 70 72 5d 0a 20 20 69 66 20 28 24 65 32 29 20  xpr].  if ($e2) 
4940: 7b 0a 20 20 20 20 73 65 74 20 63 20 5b 63 61 74  {.    set c [cat
4950: 63 68 20 7b 75 70 6c 65 76 65 6c 20 31 20 24 63  ch {uplevel 1 $c
4960: 6f 64 65 7d 20 72 5d 0a 20 20 7d 20 65 6c 73 65  ode} r].  } else
4970: 20 7b 0a 20 20 20 20 73 65 74 20 63 20 5b 63 61   {.    set c [ca
4980: 74 63 68 20 7b 75 70 6c 65 76 65 6c 20 31 20 24  tch {uplevel 1 $
4990: 65 6c 73 65 63 6f 64 65 7d 20 72 5d 0a 20 20 7d  elsecode} r].  }
49a0: 0a 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20  .  return -code 
49b0: 24 63 20 24 72 0a 7d 0a 0a 23 20 54 68 69 73 20  $c $r.}..# This 
49c0: 70 72 6f 63 20 65 78 65 63 73 20 61 20 73 65 70  proc execs a sep
49d0: 65 72 61 74 65 20 70 72 6f 63 65 73 73 20 74 68  erate process th
49e0: 61 74 20 63 72 61 73 68 65 73 20 6d 69 64 77 61  at crashes midwa
49f0: 79 20 74 68 72 6f 75 67 68 20 65 78 65 63 75 74  y through execut
4a00: 69 6e 67 0a 23 20 74 68 65 20 53 51 4c 20 73 63  ing.# the SQL sc
4a10: 72 69 70 74 20 24 73 71 6c 20 6f 6e 20 64 61 74  ript $sql on dat
4a20: 61 62 61 73 65 20 74 65 73 74 2e 64 62 2e 0a 23  abase test.db..#
4a30: 0a 23 20 54 68 65 20 63 72 61 73 68 20 6f 63 63  .# The crash occ
4a40: 75 72 73 20 64 75 72 69 6e 67 20 61 20 73 79 6e  urs during a syn
4a50: 63 28 29 20 6f 66 20 66 69 6c 65 20 24 63 72 61  c() of file $cra
4a60: 73 68 66 69 6c 65 2e 20 57 68 65 6e 20 74 68 65  shfile. When the
4a70: 20 63 72 61 73 68 0a 23 20 6f 63 63 75 72 73 20   crash.# occurs 
4a80: 61 20 72 61 6e 64 6f 6d 20 73 75 62 73 65 74 20  a random subset 
4a90: 6f 66 20 61 6c 6c 20 75 6e 73 79 6e 63 65 64 20  of all unsynced 
4aa0: 77 72 69 74 65 73 20 6d 61 64 65 20 62 79 20 74  writes made by t
4ab0: 68 65 20 70 72 6f 63 65 73 73 20 61 72 65 0a 23  he process are.#
4ac0: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68   written into th
4ad0: 65 20 66 69 6c 65 73 20 6f 6e 20 64 69 73 6b 2e  e files on disk.
4ae0: 20 41 72 67 75 6d 65 6e 74 20 24 63 72 61 73 68   Argument $crash
4af0: 64 65 6c 61 79 20 69 6e 64 69 63 61 74 65 73 20  delay indicates 
4b00: 74 68 65 0a 23 20 6e 75 6d 62 65 72 20 6f 66 20  the.# number of 
4b10: 66 69 6c 65 20 73 79 6e 63 73 20 74 6f 20 77 61  file syncs to wa
4b20: 69 74 20 62 65 66 6f 72 65 20 63 72 61 73 68 69  it before crashi
4b30: 6e 67 2e 0a 23 0a 23 20 54 68 65 20 72 65 74 75  ng..#.# The retu
4b40: 72 6e 20 76 61 6c 75 65 20 69 73 20 61 20 6c 69  rn value is a li
4b50: 73 74 20 6f 66 20 74 77 6f 20 65 6c 65 6d 65 6e  st of two elemen
4b60: 74 73 2e 20 54 68 65 20 66 69 72 73 74 20 65 6c  ts. The first el
4b70: 65 6d 65 6e 74 20 69 73 20 61 0a 23 20 62 6f 6f  ement is a.# boo
4b80: 6c 65 61 6e 2c 20 69 6e 64 69 63 61 74 69 6e 67  lean, indicating
4b90: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
4ba0: 74 68 65 20 70 72 6f 63 65 73 73 20 61 63 74 75  the process actu
4bb0: 61 6c 6c 79 20 63 72 61 73 68 65 64 20 6f 72 0a  ally crashed or.
4bc0: 23 20 72 65 70 6f 72 74 65 64 20 73 6f 6d 65 20  # reported some 
4bd0: 6f 74 68 65 72 20 65 72 72 6f 72 2e 20 54 68 65  other error. The
4be0: 20 73 65 63 6f 6e 64 20 65 6c 65 6d 65 6e 74 20   second element 
4bf0: 69 6e 20 74 68 65 20 72 65 74 75 72 6e 65 64 20  in the returned 
4c00: 6c 69 73 74 20 69 73 20 74 68 65 0a 23 20 65 72  list is the.# er
4c10: 72 6f 72 20 6d 65 73 73 61 67 65 2e 20 54 68 69  ror message. Thi
4c20: 73 20 69 73 20 22 63 68 69 6c 64 20 70 72 6f 63  s is "child proc
4c30: 65 73 73 20 65 78 69 74 65 64 20 61 62 6e 6f 72  ess exited abnor
4c40: 6d 61 6c 6c 79 22 20 69 66 20 74 68 65 20 63 72  mally" if the cr
4c50: 61 73 68 0a 23 20 6f 63 63 75 72 65 64 2e 0a 23  ash.# occured..#
4c60: 0a 23 20 20 20 63 72 61 73 68 73 71 6c 20 2d 64  .#   crashsql -d
4c70: 65 6c 61 79 20 43 52 41 53 48 44 45 4c 41 59 20  elay CRASHDELAY 
4c80: 2d 66 69 6c 65 20 43 52 41 53 48 46 49 4c 45 20  -file CRASHFILE 
4c90: 3f 2d 62 6c 6f 63 6b 73 69 7a 65 20 42 4c 4f 43  ?-blocksize BLOC
4ca0: 4b 53 49 5a 45 3f 20 24 73 71 6c 0a 23 0a 70 72  KSIZE? $sql.#.pr
4cb0: 6f 63 20 63 72 61 73 68 73 71 6c 20 7b 61 72 67  oc crashsql {arg
4cc0: 73 7d 20 7b 0a 0a 20 20 73 65 74 20 62 6c 6f 63  s} {..  set bloc
4cd0: 6b 73 69 7a 65 20 22 22 0a 20 20 73 65 74 20 63  ksize "".  set c
4ce0: 72 61 73 68 64 65 6c 61 79 20 31 0a 20 20 73 65  rashdelay 1.  se
4cf0: 74 20 70 72 6e 67 73 65 65 64 20 30 0a 20 20 73  t prngseed 0.  s
4d00: 65 74 20 74 63 6c 62 6f 64 79 20 7b 7d 0a 20 20  et tclbody {}.  
4d10: 73 65 74 20 63 72 61 73 68 66 69 6c 65 20 22 22  set crashfile ""
4d20: 0a 20 20 73 65 74 20 64 63 20 22 22 0a 20 20 73  .  set dc "".  s
4d30: 65 74 20 73 71 6c 20 5b 6c 69 6e 64 65 78 20 24  et sql [lindex $
4d40: 61 72 67 73 20 65 6e 64 5d 0a 20 20 0a 20 20 66  args end].  .  f
4d50: 6f 72 20 7b 73 65 74 20 69 69 20 30 7d 20 7b 24  or {set ii 0} {$
4d60: 69 69 20 3c 20 5b 6c 6c 65 6e 67 74 68 20 24 61  ii < [llength $a
4d70: 72 67 73 5d 2d 31 7d 20 7b 69 6e 63 72 20 69 69  rgs]-1} {incr ii
4d80: 20 32 7d 20 7b 0a 20 20 20 20 73 65 74 20 7a 20   2} {.    set z 
4d90: 5b 6c 69 6e 64 65 78 20 24 61 72 67 73 20 24 69  [lindex $args $i
4da0: 69 5d 0a 20 20 20 20 73 65 74 20 6e 20 5b 73 74  i].    set n [st
4db0: 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 7a 5d 0a  ring length $z].
4dc0: 20 20 20 20 73 65 74 20 7a 32 20 5b 6c 69 6e 64      set z2 [lind
4dd0: 65 78 20 24 61 72 67 73 20 5b 65 78 70 72 20 24  ex $args [expr $
4de0: 69 69 2b 31 5d 5d 0a 0a 20 20 20 20 69 66 20 20  ii+1]]..    if  
4df0: 20 20 20 7b 24 6e 3e 31 20 26 26 20 5b 73 74 72     {$n>1 && [str
4e00: 69 6e 67 20 66 69 72 73 74 20 24 7a 20 2d 64 65  ing first $z -de
4e10: 6c 61 79 5d 3d 3d 30 7d 20 20 20 20 20 7b 73 65  lay]==0}     {se
4e20: 74 20 63 72 61 73 68 64 65 6c 61 79 20 24 7a 32  t crashdelay $z2
4e30: 7d 20 5c 0a 20 20 20 20 65 6c 73 65 69 66 20 7b  } \.    elseif {
4e40: 24 6e 3e 31 20 26 26 20 5b 73 74 72 69 6e 67 20  $n>1 && [string 
4e50: 66 69 72 73 74 20 24 7a 20 2d 73 65 65 64 5d 3d  first $z -seed]=
4e60: 3d 30 7d 20 20 20 20 20 20 7b 73 65 74 20 70 72  =0}      {set pr
4e70: 6e 67 73 65 65 64 20 24 7a 32 7d 20 5c 0a 20 20  ngseed $z2} \.  
4e80: 20 20 65 6c 73 65 69 66 20 7b 24 6e 3e 31 20 26    elseif {$n>1 &
4e90: 26 20 5b 73 74 72 69 6e 67 20 66 69 72 73 74 20  & [string first 
4ea0: 24 7a 20 2d 66 69 6c 65 5d 3d 3d 30 7d 20 20 20  $z -file]==0}   
4eb0: 20 20 20 7b 73 65 74 20 63 72 61 73 68 66 69 6c     {set crashfil
4ec0: 65 20 24 7a 32 7d 20 20 5c 0a 20 20 20 20 65 6c  e $z2}  \.    el
4ed0: 73 65 69 66 20 7b 24 6e 3e 31 20 26 26 20 5b 73  seif {$n>1 && [s
4ee0: 74 72 69 6e 67 20 66 69 72 73 74 20 24 7a 20 2d  tring first $z -
4ef0: 74 63 6c 62 6f 64 79 5d 3d 3d 30 7d 20 20 20 7b  tclbody]==0}   {
4f00: 73 65 74 20 74 63 6c 62 6f 64 79 20 24 7a 32 7d  set tclbody $z2}
4f10: 20 20 5c 0a 20 20 20 20 65 6c 73 65 69 66 20 7b    \.    elseif {
4f20: 24 6e 3e 31 20 26 26 20 5b 73 74 72 69 6e 67 20  $n>1 && [string 
4f30: 66 69 72 73 74 20 24 7a 20 2d 62 6c 6f 63 6b 73  first $z -blocks
4f40: 69 7a 65 5d 3d 3d 30 7d 20 7b 73 65 74 20 62 6c  ize]==0} {set bl
4f50: 6f 63 6b 73 69 7a 65 20 22 2d 73 20 24 7a 32 22  ocksize "-s $z2"
4f60: 20 7d 20 5c 0a 20 20 20 20 65 6c 73 65 69 66 20   } \.    elseif 
4f70: 7b 24 6e 3e 31 20 26 26 20 5b 73 74 72 69 6e 67  {$n>1 && [string
4f80: 20 66 69 72 73 74 20 24 7a 20 2d 63 68 61 72 61   first $z -chara
4f90: 63 74 65 72 69 73 74 69 63 73 5d 3d 3d 30 7d 20  cteristics]==0} 
4fa0: 7b 73 65 74 20 64 63 20 22 2d 63 20 7b 24 7a 32  {set dc "-c {$z2
4fb0: 7d 22 20 7d 20 5c 0a 20 20 20 20 65 6c 73 65 20  }" } \.    else 
4fc0: 20 20 7b 20 65 72 72 6f 72 20 22 55 6e 72 65 63    { error "Unrec
4fd0: 6f 67 6e 69 7a 65 64 20 6f 70 74 69 6f 6e 3a 20  ognized option: 
4fe0: 24 7a 22 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 20  $z" }.  }..  if 
4ff0: 7b 24 63 72 61 73 68 66 69 6c 65 20 65 71 20 22  {$crashfile eq "
5000: 22 7d 20 7b 0a 20 20 20 20 65 72 72 6f 72 20 22  "} {.    error "
5010: 43 6f 6d 70 75 6c 73 6f 72 79 20 6f 70 74 69 6f  Compulsory optio
5020: 6e 20 2d 66 69 6c 65 20 6d 69 73 73 69 6e 67 22  n -file missing"
5030: 0a 20 20 7d 0a 0a 20 20 23 20 24 63 72 61 73 68  .  }..  # $crash
5040: 66 69 6c 65 20 67 65 74 73 20 63 6f 6d 70 61 72  file gets compar
5050: 65 64 20 74 6f 20 74 68 65 20 6e 61 74 69 76 65  ed to the native
5060: 20 66 69 6c 65 6e 61 6d 65 20 69 6e 20 0a 20 20   filename in .  
5070: 23 20 63 66 53 79 6e 63 28 29 2c 20 77 68 69 63  # cfSync(), whic
5080: 68 20 63 61 6e 20 62 65 20 64 69 66 66 65 72 65  h can be differe
5090: 6e 74 20 74 68 65 6e 20 77 68 61 74 20 54 43 4c  nt then what TCL
50a0: 20 75 73 65 73 20 62 79 0a 20 20 23 20 64 65 66   uses by.  # def
50b0: 61 75 6c 74 2c 20 73 6f 20 68 65 72 65 20 77 65  ault, so here we
50c0: 20 66 6f 72 63 65 20 69 74 20 74 6f 20 74 68 65   force it to the
50d0: 20 22 6e 61 74 69 76 65 6e 61 6d 65 22 20 66 6f   "nativename" fo
50e0: 72 6d 61 74 2e 0a 20 20 73 65 74 20 63 66 69 6c  rmat..  set cfil
50f0: 65 20 5b 73 74 72 69 6e 67 20 6d 61 70 20 7b 5c  e [string map {\
5100: 5c 20 5c 5c 5c 5c 7d 20 5b 66 69 6c 65 20 6e 61  \ \\\\} [file na
5110: 74 69 76 65 6e 61 6d 65 20 5b 66 69 6c 65 20 6a  tivename [file j
5120: 6f 69 6e 20 5b 70 77 64 5d 20 24 63 72 61 73 68  oin [pwd] $crash
5130: 66 69 6c 65 5d 5d 5d 0a 0a 20 20 73 65 74 20 66  file]]]..  set f
5140: 20 5b 6f 70 65 6e 20 63 72 61 73 68 2e 74 63 6c   [open crash.tcl
5150: 20 77 5d 0a 20 20 70 75 74 73 20 24 66 20 22 73   w].  puts $f "s
5160: 71 6c 69 74 65 33 5f 63 72 61 73 68 5f 65 6e 61  qlite3_crash_ena
5170: 62 6c 65 20 31 22 0a 20 20 70 75 74 73 20 24 66  ble 1".  puts $f
5180: 20 22 73 71 6c 69 74 65 33 5f 63 72 61 73 68 70   "sqlite3_crashp
5190: 61 72 61 6d 73 20 24 62 6c 6f 63 6b 73 69 7a 65  arams $blocksize
51a0: 20 24 64 63 20 24 63 72 61 73 68 64 65 6c 61 79   $dc $crashdelay
51b0: 20 24 63 66 69 6c 65 22 0a 20 20 70 75 74 73 20   $cfile".  puts 
51c0: 24 66 20 22 73 71 6c 69 74 65 33 5f 74 65 73 74  $f "sqlite3_test
51d0: 5f 63 6f 6e 74 72 6f 6c 5f 70 65 6e 64 69 6e 67  _control_pending
51e0: 5f 62 79 74 65 20 24 3a 3a 73 71 6c 69 74 65 5f  _byte $::sqlite_
51f0: 70 65 6e 64 69 6e 67 5f 62 79 74 65 22 0a 20 20  pending_byte".  
5200: 70 75 74 73 20 24 66 20 22 73 71 6c 69 74 65 33  puts $f "sqlite3
5210: 20 64 62 20 74 65 73 74 2e 64 62 20 2d 76 66 73   db test.db -vfs
5220: 20 63 72 61 73 68 22 0a 0a 20 20 23 20 54 68 69   crash"..  # Thi
5230: 73 20 62 6c 6f 63 6b 20 73 65 74 73 20 74 68 65  s block sets the
5240: 20 63 61 63 68 65 20 73 69 7a 65 20 6f 66 20 74   cache size of t
5250: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
5260: 20 74 6f 20 31 30 0a 20 20 23 20 70 61 67 65 73   to 10.  # pages
5270: 2e 20 54 68 69 73 20 69 73 20 64 6f 6e 65 20 69  . This is done i
5280: 6e 20 63 61 73 65 20 74 68 65 20 62 75 69 6c 64  n case the build
5290: 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74   is configured t
52a0: 6f 20 6f 6d 69 74 0a 20 20 23 20 22 50 52 41 47  o omit.  # "PRAG
52b0: 4d 41 20 63 61 63 68 65 5f 73 69 7a 65 22 2e 0a  MA cache_size"..
52c0: 20 20 70 75 74 73 20 24 66 20 7b 64 62 20 65 76    puts $f {db ev
52d0: 61 6c 20 7b 53 45 4c 45 43 54 20 2a 20 46 52 4f  al {SELECT * FRO
52e0: 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3b  M sqlite_master;
52f0: 7d 7d 0a 20 20 70 75 74 73 20 24 66 20 7b 73 65  }}.  puts $f {se
5300: 74 20 62 74 20 5b 62 74 72 65 65 5f 66 72 6f 6d  t bt [btree_from
5310: 5f 64 62 20 64 62 5d 7d 0a 20 20 70 75 74 73 20  _db db]}.  puts 
5320: 24 66 20 7b 62 74 72 65 65 5f 73 65 74 5f 63 61  $f {btree_set_ca
5330: 63 68 65 5f 73 69 7a 65 20 24 62 74 20 31 30 7d  che_size $bt 10}
5340: 0a 20 20 69 66 20 7b 24 70 72 6e 67 73 65 65 64  .  if {$prngseed
5350: 7d 20 7b 0a 20 20 20 20 73 65 74 20 73 65 65 64  } {.    set seed
5360: 20 5b 65 78 70 72 20 7b 24 70 72 6e 67 73 65 65   [expr {$prngsee
5370: 64 25 31 30 30 30 37 2b 31 7d 5d 0a 20 20 20 20  d%10007+1}].    
5380: 23 20 70 75 74 73 20 73 65 65 64 3d 24 73 65 65  # puts seed=$see
5390: 64 0a 20 20 20 20 70 75 74 73 20 24 66 20 22 64  d.    puts $f "d
53a0: 62 20 65 76 61 6c 20 7b 53 45 4c 45 43 54 20 72  b eval {SELECT r
53b0: 61 6e 64 6f 6d 62 6c 6f 62 28 24 73 65 65 64 29  andomblob($seed)
53c0: 7d 22 0a 20 20 7d 0a 0a 20 20 69 66 20 7b 5b 73  }".  }..  if {[s
53d0: 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 74 63  tring length $tc
53e0: 6c 62 6f 64 79 5d 3e 30 7d 20 7b 0a 20 20 20 20  lbody]>0} {.    
53f0: 70 75 74 73 20 24 66 20 24 74 63 6c 62 6f 64 79  puts $f $tclbody
5400: 0a 20 20 7d 0a 20 20 69 66 20 7b 5b 73 74 72 69  .  }.  if {[stri
5410: 6e 67 20 6c 65 6e 67 74 68 20 24 73 71 6c 5d 3e  ng length $sql]>
5420: 30 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 24 66  0} {.    puts $f
5430: 20 22 64 62 20 65 76 61 6c 20 7b 22 0a 20 20 20   "db eval {".   
5440: 20 70 75 74 73 20 24 66 20 20 20 22 24 73 71 6c   puts $f   "$sql
5450: 22 0a 20 20 20 20 70 75 74 73 20 24 66 20 22 7d  ".    puts $f "}
5460: 22 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 20 24 66  ".  }.  close $f
5470: 0a 20 20 73 65 74 20 72 20 5b 63 61 74 63 68 20  .  set r [catch 
5480: 7b 0a 20 20 20 20 65 78 65 63 20 5b 69 6e 66 6f  {.    exec [info
5490: 20 6e 61 6d 65 6f 66 65 78 65 63 5d 20 63 72 61   nameofexec] cra
54a0: 73 68 2e 74 63 6c 20 3e 40 73 74 64 6f 75 74 0a  sh.tcl >@stdout.
54b0: 20 20 7d 20 6d 73 67 5d 0a 20 20 0a 20 20 23 20    } msg].  .  # 
54c0: 57 69 6e 64 6f 77 73 2f 41 63 74 69 76 65 53 74  Windows/ActiveSt
54d0: 61 74 65 20 54 43 4c 20 72 65 74 75 72 6e 73 20  ate TCL returns 
54e0: 61 20 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65  a slightly diffe
54f0: 72 65 6e 74 0a 20 20 23 20 65 72 72 6f 72 20 6d  rent.  # error m
5500: 65 73 73 61 67 65 2e 20 20 57 65 20 6d 61 70 20  essage.  We map 
5510: 74 68 61 74 20 74 6f 20 74 68 65 20 65 78 70 65  that to the expe
5520: 63 74 65 64 20 6d 65 73 73 61 67 65 0a 20 20 23  cted message.  #
5530: 20 73 6f 20 74 68 61 74 20 77 65 20 64 6f 6e 27   so that we don'
5540: 74 20 68 61 76 65 20 74 6f 20 63 68 61 6e 67 65  t have to change
5550: 20 61 6c 6c 20 6f 66 20 74 68 65 20 74 65 73 74   all of the test
5560: 0a 20 20 23 20 63 61 73 65 73 2e 0a 20 20 69 66  .  # cases..  if
5570: 20 7b 24 3a 3a 74 63 6c 5f 70 6c 61 74 66 6f 72   {$::tcl_platfor
5580: 6d 28 70 6c 61 74 66 6f 72 6d 29 3d 3d 22 77 69  m(platform)=="wi
5590: 6e 64 6f 77 73 22 7d 20 7b 0a 20 20 20 20 69 66  ndows"} {.    if
55a0: 20 7b 24 6d 73 67 3d 3d 22 63 68 69 6c 64 20 6b   {$msg=="child k
55b0: 69 6c 6c 65 64 3a 20 75 6e 6b 6e 6f 77 6e 20 73  illed: unknown s
55c0: 69 67 6e 61 6c 22 7d 20 7b 0a 20 20 20 20 20 20  ignal"} {.      
55d0: 73 65 74 20 6d 73 67 20 22 63 68 69 6c 64 20 70  set msg "child p
55e0: 72 6f 63 65 73 73 20 65 78 69 74 65 64 20 61 62  rocess exited ab
55f0: 6e 6f 72 6d 61 6c 6c 79 22 0a 20 20 20 20 7d 0a  normally".    }.
5600: 20 20 7d 0a 20 20 0a 20 20 6c 61 70 70 65 6e 64    }.  .  lappend
5610: 20 72 20 24 6d 73 67 0a 7d 0a 0a 23 20 55 73 61   r $msg.}..# Usa
5620: 67 65 3a 20 64 6f 5f 69 6f 65 72 72 5f 74 65 73  ge: do_ioerr_tes
5630: 74 20 3c 74 65 73 74 20 6e 75 6d 62 65 72 3e 20  t <test number> 
5640: 3c 6f 70 74 69 6f 6e 73 2e 2e 2e 3e 0a 23 0a 23  <options...>.#.#
5650: 20 54 68 69 73 20 70 72 6f 63 20 69 73 20 75 73   This proc is us
5660: 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20  ed to implement 
5670: 74 65 73 74 20 63 61 73 65 73 20 74 68 61 74 20  test cases that 
5680: 63 68 65 63 6b 20 74 68 61 74 20 49 4f 20 65 72  check that IO er
5690: 72 6f 72 73 0a 23 20 61 72 65 20 63 6f 72 72 65  rors.# are corre
56a0: 63 74 6c 79 20 68 61 6e 64 6c 65 64 2e 20 54 68  ctly handled. Th
56b0: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
56c0: 2c 20 3c 74 65 73 74 20 6e 75 6d 62 65 72 3e 2c  , <test number>,
56d0: 20 69 73 20 61 6e 20 69 6e 74 65 67 65 72 20 0a   is an integer .
56e0: 23 20 75 73 65 64 20 74 6f 20 6e 61 6d 65 20 74  # used to name t
56f0: 68 65 20 74 65 73 74 73 20 65 78 65 63 75 74 65  he tests execute
5700: 64 20 62 79 20 74 68 69 73 20 70 72 6f 63 2e 20  d by this proc. 
5710: 4f 70 74 69 6f 6e 73 20 61 72 65 20 61 73 20 66  Options are as f
5720: 6f 6c 6c 6f 77 73 3a 0a 23 0a 23 20 20 20 20 20  ollows:.#.#     
5730: 2d 74 63 6c 70 72 65 70 20 20 20 20 20 20 20 20  -tclprep        
5740: 20 20 54 43 4c 20 73 63 72 69 70 74 20 74 6f 20    TCL script to 
5750: 72 75 6e 20 74 6f 20 70 72 65 70 61 72 65 20 74  run to prepare t
5760: 65 73 74 2e 0a 23 20 20 20 20 20 2d 73 71 6c 70  est..#     -sqlp
5770: 72 65 70 20 20 20 20 20 20 20 20 20 20 53 51 4c  rep          SQL
5780: 20 73 63 72 69 70 74 20 74 6f 20 72 75 6e 20 74   script to run t
5790: 6f 20 70 72 65 70 61 72 65 20 74 65 73 74 2e 0a  o prepare test..
57a0: 23 20 20 20 20 20 2d 74 63 6c 62 6f 64 79 20 20  #     -tclbody  
57b0: 20 20 20 20 20 20 20 20 54 43 4c 20 73 63 72 69          TCL scri
57c0: 70 74 20 74 6f 20 72 75 6e 20 77 69 74 68 20 49  pt to run with I
57d0: 4f 20 65 72 72 6f 72 20 73 69 6d 75 6c 61 74 69  O error simulati
57e0: 6f 6e 2e 0a 23 20 20 20 20 20 2d 73 71 6c 62 6f  on..#     -sqlbo
57f0: 64 79 20 20 20 20 20 20 20 20 20 20 54 43 4c 20  dy          TCL 
5800: 73 63 72 69 70 74 20 74 6f 20 72 75 6e 20 77 69  script to run wi
5810: 74 68 20 49 4f 20 65 72 72 6f 72 20 73 69 6d 75  th IO error simu
5820: 6c 61 74 69 6f 6e 2e 0a 23 20 20 20 20 20 2d 65  lation..#     -e
5830: 78 63 6c 75 64 65 20 20 20 20 20 20 20 20 20 20  xclude          
5840: 4c 69 73 74 20 6f 66 20 27 4e 27 20 76 61 6c 75  List of 'N' valu
5850: 65 73 20 6e 6f 74 20 74 6f 20 74 65 73 74 2e 0a  es not to test..
5860: 23 20 20 20 20 20 2d 65 72 63 20 20 20 20 20 20  #     -erc      
5870: 20 20 20 20 20 20 20 20 55 73 65 20 65 78 74 65          Use exte
5880: 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65  nded result code
5890: 73 0a 23 20 20 20 20 20 2d 70 65 72 73 69 73 74  s.#     -persist
58a0: 20 20 20 20 20 20 20 20 20 20 4d 61 6b 65 20 73            Make s
58b0: 69 6d 75 6c 61 74 65 64 20 49 2f 4f 20 65 72 72  imulated I/O err
58c0: 6f 72 73 20 70 65 72 73 69 73 74 65 6e 74 0a 23  ors persistent.#
58d0: 20 20 20 20 20 2d 73 74 61 72 74 20 20 20 20 20       -start     
58e0: 20 20 20 20 20 20 20 56 61 6c 75 65 20 6f 66 20         Value of 
58f0: 27 4e 27 20 74 6f 20 62 65 67 69 6e 20 77 69 74  'N' to begin wit
5900: 68 20 28 64 65 66 61 75 6c 74 20 31 29 0a 23 0a  h (default 1).#.
5910: 23 20 20 20 20 20 2d 63 6b 73 75 6d 20 20 20 20  #     -cksum    
5920: 20 20 20 20 20 20 20 20 42 6f 6f 6c 65 61 6e 2e          Boolean.
5930: 20 49 66 20 74 72 75 65 2c 20 74 65 73 74 20 74   If true, test t
5940: 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 65  hat the database
5950: 20 64 6f 65 73 0a 23 20 20 20 20 20 20 20 20 20   does.#         
5960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f                no
5970: 74 20 63 68 61 6e 67 65 20 64 75 72 69 6e 67 20  t change during 
5980: 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 66  the execution of
5990: 20 74 68 65 20 74 65 73 74 20 63 61 73 65 2e 0a   the test case..
59a0: 23 0a 70 72 6f 63 20 64 6f 5f 69 6f 65 72 72 5f  #.proc do_ioerr_
59b0: 74 65 73 74 20 7b 74 65 73 74 6e 61 6d 65 20 61  test {testname a
59c0: 72 67 73 7d 20 7b 0a 0a 20 20 73 65 74 20 3a 3a  rgs} {..  set ::
59d0: 69 6f 65 72 72 6f 70 74 73 28 2d 73 74 61 72 74  ioerropts(-start
59e0: 29 20 31 0a 20 20 73 65 74 20 3a 3a 69 6f 65 72  ) 1.  set ::ioer
59f0: 72 6f 70 74 73 28 2d 63 6b 73 75 6d 29 20 30 0a  ropts(-cksum) 0.
5a00: 20 20 73 65 74 20 3a 3a 69 6f 65 72 72 6f 70 74    set ::ioerropt
5a10: 73 28 2d 65 72 63 29 20 30 0a 20 20 73 65 74 20  s(-erc) 0.  set 
5a20: 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 63 6f 75  ::ioerropts(-cou
5a30: 6e 74 29 20 31 30 30 30 30 30 30 30 30 0a 20 20  nt) 100000000.  
5a40: 73 65 74 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28  set ::ioerropts(
5a50: 2d 70 65 72 73 69 73 74 29 20 31 0a 20 20 73 65  -persist) 1.  se
5a60: 74 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 63  t ::ioerropts(-c
5a70: 6b 72 65 66 63 6f 75 6e 74 29 20 30 0a 20 20 73  krefcount) 0.  s
5a80: 65 74 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d  et ::ioerropts(-
5a90: 72 65 73 74 6f 72 65 70 72 6e 67 29 20 31 0a 20  restoreprng) 1. 
5aa0: 20 61 72 72 61 79 20 73 65 74 20 3a 3a 69 6f 65   array set ::ioe
5ab0: 72 72 6f 70 74 73 20 24 61 72 67 73 0a 0a 20 20  rropts $args..  
5ac0: 23 20 54 45 4d 50 4f 52 41 52 59 3a 20 46 6f 72  # TEMPORARY: For
5ad0: 20 33 2e 35 2e 39 2c 20 64 69 73 61 62 6c 65 20   3.5.9, disable 
5ae0: 74 65 73 74 69 6e 67 20 6f 66 20 65 78 74 65 6e  testing of exten
5af0: 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 73  ded result codes
5b00: 2e 20 54 68 65 72 65 20 61 72 65 0a 20 20 23 20  . There are.  # 
5b10: 61 20 63 6f 75 70 6c 65 20 6f 66 20 6f 62 73 63  a couple of obsc
5b20: 75 72 65 20 49 4f 20 65 72 72 6f 72 73 20 74 68  ure IO errors th
5b30: 61 74 20 64 6f 20 6e 6f 74 20 72 65 74 75 72 6e  at do not return
5b40: 20 74 68 65 6d 2e 0a 20 20 73 65 74 20 3a 3a 69   them..  set ::i
5b50: 6f 65 72 72 6f 70 74 73 28 2d 65 72 63 29 20 30  oerropts(-erc) 0
5b60: 0a 0a 20 20 73 65 74 20 3a 3a 67 6f 20 31 0a 20  ..  set ::go 1. 
5b70: 20 23 72 65 73 65 74 5f 70 72 6e 67 5f 73 74 61   #reset_prng_sta
5b80: 74 65 0a 20 20 73 61 76 65 5f 70 72 6e 67 5f 73  te.  save_prng_s
5b90: 74 61 74 65 0a 20 20 66 6f 72 20 7b 73 65 74 20  tate.  for {set 
5ba0: 6e 20 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d  n $::ioerropts(-
5bb0: 73 74 61 72 74 29 7d 20 7b 24 3a 3a 67 6f 7d 20  start)} {$::go} 
5bc0: 7b 69 6e 63 72 20 6e 7d 20 7b 0a 20 20 20 20 73  {incr n} {.    s
5bd0: 65 74 20 3a 3a 54 4e 20 24 6e 0a 20 20 20 20 69  et ::TN $n.    i
5be0: 6e 63 72 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28  ncr ::ioerropts(
5bf0: 2d 63 6f 75 6e 74 29 20 2d 31 0a 20 20 20 20 69  -count) -1.    i
5c00: 66 20 7b 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28  f {$::ioerropts(
5c10: 2d 63 6f 75 6e 74 29 3c 30 7d 20 62 72 65 61 6b  -count)<0} break
5c20: 0a 20 0a 20 20 20 20 23 20 53 6b 69 70 20 74 68  . .    # Skip th
5c30: 69 73 20 49 4f 20 65 72 72 6f 72 20 69 66 20 69  is IO error if i
5c40: 74 20 77 61 73 20 73 70 65 63 69 66 69 65 64 20  t was specified 
5c50: 77 69 74 68 20 74 68 65 20 22 2d 65 78 63 6c 75  with the "-exclu
5c60: 64 65 22 20 6f 70 74 69 6f 6e 2e 0a 20 20 20 20  de" option..    
5c70: 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73  if {[info exists
5c80: 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 65 78   ::ioerropts(-ex
5c90: 63 6c 75 64 65 29 5d 7d 20 7b 0a 20 20 20 20 20  clude)]} {.     
5ca0: 20 69 66 20 7b 5b 6c 73 65 61 72 63 68 20 24 3a   if {[lsearch $:
5cb0: 3a 69 6f 65 72 72 6f 70 74 73 28 2d 65 78 63 6c  :ioerropts(-excl
5cc0: 75 64 65 29 20 24 6e 5d 21 3d 2d 31 7d 20 63 6f  ude) $n]!=-1} co
5cd0: 6e 74 69 6e 75 65 0a 20 20 20 20 7d 0a 20 20 20  ntinue.    }.   
5ce0: 20 69 66 20 7b 24 3a 3a 69 6f 65 72 72 6f 70 74   if {$::ioerropt
5cf0: 73 28 2d 72 65 73 74 6f 72 65 70 72 6e 67 29 7d  s(-restoreprng)}
5d00: 20 7b 0a 20 20 20 20 20 20 72 65 73 74 6f 72 65   {.      restore
5d10: 5f 70 72 6e 67 5f 73 74 61 74 65 0a 20 20 20 20  _prng_state.    
5d20: 7d 0a 0a 20 20 20 20 23 20 44 65 6c 65 74 65 20  }..    # Delete 
5d30: 74 68 65 20 66 69 6c 65 73 20 74 65 73 74 2e 64  the files test.d
5d40: 62 20 61 6e 64 20 74 65 73 74 32 2e 64 62 2c 20  b and test2.db, 
5d50: 74 68 65 6e 20 65 78 65 63 75 74 65 20 74 68 65  then execute the
5d60: 20 54 43 4c 20 61 6e 64 20 0a 20 20 20 20 23 20   TCL and .    # 
5d70: 53 51 4c 20 28 69 6e 20 74 68 61 74 20 6f 72 64  SQL (in that ord
5d80: 65 72 29 20 74 6f 20 70 72 65 70 61 72 65 20 66  er) to prepare f
5d90: 6f 72 20 74 68 65 20 74 65 73 74 20 63 61 73 65  or the test case
5da0: 2e 0a 20 20 20 20 64 6f 5f 74 65 73 74 20 24 74  ..    do_test $t
5db0: 65 73 74 6e 61 6d 65 2e 24 6e 2e 31 20 7b 0a 20  estname.$n.1 {. 
5dc0: 20 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74       set ::sqlit
5dd0: 65 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69  e_io_error_pendi
5de0: 6e 67 20 30 0a 20 20 20 20 20 20 63 61 74 63 68  ng 0.      catch
5df0: 20 7b 64 62 20 63 6c 6f 73 65 7d 0a 20 20 20 20   {db close}.    
5e00: 20 20 63 61 74 63 68 20 7b 64 62 32 20 63 6c 6f    catch {db2 clo
5e10: 73 65 7d 0a 20 20 20 20 20 20 63 61 74 63 68 20  se}.      catch 
5e20: 7b 66 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f  {file delete -fo
5e30: 72 63 65 20 74 65 73 74 2e 64 62 7d 0a 20 20 20  rce test.db}.   
5e40: 20 20 20 63 61 74 63 68 20 7b 66 69 6c 65 20 64     catch {file d
5e50: 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 74 65 73  elete -force tes
5e60: 74 2e 64 62 2d 6a 6f 75 72 6e 61 6c 7d 0a 20 20  t.db-journal}.  
5e70: 20 20 20 20 63 61 74 63 68 20 7b 66 69 6c 65 20      catch {file 
5e80: 64 65 6c 65 74 65 20 2d 66 6f 72 63 65 20 74 65  delete -force te
5e90: 73 74 32 2e 64 62 7d 0a 20 20 20 20 20 20 63 61  st2.db}.      ca
5ea0: 74 63 68 20 7b 66 69 6c 65 20 64 65 6c 65 74 65  tch {file delete
5eb0: 20 2d 66 6f 72 63 65 20 74 65 73 74 32 2e 64 62   -force test2.db
5ec0: 2d 6a 6f 75 72 6e 61 6c 7d 0a 20 20 20 20 20 20  -journal}.      
5ed0: 73 65 74 20 3a 3a 44 42 20 5b 73 71 6c 69 74 65  set ::DB [sqlite
5ee0: 33 20 64 62 20 74 65 73 74 2e 64 62 3b 20 73 71  3 db test.db; sq
5ef0: 6c 69 74 65 33 5f 63 6f 6e 6e 65 63 74 69 6f 6e  lite3_connection
5f00: 5f 70 6f 69 6e 74 65 72 20 64 62 5d 0a 20 20 20  _pointer db].   
5f10: 20 20 20 73 71 6c 69 74 65 33 5f 65 78 74 65 6e     sqlite3_exten
5f20: 64 65 64 5f 72 65 73 75 6c 74 5f 63 6f 64 65 73  ded_result_codes
5f30: 20 24 3a 3a 44 42 20 24 3a 3a 69 6f 65 72 72 6f   $::DB $::ioerro
5f40: 70 74 73 28 2d 65 72 63 29 0a 20 20 20 20 20 20  pts(-erc).      
5f50: 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73  if {[info exists
5f60: 20 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 74 63   ::ioerropts(-tc
5f70: 6c 70 72 65 70 29 5d 7d 20 7b 0a 20 20 20 20 20  lprep)]} {.     
5f80: 20 20 20 65 76 61 6c 20 24 3a 3a 69 6f 65 72 72     eval $::ioerr
5f90: 6f 70 74 73 28 2d 74 63 6c 70 72 65 70 29 0a 20  opts(-tclprep). 
5fa0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 20       }.      if 
5fb0: 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 3a 3a  {[info exists ::
5fc0: 69 6f 65 72 72 6f 70 74 73 28 2d 73 71 6c 70 72  ioerropts(-sqlpr
5fd0: 65 70 29 5d 7d 20 7b 0a 20 20 20 20 20 20 20 20  ep)]} {.        
5fe0: 65 78 65 63 73 71 6c 20 24 3a 3a 69 6f 65 72 72  execsql $::ioerr
5ff0: 6f 70 74 73 28 2d 73 71 6c 70 72 65 70 29 0a 20  opts(-sqlprep). 
6000: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 65 78 70       }.      exp
6010: 72 20 30 0a 20 20 20 20 7d 20 7b 30 7d 0a 0a 20  r 0.    } {0}.. 
6020: 20 20 20 23 20 52 65 61 64 20 74 68 65 20 27 63     # Read the 'c
6030: 68 65 63 6b 73 75 6d 27 20 6f 66 20 74 68 65 20  hecksum' of the 
6040: 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 69 66  database..    if
6050: 20 7b 24 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d   {$::ioerropts(-
6060: 63 6b 73 75 6d 29 7d 20 7b 0a 20 20 20 20 20 20  cksum)} {.      
6070: 73 65 74 20 63 68 65 63 6b 73 75 6d 20 5b 63 6b  set checksum [ck
6080: 73 75 6d 5d 0a 20 20 20 20 7d 0a 0a 20 20 20 20  sum].    }..    
6090: 23 20 53 65 74 20 74 68 65 20 4e 74 68 20 49 4f  # Set the Nth IO
60a0: 20 65 72 72 6f 72 20 74 6f 20 66 61 69 6c 2e 0a   error to fail..
60b0: 20 20 20 20 64 6f 5f 74 65 73 74 20 24 74 65 73      do_test $tes
60c0: 74 6e 61 6d 65 2e 24 6e 2e 32 20 5b 73 75 62 73  tname.$n.2 [subs
60d0: 74 20 7b 0a 20 20 20 20 20 20 73 65 74 20 3a 3a  t {.      set ::
60e0: 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f  sqlite_io_error_
60f0: 70 65 72 73 69 73 74 20 24 3a 3a 69 6f 65 72 72  persist $::ioerr
6100: 6f 70 74 73 28 2d 70 65 72 73 69 73 74 29 0a 20  opts(-persist). 
6110: 20 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74       set ::sqlit
6120: 65 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69  e_io_error_pendi
6130: 6e 67 20 24 6e 0a 20 20 20 20 7d 5d 20 24 6e 0a  ng $n.    }] $n.
6140: 20 20 0a 20 20 20 20 23 20 43 72 65 61 74 65 20    .    # Create 
6150: 61 20 73 69 6e 67 6c 65 20 54 43 4c 20 73 63 72  a single TCL scr
6160: 69 70 74 20 66 72 6f 6d 20 74 68 65 20 54 43 4c  ipt from the TCL
6170: 20 61 6e 64 20 53 51 4c 20 73 70 65 63 69 66 69   and SQL specifi
6180: 65 64 0a 20 20 20 20 23 20 61 73 20 74 68 65 20  ed.    # as the 
6190: 62 6f 64 79 20 6f 66 20 74 68 65 20 74 65 73 74  body of the test
61a0: 2e 0a 20 20 20 20 73 65 74 20 3a 3a 69 6f 65 72  ..    set ::ioer
61b0: 72 6f 72 62 6f 64 79 20 7b 7d 0a 20 20 20 20 69  rorbody {}.    i
61c0: 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20  f {[info exists 
61d0: 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 74 63 6c  ::ioerropts(-tcl
61e0: 62 6f 64 79 29 5d 7d 20 7b 0a 20 20 20 20 20 20  body)]} {.      
61f0: 61 70 70 65 6e 64 20 3a 3a 69 6f 65 72 72 6f 72  append ::ioerror
6200: 62 6f 64 79 20 22 24 3a 3a 69 6f 65 72 72 6f 70  body "$::ioerrop
6210: 74 73 28 2d 74 63 6c 62 6f 64 79 29 5c 6e 22 0a  ts(-tclbody)\n".
6220: 20 20 20 20 7d 0a 20 20 20 20 69 66 20 7b 5b 69      }.    if {[i
6230: 6e 66 6f 20 65 78 69 73 74 73 20 3a 3a 69 6f 65  nfo exists ::ioe
6240: 72 72 6f 70 74 73 28 2d 73 71 6c 62 6f 64 79 29  rropts(-sqlbody)
6250: 5d 7d 20 7b 0a 20 20 20 20 20 20 61 70 70 65 6e  ]} {.      appen
6260: 64 20 3a 3a 69 6f 65 72 72 6f 72 62 6f 64 79 20  d ::ioerrorbody 
6270: 22 64 62 20 65 76 61 6c 20 7b 24 3a 3a 69 6f 65  "db eval {$::ioe
6280: 72 72 6f 70 74 73 28 2d 73 71 6c 62 6f 64 79 29  rropts(-sqlbody)
6290: 7d 22 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20  }".    }..    # 
62a0: 45 78 65 63 75 74 65 20 74 68 65 20 54 43 4c 20  Execute the TCL 
62b0: 53 63 72 69 70 74 20 63 72 65 61 74 65 64 20 69  Script created i
62c0: 6e 20 74 68 65 20 61 62 6f 76 65 20 62 6c 6f 63  n the above bloc
62d0: 6b 2e 20 49 66 0a 20 20 20 20 23 20 74 68 65 72  k. If.    # ther
62e0: 65 20 61 72 65 20 61 74 20 6c 65 61 73 74 20 4e  e are at least N
62f0: 20 49 4f 20 6f 70 65 72 61 74 69 6f 6e 73 20 70   IO operations p
6300: 65 72 66 6f 72 6d 65 64 20 62 79 20 53 51 4c 69  erformed by SQLi
6310: 74 65 20 61 73 0a 20 20 20 20 23 20 61 20 72 65  te as.    # a re
6320: 73 75 6c 74 20 6f 66 20 74 68 65 20 73 63 72 69  sult of the scri
6330: 70 74 2c 20 74 68 65 20 4e 74 68 20 77 69 6c 6c  pt, the Nth will
6340: 20 66 61 69 6c 2e 0a 20 20 20 20 64 6f 5f 74 65   fail..    do_te
6350: 73 74 20 24 74 65 73 74 6e 61 6d 65 2e 24 6e 2e  st $testname.$n.
6360: 33 20 7b 0a 20 20 20 20 20 20 73 65 74 20 3a 3a  3 {.      set ::
6370: 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f  sqlite_io_error_
6380: 68 69 74 20 30 0a 20 20 20 20 20 20 73 65 74 20  hit 0.      set 
6390: 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f  ::sqlite_io_erro
63a0: 72 5f 68 61 72 64 68 69 74 20 30 0a 20 20 20 20  r_hardhit 0.    
63b0: 20 20 73 65 74 20 72 20 5b 63 61 74 63 68 20 24    set r [catch $
63c0: 3a 3a 69 6f 65 72 72 6f 72 62 6f 64 79 20 6d 73  ::ioerrorbody ms
63d0: 67 5d 0a 20 20 20 20 20 20 73 65 74 20 3a 3a 65  g].      set ::e
63e0: 72 72 73 65 65 6e 20 24 72 0a 20 20 20 20 20 20  rrseen $r.      
63f0: 73 65 74 20 72 63 20 5b 73 71 6c 69 74 65 33 5f  set rc [sqlite3_
6400: 65 72 72 63 6f 64 65 20 24 3a 3a 44 42 5d 0a 20  errcode $::DB]. 
6410: 20 20 20 20 20 69 66 20 7b 24 3a 3a 69 6f 65 72       if {$::ioer
6420: 72 6f 70 74 73 28 2d 65 72 63 29 7d 20 7b 0a 20  ropts(-erc)} {. 
6430: 20 20 20 20 20 20 20 23 20 49 66 20 77 65 20 61         # If we a
6440: 72 65 20 69 6e 20 65 78 74 65 6e 64 65 64 20 72  re in extended r
6450: 65 73 75 6c 74 20 63 6f 64 65 20 6d 6f 64 65 2c  esult code mode,
6460: 20 6d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 6f   make sure all o
6470: 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 23 20  f the.        # 
6480: 49 4f 45 52 52 73 20 77 65 20 67 65 74 20 62 61  IOERRs we get ba
6490: 63 6b 20 72 65 61 6c 6c 79 20 64 6f 20 68 61 76  ck really do hav
64a0: 65 20 74 68 65 69 72 20 65 78 74 65 6e 64 65 64  e their extended
64b0: 20 63 6f 64 65 20 76 61 6c 75 65 73 2e 0a 20 20   code values..  
64c0: 20 20 20 20 20 20 23 20 49 66 20 61 6e 20 65 78        # If an ex
64d0: 74 65 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f  tended result co
64e0: 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20  de is returned, 
64f0: 74 68 65 20 73 71 6c 69 74 65 33 5f 65 72 72 63  the sqlite3_errc
6500: 6f 64 65 0a 20 20 20 20 20 20 20 20 23 20 54 43  ode.        # TC
6510: 4c 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 72 65  Lcommand will re
6520: 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20 6f 66  turn a string of
6530: 20 74 68 65 20 66 6f 72 6d 3a 20 20 53 51 4c 49   the form:  SQLI
6540: 54 45 5f 49 4f 45 52 52 2b 6e 6e 6e 6e 0a 20 20  TE_IOERR+nnnn.  
6550: 20 20 20 20 20 20 23 20 77 68 65 72 65 20 6e 6e        # where nn
6560: 6e 6e 20 69 73 20 61 20 6e 75 6d 62 65 72 0a 20  nn is a number. 
6570: 20 20 20 20 20 20 20 69 66 20 7b 5b 72 65 67 65         if {[rege
6580: 78 70 20 7b 5e 53 51 4c 49 54 45 5f 49 4f 45 52  xp {^SQLITE_IOER
6590: 52 7d 20 24 72 63 5d 20 26 26 20 21 5b 72 65 67  R} $rc] && ![reg
65a0: 65 78 70 20 7b 49 4f 45 52 52 5c 2b 5c 64 7d 20  exp {IOERR\+\d} 
65b0: 24 72 63 5d 7d 20 7b 0a 20 20 20 20 20 20 20 20  $rc]} {.        
65c0: 20 20 72 65 74 75 72 6e 20 24 72 63 0a 20 20 20    return $rc.   
65d0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 20 65       }.      } e
65e0: 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 23 20  lse {.        # 
65f0: 49 66 20 77 65 20 61 72 65 20 6e 6f 74 20 69 6e  If we are not in
6600: 20 65 78 74 65 6e 64 65 64 20 72 65 73 75 6c 74   extended result
6610: 20 63 6f 64 65 20 6d 6f 64 65 2c 20 6d 61 6b 65   code mode, make
6620: 20 73 75 72 65 20 6e 6f 0a 20 20 20 20 20 20 20   sure no.       
6630: 20 23 20 65 78 74 65 6e 64 65 64 20 65 72 72 6f   # extended erro
6640: 72 20 63 6f 64 65 73 20 61 72 65 20 72 65 74 75  r codes are retu
6650: 72 6e 65 64 2e 0a 20 20 20 20 20 20 20 20 69 66  rned..        if
6660: 20 7b 5b 72 65 67 65 78 70 20 7b 5c 2b 5c 64 7d   {[regexp {\+\d}
6670: 20 24 72 63 5d 7d 20 7b 0a 20 20 20 20 20 20 20   $rc]} {.       
6680: 20 20 20 72 65 74 75 72 6e 20 24 72 63 0a 20 20     return $rc.  
6690: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
66a0: 20 20 20 20 20 20 23 20 54 68 65 20 74 65 73 74        # The test
66b0: 20 72 65 70 65 61 74 73 20 61 73 20 6c 6f 6e 67   repeats as long
66c0: 20 61 73 20 24 3a 3a 67 6f 20 69 73 20 6e 6f 6e   as $::go is non
66d0: 2d 7a 65 72 6f 2e 20 20 24 3a 3a 67 6f 20 73 74  -zero.  $::go st
66e0: 61 72 74 73 20 6f 75 74 0a 20 20 20 20 20 20 23  arts out.      #
66f0: 20 61 73 20 31 2e 20 20 57 68 65 6e 20 61 20 74   as 1.  When a t
6700: 65 73 74 20 72 75 6e 73 20 74 6f 20 63 6f 6d 70  est runs to comp
6710: 6c 65 74 69 6f 6e 20 77 69 74 68 6f 75 74 20 68  letion without h
6720: 69 74 74 69 6e 67 20 61 6e 20 49 2f 4f 0a 20 20  itting an I/O.  
6730: 20 20 20 20 23 20 65 72 72 6f 72 2c 20 74 68 61      # error, tha
6740: 74 20 6d 65 61 6e 73 20 74 68 65 72 65 20 69 73  t means there is
6750: 20 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 63 6f 6e   no point in con
6760: 74 69 6e 75 69 6e 67 20 77 69 74 68 20 74 68 69  tinuing with thi
6770: 73 20 74 65 73 74 0a 20 20 20 20 20 20 23 20 63  s test.      # c
6780: 61 73 65 20 73 6f 20 73 65 74 20 24 3a 3a 67 6f  ase so set $::go
6790: 20 74 6f 20 7a 65 72 6f 2e 0a 20 20 20 20 20 20   to zero..      
67a0: 23 0a 20 20 20 20 20 20 69 66 20 7b 24 3a 3a 73  #.      if {$::s
67b0: 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f 70  qlite_io_error_p
67c0: 65 6e 64 69 6e 67 3e 30 7d 20 7b 0a 20 20 20 20  ending>0} {.    
67d0: 20 20 20 20 73 65 74 20 3a 3a 67 6f 20 30 0a 20      set ::go 0. 
67e0: 20 20 20 20 20 20 20 73 65 74 20 71 20 30 0a 20         set q 0. 
67f0: 20 20 20 20 20 20 20 73 65 74 20 3a 3a 73 71 6c         set ::sql
6800: 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e  ite_io_error_pen
6810: 64 69 6e 67 20 30 0a 20 20 20 20 20 20 7d 20 65  ding 0.      } e
6820: 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 73 65  lse {.        se
6830: 74 20 71 20 31 0a 20 20 20 20 20 20 7d 0a 0a 20  t q 1.      }.. 
6840: 20 20 20 20 20 73 65 74 20 73 20 5b 65 78 70 72       set s [expr
6850: 20 24 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f 65 72   $::sqlite_io_er
6860: 72 6f 72 5f 68 69 74 3d 3d 30 5d 0a 20 20 20 20  ror_hit==0].    
6870: 20 20 69 66 20 7b 24 3a 3a 73 71 6c 69 74 65 5f    if {$::sqlite_
6880: 69 6f 5f 65 72 72 6f 72 5f 68 69 74 3e 24 3a 3a  io_error_hit>$::
6890: 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f 72 5f  sqlite_io_error_
68a0: 68 61 72 64 68 69 74 20 26 26 20 24 72 3d 3d 30  hardhit && $r==0
68b0: 7d 20 7b 0a 20 20 20 20 20 20 20 20 73 65 74 20  } {.        set 
68c0: 72 20 31 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  r 1.      }.    
68d0: 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65 5f 69    set ::sqlite_i
68e0: 6f 5f 65 72 72 6f 72 5f 68 69 74 20 30 0a 0a 20  o_error_hit 0.. 
68f0: 20 20 20 20 20 23 20 4f 6e 65 20 6f 66 20 74 77       # One of tw
6900: 6f 20 74 68 69 6e 67 73 20 6d 75 73 74 20 68 61  o things must ha
6910: 76 65 20 68 61 70 70 65 6e 65 64 2e 20 65 69 74  ve happened. eit
6920: 68 65 72 0a 20 20 20 20 20 20 23 20 20 20 31 2e  her.      #   1.
6930: 20 20 57 65 20 6e 65 76 65 72 20 68 69 74 20 74    We never hit t
6940: 68 65 20 49 4f 20 65 72 72 6f 72 20 61 6e 64 20  he IO error and 
6950: 74 68 65 20 53 51 4c 20 72 65 74 75 72 6e 65 64  the SQL returned
6960: 20 4f 4b 0a 20 20 20 20 20 20 23 20 20 20 32 2e   OK.      #   2.
6970: 20 20 41 6e 20 49 4f 20 65 72 72 6f 72 20 77 61    An IO error wa
6980: 73 20 68 69 74 20 61 6e 64 20 74 68 65 20 53 51  s hit and the SQ
6990: 4c 20 66 61 69 6c 65 64 0a 20 20 20 20 20 20 23  L failed.      #
69a0: 0a 20 20 20 20 20 20 23 70 75 74 73 20 22 73 3d  .      #puts "s=
69b0: 24 73 20 72 3d 24 72 20 71 3d 24 71 22 0a 20 20  $s r=$r q=$q".  
69c0: 20 20 20 20 65 78 70 72 20 7b 20 28 24 73 20 26      expr { ($s &
69d0: 26 20 21 24 72 20 26 26 20 21 24 71 29 20 7c 7c  & !$r && !$q) ||
69e0: 20 28 21 24 73 20 26 26 20 24 72 20 26 26 20 24   (!$s && $r && $
69f0: 71 29 20 7d 0a 20 20 20 20 7d 20 7b 31 7d 0a 0a  q) }.    } {1}..
6a00: 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65      set ::sqlite
6a10: 5f 69 6f 5f 65 72 72 6f 72 5f 68 69 74 20 30 0a  _io_error_hit 0.
6a20: 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65      set ::sqlite
6a30: 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e  _io_error_pendin
6a40: 67 20 30 0a 0a 20 20 20 20 23 20 43 68 65 63 6b  g 0..    # Check
6a50: 20 74 68 61 74 20 6e 6f 20 70 61 67 65 20 72 65   that no page re
6a60: 66 65 72 65 6e 63 65 73 20 77 65 72 65 20 6c 65  ferences were le
6a70: 61 6b 65 64 2e 20 54 68 65 72 65 20 73 68 6f 75  aked. There shou
6a80: 6c 64 20 62 65 20 0a 20 20 20 20 23 20 61 20 73  ld be .    # a s
6a90: 69 6e 67 6c 65 20 72 65 66 65 72 65 6e 63 65 20  ingle reference 
6aa0: 69 66 20 74 68 65 72 65 20 69 73 20 73 74 69 6c  if there is stil
6ab0: 6c 20 61 6e 20 61 63 74 69 76 65 20 74 72 61 6e  l an active tran
6ac0: 73 61 63 74 69 6f 6e 2c 20 0a 20 20 20 20 23 20  saction, .    # 
6ad0: 6f 72 20 7a 65 72 6f 20 6f 74 68 65 72 77 69 73  or zero otherwis
6ae0: 65 2e 0a 20 20 20 20 23 0a 20 20 20 20 23 20 55  e..    #.    # U
6af0: 50 44 41 54 45 3a 20 49 66 20 74 68 65 20 49 4f  PDATE: If the IO
6b00: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 66   error occurs af
6b10: 74 65 72 20 61 20 27 42 45 47 49 4e 27 20 62 75  ter a 'BEGIN' bu
6b20: 74 20 62 65 66 6f 72 65 20 61 6e 79 0a 20 20 20  t before any.   
6b30: 20 23 20 6c 6f 63 6b 73 20 61 72 65 20 65 73 74   # locks are est
6b40: 61 62 6c 69 73 68 65 64 20 6f 6e 20 64 61 74 61  ablished on data
6b50: 62 61 73 65 20 66 69 6c 65 73 20 28 69 2e 65 2e  base files (i.e.
6b60: 20 69 66 20 74 68 65 20 65 72 72 6f 72 20 0a 20   if the error . 
6b70: 20 20 20 23 20 6f 63 63 75 72 73 20 77 68 69 6c     # occurs whil
6b80: 65 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20  e attempting to 
6b90: 64 65 74 65 63 74 20 61 20 68 6f 74 2d 6a 6f 75  detect a hot-jou
6ba0: 72 6e 61 6c 20 66 69 6c 65 29 2c 20 74 68 65 6e  rnal file), then
6bb0: 0a 20 20 20 20 23 20 74 68 65 72 65 20 6d 61 79  .    # there may
6bc0: 20 30 20 70 61 67 65 20 72 65 66 65 72 65 6e 63   0 page referenc
6bd0: 65 73 20 61 6e 64 20 61 6e 20 61 63 74 69 76 65  es and an active
6be0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 63   transaction acc
6bf0: 6f 72 64 69 6e 67 0a 20 20 20 20 23 20 74 6f 20  ording.    # to 
6c00: 5b 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74  [sqlite3_get_aut
6c10: 6f 63 6f 6d 6d 69 74 5d 2e 0a 20 20 20 20 23 0a  ocommit]..    #.
6c20: 20 20 20 20 69 66 20 7b 24 3a 3a 67 6f 20 26 26      if {$::go &&
6c30: 20 24 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f 65 72   $::sqlite_io_er
6c40: 72 6f 72 5f 68 61 72 64 68 69 74 20 26 26 20 24  ror_hardhit && $
6c50: 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 63 6b 72  ::ioerropts(-ckr
6c60: 65 66 63 6f 75 6e 74 29 7d 20 7b 0a 20 20 20 20  efcount)} {.    
6c70: 20 20 64 6f 5f 74 65 73 74 20 24 74 65 73 74 6e    do_test $testn
6c80: 61 6d 65 2e 24 6e 2e 34 20 7b 0a 20 20 20 20 20  ame.$n.4 {.     
6c90: 20 20 20 73 65 74 20 62 74 20 5b 62 74 72 65 65     set bt [btree
6ca0: 5f 66 72 6f 6d 5f 64 62 20 64 62 5d 0a 20 20 20  _from_db db].   
6cb0: 20 20 20 20 20 64 62 5f 65 6e 74 65 72 20 64 62       db_enter db
6cc0: 0a 20 20 20 20 20 20 20 20 61 72 72 61 79 20 73  .        array s
6cd0: 65 74 20 73 74 61 74 73 20 5b 62 74 72 65 65 5f  et stats [btree_
6ce0: 70 61 67 65 72 5f 73 74 61 74 73 20 24 62 74 5d  pager_stats $bt]
6cf0: 0a 20 20 20 20 20 20 20 20 64 62 5f 6c 65 61 76  .        db_leav
6d00: 65 20 64 62 0a 20 20 20 20 20 20 20 20 73 65 74  e db.        set
6d10: 20 6e 52 65 66 20 24 73 74 61 74 73 28 72 65 66   nRef $stats(ref
6d20: 29 0a 20 20 20 20 20 20 20 20 65 78 70 72 20 7b  ).        expr {
6d30: 24 6e 52 65 66 20 3d 3d 20 30 20 7c 7c 20 28 5b  $nRef == 0 || ([
6d40: 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 6f  sqlite3_get_auto
6d50: 63 6f 6d 6d 69 74 20 64 62 5d 3d 3d 30 20 26 26  commit db]==0 &&
6d60: 20 24 6e 52 65 66 20 3d 3d 20 31 29 7d 0a 20 20   $nRef == 1)}.  
6d70: 20 20 20 20 7d 20 7b 31 7d 0a 20 20 20 20 7d 0a      } {1}.    }.
6d80: 0a 20 20 20 20 23 20 49 66 20 74 68 65 72 65 20  .    # If there 
6d90: 69 73 20 61 6e 20 6f 70 65 6e 20 64 61 74 61 62  is an open datab
6da0: 61 73 65 20 68 61 6e 64 6c 65 20 61 6e 64 20 6e  ase handle and n
6db0: 6f 20 6f 70 65 6e 20 74 72 61 6e 73 61 63 74 69  o open transacti
6dc0: 6f 6e 2c 20 0a 20 20 20 20 23 20 61 6e 64 20 74  on, .    # and t
6dd0: 68 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20  he pager is not 
6de0: 72 75 6e 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75  running in exclu
6df0: 73 69 76 65 2d 6c 6f 63 6b 69 6e 67 20 6d 6f 64  sive-locking mod
6e00: 65 2c 0a 20 20 20 20 23 20 63 68 65 63 6b 20 74  e,.    # check t
6e10: 68 61 74 20 74 68 65 20 70 61 67 65 72 20 69 73  hat the pager is
6e20: 20 69 6e 20 22 75 6e 6c 6f 63 6b 65 64 22 20 73   in "unlocked" s
6e30: 74 61 74 65 2e 20 54 68 65 6f 72 65 74 69 63 61  tate. Theoretica
6e40: 6c 6c 79 2c 0a 20 20 20 20 23 20 69 66 20 61 20  lly,.    # if a 
6e50: 63 61 6c 6c 20 74 6f 20 78 55 6e 6c 6f 63 6b 28  call to xUnlock(
6e60: 29 20 66 61 69 6c 65 64 20 64 75 65 20 74 6f 20  ) failed due to 
6e70: 61 6e 20 49 4f 20 65 72 72 6f 72 20 74 68 65 20  an IO error the 
6e80: 75 6e 64 65 72 6c 79 69 6e 67 0a 20 20 20 20 23  underlying.    #
6e90: 20 66 69 6c 65 20 6d 61 79 20 73 74 69 6c 6c 20   file may still 
6ea0: 62 65 20 6c 6f 63 6b 65 64 2e 0a 20 20 20 20 23  be locked..    #
6eb0: 0a 20 20 20 20 69 66 63 61 70 61 62 6c 65 20 70  .    ifcapable p
6ec0: 72 61 67 6d 61 20 7b 0a 20 20 20 20 20 20 69 66  ragma {.      if
6ed0: 20 7b 20 5b 69 6e 66 6f 20 63 6f 6d 6d 61 6e 64   { [info command
6ee0: 73 20 64 62 5d 20 6e 65 20 22 22 0a 20 20 20 20  s db] ne "".    
6ef0: 20 20 20 20 26 26 20 24 3a 3a 69 6f 65 72 72 6f      && $::ioerro
6f00: 70 74 73 28 2d 63 6b 72 65 66 63 6f 75 6e 74 29  pts(-ckrefcount)
6f10: 0a 20 20 20 20 20 20 20 20 26 26 20 5b 64 62 20  .        && [db 
6f20: 6f 6e 65 20 7b 70 72 61 67 6d 61 20 6c 6f 63 6b  one {pragma lock
6f30: 69 6e 67 5f 6d 6f 64 65 7d 5d 20 65 71 20 22 6e  ing_mode}] eq "n
6f40: 6f 72 6d 61 6c 22 0a 20 20 20 20 20 20 20 20 26  ormal".        &
6f50: 26 20 5b 73 71 6c 69 74 65 33 5f 67 65 74 5f 61  & [sqlite3_get_a
6f60: 75 74 6f 63 6f 6d 6d 69 74 20 64 62 5d 0a 20 20  utocommit db].  
6f70: 20 20 20 20 7d 20 7b 0a 20 20 20 20 20 20 20 20      } {.        
6f80: 64 6f 5f 74 65 73 74 20 24 74 65 73 74 6e 61 6d  do_test $testnam
6f90: 65 2e 24 6e 2e 35 20 7b 0a 20 20 20 20 20 20 20  e.$n.5 {.       
6fa0: 20 20 20 73 65 74 20 62 74 20 5b 62 74 72 65 65     set bt [btree
6fb0: 5f 66 72 6f 6d 5f 64 62 20 64 62 5d 0a 20 20 20  _from_db db].   
6fc0: 20 20 20 20 20 20 20 64 62 5f 65 6e 74 65 72 20         db_enter 
6fd0: 64 62 0a 20 20 20 20 20 20 20 20 20 20 61 72 72  db.          arr
6fe0: 61 79 20 73 65 74 20 73 74 61 74 73 20 5b 62 74  ay set stats [bt
6ff0: 72 65 65 5f 70 61 67 65 72 5f 73 74 61 74 73 20  ree_pager_stats 
7000: 24 62 74 5d 0a 20 20 20 20 20 20 20 20 20 20 64  $bt].          d
7010: 62 5f 6c 65 61 76 65 20 64 62 0a 20 20 20 20 20  b_leave db.     
7020: 20 20 20 20 20 73 65 74 20 73 74 61 74 73 28 73       set stats(s
7030: 74 61 74 65 29 0a 20 20 20 20 20 20 20 20 7d 20  tate).        } 
7040: 30 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  0.      }.    }.
7050: 0a 20 20 20 20 23 20 49 66 20 61 6e 20 49 4f 20  .    # If an IO 
7060: 65 72 72 6f 72 20 6f 63 63 75 72 65 64 2c 20 74  error occured, t
7070: 68 65 6e 20 74 68 65 20 63 68 65 63 6b 73 75 6d  hen the checksum
7080: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65   of the database
7090: 20 73 68 6f 75 6c 64 0a 20 20 20 20 23 20 62 65   should.    # be
70a0: 20 74 68 65 20 73 61 6d 65 20 61 73 20 62 65 66   the same as bef
70b0: 6f 72 65 20 74 68 65 20 73 63 72 69 70 74 20 74  ore the script t
70c0: 68 61 74 20 63 61 75 73 65 64 20 74 68 65 20 49  hat caused the I
70d0: 4f 20 65 72 72 6f 72 20 77 61 73 20 72 75 6e 2e  O error was run.
70e0: 0a 20 20 20 20 23 0a 20 20 20 20 69 66 20 7b 24  .    #.    if {$
70f0: 3a 3a 67 6f 20 26 26 20 24 3a 3a 73 71 6c 69 74  ::go && $::sqlit
7100: 65 5f 69 6f 5f 65 72 72 6f 72 5f 68 61 72 64 68  e_io_error_hardh
7110: 69 74 20 26 26 20 24 3a 3a 69 6f 65 72 72 6f 70  it && $::ioerrop
7120: 74 73 28 2d 63 6b 73 75 6d 29 7d 20 7b 0a 20 20  ts(-cksum)} {.  
7130: 20 20 20 20 64 6f 5f 74 65 73 74 20 24 74 65 73      do_test $tes
7140: 74 6e 61 6d 65 2e 24 6e 2e 36 20 7b 0a 20 20 20  tname.$n.6 {.   
7150: 20 20 20 20 20 63 61 74 63 68 20 7b 64 62 20 63       catch {db c
7160: 6c 6f 73 65 7d 0a 20 20 20 20 20 20 20 20 63 61  lose}.        ca
7170: 74 63 68 20 7b 64 62 32 20 63 6c 6f 73 65 7d 0a  tch {db2 close}.
7180: 20 20 20 20 20 20 20 20 73 65 74 20 3a 3a 44 42          set ::DB
7190: 20 5b 73 71 6c 69 74 65 33 20 64 62 20 74 65 73   [sqlite3 db tes
71a0: 74 2e 64 62 3b 20 73 71 6c 69 74 65 33 5f 63 6f  t.db; sqlite3_co
71b0: 6e 6e 65 63 74 69 6f 6e 5f 70 6f 69 6e 74 65 72  nnection_pointer
71c0: 20 64 62 5d 0a 20 20 20 20 20 20 20 20 63 6b 73   db].        cks
71d0: 75 6d 0a 20 20 20 20 20 20 7d 20 24 63 68 65 63  um.      } $chec
71e0: 6b 73 75 6d 0a 20 20 20 20 7d 0a 0a 20 20 20 20  ksum.    }..    
71f0: 73 65 74 20 3a 3a 73 71 6c 69 74 65 5f 69 6f 5f  set ::sqlite_io_
7200: 65 72 72 6f 72 5f 68 61 72 64 68 69 74 20 30 0a  error_hardhit 0.
7210: 20 20 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65      set ::sqlite
7220: 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e  _io_error_pendin
7230: 67 20 30 0a 20 20 20 20 69 66 20 7b 5b 69 6e 66  g 0.    if {[inf
7240: 6f 20 65 78 69 73 74 73 20 3a 3a 69 6f 65 72 72  o exists ::ioerr
7250: 6f 70 74 73 28 2d 63 6c 65 61 6e 75 70 29 5d 7d  opts(-cleanup)]}
7260: 20 7b 0a 20 20 20 20 20 20 63 61 74 63 68 20 24   {.      catch $
7270: 3a 3a 69 6f 65 72 72 6f 70 74 73 28 2d 63 6c 65  ::ioerropts(-cle
7280: 61 6e 75 70 29 0a 20 20 20 20 7d 0a 20 20 7d 0a  anup).    }.  }.
7290: 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65 5f 69    set ::sqlite_i
72a0: 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20  o_error_pending 
72b0: 30 0a 20 20 73 65 74 20 3a 3a 73 71 6c 69 74 65  0.  set ::sqlite
72c0: 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 72 73 69 73  _io_error_persis
72d0: 74 20 30 0a 20 20 75 6e 73 65 74 20 3a 3a 69 6f  t 0.  unset ::io
72e0: 65 72 72 6f 70 74 73 0a 7d 0a 0a 23 20 52 65 74  erropts.}..# Ret
72f0: 75 72 6e 20 61 20 63 68 65 63 6b 73 75 6d 20 62  urn a checksum b
7300: 61 73 65 64 20 6f 6e 20 74 68 65 20 63 6f 6e 74  ased on the cont
7310: 65 6e 74 73 20 6f 66 20 74 68 65 20 6d 61 69 6e  ents of the main
7320: 20 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69   database associ
7330: 61 74 65 64 0a 23 20 77 69 74 68 20 63 6f 6e 6e  ated.# with conn
7340: 65 63 74 69 6f 6e 20 24 64 62 0a 23 0a 70 72 6f  ection $db.#.pro
7350: 63 20 63 6b 73 75 6d 20 7b 7b 64 62 20 64 62 7d  c cksum {{db db}
7360: 7d 20 7b 0a 20 20 73 65 74 20 74 78 74 20 5b 24  } {.  set txt [$
7370: 64 62 20 65 76 61 6c 20 7b 0a 20 20 20 20 20 20  db eval {.      
7380: 53 45 4c 45 43 54 20 6e 61 6d 65 2c 20 74 79 70  SELECT name, typ
7390: 65 2c 20 73 71 6c 20 46 52 4f 4d 20 73 71 6c 69  e, sql FROM sqli
73a0: 74 65 5f 6d 61 73 74 65 72 20 6f 72 64 65 72 20  te_master order 
73b0: 62 79 20 6e 61 6d 65 0a 20 20 7d 5d 5c 6e 0a 20  by name.  }]\n. 
73c0: 20 66 6f 72 65 61 63 68 20 74 62 6c 20 5b 24 64   foreach tbl [$d
73d0: 62 20 65 76 61 6c 20 7b 0a 20 20 20 20 20 20 53  b eval {.      S
73e0: 45 4c 45 43 54 20 6e 61 6d 65 20 46 52 4f 4d 20  ELECT name FROM 
73f0: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 57 48  sqlite_master WH
7400: 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c 65 27  ERE type='table'
7410: 20 6f 72 64 65 72 20 62 79 20 6e 61 6d 65 0a 20   order by name. 
7420: 20 7d 5d 20 7b 0a 20 20 20 20 61 70 70 65 6e 64   }] {.    append
7430: 20 74 78 74 20 5b 24 64 62 20 65 76 61 6c 20 22   txt [$db eval "
7440: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 24 74  SELECT * FROM $t
7450: 62 6c 22 5d 5c 6e 0a 20 20 7d 0a 20 20 66 6f 72  bl"]\n.  }.  for
7460: 65 61 63 68 20 70 72 61 67 20 7b 64 65 66 61 75  each prag {defau
7470: 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75 73 20 64  lt_synchronous d
7480: 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73 69 7a  efault_cache_siz
7490: 65 7d 20 7b 0a 20 20 20 20 61 70 70 65 6e 64 20  e} {.    append 
74a0: 74 78 74 20 24 70 72 61 67 2d 5b 24 64 62 20 65  txt $prag-[$db e
74b0: 76 61 6c 20 22 50 52 41 47 4d 41 20 24 70 72 61  val "PRAGMA $pra
74c0: 67 22 5d 5c 6e 0a 20 20 7d 0a 20 20 73 65 74 20  g"]\n.  }.  set 
74d0: 63 6b 73 75 6d 20 5b 73 74 72 69 6e 67 20 6c 65  cksum [string le
74e0: 6e 67 74 68 20 24 74 78 74 5d 2d 5b 6d 64 35 20  ngth $txt]-[md5 
74f0: 24 74 78 74 5d 0a 20 20 23 20 70 75 74 73 20 24  $txt].  # puts $
7500: 63 6b 73 75 6d 2d 5b 66 69 6c 65 20 73 69 7a 65  cksum-[file size
7510: 20 74 65 73 74 2e 64 62 5d 0a 20 20 72 65 74 75   test.db].  retu
7520: 72 6e 20 24 63 6b 73 75 6d 0a 7d 0a 0a 23 20 47  rn $cksum.}..# G
7530: 65 6e 65 72 61 74 65 20 61 20 63 68 65 63 6b 73  enerate a checks
7540: 75 6d 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20  um based on the 
7550: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20  contents of the 
7560: 6d 61 69 6e 20 61 6e 64 20 74 65 6d 70 20 74 61  main and temp ta
7570: 62 6c 65 73 0a 23 20 64 61 74 61 62 61 73 65 20  bles.# database 
7580: 24 64 62 2e 20 49 66 20 74 68 65 20 63 68 65 63  $db. If the chec
7590: 6b 73 75 6d 20 6f 66 20 74 77 6f 20 64 61 74 61  ksum of two data
75a0: 62 61 73 65 73 20 69 73 20 74 68 65 20 73 61 6d  bases is the sam
75b0: 65 2c 20 61 6e 64 20 74 68 65 0a 23 20 69 6e 74  e, and the.# int
75c0: 65 67 72 69 74 79 2d 63 68 65 63 6b 20 70 61 73  egrity-check pas
75d0: 73 65 73 20 66 6f 72 20 62 6f 74 68 2c 20 74 68  ses for both, th
75e0: 65 20 74 77 6f 20 64 61 74 61 62 61 73 65 73 20  e two databases 
75f0: 61 72 65 20 69 64 65 6e 74 69 63 61 6c 2e 0a 23  are identical..#
7600: 0a 70 72 6f 63 20 61 6c 6c 63 6b 73 75 6d 20 7b  .proc allcksum {
7610: 7b 64 62 20 64 62 7d 7d 20 7b 0a 20 20 73 65 74  {db db}} {.  set
7620: 20 72 65 74 20 5b 6c 69 73 74 5d 0a 20 20 69 66   ret [list].  if
7630: 63 61 70 61 62 6c 65 20 74 65 6d 70 64 62 20 7b  capable tempdb {
7640: 0a 20 20 20 20 73 65 74 20 73 71 6c 20 7b 0a 20  .    set sql {. 
7650: 20 20 20 20 20 53 45 4c 45 43 54 20 6e 61 6d 65       SELECT name
7660: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73   FROM sqlite_mas
7670: 74 65 72 20 57 48 45 52 45 20 74 79 70 65 20 3d  ter WHERE type =
7680: 20 27 74 61 62 6c 65 27 20 55 4e 49 4f 4e 0a 20   'table' UNION. 
7690: 20 20 20 20 20 53 45 4c 45 43 54 20 6e 61 6d 65       SELECT name
76a0: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 74 65 6d   FROM sqlite_tem
76b0: 70 5f 6d 61 73 74 65 72 20 57 48 45 52 45 20 74  p_master WHERE t
76c0: 79 70 65 20 3d 20 27 74 61 62 6c 65 27 20 55 4e  ype = 'table' UN
76d0: 49 4f 4e 0a 20 20 20 20 20 20 53 45 4c 45 43 54  ION.      SELECT
76e0: 20 27 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 27   'sqlite_master'
76f0: 20 55 4e 49 4f 4e 0a 20 20 20 20 20 20 53 45 4c   UNION.      SEL
7700: 45 43 54 20 27 73 71 6c 69 74 65 5f 74 65 6d 70  ECT 'sqlite_temp
7710: 5f 6d 61 73 74 65 72 27 20 4f 52 44 45 52 20 42  _master' ORDER B
7720: 59 20 31 0a 20 20 20 20 7d 0a 20 20 7d 20 65 6c  Y 1.    }.  } el
7730: 73 65 20 7b 0a 20 20 20 20 73 65 74 20 73 71 6c  se {.    set sql
7740: 20 7b 0a 20 20 20 20 20 20 53 45 4c 45 43 54 20   {.      SELECT 
7750: 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c 69 74 65  name FROM sqlite
7760: 5f 6d 61 73 74 65 72 20 57 48 45 52 45 20 74 79  _master WHERE ty
7770: 70 65 20 3d 20 27 74 61 62 6c 65 27 20 55 4e 49  pe = 'table' UNI
7780: 4f 4e 0a 20 20 20 20 20 20 53 45 4c 45 43 54 20  ON.      SELECT 
7790: 27 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 27 20  'sqlite_master' 
77a0: 4f 52 44 45 52 20 42 59 20 31 0a 20 20 20 20 7d  ORDER BY 1.    }
77b0: 0a 20 20 7d 0a 20 20 73 65 74 20 74 62 6c 6c 69  .  }.  set tblli
77c0: 73 74 20 5b 24 64 62 20 65 76 61 6c 20 24 73 71  st [$db eval $sq
77d0: 6c 5d 0a 20 20 73 65 74 20 74 78 74 20 7b 7d 0a  l].  set txt {}.
77e0: 20 20 66 6f 72 65 61 63 68 20 74 62 6c 20 24 74    foreach tbl $t
77f0: 62 6c 6c 69 73 74 20 7b 0a 20 20 20 20 61 70 70  bllist {.    app
7800: 65 6e 64 20 74 78 74 20 5b 24 64 62 20 65 76 61  end txt [$db eva
7810: 6c 20 22 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d  l "SELECT * FROM
7820: 20 24 74 62 6c 22 5d 0a 20 20 7d 0a 20 20 66 6f   $tbl"].  }.  fo
7830: 72 65 61 63 68 20 70 72 61 67 20 7b 64 65 66 61  reach prag {defa
7840: 75 6c 74 5f 63 61 63 68 65 5f 73 69 7a 65 7d 20  ult_cache_size} 
7850: 7b 0a 20 20 20 20 61 70 70 65 6e 64 20 74 78 74  {.    append txt
7860: 20 24 70 72 61 67 2d 5b 24 64 62 20 65 76 61 6c   $prag-[$db eval
7870: 20 22 50 52 41 47 4d 41 20 24 70 72 61 67 22 5d   "PRAGMA $prag"]
7880: 5c 6e 0a 20 20 7d 0a 20 20 23 20 70 75 74 73 20  \n.  }.  # puts 
7890: 74 78 74 3d 24 74 78 74 0a 20 20 72 65 74 75 72  txt=$txt.  retur
78a0: 6e 20 5b 6d 64 35 20 24 74 78 74 5d 0a 7d 0a 0a  n [md5 $txt].}..
78b0: 23 20 47 65 6e 65 72 61 74 65 20 61 20 63 68 65  # Generate a che
78c0: 63 6b 73 75 6d 20 62 61 73 65 64 20 6f 6e 20 74  cksum based on t
78d0: 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61  he contents of a
78e0: 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65   single database
78f0: 20 77 69 74 68 0a 23 20 61 20 64 61 74 61 62 61   with.# a databa
7900: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20  se connection.  
7910: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
7920: 64 61 74 61 62 61 73 65 20 69 73 20 24 64 62 6e  database is $dbn
7930: 61 6d 65 2e 20 20 0a 23 20 45 78 61 6d 70 6c 65  ame.  .# Example
7940: 73 20 6f 66 20 24 64 62 6e 61 6d 65 20 61 72 65  s of $dbname are
7950: 20 22 74 65 6d 70 22 20 6f 72 20 22 6d 61 69 6e   "temp" or "main
7960: 22 2e 0a 23 0a 70 72 6f 63 20 64 62 63 6b 73 75  "..#.proc dbcksu
7970: 6d 20 7b 64 62 20 64 62 6e 61 6d 65 7d 20 7b 0a  m {db dbname} {.
7980: 20 20 69 66 20 7b 24 64 62 6e 61 6d 65 3d 3d 22    if {$dbname=="
7990: 74 65 6d 70 22 7d 20 7b 0a 20 20 20 20 73 65 74  temp"} {.    set
79a0: 20 6d 61 73 74 65 72 20 73 71 6c 69 74 65 5f 74   master sqlite_t
79b0: 65 6d 70 5f 6d 61 73 74 65 72 0a 20 20 7d 20 65  emp_master.  } e
79c0: 6c 73 65 20 7b 0a 20 20 20 20 73 65 74 20 6d 61  lse {.    set ma
79d0: 73 74 65 72 20 24 64 62 6e 61 6d 65 2e 73 71 6c  ster $dbname.sql
79e0: 69 74 65 5f 6d 61 73 74 65 72 0a 20 20 7d 0a 20  ite_master.  }. 
79f0: 20 73 65 74 20 61 6c 6c 74 61 62 20 5b 24 64 62   set alltab [$db
7a00: 20 65 76 61 6c 20 22 53 45 4c 45 43 54 20 6e 61   eval "SELECT na
7a10: 6d 65 20 46 52 4f 4d 20 24 6d 61 73 74 65 72 20  me FROM $master 
7a20: 57 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c  WHERE type='tabl
7a30: 65 27 22 5d 0a 20 20 73 65 74 20 74 78 74 20 5b  e'"].  set txt [
7a40: 24 64 62 20 65 76 61 6c 20 22 53 45 4c 45 43 54  $db eval "SELECT
7a50: 20 2a 20 46 52 4f 4d 20 24 6d 61 73 74 65 72 22   * FROM $master"
7a60: 5d 5c 6e 0a 20 20 66 6f 72 65 61 63 68 20 74 61  ]\n.  foreach ta
7a70: 62 20 24 61 6c 6c 74 61 62 20 7b 0a 20 20 20 20  b $alltab {.    
7a80: 61 70 70 65 6e 64 20 74 78 74 20 5b 24 64 62 20  append txt [$db 
7a90: 65 76 61 6c 20 22 53 45 4c 45 43 54 20 2a 20 46  eval "SELECT * F
7aa0: 52 4f 4d 20 24 64 62 6e 61 6d 65 2e 24 74 61 62  ROM $dbname.$tab
7ab0: 22 5d 5c 6e 0a 20 20 7d 0a 20 20 72 65 74 75 72  "]\n.  }.  retur
7ac0: 6e 20 5b 6d 64 35 20 24 74 78 74 5d 0a 7d 0a 0a  n [md5 $txt].}..
7ad0: 70 72 6f 63 20 6d 65 6d 64 65 62 75 67 5f 6c 6f  proc memdebug_lo
7ae0: 67 5f 73 71 6c 20 7b 7b 66 69 6c 65 6e 61 6d 65  g_sql {{filename
7af0: 20 6d 61 6c 6c 6f 63 73 2e 73 71 6c 7d 7d 20 7b   mallocs.sql}} {
7b00: 0a 0a 20 20 73 65 74 20 64 61 74 61 20 5b 73 71  ..  set data [sq
7b10: 6c 69 74 65 33 5f 6d 65 6d 64 65 62 75 67 5f 6c  lite3_memdebug_l
7b20: 6f 67 20 64 75 6d 70 5d 0a 20 20 73 65 74 20 6e  og dump].  set n
7b30: 46 72 61 6d 65 20 5b 65 78 70 72 20 5b 6c 6c 65  Frame [expr [lle
7b40: 6e 67 74 68 20 5b 6c 69 6e 64 65 78 20 24 64 61  ngth [lindex $da
7b50: 74 61 20 30 5d 5d 2d 32 5d 0a 20 20 69 66 20 7b  ta 0]]-2].  if {
7b60: 24 6e 46 72 61 6d 65 20 3c 20 30 7d 20 7b 20 72  $nFrame < 0} { r
7b70: 65 74 75 72 6e 20 22 22 20 7d 0a 0a 20 20 73 65  eturn "" }..  se
7b80: 74 20 64 61 74 61 62 61 73 65 20 74 65 6d 70 0a  t database temp.
7b90: 0a 20 20 73 65 74 20 74 62 6c 20 22 43 52 45 41  .  set tbl "CREA
7ba0: 54 45 20 54 41 42 4c 45 20 24 7b 64 61 74 61 62  TE TABLE ${datab
7bb0: 61 73 65 7d 2e 6d 61 6c 6c 6f 63 28 7a 54 65 73  ase}.malloc(zTes
7bc0: 74 2c 20 6e 43 61 6c 6c 2c 20 6e 42 79 74 65 2c  t, nCall, nByte,
7bd0: 20 6c 53 74 61 63 6b 29 3b 22 0a 0a 20 20 73 65   lStack);"..  se
7be0: 74 20 73 71 6c 20 22 22 0a 20 20 66 6f 72 65 61  t sql "".  forea
7bf0: 63 68 20 65 20 24 64 61 74 61 20 7b 0a 20 20 20  ch e $data {.   
7c00: 20 73 65 74 20 6e 43 61 6c 6c 20 5b 6c 69 6e 64   set nCall [lind
7c10: 65 78 20 24 65 20 30 5d 0a 20 20 20 20 73 65 74  ex $e 0].    set
7c20: 20 6e 42 79 74 65 20 5b 6c 69 6e 64 65 78 20 24   nByte [lindex $
7c30: 65 20 31 5d 0a 20 20 20 20 73 65 74 20 6c 53 74  e 1].    set lSt
7c40: 61 63 6b 20 5b 6c 72 61 6e 67 65 20 24 65 20 32  ack [lrange $e 2
7c50: 20 65 6e 64 5d 0a 20 20 20 20 61 70 70 65 6e 64   end].    append
7c60: 20 73 71 6c 20 22 49 4e 53 45 52 54 20 49 4e 54   sql "INSERT INT
7c70: 4f 20 24 7b 64 61 74 61 62 61 73 65 7d 2e 6d 61  O ${database}.ma
7c80: 6c 6c 6f 63 20 56 41 4c 55 45 53 22 0a 20 20 20  lloc VALUES".   
7c90: 20 61 70 70 65 6e 64 20 73 71 6c 20 22 28 27 74   append sql "('t
7ca0: 65 73 74 27 2c 20 24 6e 43 61 6c 6c 2c 20 24 6e  est', $nCall, $n
7cb0: 42 79 74 65 2c 20 27 24 6c 53 74 61 63 6b 27 29  Byte, '$lStack')
7cc0: 3b 5c 6e 22 0a 20 20 20 20 66 6f 72 65 61 63 68  ;\n".    foreach
7cd0: 20 66 20 24 6c 53 74 61 63 6b 20 7b 0a 20 20 20   f $lStack {.   
7ce0: 20 20 20 73 65 74 20 66 72 61 6d 65 73 28 24 66     set frames($f
7cf0: 29 20 31 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20  ) 1.    }.  }.. 
7d00: 20 73 65 74 20 74 62 6c 32 20 22 43 52 45 41 54   set tbl2 "CREAT
7d10: 45 20 54 41 42 4c 45 20 24 7b 64 61 74 61 62 61  E TABLE ${databa
7d20: 73 65 7d 2e 66 72 61 6d 65 28 66 72 61 6d 65 20  se}.frame(frame 
7d30: 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20  INTEGER PRIMARY 
7d40: 4b 45 59 2c 20 6c 69 6e 65 29 3b 5c 6e 22 0a 20  KEY, line);\n". 
7d50: 20 73 65 74 20 74 62 6c 33 20 22 43 52 45 41 54   set tbl3 "CREAT
7d60: 45 20 54 41 42 4c 45 20 24 7b 64 61 74 61 62 61  E TABLE ${databa
7d70: 73 65 7d 2e 66 69 6c 65 28 6e 61 6d 65 20 50 52  se}.file(name PR
7d80: 49 4d 41 52 59 20 4b 45 59 2c 20 63 6f 6e 74 65  IMARY KEY, conte
7d90: 6e 74 29 3b 5c 6e 22 0a 0a 20 20 66 6f 72 65 61  nt);\n"..  forea
7da0: 63 68 20 66 20 5b 61 72 72 61 79 20 6e 61 6d 65  ch f [array name
7db0: 73 20 66 72 61 6d 65 73 5d 20 7b 0a 20 20 20 20  s frames] {.    
7dc0: 73 65 74 20 61 64 64 72 20 5b 66 6f 72 6d 61 74  set addr [format
7dd0: 20 25 78 20 24 66 5d 0a 20 20 20 20 73 65 74 20   %x $f].    set 
7de0: 63 6d 64 20 22 61 64 64 72 32 6c 69 6e 65 20 2d  cmd "addr2line -
7df0: 65 20 5b 69 6e 66 6f 20 6e 61 6d 65 6f 66 65 78  e [info nameofex
7e00: 65 63 5d 20 24 61 64 64 72 22 0a 20 20 20 20 73  ec] $addr".    s
7e10: 65 74 20 6c 69 6e 65 20 5b 65 76 61 6c 20 65 78  et line [eval ex
7e20: 65 63 20 24 63 6d 64 5d 0a 20 20 20 20 61 70 70  ec $cmd].    app
7e30: 65 6e 64 20 73 71 6c 20 22 49 4e 53 45 52 54 20  end sql "INSERT 
7e40: 49 4e 54 4f 20 24 7b 64 61 74 61 62 61 73 65 7d  INTO ${database}
7e50: 2e 66 72 61 6d 65 20 56 41 4c 55 45 53 28 24 66  .frame VALUES($f
7e60: 2c 20 27 24 6c 69 6e 65 27 29 3b 5c 6e 22 0a 0a  , '$line');\n"..
7e70: 20 20 20 20 73 65 74 20 66 69 6c 65 20 5b 6c 69      set file [li
7e80: 6e 64 65 78 20 5b 73 70 6c 69 74 20 24 6c 69 6e  ndex [split $lin
7e90: 65 20 3a 5d 20 30 5d 0a 20 20 20 20 73 65 74 20  e :] 0].    set 
7ea0: 66 69 6c 65 73 28 24 66 69 6c 65 29 20 31 0a 20  files($file) 1. 
7eb0: 20 7d 0a 0a 20 20 66 6f 72 65 61 63 68 20 66 20   }..  foreach f 
7ec0: 5b 61 72 72 61 79 20 6e 61 6d 65 73 20 66 69 6c  [array names fil
7ed0: 65 73 5d 20 7b 0a 20 20 20 20 73 65 74 20 63 6f  es] {.    set co
7ee0: 6e 74 65 6e 74 73 20 22 22 0a 20 20 20 20 63 61  ntents "".    ca
7ef0: 74 63 68 20 7b 0a 20 20 20 20 20 20 73 65 74 20  tch {.      set 
7f00: 66 64 20 5b 6f 70 65 6e 20 24 66 5d 0a 20 20 20  fd [open $f].   
7f10: 20 20 20 73 65 74 20 63 6f 6e 74 65 6e 74 73 20     set contents 
7f20: 5b 72 65 61 64 20 24 66 64 5d 0a 20 20 20 20 20  [read $fd].     
7f30: 20 63 6c 6f 73 65 20 24 66 64 0a 20 20 20 20 7d   close $fd.    }
7f40: 0a 20 20 20 20 73 65 74 20 63 6f 6e 74 65 6e 74  .    set content
7f50: 73 20 5b 73 74 72 69 6e 67 20 6d 61 70 20 7b 27  s [string map {'
7f60: 20 27 27 7d 20 24 63 6f 6e 74 65 6e 74 73 5d 0a   ''} $contents].
7f70: 20 20 20 20 61 70 70 65 6e 64 20 73 71 6c 20 22      append sql "
7f80: 49 4e 53 45 52 54 20 49 4e 54 4f 20 24 7b 64 61  INSERT INTO ${da
7f90: 74 61 62 61 73 65 7d 2e 66 69 6c 65 20 56 41 4c  tabase}.file VAL
7fa0: 55 45 53 28 27 24 66 27 2c 20 27 24 63 6f 6e 74  UES('$f', '$cont
7fb0: 65 6e 74 73 27 29 3b 5c 6e 22 0a 20 20 7d 0a 0a  ents');\n".  }..
7fc0: 20 20 73 65 74 20 66 64 20 5b 6f 70 65 6e 20 24    set fd [open $
7fd0: 66 69 6c 65 6e 61 6d 65 20 77 5d 0a 20 20 70 75  filename w].  pu
7fe0: 74 73 20 24 66 64 20 22 42 45 47 49 4e 3b 20 24  ts $fd "BEGIN; $
7ff0: 7b 74 62 6c 7d 24 7b 74 62 6c 32 7d 24 7b 74 62  {tbl}${tbl2}${tb
8000: 6c 33 7d 24 7b 73 71 6c 7d 20 3b 20 43 4f 4d 4d  l3}${sql} ; COMM
8010: 49 54 3b 22 0a 20 20 63 6c 6f 73 65 20 24 66 64  IT;".  close $fd
8020: 0a 7d 0a 0a 23 20 43 6f 70 79 20 66 69 6c 65 20  .}..# Copy file 
8030: 24 66 72 6f 6d 20 69 6e 74 6f 20 24 74 6f 2e 20  $from into $to. 
8040: 54 68 69 73 20 69 73 20 75 73 65 64 20 62 65 63  This is used bec
8050: 61 75 73 65 20 73 6f 6d 65 20 76 65 72 73 69 6f  ause some versio
8060: 6e 73 20 6f 66 0a 23 20 54 43 4c 20 66 6f 72 20  ns of.# TCL for 
8070: 77 69 6e 64 6f 77 73 20 28 6e 6f 74 61 62 6c 79  windows (notably
8080: 20 74 68 65 20 38 2e 34 2e 31 20 62 69 6e 61 72   the 8.4.1 binar
8090: 79 20 70 61 63 6b 61 67 65 20 73 68 69 70 70 65  y package shippe
80a0: 64 20 77 69 74 68 20 74 68 65 0a 23 20 63 75 72  d with the.# cur
80b0: 72 65 6e 74 20 6d 69 6e 67 77 20 72 65 6c 65 61  rent mingw relea
80c0: 73 65 29 20 68 61 76 65 20 61 20 62 72 6f 6b 65  se) have a broke
80d0: 6e 20 22 66 69 6c 65 20 63 6f 70 79 22 20 63 6f  n "file copy" co
80e0: 6d 6d 61 6e 64 2e 0a 23 0a 70 72 6f 63 20 63 6f  mmand..#.proc co
80f0: 70 79 5f 66 69 6c 65 20 7b 66 72 6f 6d 20 74 6f  py_file {from to
8100: 7d 20 7b 0a 20 20 69 66 20 7b 24 3a 3a 74 63 6c  } {.  if {$::tcl
8110: 5f 70 6c 61 74 66 6f 72 6d 28 70 6c 61 74 66 6f  _platform(platfo
8120: 72 6d 29 3d 3d 22 75 6e 69 78 22 7d 20 7b 0a 20  rm)=="unix"} {. 
8130: 20 20 20 66 69 6c 65 20 63 6f 70 79 20 2d 66 6f     file copy -fo
8140: 72 63 65 20 24 66 72 6f 6d 20 24 74 6f 0a 20 20  rce $from $to.  
8150: 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 65 74  } else {.    set
8160: 20 66 20 5b 6f 70 65 6e 20 24 66 72 6f 6d 5d 0a   f [open $from].
8170: 20 20 20 20 66 63 6f 6e 66 69 67 75 72 65 20 24      fconfigure $
8180: 66 20 2d 74 72 61 6e 73 6c 61 74 69 6f 6e 20 62  f -translation b
8190: 69 6e 61 72 79 0a 20 20 20 20 73 65 74 20 74 20  inary.    set t 
81a0: 5b 6f 70 65 6e 20 24 74 6f 20 77 5d 0a 20 20 20  [open $to w].   
81b0: 20 66 63 6f 6e 66 69 67 75 72 65 20 24 74 20 2d   fconfigure $t -
81c0: 74 72 61 6e 73 6c 61 74 69 6f 6e 20 62 69 6e 61  translation bina
81d0: 72 79 0a 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e  ry.    puts -non
81e0: 65 77 6c 69 6e 65 20 24 74 20 5b 72 65 61 64 20  ewline $t [read 
81f0: 24 66 20 5b 66 69 6c 65 20 73 69 7a 65 20 24 66  $f [file size $f
8200: 72 6f 6d 5d 5d 0a 20 20 20 20 63 6c 6f 73 65 20  rom]].    close 
8210: 24 74 0a 20 20 20 20 63 6c 6f 73 65 20 24 66 0a  $t.    close $f.
8220: 20 20 7d 0a 7d 0a 0a 23 20 44 72 6f 70 20 61 6c    }.}..# Drop al
8230: 6c 20 74 61 62 6c 65 73 20 69 6e 20 64 61 74 61  l tables in data
8240: 62 61 73 65 20 5b 64 62 5d 0a 70 72 6f 63 20 64  base [db].proc d
8250: 72 6f 70 5f 61 6c 6c 5f 74 61 62 6c 65 73 20 7b  rop_all_tables {
8260: 7b 64 62 20 64 62 7d 7d 20 7b 0a 20 20 69 66 63  {db db}} {.  ifc
8270: 61 70 61 62 6c 65 20 74 72 69 67 67 65 72 26 26  apable trigger&&
8280: 66 6f 72 65 69 67 6e 6b 65 79 20 7b 0a 20 20 20  foreignkey {.   
8290: 20 73 65 74 20 70 6b 20 5b 24 64 62 20 6f 6e 65   set pk [$db one
82a0: 20 22 50 52 41 47 4d 41 20 66 6f 72 65 69 67 6e   "PRAGMA foreign
82b0: 5f 6b 65 79 73 22 5d 0a 20 20 20 20 24 64 62 20  _keys"].    $db 
82c0: 65 76 61 6c 20 22 50 52 41 47 4d 41 20 66 6f 72  eval "PRAGMA for
82d0: 65 69 67 6e 5f 6b 65 79 73 20 3d 20 4f 46 46 22  eign_keys = OFF"
82e0: 0a 20 20 7d 0a 20 20 66 6f 72 65 61 63 68 20 7b  .  }.  foreach {
82f0: 69 64 78 20 6e 61 6d 65 20 66 69 6c 65 7d 20 5b  idx name file} [
8300: 64 62 20 65 76 61 6c 20 7b 50 52 41 47 4d 41 20  db eval {PRAGMA 
8310: 64 61 74 61 62 61 73 65 5f 6c 69 73 74 7d 5d 20  database_list}] 
8320: 7b 0a 20 20 20 20 69 66 20 7b 24 69 64 78 3d 3d  {.    if {$idx==
8330: 31 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 6d  1} {.      set m
8340: 61 73 74 65 72 20 73 71 6c 69 74 65 5f 74 65 6d  aster sqlite_tem
8350: 70 5f 6d 61 73 74 65 72 0a 20 20 20 20 7d 20 65  p_master.    } e
8360: 6c 73 65 20 7b 0a 20 20 20 20 20 20 73 65 74 20  lse {.      set 
8370: 6d 61 73 74 65 72 20 24 6e 61 6d 65 2e 73 71 6c  master $name.sql
8380: 69 74 65 5f 6d 61 73 74 65 72 0a 20 20 20 20 7d  ite_master.    }
8390: 0a 20 20 20 20 66 6f 72 65 61 63 68 20 7b 74 20  .    foreach {t 
83a0: 74 79 70 65 7d 20 5b 24 64 62 20 65 76 61 6c 20  type} [$db eval 
83b0: 22 0a 20 20 20 20 20 20 53 45 4c 45 43 54 20 6e  ".      SELECT n
83c0: 61 6d 65 2c 20 74 79 70 65 20 46 52 4f 4d 20 24  ame, type FROM $
83d0: 6d 61 73 74 65 72 0a 20 20 20 20 20 20 57 48 45  master.      WHE
83e0: 52 45 20 74 79 70 65 20 49 4e 28 27 74 61 62 6c  RE type IN('tabl
83f0: 65 27 2c 20 27 76 69 65 77 27 29 20 41 4e 44 20  e', 'view') AND 
8400: 6e 61 6d 65 20 4e 4f 54 20 6c 69 6b 65 20 27 73  name NOT like 's
8410: 71 6c 69 74 65 5f 25 27 0a 20 20 20 20 22 5d 20  qlite_%'.    "] 
8420: 7b 0a 20 20 20 20 20 20 24 64 62 20 65 76 61 6c  {.      $db eval
8430: 20 22 44 52 4f 50 20 24 74 79 70 65 20 24 74 22   "DROP $type $t"
8440: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 63  .    }.  }.  ifc
8450: 61 70 61 62 6c 65 20 74 72 69 67 67 65 72 26 26  apable trigger&&
8460: 66 6f 72 65 69 67 6e 6b 65 79 20 7b 0a 20 20 20  foreignkey {.   
8470: 20 24 64 62 20 65 76 61 6c 20 22 50 52 41 47 4d   $db eval "PRAGM
8480: 41 20 66 6f 72 65 69 67 6e 5f 6b 65 79 73 20 3d  A foreign_keys =
8490: 20 24 70 6b 22 0a 20 20 7d 0a 7d 0a 0a 23 2d 2d   $pk".  }.}..#--
84a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
84b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
84c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
84d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
84e0: 2d 2d 2d 2d 2d 2d 2d 0a 23 20 49 66 20 61 20 74  -------.# If a t
84f0: 65 73 74 20 73 63 72 69 70 74 20 69 73 20 65 78  est script is ex
8500: 65 63 75 74 65 64 20 77 69 74 68 20 67 6c 6f 62  ecuted with glob
8510: 61 6c 20 76 61 72 69 61 62 6c 65 20 24 3a 3a 47  al variable $::G
8520: 28 70 65 72 6d 3a 6e 61 6d 65 29 20 73 65 74 20  (perm:name) set 
8530: 74 6f 0a 23 20 22 77 61 6c 22 2c 20 74 68 65 6e  to.# "wal", then
8540: 20 74 68 65 20 74 65 73 74 73 20 61 72 65 20 72   the tests are r
8550: 75 6e 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 20  un in WAL mode. 
8560: 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 79 20  Otherwise, they 
8570: 73 68 6f 75 6c 64 20 62 65 20 72 75 6e 20 0a 23  should be run .#
8580: 20 69 6e 20 72 6f 6c 6c 62 61 63 6b 20 6d 6f 64   in rollback mod
8590: 65 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  e. The following
85a0: 20 54 63 6c 20 70 72 6f 63 73 20 61 72 65 20 75   Tcl procs are u
85b0: 73 65 64 20 74 6f 20 6d 61 6b 65 20 74 68 69 73  sed to make this
85c0: 20 6c 65 73 73 20 0a 23 20 69 6e 74 72 75 73 69   less .# intrusi
85d0: 76 65 3a 0a 23 0a 23 20 20 20 77 61 6c 5f 73 65  ve:.#.#   wal_se
85e0: 74 5f 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 3f  t_journal_mode ?
85f0: 44 42 3f 0a 23 0a 23 20 20 20 20 20 49 66 20 72  DB?.#.#     If r
8600: 75 6e 6e 69 6e 67 20 61 20 57 41 4c 20 74 65 73  unning a WAL tes
8610: 74 2c 20 65 78 65 63 75 74 65 20 22 50 52 41 47  t, execute "PRAG
8620: 4d 41 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20  MA journal_mode 
8630: 3d 20 77 61 6c 22 20 75 73 69 6e 67 0a 23 20 20  = wal" using.#  
8640: 20 20 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61     connection ha
8650: 6e 64 6c 65 20 44 42 2e 20 4f 74 68 65 72 77 69  ndle DB. Otherwi
8660: 73 65 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64  se, this command
8670: 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 23 0a 23   is a no-op..#.#
8680: 20 20 20 77 61 6c 5f 63 68 65 63 6b 5f 6a 6f 75     wal_check_jou
8690: 72 6e 61 6c 5f 6d 6f 64 65 20 54 45 53 54 4e 41  rnal_mode TESTNA
86a0: 4d 45 20 3f 44 42 3f 0a 23 0a 23 20 20 20 20 20  ME ?DB?.#.#     
86b0: 49 66 20 72 75 6e 6e 69 6e 67 20 61 20 57 41 4c  If running a WAL
86c0: 20 74 65 73 74 2c 20 65 78 65 63 75 74 65 20 61   test, execute a
86d0: 20 74 65 73 74 73 20 63 61 73 65 20 74 68 61 74   tests case that
86e0: 20 66 61 69 6c 73 20 69 66 20 74 68 65 20 6d 61   fails if the ma
86f0: 69 6e 0a 23 20 20 20 20 20 64 61 74 61 62 61 73  in.#     databas
8700: 65 20 66 6f 72 20 63 6f 6e 6e 65 63 74 69 6f 6e  e for connection
8710: 20 68 61 6e 64 6c 65 20 44 42 20 69 73 20 6e 6f   handle DB is no
8720: 74 20 63 75 72 72 65 6e 74 6c 79 20 61 20 57 41  t currently a WA
8730: 4c 20 64 61 74 61 62 61 73 65 2e 0a 23 20 20 20  L database..#   
8740: 20 20 4f 74 68 65 72 77 69 73 65 20 28 69 66 20    Otherwise (if 
8750: 6e 6f 74 20 72 75 6e 6e 69 6e 67 20 61 20 57 41  not running a WA
8760: 4c 20 70 65 72 6d 75 74 61 74 69 6f 6e 29 20 74  L permutation) t
8770: 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a  his is a no-op..
8780: 23 0a 23 20 20 20 77 61 6c 5f 69 73 5f 77 61 6c  #.#   wal_is_wal
8790: 5f 6d 6f 64 65 0a 23 20 20 20 0a 23 20 20 20 20  _mode.#   .#    
87a0: 20 52 65 74 75 72 6e 73 20 74 72 75 65 20 69 66   Returns true if
87b0: 20 74 68 69 73 20 74 65 73 74 20 73 68 6f 75 6c   this test shoul
87c0: 64 20 62 65 20 72 75 6e 20 69 6e 20 57 41 4c 20  d be run in WAL 
87d0: 6d 6f 64 65 2e 20 46 61 6c 73 65 20 6f 74 68 65  mode. False othe
87e0: 72 77 69 73 65 2e 0a 23 20 0a 70 72 6f 63 20 77  rwise..# .proc w
87f0: 61 6c 5f 69 73 5f 77 61 6c 5f 6d 6f 64 65 20 7b  al_is_wal_mode {
8800: 7d 20 7b 0a 20 20 65 78 70 72 20 7b 5b 70 65 72  } {.  expr {[per
8810: 6d 75 74 61 74 69 6f 6e 5d 20 65 71 20 22 77 61  mutation] eq "wa
8820: 6c 22 7d 0a 7d 0a 70 72 6f 63 20 77 61 6c 5f 73  l"}.}.proc wal_s
8830: 65 74 5f 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20  et_journal_mode 
8840: 7b 7b 64 62 20 64 62 7d 7d 20 7b 0a 20 20 69 66  {{db db}} {.  if
8850: 20 7b 20 5b 77 61 6c 5f 69 73 5f 77 61 6c 5f 6d   { [wal_is_wal_m
8860: 6f 64 65 5d 20 7d 20 7b 0a 20 20 20 20 24 64 62  ode] } {.    $db
8870: 20 65 76 61 6c 20 22 50 52 41 47 4d 41 20 6a 6f   eval "PRAGMA jo
8880: 75 72 6e 61 6c 5f 6d 6f 64 65 20 3d 20 57 41 4c  urnal_mode = WAL
8890: 22 0a 20 20 7d 0a 7d 0a 70 72 6f 63 20 77 61 6c  ".  }.}.proc wal
88a0: 5f 63 68 65 63 6b 5f 6a 6f 75 72 6e 61 6c 5f 6d  _check_journal_m
88b0: 6f 64 65 20 7b 74 65 73 74 6e 61 6d 65 20 7b 64  ode {testname {d
88c0: 62 20 64 62 7d 7d 20 7b 0a 20 20 69 66 20 7b 20  b db}} {.  if { 
88d0: 5b 77 61 6c 5f 69 73 5f 77 61 6c 5f 6d 6f 64 65  [wal_is_wal_mode
88e0: 5d 20 7d 20 7b 0a 20 20 20 20 24 64 62 20 65 76  ] } {.    $db ev
88f0: 61 6c 20 7b 20 53 45 4c 45 43 54 20 2a 20 46 52  al { SELECT * FR
8900: 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  OM sqlite_master
8910: 20 7d 0a 20 20 20 20 64 6f 5f 74 65 73 74 20 24   }.    do_test $
8920: 74 65 73 74 6e 61 6d 65 20 5b 6c 69 73 74 20 24  testname [list $
8930: 64 62 20 65 76 61 6c 20 22 50 52 41 47 4d 41 20  db eval "PRAGMA 
8940: 6d 61 69 6e 2e 6a 6f 75 72 6e 61 6c 5f 6d 6f 64  main.journal_mod
8950: 65 22 5d 20 7b 77 61 6c 7d 0a 20 20 7d 0a 7d 0a  e"] {wal}.  }.}.
8960: 0a 70 72 6f 63 20 70 65 72 6d 75 74 61 74 69 6f  .proc permutatio
8970: 6e 20 7b 7d 20 7b 0a 20 20 73 65 74 20 70 65 72  n {} {.  set per
8980: 6d 20 22 22 0a 20 20 63 61 74 63 68 20 7b 73 65  m "".  catch {se
8990: 74 20 70 65 72 6d 20 24 3a 3a 47 28 70 65 72 6d  t perm $::G(perm
89a0: 3a 6e 61 6d 65 29 7d 0a 20 20 73 65 74 20 70 65  :name)}.  set pe
89b0: 72 6d 0a 7d 0a 70 72 6f 63 20 70 72 65 73 71 6c  rm.}.proc presql
89c0: 20 7b 7d 20 7b 0a 20 20 73 65 74 20 70 72 65 73   {} {.  set pres
89d0: 71 6c 20 22 22 0a 20 20 63 61 74 63 68 20 7b 73  ql "".  catch {s
89e0: 65 74 20 70 72 65 73 71 6c 20 24 3a 3a 47 28 70  et presql $::G(p
89f0: 65 72 6d 3a 70 72 65 73 71 6c 29 7d 0a 20 20 73  erm:presql)}.  s
8a00: 65 74 20 70 72 65 73 71 6c 0a 7d 0a 0a 23 2d 2d  et presql.}..#--
8a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8a30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8a40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8a50: 2d 2d 2d 2d 2d 2d 2d 0a 23 0a 70 72 6f 63 20 73  -------.#.proc s
8a60: 6c 61 76 65 5f 74 65 73 74 5f 73 63 72 69 70 74  lave_test_script
8a70: 20 7b 73 63 72 69 70 74 7d 20 7b 0a 0a 20 20 23   {script} {..  #
8a80: 20 43 72 65 61 74 65 20 74 68 65 20 69 6e 74 65   Create the inte
8a90: 72 70 72 65 74 65 72 20 75 73 65 64 20 74 6f 20  rpreter used to 
8aa0: 72 75 6e 20 74 68 65 20 74 65 73 74 20 73 63 72  run the test scr
8ab0: 69 70 74 2e 0a 20 20 69 6e 74 65 72 70 20 63 72  ipt..  interp cr
8ac0: 65 61 74 65 20 74 69 6e 74 65 72 70 0a 0a 20 20  eate tinterp..  
8ad0: 23 20 50 6f 70 75 6c 61 74 65 20 73 6f 6d 65 20  # Populate some 
8ae0: 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73  global variables
8af0: 20 74 68 61 74 20 74 65 73 74 65 72 2e 74 63 6c   that tester.tcl
8b00: 20 65 78 70 65 63 74 73 20 74 6f 20 73 65 65 2e   expects to see.
8b10: 0a 20 20 66 6f 72 65 61 63 68 20 7b 76 61 72 20  .  foreach {var 
8b20: 76 61 6c 75 65 7d 20 5b 6c 69 73 74 20 20 20 20  value} [list    
8b30: 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20            \.    
8b40: 3a 3a 61 72 67 76 30 20 24 3a 3a 61 72 67 76 30  ::argv0 $::argv0
8b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8b60: 20 20 20 20 20 5c 0a 20 20 20 20 3a 3a 61 72 67       \.    ::arg
8b70: 76 20 20 7b 7d 20 20 20 20 20 20 20 20 20 20 20  v  {}           
8b80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8b90: 5c 0a 20 20 20 20 3a 3a 53 4c 41 56 45 20 31 20  \.    ::SLAVE 1 
8ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8bb0: 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 5d             \.  ]
8bc0: 20 7b 0a 20 20 20 20 69 6e 74 65 72 70 20 65 76   {.    interp ev
8bd0: 61 6c 20 74 69 6e 74 65 72 70 20 5b 6c 69 73 74  al tinterp [list
8be0: 20 73 65 74 20 24 76 61 72 20 24 76 61 6c 75 65   set $var $value
8bf0: 5d 0a 20 20 7d 0a 0a 20 20 23 20 54 68 65 20 61  ].  }..  # The a
8c00: 6c 69 61 73 20 75 73 65 64 20 74 6f 20 61 63 63  lias used to acc
8c10: 65 73 73 20 74 68 65 20 67 6c 6f 62 61 6c 20 74  ess the global t
8c20: 65 73 74 20 63 6f 75 6e 74 65 72 73 2e 0a 20 20  est counters..  
8c30: 74 69 6e 74 65 72 70 20 61 6c 69 61 73 20 73 65  tinterp alias se
8c40: 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 20 73  t_test_counter s
8c50: 65 74 5f 74 65 73 74 5f 63 6f 75 6e 74 65 72 0a  et_test_counter.
8c60: 0a 20 20 23 20 53 65 74 20 75 70 20 74 68 65 20  .  # Set up the 
8c70: 3a 3a 63 6d 64 6c 69 6e 65 61 72 67 20 61 72 72  ::cmdlinearg arr
8c80: 61 79 20 69 6e 20 74 68 65 20 73 6c 61 76 65 2e  ay in the slave.
8c90: 0a 20 20 69 6e 74 65 72 70 20 65 76 61 6c 20 74  .  interp eval t
8ca0: 69 6e 74 65 72 70 20 5b 6c 69 73 74 20 61 72 72  interp [list arr
8cb0: 61 79 20 73 65 74 20 3a 3a 63 6d 64 6c 69 6e 65  ay set ::cmdline
8cc0: 61 72 67 20 5b 61 72 72 61 79 20 67 65 74 20 3a  arg [array get :
8cd0: 3a 63 6d 64 6c 69 6e 65 61 72 67 5d 5d 0a 0a 20  :cmdlinearg]].. 
8ce0: 20 23 20 53 65 74 20 75 70 20 74 68 65 20 3a 3a   # Set up the ::
8cf0: 47 20 61 72 72 61 79 20 69 6e 20 74 68 65 20 73  G array in the s
8d00: 6c 61 76 65 2e 0a 20 20 69 6e 74 65 72 70 20 65  lave..  interp e
8d10: 76 61 6c 20 74 69 6e 74 65 72 70 20 5b 6c 69 73  val tinterp [lis
8d20: 74 20 61 72 72 61 79 20 73 65 74 20 3a 3a 47 20  t array set ::G 
8d30: 5b 61 72 72 61 79 20 67 65 74 20 3a 3a 47 5d 5d  [array get ::G]]
8d40: 0a 0a 20 20 23 20 4c 6f 61 64 20 74 68 65 20 76  ..  # Load the v
8d50: 61 72 69 6f 75 73 20 74 65 73 74 20 69 6e 74 65  arious test inte
8d60: 72 66 61 63 65 73 20 69 6d 70 6c 65 6d 65 6e 74  rfaces implement
8d70: 65 64 20 69 6e 20 43 2e 0a 20 20 6c 6f 61 64 5f  ed in C..  load_
8d80: 74 65 73 74 66 69 78 74 75 72 65 5f 65 78 74 65  testfixture_exte
8d90: 6e 73 69 6f 6e 73 20 74 69 6e 74 65 72 70 0a 0a  nsions tinterp..
8da0: 20 20 23 20 52 75 6e 20 74 68 65 20 74 65 73 74    # Run the test
8db0: 20 73 63 72 69 70 74 2e 0a 20 20 69 6e 74 65 72   script..  inter
8dc0: 70 20 65 76 61 6c 20 74 69 6e 74 65 72 70 20 24  p eval tinterp $
8dd0: 73 63 72 69 70 74 0a 0a 20 20 23 20 43 68 65 63  script..  # Chec
8de0: 6b 20 69 66 20 74 68 65 20 69 6e 74 65 72 70 72  k if the interpr
8df0: 65 74 65 72 20 63 61 6c 6c 20 5b 72 75 6e 5f 74  eter call [run_t
8e00: 68 72 65 61 64 5f 74 65 73 74 73 5d 0a 20 20 69  hread_tests].  i
8e10: 66 20 7b 20 5b 69 6e 74 65 72 70 20 65 76 61 6c  f { [interp eval
8e20: 20 74 69 6e 74 65 72 70 20 7b 69 6e 66 6f 20 65   tinterp {info e
8e30: 78 69 73 74 73 20 3a 3a 72 75 6e 5f 74 68 72 65  xists ::run_thre
8e40: 61 64 5f 74 65 73 74 73 5f 63 61 6c 6c 65 64 7d  ad_tests_called}
8e50: 5d 20 7d 20 7b 0a 20 20 20 20 73 65 74 20 3a 3a  ] } {.    set ::
8e60: 72 75 6e 5f 74 68 72 65 61 64 5f 74 65 73 74 73  run_thread_tests
8e70: 5f 63 61 6c 6c 65 64 20 31 0a 20 20 7d 0a 0a 20  _called 1.  }.. 
8e80: 20 23 20 44 65 6c 65 74 65 20 74 68 65 20 69 6e   # Delete the in
8e90: 74 65 72 70 72 65 74 65 72 20 75 73 65 64 20 74  terpreter used t
8ea0: 6f 20 72 75 6e 20 74 68 65 20 74 65 73 74 20 73  o run the test s
8eb0: 63 72 69 70 74 2e 0a 20 20 69 6e 74 65 72 70 20  cript..  interp 
8ec0: 64 65 6c 65 74 65 20 74 69 6e 74 65 72 70 0a 7d  delete tinterp.}
8ed0: 0a 0a 70 72 6f 63 20 73 6c 61 76 65 5f 74 65 73  ..proc slave_tes
8ee0: 74 5f 66 69 6c 65 20 7b 7a 46 69 6c 65 7d 20 7b  t_file {zFile} {
8ef0: 0a 20 20 73 65 74 20 74 61 69 6c 20 5b 66 69 6c  .  set tail [fil
8f00: 65 20 74 61 69 6c 20 24 7a 46 69 6c 65 5d 0a 0a  e tail $zFile]..
8f10: 20 20 23 20 52 65 6d 65 6d 62 65 72 20 74 68 65    # Remember the
8f20: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 68   value of the sh
8f30: 61 72 65 64 2d 63 61 63 68 65 20 73 65 74 74 69  ared-cache setti
8f40: 6e 67 2e 20 53 6f 20 74 68 61 74 20 69 74 20 69  ng. So that it i
8f50: 73 20 70 6f 73 73 69 62 6c 65 0a 20 20 23 20 74  s possible.  # t
8f60: 6f 20 63 68 65 63 6b 20 61 66 74 65 72 77 61 72  o check afterwar
8f70: 64 73 20 74 68 61 74 20 69 74 20 77 61 73 20 6e  ds that it was n
8f80: 6f 74 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74  ot modified by t
8f90: 68 65 20 74 65 73 74 20 73 63 72 69 70 74 2e 0a  he test script..
8fa0: 20 20 23 0a 20 20 69 66 63 61 70 61 62 6c 65 20    #.  ifcapable 
8fb0: 73 68 61 72 65 64 5f 63 61 63 68 65 20 7b 20 73  shared_cache { s
8fc0: 65 74 20 73 63 73 20 5b 73 71 6c 69 74 65 33 5f  et scs [sqlite3_
8fd0: 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 61  enable_shared_ca
8fe0: 63 68 65 5d 20 7d 0a 0a 20 20 23 20 52 75 6e 20  che] }..  # Run 
8ff0: 74 68 65 20 74 65 73 74 20 73 63 72 69 70 74 20  the test script 
9000: 69 6e 20 61 20 73 6c 61 76 65 20 69 6e 74 65 72  in a slave inter
9010: 70 72 65 74 65 72 2e 0a 20 20 23 0a 20 20 75 6e  preter..  #.  un
9020: 73 65 74 20 2d 6e 6f 63 6f 6d 70 6c 61 69 6e 20  set -nocomplain 
9030: 3a 3a 72 75 6e 5f 74 68 72 65 61 64 5f 74 65 73  ::run_thread_tes
9040: 74 73 5f 63 61 6c 6c 65 64 0a 20 20 72 65 73 65  ts_called.  rese
9050: 74 5f 70 72 6e 67 5f 73 74 61 74 65 0a 20 20 73  t_prng_state.  s
9060: 65 74 20 3a 3a 73 71 6c 69 74 65 5f 6f 70 65 6e  et ::sqlite_open
9070: 5f 66 69 6c 65 5f 63 6f 75 6e 74 20 30 0a 20 20  _file_count 0.  
9080: 73 65 74 20 74 69 6d 65 20 5b 74 69 6d 65 20 7b  set time [time {
9090: 20 73 6c 61 76 65 5f 74 65 73 74 5f 73 63 72 69   slave_test_scri
90a0: 70 74 20 5b 6c 69 73 74 20 73 6f 75 72 63 65 20  pt [list source 
90b0: 24 7a 46 69 6c 65 5d 20 7d 5d 0a 20 20 73 65 74  $zFile] }].  set
90c0: 20 6d 73 20 5b 65 78 70 72 20 5b 6c 69 6e 64 65   ms [expr [linde
90d0: 78 20 24 74 69 6d 65 20 30 5d 20 2f 20 31 30 30  x $time 0] / 100
90e0: 30 5d 0a 0a 20 20 23 20 54 65 73 74 20 74 68 61  0]..  # Test tha
90f0: 74 20 61 6c 6c 20 66 69 6c 65 73 20 6f 70 65 6e  t all files open
9100: 65 64 20 62 79 20 74 68 65 20 74 65 73 74 20 73  ed by the test s
9110: 63 72 69 70 74 20 77 65 72 65 20 63 6c 6f 73 65  cript were close
9120: 64 2e 20 4f 6d 69 74 20 74 68 69 73 0a 20 20 23  d. Omit this.  #
9130: 20 69 66 20 74 68 65 20 74 65 73 74 20 73 63 72   if the test scr
9140: 69 70 74 20 68 61 73 20 22 74 68 72 65 61 64 22  ipt has "thread"
9150: 20 69 6e 20 69 74 73 20 6e 61 6d 65 2e 20 54 68   in its name. Th
9160: 65 20 6f 70 65 6e 20 66 69 6c 65 20 63 6f 75 6e  e open file coun
9170: 74 65 72 0a 20 20 23 20 69 73 20 6e 6f 74 20 74  ter.  # is not t
9180: 68 72 65 61 64 2d 73 61 66 65 2e 0a 20 20 23 0a  hread-safe..  #.
9190: 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73    if {[info exis
91a0: 74 73 20 3a 3a 72 75 6e 5f 74 68 72 65 61 64 5f  ts ::run_thread_
91b0: 74 65 73 74 73 5f 63 61 6c 6c 65 64 5d 3d 3d 30  tests_called]==0
91c0: 7d 20 7b 0a 20 20 20 20 64 6f 5f 74 65 73 74 20  } {.    do_test 
91d0: 24 7b 74 61 69 6c 7d 2d 63 6c 6f 73 65 61 6c 6c  ${tail}-closeall
91e0: 66 69 6c 65 73 20 7b 20 65 78 70 72 20 7b 24 3a  files { expr {$:
91f0: 3a 73 71 6c 69 74 65 5f 6f 70 65 6e 5f 66 69 6c  :sqlite_open_fil
9200: 65 5f 63 6f 75 6e 74 3e 30 7d 20 7d 20 7b 30 7d  e_count>0} } {0}
9210: 0a 20 20 7d 0a 20 20 73 65 74 20 3a 3a 73 71 6c  .  }.  set ::sql
9220: 69 74 65 5f 6f 70 65 6e 5f 66 69 6c 65 5f 63 6f  ite_open_file_co
9230: 75 6e 74 20 30 0a 0a 20 20 23 20 54 65 73 74 20  unt 0..  # Test 
9240: 74 68 61 74 20 74 68 65 20 67 6c 6f 62 61 6c 20  that the global 
9250: 22 73 68 61 72 65 64 2d 63 61 63 68 65 22 20 73  "shared-cache" s
9260: 65 74 74 69 6e 67 20 77 61 73 20 6e 6f 74 20 61  etting was not a
9270: 6c 74 65 72 65 64 20 62 79 20 0a 20 20 23 20 74  ltered by .  # t
9280: 68 65 20 74 65 73 74 20 73 63 72 69 70 74 2e 0a  he test script..
9290: 20 20 23 0a 20 20 69 66 63 61 70 61 62 6c 65 20    #.  ifcapable 
92a0: 73 68 61 72 65 64 5f 63 61 63 68 65 20 7b 20 0a  shared_cache { .
92b0: 20 20 20 20 73 65 74 20 72 65 73 20 5b 65 78 70      set res [exp
92c0: 72 20 7b 5b 73 71 6c 69 74 65 33 5f 65 6e 61 62  r {[sqlite3_enab
92d0: 6c 65 5f 73 68 61 72 65 64 5f 63 61 63 68 65 5d  le_shared_cache]
92e0: 20 3d 3d 20 24 73 63 73 7d 5d 0a 20 20 20 20 64   == $scs}].    d
92f0: 6f 5f 74 65 73 74 20 24 7b 74 61 69 6c 7d 2d 73  o_test ${tail}-s
9300: 68 61 72 65 64 63 61 63 68 65 73 65 74 74 69 6e  haredcachesettin
9310: 67 20 5b 6c 69 73 74 20 73 65 74 20 7b 7d 20 24  g [list set {} $
9320: 72 65 73 5d 20 31 0a 20 20 7d 0a 0a 20 20 23 20  res] 1.  }..  # 
9330: 41 64 64 20 73 6f 6d 65 20 69 6e 66 6f 20 74 6f  Add some info to
9340: 20 74 68 65 20 6f 75 74 70 75 74 2e 0a 20 20 23   the output..  #
9350: 0a 20 20 70 75 74 73 20 22 54 69 6d 65 3a 20 24  .  puts "Time: $
9360: 74 61 69 6c 20 24 6d 73 20 6d 73 22 0a 20 20 73  tail $ms ms".  s
9370: 68 6f 77 5f 6d 65 6d 73 74 61 74 73 0a 7d 0a 0a  how_memstats.}..
9380: 23 20 4f 70 65 6e 20 61 20 6e 65 77 20 63 6f 6e  # Open a new con
9390: 6e 65 63 74 69 6f 6e 20 6f 6e 20 64 61 74 61 62  nection on datab
93a0: 61 73 65 20 74 65 73 74 2e 64 62 20 61 6e 64 20  ase test.db and 
93b0: 65 78 65 63 75 74 65 20 74 68 65 20 53 51 4c 20  execute the SQL 
93c0: 73 63 72 69 70 74 0a 23 20 73 75 70 70 6c 69 65  script.# supplie
93d0: 64 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74  d as an argument
93e0: 2e 20 42 65 66 6f 72 65 20 72 65 74 75 72 6e 69  . Before returni
93f0: 6e 67 2c 20 63 6c 6f 73 65 20 74 68 65 20 6e 65  ng, close the ne
9400: 77 20 63 6f 6e 65 63 74 69 6f 6e 20 61 6e 64 0a  w conection and.
9410: 23 20 72 65 73 74 6f 72 65 20 74 68 65 20 34 20  # restore the 4 
9420: 62 79 74 65 20 66 69 65 6c 64 73 20 73 74 61 72  byte fields star
9430: 74 69 6e 67 20 61 74 20 68 65 61 64 65 72 20 6f  ting at header o
9440: 66 66 73 65 74 73 20 32 38 2c 20 39 32 20 61 6e  ffsets 28, 92 an
9450: 64 20 39 36 0a 23 20 74 6f 20 74 68 65 20 76 61  d 96.# to the va
9460: 6c 75 65 73 20 74 68 65 79 20 68 65 6c 64 20 62  lues they held b
9470: 65 66 6f 72 65 20 74 68 65 20 53 51 4c 20 77 61  efore the SQL wa
9480: 73 20 65 78 65 63 75 74 65 64 2e 20 54 68 69 73  s executed. This
9490: 20 73 69 6d 75 6c 61 74 65 73 0a 23 20 61 20 77   simulates.# a w
94a0: 72 69 74 65 20 62 79 20 61 20 70 72 65 2d 33 2e  rite by a pre-3.
94b0: 37 2e 30 20 63 6c 69 65 6e 74 2e 0a 23 0a 70 72  7.0 client..#.pr
94c0: 6f 63 20 73 71 6c 33 36 32 33 31 20 7b 73 71 6c  oc sql36231 {sql
94d0: 7d 20 7b 0a 20 20 73 65 74 20 42 20 5b 68 65 78  } {.  set B [hex
94e0: 69 6f 5f 72 65 61 64 20 74 65 73 74 2e 64 62 20  io_read test.db 
94f0: 39 32 20 38 5d 0a 20 20 73 65 74 20 41 20 5b 68  92 8].  set A [h
9500: 65 78 69 6f 5f 72 65 61 64 20 74 65 73 74 2e 64  exio_read test.d
9510: 62 20 32 38 20 34 5d 0a 20 20 73 71 6c 69 74 65  b 28 4].  sqlite
9520: 33 20 64 62 33 36 32 33 31 20 74 65 73 74 2e 64  3 db36231 test.d
9530: 62 0a 20 20 63 61 74 63 68 20 7b 20 64 62 33 36  b.  catch { db36
9540: 32 33 31 20 66 75 6e 63 20 61 5f 73 74 72 69 6e  231 func a_strin
9550: 67 20 61 5f 73 74 72 69 6e 67 20 7d 0a 20 20 65  g a_string }.  e
9560: 78 65 63 73 71 6c 20 24 73 71 6c 20 64 62 33 36  xecsql $sql db36
9570: 32 33 31 0a 20 20 64 62 33 36 32 33 31 20 63 6c  231.  db36231 cl
9580: 6f 73 65 0a 20 20 68 65 78 69 6f 5f 77 72 69 74  ose.  hexio_writ
9590: 65 20 74 65 73 74 2e 64 62 20 32 38 20 24 41 0a  e test.db 28 $A.
95a0: 20 20 68 65 78 69 6f 5f 77 72 69 74 65 20 74 65    hexio_write te
95b0: 73 74 2e 64 62 20 39 32 20 24 42 0a 20 20 72 65  st.db 92 $B.  re
95c0: 74 75 72 6e 20 22 22 0a 7d 0a 0a 23 20 49 66 20  turn "".}..# If 
95d0: 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 63  the library is c
95e0: 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65  ompiled with the
95f0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f   SQLITE_DEFAULT_
9600: 41 55 54 4f 56 41 43 55 55 4d 20 6d 61 63 72 6f  AUTOVACUUM macro
9610: 20 73 65 74 0a 23 20 74 6f 20 6e 6f 6e 2d 7a 65   set.# to non-ze
9620: 72 6f 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65  ro, then set the
9630: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65   global variable
9640: 20 24 41 55 54 4f 56 41 43 55 55 4d 20 74 6f 20   $AUTOVACUUM to 
9650: 31 2e 0a 73 65 74 20 41 55 54 4f 56 41 43 55 55  1..set AUTOVACUU
9660: 4d 20 24 73 71 6c 69 74 65 5f 6f 70 74 69 6f 6e  M $sqlite_option
9670: 73 28 64 65 66 61 75 6c 74 5f 61 75 74 6f 76 61  s(default_autova
9680: 63 75 75 6d 29 0a 0a 73 6f 75 72 63 65 20 24 74  cuum)..source $t
9690: 65 73 74 64 69 72 2f 74 68 72 65 61 64 5f 63 6f  estdir/thread_co
96a0: 6d 6d 6f 6e 2e 74 63 6c 0a                       mmon.tcl.