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

Artifact ab7f1aae3fff4adbf3b5d518267a1160d7760a6b:


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 31 35 38 20 32 30 30 34 2f 30 32  ,v 1.158 2004/02
0280: 2f 32 30 20 32 32 3a 35 33 3a 33 39 20 72 64 63  /20 22:53:39 rdc
0290: 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75   Exp $.*/.#inclu
02a0: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22  de "sqliteInt.h"
02b0: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22  .#include "os.h"
02c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65  .#include <ctype
02d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69  .h>../*.** A poi
02e0: 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72  nter to this str
02f0: 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 74  ucture is used t
0300: 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e  o communicate in
0310: 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f  formation.** fro
0320: 6d 20 73 71 6c 69 74 65 49 6e 69 74 20 69 6e 74  m sqliteInit int
0330: 6f 20 74 68 65 20 73 71 6c 69 74 65 49 6e 69 74  o the sqliteInit
0340: 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 79 70  Callback..*/.typ
0350: 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a 20 20  edef struct {.  
0360: 73 71 6c 69 74 65 20 2a 64 62 3b 20 20 20 20 20  sqlite *db;     
0370: 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62      /* The datab
0380: 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74 69 61  ase being initia
0390: 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61 72 20  lized */.  char 
03a0: 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20 20 2f  **pzErrMsg;    /
03b0: 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20  * Error message 
03c0: 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a 7d  stored here */.}
03d0: 20 49 6e 69 74 44 61 74 61 3b 0a 0a 2f 2a 0a 2a   InitData;../*.*
03e0: 2a 20 46 69 6c 6c 20 74 68 65 20 49 6e 69 74 44  * Fill the InitD
03f0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 77 69  ata structure wi
0400: 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  th an error mess
0410: 61 67 65 20 74 68 61 74 20 69 6e 64 69 63 61 74  age that indicat
0420: 65 73 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64  es.** that the d
0430: 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 75  atabase is corru
0440: 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  pt..*/.static vo
0450: 69 64 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61  id corruptSchema
0460: 28 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61  (InitData *pData
0470: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45  , const char *zE
0480: 78 74 72 61 29 7b 0a 20 20 73 71 6c 69 74 65 53  xtra){.  sqliteS
0490: 65 74 53 74 72 69 6e 67 28 70 44 61 74 61 2d 3e  etString(pData->
04a0: 70 7a 45 72 72 4d 73 67 2c 20 22 6d 61 6c 66 6f  pzErrMsg, "malfo
04b0: 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 73 63  rmed database sc
04c0: 68 65 6d 61 22 2c 0a 20 20 20 20 20 7a 45 78 74  hema",.     zExt
04d0: 72 61 21 3d 30 20 26 26 20 7a 45 78 74 72 61 5b  ra!=0 && zExtra[
04e0: 30 5d 21 3d 30 20 3f 20 22 20 2d 20 22 20 3a 20  0]!=0 ? " - " : 
04f0: 28 63 68 61 72 2a 29 30 2c 20 7a 45 78 74 72 61  (char*)0, zExtra
0500: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 7d 0a 0a  , (char*)0);.}..
0510: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68  /*.** This is th
0520: 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69  e callback routi
0530: 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20  ne for the code 
0540: 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65 73  that initializes
0550: 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65   the.** database
0560: 2e 20 20 53 65 65 20 73 71 6c 69 74 65 49 6e 69  .  See sqliteIni
0570: 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 64  t() below for ad
0580: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
0590: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68  tion..**.** Each
05a0: 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69   callback contai
05b0: 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ns the following
05c0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a   information:.**
05d0: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d 20  .**     argv[0] 
05e0: 3d 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22 20  = "file-format" 
05f0: 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69  or "schema-cooki
0600: 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f 72  e" or "table" or
0610: 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20   "index".**     
0620: 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20  argv[1] = table 
0630: 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72  or index name or
0640: 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74 20   meta statement 
0650: 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67  type..**     arg
0660: 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65  v[2] = root page
0670: 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62 6c   number for tabl
0680: 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c  e or index.  NUL
0690: 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20  L for meta..**  
06a0: 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c     argv[3] = SQL
06b0: 20 74 65 78 74 20 66 6f 72 20 61 20 43 52 45 41   text for a CREA
06c0: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
06d0: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
06e0: 6e 74 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  nt..**     argv[
06f0: 34 5d 20 3d 20 22 31 22 20 66 6f 72 20 74 65 6d  4] = "1" for tem
0700: 70 6f 72 61 72 79 20 66 69 6c 65 73 2c 20 22 30  porary files, "0
0710: 22 20 66 6f 72 20 6d 61 69 6e 20 64 61 74 61 62  " for main datab
0720: 61 73 65 2c 20 22 32 22 20 6f 72 20 6d 6f 72 65  ase, "2" or more
0730: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
0740: 20 20 66 6f 72 20 61 75 78 69 6c 69 61 72 79 20    for auxiliary 
0750: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a  database files..
0760: 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 0a 69 6e 74  **.*/.static.int
0770: 20 73 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62   sqliteInitCallb
0780: 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74 2c  ack(void *pInit,
0790: 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 72 20   int argc, char 
07a0: 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a 61  **argv, char **a
07b0: 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 49 6e 69  zColName){.  Ini
07c0: 74 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20 28  tData *pData = (
07d0: 49 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74 3b  InitData*)pInit;
07e0: 0a 20 20 69 6e 74 20 6e 45 72 72 20 3d 20 30 3b  .  int nErr = 0;
07f0: 0a 0a 20 20 61 73 73 65 72 74 28 20 61 72 67 63  ..  assert( argc
0800: 3d 3d 35 20 29 3b 0a 20 20 69 66 28 20 61 72 67  ==5 );.  if( arg
0810: 76 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b  v==0 ) return 0;
0820: 20 20 20 2f 2a 20 4d 69 67 68 74 20 68 61 70 70     /* Might happ
0830: 65 6e 20 69 66 20 45 4d 50 54 59 5f 52 45 53 55  en if EMPTY_RESU
0840: 4c 54 5f 43 41 4c 4c 42 41 43 4b 53 20 61 72 65  LT_CALLBACKS are
0850: 20 6f 6e 20 2a 2f 0a 20 20 69 66 28 20 61 72 67   on */.  if( arg
0860: 76 5b 30 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 63  v[0]==0 ){.    c
0870: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61  orruptSchema(pDa
0880: 74 61 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75  ta, 0);.    retu
0890: 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 73 77 69 74  rn 1;.  }.  swit
08a0: 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20 29  ch( argv[0][0] )
08b0: 7b 0a 20 20 20 20 63 61 73 65 20 27 76 27 3a 0a  {.    case 'v':.
08c0: 20 20 20 20 63 61 73 65 20 27 69 27 3a 0a 20 20      case 'i':.  
08d0: 20 20 63 61 73 65 20 27 74 27 3a 20 7b 20 20 2f    case 't': {  /
08e0: 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20  * CREATE TABLE, 
08f0: 43 52 45 41 54 45 20 49 4e 44 45 58 2c 20 6f 72  CREATE INDEX, or
0900: 20 43 52 45 41 54 45 20 56 49 45 57 20 73 74 61   CREATE VIEW sta
0910: 74 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20  tements */.     
0920: 20 73 71 6c 69 74 65 20 2a 64 62 20 3d 20 70 44   sqlite *db = pD
0930: 61 74 61 2d 3e 64 62 3b 0a 20 20 20 20 20 20 69  ata->db;.      i
0940: 66 28 20 61 72 67 76 5b 32 5d 3d 3d 30 20 7c 7c  f( argv[2]==0 ||
0950: 20 61 72 67 76 5b 34 5d 3d 3d 30 20 29 7b 0a 20   argv[4]==0 ){. 
0960: 20 20 20 20 20 20 20 63 6f 72 72 75 70 74 53 63         corruptSc
0970: 68 65 6d 61 28 70 44 61 74 61 2c 20 30 29 3b 0a  hema(pData, 0);.
0980: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 31          return 1
0990: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
09a0: 69 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20 61  if( argv[3] && a
09b0: 72 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20  rgv[3][0] ){.   
09c0: 20 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65       /* Call the
09d0: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65   parser to proce
09e0: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  ss a CREATE TABL
09f0: 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 57  E, INDEX or VIEW
0a00: 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 42 75 74  ..        ** But
0a10: 20 62 65 63 61 75 73 65 20 64 62 2d 3e 69 6e 69   because db->ini
0a20: 74 2e 62 75 73 79 20 69 73 20 73 65 74 20 74 6f  t.busy is set to
0a30: 20 31 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64 65   1, no VDBE code
0a40: 20 69 73 20 67 65 6e 65 72 61 74 65 64 0a 20 20   is generated.  
0a50: 20 20 20 20 20 20 2a 2a 20 6f 72 20 65 78 65 63        ** or exec
0a60: 75 74 65 64 2e 20 20 41 6c 6c 20 74 68 65 20 70  uted.  All the p
0a70: 61 72 73 65 72 20 64 6f 65 73 20 69 73 20 62 75  arser does is bu
0a80: 69 6c 64 20 74 68 65 20 69 6e 74 65 72 6e 61 6c  ild the internal
0a90: 20 64 61 74 61 0a 20 20 20 20 20 20 20 20 2a 2a   data.        **
0aa0: 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74   structures that
0ab0: 20 64 65 73 63 72 69 62 65 20 74 68 65 20 74 61   describe the ta
0ac0: 62 6c 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20 76  ble, index, or v
0ad0: 69 65 77 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a  iew..        */.
0ae0: 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a 45          char *zE
0af0: 72 72 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65  rr;.        asse
0b00: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73  rt( db->init.bus
0b10: 79 20 29 3b 0a 20 20 20 20 20 20 20 20 64 62 2d  y );.        db-
0b20: 3e 69 6e 69 74 2e 69 44 62 20 3d 20 61 74 6f 69  >init.iDb = atoi
0b30: 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20 20 20  (argv[4]);.     
0b40: 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69     assert( db->i
0b50: 6e 69 74 2e 69 44 62 3e 3d 30 20 26 26 20 64 62  nit.iDb>=0 && db
0b60: 2d 3e 69 6e 69 74 2e 69 44 62 3c 64 62 2d 3e 6e  ->init.iDb<db->n
0b70: 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 64 62  Db );.        db
0b80: 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d  ->init.newTnum =
0b90: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a   atoi(argv[2]);.
0ba0: 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69          if( sqli
0bb0: 74 65 5f 65 78 65 63 28 64 62 2c 20 61 72 67 76  te_exec(db, argv
0bc0: 5b 33 5d 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72  [3], 0, 0, &zErr
0bd0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63  ) ){.          c
0be0: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61  orruptSchema(pDa
0bf0: 74 61 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20  ta, zErr);.     
0c00: 20 20 20 20 20 73 71 6c 69 74 65 5f 66 72 65 65       sqlite_free
0c10: 6d 65 6d 28 7a 45 72 72 29 3b 0a 20 20 20 20 20  mem(zErr);.     
0c20: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 64 62 2d     }.        db-
0c30: 3e 69 6e 69 74 2e 69 44 62 20 3d 20 30 3b 0a 20  >init.iDb = 0;. 
0c40: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
0c50: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51      /* If the SQ
0c60: 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e  L column is blan
0c70: 6b 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20  k it means this 
0c80: 69 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74  is an index that
0c90: 0a 20 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20  .        ** was 
0ca0: 63 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68  created to be th
0cb0: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72  e PRIMARY KEY or
0cc0: 20 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e   to fulfill a UN
0cd0: 49 51 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20  IQUE.        ** 
0ce0: 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61  constraint for a
0cf0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20   CREATE TABLE.  
0d00: 54 68 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64  The index should
0d10: 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20   have already.  
0d20: 20 20 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72        ** been cr
0d30: 65 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72  eated when we pr
0d40: 6f 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41  ocessed the CREA
0d50: 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77  TE TABLE.  All w
0d60: 65 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a  e have.        *
0d70: 2a 20 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20  * to do here is 
0d80: 72 65 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20  record the root 
0d90: 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20  page number for 
0da0: 74 68 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20  that index..    
0db0: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69      */.        i
0dc0: 6e 74 20 69 44 62 3b 0a 20 20 20 20 20 20 20 20  nt iDb;.        
0dd0: 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 0a 0a  Index *pIndex;..
0de0: 20 20 20 20 20 20 20 20 69 44 62 20 3d 20 61 74          iDb = at
0df0: 6f 69 28 61 72 67 76 5b 34 5d 29 3b 0a 20 20 20  oi(argv[4]);.   
0e00: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 44 62       assert( iDb
0e10: 3e 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e  >=0 && iDb<db->n
0e20: 44 62 20 29 3b 0a 20 20 20 20 20 20 20 20 70 49  Db );.        pI
0e30: 6e 64 65 78 20 3d 20 73 71 6c 69 74 65 46 69 6e  ndex = sqliteFin
0e40: 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76 5b  dIndex(db, argv[
0e50: 31 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  1], db->aDb[iDb]
0e60: 2e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20  .zName);.       
0e70: 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 7c   if( pIndex==0 |
0e80: 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 21 3d  | pIndex->tnum!=
0e90: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f  0 ){.          /
0ea0: 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72  * This can occur
0eb0: 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73   if there exists
0ec0: 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20 54   an index on a T
0ed0: 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68 0a  EMP table which.
0ee0: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73            ** has
0ef0: 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61   the same name a
0f00: 73 20 61 6e 6f 74 68 65 72 20 69 6e 64 65 78 20  s another index 
0f10: 6f 6e 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 69  on a permanent i
0f20: 6e 64 65 78 2e 20 20 53 69 6e 63 65 0a 20 20 20  ndex.  Since.   
0f30: 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65         ** the pe
0f40: 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73  rmanent table is
0f50: 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20 54   hidden by the T
0f60: 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61  EMP table, we ca
0f70: 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 20 20 20  n also.         
0f80: 20 2a 2a 20 73 61 66 65 6c 79 20 69 67 6e 6f 72   ** safely ignor
0f90: 65 20 74 68 65 20 69 6e 64 65 78 20 6f 6e 20 74  e the index on t
0fa0: 68 65 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62  he permanent tab
0fb0: 6c 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f  le..          */
0fc0: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f  .          /* Do
0fd0: 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20   Nothing */;.   
0fe0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
0ff0: 20 20 20 20 20 20 70 49 6e 64 65 78 2d 3e 74 6e        pIndex->tn
1000: 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 32  um = atoi(argv[2
1010: 5d 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ]);.        }.  
1020: 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61      }.      brea
1030: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66  k;.    }.    def
1040: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a  ault: {.      /*
1050: 20 54 68 69 73 20 63 61 6e 20 6e 6f 74 20 68 61   This can not ha
1060: 70 70 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20 6e  ppen! */.      n
1070: 45 72 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 61  Err = 1;.      a
1080: 73 73 65 72 74 28 20 6e 45 72 72 3d 3d 30 20 29  ssert( nErr==0 )
1090: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
10a0: 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a  turn nErr;.}../*
10b0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 61  .** This is a ca
10c0: 6c 6c 62 61 63 6b 20 70 72 6f 63 65 64 75 72 65  llback procedure
10d0: 20 75 73 65 64 20 74 6f 20 72 65 63 6f 6e 73 74   used to reconst
10e0: 72 75 63 74 20 61 20 74 61 62 6c 65 2e 20 20 54  ruct a table.  T
10f0: 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 74 68  he.** name of th
1100: 65 20 74 61 62 6c 65 20 74 6f 20 62 65 20 72 65  e table to be re
1110: 63 6f 6e 73 74 72 75 63 74 65 64 20 69 73 20 70  constructed is p
1120: 61 73 73 65 64 20 69 6e 20 61 73 20 61 72 67 76  assed in as argv
1130: 5b 30 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  [0]..**.** This 
1140: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20  routine is used 
1150: 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  to automatically
1160: 20 75 70 67 72 61 64 65 20 61 20 64 61 74 61 62   upgrade a datab
1170: 61 73 65 20 66 72 6f 6d 0a 2a 2a 20 66 6f 72 6d  ase from.** form
1180: 61 74 20 76 65 72 73 69 6f 6e 20 31 20 6f 72 20  at version 1 or 
1190: 32 20 74 6f 20 76 65 72 73 69 6f 6e 20 33 2e 20  2 to version 3. 
11a0: 20 54 68 65 20 63 6f 72 72 65 63 74 20 6f 70 65   The correct ope
11b0: 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 69  ration of.** thi
11c0: 73 20 72 6f 75 74 69 6e 65 20 72 65 6c 79 73 20  s routine relys 
11d0: 6f 6e 20 74 68 65 20 66 61 63 74 20 74 68 61 74  on the fact that
11e0: 20 6e 6f 20 69 6e 64 69 63 65 73 20 61 72 65 20   no indices are 
11f0: 75 73 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 70  used when.** cop
1200: 79 69 6e 67 20 61 20 74 61 62 6c 65 20 6f 75 74  ying a table out
1210: 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20   to a temporary 
1220: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  file..**.** The 
1230: 63 68 61 6e 67 65 20 66 72 6f 6d 20 76 65 72 73  change from vers
1240: 69 6f 6e 20 32 20 74 6f 20 76 65 72 73 69 6f 6e  ion 2 to version
1250: 20 33 20 6f 63 63 75 72 72 65 64 20 62 65 74 77   3 occurred betw
1260: 65 65 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 76 65  een SQLite.** ve
1270: 72 73 69 6f 6e 20 32 2e 35 2e 36 20 61 6e 64 20  rsion 2.5.6 and 
1280: 32 2e 36 2e 30 20 6f 6e 20 32 30 30 32 2d 4a 75  2.6.0 on 2002-Ju
1290: 6c 79 2d 31 38 2e 20 20 0a 2a 2f 0a 73 74 61 74  ly-18.  .*/.stat
12a0: 69 63 0a 69 6e 74 20 75 70 67 72 61 64 65 5f 33  ic.int upgrade_3
12b0: 5f 63 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a  _callback(void *
12c0: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c  pInit, int argc,
12d0: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68   char **argv, ch
12e0: 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 7b 0a 20  ar **NotUsed){. 
12f0: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61   InitData *pData
1300: 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29 70 49   = (InitData*)pI
1310: 6e 69 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  nit;.  int rc;. 
1320: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
1330: 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 3b 0a  Trigger *pTrig;.
1340: 20 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 30    char *zErr = 0
1350: 3b 0a 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69  ;..  pTab = sqli
1360: 74 65 46 69 6e 64 54 61 62 6c 65 28 70 44 61 74  teFindTable(pDat
1370: 61 2d 3e 64 62 2c 20 61 72 67 76 5b 30 5d 2c 20  a->db, argv[0], 
1380: 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 54  0);.  assert( pT
1390: 61 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  ab!=0 );.  asser
13a0: 74 28 20 73 71 6c 69 74 65 53 74 72 49 43 6d 70  t( sqliteStrICmp
13b0: 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 61 72  (pTab->zName, ar
13c0: 67 76 5b 30 5d 29 3d 3d 30 20 29 3b 0a 20 20 69  gv[0])==0 );.  i
13d0: 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 70  f( pTab ){.    p
13e0: 54 72 69 67 20 3d 20 70 54 61 62 2d 3e 70 54 72  Trig = pTab->pTr
13f0: 69 67 67 65 72 3b 0a 20 20 20 20 70 54 61 62 2d  igger;.    pTab-
1400: 3e 70 54 72 69 67 67 65 72 20 3d 20 30 3b 20 20  >pTrigger = 0;  
1410: 2f 2a 20 44 69 73 61 62 6c 65 20 61 6c 6c 20 74  /* Disable all t
1420: 72 69 67 67 65 72 73 20 62 65 66 6f 72 65 20 72  riggers before r
1430: 65 62 75 69 6c 64 69 6e 67 20 74 68 65 20 74 61  ebuilding the ta
1440: 62 6c 65 20 2a 2f 0a 20 20 7d 0a 20 20 72 63 20  ble */.  }.  rc 
1450: 3d 20 73 71 6c 69 74 65 5f 65 78 65 63 5f 70 72  = sqlite_exec_pr
1460: 69 6e 74 66 28 70 44 61 74 61 2d 3e 64 62 2c 0a  intf(pData->db,.
1470: 20 20 20 20 22 43 52 45 41 54 45 20 54 45 4d 50      "CREATE TEMP
1480: 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 78 20   TABLE sqlite_x 
1490: 41 53 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d  AS SELECT * FROM
14a0: 20 27 25 71 27 3b 20 22 0a 20 20 20 20 22 44 45   '%q'; ".    "DE
14b0: 4c 45 54 45 20 46 52 4f 4d 20 27 25 71 27 3b 20  LETE FROM '%q'; 
14c0: 22 0a 20 20 20 20 22 49 4e 53 45 52 54 20 49 4e  ".    "INSERT IN
14d0: 54 4f 20 27 25 71 27 20 53 45 4c 45 43 54 20 2a  TO '%q' SELECT *
14e0: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 78 3b 20   FROM sqlite_x; 
14f0: 22 0a 20 20 20 20 22 44 52 4f 50 20 54 41 42 4c  ".    "DROP TABL
1500: 45 20 73 71 6c 69 74 65 5f 78 3b 22 2c 0a 20 20  E sqlite_x;",.  
1510: 20 20 30 2c 20 30 2c 20 26 7a 45 72 72 2c 20 61    0, 0, &zErr, a
1520: 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b 30 5d 2c  rgv[0], argv[0],
1530: 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20 69 66 28   argv[0]);.  if(
1540: 20 7a 45 72 72 20 29 7b 0a 20 20 20 20 69 66 28   zErr ){.    if(
1550: 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73   *pData->pzErrMs
1560: 67 20 29 20 73 71 6c 69 74 65 5f 66 72 65 65 6d  g ) sqlite_freem
1570: 65 6d 28 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72  em(*pData->pzErr
1580: 4d 73 67 29 3b 0a 20 20 20 20 2a 70 44 61 74 61  Msg);.    *pData
1590: 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 7a 45 72  ->pzErrMsg = zEr
15a0: 72 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20  r;.  }..  /* If 
15b0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65  an error occurre
15c0: 64 20 69 6e 20 74 68 65 20 53 51 4c 20 61 62 6f  d in the SQL abo
15d0: 76 65 2c 20 74 68 65 6e 20 74 68 65 20 74 72 61  ve, then the tra
15e0: 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 0a 20 20  nsaction will.  
15f0: 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 77 68 69 63  ** rollback whic
1600: 68 20 77 69 6c 6c 20 64 65 6c 65 74 65 20 74 68  h will delete th
1610: 65 20 69 6e 74 65 72 6e 61 6c 20 73 79 6d 62 6f  e internal symbo
1620: 6c 20 74 61 62 6c 65 73 2e 20 20 54 68 69 73 20  l tables.  This 
1630: 77 69 6c 6c 0a 20 20 2a 2a 20 63 61 75 73 65 20  will.  ** cause 
1640: 74 68 65 20 73 74 72 75 63 74 75 72 65 20 74 68  the structure th
1650: 61 74 20 70 54 61 62 20 70 6f 69 6e 74 73 20 74  at pTab points t
1660: 6f 20 62 65 20 64 65 6c 65 74 65 64 2e 20 20 49  o be deleted.  I
1670: 6e 20 63 61 73 65 20 74 68 61 74 0a 20 20 2a 2a  n case that.  **
1680: 20 68 61 70 70 65 6e 65 64 2c 20 77 65 20 6e 65   happened, we ne
1690: 65 64 20 74 6f 20 72 65 66 65 74 63 68 20 70 54  ed to refetch pT
16a0: 61 62 2e 0a 20 20 2a 2f 0a 20 20 70 54 61 62 20  ab..  */.  pTab 
16b0: 3d 20 73 71 6c 69 74 65 46 69 6e 64 54 61 62 6c  = sqliteFindTabl
16c0: 65 28 70 44 61 74 61 2d 3e 64 62 2c 20 61 72 67  e(pData->db, arg
16d0: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 69 66 28 20  v[0], 0);.  if( 
16e0: 70 54 61 62 20 29 7b 0a 20 20 20 20 61 73 73 65  pTab ){.    asse
16f0: 72 74 28 20 73 71 6c 69 74 65 53 74 72 49 43 6d  rt( sqliteStrICm
1700: 70 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 61  p(pTab->zName, a
1710: 72 67 76 5b 30 5d 29 3d 3d 30 20 29 3b 0a 20 20  rgv[0])==0 );.  
1720: 20 20 70 54 61 62 2d 3e 70 54 72 69 67 67 65 72    pTab->pTrigger
1730: 20 3d 20 70 54 72 69 67 3b 20 20 2f 2a 20 52 65   = pTrig;  /* Re
1740: 2d 65 6e 61 62 6c 65 20 74 72 69 67 67 65 72 73  -enable triggers
1750: 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e   */.  }.  return
1760: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 3b 0a   rc!=SQLITE_OK;.
1770: 7d 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  }..../*.** Attem
1780: 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 20 64  pt to read the d
1790: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 61  atabase schema a
17a0: 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 69 6e  nd initialize in
17b0: 74 65 72 6e 61 6c 0a 2a 2a 20 64 61 74 61 20 73  ternal.** data s
17c0: 74 72 75 63 74 75 72 65 73 20 66 6f 72 20 61 20  tructures for a 
17d0: 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65 20  single database 
17e0: 66 69 6c 65 2e 20 20 54 68 65 20 69 6e 64 65 78  file.  The index
17f0: 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62   of the.** datab
1800: 61 73 65 20 66 69 6c 65 20 69 73 20 67 69 76 65  ase file is give
1810: 6e 20 62 79 20 69 44 62 2e 20 20 69 44 62 3d 3d  n by iDb.  iDb==
1820: 30 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68  0 is used for th
1830: 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74 61 62 61  e main.** databa
1840: 73 65 2e 20 20 69 44 62 3d 3d 31 20 73 68 6f 75  se.  iDb==1 shou
1850: 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73 65 64  ld never be used
1860: 2e 20 20 69 44 62 3e 3d 32 20 69 73 20 75 73 65  .  iDb>=2 is use
1870: 64 20 66 6f 72 0a 2a 2a 20 61 75 78 69 6c 69 61  d for.** auxilia
1880: 72 79 20 64 61 74 61 62 61 73 65 73 2e 20 20 52  ry databases.  R
1890: 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65  eturn one of the
18a0: 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72 20 63   SQLITE_ error c
18b0: 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 69 63  odes to.** indic
18c0: 61 74 65 20 73 75 63 63 65 73 73 20 6f 72 20 66  ate success or f
18d0: 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69  ailure..*/.stati
18e0: 63 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69 74  c int sqliteInit
18f0: 4f 6e 65 28 73 71 6c 69 74 65 20 2a 64 62 2c 20  One(sqlite *db, 
1900: 69 6e 74 20 69 44 62 2c 20 63 68 61 72 20 2a 2a  int iDb, char **
1910: 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74  pzErrMsg){.  int
1920: 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20   rc;.  BtCursor 
1930: 2a 63 75 72 4d 61 69 6e 3b 0a 20 20 69 6e 74 20  *curMain;.  int 
1940: 73 69 7a 65 3b 0a 20 20 54 61 62 6c 65 20 2a 70  size;.  Table *p
1950: 54 61 62 3b 0a 20 20 63 68 61 72 20 2a 61 7a 41  Tab;.  char *azA
1960: 72 67 5b 36 5d 3b 0a 20 20 63 68 61 72 20 7a 44  rg[6];.  char zD
1970: 62 4e 75 6d 5b 33 30 5d 3b 0a 20 20 69 6e 74 20  bNum[30];.  int 
1980: 6d 65 74 61 5b 53 51 4c 49 54 45 5f 4e 5f 42 54  meta[SQLITE_N_BT
1990: 52 45 45 5f 4d 45 54 41 5d 3b 0a 20 20 49 6e 69  REE_META];.  Ini
19a0: 74 44 61 74 61 20 69 6e 69 74 44 61 74 61 3b 0a  tData initData;.
19b0: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 6d  .  /*.  ** The m
19c0: 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74  aster database t
19d0: 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75 63  able has a struc
19e0: 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a 20  ture like this. 
19f0: 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 61   */.  static cha
1a00: 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b  r master_schema[
1a10: 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54  ] = .     "CREAT
1a20: 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d  E TABLE sqlite_m
1a30: 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22  aster(\n".     "
1a40: 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a    type text,\n".
1a50: 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78       "  name tex
1a60: 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62  t,\n".     "  tb
1a70: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a  l_name text,\n".
1a80: 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65       "  rootpage
1a90: 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20   integer,\n".   
1aa0: 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22    "  sql text\n"
1ab0: 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 20 20  .     ")".  ;.  
1ac0: 73 74 61 74 69 63 20 63 68 61 72 20 74 65 6d 70  static char temp
1ad0: 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d  _master_schema[]
1ae0: 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45   = .     "CREATE
1af0: 20 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69   TEMP TABLE sqli
1b00: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c  te_temp_master(\
1b10: 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20  n".     "  type 
1b20: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
1b30: 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20   name text,\n". 
1b40: 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20      "  tbl_name 
1b50: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
1b60: 20 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65   rootpage intege
1b70: 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71  r,\n".     "  sq
1b80: 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22  l text\n".     "
1b90: 29 22 0a 20 20 3b 0a 0a 20 20 2f 2a 20 54 68 65  )".  ;..  /* The
1ba0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 53 51 4c 20 77   following SQL w
1bb0: 69 6c 6c 20 72 65 61 64 20 74 68 65 20 73 63 68  ill read the sch
1bc0: 65 6d 61 20 66 72 6f 6d 20 74 68 65 20 6d 61 73  ema from the mas
1bd0: 74 65 72 20 74 61 62 6c 65 73 2e 0a 20 20 2a 2a  ter tables..  **
1be0: 20 54 68 65 20 66 69 72 73 74 20 76 65 72 73 69   The first versi
1bf0: 6f 6e 20 77 6f 72 6b 73 20 77 69 74 68 20 53 51  on works with SQ
1c00: 4c 69 74 65 20 66 69 6c 65 20 66 6f 72 6d 61 74  Lite file format
1c10: 73 20 32 20 6f 72 20 67 72 65 61 74 65 72 2e 0a  s 2 or greater..
1c20: 20 20 2a 2a 20 54 68 65 20 73 65 63 6f 6e 64 20    ** The second 
1c30: 76 65 72 73 69 6f 6e 20 69 73 20 66 6f 72 20 66  version is for f
1c40: 6f 72 6d 61 74 20 31 20 66 69 6c 65 73 2e 0a 20  ormat 1 files.. 
1c50: 20 2a 2a 0a 20 20 2a 2a 20 42 65 67 69 6e 6e 69   **.  ** Beginni
1c60: 6e 67 20 77 69 74 68 20 66 69 6c 65 20 66 6f 72  ng with file for
1c70: 6d 61 74 20 32 2c 20 74 68 65 20 72 6f 77 69 64  mat 2, the rowid
1c80: 20 66 6f 72 20 6e 65 77 20 74 61 62 6c 65 20 65   for new table e
1c90: 6e 74 72 69 65 73 0a 20 20 2a 2a 20 28 69 6e 63  ntries.  ** (inc
1ca0: 6c 75 64 69 6e 67 20 65 6e 74 72 69 65 73 20 69  luding entries i
1cb0: 6e 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 29  n sqlite_master)
1cc0: 20 69 73 20 61 6e 20 69 6e 63 72 65 61 73 69 6e   is an increasin
1cd0: 67 20 69 6e 74 65 67 65 72 2e 0a 20 20 2a 2a 20  g integer..  ** 
1ce0: 53 6f 20 66 6f 72 20 66 69 6c 65 20 66 6f 72 6d  So for file form
1cf0: 61 74 20 32 20 61 6e 64 20 6c 61 74 65 72 2c 20  at 2 and later, 
1d00: 77 65 20 63 61 6e 20 70 6c 61 79 20 62 61 63 6b  we can play back
1d10: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 0a 20   sqlite_master. 
1d20: 20 2a 2a 20 61 6e 64 20 61 6c 6c 20 74 68 65 20   ** and all the 
1d30: 43 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74  CREATE statement
1d40: 73 20 77 69 6c 6c 20 61 70 70 65 61 72 20 69 6e  s will appear in
1d50: 20 74 68 65 20 72 69 67 68 74 20 6f 72 64 65 72   the right order
1d60: 2e 0a 20 20 2a 2a 20 42 75 74 20 77 69 74 68 20  ..  ** But with 
1d70: 66 69 6c 65 20 66 6f 72 6d 61 74 20 31 2c 20 74  file format 1, t
1d80: 61 62 6c 65 20 65 6e 74 72 69 65 73 20 77 65 72  able entries wer
1d90: 65 20 72 61 6e 64 6f 6d 20 61 6e 64 20 73 6f 20  e random and so 
1da0: 77 65 0a 20 20 2a 2a 20 68 61 76 65 20 74 6f 20  we.  ** have to 
1db0: 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 43 52  make sure the CR
1dc0: 45 41 54 45 20 54 41 42 4c 45 73 20 6f 63 63 75  EATE TABLEs occu
1dd0: 72 20 62 65 66 6f 72 65 20 74 68 65 69 72 20 63  r before their c
1de0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 2a  orresponding.  *
1df0: 2a 20 43 52 45 41 54 45 20 49 4e 44 45 58 73 2e  * CREATE INDEXs.
1e00: 20 20 28 57 65 20 64 6f 6e 27 74 20 68 61 76 65    (We don't have
1e10: 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 43 52   to deal with CR
1e20: 45 41 54 45 20 56 49 45 57 20 6f 72 0a 20 20 2a  EATE VIEW or.  *
1e30: 2a 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52  * CREATE TRIGGER
1e40: 20 69 6e 20 66 69 6c 65 20 66 6f 72 6d 61 74 20   in file format 
1e50: 31 20 62 65 63 61 75 73 65 20 74 68 6f 73 65 20  1 because those 
1e60: 63 6f 6e 73 74 72 75 63 74 73 20 64 69 64 0a 20  constructs did. 
1e70: 20 2a 2a 20 6e 6f 74 20 65 78 69 73 74 20 74 68   ** not exist th
1e80: 65 6e 2e 29 20 0a 20 20 2a 2f 0a 20 20 73 74 61  en.) .  */.  sta
1e90: 74 69 63 20 63 68 61 72 20 69 6e 69 74 5f 73 63  tic char init_sc
1ea0: 72 69 70 74 5b 5d 20 3d 20 0a 20 20 20 20 20 22  ript[] = .     "
1eb0: 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d  SELECT type, nam
1ec0: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c  e, rootpage, sql
1ed0: 2c 20 31 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f  , 1 FROM sqlite_
1ee0: 74 65 6d 70 5f 6d 61 73 74 65 72 20 22 0a 20 20  temp_master ".  
1ef0: 20 20 20 22 55 4e 49 4f 4e 20 41 4c 4c 20 22 0a     "UNION ALL ".
1f00: 20 20 20 20 20 22 53 45 4c 45 43 54 20 74 79 70       "SELECT typ
1f10: 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67  e, name, rootpag
1f20: 65 2c 20 73 71 6c 2c 20 30 20 46 52 4f 4d 20 73  e, sql, 0 FROM s
1f30: 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 3b 0a 20  qlite_master";. 
1f40: 20 73 74 61 74 69 63 20 63 68 61 72 20 6f 6c 64   static char old
1f50: 65 72 5f 69 6e 69 74 5f 73 63 72 69 70 74 5b 5d  er_init_script[]
1f60: 20 3d 20 0a 20 20 20 20 20 22 53 45 4c 45 43 54   = .     "SELECT
1f70: 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f   type, name, roo
1f80: 74 70 61 67 65 2c 20 73 71 6c 2c 20 31 20 46 52  tpage, sql, 1 FR
1f90: 4f 4d 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d  OM sqlite_temp_m
1fa0: 61 73 74 65 72 20 22 0a 20 20 20 20 20 22 55 4e  aster ".     "UN
1fb0: 49 4f 4e 20 41 4c 4c 20 22 0a 20 20 20 20 20 22  ION ALL ".     "
1fc0: 53 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d  SELECT type, nam
1fd0: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c  e, rootpage, sql
1fe0: 2c 20 30 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f  , 0 FROM sqlite_
1ff0: 6d 61 73 74 65 72 20 22 0a 20 20 20 20 20 22 57  master ".     "W
2000: 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c 65  HERE type='table
2010: 27 20 22 0a 20 20 20 20 20 22 55 4e 49 4f 4e 20  ' ".     "UNION 
2020: 41 4c 4c 20 22 0a 20 20 20 20 20 22 53 45 4c 45  ALL ".     "SELE
2030: 43 54 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72  CT type, name, r
2040: 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c 20 30 20  ootpage, sql, 0 
2050: 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74  FROM sqlite_mast
2060: 65 72 20 22 0a 20 20 20 20 20 22 57 48 45 52 45  er ".     "WHERE
2070: 20 74 79 70 65 3d 27 69 6e 64 65 78 27 22 3b 0a   type='index'";.
2080: 0a 0a 20 20 61 73 73 65 72 74 28 20 69 44 62 3e  ..  assert( iDb>
2090: 3d 30 20 26 26 20 69 44 62 21 3d 31 20 26 26 20  =0 && iDb!=1 && 
20a0: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 0a  iDb<db->nDb );..
20b0: 20 20 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74    /* Construct t
20c0: 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73  he schema tables
20d0: 3a 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  : sqlite_master 
20e0: 61 6e 64 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f  and sqlite_temp_
20f0: 6d 61 73 74 65 72 0a 20 20 2a 2f 0a 20 20 73 71  master.  */.  sq
2100: 6c 69 74 65 53 61 66 65 74 79 4f 66 66 28 64 62  liteSafetyOff(db
2110: 29 3b 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d 20  );.  azArg[0] = 
2120: 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a 41 72 67  "table";.  azArg
2130: 5b 31 5d 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d  [1] = MASTER_NAM
2140: 45 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d 20  E;.  azArg[2] = 
2150: 22 32 22 3b 0a 20 20 61 7a 41 72 67 5b 33 5d 20  "2";.  azArg[3] 
2160: 3d 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 3b  = master_schema;
2170: 0a 20 20 73 70 72 69 6e 74 66 28 7a 44 62 4e 75  .  sprintf(zDbNu
2180: 6d 2c 20 22 25 64 22 2c 20 69 44 62 29 3b 0a 20  m, "%d", iDb);. 
2190: 20 61 7a 41 72 67 5b 34 5d 20 3d 20 7a 44 62 4e   azArg[4] = zDbN
21a0: 75 6d 3b 0a 20 20 61 7a 41 72 67 5b 35 5d 20 3d  um;.  azArg[5] =
21b0: 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 64   0;.  initData.d
21c0: 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74 44 61  b = db;.  initDa
21d0: 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20 70 7a  ta.pzErrMsg = pz
21e0: 45 72 72 4d 73 67 3b 0a 20 20 73 71 6c 69 74 65  ErrMsg;.  sqlite
21f0: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 26 69 6e  InitCallback(&in
2200: 69 74 44 61 74 61 2c 20 35 2c 20 61 7a 41 72 67  itData, 5, azArg
2210: 2c 20 30 29 3b 0a 20 20 70 54 61 62 20 3d 20 73  , 0);.  pTab = s
2220: 71 6c 69 74 65 46 69 6e 64 54 61 62 6c 65 28 64  qliteFindTable(d
2230: 62 2c 20 4d 41 53 54 45 52 5f 4e 41 4d 45 2c 20  b, MASTER_NAME, 
2240: 22 6d 61 69 6e 22 29 3b 0a 20 20 69 66 28 20 70  "main");.  if( p
2250: 54 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d  Tab ){.    pTab-
2260: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20  >readOnly = 1;. 
2270: 20 7d 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20   }.  if( iDb==0 
2280: 29 7b 0a 20 20 20 20 61 7a 41 72 67 5b 31 5d 20  ){.    azArg[1] 
2290: 3d 20 54 45 4d 50 5f 4d 41 53 54 45 52 5f 4e 41  = TEMP_MASTER_NA
22a0: 4d 45 3b 0a 20 20 20 20 61 7a 41 72 67 5b 33 5d  ME;.    azArg[3]
22b0: 20 3d 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73   = temp_master_s
22c0: 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a 41 72 67  chema;.    azArg
22d0: 5b 34 5d 20 3d 20 22 31 22 3b 0a 20 20 20 20 73  [4] = "1";.    s
22e0: 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c 62 61 63  qliteInitCallbac
22f0: 6b 28 26 69 6e 69 74 44 61 74 61 2c 20 35 2c 20  k(&initData, 5, 
2300: 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 20 20 70  azArg, 0);.    p
2310: 54 61 62 20 3d 20 73 71 6c 69 74 65 46 69 6e 64  Tab = sqliteFind
2320: 54 61 62 6c 65 28 64 62 2c 20 54 45 4d 50 5f 4d  Table(db, TEMP_M
2330: 41 53 54 45 52 5f 4e 41 4d 45 2c 20 22 74 65 6d  ASTER_NAME, "tem
2340: 70 22 29 3b 0a 20 20 20 20 69 66 28 20 70 54 61  p");.    if( pTa
2350: 62 20 29 7b 0a 20 20 20 20 20 20 70 54 61 62 2d  b ){.      pTab-
2360: 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20  >readOnly = 1;. 
2370: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
2380: 65 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 0a  eSafetyOn(db);..
2390: 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 63 75    /* Create a cu
23a0: 72 73 6f 72 20 74 6f 20 68 6f 6c 64 20 74 68 65  rsor to hold the
23b0: 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 0a 20   database open. 
23c0: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44   */.  if( db->aD
23d0: 62 5b 69 44 62 5d 2e 70 42 74 3d 3d 30 20 29 20  b[iDb].pBt==0 ) 
23e0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
23f0: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 42  ;.  rc = sqliteB
2400: 74 72 65 65 43 75 72 73 6f 72 28 64 62 2d 3e 61  treeCursor(db->a
2410: 44 62 5b 69 44 62 5d 2e 70 42 74 2c 20 32 2c 20  Db[iDb].pBt, 2, 
2420: 30 2c 20 26 63 75 72 4d 61 69 6e 29 3b 0a 20 20  0, &curMain);.  
2430: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 73 71  if( rc ){.    sq
2440: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a  liteSetString(pz
2450: 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65  ErrMsg, sqlite_e
2460: 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29 2c  rror_string(rc),
2470: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20   (char*)0);.    
2480: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a  return rc;.  }..
2490: 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74    /* Get the dat
24a0: 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72  abase meta infor
24b0: 6d 61 74 69 6f 6e 0a 20 20 2a 2f 0a 20 20 72 63  mation.  */.  rc
24c0: 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65 47 65   = sqliteBtreeGe
24d0: 74 4d 65 74 61 28 64 62 2d 3e 61 44 62 5b 69 44  tMeta(db->aDb[iD
24e0: 62 5d 2e 70 42 74 2c 20 6d 65 74 61 29 3b 0a 20  b].pBt, meta);. 
24f0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 73   if( rc ){.    s
2500: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
2510: 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f  zErrMsg, sqlite_
2520: 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29  error_string(rc)
2530: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20  , (char*)0);.   
2540: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73   sqliteBtreeClos
2550: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29  eCursor(curMain)
2560: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
2570: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 69  .  }.  db->aDb[i
2580: 44 62 5d 2e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  Db].schema_cooki
2590: 65 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 69  e = meta[1];.  i
25a0: 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20  f( iDb==0 ){.   
25b0: 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b 69 65   db->next_cookie
25c0: 20 3d 20 6d 65 74 61 5b 31 5d 3b 0a 20 20 20 20   = meta[1];.    
25d0: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20  db->file_format 
25e0: 3d 20 6d 65 74 61 5b 32 5d 3b 0a 20 20 20 20 73  = meta[2];.    s
25f0: 69 7a 65 20 3d 20 6d 65 74 61 5b 33 5d 3b 0a 20  ize = meta[3];. 
2600: 20 20 20 69 66 28 20 73 69 7a 65 3d 3d 30 20 29     if( size==0 )
2610: 7b 20 73 69 7a 65 20 3d 20 4d 41 58 5f 50 41 47  { size = MAX_PAG
2620: 45 53 3b 20 7d 0a 20 20 20 20 64 62 2d 3e 63 61  ES; }.    db->ca
2630: 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b  che_size = size;
2640: 0a 20 20 20 20 64 62 2d 3e 73 61 66 65 74 79 5f  .    db->safety_
2650: 6c 65 76 65 6c 20 3d 20 6d 65 74 61 5b 34 5d 3b  level = meta[4];
2660: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 73 61 66  .    if( db->saf
2670: 65 74 79 5f 6c 65 76 65 6c 3d 3d 30 20 29 20 64  ety_level==0 ) d
2680: 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20  b->safety_level 
2690: 3d 20 32 3b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20  = 2;..    /*.   
26a0: 20 2a 2a 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74   **  file_format
26b0: 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20 32  ==1    Version 2
26c0: 2e 31 2e 30 2e 0a 20 20 20 20 2a 2a 20 20 66 69  .1.0..    **  fi
26d0: 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20 20 20 20  le_format==2    
26e0: 56 65 72 73 69 6f 6e 20 32 2e 32 2e 30 2e 20 41  Version 2.2.0. A
26f0: 64 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20 49  dd support for I
2700: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b  NTEGER PRIMARY K
2710: 45 59 2e 0a 20 20 20 20 2a 2a 20 20 66 69 6c 65  EY..    **  file
2720: 5f 66 6f 72 6d 61 74 3d 3d 33 20 20 20 20 56 65  _format==3    Ve
2730: 72 73 69 6f 6e 20 32 2e 36 2e 30 2e 20 46 69 78  rsion 2.6.0. Fix
2740: 20 65 6d 70 74 79 2d 73 74 72 69 6e 67 20 69 6e   empty-string in
2750: 64 65 78 20 62 75 67 2e 0a 20 20 20 20 2a 2a 20  dex bug..    ** 
2760: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 34 20   file_format==4 
2770: 20 20 20 56 65 72 73 69 6f 6e 20 32 2e 37 2e 30     Version 2.7.0
2780: 2e 20 41 64 64 20 73 75 70 70 6f 72 74 20 66 6f  . Add support fo
2790: 72 20 73 65 70 61 72 61 74 65 20 6e 75 6d 65 72  r separate numer
27a0: 69 63 20 61 6e 64 0a 20 20 20 20 2a 2a 20 20 20  ic and.    **   
27b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
27c0: 20 74 65 78 74 20 64 61 74 61 74 79 70 65 73 2e   text datatypes.
27d0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20  .    */.    if( 
27e0: 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3d  db->file_format=
27f0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  =0 ){.      /* T
2800: 68 69 73 20 68 61 70 70 65 6e 73 20 69 66 20 74  his happens if t
2810: 68 65 20 64 61 74 61 62 61 73 65 20 77 61 73 20  he database was 
2820: 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74 79 20  initially empty 
2830: 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 66 69 6c  */.      db->fil
2840: 65 5f 66 6f 72 6d 61 74 20 3d 20 34 3b 0a 20 20  e_format = 4;.  
2850: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e    }else if( db->
2860: 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 34 20 29 7b  file_format>4 ){
2870: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 42 74 72  .      sqliteBtr
2880: 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75  eeCloseCursor(cu
2890: 72 4d 61 69 6e 29 3b 0a 20 20 20 20 20 20 73 71  rMain);.      sq
28a0: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a  liteSetString(pz
28b0: 45 72 72 4d 73 67 2c 20 22 75 6e 73 75 70 70 6f  ErrMsg, "unsuppo
28c0: 72 74 65 64 20 66 69 6c 65 20 66 6f 72 6d 61 74  rted file format
28d0: 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20  ", (char*)0);.  
28e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
28f0: 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20  E_ERROR;.    }. 
2900: 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e 66   }else if( db->f
2910: 69 6c 65 5f 66 6f 72 6d 61 74 21 3d 6d 65 74 61  ile_format!=meta
2920: 5b 32 5d 20 7c 7c 20 64 62 2d 3e 66 69 6c 65 5f  [2] || db->file_
2930: 66 6f 72 6d 61 74 3c 34 20 29 7b 0a 20 20 20 20  format<4 ){.    
2940: 61 73 73 65 72 74 28 20 64 62 2d 3e 66 69 6c 65  assert( db->file
2950: 5f 66 6f 72 6d 61 74 3e 3d 34 20 29 3b 0a 20 20  _format>=4 );.  
2960: 20 20 69 66 28 20 6d 65 74 61 5b 32 5d 3d 3d 30    if( meta[2]==0
2970: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
2980: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
2990: 73 67 2c 20 22 63 61 6e 6e 6f 74 20 61 74 74 61  sg, "cannot atta
29a0: 63 68 20 65 6d 70 74 79 20 64 61 74 61 62 61 73  ch empty databas
29b0: 65 3a 20 22 2c 0a 20 20 20 20 20 20 20 20 20 64  e: ",.         d
29c0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d  b->aDb[iDb].zNam
29d0: 65 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20  e, (char*)0);.  
29e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73    }else{.      s
29f0: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
2a00: 7a 45 72 72 4d 73 67 2c 20 22 69 6e 63 6f 6d 70  zErrMsg, "incomp
2a10: 61 74 69 62 6c 65 20 66 69 6c 65 20 66 6f 72 6d  atible file form
2a20: 61 74 20 69 6e 20 61 75 78 69 6c 69 61 72 79 20  at in auxiliary 
2a30: 22 0a 20 20 20 20 20 20 20 20 20 22 64 61 74 61  ".         "data
2a40: 62 61 73 65 3a 20 22 2c 20 64 62 2d 3e 61 44 62  base: ", db->aDb
2a50: 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 28 63 68  [iDb].zName, (ch
2a60: 61 72 2a 29 30 29 3b 0a 20 20 20 20 7d 0a 20 20  ar*)0);.    }.  
2a70: 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f    sqliteBtreeClo
2a80: 73 65 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  se(db->aDb[iDb].
2a90: 70 42 74 29 3b 0a 20 20 20 20 64 62 2d 3e 61 44  pBt);.    db->aD
2aa0: 62 5b 69 44 62 5d 2e 70 42 74 20 3d 20 30 3b 0a  b[iDb].pBt = 0;.
2ab0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
2ac0: 45 5f 46 4f 52 4d 41 54 3b 0a 20 20 7d 0a 20 20  E_FORMAT;.  }.  
2ad0: 73 71 6c 69 74 65 42 74 72 65 65 53 65 74 43 61  sqliteBtreeSetCa
2ae0: 63 68 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b  cheSize(db->aDb[
2af0: 69 44 62 5d 2e 70 42 74 2c 20 64 62 2d 3e 63 61  iDb].pBt, db->ca
2b00: 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 73 71 6c  che_size);.  sql
2b10: 69 74 65 42 74 72 65 65 53 65 74 53 61 66 65 74  iteBtreeSetSafet
2b20: 79 4c 65 76 65 6c 28 64 62 2d 3e 61 44 62 5b 69  yLevel(db->aDb[i
2b30: 44 62 5d 2e 70 42 74 2c 20 6d 65 74 61 5b 34 5d  Db].pBt, meta[4]
2b40: 3d 3d 30 20 3f 20 32 20 3a 20 6d 65 74 61 5b 34  ==0 ? 2 : meta[4
2b50: 5d 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74  ]);..  /* Read t
2b60: 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d  he schema inform
2b70: 61 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65  ation out of the
2b80: 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 0a 20   schema tables. 
2b90: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64 62   */.  assert( db
2ba0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20  ->init.busy );. 
2bb0: 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f 66 66   sqliteSafetyOff
2bc0: 28 64 62 29 3b 0a 20 20 69 66 28 20 69 44 62 3d  (db);.  if( iDb=
2bd0: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  =0 ){.    rc = s
2be0: 71 6c 69 74 65 5f 65 78 65 63 28 64 62 2c 20 0a  qlite_exec(db, .
2bf0: 20 20 20 20 20 20 20 20 64 62 2d 3e 66 69 6c 65          db->file
2c00: 5f 66 6f 72 6d 61 74 3e 3d 32 20 3f 20 69 6e 69  _format>=2 ? ini
2c10: 74 5f 73 63 72 69 70 74 20 3a 20 6f 6c 64 65 72  t_script : older
2c20: 5f 69 6e 69 74 5f 73 63 72 69 70 74 2c 0a 20 20  _init_script,.  
2c30: 20 20 20 20 20 20 73 71 6c 69 74 65 49 6e 69 74        sqliteInit
2c40: 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e 69 74 44  Callback, &initD
2c50: 61 74 61 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65  ata, 0);.  }else
2c60: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 71 6c  {.    char *zSql
2c70: 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65   = 0;.    sqlite
2c80: 53 65 74 53 74 72 69 6e 67 28 26 7a 53 71 6c 2c  SetString(&zSql,
2c90: 20 0a 20 20 20 20 20 20 20 22 53 45 4c 45 43 54   .       "SELECT
2ca0: 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f   type, name, roo
2cb0: 74 70 61 67 65 2c 20 73 71 6c 2c 20 22 2c 20 7a  tpage, sql, ", z
2cc0: 44 62 4e 75 6d 2c 20 22 20 46 52 4f 4d 20 5c 22  DbNum, " FROM \"
2cd0: 22 2c 0a 20 20 20 20 20 20 20 64 62 2d 3e 61 44  ",.       db->aD
2ce0: 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 22 5c  b[iDb].zName, "\
2cf0: 22 2e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22  ".sqlite_master"
2d00: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20  , (char*)0);.   
2d10: 20 72 63 20 3d 20 73 71 6c 69 74 65 5f 65 78 65   rc = sqlite_exe
2d20: 63 28 64 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69  c(db, zSql, sqli
2d30: 74 65 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20  teInitCallback, 
2d40: 26 69 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 20  &initData, 0);. 
2d50: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 53     sqliteFree(zS
2d60: 71 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  ql);.  }.  sqlit
2d70: 65 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20  eSafetyOn(db);. 
2d80: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73   sqliteBtreeClos
2d90: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29  eCursor(curMain)
2da0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d  ;.  if( sqlite_m
2db0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
2dc0: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72      sqliteSetStr
2dd0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f  ing(pzErrMsg, "o
2de0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 28  ut of memory", (
2df0: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 63  char*)0);.    rc
2e00: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b   = SQLITE_NOMEM;
2e10: 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74  .    sqliteReset
2e20: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
2e30: 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28  b, 0);.  }.  if(
2e40: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
2e50: 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65  {.    DbSetPrope
2e60: 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f  rty(db, iDb, DB_
2e70: 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20  SchemaLoaded);. 
2e80: 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 7b     if( iDb==0 ){
2e90: 0a 20 20 20 20 20 20 44 62 53 65 74 50 72 6f 70  .      DbSetProp
2ea0: 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53  erty(db, 1, DB_S
2eb0: 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20  chemaLoaded);.  
2ec0: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20    }.  }else{.   
2ed0: 20 73 71 6c 69 74 65 52 65 73 65 74 49 6e 74 65   sqliteResetInte
2ee0: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 69  rnalSchema(db, i
2ef0: 44 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  Db);.  }.  retur
2f00: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  n rc;.}../*.** I
2f10: 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c 20 64 61  nitialize all da
2f20: 74 61 62 61 73 65 20 66 69 6c 65 73 20 2d 20 74  tabase files - t
2f30: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
2f40: 20 66 69 6c 65 2c 20 74 68 65 20 66 69 6c 65 0a   file, the file.
2f50: 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65  ** used to store
2f60: 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65   temporary table
2f70: 73 2c 20 61 6e 64 20 61 6e 79 20 61 64 64 69 74  s, and any addit
2f80: 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66  ional database f
2f90: 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74 65 64 20  iles.** created 
2fa0: 75 73 69 6e 67 20 41 54 54 41 43 48 20 73 74 61  using ATTACH sta
2fb0: 74 65 6d 65 6e 74 73 2e 20 20 52 65 74 75 72 6e  tements.  Return
2fc0: 20 61 20 73 75 63 63 65 73 73 20 63 6f 64 65 2e   a success code.
2fd0: 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72 72 6f 72    If an.** error
2fe0: 20 6f 63 63 75 72 73 2c 20 77 72 69 74 65 20 61   occurs, write a
2ff0: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  n error message 
3000: 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a  into *pzErrMsg..
3010: 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20  **.** After the 
3020: 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69 74  database is init
3030: 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51 4c  ialized, the SQL
3040: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 0a  ITE_Initialized.
3050: 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e  ** bit is set in
3060: 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64   the flags field
3070: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20 73   of the sqlite s
3080: 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a 2a  tructure.  An.**
3090: 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65   attempt is made
30a0: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74   to initialize t
30b0: 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20 73  he database as s
30c0: 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73 20  oon as it.** is 
30d0: 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61 74  opened.  If that
30e0: 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73 20   fails (perhaps 
30f0: 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72 20  because another 
3100: 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20 74  process.** has t
3110: 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  he sqlite_master
3120: 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20 74   table locked) t
3130: 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74 65  han another atte
3140: 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20 74  mpt.** is made t
3150: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68  he first time th
3160: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 63  e database is ac
3170: 63 65 73 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  cessed..*/.int s
3180: 71 6c 69 74 65 49 6e 69 74 28 73 71 6c 69 74 65  qliteInit(sqlite
3190: 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45   *db, char **pzE
31a0: 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 69 2c  rrMsg){.  int i,
31b0: 20 72 63 3b 0a 20 20 0a 20 20 69 66 28 20 64 62   rc;.  .  if( db
31c0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72 65  ->init.busy ) re
31d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
31e0: 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e 66    assert( (db->f
31f0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49 6e  lags & SQLITE_In
3200: 69 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29 3b  itialized)==0 );
3210: 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  .  rc = SQLITE_O
3220: 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75  K;.  db->init.bu
3230: 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69 3d  sy = 1;.  for(i=
3240: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  0; rc==SQLITE_OK
3250: 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69   && i<db->nDb; i
3260: 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44 62 48  ++){.    if( DbH
3270: 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69  asProperty(db, i
3280: 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65  , DB_SchemaLoade
3290: 64 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  d) ) continue;. 
32a0: 20 20 20 61 73 73 65 72 74 28 20 69 21 3d 31 20     assert( i!=1 
32b0: 29 3b 20 20 2f 2a 20 53 68 6f 75 6c 64 20 68 61  );  /* Should ha
32c0: 76 65 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69  ve been initiali
32d0: 7a 65 64 20 74 6f 67 65 74 68 65 72 20 77 69 74  zed together wit
32e0: 68 20 30 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20  h 0 */.    rc = 
32f0: 73 71 6c 69 74 65 49 6e 69 74 4f 6e 65 28 64 62  sqliteInitOne(db
3300: 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a  , i, pzErrMsg);.
3310: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20      if( rc ){.  
3320: 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74 49      sqliteResetI
3330: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62  nternalSchema(db
3340: 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  , i);.    }.  }.
3350: 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20    db->init.busy 
3360: 3d 20 30 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53  = 0;.  if( rc==S
3370: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
3380: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c  db->flags |= SQL
3390: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b  ITE_Initialized;
33a0: 0a 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69  .    sqliteCommi
33b0: 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73  tInternalChanges
33c0: 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  (db);.  }..  /* 
33d0: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  If the database 
33e0: 69 73 20 69 6e 20 66 6f 72 6d 61 74 73 20 31 20  is in formats 1 
33f0: 6f 72 20 32 2c 20 74 68 65 6e 20 75 70 67 72 61  or 2, then upgra
3400: 64 65 20 69 74 20 74 6f 0a 20 20 2a 2a 20 76 65  de it to.  ** ve
3410: 72 73 69 6f 6e 20 33 2e 20 20 54 68 69 73 20 77  rsion 3.  This w
3420: 69 6c 6c 20 72 65 63 6f 6e 73 74 72 75 63 74 20  ill reconstruct 
3430: 61 6c 6c 20 69 6e 64 69 63 65 73 2e 20 20 49 66  all indices.  If
3440: 20 74 68 65 0a 20 20 2a 2a 20 75 70 67 72 61 64   the.  ** upgrad
3450: 65 20 66 61 69 6c 73 20 66 6f 72 20 61 6e 79 20  e fails for any 
3460: 72 65 61 73 6f 6e 20 28 65 78 3a 20 6f 75 74 20  reason (ex: out 
3470: 6f 66 20 64 69 73 6b 20 73 70 61 63 65 2c 20 64  of disk space, d
3480: 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 20  atabase.  ** is 
3490: 72 65 61 64 20 6f 6e 6c 79 2c 20 69 6e 74 65 72  read only, inter
34a0: 72 75 70 74 20 72 65 63 65 69 76 65 64 2c 20 65  rupt received, e
34b0: 74 63 2e 29 20 74 68 65 6e 20 66 61 69 6c 20 74  tc.) then fail t
34c0: 68 65 20 69 6e 69 74 2e 0a 20 20 2a 2f 0a 20 20  he init..  */.  
34d0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
34e0: 4b 20 26 26 20 64 62 2d 3e 66 69 6c 65 5f 66 6f  K && db->file_fo
34f0: 72 6d 61 74 3c 33 20 29 7b 0a 20 20 20 20 63 68  rmat<3 ){.    ch
3500: 61 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 20 20  ar *zErr = 0;.  
3510: 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69 74 44    InitData initD
3520: 61 74 61 3b 0a 20 20 20 20 69 6e 74 20 6d 65 74  ata;.    int met
3530: 61 5b 53 51 4c 49 54 45 5f 4e 5f 42 54 52 45 45  a[SQLITE_N_BTREE
3540: 5f 4d 45 54 41 5d 3b 0a 0a 20 20 20 20 64 62 2d  _META];..    db-
3550: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f  >magic = SQLITE_
3560: 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 20 20  MAGIC_OPEN;.    
3570: 69 6e 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62  initData.db = db
3580: 3b 0a 20 20 20 20 69 6e 69 74 44 61 74 61 2e 70  ;.    initData.p
3590: 7a 45 72 72 4d 73 67 20 3d 20 26 7a 45 72 72 3b  zErrMsg = &zErr;
35a0: 0a 20 20 20 20 64 62 2d 3e 66 69 6c 65 5f 66 6f  .    db->file_fo
35b0: 72 6d 61 74 20 3d 20 33 3b 0a 20 20 20 20 72 63  rmat = 3;.    rc
35c0: 20 3d 20 73 71 6c 69 74 65 5f 65 78 65 63 28 64   = sqlite_exec(d
35d0: 62 2c 0a 20 20 20 20 20 20 22 42 45 47 49 4e 3b  b,.      "BEGIN;
35e0: 20 53 45 4c 45 43 54 20 6e 61 6d 65 20 46 52 4f   SELECT name FRO
35f0: 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  M sqlite_master 
3600: 57 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c  WHERE type='tabl
3610: 65 27 3b 22 2c 0a 20 20 20 20 20 20 75 70 67 72  e';",.      upgr
3620: 61 64 65 5f 33 5f 63 61 6c 6c 62 61 63 6b 2c 0a  ade_3_callback,.
3630: 20 20 20 20 20 20 26 69 6e 69 74 44 61 74 61 2c        &initData,
3640: 0a 20 20 20 20 20 20 26 7a 45 72 72 29 3b 0a 20  .      &zErr);. 
3650: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
3660: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71  E_OK ){.      sq
3670: 6c 69 74 65 42 74 72 65 65 47 65 74 4d 65 74 61  liteBtreeGetMeta
3680: 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c  (db->aDb[0].pBt,
3690: 20 6d 65 74 61 29 3b 0a 20 20 20 20 20 20 6d 65   meta);.      me
36a0: 74 61 5b 32 5d 20 3d 20 34 3b 0a 20 20 20 20 20  ta[2] = 4;.     
36b0: 20 73 71 6c 69 74 65 42 74 72 65 65 55 70 64 61   sqliteBtreeUpda
36c0: 74 65 4d 65 74 61 28 64 62 2d 3e 61 44 62 5b 30  teMeta(db->aDb[0
36d0: 5d 2e 70 42 74 2c 20 6d 65 74 61 29 3b 0a 20 20  ].pBt, meta);.  
36e0: 20 20 20 20 73 71 6c 69 74 65 5f 65 78 65 63 28      sqlite_exec(
36f0: 64 62 2c 20 22 43 4f 4d 4d 49 54 22 2c 20 30 2c  db, "COMMIT", 0,
3700: 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20   0, 0);.    }.  
3710: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
3720: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  _OK ){.      sql
3730: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45  iteSetString(pzE
3740: 72 72 4d 73 67 2c 20 0a 20 20 20 20 20 20 20 20  rrMsg, .        
3750: 22 75 6e 61 62 6c 65 20 74 6f 20 75 70 67 72 61  "unable to upgra
3760: 64 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74  de database to t
3770: 68 65 20 76 65 72 73 69 6f 6e 20 32 2e 36 20 66  he version 2.6 f
3780: 6f 72 6d 61 74 22 2c 0a 20 20 20 20 20 20 20 20  ormat",.        
3790: 7a 45 72 72 20 3f 20 22 3a 20 22 20 3a 20 30 2c  zErr ? ": " : 0,
37a0: 20 7a 45 72 72 2c 20 28 63 68 61 72 2a 29 30 29   zErr, (char*)0)
37b0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
37c0: 74 65 5f 66 72 65 65 6d 65 6d 28 7a 45 72 72 29  te_freemem(zErr)
37d0: 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21  ;.  }..  if( rc!
37e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
37f0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
3800: 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a  SQLITE_Initializ
3810: 65 64 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  ed;.  }.  return
3820: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
3830: 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65  e version of the
3840: 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e 73   library.*/.cons
3850: 74 20 63 68 61 72 20 72 63 73 69 64 5b 5d 20 3d  t char rcsid[] =
3860: 20 22 40 28 23 29 20 5c 30 34 34 49 64 3a 20 53   "@(#) \044Id: S
3870: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 22 20  QLite version " 
3880: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 20 22  SQLITE_VERSION "
3890: 20 24 22 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20   $";.const char 
38a0: 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 5b 5d  sqlite_version[]
38b0: 20 3d 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f   = SQLITE_VERSIO
38c0: 4e 3b 0a 0a 2f 2a 0a 2a 2a 20 44 6f 65 73 20 74  N;../*.** Does t
38d0: 68 65 20 6c 69 62 72 61 72 79 20 65 78 70 65 63  he library expec
38e0: 74 20 64 61 74 61 20 74 6f 20 62 65 20 65 6e 63  t data to be enc
38f0: 6f 64 65 64 20 61 73 20 55 54 46 2d 38 20 6f 72  oded as UTF-8 or
3900: 20 69 73 6f 38 38 35 39 3f 20 20 54 68 65 0a 2a   iso8859?  The.*
3910: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62  * following glob
3920: 61 6c 20 63 6f 6e 73 74 61 6e 74 20 61 6c 77 61  al constant alwa
3930: 79 73 20 6c 65 74 73 20 75 73 20 6b 6e 6f 77 2e  ys lets us know.
3940: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54  .*/.#ifdef SQLIT
3950: 45 5f 55 54 46 38 0a 63 6f 6e 73 74 20 63 68 61  E_UTF8.const cha
3960: 72 20 73 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e  r sqlite_encodin
3970: 67 5b 5d 20 3d 20 22 55 54 46 2d 38 22 3b 0a 23  g[] = "UTF-8";.#
3980: 65 6c 73 65 0a 63 6f 6e 73 74 20 63 68 61 72 20  else.const char 
3990: 73 71 6c 69 74 65 5f 65 6e 63 6f 64 69 6e 67 5b  sqlite_encoding[
39a0: 5d 20 3d 20 22 69 73 6f 38 38 35 39 22 3b 0a 23  ] = "iso8859";.#
39b0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65  endif../*.** Ope
39c0: 6e 20 61 20 6e 65 77 20 53 51 4c 69 74 65 20 64  n a new SQLite d
39d0: 61 74 61 62 61 73 65 2e 20 20 43 6f 6e 73 74 72  atabase.  Constr
39e0: 75 63 74 20 61 6e 20 22 73 71 6c 69 74 65 22 20  uct an "sqlite" 
39f0: 73 74 72 75 63 74 75 72 65 20 74 6f 20 64 65 66  structure to def
3a00: 69 6e 65 0a 2a 2a 20 74 68 65 20 73 74 61 74 65  ine.** the state
3a10: 20 6f 66 20 74 68 69 73 20 64 61 74 61 62 61 73   of this databas
3a20: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70  e and return a p
3a30: 6f 69 6e 74 65 72 20 74 6f 20 74 68 61 74 20 73  ointer to that s
3a40: 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20  tructure..**.** 
3a50: 41 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61  An attempt is ma
3a60: 64 65 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65  de to initialize
3a70: 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64   the in-memory d
3a80: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 20 74  ata structures t
3a90: 68 61 74 0a 2a 2a 20 68 6f 6c 64 20 74 68 65 20  hat.** hold the 
3aa0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e  database schema.
3ab0: 20 20 42 75 74 20 69 66 20 74 68 69 73 20 66 61    But if this fa
3ac0: 69 6c 73 20 28 62 65 63 61 75 73 65 20 74 68 65  ils (because the
3ad0: 20 73 63 68 65 6d 61 20 66 69 6c 65 0a 2a 2a 20   schema file.** 
3ae0: 69 73 20 6c 6f 63 6b 65 64 29 20 74 68 65 6e 20  is locked) then 
3af0: 74 68 61 74 20 73 74 65 70 20 69 73 20 64 65 66  that step is def
3b00: 65 72 72 65 64 20 75 6e 74 69 6c 20 74 68 65 20  erred until the 
3b10: 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a  first call to.**
3b20: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 29 2e 0a   sqlite_exec()..
3b30: 2a 2f 0a 73 71 6c 69 74 65 20 2a 73 71 6c 69 74  */.sqlite *sqlit
3b40: 65 5f 6f 70 65 6e 28 63 6f 6e 73 74 20 63 68 61  e_open(const cha
3b50: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 69 6e  r *zFilename, in
3b60: 74 20 6d 6f 64 65 2c 20 63 68 61 72 20 2a 2a 70  t mode, char **p
3b70: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69  zErrMsg){.  sqli
3b80: 74 65 20 2a 64 62 3b 0a 20 20 69 6e 74 20 72 63  te *db;.  int rc
3b90: 2c 20 69 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63  , i;..  /* Alloc
3ba0: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 20 64  ate the sqlite d
3bb0: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 2a 2f  ata structure */
3bc0: 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 4d 61  .  db = sqliteMa
3bd0: 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 73 71 6c  lloc( sizeof(sql
3be0: 69 74 65 29 20 29 3b 0a 20 20 69 66 28 20 70 7a  ite) );.  if( pz
3bf0: 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 72 4d  ErrMsg ) *pzErrM
3c00: 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 64 62  sg = 0;.  if( db
3c10: 3d 3d 30 20 29 20 67 6f 74 6f 20 6e 6f 5f 6d 65  ==0 ) goto no_me
3c20: 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 20 64 62 2d  m_on_open;.  db-
3c30: 3e 6f 6e 45 72 72 6f 72 20 3d 20 4f 45 5f 44 65  >onError = OE_De
3c40: 66 61 75 6c 74 3b 0a 20 20 64 62 2d 3e 70 72 69  fault;.  db->pri
3c50: 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b 0a  orNewRowid = 0;.
3c60: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51    db->magic = SQ
3c70: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b  LITE_MAGIC_BUSY;
3c80: 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a  .  db->nDb = 2;.
3c90: 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d 3e    db->aDb = db->
3ca0: 61 44 62 53 74 61 74 69 63 3b 0a 20 20 64 62 2d  aDbStatic;.  db-
3cb0: 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45  >flags |= SQLITE
3cc0: 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 3b 0a  _ShortColNames;.
3cd0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
3ce0: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 53 51 4c  (&db->aFunc, SQL
3cf0: 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c  ITE_HASH_STRING,
3d00: 20 31 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20   1);.  for(i=0; 
3d10: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
3d20: 0a 20 20 20 20 73 71 6c 69 74 65 48 61 73 68 49  .    sqliteHashI
3d30: 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e  nit(&db->aDb[i].
3d40: 74 62 6c 48 61 73 68 2c 20 53 51 4c 49 54 45 5f  tblHash, SQLITE_
3d50: 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b  HASH_STRING, 0);
3d60: 0a 20 20 20 20 73 71 6c 69 74 65 48 61 73 68 49  .    sqliteHashI
3d70: 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e  nit(&db->aDb[i].
3d80: 69 64 78 48 61 73 68 2c 20 53 51 4c 49 54 45 5f  idxHash, SQLITE_
3d90: 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b  HASH_STRING, 0);
3da0: 0a 20 20 20 20 73 71 6c 69 74 65 48 61 73 68 49  .    sqliteHashI
3db0: 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d 2e  nit(&db->aDb[i].
3dc0: 74 72 69 67 48 61 73 68 2c 20 53 51 4c 49 54 45  trigHash, SQLITE
3dd0: 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29  _HASH_STRING, 0)
3de0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 48 61 73 68  ;.    sqliteHash
3df0: 49 6e 69 74 28 26 64 62 2d 3e 61 44 62 5b 69 5d  Init(&db->aDb[i]
3e00: 2e 61 46 4b 65 79 2c 20 53 51 4c 49 54 45 5f 48  .aFKey, SQLITE_H
3e10: 41 53 48 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a  ASH_STRING, 1);.
3e20: 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 4f 70 65 6e    }.  .  /* Open
3e30: 20 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74   the backend dat
3e40: 61 62 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a  abase driver */.
3e50: 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 5b    if( zFilename[
3e60: 30 5d 3d 3d 27 3a 27 20 26 26 20 73 74 72 63 6d  0]==':' && strcm
3e70: 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 22 3a 6d 65  p(zFilename,":me
3e80: 6d 6f 72 79 3a 22 29 3d 3d 30 20 29 7b 0a 20 20  mory:")==0 ){.  
3e90: 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65    db->temp_store
3ea0: 20 3d 20 32 3b 0a 20 20 7d 0a 20 20 72 63 20 3d   = 2;.  }.  rc =
3eb0: 20 73 71 6c 69 74 65 42 74 72 65 65 46 61 63 74   sqliteBtreeFact
3ec0: 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e 61 6d  ory(db, zFilenam
3ed0: 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47 45 53 2c  e, 0, MAX_PAGES,
3ee0: 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74   &db->aDb[0].pBt
3ef0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  );.  if( rc!=SQL
3f00: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 77  ITE_OK ){.    sw
3f10: 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20  itch( rc ){.    
3f20: 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20    default: {.   
3f30: 20 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74       sqliteSetSt
3f40: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22  ring(pzErrMsg, "
3f50: 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64  unable to open d
3f60: 61 74 61 62 61 73 65 3a 20 22 2c 0a 20 20 20 20  atabase: ",.    
3f70: 20 20 20 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65         zFilename
3f80: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20  , (char*)0);.   
3f90: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73     }.    }.    s
3fa0: 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a 20  qliteFree(db);. 
3fb0: 20 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c     sqliteStrReal
3fc0: 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20  loc(pzErrMsg);. 
3fd0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
3fe0: 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a 4e  .  db->aDb[0].zN
3ff0: 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 20  ame = "main";.  
4000: 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 4e 61 6d 65  db->aDb[1].zName
4010: 20 3d 20 22 74 65 6d 70 22 3b 0a 0a 20 20 2f 2a   = "temp";..  /*
4020: 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64   Attempt to read
4030: 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f 0a 20   the schema */. 
4040: 20 73 71 6c 69 74 65 52 65 67 69 73 74 65 72 42   sqliteRegisterB
4050: 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28  uiltinFunctions(
4060: 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  db);.  rc = sqli
4070: 74 65 49 6e 69 74 28 64 62 2c 20 70 7a 45 72 72  teInit(db, pzErr
4080: 4d 73 67 29 3b 0a 20 20 64 62 2d 3e 6d 61 67 69  Msg);.  db->magi
4090: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  c = SQLITE_MAGIC
40a0: 5f 4f 50 45 4e 3b 0a 20 20 69 66 28 20 73 71 6c  _OPEN;.  if( sql
40b0: 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  ite_malloc_faile
40c0: 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f  d ){.    sqlite_
40d0: 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 67  close(db);.    g
40e0: 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  oto no_mem_on_op
40f0: 65 6e 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  en;.  }else if( 
4100: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc!=SQLITE_OK &&
4110: 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59   rc!=SQLITE_BUSY
4120: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 63   ){.    sqlite_c
4130: 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 73 71  lose(db);.    sq
4140: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
4150: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72 65  zErrMsg);.    re
4160: 74 75 72 6e 20 30 3b 0a 20 20 7d 65 6c 73 65 20  turn 0;.  }else 
4170: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
4180: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 2a      sqliteFree(*
4190: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 2a  pzErrMsg);.    *
41a0: 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20  pzErrMsg = 0;.  
41b0: 7d 0a 0a 20 20 2f 2a 20 52 65 74 75 72 6e 20 61  }..  /* Return a
41c0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
41d0: 6e 65 77 6c 79 20 6f 70 65 6e 65 64 20 64 61 74  newly opened dat
41e0: 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 20  abase structure 
41f0: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 64 62 3b 0a  */.  return db;.
4200: 0a 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3a  .no_mem_on_open:
4210: 0a 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69  .  sqliteSetStri
4220: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75  ng(pzErrMsg, "ou
4230: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 28 63  t of memory", (c
4240: 68 61 72 2a 29 30 29 3b 0a 20 20 73 71 6c 69 74  har*)0);.  sqlit
4250: 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72  eStrRealloc(pzEr
4260: 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20  rMsg);.  return 
4270: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  0;.}../*.** Retu
4280: 72 6e 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20  rn the ROWID of 
4290: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
42a0: 69 6e 73 65 72 74 0a 2a 2f 0a 69 6e 74 20 73 71  insert.*/.int sq
42b0: 6c 69 74 65 5f 6c 61 73 74 5f 69 6e 73 65 72 74  lite_last_insert
42c0: 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 20 2a 64  _rowid(sqlite *d
42d0: 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d  b){.  return db-
42e0: 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d 0a 0a 2f  >lastRowid;.}../
42f0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
4300: 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65  number of change
4310: 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 20 72 65  s in the most re
4320: 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c  cent call to sql
4330: 69 74 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 69  ite_exec()..*/.i
4340: 6e 74 20 73 71 6c 69 74 65 5f 63 68 61 6e 67 65  nt sqlite_change
4350: 73 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a 20  s(sqlite *db){. 
4360: 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 43 68 61   return db->nCha
4370: 6e 67 65 3b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69  nge;.}..int sqli
4380: 74 65 5f 6c 61 73 74 5f 73 74 61 74 65 6d 65 6e  te_last_statemen
4390: 74 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65  t_changes(sqlite
43a0: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20   *db){.  return 
43b0: 64 62 2d 3e 6c 73 43 68 61 6e 67 65 3b 0a 7d 0a  db->lsChange;.}.
43c0: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20  ./*.** Close an 
43d0: 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20  existing SQLite 
43e0: 64 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69 64  database.*/.void
43f0: 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73 71   sqlite_close(sq
4400: 6c 69 74 65 20 2a 64 62 29 7b 0a 20 20 48 61 73  lite *db){.  Has
4410: 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74 20  hElem *i;.  int 
4420: 6a 3b 0a 20 20 64 62 2d 3e 77 61 6e 74 5f 74 6f  j;.  db->want_to
4430: 5f 63 6c 6f 73 65 20 3d 20 31 3b 0a 20 20 69 66  _close = 1;.  if
4440: 28 20 73 71 6c 69 74 65 53 61 66 65 74 79 43 68  ( sqliteSafetyCh
4450: 65 63 6b 28 64 62 29 20 7c 7c 20 73 71 6c 69 74  eck(db) || sqlit
4460: 65 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29 7b  eSafetyOn(db) ){
4470: 0a 20 20 20 20 2f 2a 20 70 72 69 6e 74 66 28 22  .    /* printf("
4480: 44 49 44 20 4e 4f 54 20 43 4c 4f 53 45 5c 6e 22  DID NOT CLOSE\n"
4490: 29 3b 20 66 66 6c 75 73 68 28 73 74 64 6f 75 74  ); fflush(stdout
44a0: 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e  ); */.    return
44b0: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 69  ;.  }.  db->magi
44c0: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  c = SQLITE_MAGIC
44d0: 5f 43 4c 4f 53 45 44 3b 0a 20 20 66 6f 72 28 6a  _CLOSED;.  for(j
44e0: 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a  =0; j<db->nDb; j
44f0: 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20  ++){.    struct 
4500: 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e 61  Db *pDb = &db->a
4510: 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 70  Db[j];.    if( p
4520: 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20  Db->pBt ){.     
4530: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73   sqliteBtreeClos
4540: 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20  e(pDb->pBt);.   
4550: 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b     pDb->pBt = 0;
4560: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c  .    }.  }.  sql
4570: 69 74 65 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  iteResetInternal
4580: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
4590: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62   assert( db->nDb
45a0: 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28  <=2 );.  assert(
45b0: 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44   db->aDb==db->aD
45c0: 62 53 74 61 74 69 63 20 29 3b 0a 20 20 66 6f 72  bStatic );.  for
45d0: 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72  (i=sqliteHashFir
45e0: 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 20  st(&db->aFunc); 
45f0: 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e  i; i=sqliteHashN
4600: 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46 75 6e  ext(i)){.    Fun
4610: 63 44 65 66 20 2a 70 46 75 6e 63 2c 20 2a 70 4e  cDef *pFunc, *pN
4620: 65 78 74 3b 0a 20 20 20 20 66 6f 72 28 70 46 75  ext;.    for(pFu
4630: 6e 63 20 3d 20 28 46 75 6e 63 44 65 66 2a 29 73  nc = (FuncDef*)s
4640: 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 29  qliteHashData(i)
4650: 3b 20 70 46 75 6e 63 3b 20 70 46 75 6e 63 3d 70  ; pFunc; pFunc=p
4660: 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 70 4e 65  Next){.      pNe
4670: 78 74 20 3d 20 70 46 75 6e 63 2d 3e 70 4e 65 78  xt = pFunc->pNex
4680: 74 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  t;.      sqliteF
4690: 72 65 65 28 70 46 75 6e 63 29 3b 0a 20 20 20 20  ree(pFunc);.    
46a0: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 48 61  }.  }.  sqliteHa
46b0: 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 46 75  shClear(&db->aFu
46c0: 6e 63 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  nc);.  sqliteFre
46d0: 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  e(db);.}../*.** 
46e0: 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74  Rollback all dat
46f0: 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a  abase files..*/.
4700: 76 6f 69 64 20 73 71 6c 69 74 65 52 6f 6c 6c 62  void sqliteRollb
4710: 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 20 2a 64  ackAll(sqlite *d
4720: 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66  b){.  int i;.  f
4730: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
4740: 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  b; i++){.    if(
4750: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 20   db->aDb[i].pBt 
4760: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 42  ){.      sqliteB
4770: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d  treeRollback(db-
4780: 3e 61 44 62 5b 69 5d 2e 70 42 74 29 3b 0a 20 20  >aDb[i].pBt);.  
4790: 20 20 20 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 69      db->aDb[i].i
47a0: 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 20 20  nTrans = 0;.    
47b0: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 52 65  }.  }.  sqliteRe
47c0: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
47d0: 61 28 64 62 2c 20 30 29 3b 0a 20 20 2f 2a 20 73  a(db, 0);.  /* s
47e0: 71 6c 69 74 65 52 6f 6c 6c 62 61 63 6b 49 6e 74  qliteRollbackInt
47f0: 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29  ernalChanges(db)
4800: 3b 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78  ; */.}../*.** Ex
4810: 65 63 75 74 65 20 53 51 4c 20 63 6f 64 65 2e 20  ecute SQL code. 
4820: 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74   Return one of t
4830: 68 65 20 53 51 4c 49 54 45 5f 20 73 75 63 63 65  he SQLITE_ succe
4840: 73 73 2f 66 61 69 6c 75 72 65 0a 2a 2a 20 63 6f  ss/failure.** co
4850: 64 65 73 2e 20 20 41 6c 73 6f 20 77 72 69 74 65  des.  Also write
4860: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67   an error messag
4870: 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62  e into memory ob
4880: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 6d  tained from.** m
4890: 61 6c 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65  alloc() and make
48a0: 20 2a 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74   *pzErrMsg point
48b0: 20 74 6f 20 74 68 61 74 20 6d 65 73 73 61 67 65   to that message
48c0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53  ..**.** If the S
48d0: 51 4c 20 69 73 20 61 20 71 75 65 72 79 2c 20 74  QL is a query, t
48e0: 68 65 6e 20 66 6f 72 20 65 61 63 68 20 72 6f 77  hen for each row
48f0: 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 72 65   in the query re
4900: 73 75 6c 74 0a 2a 2a 20 74 68 65 20 78 43 61 6c  sult.** the xCal
4910: 6c 62 61 63 6b 28 29 20 66 75 6e 63 74 69 6f 6e  lback() function
4920: 20 69 73 20 63 61 6c 6c 65 64 2e 20 20 70 41 72   is called.  pAr
4930: 67 20 62 65 63 6f 6d 65 73 20 74 68 65 20 66 69  g becomes the fi
4940: 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20  rst.** argument 
4950: 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 2e 20  to xCallback(). 
4960: 20 49 66 20 78 43 61 6c 6c 62 61 63 6b 3d 4e 55   If xCallback=NU
4970: 4c 4c 20 74 68 65 6e 20 6e 6f 20 63 61 6c 6c 62  LL then no callb
4980: 61 63 6b 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65  ack.** is invoke
4990: 64 2c 20 65 76 65 6e 20 66 6f 72 20 71 75 65 72  d, even for quer
49a0: 69 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ies..*/.int sqli
49b0: 74 65 5f 65 78 65 63 28 0a 20 20 73 71 6c 69 74  te_exec(.  sqlit
49c0: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
49d0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61         /* The da
49e0: 74 61 62 61 73 65 20 6f 6e 20 77 68 69 63 68 20  tabase on which 
49f0: 74 68 65 20 53 51 4c 20 65 78 65 63 75 74 65 73  the SQL executes
4a00: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
4a10: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
4a20: 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f 20    /* The SQL to 
4a30: 62 65 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20  be executed */. 
4a40: 20 73 71 6c 69 74 65 5f 63 61 6c 6c 62 61 63 6b   sqlite_callback
4a50: 20 78 43 61 6c 6c 62 61 63 6b 2c 20 20 2f 2a 20   xCallback,  /* 
4a60: 49 6e 76 6f 6b 65 20 74 68 69 73 20 63 61 6c 6c  Invoke this call
4a70: 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 2a 2f 0a  back routine */.
4a80: 20 20 76 6f 69 64 20 2a 70 41 72 67 2c 20 20 20    void *pArg,   
4a90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4aa0: 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20   First argument 
4ab0: 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a  to xCallback() *
4ac0: 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  /.  char **pzErr
4ad0: 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20  Msg             
4ae0: 2f 2a 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d  /* Write error m
4af0: 65 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a  essages here */.
4b00: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
4b10: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 6f 6e 73 74  LITE_OK;.  const
4b20: 20 63 68 61 72 20 2a 7a 4c 65 66 74 6f 76 65 72   char *zLeftover
4b30: 3b 0a 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a 70  ;.  sqlite_vm *p
4b40: 56 6d 3b 0a 20 20 69 6e 74 20 6e 52 65 74 72 79  Vm;.  int nRetry
4b50: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 43 68 61   = 0;.  int nCha
4b60: 6e 67 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e  nge = 0;.  int n
4b70: 43 61 6c 6c 62 61 63 6b 3b 0a 0a 20 20 69 66 28  Callback;..  if(
4b80: 20 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72   zSql==0 ) retur
4b90: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 77  n SQLITE_OK;.  w
4ba0: 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45  hile( rc==SQLITE
4bb0: 5f 4f 4b 20 26 26 20 7a 53 71 6c 5b 30 5d 20 29  _OK && zSql[0] )
4bc0: 7b 0a 20 20 20 20 70 56 6d 20 3d 20 30 3b 0a 20  {.    pVm = 0;. 
4bd0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 5f 63     rc = sqlite_c
4be0: 6f 6d 70 69 6c 65 28 64 62 2c 20 7a 53 71 6c 2c  ompile(db, zSql,
4bf0: 20 26 7a 4c 65 66 74 6f 76 65 72 2c 20 26 70 56   &zLeftover, &pV
4c00: 6d 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  m, pzErrMsg);.  
4c10: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
4c20: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 73  _OK ){.      ass
4c30: 65 72 74 28 20 70 56 6d 3d 3d 30 20 7c 7c 20 73  ert( pVm==0 || s
4c40: 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69  qlite_malloc_fai
4c50: 6c 65 64 20 29 3b 0a 20 20 20 20 20 20 72 65 74  led );.      ret
4c60: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20  urn rc;.    }.  
4c70: 20 20 69 66 28 20 70 56 6d 3d 3d 30 20 29 7b 0a    if( pVm==0 ){.
4c80: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 68 61        /* This ha
4c90: 70 70 65 6e 73 20 69 66 20 74 68 65 20 7a 53 71  ppens if the zSq
4ca0: 6c 20 69 6e 70 75 74 20 63 6f 6e 74 61 69 6e 65  l input containe
4cb0: 64 20 6f 6e 6c 79 20 77 68 69 74 65 73 70 61 63  d only whitespac
4cc0: 65 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 6b  e */.      break
4cd0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e  ;.    }.    db->
4ce0: 6e 43 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e  nChange += nChan
4cf0: 67 65 3b 0a 20 20 20 20 6e 43 61 6c 6c 62 61 63  ge;.    nCallbac
4d00: 6b 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 6c 65  k = 0;.    while
4d10: 28 31 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e  (1){.      int n
4d20: 41 72 67 3b 0a 20 20 20 20 20 20 63 68 61 72 20  Arg;.      char 
4d30: 2a 2a 61 7a 41 72 67 2c 20 2a 2a 61 7a 43 6f 6c  **azArg, **azCol
4d40: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  ;.      rc = sql
4d50: 69 74 65 5f 73 74 65 70 28 70 56 6d 2c 20 26 6e  ite_step(pVm, &n
4d60: 41 72 67 2c 20 28 63 6f 6e 73 74 20 63 68 61 72  Arg, (const char
4d70: 2a 2a 2a 29 26 61 7a 41 72 67 2c 28 63 6f 6e 73  ***)&azArg,(cons
4d80: 74 20 63 68 61 72 2a 2a 2a 29 26 61 7a 43 6f 6c  t char***)&azCol
4d90: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d  );.      if( rc=
4da0: 3d 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a 20  =SQLITE_ROW ){. 
4db0: 20 20 20 20 20 20 20 69 66 28 20 78 43 61 6c 6c         if( xCall
4dc0: 62 61 63 6b 21 3d 30 20 26 26 20 78 43 61 6c 6c  back!=0 && xCall
4dd0: 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72 67 2c  back(pArg, nArg,
4de0: 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29 20 29   azArg, azCol) )
4df0: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
4e00: 74 65 5f 66 69 6e 61 6c 69 7a 65 28 70 56 6d 2c  te_finalize(pVm,
4e10: 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72   0);.          r
4e20: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41 42 4f  eturn SQLITE_ABO
4e30: 52 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  RT;.        }.  
4e40: 20 20 20 20 20 20 6e 43 61 6c 6c 62 61 63 6b 2b        nCallback+
4e50: 2b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  +;.      }else{.
4e60: 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d          if( rc==
4e70: 53 51 4c 49 54 45 5f 44 4f 4e 45 20 26 26 20 6e  SQLITE_DONE && n
4e80: 43 61 6c 6c 62 61 63 6b 3d 3d 30 0a 20 20 20 20  Callback==0.    
4e90: 20 20 20 20 20 20 26 26 20 28 64 62 2d 3e 66 6c        && (db->fl
4ea0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4e 75 6c  ags & SQLITE_Nul
4eb0: 6c 43 61 6c 6c 62 61 63 6b 29 21 3d 30 20 26 26  lCallback)!=0 &&
4ec0: 20 78 43 61 6c 6c 62 61 63 6b 21 3d 30 20 29 7b   xCallback!=0 ){
4ed0: 0a 20 20 20 20 20 20 20 20 20 20 78 43 61 6c 6c  .          xCall
4ee0: 62 61 63 6b 28 70 41 72 67 2c 20 6e 41 72 67 2c  back(pArg, nArg,
4ef0: 20 61 7a 41 72 67 2c 20 61 7a 43 6f 6c 29 3b 0a   azArg, azCol);.
4f00: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
4f10: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 5f 66 69    rc = sqlite_fi
4f20: 6e 61 6c 69 7a 65 28 70 56 6d 2c 20 70 7a 45 72  nalize(pVm, pzEr
4f30: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 20 20 69  rMsg);.        i
4f40: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43  f( rc==SQLITE_SC
4f50: 48 45 4d 41 20 26 26 20 6e 52 65 74 72 79 3c 32  HEMA && nRetry<2
4f60: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 52   ){.          nR
4f70: 65 74 72 79 2b 2b 3b 0a 20 20 20 20 20 20 20 20  etry++;.        
4f80: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
4f90: 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61  ;.          brea
4fa0: 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  k;.        }.   
4fb0: 20 20 20 20 20 69 66 28 20 64 62 2d 3e 70 56 64       if( db->pVd
4fc0: 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  be==0 ){.       
4fd0: 20 20 20 6e 43 68 61 6e 67 65 20 3d 20 64 62 2d     nChange = db-
4fe0: 3e 6e 43 68 61 6e 67 65 3b 0a 20 20 20 20 20 20  >nChange;.      
4ff0: 20 20 7d 0a 20 20 20 20 20 20 20 20 6e 52 65 74    }.        nRet
5000: 72 79 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  ry = 0;.        
5010: 7a 53 71 6c 20 3d 20 7a 4c 65 66 74 6f 76 65 72  zSql = zLeftover
5020: 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28  ;.        while(
5030: 20 69 73 73 70 61 63 65 28 7a 53 71 6c 5b 30 5d   isspace(zSql[0]
5040: 29 20 29 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20  ) ) zSql++;.    
5050: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
5060: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72   }.    }.  }.  r
5070: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a  eturn rc;.}.../*
5080: 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 61 20 73 69  .** Compile a si
5090: 6e 67 6c 65 20 73 74 61 74 65 6d 65 6e 74 20 6f  ngle statement o
50a0: 66 20 53 51 4c 20 69 6e 74 6f 20 61 20 76 69 72  f SQL into a vir
50b0: 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20 52  tual machine.  R
50c0: 65 74 75 72 6e 20 6f 6e 65 0a 2a 2a 20 6f 66 20  eturn one.** of 
50d0: 74 68 65 20 53 51 4c 49 54 45 5f 20 73 75 63 63  the SQLITE_ succ
50e0: 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f 64 65  ess/failure code
50f0: 73 2e 20 20 41 6c 73 6f 20 77 72 69 74 65 20 61  s.  Also write a
5100: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  n error message 
5110: 69 6e 74 6f 0a 2a 2a 20 6d 65 6d 6f 72 79 20 6f  into.** memory o
5120: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c  btained from mal
5130: 6c 6f 63 28 29 20 61 6e 64 20 6d 61 6b 65 20 2a  loc() and make *
5140: 70 7a 45 72 72 4d 73 67 20 70 6f 69 6e 74 20 74  pzErrMsg point t
5150: 6f 20 74 68 61 74 20 6d 65 73 73 61 67 65 2e 0a  o that message..
5160: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 6f  */.int sqlite_co
5170: 6d 70 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 20  mpile(.  sqlite 
5180: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
5190: 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61       /* The data
51a0: 62 61 73 65 20 6f 6e 20 77 68 69 63 68 20 74 68  base on which th
51b0: 65 20 53 51 4c 20 65 78 65 63 75 74 65 73 20 2a  e SQL executes *
51c0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
51d0: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20 20  zSql,           
51e0: 2f 2a 20 54 68 65 20 53 51 4c 20 74 6f 20 62 65  /* The SQL to be
51f0: 20 65 78 65 63 75 74 65 64 20 2a 2f 0a 20 20 63   executed */.  c
5200: 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61  onst char **pzTa
5210: 69 6c 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f 55  il,        /* OU
5220: 54 3a 20 4e 65 78 74 20 73 74 61 74 65 6d 65 6e  T: Next statemen
5230: 74 20 61 66 74 65 72 20 74 68 65 20 66 69 72 73  t after the firs
5240: 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 76 6d  t */.  sqlite_vm
5250: 20 2a 2a 70 70 56 6d 2c 20 20 20 20 20 20 20 20   **ppVm,        
5260: 20 20 20 2f 2a 20 4f 55 54 3a 20 54 68 65 20 76     /* OUT: The v
5270: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 2a  irtual machine *
5280: 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  /.  char **pzErr
5290: 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20  Msg             
52a0: 2f 2a 20 4f 55 54 3a 20 57 72 69 74 65 20 65 72  /* OUT: Write er
52b0: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72  ror messages her
52c0: 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 20  e */.){.  Parse 
52d0: 73 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20 70  sParse;..  if( p
52e0: 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 72  zErrMsg ) *pzErr
52f0: 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 73  Msg = 0;.  if( s
5300: 71 6c 69 74 65 53 61 66 65 74 79 4f 6e 28 64 62  qliteSafetyOn(db
5310: 29 20 29 20 67 6f 74 6f 20 65 78 65 63 5f 6d 69  ) ) goto exec_mi
5320: 73 75 73 65 3b 0a 20 20 69 66 28 20 21 64 62 2d  suse;.  if( !db-
5330: 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20  >init.busy ){.  
5340: 20 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73    if( (db->flags
5350: 20 26 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61   & SQLITE_Initia
5360: 6c 69 7a 65 64 29 3d 3d 30 20 29 7b 0a 20 20 20  lized)==0 ){.   
5370: 20 20 20 69 6e 74 20 72 63 2c 20 63 6e 74 20 3d     int rc, cnt =
5380: 20 31 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28   1;.      while(
5390: 20 28 72 63 20 3d 20 73 71 6c 69 74 65 49 6e 69   (rc = sqliteIni
53a0: 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29 29  t(db, pzErrMsg))
53b0: 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 0a 20 20  ==SQLITE_BUSY.  
53c0: 20 20 20 20 20 20 20 26 26 20 64 62 2d 3e 78 42         && db->xB
53d0: 75 73 79 43 61 6c 6c 62 61 63 6b 0a 20 20 20 20  usyCallback.    
53e0: 20 20 20 20 20 26 26 20 64 62 2d 3e 78 42 75 73       && db->xBus
53f0: 79 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 42  yCallback(db->pB
5400: 75 73 79 41 72 67 2c 20 22 22 2c 20 63 6e 74 2b  usyArg, "", cnt+
5410: 2b 29 21 3d 30 20 29 7b 7d 0a 20 20 20 20 20 20  +)!=0 ){}.      
5420: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
5430: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  K ){.        sql
5440: 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  iteStrRealloc(pz
5450: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 20  ErrMsg);.       
5460: 20 73 71 6c 69 74 65 53 61 66 65 74 79 4f 66 66   sqliteSafetyOff
5470: 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 72 65  (db);.        re
5480: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d  turn rc;.      }
5490: 0a 20 20 20 20 20 20 69 66 28 20 70 7a 45 72 72  .      if( pzErr
54a0: 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 20 20 73  Msg ){.        s
54b0: 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72 72  qliteFree(*pzErr
54c0: 4d 73 67 29 3b 0a 20 20 20 20 20 20 20 20 2a 70  Msg);.        *p
54d0: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20  zErrMsg = 0;.   
54e0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69     }.    }.    i
54f0: 66 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72 6d  f( db->file_form
5500: 61 74 3c 33 20 29 7b 0a 20 20 20 20 20 20 73 71  at<3 ){.      sq
5510: 6c 69 74 65 53 61 66 65 74 79 4f 66 66 28 64 62  liteSafetyOff(db
5520: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 53  );.      sqliteS
5530: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73  etString(pzErrMs
5540: 67 2c 20 22 6f 62 73 6f 6c 65 74 65 20 64 61 74  g, "obsolete dat
5550: 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 6d 61  abase file forma
5560: 74 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  t", (char*)0);. 
5570: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
5580: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a  TE_ERROR;.    }.
5590: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28 64    }.  assert( (d
55a0: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54  b->flags & SQLIT
55b0: 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 21 3d  E_Initialized)!=
55c0: 30 20 7c 7c 20 64 62 2d 3e 69 6e 69 74 2e 62 75  0 || db->init.bu
55d0: 73 79 20 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e  sy );.  if( db->
55e0: 70 56 64 62 65 3d 3d 30 20 29 7b 20 64 62 2d 3e  pVdbe==0 ){ db->
55f0: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 20 7d 0a 20  nChange = 0; }. 
5600: 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c   memset(&sParse,
5610: 20 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73   0, sizeof(sPars
5620: 65 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62  e));.  sParse.db
5630: 20 3d 20 64 62 3b 0a 20 20 69 66 28 20 64 62 2d   = db;.  if( db-
5640: 3e 78 54 72 61 63 65 20 29 20 64 62 2d 3e 78 54  >xTrace ) db->xT
5650: 72 61 63 65 28 64 62 2d 3e 70 54 72 61 63 65 41  race(db->pTraceA
5660: 72 67 2c 20 7a 53 71 6c 29 3b 0a 20 20 73 71 6c  rg, zSql);.  sql
5670: 69 74 65 52 75 6e 50 61 72 73 65 72 28 26 73 50  iteRunParser(&sP
5680: 61 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72  arse, zSql, pzEr
5690: 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 73 71 6c  rMsg);.  if( sql
56a0: 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  ite_malloc_faile
56b0: 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53  d ){.    sqliteS
56c0: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73  etString(pzErrMs
56d0: 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72  g, "out of memor
56e0: 79 22 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20  y", (char*)0);. 
56f0: 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53     sParse.rc = S
5700: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
5710: 20 73 71 6c 69 74 65 52 6f 6c 6c 62 61 63 6b 41   sqliteRollbackA
5720: 6c 6c 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69  ll(db);.    sqli
5730: 74 65 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53  teResetInternalS
5740: 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20  chema(db, 0);.  
5750: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e    db->flags &= ~
5760: 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b 0a  SQLITE_InTrans;.
5770: 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72 73 65    }.  if( sParse
5780: 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45  .rc==SQLITE_DONE
5790: 20 29 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53   ) sParse.rc = S
57a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20  QLITE_OK;.  if( 
57b0: 73 50 61 72 73 65 2e 72 63 21 3d 53 51 4c 49 54  sParse.rc!=SQLIT
57c0: 45 5f 4f 4b 20 26 26 20 70 7a 45 72 72 4d 73 67  E_OK && pzErrMsg
57d0: 20 26 26 20 2a 70 7a 45 72 72 4d 73 67 3d 3d 30   && *pzErrMsg==0
57e0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65   ){.    sqliteSe
57f0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
5800: 2c 20 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f 73  , sqlite_error_s
5810: 74 72 69 6e 67 28 73 50 61 72 73 65 2e 72 63 29  tring(sParse.rc)
5820: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 7d  , (char*)0);.  }
5830: 0a 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c  .  sqliteStrReal
5840: 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20  loc(pzErrMsg);. 
5850: 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d   if( sParse.rc==
5860: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b  SQLITE_SCHEMA ){
5870: 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74  .    sqliteReset
5880: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
5890: 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 61 73 73  b, 0);.  }.  ass
58a0: 65 72 74 28 20 70 70 56 6d 20 29 3b 0a 20 20 2a  ert( ppVm );.  *
58b0: 70 70 56 6d 20 3d 20 28 73 71 6c 69 74 65 5f 76  ppVm = (sqlite_v
58c0: 6d 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 3b  m*)sParse.pVdbe;
58d0: 0a 20 20 69 66 28 20 70 7a 54 61 69 6c 20 29 20  .  if( pzTail ) 
58e0: 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72 73 65  *pzTail = sParse
58f0: 2e 7a 54 61 69 6c 3b 0a 20 20 69 66 28 20 73 71  .zTail;.  if( sq
5900: 6c 69 74 65 53 61 66 65 74 79 4f 66 66 28 64 62  liteSafetyOff(db
5910: 29 20 29 20 67 6f 74 6f 20 65 78 65 63 5f 6d 69  ) ) goto exec_mi
5920: 73 75 73 65 3b 0a 20 20 72 65 74 75 72 6e 20 73  suse;.  return s
5930: 50 61 72 73 65 2e 72 63 3b 0a 0a 65 78 65 63 5f  Parse.rc;..exec_
5940: 6d 69 73 75 73 65 3a 0a 20 20 69 66 28 20 70 7a  misuse:.  if( pz
5950: 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 2a 70  ErrMsg ){.    *p
5960: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20  zErrMsg = 0;.   
5970: 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67   sqliteSetString
5980: 28 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74  (pzErrMsg, sqlit
5990: 65 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 53  e_error_string(S
59a0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 2c 20 28  QLITE_MISUSE), (
59b0: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 73 71  char*)0);.    sq
59c0: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
59d0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20  zErrMsg);.  }.  
59e0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
59f0: 53 55 53 45 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  SUSE;.}.../*.** 
5a00: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f  The following ro
5a10: 75 74 69 6e 65 20 64 65 73 74 72 6f 79 73 20 61  utine destroys a
5a20: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5a30: 20 74 68 61 74 20 69 73 20 63 72 65 61 74 65 64   that is created
5a40: 20 62 79 0a 2a 2a 20 74 68 65 20 73 71 6c 69 74   by.** the sqlit
5a50: 65 5f 63 6f 6d 70 69 6c 65 28 29 20 72 6f 75 74  e_compile() rout
5a60: 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69  ine..**.** The i
5a70: 6e 74 65 67 65 72 20 72 65 74 75 72 6e 65 64 20  nteger returned 
5a80: 69 73 20 61 6e 20 53 51 4c 49 54 45 5f 20 73 75  is an SQLITE_ su
5a90: 63 63 65 73 73 2f 66 61 69 6c 75 72 65 20 63 6f  ccess/failure co
5aa0: 64 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65  de that describe
5ab0: 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c 74 20  s.** the result 
5ac0: 6f 66 20 65 78 65 63 75 74 69 6e 67 20 74 68 65  of executing the
5ad0: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5ae0: 2e 20 20 41 6e 20 65 72 72 6f 72 20 6d 65 73 73  .  An error mess
5af0: 61 67 65 20 69 73 0a 2a 2a 20 77 72 69 74 74 65  age is.** writte
5b00: 6e 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62  n into memory ob
5b10: 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c  tained from mall
5b20: 6f 63 20 61 6e 64 20 2a 70 7a 45 72 72 4d 73 67  oc and *pzErrMsg
5b30: 20 69 73 20 6d 61 64 65 20 74 6f 0a 2a 2a 20 70   is made to.** p
5b40: 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 65 72 72  oint to that err
5b50: 6f 72 20 69 66 20 70 7a 45 72 72 4d 73 67 20 69  or if pzErrMsg i
5b60: 73 20 6e 6f 74 20 4e 55 4c 4c 2e 20 20 54 68 65  s not NULL.  The
5b70: 20 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65   calling routine
5b80: 0a 2a 2a 20 73 68 6f 75 6c 64 20 75 73 65 20 73  .** should use s
5b90: 71 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28 29 20  qlite_freemem() 
5ba0: 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d 65  to delete the me
5bb0: 73 73 61 67 65 20 77 68 65 6e 20 69 74 20 68 61  ssage when it ha
5bc0: 73 20 66 69 6e 69 73 68 65 64 0a 2a 2a 20 77 69  s finished.** wi
5bd0: 74 68 20 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  th it..*/.int sq
5be0: 6c 69 74 65 5f 66 69 6e 61 6c 69 7a 65 28 0a 20  lite_finalize(. 
5bf0: 20 73 71 6c 69 74 65 5f 76 6d 20 2a 70 56 6d 2c   sqlite_vm *pVm,
5c00: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
5c10: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  he virtual machi
5c20: 6e 65 20 74 6f 20 62 65 20 64 65 73 74 72 6f 79  ne to be destroy
5c30: 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  ed */.  char **p
5c40: 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20 20  zErrMsg         
5c50: 20 20 20 2f 2a 20 4f 55 54 3a 20 57 72 69 74 65     /* OUT: Write
5c60: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20   error messages 
5c70: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  here */.){.  int
5c80: 20 72 63 20 3d 20 73 71 6c 69 74 65 56 64 62 65   rc = sqliteVdbe
5c90: 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a 29  Finalize((Vdbe*)
5ca0: 70 56 6d 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a  pVm, pzErrMsg);.
5cb0: 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c    sqliteStrReall
5cc0: 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20  oc(pzErrMsg);.  
5cd0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
5ce0: 0a 2a 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68  .** Terminate th
5cf0: 65 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 74  e current execut
5d00: 69 6f 6e 20 6f 66 20 61 20 76 69 72 74 75 61 6c  ion of a virtual
5d10: 20 6d 61 63 68 69 6e 65 20 74 68 65 6e 0a 2a 2a   machine then.**
5d20: 20 72 65 73 65 74 20 74 68 65 20 76 69 72 74 75   reset the virtu
5d30: 61 6c 20 6d 61 63 68 69 6e 65 20 62 61 63 6b 20  al machine back 
5d40: 74 6f 20 69 74 73 20 73 74 61 72 74 69 6e 67 20  to its starting 
5d50: 73 74 61 74 65 20 73 6f 20 74 68 61 74 20 69 74  state so that it
5d60: 0a 2a 2a 20 63 61 6e 20 62 65 20 72 65 75 73 65  .** can be reuse
5d70: 64 2e 20 20 41 6e 79 20 65 72 72 6f 72 20 6d 65  d.  Any error me
5d80: 73 73 61 67 65 20 72 65 73 75 6c 74 69 6e 67 20  ssage resulting 
5d90: 66 72 6f 6d 20 74 68 65 20 70 72 69 6f 72 20 65  from the prior e
5da0: 78 65 63 75 74 69 6f 6e 0a 2a 2a 20 69 73 20 77  xecution.** is w
5db0: 72 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 7a 45  ritten into *pzE
5dc0: 72 72 4d 73 67 2e 20 20 41 20 73 75 63 63 65 73  rrMsg.  A succes
5dd0: 73 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 65 20  s code from the 
5de0: 70 72 69 6f 72 20 65 78 65 63 75 74 69 6f 6e 0a  prior execution.
5df0: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  ** is returned..
5e00: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 72 65  */.int sqlite_re
5e10: 73 65 74 28 0a 20 20 73 71 6c 69 74 65 5f 76 6d  set(.  sqlite_vm
5e20: 20 2a 70 56 6d 2c 20 20 20 20 20 20 20 20 20 20   *pVm,          
5e30: 20 20 2f 2a 20 54 68 65 20 76 69 72 74 75 61 6c    /* The virtual
5e40: 20 6d 61 63 68 69 6e 65 20 74 6f 20 62 65 20 64   machine to be d
5e50: 65 73 74 72 6f 79 65 64 20 2a 2f 0a 20 20 63 68  estroyed */.  ch
5e60: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20  ar **pzErrMsg   
5e70: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
5e80: 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d 65 73   Write error mes
5e90: 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b  sages here */.){
5ea0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69  .  int rc = sqli
5eb0: 74 65 56 64 62 65 52 65 73 65 74 28 28 56 64 62  teVdbeReset((Vdb
5ec0: 65 2a 29 70 56 6d 2c 20 70 7a 45 72 72 4d 73 67  e*)pVm, pzErrMsg
5ed0: 29 3b 0a 20 20 73 71 6c 69 74 65 56 64 62 65 4d  );.  sqliteVdbeM
5ee0: 61 6b 65 52 65 61 64 79 28 28 56 64 62 65 2a 29  akeReady((Vdbe*)
5ef0: 70 56 6d 2c 20 2d 31 2c 20 30 29 3b 0a 20 20 73  pVm, -1, 0);.  s
5f00: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28  qliteStrRealloc(
5f10: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74  pzErrMsg);.  ret
5f20: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
5f30: 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 63   Return a static
5f40: 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73   string that des
5f50: 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20  cribes the kind 
5f60: 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69 66 69  of error specifi
5f70: 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67  ed in the.** arg
5f80: 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20  ument..*/.const 
5f90: 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 65 72 72  char *sqlite_err
5fa0: 6f 72 5f 73 74 72 69 6e 67 28 69 6e 74 20 72 63  or_string(int rc
5fb0: 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  ){.  const char 
5fc0: 2a 7a 3b 0a 20 20 73 77 69 74 63 68 28 20 72 63  *z;.  switch( rc
5fd0: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c   ){.    case SQL
5fe0: 49 54 45 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20  ITE_OK:         
5ff0: 7a 20 3d 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f  z = "not an erro
6000: 72 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  r";             
6010: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6020: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6030: 49 54 45 5f 45 52 52 4f 52 3a 20 20 20 20 20 20  ITE_ERROR:      
6040: 7a 20 3d 20 22 53 51 4c 20 6c 6f 67 69 63 20 65  z = "SQL logic e
6050: 72 72 6f 72 20 6f 72 20 6d 69 73 73 69 6e 67 20  rror or missing 
6060: 64 61 74 61 62 61 73 65 22 3b 20 20 20 62 72 65  database";   bre
6070: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6080: 49 54 45 5f 49 4e 54 45 52 4e 41 4c 3a 20 20 20  ITE_INTERNAL:   
6090: 7a 20 3d 20 22 69 6e 74 65 72 6e 61 6c 20 53 51  z = "internal SQ
60a0: 4c 69 74 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74  Lite implementat
60b0: 69 6f 6e 20 66 6c 61 77 22 3b 20 20 20 62 72 65  ion flaw";   bre
60c0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
60d0: 49 54 45 5f 50 45 52 4d 3a 20 20 20 20 20 20 20  ITE_PERM:       
60e0: 7a 20 3d 20 22 61 63 63 65 73 73 20 70 65 72 6d  z = "access perm
60f0: 69 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20  ission denied"; 
6100: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6110: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6120: 49 54 45 5f 41 42 4f 52 54 3a 20 20 20 20 20 20  ITE_ABORT:      
6130: 7a 20 3d 20 22 63 61 6c 6c 62 61 63 6b 20 72 65  z = "callback re
6140: 71 75 65 73 74 65 64 20 71 75 65 72 79 20 61 62  quested query ab
6150: 6f 72 74 22 3b 20 20 20 20 20 20 20 20 62 72 65  ort";        bre
6160: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6170: 49 54 45 5f 42 55 53 59 3a 20 20 20 20 20 20 20  ITE_BUSY:       
6180: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 69 73  z = "database is
6190: 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20   locked";       
61a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
61b0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
61c0: 49 54 45 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20  ITE_LOCKED:     
61d0: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 74 61  z = "database ta
61e0: 62 6c 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20  ble is locked"; 
61f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6200: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6210: 49 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20  ITE_NOMEM:      
6220: 7a 20 3d 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f  z = "out of memo
6230: 72 79 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ry";            
6240: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6250: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6260: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20  ITE_READONLY:   
6270: 7a 20 3d 20 22 61 74 74 65 6d 70 74 20 74 6f 20  z = "attempt to 
6280: 77 72 69 74 65 20 61 20 72 65 61 64 6f 6e 6c 79  write a readonly
6290: 20 64 61 74 61 62 61 73 65 22 3b 20 20 62 72 65   database";  bre
62a0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
62b0: 49 54 45 5f 49 4e 54 45 52 52 55 50 54 3a 20 20  ITE_INTERRUPT:  
62c0: 7a 20 3d 20 22 69 6e 74 65 72 72 75 70 74 65 64  z = "interrupted
62d0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
62e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
62f0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6300: 49 54 45 5f 49 4f 45 52 52 3a 20 20 20 20 20 20  ITE_IOERR:      
6310: 7a 20 3d 20 22 64 69 73 6b 20 49 2f 4f 20 65 72  z = "disk I/O er
6320: 72 6f 72 22 3b 20 20 20 20 20 20 20 20 20 20 20  ror";           
6330: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6340: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6350: 49 54 45 5f 43 4f 52 52 55 50 54 3a 20 20 20 20  ITE_CORRUPT:    
6360: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 64 69  z = "database di
6370: 73 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 6c 66  sk image is malf
6380: 6f 72 6d 65 64 22 3b 20 20 20 20 20 20 62 72 65  ormed";      bre
6390: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
63a0: 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20  ITE_NOTFOUND:   
63b0: 7a 20 3d 20 22 74 61 62 6c 65 20 6f 72 20 72 65  z = "table or re
63c0: 63 6f 72 64 20 6e 6f 74 20 66 6f 75 6e 64 22 3b  cord not found";
63d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
63e0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
63f0: 49 54 45 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20  ITE_FULL:       
6400: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 69 73  z = "database is
6410: 20 66 75 6c 6c 22 3b 20 20 20 20 20 20 20 20 20   full";         
6420: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6430: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6440: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20  ITE_CANTOPEN:   
6450: 7a 20 3d 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f  z = "unable to o
6460: 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c  pen database fil
6470: 65 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65  e";          bre
6480: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6490: 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20  ITE_PROTOCOL:   
64a0: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 6c 6f  z = "database lo
64b0: 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 20 66  cking protocol f
64c0: 61 69 6c 75 72 65 22 3b 20 20 20 20 20 62 72 65  ailure";     bre
64d0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
64e0: 49 54 45 5f 45 4d 50 54 59 3a 20 20 20 20 20 20  ITE_EMPTY:      
64f0: 7a 20 3d 20 22 74 61 62 6c 65 20 63 6f 6e 74 61  z = "table conta
6500: 69 6e 73 20 6e 6f 20 64 61 74 61 22 3b 20 20 20  ins no data";   
6510: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6520: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6530: 49 54 45 5f 53 43 48 45 4d 41 3a 20 20 20 20 20  ITE_SCHEMA:     
6540: 7a 20 3d 20 22 64 61 74 61 62 61 73 65 20 73 63  z = "database sc
6550: 68 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 64  hema has changed
6560: 22 3b 20 20 20 20 20 20 20 20 20 20 20 62 72 65  ";           bre
6570: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6580: 49 54 45 5f 54 4f 4f 42 49 47 3a 20 20 20 20 20  ITE_TOOBIG:     
6590: 7a 20 3d 20 22 74 6f 6f 20 6d 75 63 68 20 64 61  z = "too much da
65a0: 74 61 20 66 6f 72 20 6f 6e 65 20 74 61 62 6c 65  ta for one table
65b0: 20 72 6f 77 22 3b 20 20 20 20 20 20 20 62 72 65   row";       bre
65c0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
65d0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3a 20  ITE_CONSTRAINT: 
65e0: 7a 20 3d 20 22 63 6f 6e 73 74 72 61 69 6e 74 20  z = "constraint 
65f0: 66 61 69 6c 65 64 22 3b 20 20 20 20 20 20 20 20  failed";        
6600: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6610: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6620: 49 54 45 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20  ITE_MISMATCH:   
6630: 7a 20 3d 20 22 64 61 74 61 74 79 70 65 20 6d 69  z = "datatype mi
6640: 73 6d 61 74 63 68 22 3b 20 20 20 20 20 20 20 20  smatch";        
6650: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6660: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6670: 49 54 45 5f 4d 49 53 55 53 45 3a 20 20 20 20 20  ITE_MISUSE:     
6680: 7a 20 3d 20 22 6c 69 62 72 61 72 79 20 72 6f 75  z = "library rou
6690: 74 69 6e 65 20 63 61 6c 6c 65 64 20 6f 75 74 20  tine called out 
66a0: 6f 66 20 73 65 71 75 65 6e 63 65 22 3b 62 72 65  of sequence";bre
66b0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
66c0: 49 54 45 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 20  ITE_NOLFS:      
66d0: 7a 20 3d 20 22 6b 65 72 6e 65 6c 20 6c 61 63 6b  z = "kernel lack
66e0: 73 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70  s large file sup
66f0: 70 6f 72 74 22 3b 20 20 20 20 20 20 20 62 72 65  port";       bre
6700: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6710: 49 54 45 5f 41 55 54 48 3a 20 20 20 20 20 20 20  ITE_AUTH:       
6720: 7a 20 3d 20 22 61 75 74 68 6f 72 69 7a 61 74 69  z = "authorizati
6730: 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20 20  on denied";     
6740: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6750: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6760: 49 54 45 5f 46 4f 52 4d 41 54 3a 20 20 20 20 20  ITE_FORMAT:     
6770: 7a 20 3d 20 22 61 75 78 69 6c 69 61 72 79 20 64  z = "auxiliary d
6780: 61 74 61 62 61 73 65 20 66 6f 72 6d 61 74 20 65  atabase format e
6790: 72 72 6f 72 22 3b 20 20 20 20 20 20 20 62 72 65  rror";       bre
67a0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
67b0: 49 54 45 5f 52 41 4e 47 45 3a 20 20 20 20 20 20  ITE_RANGE:      
67c0: 7a 20 3d 20 22 62 69 6e 64 20 69 6e 64 65 78 20  z = "bind index 
67d0: 6f 75 74 20 6f 66 20 72 61 6e 67 65 22 3b 20 20  out of range";  
67e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
67f0: 61 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c  ak;.    case SQL
6800: 49 54 45 5f 4e 4f 54 41 44 42 3a 20 20 20 20 20  ITE_NOTADB:     
6810: 7a 20 3d 20 22 66 69 6c 65 20 69 73 20 65 6e 63  z = "file is enc
6820: 72 79 70 74 65 64 20 6f 72 20 69 73 20 6e 6f 74  rypted or is not
6830: 20 61 20 64 61 74 61 62 61 73 65 22 3b 62 72 65   a database";bre
6840: 61 6b 3b 0a 20 20 20 20 64 65 66 61 75 6c 74 3a  ak;.    default:
6850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6860: 7a 20 3d 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72  z = "unknown err
6870: 6f 72 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  or";            
6880: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
6890: 61 6b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  ak;.  }.  return
68a0: 20 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69   z;.}../*.** Thi
68b0: 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d  s routine implem
68c0: 65 6e 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c  ents a busy call
68d0: 62 61 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73  back that sleeps
68e0: 20 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67   and tries.** ag
68f0: 61 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65  ain until a time
6900: 6f 75 74 20 76 61 6c 75 65 20 69 73 20 72 65 61  out value is rea
6910: 63 68 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f  ched.  The timeo
6920: 75 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61  ut value is.** a
6930: 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72  n integer number
6940: 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73   of milliseconds
6950: 20 70 61 73 73 65 64 20 69 6e 20 61 73 20 74 68   passed in as th
6960: 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d  e first.** argum
6970: 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ent..*/.static i
6980: 6e 74 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74  nt sqliteDefault
6990: 42 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76  BusyCallback(. v
69a0: 6f 69 64 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20  oid *Timeout,   
69b0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d          /* Maxim
69c0: 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d  um amount of tim
69d0: 65 20 74 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f  e to wait */. co
69e0: 6e 73 74 20 63 68 61 72 20 2a 4e 6f 74 55 73 65  nst char *NotUse
69f0: 64 2c 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61  d,     /* The na
6a00: 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  me of the table 
6a10: 74 68 61 74 20 69 73 20 62 75 73 79 20 2a 2f 0a  that is busy */.
6a20: 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20   int count      
6a30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
6a40: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62  ber of times tab
6a50: 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79  le has been busy
6a60: 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54   */.){.#if SQLIT
6a70: 45 5f 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d  E_MIN_SLEEP_MS==
6a80: 31 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  1.  static const
6a90: 20 63 68 61 72 20 64 65 6c 61 79 73 5b 5d 20 3d   char delays[] =
6aa0: 0a 20 20 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c  .     { 1, 2, 5,
6ab0: 20 31 30 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c   10, 15, 20, 25,
6ac0: 20 32 35 2c 20 20 32 35 2c 20 20 35 30 2c 20 20   25,  25,  50,  
6ad0: 35 30 2c 20 20 35 30 2c 20 31 30 30 7d 3b 0a 20  50,  50, 100};. 
6ae0: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 68   static const sh
6af0: 6f 72 74 20 69 6e 74 20 74 6f 74 61 6c 73 5b 5d  ort int totals[]
6b00: 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20   =.     { 0, 1, 
6b10: 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35  3,  8, 18, 33, 5
6b20: 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c  3, 78, 103, 128,
6b30: 20 31 37 38 2c 20 32 32 38 2c 20 32 38 37 7d 3b   178, 228, 287};
6b40: 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59  .# define NDELAY
6b50: 20 28 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 29   (sizeof(delays)
6b60: 2f 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30  /sizeof(delays[0
6b70: 5d 29 29 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75  ])).  int timeou
6b80: 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75 74  t = (int)Timeout
6b90: 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 70  ;.  int delay, p
6ba0: 72 69 6f 72 3b 0a 0a 20 20 69 66 28 20 63 6f 75  rior;..  if( cou
6bb0: 6e 74 20 3c 3d 20 4e 44 45 4c 41 59 20 29 7b 0a  nt <= NDELAY ){.
6bc0: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61      delay = dela
6bd0: 79 73 5b 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20 20  ys[count-1];.   
6be0: 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b   prior = totals[
6bf0: 63 6f 75 6e 74 2d 31 5d 3b 0a 20 20 7d 65 6c 73  count-1];.  }els
6c00: 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64  e{.    delay = d
6c10: 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b  elays[NDELAY-1];
6c20: 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74  .    prior = tot
6c30: 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20  als[NDELAY-1] + 
6c40: 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 4e 44 45  delay*(count-NDE
6c50: 4c 41 59 2d 31 29 3b 0a 20 20 7d 0a 20 20 69 66  LAY-1);.  }.  if
6c60: 28 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 20  ( prior + delay 
6c70: 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20  > timeout ){.   
6c80: 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74   delay = timeout
6c90: 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 66   - prior;.    if
6ca0: 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74  ( delay<=0 ) ret
6cb0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c  urn 0;.  }.  sql
6cc0: 69 74 65 4f 73 53 6c 65 65 70 28 64 65 6c 61 79  iteOsSleep(delay
6cd0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23  );.  return 1;.#
6ce0: 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d 65 6f  else.  int timeo
6cf0: 75 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f 75  ut = (int)Timeou
6d00: 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e 74 2b  t;.  if( (count+
6d10: 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f 75  1)*1000 > timeou
6d20: 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  t ){.    return 
6d30: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f  0;.  }.  sqliteO
6d40: 73 53 6c 65 65 70 28 31 30 30 30 29 3b 0a 20 20  sSleep(1000);.  
6d50: 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66  return 1;.#endif
6d60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
6d70: 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20  outine sets the 
6d80: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 6f  busy callback fo
6d90: 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61  r an Sqlite data
6da0: 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67  base to the.** g
6db0: 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75  iven callback fu
6dc0: 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20  nction with the 
6dd0: 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 0a  given argument..
6de0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62  */.void sqlite_b
6df0: 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73  usy_handler(.  s
6e00: 71 6c 69 74 65 20 2a 64 62 2c 0a 20 20 69 6e 74  qlite *db,.  int
6e10: 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 2a 2c   (*xBusy)(void*,
6e20: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29  const char*,int)
6e30: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29  ,.  void *pArg.)
6e40: 7b 0a 20 20 64 62 2d 3e 78 42 75 73 79 43 61 6c  {.  db->xBusyCal
6e50: 6c 62 61 63 6b 20 3d 20 78 42 75 73 79 3b 0a 20  lback = xBusy;. 
6e60: 20 64 62 2d 3e 70 42 75 73 79 41 72 67 20 3d 20   db->pBusyArg = 
6e70: 70 41 72 67 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66  pArg;.}..#ifndef
6e80: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f   SQLITE_OMIT_PRO
6e90: 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f  GRESS_CALLBACK./
6ea0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
6eb0: 65 20 73 65 74 73 20 74 68 65 20 70 72 6f 67 72  e sets the progr
6ec0: 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72  ess callback for
6ed0: 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62   an Sqlite datab
6ee0: 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69  ase to the.** gi
6ef0: 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e  ven callback fun
6f00: 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67  ction with the g
6f10: 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54  iven argument. T
6f20: 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c  he progress call
6f30: 62 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20  back will.** be 
6f40: 69 6e 76 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f  invoked every nO
6f50: 70 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76  ps opcodes..*/.v
6f60: 6f 69 64 20 73 71 6c 69 74 65 5f 70 72 6f 67 72  oid sqlite_progr
6f70: 65 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73  ess_handler(.  s
6f80: 71 6c 69 74 65 20 2a 64 62 2c 20 0a 20 20 69 6e  qlite *db, .  in
6f90: 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a  t nOps,.  int (*
6fa0: 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69 64 2a  xProgress)(void*
6fb0: 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 67  ), .  void *pArg
6fc0: 0a 29 7b 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30  .){.  if( nOps>0
6fd0: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f   ){.    db->xPro
6fe0: 67 72 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73  gress = xProgres
6ff0: 73 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67  s;.    db->nProg
7000: 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a  ressOps = nOps;.
7010: 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73      db->pProgres
7020: 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d  sArg = pArg;.  }
7030: 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50  else{.    db->xP
7040: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20  rogress = 0;.   
7050: 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70   db->nProgressOp
7060: 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70  s = 0;.    db->p
7070: 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b  ProgressArg = 0;
7080: 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a  .  }.}.#endif...
7090: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
70a0: 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65  ne installs a de
70b0: 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c  fault busy handl
70c0: 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f  er that waits fo
70d0: 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69  r the.** specifi
70e0: 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c  ed number of mil
70f0: 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65  liseconds before
7100: 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f   returning 0..*/
7110: 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73  .void sqlite_bus
7120: 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65  y_timeout(sqlite
7130: 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20   *db, int ms){. 
7140: 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20   if( ms>0 ){.   
7150: 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e   sqlite_busy_han
7160: 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44  dler(db, sqliteD
7170: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61  efaultBusyCallba
7180: 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a  ck, (void*)ms);.
7190: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
71a0: 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72  ite_busy_handler
71b0: 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a  (db, 0, 0);.  }.
71c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61  }../*.** Cause a
71d0: 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61  ny pending opera
71e0: 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20  tion to stop at 
71f0: 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70  its earliest opp
7200: 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69  ortunity..*/.voi
7210: 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 72 75  d sqlite_interru
7220: 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a  pt(sqlite *db){.
7230: 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53    db->flags |= S
7240: 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b  QLITE_Interrupt;
7250: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77  .}../*.** Window
7260: 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c 64  s systems should
7270: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69   call this routi
7280: 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72  ne to free memor
7290: 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65 74  y that.** is ret
72a0: 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e 20  urned in the in 
72b0: 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61 6d  the errmsg param
72c0: 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 5f 6f  eter of sqlite_o
72d0: 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51  pen() when.** SQ
72e0: 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e 20 20  Lite is a DLL.  
72f0: 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c  For some reason,
7300: 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72   it does not wor
7310: 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 29  k to call free()
7320: 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a  .** directly..**
7330: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 77 65  .** Note that we
7340: 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 66 72   need to call fr
7350: 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74 65 46  ee() not sqliteF
7360: 72 65 65 28 29 20 68 65 72 65 2c 20 73 69 6e 63  ree() here, sinc
7370: 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72 69 6e  e every.** strin
7380: 67 20 74 68 61 74 20 69 73 20 65 78 70 6f 72 74  g that is export
7390: 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 20 73  ed from SQLite s
73a0: 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61  hould have alrea
73b0: 64 79 20 70 61 73 73 65 64 20 74 68 72 6f 75 67  dy passed throug
73c0: 68 0a 2a 2a 20 73 71 6c 69 74 65 53 74 72 52 65  h.** sqliteStrRe
73d0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64  alloc()..*/.void
73e0: 20 73 71 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28   sqlite_freemem(
73f0: 76 6f 69 64 20 2a 70 29 7b 20 66 72 65 65 28 70  void *p){ free(p
7400: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64  ); }../*.** Wind
7410: 6f 77 73 20 73 79 73 74 65 6d 73 20 6e 65 65 64  ows systems need
7420: 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 63 61   functions to ca
7430: 6c 6c 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65  ll to return the
7440: 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 0a   sqlite_version.
7450: 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 5f 65 6e  ** and sqlite_en
7460: 63 6f 64 69 6e 67 20 73 74 72 69 6e 67 73 20 73  coding strings s
7470: 69 6e 63 65 20 74 68 65 79 20 61 72 65 20 75 6e  ince they are un
7480: 61 62 6c 65 20 74 6f 20 61 63 63 65 73 73 20 63  able to access c
7490: 6f 6e 73 74 61 6e 74 73 0a 2a 2a 20 77 69 74 68  onstants.** with
74a0: 69 6e 20 44 4c 4c 73 2e 0a 2a 2f 0a 63 6f 6e 73  in DLLs..*/.cons
74b0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c  t char *sqlite_l
74c0: 69 62 76 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b  ibversion(void){
74d0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 76   return sqlite_v
74e0: 65 72 73 69 6f 6e 3b 20 7d 0a 63 6f 6e 73 74 20  ersion; }.const 
74f0: 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c 69 62  char *sqlite_lib
7500: 65 6e 63 6f 64 69 6e 67 28 76 6f 69 64 29 7b 20  encoding(void){ 
7510: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 65 6e  return sqlite_en
7520: 63 6f 64 69 6e 67 3b 20 7d 0a 0a 2f 2a 0a 2a 2a  coding; }../*.**
7530: 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72   Create new user
7540: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
7550: 6e 73 2e 20 20 54 68 65 20 73 71 6c 69 74 65 5f  ns.  The sqlite_
7560: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
7570: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 63 72 65  ).** routine cre
7580: 61 74 65 73 20 61 20 72 65 67 75 6c 61 72 20 66  ates a regular f
7590: 75 6e 63 74 69 6f 6e 20 61 6e 64 20 73 71 6c 69  unction and sqli
75a0: 74 65 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67  te_create_aggreg
75b0: 61 74 65 28 29 0a 2a 2a 20 63 72 65 61 74 65 73  ate().** creates
75c0: 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75   an aggregate fu
75d0: 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61  nction..**.** Pa
75e0: 73 73 69 6e 67 20 61 20 4e 55 4c 4c 20 78 46 75  ssing a NULL xFu
75f0: 6e 63 20 61 72 67 75 6d 65 6e 74 20 6f 72 20 4e  nc argument or N
7600: 55 4c 4c 20 78 53 74 65 70 20 61 6e 64 20 78 46  ULL xStep and xF
7610: 69 6e 61 6c 69 7a 65 20 61 72 67 75 6d 65 6e 74  inalize argument
7620: 73 0a 2a 2a 20 64 69 73 61 62 6c 65 73 20 74 68  s.** disables th
7630: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 43 61 6c  e function.  Cal
7640: 6c 69 6e 67 20 73 71 6c 69 74 65 5f 63 72 65 61  ling sqlite_crea
7650: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 20 77 69  te_function() wi
7660: 74 68 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 6e  th the.** same n
7670: 61 6d 65 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f  ame and number o
7680: 66 20 61 72 67 75 6d 65 6e 74 73 20 61 73 20 61  f arguments as a
7690: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a   prior call to.*
76a0: 2a 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  * sqlite_create_
76b0: 61 67 67 72 65 67 61 74 65 28 29 20 64 69 73 61  aggregate() disa
76c0: 62 6c 65 73 20 74 68 65 20 70 72 69 6f 72 20 63  bles the prior c
76d0: 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65  all to.** sqlite
76e0: 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74  _create_aggregat
76f0: 65 28 29 2c 20 61 6e 64 20 76 69 63 65 20 76 65  e(), and vice ve
7700: 72 73 61 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 41  rsa..**.** If nA
7710: 72 67 20 69 73 20 2d 31 20 69 74 20 6d 65 61 6e  rg is -1 it mean
7720: 73 20 74 68 61 74 20 74 68 69 73 20 66 75 6e 63  s that this func
7730: 74 69 6f 6e 20 77 69 6c 6c 20 61 63 63 65 70 74  tion will accept
7740: 20 61 6e 79 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f   any number.** o
7750: 66 20 61 72 67 75 6d 65 6e 74 73 2c 20 69 6e 63  f arguments, inc
7760: 6c 75 64 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74  luding 0..*/.int
7770: 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66   sqlite_create_f
7780: 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74  unction(.  sqlit
7790: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
77a0: 2f 2a 20 41 64 64 20 74 68 65 20 66 75 6e 63 74  /* Add the funct
77b0: 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61  ion to this data
77c0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
77d0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
77e0: 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d  *zName,   /* Nam
77f0: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f  e of the functio
7800: 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e  n to add */.  in
7810: 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20  t nArg,         
7820: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
7830: 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76  arguments */.  v
7840: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c  oid (*xFunc)(sql
7850: 69 74 65 5f 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f  ite_func*,int,co
7860: 6e 73 74 20 63 68 61 72 2a 2a 29 2c 20 20 2f 2a  nst char**),  /*
7870: 20 54 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   The implementat
7880: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  ion */.  void *p
7890: 55 73 65 72 44 61 74 61 20 20 20 20 20 20 2f 2a  UserData      /*
78a0: 20 55 73 65 72 20 64 61 74 61 20 2a 2f 0a 29 7b   User data */.){
78b0: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b 0a 20  .  FuncDef *p;. 
78c0: 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20 69 66   int nName;.  if
78d0: 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61 6d 65  ( db==0 || zName
78e0: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 53 61 66  ==0 || sqliteSaf
78f0: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 20 72  etyCheck(db) ) r
7900: 65 74 75 72 6e 20 31 3b 0a 20 20 6e 4e 61 6d 65  eturn 1;.  nName
7910: 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29   = strlen(zName)
7920: 3b 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e 32 35  ;.  if( nName>25
7930: 35 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20  5 ) return 1;.  
7940: 70 20 3d 20 73 71 6c 69 74 65 46 69 6e 64 46 75  p = sqliteFindFu
7950: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65  nction(db, zName
7960: 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 31  , nName, nArg, 1
7970: 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  );.  if( p==0 ) 
7980: 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78  return 1;.  p->x
7990: 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20  Func = xFunc;.  
79a0: 70 2d 3e 78 53 74 65 70 20 3d 20 30 3b 0a 20 20  p->xStep = 0;.  
79b0: 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 30  p->xFinalize = 0
79c0: 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61  ;.  p->pUserData
79d0: 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20   = pUserData;.  
79e0: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 69 6e 74 20  return 0;.}.int 
79f0: 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 61 67  sqlite_create_ag
7a00: 67 72 65 67 61 74 65 28 0a 20 20 73 71 6c 69 74  gregate(.  sqlit
7a10: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
7a20: 2f 2a 20 41 64 64 20 74 68 65 20 66 75 6e 63 74  /* Add the funct
7a30: 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61  ion to this data
7a40: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
7a50: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
7a60: 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d  *zName,   /* Nam
7a70: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f  e of the functio
7a80: 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e  n to add */.  in
7a90: 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20  t nArg,         
7aa0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
7ab0: 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76  arguments */.  v
7ac0: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c  oid (*xStep)(sql
7ad0: 69 74 65 5f 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f  ite_func*,int,co
7ae0: 6e 73 74 20 63 68 61 72 2a 2a 29 2c 20 2f 2a 20  nst char**), /* 
7af0: 54 68 65 20 73 74 65 70 20 66 75 6e 63 74 69 6f  The step functio
7b00: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46  n */.  void (*xF
7b10: 69 6e 61 6c 69 7a 65 29 28 73 71 6c 69 74 65 5f  inalize)(sqlite_
7b20: 66 75 6e 63 2a 29 2c 20 20 20 20 20 20 20 20 20  func*),         
7b30: 20 20 20 20 20 2f 2a 20 54 68 65 20 66 69 6e 61       /* The fina
7b40: 6c 69 7a 65 72 20 2a 2f 0a 20 20 76 6f 69 64 20  lizer */.  void 
7b50: 2a 70 55 73 65 72 44 61 74 61 20 20 20 20 20 20  *pUserData      
7b60: 2f 2a 20 55 73 65 72 20 64 61 74 61 20 2a 2f 0a  /* User data */.
7b70: 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b  ){.  FuncDef *p;
7b80: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20  .  int nName;.  
7b90: 69 66 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61  if( db==0 || zNa
7ba0: 6d 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 53  me==0 || sqliteS
7bb0: 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29  afetyCheck(db) )
7bc0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 6e 4e 61   return 1;.  nNa
7bd0: 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d  me = strlen(zNam
7be0: 65 29 3b 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e  e);.  if( nName>
7bf0: 32 35 35 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  255 ) return 1;.
7c00: 20 20 70 20 3d 20 73 71 6c 69 74 65 46 69 6e 64    p = sqliteFind
7c10: 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61  Function(db, zNa
7c20: 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c  me, nName, nArg,
7c30: 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20   1);.  if( p==0 
7c40: 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d  ) return 1;.  p-
7c50: 3e 78 46 75 6e 63 20 3d 20 30 3b 0a 20 20 70 2d  >xFunc = 0;.  p-
7c60: 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a  >xStep = xStep;.
7c70: 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d    p->xFinalize =
7c80: 20 78 46 69 6e 61 6c 69 7a 65 3b 0a 20 20 70 2d   xFinalize;.  p-
7c90: 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 55 73  >pUserData = pUs
7ca0: 65 72 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e  erData;.  return
7cb0: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61   0;.}../*.** Cha
7cc0: 6e 67 65 20 74 68 65 20 64 61 74 61 74 79 70 65  nge the datatype
7cd0: 20 66 6f 72 20 61 6c 6c 20 66 75 6e 63 74 69 6f   for all functio
7ce0: 6e 73 20 77 69 74 68 20 61 20 67 69 76 65 6e 20  ns with a given 
7cf0: 6e 61 6d 65 2e 20 20 53 65 65 20 74 68 65 0a 2a  name.  See the.*
7d00: 2a 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74  * header comment
7d10: 20 66 6f 72 20 74 68 65 20 70 72 6f 74 6f 74 79   for the prototy
7d20: 70 65 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74  pe of this funct
7d30: 69 6f 6e 20 69 6e 20 73 71 6c 69 74 65 2e 68 20  ion in sqlite.h 
7d40: 66 6f 72 0a 2a 2a 20 61 64 64 69 74 69 6f 6e 61  for.** additiona
7d50: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a  l information..*
7d60: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 66 75 6e  /.int sqlite_fun
7d70: 63 74 69 6f 6e 5f 74 79 70 65 28 73 71 6c 69 74  ction_type(sqlit
7d80: 65 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61  e *db, const cha
7d90: 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20 64 61  r *zName, int da
7da0: 74 61 54 79 70 65 29 7b 0a 20 20 46 75 6e 63 44  taType){.  FuncD
7db0: 65 66 20 2a 70 20 3d 20 28 46 75 6e 63 44 65 66  ef *p = (FuncDef
7dc0: 2a 29 73 71 6c 69 74 65 48 61 73 68 46 69 6e 64  *)sqliteHashFind
7dd0: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 7a 4e 61  (&db->aFunc, zNa
7de0: 6d 65 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65  me, strlen(zName
7df0: 29 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 20 29  ));.  while( p )
7e00: 7b 0a 20 20 20 20 70 2d 3e 64 61 74 61 54 79 70  {.    p->dataTyp
7e10: 65 20 3d 20 64 61 74 61 54 79 70 65 3b 20 0a 20  e = dataType; . 
7e20: 20 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b     p = p->pNext;
7e30: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51  .  }.  return SQ
7e40: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
7e50: 2a 20 52 65 67 69 73 74 65 72 20 61 20 74 72 61  * Register a tra
7e60: 63 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68  ce function.  Th
7e70: 65 20 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20  e pArg from the 
7e80: 70 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73  previously regis
7e90: 74 65 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69  tered trace.** i
7ea0: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a  s returned.  .**
7eb0: 0a 2a 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65  .** A NULL trace
7ec0: 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20   function means 
7ed0: 74 68 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20  that no tracing 
7ee0: 69 73 20 65 78 65 63 75 74 65 73 2e 20 20 41 20  is executes.  A 
7ef0: 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63  non-NULL.** trac
7f00: 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74  e is a pointer t
7f10: 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61  o a function tha
7f20: 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20  t is invoked at 
7f30: 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 61 63  the start of eac
7f40: 68 0a 2a 2a 20 73 71 6c 69 74 65 5f 65 78 65 63  h.** sqlite_exec
7f50: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  ()..*/.void *sql
7f60: 69 74 65 5f 74 72 61 63 65 28 73 71 6c 69 74 65  ite_trace(sqlite
7f70: 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72   *db, void (*xTr
7f80: 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74  ace)(void*,const
7f90: 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70   char*), void *p
7fa0: 41 72 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f  Arg){.  void *pO
7fb0: 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 41  ld = db->pTraceA
7fc0: 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 65  rg;.  db->xTrace
7fd0: 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64 62 2d   = xTrace;.  db-
7fe0: 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70 41 72  >pTraceArg = pAr
7ff0: 67 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64  g;.  return pOld
8000: 3b 0a 7d 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 49  ;.}../*** EXPERI
8010: 4d 45 4e 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a 2a  MENTAL ***.**.**
8020: 20 52 65 67 69 73 74 65 72 20 61 20 66 75 6e 63   Register a func
8030: 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b  tion to be invok
8040: 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61  ed when a transa
8050: 63 74 69 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a  ction comments..
8060: 2a 2a 20 49 66 20 65 69 74 68 65 72 20 66 75 6e  ** If either fun
8070: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f  ction returns no
8080: 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65  n-zero, then the
8090: 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20   commit becomes 
80a0: 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a  a.** rollback..*
80b0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 5f 63  /.void *sqlite_c
80c0: 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 71  ommit_hook(.  sq
80d0: 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20  lite *db,       
80e0: 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63          /* Attac
80f0: 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68  h the hook to th
8100: 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20  is database */. 
8110: 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63 6b   int (*xCallback
8120: 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 75  )(void*),  /* Fu
8130: 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65  nction to invoke
8140: 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74 20   on each commit 
8150: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20  */.  void *pArg 
8160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
8170: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68  * Argument to th
8180: 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b  e function */.){
8190: 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20  .  void *pOld = 
81a0: 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a  db->pCommitArg;.
81b0: 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c    db->xCommitCal
81c0: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63  lback = xCallbac
81d0: 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74  k;.  db->pCommit
81e0: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72 65  Arg = pArg;.  re
81f0: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 0a 2f  turn pOld;.}.../
8200: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
8210: 65 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 63  e is called to c
8220: 72 65 61 74 65 20 61 20 63 6f 6e 6e 65 63 74 69  reate a connecti
8230: 6f 6e 20 74 6f 20 61 20 64 61 74 61 62 61 73 65  on to a database
8240: 20 42 54 72 65 65 0a 2a 2a 20 64 72 69 76 65 72   BTree.** driver
8250: 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20  .  If zFilename 
8260: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61  is the name of a
8270: 20 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 61 74   file, then that
8280: 20 66 69 6c 65 20 69 73 0a 2a 2a 20 6f 70 65 6e   file is.** open
8290: 65 64 20 61 6e 64 20 75 73 65 64 2e 20 20 49 66  ed and used.  If
82a0: 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68   zFilename is th
82b0: 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d  e magic name ":m
82c0: 65 6d 6f 72 79 3a 22 20 74 68 65 6e 0a 2a 2a 20  emory:" then.** 
82d0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
82e0: 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79  stored in memory
82f0: 20 28 61 6e 64 20 69 73 20 74 68 75 73 20 66 6f   (and is thus fo
8300: 72 67 6f 74 74 65 6e 20 61 73 20 73 6f 6f 6e 20  rgotten as soon 
8310: 61 73 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63  as.** the connec
8320: 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 29  tion is closed.)
8330: 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69    If zFilename i
8340: 73 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 20  s NULL then the 
8350: 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20 66  database.** is f
8360: 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 75 73 65  or temporary use
8370: 20 6f 6e 6c 79 20 61 6e 64 20 69 73 20 64 65 6c   only and is del
8380: 65 74 65 64 20 61 73 20 73 6f 6f 6e 20 61 73 20  eted as soon as 
8390: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a  the connection.*
83a0: 2a 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a  * is closed..**.
83b0: 2a 2a 20 41 20 74 65 6d 70 6f 72 61 72 79 20 64  ** A temporary d
83c0: 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 20 65  atabase can be e
83d0: 69 74 68 65 72 20 61 20 64 69 73 6b 20 66 69 6c  ither a disk fil
83e0: 65 20 28 74 68 61 74 20 69 73 20 61 75 74 6f 6d  e (that is autom
83f0: 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 64 65 6c 65  atically.** dele
8400: 74 65 64 20 77 68 65 6e 20 74 68 65 20 66 69 6c  ted when the fil
8410: 65 20 69 73 20 63 6c 6f 73 65 64 29 20 6f 72 20  e is closed) or 
8420: 61 20 73 65 74 20 6f 66 20 72 65 64 2d 62 6c 61  a set of red-bla
8430: 63 6b 20 74 72 65 65 73 20 68 65 6c 64 20 69 6e  ck trees held in
8440: 20 6d 65 6d 6f 72 79 2c 0a 2a 2a 20 64 65 70 65   memory,.** depe
8450: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c  nding on the val
8460: 75 65 73 20 6f 66 20 74 68 65 20 54 45 4d 50 5f  ues of the TEMP_
8470: 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65 2d 74 69  STORE compile-ti
8480: 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20 74 68 65  me macro and the
8490: 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f  .** db->temp_sto
84a0: 72 65 20 76 61 72 69 61 62 6c 65 2c 20 61 63 63  re variable, acc
84b0: 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 66 6f  ording to the fo
84c0: 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 3a 0a 2a  llowing chart:.*
84d0: 2a 0a 2a 2a 20 20 20 20 20 20 20 54 45 4d 50 5f  *.**       TEMP_
84e0: 53 54 4f 52 45 20 20 20 20 20 64 62 2d 3e 74 65  STORE     db->te
84f0: 6d 70 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f 63  mp_store     Loc
8500: 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61  ation of tempora
8510: 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20  ry database.**  
8520: 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20       ---------- 
8530: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
8540: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  --     ---------
8550: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8560: 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 20 20  -----.**        
8570: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
8580: 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20     any          
8590: 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20     file.**      
85a0: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20       1          
85b0: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20        1         
85c0: 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 20 20       file.**    
85d0: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20         1        
85e0: 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20          2       
85f0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a         memory.**
8600: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20             1    
8610: 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20              0   
8620: 20 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a             file.
8630: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32 20 20  **           2  
8640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 20                1 
8650: 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c               fil
8660: 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 32  e.**           2
8670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8680: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d  2              m
8690: 65 6d 6f 72 79 0a 2a 2a 20 20 20 20 20 20 20 20  emory.**        
86a0: 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20     2            
86b0: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20      0           
86c0: 20 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 20     memory.**    
86d0: 20 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20         3        
86e0: 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20         any      
86f0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2f         memory.*/
8700: 0a 69 6e 74 20 73 71 6c 69 74 65 42 74 72 65 65  .int sqliteBtree
8710: 46 61 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 74  Factory(.  const
8720: 20 73 71 6c 69 74 65 20 2a 64 62 2c 09 20 20 20   sqlite *db,.   
8730: 20 2f 2a 20 4d 61 69 6e 20 64 61 74 61 62 61 73   /* Main databas
8740: 65 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 61  e when opening a
8750: 75 78 20 6f 74 68 65 72 77 69 73 65 20 30 20 2a  ux otherwise 0 *
8760: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
8770: 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a  zFilename,    /*
8780: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c   Name of the fil
8790: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65  e containing the
87a0: 20 42 54 72 65 65 20 64 61 74 61 62 61 73 65 20   BTree database 
87b0: 2a 2f 0a 20 20 69 6e 74 20 6f 6d 69 74 4a 6f 75  */.  int omitJou
87c0: 72 6e 61 6c 2c 20 20 20 20 20 20 20 20 20 20 2f  rnal,          /
87d0: 2a 20 69 66 20 54 52 55 45 20 74 68 65 6e 20 64  * if TRUE then d
87e0: 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 20 74 68  o not journal th
87f0: 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74  is file */.  int
8800: 20 6e 43 61 63 68 65 2c 20 20 20 20 20 20 20 20   nCache,        
8810: 20 20 20 20 20 20 20 2f 2a 20 48 6f 77 20 6d 61         /* How ma
8820: 6e 79 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  ny pages in the 
8830: 70 61 67 65 20 63 61 63 68 65 20 2a 2f 0a 20 20  page cache */.  
8840: 42 74 72 65 65 20 2a 2a 70 70 42 74 72 65 65 29  Btree **ppBtree)
8850: 7b 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69  {         /* Poi
8860: 6e 74 65 72 20 74 6f 20 6e 65 77 20 42 74 72 65  nter to new Btre
8870: 65 20 6f 62 6a 65 63 74 20 77 72 69 74 74 65 6e  e object written
8880: 20 68 65 72 65 20 2a 2f 0a 0a 20 20 61 73 73 65   here */..  asse
8890: 72 74 28 20 70 70 42 74 72 65 65 20 21 3d 20 30  rt( ppBtree != 0
88a0: 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  );..#ifndef SQLI
88b0: 54 45 5f 4f 4d 49 54 5f 49 4e 4d 45 4d 4f 52 59  TE_OMIT_INMEMORY
88c0: 44 42 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61  DB.  if( zFilena
88d0: 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 20  me==0 ){.    if 
88e0: 28 54 45 4d 50 5f 53 54 4f 52 45 20 3d 3d 20 30  (TEMP_STORE == 0
88f0: 29 20 7b 0a 20 20 20 20 20 20 2f 2a 20 41 6c 77  ) {.      /* Alw
8900: 61 79 73 20 75 73 65 20 66 69 6c 65 20 62 61 73  ays use file bas
8910: 65 64 20 74 65 6d 70 6f 72 61 72 79 20 44 42 20  ed temporary DB 
8920: 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  */.      return 
8930: 73 71 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28  sqliteBtreeOpen(
8940: 30 2c 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c 20  0, omitJournal, 
8950: 6e 43 61 63 68 65 2c 20 70 70 42 74 72 65 65 29  nCache, ppBtree)
8960: 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 69 66 20  ;.    } else if 
8970: 28 54 45 4d 50 5f 53 54 4f 52 45 20 3d 3d 20 31  (TEMP_STORE == 1
8980: 20 7c 7c 20 54 45 4d 50 5f 53 54 4f 52 45 20 3d   || TEMP_STORE =
8990: 3d 20 32 29 20 7b 0a 20 20 20 20 20 20 2f 2a 20  = 2) {.      /* 
89a0: 53 77 69 74 63 68 20 64 65 70 65 6e 64 69 6e 67  Switch depending
89b0: 20 6f 6e 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65   on compile-time
89c0: 20 61 6e 64 2f 6f 72 20 72 75 6e 74 69 6d 65 20   and/or runtime 
89d0: 73 65 74 74 69 6e 67 73 2e 20 2a 2f 0a 20 20 20  settings. */.   
89e0: 20 20 20 69 6e 74 20 6c 6f 63 61 74 69 6f 6e 20     int location 
89f0: 3d 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65  = db->temp_store
8a00: 3d 3d 30 20 3f 20 54 45 4d 50 5f 53 54 4f 52 45  ==0 ? TEMP_STORE
8a10: 20 3a 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72   : db->temp_stor
8a20: 65 3b 0a 0a 20 20 20 20 20 20 69 66 20 28 6c 6f  e;..      if (lo
8a30: 63 61 74 69 6f 6e 20 3d 3d 20 31 29 20 7b 0a 20  cation == 1) {. 
8a40: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 73 71         return sq
8a50: 6c 69 74 65 42 74 72 65 65 4f 70 65 6e 28 7a 46  liteBtreeOpen(zF
8a60: 69 6c 65 6e 61 6d 65 2c 20 6f 6d 69 74 4a 6f 75  ilename, omitJou
8a70: 72 6e 61 6c 2c 20 6e 43 61 63 68 65 2c 20 70 70  rnal, nCache, pp
8a80: 42 74 72 65 65 29 3b 0a 20 20 20 20 20 20 7d 20  Btree);.      } 
8a90: 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 72  else {.        r
8aa0: 65 74 75 72 6e 20 73 71 6c 69 74 65 52 62 74 72  eturn sqliteRbtr
8ab0: 65 65 4f 70 65 6e 28 30 2c 20 30 2c 20 30 2c 20  eeOpen(0, 0, 0, 
8ac0: 70 70 42 74 72 65 65 29 3b 0a 20 20 20 20 20 20  ppBtree);.      
8ad0: 7d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20  }.    } else {. 
8ae0: 20 20 20 20 20 2f 2a 20 41 6c 77 61 79 73 20 75       /* Always u
8af0: 73 65 20 69 6e 2d 63 6f 72 65 20 44 42 20 2a 2f  se in-core DB */
8b00: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 73 71  .      return sq
8b10: 6c 69 74 65 52 62 74 72 65 65 4f 70 65 6e 28 30  liteRbtreeOpen(0
8b20: 2c 20 30 2c 20 30 2c 20 70 70 42 74 72 65 65 29  , 0, 0, ppBtree)
8b30: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20  ;.    }.  }else 
8b40: 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d  if( zFilename[0]
8b50: 3d 3d 27 3a 27 20 26 26 20 73 74 72 63 6d 70 28  ==':' && strcmp(
8b60: 7a 46 69 6c 65 6e 61 6d 65 2c 22 3a 6d 65 6d 6f  zFilename,":memo
8b70: 72 79 3a 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20  ry:")==0 ){.    
8b80: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 52 62 74  return sqliteRbt
8b90: 72 65 65 4f 70 65 6e 28 30 2c 20 30 2c 20 30 2c  reeOpen(0, 0, 0,
8ba0: 20 70 70 42 74 72 65 65 29 3b 0a 20 20 7d 65 6c   ppBtree);.  }el
8bb0: 73 65 0a 23 65 6e 64 69 66 0a 20 20 7b 0a 20 20  se.#endif.  {.  
8bc0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 42    return sqliteB
8bd0: 74 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e 61  treeOpen(zFilena
8be0: 6d 65 2c 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c 2c  me, omitJournal,
8bf0: 20 6e 43 61 63 68 65 2c 20 70 70 42 74 72 65 65   nCache, ppBtree
8c00: 29 3b 0a 20 20 7d 0a 7d 0a                       );.  }.}.