/ Hex Artifact Content
Login

Artifact 00ff61d82189ad23fe2f2e6c355951f514cb1b5c:


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 31 20 32 30 30 31 2f 30 39 2f  ,v 1.41 2001/09/
0280: 32 33 20 32 30 3a 31 37 3a 35 35 20 64 72 68 20  23 20:17:55 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 45 61 63 68 20 63 61 6c 6c 62 61 63  e.  Each callbac
0320: 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66  k contains the f
0330: 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61  ollowing informa
0340: 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  tion:.**.**     
0350: 61 72 67 76 5b 30 5d 20 3d 20 22 6d 65 74 61 22  argv[0] = "meta"
0360: 20 6f 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22   or "table" or "
0370: 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20 61 72  index".**     ar
0380: 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20 6f 72  gv[1] = table or
0390: 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72 20 6d   index name or m
03a0: 65 74 61 20 73 74 61 74 65 6d 65 6e 74 20 74 79  eta statement ty
03b0: 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  pe..**     argv[
03c0: 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e  2] = root page n
03d0: 75 6d 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20  umber for table 
03e0: 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c 4c 20  or index.  NULL 
03f0: 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20 20 20  for meta..**    
0400: 20 61 72 67 76 5b 33 5d 20 3d 20 72 6f 6f 74 20   argv[3] = root 
0410: 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 70  page number of p
0420: 72 69 6d 61 72 79 20 6b 65 79 20 66 6f 72 20 74  rimary key for t
0430: 61 62 6c 65 73 20 6f 72 20 4e 55 4c 4c 2e 0a 2a  ables or NULL..*
0440: 2a 20 20 20 20 20 61 72 67 76 5b 34 5d 20 3d 20  *     argv[4] = 
0450: 53 51 4c 20 63 72 65 61 74 65 20 73 74 61 74 65  SQL create state
0460: 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 74 61 62  ment for the tab
0470: 6c 65 20 6f 72 20 69 6e 64 65 78 0a 2a 2a 0a 2a  le or index.**.*
0480: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c  /.static int sql
0490: 69 74 65 4f 70 65 6e 43 62 28 76 6f 69 64 20 2a  iteOpenCb(void *
04a0: 70 44 62 2c 20 69 6e 74 20 61 72 67 63 2c 20 63  pDb, int argc, c
04b0: 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68 61 72  har **argv, char
04c0: 20 2a 2a 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20   **azColName){. 
04d0: 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 28 73   sqlite *db = (s
04e0: 71 6c 69 74 65 2a 29 70 44 62 3b 0a 20 20 50 61  qlite*)pDb;.  Pa
04f0: 72 73 65 20 73 50 61 72 73 65 3b 0a 20 20 69 6e  rse sParse;.  in
0500: 74 20 6e 45 72 72 20 3d 20 30 3b 0a 0a 2f 2a 20  t nErr = 0;../* 
0510: 54 4f 44 4f 3a 20 44 6f 20 73 6f 6d 65 20 76 61  TODO: Do some va
0520: 6c 69 64 69 74 79 20 63 68 65 63 6b 73 20 6f 6e  lidity checks on
0530: 20 61 6c 6c 20 66 69 65 6c 64 73 2e 20 20 49 6e   all fields.  In
0540: 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 2a 2a 20   particular,.** 
0550: 6d 61 6b 65 20 73 75 72 65 20 66 69 65 6c 64 73  make sure fields
0560: 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20   do not contain 
0570: 4e 55 4c 4c 73 2e 20 2a 2f 0a 0a 20 20 61 73 73  NULLs. */..  ass
0580: 65 72 74 28 20 61 72 67 63 3d 3d 35 20 29 3b 0a  ert( argc==5 );.
0590: 20 20 73 77 69 74 63 68 28 20 61 72 67 76 5b 30    switch( argv[0
05a0: 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 63 61 73 65  ][0] ){.    case
05b0: 20 27 6d 27 3a 20 7b 20 20 2f 2a 20 4d 65 74 61   'm': {  /* Meta
05c0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a   information */.
05d0: 20 20 20 20 20 20 69 66 28 20 73 74 72 63 6d 70        if( strcmp
05e0: 28 61 72 67 76 5b 31 5d 2c 22 66 69 6c 65 2d 66  (argv[1],"file-f
05f0: 6f 72 6d 61 74 22 29 3d 3d 30 20 29 7b 0a 20 20  ormat")==0 ){.  
0600: 20 20 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66        db->file_f
0610: 6f 72 6d 61 74 20 3d 20 61 74 6f 69 28 61 72 67  ormat = atoi(arg
0620: 76 5b 34 5d 29 3b 0a 20 20 20 20 20 20 7d 65 6c  v[4]);.      }el
0630: 73 65 20 69 66 28 20 73 74 72 63 6d 70 28 61 72  se if( strcmp(ar
0640: 67 76 5b 31 5d 2c 22 73 63 68 65 6d 61 2d 63 6f  gv[1],"schema-co
0650: 6f 6b 69 65 22 29 3d 3d 30 20 29 7b 0a 20 20 20  okie")==0 ){.   
0660: 20 20 20 20 20 64 62 2d 3e 73 63 68 65 6d 61 5f       db->schema_
0670: 63 6f 6f 6b 69 65 20 3d 20 61 74 6f 69 28 61 72  cookie = atoi(ar
0680: 67 76 5b 34 5d 29 3b 0a 20 20 20 20 20 20 20 20  gv[4]);.        
0690: 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65 20  db->next_cookie 
06a0: 3d 20 64 62 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f  = db->schema_coo
06b0: 6b 69 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  kie;.      }.   
06c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
06d0: 20 20 20 20 63 61 73 65 20 27 69 27 3a 0a 20 20      case 'i':.  
06e0: 20 20 63 61 73 65 20 27 74 27 3a 20 7b 20 20 2f    case 't': {  /
06f0: 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 20  * CREATE TABLE  
0700: 61 6e 64 20 43 52 45 41 54 45 20 49 4e 44 45 58  and CREATE INDEX
0710: 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 20   statements */. 
0720: 20 20 20 20 20 6d 65 6d 73 65 74 28 26 73 50 61       memset(&sPa
0730: 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  rse, 0, sizeof(s
0740: 50 61 72 73 65 29 29 3b 0a 20 20 20 20 20 20 73  Parse));.      s
0750: 50 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20  Parse.db = db;. 
0760: 20 20 20 20 20 73 50 61 72 73 65 2e 69 6e 69 74       sParse.init
0770: 46 6c 61 67 20 3d 20 31 3b 0a 20 20 20 20 20 20  Flag = 1;.      
0780: 73 50 61 72 73 65 2e 6e 65 77 54 6e 75 6d 20 3d  sParse.newTnum =
0790: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a   atoi(argv[2]);.
07a0: 20 20 20 20 20 20 73 50 61 72 73 65 2e 6e 65 77        sParse.new
07b0: 4b 6e 75 6d 20 3d 20 61 72 67 76 5b 33 5d 20 3f  Knum = argv[3] ?
07c0: 20 61 74 6f 69 28 61 72 67 76 5b 33 5d 29 20 3a   atoi(argv[3]) :
07d0: 20 30 3b 0a 20 20 20 20 20 20 6e 45 72 72 20 3d   0;.      nErr =
07e0: 20 73 71 6c 69 74 65 52 75 6e 50 61 72 73 65 72   sqliteRunParser
07f0: 28 26 73 50 61 72 73 65 2c 20 61 72 67 76 5b 34  (&sParse, argv[4
0800: 5d 2c 20 30 29 3b 0a 20 20 20 20 20 20 62 72 65  ], 0);.      bre
0810: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65  ak;.    }.    de
0820: 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f  fault: {.      /
0830: 2a 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20 68  * This can not h
0840: 61 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20  appen! */.      
0850: 6e 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20 20  nErr = 1;.      
0860: 61 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30 20  assert( nErr==0 
0870: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  );.    }.  }.  r
0880: 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f  eturn nErr;.}../
0890: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
08a0: 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73  read the databas
08b0: 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69  e schema and ini
08c0: 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c  tialize internal
08d0: 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75  .** data structu
08e0: 72 65 73 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65  res.  Return one
08f0: 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20   of the SQLITE_ 
0900: 65 72 72 6f 72 20 63 6f 64 65 73 20 74 6f 0a 2a  error codes to.*
0910: 2a 20 69 6e 64 69 63 61 74 65 20 73 75 63 63 65  * indicate succe
0920: 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e 0a 2a  ss or failure..*
0930: 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 64  *.** After the d
0940: 61 74 61 62 61 73 65 20 69 73 20 69 6e 69 74 69  atabase is initi
0950: 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c 49  alized, the SQLI
0960: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a 2a  TE_Initialized.*
0970: 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20  * bit is set in 
0980: 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20  the flags field 
0990: 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20 73 74  of the sqlite st
09a0: 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a 2a 20  ructure.  An.** 
09b0: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20  attempt is made 
09c0: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68  to initialize th
09d0: 65 20 64 61 74 61 62 61 73 65 20 61 73 20 73 6f  e database as so
09e0: 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73 20 6f  on as it.** is o
09f0: 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61 74 20  pened.  If that 
0a00: 66 61 69 6c 73 20 28 70 65 72 68 61 70 73 20 62  fails (perhaps b
0a10: 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72 20 70  ecause another p
0a20: 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20 74 68  rocess.** has th
0a30: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  e sqlite_master 
0a40: 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20 74 68  table locked) th
0a50: 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74 65 6d  an another attem
0a60: 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20 74 68  pt.** is made th
0a70: 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 65  e first time the
0a80: 20 64 61 74 61 62 61 73 65 20 69 73 20 61 63 63   database is acc
0a90: 65 73 73 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  essed..*/.static
0aa0: 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69 74 28   int sqliteInit(
0ab0: 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68 61 72  sqlite *db, char
0ac0: 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20   **pzErrMsg){.  
0ad0: 56 64 62 65 20 2a 76 64 62 65 3b 0a 20 20 69 6e  Vdbe *vdbe;.  in
0ae0: 74 20 72 63 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a  t rc;..  /*.  **
0af0: 20 54 68 65 20 6d 61 73 74 65 72 20 64 61 74 61   The master data
0b00: 62 61 73 65 20 74 61 62 6c 65 20 68 61 73 20 61  base table has a
0b10: 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b 65 20   structure like 
0b20: 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74 61 74  this.  */.  stat
0b30: 69 63 20 63 68 61 72 20 6d 61 73 74 65 72 5f 73  ic char master_s
0b40: 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20 20  chema[] = .     
0b50: 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 22 20  "CREATE TABLE " 
0b60: 4d 41 53 54 45 52 5f 4e 41 4d 45 20 22 20 28 5c  MASTER_NAME " (\
0b70: 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20  n".     "  type 
0b80: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
0b90: 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20   name text,\n". 
0ba0: 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20      "  tbl_name 
0bb0: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
0bc0: 20 74 6e 75 6d 20 69 6e 74 65 67 65 72 2c 5c 6e   tnum integer,\n
0bd0: 22 0a 20 20 20 20 20 22 20 20 6b 6e 75 6d 20 69  ".     "  knum i
0be0: 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20 20 20  nteger,\n".     
0bf0: 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20  "  sql text\n". 
0c00: 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a 20 20 2f      ")".  ;..  /
0c10: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
0c20: 70 72 6f 67 72 61 6d 20 69 73 20 75 73 65 64 20  program is used 
0c30: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68  to initialize th
0c40: 65 20 69 6e 74 65 72 6e 61 6c 0a 20 20 2a 2a 20  e internal.  ** 
0c50: 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 69 6e  structure holdin
0c60: 67 20 74 68 65 20 74 61 62 6c 65 73 20 61 6e 64  g the tables and
0c70: 20 69 6e 64 65 78 65 73 20 6f 66 20 74 68 65 20   indexes of the 
0c80: 64 61 74 61 62 61 73 65 2e 0a 20 20 2a 2a 20 54  database..  ** T
0c90: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  he database cont
0ca0: 61 69 6e 73 20 61 20 73 70 65 63 69 61 6c 20 74  ains a special t
0cb0: 61 62 6c 65 20 6e 61 6d 65 64 20 22 73 71 6c 69  able named "sqli
0cc0: 74 65 5f 6d 61 73 74 65 72 22 0a 20 20 2a 2a 20  te_master".  ** 
0cd0: 64 65 66 69 6e 65 64 20 61 73 20 66 6f 6c 6c 6f  defined as follo
0ce0: 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20  ws:.  **.  **   
0cf0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 71   CREATE TABLE sq
0d00: 6c 69 74 65 5f 6d 61 73 74 65 72 20 28 0a 20 20  lite_master (.  
0d10: 2a 2a 20 20 20 20 20 20 20 20 74 79 70 65 20 20  **        type  
0d20: 20 20 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d       text,    --
0d30: 20 20 45 69 74 68 65 72 20 22 74 61 62 6c 65 22    Either "table"
0d40: 20 6f 72 20 22 69 6e 64 65 78 22 20 6f 72 20 22   or "index" or "
0d50: 6d 65 74 61 22 0a 20 20 2a 2a 20 20 20 20 20 20  meta".  **      
0d60: 20 20 6e 61 6d 65 20 20 20 20 20 20 20 74 65 78    name       tex
0d70: 74 2c 20 20 20 20 2d 2d 20 20 4e 61 6d 65 20 6f  t,    --  Name o
0d80: 66 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  f table or index
0d90: 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 74 62 6c  .  **        tbl
0da0: 5f 6e 61 6d 65 20 20 20 74 65 78 74 2c 20 20 20  _name   text,   
0db0: 20 2d 2d 20 20 41 73 73 6f 63 69 61 74 65 64 20   --  Associated 
0dc0: 74 61 62 6c 65 20 0a 20 20 2a 2a 20 20 20 20 20  table .  **     
0dd0: 20 20 20 74 6e 75 6d 20 20 20 20 20 20 20 69 6e     tnum       in
0de0: 74 65 67 65 72 2c 20 2d 2d 20 20 54 68 65 20 69  teger, --  The i
0df0: 6e 74 65 67 65 72 20 70 61 67 65 20 6e 75 6d 62  nteger page numb
0e00: 65 72 20 6f 66 20 72 6f 6f 74 20 70 61 67 65 0a  er of root page.
0e10: 20 20 2a 2a 20 20 20 20 20 20 20 20 6b 6e 75 6d    **        knum
0e20: 20 20 20 20 20 20 20 69 6e 74 65 67 65 72 2c 20         integer, 
0e30: 2d 2d 20 20 52 6f 6f 74 20 70 61 67 65 20 6f 66  --  Root page of
0e40: 20 70 72 69 6d 61 72 79 20 6b 65 79 2c 20 6f 72   primary key, or
0e50: 20 4e 55 4c 4c 0a 20 20 2a 2a 20 20 20 20 20 20   NULL.  **      
0e60: 20 20 73 71 6c 20 20 20 20 20 20 20 20 74 65 78    sql        tex
0e70: 74 20 20 20 20 20 2d 2d 20 20 54 68 65 20 43 52  t     --  The CR
0e80: 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 66  EATE statement f
0e90: 6f 72 20 74 68 69 73 20 6f 62 6a 65 63 74 0a 20  or this object. 
0ea0: 20 2a 2a 20 20 20 20 29 3b 0a 20 20 2a 2a 0a 20   **    );.  **. 
0eb0: 20 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 5f 6d   ** The sqlite_m
0ec0: 61 73 74 65 72 20 74 61 62 6c 65 20 63 6f 6e 74  aster table cont
0ed0: 61 69 6e 73 20 61 20 73 69 6e 67 6c 65 20 65 6e  ains a single en
0ee0: 74 72 79 20 66 6f 72 20 65 61 63 68 20 74 61 62  try for each tab
0ef0: 6c 65 0a 20 20 2a 2a 20 61 6e 64 20 65 61 63 68  le.  ** and each
0f00: 20 69 6e 64 65 78 2e 20 20 54 68 65 20 22 74 79   index.  The "ty
0f10: 70 65 22 20 63 6f 6c 75 6d 6e 20 74 65 6c 6c 73  pe" column tells
0f20: 20 77 68 65 74 68 65 72 20 74 68 65 20 65 6e 74   whether the ent
0f30: 72 79 20 69 73 0a 20 20 2a 2a 20 61 20 74 61 62  ry is.  ** a tab
0f40: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 54 68  le or index.  Th
0f50: 65 20 22 6e 61 6d 65 22 20 63 6f 6c 75 6d 6e 20  e "name" column 
0f60: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  is the name of t
0f70: 68 65 20 6f 62 6a 65 63 74 2e 0a 20 20 2a 2a 20  he object..  ** 
0f80: 54 68 65 20 22 74 62 6c 5f 6e 61 6d 65 22 20 69  The "tbl_name" i
0f90: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  s the name of th
0fa0: 65 20 61 73 73 6f 63 69 61 74 65 64 20 74 61 62  e associated tab
0fb0: 6c 65 2e 20 20 46 6f 72 20 74 61 62 6c 65 73 2c  le.  For tables,
0fc0: 0a 20 20 2a 2a 20 74 68 65 20 74 62 6c 5f 6e 61  .  ** the tbl_na
0fd0: 6d 65 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6c 77  me column is alw
0fe0: 61 79 73 20 74 68 65 20 73 61 6d 65 20 61 73 20  ays the same as 
0ff0: 6e 61 6d 65 2e 20 20 46 6f 72 20 69 6e 64 69 63  name.  For indic
1000: 65 73 2c 20 74 68 65 0a 20 20 2a 2a 20 74 62 6c  es, the.  ** tbl
1010: 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 63 6f 6e  _name column con
1020: 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f  tains the name o
1030: 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74  f the table that
1040: 20 74 68 65 20 69 6e 64 65 78 0a 20 20 2a 2a 20   the index.  ** 
1050: 69 6e 64 65 78 65 73 2e 20 20 46 69 6e 61 6c 6c  indexes.  Finall
1060: 79 2c 20 74 68 65 20 22 73 71 6c 22 20 63 6f 6c  y, the "sql" col
1070: 75 6d 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65  umn contains the
1080: 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f   complete text o
1090: 66 0a 20 20 2a 2a 20 74 68 65 20 43 52 45 41 54  f.  ** the CREAT
10a0: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
10b0: 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e  E INDEX statemen
10c0: 74 20 74 68 61 74 20 6f 72 69 67 69 6e 61 6c 6c  t that originall
10d0: 79 20 63 72 65 61 74 65 64 0a 20 20 2a 2a 20 74  y created.  ** t
10e0: 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65  he table or inde
10f0: 78 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20  x..  **.  ** If 
1100: 74 68 65 20 22 74 79 70 65 22 20 63 6f 6c 75 6d  the "type" colum
1110: 6e 20 68 61 73 20 74 68 65 20 76 61 6c 75 65 20  n has the value 
1120: 22 6d 65 74 61 22 2c 20 74 68 65 6e 20 74 68 65  "meta", then the
1130: 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 0a 20 20   "sql" column.  
1140: 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 65 78 74 72  ** contains extr
1150: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62  a information ab
1160: 6f 75 74 20 74 68 65 20 64 61 74 61 62 61 73 65  out the database
1170: 2c 20 73 75 63 68 20 61 73 20 74 68 65 0a 20 20  , such as the.  
1180: 2a 2a 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 76  ** file format v
1190: 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2e 20 20  ersion number.  
11a0: 41 6c 6c 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61  All meta informa
11b0: 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 70 72 6f  tion must be pro
11c0: 63 65 73 73 65 64 0a 20 20 2a 2a 20 62 65 66 6f  cessed.  ** befo
11d0: 72 65 20 61 6e 79 20 74 61 62 6c 65 73 20 6f 72  re any tables or
11e0: 20 69 6e 64 69 63 65 73 20 61 72 65 20 63 6f 6e   indices are con
11f0: 73 74 72 75 63 74 65 64 2e 0a 20 20 2a 2a 0a 20  structed..  **. 
1200: 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e   ** The followin
1210: 67 20 70 72 6f 67 72 61 6d 20 69 6e 76 6f 6b 65  g program invoke
1220: 73 20 69 74 73 20 63 61 6c 6c 62 61 63 6b 20 6f  s its callback o
1230: 6e 20 74 68 65 20 53 51 4c 20 66 6f 72 20 65 61  n the SQL for ea
1240: 63 68 0a 20 20 2a 2a 20 74 61 62 6c 65 20 74 68  ch.  ** table th
1250: 65 6e 20 67 6f 65 73 20 62 61 63 6b 20 61 6e 64  en goes back and
1260: 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 63 61 6c   invokes the cal
1270: 6c 62 61 63 6b 20 6f 6e 20 74 68 65 0a 20 20 2a  lback on the.  *
1280: 2a 20 53 51 4c 20 66 6f 72 20 65 61 63 68 20 69  * SQL for each i
1290: 6e 64 65 78 2e 20 20 54 68 65 20 63 61 6c 6c 62  ndex.  The callb
12a0: 61 63 6b 20 77 69 6c 6c 20 69 6e 76 6f 6b 65 20  ack will invoke 
12b0: 74 68 65 0a 20 20 2a 2a 20 70 61 72 73 65 72 20  the.  ** parser 
12c0: 74 6f 20 62 75 69 6c 64 20 74 68 65 20 69 6e 74  to build the int
12d0: 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61  ernal representa
12e0: 74 69 6f 6e 20 6f 66 20 74 68 65 0a 20 20 2a 2a  tion of the.  **
12f0: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 65   database scheme
1300: 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20  ..  */.  static 
1310: 56 64 62 65 4f 70 20 69 6e 69 74 50 72 6f 67 5b  VdbeOp initProg[
1320: 5d 20 3d 20 7b 0a 20 20 20 20 7b 20 4f 50 5f 4f  ] = {.    { OP_O
1330: 70 65 6e 2c 20 20 20 20 20 30 2c 20 32 2c 20 20  pen,     0, 2,  
1340: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77  0},.    { OP_Rew
1350: 69 6e 64 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d  ind,   0, 0,  0}
1360: 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c  ,.    { OP_Next,
1370: 20 20 20 20 20 30 2c 20 31 33 2c 20 30 7d 2c 20       0, 13, 0}, 
1380: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32 20 2a            /* 2 *
1390: 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d  /.    { OP_Colum
13a0: 6e 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a  n,   0, 0,  0},.
13b0: 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67 2c      { OP_String,
13c0: 20 20 20 30 2c 20 30 2c 20 20 22 6d 65 74 61 22     0, 0,  "meta"
13d0: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 2c 20  },.    { OP_Ne, 
13e0: 20 20 20 20 20 20 30 2c 20 32 2c 20 20 30 7d 2c        0, 2,  0},
13f0: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
1400: 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20  ,   0, 0,  0},. 
1410: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
1420: 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 20 20    0, 1,  0},.   
1430: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1440: 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 20 20 20 7b  0, 3,  0},.    {
1450: 20 4f 50 5f 4e 75 6c 6c 2c 20 20 20 20 20 30 2c   OP_Null,     0,
1460: 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   0,  0},.    { O
1470: 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 35  P_Column,   0, 5
1480: 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  ,  0},.    { OP_
1490: 43 61 6c 6c 62 61 63 6b 2c 20 35 2c 20 30 2c 20  Callback, 5, 0, 
14a0: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 47 6f   0},.    { OP_Go
14b0: 74 6f 2c 20 20 20 20 20 30 2c 20 32 2c 20 20 30  to,     0, 2,  0
14c0: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77 69  },.    { OP_Rewi
14d0: 6e 64 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  nd,   0, 0,  0},
14e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 33             /* 13
14f0: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78   */.    { OP_Nex
1500: 74 2c 20 20 20 20 20 30 2c 20 32 35 2c 20 30 7d  t,     0, 25, 0}
1510: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31  ,           /* 1
1520: 34 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6f  4 */.    { OP_Co
1530: 6c 75 6d 6e 2c 20 20 20 30 2c 20 30 2c 20 20 30  lumn,   0, 0,  0
1540: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69  },.    { OP_Stri
1550: 6e 67 2c 20 20 20 30 2c 20 30 2c 20 20 22 74 61  ng,   0, 0,  "ta
1560: 62 6c 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  ble"},.    { OP_
1570: 4e 65 2c 20 20 20 20 20 20 20 30 2c 20 31 34 2c  Ne,       0, 14,
1580: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
1590: 6c 75 6d 6e 2c 20 20 20 30 2c 20 30 2c 20 20 30  lumn,   0, 0,  0
15a0: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75  },.    { OP_Colu
15b0: 6d 6e 2c 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c  mn,   0, 1,  0},
15c0: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
15d0: 2c 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20  ,   0, 3,  0},. 
15e0: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
15f0: 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 20 20    0, 4,  0},.   
1600: 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20   { OP_Column,   
1610: 30 2c 20 35 2c 20 20 30 7d 2c 0a 20 20 20 20 7b  0, 5,  0},.    {
1620: 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c 20 35 2c   OP_Callback, 5,
1630: 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   0,  0},.    { O
1640: 50 5f 47 6f 74 6f 2c 20 20 20 20 20 30 2c 20 31  P_Goto,     0, 1
1650: 34 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  4, 0},.    { OP_
1660: 52 65 77 69 6e 64 2c 20 20 20 30 2c 20 30 2c 20  Rewind,   0, 0, 
1670: 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f   0},           /
1680: 2a 20 32 35 20 2a 2f 0a 20 20 20 20 7b 20 4f 50  * 25 */.    { OP
1690: 5f 4e 65 78 74 2c 20 20 20 20 20 30 2c 20 33 37  _Next,     0, 37
16a0: 2c 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20  , 0},           
16b0: 2f 2a 20 32 36 20 2a 2f 0a 20 20 20 20 7b 20 4f  /* 26 */.    { O
16c0: 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 30  P_Column,   0, 0
16d0: 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  ,  0},.    { OP_
16e0: 53 74 72 69 6e 67 2c 20 20 20 30 2c 20 30 2c 20  String,   0, 0, 
16f0: 20 22 69 6e 64 65 78 22 7d 2c 0a 20 20 20 20 7b   "index"},.    {
1700: 20 4f 50 5f 4e 65 2c 20 20 20 20 20 20 20 30 2c   OP_Ne,       0,
1710: 20 32 36 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f   26, 0},.    { O
1720: 50 5f 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 30  P_Column,   0, 0
1730: 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  ,  0},.    { OP_
1740: 43 6f 6c 75 6d 6e 2c 20 20 20 30 2c 20 31 2c 20  Column,   0, 1, 
1750: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 6f   0},.    { OP_Co
1760: 6c 75 6d 6e 2c 20 20 20 30 2c 20 33 2c 20 20 30  lumn,   0, 3,  0
1770: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 75 6c 6c  },.    { OP_Null
1780: 2c 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  ,     0, 0,  0},
1790: 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e  .    { OP_Column
17a0: 2c 20 20 20 30 2c 20 35 2c 20 20 30 7d 2c 0a 20  ,   0, 5,  0},. 
17b0: 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b     { OP_Callback
17c0: 2c 20 35 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20  , 5, 0,  0},.   
17d0: 20 7b 20 4f 50 5f 47 6f 74 6f 2c 20 20 20 20 20   { OP_Goto,     
17e0: 30 2c 20 32 36 2c 20 30 7d 2c 0a 20 20 20 20 7b  0, 26, 0},.    {
17f0: 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 30 2c   OP_String,   0,
1800: 20 30 2c 20 20 22 6d 65 74 61 22 7d 2c 20 20 20   0,  "meta"},   
1810: 20 20 20 2f 2a 20 33 37 20 2a 2f 0a 20 20 20 20     /* 37 */.    
1820: 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 30  { OP_String,   0
1830: 2c 20 30 2c 20 20 22 73 63 68 65 6d 61 2d 63 6f  , 0,  "schema-co
1840: 6f 6b 69 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50  okie"},.    { OP
1850: 5f 4e 75 6c 6c 2c 20 20 20 20 20 30 2c 20 30 2c  _Null,     0, 0,
1860: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e    0},.    { OP_N
1870: 75 6c 6c 2c 20 20 20 20 20 30 2c 20 30 2c 20 20  ull,     0, 0,  
1880: 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 65 61  0},.    { OP_Rea
1890: 64 43 6f 6f 6b 69 65 2c 30 2c 30 2c 20 20 30 7d  dCookie,0,0,  0}
18a0: 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62  ,.    { OP_Callb
18b0: 61 63 6b 2c 20 35 2c 20 30 2c 20 20 30 7d 2c 0a  ack, 5, 0,  0},.
18c0: 20 20 20 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c 20      { OP_Close, 
18d0: 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20     0, 0,  0},.  
18e0: 20 20 7b 20 4f 50 5f 48 61 6c 74 2c 20 20 20 20    { OP_Halt,    
18f0: 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 7d 3b   0, 0,  0},.  };
1900: 0a 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20  ..  /* Create a 
1910: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
1920: 74 6f 20 72 75 6e 20 74 68 65 20 69 6e 69 74 69  to run the initi
1930: 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 67 72 61  alization progra
1940: 6d 2e 20 20 52 75 6e 0a 20 20 2a 2a 20 74 68 65  m.  Run.  ** the
1950: 20 70 72 6f 67 72 61 6d 2e 20 20 54 68 65 20 64   program.  The d
1960: 65 6c 65 74 65 20 74 68 65 20 76 69 72 74 75 61  elete the virtua
1970: 6c 20 6d 61 63 68 69 6e 65 2e 0a 20 20 2a 2f 0a  l machine..  */.
1980: 20 20 76 64 62 65 20 3d 20 73 71 6c 69 74 65 56    vdbe = sqliteV
1990: 64 62 65 43 72 65 61 74 65 28 64 62 29 3b 0a 20  dbeCreate(db);. 
19a0: 20 69 66 28 20 76 64 62 65 3d 3d 30 20 29 7b 0a   if( vdbe==0 ){.
19b0: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72      sqliteSetStr
19c0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f  ing(pzErrMsg, "o
19d0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 29 3b 0a  ut of memory");.
19e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
19f0: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73  E_NOMEM;.  }.  s
1a00: 71 6c 69 74 65 56 64 62 65 41 64 64 4f 70 4c 69  qliteVdbeAddOpLi
1a10: 73 74 28 76 64 62 65 2c 20 73 69 7a 65 6f 66 28  st(vdbe, sizeof(
1a20: 69 6e 69 74 50 72 6f 67 29 2f 73 69 7a 65 6f 66  initProg)/sizeof
1a30: 28 69 6e 69 74 50 72 6f 67 5b 30 5d 29 2c 20 69  (initProg[0]), i
1a40: 6e 69 74 50 72 6f 67 29 3b 0a 20 20 72 63 20 3d  nitProg);.  rc =
1a50: 20 73 71 6c 69 74 65 56 64 62 65 45 78 65 63 28   sqliteVdbeExec(
1a60: 76 64 62 65 2c 20 73 71 6c 69 74 65 4f 70 65 6e  vdbe, sqliteOpen
1a70: 43 62 2c 20 64 62 2c 20 70 7a 45 72 72 4d 73 67  Cb, db, pzErrMsg
1a80: 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  , .             
1a90: 20 20 20 20 20 20 20 20 20 64 62 2d 3e 70 42 75           db->pBu
1aa0: 73 79 41 72 67 2c 20 64 62 2d 3e 78 42 75 73 79  syArg, db->xBusy
1ab0: 43 61 6c 6c 62 61 63 6b 29 3b 0a 20 20 73 71 6c  Callback);.  sql
1ac0: 69 74 65 56 64 62 65 44 65 6c 65 74 65 28 76 64  iteVdbeDelete(vd
1ad0: 62 65 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53  be);.  if( rc==S
1ae0: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e  QLITE_OK && db->
1af0: 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 31 20 26 26  file_format>1 &&
1b00: 20 64 62 2d 3e 6e 54 61 62 6c 65 3e 30 20 29 7b   db->nTable>0 ){
1b10: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74  .    sqliteSetSt
1b20: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
1b30: 75 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65  unsupported file
1b40: 20 66 6f 72 6d 61 74 22 2c 20 30 29 3b 0a 20 20   format", 0);.  
1b50: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52    rc = SQLITE_ER
1b60: 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72  ROR;.  }.  if( r
1b70: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
1b80: 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b      Table *pTab;
1b90: 0a 20 20 20 20 63 68 61 72 20 2a 61 7a 41 72 67  .    char *azArg
1ba0: 5b 36 5d 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30  [6];.    azArg[0
1bb0: 5d 20 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 20  ] = "table";.   
1bc0: 20 61 7a 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54   azArg[1] = MAST
1bd0: 45 52 5f 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41  ER_NAME;.    azA
1be0: 72 67 5b 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20  rg[2] = "2";.   
1bf0: 20 61 7a 41 72 67 5b 33 5d 20 3d 20 30 3b 0a 20   azArg[3] = 0;. 
1c00: 20 20 20 61 7a 41 72 67 5b 34 5d 20 3d 20 6d 61     azArg[4] = ma
1c10: 73 74 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20  ster_schema;.   
1c20: 20 61 7a 41 72 67 5b 35 5d 20 3d 20 30 3b 0a 20   azArg[5] = 0;. 
1c30: 20 20 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 28     sqliteOpenCb(
1c40: 64 62 2c 20 35 2c 20 61 7a 41 72 67 2c 20 30 29  db, 5, azArg, 0)
1c50: 3b 0a 20 20 20 20 70 54 61 62 20 3d 20 73 71 6c  ;.    pTab = sql
1c60: 69 74 65 46 69 6e 64 54 61 62 6c 65 28 64 62 2c  iteFindTable(db,
1c70: 20 4d 41 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20   MASTER_NAME);. 
1c80: 20 20 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20     if( pTab ){. 
1c90: 20 20 20 20 20 70 54 61 62 2d 3e 72 65 61 64 4f       pTab->readO
1ca0: 6e 6c 79 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20  nly = 1;.    }. 
1cb0: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20     db->flags |= 
1cc0: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a  SQLITE_Initializ
1cd0: 65 64 3b 0a 20 20 20 20 73 71 6c 69 74 65 43 6f  ed;.    sqliteCo
1ce0: 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e  mmitInternalChan
1cf0: 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 20 20 72  ges(db);.  }.  r
1d00: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
1d10: 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f  ** The version o
1d20: 66 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f  f the library.*/
1d30: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
1d40: 74 65 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53  te_version[] = S
1d50: 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a  QLITE_VERSION;..
1d60: 2f 2a 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20 6c  /*.** Does the l
1d70: 69 62 72 61 72 79 20 65 78 70 65 63 74 20 64 61  ibrary expect da
1d80: 74 61 20 74 6f 20 62 65 20 65 6e 63 6f 64 65 64  ta to be encoded
1d90: 20 61 73 20 55 54 46 2d 38 20 6f 72 20 69 73 6f   as UTF-8 or iso
1da0: 38 38 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66 6f  8859?  The.** fo
1db0: 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 63  llowing global c
1dc0: 6f 6e 73 74 61 6e 74 20 61 6c 77 61 79 73 20 6c  onstant always l
1dd0: 65 74 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a  ets us know..*/.
1de0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 54  #ifdef SQLITE_UT
1df0: 46 38 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71  F8.const char sq
1e00: 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20  lite_encoding[] 
1e10: 3d 20 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73 65  = "UTF-8";.#else
1e20: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
1e30: 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20  te_encoding[] = 
1e40: 22 69 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64 69  "iso8859";.#endi
1e50: 66 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20  f../*.** Open a 
1e60: 6e 65 77 20 53 51 4c 69 74 65 20 64 61 74 61 62  new SQLite datab
1e70: 61 73 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20  ase.  Construct 
1e80: 61 6e 20 22 73 71 6c 69 74 65 22 20 73 74 72 75  an "sqlite" stru
1e90: 63 74 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a  cture to define.
1ea0: 2a 2a 20 74 68 65 20 73 74 61 74 65 20 6f 66 20  ** the state of 
1eb0: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 61 6e  this database an
1ec0: 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  d return a point
1ed0: 65 72 20 74 6f 20 74 68 61 74 20 73 74 72 75 63  er to that struc
1ee0: 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61  ture..**.** An a
1ef0: 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74  ttempt is made t
1f00: 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65  o initialize the
1f10: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20   in-memory data 
1f20: 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74 0a  structures that.
1f30: 2a 2a 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61  ** hold the data
1f40: 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75  base schema.  Bu
1f50: 74 20 69 66 20 74 68 69 73 20 66 61 69 6c 73 20  t if this fails 
1f60: 28 62 65 63 61 75 73 65 20 74 68 65 20 73 63 68  (because the sch
1f70: 65 6d 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c  ema file.** is l
1f80: 6f 63 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74  ocked) then that
1f90: 20 73 74 65 70 20 69 73 20 64 65 66 65 72 72 65   step is deferre
1fa0: 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73  d until the firs
1fb0: 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c  t call to.** sql
1fc0: 69 74 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 73  ite_exec()..*/.s
1fd0: 71 6c 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f 70  qlite *sqlite_op
1fe0: 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  en(const char *z
1ff0: 46 69 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f  Filename, int mo
2000: 64 65 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  de, char **pzErr
2010: 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a  Msg){.  sqlite *
2020: 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20  db;.  int rc;.. 
2030: 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65   /* Allocate the
2040: 20 73 71 6c 69 74 65 20 64 61 74 61 20 73 74 72   sqlite data str
2050: 75 63 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d  ucture */.  db =
2060: 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73   sqliteMalloc( s
2070: 69 7a 65 6f 66 28 73 71 6c 69 74 65 29 20 29 3b  izeof(sqlite) );
2080: 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20  .  if( pzErrMsg 
2090: 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b  ) *pzErrMsg = 0;
20a0: 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67  .  if( db==0 ) g
20b0: 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  oto no_mem_on_op
20c0: 65 6e 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 68  en;.  sqliteHash
20d0: 49 6e 69 74 28 26 64 62 2d 3e 74 62 6c 48 61 73  Init(&db->tblHas
20e0: 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53  h, SQLITE_HASH_S
20f0: 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c  TRING, 0);.  sql
2100: 69 74 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d  iteHashInit(&db-
2110: 3e 69 64 78 48 61 73 68 2c 20 53 51 4c 49 54 45  >idxHash, SQLITE
2120: 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29  _HASH_STRING, 0)
2130: 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 52 6f 77 69  ;.  db->nextRowi
2140: 64 20 3d 20 73 71 6c 69 74 65 52 61 6e 64 6f 6d  d = sqliteRandom
2150: 49 6e 74 65 67 65 72 28 64 62 29 3b 0a 20 20 0a  Integer(db);.  .
2160: 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61    /* Open the ba
2170: 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 64  ckend database d
2180: 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20  river */.  rc = 
2190: 73 71 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28  sqliteBtreeOpen(
21a0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 6d 6f 64 65 2c  zFilename, mode,
21b0: 20 4d 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d   MAX_PAGES, &db-
21c0: 3e 70 42 65 29 3b 0a 20 20 69 66 28 20 72 63 21  >pBe);.  if( rc!
21d0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
21e0: 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a    switch( rc ){.
21f0: 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b        default: {
2200: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 7a 45  .        if( pzE
2210: 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 20  rrMsg ){.       
2220: 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69     sqliteSetStri
2230: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e  ng(pzErrMsg, "un
2240: 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74  able to open dat
2250: 61 62 61 73 65 3a 20 22 2c 20 7a 46 69 6c 65 6e  abase: ", zFilen
2260: 61 6d 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  ame, 0);.       
2270: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
2280: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
2290: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53  db);.    sqliteS
22a0: 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d  trRealloc(pzErrM
22b0: 73 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  sg);.    return 
22c0: 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 73 73  0;.  }..  /* Ass
22d0: 75 6d 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 20  ume file format 
22e0: 31 20 75 6e 6c 65 73 73 20 74 68 65 20 64 61 74  1 unless the dat
22f0: 61 62 61 73 65 20 73 61 79 73 20 6f 74 68 65 72  abase says other
2300: 77 69 73 65 20 2a 2f 0a 20 20 64 62 2d 3e 66 69  wise */.  db->fi
2310: 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 0a  le_format = 1;..
2320: 20 20 2f 2a 20 41 74 74 65 6d 70 74 20 74 6f 20    /* Attempt to 
2330: 72 65 61 64 20 74 68 65 20 73 63 68 65 6d 61 20  read the schema 
2340: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  */.  rc = sqlite
2350: 49 6e 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73  Init(db, pzErrMs
2360: 67 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65  g);.  if( sqlite
2370: 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29  _malloc_failed )
2380: 7b 0a 20 20 20 20 67 6f 74 6f 20 6e 6f 5f 6d 65  {.    goto no_me
2390: 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 7d 65 6c  m_on_open;.  }el
23a0: 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  se if( rc!=SQLIT
23b0: 45 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49  E_OK && rc!=SQLI
23c0: 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 73  TE_BUSY ){.    s
23d0: 71 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b  qlite_close(db);
23e0: 0a 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65  .    sqliteStrRe
23f0: 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b  alloc(pzErrMsg);
2400: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
2410: 20 7d 65 6c 73 65 20 2f 2a 20 69 66 28 20 70 7a   }else /* if( pz
2420: 45 72 72 4d 73 67 20 29 20 2a 2f 7b 0a 20 20 20  ErrMsg ) */{.   
2430: 20 73 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45   sqliteFree(*pzE
2440: 72 72 4d 73 67 29 3b 0a 20 20 20 20 2a 70 7a 45  rrMsg);.    *pzE
2450: 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 7d 0a 20  rrMsg = 0;.  }. 
2460: 20 72 65 74 75 72 6e 20 64 62 3b 0a 0a 6e 6f 5f   return db;..no_
2470: 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3a 0a 20 20 73  mem_on_open:.  s
2480: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
2490: 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66  zErrMsg, "out of
24a0: 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20   memory", 0);.  
24b0: 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63  sqliteStrRealloc
24c0: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65  (pzErrMsg);.  re
24d0: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  turn 0;.}../*.**
24e0: 20 45 72 61 73 65 20 61 6c 6c 20 73 63 68 65 6d   Erase all schem
24f0: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72  a information fr
2500: 6f 6d 20 74 68 65 20 73 63 68 65 6d 61 20 68 61  om the schema ha
2510: 73 68 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20  sh table..**.** 
2520: 54 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  The database sch
2530: 65 6d 61 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20  ema is normally 
2540: 72 65 61 64 20 69 6e 20 6f 6e 63 65 20 77 68 65  read in once whe
2550: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a  n the database.*
2560: 2a 20 69 73 20 66 69 72 73 74 20 6f 70 65 6e 65  * is first opene
2570: 64 20 61 6e 64 20 73 74 6f 72 65 64 20 69 6e 20  d and stored in 
2580: 61 20 68 61 73 68 20 74 61 62 6c 65 20 69 6e 20  a hash table in 
2590: 74 68 65 20 73 71 6c 69 74 65 20 73 74 72 75 63  the sqlite struc
25a0: 74 75 72 65 2e 0a 2a 2a 20 54 68 69 73 20 72 6f  ture..** This ro
25b0: 75 74 69 6e 65 20 65 72 61 73 65 73 20 74 68 65  utine erases the
25c0: 20 73 74 6f 72 65 64 20 73 63 68 65 6d 61 2e 20   stored schema. 
25d0: 20 54 68 69 73 20 65 72 61 73 75 72 65 20 6f 63   This erasure oc
25e0: 63 75 72 73 20 62 65 63 61 75 73 65 0a 2a 2a 20  curs because.** 
25f0: 65 69 74 68 65 72 20 74 68 65 20 64 61 74 61 62  either the datab
2600: 61 73 65 20 69 73 20 62 65 69 6e 67 20 63 6c 6f  ase is being clo
2610: 73 65 64 20 6f 72 20 62 65 63 61 75 73 65 20 73  sed or because s
2620: 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73  ome other proces
2630: 73 0a 2a 2a 20 63 68 61 6e 67 65 64 20 74 68 65  s.** changed the
2640: 20 73 63 68 65 6d 61 20 61 6e 64 20 74 68 69 73   schema and this
2650: 20 70 72 6f 63 65 73 73 20 6e 65 65 64 73 20 74   process needs t
2660: 6f 20 72 65 72 65 61 64 20 69 74 2e 0a 2a 2f 0a  o reread it..*/.
2670: 73 74 61 74 69 63 20 76 6f 69 64 20 63 6c 65 61  static void clea
2680: 72 48 61 73 68 54 61 62 6c 65 28 73 71 6c 69 74  rHashTable(sqlit
2690: 65 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c  e *db){.  HashEl
26a0: 65 6d 20 2a 70 45 6c 65 6d 3b 0a 20 20 48 61 73  em *pElem;.  Has
26b0: 68 20 74 65 6d 70 31 3b 0a 20 20 74 65 6d 70 31  h temp1;.  temp1
26c0: 20 3d 20 64 62 2d 3e 74 62 6c 48 61 73 68 3b 0a   = db->tblHash;.
26d0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
26e0: 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53  (&db->tblHash, S
26f0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
2700: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48  G, 0);.  sqliteH
2710: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 69 64  ashClear(&db->id
2720: 78 48 61 73 68 29 3b 0a 20 20 66 6f 72 28 70 45  xHash);.  for(pE
2730: 6c 65 6d 3d 73 71 6c 69 74 65 48 61 73 68 46 69  lem=sqliteHashFi
2740: 72 73 74 28 26 74 65 6d 70 31 29 3b 20 70 45 6c  rst(&temp1); pEl
2750: 65 6d 3b 20 70 45 6c 65 6d 3d 73 71 6c 69 74 65  em; pElem=sqlite
2760: 48 61 73 68 4e 65 78 74 28 70 45 6c 65 6d 29 29  HashNext(pElem))
2770: 7b 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 62  {.    Table *pTb
2780: 6c 20 3d 20 73 71 6c 69 74 65 48 61 73 68 44 61  l = sqliteHashDa
2790: 74 61 28 70 45 6c 65 6d 29 3b 0a 20 20 20 20 73  ta(pElem);.    s
27a0: 71 6c 69 74 65 44 65 6c 65 74 65 54 61 62 6c 65  qliteDeleteTable
27b0: 28 64 62 2c 20 70 54 62 6c 29 3b 0a 20 20 7d 0a  (db, pTbl);.  }.
27c0: 20 20 73 71 6c 69 74 65 48 61 73 68 43 6c 65 61    sqliteHashClea
27d0: 72 28 26 74 65 6d 70 31 29 3b 0a 20 20 64 62 2d  r(&temp1);.  db-
27e0: 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54  >flags &= ~SQLIT
27f0: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 7d  E_Initialized;.}
2800: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e  ../*.** Close an
2810: 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65   existing SQLite
2820: 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69   database.*/.voi
2830: 64 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73  d sqlite_close(s
2840: 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 73 71  qlite *db){.  sq
2850: 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64  liteBtreeClose(d
2860: 62 2d 3e 70 42 65 29 3b 0a 20 20 63 6c 65 61 72  b->pBe);.  clear
2870: 48 61 73 68 54 61 62 6c 65 28 64 62 29 3b 0a 20  HashTable(db);. 
2880: 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b   sqliteFree(db);
2890: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
28a0: 20 54 52 55 45 20 69 66 20 74 68 65 20 67 69 76   TRUE if the giv
28b0: 65 6e 20 53 51 4c 20 73 74 72 69 6e 67 20 65 6e  en SQL string en
28c0: 64 73 20 69 6e 20 61 20 73 65 6d 69 63 6f 6c 6f  ds in a semicolo
28d0: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  n..*/.int sqlite
28e0: 5f 63 6f 6d 70 6c 65 74 65 28 63 6f 6e 73 74 20  _complete(const 
28f0: 63 68 61 72 20 2a 7a 53 71 6c 29 7b 0a 20 20 69  char *zSql){.  i
2900: 6e 74 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20  nt isComplete = 
2910: 30 3b 0a 20 20 77 68 69 6c 65 28 20 2a 7a 53 71  0;.  while( *zSq
2920: 6c 20 29 7b 0a 20 20 20 20 73 77 69 74 63 68 28  l ){.    switch(
2930: 20 2a 7a 53 71 6c 20 29 7b 0a 20 20 20 20 20 20   *zSql ){.      
2940: 63 61 73 65 20 27 3b 27 3a 20 7b 0a 20 20 20 20  case ';': {.    
2950: 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d      isComplete =
2960: 20 31 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61   1;.        brea
2970: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
2980: 20 63 61 73 65 20 27 20 27 3a 0a 20 20 20 20 20   case ' ':.     
2990: 20 63 61 73 65 20 27 5c 74 27 3a 0a 20 20 20 20   case '\t':.    
29a0: 20 20 63 61 73 65 20 27 5c 6e 27 3a 0a 20 20 20    case '\n':.   
29b0: 20 20 20 63 61 73 65 20 27 5c 66 27 3a 20 7b 0a     case '\f': {.
29c0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
29d0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73       }.      cas
29e0: 65 20 27 5c 27 27 3a 20 7b 0a 20 20 20 20 20 20  e '\'': {.      
29f0: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30    isComplete = 0
2a00: 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b  ;.        zSql++
2a10: 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28  ;.        while(
2a20: 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21   *zSql && *zSql!
2a30: 3d 27 5c 27 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b  ='\'' ){ zSql++;
2a40: 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a   }.        if( *
2a50: 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e  zSql==0 ) return
2a60: 20 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61   0;.        brea
2a70: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
2a80: 20 63 61 73 65 20 27 22 27 3a 20 7b 0a 20 20 20   case '"': {.   
2a90: 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20       isComplete 
2aa0: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7a 53 71  = 0;.        zSq
2ab0: 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 77 68 69  l++;.        whi
2ac0: 6c 65 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53  le( *zSql && *zS
2ad0: 71 6c 21 3d 27 22 27 20 29 7b 20 7a 53 71 6c 2b  ql!='"' ){ zSql+
2ae0: 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28  +; }.        if(
2af0: 20 2a 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75   *zSql==0 ) retu
2b00: 72 6e 20 30 3b 0a 20 20 20 20 20 20 20 20 62 72  rn 0;.        br
2b10: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eak;.      }.   
2b20: 20 20 20 63 61 73 65 20 27 2d 27 3a 20 7b 0a 20     case '-': {. 
2b30: 20 20 20 20 20 20 20 69 66 28 20 7a 53 71 6c 5b         if( zSql[
2b40: 31 5d 21 3d 27 2d 27 20 29 7b 0a 20 20 20 20 20  1]!='-' ){.     
2b50: 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20       isComplete 
2b60: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 62  = 0;.          b
2b70: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a  reak;.        }.
2b80: 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a          while( *
2b90: 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27  zSql && *zSql!='
2ba0: 5c 6e 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d  \n' ){ zSql++; }
2bb0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53  .        if( *zS
2bc0: 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 69  ql==0 ) return i
2bd0: 73 43 6f 6d 70 6c 65 74 65 3b 0a 20 20 20 20 20  sComplete;.     
2be0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
2bf0: 7d 20 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74  } .      default
2c00: 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f  : {.        isCo
2c10: 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20  mplete = 0;.    
2c20: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
2c30: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 7a 53 71   }.    }.    zSq
2c40: 6c 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  l++;.  }.  retur
2c50: 6e 20 69 73 43 6f 6d 70 6c 65 74 65 3b 0a 7d 0a  n isComplete;.}.
2c60: 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65 20 53  ./*.** Execute S
2c70: 51 4c 20 63 6f 64 65 2e 20 20 52 65 74 75 72 6e  QL code.  Return
2c80: 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49   one of the SQLI
2c90: 54 45 5f 20 73 75 63 63 65 73 73 2f 66 61 69 6c  TE_ success/fail
2ca0: 75 72 65 0a 2a 2a 20 63 6f 64 65 73 2e 20 20 41  ure.** codes.  A
2cb0: 6c 73 6f 20 77 72 69 74 65 20 61 6e 20 65 72 72  lso write an err
2cc0: 6f 72 20 6d 65 73 73 61 67 65 20 69 6e 74 6f 20  or message into 
2cd0: 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 20  memory obtained 
2ce0: 66 72 6f 6d 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29  from.** malloc()
2cf0: 20 61 6e 64 20 6d 61 6b 65 20 2a 70 7a 45 72 72   and make *pzErr
2d00: 4d 73 67 20 70 6f 69 6e 74 20 74 6f 20 74 68 61  Msg point to tha
2d10: 74 20 6d 65 73 73 61 67 65 2e 0a 2a 2a 0a 2a 2a  t message..**.**
2d20: 20 49 66 20 74 68 65 20 53 51 4c 20 69 73 20 61   If the SQL is a
2d30: 20 71 75 65 72 79 2c 20 74 68 65 6e 20 66 6f 72   query, then for
2d40: 20 65 61 63 68 20 72 6f 77 20 69 6e 20 74 68 65   each row in the
2d50: 20 71 75 65 72 79 20 72 65 73 75 6c 74 0a 2a 2a   query result.**
2d60: 20 74 68 65 20 78 43 61 6c 6c 62 61 63 6b 28 29   the xCallback()
2d70: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
2d80: 6c 65 64 2e 20 20 70 41 72 67 20 62 65 63 6f 6d  led.  pArg becom
2d90: 65 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20  es the first.** 
2da0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c  argument to xCal
2db0: 6c 62 61 63 6b 28 29 2e 20 20 49 66 20 78 43 61  lback().  If xCa
2dc0: 6c 6c 62 61 63 6b 3d 4e 55 4c 4c 20 74 68 65 6e  llback=NULL then
2dd0: 20 6e 6f 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20   no callback.** 
2de0: 69 73 20 69 6e 76 6f 6b 65 64 2c 20 65 76 65 6e  is invoked, even
2df0: 20 66 6f 72 20 71 75 65 72 69 65 73 2e 0a 2a 2f   for queries..*/
2e00: 0a 69 6e 74 20 73 71 6c 69 74 65 5f 65 78 65 63  .int sqlite_exec
2e10: 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c 20  (.  sqlite *db, 
2e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2e30: 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20  /* The database 
2e40: 6f 6e 20 77 68 69 63 68 20 74 68 65 20 53 51 4c  on which the SQL
2e50: 20 65 78 65 63 75 74 65 73 20 2a 2f 0a 20 20 63   executes */.  c
2e60: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
2e70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
2e80: 65 20 53 51 4c 20 74 6f 20 62 65 20 65 78 65 63  e SQL to be exec
2e90: 75 74 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65  uted */.  sqlite
2ea0: 5f 63 61 6c 6c 62 61 63 6b 20 78 43 61 6c 6c 62  _callback xCallb
2eb0: 61 63 6b 2c 20 20 2f 2a 20 49 6e 76 6f 6b 65 20  ack,  /* Invoke 
2ec0: 74 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 72 6f  this callback ro
2ed0: 75 74 69 6e 65 20 2a 2f 0a 20 20 76 6f 69 64 20  utine */.  void 
2ee0: 2a 70 41 72 67 2c 20 20 20 20 20 20 20 20 20 20  *pArg,          
2ef0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20         /* First 
2f00: 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c  argument to xCal
2f10: 6c 62 61 63 6b 28 29 20 2a 2f 0a 20 20 63 68 61  lback() */.  cha
2f20: 72 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20  r **pzErrMsg    
2f30: 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74           /* Writ
2f40: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73  e error messages
2f50: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 50 61   here */.){.  Pa
2f60: 72 73 65 20 73 50 61 72 73 65 3b 0a 0a 20 20 69  rse sParse;..  i
2f70: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20 2a 70  f( pzErrMsg ) *p
2f80: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69  zErrMsg = 0;.  i
2f90: 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20  f( (db->flags & 
2fa0: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a  SQLITE_Initializ
2fb0: 65 64 29 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e  ed)==0 ){.    in
2fc0: 74 20 72 63 20 3d 20 73 71 6c 69 74 65 49 6e 69  t rc = sqliteIni
2fd0: 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29 3b  t(db, pzErrMsg);
2fe0: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
2ff0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
3000: 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63  sqliteStrRealloc
3010: 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  (pzErrMsg);.    
3020: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
3030: 20 7d 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28   }.  }.  memset(
3040: 26 73 50 61 72 73 65 2c 20 30 2c 20 73 69 7a 65  &sParse, 0, size
3050: 6f 66 28 73 50 61 72 73 65 29 29 3b 0a 20 20 73  of(sParse));.  s
3060: 50 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20  Parse.db = db;. 
3070: 20 73 50 61 72 73 65 2e 70 42 65 20 3d 20 64 62   sParse.pBe = db
3080: 2d 3e 70 42 65 3b 0a 20 20 73 50 61 72 73 65 2e  ->pBe;.  sParse.
3090: 78 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c  xCallback = xCal
30a0: 6c 62 61 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e  lback;.  sParse.
30b0: 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73  pArg = pArg;.  s
30c0: 71 6c 69 74 65 52 75 6e 50 61 72 73 65 72 28 26  qliteRunParser(&
30d0: 73 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a  sParse, zSql, pz
30e0: 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 73  ErrMsg);.  if( s
30f0: 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69  qlite_malloc_fai
3100: 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  led ){.    sqlit
3110: 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  eSetString(pzErr
3120: 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d  Msg, "out of mem
3130: 6f 72 79 22 2c 20 30 29 3b 0a 20 20 20 20 73 50  ory", 0);.    sP
3140: 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45  arse.rc = SQLITE
3150: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71  _NOMEM;.  }.  sq
3160: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
3170: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20  zErrMsg);.  if( 
3180: 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49 54  sParse.rc==SQLIT
3190: 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 20 20  E_SCHEMA ){.    
31a0: 63 6c 65 61 72 48 61 73 68 54 61 62 6c 65 28 64  clearHashTable(d
31b0: 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  b);.  }.  return
31c0: 20 73 50 61 72 73 65 2e 72 63 3b 0a 7d 0a 0a 2f   sParse.rc;.}../
31d0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
31e0: 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62  e implements a b
31f0: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61  usy callback tha
3200: 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69  t sleeps and tri
3210: 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69  es.** again unti
3220: 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75  l a timeout valu
3230: 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54  e is reached.  T
3240: 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65  he timeout value
3250: 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65   is.** an intege
3260: 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  r number of mill
3270: 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20  iseconds passed 
3280: 69 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a  in as the first.
3290: 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ** argument..*/.
32a0: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
32b0: 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c  eDefaultBusyCall
32c0: 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a 54 69 6d  back(. void *Tim
32d0: 65 6f 75 74 2c 20 20 20 20 20 20 20 20 20 20 20  eout,           
32e0: 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e  /* Maximum amoun
32f0: 74 20 6f 66 20 74 69 6d 65 20 74 6f 20 77 61 69  t of time to wai
3300: 74 20 2a 2f 0a 20 63 6f 6e 73 74 20 63 68 61 72  t */. const char
3310: 20 2a 4e 6f 74 55 73 65 64 2c 20 20 20 20 20 2f   *NotUsed,     /
3320: 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  * The name of th
3330: 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20  e table that is 
3340: 62 75 73 79 20 2a 2f 0a 20 69 6e 74 20 63 6f 75  busy */. int cou
3350: 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20  nt              
3360: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74    /* Number of t
3370: 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20 62  imes table has b
3380: 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23  een busy */.){.#
3390: 69 66 20 53 51 4c 49 54 45 5f 4d 49 4e 5f 53 4c  if SQLITE_MIN_SL
33a0: 45 45 50 5f 4d 53 3d 3d 31 0a 20 20 69 6e 74 20  EEP_MS==1.  int 
33b0: 64 65 6c 61 79 20 3d 20 31 30 3b 0a 20 20 69 6e  delay = 10;.  in
33c0: 74 20 70 72 69 6f 72 5f 64 65 6c 61 79 20 3d 20  t prior_delay = 
33d0: 30 3b 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74  0;.  int timeout
33e0: 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75 74 3b   = (int)Timeout;
33f0: 0a 20 20 69 6e 74 20 69 3b 0a 0a 20 20 66 6f 72  .  int i;..  for
3400: 28 69 3d 31 3b 20 69 3c 63 6f 75 6e 74 3b 20 69  (i=1; i<count; i
3410: 2b 2b 29 7b 20 0a 20 20 20 20 70 72 69 6f 72 5f  ++){ .    prior_
3420: 64 65 6c 61 79 20 2b 3d 20 64 65 6c 61 79 3b 0a  delay += delay;.
3430: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61      delay = dela
3440: 79 2a 32 3b 0a 20 20 20 20 69 66 28 20 64 65 6c  y*2;.    if( del
3450: 61 79 3e 3d 31 30 30 30 20 29 7b 0a 20 20 20 20  ay>=1000 ){.    
3460: 20 20 64 65 6c 61 79 20 3d 20 31 30 30 30 3b 0a    delay = 1000;.
3470: 20 20 20 20 20 20 70 72 69 6f 72 5f 64 65 6c 61        prior_dela
3480: 79 20 2b 3d 20 31 30 30 30 2a 28 63 6f 75 6e 74  y += 1000*(count
3490: 20 2d 20 69 20 2d 20 31 29 3b 0a 20 20 20 20 20   - i - 1);.     
34a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
34b0: 7d 0a 20 20 69 66 28 20 70 72 69 6f 72 5f 64 65  }.  if( prior_de
34c0: 6c 61 79 20 2b 20 64 65 6c 61 79 20 3e 20 74 69  lay + delay > ti
34d0: 6d 65 6f 75 74 2a 31 30 30 30 20 29 7b 0a 20 20  meout*1000 ){.  
34e0: 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75    delay = timeou
34f0: 74 2a 31 30 30 30 20 2d 20 70 72 69 6f 72 5f 64  t*1000 - prior_d
3500: 65 6c 61 79 3b 0a 20 20 20 20 69 66 28 20 64 65  elay;.    if( de
3510: 6c 61 79 3c 3d 30 20 29 20 72 65 74 75 72 6e 20  lay<=0 ) return 
3520: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f  0;.  }.  sqliteO
3530: 73 53 6c 65 65 70 28 64 65 6c 61 79 29 3b 0a 20  sSleep(delay);. 
3540: 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65   return 1;.#else
3550: 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d  .  int timeout =
3560: 20 28 69 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20   (int)Timeout;. 
3570: 20 69 66 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31   if( (count+1)*1
3580: 30 30 30 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b  000 > timeout ){
3590: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
35a0: 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c 65   }.  sqliteOsSle
35b0: 65 70 28 31 30 30 30 29 3b 0a 20 20 72 65 74 75  ep(1000);.  retu
35c0: 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a  rn 1;.#endif.}..
35d0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
35e0: 6e 65 20 73 65 74 73 20 74 68 65 20 62 75 73 79  ne sets the busy
35f0: 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e   callback for an
3600: 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65   Sqlite database
3610: 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e   to the.** given
3620: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   callback functi
3630: 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65  on with the give
3640: 6e 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 76  n argument..*/.v
3650: 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73 79 5f  oid sqlite_busy_
3660: 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74  handler(.  sqlit
3670: 65 20 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78  e *db,.  int (*x
3680: 42 75 73 79 29 28 76 6f 69 64 2a 2c 63 6f 6e 73  Busy)(void*,cons
3690: 74 20 63 68 61 72 2a 2c 69 6e 74 29 2c 0a 20 20  t char*,int),.  
36a0: 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20  void *pArg.){.  
36b0: 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61 63  db->xBusyCallbac
36c0: 6b 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 2d  k = xBusy;.  db-
36d0: 3e 70 42 75 73 79 41 72 67 20 3d 20 70 41 72 67  >pBusyArg = pArg
36e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
36f0: 72 6f 75 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73  routine installs
3700: 20 61 20 64 65 66 61 75 6c 74 20 62 75 73 79 20   a default busy 
3710: 68 61 6e 64 6c 65 72 20 74 68 61 74 20 77 61 69  handler that wai
3720: 74 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70  ts for the.** sp
3730: 65 63 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f  ecified number o
3740: 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62  f milliseconds b
3750: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20  efore returning 
3760: 30 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  0..*/.void sqlit
3770: 65 5f 62 75 73 79 5f 74 69 6d 65 6f 75 74 28 73  e_busy_timeout(s
3780: 71 6c 69 74 65 20 2a 64 62 2c 20 69 6e 74 20 6d  qlite *db, int m
3790: 73 29 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 29  s){.  if( ms>0 )
37a0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 62 75 73  {.    sqlite_bus
37b0: 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 73 71  y_handler(db, sq
37c0: 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43  liteDefaultBusyC
37d0: 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29  allback, (void*)
37e0: 6d 73 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  ms);.  }else{.  
37f0: 20 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61    sqlite_busy_ha
3800: 6e 64 6c 65 72 28 64 62 2c 20 30 2c 20 30 29 3b  ndler(db, 0, 0);
3810: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61  .  }.}../*.** Ca
3820: 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20  use any pending 
3830: 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f  operation to sto
3840: 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 73  p at its earlies
3850: 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a  t opportunity..*
3860: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 69 6e  /.void sqlite_in
3870: 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 20 2a  terrupt(sqlite *
3880: 64 62 29 7b 0a 20 20 64 62 2d 3e 66 6c 61 67 73  db){.  db->flags
3890: 20 7c 3d 20 53 51 4c 49 54 45 5f 49 6e 74 65 72   |= SQLITE_Inter
38a0: 72 75 70 74 3b 0a 7d 0a                          rupt;.}.