/ Hex Artifact Content
Login

Artifact f88dfe09ed79588899cb4013836dd940f73a17fa:


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 31 33 20 32 30 30 33 2f 30 32  ,v 1.113 2003/02
0280: 2f 31 32 20 31 34 3a 30 39 3a 34 34 20 64 72 68  /12 14:09:44 drh
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 0a 2f 2a 0a   InitData;.../*.
03e0: 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 63  ** This is the c
03f0: 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20  allback routine 
0400: 66 6f 72 20 74 68 65 20 63 6f 64 65 20 74 68 61  for the code tha
0410: 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68  t initializes th
0420: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20  e.** database.  
0430: 53 65 65 20 73 71 6c 69 74 65 49 6e 69 74 28 29  See sqliteInit()
0440: 20 62 65 6c 6f 77 20 66 6f 72 20 61 64 64 69 74   below for addit
0450: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
0460: 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 61  n..**.** Each ca
0470: 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69 6e 73 20  llback contains 
0480: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e  the following in
0490: 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a  formation:.**.**
04a0: 20 20 20 20 20 61 72 67 76 5b 30 5d 20 3d 20 22       argv[0] = "
04b0: 66 69 6c 65 2d 66 6f 72 6d 61 74 22 20 6f 72 20  file-format" or 
04c0: 22 73 63 68 65 6d 61 2d 63 6f 6f 6b 69 65 22 20  "schema-cookie" 
04d0: 6f 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22 69  or "table" or "i
04e0: 6e 64 65 78 22 0a 2a 2a 20 20 20 20 20 61 72 67  ndex".**     arg
04f0: 76 5b 31 5d 20 3d 20 74 61 62 6c 65 20 6f 72 20  v[1] = table or 
0500: 69 6e 64 65 78 20 6e 61 6d 65 20 6f 72 20 6d 65  index name or me
0510: 74 61 20 73 74 61 74 65 6d 65 6e 74 20 74 79 70  ta statement typ
0520: 65 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 32  e..**     argv[2
0530: 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75  ] = root page nu
0540: 6d 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f  mber for table o
0550: 72 20 69 6e 64 65 78 2e 20 20 4e 55 4c 4c 20 66  r index.  NULL f
0560: 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 20 20 20 20  or meta..**     
0570: 61 72 67 76 5b 33 5d 20 3d 20 53 51 4c 20 74 65  argv[3] = SQL te
0580: 78 74 20 66 6f 72 20 61 20 43 52 45 41 54 45 20  xt for a CREATE 
0590: 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20  TABLE or CREATE 
05a0: 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74 2e  INDEX statement.
05b0: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 34 5d 20  .**     argv[4] 
05c0: 3d 20 22 31 22 20 66 6f 72 20 74 65 6d 70 6f 72  = "1" for tempor
05d0: 61 72 79 20 66 69 6c 65 73 2c 20 22 30 22 20 66  ary files, "0" f
05e0: 6f 72 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  or main database
05f0: 0a 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 0a 69 6e  .**.*/.static.in
0600: 74 20 73 71 6c 69 74 65 49 6e 69 74 43 61 6c 6c  t sqliteInitCall
0610: 62 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74  back(void *pInit
0620: 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 72  , int argc, char
0630: 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a   **argv, char **
0640: 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 49 6e  azColName){.  In
0650: 69 74 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20  itData *pData = 
0660: 28 49 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74  (InitData*)pInit
0670: 3b 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65  ;.  Parse sParse
0680: 3b 0a 20 20 69 6e 74 20 6e 45 72 72 20 3d 20 30  ;.  int nErr = 0
0690: 3b 0a 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 44 6f  ;..  /* TODO: Do
06a0: 20 73 6f 6d 65 20 76 61 6c 69 64 69 74 79 20 63   some validity c
06b0: 68 65 63 6b 73 20 6f 6e 20 61 6c 6c 20 66 69 65  hecks on all fie
06c0: 6c 64 73 2e 20 20 49 6e 20 70 61 72 74 69 63 75  lds.  In particu
06d0: 6c 61 72 2c 0a 20 20 2a 2a 20 6d 61 6b 65 20 73  lar,.  ** make s
06e0: 75 72 65 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f  ure fields do no
06f0: 74 20 63 6f 6e 74 61 69 6e 20 4e 55 4c 4c 73 2e  t contain NULLs.
0700: 20 4f 74 68 65 72 77 69 73 65 20 77 65 20 6d 69   Otherwise we mi
0710: 67 68 74 20 63 6f 72 65 0a 20 20 2a 2a 20 77 68  ght core.  ** wh
0720: 65 6e 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f  en attempting to
0730: 20 69 6e 69 74 69 61 6c 69 7a 65 20 66 72 6f 6d   initialize from
0740: 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62   a corrupt datab
0750: 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 0a 20 20  ase file. */..  
0760: 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 35 20  assert( argc==5 
0770: 29 3b 0a 20 20 73 77 69 74 63 68 28 20 61 72 67  );.  switch( arg
0780: 76 5b 30 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 63  v[0][0] ){.    c
0790: 61 73 65 20 27 76 27 3a 0a 20 20 20 20 63 61 73  ase 'v':.    cas
07a0: 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73 65 20  e 'i':.    case 
07b0: 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45 41 54  't': {  /* CREAT
07c0: 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20  E TABLE, CREATE 
07d0: 49 4e 44 45 58 2c 20 6f 72 20 43 52 45 41 54 45  INDEX, or CREATE
07e0: 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e 74 73   VIEW statements
07f0: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 61 72   */.      if( ar
0800: 67 76 5b 33 5d 20 26 26 20 61 72 67 76 5b 33 5d  gv[3] && argv[3]
0810: 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 2f  [0] ){.        /
0820: 2a 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73 65  * Call the parse
0830: 72 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20 43  r to process a C
0840: 52 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e 44  REATE TABLE, IND
0850: 45 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20 20  EX or VIEW..    
0860: 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61 75      ** But becau
0870: 73 65 20 73 50 61 72 73 65 2e 69 6e 69 74 46 6c  se sParse.initFl
0880: 61 67 20 69 73 20 73 65 74 20 74 6f 20 31 2c 20  ag is set to 1, 
0890: 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 20  no VDBE code is 
08a0: 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20 20  generated.      
08b0: 20 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 64    ** or executed
08c0: 2e 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73 65  .  All the parse
08d0: 72 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64 20  r does is build 
08e0: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 74  the internal dat
08f0: 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 72  a.        ** str
0900: 75 63 74 75 72 65 73 20 74 68 61 74 20 64 65 73  uctures that des
0910: 63 72 69 62 65 20 74 68 65 20 74 61 62 6c 65 2c  cribe the table,
0920: 20 69 6e 64 65 78 2c 20 6f 72 20 76 69 65 77 2e   index, or view.
0930: 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  .        */.    
0940: 20 20 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72      memset(&sPar
0950: 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50  se, 0, sizeof(sP
0960: 61 72 73 65 29 29 3b 0a 20 20 20 20 20 20 20 20  arse));.        
0970: 73 50 61 72 73 65 2e 64 62 20 3d 20 70 44 61 74  sParse.db = pDat
0980: 61 2d 3e 64 62 3b 0a 20 20 20 20 20 20 20 20 73  a->db;.        s
0990: 50 61 72 73 65 2e 69 6e 69 74 46 6c 61 67 20 3d  Parse.initFlag =
09a0: 20 31 3b 0a 20 20 20 20 20 20 20 20 73 50 61 72   1;.        sPar
09b0: 73 65 2e 69 73 54 65 6d 70 20 3d 20 61 72 67 76  se.isTemp = argv
09c0: 5b 34 5d 5b 30 5d 20 2d 20 27 30 27 3b 0a 20 20  [4][0] - '0';.  
09d0: 20 20 20 20 20 20 73 50 61 72 73 65 2e 6e 65 77        sParse.new
09e0: 54 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72 67 76  Tnum = atoi(argv
09f0: 5b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 73 50  [2]);.        sP
0a00: 61 72 73 65 2e 75 73 65 43 61 6c 6c 62 61 63 6b  arse.useCallback
0a10: 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 73 71   = 1;.        sq
0a20: 6c 69 74 65 52 75 6e 50 61 72 73 65 72 28 26 73  liteRunParser(&s
0a30: 50 61 72 73 65 2c 20 61 72 67 76 5b 33 5d 2c 20  Parse, argv[3], 
0a40: 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 67 29  pData->pzErrMsg)
0a50: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
0a60: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65         /* If the
0a70: 20 53 51 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62   SQL column is b
0a80: 6c 61 6e 6b 20 69 74 20 6d 65 61 6e 73 20 74 68  lank it means th
0a90: 69 73 20 69 73 20 61 6e 20 69 6e 64 65 78 20 74  is is an index t
0aa0: 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 77  hat.        ** w
0ab0: 61 73 20 63 72 65 61 74 65 64 20 74 6f 20 62 65  as created to be
0ac0: 20 74 68 65 20 50 52 49 4d 41 52 59 20 4b 45 59   the PRIMARY KEY
0ad0: 20 6f 72 20 74 6f 20 66 75 6c 66 69 6c 6c 20 61   or to fulfill a
0ae0: 20 55 4e 49 51 55 45 0a 20 20 20 20 20 20 20 20   UNIQUE.        
0af0: 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f  ** constraint fo
0b00: 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45  r a CREATE TABLE
0b10: 2e 20 20 54 68 65 20 69 6e 64 65 78 20 73 68 6f  .  The index sho
0b20: 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79  uld have already
0b30: 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 65 65 6e  .        ** been
0b40: 20 63 72 65 61 74 65 64 20 77 68 65 6e 20 77 65   created when we
0b50: 20 70 72 6f 63 65 73 73 65 64 20 74 68 65 20 43   processed the C
0b60: 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 41 6c  REATE TABLE.  Al
0b70: 6c 20 77 65 20 68 61 76 65 0a 20 20 20 20 20 20  l we have.      
0b80: 20 20 2a 2a 20 74 6f 20 64 6f 20 68 65 72 65 20    ** to do here 
0b90: 69 73 20 72 65 63 6f 72 64 20 74 68 65 20 72 6f  is record the ro
0ba0: 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66  ot page number f
0bb0: 6f 72 20 74 68 61 74 20 69 6e 64 65 78 2e 0a 20  or that index.. 
0bc0: 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20         */.      
0bd0: 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 20    Index *pIndex 
0be0: 3d 20 73 71 6c 69 74 65 46 69 6e 64 49 6e 64 65  = sqliteFindInde
0bf0: 78 28 70 44 61 74 61 2d 3e 64 62 2c 20 61 72 67  x(pData->db, arg
0c00: 76 5b 31 5d 29 3b 0a 20 20 20 20 20 20 20 20 69  v[1]);.        i
0c10: 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 7c 7c 20  f( pIndex==0 || 
0c20: 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 21 3d 30 20  pIndex->tnum!=0 
0c30: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ){.          /* 
0c40: 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72 20 69  This can occur i
0c50: 66 20 74 68 65 72 65 20 65 78 69 73 74 73 20 61  f there exists a
0c60: 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20 54 45 4d  n index on a TEM
0c70: 50 20 74 61 62 6c 65 20 77 68 69 63 68 0a 20 20  P table which.  
0c80: 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73 20 74          ** has t
0c90: 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20  he same name as 
0ca0: 61 6e 6f 74 68 65 72 20 69 6e 64 65 78 20 6f 6e  another index on
0cb0: 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 64   a permanent ind
0cc0: 65 78 2e 20 20 53 69 6e 63 65 0a 20 20 20 20 20  ex.  Since.     
0cd0: 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65 72 6d       ** the perm
0ce0: 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73 20 68  anent table is h
0cf0: 69 64 64 65 6e 20 62 79 20 74 68 65 20 54 45 4d  idden by the TEM
0d00: 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61 6e 20  P table, we can 
0d10: 61 6c 73 6f 0a 20 20 20 20 20 20 20 20 20 20 2a  also.          *
0d20: 2a 20 73 61 66 65 6c 79 20 69 67 6e 6f 72 65 20  * safely ignore 
0d30: 74 68 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65  the index on the
0d40: 20 70 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65   permanent table
0d50: 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20  ..          */. 
0d60: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 4e           /* Do N
0d70: 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 20 20  othing */;.     
0d80: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
0d90: 20 20 20 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d      pIndex->tnum
0da0: 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29   = atoi(argv[2])
0db0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
0dc0: 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b    }.      break;
0dd0: 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75  .    }.    defau
0de0: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 54  lt: {.      /* T
0df0: 68 69 73 20 63 61 6e 20 6e 6f 74 20 68 61 70 70  his can not happ
0e00: 65 6e 21 20 2a 2f 0a 20 20 20 20 20 20 6e 45 72  en! */.      nEr
0e10: 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 61 73 73  r = 1;.      ass
0e20: 65 72 74 28 20 6e 45 72 72 3d 3d 30 20 29 3b 0a  ert( nErr==0 );.
0e30: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
0e40: 72 6e 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a  rn nErr;.}../*.*
0e50: 2a 20 54 68 69 73 20 69 73 20 61 20 63 61 6c 6c  * This is a call
0e60: 62 61 63 6b 20 70 72 6f 63 65 64 75 72 65 20 75  back procedure u
0e70: 73 65 64 20 74 6f 20 72 65 63 6f 6e 73 74 72 75  sed to reconstru
0e80: 63 74 20 61 20 74 61 62 6c 65 2e 20 20 54 68 65  ct a table.  The
0e90: 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  .** name of the 
0ea0: 74 61 62 6c 65 20 74 6f 20 62 65 20 72 65 63 6f  table to be reco
0eb0: 6e 73 74 72 75 63 74 65 64 20 69 73 20 70 61 73  nstructed is pas
0ec0: 73 65 64 20 69 6e 20 61 73 20 61 72 67 76 5b 30  sed in as argv[0
0ed0: 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  ]..**.** This ro
0ee0: 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 74 6f  utine is used to
0ef0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75   automatically u
0f00: 70 67 72 61 64 65 20 61 20 64 61 74 61 62 61 73  pgrade a databas
0f10: 65 20 66 72 6f 6d 0a 2a 2a 20 66 6f 72 6d 61 74  e from.** format
0f20: 20 76 65 72 73 69 6f 6e 20 31 20 6f 72 20 32 20   version 1 or 2 
0f30: 74 6f 20 76 65 72 73 69 6f 6e 20 33 2e 20 20 54  to version 3.  T
0f40: 68 65 20 63 6f 72 72 65 63 74 20 6f 70 65 72 61  he correct opera
0f50: 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 69 73 20  tion of.** this 
0f60: 72 6f 75 74 69 6e 65 20 72 65 6c 79 73 20 6f 6e  routine relys on
0f70: 20 74 68 65 20 66 61 63 74 20 74 68 61 74 20 6e   the fact that n
0f80: 6f 20 69 6e 64 69 63 65 73 20 61 72 65 20 75 73  o indices are us
0f90: 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 70 79 69  ed when.** copyi
0fa0: 6e 67 20 61 20 74 61 62 6c 65 20 6f 75 74 20 74  ng a table out t
0fb0: 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69  o a temporary fi
0fc0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 0a 69 6e  le..*/.static.in
0fd0: 74 20 75 70 67 72 61 64 65 5f 33 5f 63 61 6c 6c  t upgrade_3_call
0fe0: 62 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74  back(void *pInit
0ff0: 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 72  , int argc, char
1000: 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a   **argv, char **
1010: 4e 6f 74 55 73 65 64 29 7b 0a 20 20 49 6e 69 74  NotUsed){.  Init
1020: 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20 28 49  Data *pData = (I
1030: 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74 3b 0a  nitData*)pInit;.
1040: 20 20 69 6e 74 20 72 63 3b 0a 20 20 54 61 62 6c    int rc;.  Tabl
1050: 65 20 2a 70 54 61 62 3b 0a 20 20 54 72 69 67 67  e *pTab;.  Trigg
1060: 65 72 20 2a 70 54 72 69 67 3b 0a 20 20 63 68 61  er *pTrig;.  cha
1070: 72 20 2a 7a 45 72 72 20 3d 20 30 3b 0a 0a 20 20  r *zErr = 0;..  
1080: 70 54 61 62 20 3d 20 73 71 6c 69 74 65 46 69 6e  pTab = sqliteFin
1090: 64 54 61 62 6c 65 28 70 44 61 74 61 2d 3e 64 62  dTable(pData->db
10a0: 2c 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20 61 73  , argv[0]);.  as
10b0: 73 65 72 74 28 20 70 54 61 62 21 3d 30 20 29 3b  sert( pTab!=0 );
10c0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
10d0: 65 53 74 72 49 43 6d 70 28 70 54 61 62 2d 3e 7a  eStrICmp(pTab->z
10e0: 4e 61 6d 65 2c 20 61 72 67 76 5b 30 5d 29 3d 3d  Name, argv[0])==
10f0: 30 20 29 3b 0a 20 20 69 66 28 20 70 54 61 62 20  0 );.  if( pTab 
1100: 29 7b 0a 20 20 20 20 70 54 72 69 67 20 3d 20 70  ){.    pTrig = p
1110: 54 61 62 2d 3e 70 54 72 69 67 67 65 72 3b 0a 20  Tab->pTrigger;. 
1120: 20 20 20 70 54 61 62 2d 3e 70 54 72 69 67 67 65     pTab->pTrigge
1130: 72 20 3d 20 30 3b 20 20 2f 2a 20 44 69 73 61 62  r = 0;  /* Disab
1140: 6c 65 20 61 6c 6c 20 74 72 69 67 67 65 72 73 20  le all triggers 
1150: 62 65 66 6f 72 65 20 72 65 62 75 69 6c 64 69 6e  before rebuildin
1160: 67 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20  g the table */. 
1170: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65   }.  rc = sqlite
1180: 5f 65 78 65 63 5f 70 72 69 6e 74 66 28 70 44 61  _exec_printf(pDa
1190: 74 61 2d 3e 64 62 2c 0a 20 20 20 20 22 43 52 45  ta->db,.    "CRE
11a0: 41 54 45 20 54 45 4d 50 20 54 41 42 4c 45 20 73  ATE TEMP TABLE s
11b0: 71 6c 69 74 65 5f 78 20 41 53 20 53 45 4c 45 43  qlite_x AS SELEC
11c0: 54 20 2a 20 46 52 4f 4d 20 27 25 71 27 3b 20 22  T * FROM '%q'; "
11d0: 0a 20 20 20 20 22 44 45 4c 45 54 45 20 46 52 4f  .    "DELETE FRO
11e0: 4d 20 27 25 71 27 3b 20 22 0a 20 20 20 20 22 49  M '%q'; ".    "I
11f0: 4e 53 45 52 54 20 49 4e 54 4f 20 27 25 71 27 20  NSERT INTO '%q' 
1200: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 71  SELECT * FROM sq
1210: 6c 69 74 65 5f 78 3b 20 22 0a 20 20 20 20 22 44  lite_x; ".    "D
1220: 52 4f 50 20 54 41 42 4c 45 20 73 71 6c 69 74 65  ROP TABLE sqlite
1230: 5f 78 3b 22 2c 0a 20 20 20 20 30 2c 20 30 2c 20  _x;",.    0, 0, 
1240: 26 7a 45 72 72 2c 20 61 72 67 76 5b 30 5d 2c 20  &zErr, argv[0], 
1250: 61 72 67 76 5b 30 5d 2c 20 61 72 67 76 5b 30 5d  argv[0], argv[0]
1260: 29 3b 0a 20 20 69 66 28 20 7a 45 72 72 20 29 7b  );.  if( zErr ){
1270: 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74  .    sqliteSetSt
1280: 72 69 6e 67 28 70 44 61 74 61 2d 3e 70 7a 45 72  ring(pData->pzEr
1290: 72 4d 73 67 2c 20 7a 45 72 72 2c 20 30 29 3b 0a  rMsg, zErr, 0);.
12a0: 20 20 20 20 73 71 6c 69 74 65 5f 66 72 65 65 6d      sqlite_freem
12b0: 65 6d 28 7a 45 72 72 29 3b 0a 20 20 7d 0a 0a 20  em(zErr);.  }.. 
12c0: 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20   /* If an error 
12d0: 6f 63 63 75 72 72 65 64 20 69 6e 20 74 68 65 20  occurred in the 
12e0: 53 51 4c 20 61 62 6f 76 65 2c 20 74 68 65 6e 20  SQL above, then 
12f0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
1300: 77 69 6c 6c 0a 20 20 2a 2a 20 72 6f 6c 6c 62 61  will.  ** rollba
1310: 63 6b 20 77 68 69 63 68 20 77 69 6c 6c 20 64 65  ck which will de
1320: 6c 65 74 65 20 74 68 65 20 69 6e 74 65 72 6e 61  lete the interna
1330: 6c 20 73 79 6d 62 6f 6c 20 74 61 62 6c 65 73 2e  l symbol tables.
1340: 20 20 54 68 69 73 20 77 69 6c 6c 0a 20 20 2a 2a    This will.  **
1350: 20 63 61 75 73 65 20 74 68 65 20 73 74 72 75 63   cause the struc
1360: 74 75 72 65 20 74 68 61 74 20 70 54 61 62 20 70  ture that pTab p
1370: 6f 69 6e 74 73 20 74 6f 20 62 65 20 64 65 6c 65  oints to be dele
1380: 74 65 64 2e 20 20 49 6e 20 63 61 73 65 20 74 68  ted.  In case th
1390: 61 74 0a 20 20 2a 2a 20 68 61 70 70 65 6e 65 64  at.  ** happened
13a0: 2c 20 77 65 20 6e 65 65 64 20 74 6f 20 72 65 66  , we need to ref
13b0: 65 74 63 68 20 70 54 61 62 2e 0a 20 20 2a 2f 0a  etch pTab..  */.
13c0: 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 46    pTab = sqliteF
13d0: 69 6e 64 54 61 62 6c 65 28 70 44 61 74 61 2d 3e  indTable(pData->
13e0: 64 62 2c 20 61 72 67 76 5b 30 5d 29 3b 0a 20 20  db, argv[0]);.  
13f0: 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20  if( pTab ){.    
1400: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 53 74  assert( sqliteSt
1410: 72 49 43 6d 70 28 70 54 61 62 2d 3e 7a 4e 61 6d  rICmp(pTab->zNam
1420: 65 2c 20 61 72 67 76 5b 30 5d 29 3d 3d 30 20 29  e, argv[0])==0 )
1430: 3b 0a 20 20 20 20 70 54 61 62 2d 3e 70 54 72 69  ;.    pTab->pTri
1440: 67 67 65 72 20 3d 20 70 54 72 69 67 3b 20 20 2f  gger = pTrig;  /
1450: 2a 20 52 65 2d 65 6e 61 62 6c 65 20 74 72 69 67  * Re-enable trig
1460: 67 65 72 73 20 2a 2f 0a 20 20 7d 0a 20 20 72 65  gers */.  }.  re
1470: 74 75 72 6e 20 72 63 21 3d 53 51 4c 49 54 45 5f  turn rc!=SQLITE_
1480: 4f 4b 3b 0a 7d 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 41  OK;.}..../*.** A
1490: 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74  ttempt to read t
14a0: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65  he database sche
14b0: 6d 61 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a  ma and initializ
14c0: 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 61  e internal.** da
14d0: 74 61 20 73 74 72 75 63 74 75 72 65 73 2e 20 20  ta structures.  
14e0: 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 68  Return one of th
14f0: 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72 20  e SQLITE_ error 
1500: 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 69  codes to.** indi
1510: 63 61 74 65 20 73 75 63 63 65 73 73 20 6f 72 20  cate success or 
1520: 66 61 69 6c 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41  failure..**.** A
1530: 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61 73  fter the databas
1540: 65 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64  e is initialized
1550: 2c 20 74 68 65 20 53 51 4c 49 54 45 5f 49 6e 69  , the SQLITE_Ini
1560: 74 69 61 6c 69 7a 65 64 0a 2a 2a 20 62 69 74 20  tialized.** bit 
1570: 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66 6c  is set in the fl
1580: 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 65  ags field of the
1590: 20 73 71 6c 69 74 65 20 73 74 72 75 63 74 75 72   sqlite structur
15a0: 65 2e 20 20 41 6e 0a 2a 2a 20 61 74 74 65 6d 70  e.  An.** attemp
15b0: 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e 69  t is made to ini
15c0: 74 69 61 6c 69 7a 65 20 74 68 65 20 64 61 74 61  tialize the data
15d0: 62 61 73 65 20 61 73 20 73 6f 6f 6e 20 61 73 20  base as soon as 
15e0: 69 74 0a 2a 2a 20 69 73 20 6f 70 65 6e 65 64 2e  it.** is opened.
15f0: 20 20 49 66 20 74 68 61 74 20 66 61 69 6c 73 20    If that fails 
1600: 28 70 65 72 68 61 70 73 20 62 65 63 61 75 73 65  (perhaps because
1610: 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 73   another process
1620: 0a 2a 2a 20 68 61 73 20 74 68 65 20 73 71 6c 69  .** has the sqli
1630: 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20  te_master table 
1640: 6c 6f 63 6b 65 64 29 20 74 68 61 6e 20 61 6e 6f  locked) than ano
1650: 74 68 65 72 20 61 74 74 65 6d 70 74 0a 2a 2a 20  ther attempt.** 
1660: 69 73 20 6d 61 64 65 20 74 68 65 20 66 69 72 73  is made the firs
1670: 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 62  t time the datab
1680: 61 73 65 20 69 73 20 61 63 63 65 73 73 65 64 2e  ase is accessed.
1690: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 49 6e  .*/.int sqliteIn
16a0: 69 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63  it(sqlite *db, c
16b0: 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b  har **pzErrMsg){
16c0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43  .  int rc;.  BtC
16d0: 75 72 73 6f 72 20 2a 63 75 72 4d 61 69 6e 3b 0a  ursor *curMain;.
16e0: 20 20 69 6e 74 20 73 69 7a 65 3b 0a 20 20 54 61    int size;.  Ta
16f0: 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 63 68 61  ble *pTab;.  cha
1700: 72 20 2a 61 7a 41 72 67 5b 36 5d 3b 0a 20 20 69  r *azArg[6];.  i
1710: 6e 74 20 6d 65 74 61 5b 53 51 4c 49 54 45 5f 4e  nt meta[SQLITE_N
1720: 5f 42 54 52 45 45 5f 4d 45 54 41 5d 3b 0a 20 20  _BTREE_META];.  
1730: 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a 20 20  Parse sParse;.  
1740: 49 6e 69 74 44 61 74 61 20 69 6e 69 74 44 61 74  InitData initDat
1750: 61 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68  a;..  /*.  ** Th
1760: 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 61 73  e master databas
1770: 65 20 74 61 62 6c 65 20 68 61 73 20 61 20 73 74  e table has a st
1780: 72 75 63 74 75 72 65 20 6c 69 6b 65 20 74 68 69  ructure like thi
1790: 73 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20  s.  */.  static 
17a0: 63 68 61 72 20 6d 61 73 74 65 72 5f 73 63 68 65  char master_sche
17b0: 6d 61 5b 5d 20 3d 20 0a 20 20 20 20 20 22 43 52  ma[] = .     "CR
17c0: 45 41 54 45 20 54 41 42 4c 45 20 73 71 6c 69 74  EATE TABLE sqlit
17d0: 65 5f 6d 61 73 74 65 72 28 5c 6e 22 0a 20 20 20  e_master(\n".   
17e0: 20 20 22 20 20 74 79 70 65 20 74 65 78 74 2c 5c    "  type text,\
17f0: 6e 22 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 20  n".     "  name 
1800: 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20  text,\n".     " 
1810: 20 74 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c   tbl_name text,\
1820: 6e 22 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 70  n".     "  rootp
1830: 61 67 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a  age integer,\n".
1840: 20 20 20 20 20 22 20 20 73 71 6c 20 74 65 78 74       "  sql text
1850: 5c 6e 22 0a 20 20 20 20 20 22 29 22 0a 20 20 3b  \n".     ")".  ;
1860: 0a 20 20 73 74 61 74 69 63 20 63 68 61 72 20 74  .  static char t
1870: 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d  emp_master_schem
1880: 61 5b 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45  a[] = .     "CRE
1890: 41 54 45 20 54 45 4d 50 20 54 41 42 4c 45 20 73  ATE TEMP TABLE s
18a0: 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65  qlite_temp_maste
18b0: 72 28 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 79  r(\n".     "  ty
18c0: 70 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20  pe text,\n".    
18d0: 20 22 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e   "  name text,\n
18e0: 22 0a 20 20 20 20 20 22 20 20 74 62 6c 5f 6e 61  ".     "  tbl_na
18f0: 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20  me text,\n".    
1900: 20 22 20 20 72 6f 6f 74 70 61 67 65 20 69 6e 74   "  rootpage int
1910: 65 67 65 72 2c 5c 6e 22 0a 20 20 20 20 20 22 20  eger,\n".     " 
1920: 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20 20 20   sql text\n".   
1930: 20 20 22 29 22 0a 20 20 3b 0a 0a 20 20 2f 2a 20    ")".  ;..  /* 
1940: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 53 51  The following SQ
1950: 4c 20 77 69 6c 6c 20 72 65 61 64 20 74 68 65 20  L will read the 
1960: 73 63 68 65 6d 61 20 66 72 6f 6d 20 74 68 65 20  schema from the 
1970: 6d 61 73 74 65 72 20 74 61 62 6c 65 73 2e 0a 20  master tables.. 
1980: 20 2a 2a 20 54 68 65 20 66 69 72 73 74 20 76 65   ** The first ve
1990: 72 73 69 6f 6e 20 77 6f 72 6b 73 20 77 69 74 68  rsion works with
19a0: 20 53 51 4c 69 74 65 20 66 69 6c 65 20 66 6f 72   SQLite file for
19b0: 6d 61 74 73 20 32 20 6f 72 20 67 72 65 61 74 65  mats 2 or greate
19c0: 72 2e 0a 20 20 2a 2a 20 54 68 65 20 73 65 63 6f  r..  ** The seco
19d0: 6e 64 20 76 65 72 73 69 6f 6e 20 69 73 20 66 6f  nd version is fo
19e0: 72 20 66 6f 72 6d 61 74 20 31 20 66 69 6c 65 73  r format 1 files
19f0: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 42 65 67 69  ..  **.  ** Begi
1a00: 6e 6e 69 6e 67 20 77 69 74 68 20 66 69 6c 65 20  nning with file 
1a10: 66 6f 72 6d 61 74 20 32 2c 20 74 68 65 20 72 6f  format 2, the ro
1a20: 77 69 64 20 66 6f 72 20 6e 65 77 20 74 61 62 6c  wid for new tabl
1a30: 65 20 65 6e 74 72 69 65 73 0a 20 20 2a 2a 20 28  e entries.  ** (
1a40: 69 6e 63 6c 75 64 69 6e 67 20 65 6e 74 72 69 65  including entrie
1a50: 73 20 69 6e 20 73 71 6c 69 74 65 5f 6d 61 73 74  s in sqlite_mast
1a60: 65 72 29 20 69 73 20 61 6e 20 69 6e 63 72 65 61  er) is an increa
1a70: 73 69 6e 67 20 69 6e 74 65 67 65 72 2e 0a 20 20  sing integer..  
1a80: 2a 2a 20 53 6f 20 66 6f 72 20 66 69 6c 65 20 66  ** So for file f
1a90: 6f 72 6d 61 74 20 32 20 61 6e 64 20 6c 61 74 65  ormat 2 and late
1aa0: 72 2c 20 77 65 20 63 61 6e 20 70 6c 61 79 20 62  r, we can play b
1ab0: 61 63 6b 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  ack sqlite_maste
1ac0: 72 0a 20 20 2a 2a 20 61 6e 64 20 61 6c 6c 20 74  r.  ** and all t
1ad0: 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65 6d  he CREATE statem
1ae0: 65 6e 74 73 20 77 69 6c 6c 20 61 70 70 65 61 72  ents will appear
1af0: 20 69 6e 20 74 68 65 20 72 69 67 68 74 20 6f 72   in the right or
1b00: 64 65 72 2e 0a 20 20 2a 2a 20 42 75 74 20 77 69  der..  ** But wi
1b10: 74 68 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 31  th file format 1
1b20: 2c 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 20  , table entries 
1b30: 77 65 72 65 20 72 61 6e 64 6f 6d 20 61 6e 64 20  were random and 
1b40: 73 6f 20 77 65 0a 20 20 2a 2a 20 68 61 76 65 20  so we.  ** have 
1b50: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65  to make sure the
1b60: 20 43 52 45 41 54 45 20 54 41 42 4c 45 73 20 6f   CREATE TABLEs o
1b70: 63 63 75 72 20 62 65 66 6f 72 65 20 74 68 65 69  ccur before thei
1b80: 72 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a  r corresponding.
1b90: 20 20 2a 2a 20 43 52 45 41 54 45 20 49 4e 44 45    ** CREATE INDE
1ba0: 58 73 2e 20 20 28 57 65 20 64 6f 6e 27 74 20 68  Xs.  (We don't h
1bb0: 61 76 65 20 74 6f 20 64 65 61 6c 20 77 69 74 68  ave to deal with
1bc0: 20 43 52 45 41 54 45 20 56 49 45 57 20 6f 72 0a   CREATE VIEW or.
1bd0: 20 20 2a 2a 20 43 52 45 41 54 45 20 54 52 49 47    ** CREATE TRIG
1be0: 47 45 52 20 69 6e 20 66 69 6c 65 20 66 6f 72 6d  GER in file form
1bf0: 61 74 20 31 20 62 65 63 61 75 73 65 20 74 68 6f  at 1 because tho
1c00: 73 65 20 63 6f 6e 73 74 72 75 63 74 73 20 64 69  se constructs di
1c10: 64 0a 20 20 2a 2a 20 6e 6f 74 20 65 78 69 73 74  d.  ** not exist
1c20: 20 74 68 65 6e 2e 29 20 0a 20 20 2a 2f 0a 20 20   then.) .  */.  
1c30: 73 74 61 74 69 63 20 63 68 61 72 20 69 6e 69 74  static char init
1c40: 5f 73 63 72 69 70 74 5b 5d 20 3d 20 0a 20 20 20  _script[] = .   
1c50: 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c 20    "SELECT type, 
1c60: 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20  name, rootpage, 
1c70: 73 71 6c 2c 20 31 20 46 52 4f 4d 20 73 71 6c 69  sql, 1 FROM sqli
1c80: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 20 22  te_temp_master "
1c90: 0a 20 20 20 20 20 22 55 4e 49 4f 4e 20 41 4c 4c  .     "UNION ALL
1ca0: 20 22 0a 20 20 20 20 20 22 53 45 4c 45 43 54 20   ".     "SELECT 
1cb0: 74 79 70 65 2c 20 6e 61 6d 65 2c 20 72 6f 6f 74  type, name, root
1cc0: 70 61 67 65 2c 20 73 71 6c 2c 20 30 20 46 52 4f  page, sql, 0 FRO
1cd0: 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22  M sqlite_master"
1ce0: 3b 0a 20 20 73 74 61 74 69 63 20 63 68 61 72 20  ;.  static char 
1cf0: 6f 6c 64 65 72 5f 69 6e 69 74 5f 73 63 72 69 70  older_init_scrip
1d00: 74 5b 5d 20 3d 20 0a 20 20 20 20 20 22 53 45 4c  t[] = .     "SEL
1d10: 45 43 54 20 74 79 70 65 2c 20 6e 61 6d 65 2c 20  ECT type, name, 
1d20: 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c 20 31  rootpage, sql, 1
1d30: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 74 65 6d   FROM sqlite_tem
1d40: 70 5f 6d 61 73 74 65 72 20 22 0a 20 20 20 20 20  p_master ".     
1d50: 22 55 4e 49 4f 4e 20 41 4c 4c 20 22 0a 20 20 20  "UNION ALL ".   
1d60: 20 20 22 53 45 4c 45 43 54 20 74 79 70 65 2c 20    "SELECT type, 
1d70: 6e 61 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20  name, rootpage, 
1d80: 73 71 6c 2c 20 30 20 46 52 4f 4d 20 73 71 6c 69  sql, 0 FROM sqli
1d90: 74 65 5f 6d 61 73 74 65 72 20 22 0a 20 20 20 20  te_master ".    
1da0: 20 22 57 48 45 52 45 20 74 79 70 65 3d 27 74 61   "WHERE type='ta
1db0: 62 6c 65 27 20 22 0a 20 20 20 20 20 22 55 4e 49  ble' ".     "UNI
1dc0: 4f 4e 20 41 4c 4c 20 22 0a 20 20 20 20 20 22 53  ON ALL ".     "S
1dd0: 45 4c 45 43 54 20 74 79 70 65 2c 20 6e 61 6d 65  ELECT type, name
1de0: 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 2c  , rootpage, sql,
1df0: 20 30 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d   0 FROM sqlite_m
1e00: 61 73 74 65 72 20 22 0a 20 20 20 20 20 22 57 48  aster ".     "WH
1e10: 45 52 45 20 74 79 70 65 3d 27 69 6e 64 65 78 27  ERE type='index'
1e20: 22 3b 0a 0a 0a 20 20 2f 2a 20 43 6f 6e 73 74 72  ";...  /* Constr
1e30: 75 63 74 20 74 68 65 20 73 63 68 65 6d 61 20 74  uct the schema t
1e40: 61 62 6c 65 73 3a 20 73 71 6c 69 74 65 5f 6d 61  ables: sqlite_ma
1e50: 73 74 65 72 20 61 6e 64 20 73 71 6c 69 74 65 5f  ster and sqlite_
1e60: 74 65 6d 70 5f 6d 61 73 74 65 72 0a 20 20 2a 2f  temp_master.  */
1e70: 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d 20 22 74  .  azArg[0] = "t
1e80: 61 62 6c 65 22 3b 0a 20 20 61 7a 41 72 67 5b 31  able";.  azArg[1
1e90: 5d 20 3d 20 4d 41 53 54 45 52 5f 4e 41 4d 45 3b  ] = MASTER_NAME;
1ea0: 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d 20 22 32  .  azArg[2] = "2
1eb0: 22 3b 0a 20 20 61 7a 41 72 67 5b 33 5d 20 3d 20  ";.  azArg[3] = 
1ec0: 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 3b 0a 20  master_schema;. 
1ed0: 20 61 7a 41 72 67 5b 34 5d 20 3d 20 22 30 22 3b   azArg[4] = "0";
1ee0: 0a 20 20 61 7a 41 72 67 5b 35 5d 20 3d 20 30 3b  .  azArg[5] = 0;
1ef0: 0a 20 20 69 6e 69 74 44 61 74 61 2e 64 62 20 3d  .  initData.db =
1f00: 20 64 62 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e   db;.  initData.
1f10: 70 7a 45 72 72 4d 73 67 20 3d 20 70 7a 45 72 72  pzErrMsg = pzErr
1f20: 4d 73 67 3b 0a 20 20 73 71 6c 69 74 65 49 6e 69  Msg;.  sqliteIni
1f30: 74 43 61 6c 6c 62 61 63 6b 28 26 69 6e 69 74 44  tCallback(&initD
1f40: 61 74 61 2c 20 35 2c 20 61 7a 41 72 67 2c 20 30  ata, 5, azArg, 0
1f50: 29 3b 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69  );.  pTab = sqli
1f60: 74 65 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20  teFindTable(db, 
1f70: 4d 41 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20  MASTER_NAME);.  
1f80: 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20  if( pTab ){.    
1f90: 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d  pTab->readOnly =
1fa0: 20 31 3b 0a 20 20 7d 0a 20 20 61 7a 41 72 67 5b   1;.  }.  azArg[
1fb0: 31 5d 20 3d 20 54 45 4d 50 5f 4d 41 53 54 45 52  1] = TEMP_MASTER
1fc0: 5f 4e 41 4d 45 3b 0a 20 20 61 7a 41 72 67 5b 33  _NAME;.  azArg[3
1fd0: 5d 20 3d 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f  ] = temp_master_
1fe0: 73 63 68 65 6d 61 3b 0a 20 20 61 7a 41 72 67 5b  schema;.  azArg[
1ff0: 34 5d 20 3d 20 22 31 22 3b 0a 20 20 73 71 6c 69  4] = "1";.  sqli
2000: 74 65 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 26  teInitCallback(&
2010: 69 6e 69 74 44 61 74 61 2c 20 35 2c 20 61 7a 41  initData, 5, azA
2020: 72 67 2c 20 30 29 3b 0a 20 20 70 54 61 62 20 3d  rg, 0);.  pTab =
2030: 20 73 71 6c 69 74 65 46 69 6e 64 54 61 62 6c 65   sqliteFindTable
2040: 28 64 62 2c 20 54 45 4d 50 5f 4d 41 53 54 45 52  (db, TEMP_MASTER
2050: 5f 4e 41 4d 45 29 3b 0a 20 20 69 66 28 20 70 54  _NAME);.  if( pT
2060: 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d 3e  ab ){.    pTab->
2070: 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 20  readOnly = 1;.  
2080: 7d 0a 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 61  }..  /* Create a
2090: 20 63 75 72 73 6f 72 20 74 6f 20 68 6f 6c 64 20   cursor to hold 
20a0: 74 68 65 20 64 61 74 61 62 61 73 65 20 6f 70 65  the database ope
20b0: 6e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d  n.  */.  if( db-
20c0: 3e 70 42 65 3d 3d 30 20 29 20 72 65 74 75 72 6e  >pBe==0 ) return
20d0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 72 63   SQLITE_OK;.  rc
20e0: 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65 43 75   = sqliteBtreeCu
20f0: 72 73 6f 72 28 64 62 2d 3e 70 42 65 2c 20 32 2c  rsor(db->pBe, 2,
2100: 20 30 2c 20 26 63 75 72 4d 61 69 6e 29 3b 0a 20   0, &curMain);. 
2110: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 73   if( rc ){.    s
2120: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
2130: 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65 5f  zErrMsg, sqlite_
2140: 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29  error_string(rc)
2150: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
2160: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
2170: 65 6d 61 28 64 62 29 3b 0a 20 20 20 20 72 65 74  ema(db);.    ret
2180: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f  urn rc;.  }..  /
2190: 2a 20 47 65 74 20 74 68 65 20 64 61 74 61 62 61  * Get the databa
21a0: 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74  se meta informat
21b0: 69 6f 6e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20  ion.  */.  rc = 
21c0: 73 71 6c 69 74 65 42 74 72 65 65 47 65 74 4d 65  sqliteBtreeGetMe
21d0: 74 61 28 64 62 2d 3e 70 42 65 2c 20 6d 65 74 61  ta(db->pBe, meta
21e0: 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20  );.  if( rc ){. 
21f0: 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69     sqliteSetStri
2200: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c  ng(pzErrMsg, sql
2210: 69 74 65 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67  ite_error_string
2220: 28 72 63 29 2c 20 30 29 3b 0a 20 20 20 20 73 71  (rc), 0);.    sq
2230: 6c 69 74 65 52 65 73 65 74 49 6e 74 65 72 6e 61  liteResetInterna
2240: 6c 53 63 68 65 6d 61 28 64 62 29 3b 0a 20 20 20  lSchema(db);.   
2250: 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c 6f 73   sqliteBtreeClos
2260: 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69 6e 29  eCursor(curMain)
2270: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
2280: 0a 20 20 7d 0a 20 20 64 62 2d 3e 73 63 68 65 6d  .  }.  db->schem
2290: 61 5f 63 6f 6f 6b 69 65 20 3d 20 6d 65 74 61 5b  a_cookie = meta[
22a0: 31 5d 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 5f 63  1];.  db->next_c
22b0: 6f 6f 6b 69 65 20 3d 20 64 62 2d 3e 73 63 68 65  ookie = db->sche
22c0: 6d 61 5f 63 6f 6f 6b 69 65 3b 0a 20 20 64 62 2d  ma_cookie;.  db-
22d0: 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 6d  >file_format = m
22e0: 65 74 61 5b 32 5d 3b 0a 20 20 73 69 7a 65 20 3d  eta[2];.  size =
22f0: 20 6d 65 74 61 5b 33 5d 3b 0a 20 20 69 66 28 20   meta[3];.  if( 
2300: 73 69 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20  size==0 ){ size 
2310: 3d 20 4d 41 58 5f 50 41 47 45 53 3b 20 7d 0a 20  = MAX_PAGES; }. 
2320: 20 64 62 2d 3e 63 61 63 68 65 5f 73 69 7a 65 20   db->cache_size 
2330: 3d 20 73 69 7a 65 3b 0a 20 20 73 71 6c 69 74 65  = size;.  sqlite
2340: 42 74 72 65 65 53 65 74 43 61 63 68 65 53 69 7a  BtreeSetCacheSiz
2350: 65 28 64 62 2d 3e 70 42 65 2c 20 73 69 7a 65 29  e(db->pBe, size)
2360: 3b 0a 20 20 64 62 2d 3e 73 61 66 65 74 79 5f 6c  ;.  db->safety_l
2370: 65 76 65 6c 20 3d 20 6d 65 74 61 5b 34 5d 3b 0a  evel = meta[4];.
2380: 20 20 69 66 28 20 64 62 2d 3e 73 61 66 65 74 79    if( db->safety
2390: 5f 6c 65 76 65 6c 3d 3d 30 20 29 20 64 62 2d 3e  _level==0 ) db->
23a0: 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 32  safety_level = 2
23b0: 3b 0a 20 20 73 71 6c 69 74 65 42 74 72 65 65 53  ;.  sqliteBtreeS
23c0: 65 74 53 61 66 65 74 79 4c 65 76 65 6c 28 64 62  etSafetyLevel(db
23d0: 2d 3e 70 42 65 2c 20 64 62 2d 3e 73 61 66 65 74  ->pBe, db->safet
23e0: 79 5f 6c 65 76 65 6c 29 3b 0a 0a 20 20 2f 2a 0a  y_level);..  /*.
23f0: 20 20 2a 2a 20 20 20 20 20 66 69 6c 65 5f 66 6f    **     file_fo
2400: 72 6d 61 74 3d 3d 31 20 20 20 20 56 65 72 73 69  rmat==1    Versi
2410: 6f 6e 20 32 2e 31 2e 30 2e 0a 20 20 2a 2a 20 20  on 2.1.0..  **  
2420: 20 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d     file_format==
2430: 32 20 20 20 20 56 65 72 73 69 6f 6e 20 32 2e 32  2    Version 2.2
2440: 2e 30 2e 20 41 64 64 20 73 75 70 70 6f 72 74 20  .0. Add support 
2450: 66 6f 72 20 49 4e 54 45 47 45 52 20 50 52 49 4d  for INTEGER PRIM
2460: 41 52 59 20 4b 45 59 2e 0a 20 20 2a 2a 20 20 20  ARY KEY..  **   
2470: 20 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 33    file_format==3
2480: 20 20 20 20 56 65 72 73 69 6f 6e 20 32 2e 36 2e      Version 2.6.
2490: 30 2e 20 46 69 78 20 65 6d 70 74 79 2d 73 74 72  0. Fix empty-str
24a0: 69 6e 67 20 69 6e 64 65 78 20 62 75 67 2e 0a 20  ing index bug.. 
24b0: 20 2a 2a 20 20 20 20 20 66 69 6c 65 5f 66 6f 72   **     file_for
24c0: 6d 61 74 3d 3d 34 20 20 20 20 56 65 72 73 69 6f  mat==4    Versio
24d0: 6e 20 32 2e 37 2e 30 2e 20 41 64 64 20 73 75 70  n 2.7.0. Add sup
24e0: 70 6f 72 74 20 66 6f 72 20 73 65 70 61 72 61 74  port for separat
24f0: 65 20 6e 75 6d 65 72 69 63 20 61 6e 64 0a 20 20  e numeric and.  
2500: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  **              
2510: 20 20 20 20 20 20 20 20 20 74 65 78 74 20 64 61           text da
2520: 74 61 74 79 70 65 73 2e 0a 20 20 2a 2f 0a 20 20  tatypes..  */.  
2530: 69 66 28 20 64 62 2d 3e 66 69 6c 65 5f 66 6f 72  if( db->file_for
2540: 6d 61 74 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a  mat==0 ){.    /*
2550: 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 66   This happens if
2560: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 61   the database wa
2570: 73 20 69 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74  s initially empt
2580: 79 20 2a 2f 0a 20 20 20 20 64 62 2d 3e 66 69 6c  y */.    db->fil
2590: 65 5f 66 6f 72 6d 61 74 20 3d 20 34 3b 0a 20 20  e_format = 4;.  
25a0: 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e 66 69  }else if( db->fi
25b0: 6c 65 5f 66 6f 72 6d 61 74 3e 34 20 29 7b 0a 20  le_format>4 ){. 
25c0: 20 20 20 73 71 6c 69 74 65 42 74 72 65 65 43 6c     sqliteBtreeCl
25d0: 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d 61 69  oseCursor(curMai
25e0: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 65  n);.    sqliteSe
25f0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
2600: 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 20 66  , "unsupported f
2610: 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 30 29 3b  ile format", 0);
2620: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
2630: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20  TE_ERROR;.  }.. 
2640: 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73 63 68   /* Read the sch
2650: 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ema information 
2660: 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68 65 6d  out of the schem
2670: 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a 20 20  a tables.  */.  
2680: 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20  memset(&sParse, 
2690: 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65  0, sizeof(sParse
26a0: 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20  ));.  sParse.db 
26b0: 3d 20 64 62 3b 0a 20 20 73 50 61 72 73 65 2e 70  = db;.  sParse.p
26c0: 42 65 20 3d 20 64 62 2d 3e 70 42 65 3b 0a 20 20  Be = db->pBe;.  
26d0: 73 50 61 72 73 65 2e 78 43 61 6c 6c 62 61 63 6b  sParse.xCallback
26e0: 20 3d 20 73 71 6c 69 74 65 49 6e 69 74 43 61 6c   = sqliteInitCal
26f0: 6c 62 61 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e  lback;.  sParse.
2700: 70 41 72 67 20 3d 20 28 76 6f 69 64 2a 29 26 69  pArg = (void*)&i
2710: 6e 69 74 44 61 74 61 3b 0a 20 20 73 50 61 72 73  nitData;.  sPars
2720: 65 2e 69 6e 69 74 46 6c 61 67 20 3d 20 31 3b 0a  e.initFlag = 1;.
2730: 20 20 73 50 61 72 73 65 2e 75 73 65 43 61 6c 6c    sParse.useCall
2740: 62 61 63 6b 20 3d 20 31 3b 0a 20 20 73 71 6c 69  back = 1;.  sqli
2750: 74 65 52 75 6e 50 61 72 73 65 72 28 26 73 50 61  teRunParser(&sPa
2760: 72 73 65 2c 0a 20 20 20 20 20 20 64 62 2d 3e 66  rse,.      db->f
2770: 69 6c 65 5f 66 6f 72 6d 61 74 3e 3d 32 20 3f 20  ile_format>=2 ? 
2780: 69 6e 69 74 5f 73 63 72 69 70 74 20 3a 20 6f 6c  init_script : ol
2790: 64 65 72 5f 69 6e 69 74 5f 73 63 72 69 70 74 2c  der_init_script,
27a0: 0a 20 20 20 20 20 20 70 7a 45 72 72 4d 73 67 29  .      pzErrMsg)
27b0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d  ;.  if( sqlite_m
27c0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a  alloc_failed ){.
27d0: 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72      sqliteSetStr
27e0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f  ing(pzErrMsg, "o
27f0: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 30  ut of memory", 0
2800: 29 3b 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63  );.    sParse.rc
2810: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b   = SQLITE_NOMEM;
2820: 0a 20 20 20 20 73 71 6c 69 74 65 42 74 72 65 65  .    sqliteBtree
2830: 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 42 65  Rollback(db->pBe
2840: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73  );.    sqliteRes
2850: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
2860: 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  (db);.  }.  if( 
2870: 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49 54  sParse.rc==SQLIT
2880: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e  E_OK ){.    db->
2890: 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f  flags |= SQLITE_
28a0: 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 20 20 20  Initialized;.   
28b0: 20 73 71 6c 69 74 65 43 6f 6d 6d 69 74 49 6e 74   sqliteCommitInt
28c0: 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29  ernalChanges(db)
28d0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64  ;.  }else{.    d
28e0: 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c  b->flags &= ~SQL
28f0: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b  ITE_Initialized;
2900: 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73 65 74  .    sqliteReset
2910: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
2920: 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  b);.  }.  sqlite
2930: 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72  BtreeCloseCursor
2940: 28 63 75 72 4d 61 69 6e 29 3b 0a 20 20 72 65 74  (curMain);.  ret
2950: 75 72 6e 20 73 50 61 72 73 65 2e 72 63 3b 0a 7d  urn sParse.rc;.}
2960: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 76 65 72 73  ../*.** The vers
2970: 69 6f 6e 20 6f 66 20 74 68 65 20 6c 69 62 72 61  ion of the libra
2980: 72 79 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72  ry.*/.const char
2990: 20 72 63 73 69 64 5b 5d 20 3d 20 22 40 28 23 29   rcsid[] = "@(#)
29a0: 20 5c 30 34 34 49 64 3a 20 53 51 4c 69 74 65 20   \044Id: SQLite 
29b0: 76 65 72 73 69 6f 6e 20 22 20 53 51 4c 49 54 45  version " SQLITE
29c0: 5f 56 45 52 53 49 4f 4e 20 22 20 24 22 3b 0a 63  _VERSION " $";.c
29d0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
29e0: 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c  _version[] = SQL
29f0: 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a  ITE_VERSION;../*
2a00: 0a 2a 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62  .** Does the lib
2a10: 72 61 72 79 20 65 78 70 65 63 74 20 64 61 74 61  rary expect data
2a20: 20 74 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61   to be encoded a
2a30: 73 20 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38  s UTF-8 or iso88
2a40: 35 39 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c  59?  The.** foll
2a50: 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e  owing global con
2a60: 73 74 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74  stant always let
2a70: 73 20 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69  s us know..*/.#i
2a80: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38  fdef SQLITE_UTF8
2a90: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69  .const char sqli
2aa0: 74 65 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20  te_encoding[] = 
2ab0: 22 55 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63  "UTF-8";.#else.c
2ac0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65  onst char sqlite
2ad0: 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69  _encoding[] = "i
2ae0: 73 6f 38 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a  so8859";.#endif.
2af0: 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65  ./*.** Open a ne
2b00: 77 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  w SQLite databas
2b10: 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e  e.  Construct an
2b20: 20 22 73 71 6c 69 74 65 22 20 73 74 72 75 63 74   "sqlite" struct
2b30: 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a  ure to define.**
2b40: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68   the state of th
2b50: 69 73 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  is database and 
2b60: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  return a pointer
2b70: 20 74 6f 20 74 68 61 74 20 73 74 72 75 63 74 75   to that structu
2b80: 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74  re..**.** An att
2b90: 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20  empt is made to 
2ba0: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69  initialize the i
2bb0: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74  n-memory data st
2bc0: 72 75 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a  ructures that.**
2bd0: 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61   hold the databa
2be0: 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20  se schema.  But 
2bf0: 69 66 20 74 68 69 73 20 66 61 69 6c 73 20 28 62  if this fails (b
2c00: 65 63 61 75 73 65 20 74 68 65 20 73 63 68 65 6d  ecause the schem
2c10: 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63  a file.** is loc
2c20: 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74 20 73  ked) then that s
2c30: 74 65 70 20 69 73 20 64 65 66 65 72 72 65 64 20  tep is deferred 
2c40: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
2c50: 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74  call to.** sqlit
2c60: 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c  e_exec()..*/.sql
2c70: 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e  ite *sqlite_open
2c80: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
2c90: 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65  lename, int mode
2ca0: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73  , char **pzErrMs
2cb0: 67 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  g){.  sqlite *db
2cc0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f  ;.  int rc;..  /
2cd0: 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73  * Allocate the s
2ce0: 71 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63  qlite data struc
2cf0: 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73  ture */.  db = s
2d00: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
2d10: 65 6f 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20  eof(sqlite) );. 
2d20: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20   if( pzErrMsg ) 
2d30: 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20  *pzErrMsg = 0;. 
2d40: 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74   if( db==0 ) got
2d50: 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e  o no_mem_on_open
2d60: 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e  ;.  sqliteHashIn
2d70: 69 74 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c  it(&db->tblHash,
2d80: 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52   SQLITE_HASH_STR
2d90: 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74  ING, 0);.  sqlit
2da0: 65 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69  eHashInit(&db->i
2db0: 64 78 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48  dxHash, SQLITE_H
2dc0: 41 53 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a  ASH_STRING, 0);.
2dd0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74    sqliteHashInit
2de0: 28 26 64 62 2d 3e 74 72 69 67 48 61 73 68 2c 20  (&db->trigHash, 
2df0: 53 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49  SQLITE_HASH_STRI
2e00: 4e 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65  NG, 0);.  sqlite
2e10: 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 46  HashInit(&db->aF
2e20: 75 6e 63 2c 20 53 51 4c 49 54 45 5f 48 41 53 48  unc, SQLITE_HASH
2e30: 5f 53 54 52 49 4e 47 2c 20 31 29 3b 0a 20 20 73  _STRING, 1);.  s
2e40: 71 6c 69 74 65 48 61 73 68 49 6e 69 74 28 26 64  qliteHashInit(&d
2e50: 62 2d 3e 61 46 4b 65 79 2c 20 53 51 4c 49 54 45  b->aFKey, SQLITE
2e60: 5f 48 41 53 48 5f 53 54 52 49 4e 47 2c 20 31 29  _HASH_STRING, 1)
2e70: 3b 0a 20 20 64 62 2d 3e 6f 6e 45 72 72 6f 72 20  ;.  db->onError 
2e80: 3d 20 4f 45 5f 44 65 66 61 75 6c 74 3b 0a 20 20  = OE_Default;.  
2e90: 64 62 2d 3e 70 72 69 6f 72 4e 65 77 52 6f 77 69  db->priorNewRowi
2ea0: 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6d 61 67  d = 0;.  db->mag
2eb0: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49  ic = SQLITE_MAGI
2ec0: 43 5f 42 55 53 59 3b 0a 20 20 0a 20 20 2f 2a 20  C_BUSY;.  .  /* 
2ed0: 4f 70 65 6e 20 74 68 65 20 62 61 63 6b 65 6e 64  Open the backend
2ee0: 20 64 61 74 61 62 61 73 65 20 64 72 69 76 65 72   database driver
2ef0: 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74   */.  rc = sqlit
2f00: 65 42 74 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65  eBtreeOpen(zFile
2f10: 6e 61 6d 65 2c 20 30 2c 20 4d 41 58 5f 50 41 47  name, 0, MAX_PAG
2f20: 45 53 2c 20 26 64 62 2d 3e 70 42 65 29 3b 0a 20  ES, &db->pBe);. 
2f30: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
2f40: 4f 4b 20 29 7b 0a 20 20 20 20 73 77 69 74 63 68  OK ){.    switch
2f50: 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 64 65  ( rc ){.      de
2f60: 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 20  fault: {.       
2f70: 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67   sqliteSetString
2f80: 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e 61 62  (pzErrMsg, "unab
2f90: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62  le to open datab
2fa0: 61 73 65 3a 20 22 2c 20 7a 46 69 6c 65 6e 61 6d  ase: ", zFilenam
2fb0: 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20  e, 0);.      }. 
2fc0: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46     }.    sqliteF
2fd0: 72 65 65 28 64 62 29 3b 0a 20 20 20 20 73 71 6c  ree(db);.    sql
2fe0: 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a  iteStrRealloc(pz
2ff0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72 65 74  ErrMsg);.    ret
3000: 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  urn 0;.  }..  /*
3010: 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64   Attempt to read
3020: 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f 0a 20   the schema */. 
3030: 20 73 71 6c 69 74 65 52 65 67 69 73 74 65 72 42   sqliteRegisterB
3040: 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28  uiltinFunctions(
3050: 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  db);.  rc = sqli
3060: 74 65 49 6e 69 74 28 64 62 2c 20 70 7a 45 72 72  teInit(db, pzErr
3070: 4d 73 67 29 3b 0a 20 20 64 62 2d 3e 6d 61 67 69  Msg);.  db->magi
3080: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43  c = SQLITE_MAGIC
3090: 5f 4f 50 45 4e 3b 0a 20 20 69 66 28 20 73 71 6c  _OPEN;.  if( sql
30a0: 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65  ite_malloc_faile
30b0: 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f  d ){.    sqlite_
30c0: 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 67  close(db);.    g
30d0: 6f 74 6f 20 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70  oto no_mem_on_op
30e0: 65 6e 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  en;.  }else if( 
30f0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc!=SQLITE_OK &&
3100: 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59   rc!=SQLITE_BUSY
3110: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 5f 63   ){.    sqlite_c
3120: 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 73 71  lose(db);.    sq
3130: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
3140: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72 65  zErrMsg);.    re
3150: 74 75 72 6e 20 30 3b 0a 20 20 7d 65 6c 73 65 20  turn 0;.  }else 
3160: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
3170: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 2a      sqliteFree(*
3180: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 2a  pzErrMsg);.    *
3190: 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20  pzErrMsg = 0;.  
31a0: 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64  }..  /* If the d
31b0: 61 74 61 62 61 73 65 20 69 73 20 69 6e 20 66 6f  atabase is in fo
31c0: 72 6d 61 74 73 20 31 20 6f 72 20 32 2c 20 74 68  rmats 1 or 2, th
31d0: 65 6e 20 75 70 67 72 61 64 65 20 69 74 20 74 6f  en upgrade it to
31e0: 0a 20 20 2a 2a 20 76 65 72 73 69 6f 6e 20 33 2e  .  ** version 3.
31f0: 20 20 54 68 69 73 20 77 69 6c 6c 20 72 65 63 6f    This will reco
3200: 6e 73 74 72 75 63 74 20 61 6c 6c 20 69 6e 64 69  nstruct all indi
3210: 63 65 73 2e 20 20 49 66 20 74 68 65 0a 20 20 2a  ces.  If the.  *
3220: 2a 20 75 70 67 72 61 64 65 20 66 61 69 6c 73 20  * upgrade fails 
3230: 66 6f 72 20 61 6e 79 20 72 65 61 73 6f 6e 20 28  for any reason (
3240: 65 78 3a 20 6f 75 74 20 6f 66 20 64 69 73 6b 20  ex: out of disk 
3250: 73 70 61 63 65 2c 20 64 61 74 61 62 61 73 65 0a  space, database.
3260: 20 20 2a 2a 20 69 73 20 72 65 61 64 20 6f 6e 6c    ** is read onl
3270: 79 2c 20 69 6e 74 65 72 72 75 70 74 20 72 65 63  y, interrupt rec
3280: 65 69 76 65 64 2c 20 65 74 63 2e 29 20 74 68 65  eived, etc.) the
3290: 6e 20 72 65 66 75 73 65 20 74 6f 20 6f 70 65 6e  n refuse to open
32a0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d  ..  */.  if( rc=
32b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62  =SQLITE_OK && db
32c0: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3c 33 20  ->file_format<3 
32d0: 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 45 72  ){.    char *zEr
32e0: 72 20 3d 20 30 3b 0a 20 20 20 20 49 6e 69 74 44  r = 0;.    InitD
32f0: 61 74 61 20 69 6e 69 74 44 61 74 61 3b 0a 20 20  ata initData;.  
3300: 20 20 69 6e 74 20 6d 65 74 61 5b 53 51 4c 49 54    int meta[SQLIT
3310: 45 5f 4e 5f 42 54 52 45 45 5f 4d 45 54 41 5d 3b  E_N_BTREE_META];
3320: 0a 0a 20 20 20 20 69 6e 69 74 44 61 74 61 2e 64  ..    initData.d
3330: 62 20 3d 20 64 62 3b 0a 20 20 20 20 69 6e 69 74  b = db;.    init
3340: 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d 20  Data.pzErrMsg = 
3350: 26 7a 45 72 72 3b 0a 20 20 20 20 64 62 2d 3e 66  &zErr;.    db->f
3360: 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 33 3b 0a  ile_format = 3;.
3370: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 5f      rc = sqlite_
3380: 65 78 65 63 28 64 62 2c 0a 20 20 20 20 20 20 22  exec(db,.      "
3390: 42 45 47 49 4e 3b 20 53 45 4c 45 43 54 20 6e 61  BEGIN; SELECT na
33a0: 6d 65 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d  me FROM sqlite_m
33b0: 61 73 74 65 72 20 57 48 45 52 45 20 74 79 70 65  aster WHERE type
33c0: 3d 27 74 61 62 6c 65 27 3b 22 2c 0a 20 20 20 20  ='table';",.    
33d0: 20 20 75 70 67 72 61 64 65 5f 33 5f 63 61 6c 6c    upgrade_3_call
33e0: 62 61 63 6b 2c 0a 20 20 20 20 20 20 26 69 6e 69  back,.      &ini
33f0: 74 44 61 74 61 2c 0a 20 20 20 20 20 20 26 7a 45  tData,.      &zE
3400: 72 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d  rr);.    if( rc=
3410: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
3420: 20 20 20 20 73 71 6c 69 74 65 42 74 72 65 65 47      sqliteBtreeG
3430: 65 74 4d 65 74 61 28 64 62 2d 3e 70 42 65 2c 20  etMeta(db->pBe, 
3440: 6d 65 74 61 29 3b 0a 20 20 20 20 20 20 6d 65 74  meta);.      met
3450: 61 5b 32 5d 20 3d 20 34 3b 0a 20 20 20 20 20 20  a[2] = 4;.      
3460: 73 71 6c 69 74 65 42 74 72 65 65 55 70 64 61 74  sqliteBtreeUpdat
3470: 65 4d 65 74 61 28 64 62 2d 3e 70 42 65 2c 20 6d  eMeta(db->pBe, m
3480: 65 74 61 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  eta);.      sqli
3490: 74 65 5f 65 78 65 63 28 64 62 2c 20 22 43 4f 4d  te_exec(db, "COM
34a0: 4d 49 54 22 2c 20 30 2c 20 30 2c 20 30 29 3b 0a  MIT", 0, 0, 0);.
34b0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
34c0: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
34d0: 20 20 20 20 20 73 71 6c 69 74 65 53 65 74 53 74       sqliteSetSt
34e0: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 0a  ring(pzErrMsg, .
34f0: 20 20 20 20 20 20 20 20 22 75 6e 61 62 6c 65 20          "unable 
3500: 74 6f 20 75 70 67 72 61 64 65 20 64 61 74 61 62  to upgrade datab
3510: 61 73 65 20 74 6f 20 74 68 65 20 76 65 72 73 69  ase to the versi
3520: 6f 6e 20 32 2e 36 20 66 6f 72 6d 61 74 22 2c 0a  on 2.6 format",.
3530: 20 20 20 20 20 20 20 20 7a 45 72 72 20 3f 20 22          zErr ? "
3540: 3a 20 22 20 3a 20 30 2c 20 7a 45 72 72 2c 20 30  : " : 0, zErr, 0
3550: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 5f  );.      sqlite_
3560: 66 72 65 65 6d 65 6d 28 7a 45 72 72 29 3b 0a 20  freemem(zErr);. 
3570: 20 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65       sqliteStrRe
3580: 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b  alloc(pzErrMsg);
3590: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 5f 63 6c  .      sqlite_cl
35a0: 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 20 20 72  ose(db);.      r
35b0: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20  eturn 0;.    }. 
35c0: 20 20 20 73 71 6c 69 74 65 5f 66 72 65 65 6d 65     sqlite_freeme
35d0: 6d 28 7a 45 72 72 29 3b 0a 20 20 7d 0a 0a 20 20  m(zErr);.  }..  
35e0: 2f 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e  /* Return a poin
35f0: 74 65 72 20 74 6f 20 74 68 65 20 6e 65 77 6c 79  ter to the newly
3600: 20 6f 70 65 6e 65 64 20 64 61 74 61 62 61 73 65   opened database
3610: 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20   structure */.  
3620: 72 65 74 75 72 6e 20 64 62 3b 0a 0a 6e 6f 5f 6d  return db;..no_m
3630: 65 6d 5f 6f 6e 5f 6f 70 65 6e 3a 0a 20 20 73 71  em_on_open:.  sq
3640: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a  liteSetString(pz
3650: 45 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20  ErrMsg, "out of 
3660: 6d 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 73  memory", 0);.  s
3670: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28  qliteStrRealloc(
3680: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74  pzErrMsg);.  ret
3690: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
36a0: 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49 44  Return the ROWID
36b0: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63   of the most rec
36c0: 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a 69 6e  ent insert.*/.in
36d0: 74 20 73 71 6c 69 74 65 5f 6c 61 73 74 5f 69 6e  t sqlite_last_in
36e0: 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74  sert_rowid(sqlit
36f0: 65 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e  e *db){.  return
3700: 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a   db->lastRowid;.
3710: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
3720: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68  the number of ch
3730: 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73  anges in the mos
3740: 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f  t recent call to
3750: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 29 2e 0a   sqlite_exec()..
3760: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 68  */.int sqlite_ch
3770: 61 6e 67 65 73 28 73 71 6c 69 74 65 20 2a 64 62  anges(sqlite *db
3780: 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e  ){.  return db->
3790: 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a  nChange;.}../*.*
37a0: 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 73 74  * Close an exist
37b0: 69 6e 67 20 53 51 4c 69 74 65 20 64 61 74 61 62  ing SQLite datab
37c0: 61 73 65 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ase.*/.void sqli
37d0: 74 65 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65 20  te_close(sqlite 
37e0: 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d  *db){.  HashElem
37f0: 20 2a 69 3b 0a 20 20 69 66 28 20 73 71 6c 69 74   *i;.  if( sqlit
3800: 65 53 61 66 65 74 79 43 68 65 63 6b 28 64 62 29  eSafetyCheck(db)
3810: 20 7c 7c 20 73 71 6c 69 74 65 53 61 66 65 74 79   || sqliteSafety
3820: 4f 6e 28 64 62 29 20 29 7b 20 72 65 74 75 72 6e  On(db) ){ return
3830: 3b 20 7d 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20  ; }.  db->magic 
3840: 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43  = SQLITE_MAGIC_C
3850: 4c 4f 53 45 44 3b 0a 20 20 73 71 6c 69 74 65 42  LOSED;.  sqliteB
3860: 74 72 65 65 43 6c 6f 73 65 28 64 62 2d 3e 70 42  treeClose(db->pB
3870: 65 29 3b 0a 20 20 73 71 6c 69 74 65 52 65 73 65  e);.  sqliteRese
3880: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28  tInternalSchema(
3890: 64 62 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 70  db);.  if( db->p
38a0: 42 65 54 65 6d 70 20 29 7b 0a 20 20 20 20 73 71  BeTemp ){.    sq
38b0: 6c 69 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64  liteBtreeClose(d
38c0: 62 2d 3e 70 42 65 54 65 6d 70 29 3b 0a 20 20 7d  b->pBeTemp);.  }
38d0: 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48  .  for(i=sqliteH
38e0: 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 46  ashFirst(&db->aF
38f0: 75 6e 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74  unc); i; i=sqlit
3900: 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20  eHashNext(i)){. 
3910: 20 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e     FuncDef *pFun
3920: 63 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 20 20 66  c, *pNext;.    f
3930: 6f 72 28 70 46 75 6e 63 20 3d 20 28 46 75 6e 63  or(pFunc = (Func
3940: 44 65 66 2a 29 73 71 6c 69 74 65 48 61 73 68 44  Def*)sqliteHashD
3950: 61 74 61 28 69 29 3b 20 70 46 75 6e 63 3b 20 70  ata(i); pFunc; p
3960: 46 75 6e 63 3d 70 4e 65 78 74 29 7b 0a 20 20 20  Func=pNext){.   
3970: 20 20 20 70 4e 65 78 74 20 3d 20 70 46 75 6e 63     pNext = pFunc
3980: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 73  ->pNext;.      s
3990: 71 6c 69 74 65 46 72 65 65 28 70 46 75 6e 63 29  qliteFree(pFunc)
39a0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71  ;.    }.  }.  sq
39b0: 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28 26 64  liteHashClear(&d
39c0: 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 73 71 6c  b->aFunc);.  sql
39d0: 69 74 65 48 61 73 68 43 6c 65 61 72 28 26 64 62  iteHashClear(&db
39e0: 2d 3e 61 46 4b 65 79 29 3b 0a 20 20 73 71 6c 69  ->aFKey);.  sqli
39f0: 74 65 46 72 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f  teFree(db);.}../
3a00: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45  *.** Return TRUE
3a10: 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 53 51   if the given SQ
3a20: 4c 20 73 74 72 69 6e 67 20 65 6e 64 73 20 69 6e  L string ends in
3a30: 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 2e 0a 2a 2a   a semicolon..**
3a40: 0a 2a 2a 20 53 70 65 63 69 61 6c 20 68 61 6e 64  .** Special hand
3a50: 6c 69 6e 67 20 69 73 20 72 65 71 75 69 72 65 20  ling is require 
3a60: 66 6f 72 20 43 52 45 41 54 45 20 54 52 49 47 47  for CREATE TRIGG
3a70: 45 52 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a  ER statements..*
3a80: 2a 20 57 68 65 6e 65 76 65 72 20 74 68 65 20 43  * Whenever the C
3a90: 52 45 41 54 45 20 54 52 49 47 47 45 52 20 6b 65  REATE TRIGGER ke
3aa0: 79 77 6f 72 64 73 20 61 72 65 20 73 65 65 6e 2c  ywords are seen,
3ab0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a   the statement.*
3ac0: 2a 20 6d 75 73 74 20 65 6e 64 20 77 69 74 68 20  * must end with 
3ad0: 22 3b 45 4e 44 3b 22 2e 0a 2a 2f 0a 69 6e 74 20  ";END;"..*/.int 
3ae0: 73 71 6c 69 74 65 5f 63 6f 6d 70 6c 65 74 65 28  sqlite_complete(
3af0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c  const char *zSql
3b00: 29 7b 0a 20 20 69 6e 74 20 69 73 43 6f 6d 70 6c  ){.  int isCompl
3b10: 65 74 65 20 3d 20 31 3b 0a 20 20 69 6e 74 20 72  ete = 1;.  int r
3b20: 65 71 75 69 72 65 45 6e 64 20 3d 20 30 3b 0a 20  equireEnd = 0;. 
3b30: 20 69 6e 74 20 73 65 65 6e 54 65 78 74 20 3d 20   int seenText = 
3b40: 30 3b 0a 20 20 69 6e 74 20 73 65 65 6e 43 72 65  0;.  int seenCre
3b50: 61 74 65 20 3d 20 30 3b 0a 20 20 77 68 69 6c 65  ate = 0;.  while
3b60: 28 20 2a 7a 53 71 6c 20 29 7b 0a 20 20 20 20 73  ( *zSql ){.    s
3b70: 77 69 74 63 68 28 20 2a 7a 53 71 6c 20 29 7b 0a  witch( *zSql ){.
3b80: 20 20 20 20 20 20 63 61 73 65 20 27 3b 27 3a 20        case ';': 
3b90: 7b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70  {.        isComp
3ba0: 6c 65 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20  lete = 1;.      
3bb0: 20 20 73 65 65 6e 54 65 78 74 20 3d 20 31 3b 0a    seenText = 1;.
3bc0: 20 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61          seenCrea
3bd0: 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  te = 0;.        
3be0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
3bf0: 20 20 20 20 20 63 61 73 65 20 27 20 27 3a 0a 20       case ' ':. 
3c00: 20 20 20 20 20 63 61 73 65 20 27 5c 74 27 3a 0a       case '\t':.
3c10: 20 20 20 20 20 20 63 61 73 65 20 27 5c 6e 27 3a        case '\n':
3c20: 0a 20 20 20 20 20 20 63 61 73 65 20 27 5c 66 27  .      case '\f'
3c30: 3a 20 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61  : {.        brea
3c40: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
3c50: 20 63 61 73 65 20 27 5b 27 3a 20 7b 0a 20 20 20   case '[': {.   
3c60: 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20       isComplete 
3c70: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 73 65 65  = 0;.        see
3c80: 6e 54 65 78 74 20 3d 20 31 3b 0a 20 20 20 20 20  nText = 1;.     
3c90: 20 20 20 73 65 65 6e 43 72 65 61 74 65 20 3d 20     seenCreate = 
3ca0: 30 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b  0;.        zSql+
3cb0: 2b 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65  +;.        while
3cc0: 28 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c  ( *zSql && *zSql
3cd0: 21 3d 27 5d 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b  !=']' ){ zSql++;
3ce0: 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a   }.        if( *
3cf0: 7a 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e  zSql==0 ) return
3d00: 20 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61   0;.        brea
3d10: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
3d20: 20 63 61 73 65 20 27 22 27 3a 0a 20 20 20 20 20   case '"':.     
3d30: 20 63 61 73 65 20 27 5c 27 27 3a 20 7b 0a 20 20   case '\'': {.  
3d40: 20 20 20 20 20 20 69 6e 74 20 63 20 3d 20 2a 7a        int c = *z
3d50: 53 71 6c 3b 0a 20 20 20 20 20 20 20 20 69 73 43  Sql;.        isC
3d60: 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20  omplete = 0;.   
3d70: 20 20 20 20 20 73 65 65 6e 54 65 78 74 20 3d 20       seenText = 
3d80: 31 3b 0a 20 20 20 20 20 20 20 20 73 65 65 6e 43  1;.        seenC
3d90: 72 65 61 74 65 20 3d 20 30 3b 0a 20 20 20 20 20  reate = 0;.     
3da0: 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20     zSql++;.     
3db0: 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20     while( *zSql 
3dc0: 26 26 20 2a 7a 53 71 6c 21 3d 63 20 29 7b 20 7a  && *zSql!=c ){ z
3dd0: 53 71 6c 2b 2b 3b 20 7d 0a 20 20 20 20 20 20 20  Sql++; }.       
3de0: 20 69 66 28 20 2a 7a 53 71 6c 3d 3d 30 20 29 20   if( *zSql==0 ) 
3df0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20  return 0;.      
3e00: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
3e10: 0a 20 20 20 20 20 20 63 61 73 65 20 27 2d 27 3a  .      case '-':
3e20: 20 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a   {.        if( z
3e30: 53 71 6c 5b 31 5d 21 3d 27 2d 27 20 29 7b 0a 20  Sql[1]!='-' ){. 
3e40: 20 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c           isCompl
3e50: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ete = 0;.       
3e60: 20 20 20 73 65 65 6e 43 72 65 61 74 65 20 3d 20     seenCreate = 
3e70: 30 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65  0;.          bre
3e80: 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ak;.        }.  
3e90: 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53        while( *zS
3ea0: 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c 6e  ql && *zSql!='\n
3eb0: 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20  ' ){ zSql++; }. 
3ec0: 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c         if( *zSql
3ed0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 73 65 65  ==0 ) return see
3ee0: 6e 54 65 78 74 20 26 26 20 69 73 43 6f 6d 70 6c  nText && isCompl
3ef0: 65 74 65 20 26 26 20 72 65 71 75 69 72 65 45 6e  ete && requireEn
3f00: 64 3d 3d 30 3b 0a 20 20 20 20 20 20 20 20 62 72  d==0;.        br
3f10: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eak;.      }.   
3f20: 20 20 20 63 61 73 65 20 27 63 27 3a 0a 20 20 20     case 'c':.   
3f30: 20 20 20 63 61 73 65 20 27 43 27 3a 20 7b 0a 20     case 'C': {. 
3f40: 20 20 20 20 20 20 20 73 65 65 6e 54 65 78 74 20         seenText 
3f50: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 69 66 28  = 1;.        if(
3f60: 20 21 69 73 43 6f 6d 70 6c 65 74 65 20 29 20 62   !isComplete ) b
3f70: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 69 73  reak;.        is
3f80: 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20  Complete = 0;.  
3f90: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65        if( sqlite
3fa0: 53 74 72 4e 49 43 6d 70 28 7a 53 71 6c 2c 20 22  StrNICmp(zSql, "
3fb0: 63 72 65 61 74 65 22 2c 20 36 29 21 3d 30 20 29  create", 6)!=0 )
3fc0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
3fd0: 69 66 28 20 21 69 73 73 70 61 63 65 28 7a 53 71  if( !isspace(zSq
3fe0: 6c 5b 36 5d 29 20 29 20 62 72 65 61 6b 3b 0a 20  l[6]) ) break;. 
3ff0: 20 20 20 20 20 20 20 7a 53 71 6c 20 2b 3d 20 35         zSql += 5
4000: 3b 0a 20 20 20 20 20 20 20 20 73 65 65 6e 43 72  ;.        seenCr
4010: 65 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20  eate = 1;.      
4020: 20 20 77 68 69 6c 65 28 20 69 73 73 70 61 63 65    while( isspace
4030: 28 7a 53 71 6c 5b 31 5d 29 20 29 20 7a 53 71 6c  (zSql[1]) ) zSql
4040: 2b 2b 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  ++;.        if( 
4050: 73 71 6c 69 74 65 53 74 72 4e 49 43 6d 70 28 26  sqliteStrNICmp(&
4060: 7a 53 71 6c 5b 31 5d 2c 22 74 72 69 67 67 65 72  zSql[1],"trigger
4070: 22 2c 20 37 29 21 3d 30 20 29 20 62 72 65 61 6b  ", 7)!=0 ) break
4080: 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 20 2b  ;.        zSql +
4090: 3d 20 37 3b 0a 20 20 20 20 20 20 20 20 72 65 71  = 7;.        req
40a0: 75 69 72 65 45 6e 64 2b 2b 3b 0a 20 20 20 20 20  uireEnd++;.     
40b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
40c0: 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 74 27  }.      case 't'
40d0: 3a 0a 20 20 20 20 20 20 63 61 73 65 20 27 54 27  :.      case 'T'
40e0: 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 65 65 6e  : {.        seen
40f0: 54 65 78 74 20 3d 20 31 3b 0a 20 20 20 20 20 20  Text = 1;.      
4100: 20 20 69 66 28 20 21 73 65 65 6e 43 72 65 61 74    if( !seenCreat
4110: 65 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  e ) break;.     
4120: 20 20 20 73 65 65 6e 43 72 65 61 74 65 20 3d 20     seenCreate = 
4130: 30 3b 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d  0;.        isCom
4140: 70 6c 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20  plete = 0;.     
4150: 20 20 20 69 66 28 20 73 71 6c 69 74 65 53 74 72     if( sqliteStr
4160: 4e 49 43 6d 70 28 7a 53 71 6c 2c 20 22 74 72 69  NICmp(zSql, "tri
4170: 67 67 65 72 22 2c 20 37 29 21 3d 30 20 29 20 62  gger", 7)!=0 ) b
4180: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 69 66  reak;.        if
4190: 28 20 21 69 73 73 70 61 63 65 28 7a 53 71 6c 5b  ( !isspace(zSql[
41a0: 37 5d 29 20 29 20 62 72 65 61 6b 3b 0a 20 20 20  7]) ) break;.   
41b0: 20 20 20 20 20 7a 53 71 6c 20 2b 3d 20 36 3b 0a       zSql += 6;.
41c0: 20 20 20 20 20 20 20 20 72 65 71 75 69 72 65 45          requireE
41d0: 6e 64 2b 2b 3b 0a 20 20 20 20 20 20 20 20 62 72  nd++;.        br
41e0: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eak;.      }.   
41f0: 20 20 20 63 61 73 65 20 27 65 27 3a 0a 20 20 20     case 'e':.   
4200: 20 20 20 63 61 73 65 20 27 45 27 3a 20 7b 0a 20     case 'E': {. 
4210: 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61 74         seenCreat
4220: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 73  e = 0;.        s
4230: 65 65 6e 54 65 78 74 20 3d 20 31 3b 0a 20 20 20  eenText = 1;.   
4240: 20 20 20 20 20 69 66 28 20 21 69 73 43 6f 6d 70       if( !isComp
4250: 6c 65 74 65 20 29 20 62 72 65 61 6b 3b 0a 20 20  lete ) break;.  
4260: 20 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65        isComplete
4270: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 69 66   = 0;.        if
4280: 28 20 72 65 71 75 69 72 65 45 6e 64 3d 3d 30 20  ( requireEnd==0 
4290: 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20  ) break;.       
42a0: 20 69 66 28 20 73 71 6c 69 74 65 53 74 72 4e 49   if( sqliteStrNI
42b0: 43 6d 70 28 7a 53 71 6c 2c 20 22 65 6e 64 22 2c  Cmp(zSql, "end",
42c0: 20 33 29 21 3d 30 20 29 20 62 72 65 61 6b 3b 0a   3)!=0 ) break;.
42d0: 20 20 20 20 20 20 20 20 7a 53 71 6c 20 2b 3d 20          zSql += 
42e0: 32 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65  2;.        while
42f0: 28 20 69 73 73 70 61 63 65 28 7a 53 71 6c 5b 31  ( isspace(zSql[1
4300: 5d 29 20 29 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20  ]) ) zSql++;.   
4310: 20 20 20 20 20 69 66 28 20 7a 53 71 6c 5b 31 5d       if( zSql[1]
4320: 3d 3d 27 3b 27 20 29 7b 0a 20 20 20 20 20 20 20  ==';' ){.       
4330: 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20 20 20 20     zSql++;.     
4340: 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20       isComplete 
4350: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 72  = 1;.          r
4360: 65 71 75 69 72 65 45 6e 64 2d 2d 3b 0a 20 20 20  equireEnd--;.   
4370: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 62       }.        b
4380: 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20  reak;.      }.  
4390: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
43a0: 20 20 20 20 20 20 20 73 65 65 6e 43 72 65 61 74         seenCreat
43b0: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 73  e = 0;.        s
43c0: 65 65 6e 54 65 78 74 20 3d 20 31 3b 0a 20 20 20  eenText = 1;.   
43d0: 20 20 20 20 20 69 73 43 6f 6d 70 6c 65 74 65 20       isComplete 
43e0: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65  = 0;.        bre
43f0: 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ak;.      }.    
4400: 7d 0a 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 20  }.    zSql++;.  
4410: 7d 0a 20 20 72 65 74 75 72 6e 20 73 65 65 6e 54  }.  return seenT
4420: 65 78 74 20 26 26 20 69 73 43 6f 6d 70 6c 65 74  ext && isComplet
4430: 65 20 26 26 20 72 65 71 75 69 72 65 45 6e 64 3d  e && requireEnd=
4440: 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  =0;.}../*.** Thi
4450: 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74  s routine does t
4460: 68 65 20 77 6f 72 6b 20 6f 66 20 65 69 74 68 65  he work of eithe
4470: 72 20 73 71 6c 69 74 65 5f 65 78 65 63 28 29 20  r sqlite_exec() 
4480: 6f 72 20 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c  or sqlite_compil
4490: 65 28 29 2e 0a 2a 2a 20 49 74 20 77 6f 72 6b 73  e()..** It works
44a0: 20 6c 69 6b 65 20 73 71 6c 69 74 65 5f 65 78 65   like sqlite_exe
44b0: 63 28 29 20 69 66 20 70 56 6d 3d 3d 4e 55 4c 4c  c() if pVm==NULL
44c0: 20 61 6e 64 20 69 74 20 77 6f 72 6b 73 20 6c 69   and it works li
44d0: 6b 65 20 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c  ke sqlite_compil
44e0: 65 28 29 0a 2a 2a 20 6f 74 68 65 72 77 69 73 65  e().** otherwise
44f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
4500: 73 71 6c 69 74 65 4d 61 69 6e 28 0a 20 20 73 71  sqliteMain(.  sq
4510: 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20 20  lite *db,       
4520: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
4530: 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68 69   database on whi
4540: 63 68 20 74 68 65 20 53 51 4c 20 65 78 65 63 75  ch the SQL execu
4550: 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  tes */.  const c
4560: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
4570: 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20       /* The SQL 
4580: 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 2a  to be executed *
4590: 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 6c 6c 62  /.  sqlite_callb
45a0: 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b 2c 20 20  ack xCallback,  
45b0: 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 73 20 63  /* Invoke this c
45c0: 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20  allback routine 
45d0: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 2c  */.  void *pArg,
45e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
45f0: 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65   /* First argume
4600: 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28  nt to xCallback(
4610: 29 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61  ) */.  const cha
4620: 72 20 2a 2a 70 7a 54 61 69 6c 2c 20 20 20 20 20  r **pzTail,     
4630: 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20     /* OUT: Next 
4640: 73 74 61 74 65 6d 65 6e 74 20 61 66 74 65 72 20  statement after 
4650: 74 68 65 20 66 69 72 73 74 20 2a 2f 0a 20 20 73  the first */.  s
4660: 71 6c 69 74 65 5f 76 6d 20 2a 2a 70 70 56 6d 2c  qlite_vm **ppVm,
4670: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
4680: 54 3a 20 54 68 65 20 76 69 72 74 75 61 6c 20 6d  T: The virtual m
4690: 61 63 68 69 6e 65 20 2a 2f 0a 20 20 63 68 61 72  achine */.  char
46a0: 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20   **pzErrMsg     
46b0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
46c0: 57 72 69 74 65 20 65 72 72 6f 72 20 6d 65 73 73  Write error mess
46d0: 61 67 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a  ages here */.){.
46e0: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a    Parse sParse;.
46f0: 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20  .  if( pzErrMsg 
4700: 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b  ) *pzErrMsg = 0;
4710: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 53 61 66  .  if( sqliteSaf
4720: 65 74 79 4f 6e 28 64 62 29 20 29 20 67 6f 74 6f  etyOn(db) ) goto
4730: 20 65 78 65 63 5f 6d 69 73 75 73 65 3b 0a 20 20   exec_misuse;.  
4740: 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20 26  if( (db->flags &
4750: 20 53 51 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69   SQLITE_Initiali
4760: 7a 65 64 29 3d 3d 30 20 29 7b 0a 20 20 20 20 69  zed)==0 ){.    i
4770: 6e 74 20 72 63 2c 20 63 6e 74 20 3d 20 31 3b 0a  nt rc, cnt = 1;.
4780: 20 20 20 20 77 68 69 6c 65 28 20 28 72 63 20 3d      while( (rc =
4790: 20 73 71 6c 69 74 65 49 6e 69 74 28 64 62 2c 20   sqliteInit(db, 
47a0: 70 7a 45 72 72 4d 73 67 29 29 3d 3d 53 51 4c 49  pzErrMsg))==SQLI
47b0: 54 45 5f 42 55 53 59 0a 20 20 20 20 20 20 20 26  TE_BUSY.       &
47c0: 26 20 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62  & db->xBusyCallb
47d0: 61 63 6b 20 26 26 20 64 62 2d 3e 78 42 75 73 79  ack && db->xBusy
47e0: 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 42 75  Callback(db->pBu
47f0: 73 79 41 72 67 2c 20 22 22 2c 20 63 6e 74 2b 2b  syArg, "", cnt++
4800: 29 21 3d 30 20 29 7b 7d 0a 20 20 20 20 69 66 28  )!=0 ){}.    if(
4810: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
4820: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 53 74  {.      sqliteSt
4830: 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73  rRealloc(pzErrMs
4840: 67 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  g);.      sqlite
4850: 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20  SafetyOff(db);. 
4860: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
4870: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 7a      }.    if( pz
4880: 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20  ErrMsg ){.      
4890: 73 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72  sqliteFree(*pzEr
48a0: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 2a 70 7a  rMsg);.      *pz
48b0: 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20  ErrMsg = 0;.    
48c0: 7d 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e  }.  }.  if( db->
48d0: 66 69 6c 65 5f 66 6f 72 6d 61 74 3c 33 20 29 7b  file_format<3 ){
48e0: 0a 20 20 20 20 73 71 6c 69 74 65 53 61 66 65 74  .    sqliteSafet
48f0: 79 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 73 71  yOff(db);.    sq
4900: 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a  liteSetString(pz
4910: 45 72 72 4d 73 67 2c 20 22 6f 62 73 6f 6c 65 74  ErrMsg, "obsolet
4920: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
4930: 66 6f 72 6d 61 74 22 2c 20 30 29 3b 0a 20 20 20  format", 0);.   
4940: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45   return SQLITE_E
4950: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20  RROR;.  }.  if( 
4960: 64 62 2d 3e 70 56 64 62 65 3d 3d 30 20 29 7b 20  db->pVdbe==0 ){ 
4970: 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b  db->nChange = 0;
4980: 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61   }.  memset(&sPa
4990: 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73  rse, 0, sizeof(s
49a0: 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73  Parse));.  sPars
49b0: 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 50 61  e.db = db;.  sPa
49c0: 72 73 65 2e 70 42 65 20 3d 20 64 62 2d 3e 70 42  rse.pBe = db->pB
49d0: 65 3b 0a 20 20 73 50 61 72 73 65 2e 78 43 61 6c  e;.  sParse.xCal
49e0: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63  lback = xCallbac
49f0: 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70 41 72 67  k;.  sParse.pArg
4a00: 20 3d 20 70 41 72 67 3b 0a 20 20 73 50 61 72 73   = pArg;.  sPars
4a10: 65 2e 75 73 65 43 61 6c 6c 62 61 63 6b 20 3d 20  e.useCallback = 
4a20: 70 70 56 6d 3d 3d 30 3b 0a 23 69 66 6e 64 65 66  ppVm==0;.#ifndef
4a30: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41   SQLITE_OMIT_TRA
4a40: 43 45 0a 20 20 69 66 28 20 64 62 2d 3e 78 54 72  CE.  if( db->xTr
4a50: 61 63 65 20 29 20 64 62 2d 3e 78 54 72 61 63 65  ace ) db->xTrace
4a60: 28 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20  (db->pTraceArg, 
4a70: 7a 53 71 6c 29 3b 0a 23 65 6e 64 69 66 0a 20 20  zSql);.#endif.  
4a80: 73 71 6c 69 74 65 52 75 6e 50 61 72 73 65 72 28  sqliteRunParser(
4a90: 26 73 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 70  &sParse, zSql, p
4aa0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20  zErrMsg);.  if( 
4ab0: 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61  sqlite_malloc_fa
4ac0: 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69  iled ){.    sqli
4ad0: 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  teSetString(pzEr
4ae0: 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d 65  rMsg, "out of me
4af0: 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 20 20 73  mory", 0);.    s
4b00: 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54  Parse.rc = SQLIT
4b10: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 6c  E_NOMEM;.    sql
4b20: 69 74 65 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  iteBtreeRollback
4b30: 28 64 62 2d 3e 70 42 65 29 3b 0a 20 20 20 20 69  (db->pBe);.    i
4b40: 66 28 20 64 62 2d 3e 70 42 65 54 65 6d 70 20 29  f( db->pBeTemp )
4b50: 20 73 71 6c 69 74 65 42 74 72 65 65 52 6f 6c 6c   sqliteBtreeRoll
4b60: 62 61 63 6b 28 64 62 2d 3e 70 42 65 54 65 6d 70  back(db->pBeTemp
4b70: 29 3b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67 73  );.    db->flags
4b80: 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e 54 72   &= ~SQLITE_InTr
4b90: 61 6e 73 3b 0a 20 20 20 20 73 71 6c 69 74 65 52  ans;.    sqliteR
4ba0: 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65  esetInternalSche
4bb0: 6d 61 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66  ma(db);.  }.  if
4bc0: 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c  ( sParse.rc==SQL
4bd0: 49 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73  ITE_DONE ) sPars
4be0: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  e.rc = SQLITE_OK
4bf0: 3b 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72  ;.  if( sParse.r
4c00: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c!=SQLITE_OK && 
4c10: 70 7a 45 72 72 4d 73 67 20 26 26 20 2a 70 7a 45  pzErrMsg && *pzE
4c20: 72 72 4d 73 67 3d 3d 30 20 29 7b 0a 20 20 20 20  rrMsg==0 ){.    
4c30: 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28  sqliteSetString(
4c40: 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74 65  pzErrMsg, sqlite
4c50: 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 73 50  _error_string(sP
4c60: 61 72 73 65 2e 72 63 29 2c 20 30 29 3b 0a 20 20  arse.rc), 0);.  
4c70: 7d 0a 20 20 73 71 6c 69 74 65 53 74 72 52 65 61  }.  sqliteStrRea
4c80: 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a  lloc(pzErrMsg);.
4c90: 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d    if( sParse.rc=
4ca0: 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29  =SQLITE_SCHEMA )
4cb0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 52 65 73 65  {.    sqliteRese
4cc0: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28  tInternalSchema(
4cd0: 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73  db);.  }.  if( s
4ce0: 50 61 72 73 65 2e 75 73 65 43 61 6c 6c 62 61 63  Parse.useCallbac
4cf0: 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65  k==0 ){.    asse
4d00: 72 74 28 20 70 70 56 6d 20 29 3b 0a 20 20 20 20  rt( ppVm );.    
4d10: 2a 70 70 56 6d 20 3d 20 28 73 71 6c 69 74 65 5f  *ppVm = (sqlite_
4d20: 76 6d 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65  vm*)sParse.pVdbe
4d30: 3b 0a 20 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20  ;.    *pzTail = 
4d40: 73 50 61 72 73 65 2e 7a 54 61 69 6c 3b 0a 20 20  sParse.zTail;.  
4d50: 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 53 61  }.  if( sqliteSa
4d60: 66 65 74 79 4f 66 66 28 64 62 29 20 29 20 67 6f  fetyOff(db) ) go
4d70: 74 6f 20 65 78 65 63 5f 6d 69 73 75 73 65 3b 0a  to exec_misuse;.
4d80: 20 20 72 65 74 75 72 6e 20 73 50 61 72 73 65 2e    return sParse.
4d90: 72 63 3b 0a 0a 65 78 65 63 5f 6d 69 73 75 73 65  rc;..exec_misuse
4da0: 3a 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67  :.  if( pzErrMsg
4db0: 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73   ){.    *pzErrMs
4dc0: 67 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74  g = 0;.    sqlit
4dd0: 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  eSetString(pzErr
4de0: 4d 73 67 2c 20 73 71 6c 69 74 65 5f 65 72 72 6f  Msg, sqlite_erro
4df0: 72 5f 73 74 72 69 6e 67 28 53 51 4c 49 54 45 5f  r_string(SQLITE_
4e00: 4d 49 53 55 53 45 29 2c 20 30 29 3b 0a 20 20 20  MISUSE), 0);.   
4e10: 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f   sqliteStrReallo
4e20: 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d  c(pzErrMsg);.  }
4e30: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
4e40: 5f 4d 49 53 55 53 45 3b 0a 7d 0a 0a 2f 2a 0a 2a  _MISUSE;.}../*.*
4e50: 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20 63 6f  * Execute SQL co
4e60: 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65 20  de.  Return one 
4e70: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 73  of the SQLITE_ s
4e80: 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 0a 2a  uccess/failure.*
4e90: 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f 20 77  * codes.  Also w
4ea0: 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65  rite an error me
4eb0: 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d 6f 72  ssage into memor
4ec0: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a  y obtained from.
4ed0: 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e 64 20  ** malloc() and 
4ee0: 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67 20 70  make *pzErrMsg p
4ef0: 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d 65 73  oint to that mes
4f00: 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74  sage..**.** If t
4f10: 68 65 20 53 51 4c 20 69 73 20 61 20 71 75 65 72  he SQL is a quer
4f20: 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61 63 68  y, then for each
4f30: 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75 65 72   row in the quer
4f40: 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68 65 20  y result.** the 
4f50: 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75 6e 63  xCallback() func
4f60: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 20  tion is called. 
4f70: 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20 74 68   pArg becomes th
4f80: 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d  e first.** argum
4f90: 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b  ent to xCallback
4fa0: 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62 61 63  ().  If xCallbac
4fb0: 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f 20 63  k=NULL then no c
4fc0: 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 69 6e  allback.** is in
4fd0: 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f 72 20  voked, even for 
4fe0: 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e 74 20  queries..*/.int 
4ff0: 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20 20 73  sqlite_exec(.  s
5000: 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20 20  qlite *db,      
5010: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
5020: 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68  e database on wh
5030: 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 65 63  ich the SQL exec
5040: 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  utes */.  const 
5050: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20  char *zSql,     
5060: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c        /* The SQL
5070: 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20   to be executed 
5080: 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 6c 6c  */.  sqlite_call
5090: 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b 2c 20  back xCallback, 
50a0: 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 73 20   /* Invoke this 
50b0: 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65  callback routine
50c0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67   */.  void *pArg
50d0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
50e0: 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d    /* First argum
50f0: 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b  ent to xCallback
5100: 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  () */.  char **p
5110: 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20 20  zErrMsg         
5120: 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 72 72      /* Write err
5130: 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72 65  or messages here
5140: 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20   */.){.  return 
5150: 73 71 6c 69 74 65 4d 61 69 6e 28 64 62 2c 20 7a  sqliteMain(db, z
5160: 53 71 6c 2c 20 78 43 61 6c 6c 62 61 63 6b 2c 20  Sql, xCallback, 
5170: 70 41 72 67 2c 20 30 2c 20 30 2c 20 70 7a 45 72  pArg, 0, 0, pzEr
5180: 72 4d 73 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rMsg);.}../*.** 
5190: 43 6f 6d 70 69 6c 65 20 61 20 73 69 6e 67 6c 65  Compile a single
51a0: 20 73 74 61 74 65 6d 65 6e 74 20 6f 66 20 53 51   statement of SQ
51b0: 4c 20 69 6e 74 6f 20 61 20 76 69 72 74 75 61 6c  L into a virtual
51c0: 20 6d 61 63 68 69 6e 65 2e 20 20 52 65 74 75 72   machine.  Retur
51d0: 6e 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20  n one.** of the 
51e0: 53 51 4c 49 54 45 5f 20 73 75 63 63 65 73 73 2f  SQLITE_ success/
51f0: 66 61 69 6c 75 72 65 20 63 6f 64 65 73 2e 20 20  failure codes.  
5200: 41 6c 73 6f 20 77 72 69 74 65 20 61 6e 20 65 72  Also write an er
5210: 72 6f 72 20 6d 65 73 73 61 67 65 20 69 6e 74 6f  ror message into
5220: 0a 2a 2a 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69  .** memory obtai
5230: 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28  ned from malloc(
5240: 29 20 61 6e 64 20 6d 61 6b 65 20 2a 70 7a 45 72  ) and make *pzEr
5250: 72 4d 73 67 20 70 6f 69 6e 74 20 74 6f 20 74 68  rMsg point to th
5260: 61 74 20 6d 65 73 73 61 67 65 2e 0a 2a 2f 0a 69  at message..*/.i
5270: 6e 74 20 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c  nt sqlite_compil
5280: 65 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c  e(.  sqlite *db,
5290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
52a0: 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65   /* The database
52b0: 20 6f 6e 20 77 68 69 63 68 20 74 68 65 20 53 51   on which the SQ
52c0: 4c 20 65 78 65 63 75 74 65 73 20 2a 2f 0a 20 20  L executes */.  
52d0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c  const char *zSql
52e0: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  ,           /* T
52f0: 68 65 20 53 51 4c 20 74 6f 20 62 65 20 65 78 65  he SQL to be exe
5300: 63 75 74 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74  cuted */.  const
5310: 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 2c 20   char **pzTail, 
5320: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4e         /* OUT: N
5330: 65 78 74 20 73 74 61 74 65 6d 65 6e 74 20 61 66  ext statement af
5340: 74 65 72 20 74 68 65 20 66 69 72 73 74 20 2a 2f  ter the first */
5350: 0a 20 20 73 71 6c 69 74 65 5f 76 6d 20 2a 2a 70  .  sqlite_vm **p
5360: 70 56 6d 2c 20 20 20 20 20 20 20 20 20 20 20 2f  pVm,           /
5370: 2a 20 4f 55 54 3a 20 54 68 65 20 76 69 72 74 75  * OUT: The virtu
5380: 61 6c 20 6d 61 63 68 69 6e 65 20 2a 2f 0a 20 20  al machine */.  
5390: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 20  char **pzErrMsg 
53a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f              /* O
53b0: 55 54 3a 20 57 72 69 74 65 20 65 72 72 6f 72 20  UT: Write error 
53c0: 6d 65 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f  messages here */
53d0: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  .){.  return sql
53e0: 69 74 65 4d 61 69 6e 28 64 62 2c 20 7a 53 71 6c  iteMain(db, zSql
53f0: 2c 20 30 2c 20 30 2c 20 70 7a 54 61 69 6c 2c 20  , 0, 0, pzTail, 
5400: 70 70 56 6d 2c 20 70 7a 45 72 72 4d 73 67 29 3b  ppVm, pzErrMsg);
5410: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  .}../*.** The fo
5420: 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20  llowing routine 
5430: 64 65 73 74 72 6f 79 73 20 61 20 76 69 72 74 75  destroys a virtu
5440: 61 6c 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20  al machine that 
5450: 69 73 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a  is created by.**
5460: 20 74 68 65 20 73 71 6c 69 74 65 5f 63 6f 6d 70   the sqlite_comp
5470: 69 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 0a 2a  ile() routine..*
5480: 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 67 65 72  *.** The integer
5490: 20 72 65 74 75 72 6e 65 64 20 69 73 20 61 6e 20   returned is an 
54a0: 53 51 4c 49 54 45 5f 20 73 75 63 63 65 73 73 2f  SQLITE_ success/
54b0: 66 61 69 6c 75 72 65 20 63 6f 64 65 20 74 68 61  failure code tha
54c0: 74 20 64 65 73 63 72 69 62 65 73 0a 2a 2a 20 74  t describes.** t
54d0: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 65 78 65  he result of exe
54e0: 63 75 74 69 6e 67 20 74 68 65 20 76 69 72 74 75  cuting the virtu
54f0: 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20 41 6e 20  al machine.  An 
5500: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73  error message is
5510: 0a 2a 2a 20 77 72 69 74 74 65 6e 20 69 6e 74 6f  .** written into
5520: 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64   memory obtained
5530: 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 20 61 6e 64   from malloc and
5540: 20 2a 70 7a 45 72 72 4d 73 67 20 69 73 20 6d 61   *pzErrMsg is ma
5550: 64 65 20 74 6f 0a 2a 2a 20 70 6f 69 6e 74 20 74  de to.** point t
5560: 6f 20 74 68 61 74 20 65 72 72 6f 72 20 69 66 20  o that error if 
5570: 70 7a 45 72 72 4d 73 67 20 69 73 20 6e 6f 74 20  pzErrMsg is not 
5580: 4e 55 4c 4c 2e 20 20 54 68 65 20 63 61 6c 6c 69  NULL.  The calli
5590: 6e 67 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 73 68  ng routine.** sh
55a0: 6f 75 6c 64 20 75 73 65 20 73 71 6c 69 74 65 5f  ould use sqlite_
55b0: 66 72 65 65 6d 65 6d 28 29 20 74 6f 20 64 65 6c  freemem() to del
55c0: 65 74 65 20 74 68 65 20 6d 65 73 73 61 67 65 20  ete the message 
55d0: 77 68 65 6e 20 69 74 20 68 61 73 20 66 69 6e 69  when it has fini
55e0: 73 68 65 64 0a 2a 2a 20 77 69 74 68 20 69 74 2e  shed.** with it.
55f0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 66  .*/.int sqlite_f
5600: 69 6e 61 6c 69 7a 65 28 0a 20 20 73 71 6c 69 74  inalize(.  sqlit
5610: 65 5f 76 6d 20 2a 70 56 6d 2c 20 20 20 20 20 20  e_vm *pVm,      
5620: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72        /* The vir
5630: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 74 6f 20  tual machine to 
5640: 62 65 20 64 65 73 74 72 6f 79 65 64 20 2a 2f 0a  be destroyed */.
5650: 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73    char **pzErrMs
5660: 67 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  g            /* 
5670: 4f 55 54 3a 20 57 72 69 74 65 20 65 72 72 6f 72  OUT: Write error
5680: 20 6d 65 73 73 61 67 65 73 20 68 65 72 65 20 2a   messages here *
5690: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20  /.){.  int rc = 
56a0: 73 71 6c 69 74 65 56 64 62 65 46 69 6e 61 6c 69  sqliteVdbeFinali
56b0: 7a 65 28 28 56 64 62 65 2a 29 70 56 6d 2c 20 70  ze((Vdbe*)pVm, p
56c0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 73 71 6c 69  zErrMsg);.  sqli
56d0: 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45  teStrRealloc(pzE
56e0: 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e  rrMsg);.  return
56f0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65   rc;.}../*.** Re
5700: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74  turn a static st
5710: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69  ring that descri
5720: 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20  bes the kind of 
5730: 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20  error specified 
5740: 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65  in the.** argume
5750: 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  nt..*/.const cha
5760: 72 20 2a 73 71 6c 69 74 65 5f 65 72 72 6f 72 5f  r *sqlite_error_
5770: 73 74 72 69 6e 67 28 69 6e 74 20 72 63 29 7b 0a  string(int rc){.
5780: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b    const char *z;
5790: 0a 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b  .  switch( rc ){
57a0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
57b0: 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 7a 20 3d  _OK:         z =
57c0: 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 3b   "not an error";
57d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
57e0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
57f0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5800: 5f 45 52 52 4f 52 3a 20 20 20 20 20 20 7a 20 3d  _ERROR:      z =
5810: 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f   "SQL logic erro
5820: 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74  r or missing dat
5830: 61 62 61 73 65 22 3b 20 20 20 62 72 65 61 6b 3b  abase";   break;
5840: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5850: 5f 49 4e 54 45 52 4e 41 4c 3a 20 20 20 7a 20 3d  _INTERNAL:   z =
5860: 20 22 69 6e 74 65 72 6e 61 6c 20 53 51 4c 69 74   "internal SQLit
5870: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
5880: 20 66 6c 61 77 22 3b 20 20 20 62 72 65 61 6b 3b   flaw";   break;
5890: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
58a0: 5f 50 45 52 4d 3a 20 20 20 20 20 20 20 7a 20 3d  _PERM:       z =
58b0: 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 73   "access permiss
58c0: 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20  ion denied";    
58d0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
58e0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
58f0: 5f 41 42 4f 52 54 3a 20 20 20 20 20 20 7a 20 3d  _ABORT:      z =
5900: 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 75 65   "callback reque
5910: 73 74 65 64 20 71 75 65 72 79 20 61 62 6f 72 74  sted query abort
5920: 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ";        break;
5930: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5940: 5f 42 55 53 59 3a 20 20 20 20 20 20 20 7a 20 3d  _BUSY:       z =
5950: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f   "database is lo
5960: 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 20 20  cked";          
5970: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5980: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5990: 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 7a 20 3d  _LOCKED:     z =
59a0: 20 22 64 61 74 61 62 61 73 65 20 74 61 62 6c 65   "database table
59b0: 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 20 20 20   is locked";    
59c0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
59d0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
59e0: 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 7a 20 3d  _NOMEM:      z =
59f0: 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22   "out of memory"
5a00: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
5a10: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5a20: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5a30: 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 7a 20 3d  _READONLY:   z =
5a40: 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69   "attempt to wri
5a50: 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61  te a readonly da
5a60: 74 61 62 61 73 65 22 3b 20 20 62 72 65 61 6b 3b  tabase";  break;
5a70: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5a80: 5f 49 4e 54 45 52 52 55 50 54 3a 20 20 7a 20 3d  _INTERRUPT:  z =
5a90: 20 22 69 6e 74 65 72 72 75 70 74 65 64 22 3b 20   "interrupted"; 
5aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5ab0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5ac0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5ad0: 5f 49 4f 45 52 52 3a 20 20 20 20 20 20 7a 20 3d  _IOERR:      z =
5ae0: 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72   "disk I/O error
5af0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ";              
5b00: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5b10: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5b20: 5f 43 4f 52 52 55 50 54 3a 20 20 20 20 7a 20 3d  _CORRUPT:    z =
5b30: 20 22 64 61 74 61 62 61 73 65 20 64 69 73 6b 20   "database disk 
5b40: 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d  image is malform
5b50: 65 64 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b  ed";      break;
5b60: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5b70: 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20 7a 20 3d  _NOTFOUND:   z =
5b80: 20 22 74 61 62 6c 65 20 6f 72 20 72 65 63 6f 72   "table or recor
5b90: 64 20 6e 6f 74 20 66 6f 75 6e 64 22 3b 20 20 20  d not found";   
5ba0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5bb0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5bc0: 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 7a 20 3d  _FULL:       z =
5bd0: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 66 75   "database is fu
5be0: 6c 6c 22 3b 20 20 20 20 20 20 20 20 20 20 20 20  ll";            
5bf0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5c00: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5c10: 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 7a 20 3d  _CANTOPEN:   z =
5c20: 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e   "unable to open
5c30: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 3b   database file";
5c40: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5c50: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5c60: 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20 7a 20 3d  _PROTOCOL:   z =
5c70: 20 22 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69   "database locki
5c80: 6e 67 20 70 72 6f 74 6f 63 6f 6c 20 66 61 69 6c  ng protocol fail
5c90: 75 72 65 22 3b 20 20 20 20 20 62 72 65 61 6b 3b  ure";     break;
5ca0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5cb0: 5f 45 4d 50 54 59 3a 20 20 20 20 20 20 7a 20 3d  _EMPTY:      z =
5cc0: 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73   "table contains
5cd0: 20 6e 6f 20 64 61 74 61 22 3b 20 20 20 20 20 20   no data";      
5ce0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5cf0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5d00: 5f 53 43 48 45 4d 41 3a 20 20 20 20 20 7a 20 3d  _SCHEMA:     z =
5d10: 20 22 64 61 74 61 62 61 73 65 20 73 63 68 65 6d   "database schem
5d20: 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 3b 20  a has changed"; 
5d30: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5d40: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5d50: 5f 54 4f 4f 42 49 47 3a 20 20 20 20 20 7a 20 3d  _TOOBIG:     z =
5d60: 20 22 74 6f 6f 20 6d 75 63 68 20 64 61 74 61 20   "too much data 
5d70: 66 6f 72 20 6f 6e 65 20 74 61 62 6c 65 20 72 6f  for one table ro
5d80: 77 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b  w";       break;
5d90: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5da0: 5f 43 4f 4e 53 54 52 41 49 4e 54 3a 20 7a 20 3d  _CONSTRAINT: z =
5db0: 20 22 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69   "constraint fai
5dc0: 6c 65 64 22 3b 20 20 20 20 20 20 20 20 20 20 20  led";           
5dd0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5de0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5df0: 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20 7a 20 3d  _MISMATCH:   z =
5e00: 20 22 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61   "datatype misma
5e10: 74 63 68 22 3b 20 20 20 20 20 20 20 20 20 20 20  tch";           
5e20: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5e30: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5e40: 5f 4d 49 53 55 53 45 3a 20 20 20 20 20 7a 20 3d  _MISUSE:     z =
5e50: 20 22 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e   "library routin
5e60: 65 20 63 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20  e called out of 
5e70: 73 65 71 75 65 6e 63 65 22 3b 62 72 65 61 6b 3b  sequence";break;
5e80: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5e90: 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 20 7a 20 3d  _NOLFS:      z =
5ea0: 20 22 6b 65 72 6e 65 6c 20 6c 61 63 6b 73 20 6c   "kernel lacks l
5eb0: 61 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72  arge file suppor
5ec0: 74 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b  t";       break;
5ed0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
5ee0: 5f 41 55 54 48 3a 20 20 20 20 20 20 20 7a 20 3d  _AUTH:       z =
5ef0: 20 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20   "authorization 
5f00: 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 20 20  denied";        
5f10: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5f20: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 20 20  .    default:   
5f30: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 20 3d               z =
5f40: 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22   "unknown error"
5f50: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
5f60: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
5f70: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b  .  }.  return z;
5f80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
5f90: 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74  outine implement
5fa0: 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63  s a busy callbac
5fb0: 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e  k that sleeps an
5fc0: 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e  d tries.** again
5fd0: 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74   until a timeout
5fe0: 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 65   value is reache
5ff0: 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20  d.  The timeout 
6000: 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69  value is.** an i
6010: 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66  nteger number of
6020: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61   milliseconds pa
6030: 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 66  ssed in as the f
6040: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74  irst.** argument
6050: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
6060: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73  sqliteDefaultBus
6070: 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64  yCallback(. void
6080: 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20 20 20   *Timeout,      
6090: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20       /* Maximum 
60a0: 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74  amount of time t
60b0: 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e 73 74  o wait */. const
60c0: 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64 2c 20   char *NotUsed, 
60d0: 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65 20      /* The name 
60e0: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  of the table tha
60f0: 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20 69 6e  t is busy */. in
6100: 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20  t count         
6110: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
6120: 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20   of times table 
6130: 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f  has been busy */
6140: 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d  .){.#if SQLITE_M
6150: 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 0a 20  IN_SLEEP_MS==1. 
6160: 20 69 6e 74 20 64 65 6c 61 79 20 3d 20 31 30 3b   int delay = 10;
6170: 0a 20 20 69 6e 74 20 70 72 69 6f 72 5f 64 65 6c  .  int prior_del
6180: 61 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 74 69  ay = 0;.  int ti
6190: 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d  meout = (int)Tim
61a0: 65 6f 75 74 3b 0a 20 20 69 6e 74 20 69 3b 0a 0a  eout;.  int i;..
61b0: 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 63 6f 75    for(i=1; i<cou
61c0: 6e 74 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 70  nt; i++){ .    p
61d0: 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 64 65  rior_delay += de
61e0: 6c 61 79 3b 0a 20 20 20 20 64 65 6c 61 79 20 3d  lay;.    delay =
61f0: 20 64 65 6c 61 79 2a 32 3b 0a 20 20 20 20 69 66   delay*2;.    if
6200: 28 20 64 65 6c 61 79 3e 3d 31 30 30 30 20 29 7b  ( delay>=1000 ){
6210: 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d 20 31  .      delay = 1
6220: 30 30 30 3b 0a 20 20 20 20 20 20 70 72 69 6f 72  000;.      prior
6230: 5f 64 65 6c 61 79 20 2b 3d 20 31 30 30 30 2a 28  _delay += 1000*(
6240: 63 6f 75 6e 74 20 2d 20 69 20 2d 20 31 29 3b 0a  count - i - 1);.
6250: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
6260: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 69   }.  }.  if( pri
6270: 6f 72 5f 64 65 6c 61 79 20 2b 20 64 65 6c 61 79  or_delay + delay
6280: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20   > timeout ){.  
6290: 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75    delay = timeou
62a0: 74 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 79 3b  t - prior_delay;
62b0: 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d  .    if( delay<=
62c0: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
62d0: 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c 65 65  }.  sqliteOsSlee
62e0: 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 74 75  p(delay);.  retu
62f0: 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 69 6e  rn 1;.#else.  in
6300: 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74  t timeout = (int
6310: 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20  )Timeout;.  if( 
6320: 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e  (count+1)*1000 >
6330: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20   timeout ){.    
6340: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
6350: 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 31 30  sqliteOsSleep(10
6360: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b  00);.  return 1;
6370: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a  .#endif.}../*.**
6380: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
6390: 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c  ts the busy call
63a0: 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69  back for an Sqli
63b0: 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74  te database to t
63c0: 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c  he.** given call
63d0: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69  back function wi
63e0: 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67  th the given arg
63f0: 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ument..*/.void s
6400: 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c  qlite_busy_handl
6410: 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  er(.  sqlite *db
6420: 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29  ,.  int (*xBusy)
6430: 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61  (void*,const cha
6440: 72 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20  r*,int),.  void 
6450: 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e 78  *pArg.){.  db->x
6460: 42 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d 20 78  BusyCallback = x
6470: 42 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 75 73  Busy;.  db->pBus
6480: 79 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a 0a  yArg = pArg;.}..
6490: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
64a0: 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65  ne installs a de
64b0: 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c  fault busy handl
64c0: 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f  er that waits fo
64d0: 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69  r the.** specifi
64e0: 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c  ed number of mil
64f0: 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65  liseconds before
6500: 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f   returning 0..*/
6510: 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73  .void sqlite_bus
6520: 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65  y_timeout(sqlite
6530: 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20   *db, int ms){. 
6540: 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20   if( ms>0 ){.   
6550: 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e   sqlite_busy_han
6560: 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44  dler(db, sqliteD
6570: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61  efaultBusyCallba
6580: 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 3b 0a  ck, (void*)ms);.
6590: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c    }else{.    sql
65a0: 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72  ite_busy_handler
65b0: 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a  (db, 0, 0);.  }.
65c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61  }../*.** Cause a
65d0: 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61  ny pending opera
65e0: 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20  tion to stop at 
65f0: 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70  its earliest opp
6600: 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69  ortunity..*/.voi
6610: 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 72 75  d sqlite_interru
6620: 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 7b 0a  pt(sqlite *db){.
6630: 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53    db->flags |= S
6640: 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 74 3b  QLITE_Interrupt;
6650: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77  .}../*.** Window
6660: 73 20 73 79 73 74 65 6d 73 20 73 68 6f 75 6c 64  s systems should
6670: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69   call this routi
6680: 6e 65 20 74 6f 20 66 72 65 65 20 6d 65 6d 6f 72  ne to free memor
6690: 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 72 65 74  y that.** is ret
66a0: 75 72 6e 65 64 20 69 6e 20 74 68 65 20 69 6e 20  urned in the in 
66b0: 74 68 65 20 65 72 72 6d 73 67 20 70 61 72 61 6d  the errmsg param
66c0: 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 5f 6f  eter of sqlite_o
66d0: 70 65 6e 28 29 20 77 68 65 6e 0a 2a 2a 20 53 51  pen() when.** SQ
66e0: 4c 69 74 65 20 69 73 20 61 20 44 4c 4c 2e 20 20  Lite is a DLL.  
66f0: 46 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 2c  For some reason,
6700: 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72   it does not wor
6710: 6b 20 74 6f 20 63 61 6c 6c 20 66 72 65 65 28 29  k to call free()
6720: 0a 2a 2a 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2a  .** directly..**
6730: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 77 65  .** Note that we
6740: 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 66 72   need to call fr
6750: 65 65 28 29 20 6e 6f 74 20 73 71 6c 69 74 65 46  ee() not sqliteF
6760: 72 65 65 28 29 20 68 65 72 65 2c 20 73 69 6e 63  ree() here, sinc
6770: 65 20 65 76 65 72 79 0a 2a 2a 20 73 74 72 69 6e  e every.** strin
6780: 67 20 74 68 61 74 20 69 73 20 65 78 70 6f 72 74  g that is export
6790: 65 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 20 73  ed from SQLite s
67a0: 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61  hould have alrea
67b0: 64 79 20 70 61 73 73 65 64 20 74 68 72 6f 75 67  dy passed throug
67c0: 68 0a 2a 2a 20 73 71 6c 69 74 65 53 74 72 52 65  h.** sqliteStrRe
67d0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a 76 6f 69 64  alloc()..*/.void
67e0: 20 73 71 6c 69 74 65 5f 66 72 65 65 6d 65 6d 28   sqlite_freemem(
67f0: 76 6f 69 64 20 2a 70 29 7b 20 66 72 65 65 28 70  void *p){ free(p
6800: 29 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64  ); }../*.** Wind
6810: 6f 77 73 20 73 79 73 74 65 6d 73 20 6e 65 65 64  ows systems need
6820: 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 63 61   functions to ca
6830: 6c 6c 20 74 6f 20 72 65 74 75 72 6e 20 74 68 65  ll to return the
6840: 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 0a   sqlite_version.
6850: 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 5f 65 6e  ** and sqlite_en
6860: 63 6f 64 69 6e 67 20 73 74 72 69 6e 67 73 20 73  coding strings s
6870: 69 6e 63 65 20 74 68 65 79 20 61 72 65 20 75 6e  ince they are un
6880: 61 62 6c 65 20 74 6f 20 61 63 63 65 73 73 20 63  able to access c
6890: 6f 6e 73 74 61 6e 74 73 0a 2a 2a 20 77 69 74 68  onstants.** with
68a0: 69 6e 20 44 4c 4c 73 2e 0a 2a 2f 0a 63 6f 6e 73  in DLLs..*/.cons
68b0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c  t char *sqlite_l
68c0: 69 62 76 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b  ibversion(void){
68d0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 76   return sqlite_v
68e0: 65 72 73 69 6f 6e 3b 20 7d 0a 63 6f 6e 73 74 20  ersion; }.const 
68f0: 63 68 61 72 20 2a 73 71 6c 69 74 65 5f 6c 69 62  char *sqlite_lib
6900: 65 6e 63 6f 64 69 6e 67 28 76 6f 69 64 29 7b 20  encoding(void){ 
6910: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 5f 65 6e  return sqlite_en
6920: 63 6f 64 69 6e 67 3b 20 7d 0a 0a 2f 2a 0a 2a 2a  coding; }../*.**
6930: 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72   Create new user
6940: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
6950: 6e 73 2e 20 20 54 68 65 20 73 71 6c 69 74 65 5f  ns.  The sqlite_
6960: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
6970: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 63 72 65  ).** routine cre
6980: 61 74 65 73 20 61 20 72 65 67 75 6c 61 72 20 66  ates a regular f
6990: 75 6e 63 74 69 6f 6e 20 61 6e 64 20 73 71 6c 69  unction and sqli
69a0: 74 65 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67  te_create_aggreg
69b0: 61 74 65 28 29 0a 2a 2a 20 63 72 65 61 74 65 73  ate().** creates
69c0: 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75   an aggregate fu
69d0: 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61  nction..**.** Pa
69e0: 73 73 69 6e 67 20 61 20 4e 55 4c 4c 20 78 46 75  ssing a NULL xFu
69f0: 6e 63 20 61 72 67 75 6d 65 6e 74 20 6f 72 20 4e  nc argument or N
6a00: 55 4c 4c 20 78 53 74 65 70 20 61 6e 64 20 78 46  ULL xStep and xF
6a10: 69 6e 61 6c 69 7a 65 20 61 72 67 75 6d 65 6e 74  inalize argument
6a20: 73 0a 2a 2a 20 64 69 73 61 62 6c 65 73 20 74 68  s.** disables th
6a30: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 43 61 6c  e function.  Cal
6a40: 6c 69 6e 67 20 73 71 6c 69 74 65 5f 63 72 65 61  ling sqlite_crea
6a50: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 20 77 69  te_function() wi
6a60: 74 68 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 6e  th the.** same n
6a70: 61 6d 65 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f  ame and number o
6a80: 66 20 61 72 67 75 6d 65 6e 74 73 20 61 73 20 61  f arguments as a
6a90: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 0a 2a   prior call to.*
6aa0: 2a 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  * sqlite_create_
6ab0: 61 67 67 72 65 67 61 74 65 28 29 20 64 69 73 61  aggregate() disa
6ac0: 62 6c 65 73 20 74 68 65 20 70 72 69 6f 72 20 63  bles the prior c
6ad0: 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65  all to.** sqlite
6ae0: 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74  _create_aggregat
6af0: 65 28 29 2c 20 61 6e 64 20 76 69 63 65 20 76 65  e(), and vice ve
6b00: 72 73 61 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 41  rsa..**.** If nA
6b10: 72 67 20 69 73 20 2d 31 20 69 74 20 6d 65 61 6e  rg is -1 it mean
6b20: 73 20 74 68 61 74 20 74 68 69 73 20 66 75 6e 63  s that this func
6b30: 74 69 6f 6e 20 77 69 6c 6c 20 61 63 63 65 70 74  tion will accept
6b40: 20 61 6e 79 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f   any number.** o
6b50: 66 20 61 72 67 75 6d 65 6e 74 73 2c 20 69 6e 63  f arguments, inc
6b60: 6c 75 64 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74  luding 0..*/.int
6b70: 20 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66   sqlite_create_f
6b80: 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74  unction(.  sqlit
6b90: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
6ba0: 2f 2a 20 41 64 64 20 74 68 65 20 66 75 6e 63 74  /* Add the funct
6bb0: 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61  ion to this data
6bc0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
6bd0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
6be0: 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d  *zName,   /* Nam
6bf0: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f  e of the functio
6c00: 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e  n to add */.  in
6c10: 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20  t nArg,         
6c20: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
6c30: 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76  arguments */.  v
6c40: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c  oid (*xFunc)(sql
6c50: 69 74 65 5f 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f  ite_func*,int,co
6c60: 6e 73 74 20 63 68 61 72 2a 2a 29 2c 20 20 2f 2a  nst char**),  /*
6c70: 20 54 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   The implementat
6c80: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  ion */.  void *p
6c90: 55 73 65 72 44 61 74 61 20 20 20 20 20 20 2f 2a  UserData      /*
6ca0: 20 55 73 65 72 20 64 61 74 61 20 2a 2f 0a 29 7b   User data */.){
6cb0: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b 0a 20  .  FuncDef *p;. 
6cc0: 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20 69 66   int nName;.  if
6cd0: 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61 6d 65  ( db==0 || zName
6ce0: 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 53 61 66  ==0 || sqliteSaf
6cf0: 65 74 79 43 68 65 63 6b 28 64 62 29 20 29 20 72  etyCheck(db) ) r
6d00: 65 74 75 72 6e 20 31 3b 0a 20 20 6e 4e 61 6d 65  eturn 1;.  nName
6d10: 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29   = strlen(zName)
6d20: 3b 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e 32 35  ;.  if( nName>25
6d30: 35 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20  5 ) return 1;.  
6d40: 70 20 3d 20 73 71 6c 69 74 65 46 69 6e 64 46 75  p = sqliteFindFu
6d50: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65  nction(db, zName
6d60: 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 31  , nName, nArg, 1
6d70: 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  );.  if( p==0 ) 
6d80: 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d 3e 78  return 1;.  p->x
6d90: 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20  Func = xFunc;.  
6da0: 70 2d 3e 78 53 74 65 70 20 3d 20 30 3b 0a 20 20  p->xStep = 0;.  
6db0: 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 30  p->xFinalize = 0
6dc0: 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61  ;.  p->pUserData
6dd0: 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20   = pUserData;.  
6de0: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 69 6e 74 20  return 0;.}.int 
6df0: 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 61 67  sqlite_create_ag
6e00: 67 72 65 67 61 74 65 28 0a 20 20 73 71 6c 69 74  gregate(.  sqlit
6e10: 65 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  e *db,          
6e20: 2f 2a 20 41 64 64 20 74 68 65 20 66 75 6e 63 74  /* Add the funct
6e30: 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61  ion to this data
6e40: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
6e50: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
6e60: 2a 7a 4e 61 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d  *zName,   /* Nam
6e70: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f  e of the functio
6e80: 6e 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 69 6e  n to add */.  in
6e90: 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20 20  t nArg,         
6ea0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
6eb0: 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 76  arguments */.  v
6ec0: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c  oid (*xStep)(sql
6ed0: 69 74 65 5f 66 75 6e 63 2a 2c 69 6e 74 2c 63 6f  ite_func*,int,co
6ee0: 6e 73 74 20 63 68 61 72 2a 2a 29 2c 20 2f 2a 20  nst char**), /* 
6ef0: 54 68 65 20 73 74 65 70 20 66 75 6e 63 74 69 6f  The step functio
6f00: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46  n */.  void (*xF
6f10: 69 6e 61 6c 69 7a 65 29 28 73 71 6c 69 74 65 5f  inalize)(sqlite_
6f20: 66 75 6e 63 2a 29 2c 20 20 20 20 20 20 20 20 20  func*),         
6f30: 20 20 20 20 20 2f 2a 20 54 68 65 20 66 69 6e 61       /* The fina
6f40: 6c 69 7a 65 72 20 2a 2f 0a 20 20 76 6f 69 64 20  lizer */.  void 
6f50: 2a 70 55 73 65 72 44 61 74 61 20 20 20 20 20 20  *pUserData      
6f60: 2f 2a 20 55 73 65 72 20 64 61 74 61 20 2a 2f 0a  /* User data */.
6f70: 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 3b  ){.  FuncDef *p;
6f80: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20  .  int nName;.  
6f90: 69 66 28 20 64 62 3d 3d 30 20 7c 7c 20 7a 4e 61  if( db==0 || zNa
6fa0: 6d 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 53  me==0 || sqliteS
6fb0: 61 66 65 74 79 43 68 65 63 6b 28 64 62 29 20 29  afetyCheck(db) )
6fc0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 6e 4e 61   return 1;.  nNa
6fd0: 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 4e 61 6d  me = strlen(zNam
6fe0: 65 29 3b 0a 20 20 69 66 28 20 6e 4e 61 6d 65 3e  e);.  if( nName>
6ff0: 32 35 35 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  255 ) return 1;.
7000: 20 20 70 20 3d 20 73 71 6c 69 74 65 46 69 6e 64    p = sqliteFind
7010: 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61  Function(db, zNa
7020: 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c  me, nName, nArg,
7030: 20 31 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20   1);.  if( p==0 
7040: 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 70 2d  ) return 1;.  p-
7050: 3e 78 46 75 6e 63 20 3d 20 30 3b 0a 20 20 70 2d  >xFunc = 0;.  p-
7060: 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a  >xStep = xStep;.
7070: 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d    p->xFinalize =
7080: 20 78 46 69 6e 61 6c 69 7a 65 3b 0a 20 20 70 2d   xFinalize;.  p-
7090: 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 55 73  >pUserData = pUs
70a0: 65 72 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e  erData;.  return
70b0: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61   0;.}../*.** Cha
70c0: 6e 67 65 20 74 68 65 20 64 61 74 61 74 79 70 65  nge the datatype
70d0: 20 66 6f 72 20 61 6c 6c 20 66 75 6e 63 74 69 6f   for all functio
70e0: 6e 73 20 77 69 74 68 20 61 20 67 69 76 65 6e 20  ns with a given 
70f0: 6e 61 6d 65 2e 20 20 53 65 65 20 74 68 65 0a 2a  name.  See the.*
7100: 2a 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74  * header comment
7110: 20 66 6f 72 20 74 68 65 20 70 72 6f 74 6f 74 79   for the prototy
7120: 70 65 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74  pe of this funct
7130: 69 6f 6e 20 69 6e 20 73 71 6c 69 74 65 2e 68 20  ion in sqlite.h 
7140: 66 6f 72 0a 2a 2a 20 61 64 64 69 74 69 6f 6e 61  for.** additiona
7150: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a  l information..*
7160: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 66 75 6e  /.int sqlite_fun
7170: 63 74 69 6f 6e 5f 74 79 70 65 28 73 71 6c 69 74  ction_type(sqlit
7180: 65 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61  e *db, const cha
7190: 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20 64 61  r *zName, int da
71a0: 74 61 54 79 70 65 29 7b 0a 20 20 46 75 6e 63 44  taType){.  FuncD
71b0: 65 66 20 2a 70 20 3d 20 28 46 75 6e 63 44 65 66  ef *p = (FuncDef
71c0: 2a 29 73 71 6c 69 74 65 48 61 73 68 46 69 6e 64  *)sqliteHashFind
71d0: 28 26 64 62 2d 3e 61 46 75 6e 63 2c 20 7a 4e 61  (&db->aFunc, zNa
71e0: 6d 65 2c 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65  me, strlen(zName
71f0: 29 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 20 29  ));.  while( p )
7200: 7b 0a 20 20 20 20 70 2d 3e 64 61 74 61 54 79 70  {.    p->dataTyp
7210: 65 20 3d 20 64 61 74 61 54 79 70 65 3b 20 0a 20  e = dataType; . 
7220: 20 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 3b     p = p->pNext;
7230: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51  .  }.  return SQ
7240: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
7250: 2a 20 52 65 67 69 73 74 65 72 20 61 20 74 72 61  * Register a tra
7260: 63 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68  ce function.  Th
7270: 65 20 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20  e pArg from the 
7280: 70 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73  previously regis
7290: 74 65 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69  tered trace.** i
72a0: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a  s returned.  .**
72b0: 0a 2a 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65  .** A NULL trace
72c0: 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20   function means 
72d0: 74 68 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20  that no tracing 
72e0: 69 73 20 65 78 65 63 75 74 65 73 2e 20 20 41 20  is executes.  A 
72f0: 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63  non-NULL.** trac
7300: 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74  e is a pointer t
7310: 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61  o a function tha
7320: 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20  t is invoked at 
7330: 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 61 63  the start of eac
7340: 68 0a 2a 2a 20 73 71 6c 69 74 65 5f 65 78 65 63  h.** sqlite_exec
7350: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c  ()..*/.void *sql
7360: 69 74 65 5f 74 72 61 63 65 28 73 71 6c 69 74 65  ite_trace(sqlite
7370: 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72   *db, void (*xTr
7380: 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74  ace)(void*,const
7390: 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70   char*), void *p
73a0: 41 72 67 29 7b 0a 23 69 66 6e 64 65 66 20 53 51  Arg){.#ifndef SQ
73b0: 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a  LITE_OMIT_TRACE.
73c0: 20 20 76 6f 69 64 20 2a 70 4f 6c 64 20 3d 20 64    void *pOld = d
73d0: 62 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20  b->pTraceArg;.  
73e0: 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72  db->xTrace = xTr
73f0: 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63  ace;.  db->pTrac
7400: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 72  eArg = pArg;.  r
7410: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 23 65 6c 73  eturn pOld;.#els
7420: 65 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 23 65  e.  return 0;.#e
7430: 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 41  ndif.}.../*.** A
7440: 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 74  ttempt to open t
7450: 68 65 20 66 69 6c 65 20 6e 61 6d 65 64 20 69 6e  he file named in
7460: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 61 73   the argument as
7470: 20 74 68 65 20 61 75 78 69 6c 69 61 72 79 20 64   the auxiliary d
7480: 61 74 61 62 61 73 65 0a 2a 2a 20 66 69 6c 65 2e  atabase.** file.
7490: 20 20 54 68 65 20 61 75 78 69 6c 69 61 72 79 20    The auxiliary 
74a0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73  database file is
74b0: 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 54   used to store T
74c0: 45 4d 50 20 74 61 62 6c 65 73 2e 20 20 42 75 74  EMP tables.  But
74d0: 0a 2a 2a 20 62 79 20 75 73 69 6e 67 20 74 68 69  .** by using thi
74e0: 73 20 41 50 49 2c 20 69 74 20 69 73 20 70 6f 73  s API, it is pos
74f0: 73 69 62 6c 65 20 74 6f 20 74 72 69 63 6b 20 53  sible to trick S
7500: 51 4c 69 74 65 20 69 6e 74 6f 20 6f 70 65 6e 69  QLite into openi
7510: 6e 67 20 74 77 6f 0a 2a 2a 20 73 65 70 61 72 61  ng two.** separa
7520: 74 65 20 64 61 74 61 62 61 73 65 73 20 61 6e 64  te databases and
7530: 20 61 63 74 69 6e 67 20 6f 6e 20 74 68 65 6d 20   acting on them 
7540: 61 73 20 69 66 20 74 68 65 79 20 77 65 72 65 20  as if they were 
7550: 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  one..**.** This 
7560: 72 6f 75 74 69 6e 65 20 63 6c 6f 73 65 73 20 74  routine closes t
7570: 68 65 20 65 78 69 73 74 69 6e 67 20 61 75 78 69  he existing auxi
7580: 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 20 66  liary database f
7590: 69 6c 65 2c 20 77 68 69 63 68 20 77 69 6c 6c 0a  ile, which will.
75a0: 2a 2a 20 63 61 75 73 65 20 61 6e 79 20 70 72 65  ** cause any pre
75b0: 76 69 6f 75 73 6c 79 20 63 72 65 61 74 65 64 20  viously created 
75c0: 54 45 4d 50 20 74 61 62 6c 65 73 20 74 6f 20 62  TEMP tables to b
75d0: 65 20 64 72 6f 70 70 65 64 2e 0a 2a 2a 0a 2a 2a  e dropped..**.**
75e0: 20 54 68 65 20 7a 4e 61 6d 65 20 70 61 72 61 6d   The zName param
75f0: 65 74 65 72 20 63 61 6e 20 62 65 20 61 20 4e 55  eter can be a NU
7600: 4c 4c 20 70 6f 69 6e 74 65 72 20 6f 72 20 61 6e  LL pointer or an
7610: 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20 74 6f   empty string to
7620: 20 63 61 75 73 65 0a 2a 2a 20 61 20 74 65 6d 70   cause.** a temp
7630: 6f 72 61 72 79 20 66 69 6c 65 20 74 6f 20 62 65  orary file to be
7640: 20 6f 70 65 6e 65 64 20 61 6e 64 20 61 75 74 6f   opened and auto
7650: 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65  matically delete
7660: 64 20 77 68 65 6e 20 63 6c 6f 73 65 64 2e 0a 2a  d when closed..*
7670: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 6f 70 65  /.int sqlite_ope
7680: 6e 5f 61 75 78 5f 66 69 6c 65 28 73 71 6c 69 74  n_aux_file(sqlit
7690: 65 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61  e *db, const cha
76a0: 72 20 2a 7a 4e 61 6d 65 2c 20 63 68 61 72 20 2a  r *zName, char *
76b0: 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e  *pzErrMsg){.  in
76c0: 74 20 72 63 3b 0a 20 20 69 66 28 20 7a 4e 61 6d  t rc;.  if( zNam
76d0: 65 20 26 26 20 7a 4e 61 6d 65 5b 30 5d 3d 3d 30  e && zName[0]==0
76e0: 20 29 20 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20 20   ) zName = 0;.  
76f0: 69 66 28 20 73 71 6c 69 74 65 53 61 66 65 74 79  if( sqliteSafety
7700: 4f 6e 28 64 62 29 20 29 20 67 6f 74 6f 20 6f 70  On(db) ) goto op
7710: 65 6e 61 75 78 5f 6d 69 73 75 73 65 3b 0a 20 20  enaux_misuse;.  
7720: 73 71 6c 69 74 65 52 65 73 65 74 49 6e 74 65 72  sqliteResetInter
7730: 6e 61 6c 53 63 68 65 6d 61 28 64 62 29 3b 0a 20  nalSchema(db);. 
7740: 20 69 66 28 20 64 62 2d 3e 70 42 65 54 65 6d 70   if( db->pBeTemp
7750: 21 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  !=0 ){.    sqlit
7760: 65 42 74 72 65 65 43 6c 6f 73 65 28 64 62 2d 3e  eBtreeClose(db->
7770: 70 42 65 54 65 6d 70 29 3b 0a 20 20 7d 0a 20 20  pBeTemp);.  }.  
7780: 72 63 20 3d 20 73 71 6c 69 74 65 42 74 72 65 65  rc = sqliteBtree
7790: 4f 70 65 6e 28 7a 4e 61 6d 65 2c 20 30 2c 20 4d  Open(zName, 0, M
77a0: 41 58 5f 50 41 47 45 53 2c 20 26 64 62 2d 3e 70  AX_PAGES, &db->p
77b0: 42 65 54 65 6d 70 29 3b 0a 20 20 69 66 28 20 72  BeTemp);.  if( r
77c0: 63 20 29 7b 0a 20 20 20 20 69 66 28 20 7a 4e 61  c ){.    if( zNa
77d0: 6d 65 3d 3d 30 20 29 20 7a 4e 61 6d 65 20 3d 20  me==0 ) zName = 
77e0: 22 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c  "a temporary fil
77f0: 65 22 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 65  e";.    sqliteSe
7800: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67  tString(pzErrMsg
7810: 2c 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65  , "unable to ope
7820: 6e 20 22 2c 20 7a 4e 61 6d 65 2c 20 0a 20 20 20  n ", zName, .   
7830: 20 20 20 22 3a 20 22 2c 20 73 71 6c 69 74 65 5f     ": ", sqlite_
7840: 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 72 63 29  error_string(rc)
7850: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
7860: 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72  StrRealloc(pzErr
7870: 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Msg);.    sqlite
7880: 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20  SafetyOff(db);. 
7890: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
78a0: 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 49  }.  rc = sqliteI
78b0: 6e 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67  nit(db, pzErrMsg
78c0: 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 53  );.  if( sqliteS
78d0: 61 66 65 74 79 4f 66 66 28 64 62 29 20 29 20 67  afetyOff(db) ) g
78e0: 6f 74 6f 20 6f 70 65 6e 61 75 78 5f 6d 69 73 75  oto openaux_misu
78f0: 73 65 3b 0a 20 20 73 71 6c 69 74 65 53 74 72 52  se;.  sqliteStrR
7900: 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29  ealloc(pzErrMsg)
7910: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a  ;.  return rc;..
7920: 6f 70 65 6e 61 75 78 5f 6d 69 73 75 73 65 3a 0a  openaux_misuse:.
7930: 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e    sqliteSetStrin
7940: 67 28 70 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69  g(pzErrMsg, sqli
7950: 74 65 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28  te_error_string(
7960: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 2c 20  SQLITE_MISUSE), 
7970: 30 29 3b 0a 20 20 73 71 6c 69 74 65 53 74 72 52  0);.  sqliteStrR
7980: 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29  ealloc(pzErrMsg)
7990: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
79a0: 45 5f 4d 49 53 55 53 45 3b 0a 7d 0a              E_MISUSE;.}.