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

Artifact 87b2fca50cbe8b400e1443b2c73693e18d9911cb:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
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 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66  ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69  ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65  te library.  The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69   routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d  s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d  ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  er interface to 
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f  the library.  Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68  utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72  er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79   internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75   SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63  ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f  essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a  f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63  *.** $Id: main.c
0270: 2c 76 20 31 2e 34 34 20 32 30 30 31 2f 31 30 2f  ,v 1.44 2001/10/
0280: 30 38 20 31 33 3a 32 32 3a 33 33 20 64 72 68 20  08 13:22:33 drh 
0290: 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64  Exp $.*/.#includ
02a0: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
02b0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a  #include "os.h".
02c0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  ./*.** This is t
02d0: 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74  he callback rout
02e0: 69 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65  ine for the code
02f0: 20 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65   that initialize
0300: 73 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73  s the.** databas
0310: 65 2e 20 20 53 65 65 20 73 71 6c 69 74 65 49 6e  e.  See sqliteIn
0320: 69 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61  it() below for a
0330: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
0340: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63  ation..**.** Eac
0350: 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61  h callback conta
0360: 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ins the followin
0370: 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a  g information:.*
0380: 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d  *.**     argv[0]
0390: 20 3d 20 22 6d 65 74 61 22 20 6f 72 20 22 74 61   = "meta" or "ta
03a0: 62 6c 65 22 20 6f 72 20 22 69 6e 64 65 78 22 0a  ble" or "index".
03b0: 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d 20 3d  **     argv[1] =
03c0: 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 20   table or index 
03d0: 6e 61 6d 65 20 6f 72 20 6d 65 74 61 20 73 74 61  name or meta sta
03e0: 74 65 6d 65 6e 74 20 74 79 70 65 2e 0a 2a 2a 20  tement type..** 
03f0: 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 72 6f      argv[2] = ro
0400: 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66  ot page number f
0410: 6f 72 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65  or table or inde
0420: 78 2e 20 20 4e 55 4c 4c 20 66 6f 72 20 6d 65 74  x.  NULL for met
0430: 61 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 33  a..**     argv[3
0440: 5d 20 3d 20 53 51 4c 20 63 72 65 61 74 65 20 73  ] = SQL create s
0450: 74 61 74 65 6d 65 6e 74 20 66 6f 72 20 74 68 65  tatement for the
0460: 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a   table or index.
0470: 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  **.*/.static int
0480: 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 28 76 6f   sqliteOpenCb(vo
0490: 69 64 20 2a 70 44 62 2c 20 69 6e 74 20 61 72 67  id *pDb, int arg
04a0: 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20  c, char **argv, 
04b0: 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61 6d 65  char **azColName
04c0: 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 20  ){.  sqlite *db 
04d0: 3d 20 28 73 71 6c 69 74 65 2a 29 70 44 62 3b 0a  = (sqlite*)pDb;.
04e0: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a    Parse sParse;.
04f0: 20 20 69 6e 74 20 6e 45 72 72 20 3d 20 30 3b 0a    int nErr = 0;.
0500: 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 44 6f 20 73  .  /* TODO: Do s
0510: 6f 6d 65 20 76 61 6c 69 64 69 74 79 20 63 68 65  ome validity che
0520: 63 6b 73 20 6f 6e 20 61 6c 6c 20 66 69 65 6c 64  cks on all field
0530: 73 2e 20 20 49 6e 20 70 61 72 74 69 63 75 6c 61  s.  In particula
0540: 72 2c 0a 20 20 2a 2a 20 6d 61 6b 65 20 73 75 72  r,.  ** make sur
0550: 65 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f 74 20  e fields do not 
0560: 63 6f 6e 74 61 69 6e 20 4e 55 4c 4c 73 2e 20 4f  contain NULLs. O
0570: 74 68 65 72 77 69 73 65 20 77 65 20 6d 69 67 68  therwise we migh
0580: 74 20 63 6f 72 65 0a 20 20 2a 2a 20 77 68 65 6e  t core.  ** when
0590: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 69   attempting to i
05a0: 6e 69 74 69 61 6c 69 7a 65 20 66 72 6f 6d 20 61  nitialize from a
05b0: 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 61 73   corrupt databas
05c0: 65 20 66 69 6c 65 2e 20 2a 2f 0a 0a 20 20 61 73  e file. */..  as
05d0: 73 65 72 74 28 20 61 72 67 63 3d 3d 34 20 29 3b  sert( argc==4 );
05e0: 0a 20 20 73 77 69 74 63 68 28 20 61 72 67 76 5b  .  switch( argv[
05f0: 30 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 63 61 73  0][0] ){.    cas
0600: 65 20 27 6d 27 3a 20 7b 20 20 2f 2a 20 4d 65 74  e 'm': {  /* Met
0610: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f  a information */
0620: 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 63 6d  .      if( strcm
0630: 70 28 61 72 67 76 5b 31 5d 2c 22 66 69 6c 65 2d  p(argv[1],"file-
0640: 66 6f 72 6d 61 74 22 29 3d 3d 30 20 29 7b 0a 20  format")==0 ){. 
0650: 20 20 20 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f         db->file_
0660: 66 6f 72 6d 61 74 20 3d 20 61 74 6f 69 28 61 72  format = atoi(ar
0670: 67 76 5b 33 5d 29 3b 0a 20 20 20 20 20 20 7d 65  gv[3]);.      }e
0680: 6c 73 65 20 69 66 28 20 73 74 72 63 6d 70 28 61  lse if( strcmp(a
0690: 72 67 76 5b 31 5d 2c 22 73 63 68 65 6d 61 2d 63  rgv[1],"schema-c
06a0: 6f 6f 6b 69 65 22 29 3d 3d 30 20 29 7b 0a 20 20  ookie")==0 ){.  
06b0: 20 20 20 20 20 20 64 62 2d 3e 73 63 68 65 6d 61        db->schema
06c0: 5f 63 6f 6f 6b 69 65 20 3d 20 61 74 6f 69 28 61  _cookie = atoi(a
06d0: 72 67 76 5b 33 5d 29 3b 0a 20 20 20 20 20 20 20  rgv[3]);.       
06e0: 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65   db->next_cookie
06f0: 20 3d 20 64 62 2d 3e 73 63 68 65 6d 61 5f 63 6f   = db->schema_co
0700: 6f 6b 69 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20  okie;.      }.  
0710: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
0720: 0a 20 20 20 20 63 61 73 65 20 27 69 27 3a 0a 20  .    case 'i':. 
0730: 20 20 20 63 61 73 65 20 27 74 27 3a 20 7b 20 20     case 't': {  
0740: 2f 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 20  /* CREATE TABLE 
0750: 20 61 6e 64 20 43 52 45 41 54 45 20 49 4e 44 45   and CREATE INDE
0760: 58 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a  X statements */.
0770: 20 20 20 20 20 20 69 66 28 20 61 72 67 76 5b 33        if( argv[3
0780: 5d 20 26 26 20 61 72 67 76 5b 33 5d 5b 30 5d 20  ] && argv[3][0] 
0790: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 43 61  ){.        /* Ca
07a0: 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 74 6f  ll the parser to
07b0: 20 70 72 6f 63 65 73 73 20 61 20 43 52 45 41 54   process a CREAT
07c0: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
07d0: 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e  E INDEX statemen
07e0: 74 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 42 75  t..        ** Bu
07f0: 74 20 62 65 63 61 75 73 65 20 73 50 61 72 73 65  t because sParse
0800: 2e 69 6e 69 74 46 6c 61 67 20 69 73 20 73 65 74  .initFlag is set
0810: 20 74 6f 20 31 2c 20 6e 6f 20 56 44 42 45 20 63   to 1, no VDBE c
0820: 6f 64 65 20 69 73 20 67 65 6e 65 72 61 74 65 64  ode is generated
0830: 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 72 20 65  .        ** or e
0840: 78 65 63 75 74 65 64 2e 20 20 41 6c 6c 20 74 68  xecuted.  All th
0850: 65 20 70 61 72 73 65 72 20 64 6f 65 73 20 69 73  e parser does is
0860: 20 62 75 69 6c 64 20 74 68 65 20 69 6e 74 65 72   build the inter
0870: 6e 61 6c 20 64 61 74 61 0a 20 20 20 20 20 20 20  nal data.       
0880: 20 2a 2a 20 73 74 72 75 63 74 75 72 65 73 20 74   ** structures t
0890: 68 61 74 20 64 65 73 63 72 69 62 65 20 74 68 65  hat describe the
08a0: 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e   table or index.
08b0: 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  .        */.    
08c0: 20 20 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72      memset(&sPar
08d0: 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50  se, 0, sizeof(sP
08e0: 61 72 73 65 29 29 3b 0a 20 20 20 20 20 20 20 20  arse));.        
08f0: 73 50 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a  sParse.db = db;.
0900: 20 20 20 20 20 20 20 20 73 50 61 72 73 65 2e 69          sParse.i
0910: 6e 69 74 46 6c 61 67 20 3d 20 31 3b 0a 20 20 20  nitFlag = 1;.   
0920: 20 20 20 20 20 73 50 61 72 73 65 2e 6e 65 77 54       sParse.newT
0930: 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b  num = atoi(argv[
0940: 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 6e 45 72  2]);.        nEr
0950: 72 20 3d 20 73 71 6c 69 74 65 52 75 6e 50 61 72  r = sqliteRunPar
0960: 73 65 72 28 26 73 50 61 72 73 65 2c 20 61 72 67  ser(&sParse, arg
0970: 76 5b 33 5d 2c 20 30 29 3b 0a 20 20 20 20 20 20  v[3], 0);.      
0980: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f  }else{.        /
0990: 2a 20 49 66 20 74 68 65 20 53 51 4c 20 63 6f 6c  * If the SQL col
09a0: 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74 20  umn is blank it 
09b0: 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 61 6e  means this is an
09c0: 20 69 6e 64 65 78 20 74 68 61 74 0a 20 20 20 20   index that.    
09d0: 20 20 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74      ** was creat
09e0: 65 64 20 74 6f 20 62 65 20 74 68 65 20 50 52 49  ed to be the PRI
09f0: 4d 41 52 59 20 4b 45 59 20 6f 72 20 74 6f 20 66  MARY KEY or to f
0a00: 75 6c 66 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a  ulfill a UNIQUE.
0a10: 20 20 20 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74          ** const
0a20: 72 61 69 6e 74 20 6f 72 20 61 20 43 52 45 41 54  raint or a CREAT
0a30: 45 20 54 41 42 4c 45 2e 20 20 54 68 65 20 69 6e  E TABLE.  The in
0a40: 64 65 78 20 73 68 6f 75 6c 64 20 68 61 76 65 20  dex should have 
0a50: 61 6c 72 65 61 64 79 0a 20 20 20 20 20 20 20 20  already.        
0a60: 2a 2a 20 62 65 65 6e 20 63 72 65 61 74 65 64 20  ** been created 
0a70: 77 68 65 6e 20 77 65 20 70 72 6f 63 65 73 73 65  when we processe
0a80: 64 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42  d the CREATE TAB
0a90: 4c 45 2e 20 20 41 6c 6c 20 77 65 20 68 61 76 65  LE.  All we have
0aa0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 64  .        ** to d
0ab0: 6f 20 68 65 72 65 20 69 73 20 72 65 63 6f 72 64  o here is record
0ac0: 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 2e 0a   the root page..
0ad0: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20          */.     
0ae0: 20 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78     Index *pIndex
0af0: 20 3d 20 73 71 6c 69 74 65 46 69 6e 64 49 6e 64   = sqliteFindInd
0b00: 65 78 28 64 62 2c 20 61 72 67 76 5b 31 5d 29 3b  ex(db, argv[1]);
0b10: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 49 6e  .        if( pIn
0b20: 64 65 78 3d 3d 30 20 7c 7c 20 70 49 6e 64 65 78  dex==0 || pIndex
0b30: 2d 3e 74 6e 75 6d 21 3d 30 20 29 7b 0a 20 20 20  ->tnum!=0 ){.   
0b40: 20 20 20 20 20 20 20 6e 45 72 72 2b 2b 3b 0a 20         nErr++;. 
0b50: 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20         }else{.  
0b60: 20 20 20 20 20 20 20 20 70 49 6e 64 65 78 2d 3e          pIndex->
0b70: 74 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76  tnum = atoi(argv
0b80: 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  [2]);.        }.
0b90: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72        }.      br
0ba0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64  eak;.    }.    d
0bb0: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20  efault: {.      
0bc0: 2f 2a 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20  /* This can not 
0bd0: 68 61 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20  happen! */.     
0be0: 20 6e 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20   nErr = 1;.     
0bf0: 20 61 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30   assert( nErr==0
0c00: 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   );.    }.  }.  
0c10: 72 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a  return nErr;.}..
0c20: 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f  /*.** Attempt to
0c30: 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61   read the databa
0c40: 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e  se schema and in
0c50: 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61  itialize interna
0c60: 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74  l.** data struct
0c70: 75 72 65 73 2e 20 20 52 65 74 75 72 6e 20 6f 6e  ures.  Return on
0c80: 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f  e of the SQLITE_
0c90: 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74 6f 0a   error codes to.
0ca0: 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75 63 63  ** indicate succ
0cb0: 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e 0a  ess or failure..
0cc0: 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20  **.** After the 
0cd0: 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69 74  database is init
0ce0: 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c  ialized, the SQL
0cf0: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a  ITE_Initialized.
0d00: 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e  ** bit is set in
0d10: 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64   the flags field
0d20: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20 73   of the sqlite s
0d30: 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a 2a  tructure.  An.**
0d40: 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65   attempt is made
0d50: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74   to initialize t
0d60: 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20 73  he database as s
0d70: 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73 20  oon as it.** is 
0d80: 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61 74  opened.  If that
0d90: 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73 20   fails (perhaps 
0da0: 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72 20  because another 
0db0: 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20 74  process.** has t
0dc0: 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  he sqlite_master
0dd0: 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20 74   table locked) t
0de0: 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74 65  han another atte
0df0: 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20 74  mpt.** is made t
0e00: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68  he first time th
0e10: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 63  e database is ac
0e20: 63 65 73 73 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  cessed..*/.stati
0e30: 63 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69 74  c int sqliteInit
0e40: 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68 61  (sqlite *db, cha
0e50: 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20  r **pzErrMsg){. 
0e60: 20 56 64 62 65 20 2a 76 64 62 65 3b 0a 20 20 69   Vdbe *vdbe;.  i
0e70: 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 0a 20 20 2a  nt rc;..  /*.  *
0e80: 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61 74  * The master dat
0e90: 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73 20  abase table has 
0ea0: 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b 65  a structure like
0eb0: 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74 61   this.  */.  sta
0ec0: 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72 5f  tic char master_
0ed0: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
0ee0: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 22   "CREATE TABLE "
0ef0: 20 4d 41 53 54 45 52 5f 4e 41 4d 45 20 22 20 28   MASTER_NAME " (
0f00: 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65  \n".     "  type
0f10: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22   text,\n".     "
0f20: 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a    name text,\n".
0f30: 20 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65       "  tbl_name
0f40: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22   text,\n".     "
0f50: 20 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67    rootpage integ
0f60: 65 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73  er,\n".     "  s
0f70: 71 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20  ql text\n".     
0f80: 22 29 22 0a 20 20 3b 0a 0a 20 20 2f 2a 20 54 68  ")".  ;..  /* Th
0f90: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 67  e following prog
0fa0: 72 61 6d 20 69 73 20 75 73 65 64 20 74 6f 20 69  ram is used to i
0fb0: 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e  nitialize the in
0fc0: 74 65 72 6e 61 6c 0a 20 20 2a 2a 20 73 74 72 75  ternal.  ** stru
0fd0: 63 74 75 72 65 20 68 6f 6c 64 69 6e 67 20 74 68  cture holding th
0fe0: 65 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64  e tables and ind
0ff0: 65 78 65 73 20 6f 66 20 74 68 65 20 64 61 74 61  exes of the data
1000: 62 61 73 65 2e 0a 20 20 2a 2a 20 54 68 65 20 64  base..  ** The d
1010: 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 73  atabase contains
1020: 20 61 20 73 70 65 63 69 61 6c 20 74 61 62 6c 65   a special table
1030: 20 6e 61 6d 65 64 20 22 73 71 6c 69 74 65 5f 6d   named "sqlite_m
1040: 61 73 74 65 72 22 0a 20 20 2a 2a 20 64 65 66 69  aster".  ** defi
1050: 6e 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a  ned as follows:.
1060: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 43 52 45    **.  **    CRE
1070: 41 54 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65  ATE TABLE sqlite
1080: 5f 6d 61 73 74 65 72 20 28 0a 20 20 2a 2a 20 20  _master (.  **  
1090: 20 20 20 20 20 20 74 79 70 65 20 20 20 20 20 20        type      
10a0: 20 74 65 78 74 2c 20 20 20 20 2d 2d 20 20 45 69   text,    --  Ei
10b0: 74 68 65 72 20 22 74 61 62 6c 65 22 20 6f 72 20  ther "table" or 
10c0: 22 69 6e 64 65 78 22 20 6f 72 20 22 6d 65 74 61  "index" or "meta
10d0: 22 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 6e 61  ".  **        na
10e0: 6d 65 20 20 20 20 20 20 20 74 65 78 74 2c 20 20  me       text,  
10f0: 20 20 2d 2d 20 20 4e 61 6d 65 20 6f 66 20 74 61    --  Name of ta
1100: 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a 20 20 2a  ble or index.  *
1110: 2a 20 20 20 20 20 20 20 20 74 62 6c 5f 6e 61 6d  *        tbl_nam
1120: 65 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d 20  e   text,    -- 
1130: 20 41 73 73 6f 63 69 61 74 65 64 20 74 61 62 6c   Associated tabl
1140: 65 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 72  e .  **        r
1150: 6f 6f 74 70 61 67 65 20 20 20 69 6e 74 65 67 65  ootpage   intege
1160: 72 2c 20 2d 2d 20 20 54 68 65 20 69 6e 74 65 67  r, --  The integ
1170: 65 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f  er page number o
1180: 66 20 72 6f 6f 74 20 70 61 67 65 0a 20 20 2a 2a  f root page.  **
1190: 20 20 20 20 20 20 20 20 73 71 6c 20 20 20 20 20          sql     
11a0: 20 20 20 74 65 78 74 20 20 20 20 20 2d 2d 20 20     text     --  
11b0: 54 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65  The CREATE state
11c0: 6d 65 6e 74 20 66 6f 72 20 74 68 69 73 20 6f 62  ment for this ob
11d0: 6a 65 63 74 0a 20 20 2a 2a 20 20 20 20 29 3b 0a  ject.  **    );.
11e0: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 73 71    **.  ** The sq
11f0: 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c  lite_master tabl
1200: 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 73 69 6e  e contains a sin
1210: 67 6c 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61  gle entry for ea
1220: 63 68 20 74 61 62 6c 65 0a 20 20 2a 2a 20 61 6e  ch table.  ** an
1230: 64 20 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54  d each index.  T
1240: 68 65 20 22 74 79 70 65 22 20 63 6f 6c 75 6d 6e  he "type" column
1250: 20 74 65 6c 6c 73 20 77 68 65 74 68 65 72 20 74   tells whether t
1260: 68 65 20 65 6e 74 72 79 20 69 73 0a 20 20 2a 2a  he entry is.  **
1270: 20 61 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65   a table or inde
1280: 78 2e 20 20 54 68 65 20 22 6e 61 6d 65 22 20 63  x.  The "name" c
1290: 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 6e 61 6d  olumn is the nam
12a0: 65 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 2e  e of the object.
12b0: 0a 20 20 2a 2a 20 54 68 65 20 22 74 62 6c 5f 6e  .  ** The "tbl_n
12c0: 61 6d 65 22 20 69 73 20 74 68 65 20 6e 61 6d 65  ame" is the name
12d0: 20 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74   of the associat
12e0: 65 64 20 74 61 62 6c 65 2e 20 20 46 6f 72 20 74  ed table.  For t
12f0: 61 62 6c 65 73 2c 0a 20 20 2a 2a 20 74 68 65 20  ables,.  ** the 
1300: 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20  tbl_name column 
1310: 69 73 20 61 6c 77 61 79 73 20 74 68 65 20 73 61  is always the sa
1320: 6d 65 20 61 73 20 6e 61 6d 65 2e 20 20 46 6f 72  me as name.  For
1330: 20 69 6e 64 69 63 65 73 2c 20 74 68 65 0a 20 20   indices, the.  
1340: 2a 2a 20 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75  ** tbl_name colu
1350: 6d 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  mn contains the 
1360: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
1370: 65 20 74 68 61 74 20 74 68 65 20 69 6e 64 65 78  e that the index
1380: 0a 20 20 2a 2a 20 69 6e 64 65 78 65 73 2e 20 20  .  ** indexes.  
1390: 54 68 65 20 22 72 6f 6f 74 70 61 67 65 22 20 63  The "rootpage" c
13a0: 6f 6c 75 6d 6e 20 68 6f 6c 64 73 20 74 68 65 20  olumn holds the 
13b0: 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 72 6f  number of the ro
13c0: 6f 74 20 70 61 67 65 0a 20 20 2a 2a 20 66 6f 72  ot page.  ** for
13d0: 20 74 68 65 20 62 2d 74 72 65 65 20 66 6f 72 20   the b-tree for 
13e0: 74 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  the table or ind
13f0: 65 78 2e 20 20 46 69 6e 61 6c 6c 79 2c 20 74 68  ex.  Finally, th
1400: 65 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 0a 20  e "sql" column. 
1410: 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65   ** contains the
1420: 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f   complete text o
1430: 66 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42  f the CREATE TAB
1440: 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44  LE or CREATE IND
1450: 45 58 0a 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e  EX.  ** statemen
1460: 74 20 74 68 61 74 20 6f 72 69 67 69 6e 61 6c 6c  t that originall
1470: 79 20 63 72 65 61 74 65 64 20 74 68 65 20 74 61  y created the ta
1480: 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 49  ble or index.  I
1490: 66 20 61 6e 20 69 6e 64 65 78 0a 20 20 2a 2a 20  f an index.  ** 
14a0: 77 61 73 20 63 72 65 61 74 65 64 20 74 6f 20 66  was created to f
14b0: 75 6c 66 69 6c 6c 20 61 20 50 52 49 4d 41 52 59  ulfill a PRIMARY
14c0: 20 4b 45 59 20 6f 72 20 55 4e 49 51 55 45 20 63   KEY or UNIQUE c
14d0: 6f 6e 73 74 72 61 69 6e 74 20 6f 6e 20 61 20 74  onstraint on a t
14e0: 61 62 6c 65 2c 0a 20 20 2a 2a 20 74 68 65 6e 20  able,.  ** then 
14f0: 74 68 65 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e  the "sql" column
1500: 20 69 73 20 4e 55 4c 4c 2e 0a 20 20 2a 2a 0a 20   is NULL..  **. 
1510: 20 2a 2a 20 49 66 20 74 68 65 20 22 74 79 70 65   ** If the "type
1520: 22 20 63 6f 6c 75 6d 6e 20 68 61 73 20 74 68 65  " column has the
1530: 20 76 61 6c 75 65 20 22 6d 65 74 61 22 2c 20 74   value "meta", t
1540: 68 65 6e 20 74 68 65 20 22 73 71 6c 22 20 63 6f  hen the "sql" co
1550: 6c 75 6d 6e 0a 20 20 2a 2a 20 63 6f 6e 74 61 69  lumn.  ** contai
1560: 6e 73 20 65 78 74 72 61 20 69 6e 66 6f 72 6d 61  ns extra informa
1570: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 64  tion about the d
1580: 61 74 61 62 61 73 65 2c 20 73 75 63 68 20 61 73  atabase, such as
1590: 20 74 68 65 0a 20 20 2a 2a 20 66 69 6c 65 20 66   the.  ** file f
15a0: 6f 72 6d 61 74 20 76 65 72 73 69 6f 6e 20 6e 75  ormat version nu
15b0: 6d 62 65 72 2e 20 20 41 6c 6c 20 6d 65 74 61 20  mber.  All meta 
15c0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6d 75 73 74  information must
15d0: 20 62 65 20 70 72 6f 63 65 73 73 65 64 0a 20 20   be processed.  
15e0: 2a 2a 20 62 65 66 6f 72 65 20 61 6e 79 20 74 61  ** before any ta
15f0: 62 6c 65 73 20 6f 72 20 69 6e 64 69 63 65 73 20  bles or indices 
1600: 61 72 65 20 63 6f 6e 73 74 72 75 63 74 65 64 2e  are constructed.
1610: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66  .  **.  ** The f
1620: 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 67 72 61 6d  ollowing program
1630: 20 69 6e 76 6f 6b 65 73 20 69 74 73 20 63 61 6c   invokes its cal
1640: 6c 62 61 63 6b 20 6f 6e 20 74 68 65 20 53 51 4c  lback on the SQL
1650: 20 66 6f 72 20 65 61 63 68 0a 20 20 2a 2a 20 74   for each.  ** t
1660: 61 62 6c 65 20 74 68 65 6e 20 67 6f 65 73 20 62  able then goes b
1670: 61 63 6b 20 61 6e 64 20 69 6e 76 6f 6b 65 73 20  ack and invokes 
1680: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 20  the callback on 
1690: 74 68 65 0a 20 20 2a 2a 20 53 51 4c 20 66 6f 72  the.  ** SQL for
16a0: 20 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54 68   each index.  Th
16b0: 65 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 20  e callback will 
16c0: 69 6e 76 6f 6b 65 20 74 68 65 0a 20 20 2a 2a 20  invoke the.  ** 
16d0: 70 61 72 73 65 72 20 74 6f 20 62 75 69 6c 64 20  parser to build 
16e0: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 72 65 70  the internal rep
16f0: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  resentation of t
1700: 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65  he.  ** database
1710: 20 73 63 68 65 6d 65 2e 0a 20 20 2a 2f 0a 20 20   scheme..  */.  
1720: 73 74 61 74 69 63 20 56 64 62 65 4f 70 20 69 6e  static VdbeOp in
1730: 69 74 50 72 6f 67 5b 5d 20 3d 20 7b 0a 20 20 20  itProg[] = {.   
1740: 20 7b 20 4f 50 5f 4f 70 65 6e 2c 20 20 20 20 20   { OP_Open,     
1750: 30 2c 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20 7b  0, 2,  0},.    {
1760: 20 4f 50 5f 52 65 77 69 6e 64 2c 20 20 20 30 2c   OP_Rewind,   0,
1770: 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   0,  0},.    { O
1780: 50 5f 4e 65 78 74 2c 20 20 20 20 20 30 2c 20 31  P_Next,     0, 1
1790: 32 2c 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20  2, 0},          
17a0: 20 2f 2a 20 32 20 2a 2f 0a 20 20 20 20 7b 20 4f   /* 2 */.    { O
17b0: 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 30  P_Column,   0, 0
17c0: 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  ,  0},.    { OP_
17d0: 53 74 72 69 6e 67 2c 20 20 20 30 2c 20 30 2c 20  String,   0, 0, 
17e0: 20 22 6d 65 74 61 22 7d 2c 0a 20 20 20 20 7b 20   "meta"},.    { 
17f0: 4f 50 5f 4e 65 2c 20 20 20 20 20 20 20 30 2c 20  OP_Ne,       0, 
1800: 32 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  2,  0},.    { OP
1810: 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 30 2c  _Column,   0, 0,
1820: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43    0},.    { OP_C
1830: 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 31 2c 20 20  olumn,   0, 1,  
1840: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
1850: 75 6d 6e 2c 20 20 20 30 2c 20 33 2c 20 20 30 7d  umn,   0, 3,  0}
1860: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
1870: 6e 2c 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a  n,   0, 4,  0},.
1880: 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63      { OP_Callbac
1890: 6b 2c 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20 20  k, 4, 0,  0},.  
18a0: 20 20 7b 20 4f 50 5f 47 6f 74 6f 2c 20 20 20 20    { OP_Goto,    
18b0: 20 30 2c 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 2,  0},.    
18c0: 7b 20 4f 50 5f 52 65 77 69 6e 64 2c 20 20 20 30  { OP_Rewind,   0
18d0: 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20 20 20 20  , 0,  0},       
18e0: 20 20 20 20 2f 2a 20 31 32 20 2a 2f 0a 20 20 20      /* 12 */.   
18f0: 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20 20 20   { OP_Next,     
1900: 30 2c 20 32 33 2c 20 30 7d 2c 20 20 20 20 20 20  0, 23, 0},      
1910: 20 20 20 20 20 2f 2a 20 31 33 20 2a 2f 0a 20 20       /* 13 */.  
1920: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1930: 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 0,  0},.    
1940: 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 30  { OP_String,   0
1950: 2c 20 30 2c 20 20 22 74 61 62 6c 65 22 7d 2c 0a  , 0,  "table"},.
1960: 20 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20      { OP_Ne,    
1970: 20 20 20 30 2c 20 31 33 2c 20 30 7d 2c 0a 20 20     0, 13, 0},.  
1980: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1990: 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 0,  0},.    
19a0: 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30  { OP_Column,   0
19b0: 2c 20 31 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20  , 1,  0},.    { 
19c0: 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20  OP_Column,   0, 
19d0: 33 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  3,  0},.    { OP
19e0: 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 34 2c  _Column,   0, 4,
19f0: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43    0},.    { OP_C
1a00: 61 6c 6c 62 61 63 6b 2c 20 34 2c 20 30 2c 20 20  allback, 4, 0,  
1a10: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 47 6f 74  0},.    { OP_Got
1a20: 6f 2c 20 20 20 20 20 30 2c 20 31 33 2c 20 30 7d  o,     0, 13, 0}
1a30: 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77 69 6e  ,.    { OP_Rewin
1a40: 64 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 20  d,   0, 0,  0}, 
1a50: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32 33 20            /* 23 
1a60: 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74  */.    { OP_Next
1a70: 2c 20 20 20 20 20 30 2c 20 33 34 2c 20 30 7d 2c  ,     0, 34, 0},
1a80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32 34             /* 24
1a90: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c   */.    { OP_Col
1aa0: 75 6d 6e 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d  umn,   0, 0,  0}
1ab0: 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e  ,.    { OP_Strin
1ac0: 67 2c 20 20 20 30 2c 20 30 2c 20 20 22 69 6e 64  g,   0, 0,  "ind
1ad0: 65 78 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e  ex"},.    { OP_N
1ae0: 65 2c 20 20 20 20 20 20 20 30 2c 20 32 34 2c 20  e,       0, 24, 
1af0: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c  0},.    { OP_Col
1b00: 75 6d 6e 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d  umn,   0, 0,  0}
1b10: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  ,.    { OP_Colum
1b20: 6e 2c 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a  n,   0, 1,  0},.
1b30: 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c      { OP_Column,
1b40: 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 20     0, 3,  0},.  
1b50: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1b60: 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 4,  0},.    
1b70: 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c 20 34  { OP_Callback, 4
1b80: 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20  , 0,  0},.    { 
1b90: 4f 50 5f 47 6f 74 6f 2c 20 20 20 20 20 30 2c 20  OP_Goto,     0, 
1ba0: 32 34 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  24, 0},.    { OP
1bb0: 5f 53 74 72 69 6e 67 2c 20 20 20 30 2c 20 30 2c  _String,   0, 0,
1bc0: 20 20 22 6d 65 74 61 22 7d 2c 20 20 20 20 20 20    "meta"},      
1bd0: 2f 2a 20 33 34 20 2a 2f 0a 20 20 20 20 7b 20 4f  /* 34 */.    { O
1be0: 50 5f 53 74 72 69 6e 67 2c 20 20 20 30 2c 20 30  P_String,   0, 0
1bf0: 2c 20 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69  ,  "schema-cooki
1c00: 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74  e"},.    { OP_St
1c10: 72 69 6e 67 2c 20 20 20 30 2c 20 30 2c 20 20 30  ring,   0, 0,  0
1c20: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 61 64  },.    { OP_Read
1c30: 43 6f 6f 6b 69 65 2c 30 2c 30 2c 20 20 30 7d 2c  Cookie,0,0,  0},
1c40: 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61  .    { OP_Callba
1c50: 63 6b 2c 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20  ck, 4, 0,  0},. 
1c60: 20 20 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c 20 20     { OP_Close,  
1c70: 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20    0, 0,  0},.   
1c80: 20 7b 20 4f 50 5f 48 61 6c 74 2c 20 20 20 20 20   { OP_Halt,     
1c90: 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 7d 3b 0a  0, 0,  0},.  };.
1ca0: 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 76  .  /* Create a v
1cb0: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74  irtual machine t
1cc0: 6f 20 72 75 6e 20 74 68 65 20 69 6e 69 74 69 61  o run the initia
1cd0: 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 67 72 61 6d  lization program
1ce0: 2e 20 20 52 75 6e 0a 20 20 2a 2a 20 74 68 65 20  .  Run.  ** the 
1cf0: 70 72 6f 67 72 61 6d 2e 20 20 54 68 65 6e 20 64  program.  Then d
1d00: 65 6c 65 74 65 20 74 68 65 20 76 69 72 74 75 61  elete the virtua
1d10: 6c 20 6d 61 63 68 69 6e 65 2e 0a 20 20 2a 2f 0a  l machine..  */.
1d20: 20 20 76 64 62 65 20 3d 20 73 71 6c 69 74 65 56    vdbe = sqliteV
1d30: 64 62 65 43 72 65 61 74 65 28 64 62 29 3b 0a 20  dbeCreate(db);. 
1d40: 20 69 66 28 20 76 64 62 65 3d 3d 30 20 29 7b 0a   if( vdbe==0 ){.
1d50: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72      sqliteSetStr
1d60: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f  ing(pzErrMsg, "o
1d70: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 29 3b 0a  ut of memory");.
1d80: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
1d90: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73  E_NOMEM;.  }.  s
1da0: 71 6c 69 74 65 56 64 62 65 41 64 64 4f 70 4c 69  qliteVdbeAddOpLi
1db0: 73 74 28 76 64 62 65 2c 20 73 69 7a 65 6f 66 28  st(vdbe, sizeof(
1dc0: 69 6e 69 74 50 72 6f 67 29 2f 73 69 7a 65 6f 66  initProg)/sizeof
1dd0: 28 69 6e 69 74 50 72 6f 67 5b 30 5d 29 2c 20 69  (initProg[0]), i
1de0: 6e 69 74 50 72 6f 67 29 3b 0a 20 20 72 63 20 3d  nitProg);.  rc =
1df0: 20 73 71 6c 69 74 65 56 64 62 65 45 78 65 63 28   sqliteVdbeExec(
1e00: 76 64 62 65 2c 20 73 71 6c 69 74 65 4f 70 65 6e  vdbe, sqliteOpen
1e10: 43 62 2c 20 64 62 2c 20 70 7a 45 72 72 4d 73 67  Cb, db, pzErrMsg
1e20: 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  , .             
1e30: 20 20 20 20 20 20 20 20 20 64 62 2d 3e 70 42 75           db->pBu
1e40: 73 79 41 72 67 2c 20 64 62 2d 3e 78 42 75 73 79  syArg, db->xBusy
1e50: 43 61 6c 6c 62 61 63 6b 29 3b 0a 20 20 73 71 6c  Callback);.  sql
1e60: 69 74 65 56 64 62 65 44 65 6c 65 74 65 28 76 64  iteVdbeDelete(vd
1e70: 62 65 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53  be);.  if( rc==S
1e80: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e  QLITE_OK && db->
1e90: 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 31 20 26 26  file_format>1 &&
1ea0: 20 64 62 2d 3e 6e 54 61 62 6c 65 3e 30 20 29 7b   db->nTable>0 ){
1eb0: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74  .    sqliteSetSt
1ec0: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
1ed0: 75 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65  unsupported file
1ee0: 20 66 6f 72 6d 61 74 22 2c 20 30 29 3b 0a 20 20   format", 0);.  
1ef0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52    rc = SQLITE_ER
1f00: 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72  ROR;.  }.  if( r
1f10: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
1f20: 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b      Table *pTab;
1f30: 0a 20 20 20 20 63 68 61 72 20 2a 61 7a 41 72 67  .    char *azArg
1f40: 5b 36 5d 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30  [6];.    azArg[0
1f50: 5d 20 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 20  ] = "table";.   
1f60: 20 61 7a 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54   azArg[1] = MAST
1f70: 45 52 5f 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41  ER_NAME;.    azA
1f80: 72 67 5b 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20  rg[2] = "2";.   
1f90: 20 61 7a 41 72 67 5b 33 5d 20 3d 20 6d 61 73 74   azArg[3] = mast
1fa0: 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 61  er_schema;.    a
1fb0: 7a 41 72 67 5b 34 5d 20 3d 20 30 3b 0a 20 20 20  zArg[4] = 0;.   
1fc0: 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 28 64 62   sqliteOpenCb(db
1fd0: 2c 20 34 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a  , 4, azArg, 0);.
1fe0: 20 20 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74      pTab = sqlit
1ff0: 65 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d  eFindTable(db, M
2000: 41 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20  ASTER_NAME);.   
2010: 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20   if( pTab ){.   
2020: 20 20 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c     pTab->readOnl
2030: 79 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20  y = 1;.    }.   
2040: 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51   db->flags |= SQ
2050: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
2060: 3b 0a 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d  ;.    sqliteComm
2070: 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65  itInternalChange
2080: 73 28 64 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74  s(db);.  }.  ret
2090: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
20a0: 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   The version of 
20b0: 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63  the library.*/.c
20c0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
20d0: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
20e0: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
20f0: 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62  .** Does the lib
2100: 72 61 72 79 20 65 78 70 65 63 74 20 64 61 74 61  rary expect data
2110: 20 74 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61   to be encoded a
2120: 73 20 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38  s UTF-8 or iso88
2130: 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c  59?  The.** foll
2140: 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e  owing global con
2150: 73 74 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74  stant always let
2160: 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69  s us know..*/.#i
2170: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38  fdef SQLITE_UTF8
2180: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
2190: 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20  te_encoding[] = 
21a0: 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63  "UTF-8";.#else.c
21b0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
21c0: 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69  _encoding[] = "i
21d0: 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a  so8859";.#endif.
21e0: 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65  ./*.** Open a ne
21f0: 77 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  w SQLite databas
2200: 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e  e.  Construct an
2210: 20 22 73 71 6c 69 74 65 22 20 73 74 72 75 63 74   "sqlite" struct
2220: 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a  ure to define.**
2230: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68   the state of th
2240: 69 73 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  is database and 
2250: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  return a pointer
2260: 20 74 6f 20 74 68 61 74 20 73 74 72 75 63 74 75   to that structu
2270: 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74  re..**.** An att
2280: 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20  empt is made to 
2290: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69  initialize the i
22a0: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74  n-memory data st
22b0: 72 75 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a  ructures that.**
22c0: 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61   hold the databa
22d0: 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20  se schema.  But 
22e0: 69 66 20 74 68 69 73 20 66 61 69 6c 73 20 28 62  if this fails (b
22f0: 65 63 61 75 73 65 20 74 68 65 20 73 63 68 65 6d  ecause the schem
2300: 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63  a file.** is loc
2310: 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74 20 73  ked) then that s
2320: 74 65 70 20 69 73 20 64 65 66 65 72 72 65 64 20  tep is deferred 
2330: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
2340: 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74  call to.** sqlit
2350: 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c  e_exec()..*/.sql
2360: 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e  ite *sqlite_open
2370: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
2380: 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65  lename, int mode
2390: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73  , char **pzErrMs
23a0: 67 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  g){.  sqlite *db
23b0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f  ;.  int rc;..  /
23c0: 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73  * Allocate the s
23d0: 71 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63  qlite data struc
23e0: 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73  ture */.  db = s
23f0: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
2400: 65 6f 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20  eof(sqlite) );. 
2410: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20   if( pzErrMsg ) 
2420: 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20  *pzErrMsg = 0;. 
2430: 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74   if( db==0 ) got
2440: 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e  o no_mem_on_open
2450: 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e  ;.  sqliteHashIn
2460: 69 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c  it(&db->tblHash,
2470: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
2480: 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74  ING, 0);.  sqlit
2490: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69  eHashInit(&db->i
24a0: 64 78 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  dxHash, SQLITE_H
24b0: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
24c0: 20 20 64 62 2d 3e 6e 65 78 74 52 6f 77 69 64 20    db->nextRowid 
24d0: 3d 20 73 71 6c 69 74 65 52 61 6e 64 6f 6d 49 6e  = sqliteRandomIn
24e0: 74 65 67 65 72 28 64 62 29 3b 0a 20 20 0a 20 20  teger(db);.  .  
24f0: 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61 63 6b  /* Open the back
2500: 65 6e 64 20 64 61 74 61 62 61 73 65 20 64 72 69  end database dri
2510: 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71  ver */.  rc = sq
2520: 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28 7a 46  liteBtreeOpen(zF
2530: 69 6c 65 6e 61 6d 65 2c 20 6d 6f 64 65 2c 20 4d  ilename, mode, M
2540: 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d 3e 70  AX_PAGES, &db->p
2550: 42 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  Be);.  if( rc!=S
2560: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2570: 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20  switch( rc ){.  
2580: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
2590: 20 20 20 20 20 20 20 69 66 28 20 70 7a 45 72 72         if( pzErr
25a0: 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 20 20 20  Msg ){.         
25b0: 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67   sqliteSetString
25c0: 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 61 62  (pzErrMsg, "unab
25d0: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62  le to open datab
25e0: 61 73 65 3a 20 22 2c 20 7a 46 69 6c 65 6e 61 6d  ase: ", zFilenam
25f0: 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 7d  e, 0);.        }
2600: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
2610: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62     sqliteFree(db
2620: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 74 72  );.    sqliteStr
2630: 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67  Realloc(pzErrMsg
2640: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  );.    return 0;
2650: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 73 73 75 6d  .  }..  /* Assum
2660: 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 31 20  e file format 1 
2670: 75 6e 6c 65 73 73 20 74 68 65 20 64 61 74 61 62  unless the datab
2680: 61 73 65 20 73 61 79 73 20 6f 74 68 65 72 77 69  ase says otherwi
2690: 73 65 20 2a 2f 0a 20 20 64 62 2d 3e 66 69 6c 65  se */.  db->file
26a0: 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 0a 20 20  _format = 1;..  
26b0: 2f 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65  /* Attempt to re
26c0: 61 64 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f  ad the schema */
26d0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 49 6e  .  rc = sqliteIn
26e0: 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29  it(db, pzErrMsg)
26f0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d  ;.  if( sqlite_m
2700: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
2710: 20 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f      goto no_mem_
2720: 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c 73 65  on_open;.  }else
2730: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
2740: 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45  OK && rc!=SQLITE
2750: 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71 6c  _BUSY ){.    sql
2760: 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20  ite_close(db);. 
2770: 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c     sqliteStrReal
2780: 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20  loc(pzErrMsg);. 
2790: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
27a0: 65 6c 73 65 20 2f 2a 20 69 66 28 20 70 7a 45 72  else /* if( pzEr
27b0: 72 4d 73 67 20 29 20 2a 2f 7b 0a 20 20 20 20 73  rMsg ) */{.    s
27c0: 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72 72  qliteFree(*pzErr
27d0: 4d 73 67 29 3b 0a 20 20 20 20 2a 70 7a 45 72 72  Msg);.    *pzErr
27e0: 4d 73 67 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72  Msg = 0;.  }.  r
27f0: 65 74 75 72 6e 20 64 62 3b 0a 0a 6e 6f 5f 6d 65  eturn db;..no_me
2800: 6d 5f 6f 6e 5f 6f 70 65 6e 3a 0a 20 20 73 71 6c  m_on_open:.  sql
2810: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45  iteSetString(pzE
2820: 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d  rrMsg, "out of m
2830: 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 73 71  emory", 0);.  sq
2840: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
2850: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75  zErrMsg);.  retu
2860: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45  rn 0;.}../*.** E
2870: 72 61 73 65 20 61 6c 6c 20 73 63 68 65 6d 61 20  rase all schema 
2880: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d  information from
2890: 20 74 68 65 20 73 63 68 65 6d 61 20 68 61 73 68   the schema hash
28a0: 20 74 61 62 6c 65 2e 20 20 45 78 63 65 70 74 0a   table.  Except.
28b0: 2a 2a 20 74 61 62 6c 65 73 20 74 68 61 74 20 61  ** tables that a
28c0: 72 65 20 63 72 65 61 74 65 64 20 75 73 69 6e 67  re created using
28d0: 20 43 52 45 41 54 45 20 54 45 4d 50 4f 52 41 52   CREATE TEMPORAR
28e0: 59 20 54 41 42 4c 45 20 61 72 65 20 70 72 65 73  Y TABLE are pres
28f0: 65 72 76 65 64 0a 2a 2a 20 69 66 20 74 68 65 20  erved.** if the 
2900: 70 72 65 73 65 72 76 65 72 54 65 6d 70 73 20 66  preserverTemps f
2910: 6c 61 67 20 69 73 20 74 72 75 65 2e 0a 2a 2a 0a  lag is true..**.
2920: 2a 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20  ** The database 
2930: 73 63 68 65 6d 61 20 69 73 20 6e 6f 72 6d 61 6c  schema is normal
2940: 6c 79 20 72 65 61 64 20 69 6e 20 6f 6e 63 65 20  ly read in once 
2950: 77 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73  when the databas
2960: 65 0a 2a 2a 20 69 73 20 66 69 72 73 74 20 6f 70  e.** is first op
2970: 65 6e 65 64 20 61 6e 64 20 73 74 6f 72 65 64 20  ened and stored 
2980: 69 6e 20 61 20 68 61 73 68 20 74 61 62 6c 65 20  in a hash table 
2990: 69 6e 20 74 68 65 20 73 71 6c 69 74 65 20 73 74  in the sqlite st
29a0: 72 75 63 74 75 72 65 2e 0a 2a 2a 20 54 68 69 73  ructure..** This
29b0: 20 72 6f 75 74 69 6e 65 20 65 72 61 73 65 73 20   routine erases 
29c0: 74 68 65 20 73 74 6f 72 65 64 20 73 63 68 65 6d  the stored schem
29d0: 61 2e 20 20 54 68 69 73 20 65 72 61 73 75 72 65  a.  This erasure
29e0: 20 6f 63 63 75 72 73 20 62 65 63 61 75 73 65 0a   occurs because.
29f0: 2a 2a 20 65 69 74 68 65 72 20 74 68 65 20 64 61  ** either the da
2a00: 74 61 62 61 73 65 20 69 73 20 62 65 69 6e 67 20  tabase is being 
2a10: 63 6c 6f 73 65 64 20 6f 72 20 62 65 63 61 75 73  closed or becaus
2a20: 65 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f  e some other pro
2a30: 63 65 73 73 0a 2a 2a 20 63 68 61 6e 67 65 64 20  cess.** changed 
2a40: 74 68 65 20 73 63 68 65 6d 61 20 61 6e 64 20 74  the schema and t
2a50: 68 69 73 20 70 72 6f 63 65 73 73 20 6e 65 65 64  his process need
2a60: 73 20 74 6f 20 72 65 72 65 61 64 20 69 74 2e 0a  s to reread it..
2a70: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63  */.static void c
2a80: 6c 65 61 72 48 61 73 68 54 61 62 6c 65 28 73 71  learHashTable(sq
2a90: 6c 69 74 65 20 2a 64 62 2c 20 69 6e 74 20 70 72  lite *db, int pr
2aa0: 65 73 65 72 76 65 54 65 6d 70 73 29 7b 0a 20 20  eserveTemps){.  
2ab0: 48 61 73 68 45 6c 65 6d 20 2a 70 45 6c 65 6d 3b  HashElem *pElem;
2ac0: 0a 20 20 48 61 73 68 20 74 65 6d 70 31 3b 0a 20  .  Hash temp1;. 
2ad0: 20 74 65 6d 70 31 20 3d 20 64 62 2d 3e 74 62 6c   temp1 = db->tbl
2ae0: 48 61 73 68 3b 0a 20 20 73 71 6c 69 74 65 48 61  Hash;.  sqliteHa
2af0: 73 68 49 6e 69 74 28 26 64 62 2d 3e 74 62 6c 48  shInit(&db->tblH
2b00: 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  ash, SQLITE_HASH
2b10: 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73  _STRING, 0);.  s
2b20: 71 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28 26  qliteHashClear(&
2b30: 64 62 2d 3e 69 64 78 48 61 73 68 29 3b 0a 20 20  db->idxHash);.  
2b40: 66 6f 72 28 70 45 6c 65 6d 3d 73 71 6c 69 74 65  for(pElem=sqlite
2b50: 48 61 73 68 46 69 72 73 74 28 26 74 65 6d 70 31  HashFirst(&temp1
2b60: 29 3b 20 70 45 6c 65 6d 3b 20 70 45 6c 65 6d 3d  ); pElem; pElem=
2b70: 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28 70  sqliteHashNext(p
2b80: 45 6c 65 6d 29 29 7b 0a 20 20 20 20 54 61 62 6c  Elem)){.    Tabl
2b90: 65 20 2a 70 54 61 62 20 3d 20 73 71 6c 69 74 65  e *pTab = sqlite
2ba0: 48 61 73 68 44 61 74 61 28 70 45 6c 65 6d 29 3b  HashData(pElem);
2bb0: 0a 20 20 20 20 69 66 28 20 70 72 65 73 65 72 76  .    if( preserv
2bc0: 65 54 65 6d 70 73 20 26 26 20 70 54 61 62 2d 3e  eTemps && pTab->
2bd0: 69 73 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20  isTemp ){.      
2be0: 49 6e 64 65 78 20 2a 70 49 64 78 3b 0a 20 20 20  Index *pIdx;.   
2bf0: 20 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 73     sqliteHashIns
2c00: 65 72 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68  ert(&db->tblHash
2c10: 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 73  , pTab->zName, s
2c20: 74 72 6c 65 6e 28 70 54 61 62 2d 3e 7a 4e 61 6d  trlen(pTab->zNam
2c30: 65 29 2b 31 2c 20 70 54 61 62 29 3b 0a 20 20 20  e)+1, pTab);.   
2c40: 20 20 20 66 6f 72 28 70 49 64 78 3d 70 54 61 62     for(pIdx=pTab
2c50: 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20  ->pIndex; pIdx; 
2c60: 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74  pIdx=pIdx->pNext
2c70: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6e  ){.        int n
2c80: 20 3d 20 73 74 72 6c 65 6e 28 70 49 64 78 2d 3e   = strlen(pIdx->
2c90: 7a 4e 61 6d 65 29 2b 31 3b 0a 20 20 20 20 20 20  zName)+1;.      
2ca0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 73 65    sqliteHashInse
2cb0: 72 74 28 26 64 62 2d 3e 69 64 78 48 61 73 68 2c  rt(&db->idxHash,
2cc0: 20 70 49 64 78 2d 3e 7a 4e 61 6d 65 2c 20 6e 2c   pIdx->zName, n,
2cd0: 20 70 49 64 78 29 3b 0a 20 20 20 20 20 20 7d 0a   pIdx);.      }.
2ce0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
2cf0: 20 73 71 6c 69 74 65 44 65 6c 65 74 65 54 61 62   sqliteDeleteTab
2d00: 6c 65 28 64 62 2c 20 70 54 61 62 29 3b 0a 20 20  le(db, pTab);.  
2d10: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65    }.  }.  sqlite
2d20: 48 61 73 68 43 6c 65 61 72 28 26 74 65 6d 70 31  HashClear(&temp1
2d30: 29 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 26  );.  db->flags &
2d40: 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 69 74 69 61  = ~SQLITE_Initia
2d50: 6c 69 7a 65 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  lized;.}../*.** 
2d60: 43 6c 6f 73 65 20 61 6e 20 65 78 69 73 74 69 6e  Close an existin
2d70: 67 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  g SQLite databas
2d80: 65 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  e.*/.void sqlite
2d90: 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65 20 2a 64  _close(sqlite *d
2da0: 62 29 7b 0a 20 20 73 71 6c 69 74 65 42 74 72 65  b){.  sqliteBtre
2db0: 65 43 6c 6f 73 65 28 64 62 2d 3e 70 42 65 29 3b  eClose(db->pBe);
2dc0: 0a 20 20 63 6c 65 61 72 48 61 73 68 54 61 62 6c  .  clearHashTabl
2dd0: 65 28 64 62 2c 20 30 29 3b 0a 20 20 69 66 28 20  e(db, 0);.  if( 
2de0: 64 62 2d 3e 70 42 65 54 65 6d 70 20 29 7b 0a 20  db->pBeTemp ){. 
2df0: 20 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c     sqliteBtreeCl
2e00: 6f 73 65 28 64 62 2d 3e 70 42 65 54 65 6d 70 29  ose(db->pBeTemp)
2e10: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46 72  ;.  }.  sqliteFr
2e20: 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ee(db);.}../*.**
2e30: 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20   Return TRUE if 
2e40: 74 68 65 20 67 69 76 65 6e 20 53 51 4c 20 73 74  the given SQL st
2e50: 72 69 6e 67 20 65 6e 64 73 20 69 6e 20 61 20 73  ring ends in a s
2e60: 65 6d 69 63 6f 6c 6f 6e 2e 0a 2a 2f 0a 69 6e 74  emicolon..*/.int
2e70: 20 73 71 6c 69 74 65 5f 63 6f 6d 70 6c 65 74 65   sqlite_complete
2e80: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71  (const char *zSq
2e90: 6c 29 7b 0a 20 20 69 6e 74 20 69 73 43 6f 6d 70  l){.  int isComp
2ea0: 6c 65 74 65 20 3d 20 30 3b 0a 20 20 77 68 69 6c  lete = 0;.  whil
2eb0: 65 28 20 2a 7a 53 71 6c 20 29 7b 0a 20 20 20 20  e( *zSql ){.    
2ec0: 73 77 69 74 63 68 28 20 2a 7a 53 71 6c 20 29 7b  switch( *zSql ){
2ed0: 0a 20 20 20 20 20 20 63 61 73 65 20 27 3b 27 3a  .      case ';':
2ee0: 20 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d   {.        isCom
2ef0: 70 6c 65 74 65 20 3d 20 31 3b 0a 20 20 20 20 20  plete = 1;.     
2f00: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
2f10: 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 20 27  }.      case ' '
2f20: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27 5c 74  :.      case '\t
2f30: 27 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27 5c  ':.      case '\
2f40: 6e 27 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27  n':.      case '
2f50: 5c 66 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 62  \f': {.        b
2f60: 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20  reak;.      }.  
2f70: 20 20 20 20 63 61 73 65 20 27 5c 27 27 3a 20 7b      case '\'': {
2f80: 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c  .        isCompl
2f90: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ete = 0;.       
2fa0: 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20 20 20   zSql++;.       
2fb0: 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 26 26   while( *zSql &&
2fc0: 20 2a 7a 53 71 6c 21 3d 27 5c 27 27 20 29 7b 20   *zSql!='\'' ){ 
2fd0: 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20  zSql++; }.      
2fe0: 20 20 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29    if( *zSql==0 )
2ff0: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20   return 0;.     
3000: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
3010: 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 22 27  }.      case '"'
3020: 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f  : {.        isCo
3030: 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20  mplete = 0;.    
3040: 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20      zSql++;.    
3050: 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c      while( *zSql
3060: 20 26 26 20 2a 7a 53 71 6c 21 3d 27 22 27 20 29   && *zSql!='"' )
3070: 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20  { zSql++; }.    
3080: 20 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d 3d 30      if( *zSql==0
3090: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20   ) return 0;.   
30a0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
30b0: 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27    }.      case '
30c0: 2d 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 66  -': {.        if
30d0: 28 20 7a 53 71 6c 5b 31 5d 21 3d 27 2d 27 20 29  ( zSql[1]!='-' )
30e0: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 73 43 6f  {.          isCo
30f0: 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20  mplete = 0;.    
3100: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3110: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 77       }.        w
3120: 68 69 6c 65 28 20 2a 7a 53 71 6c 20 26 26 20 2a  hile( *zSql && *
3130: 7a 53 71 6c 21 3d 27 5c 6e 27 20 29 7b 20 7a 53  zSql!='\n' ){ zS
3140: 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20  ql++; }.        
3150: 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29 20 72  if( *zSql==0 ) r
3160: 65 74 75 72 6e 20 69 73 43 6f 6d 70 6c 65 74 65  eturn isComplete
3170: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
3180: 0a 20 20 20 20 20 20 7d 20 0a 20 20 20 20 20 20  .      } .      
3190: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20  default: {.     
31a0: 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20     isComplete = 
31b0: 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  0;.        break
31c0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
31d0: 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20 7d 0a      zSql++;.  }.
31e0: 20 20 72 65 74 75 72 6e 20 69 73 43 6f 6d 70 6c    return isCompl
31f0: 65 74 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78  ete;.}../*.** Ex
3200: 65 63 75 74 65 20 53 51 4c 20 63 6f 64 65 2e 20  ecute SQL code. 
3210: 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74   Return one of t
3220: 68 65 20 53 51 4c 49 54 45 5f 20 73 75 63 63 65  he SQLITE_ succe
3230: 73 73 2f 66 61 69 6c 75 72 65 0a 2a 2a 20 63 6f  ss/failure.** co
3240: 64 65 73 2e 20 20 41 6c 73 6f 20 77 72 69 74 65  des.  Also write
3250: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67   an error messag
3260: 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62  e into memory ob
3270: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 6d  tained from.** m
3280: 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65  alloc() and make
3290: 20 2a 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74   *pzErrMsg point
32a0: 20 74 6f 20 74 68 61 74 20 6d 65 73 73 61 67 65   to that message
32b0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53  ..**.** If the S
32c0: 51 4c 20 69 73 20 61 20 71 75 65 72 79 2c 20 74  QL is a query, t
32d0: 68 65 6e 20 66 6f 72 20 65 61 63 68 20 72 6f 77  hen for each row
32e0: 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 72 65   in the query re
32f0: 73 75 6c 74 0a 2a 2a 20 74 68 65 20 78 43 61 6c  sult.** the xCal
3300: 6c 62 61 63 6b 28 29 20 66 75 6e 63 74 69 6f 6e  lback() function
3310: 20 69 73 20 63 61 6c 6c 65 64 2e 20 20 70 41 72   is called.  pAr
3320: 67 20 62 65 63 6f 6d 65 73 20 74 68 65 20 66 69  g becomes the fi
3330: 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20  rst.** argument 
3340: 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 2e 20  to xCallback(). 
3350: 20 49 66 20 78 43 61 6c 6c 62 61 63 6b 3d 4e 55   If xCallback=NU
3360: 4c 4c 20 74 68 65 6e 20 6e 6f 20 63 61 6c 6c 62  LL then no callb
3370: 61 63 6b 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65  ack.** is invoke
3380: 64 2c 20 65 76 65 6e 20 66 6f 72 20 71 75 65 72  d, even for quer
3390: 69 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ies..*/.int sqli
33a0: 74 65 5f 65 78 65 63 28 0a 20 20 73 71 6c 69 74  te_exec(.  sqlit
33b0: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
33c0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61         /* The da
33d0: 74 61 62 61 73 65 20 6f 6e 20 77 68 69 63 68 20  tabase on which 
33e0: 74 68 65 20 53 51 4c 20 65 78 65 63 75 74 65 73  the SQL executes
33f0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 53 71 6c   */.  char *zSql
3400: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
3410: 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f 20    /* The SQL to 
3420: 62 65 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20  be executed */. 
3430: 20 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b   sqlite_callback
3440: 20 78 43 61 6c 6c 62 61 63 6b 2c 20 20 2f 2a 20   xCallback,  /* 
3450: 49 6e 76 6f 6b 65 20 74 68 69 73 20 63 61 6c 6c  Invoke this call
3460: 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a  back routine */.
3470: 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 20 20 20    void *pArg,   
3480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3490: 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20   First argument 
34a0: 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a  to xCallback() *
34b0: 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  /.  char **pzErr
34c0: 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20  Msg             
34d0: 2f 2a 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d  /* Write error m
34e0: 65 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a  essages here */.
34f0: 29 7b 0a 20 20 50 61 72 73 65 20 73 50 61 72 73  ){.  Parse sPars
3500: 65 3b 0a 0a 20 20 69 66 28 20 70 7a 45 72 72 4d  e;..  if( pzErrM
3510: 73 67 20 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d  sg ) *pzErrMsg =
3520: 20 30 3b 0a 20 20 69 66 28 20 28 64 62 2d 3e 66   0;.  if( (db->f
3530: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49 6e  lags & SQLITE_In
3540: 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29 7b  itialized)==0 ){
3550: 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71  .    int rc = sq
3560: 6c 69 74 65 49 6e 69 74 28 64 62 2c 20 70 7a 45  liteInit(db, pzE
3570: 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28 20  rrMsg);.    if( 
3580: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
3590: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 53 74 72  .      sqliteStr
35a0: 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67  Realloc(pzErrMsg
35b0: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
35c0: 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  rc;.    }.  }.  
35d0: 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20  memset(&sParse, 
35e0: 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65  0, sizeof(sParse
35f0: 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20  ));.  sParse.db 
3600: 3d 20 64 62 3b 0a 20 20 73 50 61 72 73 65 2e 70  = db;.  sParse.p
3610: 42 65 20 3d 20 64 62 2d 3e 70 42 65 3b 0a 20 20  Be = db->pBe;.  
3620: 73 50 61 72 73 65 2e 78 43 61 6c 6c 62 61 63 6b  sParse.xCallback
3630: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20   = xCallback;.  
3640: 73 50 61 72 73 65 2e 70 41 72 67 20 3d 20 70 41  sParse.pArg = pA
3650: 72 67 3b 0a 20 20 73 71 6c 69 74 65 52 75 6e 50  rg;.  sqliteRunP
3660: 61 72 73 65 72 28 26 73 50 61 72 73 65 2c 20 7a  arser(&sParse, z
3670: 53 71 6c 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a  Sql, pzErrMsg);.
3680: 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c    if( sqlite_mal
3690: 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20  loc_failed ){.  
36a0: 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e    sqliteSetStrin
36b0: 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74  g(pzErrMsg, "out
36c0: 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b   of memory", 0);
36d0: 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d  .    sParse.rc =
36e0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
36f0: 20 7d 0a 20 20 73 71 6c 69 74 65 53 74 72 52 65   }.  sqliteStrRe
3700: 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b  alloc(pzErrMsg);
3710: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63  .  if( sParse.rc
3720: 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20  ==SQLITE_SCHEMA 
3730: 29 7b 0a 20 20 20 20 63 6c 65 61 72 48 61 73 68  ){.    clearHash
3740: 54 61 62 6c 65 28 64 62 2c 20 31 29 3b 0a 20 20  Table(db, 1);.  
3750: 7d 0a 20 20 72 65 74 75 72 6e 20 73 50 61 72 73  }.  return sPars
3760: 65 2e 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  e.rc;.}../*.** T
3770: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c  his routine impl
3780: 65 6d 65 6e 74 73 20 61 20 62 75 73 79 20 63 61  ements a busy ca
3790: 6c 6c 62 61 63 6b 20 74 68 61 74 20 73 6c 65 65  llback that slee
37a0: 70 73 20 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20  ps and tries.** 
37b0: 61 67 61 69 6e 20 75 6e 74 69 6c 20 61 20 74 69  again until a ti
37c0: 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 20 72  meout value is r
37d0: 65 61 63 68 65 64 2e 20 20 54 68 65 20 74 69 6d  eached.  The tim
37e0: 65 6f 75 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a  eout value is.**
37f0: 20 61 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d 62   an integer numb
3800: 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e  er of millisecon
3810: 64 73 20 70 61 73 73 65 64 20 69 6e 20 61 73 20  ds passed in as 
3820: 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67  the first.** arg
3830: 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63  ument..*/.static
3840: 20 69 6e 74 20 73 71 6c 69 74 65 44 65 66 61 75   int sqliteDefau
3850: 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a  ltBusyCallback(.
3860: 20 76 6f 69 64 20 2a 54 69 6d 65 6f 75 74 2c 20   void *Timeout, 
3870: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78            /* Max
3880: 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 74  imum amount of t
3890: 69 6d 65 20 74 6f 20 77 61 69 74 20 2a 2f 0a 20  ime to wait */. 
38a0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 4e 6f 74 55  const char *NotU
38b0: 73 65 64 2c 20 20 20 20 20 2f 2a 20 54 68 65 20  sed,     /* The 
38c0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
38d0: 65 20 74 68 61 74 20 69 73 20 62 75 73 79 20 2a  e that is busy *
38e0: 2f 0a 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20  /. int count    
38f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
3900: 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74  umber of times t
3910: 61 62 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75  able has been bu
3920: 73 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c  sy */.){.#if SQL
3930: 49 54 45 5f 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53  ITE_MIN_SLEEP_MS
3940: 3d 3d 31 0a 20 20 69 6e 74 20 64 65 6c 61 79 20  ==1.  int delay 
3950: 3d 20 31 30 3b 0a 20 20 69 6e 74 20 70 72 69 6f  = 10;.  int prio
3960: 72 5f 64 65 6c 61 79 20 3d 20 30 3b 0a 20 20 69  r_delay = 0;.  i
3970: 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e  nt timeout = (in
3980: 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74  t)Timeout;.  int
3990: 20 69 3b 0a 0a 20 20 66 6f 72 28 69 3d 31 3b 20   i;..  for(i=1; 
39a0: 69 3c 63 6f 75 6e 74 3b 20 69 2b 2b 29 7b 20 0a  i<count; i++){ .
39b0: 20 20 20 20 70 72 69 6f 72 5f 64 65 6c 61 79 20      prior_delay 
39c0: 2b 3d 20 64 65 6c 61 79 3b 0a 20 20 20 20 64 65  += delay;.    de
39d0: 6c 61 79 20 3d 20 64 65 6c 61 79 2a 32 3b 0a 20  lay = delay*2;. 
39e0: 20 20 20 69 66 28 20 64 65 6c 61 79 3e 3d 31 30     if( delay>=10
39f0: 30 30 20 29 7b 0a 20 20 20 20 20 20 64 65 6c 61  00 ){.      dela
3a00: 79 20 3d 20 31 30 30 30 3b 0a 20 20 20 20 20 20  y = 1000;.      
3a10: 70 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 31  prior_delay += 1
3a20: 30 30 30 2a 28 63 6f 75 6e 74 20 2d 20 69 20 2d  000*(count - i -
3a30: 20 31 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b   1);.      break
3a40: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66  ;.    }.  }.  if
3a50: 28 20 70 72 69 6f 72 5f 64 65 6c 61 79 20 2b 20  ( prior_delay + 
3a60: 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 2a  delay > timeout*
3a70: 31 30 30 30 20 29 7b 0a 20 20 20 20 64 65 6c 61  1000 ){.    dela
3a80: 79 20 3d 20 74 69 6d 65 6f 75 74 2a 31 30 30 30  y = timeout*1000
3a90: 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 79 3b 0a   - prior_delay;.
3aa0: 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30      if( delay<=0
3ab0: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d   ) return 0;.  }
3ac0: 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c 65 65 70  .  sqliteOsSleep
3ad0: 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75 72  (delay);.  retur
3ae0: 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74  n 1;.#else.  int
3af0: 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29   timeout = (int)
3b00: 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28  Timeout;.  if( (
3b10: 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20  count+1)*1000 > 
3b20: 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72  timeout ){.    r
3b30: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73  eturn 0;.  }.  s
3b40: 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 31 30 30  qliteOsSleep(100
3b50: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  0);.  return 1;.
3b60: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
3b70: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74  This routine set
3b80: 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62  s the busy callb
3b90: 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74  ack for an Sqlit
3ba0: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68  e database to th
3bb0: 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62  e.** given callb
3bc0: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74  ack function wit
3bd0: 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75  h the given argu
3be0: 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ment..*/.void sq
3bf0: 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65  lite_busy_handle
3c00: 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c  r(.  sqlite *db,
3c10: 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29 28  .  int (*xBusy)(
3c20: 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72  void*,const char
3c30: 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a  *,int),.  void *
3c40: 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e 78 42  pArg.){.  db->xB
3c50: 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d 20 78 42  usyCallback = xB
3c60: 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 75 73 79  usy;.  db->pBusy
3c70: 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a 0a 2f  Arg = pArg;.}../
3c80: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
3c90: 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66  e installs a def
3ca0: 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65  ault busy handle
3cb0: 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f 72  r that waits for
3cc0: 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65   the.** specifie
3cd0: 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  d number of mill
3ce0: 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20  iseconds before 
3cf0: 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a  returning 0..*/.
3d00: 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73 79  void sqlite_busy
3d10: 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 20  _timeout(sqlite 
3d20: 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20  *db, int ms){.  
3d30: 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20  if( ms>0 ){.    
3d40: 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64  sqlite_busy_hand
3d50: 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65  ler(db, sqliteDe
3d60: 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63  faultBusyCallbac
3d70: 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a 20  k, (void*)ms);. 
3d80: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
3d90: 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  te_busy_handler(
3da0: 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 7d  db, 0, 0);.  }.}
3db0: 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61 6e  ../*.** Cause an
3dc0: 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61 74  y pending operat
3dd0: 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20 69  ion to stop at i
3de0: 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70 6f  ts earliest oppo
3df0: 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64  rtunity..*/.void
3e00: 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 72 75 70   sqlite_interrup
3e10: 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20  t(sqlite *db){. 
3e20: 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51   db->flags |= SQ
3e30: 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b 0a  LITE_Interrupt;.
3e40: 7d 0a                                            }.