/ Hex Artifact Content
Login

Artifact 567e472a1ca22f7d9970b1f96b9be91d45ccd7e2:


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 35 33 20 32 30 30 32 2f 30 31 2f  ,v 1.53 2002/01/
0280: 30 36 20 31 37 3a 30 37 3a 34 30 20 64 72 68 20  06 17:07:40 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 66 69 6c 65 2d 66 6f 72 6d 61 74 22   = "file-format"
03a0: 20 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b   or "schema-cook
03b0: 69 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f  ie" or "table" o
03c0: 72 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20  r "index".**    
03d0: 20 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65   argv[1] = table
03e0: 20 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f   or index name o
03f0: 72 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74  r meta statement
0400: 20 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72   type..**     ar
0410: 67 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67  gv[2] = root pag
0420: 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62  e number for tab
0430: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55  le or index.  NU
0440: 4c 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20  LL for meta..** 
0450: 20 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51      argv[3] = SQ
0460: 4c 20 63 72 65 61 74 65 20 73 74 61 74 65 6d 65  L create stateme
0470: 6e 74 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65  nt for the table
0480: 20 6f 72 20 69 6e 64 65 78 0a 2a 2a 0a 2a 2f 0a   or index.**.*/.
0490: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
04a0: 65 4f 70 65 6e 43 62 28 76 6f 69 64 20 2a 70 44  eOpenCb(void *pD
04b0: 62 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61  b, int argc, cha
04c0: 72 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a  r **argv, char *
04d0: 2a 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 73  *azColName){.  s
04e0: 71 6c 69 74 65 20 2a 64 62 20 3d 20 28 73 71 6c  qlite *db = (sql
04f0: 69 74 65 2a 29 70 44 62 3b 0a 20 20 50 61 72 73  ite*)pDb;.  Pars
0500: 65 20 73 50 61 72 73 65 3b 0a 20 20 69 6e 74 20  e sParse;.  int 
0510: 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20  nErr = 0;..  /* 
0520: 54 4f 44 4f 3a 20 44 6f 20 73 6f 6d 65 20 76 61  TODO: Do some va
0530: 6c 69 64 69 74 79 20 63 68 65 63 6b 73 20 6f 6e  lidity checks on
0540: 20 61 6c 6c 20 66 69 65 6c 64 73 2e 20 20 49 6e   all fields.  In
0550: 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 20 20 2a   particular,.  *
0560: 2a 20 6d 61 6b 65 20 73 75 72 65 20 66 69 65 6c  * make sure fiel
0570: 64 73 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69  ds do not contai
0580: 6e 20 4e 55 4c 4c 73 2e 20 4f 74 68 65 72 77 69  n NULLs. Otherwi
0590: 73 65 20 77 65 20 6d 69 67 68 74 20 63 6f 72 65  se we might core
05a0: 0a 20 20 2a 2a 20 77 68 65 6e 20 61 74 74 65 6d  .  ** when attem
05b0: 70 74 69 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c  pting to initial
05c0: 69 7a 65 20 66 72 6f 6d 20 61 20 63 6f 72 72 75  ize from a corru
05d0: 70 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  pt database file
05e0: 2e 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20  . */..  assert( 
05f0: 61 72 67 63 3d 3d 34 20 29 3b 0a 20 20 73 77 69  argc==4 );.  swi
0600: 74 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20  tch( argv[0][0] 
0610: 29 7b 0a 20 20 20 20 63 61 73 65 20 27 66 27 3a  ){.    case 'f':
0620: 20 7b 20 20 2f 2a 20 46 69 6c 65 20 66 6f 72 6d   {  /* File form
0630: 61 74 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e  at */.      db->
0640: 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 61 74  file_format = at
0650: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20  oi(argv[3]);.   
0660: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
0670: 20 20 20 20 63 61 73 65 20 27 73 27 3a 20 7b 20      case 's': { 
0680: 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65  /* Schema cookie
0690: 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 73 63   */.      db->sc
06a0: 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20 61 74  hema_cookie = at
06b0: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20  oi(argv[3]);.   
06c0: 20 20 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b     db->next_cook
06d0: 69 65 20 3d 20 64 62 2d 3e 73 63 68 65 6d 61 5f  ie = db->schema_
06e0: 63 6f 6f 6b 69 65 3b 0a 20 20 20 20 20 20 62 72  cookie;.      br
06f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
0700: 61 73 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73  ase 'i':.    cas
0710: 65 20 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45  e 't': {  /* CRE
0720: 41 54 45 20 54 41 42 4c 45 20 20 61 6e 64 20 43  ATE TABLE  and C
0730: 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74  REATE INDEX stat
0740: 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20  ements */.      
0750: 69 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20 61  if( argv[3] && a
0760: 72 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20  rgv[3][0] ){.   
0770: 20 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65       /* Call the
0780: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65   parser to proce
0790: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  ss a CREATE TABL
07a0: 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45  E or CREATE INDE
07b0: 58 20 73 74 61 74 65 6d 65 6e 74 2e 0a 20 20 20  X statement..   
07c0: 20 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61       ** But beca
07d0: 75 73 65 20 73 50 61 72 73 65 2e 69 6e 69 74 46  use sParse.initF
07e0: 6c 61 67 20 69 73 20 73 65 74 20 74 6f 20 31 2c  lag is set to 1,
07f0: 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73   no VDBE code is
0800: 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20   generated.     
0810: 20 20 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65     ** or execute
0820: 64 2e 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73  d.  All the pars
0830: 65 72 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64  er does is build
0840: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61   the internal da
0850: 74 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74  ta.        ** st
0860: 72 75 63 74 75 72 65 73 20 74 68 61 74 20 64 65  ructures that de
0870: 73 63 72 69 62 65 20 74 68 65 20 74 61 62 6c 65  scribe the table
0880: 20 6f 72 20 69 6e 64 65 78 2e 0a 20 20 20 20 20   or index..     
0890: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65     */.        me
08a0: 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c  mset(&sParse, 0,
08b0: 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29   sizeof(sParse))
08c0: 3b 0a 20 20 20 20 20 20 20 20 73 50 61 72 73 65  ;.        sParse
08d0: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 20 20 20 20  .db = db;.      
08e0: 20 20 73 50 61 72 73 65 2e 69 6e 69 74 46 6c 61    sParse.initFla
08f0: 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 73  g = 1;.        s
0900: 50 61 72 73 65 2e 6e 65 77 54 6e 75 6d 20 3d 20  Parse.newTnum = 
0910: 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20  atoi(argv[2]);. 
0920: 20 20 20 20 20 20 20 73 71 6c 69 74 65 52 75 6e         sqliteRun
0930: 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c 20  Parser(&sParse, 
0940: 61 72 67 76 5b 33 5d 2c 20 30 29 3b 0a 20 20 20  argv[3], 0);.   
0950: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
0960: 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c 20    /* If the SQL 
0970: 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20  column is blank 
0980: 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73  it means this is
0990: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a 20   an index that. 
09a0: 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20 63 72         ** was cr
09b0: 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65 20  eated to be the 
09c0: 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20 74  PRIMARY KEY or t
09d0: 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49 51  o fulfill a UNIQ
09e0: 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20 63 6f  UE.        ** co
09f0: 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61 20 43  nstraint for a C
0a00: 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 54 68  REATE TABLE.  Th
0a10: 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64 20 68  e index should h
0a20: 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 20 20  ave already.    
0a30: 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65 61      ** been crea
0a40: 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f 63  ted when we proc
0a50: 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54 45  essed the CREATE
0a60: 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65 20   TABLE.  All we 
0a70: 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a 2a 20  have.        ** 
0a80: 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72 65  to do here is re
0a90: 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70 61  cord the root pa
0aa0: 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68  ge number for th
0ab0: 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 20 20  at index..      
0ac0: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 49 6e 64    */.        Ind
0ad0: 65 78 20 2a 70 49 6e 64 65 78 20 3d 20 73 71 6c  ex *pIndex = sql
0ae0: 69 74 65 46 69 6e 64 49 6e 64 65 78 28 64 62 2c  iteFindIndex(db,
0af0: 20 61 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 20   argv[1]);.     
0b00: 20 20 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30     if( pIndex==0
0b10: 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d   || pIndex->tnum
0b20: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20  !=0 ){.         
0b30: 20 6e 45 72 72 2b 2b 3b 0a 20 20 20 20 20 20 20   nErr++;.       
0b40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
0b50: 20 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d    pIndex->tnum =
0b60: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a   atoi(argv[2]);.
0b70: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
0b80: 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  }.      break;. 
0b90: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74     }.    default
0ba0: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69  : {.      /* Thi
0bb0: 73 20 63 61 6e 20 6e 6f 74 20 68 61 70 70 65 6e  s can not happen
0bc0: 21 20 2a 2f 0a 20 20 20 20 20 20 6e 45 72 72 20  ! */.      nErr 
0bd0: 3d 20 31 3b 0a 20 20 20 20 20 20 61 73 73 65 72  = 1;.      asser
0be0: 74 28 20 6e 45 72 72 3d 3d 30 20 29 3b 0a 20 20  t( nErr==0 );.  
0bf0: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e    }.  }.  return
0c00: 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   nErr;.}../*.** 
0c10: 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20  Attempt to read 
0c20: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
0c30: 65 6d 61 20 61 6e 64 20 69 6e 69 74 69 61 6c 69  ema and initiali
0c40: 7a 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64  ze internal.** d
0c50: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 2e 20  ata structures. 
0c60: 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74   Return one of t
0c70: 68 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72  he SQLITE_ error
0c80: 20 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64   codes to.** ind
0c90: 69 63 61 74 65 20 73 75 63 63 65 73 73 20 6f 72  icate success or
0ca0: 20 66 61 69 6c 75 72 65 2e 0a 2a 2a 0a 2a 2a 20   failure..**.** 
0cb0: 41 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61  After the databa
0cc0: 73 65 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65  se is initialize
0cd0: 64 2c 20 74 68 65 20 53 51 4c 49 54 45 5f 49 6e  d, the SQLITE_In
0ce0: 69 74 69 61 6c 69 7a 65 64 0a 2a 2a 20 62 69 74  itialized.** bit
0cf0: 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66   is set in the f
0d00: 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68  lags field of th
0d10: 65 20 73 71 6c 69 74 65 20 73 74 72 75 63 74 75  e sqlite structu
0d20: 72 65 2e 20 20 41 6e 0a 2a 2a 20 61 74 74 65 6d  re.  An.** attem
0d30: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e  pt is made to in
0d40: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 64 61 74  itialize the dat
0d50: 61 62 61 73 65 20 61 73 20 73 6f 6f 6e 20 61 73  abase as soon as
0d60: 20 69 74 0a 2a 2a 20 69 73 20 6f 70 65 6e 65 64   it.** is opened
0d70: 2e 20 20 49 66 20 74 68 61 74 20 66 61 69 6c 73  .  If that fails
0d80: 20 28 70 65 72 68 61 70 73 20 62 65 63 61 75 73   (perhaps becaus
0d90: 65 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73  e another proces
0da0: 73 0a 2a 2a 20 68 61 73 20 74 68 65 20 73 71 6c  s.** has the sql
0db0: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
0dc0: 20 6c 6f 63 6b 65 64 29 20 74 68 61 6e 20 61 6e   locked) than an
0dd0: 6f 74 68 65 72 20 61 74 74 65 6d 70 74 0a 2a 2a  other attempt.**
0de0: 20 69 73 20 6d 61 64 65 20 74 68 65 20 66 69 72   is made the fir
0df0: 73 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61  st time the data
0e00: 62 61 73 65 20 69 73 20 61 63 63 65 73 73 65 64  base is accessed
0e10: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
0e20: 73 71 6c 69 74 65 49 6e 69 74 28 73 71 6c 69 74  sqliteInit(sqlit
0e30: 65 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a  e *db, char **pz
0e40: 45 72 72 4d 73 67 29 7b 0a 20 20 56 64 62 65 20  ErrMsg){.  Vdbe 
0e50: 2a 76 64 62 65 3b 0a 20 20 69 6e 74 20 72 63 3b  *vdbe;.  int rc;
0e60: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20  ..  /*.  ** The 
0e70: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20  master database 
0e80: 74 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75  table has a stru
0e90: 63 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a  cture like this.
0ea0: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68    */.  static ch
0eb0: 61 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61  ar master_schema
0ec0: 5b 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41  [] = .     "CREA
0ed0: 54 45 20 54 41 42 4c 45 20 22 20 4d 41 53 54 45  TE TABLE " MASTE
0ee0: 52 5f 4e 41 4d 45 20 22 20 28 5c 6e 22 0a 20 20  R_NAME " (\n".  
0ef0: 20 20 20 22 20 20 74 79 70 65 20 74 65 78 74 2c     "  type text,
0f00: 5c 6e 22 0a 20 20 20 20 20 22 20 20 6e 61 6d 65  \n".     "  name
0f10: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22   text,\n".     "
0f20: 20 20 74 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c    tbl_name text,
0f30: 5c 6e 22 0a 20 20 20 20 20 22 20 20 72 6f 6f 74  \n".     "  root
0f40: 70 61 67 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22  page integer,\n"
0f50: 0a 20 20 20 20 20 22 20 20 73 71 6c 20 74 65 78  .     "  sql tex
0f60: 74 5c 6e 22 0a 20 20 20 20 20 22 29 22 0a 20 20  t\n".     ")".  
0f70: 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c  ;..  /* The foll
0f80: 6f 77 69 6e 67 20 56 44 42 45 20 70 72 6f 67 72  owing VDBE progr
0f90: 61 6d 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e  am is used to in
0fa0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e 74  itialize the int
0fb0: 65 72 6e 61 6c 0a 20 20 2a 2a 20 73 74 72 75 63  ernal.  ** struc
0fc0: 74 75 72 65 20 68 6f 6c 64 69 6e 67 20 74 68 65  ture holding the
0fd0: 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 65   tables and inde
0fe0: 78 65 73 20 6f 66 20 74 68 65 20 64 61 74 61 62  xes of the datab
0ff0: 61 73 65 2e 0a 20 20 2a 2a 20 54 68 65 20 64 61  ase..  ** The da
1000: 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 73 20  tabase contains 
1010: 61 20 73 70 65 63 69 61 6c 20 74 61 62 6c 65 20  a special table 
1020: 6e 61 6d 65 64 20 22 73 71 6c 69 74 65 5f 6d 61  named "sqlite_ma
1030: 73 74 65 72 22 0a 20 20 2a 2a 20 64 65 66 69 6e  ster".  ** defin
1040: 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20  ed as follows:. 
1050: 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 43 52 45 41   **.  **    CREA
1060: 54 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f  TE TABLE sqlite_
1070: 6d 61 73 74 65 72 20 28 0a 20 20 2a 2a 20 20 20  master (.  **   
1080: 20 20 20 20 20 74 79 70 65 20 20 20 20 20 20 20       type       
1090: 74 65 78 74 2c 20 20 20 20 2d 2d 20 20 45 69 74  text,    --  Eit
10a0: 68 65 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22  her "table" or "
10b0: 69 6e 64 65 78 22 20 6f 72 20 22 6d 65 74 61 22  index" or "meta"
10c0: 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 6e 61 6d  .  **        nam
10d0: 65 20 20 20 20 20 20 20 74 65 78 74 2c 20 20 20  e       text,   
10e0: 20 2d 2d 20 20 4e 61 6d 65 20 6f 66 20 74 61 62   --  Name of tab
10f0: 6c 65 20 6f 72 20 69 6e 64 65 78 0a 20 20 2a 2a  le or index.  **
1100: 20 20 20 20 20 20 20 20 74 62 6c 5f 6e 61 6d 65          tbl_name
1110: 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d 20 20     text,    --  
1120: 41 73 73 6f 63 69 61 74 65 64 20 74 61 62 6c 65  Associated table
1130: 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 72 6f   .  **        ro
1140: 6f 74 70 61 67 65 20 20 20 69 6e 74 65 67 65 72  otpage   integer
1150: 2c 20 2d 2d 20 20 54 68 65 20 69 6e 74 65 67 65  , --  The intege
1160: 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66  r page number of
1170: 20 72 6f 6f 74 20 70 61 67 65 0a 20 20 2a 2a 20   root page.  ** 
1180: 20 20 20 20 20 20 20 73 71 6c 20 20 20 20 20 20         sql      
1190: 20 20 74 65 78 74 20 20 20 20 20 2d 2d 20 20 54    text     --  T
11a0: 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65 6d  he CREATE statem
11b0: 65 6e 74 20 66 6f 72 20 74 68 69 73 20 6f 62 6a  ent for this obj
11c0: 65 63 74 0a 20 20 2a 2a 20 20 20 20 29 3b 0a 20  ect.  **    );. 
11d0: 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 73 71 6c   **.  ** The sql
11e0: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
11f0: 20 63 6f 6e 74 61 69 6e 73 20 61 20 73 69 6e 67   contains a sing
1200: 6c 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63  le entry for eac
1210: 68 20 74 61 62 6c 65 0a 20 20 2a 2a 20 61 6e 64  h table.  ** and
1220: 20 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54 68   each index.  Th
1230: 65 20 22 74 79 70 65 22 20 63 6f 6c 75 6d 6e 20  e "type" column 
1240: 74 65 6c 6c 73 20 77 68 65 74 68 65 72 20 74 68  tells whether th
1250: 65 20 65 6e 74 72 79 20 69 73 0a 20 20 2a 2a 20  e entry is.  ** 
1260: 61 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  a table or index
1270: 2e 20 20 54 68 65 20 22 6e 61 6d 65 22 20 63 6f  .  The "name" co
1280: 6c 75 6d 6e 20 69 73 20 74 68 65 20 6e 61 6d 65  lumn is the name
1290: 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a   of the object..
12a0: 20 20 2a 2a 20 54 68 65 20 22 74 62 6c 5f 6e 61    ** The "tbl_na
12b0: 6d 65 22 20 69 73 20 74 68 65 20 6e 61 6d 65 20  me" is the name 
12c0: 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74 65  of the associate
12d0: 64 20 74 61 62 6c 65 2e 20 20 46 6f 72 20 74 61  d table.  For ta
12e0: 62 6c 65 73 2c 0a 20 20 2a 2a 20 74 68 65 20 74  bles,.  ** the t
12f0: 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 69  bl_name column i
1300: 73 20 61 6c 77 61 79 73 20 74 68 65 20 73 61 6d  s always the sam
1310: 65 20 61 73 20 6e 61 6d 65 2e 20 20 46 6f 72 20  e as name.  For 
1320: 69 6e 64 69 63 65 73 2c 20 74 68 65 0a 20 20 2a  indices, the.  *
1330: 2a 20 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d  * tbl_name colum
1340: 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e  n contains the n
1350: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65  ame of the table
1360: 20 74 68 61 74 20 74 68 65 20 69 6e 64 65 78 0a   that the index.
1370: 20 20 2a 2a 20 69 6e 64 65 78 65 73 2e 20 20 54    ** indexes.  T
1380: 68 65 20 22 72 6f 6f 74 70 61 67 65 22 20 63 6f  he "rootpage" co
1390: 6c 75 6d 6e 20 68 6f 6c 64 73 20 74 68 65 20 6e  lumn holds the n
13a0: 75 6d 62 65 72 20 6f 66 20 74 68 65 20 72 6f 6f  umber of the roo
13b0: 74 20 70 61 67 65 0a 20 20 2a 2a 20 66 6f 72 20  t page.  ** for 
13c0: 74 68 65 20 62 2d 74 72 65 65 20 66 6f 72 20 74  the b-tree for t
13d0: 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65  he table or inde
13e0: 78 2e 20 20 46 69 6e 61 6c 6c 79 2c 20 74 68 65  x.  Finally, the
13f0: 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 0a 20 20   "sql" column.  
1400: 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  ** contains the 
1410: 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66  complete text of
1420: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
1430: 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45  E or CREATE INDE
1440: 58 0a 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74  X.  ** statement
1450: 20 74 68 61 74 20 6f 72 69 67 69 6e 61 6c 6c 79   that originally
1460: 20 63 72 65 61 74 65 64 20 74 68 65 20 74 61 62   created the tab
1470: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 49 66  le or index.  If
1480: 20 61 6e 20 69 6e 64 65 78 0a 20 20 2a 2a 20 77   an index.  ** w
1490: 61 73 20 63 72 65 61 74 65 64 20 74 6f 20 66 75  as created to fu
14a0: 6c 66 69 6c 6c 20 61 20 50 52 49 4d 41 52 59 20  lfill a PRIMARY 
14b0: 4b 45 59 20 6f 72 20 55 4e 49 51 55 45 20 63 6f  KEY or UNIQUE co
14c0: 6e 73 74 72 61 69 6e 74 20 6f 6e 20 61 20 74 61  nstraint on a ta
14d0: 62 6c 65 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 74  ble,.  ** then t
14e0: 68 65 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 20  he "sql" column 
14f0: 69 73 20 4e 55 4c 4c 2e 0a 20 20 2a 2a 0a 20 20  is NULL..  **.  
1500: 2a 2a 20 49 66 20 74 68 65 20 22 74 79 70 65 22  ** If the "type"
1510: 20 63 6f 6c 75 6d 6e 20 68 61 73 20 74 68 65 20   column has the 
1520: 76 61 6c 75 65 20 22 6d 65 74 61 22 2c 20 74 68  value "meta", th
1530: 65 6e 20 74 68 65 20 22 73 71 6c 22 20 63 6f 6c  en the "sql" col
1540: 75 6d 6e 0a 20 20 2a 2a 20 63 6f 6e 74 61 69 6e  umn.  ** contain
1550: 73 20 65 78 74 72 61 20 69 6e 66 6f 72 6d 61 74  s extra informat
1560: 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 64 61  ion about the da
1570: 74 61 62 61 73 65 2c 20 73 75 63 68 20 61 73 20  tabase, such as 
1580: 74 68 65 0a 20 20 2a 2a 20 66 69 6c 65 20 66 6f  the.  ** file fo
1590: 72 6d 61 74 20 76 65 72 73 69 6f 6e 20 6e 75 6d  rmat version num
15a0: 62 65 72 2e 20 20 41 6c 6c 20 6d 65 74 61 20 69  ber.  All meta i
15b0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 6d 75 73 74 20  nformation must 
15c0: 62 65 20 70 72 6f 63 65 73 73 65 64 0a 20 20 2a  be processed.  *
15d0: 2a 20 62 65 66 6f 72 65 20 61 6e 79 20 74 61 62  * before any tab
15e0: 6c 65 73 20 6f 72 20 69 6e 64 69 63 65 73 20 61  les or indices a
15f0: 72 65 20 63 6f 6e 73 74 72 75 63 74 65 64 2e 0a  re constructed..
1600: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f    **.  ** The fo
1610: 6c 6c 6f 77 69 6e 67 20 70 72 6f 67 72 61 6d 20  llowing program 
1620: 69 6e 76 6f 6b 65 73 20 69 74 73 20 63 61 6c 6c  invokes its call
1630: 62 61 63 6b 20 6f 6e 20 74 68 65 20 53 51 4c 20  back on the SQL 
1640: 66 6f 72 20 65 61 63 68 0a 20 20 2a 2a 20 74 61  for each.  ** ta
1650: 62 6c 65 20 74 68 65 6e 20 67 6f 65 73 20 62 61  ble then goes ba
1660: 63 6b 20 61 6e 64 20 69 6e 76 6f 6b 65 73 20 74  ck and invokes t
1670: 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 20 74  he callback on t
1680: 68 65 0a 20 20 2a 2a 20 53 51 4c 20 66 6f 72 20  he.  ** SQL for 
1690: 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54 68 65  each index.  The
16a0: 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 20 69   callback will i
16b0: 6e 76 6f 6b 65 20 74 68 65 0a 20 20 2a 2a 20 70  nvoke the.  ** p
16c0: 61 72 73 65 72 20 74 6f 20 62 75 69 6c 64 20 74  arser to build t
16d0: 68 65 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72  he internal repr
16e0: 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68  esentation of th
16f0: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  e.  ** database 
1700: 73 63 68 65 6d 65 2e 0a 20 20 2a 2f 0a 20 20 73  scheme..  */.  s
1710: 74 61 74 69 63 20 56 64 62 65 4f 70 20 69 6e 69  tatic VdbeOp ini
1720: 74 50 72 6f 67 5b 5d 20 3d 20 7b 0a 20 20 20 20  tProg[] = {.    
1730: 7b 20 4f 50 5f 4f 70 65 6e 2c 20 20 20 20 20 20  { OP_Open,      
1740: 20 30 2c 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 2,  0},.    
1750: 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 20  { OP_String,    
1760: 20 30 2c 20 30 2c 20 20 22 66 69 6c 65 2d 66 6f   0, 0,  "file-fo
1770: 72 6d 61 74 22 7d 2c 0a 20 20 20 20 7b 20 4f 50  rmat"},.    { OP
1780: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20  _String,     0, 
1790: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  0,  0},.    { OP
17a0: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20  _String,     0, 
17b0: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  0,  0},.    { OP
17c0: 5f 52 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20  _ReadCookie, 0, 
17d0: 31 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  1,  0},.    { OP
17e0: 5f 43 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20  _Callback,   4, 
17f0: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  0,  0},.    { OP
1800: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20  _String,     0, 
1810: 30 2c 20 20 22 73 63 68 65 6d 61 5f 63 6f 6f 6b  0,  "schema_cook
1820: 69 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53  ie"},.    { OP_S
1830: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c  tring,     0, 0,
1840: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53    0},.    { OP_S
1850: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c  tring,     0, 0,
1860: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52    0},.    { OP_R
1870: 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20 30 2c  eadCookie, 0, 0,
1880: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43    0},.    { OP_C
1890: 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c  allback,   4, 0,
18a0: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52    0},.    { OP_R
18b0: 65 77 69 6e 64 2c 20 20 20 20 20 30 2c 20 33 31  ewind,     0, 31
18c0: 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43  , 0},.    { OP_C
18d0: 6f 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c  olumn,     0, 0,
18e0: 20 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20    0},           
18f0: 2f 2a 20 31 32 20 2a 2f 0a 20 20 20 20 7b 20 4f  /* 12 */.    { O
1900: 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c  P_String,     0,
1910: 20 30 2c 20 20 22 74 61 62 6c 65 22 7d 2c 0a 20   0,  "table"},. 
1920: 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20 20     { OP_Ne,     
1930: 20 20 20 20 30 2c 20 32 30 2c 20 30 7d 2c 0a 20      0, 20, 0},. 
1940: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
1950: 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20      0, 0,  0},. 
1960: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
1970: 20 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20      0, 1,  0},. 
1980: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
1990: 20 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20      0, 3,  0},. 
19a0: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20     { OP_Column, 
19b0: 20 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20      0, 4,  0},. 
19c0: 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b     { OP_Callback
19d0: 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20  ,   4, 0,  0},. 
19e0: 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20     { OP_Next,   
19f0: 20 20 20 20 30 2c 20 31 32 2c 20 30 7d 2c 20 20      0, 12, 0},  
1a00: 20 20 20 20 20 20 20 20 20 2f 2a 20 32 30 20 2a           /* 20 *
1a10: 2f 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77 69 6e  /.    { OP_Rewin
1a20: 64 2c 20 20 20 20 20 30 2c 20 33 31 2c 20 30 7d  d,     0, 31, 0}
1a30: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32  ,           /* 2
1a40: 31 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6f  1 */.    { OP_Co
1a50: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20  lumn,     0, 0, 
1a60: 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f   0},           /
1a70: 2a 20 32 32 20 2a 2f 0a 20 20 20 20 7b 20 4f 50  * 22 */.    { OP
1a80: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20  _String,     0, 
1a90: 30 2c 20 20 22 69 6e 64 65 78 22 7d 2c 0a 20 20  0,  "index"},.  
1aa0: 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20 20 20    { OP_Ne,      
1ab0: 20 20 20 30 2c 20 33 30 2c 20 30 7d 2c 0a 20 20     0, 30, 0},.  
1ac0: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1ad0: 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20     0, 0,  0},.  
1ae0: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1af0: 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 20     0, 1,  0},.  
1b00: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1b10: 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 20     0, 3,  0},.  
1b20: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20    { OP_Column,  
1b30: 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 20     0, 4,  0},.  
1b40: 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c    { OP_Callback,
1b50: 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20 20     4, 0,  0},.  
1b60: 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20 20    { OP_Next,    
1b70: 20 20 20 30 2c 20 32 32 2c 20 30 7d 2c 20 20 20     0, 22, 0},   
1b80: 20 20 20 20 20 20 20 20 2f 2a 20 33 30 20 2a 2f          /* 30 */
1b90: 0a 20 20 20 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c  .    { OP_Close,
1ba0: 20 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c        0, 0,  0},
1bb0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 33 31             /* 31
1bc0: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 48 61 6c   */.    { OP_Hal
1bd0: 74 2c 20 20 20 20 20 20 20 30 2c 20 30 2c 20 20  t,       0, 0,  
1be0: 30 7d 2c 0a 20 20 7d 3b 0a 0a 20 20 2f 2a 20 43  0},.  };..  /* C
1bf0: 72 65 61 74 65 20 61 20 76 69 72 74 75 61 6c 20  reate a virtual 
1c00: 6d 61 63 68 69 6e 65 20 74 6f 20 72 75 6e 20 74  machine to run t
1c10: 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f  he initializatio
1c20: 6e 20 70 72 6f 67 72 61 6d 2e 20 20 52 75 6e 0a  n program.  Run.
1c30: 20 20 2a 2a 20 74 68 65 20 70 72 6f 67 72 61 6d    ** the program
1c40: 2e 20 20 54 68 65 6e 20 64 65 6c 65 74 65 20 74  .  Then delete t
1c50: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  he virtual machi
1c60: 6e 65 2e 0a 20 20 2a 2f 0a 20 20 76 64 62 65 20  ne..  */.  vdbe 
1c70: 3d 20 73 71 6c 69 74 65 56 64 62 65 43 72 65 61  = sqliteVdbeCrea
1c80: 74 65 28 64 62 29 3b 0a 20 20 69 66 28 20 76 64  te(db);.  if( vd
1c90: 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c  be==0 ){.    sql
1ca0: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45  iteSetString(pzE
1cb0: 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d  rrMsg, "out of m
1cc0: 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 20 20  emory", 0);.    
1cd0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
1ce0: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  MEM;.  }.  sqlit
1cf0: 65 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 76  eVdbeAddOpList(v
1d00: 64 62 65 2c 20 73 69 7a 65 6f 66 28 69 6e 69 74  dbe, sizeof(init
1d10: 50 72 6f 67 29 2f 73 69 7a 65 6f 66 28 69 6e 69  Prog)/sizeof(ini
1d20: 74 50 72 6f 67 5b 30 5d 29 2c 20 69 6e 69 74 50  tProg[0]), initP
1d30: 72 6f 67 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c  rog);.  rc = sql
1d40: 69 74 65 56 64 62 65 45 78 65 63 28 76 64 62 65  iteVdbeExec(vdbe
1d50: 2c 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 2c 20  , sqliteOpenCb, 
1d60: 64 62 2c 20 70 7a 45 72 72 4d 73 67 2c 20 0a 20  db, pzErrMsg, . 
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d80: 20 20 20 20 20 64 62 2d 3e 70 42 75 73 79 41 72       db->pBusyAr
1d90: 67 2c 20 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c  g, db->xBusyCall
1da0: 62 61 63 6b 29 3b 0a 20 20 73 71 6c 69 74 65 56  back);.  sqliteV
1db0: 64 62 65 44 65 6c 65 74 65 28 76 64 62 65 29 3b  dbeDelete(vdbe);
1dc0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
1dd0: 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e 54 61 62  E_OK && db->nTab
1de0: 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d  le==0 ){.    db-
1df0: 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 46  >file_format = F
1e00: 49 4c 45 5f 46 4f 52 4d 41 54 3b 0a 20 20 7d 0a  ILE_FORMAT;.  }.
1e10: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
1e20: 5f 4f 4b 20 26 26 20 64 62 2d 3e 66 69 6c 65 5f  _OK && db->file_
1e30: 66 6f 72 6d 61 74 3e 46 49 4c 45 5f 46 4f 52 4d  format>FILE_FORM
1e40: 41 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  AT ){.    sqlite
1e50: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
1e60: 73 67 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64  sg, "unsupported
1e70: 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 30   file format", 0
1e80: 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  );.    rc = SQLI
1e90: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20  TE_ERROR;.  }.. 
1ea0: 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 20 66   /* The schema f
1eb0: 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41  or the SQLITE_MA
1ec0: 53 54 45 52 20 74 61 62 6c 65 20 69 73 20 6e 6f  STER table is no
1ed0: 74 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a  t stored in the.
1ee0: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 74    ** database it
1ef0: 73 65 6c 66 2e 20 20 57 65 20 68 61 76 65 20 74  self.  We have t
1f00: 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c  o invoke the cal
1f10: 6c 62 61 63 6b 20 6f 6e 65 20 65 78 74 72 61 0a  lback one extra.
1f20: 20 20 2a 2a 20 74 69 6d 65 20 74 6f 20 67 65 74    ** time to get
1f30: 20 69 74 20 74 6f 20 70 72 6f 63 65 73 73 20 74   it to process t
1f40: 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52  he SQLITE_MASTER
1f50: 20 74 61 62 6c 65 20 64 65 66 69 6e 74 69 6f 6e   table defintion
1f60: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d  ..  */.  if( rc=
1f70: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
1f80: 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20    Table *pTab;. 
1f90: 20 20 20 63 68 61 72 20 2a 61 7a 41 72 67 5b 36     char *azArg[6
1fa0: 5d 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30 5d 20  ];.    azArg[0] 
1fb0: 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 20 20 61  = "table";.    a
1fc0: 7a 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54 45 52  zArg[1] = MASTER
1fd0: 5f 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41 72 67  _NAME;.    azArg
1fe0: 5b 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20 20 61  [2] = "2";.    a
1ff0: 7a 41 72 67 5b 33 5d 20 3d 20 6d 61 73 74 65 72  zArg[3] = master
2000: 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a 41  _schema;.    azA
2010: 72 67 5b 34 5d 20 3d 20 30 3b 0a 20 20 20 20 73  rg[4] = 0;.    s
2020: 71 6c 69 74 65 4f 70 65 6e 43 62 28 64 62 2c 20  qliteOpenCb(db, 
2030: 34 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20  4, azArg, 0);.  
2040: 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 46    pTab = sqliteF
2050: 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d 41 53  indTable(db, MAS
2060: 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20 20 69  TER_NAME);.    i
2070: 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 20  f( pTab ){.     
2080: 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79 20   pTab->readOnly 
2090: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64  = 1;.    }.    d
20a0: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49  b->flags |= SQLI
20b0: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a  TE_Initialized;.
20c0: 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69 74      sqliteCommit
20d0: 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28  InternalChanges(
20e0: 64 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  db);.  }.  retur
20f0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  n rc;.}../*.** T
2100: 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68  he version of th
2110: 65 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e  e library.*/.con
2120: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 76  st char sqlite_v
2130: 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54  ersion[] = SQLIT
2140: 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a 0a 2a  E_VERSION;../*.*
2150: 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62 72 61  * Does the libra
2160: 72 79 20 65 78 70 65 63 74 20 64 61 74 61 20 74  ry expect data t
2170: 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61 73 20  o be encoded as 
2180: 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38 35 39  UTF-8 or iso8859
2190: 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c 6f 77  ?  The.** follow
21a0: 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e 73 74  ing global const
21b0: 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74 73 20  ant always lets 
21c0: 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69 66 64  us know..*/.#ifd
21d0: 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38 0a 63  ef SQLITE_UTF8.c
21e0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
21f0: 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 55  _encoding[] = "U
2200: 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63 6f 6e  TF-8";.#else.con
2210: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 65  st char sqlite_e
2220: 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69 73 6f  ncoding[] = "iso
2230: 38 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a 0a 2f  8859";.#endif../
2240: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20  *.** Open a new 
2250: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e  SQLite database.
2260: 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e 20 22    Construct an "
2270: 73 71 6c 69 74 65 22 20 73 74 72 75 63 74 75 72  sqlite" structur
2280: 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a 20 74  e to define.** t
2290: 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 69 73  he state of this
22a0: 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 72 65   database and re
22b0: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74  turn a pointer t
22c0: 6f 20 74 68 61 74 20 73 74 72 75 63 74 75 72 65  o that structure
22d0: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74 65 6d  ..**.** An attem
22e0: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e  pt is made to in
22f0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e 2d  itialize the in-
2300: 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74 72 75  memory data stru
2310: 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a 20 68  ctures that.** h
2320: 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61 73 65  old the database
2330: 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20 69 66   schema.  But if
2340: 20 74 68 69 73 20 66 61 69 6c 73 20 28 62 65 63   this fails (bec
2350: 61 75 73 65 20 74 68 65 20 73 63 68 65 6d 61 20  ause the schema 
2360: 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63 6b 65  file.** is locke
2370: 64 29 20 74 68 65 6e 20 74 68 61 74 20 73 74 65  d) then that ste
2380: 70 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e  p is deferred un
2390: 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 63 61  til the first ca
23a0: 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 5f  ll to.** sqlite_
23b0: 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c 69 74  exec()..*/.sqlit
23c0: 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e 28 63  e *sqlite_open(c
23d0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
23e0: 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65 2c 20  name, int mode, 
23f0: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29  char **pzErrMsg)
2400: 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 3b 0a  {.  sqlite *db;.
2410: 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 20    int rc;..  /* 
2420: 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c  Allocate the sql
2430: 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 75  ite data structu
2440: 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c  re */.  db = sql
2450: 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f  iteMalloc( sizeo
2460: 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20 20 69  f(sqlite) );.  i
2470: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20 2a 70  f( pzErrMsg ) *p
2480: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69  zErrMsg = 0;.  i
2490: 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20  f( db==0 ) goto 
24a0: 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a  no_mem_on_open;.
24b0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
24c0: 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53  (&db->tblHash, S
24d0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e  QLITE_HASH_STRIN
24e0: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48  G, 0);.  sqliteH
24f0: 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69 64 78  ashInit(&db->idx
2500: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53  Hash, SQLITE_HAS
2510: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20  H_STRING, 0);.  
2520: 64 62 2d 3e 6e 65 78 74 52 6f 77 69 64 20 3d 20  db->nextRowid = 
2530: 73 71 6c 69 74 65 52 61 6e 64 6f 6d 49 6e 74 65  sqliteRandomInte
2540: 67 65 72 28 29 3b 0a 20 20 0a 20 20 2f 2a 20 4f  ger();.  .  /* O
2550: 70 65 6e 20 74 68 65 20 62 61 63 6b 65 6e 64 20  pen the backend 
2560: 64 61 74 61 62 61 73 65 20 64 72 69 76 65 72 20  database driver 
2570: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  */.  rc = sqlite
2580: 42 74 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e  BtreeOpen(zFilen
2590: 61 6d 65 2c 20 6d 6f 64 65 2c 20 4d 41 58 5f 50  ame, mode, MAX_P
25a0: 41 47 45 53 2c 20 26 64 62 2d 3e 70 42 65 29 3b  AGES, &db->pBe);
25b0: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  .  if( rc!=SQLIT
25c0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 77 69 74  E_OK ){.    swit
25d0: 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20  ch( rc ){.      
25e0: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20  default: {.     
25f0: 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69     sqliteSetStri
2600: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e  ng(pzErrMsg, "un
2610: 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74  able to open dat
2620: 61 62 61 73 65 3a 20 22 2c 20 7a 46 69 6c 65 6e  abase: ", zFilen
2630: 61 6d 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d  ame, 0);.      }
2640: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
2650: 65 46 72 65 65 28 64 62 29 3b 0a 20 20 20 20 73  eFree(db);.    s
2660: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28  qliteStrRealloc(
2670: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72  pzErrMsg);.    r
2680: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20  eturn 0;.  }..  
2690: 2f 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65  /* Attempt to re
26a0: 61 64 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f  ad the schema */
26b0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 49 6e  .  rc = sqliteIn
26c0: 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29  it(db, pzErrMsg)
26d0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d  ;.  if( sqlite_m
26e0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
26f0: 20 20 20 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65      sqlite_close
2700: 28 64 62 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6e  (db);.    goto n
2710: 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20  o_mem_on_open;. 
2720: 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53   }else if( rc!=S
2730: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d  QLITE_OK && rc!=
2740: 53 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20  SQLITE_BUSY ){. 
2750: 20 20 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28     sqlite_close(
2760: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53  db);.    sqliteS
2770: 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d  trRealloc(pzErrM
2780: 73 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  sg);.    return 
2790: 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70  0;.  }else if( p
27a0: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73  zErrMsg ){.    s
27b0: 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72 72  qliteFree(*pzErr
27c0: 4d 73 67 29 3b 0a 20 20 20 20 2a 70 7a 45 72 72  Msg);.    *pzErr
27d0: 4d 73 67 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72  Msg = 0;.  }.  r
27e0: 65 74 75 72 6e 20 64 62 3b 0a 0a 6e 6f 5f 6d 65  eturn db;..no_me
27f0: 6d 5f 6f 6e 5f 6f 70 65 6e 3a 0a 20 20 73 71 6c  m_on_open:.  sql
2800: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45  iteSetString(pzE
2810: 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d  rrMsg, "out of m
2820: 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 73 71  emory", 0);.  sq
2830: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
2840: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75  zErrMsg);.  retu
2850: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45  rn 0;.}../*.** E
2860: 72 61 73 65 20 61 6c 6c 20 73 63 68 65 6d 61 20  rase all schema 
2870: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d  information from
2880: 20 74 68 65 20 73 63 68 65 6d 61 20 68 61 73 68   the schema hash
2890: 20 74 61 62 6c 65 2e 20 20 45 78 63 65 70 74 0a   table.  Except.
28a0: 2a 2a 20 74 61 62 6c 65 73 20 74 68 61 74 20 61  ** tables that a
28b0: 72 65 20 63 72 65 61 74 65 64 20 75 73 69 6e 67  re created using
28c0: 20 43 52 45 41 54 45 20 54 45 4d 50 4f 52 41 52   CREATE TEMPORAR
28d0: 59 20 54 41 42 4c 45 20 61 72 65 20 70 72 65 73  Y TABLE are pres
28e0: 65 72 76 65 64 0a 2a 2a 20 69 66 20 74 68 65 20  erved.** if the 
28f0: 70 72 65 73 65 72 76 65 54 65 6d 70 73 20 66 6c  preserveTemps fl
2900: 61 67 20 69 73 20 74 72 75 65 2e 0a 2a 2a 0a 2a  ag is true..**.*
2910: 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 73  * The database s
2920: 63 68 65 6d 61 20 69 73 20 6e 6f 72 6d 61 6c 6c  chema is normall
2930: 79 20 72 65 61 64 20 69 6e 20 6f 6e 63 65 20 77  y read in once w
2940: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  hen the database
2950: 0a 2a 2a 20 69 73 20 66 69 72 73 74 20 6f 70 65  .** is first ope
2960: 6e 65 64 20 61 6e 64 20 73 74 6f 72 65 64 20 69  ned and stored i
2970: 6e 20 61 20 68 61 73 68 20 74 61 62 6c 65 20 69  n a hash table i
2980: 6e 20 74 68 65 20 73 71 6c 69 74 65 20 73 74 72  n the sqlite str
2990: 75 63 74 75 72 65 2e 0a 2a 2a 20 54 68 69 73 20  ucture..** This 
29a0: 72 6f 75 74 69 6e 65 20 65 72 61 73 65 73 20 74  routine erases t
29b0: 68 65 20 73 74 6f 72 65 64 20 73 63 68 65 6d 61  he stored schema
29c0: 2e 20 20 54 68 69 73 20 65 72 61 73 75 72 65 20  .  This erasure 
29d0: 6f 63 63 75 72 73 20 62 65 63 61 75 73 65 0a 2a  occurs because.*
29e0: 2a 20 65 69 74 68 65 72 20 74 68 65 20 64 61 74  * either the dat
29f0: 61 62 61 73 65 20 69 73 20 62 65 69 6e 67 20 63  abase is being c
2a00: 6c 6f 73 65 64 20 6f 72 20 62 65 63 61 75 73 65  losed or because
2a10: 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f 63   some other proc
2a20: 65 73 73 0a 2a 2a 20 63 68 61 6e 67 65 64 20 74  ess.** changed t
2a30: 68 65 20 73 63 68 65 6d 61 20 61 6e 64 20 74 68  he schema and th
2a40: 69 73 20 70 72 6f 63 65 73 73 20 6e 65 65 64 73  is process needs
2a50: 20 74 6f 20 72 65 72 65 61 64 20 69 74 2e 0a 2a   to reread it..*
2a60: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6c  /.static void cl
2a70: 65 61 72 48 61 73 68 54 61 62 6c 65 28 73 71 6c  earHashTable(sql
2a80: 69 74 65 20 2a 64 62 2c 20 69 6e 74 20 70 72 65  ite *db, int pre
2a90: 73 65 72 76 65 54 65 6d 70 73 29 7b 0a 20 20 48  serveTemps){.  H
2aa0: 61 73 68 45 6c 65 6d 20 2a 70 45 6c 65 6d 3b 0a  ashElem *pElem;.
2ab0: 20 20 48 61 73 68 20 74 65 6d 70 31 3b 0a 20 20    Hash temp1;.  
2ac0: 74 65 6d 70 31 20 3d 20 64 62 2d 3e 74 62 6c 48  temp1 = db->tblH
2ad0: 61 73 68 3b 0a 20 20 73 71 6c 69 74 65 48 61 73  ash;.  sqliteHas
2ae0: 68 49 6e 69 74 28 26 64 62 2d 3e 74 62 6c 48 61  hInit(&db->tblHa
2af0: 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  sh, SQLITE_HASH_
2b00: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71  STRING, 0);.  sq
2b10: 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28 26 64  liteHashClear(&d
2b20: 62 2d 3e 69 64 78 48 61 73 68 29 3b 0a 20 20 66  b->idxHash);.  f
2b30: 6f 72 28 70 45 6c 65 6d 3d 73 71 6c 69 74 65 48  or(pElem=sqliteH
2b40: 61 73 68 46 69 72 73 74 28 26 74 65 6d 70 31 29  ashFirst(&temp1)
2b50: 3b 20 70 45 6c 65 6d 3b 20 70 45 6c 65 6d 3d 73  ; pElem; pElem=s
2b60: 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28 70 45  qliteHashNext(pE
2b70: 6c 65 6d 29 29 7b 0a 20 20 20 20 54 61 62 6c 65  lem)){.    Table
2b80: 20 2a 70 54 61 62 20 3d 20 73 71 6c 69 74 65 48   *pTab = sqliteH
2b90: 61 73 68 44 61 74 61 28 70 45 6c 65 6d 29 3b 0a  ashData(pElem);.
2ba0: 20 20 20 20 69 66 28 20 70 72 65 73 65 72 76 65      if( preserve
2bb0: 54 65 6d 70 73 20 26 26 20 70 54 61 62 2d 3e 69  Temps && pTab->i
2bc0: 73 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 49  sTemp ){.      I
2bd0: 6e 64 65 78 20 2a 70 49 64 78 3b 0a 20 20 20 20  ndex *pIdx;.    
2be0: 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 74    int nName = st
2bf0: 72 6c 65 6e 28 70 54 61 62 2d 3e 7a 4e 61 6d 65  rlen(pTab->zName
2c00: 29 3b 0a 20 20 20 20 20 20 54 61 62 6c 65 20 2a  );.      Table *
2c10: 70 4f 6c 64 20 3d 20 73 71 6c 69 74 65 48 61 73  pOld = sqliteHas
2c20: 68 49 6e 73 65 72 74 28 26 64 62 2d 3e 74 62 6c  hInsert(&db->tbl
2c30: 48 61 73 68 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d  Hash, pTab->zNam
2c40: 65 2c 20 6e 4e 61 6d 65 2b 31 2c 20 70 54 61 62  e, nName+1, pTab
2c50: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4f 6c  );.      if( pOl
2c60: 64 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  d!=0 ){.        
2c70: 61 73 73 65 72 74 28 20 70 4f 6c 64 3d 3d 70 54  assert( pOld==pT
2c80: 61 62 20 29 3b 20 20 20 2f 2a 20 4d 61 6c 6c 6f  ab );   /* Mallo
2c90: 63 20 66 61 69 6c 65 64 20 6f 6e 20 74 68 65 20  c failed on the 
2ca0: 48 61 73 68 49 6e 73 65 72 74 20 2a 2f 0a 20 20  HashInsert */.  
2cb0: 20 20 20 20 20 20 73 71 6c 69 74 65 44 65 6c 65        sqliteDele
2cc0: 74 65 54 61 62 6c 65 28 64 62 2c 20 70 4f 6c 64  teTable(db, pOld
2cd0: 29 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69  );.        conti
2ce0: 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  nue;.      }.   
2cf0: 20 20 20 66 6f 72 28 70 49 64 78 3d 70 54 61 62     for(pIdx=pTab
2d00: 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20  ->pIndex; pIdx; 
2d10: 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74  pIdx=pIdx->pNext
2d20: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6e  ){.        int n
2d30: 20 3d 20 73 74 72 6c 65 6e 28 70 49 64 78 2d 3e   = strlen(pIdx->
2d40: 7a 4e 61 6d 65 29 2b 31 3b 0a 20 20 20 20 20 20  zName)+1;.      
2d50: 20 20 49 6e 64 65 78 20 2a 70 4f 6c 64 49 64 78    Index *pOldIdx
2d60: 3b 0a 20 20 20 20 20 20 20 20 70 4f 6c 64 49 64  ;.        pOldId
2d70: 78 20 3d 20 73 71 6c 69 74 65 48 61 73 68 49 6e  x = sqliteHashIn
2d80: 73 65 72 74 28 26 64 62 2d 3e 69 64 78 48 61 73  sert(&db->idxHas
2d90: 68 2c 20 70 49 64 78 2d 3e 7a 4e 61 6d 65 2c 20  h, pIdx->zName, 
2da0: 6e 2c 20 70 49 64 78 29 3b 0a 20 20 20 20 20 20  n, pIdx);.      
2db0: 20 20 69 66 28 20 70 4f 6c 64 20 29 7b 0a 20 20    if( pOld ){.  
2dc0: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
2dd0: 70 4f 6c 64 49 64 78 3d 3d 70 49 64 78 20 29 3b  pOldIdx==pIdx );
2de0: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
2df0: 65 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65  eUnlinkAndDelete
2e00: 49 6e 64 65 78 28 64 62 2c 20 70 4f 6c 64 49 64  Index(db, pOldId
2e10: 78 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  x);.        }.  
2e20: 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b      }.    }else{
2e30: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 44 65 6c  .      sqliteDel
2e40: 65 74 65 54 61 62 6c 65 28 64 62 2c 20 70 54 61  eteTable(db, pTa
2e50: 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  b);.    }.  }.  
2e60: 73 71 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28  sqliteHashClear(
2e70: 26 74 65 6d 70 31 29 3b 0a 20 20 64 62 2d 3e 66  &temp1);.  db->f
2e80: 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f  lags &= ~SQLITE_
2e90: 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 7d 0a 0a  Initialized;.}..
2ea0: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65  /*.** Close an e
2eb0: 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64  xisting SQLite d
2ec0: 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69 64 20  atabase.*/.void 
2ed0: 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73 71 6c  sqlite_close(sql
2ee0: 69 74 65 20 2a 64 62 29 7b 0a 20 20 73 71 6c 69  ite *db){.  sqli
2ef0: 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64 62 2d  teBtreeClose(db-
2f00: 3e 70 42 65 29 3b 0a 20 20 63 6c 65 61 72 48 61  >pBe);.  clearHa
2f10: 73 68 54 61 62 6c 65 28 64 62 2c 20 30 29 3b 0a  shTable(db, 0);.
2f20: 20 20 69 66 28 20 64 62 2d 3e 70 42 65 54 65 6d    if( db->pBeTem
2f30: 70 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 42  p ){.    sqliteB
2f40: 74 72 65 65 43 6c 6f 73 65 28 64 62 2d 3e 70 42  treeClose(db->pB
2f50: 65 54 65 6d 70 29 3b 0a 20 20 7d 0a 20 20 73 71  eTemp);.  }.  sq
2f60: 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a 7d 0a  liteFree(db);.}.
2f70: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52  ./*.** Return TR
2f80: 55 45 20 69 66 20 74 68 65 20 67 69 76 65 6e 20  UE if the given 
2f90: 53 51 4c 20 73 74 72 69 6e 67 20 65 6e 64 73 20  SQL string ends 
2fa0: 69 6e 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 2e 0a  in a semicolon..
2fb0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 6f  */.int sqlite_co
2fc0: 6d 70 6c 65 74 65 28 63 6f 6e 73 74 20 63 68 61  mplete(const cha
2fd0: 72 20 2a 7a 53 71 6c 29 7b 0a 20 20 69 6e 74 20  r *zSql){.  int 
2fe0: 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a  isComplete = 0;.
2ff0: 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 29    while( *zSql )
3000: 7b 0a 20 20 20 20 73 77 69 74 63 68 28 20 2a 7a  {.    switch( *z
3010: 53 71 6c 20 29 7b 0a 20 20 20 20 20 20 63 61 73  Sql ){.      cas
3020: 65 20 27 3b 27 3a 20 7b 0a 20 20 20 20 20 20 20  e ';': {.       
3030: 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 31 3b   isComplete = 1;
3040: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
3050: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61        }.      ca
3060: 73 65 20 27 20 27 3a 0a 20 20 20 20 20 20 63 61  se ' ':.      ca
3070: 73 65 20 27 5c 74 27 3a 0a 20 20 20 20 20 20 63  se '\t':.      c
3080: 61 73 65 20 27 5c 6e 27 3a 0a 20 20 20 20 20 20  ase '\n':.      
3090: 63 61 73 65 20 27 5c 66 27 3a 20 7b 0a 20 20 20  case '\f': {.   
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: 5c 27 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69  \'': {.        i
30d0: 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20  sComplete = 0;. 
30e0: 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20         zSql++;. 
30f0: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a         while( *z
3100: 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c  Sql && *zSql!='\
3110: 27 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a  '' ){ zSql++; }.
3120: 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71          if( *zSq
3130: 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b  l==0 ) return 0;
3140: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
3150: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61        }.      ca
3160: 73 65 20 27 22 27 3a 20 7b 0a 20 20 20 20 20 20  se '"': {.      
3170: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30    isComplete = 0
3180: 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b  ;.        zSql++
3190: 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28  ;.        while(
31a0: 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21   *zSql && *zSql!
31b0: 3d 27 22 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20  ='"' ){ zSql++; 
31c0: 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a  }.        if( *z
31d0: 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  Sql==0 ) return 
31e0: 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  0;.        break
31f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3200: 63 61 73 65 20 27 2d 27 3a 20 7b 0a 20 20 20 20  case '-': {.    
3210: 20 20 20 20 69 66 28 20 7a 53 71 6c 5b 31 5d 21      if( zSql[1]!
3220: 3d 27 2d 27 20 29 7b 0a 20 20 20 20 20 20 20 20  ='-' ){.        
3230: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30    isComplete = 0
3240: 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61  ;.          brea
3250: 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  k;.        }.   
3260: 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71       while( *zSq
3270: 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c 6e 27  l && *zSql!='\n'
3280: 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20   ){ zSql++; }.  
3290: 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d        if( *zSql=
32a0: 3d 30 20 29 20 72 65 74 75 72 6e 20 69 73 43 6f  =0 ) return isCo
32b0: 6d 70 6c 65 74 65 3b 0a 20 20 20 20 20 20 20 20  mplete;.        
32c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 20 0a  break;.      } .
32d0: 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b        default: {
32e0: 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c  .        isCompl
32f0: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ete = 0;.       
3300: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
3310: 20 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 2b 2b      }.    zSql++
3320: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69  ;.  }.  return i
3330: 73 43 6f 6d 70 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a  sComplete;.}../*
3340: 0a 2a 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20  .** Execute SQL 
3350: 63 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e  code.  Return on
3360: 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f  e of the SQLITE_
3370: 20 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65   success/failure
3380: 0a 2a 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f  .** codes.  Also
3390: 20 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20   write an error 
33a0: 6d 65 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d  message into mem
33b0: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ory obtained fro
33c0: 6d 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e  m.** malloc() an
33d0: 64 20 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67  d make *pzErrMsg
33e0: 20 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d   point to that m
33f0: 65 73 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66  essage..**.** If
3400: 20 74 68 65 20 53 51 4c 20 69 73 20 61 20 71 75   the SQL is a qu
3410: 65 72 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61  ery, then for ea
3420: 63 68 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75  ch row in the qu
3430: 65 72 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68  ery result.** th
3440: 65 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75  e xCallback() fu
3450: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
3460: 2e 20 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20  .  pArg becomes 
3470: 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67  the first.** arg
3480: 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61  ument to xCallba
3490: 63 6b 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62  ck().  If xCallb
34a0: 61 63 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f  ack=NULL then no
34b0: 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20   callback.** is 
34c0: 69 6e 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f  invoked, even fo
34d0: 72 20 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e  r queries..*/.in
34e0: 74 20 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20  t sqlite_exec(. 
34f0: 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20   sqlite *db,    
3500: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3510: 54 68 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20  The database on 
3520: 77 68 69 63 68 20 74 68 65 20 53 51 4c 20 65 78  which the SQL ex
3530: 65 63 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73  ecutes */.  cons
3540: 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20  t char *zSql,   
3550: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53          /* The S
3560: 51 4c 20 74 6f 20 62 65 20 65 78 65 63 75 74 65  QL to be execute
3570: 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61  d */.  sqlite_ca
3580: 6c 6c 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b  llback xCallback
3590: 2c 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69  ,  /* Invoke thi
35a0: 73 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69  s callback routi
35b0: 6e 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41  ne */.  void *pA
35c0: 72 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  rg,             
35d0: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67      /* First arg
35e0: 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61  ument to xCallba
35f0: 63 6b 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a  ck() */.  char *
3600: 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20  *pzErrMsg       
3610: 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65        /* Write e
3620: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65  rror messages he
3630: 72 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65  re */.){.  Parse
3640: 20 73 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20   sParse;..  if( 
3650: 70 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72  pzErrMsg ) *pzEr
3660: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20  rMsg = 0;.  if( 
3670: 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c  (db->flags & SQL
3680: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29  ITE_Initialized)
3690: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  ==0 ){.    int r
36a0: 63 20 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64  c = sqliteInit(d
36b0: 62 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  b, pzErrMsg);.  
36c0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
36d0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
36e0: 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  iteStrRealloc(pz
36f0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 72  ErrMsg);.      r
3700: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
3710: 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50    }.  memset(&sP
3720: 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28  arse, 0, sizeof(
3730: 73 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72  sParse));.  sPar
3740: 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 50  se.db = db;.  sP
3750: 61 72 73 65 2e 70 42 65 20 3d 20 64 62 2d 3e 70  arse.pBe = db->p
3760: 42 65 3b 0a 20 20 73 50 61 72 73 65 2e 78 43 61  Be;.  sParse.xCa
3770: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61  llback = xCallba
3780: 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70 41 72  ck;.  sParse.pAr
3790: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69  g = pArg;.  sqli
37a0: 74 65 52 75 6e 50 61 72 73 65 72 28 26 73 50 61  teRunParser(&sPa
37b0: 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72 72  rse, zSql, pzErr
37c0: 4d 73 67 29 3b 0a 20 20 69 66 28 20 73 71 6c 69  Msg);.  if( sqli
37d0: 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64  te_malloc_failed
37e0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65   ){.    sqliteSe
37f0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
3800: 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79  , "out of memory
3810: 22 2c 20 30 29 3b 0a 20 20 20 20 73 50 61 72 73  ", 0);.    sPars
3820: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  e.rc = SQLITE_NO
3830: 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 42  MEM;.    sqliteB
3840: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d  treeRollback(db-
3850: 3e 70 42 65 29 3b 0a 20 20 20 20 69 66 28 20 64  >pBe);.    if( d
3860: 62 2d 3e 70 42 65 54 65 6d 70 20 29 20 73 71 6c  b->pBeTemp ) sql
3870: 69 74 65 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  iteBtreeRollback
3880: 28 64 62 2d 3e 70 42 65 54 65 6d 70 29 3b 0a 20  (db->pBeTemp);. 
3890: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20     db->flags &= 
38a0: 7e 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b  ~SQLITE_InTrans;
38b0: 0a 20 20 20 20 63 6c 65 61 72 48 61 73 68 54 61  .    clearHashTa
38c0: 62 6c 65 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a  ble(db, 0);.  }.
38d0: 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c    sqliteStrReall
38e0: 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  oc(pzErrMsg);.  
38f0: 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53  if( sParse.rc==S
3900: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a  QLITE_SCHEMA ){.
3910: 20 20 20 20 63 6c 65 61 72 48 61 73 68 54 61 62      clearHashTab
3920: 6c 65 28 64 62 2c 20 31 29 3b 0a 20 20 7d 0a 20  le(db, 1);.  }. 
3930: 20 72 65 74 75 72 6e 20 73 50 61 72 73 65 2e 72   return sParse.r
3940: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  c;.}../*.** This
3950: 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65   routine impleme
3960: 6e 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62  nts a busy callb
3970: 61 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20  ack that sleeps 
3980: 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61  and tries.** aga
3990: 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f  in until a timeo
39a0: 75 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63  ut value is reac
39b0: 68 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75  hed.  The timeou
39c0: 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e  t value is.** an
39d0: 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20   integer number 
39e0: 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20  of milliseconds 
39f0: 70 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65  passed in as the
3a00: 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65   first.** argume
3a10: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  nt..*/.static in
3a20: 74 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42  t sqliteDefaultB
3a30: 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f  usyCallback(. vo
3a40: 69 64 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20  id *Timeout,    
3a50: 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75         /* Maximu
3a60: 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65  m amount of time
3a70: 20 74 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e   to wait */. con
3a80: 73 74 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64  st char *NotUsed
3a90: 2c 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d  ,     /* The nam
3aa0: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74  e of the table t
3ab0: 68 61 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20  hat is busy */. 
3ac0: 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20  int count       
3ad0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
3ae0: 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c  er of times tabl
3af0: 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 20  e has been busy 
3b00: 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45  */.){.#if SQLITE
3b10: 5f 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31  _MIN_SLEEP_MS==1
3b20: 0a 20 20 69 6e 74 20 64 65 6c 61 79 20 3d 20 31  .  int delay = 1
3b30: 30 3b 0a 20 20 69 6e 74 20 70 72 69 6f 72 5f 64  0;.  int prior_d
3b40: 65 6c 61 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20  elay = 0;.  int 
3b50: 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54  timeout = (int)T
3b60: 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 69 3b  imeout;.  int i;
3b70: 0a 0a 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 63  ..  for(i=1; i<c
3b80: 6f 75 6e 74 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  ount; i++){ .   
3b90: 20 70 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20   prior_delay += 
3ba0: 64 65 6c 61 79 3b 0a 20 20 20 20 64 65 6c 61 79  delay;.    delay
3bb0: 20 3d 20 64 65 6c 61 79 2a 32 3b 0a 20 20 20 20   = delay*2;.    
3bc0: 69 66 28 20 64 65 6c 61 79 3e 3d 31 30 30 30 20  if( delay>=1000 
3bd0: 29 7b 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d  ){.      delay =
3be0: 20 31 30 30 30 3b 0a 20 20 20 20 20 20 70 72 69   1000;.      pri
3bf0: 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 31 30 30 30  or_delay += 1000
3c00: 2a 28 63 6f 75 6e 74 20 2d 20 69 20 2d 20 31 29  *(count - i - 1)
3c10: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
3c20: 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70     }.  }.  if( p
3c30: 72 69 6f 72 5f 64 65 6c 61 79 20 2b 20 64 65 6c  rior_delay + del
3c40: 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a  ay > timeout ){.
3c50: 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65      delay = time
3c60: 6f 75 74 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61  out - prior_dela
3c70: 79 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79  y;.    if( delay
3c80: 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  <=0 ) return 0;.
3c90: 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c    }.  sqliteOsSl
3ca0: 65 65 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65  eep(delay);.  re
3cb0: 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20  turn 1;.#else.  
3cc0: 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69  int timeout = (i
3cd0: 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66  nt)Timeout;.  if
3ce0: 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30  ( (count+1)*1000
3cf0: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20   > timeout ){.  
3d00: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
3d10: 20 20 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28    sqliteOsSleep(
3d20: 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20  1000);.  return 
3d30: 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a  1;.#endif.}../*.
3d40: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
3d50: 73 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61  sets the busy ca
3d60: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71  llback for an Sq
3d70: 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f  lite database to
3d80: 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61   the.** given ca
3d90: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20  llback function 
3da0: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61  with the given a
3db0: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64  rgument..*/.void
3dc0: 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e   sqlite_busy_han
3dd0: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a  dler(.  sqlite *
3de0: 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73  db,.  int (*xBus
3df0: 79 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63  y)(void*,const c
3e00: 68 61 72 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69  har*,int),.  voi
3e10: 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d  d *pArg.){.  db-
3e20: 3e 78 42 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d  >xBusyCallback =
3e30: 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42   xBusy;.  db->pB
3e40: 75 73 79 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d  usyArg = pArg;.}
3e50: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
3e60: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20  tine installs a 
3e70: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e  default busy han
3e80: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20  dler that waits 
3e90: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69  for the.** speci
3ea0: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d  fied number of m
3eb0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f  illiseconds befo
3ec0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a  re returning 0..
3ed0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62  */.void sqlite_b
3ee0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69  usy_timeout(sqli
3ef0: 74 65 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b  te *db, int ms){
3f00: 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20  .  if( ms>0 ){. 
3f10: 20 20 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68     sqlite_busy_h
3f20: 61 6e 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74  andler(db, sqlit
3f30: 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c  eDefaultBusyCall
3f40: 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29  back, (void*)ms)
3f50: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
3f60: 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c  qlite_busy_handl
3f70: 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20  er(db, 0, 0);.  
3f80: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65  }.}../*.** Cause
3f90: 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65   any pending ope
3fa0: 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61  ration to stop a
3fb0: 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f  t its earliest o
3fc0: 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76  pportunity..*/.v
3fd0: 6f 69 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72  oid sqlite_inter
3fe0: 72 75 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29  rupt(sqlite *db)
3ff0: 7b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d  {.  db->flags |=
4000: 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70   SQLITE_Interrup
4010: 74 3b 0a 7d 0a                                   t;.}.