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 0a 23 69 66 64 65 66 20 53 51 4c 49 */..#ifdef SQLI
1110: 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 72 63 TE_OMIT_WSD. rc
1120: 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 5f 69 = sqlite3_wsd_i
1130: 6e 69 74 28 34 30 39 36 2c 20 32 34 29 3b 0a 20 nit(4096, 24);.
1140: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1150: 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
1160: 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a rc;. }.#endif.
1170: 0a 20 20 2f 2a 20 49 66 20 53 51 4c 69 74 65 20 . /* If SQLite
1180: 69 73 20 61 6c 72 65 61 64 79 20 63 6f 6d 70 6c is already compl
1190: 65 74 65 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65 etely initialize
11a0: 64 2c 20 74 68 65 6e 20 74 68 69 73 20 63 61 6c d, then this cal
11b0: 6c 0a 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 l. ** to sqlite
11c0: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 73 3_initialize() s
11d0: 68 6f 75 6c 64 20 62 65 20 61 20 6e 6f 2d 6f 70 hould be a no-op
11e0: 2e 20 20 42 75 74 20 74 68 65 20 69 6e 69 74 69 . But the initi
11f0: 61 6c 69 7a 61 74 69 6f 6e 0a 20 20 2a 2a 20 6d alization. ** m
1200: 75 73 74 20 62 65 20 63 6f 6d 70 6c 65 74 65 2e ust be complete.
1210: 20 20 53 6f 20 69 73 49 6e 69 74 20 6d 75 73 74 So isInit must
1220: 20 6e 6f 74 20 62 65 20 73 65 74 20 75 6e 74 69 not be set unti
1230: 6c 20 74 68 65 20 76 65 72 79 20 65 6e 64 0a 20 l the very end.
1240: 20 2a 2a 20 6f 66 20 74 68 69 73 20 72 6f 75 74 ** of this rout
1250: 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ine.. */. if(
1260: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1270: 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 65 74 fig.isInit ) ret
1280: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a urn SQLITE_OK;..
1290: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
12a0: 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 7b 0a ABLE_SQLLOG. {.
12b0: 20 20 20 20 65 78 74 65 72 6e 20 76 6f 69 64 20 extern void
12c0: 73 71 6c 69 74 65 33 5f 69 6e 69 74 5f 73 71 6c sqlite3_init_sql
12d0: 6c 6f 67 28 76 6f 69 64 29 3b 0a 20 20 20 20 73 log(void);. s
12e0: 71 6c 69 74 65 33 5f 69 6e 69 74 5f 73 71 6c 6c qlite3_init_sqll
12f0: 6f 67 28 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 og();. }.#endif
1300: 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 .. /* Make sure
1310: 20 74 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 the mutex subsy
1320: 73 74 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 stem is initiali
1330: 7a 65 64 2e 20 20 49 66 20 75 6e 61 62 6c 65 20 zed. If unable
1340: 74 6f 20 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c to . ** initial
1350: 69 7a 65 20 74 68 65 20 6d 75 74 65 78 20 73 75 ize the mutex su
1360: 62 73 79 73 74 65 6d 2c 20 72 65 74 75 72 6e 20 bsystem, return
1370: 65 61 72 6c 79 20 77 69 74 68 20 74 68 65 20 65 early with the e
1380: 72 72 6f 72 2e 0a 20 20 2a 2a 20 49 66 20 74 68 rror.. ** If th
1390: 65 20 73 79 73 74 65 6d 20 69 73 20 73 6f 20 73 e system is so s
13a0: 69 63 6b 20 74 68 61 74 20 77 65 20 61 72 65 20 ick that we are
13b0: 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 unable to alloca
13c0: 74 65 20 61 20 6d 75 74 65 78 2c 0a 20 20 2a 2a te a mutex,. **
13d0: 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 6d 75 there is not mu
13e0: 63 68 20 53 51 4c 69 74 65 20 69 73 20 67 6f 69 ch SQLite is goi
13f0: 6e 67 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f ng to be able to
1400: 20 64 6f 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 do.. **. ** T
1410: 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 he mutex subsyst
1420: 65 6d 20 6d 75 73 74 20 74 61 6b 65 20 63 61 72 em must take car
1430: 65 20 6f 66 20 73 65 72 69 61 6c 69 7a 69 6e 67 e of serializing
1440: 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 69 6e its own. ** in
1450: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 itialization..
1460: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
1470: 33 4d 75 74 65 78 49 6e 69 74 28 29 3b 0a 20 20 3MutexInit();.
1480: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
1490: 72 63 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 rc;.. /* Initia
14a0: 6c 69 7a 65 20 74 68 65 20 6d 61 6c 6c 6f 63 28 lize the malloc(
14b0: 29 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 65 ) system and the
14c0: 20 72 65 63 75 72 73 69 76 65 20 70 49 6e 69 74 recursive pInit
14d0: 4d 75 74 65 78 20 6d 75 74 65 78 2e 0a 20 20 2a Mutex mutex.. *
14e0: 2a 20 54 68 69 73 20 6f 70 65 72 61 74 69 6f 6e * This operation
14f0: 20 69 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 is protected by
1500: 20 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 the STATIC_MAST
1510: 45 52 20 6d 75 74 65 78 2e 20 20 4e 6f 74 65 20 ER mutex. Note
1520: 74 68 61 74 0a 20 20 2a 2a 20 4d 75 74 65 78 41 that. ** MutexA
1530: 6c 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64 lloc() is called
1540: 20 66 6f 72 20 61 20 73 74 61 74 69 63 20 6d 75 for a static mu
1550: 74 65 78 20 70 72 69 6f 72 20 74 6f 20 69 6e 69 tex prior to ini
1560: 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 0a 20 20 tializing the.
1570: 2a 2a 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 ** malloc subsys
1580: 74 65 6d 20 2d 20 74 68 69 73 20 69 6d 70 6c 69 tem - this impli
1590: 65 73 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f es that the allo
15a0: 63 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 cation of a stat
15b0: 69 63 0a 20 20 2a 2a 20 6d 75 74 65 78 20 6d 75 ic. ** mutex mu
15c0: 73 74 20 6e 6f 74 20 72 65 71 75 69 72 65 20 73 st not require s
15d0: 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20 upport from the
15e0: 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d malloc subsystem
15f0: 2e 0a 20 20 2a 2f 0a 20 20 4d 55 54 45 58 5f 4c .. */. MUTEX_L
1600: 4f 47 49 43 28 20 70 4d 61 73 74 65 72 20 3d 20 OGIC( pMaster =
1610: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
1620: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
1630: 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 20 29 TATIC_MASTER); )
1640: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1650: 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b _enter(pMaster);
1660: 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c . sqlite3Global
1670: 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e Config.isMutexIn
1680: 69 74 20 3d 20 31 3b 0a 20 20 69 66 28 20 21 73 it = 1;. if( !s
1690: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
16a0: 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 ig.isMallocInit
16b0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
16c0: 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 29 3b te3MallocInit();
16d0: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
16e0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
16f0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1700: 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 fig.isMallocInit
1710: 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 21 73 = 1;. if( !s
1720: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1730: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 29 7b ig.pInitMutex ){
1740: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
1750: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
1760: 4d 75 74 65 78 20 3d 0a 20 20 20 20 20 20 20 20 Mutex =.
1770: 20 20 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 sqlite3MutexA
1780: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
1790: 58 5f 52 45 43 55 52 53 49 56 45 29 3b 0a 20 20 X_RECURSIVE);.
17a0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 if( sqlite3G
17b0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 lobalConfig.bCor
17c0: 65 4d 75 74 65 78 20 26 26 20 21 73 71 6c 69 74 eMutex && !sqlit
17d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
17e0: 49 6e 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 InitMutex ){.
17f0: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1800: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a _NOMEM;. }.
1810: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
1820: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1830: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
1840: 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 alConfig.nRefIni
1850: 74 4d 75 74 65 78 2b 2b 3b 0a 20 20 7d 0a 20 20 tMutex++;. }.
1860: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
1870: 61 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 ave(pMaster);..
1880: 20 2f 2a 20 49 66 20 72 63 20 69 73 20 6e 6f 74 /* If rc is not
1890: 20 53 51 4c 49 54 45 5f 4f 4b 20 61 74 20 74 68 SQLITE_OK at th
18a0: 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 65 is point, then e
18b0: 69 74 68 65 72 20 74 68 65 20 6d 61 6c 6c 6f 63 ither the malloc
18c0: 0a 20 20 2a 2a 20 73 75 62 73 79 73 74 65 6d 20 . ** subsystem
18d0: 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 69 6e 69 could not be ini
18e0: 74 69 61 6c 69 7a 65 64 20 6f 72 20 74 68 65 20 tialized or the
18f0: 73 79 73 74 65 6d 20 66 61 69 6c 65 64 20 74 6f system failed to
1900: 20 61 6c 6c 6f 63 61 74 65 0a 20 20 2a 2a 20 74 allocate. ** t
1910: 68 65 20 70 49 6e 69 74 4d 75 74 65 78 20 6d 75 he pInitMutex mu
1920: 74 65 78 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 tex. Return an e
1930: 72 72 6f 72 20 69 6e 20 65 69 74 68 65 72 20 63 rror in either c
1940: 61 73 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 72 ase. */. if( r
1950: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1960: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1970: 20 7d 0a 0a 20 20 2f 2a 20 44 6f 20 74 68 65 20 }.. /* Do the
1980: 72 65 73 74 20 6f 66 20 74 68 65 20 69 6e 69 74 rest of the init
1990: 69 61 6c 69 7a 61 74 69 6f 6e 20 75 6e 64 65 72 ialization under
19a0: 20 74 68 65 20 72 65 63 75 72 73 69 76 65 20 6d the recursive m
19b0: 75 74 65 78 20 73 6f 0a 20 20 2a 2a 20 74 68 61 utex so. ** tha
19c0: 74 20 77 65 20 77 69 6c 6c 20 62 65 20 61 62 6c t we will be abl
19d0: 65 20 74 6f 20 68 61 6e 64 6c 65 20 72 65 63 75 e to handle recu
19e0: 72 73 69 76 65 20 63 61 6c 6c 73 20 69 6e 74 6f rsive calls into
19f0: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6e . ** sqlite3_in
1a00: 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 54 68 65 itialize(). The
1a10: 20 72 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 recursive calls
1a20: 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6d 65 20 74 normally come t
1a30: 68 72 6f 75 67 68 0a 20 20 2a 2a 20 73 71 6c 69 hrough. ** sqli
1a40: 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29 20 77 68 te3_os_init() wh
1a50: 65 6e 20 69 74 20 69 6e 76 6f 6b 65 73 20 73 71 en it invokes sq
1a60: 6c 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 lite3_vfs_regist
1a70: 65 72 28 29 2c 20 62 75 74 20 6f 74 68 65 72 0a er(), but other.
1a80: 20 20 2a 2a 20 72 65 63 75 72 73 69 76 65 20 63 ** recursive c
1a90: 61 6c 6c 73 20 6d 69 67 68 74 20 61 6c 73 6f 20 alls might also
1aa0: 62 65 20 70 6f 73 73 69 62 6c 65 2e 0a 20 20 2a be possible.. *
1ab0: 2a 0a 20 20 2a 2a 20 49 4d 50 4c 45 4d 45 4e 54 *. ** IMPLEMENT
1ac0: 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 30 30 31 34 ATION-OF: R-0014
1ad0: 30 2d 33 37 34 34 35 20 53 51 4c 69 74 65 20 61 0-37445 SQLite a
1ae0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 65 72 utomatically ser
1af0: 69 61 6c 69 7a 65 73 20 63 61 6c 6c 73 0a 20 20 ializes calls.
1b00: 2a 2a 20 74 6f 20 74 68 65 20 78 49 6e 69 74 20 ** to the xInit
1b10: 6d 65 74 68 6f 64 2c 20 73 6f 20 74 68 65 20 78 method, so the x
1b20: 49 6e 69 74 20 6d 65 74 68 6f 64 20 6e 65 65 64 Init method need
1b30: 20 6e 6f 74 20 62 65 20 74 68 72 65 61 64 73 61 not be threadsa
1b40: 66 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 fe.. **. ** Th
1b50: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 75 74 65 e following mute
1b60: 78 20 69 73 20 77 68 61 74 20 73 65 72 69 61 6c x is what serial
1b70: 69 7a 65 73 20 61 63 63 65 73 73 20 74 6f 20 74 izes access to t
1b80: 68 65 20 61 70 70 64 65 66 20 70 63 61 63 68 65 he appdef pcache
1b90: 20 78 49 6e 69 74 0a 20 20 2a 2a 20 6d 65 74 68 xInit. ** meth
1ba0: 6f 64 73 2e 20 20 54 68 65 20 73 71 6c 69 74 65 ods. The sqlite
1bb0: 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 3_pcache_methods
1bc0: 2e 78 49 6e 69 74 28 29 20 61 6c 6c 20 69 73 20 .xInit() all is
1bd0: 65 6d 62 65 64 64 65 64 20 69 6e 20 74 68 65 0a embedded in the.
1be0: 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 73 71 6c ** call to sql
1bf0: 69 74 65 33 50 63 61 63 68 65 49 6e 69 74 69 61 ite3PcacheInitia
1c00: 6c 69 7a 65 28 29 2e 0a 20 20 2a 2f 0a 20 20 73 lize().. */. s
1c10: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
1c20: 65 72 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c er(sqlite3Global
1c30: 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 Config.pInitMute
1c40: 78 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 x);. if( sqlite
1c50: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1c60: 49 6e 69 74 3d 3d 30 20 26 26 20 73 71 6c 69 74 Init==0 && sqlit
1c70: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1c80: 6e 50 72 6f 67 72 65 73 73 3d 3d 30 20 29 7b 0a nProgress==0 ){.
1c90: 20 20 20 20 46 75 6e 63 44 65 66 48 61 73 68 20 FuncDefHash
1ca0: 2a 70 48 61 73 68 20 3d 20 26 47 4c 4f 42 41 4c *pHash = &GLOBAL
1cb0: 28 46 75 6e 63 44 65 66 48 61 73 68 2c 20 73 71 (FuncDefHash, sq
1cc0: 6c 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e 63 74 lite3GlobalFunct
1cd0: 69 6f 6e 73 29 3b 0a 20 20 20 20 73 71 6c 69 74 ions);. sqlit
1ce0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1cf0: 6e 50 72 6f 67 72 65 73 73 20 3d 20 31 3b 0a 20 nProgress = 1;.
1d00: 20 20 20 6d 65 6d 73 65 74 28 70 48 61 73 68 2c memset(pHash,
1d10: 20 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 0, sizeof(sqlit
1d20: 65 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e e3GlobalFunction
1d30: 73 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 s));. sqlite3
1d40: 52 65 67 69 73 74 65 72 47 6c 6f 62 61 6c 46 75 RegisterGlobalFu
1d50: 6e 63 74 69 6f 6e 73 28 29 3b 0a 20 20 20 20 69 nctions();. i
1d60: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
1d70: 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 Config.isPCacheI
1d80: 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 nit==0 ){.
1d90: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 rc = sqlite3Pcac
1da0: 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a heInitialize();.
1db0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
1dc0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1dd0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
1de0: 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 alConfig.isPCach
1df0: 65 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 eInit = 1;.
1e00: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 49 rc = sqlite3OsI
1e10: 6e 69 74 28 29 3b 0a 20 20 20 20 7d 0a 20 20 20 nit();. }.
1e20: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1e30: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 OK ){. sqli
1e40: 74 65 33 50 43 61 63 68 65 42 75 66 66 65 72 53 te3PCacheBufferS
1e50: 65 74 75 70 28 20 73 71 6c 69 74 65 33 47 6c 6f etup( sqlite3Glo
1e60: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 2c balConfig.pPage,
1e70: 20 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 . sqli
1e80: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1e90: 73 7a 50 61 67 65 2c 20 73 71 6c 69 74 65 33 47 szPage, sqlite3G
1ea0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 lobalConfig.nPag
1eb0: 65 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 e);. sqlite
1ec0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1ed0: 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a Init = 1;. }.
1ee0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1ef0: 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 72 65 lConfig.inProgre
1f00: 73 73 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 ss = 0;. }. sq
1f10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1f20: 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 e(sqlite3GlobalC
1f30: 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 onfig.pInitMutex
1f40: 29 3b 0a 0a 20 20 2f 2a 20 47 6f 20 62 61 63 6b );.. /* Go back
1f50: 20 75 6e 64 65 72 20 74 68 65 20 73 74 61 74 69 under the stati
1f60: 63 20 6d 75 74 65 78 20 61 6e 64 20 63 6c 65 61 c mutex and clea
1f70: 6e 20 75 70 20 74 68 65 20 72 65 63 75 72 73 69 n up the recursi
1f80: 76 65 0a 20 20 2a 2a 20 6d 75 74 65 78 20 74 6f ve. ** mutex to
1f90: 20 70 72 65 76 65 6e 74 20 61 20 72 65 73 6f 75 prevent a resou
1fa0: 72 63 65 20 6c 65 61 6b 2e 0a 20 20 2a 2f 0a 20 rce leak.. */.
1fb0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
1fc0: 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 nter(pMaster);.
1fd0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1fe0: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
1ff0: 65 78 2d 2d 3b 0a 20 20 69 66 28 20 73 71 6c 69 ex--;. if( sqli
2000: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2010: 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 3c 3d 30 nRefInitMutex<=0
2020: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
2030: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2040: 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 fig.nRefInitMute
2050: 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 x==0 );. sqli
2060: 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 73 te3_mutex_free(s
2070: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2080: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a ig.pInitMutex);.
2090: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
20a0: 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 lConfig.pInitMut
20b0: 65 78 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 ex = 0;. }. sq
20c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
20d0: 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 2f e(pMaster);.. /
20e0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
20f0: 69 73 20 6a 75 73 74 20 61 20 73 61 6e 69 74 79 is just a sanity
2100: 20 63 68 65 63 6b 20 74 6f 20 6d 61 6b 65 20 73 check to make s
2110: 75 72 65 20 53 51 4c 69 74 65 20 68 61 73 0a 20 ure SQLite has.
2120: 20 2a 2a 20 62 65 65 6e 20 63 6f 6d 70 69 6c 65 ** been compile
2130: 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 49 74 d correctly. It
2140: 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f is important to
2150: 20 72 75 6e 20 74 68 69 73 20 63 6f 64 65 2c 20 run this code,
2160: 62 75 74 0a 20 20 2a 2a 20 77 65 20 64 6f 6e 27 but. ** we don'
2170: 74 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 69 74 t want to run it
2180: 20 74 6f 6f 20 6f 66 74 65 6e 20 61 6e 64 20 73 too often and s
2190: 6f 61 6b 20 75 70 20 43 50 55 20 63 79 63 6c 65 oak up CPU cycle
21a0: 73 20 66 6f 72 20 6e 6f 0a 20 20 2a 2a 20 72 65 s for no. ** re
21b0: 61 73 6f 6e 2e 20 20 53 6f 20 77 65 20 72 75 6e ason. So we run
21c0: 20 69 74 20 6f 6e 63 65 20 64 75 72 69 6e 67 20 it once during
21d0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a initialization..
21e0: 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 */.#ifndef NDE
21f0: 42 55 47 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 BUG.#ifndef SQLI
2200: 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 TE_OMIT_FLOATING
2210: 5f 50 4f 49 4e 54 0a 20 20 2f 2a 20 54 68 69 73 _POINT. /* This
2220: 20 73 65 63 74 69 6f 6e 20 6f 66 20 63 6f 64 65 section of code
2230: 27 73 20 6f 6e 6c 79 20 22 6f 75 74 70 75 74 22 's only "output"
2240: 20 69 73 20 76 69 61 20 61 73 73 65 72 74 28 29 is via assert()
2250: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 2a 2f 0a statements. */.
2260: 20 20 69 66 20 28 20 72 63 3d 3d 53 51 4c 49 54 if ( rc==SQLIT
2270: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 75 36 34 20 E_OK ){. u64
2280: 78 20 3d 20 28 28 28 75 36 34 29 31 29 3c 3c 36 x = (((u64)1)<<6
2290: 33 29 2d 31 3b 0a 20 20 20 20 64 6f 75 62 6c 65 3)-1;. double
22a0: 20 79 3b 0a 20 20 20 20 61 73 73 65 72 74 28 73 y;. assert(s
22b0: 69 7a 65 6f 66 28 78 29 3d 3d 38 29 3b 0a 20 20 izeof(x)==8);.
22c0: 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 28 assert(sizeof(
22d0: 78 29 3d 3d 73 69 7a 65 6f 66 28 79 29 29 3b 0a x)==sizeof(y));.
22e0: 20 20 20 20 6d 65 6d 63 70 79 28 26 79 2c 20 26 memcpy(&y, &
22f0: 78 2c 20 38 29 3b 0a 20 20 20 20 61 73 73 65 72 x, 8);. asser
2300: 74 28 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 t( sqlite3IsNaN(
2310: 79 29 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 y) );. }.#endif
2320: 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 44 6f .#endif.. /* Do
2330: 20 65 78 74 72 61 20 69 6e 69 74 69 61 6c 69 7a extra initializ
2340: 61 74 69 6f 6e 20 73 74 65 70 73 20 72 65 71 75 ation steps requ
2350: 65 73 74 65 64 20 62 79 20 74 68 65 20 53 51 4c ested by the SQL
2360: 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 ITE_EXTRA_INIT.
2370: 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 ** compile-time
2380: 20 6f 70 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 option.. */.#i
2390: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 58 54 52 fdef SQLITE_EXTR
23a0: 41 5f 49 4e 49 54 0a 20 20 69 66 28 20 72 63 3d A_INIT. if( rc=
23b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 73 71 =SQLITE_OK && sq
23c0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
23d0: 67 2e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20 g.isInit ){.
23e0: 69 6e 74 20 53 51 4c 49 54 45 5f 45 58 54 52 41 int SQLITE_EXTRA
23f0: 5f 49 4e 49 54 28 63 6f 6e 73 74 20 63 68 61 72 _INIT(const char
2400: 2a 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c *);. rc = SQL
2410: 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 28 30 ITE_EXTRA_INIT(0
2420: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 );. }.#endif..
2430: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
2440: 2a 0a 2a 2a 20 55 6e 64 6f 20 74 68 65 20 65 66 *.** Undo the ef
2450: 66 65 63 74 73 20 6f 66 20 73 71 6c 69 74 65 33 fects of sqlite3
2460: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 _initialize().
2470: 4d 75 73 74 20 6e 6f 74 20 62 65 20 63 61 6c 6c Must not be call
2480: 65 64 20 77 68 69 6c 65 0a 2a 2a 20 74 68 65 72 ed while.** ther
2490: 65 20 61 72 65 20 6f 75 74 73 74 61 6e 64 69 6e e are outstandin
24a0: 67 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 g database conne
24b0: 63 74 69 6f 6e 73 20 6f 72 20 6d 65 6d 6f 72 79 ctions or memory
24c0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 6f 72 0a allocations or.
24d0: 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 70 61 72 ** while any par
24e0: 74 20 6f 66 20 53 51 4c 69 74 65 20 69 73 20 6f t of SQLite is o
24f0: 74 68 65 72 77 69 73 65 20 69 6e 20 75 73 65 20 therwise in use
2500: 69 6e 20 61 6e 79 20 74 68 72 65 61 64 2e 20 20 in any thread.
2510: 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 This.** routine
2520: 69 73 20 6e 6f 74 20 74 68 72 65 61 64 73 61 66 is not threadsaf
2530: 65 2e 20 20 42 75 74 20 69 74 20 69 73 20 73 61 e. But it is sa
2540: 66 65 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 69 fe to invoke thi
2550: 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 6f 6e 20 s routine.** on
2560: 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73 20 61 when SQLite is a
2570: 6c 72 65 61 64 79 20 73 68 75 74 20 64 6f 77 6e lready shut down
2580: 2e 20 20 49 66 20 53 51 4c 69 74 65 20 69 73 20 . If SQLite is
2590: 61 6c 72 65 61 64 79 20 73 68 75 74 20 64 6f 77 already shut dow
25a0: 6e 0a 2a 2a 20 77 68 65 6e 20 74 68 69 73 20 72 n.** when this r
25b0: 6f 75 74 69 6e 65 20 69 73 20 69 6e 76 6f 6b 65 outine is invoke
25c0: 64 2c 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 d, then this rou
25d0: 74 69 6e 65 20 69 73 20 61 20 68 61 72 6d 6c 65 tine is a harmle
25e0: 73 73 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 ss no-op..*/.int
25f0: 20 73 71 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 sqlite3_shutdow
2600: 6e 28 76 6f 69 64 29 7b 0a 20 20 69 66 28 20 73 n(void){. if( s
2610: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2620: 69 67 2e 69 73 49 6e 69 74 20 29 7b 0a 23 69 66 ig.isInit ){.#if
2630: 64 65 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 def SQLITE_EXTRA
2640: 5f 53 48 55 54 44 4f 57 4e 0a 20 20 20 20 76 6f _SHUTDOWN. vo
2650: 69 64 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f id SQLITE_EXTRA_
2660: 53 48 55 54 44 4f 57 4e 28 76 6f 69 64 29 3b 0a SHUTDOWN(void);.
2670: 20 20 20 20 53 51 4c 49 54 45 5f 45 58 54 52 41 SQLITE_EXTRA
2680: 5f 53 48 55 54 44 4f 57 4e 28 29 3b 0a 23 65 6e _SHUTDOWN();.#en
2690: 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33 5f dif. sqlite3_
26a0: 6f 73 5f 65 6e 64 28 29 3b 0a 20 20 20 20 73 71 os_end();. sq
26b0: 6c 69 74 65 33 5f 72 65 73 65 74 5f 61 75 74 6f lite3_reset_auto
26c0: 5f 65 78 74 65 6e 73 69 6f 6e 28 29 3b 0a 20 20 _extension();.
26d0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
26e0: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 3d 20 30 onfig.isInit = 0
26f0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 ;. }. if( sqli
2700: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2710: 69 73 50 43 61 63 68 65 49 6e 69 74 20 29 7b 0a isPCacheInit ){.
2720: 20 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 sqlite3Pcach
2730: 65 53 68 75 74 64 6f 77 6e 28 29 3b 0a 20 20 20 eShutdown();.
2740: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2750: 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 6e 69 nfig.isPCacheIni
2760: 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 t = 0;. }. if(
2770: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2780: 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 nfig.isMallocIni
2790: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 t ){. sqlite3
27a0: 4d 61 6c 6c 6f 63 45 6e 64 28 29 3b 0a 20 20 20 MallocEnd();.
27b0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
27c0: 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 nfig.isMallocIni
27d0: 74 20 3d 20 30 3b 0a 0a 23 69 66 6e 64 65 66 20 t = 0;..#ifndef
27e0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 55 54 SQLITE_OMIT_SHUT
27f0: 44 4f 57 4e 5f 44 49 52 45 43 54 4f 52 49 45 53 DOWN_DIRECTORIES
2800: 0a 20 20 20 20 2f 2a 20 54 68 65 20 68 65 61 70 . /* The heap
2810: 20 73 75 62 73 79 73 74 65 6d 20 68 61 73 20 6e subsystem has n
2820: 6f 77 20 62 65 65 6e 20 73 68 75 74 64 6f 77 6e ow been shutdown
2830: 20 61 6e 64 20 74 68 65 73 65 20 76 61 6c 75 65 and these value
2840: 73 20 61 72 65 20 73 75 70 70 6f 73 65 64 0a 20 s are supposed.
2850: 20 20 20 2a 2a 20 74 6f 20 62 65 20 4e 55 4c 4c ** to be NULL
2860: 20 6f 72 20 70 6f 69 6e 74 20 74 6f 20 6d 65 6d or point to mem
2870: 6f 72 79 20 74 68 61 74 20 77 61 73 20 6f 62 74 ory that was obt
2880: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 ained from sqlit
2890: 65 33 5f 6d 61 6c 6c 6f 63 28 29 2c 0a 20 20 20 e3_malloc(),.
28a0: 20 2a 2a 20 77 68 69 63 68 20 77 6f 75 6c 64 20 ** which would
28b0: 72 65 6c 79 20 6f 6e 20 74 68 61 74 20 68 65 61 rely on that hea
28c0: 70 20 73 75 62 73 79 73 74 65 6d 3b 20 74 68 65 p subsystem; the
28d0: 72 65 66 6f 72 65 2c 20 6d 61 6b 65 20 73 75 72 refore, make sur
28e0: 65 20 74 68 65 73 65 0a 20 20 20 20 2a 2a 20 76 e these. ** v
28f0: 61 6c 75 65 73 20 63 61 6e 6e 6f 74 20 72 65 66 alues cannot ref
2900: 65 72 20 74 6f 20 68 65 61 70 20 6d 65 6d 6f 72 er to heap memor
2910: 79 20 74 68 61 74 20 77 61 73 20 6a 75 73 74 20 y that was just
2920: 69 6e 76 61 6c 69 64 61 74 65 64 20 77 68 65 6e invalidated when
2930: 20 74 68 65 0a 20 20 20 20 2a 2a 20 68 65 61 70 the. ** heap
2940: 20 73 75 62 73 79 73 74 65 6d 20 77 61 73 20 73 subsystem was s
2950: 68 75 74 64 6f 77 6e 2e 20 20 54 68 69 73 20 69 hutdown. This i
2960: 73 20 6f 6e 6c 79 20 64 6f 6e 65 20 69 66 20 74 s only done if t
2970: 68 65 20 63 75 72 72 65 6e 74 20 63 61 6c 6c 20 he current call
2980: 74 6f 0a 20 20 20 20 2a 2a 20 74 68 69 73 20 66 to. ** this f
2990: 75 6e 63 74 69 6f 6e 20 72 65 73 75 6c 74 65 64 unction resulted
29a0: 20 69 6e 20 74 68 65 20 68 65 61 70 20 73 75 62 in the heap sub
29b0: 73 79 73 74 65 6d 20 61 63 74 75 61 6c 6c 79 20 system actually
29c0: 62 65 69 6e 67 20 73 68 75 74 64 6f 77 6e 2e 0a being shutdown..
29d0: 20 20 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 */. sqlit
29e0: 65 33 5f 64 61 74 61 5f 64 69 72 65 63 74 6f 72 e3_data_director
29f0: 79 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 y = 0;. sqlit
2a00: 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 74 6f 72 e3_temp_director
2a10: 79 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 y = 0;.#endif.
2a20: 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 }. if( sqlite3G
2a30: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 lobalConfig.isMu
2a40: 74 65 78 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 texInit ){. s
2a50: 71 6c 69 74 65 33 4d 75 74 65 78 45 6e 64 28 29 qlite3MutexEnd()
2a60: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f ;. sqlite3Glo
2a70: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 balConfig.isMute
2a80: 78 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 0a xInit = 0;. }..
2a90: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2aa0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 OK;.}../*.** Thi
2ab0: 73 20 41 50 49 20 61 6c 6c 6f 77 73 20 61 70 70 s API allows app
2ac0: 6c 69 63 61 74 69 6f 6e 73 20 74 6f 20 6d 6f 64 lications to mod
2ad0: 69 66 79 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 ify the global c
2ae0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 66 0a onfiguration of.
2af0: 2a 2a 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 ** the SQLite li
2b00: 62 72 61 72 79 20 61 74 20 72 75 6e 2d 74 69 6d brary at run-tim
2b10: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f e..**.** This ro
2b20: 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c utine should onl
2b30: 79 20 62 65 20 63 61 6c 6c 65 64 20 77 68 65 6e y be called when
2b40: 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 there are no ou
2b50: 74 73 74 61 6e 64 69 6e 67 0a 2a 2a 20 64 61 74 tstanding.** dat
2b60: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
2b70: 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f s or memory allo
2b80: 63 61 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 72 cations. This r
2b90: 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 0a 2a 2a outine is not.**
2ba0: 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 46 61 threadsafe. Fa
2bb0: 69 6c 75 72 65 20 74 6f 20 68 65 65 64 20 74 68 ilure to heed th
2bc0: 65 73 65 20 77 61 72 6e 69 6e 67 73 20 63 61 6e ese warnings can
2bd0: 20 6c 65 61 64 20 74 6f 20 75 6e 70 72 65 64 69 lead to unpredi
2be0: 63 74 61 62 6c 65 0a 2a 2a 20 62 65 68 61 76 69 ctable.** behavi
2bf0: 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 or..*/.int sqlit
2c00: 65 33 5f 63 6f 6e 66 69 67 28 69 6e 74 20 6f 70 e3_config(int op
2c10: 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 , ...){. va_lis
2c20: 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d t ap;. int rc =
2c30: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f SQLITE_OK;.. /
2c40: 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 * sqlite3_config
2c50: 28 29 20 73 68 61 6c 6c 20 72 65 74 75 72 6e 20 () shall return
2c60: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 69 66 SQLITE_MISUSE if
2c70: 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 it is invoked w
2c80: 68 69 6c 65 0a 20 20 2a 2a 20 74 68 65 20 53 51 hile. ** the SQ
2c90: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 69 73 20 Lite library is
2ca0: 69 6e 20 75 73 65 2e 20 2a 2f 0a 20 20 69 66 28 in use. */. if(
2cb0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2cc0: 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 65 nfig.isInit ) re
2cd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
2ce0: 53 45 5f 42 4b 50 54 3b 0a 0a 20 20 76 61 5f 73 SE_BKPT;.. va_s
2cf0: 74 61 72 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 tart(ap, op);.
2d00: 73 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 0a 20 switch( op ){..
2d10: 20 20 20 2f 2a 20 4d 75 74 65 78 20 63 6f 6e 66 /* Mutex conf
2d20: 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e iguration option
2d30: 73 20 61 72 65 20 6f 6e 6c 79 20 61 76 61 69 6c s are only avail
2d40: 61 62 6c 65 20 69 6e 20 61 20 74 68 72 65 61 64 able in a thread
2d50: 73 61 66 65 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 safe. ** comp
2d60: 69 6c 65 2e 20 0a 20 20 20 20 2a 2f 0a 23 69 66 ile. . */.#if
2d70: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2d80: 54 48 52 45 41 44 53 41 46 45 29 20 26 26 20 53 THREADSAFE) && S
2d90: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
2da0: 3e 30 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 >0. case SQLI
2db0: 54 45 5f 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 TE_CONFIG_SINGLE
2dc0: 54 48 52 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 THREAD: {.
2dd0: 2f 2a 20 44 69 73 61 62 6c 65 20 61 6c 6c 20 6d /* Disable all m
2de0: 75 74 65 78 69 6e 67 20 2a 2f 0a 20 20 20 20 20 utexing */.
2df0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2e00: 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 nfig.bCoreMutex
2e10: 3d 20 30 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 = 0;. sqlit
2e20: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
2e30: 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 0a 20 FullMutex = 0;.
2e40: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
2e50: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
2e60: 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48 E_CONFIG_MULTITH
2e70: 52 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a READ: {. /*
2e80: 20 44 69 73 61 62 6c 65 20 6d 75 74 65 78 69 6e Disable mutexin
2e90: 67 20 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f g of database co
2ea0: 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 nnections */.
2eb0: 20 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6d 75 74 /* Enable mut
2ec0: 65 78 69 6e 67 20 6f 66 20 63 6f 72 65 20 64 61 exing of core da
2ed0: 74 61 20 73 74 72 75 63 74 75 72 65 73 20 2a 2f ta structures */
2ee0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2ef0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 obalConfig.bCore
2f00: 4d 75 74 65 78 20 3d 20 31 3b 0a 20 20 20 20 20 Mutex = 1;.
2f10: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2f20: 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 nfig.bFullMutex
2f30: 3d 20 30 3b 0a 20 20 20 20 20 20 62 72 65 61 6b = 0;. break
2f40: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 ;. }. case
2f50: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 SQLITE_CONFIG_S
2f60: 45 52 49 41 4c 49 5a 45 44 3a 20 7b 0a 20 20 20 ERIALIZED: {.
2f70: 20 20 20 2f 2a 20 45 6e 61 62 6c 65 20 61 6c 6c /* Enable all
2f80: 20 6d 75 74 65 78 69 6e 67 20 2a 2f 0a 20 20 20 mutexing */.
2f90: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2fa0: 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 Config.bCoreMute
2fb0: 78 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c x = 1;. sql
2fc0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2fd0: 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 31 3b .bFullMutex = 1;
2fe0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
2ff0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
3000: 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 54 45 58 ITE_CONFIG_MUTEX
3010: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 53 70 65 : {. /* Spe
3020: 63 69 66 79 20 61 6e 20 61 6c 74 65 72 6e 61 74 cify an alternat
3030: 69 76 65 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d ive mutex implem
3040: 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 entation */.
3050: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
3060: 6f 6e 66 69 67 2e 6d 75 74 65 78 20 3d 20 2a 76 onfig.mutex = *v
3070: 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 a_arg(ap, sqlite
3080: 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 2a 3_mutex_methods*
3090: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
30a0: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 }. case S
30b0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 QLITE_CONFIG_GET
30c0: 4d 55 54 45 58 3a 20 7b 0a 20 20 20 20 20 20 2f MUTEX: {. /
30d0: 2a 20 52 65 74 72 69 65 76 65 20 74 68 65 20 63 * Retrieve the c
30e0: 75 72 72 65 6e 74 20 6d 75 74 65 78 20 69 6d 70 urrent mutex imp
30f0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 lementation */.
3100: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
3110: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d sqlite3_mutex_m
3120: 65 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 ethods*) = sqlit
3130: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3140: 75 74 65 78 3b 0a 20 20 20 20 20 20 62 72 65 61 utex;. brea
3150: 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a k;. }.#endif.
3160: 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 .. case SQLIT
3170: 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 3a E_CONFIG_MALLOC:
3180: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 53 70 65 63 {. /* Spec
3190: 69 66 79 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 ify an alternati
31a0: 76 65 20 6d 61 6c 6c 6f 63 20 69 6d 70 6c 65 6d ve malloc implem
31b0: 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 entation */.
31c0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
31d0: 6f 6e 66 69 67 2e 6d 20 3d 20 2a 76 61 5f 61 72 onfig.m = *va_ar
31e0: 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 g(ap, sqlite3_me
31f0: 6d 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 m_methods*);.
3200: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
3210: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
3220: 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 CONFIG_GETMALLOC
3230: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 74 : {. /* Ret
3240: 72 69 65 76 65 20 74 68 65 20 63 75 72 72 65 6e rieve the curren
3250: 74 20 6d 61 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 t malloc() imple
3260: 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 mentation */.
3270: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c if( sqlite3Gl
3280: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 obalConfig.m.xMa
3290: 6c 6c 6f 63 3d 3d 30 20 29 20 73 71 6c 69 74 65 lloc==0 ) sqlite
32a0: 33 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 28 29 3MemSetDefault()
32b0: 3b 0a 20 20 20 20 20 20 2a 76 61 5f 61 72 67 28 ;. *va_arg(
32c0: 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f ap, sqlite3_mem_
32d0: 6d 65 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 methods*) = sqli
32e0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
32f0: 6d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a m;. break;.
3300: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 }. case S
3310: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d QLITE_CONFIG_MEM
3320: 53 54 41 54 55 53 3a 20 7b 0a 20 20 20 20 20 20 STATUS: {.
3330: 2f 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 /* Enable or dis
3340: 61 62 6c 65 20 74 68 65 20 6d 61 6c 6c 6f 63 20 able the malloc
3350: 73 74 61 74 75 73 20 63 6f 6c 6c 65 63 74 69 6f status collectio
3360: 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 n */. sqlit
3370: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
3380: 4d 65 6d 73 74 61 74 20 3d 20 76 61 5f 61 72 67 Memstat = va_arg
3390: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
33a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
33b0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
33c0: 4e 46 49 47 5f 53 43 52 41 54 43 48 3a 20 7b 0a NFIG_SCRATCH: {.
33d0: 20 20 20 20 20 20 2f 2a 20 44 65 73 69 67 6e 61 /* Designa
33e0: 74 65 20 61 20 62 75 66 66 65 72 20 66 6f 72 20 te a buffer for
33f0: 73 63 72 61 74 63 68 20 6d 65 6d 6f 72 79 20 73 scratch memory s
3400: 70 61 63 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 pace */. sq
3410: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3420: 67 2e 70 53 63 72 61 74 63 68 20 3d 20 76 61 5f g.pScratch = va_
3430: 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a arg(ap, void*);.
3440: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3450: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 balConfig.szScra
3460: 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 2c tch = va_arg(ap,
3470: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c int);. sql
3480: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3490: 2e 6e 53 63 72 61 74 63 68 20 3d 20 76 61 5f 61 .nScratch = va_a
34a0: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
34b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
34c0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
34d0: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 CONFIG_PAGECACHE
34e0: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 44 65 73 : {. /* Des
34f0: 69 67 6e 61 74 65 20 61 20 62 75 66 66 65 72 20 ignate a buffer
3500: 66 6f 72 20 70 61 67 65 20 63 61 63 68 65 20 6d for page cache m
3510: 65 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 emory space */.
3520: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
3530: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 20 3d alConfig.pPage =
3540: 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
3550: 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 *);. sqlite
3560: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
3570: 50 61 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 Page = va_arg(ap
3580: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 , int);. sq
3590: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
35a0: 67 2e 6e 50 61 67 65 20 3d 20 76 61 5f 61 72 67 g.nPage = va_arg
35b0: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
35c0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
35d0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
35e0: 4f 4e 46 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a ONFIG_PCACHE: {.
35f0: 20 20 20 20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a /* no-op *
3600: 2f 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 /. break;.
3610: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 }. case SQ
3620: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 50 LITE_CONFIG_GETP
3630: 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f CACHE: {. /
3640: 2a 20 6e 6f 77 20 61 6e 20 65 72 72 6f 72 20 2a * now an error *
3650: 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c /. rc = SQL
3660: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 ITE_ERROR;.
3670: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
3680: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
3690: 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 3a 20 7b ONFIG_PCACHE2: {
36a0: 0a 20 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 . /* Specif
36b0: 79 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 y an alternative
36c0: 20 70 61 67 65 20 63 61 63 68 65 20 69 6d 70 6c page cache impl
36d0: 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 ementation */.
36e0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
36f0: 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 32 20 lConfig.pcache2
3700: 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 = *va_arg(ap, sq
3710: 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 lite3_pcache_met
3720: 68 6f 64 73 32 2a 29 3b 0a 20 20 20 20 20 20 62 hods2*);. b
3730: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
3740: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
3750: 49 47 5f 47 45 54 50 43 41 43 48 45 32 3a 20 7b IG_GETPCACHE2: {
3760: 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
3770: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
3780: 63 61 63 68 65 32 2e 78 49 6e 69 74 3d 3d 30 20 cache2.xInit==0
3790: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
37a0: 65 33 50 43 61 63 68 65 53 65 74 44 65 66 61 75 e3PCacheSetDefau
37b0: 6c 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 lt();. }.
37c0: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
37d0: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d sqlite3_pcache_m
37e0: 65 74 68 6f 64 73 32 2a 29 20 3d 20 73 71 6c 69 ethods2*) = sqli
37f0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3800: 70 63 61 63 68 65 32 3b 0a 20 20 20 20 20 20 62 pcache2;. b
3810: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 reak;. }..#if
3820: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
3830: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 29 20 ENABLE_MEMSYS3)
3840: 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
3850: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 E_ENABLE_MEMSYS5
3860: 29 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 ). case SQLIT
3870: 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 3a 20 7b E_CONFIG_HEAP: {
3880: 0a 20 20 20 20 20 20 2f 2a 20 44 65 73 69 67 6e . /* Design
3890: 61 74 65 20 61 20 62 75 66 66 65 72 20 66 6f 72 ate a buffer for
38a0: 20 68 65 61 70 20 6d 65 6d 6f 72 79 20 73 70 61 heap memory spa
38b0: 63 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 ce */. sqli
38c0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
38d0: 70 48 65 61 70 20 3d 20 76 61 5f 61 72 67 28 61 pHeap = va_arg(a
38e0: 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 p, void*);.
38f0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3900: 6e 66 69 67 2e 6e 48 65 61 70 20 3d 20 76 61 5f nfig.nHeap = va_
3910: 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
3920: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3930: 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 lConfig.mnReq =
3940: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
3950: 0a 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 .. if( sqli
3960: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3970: 6d 6e 52 65 71 3c 31 20 29 7b 0a 20 20 20 20 20 mnReq<1 ){.
3980: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
3990: 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 31 Config.mnReq = 1
39a0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 ;. }else if
39b0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
39c0: 6f 6e 66 69 67 2e 6d 6e 52 65 71 3e 28 31 3c 3c onfig.mnReq>(1<<
39d0: 31 32 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 12) ){. /
39e0: 2a 20 63 61 70 20 6d 69 6e 20 72 65 71 75 65 73 * cap min reques
39f0: 74 20 73 69 7a 65 20 61 74 20 32 5e 31 32 20 2a t size at 2^12 *
3a00: 2f 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 /. sqlite
3a10: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 3GlobalConfig.mn
3a20: 52 65 71 20 3d 20 28 31 3c 3c 31 32 29 3b 0a 20 Req = (1<<12);.
3a30: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 }.. if
3a40: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
3a50: 6f 6e 66 69 67 2e 70 48 65 61 70 3d 3d 30 20 29 onfig.pHeap==0 )
3a60: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 {. /* If
3a70: 74 68 65 20 68 65 61 70 20 70 6f 69 6e 74 65 72 the heap pointer
3a80: 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 is NULL, then r
3a90: 65 73 74 6f 72 65 20 74 68 65 20 6d 61 6c 6c 6f estore the mallo
3aa0: 63 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e c implementation
3ab0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b . ** back
3ac0: 20 74 6f 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 to NULL pointer
3ad0: 73 20 74 6f 6f 2e 20 20 54 68 69 73 20 77 69 6c s too. This wil
3ae0: 6c 20 63 61 75 73 65 20 74 68 65 20 6d 61 6c 6c l cause the mall
3af0: 6f 63 20 74 6f 20 67 6f 0a 20 20 20 20 20 20 20 oc to go.
3b00: 20 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74 73 20 ** back to its
3b10: 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e default implemen
3b20: 74 61 74 69 6f 6e 20 77 68 65 6e 20 73 71 6c 69 tation when sqli
3b30: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
3b40: 20 69 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 72 is. ** r
3b50: 75 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 un.. */.
3b60: 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26 73 memset(&s
3b70: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3b80: 69 67 2e 6d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 ig.m, 0, sizeof(
3b90: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3ba0: 66 69 67 2e 6d 29 29 3b 0a 20 20 20 20 20 20 7d fig.m));. }
3bb0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a else{. /*
3bc0: 20 54 68 65 20 68 65 61 70 20 70 6f 69 6e 74 65 The heap pointe
3bd0: 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 r is not NULL, t
3be0: 68 65 6e 20 69 6e 73 74 61 6c 6c 20 6f 6e 65 20 hen install one
3bf0: 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a of the. *
3c00: 2a 20 6d 65 6d 35 2e 63 2f 6d 65 6d 33 2e 63 20 * mem5.c/mem3.c
3c10: 6d 65 74 68 6f 64 73 2e 20 49 66 20 6e 65 69 74 methods. If neit
3c20: 68 65 72 20 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 her ENABLE_MEMSY
3c30: 53 33 20 6e 6f 72 0a 20 20 20 20 20 20 20 20 2a S3 nor. *
3c40: 2a 20 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 * ENABLE_MEMSYS5
3c50: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 72 65 74 is defined, ret
3c60: 75 72 6e 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 urn an error..
3c70: 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 66 20 */.#ifdef
3c80: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
3c90: 4d 53 59 53 33 0a 20 20 20 20 20 20 20 20 73 71 MSYS3. sq
3ca0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3cb0: 67 2e 6d 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 g.m = *sqlite3Me
3cc0: 6d 47 65 74 4d 65 6d 73 79 73 33 28 29 3b 0a 23 mGetMemsys3();.#
3cd0: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
3ce0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
3cf0: 53 35 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 S5. sqlit
3d00: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3d10: 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 = *sqlite3MemGe
3d20: 74 4d 65 6d 73 79 73 35 28 29 3b 0a 23 65 6e 64 tMemsys5();.#end
3d30: 69 66 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 if. }.
3d40: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 break;. }.#e
3d50: 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 20 53 ndif.. case S
3d60: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 4f QLITE_CONFIG_LOO
3d70: 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 KASIDE: {.
3d80: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3d90: 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 20 fig.szLookaside
3da0: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
3db0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
3dc0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f GlobalConfig.nLo
3dd0: 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 67 okaside = va_arg
3de0: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
3df0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
3e00: 20 20 0a 20 20 20 20 2f 2a 20 52 65 63 6f 72 64 . /* Record
3e10: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 a pointer to th
3e20: 65 20 6c 6f 67 67 65 72 20 66 75 6e 63 63 74 69 e logger funccti
3e30: 6f 6e 20 61 6e 64 20 69 74 73 20 66 69 72 73 74 on and its first
3e40: 20 61 72 67 75 6d 65 6e 74 2e 0a 20 20 20 20 2a argument.. *
3e50: 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 * The default is
3e60: 20 4e 55 4c 4c 2e 20 20 4c 6f 67 67 69 6e 67 20 NULL. Logging
3e70: 69 73 20 64 69 73 61 62 6c 65 64 20 69 66 20 74 is disabled if t
3e80: 68 65 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e he function poin
3e90: 74 65 72 20 69 73 0a 20 20 20 20 2a 2a 20 4e 55 ter is. ** NU
3ea0: 4c 4c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 LL.. */. c
3eb0: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
3ec0: 47 5f 4c 4f 47 3a 20 7b 0a 20 20 20 20 20 20 2f G_LOG: {. /
3ed0: 2a 20 4d 53 56 43 20 69 73 20 70 69 63 6b 79 20 * MSVC is picky
3ee0: 61 62 6f 75 74 20 70 75 6c 6c 69 6e 67 20 66 75 about pulling fu
3ef0: 6e 63 20 70 74 72 73 20 66 72 6f 6d 20 76 61 20 nc ptrs from va
3f00: 6c 69 73 74 73 2e 0a 20 20 20 20 20 20 2a 2a 20 lists.. **
3f10: 68 74 74 70 3a 2f 2f 73 75 70 70 6f 72 74 2e 6d http://support.m
3f20: 69 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 6b 62 2f icrosoft.com/kb/
3f30: 34 37 39 36 31 0a 20 20 20 20 20 20 2a 2a 20 73 47961. ** s
3f40: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3f50: 69 67 2e 78 4c 6f 67 20 3d 20 76 61 5f 61 72 67 ig.xLog = va_arg
3f60: 28 61 70 2c 20 76 6f 69 64 28 2a 29 28 76 6f 69 (ap, void(*)(voi
3f70: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 d*,int,const cha
3f80: 72 2a 29 29 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 r*));. */.
3f90: 20 20 20 20 20 74 79 70 65 64 65 66 20 76 6f 69 typedef voi
3fa0: 64 28 2a 4c 4f 47 46 55 4e 43 5f 74 29 28 76 6f d(*LOGFUNC_t)(vo
3fb0: 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 id*,int,const ch
3fc0: 61 72 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 ar*);. sqli
3fd0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3fe0: 78 4c 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 xLog = va_arg(ap
3ff0: 2c 20 4c 4f 47 46 55 4e 43 5f 74 29 3b 0a 20 20 , LOGFUNC_t);.
4000: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4010: 6c 43 6f 6e 66 69 67 2e 70 4c 6f 67 41 72 67 20 lConfig.pLogArg
4020: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
4030: 64 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b d*);. break
4040: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 ;. }.. cas
4050: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
4060: 55 52 49 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c URI: {. sql
4070: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4080: 2e 62 4f 70 65 6e 55 72 69 20 3d 20 76 61 5f 61 .bOpenUri = va_a
4090: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
40a0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
40b0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
40c0: 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 _CONFIG_COVERING
40d0: 5f 49 4e 44 45 58 5f 53 43 41 4e 3a 20 7b 0a 20 _INDEX_SCAN: {.
40e0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
40f0: 61 6c 43 6f 6e 66 69 67 2e 62 55 73 65 43 69 73 alConfig.bUseCis
4100: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
4110: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
4120: 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 . }..#ifdef S
4130: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c QLITE_ENABLE_SQL
4140: 4c 4f 47 0a 20 20 20 20 63 61 73 65 20 53 51 4c LOG. case SQL
4150: 49 54 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f ITE_CONFIG_SQLLO
4160: 47 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 G: {. typed
4170: 65 66 20 76 6f 69 64 28 2a 53 51 4c 4c 4f 47 46 ef void(*SQLLOGF
4180: 55 4e 43 5f 74 29 28 76 6f 69 64 2a 2c 20 73 71 UNC_t)(void*, sq
4190: 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 lite3*, const ch
41a0: 61 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 ar*, int);.
41b0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
41c0: 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 3d 20 76 nfig.xSqllog = v
41d0: 61 5f 61 72 67 28 61 70 2c 20 53 51 4c 4c 4f 47 a_arg(ap, SQLLOG
41e0: 46 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 FUNC_t);. s
41f0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
4200: 69 67 2e 70 53 71 6c 6c 6f 67 41 72 67 20 3d 20 ig.pSqllogArg =
4210: 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 20 va_arg(ap, void
4220: 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b *);. break;
4230: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 . }.#endif..
4240: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
4250: 4f 4e 46 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 3a ONFIG_MMAP_SIZE:
4260: 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
4270: 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 20 3d 20 _int64 szMmap =
4280: 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 va_arg(ap, sqlit
4290: 65 33 5f 69 6e 74 36 34 29 3b 0a 20 20 20 20 20 e3_int64);.
42a0: 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6d sqlite3_int64 m
42b0: 78 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 61 xMmap = va_arg(a
42c0: 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 p, sqlite3_int64
42d0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 6d 78 4d );. if( mxM
42e0: 6d 61 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 70 3e map<0 || mxMmap>
42f0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
4300: 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 20 20 SIZE ){.
4310: 6d 78 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f mxMmap = SQLITE_
4320: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 MAX_MMAP_SIZE;.
4330: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
4340: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4350: 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 4d 6d 61 70 .mxMmap = mxMmap
4360: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 7a 4d 6d ;. if( szMm
4370: 61 70 3c 30 20 29 20 73 7a 4d 6d 61 70 20 3d 20 ap<0 ) szMmap =
4380: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
4390: 4d 41 50 5f 53 49 5a 45 3b 0a 20 20 20 20 20 20 MAP_SIZE;.
43a0: 69 66 28 20 73 7a 4d 6d 61 70 3e 6d 78 4d 6d 61 if( szMmap>mxMma
43b0: 70 29 20 73 7a 4d 6d 61 70 20 3d 20 6d 78 4d 6d p) szMmap = mxMm
43c0: 61 70 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ap;. sqlite
43d0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
43e0: 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b 0a 20 Mmap = szMmap;.
43f0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
4400: 7d 0a 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 }.. default:
4410: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
4420: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 ITE_ERROR;.
4430: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
4440: 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a }. va_end(ap);.
4450: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
4460: 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 20 74 68 65 /*.** Set up the
4470: 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 lookaside buffe
4480: 72 73 20 66 6f 72 20 61 20 64 61 74 61 62 61 73 rs for a databas
4490: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2a e connection..**
44a0: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
44b0: 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 0a K on success. .
44c0: 2a 2a 20 49 66 20 6c 6f 6f 6b 61 73 69 64 65 20 ** If lookaside
44d0: 69 73 20 61 6c 72 65 61 64 79 20 61 63 74 69 76 is already activ
44e0: 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 e, return SQLITE
44f0: 5f 42 55 53 59 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 _BUSY..**.** The
4500: 20 73 7a 20 70 61 72 61 6d 65 74 65 72 20 69 73 sz parameter is
4510: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
4520: 79 74 65 73 20 69 6e 20 65 61 63 68 20 6c 6f 6f ytes in each loo
4530: 6b 61 73 69 64 65 20 73 6c 6f 74 2e 0a 2a 2a 20 kaside slot..**
4540: 54 68 65 20 63 6e 74 20 70 61 72 61 6d 65 74 65 The cnt paramete
4550: 72 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 r is the number
4560: 6f 66 20 73 6c 6f 74 73 2e 20 20 49 66 20 70 53 of slots. If pS
4570: 74 61 72 74 20 69 73 20 4e 55 4c 4c 20 74 68 65 tart is NULL the
4580: 0a 2a 2a 20 73 70 61 63 65 20 66 6f 72 20 74 68 .** space for th
4590: 65 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f e lookaside memo
45a0: 72 79 20 69 73 20 6f 62 74 61 69 6e 65 64 20 66 ry is obtained f
45b0: 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c rom sqlite3_mall
45c0: 6f 63 28 29 2e 0a 2a 2a 20 49 66 20 70 53 74 61 oc()..** If pSta
45d0: 72 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 rt is not NULL t
45e0: 68 65 6e 20 69 74 20 69 73 20 73 7a 2a 63 6e 74 hen it is sz*cnt
45f0: 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 bytes of memory
4600: 20 74 6f 20 75 73 65 20 66 6f 72 0a 2a 2a 20 74 to use for.** t
4610: 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d he lookaside mem
4620: 6f 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ory..*/.static i
4630: 6e 74 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 nt setupLookasid
4640: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 e(sqlite3 *db, v
4650: 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 73 oid *pBuf, int s
4660: 7a 2c 20 69 6e 74 20 63 6e 74 29 7b 0a 20 20 76 z, int cnt){. v
4670: 6f 69 64 20 2a 70 53 74 61 72 74 3b 0a 20 20 69 oid *pStart;. i
4680: 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 f( db->lookaside
4690: 2e 6e 4f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 .nOut ){. ret
46a0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
46b0: 0a 20 20 7d 0a 20 20 2f 2a 20 46 72 65 65 20 61 . }. /* Free a
46c0: 6e 79 20 65 78 69 73 74 69 6e 67 20 6c 6f 6f 6b ny existing look
46d0: 61 73 69 64 65 20 62 75 66 66 65 72 20 66 6f 72 aside buffer for
46e0: 20 74 68 69 73 20 68 61 6e 64 6c 65 20 62 65 66 this handle bef
46f0: 6f 72 65 0a 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 ore. ** allocat
4700: 69 6e 67 20 61 20 6e 65 77 20 6f 6e 65 20 73 6f ing a new one so
4710: 20 77 65 20 64 6f 6e 27 74 20 68 61 76 65 20 74 we don't have t
4720: 6f 20 68 61 76 65 20 73 70 61 63 65 20 66 6f 72 o have space for
4730: 20 0a 20 20 2a 2a 20 62 6f 74 68 20 61 74 20 74 . ** both at t
4740: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 20 20 he same time..
4750: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f */. if( db->loo
4760: 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 kaside.bMalloced
4770: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ){. sqlite3_
4780: 66 72 65 65 28 64 62 2d 3e 6c 6f 6f 6b 61 73 69 free(db->lookasi
4790: 64 65 2e 70 53 74 61 72 74 29 3b 0a 20 20 7d 0a de.pStart);. }.
47a0: 20 20 2f 2a 20 54 68 65 20 73 69 7a 65 20 6f 66 /* The size of
47b0: 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 73 6c 6f a lookaside slo
47c0: 74 20 61 66 74 65 72 20 52 4f 55 4e 44 44 4f 57 t after ROUNDDOW
47d0: 4e 38 20 6e 65 65 64 73 20 74 6f 20 62 65 20 6c N8 needs to be l
47e0: 61 72 67 65 72 0a 20 20 2a 2a 20 74 68 61 6e 20 arger. ** than
47f0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 62 65 20 a pointer to be
4800: 75 73 65 66 75 6c 2e 0a 20 20 2a 2f 0a 20 20 73 useful.. */. s
4810: 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 73 z = ROUNDDOWN8(s
4820: 7a 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 33 z); /* IMP: R-3
4830: 33 30 33 38 2d 30 39 33 38 32 20 2a 2f 0a 20 20 3038-09382 */.
4840: 69 66 28 20 73 7a 3c 3d 28 69 6e 74 29 73 69 7a if( sz<=(int)siz
4850: 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f eof(LookasideSlo
4860: 74 2a 29 20 29 20 73 7a 20 3d 20 30 3b 0a 20 20 t*) ) sz = 0;.
4870: 69 66 28 20 63 6e 74 3c 30 20 29 20 63 6e 74 20 if( cnt<0 ) cnt
4880: 3d 20 30 3b 0a 20 20 69 66 28 20 73 7a 3d 3d 30 = 0;. if( sz==0
4890: 20 7c 7c 20 63 6e 74 3d 3d 30 20 29 7b 0a 20 20 || cnt==0 ){.
48a0: 20 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 70 53 sz = 0;. pS
48b0: 74 61 72 74 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 tart = 0;. }els
48c0: 65 20 69 66 28 20 70 42 75 66 3d 3d 30 20 29 7b e if( pBuf==0 ){
48d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 42 65 67 69 . sqlite3Begi
48e0: 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b nBenignMalloc();
48f0: 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 73 71 . pStart = sq
4900: 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 2a lite3Malloc( sz*
4910: 63 6e 74 20 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 cnt ); /* IMP:
4920: 52 2d 36 31 39 34 39 2d 33 35 37 32 37 20 2a 2f R-61949-35727 */
4930: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 . sqlite3EndB
4940: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 enignMalloc();.
4950: 20 20 20 69 66 28 20 70 53 74 61 72 74 20 29 20 if( pStart )
4960: 63 6e 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c cnt = sqlite3Mal
4970: 6c 6f 63 53 69 7a 65 28 70 53 74 61 72 74 29 2f locSize(pStart)/
4980: 73 7a 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 sz;. }else{.
4990: 20 70 53 74 61 72 74 20 3d 20 70 42 75 66 3b 0a pStart = pBuf;.
49a0: 20 20 7d 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 }. db->lookas
49b0: 69 64 65 2e 70 53 74 61 72 74 20 3d 20 70 53 74 ide.pStart = pSt
49c0: 61 72 74 3b 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 art;. db->looka
49d0: 73 69 64 65 2e 70 46 72 65 65 20 3d 20 30 3b 0a side.pFree = 0;.
49e0: 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e db->lookaside.
49f0: 73 7a 20 3d 20 28 75 31 36 29 73 7a 3b 0a 20 20 sz = (u16)sz;.
4a00: 69 66 28 20 70 53 74 61 72 74 20 29 7b 0a 20 20 if( pStart ){.
4a10: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 4c 6f 6f int i;. Loo
4a20: 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 3b 0a 20 kasideSlot *p;.
4a30: 20 20 20 61 73 73 65 72 74 28 20 73 7a 20 3e 20 assert( sz >
4a40: 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f 6f 6b (int)sizeof(Look
4a50: 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 3b 0a 20 asideSlot*) );.
4a60: 20 20 20 70 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 p = (Lookasid
4a70: 65 53 6c 6f 74 2a 29 70 53 74 61 72 74 3b 0a 20 eSlot*)pStart;.
4a80: 20 20 20 66 6f 72 28 69 3d 63 6e 74 2d 31 3b 20 for(i=cnt-1;
4a90: 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 i>=0; i--){.
4aa0: 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 64 62 2d p->pNext = db-
4ab0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 >lookaside.pFree
4ac0: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b ;. db->look
4ad0: 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 70 3b aside.pFree = p;
4ae0: 0a 20 20 20 20 20 20 70 20 3d 20 28 4c 6f 6f 6b . p = (Look
4af0: 61 73 69 64 65 53 6c 6f 74 2a 29 26 28 28 75 38 asideSlot*)&((u8
4b00: 2a 29 70 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 0a *)p)[sz];. }.
4b10: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 db->lookasid
4b20: 65 2e 70 45 6e 64 20 3d 20 70 3b 0a 20 20 20 20 e.pEnd = p;.
4b30: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 db->lookaside.bE
4b40: 6e 61 62 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 nabled = 1;.
4b50: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d db->lookaside.bM
4b60: 61 6c 6c 6f 63 65 64 20 3d 20 70 42 75 66 3d 3d alloced = pBuf==
4b70: 30 20 3f 31 3a 30 3b 0a 20 20 7d 65 6c 73 65 7b 0 ?1:0;. }else{
4b80: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
4b90: 64 65 2e 70 45 6e 64 20 3d 20 30 3b 0a 20 20 20 de.pEnd = 0;.
4ba0: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 db->lookaside.b
4bb0: 45 6e 61 62 6c 65 64 20 3d 20 30 3b 0a 20 20 20 Enabled = 0;.
4bc0: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 db->lookaside.b
4bd0: 4d 61 6c 6c 6f 63 65 64 20 3d 20 30 3b 0a 20 20 Malloced = 0;.
4be0: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
4bf0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 E_OK;.}../*.** R
4c00: 65 74 75 72 6e 20 74 68 65 20 6d 75 74 65 78 20 eturn the mutex
4c10: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
4c20: 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 a database conne
4c30: 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c 69 74 65 ction..*/.sqlite
4c40: 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 3_mutex *sqlite3
4c50: 5f 64 62 5f 6d 75 74 65 78 28 73 71 6c 69 74 65 _db_mutex(sqlite
4c60: 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 3 *db){. return
4c70: 20 64 62 2d 3e 6d 75 74 65 78 3b 0a 7d 0a 0a 2f db->mutex;.}../
4c80: 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61 73 20 *.** Free up as
4c90: 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73 20 77 much memory as w
4ca0: 65 20 63 61 6e 20 66 72 6f 6d 20 74 68 65 20 67 e can from the g
4cb0: 69 76 65 6e 20 64 61 74 61 62 61 73 65 0a 2a 2a iven database.**
4cc0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a connection..*/.
4cd0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 5f 72 int sqlite3_db_r
4ce0: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 73 71 elease_memory(sq
4cf0: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e lite3 *db){. in
4d00: 74 20 69 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d t i;. sqlite3_m
4d10: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
4d20: 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 33 utex);. sqlite3
4d30: 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 62 BtreeEnterAll(db
4d40: 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c );. for(i=0; i<
4d50: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 db->nDb; i++){.
4d60: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 Btree *pBt =
4d70: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a db->aDb[i].pBt;.
4d80: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 if( pBt ){.
4d90: 20 20 20 20 20 50 61 67 65 72 20 2a 70 50 61 67 Pager *pPag
4da0: 65 72 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 er = sqlite3Btre
4db0: 65 50 61 67 65 72 28 70 42 74 29 3b 0a 20 20 20 ePager(pBt);.
4dc0: 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
4dd0: 68 72 69 6e 6b 28 70 50 61 67 65 72 29 3b 0a 20 hrink(pPager);.
4de0: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 }. }. sqlit
4df0: 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 e3BtreeLeaveAll(
4e00: 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d db);. sqlite3_m
4e10: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
4e20: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
4e30: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
4e40: 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f .** Configuratio
4e50: 6e 20 73 65 74 74 69 6e 67 73 20 66 6f 72 20 61 n settings for a
4e60: 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 64 61 74 n individual dat
4e70: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
4e80: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
4e90: 64 62 5f 63 6f 6e 66 69 67 28 73 71 6c 69 74 65 db_config(sqlite
4ea0: 33 20 2a 64 62 2c 20 69 6e 74 20 6f 70 2c 20 2e 3 *db, int op, .
4eb0: 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 ..){. va_list a
4ec0: 70 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 76 p;. int rc;. v
4ed0: 61 5f 73 74 61 72 74 28 61 70 2c 20 6f 70 29 3b a_start(ap, op);
4ee0: 0a 20 20 73 77 69 74 63 68 28 20 6f 70 20 29 7b . switch( op ){
4ef0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
4f00: 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 _DBCONFIG_LOOKAS
4f10: 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 76 6f 69 IDE: {. voi
4f20: 64 20 2a 70 42 75 66 20 3d 20 76 61 5f 61 72 67 d *pBuf = va_arg
4f30: 28 61 70 2c 20 76 6f 69 64 2a 29 3b 20 2f 2a 20 (ap, void*); /*
4f40: 49 4d 50 3a 20 52 2d 32 36 38 33 35 2d 31 30 39 IMP: R-26835-109
4f50: 36 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 64 */. int
4f60: 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 sz = va_arg(ap,
4f70: 69 6e 74 29 3b 20 20 20 20 20 20 20 2f 2a 20 49 int); /* I
4f80: 4d 50 3a 20 52 2d 34 37 38 37 31 2d 32 35 39 39 MP: R-47871-2599
4f90: 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 63 4 */. int c
4fa0: 6e 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 nt = va_arg(ap,
4fb0: 69 6e 74 29 3b 20 20 20 20 20 20 2f 2a 20 49 4d int); /* IM
4fc0: 50 3a 20 52 2d 30 34 34 36 30 2d 35 33 33 38 36 P: R-04460-53386
4fd0: 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 73 */. rc = s
4fe0: 65 74 75 70 4c 6f 6f 6b 61 73 69 64 65 28 64 62 etupLookaside(db
4ff0: 2c 20 70 42 75 66 2c 20 73 7a 2c 20 63 6e 74 29 , pBuf, sz, cnt)
5000: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
5010: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 }. default
5020: 3a 20 7b 0a 20 20 20 20 20 20 73 74 61 74 69 63 : {. static
5030: 20 63 6f 6e 73 74 20 73 74 72 75 63 74 20 7b 0a const struct {.
5040: 20 20 20 20 20 20 20 20 69 6e 74 20 6f 70 3b 20 int op;
5050: 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 70 63 6f /* The opco
5060: 64 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 de */. u3
5070: 32 20 6d 61 73 6b 3b 20 20 20 20 2f 2a 20 4d 61 2 mask; /* Ma
5080: 73 6b 20 6f 66 20 74 68 65 20 62 69 74 20 69 6e sk of the bit in
5090: 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 73 20 74 sqlite3.flags t
50a0: 6f 20 73 65 74 2f 63 6c 65 61 72 20 2a 2f 0a 20 o set/clear */.
50b0: 20 20 20 20 20 7d 20 61 46 6c 61 67 4f 70 5b 5d } aFlagOp[]
50c0: 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 7b 20 53 = {. { S
50d0: 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 45 QLITE_DBCONFIG_E
50e0: 4e 41 42 4c 45 5f 46 4b 45 59 2c 20 20 20 20 53 NABLE_FKEY, S
50f0: 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 QLITE_ForeignKey
5100: 73 20 20 20 20 7d 2c 0a 20 20 20 20 20 20 20 20 s },.
5110: 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 { SQLITE_DBCONFI
5120: 47 5f 45 4e 41 42 4c 45 5f 54 52 49 47 47 45 52 G_ENABLE_TRIGGER
5130: 2c 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 , SQLITE_EnableT
5140: 72 69 67 67 65 72 20 20 7d 2c 0a 20 20 20 20 20 rigger },.
5150: 20 7d 3b 0a 20 20 20 20 20 20 75 6e 73 69 67 6e };. unsign
5160: 65 64 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 ed int i;.
5170: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
5180: 52 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 32 37 R; /* IMP: R-427
5190: 39 30 2d 32 33 33 37 32 20 2a 2f 0a 20 20 20 20 90-23372 */.
51a0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72 for(i=0; i<Arr
51b0: 61 79 53 69 7a 65 28 61 46 6c 61 67 4f 70 29 3b aySize(aFlagOp);
51c0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 69 i++){. i
51d0: 66 28 20 61 46 6c 61 67 4f 70 5b 69 5d 2e 6f 70 f( aFlagOp[i].op
51e0: 3d 3d 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 ==op ){.
51f0: 20 20 69 6e 74 20 6f 6e 6f 66 66 20 3d 20 76 61 int onoff = va
5200: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
5210: 20 20 20 20 20 20 20 20 20 69 6e 74 20 2a 70 52 int *pR
5220: 65 73 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 es = va_arg(ap,
5230: 69 6e 74 2a 29 3b 0a 20 20 20 20 20 20 20 20 20 int*);.
5240: 20 69 6e 74 20 6f 6c 64 46 6c 61 67 73 20 3d 20 int oldFlags =
5250: 64 62 2d 3e 66 6c 61 67 73 3b 0a 20 20 20 20 20 db->flags;.
5260: 20 20 20 20 20 69 66 28 20 6f 6e 6f 66 66 3e 30 if( onoff>0
5270: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
5280: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 61 46 6c db->flags |= aFl
5290: 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 20 agOp[i].mask;.
52a0: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
52b0: 28 20 6f 6e 6f 66 66 3d 3d 30 20 29 7b 0a 20 20 ( onoff==0 ){.
52c0: 20 20 20 20 20 20 20 20 20 20 64 62 2d 3e 66 6c db->fl
52d0: 61 67 73 20 26 3d 20 7e 61 46 6c 61 67 4f 70 5b ags &= ~aFlagOp[
52e0: 69 5d 2e 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 i].mask;.
52f0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 }. i
5300: 66 28 20 6f 6c 64 46 6c 61 67 73 21 3d 64 62 2d f( oldFlags!=db-
5310: 3e 66 6c 61 67 73 20 29 7b 0a 20 20 20 20 20 20 >flags ){.
5320: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 sqlite3Exp
5330: 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
5340: 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 20 ments(db);.
5350: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
5360: 20 69 66 28 20 70 52 65 73 20 29 7b 0a 20 20 20 if( pRes ){.
5370: 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d *pRes =
5380: 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 61 46 (db->flags & aF
5390: 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 29 21 3d lagOp[i].mask)!=
53a0: 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 0;. }.
53b0: 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
53c0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
53d0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
53e0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
53f0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
5400: 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 29 3b }. va_end(ap);
5410: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
5420: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
5430: 72 75 65 20 69 66 20 74 68 65 20 62 75 66 66 65 rue if the buffe
5440: 72 20 7a 5b 30 2e 2e 6e 2d 31 5d 20 63 6f 6e 74 r z[0..n-1] cont
5450: 61 69 6e 73 20 61 6c 6c 20 73 70 61 63 65 73 2e ains all spaces.
5460: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
5470: 6c 6c 53 70 61 63 65 73 28 63 6f 6e 73 74 20 63 llSpaces(const c
5480: 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a har *z, int n){.
5490: 20 20 77 68 69 6c 65 28 20 6e 3e 30 20 26 26 20 while( n>0 &&
54a0: 7a 5b 6e 2d 31 5d 3d 3d 27 20 27 20 29 7b 20 6e z[n-1]==' ' ){ n
54b0: 2d 2d 3b 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e --; }. return n
54c0: 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 ==0;.}../*.** Th
54d0: 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c is is the defaul
54e0: 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 t collating func
54f0: 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49 4e 41 tion named "BINA
5500: 52 59 22 20 77 68 69 63 68 20 69 73 20 61 6c 77 RY" which is alw
5510: 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 ays.** available
5520: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 ..**.** If the p
5530: 61 64 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 adFlag argument
5540: 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e is not NULL then
5550: 20 73 70 61 63 65 20 70 61 64 64 69 6e 67 20 61 space padding a
5560: 74 20 74 68 65 20 65 6e 64 0a 2a 2a 20 6f 66 20 t the end.** of
5570: 73 74 72 69 6e 67 73 20 69 73 20 69 67 6e 6f 72 strings is ignor
5580: 65 64 2e 20 20 54 68 69 73 20 69 6d 70 6c 65 6d ed. This implem
5590: 65 6e 74 73 20 74 68 65 20 52 54 52 49 4d 20 63 ents the RTRIM c
55a0: 6f 6c 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 ollation..*/.sta
55b0: 74 69 63 20 69 6e 74 20 62 69 6e 43 6f 6c 6c 46 tic int binCollF
55c0: 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 70 61 64 unc(. void *pad
55d0: 46 6c 61 67 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 Flag,. int nKey
55e0: 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 1, const void *p
55f0: 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 Key1,. int nKey
5600: 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 2, const void *p
5610: 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 63 Key2.){. int rc
5620: 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e 4b 65 79 31 , n;. n = nKey1
5630: 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65 79 31 20 3a <nKey2 ? nKey1 :
5640: 20 6e 4b 65 79 32 3b 0a 20 20 72 63 20 3d 20 6d nKey2;. rc = m
5650: 65 6d 63 6d 70 28 70 4b 65 79 31 2c 20 70 4b 65 emcmp(pKey1, pKe
5660: 79 32 2c 20 6e 29 3b 0a 20 20 69 66 28 20 72 63 y2, n);. if( rc
5670: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 ==0 ){. if( p
5680: 61 64 46 6c 61 67 0a 20 20 20 20 20 26 26 20 61 adFlag. && a
5690: 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 72 2a llSpaces(((char*
56a0: 29 70 4b 65 79 31 29 2b 6e 2c 20 6e 4b 65 79 31 )pKey1)+n, nKey1
56b0: 2d 6e 29 0a 20 20 20 20 20 26 26 20 61 6c 6c 53 -n). && allS
56c0: 70 61 63 65 73 28 28 28 63 68 61 72 2a 29 70 4b paces(((char*)pK
56d0: 65 79 32 29 2b 6e 2c 20 6e 4b 65 79 32 2d 6e 29 ey2)+n, nKey2-n)
56e0: 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
56f0: 20 4c 65 61 76 65 20 72 63 20 75 6e 63 68 61 6e Leave rc unchan
5700: 67 65 64 20 61 74 20 30 20 2a 2f 0a 20 20 20 20 ged at 0 */.
5710: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 }else{. rc
5720: 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 79 32 3b = nKey1 - nKey2;
5730: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
5740: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
5750: 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 Another built-i
5760: 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 n collating sequ
5770: 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a ence: NOCASE. .*
5780: 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 74 *.** This collat
5790: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 ing sequence is
57a0: 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 intended to be u
57b0: 73 65 64 20 66 6f 72 20 22 63 61 73 65 20 69 6e sed for "case in
57c0: 64 65 70 65 6e 64 65 6e 74 0a 2a 2a 20 63 6f 6d dependent.** com
57d0: 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 65 parison". SQLite
57e0: 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 's knowledge of
57f0: 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 20 upper and lower
5800: 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 case equivalents
5810: 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c 79 .** extends only
5820: 20 74 6f 20 74 68 65 20 32 36 20 63 68 61 72 61 to the 26 chara
5830: 63 74 65 72 73 20 75 73 65 64 20 69 6e 20 74 68 cters used in th
5840: 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 e English langua
5850: 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 ge..**.** At the
5860: 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 73 moment there is
5870: 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 6d only a UTF-8 im
5880: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f plementation..*/
5890: 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 61 .static int noca
58a0: 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 28 seCollatingFunc(
58b0: 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 . void *NotUsed
58c0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 ,. int nKey1, c
58d0: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 onst void *pKey1
58e0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 ,. int nKey2, c
58f0: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 onst void *pKey2
5900: 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 71 .){. int r = sq
5910: 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28 0a 20 lite3StrNICmp(.
5920: 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68 61 72 (const char
5930: 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 74 *)pKey1, (const
5940: 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 28 char *)pKey2, (
5950: 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e 4b 65 nKey1<nKey2)?nKe
5960: 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 55 4e 55 y1:nKey2);. UNU
5970: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
5980: 74 55 73 65 64 29 3b 0a 20 20 69 66 28 20 30 3d tUsed);. if( 0=
5990: 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e 4b =r ){. r = nK
59a0: 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 ey1-nKey2;. }.
59b0: 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a return r;.}../*
59c0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 52 .** Return the R
59d0: 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 OWID of the most
59e0: 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a recent insert.*
59f0: 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 /.sqlite_int64 s
5a00: 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 qlite3_last_inse
5a10: 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 33 rt_rowid(sqlite3
5a20: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 *db){. return
5a30: 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d db->lastRowid;.}
5a40: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
5a50: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 he number of cha
5a60: 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 nges in the most
5a70: 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 recent call to
5a80: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a sqlite3_exec()..
5a90: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
5aa0: 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a hanges(sqlite3 *
5ab0: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 db){. return db
5ac0: 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a ->nChange;.}../*
5ad0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
5ae0: 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 umber of changes
5af0: 20 73 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 since the datab
5b00: 61 73 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f ase handle was o
5b10: 70 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 pened..*/.int sq
5b20: 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e lite3_total_chan
5b30: 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 ges(sqlite3 *db)
5b40: 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e {. return db->n
5b50: 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a TotalChange;.}..
5b60: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 /*.** Close all
5b70: 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 2e open savepoints.
5b80: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6f This function o
5b90: 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 nly manipulates
5ba0: 66 69 65 6c 64 73 20 6f 66 20 74 68 65 0a 2a 2a fields of the.**
5bb0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
5bc0: 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 6f 65 73 object, it does
5bd0: 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e 79 20 73 not close any s
5be0: 61 76 65 70 6f 69 6e 74 73 20 74 68 61 74 20 6d avepoints that m
5bf0: 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a 20 61 74 ay be open.** at
5c00: 20 74 68 65 20 62 2d 74 72 65 65 2f 70 61 67 65 the b-tree/page
5c10: 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 6f 69 64 r level..*/.void
5c20: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 sqlite3CloseSav
5c30: 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 65 33 20 epoints(sqlite3
5c40: 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 28 20 64 *db){. while( d
5c50: 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 29 7b b->pSavepoint ){
5c60: 0a 20 20 20 20 53 61 76 65 70 6f 69 6e 74 20 2a . Savepoint *
5c70: 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 61 76 65 pTmp = db->pSave
5c80: 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 2d 3e 70 point;. db->p
5c90: 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 54 6d 70 Savepoint = pTmp
5ca0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c ->pNext;. sql
5cb0: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 ite3DbFree(db, p
5cc0: 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e Tmp);. }. db->
5cd0: 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a nSavepoint = 0;.
5ce0: 20 20 64 62 2d 3e 6e 53 74 61 74 65 6d 65 6e 74 db->nStatement
5cf0: 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 69 73 54 72 = 0;. db->isTr
5d00: 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 70 6f 69 ansactionSavepoi
5d10: 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a nt = 0;.}../*.**
5d20: 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 65 73 74 Invoke the dest
5d30: 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 ructor function
5d40: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
5d50: 46 75 6e 63 44 65 66 20 70 2c 20 69 66 20 61 6e FuncDef p, if an
5d60: 79 2e 20 45 78 63 65 70 74 2c 0a 2a 2a 20 69 66 y. Except,.** if
5d70: 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 65 this is not the
5d80: 20 6c 61 73 74 20 63 6f 70 79 20 6f 66 20 74 68 last copy of th
5d90: 65 20 66 75 6e 63 74 69 6f 6e 2c 20 64 6f 20 6e e function, do n
5da0: 6f 74 20 69 6e 76 6f 6b 65 20 69 74 2e 20 4d 75 ot invoke it. Mu
5db0: 6c 74 69 70 6c 65 0a 2a 2a 20 63 6f 70 69 65 73 ltiple.** copies
5dc0: 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 66 75 6e of a single fun
5dd0: 63 74 69 6f 6e 20 61 72 65 20 63 72 65 61 74 65 ction are create
5de0: 64 20 77 68 65 6e 20 63 72 65 61 74 65 5f 66 75 d when create_fu
5df0: 6e 63 74 69 6f 6e 28 29 20 69 73 20 63 61 6c 6c nction() is call
5e00: 65 64 0a 2a 2a 20 77 69 74 68 20 53 51 4c 49 54 ed.** with SQLIT
5e10: 45 5f 41 4e 59 20 61 73 20 74 68 65 20 65 6e 63 E_ANY as the enc
5e20: 6f 64 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 oding..*/.static
5e30: 20 76 6f 69 64 20 66 75 6e 63 74 69 6f 6e 44 65 void functionDe
5e40: 73 74 72 6f 79 28 73 71 6c 69 74 65 33 20 2a 64 stroy(sqlite3 *d
5e50: 62 2c 20 46 75 6e 63 44 65 66 20 2a 70 29 7b 0a b, FuncDef *p){.
5e60: 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 FuncDestructor
5e70: 20 2a 70 44 65 73 74 72 75 63 74 6f 72 20 3d 20 *pDestructor =
5e80: 70 2d 3e 70 44 65 73 74 72 75 63 74 6f 72 3b 0a p->pDestructor;.
5e90: 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f if( pDestructo
5ea0: 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 r ){. pDestru
5eb0: 63 74 6f 72 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 ctor->nRef--;.
5ec0: 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f if( pDestructo
5ed0: 72 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 r->nRef==0 ){.
5ee0: 20 20 20 20 70 44 65 73 74 72 75 63 74 6f 72 2d pDestructor-
5ef0: 3e 78 44 65 73 74 72 6f 79 28 70 44 65 73 74 72 >xDestroy(pDestr
5f00: 75 63 74 6f 72 2d 3e 70 55 73 65 72 44 61 74 61 uctor->pUserData
5f10: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
5f20: 44 62 46 72 65 65 28 64 62 2c 20 70 44 65 73 74 DbFree(db, pDest
5f30: 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 7d 0a 20 ructor);. }.
5f40: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 }.}../*.** Disc
5f50: 6f 6e 6e 65 63 74 20 61 6c 6c 20 73 71 6c 69 74 onnect all sqlit
5f60: 65 33 5f 76 74 61 62 20 6f 62 6a 65 63 74 73 20 e3_vtab objects
5f70: 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 64 that belong to d
5f80: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
5f90: 6f 6e 0a 2a 2a 20 64 62 2e 20 54 68 69 73 20 69 on.** db. This i
5fa0: 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 64 62 s called when db
5fb0: 20 69 73 20 62 65 69 6e 67 20 63 6c 6f 73 65 64 is being closed
5fc0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
5fd0: 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 disconnectAllVt
5fe0: 61 62 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b ab(sqlite3 *db){
5ff0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
6000: 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
6010: 45 0a 20 20 69 6e 74 20 69 3b 0a 20 20 73 71 6c E. int i;. sql
6020: 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c ite3BtreeEnterAl
6030: 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 69 3d 30 l(db);. for(i=0
6040: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b ; i<db->nDb; i++
6050: 29 7b 0a 20 20 20 20 53 63 68 65 6d 61 20 2a 70 ){. Schema *p
6060: 53 63 68 65 6d 61 20 3d 20 64 62 2d 3e 61 44 62 Schema = db->aDb
6070: 5b 69 5d 2e 70 53 63 68 65 6d 61 3b 0a 20 20 20 [i].pSchema;.
6080: 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e if( db->aDb[i].
6090: 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 20 pSchema ){.
60a0: 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a 20 20 HashElem *p;.
60b0: 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 for(p=sqlite
60c0: 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 65 HashFirst(&pSche
60d0: 6d 61 2d 3e 74 62 6c 48 61 73 68 29 3b 20 70 3b ma->tblHash); p;
60e0: 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 p=sqliteHashNex
60f0: 74 28 70 29 29 7b 0a 20 20 20 20 20 20 20 20 54 t(p)){. T
6100: 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 28 54 61 able *pTab = (Ta
6110: 62 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 68 ble *)sqliteHash
6120: 44 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 20 Data(p);.
6130: 20 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 70 if( IsVirtual(p
6140: 54 61 62 29 20 29 20 73 71 6c 69 74 65 33 56 74 Tab) ) sqlite3Vt
6150: 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 64 62 2c abDisconnect(db,
6160: 20 70 54 61 62 29 3b 0a 20 20 20 20 20 20 7d 0a pTab);. }.
6170: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
6180: 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c te3BtreeLeaveAll
6190: 28 64 62 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e (db);.#else. UN
61a0: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 64 USED_PARAMETER(d
61b0: 62 29 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a b);.#endif.}../*
61c0: 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 .** Return TRUE
61d0: 69 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e if database conn
61e0: 65 63 74 69 6f 6e 20 64 62 20 68 61 73 20 75 6e ection db has un
61f0: 66 69 6e 61 6c 69 7a 65 64 20 70 72 65 70 61 72 finalized prepar
6200: 65 64 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 ed.** statements
6210: 20 6f 72 20 75 6e 66 69 6e 69 73 68 65 64 20 73 or unfinished s
6220: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 qlite3_backup ob
6230: 6a 65 63 74 73 2e 20 20 0a 2a 2f 0a 73 74 61 74 jects. .*/.stat
6240: 69 63 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69 6f ic int connectio
6250: 6e 49 73 42 75 73 79 28 73 71 6c 69 74 65 33 20 nIsBusy(sqlite3
6260: 2a 64 62 29 7b 0a 20 20 69 6e 74 20 6a 3b 0a 20 *db){. int j;.
6270: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
6280: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e _mutex_held(db->
6290: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 mutex) );. if(
62a0: 64 62 2d 3e 70 56 64 62 65 20 29 20 72 65 74 75 db->pVdbe ) retu
62b0: 72 6e 20 31 3b 0a 20 20 66 6f 72 28 6a 3d 30 3b rn 1;. for(j=0;
62c0: 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 j<db->nDb; j++)
62d0: 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 {. Btree *pBt
62e0: 20 3d 20 64 62 2d 3e 61 44 62 5b 6a 5d 2e 70 42 = db->aDb[j].pB
62f0: 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20 26 t;. if( pBt &
6300: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 & sqlite3BtreeIs
6310: 49 6e 42 61 63 6b 75 70 28 70 42 74 29 20 29 20 InBackup(pBt) )
6320: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 return 1;. }.
6330: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a return 0;.}../*.
6340: 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 73 ** Close an exis
6350: 74 69 6e 67 20 53 51 4c 69 74 65 20 64 61 74 61 ting SQLite data
6360: 62 61 73 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 base.*/.static i
6370: 6e 74 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 nt sqlite3Close(
6380: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
6390: 20 66 6f 72 63 65 5a 6f 6d 62 69 65 29 7b 0a 20 forceZombie){.
63a0: 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 if( !db ){.
63b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
63c0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c ;. }. if( !sql
63d0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
63e0: 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 ickOrOk(db) ){.
63f0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
6400: 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
6410: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
6420: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
6430: 78 29 3b 0a 0a 20 20 2f 2a 20 46 6f 72 63 65 20 x);.. /* Force
6440: 78 44 69 73 63 6f 6e 6e 65 63 74 20 63 61 6c 6c xDisconnect call
6450: 73 20 6f 6e 20 61 6c 6c 20 76 69 72 74 75 61 6c s on all virtual
6460: 20 74 61 62 6c 65 73 20 2a 2f 0a 20 20 64 69 73 tables */. dis
6470: 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 61 62 28 64 connectAllVtab(d
6480: 62 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 61 20 74 b);.. /* If a t
6490: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 ransaction is op
64a0: 65 6e 2c 20 74 68 65 20 64 69 73 63 6f 6e 6e 65 en, the disconne
64b0: 63 74 41 6c 6c 56 74 61 62 28 29 20 63 61 6c 6c ctAllVtab() call
64c0: 20 61 62 6f 76 65 0a 20 20 2a 2a 20 77 69 6c 6c above. ** will
64d0: 20 6e 6f 74 20 68 61 76 65 20 63 61 6c 6c 65 64 not have called
64e0: 20 74 68 65 20 78 44 69 73 63 6f 6e 6e 65 63 74 the xDisconnect
64f0: 28 29 20 6d 65 74 68 6f 64 20 6f 6e 20 61 6e 79 () method on any
6500: 20 76 69 72 74 75 61 6c 0a 20 20 2a 2a 20 74 61 virtual. ** ta
6510: 62 6c 65 73 20 69 6e 20 74 68 65 20 64 62 2d 3e bles in the db->
6520: 61 56 54 72 61 6e 73 5b 5d 20 61 72 72 61 79 2e aVTrans[] array.
6530: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 The following s
6540: 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 qlite3VtabRollba
6550: 63 6b 28 29 0a 20 20 2a 2a 20 63 61 6c 6c 20 77 ck(). ** call w
6560: 69 6c 6c 20 64 6f 20 73 6f 2e 20 57 65 20 6e 65 ill do so. We ne
6570: 65 64 20 74 6f 20 64 6f 20 74 68 69 73 20 62 65 ed to do this be
6580: 66 6f 72 65 20 74 68 65 20 63 68 65 63 6b 20 66 fore the check f
6590: 6f 72 20 61 63 74 69 76 65 0a 20 20 2a 2a 20 53 or active. ** S
65a0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 62 65 QL statements be
65b0: 6c 6f 77 2c 20 61 73 20 74 68 65 20 76 2d 74 61 low, as the v-ta
65c0: 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ble implementati
65d0: 6f 6e 20 6d 61 79 20 62 65 20 73 74 6f 72 69 6e on may be storin
65e0: 67 0a 20 20 2a 2a 20 73 6f 6d 65 20 70 72 65 70 g. ** some prep
65f0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20 ared statements
6600: 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f internally.. */
6610: 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f . sqlite3VtabRo
6620: 6c 6c 62 61 63 6b 28 64 62 29 3b 0a 0a 20 20 2f llback(db);.. /
6630: 2a 20 4c 65 67 61 63 79 20 62 65 68 61 76 69 6f * Legacy behavio
6640: 72 20 28 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 r (sqlite3_close
6650: 28 29 20 62 65 68 61 76 69 6f 72 29 20 69 73 20 () behavior) is
6660: 74 6f 20 72 65 74 75 72 6e 0a 20 20 2a 2a 20 53 to return. ** S
6670: 51 4c 49 54 45 5f 42 55 53 59 20 69 66 20 74 68 QLITE_BUSY if th
6680: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 63 61 6e e connection can
6690: 20 6e 6f 74 20 62 65 20 63 6c 6f 73 65 64 20 69 not be closed i
66a0: 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 20 20 2a 2f mmediately.. */
66b0: 0a 20 20 69 66 28 20 21 66 6f 72 63 65 5a 6f 6d . if( !forceZom
66c0: 62 69 65 20 26 26 20 63 6f 6e 6e 65 63 74 69 6f bie && connectio
66d0: 6e 49 73 42 75 73 79 28 64 62 29 20 29 7b 0a 20 nIsBusy(db) ){.
66e0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
66f0: 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c db, SQLITE_BUSY,
6700: 20 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 "unable to clos
6710: 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c e due to unfinal
6720: 69 7a 65 64 20 22 0a 20 20 20 20 20 20 20 22 73 ized ". "s
6730: 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e 66 tatements or unf
6740: 69 6e 69 73 68 65 64 20 62 61 63 6b 75 70 73 22 inished backups"
6750: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
6760: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
6770: 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 72 utex);. retur
6780: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
6790: 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }..#ifdef SQLIT
67a0: 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a E_ENABLE_SQLLOG.
67b0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
67c0: 62 61 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f balConfig.xSqllo
67d0: 67 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6c 6f 73 g ){. /* Clos
67e0: 69 6e 67 20 74 68 65 20 68 61 6e 64 6c 65 2e 20 ing the handle.
67f0: 46 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 72 Fourth parameter
6800: 20 69 73 20 70 61 73 73 65 64 20 74 68 65 20 76 is passed the v
6810: 61 6c 75 65 20 32 2e 20 2a 2f 0a 20 20 20 20 73 alue 2. */. s
6820: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
6830: 69 67 2e 78 53 71 6c 6c 6f 67 28 73 71 6c 69 74 ig.xSqllog(sqlit
6840: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
6850: 53 71 6c 6c 6f 67 41 72 67 2c 20 64 62 2c 20 30 SqllogArg, db, 0
6860: 2c 20 32 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 , 2);. }.#endif
6870: 0a 0a 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 74 .. /* Convert t
6880: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 6e he connection in
6890: 74 6f 20 61 20 7a 6f 6d 62 69 65 20 61 6e 64 20 to a zombie and
68a0: 74 68 65 6e 20 63 6c 6f 73 65 20 69 74 2e 0a 20 then close it..
68b0: 20 2a 2f 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 */. db->magic
68c0: 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 5a = SQLITE_MAGIC_Z
68d0: 4f 4d 42 49 45 3b 0a 20 20 73 71 6c 69 74 65 33 OMBIE;. sqlite3
68e0: 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f LeaveMutexAndClo
68f0: 73 65 5a 6f 6d 62 69 65 28 64 62 29 3b 0a 20 20 seZombie(db);.
6900: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
6910: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 76 ;.}../*.** Two v
6920: 61 72 69 61 74 69 6f 6e 73 20 6f 6e 20 74 68 65 ariations on the
6930: 20 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 63 public interfac
6940: 65 20 66 6f 72 20 63 6c 6f 73 69 6e 67 20 61 20 e for closing a
6950: 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e database.** conn
6960: 65 63 74 69 6f 6e 2e 20 54 68 65 20 73 71 6c 69 ection. The sqli
6970: 74 65 33 5f 63 6c 6f 73 65 28 29 20 76 65 72 73 te3_close() vers
6980: 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 ion returns SQLI
6990: 54 45 5f 42 55 53 59 20 61 6e 64 0a 2a 2a 20 6c TE_BUSY and.** l
69a0: 65 61 76 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 eaves the connec
69b0: 74 69 6f 6e 20 6f 70 74 69 6f 6e 20 69 66 20 74 tion option if t
69c0: 68 65 72 65 20 61 72 65 20 75 6e 66 69 6e 61 6c here are unfinal
69d0: 69 7a 65 64 20 70 72 65 70 61 72 65 64 0a 2a 2a ized prepared.**
69e0: 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 statements or u
69f0: 6e 66 69 6e 69 73 68 65 64 20 73 71 6c 69 74 65 nfinished sqlite
6a00: 33 5f 62 61 63 6b 75 70 73 2e 20 20 54 68 65 20 3_backups. The
6a10: 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32 sqlite3_close_v2
6a20: 28 29 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 66 6f ().** version fo
6a30: 72 63 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 rces the connect
6a40: 69 6f 6e 20 74 6f 20 62 65 63 6f 6d 65 20 61 20 ion to become a
6a50: 7a 6f 6d 62 69 65 20 69 66 20 74 68 65 72 65 20 zombie if there
6a60: 61 72 65 0a 2a 2a 20 75 6e 63 6c 6f 73 65 64 20 are.** unclosed
6a70: 72 65 73 6f 75 72 63 65 73 2c 20 61 6e 64 20 61 resources, and a
6a80: 72 72 61 6e 67 65 73 20 66 6f 72 20 64 65 61 6c rranges for deal
6a90: 6c 6f 63 61 74 69 6f 6e 20 77 68 65 6e 20 74 68 location when th
6aa0: 65 20 6c 61 73 74 0a 2a 2a 20 70 72 65 70 61 72 e last.** prepar
6ab0: 65 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 73 e statement or s
6ac0: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 63 6c qlite3_backup cl
6ad0: 6f 73 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c oses..*/.int sql
6ae0: 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69 74 ite3_close(sqlit
6af0: 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 e3 *db){ return
6b00: 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 2c sqlite3Close(db,
6b10: 30 29 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 0); }.int sqlite
6b20: 33 5f 63 6c 6f 73 65 5f 76 32 28 73 71 6c 69 74 3_close_v2(sqlit
6b30: 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 e3 *db){ return
6b40: 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 2c sqlite3Close(db,
6b50: 31 29 3b 20 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6c 1); }.../*.** Cl
6b60: 6f 73 65 20 74 68 65 20 6d 75 74 65 78 20 6f 6e ose the mutex on
6b70: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
6b80: 74 69 6f 6e 20 64 62 2e 0a 2a 2a 0a 2a 2a 20 46 tion db..**.** F
6b90: 75 72 74 68 65 72 6d 6f 72 65 2c 20 69 66 20 64 urthermore, if d
6ba0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
6bb0: 6f 6e 20 64 62 20 69 73 20 61 20 7a 6f 6d 62 69 on db is a zombi
6bc0: 65 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 e (meaning that
6bd0: 74 68 65 72 65 0a 2a 2a 20 68 61 73 20 62 65 65 there.** has bee
6be0: 6e 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 n a prior call t
6bf0: 6f 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 o sqlite3_close(
6c00: 64 62 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 63 db) or sqlite3_c
6c10: 6c 6f 73 65 5f 76 32 28 64 62 29 29 20 61 6e 64 lose_v2(db)) and
6c20: 0a 2a 2a 20 65 76 65 72 79 20 73 71 6c 69 74 65 .** every sqlite
6c30: 33 5f 73 74 6d 74 20 68 61 73 20 6e 6f 77 20 62 3_stmt has now b
6c40: 65 65 6e 20 66 69 6e 61 6c 69 7a 65 64 20 61 6e een finalized an
6c50: 64 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 5f d every sqlite3_
6c60: 62 61 63 6b 75 70 20 68 61 73 0a 2a 2a 20 66 69 backup has.** fi
6c70: 6e 69 73 68 65 64 2c 20 74 68 65 6e 20 66 72 65 nished, then fre
6c80: 65 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 2e e all resources.
6c90: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
6ca0: 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f LeaveMutexAndClo
6cb0: 73 65 5a 6f 6d 62 69 65 28 73 71 6c 69 74 65 33 seZombie(sqlite3
6cc0: 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 65 *db){. HashEle
6cd0: 6d 20 2a 69 3b 20 20 20 20 20 20 20 20 20 20 20 m *i;
6ce0: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 /* Hash
6cf0: 20 74 61 62 6c 65 20 69 74 65 72 61 74 6f 72 20 table iterator
6d00: 2a 2f 0a 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 2f */. int j;.. /
6d10: 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f * If there are o
6d20: 75 74 73 74 61 6e 64 69 6e 67 20 73 71 6c 69 74 utstanding sqlit
6d30: 65 33 5f 73 74 6d 74 20 6f 72 20 73 71 6c 69 74 e3_stmt or sqlit
6d40: 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 e3_backup object
6d50: 73 0a 20 20 2a 2a 20 6f 72 20 69 66 20 74 68 65 s. ** or if the
6d60: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 connection has
6d70: 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 63 6c 6f not yet been clo
6d80: 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 sed by sqlite3_c
6d90: 6c 6f 73 65 5f 76 32 28 29 2c 0a 20 20 2a 2a 20 lose_v2(),. **
6da0: 74 68 65 6e 20 6a 75 73 74 20 6c 65 61 76 65 20 then just leave
6db0: 74 68 65 20 6d 75 74 65 78 20 61 6e 64 20 72 65 the mutex and re
6dc0: 74 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 turn.. */. if(
6dd0: 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 db->magic!=SQLI
6de0: 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 20 TE_MAGIC_ZOMBIE
6df0: 7c 7c 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 || connectionIsB
6e00: 75 73 79 28 64 62 29 20 29 7b 0a 20 20 20 20 73 usy(db) ){. s
6e10: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
6e20: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
6e30: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 0a return;. }..
6e40: 20 20 2f 2a 20 49 66 20 77 65 20 72 65 61 63 68 /* If we reach
6e50: 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 69 74 20 this point, it
6e60: 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 64 means that the d
6e70: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
6e80: 6f 6e 20 68 61 73 0a 20 20 2a 2a 20 63 6c 6f 73 on has. ** clos
6e90: 65 64 20 61 6c 6c 20 73 71 6c 69 74 65 33 5f 73 ed all sqlite3_s
6ea0: 74 6d 74 20 61 6e 64 20 73 71 6c 69 74 65 33 5f tmt and sqlite3_
6eb0: 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 61 backup objects a
6ec0: 6e 64 20 68 61 73 20 62 65 65 6e 0a 20 20 2a 2a nd has been. **
6ed0: 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 passed to sqlit
6ee0: 65 33 5f 63 6c 6f 73 65 20 28 6d 65 61 6e 69 6e e3_close (meanin
6ef0: 67 20 74 68 61 74 20 69 74 20 69 73 20 61 20 7a g that it is a z
6f00: 6f 6d 62 69 65 29 2e 20 20 54 68 65 72 65 66 6f ombie). Therefo
6f10: 72 65 2c 0a 20 20 2a 2a 20 67 6f 20 61 68 65 61 re,. ** go ahea
6f20: 64 20 61 6e 64 20 66 72 65 65 20 61 6c 6c 20 72 d and free all r
6f30: 65 73 6f 75 72 63 65 73 2e 0a 20 20 2a 2f 0a 0a esources.. */..
6f40: 20 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 /* If a transa
6f50: 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 72 ction is open, r
6f60: 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 54 68 69 oll it back. Thi
6f70: 73 20 61 6c 73 6f 20 65 6e 73 75 72 65 73 20 74 s also ensures t
6f80: 68 61 74 20 69 66 0a 20 20 2a 2a 20 61 6e 79 20 hat if. ** any
6f90: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 73 database schemas
6fa0: 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 have been modif
6fb0: 69 65 64 20 62 79 20 61 6e 20 75 6e 63 6f 6d 6d ied by an uncomm
6fc0: 69 74 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f itted transactio
6fd0: 6e 0a 20 20 2a 2a 20 74 68 65 79 20 61 72 65 20 n. ** they are
6fe0: 72 65 73 65 74 2e 20 41 6e 64 20 74 68 61 74 20 reset. And that
6ff0: 74 68 65 20 72 65 71 75 69 72 65 64 20 62 2d 74 the required b-t
7000: 72 65 65 20 6d 75 74 65 78 20 69 73 20 68 65 6c ree mutex is hel
7010: 64 20 74 6f 20 6d 61 6b 65 0a 20 20 2a 2a 20 74 d to make. ** t
7020: 68 65 20 70 61 67 65 72 20 72 6f 6c 6c 62 61 63 he pager rollbac
7030: 6b 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 73 k and schema res
7040: 65 74 20 61 6e 20 61 74 6f 6d 69 63 20 6f 70 65 et an atomic ope
7050: 72 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 73 71 6c ration. */. sql
7060: 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 ite3RollbackAll(
7070: 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a db, SQLITE_OK);.
7080: 0a 20 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 6f . /* Free any o
7090: 75 74 73 74 61 6e 64 69 6e 67 20 53 61 76 65 70 utstanding Savep
70a0: 6f 69 6e 74 20 73 74 72 75 63 74 75 72 65 73 2e oint structures.
70b0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f */. sqlite3Clo
70c0: 73 65 53 61 76 65 70 6f 69 6e 74 73 28 64 62 29 seSavepoints(db)
70d0: 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c ;.. /* Close al
70e0: 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 l database conne
70f0: 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 66 6f 72 28 ctions */. for(
7100: 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 j=0; j<db->nDb;
7110: 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 j++){. struct
7120: 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e Db *pDb = &db->
7130: 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 aDb[j];. if(
7140: 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 pDb->pBt ){.
7150: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
7160: 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 ose(pDb->pBt);.
7170: 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 pDb->pBt =
7180: 30 3b 0a 20 20 20 20 20 20 69 66 28 20 6a 21 3d 0;. if( j!=
7190: 31 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 62 1 ){. pDb
71a0: 2d 3e 70 53 63 68 65 6d 61 20 3d 20 30 3b 0a 20 ->pSchema = 0;.
71b0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
71c0: 0a 20 20 2f 2a 20 43 6c 65 61 72 20 74 68 65 20 . /* Clear the
71d0: 54 45 4d 50 20 73 63 68 65 6d 61 20 73 65 70 61 TEMP schema sepa
71e0: 72 61 74 65 6c 79 20 61 6e 64 20 6c 61 73 74 20 rately and last
71f0: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 62 */. if( db->aDb
7200: 5b 31 5d 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 [1].pSchema ){.
7210: 20 20 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 sqlite3Schema
7220: 43 6c 65 61 72 28 64 62 2d 3e 61 44 62 5b 31 5d Clear(db->aDb[1]
7230: 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 7d 0a 20 .pSchema);. }.
7240: 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f sqlite3VtabUnlo
7250: 63 6b 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 2f ckList(db);.. /
7260: 2a 20 46 72 65 65 20 75 70 20 74 68 65 20 61 72 * Free up the ar
7270: 72 61 79 20 6f 66 20 61 75 78 69 6c 69 61 72 79 ray of auxiliary
7280: 20 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 databases */.
7290: 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 sqlite3CollapseD
72a0: 61 74 61 62 61 73 65 41 72 72 61 79 28 64 62 29 atabaseArray(db)
72b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e ;. assert( db->
72c0: 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 nDb<=2 );. asse
72d0: 72 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d rt( db->aDb==db-
72e0: 3e 61 44 62 53 74 61 74 69 63 20 29 3b 0a 0a 20 >aDbStatic );..
72f0: 20 2f 2a 20 54 65 6c 6c 20 74 68 65 20 63 6f 64 /* Tell the cod
7300: 65 20 69 6e 20 6e 6f 74 69 66 79 2e 63 20 74 68 e in notify.c th
7310: 61 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f at the connectio
7320: 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 68 6f 6c 64 n no longer hold
7330: 73 20 61 6e 79 0a 20 20 2a 2a 20 6c 6f 63 6b 73 s any. ** locks
7340: 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 72 65 and does not re
7350: 71 75 69 72 65 20 61 6e 79 20 66 75 72 74 68 65 quire any furthe
7360: 72 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20 r unlock-notify
7370: 63 61 6c 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a callbacks.. */.
7380: 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 sqlite3Connect
7390: 69 6f 6e 43 6c 6f 73 65 64 28 64 62 29 3b 0a 0a ionClosed(db);..
73a0: 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 41 72 72 for(j=0; j<Arr
73b0: 61 79 53 69 7a 65 28 64 62 2d 3e 61 46 75 6e 63 aySize(db->aFunc
73c0: 2e 61 29 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 46 .a); j++){. F
73d0: 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 2c 20 2a uncDef *pNext, *
73e0: 70 48 61 73 68 2c 20 2a 70 3b 0a 20 20 20 20 66 pHash, *p;. f
73f0: 6f 72 28 70 3d 64 62 2d 3e 61 46 75 6e 63 2e 61 or(p=db->aFunc.a
7400: 5b 6a 5d 3b 20 70 3b 20 70 3d 70 48 61 73 68 29 [j]; p; p=pHash)
7410: 7b 0a 20 20 20 20 20 20 70 48 61 73 68 20 3d 20 {. pHash =
7420: 70 2d 3e 70 48 61 73 68 3b 0a 20 20 20 20 20 20 p->pHash;.
7430: 77 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 while( p ){.
7440: 20 20 20 20 66 75 6e 63 74 69 6f 6e 44 65 73 74 functionDest
7450: 72 6f 79 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 roy(db, p);.
7460: 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 pNext = p->p
7470: 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 73 71 Next;. sq
7480: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
7490: 70 29 3b 0a 20 20 20 20 20 20 20 20 70 20 3d 20 p);. p =
74a0: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 pNext;. }.
74b0: 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 69 }. }. for(i
74c0: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 =sqliteHashFirst
74d0: 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b (&db->aCollSeq);
74e0: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 i; i=sqliteHash
74f0: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 6f Next(i)){. Co
7500: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 llSeq *pColl = (
7510: 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 65 CollSeq *)sqlite
7520: 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20 HashData(i);.
7530: 20 2f 2a 20 49 6e 76 6f 6b 65 20 61 6e 79 20 64 /* Invoke any d
7540: 65 73 74 72 75 63 74 6f 72 73 20 72 65 67 69 73 estructors regis
7550: 74 65 72 65 64 20 66 6f 72 20 63 6f 6c 6c 61 74 tered for collat
7560: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 75 73 65 ion sequence use
7570: 72 20 64 61 74 61 2e 20 2a 2f 0a 20 20 20 20 66 r data. */. f
7580: 6f 72 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b or(j=0; j<3; j++
7590: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 43 6f ){. if( pCo
75a0: 6c 6c 5b 6a 5d 2e 78 44 65 6c 20 29 7b 0a 20 20 ll[j].xDel ){.
75b0: 20 20 20 20 20 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 pColl[j].x
75c0: 44 65 6c 28 70 43 6f 6c 6c 5b 6a 5d 2e 70 55 73 Del(pColl[j].pUs
75d0: 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 er);. }.
75e0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 }. sqlite3Db
75f0: 46 72 65 65 28 64 62 2c 20 70 43 6f 6c 6c 29 3b Free(db, pColl);
7600: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 . }. sqlite3Ha
7610: 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 6f shClear(&db->aCo
7620: 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 20 llSeq);.#ifndef
7630: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
7640: 55 41 4c 54 41 42 4c 45 0a 20 20 66 6f 72 28 69 UALTABLE. for(i
7650: 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 =sqliteHashFirst
7660: 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 20 (&db->aModule);
7670: 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e i; i=sqliteHashN
7680: 65 78 74 28 69 29 29 7b 0a 20 20 20 20 4d 6f 64 ext(i)){. Mod
7690: 75 6c 65 20 2a 70 4d 6f 64 20 3d 20 28 4d 6f 64 ule *pMod = (Mod
76a0: 75 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 68 ule *)sqliteHash
76b0: 44 61 74 61 28 69 29 3b 0a 20 20 20 20 69 66 28 Data(i);. if(
76c0: 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 20 pMod->xDestroy
76d0: 29 7b 0a 20 20 20 20 20 20 70 4d 6f 64 2d 3e 78 ){. pMod->x
76e0: 44 65 73 74 72 6f 79 28 70 4d 6f 64 2d 3e 70 41 Destroy(pMod->pA
76f0: 75 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 ux);. }. s
7700: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
7710: 20 70 4d 6f 64 29 3b 0a 20 20 7d 0a 20 20 73 71 pMod);. }. sq
7720: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 lite3HashClear(&
7730: 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 65 db->aModule);.#e
7740: 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 ndif.. sqlite3E
7750: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f rror(db, SQLITE_
7760: 4f 4b 2c 20 30 29 3b 20 2f 2a 20 44 65 61 6c 6c OK, 0); /* Deall
7770: 6f 63 61 74 65 73 20 61 6e 79 20 63 61 63 68 65 ocates any cache
7780: 64 20 65 72 72 6f 72 20 73 74 72 69 6e 67 73 2e d error strings.
7790: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70 45 */. if( db->pE
77a0: 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 rr ){. sqlite
77b0: 33 56 61 6c 75 65 46 72 65 65 28 64 62 2d 3e 70 3ValueFree(db->p
77c0: 45 72 72 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 Err);. }. sqli
77d0: 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f te3CloseExtensio
77e0: 6e 73 28 64 62 29 3b 0a 0a 20 20 64 62 2d 3e 6d ns(db);.. db->m
77f0: 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 agic = SQLITE_MA
7800: 47 49 43 5f 45 52 52 4f 52 3b 0a 0a 20 20 2f 2a GIC_ERROR;.. /*
7810: 20 54 68 65 20 74 65 6d 70 2d 64 61 74 61 62 61 The temp-databa
7820: 73 65 20 73 63 68 65 6d 61 20 69 73 20 61 6c 6c se schema is all
7830: 6f 63 61 74 65 64 20 64 69 66 66 65 72 65 6e 74 ocated different
7840: 6c 79 20 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 ly from the othe
7850: 72 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 6f 62 r schema. ** ob
7860: 6a 65 63 74 73 20 28 75 73 69 6e 67 20 73 71 6c jects (using sql
7870: 69 74 65 4d 61 6c 6c 6f 63 28 29 20 64 69 72 65 iteMalloc() dire
7880: 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 20 6f 66 ctly, instead of
7890: 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 sqlite3BtreeSch
78a0: 65 6d 61 28 29 29 2e 0a 20 20 2a 2a 20 53 6f 20 ema()).. ** So
78b0: 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 66 it needs to be f
78c0: 72 65 65 64 20 68 65 72 65 2e 20 54 6f 64 6f 3a reed here. Todo:
78d0: 20 57 68 79 20 6e 6f 74 20 72 6f 6c 6c 20 74 68 Why not roll th
78e0: 65 20 74 65 6d 70 20 73 63 68 65 6d 61 20 69 6e e temp schema in
78f0: 74 6f 0a 20 20 2a 2a 20 74 68 65 20 73 61 6d 65 to. ** the same
7900: 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 sqliteMalloc()
7910: 61 73 20 74 68 65 20 6f 6e 65 20 74 68 61 74 20 as the one that
7920: 61 6c 6c 6f 63 61 74 65 73 20 74 68 65 20 64 61 allocates the da
7930: 74 61 62 61 73 65 20 0a 20 20 2a 2a 20 73 74 72 tabase . ** str
7940: 75 63 74 75 72 65 3f 0a 20 20 2a 2f 0a 20 20 73 ucture?. */. s
7950: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
7960: 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 db->aDb[1].pSch
7970: 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f ema);. sqlite3_
7980: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
7990: 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 6d 61 mutex);. db->ma
79a0: 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 gic = SQLITE_MAG
79b0: 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 71 6c IC_CLOSED;. sql
79c0: 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 ite3_mutex_free(
79d0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
79e0: 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 sert( db->lookas
79f0: 69 64 65 2e 6e 4f 75 74 3d 3d 30 20 29 3b 20 20 ide.nOut==0 );
7a00: 2f 2a 20 46 61 69 6c 73 20 6f 6e 20 61 20 6c 6f /* Fails on a lo
7a10: 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 6c okaside memory l
7a20: 65 61 6b 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d eak */. if( db-
7a30: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c >lookaside.bMall
7a40: 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 oced ){. sqli
7a50: 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c 6f 6f te3_free(db->loo
7a60: 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 3b 0a kaside.pStart);.
7a70: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 }. sqlite3_fr
7a80: 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ee(db);.}../*.**
7a90: 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 64 61 Rollback all da
7aa0: 74 61 62 61 73 65 20 66 69 6c 65 73 2e 20 20 49 tabase files. I
7ab0: 66 20 74 72 69 70 43 6f 64 65 20 69 73 20 6e 6f f tripCode is no
7ac0: 74 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 74 68 65 t SQLITE_OK, the
7ad0: 6e 0a 2a 2a 20 61 6e 79 20 6f 70 65 6e 20 63 75 n.** any open cu
7ae0: 72 73 6f 72 73 20 61 72 65 20 69 6e 76 61 6c 69 rsors are invali
7af0: 64 61 74 65 64 20 28 22 74 72 69 70 70 65 64 22 dated ("tripped"
7b00: 20 2d 20 61 73 20 69 6e 20 22 74 72 69 70 70 69 - as in "trippi
7b10: 6e 67 20 61 20 63 69 72 63 75 69 74 0a 2a 2a 20 ng a circuit.**
7b20: 62 72 65 61 6b 65 72 22 29 20 61 6e 64 20 6d 61 breaker") and ma
7b30: 64 65 20 74 6f 20 72 65 74 75 72 6e 20 74 72 69 de to return tri
7b40: 70 43 6f 64 65 20 69 66 20 74 68 65 72 65 20 61 pCode if there a
7b50: 72 65 20 61 6e 79 20 66 75 72 74 68 65 72 0a 2a re any further.*
7b60: 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 75 73 * attempts to us
7b70: 65 20 74 68 61 74 20 63 75 72 73 6f 72 2e 0a 2a e that cursor..*
7b80: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f /.void sqlite3Ro
7b90: 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 llbackAll(sqlite
7ba0: 33 20 2a 64 62 2c 20 69 6e 74 20 74 72 69 70 43 3 *db, int tripC
7bb0: 6f 64 65 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 ode){. int i;.
7bc0: 20 69 6e 74 20 69 6e 54 72 61 6e 73 20 3d 20 30 int inTrans = 0
7bd0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
7be0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 te3_mutex_held(d
7bf0: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
7c00: 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 qlite3BeginBenig
7c10: 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 2f 2a nMalloc();.. /*
7c20: 20 4f 62 74 61 69 6e 20 61 6c 6c 20 62 2d 74 72 Obtain all b-tr
7c30: 65 65 20 6d 75 74 65 78 65 73 20 62 65 66 6f 72 ee mutexes befor
7c40: 65 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 61 6c e making any cal
7c50: 6c 73 20 74 6f 20 42 74 72 65 65 52 6f 6c 6c 62 ls to BtreeRollb
7c60: 61 63 6b 28 29 2e 20 0a 20 20 2a 2a 20 54 68 69 ack(). . ** Thi
7c70: 73 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 69 s is important i
7c80: 6e 20 63 61 73 65 20 74 68 65 20 74 72 61 6e 73 n case the trans
7c90: 61 63 74 69 6f 6e 20 62 65 69 6e 67 20 72 6f 6c action being rol
7ca0: 6c 65 64 20 62 61 63 6b 20 68 61 73 0a 20 20 2a led back has. *
7cb0: 2a 20 6d 6f 64 69 66 69 65 64 20 74 68 65 20 64 * modified the d
7cc0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 atabase schema.
7cd0: 49 66 20 74 68 65 20 62 2d 74 72 65 65 20 6d 75 If the b-tree mu
7ce0: 74 65 78 65 73 20 61 72 65 20 6e 6f 74 20 74 61 texes are not ta
7cf0: 6b 65 6e 0a 20 20 2a 2a 20 68 65 72 65 2c 20 74 ken. ** here, t
7d00: 68 65 6e 20 61 6e 6f 74 68 65 72 20 73 68 61 72 hen another shar
7d10: 65 64 2d 63 61 63 68 65 20 63 6f 6e 6e 65 63 74 ed-cache connect
7d20: 69 6f 6e 20 6d 69 67 68 74 20 73 6e 65 61 6b 20 ion might sneak
7d30: 69 6e 20 62 65 74 77 65 65 6e 0a 20 20 2a 2a 20 in between. **
7d40: 74 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 6c the database rol
7d50: 6c 62 61 63 6b 20 61 6e 64 20 73 63 68 65 6d 61 lback and schema
7d60: 20 72 65 73 65 74 2c 20 77 68 69 63 68 20 63 61 reset, which ca
7d70: 6e 20 63 61 75 73 65 20 66 61 6c 73 65 0a 20 20 n cause false.
7d80: 2a 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 72 65 ** corruption re
7d90: 70 6f 72 74 73 20 69 6e 20 73 6f 6d 65 20 63 61 ports in some ca
7da0: 73 65 73 2e 20 20 2a 2f 0a 20 20 73 71 6c 69 74 ses. */. sqlit
7db0: 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 e3BtreeEnterAll(
7dc0: 64 62 29 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b db);.. for(i=0;
7dd0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 i<db->nDb; i++)
7de0: 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 20 3d {. Btree *p =
7df0: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b db->aDb[i].pBt;
7e00: 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 20 . if( p ){.
7e10: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 if( sqlite3B
7e20: 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 29 treeIsInTrans(p)
7e30: 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 54 72 ){. inTr
7e40: 61 6e 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d ans = 1;. }
7e50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 . sqlite3Bt
7e60: 72 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c 20 74 reeRollback(p, t
7e70: 72 69 70 43 6f 64 65 29 3b 0a 20 20 20 20 7d 0a ripCode);. }.
7e80: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 74 61 }. sqlite3Vta
7e90: 62 52 6f 6c 6c 62 61 63 6b 28 64 62 29 3b 0a 20 bRollback(db);.
7ea0: 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 sqlite3EndBenig
7eb0: 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 69 66 nMalloc();.. if
7ec0: 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c ( (db->flags&SQL
7ed0: 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 ITE_InternChange
7ee0: 73 29 21 3d 30 20 26 26 20 64 62 2d 3e 69 6e 69 s)!=0 && db->ini
7ef0: 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a 20 20 20 t.busy==0 ){.
7f00: 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 sqlite3ExpirePr
7f10: 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 eparedStatements
7f20: 28 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 (db);. sqlite
7f30: 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d 61 73 3ResetAllSchemas
7f40: 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 64 62 29 OfConnection(db)
7f50: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 ;. }. sqlite3B
7f60: 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 treeLeaveAll(db)
7f70: 3b 0a 0a 20 20 2f 2a 20 41 6e 79 20 64 65 66 65 ;.. /* Any defe
7f80: 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 20 rred constraint
7f90: 76 69 6f 6c 61 74 69 6f 6e 73 20 68 61 76 65 20 violations have
7fa0: 6e 6f 77 20 62 65 65 6e 20 72 65 73 6f 6c 76 65 now been resolve
7fb0: 64 2e 20 2a 2f 0a 20 20 64 62 2d 3e 6e 44 65 66 d. */. db->nDef
7fc0: 65 72 72 65 64 43 6f 6e 73 20 3d 20 30 3b 0a 0a erredCons = 0;..
7fd0: 20 20 2f 2a 20 49 66 20 6f 6e 65 20 68 61 73 20 /* If one has
7fe0: 62 65 65 6e 20 63 6f 6e 66 69 67 75 72 65 64 2c been configured,
7ff0: 20 69 6e 76 6f 6b 65 20 74 68 65 20 72 6f 6c 6c invoke the roll
8000: 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 6c 6c 62 61 back-hook callba
8010: 63 6b 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e ck */. if( db->
8020: 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 xRollbackCallbac
8030: 6b 20 26 26 20 28 69 6e 54 72 61 6e 73 20 7c 7c k && (inTrans ||
8040: 20 21 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 !db->autoCommit
8050: 29 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 52 6f ) ){. db->xRo
8060: 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 64 llbackCallback(d
8070: 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 29 b->pRollbackArg)
8080: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 ;. }.}../*.** R
8090: 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 eturn a static s
80a0: 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 tring containing
80b0: 20 74 68 65 20 6e 61 6d 65 20 63 6f 72 72 65 73 the name corres
80c0: 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 65 ponding to the e
80d0: 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 73 70 65 rror code.** spe
80e0: 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 61 72 cified in the ar
80f0: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 20 64 gument..*/.#if d
8100: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
8110: 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 BUG) || defined(
8120: 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c 7c 20 SQLITE_TEST) ||
8130: 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 28 53 51 \. defined(SQ
8140: 4c 49 54 45 5f 44 45 42 55 47 5f 4f 53 5f 54 52 LITE_DEBUG_OS_TR
8150: 41 43 45 29 0a 63 6f 6e 73 74 20 63 68 61 72 20 ACE).const char
8160: 2a 73 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 *sqlite3ErrName(
8170: 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f 6e 73 74 int rc){. const
8180: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 30 char *zName = 0
8190: 3b 0a 20 20 69 6e 74 20 69 2c 20 6f 72 69 67 52 ;. int i, origR
81a0: 63 20 3d 20 72 63 3b 0a 20 20 66 6f 72 28 69 3d c = rc;. for(i=
81b0: 30 3b 20 69 3c 32 20 26 26 20 7a 4e 61 6d 65 3d 0; i<2 && zName=
81c0: 3d 30 3b 20 69 2b 2b 2c 20 72 63 20 26 3d 20 30 =0; i++, rc &= 0
81d0: 78 66 66 29 7b 0a 20 20 20 20 73 77 69 74 63 68 xff){. switch
81e0: 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 63 61 ( rc ){. ca
81f0: 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20 20 se SQLITE_OK:
8200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
8210: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4f 4b ame = "SQLITE_OK
8220: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
8230: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
8240: 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 ase SQLITE_ERROR
8250: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a : z
8260: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 45 Name = "SQLITE_E
8270: 52 52 4f 52 22 3b 20 20 20 20 20 20 20 20 20 20 RROR";
8280: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
8290: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 case SQLITE_INTE
82a0: 52 4e 41 4c 3a 20 20 20 20 20 20 20 20 20 20 20 RNAL:
82b0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
82c0: 49 4e 54 45 52 4e 41 4c 22 3b 20 20 20 20 20 20 INTERNAL";
82d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
82e0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 case SQLITE_PER
82f0: 4d 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 M:
8300: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
8310: 5f 50 45 52 4d 22 3b 20 20 20 20 20 20 20 20 20 _PERM";
8320: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
8330: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 case SQLITE_AB
8340: 4f 52 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 ORT:
8350: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
8360: 45 5f 41 42 4f 52 54 22 3b 20 20 20 20 20 20 20 E_ABORT";
8370: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
8380: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 case SQLITE_A
8390: 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 20 BORT_ROLLBACK:
83a0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
83b0: 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 TE_ABORT_ROLLBAC
83c0: 4b 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 K"; break;.
83d0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
83e0: 42 55 53 59 3a 20 20 20 20 20 20 20 20 20 20 20 BUSY:
83f0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
8400: 49 54 45 5f 42 55 53 59 22 3b 20 20 20 20 20 20 ITE_BUSY";
8410: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
8420: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
8430: 5f 42 55 53 59 5f 52 45 43 4f 56 45 52 59 3a 20 _BUSY_RECOVERY:
8440: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
8450: 4c 49 54 45 5f 42 55 53 59 5f 52 45 43 4f 56 45 LITE_BUSY_RECOVE
8460: 52 59 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a RY"; break;.
8470: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
8480: 45 5f 42 55 53 59 5f 53 4e 41 50 53 48 4f 54 3a E_BUSY_SNAPSHOT:
8490: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
84a0: 51 4c 49 54 45 5f 42 55 53 59 5f 53 4e 41 50 53 QLITE_BUSY_SNAPS
84b0: 48 4f 54 22 3b 20 20 20 20 20 62 72 65 61 6b 3b HOT"; break;
84c0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
84d0: 54 45 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 20 TE_LOCKED:
84e0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
84f0: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 22 3b 20 SQLITE_LOCKED";
8500: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
8510: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
8520: 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 ITE_LOCKED_SHARE
8530: 44 43 41 43 48 45 3a 20 7a 4e 61 6d 65 20 3d 20 DCACHE: zName =
8540: 22 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 "SQLITE_LOCKED_S
8550: 48 41 52 45 44 43 41 43 48 45 22 3b 62 72 65 61 HAREDCACHE";brea
8560: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
8570: 4c 49 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 LITE_NOMEM:
8580: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
8590: 20 22 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 22 3b "SQLITE_NOMEM";
85a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
85b0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
85c0: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3a 20 QLITE_READONLY:
85d0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
85e0: 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e = "SQLITE_READON
85f0: 4c 59 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 LY"; br
8600: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
8610: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f SQLITE_READONLY_
8620: 52 45 43 4f 56 45 52 59 3a 20 20 7a 4e 61 6d 65 RECOVERY: zName
8630: 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f = "SQLITE_READO
8640: 4e 4c 59 5f 52 45 43 4f 56 45 52 59 22 3b 20 62 NLY_RECOVERY"; b
8650: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
8660: 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
8670: 5f 43 41 4e 54 4c 4f 43 4b 3a 20 20 7a 4e 61 6d _CANTLOCK: zNam
8680: 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 e = "SQLITE_READ
8690: 4f 4e 4c 59 5f 43 41 4e 54 4c 4f 43 4b 22 3b 20 ONLY_CANTLOCK";
86a0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
86b0: 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c e SQLITE_READONL
86c0: 59 5f 52 4f 4c 4c 42 41 43 4b 3a 20 20 7a 4e 61 Y_ROLLBACK: zNa
86d0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 me = "SQLITE_REA
86e0: 44 4f 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b 22 3b DONLY_ROLLBACK";
86f0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
8700: 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 se SQLITE_INTERR
8710: 55 50 54 3a 20 20 20 20 20 20 20 20 20 20 7a 4e UPT: zN
8720: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4e ame = "SQLITE_IN
8730: 54 45 52 52 55 50 54 22 3b 20 20 20 20 20 20 20 TERRUPT";
8740: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
8750: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
8760: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a : z
8770: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
8780: 4f 45 52 52 22 3b 20 20 20 20 20 20 20 20 20 20 OERR";
8790: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
87a0: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
87b0: 52 5f 52 45 41 44 3a 20 20 20 20 20 20 20 20 20 R_READ:
87c0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
87d0: 49 4f 45 52 52 5f 52 45 41 44 22 3b 20 20 20 20 IOERR_READ";
87e0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
87f0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
8800: 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 3a 20 20 RR_SHORT_READ:
8810: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
8820: 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 _IOERR_SHORT_REA
8830: 44 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 D"; break;.
8840: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
8850: 45 52 52 5f 57 52 49 54 45 3a 20 20 20 20 20 20 ERR_WRITE:
8860: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
8870: 45 5f 49 4f 45 52 52 5f 57 52 49 54 45 22 3b 20 E_IOERR_WRITE";
8880: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
8890: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
88a0: 4f 45 52 52 5f 46 53 59 4e 43 3a 20 20 20 20 20 OERR_FSYNC:
88b0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
88c0: 54 45 5f 49 4f 45 52 52 5f 46 53 59 4e 43 22 3b TE_IOERR_FSYNC";
88d0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
88e0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
88f0: 49 4f 45 52 52 5f 44 49 52 5f 46 53 59 4e 43 3a IOERR_DIR_FSYNC:
8900: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
8910: 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 46 53 ITE_IOERR_DIR_FS
8920: 59 4e 43 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 YNC"; break;.
8930: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
8940: 5f 49 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 3a _IOERR_TRUNCATE:
8950: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
8960: 4c 49 54 45 5f 49 4f 45 52 52 5f 54 52 55 4e 43 LITE_IOERR_TRUNC
8970: 41 54 45 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a ATE"; break;.
8980: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
8990: 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 3a 20 20 E_IOERR_FSTAT:
89a0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
89b0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54 41 QLITE_IOERR_FSTA
89c0: 54 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b T"; break;
89d0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
89e0: 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3a TE_IOERR_UNLOCK:
89f0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
8a00: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c SQLITE_IOERR_UNL
8a10: 4f 43 4b 22 3b 20 20 20 20 20 20 62 72 65 61 6b OCK"; break
8a20: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
8a30: 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b ITE_IOERR_RDLOCK
8a40: 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 : zName =
8a50: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 "SQLITE_IOERR_RD
8a60: 4c 4f 43 4b 22 3b 20 20 20 20 20 20 62 72 65 61 LOCK"; brea
8a70: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
8a80: 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 LITE_IOERR_DELET
8a90: 45 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d E: zName =
8aa0: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 "SQLITE_IOERR_D
8ab0: 45 4c 45 54 45 22 3b 20 20 20 20 20 20 62 72 65 ELETE"; bre
8ac0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
8ad0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 42 4c 4f 43 QLITE_IOERR_BLOC
8ae0: 4b 45 44 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 KED: zName
8af0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
8b00: 42 4c 4f 43 4b 45 44 22 3b 20 20 20 20 20 62 72 BLOCKED"; br
8b10: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
8b20: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d SQLITE_IOERR_NOM
8b30: 45 4d 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 EM: zName
8b40: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
8b50: 5f 4e 4f 4d 45 4d 22 3b 20 20 20 20 20 20 20 62 _NOMEM"; b
8b60: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
8b70: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 41 43 SQLITE_IOERR_AC
8b80: 43 45 53 53 3a 20 20 20 20 20 20 20 7a 4e 61 6d CESS: zNam
8b90: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
8ba0: 52 5f 41 43 43 45 53 53 22 3b 20 20 20 20 20 20 R_ACCESS";
8bb0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
8bc0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 e SQLITE_IOERR_C
8bd0: 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b HECKRESERVEDLOCK
8be0: 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :.
8bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8c00: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
8c10: 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 E_IOERR_CHECKRES
8c20: 45 52 56 45 44 4c 4f 43 4b 22 3b 20 62 72 65 61 ERVEDLOCK"; brea
8c30: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
8c40: 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3a LITE_IOERR_LOCK:
8c50: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
8c60: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c "SQLITE_IOERR_L
8c70: 4f 43 4b 22 3b 20 20 20 20 20 20 20 20 62 72 65 OCK"; bre
8c80: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
8c90: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 QLITE_IOERR_CLOS
8ca0: 45 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 E: zName
8cb0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
8cc0: 43 4c 4f 53 45 22 3b 20 20 20 20 20 20 20 62 72 CLOSE"; br
8cd0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
8ce0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 SQLITE_IOERR_DIR
8cf0: 5f 43 4c 4f 53 45 3a 20 20 20 20 7a 4e 61 6d 65 _CLOSE: zName
8d00: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
8d10: 5f 44 49 52 5f 43 4c 4f 53 45 22 3b 20 20 20 62 _DIR_CLOSE"; b
8d20: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
8d30: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 SQLITE_IOERR_SH
8d40: 4d 4f 50 45 4e 3a 20 20 20 20 20 20 7a 4e 61 6d MOPEN: zNam
8d50: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
8d60: 52 5f 53 48 4d 4f 50 45 4e 22 3b 20 20 20 20 20 R_SHMOPEN";
8d70: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
8d80: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 e SQLITE_IOERR_S
8d90: 48 4d 53 49 5a 45 3a 20 20 20 20 20 20 7a 4e 61 HMSIZE: zNa
8da0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
8db0: 52 52 5f 53 48 4d 53 49 5a 45 22 3b 20 20 20 20 RR_SHMSIZE";
8dc0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
8dd0: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
8de0: 53 48 4d 4c 4f 43 4b 3a 20 20 20 20 20 20 7a 4e SHMLOCK: zN
8df0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
8e00: 45 52 52 5f 53 48 4d 4c 4f 43 4b 22 3b 20 20 20 ERR_SHMLOCK";
8e10: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
8e20: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
8e30: 5f 53 48 4d 4d 41 50 3a 20 20 20 20 20 20 20 7a _SHMMAP: z
8e40: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
8e50: 4f 45 52 52 5f 53 48 4d 4d 41 50 22 3b 20 20 20 OERR_SHMMAP";
8e60: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
8e70: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
8e80: 52 5f 53 45 45 4b 3a 20 20 20 20 20 20 20 20 20 R_SEEK:
8e90: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
8ea0: 49 4f 45 52 52 5f 53 45 45 4b 22 3b 20 20 20 20 IOERR_SEEK";
8eb0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
8ec0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
8ed0: 52 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54 3a RR_DELETE_NOENT:
8ee0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
8ef0: 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 5f 4e 4f _IOERR_DELETE_NO
8f00: 45 4e 54 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 ENT";break;.
8f10: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
8f20: 45 52 52 5f 4d 4d 41 50 3a 20 20 20 20 20 20 20 ERR_MMAP:
8f30: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
8f40: 45 5f 49 4f 45 52 52 5f 4d 4d 41 50 22 3b 20 20 E_IOERR_MMAP";
8f50: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
8f60: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
8f70: 4f 52 52 55 50 54 3a 20 20 20 20 20 20 20 20 20 ORRUPT:
8f80: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
8f90: 54 45 5f 43 4f 52 52 55 50 54 22 3b 20 20 20 20 TE_CORRUPT";
8fa0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
8fb0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
8fc0: 43 4f 52 52 55 50 54 5f 56 54 41 42 3a 20 20 20 CORRUPT_VTAB:
8fd0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
8fe0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 56 54 41 42 ITE_CORRUPT_VTAB
8ff0: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 "; break;.
9000: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
9010: 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20 20 20 20 _NOTFOUND:
9020: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
9030: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 22 3b 20 LITE_NOTFOUND";
9040: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
9050: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
9060: 45 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 20 20 E_FULL:
9070: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
9080: 51 4c 49 54 45 5f 46 55 4c 4c 22 3b 20 20 20 20 QLITE_FULL";
9090: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
90a0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
90b0: 54 45 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 20 TE_CANTOPEN:
90c0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
90d0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 22 SQLITE_CANTOPEN"
90e0: 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b ; break
90f0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
9100: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 ITE_CANTOPEN_NOT
9110: 45 4d 50 44 49 52 3a 20 7a 4e 61 6d 65 20 3d 20 EMPDIR: zName =
9120: 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e "SQLITE_CANTOPEN
9130: 5f 4e 4f 54 45 4d 50 44 49 52 22 3b 62 72 65 61 _NOTEMPDIR";brea
9140: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
9150: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 LITE_CANTOPEN_IS
9160: 44 49 52 3a 20 20 20 20 20 7a 4e 61 6d 65 20 3d DIR: zName =
9170: 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 "SQLITE_CANTOPE
9180: 4e 5f 49 53 44 49 52 22 3b 20 20 20 20 62 72 65 N_ISDIR"; bre
9190: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
91a0: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 QLITE_CANTOPEN_F
91b0: 55 4c 4c 50 41 54 48 3a 20 20 7a 4e 61 6d 65 20 ULLPATH: zName
91c0: 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 = "SQLITE_CANTOP
91d0: 45 4e 5f 46 55 4c 4c 50 41 54 48 22 3b 20 62 72 EN_FULLPATH"; br
91e0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
91f0: 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3a SQLITE_PROTOCOL:
9200: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
9210: 20 3d 20 22 53 51 4c 49 54 45 5f 50 52 4f 54 4f = "SQLITE_PROTO
9220: 43 4f 4c 22 3b 20 20 20 20 20 20 20 20 20 20 62 COL"; b
9230: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
9240: 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 3a 20 20 SQLITE_EMPTY:
9250: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
9260: 65 20 3d 20 22 53 51 4c 49 54 45 5f 45 4d 50 54 e = "SQLITE_EMPT
9270: 59 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Y";
9280: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
9290: 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3a e SQLITE_SCHEMA:
92a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
92b0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 53 43 48 me = "SQLITE_SCH
92c0: 45 4d 41 22 3b 20 20 20 20 20 20 20 20 20 20 20 EMA";
92d0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
92e0: 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 se SQLITE_TOOBIG
92f0: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e : zN
9300: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 54 4f ame = "SQLITE_TO
9310: 4f 42 49 47 22 3b 20 20 20 20 20 20 20 20 20 20 OBIG";
9320: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9330: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 ase SQLITE_CONST
9340: 52 41 49 4e 54 3a 20 20 20 20 20 20 20 20 20 7a RAINT: z
9350: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
9360: 4f 4e 53 54 52 41 49 4e 54 22 3b 20 20 20 20 20 ONSTRAINT";
9370: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
9380: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 case SQLITE_CONS
9390: 54 52 41 49 4e 54 5f 55 4e 49 51 55 45 3a 20 20 TRAINT_UNIQUE:
93a0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
93b0: 43 4f 4e 53 54 52 41 49 4e 54 5f 55 4e 49 51 55 CONSTRAINT_UNIQU
93c0: 45 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 E"; break;.
93d0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
93e0: 53 54 52 41 49 4e 54 5f 54 52 49 47 47 45 52 3a STRAINT_TRIGGER:
93f0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9400: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 54 52 49 47 _CONSTRAINT_TRIG
9410: 47 45 52 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 GER";break;.
9420: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
9430: 4e 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 47 4e NSTRAINT_FOREIGN
9440: 4b 45 59 3a 0a 20 20 20 20 20 20 20 20 20 20 20 KEY:.
9450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9460: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
9470: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
9480: 46 4f 52 45 49 47 4e 4b 45 59 22 3b 20 20 20 62 FOREIGNKEY"; b
9490: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
94a0: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
94b0: 4e 54 5f 43 48 45 43 4b 3a 20 20 20 7a 4e 61 6d NT_CHECK: zNam
94c0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
94d0: 54 52 41 49 4e 54 5f 43 48 45 43 4b 22 3b 20 20 TRAINT_CHECK";
94e0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
94f0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
9500: 49 4e 54 5f 50 52 49 4d 41 52 59 4b 45 59 3a 0a INT_PRIMARYKEY:.
9510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9530: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
9540: 43 4f 4e 53 54 52 41 49 4e 54 5f 50 52 49 4d 41 CONSTRAINT_PRIMA
9550: 52 59 4b 45 59 22 3b 20 20 20 62 72 65 61 6b 3b RYKEY"; break;
9560: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
9570: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4e 4f TE_CONSTRAINT_NO
9580: 54 4e 55 4c 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 TNULL: zName = "
9590: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
95a0: 54 5f 4e 4f 54 4e 55 4c 4c 22 3b 62 72 65 61 6b T_NOTNULL";break
95b0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
95c0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 43 ITE_CONSTRAINT_C
95d0: 4f 4d 4d 49 54 48 4f 4f 4b 3a 0a 20 20 20 20 20 OMMITHOOK:.
95e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95f0: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
9600: 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 = "SQLITE_CONST
9610: 52 41 49 4e 54 5f 43 4f 4d 4d 49 54 48 4f 4f 4b RAINT_COMMITHOOK
9620: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 "; break;.
9630: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
9640: 4e 53 54 52 41 49 4e 54 5f 56 54 41 42 3a 20 20 NSTRAINT_VTAB:
9650: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
9660: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 56 54 41 E_CONSTRAINT_VTA
9670: 42 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 B"; break;.
9680: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
9690: 4f 4e 53 54 52 41 49 4e 54 5f 46 55 4e 43 54 49 ONSTRAINT_FUNCTI
96a0: 4f 4e 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 ON:.
96b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
96c0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
96d0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 ITE_CONSTRAINT_F
96e0: 55 4e 43 54 49 4f 4e 22 3b 20 20 20 20 20 62 72 UNCTION"; br
96f0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
9700: 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 48 3a SQLITE_MISMATCH:
9710: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
9720: 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 4d 41 = "SQLITE_MISMA
9730: 54 43 48 22 3b 20 20 20 20 20 20 20 20 20 20 62 TCH"; b
9740: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
9750: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3a 20 SQLITE_MISUSE:
9760: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
9770: 65 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 55 e = "SQLITE_MISU
9780: 53 45 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 SE";
9790: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
97a0: 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3a 20 e SQLITE_NOLFS:
97b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
97c0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 4c me = "SQLITE_NOL
97d0: 46 53 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 FS";
97e0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
97f0: 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a 20 se SQLITE_AUTH:
9800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
9810: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 55 ame = "SQLITE_AU
9820: 54 48 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 TH";
9830: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9840: 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 ase SQLITE_FORMA
9850: 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a T: z
9860: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 46 Name = "SQLITE_F
9870: 4f 52 4d 41 54 22 3b 20 20 20 20 20 20 20 20 20 ORMAT";
9880: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
9890: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 case SQLITE_RANG
98a0: 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 E:
98b0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
98c0: 52 41 4e 47 45 22 3b 20 20 20 20 20 20 20 20 20 RANGE";
98d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
98e0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 case SQLITE_NOT
98f0: 41 44 42 3a 20 20 20 20 20 20 20 20 20 20 20 20 ADB:
9900: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9910: 5f 4e 4f 54 41 44 42 22 3b 20 20 20 20 20 20 20 _NOTADB";
9920: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
9930: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 4f case SQLITE_RO
9940: 57 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 W:
9950: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
9960: 45 5f 52 4f 57 22 3b 20 20 20 20 20 20 20 20 20 E_ROW";
9970: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
9980: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
9990: 4f 54 49 43 45 3a 20 20 20 20 20 20 20 20 20 20 OTICE:
99a0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
99b0: 54 45 5f 4e 4f 54 49 43 45 22 3b 20 20 20 20 20 TE_NOTICE";
99c0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
99d0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
99e0: 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 57 NOTICE_RECOVER_W
99f0: 41 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c AL: zName = "SQL
9a00: 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 ITE_NOTICE_RECOV
9a10: 45 52 5f 57 41 4c 22 3b 62 72 65 61 6b 3b 0a 20 ER_WAL";break;.
9a20: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
9a30: 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f _NOTICE_RECOVER_
9a40: 52 4f 4c 4c 42 41 43 4b 3a 0a 20 20 20 20 20 20 ROLLBACK:.
9a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9a60: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
9a70: 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 = "SQLITE_NOTICE
9a80: 5f 52 45 43 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 _RECOVER_ROLLBAC
9a90: 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 K"; break;.
9aa0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 57 41 52 case SQLITE_WAR
9ab0: 4e 49 4e 47 3a 20 20 20 20 20 20 20 20 20 20 20 NING:
9ac0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9ad0: 5f 57 41 52 4e 49 4e 47 22 3b 20 20 20 20 20 20 _WARNING";
9ae0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
9af0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 4f case SQLITE_DO
9b00: 4e 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 NE:
9b10: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
9b20: 45 5f 44 4f 4e 45 22 3b 20 20 20 20 20 20 20 20 E_DONE";
9b30: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
9b40: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 7a 4e 61 }. }. if( zNa
9b50: 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 61 me==0 ){. sta
9b60: 74 69 63 20 63 68 61 72 20 7a 42 75 66 5b 35 30 tic char zBuf[50
9b70: 5d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 ];. sqlite3_s
9b80: 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 7a nprintf(sizeof(z
9b90: 42 75 66 29 2c 20 7a 42 75 66 2c 20 22 53 51 4c Buf), zBuf, "SQL
9ba0: 49 54 45 5f 55 4e 4b 4e 4f 57 4e 28 25 64 29 22 ITE_UNKNOWN(%d)"
9bb0: 2c 20 6f 72 69 67 52 63 29 3b 0a 20 20 20 20 7a , origRc);. z
9bc0: 4e 61 6d 65 20 3d 20 7a 42 75 66 3b 0a 20 20 7d Name = zBuf;. }
9bd0: 0a 20 20 72 65 74 75 72 6e 20 7a 4e 61 6d 65 3b . return zName;
9be0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
9bf0: 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 Return a static
9c00: 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 string that des
9c10: 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 cribes the kind
9c20: 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 of error specifi
9c30: 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 ed in the.** arg
9c40: 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 ument..*/.const
9c50: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 char *sqlite3Err
9c60: 53 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 73 Str(int rc){. s
9c70: 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 tatic const char
9c80: 2a 20 63 6f 6e 73 74 20 61 4d 73 67 5b 5d 20 3d * const aMsg[] =
9c90: 20 7b 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 {. /* SQLITE
9ca0: 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 2a 2f 20 _OK */
9cb0: 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 2c 0a "not an error",.
9cc0: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 52 /* SQLITE_ER
9cd0: 52 4f 52 20 20 20 20 20 20 20 2a 2f 20 22 53 51 ROR */ "SQ
9ce0: 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f 72 L logic error or
9cf0: 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 73 missing databas
9d00: 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 e",. /* SQLIT
9d10: 45 5f 49 4e 54 45 52 4e 41 4c 20 20 20 20 2a 2f E_INTERNAL */
9d20: 20 30 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 0,. /* SQLIT
9d30: 45 5f 50 45 52 4d 20 20 20 20 20 20 20 20 2a 2f E_PERM */
9d40: 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 73 "access permiss
9d50: 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 ion denied",.
9d60: 20 2f 2a 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 /* SQLITE_ABORT
9d70: 20 20 20 20 20 20 20 2a 2f 20 22 63 61 6c 6c 62 */ "callb
9d80: 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71 75 ack requested qu
9d90: 65 72 79 20 61 62 6f 72 74 22 2c 0a 20 20 20 20 ery abort",.
9da0: 2f 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 20 /* SQLITE_BUSY
9db0: 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 */ "databa
9dc0: 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0a 20 se is locked",.
9dd0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4c 4f 43 /* SQLITE_LOC
9de0: 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 64 61 74 KED */ "dat
9df0: 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 6c abase table is l
9e00: 6f 63 6b 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 ocked",. /* S
9e10: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 20 20 20 QLITE_NOMEM
9e20: 20 20 2a 2f 20 22 6f 75 74 20 6f 66 20 6d 65 6d */ "out of mem
9e30: 6f 72 79 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ory",. /* SQL
9e40: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 20 20 20 ITE_READONLY
9e50: 2a 2f 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 */ "attempt to w
9e60: 72 69 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 rite a readonly
9e70: 64 61 74 61 62 61 73 65 22 2c 0a 20 20 20 20 2f database",. /
9e80: 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 * SQLITE_INTERRU
9e90: 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 72 72 75 PT */ "interru
9ea0: 70 74 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 pted",. /* SQ
9eb0: 4c 49 54 45 5f 49 4f 45 52 52 20 20 20 20 20 20 LITE_IOERR
9ec0: 20 2a 2f 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 */ "disk I/O er
9ed0: 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ror",. /* SQL
9ee0: 49 54 45 5f 43 4f 52 52 55 50 54 20 20 20 20 20 ITE_CORRUPT
9ef0: 2a 2f 20 22 64 61 74 61 62 61 73 65 20 64 69 73 */ "database dis
9f00: 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f k image is malfo
9f10: 72 6d 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 rmed",. /* SQ
9f20: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 20 20 LITE_NOTFOUND
9f30: 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 6f 70 65 */ "unknown ope
9f40: 72 61 74 69 6f 6e 22 2c 0a 20 20 20 20 2f 2a 20 ration",. /*
9f50: 53 51 4c 49 54 45 5f 46 55 4c 4c 20 20 20 20 20 SQLITE_FULL
9f60: 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 */ "database
9f70: 6f 72 20 64 69 73 6b 20 69 73 20 66 75 6c 6c 22 or disk is full"
9f80: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
9f90: 43 41 4e 54 4f 50 45 4e 20 20 20 20 2a 2f 20 22 CANTOPEN */ "
9fa0: 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 unable to open d
9fb0: 61 74 61 62 61 73 65 20 66 69 6c 65 22 2c 0a 20 atabase file",.
9fc0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 4f /* SQLITE_PRO
9fd0: 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 6c 6f 63 TOCOL */ "loc
9fe0: 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 22 2c 0a king protocol",.
9ff0: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4d /* SQLITE_EM
a000: 50 54 59 20 20 20 20 20 20 20 2a 2f 20 22 74 61 PTY */ "ta
a010: 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 ble contains no
a020: 64 61 74 61 22 2c 0a 20 20 20 20 2f 2a 20 53 51 data",. /* SQ
a030: 4c 49 54 45 5f 53 43 48 45 4d 41 20 20 20 20 20 LITE_SCHEMA
a040: 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 73 63 */ "database sc
a050: 68 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 64 hema has changed
a060: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
a070: 5f 54 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f 20 _TOOBIG */
a080: 22 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 "string or blob
a090: 74 6f 6f 20 62 69 67 22 2c 0a 20 20 20 20 2f 2a too big",. /*
a0a0: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
a0b0: 4e 54 20 20 2a 2f 20 22 63 6f 6e 73 74 72 61 69 NT */ "constrai
a0c0: 6e 74 20 66 61 69 6c 65 64 22 2c 0a 20 20 20 20 nt failed",.
a0d0: 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 /* SQLITE_MISMAT
a0e0: 43 48 20 20 20 20 2a 2f 20 22 64 61 74 61 74 79 CH */ "dataty
a0f0: 70 65 20 6d 69 73 6d 61 74 63 68 22 2c 0a 20 20 pe mismatch",.
a100: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 /* SQLITE_MISU
a110: 53 45 20 20 20 20 20 20 2a 2f 20 22 6c 69 62 72 SE */ "libr
a120: 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c ary routine call
a130: 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e ed out of sequen
a140: 63 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ce",. /* SQLI
a150: 54 45 5f 4e 4f 4c 46 53 20 20 20 20 20 20 20 2a TE_NOLFS *
a160: 2f 20 22 6c 61 72 67 65 20 66 69 6c 65 20 73 75 / "large file su
a170: 70 70 6f 72 74 20 69 73 20 64 69 73 61 62 6c 65 pport is disable
a180: 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 d",. /* SQLIT
a190: 45 5f 41 55 54 48 20 20 20 20 20 20 20 20 2a 2f E_AUTH */
a1a0: 20 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 "authorization
a1b0: 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 2f 2a 20 denied",. /*
a1c0: 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 20 20 20 SQLITE_FORMAT
a1d0: 20 20 20 2a 2f 20 22 61 75 78 69 6c 69 61 72 79 */ "auxiliary
a1e0: 20 64 61 74 61 62 61 73 65 20 66 6f 72 6d 61 74 database format
a1f0: 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 error",. /*
a200: 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 20 20 20 SQLITE_RANGE
a210: 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f 72 20 63 */ "bind or c
a220: 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f 75 74 20 olumn index out
a230: 6f 66 20 72 61 6e 67 65 22 2c 0a 20 20 20 20 2f of range",. /
a240: 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 20 * SQLITE_NOTADB
a250: 20 20 20 20 20 2a 2f 20 22 66 69 6c 65 20 69 73 */ "file is
a260: 20 65 6e 63 72 79 70 74 65 64 20 6f 72 20 69 73 encrypted or is
a270: 20 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 22 not a database"
a280: 2c 0a 20 20 7d 3b 0a 20 20 63 6f 6e 73 74 20 63 ,. };. const c
a290: 68 61 72 20 2a 7a 45 72 72 20 3d 20 22 75 6e 6b har *zErr = "unk
a2a0: 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 0a 20 20 73 nown error";. s
a2b0: 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 20 witch( rc ){.
a2c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f case SQLITE_ABO
a2d0: 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 7b 0a 20 RT_ROLLBACK: {.
a2e0: 20 20 20 20 20 7a 45 72 72 20 3d 20 22 61 62 6f zErr = "abo
a2f0: 72 74 20 64 75 65 20 74 6f 20 52 4f 4c 4c 42 41 rt due to ROLLBA
a300: 43 4b 22 3b 0a 20 20 20 20 20 20 62 72 65 61 6b CK";. break
a310: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 ;. }. defa
a320: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 ult: {. rc
a330: 26 3d 20 30 78 66 66 3b 0a 20 20 20 20 20 20 69 &= 0xff;. i
a340: 66 28 20 41 4c 57 41 59 53 28 72 63 3e 3d 30 29 f( ALWAYS(rc>=0)
a350: 20 26 26 20 72 63 3c 41 72 72 61 79 53 69 7a 65 && rc<ArraySize
a360: 28 61 4d 73 67 29 20 26 26 20 61 4d 73 67 5b 72 (aMsg) && aMsg[r
a370: 63 5d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 c]!=0 ){.
a380: 20 7a 45 72 72 20 3d 20 61 4d 73 67 5b 72 63 5d zErr = aMsg[rc]
a390: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
a3a0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d break;. }. }
a3b0: 0a 20 20 72 65 74 75 72 6e 20 7a 45 72 72 3b 0a . return zErr;.
a3c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
a3d0: 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 utine implements
a3e0: 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b a busy callback
a3f0: 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e 64 that sleeps and
a400: 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e 20 tries.** again
a410: 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 20 until a timeout
a420: 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 65 64 value is reached
a430: 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20 76 . The timeout v
a440: 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 6e alue is.** an in
a450: 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 teger number of
a460: 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 73 milliseconds pas
a470: 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 66 69 sed in as the fi
a480: 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e rst.** argument.
a490: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
a4a0: 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 qliteDefaultBusy
a4b0: 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 20 Callback(. void
a4c0: 2a 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 20 *ptr,
a4d0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
a4e0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 69 connection */. i
a4f0: 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 20 nt count
a500: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
a510: 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c 65 r of times table
a520: 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 2a has been busy *
a530: 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f /.){.#if SQLITE_
a540: 4f 53 5f 57 49 4e 20 7c 7c 20 28 64 65 66 69 6e OS_WIN || (defin
a550: 65 64 28 48 41 56 45 5f 55 53 4c 45 45 50 29 20 ed(HAVE_USLEEP)
a560: 26 26 20 48 41 56 45 5f 55 53 4c 45 45 50 29 0a && HAVE_USLEEP).
a570: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 static const u
a580: 38 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 8 delays[] =.
a590: 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c { 1, 2, 5, 10,
a5a0: 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 15, 20, 25, 25,
a5b0: 20 20 32 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 25, 50, 50,
a5c0: 31 30 30 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 100 };. static
a5d0: 63 6f 6e 73 74 20 75 38 20 74 6f 74 61 6c 73 5b const u8 totals[
a5e0: 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c ] =. { 0, 1,
a5f0: 20 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 3, 8, 18, 33,
a600: 35 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 38 53, 78, 103, 128
a610: 2c 20 31 37 38 2c 20 32 32 38 20 7d 3b 0a 23 20 , 178, 228 };.#
a620: 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 41 72 define NDELAY Ar
a630: 72 61 79 53 69 7a 65 28 64 65 6c 61 79 73 29 0a raySize(delays).
a640: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
a650: 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a (sqlite3 *)ptr;.
a660: 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 int timeout =
a670: 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b db->busyTimeout;
a680: 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 . int delay, pr
a690: 69 6f 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ior;.. assert(
a6a0: 63 6f 75 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 66 count>=0 );. if
a6b0: 28 20 63 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 59 ( count < NDELAY
a6c0: 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 ){. delay =
a6d0: 64 65 6c 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a 20 delays[count];.
a6e0: 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c prior = total
a6f0: 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c 73 s[count];. }els
a700: 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 e{. delay = d
a710: 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b elays[NDELAY-1];
a720: 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 . prior = tot
a730: 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 als[NDELAY-1] +
a740: 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 28 4e 44 delay*(count-(ND
a750: 45 4c 41 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 20 ELAY-1));. }.
a760: 69 66 28 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 if( prior + dela
a770: 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 y > timeout ){.
a780: 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f delay = timeo
a790: 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 ut - prior;.
a7a0: 69 66 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 if( delay<=0 ) r
a7b0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 eturn 0;. }. s
a7c0: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 64 62 qlite3OsSleep(db
a7d0: 2d 3e 70 56 66 73 2c 20 64 65 6c 61 79 2a 31 30 ->pVfs, delay*10
a7e0: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 00);. return 1;
a7f0: 0a 23 65 6c 73 65 0a 20 20 73 71 6c 69 74 65 33 .#else. sqlite3
a800: 20 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 33 20 *db = (sqlite3
a810: 2a 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d *)ptr;. int tim
a820: 65 6f 75 74 20 3d 20 28 28 73 71 6c 69 74 65 33 eout = ((sqlite3
a830: 20 2a 29 70 74 72 29 2d 3e 62 75 73 79 54 69 6d *)ptr)->busyTim
a840: 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 eout;. if( (cou
a850: 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 6d nt+1)*1000 > tim
a860: 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 75 eout ){. retu
a870: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 rn 0;. }. sqli
a880: 74 65 33 4f 73 53 6c 65 65 70 28 64 62 2d 3e 70 te3OsSleep(db->p
a890: 56 66 73 2c 20 31 30 30 30 30 30 30 29 3b 0a 20 Vfs, 1000000);.
a8a0: 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 return 1;.#endi
a8b0: 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b f.}../*.** Invok
a8c0: 65 20 74 68 65 20 67 69 76 65 6e 20 62 75 73 79 e the given busy
a8d0: 20 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 handler..**.**
a8e0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
a8f0: 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 6e 20 6f called when an o
a900: 70 65 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 peration failed
a910: 77 69 74 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a 20 with a lock..**
a920: 49 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 If this routine
a930: 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f returns non-zero
a940: 2c 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 72 65 , the lock is re
a950: 74 72 69 65 64 2e 20 20 49 66 20 69 74 0a 2a 2a tried. If it.**
a960: 20 72 65 74 75 72 6e 73 20 30 2c 20 74 68 65 20 returns 0, the
a970: 6f 70 65 72 61 74 69 6f 6e 20 61 62 6f 72 74 73 operation aborts
a980: 20 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f with an SQLITE_
a990: 42 55 53 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a 69 BUSY error..*/.i
a9a0: 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 nt sqlite3Invoke
a9b0: 42 75 73 79 48 61 6e 64 6c 65 72 28 42 75 73 79 BusyHandler(Busy
a9c0: 48 61 6e 64 6c 65 72 20 2a 70 29 7b 0a 20 20 69 Handler *p){. i
a9d0: 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 4e 45 56 nt rc;. if( NEV
a9e0: 45 52 28 70 3d 3d 30 29 20 7c 7c 20 70 2d 3e 78 ER(p==0) || p->x
a9f0: 46 75 6e 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 42 Func==0 || p->nB
aa00: 75 73 79 3c 30 20 29 20 72 65 74 75 72 6e 20 30 usy<0 ) return 0
aa10: 3b 0a 20 20 72 63 20 3d 20 70 2d 3e 78 46 75 6e ;. rc = p->xFun
aa20: 63 28 70 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e 42 c(p->pArg, p->nB
aa30: 75 73 79 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d usy);. if( rc==
aa40: 30 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 0 ){. p->nBus
aa50: 79 20 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b y = -1;. }else{
aa60: 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 2b 2b 3b . p->nBusy++;
aa70: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
aa80: 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ; .}../*.** This
aa90: 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 routine sets th
aaa0: 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 e busy callback
aab0: 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 for an Sqlite da
aac0: 74 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a tabase to the.**
aad0: 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 given callback
aae0: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 function with th
aaf0: 65 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 e given argument
ab00: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
ab10: 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 _busy_handler(.
ab20: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 sqlite3 *db,.
ab30: 69 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f 69 int (*xBusy)(voi
ab40: 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 d*,int),. void
ab50: 2a 70 41 72 67 0a 29 7b 0a 20 20 73 71 6c 69 74 *pArg.){. sqlit
ab60: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
ab70: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d b->mutex);. db-
ab80: 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 78 46 75 >busyHandler.xFu
ab90: 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 nc = xBusy;. db
aba0: 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 70 41 ->busyHandler.pA
abb0: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 64 62 2d rg = pArg;. db-
abc0: 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 6e 42 75 >busyHandler.nBu
abd0: 73 79 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 62 75 sy = 0;. db->bu
abe0: 73 79 54 69 6d 65 6f 75 74 20 3d 20 30 3b 0a 20 syTimeout = 0;.
abf0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
ac00: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
ac10: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
ac20: 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 _OK;.}..#ifndef
ac30: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 SQLITE_OMIT_PROG
ac40: 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a RESS_CALLBACK./*
ac50: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
ac60: 20 73 65 74 73 20 74 68 65 20 70 72 6f 67 72 65 sets the progre
ac70: 73 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 ss callback for
ac80: 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 an Sqlite databa
ac90: 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 se to the.** giv
aca0: 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 en callback func
acb0: 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 tion with the gi
acc0: 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 ven argument. Th
acd0: 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 e progress callb
ace0: 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 ack will.** be i
acf0: 6e 76 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 nvoked every nOp
ad00: 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f s opcodes..*/.vo
ad10: 69 64 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 id sqlite3_progr
ad20: 65 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 ess_handler(. s
ad30: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 69 qlite3 *db, . i
ad40: 6e 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 nt nOps,. int (
ad50: 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69 64 *xProgress)(void
ad60: 2a 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 *), . void *pAr
ad70: 67 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d g.){. sqlite3_m
ad80: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
ad90: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 6e 4f 70 utex);. if( nOp
ada0: 73 3e 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 s>0 ){. db->x
adb0: 50 72 6f 67 72 65 73 73 20 3d 20 78 50 72 6f 67 Progress = xProg
adc0: 72 65 73 73 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 ress;. db->nP
add0: 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 rogressOps = nOp
ade0: 73 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 s;. db->pProg
adf0: 72 65 73 73 41 72 67 20 3d 20 70 41 72 67 3b 0a ressArg = pArg;.
ae00: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d }else{. db-
ae10: 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a >xProgress = 0;.
ae20: 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 db->nProgres
ae30: 73 4f 70 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 sOps = 0;. db
ae40: 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d ->pProgressArg =
ae50: 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 0;. }. sqlite
ae60: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
ae70: 2d 3e 6d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 ->mutex);.}.#end
ae80: 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 if.../*.** This
ae90: 72 6f 75 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 routine installs
aea0: 20 61 20 64 65 66 61 75 6c 74 20 62 75 73 79 20 a default busy
aeb0: 68 61 6e 64 6c 65 72 20 74 68 61 74 20 77 61 69 handler that wai
aec0: 74 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 ts for the.** sp
aed0: 65 63 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f ecified number o
aee0: 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 f milliseconds b
aef0: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 efore returning
af00: 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 0..*/.int sqlite
af10: 33 5f 62 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 3_busy_timeout(s
af20: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
af30: 6d 73 29 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 ms){. if( ms>0
af40: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62 ){. sqlite3_b
af50: 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 usy_handler(db,
af60: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 sqliteDefaultBus
af70: 79 43 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 yCallback, (void
af80: 2a 29 64 62 29 3b 0a 20 20 20 20 64 62 2d 3e 62 *)db);. db->b
af90: 75 73 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 3b usyTimeout = ms;
afa0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 . }else{. sq
afb0: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c lite3_busy_handl
afc0: 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 er(db, 0, 0);.
afd0: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
afe0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 E_OK;.}../*.** C
aff0: 61 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 ause any pending
b000: 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 operation to st
b010: 6f 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 op at its earlie
b020: 73 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a st opportunity..
b030: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f */.void sqlite3_
b040: 69 6e 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 interrupt(sqlite
b050: 33 20 2a 64 62 29 7b 0a 20 20 64 62 2d 3e 75 31 3 *db){. db->u1
b060: 2e 69 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d .isInterrupted =
b070: 20 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 1;.}.../*.** Th
b080: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 65 is function is e
b090: 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 xactly the same
b0a0: 61 73 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 as sqlite3_creat
b0b0: 65 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 65 78 e_function(), ex
b0c0: 63 65 70 74 0a 2a 2a 20 74 68 61 74 20 69 74 20 cept.** that it
b0d0: 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 62 is designed to b
b0e0: 65 20 63 61 6c 6c 65 64 20 62 79 20 69 6e 74 65 e called by inte
b0f0: 72 6e 61 6c 20 63 6f 64 65 2e 20 54 68 65 20 64 rnal code. The d
b100: 69 66 66 65 72 65 6e 63 65 20 69 73 0a 2a 2a 20 ifference is.**
b110: 74 68 61 74 20 69 66 20 61 20 6d 61 6c 6c 6f 63 that if a malloc
b120: 28 29 20 66 61 69 6c 73 20 69 6e 20 73 71 6c 69 () fails in sqli
b130: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
b140: 69 6f 6e 28 29 2c 20 61 6e 20 65 72 72 6f 72 20 ion(), an error
b150: 63 6f 64 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 code.** is retur
b160: 6e 65 64 20 61 6e 64 20 74 68 65 20 6d 61 6c 6c ned and the mall
b170: 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 63 6c ocFailed flag cl
b180: 65 61 72 65 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 eared. .*/.int s
b190: 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 qlite3CreateFunc
b1a0: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
b1b0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
b1c0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 FunctionName,.
b1d0: 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 int nArg,. int
b1e0: 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73 enc,. void *pUs
b1f0: 65 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20 28 erData,. void (
b200: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f *xFunc)(sqlite3_
b210: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
b220: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a ite3_value **),.
b230: 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 void (*xStep)(
b240: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
b250: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
b260: 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 ue **),. void (
b270: 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 *xFinal)(sqlite3
b280: 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 46 75 _context*),. Fu
b290: 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 44 ncDestructor *pD
b2a0: 65 73 74 72 75 63 74 6f 72 0a 29 7b 0a 20 20 46 estructor.){. F
b2b0: 75 6e 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 uncDef *p;. int
b2c0: 20 6e 4e 61 6d 65 3b 0a 0a 20 20 61 73 73 65 72 nName;.. asser
b2d0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
b2e0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 _held(db->mutex)
b2f0: 20 29 3b 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 );. if( zFunct
b300: 69 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 ionName==0 ||.
b310: 20 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78 (xFunc && (x
b320: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 Final || xStep))
b330: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75 || . (!xFu
b340: 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26 nc && (xFinal &&
b350: 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 !xStep)) ||.
b360: 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21 (!xFunc && (!
b370: 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29 xFinal && xStep)
b380: 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 ) ||. (nArg
b390: 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 53 51 4c 49 <-1 || nArg>SQLI
b3a0: 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f TE_MAX_FUNCTION_
b3b0: 41 52 47 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 ARG) ||. (2
b3c0: 35 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 55<(nName = sqli
b3d0: 74 65 33 53 74 72 6c 65 6e 33 30 28 20 7a 46 75 te3Strlen30( zFu
b3e0: 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b nctionName))) ){
b3f0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
b400: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
b410: 20 20 7d 0a 20 20 0a 23 69 66 6e 64 65 66 20 53 }. .#ifndef S
b420: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
b430: 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f . /* If SQLITE_
b440: 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69 UTF16 is specifi
b450: 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 ed as the encodi
b460: 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f ng type, transfo
b470: 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 rm this. ** to
b480: 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 one of SQLITE_UT
b490: 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f F16LE or SQLITE_
b4a0: 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 UTF16BE using th
b4b0: 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 e. ** SQLITE_UT
b4c0: 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e F16NATIVE macro.
b4d0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 SQLITE_UTF16 is
b4e0: 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e not used intern
b4f0: 61 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ally.. **. **
b500: 49 66 20 53 51 4c 49 54 45 5f 41 4e 59 20 69 73 If SQLITE_ANY is
b510: 20 73 70 65 63 69 66 69 65 64 2c 20 61 64 64 20 specified, add
b520: 74 68 72 65 65 20 76 65 72 73 69 6f 6e 73 20 6f three versions o
b530: 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a 20 f the function.
b540: 20 2a 2a 20 74 6f 20 74 68 65 20 68 61 73 68 20 ** to the hash
b550: 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 table.. */. if
b560: 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 ( enc==SQLITE_UT
b570: 46 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d F16 ){. enc =
b580: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
b590: 49 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 IVE;. }else if(
b5a0: 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 enc==SQLITE_ANY
b5b0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a ){. int rc;.
b5c0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
b5d0: 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a CreateFunc(db, z
b5e0: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 FunctionName, nA
b5f0: 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c rg, SQLITE_UTF8,
b600: 0a 20 20 20 20 20 20 20 20 20 70 55 73 65 72 44 . pUserD
b610: 61 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 ata, xFunc, xSte
b620: 70 2c 20 78 46 69 6e 61 6c 2c 20 70 44 65 73 74 p, xFinal, pDest
b630: 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 69 66 28 ructor);. if(
b640: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
b650: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
b660: 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 ite3CreateFunc(d
b670: 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 b, zFunctionName
b680: 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 , nArg, SQLITE_U
b690: 54 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 20 20 TF16LE,.
b6a0: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 pUserData, xFu
b6b0: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 nc, xStep, xFina
b6c0: 6c 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b l, pDestructor);
b6d0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
b6e0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
b6f0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
b700: 0a 20 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d . }. enc =
b710: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b SQLITE_UTF16BE;
b720: 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 . }.#else. enc
b730: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a = SQLITE_UTF8;.
b740: 23 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 #endif. . /* C
b750: 68 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 heck if an exist
b760: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 ing function is
b770: 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e being overridden
b780: 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 or deleted. If
b790: 73 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 so,. ** and the
b7a0: 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d re are active VM
b7b0: 73 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 s, then return S
b7c0: 51 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 QLITE_BUSY. If a
b7d0: 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 function. ** i
b7e0: 73 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 s being overridd
b7f0: 65 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 en/deleted but t
b800: 68 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 here are no acti
b810: 76 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 ve VMs, allow th
b820: 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e e. ** operation
b830: 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 to continue but
b840: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 invalidate all
b850: 70 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 precompiled stat
b860: 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 ements.. */. p
b870: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
b880: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
b890: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c tionName, nName,
b8a0: 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 nArg, (u8)enc,
b8b0: 30 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 70 0);. if( p && p
b8c0: 2d 3e 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63 20 ->iPrefEnc==enc
b8d0: 26 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72 67 && p->nArg==nArg
b8e0: 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e ){. if( db->
b8f0: 6e 56 64 62 65 41 63 74 69 76 65 20 29 7b 0a 20 nVdbeActive ){.
b900: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
b910: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 r(db, SQLITE_BUS
b920: 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 Y, . "una
b930: 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f ble to delete/mo
b940: 64 69 66 79 20 75 73 65 72 2d 66 75 6e 63 74 69 dify user-functi
b950: 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 69 76 65 on due to active
b960: 20 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 statements");.
b970: 20 20 20 20 20 61 73 73 65 72 74 28 20 21 64 62 assert( !db
b980: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
b990: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
b9a0: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 QLITE_BUSY;.
b9b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c }else{. sql
b9c0: 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 ite3ExpirePrepar
b9d0: 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 edStatements(db)
b9e0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 ;. }. }.. p
b9f0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
ba00: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
ba10: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c tionName, nName,
ba20: 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 nArg, (u8)enc,
ba30: 31 29 3b 0a 20 20 61 73 73 65 72 74 28 70 20 7c 1);. assert(p |
ba40: 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c | db->mallocFail
ba50: 65 64 29 3b 0a 20 20 69 66 28 20 21 70 20 29 7b ed);. if( !p ){
ba60: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
ba70: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 TE_NOMEM;. }..
ba80: 20 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 65 72 20 /* If an older
ba90: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 version of the f
baa0: 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 63 unction with a c
bab0: 6f 6e 66 69 67 75 72 65 64 20 64 65 73 74 72 75 onfigured destru
bac0: 63 74 6f 72 20 69 73 0a 20 20 2a 2a 20 62 65 69 ctor is. ** bei
bad0: 6e 67 20 72 65 70 6c 61 63 65 64 20 69 6e 76 6f ng replaced invo
bae0: 6b 65 20 74 68 65 20 64 65 73 74 72 75 63 74 6f ke the destructo
baf0: 72 20 66 75 6e 63 74 69 6f 6e 20 68 65 72 65 2e r function here.
bb00: 20 2a 2f 0a 20 20 66 75 6e 63 74 69 6f 6e 44 65 */. functionDe
bb10: 73 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 0a 20 stroy(db, p);..
bb20: 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f 72 if( pDestructor
bb30: 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 63 ){. pDestruc
bb40: 74 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 7d tor->nRef++;. }
bb50: 0a 20 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f . p->pDestructo
bb60: 72 20 3d 20 70 44 65 73 74 72 75 63 74 6f 72 3b r = pDestructor;
bb70: 0a 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20 30 3b . p->flags = 0;
bb80: 0a 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46 . p->xFunc = xF
bb90: 75 6e 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20 unc;. p->xStep
bba0: 3d 20 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78 46 = xStep;. p->xF
bbb0: 69 6e 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61 6c inalize = xFinal
bbc0: 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61 ;. p->pUserData
bbd0: 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20 = pUserData;.
bbe0: 70 2d 3e 6e 41 72 67 20 3d 20 28 75 31 36 29 6e p->nArg = (u16)n
bbf0: 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 Arg;. return SQ
bc00: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
bc10: 2a 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 * Create new use
bc20: 72 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a r functions..*/.
bc30: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 int sqlite3_crea
bc40: 74 65 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 te_function(. s
bc50: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f qlite3 *db,. co
bc60: 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 2c nst char *zFunc,
bc70: 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 . int nArg,. i
bc80: 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a nt enc,. void *
bc90: 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e p,. void (*xFun
bca0: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 c)(sqlite3_conte
bcb0: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
bcc0: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 value **),. voi
bcd0: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
bce0: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
bcf0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
bd00: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e ),. void (*xFin
bd10: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 al)(sqlite3_cont
bd20: 65 78 74 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 ext*).){. retur
bd30: 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 n sqlite3_create
bd40: 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 64 62 2c _function_v2(db,
bd50: 20 7a 46 75 6e 63 2c 20 6e 41 72 67 2c 20 65 6e zFunc, nArg, en
bd60: 63 2c 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 c, p, xFunc, xSt
bd70: 65 70 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ep,.
bd80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bd90: 20 20 20 20 20 20 20 20 78 46 69 6e 61 6c 2c 20 xFinal,
bda0: 30 29 3b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 74 0);.}..int sqlit
bdb0: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 e3_create_functi
bdc0: 6f 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33 on_v2(. sqlite3
bdd0: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 *db,. const ch
bde0: 61 72 20 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e 74 ar *zFunc,. int
bdf0: 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 nArg,. int enc
be00: 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 ,. void *p,. v
be10: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c oid (*xFunc)(sql
be20: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
be30: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
be40: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 **),. void (*xS
be50: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e tep)(sqlite3_con
be60: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
be70: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 3_value **),. v
be80: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 oid (*xFinal)(sq
be90: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 2c lite3_context*),
bea0: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 . void (*xDestr
beb0: 6f 79 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 oy)(void *).){.
bec0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
bed0: 5f 45 52 52 4f 52 3b 0a 20 20 46 75 6e 63 44 65 _ERROR;. FuncDe
bee0: 73 74 72 75 63 74 6f 72 20 2a 70 41 72 67 20 3d structor *pArg =
bef0: 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 0;. sqlite3_mu
bf00: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
bf10: 74 65 78 29 3b 0a 20 20 69 66 28 20 78 44 65 73 tex);. if( xDes
bf20: 74 72 6f 79 20 29 7b 0a 20 20 20 20 70 41 72 67 troy ){. pArg
bf30: 20 3d 20 28 46 75 6e 63 44 65 73 74 72 75 63 74 = (FuncDestruct
bf40: 6f 72 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 or *)sqlite3DbMa
bf50: 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a llocZero(db, siz
bf60: 65 6f 66 28 46 75 6e 63 44 65 73 74 72 75 63 74 eof(FuncDestruct
bf70: 6f 72 29 29 3b 0a 20 20 20 20 69 66 28 20 21 70 or));. if( !p
bf80: 41 72 67 20 29 7b 0a 20 20 20 20 20 20 78 44 65 Arg ){. xDe
bf90: 73 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 20 20 stroy(p);.
bfa0: 67 6f 74 6f 20 6f 75 74 3b 0a 20 20 20 20 7d 0a goto out;. }.
bfb0: 20 20 20 20 70 41 72 67 2d 3e 78 44 65 73 74 72 pArg->xDestr
bfc0: 6f 79 20 3d 20 78 44 65 73 74 72 6f 79 3b 0a 20 oy = xDestroy;.
bfd0: 20 20 20 70 41 72 67 2d 3e 70 55 73 65 72 44 61 pArg->pUserDa
bfe0: 74 61 20 3d 20 70 3b 0a 20 20 7d 0a 20 20 72 63 ta = p;. }. rc
bff0: 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 = sqlite3Create
c000: 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 2c 20 Func(db, zFunc,
c010: 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 46 nArg, enc, p, xF
c020: 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e unc, xStep, xFin
c030: 61 6c 2c 20 70 41 72 67 29 3b 0a 20 20 69 66 28 al, pArg);. if(
c040: 20 70 41 72 67 20 26 26 20 70 41 72 67 2d 3e 6e pArg && pArg->n
c050: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 Ref==0 ){. as
c060: 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
c070: 5f 4f 4b 20 29 3b 0a 20 20 20 20 78 44 65 73 74 _OK );. xDest
c080: 72 6f 79 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 roy(p);. sqli
c090: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 41 te3DbFree(db, pA
c0a0: 72 67 29 3b 0a 20 20 7d 0a 0a 20 6f 75 74 3a 0a rg);. }.. out:.
c0b0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 rc = sqlite3Ap
c0c0: 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 iExit(db, rc);.
c0d0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
c0e0: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
c0f0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
c100: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
c110: 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 OMIT_UTF16.int s
c120: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 qlite3_create_fu
c130: 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 nction16(. sqli
c140: 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 te3 *db,. const
c150: 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e void *zFunction
c160: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Name,. int nArg
c170: 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 52 65 70 ,. int eTextRep
c180: 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 ,. void *p,. v
c190: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c oid (*xFunc)(sql
c1a0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
c1b0: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a t,sqlite3_value*
c1c0: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 *),. void (*xSt
c1d0: 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 ep)(sqlite3_cont
c1e0: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
c1f0: 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 _value**),. voi
c200: 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 d (*xFinal)(sqli
c210: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b te3_context*).){
c220: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 . int rc;. cha
c230: 72 20 2a 7a 46 75 6e 63 38 3b 0a 20 20 73 71 6c r *zFunc8;. sql
c240: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
c250: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 (db->mutex);. a
c260: 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c ssert( !db->mall
c270: 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 46 ocFailed );. zF
c280: 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 55 74 unc8 = sqlite3Ut
c290: 66 31 36 74 6f 38 28 64 62 2c 20 7a 46 75 6e 63 f16to8(db, zFunc
c2a0: 74 69 6f 6e 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 tionName, -1, SQ
c2b0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
c2c0: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
c2d0: 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 3CreateFunc(db,
c2e0: 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54 zFunc8, nArg, eT
c2f0: 65 78 74 52 65 70 2c 20 70 2c 20 78 46 75 6e 63 extRep, p, xFunc
c300: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c , xStep, xFinal,
c310: 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 0);. sqlite3DbF
c320: 72 65 65 28 64 62 2c 20 7a 46 75 6e 63 38 29 3b ree(db, zFunc8);
c330: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
c340: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
c350: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
c360: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
c370: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
c380: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
c390: 44 65 63 6c 61 72 65 20 74 68 61 74 20 61 20 66 Declare that a f
c3a0: 75 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e unction has been
c3b0: 20 6f 76 65 72 6c 6f 61 64 65 64 20 62 79 20 61 overloaded by a
c3c0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0a virtual table..
c3d0: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 75 6e **.** If the fun
c3e0: 63 74 69 6f 6e 20 61 6c 72 65 61 64 79 20 65 78 ction already ex
c3f0: 69 73 74 73 20 61 73 20 61 20 72 65 67 75 6c 61 ists as a regula
c400: 72 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 6f r global functio
c410: 6e 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 20 n, then.** this
c420: 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d routine is a no-
c430: 6f 70 2e 20 20 49 66 20 74 68 65 20 66 75 6e 63 op. If the func
c440: 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 65 78 tion does not ex
c450: 69 73 74 2c 20 74 68 65 6e 20 63 72 65 61 74 65 ist, then create
c460: 0a 2a 2a 20 61 20 6e 65 77 20 6f 6e 65 20 74 68 .** a new one th
c470: 61 74 20 61 6c 77 61 79 73 20 74 68 72 6f 77 73 at always throws
c480: 20 61 20 72 75 6e 2d 74 69 6d 65 20 65 72 72 6f a run-time erro
c490: 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 r. .**.** When
c4a0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69 virtual tables i
c4b0: 6e 74 65 6e 64 20 74 6f 20 70 72 6f 76 69 64 65 ntend to provide
c4c0: 20 61 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 66 an overloaded f
c4d0: 75 6e 63 74 69 6f 6e 2c 20 74 68 65 79 0a 2a 2a unction, they.**
c4e0: 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 68 69 should call thi
c4f0: 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6b s routine to mak
c500: 65 20 73 75 72 65 20 74 68 65 20 67 6c 6f 62 61 e sure the globa
c510: 6c 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 73 74 l function exist
c520: 73 2e 0a 2a 2a 20 41 20 67 6c 6f 62 61 6c 20 66 s..** A global f
c530: 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 65 78 69 unction must exi
c540: 73 74 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 st in order for
c550: 6e 61 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 name resolution
c560: 74 6f 20 77 6f 72 6b 0a 2a 2a 20 70 72 6f 70 65 to work.** prope
c570: 72 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 rly..*/.int sqli
c580: 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 6e te3_overload_fun
c590: 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 ction(. sqlite3
c5a0: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 *db,. const ch
c5b0: 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 ar *zName,. int
c5c0: 20 6e 41 72 67 0a 29 7b 0a 20 20 69 6e 74 20 6e nArg.){. int n
c5d0: 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 Name = sqlite3St
c5e0: 72 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 3b 0a 20 rlen30(zName);.
c5f0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
c600: 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d _OK;. sqlite3_m
c610: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
c620: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 6c utex);. if( sql
c630: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e ite3FindFunction
c640: 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d (db, zName, nNam
c650: 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f e, nArg, SQLITE_
c660: 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 UTF8, 0)==0 ){.
c670: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 rc = sqlite3C
c680: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 4e reateFunc(db, zN
c690: 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 ame, nArg, SQLIT
c6a0: 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 E_UTF8,.
c6b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c6c0: 20 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 76 0, sqlite3Inv
c6d0: 61 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 2c alidFunction, 0,
c6e0: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 63 0, 0);. }. rc
c6f0: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 = sqlite3ApiExi
c700: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c t(db, rc);. sql
c710: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
c720: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
c730: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 eturn rc;.}..#if
c740: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
c750: 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 _TRACE./*.** Reg
c760: 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75 ister a trace fu
c770: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 nction. The pAr
c780: 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 g from the previ
c790: 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 ously registered
c7a0: 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 trace.** is ret
c7b0: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 urned. .**.** A
c7c0: 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 NULL trace func
c7d0: 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 tion means that
c7e0: 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 no tracing is ex
c7f0: 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e ecutes. A non-N
c800: 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 ULL.** trace is
c810: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 a pointer to a f
c820: 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 unction that is
c830: 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 invoked at the s
c840: 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 tart of each.**
c850: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a SQL statement..*
c860: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
c870: 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 trace(sqlite3 *d
c880: 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 b, void (*xTrace
c890: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
c8a0: 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 ar*), void *pArg
c8b0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b ){. void *pOld;
c8c0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
c8d0: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
c8e0: 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e );. pOld = db->
c8f0: 70 54 72 61 63 65 41 72 67 3b 0a 20 20 64 62 2d pTraceArg;. db-
c900: 3e 78 54 72 61 63 65 20 3d 20 78 54 72 61 63 65 >xTrace = xTrace
c910: 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65 41 72 ;. db->pTraceAr
c920: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
c930: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
c940: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
c950: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 2f 2a 0a turn pOld;.}./*.
c960: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 70 72 ** Register a pr
c970: 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 2e 20 ofile function.
c980: 20 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 74 The pArg from t
c990: 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 65 he previously re
c9a0: 67 69 73 74 65 72 65 64 20 0a 2a 2a 20 70 72 6f gistered .** pro
c9b0: 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 file function is
c9c0: 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a returned. .**.
c9d0: 2a 2a 20 41 20 4e 55 4c 4c 20 70 72 6f 66 69 6c ** A NULL profil
c9e0: 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 e function means
c9f0: 20 74 68 61 74 20 6e 6f 20 70 72 6f 66 69 6c 69 that no profili
ca00: 6e 67 20 69 73 20 65 78 65 63 75 74 65 73 2e 20 ng is executes.
ca10: 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 70 A non-NULL.** p
ca20: 72 6f 66 69 6c 65 20 69 73 20 61 20 70 6f 69 6e rofile is a poin
ca30: 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f ter to a functio
ca40: 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 n that is invoke
ca50: 64 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 d at the conclus
ca60: 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61 63 68 20 53 ion of.** each S
ca70: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61 QL statement tha
ca80: 74 20 69 73 20 72 75 6e 2e 0a 2a 2f 0a 76 6f 69 t is run..*/.voi
ca90: 64 20 2a 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 d *sqlite3_profi
caa0: 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 le(. sqlite3 *d
cab0: 62 2c 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 6f b,. void (*xPro
cac0: 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 file)(void*,cons
cad0: 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f 75 t char*,sqlite_u
cae0: 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 2a int64),. void *
caf0: 70 41 72 67 0a 29 7b 0a 20 20 76 6f 69 64 20 2a pArg.){. void *
cb00: 70 4f 6c 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f pOld;. sqlite3_
cb10: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
cb20: 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d mutex);. pOld =
cb30: 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 67 db->pProfileArg
cb40: 3b 0a 20 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 ;. db->xProfile
cb50: 20 3d 20 78 50 72 6f 66 69 6c 65 3b 0a 20 20 64 = xProfile;. d
cb60: 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 67 20 3d b->pProfileArg =
cb70: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
cb80: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
cb90: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
cba0: 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 6e 64 69 66 n pOld;.}.#endif
cbb0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
cbc0: 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 TRACE */../*.**
cbd0: 52 65 67 69 73 74 65 72 20 61 20 66 75 6e 63 74 Register a funct
cbe0: 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 ion to be invoke
cbf0: 64 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 d when a transac
cc00: 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 2e 0a 2a 2a tion commits..**
cc10: 20 49 66 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 If the invoked
cc20: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
cc30: 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 non-zero, then
cc40: 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d the commit becom
cc50: 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b es a.** rollback
cc60: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
cc70: 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a e3_commit_hook(.
cc80: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
cc90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
cca0: 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 ttach the hook t
ccb0: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 o this database
ccc0: 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c */. int (*xCall
ccd0: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f back)(void*), /
cce0: 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e * Function to in
ccf0: 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d voke on each com
cd00: 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 mit */. void *p
cd10: 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 Arg
cd20: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 /* Argument t
cd30: 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a o the function *
cd40: 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c /.){. void *pOl
cd50: 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 d;. sqlite3_mut
cd60: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
cd70: 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 ex);. pOld = db
cd80: 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 ->pCommitArg;.
cd90: 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 db->xCommitCallb
cda0: 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b ack = xCallback;
cdb0: 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 . db->pCommitAr
cdc0: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
cdd0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
cde0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
cdf0: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a turn pOld;.}../*
ce00: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
ce10: 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 6e allback to be in
ce20: 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 20 voked each time
ce30: 61 20 72 6f 77 20 69 73 20 75 70 64 61 74 65 64 a row is updated
ce40: 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 6f 72 ,.** inserted or
ce50: 20 64 65 6c 65 74 65 64 20 75 73 69 6e 67 20 74 deleted using t
ce60: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e his database con
ce70: 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 nection..*/.void
ce80: 20 2a 73 71 6c 69 74 65 33 5f 75 70 64 61 74 65 *sqlite3_update
ce90: 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 _hook(. sqlite3
cea0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
ceb0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 /* Attach the
cec0: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 hook to this da
ced0: 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 tabase */. void
cee0: 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f (*xCallback)(vo
cef0: 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20 63 6f 6e id*,int,char con
cf00: 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e 73 74 20 st *,char const
cf10: 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36 34 29 2c *,sqlite_int64),
cf20: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 . void *pArg
cf30: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
cf40: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
cf50: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 function */.){.
cf60: 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a 20 20 73 void *pRet;. s
cf70: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
cf80: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
cf90: 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 55 70 64 pRet = db->pUpd
cfa0: 61 74 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 55 ateArg;. db->xU
cfb0: 70 64 61 74 65 43 61 6c 6c 62 61 63 6b 20 3d 20 pdateCallback =
cfc0: 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d xCallback;. db-
cfd0: 3e 70 55 70 64 61 74 65 41 72 67 20 3d 20 70 41 >pUpdateArg = pA
cfe0: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
cff0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
d000: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 tex);. return p
d010: 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 Ret;.}../*.** Re
d020: 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 gister a callbac
d030: 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 k to be invoked
d040: 65 61 63 68 20 74 69 6d 65 20 61 20 74 72 61 6e each time a tran
d050: 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 saction is rolle
d060: 64 0a 2a 2a 20 62 61 63 6b 20 62 79 20 74 68 69 d.** back by thi
d070: 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 s database conne
d080: 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a ction..*/.void *
d090: 73 71 6c 69 74 65 33 5f 72 6f 6c 6c 62 61 63 6b sqlite3_rollback
d0a0: 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 _hook(. sqlite3
d0b0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
d0c0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 /* Attach the
d0d0: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 hook to this da
d0e0: 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 tabase */. void
d0f0: 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f (*xCallback)(vo
d100: 69 64 2a 29 2c 20 2f 2a 20 43 61 6c 6c 62 61 63 id*), /* Callbac
d110: 6b 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 k function */.
d120: 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 void *pArg
d130: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
d140: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e ument to the fun
d150: 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f ction */.){. vo
d160: 69 64 20 2a 70 52 65 74 3b 0a 20 20 73 71 6c 69 id *pRet;. sqli
d170: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
d180: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 52 db->mutex);. pR
d190: 65 74 20 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 et = db->pRollba
d1a0: 63 6b 41 72 67 3b 0a 20 20 64 62 2d 3e 78 52 6f ckArg;. db->xRo
d1b0: 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 3d llbackCallback =
d1c0: 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 xCallback;. db
d1d0: 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 20 3d ->pRollbackArg =
d1e0: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
d1f0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
d200: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
d210: 6e 20 70 52 65 74 3b 0a 7d 0a 0a 23 69 66 6e 64 n pRet;.}..#ifnd
d220: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
d230: 41 4c 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 71 6c AL./*.** The sql
d240: 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 ite3_wal_hook()
d250: 63 61 6c 6c 62 61 63 6b 20 72 65 67 69 73 74 65 callback registe
d260: 72 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 77 red by sqlite3_w
d270: 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e al_autocheckpoin
d280: 74 28 29 2e 0a 2a 2a 20 49 6e 76 6f 6b 65 20 73 t()..** Invoke s
d290: 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 6b qlite3_wal_check
d2a0: 70 6f 69 6e 74 20 69 66 20 74 68 65 20 6e 75 6d point if the num
d2b0: 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 69 6e ber of frames in
d2c0: 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 0a 2a 2a the log file.**
d2d0: 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
d2e0: 20 73 71 6c 69 74 65 33 2e 70 57 61 6c 41 72 67 sqlite3.pWalArg
d2f0: 20 63 61 73 74 20 74 6f 20 61 6e 20 69 6e 74 65 cast to an inte
d300: 67 65 72 20 28 74 68 65 20 76 61 6c 75 65 20 63 ger (the value c
d310: 6f 6e 66 69 67 75 72 65 64 20 62 79 0a 2a 2a 20 onfigured by.**
d320: 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 wal_autocheckpoi
d330: 6e 74 28 29 29 2e 0a 2a 2f 20 0a 69 6e 74 20 73 nt())..*/ .int s
d340: 71 6c 69 74 65 33 57 61 6c 44 65 66 61 75 6c 74 qlite3WalDefault
d350: 48 6f 6f 6b 28 0a 20 20 76 6f 69 64 20 2a 70 43 Hook(. void *pC
d360: 6c 69 65 6e 74 44 61 74 61 2c 20 20 20 20 20 2f lientData, /
d370: 2a 20 41 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 * Argument */.
d380: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
d390: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 /* Connec
d3a0: 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 tion */. const
d3b0: 63 68 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 20 char *zDb,
d3c0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 2a 2f 0a /* Database */.
d3d0: 20 20 69 6e 74 20 6e 46 72 61 6d 65 20 20 20 20 int nFrame
d3e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
d3f0: 20 6f 66 20 57 41 4c 20 2a 2f 0a 29 7b 0a 20 20 of WAL */.){.
d400: 69 66 28 20 6e 46 72 61 6d 65 3e 3d 53 51 4c 49 if( nFrame>=SQLI
d410: 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 43 TE_PTR_TO_INT(pC
d420: 6c 69 65 6e 74 44 61 74 61 29 20 29 7b 0a 20 20 lientData) ){.
d430: 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 sqlite3BeginBe
d440: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 nignMalloc();.
d450: 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 sqlite3_wal_ch
d460: 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 7a 44 62 eckpoint(db, zDb
d470: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 6e );. sqlite3En
d480: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b dBenignMalloc();
d490: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
d4a0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 LITE_OK;.}.#endi
d4b0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 f /* SQLITE_OMIT
d4c0: 5f 57 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 _WAL */../*.** C
d4d0: 6f 6e 66 69 67 75 72 65 20 61 6e 20 73 71 6c 69 onfigure an sqli
d4e0: 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 63 te3_wal_hook() c
d4f0: 61 6c 6c 62 61 63 6b 20 74 6f 20 61 75 74 6f 6d allback to autom
d500: 61 74 69 63 61 6c 6c 79 20 63 68 65 63 6b 70 6f atically checkpo
d510: 69 6e 74 0a 2a 2a 20 61 20 64 61 74 61 62 61 73 int.** a databas
d520: 65 20 61 66 74 65 72 20 63 6f 6d 6d 69 74 74 69 e after committi
d530: 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ng a transaction
d540: 20 69 66 20 74 68 65 72 65 20 61 72 65 20 6e 46 if there are nF
d550: 72 61 6d 65 20 6f 72 0a 2a 2a 20 6d 6f 72 65 20 rame or.** more
d560: 66 72 61 6d 65 73 20 69 6e 20 74 68 65 20 6c 6f frames in the lo
d570: 67 20 66 69 6c 65 2e 20 50 61 73 73 69 6e 67 20 g file. Passing
d580: 7a 65 72 6f 20 6f 72 20 61 20 6e 65 67 61 74 69 zero or a negati
d590: 76 65 20 76 61 6c 75 65 20 61 73 20 74 68 65 0a ve value as the.
d5a0: 2a 2a 20 6e 46 72 61 6d 65 20 70 61 72 61 6d 65 ** nFrame parame
d5b0: 74 65 72 20 64 69 73 61 62 6c 65 73 20 61 75 74 ter disables aut
d5c0: 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f 69 6e omatic checkpoin
d5d0: 74 73 20 65 6e 74 69 72 65 6c 79 2e 0a 2a 2a 0a ts entirely..**.
d5e0: 2a 2a 20 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 ** The callback
d5f0: 72 65 67 69 73 74 65 72 65 64 20 62 79 20 74 68 registered by th
d600: 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 70 6c is function repl
d610: 61 63 65 73 20 61 6e 79 20 65 78 69 73 74 69 6e aces any existin
d620: 67 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 72 65 g callback.** re
d630: 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 20 73 gistered using s
d640: 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
d650: 29 2e 20 4c 69 6b 65 77 69 73 65 2c 20 72 65 67 ). Likewise, reg
d660: 69 73 74 65 72 69 6e 67 20 61 20 63 61 6c 6c 62 istering a callb
d670: 61 63 6b 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c ack.** using sql
d680: 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 ite3_wal_hook()
d690: 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 75 74 disables the aut
d6a0: 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f 69 6e omatic checkpoin
d6b0: 74 20 6d 65 63 68 61 6e 69 73 6d 0a 2a 2a 20 63 t mechanism.** c
d6c0: 6f 6e 66 69 67 75 72 65 64 20 62 79 20 74 68 69 onfigured by thi
d6d0: 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 s function..*/.i
d6e0: 6e 74 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 61 nt sqlite3_wal_a
d6f0: 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 28 73 71 utocheckpoint(sq
d700: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e lite3 *db, int n
d710: 46 72 61 6d 65 29 7b 0a 23 69 66 64 65 66 20 53 Frame){.#ifdef S
d720: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
d730: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
d740: 52 28 64 62 29 3b 0a 20 20 55 4e 55 53 45 44 5f R(db);. UNUSED_
d750: 50 41 52 41 4d 45 54 45 52 28 6e 46 72 61 6d 65 PARAMETER(nFrame
d760: 29 3b 0a 23 65 6c 73 65 0a 20 20 69 66 28 20 6e );.#else. if( n
d770: 46 72 61 6d 65 3e 30 20 29 7b 0a 20 20 20 20 73 Frame>0 ){. s
d780: 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
d790: 64 62 2c 20 73 71 6c 69 74 65 33 57 61 6c 44 65 db, sqlite3WalDe
d7a0: 66 61 75 6c 74 48 6f 6f 6b 2c 20 53 51 4c 49 54 faultHook, SQLIT
d7b0: 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 6e 46 72 E_INT_TO_PTR(nFr
d7c0: 61 6d 65 29 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a ame));. }else{.
d7d0: 20 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f sqlite3_wal_
d7e0: 68 6f 6f 6b 28 64 62 2c 20 30 2c 20 30 29 3b 0a hook(db, 0, 0);.
d7f0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 }.#endif. ret
d800: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
d810: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 ../*.** Register
d820: 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 a callback to b
d830: 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 e invoked each t
d840: 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f ime a transactio
d850: 6e 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 n is written.**
d860: 69 6e 74 6f 20 74 68 65 20 77 72 69 74 65 2d 61 into the write-a
d870: 68 65 61 64 2d 6c 6f 67 20 62 79 20 74 68 69 73 head-log by this
d880: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
d890: 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 tion..*/.void *s
d8a0: 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
d8b0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
d8c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d8d0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 /* Attach the
d8e0: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 62 hook to this db
d8f0: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 handle */. int
d900: 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 (*xCallback)(voi
d910: 64 20 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 63 d *, sqlite3*, c
d920: 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 29 onst char*, int)
d930: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 ,. void *pArg
d940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d950: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
d960: 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f 20 ument passed to
d970: 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a 29 xCallback() */.)
d980: 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
d990: 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 76 6f 69 64 _OMIT_WAL. void
d9a0: 20 2a 70 52 65 74 3b 0a 20 20 73 71 6c 69 74 65 *pRet;. sqlite
d9b0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
d9c0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 52 65 74 ->mutex);. pRet
d9d0: 20 3d 20 64 62 2d 3e 70 57 61 6c 41 72 67 3b 0a = db->pWalArg;.
d9e0: 20 20 64 62 2d 3e 78 57 61 6c 43 61 6c 6c 62 61 db->xWalCallba
d9f0: 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a ck = xCallback;.
da00: 20 20 64 62 2d 3e 70 57 61 6c 41 72 67 20 3d 20 db->pWalArg =
da10: 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f pArg;. sqlite3_
da20: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
da30: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
da40: 20 70 52 65 74 3b 0a 23 65 6c 73 65 0a 20 20 72 pRet;.#else. r
da50: 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a eturn 0;.#endif.
da60: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 70 6f }../*.** Checkpo
da70: 69 6e 74 20 64 61 74 61 62 61 73 65 20 7a 44 62 int database zDb
da80: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
da90: 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f _wal_checkpoint_
daa0: 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 v2(. sqlite3 *d
dab0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
dac0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 /* Databas
dad0: 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f e handle */. co
dae0: 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 20 nst char *zDb,
daf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
db00: 20 4e 61 6d 65 20 6f 66 20 61 74 74 61 63 68 65 Name of attache
db10: 64 20 64 61 74 61 62 61 73 65 20 28 6f 72 20 4e d database (or N
db20: 55 4c 4c 29 20 2a 2f 0a 20 20 69 6e 74 20 65 4d ULL) */. int eM
db30: 6f 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ode,
db40: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c /* SQL
db50: 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 2a ITE_CHECKPOINT_*
db60: 20 76 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20 value */. int
db70: 2a 70 6e 4c 6f 67 2c 20 20 20 20 20 20 20 20 20 *pnLog,
db80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
db90: 55 54 3a 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 UT: Size of WAL
dba0: 6c 6f 67 20 69 6e 20 66 72 61 6d 65 73 20 2a 2f log in frames */
dbb0: 0a 20 20 69 6e 74 20 2a 70 6e 43 6b 70 74 20 20 . int *pnCkpt
dbc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dbd0: 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c /* OUT: Total
dbe0: 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 number of frame
dbf0: 73 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 20 2a s checkpointed *
dc00: 2f 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 /.){.#ifdef SQLI
dc10: 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 72 65 TE_OMIT_WAL. re
dc20: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
dc30: 23 65 6c 73 65 0a 20 20 69 6e 74 20 72 63 3b 20 #else. int rc;
dc40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dc50: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
dc60: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 n code */. int
dc70: 69 44 62 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 iDb = SQLITE_MAX
dc80: 5f 41 54 54 41 43 48 45 44 3b 20 20 2f 2a 20 73 _ATTACHED; /* s
dc90: 71 6c 69 74 65 33 2e 61 44 62 5b 5d 20 69 6e 64 qlite3.aDb[] ind
dca0: 65 78 20 6f 66 20 64 62 20 74 6f 20 63 68 65 63 ex of db to chec
dcb0: 6b 70 6f 69 6e 74 20 2a 2f 0a 0a 20 20 2f 2a 20 kpoint */.. /*
dcc0: 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6f Initialize the o
dcd0: 75 74 70 75 74 20 76 61 72 69 61 62 6c 65 73 20 utput variables
dce0: 74 6f 20 2d 31 20 69 6e 20 63 61 73 65 20 61 6e to -1 in case an
dcf0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 2a error occurs. *
dd00: 2f 0a 20 20 69 66 28 20 70 6e 4c 6f 67 20 29 20 /. if( pnLog )
dd10: 2a 70 6e 4c 6f 67 20 3d 20 2d 31 3b 0a 20 20 69 *pnLog = -1;. i
dd20: 66 28 20 70 6e 43 6b 70 74 20 29 20 2a 70 6e 43 f( pnCkpt ) *pnC
dd30: 6b 70 74 20 3d 20 2d 31 3b 0a 0a 20 20 61 73 73 kpt = -1;.. ass
dd40: 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 ert( SQLITE_CHEC
dd50: 4b 50 4f 49 4e 54 5f 46 55 4c 4c 3e 53 51 4c 49 KPOINT_FULL>SQLI
dd60: 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 TE_CHECKPOINT_PA
dd70: 53 53 49 56 45 20 29 3b 0a 20 20 61 73 73 65 72 SSIVE );. asser
dd80: 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 t( SQLITE_CHECKP
dd90: 4f 49 4e 54 5f 46 55 4c 4c 3c 53 51 4c 49 54 45 OINT_FULL<SQLITE
dda0: 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 52 45 53 54 _CHECKPOINT_REST
ddb0: 41 52 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ART );. assert(
ddc0: 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 SQLITE_CHECKPOI
ddd0: 4e 54 5f 50 41 53 53 49 56 45 2b 32 3d 3d 53 51 NT_PASSIVE+2==SQ
dde0: 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
ddf0: 52 45 53 54 41 52 54 20 29 3b 0a 20 20 69 66 28 RESTART );. if(
de00: 20 65 4d 6f 64 65 3c 53 51 4c 49 54 45 5f 43 48 eMode<SQLITE_CH
de10: 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 ECKPOINT_PASSIVE
de20: 20 7c 7c 20 65 4d 6f 64 65 3e 53 51 4c 49 54 45 || eMode>SQLITE
de30: 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 52 45 53 54 _CHECKPOINT_REST
de40: 41 52 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ART ){. retur
de50: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b n SQLITE_MISUSE;
de60: 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33 5f . }.. sqlite3_
de70: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
de80: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 7a 44 mutex);. if( zD
de90: 62 20 26 26 20 7a 44 62 5b 30 5d 20 29 7b 0a 20 b && zDb[0] ){.
dea0: 20 20 20 69 44 62 20 3d 20 73 71 6c 69 74 65 33 iDb = sqlite3
deb0: 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c 20 7a FindDbName(db, z
dec0: 44 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 Db);. }. if( i
ded0: 44 62 3c 30 20 29 7b 0a 20 20 20 20 72 63 20 3d Db<0 ){. rc =
dee0: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
def0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
df00: 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 db, SQLITE_ERROR
df10: 2c 20 22 75 6e 6b 6e 6f 77 6e 20 64 61 74 61 62 , "unknown datab
df20: 61 73 65 3a 20 25 73 22 2c 20 7a 44 62 29 3b 0a ase: %s", zDb);.
df30: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 }else{. rc
df40: 3d 20 73 71 6c 69 74 65 33 43 68 65 63 6b 70 6f = sqlite3Checkpo
df50: 69 6e 74 28 64 62 2c 20 69 44 62 2c 20 65 4d 6f int(db, iDb, eMo
df60: 64 65 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 6b 70 de, pnLog, pnCkp
df70: 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 t);. sqlite3E
df80: 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 30 29 3b rror(db, rc, 0);
df90: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
dfa0: 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 te3ApiExit(db, r
dfb0: 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 c);. sqlite3_mu
dfc0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
dfd0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 tex);. return r
dfe0: 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a c;.#endif.}.../*
dff0: 0a 2a 2a 20 43 68 65 63 6b 70 6f 69 6e 74 20 64 .** Checkpoint d
e000: 61 74 61 62 61 73 65 20 7a 44 62 2e 20 49 66 20 atabase zDb. If
e010: 7a 44 62 20 69 73 20 4e 55 4c 4c 2c 20 6f 72 20 zDb is NULL, or
e020: 69 66 20 74 68 65 20 62 75 66 66 65 72 20 7a 44 if the buffer zD
e030: 62 20 70 6f 69 6e 74 73 0a 2a 2a 20 74 6f 20 63 b points.** to c
e040: 6f 6e 74 61 69 6e 73 20 61 20 7a 65 72 6f 2d 6c ontains a zero-l
e050: 65 6e 67 74 68 20 73 74 72 69 6e 67 2c 20 61 6c ength string, al
e060: 6c 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 l attached datab
e070: 61 73 65 73 20 61 72 65 20 0a 2a 2a 20 63 68 65 ases are .** che
e080: 63 6b 70 6f 69 6e 74 65 64 2e 0a 2a 2f 0a 69 6e ckpointed..*/.in
e090: 74 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 t sqlite3_wal_ch
e0a0: 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 eckpoint(sqlite3
e0b0: 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 *db, const char
e0c0: 20 2a 7a 44 62 29 7b 0a 20 20 72 65 74 75 72 6e *zDb){. return
e0d0: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 sqlite3_wal_che
e0e0: 63 6b 70 6f 69 6e 74 5f 76 32 28 64 62 2c 20 7a ckpoint_v2(db, z
e0f0: 44 62 2c 20 53 51 4c 49 54 45 5f 43 48 45 43 4b Db, SQLITE_CHECK
e100: 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 20 30 POINT_PASSIVE, 0
e110: 2c 20 30 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 , 0);.}..#ifndef
e120: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
e130: 0a 2f 2a 0a 2a 2a 20 52 75 6e 20 61 20 63 68 65 ./*.** Run a che
e140: 63 6b 70 6f 69 6e 74 20 6f 6e 20 64 61 74 61 62 ckpoint on datab
e150: 61 73 65 20 69 44 62 2e 20 54 68 69 73 20 69 73 ase iDb. This is
e160: 20 61 20 6e 6f 2d 6f 70 20 69 66 20 64 61 74 61 a no-op if data
e170: 62 61 73 65 20 69 44 62 20 69 73 0a 2a 2a 20 6e base iDb is.** n
e180: 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 70 65 ot currently ope
e190: 6e 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 0a 2a n in WAL mode..*
e1a0: 2a 0a 2a 2a 20 49 66 20 61 20 74 72 61 6e 73 61 *.** If a transa
e1b0: 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 6f 6e ction is open on
e1c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 the database be
e1d0: 69 6e 67 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 ing checkpointed
e1e0: 2c 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 74 , this .** funct
e1f0: 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 ion returns SQLI
e200: 54 45 5f 4c 4f 43 4b 45 44 20 61 6e 64 20 61 20 TE_LOCKED and a
e210: 63 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 6e 6f checkpoint is no
e220: 74 20 61 74 74 65 6d 70 74 65 64 2e 20 49 66 20 t attempted. If
e230: 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 .** an error occ
e240: 75 72 73 20 77 68 69 6c 65 20 72 75 6e 6e 69 6e urs while runnin
e250: 67 20 74 68 65 20 63 68 65 63 6b 70 6f 69 6e 74 g the checkpoint
e260: 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f , an SQLite erro
e270: 72 20 63 6f 64 65 20 69 73 20 0a 2a 2a 20 72 65 r code is .** re
e280: 74 75 72 6e 65 64 20 28 69 2e 65 2e 20 53 51 4c turned (i.e. SQL
e290: 49 54 45 5f 49 4f 45 52 52 29 2e 20 4f 74 68 65 ITE_IOERR). Othe
e2a0: 72 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f 4b rwise, SQLITE_OK
e2b0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 65 ..**.** The mute
e2c0: 78 20 6f 6e 20 64 61 74 61 62 61 73 65 20 68 61 x on database ha
e2d0: 6e 64 6c 65 20 64 62 20 73 68 6f 75 6c 64 20 62 ndle db should b
e2e0: 65 20 68 65 6c 64 20 62 79 20 74 68 65 20 63 61 e held by the ca
e2f0: 6c 6c 65 72 2e 20 54 68 65 20 6d 75 74 65 78 0a ller. The mutex.
e300: 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 ** associated wi
e310: 74 68 20 74 68 65 20 73 70 65 63 69 66 69 63 20 th the specific
e320: 62 2d 74 72 65 65 20 62 65 69 6e 67 20 63 68 65 b-tree being che
e330: 63 6b 70 6f 69 6e 74 65 64 20 69 73 20 74 61 6b ckpointed is tak
e340: 65 6e 20 62 79 0a 2a 2a 20 74 68 69 73 20 66 75 en by.** this fu
e350: 6e 63 74 69 6f 6e 20 77 68 69 6c 65 20 74 68 65 nction while the
e360: 20 63 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 72 checkpoint is r
e370: 75 6e 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 unning..**.** If
e380: 20 69 44 62 20 69 73 20 70 61 73 73 65 64 20 53 iDb is passed S
e390: 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 QLITE_MAX_ATTACH
e3a0: 45 44 2c 20 74 68 65 6e 20 61 6c 6c 20 61 74 74 ED, then all att
e3b0: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73 20 ached databases
e3c0: 61 72 65 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 6e are.** checkpoin
e3d0: 74 65 64 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 ted. If an error
e3e0: 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 is encountered
e3f0: 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 it is returned i
e400: 6d 6d 65 64 69 61 74 65 6c 79 20 2d 0a 2a 2a 20 mmediately -.**
e410: 6e 6f 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 no attempt is ma
e420: 64 65 20 74 6f 20 63 68 65 63 6b 70 6f 69 6e 74 de to checkpoint
e430: 20 61 6e 79 20 72 65 6d 61 69 6e 69 6e 67 20 64 any remaining d
e440: 61 74 61 62 61 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 atabases..**.**
e450: 50 61 72 61 6d 65 74 65 72 20 65 4d 6f 64 65 20 Parameter eMode
e460: 69 73 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 is one of SQLITE
e470: 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 _CHECKPOINT_PASS
e480: 49 56 45 2c 20 46 55 4c 4c 20 6f 72 20 52 45 53 IVE, FULL or RES
e490: 54 41 52 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c TART..*/.int sql
e4a0: 69 74 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 73 ite3Checkpoint(s
e4b0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
e4c0: 69 44 62 2c 20 69 6e 74 20 65 4d 6f 64 65 2c 20 iDb, int eMode,
e4d0: 69 6e 74 20 2a 70 6e 4c 6f 67 2c 20 69 6e 74 20 int *pnLog, int
e4e0: 2a 70 6e 43 6b 70 74 29 7b 0a 20 20 69 6e 74 20 *pnCkpt){. int
e4f0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 rc = SQLITE_OK;
e500: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
e510: 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
e520: 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 int i;
e530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e540: 2f 2a 20 55 73 65 64 20 74 6f 20 69 74 65 72 61 /* Used to itera
e550: 74 65 20 74 68 72 6f 75 67 68 20 61 74 74 61 63 te through attac
e560: 68 65 64 20 64 62 73 20 2a 2f 0a 20 20 69 6e 74 hed dbs */. int
e570: 20 62 42 75 73 79 20 3d 20 30 3b 20 20 20 20 20 bBusy = 0;
e580: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
e590: 54 72 75 65 20 69 66 20 53 51 4c 49 54 45 5f 42 True if SQLITE_B
e5a0: 55 53 59 20 68 61 73 20 62 65 65 6e 20 65 6e 63 USY has been enc
e5b0: 6f 75 6e 74 65 72 65 64 20 2a 2f 0a 0a 20 20 61 ountered */.. a
e5c0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
e5d0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
e5e0: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
e5f0: 28 20 21 70 6e 4c 6f 67 20 7c 7c 20 2a 70 6e 4c ( !pnLog || *pnL
e600: 6f 67 3d 3d 2d 31 20 29 3b 0a 20 20 61 73 73 65 og==-1 );. asse
e610: 72 74 28 20 21 70 6e 43 6b 70 74 20 7c 7c 20 2a rt( !pnCkpt || *
e620: 70 6e 43 6b 70 74 3d 3d 2d 31 20 29 3b 0a 0a 20 pnCkpt==-1 );..
e630: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e for(i=0; i<db->
e640: 6e 44 62 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 nDb && rc==SQLIT
e650: 45 5f 4f 4b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 E_OK; i++){.
e660: 69 66 28 20 69 3d 3d 69 44 62 20 7c 7c 20 69 44 if( i==iDb || iD
e670: 62 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 b==SQLITE_MAX_AT
e680: 54 41 43 48 45 44 20 29 7b 0a 20 20 20 20 20 20 TACHED ){.
e690: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
e6a0: 65 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2d 3e eCheckpoint(db->
e6b0: 61 44 62 5b 69 5d 2e 70 42 74 2c 20 65 4d 6f 64 aDb[i].pBt, eMod
e6c0: 65 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 6b 70 74 e, pnLog, pnCkpt
e6d0: 29 3b 0a 20 20 20 20 20 20 70 6e 4c 6f 67 20 3d );. pnLog =
e6e0: 20 30 3b 0a 20 20 20 20 20 20 70 6e 43 6b 70 74 0;. pnCkpt
e6f0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 = 0;. if(
e700: 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 rc==SQLITE_BUSY
e710: 29 7b 0a 20 20 20 20 20 20 20 20 62 42 75 73 79 ){. bBusy
e720: 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 63 = 1;. rc
e730: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
e740: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
e750: 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d 53 . return (rc==S
e760: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 42 75 73 QLITE_OK && bBus
e770: 79 29 20 3f 20 53 51 4c 49 54 45 5f 42 55 53 59 y) ? SQLITE_BUSY
e780: 20 3a 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 : rc;.}.#endif
e790: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 /* SQLITE_OMIT_W
e7a0: 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 AL */../*.** Thi
e7b0: 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
e7c0: 6e 73 20 74 72 75 65 20 69 66 20 6d 61 69 6e 2d ns true if main-
e7d0: 6d 65 6d 6f 72 79 20 73 68 6f 75 6c 64 20 62 65 memory should be
e7e0: 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 used instead of
e7f0: 0a 2a 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 20 .** a temporary
e800: 66 69 6c 65 20 66 6f 72 20 74 72 61 6e 73 69 65 file for transie
e810: 6e 74 20 70 61 67 65 72 20 66 69 6c 65 73 20 61 nt pager files a
e820: 6e 64 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 nd statement jou
e830: 72 6e 61 6c 73 2e 0a 2a 2a 20 54 68 65 20 76 61 rnals..** The va
e840: 6c 75 65 20 72 65 74 75 72 6e 65 64 20 64 65 70 lue returned dep
e850: 65 6e 64 73 20 6f 6e 20 74 68 65 20 76 61 6c 75 ends on the valu
e860: 65 20 6f 66 20 64 62 2d 3e 74 65 6d 70 5f 73 74 e of db->temp_st
e870: 6f 72 65 20 28 72 75 6e 74 69 6d 65 0a 2a 2a 20 ore (runtime.**
e880: 70 61 72 61 6d 65 74 65 72 29 20 61 6e 64 20 74 parameter) and t
e890: 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 20 he compile time
e8a0: 76 61 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 5f value of SQLITE_
e8b0: 54 45 4d 50 5f 53 54 4f 52 45 2e 20 54 68 65 0a TEMP_STORE. The.
e8c0: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 ** following tab
e8d0: 6c 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 le describes the
e8e0: 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 20 62 65 relationship be
e8f0: 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f 20 tween these two
e900: 76 61 6c 75 65 73 0a 2a 2a 20 61 6e 64 20 74 68 values.** and th
e910: 69 73 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 is functions ret
e920: 75 72 6e 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a urn value..**.**
e930: 20 20 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 SQLITE_TEMP_S
e940: 54 4f 52 45 20 20 20 20 20 64 62 2d 3e 74 65 6d TORE db->tem
e950: 70 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 61 p_store Loca
e960: 74 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 72 tion of temporar
e970: 79 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 y database.**
e980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
e990: 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - ----------
e9a0: 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d ---- -------
e9b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
e9c0: 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 -------.** 0
e9d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e9e0: 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 any
e9f0: 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 file
ea00: 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 (return 0).**
ea10: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
ea20: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 1
ea30: 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 file
ea40: 20 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a (return 0).**
ea50: 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 1
ea60: 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 2
ea70: 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f memo
ea80: 72 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 ry (return 1)
ea90: 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 .** 1
eaa0: 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 0
eab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 f
eac0: 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 6e ile (return
ead0: 20 30 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 0).** 2
eae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 1
eaf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb00: 20 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 file (ret
eb10: 75 72 6e 20 30 29 0a 2a 2a 20 20 20 32 20 20 20 urn 0).** 2
eb20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb30: 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 2
eb40: 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 memory (
eb50: 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 32 return 1).** 2
eb60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb70: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 0
eb80: 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 memory
eb90: 20 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 (return 1).**
eba0: 20 20 33 20 20 20 20 20 20 20 20 20 20 20 20 20 3
ebb0: 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 any
ebc0: 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 memor
ebd0: 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a y (return 1).
ebe0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 65 */.int sqlite3Te
ebf0: 6d 70 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 74 mpInMemory(const
ec00: 20 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 sqlite3 *db){.#
ec10: 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 if SQLITE_TEMP_S
ec20: 54 4f 52 45 3d 3d 31 0a 20 20 72 65 74 75 72 6e TORE==1. return
ec30: 20 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 ( db->temp_stor
ec40: 65 3d 3d 32 20 29 3b 0a 23 65 6e 64 69 66 0a 23 e==2 );.#endif.#
ec50: 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 if SQLITE_TEMP_S
ec60: 54 4f 52 45 3d 3d 32 0a 20 20 72 65 74 75 72 6e TORE==2. return
ec70: 20 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 ( db->temp_stor
ec80: 65 21 3d 31 20 29 3b 0a 23 65 6e 64 69 66 0a 23 e!=1 );.#endif.#
ec90: 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 if SQLITE_TEMP_S
eca0: 54 4f 52 45 3d 3d 33 0a 20 20 72 65 74 75 72 6e TORE==3. return
ecb0: 20 31 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 1;.#endif.#if S
ecc0: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
ecd0: 3c 31 20 7c 7c 20 53 51 4c 49 54 45 5f 54 45 4d <1 || SQLITE_TEM
ece0: 50 5f 53 54 4f 52 45 3e 33 0a 20 20 72 65 74 75 P_STORE>3. retu
ecf0: 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a rn 0;.#endif.}..
ed00: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 /*.** Return UTF
ed10: 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 -8 encoded Engli
ed20: 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c sh language expl
ed30: 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d anation of the m
ed40: 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 ost recent.** er
ed50: 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 ror..*/.const ch
ed60: 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d ar *sqlite3_errm
ed70: 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b sg(sqlite3 *db){
ed80: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
ed90: 3b 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 ;. if( !db ){.
eda0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
edb0: 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 3ErrStr(SQLITE_N
edc0: 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 OMEM);. }. if(
edd0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
ede0: 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
edf0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 ){. return s
ee00: 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 4c qlite3ErrStr(SQL
ee10: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 29 ITE_MISUSE_BKPT)
ee20: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
ee30: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
ee40: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 64 62 mutex);. if( db
ee50: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
ee60: 7b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 {. z = sqlite
ee70: 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 3ErrStr(SQLITE_N
ee80: 4f 4d 45 4d 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a OMEM);. }else{.
ee90: 20 20 20 20 7a 20 3d 20 28 63 68 61 72 2a 29 73 z = (char*)s
eea0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 qlite3_value_tex
eeb0: 74 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 t(db->pErr);.
eec0: 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 assert( !db->ma
eed0: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 llocFailed );.
eee0: 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 20 if( z==0 ){.
eef0: 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 45 z = sqlite3E
ef00: 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 6f 64 rrStr(db->errCod
ef10: 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 e);. }. }.
ef20: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
ef30: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
ef40: 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 return z;.}..#
ef50: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
ef60: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 IT_UTF16./*.** R
ef70: 65 74 75 72 6e 20 55 54 46 2d 31 36 20 65 6e 63 eturn UTF-16 enc
ef80: 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e oded English lan
ef90: 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f guage explanatio
efa0: 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 n of the most re
efb0: 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a cent.** error..*
efc0: 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 /.const void *sq
efd0: 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 73 lite3_errmsg16(s
efe0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 73 qlite3 *db){. s
eff0: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 31 36 20 tatic const u16
f000: 6f 75 74 4f 66 4d 65 6d 5b 5d 20 3d 20 7b 0a 20 outOfMem[] = {.
f010: 20 20 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 27 'o', 'u', 't'
f020: 2c 20 27 20 27 2c 20 27 6f 27 2c 20 27 66 27 2c , ' ', 'o', 'f',
f030: 20 27 20 27 2c 20 27 6d 27 2c 20 27 65 27 2c 20 ' ', 'm', 'e',
f040: 27 6d 27 2c 20 27 6f 27 2c 20 27 72 27 2c 20 27 'm', 'o', 'r', '
f050: 79 27 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 y', 0. };. sta
f060: 74 69 63 20 63 6f 6e 73 74 20 75 31 36 20 6d 69 tic const u16 mi
f070: 73 75 73 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 suse[] = {. '
f080: 6c 27 2c 20 27 69 27 2c 20 27 62 27 2c 20 27 72 l', 'i', 'b', 'r
f090: 27 2c 20 27 61 27 2c 20 27 72 27 2c 20 27 79 27 ', 'a', 'r', 'y'
f0a0: 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 72 27 2c , ' ', . 'r',
f0b0: 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 'o', 'u', 't',
f0c0: 27 69 27 2c 20 27 6e 27 2c 20 27 65 27 2c 20 27 'i', 'n', 'e', '
f0d0: 20 27 2c 20 0a 20 20 20 20 27 63 27 2c 20 27 61 ', . 'c', 'a
f0e0: 27 2c 20 27 6c 27 2c 20 27 6c 27 2c 20 27 65 27 ', 'l', 'l', 'e'
f0f0: 2c 20 27 64 27 2c 20 27 20 27 2c 20 0a 20 20 20 , 'd', ' ', .
f100: 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 'o', 'u', 't',
f110: 27 20 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 27 ' ', . 'o', '
f120: 66 27 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 73 f', ' ', . 's
f130: 27 2c 20 27 65 27 2c 20 27 71 27 2c 20 27 75 27 ', 'e', 'q', 'u'
f140: 2c 20 27 65 27 2c 20 27 6e 27 2c 20 27 63 27 2c , 'e', 'n', 'c',
f150: 20 27 65 27 2c 20 30 0a 20 20 7d 3b 0a 0a 20 20 'e', 0. };..
f160: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 3b 0a 20 const void *z;.
f170: 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 if( !db ){.
f180: 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a 29 6f return (void *)o
f190: 75 74 4f 66 4d 65 6d 3b 0a 20 20 7d 0a 20 20 69 utOfMem;. }. i
f1a0: 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
f1b0: 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 yCheckSickOrOk(d
f1c0: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
f1d0: 20 28 76 6f 69 64 20 2a 29 6d 69 73 75 73 65 3b (void *)misuse;
f1e0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
f1f0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
f200: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 64 62 2d utex);. if( db-
f210: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b >mallocFailed ){
f220: 0a 20 20 20 20 7a 20 3d 20 28 76 6f 69 64 20 2a . z = (void *
f230: 29 6f 75 74 4f 66 4d 65 6d 3b 0a 20 20 7d 65 6c )outOfMem;. }el
f240: 73 65 7b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 se{. z = sqli
f250: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 te3_value_text16
f260: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 (db->pErr);.
f270: 69 66 28 20 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 if( z==0 ){.
f280: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 sqlite3ValueSe
f290: 74 53 74 72 28 64 62 2d 3e 70 45 72 72 2c 20 2d tStr(db->pErr, -
f2a0: 31 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 1, sqlite3ErrStr
f2b0: 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 2c 0a 20 (db->errCode),.
f2c0: 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
f2d0: 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 _UTF8, SQLITE_ST
f2e0: 41 54 49 43 29 3b 0a 20 20 20 20 20 20 7a 20 3d ATIC);. z =
f2f0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
f300: 65 78 74 31 36 28 64 62 2d 3e 70 45 72 72 29 3b ext16(db->pErr);
f310: 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 41 20 . }. /* A
f320: 6d 61 6c 6c 6f 63 28 29 20 6d 61 79 20 68 61 76 malloc() may hav
f330: 65 20 66 61 69 6c 65 64 20 77 69 74 68 69 6e 20 e failed within
f340: 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 the call to sqli
f350: 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 te3_value_text16
f360: 28 29 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 2e (). ** above.
f370: 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
f380: 63 61 73 65 2c 20 74 68 65 6e 20 74 68 65 20 64 case, then the d
f390: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
f3a0: 66 6c 61 67 20 6e 65 65 64 73 20 74 6f 0a 20 20 flag needs to.
f3b0: 20 20 2a 2a 20 62 65 20 63 6c 65 61 72 65 64 20 ** be cleared
f3c0: 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
f3d0: 2e 20 44 6f 20 74 68 69 73 20 64 69 72 65 63 74 . Do this direct
f3e0: 6c 79 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 76 ly, instead of v
f3f0: 69 61 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 ia. ** sqlite
f400: 33 41 70 69 45 78 69 74 28 29 2c 20 74 6f 20 61 3ApiExit(), to a
f410: 76 6f 69 64 20 73 65 74 74 69 6e 67 20 74 68 65 void setting the
f420: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
f430: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 0a error message..
f440: 20 20 20 20 2a 2f 0a 20 20 20 20 64 62 2d 3e 6d */. db->m
f450: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 30 3b allocFailed = 0;
f460: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
f470: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
f480: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
f490: 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 z;.}.#endif /* S
f4a0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
f4b0: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 */../*.** Retur
f4c0: 6e 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e n the most recen
f4d0: 74 20 65 72 72 6f 72 20 63 6f 64 65 20 67 65 6e t error code gen
f4e0: 65 72 61 74 65 64 20 62 79 20 61 6e 20 53 51 4c erated by an SQL
f4f0: 69 74 65 20 72 6f 75 74 69 6e 65 2e 20 49 66 20 ite routine. If
f500: 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 61 73 73 65 NULL is.** passe
f510: 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 d to this functi
f520: 6f 6e 2c 20 77 65 20 61 73 73 75 6d 65 20 61 20 on, we assume a
f530: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 malloc() failed
f540: 64 75 72 69 6e 67 20 73 71 6c 69 74 65 33 5f 6f during sqlite3_o
f550: 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 pen()..*/.int sq
f560: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 73 71 lite3_errcode(sq
f570: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 lite3 *db){. if
f580: 28 20 64 62 20 26 26 20 21 73 71 6c 69 74 65 33 ( db && !sqlite3
f590: 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f SafetyCheckSickO
f5a0: 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 rOk(db) ){. r
f5b0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
f5c0: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 USE_BKPT;. }.
f5d0: 69 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e 6d if( !db || db->m
f5e0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
f5f0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
f600: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 65 _NOMEM;. }. re
f610: 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 turn db->errCode
f620: 20 26 20 64 62 2d 3e 65 72 72 4d 61 73 6b 3b 0a & db->errMask;.
f630: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 }.int sqlite3_ex
f640: 74 65 6e 64 65 64 5f 65 72 72 63 6f 64 65 28 73 tended_errcode(s
f650: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 qlite3 *db){. i
f660: 66 28 20 64 62 20 26 26 20 21 73 71 6c 69 74 65 f( db && !sqlite
f670: 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 3SafetyCheckSick
f680: 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 OrOk(db) ){.
f690: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
f6a0: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 SUSE_BKPT;. }.
f6b0: 20 69 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e if( !db || db->
f6c0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
f6d0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
f6e0: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 E_NOMEM;. }. r
f6f0: 65 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 eturn db->errCod
f700: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 e;.}../*.** Retu
f710: 72 6e 20 61 20 73 74 72 69 6e 67 20 74 68 61 74 rn a string that
f720: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6b describes the k
f730: 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 ind of error spe
f740: 63 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a cified in the.**
f750: 20 61 72 67 75 6d 65 6e 74 2e 20 20 46 6f 72 20 argument. For
f760: 6e 6f 77 2c 20 74 68 69 73 20 73 69 6d 70 6c 79 now, this simply
f770: 20 63 61 6c 6c 73 20 74 68 65 20 69 6e 74 65 72 calls the inter
f780: 6e 61 6c 20 73 71 6c 69 74 65 33 45 72 72 53 74 nal sqlite3ErrSt
f790: 72 28 29 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e r().** function.
f7a0: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
f7b0: 73 71 6c 69 74 65 33 5f 65 72 72 73 74 72 28 69 sqlite3_errstr(i
f7c0: 6e 74 20 72 63 29 7b 0a 20 20 72 65 74 75 72 6e nt rc){. return
f7d0: 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 72 sqlite3ErrStr(r
f7e0: 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 c);.}../*.** Cre
f7f0: 61 74 65 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 ate a new collat
f800: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 ing function for
f810: 20 64 61 74 61 62 61 73 65 20 22 64 62 22 2e 20 database "db".
f820: 20 54 68 65 20 6e 61 6d 65 20 69 73 20 7a 4e 61 The name is zNa
f830: 6d 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 65 6e me.** and the en
f840: 63 6f 64 69 6e 67 20 69 73 20 65 6e 63 2e 0a 2a coding is enc..*
f850: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 72 65 /.static int cre
f860: 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 ateCollation(.
f870: 73 71 6c 69 74 65 33 2a 20 64 62 2c 0a 20 20 63 sqlite3* db,. c
f880: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 onst char *zName
f890: 2c 20 0a 20 20 75 38 20 65 6e 63 2c 0a 20 20 76 , . u8 enc,. v
f8a0: 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 oid* pCtx,. int
f8b0: 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 (*xCompare)(void
f8c0: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
f8d0: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
f8e0: 2a 29 2c 0a 20 20 76 6f 69 64 28 2a 78 44 65 6c *),. void(*xDel
f8f0: 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 43 6f )(void*).){. Co
f900: 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20 llSeq *pColl;.
f910: 69 6e 74 20 65 6e 63 32 3b 0a 20 20 69 6e 74 20 int enc2;. int
f920: 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 nName = sqlite3S
f930: 74 72 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 3b 0a trlen30(zName);.
f940: 20 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
f950: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
f960: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 db->mutex) );..
f970: 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 /* If SQLITE_UT
f980: 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64 F16 is specified
f990: 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 as the encoding
f9a0: 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d type, transform
f9b0: 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e this. ** to on
f9c0: 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 e of SQLITE_UTF1
f9d0: 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 6LE or SQLITE_UT
f9e0: 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a F16BE using the.
f9f0: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 ** SQLITE_UTF1
fa00: 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 6NATIVE macro. S
fa10: 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e QLITE_UTF16 is n
fa20: 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c ot used internal
fa30: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e 63 32 20 ly.. */. enc2
fa40: 3d 20 65 6e 63 3b 0a 20 20 74 65 73 74 63 61 73 = enc;. testcas
fa50: 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f e( enc2==SQLITE_
fa60: 55 54 46 31 36 20 29 3b 0a 20 20 74 65 73 74 63 UTF16 );. testc
fa70: 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 ase( enc2==SQLIT
fa80: 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 E_UTF16_ALIGNED
fa90: 29 3b 0a 20 20 69 66 28 20 65 6e 63 32 3d 3d 53 );. if( enc2==S
faa0: 51 4c 49 54 45 5f 55 54 46 31 36 20 7c 7c 20 65 QLITE_UTF16 || e
fab0: 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 nc2==SQLITE_UTF1
fac0: 36 5f 41 4c 49 47 4e 45 44 20 29 7b 0a 20 20 20 6_ALIGNED ){.
fad0: 20 65 6e 63 32 20 3d 20 53 51 4c 49 54 45 5f 55 enc2 = SQLITE_U
fae0: 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 0a TF16NATIVE;. }.
faf0: 20 20 69 66 28 20 65 6e 63 32 3c 53 51 4c 49 54 if( enc2<SQLIT
fb00: 45 5f 55 54 46 38 20 7c 7c 20 65 6e 63 32 3e 53 E_UTF8 || enc2>S
fb10: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b QLITE_UTF16BE ){
fb20: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
fb30: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
fb40: 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 }.. /* Check
fb50: 69 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 if this call is
fb60: 72 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 70 6c removing or repl
fb70: 61 63 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e acing an existin
fb80: 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 20 2a g collation . *
fb90: 2a 20 73 65 71 75 65 6e 63 65 2e 20 49 66 20 73 * sequence. If s
fba0: 6f 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 o, and there are
fbb0: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 72 65 74 active VMs, ret
fbc0: 75 72 6e 20 62 75 73 79 2e 20 49 66 20 74 68 65 urn busy. If the
fbd0: 72 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f 20 61 re. ** are no a
fbe0: 63 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 61 6c ctive VMs, inval
fbf0: 69 64 61 74 65 20 61 6e 79 20 70 72 65 2d 63 6f idate any pre-co
fc00: 6d 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e 74 mpiled statement
fc10: 73 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f 6c 6c 20 s.. */. pColl
fc20: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c = sqlite3FindCol
fc30: 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 lSeq(db, (u8)enc
fc40: 32 2c 20 7a 4e 61 6d 65 2c 20 30 29 3b 0a 20 20 2, zName, 0);.
fc50: 69 66 28 20 70 43 6f 6c 6c 20 26 26 20 70 43 6f if( pColl && pCo
fc60: 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a 20 20 20 20 ll->xCmp ){.
fc70: 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 74 if( db->nVdbeAct
fc80: 69 76 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ive ){. sql
fc90: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 ite3Error(db, SQ
fca0: 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 LITE_BUSY, .
fcb0: 20 20 20 20 22 75 6e 61 62 6c 65 20 74 6f 20 64 "unable to d
fcc0: 65 6c 65 74 65 2f 6d 6f 64 69 66 79 20 63 6f 6c elete/modify col
fcd0: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
fce0: 64 75 65 20 74 6f 20 61 63 74 69 76 65 20 73 74 due to active st
fcf0: 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 atements");.
fd00: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
fd10: 42 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 BUSY;. }.
fd20: 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 sqlite3ExpirePre
fd30: 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 paredStatements(
fd40: 64 62 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 db);.. /* If
fd50: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
fd60: 63 65 20 70 43 6f 6c 6c 20 77 61 73 20 63 72 65 ce pColl was cre
fd70: 61 74 65 64 20 64 69 72 65 63 74 6c 79 20 62 79 ated directly by
fd80: 20 61 20 63 61 6c 6c 20 74 6f 0a 20 20 20 20 2a a call to. *
fd90: 2a 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 * sqlite3_create
fda0: 5f 63 6f 6c 6c 61 74 69 6f 6e 2c 20 61 6e 64 20 _collation, and
fdb0: 6e 6f 74 20 67 65 6e 65 72 61 74 65 64 20 62 79 not generated by
fdc0: 20 73 79 6e 74 68 43 6f 6c 6c 53 65 71 28 29 2c synthCollSeq(),
fdd0: 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20 61 6e 79 . ** then any
fde0: 20 63 6f 70 69 65 73 20 6d 61 64 65 20 62 79 20 copies made by
fdf0: 73 79 6e 74 68 43 6f 6c 6c 53 65 71 28 29 20 6e synthCollSeq() n
fe00: 65 65 64 20 74 6f 20 62 65 20 69 6e 76 61 6c 69 eed to be invali
fe10: 64 61 74 65 64 2e 0a 20 20 20 20 2a 2a 20 41 6c dated.. ** Al
fe20: 73 6f 2c 20 63 6f 6c 6c 61 74 69 6f 6e 20 64 65 so, collation de
fe30: 73 74 72 75 63 74 6f 72 20 2d 20 43 6f 6c 6c 53 structor - CollS
fe40: 65 71 2e 78 44 65 6c 28 29 20 2d 20 66 75 6e 63 eq.xDel() - func
fe50: 74 69 6f 6e 20 6d 61 79 20 6e 65 65 64 0a 20 20 tion may need.
fe60: 20 20 2a 2a 20 74 6f 20 62 65 20 63 61 6c 6c 65 ** to be calle
fe70: 64 2e 0a 20 20 20 20 2a 2f 20 0a 20 20 20 20 69 d.. */ . i
fe80: 66 28 20 28 70 43 6f 6c 6c 2d 3e 65 6e 63 20 26 f( (pColl->enc &
fe90: 20 7e 53 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 ~SQLITE_UTF16_A
fea0: 4c 49 47 4e 45 44 29 3d 3d 65 6e 63 32 20 29 7b LIGNED)==enc2 ){
feb0: 0a 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a . CollSeq *
fec0: 61 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 48 aColl = sqlite3H
fed0: 61 73 68 46 69 6e 64 28 26 64 62 2d 3e 61 43 6f ashFind(&db->aCo
fee0: 6c 6c 53 65 71 2c 20 7a 4e 61 6d 65 2c 20 6e 4e llSeq, zName, nN
fef0: 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 ame);. int
ff00: 6a 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 j;. for(j=0
ff10: 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 ; j<3; j++){.
ff20: 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 20 CollSeq *p
ff30: 3d 20 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 = &aColl[j];.
ff40: 20 20 20 20 20 69 66 28 20 70 2d 3e 65 6e 63 3d if( p->enc=
ff50: 3d 70 43 6f 6c 6c 2d 3e 65 6e 63 20 29 7b 0a 20 =pColl->enc ){.
ff60: 20 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e if( p->
ff70: 78 44 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 xDel ){.
ff80: 20 20 20 20 70 2d 3e 78 44 65 6c 28 70 2d 3e 70 p->xDel(p->p
ff90: 55 73 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 User);.
ffa0: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e }. p->
ffb0: 78 43 6d 70 20 3d 20 30 3b 0a 20 20 20 20 20 20 xCmp = 0;.
ffc0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
ffd0: 7d 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c 20 3d }. }.. pColl =
ffe0: 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c sqlite3FindColl
fff0: 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 32 Seq(db, (u8)enc2
10000 2c 20 7a 4e 61 6d 65 2c 20 31 29 3b 0a 20 20 69 , zName, 1);. i
10010 66 28 20 70 43 6f 6c 6c 3d 3d 30 20 29 20 72 65 f( pColl==0 ) re
10020 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
10030 4d 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 M;. pColl->xCmp
10040 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a 20 20 70 = xCompare;. p
10050 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d 20 70 43 Coll->pUser = pC
10060 74 78 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 44 65 tx;. pColl->xDe
10070 6c 20 3d 20 78 44 65 6c 3b 0a 20 20 70 43 6f 6c l = xDel;. pCol
10080 6c 2d 3e 65 6e 63 20 3d 20 28 75 38 29 28 65 6e l->enc = (u8)(en
10090 63 32 20 7c 20 28 65 6e 63 20 26 20 53 51 4c 49 c2 | (enc & SQLI
100a0 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 TE_UTF16_ALIGNED
100b0 29 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72 ));. sqlite3Err
100c0 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b or(db, SQLITE_OK
100d0 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 , 0);. return S
100e0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a QLITE_OK;.}.../*
100f0 0a 2a 2a 20 54 68 69 73 20 61 72 72 61 79 20 64 .** This array d
10100 65 66 69 6e 65 73 20 68 61 72 64 20 75 70 70 65 efines hard uppe
10110 72 20 62 6f 75 6e 64 73 20 6f 6e 20 6c 69 6d 69 r bounds on limi
10120 74 20 76 61 6c 75 65 73 2e 20 20 54 68 65 0a 2a t values. The.*
10130 2a 20 69 6e 69 74 69 61 6c 69 7a 65 72 20 6d 75 * initializer mu
10140 73 74 20 62 65 20 6b 65 70 74 20 69 6e 20 73 79 st be kept in sy
10150 6e 63 20 77 69 74 68 20 74 68 65 20 53 51 4c 49 nc with the SQLI
10160 54 45 5f 4c 49 4d 49 54 5f 2a 0a 2a 2a 20 23 64 TE_LIMIT_*.** #d
10170 65 66 69 6e 65 73 20 69 6e 20 73 71 6c 69 74 65 efines in sqlite
10180 33 2e 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 3.h..*/.static c
10190 6f 6e 73 74 20 69 6e 74 20 61 48 61 72 64 4c 69 onst int aHardLi
101a0 6d 69 74 5b 5d 20 3d 20 7b 0a 20 20 53 51 4c 49 mit[] = {. SQLI
101b0 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 2c 0a 20 TE_MAX_LENGTH,.
101c0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f SQLITE_MAX_SQL_
101d0 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 LENGTH,. SQLITE
101e0 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 2c 0a 20 20 53 _MAX_COLUMN,. S
101f0 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 QLITE_MAX_EXPR_D
10200 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d EPTH,. SQLITE_M
10210 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 AX_COMPOUND_SELE
10220 43 54 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 CT,. SQLITE_MAX
10230 5f 56 44 42 45 5f 4f 50 2c 0a 20 20 53 51 4c 49 _VDBE_OP,. SQLI
10240 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f TE_MAX_FUNCTION_
10250 41 52 47 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 ARG,. SQLITE_MA
10260 58 5f 41 54 54 41 43 48 45 44 2c 0a 20 20 53 51 X_ATTACHED,. SQ
10270 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 LITE_MAX_LIKE_PA
10280 54 54 45 52 4e 5f 4c 45 4e 47 54 48 2c 0a 20 20 TTERN_LENGTH,.
10290 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
102a0 42 4c 45 5f 4e 55 4d 42 45 52 2c 0a 20 20 53 51 BLE_NUMBER,. SQ
102b0 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 LITE_MAX_TRIGGER
102c0 5f 44 45 50 54 48 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a _DEPTH,.};../*.*
102d0 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 * Make sure the
102e0 68 61 72 64 20 6c 69 6d 69 74 73 20 61 72 65 20 hard limits are
102f0 73 65 74 20 74 6f 20 72 65 61 73 6f 6e 61 62 6c set to reasonabl
10300 65 20 76 61 6c 75 65 73 0a 2a 2f 0a 23 69 66 20 e values.*/.#if
10310 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 SQLITE_MAX_LENGT
10320 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 51 H<100.# error SQ
10330 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 20 LITE_MAX_LENGTH
10340 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 must be at least
10350 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 100.#endif.#if
10360 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c SQLITE_MAX_SQL_L
10370 45 4e 47 54 48 3c 31 30 30 0a 23 20 65 72 72 6f ENGTH<100.# erro
10380 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c r SQLITE_MAX_SQL
10390 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 _LENGTH must be
103a0 61 74 20 6c 65 61 73 74 20 31 30 30 0a 23 65 6e at least 100.#en
103b0 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d dif.#if SQLITE_M
103c0 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 3e 53 51 AX_SQL_LENGTH>SQ
103d0 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 0a LITE_MAX_LENGTH.
103e0 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d # error SQLITE_M
103f0 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 6d 75 AX_SQL_LENGTH mu
10400 73 74 20 6e 6f 74 20 62 65 20 67 72 65 61 74 65 st not be greate
10410 72 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4d 41 r than SQLITE_MA
10420 58 5f 4c 45 4e 47 54 48 0a 23 65 6e 64 69 66 0a X_LENGTH.#endif.
10430 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 #if SQLITE_MAX_C
10440 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 3c 32 OMPOUND_SELECT<2
10450 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
10460 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c MAX_COMPOUND_SEL
10470 45 43 54 20 6d 75 73 74 20 62 65 20 61 74 20 6c ECT must be at l
10480 65 61 73 74 20 32 0a 23 65 6e 64 69 66 0a 23 69 east 2.#endif.#i
10490 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 f SQLITE_MAX_VDB
104a0 45 5f 4f 50 3c 34 30 0a 23 20 65 72 72 6f 72 20 E_OP<40.# error
104b0 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f SQLITE_MAX_VDBE_
104c0 4f 50 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 OP must be at le
104d0 61 73 74 20 34 30 0a 23 65 6e 64 69 66 0a 23 69 ast 40.#endif.#i
104e0 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e f SQLITE_MAX_FUN
104f0 43 54 49 4f 4e 5f 41 52 47 3c 30 20 7c 7c 20 53 CTION_ARG<0 || S
10500 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 QLITE_MAX_FUNCTI
10510 4f 4e 5f 41 52 47 3e 31 30 30 30 0a 23 20 65 72 ON_ARG>1000.# er
10520 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 ror SQLITE_MAX_F
10530 55 4e 43 54 49 4f 4e 5f 41 52 47 20 6d 75 73 74 UNCTION_ARG must
10540 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e be between 0 an
10550 64 20 31 30 30 30 0a 23 65 6e 64 69 66 0a 23 69 d 1000.#endif.#i
10560 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 f SQLITE_MAX_ATT
10570 41 43 48 45 44 3c 30 20 7c 7c 20 53 51 4c 49 54 ACHED<0 || SQLIT
10580 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 36 E_MAX_ATTACHED>6
10590 32 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 2.# error SQLITE
105a0 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 6d 75 _MAX_ATTACHED mu
105b0 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 st be between 0
105c0 61 6e 64 20 36 32 0a 23 65 6e 64 69 66 0a 23 69 and 62.#endif.#i
105d0 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b f SQLITE_MAX_LIK
105e0 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 E_PATTERN_LENGTH
105f0 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 <1.# error SQLIT
10600 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 E_MAX_LIKE_PATTE
10610 52 4e 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 RN_LENGTH must b
10620 65 20 61 74 20 6c 65 61 73 74 20 31 0a 23 65 6e e at least 1.#en
10630 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d dif.#if SQLITE_M
10640 41 58 5f 43 4f 4c 55 4d 4e 3e 33 32 37 36 37 0a AX_COLUMN>32767.
10650 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d # error SQLITE_M
10660 41 58 5f 43 4f 4c 55 4d 4e 20 6d 75 73 74 20 6e AX_COLUMN must n
10670 6f 74 20 65 78 63 65 65 64 20 33 32 37 36 37 0a ot exceed 32767.
10680 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
10690 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 E_MAX_TRIGGER_DE
106a0 50 54 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 PTH<1.# error SQ
106b0 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 LITE_MAX_TRIGGER
106c0 5f 44 45 50 54 48 20 6d 75 73 74 20 62 65 20 61 _DEPTH must be a
106d0 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 66 t least 1.#endif
106e0 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 .../*.** Change
106f0 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 6c the value of a l
10700 69 6d 69 74 2e 20 20 52 65 70 6f 72 74 20 74 68 imit. Report th
10710 65 20 6f 6c 64 20 76 61 6c 75 65 2e 0a 2a 2a 20 e old value..**
10720 49 66 20 61 6e 20 69 6e 76 61 6c 69 64 20 6c 69 If an invalid li
10730 6d 69 74 20 69 6e 64 65 78 20 69 73 20 73 75 70 mit index is sup
10740 70 6c 69 65 64 2c 20 72 65 70 6f 72 74 20 2d 31 plied, report -1
10750 2e 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 ..** Make no cha
10760 6e 67 65 73 20 62 75 74 20 73 74 69 6c 6c 20 72 nges but still r
10770 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 76 61 eport the old va
10780 6c 75 65 20 69 66 20 74 68 65 0a 2a 2a 20 6e 65 lue if the.** ne
10790 77 20 6c 69 6d 69 74 20 69 73 20 6e 65 67 61 74 w limit is negat
107a0 69 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 77 ive..**.** A new
107b0 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 64 6f 65 lower limit doe
107c0 73 20 6e 6f 74 20 73 68 72 69 6e 6b 20 65 78 69 s not shrink exi
107d0 73 74 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 73 sting constructs
107e0 2e 0a 2a 2a 20 49 74 20 6d 65 72 65 6c 79 20 70 ..** It merely p
107f0 72 65 76 65 6e 74 73 20 6e 65 77 20 63 6f 6e 73 revents new cons
10800 74 72 75 63 74 73 20 74 68 61 74 20 65 78 63 65 tructs that exce
10810 65 64 20 74 68 65 20 6c 69 6d 69 74 0a 2a 2a 20 ed the limit.**
10820 66 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e 0a 2a 2f from forming..*/
10830 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 69 6d .int sqlite3_lim
10840 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 it(sqlite3 *db,
10850 69 6e 74 20 6c 69 6d 69 74 49 64 2c 20 69 6e 74 int limitId, int
10860 20 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 20 69 6e newLimit){. in
10870 74 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a 0a 20 20 t oldLimit;...
10880 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
10890 52 2d 33 30 31 38 39 2d 35 34 30 39 37 20 46 6f R-30189-54097 Fo
108a0 72 20 65 61 63 68 20 6c 69 6d 69 74 20 63 61 74 r each limit cat
108b0 65 67 6f 72 79 20 53 51 4c 49 54 45 5f 4c 49 4d egory SQLITE_LIM
108c0 49 54 5f 4e 41 4d 45 0a 20 20 2a 2a 20 74 68 65 IT_NAME. ** the
108d0 72 65 20 69 73 20 61 20 68 61 72 64 20 75 70 70 re is a hard upp
108e0 65 72 20 62 6f 75 6e 64 20 73 65 74 20 61 74 20 er bound set at
108f0 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 62 79 20 compile-time by
10900 61 20 43 20 70 72 65 70 72 6f 63 65 73 73 6f 72 a C preprocessor
10910 0a 20 20 2a 2a 20 6d 61 63 72 6f 20 63 61 6c 6c . ** macro call
10920 65 64 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4e 41 ed SQLITE_MAX_NA
10930 4d 45 2e 20 28 54 68 65 20 22 5f 4c 49 4d 49 54 ME. (The "_LIMIT
10940 5f 22 20 69 6e 20 74 68 65 20 6e 61 6d 65 20 69 _" in the name i
10950 73 20 63 68 61 6e 67 65 64 20 74 6f 0a 20 20 2a s changed to. *
10960 2a 20 22 5f 4d 41 58 5f 22 2e 29 0a 20 20 2a 2f * "_MAX_".). */
10970 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
10980 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
10990 49 54 5f 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c 49 IT_LENGTH]==SQLI
109a0 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 20 29 3b TE_MAX_LENGTH );
109b0 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
109c0 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
109d0 49 54 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d 3d 3d IT_SQL_LENGTH]==
109e0 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c SQLITE_MAX_SQL_L
109f0 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 65 72 ENGTH );. asser
10a00 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
10a10 4c 49 54 45 5f 4c 49 4d 49 54 5f 43 4f 4c 55 4d LITE_LIMIT_COLUM
10a20 4e 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 43 N]==SQLITE_MAX_C
10a30 4f 4c 55 4d 4e 20 29 3b 0a 20 20 61 73 73 65 72 OLUMN );. asser
10a40 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
10a50 4c 49 54 45 5f 4c 49 4d 49 54 5f 45 58 50 52 5f LITE_LIMIT_EXPR_
10a60 44 45 50 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d DEPTH]==SQLITE_M
10a70 41 58 5f 45 58 50 52 5f 44 45 50 54 48 20 29 3b AX_EXPR_DEPTH );
10a80 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
10a90 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
10aa0 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 IT_COMPOUND_SELE
10ab0 43 54 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f CT]==SQLITE_MAX_
10ac0 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 29 COMPOUND_SELECT)
10ad0 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
10ae0 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
10af0 4d 49 54 5f 56 44 42 45 5f 4f 50 5d 3d 3d 53 51 MIT_VDBE_OP]==SQ
10b00 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 LITE_MAX_VDBE_OP
10b10 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 );. assert( aH
10b20 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f ardLimit[SQLITE_
10b30 4c 49 4d 49 54 5f 46 55 4e 43 54 49 4f 4e 5f 41 LIMIT_FUNCTION_A
10b40 52 47 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f RG]==SQLITE_MAX_
10b50 46 55 4e 43 54 49 4f 4e 5f 41 52 47 20 29 3b 0a FUNCTION_ARG );.
10b60 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 4c assert( aHardL
10b70 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 imit[SQLITE_LIMI
10b80 54 5f 41 54 54 41 43 48 45 44 5d 3d 3d 53 51 4c T_ATTACHED]==SQL
10b90 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
10ba0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 );. assert( aH
10bb0 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f ardLimit[SQLITE_
10bc0 4c 49 4d 49 54 5f 4c 49 4b 45 5f 50 41 54 54 45 LIMIT_LIKE_PATTE
10bd0 52 4e 5f 4c 45 4e 47 54 48 5d 3d 3d 0a 20 20 20 RN_LENGTH]==.
10be0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10bf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10c00 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
10c10 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 TE_MAX_LIKE_PATT
10c20 45 52 4e 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 ERN_LENGTH );.
10c30 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
10c40 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
10c50 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 5d VARIABLE_NUMBER]
10c60 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 ==SQLITE_MAX_VAR
10c70 49 41 42 4c 45 5f 4e 55 4d 42 45 52 29 3b 0a 20 IABLE_NUMBER);.
10c80 20 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 assert( aHardLi
10c90 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 mit[SQLITE_LIMIT
10ca0 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 5d 3d _TRIGGER_DEPTH]=
10cb0 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 =SQLITE_MAX_TRIG
10cc0 47 45 52 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 GER_DEPTH );. a
10cd0 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 4c 49 ssert( SQLITE_LI
10ce0 4d 49 54 5f 54 52 49 47 47 45 52 5f 44 45 50 54 MIT_TRIGGER_DEPT
10cf0 48 3d 3d 28 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d H==(SQLITE_N_LIM
10d00 49 54 2d 31 29 20 29 3b 0a 0a 0a 20 20 69 66 28 IT-1) );... if(
10d10 20 6c 69 6d 69 74 49 64 3c 30 20 7c 7c 20 6c 69 limitId<0 || li
10d20 6d 69 74 49 64 3e 3d 53 51 4c 49 54 45 5f 4e 5f mitId>=SQLITE_N_
10d30 4c 49 4d 49 54 20 29 7b 0a 20 20 20 20 72 65 74 LIMIT ){. ret
10d40 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 6f 6c urn -1;. }. ol
10d50 64 4c 69 6d 69 74 20 3d 20 64 62 2d 3e 61 4c 69 dLimit = db->aLi
10d60 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 3b 0a 20 20 mit[limitId];.
10d70 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 3d 30 20 if( newLimit>=0
10d80 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ){
10d90 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 /* IMP: R-5
10da0 32 34 37 36 2d 32 38 37 33 32 20 2a 2f 0a 20 20 2476-28732 */.
10db0 20 20 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 61 if( newLimit>a
10dc0 48 61 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 HardLimit[limitI
10dd0 64 5d 20 29 7b 0a 20 20 20 20 20 20 6e 65 77 4c d] ){. newL
10de0 69 6d 69 74 20 3d 20 61 48 61 72 64 4c 69 6d 69 imit = aHardLimi
10df0 74 5b 6c 69 6d 69 74 49 64 5d 3b 20 20 2f 2a 20 t[limitId]; /*
10e00 49 4d 50 3a 20 52 2d 35 31 34 36 33 2d 32 35 36 IMP: R-51463-256
10e10 33 34 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 20 20 34 */. }.
10e20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 db->aLimit[limit
10e30 49 64 5d 20 3d 20 6e 65 77 4c 69 6d 69 74 3b 0a Id] = newLimit;.
10e40 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6f 6c 64 }. return old
10e50 4c 69 6d 69 74 3b 20 20 20 20 20 20 20 20 20 20 Limit;
10e60 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4d /* IM
10e70 50 3a 20 52 2d 35 33 33 34 31 2d 33 35 34 31 39 P: R-53341-35419
10e80 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 */.}../*.** Thi
10e90 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 s function is us
10ea0 65 64 20 74 6f 20 70 61 72 73 65 20 62 6f 74 68 ed to parse both
10eb0 20 55 52 49 73 20 61 6e 64 20 6e 6f 6e 2d 55 52 URIs and non-UR
10ec0 49 20 66 69 6c 65 6e 61 6d 65 73 20 70 61 73 73 I filenames pass
10ed0 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 75 73 65 ed by the.** use
10ee0 72 20 74 6f 20 41 50 49 20 66 75 6e 63 74 69 6f r to API functio
10ef0 6e 73 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 ns sqlite3_open(
10f00 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 ) or sqlite3_ope
10f10 6e 5f 76 32 28 29 2c 20 61 6e 64 20 66 6f 72 20 n_v2(), and for
10f20 64 61 74 61 62 61 73 65 0a 2a 2a 20 55 52 49 73 database.** URIs
10f30 20 73 70 65 63 69 66 69 65 64 20 61 73 20 70 61 specified as pa
10f40 72 74 20 6f 66 20 41 54 54 41 43 48 20 73 74 61 rt of ATTACH sta
10f50 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 tements..**.** T
10f60 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
10f70 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 t to this functi
10f80 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f on is the name o
10f90 66 20 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 f the VFS to use
10fa0 20 28 6f 72 0a 2a 2a 20 61 20 4e 55 4c 4c 20 74 (or.** a NULL t
10fb0 6f 20 73 69 67 6e 69 66 79 20 74 68 65 20 64 65 o signify the de
10fc0 66 61 75 6c 74 20 56 46 53 29 20 69 66 20 74 68 fault VFS) if th
10fd0 65 20 55 52 49 20 64 6f 65 73 20 6e 6f 74 20 63 e URI does not c
10fe0 6f 6e 74 61 69 6e 20 61 20 22 76 66 73 3d 78 78 ontain a "vfs=xx
10ff0 78 22 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 61 x".** query para
11000 6d 65 74 65 72 2e 20 54 68 65 20 73 65 63 6f 6e meter. The secon
11010 64 20 61 72 67 75 6d 65 6e 74 20 63 6f 6e 74 61 d argument conta
11020 69 6e 73 20 74 68 65 20 55 52 49 20 28 6f 72 20 ins the URI (or
11030 6e 6f 6e 2d 55 52 49 20 66 69 6c 65 6e 61 6d 65 non-URI filename
11040 29 0a 2a 2a 20 69 74 73 65 6c 66 2e 20 57 68 65 ).** itself. Whe
11050 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 n this function
11060 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 2a 70 is called the *p
11070 46 6c 61 67 73 20 76 61 72 69 61 62 6c 65 20 73 Flags variable s
11080 68 6f 75 6c 64 20 63 6f 6e 74 61 69 6e 0a 2a 2a hould contain.**
11090 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 6c 61 the default fla
110a0 67 73 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 gs to open the d
110b0 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 atabase handle w
110c0 69 74 68 2e 20 54 68 65 20 76 61 6c 75 65 20 73 ith. The value s
110d0 74 6f 72 65 64 20 69 6e 0a 2a 2a 20 2a 70 46 6c tored in.** *pFl
110e0 61 67 73 20 6d 61 79 20 62 65 20 75 70 64 61 74 ags may be updat
110f0 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e ed before return
11100 69 6e 67 20 69 66 20 74 68 65 20 55 52 49 20 66 ing if the URI f
11110 69 6c 65 6e 61 6d 65 20 63 6f 6e 74 61 69 6e 73 ilename contains
11120 20 0a 2a 2a 20 22 63 61 63 68 65 3d 78 78 78 22 .** "cache=xxx"
11130 20 6f 72 20 22 6d 6f 64 65 3d 78 78 78 22 20 71 or "mode=xxx" q
11140 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 73 2e uery parameters.
11150 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 .**.** If succes
11160 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 sful, SQLITE_OK
11170 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 6e 20 is returned. In
11180 74 68 69 73 20 63 61 73 65 20 2a 70 70 56 66 73 this case *ppVfs
11190 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 is set to point
111a0 20 74 6f 0a 2a 2a 20 74 68 65 20 56 46 53 20 74 to.** the VFS t
111b0 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 75 73 hat should be us
111c0 65 64 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 ed to open the d
111d0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 70 atabase file. *p
111e0 7a 46 69 6c 65 20 69 73 20 73 65 74 20 74 6f 0a zFile is set to.
111f0 2a 2a 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 ** point to a bu
11200 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ffer containing
11210 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
11220 66 69 6c 65 20 74 6f 20 6f 70 65 6e 2e 20 49 74 file to open. It
11230 20 69 73 20 74 68 65 20 0a 2a 2a 20 72 65 73 70 is the .** resp
11240 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 onsibility of th
11250 65 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e e caller to even
11260 74 75 61 6c 6c 79 20 63 61 6c 6c 20 73 71 6c 69 tually call sqli
11270 74 65 33 5f 66 72 65 65 28 29 20 74 6f 20 72 65 te3_free() to re
11280 6c 65 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 lease.** this bu
11290 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 ffer..**.** If a
112a0 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 n error occurs,
112b0 74 68 65 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 then an SQLite e
112c0 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 rror code is ret
112d0 75 72 6e 65 64 20 61 6e 64 20 2a 70 7a 45 72 72 urned and *pzErr
112e0 4d 73 67 0a 2a 2a 20 6d 61 79 20 62 65 20 73 65 Msg.** may be se
112f0 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20 t to point to a
11300 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e buffer containin
11310 67 20 61 6e 20 45 6e 67 6c 69 73 68 20 6c 61 6e g an English lan
11320 67 75 61 67 65 20 65 72 72 6f 72 20 0a 2a 2a 20 guage error .**
11330 6d 65 73 73 61 67 65 2e 20 49 74 20 69 73 20 74 message. It is t
11340 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 he responsibilit
11350 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
11360 74 6f 20 65 76 65 6e 74 75 61 6c 6c 79 20 72 65 to eventually re
11370 6c 65 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 lease.** this bu
11380 66 66 65 72 20 62 79 20 63 61 6c 6c 69 6e 67 20 ffer by calling
11390 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a sqlite3_free()..
113a0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 */.int sqlite3Pa
113b0 72 73 65 55 72 69 28 0a 20 20 63 6f 6e 73 74 20 rseUri(. const
113c0 63 68 61 72 20 2a 7a 44 65 66 61 75 6c 74 56 66 char *zDefaultVf
113d0 73 2c 20 20 20 20 20 20 20 20 2f 2a 20 56 46 53 s, /* VFS
113e0 20 74 6f 20 75 73 65 20 69 66 20 6e 6f 20 22 76 to use if no "v
113f0 66 73 3d 78 78 78 22 20 71 75 65 72 79 20 6f 70 fs=xxx" query op
11400 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 tion */. const
11410 63 68 61 72 20 2a 7a 55 72 69 2c 20 20 20 20 20 char *zUri,
11420 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6c /* Nul
11430 2d 74 65 72 6d 69 6e 61 74 65 64 20 55 52 49 20 -terminated URI
11440 74 6f 20 70 61 72 73 65 20 2a 2f 0a 20 20 75 6e to parse */. un
11450 73 69 67 6e 65 64 20 69 6e 74 20 2a 70 46 6c 61 signed int *pFla
11460 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a gs, /*
11470 20 49 4e 2f 4f 55 54 3a 20 53 51 4c 49 54 45 5f IN/OUT: SQLITE_
11480 4f 50 45 4e 5f 58 58 58 20 66 6c 61 67 73 20 2a OPEN_XXX flags *
11490 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 /. sqlite3_vfs
114a0 2a 2a 70 70 56 66 73 2c 20 20 20 20 20 20 20 20 **ppVfs,
114b0 20 20 20 20 2f 2a 20 4f 55 54 3a 20 56 46 53 20 /* OUT: VFS
114c0 74 6f 20 75 73 65 20 2a 2f 20 0a 20 20 63 68 61 to use */ . cha
114d0 72 20 2a 2a 70 7a 46 69 6c 65 2c 20 20 20 20 20 r **pzFile,
114e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
114f0 4f 55 54 3a 20 46 69 6c 65 6e 61 6d 65 20 63 6f OUT: Filename co
11500 6d 70 6f 6e 65 6e 74 20 6f 66 20 55 52 49 20 2a mponent of URI *
11510 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 /. char **pzErr
11520 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20 Msg
11530 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 72 72 6f /* OUT: Erro
11540 72 20 6d 65 73 73 61 67 65 20 28 69 66 20 72 63 r message (if rc
11550 21 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 2a 2f 0a !=SQLITE_OK) */.
11560 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
11570 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e 73 69 67 LITE_OK;. unsig
11580 6e 65 64 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 ned int flags =
11590 2a 70 46 6c 61 67 73 3b 0a 20 20 63 6f 6e 73 74 *pFlags;. const
115a0 20 63 68 61 72 20 2a 7a 56 66 73 20 3d 20 7a 44 char *zVfs = zD
115b0 65 66 61 75 6c 74 56 66 73 3b 0a 20 20 63 68 61 efaultVfs;. cha
115c0 72 20 2a 7a 46 69 6c 65 3b 0a 20 20 63 68 61 72 r *zFile;. char
115d0 20 63 3b 0a 20 20 69 6e 74 20 6e 55 72 69 20 3d c;. int nUri =
115e0 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
115f0 28 7a 55 72 69 29 3b 0a 0a 20 20 61 73 73 65 72 (zUri);.. asser
11600 74 28 20 2a 70 7a 45 72 72 4d 73 67 3d 3d 30 20 t( *pzErrMsg==0
11610 29 3b 0a 0a 20 20 69 66 28 20 28 28 66 6c 61 67 );.. if( ((flag
11620 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
11630 55 52 49 29 20 7c 7c 20 73 71 6c 69 74 65 33 47 URI) || sqlite3G
11640 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4f 70 65 lobalConfig.bOpe
11650 6e 55 72 69 29 20 0a 20 20 20 26 26 20 6e 55 72 nUri) . && nUr
11660 69 3e 3d 35 20 26 26 20 6d 65 6d 63 6d 70 28 7a i>=5 && memcmp(z
11670 55 72 69 2c 20 22 66 69 6c 65 3a 22 2c 20 35 29 Uri, "file:", 5)
11680 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 20 20 63 68 ==0 . ){. ch
11690 61 72 20 2a 7a 4f 70 74 3b 0a 20 20 20 20 69 6e ar *zOpt;. in
116a0 74 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 20 t eState;
116b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
116c0 61 72 73 65 72 20 73 74 61 74 65 20 77 68 65 6e arser state when
116d0 20 70 61 72 73 69 6e 67 20 55 52 49 20 2a 2f 0a parsing URI */.
116e0 20 20 20 20 69 6e 74 20 69 49 6e 3b 20 20 20 20 int iIn;
116f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11700 20 20 2f 2a 20 49 6e 70 75 74 20 63 68 61 72 61 /* Input chara
11710 63 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 cter index */.
11720 20 20 69 6e 74 20 69 4f 75 74 20 3d 20 30 3b 20 int iOut = 0;
11730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11740 2f 2a 20 4f 75 74 70 75 74 20 63 68 61 72 61 63 /* Output charac
11750 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 ter index */.
11760 20 69 6e 74 20 6e 42 79 74 65 20 3d 20 6e 55 72 int nByte = nUr
11770 69 2b 32 3b 20 20 20 20 20 20 20 20 20 20 20 2f i+2; /
11780 2a 20 42 79 74 65 73 20 6f 66 20 73 70 61 63 65 * Bytes of space
11790 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a to allocate */.
117a0 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 . /* Make sur
117b0 65 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 50 45 e the SQLITE_OPE
117c0 4e 5f 55 52 49 20 66 6c 61 67 20 69 73 20 73 65 N_URI flag is se
117d0 74 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 6f t to indicate to
117e0 20 74 68 65 20 56 46 53 20 78 4f 70 65 6e 20 0a the VFS xOpen .
117f0 20 20 20 20 2a 2a 20 6d 65 74 68 6f 64 20 74 68 ** method th
11800 61 74 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 at there may be
11810 65 78 74 72 61 20 70 61 72 61 6d 65 74 65 72 73 extra parameters
11820 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 66 following the f
11830 69 6c 65 2d 6e 61 6d 65 2e 20 20 2a 2f 0a 20 20 ile-name. */.
11840 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 flags |= SQLIT
11850 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a 0a 20 20 20 E_OPEN_URI;..
11860 20 66 6f 72 28 69 49 6e 3d 30 3b 20 69 49 6e 3c for(iIn=0; iIn<
11870 6e 55 72 69 3b 20 69 49 6e 2b 2b 29 20 6e 42 79 nUri; iIn++) nBy
11880 74 65 20 2b 3d 20 28 7a 55 72 69 5b 69 49 6e 5d te += (zUri[iIn]
11890 3d 3d 27 26 27 29 3b 0a 20 20 20 20 7a 46 69 6c =='&');. zFil
118a0 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c e = sqlite3_mall
118b0 6f 63 28 6e 42 79 74 65 29 3b 0a 20 20 20 20 69 oc(nByte);. i
118c0 66 28 20 21 7a 46 69 6c 65 20 29 20 72 65 74 75 f( !zFile ) retu
118d0 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
118e0 0a 0a 20 20 20 20 2f 2a 20 44 69 73 63 61 72 64 .. /* Discard
118f0 20 74 68 65 20 73 63 68 65 6d 65 20 61 6e 64 20 the scheme and
11900 61 75 74 68 6f 72 69 74 79 20 73 65 67 6d 65 6e authority segmen
11910 74 73 20 6f 66 20 74 68 65 20 55 52 49 2e 20 2a ts of the URI. *
11920 2f 0a 20 20 20 20 69 66 28 20 7a 55 72 69 5b 35 /. if( zUri[5
11930 5d 3d 3d 27 2f 27 20 26 26 20 7a 55 72 69 5b 36 ]=='/' && zUri[6
11940 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 20 20 ]=='/' ){.
11950 69 49 6e 20 3d 20 37 3b 0a 20 20 20 20 20 20 77 iIn = 7;. w
11960 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 6e 5d 20 hile( zUri[iIn]
11970 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 3d 27 2f && zUri[iIn]!='/
11980 27 20 29 20 69 49 6e 2b 2b 3b 0a 0a 20 20 20 20 ' ) iIn++;..
11990 20 20 69 66 28 20 69 49 6e 21 3d 37 20 26 26 20 if( iIn!=7 &&
119a0 28 69 49 6e 21 3d 31 36 20 7c 7c 20 6d 65 6d 63 (iIn!=16 || memc
119b0 6d 70 28 22 6c 6f 63 61 6c 68 6f 73 74 22 2c 20 mp("localhost",
119c0 26 7a 55 72 69 5b 37 5d 2c 20 39 29 29 20 29 7b &zUri[7], 9)) ){
119d0 0a 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d . *pzErrM
119e0 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 sg = sqlite3_mpr
119f0 69 6e 74 66 28 22 69 6e 76 61 6c 69 64 20 75 72 intf("invalid ur
11a00 69 20 61 75 74 68 6f 72 69 74 79 3a 20 25 2e 2a i authority: %.*
11a10 73 22 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 s", .
11a20 20 69 49 6e 2d 37 2c 20 26 7a 55 72 69 5b 37 5d iIn-7, &zUri[7]
11a30 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
11a40 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
11a50 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 65 goto parse
11a60 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 20 _uri_out;.
11a70 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
11a80 20 20 20 69 49 6e 20 3d 20 35 3b 0a 20 20 20 20 iIn = 5;.
11a90 7d 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 74 }.. /* Copy t
11aa0 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 6e 64 20 he filename and
11ab0 61 6e 79 20 71 75 65 72 79 20 70 61 72 61 6d 65 any query parame
11ac0 74 65 72 73 20 69 6e 74 6f 20 74 68 65 20 7a 46 ters into the zF
11ad0 69 6c 65 20 62 75 66 66 65 72 2e 20 0a 20 20 20 ile buffer. .
11ae0 20 2a 2a 20 44 65 63 6f 64 65 20 25 48 48 20 65 ** Decode %HH e
11af0 73 63 61 70 65 20 63 6f 64 65 73 20 61 6c 6f 6e scape codes alon
11b00 67 20 74 68 65 20 77 61 79 2e 20 0a 20 20 20 20 g the way. .
11b10 2a 2a 0a 20 20 20 20 2a 2a 20 57 69 74 68 69 6e **. ** Within
11b20 20 74 68 69 73 20 6c 6f 6f 70 2c 20 76 61 72 69 this loop, vari
11b30 61 62 6c 65 20 65 53 74 61 74 65 20 6d 61 79 20 able eState may
11b40 62 65 20 73 65 74 20 74 6f 20 30 2c 20 31 20 6f be set to 0, 1 o
11b50 72 20 32 2c 20 64 65 70 65 6e 64 69 6e 67 0a 20 r 2, depending.
11b60 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 72 ** on the par
11b70 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 41 73 sing context. As
11b80 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 20 20 2a 2a follows:. **
11b90 0a 20 20 20 20 2a 2a 20 20 20 30 3a 20 50 61 72 . ** 0: Par
11ba0 73 69 6e 67 20 66 69 6c 65 2d 6e 61 6d 65 2e 0a sing file-name..
11bb0 20 20 20 20 2a 2a 20 20 20 31 3a 20 50 61 72 73 ** 1: Pars
11bc0 69 6e 67 20 6e 61 6d 65 20 73 65 63 74 69 6f 6e ing name section
11bd0 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 6c 75 65 of a name=value
11be0 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 query parameter
11bf0 2e 0a 20 20 20 20 2a 2a 20 20 20 32 3a 20 50 61 .. ** 2: Pa
11c00 72 73 69 6e 67 20 76 61 6c 75 65 20 73 65 63 74 rsing value sect
11c10 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 ion of a name=va
11c20 6c 75 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 lue query parame
11c30 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ter.. */.
11c40 65 53 74 61 74 65 20 3d 20 30 3b 0a 20 20 20 20 eState = 0;.
11c50 77 68 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 69 while( (c = zUri
11c60 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 3d [iIn])!=0 && c!=
11c70 27 23 27 20 29 7b 0a 20 20 20 20 20 20 69 49 6e '#' ){. iIn
11c80 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 63 3d ++;. if( c=
11c90 3d 27 25 27 20 0a 20 20 20 20 20 20 20 26 26 20 ='%' . &&
11ca0 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 sqlite3Isxdigit(
11cb0 7a 55 72 69 5b 69 49 6e 5d 29 20 0a 20 20 20 20 zUri[iIn]) .
11cc0 20 20 20 26 26 20 73 71 6c 69 74 65 33 49 73 78 && sqlite3Isx
11cd0 64 69 67 69 74 28 7a 55 72 69 5b 69 49 6e 2b 31 digit(zUri[iIn+1
11ce0 5d 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 ]) . ){.
11cf0 20 20 20 20 20 69 6e 74 20 6f 63 74 65 74 20 3d int octet =
11d00 20 28 73 71 6c 69 74 65 33 48 65 78 54 6f 49 6e (sqlite3HexToIn
11d10 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d 29 20 3c t(zUri[iIn++]) <
11d20 3c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 6f 63 < 4);. oc
11d30 74 65 74 20 2b 3d 20 73 71 6c 69 74 65 33 48 65 tet += sqlite3He
11d40 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 49 6e 2b xToInt(zUri[iIn+
11d50 2b 5d 29 3b 0a 0a 20 20 20 20 20 20 20 20 61 73 +]);.. as
11d60 73 65 72 74 28 20 6f 63 74 65 74 3e 3d 30 20 26 sert( octet>=0 &
11d70 26 20 6f 63 74 65 74 3c 32 35 36 20 29 3b 0a 20 & octet<256 );.
11d80 20 20 20 20 20 20 20 69 66 28 20 6f 63 74 65 74 if( octet
11d90 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
11da0 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 68 20 /* This branch
11db0 69 73 20 74 61 6b 65 6e 20 77 68 65 6e 20 22 25 is taken when "%
11dc0 30 30 22 20 61 70 70 65 61 72 73 20 77 69 74 68 00" appears with
11dd0 69 6e 20 74 68 65 20 55 52 49 2e 20 49 6e 20 74 in the URI. In t
11de0 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a his. **
11df0 20 63 61 73 65 20 77 65 20 69 67 6e 6f 72 65 20 case we ignore
11e00 61 6c 6c 20 74 65 78 74 20 69 6e 20 74 68 65 20 all text in the
11e10 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 65 remainder of the
11e20 20 70 61 74 68 2c 20 6e 61 6d 65 20 6f 72 0a 20 path, name or.
11e30 20 20 20 20 20 20 20 20 20 2a 2a 20 76 61 6c 75 ** valu
11e40 65 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e e currently bein
11e50 67 20 70 61 72 73 65 64 2e 20 53 6f 20 69 67 6e g parsed. So ign
11e60 6f 72 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 ore the current
11e70 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 20 20 character.
11e80 20 20 20 20 2a 2a 20 61 6e 64 20 73 6b 69 70 20 ** and skip
11e90 74 6f 20 74 68 65 20 6e 65 78 74 20 22 3f 22 2c to the next "?",
11ea0 20 22 3d 22 20 6f 72 20 22 26 22 2c 20 61 73 20 "=" or "&", as
11eb0 61 70 70 72 6f 70 72 69 61 74 65 2e 20 2a 2f 0a appropriate. */.
11ec0 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 while(
11ed0 20 28 63 20 3d 20 7a 55 72 69 5b 69 49 6e 5d 29 (c = zUri[iIn])
11ee0 21 3d 30 20 26 26 20 63 21 3d 27 23 27 20 0a 20 !=0 && c!='#' .
11ef0 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 &&
11f00 28 65 53 74 61 74 65 21 3d 30 20 7c 7c 20 63 21 (eState!=0 || c!
11f10 3d 27 3f 27 29 0a 20 20 20 20 20 20 20 20 20 20 ='?').
11f20 20 20 20 20 26 26 20 28 65 53 74 61 74 65 21 3d && (eState!=
11f30 31 20 7c 7c 20 28 63 21 3d 27 3d 27 20 26 26 20 1 || (c!='=' &&
11f40 63 21 3d 27 26 27 29 29 0a 20 20 20 20 20 20 20 c!='&')).
11f50 20 20 20 20 20 20 20 26 26 20 28 65 53 74 61 74 && (eStat
11f60 65 21 3d 32 20 7c 7c 20 63 21 3d 27 26 27 29 0a e!=2 || c!='&').
11f70 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 ){.
11f80 20 20 20 20 20 20 20 20 20 69 49 6e 2b 2b 3b 0a iIn++;.
11f90 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
11fa0 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a continue;.
11fb0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
11fc0 20 20 63 20 3d 20 6f 63 74 65 74 3b 0a 20 20 20 c = octet;.
11fd0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 65 53 74 }else if( eSt
11fe0 61 74 65 3d 3d 31 20 26 26 20 28 63 3d 3d 27 26 ate==1 && (c=='&
11ff0 27 20 7c 7c 20 63 3d 3d 27 3d 27 29 20 29 7b 0a ' || c=='=') ){.
12000 20 20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c if( zFil
12010 65 5b 69 4f 75 74 2d 31 5d 3d 3d 30 20 29 7b 0a e[iOut-1]==0 ){.
12020 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 /* An
12030 65 6d 70 74 79 20 6f 70 74 69 6f 6e 20 6e 61 6d empty option nam
12040 65 2e 20 49 67 6e 6f 72 65 20 74 68 69 73 20 6f e. Ignore this o
12050 70 74 69 6f 6e 20 61 6c 74 6f 67 65 74 68 65 72 ption altogether
12060 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 77 . */. w
12070 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 6e 5d 20 hile( zUri[iIn]
12080 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 3d 27 23 && zUri[iIn]!='#
12090 27 20 26 26 20 7a 55 72 69 5b 69 49 6e 2d 31 5d ' && zUri[iIn-1]
120a0 21 3d 27 26 27 20 29 20 69 49 6e 2b 2b 3b 0a 20 !='&' ) iIn++;.
120b0 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 continu
120c0 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 e;. }.
120d0 20 20 20 20 20 69 66 28 20 63 3d 3d 27 26 27 20 if( c=='&'
120e0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 7a 46 69 ){. zFi
120f0 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 le[iOut++] = '\0
12100 27 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 ';. }else
12110 7b 0a 20 20 20 20 20 20 20 20 20 20 65 53 74 61 {. eSta
12120 74 65 20 3d 20 32 3b 0a 20 20 20 20 20 20 20 20 te = 2;.
12130 7d 0a 20 20 20 20 20 20 20 20 63 20 3d 20 30 3b }. c = 0;
12140 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
12150 20 28 65 53 74 61 74 65 3d 3d 30 20 26 26 20 63 (eState==0 && c
12160 3d 3d 27 3f 27 29 20 7c 7c 20 28 65 53 74 61 74 =='?') || (eStat
12170 65 3d 3d 32 20 26 26 20 63 3d 3d 27 26 27 29 20 e==2 && c=='&')
12180 29 7b 0a 20 20 20 20 20 20 20 20 63 20 3d 20 30 ){. c = 0
12190 3b 0a 20 20 20 20 20 20 20 20 65 53 74 61 74 65 ;. eState
121a0 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 1;. }.
121b0 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b zFile[iOut++
121c0 5d 20 3d 20 63 3b 0a 20 20 20 20 7d 0a 20 20 20 ] = c;. }.
121d0 20 69 66 28 20 65 53 74 61 74 65 3d 3d 31 20 29 if( eState==1 )
121e0 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d zFile[iOut++] =
121f0 20 27 5c 30 27 3b 0a 20 20 20 20 7a 46 69 6c 65 '\0';. zFile
12200 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b [iOut++] = '\0';
12210 0a 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b . zFile[iOut+
12220 2b 5d 20 3d 20 27 5c 30 27 3b 0a 0a 20 20 20 20 +] = '\0';..
12230 2f 2a 20 43 68 65 63 6b 20 69 66 20 74 68 65 72 /* Check if ther
12240 65 20 77 65 72 65 20 61 6e 79 20 6f 70 74 69 6f e were any optio
12250 6e 73 20 73 70 65 63 69 66 69 65 64 20 74 68 61 ns specified tha
12260 74 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 74 65 t should be inte
12270 72 70 72 65 74 65 64 20 0a 20 20 20 20 2a 2a 20 rpreted . **
12280 68 65 72 65 2e 20 4f 70 74 69 6f 6e 73 20 74 68 here. Options th
12290 61 74 20 61 72 65 20 69 6e 74 65 72 70 72 65 74 at are interpret
122a0 65 64 20 68 65 72 65 20 69 6e 63 6c 75 64 65 20 ed here include
122b0 22 76 66 73 22 20 61 6e 64 20 74 68 6f 73 65 20 "vfs" and those
122c0 74 68 61 74 0a 20 20 20 20 2a 2a 20 63 6f 72 72 that. ** corr
122d0 65 73 70 6f 6e 64 20 74 6f 20 66 6c 61 67 73 20 espond to flags
122e0 74 68 61 74 20 6d 61 79 20 62 65 20 70 61 73 73 that may be pass
122f0 65 64 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 ed to the sqlite
12300 33 5f 6f 70 65 6e 5f 76 32 28 29 0a 20 20 20 20 3_open_v2().
12310 2a 2a 20 6d 65 74 68 6f 64 2e 20 2a 2f 0a 20 20 ** method. */.
12320 20 20 7a 4f 70 74 20 3d 20 26 7a 46 69 6c 65 5b zOpt = &zFile[
12330 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
12340 7a 46 69 6c 65 29 2b 31 5d 3b 0a 20 20 20 20 77 zFile)+1];. w
12350 68 69 6c 65 28 20 7a 4f 70 74 5b 30 5d 20 29 7b hile( zOpt[0] ){
12360 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f 70 74 20 . int nOpt
12370 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
12380 30 28 7a 4f 70 74 29 3b 0a 20 20 20 20 20 20 63 0(zOpt);. c
12390 68 61 72 20 2a 7a 56 61 6c 20 3d 20 26 7a 4f 70 har *zVal = &zOp
123a0 74 5b 6e 4f 70 74 2b 31 5d 3b 0a 20 20 20 20 20 t[nOpt+1];.
123b0 20 69 6e 74 20 6e 56 61 6c 20 3d 20 73 71 6c 69 int nVal = sqli
123c0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 56 61 6c te3Strlen30(zVal
123d0 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 6e 4f );.. if( nO
123e0 70 74 3d 3d 33 20 26 26 20 6d 65 6d 63 6d 70 28 pt==3 && memcmp(
123f0 22 76 66 73 22 2c 20 7a 4f 70 74 2c 20 33 29 3d "vfs", zOpt, 3)=
12400 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 56 =0 ){. zV
12410 66 73 20 3d 20 7a 56 61 6c 3b 0a 20 20 20 20 20 fs = zVal;.
12420 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
12430 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f 64 65 20 struct OpenMode
12440 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 {. cons
12450 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 20 t char *z;.
12460 20 20 20 20 20 69 6e 74 20 6d 6f 64 65 3b 0a 20 int mode;.
12470 20 20 20 20 20 20 20 7d 20 2a 61 4d 6f 64 65 20 } *aMode
12480 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 63 68 61 = 0;. cha
12490 72 20 2a 7a 4d 6f 64 65 54 79 70 65 20 3d 20 30 r *zModeType = 0
124a0 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6d 61 ;. int ma
124b0 73 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 sk = 0;.
124c0 69 6e 74 20 6c 69 6d 69 74 20 3d 20 30 3b 0a 0a int limit = 0;..
124d0 20 20 20 20 20 20 20 20 69 66 28 20 6e 4f 70 74 if( nOpt
124e0 3d 3d 35 20 26 26 20 6d 65 6d 63 6d 70 28 22 63 ==5 && memcmp("c
124f0 61 63 68 65 22 2c 20 7a 4f 70 74 2c 20 35 29 3d ache", zOpt, 5)=
12500 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
12510 73 74 61 74 69 63 20 73 74 72 75 63 74 20 4f 70 static struct Op
12520 65 6e 4d 6f 64 65 20 61 43 61 63 68 65 4d 6f 64 enMode aCacheMod
12530 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 e[] = {.
12540 20 20 20 20 7b 20 22 73 68 61 72 65 64 22 2c 20 { "shared",
12550 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 SQLITE_OPEN_SHA
12560 52 45 44 43 41 43 48 45 20 7d 2c 0a 20 20 20 20 REDCACHE },.
12570 20 20 20 20 20 20 20 20 7b 20 22 70 72 69 76 61 { "priva
12580 74 65 22 2c 20 53 51 4c 49 54 45 5f 4f 50 45 4e te", SQLITE_OPEN
12590 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 7d 2c _PRIVATECACHE },
125a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 20 30 . { 0
125b0 2c 20 30 20 7d 0a 20 20 20 20 20 20 20 20 20 20 , 0 }.
125c0 7d 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 6d 61 };.. ma
125d0 73 6b 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e sk = SQLITE_OPEN
125e0 5f 53 48 41 52 45 44 43 41 43 48 45 7c 53 51 4c _SHAREDCACHE|SQL
125f0 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 ITE_OPEN_PRIVATE
12600 43 41 43 48 45 3b 0a 20 20 20 20 20 20 20 20 20 CACHE;.
12610 20 61 4d 6f 64 65 20 3d 20 61 43 61 63 68 65 4d aMode = aCacheM
12620 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 20 20 6c ode;. l
12630 69 6d 69 74 20 3d 20 6d 61 73 6b 3b 0a 20 20 20 imit = mask;.
12640 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 zModeType
12650 20 3d 20 22 63 61 63 68 65 22 3b 0a 20 20 20 20 = "cache";.
12660 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 }. if
12670 28 20 6e 4f 70 74 3d 3d 34 20 26 26 20 6d 65 6d ( nOpt==4 && mem
12680 63 6d 70 28 22 6d 6f 64 65 22 2c 20 7a 4f 70 74 cmp("mode", zOpt
12690 2c 20 34 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 , 4)==0 ){.
126a0 20 20 20 20 20 73 74 61 74 69 63 20 73 74 72 75 static stru
126b0 63 74 20 4f 70 65 6e 4d 6f 64 65 20 61 4f 70 65 ct OpenMode aOpe
126c0 6e 4d 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 nMode[] = {.
126d0 20 20 20 20 20 20 20 20 7b 20 22 72 6f 22 2c 20 { "ro",
126e0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
126f0 44 4f 4e 4c 59 20 7d 2c 0a 20 20 20 20 20 20 20 DONLY },.
12700 20 20 20 20 20 7b 20 22 72 77 22 2c 20 20 53 51 { "rw", SQ
12710 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
12720 49 54 45 20 7d 2c 20 0a 20 20 20 20 20 20 20 20 ITE }, .
12730 20 20 20 20 7b 20 22 72 77 63 22 2c 20 53 51 4c { "rwc", SQL
12740 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
12750 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e TE | SQLITE_OPEN
12760 5f 43 52 45 41 54 45 20 7d 2c 0a 20 20 20 20 20 _CREATE },.
12770 20 20 20 20 20 20 20 7b 20 22 6d 65 6d 6f 72 79 { "memory
12780 22 2c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d ", SQLITE_OPEN_M
12790 45 4d 4f 52 59 20 7d 2c 0a 20 20 20 20 20 20 20 EMORY },.
127a0 20 20 20 20 20 7b 20 30 2c 20 30 20 7d 0a 20 20 { 0, 0 }.
127b0 20 20 20 20 20 20 20 20 7d 3b 0a 0a 20 20 20 20 };..
127c0 20 20 20 20 20 20 6d 61 73 6b 20 3d 20 53 51 4c mask = SQL
127d0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
127e0 59 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f Y | SQLITE_OPEN_
127f0 52 45 41 44 57 52 49 54 45 0a 20 20 20 20 20 20 READWRITE.
12800 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 | S
12810 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 QLITE_OPEN_CREAT
12820 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f E | SQLITE_OPEN_
12830 4d 45 4d 4f 52 59 3b 0a 20 20 20 20 20 20 20 20 MEMORY;.
12840 20 20 61 4d 6f 64 65 20 3d 20 61 4f 70 65 6e 4d aMode = aOpenM
12850 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 20 20 6c ode;. l
12860 69 6d 69 74 20 3d 20 6d 61 73 6b 20 26 20 66 6c imit = mask & fl
12870 61 67 73 3b 0a 20 20 20 20 20 20 20 20 20 20 7a ags;. z
12880 4d 6f 64 65 54 79 70 65 20 3d 20 22 61 63 63 65 ModeType = "acce
12890 73 73 22 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a ss";. }..
128a0 20 20 20 20 20 20 20 20 69 66 28 20 61 4d 6f 64 if( aMod
128b0 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 e ){. i
128c0 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 nt i;.
128d0 69 6e 74 20 6d 6f 64 65 20 3d 20 30 3b 0a 20 20 int mode = 0;.
128e0 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b for(i=0;
128f0 20 61 4d 6f 64 65 5b 69 5d 2e 7a 3b 20 69 2b 2b aMode[i].z; i++
12900 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 63 ){. c
12910 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 61 onst char *z = a
12920 4d 6f 64 65 5b 69 5d 2e 7a 3b 0a 20 20 20 20 20 Mode[i].z;.
12930 20 20 20 20 20 20 20 69 66 28 20 6e 56 61 6c 3d if( nVal=
12940 3d 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 =sqlite3Strlen30
12950 28 7a 29 20 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 (z) && 0==memcmp
12960 28 7a 56 61 6c 2c 20 7a 2c 20 6e 56 61 6c 29 20 (zVal, z, nVal)
12970 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
12980 20 6d 6f 64 65 20 3d 20 61 4d 6f 64 65 5b 69 5d mode = aMode[i]
12990 2e 6d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 20 .mode;.
129a0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
129b0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
129c0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
129d0 69 66 28 20 6d 6f 64 65 3d 3d 30 20 29 7b 0a 20 if( mode==0 ){.
129e0 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 *pzEr
129f0 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d rMsg = sqlite3_m
12a00 70 72 69 6e 74 66 28 22 6e 6f 20 73 75 63 68 20 printf("no such
12a10 25 73 20 6d 6f 64 65 3a 20 25 73 22 2c 20 7a 4d %s mode: %s", zM
12a20 6f 64 65 54 79 70 65 2c 20 7a 56 61 6c 29 3b 0a odeType, zVal);.
12a30 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
12a40 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
12a50 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 goto
12a60 70 61 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 parse_uri_out;.
12a70 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
12a80 20 20 20 20 20 69 66 28 20 28 6d 6f 64 65 20 26 if( (mode &
12a90 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 ~SQLITE_OPEN_ME
12aa0 4d 4f 52 59 29 3e 6c 69 6d 69 74 20 29 7b 0a 20 MORY)>limit ){.
12ab0 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 *pzEr
12ac0 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d rMsg = sqlite3_m
12ad0 70 72 69 6e 74 66 28 22 25 73 20 6d 6f 64 65 20 printf("%s mode
12ae0 6e 6f 74 20 61 6c 6c 6f 77 65 64 3a 20 25 73 22 not allowed: %s"
12af0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
12b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12b10 20 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 zModeT
12b20 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20 ype, zVal);.
12b30 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
12b40 49 54 45 5f 50 45 52 4d 3b 0a 20 20 20 20 20 20 ITE_PERM;.
12b50 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 65 goto parse
12b60 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 20 _uri_out;.
12b70 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
12b80 66 6c 61 67 73 20 3d 20 28 66 6c 61 67 73 20 26 flags = (flags &
12b90 20 7e 6d 61 73 6b 29 20 7c 20 6d 6f 64 65 3b 0a ~mask) | mode;.
12ba0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
12bb0 7d 0a 0a 20 20 20 20 20 20 7a 4f 70 74 20 3d 20 }.. zOpt =
12bc0 26 7a 56 61 6c 5b 6e 56 61 6c 2b 31 5d 3b 0a 20 &zVal[nVal+1];.
12bd0 20 20 20 7d 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 }.. }else{.
12be0 20 20 20 7a 46 69 6c 65 20 3d 20 73 71 6c 69 74 zFile = sqlit
12bf0 65 33 5f 6d 61 6c 6c 6f 63 28 6e 55 72 69 2b 32 e3_malloc(nUri+2
12c00 29 3b 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c );. if( !zFil
12c10 65 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 e ) return SQLIT
12c20 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 6d 65 6d E_NOMEM;. mem
12c30 63 70 79 28 7a 46 69 6c 65 2c 20 7a 55 72 69 2c cpy(zFile, zUri,
12c40 20 6e 55 72 69 29 3b 0a 20 20 20 20 7a 46 69 6c nUri);. zFil
12c50 65 5b 6e 55 72 69 5d 20 3d 20 27 5c 30 27 3b 0a e[nUri] = '\0';.
12c60 20 20 20 20 7a 46 69 6c 65 5b 6e 55 72 69 2b 31 zFile[nUri+1
12c70 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 66 6c ] = '\0';. fl
12c80 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4f ags &= ~SQLITE_O
12c90 50 45 4e 5f 55 52 49 3b 0a 20 20 7d 0a 0a 20 20 PEN_URI;. }..
12ca0 2a 70 70 56 66 73 20 3d 20 73 71 6c 69 74 65 33 *ppVfs = sqlite3
12cb0 5f 76 66 73 5f 66 69 6e 64 28 7a 56 66 73 29 3b _vfs_find(zVfs);
12cc0 0a 20 20 69 66 28 20 2a 70 70 56 66 73 3d 3d 30 . if( *ppVfs==0
12cd0 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 72 4d 73 ){. *pzErrMs
12ce0 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 g = sqlite3_mpri
12cf0 6e 74 66 28 22 6e 6f 20 73 75 63 68 20 76 66 73 ntf("no such vfs
12d00 3a 20 25 73 22 2c 20 7a 56 66 73 29 3b 0a 20 20 : %s", zVfs);.
12d10 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
12d20 52 4f 52 3b 0a 20 20 7d 0a 20 70 61 72 73 65 5f ROR;. }. parse_
12d30 75 72 69 5f 6f 75 74 3a 0a 20 20 69 66 28 20 72 uri_out:. if( r
12d40 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
12d50 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
12d60 28 7a 46 69 6c 65 29 3b 0a 20 20 20 20 7a 46 69 (zFile);. zFi
12d70 6c 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a 70 le = 0;. }. *p
12d80 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a 20 Flags = flags;.
12d90 20 2a 70 7a 46 69 6c 65 20 3d 20 7a 46 69 6c 65 *pzFile = zFile
12da0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
12db0 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f .../*.** This ro
12dc0 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 77 utine does the w
12dd0 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 ork of opening a
12de0 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65 68 database on beh
12df0 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 alf of.** sqlite
12e00 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 3_open() and sql
12e10 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 ite3_open16(). T
12e20 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
12e30 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 name "zFilename"
12e40 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 .** is UTF-8 e
12e50 6e 63 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 ncoded..*/.stati
12e60 63 20 69 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 c int openDataba
12e70 73 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 se(. const char
12e80 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 *zFilename, /*
12e90 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d Database filenam
12ea0 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 e UTF-8 encoded
12eb0 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 */. sqlite3 **p
12ec0 70 44 62 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f pDb, /* O
12ed0 55 54 3a 20 52 65 74 75 72 6e 65 64 20 64 61 74 UT: Returned dat
12ee0 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a abase handle */.
12ef0 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 66 unsigned int f
12f00 6c 61 67 73 2c 20 20 20 20 2f 2a 20 4f 70 65 72 lags, /* Oper
12f10 61 74 69 6f 6e 61 6c 20 66 6c 61 67 73 20 2a 2f ational flags */
12f20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
12f30 56 66 73 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d Vfs /* Nam
12f40 65 20 6f 66 20 74 68 65 20 56 46 53 20 74 6f 20 e of the VFS to
12f50 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 use */.){. sqli
12f60 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 te3 *db;
12f70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
12f80 74 6f 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 68 tore allocated h
12f90 61 6e 64 6c 65 20 68 65 72 65 20 2a 2f 0a 20 20 andle here */.
12fa0 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
12fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12fc0 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
12fd0 2f 0a 20 20 69 6e 74 20 69 73 54 68 72 65 61 64 /. int isThread
12fe0 73 61 66 65 3b 20 20 20 20 20 20 20 20 20 20 20 safe;
12ff0 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 /* True for
13000 74 68 72 65 61 64 73 61 66 65 20 63 6f 6e 6e 65 threadsafe conne
13010 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 63 68 61 72 ctions */. char
13020 20 2a 7a 4f 70 65 6e 20 3d 20 30 3b 20 20 20 20 *zOpen = 0;
13030 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
13040 69 6c 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 ilename argument
13050 20 74 6f 20 70 61 73 73 20 74 6f 20 42 74 72 65 to pass to Btre
13060 65 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 63 68 61 eOpen() */. cha
13070 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 20 r *zErrMsg = 0;
13080 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
13090 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72 Error message fr
130a0 6f 6d 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 om sqlite3ParseU
130b0 72 69 28 29 20 2a 2f 0a 0a 20 20 2a 70 70 44 62 ri() */.. *ppDb
130c0 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 = 0;.#ifndef SQ
130d0 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e LITE_OMIT_AUTOIN
130e0 49 54 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 IT. rc = sqlite
130f0 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 3_initialize();.
13100 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
13110 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 n rc;.#endif..
13120 2f 2a 20 4f 6e 6c 79 20 61 6c 6c 6f 77 20 73 65 /* Only allow se
13130 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 69 nsible combinati
13140 6f 6e 73 20 6f 66 20 62 69 74 73 20 69 6e 20 74 ons of bits in t
13150 68 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 6e he flags argumen
13160 74 2e 20 20 0a 20 20 2a 2a 20 54 68 72 6f 77 20 t. . ** Throw
13170 61 6e 20 65 72 72 6f 72 20 69 66 20 61 6e 79 20 an error if any
13180 6e 6f 6e 2d 73 65 6e 73 65 20 63 6f 6d 62 69 6e non-sense combin
13190 61 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 20 20 ation is used.
131a0 49 66 20 77 65 0a 20 20 2a 2a 20 64 6f 20 6e 6f If we. ** do no
131b0 74 20 62 6c 6f 63 6b 20 69 6c 6c 65 67 61 6c 20 t block illegal
131c0 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 68 65 72 combinations her
131d0 65 2c 20 69 74 20 63 6f 75 6c 64 20 74 72 69 67 e, it could trig
131e0 67 65 72 0a 20 20 2a 2a 20 61 73 73 65 72 74 28 ger. ** assert(
131f0 29 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 ) statements in
13200 64 65 65 70 65 72 20 6c 61 79 65 72 73 2e 20 20 deeper layers.
13210 53 65 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 Sensible combina
13220 74 69 6f 6e 73 0a 20 20 2a 2a 20 61 72 65 3a 0a tions. ** are:.
13230 20 20 2a 2a 0a 20 20 2a 2a 20 20 31 3a 20 20 53 **. ** 1: S
13240 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f QLITE_OPEN_READO
13250 4e 4c 59 0a 20 20 2a 2a 20 20 32 3a 20 20 53 51 NLY. ** 2: SQ
13260 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
13270 49 54 45 0a 20 20 2a 2a 20 20 36 3a 20 20 53 51 ITE. ** 6: SQ
13280 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
13290 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 ITE | SQLITE_OPE
132a0 4e 5f 43 52 45 41 54 45 0a 20 20 2a 2f 0a 20 20 N_CREATE. */.
132b0 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 4f assert( SQLITE_O
132c0 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 20 3d 3d PEN_READONLY ==
132d0 20 30 78 30 31 20 29 3b 0a 20 20 61 73 73 65 72 0x01 );. asser
132e0 74 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 t( SQLITE_OPEN_R
132f0 45 41 44 57 52 49 54 45 20 3d 3d 20 30 78 30 32 EADWRITE == 0x02
13300 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 );. assert( SQ
13310 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 LITE_OPEN_CREATE
13320 20 20 20 20 3d 3d 20 30 78 30 34 20 29 3b 0a 20 == 0x04 );.
13330 20 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c 28 testcase( (1<<(
13340 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 32 20 flags&7))==0x02
13350 29 3b 20 2f 2a 20 52 45 41 44 4f 4e 4c 59 20 2a ); /* READONLY *
13360 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 28 31 /. testcase( (1
13370 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 <<(flags&7))==0x
13380 30 34 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 49 04 ); /* READWRI
13390 54 45 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 TE */. testcase
133a0 28 20 28 31 3c 3c 28 66 6c 61 67 73 26 37 29 29 ( (1<<(flags&7))
133b0 3d 3d 30 78 34 30 20 29 3b 20 2f 2a 20 52 45 41 ==0x40 ); /* REA
133c0 44 57 52 49 54 45 20 7c 20 43 52 45 41 54 45 20 DWRITE | CREATE
133d0 2a 2f 0a 20 20 69 66 28 20 28 28 31 3c 3c 28 66 */. if( ((1<<(f
133e0 6c 61 67 73 26 37 29 29 20 26 20 30 78 34 36 29 lags&7)) & 0x46)
133f0 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
13400 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
13410 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 .. if( sqlite3G
13420 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 lobalConfig.bCor
13430 65 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 eMutex==0 ){.
13440 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d 20 isThreadsafe =
13450 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 0;. }else if( f
13460 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
13470 45 4e 5f 4e 4f 4d 55 54 45 58 20 29 7b 0a 20 20 EN_NOMUTEX ){.
13480 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d isThreadsafe =
13490 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 0;. }else if(
134a0 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f flags & SQLITE_O
134b0 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 29 7b PEN_FULLMUTEX ){
134c0 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 . isThreadsaf
134d0 65 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a e = 1;. }else{.
134e0 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 isThreadsafe
134f0 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c = sqlite3Global
13500 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 Config.bFullMute
13510 78 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 x;. }. if( fla
13520 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e gs & SQLITE_OPEN
13530 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 29 7b _PRIVATECACHE ){
13540 0a 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e 53 . flags &= ~S
13550 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 QLITE_OPEN_SHARE
13560 44 43 41 43 48 45 3b 0a 20 20 7d 65 6c 73 65 20 DCACHE;. }else
13570 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
13580 6c 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 43 61 lConfig.sharedCa
13590 63 68 65 45 6e 61 62 6c 65 64 20 29 7b 0a 20 20 cheEnabled ){.
135a0 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 flags |= SQLIT
135b0 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 43 E_OPEN_SHAREDCAC
135c0 48 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 HE;. }.. /* Re
135d0 6d 6f 76 65 20 68 61 72 6d 66 75 6c 20 62 69 74 move harmful bit
135e0 73 20 66 72 6f 6d 20 74 68 65 20 66 6c 61 67 73 s from the flags
135f0 20 70 61 72 61 6d 65 74 65 72 0a 20 20 2a 2a 0a parameter. **.
13600 20 20 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f ** The SQLITE_
13610 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 61 6e 64 OPEN_NOMUTEX and
13620 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c SQLITE_OPEN_FUL
13630 4c 4d 55 54 45 58 20 66 6c 61 67 73 20 77 65 72 LMUTEX flags wer
13640 65 0a 20 20 2a 2a 20 64 65 61 6c 74 20 77 69 74 e. ** dealt wit
13650 68 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 h in the previou
13660 73 20 63 6f 64 65 20 62 6c 6f 63 6b 2e 20 20 42 s code block. B
13670 65 73 69 64 65 73 20 74 68 65 73 65 2c 20 74 68 esides these, th
13680 65 20 6f 6e 6c 79 0a 20 20 2a 2a 20 76 61 6c 69 e only. ** vali
13690 64 20 69 6e 70 75 74 20 66 6c 61 67 73 20 66 6f d input flags fo
136a0 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 r sqlite3_open_v
136b0 32 28 29 20 61 72 65 20 53 51 4c 49 54 45 5f 4f 2() are SQLITE_O
136c0 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 0a 20 20 PEN_READONLY,.
136d0 2a 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 ** SQLITE_OPEN_R
136e0 45 41 44 57 52 49 54 45 2c 20 53 51 4c 49 54 45 EADWRITE, SQLITE
136f0 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 53 51 _OPEN_CREATE, SQ
13700 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 LITE_OPEN_SHARED
13710 43 41 43 48 45 2c 0a 20 20 2a 2a 20 53 51 4c 49 CACHE,. ** SQLI
13720 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 TE_OPEN_PRIVATEC
13730 41 43 48 45 2c 20 61 6e 64 20 73 6f 6d 65 20 72 ACHE, and some r
13740 65 73 65 72 76 65 64 20 62 69 74 73 2e 20 20 53 eserved bits. S
13750 69 6c 65 6e 74 6c 79 20 6d 61 73 6b 0a 20 20 2a ilently mask. *
13760 2a 20 6f 66 66 20 61 6c 6c 20 6f 74 68 65 72 20 * off all other
13770 66 6c 61 67 73 2e 0a 20 20 2a 2f 0a 20 20 66 6c flags.. */. fl
13780 61 67 73 20 26 3d 20 20 7e 28 20 53 51 4c 49 54 ags &= ~( SQLIT
13790 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 E_OPEN_DELETEONC
137a0 4c 4f 53 45 20 7c 0a 20 20 20 20 20 20 20 20 20 LOSE |.
137b0 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
137c0 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 0a 20 20 N_EXCLUSIVE |.
137d0 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
137e0 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 ITE_OPEN_MAIN_DB
137f0 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
13800 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 SQLITE_OPEN_TE
13810 4d 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 20 20 MP_DB | .
13820 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
13830 50 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 42 PEN_TRANSIENT_DB
13840 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 | .
13850 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d SQLITE_OPEN_M
13860 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 AIN_JOURNAL | .
13870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
13880 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a LITE_OPEN_TEMP_J
13890 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 OURNAL | .
138a0 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
138b0 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 OPEN_SUBJOURNAL
138c0 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | .
138d0 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 SQLITE_OPEN_MA
138e0 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 STER_JOURNAL |.
138f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
13900 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 LITE_OPEN_NOMUTE
13910 58 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 X |.
13920 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 SQLITE_OPEN_F
13930 55 4c 4c 4d 55 54 45 58 20 7c 0a 20 20 20 20 20 ULLMUTEX |.
13940 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
13950 5f 4f 50 45 4e 5f 57 41 4c 0a 20 20 20 20 20 20 _OPEN_WAL.
13960 20 20 20 20 20 20 20 29 3b 0a 0a 20 20 2f 2a 20 );.. /*
13970 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c Allocate the sql
13980 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 75 ite data structu
13990 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c re */. db = sql
139a0 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 ite3MallocZero(
139b0 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 20 sizeof(sqlite3)
139c0 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 );. if( db==0 )
139d0 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 goto opendb_out
139e0 3b 0a 20 20 69 66 28 20 69 73 54 68 72 65 61 64 ;. if( isThread
139f0 73 61 66 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e safe ){. db->
13a00 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d mutex = sqlite3M
13a10 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 utexAlloc(SQLITE
13a20 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 _MUTEX_RECURSIVE
13a30 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d );. if( db->m
13a40 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 utex==0 ){.
13a50 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 sqlite3_free(db
13a60 29 3b 0a 20 20 20 20 20 20 64 62 20 3d 20 30 3b );. db = 0;
13a70 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e . goto open
13a80 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 db_out;. }.
13a90 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
13aa0 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
13ab0 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 x);. db->errMas
13ac0 6b 20 3d 20 30 78 66 66 3b 0a 20 20 64 62 2d 3e k = 0xff;. db->
13ad0 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e 6d nDb = 2;. db->m
13ae0 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 agic = SQLITE_MA
13af0 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d 3e GIC_BUSY;. db->
13b00 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 61 aDb = db->aDbSta
13b10 74 69 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 tic;.. assert(
13b20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 sizeof(db->aLimi
13b30 74 29 3d 3d 73 69 7a 65 6f 66 28 61 48 61 72 64 t)==sizeof(aHard
13b40 4c 69 6d 69 74 29 20 29 3b 0a 20 20 6d 65 6d 63 Limit) );. memc
13b50 70 79 28 64 62 2d 3e 61 4c 69 6d 69 74 2c 20 61 py(db->aLimit, a
13b60 48 61 72 64 4c 69 6d 69 74 2c 20 73 69 7a 65 6f HardLimit, sizeo
13b70 66 28 64 62 2d 3e 61 4c 69 6d 69 74 29 29 3b 0a f(db->aLimit));.
13b80 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 db->autoCommit
13b90 20 3d 20 31 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 = 1;. db->next
13ba0 41 75 74 6f 76 61 63 20 3d 20 2d 31 3b 0a 20 20 Autovac = -1;.
13bb0 64 62 2d 3e 73 7a 4d 6d 61 70 20 3d 20 73 71 6c db->szMmap = sql
13bc0 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
13bd0 2e 73 7a 4d 6d 61 70 3b 0a 20 20 64 62 2d 3e 6e .szMmap;. db->n
13be0 65 78 74 50 61 67 65 73 69 7a 65 20 3d 20 30 3b extPagesize = 0;
13bf0 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 . db->flags |=
13c00 53 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e SQLITE_ShortColN
13c10 61 6d 65 73 20 7c 20 53 51 4c 49 54 45 5f 41 75 ames | SQLITE_Au
13c20 74 6f 49 6e 64 65 78 20 7c 20 53 51 4c 49 54 45 toIndex | SQLITE
13c30 5f 45 6e 61 62 6c 65 54 72 69 67 67 65 72 0a 23 _EnableTrigger.#
13c40 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c if SQLITE_DEFAUL
13c50 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 3c 34 0a T_FILE_FORMAT<4.
13c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13c70 20 7c 20 53 51 4c 49 54 45 5f 4c 65 67 61 63 79 | SQLITE_Legacy
13c80 46 69 6c 65 46 6d 74 0a 23 65 6e 64 69 66 0a 23 FileFmt.#endif.#
13c90 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
13ca0 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 BLE_LOAD_EXTENSI
13cb0 4f 4e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ON.
13cc0 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c 6f 61 | SQLITE_Loa
13cd0 64 45 78 74 65 6e 73 69 6f 6e 0a 23 65 6e 64 69 dExtension.#endi
13ce0 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 f.#if SQLITE_DEF
13cf0 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 5f 54 AULT_RECURSIVE_T
13d00 52 49 47 47 45 52 53 0a 20 20 20 20 20 20 20 20 RIGGERS.
13d10 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
13d20 45 5f 52 65 63 54 72 69 67 67 65 72 73 0a 23 65 E_RecTriggers.#e
13d30 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 ndif.#if defined
13d40 28 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f (SQLITE_DEFAULT_
13d50 46 4f 52 45 49 47 4e 5f 4b 45 59 53 29 20 26 26 FOREIGN_KEYS) &&
13d60 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
13d70 46 4f 52 45 49 47 4e 5f 4b 45 59 53 0a 20 20 20 FOREIGN_KEYS.
13d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
13d90 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 SQLITE_ForeignKe
13da0 79 73 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 ys.#endif.
13db0 3b 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 ;. sqlite3HashI
13dc0 6e 69 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 nit(&db->aCollSe
13dd0 71 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 q);.#ifndef SQLI
13de0 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
13df0 41 42 4c 45 0a 20 20 73 71 6c 69 74 65 33 48 61 ABLE. sqlite3Ha
13e00 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 4d 6f 64 shInit(&db->aMod
13e10 75 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 ule);.#endif..
13e20 2f 2a 20 41 64 64 20 74 68 65 20 64 65 66 61 75 /* Add the defau
13e30 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 lt collation seq
13e40 75 65 6e 63 65 20 42 49 4e 41 52 59 2e 20 42 49 uence BINARY. BI
13e50 4e 41 52 59 20 77 6f 72 6b 73 20 66 6f 72 20 62 NARY works for b
13e60 6f 74 68 20 55 54 46 2d 38 0a 20 20 2a 2a 20 61 oth UTF-8. ** a
13e70 6e 64 20 55 54 46 2d 31 36 2c 20 73 6f 20 61 64 nd UTF-16, so ad
13e80 64 20 61 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 d a version for
13e90 65 61 63 68 20 74 6f 20 61 76 6f 69 64 20 61 6e each to avoid an
13ea0 79 20 75 6e 6e 65 63 65 73 73 61 72 79 0a 20 20 y unnecessary.
13eb0 2a 2a 20 63 6f 6e 76 65 72 73 69 6f 6e 73 2e 20 ** conversions.
13ec0 54 68 65 20 6f 6e 6c 79 20 65 72 72 6f 72 20 74 The only error t
13ed0 68 61 74 20 63 61 6e 20 6f 63 63 75 72 20 68 65 hat can occur he
13ee0 72 65 20 69 73 20 61 20 6d 61 6c 6c 6f 63 28 29 re is a malloc()
13ef0 20 66 61 69 6c 75 72 65 2e 0a 20 20 2a 2f 0a 20 failure.. */.
13f00 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e createCollation
13f10 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 (db, "BINARY", S
13f20 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 62 QLITE_UTF8, 0, b
13f30 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a inCollFunc, 0);.
13f40 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
13f50 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 n(db, "BINARY",
13f60 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 SQLITE_UTF16BE,
13f70 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 0, binCollFunc,
13f80 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 0);. createColl
13f90 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 ation(db, "BINAR
13fa0 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 Y", SQLITE_UTF16
13fb0 4c 45 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 LE, 0, binCollFu
13fc0 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 74 65 nc, 0);. create
13fd0 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 52 Collation(db, "R
13fe0 54 52 49 4d 22 2c 20 53 51 4c 49 54 45 5f 55 54 TRIM", SQLITE_UT
13ff0 46 38 2c 20 28 76 6f 69 64 2a 29 31 2c 20 62 69 F8, (void*)1, bi
14000 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 nCollFunc, 0);.
14010 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
14020 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 6f 74 ailed ){. got
14030 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
14040 7d 0a 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c }. db->pDfltCol
14050 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
14060 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 54 ollSeq(db, SQLIT
14070 45 5f 55 54 46 38 2c 20 22 42 49 4e 41 52 59 22 E_UTF8, "BINARY"
14080 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 , 0);. assert(
14090 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 db->pDfltColl!=0
140a0 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 );.. /* Also a
140b0 64 64 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d dd a UTF-8 case-
140c0 69 6e 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c insensitive coll
140d0 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 ation sequence.
140e0 2a 2f 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 */. createColla
140f0 74 69 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 tion(db, "NOCASE
14100 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 ", SQLITE_UTF8,
14110 30 2c 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 0, nocaseCollati
14120 6e 67 46 75 6e 63 2c 20 30 29 3b 0a 0a 20 20 2f ngFunc, 0);.. /
14130 2a 20 50 61 72 73 65 20 74 68 65 20 66 69 6c 65 * Parse the file
14140 6e 61 6d 65 2f 55 52 49 20 61 72 67 75 6d 65 6e name/URI argumen
14150 74 2e 20 2a 2f 0a 20 20 64 62 2d 3e 6f 70 65 6e t. */. db->open
14160 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a 20 Flags = flags;.
14170 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 72 rc = sqlite3Par
14180 73 65 55 72 69 28 7a 56 66 73 2c 20 7a 46 69 6c seUri(zVfs, zFil
14190 65 6e 61 6d 65 2c 20 26 66 6c 61 67 73 2c 20 26 ename, &flags, &
141a0 64 62 2d 3e 70 56 66 73 2c 20 26 7a 4f 70 65 6e db->pVfs, &zOpen
141b0 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 , &zErrMsg);. i
141c0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
141d0 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d ){. if( rc==
141e0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 20 64 SQLITE_NOMEM ) d
141f0 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
14200 3d 20 31 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 = 1;. sqlite3
14210 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 7a 45 Error(db, rc, zE
14220 72 72 4d 73 67 20 3f 20 22 25 73 22 20 3a 20 30 rrMsg ? "%s" : 0
14230 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 , zErrMsg);.
14240 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72 sqlite3_free(zEr
14250 72 4d 73 67 29 3b 0a 20 20 20 20 67 6f 74 6f 20 rMsg);. goto
14260 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a opendb_out;. }.
14270 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 . /* Open the b
14280 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 ackend database
14290 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d driver */. rc =
142a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 sqlite3BtreeOpe
142b0 6e 28 64 62 2d 3e 70 56 66 73 2c 20 7a 4f 70 65 n(db->pVfs, zOpe
142c0 6e 2c 20 64 62 2c 20 26 64 62 2d 3e 61 44 62 5b n, db, &db->aDb[
142d0 30 5d 2e 70 42 74 2c 20 30 2c 0a 20 20 20 20 20 0].pBt, 0,.
142e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
142f0 20 20 20 66 6c 61 67 73 20 7c 20 53 51 4c 49 54 flags | SQLIT
14300 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 3b E_OPEN_MAIN_DB);
14310 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
14320 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
14330 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 rc==SQLITE_IOERR
14340 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 _NOMEM ){.
14350 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
14360 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c M;. }. sql
14370 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 ite3Error(db, rc
14380 2c 20 30 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f , 0);. goto o
14390 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 pendb_out;. }.
143a0 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 db->aDb[0].pSch
143b0 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 ema = sqlite3Sch
143c0 65 6d 61 47 65 74 28 64 62 2c 20 64 62 2d 3e 61 emaGet(db, db->a
143d0 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 Db[0].pBt);. db
143e0 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 ->aDb[1].pSchema
143f0 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 = sqlite3Schema
14400 47 65 74 28 64 62 2c 20 30 29 3b 0a 0a 0a 20 20 Get(db, 0);...
14410 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 /* The default s
14420 61 66 65 74 79 5f 6c 65 76 65 6c 20 66 6f 72 20 afety_level for
14430 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 the main databas
14440 65 20 69 73 20 27 66 75 6c 6c 27 3b 20 66 6f 72 e is 'full'; for
14450 20 74 68 65 20 74 65 6d 70 0a 20 20 2a 2a 20 64 the temp. ** d
14460 61 74 61 62 61 73 65 20 69 74 20 69 73 20 27 4e atabase it is 'N
14470 4f 4e 45 27 2e 20 54 68 69 73 20 6d 61 74 63 68 ONE'. This match
14480 65 73 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 es the pager lay
14490 65 72 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 er defaults. .
144a0 20 2a 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d */. db->aDb[0]
144b0 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 22 3b .zName = "main";
144c0 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 73 61 . db->aDb[0].sa
144d0 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 33 3b 0a fety_level = 3;.
144e0 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 4e 61 db->aDb[1].zNa
144f0 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 20 20 64 me = "temp";. d
14500 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66 65 74 79 b->aDb[1].safety
14510 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a 0a 20 20 64 _level = 1;.. d
14520 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 b->magic = SQLIT
14530 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 E_MAGIC_OPEN;.
14540 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 if( db->mallocFa
14550 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 6f 74 6f iled ){. goto
14560 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d opendb_out;. }
14570 0a 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 .. /* Register
14580 61 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e all built-in fun
14590 63 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f 20 6e ctions, but do n
145a0 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 ot attempt to re
145b0 61 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 ad the. ** data
145c0 62 61 73 65 20 73 63 68 65 6d 61 20 79 65 74 2e base schema yet.
145d0 20 54 68 69 73 20 69 73 20 64 65 6c 61 79 65 64 This is delayed
145e0 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 until the first
145f0 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 time the databa
14600 73 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 65 73 se. ** is acces
14610 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 sed.. */. sqli
14620 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c te3Error(db, SQL
14630 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 73 71 ITE_OK, 0);. sq
14640 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 lite3RegisterBui
14650 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 ltinFunctions(db
14660 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 61 64 20 61 75 );.. /* Load au
14670 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 69 6f tomatic extensio
14680 6e 73 20 2d 20 65 78 74 65 6e 73 69 6f 6e 73 20 ns - extensions
14690 74 68 61 74 20 68 61 76 65 20 62 65 65 6e 20 72 that have been r
146a0 65 67 69 73 74 65 72 65 64 0a 20 20 2a 2a 20 75 egistered. ** u
146b0 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 sing the sqlite3
146c0 5f 61 75 74 6f 6d 61 74 69 63 5f 65 78 74 65 6e _automatic_exten
146d0 73 69 6f 6e 28 29 20 41 50 49 2e 0a 20 20 2a 2f sion() API.. */
146e0 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f . rc = sqlite3_
146f0 65 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 69 errcode(db);. i
14700 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
14710 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 41 ){. sqlite3A
14720 75 74 6f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e utoLoadExtension
14730 73 28 64 62 29 3b 0a 20 20 20 20 72 63 20 3d 20 s(db);. rc =
14740 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 sqlite3_errcode(
14750 64 62 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 db);. if( rc!
14760 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
14770 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f goto opendb_
14780 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a out;. }. }..
14790 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
147a0 41 42 4c 45 5f 46 54 53 31 0a 20 20 69 66 28 20 ABLE_FTS1. if(
147b0 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
147c0 64 20 29 7b 0a 20 20 20 20 65 78 74 65 72 6e 20 d ){. extern
147d0 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 31 49 int sqlite3Fts1I
147e0 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 20 nit(sqlite3*);.
147f0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 46 rc = sqlite3F
14800 74 73 31 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d ts1Init(db);. }
14810 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
14820 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 SQLITE_ENABLE_FT
14830 53 32 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 S2. if( !db->ma
14840 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 llocFailed && rc
14850 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
14860 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 extern int sq
14870 6c 69 74 65 33 46 74 73 32 49 6e 69 74 28 73 71 lite3Fts2Init(sq
14880 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 63 20 lite3*);. rc
14890 3d 20 73 71 6c 69 74 65 33 46 74 73 32 49 6e 69 = sqlite3Fts2Ini
148a0 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 t(db);. }.#endi
148b0 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
148c0 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a 20 20 69 _ENABLE_FTS3. i
148d0 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
148e0 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 iled && rc==SQLI
148f0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
14900 3d 20 73 71 6c 69 74 65 33 46 74 73 33 49 6e 69 = sqlite3Fts3Ini
14910 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 t(db);. }.#endi
14920 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
14930 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 20 20 69 66 _ENABLE_ICU. if
14940 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
14950 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 led && rc==SQLIT
14960 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d E_OK ){. rc =
14970 20 73 71 6c 69 74 65 33 49 63 75 49 6e 69 74 28 sqlite3IcuInit(
14980 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a db);. }.#endif.
14990 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
149a0 4e 41 42 4c 45 5f 52 54 52 45 45 0a 20 20 69 66 NABLE_RTREE. if
149b0 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
149c0 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 led && rc==SQLIT
149d0 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 20 3d 20 E_OK){. rc =
149e0 73 71 6c 69 74 65 33 52 74 72 65 65 49 6e 69 74 sqlite3RtreeInit
149f0 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 (db);. }.#endif
14a00 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 .. sqlite3Error
14a10 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 0a 20 20 (db, rc, 0);..
14a20 2f 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 /* -DSQLITE_DEFA
14a30 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 ULT_LOCKING_MODE
14a40 3d 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 49 =1 makes EXCLUSI
14a50 56 45 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c VE the default l
14a60 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 ocking. ** mode
14a70 2e 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 . -DSQLITE_DEFA
14a80 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 ULT_LOCKING_MODE
14a90 3d 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 74 =0 make NORMAL t
14aa0 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 he default locki
14ab0 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 44 ng. ** mode. D
14ac0 6f 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 20 oing nothing at
14ad0 61 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 4e all also makes N
14ae0 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c ORMAL the defaul
14af0 74 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 t.. */.#ifdef S
14b00 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f QLITE_DEFAULT_LO
14b10 43 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 2d CKING_MODE. db-
14b20 3e 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d 20 >dfltLockMode =
14b30 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c SQLITE_DEFAULT_L
14b40 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 73 OCKING_MODE;. s
14b50 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 6b 69 qlite3PagerLocki
14b60 6e 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 74 ngMode(sqlite3Bt
14b70 72 65 65 50 61 67 65 72 28 64 62 2d 3e 61 44 62 reePager(db->aDb
14b80 5b 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 20 [0].pBt),.
14b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14ba0 20 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 55 SQLITE_DEFAU
14bb0 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 29 LT_LOCKING_MODE)
14bc0 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 45 ;.#endif.. /* E
14bd0 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 73 nable the lookas
14be0 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 79 ide-malloc subsy
14bf0 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 70 4c stem */. setupL
14c00 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 2c 20 ookaside(db, 0,
14c10 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
14c20 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 2c fig.szLookaside,
14c30 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
14c40 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
14c50 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f GlobalConfig.nLo
14c60 6f 6b 61 73 69 64 65 29 3b 0a 0a 20 20 73 71 6c okaside);.. sql
14c70 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 ite3_wal_autoche
14c80 63 6b 70 6f 69 6e 74 28 64 62 2c 20 53 51 4c 49 ckpoint(db, SQLI
14c90 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f 41 TE_DEFAULT_WAL_A
14ca0 55 54 4f 43 48 45 43 4b 50 4f 49 4e 54 29 3b 0a UTOCHECKPOINT);.
14cb0 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 73 .opendb_out:. s
14cc0 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 4f 70 65 qlite3_free(zOpe
14cd0 6e 29 3b 0a 20 20 69 66 28 20 64 62 20 29 7b 0a n);. if( db ){.
14ce0 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e assert( db->
14cf0 6d 75 74 65 78 21 3d 30 20 7c 7c 20 69 73 54 68 mutex!=0 || isTh
14d00 72 65 61 64 73 61 66 65 3d 3d 30 20 7c 7c 20 73 readsafe==0 || s
14d10 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
14d20 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 3d 3d 30 ig.bFullMutex==0
14d30 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f );. sqlite3_
14d40 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
14d50 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 63 mutex);. }. rc
14d60 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f = sqlite3_errco
14d70 64 65 28 64 62 29 3b 0a 20 20 61 73 73 65 72 74 de(db);. assert
14d80 28 20 64 62 21 3d 30 20 7c 7c 20 72 63 3d 3d 53 ( db!=0 || rc==S
14d90 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 QLITE_NOMEM );.
14da0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
14db0 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 73 71 6c NOMEM ){. sql
14dc0 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a ite3_close(db);.
14dd0 20 20 20 20 64 62 20 3d 20 30 3b 0a 20 20 7d 65 db = 0;. }e
14de0 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 lse if( rc!=SQLI
14df0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d TE_OK ){. db-
14e00 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
14e10 4d 41 47 49 43 5f 53 49 43 4b 3b 0a 20 20 7d 0a MAGIC_SICK;. }.
14e20 20 20 2a 70 70 44 62 20 3d 20 64 62 3b 0a 23 69 *ppDb = db;.#i
14e30 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
14e40 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 69 66 28 20 LE_SQLLOG. if(
14e50 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
14e60 66 69 67 2e 78 53 71 6c 6c 6f 67 20 29 7b 0a 20 fig.xSqllog ){.
14e70 20 20 20 2f 2a 20 4f 70 65 6e 69 6e 67 20 61 20 /* Opening a
14e80 64 62 20 68 61 6e 64 6c 65 2e 20 46 6f 75 72 74 db handle. Fourt
14e90 68 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 70 h parameter is p
14ea0 61 73 73 65 64 20 30 2e 20 2a 2f 0a 20 20 20 20 assed 0. */.
14eb0 76 6f 69 64 20 2a 70 41 72 67 20 3d 20 73 71 6c void *pArg = sql
14ec0 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
14ed0 2e 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 20 20 20 .pSqllogArg;.
14ee0 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
14ef0 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 28 70 41 72 nfig.xSqllog(pAr
14f00 67 2c 20 64 62 2c 20 7a 46 69 6c 65 6e 61 6d 65 g, db, zFilename
14f10 2c 20 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 , 0);. }.#endif
14f20 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
14f30 33 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 3b 3ApiExit(0, rc);
14f40 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 .}../*.** Open a
14f50 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 68 61 new database ha
14f60 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ndle..*/.int sql
14f70 69 74 65 33 5f 6f 70 65 6e 28 0a 20 20 63 6f 6e ite3_open(. con
14f80 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 st char *zFilena
14f90 6d 65 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a me, . sqlite3 *
14fa0 2a 70 70 44 62 20 0a 29 7b 0a 20 20 72 65 74 75 *ppDb .){. retu
14fb0 72 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 rn openDatabase(
14fc0 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c zFilename, ppDb,
14fd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
14fe0 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
14ff0 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 53 EN_READWRITE | S
15000 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 QLITE_OPEN_CREAT
15010 45 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c E, 0);.}.int sql
15020 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 0a 20 20 ite3_open_v2(.
15030 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c 65 const char *file
15040 6e 61 6d 65 2c 20 20 20 2f 2a 20 44 61 74 61 62 name, /* Datab
15050 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 28 55 54 ase filename (UT
15060 46 2d 38 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 F-8) */. sqlite
15070 33 20 2a 2a 70 70 44 62 2c 20 20 20 20 20 20 20 3 **ppDb,
15080 20 20 2f 2a 20 4f 55 54 3a 20 53 51 4c 69 74 65 /* OUT: SQLite
15090 20 64 62 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 db handle */.
150a0 69 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 int flags,
150b0 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 /* Flags
150c0 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
150d0 20 2a 7a 56 66 73 20 20 20 20 20 20 20 20 2f 2a *zVfs /*
150e0 20 4e 61 6d 65 20 6f 66 20 56 46 53 20 6d 6f 64 Name of VFS mod
150f0 75 6c 65 20 74 6f 20 75 73 65 20 2a 2f 0a 29 7b ule to use */.){
15100 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 61 . return openDa
15110 74 61 62 61 73 65 28 66 69 6c 65 6e 61 6d 65 2c tabase(filename,
15120 20 70 70 44 62 2c 20 28 75 6e 73 69 67 6e 65 64 ppDb, (unsigned
15130 20 69 6e 74 29 66 6c 61 67 73 2c 20 7a 56 66 73 int)flags, zVfs
15140 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 );.}..#ifndef SQ
15150 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
15160 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 /*.** Open a new
15170 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
15180 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
15190 5f 6f 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 _open16(. const
151a0 20 76 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 void *zFilename
151b0 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 , . sqlite3 **p
151c0 70 44 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f pDb.){. char co
151d0 6e 73 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b nst *zFilename8;
151e0 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 /* zFilename
151f0 65 6e 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 encoded in UTF-8
15200 20 69 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d instead of UTF-
15210 31 36 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 16 */. sqlite3_
15220 76 61 6c 75 65 20 2a 70 56 61 6c 3b 0a 20 20 69 value *pVal;. i
15230 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
15240 28 20 7a 46 69 6c 65 6e 61 6d 65 20 29 3b 0a 20 ( zFilename );.
15250 20 61 73 73 65 72 74 28 20 70 70 44 62 20 29 3b assert( ppDb );
15260 0a 20 20 2a 70 70 44 62 20 3d 20 30 3b 0a 23 69 . *ppDb = 0;.#i
15270 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
15280 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 63 20 T_AUTOINIT. rc
15290 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 = sqlite3_initia
152a0 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 72 63 lize();. if( rc
152b0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 ) return rc;.#e
152c0 6e 64 69 66 0a 20 20 70 56 61 6c 20 3d 20 73 71 ndif. pVal = sq
152d0 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 30 29 lite3ValueNew(0)
152e0 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 ;. sqlite3Value
152f0 53 65 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c SetStr(pVal, -1,
15300 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 zFilename, SQLI
15310 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 TE_UTF16NATIVE,
15320 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a SQLITE_STATIC);.
15330 20 20 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 zFilename8 = s
15340 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 qlite3ValueText(
15350 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 pVal, SQLITE_UTF
15360 38 29 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 8);. if( zFilen
15370 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d ame8 ){. rc =
15380 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 openDatabase(zF
15390 69 6c 65 6e 61 6d 65 38 2c 20 70 70 44 62 2c 0a ilename8, ppDb,.
153a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
153b0 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
153c0 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 53 51 N_READWRITE | SQ
153d0 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 LITE_OPEN_CREATE
153e0 2c 20 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 , 0);. assert
153f0 28 20 2a 70 70 44 62 20 7c 7c 20 72 63 3d 3d 53 ( *ppDb || rc==S
15400 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 QLITE_NOMEM );.
15410 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
15420 45 5f 4f 4b 20 26 26 20 21 44 62 48 61 73 50 72 E_OK && !DbHasPr
15430 6f 70 65 72 74 79 28 2a 70 70 44 62 2c 20 30 2c operty(*ppDb, 0,
15440 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 DB_SchemaLoaded
15450 29 20 29 7b 0a 20 20 20 20 20 20 45 4e 43 28 2a ) ){. ENC(*
15460 70 70 44 62 29 20 3d 20 53 51 4c 49 54 45 5f 55 ppDb) = SQLITE_U
15470 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 TF16NATIVE;.
15480 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 }. }else{. r
15490 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
154a0 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 ;. }. sqlite3V
154b0 61 6c 75 65 46 72 65 65 28 70 56 61 6c 29 3b 0a alueFree(pVal);.
154c0 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
154d0 33 41 70 69 45 78 69 74 28 30 2c 20 72 63 29 3b 3ApiExit(0, rc);
154e0 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
154f0 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a ITE_OMIT_UTF16 *
15500 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 /../*.** Registe
15510 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f r a new collatio
15520 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 n sequence with
15530 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e the database han
15540 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 dle db..*/.int s
15550 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
15560 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 llation(. sqlit
15570 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 e3* db, . const
15580 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 char *zName, .
15590 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 int enc, . voi
155a0 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a d* pCtx,. int(*
155b0 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c xCompare)(void*,
155c0 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
155d0 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 int,const void*)
155e0 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 .){. int rc;.
155f0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
15600 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
15610 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d assert( !db->m
15620 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 allocFailed );.
15630 20 72 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c rc = createColl
15640 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c ation(db, zName,
15650 20 28 75 38 29 65 6e 63 2c 20 70 43 74 78 2c 20 (u8)enc, pCtx,
15660 78 43 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 20 20 xCompare, 0);.
15670 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 rc = sqlite3ApiE
15680 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 xit(db, rc);. s
15690 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
156a0 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
156b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
156c0 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
156d0 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 new collation se
156e0 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 20 quence with the
156f0 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
15700 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 db..*/.int sqlit
15710 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 e3_create_collat
15720 69 6f 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 ion_v2(. sqlite
15730 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 3* db, . const
15740 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 char *zName, .
15750 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 int enc, . void
15760 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 * pCtx,. int(*x
15770 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 Compare)(void*,i
15780 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 nt,const void*,i
15790 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 2c nt,const void*),
157a0 0a 20 20 76 6f 69 64 28 2a 78 44 65 6c 29 28 76 . void(*xDel)(v
157b0 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 oid*).){. int r
157c0 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 c;. sqlite3_mut
157d0 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
157e0 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 ex);. assert( !
157f0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
15800 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 61 74 );. rc = creat
15810 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a eCollation(db, z
15820 4e 61 6d 65 2c 20 28 75 38 29 65 6e 63 2c 20 70 Name, (u8)enc, p
15830 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 78 Ctx, xCompare, x
15840 44 65 6c 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c Del);. rc = sql
15850 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 ite3ApiExit(db,
15860 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc);. sqlite3_m
15870 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
15880 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
15890 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 rc;.}..#ifndef S
158a0 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
158b0 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
158c0 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 a new collation
158d0 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 sequence with th
158e0 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c e database handl
158f0 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c e db..*/.int sql
15900 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
15910 61 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 ation16(. sqlit
15920 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 e3* db, . const
15930 20 76 6f 69 64 20 2a 7a 4e 61 6d 65 2c 0a 20 20 void *zName,.
15940 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 int enc, . void
15950 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 * pCtx,. int(*x
15960 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 Compare)(void*,i
15970 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 nt,const void*,i
15980 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a nt,const void*).
15990 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
159a0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 68 61 72 20 LITE_OK;. char
159b0 2a 7a 4e 61 6d 65 38 3b 0a 20 20 73 71 6c 69 74 *zName8;. sqlit
159c0 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
159d0 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 b->mutex);. ass
159e0 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 ert( !db->malloc
159f0 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 4e 61 6d Failed );. zNam
15a00 65 38 20 3d 20 73 71 6c 69 74 65 33 55 74 66 31 e8 = sqlite3Utf1
15a10 36 74 6f 38 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6to8(db, zName,
15a20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 -1, SQLITE_UTF16
15a30 4e 41 54 49 56 45 29 3b 0a 20 20 69 66 28 20 7a NATIVE);. if( z
15a40 4e 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 20 Name8 ){. rc
15a50 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f = createCollatio
15a60 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c 20 28 75 n(db, zName8, (u
15a70 38 29 65 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 8)enc, pCtx, xCo
15a80 6d 70 61 72 65 2c 20 30 29 3b 0a 20 20 20 20 73 mpare, 0);. s
15a90 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
15aa0 20 7a 4e 61 6d 65 38 29 3b 0a 20 20 7d 0a 20 20 zName8);. }.
15ab0 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 rc = sqlite3ApiE
15ac0 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 xit(db, rc);. s
15ad0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
15ae0 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
15af0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 return rc;.}.#e
15b00 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
15b10 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a MIT_UTF16 */../*
15b20 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
15b30 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
15b40 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 e factory callba
15b50 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ck with the data
15b60 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 base handle.** d
15b70 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 b. Replace any p
15b80 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c reviously instal
15b90 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 led collation se
15ba0 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a quence factory..
15bb0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
15bc0 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 ollation_needed(
15bd0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
15be0 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 . void *pCollNe
15bf0 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 ededArg, . void
15c00 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 (*xCollNeeded)(v
15c10 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e oid*,sqlite3*,in
15c20 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 t eTextRep,const
15c30 20 63 68 61 72 2a 29 0a 29 7b 0a 20 20 73 71 6c char*).){. sql
15c40 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
15c50 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 (db->mutex);. d
15c60 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d b->xCollNeeded =
15c70 20 78 43 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 xCollNeeded;.
15c80 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 db->xCollNeeded1
15c90 36 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6 = 0;. db->pCo
15ca0 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20 70 43 llNeededArg = pC
15cb0 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 ollNeededArg;.
15cc0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
15cd0 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
15ce0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
15cf0 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 OK;.}..#ifndef S
15d00 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
15d10 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
15d20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 a collation sequ
15d30 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c ence factory cal
15d40 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20 64 lback with the d
15d50 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a atabase handle.*
15d60 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e * db. Replace an
15d70 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 y previously ins
15d80 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e talled collation
15d90 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 sequence factor
15da0 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 y..*/.int sqlite
15db0 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 3_collation_need
15dc0 65 64 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 ed16(. sqlite3
15dd0 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 *db, . void *pC
15de0 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 ollNeededArg, .
15df0 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 void(*xCollNeed
15e00 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 ed16)(void*,sqli
15e10 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 te3*,int eTextRe
15e20 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 p,const void*).)
15e30 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 {. sqlite3_mute
15e40 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
15e50 78 29 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e x);. db->xCollN
15e60 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d eeded = 0;. db-
15e70 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d >xCollNeeded16 =
15e80 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a xCollNeeded16;.
15e90 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 db->pCollNeede
15ea0 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 dArg = pCollNeed
15eb0 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 edArg;. sqlite3
15ec0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
15ed0 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
15ee0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
15ef0 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
15f00 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 OMIT_UTF16 */..#
15f10 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
15f20 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a IT_DEPRECATED./*
15f30 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
15f40 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 n is now an anac
15f50 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 hronism. It used
15f60 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 to be used to r
15f70 65 63 6f 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a ecover from a.**
15f80 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 malloc() failur
15f90 65 2c 20 62 75 74 20 53 51 4c 69 74 65 20 6e 6f e, but SQLite no
15fa0 77 20 64 6f 65 73 20 74 68 69 73 20 61 75 74 6f w does this auto
15fb0 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e matically..*/.in
15fc0 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c t sqlite3_global
15fd0 5f 72 65 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a _recover(void){.
15fe0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
15ff0 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a OK;.}.#endif../*
16000 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 .** Test to see
16010 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 whether or not t
16020 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e he database conn
16030 65 63 74 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 ection is in aut
16040 6f 63 6f 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e ocommit.** mode.
16050 20 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 Return TRUE if
16060 20 69 74 20 69 73 20 61 6e 64 20 46 41 4c 53 45 it is and FALSE
16070 20 69 66 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f if not. Autoco
16080 6d 6d 69 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a mmit mode is on.
16090 2a 2a 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 ** by default.
160a0 41 75 74 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 Autocommit is di
160b0 73 61 62 6c 65 64 20 62 79 20 61 20 42 45 47 49 sabled by a BEGI
160c0 4e 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 N statement and
160d0 72 65 65 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 reenabled.** by
160e0 74 68 65 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 the next COMMIT
160f0 6f 72 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2f 0a or ROLLBACK..*/.
16100 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 65 74 5f int sqlite3_get_
16110 61 75 74 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 autocommit(sqlit
16120 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 e3 *db){. retur
16130 6e 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 n db->autoCommit
16140 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 ;.}../*.** The f
16150 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 ollowing routine
16160 73 20 61 72 65 20 73 75 62 74 69 74 75 74 65 73 s are subtitutes
16170 20 66 6f 72 20 63 6f 6e 73 74 61 6e 74 73 20 53 for constants S
16180 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c 0a 2a QLITE_CORRUPT,.*
16190 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c * SQLITE_MISUSE,
161a0 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
161b0 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 61 , SQLITE_IOERR a
161c0 6e 64 20 70 6f 73 73 69 62 6c 79 20 6f 74 68 65 nd possibly othe
161d0 72 20 65 72 72 6f 72 0a 2a 2a 20 63 6f 6e 73 74 r error.** const
161e0 61 6e 74 73 2e 20 20 54 68 65 79 20 73 65 72 76 ants. They serv
161f0 65 72 20 74 77 6f 20 70 75 72 70 6f 73 65 73 3a er two purposes:
16200 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 20 53 65 72 .**.** 1. Ser
16210 76 65 20 61 73 20 61 20 63 6f 6e 76 65 6e 69 65 ve as a convenie
16220 6e 74 20 70 6c 61 63 65 20 74 6f 20 73 65 74 20 nt place to set
16230 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 69 6e 20 a breakpoint in
16240 61 20 64 65 62 75 67 67 65 72 0a 2a 2a 20 20 20 a debugger.**
16250 20 20 20 20 74 6f 20 64 65 74 65 63 74 20 77 68 to detect wh
16260 65 6e 20 76 65 72 73 69 6f 6e 20 65 72 72 6f 72 en version error
16270 20 63 6f 6e 64 69 74 69 6f 6e 73 20 6f 63 63 75 conditions occu
16280 72 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 20 rs..**.** 2.
16290 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 5f 6c Invoke sqlite3_l
162a0 6f 67 28 29 20 74 6f 20 70 72 6f 76 69 64 65 20 og() to provide
162b0 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 the source code
162c0 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 0a 2a location where.*
162d0 2a 20 20 20 20 20 20 20 61 20 6c 6f 77 2d 6c 65 * a low-le
162e0 76 65 6c 20 65 72 72 6f 72 20 69 73 20 66 69 72 vel error is fir
162f0 73 74 20 64 65 74 65 63 74 65 64 2e 0a 2a 2f 0a st detected..*/.
16300 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 int sqlite3Corru
16310 70 74 45 72 72 6f 72 28 69 6e 74 20 6c 69 6e 65 ptError(int line
16320 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 65 28 no){. testcase(
16330 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
16340 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a nfig.xLog!=0 );.
16350 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 51 sqlite3_log(SQ
16360 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c 0a 20 20 LITE_CORRUPT,.
16370 20 20 20 20 20 20 20 20 20 20 20 20 22 64 61 74 "dat
16380 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e abase corruption
16390 20 61 74 20 6c 69 6e 65 20 25 64 20 6f 66 20 5b at line %d of [
163a0 25 2e 31 30 73 5d 22 2c 0a 20 20 20 20 20 20 20 %.10s]",.
163b0 20 20 20 20 20 20 20 6c 69 6e 65 6e 6f 2c 20 32 lineno, 2
163c0 30 2b 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 0+sqlite3_source
163d0 69 64 28 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 id());. return
163e0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a SQLITE_CORRUPT;.
163f0 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 69 73 }.int sqlite3Mis
16400 75 73 65 45 72 72 6f 72 28 69 6e 74 20 6c 69 6e useError(int lin
16410 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 65 eno){. testcase
16420 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
16430 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 3b onfig.xLog!=0 );
16440 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 . sqlite3_log(S
16450 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 0a 20 QLITE_MISUSE, .
16460 20 20 20 20 20 20 20 20 20 20 20 20 20 22 6d 69 "mi
16470 73 75 73 65 20 61 74 20 6c 69 6e 65 20 25 64 20 suse at line %d
16480 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 20 20 of [%.10s]",.
16490 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e 65 6e linen
164a0 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f 73 6f o, 20+sqlite3_so
164b0 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 65 74 urceid());. ret
164c0 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
164d0 45 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 E;.}.int sqlite3
164e0 43 61 6e 74 6f 70 65 6e 45 72 72 6f 72 28 69 6e CantopenError(in
164f0 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 t lineno){. tes
16500 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c tcase( sqlite3Gl
16510 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 obalConfig.xLog!
16520 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f =0 );. sqlite3_
16530 6c 6f 67 28 53 51 4c 49 54 45 5f 43 41 4e 54 4f log(SQLITE_CANTO
16540 50 45 4e 2c 20 0a 20 20 20 20 20 20 20 20 20 20 PEN, .
16550 20 20 20 20 22 63 61 6e 6e 6f 74 20 6f 70 65 6e "cannot open
16560 20 66 69 6c 65 20 61 74 20 6c 69 6e 65 20 25 64 file at line %d
16570 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 20 of [%.10s]",.
16580 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e 65 line
16590 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f 73 no, 20+sqlite3_s
165a0 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 65 ourceid());. re
165b0 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 turn SQLITE_CANT
165c0 4f 50 45 4e 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 OPEN;.}...#ifnde
165d0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 f SQLITE_OMIT_DE
165e0 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 PRECATED./*.** T
165f0 68 69 73 20 69 73 20 61 20 63 6f 6e 76 65 6e 69 his is a conveni
16600 65 6e 63 65 20 72 6f 75 74 69 6e 65 20 74 68 61 ence routine tha
16610 74 20 6d 61 6b 65 73 20 73 75 72 65 20 74 68 61 t makes sure tha
16620 74 20 61 6c 6c 20 74 68 72 65 61 64 2d 73 70 65 t all thread-spe
16630 63 69 66 69 63 0a 2a 2a 20 64 61 74 61 20 66 6f cific.** data fo
16640 72 20 74 68 69 73 20 74 68 72 65 61 64 20 68 61 r this thread ha
16650 73 20 62 65 65 6e 20 64 65 61 6c 6c 6f 63 61 74 s been deallocat
16660 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 ed..**.** SQLite
16670 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73 65 73 20 no longer uses
16680 74 68 72 65 61 64 2d 73 70 65 63 69 66 69 63 20 thread-specific
16690 64 61 74 61 20 73 6f 20 74 68 69 73 20 72 6f 75 data so this rou
166a0 74 69 6e 65 20 69 73 20 6e 6f 77 20 61 0a 2a 2a tine is now a.**
166b0 20 6e 6f 2d 6f 70 2e 20 20 49 74 20 69 73 20 72 no-op. It is r
166c0 65 74 61 69 6e 65 64 20 66 6f 72 20 68 69 73 74 etained for hist
166d0 6f 72 69 63 61 6c 20 63 6f 6d 70 61 74 69 62 69 orical compatibi
166e0 6c 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 lity..*/.void sq
166f0 6c 69 74 65 33 5f 74 68 72 65 61 64 5f 63 6c 65 lite3_thread_cle
16700 61 6e 75 70 28 76 6f 69 64 29 7b 0a 7d 0a 23 65 anup(void){.}.#e
16710 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ndif../*.** Retu
16720 72 6e 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 rn meta informat
16730 69 6f 6e 20 61 62 6f 75 74 20 61 20 73 70 65 63 ion about a spec
16740 69 66 69 63 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 ific column of a
16750 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e database table.
16760 0a 2a 2a 20 53 65 65 20 63 6f 6d 6d 65 6e 74 20 .** See comment
16770 69 6e 20 73 71 6c 69 74 65 33 2e 68 20 28 73 71 in sqlite3.h (sq
16780 6c 69 74 65 2e 68 2e 69 6e 29 20 66 6f 72 20 64 lite.h.in) for d
16790 65 74 61 69 6c 73 2e 0a 2a 2f 0a 23 69 66 64 65 etails..*/.#ifde
167a0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
167b0 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 0a COLUMN_METADATA.
167c0 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 61 62 6c int sqlite3_tabl
167d0 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 e_column_metadat
167e0 61 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 a(. sqlite3 *db
167f0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
16800 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 68 /* Connection h
16810 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 andle */. const
16820 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 2c 20 char *zDbName,
16830 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
16840 73 65 20 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c 20 se name or NULL
16850 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
16860 2a 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 20 20 20 *zTableName,
16870 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20 2a /* Table name *
16880 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
16890 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 20 zColumnName,
168a0 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 2a /* Column name *
168b0 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a /. char const *
168c0 2a 70 7a 44 61 74 61 54 79 70 65 2c 20 20 20 20 *pzDataType,
168d0 2f 2a 20 4f 55 54 50 55 54 3a 20 44 65 63 6c 61 /* OUTPUT: Decla
168e0 72 65 64 20 64 61 74 61 20 74 79 70 65 20 2a 2f red data type */
168f0 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a . char const **
16900 70 7a 43 6f 6c 6c 53 65 71 2c 20 20 20 20 20 2f pzCollSeq, /
16910 2a 20 4f 55 54 50 55 54 3a 20 43 6f 6c 6c 61 74 * OUTPUT: Collat
16920 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 6e 61 6d ion sequence nam
16930 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f 74 e */. int *pNot
16940 4e 75 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Null,
16950 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 /* OUTPUT: Tr
16960 75 65 20 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 63 ue if NOT NULL c
16970 6f 6e 73 74 72 61 69 6e 74 20 65 78 69 73 74 73 onstraint exists
16980 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 50 72 69 6d */. int *pPrim
16990 61 72 79 4b 65 79 2c 20 20 20 20 20 20 20 20 20 aryKey,
169a0 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 /* OUTPUT: Tru
169b0 65 20 69 66 20 63 6f 6c 75 6d 6e 20 70 61 72 74 e if column part
169c0 20 6f 66 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 20 of PK */. int
169d0 2a 70 41 75 74 6f 69 6e 63 20 20 20 20 20 20 20 *pAutoinc
169e0 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 /* OUTPU
169f0 54 3a 20 54 72 75 65 20 69 66 20 63 6f 6c 75 6d T: True if colum
16a00 6e 20 69 73 20 61 75 74 6f 2d 69 6e 63 72 65 6d n is auto-increm
16a10 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ent */.){. int
16a20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 rc;. char *zErr
16a30 4d 73 67 20 3d 20 30 3b 0a 20 20 54 61 62 6c 65 Msg = 0;. Table
16a40 20 2a 70 54 61 62 20 3d 20 30 3b 0a 20 20 43 6f *pTab = 0;. Co
16a50 6c 75 6d 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b 0a lumn *pCol = 0;.
16a60 20 20 69 6e 74 20 69 43 6f 6c 3b 0a 0a 20 20 63 int iCol;.. c
16a70 68 61 72 20 63 6f 6e 73 74 20 2a 7a 44 61 74 61 har const *zData
16a80 54 79 70 65 20 3d 20 30 3b 0a 20 20 63 68 61 72 Type = 0;. char
16a90 20 63 6f 6e 73 74 20 2a 7a 43 6f 6c 6c 53 65 71 const *zCollSeq
16aa0 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 6f 74 6e = 0;. int notn
16ab0 75 6c 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 70 ull = 0;. int p
16ac0 72 69 6d 61 72 79 6b 65 79 20 3d 20 30 3b 0a 20 rimarykey = 0;.
16ad0 20 69 6e 74 20 61 75 74 6f 69 6e 63 20 3d 20 30 int autoinc = 0
16ae0 3b 0a 0a 20 20 2f 2a 20 45 6e 73 75 72 65 20 74 ;.. /* Ensure t
16af0 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 he database sche
16b00 6d 61 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 ma has been load
16b10 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ed */. sqlite3_
16b20 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
16b30 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 mutex);. sqlite
16b40 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 3BtreeEnterAll(d
16b50 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 b);. rc = sqlit
16b60 65 33 49 6e 69 74 28 64 62 2c 20 26 7a 45 72 72 e3Init(db, &zErr
16b70 4d 73 67 29 3b 0a 20 20 69 66 28 20 53 51 4c 49 Msg);. if( SQLI
16b80 54 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 TE_OK!=rc ){.
16b90 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b goto error_out;
16ba0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4c 6f 63 61 74 . }.. /* Locat
16bb0 65 20 74 68 65 20 74 61 62 6c 65 20 69 6e 20 71 e the table in q
16bc0 75 65 73 74 69 6f 6e 20 2a 2f 0a 20 20 70 54 61 uestion */. pTa
16bd0 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54 b = sqlite3FindT
16be0 61 62 6c 65 28 64 62 2c 20 7a 54 61 62 6c 65 4e able(db, zTableN
16bf0 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a 20 ame, zDbName);.
16c00 20 69 66 28 20 21 70 54 61 62 20 7c 7c 20 70 54 if( !pTab || pT
16c10 61 62 2d 3e 70 53 65 6c 65 63 74 20 29 7b 0a 20 ab->pSelect ){.
16c20 20 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 pTab = 0;.
16c30 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b goto error_out;
16c40 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 6e 64 20 . }.. /* Find
16c50 74 68 65 20 63 6f 6c 75 6d 6e 20 66 6f 72 20 77 the column for w
16c60 68 69 63 68 20 69 6e 66 6f 20 69 73 20 72 65 71 hich info is req
16c70 75 65 73 74 65 64 20 2a 2f 0a 20 20 69 66 28 20 uested */. if(
16c80 73 71 6c 69 74 65 33 49 73 52 6f 77 69 64 28 7a sqlite3IsRowid(z
16c90 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a 20 ColumnName) ){.
16ca0 20 20 20 69 43 6f 6c 20 3d 20 70 54 61 62 2d 3e iCol = pTab->
16cb0 69 50 4b 65 79 3b 0a 20 20 20 20 69 66 28 20 69 iPKey;. if( i
16cc0 43 6f 6c 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 Col>=0 ){.
16cd0 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 pCol = &pTab->aC
16ce0 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 7d 0a ol[iCol];. }.
16cf0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 66 6f 72 }else{. for
16d00 28 69 43 6f 6c 3d 30 3b 20 69 43 6f 6c 3c 70 54 (iCol=0; iCol<pT
16d10 61 62 2d 3e 6e 43 6f 6c 3b 20 69 43 6f 6c 2b 2b ab->nCol; iCol++
16d20 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 ){. pCol =
16d30 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c &pTab->aCol[iCol
16d40 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d ];. if( 0==
16d50 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 70 sqlite3StrICmp(p
16d60 43 6f 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 6f 6c Col->zName, zCol
16d70 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 umnName) ){.
16d80 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
16d90 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 }. }. if(
16da0 20 69 43 6f 6c 3d 3d 70 54 61 62 2d 3e 6e 43 6f iCol==pTab->nCo
16db0 6c 20 29 7b 0a 20 20 20 20 20 20 70 54 61 62 20 l ){. pTab
16dc0 3d 20 30 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 = 0;. goto
16dd0 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 7d error_out;. }
16de0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 66 . }.. /* The f
16df0 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 73 ollowing block s
16e00 74 6f 72 65 73 20 74 68 65 20 6d 65 74 61 20 69 tores the meta i
16e10 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20 nformation that
16e20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 will be returned
16e30 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 63 61 6c . ** to the cal
16e40 6c 65 72 20 69 6e 20 6c 6f 63 61 6c 20 76 61 72 ler in local var
16e50 69 61 62 6c 65 73 20 7a 44 61 74 61 54 79 70 65 iables zDataType
16e60 2c 20 7a 43 6f 6c 6c 53 65 71 2c 20 6e 6f 74 6e , zCollSeq, notn
16e70 75 6c 6c 2c 20 70 72 69 6d 61 72 79 6b 65 79 0a ull, primarykey.
16e80 20 20 2a 2a 20 61 6e 64 20 61 75 74 6f 69 6e 63 ** and autoinc
16e90 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 . At this point
16ea0 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 6f there are two po
16eb0 73 73 69 62 69 6c 69 74 69 65 73 3a 0a 20 20 2a ssibilities:. *
16ec0 2a 20 0a 20 20 2a 2a 20 20 20 20 20 31 2e 20 54 * . ** 1. T
16ed0 68 65 20 73 70 65 63 69 66 69 65 64 20 63 6f 6c he specified col
16ee0 75 6d 6e 20 6e 61 6d 65 20 77 61 73 20 72 6f 77 umn name was row
16ef0 69 64 22 2c 20 22 6f 69 64 22 20 6f 72 20 22 5f id", "oid" or "_
16f00 72 6f 77 69 64 5f 22 20 0a 20 20 2a 2a 20 20 20 rowid_" . **
16f10 20 20 20 20 20 61 6e 64 20 74 68 65 72 65 20 69 and there i
16f20 73 20 6e 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 s no explicitly
16f30 64 65 63 6c 61 72 65 64 20 49 50 4b 20 63 6f 6c declared IPK col
16f40 75 6d 6e 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 umn. . **. **
16f50 20 20 20 20 32 2e 20 54 68 65 20 74 61 62 6c 65 2. The table
16f60 20 69 73 20 6e 6f 74 20 61 20 76 69 65 77 20 61 is not a view a
16f70 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 nd the column na
16f80 6d 65 20 69 64 65 6e 74 69 66 69 65 64 20 61 6e me identified an
16f90 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 65 78 . ** ex
16fa0 70 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 72 65 plicitly declare
16fb0 64 20 63 6f 6c 75 6d 6e 2e 20 43 6f 70 79 20 6d d column. Copy m
16fc0 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 eta information
16fd0 66 72 6f 6d 20 2a 70 43 6f 6c 2e 0a 20 20 2a 2f from *pCol.. */
16fe0 20 0a 20 20 69 66 28 20 70 43 6f 6c 20 29 7b 0a . if( pCol ){.
16ff0 20 20 20 20 7a 44 61 74 61 54 79 70 65 20 3d 20 zDataType =
17000 70 43 6f 6c 2d 3e 7a 54 79 70 65 3b 0a 20 20 20 pCol->zType;.
17010 20 7a 43 6f 6c 6c 53 65 71 20 3d 20 70 43 6f 6c zCollSeq = pCol
17020 2d 3e 7a 43 6f 6c 6c 3b 0a 20 20 20 20 6e 6f 74 ->zColl;. not
17030 6e 75 6c 6c 20 3d 20 70 43 6f 6c 2d 3e 6e 6f 74 null = pCol->not
17040 4e 75 6c 6c 21 3d 30 3b 0a 20 20 20 20 70 72 69 Null!=0;. pri
17050 6d 61 72 79 6b 65 79 20 20 3d 20 28 70 43 6f 6c marykey = (pCol
17060 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c ->colFlags & COL
17070 46 4c 41 47 5f 50 52 49 4d 4b 45 59 29 21 3d 30 FLAG_PRIMKEY)!=0
17080 3b 0a 20 20 20 20 61 75 74 6f 69 6e 63 20 3d 20 ;. autoinc =
17090 70 54 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f pTab->iPKey==iCo
170a0 6c 20 26 26 20 28 70 54 61 62 2d 3e 74 61 62 46 l && (pTab->tabF
170b0 6c 61 67 73 20 26 20 54 46 5f 41 75 74 6f 69 6e lags & TF_Autoin
170c0 63 72 65 6d 65 6e 74 29 21 3d 30 3b 0a 20 20 7d crement)!=0;. }
170d0 65 6c 73 65 7b 0a 20 20 20 20 7a 44 61 74 61 54 else{. zDataT
170e0 79 70 65 20 3d 20 22 49 4e 54 45 47 45 52 22 3b ype = "INTEGER";
170f0 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 79 20 . primarykey
17100 3d 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 = 1;. }. if( !
17110 7a 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20 20 zCollSeq ){.
17120 7a 43 6f 6c 6c 53 65 71 20 3d 20 22 42 49 4e 41 zCollSeq = "BINA
17130 52 59 22 3b 0a 20 20 7d 0a 0a 65 72 72 6f 72 5f RY";. }..error_
17140 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 out:. sqlite3Bt
17150 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 3b reeLeaveAll(db);
17160 0a 0a 20 20 2f 2a 20 57 68 65 74 68 65 72 20 74 .. /* Whether t
17170 68 65 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c he function call
17180 20 73 75 63 63 65 65 64 65 64 20 6f 72 20 66 61 succeeded or fa
17190 69 6c 65 64 2c 20 73 65 74 20 74 68 65 20 6f 75 iled, set the ou
171a0 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 73 0a tput parameters.
171b0 20 20 2a 2a 20 74 6f 20 77 68 61 74 65 76 65 72 ** to whatever
171c0 20 74 68 65 69 72 20 6c 6f 63 61 6c 20 63 6f 75 their local cou
171d0 6e 74 65 72 70 61 72 74 73 20 63 6f 6e 74 61 69 nterparts contai
171e0 6e 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 64 n. If an error d
171f0 69 64 20 6f 63 63 75 72 2c 0a 20 20 2a 2a 20 74 id occur,. ** t
17200 68 69 73 20 68 61 73 20 74 68 65 20 65 66 66 65 his has the effe
17210 63 74 20 6f 66 20 7a 65 72 6f 69 6e 67 20 61 6c ct of zeroing al
17220 6c 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 74 l output paramet
17230 65 72 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ers.. */. if(
17240 70 7a 44 61 74 61 54 79 70 65 20 29 20 2a 70 7a pzDataType ) *pz
17250 44 61 74 61 54 79 70 65 20 3d 20 7a 44 61 74 61 DataType = zData
17260 54 79 70 65 3b 0a 20 20 69 66 28 20 70 7a 43 6f Type;. if( pzCo
17270 6c 6c 53 65 71 20 29 20 2a 70 7a 43 6f 6c 6c 53 llSeq ) *pzCollS
17280 65 71 20 3d 20 7a 43 6f 6c 6c 53 65 71 3b 0a 20 eq = zCollSeq;.
17290 20 69 66 28 20 70 4e 6f 74 4e 75 6c 6c 20 29 20 if( pNotNull )
172a0 2a 70 4e 6f 74 4e 75 6c 6c 20 3d 20 6e 6f 74 6e *pNotNull = notn
172b0 75 6c 6c 3b 0a 20 20 69 66 28 20 70 50 72 69 6d ull;. if( pPrim
172c0 61 72 79 4b 65 79 20 29 20 2a 70 50 72 69 6d 61 aryKey ) *pPrima
172d0 72 79 4b 65 79 20 3d 20 70 72 69 6d 61 72 79 6b ryKey = primaryk
172e0 65 79 3b 0a 20 20 69 66 28 20 70 41 75 74 6f 69 ey;. if( pAutoi
172f0 6e 63 20 29 20 2a 70 41 75 74 6f 69 6e 63 20 3d nc ) *pAutoinc =
17300 20 61 75 74 6f 69 6e 63 3b 0a 0a 20 20 69 66 28 autoinc;.. if(
17310 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 72 63 20 26 SQLITE_OK==rc &
17320 26 20 21 70 54 61 62 20 29 7b 0a 20 20 20 20 73 & !pTab ){. s
17330 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
17340 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 7a zErrMsg);. z
17350 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 ErrMsg = sqlite3
17360 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6e 6f 20 MPrintf(db, "no
17370 73 75 63 68 20 74 61 62 6c 65 20 63 6f 6c 75 6d such table colum
17380 6e 3a 20 25 73 2e 25 73 22 2c 20 7a 54 61 62 6c n: %s.%s", zTabl
17390 65 4e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 7a eName,. z
173a0 43 6f 6c 75 6d 6e 4e 61 6d 65 29 3b 0a 20 20 20 ColumnName);.
173b0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
173c0 4f 52 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 OR;. }. sqlite
173d0 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 28 3Error(db, rc, (
173e0 7a 45 72 72 4d 73 67 3f 22 25 73 22 3a 30 29 2c zErrMsg?"%s":0),
173f0 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 73 71 6c zErrMsg);. sql
17400 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a ite3DbFree(db, z
17410 45 72 72 4d 73 67 29 3b 0a 20 20 72 63 20 3d 20 ErrMsg);. rc =
17420 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
17430 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 b, rc);. sqlite
17440 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
17450 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
17460 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a rn rc;.}.#endif.
17470 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72 ./*.** Sleep for
17480 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e a little while.
17490 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f Return the amo
174a0 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 70 unt of time slep
174b0 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
174c0 33 5f 73 6c 65 65 70 28 69 6e 74 20 6d 73 29 7b 3_sleep(int ms){
174d0 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
174e0 70 56 66 73 3b 0a 20 20 69 6e 74 20 72 63 3b 0a pVfs;. int rc;.
174f0 20 20 70 56 66 73 20 3d 20 73 71 6c 69 74 65 33 pVfs = sqlite3
17500 5f 76 66 73 5f 66 69 6e 64 28 30 29 3b 0a 20 20 _vfs_find(0);.
17510 69 66 28 20 70 56 66 73 3d 3d 30 20 29 20 72 65 if( pVfs==0 ) re
17520 74 75 72 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 turn 0;.. /* Th
17530 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b is function work
17540 73 20 69 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 s in millisecond
17550 73 2c 20 62 75 74 20 74 68 65 20 75 6e 64 65 72 s, but the under
17560 6c 79 69 6e 67 20 4f 73 53 6c 65 65 70 28 29 20 lying OsSleep()
17570 0a 20 20 2a 2a 20 41 50 49 20 75 73 65 73 20 6d . ** API uses m
17580 69 63 72 6f 73 65 63 6f 6e 64 73 2e 20 48 65 6e icroseconds. Hen
17590 63 65 20 74 68 65 20 31 30 30 30 27 73 2e 0a 20 ce the 1000's..
175a0 20 2a 2f 0a 20 20 72 63 20 3d 20 28 73 71 6c 69 */. rc = (sqli
175b0 74 65 33 4f 73 53 6c 65 65 70 28 70 56 66 73 2c te3OsSleep(pVfs,
175c0 20 31 30 30 30 2a 6d 73 29 2f 31 30 30 30 29 3b 1000*ms)/1000);
175d0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
175e0 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 ./*.** Enable or
175f0 20 64 69 73 61 62 6c 65 20 74 68 65 20 65 78 74 disable the ext
17600 65 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 ended result cod
17610 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 es..*/.int sqlit
17620 65 33 5f 65 78 74 65 6e 64 65 64 5f 72 65 73 75 e3_extended_resu
17630 6c 74 5f 63 6f 64 65 73 28 73 71 6c 69 74 65 33 lt_codes(sqlite3
17640 20 2a 64 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 *db, int onoff)
17650 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 {. sqlite3_mute
17660 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
17670 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 x);. db->errMas
17680 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 30 78 66 66 k = onoff ? 0xff
17690 66 66 66 66 66 66 20 3a 20 30 78 66 66 3b 0a 20 ffffff : 0xff;.
176a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
176b0 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
176c0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
176d0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e _OK;.}../*.** In
176e0 76 6f 6b 65 20 74 68 65 20 78 46 69 6c 65 43 6f voke the xFileCo
176f0 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 6f 6e 20 ntrol method on
17700 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 a particular dat
17710 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 abase..*/.int sq
17720 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
17730 6f 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 ol(sqlite3 *db,
17740 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e const char *zDbN
17750 61 6d 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69 ame, int op, voi
17760 64 20 2a 70 41 72 67 29 7b 0a 20 20 69 6e 74 20 d *pArg){. int
17770 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
17780 52 3b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 R;. Btree *pBtr
17790 65 65 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d ee;.. sqlite3_m
177a0 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
177b0 75 74 65 78 29 3b 0a 20 20 70 42 74 72 65 65 20 utex);. pBtree
177c0 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 = sqlite3DbNameT
177d0 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 oBtree(db, zDbNa
177e0 6d 65 29 3b 0a 20 20 69 66 28 20 70 42 74 72 65 me);. if( pBtre
177f0 65 20 29 7b 0a 20 20 20 20 50 61 67 65 72 20 2a e ){. Pager *
17800 70 50 61 67 65 72 3b 0a 20 20 20 20 73 71 6c 69 pPager;. sqli
17810 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b 0a 20 20 te3_file *fd;.
17820 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
17830 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 ter(pBtree);.
17840 20 70 50 61 67 65 72 20 3d 20 73 71 6c 69 74 65 pPager = sqlite
17850 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 72 3BtreePager(pBtr
17860 65 65 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ee);. assert(
17870 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 20 pPager!=0 );.
17880 20 20 66 64 20 3d 20 73 71 6c 69 74 65 33 50 61 fd = sqlite3Pa
17890 67 65 72 46 69 6c 65 28 70 50 61 67 65 72 29 3b gerFile(pPager);
178a0 0a 20 20 20 20 61 73 73 65 72 74 28 20 66 64 21 . assert( fd!
178b0 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 6f 70 =0 );. if( op
178c0 3d 3d 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 46 ==SQLITE_FCNTL_F
178d0 49 4c 45 5f 50 4f 49 4e 54 45 52 20 29 7b 0a 20 ILE_POINTER ){.
178e0 20 20 20 20 20 2a 28 73 71 6c 69 74 65 33 5f 66 *(sqlite3_f
178f0 69 6c 65 2a 2a 29 70 41 72 67 20 3d 20 66 64 3b ile**)pArg = fd;
17900 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
17910 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 TE_OK;. }else
17920 20 69 66 28 20 66 64 2d 3e 70 4d 65 74 68 6f 64 if( fd->pMethod
17930 73 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 s ){. rc =
17940 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e sqlite3OsFileCon
17950 74 72 6f 6c 28 66 64 2c 20 6f 70 2c 20 70 41 72 trol(fd, op, pAr
17960 67 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 g);. }else{.
17970 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
17980 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 20 20 20 20 7d _NOTFOUND;. }
17990 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
179a0 65 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a eLeave(pBtree);.
179b0 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
179c0 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
179d0 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 tex);. return r
179e0 63 3b 20 20 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 c; .}../*.** I
179f0 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 nterface to the
17a00 74 65 73 74 69 6e 67 20 6c 6f 67 69 63 2e 0a 2a testing logic..*
17a10 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 65 /.int sqlite3_te
17a20 73 74 5f 63 6f 6e 74 72 6f 6c 28 69 6e 74 20 6f st_control(int o
17a30 70 2c 20 2e 2e 2e 29 7b 0a 20 20 69 6e 74 20 72 p, ...){. int r
17a40 63 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 c = 0;.#ifndef S
17a50 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 QLITE_OMIT_BUILT
17a60 49 4e 5f 54 45 53 54 0a 20 20 76 61 5f 6c 69 73 IN_TEST. va_lis
17a70 74 20 61 70 3b 0a 20 20 76 61 5f 73 74 61 72 74 t ap;. va_start
17a80 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 (ap, op);. swit
17a90 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f ch( op ){.. /
17aa0 2a 0a 20 20 20 20 2a 2a 20 53 61 76 65 20 74 68 *. ** Save th
17ab0 65 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 e current state
17ac0 6f 66 20 74 68 65 20 50 52 4e 47 2e 0a 20 20 20 of the PRNG..
17ad0 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
17ae0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e ITE_TESTCTRL_PRN
17af0 47 5f 53 41 56 45 3a 20 7b 0a 20 20 20 20 20 20 G_SAVE: {.
17b00 73 71 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 sqlite3PrngSaveS
17b10 74 61 74 65 28 29 3b 0a 20 20 20 20 20 20 62 72 tate();. br
17b20 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
17b30 2f 2a 0a 20 20 20 20 2a 2a 20 52 65 73 74 6f 72 /*. ** Restor
17b40 65 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 e the state of t
17b50 68 65 20 50 52 4e 47 20 74 6f 20 74 68 65 20 6c he PRNG to the l
17b60 61 73 74 20 73 74 61 74 65 20 73 61 76 65 64 20 ast state saved
17b70 75 73 69 6e 67 0a 20 20 20 20 2a 2a 20 50 52 4e using. ** PRN
17b80 47 5f 53 41 56 45 2e 20 20 49 66 20 50 52 4e 47 G_SAVE. If PRNG
17b90 5f 53 41 56 45 20 68 61 73 20 6e 65 76 65 72 20 _SAVE has never
17ba0 62 65 66 6f 72 65 20 62 65 65 6e 20 63 61 6c 6c before been call
17bb0 65 64 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 ed, then. **
17bc0 74 68 69 73 20 76 65 72 62 20 61 63 74 73 20 6c this verb acts l
17bd0 69 6b 65 20 50 52 4e 47 5f 52 45 53 45 54 2e 0a ike PRNG_RESET..
17be0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
17bf0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
17c00 50 52 4e 47 5f 52 45 53 54 4f 52 45 3a 20 7b 0a PRNG_RESTORE: {.
17c10 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e sqlite3Prn
17c20 67 52 65 73 74 6f 72 65 53 74 61 74 65 28 29 3b gRestoreState();
17c30 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
17c40 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
17c50 2a 2a 20 52 65 73 65 74 20 74 68 65 20 50 52 4e ** Reset the PRN
17c60 47 20 62 61 63 6b 20 74 6f 20 69 74 73 20 75 6e G back to its un
17c70 69 6e 69 74 69 61 6c 69 7a 65 64 20 73 74 61 74 initialized stat
17c80 65 2e 20 20 54 68 65 20 6e 65 78 74 20 63 61 6c e. The next cal
17c90 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69 l. ** to sqli
17ca0 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 29 te3_randomness()
17cb0 20 77 69 6c 6c 20 72 65 73 65 65 64 20 74 68 65 will reseed the
17cc0 20 50 52 4e 47 20 75 73 69 6e 67 20 61 20 73 69 PRNG using a si
17cd0 6e 67 6c 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a ngle call. **
17ce0 20 74 6f 20 74 68 65 20 78 52 61 6e 64 6f 6d 6e to the xRandomn
17cf0 65 73 73 20 6d 65 74 68 6f 64 20 6f 66 20 74 68 ess method of th
17d00 65 20 64 65 66 61 75 6c 74 20 56 46 53 2e 0a 20 e default VFS..
17d10 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
17d20 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 QLITE_TESTCTRL_P
17d30 52 4e 47 5f 52 45 53 45 54 3a 20 7b 0a 20 20 20 RNG_RESET: {.
17d40 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 52 65 sqlite3PrngRe
17d50 73 65 74 53 74 61 74 65 28 29 3b 0a 20 20 20 20 setState();.
17d60 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
17d70 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
17d80 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
17d90 72 6f 6c 28 42 49 54 56 45 43 5f 54 45 53 54 2c rol(BITVEC_TEST,
17da0 20 73 69 7a 65 2c 20 70 72 6f 67 72 61 6d 29 0a size, program).
17db0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 75 **. ** Ru
17dc0 6e 20 61 20 74 65 73 74 20 61 67 61 69 6e 73 74 n a test against
17dd0 20 61 20 42 69 74 76 65 63 20 6f 62 6a 65 63 74 a Bitvec object
17de0 20 6f 66 20 73 69 7a 65 2e 20 20 54 68 65 20 70 of size. The p
17df0 72 6f 67 72 61 6d 20 61 72 67 75 6d 65 6e 74 0a rogram argument.
17e00 20 20 20 20 2a 2a 20 69 73 20 61 6e 20 61 72 72 ** is an arr
17e10 61 79 20 6f 66 20 69 6e 74 65 67 65 72 73 20 74 ay of integers t
17e20 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 hat defines the
17e30 74 65 73 74 2e 20 20 52 65 74 75 72 6e 20 2d 31 test. Return -1
17e40 20 6f 6e 20 61 0a 20 20 20 20 2a 2a 20 6d 65 6d on a. ** mem
17e50 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 65 ory allocation e
17e60 72 72 6f 72 2c 20 30 20 6f 6e 20 73 75 63 63 65 rror, 0 on succe
17e70 73 73 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f 20 ss, or non-zero
17e80 66 6f 72 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 for an error..
17e90 20 20 2a 2a 20 53 65 65 20 74 68 65 20 73 71 6c ** See the sql
17ea0 69 74 65 33 42 69 74 76 65 63 42 75 69 6c 74 69 ite3BitvecBuilti
17eb0 6e 54 65 73 74 28 29 20 66 6f 72 20 61 64 64 69 nTest() for addi
17ec0 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
17ed0 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 on.. */. c
17ee0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
17ef0 54 52 4c 5f 42 49 54 56 45 43 5f 54 45 53 54 3a TRL_BITVEC_TEST:
17f00 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 {. int sz
17f10 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
17f20 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 2a 61 50 );. int *aP
17f30 72 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c rog = va_arg(ap,
17f40 20 69 6e 74 2a 29 3b 0a 20 20 20 20 20 20 72 63 int*);. rc
17f50 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 = sqlite3Bitvec
17f60 42 75 69 6c 74 69 6e 54 65 73 74 28 73 7a 2c 20 BuiltinTest(sz,
17f70 61 50 72 6f 67 29 3b 0a 20 20 20 20 20 20 62 72 aProg);. br
17f80 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
17f90 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 /*. ** sqlit
17fa0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
17fb0 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f BENIGN_MALLOC_HO
17fc0 4f 4b 53 2c 20 78 42 65 67 69 6e 2c 20 78 45 6e OKS, xBegin, xEn
17fd0 64 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a d). **. **
17fe0 20 52 65 67 69 73 74 65 72 20 68 6f 6f 6b 73 20 Register hooks
17ff0 74 6f 20 63 61 6c 6c 20 74 6f 20 69 6e 64 69 63 to call to indic
18000 61 74 65 20 77 68 69 63 68 20 6d 61 6c 6c 6f 63 ate which malloc
18010 28 29 20 66 61 69 6c 75 72 65 73 20 0a 20 20 20 () failures .
18020 20 2a 2a 20 61 72 65 20 62 65 6e 69 67 6e 2e 0a ** are benign..
18030 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
18040 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
18050 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f BENIGN_MALLOC_HO
18060 4f 4b 53 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 OKS: {. typ
18070 65 64 65 66 20 76 6f 69 64 20 28 2a 76 6f 69 64 edef void (*void
18080 5f 66 75 6e 63 74 69 6f 6e 29 28 76 6f 69 64 29 _function)(void)
18090 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 6e ;. void_fun
180a0 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e 42 65 67 ction xBenignBeg
180b0 69 6e 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 in;. void_f
180c0 75 6e 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e 45 unction xBenignE
180d0 6e 64 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 nd;. xBenig
180e0 6e 42 65 67 69 6e 20 3d 20 76 61 5f 61 72 67 28 nBegin = va_arg(
180f0 61 70 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f ap, void_functio
18100 6e 29 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 n);. xBenig
18110 6e 45 6e 64 20 3d 20 76 61 5f 61 72 67 28 61 70 nEnd = va_arg(ap
18120 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 , void_function)
18130 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ;. sqlite3B
18140 65 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 enignMallocHooks
18150 28 78 42 65 6e 69 67 6e 42 65 67 69 6e 2c 20 78 (xBenignBegin, x
18160 42 65 6e 69 67 6e 45 6e 64 29 3b 0a 20 20 20 20 BenignEnd);.
18170 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
18180 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
18190 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
181a0 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
181b0 54 52 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 45 TRL_PENDING_BYTE
181c0 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 58 , unsigned int X
181d0 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 ). **. **
181e0 53 65 74 20 74 68 65 20 50 45 4e 44 49 4e 47 20 Set the PENDING
181f0 62 79 74 65 20 74 6f 20 74 68 65 20 76 61 6c 75 byte to the valu
18200 65 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e e in the argumen
18210 74 2c 20 69 66 20 58 3e 30 2e 0a 20 20 20 20 2a t, if X>0.. *
18220 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 * Make no change
18230 73 20 69 66 20 58 3d 3d 30 2e 20 20 52 65 74 75 s if X==0. Retu
18240 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 rn the value of
18250 74 68 65 20 70 65 6e 64 69 6e 67 20 62 79 74 65 the pending byte
18260 0a 20 20 20 20 2a 2a 20 61 73 20 69 74 20 65 78 . ** as it ex
18270 69 73 74 69 6e 67 20 62 65 66 6f 72 65 20 74 68 isting before th
18280 69 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 is routine was c
18290 61 6c 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 alled.. **.
182a0 20 20 2a 2a 20 49 4d 50 4f 52 54 41 4e 54 3a 20 ** IMPORTANT:
182b0 20 43 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 Changing the PE
182c0 4e 44 49 4e 47 20 62 79 74 65 20 66 72 6f 6d 20 NDING byte from
182d0 30 78 34 30 30 30 30 30 30 30 20 72 65 73 75 6c 0x40000000 resul
182e0 74 73 20 69 6e 0a 20 20 20 20 2a 2a 20 61 6e 20 ts in. ** an
182f0 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 64 61 74 incompatible dat
18300 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 6d 61 abase file forma
18310 74 2e 20 20 43 68 61 6e 67 69 6e 67 20 74 68 65 t. Changing the
18320 20 50 45 4e 44 49 4e 47 20 62 79 74 65 0a 20 20 PENDING byte.
18330 20 20 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 64 ** while any d
18340 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
18350 6f 6e 20 69 73 20 6f 70 65 6e 20 72 65 73 75 6c on is open resul
18360 74 73 20 69 6e 20 75 6e 64 65 66 69 6e 65 64 20 ts in undefined
18370 61 6e 64 0a 20 20 20 20 2a 2a 20 64 69 6c 65 74 and. ** dilet
18380 65 72 69 6f 75 73 20 62 65 68 61 76 69 6f 72 2e erious behavior.
18390 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
183a0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
183b0 5f 50 45 4e 44 49 4e 47 5f 42 59 54 45 3a 20 7b _PENDING_BYTE: {
183c0 0a 20 20 20 20 20 20 72 63 20 3d 20 50 45 4e 44 . rc = PEND
183d0 49 4e 47 5f 42 59 54 45 3b 0a 23 69 66 6e 64 65 ING_BYTE;.#ifnde
183e0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 f SQLITE_OMIT_WS
183f0 44 0a 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 D. {.
18400 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e unsigned int n
18410 65 77 56 61 6c 20 3d 20 76 61 5f 61 72 67 28 61 ewVal = va_arg(a
18420 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 p, unsigned int)
18430 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 65 ;. if( ne
18440 77 56 61 6c 20 29 20 73 71 6c 69 74 65 33 50 65 wVal ) sqlite3Pe
18450 6e 64 69 6e 67 42 79 74 65 20 3d 20 6e 65 77 56 ndingByte = newV
18460 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 al;. }.#end
18470 69 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a if. break;.
18480 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 }.. /*.
18490 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 ** sqlite3_te
184a0 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 st_control(SQLIT
184b0 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 E_TESTCTRL_ASSER
184c0 54 2c 20 69 6e 74 20 58 29 0a 20 20 20 20 2a 2a T, int X). **
184d0 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 61 63 74 . ** This act
184e0 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 61 20 72 ion provides a r
184f0 75 6e 2d 74 69 6d 65 20 74 65 73 74 20 74 6f 20 un-time test to
18500 73 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e see whether or n
18510 6f 74 0a 20 20 20 20 2a 2a 20 61 73 73 65 72 74 ot. ** assert
18520 28 29 20 77 61 73 20 65 6e 61 62 6c 65 64 20 61 () was enabled a
18530 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e 20 t compile-time.
18540 20 49 66 20 58 20 69 73 20 74 72 75 65 20 61 6e If X is true an
18550 64 20 61 73 73 65 72 74 28 29 0a 20 20 20 20 2a d assert(). *
18560 2a 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 * is enabled, th
18570 65 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 en the return va
18580 6c 75 65 20 69 73 20 74 72 75 65 2e 20 20 49 66 lue is true. If
18590 20 58 20 69 73 20 74 72 75 65 20 61 6e 64 0a 20 X is true and.
185a0 20 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 69 ** assert() i
185b0 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e s disabled, then
185c0 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 the return valu
185d0 65 20 69 73 20 7a 65 72 6f 2e 20 20 49 66 20 58 e is zero. If X
185e0 20 69 73 0a 20 20 20 20 2a 2a 20 66 61 6c 73 65 is. ** false
185f0 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 73 and assert() is
18600 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 enabled, then t
18610 68 65 20 61 73 73 65 72 74 69 6f 6e 20 66 69 72 he assertion fir
18620 65 73 20 61 6e 64 20 74 68 65 0a 20 20 20 20 2a es and the. *
18630 2a 20 70 72 6f 63 65 73 73 20 61 62 6f 72 74 73 * process aborts
18640 2e 20 20 49 66 20 58 20 69 73 20 66 61 6c 73 65 . If X is false
18650 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 73 and assert() is
18660 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 disabled, then
18670 74 68 65 0a 20 20 20 20 2a 2a 20 72 65 74 75 72 the. ** retur
18680 6e 20 76 61 6c 75 65 20 69 73 20 7a 65 72 6f 2e n value is zero.
18690 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
186a0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
186b0 5f 41 53 53 45 52 54 3a 20 7b 0a 20 20 20 20 20 _ASSERT: {.
186c0 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 78 20 volatile int x
186d0 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 72 = 0;. asser
186e0 74 28 20 28 78 20 3d 20 76 61 5f 61 72 67 28 61 t( (x = va_arg(a
186f0 70 2c 69 6e 74 29 29 21 3d 30 20 29 3b 0a 20 20 p,int))!=0 );.
18700 20 20 20 20 72 63 20 3d 20 78 3b 0a 20 20 20 20 rc = x;.
18710 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
18720 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
18730 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
18740 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
18750 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 69 6e 74 CTRL_ALWAYS, int
18760 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a X). **. *
18770 2a 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 72 * This action pr
18780 6f 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 6d ovides a run-tim
18790 65 20 74 65 73 74 20 74 6f 20 73 65 65 20 68 6f e test to see ho
187a0 77 20 74 68 65 20 41 4c 57 41 59 53 20 61 6e 64 w the ALWAYS and
187b0 0a 20 20 20 20 2a 2a 20 4e 45 56 45 52 20 6d 61 . ** NEVER ma
187c0 63 72 6f 73 20 77 65 72 65 20 64 65 66 69 6e 65 cros were define
187d0 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d d at compile-tim
187e0 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a e.. **. **
187f0 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 The return valu
18800 65 20 69 73 20 41 4c 57 41 59 53 28 58 29 2e 20 e is ALWAYS(X).
18810 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 . **. **
18820 54 68 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 The recommended
18830 74 65 73 74 20 69 73 20 58 3d 3d 32 2e 20 20 49 test is X==2. I
18840 66 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c f the return val
18850 75 65 20 69 73 20 32 2c 20 74 68 61 74 20 6d 65 ue is 2, that me
18860 61 6e 73 0a 20 20 20 20 2a 2a 20 41 4c 57 41 59 ans. ** ALWAY
18870 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 20 S() and NEVER()
18880 61 72 65 20 62 6f 74 68 20 6e 6f 2d 6f 70 20 70 are both no-op p
18890 61 73 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 ass-through macr
188a0 6f 73 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 os, which is the
188b0 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 20 . ** default
188c0 73 65 74 74 69 6e 67 2e 20 20 49 66 20 74 68 65 setting. If the
188d0 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 return value is
188e0 20 31 2c 20 74 68 65 6e 20 41 4c 57 41 59 53 28 1, then ALWAYS(
188f0 29 20 69 73 20 65 69 74 68 65 72 0a 20 20 20 20 ) is either.
18900 2a 2a 20 68 61 72 64 2d 63 6f 64 65 64 20 74 6f ** hard-coded to
18910 20 74 72 75 65 20 6f 72 20 65 6c 73 65 20 69 74 true or else it
18920 20 61 73 73 65 72 74 73 20 69 66 20 69 74 73 20 asserts if its
18930 61 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c 73 argument is fals
18940 65 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 69 e.. ** The fi
18950 72 73 74 20 62 65 68 61 76 69 6f 72 20 28 68 61 rst behavior (ha
18960 72 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 65 rd-coded to true
18970 29 20 69 73 20 74 68 65 20 63 61 73 65 20 69 66 ) is the case if
18980 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 54 . ** SQLITE_T
18990 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 20 73 ESTCTRL_ASSERT s
189a0 68 6f 77 73 20 74 68 61 74 20 61 73 73 65 72 74 hows that assert
189b0 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 20 61 () is disabled a
189c0 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 0a 20 20 nd the second.
189d0 20 20 2a 2a 20 62 65 68 61 76 69 6f 72 20 28 61 ** behavior (a
189e0 73 73 65 72 74 20 69 66 20 74 68 65 20 61 72 67 ssert if the arg
189f0 75 6d 65 6e 74 20 74 6f 20 41 4c 57 41 59 53 28 ument to ALWAYS(
18a00 29 20 69 73 20 66 61 6c 73 65 29 20 69 73 20 74 ) is false) is t
18a10 68 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 2a he case if. *
18a20 2a 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 * SQLITE_TESTCTR
18a30 4c 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 74 L_ASSERT shows t
18a40 68 61 74 20 61 73 73 65 72 74 28 29 20 69 73 20 hat assert() is
18a50 65 6e 61 62 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a enabled.. **.
18a60 20 20 20 20 2a 2a 20 54 68 65 20 72 75 6e 2d 74 ** The run-t
18a70 69 6d 65 20 74 65 73 74 20 70 72 6f 63 65 64 75 ime test procedu
18a80 72 65 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 73 6f re might look so
18a90 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 mething like thi
18aa0 73 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a s:. **. **
18ab0 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f if( sqlite3_
18ac0 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
18ad0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c 57 ITE_TESTCTRL_ALW
18ae0 41 59 53 2c 20 32 29 3d 3d 32 20 29 7b 0a 20 20 AYS, 2)==2 ){.
18af0 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c 57 ** // ALW
18b00 41 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 AYS() and NEVER(
18b10 29 20 61 72 65 20 6e 6f 2d 6f 70 20 70 61 73 73 ) are no-op pass
18b20 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 0a -through macros.
18b30 20 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 20 ** }else
18b40 69 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 74 if( sqlite3_test
18b50 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
18b60 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 2c TESTCTRL_ASSERT,
18b70 20 31 29 20 29 7b 0a 20 20 20 20 2a 2a 20 20 20 1) ){. **
18b80 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 // ALWAYS(x)
18b90 61 73 73 65 72 74 73 20 74 68 61 74 20 78 20 69 asserts that x i
18ba0 73 20 74 72 75 65 2e 20 4e 45 56 45 52 28 78 29 s true. NEVER(x)
18bb0 20 61 73 73 65 72 74 73 20 78 20 69 73 20 66 61 asserts x is fa
18bc0 6c 73 65 2e 0a 20 20 20 20 2a 2a 20 20 20 20 7d lse.. ** }
18bd0 65 6c 73 65 7b 0a 20 20 20 20 2a 2a 20 20 20 20 else{. **
18be0 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 69 // ALWAYS(x) i
18bf0 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 31 2e 20 s a constant 1.
18c00 20 4e 45 56 45 52 28 78 29 20 69 73 20 61 20 63 NEVER(x) is a c
18c10 6f 6e 73 74 61 6e 74 20 30 2e 0a 20 20 20 20 2a onstant 0.. *
18c20 2a 20 20 20 20 7d 0a 20 20 20 20 2a 2f 0a 20 20 * }. */.
18c30 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 case SQLITE_TE
18c40 53 54 43 54 52 4c 5f 41 4c 57 41 59 53 3a 20 7b STCTRL_ALWAYS: {
18c50 0a 20 20 20 20 20 20 69 6e 74 20 78 20 3d 20 76 . int x = v
18c60 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 a_arg(ap,int);.
18c70 20 20 20 20 20 72 63 20 3d 20 41 4c 57 41 59 53 rc = ALWAYS
18c80 28 78 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b (x);. break
18c90 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
18ca0 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 sqlite3_test_c
18cb0 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 ontrol(SQLITE_TE
18cc0 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 2c 20 STCTRL_RESERVE,
18cd0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
18ce0 20 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a N). **. *
18cf0 2a 20 53 65 74 20 74 68 65 20 6e 52 65 73 65 72 * Set the nReser
18d00 76 65 20 73 69 7a 65 20 74 6f 20 4e 20 66 6f 72 ve size to N for
18d10 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 the main databa
18d20 73 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 se on the databa
18d30 73 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 63 se. ** connec
18d40 74 69 6f 6e 20 64 62 2e 0a 20 20 20 20 2a 2f 0a tion db.. */.
18d50 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
18d60 54 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 TESTCTRL_RESERVE
18d70 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
18d80 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 3 *db = va_arg(a
18d90 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 p, sqlite3*);.
18da0 20 20 20 20 69 6e 74 20 78 20 3d 20 76 61 5f 61 int x = va_a
18db0 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 20 rg(ap,int);.
18dc0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
18dd0 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
18de0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ;. sqlite3B
18df0 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 28 treeSetPageSize(
18e00 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c 20 db->aDb[0].pBt,
18e10 30 2c 20 78 2c 20 30 29 3b 0a 20 20 20 20 20 20 0, x, 0);.
18e20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
18e30 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
18e40 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
18e50 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c 69 }.. /* sqli
18e60 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
18e70 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
18e80 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c 20 _OPTIMIZATIONS,
18e90 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
18ea0 20 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a N). **. *
18eb0 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 * Enable or disa
18ec0 62 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 74 69 ble various opti
18ed0 6d 69 7a 61 74 69 6f 6e 73 20 66 6f 72 20 74 65 mizations for te
18ee0 73 74 69 6e 67 20 70 75 72 70 6f 73 65 73 2e 20 sting purposes.
18ef0 20 54 68 65 20 0a 20 20 20 20 2a 2a 20 61 72 67 The . ** arg
18f00 75 6d 65 6e 74 20 4e 20 69 73 20 61 20 62 69 74 ument N is a bit
18f10 6d 61 73 6b 20 6f 66 20 6f 70 74 69 6d 69 7a 61 mask of optimiza
18f20 74 69 6f 6e 73 20 74 6f 20 62 65 20 64 69 73 61 tions to be disa
18f30 62 6c 65 64 2e 20 20 46 6f 72 20 6e 6f 72 6d 61 bled. For norma
18f40 6c 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 69 l. ** operati
18f50 6f 6e 20 4e 20 73 68 6f 75 6c 64 20 62 65 20 30 on N should be 0
18f60 2e 20 20 54 68 65 20 69 64 65 61 20 69 73 20 74 . The idea is t
18f70 68 61 74 20 61 20 74 65 73 74 20 70 72 6f 67 72 hat a test progr
18f80 61 6d 20 28 6c 69 6b 65 20 74 68 65 0a 20 20 20 am (like the.
18f90 20 2a 2a 20 53 51 4c 20 4c 6f 67 69 63 20 54 65 ** SQL Logic Te
18fa0 73 74 20 6f 72 20 53 4c 54 20 74 65 73 74 20 6d st or SLT test m
18fb0 6f 64 75 6c 65 29 20 63 61 6e 20 72 75 6e 20 74 odule) can run t
18fc0 68 65 20 73 61 6d 65 20 53 51 4c 20 6d 75 6c 74 he same SQL mult
18fd0 69 70 6c 65 20 74 69 6d 65 73 0a 20 20 20 20 2a iple times. *
18fe0 2a 20 77 69 74 68 20 76 61 72 69 6f 75 73 20 6f * with various o
18ff0 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 64 69 73 ptimizations dis
19000 61 62 6c 65 64 20 74 6f 20 76 65 72 69 66 79 20 abled to verify
19010 74 68 61 74 20 74 68 65 20 73 61 6d 65 20 61 6e that the same an
19020 73 77 65 72 0a 20 20 20 20 2a 2a 20 69 73 20 6f swer. ** is o
19030 62 74 61 69 6e 65 64 20 69 6e 20 65 76 65 72 79 btained in every
19040 20 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 case.. */.
19050 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 case SQLITE_TE
19060 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 STCTRL_OPTIMIZAT
19070 49 4f 4e 53 3a 20 7b 0a 20 20 20 20 20 20 73 71 IONS: {. sq
19080 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 lite3 *db = va_a
19090 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 rg(ap, sqlite3*)
190a0 3b 0a 20 20 20 20 20 20 64 62 2d 3e 64 62 4f 70 ;. db->dbOp
190b0 74 46 6c 61 67 73 20 3d 20 28 75 31 36 29 28 76 tFlags = (u16)(v
190c0 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 20 26 a_arg(ap, int) &
190d0 20 30 78 66 66 66 66 29 3b 0a 20 20 20 20 20 20 0xffff);.
190e0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 break;. }..#i
190f0 66 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 fdef SQLITE_N_KE
19100 59 57 4f 52 44 0a 20 20 20 20 2f 2a 20 73 71 6c YWORD. /* sql
19110 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
19120 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
19130 4c 5f 49 53 4b 45 59 57 4f 52 44 2c 20 63 6f 6e L_ISKEYWORD, con
19140 73 74 20 63 68 61 72 20 2a 7a 57 6f 72 64 29 0a st char *zWord).
19150 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 **. ** If
19160 20 7a 57 6f 72 64 20 69 73 20 61 20 6b 65 79 77 zWord is a keyw
19170 6f 72 64 20 72 65 63 6f 67 6e 69 7a 65 64 20 62 ord recognized b
19180 79 20 74 68 65 20 70 61 72 73 65 72 2c 20 74 68 y the parser, th
19190 65 6e 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 en return the.
191a0 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 6b ** number of k
191b0 65 79 77 6f 72 64 73 2e 20 20 4f 72 20 69 66 20 eywords. Or if
191c0 7a 57 6f 72 64 20 69 73 20 6e 6f 74 20 61 20 6b zWord is not a k
191d0 65 79 77 6f 72 64 2c 20 72 65 74 75 72 6e 20 30 eyword, return 0
191e0 2e 0a 20 20 20 20 2a 2a 20 0a 20 20 20 20 2a 2a .. ** . **
191f0 20 54 68 69 73 20 74 65 73 74 20 66 65 61 74 75 This test featu
19200 72 65 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c re is only avail
19210 61 62 6c 65 20 69 6e 20 74 68 65 20 61 6d 61 6c able in the amal
19220 67 61 6d 61 74 69 6f 6e 20 73 69 6e 63 65 0a 20 gamation since.
19230 20 20 20 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 ** the SQLITE
19240 5f 4e 5f 4b 45 59 57 4f 52 44 20 6d 61 63 72 6f _N_KEYWORD macro
19250 20 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 is not defined
19260 69 6e 20 74 68 69 73 20 66 69 6c 65 20 69 66 20 in this file if
19270 53 51 4c 69 74 65 0a 20 20 20 20 2a 2a 20 69 73 SQLite. ** is
19280 20 62 75 69 6c 74 20 75 73 69 6e 67 20 73 65 70 built using sep
19290 61 72 61 74 65 20 73 6f 75 72 63 65 20 66 69 6c arate source fil
192a0 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 es.. */. c
192b0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
192c0 54 52 4c 5f 49 53 4b 45 59 57 4f 52 44 3a 20 7b TRL_ISKEYWORD: {
192d0 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 . const cha
192e0 72 20 2a 7a 57 6f 72 64 20 3d 20 76 61 5f 61 72 r *zWord = va_ar
192f0 67 28 61 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 g(ap, const char
19300 2a 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 *);. int n
19310 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
19320 30 28 7a 57 6f 72 64 29 3b 0a 20 20 20 20 20 20 0(zWord);.
19330 72 63 20 3d 20 28 73 71 6c 69 74 65 33 4b 65 79 rc = (sqlite3Key
19340 77 6f 72 64 43 6f 64 65 28 28 75 38 2a 29 7a 57 wordCode((u8*)zW
19350 6f 72 64 2c 20 6e 29 21 3d 54 4b 5f 49 44 29 20 ord, n)!=TK_ID)
19360 3f 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f ? SQLITE_N_KEYWO
19370 52 44 20 3a 20 30 3b 0a 20 20 20 20 20 20 62 72 RD : 0;. br
19380 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 eak;. }.#endi
19390 66 20 0a 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 f .. /* sqlit
193a0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
193b0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
193c0 53 43 52 41 54 43 48 4d 41 4c 4c 4f 43 2c 20 73 SCRATCHMALLOC, s
193d0 7a 2c 20 26 70 4e 65 77 2c 20 70 46 72 65 65 29 z, &pNew, pFree)
193e0 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 ;. **. **
193f0 50 61 73 73 20 70 46 72 65 65 20 69 6e 74 6f 20 Pass pFree into
19400 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 sqlite3ScratchFr
19410 65 65 28 29 2e 20 0a 20 20 20 20 2a 2a 20 49 66 ee(). . ** If
19420 20 73 7a 3e 30 20 74 68 65 6e 20 61 6c 6c 6f 63 sz>0 then alloc
19430 61 74 65 20 61 20 73 63 72 61 74 63 68 20 62 75 ate a scratch bu
19440 66 66 65 72 20 69 6e 74 6f 20 70 4e 65 77 2e 20 ffer into pNew.
19450 20 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 . */. cas
19460 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
19470 4c 5f 53 43 52 41 54 43 48 4d 41 4c 4c 4f 43 3a L_SCRATCHMALLOC:
19480 20 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 2a 70 {. void *p
19490 46 72 65 65 2c 20 2a 2a 70 70 4e 65 77 3b 0a 20 Free, **ppNew;.
194a0 20 20 20 20 20 69 6e 74 20 73 7a 3b 0a 20 20 20 int sz;.
194b0 20 20 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 sz = va_arg(a
194c0 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 70 p, int);. p
194d0 70 4e 65 77 20 3d 20 76 61 5f 61 72 67 28 61 70 pNew = va_arg(ap
194e0 2c 20 76 6f 69 64 2a 2a 29 3b 0a 20 20 20 20 20 , void**);.
194f0 20 70 46 72 65 65 20 3d 20 76 61 5f 61 72 67 28 pFree = va_arg(
19500 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 ap, void*);.
19510 20 20 69 66 28 20 73 7a 20 29 20 2a 70 70 4e 65 if( sz ) *ppNe
19520 77 20 3d 20 73 71 6c 69 74 65 33 53 63 72 61 74 w = sqlite3Scrat
19530 63 68 4d 61 6c 6c 6f 63 28 73 7a 29 3b 0a 20 20 chMalloc(sz);.
19540 20 20 20 20 73 71 6c 69 74 65 33 53 63 72 61 74 sqlite3Scrat
19550 63 68 46 72 65 65 28 70 46 72 65 65 29 3b 0a 20 chFree(pFree);.
19560 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
19570 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 }.. /* sqli
19580 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
19590 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
195a0 5f 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 55 4c 54 _LOCALTIME_FAULT
195b0 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 3b 0a 20 20 , int onoff);.
195c0 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 70 **. ** If p
195d0 61 72 61 6d 65 74 65 72 20 6f 6e 6f 66 66 20 69 arameter onoff i
195e0 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 63 6f 6e 66 s non-zero, conf
195f0 69 67 75 72 65 20 74 68 65 20 77 72 61 70 70 65 igure the wrappe
19600 72 73 20 73 6f 20 74 68 61 74 20 61 6c 6c 0a 20 rs so that all.
19610 20 20 20 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 ** subsequent
19620 20 63 61 6c 6c 73 20 74 6f 20 6c 6f 63 61 6c 74 calls to localt
19630 69 6d 65 28 29 20 61 6e 64 20 76 61 72 69 61 6e ime() and varian
19640 74 73 20 66 61 69 6c 2e 20 49 66 20 6f 6e 6f 66 ts fail. If onof
19650 66 20 69 73 20 7a 65 72 6f 2c 0a 20 20 20 20 2a f is zero,. *
19660 2a 20 75 6e 64 6f 20 74 68 69 73 20 73 65 74 74 * undo this sett
19670 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ing.. */.
19680 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
19690 43 54 52 4c 5f 4c 4f 43 41 4c 54 49 4d 45 5f 46 CTRL_LOCALTIME_F
196a0 41 55 4c 54 3a 20 7b 0a 20 20 20 20 20 20 73 71 AULT: {. sq
196b0 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
196c0 67 2e 62 4c 6f 63 61 6c 74 69 6d 65 46 61 75 6c g.bLocaltimeFaul
196d0 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 t = va_arg(ap, i
196e0 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nt);. break
196f0 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 20 64 65 66 ;. }..#if def
19700 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
19710 4c 45 5f 54 52 45 45 5f 45 58 50 4c 41 49 4e 29 LE_TREE_EXPLAIN)
19720 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 . /* sqlite
19730 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
19740 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 45 QLITE_TESTCTRL_E
19750 58 50 4c 41 49 4e 5f 53 54 4d 54 2c 0a 20 20 20 XPLAIN_STMT,.
19760 20 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 **
19770 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
19780 65 33 5f 73 74 6d 74 2a 2c 63 6f 6e 73 74 20 63 e3_stmt*,const c
19790 68 61 72 2a 2a 29 3b 0a 20 20 20 20 2a 2a 0a 20 har**);. **.
197a0 20 20 20 2a 2a 20 49 66 20 63 6f 6d 70 69 6c 65 ** If compile
197b0 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 45 4e d with SQLITE_EN
197c0 41 42 4c 45 5f 54 52 45 45 5f 45 58 50 4c 41 49 ABLE_TREE_EXPLAI
197d0 4e 2c 20 65 61 63 68 20 73 71 6c 69 74 65 33 5f N, each sqlite3_
197e0 73 74 6d 74 20 68 6f 6c 64 73 0a 20 20 20 20 2a stmt holds. *
197f0 2a 20 61 20 73 74 72 69 6e 67 20 74 68 61 74 20 * a string that
19800 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6f 70 describes the op
19810 74 69 6d 69 7a 65 64 20 70 61 72 73 65 20 74 72 timized parse tr
19820 65 65 2e 20 20 54 68 69 73 20 74 65 73 74 2d 63 ee. This test-c
19830 6f 6e 74 72 6f 6c 0a 20 20 20 20 2a 2a 20 72 65 ontrol. ** re
19840 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 turns a pointer
19850 74 6f 20 74 68 61 74 20 73 74 72 69 6e 67 2e 0a to that string..
19860 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
19870 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
19880 45 58 50 4c 41 49 4e 5f 53 54 4d 54 3a 20 7b 0a EXPLAIN_STMT: {.
19890 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 73 74 sqlite3_st
198a0 6d 74 20 2a 70 53 74 6d 74 20 3d 20 76 61 5f 61 mt *pStmt = va_a
198b0 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 73 rg(ap, sqlite3_s
198c0 74 6d 74 2a 29 3b 0a 20 20 20 20 20 20 63 6f 6e tmt*);. con
198d0 73 74 20 63 68 61 72 20 2a 2a 70 7a 52 65 74 20 st char **pzRet
198e0 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 63 6f 6e = va_arg(ap, con
198f0 73 74 20 63 68 61 72 2a 2a 29 3b 0a 20 20 20 20 st char**);.
19900 20 20 2a 70 7a 52 65 74 20 3d 20 73 71 6c 69 74 *pzRet = sqlit
19910 65 33 56 64 62 65 45 78 70 6c 61 6e 61 74 69 6f e3VdbeExplanatio
19920 6e 28 28 56 64 62 65 2a 29 70 53 74 6d 74 29 3b n((Vdbe*)pStmt);
19930 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
19940 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 7d 0a }.#endif.. }.
19950 20 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 23 65 va_end(ap);.#e
19960 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
19970 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 MIT_BUILTIN_TEST
19980 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b */. return rc;
19990 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 .}../*.** This i
199a0 73 20 61 20 75 74 69 6c 69 74 79 20 72 6f 75 74 s a utility rout
199b0 69 6e 65 2c 20 75 73 65 66 75 6c 20 74 6f 20 56 ine, useful to V
199c0 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f FS implementatio
199d0 6e 73 2c 20 74 68 61 74 20 63 68 65 63 6b 73 0a ns, that checks.
199e0 2a 2a 20 74 6f 20 73 65 65 20 69 66 20 61 20 64 ** to see if a d
199f0 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 61 73 atabase file was
19a00 20 61 20 55 52 49 20 74 68 61 74 20 63 6f 6e 74 a URI that cont
19a10 61 69 6e 65 64 20 61 20 73 70 65 63 69 66 69 63 ained a specific
19a20 20 71 75 65 72 79 20 0a 2a 2a 20 70 61 72 61 6d query .** param
19a30 65 74 65 72 2c 20 61 6e 64 20 69 66 20 73 6f 20 eter, and if so
19a40 6f 62 74 61 69 6e 73 20 74 68 65 20 76 61 6c 75 obtains the valu
19a50 65 20 6f 66 20 74 68 65 20 71 75 65 72 79 20 70 e of the query p
19a60 61 72 61 6d 65 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 arameter..**.**
19a70 54 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 61 72 The zFilename ar
19a80 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 66 69 gument is the fi
19a90 6c 65 6e 61 6d 65 20 70 6f 69 6e 74 65 72 20 70 lename pointer p
19aa0 61 73 73 65 64 20 69 6e 74 6f 20 74 68 65 20 78 assed into the x
19ab0 4f 70 65 6e 28 29 0a 2a 2a 20 6d 65 74 68 6f 64 Open().** method
19ac0 20 6f 66 20 61 20 56 46 53 20 69 6d 70 6c 65 6d of a VFS implem
19ad0 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 20 7a entation. The z
19ae0 50 61 72 61 6d 20 61 72 67 75 6d 65 6e 74 20 69 Param argument i
19af0 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th
19b00 65 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 61 6d e.** query param
19b10 65 74 65 72 20 77 65 20 73 65 65 6b 2e 20 20 54 eter we seek. T
19b20 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 his routine retu
19b30 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 rns the value of
19b40 20 74 68 65 20 7a 50 61 72 61 6d 0a 2a 2a 20 70 the zParam.** p
19b50 61 72 61 6d 65 74 65 72 20 69 66 20 69 74 20 65 arameter if it e
19b60 78 69 73 74 73 2e 20 20 49 66 20 74 68 65 20 70 xists. If the p
19b70 61 72 61 6d 65 74 65 72 20 64 6f 65 73 20 6e 6f arameter does no
19b80 74 20 65 78 69 73 74 2c 20 74 68 69 73 20 72 6f t exist, this ro
19b90 75 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72 6e 73 utine.** returns
19ba0 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2e a NULL pointer.
19bb0 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
19bc0 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 sqlite3_uri_para
19bd0 6d 65 74 65 72 28 63 6f 6e 73 74 20 63 68 61 72 meter(const char
19be0 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 6f 6e *zFilename, con
19bf0 73 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 29 st char *zParam)
19c00 7b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d {. if( zFilenam
19c10 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b e==0 ) return 0;
19c20 0a 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 . zFilename +=
19c30 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
19c40 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 3b 0a zFilename) + 1;.
19c50 20 20 77 68 69 6c 65 28 20 7a 46 69 6c 65 6e 61 while( zFilena
19c60 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 69 6e 74 me[0] ){. int
19c70 20 78 20 3d 20 73 74 72 63 6d 70 28 7a 46 69 6c x = strcmp(zFil
19c80 65 6e 61 6d 65 2c 20 7a 50 61 72 61 6d 29 3b 0a ename, zParam);.
19c90 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d zFilename +=
19ca0 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
19cb0 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 3b (zFilename) + 1;
19cc0 0a 20 20 20 20 69 66 28 20 78 3d 3d 30 20 29 20 . if( x==0 )
19cd0 72 65 74 75 72 6e 20 7a 46 69 6c 65 6e 61 6d 65 return zFilename
19ce0 3b 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 ;. zFilename
19cf0 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e += sqlite3Strlen
19d00 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 30(zFilename) +
19d10 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 1;. }. return
19d20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
19d30 72 6e 20 61 20 62 6f 6f 6c 65 61 6e 20 76 61 6c rn a boolean val
19d40 75 65 20 66 6f 72 20 61 20 71 75 65 72 79 20 70 ue for a query p
19d50 61 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 69 6e 74 arameter..*/.int
19d60 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 62 6f 6f sqlite3_uri_boo
19d70 6c 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 lean(const char
19d80 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 6f 6e 73 *zFilename, cons
19d90 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 2c 20 t char *zParam,
19da0 69 6e 74 20 62 44 66 6c 74 29 7b 0a 20 20 63 6f int bDflt){. co
19db0 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 nst char *z = sq
19dc0 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 lite3_uri_parame
19dd0 74 65 72 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a ter(zFilename, z
19de0 50 61 72 61 6d 29 3b 0a 20 20 62 44 66 6c 74 20 Param);. bDflt
19df0 3d 20 62 44 66 6c 74 21 3d 30 3b 0a 20 20 72 65 = bDflt!=0;. re
19e00 74 75 72 6e 20 7a 20 3f 20 73 71 6c 69 74 65 33 turn z ? sqlite3
19e10 47 65 74 42 6f 6f 6c 65 61 6e 28 7a 2c 20 62 44 GetBoolean(z, bD
19e20 66 6c 74 29 20 3a 20 62 44 66 6c 74 3b 0a 7d 0a flt) : bDflt;.}.
19e30 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 ./*.** Return a
19e40 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 20 76 64-bit integer v
19e50 61 6c 75 65 20 66 6f 72 20 61 20 71 75 65 72 79 alue for a query
19e60 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 73 parameter..*/.s
19e70 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c qlite3_int64 sql
19e80 69 74 65 33 5f 75 72 69 5f 69 6e 74 36 34 28 0a ite3_uri_int64(.
19e90 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
19ea0 69 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 46 ilename, /* F
19eb0 69 6c 65 6e 61 6d 65 20 61 73 20 70 61 73 73 65 ilename as passe
19ec0 64 20 74 6f 20 78 4f 70 65 6e 20 2a 2f 0a 20 20 d to xOpen */.
19ed0 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 72 const char *zPar
19ee0 61 6d 2c 20 20 20 20 20 20 20 2f 2a 20 55 52 49 am, /* URI
19ef0 20 70 61 72 61 6d 65 74 65 72 20 73 6f 75 67 68 parameter sough
19f00 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 t */. sqlite3_i
19f10 6e 74 36 34 20 62 44 66 6c 74 20 20 20 20 20 20 nt64 bDflt
19f20 20 2f 2a 20 72 65 74 75 72 6e 20 69 66 20 70 61 /* return if pa
19f30 72 61 6d 65 74 65 72 20 69 73 20 6d 69 73 73 69 rameter is missi
19f40 6e 67 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 ng */.){. const
19f50 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c 69 74 char *z = sqlit
19f60 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 e3_uri_parameter
19f70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 72 (zFilename, zPar
19f80 61 6d 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 am);. sqlite3_i
19f90 6e 74 36 34 20 76 3b 0a 20 20 69 66 28 20 7a 20 nt64 v;. if( z
19fa0 26 26 20 73 71 6c 69 74 65 33 41 74 6f 69 36 34 && sqlite3Atoi64
19fb0 28 7a 2c 20 26 76 2c 20 73 71 6c 69 74 65 33 53 (z, &v, sqlite3S
19fc0 74 72 6c 65 6e 33 30 28 7a 29 2c 20 53 51 4c 49 trlen30(z), SQLI
19fd0 54 45 5f 55 54 46 38 29 3d 3d 53 51 4c 49 54 45 TE_UTF8)==SQLITE
19fe0 5f 4f 4b 20 29 7b 0a 20 20 20 20 62 44 66 6c 74 _OK ){. bDflt
19ff0 20 3d 20 76 3b 0a 20 20 7d 0a 20 20 72 65 74 75 = v;. }. retu
1a000 72 6e 20 62 44 66 6c 74 3b 0a 7d 0a 0a 2f 2a 0a rn bDflt;.}../*.
1a010 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 42 74 ** Return the Bt
1a020 72 65 65 20 70 6f 69 6e 74 65 72 20 69 64 65 6e ree pointer iden
1a030 74 69 66 69 65 64 20 62 79 20 7a 44 62 4e 61 6d tified by zDbNam
1a040 65 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 e. Return NULL
1a050 69 66 20 6e 6f 74 20 66 6f 75 6e 64 2e 0a 2a 2f if not found..*/
1a060 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 65 33 44 .Btree *sqlite3D
1a070 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 71 6c bNameToBtree(sql
1a080 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 ite3 *db, const
1a090 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a char *zDbName){.
1a0a0 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 int i;. for(i
1a0b0 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 =0; i<db->nDb; i
1a0c0 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d ++){. if( db-
1a0d0 3e 61 44 62 5b 69 5d 2e 70 42 74 0a 20 20 20 20 >aDb[i].pBt.
1a0e0 20 26 26 20 28 7a 44 62 4e 61 6d 65 3d 3d 30 20 && (zDbName==0
1a0f0 7c 7c 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d || sqlite3StrICm
1a100 70 28 7a 44 62 4e 61 6d 65 2c 20 64 62 2d 3e 61 p(zDbName, db->a
1a110 44 62 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d 30 29 Db[i].zName)==0)
1a120 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 . ){. re
1a130 74 75 72 6e 20 64 62 2d 3e 61 44 62 5b 69 5d 2e turn db->aDb[i].
1a140 70 42 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 pBt;. }. }.
1a150 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a return 0;.}../*
1a160 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 66 .** Return the f
1a170 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 ilename of the d
1a180 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 61 74 atabase associat
1a190 65 64 20 77 69 74 68 20 61 20 64 61 74 61 62 61 ed with a databa
1a1a0 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e se.** connection
1a1b0 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 ..*/.const char
1a1c0 2a 73 71 6c 69 74 65 33 5f 64 62 5f 66 69 6c 65 *sqlite3_db_file
1a1d0 6e 61 6d 65 28 73 71 6c 69 74 65 33 20 2a 64 62 name(sqlite3 *db
1a1e0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 , const char *zD
1a1f0 62 4e 61 6d 65 29 7b 0a 20 20 42 74 72 65 65 20 bName){. Btree
1a200 2a 70 42 74 20 3d 20 73 71 6c 69 74 65 33 44 62 *pBt = sqlite3Db
1a210 4e 61 6d 65 54 6f 42 74 72 65 65 28 64 62 2c 20 NameToBtree(db,
1a220 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 72 65 74 75 zDbName);. retu
1a230 72 6e 20 70 42 74 20 3f 20 73 71 6c 69 74 65 33 rn pBt ? sqlite3
1a240 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 BtreeGetFilename
1a250 28 70 42 74 29 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a (pBt) : 0;.}../*
1a260 0a 2a 2a 20 52 65 74 75 72 6e 20 31 20 69 66 20 .** Return 1 if
1a270 64 61 74 61 62 61 73 65 20 69 73 20 72 65 61 64 database is read
1a280 2d 6f 6e 6c 79 20 6f 72 20 30 20 69 66 20 72 65 -only or 0 if re
1a290 61 64 2f 77 72 69 74 65 2e 20 20 52 65 74 75 72 ad/write. Retur
1a2a0 6e 20 2d 31 20 69 66 0a 2a 2a 20 6e 6f 20 73 75 n -1 if.** no su
1a2b0 63 68 20 64 61 74 61 62 61 73 65 20 65 78 69 73 ch database exis
1a2c0 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ts..*/.int sqlit
1a2d0 65 33 5f 64 62 5f 72 65 61 64 6f 6e 6c 79 28 73 e3_db_readonly(s
1a2e0 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 qlite3 *db, cons
1a2f0 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 29 t char *zDbName)
1a300 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d {. Btree *pBt =
1a310 20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 6f sqlite3DbNameTo
1a320 42 74 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 6d Btree(db, zDbNam
1a330 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 42 74 e);. return pBt
1a340 20 3f 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 ? sqlite3PagerI
1a350 73 72 65 61 64 6f 6e 6c 79 28 73 71 6c 69 74 65 sreadonly(sqlite
1a360 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 29 3BtreePager(pBt)
1a370 29 20 3a 20 2d 31 3b 0a 7d 0a ) : -1;.}.