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: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 /.#include "sqli
0270: 74 65 49 6e 74 2e 68 22 0a 0a 23 69 66 64 65 66 teInt.h"..#ifdef
0280: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
0290: 54 53 33 0a 23 20 69 6e 63 6c 75 64 65 20 22 66 TS3.# include "f
02a0: 74 73 33 2e 68 22 0a 23 65 6e 64 69 66 0a 23 69 ts3.h".#endif.#i
02b0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
02c0: 4c 45 5f 52 54 52 45 45 0a 23 20 69 6e 63 6c 75 LE_RTREE.# inclu
02d0: 64 65 20 22 72 74 72 65 65 2e 68 22 0a 23 65 6e de "rtree.h".#en
02e0: 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
02f0: 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 23 20 69 E_ENABLE_ICU.# i
0300: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 69 63 nclude "sqliteic
0310: 75 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 23 69 66 u.h".#endif..#if
0320: 6e 64 65 66 20 53 51 4c 49 54 45 5f 41 4d 41 4c ndef SQLITE_AMAL
0330: 47 41 4d 41 54 49 4f 4e 0a 2f 2a 20 49 4d 50 4c GAMATION./* IMPL
0340: 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 EMENTATION-OF: R
0350: 2d 34 36 36 35 36 2d 34 35 31 35 36 20 54 68 65 -46656-45156 The
0360: 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e sqlite3_version
0370: 5b 5d 20 73 74 72 69 6e 67 20 63 6f 6e 73 74 61 [] string consta
0380: 6e 74 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 nt.** contains t
0390: 68 65 20 74 65 78 74 20 6f 66 20 53 51 4c 49 54 he text of SQLIT
03a0: 45 5f 56 45 52 53 49 4f 4e 20 6d 61 63 72 6f 2e E_VERSION macro.
03b0: 20 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 .*/.const char
03c0: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 5b sqlite3_version[
03d0: 5d 20 3d 20 53 51 4c 49 54 45 5f 56 45 52 53 49 ] = SQLITE_VERSI
03e0: 4f 4e 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 49 ON;.#endif../* I
03f0: 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 MPLEMENTATION-OF
0400: 3a 20 52 2d 35 33 35 33 36 2d 34 32 35 37 35 20 : R-53536-42575
0410: 54 68 65 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 The sqlite3_libv
0420: 65 72 73 69 6f 6e 28 29 20 66 75 6e 63 74 69 6f ersion() functio
0430: 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 61 20 70 n returns.** a p
0440: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 74 6f ointer to the to
0450: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 65 72 the sqlite3_ver
0460: 73 69 6f 6e 5b 5d 20 73 74 72 69 6e 67 20 63 6f sion[] string co
0470: 6e 73 74 61 6e 74 2e 20 0a 2a 2f 0a 63 6f 6e 73 nstant. .*/.cons
0480: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f t char *sqlite3_
0490: 6c 69 62 76 65 72 73 69 6f 6e 28 76 6f 69 64 29 libversion(void)
04a0: 7b 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 { return sqlite3
04b0: 5f 76 65 72 73 69 6f 6e 3b 20 7d 0a 0a 2f 2a 20 _version; }../*
04c0: 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f IMPLEMENTATION-O
04d0: 46 3a 20 52 2d 36 33 31 32 34 2d 33 39 33 30 30 F: R-63124-39300
04e0: 20 54 68 65 20 73 71 6c 69 74 65 33 5f 73 6f 75 The sqlite3_sou
04f0: 72 63 65 69 64 28 29 20 66 75 6e 63 74 69 6f 6e rceid() function
0500: 20 72 65 74 75 72 6e 73 20 61 0a 2a 2a 20 70 6f returns a.** po
0510: 69 6e 74 65 72 20 74 6f 20 61 20 73 74 72 69 6e inter to a strin
0520: 67 20 63 6f 6e 73 74 61 6e 74 20 77 68 6f 73 65 g constant whose
0530: 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 73 61 value is the sa
0540: 6d 65 20 61 73 20 74 68 65 0a 2a 2a 20 53 51 4c me as the.** SQL
0550: 49 54 45 5f 53 4f 55 52 43 45 5f 49 44 20 43 20 ITE_SOURCE_ID C
0560: 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 preprocessor mac
0570: 72 6f 2e 20 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 ro. .*/.const ch
0580: 61 72 20 2a 73 71 6c 69 74 65 33 5f 73 6f 75 72 ar *sqlite3_sour
0590: 63 65 69 64 28 76 6f 69 64 29 7b 20 72 65 74 75 ceid(void){ retu
05a0: 72 6e 20 53 51 4c 49 54 45 5f 53 4f 55 52 43 45 rn SQLITE_SOURCE
05b0: 5f 49 44 3b 20 7d 0a 0a 2f 2a 20 49 4d 50 4c 45 _ID; }../* IMPLE
05c0: 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d MENTATION-OF: R-
05d0: 33 35 32 31 30 2d 36 33 35 30 38 20 54 68 65 20 35210-63508 The
05e0: 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 sqlite3_libversi
05f0: 6f 6e 5f 6e 75 6d 62 65 72 28 29 20 66 75 6e 63 on_number() func
0600: 74 69 6f 6e 0a 2a 2a 20 72 65 74 75 72 6e 73 20 tion.** returns
0610: 61 6e 20 69 6e 74 65 67 65 72 20 65 71 75 61 6c an integer equal
0620: 20 74 6f 20 53 51 4c 49 54 45 5f 56 45 52 53 49 to SQLITE_VERSI
0630: 4f 4e 5f 4e 55 4d 42 45 52 2e 0a 2a 2f 0a 69 6e ON_NUMBER..*/.in
0640: 74 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 t sqlite3_libver
0650: 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 76 6f 69 64 sion_number(void
0660: 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ){ return SQLITE
0670: 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d 42 45 52 3b _VERSION_NUMBER;
0680: 20 7d 0a 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 }../* IMPLEMENT
0690: 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 32 30 37 39 ATION-OF: R-2079
06a0: 30 2d 31 34 30 32 35 20 54 68 65 20 73 71 6c 69 0-14025 The sqli
06b0: 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 29 te3_threadsafe()
06c0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
06d0: 73 0a 2a 2a 20 7a 65 72 6f 20 69 66 20 61 6e 64 s.** zero if and
06e0: 20 6f 6e 6c 79 20 69 66 20 53 51 4c 69 74 65 20 only if SQLite
06f0: 77 61 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 was compiled wit
0700: 68 20 6d 75 74 65 78 69 6e 67 20 63 6f 64 65 20 h mutexing code
0710: 6f 6d 69 74 74 65 64 20 64 75 65 20 74 6f 0a 2a omitted due to.*
0720: 2a 20 74 68 65 20 53 51 4c 49 54 45 5f 54 48 52 * the SQLITE_THR
0730: 45 41 44 53 41 46 45 20 63 6f 6d 70 69 6c 65 2d EADSAFE compile-
0740: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 62 65 69 6e time option bein
0750: 67 20 73 65 74 20 74 6f 20 30 2e 0a 2a 2f 0a 69 g set to 0..*/.i
0760: 6e 74 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61 nt sqlite3_threa
0770: 64 73 61 66 65 28 76 6f 69 64 29 7b 20 72 65 74 dsafe(void){ ret
0780: 75 72 6e 20 53 51 4c 49 54 45 5f 54 48 52 45 41 urn SQLITE_THREA
0790: 44 53 41 46 45 3b 20 7d 0a 0a 23 69 66 20 21 64 DSAFE; }..#if !d
07a0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
07b0: 49 54 5f 54 52 41 43 45 29 20 26 26 20 64 65 66 IT_TRACE) && def
07c0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
07d0: 4c 45 5f 49 4f 54 52 41 43 45 29 0a 2f 2a 0a 2a LE_IOTRACE)./*.*
07e0: 2a 20 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 * If the followi
07f0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e ng function poin
0800: 74 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 ter is not NULL
0810: 61 6e 64 20 69 66 0a 2a 2a 20 53 51 4c 49 54 45 and if.** SQLITE
0820: 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 20 _ENABLE_IOTRACE
0830: 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e is enabled, then
0840: 20 6d 65 73 73 61 67 65 73 20 64 65 73 63 72 69 messages descri
0850: 62 69 6e 67 0a 2a 2a 20 49 2f 4f 20 61 63 74 69 bing.** I/O acti
0860: 76 65 20 61 72 65 20 77 72 69 74 74 65 6e 20 75 ve are written u
0870: 73 69 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 sing this functi
0880: 6f 6e 2e 20 20 54 68 65 73 65 20 6d 65 73 73 61 on. These messa
0890: 67 65 73 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e ges.** are inten
08a0: 64 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e ded for debuggin
08b0: 67 20 61 63 74 69 76 69 74 79 20 6f 6e 6c 79 2e g activity only.
08c0: 0a 2a 2f 0a 76 6f 69 64 20 28 2a 73 71 6c 69 74 .*/.void (*sqlit
08d0: 65 33 49 6f 54 72 61 63 65 29 28 63 6f 6e 73 74 e3IoTrace)(const
08e0: 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 20 3d 20 30 char*, ...) = 0
08f0: 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ;.#endif../*.**
0900: 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 If the following
0910: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 global variable
0920: 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 72 points to a str
0930: 69 6e 67 20 77 68 69 63 68 20 69 73 20 74 68 65 ing which is the
0940: 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 61 20 64 69 .** name of a di
0950: 72 65 63 74 6f 72 79 2c 20 74 68 65 6e 20 74 68 rectory, then th
0960: 61 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 6c at directory wil
0970: 6c 20 62 65 20 75 73 65 64 20 74 6f 20 73 74 6f l be used to sto
0980: 72 65 0a 2a 2a 20 74 65 6d 70 6f 72 61 72 79 20 re.** temporary
0990: 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 files..**.** See
09a0: 20 61 6c 73 6f 20 74 68 65 20 22 50 52 41 47 4d also the "PRAGM
09b0: 41 20 74 65 6d 70 5f 73 74 6f 72 65 5f 64 69 72 A temp_store_dir
09c0: 65 63 74 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d ectory" SQL comm
09d0: 61 6e 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 and..*/.char *sq
09e0: 6c 69 74 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 lite3_temp_direc
09f0: 74 6f 72 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a tory = 0;../*.**
0a00: 20 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e If the followin
0a10: 67 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c g global variabl
0a20: 65 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 e points to a st
0a30: 72 69 6e 67 20 77 68 69 63 68 20 69 73 20 74 68 ring which is th
0a40: 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 61 20 64 e.** name of a d
0a50: 69 72 65 63 74 6f 72 79 2c 20 74 68 65 6e 20 74 irectory, then t
0a60: 68 61 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 hat directory wi
0a70: 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20 73 74 ll be used to st
0a80: 6f 72 65 0a 2a 2a 20 61 6c 6c 20 64 61 74 61 62 ore.** all datab
0a90: 61 73 65 20 66 69 6c 65 73 20 73 70 65 63 69 66 ase files specif
0aa0: 69 65 64 20 77 69 74 68 20 61 20 72 65 6c 61 74 ied with a relat
0ab0: 69 76 65 20 70 61 74 68 6e 61 6d 65 2e 0a 2a 2a ive pathname..**
0ac0: 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 68 65 .** See also the
0ad0: 20 22 50 52 41 47 4d 41 20 64 61 74 61 5f 73 74 "PRAGMA data_st
0ae0: 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 20 53 ore_directory" S
0af0: 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f 0a 63 QL command..*/.c
0b00: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 64 61 74 har *sqlite3_dat
0b10: 61 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 3b a_directory = 0;
0b20: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 ../*.** Initiali
0b30: 7a 65 20 53 51 4c 69 74 65 2e 20 20 0a 2a 2a 0a ze SQLite. .**.
0b40: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
0b50: 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 74 must be called t
0b60: 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 o initialize the
0b70: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
0b80: 6f 6e 2c 0a 2a 2a 20 56 46 53 2c 20 61 6e 64 20 on,.** VFS, and
0b90: 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 6d 73 mutex subsystems
0ba0: 20 70 72 69 6f 72 20 74 6f 20 64 6f 69 6e 67 20 prior to doing
0bb0: 61 6e 79 20 73 65 72 69 6f 75 73 20 77 6f 72 6b any serious work
0bc0: 20 77 69 74 68 0a 2a 2a 20 53 51 4c 69 74 65 2e with.** SQLite.
0bd0: 20 20 42 75 74 20 61 73 20 6c 6f 6e 67 20 61 73 But as long as
0be0: 20 79 6f 75 20 64 6f 20 6e 6f 74 20 63 6f 6d 70 you do not comp
0bf0: 69 6c 65 20 77 69 74 68 20 53 51 4c 49 54 45 5f ile with SQLITE_
0c00: 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 2a 2a OMIT_AUTOINIT.**
0c10: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 this routine wi
0c20: 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 61 75 74 ll be called aut
0c30: 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 6b 65 omatically by ke
0c40: 79 20 72 6f 75 74 69 6e 65 73 20 73 75 63 68 20 y routines such
0c50: 61 73 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 as.** sqlite3_op
0c60: 65 6e 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 en(). .**.** Th
0c70: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 is routine is a
0c80: 6e 6f 2d 6f 70 20 65 78 63 65 70 74 20 6f 6e 20 no-op except on
0c90: 69 74 73 20 76 65 72 79 20 66 69 72 73 74 20 63 its very first c
0ca0: 61 6c 6c 20 66 6f 72 20 74 68 65 20 70 72 6f 63 all for the proc
0cb0: 65 73 73 2c 0a 2a 2a 20 6f 72 20 66 6f 72 20 74 ess,.** or for t
0cc0: 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20 61 66 he first call af
0cd0: 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 ter a call to sq
0ce0: 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 6e 2e 0a lite3_shutdown..
0cf0: 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 **.** The first
0d00: 74 68 72 65 61 64 20 74 6f 20 63 61 6c 6c 20 74 thread to call t
0d10: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 75 6e 73 his routine runs
0d20: 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 the initializat
0d30: 69 6f 6e 20 74 6f 0a 2a 2a 20 63 6f 6d 70 6c 65 ion to.** comple
0d40: 74 69 6f 6e 2e 20 20 49 66 20 73 75 62 73 65 71 tion. If subseq
0d50: 75 65 6e 74 20 74 68 72 65 61 64 73 20 63 61 6c uent threads cal
0d60: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 62 l this routine b
0d70: 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 0a efore the first.
0d80: 2a 2a 20 74 68 72 65 61 64 20 68 61 73 20 66 69 ** thread has fi
0d90: 6e 69 73 68 65 64 20 74 68 65 20 69 6e 69 74 69 nished the initi
0da0: 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 63 65 73 alization proces
0db0: 73 2c 20 74 68 65 6e 20 74 68 65 20 73 75 62 73 s, then the subs
0dc0: 65 71 75 65 6e 74 0a 2a 2a 20 74 68 72 65 61 64 equent.** thread
0dd0: 73 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e 74 s must block unt
0de0: 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 68 72 il the first thr
0df0: 65 61 64 20 66 69 6e 69 73 68 65 73 20 77 69 74 ead finishes wit
0e00: 68 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 h the initializa
0e10: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 tion..**.** The
0e20: 66 69 72 73 74 20 74 68 72 65 61 64 20 6d 69 67 first thread mig
0e30: 68 74 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 ht call this rou
0e40: 74 69 6e 65 20 72 65 63 75 72 73 69 76 65 6c 79 tine recursively
0e50: 2e 20 20 52 65 63 75 72 73 69 76 65 0a 2a 2a 20 . Recursive.**
0e60: 63 61 6c 6c 73 20 74 6f 20 74 68 69 73 20 72 6f calls to this ro
0e70: 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6e 6f 74 utine should not
0e80: 20 62 6c 6f 63 6b 2c 20 6f 66 20 63 6f 75 72 73 block, of cours
0e90: 65 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 e. Otherwise th
0ea0: 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 61 74 e.** initializat
0eb0: 69 6f 6e 20 70 72 6f 63 65 73 73 20 77 6f 75 6c ion process woul
0ec0: 64 20 6e 65 76 65 72 20 63 6f 6d 70 6c 65 74 65 d never complete
0ed0: 2e 0a 2a 2a 0a 2a 2a 20 4c 65 74 20 58 20 62 65 ..**.** Let X be
0ee0: 20 74 68 65 20 66 69 72 73 74 20 74 68 72 65 61 the first threa
0ef0: 64 20 74 6f 20 65 6e 74 65 72 20 74 68 69 73 20 d to enter this
0f00: 72 6f 75 74 69 6e 65 2e 20 20 4c 65 74 20 59 20 routine. Let Y
0f10: 62 65 20 73 6f 6d 65 20 6f 74 68 65 72 0a 2a 2a be some other.**
0f20: 20 74 68 72 65 61 64 2e 20 20 54 68 65 6e 20 77 thread. Then w
0f30: 68 69 6c 65 20 74 68 65 20 69 6e 69 74 69 61 6c hile the initial
0f40: 20 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 20 74 invocation of t
0f50: 68 69 73 20 72 6f 75 74 69 6e 65 20 62 79 20 58 his routine by X
0f60: 20 69 73 0a 2a 2a 20 69 6e 63 6f 6d 70 6c 65 74 is.** incomplet
0f70: 65 2c 20 69 74 20 69 73 20 72 65 71 75 69 72 65 e, it is require
0f80: 64 20 74 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 d that:.**.**
0f90: 20 2a 20 20 43 61 6c 6c 73 20 74 6f 20 74 68 69 * Calls to thi
0fa0: 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 59 s routine from Y
0fb0: 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e 74 69 must block unti
0fc0: 6c 20 74 68 65 20 6f 75 74 65 72 2d 6d 6f 73 74 l the outer-most
0fd0: 0a 2a 2a 20 20 20 20 20 20 20 63 61 6c 6c 20 62 .** call b
0fe0: 79 20 58 20 63 6f 6d 70 6c 65 74 65 73 2e 0a 2a y X completes..*
0ff0: 2a 0a 2a 2a 20 20 20 20 2a 20 20 52 65 63 75 72 *.** * Recur
1000: 73 69 76 65 20 63 61 6c 6c 73 20 74 6f 20 74 68 sive calls to th
1010: 69 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 is routine from
1020: 74 68 72 65 61 64 20 58 20 72 65 74 75 72 6e 20 thread X return
1030: 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a 20 20 immediately.**
1040: 20 20 20 20 20 77 69 74 68 6f 75 74 20 62 6c 6f without blo
1050: 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 cking..*/.int sq
1060: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
1070: 28 76 6f 69 64 29 7b 0a 20 20 4d 55 54 45 58 5f (void){. MUTEX_
1080: 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 5f 6d LOGIC( sqlite3_m
1090: 75 74 65 78 20 2a 70 4d 61 73 74 65 72 3b 20 29 utex *pMaster; )
10a0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 /* The ma
10b0: 69 6e 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 in static mutex
10c0: 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 */. int rc;
10d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10f0: 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 /* Result code
1100: 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
1110: 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 20 69 E_EXTRA_INIT. i
1120: 6e 74 20 62 52 75 6e 45 78 74 72 61 49 6e 69 74 nt bRunExtraInit
1130: 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
1140: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
1150: 78 74 72 61 20 69 6e 69 74 69 61 6c 69 7a 61 74 xtra initializat
1160: 69 6f 6e 20 6e 65 65 64 65 64 20 2a 2f 0a 23 65 ion needed */.#e
1170: 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
1180: 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 72 ITE_OMIT_WSD. r
1190: 63 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 5f c = sqlite3_wsd_
11a0: 69 6e 69 74 28 34 30 39 36 2c 20 32 34 29 3b 0a init(4096, 24);.
11b0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
11c0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 _OK ){. retur
11d0: 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 n rc;. }.#endif
11e0: 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 69 74 65 .. /* If SQLite
11f0: 20 69 73 20 61 6c 72 65 61 64 79 20 63 6f 6d 70 is already comp
1200: 6c 65 74 65 6c 79 20 69 6e 69 74 69 61 6c 69 7a letely initializ
1210: 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 63 61 ed, then this ca
1220: 6c 6c 0a 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 ll. ** to sqlit
1230: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 e3_initialize()
1240: 73 68 6f 75 6c 64 20 62 65 20 61 20 6e 6f 2d 6f should be a no-o
1250: 70 2e 20 20 42 75 74 20 74 68 65 20 69 6e 69 74 p. But the init
1260: 69 61 6c 69 7a 61 74 69 6f 6e 0a 20 20 2a 2a 20 ialization. **
1270: 6d 75 73 74 20 62 65 20 63 6f 6d 70 6c 65 74 65 must be complete
1280: 2e 20 20 53 6f 20 69 73 49 6e 69 74 20 6d 75 73 . So isInit mus
1290: 74 20 6e 6f 74 20 62 65 20 73 65 74 20 75 6e 74 t not be set unt
12a0: 69 6c 20 74 68 65 20 76 65 72 79 20 65 6e 64 0a il the very end.
12b0: 20 20 2a 2a 20 6f 66 20 74 68 69 73 20 72 6f 75 ** of this rou
12c0: 74 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 tine.. */. if(
12d0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
12e0: 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 65 nfig.isInit ) re
12f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
1300: 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 . /* Make sure
1310: 74 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 the mutex subsys
1320: 74 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 7a tem is initializ
1330: 65 64 2e 20 20 49 66 20 75 6e 61 62 6c 65 20 74 ed. If unable t
1340: 6f 20 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 o . ** initiali
1350: 7a 65 20 74 68 65 20 6d 75 74 65 78 20 73 75 62 ze the mutex sub
1360: 73 79 73 74 65 6d 2c 20 72 65 74 75 72 6e 20 65 system, return e
1370: 61 72 6c 79 20 77 69 74 68 20 74 68 65 20 65 72 arly with the er
1380: 72 6f 72 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 ror.. ** If the
1390: 20 73 79 73 74 65 6d 20 69 73 20 73 6f 20 73 69 system is so si
13a0: 63 6b 20 74 68 61 74 20 77 65 20 61 72 65 20 75 ck that we are u
13b0: 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 nable to allocat
13c0: 65 20 61 20 6d 75 74 65 78 2c 0a 20 20 2a 2a 20 e a mutex,. **
13d0: 74 68 65 72 65 20 69 73 20 6e 6f 74 20 6d 75 63 there is not muc
13e0: 68 20 53 51 4c 69 74 65 20 69 73 20 67 6f 69 6e h SQLite is goin
13f0: 67 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 g to be able to
1400: 64 6f 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 do.. **. ** Th
1410: 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 e mutex subsyste
1420: 6d 20 6d 75 73 74 20 74 61 6b 65 20 63 61 72 65 m must take care
1430: 20 6f 66 20 73 65 72 69 61 6c 69 7a 69 6e 67 20 of serializing
1440: 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 69 6e 69 its own. ** ini
1450: 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 2a tialization.. *
1460: 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 /. rc = sqlite3
1470: 4d 75 74 65 78 49 6e 69 74 28 29 3b 0a 20 20 69 MutexInit();. i
1480: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
1490: 63 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c c;.. /* Initial
14a0: 69 7a 65 20 74 68 65 20 6d 61 6c 6c 6f 63 28 29 ize the malloc()
14b0: 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 65 20 system and the
14c0: 72 65 63 75 72 73 69 76 65 20 70 49 6e 69 74 4d recursive pInitM
14d0: 75 74 65 78 20 6d 75 74 65 78 2e 0a 20 20 2a 2a utex mutex.. **
14e0: 20 54 68 69 73 20 6f 70 65 72 61 74 69 6f 6e 20 This operation
14f0: 69 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 is protected by
1500: 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 45 the STATIC_MASTE
1510: 52 20 6d 75 74 65 78 2e 20 20 4e 6f 74 65 20 74 R mutex. Note t
1520: 68 61 74 0a 20 20 2a 2a 20 4d 75 74 65 78 41 6c hat. ** MutexAl
1530: 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64 20 loc() is called
1540: 66 6f 72 20 61 20 73 74 61 74 69 63 20 6d 75 74 for a static mut
1550: 65 78 20 70 72 69 6f 72 20 74 6f 20 69 6e 69 74 ex prior to init
1560: 69 61 6c 69 7a 69 6e 67 20 74 68 65 0a 20 20 2a ializing the. *
1570: 2a 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 * malloc subsyst
1580: 65 6d 20 2d 20 74 68 69 73 20 69 6d 70 6c 69 65 em - this implie
1590: 73 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 s that the alloc
15a0: 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 69 ation of a stati
15b0: 63 0a 20 20 2a 2a 20 6d 75 74 65 78 20 6d 75 73 c. ** mutex mus
15c0: 74 20 6e 6f 74 20 72 65 71 75 69 72 65 20 73 75 t not require su
15d0: 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20 6d pport from the m
15e0: 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 2e alloc subsystem.
15f0: 0a 20 20 2a 2f 0a 20 20 4d 55 54 45 58 5f 4c 4f . */. MUTEX_LO
1600: 47 49 43 28 20 70 4d 61 73 74 65 72 20 3d 20 73 GIC( pMaster = s
1610: 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
1620: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 (SQLITE_MUTEX_ST
1630: 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 20 29 0a ATIC_MASTER); ).
1640: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1650: 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a enter(pMaster);.
1660: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
1670: 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 onfig.isMutexIni
1680: 74 20 3d 20 31 3b 0a 20 20 69 66 28 20 21 73 71 t = 1;. if( !sq
1690: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
16a0: 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 29 g.isMallocInit )
16b0: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
16c0: 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 29 3b 0a e3MallocInit();.
16d0: 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
16e0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 LITE_OK ){. s
16f0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1700: 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 ig.isMallocInit
1710: 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 21 73 71 = 1;. if( !sq
1720: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1730: 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 29 7b 0a g.pInitMutex ){.
1740: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
1750: 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d balConfig.pInitM
1760: 75 74 65 78 20 3d 0a 20 20 20 20 20 20 20 20 20 utex =.
1770: 20 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c sqlite3MutexAl
1780: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
1790: 5f 52 45 43 55 52 53 49 56 45 29 3b 0a 20 20 20 _RECURSIVE);.
17a0: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c if( sqlite3Gl
17b0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 obalConfig.bCore
17c0: 4d 75 74 65 78 20 26 26 20 21 73 71 6c 69 74 65 Mutex && !sqlite
17d0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 3GlobalConfig.pI
17e0: 6e 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 nitMutex ){.
17f0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
1800: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 NOMEM;. }.
1810: 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 }. }. if( r
1820: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1830: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1840: 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 lConfig.nRefInit
1850: 4d 75 74 65 78 2b 2b 3b 0a 20 20 7d 0a 20 20 73 Mutex++;. }. s
1860: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1870: 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 ve(pMaster);..
1880: 2f 2a 20 49 66 20 72 63 20 69 73 20 6e 6f 74 20 /* If rc is not
1890: 53 51 4c 49 54 45 5f 4f 4b 20 61 74 20 74 68 69 SQLITE_OK at thi
18a0: 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 65 69 s point, then ei
18b0: 74 68 65 72 20 74 68 65 20 6d 61 6c 6c 6f 63 0a ther the malloc.
18c0: 20 20 2a 2a 20 73 75 62 73 79 73 74 65 6d 20 63 ** subsystem c
18d0: 6f 75 6c 64 20 6e 6f 74 20 62 65 20 69 6e 69 74 ould not be init
18e0: 69 61 6c 69 7a 65 64 20 6f 72 20 74 68 65 20 73 ialized or the s
18f0: 79 73 74 65 6d 20 66 61 69 6c 65 64 20 74 6f 20 ystem failed to
1900: 61 6c 6c 6f 63 61 74 65 0a 20 20 2a 2a 20 74 68 allocate. ** th
1910: 65 20 70 49 6e 69 74 4d 75 74 65 78 20 6d 75 74 e pInitMutex mut
1920: 65 78 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 ex. Return an er
1930: 72 6f 72 20 69 6e 20 65 69 74 68 65 72 20 63 61 ror in either ca
1940: 73 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 se. */. if( rc
1950: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
1960: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1970: 7d 0a 0a 20 20 2f 2a 20 44 6f 20 74 68 65 20 72 }.. /* Do the r
1980: 65 73 74 20 6f 66 20 74 68 65 20 69 6e 69 74 69 est of the initi
1990: 61 6c 69 7a 61 74 69 6f 6e 20 75 6e 64 65 72 20 alization under
19a0: 74 68 65 20 72 65 63 75 72 73 69 76 65 20 6d 75 the recursive mu
19b0: 74 65 78 20 73 6f 0a 20 20 2a 2a 20 74 68 61 74 tex so. ** that
19c0: 20 77 65 20 77 69 6c 6c 20 62 65 20 61 62 6c 65 we will be able
19d0: 20 74 6f 20 68 61 6e 64 6c 65 20 72 65 63 75 72 to handle recur
19e0: 73 69 76 65 20 63 61 6c 6c 73 20 69 6e 74 6f 0a sive calls into.
19f0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6e 69 ** sqlite3_ini
1a00: 74 69 61 6c 69 7a 65 28 29 2e 20 20 54 68 65 20 tialize(). The
1a10: 72 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 recursive calls
1a20: 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6d 65 20 74 68 normally come th
1a30: 72 6f 75 67 68 0a 20 20 2a 2a 20 73 71 6c 69 74 rough. ** sqlit
1a40: 65 33 5f 6f 73 5f 69 6e 69 74 28 29 20 77 68 65 e3_os_init() whe
1a50: 6e 20 69 74 20 69 6e 76 6f 6b 65 73 20 73 71 6c n it invokes sql
1a60: 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 65 ite3_vfs_registe
1a70: 72 28 29 2c 20 62 75 74 20 6f 74 68 65 72 0a 20 r(), but other.
1a80: 20 2a 2a 20 72 65 63 75 72 73 69 76 65 20 63 61 ** recursive ca
1a90: 6c 6c 73 20 6d 69 67 68 74 20 61 6c 73 6f 20 62 lls might also b
1aa0: 65 20 70 6f 73 73 69 62 6c 65 2e 0a 20 20 2a 2a e possible.. **
1ab0: 0a 20 20 2a 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 . ** IMPLEMENTA
1ac0: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 30 30 31 34 30 TION-OF: R-00140
1ad0: 2d 33 37 34 34 35 20 53 51 4c 69 74 65 20 61 75 -37445 SQLite au
1ae0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 65 72 69 tomatically seri
1af0: 61 6c 69 7a 65 73 20 63 61 6c 6c 73 0a 20 20 2a alizes calls. *
1b00: 2a 20 74 6f 20 74 68 65 20 78 49 6e 69 74 20 6d * to the xInit m
1b10: 65 74 68 6f 64 2c 20 73 6f 20 74 68 65 20 78 49 ethod, so the xI
1b20: 6e 69 74 20 6d 65 74 68 6f 64 20 6e 65 65 64 20 nit method need
1b30: 6e 6f 74 20 62 65 20 74 68 72 65 61 64 73 61 66 not be threadsaf
1b40: 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 e.. **. ** The
1b50: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 75 74 65 78 following mutex
1b60: 20 69 73 20 77 68 61 74 20 73 65 72 69 61 6c 69 is what seriali
1b70: 7a 65 73 20 61 63 63 65 73 73 20 74 6f 20 74 68 zes access to th
1b80: 65 20 61 70 70 64 65 66 20 70 63 61 63 68 65 20 e appdef pcache
1b90: 78 49 6e 69 74 0a 20 20 2a 2a 20 6d 65 74 68 6f xInit. ** metho
1ba0: 64 73 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 ds. The sqlite3
1bb0: 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2e _pcache_methods.
1bc0: 78 49 6e 69 74 28 29 20 61 6c 6c 20 69 73 20 65 xInit() all is e
1bd0: 6d 62 65 64 64 65 64 20 69 6e 20 74 68 65 0a 20 mbedded in the.
1be0: 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 ** call to sqli
1bf0: 74 65 33 50 63 61 63 68 65 49 6e 69 74 69 61 6c te3PcacheInitial
1c00: 69 7a 65 28 29 2e 0a 20 20 2a 2f 0a 20 20 73 71 ize().. */. sq
1c10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
1c20: 72 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 r(sqlite3GlobalC
1c30: 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 onfig.pInitMutex
1c40: 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 );. if( sqlite3
1c50: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 GlobalConfig.isI
1c60: 6e 69 74 3d 3d 30 20 26 26 20 73 71 6c 69 74 65 nit==0 && sqlite
1c70: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 3GlobalConfig.in
1c80: 50 72 6f 67 72 65 73 73 3d 3d 30 20 29 7b 0a 20 Progress==0 ){.
1c90: 20 20 20 46 75 6e 63 44 65 66 48 61 73 68 20 2a FuncDefHash *
1ca0: 70 48 61 73 68 20 3d 20 26 47 4c 4f 42 41 4c 28 pHash = &GLOBAL(
1cb0: 46 75 6e 63 44 65 66 48 61 73 68 2c 20 73 71 6c FuncDefHash, sql
1cc0: 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 ite3GlobalFuncti
1cd0: 6f 6e 73 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 ons);. sqlite
1ce0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 3GlobalConfig.in
1cf0: 50 72 6f 67 72 65 73 73 20 3d 20 31 3b 0a 20 20 Progress = 1;.
1d00: 20 20 6d 65 6d 73 65 74 28 70 48 61 73 68 2c 20 memset(pHash,
1d10: 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 0, sizeof(sqlite
1d20: 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 3GlobalFunctions
1d30: 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 ));. sqlite3R
1d40: 65 67 69 73 74 65 72 47 6c 6f 62 61 6c 46 75 6e egisterGlobalFun
1d50: 63 74 69 6f 6e 73 28 29 3b 0a 20 20 20 20 69 66 ctions();. if
1d60: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
1d70: 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 6e onfig.isPCacheIn
1d80: 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 it==0 ){. r
1d90: 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 c = sqlite3Pcach
1da0: 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 eInitialize();.
1db0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d }. if( rc=
1dc0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1dd0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1de0: 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 lConfig.isPCache
1df0: 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 Init = 1;.
1e00: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 49 6e rc = sqlite3OsIn
1e10: 69 74 28 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 it();. }.
1e20: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1e30: 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
1e40: 65 33 50 43 61 63 68 65 42 75 66 66 65 72 53 65 e3PCacheBufferSe
1e50: 74 75 70 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 tup( sqlite3Glob
1e60: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 2c 20 alConfig.pPage,
1e70: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
1e80: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 e3GlobalConfig.s
1e90: 7a 50 61 67 65 2c 20 73 71 6c 69 74 65 33 47 6c zPage, sqlite3Gl
1ea0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 obalConfig.nPage
1eb0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
1ec0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 GlobalConfig.isI
1ed0: 6e 69 74 20 3d 20 31 3b 0a 23 69 66 64 65 66 20 nit = 1;.#ifdef
1ee0: 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 SQLITE_EXTRA_INI
1ef0: 54 0a 20 20 20 20 20 20 62 52 75 6e 45 78 74 72 T. bRunExtr
1f00: 61 49 6e 69 74 20 3d 20 31 3b 0a 23 65 6e 64 69 aInit = 1;.#endi
1f10: 66 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 f. }. sqli
1f20: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1f30: 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a inProgress = 0;.
1f40: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
1f50: 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 tex_leave(sqlite
1f60: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 3GlobalConfig.pI
1f70: 6e 69 74 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a nitMutex);.. /*
1f80: 20 47 6f 20 62 61 63 6b 20 75 6e 64 65 72 20 74 Go back under t
1f90: 68 65 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 he static mutex
1fa0: 61 6e 64 20 63 6c 65 61 6e 20 75 70 20 74 68 65 and clean up the
1fb0: 20 72 65 63 75 72 73 69 76 65 0a 20 20 2a 2a 20 recursive. **
1fc0: 6d 75 74 65 78 20 74 6f 20 70 72 65 76 65 6e 74 mutex to prevent
1fd0: 20 61 20 72 65 73 6f 75 72 63 65 20 6c 65 61 6b a resource leak
1fe0: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
1ff0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 _mutex_enter(pMa
2000: 73 74 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 ster);. sqlite3
2010: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 GlobalConfig.nRe
2020: 66 49 6e 69 74 4d 75 74 65 78 2d 2d 3b 0a 20 20 fInitMutex--;.
2030: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
2040: 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 lConfig.nRefInit
2050: 4d 75 74 65 78 3c 3d 30 20 29 7b 0a 20 20 20 20 Mutex<=0 ){.
2060: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 47 assert( sqlite3G
2070: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 lobalConfig.nRef
2080: 49 6e 69 74 4d 75 74 65 78 3d 3d 30 20 29 3b 0a InitMutex==0 );.
2090: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
20a0: 78 5f 66 72 65 65 28 73 71 6c 69 74 65 33 47 6c x_free(sqlite3Gl
20b0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
20c0: 4d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 Mutex);. sqli
20d0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
20e0: 70 49 6e 69 74 4d 75 74 65 78 20 3d 20 30 3b 0a pInitMutex = 0;.
20f0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
2100: 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 tex_leave(pMaste
2110: 72 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f r);.. /* The fo
2120: 6c 6c 6f 77 69 6e 67 20 69 73 20 6a 75 73 74 20 llowing is just
2130: 61 20 73 61 6e 69 74 79 20 63 68 65 63 6b 20 74 a sanity check t
2140: 6f 20 6d 61 6b 65 20 73 75 72 65 20 53 51 4c 69 o make sure SQLi
2150: 74 65 20 68 61 73 0a 20 20 2a 2a 20 62 65 65 6e te has. ** been
2160: 20 63 6f 6d 70 69 6c 65 64 20 63 6f 72 72 65 63 compiled correc
2170: 74 6c 79 2e 20 20 49 74 20 69 73 20 69 6d 70 6f tly. It is impo
2180: 72 74 61 6e 74 20 74 6f 20 72 75 6e 20 74 68 69 rtant to run thi
2190: 73 20 63 6f 64 65 2c 20 62 75 74 0a 20 20 2a 2a s code, but. **
21a0: 20 77 65 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 we don't want t
21b0: 6f 20 72 75 6e 20 69 74 20 74 6f 6f 20 6f 66 74 o run it too oft
21c0: 65 6e 20 61 6e 64 20 73 6f 61 6b 20 75 70 20 43 en and soak up C
21d0: 50 55 20 63 79 63 6c 65 73 20 66 6f 72 20 6e 6f PU cycles for no
21e0: 0a 20 20 2a 2a 20 72 65 61 73 6f 6e 2e 20 20 53 . ** reason. S
21f0: 6f 20 77 65 20 72 75 6e 20 69 74 20 6f 6e 63 65 o we run it once
2200: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 during initiali
2210: 7a 61 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 66 zation.. */.#if
2220: 6e 64 65 66 20 4e 44 45 42 55 47 0a 23 69 66 6e ndef NDEBUG.#ifn
2230: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2240: 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 FLOATING_POINT.
2250: 20 2f 2a 20 54 68 69 73 20 73 65 63 74 69 6f 6e /* This section
2260: 20 6f 66 20 63 6f 64 65 27 73 20 6f 6e 6c 79 20 of code's only
2270: 22 6f 75 74 70 75 74 22 20 69 73 20 76 69 61 20 "output" is via
2280: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
2290: 6e 74 73 2e 20 2a 2f 0a 20 20 69 66 20 28 20 72 nts. */. if ( r
22a0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
22b0: 20 20 20 20 75 36 34 20 78 20 3d 20 28 28 28 75 u64 x = (((u
22c0: 36 34 29 31 29 3c 3c 36 33 29 2d 31 3b 0a 20 20 64)1)<<63)-1;.
22d0: 20 20 64 6f 75 62 6c 65 20 79 3b 0a 20 20 20 20 double y;.
22e0: 61 73 73 65 72 74 28 73 69 7a 65 6f 66 28 78 29 assert(sizeof(x)
22f0: 3d 3d 38 29 3b 0a 20 20 20 20 61 73 73 65 72 74 ==8);. assert
2300: 28 73 69 7a 65 6f 66 28 78 29 3d 3d 73 69 7a 65 (sizeof(x)==size
2310: 6f 66 28 79 29 29 3b 0a 20 20 20 20 6d 65 6d 63 of(y));. memc
2320: 70 79 28 26 79 2c 20 26 78 2c 20 38 29 3b 0a 20 py(&y, &x, 8);.
2330: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
2340: 65 33 49 73 4e 61 4e 28 79 29 20 29 3b 0a 20 20 e3IsNaN(y) );.
2350: 7d 0a 23 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a }.#endif.#endif.
2360: 0a 20 20 2f 2a 20 44 6f 20 65 78 74 72 61 20 69 . /* Do extra i
2370: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 73 74 nitialization st
2380: 65 70 73 20 72 65 71 75 65 73 74 65 64 20 62 79 eps requested by
2390: 20 74 68 65 20 53 51 4c 49 54 45 5f 45 58 54 52 the SQLITE_EXTR
23a0: 41 5f 49 4e 49 54 0a 20 20 2a 2a 20 63 6f 6d 70 A_INIT. ** comp
23b0: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2e ile-time option.
23c0: 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c . */.#ifdef SQL
23d0: 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 ITE_EXTRA_INIT.
23e0: 20 69 66 28 20 62 52 75 6e 45 78 74 72 61 49 6e if( bRunExtraIn
23f0: 69 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 53 51 it ){. int SQ
2400: 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 28 LITE_EXTRA_INIT(
2410: 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
2420: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 58 rc = SQLITE_EX
2430: 54 52 41 5f 49 4e 49 54 28 30 29 3b 0a 20 20 7d TRA_INIT(0);. }
2440: 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 .#endif.. retur
2450: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 n rc;.}../*.** U
2460: 6e 64 6f 20 74 68 65 20 65 66 66 65 63 74 73 20 ndo the effects
2470: 6f 66 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 of sqlite3_initi
2480: 61 6c 69 7a 65 28 29 2e 20 20 4d 75 73 74 20 6e alize(). Must n
2490: 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 77 68 69 ot be called whi
24a0: 6c 65 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 20 le.** there are
24b0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 61 74 61 outstanding data
24c0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
24d0: 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 or memory alloc
24e0: 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 77 68 69 ations or.** whi
24f0: 6c 65 20 61 6e 79 20 70 61 72 74 20 6f 66 20 53 le any part of S
2500: 51 4c 69 74 65 20 69 73 20 6f 74 68 65 72 77 69 QLite is otherwi
2510: 73 65 20 69 6e 20 75 73 65 20 69 6e 20 61 6e 79 se in use in any
2520: 20 74 68 72 65 61 64 2e 20 20 54 68 69 73 0a 2a thread. This.*
2530: 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 * routine is not
2540: 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 42 75 threadsafe. Bu
2550: 74 20 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 t it is safe to
2560: 69 6e 76 6f 6b 65 20 74 68 69 73 20 72 6f 75 74 invoke this rout
2570: 69 6e 65 0a 2a 2a 20 6f 6e 20 77 68 65 6e 20 53 ine.** on when S
2580: 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 64 79 QLite is already
2590: 20 73 68 75 74 20 64 6f 77 6e 2e 20 20 49 66 20 shut down. If
25a0: 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 64 SQLite is alread
25b0: 79 20 73 68 75 74 20 64 6f 77 6e 0a 2a 2a 20 77 y shut down.** w
25c0: 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 hen this routine
25d0: 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 65 is invoked, the
25e0: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 n this routine i
25f0: 73 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d s a harmless no-
2600: 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 op..*/.int sqlit
2610: 65 33 5f 73 68 75 74 64 6f 77 6e 28 76 6f 69 64 e3_shutdown(void
2620: 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 ){. if( sqlite3
2630: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 GlobalConfig.isI
2640: 6e 69 74 20 29 7b 0a 23 69 66 64 65 66 20 53 51 nit ){.#ifdef SQ
2650: 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 44 LITE_EXTRA_SHUTD
2660: 4f 57 4e 0a 20 20 20 20 76 6f 69 64 20 53 51 4c OWN. void SQL
2670: 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 44 4f ITE_EXTRA_SHUTDO
2680: 57 4e 28 76 6f 69 64 29 3b 0a 20 20 20 20 53 51 WN(void);. SQ
2690: 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 44 LITE_EXTRA_SHUTD
26a0: 4f 57 4e 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20 OWN();.#endif.
26b0: 20 20 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 sqlite3_os_end
26c0: 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ();. sqlite3_
26d0: 72 65 73 65 74 5f 61 75 74 6f 5f 65 78 74 65 6e reset_auto_exten
26e0: 73 69 6f 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 sion();. sqli
26f0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2700: 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a isInit = 0;. }.
2710: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
2720: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 balConfig.isPCac
2730: 68 65 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 heInit ){. sq
2740: 6c 69 74 65 33 50 63 61 63 68 65 53 68 75 74 64 lite3PcacheShutd
2750: 6f 77 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 own();. sqlit
2760: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
2770: 73 50 43 61 63 68 65 49 6e 69 74 20 3d 20 30 3b sPCacheInit = 0;
2780: 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 . }. if( sqlit
2790: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
27a0: 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 sMallocInit ){.
27b0: 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 sqlite3Malloc
27c0: 45 6e 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 End();. sqlit
27d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
27e0: 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 3d 20 30 3b sMallocInit = 0;
27f0: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
2800: 5f 4f 4d 49 54 5f 53 48 55 54 44 4f 57 4e 5f 44 _OMIT_SHUTDOWN_D
2810: 49 52 45 43 54 4f 52 49 45 53 0a 20 20 20 20 2f IRECTORIES. /
2820: 2a 20 54 68 65 20 68 65 61 70 20 73 75 62 73 79 * The heap subsy
2830: 73 74 65 6d 20 68 61 73 20 6e 6f 77 20 62 65 65 stem has now bee
2840: 6e 20 73 68 75 74 64 6f 77 6e 20 61 6e 64 20 74 n shutdown and t
2850: 68 65 73 65 20 76 61 6c 75 65 73 20 61 72 65 20 hese values are
2860: 73 75 70 70 6f 73 65 64 0a 20 20 20 20 2a 2a 20 supposed. **
2870: 74 6f 20 62 65 20 4e 55 4c 4c 20 6f 72 20 70 6f to be NULL or po
2880: 69 6e 74 20 74 6f 20 6d 65 6d 6f 72 79 20 74 68 int to memory th
2890: 61 74 20 77 61 73 20 6f 62 74 61 69 6e 65 64 20 at was obtained
28a0: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c from sqlite3_mal
28b0: 6c 6f 63 28 29 2c 0a 20 20 20 20 2a 2a 20 77 68 loc(),. ** wh
28c0: 69 63 68 20 77 6f 75 6c 64 20 72 65 6c 79 20 6f ich would rely o
28d0: 6e 20 74 68 61 74 20 68 65 61 70 20 73 75 62 73 n that heap subs
28e0: 79 73 74 65 6d 3b 20 74 68 65 72 65 66 6f 72 65 ystem; therefore
28f0: 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 73 , make sure thes
2900: 65 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 73 20 e. ** values
2910: 63 61 6e 6e 6f 74 20 72 65 66 65 72 20 74 6f 20 cannot refer to
2920: 68 65 61 70 20 6d 65 6d 6f 72 79 20 74 68 61 74 heap memory that
2930: 20 77 61 73 20 6a 75 73 74 20 69 6e 76 61 6c 69 was just invali
2940: 64 61 74 65 64 20 77 68 65 6e 20 74 68 65 0a 20 dated when the.
2950: 20 20 20 2a 2a 20 68 65 61 70 20 73 75 62 73 79 ** heap subsy
2960: 73 74 65 6d 20 77 61 73 20 73 68 75 74 64 6f 77 stem was shutdow
2970: 6e 2e 20 20 54 68 69 73 20 69 73 20 6f 6e 6c 79 n. This is only
2980: 20 64 6f 6e 65 20 69 66 20 74 68 65 20 63 75 72 done if the cur
2990: 72 65 6e 74 20 63 61 6c 6c 20 74 6f 0a 20 20 20 rent call to.
29a0: 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 6f ** this functio
29b0: 6e 20 72 65 73 75 6c 74 65 64 20 69 6e 20 74 68 n resulted in th
29c0: 65 20 68 65 61 70 20 73 75 62 73 79 73 74 65 6d e heap subsystem
29d0: 20 61 63 74 75 61 6c 6c 79 20 62 65 69 6e 67 20 actually being
29e0: 73 68 75 74 64 6f 77 6e 2e 0a 20 20 20 20 2a 2f shutdown.. */
29f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 64 61 74 . sqlite3_dat
2a00: 61 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 3b a_directory = 0;
2a10: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 74 65 6d . sqlite3_tem
2a20: 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 3b p_directory = 0;
2a30: 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 .#endif. }. if
2a40: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
2a50: 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 onfig.isMutexIni
2a60: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 t ){. sqlite3
2a70: 4d 75 74 65 78 45 6e 64 28 29 3b 0a 20 20 20 20 MutexEnd();.
2a80: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2a90: 66 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 74 20 fig.isMutexInit
2aa0: 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 = 0;. }.. retu
2ab0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
2ac0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 41 50 49 20 ./*.** This API
2ad0: 61 6c 6c 6f 77 73 20 61 70 70 6c 69 63 61 74 69 allows applicati
2ae0: 6f 6e 73 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 ons to modify th
2af0: 65 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 75 e global configu
2b00: 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 65 ration of.** the
2b10: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 SQLite library
2b20: 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2a 0a at run-time..**.
2b30: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
2b40: 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 should only be c
2b50: 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 72 65 alled when there
2b60: 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 are no outstand
2b70: 69 6e 67 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 ing.** database
2b80: 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 72 20 6d connections or m
2b90: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
2ba0: 73 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 s. This routine
2bb0: 20 69 73 20 6e 6f 74 0a 2a 2a 20 74 68 72 65 61 is not.** threa
2bc0: 64 73 61 66 65 2e 20 20 46 61 69 6c 75 72 65 20 dsafe. Failure
2bd0: 74 6f 20 68 65 65 64 20 74 68 65 73 65 20 77 61 to heed these wa
2be0: 72 6e 69 6e 67 73 20 63 61 6e 20 6c 65 61 64 20 rnings can lead
2bf0: 74 6f 20 75 6e 70 72 65 64 69 63 74 61 62 6c 65 to unpredictable
2c00: 0a 2a 2a 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2f .** behavior..*/
2c10: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6e .int sqlite3_con
2c20: 66 69 67 28 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 fig(int op, ...)
2c30: 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a {. va_list ap;.
2c40: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
2c50: 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 73 71 6c 69 E_OK;.. /* sqli
2c60: 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 73 68 61 te3_config() sha
2c70: 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ll return SQLITE
2c80: 5f 4d 49 53 55 53 45 20 69 66 20 69 74 20 69 73 _MISUSE if it is
2c90: 20 69 6e 76 6f 6b 65 64 20 77 68 69 6c 65 0a 20 invoked while.
2ca0: 20 2a 2a 20 74 68 65 20 53 51 4c 69 74 65 20 6c ** the SQLite l
2cb0: 69 62 72 61 72 79 20 69 73 20 69 6e 20 75 73 65 ibrary is in use
2cc0: 2e 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 . */. if( sqlit
2cd0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
2ce0: 73 49 6e 69 74 20 29 20 72 65 74 75 72 6e 20 53 sInit ) return S
2cf0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
2d00: 54 3b 0a 0a 20 20 76 61 5f 73 74 61 72 74 28 61 T;.. va_start(a
2d10: 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 p, op);. switch
2d20: 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 ( op ){.. /*
2d30: 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 72 61 74 Mutex configurat
2d40: 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 ion options are
2d50: 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 only available i
2d60: 6e 20 61 20 74 68 72 65 61 64 73 61 66 65 0a 20 n a threadsafe.
2d70: 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2e 0a 20 ** compile..
2d80: 20 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 */.#if define
2d90: 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 d(SQLITE_THREADS
2da0: 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f 54 AFE) && SQLITE_T
2db0: 48 52 45 41 44 53 41 46 45 3e 30 20 20 2f 2a 20 HREADSAFE>0 /*
2dc0: 49 4d 50 3a 20 52 2d 35 34 34 36 36 2d 34 36 37 IMP: R-54466-467
2dd0: 35 36 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 56 */. case S
2de0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 49 4e QLITE_CONFIG_SIN
2df0: 47 4c 45 54 48 52 45 41 44 3a 20 7b 0a 20 20 20 GLETHREAD: {.
2e00: 20 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 61 6c /* Disable al
2e10: 6c 20 6d 75 74 65 78 69 6e 67 20 2a 2f 0a 20 20 l mutexing */.
2e20: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
2e30: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 lConfig.bCoreMut
2e40: 65 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 73 71 ex = 0;. sq
2e50: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2e60: 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 g.bFullMutex = 0
2e70: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
2e80: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 }.#endif.#if
2e90: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 defined(SQLITE_T
2ea0: 48 52 45 41 44 53 41 46 45 29 20 26 26 20 53 51 HREADSAFE) && SQ
2eb0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e LITE_THREADSAFE>
2ec0: 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 32 30 35 32 0 /* IMP: R-2052
2ed0: 30 2d 35 34 30 38 36 20 2a 2f 0a 20 20 20 20 63 0-54086 */. c
2ee0: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
2ef0: 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 3a 20 7b G_MULTITHREAD: {
2f00: 0a 20 20 20 20 20 20 2f 2a 20 44 69 73 61 62 6c . /* Disabl
2f10: 65 20 6d 75 74 65 78 69 6e 67 20 6f 66 20 64 61 e mutexing of da
2f20: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
2f30: 6e 73 20 2a 2f 0a 20 20 20 20 20 20 2f 2a 20 45 ns */. /* E
2f40: 6e 61 62 6c 65 20 6d 75 74 65 78 69 6e 67 20 6f nable mutexing o
2f50: 66 20 63 6f 72 65 20 64 61 74 61 20 73 74 72 75 f core data stru
2f60: 63 74 75 72 65 73 20 2a 2f 0a 20 20 20 20 20 20 ctures */.
2f70: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2f80: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d fig.bCoreMutex =
2f90: 20 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 1;. sqlite
2fa0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 3GlobalConfig.bF
2fb0: 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 ullMutex = 0;.
2fc0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
2fd0: 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 .#endif.#if defi
2fe0: 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 ned(SQLITE_THREA
2ff0: 44 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 DSAFE) && SQLITE
3000: 5f 54 48 52 45 41 44 53 41 46 45 3e 30 20 2f 2a _THREADSAFE>0 /*
3010: 20 49 4d 50 3a 20 52 2d 35 39 35 39 33 2d 32 31 IMP: R-59593-21
3020: 38 31 30 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 810 */. case
3030: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 SQLITE_CONFIG_SE
3040: 52 49 41 4c 49 5a 45 44 3a 20 7b 0a 20 20 20 20 RIALIZED: {.
3050: 20 20 2f 2a 20 45 6e 61 62 6c 65 20 61 6c 6c 20 /* Enable all
3060: 6d 75 74 65 78 69 6e 67 20 2a 2f 0a 20 20 20 20 mutexing */.
3070: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
3080: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
3090: 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 = 1;. sqli
30a0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
30b0: 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 31 3b 0a bFullMutex = 1;.
30c0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
30d0: 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 }.#endif.#if de
30e0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 fined(SQLITE_THR
30f0: 45 41 44 53 41 46 45 29 20 26 26 20 53 51 4c 49 EADSAFE) && SQLI
3100: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 20 TE_THREADSAFE>0
3110: 2f 2a 20 49 4d 50 3a 20 52 2d 36 33 36 36 36 2d /* IMP: R-63666-
3120: 34 38 37 35 35 20 2a 2f 0a 20 20 20 20 63 61 73 48755 */. cas
3130: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3140: 4d 55 54 45 58 3a 20 7b 0a 20 20 20 20 20 20 2f MUTEX: {. /
3150: 2a 20 53 70 65 63 69 66 79 20 61 6e 20 61 6c 74 * Specify an alt
3160: 65 72 6e 61 74 69 76 65 20 6d 75 74 65 78 20 69 ernative mutex i
3170: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f mplementation */
3180: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
3190: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 obalConfig.mutex
31a0: 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 = *va_arg(ap, s
31b0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 qlite3_mutex_met
31c0: 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 72 hods*);. br
31d0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 eak;. }.#endi
31e0: 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 f.#if defined(SQ
31f0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 29 LITE_THREADSAFE)
3200: 20 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 41 && SQLITE_THREA
3210: 44 53 41 46 45 3e 30 20 2f 2a 20 49 4d 50 3a 20 DSAFE>0 /* IMP:
3220: 52 2d 31 34 34 35 30 2d 33 37 35 39 37 20 2a 2f R-14450-37597 */
3230: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
3240: 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45 58 _CONFIG_GETMUTEX
3250: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 74 : {. /* Ret
3260: 72 69 65 76 65 20 74 68 65 20 63 75 72 72 65 6e rieve the curren
3270: 74 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e t mutex implemen
3280: 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 tation */.
3290: 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 *va_arg(ap, sqli
32a0: 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 te3_mutex_method
32b0: 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f s*) = sqlite3Glo
32c0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 3b balConfig.mutex;
32d0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
32e0: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 }.#endif..
32f0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
3300: 49 47 5f 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 IG_MALLOC: {.
3310: 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
3320: 46 3a 20 52 2d 35 35 35 39 34 2d 32 31 30 33 30 F: R-55594-21030
3330: 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 The SQLITE_CONF
3340: 49 47 5f 4d 41 4c 4c 4f 43 20 6f 70 74 69 6f 6e IG_MALLOC option
3350: 20 74 61 6b 65 73 20 61 0a 20 20 20 20 20 20 2a takes a. *
3360: 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e * single argumen
3370: 74 20 77 68 69 63 68 20 69 73 20 61 20 70 6f 69 t which is a poi
3380: 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 73 74 61 nter to an insta
3390: 6e 63 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 nce of the.
33a0: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f ** sqlite3_mem_
33b0: 6d 65 74 68 6f 64 73 20 73 74 72 75 63 74 75 72 methods structur
33c0: 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 e. The argument
33d0: 73 70 65 63 69 66 69 65 73 20 61 6c 74 65 72 6e specifies altern
33e0: 61 74 69 76 65 0a 20 20 20 20 20 20 2a 2a 20 6c ative. ** l
33f0: 6f 77 2d 6c 65 76 65 6c 20 6d 65 6d 6f 72 79 20 ow-level memory
3400: 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 69 allocation routi
3410: 6e 65 73 20 74 6f 20 62 65 20 75 73 65 64 20 69 nes to be used i
3420: 6e 20 70 6c 61 63 65 20 6f 66 20 74 68 65 20 6d n place of the m
3430: 65 6d 6f 72 79 0a 20 20 20 20 20 20 2a 2a 20 61 emory. ** a
3440: 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e llocation routin
3450: 65 73 20 62 75 69 6c 74 20 69 6e 74 6f 20 53 51 es built into SQ
3460: 4c 69 74 65 2e 20 2a 2f 0a 20 20 20 20 20 20 73 Lite. */. s
3470: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3480: 69 67 2e 6d 20 3d 20 2a 76 61 5f 61 72 67 28 61 ig.m = *va_arg(a
3490: 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d p, sqlite3_mem_m
34a0: 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 ethods*);.
34b0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
34c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
34d0: 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 7b FIG_GETMALLOC: {
34e0: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
34f0: 43 45 2d 4f 46 3a 20 52 2d 35 31 32 31 33 2d 34 CE-OF: R-51213-4
3500: 36 34 31 34 20 54 68 65 20 53 51 4c 49 54 45 5f 6414 The SQLITE_
3510: 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 CONFIG_GETMALLOC
3520: 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a option takes a.
3530: 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 ** single
3540: 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 argument which i
3550: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 s a pointer to a
3560: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
3570: 65 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 e. ** sqlit
3580: 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 73 e3_mem_methods s
3590: 74 72 75 63 74 75 72 65 2e 20 54 68 65 20 73 71 tructure. The sq
35a0: 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 lite3_mem_method
35b0: 73 20 73 74 72 75 63 74 75 72 65 20 69 73 0a 20 s structure is.
35c0: 20 20 20 20 20 2a 2a 20 66 69 6c 6c 65 64 20 77 ** filled w
35d0: 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 6c ith the currentl
35e0: 79 20 64 65 66 69 6e 65 64 20 6d 65 6d 6f 72 79 y defined memory
35f0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 allocation rout
3600: 69 6e 65 73 2e 20 2a 2f 0a 20 20 20 20 20 20 69 ines. */. i
3610: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
3620: 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 Config.m.xMalloc
3630: 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 4d 65 6d ==0 ) sqlite3Mem
3640: 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 SetDefault();.
3650: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
3660: 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
3670: 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 ods*) = sqlite3G
3680: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a 20 lobalConfig.m;.
3690: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
36a0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
36b0: 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 E_CONFIG_MEMSTAT
36c0: 55 53 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 US: {. /* E
36d0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 31 VIDENCE-OF: R-61
36e0: 32 37 35 2d 33 35 31 35 37 20 54 68 65 20 53 51 275-35157 The SQ
36f0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 LITE_CONFIG_MEMS
3700: 54 41 54 55 53 20 6f 70 74 69 6f 6e 20 74 61 6b TATUS option tak
3710: 65 73 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 es. ** sing
3720: 6c 65 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 74 le argument of t
3730: 79 70 65 20 69 6e 74 2c 20 69 6e 74 65 72 70 72 ype int, interpr
3740: 65 74 65 64 20 61 73 20 61 20 62 6f 6f 6c 65 61 eted as a boolea
3750: 6e 2c 20 77 68 69 63 68 20 65 6e 61 62 6c 65 73 n, which enables
3760: 0a 20 20 20 20 20 20 2a 2a 20 6f 72 20 64 69 73 . ** or dis
3770: 61 62 6c 65 73 20 74 68 65 20 63 6f 6c 6c 65 63 ables the collec
3780: 74 69 6f 6e 20 6f 66 20 6d 65 6d 6f 72 79 20 61 tion of memory a
3790: 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 69 73 llocation statis
37a0: 74 69 63 73 2e 20 2a 2f 0a 20 20 20 20 20 20 73 tics. */. s
37b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
37c0: 69 67 2e 62 4d 65 6d 73 74 61 74 20 3d 20 76 61 ig.bMemstat = va
37d0: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
37e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
37f0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
3800: 45 5f 43 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 E_CONFIG_SCRATCH
3810: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 : {. /* EVI
3820: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 38 34 30 DENCE-OF: R-0840
3830: 34 2d 36 30 38 38 37 20 54 68 65 72 65 20 61 72 4-60887 There ar
3840: 65 20 74 68 72 65 65 20 61 72 67 75 6d 65 6e 74 e three argument
3850: 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 51 s to. ** SQ
3860: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 43 52 41 LITE_CONFIG_SCRA
3870: 54 43 48 3a 20 41 20 70 6f 69 6e 74 65 72 20 61 TCH: A pointer a
3880: 6e 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 n 8-byte aligned
3890: 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 20 66 memory buffer f
38a0: 72 6f 6d 0a 20 20 20 20 20 20 2a 2a 20 77 68 69 rom. ** whi
38b0: 63 68 20 74 68 65 20 73 63 72 61 74 63 68 20 61 ch the scratch a
38c0: 6c 6c 6f 63 61 74 69 6f 6e 73 20 77 69 6c 6c 20 llocations will
38d0: 62 65 20 64 72 61 77 6e 2c 20 74 68 65 20 73 69 be drawn, the si
38e0: 7a 65 20 6f 66 20 65 61 63 68 20 73 63 72 61 74 ze of each scrat
38f0: 63 68 0a 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f ch. ** allo
3900: 63 61 74 69 6f 6e 20 28 73 7a 29 2c 20 61 6e 64 cation (sz), and
3910: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d the maximum num
3920: 62 65 72 20 6f 66 20 73 63 72 61 74 63 68 20 61 ber of scratch a
3930: 6c 6c 6f 63 61 74 69 6f 6e 73 20 28 4e 29 2e 20 llocations (N).
3940: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
3950: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 GlobalConfig.pSc
3960: 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 ratch = va_arg(a
3970: 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 p, void*);.
3980: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3990: 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 3d nfig.szScratch =
39a0: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
39b0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
39c0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72 lobalConfig.nScr
39d0: 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 atch = va_arg(ap
39e0: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
39f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 eak;. }. c
3a00: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
3a10: 47 5f 50 41 47 45 43 41 43 48 45 3a 20 7b 0a 20 G_PAGECACHE: {.
3a20: 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
3a30: 2d 4f 46 3a 20 52 2d 33 31 34 30 38 2d 34 30 35 -OF: R-31408-405
3a40: 31 30 20 54 68 65 72 65 20 61 72 65 20 74 68 72 10 There are thr
3a50: 65 65 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 0a ee arguments to.
3a60: 20 20 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f ** SQLITE_
3a70: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 CONFIG_PAGECACHE
3a80: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 38 : A pointer to 8
3a90: 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 20 6d 65 -byte aligned me
3aa0: 6d 6f 72 79 2c 20 74 68 65 20 73 69 7a 65 0a 20 mory, the size.
3ab0: 20 20 20 20 20 2a 2a 20 6f 66 20 65 61 63 68 20 ** of each
3ac0: 70 61 67 65 20 62 75 66 66 65 72 20 28 73 7a 29 page buffer (sz)
3ad0: 2c 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 , and the number
3ae0: 20 6f 66 20 70 61 67 65 73 20 28 4e 29 2e 20 2a of pages (N). *
3af0: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 /. sqlite3G
3b00: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 lobalConfig.pPag
3b10: 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 e = va_arg(ap, v
3b20: 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c oid*);. sql
3b30: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3b40: 2e 73 7a 50 61 67 65 20 3d 20 76 61 5f 61 72 67 .szPage = va_arg
3b50: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
3b60: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3b70: 6e 66 69 67 2e 6e 50 61 67 65 20 3d 20 76 61 5f nfig.nPage = va_
3b80: 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
3b90: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
3ba0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
3bb0: 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 5f 48 _CONFIG_PCACHE_H
3bc0: 44 52 53 5a 3a 20 7b 0a 20 20 20 20 20 20 2f 2a DRSZ: {. /*
3bd0: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
3be0: 33 39 31 30 30 2d 32 37 33 31 37 20 54 68 65 20 39100-27317 The
3bf0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 SQLITE_CONFIG_PC
3c00: 41 43 48 45 5f 48 44 52 53 5a 20 6f 70 74 69 6f ACHE_HDRSZ optio
3c10: 6e 20 74 61 6b 65 73 0a 20 20 20 20 20 20 2a 2a n takes. **
3c20: 20 61 20 73 69 6e 67 6c 65 20 70 61 72 61 6d 65 a single parame
3c30: 74 65 72 20 77 68 69 63 68 20 69 73 20 61 20 70 ter which is a p
3c40: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 74 ointer to an int
3c50: 65 67 65 72 20 61 6e 64 20 77 72 69 74 65 73 20 eger and writes
3c60: 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 into. ** th
3c70: 61 74 20 69 6e 74 65 67 65 72 20 74 68 65 20 6e at integer the n
3c80: 75 6d 62 65 72 20 6f 66 20 65 78 74 72 61 20 62 umber of extra b
3c90: 79 74 65 73 20 70 65 72 20 70 61 67 65 20 72 65 ytes per page re
3ca0: 71 75 69 72 65 64 20 66 6f 72 20 65 61 63 68 20 quired for each
3cb0: 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 6e page. ** in
3cc0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
3cd0: 41 47 45 43 41 43 48 45 2e 20 2a 2f 0a 20 20 20 AGECACHE. */.
3ce0: 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 69 *va_arg(ap, i
3cf0: 6e 74 2a 29 20 3d 20 0a 20 20 20 20 20 20 20 20 nt*) = .
3d00: 20 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 53 sqlite3HeaderS
3d10: 69 7a 65 42 74 72 65 65 28 29 20 2b 0a 20 20 20 izeBtree() +.
3d20: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 48 65 sqlite3He
3d30: 61 64 65 72 53 69 7a 65 50 63 61 63 68 65 28 29 aderSizePcache()
3d40: 20 2b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c +. sql
3d50: 69 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 63 ite3HeaderSizePc
3d60: 61 63 68 65 31 28 29 3b 0a 20 20 20 20 20 20 62 ache1();. b
3d70: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
3d80: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
3d90: 46 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 20 FIG_PCACHE: {.
3da0: 20 20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a /* no-op */.
3db0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
3dc0: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
3dd0: 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 TE_CONFIG_GETPCA
3de0: 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 CHE: {. /*
3df0: 6e 6f 77 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a now an error */.
3e00: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
3e10: 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 62 E_ERROR;. b
3e20: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
3e30: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
3e40: 46 49 47 5f 50 43 41 43 48 45 32 3a 20 7b 0a 20 FIG_PCACHE2: {.
3e50: 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
3e60: 2d 4f 46 3a 20 52 2d 36 33 33 32 35 2d 34 38 33 -OF: R-63325-483
3e70: 37 38 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 78 The SQLITE_CO
3e80: 4e 46 49 47 5f 50 43 41 43 48 45 32 20 6f 70 74 NFIG_PCACHE2 opt
3e90: 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 20 ion takes a.
3ea0: 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 ** single argu
3eb0: 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 61 20 ment which is a
3ec0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 73 71 pointer to an sq
3ed0: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 lite3_pcache_met
3ee0: 68 6f 64 73 32 0a 20 20 20 20 20 20 2a 2a 20 6f hods2. ** o
3ef0: 62 6a 65 63 74 2e 20 54 68 69 73 20 6f 62 6a 65 bject. This obje
3f00: 63 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 ct specifies the
3f10: 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 61 20 interface to a
3f20: 63 75 73 74 6f 6d 20 70 61 67 65 20 63 61 63 68 custom page cach
3f30: 65 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6c 65 e. ** imple
3f40: 6d 65 6e 74 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 mentation. */.
3f50: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3f60: 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 32 20 lConfig.pcache2
3f70: 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 = *va_arg(ap, sq
3f80: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 lite3_pcache_met
3f90: 68 6f 64 73 32 2a 29 3b 0a 20 20 20 20 20 20 62 hods2*);. b
3fa0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
3fb0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
3fc0: 49 47 5f 47 45 54 50 43 41 43 48 45 32 3a 20 7b IG_GETPCACHE2: {
3fd0: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
3fe0: 43 45 2d 4f 46 3a 20 52 2d 32 32 30 33 35 2d 34 CE-OF: R-22035-4
3ff0: 36 31 38 32 20 54 68 65 20 53 51 4c 49 54 45 5f 6182 The SQLITE_
4000: 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 48 45 CONFIG_GETPCACHE
4010: 32 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 2 option takes a
4020: 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 . ** single
4030: 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 argument which
4040: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
4050: 61 6e 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 an sqlite3_pcach
4060: 65 5f 6d 65 74 68 6f 64 73 32 0a 20 20 20 20 20 e_methods2.
4070: 20 2a 2a 20 6f 62 6a 65 63 74 2e 20 53 51 4c 69 ** object. SQLi
4080: 74 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 65 te copies of the
4090: 20 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 61 current page ca
40a0: 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 che implementati
40b0: 6f 6e 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a on into. **
40c0: 20 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 2a 2f that object. */
40d0: 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
40e0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
40f0: 63 61 63 68 65 32 2e 78 49 6e 69 74 3d 3d 30 20 cache2.xInit==0
4100: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
4110: 65 33 50 43 61 63 68 65 53 65 74 44 65 66 61 75 e3PCacheSetDefau
4120: 6c 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 lt();. }.
4130: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
4140: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d sqlite3_pcache_m
4150: 65 74 68 6f 64 73 32 2a 29 20 3d 20 73 71 6c 69 ethods2*) = sqli
4160: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4170: 70 63 61 63 68 65 32 3b 0a 20 20 20 20 20 20 62 pcache2;. b
4180: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 reak;. }..#if
4190: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
41a0: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 29 20 ENABLE_MEMSYS3)
41b0: 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
41c0: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 E_ENABLE_MEMSYS5
41d0: 29 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 ). case SQLIT
41e0: 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 3a 20 7b E_CONFIG_HEAP: {
41f0: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
4200: 43 45 2d 4f 46 3a 20 52 2d 31 39 38 35 34 2d 34 CE-OF: R-19854-4
4210: 32 31 32 36 20 54 68 65 72 65 20 61 72 65 20 74 2126 There are t
4220: 68 72 65 65 20 61 72 67 75 6d 65 6e 74 73 20 74 hree arguments t
4230: 6f 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c 49 54 o. ** SQLIT
4240: 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 3a 20 41 E_CONFIG_HEAP: A
4250: 6e 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 n 8-byte aligned
4260: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
4270: 6d 65 6d 6f 72 79 2c 20 74 68 65 0a 20 20 20 20 memory, the.
4280: 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 62 ** number of b
4290: 79 74 65 73 20 69 6e 20 74 68 65 20 6d 65 6d 6f ytes in the memo
42a0: 72 79 20 62 75 66 66 65 72 2c 20 61 6e 64 20 74 ry buffer, and t
42b0: 68 65 20 6d 69 6e 69 6d 75 6d 20 61 6c 6c 6f 63 he minimum alloc
42c0: 61 74 69 6f 6e 20 73 69 7a 65 2e 20 2a 2f 0a 20 ation size. */.
42d0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
42e0: 61 6c 43 6f 6e 66 69 67 2e 70 48 65 61 70 20 3d alConfig.pHeap =
42f0: 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
4300: 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 *);. sqlite
4310: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 3GlobalConfig.nH
4320: 65 61 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c eap = va_arg(ap,
4330: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c int);. sql
4340: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4350: 2e 6d 6e 52 65 71 20 3d 20 76 61 5f 61 72 67 28 .mnReq = va_arg(
4360: 61 70 2c 20 69 6e 74 29 3b 0a 0a 20 20 20 20 20 ap, int);..
4370: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
4380: 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 3c 31 alConfig.mnReq<1
4390: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
43a0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
43b0: 6d 6e 52 65 71 20 3d 20 31 3b 0a 20 20 20 20 20 mnReq = 1;.
43c0: 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 }else if( sqlit
43d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
43e0: 6e 52 65 71 3e 28 31 3c 3c 31 32 29 20 29 7b 0a nReq>(1<<12) ){.
43f0: 20 20 20 20 20 20 20 20 2f 2a 20 63 61 70 20 6d /* cap m
4400: 69 6e 20 72 65 71 75 65 73 74 20 73 69 7a 65 20 in request size
4410: 61 74 20 32 5e 31 32 20 2a 2f 0a 20 20 20 20 20 at 2^12 */.
4420: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
4430: 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 28 Config.mnReq = (
4440: 31 3c 3c 31 32 29 3b 0a 20 20 20 20 20 20 7d 0a 1<<12);. }.
4450: 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
4460: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
4470: 48 65 61 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Heap==0 ){.
4480: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 68 65 61 /* If the hea
4490: 70 20 70 6f 69 6e 74 65 72 20 69 73 20 4e 55 4c p pointer is NUL
44a0: 4c 2c 20 74 68 65 6e 20 72 65 73 74 6f 72 65 20 L, then restore
44b0: 74 68 65 20 6d 61 6c 6c 6f 63 20 69 6d 70 6c 65 the malloc imple
44c0: 6d 65 6e 74 61 74 69 6f 6e 0a 20 20 20 20 20 20 mentation.
44d0: 20 20 2a 2a 20 62 61 63 6b 20 74 6f 20 4e 55 4c ** back to NUL
44e0: 4c 20 70 6f 69 6e 74 65 72 73 20 74 6f 6f 2e 20 L pointers too.
44f0: 20 54 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 This will cause
4500: 20 74 68 65 20 6d 61 6c 6c 6f 63 20 74 6f 20 67 the malloc to g
4510: 6f 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 o. ** bac
4520: 6b 20 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 k to its default
4530: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
4540: 77 68 65 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 when sqlite3_ini
4550: 74 69 61 6c 69 7a 65 28 29 20 69 73 0a 20 20 20 tialize() is.
4560: 20 20 20 20 20 2a 2a 20 72 75 6e 2e 0a 20 20 20 ** run..
4570: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
4580: 6d 65 6d 73 65 74 28 26 73 71 6c 69 74 65 33 47 memset(&sqlite3G
4590: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2c 20 30 lobalConfig.m, 0
45a0: 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 , sizeof(sqlite3
45b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 29 29 GlobalConfig.m))
45c0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
45d0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 68 65 /* The he
45e0: 61 70 20 70 6f 69 6e 74 65 72 20 69 73 20 6e 6f ap pointer is no
45f0: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 6e 73 t NULL, then ins
4600: 74 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65 0a tall one of the.
4610: 20 20 20 20 20 20 20 20 2a 2a 20 6d 65 6d 35 2e ** mem5.
4620: 63 2f 6d 65 6d 33 2e 63 20 6d 65 74 68 6f 64 73 c/mem3.c methods
4630: 2e 20 20 54 68 65 20 65 6e 63 6c 6f 73 69 6e 67 . The enclosing
4640: 20 23 69 66 20 67 75 61 72 61 6e 74 65 65 73 20 #if guarantees
4650: 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 6c 65 at. ** le
4660: 61 73 74 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 ast one of these
4670: 20 6d 65 74 68 6f 64 73 20 69 73 20 63 75 72 72 methods is curr
4680: 65 6e 74 6c 79 20 65 6e 61 62 6c 65 64 2e 0a 20 ently enabled..
4690: 20 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 66 */.#ifdef
46a0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
46b0: 45 4d 53 59 53 33 0a 20 20 20 20 20 20 20 20 73 EMSYS3. s
46c0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
46d0: 69 67 2e 6d 20 3d 20 2a 73 71 6c 69 74 65 33 4d ig.m = *sqlite3M
46e0: 65 6d 47 65 74 4d 65 6d 73 79 73 33 28 29 3b 0a emGetMemsys3();.
46f0: 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 #endif.#ifdef SQ
4700: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 LITE_ENABLE_MEMS
4710: 59 53 35 0a 20 20 20 20 20 20 20 20 73 71 6c 69 YS5. sqli
4720: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4730: 6d 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 m = *sqlite3MemG
4740: 65 74 4d 65 6d 73 79 73 35 28 29 3b 0a 23 65 6e etMemsys5();.#en
4750: 64 69 66 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 dif. }.
4760: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 break;. }.#
4770: 65 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 20 endif.. case
4780: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f SQLITE_CONFIG_LO
4790: 4f 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 OKASIDE: {.
47a0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
47b0: 6e 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 nfig.szLookaside
47c0: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
47d0: 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 t);. sqlite
47e0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 3GlobalConfig.nL
47f0: 6f 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 ookaside = va_ar
4800: 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
4810: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
4820: 20 20 20 0a 20 20 20 20 2f 2a 20 52 65 63 6f 72 . /* Recor
4830: 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 d a pointer to t
4840: 68 65 20 6c 6f 67 67 65 72 20 66 75 6e 63 74 69 he logger functi
4850: 6f 6e 20 61 6e 64 20 69 74 73 20 66 69 72 73 74 on and its first
4860: 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 20 20 2a argument.. *
4870: 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 * The default is
4880: 20 4e 55 4c 4c 2e 20 20 4c 6f 67 67 69 6e 67 20 NULL. Logging
4890: 69 73 20 64 69 73 61 62 6c 65 64 20 69 66 20 74 is disabled if t
48a0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e he function poin
48b0: 74 65 72 20 69 73 0a 20 20 20 20 2a 2a 20 4e 55 ter is. ** NU
48c0: 4c 4c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 LL.. */. c
48d0: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
48e0: 47 5f 4c 4f 47 3a 20 7b 0a 20 20 20 20 20 20 2f G_LOG: {. /
48f0: 2a 20 4d 53 56 43 20 69 73 20 70 69 63 6b 79 20 * MSVC is picky
4900: 61 62 6f 75 74 20 70 75 6c 6c 69 6e 67 20 66 75 about pulling fu
4910: 6e 63 20 70 74 72 73 20 66 72 6f 6d 20 76 61 20 nc ptrs from va
4920: 6c 69 73 74 73 2e 0a 20 20 20 20 20 20 2a 2a 20 lists.. **
4930: 68 74 74 70 3a 2f 2f 73 75 70 70 6f 72 74 2e 6d http://support.m
4940: 69 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 6b 62 2f icrosoft.com/kb/
4950: 34 37 39 36 31 0a 20 20 20 20 20 20 2a 2a 20 73 47961. ** s
4960: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
4970: 69 67 2e 78 4c 6f 67 20 3d 20 76 61 5f 61 72 67 ig.xLog = va_arg
4980: 28 61 70 2c 20 76 6f 69 64 28 2a 29 28 76 6f 69 (ap, void(*)(voi
4990: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 d*,int,const cha
49a0: 72 2a 29 29 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 r*));. */.
49b0: 20 20 20 20 20 74 79 70 65 64 65 66 20 76 6f 69 typedef voi
49c0: 64 28 2a 4c 4f 47 46 55 4e 43 5f 74 29 28 76 6f d(*LOGFUNC_t)(vo
49d0: 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 id*,int,const ch
49e0: 61 72 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 ar*);. sqli
49f0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4a00: 78 4c 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 xLog = va_arg(ap
4a10: 2c 20 4c 4f 47 46 55 4e 43 5f 74 29 3b 0a 20 20 , LOGFUNC_t);.
4a20: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4a30: 6c 43 6f 6e 66 69 67 2e 70 4c 6f 67 41 72 67 20 lConfig.pLogArg
4a40: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
4a50: 64 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b d*);. break
4a60: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
4a70: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 EVIDENCE-OF: R-5
4a80: 35 35 34 38 2d 33 33 38 31 37 20 54 68 65 20 63 5548-33817 The c
4a90: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 73 65 74 74 ompile-time sett
4aa0: 69 6e 67 20 66 6f 72 20 55 52 49 20 66 69 6c 65 ing for URI file
4ab0: 6e 61 6d 65 73 0a 20 20 20 20 2a 2a 20 63 61 6e names. ** can
4ac0: 20 62 65 20 63 68 61 6e 67 65 64 20 61 74 20 73 be changed at s
4ad0: 74 61 72 74 2d 74 69 6d 65 20 75 73 69 6e 67 20 tart-time using
4ae0: 74 68 65 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 the. ** sqlit
4af0: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 e3_config(SQLITE
4b00: 5f 43 4f 4e 46 49 47 5f 55 52 49 2c 31 29 20 6f _CONFIG_URI,1) o
4b10: 72 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 r. ** sqlite3
4b20: 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 _config(SQLITE_C
4b30: 4f 4e 46 49 47 5f 55 52 49 2c 30 29 20 63 6f 6e ONFIG_URI,0) con
4b40: 66 69 67 75 72 61 74 69 6f 6e 20 63 61 6c 6c 73 figuration calls
4b50: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
4b60: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
4b70: 55 52 49 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c URI: {. sql
4b80: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4b90: 2e 62 4f 70 65 6e 55 72 69 20 3d 20 76 61 5f 61 .bOpenUri = va_a
4ba0: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
4bb0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
4bc0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
4bd0: 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 _CONFIG_COVERING
4be0: 5f 49 4e 44 45 58 5f 53 43 41 4e 3a 20 7b 0a 20 _INDEX_SCAN: {.
4bf0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
4c00: 61 6c 43 6f 6e 66 69 67 2e 62 55 73 65 43 69 73 alConfig.bUseCis
4c10: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
4c20: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
4c30: 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 . }..#ifdef S
4c40: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c QLITE_ENABLE_SQL
4c50: 4c 4f 47 0a 20 20 20 20 63 61 73 65 20 53 51 4c LOG. case SQL
4c60: 49 54 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f ITE_CONFIG_SQLLO
4c70: 47 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 G: {. typed
4c80: 65 66 20 76 6f 69 64 28 2a 53 51 4c 4c 4f 47 46 ef void(*SQLLOGF
4c90: 55 4e 43 5f 74 29 28 76 6f 69 64 2a 2c 20 73 71 UNC_t)(void*, sq
4ca0: 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 lite3*, const ch
4cb0: 61 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 ar*, int);.
4cc0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
4cd0: 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 3d 20 76 nfig.xSqllog = v
4ce0: 61 5f 61 72 67 28 61 70 2c 20 53 51 4c 4c 4f 47 a_arg(ap, SQLLOG
4cf0: 46 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 FUNC_t);. s
4d00: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
4d10: 69 67 2e 70 53 71 6c 6c 6f 67 41 72 67 20 3d 20 ig.pSqllogArg =
4d20: 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 20 va_arg(ap, void
4d30: 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b *);. break;
4d40: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 . }.#endif..
4d50: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
4d60: 4f 4e 46 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 3a ONFIG_MMAP_SIZE:
4d70: 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
4d80: 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 20 3d 20 _int64 szMmap =
4d90: 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 va_arg(ap, sqlit
4da0: 65 33 5f 69 6e 74 36 34 29 3b 0a 20 20 20 20 20 e3_int64);.
4db0: 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6d sqlite3_int64 m
4dc0: 78 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 61 xMmap = va_arg(a
4dd0: 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 p, sqlite3_int64
4de0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 6d 78 4d );. if( mxM
4df0: 6d 61 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 70 3e map<0 || mxMmap>
4e00: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
4e10: 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 20 20 SIZE ){.
4e20: 6d 78 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f mxMmap = SQLITE_
4e30: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 MAX_MMAP_SIZE;.
4e40: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
4e50: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4e60: 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 4d 6d 61 70 .mxMmap = mxMmap
4e70: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 7a 4d 6d ;. if( szMm
4e80: 61 70 3c 30 20 29 20 73 7a 4d 6d 61 70 20 3d 20 ap<0 ) szMmap =
4e90: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
4ea0: 4d 41 50 5f 53 49 5a 45 3b 0a 20 20 20 20 20 20 MAP_SIZE;.
4eb0: 69 66 28 20 73 7a 4d 6d 61 70 3e 6d 78 4d 6d 61 if( szMmap>mxMma
4ec0: 70 29 20 73 7a 4d 6d 61 70 20 3d 20 6d 78 4d 6d p) szMmap = mxMm
4ed0: 61 70 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ap;. sqlite
4ee0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
4ef0: 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b 0a 20 Mmap = szMmap;.
4f00: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
4f10: 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4f 53 }..#if SQLITE_OS
4f20: 5f 57 49 4e 20 26 26 20 64 65 66 69 6e 65 64 28 _WIN && defined(
4f30: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
4f40: 4c 4f 43 29 0a 20 20 20 20 63 61 73 65 20 53 51 LOC). case SQ
4f50: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 57 49 4e 33 LITE_CONFIG_WIN3
4f60: 32 5f 48 45 41 50 53 49 5a 45 3a 20 7b 0a 20 20 2_HEAPSIZE: {.
4f70: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4f80: 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 70 20 3d 20 lConfig.nHeap =
4f90: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
4fa0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
4fb0: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 }.#endif..
4fc0: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 default: {.
4fd0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
4fe0: 4f 52 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b OR;. break;
4ff0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f . }. }. va_
5000: 65 6e 64 28 61 70 29 3b 0a 20 20 72 65 74 75 72 end(ap);. retur
5010: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 n rc;.}../*.** S
5020: 65 74 20 75 70 20 74 68 65 20 6c 6f 6f 6b 61 73 et up the lookas
5030: 69 64 65 20 62 75 66 66 65 72 73 20 66 6f 72 20 ide buffers for
5040: 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 a database conne
5050: 63 74 69 6f 6e 2e 0a 2a 2a 20 52 65 74 75 72 6e ction..** Return
5060: 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 SQLITE_OK on su
5070: 63 63 65 73 73 2e 20 20 0a 2a 2a 20 49 66 20 6c ccess. .** If l
5080: 6f 6f 6b 61 73 69 64 65 20 69 73 20 61 6c 72 65 ookaside is alre
5090: 61 64 79 20 61 63 74 69 76 65 2c 20 72 65 74 75 ady active, retu
50a0: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 0a rn SQLITE_BUSY..
50b0: 2a 2a 0a 2a 2a 20 54 68 65 20 73 7a 20 70 61 72 **.** The sz par
50c0: 61 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e 75 ameter is the nu
50d0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e mber of bytes in
50e0: 20 65 61 63 68 20 6c 6f 6f 6b 61 73 69 64 65 20 each lookaside
50f0: 73 6c 6f 74 2e 0a 2a 2a 20 54 68 65 20 63 6e 74 slot..** The cnt
5100: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 68 parameter is th
5110: 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 e number of slot
5120: 73 2e 20 20 49 66 20 70 53 74 61 72 74 20 69 73 s. If pStart is
5130: 20 4e 55 4c 4c 20 74 68 65 0a 2a 2a 20 73 70 61 NULL the.** spa
5140: 63 65 20 66 6f 72 20 74 68 65 20 6c 6f 6f 6b 61 ce for the looka
5150: 73 69 64 65 20 6d 65 6d 6f 72 79 20 69 73 20 6f side memory is o
5160: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c btained from sql
5170: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a ite3_malloc()..*
5180: 2a 20 49 66 20 70 53 74 61 72 74 20 69 73 20 6e * If pStart is n
5190: 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 69 74 20 ot NULL then it
51a0: 69 73 20 73 7a 2a 63 6e 74 20 62 79 74 65 73 20 is sz*cnt bytes
51b0: 6f 66 20 6d 65 6d 6f 72 79 20 74 6f 20 75 73 65 of memory to use
51c0: 20 66 6f 72 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b for.** the look
51d0: 61 73 69 64 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f aside memory..*/
51e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 75 .static int setu
51f0: 70 4c 6f 6f 6b 61 73 69 64 65 28 73 71 6c 69 74 pLookaside(sqlit
5200: 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 42 e3 *db, void *pB
5210: 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 uf, int sz, int
5220: 63 6e 74 29 7b 0a 20 20 76 6f 69 64 20 2a 70 53 cnt){. void *pS
5230: 74 61 72 74 3b 0a 20 20 69 66 28 20 64 62 2d 3e tart;. if( db->
5240: 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 20 29 lookaside.nOut )
5250: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
5260: 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a 20 20 ITE_BUSY;. }.
5270: 2f 2a 20 46 72 65 65 20 61 6e 79 20 65 78 69 73 /* Free any exis
5280: 74 69 6e 67 20 6c 6f 6f 6b 61 73 69 64 65 20 62 ting lookaside b
5290: 75 66 66 65 72 20 66 6f 72 20 74 68 69 73 20 68 uffer for this h
52a0: 61 6e 64 6c 65 20 62 65 66 6f 72 65 0a 20 20 2a andle before. *
52b0: 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e * allocating a n
52c0: 65 77 20 6f 6e 65 20 73 6f 20 77 65 20 64 6f 6e ew one so we don
52d0: 27 74 20 68 61 76 65 20 74 6f 20 68 61 76 65 20 't have to have
52e0: 73 70 61 63 65 20 66 6f 72 20 0a 20 20 2a 2a 20 space for . **
52f0: 62 6f 74 68 20 61 74 20 74 68 65 20 73 61 6d 65 both at the same
5300: 20 74 69 6d 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 time.. */. if
5310: 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e ( db->lookaside.
5320: 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 bMalloced ){.
5330: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 sqlite3_free(db
5340: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 ->lookaside.pSta
5350: 72 74 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 54 68 rt);. }. /* Th
5360: 65 20 73 69 7a 65 20 6f 66 20 61 20 6c 6f 6f 6b e size of a look
5370: 61 73 69 64 65 20 73 6c 6f 74 20 61 66 74 65 72 aside slot after
5380: 20 52 4f 55 4e 44 44 4f 57 4e 38 20 6e 65 65 64 ROUNDDOWN8 need
5390: 73 20 74 6f 20 62 65 20 6c 61 72 67 65 72 0a 20 s to be larger.
53a0: 20 2a 2a 20 74 68 61 6e 20 61 20 70 6f 69 6e 74 ** than a point
53b0: 65 72 20 74 6f 20 62 65 20 75 73 65 66 75 6c 2e er to be useful.
53c0: 0a 20 20 2a 2f 0a 20 20 73 7a 20 3d 20 52 4f 55 . */. sz = ROU
53d0: 4e 44 44 4f 57 4e 38 28 73 7a 29 3b 20 20 2f 2a NDDOWN8(sz); /*
53e0: 20 49 4d 50 3a 20 52 2d 33 33 30 33 38 2d 30 39 IMP: R-33038-09
53f0: 33 38 32 20 2a 2f 0a 20 20 69 66 28 20 73 7a 3c 382 */. if( sz<
5400: 3d 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f 6f =(int)sizeof(Loo
5410: 6b 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 20 73 kasideSlot*) ) s
5420: 7a 20 3d 20 30 3b 0a 20 20 69 66 28 20 63 6e 74 z = 0;. if( cnt
5430: 3c 30 20 29 20 63 6e 74 20 3d 20 30 3b 0a 20 20 <0 ) cnt = 0;.
5440: 69 66 28 20 73 7a 3d 3d 30 20 7c 7c 20 63 6e 74 if( sz==0 || cnt
5450: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 7a 20 3d 20 ==0 ){. sz =
5460: 30 3b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 0;. pStart =
5470: 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 0;. }else if( p
5480: 42 75 66 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 Buf==0 ){. sq
5490: 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
54a0: 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 70 53 Malloc();. pS
54b0: 74 61 72 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 tart = sqlite3Ma
54c0: 6c 6c 6f 63 28 20 73 7a 2a 63 6e 74 20 29 3b 20 lloc( sz*cnt );
54d0: 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 31 39 34 39 /* IMP: R-61949
54e0: 2d 33 35 37 32 37 20 2a 2f 0a 20 20 20 20 73 71 -35727 */. sq
54f0: 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 lite3EndBenignMa
5500: 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 69 66 28 20 lloc();. if(
5510: 70 53 74 61 72 74 20 29 20 63 6e 74 20 3d 20 73 pStart ) cnt = s
5520: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 qlite3MallocSize
5530: 28 70 53 74 61 72 74 29 2f 73 7a 3b 0a 20 20 7d (pStart)/sz;. }
5540: 65 6c 73 65 7b 0a 20 20 20 20 70 53 74 61 72 74 else{. pStart
5550: 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 20 20 64 = pBuf;. }. d
5560: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 b->lookaside.pSt
5570: 61 72 74 20 3d 20 70 53 74 61 72 74 3b 0a 20 20 art = pStart;.
5580: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 db->lookaside.pF
5590: 72 65 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c ree = 0;. db->l
55a0: 6f 6f 6b 61 73 69 64 65 2e 73 7a 20 3d 20 28 75 ookaside.sz = (u
55b0: 31 36 29 73 7a 3b 0a 20 20 69 66 28 20 70 53 74 16)sz;. if( pSt
55c0: 61 72 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 art ){. int i
55d0: 3b 0a 20 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 ;. LookasideS
55e0: 6c 6f 74 20 2a 70 3b 0a 20 20 20 20 61 73 73 65 lot *p;. asse
55f0: 72 74 28 20 73 7a 20 3e 20 28 69 6e 74 29 73 69 rt( sz > (int)si
5600: 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c zeof(LookasideSl
5610: 6f 74 2a 29 20 29 3b 0a 20 20 20 20 70 20 3d 20 ot*) );. p =
5620: 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 (LookasideSlot*)
5630: 70 53 74 61 72 74 3b 0a 20 20 20 20 66 6f 72 28 pStart;. for(
5640: 69 3d 63 6e 74 2d 31 3b 20 69 3e 3d 30 3b 20 69 i=cnt-1; i>=0; i
5650: 2d 2d 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4e --){. p->pN
5660: 65 78 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ext = db->lookas
5670: 69 64 65 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 ide.pFree;.
5680: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 db->lookaside.p
5690: 46 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 20 20 Free = p;.
56a0: 70 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53 6c p = (LookasideSl
56b0: 6f 74 2a 29 26 28 28 75 38 2a 29 70 29 5b 73 7a ot*)&((u8*)p)[sz
56c0: 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d ];. }. db-
56d0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 >lookaside.pEnd
56e0: 3d 20 70 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f = p;. db->loo
56f0: 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 kaside.bEnabled
5700: 3d 20 31 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f = 1;. db->loo
5710: 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 kaside.bMalloced
5720: 20 3d 20 70 42 75 66 3d 3d 30 20 3f 31 3a 30 3b = pBuf==0 ?1:0;
5730: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 . }else{. db
5740: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 ->lookaside.pSta
5750: 72 74 20 3d 20 64 62 3b 0a 20 20 20 20 64 62 2d rt = db;. db-
5760: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 >lookaside.pEnd
5770: 3d 20 64 62 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f = db;. db->lo
5780: 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 okaside.bEnabled
5790: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f = 0;. db->lo
57a0: 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 okaside.bMalloce
57b0: 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 d = 0;. }. ret
57c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
57d0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
57e0: 68 65 20 6d 75 74 65 78 20 61 73 73 6f 63 69 61 he mutex associa
57f0: 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61 62 ted with a datab
5800: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ase connection..
5810: 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 */.sqlite3_mutex
5820: 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 6d 75 74 *sqlite3_db_mut
5830: 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b ex(sqlite3 *db){
5840: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
5850: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
5860: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
5870: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
5880: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
5890: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
58a0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
58b0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 }.#endif. retu
58c0: 72 6e 20 64 62 2d 3e 6d 75 74 65 78 3b 0a 7d 0a rn db->mutex;.}.
58d0: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61 ./*.** Free up a
58e0: 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73 s much memory as
58f0: 20 77 65 20 63 61 6e 20 66 72 6f 6d 20 74 68 65 we can from the
5900: 20 67 69 76 65 6e 20 64 61 74 61 62 61 73 65 0a given database.
5910: 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a ** connection..*
5920: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 /.int sqlite3_db
5930: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 _release_memory(
5940: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 sqlite3 *db){.
5950: 69 6e 74 20 69 3b 0a 0a 23 69 66 64 65 66 20 53 int i;..#ifdef S
5960: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
5970: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
5980: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
5990: 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 Ok(db) ) return
59a0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
59b0: 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c PT;.#endif. sql
59c0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
59d0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 (db->mutex);. s
59e0: 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
59f0: 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 69 All(db);. for(i
5a00: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 =0; i<db->nDb; i
5a10: 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 20 2a ++){. Btree *
5a20: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d pBt = db->aDb[i]
5a30: 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 .pBt;. if( pB
5a40: 74 20 29 7b 0a 20 20 20 20 20 20 50 61 67 65 72 t ){. Pager
5a50: 20 2a 70 50 61 67 65 72 20 3d 20 73 71 6c 69 74 *pPager = sqlit
5a60: 65 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 e3BtreePager(pBt
5a70: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
5a80: 50 61 67 65 72 53 68 72 69 6e 6b 28 70 50 61 67 PagerShrink(pPag
5a90: 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 er);. }. }.
5aa0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
5ab0: 76 65 41 6c 6c 28 64 62 29 3b 0a 20 20 73 71 6c veAll(db);. sql
5ac0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
5ad0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
5ae0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
5af0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 .}../*.** Config
5b00: 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67 73 uration settings
5b10: 20 66 6f 72 20 61 6e 20 69 6e 64 69 76 69 64 75 for an individu
5b20: 61 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e al database conn
5b30: 65 63 74 69 6f 6e 0a 2a 2f 0a 69 6e 74 20 73 71 ection.*/.int sq
5b40: 6c 69 74 65 33 5f 64 62 5f 63 6f 6e 66 69 67 28 lite3_db_config(
5b50: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
5b60: 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f op, ...){. va_
5b70: 6c 69 73 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 list ap;. int r
5b80: 63 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 c;. va_start(ap
5b90: 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 28 , op);. switch(
5ba0: 20 6f 70 20 29 7b 0a 20 20 20 20 63 61 73 65 20 op ){. case
5bb0: 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f SQLITE_DBCONFIG_
5bc0: 4c 4f 4f 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 LOOKASIDE: {.
5bd0: 20 20 20 76 6f 69 64 20 2a 70 42 75 66 20 3d 20 void *pBuf =
5be0: 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a va_arg(ap, void*
5bf0: 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 32 36 38 ); /* IMP: R-268
5c00: 33 35 2d 31 30 39 36 34 20 2a 2f 0a 20 20 20 20 35-10964 */.
5c10: 20 20 69 6e 74 20 73 7a 20 3d 20 76 61 5f 61 72 int sz = va_ar
5c20: 67 28 61 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 g(ap, int);
5c30: 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 37 38 37 /* IMP: R-4787
5c40: 31 2d 32 35 39 39 34 20 2a 2f 0a 20 20 20 20 20 1-25994 */.
5c50: 20 69 6e 74 20 63 6e 74 20 3d 20 76 61 5f 61 72 int cnt = va_ar
5c60: 67 28 61 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 g(ap, int);
5c70: 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 34 34 36 30 /* IMP: R-04460
5c80: 2d 35 33 33 38 36 20 2a 2f 0a 20 20 20 20 20 20 -53386 */.
5c90: 72 63 20 3d 20 73 65 74 75 70 4c 6f 6f 6b 61 73 rc = setupLookas
5ca0: 69 64 65 28 64 62 2c 20 70 42 75 66 2c 20 73 7a ide(db, pBuf, sz
5cb0: 2c 20 63 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , cnt);. br
5cc0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 eak;. }. d
5cd0: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 efault: {.
5ce0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 74 72 static const str
5cf0: 75 63 74 20 7b 0a 20 20 20 20 20 20 20 20 69 6e uct {. in
5d00: 74 20 6f 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 t op; /* Th
5d10: 65 20 6f 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 e opcode */.
5d20: 20 20 20 20 75 33 32 20 6d 61 73 6b 3b 20 20 20 u32 mask;
5d30: 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 74 68 65 20 /* Mask of the
5d40: 62 69 74 20 69 6e 20 73 71 6c 69 74 65 33 2e 66 bit in sqlite3.f
5d50: 6c 61 67 73 20 74 6f 20 73 65 74 2f 63 6c 65 61 lags to set/clea
5d60: 72 20 2a 2f 0a 20 20 20 20 20 20 7d 20 61 46 6c r */. } aFl
5d70: 61 67 4f 70 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 agOp[] = {.
5d80: 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f { SQLITE_DBCO
5d90: 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 46 4b 45 59 NFIG_ENABLE_FKEY
5da0: 2c 20 20 20 20 53 51 4c 49 54 45 5f 46 6f 72 65 , SQLITE_Fore
5db0: 69 67 6e 4b 65 79 73 20 20 20 20 7d 2c 0a 20 20 ignKeys },.
5dc0: 20 20 20 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 { SQLITE_D
5dd0: 42 43 4f 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 54 BCONFIG_ENABLE_T
5de0: 52 49 47 47 45 52 2c 20 53 51 4c 49 54 45 5f 45 RIGGER, SQLITE_E
5df0: 6e 61 62 6c 65 54 72 69 67 67 65 72 20 20 7d 2c nableTrigger },
5e00: 0a 20 20 20 20 20 20 7d 3b 0a 20 20 20 20 20 20 . };.
5e10: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a unsigned int i;.
5e20: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
5e30: 45 5f 45 52 52 4f 52 3b 20 2f 2a 20 49 4d 50 3a E_ERROR; /* IMP:
5e40: 20 52 2d 34 32 37 39 30 2d 32 33 33 37 32 20 2a R-42790-23372 *
5e50: 2f 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b /. for(i=0;
5e60: 20 69 3c 41 72 72 61 79 53 69 7a 65 28 61 46 6c i<ArraySize(aFl
5e70: 61 67 4f 70 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 agOp); i++){.
5e80: 20 20 20 20 20 69 66 28 20 61 46 6c 61 67 4f 70 if( aFlagOp
5e90: 5b 69 5d 2e 6f 70 3d 3d 6f 70 20 29 7b 0a 20 20 [i].op==op ){.
5ea0: 20 20 20 20 20 20 20 20 69 6e 74 20 6f 6e 6f 66 int onof
5eb0: 66 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 f = va_arg(ap, i
5ec0: 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 nt);. i
5ed0: 6e 74 20 2a 70 52 65 73 20 3d 20 76 61 5f 61 72 nt *pRes = va_ar
5ee0: 67 28 61 70 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 g(ap, int*);.
5ef0: 20 20 20 20 20 20 20 69 6e 74 20 6f 6c 64 46 6c int oldFl
5f00: 61 67 73 20 3d 20 64 62 2d 3e 66 6c 61 67 73 3b ags = db->flags;
5f10: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6f . if( o
5f20: 6e 6f 66 66 3e 30 20 29 7b 0a 20 20 20 20 20 20 noff>0 ){.
5f30: 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 db->flags
5f40: 7c 3d 20 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 |= aFlagOp[i].ma
5f50: 73 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 sk;. }e
5f60: 6c 73 65 20 69 66 28 20 6f 6e 6f 66 66 3d 3d 30 lse if( onoff==0
5f70: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
5f80: 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 61 46 db->flags &= ~aF
5f90: 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 lagOp[i].mask;.
5fa0: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
5fb0: 20 20 20 20 20 69 66 28 20 6f 6c 64 46 6c 61 67 if( oldFlag
5fc0: 73 21 3d 64 62 2d 3e 66 6c 61 67 73 20 29 7b 0a s!=db->flags ){.
5fd0: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
5fe0: 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 te3ExpirePrepare
5ff0: 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b dStatements(db);
6000: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
6010: 20 20 20 20 20 20 20 69 66 28 20 70 52 65 73 20 if( pRes
6020: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a ){. *
6030: 70 52 65 73 20 3d 20 28 64 62 2d 3e 66 6c 61 67 pRes = (db->flag
6040: 73 20 26 20 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d s & aFlagOp[i].m
6050: 61 73 6b 29 21 3d 30 3b 0a 20 20 20 20 20 20 20 ask)!=0;.
6060: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 72 }. r
6070: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
6080: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
6090: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
60a0: 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 }. break;.
60b0: 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e }. }. va_en
60c0: 64 28 61 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 d(ap);. return
60d0: 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}.../*.** Re
60e0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 turn true if the
60f0: 20 62 75 66 66 65 72 20 7a 5b 30 2e 2e 6e 2d 31 buffer z[0..n-1
6100: 5d 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 73 ] contains all s
6110: 70 61 63 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 paces..*/.static
6120: 20 69 6e 74 20 61 6c 6c 53 70 61 63 65 73 28 63 int allSpaces(c
6130: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e onst char *z, in
6140: 74 20 6e 29 7b 0a 20 20 77 68 69 6c 65 28 20 6e t n){. while( n
6150: 3e 30 20 26 26 20 7a 5b 6e 2d 31 5d 3d 3d 27 20 >0 && z[n-1]=='
6160: 27 20 29 7b 20 6e 2d 2d 3b 20 7d 0a 20 20 72 65 ' ){ n--; }. re
6170: 74 75 72 6e 20 6e 3d 3d 30 3b 0a 7d 0a 0a 2f 2a turn n==0;.}../*
6180: 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 .** This is the
6190: 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e default collatin
61a0: 67 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 g function named
61b0: 20 22 42 49 4e 41 52 59 22 20 77 68 69 63 68 20 "BINARY" which
61c0: 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61 is always.** ava
61d0: 69 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 ilable..**.** If
61e0: 20 74 68 65 20 70 61 64 46 6c 61 67 20 61 72 67 the padFlag arg
61f0: 75 6d 65 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c ument is not NUL
6200: 4c 20 74 68 65 6e 20 73 70 61 63 65 20 70 61 64 L then space pad
6210: 64 69 6e 67 20 61 74 20 74 68 65 20 65 6e 64 0a ding at the end.
6220: 2a 2a 20 6f 66 20 73 74 72 69 6e 67 73 20 69 73 ** of strings is
6230: 20 69 67 6e 6f 72 65 64 2e 20 20 54 68 69 73 20 ignored. This
6240: 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 52 implements the R
6250: 54 52 49 4d 20 63 6f 6c 6c 61 74 69 6f 6e 2e 0a TRIM collation..
6260: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 69 */.static int bi
6270: 6e 43 6f 6c 6c 46 75 6e 63 28 0a 20 20 76 6f 69 nCollFunc(. voi
6280: 64 20 2a 70 61 64 46 6c 61 67 2c 0a 20 20 69 6e d *padFlag,. in
6290: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 t nKey1, const v
62a0: 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e oid *pKey1,. in
62b0: 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 t nKey2, const v
62c0: 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 oid *pKey2.){.
62d0: 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d int rc, n;. n =
62e0: 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e nKey1<nKey2 ? n
62f0: 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 Key1 : nKey2;.
6300: 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 rc = memcmp(pKey
6310: 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 1, pKey2, n);.
6320: 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 if( rc==0 ){.
6330: 20 69 66 28 20 70 61 64 46 6c 61 67 0a 20 20 20 if( padFlag.
6340: 20 20 26 26 20 61 6c 6c 53 70 61 63 65 73 28 28 && allSpaces((
6350: 28 63 68 61 72 2a 29 70 4b 65 79 31 29 2b 6e 2c (char*)pKey1)+n,
6360: 20 6e 4b 65 79 31 2d 6e 29 0a 20 20 20 20 20 26 nKey1-n). &
6370: 26 20 61 6c 6c 53 70 61 63 65 73 28 28 28 63 68 & allSpaces(((ch
6380: 61 72 2a 29 70 4b 65 79 32 29 2b 6e 2c 20 6e 4b ar*)pKey2)+n, nK
6390: 65 79 32 2d 6e 29 0a 20 20 20 20 29 7b 0a 20 20 ey2-n). ){.
63a0: 20 20 20 20 2f 2a 20 4c 65 61 76 65 20 72 63 20 /* Leave rc
63b0: 75 6e 63 68 61 6e 67 65 64 20 61 74 20 30 20 2a unchanged at 0 *
63c0: 2f 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 /. }else{.
63d0: 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 rc = nKey1 -
63e0: 6e 4b 65 79 32 3b 0a 20 20 20 20 7d 0a 20 20 7d nKey2;. }. }
63f0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
6400: 0a 2f 2a 0a 2a 2a 20 41 6e 6f 74 68 65 72 20 62 ./*.** Another b
6410: 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e uilt-in collatin
6420: 67 20 73 65 71 75 65 6e 63 65 3a 20 4e 4f 43 41 g sequence: NOCA
6430: 53 45 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 SE. .**.** This
6440: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
6450: 63 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 ce is intended t
6460: 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 22 63 o be used for "c
6470: 61 73 65 20 69 6e 64 65 70 65 6e 64 65 6e 74 0a ase independent.
6480: 2a 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 ** comparison".
6490: 53 51 4c 69 74 65 27 73 20 6b 6e 6f 77 6c 65 64 SQLite's knowled
64a0: 67 65 20 6f 66 20 75 70 70 65 72 20 61 6e 64 20 ge of upper and
64b0: 6c 6f 77 65 72 20 63 61 73 65 20 65 71 75 69 76 lower case equiv
64c0: 61 6c 65 6e 74 73 0a 2a 2a 20 65 78 74 65 6e 64 alents.** extend
64d0: 73 20 6f 6e 6c 79 20 74 6f 20 74 68 65 20 32 36 s only to the 26
64e0: 20 63 68 61 72 61 63 74 65 72 73 20 75 73 65 64 characters used
64f0: 20 69 6e 20 74 68 65 20 45 6e 67 6c 69 73 68 20 in the English
6500: 6c 61 6e 67 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 language..**.**
6510: 41 74 20 74 68 65 20 6d 6f 6d 65 6e 74 20 74 68 At the moment th
6520: 65 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 55 54 ere is only a UT
6530: 46 2d 38 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 F-8 implementati
6540: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e on..*/.static in
6550: 74 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e t nocaseCollatin
6560: 67 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 4e gFunc(. void *N
6570: 6f 74 55 73 65 64 2c 0a 20 20 69 6e 74 20 6e 4b otUsed,. int nK
6580: 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey1, const void
6590: 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b *pKey1,. int nK
65a0: 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey2, const void
65b0: 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 *pKey2.){. int
65c0: 72 20 3d 20 73 71 6c 69 74 65 33 53 74 72 4e 49 r = sqlite3StrNI
65d0: 43 6d 70 28 0a 20 20 20 20 20 20 28 63 6f 6e 73 Cmp(. (cons
65e0: 74 20 63 68 61 72 20 2a 29 70 4b 65 79 31 2c 20 t char *)pKey1,
65f0: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 4b (const char *)pK
6600: 65 79 32 2c 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 ey2, (nKey1<nKey
6610: 32 29 3f 6e 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 2)?nKey1:nKey2);
6620: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
6630: 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
6640: 69 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 if( 0==r ){.
6650: 72 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b r = nKey1-nKey2;
6660: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b . }. return r;
6670: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
6680: 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 the ROWID of th
6690: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e e most recent in
66a0: 73 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 sert.*/.sqlite_i
66b0: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 nt64 sqlite3_las
66c0: 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 t_insert_rowid(s
66d0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 qlite3 *db){.#if
66e0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
66f0: 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
6700: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
6710: 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
6720: 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
6730: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
6740: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 return 0;. }.#
6750: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 64 endif. return d
6760: 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d 0a b->lastRowid;.}.
6770: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
6780: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e e number of chan
6790: 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 20 ges in the most
67a0: 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 73 recent call to s
67b0: 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a qlite3_exec()..*
67c0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 68 /.int sqlite3_ch
67d0: 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 anges(sqlite3 *d
67e0: 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 b){.#ifdef SQLIT
67f0: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
6800: 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
6810: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
6820: 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 b) ){. (void)
6830: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
6840: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 PT;. return 0
6850: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 ;. }.#endif. r
6860: 65 74 75 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 eturn db->nChang
6870: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 e;.}../*.** Retu
6880: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
6890: 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 20 74 changes since t
68a0: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
68b0: 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a le was opened..*
68c0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f /.int sqlite3_to
68d0: 74 61 6c 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 tal_changes(sqli
68e0: 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 te3 *db){.#ifdef
68f0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
6900: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
6910: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
6920: 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
6930: 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 (void)SQLITE_MIS
6940: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 USE_BKPT;. re
6950: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 turn 0;. }.#end
6960: 69 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e if. return db->
6970: 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a nTotalChange;.}.
6980: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c ./*.** Close all
6990: 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 open savepoints
69a0: 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
69b0: 6f 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 65 73 only manipulates
69c0: 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 0a 2a fields of the.*
69d0: 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c * database handl
69e0: 65 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 6f 65 e object, it doe
69f0: 73 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e 79 20 s not close any
6a00: 73 61 76 65 70 6f 69 6e 74 73 20 74 68 61 74 20 savepoints that
6a10: 6d 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a 20 61 may be open.** a
6a20: 74 20 74 68 65 20 62 2d 74 72 65 65 2f 70 61 67 t the b-tree/pag
6a30: 65 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 6f 69 er level..*/.voi
6a40: 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 d sqlite3CloseSa
6a50: 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 65 33 vepoints(sqlite3
6a60: 20 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 28 20 *db){. while(
6a70: 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 29 db->pSavepoint )
6a80: 7b 0a 20 20 20 20 53 61 76 65 70 6f 69 6e 74 20 {. Savepoint
6a90: 2a 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 61 76 *pTmp = db->pSav
6aa0: 65 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 2d 3e epoint;. db->
6ab0: 70 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 54 6d pSavepoint = pTm
6ac0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 p->pNext;. sq
6ad0: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
6ae0: 70 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 62 2d pTmp);. }. db-
6af0: 3e 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b >nSavepoint = 0;
6b00: 0a 20 20 64 62 2d 3e 6e 53 74 61 74 65 6d 65 6e . db->nStatemen
6b10: 74 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 69 73 54 t = 0;. db->isT
6b20: 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 70 6f ransactionSavepo
6b30: 69 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a int = 0;.}../*.*
6b40: 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 65 73 * Invoke the des
6b50: 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e tructor function
6b60: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
6b70: 20 46 75 6e 63 44 65 66 20 70 2c 20 69 66 20 61 FuncDef p, if a
6b80: 6e 79 2e 20 45 78 63 65 70 74 2c 0a 2a 2a 20 69 ny. Except,.** i
6b90: 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 f this is not th
6ba0: 65 20 6c 61 73 74 20 63 6f 70 79 20 6f 66 20 74 e last copy of t
6bb0: 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 64 6f 20 he function, do
6bc0: 6e 6f 74 20 69 6e 76 6f 6b 65 20 69 74 2e 20 4d not invoke it. M
6bd0: 75 6c 74 69 70 6c 65 0a 2a 2a 20 63 6f 70 69 65 ultiple.** copie
6be0: 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 66 75 s of a single fu
6bf0: 6e 63 74 69 6f 6e 20 61 72 65 20 63 72 65 61 74 nction are creat
6c00: 65 64 20 77 68 65 6e 20 63 72 65 61 74 65 5f 66 ed when create_f
6c10: 75 6e 63 74 69 6f 6e 28 29 20 69 73 20 63 61 6c unction() is cal
6c20: 6c 65 64 0a 2a 2a 20 77 69 74 68 20 53 51 4c 49 led.** with SQLI
6c30: 54 45 5f 41 4e 59 20 61 73 20 74 68 65 20 65 6e TE_ANY as the en
6c40: 63 6f 64 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 coding..*/.stati
6c50: 63 20 76 6f 69 64 20 66 75 6e 63 74 69 6f 6e 44 c void functionD
6c60: 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 20 2a estroy(sqlite3 *
6c70: 64 62 2c 20 46 75 6e 63 44 65 66 20 2a 70 29 7b db, FuncDef *p){
6c80: 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f . FuncDestructo
6c90: 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 20 3d r *pDestructor =
6ca0: 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f 72 3b p->pDestructor;
6cb0: 0a 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 . if( pDestruct
6cc0: 6f 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 or ){. pDestr
6cd0: 75 63 74 6f 72 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 uctor->nRef--;.
6ce0: 20 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 if( pDestruct
6cf0: 6f 72 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 or->nRef==0 ){.
6d00: 20 20 20 20 20 70 44 65 73 74 72 75 63 74 6f 72 pDestructor
6d10: 2d 3e 78 44 65 73 74 72 6f 79 28 70 44 65 73 74 ->xDestroy(pDest
6d20: 72 75 63 74 6f 72 2d 3e 70 55 73 65 72 44 61 74 ructor->pUserDat
6d30: 61 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 a);. sqlite
6d40: 33 44 62 46 72 65 65 28 64 62 2c 20 70 44 65 73 3DbFree(db, pDes
6d50: 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 7d 0a tructor);. }.
6d60: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 }.}../*.** Dis
6d70: 63 6f 6e 6e 65 63 74 20 61 6c 6c 20 73 71 6c 69 connect all sqli
6d80: 74 65 33 5f 76 74 61 62 20 6f 62 6a 65 63 74 73 te3_vtab objects
6d90: 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 that belong to
6da0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
6db0: 69 6f 6e 0a 2a 2a 20 64 62 2e 20 54 68 69 73 20 ion.** db. This
6dc0: 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 64 is called when d
6dd0: 62 20 69 73 20 62 65 69 6e 67 20 63 6c 6f 73 65 b is being close
6de0: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 d..*/.static voi
6df0: 64 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 d disconnectAllV
6e00: 74 61 62 28 73 71 6c 69 74 65 33 20 2a 64 62 29 tab(sqlite3 *db)
6e10: 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
6e20: 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
6e30: 4c 45 0a 20 20 69 6e 74 20 69 3b 0a 20 20 73 71 LE. int i;. sq
6e40: 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 lite3BtreeEnterA
6e50: 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 69 3d ll(db);. for(i=
6e60: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
6e70: 2b 29 7b 0a 20 20 20 20 53 63 68 65 6d 61 20 2a +){. Schema *
6e80: 70 53 63 68 65 6d 61 20 3d 20 64 62 2d 3e 61 44 pSchema = db->aD
6e90: 62 5b 69 5d 2e 70 53 63 68 65 6d 61 3b 0a 20 20 b[i].pSchema;.
6ea0: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d if( db->aDb[i]
6eb0: 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 .pSchema ){.
6ec0: 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a 20 HashElem *p;.
6ed0: 20 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 for(p=sqlit
6ee0: 65 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 eHashFirst(&pSch
6ef0: 65 6d 61 2d 3e 74 62 6c 48 61 73 68 29 3b 20 70 ema->tblHash); p
6f00: 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 ; p=sqliteHashNe
6f10: 78 74 28 70 29 29 7b 0a 20 20 20 20 20 20 20 20 xt(p)){.
6f20: 54 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 28 54 Table *pTab = (T
6f30: 61 62 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 able *)sqliteHas
6f40: 68 44 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 hData(p);.
6f50: 20 20 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 if( IsVirtual(
6f60: 70 54 61 62 29 20 29 20 73 71 6c 69 74 65 33 56 pTab) ) sqlite3V
6f70: 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 64 62 tabDisconnect(db
6f80: 2c 20 70 54 61 62 29 3b 0a 20 20 20 20 20 20 7d , pTab);. }
6f90: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c . }. }. sql
6fa0: 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 ite3VtabUnlockLi
6fb0: 73 74 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 st(db);. sqlite
6fc0: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 3BtreeLeaveAll(d
6fd0: 62 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e 55 53 b);.#else. UNUS
6fe0: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 64 62 29 ED_PARAMETER(db)
6ff0: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
7000: 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 * Return TRUE if
7010: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
7020: 74 69 6f 6e 20 64 62 20 68 61 73 20 75 6e 66 69 tion db has unfi
7030: 6e 61 6c 69 7a 65 64 20 70 72 65 70 61 72 65 64 nalized prepared
7040: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 6f .** statements o
7050: 72 20 75 6e 66 69 6e 69 73 68 65 64 20 73 71 6c r unfinished sql
7060: 69 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 ite3_backup obje
7070: 63 74 73 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 cts. .*/.static
7080: 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 int connectionI
7090: 73 42 75 73 79 28 73 71 6c 69 74 65 33 20 2a 64 sBusy(sqlite3 *d
70a0: 62 29 7b 0a 20 20 69 6e 74 20 6a 3b 0a 20 20 61 b){. int j;. a
70b0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
70c0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
70d0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 tex) );. if( db
70e0: 2d 3e 70 56 64 62 65 20 29 20 72 65 74 75 72 6e ->pVdbe ) return
70f0: 20 31 3b 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 1;. for(j=0; j
7100: 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a <db->nDb; j++){.
7110: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d Btree *pBt =
7120: 20 64 62 2d 3e 61 44 62 5b 6a 5d 2e 70 42 74 3b db->aDb[j].pBt;
7130: 0a 20 20 20 20 69 66 28 20 70 42 74 20 26 26 20 . if( pBt &&
7140: 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e sqlite3BtreeIsIn
7150: 42 61 63 6b 75 70 28 70 42 74 29 20 29 20 72 65 Backup(pBt) ) re
7160: 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 72 65 turn 1;. }. re
7170: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn 0;.}../*.**
7180: 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 73 74 69 Close an existi
7190: 6e 67 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 ng SQLite databa
71a0: 73 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 se.*/.static int
71b0: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 73 71 sqlite3Close(sq
71c0: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 66 lite3 *db, int f
71d0: 6f 72 63 65 5a 6f 6d 62 69 65 29 7b 0a 20 20 69 orceZombie){. i
71e0: 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 2f 2a f( !db ){. /*
71f0: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
7200: 36 33 32 35 37 2d 31 31 37 34 30 20 43 61 6c 6c 63257-11740 Call
7210: 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 ing sqlite3_clos
7220: 65 28 29 20 6f 72 0a 20 20 20 20 2a 2a 20 73 71 e() or. ** sq
7230: 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32 28 29 lite3_close_v2()
7240: 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 70 6f 69 with a NULL poi
7250: 6e 74 65 72 20 61 72 67 75 6d 65 6e 74 20 69 73 nter argument is
7260: 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f a harmless no-o
7270: 70 2e 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e p. */. return
7280: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
7290: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
72a0: 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f fetyCheckSickOrO
72b0: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
72c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
72d0: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 E_BKPT;. }. sq
72e0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
72f0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 0a 20 r(db->mutex);..
7300: 20 2f 2a 20 46 6f 72 63 65 20 78 44 69 73 63 6f /* Force xDisco
7310: 6e 6e 65 63 74 20 63 61 6c 6c 73 20 6f 6e 20 61 nnect calls on a
7320: 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ll virtual table
7330: 73 20 2a 2f 0a 20 20 64 69 73 63 6f 6e 6e 65 63 s */. disconnec
7340: 74 41 6c 6c 56 74 61 62 28 64 62 29 3b 0a 0a 20 tAllVtab(db);..
7350: 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 /* If a transac
7360: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 74 68 tion is open, th
7370: 65 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 e disconnectAllV
7380: 74 61 62 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 tab() call above
7390: 0a 20 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 . ** will not h
73a0: 61 76 65 20 63 61 6c 6c 65 64 20 74 68 65 20 78 ave called the x
73b0: 44 69 73 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 Disconnect() met
73c0: 68 6f 64 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 hod on any virtu
73d0: 61 6c 0a 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 al. ** tables i
73e0: 6e 20 74 68 65 20 64 62 2d 3e 61 56 54 72 61 6e n the db->aVTran
73f0: 73 5b 5d 20 61 72 72 61 79 2e 20 54 68 65 20 66 s[] array. The f
7400: 6f 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 ollowing sqlite3
7410: 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 VtabRollback().
7420: 20 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f ** call will do
7430: 20 73 6f 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 so. We need to
7440: 64 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20 74 do this before t
7450: 68 65 20 63 68 65 63 6b 20 66 6f 72 20 61 63 74 he check for act
7460: 69 76 65 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 ive. ** SQL sta
7470: 74 65 6d 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 tements below, a
7480: 73 20 74 68 65 20 76 2d 74 61 62 6c 65 20 69 6d s the v-table im
7490: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 plementation may
74a0: 20 62 65 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a be storing. **
74b0: 20 73 6f 6d 65 20 70 72 65 70 61 72 65 64 20 73 some prepared s
74c0: 74 61 74 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e tatements intern
74d0: 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c ally.. */. sql
74e0: 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b ite3VtabRollback
74f0: 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 4c 65 67 61 (db);.. /* Lega
7500: 63 79 20 62 65 68 61 76 69 6f 72 20 28 73 71 6c cy behavior (sql
7510: 69 74 65 33 5f 63 6c 6f 73 65 28 29 20 62 65 68 ite3_close() beh
7520: 61 76 69 6f 72 29 20 69 73 20 74 6f 20 72 65 74 avior) is to ret
7530: 75 72 6e 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f urn. ** SQLITE_
7540: 42 55 53 59 20 69 66 20 74 68 65 20 63 6f 6e 6e BUSY if the conn
7550: 65 63 74 69 6f 6e 20 63 61 6e 20 6e 6f 74 20 62 ection can not b
7560: 65 20 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 e closed immedia
7570: 74 65 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 tely.. */. if(
7580: 20 21 66 6f 72 63 65 5a 6f 6d 62 69 65 20 26 26 !forceZombie &&
7590: 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 connectionIsBus
75a0: 79 28 64 62 29 20 29 7b 0a 20 20 20 20 73 71 6c y(db) ){. sql
75b0: 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 ite3ErrorWithMsg
75c0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 (db, SQLITE_BUSY
75d0: 2c 20 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f , "unable to clo
75e0: 73 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 se due to unfina
75f0: 6c 69 7a 65 64 20 22 0a 20 20 20 20 20 20 20 22 lized ". "
7600: 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e statements or un
7610: 66 69 6e 69 73 68 65 64 20 62 61 63 6b 75 70 73 finished backups
7620: 22 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ");. sqlite3_
7630: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
7640: 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 mutex);. retu
7650: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a rn SQLITE_BUSY;.
7660: 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 }..#ifdef SQLI
7670: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 TE_ENABLE_SQLLOG
7680: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
7690: 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c obalConfig.xSqll
76a0: 6f 67 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6c 6f og ){. /* Clo
76b0: 73 69 6e 67 20 74 68 65 20 68 61 6e 64 6c 65 2e sing the handle.
76c0: 20 46 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 Fourth paramete
76d0: 72 20 69 73 20 70 61 73 73 65 64 20 74 68 65 20 r is passed the
76e0: 76 61 6c 75 65 20 32 2e 20 2a 2f 0a 20 20 20 20 value 2. */.
76f0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
7700: 66 69 67 2e 78 53 71 6c 6c 6f 67 28 73 71 6c 69 fig.xSqllog(sqli
7710: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
7720: 70 53 71 6c 6c 6f 67 41 72 67 2c 20 64 62 2c 20 pSqllogArg, db,
7730: 30 2c 20 32 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 0, 2);. }.#endi
7740: 66 0a 0a 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 f.. /* Convert
7750: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 the connection i
7760: 6e 74 6f 20 61 20 7a 6f 6d 62 69 65 20 61 6e 64 nto a zombie and
7770: 20 74 68 65 6e 20 63 6c 6f 73 65 20 69 74 2e 0a then close it..
7780: 20 20 2a 2f 0a 20 20 64 62 2d 3e 6d 61 67 69 63 */. db->magic
7790: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f = SQLITE_MAGIC_
77a0: 5a 4f 4d 42 49 45 3b 0a 20 20 73 71 6c 69 74 65 ZOMBIE;. sqlite
77b0: 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
77c0: 6f 73 65 5a 6f 6d 62 69 65 28 64 62 29 3b 0a 20 oseZombie(db);.
77d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
77e0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 K;.}../*.** Two
77f0: 76 61 72 69 61 74 69 6f 6e 73 20 6f 6e 20 74 68 variations on th
7800: 65 20 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 e public interfa
7810: 63 65 20 66 6f 72 20 63 6c 6f 73 69 6e 67 20 61 ce for closing a
7820: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
7830: 6e 65 63 74 69 6f 6e 2e 20 54 68 65 20 73 71 6c nection. The sql
7840: 69 74 65 33 5f 63 6c 6f 73 65 28 29 20 76 65 72 ite3_close() ver
7850: 73 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c sion returns SQL
7860: 49 54 45 5f 42 55 53 59 20 61 6e 64 0a 2a 2a 20 ITE_BUSY and.**
7870: 6c 65 61 76 65 73 20 74 68 65 20 63 6f 6e 6e 65 leaves the conne
7880: 63 74 69 6f 6e 20 6f 70 74 69 6f 6e 20 69 66 20 ction option if
7890: 74 68 65 72 65 20 61 72 65 20 75 6e 66 69 6e 61 there are unfina
78a0: 6c 69 7a 65 64 20 70 72 65 70 61 72 65 64 0a 2a lized prepared.*
78b0: 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 * statements or
78c0: 75 6e 66 69 6e 69 73 68 65 64 20 73 71 6c 69 74 unfinished sqlit
78d0: 65 33 5f 62 61 63 6b 75 70 73 2e 20 20 54 68 65 e3_backups. The
78e0: 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 sqlite3_close_v
78f0: 32 28 29 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 66 2().** version f
7900: 6f 72 63 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 orces the connec
7910: 74 69 6f 6e 20 74 6f 20 62 65 63 6f 6d 65 20 61 tion to become a
7920: 20 7a 6f 6d 62 69 65 20 69 66 20 74 68 65 72 65 zombie if there
7930: 20 61 72 65 0a 2a 2a 20 75 6e 63 6c 6f 73 65 64 are.** unclosed
7940: 20 72 65 73 6f 75 72 63 65 73 2c 20 61 6e 64 20 resources, and
7950: 61 72 72 61 6e 67 65 73 20 66 6f 72 20 64 65 61 arranges for dea
7960: 6c 6c 6f 63 61 74 69 6f 6e 20 77 68 65 6e 20 74 llocation when t
7970: 68 65 20 6c 61 73 74 0a 2a 2a 20 70 72 65 70 61 he last.** prepa
7980: 72 65 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 re statement or
7990: 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 63 sqlite3_backup c
79a0: 6c 6f 73 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 loses..*/.int sq
79b0: 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69 lite3_close(sqli
79c0: 74 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e te3 *db){ return
79d0: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 sqlite3Close(db
79e0: 2c 30 29 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 ,0); }.int sqlit
79f0: 65 33 5f 63 6c 6f 73 65 5f 76 32 28 73 71 6c 69 e3_close_v2(sqli
7a00: 74 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e te3 *db){ return
7a10: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 sqlite3Close(db
7a20: 2c 31 29 3b 20 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 ,1); }.../*.** C
7a30: 6c 6f 73 65 20 74 68 65 20 6d 75 74 65 78 20 6f lose the mutex o
7a40: 6e 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 n database conne
7a50: 63 74 69 6f 6e 20 64 62 2e 0a 2a 2a 0a 2a 2a 20 ction db..**.**
7a60: 46 75 72 74 68 65 72 6d 6f 72 65 2c 20 69 66 20 Furthermore, if
7a70: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
7a80: 69 6f 6e 20 64 62 20 69 73 20 61 20 7a 6f 6d 62 ion db is a zomb
7a90: 69 65 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 74 ie (meaning that
7aa0: 20 74 68 65 72 65 0a 2a 2a 20 68 61 73 20 62 65 there.** has be
7ab0: 65 6e 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 en a prior call
7ac0: 74 6f 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 to sqlite3_close
7ad0: 28 64 62 29 20 6f 72 20 73 71 6c 69 74 65 33 5f (db) or sqlite3_
7ae0: 63 6c 6f 73 65 5f 76 32 28 64 62 29 29 20 61 6e close_v2(db)) an
7af0: 64 0a 2a 2a 20 65 76 65 72 79 20 73 71 6c 69 74 d.** every sqlit
7b00: 65 33 5f 73 74 6d 74 20 68 61 73 20 6e 6f 77 20 e3_stmt has now
7b10: 62 65 65 6e 20 66 69 6e 61 6c 69 7a 65 64 20 61 been finalized a
7b20: 6e 64 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 nd every sqlite3
7b30: 5f 62 61 63 6b 75 70 20 68 61 73 0a 2a 2a 20 66 _backup has.** f
7b40: 69 6e 69 73 68 65 64 2c 20 74 68 65 6e 20 66 72 inished, then fr
7b50: 65 65 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 ee all resources
7b60: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 ..*/.void sqlite
7b70: 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
7b80: 6f 73 65 5a 6f 6d 62 69 65 28 73 71 6c 69 74 65 oseZombie(sqlite
7b90: 33 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 3 *db){. HashEl
7ba0: 65 6d 20 2a 69 3b 20 20 20 20 20 20 20 20 20 20 em *i;
7bb0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 /* Has
7bc0: 68 20 74 61 62 6c 65 20 69 74 65 72 61 74 6f 72 h table iterator
7bd0: 20 2a 2f 0a 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 */. int j;..
7be0: 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 /* If there are
7bf0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 73 71 6c 69 outstanding sqli
7c00: 74 65 33 5f 73 74 6d 74 20 6f 72 20 73 71 6c 69 te3_stmt or sqli
7c10: 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 te3_backup objec
7c20: 74 73 0a 20 20 2a 2a 20 6f 72 20 69 66 20 74 68 ts. ** or if th
7c30: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 e connection has
7c40: 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 63 6c not yet been cl
7c50: 6f 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f osed by sqlite3_
7c60: 63 6c 6f 73 65 5f 76 32 28 29 2c 0a 20 20 2a 2a close_v2(),. **
7c70: 20 74 68 65 6e 20 6a 75 73 74 20 6c 65 61 76 65 then just leave
7c80: 20 74 68 65 20 6d 75 74 65 78 20 61 6e 64 20 72 the mutex and r
7c90: 65 74 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 eturn.. */. if
7ca0: 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c ( db->magic!=SQL
7cb0: 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 ITE_MAGIC_ZOMBIE
7cc0: 20 7c 7c 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 || connectionIs
7cd0: 42 75 73 79 28 64 62 29 20 29 7b 0a 20 20 20 20 Busy(db) ){.
7ce0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
7cf0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
7d00: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a return;. }.
7d10: 0a 20 20 2f 2a 20 49 66 20 77 65 20 72 65 61 63 . /* If we reac
7d20: 68 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 69 74 h this point, it
7d30: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
7d40: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
7d50: 69 6f 6e 20 68 61 73 0a 20 20 2a 2a 20 63 6c 6f ion has. ** clo
7d60: 73 65 64 20 61 6c 6c 20 73 71 6c 69 74 65 33 5f sed all sqlite3_
7d70: 73 74 6d 74 20 61 6e 64 20 73 71 6c 69 74 65 33 stmt and sqlite3
7d80: 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 _backup objects
7d90: 61 6e 64 20 68 61 73 20 62 65 65 6e 0a 20 20 2a and has been. *
7da0: 2a 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 * passed to sqli
7db0: 74 65 33 5f 63 6c 6f 73 65 20 28 6d 65 61 6e 69 te3_close (meani
7dc0: 6e 67 20 74 68 61 74 20 69 74 20 69 73 20 61 20 ng that it is a
7dd0: 7a 6f 6d 62 69 65 29 2e 20 20 54 68 65 72 65 66 zombie). Theref
7de0: 6f 72 65 2c 0a 20 20 2a 2a 20 67 6f 20 61 68 65 ore,. ** go ahe
7df0: 61 64 20 61 6e 64 20 66 72 65 65 20 61 6c 6c 20 ad and free all
7e00: 72 65 73 6f 75 72 63 65 73 2e 0a 20 20 2a 2f 0a resources.. */.
7e10: 0a 20 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 . /* If a trans
7e20: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 action is open,
7e30: 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 54 68 roll it back. Th
7e40: 69 73 20 61 6c 73 6f 20 65 6e 73 75 72 65 73 20 is also ensures
7e50: 74 68 61 74 20 69 66 0a 20 20 2a 2a 20 61 6e 79 that if. ** any
7e60: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
7e70: 73 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 s have been modi
7e80: 66 69 65 64 20 62 79 20 61 6e 20 75 6e 63 6f 6d fied by an uncom
7e90: 6d 69 74 74 65 64 20 74 72 61 6e 73 61 63 74 69 mitted transacti
7ea0: 6f 6e 0a 20 20 2a 2a 20 74 68 65 79 20 61 72 65 on. ** they are
7eb0: 20 72 65 73 65 74 2e 20 41 6e 64 20 74 68 61 74 reset. And that
7ec0: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 62 2d the required b-
7ed0: 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 68 65 tree mutex is he
7ee0: 6c 64 20 74 6f 20 6d 61 6b 65 0a 20 20 2a 2a 20 ld to make. **
7ef0: 74 68 65 20 70 61 67 65 72 20 72 6f 6c 6c 62 61 the pager rollba
7f00: 63 6b 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 ck and schema re
7f10: 73 65 74 20 61 6e 20 61 74 6f 6d 69 63 20 6f 70 set an atomic op
7f20: 65 72 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 73 71 eration. */. sq
7f30: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c lite3RollbackAll
7f40: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b (db, SQLITE_OK);
7f50: 0a 0a 20 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 .. /* Free any
7f60: 6f 75 74 73 74 61 6e 64 69 6e 67 20 53 61 76 65 outstanding Save
7f70: 70 6f 69 6e 74 20 73 74 72 75 63 74 75 72 65 73 point structures
7f80: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 43 6c . */. sqlite3Cl
7f90: 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 64 62 oseSavepoints(db
7fa0: 29 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 );.. /* Close a
7fb0: 6c 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ll database conn
7fc0: 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 66 6f 72 ections */. for
7fd0: 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b (j=0; j<db->nDb;
7fe0: 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 j++){. struc
7ff0: 74 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d t Db *pDb = &db-
8000: 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 >aDb[j];. if(
8010: 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 pDb->pBt ){.
8020: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
8030: 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a lose(pDb->pBt);.
8040: 20 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d pDb->pBt =
8050: 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 6a 21 0;. if( j!
8060: 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 =1 ){. pD
8070: 62 2d 3e 70 53 63 68 65 6d 61 20 3d 20 30 3b 0a b->pSchema = 0;.
8080: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
8090: 7d 0a 20 20 2f 2a 20 43 6c 65 61 72 20 74 68 65 }. /* Clear the
80a0: 20 54 45 4d 50 20 73 63 68 65 6d 61 20 73 65 70 TEMP schema sep
80b0: 61 72 61 74 65 6c 79 20 61 6e 64 20 6c 61 73 74 arately and last
80c0: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 */. if( db->aD
80d0: 62 5b 31 5d 2e 70 53 63 68 65 6d 61 20 29 7b 0a b[1].pSchema ){.
80e0: 20 20 20 20 73 71 6c 69 74 65 33 53 63 68 65 6d sqlite3Schem
80f0: 61 43 6c 65 61 72 28 64 62 2d 3e 61 44 62 5b 31 aClear(db->aDb[1
8100: 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 7d 0a ].pSchema);. }.
8110: 20 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c sqlite3VtabUnl
8120: 6f 63 6b 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 ockList(db);..
8130: 2f 2a 20 46 72 65 65 20 75 70 20 74 68 65 20 61 /* Free up the a
8140: 72 72 61 79 20 6f 66 20 61 75 78 69 6c 69 61 72 rray of auxiliar
8150: 79 20 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 y databases */.
8160: 20 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 sqlite3Collapse
8170: 44 61 74 61 62 61 73 65 41 72 72 61 79 28 64 62 DatabaseArray(db
8180: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d );. assert( db-
8190: 3e 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 >nDb<=2 );. ass
81a0: 65 72 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 ert( db->aDb==db
81b0: 2d 3e 61 44 62 53 74 61 74 69 63 20 29 3b 0a 0a ->aDbStatic );..
81c0: 20 20 2f 2a 20 54 65 6c 6c 20 74 68 65 20 63 6f /* Tell the co
81d0: 64 65 20 69 6e 20 6e 6f 74 69 66 79 2e 63 20 74 de in notify.c t
81e0: 68 61 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 hat the connecti
81f0: 6f 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 68 6f 6c on no longer hol
8200: 64 73 20 61 6e 79 0a 20 20 2a 2a 20 6c 6f 63 6b ds any. ** lock
8210: 73 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 72 s and does not r
8220: 65 71 75 69 72 65 20 61 6e 79 20 66 75 72 74 68 equire any furth
8230: 65 72 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 er unlock-notify
8240: 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f callbacks.. */
8250: 0a 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 . sqlite3Connec
8260: 74 69 6f 6e 43 6c 6f 73 65 64 28 64 62 29 3b 0a tionClosed(db);.
8270: 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 41 72 . for(j=0; j<Ar
8280: 72 61 79 53 69 7a 65 28 64 62 2d 3e 61 46 75 6e raySize(db->aFun
8290: 63 2e 61 29 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 c.a); j++){.
82a0: 46 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 2c 20 FuncDef *pNext,
82b0: 2a 70 48 61 73 68 2c 20 2a 70 3b 0a 20 20 20 20 *pHash, *p;.
82c0: 66 6f 72 28 70 3d 64 62 2d 3e 61 46 75 6e 63 2e for(p=db->aFunc.
82d0: 61 5b 6a 5d 3b 20 70 3b 20 70 3d 70 48 61 73 68 a[j]; p; p=pHash
82e0: 29 7b 0a 20 20 20 20 20 20 70 48 61 73 68 20 3d ){. pHash =
82f0: 20 70 2d 3e 70 48 61 73 68 3b 0a 20 20 20 20 20 p->pHash;.
8300: 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 while( p ){.
8310: 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 44 65 73 functionDes
8320: 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 20 20 20 troy(db, p);.
8330: 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e pNext = p->
8340: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 73 pNext;. s
8350: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
8360: 20 70 29 3b 0a 20 20 20 20 20 20 20 20 70 20 3d p);. p =
8370: 20 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a pNext;. }.
8380: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 }. }. for(
8390: 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 i=sqliteHashFirs
83a0: 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 t(&db->aCollSeq)
83b0: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 ; i; i=sqliteHas
83c0: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 hNext(i)){. C
83d0: 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 ollSeq *pColl =
83e0: 28 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 (CollSeq *)sqlit
83f0: 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 eHashData(i);.
8400: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 61 6e 79 20 /* Invoke any
8410: 64 65 73 74 72 75 63 74 6f 72 73 20 72 65 67 69 destructors regi
8420: 73 74 65 72 65 64 20 66 6f 72 20 63 6f 6c 6c 61 stered for colla
8430: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 75 73 tion sequence us
8440: 65 72 20 64 61 74 61 2e 20 2a 2f 0a 20 20 20 20 er data. */.
8450: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b for(j=0; j<3; j+
8460: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 43 +){. if( pC
8470: 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 20 29 7b 0a 20 oll[j].xDel ){.
8480: 20 20 20 20 20 20 20 70 43 6f 6c 6c 5b 6a 5d 2e pColl[j].
8490: 78 44 65 6c 28 70 43 6f 6c 6c 5b 6a 5d 2e 70 55 xDel(pColl[j].pU
84a0: 73 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ser);. }.
84b0: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 }. sqlite3D
84c0: 62 46 72 65 65 28 64 62 2c 20 70 43 6f 6c 6c 29 bFree(db, pColl)
84d0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 ;. }. sqlite3H
84e0: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 ashClear(&db->aC
84f0: 6f 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 ollSeq);.#ifndef
8500: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 SQLITE_OMIT_VIR
8510: 54 55 41 4c 54 41 42 4c 45 0a 20 20 66 6f 72 28 TUALTABLE. for(
8520: 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 i=sqliteHashFirs
8530: 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b t(&db->aModule);
8540: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 i; i=sqliteHash
8550: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 4d 6f Next(i)){. Mo
8560: 64 75 6c 65 20 2a 70 4d 6f 64 20 3d 20 28 4d 6f dule *pMod = (Mo
8570: 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 dule *)sqliteHas
8580: 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20 69 66 hData(i);. if
8590: 28 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 ( pMod->xDestroy
85a0: 20 29 7b 0a 20 20 20 20 20 20 70 4d 6f 64 2d 3e ){. pMod->
85b0: 78 44 65 73 74 72 6f 79 28 70 4d 6f 64 2d 3e 70 xDestroy(pMod->p
85c0: 41 75 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Aux);. }.
85d0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
85e0: 2c 20 70 4d 6f 64 29 3b 0a 20 20 7d 0a 20 20 73 , pMod);. }. s
85f0: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 qlite3HashClear(
8600: 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 &db->aModule);.#
8610: 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 endif.. sqlite3
8620: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
8630: 5f 4f 4b 29 3b 20 2f 2a 20 44 65 61 6c 6c 6f 63 _OK); /* Dealloc
8640: 61 74 65 73 20 61 6e 79 20 63 61 63 68 65 64 20 ates any cached
8650: 65 72 72 6f 72 20 73 74 72 69 6e 67 73 2e 20 2a error strings. *
8660: 2f 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 /. sqlite3Value
8670: 46 72 65 65 28 64 62 2d 3e 70 45 72 72 29 3b 0a Free(db->pErr);.
8680: 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 sqlite3CloseEx
8690: 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 23 69 tensions(db);.#i
86a0: 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 f SQLITE_USER_AU
86b0: 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 THENTICATION. s
86c0: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e qlite3_free(db->
86d0: 61 75 74 68 2e 7a 41 75 74 68 55 73 65 72 29 3b auth.zAuthUser);
86e0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
86f0: 64 62 2d 3e 61 75 74 68 2e 7a 41 75 74 68 50 57 db->auth.zAuthPW
8700: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 64 62 2d );.#endif.. db-
8710: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
8720: 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 0a 20 20 MAGIC_ERROR;..
8730: 2f 2a 20 54 68 65 20 74 65 6d 70 2d 64 61 74 61 /* The temp-data
8740: 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 61 base schema is a
8750: 6c 6c 6f 63 61 74 65 64 20 64 69 66 66 65 72 65 llocated differe
8760: 6e 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 6f 74 ntly from the ot
8770: 68 65 72 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 her schema. **
8780: 6f 62 6a 65 63 74 73 20 28 75 73 69 6e 67 20 73 objects (using s
8790: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 64 69 qliteMalloc() di
87a0: 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 20 rectly, instead
87b0: 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 of sqlite3BtreeS
87c0: 63 68 65 6d 61 28 29 29 2e 0a 20 20 2a 2a 20 53 chema()).. ** S
87d0: 6f 20 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 o it needs to be
87e0: 20 66 72 65 65 64 20 68 65 72 65 2e 20 54 6f 64 freed here. Tod
87f0: 6f 3a 20 57 68 79 20 6e 6f 74 20 72 6f 6c 6c 20 o: Why not roll
8800: 74 68 65 20 74 65 6d 70 20 73 63 68 65 6d 61 20 the temp schema
8810: 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20 73 61 into. ** the sa
8820: 6d 65 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 me sqliteMalloc(
8830: 29 20 61 73 20 74 68 65 20 6f 6e 65 20 74 68 61 ) as the one tha
8840: 74 20 61 6c 6c 6f 63 61 74 65 73 20 74 68 65 20 t allocates the
8850: 64 61 74 61 62 61 73 65 20 0a 20 20 2a 2a 20 73 database . ** s
8860: 74 72 75 63 74 75 72 65 3f 0a 20 20 2a 2f 0a 20 tructure?. */.
8870: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
8880: 62 2c 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 b, db->aDb[1].pS
8890: 63 68 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 chema);. sqlite
88a0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
88b0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
88c0: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d magic = SQLITE_M
88d0: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 AGIC_CLOSED;. s
88e0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 qlite3_mutex_fre
88f0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
8900: 61 73 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f 6b assert( db->look
8910: 61 73 69 64 65 2e 6e 4f 75 74 3d 3d 30 20 29 3b aside.nOut==0 );
8920: 20 20 2f 2a 20 46 61 69 6c 73 20 6f 6e 20 61 20 /* Fails on a
8930: 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 lookaside memory
8940: 20 6c 65 61 6b 20 2a 2f 0a 20 20 69 66 28 20 64 leak */. if( d
8950: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 b->lookaside.bMa
8960: 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 lloced ){. sq
8970: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c lite3_free(db->l
8980: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 ookaside.pStart)
8990: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
89a0: 66 72 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a free(db);.}../*.
89b0: 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 ** Rollback all
89c0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 20 database files.
89d0: 20 49 66 20 74 72 69 70 43 6f 64 65 20 69 73 20 If tripCode is
89e0: 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 74 not SQLITE_OK, t
89f0: 68 65 6e 0a 2a 2a 20 61 6e 79 20 6f 70 65 6e 20 hen.** any open
8a00: 63 75 72 73 6f 72 73 20 61 72 65 20 69 6e 76 61 cursors are inva
8a10: 6c 69 64 61 74 65 64 20 28 22 74 72 69 70 70 65 lidated ("trippe
8a20: 64 22 20 2d 20 61 73 20 69 6e 20 22 74 72 69 70 d" - as in "trip
8a30: 70 69 6e 67 20 61 20 63 69 72 63 75 69 74 0a 2a ping a circuit.*
8a40: 2a 20 62 72 65 61 6b 65 72 22 29 20 61 6e 64 20 * breaker") and
8a50: 6d 61 64 65 20 74 6f 20 72 65 74 75 72 6e 20 74 made to return t
8a60: 72 69 70 43 6f 64 65 20 69 66 20 74 68 65 72 65 ripCode if there
8a70: 20 61 72 65 20 61 6e 79 20 66 75 72 74 68 65 72 are any further
8a80: 0a 2a 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 .** attempts to
8a90: 75 73 65 20 74 68 61 74 20 63 75 72 73 6f 72 2e use that cursor.
8aa0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
8ab0: 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69 RollbackAll(sqli
8ac0: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 74 72 69 te3 *db, int tri
8ad0: 70 43 6f 64 65 29 7b 0a 20 20 69 6e 74 20 69 3b pCode){. int i;
8ae0: 0a 20 20 69 6e 74 20 69 6e 54 72 61 6e 73 20 3d . int inTrans =
8af0: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 0;. assert( sq
8b00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
8b10: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 (db->mutex) );.
8b20: 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e sqlite3BeginBen
8b30: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 ignMalloc();..
8b40: 2f 2a 20 4f 62 74 61 69 6e 20 61 6c 6c 20 62 2d /* Obtain all b-
8b50: 74 72 65 65 20 6d 75 74 65 78 65 73 20 62 65 66 tree mutexes bef
8b60: 6f 72 65 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 ore making any c
8b70: 61 6c 6c 73 20 74 6f 20 42 74 72 65 65 52 6f 6c alls to BtreeRol
8b80: 6c 62 61 63 6b 28 29 2e 20 0a 20 20 2a 2a 20 54 lback(). . ** T
8b90: 68 69 73 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 his is important
8ba0: 20 69 6e 20 63 61 73 65 20 74 68 65 20 74 72 61 in case the tra
8bb0: 6e 73 61 63 74 69 6f 6e 20 62 65 69 6e 67 20 72 nsaction being r
8bc0: 6f 6c 6c 65 64 20 62 61 63 6b 20 68 61 73 0a 20 olled back has.
8bd0: 20 2a 2a 20 6d 6f 64 69 66 69 65 64 20 74 68 65 ** modified the
8be0: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
8bf0: 2e 20 49 66 20 74 68 65 20 62 2d 74 72 65 65 20 . If the b-tree
8c00: 6d 75 74 65 78 65 73 20 61 72 65 20 6e 6f 74 20 mutexes are not
8c10: 74 61 6b 65 6e 0a 20 20 2a 2a 20 68 65 72 65 2c taken. ** here,
8c20: 20 74 68 65 6e 20 61 6e 6f 74 68 65 72 20 73 68 then another sh
8c30: 61 72 65 64 2d 63 61 63 68 65 20 63 6f 6e 6e 65 ared-cache conne
8c40: 63 74 69 6f 6e 20 6d 69 67 68 74 20 73 6e 65 61 ction might snea
8c50: 6b 20 69 6e 20 62 65 74 77 65 65 6e 0a 20 20 2a k in between. *
8c60: 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 72 * the database r
8c70: 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 73 63 68 65 ollback and sche
8c80: 6d 61 20 72 65 73 65 74 2c 20 77 68 69 63 68 20 ma reset, which
8c90: 63 61 6e 20 63 61 75 73 65 20 66 61 6c 73 65 0a can cause false.
8ca0: 20 20 2a 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 ** corruption
8cb0: 72 65 70 6f 72 74 73 20 69 6e 20 73 6f 6d 65 20 reports in some
8cc0: 63 61 73 65 73 2e 20 20 2a 2f 0a 20 20 73 71 6c cases. */. sql
8cd0: 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c ite3BtreeEnterAl
8ce0: 6c 28 64 62 29 3b 0a 0a 20 20 66 6f 72 28 69 3d l(db);.. for(i=
8cf0: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
8d00: 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 +){. Btree *p
8d10: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 = db->aDb[i].pB
8d20: 74 3b 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a t;. if( p ){.
8d30: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
8d40: 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 3BtreeIsInTrans(
8d50: 70 29 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e p) ){. in
8d60: 54 72 61 6e 73 20 3d 20 31 3b 0a 20 20 20 20 20 Trans = 1;.
8d70: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
8d80: 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c BtreeRollback(p,
8d90: 20 74 72 69 70 43 6f 64 65 29 3b 0a 20 20 20 20 tripCode);.
8da0: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 }. }. sqlite3V
8db0: 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 62 29 3b tabRollback(db);
8dc0: 0a 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e . sqlite3EndBen
8dd0: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 ignMalloc();..
8de0: 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 if( (db->flags&S
8df0: 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e QLITE_InternChan
8e00: 67 65 73 29 21 3d 30 20 26 26 20 64 62 2d 3e 69 ges)!=0 && db->i
8e10: 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a 20 nit.busy==0 ){.
8e20: 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 sqlite3Expire
8e30: 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e PreparedStatemen
8e40: 74 73 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 ts(db);. sqli
8e50: 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d te3ResetAllSchem
8e60: 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 64 asOfConnection(d
8e70: 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 b);. }. sqlite
8e80: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 3BtreeLeaveAll(d
8e90: 62 29 3b 0a 0a 20 20 2f 2a 20 41 6e 79 20 64 65 b);.. /* Any de
8ea0: 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e ferred constrain
8eb0: 74 20 76 69 6f 6c 61 74 69 6f 6e 73 20 68 61 76 t violations hav
8ec0: 65 20 6e 6f 77 20 62 65 65 6e 20 72 65 73 6f 6c e now been resol
8ed0: 76 65 64 2e 20 2a 2f 0a 20 20 64 62 2d 3e 6e 44 ved. */. db->nD
8ee0: 65 66 65 72 72 65 64 43 6f 6e 73 20 3d 20 30 3b eferredCons = 0;
8ef0: 0a 20 20 64 62 2d 3e 6e 44 65 66 65 72 72 65 64 . db->nDeferred
8f00: 49 6d 6d 43 6f 6e 73 20 3d 20 30 3b 0a 20 20 64 ImmCons = 0;. d
8f10: 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c b->flags &= ~SQL
8f20: 49 54 45 5f 44 65 66 65 72 46 4b 73 3b 0a 0a 20 ITE_DeferFKs;..
8f30: 20 2f 2a 20 49 66 20 6f 6e 65 20 68 61 73 20 62 /* If one has b
8f40: 65 65 6e 20 63 6f 6e 66 69 67 75 72 65 64 2c 20 een configured,
8f50: 69 6e 76 6f 6b 65 20 74 68 65 20 72 6f 6c 6c 62 invoke the rollb
8f60: 61 63 6b 2d 68 6f 6f 6b 20 63 61 6c 6c 62 61 63 ack-hook callbac
8f70: 6b 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 78 k */. if( db->x
8f80: 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b RollbackCallback
8f90: 20 26 26 20 28 69 6e 54 72 61 6e 73 20 7c 7c 20 && (inTrans ||
8fa0: 21 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 29 !db->autoCommit)
8fb0: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 52 6f 6c ){. db->xRol
8fc0: 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 64 62 lbackCallback(db
8fd0: 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 29 3b ->pRollbackArg);
8fe0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 . }.}../*.** Re
8ff0: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74 turn a static st
9000: 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ring containing
9010: 74 68 65 20 6e 61 6d 65 20 63 6f 72 72 65 73 70 the name corresp
9020: 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 65 72 onding to the er
9030: 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 73 70 65 63 ror code.** spec
9040: 69 66 69 65 64 20 69 6e 20 74 68 65 20 61 72 67 ified in the arg
9050: 75 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 20 28 64 ument..*/.#if (d
9060: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
9070: 42 55 47 29 20 26 26 20 53 51 4c 49 54 45 5f 4f BUG) && SQLITE_O
9080: 53 5f 57 49 4e 29 20 7c 7c 20 64 65 66 69 6e 65 S_WIN) || define
9090: 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a 63 d(SQLITE_TEST).c
90a0: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
90b0: 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 20 72 63 e3ErrName(int rc
90c0: 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 ){. const char
90d0: 2a 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20 20 69 6e *zName = 0;. in
90e0: 74 20 69 2c 20 6f 72 69 67 52 63 20 3d 20 72 63 t i, origRc = rc
90f0: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 32 ;. for(i=0; i<2
9100: 20 26 26 20 7a 4e 61 6d 65 3d 3d 30 3b 20 69 2b && zName==0; i+
9110: 2b 2c 20 72 63 20 26 3d 20 30 78 66 66 29 7b 0a +, rc &= 0xff){.
9120: 20 20 20 20 73 77 69 74 63 68 28 20 72 63 20 29 switch( rc )
9130: 7b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c {. case SQL
9140: 49 54 45 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 ITE_OK:
9150: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
9160: 22 53 51 4c 49 54 45 5f 4f 4b 22 3b 20 20 20 20 "SQLITE_OK";
9170: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
9180: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
9190: 4c 49 54 45 5f 45 52 52 4f 52 3a 20 20 20 20 20 LITE_ERROR:
91a0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
91b0: 20 22 53 51 4c 49 54 45 5f 45 52 52 4f 52 22 3b "SQLITE_ERROR";
91c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
91d0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
91e0: 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c 3a 20 QLITE_INTERNAL:
91f0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
9200: 3d 20 22 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e = "SQLITE_INTERN
9210: 41 4c 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 AL"; br
9220: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
9230: 53 51 4c 49 54 45 5f 50 45 52 4d 3a 20 20 20 20 SQLITE_PERM:
9240: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
9250: 20 3d 20 22 53 51 4c 49 54 45 5f 50 45 52 4d 22 = "SQLITE_PERM"
9260: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 ; b
9270: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
9280: 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 3a 20 20 SQLITE_ABORT:
9290: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
92a0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 42 4f 52 e = "SQLITE_ABOR
92b0: 54 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 T";
92c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
92d0: 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 5f 52 e SQLITE_ABORT_R
92e0: 4f 4c 4c 42 41 43 4b 3a 20 20 20 20 20 7a 4e 61 OLLBACK: zNa
92f0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 42 4f me = "SQLITE_ABO
9300: 52 54 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 20 20 RT_ROLLBACK";
9310: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
9320: 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 3a 20 se SQLITE_BUSY:
9330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
9340: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 42 55 ame = "SQLITE_BU
9350: 53 59 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 SY";
9360: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9370: 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 5f ase SQLITE_BUSY_
9380: 52 45 43 4f 56 45 52 59 3a 20 20 20 20 20 20 7a RECOVERY: z
9390: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 42 Name = "SQLITE_B
93a0: 55 53 59 5f 52 45 43 4f 56 45 52 59 22 3b 20 20 USY_RECOVERY";
93b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
93c0: 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 case SQLITE_BUSY
93d0: 5f 53 4e 41 50 53 48 4f 54 3a 20 20 20 20 20 20 _SNAPSHOT:
93e0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
93f0: 42 55 53 59 5f 53 4e 41 50 53 48 4f 54 22 3b 20 BUSY_SNAPSHOT";
9400: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9410: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 case SQLITE_LOC
9420: 4b 45 44 3a 20 20 20 20 20 20 20 20 20 20 20 20 KED:
9430: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9440: 5f 4c 4f 43 4b 45 44 22 3b 20 20 20 20 20 20 20 _LOCKED";
9450: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
9460: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f case SQLITE_LO
9470: 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 CKED_SHAREDCACHE
9480: 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 : zName = "SQLIT
9490: 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 E_LOCKED_SHAREDC
94a0: 41 43 48 45 22 3b 62 72 65 61 6b 3b 0a 20 20 20 ACHE";break;.
94b0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
94c0: 4f 4d 45 4d 3a 20 20 20 20 20 20 20 20 20 20 20 OMEM:
94d0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
94e0: 54 45 5f 4e 4f 4d 45 4d 22 3b 20 20 20 20 20 20 TE_NOMEM";
94f0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
9500: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
9510: 52 45 41 44 4f 4e 4c 59 3a 20 20 20 20 20 20 20 READONLY:
9520: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
9530: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 22 3b 20 20 ITE_READONLY";
9540: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
9550: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
9560: 5f 52 45 41 44 4f 4e 4c 59 5f 52 45 43 4f 56 45 _READONLY_RECOVE
9570: 52 59 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 RY: zName = "SQ
9580: 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 45 LITE_READONLY_RE
9590: 43 4f 56 45 52 59 22 3b 20 62 72 65 61 6b 3b 0a COVERY"; break;.
95a0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
95b0: 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 41 4e 54 4c E_READONLY_CANTL
95c0: 4f 43 4b 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 OCK: zName = "S
95d0: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 QLITE_READONLY_C
95e0: 41 4e 54 4c 4f 43 4b 22 3b 20 62 72 65 61 6b 3b ANTLOCK"; break;
95f0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
9600: 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 4f 4c 4c TE_READONLY_ROLL
9610: 42 41 43 4b 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 BACK: zName = "
9620: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f SQLITE_READONLY_
9630: 52 4f 4c 4c 42 41 43 4b 22 3b 20 62 72 65 61 6b ROLLBACK"; break
9640: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
9650: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 44 42 4d ITE_READONLY_DBM
9660: 4f 56 45 44 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 OVED: zName =
9670: 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 "SQLITE_READONLY
9680: 5f 44 42 4d 4f 56 45 44 22 3b 20 20 62 72 65 61 _DBMOVED"; brea
9690: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
96a0: 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 3a 20 LITE_INTERRUPT:
96b0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
96c0: 20 22 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 "SQLITE_INTERRU
96d0: 50 54 22 3b 20 20 20 20 20 20 20 20 20 62 72 65 PT"; bre
96e0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
96f0: 51 4c 49 54 45 5f 49 4f 45 52 52 3a 20 20 20 20 QLITE_IOERR:
9700: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
9710: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 22 = "SQLITE_IOERR"
9720: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 ; br
9730: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
9740: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 45 41 SQLITE_IOERR_REA
9750: 44 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 D: zName
9760: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
9770: 5f 52 45 41 44 22 3b 20 20 20 20 20 20 20 20 62 _READ"; b
9780: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
9790: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 SQLITE_IOERR_SH
97a0: 4f 52 54 5f 52 45 41 44 3a 20 20 20 7a 4e 61 6d ORT_READ: zNam
97b0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
97c0: 52 5f 53 48 4f 52 54 5f 52 45 41 44 22 3b 20 20 R_SHORT_READ";
97d0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
97e0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 57 e SQLITE_IOERR_W
97f0: 52 49 54 45 3a 20 20 20 20 20 20 20 20 7a 4e 61 RITE: zNa
9800: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
9810: 52 52 5f 57 52 49 54 45 22 3b 20 20 20 20 20 20 RR_WRITE";
9820: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
9830: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
9840: 46 53 59 4e 43 3a 20 20 20 20 20 20 20 20 7a 4e FSYNC: zN
9850: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
9860: 45 52 52 5f 46 53 59 4e 43 22 3b 20 20 20 20 20 ERR_FSYNC";
9870: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9880: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
9890: 5f 44 49 52 5f 46 53 59 4e 43 3a 20 20 20 20 7a _DIR_FSYNC: z
98a0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
98b0: 4f 45 52 52 5f 44 49 52 5f 46 53 59 4e 43 22 3b OERR_DIR_FSYNC";
98c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
98d0: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
98e0: 52 5f 54 52 55 4e 43 41 54 45 3a 20 20 20 20 20 R_TRUNCATE:
98f0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
9900: 49 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 22 3b IOERR_TRUNCATE";
9910: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9920: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
9930: 52 52 5f 46 53 54 41 54 3a 20 20 20 20 20 20 20 RR_FSTAT:
9940: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9950: 5f 49 4f 45 52 52 5f 46 53 54 41 54 22 3b 20 20 _IOERR_FSTAT";
9960: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
9970: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
9980: 45 52 52 5f 55 4e 4c 4f 43 4b 3a 20 20 20 20 20 ERR_UNLOCK:
9990: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
99a0: 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 22 3b E_IOERR_UNLOCK";
99b0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
99c0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
99d0: 4f 45 52 52 5f 52 44 4c 4f 43 4b 3a 20 20 20 20 OERR_RDLOCK:
99e0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
99f0: 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b 22 TE_IOERR_RDLOCK"
9a00: 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 ; break;.
9a10: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
9a20: 49 4f 45 52 52 5f 44 45 4c 45 54 45 3a 20 20 20 IOERR_DELETE:
9a30: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
9a40: 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 ITE_IOERR_DELETE
9a50: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 "; break;.
9a60: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
9a70: 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3a 20 20 20 _IOERR_NOMEM:
9a80: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
9a90: 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d LITE_IOERR_NOMEM
9aa0: 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a "; break;.
9ab0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
9ac0: 45 5f 49 4f 45 52 52 5f 41 43 43 45 53 53 3a 20 E_IOERR_ACCESS:
9ad0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
9ae0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 45 QLITE_IOERR_ACCE
9af0: 53 53 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b SS"; break;
9b00: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
9b10: 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 TE_IOERR_CHECKRE
9b20: 53 45 52 56 45 44 4c 4f 43 4b 3a 0a 20 20 20 20 SERVEDLOCK:.
9b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9b40: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
9b50: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
9b60: 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c R_CHECKRESERVEDL
9b70: 4f 43 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 OCK"; break;.
9b80: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
9b90: 4f 45 52 52 5f 4c 4f 43 4b 3a 20 20 20 20 20 20 OERR_LOCK:
9ba0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
9bb0: 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 22 3b 20 TE_IOERR_LOCK";
9bc0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
9bd0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
9be0: 49 4f 45 52 52 5f 43 4c 4f 53 45 3a 20 20 20 20 IOERR_CLOSE:
9bf0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
9c00: 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 22 ITE_IOERR_CLOSE"
9c10: 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ; break;.
9c20: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
9c30: 5f 49 4f 45 52 52 5f 44 49 52 5f 43 4c 4f 53 45 _IOERR_DIR_CLOSE
9c40: 3a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 : zName = "SQ
9c50: 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 43 LITE_IOERR_DIR_C
9c60: 4c 4f 53 45 22 3b 20 20 20 62 72 65 61 6b 3b 0a LOSE"; break;.
9c70: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
9c80: 45 5f 49 4f 45 52 52 5f 53 48 4d 4f 50 45 4e 3a E_IOERR_SHMOPEN:
9c90: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
9ca0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4f QLITE_IOERR_SHMO
9cb0: 50 45 4e 22 3b 20 20 20 20 20 62 72 65 61 6b 3b PEN"; break;
9cc0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
9cd0: 54 45 5f 49 4f 45 52 52 5f 53 48 4d 53 49 5a 45 TE_IOERR_SHMSIZE
9ce0: 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 : zName = "
9cf0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d SQLITE_IOERR_SHM
9d00: 53 49 5a 45 22 3b 20 20 20 20 20 62 72 65 61 6b SIZE"; break
9d10: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
9d20: 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4c 4f 43 ITE_IOERR_SHMLOC
9d30: 4b 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 K: zName =
9d40: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 "SQLITE_IOERR_SH
9d50: 4d 4c 4f 43 4b 22 3b 20 20 20 20 20 62 72 65 61 MLOCK"; brea
9d60: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
9d70: 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4d 41 LITE_IOERR_SHMMA
9d80: 50 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d P: zName =
9d90: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 "SQLITE_IOERR_S
9da0: 48 4d 4d 41 50 22 3b 20 20 20 20 20 20 62 72 65 HMMAP"; bre
9db0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
9dc0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 45 45 4b QLITE_IOERR_SEEK
9dd0: 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 : zName
9de0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
9df0: 53 45 45 4b 22 3b 20 20 20 20 20 20 20 20 62 72 SEEK"; br
9e00: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
9e10: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c SQLITE_IOERR_DEL
9e20: 45 54 45 5f 4e 4f 45 4e 54 3a 20 7a 4e 61 6d 65 ETE_NOENT: zName
9e30: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
9e40: 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54 22 3b 62 _DELETE_NOENT";b
9e50: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
9e60: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4d 4d SQLITE_IOERR_MM
9e70: 41 50 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d AP: zNam
9e80: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
9e90: 52 5f 4d 4d 41 50 22 3b 20 20 20 20 20 20 20 20 R_MMAP";
9ea0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
9eb0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 47 e SQLITE_IOERR_G
9ec0: 45 54 54 45 4d 50 50 41 54 48 3a 20 20 7a 4e 61 ETTEMPPATH: zNa
9ed0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
9ee0: 52 52 5f 47 45 54 54 45 4d 50 50 41 54 48 22 3b RR_GETTEMPPATH";
9ef0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
9f00: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
9f10: 43 4f 4e 56 50 41 54 48 3a 20 20 20 20 20 7a 4e CONVPATH: zN
9f20: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
9f30: 45 52 52 5f 43 4f 4e 56 50 41 54 48 22 3b 20 20 ERR_CONVPATH";
9f40: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9f50: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 ase SQLITE_CORRU
9f60: 50 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 7a PT: z
9f70: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
9f80: 4f 52 52 55 50 54 22 3b 20 20 20 20 20 20 20 20 ORRUPT";
9f90: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
9fa0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 case SQLITE_CORR
9fb0: 55 50 54 5f 56 54 41 42 3a 20 20 20 20 20 20 20 UPT_VTAB:
9fc0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
9fd0: 43 4f 52 52 55 50 54 5f 56 54 41 42 22 3b 20 20 CORRUPT_VTAB";
9fe0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9ff0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 case SQLITE_NOT
a000: 46 4f 55 4e 44 3a 20 20 20 20 20 20 20 20 20 20 FOUND:
a010: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
a020: 5f 4e 4f 54 46 4f 55 4e 44 22 3b 20 20 20 20 20 _NOTFOUND";
a030: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
a040: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55 case SQLITE_FU
a050: 4c 4c 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 LL:
a060: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
a070: 45 5f 46 55 4c 4c 22 3b 20 20 20 20 20 20 20 20 E_FULL";
a080: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
a090: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
a0a0: 41 4e 54 4f 50 45 4e 3a 20 20 20 20 20 20 20 20 ANTOPEN:
a0b0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
a0c0: 54 45 5f 43 41 4e 54 4f 50 45 4e 22 3b 20 20 20 TE_CANTOPEN";
a0d0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
a0e0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
a0f0: 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 45 4d 50 44 CANTOPEN_NOTEMPD
a100: 49 52 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c IR: zName = "SQL
a110: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 ITE_CANTOPEN_NOT
a120: 45 4d 50 44 49 52 22 3b 62 72 65 61 6b 3b 0a 20 EMPDIR";break;.
a130: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a140: 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 44 49 52 3a _CANTOPEN_ISDIR:
a150: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
a160: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 LITE_CANTOPEN_IS
a170: 44 49 52 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a DIR"; break;.
a180: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a190: 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 55 4c 4c 50 E_CANTOPEN_FULLP
a1a0: 41 54 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 ATH: zName = "S
a1b0: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 QLITE_CANTOPEN_F
a1c0: 55 4c 4c 50 41 54 48 22 3b 20 62 72 65 61 6b 3b ULLPATH"; break;
a1d0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a1e0: 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 43 4f 4e 56 TE_CANTOPEN_CONV
a1f0: 50 41 54 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 PATH: zName = "
a200: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
a210: 43 4f 4e 56 50 41 54 48 22 3b 20 62 72 65 61 6b CONVPATH"; break
a220: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a230: 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20 ITE_PROTOCOL:
a240: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
a250: 22 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c "SQLITE_PROTOCOL
a260: 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 "; brea
a270: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a280: 4c 49 54 45 5f 45 4d 50 54 59 3a 20 20 20 20 20 LITE_EMPTY:
a290: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
a2a0: 20 22 53 51 4c 49 54 45 5f 45 4d 50 54 59 22 3b "SQLITE_EMPTY";
a2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
a2c0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a2d0: 51 4c 49 54 45 5f 53 43 48 45 4d 41 3a 20 20 20 QLITE_SCHEMA:
a2e0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
a2f0: 3d 20 22 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 = "SQLITE_SCHEMA
a300: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 72 "; br
a310: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a320: 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3a 20 20 SQLITE_TOOBIG:
a330: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
a340: 20 3d 20 22 53 51 4c 49 54 45 5f 54 4f 4f 42 49 = "SQLITE_TOOBI
a350: 47 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 G"; b
a360: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a370: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
a380: 4e 54 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d NT: zNam
a390: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
a3a0: 54 52 41 49 4e 54 22 3b 20 20 20 20 20 20 20 20 TRAINT";
a3b0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a3c0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
a3d0: 49 4e 54 5f 55 4e 49 51 55 45 3a 20 20 7a 4e 61 INT_UNIQUE: zNa
a3e0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e me = "SQLITE_CON
a3f0: 53 54 52 41 49 4e 54 5f 55 4e 49 51 55 45 22 3b STRAINT_UNIQUE";
a400: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a410: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 se SQLITE_CONSTR
a420: 41 49 4e 54 5f 54 52 49 47 47 45 52 3a 20 7a 4e AINT_TRIGGER: zN
a430: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f ame = "SQLITE_CO
a440: 4e 53 54 52 41 49 4e 54 5f 54 52 49 47 47 45 52 NSTRAINT_TRIGGER
a450: 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 ";break;. c
a460: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 ase SQLITE_CONST
a470: 52 41 49 4e 54 5f 46 4f 52 45 49 47 4e 4b 45 59 RAINT_FOREIGNKEY
a480: 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :.
a490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a4a0: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
a4b0: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 4f 52 E_CONSTRAINT_FOR
a4c0: 45 49 47 4e 4b 45 59 22 3b 20 20 20 62 72 65 61 EIGNKEY"; brea
a4d0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a4e0: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
a4f0: 43 48 45 43 4b 3a 20 20 20 7a 4e 61 6d 65 20 3d CHECK: zName =
a500: 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 "SQLITE_CONSTRA
a510: 49 4e 54 5f 43 48 45 43 4b 22 3b 20 20 62 72 65 INT_CHECK"; bre
a520: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a530: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
a540: 5f 50 52 49 4d 41 52 59 4b 45 59 3a 0a 20 20 20 _PRIMARYKEY:.
a550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a560: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
a570: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e me = "SQLITE_CON
a580: 53 54 52 41 49 4e 54 5f 50 52 49 4d 41 52 59 4b STRAINT_PRIMARYK
a590: 45 59 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 EY"; break;.
a5a0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
a5b0: 43 4f 4e 53 54 52 41 49 4e 54 5f 4e 4f 54 4e 55 CONSTRAINT_NOTNU
a5c0: 4c 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c LL: zName = "SQL
a5d0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4e ITE_CONSTRAINT_N
a5e0: 4f 54 4e 55 4c 4c 22 3b 62 72 65 61 6b 3b 0a 20 OTNULL";break;.
a5f0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a600: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 43 4f 4d 4d _CONSTRAINT_COMM
a610: 49 54 48 4f 4f 4b 3a 0a 20 20 20 20 20 20 20 20 ITHOOK:.
a620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a630: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
a640: 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 "SQLITE_CONSTRAI
a650: 4e 54 5f 43 4f 4d 4d 49 54 48 4f 4f 4b 22 3b 20 NT_COMMITHOOK";
a660: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
a670: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 ase SQLITE_CONST
a680: 52 41 49 4e 54 5f 56 54 41 42 3a 20 20 20 20 7a RAINT_VTAB: z
a690: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
a6a0: 4f 4e 53 54 52 41 49 4e 54 5f 56 54 41 42 22 3b ONSTRAINT_VTAB";
a6b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
a6c0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 case SQLITE_CONS
a6d0: 54 52 41 49 4e 54 5f 46 55 4e 43 54 49 4f 4e 3a TRAINT_FUNCTION:
a6e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
a6f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a700: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
a710: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 55 4e 43 _CONSTRAINT_FUNC
a720: 54 49 4f 4e 22 3b 20 20 20 20 20 62 72 65 61 6b TION"; break
a730: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a740: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 52 ITE_CONSTRAINT_R
a750: 4f 57 49 44 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 OWID: zName =
a760: 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 "SQLITE_CONSTRAI
a770: 4e 54 5f 52 4f 57 49 44 22 3b 20 20 62 72 65 61 NT_ROWID"; brea
a780: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a790: 4c 49 54 45 5f 4d 49 53 4d 41 54 43 48 3a 20 20 LITE_MISMATCH:
a7a0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
a7b0: 20 22 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 "SQLITE_MISMATC
a7c0: 48 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 H"; bre
a7d0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a7e0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3a 20 20 20 QLITE_MISUSE:
a7f0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
a800: 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 = "SQLITE_MISUSE
a810: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 72 "; br
a820: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a830: 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3a 20 20 20 SQLITE_NOLFS:
a840: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
a850: 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 = "SQLITE_NOLFS
a860: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 "; b
a870: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a880: 20 53 51 4c 49 54 45 5f 41 55 54 48 3a 20 20 20 SQLITE_AUTH:
a890: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
a8a0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 55 54 48 e = "SQLITE_AUTH
a8b0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
a8c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a8d0: 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 3a e SQLITE_FORMAT:
a8e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
a8f0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 46 4f 52 me = "SQLITE_FOR
a900: 4d 41 54 22 3b 20 20 20 20 20 20 20 20 20 20 20 MAT";
a910: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a920: 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 3a se SQLITE_RANGE:
a930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
a940: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 41 ame = "SQLITE_RA
a950: 4e 47 45 22 3b 20 20 20 20 20 20 20 20 20 20 20 NGE";
a960: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
a970: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 ase SQLITE_NOTAD
a980: 42 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a B: z
a990: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e Name = "SQLITE_N
a9a0: 4f 54 41 44 42 22 3b 20 20 20 20 20 20 20 20 20 OTADB";
a9b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
a9c0: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 4f 57 3a case SQLITE_ROW:
a9d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a9e0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
a9f0: 52 4f 57 22 3b 20 20 20 20 20 20 20 20 20 20 20 ROW";
aa00: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aa10: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 case SQLITE_NOT
aa20: 49 43 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 ICE:
aa30: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
aa40: 5f 4e 4f 54 49 43 45 22 3b 20 20 20 20 20 20 20 _NOTICE";
aa50: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
aa60: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f case SQLITE_NO
aa70: 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 57 41 4c TICE_RECOVER_WAL
aa80: 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 : zName = "SQLIT
aa90: 45 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 E_NOTICE_RECOVER
aaa0: 5f 57 41 4c 22 3b 62 72 65 61 6b 3b 0a 20 20 20 _WAL";break;.
aab0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
aac0: 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 52 4f OTICE_RECOVER_RO
aad0: 4c 4c 42 41 43 4b 3a 0a 20 20 20 20 20 20 20 20 LLBACK:.
aae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
aaf0: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
ab00: 22 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 "SQLITE_NOTICE_R
ab10: 45 43 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 4b 22 ECOVER_ROLLBACK"
ab20: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 ; break;. c
ab30: 61 73 65 20 53 51 4c 49 54 45 5f 57 41 52 4e 49 ase SQLITE_WARNI
ab40: 4e 47 3a 20 20 20 20 20 20 20 20 20 20 20 20 7a NG: z
ab50: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 57 Name = "SQLITE_W
ab60: 41 52 4e 49 4e 47 22 3b 20 20 20 20 20 20 20 20 ARNING";
ab70: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
ab80: 63 61 73 65 20 53 51 4c 49 54 45 5f 57 41 52 4e case SQLITE_WARN
ab90: 49 4e 47 5f 41 55 54 4f 49 4e 44 45 58 3a 20 20 ING_AUTOINDEX:
aba0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
abb0: 57 41 52 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 WARNING_AUTOINDE
abc0: 58 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 X"; break;.
abd0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 4f 4e case SQLITE_DON
abe0: 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 E:
abf0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
ac00: 5f 44 4f 4e 45 22 3b 20 20 20 20 20 20 20 20 20 _DONE";
ac10: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
ac20: 7d 0a 20 20 7d 0a 20 20 69 66 28 20 7a 4e 61 6d }. }. if( zNam
ac30: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 61 74 e==0 ){. stat
ac40: 69 63 20 63 68 61 72 20 7a 42 75 66 5b 35 30 5d ic char zBuf[50]
ac50: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e ;. sqlite3_sn
ac60: 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 7a 42 printf(sizeof(zB
ac70: 75 66 29 2c 20 7a 42 75 66 2c 20 22 53 51 4c 49 uf), zBuf, "SQLI
ac80: 54 45 5f 55 4e 4b 4e 4f 57 4e 28 25 64 29 22 2c TE_UNKNOWN(%d)",
ac90: 20 6f 72 69 67 52 63 29 3b 0a 20 20 20 20 7a 4e origRc);. zN
aca0: 61 6d 65 20 3d 20 7a 42 75 66 3b 0a 20 20 7d 0a ame = zBuf;. }.
acb0: 20 20 72 65 74 75 72 6e 20 7a 4e 61 6d 65 3b 0a return zName;.
acc0: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
acd0: 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 Return a static
ace0: 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 string that desc
acf0: 72 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f ribes the kind o
ad00: 66 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 f error specifie
ad10: 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 d in the.** argu
ad20: 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 ment..*/.const c
ad30: 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 har *sqlite3ErrS
ad40: 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 73 74 tr(int rc){. st
ad50: 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 2a atic const char*
ad60: 20 63 6f 6e 73 74 20 61 4d 73 67 5b 5d 20 3d 20 const aMsg[] =
ad70: 7b 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f {. /* SQLITE_
ad80: 4f 4b 20 20 20 20 20 20 20 20 20 20 2a 2f 20 22 OK */ "
ad90: 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 2c 0a 20 not an error",.
ada0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 52 52 /* SQLITE_ERR
adb0: 4f 52 20 20 20 20 20 20 20 2a 2f 20 22 53 51 4c OR */ "SQL
adc0: 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 20 logic error or
add0: 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 65 missing database
ade0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
adf0: 5f 49 4e 54 45 52 4e 41 4c 20 20 20 20 2a 2f 20 _INTERNAL */
ae00: 30 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 0,. /* SQLITE
ae10: 5f 50 45 52 4d 20 20 20 20 20 20 20 20 2a 2f 20 _PERM */
ae20: 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 73 69 "access permissi
ae30: 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 on denied",.
ae40: 2f 2a 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 20 /* SQLITE_ABORT
ae50: 20 20 20 20 20 20 2a 2f 20 22 63 61 6c 6c 62 61 */ "callba
ae60: 63 6b 20 72 65 71 75 65 73 74 65 64 20 71 75 65 ck requested que
ae70: 72 79 20 61 62 6f 72 74 22 2c 0a 20 20 20 20 2f ry abort",. /
ae80: 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 20 20 * SQLITE_BUSY
ae90: 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 */ "databas
aea0: 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0a 20 20 e is locked",.
aeb0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4c 4f 43 4b /* SQLITE_LOCK
aec0: 45 44 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 ED */ "data
aed0: 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c 6f base table is lo
aee0: 63 6b 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 cked",. /* SQ
aef0: 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 20 20 20 20 LITE_NOMEM
af00: 20 2a 2f 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f */ "out of memo
af10: 72 79 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ry",. /* SQLI
af20: 54 45 5f 52 45 41 44 4f 4e 4c 59 20 20 20 20 2a TE_READONLY *
af30: 2f 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 72 / "attempt to wr
af40: 69 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 ite a readonly d
af50: 61 74 61 62 61 73 65 22 2c 0a 20 20 20 20 2f 2a atabase",. /*
af60: 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 SQLITE_INTERRUP
af70: 54 20 20 20 2a 2f 20 22 69 6e 74 65 72 72 75 70 T */ "interrup
af80: 74 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ted",. /* SQL
af90: 49 54 45 5f 49 4f 45 52 52 20 20 20 20 20 20 20 ITE_IOERR
afa0: 2a 2f 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 72 */ "disk I/O err
afb0: 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 or",. /* SQLI
afc0: 54 45 5f 43 4f 52 52 55 50 54 20 20 20 20 20 2a TE_CORRUPT *
afd0: 2f 20 22 64 61 74 61 62 61 73 65 20 64 69 73 6b / "database disk
afe0: 20 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 image is malfor
aff0: 6d 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c med",. /* SQL
b000: 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 20 20 20 ITE_NOTFOUND
b010: 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 6f 70 65 72 */ "unknown oper
b020: 61 74 69 6f 6e 22 2c 0a 20 20 20 20 2f 2a 20 53 ation",. /* S
b030: 51 4c 49 54 45 5f 46 55 4c 4c 20 20 20 20 20 20 QLITE_FULL
b040: 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 6f */ "database o
b050: 72 20 64 69 73 6b 20 69 73 20 66 75 6c 6c 22 2c r disk is full",
b060: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 . /* SQLITE_C
b070: 41 4e 54 4f 50 45 4e 20 20 20 20 2a 2f 20 22 75 ANTOPEN */ "u
b080: 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 nable to open da
b090: 74 61 62 61 73 65 20 66 69 6c 65 22 2c 0a 20 20 tabase file",.
b0a0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 4f 54 /* SQLITE_PROT
b0b0: 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 6c 6f 63 6b OCOL */ "lock
b0c0: 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 22 2c 0a 20 ing protocol",.
b0d0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4d 50 /* SQLITE_EMP
b0e0: 54 59 20 20 20 20 20 20 20 2a 2f 20 22 74 61 62 TY */ "tab
b0f0: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 le contains no d
b100: 61 74 61 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ata",. /* SQL
b110: 49 54 45 5f 53 43 48 45 4d 41 20 20 20 20 20 20 ITE_SCHEMA
b120: 2a 2f 20 22 64 61 74 61 62 61 73 65 20 73 63 68 */ "database sch
b130: 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 ema has changed"
b140: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
b150: 54 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f 20 22 TOOBIG */ "
b160: 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 74 string or blob t
b170: 6f 6f 20 62 69 67 22 2c 0a 20 20 20 20 2f 2a 20 oo big",. /*
b180: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
b190: 54 20 20 2a 2f 20 22 63 6f 6e 73 74 72 61 69 6e T */ "constrain
b1a0: 74 20 66 61 69 6c 65 64 22 2c 0a 20 20 20 20 2f t failed",. /
b1b0: 2a 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 * SQLITE_MISMATC
b1c0: 48 20 20 20 20 2a 2f 20 22 64 61 74 61 74 79 70 H */ "datatyp
b1d0: 65 20 6d 69 73 6d 61 74 63 68 22 2c 0a 20 20 20 e mismatch",.
b1e0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 /* SQLITE_MISUS
b1f0: 45 20 20 20 20 20 20 2a 2f 20 22 6c 69 62 72 61 E */ "libra
b200: 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65 ry routine calle
b210: 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e 63 d out of sequenc
b220: 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 e",. /* SQLIT
b230: 45 5f 4e 4f 4c 46 53 20 20 20 20 20 20 20 2a 2f E_NOLFS */
b240: 20 22 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 "large file sup
b250: 70 6f 72 74 20 69 73 20 64 69 73 61 62 6c 65 64 port is disabled
b260: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
b270: 5f 41 55 54 48 20 20 20 20 20 20 20 20 2a 2f 20 _AUTH */
b280: 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 "authorization d
b290: 65 6e 69 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 enied",. /* S
b2a0: 51 4c 49 54 45 5f 46 4f 52 4d 41 54 20 20 20 20 QLITE_FORMAT
b2b0: 20 20 2a 2f 20 22 61 75 78 69 6c 69 61 72 79 20 */ "auxiliary
b2c0: 64 61 74 61 62 61 73 65 20 66 6f 72 6d 61 74 20 database format
b2d0: 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 error",. /* S
b2e0: 51 4c 49 54 45 5f 52 41 4e 47 45 20 20 20 20 20 QLITE_RANGE
b2f0: 20 20 2a 2f 20 22 62 69 6e 64 20 6f 72 20 63 6f */ "bind or co
b300: 6c 75 6d 6e 20 69 6e 64 65 78 20 6f 75 74 20 6f lumn index out o
b310: 66 20 72 61 6e 67 65 22 2c 0a 20 20 20 20 2f 2a f range",. /*
b320: 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 20 20 SQLITE_NOTADB
b330: 20 20 20 20 2a 2f 20 22 66 69 6c 65 20 69 73 20 */ "file is
b340: 65 6e 63 72 79 70 74 65 64 20 6f 72 20 69 73 20 encrypted or is
b350: 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 22 2c not a database",
b360: 0a 20 20 7d 3b 0a 20 20 63 6f 6e 73 74 20 63 68 . };. const ch
b370: 61 72 20 2a 7a 45 72 72 20 3d 20 22 75 6e 6b 6e ar *zErr = "unkn
b380: 6f 77 6e 20 65 72 72 6f 72 22 3b 0a 20 20 73 77 own error";. sw
b390: 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20 itch( rc ){.
b3a0: 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 case SQLITE_ABOR
b3b0: 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 7b 0a 20 20 T_ROLLBACK: {.
b3c0: 20 20 20 20 7a 45 72 72 20 3d 20 22 61 62 6f 72 zErr = "abor
b3d0: 74 20 64 75 65 20 74 6f 20 52 4f 4c 4c 42 41 43 t due to ROLLBAC
b3e0: 4b 22 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b K";. break;
b3f0: 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 . }. defau
b400: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 26 lt: {. rc &
b410: 3d 20 30 78 66 66 3b 0a 20 20 20 20 20 20 69 66 = 0xff;. if
b420: 28 20 41 4c 57 41 59 53 28 72 63 3e 3d 30 29 20 ( ALWAYS(rc>=0)
b430: 26 26 20 72 63 3c 41 72 72 61 79 53 69 7a 65 28 && rc<ArraySize(
b440: 61 4d 73 67 29 20 26 26 20 61 4d 73 67 5b 72 63 aMsg) && aMsg[rc
b450: 5d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 ]!=0 ){.
b460: 7a 45 72 72 20 3d 20 61 4d 73 67 5b 72 63 5d 3b zErr = aMsg[rc];
b470: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 . }. b
b480: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a reak;. }. }.
b490: 20 20 72 65 74 75 72 6e 20 7a 45 72 72 3b 0a 7d return zErr;.}
b4a0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
b4b0: 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 tine implements
b4c0: 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 a busy callback
b4d0: 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e 64 20 that sleeps and
b4e0: 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 75 tries.** again u
b4f0: 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 76 ntil a timeout v
b500: 61 6c 75 65 20 69 73 20 72 65 61 63 68 65 64 2e alue is reached.
b510: 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20 76 61 The timeout va
b520: 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 lue is.** an int
b530: 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 6d eger number of m
b540: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 73 illiseconds pass
b550: 65 64 20 69 6e 20 61 73 20 74 68 65 20 66 69 72 ed in as the fir
b560: 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a st.** argument..
b570: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 */.static int sq
b580: 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 liteDefaultBusyC
b590: 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 2a allback(. void *
b5a0: 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 ptr,
b5b0: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 /* Database c
b5c0: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e onnection */. in
b5d0: 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 20 t count
b5e0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
b5f0: 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 20 of times table
b600: 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a 2f has been busy */
b610: 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4f .){.#if SQLITE_O
b620: 53 5f 57 49 4e 20 7c 7c 20 28 64 65 66 69 6e 65 S_WIN || (define
b630: 64 28 48 41 56 45 5f 55 53 4c 45 45 50 29 20 26 d(HAVE_USLEEP) &
b640: 26 20 48 41 56 45 5f 55 53 4c 45 45 50 29 0a 20 & HAVE_USLEEP).
b650: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 static const u8
b660: 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 20 delays[] =.
b670: 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c 20 { 1, 2, 5, 10,
b680: 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 20 15, 20, 25, 25,
b690: 20 32 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 31 25, 50, 50, 1
b6a0: 30 30 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 00 };. static c
b6b0: 6f 6e 73 74 20 75 38 20 74 6f 74 61 6c 73 5b 5d onst u8 totals[]
b6c0: 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20 =. { 0, 1,
b6d0: 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35 3, 8, 18, 33, 5
b6e0: 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c 3, 78, 103, 128,
b6f0: 20 31 37 38 2c 20 32 32 38 20 7d 3b 0a 23 20 64 178, 228 };.# d
b700: 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 41 72 72 efine NDELAY Arr
b710: 61 79 53 69 7a 65 28 64 65 6c 61 79 73 29 0a 20 aySize(delays).
b720: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 28 sqlite3 *db = (
b730: 73 71 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a 20 sqlite3 *)ptr;.
b740: 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 64 int timeout = d
b750: 62 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a b->busyTimeout;.
b760: 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 69 int delay, pri
b770: 6f 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 or;.. assert( c
b780: 6f 75 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 66 28 ount>=0 );. if(
b790: 20 63 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 59 20 count < NDELAY
b7a0: 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 ){. delay = d
b7b0: 65 6c 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 elays[count];.
b7c0: 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 prior = totals
b7d0: 5b 63 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c 73 65 [count];. }else
b7e0: 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 {. delay = de
b7f0: 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b 0a lays[NDELAY-1];.
b800: 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 prior = tota
b810: 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 64 ls[NDELAY-1] + d
b820: 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 28 4e 44 45 elay*(count-(NDE
b830: 4c 41 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 20 69 LAY-1));. }. i
b840: 66 28 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 f( prior + delay
b850: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 > timeout ){.
b860: 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 delay = timeou
b870: 74 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 t - prior;. i
b880: 66 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 f( delay<=0 ) re
b890: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 turn 0;. }. sq
b8a0: 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 64 62 2d lite3OsSleep(db-
b8b0: 3e 70 56 66 73 2c 20 64 65 6c 61 79 2a 31 30 30 >pVfs, delay*100
b8c0: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 0);. return 1;.
b8d0: 23 65 6c 73 65 0a 20 20 73 71 6c 69 74 65 33 20 #else. sqlite3
b8e0: 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 33 20 2a *db = (sqlite3 *
b8f0: 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d 65 )ptr;. int time
b900: 6f 75 74 20 3d 20 28 28 73 71 6c 69 74 65 33 20 out = ((sqlite3
b910: 2a 29 70 74 72 29 2d 3e 62 75 73 79 54 69 6d 65 *)ptr)->busyTime
b920: 6f 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e out;. if( (coun
b930: 74 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 t+1)*1000 > time
b940: 6f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 out ){. retur
b950: 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 n 0;. }. sqlit
b960: 65 33 4f 73 53 6c 65 65 70 28 64 62 2d 3e 70 56 e3OsSleep(db->pV
b970: 66 73 2c 20 31 30 30 30 30 30 30 29 3b 0a 20 20 fs, 1000000);.
b980: 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 return 1;.#endif
b990: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 .}../*.** Invoke
b9a0: 20 74 68 65 20 67 69 76 65 6e 20 62 75 73 79 20 the given busy
b9b0: 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 handler..**.** T
b9c0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
b9d0: 61 6c 6c 65 64 20 77 68 65 6e 20 61 6e 20 6f 70 alled when an op
b9e0: 65 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 77 eration failed w
b9f0: 69 74 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a 20 49 ith a lock..** I
ba00: 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 f this routine r
ba10: 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c eturns non-zero,
ba20: 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 72 65 74 the lock is ret
ba30: 72 69 65 64 2e 20 20 49 66 20 69 74 0a 2a 2a 20 ried. If it.**
ba40: 72 65 74 75 72 6e 73 20 30 2c 20 74 68 65 20 6f returns 0, the o
ba50: 70 65 72 61 74 69 6f 6e 20 61 62 6f 72 74 73 20 peration aborts
ba60: 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 42 with an SQLITE_B
ba70: 55 53 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a 69 6e USY error..*/.in
ba80: 74 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 t sqlite3InvokeB
ba90: 75 73 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 usyHandler(BusyH
baa0: 61 6e 64 6c 65 72 20 2a 70 29 7b 0a 20 20 69 6e andler *p){. in
bab0: 74 20 72 63 3b 0a 20 20 69 66 28 20 4e 45 56 45 t rc;. if( NEVE
bac0: 52 28 70 3d 3d 30 29 20 7c 7c 20 70 2d 3e 78 46 R(p==0) || p->xF
bad0: 75 6e 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 42 75 unc==0 || p->nBu
bae0: 73 79 3c 30 20 29 20 72 65 74 75 72 6e 20 30 3b sy<0 ) return 0;
baf0: 0a 20 20 72 63 20 3d 20 70 2d 3e 78 46 75 6e 63 . rc = p->xFunc
bb00: 28 70 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e 42 75 (p->pArg, p->nBu
bb10: 73 79 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 sy);. if( rc==0
bb20: 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 ){. p->nBusy
bb30: 20 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a = -1;. }else{.
bb40: 20 20 20 20 70 2d 3e 6e 42 75 73 79 2b 2b 3b 0a p->nBusy++;.
bb50: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
bb60: 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}../*.** This
bb70: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 routine sets the
bb80: 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 busy callback f
bb90: 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 or an Sqlite dat
bba0: 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 abase to the.**
bbb0: 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 given callback f
bbc0: 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 unction with the
bbd0: 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e given argument.
bbe0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
bbf0: 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 busy_handler(.
bc00: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 69 sqlite3 *db,. i
bc10: 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 nt (*xBusy)(void
bc20: 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a *,int),. void *
bc30: 70 41 72 67 0a 29 7b 0a 23 69 66 64 65 66 20 53 pArg.){.#ifdef S
bc40: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
bc50: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
bc60: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
bc70: 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 Ok(db) ) return
bc80: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 23 SQLITE_MISUSE;.#
bc90: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
bca0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
bcb0: 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 62 75 mutex);. db->bu
bcc0: 73 79 48 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20 syHandler.xFunc
bcd0: 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62 = xBusy;. db->b
bce0: 75 73 79 48 61 6e 64 6c 65 72 2e 70 41 72 67 20 usyHandler.pArg
bcf0: 3d 20 70 41 72 67 3b 0a 20 20 64 62 2d 3e 62 75 = pArg;. db->bu
bd00: 73 79 48 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 syHandler.nBusy
bd10: 3d 20 30 3b 0a 20 20 64 62 2d 3e 62 75 73 79 54 = 0;. db->busyT
bd20: 69 6d 65 6f 75 74 20 3d 20 30 3b 0a 20 20 73 71 imeout = 0;. sq
bd30: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
bd40: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
bd50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
bd60: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ;.}..#ifndef SQL
bd70: 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 ITE_OMIT_PROGRES
bd80: 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a S_CALLBACK./*.**
bd90: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 This routine se
bda0: 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 ts the progress
bdb0: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 callback for an
bdc0: 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 Sqlite database
bdd0: 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 to the.** given
bde0: 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f callback functio
bdf0: 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e n with the given
be00: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 argument. The p
be10: 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b rogress callback
be20: 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f will.** be invo
be30: 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f ked every nOps o
be40: 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 pcodes..*/.void
be50: 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 sqlite3_progress
be60: 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 _handler(. sqli
be70: 74 65 33 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 te3 *db, . int
be80: 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 nOps,. int (*xP
be90: 72 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c rogress)(void*),
bea0: 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 . void *pArg.)
beb0: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
bec0: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
bed0: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
bee0: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
bef0: 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
bf00: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
bf10: 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 ;. return;.
bf20: 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 }.#endif. sqlit
bf30: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
bf40: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 b->mutex);. if(
bf50: 20 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 20 20 64 nOps>0 ){. d
bf60: 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 78 b->xProgress = x
bf70: 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 20 64 62 Progress;. db
bf80: 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 3d ->nProgressOps =
bf90: 20 28 75 6e 73 69 67 6e 65 64 29 6e 4f 70 73 3b (unsigned)nOps;
bfa0: 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 . db->pProgre
bfb0: 73 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 ssArg = pArg;.
bfc0: 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 }else{. db->x
bfd0: 50 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 Progress = 0;.
bfe0: 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f db->nProgressO
bff0: 70 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e ps = 0;. db->
c000: 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 30 pProgressArg = 0
c010: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
c020: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
c030: 6d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 mutex);.}.#endif
c040: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f .../*.** This ro
c050: 75 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 utine installs a
c060: 20 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 default busy ha
c070: 6e 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 ndler that waits
c080: 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 for the.** spec
c090: 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 ified number of
c0a0: 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 milliseconds bef
c0b0: 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e ore returning 0.
c0c0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
c0d0: 62 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c busy_timeout(sql
c0e0: 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 ite3 *db, int ms
c0f0: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
c100: 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
c110: 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
c120: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
c130: 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ) ) return SQLIT
c140: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
c150: 65 6e 64 69 66 0a 20 20 69 66 28 20 6d 73 3e 30 endif. if( ms>0
c160: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ){. sqlite3_
c170: 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c busy_handler(db,
c180: 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 sqliteDefaultBu
c190: 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 syCallback, (voi
c1a0: 64 2a 29 64 62 29 3b 0a 20 20 20 20 64 62 2d 3e d*)db);. db->
c1b0: 62 75 73 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 busyTimeout = ms
c1c0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
c1d0: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 qlite3_busy_hand
c1e0: 6c 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 ler(db, 0, 0);.
c1f0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
c200: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
c210: 43 61 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e Cause any pendin
c220: 67 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 g operation to s
c230: 74 6f 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 top at its earli
c240: 65 73 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e est opportunity.
c250: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
c260: 5f 69 6e 74 65 72 72 75 70 74 28 73 71 6c 69 74 _interrupt(sqlit
c270: 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 e3 *db){.#ifdef
c280: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
c290: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
c2a0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
c2b0: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
c2c0: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
c2d0: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
c2e0: 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a urn;. }.#endif.
c2f0: 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 72 db->u1.isInter
c300: 72 75 70 74 65 64 20 3d 20 31 3b 0a 7d 0a 0a 0a rupted = 1;.}...
c310: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
c320: 69 6f 6e 20 69 73 20 65 78 61 63 74 6c 79 20 74 ion is exactly t
c330: 68 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74 he same as sqlit
c340: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 e3_create_functi
c350: 6f 6e 28 29 2c 20 65 78 63 65 70 74 0a 2a 2a 20 on(), except.**
c360: 74 68 61 74 20 69 74 20 69 73 20 64 65 73 69 67 that it is desig
c370: 6e 65 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 ned to be called
c380: 20 62 79 20 69 6e 74 65 72 6e 61 6c 20 63 6f 64 by internal cod
c390: 65 2e 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 e. The differenc
c3a0: 65 20 69 73 0a 2a 2a 20 74 68 61 74 20 69 66 20 e is.** that if
c3b0: 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 73 a malloc() fails
c3c0: 20 69 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 in sqlite3_crea
c3d0: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 61 te_function(), a
c3e0: 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 n error code.**
c3f0: 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 is returned and
c400: 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 the mallocFailed
c410: 20 66 6c 61 67 20 63 6c 65 61 72 65 64 2e 20 0a flag cleared. .
c420: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 72 */.int sqlite3Cr
c430: 65 61 74 65 46 75 6e 63 28 0a 20 20 73 71 6c 69 eateFunc(. sqli
c440: 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 te3 *db,. const
c450: 20 63 68 61 72 20 2a 7a 46 75 6e 63 74 69 6f 6e char *zFunction
c460: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Name,. int nArg
c470: 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 ,. int enc,. v
c480: 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 2c 0a oid *pUserData,.
c490: 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 void (*xFunc)(
c4a0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
c4b0: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
c4c0: 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 ue **),. void (
c4d0: 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f *xStep)(sqlite3_
c4e0: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
c4f0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a ite3_value **),.
c500: 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 void (*xFinal)
c510: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
c520: 2a 29 2c 0a 20 20 46 75 6e 63 44 65 73 74 72 75 *),. FuncDestru
c530: 63 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f ctor *pDestructo
c540: 72 0a 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a r.){. FuncDef *
c550: 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a p;. int nName;.
c560: 20 20 69 6e 74 20 65 78 74 72 61 46 6c 61 67 73 int extraFlags
c570: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
c580: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
c590: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
c5a0: 69 66 28 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d if( zFunctionNam
c5b0: 65 3d 3d 30 20 7c 7c 0a 20 20 20 20 20 20 28 78 e==0 ||. (x
c5c0: 46 75 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 Func && (xFinal
c5d0: 7c 7c 20 78 53 74 65 70 29 29 20 7c 7c 20 0a 20 || xStep)) || .
c5e0: 20 20 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 (!xFunc &&
c5f0: 28 78 46 69 6e 61 6c 20 26 26 20 21 78 53 74 65 (xFinal && !xSte
c600: 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 28 21 78 p)) ||. (!x
c610: 46 75 6e 63 20 26 26 20 28 21 78 46 69 6e 61 6c Func && (!xFinal
c620: 20 26 26 20 78 53 74 65 70 29 29 20 7c 7c 0a 20 && xStep)) ||.
c630: 20 20 20 20 20 28 6e 41 72 67 3c 2d 31 20 7c 7c (nArg<-1 ||
c640: 20 6e 41 72 67 3e 53 51 4c 49 54 45 5f 4d 41 58 nArg>SQLITE_MAX
c650: 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 29 20 7c _FUNCTION_ARG) |
c660: 7c 0a 20 20 20 20 20 20 28 32 35 35 3c 28 6e 4e |. (255<(nN
c670: 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 72 ame = sqlite3Str
c680: 6c 65 6e 33 30 28 20 7a 46 75 6e 63 74 69 6f 6e len30( zFunction
c690: 4e 61 6d 65 29 29 29 20 29 7b 0a 20 20 20 20 72 Name))) ){. r
c6a0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
c6b0: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 USE_BKPT;. }..
c6c0: 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f assert( SQLITE_
c6d0: 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 3d 3d 53 FUNC_CONSTANT==S
c6e0: 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 QLITE_DETERMINIS
c6f0: 54 49 43 20 29 3b 0a 20 20 65 78 74 72 61 46 6c TIC );. extraFl
c700: 61 67 73 20 3d 20 65 6e 63 20 26 20 20 53 51 4c ags = enc & SQL
c710: 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 ITE_DETERMINISTI
c720: 43 3b 0a 20 20 65 6e 63 20 26 3d 20 28 53 51 4c C;. enc &= (SQL
c730: 49 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b ITE_FUNC_ENCMASK
c740: 7c 53 51 4c 49 54 45 5f 41 4e 59 29 3b 0a 20 20 |SQLITE_ANY);.
c750: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
c760: 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 2f 2a 20 OMIT_UTF16. /*
c770: 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 If SQLITE_UTF16
c780: 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 is specified as
c790: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70 the encoding typ
c7a0: 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69 e, transform thi
c7b0: 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 s. ** to one of
c7c0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 SQLITE_UTF16LE
c7d0: 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 or SQLITE_UTF16B
c7e0: 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a E using the. **
c7f0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
c800: 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54 IVE macro. SQLIT
c810: 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75 E_UTF16 is not u
c820: 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a sed internally..
c830: 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c **. ** If SQL
c840: 49 54 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69 ITE_ANY is speci
c850: 66 69 65 64 2c 20 61 64 64 20 74 68 72 65 65 20 fied, add three
c860: 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 versions of the
c870: 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f function. ** to
c880: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e the hash table.
c890: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d . */. if( enc=
c8a0: 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b =SQLITE_UTF16 ){
c8b0: 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 . enc = SQLIT
c8c0: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 E_UTF16NATIVE;.
c8d0: 20 7d 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d }else if( enc==
c8e0: 53 51 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20 SQLITE_ANY ){.
c8f0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63 int rc;. rc
c900: 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 = sqlite3Create
c910: 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 Func(db, zFuncti
c920: 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 onName, nArg, SQ
c930: 4c 49 54 45 5f 55 54 46 38 7c 65 78 74 72 61 46 LITE_UTF8|extraF
c940: 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 20 20 70 lags,. p
c950: 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c UserData, xFunc,
c960: 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 xStep, xFinal,
c970: 70 44 65 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 pDestructor);.
c980: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
c990: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 _OK ){. rc
c9a0: 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 = sqlite3CreateF
c9b0: 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f unc(db, zFunctio
c9c0: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c nName, nArg, SQL
c9d0: 49 54 45 5f 55 54 46 31 36 4c 45 7c 65 78 74 72 ITE_UTF16LE|extr
c9e0: 61 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 20 aFlags,.
c9f0: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 pUserData, xFu
ca00: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 nc, xStep, xFina
ca10: 6c 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b l, pDestructor);
ca20: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
ca30: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
ca40: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
ca50: 0a 20 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d . }. enc =
ca60: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b SQLITE_UTF16BE;
ca70: 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 . }.#else. enc
ca80: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a = SQLITE_UTF8;.
ca90: 23 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 #endif. . /* C
caa0: 68 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 heck if an exist
cab0: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 ing function is
cac0: 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e being overridden
cad0: 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 or deleted. If
cae0: 73 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 so,. ** and the
caf0: 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d re are active VM
cb00: 73 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 s, then return S
cb10: 51 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 QLITE_BUSY. If a
cb20: 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 function. ** i
cb30: 73 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 s being overridd
cb40: 65 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 en/deleted but t
cb50: 68 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 here are no acti
cb60: 76 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 ve VMs, allow th
cb70: 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e e. ** operation
cb80: 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 to continue but
cb90: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 invalidate all
cba0: 70 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 precompiled stat
cbb0: 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 ements.. */. p
cbc0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
cbd0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
cbe0: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c tionName, nName,
cbf0: 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 nArg, (u8)enc,
cc00: 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 28 0);. if( p && (
cc10: 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 26 20 53 p->funcFlags & S
cc20: 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 QLITE_FUNC_ENCMA
cc30: 53 4b 29 3d 3d 65 6e 63 20 26 26 20 70 2d 3e 6e SK)==enc && p->n
cc40: 41 72 67 3d 3d 6e 41 72 67 20 29 7b 0a 20 20 20 Arg==nArg ){.
cc50: 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 if( db->nVdbeAc
cc60: 74 69 76 65 20 29 7b 0a 20 20 20 20 20 20 73 71 tive ){. sq
cc70: 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 lite3ErrorWithMs
cc80: 67 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 g(db, SQLITE_BUS
cc90: 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 Y, . "una
cca0: 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f ble to delete/mo
ccb0: 64 69 66 79 20 75 73 65 72 2d 66 75 6e 63 74 69 dify user-functi
ccc0: 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 69 76 65 on due to active
ccd0: 20 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 statements");.
cce0: 20 20 20 20 20 61 73 73 65 72 74 28 20 21 64 62 assert( !db
ccf0: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
cd00: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
cd10: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 QLITE_BUSY;.
cd20: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c }else{. sql
cd30: 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 ite3ExpirePrepar
cd40: 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 edStatements(db)
cd50: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 ;. }. }.. p
cd60: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
cd70: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
cd80: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c tionName, nName,
cd90: 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 nArg, (u8)enc,
cda0: 31 29 3b 0a 20 20 61 73 73 65 72 74 28 70 20 7c 1);. assert(p |
cdb0: 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c | db->mallocFail
cdc0: 65 64 29 3b 0a 20 20 69 66 28 20 21 70 20 29 7b ed);. if( !p ){
cdd0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
cde0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 TE_NOMEM;. }..
cdf0: 20 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 65 72 20 /* If an older
ce00: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 version of the f
ce10: 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 63 unction with a c
ce20: 6f 6e 66 69 67 75 72 65 64 20 64 65 73 74 72 75 onfigured destru
ce30: 63 74 6f 72 20 69 73 0a 20 20 2a 2a 20 62 65 69 ctor is. ** bei
ce40: 6e 67 20 72 65 70 6c 61 63 65 64 20 69 6e 76 6f ng replaced invo
ce50: 6b 65 20 74 68 65 20 64 65 73 74 72 75 63 74 6f ke the destructo
ce60: 72 20 66 75 6e 63 74 69 6f 6e 20 68 65 72 65 2e r function here.
ce70: 20 2a 2f 0a 20 20 66 75 6e 63 74 69 6f 6e 44 65 */. functionDe
ce80: 73 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 0a 20 stroy(db, p);..
ce90: 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f 72 if( pDestructor
cea0: 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 63 ){. pDestruc
ceb0: 74 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 7d tor->nRef++;. }
cec0: 0a 20 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f . p->pDestructo
ced0: 72 20 3d 20 70 44 65 73 74 72 75 63 74 6f 72 3b r = pDestructor;
cee0: 0a 20 20 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 . p->funcFlags
cef0: 3d 20 28 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 = (p->funcFlags
cf00: 26 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e & SQLITE_FUNC_EN
cf10: 43 4d 41 53 4b 29 20 7c 20 65 78 74 72 61 46 6c CMASK) | extraFl
cf20: 61 67 73 3b 0a 20 20 74 65 73 74 63 61 73 65 28 ags;. testcase(
cf30: 20 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 26 20 p->funcFlags &
cf40: 53 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 SQLITE_DETERMINI
cf50: 53 54 49 43 20 29 3b 0a 20 20 70 2d 3e 78 46 75 STIC );. p->xFu
cf60: 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d nc = xFunc;. p-
cf70: 3e 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a >xStep = xStep;.
cf80: 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d p->xFinalize =
cf90: 20 78 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55 xFinal;. p->pU
cfa0: 73 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 serData = pUserD
cfb0: 61 74 61 3b 0a 20 20 70 2d 3e 6e 41 72 67 20 3d ata;. p->nArg =
cfc0: 20 28 75 31 36 29 6e 41 72 67 3b 0a 20 20 72 65 (u16)nArg;. re
cfd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
cfe0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 }../*.** Create
cff0: 6e 65 77 20 75 73 65 72 20 66 75 6e 63 74 69 6f new user functio
d000: 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ns..*/.int sqlit
d010: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 e3_create_functi
d020: 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 on(. sqlite3 *d
d030: 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 b,. const char
d040: 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 41 *zFunc,. int nA
d050: 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 rg,. int enc,.
d060: 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 void *p,. void
d070: 20 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 (*xFunc)(sqlite
d080: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 3_context*,int,s
d090: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 qlite3_value **)
d0a0: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 ,. void (*xStep
d0b0: 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 )(sqlite3_contex
d0c0: 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 t*,int,sqlite3_v
d0d0: 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 alue **),. void
d0e0: 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 (*xFinal)(sqlit
d0f0: 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a e3_context*).){.
d100: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
d110: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e _create_function
d120: 5f 76 32 28 64 62 2c 20 7a 46 75 6e 63 2c 20 6e _v2(db, zFunc, n
d130: 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 46 75 Arg, enc, p, xFu
d140: 6e 63 2c 20 78 53 74 65 70 2c 0a 20 20 20 20 20 nc, xStep,.
d150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 78 x
d170: 46 69 6e 61 6c 2c 20 30 29 3b 0a 7d 0a 0a 69 6e Final, 0);.}..in
d180: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
d190: 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 0a 20 20 _function_v2(.
d1a0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
d1b0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 onst char *zFunc
d1c0: 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 ,. int nArg,.
d1d0: 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 int enc,. void
d1e0: 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 *p,. void (*xFu
d1f0: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
d200: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
d210: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
d220: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 id (*xStep)(sqli
d230: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
d240: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
d250: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 *),. void (*xFi
d260: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e nal)(sqlite3_con
d270: 74 65 78 74 2a 29 2c 0a 20 20 76 6f 69 64 20 28 text*),. void (
d280: 2a 78 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 *xDestroy)(void
d290: 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d *).){. int rc =
d2a0: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
d2b0: 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 FuncDestructor
d2c0: 2a 70 41 72 67 20 3d 20 30 3b 0a 0a 23 69 66 64 *pArg = 0;..#ifd
d2d0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
d2e0: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
d2f0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
d300: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
d310: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d320: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d MISUSE_BKPT;. }
d330: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
d340: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
d350: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
d360: 78 44 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 xDestroy ){.
d370: 70 41 72 67 20 3d 20 28 46 75 6e 63 44 65 73 74 pArg = (FuncDest
d380: 72 75 63 74 6f 72 20 2a 29 73 71 6c 69 74 65 33 ructor *)sqlite3
d390: 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c DbMallocZero(db,
d3a0: 20 73 69 7a 65 6f 66 28 46 75 6e 63 44 65 73 74 sizeof(FuncDest
d3b0: 72 75 63 74 6f 72 29 29 3b 0a 20 20 20 20 69 66 ructor));. if
d3c0: 28 20 21 70 41 72 67 20 29 7b 0a 20 20 20 20 20 ( !pArg ){.
d3d0: 20 78 44 65 73 74 72 6f 79 28 70 29 3b 0a 20 20 xDestroy(p);.
d3e0: 20 20 20 20 67 6f 74 6f 20 6f 75 74 3b 0a 20 20 goto out;.
d3f0: 20 20 7d 0a 20 20 20 20 70 41 72 67 2d 3e 78 44 }. pArg->xD
d400: 65 73 74 72 6f 79 20 3d 20 78 44 65 73 74 72 6f estroy = xDestro
d410: 79 3b 0a 20 20 20 20 70 41 72 67 2d 3e 70 55 73 y;. pArg->pUs
d420: 65 72 44 61 74 61 20 3d 20 70 3b 0a 20 20 7d 0a erData = p;. }.
d430: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 rc = sqlite3Cr
d440: 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 eateFunc(db, zFu
d450: 6e 63 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 nc, nArg, enc, p
d460: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 , xFunc, xStep,
d470: 78 46 69 6e 61 6c 2c 20 70 41 72 67 29 3b 0a 20 xFinal, pArg);.
d480: 20 69 66 28 20 70 41 72 67 20 26 26 20 70 41 72 if( pArg && pAr
d490: 67 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 g->nRef==0 ){.
d4a0: 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 assert( rc!=SQ
d4b0: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 78 LITE_OK );. x
d4c0: 44 65 73 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 Destroy(p);.
d4d0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
d4e0: 2c 20 70 41 72 67 29 3b 0a 20 20 7d 0a 0a 20 6f , pArg);. }.. o
d4f0: 75 74 3a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 ut:. rc = sqlit
d500: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 e3ApiExit(db, rc
d510: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 );. sqlite3_mut
d520: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
d530: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ex);. return rc
d540: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ;.}..#ifndef SQL
d550: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69 ITE_OMIT_UTF16.i
d560: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 nt sqlite3_creat
d570: 65 5f 66 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20 e_function16(.
d580: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
d590: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63 onst void *zFunc
d5a0: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 tionName,. int
d5b0: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 54 65 78 nArg,. int eTex
d5c0: 74 52 65 70 2c 0a 20 20 76 6f 69 64 20 2a 70 2c tRep,. void *p,
d5d0: 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 . void (*xFunc)
d5e0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
d5f0: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
d600: 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 lue**),. void (
d610: 2a 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f *xStep)(sqlite3_
d620: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
d630: 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 ite3_value**),.
d640: 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 void (*xFinal)(
d650: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
d660: 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ).){. int rc;.
d670: 20 63 68 61 72 20 2a 7a 46 75 6e 63 38 3b 0a 0a char *zFunc8;..
d680: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
d690: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
d6a0: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
d6b0: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c etyCheckOk(db) |
d6c0: 7c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d | zFunctionName=
d6d0: 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =0 ) return SQLI
d6e0: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
d6f0: 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 #endif. sqlite3
d700: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
d710: 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 >mutex);. asser
d720: 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 t( !db->mallocFa
d730: 69 6c 65 64 20 29 3b 0a 20 20 7a 46 75 6e 63 38 iled );. zFunc8
d740: 20 3d 20 73 71 6c 69 74 65 33 55 74 66 31 36 74 = sqlite3Utf16t
d750: 6f 38 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e o8(db, zFunction
d760: 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 Name, -1, SQLITE
d770: 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 20 _UTF16NATIVE);.
d780: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 rc = sqlite3Cre
d790: 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e ateFunc(db, zFun
d7a0: 63 38 2c 20 6e 41 72 67 2c 20 65 54 65 78 74 52 c8, nArg, eTextR
d7b0: 65 70 2c 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 ep, p, xFunc, xS
d7c0: 74 65 70 2c 20 78 46 69 6e 61 6c 2c 30 29 3b 0a tep, xFinal,0);.
d7d0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
d7e0: 64 62 2c 20 7a 46 75 6e 63 38 29 3b 0a 20 20 72 db, zFunc8);. r
d7f0: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
d800: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
d810: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
d820: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
d830: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e return rc;.}.#en
d840: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6c dif.../*.** Decl
d850: 61 72 65 20 74 68 61 74 20 61 20 66 75 6e 63 74 are that a funct
d860: 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 6f 76 65 ion has been ove
d870: 72 6c 6f 61 64 65 64 20 62 79 20 61 20 76 69 72 rloaded by a vir
d880: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a tual table..**.*
d890: 2a 20 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f * If the functio
d8a0: 6e 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 n already exists
d8b0: 20 61 73 20 61 20 72 65 67 75 6c 61 72 20 67 6c as a regular gl
d8c0: 6f 62 61 6c 20 66 75 6e 63 74 69 6f 6e 2c 20 74 obal function, t
d8d0: 68 65 6e 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 hen.** this rout
d8e0: 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 ine is a no-op.
d8f0: 20 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e If the function
d900: 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c does not exist,
d910: 20 74 68 65 6e 20 63 72 65 61 74 65 0a 2a 2a 20 then create.**
d920: 61 20 6e 65 77 20 6f 6e 65 20 74 68 61 74 20 61 a new one that a
d930: 6c 77 61 79 73 20 74 68 72 6f 77 73 20 61 20 72 lways throws a r
d940: 75 6e 2d 74 69 6d 65 20 65 72 72 6f 72 2e 20 20 un-time error.
d950: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 76 69 72 74 .**.** When virt
d960: 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 74 65 6e ual tables inten
d970: 64 20 74 6f 20 70 72 6f 76 69 64 65 20 61 6e 20 d to provide an
d980: 6f 76 65 72 6c 6f 61 64 65 64 20 66 75 6e 63 74 overloaded funct
d990: 69 6f 6e 2c 20 74 68 65 79 0a 2a 2a 20 73 68 6f ion, they.** sho
d9a0: 75 6c 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f uld call this ro
d9b0: 75 74 69 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 utine to make su
d9c0: 72 65 20 74 68 65 20 67 6c 6f 62 61 6c 20 66 75 re the global fu
d9d0: 6e 63 74 69 6f 6e 20 65 78 69 73 74 73 2e 0a 2a nction exists..*
d9e0: 2a 20 41 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 * A global funct
d9f0: 69 6f 6e 20 6d 75 73 74 20 65 78 69 73 74 20 69 ion must exist i
da00: 6e 20 6f 72 64 65 72 20 66 6f 72 20 6e 61 6d 65 n order for name
da10: 20 72 65 73 6f 6c 75 74 69 6f 6e 20 74 6f 20 77 resolution to w
da20: 6f 72 6b 0a 2a 2a 20 70 72 6f 70 65 72 6c 79 2e ork.** properly.
da30: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
da40: 6f 76 65 72 6c 6f 61 64 5f 66 75 6e 63 74 69 6f overload_functio
da50: 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 n(. sqlite3 *db
da60: 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ,. const char *
da70: 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 zName,. int nAr
da80: 67 0a 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 g.){. int nName
da90: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e = sqlite3Strlen
daa0: 33 30 28 7a 4e 61 6d 65 29 3b 0a 20 20 69 6e 74 30(zName);. int
dab0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
dac0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
dad0: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
dae0: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
daf0: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
db00: 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 || zName==0 ||
db10: 6e 41 72 67 3c 2d 32 20 29 7b 0a 20 20 20 20 72 nArg<-2 ){. r
db20: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
db30: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 USE_BKPT;. }.#e
db40: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
db50: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
db60: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 6c utex);. if( sql
db70: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e ite3FindFunction
db80: 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d (db, zName, nNam
db90: 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f e, nArg, SQLITE_
dba0: 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 UTF8, 0)==0 ){.
dbb0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 rc = sqlite3C
dbc0: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 4e reateFunc(db, zN
dbd0: 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 ame, nArg, SQLIT
dbe0: 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 E_UTF8,.
dbf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dc00: 20 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 76 0, sqlite3Inv
dc10: 61 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 2c alidFunction, 0,
dc20: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 63 0, 0);. }. rc
dc30: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 = sqlite3ApiExi
dc40: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c t(db, rc);. sql
dc50: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
dc60: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
dc70: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 eturn rc;.}..#if
dc80: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
dc90: 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 _TRACE./*.** Reg
dca0: 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75 ister a trace fu
dcb0: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 nction. The pAr
dcc0: 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 g from the previ
dcd0: 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 ously registered
dce0: 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 trace.** is ret
dcf0: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 urned. .**.** A
dd00: 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 NULL trace func
dd10: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 tion means that
dd20: 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 no tracing is ex
dd30: 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e ecutes. A non-N
dd40: 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 ULL.** trace is
dd50: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 a pointer to a f
dd60: 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 unction that is
dd70: 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 invoked at the s
dd80: 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 tart of each.**
dd90: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a SQL statement..*
dda0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
ddb0: 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 trace(sqlite3 *d
ddc0: 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 b, void (*xTrace
ddd0: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
dde0: 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 ar*), void *pArg
ddf0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b ){. void *pOld;
de00: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
de10: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
de20: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
de30: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
de40: 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
de50: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
de60: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a ;. return 0;.
de70: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c }.#endif. sql
de80: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
de90: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 (db->mutex);. p
dea0: 4f 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 Old = db->pTrace
deb0: 41 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 Arg;. db->xTrac
dec0: 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64 62 e = xTrace;. db
ded0: 2d 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70 41 ->pTraceArg = pA
dee0: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
def0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
df00: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 tex);. return p
df10: 4f 6c 64 3b 0a 7d 0a 2f 2a 0a 2a 2a 20 52 65 67 Old;.}./*.** Reg
df20: 69 73 74 65 72 20 61 20 70 72 6f 66 69 6c 65 20 ister a profile
df30: 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 function. The p
df40: 41 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 Arg from the pre
df50: 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 viously register
df60: 65 64 20 0a 2a 2a 20 70 72 6f 66 69 6c 65 20 66 ed .** profile f
df70: 75 6e 63 74 69 6f 6e 20 69 73 20 72 65 74 75 72 unction is retur
df80: 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e ned. .**.** A N
df90: 55 4c 4c 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 ULL profile func
dfa0: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 tion means that
dfb0: 6e 6f 20 70 72 6f 66 69 6c 69 6e 67 20 69 73 20 no profiling is
dfc0: 65 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e executes. A non
dfd0: 2d 4e 55 4c 4c 0a 2a 2a 20 70 72 6f 66 69 6c 65 -NULL.** profile
dfe0: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f is a pointer to
dff0: 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 a function that
e000: 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 is invoked at t
e010: 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 he conclusion of
e020: 0a 2a 2a 20 65 61 63 68 20 53 51 4c 20 73 74 61 .** each SQL sta
e030: 74 65 6d 65 6e 74 20 74 68 61 74 20 69 73 20 72 tement that is r
e040: 75 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c un..*/.void *sql
e050: 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 0a 20 20 ite3_profile(.
e060: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 76 sqlite3 *db,. v
e070: 6f 69 64 20 28 2a 78 50 72 6f 66 69 6c 65 29 28 oid (*xProfile)(
e080: 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 void*,const char
e090: 2a 2c 73 71 6c 69 74 65 5f 75 69 6e 74 36 34 29 *,sqlite_uint64)
e0a0: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 ,. void *pArg.)
e0b0: 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a {. void *pOld;.
e0c0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
e0d0: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
e0e0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
e0f0: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
e100: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
e110: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
e120: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
e130: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 }.#endif. sqli
e140: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
e150: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f db->mutex);. pO
e160: 6c 64 20 3d 20 64 62 2d 3e 70 50 72 6f 66 69 6c ld = db->pProfil
e170: 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 50 72 6f eArg;. db->xPro
e180: 66 69 6c 65 20 3d 20 78 50 72 6f 66 69 6c 65 3b file = xProfile;
e190: 0a 20 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 . db->pProfileA
e1a0: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
e1b0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
e1c0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
e1d0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 eturn pOld;.}.#e
e1e0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
e1f0: 4d 49 54 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a MIT_TRACE */../*
e200: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 66 .** Register a f
e210: 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e unction to be in
e220: 76 6f 6b 65 64 20 77 68 65 6e 20 61 20 74 72 61 voked when a tra
e230: 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 nsaction commits
e240: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 76 6f ..** If the invo
e250: 6b 65 64 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 ked function ret
e260: 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 urns non-zero, t
e270: 68 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20 62 hen the commit b
e280: 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c ecomes a.** roll
e290: 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 back..*/.void *s
e2a0: 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f qlite3_commit_ho
e2b0: 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ok(. sqlite3 *d
e2c0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
e2d0: 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f /* Attach the ho
e2e0: 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 ok to this datab
e2f0: 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 ase */. int (*x
e300: 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 Callback)(void*)
e310: 2c 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 , /* Function t
e320: 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61 63 68 o invoke on each
e330: 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 commit */. voi
e340: 64 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 d *pArg
e350: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
e360: 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 nt to the functi
e370: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 on */.){. void
e380: 2a 70 4f 6c 64 3b 0a 0a 23 69 66 64 65 66 20 53 *pOld;..#ifdef S
e390: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
e3a0: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
e3b0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
e3c0: 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 Ok(db) ){. (v
e3d0: 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 oid)SQLITE_MISUS
e3e0: 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 E_BKPT;. retu
e3f0: 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 rn 0;. }.#endif
e400: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
e410: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
e420: 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e );. pOld = db->
e430: 70 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 pCommitArg;. db
e440: 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 ->xCommitCallbac
e450: 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 k = xCallback;.
e460: 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 db->pCommitArg
e470: 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 = pArg;. sqlite
e480: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
e490: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
e4a0: 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 0a 2a rn pOld;.}../*.*
e4b0: 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 61 6c * Register a cal
e4c0: 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f lback to be invo
e4d0: 6b 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 ked each time a
e4e0: 72 6f 77 20 69 73 20 75 70 64 61 74 65 64 2c 0a row is updated,.
e4f0: 2a 2a 20 69 6e 73 65 72 74 65 64 20 6f 72 20 64 ** inserted or d
e500: 65 6c 65 74 65 64 20 75 73 69 6e 67 20 74 68 69 eleted using thi
e510: 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 s database conne
e520: 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a ction..*/.void *
e530: 73 71 6c 69 74 65 33 5f 75 70 64 61 74 65 5f 68 sqlite3_update_h
e540: 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a ook(. sqlite3 *
e550: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 db,
e560: 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 /* Attach the h
e570: 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 ook to this data
e580: 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 base */. void (
e590: 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 *xCallback)(void
e5a0: 2a 2c 69 6e 74 2c 63 68 61 72 20 63 6f 6e 73 74 *,int,char const
e5b0: 20 2a 2c 63 68 61 72 20 63 6f 6e 73 74 20 2a 2c *,char const *,
e5c0: 73 71 6c 69 74 65 5f 69 6e 74 36 34 29 2c 0a 20 sqlite_int64),.
e5d0: 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 void *pArg
e5e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
e5f0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 gument to the fu
e600: 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 nction */.){. v
e610: 6f 69 64 20 2a 70 52 65 74 3b 0a 0a 23 69 66 64 oid *pRet;..#ifd
e620: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
e630: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
e640: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
e650: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
e660: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
e670: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
e680: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 return 0;. }.#e
e690: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
e6a0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
e6b0: 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 utex);. pRet =
e6c0: 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b 0a db->pUpdateArg;.
e6d0: 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61 6c db->xUpdateCal
e6e0: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 lback = xCallbac
e6f0: 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 65 k;. db->pUpdate
e700: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 Arg = pArg;. sq
e710: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
e720: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
e730: 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a return pRet;.}..
e740: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
e750: 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 callback to be
e760: 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d invoked each tim
e770: 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 e a transaction
e780: 69 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 is rolled.** bac
e790: 6b 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 k by this databa
e7a0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a se connection..*
e7b0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
e7c0: 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 rollback_hook(.
e7d0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
e7e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
e7f0: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
e800: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a this database *
e810: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c /. void (*xCall
e820: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a back)(void*), /*
e830: 20 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 Callback functi
e840: 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 on */. void *pA
e850: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rg
e860: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f /* Argument to
e870: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f the function */
e880: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 .){. void *pRet
e890: 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ;..#ifdef SQLITE
e8a0: 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
e8b0: 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
e8c0: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
e8d0: 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 ) ){. (void)S
e8e0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
e8f0: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b T;. return 0;
e900: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 . }.#endif. sq
e910: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
e920: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
e930: 70 52 65 74 20 3d 20 64 62 2d 3e 70 52 6f 6c 6c pRet = db->pRoll
e940: 62 61 63 6b 41 72 67 3b 0a 20 20 64 62 2d 3e 78 backArg;. db->x
e950: 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b RollbackCallback
e960: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 = xCallback;.
e970: 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 db->pRollbackArg
e980: 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 = pArg;. sqlit
e990: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
e9a0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
e9b0: 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 23 69 66 urn pRet;.}..#if
e9c0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
e9d0: 5f 57 41 4c 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 _WAL./*.** The s
e9e0: 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
e9f0: 29 20 63 61 6c 6c 62 61 63 6b 20 72 65 67 69 73 ) callback regis
ea00: 74 65 72 65 64 20 62 79 20 73 71 6c 69 74 65 33 tered by sqlite3
ea10: 5f 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f _wal_autocheckpo
ea20: 69 6e 74 28 29 2e 0a 2a 2a 20 49 6e 76 6f 6b 65 int()..** Invoke
ea30: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 sqlite3_wal_che
ea40: 63 6b 70 6f 69 6e 74 20 69 66 20 74 68 65 20 6e ckpoint if the n
ea50: 75 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 umber of frames
ea60: 69 6e 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 0a in the log file.
ea70: 2a 2a 20 69 73 20 67 72 65 61 74 65 72 20 74 68 ** is greater th
ea80: 61 6e 20 73 71 6c 69 74 65 33 2e 70 57 61 6c 41 an sqlite3.pWalA
ea90: 72 67 20 63 61 73 74 20 74 6f 20 61 6e 20 69 6e rg cast to an in
eaa0: 74 65 67 65 72 20 28 74 68 65 20 76 61 6c 75 65 teger (the value
eab0: 20 63 6f 6e 66 69 67 75 72 65 64 20 62 79 0a 2a configured by.*
eac0: 2a 20 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 * wal_autocheckp
ead0: 6f 69 6e 74 28 29 29 2e 0a 2a 2f 20 0a 69 6e 74 oint())..*/ .int
eae0: 20 73 71 6c 69 74 65 33 57 61 6c 44 65 66 61 75 sqlite3WalDefau
eaf0: 6c 74 48 6f 6f 6b 28 0a 20 20 76 6f 69 64 20 2a ltHook(. void *
eb00: 70 43 6c 69 65 6e 74 44 61 74 61 2c 20 20 20 20 pClientData,
eb10: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 2a 2f 0a /* Argument */.
eb20: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
eb30: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e /* Conn
eb40: 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 ection */. cons
eb50: 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 20 20 20 t char *zDb,
eb60: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 2a /* Database *
eb70: 2f 0a 20 20 69 6e 74 20 6e 46 72 61 6d 65 20 20 /. int nFrame
eb80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
eb90: 7a 65 20 6f 66 20 57 41 4c 20 2a 2f 0a 29 7b 0a ze of WAL */.){.
eba0: 20 20 69 66 28 20 6e 46 72 61 6d 65 3e 3d 53 51 if( nFrame>=SQ
ebb0: 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 LITE_PTR_TO_INT(
ebc0: 70 43 6c 69 65 6e 74 44 61 74 61 29 20 29 7b 0a pClientData) ){.
ebd0: 20 20 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e sqlite3Begin
ebe0: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a BenignMalloc();.
ebf0: 20 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f sqlite3_wal_
ec00: 63 68 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 7a checkpoint(db, z
ec10: 44 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 Db);. sqlite3
ec20: 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 EndBenignMalloc(
ec30: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
ec40: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e SQLITE_OK;.}.#en
ec50: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
ec60: 49 54 5f 57 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a IT_WAL */../*.**
ec70: 20 43 6f 6e 66 69 67 75 72 65 20 61 6e 20 73 71 Configure an sq
ec80: 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 lite3_wal_hook()
ec90: 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 61 75 74 callback to aut
eca0: 6f 6d 61 74 69 63 61 6c 6c 79 20 63 68 65 63 6b omatically check
ecb0: 70 6f 69 6e 74 0a 2a 2a 20 61 20 64 61 74 61 62 point.** a datab
ecc0: 61 73 65 20 61 66 74 65 72 20 63 6f 6d 6d 69 74 ase after commit
ecd0: 74 69 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 ting a transacti
ece0: 6f 6e 20 69 66 20 74 68 65 72 65 20 61 72 65 20 on if there are
ecf0: 6e 46 72 61 6d 65 20 6f 72 0a 2a 2a 20 6d 6f 72 nFrame or.** mor
ed00: 65 20 66 72 61 6d 65 73 20 69 6e 20 74 68 65 20 e frames in the
ed10: 6c 6f 67 20 66 69 6c 65 2e 20 50 61 73 73 69 6e log file. Passin
ed20: 67 20 7a 65 72 6f 20 6f 72 20 61 20 6e 65 67 61 g zero or a nega
ed30: 74 69 76 65 20 76 61 6c 75 65 20 61 73 20 74 68 tive value as th
ed40: 65 0a 2a 2a 20 6e 46 72 61 6d 65 20 70 61 72 61 e.** nFrame para
ed50: 6d 65 74 65 72 20 64 69 73 61 62 6c 65 73 20 61 meter disables a
ed60: 75 74 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f utomatic checkpo
ed70: 69 6e 74 73 20 65 6e 74 69 72 65 6c 79 2e 0a 2a ints entirely..*
ed80: 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 62 61 63 *.** The callbac
ed90: 6b 20 72 65 67 69 73 74 65 72 65 64 20 62 79 20 k registered by
eda0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 this function re
edb0: 70 6c 61 63 65 73 20 61 6e 79 20 65 78 69 73 74 places any exist
edc0: 69 6e 67 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 ing callback.**
edd0: 72 65 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 registered using
ede0: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f sqlite3_wal_hoo
edf0: 6b 28 29 2e 20 4c 69 6b 65 77 69 73 65 2c 20 72 k(). Likewise, r
ee00: 65 67 69 73 74 65 72 69 6e 67 20 61 20 63 61 6c egistering a cal
ee10: 6c 62 61 63 6b 0a 2a 2a 20 75 73 69 6e 67 20 73 lback.** using s
ee20: 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
ee30: 29 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 ) disables the a
ee40: 75 74 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f utomatic checkpo
ee50: 69 6e 74 20 6d 65 63 68 61 6e 69 73 6d 0a 2a 2a int mechanism.**
ee60: 20 63 6f 6e 66 69 67 75 72 65 64 20 62 79 20 74 configured by t
ee70: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f his function..*/
ee80: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 77 61 6c .int sqlite3_wal
ee90: 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 28 _autocheckpoint(
eea0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
eeb0: 20 6e 46 72 61 6d 65 29 7b 0a 23 69 66 64 65 66 nFrame){.#ifdef
eec0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
eed0: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
eee0: 54 45 52 28 64 62 29 3b 0a 20 20 55 4e 55 53 45 TER(db);. UNUSE
eef0: 44 5f 50 41 52 41 4d 45 54 45 52 28 6e 46 72 61 D_PARAMETER(nFra
ef00: 6d 65 29 3b 0a 23 65 6c 73 65 0a 23 69 66 64 65 me);.#else.#ifde
ef10: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
ef20: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
ef30: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
ef40: 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 eckOk(db) ) retu
ef50: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
ef60: 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 _BKPT;.#endif.
ef70: 69 66 28 20 6e 46 72 61 6d 65 3e 30 20 29 7b 0a if( nFrame>0 ){.
ef80: 20 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f sqlite3_wal_
ef90: 68 6f 6f 6b 28 64 62 2c 20 73 71 6c 69 74 65 33 hook(db, sqlite3
efa0: 57 61 6c 44 65 66 61 75 6c 74 48 6f 6f 6b 2c 20 WalDefaultHook,
efb0: 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 SQLITE_INT_TO_PT
efc0: 52 28 6e 46 72 61 6d 65 29 29 3b 0a 20 20 7d 65 R(nFrame));. }e
efd0: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 lse{. sqlite3
efe0: 5f 77 61 6c 5f 68 6f 6f 6b 28 64 62 2c 20 30 2c _wal_hook(db, 0,
eff0: 20 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0);. }.#endif.
f000: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
f010: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 OK;.}../*.** Reg
f020: 69 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 6b ister a callback
f030: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 65 to be invoked e
f040: 61 63 68 20 74 69 6d 65 20 61 20 74 72 61 6e 73 ach time a trans
f050: 61 63 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 action is writte
f060: 6e 0a 2a 2a 20 69 6e 74 6f 20 74 68 65 20 77 72 n.** into the wr
f070: 69 74 65 2d 61 68 65 61 64 2d 6c 6f 67 20 62 79 ite-ahead-log by
f080: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 this database c
f090: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f onnection..*/.vo
f0a0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 61 6c 5f id *sqlite3_wal_
f0b0: 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 hook(. sqlite3
f0c0: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 *db,
f0d0: 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 /* Attac
f0e0: 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 h the hook to th
f0f0: 69 73 20 64 62 20 68 61 6e 64 6c 65 20 2a 2f 0a is db handle */.
f100: 20 20 69 6e 74 28 2a 78 43 61 6c 6c 62 61 63 6b int(*xCallback
f110: 29 28 76 6f 69 64 20 2a 2c 20 73 71 6c 69 74 65 )(void *, sqlite
f120: 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 3*, const char*,
f130: 20 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a 70 int),. void *p
f140: 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 Arg
f150: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
f160: 74 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 t argument passe
f170: 64 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 d to xCallback()
f180: 20 2a 2f 0a 29 7b 0a 23 69 66 6e 64 65 66 20 53 */.){.#ifndef S
f190: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
f1a0: 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a 23 69 66 void *pRet;.#if
f1b0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
f1c0: 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
f1d0: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
f1e0: 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
f1f0: 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
f200: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
f210: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 return 0;. }.#
f220: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
f230: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
f240: 6d 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d mutex);. pRet =
f250: 20 64 62 2d 3e 70 57 61 6c 41 72 67 3b 0a 20 20 db->pWalArg;.
f260: 64 62 2d 3e 78 57 61 6c 43 61 6c 6c 62 61 63 6b db->xWalCallback
f270: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 = xCallback;.
f280: 64 62 2d 3e 70 57 61 6c 41 72 67 20 3d 20 70 41 db->pWalArg = pA
f290: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
f2a0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
f2b0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 tex);. return p
f2c0: 52 65 74 3b 0a 23 65 6c 73 65 0a 20 20 72 65 74 Ret;.#else. ret
f2d0: 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a urn 0;.#endif.}.
f2e0: 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 70 6f 69 6e ./*.** Checkpoin
f2f0: 74 20 64 61 74 61 62 61 73 65 20 7a 44 62 2e 0a t database zDb..
f300: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 77 */.int sqlite3_w
f310: 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 al_checkpoint_v2
f320: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
f330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f340: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
f350: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 handle */. cons
f360: 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 20 20 20 t char *zDb,
f370: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
f380: 61 6d 65 20 6f 66 20 61 74 74 61 63 68 65 64 20 ame of attached
f390: 64 61 74 61 62 61 73 65 20 28 6f 72 20 4e 55 4c database (or NUL
f3a0: 4c 29 20 2a 2f 0a 20 20 69 6e 74 20 65 4d 6f 64 L) */. int eMod
f3b0: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
f3c0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 /* SQLIT
f3d0: 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 2a 20 76 E_CHECKPOINT_* v
f3e0: 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 alue */. int *p
f3f0: 6e 4c 6f 67 2c 20 20 20 20 20 20 20 20 20 20 20 nLog,
f400: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
f410: 3a 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 6c 6f : Size of WAL lo
f420: 67 20 69 6e 20 66 72 61 6d 65 73 20 2a 2f 0a 20 g in frames */.
f430: 20 69 6e 74 20 2a 70 6e 43 6b 70 74 20 20 20 20 int *pnCkpt
f440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f450: 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e /* OUT: Total n
f460: 75 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 umber of frames
f470: 63 68 65 63 6b 70 6f 69 6e 74 65 64 20 2a 2f 0a checkpointed */.
f480: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
f490: 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 72 65 74 75 _OMIT_WAL. retu
f4a0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 rn SQLITE_OK;.#e
f4b0: 6c 73 65 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 lse. int rc;
f4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f4d0: 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
f4e0: 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 44 code */. int iD
f4f0: 62 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 b = SQLITE_MAX_A
f500: 54 54 41 43 48 45 44 3b 20 20 2f 2a 20 73 71 6c TTACHED; /* sql
f510: 69 74 65 33 2e 61 44 62 5b 5d 20 69 6e 64 65 78 ite3.aDb[] index
f520: 20 6f 66 20 64 62 20 74 6f 20 63 68 65 63 6b 70 of db to checkp
f530: 6f 69 6e 74 20 2a 2f 0a 0a 23 69 66 64 65 66 20 oint */..#ifdef
f540: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
f550: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
f560: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
f570: 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e kOk(db) ) return
f580: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
f590: 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f KPT;.#endif.. /
f5a0: 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 * Initialize the
f5b0: 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65 output variable
f5c0: 73 20 74 6f 20 2d 31 20 69 6e 20 63 61 73 65 20 s to -1 in case
f5d0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e an error occurs.
f5e0: 20 2a 2f 0a 20 20 69 66 28 20 70 6e 4c 6f 67 20 */. if( pnLog
f5f0: 29 20 2a 70 6e 4c 6f 67 20 3d 20 2d 31 3b 0a 20 ) *pnLog = -1;.
f600: 20 69 66 28 20 70 6e 43 6b 70 74 20 29 20 2a 70 if( pnCkpt ) *p
f610: 6e 43 6b 70 74 20 3d 20 2d 31 3b 0a 0a 20 20 61 nCkpt = -1;.. a
f620: 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 ssert( SQLITE_CH
f630: 45 43 4b 50 4f 49 4e 54 5f 46 55 4c 4c 3e 53 51 ECKPOINT_FULL>SQ
f640: 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
f650: 50 41 53 53 49 56 45 20 29 3b 0a 20 20 61 73 73 PASSIVE );. ass
f660: 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 ert( SQLITE_CHEC
f670: 4b 50 4f 49 4e 54 5f 46 55 4c 4c 3c 53 51 4c 49 KPOINT_FULL<SQLI
f680: 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 52 45 TE_CHECKPOINT_RE
f690: 53 54 41 52 54 20 29 3b 0a 20 20 61 73 73 65 72 START );. asser
f6a0: 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 t( SQLITE_CHECKP
f6b0: 4f 49 4e 54 5f 50 41 53 53 49 56 45 2b 32 3d 3d OINT_PASSIVE+2==
f6c0: 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e SQLITE_CHECKPOIN
f6d0: 54 5f 52 45 53 54 41 52 54 20 29 3b 0a 20 20 69 T_RESTART );. i
f6e0: 66 28 20 65 4d 6f 64 65 3c 53 51 4c 49 54 45 5f f( eMode<SQLITE_
f6f0: 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 CHECKPOINT_PASSI
f700: 56 45 20 7c 7c 20 65 4d 6f 64 65 3e 53 51 4c 49 VE || eMode>SQLI
f710: 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 52 45 TE_CHECKPOINT_RE
f720: 53 54 41 52 54 20 29 7b 0a 20 20 20 20 72 65 74 START ){. ret
f730: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
f740: 45 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 E;. }.. sqlite
f750: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
f760: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
f770: 7a 44 62 20 26 26 20 7a 44 62 5b 30 5d 20 29 7b zDb && zDb[0] ){
f780: 0a 20 20 20 20 69 44 62 20 3d 20 73 71 6c 69 74 . iDb = sqlit
f790: 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c e3FindDbName(db,
f7a0: 20 7a 44 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 zDb);. }. if(
f7b0: 20 69 44 62 3c 30 20 29 7b 0a 20 20 20 20 72 63 iDb<0 ){. rc
f7c0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
f7d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f . sqlite3Erro
f7e0: 72 57 69 74 68 4d 73 67 28 64 62 2c 20 53 51 4c rWithMsg(db, SQL
f7f0: 49 54 45 5f 45 52 52 4f 52 2c 20 22 75 6e 6b 6e ITE_ERROR, "unkn
f800: 6f 77 6e 20 64 61 74 61 62 61 73 65 3a 20 25 73 own database: %s
f810: 22 2c 20 7a 44 62 29 3b 0a 20 20 7d 65 6c 73 65 ", zDb);. }else
f820: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
f830: 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2c e3Checkpoint(db,
f840: 20 69 44 62 2c 20 65 4d 6f 64 65 2c 20 70 6e 4c iDb, eMode, pnL
f850: 6f 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 20 og, pnCkpt);.
f860: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
f870: 2c 20 72 63 29 3b 0a 20 20 7d 0a 20 20 72 63 20 , rc);. }. rc
f880: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
f890: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
f8a0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
f8b0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
f8c0: 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a turn rc;.#endif.
f8d0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 70 }.../*.** Checkp
f8e0: 6f 69 6e 74 20 64 61 74 61 62 61 73 65 20 7a 44 oint database zD
f8f0: 62 2e 20 49 66 20 7a 44 62 20 69 73 20 4e 55 4c b. If zDb is NUL
f900: 4c 2c 20 6f 72 20 69 66 20 74 68 65 20 62 75 66 L, or if the buf
f910: 66 65 72 20 7a 44 62 20 70 6f 69 6e 74 73 0a 2a fer zDb points.*
f920: 2a 20 74 6f 20 63 6f 6e 74 61 69 6e 73 20 61 20 * to contains a
f930: 7a 65 72 6f 2d 6c 65 6e 67 74 68 20 73 74 72 69 zero-length stri
f940: 6e 67 2c 20 61 6c 6c 20 61 74 74 61 63 68 65 64 ng, all attached
f950: 20 64 61 74 61 62 61 73 65 73 20 61 72 65 20 0a databases are .
f960: 2a 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 2e ** checkpointed.
f970: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
f980: 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 28 73 wal_checkpoint(s
f990: 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 qlite3 *db, cons
f9a0: 74 20 63 68 61 72 20 2a 7a 44 62 29 7b 0a 20 20 t char *zDb){.
f9b0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 77 return sqlite3_w
f9c0: 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 al_checkpoint_v2
f9d0: 28 64 62 2c 20 7a 44 62 2c 20 53 51 4c 49 54 45 (db, zDb, SQLITE
f9e0: 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 _CHECKPOINT_PASS
f9f0: 49 56 45 2c 20 30 2c 20 30 29 3b 0a 7d 0a 0a 23 IVE, 0, 0);.}..#
fa00: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
fa10: 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a 20 52 75 6e IT_WAL./*.** Run
fa20: 20 61 20 63 68 65 63 6b 70 6f 69 6e 74 20 6f 6e a checkpoint on
fa30: 20 64 61 74 61 62 61 73 65 20 69 44 62 2e 20 54 database iDb. T
fa40: 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 his is a no-op i
fa50: 66 20 64 61 74 61 62 61 73 65 20 69 44 62 20 69 f database iDb i
fa60: 73 0a 2a 2a 20 6e 6f 74 20 63 75 72 72 65 6e 74 s.** not current
fa70: 6c 79 20 6f 70 65 6e 20 69 6e 20 57 41 4c 20 6d ly open in WAL m
fa80: 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 ode..**.** If a
fa90: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f transaction is o
faa0: 70 65 6e 20 6f 6e 20 74 68 65 20 64 61 74 61 62 pen on the datab
fab0: 61 73 65 20 62 65 69 6e 67 20 63 68 65 63 6b 70 ase being checkp
fac0: 6f 69 6e 74 65 64 2c 20 74 68 69 73 20 0a 2a 2a ointed, this .**
fad0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
fae0: 73 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 s SQLITE_LOCKED
faf0: 61 6e 64 20 61 20 63 68 65 63 6b 70 6f 69 6e 74 and a checkpoint
fb00: 20 69 73 20 6e 6f 74 20 61 74 74 65 6d 70 74 65 is not attempte
fb10: 64 2e 20 49 66 20 0a 2a 2a 20 61 6e 20 65 72 72 d. If .** an err
fb20: 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 or occurs while
fb30: 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 68 65 63 running the chec
fb40: 6b 70 6f 69 6e 74 2c 20 61 6e 20 53 51 4c 69 74 kpoint, an SQLit
fb50: 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 e error code is
fb60: 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 28 69 2e .** returned (i.
fb70: 65 2e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 e. SQLITE_IOERR)
fb80: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 53 51 4c . Otherwise, SQL
fb90: 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 ITE_OK..**.** Th
fba0: 65 20 6d 75 74 65 78 20 6f 6e 20 64 61 74 61 62 e mutex on datab
fbb0: 61 73 65 20 68 61 6e 64 6c 65 20 64 62 20 73 68 ase handle db sh
fbc0: 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 62 79 20 ould be held by
fbd0: 74 68 65 20 63 61 6c 6c 65 72 2e 20 54 68 65 20 the caller. The
fbe0: 6d 75 74 65 78 0a 2a 2a 20 61 73 73 6f 63 69 61 mutex.** associa
fbf0: 74 65 64 20 77 69 74 68 20 74 68 65 20 73 70 65 ted with the spe
fc00: 63 69 66 69 63 20 62 2d 74 72 65 65 20 62 65 69 cific b-tree bei
fc10: 6e 67 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 20 ng checkpointed
fc20: 69 73 20 74 61 6b 65 6e 20 62 79 0a 2a 2a 20 74 is taken by.** t
fc30: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 68 69 his function whi
fc40: 6c 65 20 74 68 65 20 63 68 65 63 6b 70 6f 69 6e le the checkpoin
fc50: 74 20 69 73 20 72 75 6e 6e 69 6e 67 2e 0a 2a 2a t is running..**
fc60: 0a 2a 2a 20 49 66 20 69 44 62 20 69 73 20 70 61 .** If iDb is pa
fc70: 73 73 65 64 20 53 51 4c 49 54 45 5f 4d 41 58 5f ssed SQLITE_MAX_
fc80: 41 54 54 41 43 48 45 44 2c 20 74 68 65 6e 20 61 ATTACHED, then a
fc90: 6c 6c 20 61 74 74 61 63 68 65 64 20 64 61 74 61 ll attached data
fca0: 62 61 73 65 73 20 61 72 65 0a 2a 2a 20 63 68 65 bases are.** che
fcb0: 63 6b 70 6f 69 6e 74 65 64 2e 20 49 66 20 61 6e ckpointed. If an
fcc0: 20 65 72 72 6f 72 20 69 73 20 65 6e 63 6f 75 6e error is encoun
fcd0: 74 65 72 65 64 20 69 74 20 69 73 20 72 65 74 75 tered it is retu
fce0: 72 6e 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 rned immediately
fcf0: 20 2d 0a 2a 2a 20 6e 6f 20 61 74 74 65 6d 70 74 -.** no attempt
fd00: 20 69 73 20 6d 61 64 65 20 74 6f 20 63 68 65 63 is made to chec
fd10: 6b 70 6f 69 6e 74 20 61 6e 79 20 72 65 6d 61 69 kpoint any remai
fd20: 6e 69 6e 67 20 64 61 74 61 62 61 73 65 73 2e 0a ning databases..
fd30: 2a 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 **.** Parameter
fd40: 65 4d 6f 64 65 20 69 73 20 6f 6e 65 20 6f 66 20 eMode is one of
fd50: 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e SQLITE_CHECKPOIN
fd60: 54 5f 50 41 53 53 49 56 45 2c 20 46 55 4c 4c 20 T_PASSIVE, FULL
fd70: 6f 72 20 52 45 53 54 41 52 54 2e 0a 2a 2f 0a 69 or RESTART..*/.i
fd80: 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 6b 70 nt sqlite3Checkp
fd90: 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 oint(sqlite3 *db
fda0: 2c 20 69 6e 74 20 69 44 62 2c 20 69 6e 74 20 65 , int iDb, int e
fdb0: 4d 6f 64 65 2c 20 69 6e 74 20 2a 70 6e 4c 6f 67 Mode, int *pnLog
fdc0: 2c 20 69 6e 74 20 2a 70 6e 43 6b 70 74 29 7b 0a , int *pnCkpt){.
fdd0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
fde0: 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 E_OK;
fdf0: 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
fe00: 20 2a 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 */. int i;
fe10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
fe20: 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f /* Used to
fe30: 20 69 74 65 72 61 74 65 20 74 68 72 6f 75 67 68 iterate through
fe40: 20 61 74 74 61 63 68 65 64 20 64 62 73 20 2a 2f attached dbs */
fe50: 0a 20 20 69 6e 74 20 62 42 75 73 79 20 3d 20 30 . int bBusy = 0
fe60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
fe70: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 53 51 /* True if SQ
fe80: 4c 49 54 45 5f 42 55 53 59 20 68 61 73 20 62 65 LITE_BUSY has be
fe90: 65 6e 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 2a en encountered *
fea0: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c /.. assert( sql
feb0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
fec0: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
fed0: 61 73 73 65 72 74 28 20 21 70 6e 4c 6f 67 20 7c assert( !pnLog |
fee0: 7c 20 2a 70 6e 4c 6f 67 3d 3d 2d 31 20 29 3b 0a | *pnLog==-1 );.
fef0: 20 20 61 73 73 65 72 74 28 20 21 70 6e 43 6b 70 assert( !pnCkp
ff00: 74 20 7c 7c 20 2a 70 6e 43 6b 70 74 3d 3d 2d 31 t || *pnCkpt==-1
ff10: 20 29 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20 );.. for(i=0;
ff20: 69 3c 64 62 2d 3e 6e 44 62 20 26 26 20 72 63 3d i<db->nDb && rc=
ff30: 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 2b 2b 29 =SQLITE_OK; i++)
ff40: 7b 0a 20 20 20 20 69 66 28 20 69 3d 3d 69 44 62 {. if( i==iDb
ff50: 20 7c 7c 20 69 44 62 3d 3d 53 51 4c 49 54 45 5f || iDb==SQLITE_
ff60: 4d 41 58 5f 41 54 54 41 43 48 45 44 20 29 7b 0a MAX_ATTACHED ){.
ff70: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
ff80: 65 33 42 74 72 65 65 43 68 65 63 6b 70 6f 69 6e e3BtreeCheckpoin
ff90: 74 28 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 t(db->aDb[i].pBt
ffa0: 2c 20 65 4d 6f 64 65 2c 20 70 6e 4c 6f 67 2c 20 , eMode, pnLog,
ffb0: 70 6e 43 6b 70 74 29 3b 0a 20 20 20 20 20 20 70 pnCkpt);. p
ffc0: 6e 4c 6f 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 nLog = 0;.
ffd0: 70 6e 43 6b 70 74 20 3d 20 30 3b 0a 20 20 20 20 pnCkpt = 0;.
ffe0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
fff0: 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 _BUSY ){.
10000 20 62 42 75 73 79 20 3d 20 31 3b 0a 20 20 20 20 bBusy = 1;.
10010 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
10020 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 OK;. }.
10030 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 }. }.. return
10040 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 (rc==SQLITE_OK &
10050 26 20 62 42 75 73 79 29 20 3f 20 53 51 4c 49 54 & bBusy) ? SQLIT
10060 45 5f 42 55 53 59 20 3a 20 72 63 3b 0a 7d 0a 23 E_BUSY : rc;.}.#
10070 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
10080 4f 4d 49 54 5f 57 41 4c 20 2a 2f 0a 0a 2f 2a 0a OMIT_WAL */../*.
10090 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
100a0 20 72 65 74 75 72 6e 73 20 74 72 75 65 20 69 66 returns true if
100b0 20 6d 61 69 6e 2d 6d 65 6d 6f 72 79 20 73 68 6f main-memory sho
100c0 75 6c 64 20 62 65 20 75 73 65 64 20 69 6e 73 74 uld be used inst
100d0 65 61 64 20 6f 66 0a 2a 2a 20 61 20 74 65 6d 70 ead of.** a temp
100e0 6f 72 61 72 79 20 66 69 6c 65 20 66 6f 72 20 74 orary file for t
100f0 72 61 6e 73 69 65 6e 74 20 70 61 67 65 72 20 66 ransient pager f
10100 69 6c 65 73 20 61 6e 64 20 73 74 61 74 65 6d 65 iles and stateme
10110 6e 74 20 6a 6f 75 72 6e 61 6c 73 2e 0a 2a 2a 20 nt journals..**
10120 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e The value return
10130 65 64 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 ed depends on th
10140 65 20 76 61 6c 75 65 20 6f 66 20 64 62 2d 3e 74 e value of db->t
10150 65 6d 70 5f 73 74 6f 72 65 20 28 72 75 6e 74 69 emp_store (runti
10160 6d 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 29 me.** parameter)
10170 20 61 6e 64 20 74 68 65 20 63 6f 6d 70 69 6c 65 and the compile
10180 20 74 69 6d 65 20 76 61 6c 75 65 20 6f 66 20 53 time value of S
10190 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
101a0 2e 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 . The.** followi
101b0 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72 69 62 ng table describ
101c0 65 73 20 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 es the relations
101d0 68 69 70 20 62 65 74 77 65 65 6e 20 74 68 65 73 hip between thes
101e0 65 20 74 77 6f 20 76 61 6c 75 65 73 0a 2a 2a 20 e two values.**
101f0 61 6e 64 20 74 68 69 73 20 66 75 6e 63 74 69 6f and this functio
10200 6e 73 20 72 65 74 75 72 6e 20 76 61 6c 75 65 2e ns return value.
10210 0a 2a 2a 0a 2a 2a 20 20 20 53 51 4c 49 54 45 5f .**.** SQLITE_
10220 54 45 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 TEMP_STORE d
10230 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 b->temp_store
10240 20 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 Location of te
10250 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 mporary database
10260 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .** ----------
10270 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d ------- ----
10280 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d ---------- -
10290 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
102a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a -------------.**
102b0 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 0
102c0 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 any
102d0 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 file
102e0 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 30 29 (return 0)
102f0 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 .** 1
10300 20 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 1
10310 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 f
10320 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 6e ile (return
10330 20 30 29 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 0).** 1
10340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32 2
10350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10360 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 74 memory (ret
10370 75 72 6e 20 31 29 0a 2a 2a 20 20 20 31 20 20 20 urn 1).** 1
10380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10390 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 0
103a0 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 file (
103b0 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 32 return 0).** 2
103c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
103d0 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20 1
103e0 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 file
103f0 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 (return 0).**
10400 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 2
10410 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 2
10420 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 memor
10430 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a y (return 1).
10440 2a 2a 20 20 20 32 20 20 20 20 20 20 20 20 20 20 ** 2
10450 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20 0
10460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 me
10470 6d 6f 72 79 20 20 20 20 28 72 65 74 75 72 6e 20 mory (return
10480 31 29 0a 2a 2a 20 20 20 33 20 20 20 20 20 20 20 1).** 3
10490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e an
104a0 79 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y
104b0 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 74 75 memory (retu
104c0 72 6e 20 31 29 0a 2a 2f 0a 69 6e 74 20 73 71 6c rn 1).*/.int sql
104d0 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 ite3TempInMemory
104e0 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 20 2a (const sqlite3 *
104f0 64 62 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f db){.#if SQLITE_
10500 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 31 0a 20 20 TEMP_STORE==1.
10510 72 65 74 75 72 6e 20 28 20 64 62 2d 3e 74 65 6d return ( db->tem
10520 70 5f 73 74 6f 72 65 3d 3d 32 20 29 3b 0a 23 65 p_store==2 );.#e
10530 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
10540 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 32 0a 20 20 TEMP_STORE==2.
10550 72 65 74 75 72 6e 20 28 20 64 62 2d 3e 74 65 6d return ( db->tem
10560 70 5f 73 74 6f 72 65 21 3d 31 20 29 3b 0a 23 65 p_store!=1 );.#e
10570 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
10580 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a 20 20 TEMP_STORE==3.
10590 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 return 1;.#endif
105a0 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 .#if SQLITE_TEMP
105b0 5f 53 54 4f 52 45 3c 31 20 7c 7c 20 53 51 4c 49 _STORE<1 || SQLI
105c0 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3e 33 0a TE_TEMP_STORE>3.
105d0 20 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 return 0;.#end
105e0 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 if.}../*.** Retu
105f0 72 6e 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 rn UTF-8 encoded
10600 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 English languag
10610 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 e explanation of
10620 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
10630 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f .** error..*/.co
10640 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
10650 33 5f 65 72 72 6d 73 67 28 73 71 6c 69 74 65 33 3_errmsg(sqlite3
10660 20 2a 64 62 29 7b 0a 20 20 63 6f 6e 73 74 20 63 *db){. const c
10670 68 61 72 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 har *z;. if( !d
10680 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 b ){. return
10690 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 sqlite3ErrStr(SQ
106a0 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d LITE_NOMEM);. }
106b0 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
106c0 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 afetyCheckSickOr
106d0 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 Ok(db) ){. re
106e0 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 turn sqlite3ErrS
106f0 74 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 tr(SQLITE_MISUSE
10700 5f 42 4b 50 54 29 3b 0a 20 20 7d 0a 20 20 73 71 _BKPT);. }. sq
10710 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
10720 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
10730 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 if( db->mallocFa
10740 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d 20 iled ){. z =
10750 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 sqlite3ErrStr(SQ
10760 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d LITE_NOMEM);. }
10770 65 6c 73 65 7b 0a 20 20 20 20 74 65 73 74 63 61 else{. testca
10780 73 65 28 20 64 62 2d 3e 70 45 72 72 3d 3d 30 20 se( db->pErr==0
10790 29 3b 0a 20 20 20 20 7a 20 3d 20 28 63 68 61 72 );. z = (char
107a0 2a 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f *)sqlite3_value_
107b0 74 65 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 0a text(db->pErr);.
107c0 20 20 20 20 61 73 73 65 72 74 28 20 21 64 62 2d assert( !db-
107d0 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b >mallocFailed );
107e0 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b . if( z==0 ){
107f0 0a 20 20 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 . z = sqlit
10800 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 e3ErrStr(db->err
10810 43 6f 64 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d Code);. }. }
10820 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
10830 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
10840 29 3b 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d );. return z;.}
10850 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
10860 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a _OMIT_UTF16./*.*
10870 2a 20 52 65 74 75 72 6e 20 55 54 46 2d 31 36 20 * Return UTF-16
10880 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 encoded English
10890 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 language explana
108a0 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 tion of the most
108b0 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 recent.** error
108c0 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 ..*/.const void
108d0 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 *sqlite3_errmsg1
108e0 36 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 6(sqlite3 *db){.
108f0 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 static const u
10900 31 36 20 6f 75 74 4f 66 4d 65 6d 5b 5d 20 3d 20 16 outOfMem[] =
10910 7b 0a 20 20 20 20 27 6f 27 2c 20 27 75 27 2c 20 {. 'o', 'u',
10920 27 74 27 2c 20 27 20 27 2c 20 27 6f 27 2c 20 27 't', ' ', 'o', '
10930 66 27 2c 20 27 20 27 2c 20 27 6d 27 2c 20 27 65 f', ' ', 'm', 'e
10940 27 2c 20 27 6d 27 2c 20 27 6f 27 2c 20 27 72 27 ', 'm', 'o', 'r'
10950 2c 20 27 79 27 2c 20 30 0a 20 20 7d 3b 0a 20 20 , 'y', 0. };.
10960 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 31 36 static const u16
10970 20 6d 69 73 75 73 65 5b 5d 20 3d 20 7b 0a 20 20 misuse[] = {.
10980 20 20 27 6c 27 2c 20 27 69 27 2c 20 27 62 27 2c 'l', 'i', 'b',
10990 20 27 72 27 2c 20 27 61 27 2c 20 27 72 27 2c 20 'r', 'a', 'r',
109a0 27 79 27 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 'y', ' ', . '
109b0 72 27 2c 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 r', 'o', 'u', 't
109c0 27 2c 20 27 69 27 2c 20 27 6e 27 2c 20 27 65 27 ', 'i', 'n', 'e'
109d0 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 63 27 2c , ' ', . 'c',
109e0 20 27 61 27 2c 20 27 6c 27 2c 20 27 6c 27 2c 20 'a', 'l', 'l',
109f0 27 65 27 2c 20 27 64 27 2c 20 27 20 27 2c 20 0a 'e', 'd', ' ', .
10a00 20 20 20 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 'o', 'u', 't
10a10 27 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 6f 27 ', ' ', . 'o'
10a20 2c 20 27 66 27 2c 20 27 20 27 2c 20 0a 20 20 20 , 'f', ' ', .
10a30 20 27 73 27 2c 20 27 65 27 2c 20 27 71 27 2c 20 's', 'e', 'q',
10a40 27 75 27 2c 20 27 65 27 2c 20 27 6e 27 2c 20 27 'u', 'e', 'n', '
10a50 63 27 2c 20 27 65 27 2c 20 30 0a 20 20 7d 3b 0a c', 'e', 0. };.
10a60 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a . const void *z
10a70 3b 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 ;. if( !db ){.
10a80 20 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 return (void
10a90 2a 29 6f 75 74 4f 66 4d 65 6d 3b 0a 20 20 7d 0a *)outOfMem;. }.
10aa0 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
10ab0 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f fetyCheckSickOrO
10ac0 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
10ad0 75 72 6e 20 28 76 6f 69 64 20 2a 29 6d 69 73 75 urn (void *)misu
10ae0 73 65 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 se;. }. sqlite
10af0 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
10b00 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
10b10 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
10b20 20 29 7b 0a 20 20 20 20 7a 20 3d 20 28 76 6f 69 ){. z = (voi
10b30 64 20 2a 29 6f 75 74 4f 66 4d 65 6d 3b 0a 20 20 d *)outOfMem;.
10b40 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 20 3d 20 73 }else{. z = s
10b50 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
10b60 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 t16(db->pErr);.
10b70 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 if( z==0 ){.
10b80 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
10b90 72 57 69 74 68 4d 73 67 28 64 62 2c 20 64 62 2d rWithMsg(db, db-
10ba0 3e 65 72 72 43 6f 64 65 2c 20 73 71 6c 69 74 65 >errCode, sqlite
10bb0 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 3ErrStr(db->errC
10bc0 6f 64 65 29 29 3b 0a 20 20 20 20 20 20 7a 20 3d ode));. z =
10bd0 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
10be0 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b ext16(db->pErr);
10bf0 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 41 20 . }. /* A
10c00 6d 61 6c 6c 6f 63 28 29 20 6d 61 79 20 68 61 76 malloc() may hav
10c10 65 20 66 61 69 6c 65 64 20 77 69 74 68 69 6e 20 e failed within
10c20 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 the call to sqli
10c30 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 te3_value_text16
10c40 28 29 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 2e (). ** above.
10c50 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
10c60 63 61 73 65 2c 20 74 68 65 6e 20 74 68 65 20 64 case, then the d
10c70 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
10c80 66 6c 61 67 20 6e 65 65 64 73 20 74 6f 0a 20 20 flag needs to.
10c90 20 20 2a 2a 20 62 65 20 63 6c 65 61 72 65 64 20 ** be cleared
10ca0 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
10cb0 2e 20 44 6f 20 74 68 69 73 20 64 69 72 65 63 74 . Do this direct
10cc0 6c 79 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 76 ly, instead of v
10cd0 69 61 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 ia. ** sqlite
10ce0 33 41 70 69 45 78 69 74 28 29 2c 20 74 6f 20 61 3ApiExit(), to a
10cf0 76 6f 69 64 20 73 65 74 74 69 6e 67 20 74 68 65 void setting the
10d00 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
10d10 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 0a error message..
10d20 20 20 20 20 2a 2f 0a 20 20 20 20 64 62 2d 3e 6d */. db->m
10d30 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30 3b allocFailed = 0;
10d40 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
10d50 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
10d60 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
10d70 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 z;.}.#endif /* S
10d80 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
10d90 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 */../*.** Retur
10da0 6e 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e n the most recen
10db0 74 20 65 72 72 6f 72 20 63 6f 64 65 20 67 65 6e t error code gen
10dc0 65 72 61 74 65 64 20 62 79 20 61 6e 20 53 51 4c erated by an SQL
10dd0 69 74 65 20 72 6f 75 74 69 6e 65 2e 20 49 66 20 ite routine. If
10de0 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 61 73 73 65 NULL is.** passe
10df0 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 d to this functi
10e00 6f 6e 2c 20 77 65 20 61 73 73 75 6d 65 20 61 20 on, we assume a
10e10 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 malloc() failed
10e20 64 75 72 69 6e 67 20 73 71 6c 69 74 65 33 5f 6f during sqlite3_o
10e30 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 pen()..*/.int sq
10e40 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 73 71 lite3_errcode(sq
10e50 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 lite3 *db){. if
10e60 28 20 64 62 20 26 26 20 21 73 71 6c 69 74 65 33 ( db && !sqlite3
10e70 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f SafetyCheckSickO
10e80 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 rOk(db) ){. r
10e90 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
10ea0 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 USE_BKPT;. }.
10eb0 69 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e 6d if( !db || db->m
10ec0 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
10ed0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
10ee0 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 65 _NOMEM;. }. re
10ef0 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 turn db->errCode
10f00 20 26 20 64 62 2d 3e 65 72 72 4d 61 73 6b 3b 0a & db->errMask;.
10f10 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 }.int sqlite3_ex
10f20 74 65 6e 64 65 64 5f 65 72 72 63 6f 64 65 28 73 tended_errcode(s
10f30 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 qlite3 *db){. i
10f40 66 28 20 64 62 20 26 26 20 21 73 71 6c 69 74 65 f( db && !sqlite
10f50 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 3SafetyCheckSick
10f60 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 OrOk(db) ){.
10f70 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
10f80 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 SUSE_BKPT;. }.
10f90 20 69 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e if( !db || db->
10fa0 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
10fb0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
10fc0 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 E_NOMEM;. }. r
10fd0 65 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 eturn db->errCod
10fe0 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 e;.}../*.** Retu
10ff0 72 6e 20 61 20 73 74 72 69 6e 67 20 74 68 61 74 rn a string that
11000 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6b describes the k
11010 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 ind of error spe
11020 63 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a cified in the.**
11030 20 61 72 67 75 6d 65 6e 74 2e 20 20 46 6f 72 20 argument. For
11040 6e 6f 77 2c 20 74 68 69 73 20 73 69 6d 70 6c 79 now, this simply
11050 20 63 61 6c 6c 73 20 74 68 65 20 69 6e 74 65 72 calls the inter
11060 6e 61 6c 20 73 71 6c 69 74 65 33 45 72 72 53 74 nal sqlite3ErrSt
11070 72 28 29 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e r().** function.
11080 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
11090 73 71 6c 69 74 65 33 5f 65 72 72 73 74 72 28 69 sqlite3_errstr(i
110a0 6e 74 20 72 63 29 7b 0a 20 20 72 65 74 75 72 6e nt rc){. return
110b0 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 72 sqlite3ErrStr(r
110c0 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 c);.}../*.** Inv
110d0 61 6c 69 64 61 74 65 20 61 6c 6c 20 63 61 63 68 alidate all cach
110e0 65 64 20 4b 65 79 49 6e 66 6f 20 6f 62 6a 65 63 ed KeyInfo objec
110f0 74 73 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 ts for database
11100 63 6f 6e 6e 65 63 74 69 6f 6e 20 22 64 62 22 0a connection "db".
11110 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 */.static void i
11120 6e 76 61 6c 69 64 61 74 65 43 61 63 68 65 64 4b nvalidateCachedK
11130 65 79 49 6e 66 6f 28 73 71 6c 69 74 65 33 20 2a eyInfo(sqlite3 *
11140 64 62 29 7b 0a 20 20 44 62 20 2a 70 44 62 3b 20 db){. Db *pDb;
11150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11160 20 20 20 2f 2a 20 41 20 73 69 6e 67 6c 65 20 64 /* A single d
11170 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 atabase */. int
11180 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 iDb;
11190 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
111a0 64 61 74 61 62 61 73 65 20 69 6e 64 65 78 20 6e database index n
111b0 75 6d 62 65 72 20 2a 2f 0a 20 20 48 61 73 68 45 umber */. HashE
111c0 6c 65 6d 20 2a 6b 3b 20 20 20 20 20 20 20 20 20 lem *k;
111d0 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 6c 6f /* For lo
111e0 6f 70 69 6e 67 20 6f 76 65 72 20 74 61 62 6c 65 oping over table
111f0 73 20 69 6e 20 70 44 62 20 2a 2f 0a 20 20 54 61 s in pDb */. Ta
11200 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 ble *pTab;
11210 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 74 /* A t
11220 61 62 6c 65 20 69 6e 20 74 68 65 20 64 61 74 61 able in the data
11230 62 61 73 65 20 2a 2f 0a 20 20 49 6e 64 65 78 20 base */. Index
11240 2a 70 49 64 78 3b 20 20 20 20 20 20 20 20 20 20 *pIdx;
11250 20 20 20 20 20 20 2f 2a 20 45 61 63 68 20 69 6e /* Each in
11260 64 65 78 20 2a 2f 0a 0a 20 20 66 6f 72 28 69 44 dex */.. for(iD
11270 62 3d 30 2c 20 70 44 62 3d 64 62 2d 3e 61 44 62 b=0, pDb=db->aDb
11280 3b 20 69 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 ; iDb<db->nDb; i
11290 44 62 2b 2b 2c 20 70 44 62 2b 2b 29 7b 0a 20 20 Db++, pDb++){.
112a0 20 20 69 66 28 20 70 44 62 2d 3e 70 42 74 3d 3d if( pDb->pBt==
112b0 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 0 ) continue;.
112c0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
112d0 74 65 72 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 ter(pDb->pBt);.
112e0 20 20 20 66 6f 72 28 6b 3d 73 71 6c 69 74 65 48 for(k=sqliteH
112f0 61 73 68 46 69 72 73 74 28 26 70 44 62 2d 3e 70 ashFirst(&pDb->p
11300 53 63 68 65 6d 61 2d 3e 74 62 6c 48 61 73 68 29 Schema->tblHash)
11310 3b 20 20 6b 3b 20 6b 3d 73 71 6c 69 74 65 48 61 ; k; k=sqliteHa
11320 73 68 4e 65 78 74 28 6b 29 29 7b 0a 20 20 20 20 shNext(k)){.
11330 20 20 70 54 61 62 20 3d 20 28 54 61 62 6c 65 2a pTab = (Table*
11340 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 )sqliteHashData(
11350 6b 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 49 k);. for(pI
11360 64 78 3d 70 54 61 62 2d 3e 70 49 6e 64 65 78 3b dx=pTab->pIndex;
11370 20 70 49 64 78 3b 20 70 49 64 78 3d 70 49 64 78 pIdx; pIdx=pIdx
11380 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 ->pNext){.
11390 20 20 69 66 28 20 70 49 64 78 2d 3e 70 4b 65 79 if( pIdx->pKey
113a0 49 6e 66 6f 20 26 26 20 70 49 64 78 2d 3e 70 4b Info && pIdx->pK
113b0 65 79 49 6e 66 6f 2d 3e 64 62 3d 3d 64 62 20 29 eyInfo->db==db )
113c0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 {. sqli
113d0 74 65 33 4b 65 79 49 6e 66 6f 55 6e 72 65 66 28 te3KeyInfoUnref(
113e0 70 49 64 78 2d 3e 70 4b 65 79 49 6e 66 6f 29 3b pIdx->pKeyInfo);
113f0 0a 20 20 20 20 20 20 20 20 20 20 70 49 64 78 2d . pIdx-
11400 3e 70 4b 65 79 49 6e 66 6f 20 3d 20 30 3b 0a 20 >pKeyInfo = 0;.
11410 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
11420 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
11430 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 44 62 e3BtreeLeave(pDb
11440 2d 3e 70 42 74 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f ->pBt);. }.}../
11450 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 *.** Create a ne
11460 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 w collating func
11470 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 73 tion for databas
11480 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 6d e "db". The nam
11490 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 6e e is zName.** an
114a0 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 d the encoding i
114b0 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 s enc..*/.static
114c0 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c 61 int createColla
114d0 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a tion(. sqlite3*
114e0 20 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 db,. const cha
114f0 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 75 38 20 r *zName, . u8
11500 65 6e 63 2c 0a 20 20 76 6f 69 64 2a 20 70 43 74 enc,. void* pCt
11510 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 x,. int(*xCompa
11520 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f re)(void*,int,co
11530 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f nst void*,int,co
11540 6e 73 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f nst void*),. vo
11550 69 64 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 id(*xDel)(void*)
11560 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 .){. CollSeq *p
11570 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 65 6e 63 32 Coll;. int enc2
11580 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 73 ;. . assert( s
11590 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
115a0 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a d(db->mutex) );.
115b0 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f . /* If SQLITE_
115c0 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69 UTF16 is specifi
115d0 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 ed as the encodi
115e0 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f ng type, transfo
115f0 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 rm this. ** to
11600 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 one of SQLITE_UT
11610 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f F16LE or SQLITE_
11620 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 UTF16BE using th
11630 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 e. ** SQLITE_UT
11640 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e F16NATIVE macro.
11650 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 SQLITE_UTF16 is
11660 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e not used intern
11670 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e 63 ally.. */. enc
11680 32 20 3d 20 65 6e 63 3b 0a 20 20 74 65 73 74 63 2 = enc;. testc
11690 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 ase( enc2==SQLIT
116a0 45 5f 55 54 46 31 36 20 29 3b 0a 20 20 74 65 73 E_UTF16 );. tes
116b0 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c tcase( enc2==SQL
116c0 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 ITE_UTF16_ALIGNE
116d0 44 20 29 3b 0a 20 20 69 66 28 20 65 6e 63 32 3d D );. if( enc2=
116e0 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 7c 7c =SQLITE_UTF16 ||
116f0 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 54 enc2==SQLITE_UT
11700 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 7b 0a 20 F16_ALIGNED ){.
11710 20 20 20 65 6e 63 32 20 3d 20 53 51 4c 49 54 45 enc2 = SQLITE
11720 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 _UTF16NATIVE;.
11730 7d 0a 20 20 69 66 28 20 65 6e 63 32 3c 53 51 4c }. if( enc2<SQL
11740 49 54 45 5f 55 54 46 38 20 7c 7c 20 65 6e 63 32 ITE_UTF8 || enc2
11750 3e 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 >SQLITE_UTF16BE
11760 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
11770 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
11780 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 ;. }.. /* Chec
11790 6b 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 69 k if this call i
117a0 73 20 72 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 s removing or re
117b0 70 6c 61 63 69 6e 67 20 61 6e 20 65 78 69 73 74 placing an exist
117c0 69 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 ing collation .
117d0 20 2a 2a 20 73 65 71 75 65 6e 63 65 2e 20 49 66 ** sequence. If
117e0 20 73 6f 2c 20 61 6e 64 20 74 68 65 72 65 20 61 so, and there a
117f0 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c 20 72 re active VMs, r
11800 65 74 75 72 6e 20 62 75 73 79 2e 20 49 66 20 74 eturn busy. If t
11810 68 65 72 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f here. ** are no
11820 20 61 63 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 active VMs, inv
11830 61 6c 69 64 61 74 65 20 61 6e 79 20 70 72 65 2d alidate any pre-
11840 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 6d 65 compiled stateme
11850 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f 6c nts.. */. pCol
11860 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
11870 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 ollSeq(db, (u8)e
11880 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 30 29 3b 0a nc2, zName, 0);.
11890 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 26 20 70 if( pColl && p
118a0 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a 20 20 Coll->xCmp ){.
118b0 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 if( db->nVdbeA
118c0 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 20 73 ctive ){. s
118d0 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d qlite3ErrorWithM
118e0 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 sg(db, SQLITE_BU
118f0 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e SY, . "un
11900 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d able to delete/m
11910 6f 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 odify collation
11920 73 65 71 75 65 6e 63 65 20 64 75 65 20 74 6f 20 sequence due to
11930 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 active statement
11940 73 22 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 s");. retur
11950 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
11960 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
11970 45 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 ExpirePreparedSt
11980 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 atements(db);.
11990 20 20 69 6e 76 61 6c 69 64 61 74 65 43 61 63 68 invalidateCach
119a0 65 64 4b 65 79 49 6e 66 6f 28 64 62 29 3b 0a 0a edKeyInfo(db);..
119b0 20 20 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 74 /* If collat
119c0 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 70 43 6f ion sequence pCo
119d0 6c 6c 20 77 61 73 20 63 72 65 61 74 65 64 20 64 ll was created d
119e0 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 61 6c irectly by a cal
119f0 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 l to. ** sqli
11a00 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 te3_create_colla
11a10 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 65 tion, and not ge
11a20 6e 65 72 61 74 65 64 20 62 79 20 73 79 6e 74 68 nerated by synth
11a30 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 2a CollSeq(),. *
11a40 2a 20 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 65 * then any copie
11a50 73 20 6d 61 64 65 20 62 79 20 73 79 6e 74 68 43 s made by synthC
11a60 6f 6c 6c 53 65 71 28 29 20 6e 65 65 64 20 74 6f ollSeq() need to
11a70 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 2e be invalidated.
11a80 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 6f . ** Also, co
11a90 6c 6c 61 74 69 6f 6e 20 64 65 73 74 72 75 63 74 llation destruct
11aa0 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 65 or - CollSeq.xDe
11ab0 6c 28 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 6d l() - function m
11ac0 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 74 ay need. ** t
11ad0 6f 20 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 20 o be called..
11ae0 20 2a 2f 20 0a 20 20 20 20 69 66 28 20 28 70 43 */ . if( (pC
11af0 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c 49 oll->enc & ~SQLI
11b00 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 TE_UTF16_ALIGNED
11b10 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 20 )==enc2 ){.
11b20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 20 CollSeq *aColl
11b30 3d 20 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e = sqlite3HashFin
11b40 64 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c d(&db->aCollSeq,
11b50 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 zName);. i
11b60 6e 74 20 6a 3b 0a 20 20 20 20 20 20 66 6f 72 28 nt j;. for(
11b70 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a j=0; j<3; j++){.
11b80 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 CollSeq
11b90 2a 70 20 3d 20 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a *p = &aColl[j];.
11ba0 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 if( p->e
11bb0 6e 63 3d 3d 70 43 6f 6c 6c 2d 3e 65 6e 63 20 29 nc==pColl->enc )
11bc0 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 {. if(
11bd0 70 2d 3e 78 44 65 6c 20 29 7b 0a 20 20 20 20 20 p->xDel ){.
11be0 20 20 20 20 20 20 20 70 2d 3e 78 44 65 6c 28 70 p->xDel(p
11bf0 2d 3e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 20 ->pUser);.
11c00 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
11c10 70 2d 3e 78 43 6d 70 20 3d 20 30 3b 0a 20 20 20 p->xCmp = 0;.
11c20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
11c30 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c }. }.. pCol
11c40 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
11c50 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 ollSeq(db, (u8)e
11c60 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 31 29 3b 0a nc2, zName, 1);.
11c70 20 20 69 66 28 20 70 43 6f 6c 6c 3d 3d 30 20 29 if( pColl==0 )
11c80 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
11c90 4f 4d 45 4d 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 OMEM;. pColl->x
11ca0 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a Cmp = xCompare;.
11cb0 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d pColl->pUser =
11cc0 20 70 43 74 78 3b 0a 20 20 70 43 6f 6c 6c 2d 3e pCtx;. pColl->
11cd0 78 44 65 6c 20 3d 20 78 44 65 6c 3b 0a 20 20 70 xDel = xDel;. p
11ce0 43 6f 6c 6c 2d 3e 65 6e 63 20 3d 20 28 75 38 29 Coll->enc = (u8)
11cf0 28 65 6e 63 32 20 7c 20 28 65 6e 63 20 26 20 53 (enc2 | (enc & S
11d00 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 QLITE_UTF16_ALIG
11d10 4e 45 44 29 29 3b 0a 20 20 73 71 6c 69 74 65 33 NED));. sqlite3
11d20 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
11d30 5f 4f 4b 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 _OK);. return S
11d40 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a QLITE_OK;.}.../*
11d50 0a 2a 2a 20 54 68 69 73 20 61 72 72 61 79 20 64 .** This array d
11d60 65 66 69 6e 65 73 20 68 61 72 64 20 75 70 70 65 efines hard uppe
11d70 72 20 62 6f 75 6e 64 73 20 6f 6e 20 6c 69 6d 69 r bounds on limi
11d80 74 20 76 61 6c 75 65 73 2e 20 20 54 68 65 0a 2a t values. The.*
11d90 2a 20 69 6e 69 74 69 61 6c 69 7a 65 72 20 6d 75 * initializer mu
11da0 73 74 20 62 65 20 6b 65 70 74 20 69 6e 20 73 79 st be kept in sy
11db0 6e 63 20 77 69 74 68 20 74 68 65 20 53 51 4c 49 nc with the SQLI
11dc0 54 45 5f 4c 49 4d 49 54 5f 2a 0a 2a 2a 20 23 64 TE_LIMIT_*.** #d
11dd0 65 66 69 6e 65 73 20 69 6e 20 73 71 6c 69 74 65 efines in sqlite
11de0 33 2e 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 3.h..*/.static c
11df0 6f 6e 73 74 20 69 6e 74 20 61 48 61 72 64 4c 69 onst int aHardLi
11e00 6d 69 74 5b 5d 20 3d 20 7b 0a 20 20 53 51 4c 49 mit[] = {. SQLI
11e10 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 2c 0a 20 TE_MAX_LENGTH,.
11e20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f SQLITE_MAX_SQL_
11e30 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 LENGTH,. SQLITE
11e40 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 2c 0a 20 20 53 _MAX_COLUMN,. S
11e50 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 QLITE_MAX_EXPR_D
11e60 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d EPTH,. SQLITE_M
11e70 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 AX_COMPOUND_SELE
11e80 43 54 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 CT,. SQLITE_MAX
11e90 5f 56 44 42 45 5f 4f 50 2c 0a 20 20 53 51 4c 49 _VDBE_OP,. SQLI
11ea0 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f TE_MAX_FUNCTION_
11eb0 41 52 47 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 ARG,. SQLITE_MA
11ec0 58 5f 41 54 54 41 43 48 45 44 2c 0a 20 20 53 51 X_ATTACHED,. SQ
11ed0 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 LITE_MAX_LIKE_PA
11ee0 54 54 45 52 4e 5f 4c 45 4e 47 54 48 2c 0a 20 20 TTERN_LENGTH,.
11ef0 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
11f00 42 4c 45 5f 4e 55 4d 42 45 52 2c 20 20 20 20 20 BLE_NUMBER,
11f10 20 2f 2a 20 49 4d 50 3a 20 52 2d 33 38 30 39 31 /* IMP: R-38091
11f20 2d 33 32 33 35 32 20 2a 2f 0a 20 20 53 51 4c 49 -32352 */. SQLI
11f30 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 TE_MAX_TRIGGER_D
11f40 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d EPTH,. SQLITE_M
11f50 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 AX_WORKER_THREAD
11f60 53 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b S,.};../*.** Mak
11f70 65 20 73 75 72 65 20 74 68 65 20 68 61 72 64 20 e sure the hard
11f80 6c 69 6d 69 74 73 20 61 72 65 20 73 65 74 20 74 limits are set t
11f90 6f 20 72 65 61 73 6f 6e 61 62 6c 65 20 76 61 6c o reasonable val
11fa0 75 65 73 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 ues.*/.#if SQLIT
11fb0 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 3c 31 30 30 E_MAX_LENGTH<100
11fc0 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
11fd0 4d 41 58 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 MAX_LENGTH must
11fe0 62 65 20 61 74 20 6c 65 61 73 74 20 31 30 30 0a be at least 100.
11ff0 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
12000 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 E_MAX_SQL_LENGTH
12010 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 51 4c <100.# error SQL
12020 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
12030 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 TH must be at le
12040 61 73 74 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 ast 100.#endif.#
12050 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 if SQLITE_MAX_SQ
12060 4c 5f 4c 45 4e 47 54 48 3e 53 51 4c 49 54 45 5f L_LENGTH>SQLITE_
12070 4d 41 58 5f 4c 45 4e 47 54 48 0a 23 20 65 72 72 MAX_LENGTH.# err
12080 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 or SQLITE_MAX_SQ
12090 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 6e 6f L_LENGTH must no
120a0 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 61 t be greater tha
120b0 6e 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e n SQLITE_MAX_LEN
120c0 47 54 48 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 GTH.#endif.#if S
120d0 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 QLITE_MAX_COMPOU
120e0 4e 44 5f 53 45 4c 45 43 54 3c 32 0a 23 20 65 72 ND_SELECT<2.# er
120f0 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ror SQLITE_MAX_C
12100 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 20 6d OMPOUND_SELECT m
12110 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 ust be at least
12120 32 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 2.#endif.#if SQL
12130 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 3c ITE_MAX_VDBE_OP<
12140 34 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 40.# error SQLIT
12150 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 20 6d 75 E_MAX_VDBE_OP mu
12160 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 34 st be at least 4
12170 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 0.#endif.#if SQL
12180 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e ITE_MAX_FUNCTION
12190 5f 41 52 47 3c 30 20 7c 7c 20 53 51 4c 49 54 45 _ARG<0 || SQLITE
121a0 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 _MAX_FUNCTION_AR
121b0 47 3e 31 30 30 30 0a 23 20 65 72 72 6f 72 20 53 G>1000.# error S
121c0 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 QLITE_MAX_FUNCTI
121d0 4f 4e 5f 41 52 47 20 6d 75 73 74 20 62 65 20 62 ON_ARG must be b
121e0 65 74 77 65 65 6e 20 30 20 61 6e 64 20 31 30 30 etween 0 and 100
121f0 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 0.#endif.#if SQL
12200 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
12210 3c 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 <0 || SQLITE_MAX
12220 5f 41 54 54 41 43 48 45 44 3e 31 32 35 0a 23 20 _ATTACHED>125.#
12230 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
12240 5f 41 54 54 41 43 48 45 44 20 6d 75 73 74 20 62 _ATTACHED must b
12250 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 e between 0 and
12260 31 32 35 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 125.#endif.#if S
12270 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 QLITE_MAX_LIKE_P
12280 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 3c 31 0a ATTERN_LENGTH<1.
12290 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d # error SQLITE_M
122a0 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f AX_LIKE_PATTERN_
122b0 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 61 LENGTH must be a
122c0 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 66 t least 1.#endif
122d0 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
122e0 43 4f 4c 55 4d 4e 3e 33 32 37 36 37 0a 23 20 65 COLUMN>32767.# e
122f0 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f rror SQLITE_MAX_
12300 43 4f 4c 55 4d 4e 20 6d 75 73 74 20 6e 6f 74 20 COLUMN must not
12310 65 78 63 65 65 64 20 33 32 37 36 37 0a 23 65 6e exceed 32767.#en
12320 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d dif.#if SQLITE_M
12330 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 AX_TRIGGER_DEPTH
12340 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 <1.# error SQLIT
12350 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 E_MAX_TRIGGER_DE
12360 50 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c PTH must be at l
12370 65 61 73 74 20 31 0a 23 65 6e 64 69 66 0a 23 69 east 1.#endif.#i
12380 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 f SQLITE_MAX_WOR
12390 4b 45 52 5f 54 48 52 45 41 44 53 3c 30 20 7c 7c KER_THREADS<0 ||
123a0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b SQLITE_MAX_WORK
123b0 45 52 5f 54 48 52 45 41 44 53 3e 35 30 0a 23 20 ER_THREADS>50.#
123c0 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
123d0 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 _WORKER_THREADS
123e0 6d 75 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 must be between
123f0 30 20 61 6e 64 20 35 30 0a 23 65 6e 64 69 66 0a 0 and 50.#endif.
12400 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 ../*.** Change t
12410 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 6c 69 he value of a li
12420 6d 69 74 2e 20 20 52 65 70 6f 72 74 20 74 68 65 mit. Report the
12430 20 6f 6c 64 20 76 61 6c 75 65 2e 0a 2a 2a 20 49 old value..** I
12440 66 20 61 6e 20 69 6e 76 61 6c 69 64 20 6c 69 6d f an invalid lim
12450 69 74 20 69 6e 64 65 78 20 69 73 20 73 75 70 70 it index is supp
12460 6c 69 65 64 2c 20 72 65 70 6f 72 74 20 2d 31 2e lied, report -1.
12470 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 6e .** Make no chan
12480 67 65 73 20 62 75 74 20 73 74 69 6c 6c 20 72 65 ges but still re
12490 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 76 61 6c port the old val
124a0 75 65 20 69 66 20 74 68 65 0a 2a 2a 20 6e 65 77 ue if the.** new
124b0 20 6c 69 6d 69 74 20 69 73 20 6e 65 67 61 74 69 limit is negati
124c0 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 77 20 ve..**.** A new
124d0 6c 6f 77 65 72 20 6c 69 6d 69 74 20 64 6f 65 73 lower limit does
124e0 20 6e 6f 74 20 73 68 72 69 6e 6b 20 65 78 69 73 not shrink exis
124f0 74 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 73 2e ting constructs.
12500 0a 2a 2a 20 49 74 20 6d 65 72 65 6c 79 20 70 72 .** It merely pr
12510 65 76 65 6e 74 73 20 6e 65 77 20 63 6f 6e 73 74 events new const
12520 72 75 63 74 73 20 74 68 61 74 20 65 78 63 65 65 ructs that excee
12530 64 20 74 68 65 20 6c 69 6d 69 74 0a 2a 2a 20 66 d the limit.** f
12540 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e 0a 2a 2f 0a rom forming..*/.
12550 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 69 6d 69 int sqlite3_limi
12560 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 t(sqlite3 *db, i
12570 6e 74 20 6c 69 6d 69 74 49 64 2c 20 69 6e 74 20 nt limitId, int
12580 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 20 69 6e 74 newLimit){. int
12590 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a 23 69 66 64 oldLimit;..#ifd
125a0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
125b0 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
125c0 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
125d0 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
125e0 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
125f0 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
12600 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 return -1;. }.#
12610 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 45 56 49 44 endif.. /* EVID
12620 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 30 31 38 39 ENCE-OF: R-30189
12630 2d 35 34 30 39 37 20 46 6f 72 20 65 61 63 68 20 -54097 For each
12640 6c 69 6d 69 74 20 63 61 74 65 67 6f 72 79 20 53 limit category S
12650 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4e 41 4d 45 QLITE_LIMIT_NAME
12660 0a 20 20 2a 2a 20 74 68 65 72 65 20 69 73 20 61 . ** there is a
12670 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75 6e hard upper boun
12680 64 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65 d set at compile
12690 2d 74 69 6d 65 20 62 79 20 61 20 43 20 70 72 65 -time by a C pre
126a0 70 72 6f 63 65 73 73 6f 72 0a 20 20 2a 2a 20 6d processor. ** m
126b0 61 63 72 6f 20 63 61 6c 6c 65 64 20 53 51 4c 49 acro called SQLI
126c0 54 45 5f 4d 41 58 5f 4e 41 4d 45 2e 20 28 54 68 TE_MAX_NAME. (Th
126d0 65 20 22 5f 4c 49 4d 49 54 5f 22 20 69 6e 20 74 e "_LIMIT_" in t
126e0 68 65 20 6e 61 6d 65 20 69 73 20 63 68 61 6e 67 he name is chang
126f0 65 64 20 74 6f 0a 20 20 2a 2a 20 22 5f 4d 41 58 ed to. ** "_MAX
12700 5f 22 2e 29 0a 20 20 2a 2f 0a 20 20 61 73 73 65 _".). */. asse
12710 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
12720 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 QLITE_LIMIT_LENG
12730 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f TH]==SQLITE_MAX_
12740 4c 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 65 LENGTH );. asse
12750 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
12760 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 53 51 4c 5f QLITE_LIMIT_SQL_
12770 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c 49 54 45 5f LENGTH]==SQLITE_
12780 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 29 MAX_SQL_LENGTH )
12790 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
127a0 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
127b0 4d 49 54 5f 43 4f 4c 55 4d 4e 5d 3d 3d 53 51 4c MIT_COLUMN]==SQL
127c0 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 20 29 ITE_MAX_COLUMN )
127d0 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
127e0 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
127f0 4d 49 54 5f 45 58 50 52 5f 44 45 50 54 48 5d 3d MIT_EXPR_DEPTH]=
12800 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 =SQLITE_MAX_EXPR
12810 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 _DEPTH );. asse
12820 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
12830 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 43 4f 4d 50 QLITE_LIMIT_COMP
12840 4f 55 4e 44 5f 53 45 4c 45 43 54 5d 3d 3d 53 51 OUND_SELECT]==SQ
12850 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e LITE_MAX_COMPOUN
12860 44 5f 53 45 4c 45 43 54 29 3b 0a 20 20 61 73 73 D_SELECT);. ass
12870 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
12880 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 56 44 42 SQLITE_LIMIT_VDB
12890 45 5f 4f 50 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 E_OP]==SQLITE_MA
128a0 58 5f 56 44 42 45 5f 4f 50 20 29 3b 0a 20 20 61 X_VDBE_OP );. a
128b0 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
128c0 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 46 t[SQLITE_LIMIT_F
128d0 55 4e 43 54 49 4f 4e 5f 41 52 47 5d 3d 3d 53 51 UNCTION_ARG]==SQ
128e0 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f LITE_MAX_FUNCTIO
128f0 4e 5f 41 52 47 20 29 3b 0a 20 20 61 73 73 65 72 N_ARG );. asser
12900 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
12910 4c 49 54 45 5f 4c 49 4d 49 54 5f 41 54 54 41 43 LITE_LIMIT_ATTAC
12920 48 45 44 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 HED]==SQLITE_MAX
12930 5f 41 54 54 41 43 48 45 44 20 29 3b 0a 20 20 61 _ATTACHED );. a
12940 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
12950 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c t[SQLITE_LIMIT_L
12960 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
12970 54 48 5d 3d 3d 0a 20 20 20 20 20 20 20 20 20 20 TH]==.
12980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
129a0 20 20 20 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f SQLITE_MAX_
129b0 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e LIKE_PATTERN_LEN
129c0 47 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 GTH );. assert(
129d0 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 aHardLimit[SQLI
129e0 54 45 5f 4c 49 4d 49 54 5f 56 41 52 49 41 42 4c TE_LIMIT_VARIABL
129f0 45 5f 4e 55 4d 42 45 52 5d 3d 3d 53 51 4c 49 54 E_NUMBER]==SQLIT
12a00 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e E_MAX_VARIABLE_N
12a10 55 4d 42 45 52 29 3b 0a 20 20 61 73 73 65 72 74 UMBER);. assert
12a20 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c ( aHardLimit[SQL
12a30 49 54 45 5f 4c 49 4d 49 54 5f 54 52 49 47 47 45 ITE_LIMIT_TRIGGE
12a40 52 5f 44 45 50 54 48 5d 3d 3d 53 51 4c 49 54 45 R_DEPTH]==SQLITE
12a50 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 _MAX_TRIGGER_DEP
12a60 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
12a70 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
12a80 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 E_LIMIT_WORKER_T
12a90 48 52 45 41 44 53 5d 3d 3d 53 51 4c 49 54 45 5f HREADS]==SQLITE_
12aa0 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 MAX_WORKER_THREA
12ab0 44 53 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 DS );. assert(
12ac0 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 SQLITE_LIMIT_WOR
12ad0 4b 45 52 5f 54 48 52 45 41 44 53 3d 3d 28 53 51 KER_THREADS==(SQ
12ae0 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 2d 31 29 20 LITE_N_LIMIT-1)
12af0 29 3b 0a 0a 0a 20 20 69 66 28 20 6c 69 6d 69 74 );... if( limit
12b00 49 64 3c 30 20 7c 7c 20 6c 69 6d 69 74 49 64 3e Id<0 || limitId>
12b10 3d 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 =SQLITE_N_LIMIT
12b20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 2d 31 ){. return -1
12b30 3b 0a 20 20 7d 0a 20 20 6f 6c 64 4c 69 6d 69 74 ;. }. oldLimit
12b40 20 3d 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 = db->aLimit[li
12b50 6d 69 74 49 64 5d 3b 0a 20 20 69 66 28 20 6e 65 mitId];. if( ne
12b60 77 4c 69 6d 69 74 3e 3d 30 20 29 7b 20 20 20 20 wLimit>=0 ){
12b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
12b80 2a 20 49 4d 50 3a 20 52 2d 35 32 34 37 36 2d 32 * IMP: R-52476-2
12b90 38 37 33 32 20 2a 2f 0a 20 20 20 20 69 66 28 20 8732 */. if(
12ba0 6e 65 77 4c 69 6d 69 74 3e 61 48 61 72 64 4c 69 newLimit>aHardLi
12bb0 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 20 29 7b 0a mit[limitId] ){.
12bc0 20 20 20 20 20 20 6e 65 77 4c 69 6d 69 74 20 3d newLimit =
12bd0 20 61 48 61 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 aHardLimit[limi
12be0 74 49 64 5d 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 tId]; /* IMP: R
12bf0 2d 35 31 34 36 33 2d 32 35 36 33 34 20 2a 2f 0a -51463-25634 */.
12c00 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e 61 4c }. db->aL
12c10 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 20 3d 20 imit[limitId] =
12c20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 7d 0a 20 20 newLimit;. }.
12c30 72 65 74 75 72 6e 20 6f 6c 64 4c 69 6d 69 74 3b return oldLimit;
12c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12c50 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 /* IMP: R-5
12c60 33 33 34 31 2d 33 35 34 31 39 20 2a 2f 0a 7d 0a 3341-35419 */.}.
12c70 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
12c80 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 tion is used to
12c90 70 61 72 73 65 20 62 6f 74 68 20 55 52 49 73 20 parse both URIs
12ca0 61 6e 64 20 6e 6f 6e 2d 55 52 49 20 66 69 6c 65 and non-URI file
12cb0 6e 61 6d 65 73 20 70 61 73 73 65 64 20 62 79 20 names passed by
12cc0 74 68 65 0a 2a 2a 20 75 73 65 72 20 74 6f 20 41 the.** user to A
12cd0 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 73 71 6c PI functions sql
12ce0 69 74 65 33 5f 6f 70 65 6e 28 29 20 6f 72 20 73 ite3_open() or s
12cf0 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 qlite3_open_v2()
12d00 2c 20 61 6e 64 20 66 6f 72 20 64 61 74 61 62 61 , and for databa
12d10 73 65 0a 2a 2a 20 55 52 49 73 20 73 70 65 63 69 se.** URIs speci
12d20 66 69 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 fied as part of
12d30 41 54 54 41 43 48 20 73 74 61 74 65 6d 65 6e 74 ATTACH statement
12d40 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 s..**.** The fir
12d50 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 st argument to t
12d60 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
12d70 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
12d80 56 46 53 20 74 6f 20 75 73 65 20 28 6f 72 0a 2a VFS to use (or.*
12d90 2a 20 61 20 4e 55 4c 4c 20 74 6f 20 73 69 67 6e * a NULL to sign
12da0 69 66 79 20 74 68 65 20 64 65 66 61 75 6c 74 20 ify the default
12db0 56 46 53 29 20 69 66 20 74 68 65 20 55 52 49 20 VFS) if the URI
12dc0 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 74 61 69 6e does not contain
12dd0 20 61 20 22 76 66 73 3d 78 78 78 22 0a 2a 2a 20 a "vfs=xxx".**
12de0 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e query parameter.
12df0 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 The second argu
12e00 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 ment contains th
12e10 65 20 55 52 49 20 28 6f 72 20 6e 6f 6e 2d 55 52 e URI (or non-UR
12e20 49 20 66 69 6c 65 6e 61 6d 65 29 0a 2a 2a 20 69 I filename).** i
12e30 74 73 65 6c 66 2e 20 57 68 65 6e 20 74 68 69 73 tself. When this
12e40 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
12e50 6c 65 64 20 74 68 65 20 2a 70 46 6c 61 67 73 20 led the *pFlags
12e60 76 61 72 69 61 62 6c 65 20 73 68 6f 75 6c 64 20 variable should
12e70 63 6f 6e 74 61 69 6e 0a 2a 2a 20 74 68 65 20 64 contain.** the d
12e80 65 66 61 75 6c 74 20 66 6c 61 67 73 20 74 6f 20 efault flags to
12e90 6f 70 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 open the databas
12ea0 65 20 68 61 6e 64 6c 65 20 77 69 74 68 2e 20 54 e handle with. T
12eb0 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 he value stored
12ec0 69 6e 0a 2a 2a 20 2a 70 46 6c 61 67 73 20 6d 61 in.** *pFlags ma
12ed0 79 20 62 65 20 75 70 64 61 74 65 64 20 62 65 66 y be updated bef
12ee0 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 69 66 ore returning if
12ef0 20 74 68 65 20 55 52 49 20 66 69 6c 65 6e 61 6d the URI filenam
12f00 65 20 63 6f 6e 74 61 69 6e 73 20 0a 2a 2a 20 22 e contains .** "
12f10 63 61 63 68 65 3d 78 78 78 22 20 6f 72 20 22 6d cache=xxx" or "m
12f20 6f 64 65 3d 78 78 78 22 20 71 75 65 72 79 20 70 ode=xxx" query p
12f30 61 72 61 6d 65 74 65 72 73 2e 0a 2a 2a 0a 2a 2a arameters..**.**
12f40 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 If successful,
12f50 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
12f60 75 72 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 63 urned. In this c
12f70 61 73 65 20 2a 70 70 56 66 73 20 69 73 20 73 65 ase *ppVfs is se
12f80 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 0a 2a 2a t to point to.**
12f90 20 74 68 65 20 56 46 53 20 74 68 61 74 20 73 68 the VFS that sh
12fa0 6f 75 6c 64 20 62 65 20 75 73 65 64 20 74 6f 20 ould be used to
12fb0 6f 70 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 open the databas
12fc0 65 20 66 69 6c 65 2e 20 2a 70 7a 46 69 6c 65 20 e file. *pzFile
12fd0 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 70 6f 69 is set to.** poi
12fe0 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 63 nt to a buffer c
12ff0 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e 61 ontaining the na
13000 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 me of the file t
13010 6f 20 6f 70 65 6e 2e 20 49 74 20 69 73 20 74 68 o open. It is th
13020 65 20 0a 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 e .** responsibi
13030 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c lity of the call
13040 65 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c 79 er to eventually
13050 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 66 72 call sqlite3_fr
13060 65 65 28 29 20 74 6f 20 72 65 6c 65 61 73 65 0a ee() to release.
13070 2a 2a 20 74 68 69 73 20 62 75 66 66 65 72 2e 0a ** this buffer..
13080 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f **.** If an erro
13090 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 61 r occurs, then a
130a0 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 n SQLite error c
130b0 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 ode is returned
130c0 61 6e 64 20 2a 70 7a 45 72 72 4d 73 67 0a 2a 2a and *pzErrMsg.**
130d0 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 70 may be set to p
130e0 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 oint to a buffer
130f0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 6e 20 45 containing an E
13100 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 nglish language
13110 65 72 72 6f 72 20 0a 2a 2a 20 6d 65 73 73 61 67 error .** messag
13120 65 2e 20 49 74 20 69 73 20 74 68 65 20 72 65 73 e. It is the res
13130 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 74 ponsibility of t
13140 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 he caller to eve
13150 6e 74 75 61 6c 6c 79 20 72 65 6c 65 61 73 65 0a ntually release.
13160 2a 2a 20 74 68 69 73 20 62 75 66 66 65 72 20 62 ** this buffer b
13170 79 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 y calling sqlite
13180 33 5f 66 72 65 65 28 29 2e 0a 2a 2f 0a 69 6e 74 3_free()..*/.int
13190 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 69 sqlite3ParseUri
131a0 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
131b0 7a 44 65 66 61 75 6c 74 56 66 73 2c 20 20 20 20 zDefaultVfs,
131c0 20 20 20 20 2f 2a 20 56 46 53 20 74 6f 20 75 73 /* VFS to us
131d0 65 20 69 66 20 6e 6f 20 22 76 66 73 3d 78 78 78 e if no "vfs=xxx
131e0 22 20 71 75 65 72 79 20 6f 70 74 69 6f 6e 20 2a " query option *
131f0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
13200 7a 55 72 69 2c 20 20 20 20 20 20 20 20 20 20 20 zUri,
13210 20 20 20 20 2f 2a 20 4e 75 6c 2d 74 65 72 6d 69 /* Nul-termi
13220 6e 61 74 65 64 20 55 52 49 20 74 6f 20 70 61 72 nated URI to par
13230 73 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 se */. unsigned
13240 20 69 6e 74 20 2a 70 46 6c 61 67 73 2c 20 20 20 int *pFlags,
13250 20 20 20 20 20 20 20 20 2f 2a 20 49 4e 2f 4f 55 /* IN/OU
13260 54 3a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 58 T: SQLITE_OPEN_X
13270 58 58 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 XX flags */. sq
13280 6c 69 74 65 33 5f 76 66 73 20 2a 2a 70 70 56 66 lite3_vfs **ppVf
13290 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a s, /*
132a0 20 4f 55 54 3a 20 56 46 53 20 74 6f 20 75 73 65 OUT: VFS to use
132b0 20 2a 2f 20 0a 20 20 63 68 61 72 20 2a 2a 70 7a */ . char **pz
132c0 46 69 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 File,
132d0 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 46 /* OUT: F
132e0 69 6c 65 6e 61 6d 65 20 63 6f 6d 70 6f 6e 65 6e ilename componen
132f0 74 20 6f 66 20 55 52 49 20 2a 2f 0a 20 20 63 68 t of URI */. ch
13300 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 ar **pzErrMsg
13310 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
13320 20 4f 55 54 3a 20 45 72 72 6f 72 20 6d 65 73 73 OUT: Error mess
13330 61 67 65 20 28 69 66 20 72 63 21 3d 53 51 4c 49 age (if rc!=SQLI
13340 54 45 5f 4f 4b 29 20 2a 2f 0a 29 7b 0a 20 20 69 TE_OK) */.){. i
13350 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
13360 4b 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e K;. unsigned in
13370 74 20 66 6c 61 67 73 20 3d 20 2a 70 46 6c 61 67 t flags = *pFlag
13380 73 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 s;. const char
13390 2a 7a 56 66 73 20 3d 20 7a 44 65 66 61 75 6c 74 *zVfs = zDefault
133a0 56 66 73 3b 0a 20 20 63 68 61 72 20 2a 7a 46 69 Vfs;. char *zFi
133b0 6c 65 3b 0a 20 20 63 68 61 72 20 63 3b 0a 20 20 le;. char c;.
133c0 69 6e 74 20 6e 55 72 69 20 3d 20 73 71 6c 69 74 int nUri = sqlit
133d0 65 33 53 74 72 6c 65 6e 33 30 28 7a 55 72 69 29 e3Strlen30(zUri)
133e0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 2a 70 7a ;.. assert( *pz
133f0 45 72 72 4d 73 67 3d 3d 30 20 29 3b 0a 0a 20 20 ErrMsg==0 );..
13400 69 66 28 20 28 28 66 6c 61 67 73 20 26 20 53 51 if( ((flags & SQ
13410 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29 20 7c LITE_OPEN_URI) |
13420 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 | sqlite3GlobalC
13430 6f 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 29 20 onfig.bOpenUri)
13440 0a 20 20 20 26 26 20 6e 55 72 69 3e 3d 35 20 26 . && nUri>=5 &
13450 26 20 6d 65 6d 63 6d 70 28 7a 55 72 69 2c 20 22 & memcmp(zUri, "
13460 66 69 6c 65 3a 22 2c 20 35 29 3d 3d 30 20 2f 2a file:", 5)==0 /*
13470 20 49 4d 50 3a 20 52 2d 35 37 38 38 34 2d 33 37 IMP: R-57884-37
13480 34 39 36 20 2a 2f 0a 20 20 29 7b 0a 20 20 20 20 496 */. ){.
13490 63 68 61 72 20 2a 7a 4f 70 74 3b 0a 20 20 20 20 char *zOpt;.
134a0 69 6e 74 20 65 53 74 61 74 65 3b 20 20 20 20 20 int eState;
134b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
134c0 20 50 61 72 73 65 72 20 73 74 61 74 65 20 77 68 Parser state wh
134d0 65 6e 20 70 61 72 73 69 6e 67 20 55 52 49 20 2a en parsing URI *
134e0 2f 0a 20 20 20 20 69 6e 74 20 69 49 6e 3b 20 20 /. int iIn;
134f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13500 20 20 20 20 2f 2a 20 49 6e 70 75 74 20 63 68 61 /* Input cha
13510 72 61 63 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a racter index */.
13520 20 20 20 20 69 6e 74 20 69 4f 75 74 20 3d 20 30 int iOut = 0
13530 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
13540 20 20 2f 2a 20 4f 75 74 70 75 74 20 63 68 61 72 /* Output char
13550 61 63 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 acter index */.
13560 20 20 20 69 6e 74 20 6e 42 79 74 65 20 3d 20 6e int nByte = n
13570 55 72 69 2b 32 3b 20 20 20 20 20 20 20 20 20 20 Uri+2;
13580 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 73 70 61 /* Bytes of spa
13590 63 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a ce to allocate *
135a0 2f 0a 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 /.. /* Make s
135b0 75 72 65 20 74 68 65 20 53 51 4c 49 54 45 5f 4f ure the SQLITE_O
135c0 50 45 4e 5f 55 52 49 20 66 6c 61 67 20 69 73 20 PEN_URI flag is
135d0 73 65 74 20 74 6f 20 69 6e 64 69 63 61 74 65 20 set to indicate
135e0 74 6f 20 74 68 65 20 56 46 53 20 78 4f 70 65 6e to the VFS xOpen
135f0 20 0a 20 20 20 20 2a 2a 20 6d 65 74 68 6f 64 20 . ** method
13600 74 68 61 74 20 74 68 65 72 65 20 6d 61 79 20 62 that there may b
13610 65 20 65 78 74 72 61 20 70 61 72 61 6d 65 74 65 e extra paramete
13620 72 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 rs following the
13630 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 20 2a 2f 0a file-name. */.
13640 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c flags |= SQL
13650 49 54 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a 0a 20 ITE_OPEN_URI;..
13660 20 20 20 66 6f 72 28 69 49 6e 3d 30 3b 20 69 49 for(iIn=0; iI
13670 6e 3c 6e 55 72 69 3b 20 69 49 6e 2b 2b 29 20 6e n<nUri; iIn++) n
13680 42 79 74 65 20 2b 3d 20 28 7a 55 72 69 5b 69 49 Byte += (zUri[iI
13690 6e 5d 3d 3d 27 26 27 29 3b 0a 20 20 20 20 7a 46 n]=='&');. zF
136a0 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 ile = sqlite3_ma
136b0 6c 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 20 20 20 lloc(nByte);.
136c0 20 69 66 28 20 21 7a 46 69 6c 65 20 29 20 72 65 if( !zFile ) re
136d0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
136e0 4d 3b 0a 0a 20 20 20 20 69 49 6e 20 3d 20 35 3b M;.. iIn = 5;
136f0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
13700 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54 48 4f 52 ALLOW_URI_AUTHOR
13710 49 54 59 0a 20 20 20 20 2f 2a 20 44 69 73 63 61 ITY. /* Disca
13720 72 64 20 74 68 65 20 73 63 68 65 6d 65 20 61 6e rd the scheme an
13730 64 20 61 75 74 68 6f 72 69 74 79 20 73 65 67 6d d authority segm
13740 65 6e 74 73 20 6f 66 20 74 68 65 20 55 52 49 2e ents of the URI.
13750 20 2a 2f 0a 20 20 20 20 69 66 28 20 7a 55 72 69 */. if( zUri
13760 5b 35 5d 3d 3d 27 2f 27 20 26 26 20 7a 55 72 69 [5]=='/' && zUri
13770 5b 36 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 [6]=='/' ){.
13780 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 20 20 20 iIn = 7;.
13790 20 77 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 6e while( zUri[iIn
137a0 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 3d ] && zUri[iIn]!=
137b0 27 2f 27 20 29 20 69 49 6e 2b 2b 3b 0a 20 20 20 '/' ) iIn++;.
137c0 20 20 20 69 66 28 20 69 49 6e 21 3d 37 20 26 26 if( iIn!=7 &&
137d0 20 28 69 49 6e 21 3d 31 36 20 7c 7c 20 6d 65 6d (iIn!=16 || mem
137e0 63 6d 70 28 22 6c 6f 63 61 6c 68 6f 73 74 22 2c cmp("localhost",
137f0 20 26 7a 55 72 69 5b 37 5d 2c 20 39 29 29 20 29 &zUri[7], 9)) )
13800 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72 {. *pzErr
13810 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 Msg = sqlite3_mp
13820 72 69 6e 74 66 28 22 69 6e 76 61 6c 69 64 20 75 rintf("invalid u
13830 72 69 20 61 75 74 68 6f 72 69 74 79 3a 20 25 2e ri authority: %.
13840 2a 73 22 2c 20 0a 20 20 20 20 20 20 20 20 20 20 *s", .
13850 20 20 69 49 6e 2d 37 2c 20 26 7a 55 72 69 5b 37 iIn-7, &zUri[7
13860 5d 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ]);. rc =
13870 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
13880 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 goto pars
13890 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 e_uri_out;.
138a0 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a }. }.#endif.
138b0 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 74 68 65 . /* Copy the
138c0 20 66 69 6c 65 6e 61 6d 65 20 61 6e 64 20 61 6e filename and an
138d0 79 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 y query paramete
138e0 72 73 20 69 6e 74 6f 20 74 68 65 20 7a 46 69 6c rs into the zFil
138f0 65 20 62 75 66 66 65 72 2e 20 0a 20 20 20 20 2a e buffer. . *
13900 2a 20 44 65 63 6f 64 65 20 25 48 48 20 65 73 63 * Decode %HH esc
13910 61 70 65 20 63 6f 64 65 73 20 61 6c 6f 6e 67 20 ape codes along
13920 74 68 65 20 77 61 79 2e 20 0a 20 20 20 20 2a 2a the way. . **
13930 0a 20 20 20 20 2a 2a 20 57 69 74 68 69 6e 20 74 . ** Within t
13940 68 69 73 20 6c 6f 6f 70 2c 20 76 61 72 69 61 62 his loop, variab
13950 6c 65 20 65 53 74 61 74 65 20 6d 61 79 20 62 65 le eState may be
13960 20 73 65 74 20 74 6f 20 30 2c 20 31 20 6f 72 20 set to 0, 1 or
13970 32 2c 20 64 65 70 65 6e 64 69 6e 67 0a 20 20 20 2, depending.
13980 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 72 73 69 ** on the parsi
13990 6e 67 20 63 6f 6e 74 65 78 74 2e 20 41 73 20 66 ng context. As f
139a0 6f 6c 6c 6f 77 73 3a 0a 20 20 20 20 2a 2a 0a 20 ollows:. **.
139b0 20 20 20 2a 2a 20 20 20 30 3a 20 50 61 72 73 69 ** 0: Parsi
139c0 6e 67 20 66 69 6c 65 2d 6e 61 6d 65 2e 0a 20 20 ng file-name..
139d0 20 20 2a 2a 20 20 20 31 3a 20 50 61 72 73 69 6e ** 1: Parsin
139e0 67 20 6e 61 6d 65 20 73 65 63 74 69 6f 6e 20 6f g name section o
139f0 66 20 61 20 6e 61 6d 65 3d 76 61 6c 75 65 20 71 f a name=value q
13a00 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a uery parameter..
13a10 20 20 20 20 2a 2a 20 20 20 32 3a 20 50 61 72 73 ** 2: Pars
13a20 69 6e 67 20 76 61 6c 75 65 20 73 65 63 74 69 6f ing value sectio
13a30 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 6c 75 n of a name=valu
13a40 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 e query paramete
13a50 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 65 53 r.. */. eS
13a60 74 61 74 65 20 3d 20 30 3b 0a 20 20 20 20 77 68 tate = 0;. wh
13a70 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 69 5b 69 ile( (c = zUri[i
13a80 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 3d 27 23 In])!=0 && c!='#
13a90 27 20 29 7b 0a 20 20 20 20 20 20 69 49 6e 2b 2b ' ){. iIn++
13aa0 3b 0a 20 20 20 20 20 20 69 66 28 20 63 3d 3d 27 ;. if( c=='
13ab0 25 27 20 0a 20 20 20 20 20 20 20 26 26 20 73 71 %' . && sq
13ac0 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 7a 55 lite3Isxdigit(zU
13ad0 72 69 5b 69 49 6e 5d 29 20 0a 20 20 20 20 20 20 ri[iIn]) .
13ae0 20 26 26 20 73 71 6c 69 74 65 33 49 73 78 64 69 && sqlite3Isxdi
13af0 67 69 74 28 7a 55 72 69 5b 69 49 6e 2b 31 5d 29 git(zUri[iIn+1])
13b00 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 . ){.
13b10 20 20 20 69 6e 74 20 6f 63 74 65 74 20 3d 20 28 int octet = (
13b20 73 71 6c 69 74 65 33 48 65 78 54 6f 49 6e 74 28 sqlite3HexToInt(
13b30 7a 55 72 69 5b 69 49 6e 2b 2b 5d 29 20 3c 3c 20 zUri[iIn++]) <<
13b40 34 29 3b 0a 20 20 20 20 20 20 20 20 6f 63 74 65 4);. octe
13b50 74 20 2b 3d 20 73 71 6c 69 74 65 33 48 65 78 54 t += sqlite3HexT
13b60 6f 49 6e 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d oInt(zUri[iIn++]
13b70 29 3b 0a 0a 20 20 20 20 20 20 20 20 61 73 73 65 );.. asse
13b80 72 74 28 20 6f 63 74 65 74 3e 3d 30 20 26 26 20 rt( octet>=0 &&
13b90 6f 63 74 65 74 3c 32 35 36 20 29 3b 0a 20 20 20 octet<256 );.
13ba0 20 20 20 20 20 69 66 28 20 6f 63 74 65 74 3d 3d if( octet==
13bb0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 0 ){. /
13bc0 2a 20 54 68 69 73 20 62 72 61 6e 63 68 20 69 73 * This branch is
13bd0 20 74 61 6b 65 6e 20 77 68 65 6e 20 22 25 30 30 taken when "%00
13be0 22 20 61 70 70 65 61 72 73 20 77 69 74 68 69 6e " appears within
13bf0 20 74 68 65 20 55 52 49 2e 20 49 6e 20 74 68 69 the URI. In thi
13c00 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 63 s. ** c
13c10 61 73 65 20 77 65 20 69 67 6e 6f 72 65 20 61 6c ase we ignore al
13c20 6c 20 74 65 78 74 20 69 6e 20 74 68 65 20 72 65 l text in the re
13c30 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 65 20 70 mainder of the p
13c40 61 74 68 2c 20 6e 61 6d 65 20 6f 72 0a 20 20 20 ath, name or.
13c50 20 20 20 20 20 20 20 2a 2a 20 76 61 6c 75 65 20 ** value
13c60 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 currently being
13c70 70 61 72 73 65 64 2e 20 53 6f 20 69 67 6e 6f 72 parsed. So ignor
13c80 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 e the current ch
13c90 61 72 61 63 74 65 72 0a 20 20 20 20 20 20 20 20 aracter.
13ca0 20 20 2a 2a 20 61 6e 64 20 73 6b 69 70 20 74 6f ** and skip to
13cb0 20 74 68 65 20 6e 65 78 74 20 22 3f 22 2c 20 22 the next "?", "
13cc0 3d 22 20 6f 72 20 22 26 22 2c 20 61 73 20 61 70 =" or "&", as ap
13cd0 70 72 6f 70 72 69 61 74 65 2e 20 2a 2f 0a 20 20 propriate. */.
13ce0 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 28 while( (
13cf0 63 20 3d 20 7a 55 72 69 5b 69 49 6e 5d 29 21 3d c = zUri[iIn])!=
13d00 30 20 26 26 20 63 21 3d 27 23 27 20 0a 20 20 20 0 && c!='#' .
13d10 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 65 && (e
13d20 53 74 61 74 65 21 3d 30 20 7c 7c 20 63 21 3d 27 State!=0 || c!='
13d30 3f 27 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 ?').
13d40 20 20 26 26 20 28 65 53 74 61 74 65 21 3d 31 20 && (eState!=1
13d50 7c 7c 20 28 63 21 3d 27 3d 27 20 26 26 20 63 21 || (c!='=' && c!
13d60 3d 27 26 27 29 29 0a 20 20 20 20 20 20 20 20 20 ='&')).
13d70 20 20 20 20 20 26 26 20 28 65 53 74 61 74 65 21 && (eState!
13d80 3d 32 20 7c 7c 20 63 21 3d 27 26 27 29 0a 20 20 =2 || c!='&').
13d90 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ){.
13da0 20 20 20 20 20 20 20 69 49 6e 2b 2b 3b 0a 20 20 iIn++;.
13db0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
13dc0 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 continue;.
13dd0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
13de0 63 20 3d 20 6f 63 74 65 74 3b 0a 20 20 20 20 20 c = octet;.
13df0 20 7d 65 6c 73 65 20 69 66 28 20 65 53 74 61 74 }else if( eStat
13e00 65 3d 3d 31 20 26 26 20 28 63 3d 3d 27 26 27 20 e==1 && (c=='&'
13e10 7c 7c 20 63 3d 3d 27 3d 27 29 20 29 7b 0a 20 20 || c=='=') ){.
13e20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b if( zFile[
13e30 69 4f 75 74 2d 31 5d 3d 3d 30 20 29 7b 0a 20 20 iOut-1]==0 ){.
13e40 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 6d /* An em
13e50 70 74 79 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 2e pty option name.
13e60 20 49 67 6e 6f 72 65 20 74 68 69 73 20 6f 70 74 Ignore this opt
13e70 69 6f 6e 20 61 6c 74 6f 67 65 74 68 65 72 2e 20 ion altogether.
13e80 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 */. whi
13e90 6c 65 28 20 7a 55 72 69 5b 69 49 6e 5d 20 26 26 le( zUri[iIn] &&
13ea0 20 7a 55 72 69 5b 69 49 6e 5d 21 3d 27 23 27 20 zUri[iIn]!='#'
13eb0 26 26 20 7a 55 72 69 5b 69 49 6e 2d 31 5d 21 3d && zUri[iIn-1]!=
13ec0 27 26 27 20 29 20 69 49 6e 2b 2b 3b 0a 20 20 20 '&' ) iIn++;.
13ed0 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b continue;
13ee0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
13ef0 20 20 20 69 66 28 20 63 3d 3d 27 26 27 20 29 7b if( c=='&' ){
13f00 0a 20 20 20 20 20 20 20 20 20 20 7a 46 69 6c 65 . zFile
13f10 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b [iOut++] = '\0';
13f20 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
13f30 20 20 20 20 20 20 20 20 20 20 65 53 74 61 74 65 eState
13f40 20 3d 20 32 3b 0a 20 20 20 20 20 20 20 20 7d 0a = 2;. }.
13f50 20 20 20 20 20 20 20 20 63 20 3d 20 30 3b 0a 20 c = 0;.
13f60 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 }else if( (
13f70 65 53 74 61 74 65 3d 3d 30 20 26 26 20 63 3d 3d eState==0 && c==
13f80 27 3f 27 29 20 7c 7c 20 28 65 53 74 61 74 65 3d '?') || (eState=
13f90 3d 32 20 26 26 20 63 3d 3d 27 26 27 29 20 29 7b =2 && c=='&') ){
13fa0 0a 20 20 20 20 20 20 20 20 63 20 3d 20 30 3b 0a . c = 0;.
13fb0 20 20 20 20 20 20 20 20 65 53 74 61 74 65 20 3d eState =
13fc0 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1;. }.
13fd0 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 zFile[iOut++]
13fe0 3d 20 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 = c;. }. i
13ff0 66 28 20 65 53 74 61 74 65 3d 3d 31 20 29 20 7a f( eState==1 ) z
14000 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 File[iOut++] = '
14010 5c 30 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 69 \0';. zFile[i
14020 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 Out++] = '\0';.
14030 20 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d zFile[iOut++]
14040 20 3d 20 27 5c 30 27 3b 0a 0a 20 20 20 20 2f 2a = '\0';.. /*
14050 20 43 68 65 63 6b 20 69 66 20 74 68 65 72 65 20 Check if there
14060 77 65 72 65 20 61 6e 79 20 6f 70 74 69 6f 6e 73 were any options
14070 20 73 70 65 63 69 66 69 65 64 20 74 68 61 74 20 specified that
14080 73 68 6f 75 6c 64 20 62 65 20 69 6e 74 65 72 70 should be interp
14090 72 65 74 65 64 20 0a 20 20 20 20 2a 2a 20 68 65 reted . ** he
140a0 72 65 2e 20 4f 70 74 69 6f 6e 73 20 74 68 61 74 re. Options that
140b0 20 61 72 65 20 69 6e 74 65 72 70 72 65 74 65 64 are interpreted
140c0 20 68 65 72 65 20 69 6e 63 6c 75 64 65 20 22 76 here include "v
140d0 66 73 22 20 61 6e 64 20 74 68 6f 73 65 20 74 68 fs" and those th
140e0 61 74 0a 20 20 20 20 2a 2a 20 63 6f 72 72 65 73 at. ** corres
140f0 70 6f 6e 64 20 74 6f 20 66 6c 61 67 73 20 74 68 pond to flags th
14100 61 74 20 6d 61 79 20 62 65 20 70 61 73 73 65 64 at may be passed
14110 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f to the sqlite3_
14120 6f 70 65 6e 5f 76 32 28 29 0a 20 20 20 20 2a 2a open_v2(). **
14130 20 6d 65 74 68 6f 64 2e 20 2a 2f 0a 20 20 20 20 method. */.
14140 7a 4f 70 74 20 3d 20 26 7a 46 69 6c 65 5b 73 71 zOpt = &zFile[sq
14150 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 lite3Strlen30(zF
14160 69 6c 65 29 2b 31 5d 3b 0a 20 20 20 20 77 68 69 ile)+1];. whi
14170 6c 65 28 20 7a 4f 70 74 5b 30 5d 20 29 7b 0a 20 le( zOpt[0] ){.
14180 20 20 20 20 20 69 6e 74 20 6e 4f 70 74 20 3d 20 int nOpt =
14190 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
141a0 7a 4f 70 74 29 3b 0a 20 20 20 20 20 20 63 68 61 zOpt);. cha
141b0 72 20 2a 7a 56 61 6c 20 3d 20 26 7a 4f 70 74 5b r *zVal = &zOpt[
141c0 6e 4f 70 74 2b 31 5d 3b 0a 20 20 20 20 20 20 69 nOpt+1];. i
141d0 6e 74 20 6e 56 61 6c 20 3d 20 73 71 6c 69 74 65 nt nVal = sqlite
141e0 33 53 74 72 6c 65 6e 33 30 28 7a 56 61 6c 29 3b 3Strlen30(zVal);
141f0 0a 0a 20 20 20 20 20 20 69 66 28 20 6e 4f 70 74 .. if( nOpt
14200 3d 3d 33 20 26 26 20 6d 65 6d 63 6d 70 28 22 76 ==3 && memcmp("v
14210 66 73 22 2c 20 7a 4f 70 74 2c 20 33 29 3d 3d 30 fs", zOpt, 3)==0
14220 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 56 66 73 ){. zVfs
14230 20 3d 20 7a 56 61 6c 3b 0a 20 20 20 20 20 20 7d = zVal;. }
14240 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 74 else{. st
14250 72 75 63 74 20 4f 70 65 6e 4d 6f 64 65 20 7b 0a ruct OpenMode {.
14260 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 const
14270 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 20 20 20 char *z;.
14280 20 20 20 69 6e 74 20 6d 6f 64 65 3b 0a 20 20 20 int mode;.
14290 20 20 20 20 20 7d 20 2a 61 4d 6f 64 65 20 3d 20 } *aMode =
142a0 30 3b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 0;. char
142b0 2a 7a 4d 6f 64 65 54 79 70 65 20 3d 20 30 3b 0a *zModeType = 0;.
142c0 20 20 20 20 20 20 20 20 69 6e 74 20 6d 61 73 6b int mask
142d0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e = 0;. in
142e0 74 20 6c 69 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 t limit = 0;..
142f0 20 20 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d if( nOpt==
14300 35 20 26 26 20 6d 65 6d 63 6d 70 28 22 63 61 63 5 && memcmp("cac
14310 68 65 22 2c 20 7a 4f 70 74 2c 20 35 29 3d 3d 30 he", zOpt, 5)==0
14320 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 ){. st
14330 61 74 69 63 20 73 74 72 75 63 74 20 4f 70 65 6e atic struct Open
14340 4d 6f 64 65 20 61 43 61 63 68 65 4d 6f 64 65 5b Mode aCacheMode[
14350 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 20 20 ] = {.
14360 20 20 7b 20 22 73 68 61 72 65 64 22 2c 20 20 53 { "shared", S
14370 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 QLITE_OPEN_SHARE
14380 44 43 41 43 48 45 20 7d 2c 0a 20 20 20 20 20 20 DCACHE },.
14390 20 20 20 20 20 20 7b 20 22 70 72 69 76 61 74 65 { "private
143a0 22 2c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 ", SQLITE_OPEN_P
143b0 52 49 56 41 54 45 43 41 43 48 45 20 7d 2c 0a 20 RIVATECACHE },.
143c0 20 20 20 20 20 20 20 20 20 20 20 7b 20 30 2c 20 { 0,
143d0 30 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 3b 0 }. };
143e0 0a 0a 20 20 20 20 20 20 20 20 20 20 6d 61 73 6b .. mask
143f0 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 = SQLITE_OPEN_S
14400 48 41 52 45 44 43 41 43 48 45 7c 53 51 4c 49 54 HAREDCACHE|SQLIT
14410 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 E_OPEN_PRIVATECA
14420 43 48 45 3b 0a 20 20 20 20 20 20 20 20 20 20 61 CHE;. a
14430 4d 6f 64 65 20 3d 20 61 43 61 63 68 65 4d 6f 64 Mode = aCacheMod
14440 65 3b 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d e;. lim
14450 69 74 20 3d 20 6d 61 73 6b 3b 0a 20 20 20 20 20 it = mask;.
14460 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 20 3d zModeType =
14470 20 22 63 61 63 68 65 22 3b 0a 20 20 20 20 20 20 "cache";.
14480 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
14490 6e 4f 70 74 3d 3d 34 20 26 26 20 6d 65 6d 63 6d nOpt==4 && memcm
144a0 70 28 22 6d 6f 64 65 22 2c 20 7a 4f 70 74 2c 20 p("mode", zOpt,
144b0 34 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 4)==0 ){.
144c0 20 20 20 73 74 61 74 69 63 20 73 74 72 75 63 74 static struct
144d0 20 4f 70 65 6e 4d 6f 64 65 20 61 4f 70 65 6e 4d OpenMode aOpenM
144e0 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 ode[] = {.
144f0 20 20 20 20 20 20 7b 20 22 72 6f 22 2c 20 20 53 { "ro", S
14500 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f QLITE_OPEN_READO
14510 4e 4c 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 NLY },.
14520 20 20 20 7b 20 22 72 77 22 2c 20 20 53 51 4c 49 { "rw", SQLI
14530 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
14540 45 20 7d 2c 20 0a 20 20 20 20 20 20 20 20 20 20 E }, .
14550 20 20 7b 20 22 72 77 63 22 2c 20 53 51 4c 49 54 { "rwc", SQLIT
14560 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
14570 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 | SQLITE_OPEN_C
14580 52 45 41 54 45 20 7d 2c 0a 20 20 20 20 20 20 20 REATE },.
14590 20 20 20 20 20 7b 20 22 6d 65 6d 6f 72 79 22 2c { "memory",
145a0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d SQLITE_OPEN_MEM
145b0 4f 52 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 ORY },.
145c0 20 20 20 7b 20 30 2c 20 30 20 7d 0a 20 20 20 20 { 0, 0 }.
145d0 20 20 20 20 20 20 7d 3b 0a 0a 20 20 20 20 20 20 };..
145e0 20 20 20 20 6d 61 73 6b 20 3d 20 53 51 4c 49 54 mask = SQLIT
145f0 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 E_OPEN_READONLY
14600 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 | SQLITE_OPEN_RE
14610 41 44 57 52 49 54 45 0a 20 20 20 20 20 20 20 20 ADWRITE.
14620 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c | SQL
14630 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 ITE_OPEN_CREATE
14640 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 | SQLITE_OPEN_ME
14650 4d 4f 52 59 3b 0a 20 20 20 20 20 20 20 20 20 20 MORY;.
14660 61 4d 6f 64 65 20 3d 20 61 4f 70 65 6e 4d 6f 64 aMode = aOpenMod
14670 65 3b 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d e;. lim
14680 69 74 20 3d 20 6d 61 73 6b 20 26 20 66 6c 61 67 it = mask & flag
14690 73 3b 0a 20 20 20 20 20 20 20 20 20 20 7a 4d 6f s;. zMo
146a0 64 65 54 79 70 65 20 3d 20 22 61 63 63 65 73 73 deType = "access
146b0 22 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 ";. }..
146c0 20 20 20 20 20 20 69 66 28 20 61 4d 6f 64 65 20 if( aMode
146d0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 ){. int
146e0 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e i;. in
146f0 74 20 6d 6f 64 65 20 3d 20 30 3b 0a 20 20 20 20 t mode = 0;.
14700 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 61 for(i=0; a
14710 4d 6f 64 65 5b 69 5d 2e 7a 3b 20 69 2b 2b 29 7b Mode[i].z; i++){
14720 0a 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e . con
14730 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 61 4d 6f st char *z = aMo
14740 64 65 5b 69 5d 2e 7a 3b 0a 20 20 20 20 20 20 20 de[i].z;.
14750 20 20 20 20 20 69 66 28 20 6e 56 61 6c 3d 3d 73 if( nVal==s
14760 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
14770 29 20 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 28 7a ) && 0==memcmp(z
14780 56 61 6c 2c 20 7a 2c 20 6e 56 61 6c 29 20 29 7b Val, z, nVal) ){
14790 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d . m
147a0 6f 64 65 20 3d 20 61 4d 6f 64 65 5b 69 5d 2e 6d ode = aMode[i].m
147b0 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ode;.
147c0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
147d0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
147e0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 }. if
147f0 28 20 6d 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 ( mode==0 ){.
14800 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d *pzErrM
14810 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 sg = sqlite3_mpr
14820 69 6e 74 66 28 22 6e 6f 20 73 75 63 68 20 25 73 intf("no such %s
14830 20 6d 6f 64 65 3a 20 25 73 22 2c 20 7a 4d 6f 64 mode: %s", zMod
14840 65 54 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 eType, zVal);.
14850 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
14860 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 QLITE_ERROR;.
14870 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 goto pa
14880 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 rse_uri_out;.
14890 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
148a0 20 20 20 69 66 28 20 28 6d 6f 64 65 20 26 20 7e if( (mode & ~
148b0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f SQLITE_OPEN_MEMO
148c0 52 59 29 3e 6c 69 6d 69 74 20 29 7b 0a 20 20 20 RY)>limit ){.
148d0 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d *pzErrM
148e0 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 sg = sqlite3_mpr
148f0 69 6e 74 66 28 22 25 73 20 6d 6f 64 65 20 6e 6f intf("%s mode no
14900 74 20 61 6c 6c 6f 77 65 64 3a 20 25 73 22 2c 0a t allowed: %s",.
14910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14930 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 zModeTyp
14940 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20 20 20 e, zVal);.
14950 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
14960 45 5f 50 45 52 4d 3b 0a 20 20 20 20 20 20 20 20 E_PERM;.
14970 20 20 20 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 goto parse_u
14980 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 ri_out;.
14990 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 66 6c }. fl
149a0 61 67 73 20 3d 20 28 66 6c 61 67 73 20 26 20 7e ags = (flags & ~
149b0 6d 61 73 6b 29 20 7c 20 6d 6f 64 65 3b 0a 20 20 mask) | mode;.
149c0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
149d0 0a 20 20 20 20 20 20 7a 4f 70 74 20 3d 20 26 7a . zOpt = &z
149e0 56 61 6c 5b 6e 56 61 6c 2b 31 5d 3b 0a 20 20 20 Val[nVal+1];.
149f0 20 7d 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }.. }else{.
14a00 20 7a 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 zFile = sqlite3
14a10 5f 6d 61 6c 6c 6f 63 28 6e 55 72 69 2b 32 29 3b _malloc(nUri+2);
14a20 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c 65 20 . if( !zFile
14a30 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
14a40 4e 4f 4d 45 4d 3b 0a 20 20 20 20 6d 65 6d 63 70 NOMEM;. memcp
14a50 79 28 7a 46 69 6c 65 2c 20 7a 55 72 69 2c 20 6e y(zFile, zUri, n
14a60 55 72 69 29 3b 0a 20 20 20 20 7a 46 69 6c 65 5b Uri);. zFile[
14a70 6e 55 72 69 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 nUri] = '\0';.
14a80 20 20 7a 46 69 6c 65 5b 6e 55 72 69 2b 31 5d 20 zFile[nUri+1]
14a90 3d 20 27 5c 30 27 3b 0a 20 20 20 20 66 6c 61 67 = '\0';. flag
14aa0 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4f 50 45 s &= ~SQLITE_OPE
14ab0 4e 5f 55 52 49 3b 0a 20 20 7d 0a 0a 20 20 2a 70 N_URI;. }.. *p
14ac0 70 56 66 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 pVfs = sqlite3_v
14ad0 66 73 5f 66 69 6e 64 28 7a 56 66 73 29 3b 0a 20 fs_find(zVfs);.
14ae0 20 69 66 28 20 2a 70 70 56 66 73 3d 3d 30 20 29 if( *ppVfs==0 )
14af0 7b 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 {. *pzErrMsg
14b00 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 = sqlite3_mprint
14b10 66 28 22 6e 6f 20 73 75 63 68 20 76 66 73 3a 20 f("no such vfs:
14b20 25 73 22 2c 20 7a 56 66 73 29 3b 0a 20 20 20 20 %s", zVfs);.
14b30 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
14b40 52 3b 0a 20 20 7d 0a 20 70 61 72 73 65 5f 75 72 R;. }. parse_ur
14b50 69 5f 6f 75 74 3a 0a 20 20 69 66 28 20 72 63 21 i_out:. if( rc!
14b60 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
14b70 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a sqlite3_free(z
14b80 46 69 6c 65 29 3b 0a 20 20 20 20 7a 46 69 6c 65 File);. zFile
14b90 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a 70 46 6c = 0;. }. *pFl
14ba0 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a 20 20 2a ags = flags;. *
14bb0 70 7a 46 69 6c 65 20 3d 20 7a 46 69 6c 65 3b 0a pzFile = zFile;.
14bc0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
14bd0 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ./*.** This rout
14be0 69 6e 65 20 64 6f 65 73 20 74 68 65 20 77 6f 72 ine does the wor
14bf0 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 20 64 k of opening a d
14c00 61 74 61 62 61 73 65 20 6f 6e 20 62 65 68 61 6c atabase on behal
14c10 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 33 5f f of.** sqlite3_
14c20 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 69 74 open() and sqlit
14c30 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 68 65 e3_open16(). The
14c40 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 database filena
14c50 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 20 20 me "zFilename"
14c60 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 6e 63 .** is UTF-8 enc
14c70 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 oded..*/.static
14c80 69 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 73 65 int openDatabase
14c90 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
14ca0 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 zFilename, /* Da
14cb0 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 tabase filename
14cc0 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f UTF-8 encoded */
14cd0 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 . sqlite3 **ppD
14ce0 62 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 b, /* OUT
14cf0 3a 20 52 65 74 75 72 6e 65 64 20 64 61 74 61 62 : Returned datab
14d00 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 ase handle */.
14d10 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 66 6c 61 unsigned int fla
14d20 67 73 2c 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 gs, /* Operat
14d30 69 6f 6e 61 6c 20 66 6c 61 67 73 20 2a 2f 0a 20 ional flags */.
14d40 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 const char *zVf
14d50 73 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 s /* Name
14d60 6f 66 20 74 68 65 20 56 46 53 20 74 6f 20 75 73 of the VFS to us
14d70 65 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 e */.){. sqlite
14d80 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 20 3 *db;
14d90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 6f /* Sto
14da0 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 68 61 6e re allocated han
14db0 64 6c 65 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e dle here */. in
14dc0 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
14dd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
14de0 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a Return code */.
14df0 20 20 69 6e 74 20 69 73 54 68 72 65 61 64 73 61 int isThreadsa
14e00 66 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 fe;
14e10 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 74 68 /* True for th
14e20 72 65 61 64 73 61 66 65 20 63 6f 6e 6e 65 63 74 readsafe connect
14e30 69 6f 6e 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a ions */. char *
14e40 7a 4f 70 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 zOpen = 0;
14e50 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c /* Fil
14e60 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 74 ename argument t
14e70 6f 20 70 61 73 73 20 74 6f 20 42 74 72 65 65 4f o pass to BtreeO
14e80 70 65 6e 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 pen() */. char
14e90 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 20 20 20 *zErrMsg = 0;
14ea0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 /* Er
14eb0 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d ror message from
14ec0 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 69 sqlite3ParseUri
14ed0 28 29 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 () */..#ifdef SQ
14ee0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
14ef0 41 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 44 62 ARMOR. if( ppDb
14f00 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
14f10 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
14f20 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 .#endif. *ppDb
14f30 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c = 0;.#ifndef SQL
14f40 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 ITE_OMIT_AUTOINI
14f50 54 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 T. rc = sqlite3
14f60 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 _initialize();.
14f70 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
14f80 20 72 63 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f rc;.#endif.. /
14f90 2a 20 4f 6e 6c 79 20 61 6c 6c 6f 77 20 73 65 6e * Only allow sen
14fa0 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f sible combinatio
14fb0 6e 73 20 6f 66 20 62 69 74 73 20 69 6e 20 74 68 ns of bits in th
14fc0 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 6e 74 e flags argument
14fd0 2e 20 20 0a 20 20 2a 2a 20 54 68 72 6f 77 20 61 . . ** Throw a
14fe0 6e 20 65 72 72 6f 72 20 69 66 20 61 6e 79 20 6e n error if any n
14ff0 6f 6e 2d 73 65 6e 73 65 20 63 6f 6d 62 69 6e 61 on-sense combina
15000 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 20 20 49 tion is used. I
15010 66 20 77 65 0a 20 20 2a 2a 20 64 6f 20 6e 6f 74 f we. ** do not
15020 20 62 6c 6f 63 6b 20 69 6c 6c 65 67 61 6c 20 63 block illegal c
15030 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 68 65 72 65 ombinations here
15040 2c 20 69 74 20 63 6f 75 6c 64 20 74 72 69 67 67 , it could trigg
15050 65 72 0a 20 20 2a 2a 20 61 73 73 65 72 74 28 29 er. ** assert()
15060 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 64 statements in d
15070 65 65 70 65 72 20 6c 61 79 65 72 73 2e 20 20 53 eeper layers. S
15080 65 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 ensible combinat
15090 69 6f 6e 73 0a 20 20 2a 2a 20 61 72 65 3a 0a 20 ions. ** are:.
150a0 20 2a 2a 0a 20 20 2a 2a 20 20 31 3a 20 20 53 51 **. ** 1: SQ
150b0 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e LITE_OPEN_READON
150c0 4c 59 0a 20 20 2a 2a 20 20 32 3a 20 20 53 51 4c LY. ** 2: SQL
150d0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
150e0 54 45 0a 20 20 2a 2a 20 20 36 3a 20 20 53 51 4c TE. ** 6: SQL
150f0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
15100 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e TE | SQLITE_OPEN
15110 5f 43 52 45 41 54 45 0a 20 20 2a 2f 0a 20 20 61 _CREATE. */. a
15120 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 4f 50 ssert( SQLITE_OP
15130 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 20 3d 3d 20 EN_READONLY ==
15140 30 78 30 31 20 29 3b 0a 20 20 61 73 73 65 72 74 0x01 );. assert
15150 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 ( SQLITE_OPEN_RE
15160 41 44 57 52 49 54 45 20 3d 3d 20 30 78 30 32 20 ADWRITE == 0x02
15170 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c );. assert( SQL
15180 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 ITE_OPEN_CREATE
15190 20 20 20 3d 3d 20 30 78 30 34 20 29 3b 0a 20 20 == 0x04 );.
151a0 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c 28 66 testcase( (1<<(f
151b0 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 32 20 29 lags&7))==0x02 )
151c0 3b 20 2f 2a 20 52 45 41 44 4f 4e 4c 59 20 2a 2f ; /* READONLY */
151d0 0a 20 20 74 65 73 74 63 61 73 65 28 20 28 31 3c . testcase( (1<
151e0 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 <(flags&7))==0x0
151f0 34 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 49 54 4 ); /* READWRIT
15200 45 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 E */. testcase(
15210 20 28 31 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d (1<<(flags&7))=
15220 3d 30 78 34 30 20 29 3b 20 2f 2a 20 52 45 41 44 =0x40 ); /* READ
15230 57 52 49 54 45 20 7c 20 43 52 45 41 54 45 20 2a WRITE | CREATE *
15240 2f 0a 20 20 69 66 28 20 28 28 31 3c 3c 28 66 6c /. if( ((1<<(fl
15250 61 67 73 26 37 29 29 20 26 20 30 78 34 36 29 3d ags&7)) & 0x46)=
15260 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e =0 ){. return
15270 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
15280 4b 50 54 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d KPT; /* IMP: R-
15290 36 35 34 39 37 2d 34 34 35 39 34 20 2a 2f 0a 20 65497-44594 */.
152a0 20 7d 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 }.. if( sqlite
152b0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 3GlobalConfig.bC
152c0 6f 72 65 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 oreMutex==0 ){.
152d0 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 isThreadsafe
152e0 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 = 0;. }else if(
152f0 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f flags & SQLITE_
15300 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 29 7b 0a OPEN_NOMUTEX ){.
15310 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 isThreadsafe
15320 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 = 0;. }else if
15330 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 ( flags & SQLITE
15340 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 _OPEN_FULLMUTEX
15350 29 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 ){. isThreads
15360 61 66 65 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 afe = 1;. }else
15370 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 {. isThreadsa
15380 66 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 fe = sqlite3Glob
15390 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 alConfig.bFullMu
153a0 74 65 78 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 tex;. }. if( f
153b0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
153c0 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 EN_PRIVATECACHE
153d0 29 7b 0a 20 20 20 20 66 6c 61 67 73 20 26 3d 20 ){. flags &=
153e0 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 ~SQLITE_OPEN_SHA
153f0 52 45 44 43 41 43 48 45 3b 0a 20 20 7d 65 6c 73 REDCACHE;. }els
15400 65 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f e if( sqlite3Glo
15410 62 61 6c 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 balConfig.shared
15420 43 61 63 68 65 45 6e 61 62 6c 65 64 20 29 7b 0a CacheEnabled ){.
15430 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c flags |= SQL
15440 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 ITE_OPEN_SHAREDC
15450 41 43 48 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 ACHE;. }.. /*
15460 52 65 6d 6f 76 65 20 68 61 72 6d 66 75 6c 20 62 Remove harmful b
15470 69 74 73 20 66 72 6f 6d 20 74 68 65 20 66 6c 61 its from the fla
15480 67 73 20 70 61 72 61 6d 65 74 65 72 0a 20 20 2a gs parameter. *
15490 2a 0a 20 20 2a 2a 20 54 68 65 20 53 51 4c 49 54 *. ** The SQLIT
154a0 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 61 E_OPEN_NOMUTEX a
154b0 6e 64 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 nd SQLITE_OPEN_F
154c0 55 4c 4c 4d 55 54 45 58 20 66 6c 61 67 73 20 77 ULLMUTEX flags w
154d0 65 72 65 0a 20 20 2a 2a 20 64 65 61 6c 74 20 77 ere. ** dealt w
154e0 69 74 68 20 69 6e 20 74 68 65 20 70 72 65 76 69 ith in the previ
154f0 6f 75 73 20 63 6f 64 65 20 62 6c 6f 63 6b 2e 20 ous code block.
15500 20 42 65 73 69 64 65 73 20 74 68 65 73 65 2c 20 Besides these,
15510 74 68 65 20 6f 6e 6c 79 0a 20 20 2a 2a 20 76 61 the only. ** va
15520 6c 69 64 20 69 6e 70 75 74 20 66 6c 61 67 73 20 lid input flags
15530 66 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e for sqlite3_open
15540 5f 76 32 28 29 20 61 72 65 20 53 51 4c 49 54 45 _v2() are SQLITE
15550 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 0a _OPEN_READONLY,.
15560 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e ** SQLITE_OPEN
15570 5f 52 45 41 44 57 52 49 54 45 2c 20 53 51 4c 49 _READWRITE, SQLI
15580 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 TE_OPEN_CREATE,
15590 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 SQLITE_OPEN_SHAR
155a0 45 44 43 41 43 48 45 2c 0a 20 20 2a 2a 20 53 51 EDCACHE,. ** SQ
155b0 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 LITE_OPEN_PRIVAT
155c0 45 43 41 43 48 45 2c 20 61 6e 64 20 73 6f 6d 65 ECACHE, and some
155d0 20 72 65 73 65 72 76 65 64 20 62 69 74 73 2e 20 reserved bits.
155e0 20 53 69 6c 65 6e 74 6c 79 20 6d 61 73 6b 0a 20 Silently mask.
155f0 20 2a 2a 20 6f 66 66 20 61 6c 6c 20 6f 74 68 65 ** off all othe
15600 72 20 66 6c 61 67 73 2e 0a 20 20 2a 2f 0a 20 20 r flags.. */.
15610 66 6c 61 67 73 20 26 3d 20 20 7e 28 20 53 51 4c flags &= ~( SQL
15620 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f ITE_OPEN_DELETEO
15630 4e 43 4c 4f 53 45 20 7c 0a 20 20 20 20 20 20 20 NCLOSE |.
15640 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
15650 50 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 0a PEN_EXCLUSIVE |.
15660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
15670 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f QLITE_OPEN_MAIN_
15680 44 42 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 DB |.
15690 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
156a0 54 45 4d 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 TEMP_DB | .
156b0 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
156c0 5f 4f 50 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f _OPEN_TRANSIENT_
156d0 44 42 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 DB | .
156e0 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
156f0 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 _MAIN_JOURNAL |
15700 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
15710 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 SQLITE_OPEN_TEMP
15720 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 _JOURNAL | .
15730 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
15740 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 E_OPEN_SUBJOURNA
15750 4c 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 L | .
15760 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
15770 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c MASTER_JOURNAL |
15780 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
15790 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 SQLITE_OPEN_NOMU
157a0 54 45 58 20 7c 0a 20 20 20 20 20 20 20 20 20 20 TEX |.
157b0 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
157c0 5f 46 55 4c 4c 4d 55 54 45 58 20 7c 0a 20 20 20 _FULLMUTEX |.
157d0 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
157e0 54 45 5f 4f 50 45 4e 5f 57 41 4c 0a 20 20 20 20 TE_OPEN_WAL.
157f0 20 20 20 20 20 20 20 20 20 29 3b 0a 0a 20 20 2f );.. /
15800 2a 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 * Allocate the s
15810 71 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63 qlite data struc
15820 74 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 ture */. db = s
15830 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f qlite3MallocZero
15840 28 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 ( sizeof(sqlite3
15850 29 20 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 ) );. if( db==0
15860 20 29 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f ) goto opendb_o
15870 75 74 3b 0a 20 20 69 66 28 20 69 73 54 68 72 65 ut;. if( isThre
15880 61 64 73 61 66 65 20 29 7b 0a 20 20 20 20 64 62 adsafe ){. db
15890 2d 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 ->mutex = sqlite
158a0 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 3MutexAlloc(SQLI
158b0 54 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49 TE_MUTEX_RECURSI
158c0 56 45 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d VE);. if( db-
158d0 3e 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 >mutex==0 ){.
158e0 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
158f0 64 62 29 3b 0a 20 20 20 20 20 20 64 62 20 3d 20 db);. db =
15900 30 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 0;. goto op
15910 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a endb_out;. }.
15920 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
15930 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
15940 74 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d tex);. db->errM
15950 61 73 6b 20 3d 20 30 78 66 66 3b 0a 20 20 64 62 ask = 0xff;. db
15960 2d 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d ->nDb = 2;. db-
15970 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
15980 4d 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 MAGIC_BUSY;. db
15990 2d 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 ->aDb = db->aDbS
159a0 74 61 74 69 63 3b 0a 0a 20 20 61 73 73 65 72 74 tatic;.. assert
159b0 28 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 ( sizeof(db->aLi
159c0 6d 69 74 29 3d 3d 73 69 7a 65 6f 66 28 61 48 61 mit)==sizeof(aHa
159d0 72 64 4c 69 6d 69 74 29 20 29 3b 0a 20 20 6d 65 rdLimit) );. me
159e0 6d 63 70 79 28 64 62 2d 3e 61 4c 69 6d 69 74 2c mcpy(db->aLimit,
159f0 20 61 48 61 72 64 4c 69 6d 69 74 2c 20 73 69 7a aHardLimit, siz
15a00 65 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 74 29 29 eof(db->aLimit))
15a10 3b 0a 20 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 ;. db->aLimit[S
15a20 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b QLITE_LIMIT_WORK
15a30 45 52 5f 54 48 52 45 41 44 53 5d 20 3d 20 53 51 ER_THREADS] = SQ
15a40 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 LITE_DEFAULT_WOR
15a50 4b 45 52 5f 54 48 52 45 41 44 53 3b 0a 20 20 64 KER_THREADS;. d
15a60 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 b->autoCommit =
15a70 31 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 41 75 74 1;. db->nextAut
15a80 6f 76 61 63 20 3d 20 2d 31 3b 0a 20 20 64 62 2d ovac = -1;. db-
15a90 3e 73 7a 4d 6d 61 70 20 3d 20 73 71 6c 69 74 65 >szMmap = sqlite
15aa0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
15ab0 4d 6d 61 70 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 Mmap;. db->next
15ac0 50 61 67 65 73 69 7a 65 20 3d 20 30 3b 0a 20 20 Pagesize = 0;.
15ad0 64 62 2d 3e 6e 4d 61 78 53 6f 72 74 65 72 4d 6d db->nMaxSorterMm
15ae0 61 70 20 3d 20 30 78 37 46 46 46 46 46 46 46 3b ap = 0x7FFFFFFF;
15af0 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 . db->flags |=
15b00 53 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e SQLITE_ShortColN
15b10 61 6d 65 73 20 7c 20 53 51 4c 49 54 45 5f 45 6e ames | SQLITE_En
15b20 61 62 6c 65 54 72 69 67 67 65 72 20 7c 20 53 51 ableTrigger | SQ
15b30 4c 49 54 45 5f 43 61 63 68 65 53 70 69 6c 6c 0a LITE_CacheSpill.
15b40 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
15b50 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f ITE_DEFAULT_AUTO
15b60 4d 41 54 49 43 5f 49 4e 44 45 58 29 20 7c 7c 20 MATIC_INDEX) ||
15b70 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 SQLITE_DEFAULT_A
15b80 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 0a 20 UTOMATIC_INDEX.
15b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15ba0 7c 20 53 51 4c 49 54 45 5f 41 75 74 6f 49 6e 64 | SQLITE_AutoInd
15bb0 65 78 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 ex.#endif.#if SQ
15bc0 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c LITE_DEFAULT_FIL
15bd0 45 5f 46 4f 52 4d 41 54 3c 34 0a 20 20 20 20 20 E_FORMAT<4.
15be0 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 | SQ
15bf0 4c 49 54 45 5f 4c 65 67 61 63 79 46 69 6c 65 46 LITE_LegacyFileF
15c00 6d 74 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 mt.#endif.#ifdef
15c10 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
15c20 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 OAD_EXTENSION.
15c30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
15c40 20 53 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 SQLITE_LoadExte
15c50 6e 73 69 6f 6e 0a 23 65 6e 64 69 66 0a 23 69 66 nsion.#endif.#if
15c60 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
15c70 52 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 45 RECURSIVE_TRIGGE
15c80 52 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 RS.
15c90 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 52 65 63 | SQLITE_Rec
15ca0 54 72 69 67 67 65 72 73 0a 23 65 6e 64 69 66 0a Triggers.#endif.
15cb0 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
15cc0 54 45 5f 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 TE_DEFAULT_FOREI
15cd0 47 4e 5f 4b 45 59 53 29 20 26 26 20 53 51 4c 49 GN_KEYS) && SQLI
15ce0 54 45 5f 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 TE_DEFAULT_FOREI
15cf0 47 4e 5f 4b 45 59 53 0a 20 20 20 20 20 20 20 20 GN_KEYS.
15d00 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
15d10 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 0a 23 65 E_ForeignKeys.#e
15d20 6e 64 69 66 0a 20 20 20 20 20 20 3b 0a 20 20 73 ndif. ;. s
15d30 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 qlite3HashInit(&
15d40 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a 23 db->aCollSeq);.#
15d50 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
15d60 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
15d70 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 sqlite3HashIni
15d80 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b t(&db->aModule);
15d90 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 64 .#endif.. /* Ad
15da0 64 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f d the default co
15db0 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
15dc0 20 42 49 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 BINARY. BINARY
15dd0 77 6f 72 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 works for both U
15de0 54 46 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 TF-8. ** and UT
15df0 46 2d 31 36 2c 20 73 6f 20 61 64 64 20 61 20 76 F-16, so add a v
15e00 65 72 73 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 ersion for each
15e10 74 6f 20 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e to avoid any unn
15e20 65 63 65 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f ecessary. ** co
15e30 6e 76 65 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f nversions. The o
15e40 6e 6c 79 20 65 72 72 6f 72 20 74 68 61 74 20 63 nly error that c
15e50 61 6e 20 6f 63 63 75 72 20 68 65 72 65 20 69 73 an occur here is
15e60 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c a malloc() fail
15e70 75 72 65 2e 0a 20 20 2a 2f 0a 20 20 63 72 65 61 ure.. */. crea
15e80 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
15e90 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 "BINARY", SQLITE
15ea0 5f 55 54 46 38 2c 20 30 2c 20 62 69 6e 43 6f 6c _UTF8, 0, binCol
15eb0 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 lFunc, 0);. cre
15ec0 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c ateCollation(db,
15ed0 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 "BINARY", SQLIT
15ee0 45 5f 55 54 46 31 36 42 45 2c 20 30 2c 20 62 69 E_UTF16BE, 0, bi
15ef0 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 nCollFunc, 0);.
15f00 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e createCollation
15f10 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 (db, "BINARY", S
15f20 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 QLITE_UTF16LE, 0
15f30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 , binCollFunc, 0
15f40 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 );. createColla
15f50 74 69 6f 6e 28 64 62 2c 20 22 52 54 52 49 4d 22 tion(db, "RTRIM"
15f60 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 28 , SQLITE_UTF8, (
15f70 76 6f 69 64 2a 29 31 2c 20 62 69 6e 43 6f 6c 6c void*)1, binColl
15f80 46 75 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 Func, 0);. if(
15f90 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
15fa0 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 ){. goto ope
15fb0 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 64 ndb_out;. }. d
15fc0 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 73 b->pDfltColl = s
15fd0 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 qlite3FindCollSe
15fe0 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 54 46 q(db, SQLITE_UTF
15ff0 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 30 29 3b 8, "BINARY", 0);
16000 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 70 . assert( db->p
16010 44 66 6c 74 43 6f 6c 6c 21 3d 30 20 29 3b 0a 0a DfltColl!=0 );..
16020 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20 61 20 /* Also add a
16030 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73 65 6e UTF-8 case-insen
16040 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69 6f 6e sitive collation
16050 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a 20 20 sequence. */.
16060 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 createCollation(
16070 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c 20 53 51 db, "NOCASE", SQ
16080 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 6e 6f LITE_UTF8, 0, no
16090 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e caseCollatingFun
160a0 63 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 50 61 72 c, 0);.. /* Par
160b0 73 65 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 2f se the filename/
160c0 55 52 49 20 61 72 67 75 6d 65 6e 74 2e 20 2a 2f URI argument. */
160d0 0a 20 20 64 62 2d 3e 6f 70 65 6e 46 6c 61 67 73 . db->openFlags
160e0 20 3d 20 66 6c 61 67 73 3b 0a 20 20 72 63 20 3d = flags;. rc =
160f0 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 69 sqlite3ParseUri
16100 28 7a 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 (zVfs, zFilename
16110 2c 20 26 66 6c 61 67 73 2c 20 26 64 62 2d 3e 70 , &flags, &db->p
16120 56 66 73 2c 20 26 7a 4f 70 65 6e 2c 20 26 7a 45 Vfs, &zOpen, &zE
16130 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 72 63 rrMsg);. if( rc
16140 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
16150 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
16160 45 5f 4e 4f 4d 45 4d 20 29 20 64 62 2d 3e 6d 61 E_NOMEM ) db->ma
16170 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a llocFailed = 1;.
16180 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 sqlite3Error
16190 57 69 74 68 4d 73 67 28 64 62 2c 20 72 63 2c 20 WithMsg(db, rc,
161a0 7a 45 72 72 4d 73 67 20 3f 20 22 25 73 22 20 3a zErrMsg ? "%s" :
161b0 20 30 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 0, zErrMsg);.
161c0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a sqlite3_free(z
161d0 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 67 6f 74 ErrMsg);. got
161e0 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
161f0 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 }.. /* Open the
16200 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 backend databas
16210 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 e driver */. rc
16220 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f = sqlite3BtreeO
16230 70 65 6e 28 64 62 2d 3e 70 56 66 73 2c 20 7a 4f pen(db->pVfs, zO
16240 70 65 6e 2c 20 64 62 2c 20 26 64 62 2d 3e 61 44 pen, db, &db->aD
16250 62 5b 30 5d 2e 70 42 74 2c 20 30 2c 0a 20 20 20 b[0].pBt, 0,.
16260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16270 20 20 20 20 20 66 6c 61 67 73 20 7c 20 53 51 4c flags | SQL
16280 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 ITE_OPEN_MAIN_DB
16290 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
162a0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 ITE_OK ){. if
162b0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 ( rc==SQLITE_IOE
162c0 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 RR_NOMEM ){.
162d0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
162e0 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 MEM;. }. s
162f0 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
16300 72 63 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 rc);. goto op
16310 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 endb_out;. }.
16320 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 db->aDb[0].pSche
16330 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 ma = sqlite3Sche
16340 6d 61 47 65 74 28 64 62 2c 20 64 62 2d 3e 61 44 maGet(db, db->aD
16350 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 2d b[0].pBt);. db-
16360 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 20 >aDb[1].pSchema
16370 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 = sqlite3SchemaG
16380 65 74 28 64 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a et(db, 0);.. /*
16390 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 61 66 The default saf
163a0 65 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68 ety_level for th
163b0 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 e main database
163c0 69 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 20 74 is 'full'; for t
163d0 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 61 74 he temp. ** dat
163e0 61 62 61 73 65 20 69 74 20 69 73 20 27 4e 4f 4e abase it is 'NON
163f0 45 27 2e 20 54 68 69 73 20 6d 61 74 63 68 65 73 E'. This matches
16400 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 the pager layer
16410 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 20 2a defaults. . *
16420 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a /. db->aDb[0].z
16430 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 Name = "main";.
16440 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 66 65 db->aDb[0].safe
16450 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a 20 20 ty_level = 3;.
16460 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 4e 61 6d 65 db->aDb[1].zName
16470 20 3d 20 22 74 65 6d 70 22 3b 0a 20 20 64 62 2d = "temp";. db-
16480 3e 61 44 62 5b 31 5d 2e 73 61 66 65 74 79 5f 6c >aDb[1].safety_l
16490 65 76 65 6c 20 3d 20 31 3b 0a 0a 20 20 64 62 2d evel = 1;.. db-
164a0 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
164b0 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 69 66 MAGIC_OPEN;. if
164c0 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c ( db->mallocFail
164d0 65 64 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f ed ){. goto o
164e0 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 0a pendb_out;. }..
164f0 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 61 6c /* Register al
16500 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 l built-in funct
16510 69 6f 6e 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 ions, but do not
16520 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 attempt to read
16530 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 the. ** databa
16540 73 65 20 73 63 68 65 6d 61 20 79 65 74 2e 20 54 se schema yet. T
16550 68 69 73 20 69 73 20 64 65 6c 61 79 65 64 20 75 his is delayed u
16560 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 ntil the first t
16570 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ime the database
16580 0a 20 20 2a 2a 20 69 73 20 61 63 63 65 73 73 65 . ** is accesse
16590 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 d.. */. sqlite
165a0 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 3Error(db, SQLIT
165b0 45 5f 4f 4b 29 3b 0a 20 20 73 71 6c 69 74 65 33 E_OK);. sqlite3
165c0 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46 RegisterBuiltinF
165d0 75 6e 63 74 69 6f 6e 73 28 64 62 29 3b 0a 0a 20 unctions(db);..
165e0 20 2f 2a 20 4c 6f 61 64 20 61 75 74 6f 6d 61 74 /* Load automat
165f0 69 63 20 65 78 74 65 6e 73 69 6f 6e 73 20 2d 20 ic extensions -
16600 65 78 74 65 6e 73 69 6f 6e 73 20 74 68 61 74 20 extensions that
16610 68 61 76 65 20 62 65 65 6e 20 72 65 67 69 73 74 have been regist
16620 65 72 65 64 0a 20 20 2a 2a 20 75 73 69 6e 67 20 ered. ** using
16630 74 68 65 20 73 71 6c 69 74 65 33 5f 61 75 74 6f the sqlite3_auto
16640 6d 61 74 69 63 5f 65 78 74 65 6e 73 69 6f 6e 28 matic_extension(
16650 29 20 41 50 49 2e 0a 20 20 2a 2f 0a 20 20 72 63 ) API.. */. rc
16660 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f = sqlite3_errco
16670 64 65 28 64 62 29 3b 0a 20 20 69 66 28 20 72 63 de(db);. if( rc
16680 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
16690 20 20 20 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f sqlite3AutoLo
166a0 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 adExtensions(db)
166b0 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
166c0 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
166d0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
166e0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 TE_OK ){. g
166f0 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
16700 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 }. }..#ifde
16710 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
16720 46 54 53 31 0a 20 20 69 66 28 20 21 64 62 2d 3e FTS1. if( !db->
16730 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
16740 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 extern int s
16750 71 6c 69 74 65 33 46 74 73 31 49 6e 69 74 28 73 qlite3Fts1Init(s
16760 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 63 qlite3*);. rc
16770 20 3d 20 73 71 6c 69 74 65 33 46 74 73 31 49 6e = sqlite3Fts1In
16780 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
16790 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
167a0 45 5f 45 4e 41 42 4c 45 5f 46 54 53 32 0a 20 20 E_ENABLE_FTS2.
167b0 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
167c0 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
167d0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 65 78 ITE_OK ){. ex
167e0 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 tern int sqlite3
167f0 46 74 73 32 49 6e 69 74 28 73 71 6c 69 74 65 33 Fts2Init(sqlite3
16800 2a 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c *);. rc = sql
16810 69 74 65 33 46 74 73 32 49 6e 69 74 28 64 62 29 ite3Fts2Init(db)
16820 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 ;. }.#endif..#i
16830 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
16840 4c 45 5f 46 54 53 33 0a 20 20 69 66 28 20 21 64 LE_FTS3. if( !d
16850 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
16860 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b && rc==SQLITE_OK
16870 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c ){. rc = sql
16880 69 74 65 33 46 74 73 33 49 6e 69 74 28 64 62 29 ite3Fts3Init(db)
16890 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 ;. }.#endif..#i
168a0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
168b0 4c 45 5f 49 43 55 0a 20 20 69 66 28 20 21 64 62 LE_ICU. if( !db
168c0 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 ->mallocFailed &
168d0 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
168e0 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
168f0 74 65 33 49 63 75 49 6e 69 74 28 64 62 29 3b 0a te3IcuInit(db);.
16900 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 }.#endif..#ifd
16910 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
16920 5f 52 54 52 45 45 0a 20 20 69 66 28 20 21 64 62 _RTREE. if( !db
16930 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 ->mallocFailed &
16940 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 & rc==SQLITE_OK)
16950 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
16960 65 33 52 74 72 65 65 49 6e 69 74 28 64 62 29 3b e3RtreeInit(db);
16970 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f . }.#endif.. /
16980 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 * -DSQLITE_DEFAU
16990 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d LT_LOCKING_MODE=
169a0 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 49 56 1 makes EXCLUSIV
169b0 45 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f E the default lo
169c0 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e cking. ** mode.
169d0 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 -DSQLITE_DEFAU
169e0 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d LT_LOCKING_MODE=
169f0 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 74 68 0 make NORMAL th
16a00 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e e default lockin
16a10 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 44 6f g. ** mode. Do
16a20 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 20 61 ing nothing at a
16a30 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 4e 4f ll also makes NO
16a40 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c 74 RMAL the default
16a50 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 .. */.#ifdef SQ
16a60 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 LITE_DEFAULT_LOC
16a70 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 2d 3e KING_MODE. db->
16a80 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d 20 53 dfltLockMode = S
16a90 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f QLITE_DEFAULT_LO
16aa0 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 73 71 CKING_MODE;. sq
16ab0 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 6b 69 6e lite3PagerLockin
16ac0 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 74 72 gMode(sqlite3Btr
16ad0 65 65 50 61 67 65 72 28 64 62 2d 3e 61 44 62 5b eePager(db->aDb[
16ae0 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 20 20 0].pBt),.
16af0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16b00 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c SQLITE_DEFAUL
16b10 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 29 3b T_LOCKING_MODE);
16b20 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 72 .#endif.. if( r
16b30 63 20 29 20 73 71 6c 69 74 65 33 45 72 72 6f 72 c ) sqlite3Error
16b40 28 64 62 2c 20 72 63 29 3b 0a 0a 20 20 2f 2a 20 (db, rc);.. /*
16b50 45 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 Enable the looka
16b60 73 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 side-malloc subs
16b70 79 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 70 ystem */. setup
16b80 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 2c Lookaside(db, 0,
16b90 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
16ba0 6e 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 nfig.szLookaside
16bb0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
16bc0 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
16bd0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 3GlobalConfig.nL
16be0 6f 6f 6b 61 73 69 64 65 29 3b 0a 0a 20 20 73 71 ookaside);.. sq
16bf0 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 lite3_wal_autoch
16c00 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 53 51 4c eckpoint(db, SQL
16c10 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f ITE_DEFAULT_WAL_
16c20 41 55 54 4f 43 48 45 43 4b 50 4f 49 4e 54 29 3b AUTOCHECKPOINT);
16c30 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 ..opendb_out:.
16c40 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 4f 70 sqlite3_free(zOp
16c50 65 6e 29 3b 0a 20 20 69 66 28 20 64 62 20 29 7b en);. if( db ){
16c60 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d . assert( db-
16c70 3e 6d 75 74 65 78 21 3d 30 20 7c 7c 20 69 73 54 >mutex!=0 || isT
16c80 68 72 65 61 64 73 61 66 65 3d 3d 30 20 7c 7c 20 hreadsafe==0 ||
16c90 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
16ca0 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 3d 3d fig.bFullMutex==
16cb0 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 );. sqlite3
16cc0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
16cd0 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 >mutex);. }. r
16ce0 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 c = sqlite3_errc
16cf0 6f 64 65 28 64 62 29 3b 0a 20 20 61 73 73 65 72 ode(db);. asser
16d00 74 28 20 64 62 21 3d 30 20 7c 7c 20 72 63 3d 3d t( db!=0 || rc==
16d10 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a SQLITE_NOMEM );.
16d20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
16d30 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 73 71 _NOMEM ){. sq
16d40 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b lite3_close(db);
16d50 0a 20 20 20 20 64 62 20 3d 20 30 3b 0a 20 20 7d . db = 0;. }
16d60 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c else if( rc!=SQL
16d70 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 ITE_OK ){. db
16d80 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 ->magic = SQLITE
16d90 5f 4d 41 47 49 43 5f 53 49 43 4b 3b 0a 20 20 7d _MAGIC_SICK;. }
16da0 0a 20 20 2a 70 70 44 62 20 3d 20 64 62 3b 0a 23 . *ppDb = db;.#
16db0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
16dc0 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 69 66 28 BLE_SQLLOG. if(
16dd0 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
16de0 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 29 7b 0a nfig.xSqllog ){.
16df0 20 20 20 20 2f 2a 20 4f 70 65 6e 69 6e 67 20 61 /* Opening a
16e00 20 64 62 20 68 61 6e 64 6c 65 2e 20 46 6f 75 72 db handle. Four
16e10 74 68 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 th parameter is
16e20 70 61 73 73 65 64 20 30 2e 20 2a 2f 0a 20 20 20 passed 0. */.
16e30 20 76 6f 69 64 20 2a 70 41 72 67 20 3d 20 73 71 void *pArg = sq
16e40 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
16e50 67 2e 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 20 20 g.pSqllogArg;.
16e60 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
16e70 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 28 70 41 onfig.xSqllog(pA
16e80 72 67 2c 20 64 62 2c 20 7a 46 69 6c 65 6e 61 6d rg, db, zFilenam
16e90 65 2c 20 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 e, 0);. }.#endi
16ea0 66 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 f. return sqlit
16eb0 65 33 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 e3ApiExit(0, rc)
16ec0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 ;.}../*.** Open
16ed0 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 68 a new database h
16ee0 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 andle..*/.int sq
16ef0 6c 69 74 65 33 5f 6f 70 65 6e 28 0a 20 20 63 6f lite3_open(. co
16f00 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e nst char *zFilen
16f10 61 6d 65 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 ame, . sqlite3
16f20 2a 2a 70 70 44 62 20 0a 29 7b 0a 20 20 72 65 74 **ppDb .){. ret
16f30 75 72 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 65 urn openDatabase
16f40 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 (zFilename, ppDb
16f50 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
16f60 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
16f70 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 PEN_READWRITE |
16f80 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 SQLITE_OPEN_CREA
16f90 54 45 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 TE, 0);.}.int sq
16fa0 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 0a 20 lite3_open_v2(.
16fb0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c const char *fil
16fc0 65 6e 61 6d 65 2c 20 20 20 2f 2a 20 44 61 74 61 ename, /* Data
16fd0 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 28 55 base filename (U
16fe0 54 46 2d 38 29 20 2a 2f 0a 20 20 73 71 6c 69 74 TF-8) */. sqlit
16ff0 65 33 20 2a 2a 70 70 44 62 2c 20 20 20 20 20 20 e3 **ppDb,
17000 20 20 20 2f 2a 20 4f 55 54 3a 20 53 51 4c 69 74 /* OUT: SQLit
17010 65 20 64 62 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 e db handle */.
17020 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 int flags,
17030 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 /* Flag
17040 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 s */. const cha
17050 72 20 2a 7a 56 66 73 20 20 20 20 20 20 20 20 2f r *zVfs /
17060 2a 20 4e 61 6d 65 20 6f 66 20 56 46 53 20 6d 6f * Name of VFS mo
17070 64 75 6c 65 20 74 6f 20 75 73 65 20 2a 2f 0a 29 dule to use */.)
17080 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 {. return openD
17090 61 74 61 62 61 73 65 28 66 69 6c 65 6e 61 6d 65 atabase(filename
170a0 2c 20 70 70 44 62 2c 20 28 75 6e 73 69 67 6e 65 , ppDb, (unsigne
170b0 64 20 69 6e 74 29 66 6c 61 67 73 2c 20 7a 56 66 d int)flags, zVf
170c0 73 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 s);.}..#ifndef S
170d0 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
170e0 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 ./*.** Open a ne
170f0 77 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c w database handl
17100 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
17110 33 5f 6f 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 3_open16(. cons
17120 74 20 76 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d t void *zFilenam
17130 65 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a e, . sqlite3 **
17140 70 70 44 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 ppDb.){. char c
17150 6f 6e 73 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 onst *zFilename8
17160 3b 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 ; /* zFilename
17170 20 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46 2d encoded in UTF-
17180 38 20 69 6e 73 74 65 61 64 20 6f 66 20 55 54 46 8 instead of UTF
17190 2d 31 36 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 -16 */. sqlite3
171a0 5f 76 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 20 20 _value *pVal;.
171b0 69 6e 74 20 72 63 3b 0a 0a 23 69 66 64 65 66 20 int rc;..#ifdef
171c0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
171d0 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 I_ARMOR. if( pp
171e0 44 62 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 Db==0 ) return S
171f0 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
17200 54 3b 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 44 T;.#endif. *ppD
17210 62 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 b = 0;.#ifndef S
17220 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 QLITE_OMIT_AUTOI
17230 4e 49 54 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 NIT. rc = sqlit
17240 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b e3_initialize();
17250 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 . if( rc ) retu
17260 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a 20 20 rn rc;.#endif.
17270 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 if( zFilename==0
17280 20 29 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 ) zFilename = "
17290 5c 30 30 30 5c 30 30 30 22 3b 0a 20 20 70 56 61 \000\000";. pVa
172a0 6c 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 l = sqlite3Value
172b0 4e 65 77 28 30 29 3b 0a 20 20 73 71 6c 69 74 65 New(0);. sqlite
172c0 33 56 61 6c 75 65 53 65 74 53 74 72 28 70 56 61 3ValueSetStr(pVa
172d0 6c 2c 20 2d 31 2c 20 7a 46 69 6c 65 6e 61 6d 65 l, -1, zFilename
172e0 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 , SQLITE_UTF16NA
172f0 54 49 56 45 2c 20 53 51 4c 49 54 45 5f 53 54 41 TIVE, SQLITE_STA
17300 54 49 43 29 3b 0a 20 20 7a 46 69 6c 65 6e 61 6d TIC);. zFilenam
17310 65 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 e8 = sqlite3Valu
17320 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 eText(pVal, SQLI
17330 54 45 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 20 TE_UTF8);. if(
17340 7a 46 69 6c 65 6e 61 6d 65 38 20 29 7b 0a 20 20 zFilename8 ){.
17350 20 20 72 63 20 3d 20 6f 70 65 6e 44 61 74 61 62 rc = openDatab
17360 61 73 65 28 7a 46 69 6c 65 6e 61 6d 65 38 2c 20 ase(zFilename8,
17370 70 70 44 62 2c 0a 20 20 20 20 20 20 20 20 20 20 ppDb,.
17380 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
17390 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
173a0 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f E | SQLITE_OPEN_
173b0 43 52 45 41 54 45 2c 20 30 29 3b 0a 20 20 20 20 CREATE, 0);.
173c0 61 73 73 65 72 74 28 20 2a 70 70 44 62 20 7c 7c assert( *ppDb ||
173d0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc==SQLITE_NOME
173e0 4d 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d M );. if( rc=
173f0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 44 =SQLITE_OK && !D
17400 62 48 61 73 50 72 6f 70 65 72 74 79 28 2a 70 70 bHasProperty(*pp
17410 44 62 2c 20 30 2c 20 44 42 5f 53 63 68 65 6d 61 Db, 0, DB_Schema
17420 4c 6f 61 64 65 64 29 20 29 7b 0a 20 20 20 20 20 Loaded) ){.
17430 20 45 4e 43 28 2a 70 70 44 62 29 20 3d 20 53 51 ENC(*ppDb) = SQ
17440 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
17450 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b ;. }. }else{
17460 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
17470 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71 _NOMEM;. }. sq
17480 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 70 lite3ValueFree(p
17490 56 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 Val);.. return
174a0 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 30 sqlite3ApiExit(0
174b0 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 , rc);.}.#endif
174c0 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
174d0 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
174e0 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f egister a new co
174f0 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
17500 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 with the databa
17510 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f se handle db..*/
17520 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
17530 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 ate_collation(.
17540 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 sqlite3* db, .
17550 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
17560 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 me, . int enc,
17570 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
17580 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
17590 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
175a0 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
175b0 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 void*).){. retu
175c0 72 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 rn sqlite3_creat
175d0 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 64 e_collation_v2(d
175e0 62 2c 20 7a 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 b, zName, enc, p
175f0 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 30 Ctx, xCompare, 0
17600 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 );.}../*.** Regi
17610 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 ster a new colla
17620 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 tion sequence wi
17630 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 th the database
17640 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e handle db..*/.in
17650 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
17660 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 0a 20 _collation_v2(.
17670 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 sqlite3* db, .
17680 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
17690 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 me, . int enc,
176a0 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
176b0 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
176c0 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
176d0 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
176e0 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 28 2a void*),. void(*
176f0 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a xDel)(void*).){.
17700 20 20 69 6e 74 20 72 63 3b 0a 0a 23 69 66 64 65 int rc;..#ifde
17710 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
17720 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
17730 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
17740 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 7a 4e 61 eckOk(db) || zNa
17750 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 me==0 ) return S
17760 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
17770 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 T;.#endif. sqli
17780 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
17790 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
177a0 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
177b0 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 63 20 cFailed );. rc
177c0 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f = createCollatio
177d0 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 28 75 38 n(db, zName, (u8
177e0 29 65 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d )enc, pCtx, xCom
177f0 70 61 72 65 2c 20 78 44 65 6c 29 3b 0a 20 20 72 pare, xDel);. r
17800 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
17810 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
17820 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
17830 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
17840 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 return rc;.}..#i
17850 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
17860 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 T_UTF16./*.** Re
17870 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c gister a new col
17880 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
17890 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
178a0 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a e handle db..*/.
178b0 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 int sqlite3_crea
178c0 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a te_collation16(.
178d0 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a sqlite3* db, .
178e0 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 4e const void *zN
178f0 61 6d 65 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 20 ame,. int enc,
17900 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
17910 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
17920 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
17930 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
17940 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 void*).){. int
17950 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
17960 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 38 3b 0a char *zName8;.
17970 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
17980 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
17990 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
179a0 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
179b0 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 || zName==0 ) re
179c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
179d0 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a SE_BKPT;.#endif.
179e0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
179f0 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
17a00 3b 0a 20 20 61 73 73 65 72 74 28 20 21 64 62 2d ;. assert( !db-
17a10 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b >mallocFailed );
17a20 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 73 71 6c 69 . zName8 = sqli
17a30 74 65 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 te3Utf16to8(db,
17a40 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 zName, -1, SQLIT
17a50 45 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a E_UTF16NATIVE);.
17a60 20 20 69 66 28 20 7a 4e 61 6d 65 38 20 29 7b 0a if( zName8 ){.
17a70 20 20 20 20 72 63 20 3d 20 63 72 65 61 74 65 43 rc = createC
17a80 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 ollation(db, zNa
17a90 6d 65 38 2c 20 28 75 38 29 65 6e 63 2c 20 70 43 me8, (u8)enc, pC
17aa0 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 30 29 tx, xCompare, 0)
17ab0 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 ;. sqlite3DbF
17ac0 72 65 65 28 64 62 2c 20 7a 4e 61 6d 65 38 29 3b ree(db, zName8);
17ad0 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
17ae0 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 te3ApiExit(db, r
17af0 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 c);. sqlite3_mu
17b00 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
17b10 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 tex);. return r
17b20 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 c;.}.#endif /* S
17b30 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
17b40 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 */../*.** Regis
17b50 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 ter a collation
17b60 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 sequence factory
17b70 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 callback with t
17b80 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
17b90 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 le.** db. Replac
17ba0 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 e any previously
17bb0 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 installed colla
17bc0 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 tion sequence fa
17bd0 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ctory..*/.int sq
17be0 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f lite3_collation_
17bf0 6e 65 65 64 65 64 28 0a 20 20 73 71 6c 69 74 65 needed(. sqlite
17c00 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 3 *db, . void *
17c10 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 pCollNeededArg,
17c20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 . void(*xCollNe
17c30 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 eded)(void*,sqli
17c40 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 te3*,int eTextRe
17c50 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 0a 29 p,const char*).)
17c60 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
17c70 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
17c80 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
17c90 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
17ca0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
17cb0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
17cc0 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
17cd0 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
17ce0 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 78 43 6f utex);. db->xCo
17cf0 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c llNeeded = xColl
17d00 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 Needed;. db->xC
17d10 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 30 3b ollNeeded16 = 0;
17d20 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 . db->pCollNeed
17d30 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 edArg = pCollNee
17d40 64 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 dedArg;. sqlite
17d50 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
17d60 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
17d70 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
17d80 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
17d90 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a OMIT_UTF16./*.**
17da0 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c Register a coll
17db0 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 ation sequence f
17dc0 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 actory callback
17dd0 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
17de0 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 e handle.** db.
17df0 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 Replace any prev
17e00 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 iously installed
17e10 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
17e20 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a nce factory..*/.
17e30 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c int sqlite3_coll
17e40 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36 28 0a ation_needed16(.
17e50 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a sqlite3 *db, .
17e60 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 void *pCollNee
17e70 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 dedArg, . void(
17e80 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 28 *xCollNeeded16)(
17e90 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 void*,sqlite3*,i
17ea0 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 nt eTextRep,cons
17eb0 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 23 69 66 64 t void*).){.#ifd
17ec0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
17ed0 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
17ee0 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
17ef0 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 heckOk(db) ) ret
17f00 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
17f10 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 E_BKPT;.#endif.
17f20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
17f30 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
17f40 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 . db->xCollNeed
17f50 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 ed = 0;. db->xC
17f60 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 43 ollNeeded16 = xC
17f70 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 ollNeeded16;. d
17f80 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 b->pCollNeededAr
17f90 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 g = pCollNeededA
17fa0 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
17fb0 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
17fc0 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
17fd0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
17fe0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
17ff0 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 6e T_UTF16 */..#ifn
18000 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
18010 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a DEPRECATED./*.**
18020 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
18030 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 68 72 6f s now an anachro
18040 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 20 74 6f nism. It used to
18050 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f be used to reco
18060 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a 20 6d 61 ver from a.** ma
18070 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2c 20 lloc() failure,
18080 62 75 74 20 53 51 4c 69 74 65 20 6e 6f 77 20 64 but SQLite now d
18090 6f 65 73 20 74 68 69 73 20 61 75 74 6f 6d 61 74 oes this automat
180a0 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 ically..*/.int s
180b0 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 qlite3_global_re
180c0 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a 20 20 72 cover(void){. r
180d0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
180e0 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
180f0 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 68 65 Test to see whe
18100 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
18110 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
18120 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f 63 6f ion is in autoco
18130 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20 20 52 mmit.** mode. R
18140 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 eturn TRUE if it
18150 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20 69 66 is and FALSE if
18160 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 not. Autocommi
18170 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a 2a 20 t mode is on.**
18180 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 75 74 by default. Aut
18190 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73 61 62 ocommit is disab
181a0 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e 20 73 led by a BEGIN s
181b0 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 65 tatement and ree
181c0 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74 68 65 nabled.** by the
181d0 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f 72 20 next COMMIT or
181e0 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2f 0a 69 6e 74 ROLLBACK..*/.int
181f0 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 sqlite3_get_aut
18200 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 ocommit(sqlite3
18210 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *db){.#ifdef SQL
18220 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
18230 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
18240 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
18250 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
18260 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
18270 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
18280 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
18290 20 72 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f return db->auto
182a0 43 6f 6d 6d 69 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Commit;.}../*.**
182b0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 The following r
182c0 6f 75 74 69 6e 65 73 20 61 72 65 20 73 75 62 73 outines are subs
182d0 74 69 74 75 74 65 73 20 66 6f 72 20 63 6f 6e 73 titutes for cons
182e0 74 61 6e 74 73 20 53 51 4c 49 54 45 5f 43 4f 52 tants SQLITE_COR
182f0 52 55 50 54 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f RUPT,.** SQLITE_
18300 4d 49 53 55 53 45 2c 20 53 51 4c 49 54 45 5f 43 MISUSE, SQLITE_C
18310 41 4e 54 4f 50 45 4e 2c 20 53 51 4c 49 54 45 5f ANTOPEN, SQLITE_
18320 49 4f 45 52 52 20 61 6e 64 20 70 6f 73 73 69 62 IOERR and possib
18330 6c 79 20 6f 74 68 65 72 20 65 72 72 6f 72 0a 2a ly other error.*
18340 2a 20 63 6f 6e 73 74 61 6e 74 73 2e 20 20 54 68 * constants. Th
18350 65 79 20 73 65 72 76 65 20 74 77 6f 20 70 75 72 ey serve two pur
18360 70 6f 73 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 poses:.**.** 1
18370 2e 20 20 53 65 72 76 65 20 61 73 20 61 20 63 6f . Serve as a co
18380 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 20 74 nvenient place t
18390 6f 20 73 65 74 20 61 20 62 72 65 61 6b 70 6f 69 o set a breakpoi
183a0 6e 74 20 69 6e 20 61 20 64 65 62 75 67 67 65 72 nt in a debugger
183b0 0a 2a 2a 20 20 20 20 20 20 20 74 6f 20 64 65 74 .** to det
183c0 65 63 74 20 77 68 65 6e 20 76 65 72 73 69 6f 6e ect when version
183d0 20 65 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e error condition
183e0 73 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 s occurs..**.**
183f0 20 20 32 2e 20 20 49 6e 76 6f 6b 65 20 73 71 6c 2. Invoke sql
18400 69 74 65 33 5f 6c 6f 67 28 29 20 74 6f 20 70 72 ite3_log() to pr
18410 6f 76 69 64 65 20 74 68 65 20 73 6f 75 72 63 65 ovide the source
18420 20 63 6f 64 65 20 6c 6f 63 61 74 69 6f 6e 20 77 code location w
18430 68 65 72 65 0a 2a 2a 20 20 20 20 20 20 20 61 20 here.** a
18440 6c 6f 77 2d 6c 65 76 65 6c 20 65 72 72 6f 72 20 low-level error
18450 69 73 20 66 69 72 73 74 20 64 65 74 65 63 74 65 is first detecte
18460 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
18470 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 3CorruptError(in
18480 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 t lineno){. tes
18490 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c tcase( sqlite3Gl
184a0 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 obalConfig.xLog!
184b0 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f =0 );. sqlite3_
184c0 6c 6f 67 28 53 51 4c 49 54 45 5f 43 4f 52 52 55 log(SQLITE_CORRU
184d0 50 54 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 PT,.
184e0 20 20 22 64 61 74 61 62 61 73 65 20 63 6f 72 72 "database corr
184f0 75 70 74 69 6f 6e 20 61 74 20 6c 69 6e 65 20 25 uption at line %
18500 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 d of [%.10s]",.
18510 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e lin
18520 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f eno, 20+sqlite3_
18530 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 sourceid());. r
18540 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
18550 52 55 50 54 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 RUPT;.}.int sqli
18560 74 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 69 te3MisuseError(i
18570 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 nt lineno){. te
18580 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 stcase( sqlite3G
18590 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
185a0 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 !=0 );. sqlite3
185b0 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 4d 49 53 55 _log(SQLITE_MISU
185c0 53 45 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 SE, .
185d0 20 20 20 22 6d 69 73 75 73 65 20 61 74 20 6c 69 "misuse at li
185e0 6e 65 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d ne %d of [%.10s]
185f0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
18600 20 6c 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 lineno, 20+sqli
18610 74 65 33 5f 73 6f 75 72 63 65 69 64 28 29 29 3b te3_sourceid());
18620 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
18630 5f 4d 49 53 55 53 45 3b 0a 7d 0a 69 6e 74 20 73 _MISUSE;.}.int s
18640 71 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 qlite3CantopenEr
18650 72 6f 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b ror(int lineno){
18660 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 71 6c . testcase( sql
18670 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
18680 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 73 71 .xLog!=0 );. sq
18690 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 lite3_log(SQLITE
186a0 5f 43 41 4e 54 4f 50 45 4e 2c 20 0a 20 20 20 20 _CANTOPEN, .
186b0 20 20 20 20 20 20 20 20 20 20 22 63 61 6e 6e 6f "canno
186c0 74 20 6f 70 65 6e 20 66 69 6c 65 20 61 74 20 6c t open file at l
186d0 69 6e 65 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 ine %d of [%.10s
186e0 5d 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ]",.
186f0 20 20 6c 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c lineno, 20+sql
18700 69 74 65 33 5f 73 6f 75 72 63 65 69 64 28 29 29 ite3_sourceid())
18710 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
18720 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 7d 0a 0a 0a E_CANTOPEN;.}...
18730 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
18740 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f MIT_DEPRECATED./
18750 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 *.** This is a c
18760 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 69 onvenience routi
18770 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73 75 ne that makes su
18780 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72 65 re that all thre
18790 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 64 ad-specific.** d
187a0 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68 72 ata for this thr
187b0 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65 61 ead has been dea
187c0 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 llocated..**.**
187d0 53 51 4c 69 74 65 20 6e 6f 20 6c 6f 6e 67 65 72 SQLite no longer
187e0 20 75 73 65 73 20 74 68 72 65 61 64 2d 73 70 65 uses thread-spe
187f0 63 69 66 69 63 20 64 61 74 61 20 73 6f 20 74 68 cific data so th
18800 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f is routine is no
18810 77 20 61 0a 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 49 w a.** no-op. I
18820 74 20 69 73 20 72 65 74 61 69 6e 65 64 20 66 6f t is retained fo
18830 72 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d r historical com
18840 70 61 74 69 62 69 6c 69 74 79 2e 0a 2a 2f 0a 76 patibility..*/.v
18850 6f 69 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 oid sqlite3_thre
18860 61 64 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 ad_cleanup(void)
18870 7b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a {.}.#endif../*.*
18880 2a 20 52 65 74 75 72 6e 20 6d 65 74 61 20 69 6e * Return meta in
18890 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
188a0 61 20 73 70 65 63 69 66 69 63 20 63 6f 6c 75 6d a specific colum
188b0 6e 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 n of a database
188c0 74 61 62 6c 65 2e 0a 2a 2a 20 53 65 65 20 63 6f table..** See co
188d0 6d 6d 65 6e 74 20 69 6e 20 73 71 6c 69 74 65 33 mment in sqlite3
188e0 2e 68 20 28 73 71 6c 69 74 65 2e 68 2e 69 6e 29 .h (sqlite.h.in)
188f0 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f for details..*/
18900 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
18910 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 NABLE_COLUMN_MET
18920 41 44 41 54 41 0a 69 6e 74 20 73 71 6c 69 74 65 ADATA.int sqlite
18930 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 3_table_column_m
18940 65 74 61 64 61 74 61 28 0a 20 20 73 71 6c 69 74 etadata(. sqlit
18950 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 e3 *db,
18960 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 /* Connec
18970 74 69 6f 6e 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 tion handle */.
18980 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 const char *zDb
18990 4e 61 6d 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 Name, /*
189a0 44 61 74 61 62 61 73 65 20 6e 61 6d 65 20 6f 72 Database name or
189b0 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 6f 6e 73 74 NULL */. const
189c0 20 63 68 61 72 20 2a 7a 54 61 62 6c 65 4e 61 6d char *zTableNam
189d0 65 2c 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 e, /* Table
189e0 6e 61 6d 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 name */. const
189f0 63 68 61 72 20 2a 7a 43 6f 6c 75 6d 6e 4e 61 6d char *zColumnNam
18a00 65 2c 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 e, /* Column
18a10 6e 61 6d 65 20 2a 2f 0a 20 20 63 68 61 72 20 63 name */. char c
18a20 6f 6e 73 74 20 2a 2a 70 7a 44 61 74 61 54 79 70 onst **pzDataTyp
18a30 65 2c 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a e, /* OUTPUT:
18a40 20 44 65 63 6c 61 72 65 64 20 64 61 74 61 20 74 Declared data t
18a50 79 70 65 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f ype */. char co
18a60 6e 73 74 20 2a 2a 70 7a 43 6f 6c 6c 53 65 71 2c nst **pzCollSeq,
18a70 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 /* OUTPUT:
18a80 43 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e Collation sequen
18a90 63 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 69 6e 74 ce name */. int
18aa0 20 2a 70 4e 6f 74 4e 75 6c 6c 2c 20 20 20 20 20 *pNotNull,
18ab0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 /* OUTP
18ac0 55 54 3a 20 54 72 75 65 20 69 66 20 4e 4f 54 20 UT: True if NOT
18ad0 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 NULL constraint
18ae0 65 78 69 73 74 73 20 2a 2f 0a 20 20 69 6e 74 20 exists */. int
18af0 2a 70 50 72 69 6d 61 72 79 4b 65 79 2c 20 20 20 *pPrimaryKey,
18b00 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 /* OUTPU
18b10 54 3a 20 54 72 75 65 20 69 66 20 63 6f 6c 75 6d T: True if colum
18b20 6e 20 70 61 72 74 20 6f 66 20 50 4b 20 2a 2f 0a n part of PK */.
18b30 20 20 69 6e 74 20 2a 70 41 75 74 6f 69 6e 63 20 int *pAutoinc
18b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
18b50 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 OUTPUT: True if
18b60 20 63 6f 6c 75 6d 6e 20 69 73 20 61 75 74 6f 2d column is auto-
18b70 69 6e 63 72 65 6d 65 6e 74 20 2a 2f 0a 29 7b 0a increment */.){.
18b80 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 int rc;. char
18b90 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 *zErrMsg = 0;.
18ba0 20 54 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 30 Table *pTab = 0
18bb0 3b 0a 20 20 43 6f 6c 75 6d 6e 20 2a 70 43 6f 6c ;. Column *pCol
18bc0 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 43 6f 6c = 0;. int iCol
18bd0 3b 0a 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 ;.. char const
18be0 2a 7a 44 61 74 61 54 79 70 65 20 3d 20 30 3b 0a *zDataType = 0;.
18bf0 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 43 char const *zC
18c00 6f 6c 6c 53 65 71 20 3d 20 30 3b 0a 20 20 69 6e ollSeq = 0;. in
18c10 74 20 6e 6f 74 6e 75 6c 6c 20 3d 20 30 3b 0a 20 t notnull = 0;.
18c20 20 69 6e 74 20 70 72 69 6d 61 72 79 6b 65 79 20 int primarykey
18c30 3d 20 30 3b 0a 20 20 69 6e 74 20 61 75 74 6f 69 = 0;. int autoi
18c40 6e 63 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 45 6e nc = 0;.. /* En
18c50 73 75 72 65 20 74 68 65 20 64 61 74 61 62 61 73 sure the databas
18c60 65 20 73 63 68 65 6d 61 20 68 61 73 20 62 65 65 e schema has bee
18c70 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a 20 20 73 71 n loaded */. sq
18c80 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
18c90 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
18ca0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
18cb0 72 41 6c 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d rAll(db);. rc =
18cc0 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c sqlite3Init(db,
18cd0 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 &zErrMsg);. if
18ce0 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 ( SQLITE_OK!=rc
18cf0 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f ){. goto erro
18d00 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a r_out;. }.. /*
18d10 20 4c 6f 63 61 74 65 20 74 68 65 20 74 61 62 6c Locate the tabl
18d20 65 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 2a 2f e in question */
18d30 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 . pTab = sqlite
18d40 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 3FindTable(db, z
18d50 54 61 62 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e 61 TableName, zDbNa
18d60 6d 65 29 3b 0a 20 20 69 66 28 20 21 70 54 61 62 me);. if( !pTab
18d70 20 7c 7c 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 || pTab->pSelec
18d80 74 20 29 7b 0a 20 20 20 20 70 54 61 62 20 3d 20 t ){. pTab =
18d90 30 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 0;. goto erro
18da0 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a r_out;. }.. /*
18db0 20 46 69 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e Find the column
18dc0 20 66 6f 72 20 77 68 69 63 68 20 69 6e 66 6f 20 for which info
18dd0 69 73 20 72 65 71 75 65 73 74 65 64 20 2a 2f 0a is requested */.
18de0 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 73 52 if( sqlite3IsR
18df0 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 owid(zColumnName
18e00 29 20 29 7b 0a 20 20 20 20 69 43 6f 6c 20 3d 20 ) ){. iCol =
18e10 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 pTab->iPKey;.
18e20 20 69 66 28 20 69 43 6f 6c 3e 3d 30 20 29 7b 0a if( iCol>=0 ){.
18e30 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 pCol = &pT
18e40 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a ab->aCol[iCol];.
18e50 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
18e60 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20 69 for(iCol=0; i
18e70 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b 20 Col<pTab->nCol;
18e80 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20 70 iCol++){. p
18e90 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 6f Col = &pTab->aCo
18ea0 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 20 69 l[iCol];. i
18eb0 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 53 74 72 f( 0==sqlite3Str
18ec0 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 6d 65 ICmp(pCol->zName
18ed0 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 , zColumnName) )
18ee0 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b {. break;
18ef0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
18f00 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 70 54 61 if( iCol==pTa
18f10 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 20 20 b->nCol ){.
18f20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 20 pTab = 0;.
18f30 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b goto error_out;
18f40 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
18f50 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 The following b
18f60 6c 6f 63 6b 20 73 74 6f 72 65 73 20 74 68 65 20 lock stores the
18f70 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
18f80 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 65 that will be re
18f90 74 75 72 6e 65 64 0a 20 20 2a 2a 20 74 6f 20 74 turned. ** to t
18fa0 68 65 20 63 61 6c 6c 65 72 20 69 6e 20 6c 6f 63 he caller in loc
18fb0 61 6c 20 76 61 72 69 61 62 6c 65 73 20 7a 44 61 al variables zDa
18fc0 74 61 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 65 71 taType, zCollSeq
18fd0 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 6d 61 , notnull, prima
18fe0 72 79 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 20 61 rykey. ** and a
18ff0 75 74 6f 69 6e 63 2e 20 41 74 20 74 68 69 73 20 utoinc. At this
19000 70 6f 69 6e 74 20 74 68 65 72 65 20 61 72 65 20 point there are
19010 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74 69 65 two possibilitie
19020 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 20 20 s:. ** . **
19030 20 20 31 2e 20 54 68 65 20 73 70 65 63 69 66 69 1. The specifi
19040 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 77 ed column name w
19050 61 73 20 72 6f 77 69 64 22 2c 20 22 6f 69 64 22 as rowid", "oid"
19060 20 6f 72 20 22 5f 72 6f 77 69 64 5f 22 20 0a 20 or "_rowid_" .
19070 20 2a 2a 20 20 20 20 20 20 20 20 61 6e 64 20 74 ** and t
19080 68 65 72 65 20 69 73 20 6e 6f 20 65 78 70 6c 69 here is no expli
19090 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 20 49 citly declared I
190a0 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 2a 2a PK column. . **
190b0 0a 20 20 2a 2a 20 20 20 20 20 32 2e 20 54 68 65 . ** 2. The
190c0 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 61 20 table is not a
190d0 76 69 65 77 20 61 6e 64 20 74 68 65 20 63 6f 6c view and the col
190e0 75 6d 6e 20 6e 61 6d 65 20 69 64 65 6e 74 69 66 umn name identif
190f0 69 65 64 20 61 6e 20 0a 20 20 2a 2a 20 20 20 20 ied an . **
19100 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 20 64 explicitly d
19110 65 63 6c 61 72 65 64 20 63 6f 6c 75 6d 6e 2e 20 eclared column.
19120 43 6f 70 79 20 6d 65 74 61 20 69 6e 66 6f 72 6d Copy meta inform
19130 61 74 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 6f 6c ation from *pCol
19140 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 70 43 .. */ . if( pC
19150 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 61 74 61 54 ol ){. zDataT
19160 79 70 65 20 3d 20 70 43 6f 6c 2d 3e 7a 54 79 70 ype = pCol->zTyp
19170 65 3b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 e;. zCollSeq
19180 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 = pCol->zColl;.
19190 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d 20 70 43 6f notnull = pCo
191a0 6c 2d 3e 6e 6f 74 4e 75 6c 6c 21 3d 30 3b 0a 20 l->notNull!=0;.
191b0 20 20 20 70 72 69 6d 61 72 79 6b 65 79 20 20 3d primarykey =
191c0 20 28 70 43 6f 6c 2d 3e 63 6f 6c 46 6c 61 67 73 (pCol->colFlags
191d0 20 26 20 43 4f 4c 46 4c 41 47 5f 50 52 49 4d 4b & COLFLAG_PRIMK
191e0 45 59 29 21 3d 30 3b 0a 20 20 20 20 61 75 74 6f EY)!=0;. auto
191f0 69 6e 63 20 3d 20 70 54 61 62 2d 3e 69 50 4b 65 inc = pTab->iPKe
19200 79 3d 3d 69 43 6f 6c 20 26 26 20 28 70 54 61 62 y==iCol && (pTab
19210 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f ->tabFlags & TF_
19220 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 29 21 3d Autoincrement)!=
19230 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 0;. }else{.
19240 7a 44 61 74 61 54 79 70 65 20 3d 20 22 49 4e 54 zDataType = "INT
19250 45 47 45 52 22 3b 0a 20 20 20 20 70 72 69 6d 61 EGER";. prima
19260 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 7d 0a 20 rykey = 1;. }.
19270 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 71 20 29 if( !zCollSeq )
19280 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 3d {. zCollSeq =
19290 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 7d 0a 0a "BINARY";. }..
192a0 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 73 71 6c error_out:. sql
192b0 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c ite3BtreeLeaveAl
192c0 6c 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 57 68 65 l(db);.. /* Whe
192d0 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 6f ther the functio
192e0 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 64 n call succeeded
192f0 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 20 or failed, set
19300 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 6d the output param
19310 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 68 eters. ** to wh
19320 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f 63 atever their loc
19330 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 20 al counterparts
19340 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 65 contain. If an e
19350 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c 0a rror did occur,.
19360 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 68 ** this has th
19370 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 6f e effect of zero
19380 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 70 ing all output p
19390 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f 0a arameters.. */.
193a0 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 65 if( pzDataType
193b0 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 3d ) *pzDataType =
193c0 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 66 zDataType;. if
193d0 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a 70 ( pzCollSeq ) *p
193e0 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c 6c zCollSeq = zColl
193f0 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 4e Seq;. if( pNotN
19400 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c 20 ull ) *pNotNull
19410 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 28 = notnull;. if(
19420 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 2a pPrimaryKey ) *
19430 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 72 pPrimaryKey = pr
19440 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 20 imarykey;. if(
19450 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 74 pAutoinc ) *pAut
19460 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b 0a oinc = autoinc;.
19470 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
19480 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 7b ==rc && !pTab ){
19490 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
194a0 65 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b ee(db, zErrMsg);
194b0 0a 20 20 20 20 7a 45 72 72 4d 73 67 20 3d 20 73 . zErrMsg = s
194c0 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 qlite3MPrintf(db
194d0 2c 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 , "no such table
194e0 20 63 6f 6c 75 6d 6e 3a 20 25 73 2e 25 73 22 2c column: %s.%s",
194f0 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 0a 20 20 20 zTableName,.
19500 20 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 zColumnName
19510 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 );. rc = SQLI
19520 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 TE_ERROR;. }.
19530 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 sqlite3ErrorWith
19540 4d 73 67 28 64 62 2c 20 72 63 2c 20 28 7a 45 72 Msg(db, rc, (zEr
19550 72 4d 73 67 3f 22 25 73 22 3a 30 29 2c 20 7a 45 rMsg?"%s":0), zE
19560 72 72 4d 73 67 29 3b 0a 20 20 73 71 6c 69 74 65 rrMsg);. sqlite
19570 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72 72 3DbFree(db, zErr
19580 4d 73 67 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c Msg);. rc = sql
19590 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 ite3ApiExit(db,
195a0 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc);. sqlite3_m
195b0 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
195c0 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
195d0 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a rc;.}.#endif../*
195e0 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72 20 61 20 .** Sleep for a
195f0 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e 20 20 52 little while. R
19600 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75 6e 74 eturn the amount
19610 20 6f 66 20 74 69 6d 65 20 73 6c 65 70 74 2e 0a of time slept..
19620 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 */.int sqlite3_s
19630 6c 65 65 70 28 69 6e 74 20 6d 73 29 7b 0a 20 20 leep(int ms){.
19640 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 sqlite3_vfs *pVf
19650 73 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 s;. int rc;. p
19660 56 66 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 66 Vfs = sqlite3_vf
19670 73 5f 66 69 6e 64 28 30 29 3b 0a 20 20 69 66 28 s_find(0);. if(
19680 20 70 56 66 73 3d 3d 30 20 29 20 72 65 74 75 72 pVfs==0 ) retur
19690 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 n 0;.. /* This
196a0 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 69 function works i
196b0 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 2c 20 n milliseconds,
196c0 62 75 74 20 74 68 65 20 75 6e 64 65 72 6c 79 69 but the underlyi
196d0 6e 67 20 4f 73 53 6c 65 65 70 28 29 20 0a 20 20 ng OsSleep() .
196e0 2a 2a 20 41 50 49 20 75 73 65 73 20 6d 69 63 72 ** API uses micr
196f0 6f 73 65 63 6f 6e 64 73 2e 20 48 65 6e 63 65 20 oseconds. Hence
19700 74 68 65 20 31 30 30 30 27 73 2e 0a 20 20 2a 2f the 1000's.. */
19710 0a 20 20 72 63 20 3d 20 28 73 71 6c 69 74 65 33 . rc = (sqlite3
19720 4f 73 53 6c 65 65 70 28 70 56 66 73 2c 20 31 30 OsSleep(pVfs, 10
19730 30 30 2a 6d 73 29 2f 31 30 30 30 29 3b 0a 20 20 00*ms)/1000);.
19740 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
19750 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 .** Enable or di
19760 73 61 62 6c 65 20 74 68 65 20 65 78 74 65 6e 64 sable the extend
19770 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 73 2e ed result codes.
19780 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
19790 65 78 74 65 6e 64 65 64 5f 72 65 73 75 6c 74 5f extended_result_
197a0 63 6f 64 65 73 28 73 71 6c 69 74 65 33 20 2a 64 codes(sqlite3 *d
197b0 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 7b 0a 23 b, int onoff){.#
197c0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
197d0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
197e0 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
197f0 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 tyCheckOk(db) )
19800 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
19810 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
19820 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
19830 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
19840 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 x);. db->errMas
19850 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 30 78 66 66 k = onoff ? 0xff
19860 66 66 66 66 66 66 20 3a 20 30 78 66 66 3b 0a 20 ffffff : 0xff;.
19870 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
19880 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
19890 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
198a0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e _OK;.}../*.** In
198b0 76 6f 6b 65 20 74 68 65 20 78 46 69 6c 65 43 6f voke the xFileCo
198c0 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 6f 6e 20 ntrol method on
198d0 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 a particular dat
198e0 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 abase..*/.int sq
198f0 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
19900 6f 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 ol(sqlite3 *db,
19910 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e const char *zDbN
19920 61 6d 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69 ame, int op, voi
19930 64 20 2a 70 41 72 67 29 7b 0a 20 20 69 6e 74 20 d *pArg){. int
19940 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
19950 52 3b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 R;. Btree *pBtr
19960 65 65 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ee;..#ifdef SQLI
19970 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
19980 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
19990 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
199a0 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c db) ) return SQL
199b0 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
199c0 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
199d0 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
199e0 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 42 74 72 ->mutex);. pBtr
199f0 65 65 20 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 ee = sqlite3DbNa
19a00 6d 65 54 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 meToBtree(db, zD
19a10 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 42 bName);. if( pB
19a20 74 72 65 65 20 29 7b 0a 20 20 20 20 50 61 67 65 tree ){. Page
19a30 72 20 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 73 r *pPager;. s
19a40 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b qlite3_file *fd;
19a50 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
19a60 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a eEnter(pBtree);.
19a70 20 20 20 20 70 50 61 67 65 72 20 3d 20 73 71 6c pPager = sql
19a80 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
19a90 42 74 72 65 65 29 3b 0a 20 20 20 20 61 73 73 65 Btree);. asse
19aa0 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 29 3b rt( pPager!=0 );
19ab0 0a 20 20 20 20 66 64 20 3d 20 73 71 6c 69 74 65 . fd = sqlite
19ac0 33 50 61 67 65 72 46 69 6c 65 28 70 50 61 67 65 3PagerFile(pPage
19ad0 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 r);. assert(
19ae0 66 64 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 fd!=0 );. if(
19af0 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 46 43 4e 54 op==SQLITE_FCNT
19b00 4c 5f 46 49 4c 45 5f 50 4f 49 4e 54 45 52 20 29 L_FILE_POINTER )
19b10 7b 0a 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 {. *(sqlite
19b20 33 5f 66 69 6c 65 2a 2a 29 70 41 72 67 20 3d 20 3_file**)pArg =
19b30 66 64 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 fd;. rc = S
19b40 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 QLITE_OK;. }e
19b50 6c 73 65 20 69 66 28 20 66 64 2d 3e 70 4d 65 74 lse if( fd->pMet
19b60 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 72 63 hods ){. rc
19b70 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
19b80 43 6f 6e 74 72 6f 6c 28 66 64 2c 20 6f 70 2c 20 Control(fd, op,
19b90 70 41 72 67 29 3b 0a 20 20 20 20 7d 65 6c 73 65 pArg);. }else
19ba0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
19bb0 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 20 20 ITE_NOTFOUND;.
19bc0 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 }. sqlite3B
19bd0 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 treeLeave(pBtree
19be0 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
19bf0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
19c00 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
19c10 6e 20 72 63 3b 20 20 20 0a 7d 0a 0a 2f 2a 0a 2a n rc; .}../*.*
19c20 2a 20 49 6e 74 65 72 66 61 63 65 20 74 6f 20 74 * Interface to t
19c30 68 65 20 74 65 73 74 69 6e 67 20 6c 6f 67 69 63 he testing logic
19c40 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
19c50 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 69 6e _test_control(in
19c60 74 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 69 6e t op, ...){. in
19c70 74 20 72 63 20 3d 20 30 3b 0a 23 69 66 6e 64 65 t rc = 0;.#ifnde
19c80 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 f SQLITE_OMIT_BU
19c90 49 4c 54 49 4e 5f 54 45 53 54 0a 20 20 76 61 5f ILTIN_TEST. va_
19ca0 6c 69 73 74 20 61 70 3b 0a 20 20 76 61 5f 73 74 list ap;. va_st
19cb0 61 72 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 art(ap, op);. s
19cc0 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 witch( op ){..
19cd0 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 53 61 76 65 /*. ** Save
19ce0 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 74 61 the current sta
19cf0 74 65 20 6f 66 20 74 68 65 20 50 52 4e 47 2e 0a te of the PRNG..
19d00 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
19d10 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
19d20 50 52 4e 47 5f 53 41 56 45 3a 20 7b 0a 20 20 20 PRNG_SAVE: {.
19d30 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 53 61 sqlite3PrngSa
19d40 76 65 53 74 61 74 65 28 29 3b 0a 20 20 20 20 20 veState();.
19d50 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
19d60 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 52 65 73 /*. ** Res
19d70 74 6f 72 65 20 74 68 65 20 73 74 61 74 65 20 6f tore the state o
19d80 66 20 74 68 65 20 50 52 4e 47 20 74 6f 20 74 68 f the PRNG to th
19d90 65 20 6c 61 73 74 20 73 74 61 74 65 20 73 61 76 e last state sav
19da0 65 64 20 75 73 69 6e 67 0a 20 20 20 20 2a 2a 20 ed using. **
19db0 50 52 4e 47 5f 53 41 56 45 2e 20 20 49 66 20 50 PRNG_SAVE. If P
19dc0 52 4e 47 5f 53 41 56 45 20 68 61 73 20 6e 65 76 RNG_SAVE has nev
19dd0 65 72 20 62 65 66 6f 72 65 20 62 65 65 6e 20 63 er before been c
19de0 61 6c 6c 65 64 2c 20 74 68 65 6e 0a 20 20 20 20 alled, then.
19df0 2a 2a 20 74 68 69 73 20 76 65 72 62 20 61 63 74 ** this verb act
19e00 73 20 6c 69 6b 65 20 50 52 4e 47 5f 52 45 53 45 s like PRNG_RESE
19e10 54 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 T.. */. ca
19e20 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
19e30 52 4c 5f 50 52 4e 47 5f 52 45 53 54 4f 52 45 3a RL_PRNG_RESTORE:
19e40 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
19e50 50 72 6e 67 52 65 73 74 6f 72 65 53 74 61 74 65 PrngRestoreState
19e60 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b ();. break;
19e70 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 . }.. /*.
19e80 20 20 20 2a 2a 20 52 65 73 65 74 20 74 68 65 20 ** Reset the
19e90 50 52 4e 47 20 62 61 63 6b 20 74 6f 20 69 74 73 PRNG back to its
19ea0 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 73 uninitialized s
19eb0 74 61 74 65 2e 20 20 54 68 65 20 6e 65 78 74 20 tate. The next
19ec0 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 73 call. ** to s
19ed0 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 qlite3_randomnes
19ee0 73 28 29 20 77 69 6c 6c 20 72 65 73 65 65 64 20 s() will reseed
19ef0 74 68 65 20 50 52 4e 47 20 75 73 69 6e 67 20 61 the PRNG using a
19f00 20 73 69 6e 67 6c 65 20 63 61 6c 6c 0a 20 20 20 single call.
19f10 20 2a 2a 20 74 6f 20 74 68 65 20 78 52 61 6e 64 ** to the xRand
19f20 6f 6d 6e 65 73 73 20 6d 65 74 68 6f 64 20 6f 66 omness method of
19f30 20 74 68 65 20 64 65 66 61 75 6c 74 20 56 46 53 the default VFS
19f40 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
19f50 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
19f60 4c 5f 50 52 4e 47 5f 52 45 53 45 54 3a 20 7b 0a L_PRNG_RESET: {.
19f70 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 61 sqlite3_ra
19f80 6e 64 6f 6d 6e 65 73 73 28 30 2c 30 29 3b 0a 20 ndomness(0,0);.
19f90 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
19fa0 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a }.. /*. **
19fb0 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 sqlite3_test_c
19fc0 6f 6e 74 72 6f 6c 28 42 49 54 56 45 43 5f 54 45 ontrol(BITVEC_TE
19fd0 53 54 2c 20 73 69 7a 65 2c 20 70 72 6f 67 72 61 ST, size, progra
19fe0 6d 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a m). **. **
19ff0 20 52 75 6e 20 61 20 74 65 73 74 20 61 67 61 69 Run a test agai
1a000 6e 73 74 20 61 20 42 69 74 76 65 63 20 6f 62 6a nst a Bitvec obj
1a010 65 63 74 20 6f 66 20 73 69 7a 65 2e 20 20 54 68 ect of size. Th
1a020 65 20 70 72 6f 67 72 61 6d 20 61 72 67 75 6d 65 e program argume
1a030 6e 74 0a 20 20 20 20 2a 2a 20 69 73 20 61 6e 20 nt. ** is an
1a040 61 72 72 61 79 20 6f 66 20 69 6e 74 65 67 65 72 array of integer
1a050 73 20 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 s that defines t
1a060 68 65 20 74 65 73 74 2e 20 20 52 65 74 75 72 6e he test. Return
1a070 20 2d 31 20 6f 6e 20 61 0a 20 20 20 20 2a 2a 20 -1 on a. **
1a080 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
1a090 6e 20 65 72 72 6f 72 2c 20 30 20 6f 6e 20 73 75 n error, 0 on su
1a0a0 63 63 65 73 73 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 ccess, or non-ze
1a0b0 72 6f 20 66 6f 72 20 61 6e 20 65 72 72 6f 72 2e ro for an error.
1a0c0 0a 20 20 20 20 2a 2a 20 53 65 65 20 74 68 65 20 . ** See the
1a0d0 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 69 sqlite3BitvecBui
1a0e0 6c 74 69 6e 54 65 73 74 28 29 20 66 6f 72 20 61 ltinTest() for a
1a0f0 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d dditional inform
1a100 61 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 ation.. */.
1a110 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 case SQLITE_TE
1a120 53 54 43 54 52 4c 5f 42 49 54 56 45 43 5f 54 45 STCTRL_BITVEC_TE
1a130 53 54 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 ST: {. int
1a140 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 sz = va_arg(ap,
1a150 69 6e 74 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 int);. int
1a160 2a 61 50 72 6f 67 20 3d 20 76 61 5f 61 72 67 28 *aProg = va_arg(
1a170 61 70 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 20 20 ap, int*);.
1a180 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 69 74 rc = sqlite3Bit
1a190 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 28 73 vecBuiltinTest(s
1a1a0 7a 2c 20 61 50 72 6f 67 29 3b 0a 20 20 20 20 20 z, aProg);.
1a1b0 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
1a1c0 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 /*. ** sq
1a1d0 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 lite3_test_contr
1a1e0 6f 6c 28 46 41 55 4c 54 5f 49 4e 53 54 41 4c 4c ol(FAULT_INSTALL
1a1f0 2c 20 78 43 61 6c 6c 62 61 63 6b 29 0a 20 20 20 , xCallback).
1a200 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 72 72 61 6e **. ** Arran
1a210 67 65 20 74 6f 20 69 6e 76 6f 6b 65 20 78 43 61 ge to invoke xCa
1a220 6c 6c 62 61 63 6b 28 29 20 77 68 65 6e 65 76 65 llback() wheneve
1a230 72 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 69 r sqlite3FaultSi
1a240 6d 28 29 20 69 73 20 63 61 6c 6c 65 64 2c 0a 20 m() is called,.
1a250 20 20 20 2a 2a 20 69 66 20 78 43 61 6c 6c 62 61 ** if xCallba
1a260 63 6b 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2e 0a ck is not NULL..
1a270 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 73 **. ** As
1a280 20 61 20 74 65 73 74 20 6f 66 20 74 68 65 20 66 a test of the f
1a290 61 75 6c 74 20 73 69 6d 75 6c 61 74 6f 72 20 6d ault simulator m
1a2a0 65 63 68 61 6e 69 73 6d 20 69 74 73 65 6c 66 2c echanism itself,
1a2b0 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d sqlite3FaultSim
1a2c0 28 30 29 0a 20 20 20 20 2a 2a 20 69 73 20 63 61 (0). ** is ca
1a2d0 6c 6c 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 lled immediately
1a2e0 20 61 66 74 65 72 20 69 6e 73 74 61 6c 6c 69 6e after installin
1a2f0 67 20 74 68 65 20 6e 65 77 20 63 61 6c 6c 62 61 g the new callba
1a300 63 6b 20 61 6e 64 20 74 68 65 20 72 65 74 75 72 ck and the retur
1a310 6e 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 20 66 n. ** value f
1a320 72 6f 6d 20 73 71 6c 69 74 65 33 46 61 75 6c 74 rom sqlite3Fault
1a330 53 69 6d 28 30 29 20 62 65 63 6f 6d 65 73 20 74 Sim(0) becomes t
1a340 68 65 20 72 65 74 75 72 6e 20 66 72 6f 6d 0a 20 he return from.
1a350 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 74 65 ** sqlite3_te
1a360 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 2e 0a 20 20 st_control()..
1a370 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
1a380 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 46 41 LITE_TESTCTRL_FA
1a390 55 4c 54 5f 49 4e 53 54 41 4c 4c 3a 20 7b 0a 20 ULT_INSTALL: {.
1a3a0 20 20 20 20 20 2f 2a 20 4d 53 56 43 20 69 73 20 /* MSVC is
1a3b0 70 69 63 6b 79 20 61 62 6f 75 74 20 70 75 6c 6c picky about pull
1a3c0 69 6e 67 20 66 75 6e 63 20 70 74 72 73 20 66 72 ing func ptrs fr
1a3d0 6f 6d 20 76 61 20 6c 69 73 74 73 2e 0a 20 20 20 om va lists..
1a3e0 20 20 20 2a 2a 20 68 74 74 70 3a 2f 2f 73 75 70 ** http://sup
1a3f0 70 6f 72 74 2e 6d 69 63 72 6f 73 6f 66 74 2e 63 port.microsoft.c
1a400 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a 20 20 20 20 om/kb/47961.
1a410 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c 6f 62 ** sqlite3Glob
1a420 61 6c 43 6f 6e 66 69 67 2e 78 54 65 73 74 43 61 alConfig.xTestCa
1a430 6c 6c 62 61 63 6b 20 3d 20 76 61 5f 61 72 67 28 llback = va_arg(
1a440 61 70 2c 20 69 6e 74 28 2a 29 28 69 6e 74 29 29 ap, int(*)(int))
1a450 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 ;. */.
1a460 20 74 79 70 65 64 65 66 20 69 6e 74 28 2a 54 45 typedef int(*TE
1a470 53 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 5f 74 STCALLBACKFUNC_t
1a480 29 28 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 )(int);. sq
1a490 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1a4a0 67 2e 78 54 65 73 74 43 61 6c 6c 62 61 63 6b 20 g.xTestCallback
1a4b0 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 54 45 53 = va_arg(ap, TES
1a4c0 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 5f 74 29 TCALLBACKFUNC_t)
1a4d0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
1a4e0 69 74 65 33 46 61 75 6c 74 53 69 6d 28 30 29 3b ite3FaultSim(0);
1a4f0 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1a500 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
1a510 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 ** sqlite3_test
1a520 5f 63 6f 6e 74 72 6f 6c 28 42 45 4e 49 47 4e 5f _control(BENIGN_
1a530 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 2c 20 78 42 MALLOC_HOOKS, xB
1a540 65 67 69 6e 2c 20 78 45 6e 64 29 0a 20 20 20 20 egin, xEnd).
1a550 2a 2a 0a 20 20 20 20 2a 2a 20 52 65 67 69 73 74 **. ** Regist
1a560 65 72 20 68 6f 6f 6b 73 20 74 6f 20 63 61 6c 6c er hooks to call
1a570 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 68 69 to indicate whi
1a580 63 68 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c ch malloc() fail
1a590 75 72 65 73 20 0a 20 20 20 20 2a 2a 20 61 72 65 ures . ** are
1a5a0 20 62 65 6e 69 67 6e 2e 0a 20 20 20 20 2a 2f 0a benign.. */.
1a5b0 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1a5c0 54 45 53 54 43 54 52 4c 5f 42 45 4e 49 47 4e 5f TESTCTRL_BENIGN_
1a5d0 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 3a 20 7b 0a MALLOC_HOOKS: {.
1a5e0 20 20 20 20 20 20 74 79 70 65 64 65 66 20 76 6f typedef vo
1a5f0 69 64 20 28 2a 76 6f 69 64 5f 66 75 6e 63 74 69 id (*void_functi
1a600 6f 6e 29 28 76 6f 69 64 29 3b 0a 20 20 20 20 20 on)(void);.
1a610 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 20 78 void_function x
1a620 42 65 6e 69 67 6e 42 65 67 69 6e 3b 0a 20 20 20 BenignBegin;.
1a630 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e void_function
1a640 20 78 42 65 6e 69 67 6e 45 6e 64 3b 0a 20 20 20 xBenignEnd;.
1a650 20 20 20 78 42 65 6e 69 67 6e 42 65 67 69 6e 20 xBenignBegin
1a660 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
1a670 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 20 20 d_function);.
1a680 20 20 20 78 42 65 6e 69 67 6e 45 6e 64 20 3d 20 xBenignEnd =
1a690 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 5f va_arg(ap, void_
1a6a0 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 20 20 20 20 function);.
1a6b0 20 73 71 6c 69 74 65 33 42 65 6e 69 67 6e 4d 61 sqlite3BenignMa
1a6c0 6c 6c 6f 63 48 6f 6f 6b 73 28 78 42 65 6e 69 67 llocHooks(xBenig
1a6d0 6e 42 65 67 69 6e 2c 20 78 42 65 6e 69 67 6e 45 nBegin, xBenignE
1a6e0 6e 64 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nd);. break
1a6f0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a ;. }.. /*.
1a700 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
1a710 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1a720 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 45 4e ITE_TESTCTRL_PEN
1a730 44 49 4e 47 5f 42 59 54 45 2c 20 75 6e 73 69 67 DING_BYTE, unsig
1a740 6e 65 64 20 69 6e 74 20 58 29 0a 20 20 20 20 2a ned int X). *
1a750 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 68 65 *. ** Set the
1a760 20 50 45 4e 44 49 4e 47 20 62 79 74 65 20 74 6f PENDING byte to
1a770 20 74 68 65 20 76 61 6c 75 65 20 69 6e 20 74 68 the value in th
1a780 65 20 61 72 67 75 6d 65 6e 74 2c 20 69 66 20 58 e argument, if X
1a790 3e 30 2e 0a 20 20 20 20 2a 2a 20 4d 61 6b 65 20 >0.. ** Make
1a7a0 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 20 58 3d no changes if X=
1a7b0 3d 30 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 =0. Return the
1a7c0 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 65 6e value of the pen
1a7d0 64 69 6e 67 20 62 79 74 65 0a 20 20 20 20 2a 2a ding byte. **
1a7e0 20 61 73 20 69 74 20 65 78 69 73 74 69 6e 67 20 as it existing
1a7f0 62 65 66 6f 72 65 20 74 68 69 73 20 72 6f 75 74 before this rout
1a800 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 64 2e 0a ine was called..
1a810 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 4d **. ** IM
1a820 50 4f 52 54 41 4e 54 3a 20 20 43 68 61 6e 67 69 PORTANT: Changi
1a830 6e 67 20 74 68 65 20 50 45 4e 44 49 4e 47 20 62 ng the PENDING b
1a840 79 74 65 20 66 72 6f 6d 20 30 78 34 30 30 30 30 yte from 0x40000
1a850 30 30 30 20 72 65 73 75 6c 74 73 20 69 6e 0a 20 000 results in.
1a860 20 20 20 2a 2a 20 61 6e 20 69 6e 63 6f 6d 70 61 ** an incompa
1a870 74 69 62 6c 65 20 64 61 74 61 62 61 73 65 20 66 tible database f
1a880 69 6c 65 20 66 6f 72 6d 61 74 2e 20 20 43 68 61 ile format. Cha
1a890 6e 67 69 6e 67 20 74 68 65 20 50 45 4e 44 49 4e nging the PENDIN
1a8a0 47 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 77 68 G byte. ** wh
1a8b0 69 6c 65 20 61 6e 79 20 64 61 74 61 62 61 73 65 ile any database
1a8c0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f connection is o
1a8d0 70 65 6e 20 72 65 73 75 6c 74 73 20 69 6e 20 75 pen results in u
1a8e0 6e 64 65 66 69 6e 65 64 20 61 6e 64 0a 20 20 20 ndefined and.
1a8f0 20 2a 2a 20 64 65 6c 65 74 65 72 69 6f 75 73 20 ** deleterious
1a900 62 65 68 61 76 69 6f 72 2e 0a 20 20 20 20 2a 2f behavior.. */
1a910 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1a920 5f 54 45 53 54 43 54 52 4c 5f 50 45 4e 44 49 4e _TESTCTRL_PENDIN
1a930 47 5f 42 59 54 45 3a 20 7b 0a 20 20 20 20 20 20 G_BYTE: {.
1a940 72 63 20 3d 20 50 45 4e 44 49 4e 47 5f 42 59 54 rc = PENDING_BYT
1a950 45 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 E;.#ifndef SQLIT
1a960 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 20 20 20 E_OMIT_WSD.
1a970 20 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 69 67 {. unsig
1a980 6e 65 64 20 69 6e 74 20 6e 65 77 56 61 6c 20 3d ned int newVal =
1a990 20 76 61 5f 61 72 67 28 61 70 2c 20 75 6e 73 69 va_arg(ap, unsi
1a9a0 67 6e 65 64 20 69 6e 74 29 3b 0a 20 20 20 20 20 gned int);.
1a9b0 20 20 20 69 66 28 20 6e 65 77 56 61 6c 20 29 20 if( newVal )
1a9c0 73 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 42 79 sqlite3PendingBy
1a9d0 74 65 20 3d 20 6e 65 77 56 61 6c 3b 0a 20 20 20 te = newVal;.
1a9e0 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
1a9f0 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
1aa00 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
1aa10 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1aa20 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
1aa30 54 52 4c 5f 41 53 53 45 52 54 2c 20 69 6e 74 20 TRL_ASSERT, int
1aa40 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a X). **. **
1aa50 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 72 6f This action pro
1aa60 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 6d 65 vides a run-time
1aa70 20 74 65 73 74 20 74 6f 20 73 65 65 20 77 68 65 test to see whe
1aa80 74 68 65 72 20 6f 72 20 6e 6f 74 0a 20 20 20 20 ther or not.
1aa90 2a 2a 20 61 73 73 65 72 74 28 29 20 77 61 73 20 ** assert() was
1aaa0 65 6e 61 62 6c 65 64 20 61 74 20 63 6f 6d 70 69 enabled at compi
1aab0 6c 65 2d 74 69 6d 65 2e 20 20 49 66 20 58 20 69 le-time. If X i
1aac0 73 20 74 72 75 65 20 61 6e 64 20 61 73 73 65 72 s true and asser
1aad0 74 28 29 0a 20 20 20 20 2a 2a 20 69 73 20 65 6e t(). ** is en
1aae0 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 abled, then the
1aaf0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1ab00 74 72 75 65 2e 20 20 49 66 20 58 20 69 73 20 74 true. If X is t
1ab10 72 75 65 20 61 6e 64 0a 20 20 20 20 2a 2a 20 61 rue and. ** a
1ab20 73 73 65 72 74 28 29 20 69 73 20 64 69 73 61 62 ssert() is disab
1ab30 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 72 65 led, then the re
1ab40 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 7a 65 turn value is ze
1ab50 72 6f 2e 20 20 49 66 20 58 20 69 73 0a 20 20 20 ro. If X is.
1ab60 20 2a 2a 20 66 61 6c 73 65 20 61 6e 64 20 61 73 ** false and as
1ab70 73 65 72 74 28 29 20 69 73 20 65 6e 61 62 6c 65 sert() is enable
1ab80 64 2c 20 74 68 65 6e 20 74 68 65 20 61 73 73 65 d, then the asse
1ab90 72 74 69 6f 6e 20 66 69 72 65 73 20 61 6e 64 20 rtion fires and
1aba0 74 68 65 0a 20 20 20 20 2a 2a 20 70 72 6f 63 65 the. ** proce
1abb0 73 73 20 61 62 6f 72 74 73 2e 20 20 49 66 20 58 ss aborts. If X
1abc0 20 69 73 20 66 61 6c 73 65 20 61 6e 64 20 61 73 is false and as
1abd0 73 65 72 74 28 29 20 69 73 20 64 69 73 61 62 6c sert() is disabl
1abe0 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 20 ed, then the.
1abf0 20 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c 75 65 ** return value
1ac00 20 69 73 20 7a 65 72 6f 2e 0a 20 20 20 20 2a 2f is zero.. */
1ac10 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1ac20 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 _TESTCTRL_ASSERT
1ac30 3a 20 7b 0a 20 20 20 20 20 20 76 6f 6c 61 74 69 : {. volati
1ac40 6c 65 20 69 6e 74 20 78 20 3d 20 30 3b 0a 20 20 le int x = 0;.
1ac50 20 20 20 20 61 73 73 65 72 74 28 20 28 78 20 3d assert( (x =
1ac60 20 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 29 va_arg(ap,int))
1ac70 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20 !=0 );. rc
1ac80 3d 20 78 3b 0a 20 20 20 20 20 20 62 72 65 61 6b = x;. break
1ac90 3b 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 20 2f 2a ;. }... /*
1aca0 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 . ** sqlite3
1acb0 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 _test_control(SQ
1acc0 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c LITE_TESTCTRL_AL
1acd0 57 41 59 53 2c 20 69 6e 74 20 58 29 0a 20 20 20 WAYS, int X).
1ace0 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 **. ** This
1acf0 61 63 74 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 action provides
1ad00 61 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 20 a run-time test
1ad10 74 6f 20 73 65 65 20 68 6f 77 20 74 68 65 20 41 to see how the A
1ad20 4c 57 41 59 53 20 61 6e 64 0a 20 20 20 20 2a 2a LWAYS and. **
1ad30 20 4e 45 56 45 52 20 6d 61 63 72 6f 73 20 77 65 NEVER macros we
1ad40 72 65 20 64 65 66 69 6e 65 64 20 61 74 20 63 6f re defined at co
1ad50 6d 70 69 6c 65 2d 74 69 6d 65 2e 0a 20 20 20 20 mpile-time..
1ad60 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 65 **. ** The re
1ad70 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 41 4c turn value is AL
1ad80 57 41 59 53 28 58 29 2e 20 20 0a 20 20 20 20 2a WAYS(X). . *
1ad90 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 65 63 *. ** The rec
1ada0 6f 6d 6d 65 6e 64 65 64 20 74 65 73 74 20 69 73 ommended test is
1adb0 20 58 3d 3d 32 2e 20 20 49 66 20 74 68 65 20 72 X==2. If the r
1adc0 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 32 eturn value is 2
1add0 2c 20 74 68 61 74 20 6d 65 61 6e 73 0a 20 20 20 , that means.
1ade0 20 2a 2a 20 41 4c 57 41 59 53 28 29 20 61 6e 64 ** ALWAYS() and
1adf0 20 4e 45 56 45 52 28 29 20 61 72 65 20 62 6f 74 NEVER() are bot
1ae00 68 20 6e 6f 2d 6f 70 20 70 61 73 73 2d 74 68 72 h no-op pass-thr
1ae10 6f 75 67 68 20 6d 61 63 72 6f 73 2c 20 77 68 69 ough macros, whi
1ae20 63 68 20 69 73 20 74 68 65 0a 20 20 20 20 2a 2a ch is the. **
1ae30 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 default setting
1ae40 2e 20 20 49 66 20 74 68 65 20 72 65 74 75 72 6e . If the return
1ae50 20 76 61 6c 75 65 20 69 73 20 31 2c 20 74 68 65 value is 1, the
1ae60 6e 20 41 4c 57 41 59 53 28 29 20 69 73 20 65 69 n ALWAYS() is ei
1ae70 74 68 65 72 0a 20 20 20 20 2a 2a 20 68 61 72 64 ther. ** hard
1ae80 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 65 20 6f -coded to true o
1ae90 72 20 65 6c 73 65 20 69 74 20 61 73 73 65 72 74 r else it assert
1aea0 73 20 69 66 20 69 74 73 20 61 72 67 75 6d 65 6e s if its argumen
1aeb0 74 20 69 73 20 66 61 6c 73 65 2e 0a 20 20 20 20 t is false..
1aec0 2a 2a 20 54 68 65 20 66 69 72 73 74 20 62 65 68 ** The first beh
1aed0 61 76 69 6f 72 20 28 68 61 72 64 2d 63 6f 64 65 avior (hard-code
1aee0 64 20 74 6f 20 74 72 75 65 29 20 69 73 20 74 68 d to true) is th
1aef0 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 2a 2a e case if. **
1af00 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1af10 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 74 68 _ASSERT shows th
1af20 61 74 20 61 73 73 65 72 74 28 29 20 69 73 20 64 at assert() is d
1af30 69 73 61 62 6c 65 64 20 61 6e 64 20 74 68 65 20 isabled and the
1af40 73 65 63 6f 6e 64 0a 20 20 20 20 2a 2a 20 62 65 second. ** be
1af50 68 61 76 69 6f 72 20 28 61 73 73 65 72 74 20 69 havior (assert i
1af60 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 74 f the argument t
1af70 6f 20 41 4c 57 41 59 53 28 29 20 69 73 20 66 61 o ALWAYS() is fa
1af80 6c 73 65 29 20 69 73 20 74 68 65 20 63 61 73 65 lse) is the case
1af90 20 69 66 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 if. ** SQLIT
1afa0 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 E_TESTCTRL_ASSER
1afb0 54 20 73 68 6f 77 73 20 74 68 61 74 20 61 73 73 T shows that ass
1afc0 65 72 74 28 29 20 69 73 20 65 6e 61 62 6c 65 64 ert() is enabled
1afd0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1afe0 54 68 65 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 The run-time tes
1aff0 74 20 70 72 6f 63 65 64 75 72 65 20 6d 69 67 68 t procedure migh
1b000 74 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 6e 67 t look something
1b010 20 6c 69 6b 65 20 74 68 69 73 3a 0a 20 20 20 20 like this:.
1b020 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 20 69 66 28 **. ** if(
1b030 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1b040 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1b050 54 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 32 29 TCTRL_ALWAYS, 2)
1b060 3d 3d 32 20 29 7b 0a 20 20 20 20 2a 2a 20 20 20 ==2 ){. **
1b070 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 29 20 61 // ALWAYS() a
1b080 6e 64 20 4e 45 56 45 52 28 29 20 61 72 65 20 6e nd NEVER() are n
1b090 6f 2d 6f 70 20 70 61 73 73 2d 74 68 72 6f 75 67 o-op pass-throug
1b0a0 68 20 6d 61 63 72 6f 73 0a 20 20 20 20 2a 2a 20 h macros. **
1b0b0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c }else if( sql
1b0c0 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
1b0d0 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
1b0e0 4c 5f 41 53 53 45 52 54 2c 20 31 29 20 29 7b 0a L_ASSERT, 1) ){.
1b0f0 20 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 ** // A
1b100 4c 57 41 59 53 28 78 29 20 61 73 73 65 72 74 73 LWAYS(x) asserts
1b110 20 74 68 61 74 20 78 20 69 73 20 74 72 75 65 2e that x is true.
1b120 20 4e 45 56 45 52 28 78 29 20 61 73 73 65 72 74 NEVER(x) assert
1b130 73 20 78 20 69 73 20 66 61 6c 73 65 2e 0a 20 20 s x is false..
1b140 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ** }else{.
1b150 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c ** // AL
1b160 57 41 59 53 28 78 29 20 69 73 20 61 20 63 6f 6e WAYS(x) is a con
1b170 73 74 61 6e 74 20 31 2e 20 20 4e 45 56 45 52 28 stant 1. NEVER(
1b180 78 29 20 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 x) is a constant
1b190 20 30 2e 0a 20 20 20 20 2a 2a 20 20 20 20 7d 0a 0.. ** }.
1b1a0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1b1b0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1b1c0 41 4c 57 41 59 53 3a 20 7b 0a 20 20 20 20 20 20 ALWAYS: {.
1b1d0 69 6e 74 20 78 20 3d 20 76 61 5f 61 72 67 28 61 int x = va_arg(a
1b1e0 70 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 72 63 p,int);. rc
1b1f0 20 3d 20 41 4c 57 41 59 53 28 78 29 3b 0a 20 20 = ALWAYS(x);.
1b200 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1b210 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
1b220 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 sqlite3_test_c
1b230 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 ontrol(SQLITE_TE
1b240 53 54 43 54 52 4c 5f 42 59 54 45 4f 52 44 45 52 STCTRL_BYTEORDER
1b250 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a );. **. **
1b260 20 54 68 65 20 69 6e 74 65 67 65 72 20 72 65 74 The integer ret
1b270 75 72 6e 65 64 20 72 65 76 65 61 6c 73 20 74 68 urned reveals th
1b280 65 20 62 79 74 65 2d 6f 72 64 65 72 20 6f 66 20 e byte-order of
1b290 74 68 65 20 63 6f 6d 70 75 74 65 72 20 6f 6e 20 the computer on
1b2a0 77 68 69 63 68 0a 20 20 20 20 2a 2a 20 53 51 4c which. ** SQL
1b2b0 69 74 65 20 69 73 20 72 75 6e 6e 69 6e 67 3a 0a ite is running:.
1b2c0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 **. **
1b2d0 20 20 20 20 31 20 20 20 20 20 62 69 67 2d 65 6e 1 big-en
1b2e0 64 69 61 6e 2c 20 20 20 20 64 65 74 65 72 6d 69 dian, determi
1b2f0 6e 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a ned at run-time.
1b300 20 20 20 20 2a 2a 20 20 20 20 20 20 31 30 20 20 ** 10
1b310 20 20 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61 6e little-endian
1b320 2c 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 , determined at
1b330 72 75 6e 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 run-time. **
1b340 20 34 33 32 31 30 31 20 20 20 20 20 62 69 67 2d 432101 big-
1b350 65 6e 64 69 61 6e 2c 20 20 20 20 64 65 74 65 72 endian, deter
1b360 6d 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 mined at compile
1b370 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 31 32 -time. ** 12
1b380 33 34 31 30 20 20 20 20 20 6c 69 74 74 6c 65 2d 3410 little-
1b390 65 6e 64 69 61 6e 2c 20 64 65 74 65 72 6d 69 6e endian, determin
1b3a0 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ed at compile-ti
1b3b0 6d 65 0a 20 20 20 20 2a 2f 20 0a 20 20 20 20 63 me. */ . c
1b3c0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1b3d0 54 52 4c 5f 42 59 54 45 4f 52 44 45 52 3a 20 7b TRL_BYTEORDER: {
1b3e0 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
1b3f0 54 45 5f 42 59 54 45 4f 52 44 45 52 2a 31 30 30 TE_BYTEORDER*100
1b400 20 2b 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 + SQLITE_LITTLE
1b410 45 4e 44 49 41 4e 2a 31 30 20 2b 20 53 51 4c 49 ENDIAN*10 + SQLI
1b420 54 45 5f 42 49 47 45 4e 44 49 41 4e 3b 0a 20 20 TE_BIGENDIAN;.
1b430 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1b440 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1b450 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1b460 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1b470 52 45 53 45 52 56 45 2c 20 73 71 6c 69 74 65 33 RESERVE, sqlite3
1b480 20 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 20 20 *db, int N).
1b490 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 **. ** Set t
1b4a0 68 65 20 6e 52 65 73 65 72 76 65 20 73 69 7a 65 he nReserve size
1b4b0 20 74 6f 20 4e 20 66 6f 72 20 74 68 65 20 6d 61 to N for the ma
1b4c0 69 6e 20 64 61 74 61 62 61 73 65 20 6f 6e 20 74 in database on t
1b4d0 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 he database.
1b4e0 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64 62 ** connection db
1b4f0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1b500 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1b510 4c 5f 52 45 53 45 52 56 45 3a 20 7b 0a 20 20 20 L_RESERVE: {.
1b520 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d sqlite3 *db =
1b530 20 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 va_arg(ap, sqli
1b540 74 65 33 2a 29 3b 0a 20 20 20 20 20 20 69 6e 74 te3*);. int
1b550 20 78 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 69 x = va_arg(ap,i
1b560 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
1b570 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1b580 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 b->mutex);.
1b590 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 sqlite3BtreeSet
1b5a0 50 61 67 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 PageSize(db->aDb
1b5b0 5b 30 5d 2e 70 42 74 2c 20 30 2c 20 78 2c 20 30 [0].pBt, 0, x, 0
1b5c0 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
1b5d0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
1b5e0 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 62 >mutex);. b
1b5f0 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
1b600 20 2f 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 /* sqlite3_tes
1b610 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
1b620 5f 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 _TESTCTRL_OPTIMI
1b630 5a 41 54 49 4f 4e 53 2c 20 73 71 6c 69 74 65 33 ZATIONS, sqlite3
1b640 20 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 20 20 *db, int N).
1b650 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 6e 61 62 6c **. ** Enabl
1b660 65 20 6f 72 20 64 69 73 61 62 6c 65 20 76 61 72 e or disable var
1b670 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f ious optimizatio
1b680 6e 73 20 66 6f 72 20 74 65 73 74 69 6e 67 20 70 ns for testing p
1b690 75 72 70 6f 73 65 73 2e 20 20 54 68 65 20 0a 20 urposes. The .
1b6a0 20 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 20 4e ** argument N
1b6b0 20 69 73 20 61 20 62 69 74 6d 61 73 6b 20 6f 66 is a bitmask of
1b6c0 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 74 optimizations t
1b6d0 6f 20 62 65 20 64 69 73 61 62 6c 65 64 2e 20 20 o be disabled.
1b6e0 46 6f 72 20 6e 6f 72 6d 61 6c 0a 20 20 20 20 2a For normal. *
1b6f0 2a 20 6f 70 65 72 61 74 69 6f 6e 20 4e 20 73 68 * operation N sh
1b700 6f 75 6c 64 20 62 65 20 30 2e 20 20 54 68 65 20 ould be 0. The
1b710 69 64 65 61 20 69 73 20 74 68 61 74 20 61 20 74 idea is that a t
1b720 65 73 74 20 70 72 6f 67 72 61 6d 20 28 6c 69 6b est program (lik
1b730 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 53 51 4c e the. ** SQL
1b740 20 4c 6f 67 69 63 20 54 65 73 74 20 6f 72 20 53 Logic Test or S
1b750 4c 54 20 74 65 73 74 20 6d 6f 64 75 6c 65 29 20 LT test module)
1b760 63 61 6e 20 72 75 6e 20 74 68 65 20 73 61 6d 65 can run the same
1b770 20 53 51 4c 20 6d 75 6c 74 69 70 6c 65 20 74 69 SQL multiple ti
1b780 6d 65 73 0a 20 20 20 20 2a 2a 20 77 69 74 68 20 mes. ** with
1b790 76 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 various optimiza
1b7a0 74 69 6f 6e 73 20 64 69 73 61 62 6c 65 64 20 74 tions disabled t
1b7b0 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 o verify that th
1b7c0 65 20 73 61 6d 65 20 61 6e 73 77 65 72 0a 20 20 e same answer.
1b7d0 20 20 2a 2a 20 69 73 20 6f 62 74 61 69 6e 65 64 ** is obtained
1b7e0 20 69 6e 20 65 76 65 72 79 20 63 61 73 65 2e 0a in every case..
1b7f0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1b800 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1b810 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 3a 20 7b OPTIMIZATIONS: {
1b820 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a . sqlite3 *
1b830 64 62 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 db = va_arg(ap,
1b840 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 20 sqlite3*);.
1b850 20 64 62 2d 3e 64 62 4f 70 74 46 6c 61 67 73 20 db->dbOptFlags
1b860 3d 20 28 75 31 36 29 28 76 61 5f 61 72 67 28 61 = (u16)(va_arg(a
1b870 70 2c 20 69 6e 74 29 20 26 20 30 78 66 66 66 66 p, int) & 0xffff
1b880 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
1b890 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }..#ifdef SQ
1b8a0 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 44 0a 20 LITE_N_KEYWORD.
1b8b0 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 /* sqlite3_te
1b8c0 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 st_control(SQLIT
1b8d0 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 4b 45 59 E_TESTCTRL_ISKEY
1b8e0 57 4f 52 44 2c 20 63 6f 6e 73 74 20 63 68 61 72 WORD, const char
1b8f0 20 2a 7a 57 6f 72 64 29 0a 20 20 20 20 2a 2a 0a *zWord). **.
1b900 20 20 20 20 2a 2a 20 49 66 20 7a 57 6f 72 64 20 ** If zWord
1b910 69 73 20 61 20 6b 65 79 77 6f 72 64 20 72 65 63 is a keyword rec
1b920 6f 67 6e 69 7a 65 64 20 62 79 20 74 68 65 20 70 ognized by the p
1b930 61 72 73 65 72 2c 20 74 68 65 6e 20 72 65 74 75 arser, then retu
1b940 72 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 6e 75 rn the. ** nu
1b950 6d 62 65 72 20 6f 66 20 6b 65 79 77 6f 72 64 73 mber of keywords
1b960 2e 20 20 4f 72 20 69 66 20 7a 57 6f 72 64 20 69 . Or if zWord i
1b970 73 20 6e 6f 74 20 61 20 6b 65 79 77 6f 72 64 2c s not a keyword,
1b980 20 72 65 74 75 72 6e 20 30 2e 0a 20 20 20 20 2a return 0.. *
1b990 2a 20 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 74 * . ** This t
1b9a0 65 73 74 20 66 65 61 74 75 72 65 20 69 73 20 6f est feature is o
1b9b0 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 6e nly available in
1b9c0 20 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f the amalgamatio
1b9d0 6e 20 73 69 6e 63 65 0a 20 20 20 20 2a 2a 20 74 n since. ** t
1b9e0 68 65 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 he SQLITE_N_KEYW
1b9f0 4f 52 44 20 6d 61 63 72 6f 20 69 73 20 6e 6f 74 ORD macro is not
1ba00 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 69 73 defined in this
1ba10 20 66 69 6c 65 20 69 66 20 53 51 4c 69 74 65 0a file if SQLite.
1ba20 20 20 20 20 2a 2a 20 69 73 20 62 75 69 6c 74 20 ** is built
1ba30 75 73 69 6e 67 20 73 65 70 61 72 61 74 65 20 73 using separate s
1ba40 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 20 20 20 ource files..
1ba50 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1ba60 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 4b ITE_TESTCTRL_ISK
1ba70 45 59 57 4f 52 44 3a 20 7b 0a 20 20 20 20 20 20 EYWORD: {.
1ba80 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 57 6f 72 const char *zWor
1ba90 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 63 d = va_arg(ap, c
1baa0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 20 onst char*);.
1bab0 20 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74 int n = sqlit
1bac0 65 33 53 74 72 6c 65 6e 33 30 28 7a 57 6f 72 64 e3Strlen30(zWord
1bad0 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 28 73 );. rc = (s
1bae0 71 6c 69 74 65 33 4b 65 79 77 6f 72 64 43 6f 64 qlite3KeywordCod
1baf0 65 28 28 75 38 2a 29 7a 57 6f 72 64 2c 20 6e 29 e((u8*)zWord, n)
1bb00 21 3d 54 4b 5f 49 44 29 20 3f 20 53 51 4c 49 54 !=TK_ID) ? SQLIT
1bb10 45 5f 4e 5f 4b 45 59 57 4f 52 44 20 3a 20 30 3b E_N_KEYWORD : 0;
1bb20 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1bb30 20 20 7d 0a 23 65 6e 64 69 66 20 0a 0a 20 20 20 }.#endif ..
1bb40 20 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 74 /* sqlite3_test
1bb50 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
1bb60 54 45 53 54 43 54 52 4c 5f 53 43 52 41 54 43 48 TESTCTRL_SCRATCH
1bb70 4d 41 4c 4c 4f 43 2c 20 73 7a 2c 20 26 70 4e 65 MALLOC, sz, &pNe
1bb80 77 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 20 2a w, pFree);. *
1bb90 2a 0a 20 20 20 20 2a 2a 20 50 61 73 73 20 70 46 *. ** Pass pF
1bba0 72 65 65 20 69 6e 74 6f 20 73 71 6c 69 74 65 33 ree into sqlite3
1bbb0 53 63 72 61 74 63 68 46 72 65 65 28 29 2e 20 0a ScratchFree(). .
1bbc0 20 20 20 20 2a 2a 20 49 66 20 73 7a 3e 30 20 74 ** If sz>0 t
1bbd0 68 65 6e 20 61 6c 6c 6f 63 61 74 65 20 61 20 73 hen allocate a s
1bbe0 63 72 61 74 63 68 20 62 75 66 66 65 72 20 69 6e cratch buffer in
1bbf0 74 6f 20 70 4e 65 77 2e 20 20 0a 20 20 20 20 2a to pNew. . *
1bc00 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
1bc10 45 5f 54 45 53 54 43 54 52 4c 5f 53 43 52 41 54 E_TESTCTRL_SCRAT
1bc20 43 48 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 20 CHMALLOC: {.
1bc30 20 20 76 6f 69 64 20 2a 70 46 72 65 65 2c 20 2a void *pFree, *
1bc40 2a 70 70 4e 65 77 3b 0a 20 20 20 20 20 20 69 6e *ppNew;. in
1bc50 74 20 73 7a 3b 0a 20 20 20 20 20 20 73 7a 20 3d t sz;. sz =
1bc60 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
1bc70 3b 0a 20 20 20 20 20 20 70 70 4e 65 77 20 3d 20 ;. ppNew =
1bc80 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a va_arg(ap, void*
1bc90 2a 29 3b 0a 20 20 20 20 20 20 70 46 72 65 65 20 *);. pFree
1bca0 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
1bcb0 64 2a 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 d*);. if( s
1bcc0 7a 20 29 20 2a 70 70 4e 65 77 20 3d 20 73 71 6c z ) *ppNew = sql
1bcd0 69 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f ite3ScratchMallo
1bce0 63 28 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c c(sz);. sql
1bcf0 69 74 65 33 53 63 72 61 74 63 68 46 72 65 65 28 ite3ScratchFree(
1bd00 70 46 72 65 65 29 3b 0a 20 20 20 20 20 20 62 72 pFree);. br
1bd10 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
1bd20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 /* sqlite3_tes
1bd30 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
1bd40 5f 54 45 53 54 43 54 52 4c 5f 4c 4f 43 41 4c 54 _TESTCTRL_LOCALT
1bd50 49 4d 45 5f 46 41 55 4c 54 2c 20 69 6e 74 20 6f IME_FAULT, int o
1bd60 6e 6f 66 66 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 noff);. **.
1bd70 20 20 2a 2a 20 49 66 20 70 61 72 61 6d 65 74 65 ** If paramete
1bd80 72 20 6f 6e 6f 66 66 20 69 73 20 6e 6f 6e 2d 7a r onoff is non-z
1bd90 65 72 6f 2c 20 63 6f 6e 66 69 67 75 72 65 20 74 ero, configure t
1bda0 68 65 20 77 72 61 70 70 65 72 73 20 73 6f 20 74 he wrappers so t
1bdb0 68 61 74 20 61 6c 6c 0a 20 20 20 20 2a 2a 20 73 hat all. ** s
1bdc0 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 ubsequent calls
1bdd0 74 6f 20 6c 6f 63 61 6c 74 69 6d 65 28 29 20 61 to localtime() a
1bde0 6e 64 20 76 61 72 69 61 6e 74 73 20 66 61 69 6c nd variants fail
1bdf0 2e 20 49 66 20 6f 6e 6f 66 66 20 69 73 20 7a 65 . If onoff is ze
1be00 72 6f 2c 0a 20 20 20 20 2a 2a 20 75 6e 64 6f 20 ro,. ** undo
1be10 74 68 69 73 20 73 65 74 74 69 6e 67 2e 0a 20 20 this setting..
1be20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
1be30 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4c 4f LITE_TESTCTRL_LO
1be40 43 41 4c 54 49 4d 45 5f 46 41 55 4c 54 3a 20 7b CALTIME_FAULT: {
1be50 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
1be60 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4c 6f 63 61 obalConfig.bLoca
1be70 6c 74 69 6d 65 46 61 75 6c 74 20 3d 20 76 61 5f ltimeFault = va_
1be80 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
1be90 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1bea0 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1beb0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1bec0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1bed0 4e 45 56 45 52 5f 43 4f 52 52 55 50 54 2c 20 69 NEVER_CORRUPT, i
1bee0 6e 74 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 nt);. **.
1bef0 2a 2a 20 53 65 74 20 6f 72 20 63 6c 65 61 72 20 ** Set or clear
1bf00 61 20 66 6c 61 67 20 74 68 61 74 20 69 6e 64 69 a flag that indi
1bf10 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 64 cates that the d
1bf20 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
1bf30 61 6c 77 61 79 73 20 77 65 6c 6c 2d 0a 20 20 20 always well-.
1bf40 20 2a 2a 20 66 6f 72 6d 65 64 20 61 6e 64 20 6e ** formed and n
1bf50 65 76 65 72 20 63 6f 72 72 75 70 74 2e 20 20 54 ever corrupt. T
1bf60 68 69 73 20 66 6c 61 67 20 69 73 20 63 6c 65 61 his flag is clea
1bf70 72 20 62 79 20 64 65 66 61 75 6c 74 2c 20 69 6e r by default, in
1bf80 64 69 63 61 74 69 6e 67 20 74 68 61 74 0a 20 20 dicating that.
1bf90 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 ** database fi
1bfa0 6c 65 73 20 6d 69 67 68 74 20 68 61 76 65 20 61 les might have a
1bfb0 72 62 69 74 72 61 72 79 20 63 6f 72 72 75 70 74 rbitrary corrupt
1bfc0 69 6f 6e 2e 20 20 53 65 74 74 69 6e 67 20 74 68 ion. Setting th
1bfd0 65 20 66 6c 61 67 20 64 75 72 69 6e 67 0a 20 20 e flag during.
1bfe0 20 20 2a 2a 20 74 65 73 74 69 6e 67 20 63 61 75 ** testing cau
1bff0 73 65 73 20 63 65 72 74 61 69 6e 20 61 73 73 65 ses certain asse
1c000 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 rt() statements
1c010 69 6e 20 74 68 65 20 63 6f 64 65 20 74 6f 20 62 in the code to b
1c020 65 20 61 63 74 69 76 61 74 65 64 0a 20 20 20 20 e activated.
1c030 2a 2a 20 74 68 61 74 20 64 65 6d 6f 6e 73 74 72 ** that demonstr
1c040 61 74 20 69 6e 76 61 72 69 61 6e 74 73 20 6f 6e at invariants on
1c050 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 well-formed dat
1c060 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 20 20 20 abase files..
1c070 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1c080 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4e 45 56 ITE_TESTCTRL_NEV
1c090 45 52 5f 43 4f 52 52 55 50 54 3a 20 7b 0a 20 20 ER_CORRUPT: {.
1c0a0 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1c0b0 6c 43 6f 6e 66 69 67 2e 6e 65 76 65 72 43 6f 72 lConfig.neverCor
1c0c0 72 75 70 74 20 3d 20 76 61 5f 61 72 67 28 61 70 rupt = va_arg(ap
1c0d0 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
1c0e0 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 eak;. }...
1c0f0 20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 /* sqlite3_te
1c100 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 st_control(SQLIT
1c110 45 5f 54 45 53 54 43 54 52 4c 5f 56 44 42 45 5f E_TESTCTRL_VDBE_
1c120 43 4f 56 45 52 41 47 45 2c 20 78 43 61 6c 6c 62 COVERAGE, xCallb
1c130 61 63 6b 2c 20 70 74 72 29 3b 0a 20 20 20 20 2a ack, ptr);. *
1c140 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 68 65 *. ** Set the
1c150 20 56 44 42 45 20 63 6f 76 65 72 61 67 65 20 63 VDBE coverage c
1c160 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e allback function
1c170 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 20 77 69 to xCallback wi
1c180 74 68 20 63 6f 6e 74 65 78 74 20 0a 20 20 20 20 th context .
1c190 2a 2a 20 70 6f 69 6e 74 65 72 20 70 74 72 2e 0a ** pointer ptr..
1c1a0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1c1b0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1c1c0 56 44 42 45 5f 43 4f 56 45 52 41 47 45 3a 20 7b VDBE_COVERAGE: {
1c1d0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 56 .#ifdef SQLITE_V
1c1e0 44 42 45 5f 43 4f 56 45 52 41 47 45 0a 20 20 20 DBE_COVERAGE.
1c1f0 20 20 20 74 79 70 65 64 65 66 20 76 6f 69 64 20 typedef void
1c200 28 2a 62 72 61 6e 63 68 5f 63 61 6c 6c 62 61 63 (*branch_callbac
1c210 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 75 38 2c k)(void*,int,u8,
1c220 75 38 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 u8);. sqlit
1c230 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
1c240 56 64 62 65 42 72 61 6e 63 68 20 3d 20 76 61 5f VdbeBranch = va_
1c250 61 72 67 28 61 70 2c 62 72 61 6e 63 68 5f 63 61 arg(ap,branch_ca
1c260 6c 6c 62 61 63 6b 29 3b 0a 20 20 20 20 20 20 73 llback);. s
1c270 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1c280 69 67 2e 70 56 64 62 65 42 72 61 6e 63 68 41 72 ig.pVdbeBranchAr
1c290 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 76 6f g = va_arg(ap,vo
1c2a0 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 id*);.#endif.
1c2b0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1c2c0 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 . /* sqlite
1c2d0 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1c2e0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 53 QLITE_TESTCTRL_S
1c2f0 4f 52 54 45 52 5f 4d 4d 41 50 2c 20 64 62 2c 20 ORTER_MMAP, db,
1c300 6e 4d 61 78 29 3b 20 2a 2f 0a 20 20 20 20 63 61 nMax); */. ca
1c310 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1c320 52 4c 5f 53 4f 52 54 45 52 5f 4d 4d 41 50 3a 20 RL_SORTER_MMAP:
1c330 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 20 {. sqlite3
1c340 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 70 2c *db = va_arg(ap,
1c350 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 sqlite3*);.
1c360 20 20 64 62 2d 3e 6e 4d 61 78 53 6f 72 74 65 72 db->nMaxSorter
1c370 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 61 70 Mmap = va_arg(ap
1c380 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
1c390 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
1c3a0 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 /* sqlite3_tes
1c3b0 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
1c3c0 5f 54 45 53 54 43 54 52 4c 5f 49 53 49 4e 49 54 _TESTCTRL_ISINIT
1c3d0 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a );. **. **
1c3e0 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
1c3f0 4b 20 69 66 20 53 51 4c 69 74 65 20 68 61 73 20 K if SQLite has
1c400 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 been initialized
1c410 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 52 52 4f and SQLITE_ERRO
1c420 52 20 69 66 0a 20 20 20 20 2a 2a 20 6e 6f 74 2e R if. ** not.
1c430 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
1c440 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1c450 5f 49 53 49 4e 49 54 3a 20 7b 0a 20 20 20 20 20 _ISINIT: {.
1c460 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
1c470 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 3d alConfig.isInit=
1c480 3d 30 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 =0 ) rc = SQLITE
1c490 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 _ERROR;. br
1c4a0 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 eak;. }. }.
1c4b0 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 23 65 6e va_end(ap);.#en
1c4c0 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
1c4d0 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 20 IT_BUILTIN_TEST
1c4e0 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a */. return rc;.
1c4f0 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 }../*.** This is
1c500 20 61 20 75 74 69 6c 69 74 79 20 72 6f 75 74 69 a utility routi
1c510 6e 65 2c 20 75 73 65 66 75 6c 20 74 6f 20 56 46 ne, useful to VF
1c520 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e S implementation
1c530 73 2c 20 74 68 61 74 20 63 68 65 63 6b 73 0a 2a s, that checks.*
1c540 2a 20 74 6f 20 73 65 65 20 69 66 20 61 20 64 61 * to see if a da
1c550 74 61 62 61 73 65 20 66 69 6c 65 20 77 61 73 20 tabase file was
1c560 61 20 55 52 49 20 74 68 61 74 20 63 6f 6e 74 61 a URI that conta
1c570 69 6e 65 64 20 61 20 73 70 65 63 69 66 69 63 20 ined a specific
1c580 71 75 65 72 79 20 0a 2a 2a 20 70 61 72 61 6d 65 query .** parame
1c590 74 65 72 2c 20 61 6e 64 20 69 66 20 73 6f 20 6f ter, and if so o
1c5a0 62 74 61 69 6e 73 20 74 68 65 20 76 61 6c 75 65 btains the value
1c5b0 20 6f 66 20 74 68 65 20 71 75 65 72 79 20 70 61 of the query pa
1c5c0 72 61 6d 65 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 rameter..**.** T
1c5d0 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 61 72 67 he zFilename arg
1c5e0 75 6d 65 6e 74 20 69 73 20 74 68 65 20 66 69 6c ument is the fil
1c5f0 65 6e 61 6d 65 20 70 6f 69 6e 74 65 72 20 70 61 ename pointer pa
1c600 73 73 65 64 20 69 6e 74 6f 20 74 68 65 20 78 4f ssed into the xO
1c610 70 65 6e 28 29 0a 2a 2a 20 6d 65 74 68 6f 64 20 pen().** method
1c620 6f 66 20 61 20 56 46 53 20 69 6d 70 6c 65 6d 65 of a VFS impleme
1c630 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 20 7a 50 ntation. The zP
1c640 61 72 61 6d 20 61 72 67 75 6d 65 6e 74 20 69 73 aram argument is
1c650 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
1c660 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 61 6d 65 .** query parame
1c670 74 65 72 20 77 65 20 73 65 65 6b 2e 20 20 54 68 ter we seek. Th
1c680 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 is routine retur
1c690 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ns the value of
1c6a0 74 68 65 20 7a 50 61 72 61 6d 0a 2a 2a 20 70 61 the zParam.** pa
1c6b0 72 61 6d 65 74 65 72 20 69 66 20 69 74 20 65 78 rameter if it ex
1c6c0 69 73 74 73 2e 20 20 49 66 20 74 68 65 20 70 61 ists. If the pa
1c6d0 72 61 6d 65 74 65 72 20 64 6f 65 73 20 6e 6f 74 rameter does not
1c6e0 20 65 78 69 73 74 2c 20 74 68 69 73 20 72 6f 75 exist, this rou
1c6f0 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72 6e 73 20 tine.** returns
1c700 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2e 0a a NULL pointer..
1c710 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
1c720 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d qlite3_uri_param
1c730 65 74 65 72 28 63 6f 6e 73 74 20 63 68 61 72 20 eter(const char
1c740 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 6f 6e 73 *zFilename, cons
1c750 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 29 7b t char *zParam){
1c760 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 . if( zFilename
1c770 3d 3d 30 20 7c 7c 20 7a 50 61 72 61 6d 3d 3d 30 ==0 || zParam==0
1c780 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7a ) return 0;. z
1c790 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 73 71 6c 69 Filename += sqli
1c7a0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c te3Strlen30(zFil
1c7b0 65 6e 61 6d 65 29 20 2b 20 31 3b 0a 20 20 77 68 ename) + 1;. wh
1c7c0 69 6c 65 28 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 ile( zFilename[0
1c7d0 5d 20 29 7b 0a 20 20 20 20 69 6e 74 20 78 20 3d ] ){. int x =
1c7e0 20 73 74 72 63 6d 70 28 7a 46 69 6c 65 6e 61 6d strcmp(zFilenam
1c7f0 65 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 20 20 20 e, zParam);.
1c800 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 73 71 6c zFilename += sql
1c810 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 ite3Strlen30(zFi
1c820 6c 65 6e 61 6d 65 29 20 2b 20 31 3b 0a 20 20 20 lename) + 1;.
1c830 20 69 66 28 20 78 3d 3d 30 20 29 20 72 65 74 75 if( x==0 ) retu
1c840 72 6e 20 7a 46 69 6c 65 6e 61 6d 65 3b 0a 20 20 rn zFilename;.
1c850 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 73 zFilename += s
1c860 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
1c870 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 3b 0a 20 Filename) + 1;.
1c880 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d }. return 0;.}
1c890 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 ../*.** Return a
1c8a0 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 20 66 boolean value f
1c8b0 6f 72 20 61 20 71 75 65 72 79 20 70 61 72 61 6d or a query param
1c8c0 65 74 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c eter..*/.int sql
1c8d0 69 74 65 33 5f 75 72 69 5f 62 6f 6f 6c 65 61 6e ite3_uri_boolean
1c8e0 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 (const char *zFi
1c8f0 6c 65 6e 61 6d 65 2c 20 63 6f 6e 73 74 20 63 68 lename, const ch
1c900 61 72 20 2a 7a 50 61 72 61 6d 2c 20 69 6e 74 20 ar *zParam, int
1c910 62 44 66 6c 74 29 7b 0a 20 20 63 6f 6e 73 74 20 bDflt){. const
1c920 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c 69 74 65 char *z = sqlite
1c930 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 3_uri_parameter(
1c940 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 72 61 zFilename, zPara
1c950 6d 29 3b 0a 20 20 62 44 66 6c 74 20 3d 20 62 44 m);. bDflt = bD
1c960 66 6c 74 21 3d 30 3b 0a 20 20 72 65 74 75 72 6e flt!=0;. return
1c970 20 7a 20 3f 20 73 71 6c 69 74 65 33 47 65 74 42 z ? sqlite3GetB
1c980 6f 6f 6c 65 61 6e 28 7a 2c 20 62 44 66 6c 74 29 oolean(z, bDflt)
1c990 20 3a 20 62 44 66 6c 74 3b 0a 7d 0a 0a 2f 2a 0a : bDflt;.}../*.
1c9a0 2a 2a 20 52 65 74 75 72 6e 20 61 20 36 34 2d 62 ** Return a 64-b
1c9b0 69 74 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 it integer value
1c9c0 20 66 6f 72 20 61 20 71 75 65 72 79 20 70 61 72 for a query par
1c9d0 61 6d 65 74 65 72 2e 0a 2a 2f 0a 73 71 6c 69 74 ameter..*/.sqlit
1c9e0 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 e3_int64 sqlite3
1c9f0 5f 75 72 69 5f 69 6e 74 36 34 28 0a 20 20 63 6f _uri_int64(. co
1ca00 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e nst char *zFilen
1ca10 61 6d 65 2c 20 20 20 20 2f 2a 20 46 69 6c 65 6e ame, /* Filen
1ca20 61 6d 65 20 61 73 20 70 61 73 73 65 64 20 74 6f ame as passed to
1ca30 20 78 4f 70 65 6e 20 2a 2f 0a 20 20 63 6f 6e 73 xOpen */. cons
1ca40 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 2c 20 t char *zParam,
1ca50 20 20 20 20 20 20 2f 2a 20 55 52 49 20 70 61 72 /* URI par
1ca60 61 6d 65 74 65 72 20 73 6f 75 67 68 74 20 2a 2f ameter sought */
1ca70 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 . sqlite3_int64
1ca80 20 62 44 66 6c 74 20 20 20 20 20 20 20 2f 2a 20 bDflt /*
1ca90 72 65 74 75 72 6e 20 69 66 20 70 61 72 61 6d 65 return if parame
1caa0 74 65 72 20 69 73 20 6d 69 73 73 69 6e 67 20 2a ter is missing *
1cab0 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 /.){. const cha
1cac0 72 20 2a 7a 20 3d 20 73 71 6c 69 74 65 33 5f 75 r *z = sqlite3_u
1cad0 72 69 5f 70 61 72 61 6d 65 74 65 72 28 7a 46 69 ri_parameter(zFi
1cae0 6c 65 6e 61 6d 65 2c 20 7a 50 61 72 61 6d 29 3b lename, zParam);
1caf0 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 . sqlite3_int64
1cb00 20 76 3b 0a 20 20 69 66 28 20 7a 20 26 26 20 73 v;. if( z && s
1cb10 71 6c 69 74 65 33 44 65 63 4f 72 48 65 78 54 6f qlite3DecOrHexTo
1cb20 49 36 34 28 7a 2c 20 26 76 29 3d 3d 53 51 4c 49 I64(z, &v)==SQLI
1cb30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 62 44 66 TE_OK ){. bDf
1cb40 6c 74 20 3d 20 76 3b 0a 20 20 7d 0a 20 20 72 65 lt = v;. }. re
1cb50 74 75 72 6e 20 62 44 66 6c 74 3b 0a 7d 0a 0a 2f turn bDflt;.}../
1cb60 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
1cb70 42 74 72 65 65 20 70 6f 69 6e 74 65 72 20 69 64 Btree pointer id
1cb80 65 6e 74 69 66 69 65 64 20 62 79 20 7a 44 62 4e entified by zDbN
1cb90 61 6d 65 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c ame. Return NUL
1cba0 4c 20 69 66 20 6e 6f 74 20 66 6f 75 6e 64 2e 0a L if not found..
1cbb0 2a 2f 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 65 */.Btree *sqlite
1cbc0 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 3DbNameToBtree(s
1cbd0 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 qlite3 *db, cons
1cbe0 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 29 t char *zDbName)
1cbf0 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 {. int i;. for
1cc00 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b (i=0; i<db->nDb;
1cc10 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 i++){. if( d
1cc20 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 0a 20 20 b->aDb[i].pBt.
1cc30 20 20 20 26 26 20 28 7a 44 62 4e 61 6d 65 3d 3d && (zDbName==
1cc40 30 20 7c 7c 20 73 71 6c 69 74 65 33 53 74 72 49 0 || sqlite3StrI
1cc50 43 6d 70 28 7a 44 62 4e 61 6d 65 2c 20 64 62 2d Cmp(zDbName, db-
1cc60 3e 61 44 62 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d >aDb[i].zName)==
1cc70 30 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 0). ){.
1cc80 72 65 74 75 72 6e 20 64 62 2d 3e 61 44 62 5b 69 return db->aDb[i
1cc90 5d 2e 70 42 74 3b 0a 20 20 20 20 7d 0a 20 20 7d ].pBt;. }. }
1cca0 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a . return 0;.}..
1ccb0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
1ccc0 20 66 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65 filename of the
1ccd0 20 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 database associ
1cce0 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61 ated with a data
1ccf0 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 base.** connecti
1cd00 6f 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 on..*/.const cha
1cd10 72 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 66 69 r *sqlite3_db_fi
1cd20 6c 65 6e 61 6d 65 28 73 71 6c 69 74 65 33 20 2a lename(sqlite3 *
1cd30 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
1cd40 7a 44 62 4e 61 6d 65 29 7b 0a 23 69 66 64 65 66 zDbName){.#ifdef
1cd50 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
1cd60 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
1cd70 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
1cd80 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
1cd90 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 (void)SQLITE_MIS
1cda0 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 USE_BKPT;. re
1cdb0 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 turn 0;. }.#end
1cdc0 69 66 0a 20 20 42 74 72 65 65 20 2a 70 42 74 20 if. Btree *pBt
1cdd0 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 = sqlite3DbNameT
1cde0 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 oBtree(db, zDbNa
1cdf0 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 42 me);. return pB
1ce00 74 20 3f 20 73 71 6c 69 74 65 33 42 74 72 65 65 t ? sqlite3Btree
1ce10 47 65 74 46 69 6c 65 6e 61 6d 65 28 70 42 74 29 GetFilename(pBt)
1ce20 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 : 0;.}../*.** R
1ce30 65 74 75 72 6e 20 31 20 69 66 20 64 61 74 61 62 eturn 1 if datab
1ce40 61 73 65 20 69 73 20 72 65 61 64 2d 6f 6e 6c 79 ase is read-only
1ce50 20 6f 72 20 30 20 69 66 20 72 65 61 64 2f 77 72 or 0 if read/wr
1ce60 69 74 65 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 ite. Return -1
1ce70 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 68 20 64 61 if.** no such da
1ce80 74 61 62 61 73 65 20 65 78 69 73 74 73 2e 0a 2a tabase exists..*
1ce90 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 /.int sqlite3_db
1cea0 5f 72 65 61 64 6f 6e 6c 79 28 73 71 6c 69 74 65 _readonly(sqlite
1ceb0 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 3 *db, const cha
1cec0 72 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a 23 69 66 r *zDbName){.#if
1ced0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
1cee0 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
1cef0 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
1cf00 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
1cf10 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
1cf20 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
1cf30 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a return -1;. }.
1cf40 23 65 6e 64 69 66 0a 20 20 42 74 72 65 65 20 2a #endif. Btree *
1cf50 70 42 74 20 3d 20 73 71 6c 69 74 65 33 44 62 4e pBt = sqlite3DbN
1cf60 61 6d 65 54 6f 42 74 72 65 65 28 64 62 2c 20 7a ameToBtree(db, z
1cf70 44 62 4e 61 6d 65 29 3b 0a 20 20 72 65 74 75 72 DbName);. retur
1cf80 6e 20 70 42 74 20 3f 20 73 71 6c 69 74 65 33 42 n pBt ? sqlite3B
1cf90 74 72 65 65 49 73 52 65 61 64 6f 6e 6c 79 28 70 treeIsReadonly(p
1cfa0 42 74 29 20 3a 20 2d 31 3b 0a 7d 0a Bt) : -1;.}.