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

Artifact 6686df1f9e88fb72c3b3fc660d4595382555fb5c:


0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 31 39 39 39 2c 20 32 30 30 30 20 44  (c) 1999, 2000 D
0020: 2e 20 52 69 63 68 61 72 64 20 48 69 70 70 0a 2a  . Richard Hipp.*
0030: 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61  *.** This progra
0040: 6d 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61  m is free softwa
0050: 72 65 3b 20 79 6f 75 20 63 61 6e 20 72 65 64 69  re; you can redi
0060: 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f  stribute it and/
0070: 6f 72 0a 2a 2a 20 6d 6f 64 69 66 79 20 69 74 20  or.** modify it 
0080: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20  under the terms 
0090: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72  of the GNU Gener
00a0: 61 6c 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63  al Public.** Lic
00b0: 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 65  ense as publishe
00c0: 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f  d by the Free So
00d0: 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f  ftware Foundatio
00e0: 6e 3b 20 65 69 74 68 65 72 0a 2a 2a 20 76 65 72  n; either.** ver
00f0: 73 69 6f 6e 20 32 20 6f 66 20 74 68 65 20 4c 69  sion 2 of the Li
0100: 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20 79 6f  cense, or (at yo
0110: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c  ur option) any l
0120: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2a 2a  ater version..**
0130: 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61 6d  .** This program
0140: 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20   is distributed 
0150: 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74  in the hope that
0160: 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66   it will be usef
0170: 75 6c 2c 0a 2a 2a 20 62 75 74 20 57 49 54 48 4f  ul,.** but WITHO
0180: 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b  UT ANY WARRANTY;
0190: 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68   without even th
01a0: 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e  e implied warran
01b0: 74 79 20 6f 66 0a 2a 2a 20 4d 45 52 43 48 41 4e  ty of.** MERCHAN
01c0: 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e  TABILITY or FITN
01d0: 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43  ESS FOR A PARTIC
01e0: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53  ULAR PURPOSE.  S
01f0: 65 65 20 74 68 65 20 47 4e 55 0a 2a 2a 20 47 65  ee the GNU.** Ge
0200: 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63  neral Public Lic
0210: 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65  ense for more de
0220: 74 61 69 6c 73 2e 0a 2a 2a 20 0a 2a 2a 20 59 6f  tails..** .** Yo
0230: 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65  u should have re
0240: 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66  ceived a copy of
0250: 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c   the GNU General
0260: 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e   Public.** Licen
0270: 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68  se along with th
0280: 69 73 20 6c 69 62 72 61 72 79 3b 20 69 66 20 6e  is library; if n
0290: 6f 74 2c 20 77 72 69 74 65 20 74 6f 20 74 68 65  ot, write to the
02a0: 0a 2a 2a 20 46 72 65 65 20 53 6f 66 74 77 61 72  .** Free Softwar
02b0: 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e  e Foundation, In
02c0: 63 2e 2c 20 35 39 20 54 65 6d 70 6c 65 20 50 6c  c., 59 Temple Pl
02d0: 61 63 65 20 2d 20 53 75 69 74 65 20 33 33 30 2c  ace - Suite 330,
02e0: 0a 2a 2a 20 42 6f 73 74 6f 6e 2c 20 4d 41 20 20  .** Boston, MA  
02f0: 30 32 31 31 31 2d 31 33 30 37 2c 20 55 53 41 2e  02111-1307, USA.
0300: 0a 2a 2a 0a 2a 2a 20 41 75 74 68 6f 72 20 63 6f  .**.** Author co
0310: 6e 74 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f  ntact informatio
0320: 6e 3a 0a 2a 2a 20 20 20 64 72 68 40 68 77 61 63  n:.**   drh@hwac
0330: 69 2e 63 6f 6d 0a 2a 2a 20 20 20 68 74 74 70 3a  i.com.**   http:
0340: 2f 2f 77 77 77 2e 68 77 61 63 69 2e 63 6f 6d 2f  //www.hwaci.com/
0350: 64 72 68 2f 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  drh/.**.********
0360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
03a0: 2a 0a 2a 2a 20 4d 61 69 6e 20 66 69 6c 65 20 66  *.** Main file f
03b0: 6f 72 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69  or the SQLite li
03c0: 62 72 61 72 79 2e 20 20 54 68 65 20 72 6f 75 74  brary.  The rout
03d0: 69 6e 65 73 20 69 6e 20 74 68 69 73 20 66 69 6c  ines in this fil
03e0: 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 20 74  e.** implement t
03f0: 68 65 20 70 72 6f 67 72 61 6d 6d 65 72 20 69 6e  he programmer in
0400: 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 6c  terface to the l
0410: 69 62 72 61 72 79 2e 20 20 52 6f 75 74 69 6e 65  ibrary.  Routine
0420: 73 20 69 6e 0a 2a 2a 20 6f 74 68 65 72 20 66 69  s in.** other fi
0430: 6c 65 73 20 61 72 65 20 66 6f 72 20 69 6e 74 65  les are for inte
0440: 72 6e 61 6c 20 75 73 65 20 62 79 20 53 51 4c 69  rnal use by SQLi
0450: 74 65 20 61 6e 64 20 73 68 6f 75 6c 64 20 6e 6f  te and should no
0460: 74 20 62 65 0a 2a 2a 20 61 63 63 65 73 73 65 64  t be.** accessed
0470: 20 62 79 20 75 73 65 72 73 20 6f 66 20 74 68 65   by users of the
0480: 20 6c 69 62 72 61 72 79 2e 0a 2a 2a 0a 2a 2a 20   library..**.** 
0490: 24 49 64 3a 20 6d 61 69 6e 2e 63 2c 76 20 31 2e  $Id: main.c,v 1.
04a0: 32 31 20 32 30 30 30 2f 31 30 2f 31 39 20 30 31  21 2000/10/19 01
04b0: 3a 34 39 3a 30 32 20 64 72 68 20 45 78 70 20 24  :49:02 drh Exp $
04c0: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
04d0: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a  liteInt.h"../*.*
04e0: 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 63 61  * This is the ca
04f0: 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20 66  llback routine f
0500: 6f 72 20 74 68 65 20 63 6f 64 65 20 74 68 61 74  or the code that
0510: 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68 65   initializes the
0520: 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 45  .** database.  E
0530: 61 63 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e  ach callback con
0540: 74 61 69 6e 73 20 74 65 78 74 20 6f 66 20 61 20  tains text of a 
0550: 43 52 45 41 54 45 20 54 41 42 4c 45 20 6f 72 0a  CREATE TABLE or.
0560: 2a 2a 20 43 52 45 41 54 45 20 49 4e 44 45 58 20  ** CREATE INDEX 
0570: 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 6d  statement that m
0580: 75 73 74 20 62 65 20 70 61 72 73 65 64 20 74 6f  ust be parsed to
0590: 20 79 69 65 6c 64 20 74 68 65 20 69 6e 74 65 72   yield the inter
05a0: 6e 61 6c 0a 2a 2a 20 73 74 72 75 63 74 75 72 65  nal.** structure
05b0: 73 20 74 68 61 74 20 64 65 73 63 72 69 62 65 20  s that describe 
05c0: 74 68 65 20 74 61 62 6c 65 73 2e 0a 2a 2a 0a 2a  the tables..**.*
05d0: 2a 20 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20  * This callback 
05e0: 69 73 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 77  is also called w
05f0: 69 74 68 20 61 72 67 63 3d 3d 32 20 77 68 65 6e  ith argc==2 when
0600: 20 74 68 65 72 65 20 69 73 20 6d 65 74 61 0a 2a   there is meta.*
0610: 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e  * information in
0620: 20 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74   the sqlite_mast
0630: 65 72 20 66 69 6c 65 2e 20 20 54 68 65 20 6d 65  er file.  The me
0640: 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69  ta information i
0650: 73 0a 2a 2a 20 63 6f 6e 74 61 69 6e 65 64 20 69  s.** contained i
0660: 6e 20 61 72 67 76 5b 31 5d 2e 20 20 54 79 70 69  n argv[1].  Typi
0670: 63 61 6c 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61  cal meta informa
0680: 74 69 6f 6e 20 69 73 20 74 68 65 20 66 69 6c 65  tion is the file
0690: 20 66 6f 72 6d 61 74 0a 2a 2a 20 76 65 72 73 69   format.** versi
06a0: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  on..*/.static in
06b0: 74 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 28 76  t sqliteOpenCb(v
06c0: 6f 69 64 20 2a 70 44 62 2c 20 69 6e 74 20 61 72  oid *pDb, int ar
06d0: 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76 2c  gc, char **argv,
06e0: 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 4e 61 6d   char **azColNam
06f0: 65 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  e){.  sqlite *db
0700: 20 3d 20 28 73 71 6c 69 74 65 2a 29 70 44 62 3b   = (sqlite*)pDb;
0710: 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b  .  Parse sParse;
0720: 0a 20 20 69 6e 74 20 6e 45 72 72 3b 0a 0a 20 20  .  int nErr;..  
0730: 69 66 28 20 61 72 67 63 3d 3d 32 20 29 7b 0a 20  if( argc==2 ){. 
0740: 20 20 20 69 66 28 20 73 73 63 61 6e 66 28 61 72     if( sscanf(ar
0750: 67 76 5b 31 5d 2c 22 66 69 6c 65 20 66 6f 72 6d  gv[1],"file form
0760: 61 74 20 25 64 22 2c 26 64 62 2d 3e 66 69 6c 65  at %d",&db->file
0770: 5f 66 6f 72 6d 61 74 29 3d 3d 31 20 29 7b 0a 20  _format)==1 ){. 
0780: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20       return 0;. 
0790: 20 20 20 7d 0a 20 20 20 20 2f 2a 20 55 6e 6b 6e     }.    /* Unkn
07a0: 6f 77 6e 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61  own meta informa
07b0: 74 69 6f 6e 2e 20 20 49 67 6e 6f 72 65 20 69 74  tion.  Ignore it
07c0: 2e 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20  . */.    return 
07d0: 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 61 72 67  0;.  }.  if( arg
07e0: 63 21 3d 31 20 29 20 72 65 74 75 72 6e 20 30 3b  c!=1 ) return 0;
07f0: 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61 72 73  .  memset(&sPars
0800: 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 50 61  e, 0, sizeof(sPa
0810: 72 73 65 29 29 3b 0a 20 20 73 50 61 72 73 65 2e  rse));.  sParse.
0820: 64 62 20 3d 20 64 62 3b 0a 20 20 73 50 61 72 73  db = db;.  sPars
0830: 65 2e 69 6e 69 74 46 6c 61 67 20 3d 20 31 3b 0a  e.initFlag = 1;.
0840: 20 20 6e 45 72 72 20 3d 20 73 71 6c 69 74 65 52    nErr = sqliteR
0850: 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 65  unParser(&sParse
0860: 2c 20 61 72 67 76 5b 30 5d 2c 20 30 29 3b 0a 20  , argv[0], 0);. 
0870: 20 72 65 74 75 72 6e 20 6e 45 72 72 3b 0a 7d 0a   return nErr;.}.
0880: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74  ./*.** Attempt t
0890: 6f 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62  o read the datab
08a0: 61 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69  ase schema and i
08b0: 6e 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e  nitialize intern
08c0: 61 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63  al.** data struc
08d0: 74 75 72 65 73 2e 20 20 52 65 74 75 72 6e 20 6f  tures.  Return o
08e0: 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45  ne of the SQLITE
08f0: 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74 6f  _ error codes to
0900: 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75 63  .** indicate suc
0910: 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e  cess or failure.
0920: 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65  .**.** After the
0930: 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69   database is ini
0940: 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 53 51  tialized, the SQ
0950: 4c 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64  LITE_Initialized
0960: 0a 2a 2a 20 62 69 74 20 69 73 20 73 65 74 20 69  .** bit is set i
0970: 6e 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c  n the flags fiel
0980: 64 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20  d of the sqlite 
0990: 73 74 72 75 63 74 75 72 65 2e 20 20 41 6e 0a 2a  structure.  An.*
09a0: 2a 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64  * attempt is mad
09b0: 65 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20  e to initialize 
09c0: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73 20  the database as 
09d0: 73 6f 6f 6e 20 61 73 20 69 74 0a 2a 2a 20 69 73  soon as it.** is
09e0: 20 6f 70 65 6e 65 64 2e 20 20 49 66 20 74 68 61   opened.  If tha
09f0: 74 20 66 61 69 6c 73 20 28 70 65 72 68 61 70 73  t fails (perhaps
0a00: 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65 72   because another
0a10: 20 70 72 6f 63 65 73 73 0a 2a 2a 20 68 61 73 20   process.** has 
0a20: 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  the sqlite_maste
0a30: 72 20 74 61 62 6c 65 20 6c 6f 63 6b 65 64 29 20  r table locked) 
0a40: 74 68 61 6e 20 61 6e 6f 74 68 65 72 20 61 74 74  than another att
0a50: 65 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 64 65 20  empt.** is made 
0a60: 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74  the first time t
0a70: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61  he database is a
0a80: 63 63 65 73 73 65 64 2e 0a 2a 2f 0a 73 74 61 74  ccessed..*/.stat
0a90: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 49 6e 69  ic int sqliteIni
0aa0: 74 28 73 71 6c 69 74 65 20 2a 64 62 2c 20 63 68  t(sqlite *db, ch
0ab0: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a  ar **pzErrMsg){.
0ac0: 20 20 56 64 62 65 20 2a 76 64 62 65 3b 0a 20 20    Vdbe *vdbe;.  
0ad0: 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 0a 20 20  int rc;..  /*.  
0ae0: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61  ** The master da
0af0: 74 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73  tabase table has
0b00: 20 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b   a structure lik
0b10: 65 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74  e this.  */.  st
0b20: 61 74 69 63 20 63 68 61 72 20 6d 61 73 74 65 72  atic char master
0b30: 5f 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20  _schema[] = .   
0b40: 20 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20    "CREATE TABLE 
0b50: 22 20 4d 41 53 54 45 52 5f 4e 41 4d 45 20 22 20  " MASTER_NAME " 
0b60: 28 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 79 70  (\n".     "  typ
0b70: 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20  e text,\n".     
0b80: 22 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  "  name text,\n"
0b90: 0a 20 20 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d  .     "  tbl_nam
0ba0: 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20  e text,\n".     
0bb0: 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20  "  sql text\n". 
0bc0: 20 20 20 20 22 29 22 0a 20 20 3b 0a 0a 20 20 2f      ")".  ;..  /
0bd0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
0be0: 70 72 6f 67 72 61 6d 20 69 73 20 75 73 65 64 20  program is used 
0bf0: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68  to initialize th
0c00: 65 20 69 6e 74 65 72 6e 61 6c 0a 20 20 2a 2a 20  e internal.  ** 
0c10: 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 69 6e  structure holdin
0c20: 67 20 74 68 65 20 74 61 62 6c 65 73 20 61 6e 64  g the tables and
0c30: 20 69 6e 64 65 78 65 73 20 6f 66 20 74 68 65 20   indexes of the 
0c40: 64 61 74 61 62 61 73 65 2e 0a 20 20 2a 2a 20 54  database..  ** T
0c50: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  he database cont
0c60: 61 69 6e 73 20 61 20 73 70 65 63 69 61 6c 20 74  ains a special t
0c70: 61 62 6c 65 20 6e 61 6d 65 64 20 22 73 71 6c 69  able named "sqli
0c80: 74 65 5f 6d 61 73 74 65 72 22 0a 20 20 2a 2a 20  te_master".  ** 
0c90: 64 65 66 69 6e 65 64 20 61 73 20 66 6f 6c 6c 6f  defined as follo
0ca0: 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20  ws:.  **.  **   
0cb0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 71   CREATE TABLE sq
0cc0: 6c 69 74 65 5f 6d 61 73 74 65 72 20 28 0a 20 20  lite_master (.  
0cd0: 2a 2a 20 20 20 20 20 20 20 20 74 79 70 65 20 20  **        type  
0ce0: 20 20 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d       text,    --
0cf0: 20 20 45 69 74 68 65 72 20 22 74 61 62 6c 65 22    Either "table"
0d00: 20 6f 72 20 22 69 6e 64 65 78 22 20 6f 72 20 22   or "index" or "
0d10: 6d 65 74 61 22 0a 20 20 2a 2a 20 20 20 20 20 20  meta".  **      
0d20: 20 20 6e 61 6d 65 20 20 20 20 20 20 20 74 65 78    name       tex
0d30: 74 2c 20 20 20 20 2d 2d 20 20 4e 61 6d 65 20 6f  t,    --  Name o
0d40: 66 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  f table or index
0d50: 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 74 62 6c  .  **        tbl
0d60: 5f 6e 61 6d 65 20 20 20 74 65 78 74 2c 20 20 20  _name   text,   
0d70: 20 2d 2d 20 20 41 73 73 6f 63 69 61 74 65 64 20   --  Associated 
0d80: 74 61 62 6c 65 20 0a 20 20 2a 2a 20 20 20 20 20  table .  **     
0d90: 20 20 20 73 71 6c 20 20 20 20 20 20 20 20 74 65     sql        te
0da0: 78 74 20 20 20 20 20 2d 2d 20 20 54 68 65 20 43  xt     --  The C
0db0: 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20  REATE statement 
0dc0: 66 6f 72 20 74 68 69 73 20 6f 62 6a 65 63 74 0a  for this object.
0dd0: 20 20 2a 2a 20 20 20 20 29 3b 0a 20 20 2a 2a 0a    **    );.  **.
0de0: 20 20 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 5f    ** The sqlite_
0df0: 6d 61 73 74 65 72 20 74 61 62 6c 65 20 63 6f 6e  master table con
0e00: 74 61 69 6e 73 20 61 20 73 69 6e 67 6c 65 20 65  tains a single e
0e10: 6e 74 72 79 20 66 6f 72 20 65 61 63 68 20 74 61  ntry for each ta
0e20: 62 6c 65 0a 20 20 2a 2a 20 61 6e 64 20 65 61 63  ble.  ** and eac
0e30: 68 20 69 6e 64 65 78 2e 20 20 54 68 65 20 22 74  h index.  The "t
0e40: 79 70 65 22 20 63 6f 6c 75 6d 6e 20 74 65 6c 6c  ype" column tell
0e50: 73 20 77 68 65 74 68 65 72 20 74 68 65 20 65 6e  s whether the en
0e60: 74 72 79 20 69 73 0a 20 20 2a 2a 20 61 20 74 61  try is.  ** a ta
0e70: 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 54  ble or index.  T
0e80: 68 65 20 22 6e 61 6d 65 22 20 63 6f 6c 75 6d 6e  he "name" column
0e90: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   is the name of 
0ea0: 74 68 65 20 6f 62 6a 65 63 74 2e 0a 20 20 2a 2a  the object..  **
0eb0: 20 54 68 65 20 22 74 62 6c 5f 6e 61 6d 65 22 20   The "tbl_name" 
0ec0: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  is the name of t
0ed0: 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 74 61  he associated ta
0ee0: 62 6c 65 2e 20 20 46 6f 72 20 74 61 62 6c 65 73  ble.  For tables
0ef0: 2c 0a 20 20 2a 2a 20 74 68 65 20 74 62 6c 5f 6e  ,.  ** the tbl_n
0f00: 61 6d 65 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6c  ame column is al
0f10: 77 61 79 73 20 74 68 65 20 73 61 6d 65 20 61 73  ways the same as
0f20: 20 6e 61 6d 65 2e 20 20 46 6f 72 20 69 6e 64 69   name.  For indi
0f30: 63 65 73 2c 20 74 68 65 0a 20 20 2a 2a 20 74 62  ces, the.  ** tb
0f40: 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 63 6f  l_name column co
0f50: 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20  ntains the name 
0f60: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  of the table tha
0f70: 74 20 74 68 65 20 69 6e 64 65 78 0a 20 20 2a 2a  t the index.  **
0f80: 20 69 6e 64 65 78 65 73 2e 20 20 46 69 6e 61 6c   indexes.  Final
0f90: 6c 79 2c 20 74 68 65 20 22 73 71 6c 22 20 63 6f  ly, the "sql" co
0fa0: 6c 75 6d 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68  lumn contains th
0fb0: 65 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20  e complete text 
0fc0: 6f 66 0a 20 20 2a 2a 20 74 68 65 20 43 52 45 41  of.  ** the CREA
0fd0: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
0fe0: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
0ff0: 6e 74 20 74 68 61 74 20 6f 72 69 67 69 6e 61 6c  nt that original
1000: 6c 79 20 63 72 65 61 74 65 64 0a 20 20 2a 2a 20  ly created.  ** 
1010: 74 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  the table or ind
1020: 65 78 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66  ex..  **.  ** If
1030: 20 74 68 65 20 22 74 79 70 65 22 20 63 6f 6c 75   the "type" colu
1040: 6d 6e 20 68 61 73 20 74 68 65 20 76 61 6c 75 65  mn has the value
1050: 20 22 6d 65 74 61 22 2c 20 74 68 65 6e 20 74 68   "meta", then th
1060: 65 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 0a 20  e "sql" column. 
1070: 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 65 78 74   ** contains ext
1080: 72 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61  ra information a
1090: 62 6f 75 74 20 74 68 65 20 64 61 74 61 62 61 73  bout the databas
10a0: 65 2c 20 73 75 63 68 20 61 73 20 74 68 65 0a 20  e, such as the. 
10b0: 20 2a 2a 20 66 69 6c 65 20 66 6f 72 6d 61 74 20   ** file format 
10c0: 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2e 20  version number. 
10d0: 20 41 6c 6c 20 6d 65 74 61 20 69 6e 66 6f 72 6d   All meta inform
10e0: 61 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 70 72  ation must be pr
10f0: 6f 63 65 73 73 65 64 0a 20 20 2a 2a 20 62 65 66  ocessed.  ** bef
1100: 6f 72 65 20 61 6e 79 20 74 61 62 6c 65 73 20 6f  ore any tables o
1110: 72 20 69 6e 64 69 63 65 73 20 61 72 65 20 63 6f  r indices are co
1120: 6e 73 74 72 75 63 74 65 64 2e 0a 20 20 2a 2a 0a  nstructed..  **.
1130: 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69    ** The followi
1140: 6e 67 20 70 72 6f 67 72 61 6d 20 69 6e 76 6f 6b  ng program invok
1150: 65 73 20 69 74 73 20 63 61 6c 6c 62 61 63 6b 20  es its callback 
1160: 6f 6e 20 74 68 65 20 53 51 4c 20 66 6f 72 20 65  on the SQL for e
1170: 61 63 68 0a 20 20 2a 2a 20 74 61 62 6c 65 20 74  ach.  ** table t
1180: 68 65 6e 20 67 6f 65 73 20 62 61 63 6b 20 61 6e  hen goes back an
1190: 64 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 63 61  d invokes the ca
11a0: 6c 6c 62 61 63 6b 20 6f 6e 20 74 68 65 0a 20 20  llback on the.  
11b0: 2a 2a 20 53 51 4c 20 66 6f 72 20 65 61 63 68 20  ** SQL for each 
11c0: 69 6e 64 65 78 2e 20 20 54 68 65 20 63 61 6c 6c  index.  The call
11d0: 62 61 63 6b 20 77 69 6c 6c 20 69 6e 76 6f 6b 65  back will invoke
11e0: 20 74 68 65 0a 20 20 2a 2a 20 70 61 72 73 65 72   the.  ** parser
11f0: 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 69 6e   to build the in
1200: 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74  ternal represent
1210: 61 74 69 6f 6e 20 6f 66 20 74 68 65 0a 20 20 2a  ation of the.  *
1220: 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  * database schem
1230: 65 2e 0a 20 20 2a 2f 0a 20 20 73 74 61 74 69 63  e..  */.  static
1240: 20 56 64 62 65 4f 70 20 69 6e 69 74 50 72 6f 67   VdbeOp initProg
1250: 5b 5d 20 3d 20 7b 0a 20 20 20 20 7b 20 4f 50 5f  [] = {.    { OP_
1260: 4f 70 65 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20  Open,     0, 0, 
1270: 20 4d 41 53 54 45 52 5f 4e 41 4d 45 7d 2c 0a 20   MASTER_NAME},. 
1280: 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20     { OP_Next,   
1290: 20 20 30 2c 20 39 2c 20 20 30 7d 2c 20 20 20 20    0, 9,  0},    
12a0: 20 20 20 20 20 20 20 2f 2a 20 31 20 2a 2f 0a 20         /* 1 */. 
12b0: 20 20 20 7b 20 4f 50 5f 46 69 65 6c 64 2c 20 20     { OP_Field,  
12c0: 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20    0, 0,  0},.   
12d0: 20 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20   { OP_String,   
12e0: 30 2c 20 30 2c 20 20 22 6d 65 74 61 22 7d 2c 0a  0, 0,  "meta"},.
12f0: 20 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20      { OP_Ne,    
1300: 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 20     0, 1,  0},.  
1310: 20 20 7b 20 4f 50 5f 46 69 65 6c 64 2c 20 20 20    { OP_Field,   
1320: 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 20 20   0, 0,  0},.    
1330: 7b 20 4f 50 5f 46 69 65 6c 64 2c 20 20 20 20 30  { OP_Field,    0
1340: 2c 20 33 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20  , 3,  0},.    { 
1350: 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c 20 32 2c 20  OP_Callback, 2, 
1360: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50  0,  0},.    { OP
1370: 5f 47 6f 74 6f 2c 20 20 20 20 20 30 2c 20 31 2c  _Goto,     0, 1,
1380: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52    0},.    { OP_R
1390: 65 77 69 6e 64 2c 20 20 20 30 2c 20 30 2c 20 20  ewind,   0, 0,  
13a0: 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  0},           /*
13b0: 20 39 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 4e   9 */.    { OP_N
13c0: 65 78 74 2c 20 20 20 20 20 30 2c 20 31 37 2c 20  ext,     0, 17, 
13d0: 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a  0},           /*
13e0: 20 31 30 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f   10 */.    { OP_
13f0: 46 69 65 6c 64 2c 20 20 20 20 30 2c 20 30 2c 20  Field,    0, 0, 
1400: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 74   0},.    { OP_St
1410: 72 69 6e 67 2c 20 20 20 30 2c 20 30 2c 20 20 22  ring,   0, 0,  "
1420: 74 61 62 6c 65 22 7d 2c 0a 20 20 20 20 7b 20 4f  table"},.    { O
1430: 50 5f 4e 65 2c 20 20 20 20 20 20 20 30 2c 20 31  P_Ne,       0, 1
1440: 30 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f  0, 0},.    { OP_
1450: 46 69 65 6c 64 2c 20 20 20 20 30 2c 20 33 2c 20  Field,    0, 3, 
1460: 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 61   0},.    { OP_Ca
1470: 6c 6c 62 61 63 6b 2c 20 31 2c 20 30 2c 20 20 30  llback, 1, 0,  0
1480: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 47 6f 74 6f  },.    { OP_Goto
1490: 2c 20 20 20 20 20 30 2c 20 31 30 2c 20 30 7d 2c  ,     0, 10, 0},
14a0: 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77 69 6e 64  .    { OP_Rewind
14b0: 2c 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 20 20  ,   0, 0,  0},  
14c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 31 37 20 2a           /* 17 *
14d0: 2f 0a 20 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c  /.    { OP_Next,
14e0: 20 20 20 20 20 30 2c 20 32 35 2c 20 30 7d 2c 20       0, 25, 0}, 
14f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 38 20            /* 18 
1500: 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 46 69 65 6c  */.    { OP_Fiel
1510: 64 2c 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c  d,    0, 0,  0},
1520: 0a 20 20 20 20 7b 20 4f 50 5f 53 74 72 69 6e 67  .    { OP_String
1530: 2c 20 20 20 30 2c 20 30 2c 20 20 22 69 6e 64 65  ,   0, 0,  "inde
1540: 78 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 4e 65  x"},.    { OP_Ne
1550: 2c 20 20 20 20 20 20 20 30 2c 20 31 38 2c 20 30  ,       0, 18, 0
1560: 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 46 69 65 6c  },.    { OP_Fiel
1570: 64 2c 20 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c  d,    0, 3,  0},
1580: 0a 20 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61  .    { OP_Callba
1590: 63 6b 2c 20 31 2c 20 30 2c 20 20 30 7d 2c 0a 20  ck, 1, 0,  0},. 
15a0: 20 20 20 7b 20 4f 50 5f 47 6f 74 6f 2c 20 20 20     { OP_Goto,   
15b0: 20 20 30 2c 20 31 38 2c 20 30 7d 2c 0a 20 20 20    0, 18, 0},.   
15c0: 20 7b 20 4f 50 5f 48 61 6c 74 2c 20 20 20 20 20   { OP_Halt,     
15d0: 30 2c 20 30 2c 20 20 30 7d 2c 20 20 20 20 20 20  0, 0,  0},      
15e0: 20 20 20 20 20 2f 2a 20 32 35 20 2a 2f 0a 20 20       /* 25 */.  
15f0: 7d 3b 0a 0a 20 20 2f 2a 20 43 72 65 61 74 65 20  };..  /* Create 
1600: 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e  a virtual machin
1610: 65 20 74 6f 20 72 75 6e 20 74 68 65 20 69 6e 69  e to run the ini
1620: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 67  tialization prog
1630: 72 61 6d 2e 20 20 52 75 6e 0a 20 20 2a 2a 20 74  ram.  Run.  ** t
1640: 68 65 20 70 72 6f 67 72 61 6d 2e 20 20 54 68 65  he program.  The
1650: 20 64 65 6c 65 74 65 20 74 68 65 20 76 69 72 74   delete the virt
1660: 75 61 6c 20 6d 61 63 68 69 6e 65 2e 0a 20 20 2a  ual machine..  *
1670: 2f 0a 20 20 76 64 62 65 20 3d 20 73 71 6c 69 74  /.  vdbe = sqlit
1680: 65 56 64 62 65 43 72 65 61 74 65 28 64 62 29 3b  eVdbeCreate(db);
1690: 0a 20 20 69 66 28 20 76 64 62 65 3d 3d 30 20 29  .  if( vdbe==0 )
16a0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 74 53  {.    sqliteSetS
16b0: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
16c0: 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c  "out of memory",
16d0: 30 29 3b 20 0a 20 20 20 20 72 65 74 75 72 6e 20  0); .    return 
16e0: 31 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 56  1;.  }.  sqliteV
16f0: 64 62 65 41 64 64 4f 70 4c 69 73 74 28 76 64 62  dbeAddOpList(vdb
1700: 65 2c 20 73 69 7a 65 6f 66 28 69 6e 69 74 50 72  e, sizeof(initPr
1710: 6f 67 29 2f 73 69 7a 65 6f 66 28 69 6e 69 74 50  og)/sizeof(initP
1720: 72 6f 67 5b 30 5d 29 2c 20 69 6e 69 74 50 72 6f  rog[0]), initPro
1730: 67 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  g);.  rc = sqlit
1740: 65 56 64 62 65 45 78 65 63 28 76 64 62 65 2c 20  eVdbeExec(vdbe, 
1750: 73 71 6c 69 74 65 4f 70 65 6e 43 62 2c 20 64 62  sqliteOpenCb, db
1760: 2c 20 70 7a 45 72 72 4d 73 67 2c 20 0a 20 20 20  , pzErrMsg, .   
1770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1780: 20 20 20 64 62 2d 3e 70 42 75 73 79 41 72 67 2c     db->pBusyArg,
1790: 20 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c 62 61   db->xBusyCallba
17a0: 63 6b 29 3b 0a 20 20 73 71 6c 69 74 65 56 64 62  ck);.  sqliteVdb
17b0: 65 44 65 6c 65 74 65 28 76 64 62 65 29 3b 0a 20  eDelete(vdbe);. 
17c0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
17d0: 4f 4b 20 26 26 20 64 62 2d 3e 66 69 6c 65 5f 66  OK && db->file_f
17e0: 6f 72 6d 61 74 3c 32 20 26 26 20 64 62 2d 3e 6e  ormat<2 && db->n
17f0: 54 61 62 6c 65 3e 30 20 29 7b 0a 20 20 20 20 73  Table>0 ){.    s
1800: 71 6c 69 74 65 53 65 74 53 74 72 69 6e 67 28 70  qliteSetString(p
1810: 7a 45 72 72 4d 73 67 2c 20 22 6f 62 73 6f 6c 65  zErrMsg, "obsole
1820: 74 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c  te file format",
1830: 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51   0);.    rc = SQ
1840: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
1850: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
1860: 5f 4f 4b 20 29 7b 0a 20 20 20 20 54 61 62 6c 65  _OK ){.    Table
1870: 20 2a 70 54 61 62 3b 0a 20 20 20 20 63 68 61 72   *pTab;.    char
1880: 20 2a 61 7a 41 72 67 5b 32 5d 3b 0a 20 20 20 20   *azArg[2];.    
1890: 61 7a 41 72 67 5b 30 5d 20 3d 20 6d 61 73 74 65  azArg[0] = maste
18a0: 72 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a  r_schema;.    az
18b0: 41 72 67 5b 31 5d 20 3d 20 30 3b 0a 20 20 20 20  Arg[1] = 0;.    
18c0: 73 71 6c 69 74 65 4f 70 65 6e 43 62 28 64 62 2c  sqliteOpenCb(db,
18d0: 20 31 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a 20   1, azArg, 0);. 
18e0: 20 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65     pTab = sqlite
18f0: 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d 41  FindTable(db, MA
1900: 53 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20 20  STER_NAME);.    
1910: 69 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20  if( pTab ){.    
1920: 20 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79    pTab->readOnly
1930: 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20   = 1;.    }.    
1940: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c  db->flags |= SQL
1950: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b  ITE_Initialized;
1960: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71  .  }else{.    sq
1970: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70  liteStrRealloc(p
1980: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20  zErrMsg);.  }.  
1990: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
19a0: 0a 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20  .** The version 
19b0: 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a  of the library.*
19c0: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c  /.const char sql
19d0: 69 74 65 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20  ite_version[] = 
19e0: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a  SQLITE_VERSION;.
19f0: 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65  ./*.** Open a ne
1a00: 77 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  w SQLite databas
1a10: 65 2e 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e  e.  Construct an
1a20: 20 22 73 71 6c 69 74 65 22 20 73 74 72 75 63 74   "sqlite" struct
1a30: 75 72 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a  ure to define.**
1a40: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68   the state of th
1a50: 69 73 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  is database and 
1a60: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  return a pointer
1a70: 20 74 6f 20 74 68 61 74 20 73 74 72 75 63 74 75   to that structu
1a80: 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74  re..**.** An att
1a90: 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20  empt is made to 
1aa0: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69  initialize the i
1ab0: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74  n-memory data st
1ac0: 72 75 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a  ructures that.**
1ad0: 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61   hold the databa
1ae0: 73 65 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20  se schema.  But 
1af0: 69 66 20 74 68 69 73 20 66 61 69 6c 73 20 28 62  if this fails (b
1b00: 65 63 61 75 73 65 20 74 68 65 20 73 63 68 65 6d  ecause the schem
1b10: 61 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63  a file.** is loc
1b20: 6b 65 64 29 20 74 68 65 6e 20 74 68 61 74 20 73  ked) then that s
1b30: 74 65 70 20 69 73 20 64 65 66 65 72 72 65 64 20  tep is deferred 
1b40: 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20  until the first 
1b50: 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74  call to.** sqlit
1b60: 65 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c  e_exec()..*/.sql
1b70: 69 74 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e  ite *sqlite_open
1b80: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
1b90: 6c 65 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65  lename, int mode
1ba0: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73  , char **pzErrMs
1bb0: 67 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62  g){.  sqlite *db
1bc0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f  ;.  int rc;..  /
1bd0: 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73  * Allocate the s
1be0: 71 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63  qlite data struc
1bf0: 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73  ture */.  db = s
1c00: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
1c10: 65 6f 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20  eof(sqlite) );. 
1c20: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20   if( pzErrMsg ) 
1c30: 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20  *pzErrMsg = 0;. 
1c40: 20 69 66 28 20 64 62 3d 3d 30 20 29 7b 0a 20 20   if( db==0 ){.  
1c50: 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 6e    sqliteSetStrin
1c60: 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 6f 75 74  g(pzErrMsg, "out
1c70: 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 20 30 29 3b   of memory", 0);
1c80: 0a 20 20 20 20 73 71 6c 69 74 65 53 74 72 52 65  .    sqliteStrRe
1c90: 61 6c 6c 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b  alloc(pzErrMsg);
1ca0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
1cb0: 20 7d 0a 20 20 0a 20 20 2f 2a 20 4f 70 65 6e 20   }.  .  /* Open 
1cc0: 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 61  the backend data
1cd0: 62 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a 20  base driver */. 
1ce0: 20 64 62 2d 3e 70 42 65 20 3d 20 73 71 6c 69 74   db->pBe = sqlit
1cf0: 65 44 62 62 65 4f 70 65 6e 28 7a 46 69 6c 65 6e  eDbbeOpen(zFilen
1d00: 61 6d 65 2c 20 28 6d 6f 64 65 26 30 32 32 32 29  ame, (mode&0222)
1d10: 21 3d 30 2c 20 6d 6f 64 65 21 3d 30 2c 20 70 7a  !=0, mode!=0, pz
1d20: 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 64  ErrMsg);.  if( d
1d30: 62 2d 3e 70 42 65 3d 3d 30 20 29 7b 0a 20 20 20  b->pBe==0 ){.   
1d40: 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f   sqliteStrReallo
1d50: 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  c(pzErrMsg);.   
1d60: 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 29 3b   sqliteFree(db);
1d70: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
1d80: 20 7d 0a 0a 20 20 2f 2a 20 41 73 73 75 6d 65 20   }..  /* Assume 
1d90: 66 69 6c 65 20 66 6f 72 6d 61 74 20 31 20 75 6e  file format 1 un
1da0: 6c 65 73 73 20 74 68 65 20 64 61 74 61 62 61 73  less the databas
1db0: 65 20 73 61 79 73 20 6f 74 68 65 72 77 69 73 65  e says otherwise
1dc0: 20 2a 2f 0a 20 20 64 62 2d 3e 66 69 6c 65 5f 66   */.  db->file_f
1dd0: 6f 72 6d 61 74 20 3d 20 31 3b 0a 0a 20 20 2f 2a  ormat = 1;..  /*
1de0: 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64   Attempt to read
1df0: 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f 0a 20   the schema */. 
1e00: 20 72 63 20 3d 20 73 71 6c 69 74 65 49 6e 69 74   rc = sqliteInit
1e10: 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a  (db, pzErrMsg);.
1e20: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
1e30: 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54  _OK && rc!=SQLIT
1e40: 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 73 71  E_BUSY ){.    sq
1e50: 6c 69 74 65 5f 63 6c 6f 73 65 28 64 62 29 3b 0a  lite_close(db);.
1e60: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
1e70: 7d 65 6c 73 65 20 2f 2a 20 69 66 28 20 70 7a 45  }else /* if( pzE
1e80: 72 72 4d 73 67 20 29 20 2a 2f 7b 0a 20 20 20 20  rrMsg ) */{.    
1e90: 66 72 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b  free(*pzErrMsg);
1ea0: 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d  .    *pzErrMsg =
1eb0: 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e   0;.  }.  return
1ec0: 20 64 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c   db;.}../*.** Cl
1ed0: 6f 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 20  ose an existing 
1ee0: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a  SQLite database.
1ef0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 63  */.void sqlite_c
1f00: 6c 6f 73 65 28 73 71 6c 69 74 65 20 2a 64 62 29  lose(sqlite *db)
1f10: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 64 62 2d  {.  int i;.  db-
1f20: 3e 70 42 65 2d 3e 43 6c 6f 73 65 28 64 62 2d 3e  >pBe->Close(db->
1f30: 70 42 65 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  pBe);.  for(i=0;
1f40: 20 69 3c 4e 5f 48 41 53 48 3b 20 69 2b 2b 29 7b   i<N_HASH; i++){
1f50: 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 4e 65 78  .    Table *pNex
1f60: 74 2c 20 2a 70 4c 69 73 74 20 3d 20 64 62 2d 3e  t, *pList = db->
1f70: 61 70 54 62 6c 48 61 73 68 5b 69 5d 3b 0a 20 20  apTblHash[i];.  
1f80: 20 20 64 62 2d 3e 61 70 54 62 6c 48 61 73 68 5b    db->apTblHash[
1f90: 69 5d 20 3d 20 30 3b 0a 20 20 20 20 77 68 69 6c  i] = 0;.    whil
1fa0: 65 28 20 70 4c 69 73 74 20 29 7b 0a 20 20 20 20  e( pList ){.    
1fb0: 20 20 70 4e 65 78 74 20 3d 20 70 4c 69 73 74 2d    pNext = pList-
1fc0: 3e 70 48 61 73 68 3b 0a 20 20 20 20 20 20 70 4c  >pHash;.      pL
1fd0: 69 73 74 2d 3e 70 48 61 73 68 20 3d 20 30 3b 0a  ist->pHash = 0;.
1fe0: 20 20 20 20 20 20 73 71 6c 69 74 65 44 65 6c 65        sqliteDele
1ff0: 74 65 54 61 62 6c 65 28 64 62 2c 20 70 4c 69 73  teTable(db, pLis
2000: 74 29 3b 0a 20 20 20 20 20 20 70 4c 69 73 74 20  t);.      pList 
2010: 3d 20 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20  = pNext;.    }. 
2020: 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28   }.  sqliteFree(
2030: 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  db);.}../*.** Re
2040: 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65  turn TRUE if the
2050: 20 67 69 76 65 6e 20 53 51 4c 20 73 74 72 69 6e   given SQL strin
2060: 67 20 65 6e 64 73 20 69 6e 20 61 20 73 65 6d 69  g ends in a semi
2070: 63 6f 6c 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71  colon..*/.int sq
2080: 6c 69 74 65 5f 63 6f 6d 70 6c 65 74 65 28 63 6f  lite_complete(co
2090: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 29 7b  nst char *zSql){
20a0: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20  .  int i;.  int 
20b0: 6c 61 73 74 57 61 73 53 65 6d 69 20 3d 20 30 3b  lastWasSemi = 0;
20c0: 0a 0a 20 20 69 20 3d 20 30 3b 0a 20 20 77 68 69  ..  i = 0;.  whi
20d0: 6c 65 28 20 69 3e 3d 30 20 26 26 20 7a 53 71 6c  le( i>=0 && zSql
20e0: 5b 69 5d 21 3d 30 20 29 7b 0a 20 20 20 20 69 6e  [i]!=0 ){.    in
20f0: 74 20 74 6f 6b 65 6e 54 79 70 65 3b 0a 20 20 20  t tokenType;.   
2100: 20 69 6e 74 20 6e 3b 0a 0a 20 20 20 20 6e 20 3d   int n;..    n =
2110: 20 73 71 6c 69 74 65 47 65 74 54 6f 6b 65 6e 28   sqliteGetToken(
2120: 26 7a 53 71 6c 5b 69 5d 2c 20 26 74 6f 6b 65 6e  &zSql[i], &token
2130: 54 79 70 65 29 3b 0a 20 20 20 20 73 77 69 74 63  Type);.    switc
2140: 68 28 20 74 6f 6b 65 6e 54 79 70 65 20 29 7b 0a  h( tokenType ){.
2150: 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 53 50        case TK_SP
2160: 41 43 45 3a 0a 20 20 20 20 20 20 63 61 73 65 20  ACE:.      case 
2170: 54 4b 5f 43 4f 4d 4d 45 4e 54 3a 0a 20 20 20 20  TK_COMMENT:.    
2180: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
2190: 20 63 61 73 65 20 54 4b 5f 53 45 4d 49 3a 0a 20   case TK_SEMI:. 
21a0: 20 20 20 20 20 20 20 6c 61 73 74 57 61 73 53 65         lastWasSe
21b0: 6d 69 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20  mi = 1;.        
21c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 64 65 66  break;.      def
21d0: 61 75 6c 74 3a 0a 20 20 20 20 20 20 20 20 6c 61  ault:.        la
21e0: 73 74 57 61 73 53 65 6d 69 20 3d 20 30 3b 0a 20  stWasSemi = 0;. 
21f0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
2200: 20 20 7d 0a 20 20 20 20 69 20 2b 3d 20 6e 3b 0a    }.    i += n;.
2210: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6c 61 73    }.  return las
2220: 74 57 61 73 53 65 6d 69 3b 0a 7d 0a 0a 2f 2a 0a  tWasSemi;.}../*.
2230: 2a 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20 63  ** Execute SQL c
2240: 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65  ode.  Return one
2250: 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20   of the SQLITE_ 
2260: 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 0a  success/failure.
2270: 2a 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f 20  ** codes.  Also 
2280: 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d  write an error m
2290: 65 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d 6f  essage into memo
22a0: 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  ry obtained from
22b0: 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e 64  .** malloc() and
22c0: 20 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67 20   make *pzErrMsg 
22d0: 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d 65  point to that me
22e0: 73 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  ssage..**.** If 
22f0: 74 68 65 20 53 51 4c 20 69 73 20 61 20 71 75 65  the SQL is a que
2300: 72 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61 63  ry, then for eac
2310: 68 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75 65  h row in the que
2320: 72 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68 65  ry result.** the
2330: 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75 6e   xCallback() fun
2340: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e  ction is called.
2350: 20 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20 74    pArg becomes t
2360: 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75  he first.** argu
2370: 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63  ment to xCallbac
2380: 6b 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62 61  k().  If xCallba
2390: 63 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f 20  ck=NULL then no 
23a0: 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 69  callback.** is i
23b0: 6e 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f 72  nvoked, even for
23c0: 20 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e 74   queries..*/.int
23d0: 20 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20 20   sqlite_exec(.  
23e0: 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 20  sqlite *db,     
23f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2400: 68 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77  he database on w
2410: 68 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 65  hich the SQL exe
2420: 63 75 74 65 73 20 2a 2f 0a 20 20 63 68 61 72 20  cutes */.  char 
2430: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 20  *zSql,          
2440: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51         /* The SQ
2450: 4c 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64  L to be executed
2460: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 6c   */.  sqlite_cal
2470: 6c 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b 2c  lback xCallback,
2480: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 73    /* Invoke this
2490: 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e   callback routin
24a0: 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72  e */.  void *pAr
24b0: 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  g,              
24c0: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75     /* First argu
24d0: 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 63  ment to xCallbac
24e0: 6b 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  k() */.  char **
24f0: 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20  pzErrMsg        
2500: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 72       /* Write er
2510: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72  ror messages her
2520: 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 20  e */.){.  Parse 
2530: 73 50 61 72 73 65 3b 0a 20 20 69 6e 74 20 72 63  sParse;.  int rc
2540: 3b 0a 0a 20 20 69 66 28 20 70 7a 45 72 72 4d 73  ;..  if( pzErrMs
2550: 67 20 29 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20  g ) *pzErrMsg = 
2560: 30 3b 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 6c  0;.  if( (db->fl
2570: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 49 6e 69  ags & SQLITE_Ini
2580: 74 69 61 6c 69 7a 65 64 29 3d 3d 30 20 29 7b 0a  tialized)==0 ){.
2590: 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c      int rc = sql
25a0: 69 74 65 49 6e 69 74 28 64 62 2c 20 70 7a 45 72  iteInit(db, pzEr
25b0: 72 4d 73 67 29 3b 0a 20 20 20 20 69 66 28 20 72  rMsg);.    if( r
25c0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
25d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
25e0: 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20  memset(&sParse, 
25f0: 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65  0, sizeof(sParse
2600: 29 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20  ));.  sParse.db 
2610: 3d 20 64 62 3b 0a 20 20 73 50 61 72 73 65 2e 78  = db;.  sParse.x
2620: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c  Callback = xCall
2630: 62 61 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70  back;.  sParse.p
2640: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71  Arg = pArg;.  sq
2650: 6c 69 74 65 52 75 6e 50 61 72 73 65 72 28 26 73  liteRunParser(&s
2660: 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45  Parse, zSql, pzE
2670: 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e  rrMsg);.  return
2680: 20 73 50 61 72 73 65 2e 72 63 3b 0a 7d 0a 0a 2f   sParse.rc;.}../
2690: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
26a0: 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62  e implements a b
26b0: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61  usy callback tha
26c0: 74 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69  t sleeps and tri
26d0: 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69  es.** again unti
26e0: 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75  l a timeout valu
26f0: 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54  e is reached.  T
2700: 68 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65  he timeout value
2710: 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65   is.** an intege
2720: 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  r number of mill
2730: 69 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20  iseconds passed 
2740: 69 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a  in as the first.
2750: 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ** argument..*/.
2760: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
2770: 65 5f 64 65 66 61 75 6c 74 5f 62 75 73 79 5f 63  e_default_busy_c
2780: 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a  allback(. void *
2790: 54 69 6d 65 6f 75 74 2c 20 20 20 20 20 20 20 20  Timeout,        
27a0: 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d     /* Maximum am
27b0: 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74 6f 20  ount of time to 
27c0: 77 61 69 74 20 2a 2f 0a 20 63 6f 6e 73 74 20 63  wait */. const c
27d0: 68 61 72 20 2a 4e 6f 74 55 73 65 64 2c 20 20 20  har *NotUsed,   
27e0: 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66    /* The name of
27f0: 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20   the table that 
2800: 69 73 20 62 75 73 79 20 2a 2f 0a 20 69 6e 74 20  is busy */. int 
2810: 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20 20 20  count           
2820: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
2830: 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20 68 61  f times table ha
2840: 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29  s been busy */.)
2850: 7b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 48 41  {.#if defined(HA
2860: 56 45 5f 55 53 4c 45 45 50 29 20 26 26 20 48 41  VE_USLEEP) && HA
2870: 56 45 5f 55 53 4c 45 45 50 0a 20 20 69 6e 74 20  VE_USLEEP.  int 
2880: 64 65 6c 61 79 20 3d 20 31 30 30 30 30 3b 0a 20  delay = 10000;. 
2890: 20 69 6e 74 20 70 72 69 6f 72 5f 64 65 6c 61 79   int prior_delay
28a0: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 74 69 6d 65   = 0;.  int time
28b0: 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f  out = (int)Timeo
28c0: 75 74 3b 0a 20 20 69 6e 74 20 69 3b 0a 0a 20 20  ut;.  int i;..  
28d0: 66 6f 72 28 69 3d 31 3b 20 69 3c 63 6f 75 6e 74  for(i=1; i<count
28e0: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 70 72 69  ; i++){ .    pri
28f0: 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 64 65 6c 61  or_delay += dela
2900: 79 3b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64  y;.    delay = d
2910: 65 6c 61 79 2a 32 3b 0a 20 20 20 20 69 66 28 20  elay*2;.    if( 
2920: 64 65 6c 61 79 3e 3d 31 30 30 30 30 30 30 20 29  delay>=1000000 )
2930: 7b 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d 20  {.      delay = 
2940: 31 30 30 30 30 30 30 3b 0a 20 20 20 20 20 20 70  1000000;.      p
2950: 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 31 30  rior_delay += 10
2960: 30 30 30 30 30 2a 28 63 6f 75 6e 74 20 2d 20 69  00000*(count - i
2970: 20 2d 20 31 29 3b 0a 20 20 20 20 20 20 62 72 65   - 1);.      bre
2980: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ak;.    }.  }.  
2990: 69 66 28 20 70 72 69 6f 72 5f 64 65 6c 61 79 20  if( prior_delay 
29a0: 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75  + delay > timeou
29b0: 74 2a 31 30 30 30 20 29 7b 0a 20 20 20 20 64 65  t*1000 ){.    de
29c0: 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74 2a 31 30  lay = timeout*10
29d0: 30 30 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 79  00 - prior_delay
29e0: 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c  ;.    if( delay<
29f0: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20  =0 ) return 0;. 
2a00: 20 7d 0a 20 20 75 73 6c 65 65 70 28 64 65 6c 61   }.  usleep(dela
2a10: 79 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  y);.  return 1;.
2a20: 23 65 6c 73 65 0a 20 20 69 6e 74 20 74 69 6d 65  #else.  int time
2a30: 6f 75 74 20 3d 20 28 69 6e 74 29 54 69 6d 65 6f  out = (int)Timeo
2a40: 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e 74  ut;.  if( (count
2a50: 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f  +1)*1000 > timeo
2a60: 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ut ){.    return
2a70: 20 30 3b 0a 20 20 7d 0a 20 20 73 6c 65 65 70 28   0;.  }.  sleep(
2a80: 31 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a  1);.  return 1;.
2a90: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
2aa0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74  This routine set
2ab0: 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62  s the busy callb
2ac0: 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74  ack for an Sqlit
2ad0: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68  e database to th
2ae0: 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62  e.** given callb
2af0: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74  ack function wit
2b00: 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75  h the given argu
2b10: 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ment..*/.void sq
2b20: 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c 65  lite_busy_handle
2b30: 72 28 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 2c  r(.  sqlite *db,
2b40: 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29 28  .  int (*xBusy)(
2b50: 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72  void*,const char
2b60: 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a  *,int),.  void *
2b70: 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d 3e 78 42  pArg.){.  db->xB
2b80: 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d 20 78 42  usyCallback = xB
2b90: 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 75 73 79  usy;.  db->pBusy
2ba0: 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d 0a 0a 2f  Arg = pArg;.}../
2bb0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
2bc0: 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 66  e installs a def
2bd0: 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c 65  ault busy handle
2be0: 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f 72  r that waits for
2bf0: 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 65   the.** specifie
2c00: 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  d number of mill
2c10: 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20  iseconds before 
2c20: 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f 0a  returning 0..*/.
2c30: 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 75 73 79  void sqlite_busy
2c40: 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 20  _timeout(sqlite 
2c50: 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 20 20  *db, int ms){.  
2c60: 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20  if( ms>0 ){.    
2c70: 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64  sqlite_busy_hand
2c80: 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 5f 64  ler(db, sqlite_d
2c90: 65 66 61 75 6c 74 5f 62 75 73 79 5f 63 61 6c 6c  efault_busy_call
2ca0: 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29  back, (void*)ms)
2cb0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
2cc0: 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c  qlite_busy_handl
2cd0: 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20  er(db, 0, 0);.  
2ce0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65  }.}../*.** Cause
2cf0: 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65   any pending ope
2d00: 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61  ration to stop a
2d10: 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f  t its earliest o
2d20: 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76  pportunity..*/.v
2d30: 6f 69 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72  oid sqlite_inter
2d40: 72 75 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29  rupt(sqlite *db)
2d50: 7b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d  {.  db->flags |=
2d60: 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70   SQLITE_Interrup
2d70: 74 3b 0a 7d 0a                                   t;.}.