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 35 34 38 32 ATION-OF: R-5482
06a0: 33 2d 34 31 33 34 33 20 54 68 65 20 73 71 6c 69 3-41343 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 6d 75 74 was compiled mut
0700: 65 78 69 6e 67 20 63 6f 64 65 20 6f 6d 69 74 74 exing code omitt
0710: 65 64 20 64 75 65 20 74 6f 0a 2a 2a 20 74 68 65 ed due to.** the
0720: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
0730: 46 45 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 FE compile-time
0740: 6f 70 74 69 6f 6e 20 62 65 69 6e 67 20 73 65 74 option being set
0750: 20 74 6f 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 to 0..*/.int sq
0760: 6c 69 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 lite3_threadsafe
0770: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 (void){ return S
0780: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
0790: 3b 20 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 ; }..#if !define
07a0: 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 d(SQLITE_OMIT_TR
07b0: 41 43 45 29 20 26 26 20 64 65 66 69 6e 65 64 28 ACE) && defined(
07c0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f SQLITE_ENABLE_IO
07d0: 54 52 41 43 45 29 0a 2f 2a 0a 2a 2a 20 49 66 20 TRACE)./*.** If
07e0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 the following fu
07f0: 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 69 nction pointer i
0800: 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 69 s not NULL and i
0810: 66 0a 2a 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 f.** SQLITE_ENAB
0820: 4c 45 5f 49 4f 54 52 41 43 45 20 69 73 20 65 6e LE_IOTRACE is en
0830: 61 62 6c 65 64 2c 20 74 68 65 6e 20 6d 65 73 73 abled, then mess
0840: 61 67 65 73 20 64 65 73 63 72 69 62 69 6e 67 0a ages describing.
0850: 2a 2a 20 49 2f 4f 20 61 63 74 69 76 65 20 61 72 ** I/O active ar
0860: 65 20 77 72 69 74 74 65 6e 20 75 73 69 6e 67 20 e written using
0870: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 20 this function.
0880: 54 68 65 73 65 20 6d 65 73 73 61 67 65 73 0a 2a These messages.*
0890: 2a 20 61 72 65 20 69 6e 74 65 6e 64 65 64 20 66 * are intended f
08a0: 6f 72 20 64 65 62 75 67 67 69 6e 67 20 61 63 74 or debugging act
08b0: 69 76 69 74 79 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 ivity only..*/.v
08c0: 6f 69 64 20 28 2a 73 71 6c 69 74 65 33 49 6f 54 oid (*sqlite3IoT
08d0: 72 61 63 65 29 28 63 6f 6e 73 74 20 63 68 61 72 race)(const char
08e0: 2a 2c 20 2e 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e *, ...) = 0;.#en
08f0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 dif../*.** If th
0900: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 e following glob
0910: 61 6c 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e al variable poin
0920: 74 73 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 ts to a string w
0930: 68 69 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e hich is the.** n
0940: 61 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f ame of a directo
0950: 72 79 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 ry, then that di
0960: 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 rectory will be
0970: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a used to store.**
0980: 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 temporary files
0990: 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f ..**.** See also
09a0: 20 74 68 65 20 22 50 52 41 47 4d 41 20 74 65 6d the "PRAGMA tem
09b0: 70 5f 73 74 6f 72 65 5f 64 69 72 65 63 74 6f 72 p_store_director
09c0: 79 22 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a y" SQL command..
09d0: 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 */.char *sqlite3
09e0: 5f 74 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 _temp_directory
09f0: 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 = 0;../*.** Init
0a00: 69 61 6c 69 7a 65 20 53 51 4c 69 74 65 2e 20 20 ialize SQLite.
0a10: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
0a20: 69 6e 65 20 6d 75 73 74 20 62 65 20 63 61 6c 6c ine must be call
0a30: 65 64 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 ed to initialize
0a40: 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f the memory allo
0a50: 63 61 74 69 6f 6e 2c 0a 2a 2a 20 56 46 53 2c 20 cation,.** VFS,
0a60: 61 6e 64 20 6d 75 74 65 78 20 73 75 62 73 79 73 and mutex subsys
0a70: 74 65 6d 73 20 70 72 69 6f 72 20 74 6f 20 64 6f tems prior to do
0a80: 69 6e 67 20 61 6e 79 20 73 65 72 69 6f 75 73 20 ing any serious
0a90: 77 6f 72 6b 20 77 69 74 68 0a 2a 2a 20 53 51 4c work with.** SQL
0aa0: 69 74 65 2e 20 20 42 75 74 20 61 73 20 6c 6f 6e ite. But as lon
0ab0: 67 20 61 73 20 79 6f 75 20 64 6f 20 6e 6f 74 20 g as you do not
0ac0: 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 53 51 4c compile with SQL
0ad0: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 ITE_OMIT_AUTOINI
0ae0: 54 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e T.** this routin
0af0: 65 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 e will be called
0b00: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 automatically b
0b10: 79 20 6b 65 79 20 72 6f 75 74 69 6e 65 73 20 73 y key routines s
0b20: 75 63 68 20 61 73 0a 2a 2a 20 73 71 6c 69 74 65 uch as.** sqlite
0b30: 33 5f 6f 70 65 6e 28 29 2e 20 20 0a 2a 2a 0a 2a 3_open(). .**.*
0b40: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 * This routine i
0b50: 73 20 61 20 6e 6f 2d 6f 70 20 65 78 63 65 70 74 s a no-op except
0b60: 20 6f 6e 20 69 74 73 20 76 65 72 79 20 66 69 72 on its very fir
0b70: 73 74 20 63 61 6c 6c 20 66 6f 72 20 74 68 65 20 st call for the
0b80: 70 72 6f 63 65 73 73 2c 0a 2a 2a 20 6f 72 20 66 process,.** or f
0b90: 6f 72 20 74 68 65 20 66 69 72 73 74 20 63 61 6c or the first cal
0ba0: 6c 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20 74 l after a call t
0bb0: 6f 20 73 71 6c 69 74 65 33 5f 73 68 75 74 64 6f o sqlite3_shutdo
0bc0: 77 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 wn..**.** The fi
0bd0: 72 73 74 20 74 68 72 65 61 64 20 74 6f 20 63 61 rst thread to ca
0be0: 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ll this routine
0bf0: 72 75 6e 73 20 74 68 65 20 69 6e 69 74 69 61 6c runs the initial
0c00: 69 7a 61 74 69 6f 6e 20 74 6f 0a 2a 2a 20 63 6f ization to.** co
0c10: 6d 70 6c 65 74 69 6f 6e 2e 20 20 49 66 20 73 75 mpletion. If su
0c20: 62 73 65 71 75 65 6e 74 20 74 68 72 65 61 64 73 bsequent threads
0c30: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 call this routi
0c40: 6e 65 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 ne before the fi
0c50: 72 73 74 0a 2a 2a 20 74 68 72 65 61 64 20 68 61 rst.** thread ha
0c60: 73 20 66 69 6e 69 73 68 65 64 20 74 68 65 20 69 s finished the i
0c70: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 nitialization pr
0c80: 6f 63 65 73 73 2c 20 74 68 65 6e 20 74 68 65 20 ocess, then the
0c90: 73 75 62 73 65 71 75 65 6e 74 0a 2a 2a 20 74 68 subsequent.** th
0ca0: 72 65 61 64 73 20 6d 75 73 74 20 62 6c 6f 63 6b reads must block
0cb0: 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 until the first
0cc0: 20 74 68 72 65 61 64 20 66 69 6e 69 73 68 65 73 thread finishes
0cd0: 20 77 69 74 68 20 74 68 65 20 69 6e 69 74 69 61 with the initia
0ce0: 6c 69 7a 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 lization..**.**
0cf0: 54 68 65 20 66 69 72 73 74 20 74 68 72 65 61 64 The first thread
0d00: 20 6d 69 67 68 74 20 63 61 6c 6c 20 74 68 69 73 might call this
0d10: 20 72 6f 75 74 69 6e 65 20 72 65 63 75 72 73 69 routine recursi
0d20: 76 65 6c 79 2e 20 20 52 65 63 75 72 73 69 76 65 vely. Recursive
0d30: 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 74 68 69 .** calls to thi
0d40: 73 20 72 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 s routine should
0d50: 20 6e 6f 74 20 62 6c 6f 63 6b 2c 20 6f 66 20 63 not block, of c
0d60: 6f 75 72 73 65 2e 20 20 4f 74 68 65 72 77 69 73 ourse. Otherwis
0d70: 65 20 74 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c e the.** initial
0d80: 69 7a 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 ization process
0d90: 77 6f 75 6c 64 20 6e 65 76 65 72 20 63 6f 6d 70 would never comp
0da0: 6c 65 74 65 2e 0a 2a 2a 0a 2a 2a 20 4c 65 74 20 lete..**.** Let
0db0: 58 20 62 65 20 74 68 65 20 66 69 72 73 74 20 74 X be the first t
0dc0: 68 72 65 61 64 20 74 6f 20 65 6e 74 65 72 20 74 hread to enter t
0dd0: 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 4c 65 his routine. Le
0de0: 74 20 59 20 62 65 20 73 6f 6d 65 20 6f 74 68 65 t Y be some othe
0df0: 72 0a 2a 2a 20 74 68 72 65 61 64 2e 20 20 54 68 r.** thread. Th
0e00: 65 6e 20 77 68 69 6c 65 20 74 68 65 20 69 6e 69 en while the ini
0e10: 74 69 61 6c 20 69 6e 76 6f 63 61 74 69 6f 6e 20 tial invocation
0e20: 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 of this routine
0e30: 62 79 20 58 20 69 73 0a 2a 2a 20 69 6e 63 6f 6d by X is.** incom
0e40: 70 6c 65 74 65 2c 20 69 74 20 69 73 20 72 65 71 plete, it is req
0e50: 75 69 72 65 64 20 74 68 61 74 3a 0a 2a 2a 0a 2a uired that:.**.*
0e60: 2a 20 20 20 20 2a 20 20 43 61 6c 6c 73 20 74 6f * * Calls to
0e70: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 66 72 this routine fr
0e80: 6f 6d 20 59 20 6d 75 73 74 20 62 6c 6f 63 6b 20 om Y must block
0e90: 75 6e 74 69 6c 20 74 68 65 20 6f 75 74 65 72 2d until the outer-
0ea0: 6d 6f 73 74 0a 2a 2a 20 20 20 20 20 20 20 63 61 most.** ca
0eb0: 6c 6c 20 62 79 20 58 20 63 6f 6d 70 6c 65 74 65 ll by X complete
0ec0: 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 20 52 s..**.** * R
0ed0: 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 74 ecursive calls t
0ee0: 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 66 o this routine f
0ef0: 72 6f 6d 20 74 68 72 65 61 64 20 58 20 72 65 74 rom thread X ret
0f00: 75 72 6e 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a urn immediately.
0f10: 2a 2a 20 20 20 20 20 20 20 77 69 74 68 6f 75 74 ** without
0f20: 20 62 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e blocking..*/.in
0f30: 74 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 t sqlite3_initia
0f40: 6c 69 7a 65 28 76 6f 69 64 29 7b 0a 20 20 73 71 lize(void){. sq
0f50: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 lite3_mutex *pMa
0f60: 73 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 ster;
0f70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
0f80: 65 20 6d 61 69 6e 20 73 74 61 74 69 63 20 6d 75 e main static mu
0f90: 74 65 78 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b tex */. int rc;
0fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0fc0: 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
0fd0: 63 6f 64 65 20 2a 2f 0a 0a 23 69 66 64 65 66 20 code */..#ifdef
0fe0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a SQLITE_OMIT_WSD.
0ff0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 77 rc = sqlite3_w
1000: 73 64 5f 69 6e 69 74 28 34 30 39 36 2c 20 32 34 sd_init(4096, 24
1010: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
1020: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 ITE_OK ){. re
1030: 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e turn rc;. }.#en
1040: 64 69 66 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c dif.. /* If SQL
1050: 69 74 65 20 69 73 20 61 6c 72 65 61 64 79 20 63 ite is already c
1060: 6f 6d 70 6c 65 74 65 6c 79 20 69 6e 69 74 69 61 ompletely initia
1070: 6c 69 7a 65 64 2c 20 74 68 65 6e 20 74 68 69 73 lized, then this
1080: 20 63 61 6c 6c 0a 20 20 2a 2a 20 74 6f 20 73 71 call. ** to sq
1090: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
10a0: 28 29 20 73 68 6f 75 6c 64 20 62 65 20 61 20 6e () should be a n
10b0: 6f 2d 6f 70 2e 20 20 42 75 74 20 74 68 65 20 69 o-op. But the i
10c0: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 20 20 nitialization.
10d0: 2a 2a 20 6d 75 73 74 20 62 65 20 63 6f 6d 70 6c ** must be compl
10e0: 65 74 65 2e 20 20 53 6f 20 69 73 49 6e 69 74 20 ete. So isInit
10f0: 6d 75 73 74 20 6e 6f 74 20 62 65 20 73 65 74 20 must not be set
1100: 75 6e 74 69 6c 20 74 68 65 20 76 65 72 79 20 65 until the very e
1110: 6e 64 0a 20 20 2a 2a 20 6f 66 20 74 68 69 73 20 nd. ** of this
1120: 72 6f 75 74 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 routine.. */.
1130: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
1140: 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 lConfig.isInit )
1150: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1160: 4b 3b 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 K;.. /* Make su
1170: 72 65 20 74 68 65 20 6d 75 74 65 78 20 73 75 62 re the mutex sub
1180: 73 79 73 74 65 6d 20 69 73 20 69 6e 69 74 69 61 system is initia
1190: 6c 69 7a 65 64 2e 20 20 49 66 20 75 6e 61 62 6c lized. If unabl
11a0: 65 20 74 6f 20 0a 20 20 2a 2a 20 69 6e 69 74 69 e to . ** initi
11b0: 61 6c 69 7a 65 20 74 68 65 20 6d 75 74 65 78 20 alize the mutex
11c0: 73 75 62 73 79 73 74 65 6d 2c 20 72 65 74 75 72 subsystem, retur
11d0: 6e 20 65 61 72 6c 79 20 77 69 74 68 20 74 68 65 n early with the
11e0: 20 65 72 72 6f 72 2e 0a 20 20 2a 2a 20 49 66 20 error.. ** If
11f0: 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 73 6f the system is so
1200: 20 73 69 63 6b 20 74 68 61 74 20 77 65 20 61 72 sick that we ar
1210: 65 20 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f e unable to allo
1220: 63 61 74 65 20 61 20 6d 75 74 65 78 2c 0a 20 20 cate a mutex,.
1230: 2a 2a 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 ** there is not
1240: 6d 75 63 68 20 53 51 4c 69 74 65 20 69 73 20 67 much SQLite is g
1250: 6f 69 6e 67 20 74 6f 20 62 65 20 61 62 6c 65 20 oing to be able
1260: 74 6f 20 64 6f 2e 0a 20 20 2a 2a 0a 20 20 2a 2a to do.. **. **
1270: 20 54 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 The mutex subsy
1280: 73 74 65 6d 20 6d 75 73 74 20 74 61 6b 65 20 63 stem must take c
1290: 61 72 65 20 6f 66 20 73 65 72 69 61 6c 69 7a 69 are of serializi
12a0: 6e 67 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 ng its own. **
12b0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a initialization..
12c0: 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
12d0: 74 65 33 4d 75 74 65 78 49 6e 69 74 28 29 3b 0a te3MutexInit();.
12e0: 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
12f0: 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 n rc;.. /* Init
1300: 69 61 6c 69 7a 65 20 74 68 65 20 6d 61 6c 6c 6f ialize the mallo
1310: 63 28 29 20 73 79 73 74 65 6d 20 61 6e 64 20 74 c() system and t
1320: 68 65 20 72 65 63 75 72 73 69 76 65 20 70 49 6e he recursive pIn
1330: 69 74 4d 75 74 65 78 20 6d 75 74 65 78 2e 0a 20 itMutex mutex..
1340: 20 2a 2a 20 54 68 69 73 20 6f 70 65 72 61 74 69 ** This operati
1350: 6f 6e 20 69 73 20 70 72 6f 74 65 63 74 65 64 20 on is protected
1360: 62 79 20 74 68 65 20 53 54 41 54 49 43 5f 4d 41 by the STATIC_MA
1370: 53 54 45 52 20 6d 75 74 65 78 2e 20 20 4e 6f 74 STER mutex. Not
1380: 65 20 74 68 61 74 0a 20 20 2a 2a 20 4d 75 74 65 e that. ** Mute
1390: 78 41 6c 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c xAlloc() is call
13a0: 65 64 20 66 6f 72 20 61 20 73 74 61 74 69 63 20 ed for a static
13b0: 6d 75 74 65 78 20 70 72 69 6f 72 20 74 6f 20 69 mutex prior to i
13c0: 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 0a nitializing the.
13d0: 20 20 2a 2a 20 6d 61 6c 6c 6f 63 20 73 75 62 73 ** malloc subs
13e0: 79 73 74 65 6d 20 2d 20 74 68 69 73 20 69 6d 70 ystem - this imp
13f0: 6c 69 65 73 20 74 68 61 74 20 74 68 65 20 61 6c lies that the al
1400: 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 location of a st
1410: 61 74 69 63 0a 20 20 2a 2a 20 6d 75 74 65 78 20 atic. ** mutex
1420: 6d 75 73 74 20 6e 6f 74 20 72 65 71 75 69 72 65 must not require
1430: 20 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 support from th
1440: 65 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 e malloc subsyst
1450: 65 6d 2e 0a 20 20 2a 2f 0a 20 20 70 4d 61 73 74 em.. */. pMast
1460: 65 72 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 er = sqlite3Mute
1470: 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
1480: 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 TEX_STATIC_MASTE
1490: 52 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 R);. sqlite3_mu
14a0: 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 tex_enter(pMaste
14b0: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f r);. sqlite3Glo
14c0: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 balConfig.isMute
14d0: 78 49 6e 69 74 20 3d 20 31 3b 0a 20 20 69 66 28 xInit = 1;. if(
14e0: 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 !sqlite3GlobalC
14f0: 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e onfig.isMallocIn
1500: 69 74 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 it ){. rc = s
1510: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 qlite3MallocInit
1520: 28 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 ();. }. if( rc
1530: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1540: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
1550: 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 Config.isMallocI
1560: 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 nit = 1;. if(
1570: 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 !sqlite3GlobalC
1580: 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 onfig.pInitMutex
1590: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
15a0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 3GlobalConfig.pI
15b0: 6e 69 74 4d 75 74 65 78 20 3d 0a 20 20 20 20 20 nitMutex =.
15c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 75 74 sqlite3Mut
15d0: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
15e0: 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 29 3b UTEX_RECURSIVE);
15f0: 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
1600: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
1610: 43 6f 72 65 4d 75 74 65 78 20 26 26 20 21 73 71 CoreMutex && !sq
1620: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1630: 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 29 7b 0a g.pInitMutex ){.
1640: 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
1650: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 ITE_NOMEM;.
1660: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 }. }. }. i
1670: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1680: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 ){. sqlite3G
1690: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 lobalConfig.nRef
16a0: 49 6e 69 74 4d 75 74 65 78 2b 2b 3b 0a 20 20 7d InitMutex++;. }
16b0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
16c0: 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b _leave(pMaster);
16d0: 0a 0a 20 20 2f 2a 20 49 66 20 72 63 20 69 73 20 .. /* If rc is
16e0: 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b 20 61 74 not SQLITE_OK at
16f0: 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 this point, the
1700: 6e 20 65 69 74 68 65 72 20 74 68 65 20 6d 61 6c n either the mal
1710: 6c 6f 63 0a 20 20 2a 2a 20 73 75 62 73 79 73 74 loc. ** subsyst
1720: 65 6d 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 em could not be
1730: 69 6e 69 74 69 61 6c 69 7a 65 64 20 6f 72 20 74 initialized or t
1740: 68 65 20 73 79 73 74 65 6d 20 66 61 69 6c 65 64 he system failed
1750: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 0a 20 20 2a to allocate. *
1760: 2a 20 74 68 65 20 70 49 6e 69 74 4d 75 74 65 78 * the pInitMutex
1770: 20 6d 75 74 65 78 2e 20 52 65 74 75 72 6e 20 61 mutex. Return a
1780: 6e 20 65 72 72 6f 72 20 69 6e 20 65 69 74 68 65 n error in eithe
1790: 72 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20 69 66 r case. */. if
17a0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
17b0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 ){. return rc
17c0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 44 6f 20 74 ;. }.. /* Do t
17d0: 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 69 he rest of the i
17e0: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 75 6e nitialization un
17f0: 64 65 72 20 74 68 65 20 72 65 63 75 72 73 69 76 der the recursiv
1800: 65 20 6d 75 74 65 78 20 73 6f 0a 20 20 2a 2a 20 e mutex so. **
1810: 74 68 61 74 20 77 65 20 77 69 6c 6c 20 62 65 20 that we will be
1820: 61 62 6c 65 20 74 6f 20 68 61 6e 64 6c 65 20 72 able to handle r
1830: 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 69 ecursive calls i
1840: 6e 74 6f 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 nto. ** sqlite3
1850: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 _initialize().
1860: 54 68 65 20 72 65 63 75 72 73 69 76 65 20 63 61 The recursive ca
1870: 6c 6c 73 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6d lls normally com
1880: 65 20 74 68 72 6f 75 67 68 0a 20 20 2a 2a 20 73 e through. ** s
1890: 71 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29 qlite3_os_init()
18a0: 20 77 68 65 6e 20 69 74 20 69 6e 76 6f 6b 65 73 when it invokes
18b0: 20 73 71 6c 69 74 65 33 5f 76 66 73 5f 72 65 67 sqlite3_vfs_reg
18c0: 69 73 74 65 72 28 29 2c 20 62 75 74 20 6f 74 68 ister(), but oth
18d0: 65 72 0a 20 20 2a 2a 20 72 65 63 75 72 73 69 76 er. ** recursiv
18e0: 65 20 63 61 6c 6c 73 20 6d 69 67 68 74 20 61 6c e calls might al
18f0: 73 6f 20 62 65 20 70 6f 73 73 69 62 6c 65 2e 0a so be possible..
1900: 20 20 2a 2a 0a 20 20 2a 2a 20 49 4d 50 4c 45 4d **. ** IMPLEM
1910: 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 30 ENTATION-OF: R-0
1920: 30 31 34 30 2d 33 37 34 34 35 20 53 51 4c 69 74 0140-37445 SQLit
1930: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 e automatically
1940: 73 65 72 69 61 6c 69 7a 65 73 20 63 61 6c 6c 73 serializes calls
1950: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 78 49 6e . ** to the xIn
1960: 69 74 20 6d 65 74 68 6f 64 2c 20 73 6f 20 74 68 it method, so th
1970: 65 20 78 49 6e 69 74 20 6d 65 74 68 6f 64 20 6e e xInit method n
1980: 65 65 64 20 6e 6f 74 20 62 65 20 74 68 72 65 61 eed not be threa
1990: 64 73 61 66 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a dsafe.. **. **
19a0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d The following m
19b0: 75 74 65 78 20 69 73 20 77 68 61 74 20 73 65 72 utex is what ser
19c0: 69 61 6c 69 7a 65 73 20 61 63 63 65 73 73 20 74 ializes access t
19d0: 6f 20 74 68 65 20 61 70 70 64 65 66 20 70 63 61 o the appdef pca
19e0: 63 68 65 20 78 49 6e 69 74 0a 20 20 2a 2a 20 6d che xInit. ** m
19f0: 65 74 68 6f 64 73 2e 20 20 54 68 65 20 73 71 6c ethods. The sql
1a00: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 ite3_pcache_meth
1a10: 6f 64 73 2e 78 49 6e 69 74 28 29 20 61 6c 6c 20 ods.xInit() all
1a20: 69 73 20 65 6d 62 65 64 64 65 64 20 69 6e 20 74 is embedded in t
1a30: 68 65 0a 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 he. ** call to
1a40: 73 71 6c 69 74 65 33 50 63 61 63 68 65 49 6e 69 sqlite3PcacheIni
1a50: 74 69 61 6c 69 7a 65 28 29 2e 0a 20 20 2a 2f 0a tialize().. */.
1a60: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1a70: 65 6e 74 65 72 28 73 71 6c 69 74 65 33 47 6c 6f enter(sqlite3Glo
1a80: 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d balConfig.pInitM
1a90: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 6c utex);. if( sql
1aa0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1ab0: 2e 69 73 49 6e 69 74 3d 3d 30 20 26 26 20 73 71 .isInit==0 && sq
1ac0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1ad0: 67 2e 69 6e 50 72 6f 67 72 65 73 73 3d 3d 30 20 g.inProgress==0
1ae0: 29 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 48 61 ){. FuncDefHa
1af0: 73 68 20 2a 70 48 61 73 68 20 3d 20 26 47 4c 4f sh *pHash = &GLO
1b00: 42 41 4c 28 46 75 6e 63 44 65 66 48 61 73 68 2c BAL(FuncDefHash,
1b10: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 46 75 sqlite3GlobalFu
1b20: 6e 63 74 69 6f 6e 73 29 3b 0a 20 20 20 20 73 71 nctions);. sq
1b30: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1b40: 67 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 31 g.inProgress = 1
1b50: 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 48 61 ;. memset(pHa
1b60: 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 71 sh, 0, sizeof(sq
1b70: 6c 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e 63 74 lite3GlobalFunct
1b80: 69 6f 6e 73 29 29 3b 0a 20 20 20 20 73 71 6c 69 ions));. sqli
1b90: 74 65 33 52 65 67 69 73 74 65 72 47 6c 6f 62 61 te3RegisterGloba
1ba0: 6c 46 75 6e 63 74 69 6f 6e 73 28 29 3b 0a 20 20 lFunctions();.
1bb0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
1bc0: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 balConfig.isPCac
1bd0: 68 65 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 heInit==0 ){.
1be0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1bf0: 63 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 cacheInitialize(
1c00: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
1c10: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1c20: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 {. sqlite3G
1c30: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 lobalConfig.isPC
1c40: 61 63 68 65 49 6e 69 74 20 3d 20 31 3b 0a 20 20 acheInit = 1;.
1c50: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1c60: 4f 73 49 6e 69 74 28 29 3b 0a 20 20 20 20 7d 0a OsInit();. }.
1c70: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1c80: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 TE_OK ){. s
1c90: 71 6c 69 74 65 33 50 43 61 63 68 65 42 75 66 66 qlite3PCacheBuff
1ca0: 65 72 53 65 74 75 70 28 20 73 71 6c 69 74 65 33 erSetup( sqlite3
1cb0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 GlobalConfig.pPa
1cc0: 67 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 73 ge, . s
1cd0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1ce0: 69 67 2e 73 7a 50 61 67 65 2c 20 73 71 6c 69 74 ig.szPage, sqlit
1cf0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e e3GlobalConfig.n
1d00: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 73 71 6c Page);. sql
1d10: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1d20: 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 .isInit = 1;.
1d30: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c }. sqlite3Gl
1d40: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f obalConfig.inPro
1d50: 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 7d 0a 20 gress = 0;. }.
1d60: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
1d70: 65 61 76 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 eave(sqlite3Glob
1d80: 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 alConfig.pInitMu
1d90: 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 47 6f 20 62 tex);.. /* Go b
1da0: 61 63 6b 20 75 6e 64 65 72 20 74 68 65 20 73 74 ack under the st
1db0: 61 74 69 63 20 6d 75 74 65 78 20 61 6e 64 20 63 atic mutex and c
1dc0: 6c 65 61 6e 20 75 70 20 74 68 65 20 72 65 63 75 lean up the recu
1dd0: 72 73 69 76 65 0a 20 20 2a 2a 20 6d 75 74 65 78 rsive. ** mutex
1de0: 20 74 6f 20 70 72 65 76 65 6e 74 20 61 20 72 65 to prevent a re
1df0: 73 6f 75 72 63 65 20 6c 65 61 6b 2e 0a 20 20 2a source leak.. *
1e00: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 /. sqlite3_mute
1e10: 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 x_enter(pMaster)
1e20: 3b 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 ;. sqlite3Globa
1e30: 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 lConfig.nRefInit
1e40: 4d 75 74 65 78 2d 2d 3b 0a 20 20 69 66 28 20 73 Mutex--;. if( s
1e50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1e60: 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 ig.nRefInitMutex
1e70: 3c 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 <=0 ){. asser
1e80: 74 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c t( sqlite3Global
1e90: 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d Config.nRefInitM
1ea0: 75 74 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 utex==0 );. s
1eb0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 qlite3_mutex_fre
1ec0: 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 e(sqlite3GlobalC
1ed0: 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 onfig.pInitMutex
1ee0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c );. sqlite3Gl
1ef0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
1f00: 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 7d 0a 20 Mutex = 0;. }.
1f10: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
1f20: 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a eave(pMaster);..
1f30: 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 /* The followi
1f40: 6e 67 20 69 73 20 6a 75 73 74 20 61 20 73 61 6e ng is just a san
1f50: 69 74 79 20 63 68 65 63 6b 20 74 6f 20 6d 61 6b ity check to mak
1f60: 65 20 73 75 72 65 20 53 51 4c 69 74 65 20 68 61 e sure SQLite ha
1f70: 73 0a 20 20 2a 2a 20 62 65 65 6e 20 63 6f 6d 70 s. ** been comp
1f80: 69 6c 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 iled correctly.
1f90: 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 It is important
1fa0: 20 74 6f 20 72 75 6e 20 74 68 69 73 20 63 6f 64 to run this cod
1fb0: 65 2c 20 62 75 74 0a 20 20 2a 2a 20 77 65 20 64 e, but. ** we d
1fc0: 6f 6e 27 74 20 77 61 6e 74 20 74 6f 20 72 75 6e on't want to run
1fd0: 20 69 74 20 74 6f 6f 20 6f 66 74 65 6e 20 61 6e it too often an
1fe0: 64 20 73 6f 61 6b 20 75 70 20 43 50 55 20 63 79 d soak up CPU cy
1ff0: 63 6c 65 73 20 66 6f 72 20 6e 6f 0a 20 20 2a 2a cles for no. **
2000: 20 72 65 61 73 6f 6e 2e 20 20 53 6f 20 77 65 20 reason. So we
2010: 72 75 6e 20 69 74 20 6f 6e 63 65 20 64 75 72 69 run it once duri
2020: 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f ng initializatio
2030: 6e 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 n.. */.#ifndef
2040: 4e 44 45 42 55 47 0a 23 69 66 6e 64 65 66 20 53 NDEBUG.#ifndef S
2050: 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 QLITE_OMIT_FLOAT
2060: 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 2f 2a 20 54 ING_POINT. /* T
2070: 68 69 73 20 73 65 63 74 69 6f 6e 20 6f 66 20 63 his section of c
2080: 6f 64 65 27 73 20 6f 6e 6c 79 20 22 6f 75 74 70 ode's only "outp
2090: 75 74 22 20 69 73 20 76 69 61 20 61 73 73 65 72 ut" is via asser
20a0: 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 t() statements.
20b0: 2a 2f 0a 20 20 69 66 20 28 20 72 63 3d 3d 53 51 */. if ( rc==SQ
20c0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 75 LITE_OK ){. u
20d0: 36 34 20 78 20 3d 20 28 28 28 75 36 34 29 31 29 64 x = (((u64)1)
20e0: 3c 3c 36 33 29 2d 31 3b 0a 20 20 20 20 64 6f 75 <<63)-1;. dou
20f0: 62 6c 65 20 79 3b 0a 20 20 20 20 61 73 73 65 72 ble y;. asser
2100: 74 28 73 69 7a 65 6f 66 28 78 29 3d 3d 38 29 3b t(sizeof(x)==8);
2110: 0a 20 20 20 20 61 73 73 65 72 74 28 73 69 7a 65 . assert(size
2120: 6f 66 28 78 29 3d 3d 73 69 7a 65 6f 66 28 79 29 of(x)==sizeof(y)
2130: 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 79 );. memcpy(&y
2140: 2c 20 26 78 2c 20 38 29 3b 0a 20 20 20 20 61 73 , &x, 8);. as
2150: 73 65 72 74 28 20 73 71 6c 69 74 65 33 49 73 4e sert( sqlite3IsN
2160: 61 4e 28 79 29 20 29 3b 0a 20 20 7d 0a 23 65 6e aN(y) );. }.#en
2170: 64 69 66 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a dif.#endif.. /*
2180: 20 44 6f 20 65 78 74 72 61 20 69 6e 69 74 69 61 Do extra initia
2190: 6c 69 7a 61 74 69 6f 6e 20 73 74 65 70 73 20 72 lization steps r
21a0: 65 71 75 65 73 74 65 64 20 62 79 20 74 68 65 20 equested by the
21b0: 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 SQLITE_EXTRA_INI
21c0: 54 0a 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 T. ** compile-t
21d0: 69 6d 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 2a 2f ime option.. */
21e0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
21f0: 58 54 52 41 5f 49 4e 49 54 0a 20 20 69 66 28 20 XTRA_INIT. if(
2200: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
2210: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2220: 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 7b 0a 20 nfig.isInit ){.
2230: 20 20 20 69 6e 74 20 53 51 4c 49 54 45 5f 45 58 int SQLITE_EX
2240: 54 52 41 5f 49 4e 49 54 28 76 6f 69 64 29 3b 0a TRA_INIT(void);.
2250: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2260: 45 58 54 52 41 5f 49 4e 49 54 28 29 3b 0a 20 20 EXTRA_INIT();.
2270: 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 }.#endif.. retu
2280: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
2290: 55 6e 64 6f 20 74 68 65 20 65 66 66 65 63 74 73 Undo the effects
22a0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 of sqlite3_init
22b0: 69 61 6c 69 7a 65 28 29 2e 20 20 4d 75 73 74 20 ialize(). Must
22c0: 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 77 68 not be called wh
22d0: 69 6c 65 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 ile.** there are
22e0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 61 74 outstanding dat
22f0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
2300: 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f s or memory allo
2310: 63 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 77 68 cations or.** wh
2320: 69 6c 65 20 61 6e 79 20 70 61 72 74 20 6f 66 20 ile any part of
2330: 53 51 4c 69 74 65 20 69 73 20 6f 74 68 65 72 77 SQLite is otherw
2340: 69 73 65 20 69 6e 20 75 73 65 20 69 6e 20 61 6e ise in use in an
2350: 79 20 74 68 72 65 61 64 2e 20 20 54 68 69 73 0a y thread. This.
2360: 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f ** routine is no
2370: 74 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 42 t threadsafe. B
2380: 75 74 20 69 74 20 69 73 20 73 61 66 65 20 74 6f ut it is safe to
2390: 20 69 6e 76 6f 6b 65 20 74 68 69 73 20 72 6f 75 invoke this rou
23a0: 74 69 6e 65 0a 2a 2a 20 6f 6e 20 77 68 65 6e 20 tine.** on when
23b0: 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 64 SQLite is alread
23c0: 79 20 73 68 75 74 20 64 6f 77 6e 2e 20 20 49 66 y shut down. If
23d0: 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 SQLite is alrea
23e0: 64 79 20 73 68 75 74 20 64 6f 77 6e 0a 2a 2a 20 dy shut down.**
23f0: 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e when this routin
2400: 65 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 e is invoked, th
2410: 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 en this routine
2420: 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f is a harmless no
2430: 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 -op..*/.int sqli
2440: 74 65 33 5f 73 68 75 74 64 6f 77 6e 28 76 6f 69 te3_shutdown(voi
2450: 64 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 d){. if( sqlite
2460: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
2470: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
2480: 74 65 33 5f 6f 73 5f 65 6e 64 28 29 3b 0a 20 20 te3_os_end();.
2490: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 5f sqlite3_reset_
24a0: 61 75 74 6f 5f 65 78 74 65 6e 73 69 6f 6e 28 29 auto_extension()
24b0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f ;. sqlite3Glo
24c0: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
24d0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 = 0;. }. if(
24e0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
24f0: 66 69 67 2e 69 73 50 43 61 63 68 65 49 6e 69 74 fig.isPCacheInit
2500: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 ){. sqlite3P
2510: 63 61 63 68 65 53 68 75 74 64 6f 77 6e 28 29 3b cacheShutdown();
2520: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
2530: 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 alConfig.isPCach
2540: 65 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 eInit = 0;. }.
2550: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
2560: 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f alConfig.isMallo
2570: 63 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c cInit ){. sql
2580: 69 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 29 3b ite3MallocEnd();
2590: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
25a0: 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f alConfig.isMallo
25b0: 63 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 cInit = 0;. }.
25c0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
25d0: 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 alConfig.isMutex
25e0: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
25f0: 74 65 33 4d 75 74 65 78 45 6e 64 28 29 3b 0a 20 te3MutexEnd();.
2600: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2610: 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e Config.isMutexIn
2620: 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 it = 0;. }.. r
2630: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2640: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 41 .}../*.** This A
2650: 50 49 20 61 6c 6c 6f 77 73 20 61 70 70 6c 69 63 PI allows applic
2660: 61 74 69 6f 6e 73 20 74 6f 20 6d 6f 64 69 66 79 ations to modify
2670: 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 the global conf
2680: 69 67 75 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 iguration of.**
2690: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 the SQLite libra
26a0: 72 79 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a ry at run-time..
26b0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
26c0: 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 ne should only b
26d0: 65 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 e called when th
26e0: 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 ere are no outst
26f0: 61 6e 64 69 6e 67 0a 2a 2a 20 64 61 74 61 62 61 anding.** databa
2700: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f se connections o
2710: 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 r memory allocat
2720: 69 6f 6e 73 2e 20 20 54 68 69 73 20 72 6f 75 74 ions. This rout
2730: 69 6e 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 74 68 ine is not.** th
2740: 72 65 61 64 73 61 66 65 2e 20 20 46 61 69 6c 75 readsafe. Failu
2750: 72 65 20 74 6f 20 68 65 65 64 20 74 68 65 73 65 re to heed these
2760: 20 77 61 72 6e 69 6e 67 73 20 63 61 6e 20 6c 65 warnings can le
2770: 61 64 20 74 6f 20 75 6e 70 72 65 64 69 63 74 61 ad to unpredicta
2780: 62 6c 65 0a 2a 2a 20 62 65 68 61 76 69 6f 72 2e ble.** behavior.
2790: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
27a0: 63 6f 6e 66 69 67 28 69 6e 74 20 6f 70 2c 20 2e config(int op, .
27b0: 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 ..){. va_list a
27c0: 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 p;. int rc = SQ
27d0: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 73 LITE_OK;.. /* s
27e0: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 qlite3_config()
27f0: 73 68 61 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c shall return SQL
2800: 49 54 45 5f 4d 49 53 55 53 45 20 69 66 20 69 74 ITE_MISUSE if it
2810: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 69 6c is invoked whil
2820: 65 0a 20 20 2a 2a 20 74 68 65 20 53 51 4c 69 74 e. ** the SQLit
2830: 65 20 6c 69 62 72 61 72 79 20 69 73 20 69 6e 20 e library is in
2840: 75 73 65 2e 20 2a 2f 0a 20 20 69 66 28 20 73 71 use. */. if( sq
2850: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2860: 67 2e 69 73 49 6e 69 74 20 29 20 72 65 74 75 72 g.isInit ) retur
2870: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
2880: 42 4b 50 54 3b 0a 0a 20 20 76 61 5f 73 74 61 72 BKPT;.. va_star
2890: 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 t(ap, op);. swi
28a0: 74 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 tch( op ){..
28b0: 2f 2a 20 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 /* Mutex configu
28c0: 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 ration options a
28d0: 72 65 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c re only availabl
28e0: 65 20 69 6e 20 61 20 74 68 72 65 61 64 73 61 66 e in a threadsaf
28f0: 65 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 e. ** compile
2900: 2e 20 0a 20 20 20 20 2a 2f 0a 23 69 66 20 64 65 . . */.#if de
2910: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 fined(SQLITE_THR
2920: 45 41 44 53 41 46 45 29 20 26 26 20 53 51 4c 49 EADSAFE) && SQLI
2930: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 0a TE_THREADSAFE>0.
2940: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
2950: 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 CONFIG_SINGLETHR
2960: 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 EAD: {. /*
2970: 44 69 73 61 62 6c 65 20 61 6c 6c 20 6d 75 74 65 Disable all mute
2980: 78 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 73 71 xing */. sq
2990: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
29a0: 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 30 g.bCoreMutex = 0
29b0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
29c0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c lobalConfig.bFul
29d0: 6c 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 20 20 lMutex = 0;.
29e0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
29f0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
2a00: 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 ONFIG_MULTITHREA
2a10: 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 44 69 D: {. /* Di
2a20: 73 61 62 6c 65 20 6d 75 74 65 78 69 6e 67 20 6f sable mutexing o
2a30: 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 f database conne
2a40: 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 ctions */.
2a50: 2f 2a 20 45 6e 61 62 6c 65 20 6d 75 74 65 78 69 /* Enable mutexi
2a60: 6e 67 20 6f 66 20 63 6f 72 65 20 64 61 74 61 20 ng of core data
2a70: 73 74 72 75 63 74 75 72 65 73 20 2a 2f 0a 20 20 structures */.
2a80: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
2a90: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 lConfig.bCoreMut
2aa0: 65 78 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 ex = 1;. sq
2ab0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2ac0: 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 g.bFullMutex = 0
2ad0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
2ae0: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 }. case SQ
2af0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 LITE_CONFIG_SERI
2b00: 41 4c 49 5a 45 44 3a 20 7b 0a 20 20 20 20 20 20 ALIZED: {.
2b10: 2f 2a 20 45 6e 61 62 6c 65 20 61 6c 6c 20 6d 75 /* Enable all mu
2b20: 74 65 78 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 texing */.
2b30: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2b40: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d fig.bCoreMutex =
2b50: 20 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 1;. sqlite
2b60: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 3GlobalConfig.bF
2b70: 75 6c 6c 4d 75 74 65 78 20 3d 20 31 3b 0a 20 20 ullMutex = 1;.
2b80: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
2b90: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
2ba0: 5f 43 4f 4e 46 49 47 5f 4d 55 54 45 58 3a 20 7b _CONFIG_MUTEX: {
2bb0: 0a 20 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 . /* Specif
2bc0: 79 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 y an alternative
2bd0: 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 mutex implement
2be0: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 ation */. s
2bf0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2c00: 69 67 2e 6d 75 74 65 78 20 3d 20 2a 76 61 5f 61 ig.mutex = *va_a
2c10: 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d rg(ap, sqlite3_m
2c20: 75 74 65 78 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a utex_methods*);.
2c30: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
2c40: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
2c50: 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 TE_CONFIG_GETMUT
2c60: 45 58 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 EX: {. /* R
2c70: 65 74 72 69 65 76 65 20 74 68 65 20 63 75 72 72 etrieve the curr
2c80: 65 6e 74 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d ent mutex implem
2c90: 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 entation */.
2ca0: 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 *va_arg(ap, sq
2cb0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 lite3_mutex_meth
2cc0: 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 ods*) = sqlite3G
2cd0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 lobalConfig.mute
2ce0: 78 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a x;. break;.
2cf0: 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 0a 20 }.#endif...
2d00: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
2d10: 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 3a 20 7b 0a ONFIG_MALLOC: {.
2d20: 20 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 /* Specify
2d30: 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 an alternative
2d40: 6d 61 6c 6c 6f 63 20 69 6d 70 6c 65 6d 65 6e 74 malloc implement
2d50: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 ation */. s
2d60: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2d70: 69 67 2e 6d 20 3d 20 2a 76 61 5f 61 72 67 28 61 ig.m = *va_arg(a
2d80: 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d p, sqlite3_mem_m
2d90: 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 ethods*);.
2da0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
2db0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
2dc0: 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 7b FIG_GETMALLOC: {
2dd0: 0a 20 20 20 20 20 20 2f 2a 20 52 65 74 72 69 65 . /* Retrie
2de0: 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d ve the current m
2df0: 61 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e alloc() implemen
2e00: 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 tation */.
2e10: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
2e20: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f lConfig.m.xMallo
2e30: 63 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 4d 65 c==0 ) sqlite3Me
2e40: 6d 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 mSetDefault();.
2e50: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
2e60: 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 sqlite3_mem_met
2e70: 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 hods*) = sqlite3
2e80: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a GlobalConfig.m;.
2e90: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
2ea0: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
2eb0: 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 TE_CONFIG_MEMSTA
2ec0: 54 55 53 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 TUS: {. /*
2ed0: 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c Enable or disabl
2ee0: 65 20 74 68 65 20 6d 61 6c 6c 6f 63 20 73 74 61 e the malloc sta
2ef0: 74 75 73 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 2a tus collection *
2f00: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 /. sqlite3G
2f10: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d lobalConfig.bMem
2f20: 73 74 61 74 20 3d 20 76 61 5f 61 72 67 28 61 70 stat = va_arg(ap
2f30: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
2f40: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 eak;. }. c
2f50: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
2f60: 47 5f 53 43 52 41 54 43 48 3a 20 7b 0a 20 20 20 G_SCRATCH: {.
2f70: 20 20 20 2f 2a 20 44 65 73 69 67 6e 61 74 65 20 /* Designate
2f80: 61 20 62 75 66 66 65 72 20 66 6f 72 20 73 63 72 a buffer for scr
2f90: 61 74 63 68 20 6d 65 6d 6f 72 79 20 73 70 61 63 atch memory spac
2fa0: 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 e */. sqlit
2fb0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
2fc0: 53 63 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 Scratch = va_arg
2fd0: 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 (ap, void*);.
2fe0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2ff0: 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 Config.szScratch
3000: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
3010: 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 t);. sqlite
3020: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 3GlobalConfig.nS
3030: 63 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 cratch = va_arg(
3040: 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 ap, int);.
3050: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
3060: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
3070: 46 49 47 5f 50 41 47 45 43 41 43 48 45 3a 20 7b FIG_PAGECACHE: {
3080: 0a 20 20 20 20 20 20 2f 2a 20 44 65 73 69 67 6e . /* Design
3090: 61 74 65 20 61 20 62 75 66 66 65 72 20 66 6f 72 ate a buffer for
30a0: 20 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f page cache memo
30b0: 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 20 20 ry space */.
30c0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
30d0: 6f 6e 66 69 67 2e 70 50 61 67 65 20 3d 20 76 61 onfig.pPage = va
30e0: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b _arg(ap, void*);
30f0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
3100: 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 obalConfig.szPag
3110: 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 e = va_arg(ap, i
3120: 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
3130: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e e3GlobalConfig.n
3140: 50 61 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 Page = va_arg(ap
3150: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
3160: 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
3170: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
3180: 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 IG_PCACHE: {.
3190: 20 20 20 2f 2a 20 53 70 65 63 69 66 79 20 61 6e /* Specify an
31a0: 20 61 6c 74 65 72 6e 61 74 69 76 65 20 70 61 67 alternative pag
31b0: 65 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e e cache implemen
31c0: 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 tation */.
31d0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
31e0: 66 69 67 2e 70 63 61 63 68 65 20 3d 20 2a 76 61 fig.pcache = *va
31f0: 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 _arg(ap, sqlite3
3200: 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a _pcache_methods*
3210: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
3220: 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 }.. case
3230: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 SQLITE_CONFIG_GE
3240: 54 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 TPCACHE: {.
3250: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
3260: 61 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 2e alConfig.pcache.
3270: 78 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 xInit==0 ){.
3280: 20 20 20 20 73 71 6c 69 74 65 33 50 43 61 63 68 sqlite3PCach
3290: 65 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 eSetDefault();.
32a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 2a 76 61 }. *va
32b0: 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 _arg(ap, sqlite3
32c0: 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a _pcache_methods*
32d0: 29 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 ) = sqlite3Globa
32e0: 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 3b 0a lConfig.pcache;.
32f0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
3300: 20 7d 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 }..#if defined(
3310: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
3320: 4d 53 59 53 33 29 20 7c 7c 20 64 65 66 69 6e 65 MSYS3) || define
3330: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f d(SQLITE_ENABLE_
3340: 4d 45 4d 53 59 53 35 29 0a 20 20 20 20 63 61 73 MEMSYS5). cas
3350: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3360: 48 45 41 50 3a 20 7b 0a 20 20 20 20 20 20 2f 2a HEAP: {. /*
3370: 20 44 65 73 69 67 6e 61 74 65 20 61 20 62 75 66 Designate a buf
3380: 66 65 72 20 66 6f 72 20 68 65 61 70 20 6d 65 6d fer for heap mem
3390: 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 20 ory space */.
33a0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
33b0: 43 6f 6e 66 69 67 2e 70 48 65 61 70 20 3d 20 76 Config.pHeap = v
33c0: 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 a_arg(ap, void*)
33d0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
33e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 lobalConfig.nHea
33f0: 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 p = va_arg(ap, i
3400: 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
3410: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3420: 6e 52 65 71 20 3d 20 76 61 5f 61 72 67 28 61 70 nReq = va_arg(ap
3430: 2c 20 69 6e 74 29 3b 0a 0a 20 20 20 20 20 20 69 , int);.. i
3440: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
3450: 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 3c 31 20 29 Config.mnReq<1 )
3460: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
3470: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 3GlobalConfig.mn
3480: 52 65 71 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d Req = 1;. }
3490: 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 else if( sqlite3
34a0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 GlobalConfig.mnR
34b0: 65 71 3e 28 31 3c 3c 31 32 29 20 29 7b 0a 20 20 eq>(1<<12) ){.
34c0: 20 20 20 20 20 20 2f 2a 20 63 61 70 20 6d 69 6e /* cap min
34d0: 20 72 65 71 75 65 73 74 20 73 69 7a 65 20 61 74 request size at
34e0: 20 32 5e 31 32 20 2a 2f 0a 20 20 20 20 20 20 20 2^12 */.
34f0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3500: 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 28 31 3c nfig.mnReq = (1<
3510: 3c 31 32 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 <12);. }..
3520: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
3530: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 GlobalConfig.pHe
3540: 61 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ap==0 ){.
3550: 20 2f 2a 20 49 66 20 74 68 65 20 68 65 61 70 20 /* If the heap
3560: 70 6f 69 6e 74 65 72 20 69 73 20 4e 55 4c 4c 2c pointer is NULL,
3570: 20 74 68 65 6e 20 72 65 73 74 6f 72 65 20 74 68 then restore th
3580: 65 20 6d 61 6c 6c 6f 63 20 69 6d 70 6c 65 6d 65 e malloc impleme
3590: 6e 74 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 ntation.
35a0: 2a 2a 20 62 61 63 6b 20 74 6f 20 4e 55 4c 4c 20 ** back to NULL
35b0: 70 6f 69 6e 74 65 72 73 20 74 6f 6f 2e 20 20 54 pointers too. T
35c0: 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 his will cause t
35d0: 68 65 20 6d 61 6c 6c 6f 63 20 74 6f 20 67 6f 0a he malloc to go.
35e0: 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b 20 ** back
35f0: 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 69 to its default i
3600: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 68 mplementation wh
3610: 65 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 en sqlite3_initi
3620: 61 6c 69 7a 65 28 29 20 69 73 0a 20 20 20 20 20 alize() is.
3630: 20 20 20 2a 2a 20 72 75 6e 2e 0a 20 20 20 20 20 ** run..
3640: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 */. me
3650: 6d 73 65 74 28 26 73 71 6c 69 74 65 33 47 6c 6f mset(&sqlite3Glo
3660: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2c 20 30 2c 20 balConfig.m, 0,
3670: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 47 6c sizeof(sqlite3Gl
3680: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 29 29 3b 0a obalConfig.m));.
3690: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
36a0: 20 20 20 20 20 2f 2a 20 54 68 65 20 68 65 61 70 /* The heap
36b0: 20 70 6f 69 6e 74 65 72 20 69 73 20 6e 6f 74 20 pointer is not
36c0: 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 6e 73 74 61 NULL, then insta
36d0: 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65 0a 20 20 ll one of the.
36e0: 20 20 20 20 20 20 2a 2a 20 6d 65 6d 35 2e 63 2f ** mem5.c/
36f0: 6d 65 6d 33 2e 63 20 6d 65 74 68 6f 64 73 2e 20 mem3.c methods.
3700: 49 66 20 6e 65 69 74 68 65 72 20 45 4e 41 42 4c If neither ENABL
3710: 45 5f 4d 45 4d 53 59 53 33 20 6e 6f 72 0a 20 20 E_MEMSYS3 nor.
3720: 20 20 20 20 20 20 2a 2a 20 45 4e 41 42 4c 45 5f ** ENABLE_
3730: 4d 45 4d 53 59 53 35 20 69 73 20 64 65 66 69 6e MEMSYS5 is defin
3740: 65 64 2c 20 72 65 74 75 72 6e 20 61 6e 20 65 72 ed, return an er
3750: 72 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ror.. */.
3760: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
3770: 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a 20 20 20 ABLE_MEMSYS3.
3780: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
3790: 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 71 alConfig.m = *sq
37a0: 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 lite3MemGetMemsy
37b0: 73 33 28 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 s3();.#endif.#if
37c0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
37d0: 45 5f 4d 45 4d 53 59 53 35 0a 20 20 20 20 20 20 E_MEMSYS5.
37e0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
37f0: 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 71 6c 69 74 onfig.m = *sqlit
3800: 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 35 28 e3MemGetMemsys5(
3810: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 );.#endif.
3820: 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 }. break;.
3830: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 }.#endif..
3840: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
3850: 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 45 3a 20 7b FIG_LOOKASIDE: {
3860: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
3870: 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c 6f 6f obalConfig.szLoo
3880: 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 67 28 kaside = va_arg(
3890: 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 ap, int);.
38a0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
38b0: 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 64 65 20 3d fig.nLookaside =
38c0: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
38d0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
38e0: 20 20 20 7d 0a 20 20 20 20 0a 20 20 20 20 2f 2a }. . /*
38f0: 20 52 65 63 6f 72 64 20 61 20 70 6f 69 6e 74 65 Record a pointe
3900: 72 20 74 6f 20 74 68 65 20 6c 6f 67 67 65 72 20 r to the logger
3910: 66 75 6e 63 63 74 69 6f 6e 20 61 6e 64 20 69 74 funcction and it
3920: 73 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 s first argument
3930: 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 64 65 66 .. ** The def
3940: 61 75 6c 74 20 69 73 20 4e 55 4c 4c 2e 20 20 4c ault is NULL. L
3950: 6f 67 67 69 6e 67 20 69 73 20 64 69 73 61 62 6c ogging is disabl
3960: 65 64 20 69 66 20 74 68 65 20 66 75 6e 63 74 69 ed if the functi
3970: 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 0a 20 20 on pointer is.
3980: 20 20 2a 2a 20 4e 55 4c 4c 2e 0a 20 20 20 20 2a ** NULL.. *
3990: 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
39a0: 45 5f 43 4f 4e 46 49 47 5f 4c 4f 47 3a 20 7b 0a E_CONFIG_LOG: {.
39b0: 20 20 20 20 20 20 2f 2a 20 4d 53 56 43 20 69 73 /* MSVC is
39c0: 20 70 69 63 6b 79 20 61 62 6f 75 74 20 70 75 6c picky about pul
39d0: 6c 69 6e 67 20 66 75 6e 63 20 70 74 72 73 20 66 ling func ptrs f
39e0: 72 6f 6d 20 76 61 20 6c 69 73 74 73 2e 0a 20 20 rom va lists..
39f0: 20 20 20 20 2a 2a 20 68 74 74 70 3a 2f 2f 73 75 ** http://su
3a00: 70 70 6f 72 74 2e 6d 69 63 72 6f 73 6f 66 74 2e pport.microsoft.
3a10: 63 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a 20 20 20 com/kb/47961.
3a20: 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c 6f ** sqlite3Glo
3a30: 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 20 3d balConfig.xLog =
3a40: 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
3a50: 28 2a 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f (*)(void*,int,co
3a60: 6e 73 74 20 63 68 61 72 2a 29 29 3b 0a 20 20 20 nst char*));.
3a70: 20 20 20 2a 2f 0a 20 20 20 20 20 20 74 79 70 65 */. type
3a80: 64 65 66 20 76 6f 69 64 28 2a 4c 4f 47 46 55 4e def void(*LOGFUN
3a90: 43 5f 74 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 C_t)(void*,int,c
3aa0: 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 20 onst char*);.
3ab0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
3ac0: 43 6f 6e 66 69 67 2e 78 4c 6f 67 20 3d 20 76 61 Config.xLog = va
3ad0: 5f 61 72 67 28 61 70 2c 20 4c 4f 47 46 55 4e 43 _arg(ap, LOGFUNC
3ae0: 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 _t);. sqlit
3af0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
3b00: 4c 6f 67 41 72 67 20 3d 20 76 61 5f 61 72 67 28 LogArg = va_arg(
3b10: 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 ap, void*);.
3b20: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
3b30: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
3b40: 43 4f 4e 46 49 47 5f 55 52 49 3a 20 7b 0a 20 20 CONFIG_URI: {.
3b50: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3b60: 6c 43 6f 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 lConfig.bOpenUri
3b70: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
3b80: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
3b90: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 64 65 66 61 . }.. defa
3ba0: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 ult: {. rc
3bb0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
3bc0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
3bd0: 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 }. }. va_end(
3be0: 61 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ap);. return rc
3bf0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 ;.}../*.** Set u
3c00: 70 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 p the lookaside
3c10: 62 75 66 66 65 72 73 20 66 6f 72 20 61 20 64 61 buffers for a da
3c20: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
3c30: 6e 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c n..** Return SQL
3c40: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 ITE_OK on succes
3c50: 73 2e 20 20 0a 2a 2a 20 49 66 20 6c 6f 6f 6b 61 s. .** If looka
3c60: 73 69 64 65 20 69 73 20 61 6c 72 65 61 64 79 20 side is already
3c70: 61 63 74 69 76 65 2c 20 72 65 74 75 72 6e 20 53 active, return S
3c80: 51 4c 49 54 45 5f 42 55 53 59 2e 0a 2a 2a 0a 2a QLITE_BUSY..**.*
3c90: 2a 20 54 68 65 20 73 7a 20 70 61 72 61 6d 65 74 * The sz paramet
3ca0: 65 72 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 er is the number
3cb0: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 65 61 63 of bytes in eac
3cc0: 68 20 6c 6f 6f 6b 61 73 69 64 65 20 73 6c 6f 74 h lookaside slot
3cd0: 2e 0a 2a 2a 20 54 68 65 20 63 6e 74 20 70 61 72 ..** The cnt par
3ce0: 61 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e 75 ameter is the nu
3cf0: 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 2e 20 20 mber of slots.
3d00: 49 66 20 70 53 74 61 72 74 20 69 73 20 4e 55 4c If pStart is NUL
3d10: 4c 20 74 68 65 0a 2a 2a 20 73 70 61 63 65 20 66 L the.** space f
3d20: 6f 72 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 or the lookaside
3d30: 20 6d 65 6d 6f 72 79 20 69 73 20 6f 62 74 61 69 memory is obtai
3d40: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 ned from sqlite3
3d50: 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 49 66 _malloc()..** If
3d60: 20 70 53 74 61 72 74 20 69 73 20 6e 6f 74 20 4e pStart is not N
3d70: 55 4c 4c 20 74 68 65 6e 20 69 74 20 69 73 20 73 ULL then it is s
3d80: 7a 2a 63 6e 74 20 62 79 74 65 73 20 6f 66 20 6d z*cnt bytes of m
3d90: 65 6d 6f 72 79 20 74 6f 20 75 73 65 20 66 6f 72 emory to use for
3da0: 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 .** the lookasid
3db0: 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 e memory..*/.sta
3dc0: 74 69 63 20 69 6e 74 20 73 65 74 75 70 4c 6f 6f tic int setupLoo
3dd0: 6b 61 73 69 64 65 28 73 71 6c 69 74 65 33 20 2a kaside(sqlite3 *
3de0: 64 62 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 db, void *pBuf,
3df0: 69 6e 74 20 73 7a 2c 20 69 6e 74 20 63 6e 74 29 int sz, int cnt)
3e00: 7b 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 72 74 {. void *pStart
3e10: 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b ;. if( db->look
3e20: 61 73 69 64 65 2e 6e 4f 75 74 20 29 7b 0a 20 20 aside.nOut ){.
3e30: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
3e40: 42 55 53 59 3b 0a 20 20 7d 0a 20 20 2f 2a 20 46 BUSY;. }. /* F
3e50: 72 65 65 20 61 6e 79 20 65 78 69 73 74 69 6e 67 ree any existing
3e60: 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 lookaside buffe
3e70: 72 20 66 6f 72 20 74 68 69 73 20 68 61 6e 64 6c r for this handl
3e80: 65 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 6c e before. ** al
3e90: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 6f locating a new o
3ea0: 6e 65 20 73 6f 20 77 65 20 64 6f 6e 27 74 20 68 ne so we don't h
3eb0: 61 76 65 20 74 6f 20 68 61 76 65 20 73 70 61 63 ave to have spac
3ec0: 65 20 66 6f 72 20 0a 20 20 2a 2a 20 62 6f 74 68 e for . ** both
3ed0: 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d at the same tim
3ee0: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 e.. */. if( db
3ef0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 6c ->lookaside.bMal
3f00: 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 6c loced ){. sql
3f10: 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c 6f ite3_free(db->lo
3f20: 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 3b okaside.pStart);
3f30: 0a 20 20 7d 0a 20 20 2f 2a 20 54 68 65 20 73 69 . }. /* The si
3f40: 7a 65 20 6f 66 20 61 20 6c 6f 6f 6b 61 73 69 64 ze of a lookasid
3f50: 65 20 73 6c 6f 74 20 6e 65 65 64 73 20 74 6f 20 e slot needs to
3f60: 62 65 20 6c 61 72 67 65 72 20 74 68 61 6e 20 61 be larger than a
3f70: 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 74 6f pointer. ** to
3f80: 20 62 65 20 75 73 65 66 75 6c 2e 0a 20 20 2a 2f be useful.. */
3f90: 0a 20 20 69 66 28 20 73 7a 3c 3d 28 69 6e 74 29 . if( sz<=(int)
3fa0: 73 69 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 sizeof(Lookaside
3fb0: 53 6c 6f 74 2a 29 20 29 20 73 7a 20 3d 20 30 3b Slot*) ) sz = 0;
3fc0: 0a 20 20 69 66 28 20 63 6e 74 3c 30 20 29 20 63 . if( cnt<0 ) c
3fd0: 6e 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 7a nt = 0;. if( sz
3fe0: 3d 3d 30 20 7c 7c 20 63 6e 74 3d 3d 30 20 29 7b ==0 || cnt==0 ){
3ff0: 0a 20 20 20 20 73 7a 20 3d 20 30 3b 0a 20 20 20 . sz = 0;.
4000: 20 70 53 74 61 72 74 20 3d 20 30 3b 0a 20 20 7d pStart = 0;. }
4010: 65 6c 73 65 20 69 66 28 20 70 42 75 66 3d 3d 30 else if( pBuf==0
4020: 20 29 7b 0a 20 20 20 20 73 7a 20 3d 20 52 4f 55 ){. sz = ROU
4030: 4e 44 44 4f 57 4e 38 28 73 7a 29 3b 20 2f 2a 20 NDDOWN8(sz); /*
4040: 49 4d 50 3a 20 52 2d 33 33 30 33 38 2d 30 39 33 IMP: R-33038-093
4050: 38 32 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 82 */. sqlite
4060: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
4070: 6f 63 28 29 3b 0a 20 20 20 20 70 53 74 61 72 74 oc();. pStart
4080: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 = sqlite3Malloc
4090: 28 20 73 7a 2a 63 6e 74 20 29 3b 20 20 2f 2a 20 ( sz*cnt ); /*
40a0: 49 4d 50 3a 20 52 2d 36 31 39 34 39 2d 33 35 37 IMP: R-61949-357
40b0: 32 37 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 27 */. sqlite
40c0: 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3EndBenignMalloc
40d0: 28 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ();. }else{.
40e0: 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 sz = ROUNDDOWN8
40f0: 28 73 7a 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d (sz); /* IMP: R-
4100: 33 33 30 33 38 2d 30 39 33 38 32 20 2a 2f 0a 20 33038-09382 */.
4110: 20 20 20 70 53 74 61 72 74 20 3d 20 70 42 75 66 pStart = pBuf
4120: 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6c 6f 6f 6b ;. }. db->look
4130: 61 73 69 64 65 2e 70 53 74 61 72 74 20 3d 20 70 aside.pStart = p
4140: 53 74 61 72 74 3b 0a 20 20 64 62 2d 3e 6c 6f 6f Start;. db->loo
4150: 6b 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 30 kaside.pFree = 0
4160: 3b 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 ;. db->lookasid
4170: 65 2e 73 7a 20 3d 20 28 75 31 36 29 73 7a 3b 0a e.sz = (u16)sz;.
4180: 20 20 69 66 28 20 70 53 74 61 72 74 20 29 7b 0a if( pStart ){.
4190: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 4c int i;. L
41a0: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 3b ookasideSlot *p;
41b0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 7a 20 . assert( sz
41c0: 3e 20 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f > (int)sizeof(Lo
41d0: 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 3b okasideSlot*) );
41e0: 0a 20 20 20 20 70 20 3d 20 28 4c 6f 6f 6b 61 73 . p = (Lookas
41f0: 69 64 65 53 6c 6f 74 2a 29 70 53 74 61 72 74 3b ideSlot*)pStart;
4200: 0a 20 20 20 20 66 6f 72 28 69 3d 63 6e 74 2d 31 . for(i=cnt-1
4210: 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 ; i>=0; i--){.
4220: 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 64 p->pNext = d
4230: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 b->lookaside.pFr
4240: 65 65 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f ee;. db->lo
4250: 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 okaside.pFree =
4260: 70 3b 0a 20 20 20 20 20 20 70 20 3d 20 28 4c 6f p;. p = (Lo
4270: 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 26 28 28 okasideSlot*)&((
4280: 75 38 2a 29 70 29 5b 73 7a 5d 3b 0a 20 20 20 20 u8*)p)[sz];.
4290: 7d 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 }. db->lookas
42a0: 69 64 65 2e 70 45 6e 64 20 3d 20 70 3b 0a 20 20 ide.pEnd = p;.
42b0: 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e db->lookaside.
42c0: 62 45 6e 61 62 6c 65 64 20 3d 20 31 3b 0a 20 20 bEnabled = 1;.
42d0: 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e db->lookaside.
42e0: 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 70 42 75 66 bMalloced = pBuf
42f0: 3d 3d 30 20 3f 31 3a 30 3b 0a 20 20 7d 65 6c 73 ==0 ?1:0;. }els
4300: 65 7b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 e{. db->looka
4310: 73 69 64 65 2e 70 45 6e 64 20 3d 20 30 3b 0a 20 side.pEnd = 0;.
4320: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 db->lookaside
4330: 2e 62 45 6e 61 62 6c 65 64 20 3d 20 30 3b 0a 20 .bEnabled = 0;.
4340: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 db->lookaside
4350: 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 30 3b 0a .bMalloced = 0;.
4360: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
4370: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
4380: 20 52 65 74 75 72 6e 20 74 68 65 20 6d 75 74 65 Return the mute
4390: 78 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 x associated wit
43a0: 68 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e h a database con
43b0: 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c 69 nection..*/.sqli
43c0: 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 te3_mutex *sqlit
43d0: 65 33 5f 64 62 5f 6d 75 74 65 78 28 73 71 6c 69 e3_db_mutex(sqli
43e0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
43f0: 72 6e 20 64 62 2d 3e 6d 75 74 65 78 3b 0a 7d 0a rn db->mutex;.}.
4400: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 61 ./*.** Configura
4410: 74 69 6f 6e 20 73 65 74 74 69 6e 67 73 20 66 6f tion settings fo
4420: 72 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 r an individual
4430: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
4440: 69 6f 6e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ion.*/.int sqlit
4450: 65 33 5f 64 62 5f 63 6f 6e 66 69 67 28 73 71 6c e3_db_config(sql
4460: 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6f 70 ite3 *db, int op
4470: 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 , ...){. va_lis
4480: 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 3b 0a t ap;. int rc;.
4490: 20 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20 6f va_start(ap, o
44a0: 70 29 3b 0a 20 20 73 77 69 74 63 68 28 20 6f 70 p);. switch( op
44b0: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c ){. case SQL
44c0: 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f ITE_DBCONFIG_LOO
44d0: 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 KASIDE: {.
44e0: 76 6f 69 64 20 2a 70 42 75 66 20 3d 20 76 61 5f void *pBuf = va_
44f0: 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 20 arg(ap, void*);
4500: 2f 2a 20 49 4d 50 3a 20 52 2d 32 36 38 33 35 2d /* IMP: R-26835-
4510: 31 30 39 36 34 20 2a 2f 0a 20 20 20 20 20 20 69 10964 */. i
4520: 6e 74 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 nt sz = va_arg(a
4530: 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 20 2f p, int); /
4540: 2a 20 49 4d 50 3a 20 52 2d 34 37 38 37 31 2d 32 * IMP: R-47871-2
4550: 35 39 39 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 5994 */. in
4560: 74 20 63 6e 74 20 3d 20 76 61 5f 61 72 67 28 61 t cnt = va_arg(a
4570: 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 2f 2a p, int); /*
4580: 20 49 4d 50 3a 20 52 2d 30 34 34 36 30 2d 35 33 IMP: R-04460-53
4590: 33 38 36 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 386 */. rc
45a0: 3d 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 65 = setupLookaside
45b0: 28 64 62 2c 20 70 42 75 66 2c 20 73 7a 2c 20 63 (db, pBuf, sz, c
45c0: 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nt);. break
45d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 ;. }. defa
45e0: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 73 74 61 ult: {. sta
45f0: 74 69 63 20 63 6f 6e 73 74 20 73 74 72 75 63 74 tic const struct
4600: 20 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6f {. int o
4610: 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f p; /* The o
4620: 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 20 20 20 pcode */.
4630: 20 75 33 32 20 6d 61 73 6b 3b 20 20 20 20 2f 2a u32 mask; /*
4640: 20 4d 61 73 6b 20 6f 66 20 74 68 65 20 62 69 74 Mask of the bit
4650: 20 69 6e 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 in sqlite3.flag
4660: 73 20 74 6f 20 73 65 74 2f 63 6c 65 61 72 20 2a s to set/clear *
4670: 2f 0a 20 20 20 20 20 20 7d 20 61 46 6c 61 67 4f /. } aFlagO
4680: 70 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 p[] = {.
4690: 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 { SQLITE_DBCONFI
46a0: 47 5f 45 4e 41 42 4c 45 5f 46 4b 45 59 2c 20 20 G_ENABLE_FKEY,
46b0: 20 20 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e SQLITE_Foreign
46c0: 4b 65 79 73 20 20 20 20 7d 2c 0a 20 20 20 20 20 Keys },.
46d0: 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f { SQLITE_DBCO
46e0: 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 54 52 49 47 NFIG_ENABLE_TRIG
46f0: 47 45 52 2c 20 53 51 4c 49 54 45 5f 45 6e 61 62 GER, SQLITE_Enab
4700: 6c 65 54 72 69 67 67 65 72 20 20 7d 2c 0a 20 20 leTrigger },.
4710: 20 20 20 20 7d 3b 0a 20 20 20 20 20 20 75 6e 73 };. uns
4720: 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 20 20 20 igned int i;.
4730: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 rc = SQLITE_E
4740: 52 52 4f 52 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d RROR; /* IMP: R-
4750: 34 32 37 39 30 2d 32 33 33 37 32 20 2a 2f 0a 20 42790-23372 */.
4760: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c for(i=0; i<
4770: 41 72 72 61 79 53 69 7a 65 28 61 46 6c 61 67 4f ArraySize(aFlagO
4780: 70 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 p); i++){.
4790: 20 20 69 66 28 20 61 46 6c 61 67 4f 70 5b 69 5d if( aFlagOp[i]
47a0: 2e 6f 70 3d 3d 6f 70 20 29 7b 0a 20 20 20 20 20 .op==op ){.
47b0: 20 20 20 20 20 69 6e 74 20 6f 6e 6f 66 66 20 3d int onoff =
47c0: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
47d0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 ;. int
47e0: 2a 70 52 65 73 20 3d 20 76 61 5f 61 72 67 28 61 *pRes = va_arg(a
47f0: 70 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 20 20 20 p, int*);.
4800: 20 20 20 20 69 6e 74 20 6f 6c 64 46 6c 61 67 73 int oldFlags
4810: 20 3d 20 64 62 2d 3e 66 6c 61 67 73 3b 0a 20 20 = db->flags;.
4820: 20 20 20 20 20 20 20 20 69 66 28 20 6f 6e 6f 66 if( onof
4830: 66 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 f>0 ){.
4840: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 db->flags |=
4850: 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 3b aFlagOp[i].mask;
4860: 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 . }else
4870: 20 69 66 28 20 6f 6e 6f 66 66 3d 3d 30 20 29 7b if( onoff==0 ){
4880: 0a 20 20 20 20 20 20 20 20 20 20 20 20 64 62 2d . db-
4890: 3e 66 6c 61 67 73 20 26 3d 20 7e 61 46 6c 61 67 >flags &= ~aFlag
48a0: 4f 70 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 20 20 20 Op[i].mask;.
48b0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
48c0: 20 20 69 66 28 20 6f 6c 64 46 6c 61 67 73 21 3d if( oldFlags!=
48d0: 64 62 2d 3e 66 6c 61 67 73 20 29 7b 0a 20 20 20 db->flags ){.
48e0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
48f0: 45 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 ExpirePreparedSt
4900: 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 atements(db);.
4910: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
4920: 20 20 20 20 69 66 28 20 70 52 65 73 20 29 7b 0a if( pRes ){.
4930: 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 52 65 *pRe
4940: 73 20 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 s = (db->flags &
4950: 20 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b aFlagOp[i].mask
4960: 29 21 3d 30 3b 0a 20 20 20 20 20 20 20 20 20 20 )!=0;.
4970: 7d 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d }. rc =
4980: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
4990: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
49a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
49b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
49c0: 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 }. }. va_end(a
49d0: 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
49e0: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 .}.../*.** Retur
49f0: 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 62 75 n true if the bu
4a00: 66 66 65 72 20 7a 5b 30 2e 2e 6e 2d 31 5d 20 63 ffer z[0..n-1] c
4a10: 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 73 70 61 63 ontains all spac
4a20: 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e es..*/.static in
4a30: 74 20 61 6c 6c 53 70 61 63 65 73 28 63 6f 6e 73 t allSpaces(cons
4a40: 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e t char *z, int n
4a50: 29 7b 0a 20 20 77 68 69 6c 65 28 20 6e 3e 30 20 ){. while( n>0
4a60: 26 26 20 7a 5b 6e 2d 31 5d 3d 3d 27 20 27 20 29 && z[n-1]==' ' )
4a70: 7b 20 6e 2d 2d 3b 20 7d 0a 20 20 72 65 74 75 72 { n--; }. retur
4a80: 6e 20 6e 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n n==0;.}../*.**
4a90: 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 This is the def
4aa0: 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 ault collating f
4ab0: 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 unction named "B
4ac0: 49 4e 41 52 59 22 20 77 68 69 63 68 20 69 73 20 INARY" which is
4ad0: 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 always.** availa
4ae0: 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ble..**.** If th
4af0: 65 20 70 61 64 46 6c 61 67 20 61 72 67 75 6d 65 e padFlag argume
4b00: 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 nt is not NULL t
4b10: 68 65 6e 20 73 70 61 63 65 20 70 61 64 64 69 6e hen space paddin
4b20: 67 20 61 74 20 74 68 65 20 65 6e 64 0a 2a 2a 20 g at the end.**
4b30: 6f 66 20 73 74 72 69 6e 67 73 20 69 73 20 69 67 of strings is ig
4b40: 6e 6f 72 65 64 2e 20 20 54 68 69 73 20 69 6d 70 nored. This imp
4b50: 6c 65 6d 65 6e 74 73 20 74 68 65 20 52 54 52 49 lements the RTRI
4b60: 4d 20 63 6f 6c 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a M collation..*/.
4b70: 73 74 61 74 69 63 20 69 6e 74 20 62 69 6e 43 6f static int binCo
4b80: 6c 6c 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a llFunc(. void *
4b90: 70 61 64 46 6c 61 67 2c 0a 20 20 69 6e 74 20 6e padFlag,. int n
4ba0: 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 Key1, const void
4bb0: 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e *pKey1,. int n
4bc0: 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 Key2, const void
4bd0: 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 *pKey2.){. int
4be0: 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e 4b rc, n;. n = nK
4bf0: 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65 79 ey1<nKey2 ? nKey
4c00: 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 72 63 20 1 : nKey2;. rc
4c10: 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 31 2c 20 = memcmp(pKey1,
4c20: 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 69 66 28 pKey2, n);. if(
4c30: 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 rc==0 ){. if
4c40: 28 20 70 61 64 46 6c 61 67 0a 20 20 20 20 20 26 ( padFlag. &
4c50: 26 20 61 6c 6c 53 70 61 63 65 73 28 28 28 63 68 & allSpaces(((ch
4c60: 61 72 2a 29 70 4b 65 79 31 29 2b 6e 2c 20 6e 4b ar*)pKey1)+n, nK
4c70: 65 79 31 2d 6e 29 0a 20 20 20 20 20 26 26 20 61 ey1-n). && a
4c80: 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 72 2a llSpaces(((char*
4c90: 29 70 4b 65 79 32 29 2b 6e 2c 20 6e 4b 65 79 32 )pKey2)+n, nKey2
4ca0: 2d 6e 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 -n). ){.
4cb0: 20 2f 2a 20 4c 65 61 76 65 20 72 63 20 75 6e 63 /* Leave rc unc
4cc0: 68 61 6e 67 65 64 20 61 74 20 30 20 2a 2f 0a 20 hanged at 0 */.
4cd0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
4ce0: 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 rc = nKey1 - nKe
4cf0: 79 32 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 y2;. }. }.
4d00: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
4d10: 0a 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75 69 6c .** Another buil
4d20: 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 t-in collating s
4d30: 65 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e equence: NOCASE.
4d40: 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c .**.** This col
4d50: 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 lating sequence
4d60: 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 is intended to b
4d70: 65 20 75 73 65 64 20 66 6f 72 20 22 63 61 73 65 e used for "case
4d80: 20 69 6e 64 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 independant.**
4d90: 63 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c comparison". SQL
4da0: 69 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 ite's knowledge
4db0: 6f 66 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 of upper and low
4dc0: 65 72 20 63 61 73 65 20 65 71 75 69 76 61 6c 65 er case equivale
4dd0: 6e 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f nts.** extends o
4de0: 6e 6c 79 20 74 6f 20 74 68 65 20 32 36 20 63 68 nly to the 26 ch
4df0: 61 72 61 63 74 65 72 73 20 75 73 65 64 20 69 6e aracters used in
4e00: 20 74 68 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e the English lan
4e10: 67 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 guage..**.** At
4e20: 74 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 the moment there
4e30: 20 69 73 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 is only a UTF-8
4e40: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e implementation.
4e50: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e .*/.static int n
4e60: 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 ocaseCollatingFu
4e70: 6e 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 nc(. void *NotU
4e80: 73 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 sed,. int nKey1
4e90: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b , const void *pK
4ea0: 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 ey1,. int nKey2
4eb0: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b , const void *pK
4ec0: 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d ey2.){. int r =
4ed0: 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 sqlite3StrNICmp
4ee0: 28 0a 20 20 20 20 20 20 28 63 6f 6e 73 74 20 63 (. (const c
4ef0: 68 61 72 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f har *)pKey1, (co
4f00: 6e 73 74 20 63 68 61 72 20 2a 29 70 4b 65 79 32 nst char *)pKey2
4f10: 2c 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f , (nKey1<nKey2)?
4f20: 6e 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 nKey1:nKey2);.
4f30: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
4f40: 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 69 66 28 (NotUsed);. if(
4f50: 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 0==r ){. r =
4f60: 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 nKey1-nKey2;.
4f70: 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a }. return r;.}.
4f80: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
4f90: 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d e ROWID of the m
4fa0: 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 ost recent inser
4fb0: 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 t.*/.sqlite_int6
4fc0: 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 4 sqlite3_last_i
4fd0: 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 nsert_rowid(sqli
4fe0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
4ff0: 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 rn db->lastRowid
5000: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
5010: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
5020: 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d changes in the m
5030: 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 ost recent call
5040: 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 to sqlite3_exec(
5050: 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 )..*/.int sqlite
5060: 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 3_changes(sqlite
5070: 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 3 *db){. return
5080: 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a db->nChange;.}.
5090: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
50a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e e number of chan
50b0: 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 64 61 ges since the da
50c0: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 61 tabase handle wa
50d0: 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 s opened..*/.int
50e0: 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 sqlite3_total_c
50f0: 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a hanges(sqlite3 *
5100: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 db){. return db
5110: 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a ->nTotalChange;.
5120: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 }../*.** Close a
5130: 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e ll open savepoin
5140: 74 73 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f ts. This functio
5150: 6e 20 6f 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 n only manipulat
5160: 65 73 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 es fields of the
5170: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e .** database han
5180: 64 6c 65 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 dle object, it d
5190: 6f 65 73 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e oes not close an
51a0: 79 20 73 61 76 65 70 6f 69 6e 74 73 20 74 68 61 y savepoints tha
51b0: 74 20 6d 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a t may be open.**
51c0: 20 61 74 20 74 68 65 20 62 2d 74 72 65 65 2f 70 at the b-tree/p
51d0: 61 67 65 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 ager level..*/.v
51e0: 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 oid sqlite3Close
51f0: 53 61 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 Savepoints(sqlit
5200: 65 33 20 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 e3 *db){. while
5210: 28 20 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 ( db->pSavepoint
5220: 20 29 7b 0a 20 20 20 20 53 61 76 65 70 6f 69 6e ){. Savepoin
5230: 74 20 2a 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 t *pTmp = db->pS
5240: 61 76 65 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 avepoint;. db
5250: 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 ->pSavepoint = p
5260: 54 6d 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 Tmp->pNext;.
5270: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
5280: 2c 20 70 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 , pTmp);. }. d
5290: 62 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 b->nSavepoint =
52a0: 30 3b 0a 20 20 64 62 2d 3e 6e 53 74 61 74 65 6d 0;. db->nStatem
52b0: 65 6e 74 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 69 ent = 0;. db->i
52c0: 73 54 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 sTransactionSave
52d0: 70 6f 69 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a point = 0;.}../*
52e0: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 .** Invoke the d
52f0: 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 estructor functi
5300: 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 on associated wi
5310: 74 68 20 46 75 6e 63 44 65 66 20 70 2c 20 69 66 th FuncDef p, if
5320: 20 61 6e 79 2e 20 45 78 63 65 70 74 2c 0a 2a 2a any. Except,.**
5330: 20 69 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 if this is not
5340: 74 68 65 20 6c 61 73 74 20 63 6f 70 79 20 6f 66 the last copy of
5350: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 64 the function, d
5360: 6f 20 6e 6f 74 20 69 6e 76 6f 6b 65 20 69 74 2e o not invoke it.
5370: 20 4d 75 6c 74 69 70 6c 65 0a 2a 2a 20 63 6f 70 Multiple.** cop
5380: 69 65 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 ies of a single
5390: 66 75 6e 63 74 69 6f 6e 20 61 72 65 20 63 72 65 function are cre
53a0: 61 74 65 64 20 77 68 65 6e 20 63 72 65 61 74 65 ated when create
53b0: 5f 66 75 6e 63 74 69 6f 6e 28 29 20 69 73 20 63 _function() is c
53c0: 61 6c 6c 65 64 0a 2a 2a 20 77 69 74 68 20 53 51 alled.** with SQ
53d0: 4c 49 54 45 5f 41 4e 59 20 61 73 20 74 68 65 20 LITE_ANY as the
53e0: 65 6e 63 6f 64 69 6e 67 2e 0a 2a 2f 0a 73 74 61 encoding..*/.sta
53f0: 74 69 63 20 76 6f 69 64 20 66 75 6e 63 74 69 6f tic void functio
5400: 6e 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 nDestroy(sqlite3
5410: 20 2a 64 62 2c 20 46 75 6e 63 44 65 66 20 2a 70 *db, FuncDef *p
5420: 29 7b 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 ){. FuncDestruc
5430: 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 tor *pDestructor
5440: 20 3d 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f = p->pDestructo
5450: 72 3b 0a 20 20 69 66 28 20 70 44 65 73 74 72 75 r;. if( pDestru
5460: 63 74 6f 72 20 29 7b 0a 20 20 20 20 70 44 65 73 ctor ){. pDes
5470: 74 72 75 63 74 6f 72 2d 3e 6e 52 65 66 2d 2d 3b tructor->nRef--;
5480: 0a 20 20 20 20 69 66 28 20 70 44 65 73 74 72 75 . if( pDestru
5490: 63 74 6f 72 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b ctor->nRef==0 ){
54a0: 0a 20 20 20 20 20 20 70 44 65 73 74 72 75 63 74 . pDestruct
54b0: 6f 72 2d 3e 78 44 65 73 74 72 6f 79 28 70 44 65 or->xDestroy(pDe
54c0: 73 74 72 75 63 74 6f 72 2d 3e 70 55 73 65 72 44 structor->pUserD
54d0: 61 74 61 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 ata);. sqli
54e0: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 44 te3DbFree(db, pD
54f0: 65 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 estructor);.
5500: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 }. }.}../*.** C
5510: 6c 6f 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 lose an existing
5520: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
5530: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
5540: 63 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a 64 close(sqlite3 *d
5550: 62 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a b){. HashElem *
5560: 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
5570: 20 20 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 /* Hash ta
5580: 62 6c 65 20 69 74 65 72 61 74 6f 72 20 2a 2f 0a ble iterator */.
5590: 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 int j;.. if(
55a0: 21 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 !db ){. retur
55b0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
55c0: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
55d0: 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 afetyCheckSickOr
55e0: 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 Ok(db) ){. re
55f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
5600: 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 SE_BKPT;. }. s
5610: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
5620: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 0a er(db->mutex);..
5630: 20 20 2f 2a 20 46 6f 72 63 65 20 78 44 65 73 74 /* Force xDest
5640: 72 6f 79 20 63 61 6c 6c 73 20 6f 6e 20 61 6c 6c roy calls on all
5650: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
5660: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 52 65 73 65 */. sqlite3Rese
5670: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 tInternalSchema(
5680: 64 62 2c 20 2d 31 29 3b 0a 0a 20 20 2f 2a 20 49 db, -1);.. /* I
5690: 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 f a transaction
56a0: 69 73 20 6f 70 65 6e 2c 20 74 68 65 20 52 65 73 is open, the Res
56b0: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 etInternalSchema
56c0: 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 0a 20 20 () call above.
56d0: 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 61 76 65 ** will not have
56e0: 20 63 61 6c 6c 65 64 20 74 68 65 20 78 44 69 73 called the xDis
56f0: 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f 64 connect() method
5700: 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 61 6c 0a on any virtual.
5710: 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 74 ** tables in t
5720: 68 65 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b 5d he db->aVTrans[]
5730: 20 61 72 72 61 79 2e 20 54 68 65 20 66 6f 6c 6c array. The foll
5740: 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 56 74 61 owing sqlite3Vta
5750: 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 20 2a 2a bRollback(). **
5760: 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 6f call will do so
5770: 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 64 6f 20 . We need to do
5780: 74 68 69 73 20 62 65 66 6f 72 65 20 74 68 65 20 this before the
5790: 63 68 65 63 6b 20 66 6f 72 20 61 63 74 69 76 65 check for active
57a0: 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d . ** SQL statem
57b0: 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 73 20 74 ents below, as t
57c0: 68 65 20 76 2d 74 61 62 6c 65 20 69 6d 70 6c 65 he v-table imple
57d0: 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 20 62 65 mentation may be
57e0: 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 6f storing. ** so
57f0: 6d 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 me prepared stat
5800: 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e 61 6c 6c ements internall
5810: 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 y.. */. sqlite
5820: 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 62 3VtabRollback(db
5830: 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 );.. /* If ther
5840: 65 20 61 72 65 20 61 6e 79 20 6f 75 74 73 74 61 e are any outsta
5850: 6e 64 69 6e 67 20 56 4d 73 2c 20 72 65 74 75 72 nding VMs, retur
5860: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 2a n SQLITE_BUSY. *
5870: 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70 56 64 62 /. if( db->pVdb
5880: 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 e ){. sqlite3
5890: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
58a0: 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 _BUSY, .
58b0: 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 65 "unable to close
58c0: 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c 69 due to unfinali
58d0: 73 65 64 20 73 74 61 74 65 6d 65 6e 74 73 22 29 sed statements")
58e0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 ;. sqlite3_mu
58f0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
5900: 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e tex);. return
5910: 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 SQLITE_BUSY;.
5920: 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 }. assert( sqli
5930: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 te3SafetyCheckSi
5940: 63 6b 4f 72 4f 6b 28 64 62 29 20 29 3b 0a 0a 20 ckOrOk(db) );..
5950: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e for(j=0; j<db->
5960: 6e 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 42 nDb; j++){. B
5970: 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e tree *pBt = db->
5980: 61 44 62 5b 6a 5d 2e 70 42 74 3b 0a 20 20 20 20 aDb[j].pBt;.
5990: 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 if( pBt && sqlit
59a0: 65 33 42 74 72 65 65 49 73 49 6e 42 61 63 6b 75 e3BtreeIsInBacku
59b0: 70 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 p(pBt) ){.
59c0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
59d0: 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 SQLITE_BUSY, .
59e0: 20 20 20 20 20 20 20 20 20 22 75 6e 61 62 6c 65 "unable
59f0: 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20 74 6f to close due to
5a00: 20 75 6e 66 69 6e 69 73 68 65 64 20 62 61 63 6b unfinished back
5a10: 75 70 20 6f 70 65 72 61 74 69 6f 6e 22 29 3b 0a up operation");.
5a20: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
5a30: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
5a40: 74 65 78 29 3b 0a 20 20 20 20 20 20 72 65 74 75 tex);. retu
5a50: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a rn SQLITE_BUSY;.
5a60: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
5a70: 46 72 65 65 20 61 6e 79 20 6f 75 74 73 74 61 6e Free any outstan
5a80: 64 69 6e 67 20 53 61 76 65 70 6f 69 6e 74 20 73 ding Savepoint s
5a90: 74 72 75 63 74 75 72 65 73 2e 20 2a 2f 0a 20 20 tructures. */.
5aa0: 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 65 sqlite3CloseSave
5ab0: 70 6f 69 6e 74 73 28 64 62 29 3b 0a 0a 20 20 66 points(db);.. f
5ac0: 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 or(j=0; j<db->nD
5ad0: 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 b; j++){. str
5ae0: 75 63 74 20 44 62 20 2a 70 44 62 20 3d 20 26 64 uct Db *pDb = &d
5af0: 62 2d 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 b->aDb[j];. i
5b00: 66 28 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 f( pDb->pBt ){.
5b10: 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 sqlite3Btre
5b20: 65 43 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 eClose(pDb->pBt)
5b30: 3b 0a 20 20 20 20 20 20 70 44 62 2d 3e 70 42 74 ;. pDb->pBt
5b40: 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 = 0;. if(
5b50: 6a 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 j!=1 ){.
5b60: 70 44 62 2d 3e 70 53 63 68 65 6d 61 20 3d 20 30 pDb->pSchema = 0
5b70: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
5b80: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 73 }. sqlite3Res
5b90: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 etInternalSchema
5ba0: 28 64 62 2c 20 2d 31 29 3b 0a 0a 20 20 2f 2a 20 (db, -1);.. /*
5bb0: 54 65 6c 6c 20 74 68 65 20 63 6f 64 65 20 69 6e Tell the code in
5bc0: 20 6e 6f 74 69 66 79 2e 63 20 74 68 61 74 20 74 notify.c that t
5bd0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6e 6f he connection no
5be0: 20 6c 6f 6e 67 65 72 20 68 6f 6c 64 73 20 61 6e longer holds an
5bf0: 79 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 61 6e 64 y. ** locks and
5c00: 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 does not requir
5c10: 65 20 61 6e 79 20 66 75 72 74 68 65 72 20 75 6e e any further un
5c20: 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c 6c lock-notify call
5c30: 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 backs.. */. sq
5c40: 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 lite3ConnectionC
5c50: 6c 6f 73 65 64 28 64 62 29 3b 0a 0a 20 20 61 73 losed(db);.. as
5c60: 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d 32 sert( db->nDb<=2
5c70: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 );. assert( db
5c80: 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53 74 ->aDb==db->aDbSt
5c90: 61 74 69 63 20 29 3b 0a 20 20 66 6f 72 28 6a 3d atic );. for(j=
5ca0: 30 3b 20 6a 3c 41 72 72 61 79 53 69 7a 65 28 64 0; j<ArraySize(d
5cb0: 62 2d 3e 61 46 75 6e 63 2e 61 29 3b 20 6a 2b 2b b->aFunc.a); j++
5cc0: 29 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a ){. FuncDef *
5cd0: 70 4e 65 78 74 2c 20 2a 70 48 61 73 68 2c 20 2a pNext, *pHash, *
5ce0: 70 3b 0a 20 20 20 20 66 6f 72 28 70 3d 64 62 2d p;. for(p=db-
5cf0: 3e 61 46 75 6e 63 2e 61 5b 6a 5d 3b 20 70 3b 20 >aFunc.a[j]; p;
5d00: 70 3d 70 48 61 73 68 29 7b 0a 20 20 20 20 20 20 p=pHash){.
5d10: 70 48 61 73 68 20 3d 20 70 2d 3e 70 48 61 73 68 pHash = p->pHash
5d20: 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 70 ;. while( p
5d30: 20 29 7b 0a 20 20 20 20 20 20 20 20 66 75 6e 63 ){. func
5d40: 74 69 6f 6e 44 65 73 74 72 6f 79 28 64 62 2c 20 tionDestroy(db,
5d50: 70 29 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 p);. pNex
5d60: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 t = p->pNext;.
5d70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 sqlite3DbF
5d80: 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 ree(db, p);.
5d90: 20 20 20 20 70 20 3d 20 70 4e 65 78 74 3b 0a 20 p = pNext;.
5da0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
5db0: 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 . for(i=sqliteH
5dc0: 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 43 ashFirst(&db->aC
5dd0: 6f 6c 6c 53 65 71 29 3b 20 69 3b 20 69 3d 73 71 ollSeq); i; i=sq
5de0: 6c 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 liteHashNext(i))
5df0: 7b 0a 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 {. CollSeq *p
5e00: 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 20 Coll = (CollSeq
5e10: 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 *)sqliteHashData
5e20: 28 69 29 3b 0a 20 20 20 20 2f 2a 20 49 6e 76 6f (i);. /* Invo
5e30: 6b 65 20 61 6e 79 20 64 65 73 74 72 75 63 74 6f ke any destructo
5e40: 72 73 20 72 65 67 69 73 74 65 72 65 64 20 66 6f rs registered fo
5e50: 72 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 r collation sequ
5e60: 65 6e 63 65 20 75 73 65 72 20 64 61 74 61 2e 20 ence user data.
5e70: 2a 2f 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 */. for(j=0;
5e80: 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 j<3; j++){.
5e90: 20 69 66 28 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 if( pColl[j].xD
5ea0: 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 el ){. pC
5eb0: 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 28 70 43 6f 6c oll[j].xDel(pCol
5ec0: 6c 5b 6a 5d 2e 70 55 73 65 72 29 3b 0a 20 20 20 l[j].pUser);.
5ed0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 }. }. s
5ee0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
5ef0: 20 70 43 6f 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 pColl);. }. s
5f00: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 qlite3HashClear(
5f10: 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a &db->aCollSeq);.
5f20: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
5f30: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
5f40: 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 . for(i=sqliteH
5f50: 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 4d ashFirst(&db->aM
5f60: 6f 64 75 6c 65 29 3b 20 69 3b 20 69 3d 73 71 6c odule); i; i=sql
5f70: 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b iteHashNext(i)){
5f80: 0a 20 20 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f . Module *pMo
5f90: 64 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 d = (Module *)sq
5fa0: 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b liteHashData(i);
5fb0: 0a 20 20 20 20 69 66 28 20 70 4d 6f 64 2d 3e 78 . if( pMod->x
5fc0: 44 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 Destroy ){.
5fd0: 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 28 pMod->xDestroy(
5fe0: 70 4d 6f 64 2d 3e 70 41 75 78 29 3b 0a 20 20 20 pMod->pAux);.
5ff0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 }. sqlite3Db
6000: 46 72 65 65 28 64 62 2c 20 70 4d 6f 64 29 3b 0a Free(db, pMod);.
6010: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 }. sqlite3Has
6020: 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 4d 6f 64 hClear(&db->aMod
6030: 75 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 ule);.#endif..
6040: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
6050: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 SQLITE_OK, 0);
6060: 2f 2a 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 /* Deallocates a
6070: 6e 79 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 ny cached error
6080: 73 74 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 strings. */. if
6090: 28 20 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 ( db->pErr ){.
60a0: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 sqlite3ValueFr
60b0: 65 65 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 ee(db->pErr);.
60c0: 7d 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 }. sqlite3Close
60d0: 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a Extensions(db);.
60e0: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
60f0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f QLITE_MAGIC_ERRO
6100: 52 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d R;.. /* The tem
6110: 70 2d 64 61 74 61 62 61 73 65 20 73 63 68 65 6d p-database schem
6120: 61 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 a is allocated d
6130: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 ifferently from
6140: 74 68 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61 the other schema
6150: 0a 20 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 . ** objects (u
6160: 73 69 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f sing sqliteMallo
6170: 63 28 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e c() directly, in
6180: 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33 stead of sqlite3
6190: 42 74 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a BtreeSchema())..
61a0: 20 20 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 ** So it needs
61b0: 20 74 6f 20 62 65 20 66 72 65 65 64 20 68 65 72 to be freed her
61c0: 65 2e 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 e. Todo: Why not
61d0: 20 72 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 roll the temp s
61e0: 63 68 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 chema into. **
61f0: 74 68 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d the same sqliteM
6200: 61 6c 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f alloc() as the o
6210: 6e 65 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 ne that allocate
6220: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a s the database .
6230: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a ** structure?.
6240: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 44 62 */. sqlite3Db
6250: 46 72 65 65 28 64 62 2c 20 64 62 2d 3e 61 44 62 Free(db, db->aDb
6260: 5b 31 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 [1].pSchema);.
6270: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
6280: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
6290: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 db->magic = SQ
62a0: 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 LITE_MAGIC_CLOSE
62b0: 44 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 D;. sqlite3_mut
62c0: 65 78 5f 66 72 65 65 28 64 62 2d 3e 6d 75 74 65 ex_free(db->mute
62d0: 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 x);. assert( db
62e0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 ->lookaside.nOut
62f0: 3d 3d 30 20 29 3b 20 20 2f 2a 20 46 61 69 6c 73 ==0 ); /* Fails
6300: 20 6f 6e 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 on a lookaside
6310: 6d 65 6d 6f 72 79 20 6c 65 61 6b 20 2a 2f 0a 20 memory leak */.
6320: 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 if( db->lookasi
6330: 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a de.bMalloced ){.
6340: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
6350: 28 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 (db->lookaside.p
6360: 53 74 61 72 74 29 3b 0a 20 20 7d 0a 20 20 73 71 Start);. }. sq
6370: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 3b 0a lite3_free(db);.
6380: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
6390: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c OK;.}../*.** Rol
63a0: 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74 61 62 61 lback all databa
63b0: 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 se files..*/.voi
63c0: 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 d sqlite3Rollbac
63d0: 6b 41 6c 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 kAll(sqlite3 *db
63e0: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e ){. int i;. in
63f0: 74 20 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 t inTrans = 0;.
6400: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
6410: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e _mutex_held(db->
6420: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
6430: 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 te3BeginBenignMa
6440: 6c 6c 6f 63 28 29 3b 0a 20 20 66 6f 72 28 69 3d lloc();. for(i=
6450: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
6460: 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e +){. if( db->
6470: 61 44 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 aDb[i].pBt ){.
6480: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 if( sqlite3B
6490: 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 64 62 treeIsInTrans(db
64a0: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 20 29 7b ->aDb[i].pBt) ){
64b0: 0a 20 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 . inTrans
64c0: 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 1;. }.
64d0: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
64e0: 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 Rollback(db->aDb
64f0: 5b 69 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 [i].pBt);.
6500: 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 db->aDb[i].inTra
6510: 6e 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 ns = 0;. }.
6520: 7d 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 52 }. sqlite3VtabR
6530: 6f 6c 6c 62 61 63 6b 28 64 62 29 3b 0a 20 20 73 ollback(db);. s
6540: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
6550: 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 69 66 28 20 alloc();.. if(
6560: 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 db->flags&SQLITE
6570: 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 _InternChanges )
6580: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 {. sqlite3Exp
6590: 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
65a0: 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 73 ments(db);. s
65b0: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 qlite3ResetInter
65c0: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 2d 31 nalSchema(db, -1
65d0: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 6e 79 );. }.. /* Any
65e0: 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 deferred constr
65f0: 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 73 20 aint violations
6600: 68 61 76 65 20 6e 6f 77 20 62 65 65 6e 20 72 65 have now been re
6610: 73 6f 6c 76 65 64 2e 20 2a 2f 0a 20 20 64 62 2d solved. */. db-
6620: 3e 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 20 3d >nDeferredCons =
6630: 20 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 0;.. /* If one
6640: 20 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 has been config
6650: 75 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 ured, invoke the
6660: 20 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 rollback-hook c
6670: 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 allback */. if(
6680: 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 db->xRollbackCa
6690: 6c 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 llback && (inTra
66a0: 6e 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 ns || !db->autoC
66b0: 6f 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 ommit) ){. db
66c0: 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 ->xRollbackCallb
66d0: 61 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 ack(db->pRollbac
66e0: 6b 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a kArg);. }.}../*
66f0: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 .** Return a sta
6700: 74 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 tic string that
6710: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 describes the ki
6720: 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 nd of error spec
6730: 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 ified in the.**
6740: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e argument..*/.con
6750: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
6760: 45 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a ErrStr(int rc){.
6770: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 static const c
6780: 68 61 72 2a 20 63 6f 6e 73 74 20 61 4d 73 67 5b har* const aMsg[
6790: 5d 20 3d 20 7b 0a 20 20 20 20 2f 2a 20 53 51 4c ] = {. /* SQL
67a0: 49 54 45 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 ITE_OK
67b0: 2a 2f 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 */ "not an error
67c0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
67d0: 5f 45 52 52 4f 52 20 20 20 20 20 20 20 2a 2f 20 _ERROR */
67e0: 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 "SQL logic error
67f0: 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 or missing data
6800: 62 61 73 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 base",. /* SQ
6810: 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c 20 20 20 LITE_INTERNAL
6820: 20 2a 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 53 51 */ 0,. /* SQ
6830: 4c 49 54 45 5f 50 45 52 4d 20 20 20 20 20 20 20 LITE_PERM
6840: 20 2a 2f 20 22 61 63 63 65 73 73 20 70 65 72 6d */ "access perm
6850: 69 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a ission denied",.
6860: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 41 42 /* SQLITE_AB
6870: 4f 52 54 20 20 20 20 20 20 20 2a 2f 20 22 63 61 ORT */ "ca
6880: 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 llback requested
6890: 20 71 75 65 72 79 20 61 62 6f 72 74 22 2c 0a 20 query abort",.
68a0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 42 55 53 /* SQLITE_BUS
68b0: 59 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61 74 Y */ "dat
68c0: 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 abase is locked"
68d0: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
68e0: 4c 4f 43 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 LOCKED */ "
68f0: 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 database table i
6900: 73 20 6c 6f 63 6b 65 64 22 2c 0a 20 20 20 20 2f s locked",. /
6910: 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 * SQLITE_NOMEM
6920: 20 20 20 20 20 2a 2f 20 22 6f 75 74 20 6f 66 20 */ "out of
6930: 6d 65 6d 6f 72 79 22 2c 0a 20 20 20 20 2f 2a 20 memory",. /*
6940: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 SQLITE_READONLY
6950: 20 20 20 2a 2f 20 22 61 74 74 65 6d 70 74 20 74 */ "attempt t
6960: 6f 20 77 72 69 74 65 20 61 20 72 65 61 64 6f 6e o write a readon
6970: 6c 79 20 64 61 74 61 62 61 73 65 22 2c 0a 20 20 ly database",.
6980: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 /* SQLITE_INTE
6990: 52 52 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 RRUPT */ "inte
69a0: 72 72 75 70 74 65 64 22 2c 0a 20 20 20 20 2f 2a rrupted",. /*
69b0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 20 20 SQLITE_IOERR
69c0: 20 20 20 20 2a 2f 20 22 64 69 73 6b 20 49 2f 4f */ "disk I/O
69d0: 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 error",. /*
69e0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 20 SQLITE_CORRUPT
69f0: 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 */ "database
6a00: 64 69 73 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 disk image is ma
6a10: 6c 66 6f 72 6d 65 64 22 2c 0a 20 20 20 20 2f 2a lformed",. /*
6a20: 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 SQLITE_NOTFOUND
6a30: 20 20 20 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 */ "unknown
6a40: 6f 70 65 72 61 74 69 6f 6e 22 2c 0a 20 20 20 20 operation",.
6a50: 2f 2a 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 20 /* SQLITE_FULL
6a60: 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 */ "databa
6a70: 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20 66 75 se or disk is fu
6a80: 6c 6c 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ll",. /* SQLI
6a90: 54 45 5f 43 41 4e 54 4f 50 45 4e 20 20 20 20 2a TE_CANTOPEN *
6aa0: 2f 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 / "unable to ope
6ab0: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 n database file"
6ac0: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
6ad0: 50 52 4f 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 PROTOCOL */ "
6ae0: 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c locking protocol
6af0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
6b00: 5f 45 4d 50 54 59 20 20 20 20 20 20 20 2a 2f 20 _EMPTY */
6b10: 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 "table contains
6b20: 6e 6f 20 64 61 74 61 22 2c 0a 20 20 20 20 2f 2a no data",. /*
6b30: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 20 SQLITE_SCHEMA
6b40: 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 */ "database
6b50: 20 73 63 68 65 6d 61 20 68 61 73 20 63 68 61 6e schema has chan
6b60: 67 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ged",. /* SQL
6b70: 49 54 45 5f 54 4f 4f 42 49 47 20 20 20 20 20 20 ITE_TOOBIG
6b80: 2a 2f 20 22 73 74 72 69 6e 67 20 6f 72 20 62 6c */ "string or bl
6b90: 6f 62 20 74 6f 6f 20 62 69 67 22 2c 0a 20 20 20 ob too big",.
6ba0: 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 /* SQLITE_CONST
6bb0: 52 41 49 4e 54 20 20 2a 2f 20 22 63 6f 6e 73 74 RAINT */ "const
6bc0: 72 61 69 6e 74 20 66 61 69 6c 65 64 22 2c 0a 20 raint failed",.
6bd0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 /* SQLITE_MIS
6be0: 4d 41 54 43 48 20 20 20 20 2a 2f 20 22 64 61 74 MATCH */ "dat
6bf0: 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 2c atype mismatch",
6c00: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d . /* SQLITE_M
6c10: 49 53 55 53 45 20 20 20 20 20 20 2a 2f 20 22 6c ISUSE */ "l
6c20: 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 ibrary routine c
6c30: 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 alled out of seq
6c40: 75 65 6e 63 65 22 2c 0a 20 20 20 20 2f 2a 20 53 uence",. /* S
6c50: 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 20 20 20 20 QLITE_NOLFS
6c60: 20 20 2a 2f 20 22 6c 61 72 67 65 20 66 69 6c 65 */ "large file
6c70: 20 73 75 70 70 6f 72 74 20 69 73 20 64 69 73 61 support is disa
6c80: 62 6c 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 bled",. /* SQ
6c90: 4c 49 54 45 5f 41 55 54 48 20 20 20 20 20 20 20 LITE_AUTH
6ca0: 20 2a 2f 20 22 61 75 74 68 6f 72 69 7a 61 74 69 */ "authorizati
6cb0: 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 on denied",.
6cc0: 2f 2a 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 /* SQLITE_FORMAT
6cd0: 20 20 20 20 20 20 2a 2f 20 22 61 75 78 69 6c 69 */ "auxili
6ce0: 61 72 79 20 64 61 74 61 62 61 73 65 20 66 6f 72 ary database for
6cf0: 6d 61 74 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 mat error",.
6d00: 2f 2a 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 /* SQLITE_RANGE
6d10: 20 20 20 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f */ "bind o
6d20: 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f r column index o
6d30: 75 74 20 6f 66 20 72 61 6e 67 65 22 2c 0a 20 20 ut of range",.
6d40: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 41 /* SQLITE_NOTA
6d50: 44 42 20 20 20 20 20 20 2a 2f 20 22 66 69 6c 65 DB */ "file
6d60: 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72 is encrypted or
6d70: 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61 is not a databa
6d80: 73 65 22 2c 0a 20 20 7d 3b 0a 20 20 72 63 20 26 se",. };. rc &
6d90: 3d 20 30 78 66 66 3b 0a 20 20 69 66 28 20 41 4c = 0xff;. if( AL
6da0: 57 41 59 53 28 72 63 3e 3d 30 29 20 26 26 20 72 WAYS(rc>=0) && r
6db0: 63 3c 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 61 c<(int)(sizeof(a
6dc0: 4d 73 67 29 2f 73 69 7a 65 6f 66 28 61 4d 73 67 Msg)/sizeof(aMsg
6dd0: 5b 30 5d 29 29 20 26 26 20 61 4d 73 67 5b 72 63 [0])) && aMsg[rc
6de0: 5d 21 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 ]!=0 ){. retu
6df0: 72 6e 20 61 4d 73 67 5b 72 63 5d 3b 0a 20 20 7d rn aMsg[rc];. }
6e00: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e else{. return
6e10: 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 "unknown error"
6e20: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 ;. }.}../*.** T
6e30: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c his routine impl
6e40: 65 6d 65 6e 74 73 20 61 20 62 75 73 79 20 63 61 ements a busy ca
6e50: 6c 6c 62 61 63 6b 20 74 68 61 74 20 73 6c 65 65 llback that slee
6e60: 70 73 20 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 ps and tries.**
6e70: 61 67 61 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 again until a ti
6e80: 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 20 72 meout value is r
6e90: 65 61 63 68 65 64 2e 20 20 54 68 65 20 74 69 6d eached. The tim
6ea0: 65 6f 75 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a eout value is.**
6eb0: 20 61 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 an integer numb
6ec0: 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e er of millisecon
6ed0: 64 73 20 70 61 73 73 65 64 20 69 6e 20 61 73 20 ds passed in as
6ee0: 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 the first.** arg
6ef0: 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 ument..*/.static
6f00: 20 69 6e 74 20 73 71 6c 69 74 65 44 65 66 61 75 int sqliteDefau
6f10: 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a ltBusyCallback(.
6f20: 20 76 6f 69 64 20 2a 70 74 72 2c 20 20 20 20 20 void *ptr,
6f30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 /* Dat
6f40: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
6f50: 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74 20 20 */. int count
6f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
6f70: 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 Number of times
6f80: 20 74 61 62 6c 65 20 68 61 73 20 62 65 65 6e 20 table has been
6f90: 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 busy */.){.#if S
6fa0: 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 20 7c 7c 20 QLITE_OS_WIN ||
6fb0: 28 64 65 66 69 6e 65 64 28 48 41 56 45 5f 55 53 (defined(HAVE_US
6fc0: 4c 45 45 50 29 20 26 26 20 48 41 56 45 5f 55 53 LEEP) && HAVE_US
6fd0: 4c 45 45 50 29 0a 20 20 73 74 61 74 69 63 20 63 LEEP). static c
6fe0: 6f 6e 73 74 20 75 38 20 64 65 6c 61 79 73 5b 5d onst u8 delays[]
6ff0: 20 3d 0a 20 20 20 20 20 7b 20 31 2c 20 32 2c 20 =. { 1, 2,
7000: 35 2c 20 31 30 2c 20 31 35 2c 20 32 30 2c 20 32 5, 10, 15, 20, 2
7010: 35 2c 20 32 35 2c 20 20 32 35 2c 20 20 35 30 2c 5, 25, 25, 50,
7020: 20 20 35 30 2c 20 31 30 30 20 7d 3b 0a 20 20 73 50, 100 };. s
7030: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 74 tatic const u8 t
7040: 6f 74 61 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b otals[] =. {
7050: 20 30 2c 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 0, 1, 3, 8, 18
7060: 2c 20 33 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 , 33, 53, 78, 10
7070: 33 2c 20 31 32 38 2c 20 31 37 38 2c 20 32 32 38 3, 128, 178, 228
7080: 20 7d 3b 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 };.# define NDE
7090: 4c 41 59 20 41 72 72 61 79 53 69 7a 65 28 64 65 LAY ArraySize(de
70a0: 6c 61 79 73 29 0a 20 20 73 71 6c 69 74 65 33 20 lays). sqlite3
70b0: 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 33 20 2a *db = (sqlite3 *
70c0: 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d 65 )ptr;. int time
70d0: 6f 75 74 20 3d 20 64 62 2d 3e 62 75 73 79 54 69 out = db->busyTi
70e0: 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65 6c meout;. int del
70f0: 61 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 61 73 ay, prior;.. as
7100: 73 65 72 74 28 20 63 6f 75 6e 74 3e 3d 30 20 29 sert( count>=0 )
7110: 3b 0a 20 20 69 66 28 20 63 6f 75 6e 74 20 3c 20 ;. if( count <
7120: 4e 44 45 4c 41 59 20 29 7b 0a 20 20 20 20 64 65 NDELAY ){. de
7130: 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b 63 6f 75 lay = delays[cou
7140: 6e 74 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d nt];. prior =
7150: 20 74 6f 74 61 6c 73 5b 63 6f 75 6e 74 5d 3b 0a totals[count];.
7160: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c }else{. del
7170: 61 79 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c ay = delays[NDEL
7180: 41 59 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 AY-1];. prior
7190: 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 = totals[NDELAY
71a0: 2d 31 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75 -1] + delay*(cou
71b0: 6e 74 2d 28 4e 44 45 4c 41 59 2d 31 29 29 3b 0a nt-(NDELAY-1));.
71c0: 20 20 7d 0a 20 20 69 66 28 20 70 72 69 6f 72 20 }. if( prior
71d0: 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 + delay > timeou
71e0: 74 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d t ){. delay =
71f0: 20 74 69 6d 65 6f 75 74 20 2d 20 70 72 69 6f 72 timeout - prior
7200: 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c ;. if( delay<
7210: 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 =0 ) return 0;.
7220: 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c }. sqlite3OsSl
7230: 65 65 70 28 64 62 2d 3e 70 56 66 73 2c 20 64 65 eep(db->pVfs, de
7240: 6c 61 79 2a 31 30 30 30 29 3b 0a 20 20 72 65 74 lay*1000);. ret
7250: 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 73 urn 1;.#else. s
7260: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 28 73 71 qlite3 *db = (sq
7270: 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a 20 20 69 lite3 *)ptr;. i
7280: 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 nt timeout = ((s
7290: 71 6c 69 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 qlite3 *)ptr)->b
72a0: 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 usyTimeout;. if
72b0: 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 ( (count+1)*1000
72c0: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 > timeout ){.
72d0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a return 0;. }.
72e0: 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 sqlite3OsSleep
72f0: 28 64 62 2d 3e 70 56 66 73 2c 20 31 30 30 30 30 (db->pVfs, 10000
7300: 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 00);. return 1;
7310: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
7320: 20 49 6e 76 6f 6b 65 20 74 68 65 20 67 69 76 65 Invoke the give
7330: 6e 20 62 75 73 79 20 68 61 6e 64 6c 65 72 2e 0a n busy handler..
7340: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
7350: 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 ne is called whe
7360: 6e 20 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 66 n an operation f
7370: 61 69 6c 65 64 20 77 69 74 68 20 61 20 6c 6f 63 ailed with a loc
7380: 6b 2e 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f k..** If this ro
7390: 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 6e 6f utine returns no
73a0: 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b n-zero, the lock
73b0: 20 69 73 20 72 65 74 72 69 65 64 2e 20 20 49 66 is retried. If
73c0: 20 69 74 0a 2a 2a 20 72 65 74 75 72 6e 73 20 30 it.** returns 0
73d0: 2c 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 , the operation
73e0: 61 62 6f 72 74 73 20 77 69 74 68 20 61 6e 20 53 aborts with an S
73f0: 51 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 QLITE_BUSY error
7400: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
7410: 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
7420: 72 28 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 70 r(BusyHandler *p
7430: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 ){. int rc;. i
7440: 66 28 20 4e 45 56 45 52 28 70 3d 3d 30 29 20 7c f( NEVER(p==0) |
7450: 7c 20 70 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c 7c | p->xFunc==0 ||
7460: 20 70 2d 3e 6e 42 75 73 79 3c 30 20 29 20 72 65 p->nBusy<0 ) re
7470: 74 75 72 6e 20 30 3b 0a 20 20 72 63 20 3d 20 70 turn 0;. rc = p
7480: 2d 3e 78 46 75 6e 63 28 70 2d 3e 70 41 72 67 2c ->xFunc(p->pArg,
7490: 20 70 2d 3e 6e 42 75 73 79 29 3b 0a 20 20 69 66 p->nBusy);. if
74a0: 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 70 ( rc==0 ){. p
74b0: 2d 3e 6e 42 75 73 79 20 3d 20 2d 31 3b 0a 20 20 ->nBusy = -1;.
74c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e 42 }else{. p->nB
74d0: 75 73 79 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 usy++;. }. ret
74e0: 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a 2a urn rc; .}../*.*
74f0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 * This routine s
7500: 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 6c ets the busy cal
7510: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c lback for an Sql
7520: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 ite database to
7530: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c the.** given cal
7540: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 lback function w
7550: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 ith the given ar
7560: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 gument..*/.int s
7570: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 qlite3_busy_hand
7580: 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20 2a ler(. sqlite3 *
7590: 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 db,. int (*xBus
75a0: 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20 y)(void*,int),.
75b0: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 void *pArg.){.
75c0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
75d0: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
75e0: 0a 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c . db->busyHandl
75f0: 65 72 2e 78 46 75 6e 63 20 3d 20 78 42 75 73 79 er.xFunc = xBusy
7600: 3b 0a 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 ;. db->busyHand
7610: 6c 65 72 2e 70 41 72 67 20 3d 20 70 41 72 67 3b ler.pArg = pArg;
7620: 0a 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c . db->busyHandl
7630: 65 72 2e 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 er.nBusy = 0;.
7640: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
7650: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
7660: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
7670: 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 OK;.}..#ifndef S
7680: 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 QLITE_OMIT_PROGR
7690: 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a ESS_CALLBACK./*.
76a0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
76b0: 73 65 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 sets the progres
76c0: 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 s callback for a
76d0: 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 n Sqlite databas
76e0: 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 e to the.** give
76f0: 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 n callback funct
7700: 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 ion with the giv
7710: 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 en argument. The
7720: 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 progress callba
7730: 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e ck will.** be in
7740: 76 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 voked every nOps
7750: 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 opcodes..*/.voi
7760: 64 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 d sqlite3_progre
7770: 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 ss_handler(. sq
7780: 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 69 6e lite3 *db, . in
7790: 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a t nOps,. int (*
77a0: 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69 64 2a xProgress)(void*
77b0: 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 ), . void *pArg
77c0: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 .){. sqlite3_mu
77d0: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
77e0: 74 65 78 29 3b 0a 20 20 69 66 28 20 6e 4f 70 73 tex);. if( nOps
77f0: 3e 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 50 >0 ){. db->xP
7800: 72 6f 67 72 65 73 73 20 3d 20 78 50 72 6f 67 72 rogress = xProgr
7810: 65 73 73 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72 ess;. db->nPr
7820: 6f 67 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 ogressOps = nOps
7830: 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 ;. db->pProgr
7840: 65 73 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 essArg = pArg;.
7850: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e }else{. db->
7860: 78 50 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 xProgress = 0;.
7870: 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 db->nProgress
7880: 4f 70 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d Ops = 0;. db-
7890: 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 >pProgressArg =
78a0: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 0;. }. sqlite3
78b0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
78c0: 3e 6d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 >mutex);.}.#endi
78d0: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 f.../*.** This r
78e0: 6f 75 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 outine installs
78f0: 61 20 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 a default busy h
7900: 61 6e 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 andler that wait
7910: 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 s for the.** spe
7920: 63 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 cified number of
7930: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 milliseconds be
7940: 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 fore returning 0
7950: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
7960: 5f 62 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 _busy_timeout(sq
7970: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d lite3 *db, int m
7980: 73 29 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 s){. if( ms>0 )
7990: 7b 0a 20 20 20 20 64 62 2d 3e 62 75 73 79 54 69 {. db->busyTi
79a0: 6d 65 6f 75 74 20 3d 20 6d 73 3b 0a 20 20 20 20 meout = ms;.
79b0: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e sqlite3_busy_han
79c0: 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 dler(db, sqliteD
79d0: 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 efaultBusyCallba
79e0: 63 6b 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a ck, (void*)db);.
79f0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c }else{. sql
7a00: 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 ite3_busy_handle
7a10: 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d r(db, 0, 0);. }
7a20: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
7a30: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 _OK;.}../*.** Ca
7a40: 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 use any pending
7a50: 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f operation to sto
7a60: 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 p at its earlies
7a70: 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a t opportunity..*
7a80: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 /.void sqlite3_i
7a90: 6e 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 33 nterrupt(sqlite3
7aa0: 20 2a 64 62 29 7b 0a 20 20 64 62 2d 3e 75 31 2e *db){. db->u1.
7ab0: 69 73 49 6e 74 65 72 72 75 70 74 65 64 20 3d 20 isInterrupted =
7ac0: 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 1;.}.../*.** Thi
7ad0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 s function is ex
7ae0: 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 61 actly the same a
7af0: 73 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 s sqlite3_create
7b00: 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 _function(), exc
7b10: 65 70 74 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 ept.** that it i
7b20: 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 62 65 s designed to be
7b30: 20 63 61 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 called by inter
7b40: 6e 61 6c 20 63 6f 64 65 2e 20 54 68 65 20 64 69 nal code. The di
7b50: 66 66 65 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 fference is.** t
7b60: 68 61 74 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 hat if a malloc(
7b70: 29 20 66 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 ) fails in sqlit
7b80: 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 e3_create_functi
7b90: 6f 6e 28 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 on(), an error c
7ba0: 6f 64 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e ode.** is return
7bb0: 65 64 20 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f ed and the mallo
7bc0: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 cFailed flag cle
7bd0: 61 72 65 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 ared. .*/.int sq
7be0: 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 lite3CreateFunc(
7bf0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
7c00: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
7c10: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 unctionName,. i
7c20: 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 nt nArg,. int e
7c30: 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 nc,. void *pUse
7c40: 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a rData,. void (*
7c50: 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 xFunc)(sqlite3_c
7c60: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
7c70: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
7c80: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 void (*xStep)(s
7c90: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
7ca0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
7cb0: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
7cc0: 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f xFinal)(sqlite3_
7cd0: 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 46 75 6e context*),. Fun
7ce0: 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 44 65 cDestructor *pDe
7cf0: 73 74 72 75 63 74 6f 72 0a 29 7b 0a 20 20 46 75 structor.){. Fu
7d00: 6e 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 ncDef *p;. int
7d10: 6e 4e 61 6d 65 3b 0a 0a 20 20 61 73 73 65 72 74 nName;.. assert
7d20: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
7d30: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
7d40: 29 3b 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 );. if( zFuncti
7d50: 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 onName==0 ||.
7d60: 20 20 20 28 78 46 75 6e 63 20 26 26 20 28 78 46 (xFunc && (xF
7d70: 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 20 inal || xStep))
7d80: 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75 6e || . (!xFun
7d90: 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26 20 c && (xFinal &&
7da0: 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 !xStep)) ||.
7db0: 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 21 78 (!xFunc && (!x
7dc0: 46 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29 29 Final && xStep))
7dd0: 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 3c ||. (nArg<
7de0: 2d 31 20 7c 7c 20 6e 41 72 67 3e 53 51 4c 49 54 -1 || nArg>SQLIT
7df0: 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 E_MAX_FUNCTION_A
7e00: 52 47 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 RG) ||. (25
7e10: 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 5<(nName = sqlit
7e20: 65 33 53 74 72 6c 65 6e 33 30 28 20 7a 46 75 6e e3Strlen30( zFun
7e30: 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b 0a ctionName))) ){.
7e40: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
7e50: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
7e60: 20 7d 0a 20 20 0a 23 69 66 6e 64 65 66 20 53 51 }. .#ifndef SQ
7e70: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
7e80: 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 /* If SQLITE_U
7e90: 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 TF16 is specifie
7ea0: 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e d as the encodin
7eb0: 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 g type, transfor
7ec0: 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f m this. ** to o
7ed0: 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 ne of SQLITE_UTF
7ee0: 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 16LE or SQLITE_U
7ef0: 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 TF16BE using the
7f00: 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 . ** SQLITE_UTF
7f10: 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 16NATIVE macro.
7f20: 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 SQLITE_UTF16 is
7f30: 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 not used interna
7f40: 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 lly.. **. ** I
7f50: 66 20 53 51 4c 49 54 45 5f 41 4e 59 20 69 73 20 f SQLITE_ANY is
7f60: 73 70 65 63 69 66 69 65 64 2c 20 61 64 64 20 74 specified, add t
7f70: 68 72 65 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 hree versions of
7f80: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 the function.
7f90: 2a 2a 20 74 6f 20 74 68 65 20 68 61 73 68 20 74 ** to the hash t
7fa0: 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 able.. */. if(
7fb0: 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 enc==SQLITE_UTF
7fc0: 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 16 ){. enc =
7fd0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 SQLITE_UTF16NATI
7fe0: 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 VE;. }else if(
7ff0: 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 20 enc==SQLITE_ANY
8000: 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 ){. int rc;.
8010: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 rc = sqlite3C
8020: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 reateFunc(db, zF
8030: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 unctionName, nAr
8040: 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a g, SQLITE_UTF8,.
8050: 20 20 20 20 20 20 20 20 20 70 55 73 65 72 44 61 pUserDa
8060: 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 ta, xFunc, xStep
8070: 2c 20 78 46 69 6e 61 6c 2c 20 70 44 65 73 74 72 , xFinal, pDestr
8080: 75 63 74 6f 72 29 3b 0a 20 20 20 20 69 66 28 20 uctor);. if(
8090: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
80a0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
80b0: 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 te3CreateFunc(db
80c0: 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c , zFunctionName,
80d0: 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 nArg, SQLITE_UT
80e0: 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 20 20 20 F16LE,.
80f0: 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e pUserData, xFun
8100: 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c c, xStep, xFinal
8110: 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b 0a , pDestructor);.
8120: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
8130: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
8140: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
8150: 20 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d 20 }. enc =
8160: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a SQLITE_UTF16BE;.
8170: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 20 }.#else. enc
8180: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23 = SQLITE_UTF8;.#
8190: 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 68 endif. . /* Ch
81a0: 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 69 eck if an existi
81b0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 62 ng function is b
81c0: 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e 20 eing overridden
81d0: 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 73 or deleted. If s
81e0: 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 72 o,. ** and ther
81f0: 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 e are active VMs
8200: 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 51 , then return SQ
8210: 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 20 LITE_BUSY. If a
8220: 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 function. ** is
8230: 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 being overridde
8240: 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 68 n/deleted but th
8250: 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76 ere are no activ
8260: 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 65 e VMs, allow the
8270: 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 . ** operation
8280: 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 20 to continue but
8290: 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 70 invalidate all p
82a0: 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 recompiled state
82b0: 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 20 ments.. */. p
82c0: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e = sqlite3FindFun
82d0: 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 ction(db, zFunct
82e0: 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 ionName, nName,
82f0: 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 30 nArg, (u8)enc, 0
8300: 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 70 2d );. if( p && p-
8310: 3e 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63 20 26 >iPrefEnc==enc &
8320: 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72 67 20 & p->nArg==nArg
8330: 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 ){. if( db->a
8340: 63 74 69 76 65 56 64 62 65 43 6e 74 20 29 7b 0a ctiveVdbeCnt ){.
8350: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 sqlite3Err
8360: 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 or(db, SQLITE_BU
8370: 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e SY, . "un
8380: 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d able to delete/m
8390: 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e 63 74 odify user-funct
83a0: 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 69 76 ion due to activ
83b0: 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a e statements");.
83c0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 21 64 assert( !d
83d0: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
83e0: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
83f0: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
8400: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 }else{. sq
8410: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 lite3ExpirePrepa
8420: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 redStatements(db
8430: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
8440: 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 p = sqlite3FindF
8450: 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e unction(db, zFun
8460: 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 ctionName, nName
8470: 2c 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c , nArg, (u8)enc,
8480: 20 31 29 3b 0a 20 20 61 73 73 65 72 74 28 70 20 1);. assert(p
8490: 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 || db->mallocFai
84a0: 6c 65 64 29 3b 0a 20 20 69 66 28 20 21 70 20 29 led);. if( !p )
84b0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
84c0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a ITE_NOMEM;. }..
84d0: 20 20 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 65 72 /* If an older
84e0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
84f0: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 function with a
8500: 63 6f 6e 66 69 67 75 72 65 64 20 64 65 73 74 72 configured destr
8510: 75 63 74 6f 72 20 69 73 0a 20 20 2a 2a 20 62 65 uctor is. ** be
8520: 69 6e 67 20 72 65 70 6c 61 63 65 64 20 69 6e 76 ing replaced inv
8530: 6f 6b 65 20 74 68 65 20 64 65 73 74 72 75 63 74 oke the destruct
8540: 6f 72 20 66 75 6e 63 74 69 6f 6e 20 68 65 72 65 or function here
8550: 2e 20 2a 2f 0a 20 20 66 75 6e 63 74 69 6f 6e 44 . */. functionD
8560: 65 73 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 0a estroy(db, p);..
8570: 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f if( pDestructo
8580: 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 r ){. pDestru
8590: 63 74 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 ctor->nRef++;.
85a0: 7d 0a 20 20 70 2d 3e 70 44 65 73 74 72 75 63 74 }. p->pDestruct
85b0: 6f 72 20 3d 20 70 44 65 73 74 72 75 63 74 6f 72 or = pDestructor
85c0: 3b 0a 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20 30 ;. p->flags = 0
85d0: 3b 0a 20 20 70 2d 3e 78 46 75 6e 63 20 3d 20 78 ;. p->xFunc = x
85e0: 46 75 6e 63 3b 0a 20 20 70 2d 3e 78 53 74 65 70 Func;. p->xStep
85f0: 20 3d 20 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78 = xStep;. p->x
8600: 46 69 6e 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61 Finalize = xFina
8610: 6c 3b 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 l;. p->pUserDat
8620: 61 20 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 a = pUserData;.
8630: 20 70 2d 3e 6e 41 72 67 20 3d 20 28 75 31 36 29 p->nArg = (u16)
8640: 6e 41 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 nArg;. return S
8650: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
8660: 2a 2a 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 ** Create new us
8670: 65 72 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f er functions..*/
8680: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
8690: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 ate_function(.
86a0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
86b0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 onst char *zFunc
86c0: 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 ,. int nArg,.
86d0: 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 int enc,. void
86e0: 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 *p,. void (*xFu
86f0: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
8700: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
8710: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
8720: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 id (*xStep)(sqli
8730: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
8740: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
8750: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 *),. void (*xFi
8760: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e nal)(sqlite3_con
8770: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 72 65 74 75 text*).){. retu
8780: 72 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 rn sqlite3_creat
8790: 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 64 62 e_function_v2(db
87a0: 2c 20 7a 46 75 6e 63 2c 20 6e 41 72 67 2c 20 65 , zFunc, nArg, e
87b0: 6e 63 2c 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 nc, p, xFunc, xS
87c0: 74 65 70 2c 0a 20 20 20 20 20 20 20 20 20 20 20 tep,.
87d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
87e0: 20 20 20 20 20 20 20 20 20 78 46 69 6e 61 6c 2c xFinal,
87f0: 20 30 29 3b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 0);.}..int sqli
8800: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
8810: 69 6f 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 ion_v2(. sqlite
8820: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3 *db,. const c
8830: 68 61 72 20 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e har *zFunc,. in
8840: 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e t nArg,. int en
8850: 63 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 c,. void *p,.
8860: 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 void (*xFunc)(sq
8870: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
8880: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
8890: 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 **),. void (*x
88a0: 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f Step)(sqlite3_co
88b0: 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 ntext*,int,sqlit
88c0: 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 e3_value **),.
88d0: 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 void (*xFinal)(s
88e0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 qlite3_context*)
88f0: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 ,. void (*xDest
8900: 72 6f 79 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a roy)(void *).){.
8910: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
8920: 45 5f 45 52 52 4f 52 3b 0a 20 20 46 75 6e 63 44 E_ERROR;. FuncD
8930: 65 73 74 72 75 63 74 6f 72 20 2a 70 41 72 67 20 estructor *pArg
8940: 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d = 0;. sqlite3_m
8950: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
8960: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 78 44 65 utex);. if( xDe
8970: 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 70 41 72 stroy ){. pAr
8980: 67 20 3d 20 28 46 75 6e 63 44 65 73 74 72 75 63 g = (FuncDestruc
8990: 74 6f 72 20 2a 29 73 71 6c 69 74 65 33 44 62 4d tor *)sqlite3DbM
89a0: 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 allocZero(db, si
89b0: 7a 65 6f 66 28 46 75 6e 63 44 65 73 74 72 75 63 zeof(FuncDestruc
89c0: 74 6f 72 29 29 3b 0a 20 20 20 20 69 66 28 20 21 tor));. if( !
89d0: 70 41 72 67 20 29 7b 0a 20 20 20 20 20 20 78 44 pArg ){. xD
89e0: 65 73 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 20 estroy(p);.
89f0: 20 67 6f 74 6f 20 6f 75 74 3b 0a 20 20 20 20 7d goto out;. }
8a00: 0a 20 20 20 20 70 41 72 67 2d 3e 78 44 65 73 74 . pArg->xDest
8a10: 72 6f 79 20 3d 20 78 44 65 73 74 72 6f 79 3b 0a roy = xDestroy;.
8a20: 20 20 20 20 70 41 72 67 2d 3e 70 55 73 65 72 44 pArg->pUserD
8a30: 61 74 61 20 3d 20 70 3b 0a 20 20 7d 0a 20 20 72 ata = p;. }. r
8a40: 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 c = sqlite3Creat
8a50: 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 2c eFunc(db, zFunc,
8a60: 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 nArg, enc, p, x
8a70: 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 Func, xStep, xFi
8a80: 6e 61 6c 2c 20 70 41 72 67 29 3b 0a 20 20 69 66 nal, pArg);. if
8a90: 28 20 70 41 72 67 20 26 26 20 70 41 72 67 2d 3e ( pArg && pArg->
8aa0: 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 61 nRef==0 ){. a
8ab0: 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
8ac0: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 78 44 65 73 E_OK );. xDes
8ad0: 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 73 71 6c troy(p);. sql
8ae0: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 ite3DbFree(db, p
8af0: 41 72 67 29 3b 0a 20 20 7d 0a 0a 20 6f 75 74 3a Arg);. }.. out:
8b00: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
8b10: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
8b20: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
8b30: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
8b40: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
8b50: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
8b60: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 _OMIT_UTF16.int
8b70: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 sqlite3_create_f
8b80: 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c unction16(. sql
8b90: 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 ite3 *db,. cons
8ba0: 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f t void *zFunctio
8bb0: 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 nName,. int nAr
8bc0: 67 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 52 65 g,. int eTextRe
8bd0: 70 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 p,. void *p,.
8be0: 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 void (*xFunc)(sq
8bf0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
8c00: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
8c10: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 **),. void (*xS
8c20: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e tep)(sqlite3_con
8c30: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
8c40: 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 3_value**),. vo
8c50: 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c id (*xFinal)(sql
8c60: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 ite3_context*).)
8c70: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 {. int rc;. ch
8c80: 61 72 20 2a 7a 46 75 6e 63 38 3b 0a 20 20 73 71 ar *zFunc8;. sq
8c90: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
8ca0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
8cb0: 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c assert( !db->mal
8cc0: 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a locFailed );. z
8cd0: 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 55 Func8 = sqlite3U
8ce0: 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 46 75 6e tf16to8(db, zFun
8cf0: 63 74 69 6f 6e 4e 61 6d 65 2c 20 2d 31 2c 20 53 ctionName, -1, S
8d00: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
8d10: 45 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 E);. rc = sqlit
8d20: 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c e3CreateFunc(db,
8d30: 20 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 zFunc8, nArg, e
8d40: 54 65 78 74 52 65 70 2c 20 70 2c 20 78 46 75 6e TextRep, p, xFun
8d50: 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c c, xStep, xFinal
8d60: 2c 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 ,0);. sqlite3Db
8d70: 46 72 65 65 28 64 62 2c 20 7a 46 75 6e 63 38 29 Free(db, zFunc8)
8d80: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
8d90: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b ApiExit(db, rc);
8da0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
8db0: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
8dc0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
8dd0: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a }.#endif.../*.**
8de0: 20 44 65 63 6c 61 72 65 20 74 68 61 74 20 61 20 Declare that a
8df0: 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 function has bee
8e00: 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 62 79 20 n overloaded by
8e10: 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e a virtual table.
8e20: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 75 .**.** If the fu
8e30: 6e 63 74 69 6f 6e 20 61 6c 72 65 61 64 79 20 65 nction already e
8e40: 78 69 73 74 73 20 61 73 20 61 20 72 65 67 75 6c xists as a regul
8e50: 61 72 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 ar global functi
8e60: 6f 6e 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 on, then.** this
8e70: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f routine is a no
8e80: 2d 6f 70 2e 20 20 49 66 20 74 68 65 20 66 75 6e -op. If the fun
8e90: 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 65 ction does not e
8ea0: 78 69 73 74 2c 20 74 68 65 6e 20 63 72 65 61 74 xist, then creat
8eb0: 65 0a 2a 2a 20 61 20 6e 65 77 20 6f 6e 65 20 74 e.** a new one t
8ec0: 68 61 74 20 61 6c 77 61 79 73 20 74 68 72 6f 77 hat always throw
8ed0: 73 20 61 20 72 75 6e 2d 74 69 6d 65 20 65 72 72 s a run-time err
8ee0: 6f 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 57 68 65 6e or. .**.** When
8ef0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
8f00: 69 6e 74 65 6e 64 20 74 6f 20 70 72 6f 76 69 64 intend to provid
8f10: 65 20 61 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 e an overloaded
8f20: 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 79 0a 2a function, they.*
8f30: 2a 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 68 * should call th
8f40: 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 is routine to ma
8f50: 6b 65 20 73 75 72 65 20 74 68 65 20 67 6c 6f 62 ke sure the glob
8f60: 61 6c 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 73 al function exis
8f70: 74 73 2e 0a 2a 2a 20 41 20 67 6c 6f 62 61 6c 20 ts..** A global
8f80: 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 65 78 function must ex
8f90: 69 73 74 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 ist in order for
8fa0: 20 6e 61 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e name resolution
8fb0: 20 74 6f 20 77 6f 72 6b 0a 2a 2a 20 70 72 6f 70 to work.** prop
8fc0: 65 72 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c erly..*/.int sql
8fd0: 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 ite3_overload_fu
8fe0: 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 nction(. sqlite
8ff0: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3 *db,. const c
9000: 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e har *zName,. in
9010: 74 20 6e 41 72 67 0a 29 7b 0a 20 20 69 6e 74 20 t nArg.){. int
9020: 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 nName = sqlite3S
9030: 74 72 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 3b 0a trlen30(zName);.
9040: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
9050: 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f E_OK;. sqlite3_
9060: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
9070: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 mutex);. if( sq
9080: 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f lite3FindFunctio
9090: 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 n(db, zName, nNa
90a0: 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 me, nArg, SQLITE
90b0: 5f 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a _UTF8, 0)==0 ){.
90c0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
90d0: 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a CreateFunc(db, z
90e0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
90f0: 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 TE_UTF8,.
9100: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9110: 20 20 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 0, sqlite3In
9120: 76 61 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 validFunction, 0
9130: 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 , 0, 0);. }. r
9140: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
9150: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
9160: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
9170: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
9180: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 return rc;.}..#i
9190: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
91a0: 54 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 T_TRACE./*.** Re
91b0: 67 69 73 74 65 72 20 61 20 74 72 61 63 65 20 66 gister a trace f
91c0: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 unction. The pA
91d0: 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 rg from the prev
91e0: 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 iously registere
91f0: 64 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 d trace.** is re
9200: 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 turned. .**.**
9210: 41 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e A NULL trace fun
9220: 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 ction means that
9230: 20 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 no tracing is e
9240: 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d xecutes. A non-
9250: 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 NULL.** trace is
9260: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
9270: 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 function that is
9280: 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 invoked at the
9290: 73 74 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a start of each.**
92a0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a SQL statement..
92b0: 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 */.void *sqlite3
92c0: 5f 74 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a _trace(sqlite3 *
92d0: 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 db, void (*xTrac
92e0: 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 e)(void*,const c
92f0: 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 har*), void *pAr
9300: 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 g){. void *pOld
9310: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
9320: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
9330: 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d x);. pOld = db-
9340: 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 64 62 >pTraceArg;. db
9350: 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72 61 63 ->xTrace = xTrac
9360: 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65 41 e;. db->pTraceA
9370: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
9380: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
9390: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
93a0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 2f 2a eturn pOld;.}./*
93b0: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 70 .** Register a p
93c0: 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 2e rofile function.
93d0: 20 20 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 The pArg from
93e0: 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 the previously r
93f0: 65 67 69 73 74 65 72 65 64 20 0a 2a 2a 20 70 72 egistered .** pr
9400: 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 69 ofile function i
9410: 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a s returned. .**
9420: 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 72 6f 66 69 .** A NULL profi
9430: 6c 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e le function mean
9440: 73 20 74 68 61 74 20 6e 6f 20 70 72 6f 66 69 6c s that no profil
9450: 69 6e 67 20 69 73 20 65 78 65 63 75 74 65 73 2e ing is executes.
9460: 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 A non-NULL.**
9470: 70 72 6f 66 69 6c 65 20 69 73 20 61 20 70 6f 69 profile is a poi
9480: 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 nter to a functi
9490: 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b on that is invok
94a0: 65 64 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 ed at the conclu
94b0: 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61 63 68 20 sion of.** each
94c0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 68 SQL statement th
94d0: 61 74 20 69 73 20 72 75 6e 2e 0a 2a 2f 0a 76 6f at is run..*/.vo
94e0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 70 72 6f 66 id *sqlite3_prof
94f0: 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a ile(. sqlite3 *
9500: 64 62 2c 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 db,. void (*xPr
9510: 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e ofile)(void*,con
9520: 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f st char*,sqlite_
9530: 75 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 uint64),. void
9540: 2a 70 41 72 67 0a 29 7b 0a 20 20 76 6f 69 64 20 *pArg.){. void
9550: 2a 70 4f 6c 64 3b 0a 20 20 73 71 6c 69 74 65 33 *pOld;. sqlite3
9560: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
9570: 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 >mutex);. pOld
9580: 3d 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 = db->pProfileAr
9590: 67 3b 0a 20 20 64 62 2d 3e 78 50 72 6f 66 69 6c g;. db->xProfil
95a0: 65 20 3d 20 78 50 72 6f 66 69 6c 65 3b 0a 20 20 e = xProfile;.
95b0: 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 67 20 db->pProfileArg
95c0: 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 = pArg;. sqlite
95d0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
95e0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
95f0: 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 6e 64 69 rn pOld;.}.#endi
9600: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 f /* SQLITE_OMIT
9610: 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 2a 2a 20 _TRACE */../***
9620: 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 2a 2a 2a EXPERIMENTAL ***
9630: 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 .**.** Register
9640: 61 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65 a function to be
9650: 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20 61 20 invoked when a
9660: 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d transaction comm
9670: 65 6e 74 73 2e 0a 2a 2a 20 49 66 20 74 68 65 20 ents..** If the
9680: 69 6e 76 6f 6b 65 64 20 66 75 6e 63 74 69 6f 6e invoked function
9690: 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 returns non-zer
96a0: 6f 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d o, then the comm
96b0: 69 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 it becomes a.**
96c0: 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 rollback..*/.voi
96d0: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 d *sqlite3_commi
96e0: 74 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 t_hook(. sqlite
96f0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
9700: 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 /* Attach th
9710: 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 e hook to this d
9720: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 atabase */. int
9730: 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f (*xCallback)(vo
9740: 69 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 74 69 id*), /* Functi
9750: 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 on to invoke on
9760: 65 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 each commit */.
9770: 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 void *pArg
9780: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
9790: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 gument to the fu
97a0: 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 nction */.){. v
97b0: 6f 69 64 20 2a 70 4f 6c 64 3b 0a 20 20 73 71 6c oid *pOld;. sql
97c0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
97d0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 (db->mutex);. p
97e0: 4f 6c 64 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 Old = db->pCommi
97f0: 74 41 72 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d tArg;. db->xCom
9800: 6d 69 74 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 mitCallback = xC
9810: 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 allback;. db->p
9820: 43 6f 6d 6d 69 74 41 72 67 20 3d 20 70 41 72 67 CommitArg = pArg
9830: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
9840: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
9850: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c x);. return pOl
9860: 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 d;.}../*.** Regi
9870: 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 6b 20 ster a callback
9880: 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 65 61 to be invoked ea
9890: 63 68 20 74 69 6d 65 20 61 20 72 6f 77 20 69 73 ch time a row is
98a0: 20 75 70 64 61 74 65 64 2c 0a 2a 2a 20 69 6e 73 updated,.** ins
98b0: 65 72 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64 erted or deleted
98c0: 20 75 73 69 6e 67 20 74 68 69 73 20 64 61 74 61 using this data
98d0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e base connection.
98e0: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
98f0: 33 5f 75 70 64 61 74 65 5f 68 6f 6f 6b 28 0a 20 3_update_hook(.
9900: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
9910: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
9920: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
9930: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a this database *
9940: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c /. void (*xCall
9950: 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c back)(void*,int,
9960: 63 68 61 72 20 63 6f 6e 73 74 20 2a 2c 63 68 61 char const *,cha
9970: 72 20 63 6f 6e 73 74 20 2a 2c 73 71 6c 69 74 65 r const *,sqlite
9980: 5f 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 _int64),. void
9990: 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 20 *pArg
99a0: 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 /* Argument
99b0: 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e to the function
99c0: 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 */.){. void *p
99d0: 52 65 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d Ret;. sqlite3_m
99e0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
99f0: 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 utex);. pRet =
9a00: 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b 0a db->pUpdateArg;.
9a10: 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61 6c db->xUpdateCal
9a20: 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 lback = xCallbac
9a30: 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 65 k;. db->pUpdate
9a40: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 Arg = pArg;. sq
9a50: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
9a60: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
9a70: 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a return pRet;.}..
9a80: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
9a90: 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 callback to be
9aa0: 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d invoked each tim
9ab0: 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 e a transaction
9ac0: 69 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 is rolled.** bac
9ad0: 6b 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 k by this databa
9ae0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a se connection..*
9af0: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
9b00: 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 rollback_hook(.
9b10: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
9b20: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
9b30: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
9b40: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a this database *
9b50: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c /. void (*xCall
9b60: 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a back)(void*), /*
9b70: 20 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 Callback functi
9b80: 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 on */. void *pA
9b90: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rg
9ba0: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f /* Argument to
9bb0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f the function */
9bc0: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 .){. void *pRet
9bd0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
9be0: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
9bf0: 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 64 62 2d x);. pRet = db-
9c00: 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b 0a 20 >pRollbackArg;.
9c10: 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 db->xRollbackCa
9c20: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 llback = xCallba
9c30: 63 6b 3b 0a 20 20 64 62 2d 3e 70 52 6f 6c 6c 62 ck;. db->pRollb
9c40: 61 63 6b 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 ackArg = pArg;.
9c50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
9c60: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
9c70: 0a 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a . return pRet;.
9c80: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
9c90: 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a E_OMIT_WAL./*.**
9ca0: 20 54 68 65 20 73 71 6c 69 74 65 33 5f 77 61 6c The sqlite3_wal
9cb0: 5f 68 6f 6f 6b 28 29 20 63 61 6c 6c 62 61 63 6b _hook() callback
9cc0: 20 72 65 67 69 73 74 65 72 65 64 20 62 79 20 73 registered by s
9cd0: 71 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 qlite3_wal_autoc
9ce0: 68 65 63 6b 70 6f 69 6e 74 28 29 2e 0a 2a 2a 20 heckpoint()..**
9cf0: 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 5f 77 Invoke sqlite3_w
9d00: 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 20 69 66 al_checkpoint if
9d10: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 the number of f
9d20: 72 61 6d 65 73 20 69 6e 20 74 68 65 20 6c 6f 67 rames in the log
9d30: 20 66 69 6c 65 0a 2a 2a 20 69 73 20 67 72 65 61 file.** is grea
9d40: 74 65 72 20 74 68 61 6e 20 73 71 6c 69 74 65 33 ter than sqlite3
9d50: 2e 70 57 61 6c 41 72 67 20 63 61 73 74 20 74 6f .pWalArg cast to
9d60: 20 61 6e 20 69 6e 74 65 67 65 72 20 28 74 68 65 an integer (the
9d70: 20 76 61 6c 75 65 20 63 6f 6e 66 69 67 75 72 65 value configure
9d80: 64 20 62 79 0a 2a 2a 20 77 61 6c 5f 61 75 74 6f d by.** wal_auto
9d90: 63 68 65 63 6b 70 6f 69 6e 74 28 29 29 2e 0a 2a checkpoint())..*
9da0: 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 / .int sqlite3Wa
9db0: 6c 44 65 66 61 75 6c 74 48 6f 6f 6b 28 0a 20 20 lDefaultHook(.
9dc0: 76 6f 69 64 20 2a 70 43 6c 69 65 6e 74 44 61 74 void *pClientDat
9dd0: 61 2c 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 a, /* Argume
9de0: 6e 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 nt */. sqlite3
9df0: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 2f *db, /
9e00: 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a * Connection */.
9e10: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 const char *zD
9e20: 62 2c 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 b, /* Data
9e30: 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 base */. int nF
9e40: 72 61 6d 65 20 20 20 20 20 20 20 20 20 20 20 20 rame
9e50: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 /* Size of WAL
9e60: 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 6e 46 72 61 */.){. if( nFra
9e70: 6d 65 3e 3d 53 51 4c 49 54 45 5f 50 54 52 5f 54 me>=SQLITE_PTR_T
9e80: 4f 5f 49 4e 54 28 70 43 6c 69 65 6e 74 44 61 74 O_INT(pClientDat
9e90: 61 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 a) ){. sqlite
9ea0: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
9eb0: 6f 63 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 oc();. sqlite
9ec0: 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
9ed0: 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 20 20 73 (db, zDb);. s
9ee0: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
9ef0: 61 6c 6c 6f 63 28 29 3b 0a 20 20 7d 0a 20 20 72 alloc();. }. r
9f00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
9f10: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
9f20: 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f 0a ITE_OMIT_WAL */.
9f30: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 ./*.** Configure
9f40: 20 61 6e 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f an sqlite3_wal_
9f50: 68 6f 6f 6b 28 29 20 63 61 6c 6c 62 61 63 6b 20 hook() callback
9f60: 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 to automatically
9f70: 20 63 68 65 63 6b 70 6f 69 6e 74 0a 2a 2a 20 61 checkpoint.** a
9f80: 20 64 61 74 61 62 61 73 65 20 61 66 74 65 72 20 database after
9f90: 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 74 72 61 committing a tra
9fa0: 6e 73 61 63 74 69 6f 6e 20 69 66 20 74 68 65 72 nsaction if ther
9fb0: 65 20 61 72 65 20 6e 46 72 61 6d 65 20 6f 72 0a e are nFrame or.
9fc0: 2a 2a 20 6d 6f 72 65 20 66 72 61 6d 65 73 20 69 ** more frames i
9fd0: 6e 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 2e 20 n the log file.
9fe0: 50 61 73 73 69 6e 67 20 7a 65 72 6f 20 6f 72 20 Passing zero or
9ff0: 61 20 6e 65 67 61 74 69 76 65 20 76 61 6c 75 65 a negative value
a000: 20 61 73 20 74 68 65 0a 2a 2a 20 6e 46 72 61 6d as the.** nFram
a010: 65 20 70 61 72 61 6d 65 74 65 72 20 64 69 73 61 e parameter disa
a020: 62 6c 65 73 20 61 75 74 6f 6d 61 74 69 63 20 63 bles automatic c
a030: 68 65 63 6b 70 6f 69 6e 74 73 20 65 6e 74 69 72 heckpoints entir
a040: 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 ely..**.** The c
a050: 61 6c 6c 62 61 63 6b 20 72 65 67 69 73 74 65 72 allback register
a060: 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
a070: 69 6f 6e 20 72 65 70 6c 61 63 65 73 20 61 6e 79 ion replaces any
a080: 20 65 78 69 73 74 69 6e 67 20 63 61 6c 6c 62 61 existing callba
a090: 63 6b 0a 2a 2a 20 72 65 67 69 73 74 65 72 65 64 ck.** registered
a0a0: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 77 using sqlite3_w
a0b0: 61 6c 5f 68 6f 6f 6b 28 29 2e 20 4c 69 6b 65 77 al_hook(). Likew
a0c0: 69 73 65 2c 20 72 65 67 69 73 74 65 72 69 6e 67 ise, registering
a0d0: 20 61 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 75 a callback.** u
a0e0: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 77 61 6c sing sqlite3_wal
a0f0: 5f 68 6f 6f 6b 28 29 20 64 69 73 61 62 6c 65 73 _hook() disables
a100: 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 63 the automatic c
a110: 68 65 63 6b 70 6f 69 6e 74 20 6d 65 63 68 61 6e heckpoint mechan
a120: 69 73 6d 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 65 ism.** configure
a130: 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
a140: 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 on..*/.int sqlit
a150: 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b e3_wal_autocheck
a160: 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 point(sqlite3 *d
a170: 62 2c 20 69 6e 74 20 6e 46 72 61 6d 65 29 7b 0a b, int nFrame){.
a180: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
a190: 49 54 5f 57 41 4c 0a 20 20 55 4e 55 53 45 44 5f IT_WAL. UNUSED_
a1a0: 50 41 52 41 4d 45 54 45 52 28 64 62 29 3b 0a 20 PARAMETER(db);.
a1b0: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
a1c0: 52 28 6e 46 72 61 6d 65 29 3b 0a 23 65 6c 73 65 R(nFrame);.#else
a1d0: 0a 20 20 69 66 28 20 6e 46 72 61 6d 65 3e 30 20 . if( nFrame>0
a1e0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 77 ){. sqlite3_w
a1f0: 61 6c 5f 68 6f 6f 6b 28 64 62 2c 20 73 71 6c 69 al_hook(db, sqli
a200: 74 65 33 57 61 6c 44 65 66 61 75 6c 74 48 6f 6f te3WalDefaultHoo
a210: 6b 2c 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f k, SQLITE_INT_TO
a220: 5f 50 54 52 28 6e 46 72 61 6d 65 29 29 3b 0a 20 _PTR(nFrame));.
a230: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
a240: 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 64 62 2c te3_wal_hook(db,
a250: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 0, 0);. }.#end
a260: 69 66 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 if. return SQLI
a270: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
a280: 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 Register a callb
a290: 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 ack to be invoke
a2a0: 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 74 72 d each time a tr
a2b0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 77 72 69 ansaction is wri
a2c0: 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 74 68 65 tten.** into the
a2d0: 20 77 72 69 74 65 2d 61 68 65 61 64 2d 6c 6f 67 write-ahead-log
a2e0: 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 by this databas
a2f0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f e connection..*/
a300: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 .void *sqlite3_w
a310: 61 6c 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 al_hook(. sqlit
a320: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 e3 *db,
a330: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
a340: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
a350: 20 74 68 69 73 20 64 62 20 68 61 6e 64 6c 65 20 this db handle
a360: 2a 2f 0a 20 20 69 6e 74 28 2a 78 43 61 6c 6c 62 */. int(*xCallb
a370: 61 63 6b 29 28 76 6f 69 64 20 2a 2c 20 73 71 6c ack)(void *, sql
a380: 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 ite3*, const cha
a390: 72 2a 2c 20 69 6e 74 29 2c 0a 20 20 76 6f 69 64 r*, int),. void
a3a0: 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
a3b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
a3c0: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 70 61 irst argument pa
a3d0: 73 73 65 64 20 74 6f 20 78 43 61 6c 6c 62 61 63 ssed to xCallbac
a3e0: 6b 28 29 20 2a 2f 0a 29 7b 0a 23 69 66 6e 64 65 k() */.){.#ifnde
a3f0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
a400: 4c 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a L. void *pRet;.
a410: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
a420: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
a430: 3b 0a 20 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 ;. pRet = db->p
a440: 57 61 6c 41 72 67 3b 0a 20 20 64 62 2d 3e 78 57 WalArg;. db->xW
a450: 61 6c 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 alCallback = xCa
a460: 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 57 llback;. db->pW
a470: 61 6c 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 alArg = pArg;.
a480: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
a490: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
a4a0: 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 23 return pRet;.#
a4b0: 65 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 30 3b else. return 0;
a4c0: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
a4d0: 20 43 68 65 63 6b 70 6f 69 6e 74 20 64 61 74 61 Checkpoint data
a4e0: 62 61 73 65 20 7a 44 62 2e 0a 2a 2f 0a 69 6e 74 base zDb..*/.int
a4f0: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 sqlite3_wal_che
a500: 63 6b 70 6f 69 6e 74 5f 76 32 28 0a 20 20 73 71 ckpoint_v2(. sq
a510: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
a520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
a530: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 Database handle
a540: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
a550: 20 2a 7a 44 62 2c 20 20 20 20 20 20 20 20 20 20 *zDb,
a560: 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
a570: 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61 attached databa
a580: 73 65 20 28 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a se (or NULL) */.
a590: 20 20 69 6e 74 20 65 4d 6f 64 65 2c 20 20 20 20 int eMode,
a5a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a5b0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 48 45 43 /* SQLITE_CHEC
a5c0: 4b 50 4f 49 4e 54 5f 2a 20 76 61 6c 75 65 20 2a KPOINT_* value *
a5d0: 2f 0a 20 20 69 6e 74 20 2a 70 6e 4c 6f 67 2c 20 /. int *pnLog,
a5e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a5f0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 /* OUT: Size
a600: 20 6f 66 20 57 41 4c 20 6c 6f 67 20 69 6e 20 66 of WAL log in f
a610: 72 61 6d 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a rames */. int *
a620: 70 6e 43 6b 70 74 20 20 20 20 20 20 20 20 20 20 pnCkpt
a630: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
a640: 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 T: Total number
a650: 6f 66 20 66 72 61 6d 65 73 20 63 68 65 63 6b 70 of frames checkp
a660: 6f 69 6e 74 65 64 20 2a 2f 0a 29 7b 0a 23 69 66 ointed */.){.#if
a670: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
a680: 57 41 4c 0a 20 20 72 65 74 75 72 6e 20 53 51 4c WAL. return SQL
a690: 49 54 45 5f 4f 4b 3b 0a 23 65 6c 73 65 0a 20 20 ITE_OK;.#else.
a6a0: 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
a6b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a6c0: 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
a6d0: 2f 0a 20 20 69 6e 74 20 69 44 62 20 3d 20 53 51 /. int iDb = SQ
a6e0: 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 LITE_MAX_ATTACHE
a6f0: 44 3b 20 20 2f 2a 20 73 71 6c 69 74 65 33 2e 61 D; /* sqlite3.a
a700: 44 62 5b 5d 20 69 6e 64 65 78 20 6f 66 20 64 62 Db[] index of db
a710: 20 74 6f 20 63 68 65 63 6b 70 6f 69 6e 74 20 2a to checkpoint *
a720: 2f 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 /.. /* Initiali
a730: 7a 65 20 74 68 65 20 6f 75 74 70 75 74 20 76 61 ze the output va
a740: 72 69 61 62 6c 65 73 20 74 6f 20 2d 31 20 69 6e riables to -1 in
a750: 20 63 61 73 65 20 61 6e 20 65 72 72 6f 72 20 6f case an error o
a760: 63 63 75 72 73 2e 20 2a 2f 0a 20 20 69 66 28 20 ccurs. */. if(
a770: 70 6e 4c 6f 67 20 29 20 2a 70 6e 4c 6f 67 20 3d pnLog ) *pnLog =
a780: 20 2d 31 3b 0a 20 20 69 66 28 20 70 6e 43 6b 70 -1;. if( pnCkp
a790: 74 20 29 20 2a 70 6e 43 6b 70 74 20 3d 20 2d 31 t ) *pnCkpt = -1
a7a0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c ;.. assert( SQL
a7b0: 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 46 ITE_CHECKPOINT_F
a7c0: 55 4c 4c 3e 53 51 4c 49 54 45 5f 43 48 45 43 4b ULL>SQLITE_CHECK
a7d0: 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 20 29 3b POINT_PASSIVE );
a7e0: 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 . assert( SQLIT
a7f0: 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 46 55 4c E_CHECKPOINT_FUL
a800: 4c 3c 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f L<SQLITE_CHECKPO
a810: 49 4e 54 5f 52 45 53 54 41 52 54 20 29 3b 0a 20 INT_RESTART );.
a820: 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f assert( SQLITE_
a830: 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 CHECKPOINT_PASSI
a840: 56 45 2b 32 3d 3d 53 51 4c 49 54 45 5f 43 48 45 VE+2==SQLITE_CHE
a850: 43 4b 50 4f 49 4e 54 5f 52 45 53 54 41 52 54 20 CKPOINT_RESTART
a860: 29 3b 0a 20 20 69 66 28 20 65 4d 6f 64 65 3c 53 );. if( eMode<S
a870: 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 QLITE_CHECKPOINT
a880: 5f 50 41 53 53 49 56 45 20 7c 7c 20 65 4d 6f 64 _PASSIVE || eMod
a890: 65 3e 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f e>SQLITE_CHECKPO
a8a0: 49 4e 54 5f 52 45 53 54 41 52 54 20 29 7b 0a 20 INT_RESTART ){.
a8b0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a8c0: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 _MISUSE;. }..
a8d0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
a8e0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
a8f0: 20 20 69 66 28 20 7a 44 62 20 26 26 20 7a 44 62 if( zDb && zDb
a900: 5b 30 5d 20 29 7b 0a 20 20 20 20 69 44 62 20 3d [0] ){. iDb =
a910: 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 sqlite3FindDbNa
a920: 6d 65 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 7d me(db, zDb);. }
a930: 0a 20 20 69 66 28 20 69 44 62 3c 30 20 29 7b 0a . if( iDb<0 ){.
a940: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
a950: 45 52 52 4f 52 3b 0a 20 20 20 20 73 71 6c 69 74 ERROR;. sqlit
a960: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 e3Error(db, SQLI
a970: 54 45 5f 45 52 52 4f 52 2c 20 22 75 6e 6b 6e 6f TE_ERROR, "unkno
a980: 77 6e 20 64 61 74 61 62 61 73 65 3a 20 25 73 22 wn database: %s"
a990: 2c 20 7a 44 62 29 3b 0a 20 20 7d 65 6c 73 65 7b , zDb);. }else{
a9a0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
a9b0: 33 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 3Checkpoint(db,
a9c0: 69 44 62 2c 20 65 4d 6f 64 65 2c 20 70 6e 4c 6f iDb, eMode, pnLo
a9d0: 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 20 20 g, pnCkpt);.
a9e0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
a9f0: 20 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 rc, 0);. }. r
aa00: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
aa10: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
aa20: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
aa30: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
aa40: 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
aa50: 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 f.}.../*.** Chec
aa60: 6b 70 6f 69 6e 74 20 64 61 74 61 62 61 73 65 20 kpoint database
aa70: 7a 44 62 2e 20 49 66 20 7a 44 62 20 69 73 20 4e zDb. If zDb is N
aa80: 55 4c 4c 2c 20 6f 72 20 69 66 20 74 68 65 20 62 ULL, or if the b
aa90: 75 66 66 65 72 20 7a 44 62 20 70 6f 69 6e 74 73 uffer zDb points
aaa0: 0a 2a 2a 20 74 6f 20 63 6f 6e 74 61 69 6e 73 20 .** to contains
aab0: 61 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 20 73 74 a zero-length st
aac0: 72 69 6e 67 2c 20 61 6c 6c 20 61 74 74 61 63 68 ring, all attach
aad0: 65 64 20 64 61 74 61 62 61 73 65 73 20 61 72 65 ed databases are
aae0: 20 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 .** checkpointe
aaf0: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
ab00: 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
ab10: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f (sqlite3 *db, co
ab20: 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 29 7b 0a nst char *zDb){.
ab30: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
ab40: 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f _wal_checkpoint_
ab50: 76 32 28 64 62 2c 20 7a 44 62 2c 20 53 51 4c 49 v2(db, zDb, SQLI
ab60: 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 TE_CHECKPOINT_PA
ab70: 53 53 49 56 45 2c 20 30 2c 20 30 29 3b 0a 7d 0a SSIVE, 0, 0);.}.
ab80: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
ab90: 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a 20 52 OMIT_WAL./*.** R
aba0: 75 6e 20 61 20 63 68 65 63 6b 70 6f 69 6e 74 20 un a checkpoint
abb0: 6f 6e 20 64 61 74 61 62 61 73 65 20 69 44 62 2e on database iDb.
abc0: 20 54 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 This is a no-op
abd0: 20 69 66 20 64 61 74 61 62 61 73 65 20 69 44 62 if database iDb
abe0: 20 69 73 0a 2a 2a 20 6e 6f 74 20 63 75 72 72 65 is.** not curre
abf0: 6e 74 6c 79 20 6f 70 65 6e 20 69 6e 20 57 41 4c ntly open in WAL
ac00: 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 mode..**.** If
ac10: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 a transaction is
ac20: 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 64 61 74 open on the dat
ac30: 61 62 61 73 65 20 62 65 69 6e 67 20 63 68 65 63 abase being chec
ac40: 6b 70 6f 69 6e 74 65 64 2c 20 74 68 69 73 20 0a kpointed, this .
ac50: 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ** function retu
ac60: 72 6e 73 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 rns SQLITE_LOCKE
ac70: 44 20 61 6e 64 20 61 20 63 68 65 63 6b 70 6f 69 D and a checkpoi
ac80: 6e 74 20 69 73 20 6e 6f 74 20 61 74 74 65 6d 70 nt is not attemp
ac90: 74 65 64 2e 20 49 66 20 0a 2a 2a 20 61 6e 20 65 ted. If .** an e
aca0: 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c rror occurs whil
acb0: 65 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 68 e running the ch
acc0: 65 63 6b 70 6f 69 6e 74 2c 20 61 6e 20 53 51 4c eckpoint, an SQL
acd0: 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 ite error code i
ace0: 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 28 s .** returned (
acf0: 69 2e 65 2e 20 53 51 4c 49 54 45 5f 49 4f 45 52 i.e. SQLITE_IOER
ad00: 52 29 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 53 R). Otherwise, S
ad10: 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 QLITE_OK..**.**
ad20: 54 68 65 20 6d 75 74 65 78 20 6f 6e 20 64 61 74 The mutex on dat
ad30: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 20 abase handle db
ad40: 73 68 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 62 should be held b
ad50: 79 20 74 68 65 20 63 61 6c 6c 65 72 2e 20 54 68 y the caller. Th
ad60: 65 20 6d 75 74 65 78 0a 2a 2a 20 61 73 73 6f 63 e mutex.** assoc
ad70: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 73 iated with the s
ad80: 70 65 63 69 66 69 63 20 62 2d 74 72 65 65 20 62 pecific b-tree b
ad90: 65 69 6e 67 20 63 68 65 63 6b 70 6f 69 6e 74 65 eing checkpointe
ada0: 64 20 69 73 20 74 61 6b 65 6e 20 62 79 0a 2a 2a d is taken by.**
adb0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 this function w
adc0: 68 69 6c 65 20 74 68 65 20 63 68 65 63 6b 70 6f hile the checkpo
add0: 69 6e 74 20 69 73 20 72 75 6e 6e 69 6e 67 2e 0a int is running..
ade0: 2a 2a 0a 2a 2a 20 49 66 20 69 44 62 20 69 73 20 **.** If iDb is
adf0: 70 61 73 73 65 64 20 53 51 4c 49 54 45 5f 4d 41 passed SQLITE_MA
ae00: 58 5f 41 54 54 41 43 48 45 44 2c 20 74 68 65 6e X_ATTACHED, then
ae10: 20 61 6c 6c 20 61 74 74 61 63 68 65 64 20 64 61 all attached da
ae20: 74 61 62 61 73 65 73 20 61 72 65 0a 2a 2a 20 63 tabases are.** c
ae30: 68 65 63 6b 70 6f 69 6e 74 65 64 2e 20 49 66 20 heckpointed. If
ae40: 61 6e 20 65 72 72 6f 72 20 69 73 20 65 6e 63 6f an error is enco
ae50: 75 6e 74 65 72 65 64 20 69 74 20 69 73 20 72 65 untered it is re
ae60: 74 75 72 6e 65 64 20 69 6d 6d 65 64 69 61 74 65 turned immediate
ae70: 6c 79 20 2d 0a 2a 2a 20 6e 6f 20 61 74 74 65 6d ly -.** no attem
ae80: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 63 68 pt is made to ch
ae90: 65 63 6b 70 6f 69 6e 74 20 61 6e 79 20 72 65 6d eckpoint any rem
aea0: 61 69 6e 69 6e 67 20 64 61 74 61 62 61 73 65 73 aining databases
aeb0: 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 ..**.** Paramete
aec0: 72 20 65 4d 6f 64 65 20 69 73 20 6f 6e 65 20 6f r eMode is one o
aed0: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f f SQLITE_CHECKPO
aee0: 49 4e 54 5f 50 41 53 53 49 56 45 2c 20 46 55 4c INT_PASSIVE, FUL
aef0: 4c 20 6f 72 20 52 45 53 54 41 52 54 2e 0a 2a 2f L or RESTART..*/
af00: 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 .int sqlite3Chec
af10: 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a kpoint(sqlite3 *
af20: 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 69 6e 74 db, int iDb, int
af30: 20 65 4d 6f 64 65 2c 20 69 6e 74 20 2a 70 6e 4c eMode, int *pnL
af40: 6f 67 2c 20 69 6e 74 20 2a 70 6e 43 6b 70 74 29 og, int *pnCkpt)
af50: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
af60: 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 ITE_OK;
af70: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
af80: 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 3b 20 20 de */. int i;
af90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
afa0: 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 /* Used
afb0: 74 6f 20 69 74 65 72 61 74 65 20 74 68 72 6f 75 to iterate throu
afc0: 67 68 20 61 74 74 61 63 68 65 64 20 64 62 73 20 gh attached dbs
afd0: 2a 2f 0a 20 20 69 6e 74 20 62 42 75 73 79 20 3d */. int bBusy =
afe0: 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
aff0: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
b000: 53 51 4c 49 54 45 5f 42 55 53 59 20 68 61 73 20 SQLITE_BUSY has
b010: 62 65 65 6e 20 65 6e 63 6f 75 6e 74 65 72 65 64 been encountered
b020: 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
b030: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
b040: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a d(db->mutex) );.
b050: 20 20 61 73 73 65 72 74 28 20 21 70 6e 4c 6f 67 assert( !pnLog
b060: 20 7c 7c 20 2a 70 6e 4c 6f 67 3d 3d 2d 31 20 29 || *pnLog==-1 )
b070: 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 6e 43 ;. assert( !pnC
b080: 6b 70 74 20 7c 7c 20 2a 70 6e 43 6b 70 74 3d 3d kpt || *pnCkpt==
b090: 2d 31 20 29 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 -1 );.. for(i=0
b0a0: 3b 20 69 3c 64 62 2d 3e 6e 44 62 20 26 26 20 72 ; i<db->nDb && r
b0b0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 2b c==SQLITE_OK; i+
b0c0: 2b 29 7b 0a 20 20 20 20 69 66 28 20 69 3d 3d 69 +){. if( i==i
b0d0: 44 62 20 7c 7c 20 69 44 62 3d 3d 53 51 4c 49 54 Db || iDb==SQLIT
b0e0: 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 29 E_MAX_ATTACHED )
b0f0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
b100: 69 74 65 33 42 74 72 65 65 43 68 65 63 6b 70 6f ite3BtreeCheckpo
b110: 69 6e 74 28 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 int(db->aDb[i].p
b120: 42 74 2c 20 65 4d 6f 64 65 2c 20 70 6e 4c 6f 67 Bt, eMode, pnLog
b130: 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 20 20 20 , pnCkpt);.
b140: 20 70 6e 4c 6f 67 20 3d 20 30 3b 0a 20 20 20 20 pnLog = 0;.
b150: 20 20 70 6e 43 6b 70 74 20 3d 20 30 3b 0a 20 20 pnCkpt = 0;.
b160: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
b170: 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 TE_BUSY ){.
b180: 20 20 20 62 42 75 73 79 20 3d 20 31 3b 0a 20 20 bBusy = 1;.
b190: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
b1a0: 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 E_OK;. }.
b1b0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 }. }.. retur
b1c0: 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b n (rc==SQLITE_OK
b1d0: 20 26 26 20 62 42 75 73 79 29 20 3f 20 53 51 4c && bBusy) ? SQL
b1e0: 49 54 45 5f 42 55 53 59 20 3a 20 72 63 3b 0a 7d ITE_BUSY : rc;.}
b1f0: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
b200: 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f 0a 0a 2f E_OMIT_WAL */../
b210: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
b220: 6f 6e 20 72 65 74 75 72 6e 73 20 74 72 75 65 20 on returns true
b230: 69 66 20 6d 61 69 6e 2d 6d 65 6d 6f 72 79 20 73 if main-memory s
b240: 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 69 6e hould be used in
b250: 73 74 65 61 64 20 6f 66 0a 2a 2a 20 61 20 74 65 stead of.** a te
b260: 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 66 6f 72 mporary file for
b270: 20 74 72 61 6e 73 69 65 6e 74 20 70 61 67 65 72 transient pager
b280: 20 66 69 6c 65 73 20 61 6e 64 20 73 74 61 74 65 files and state
b290: 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 73 2e 0a 2a ment journals..*
b2a0: 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 * The value retu
b2b0: 72 6e 65 64 20 64 65 70 65 6e 64 73 20 6f 6e 20 rned depends on
b2c0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 64 62 2d the value of db-
b2d0: 3e 74 65 6d 70 5f 73 74 6f 72 65 20 28 72 75 6e >temp_store (run
b2e0: 74 69 6d 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 time.** paramete
b2f0: 72 29 20 61 6e 64 20 74 68 65 20 63 6f 6d 70 69 r) and the compi
b300: 6c 65 20 74 69 6d 65 20 76 61 6c 75 65 20 6f 66 le time value of
b310: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
b320: 52 45 2e 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c 6f RE. The.** follo
b330: 77 69 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72 wing table descr
b340: 69 62 65 73 20 74 68 65 20 72 65 6c 61 74 69 6f ibes the relatio
b350: 6e 73 68 69 70 20 62 65 74 77 65 65 6e 20 74 68 nship between th
b360: 65 73 65 20 74 77 6f 20 76 61 6c 75 65 73 0a 2a ese two values.*
b370: 2a 20 61 6e 64 20 74 68 69 73 20 66 75 6e 63 74 * and this funct
b380: 69 6f 6e 73 20 72 65 74 75 72 6e 20 76 61 6c 75 ions return valu
b390: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 53 51 4c 49 54 e..**.** SQLIT
b3a0: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 20 20 20 20 E_TEMP_STORE
b3b0: 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 db->temp_store
b3c0: 20 20 20 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 Location of
b3d0: 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 temporary databa
b3e0: 73 65 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d se.** --------
b3f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d --------- --
b400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 ------------
b410: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ---------------
b420: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
b430: 2a 2a 20 20 20 30 20 20 20 20 20 20 20 20 20 20 ** 0
b440: 20 20 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 any
b450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 fi
b460: 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 le (return
b470: 30 29 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 20 0).** 1
b480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 20 1
b490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b4a0: 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 file (retu
b4b0: 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 20 20 20 rn 0).** 1
b4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b4d0: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
b4e0: 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 memory (r
b4f0: 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 31 20 eturn 1).** 1
b500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b510: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 0
b520: 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 file
b530: 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 (return 0).**
b540: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
b550: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 1
b560: 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 file
b570: 20 20 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a (return 0).*
b580: 2a 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 * 2
b590: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 2
b5a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d mem
b5b0: 6f 72 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 ory (return 1
b5c0: 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 20 20 ).** 2
b5d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20 0
b5e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b5f0: 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 74 75 72 memory (retur
b600: 6e 20 31 29 0a 2a 2a 20 20 20 33 20 20 20 20 20 n 1).** 3
b610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b620: 61 6e 79 20 20 20 20 20 20 20 20 20 20 20 20 20 any
b630: 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 memory (re
b640: 74 75 72 6e 20 31 29 0a 2a 2f 0a 69 6e 74 20 73 turn 1).*/.int s
b650: 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f qlite3TempInMemo
b660: 72 79 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 ry(const sqlite3
b670: 20 2a 64 62 29 7b 0a 23 69 66 20 53 51 4c 49 54 *db){.#if SQLIT
b680: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 31 0a E_TEMP_STORE==1.
b690: 20 20 72 65 74 75 72 6e 20 28 20 64 62 2d 3e 74 return ( db->t
b6a0: 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 29 3b 0a emp_store==2 );.
b6b0: 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
b6c0: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 32 0a E_TEMP_STORE==2.
b6d0: 20 20 72 65 74 75 72 6e 20 28 20 64 62 2d 3e 74 return ( db->t
b6e0: 65 6d 70 5f 73 74 6f 72 65 21 3d 31 20 29 3b 0a emp_store!=1 );.
b6f0: 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
b700: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 0a E_TEMP_STORE==3.
b710: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 return 1;.#end
b720: 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 45 if.#if SQLITE_TE
b730: 4d 50 5f 53 54 4f 52 45 3c 31 20 7c 7c 20 53 51 MP_STORE<1 || SQ
b740: 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3e LITE_TEMP_STORE>
b750: 33 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 3. return 0;.#e
b760: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 ndif.}../*.** Re
b770: 74 75 72 6e 20 55 54 46 2d 38 20 65 6e 63 6f 64 turn UTF-8 encod
b780: 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 ed English langu
b790: 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 age explanation
b7a0: 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 of the most rece
b7b0: 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a nt.** error..*/.
b7c0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 const char *sqli
b7d0: 74 65 33 5f 65 72 72 6d 73 67 28 73 71 6c 69 74 te3_errmsg(sqlit
b7e0: 65 33 20 2a 64 62 29 7b 0a 20 20 63 6f 6e 73 74 e3 *db){. const
b7f0: 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69 66 28 20 char *z;. if(
b800: 21 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 !db ){. retur
b810: 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 n sqlite3ErrStr(
b820: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 SQLITE_NOMEM);.
b830: 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 }. if( !sqlite
b840: 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 3SafetyCheckSick
b850: 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 OrOk(db) ){.
b860: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 return sqlite3Er
b870: 72 53 74 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 rStr(SQLITE_MISU
b880: 53 45 5f 42 4b 50 54 29 3b 0a 20 20 7d 0a 20 20 SE_BKPT);. }.
b890: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
b8a0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
b8b0: 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 if( db->malloc
b8c0: 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 Failed ){. z
b8d0: 3d 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 = sqlite3ErrStr(
b8e0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 SQLITE_NOMEM);.
b8f0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 20 3d 20 }else{. z =
b900: 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76 (char*)sqlite3_v
b910: 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e 70 45 alue_text(db->pE
b920: 72 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 rr);. assert(
b930: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
b940: 65 64 20 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d ed );. if( z=
b950: 3d 30 20 29 7b 0a 20 20 20 20 20 20 7a 20 3d 20 =0 ){. z =
b960: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 sqlite3ErrStr(db
b970: 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 20 20 ->errCode);.
b980: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f }. }. sqlite3_
b990: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
b9a0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
b9b0: 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 z;.}..#ifndef S
b9c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
b9d0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 ./*.** Return UT
b9e0: 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 F-16 encoded Eng
b9f0: 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 lish language ex
ba00: 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 planation of the
ba10: 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 most recent.**
ba20: 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 error..*/.const
ba30: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 void *sqlite3_er
ba40: 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a rmsg16(sqlite3 *
ba50: 64 62 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f db){. static co
ba60: 6e 73 74 20 75 31 36 20 6f 75 74 4f 66 4d 65 6d nst u16 outOfMem
ba70: 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6f 27 2c 20 [] = {. 'o',
ba80: 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 27 'u', 't', ' ', '
ba90: 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 20 27 6d o', 'f', ' ', 'm
baa0: 27 2c 20 27 65 27 2c 20 27 6d 27 2c 20 27 6f 27 ', 'e', 'm', 'o'
bab0: 2c 20 27 72 27 2c 20 27 79 27 2c 20 30 0a 20 20 , 'r', 'y', 0.
bac0: 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 };. static cons
bad0: 74 20 75 31 36 20 6d 69 73 75 73 65 5b 5d 20 3d t u16 misuse[] =
bae0: 20 7b 0a 20 20 20 20 27 6c 27 2c 20 27 69 27 2c {. 'l', 'i',
baf0: 20 27 62 27 2c 20 27 72 27 2c 20 27 61 27 2c 20 'b', 'r', 'a',
bb00: 27 72 27 2c 20 27 79 27 2c 20 27 20 27 2c 20 0a 'r', 'y', ' ', .
bb10: 20 20 20 20 27 72 27 2c 20 27 6f 27 2c 20 27 75 'r', 'o', 'u
bb20: 27 2c 20 27 74 27 2c 20 27 69 27 2c 20 27 6e 27 ', 't', 'i', 'n'
bb30: 2c 20 27 65 27 2c 20 27 20 27 2c 20 0a 20 20 20 , 'e', ' ', .
bb40: 20 27 63 27 2c 20 27 61 27 2c 20 27 6c 27 2c 20 'c', 'a', 'l',
bb50: 27 6c 27 2c 20 27 65 27 2c 20 27 64 27 2c 20 27 'l', 'e', 'd', '
bb60: 20 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 27 75 ', . 'o', 'u
bb70: 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 0a 20 20 ', 't', ' ', .
bb80: 20 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 'o', 'f', ' ',
bb90: 20 0a 20 20 20 20 27 73 27 2c 20 27 65 27 2c 20 . 's', 'e',
bba0: 27 71 27 2c 20 27 75 27 2c 20 27 65 27 2c 20 27 'q', 'u', 'e', '
bbb0: 6e 27 2c 20 27 63 27 2c 20 27 65 27 2c 20 30 0a n', 'c', 'e', 0.
bbc0: 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 76 6f };.. const vo
bbd0: 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 62 id *z;. if( !db
bbe0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 ){. return (
bbf0: 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 6d 3b void *)outOfMem;
bc00: 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 . }. if( !sqli
bc10: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 te3SafetyCheckSi
bc20: 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 ckOrOk(db) ){.
bc30: 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a return (void *
bc40: 29 6d 69 73 75 73 65 3b 0a 20 20 7d 0a 20 20 73 )misuse;. }. s
bc50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
bc60: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
bc70: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
bc80: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d ailed ){. z =
bc90: 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 (void *)outOfMe
bca0: 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 m;. }else{.
bcb0: 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 z = sqlite3_valu
bcc0: 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 e_text16(db->pEr
bcd0: 72 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 r);. if( z==0
bce0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
bcf0: 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3ValueSetStr(db-
bd00: 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c 69 74 >pErr, -1, sqlit
bd10: 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 e3ErrStr(db->err
bd20: 43 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 20 20 Code),.
bd30: 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 SQLITE_UTF8, S
bd40: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 QLITE_STATIC);.
bd50: 20 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 z = sqlite3
bd60: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 _value_text16(db
bd70: 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 7d 0a 20 ->pErr);. }.
bd80: 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 28 29 /* A malloc()
bd90: 20 6d 61 79 20 68 61 76 65 20 66 61 69 6c 65 64 may have failed
bda0: 20 77 69 74 68 69 6e 20 74 68 65 20 63 61 6c 6c within the call
bdb0: 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 to sqlite3_valu
bdc0: 65 5f 74 65 78 74 31 36 28 29 0a 20 20 20 20 2a e_text16(). *
bdd0: 2a 20 61 62 6f 76 65 2e 20 49 66 20 74 68 69 73 * above. If this
bde0: 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 74 68 is the case, th
bdf0: 65 6e 20 74 68 65 20 64 62 2d 3e 6d 61 6c 6c 6f en the db->mallo
be00: 63 46 61 69 6c 65 64 20 66 6c 61 67 20 6e 65 65 cFailed flag nee
be10: 64 73 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 ds to. ** be
be20: 63 6c 65 61 72 65 64 20 62 65 66 6f 72 65 20 72 cleared before r
be30: 65 74 75 72 6e 69 6e 67 2e 20 44 6f 20 74 68 69 eturning. Do thi
be40: 73 20 64 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 s directly, inst
be50: 65 61 64 20 6f 66 20 76 69 61 0a 20 20 20 20 2a ead of via. *
be60: 2a 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 * sqlite3ApiExit
be70: 28 29 2c 20 74 6f 20 61 76 6f 69 64 20 73 65 74 (), to avoid set
be80: 74 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 ting the databas
be90: 65 20 68 61 6e 64 6c 65 20 65 72 72 6f 72 20 6d e handle error m
bea0: 65 73 73 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 essage.. */.
beb0: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 db->mallocFai
bec0: 6c 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 led = 0;. }. s
bed0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
bee0: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
bef0: 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e return z;.}.#en
bf00: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
bf10: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a IT_UTF16 */../*.
bf20: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d 6f ** Return the mo
bf30: 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 st recent error
bf40: 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20 62 code generated b
bf50: 79 20 61 6e 20 53 51 4c 69 74 65 20 72 6f 75 74 y an SQLite rout
bf60: 69 6e 65 2e 20 49 66 20 4e 55 4c 4c 20 69 73 0a ine. If NULL is.
bf70: 2a 2a 20 70 61 73 73 65 64 20 74 6f 20 74 68 69 ** passed to thi
bf80: 73 20 66 75 6e 63 74 69 6f 6e 2c 20 77 65 20 61 s function, we a
bf90: 73 73 75 6d 65 20 61 20 6d 61 6c 6c 6f 63 28 29 ssume a malloc()
bfa0: 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 73 failed during s
bfb0: 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a qlite3_open()..*
bfc0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 72 /.int sqlite3_er
bfd0: 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a 64 rcode(sqlite3 *d
bfe0: 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 26 20 b){. if( db &&
bff0: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
c000: 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 eckSickOrOk(db)
c010: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
c020: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
c030: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 62 20 ;. }. if( !db
c040: 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 || db->mallocFai
c050: 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 led ){. retur
c060: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a n SQLITE_NOMEM;.
c070: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 2d }. return db-
c080: 3e 65 72 72 43 6f 64 65 20 26 20 64 62 2d 3e 65 >errCode & db->e
c090: 72 72 4d 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 71 rrMask;.}.int sq
c0a0: 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 64 5f 65 lite3_extended_e
c0b0: 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a rrcode(sqlite3 *
c0c0: 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 26 db){. if( db &&
c0d0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
c0e0: 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
c0f0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
c100: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
c110: 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 62 T;. }. if( !db
c120: 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 || db->mallocFa
c130: 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 iled ){. retu
c140: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
c150: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 . }. return db
c160: 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a ->errCode;.}../*
c170: 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 .** Create a new
c180: 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 collating funct
c190: 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 73 65 ion for database
c1a0: 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 6d 65 "db". The name
c1b0: 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 6e 64 is zName.** and
c1c0: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 the encoding is
c1d0: 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 enc..*/.static
c1e0: 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 int createCollat
c1f0: 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 ion(. sqlite3*
c200: 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 db,. const char
c210: 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 75 38 20 65 *zName, . u8 e
c220: 6e 63 2c 0a 20 20 75 38 20 63 6f 6c 6c 54 79 70 nc,. u8 collTyp
c230: 65 2c 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c e,. void* pCtx,
c240: 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 . int(*xCompare
c250: 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
c260: 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 t void*,int,cons
c270: 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 t void*),. void
c280: 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 (*xDel)(void*).)
c290: 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f {. CollSeq *pCo
c2a0: 6c 6c 3b 0a 20 20 69 6e 74 20 65 6e 63 32 3b 0a ll;. int enc2;.
c2b0: 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 71 int nName = sq
c2c0: 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4e lite3Strlen30(zN
c2d0: 61 6d 65 29 3b 0a 20 20 0a 20 20 61 73 73 65 72 ame);. . asser
c2e0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
c2f0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 _held(db->mutex)
c300: 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c );.. /* If SQL
c310: 49 54 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 ITE_UTF16 is spe
c320: 63 69 66 69 65 64 20 61 73 20 74 68 65 20 65 6e cified as the en
c330: 63 6f 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 coding type, tra
c340: 6e 73 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a nsform this. **
c350: 20 74 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 to one of SQLIT
c360: 45 5f 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c E_UTF16LE or SQL
c370: 49 54 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e ITE_UTF16BE usin
c380: 67 20 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 g the. ** SQLIT
c390: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 E_UTF16NATIVE ma
c3a0: 63 72 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 cro. SQLITE_UTF1
c3b0: 36 20 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 6 is not used in
c3c0: 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 ternally.. */.
c3d0: 20 65 6e 63 32 20 3d 20 65 6e 63 3b 0a 20 20 74 enc2 = enc;. t
c3e0: 65 73 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 estcase( enc2==S
c3f0: 51 4c 49 54 45 5f 55 54 46 31 36 20 29 3b 0a 20 QLITE_UTF16 );.
c400: 20 74 65 73 74 63 61 73 65 28 20 65 6e 63 32 3d testcase( enc2=
c410: 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c =SQLITE_UTF16_AL
c420: 49 47 4e 45 44 20 29 3b 0a 20 20 69 66 28 20 65 IGNED );. if( e
c430: 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 nc2==SQLITE_UTF1
c440: 36 20 7c 7c 20 65 6e 63 32 3d 3d 53 51 4c 49 54 6 || enc2==SQLIT
c450: 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 E_UTF16_ALIGNED
c460: 29 7b 0a 20 20 20 20 65 6e 63 32 20 3d 20 53 51 ){. enc2 = SQ
c470: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
c480: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 65 6e 63 32 ;. }. if( enc2
c490: 3c 53 51 4c 49 54 45 5f 55 54 46 38 20 7c 7c 20 <SQLITE_UTF8 ||
c4a0: 65 6e 63 32 3e 53 51 4c 49 54 45 5f 55 54 46 31 enc2>SQLITE_UTF1
c4b0: 36 42 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6BE ){. retur
c4c0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
c4d0: 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 BKPT;. }.. /*
c4e0: 43 68 65 63 6b 20 69 66 20 74 68 69 73 20 63 61 Check if this ca
c4f0: 6c 6c 20 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f ll is removing o
c500: 72 20 72 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 r replacing an e
c510: 78 69 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f xisting collatio
c520: 6e 20 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 n . ** sequence
c530: 2e 20 49 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 . If so, and the
c540: 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d re are active VM
c550: 73 2c 20 72 65 74 75 72 6e 20 62 75 73 79 2e 20 s, return busy.
c560: 49 66 20 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 If there. ** ar
c570: 65 20 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 2c e no active VMs,
c580: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 invalidate any
c590: 70 72 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 pre-compiled sta
c5a0: 74 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 tements.. */.
c5b0: 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 pColl = sqlite3F
c5c0: 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 indCollSeq(db, (
c5d0: 75 38 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 u8)enc2, zName,
c5e0: 30 29 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 0);. if( pColl
c5f0: 26 26 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 && pColl->xCmp )
c600: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 63 {. if( db->ac
c610: 74 69 76 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 tiveVdbeCnt ){.
c620: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
c630: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 r(db, SQLITE_BUS
c640: 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 Y, . "una
c650: 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f ble to delete/mo
c660: 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 dify collation s
c670: 65 71 75 65 6e 63 65 20 64 75 65 20 74 6f 20 61 equence due to a
c680: 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 ctive statements
c690: 22 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ");. return
c6a0: 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 SQLITE_BUSY;.
c6b0: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 }. sqlite3E
c6c0: 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 xpirePreparedSta
c6d0: 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 0a 20 20 tements(db);..
c6e0: 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 74 69 6f /* If collatio
c6f0: 6e 20 73 65 71 75 65 6e 63 65 20 70 43 6f 6c 6c n sequence pColl
c700: 20 77 61 73 20 63 72 65 61 74 65 64 20 64 69 72 was created dir
c710: 65 63 74 6c 79 20 62 79 20 61 20 63 61 6c 6c 20 ectly by a call
c720: 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 to. ** sqlite
c730: 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 3_create_collati
c740: 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 65 6e 65 on, and not gene
c750: 72 61 74 65 64 20 62 79 20 73 79 6e 74 68 43 6f rated by synthCo
c760: 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 2a 2a 20 llSeq(),. **
c770: 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 65 73 20 then any copies
c780: 6d 61 64 65 20 62 79 20 73 79 6e 74 68 43 6f 6c made by synthCol
c790: 6c 53 65 71 28 29 20 6e 65 65 64 20 74 6f 20 62 lSeq() need to b
c7a0: 65 20 69 6e 76 61 6c 69 64 61 74 65 64 2e 0a 20 e invalidated..
c7b0: 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 6f 6c 6c ** Also, coll
c7c0: 61 74 69 6f 6e 20 64 65 73 74 72 75 63 74 6f 72 ation destructor
c7d0: 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 65 6c 28 - CollSeq.xDel(
c7e0: 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 ) - function may
c7f0: 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 74 6f 20 need. ** to
c800: 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a be called.. *
c810: 2f 20 0a 20 20 20 20 69 66 28 20 28 70 43 6f 6c / . if( (pCol
c820: 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c 49 54 45 l->enc & ~SQLITE
c830: 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 29 3d _UTF16_ALIGNED)=
c840: 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 20 20 43 =enc2 ){. C
c850: 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 20 3d 20 ollSeq *aColl =
c860: 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 sqlite3HashFind(
c870: 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 7a &db->aCollSeq, z
c880: 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b 0a 20 20 Name, nName);.
c890: 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 20 int j;.
c8a0: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a for(j=0; j<3; j
c8b0: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c ++){. Col
c8c0: 6c 53 65 71 20 2a 70 20 3d 20 26 61 43 6f 6c 6c lSeq *p = &aColl
c8d0: 5b 6a 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 [j];. if(
c8e0: 20 70 2d 3e 65 6e 63 3d 3d 70 43 6f 6c 6c 2d 3e p->enc==pColl->
c8f0: 65 6e 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 enc ){.
c900: 20 69 66 28 20 70 2d 3e 78 44 65 6c 20 29 7b 0a if( p->xDel ){.
c910: 20 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 78 p->x
c920: 44 65 6c 28 70 2d 3e 70 55 73 65 72 29 3b 0a 20 Del(p->pUser);.
c930: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
c940: 20 20 20 20 20 70 2d 3e 78 43 6d 70 20 3d 20 30 p->xCmp = 0
c950: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
c960: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 }. }. }..
c970: 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 pColl = sqlite3
c980: 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 FindCollSeq(db,
c990: 28 75 38 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c (u8)enc2, zName,
c9a0: 20 31 29 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 1);. if( pColl
c9b0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
c9c0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 70 43 6f ITE_NOMEM;. pCo
c9d0: 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d 70 ll->xCmp = xComp
c9e0: 61 72 65 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 70 55 are;. pColl->pU
c9f0: 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 70 43 ser = pCtx;. pC
ca00: 6f 6c 6c 2d 3e 78 44 65 6c 20 3d 20 78 44 65 6c oll->xDel = xDel
ca10: 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 3d ;. pColl->enc =
ca20: 20 28 75 38 29 28 65 6e 63 32 20 7c 20 28 65 6e (u8)(enc2 | (en
ca30: 63 20 26 20 53 51 4c 49 54 45 5f 55 54 46 31 36 c & SQLITE_UTF16
ca40: 5f 41 4c 49 47 4e 45 44 29 29 3b 0a 20 20 70 43 _ALIGNED));. pC
ca50: 6f 6c 6c 2d 3e 74 79 70 65 20 3d 20 63 6f 6c 6c oll->type = coll
ca60: 54 79 70 65 3b 0a 20 20 73 71 6c 69 74 65 33 45 Type;. sqlite3E
ca70: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f rror(db, SQLITE_
ca80: 4f 4b 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e OK, 0);. return
ca90: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a SQLITE_OK;.}...
caa0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 61 72 72 61 79 /*.** This array
cab0: 20 64 65 66 69 6e 65 73 20 68 61 72 64 20 75 70 defines hard up
cac0: 70 65 72 20 62 6f 75 6e 64 73 20 6f 6e 20 6c 69 per bounds on li
cad0: 6d 69 74 20 76 61 6c 75 65 73 2e 20 20 54 68 65 mit values. The
cae0: 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65 72 20 .** initializer
caf0: 6d 75 73 74 20 62 65 20 6b 65 70 74 20 69 6e 20 must be kept in
cb00: 73 79 6e 63 20 77 69 74 68 20 74 68 65 20 53 51 sync with the SQ
cb10: 4c 49 54 45 5f 4c 49 4d 49 54 5f 2a 0a 2a 2a 20 LITE_LIMIT_*.**
cb20: 23 64 65 66 69 6e 65 73 20 69 6e 20 73 71 6c 69 #defines in sqli
cb30: 74 65 33 2e 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 te3.h..*/.static
cb40: 20 63 6f 6e 73 74 20 69 6e 74 20 61 48 61 72 64 const int aHard
cb50: 4c 69 6d 69 74 5b 5d 20 3d 20 7b 0a 20 20 53 51 Limit[] = {. SQ
cb60: 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 2c LITE_MAX_LENGTH,
cb70: 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 . SQLITE_MAX_SQ
cb80: 4c 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 L_LENGTH,. SQLI
cb90: 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 2c 0a 20 TE_MAX_COLUMN,.
cba0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 SQLITE_MAX_EXPR
cbb0: 5f 44 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 _DEPTH,. SQLITE
cbc0: 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 _MAX_COMPOUND_SE
cbd0: 4c 45 43 54 2c 0a 20 20 53 51 4c 49 54 45 5f 4d LECT,. SQLITE_M
cbe0: 41 58 5f 56 44 42 45 5f 4f 50 2c 0a 20 20 53 51 AX_VDBE_OP,. SQ
cbf0: 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f LITE_MAX_FUNCTIO
cc00: 4e 5f 41 52 47 2c 0a 20 20 53 51 4c 49 54 45 5f N_ARG,. SQLITE_
cc10: 4d 41 58 5f 41 54 54 41 43 48 45 44 2c 0a 20 20 MAX_ATTACHED,.
cc20: 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f SQLITE_MAX_LIKE_
cc30: 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 2c 0a PATTERN_LENGTH,.
cc40: 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 SQLITE_MAX_VAR
cc50: 49 41 42 4c 45 5f 4e 55 4d 42 45 52 2c 0a 20 20 IABLE_NUMBER,.
cc60: 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 SQLITE_MAX_TRIGG
cc70: 45 52 5f 44 45 50 54 48 2c 0a 7d 3b 0a 0a 2f 2a ER_DEPTH,.};../*
cc80: 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 .** Make sure th
cc90: 65 20 68 61 72 64 20 6c 69 6d 69 74 73 20 61 72 e hard limits ar
cca0: 65 20 73 65 74 20 74 6f 20 72 65 61 73 6f 6e 61 e set to reasona
ccb0: 62 6c 65 20 76 61 6c 75 65 73 0a 2a 2f 0a 23 69 ble values.*/.#i
ccc0: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e f SQLITE_MAX_LEN
ccd0: 47 54 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 GTH<100.# error
cce0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 SQLITE_MAX_LENGT
ccf0: 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 H must be at lea
cd00: 73 74 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 69 st 100.#endif.#i
cd10: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c f SQLITE_MAX_SQL
cd20: 5f 4c 45 4e 47 54 48 3c 31 30 30 0a 23 20 65 72 _LENGTH<100.# er
cd30: 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 ror SQLITE_MAX_S
cd40: 51 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 QL_LENGTH must b
cd50: 65 20 61 74 20 6c 65 61 73 74 20 31 30 30 0a 23 e at least 100.#
cd60: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
cd70: 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 3e _MAX_SQL_LENGTH>
cd80: 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 SQLITE_MAX_LENGT
cd90: 48 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 H.# error SQLITE
cda0: 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 _MAX_SQL_LENGTH
cdb0: 6d 75 73 74 20 6e 6f 74 20 62 65 20 67 72 65 61 must not be grea
cdc0: 74 65 72 20 74 68 61 6e 20 53 51 4c 49 54 45 5f ter than SQLITE_
cdd0: 4d 41 58 5f 4c 45 4e 47 54 48 0a 23 65 6e 64 69 MAX_LENGTH.#endi
cde0: 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 f.#if SQLITE_MAX
cdf0: 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 _COMPOUND_SELECT
ce00: 3c 32 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 <2.# error SQLIT
ce10: 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 E_MAX_COMPOUND_S
ce20: 45 4c 45 43 54 20 6d 75 73 74 20 62 65 20 61 74 ELECT must be at
ce30: 20 6c 65 61 73 74 20 32 0a 23 65 6e 64 69 66 0a least 2.#endif.
ce40: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 #if SQLITE_MAX_V
ce50: 44 42 45 5f 4f 50 3c 34 30 0a 23 20 65 72 72 6f DBE_OP<40.# erro
ce60: 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 r SQLITE_MAX_VDB
ce70: 45 5f 4f 50 20 6d 75 73 74 20 62 65 20 61 74 20 E_OP must be at
ce80: 6c 65 61 73 74 20 34 30 0a 23 65 6e 64 69 66 0a least 40.#endif.
ce90: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 #if SQLITE_MAX_F
cea0: 55 4e 43 54 49 4f 4e 5f 41 52 47 3c 30 20 7c 7c UNCTION_ARG<0 ||
ceb0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 SQLITE_MAX_FUNC
cec0: 54 49 4f 4e 5f 41 52 47 3e 31 30 30 30 0a 23 20 TION_ARG>1000.#
ced0: 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
cee0: 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 20 6d 75 _FUNCTION_ARG mu
cef0: 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 st be between 0
cf00: 61 6e 64 20 31 30 30 30 0a 23 65 6e 64 69 66 0a and 1000.#endif.
cf10: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 #if SQLITE_MAX_A
cf20: 54 54 41 43 48 45 44 3c 30 20 7c 7c 20 53 51 4c TTACHED<0 || SQL
cf30: 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
cf40: 3e 36 32 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 >62.# error SQLI
cf50: 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 TE_MAX_ATTACHED
cf60: 6d 75 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 must be between
cf70: 30 20 61 6e 64 20 36 32 0a 23 65 6e 64 69 66 0a 0 and 62.#endif.
cf80: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c #if SQLITE_MAX_L
cf90: 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
cfa0: 54 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c TH<1.# error SQL
cfb0: 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 ITE_MAX_LIKE_PAT
cfc0: 54 45 52 4e 5f 4c 45 4e 47 54 48 20 6d 75 73 74 TERN_LENGTH must
cfd0: 20 62 65 20 61 74 20 6c 65 61 73 74 20 31 0a 23 be at least 1.#
cfe0: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
cff0: 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 3e 33 32 37 36 _MAX_COLUMN>3276
d000: 37 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 7.# error SQLITE
d010: 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 20 6d 75 73 74 _MAX_COLUMN must
d020: 20 6e 6f 74 20 65 78 63 65 65 64 20 33 32 37 36 not exceed 3276
d030: 37 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 7.#endif.#if SQL
d040: 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f ITE_MAX_TRIGGER_
d050: 44 45 50 54 48 3c 31 0a 23 20 65 72 72 6f 72 20 DEPTH<1.# error
d060: 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 SQLITE_MAX_TRIGG
d070: 45 52 5f 44 45 50 54 48 20 6d 75 73 74 20 62 65 ER_DEPTH must be
d080: 20 61 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 at least 1.#end
d090: 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 if.../*.** Chang
d0a0: 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 e the value of a
d0b0: 20 6c 69 6d 69 74 2e 20 20 52 65 70 6f 72 74 20 limit. Report
d0c0: 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 2e 0a 2a the old value..*
d0d0: 2a 20 49 66 20 61 6e 20 69 6e 76 61 6c 69 64 20 * If an invalid
d0e0: 6c 69 6d 69 74 20 69 6e 64 65 78 20 69 73 20 73 limit index is s
d0f0: 75 70 70 6c 69 65 64 2c 20 72 65 70 6f 72 74 20 upplied, report
d100: 2d 31 2e 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 -1..** Make no c
d110: 68 61 6e 67 65 73 20 62 75 74 20 73 74 69 6c 6c hanges but still
d120: 20 72 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 report the old
d130: 76 61 6c 75 65 20 69 66 20 74 68 65 0a 2a 2a 20 value if the.**
d140: 6e 65 77 20 6c 69 6d 69 74 20 69 73 20 6e 65 67 new limit is neg
d150: 61 74 69 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e ative..**.** A n
d160: 65 77 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 64 ew lower limit d
d170: 6f 65 73 20 6e 6f 74 20 73 68 72 69 6e 6b 20 65 oes not shrink e
d180: 78 69 73 74 69 6e 67 20 63 6f 6e 73 74 72 75 63 xisting construc
d190: 74 73 2e 0a 2a 2a 20 49 74 20 6d 65 72 65 6c 79 ts..** It merely
d1a0: 20 70 72 65 76 65 6e 74 73 20 6e 65 77 20 63 6f prevents new co
d1b0: 6e 73 74 72 75 63 74 73 20 74 68 61 74 20 65 78 nstructs that ex
d1c0: 63 65 65 64 20 74 68 65 20 6c 69 6d 69 74 0a 2a ceed the limit.*
d1d0: 2a 20 66 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e 0a * from forming..
d1e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c */.int sqlite3_l
d1f0: 69 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 imit(sqlite3 *db
d200: 2c 20 69 6e 74 20 6c 69 6d 69 74 49 64 2c 20 69 , int limitId, i
d210: 6e 74 20 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 20 nt newLimit){.
d220: 69 6e 74 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a 0a int oldLimit;...
d230: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
d240: 3a 20 52 2d 33 30 31 38 39 2d 35 34 30 39 37 20 : R-30189-54097
d250: 46 6f 72 20 65 61 63 68 20 6c 69 6d 69 74 20 63 For each limit c
d260: 61 74 65 67 6f 72 79 20 53 51 4c 49 54 45 5f 4c ategory SQLITE_L
d270: 49 4d 49 54 5f 4e 41 4d 45 0a 20 20 2a 2a 20 74 IMIT_NAME. ** t
d280: 68 65 72 65 20 69 73 20 61 20 68 61 72 64 20 75 here is a hard u
d290: 70 70 65 72 20 62 6f 75 6e 64 20 73 65 74 20 61 pper bound set a
d2a0: 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 62 t compile-time b
d2b0: 79 20 61 20 43 20 70 72 65 70 72 6f 63 65 73 73 y a C preprocess
d2c0: 6f 72 0a 20 20 2a 2a 20 6d 61 63 72 6f 20 63 61 or. ** macro ca
d2d0: 6c 6c 65 64 20 53 51 4c 49 54 45 5f 4d 41 58 5f lled SQLITE_MAX_
d2e0: 4e 41 4d 45 2e 20 28 54 68 65 20 22 5f 4c 49 4d NAME. (The "_LIM
d2f0: 49 54 5f 22 20 69 6e 20 74 68 65 20 6e 61 6d 65 IT_" in the name
d300: 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f 0a 20 is changed to.
d310: 20 2a 2a 20 22 5f 4d 41 58 5f 22 2e 29 0a 20 20 ** "_MAX_".).
d320: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 */. assert( aHa
d330: 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c rdLimit[SQLITE_L
d340: 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 3d 3d 53 51 IMIT_LENGTH]==SQ
d350: 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 20 LITE_MAX_LENGTH
d360: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 );. assert( aHa
d370: 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c rdLimit[SQLITE_L
d380: 49 4d 49 54 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d IMIT_SQL_LENGTH]
d390: 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c ==SQLITE_MAX_SQL
d3a0: 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 _LENGTH );. ass
d3b0: 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
d3c0: 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 43 4f 4c SQLITE_LIMIT_COL
d3d0: 55 4d 4e 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 UMN]==SQLITE_MAX
d3e0: 5f 43 4f 4c 55 4d 4e 20 29 3b 0a 20 20 61 73 73 _COLUMN );. ass
d3f0: 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
d400: 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 45 58 50 SQLITE_LIMIT_EXP
d410: 52 5f 44 45 50 54 48 5d 3d 3d 53 51 4c 49 54 45 R_DEPTH]==SQLITE
d420: 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 20 _MAX_EXPR_DEPTH
d430: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 );. assert( aHa
d440: 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c rdLimit[SQLITE_L
d450: 49 4d 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 IMIT_COMPOUND_SE
d460: 4c 45 43 54 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 LECT]==SQLITE_MA
d470: 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 X_COMPOUND_SELEC
d480: 54 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 T);. assert( aH
d490: 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f ardLimit[SQLITE_
d4a0: 4c 49 4d 49 54 5f 56 44 42 45 5f 4f 50 5d 3d 3d LIMIT_VDBE_OP]==
d4b0: 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f SQLITE_MAX_VDBE_
d4c0: 4f 50 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 OP );. assert(
d4d0: 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
d4e0: 45 5f 4c 49 4d 49 54 5f 46 55 4e 43 54 49 4f 4e E_LIMIT_FUNCTION
d4f0: 5f 41 52 47 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 _ARG]==SQLITE_MA
d500: 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 20 29 X_FUNCTION_ARG )
d510: 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
d520: 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
d530: 4d 49 54 5f 41 54 54 41 43 48 45 44 5d 3d 3d 53 MIT_ATTACHED]==S
d540: 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 QLITE_MAX_ATTACH
d550: 45 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ED );. assert(
d560: 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
d570: 45 5f 4c 49 4d 49 54 5f 4c 49 4b 45 5f 50 41 54 E_LIMIT_LIKE_PAT
d580: 54 45 52 4e 5f 4c 45 4e 47 54 48 5d 3d 3d 0a 20 TERN_LENGTH]==.
d590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d5a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d5b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
d5c0: 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 LITE_MAX_LIKE_PA
d5d0: 54 54 45 52 4e 5f 4c 45 4e 47 54 48 20 29 3b 0a TTERN_LENGTH );.
d5e0: 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 4c assert( aHardL
d5f0: 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 imit[SQLITE_LIMI
d600: 54 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 T_VARIABLE_NUMBE
d610: 52 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 56 R]==SQLITE_MAX_V
d620: 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 29 3b ARIABLE_NUMBER);
d630: 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
d640: 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
d650: 49 54 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 IT_TRIGGER_DEPTH
d660: 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 ]==SQLITE_MAX_TR
d670: 49 47 47 45 52 5f 44 45 50 54 48 20 29 3b 0a 20 IGGER_DEPTH );.
d680: 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f assert( SQLITE_
d690: 4c 49 4d 49 54 5f 54 52 49 47 47 45 52 5f 44 45 LIMIT_TRIGGER_DE
d6a0: 50 54 48 3d 3d 28 53 51 4c 49 54 45 5f 4e 5f 4c PTH==(SQLITE_N_L
d6b0: 49 4d 49 54 2d 31 29 20 29 3b 0a 0a 0a 20 20 69 IMIT-1) );... i
d6c0: 66 28 20 6c 69 6d 69 74 49 64 3c 30 20 7c 7c 20 f( limitId<0 ||
d6d0: 6c 69 6d 69 74 49 64 3e 3d 53 51 4c 49 54 45 5f limitId>=SQLITE_
d6e0: 4e 5f 4c 49 4d 49 54 20 29 7b 0a 20 20 20 20 72 N_LIMIT ){. r
d6f0: 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 eturn -1;. }.
d700: 6f 6c 64 4c 69 6d 69 74 20 3d 20 64 62 2d 3e 61 oldLimit = db->a
d710: 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 3b 0a Limit[limitId];.
d720: 20 20 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 3d if( newLimit>=
d730: 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 0 ){
d740: 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 /* IMP: R
d750: 2d 35 32 34 37 36 2d 32 38 37 33 32 20 2a 2f 0a -52476-28732 */.
d760: 20 20 20 20 69 66 28 20 6e 65 77 4c 69 6d 69 74 if( newLimit
d770: 3e 61 48 61 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 >aHardLimit[limi
d780: 74 49 64 5d 20 29 7b 0a 20 20 20 20 20 20 6e 65 tId] ){. ne
d790: 77 4c 69 6d 69 74 20 3d 20 61 48 61 72 64 4c 69 wLimit = aHardLi
d7a0: 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 3b 20 20 2f mit[limitId]; /
d7b0: 2a 20 49 4d 50 3a 20 52 2d 35 31 34 36 33 2d 32 * IMP: R-51463-2
d7c0: 35 36 33 34 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 5634 */. }.
d7d0: 20 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d db->aLimit[lim
d7e0: 69 74 49 64 5d 20 3d 20 6e 65 77 4c 69 6d 69 74 itId] = newLimit
d7f0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6f ;. }. return o
d800: 6c 64 4c 69 6d 69 74 3b 20 20 20 20 20 20 20 20 ldLimit;
d810: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
d820: 49 4d 50 3a 20 52 2d 35 33 33 34 31 2d 33 35 34 IMP: R-53341-354
d830: 31 39 20 2a 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 19 */.}../*.** T
d840: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
d850: 75 73 65 64 20 74 6f 20 70 61 72 73 65 20 62 6f used to parse bo
d860: 74 68 20 55 52 49 73 20 61 6e 64 20 6e 6f 6e 2d th URIs and non-
d870: 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 20 70 61 URI filenames pa
d880: 73 73 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 75 ssed by the.** u
d890: 73 65 72 20 74 6f 20 41 50 49 20 66 75 6e 63 74 ser to API funct
d8a0: 69 6f 6e 73 20 73 71 6c 69 74 65 33 5f 6f 70 65 ions sqlite3_ope
d8b0: 6e 28 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 6f n() or sqlite3_o
d8c0: 70 65 6e 5f 76 32 28 29 2c 20 61 6e 64 20 66 6f pen_v2(), and fo
d8d0: 72 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 55 52 r database.** UR
d8e0: 49 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 Is specified as
d8f0: 70 61 72 74 20 6f 66 20 41 54 54 41 43 48 20 73 part of ATTACH s
d900: 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a tatements..**.**
d910: 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d The first argum
d920: 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e 63 ent to this func
d930: 74 69 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 tion is the name
d940: 20 6f 66 20 74 68 65 20 56 46 53 20 74 6f 20 75 of the VFS to u
d950: 73 65 20 28 6f 72 0a 2a 2a 20 61 20 4e 55 4c 4c se (or.** a NULL
d960: 20 74 6f 20 73 69 67 6e 69 66 79 20 74 68 65 20 to signify the
d970: 64 65 66 61 75 6c 74 20 56 46 53 29 20 69 66 20 default VFS) if
d980: 74 68 65 20 55 52 49 20 64 6f 65 73 20 6e 6f 74 the URI does not
d990: 20 63 6f 6e 74 61 69 6e 20 61 20 22 76 66 73 3d contain a "vfs=
d9a0: 78 78 78 22 0a 2a 2a 20 71 75 65 72 79 20 70 61 xxx".** query pa
d9b0: 72 61 6d 65 74 65 72 2e 20 54 68 65 20 73 65 63 rameter. The sec
d9c0: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 63 6f 6e ond argument con
d9d0: 74 61 69 6e 73 20 74 68 65 20 55 52 49 20 28 6f tains the URI (o
d9e0: 72 20 6e 6f 6e 2d 55 52 49 20 66 69 6c 65 6e 61 r non-URI filena
d9f0: 6d 65 29 0a 2a 2a 20 69 74 73 65 6c 66 2e 20 57 me).** itself. W
da00: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
da10: 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 n is called the
da20: 2a 70 46 6c 61 67 73 20 76 61 72 69 61 62 6c 65 *pFlags variable
da30: 20 73 68 6f 75 6c 64 20 63 6f 6e 74 61 69 6e 0a should contain.
da40: 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 ** the default f
da50: 6c 61 67 73 20 74 6f 20 6f 70 65 6e 20 74 68 65 lags to open the
da60: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
da70: 20 77 69 74 68 2e 20 54 68 65 20 76 61 6c 75 65 with. The value
da80: 20 73 74 6f 72 65 64 20 69 6e 0a 2a 2a 20 2a 70 stored in.** *p
da90: 46 6c 61 67 73 20 6d 61 79 20 62 65 20 75 70 64 Flags may be upd
daa0: 61 74 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 ated before retu
dab0: 72 6e 69 6e 67 20 69 66 20 74 68 65 20 55 52 49 rning if the URI
dac0: 20 66 69 6c 65 6e 61 6d 65 20 63 6f 6e 74 61 69 filename contai
dad0: 6e 73 20 0a 2a 2a 20 22 63 61 63 68 65 3d 78 78 ns .** "cache=xx
dae0: 78 22 20 6f 72 20 22 6d 6f 64 65 3d 78 78 78 22 x" or "mode=xxx"
daf0: 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 query parameter
db00: 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 s..**.** If succ
db10: 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f 4f essful, SQLITE_O
db20: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
db30: 6e 20 74 68 69 73 20 63 61 73 65 20 2a 70 70 56 n this case *ppV
db40: 66 73 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 fs is set to poi
db50: 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 56 46 53 nt to.** the VFS
db60: 20 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 that should be
db70: 75 73 65 64 20 74 6f 20 6f 70 65 6e 20 74 68 65 used to open the
db80: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
db90: 2a 70 7a 46 69 6c 65 20 69 73 20 73 65 74 20 74 *pzFile is set t
dba0: 6f 0a 2a 2a 20 70 6f 69 6e 74 20 74 6f 20 61 20 o.** point to a
dbb0: 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e buffer containin
dbc0: 67 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 g the name of th
dbd0: 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e 2e 20 e file to open.
dbe0: 49 74 20 69 73 20 74 68 65 20 0a 2a 2a 20 72 65 It is the .** re
dbf0: 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 sponsibility of
dc00: 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 the caller to ev
dc10: 65 6e 74 75 61 6c 6c 79 20 63 61 6c 6c 20 73 71 entually call sq
dc20: 6c 69 74 65 33 5f 66 72 65 65 28 29 20 74 6f 20 lite3_free() to
dc30: 72 65 6c 65 61 73 65 0a 2a 2a 20 74 68 69 73 20 release.** this
dc40: 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 buffer..**.** If
dc50: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
dc60: 2c 20 74 68 65 6e 20 61 6e 20 53 51 4c 69 74 65 , then an SQLite
dc70: 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 error code is r
dc80: 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 7a 45 eturned and *pzE
dc90: 72 72 4d 73 67 0a 2a 2a 20 6d 61 79 20 62 65 20 rrMsg.** may be
dca0: 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 set to point to
dcb0: 61 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e a buffer contain
dcc0: 69 6e 67 20 61 6e 20 45 6e 67 6c 69 73 68 20 6c ing an English l
dcd0: 61 6e 67 75 61 67 65 20 65 72 72 6f 72 20 0a 2a anguage error .*
dce0: 2a 20 6d 65 73 73 61 67 65 2e 20 49 74 20 69 73 * message. It is
dcf0: 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c the responsibil
dd00: 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 ity of the calle
dd10: 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c 79 20 r to eventually
dd20: 72 65 6c 65 61 73 65 0a 2a 2a 20 74 68 69 73 20 release.** this
dd30: 62 75 66 66 65 72 20 62 79 20 63 61 6c 6c 69 6e buffer by callin
dd40: 67 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 g sqlite3_free()
dd50: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
dd60: 50 61 72 73 65 55 72 69 28 0a 20 20 63 6f 6e 73 ParseUri(. cons
dd70: 74 20 63 68 61 72 20 2a 7a 44 65 66 61 75 6c 74 t char *zDefault
dd80: 56 66 73 2c 20 20 20 20 20 20 20 20 2f 2a 20 56 Vfs, /* V
dd90: 46 53 20 74 6f 20 75 73 65 20 69 66 20 6e 6f 20 FS to use if no
dda0: 22 76 66 73 3d 78 78 78 22 20 71 75 65 72 79 20 "vfs=xxx" query
ddb0: 6f 70 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 option */. cons
ddc0: 74 20 63 68 61 72 20 2a 7a 55 72 69 2c 20 20 20 t char *zUri,
ddd0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
dde0: 75 6c 2d 74 65 72 6d 69 6e 61 74 65 64 20 55 52 ul-terminated UR
ddf0: 49 20 74 6f 20 70 61 72 73 65 20 2a 2f 0a 20 20 I to parse */.
de00: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a 70 46 unsigned int *pF
de10: 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 lags,
de20: 2f 2a 20 49 4e 2f 4f 55 54 3a 20 53 51 4c 49 54 /* IN/OUT: SQLIT
de30: 45 5f 4f 50 45 4e 5f 58 58 58 20 66 6c 61 67 73 E_OPEN_XXX flags
de40: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 */. sqlite3_vf
de50: 73 20 2a 2a 70 70 56 66 73 2c 20 20 20 20 20 20 s **ppVfs,
de60: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 56 46 /* OUT: VF
de70: 53 20 74 6f 20 75 73 65 20 2a 2f 20 0a 20 20 63 S to use */ . c
de80: 68 61 72 20 2a 2a 70 7a 46 69 6c 65 2c 20 20 20 har **pzFile,
de90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
dea0: 2a 20 4f 55 54 3a 20 46 69 6c 65 6e 61 6d 65 20 * OUT: Filename
deb0: 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 55 52 49 component of URI
dec0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 */. char **pzE
ded0: 72 72 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 rrMsg
dee0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 72 /* OUT: Er
def0: 72 6f 72 20 6d 65 73 73 61 67 65 20 28 69 66 20 ror message (if
df00: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 2a rc!=SQLITE_OK) *
df10: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 /.){. int rc =
df20: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e 73 SQLITE_OK;. uns
df30: 69 67 6e 65 64 20 69 6e 74 20 66 6c 61 67 73 20 igned int flags
df40: 3d 20 2a 70 46 6c 61 67 73 3b 0a 20 20 63 6f 6e = *pFlags;. con
df50: 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 3d 20 st char *zVfs =
df60: 7a 44 65 66 61 75 6c 74 56 66 73 3b 0a 20 20 63 zDefaultVfs;. c
df70: 68 61 72 20 2a 7a 46 69 6c 65 3b 0a 20 20 63 68 har *zFile;. ch
df80: 61 72 20 63 3b 0a 20 20 69 6e 74 20 6e 55 72 69 ar c;. int nUri
df90: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e = sqlite3Strlen
dfa0: 33 30 28 7a 55 72 69 29 3b 0a 0a 20 20 61 73 73 30(zUri);.. ass
dfb0: 65 72 74 28 20 2a 70 7a 45 72 72 4d 73 67 3d 3d ert( *pzErrMsg==
dfc0: 30 20 29 3b 0a 0a 20 20 69 66 28 20 28 28 66 6c 0 );.. if( ((fl
dfd0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
dfe0: 4e 5f 55 52 49 29 20 7c 7c 20 73 71 6c 69 74 65 N_URI) || sqlite
dff0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4f 3GlobalConfig.bO
e000: 70 65 6e 55 72 69 29 20 0a 20 20 20 26 26 20 6e penUri) . && n
e010: 55 72 69 3e 3d 35 20 26 26 20 6d 65 6d 63 6d 70 Uri>=5 && memcmp
e020: 28 7a 55 72 69 2c 20 22 66 69 6c 65 3a 22 2c 20 (zUri, "file:",
e030: 35 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 20 20 5)==0 . ){.
e040: 63 68 61 72 20 2a 7a 4f 70 74 3b 0a 20 20 20 20 char *zOpt;.
e050: 69 6e 74 20 65 53 74 61 74 65 3b 20 20 20 20 20 int eState;
e060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
e070: 20 50 61 72 73 65 72 20 73 74 61 74 65 20 77 68 Parser state wh
e080: 65 6e 20 70 61 72 73 69 6e 67 20 55 52 49 20 2a en parsing URI *
e090: 2f 0a 20 20 20 20 69 6e 74 20 69 49 6e 3b 20 20 /. int iIn;
e0a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e0b0: 20 20 20 20 2f 2a 20 49 6e 70 75 74 20 63 68 61 /* Input cha
e0c0: 72 61 63 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a racter index */.
e0d0: 20 20 20 20 69 6e 74 20 69 4f 75 74 20 3d 20 30 int iOut = 0
e0e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e0f0: 20 20 2f 2a 20 4f 75 74 70 75 74 20 63 68 61 72 /* Output char
e100: 61 63 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 acter index */.
e110: 20 20 20 69 6e 74 20 6e 42 79 74 65 20 3d 20 6e int nByte = n
e120: 55 72 69 2b 32 3b 20 20 20 20 20 20 20 20 20 20 Uri+2;
e130: 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 73 70 61 /* Bytes of spa
e140: 63 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a ce to allocate *
e150: 2f 0a 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 /.. /* Make s
e160: 75 72 65 20 74 68 65 20 53 51 4c 49 54 45 5f 4f ure the SQLITE_O
e170: 50 45 4e 5f 55 52 49 20 66 6c 61 67 20 69 73 20 PEN_URI flag is
e180: 73 65 74 20 74 6f 20 69 6e 64 69 63 61 74 65 20 set to indicate
e190: 74 6f 20 74 68 65 20 56 46 53 20 78 4f 70 65 6e to the VFS xOpen
e1a0: 20 0a 20 20 20 20 2a 2a 20 6d 65 74 68 6f 64 20 . ** method
e1b0: 74 68 61 74 20 74 68 65 72 65 20 6d 61 79 20 62 that there may b
e1c0: 65 20 65 78 74 72 61 20 70 61 72 61 6d 65 74 65 e extra paramete
e1d0: 72 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 rs following the
e1e0: 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 20 2a 2f 0a file-name. */.
e1f0: 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c flags |= SQL
e200: 49 54 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a 0a 20 ITE_OPEN_URI;..
e210: 20 20 20 66 6f 72 28 69 49 6e 3d 30 3b 20 69 49 for(iIn=0; iI
e220: 6e 3c 6e 55 72 69 3b 20 69 49 6e 2b 2b 29 20 6e n<nUri; iIn++) n
e230: 42 79 74 65 20 2b 3d 20 28 7a 55 72 69 5b 69 49 Byte += (zUri[iI
e240: 6e 5d 3d 3d 27 26 27 29 3b 0a 20 20 20 20 7a 46 n]=='&');. zF
e250: 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 ile = sqlite3_ma
e260: 6c 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 20 20 20 lloc(nByte);.
e270: 20 69 66 28 20 21 7a 46 69 6c 65 20 29 20 72 65 if( !zFile ) re
e280: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
e290: 4d 3b 0a 0a 20 20 20 20 2f 2a 20 44 69 73 63 61 M;.. /* Disca
e2a0: 72 64 20 74 68 65 20 73 63 68 65 6d 65 20 61 6e rd the scheme an
e2b0: 64 20 61 75 74 68 6f 72 69 74 79 20 73 65 67 6d d authority segm
e2c0: 65 6e 74 73 20 6f 66 20 74 68 65 20 55 52 49 2e ents of the URI.
e2d0: 20 2a 2f 0a 20 20 20 20 69 66 28 20 7a 55 72 69 */. if( zUri
e2e0: 5b 35 5d 3d 3d 27 2f 27 20 26 26 20 7a 55 72 69 [5]=='/' && zUri
e2f0: 5b 36 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 [6]=='/' ){.
e300: 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 20 20 20 iIn = 7;.
e310: 20 77 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 6e while( zUri[iIn
e320: 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 3d ] && zUri[iIn]!=
e330: 27 2f 27 20 29 20 69 49 6e 2b 2b 3b 0a 0a 20 20 '/' ) iIn++;..
e340: 20 20 20 20 69 66 28 20 69 49 6e 21 3d 37 20 26 if( iIn!=7 &
e350: 26 20 28 69 49 6e 21 3d 31 36 20 7c 7c 20 6d 65 & (iIn!=16 || me
e360: 6d 63 6d 70 28 22 6c 6f 63 61 6c 68 6f 73 74 22 mcmp("localhost"
e370: 2c 20 26 7a 55 72 69 5b 37 5d 2c 20 39 29 29 20 , &zUri[7], 9))
e380: 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a 45 72 ){. *pzEr
e390: 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d rMsg = sqlite3_m
e3a0: 70 72 69 6e 74 66 28 22 69 6e 76 61 6c 69 64 20 printf("invalid
e3b0: 75 72 69 20 61 75 74 68 6f 72 69 74 79 3a 20 25 uri authority: %
e3c0: 2e 2a 73 22 2c 20 0a 20 20 20 20 20 20 20 20 20 .*s", .
e3d0: 20 20 20 69 49 6e 2d 37 2c 20 26 7a 55 72 69 5b iIn-7, &zUri[
e3e0: 37 5d 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 7]);. rc
e3f0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
e400: 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 goto par
e410: 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 se_uri_out;.
e420: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
e430: 20 20 20 20 20 69 49 6e 20 3d 20 35 3b 0a 20 20 iIn = 5;.
e440: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 }.. /* Copy
e450: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 6e the filename an
e460: 64 20 61 6e 79 20 71 75 65 72 79 20 70 61 72 61 d any query para
e470: 6d 65 74 65 72 73 20 69 6e 74 6f 20 74 68 65 20 meters into the
e480: 7a 46 69 6c 65 20 62 75 66 66 65 72 2e 20 0a 20 zFile buffer. .
e490: 20 20 20 2a 2a 20 44 65 63 6f 64 65 20 25 48 48 ** Decode %HH
e4a0: 20 65 73 63 61 70 65 20 63 6f 64 65 73 20 61 6c escape codes al
e4b0: 6f 6e 67 20 74 68 65 20 77 61 79 2e 20 0a 20 20 ong the way. .
e4c0: 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 69 74 68 **. ** With
e4d0: 69 6e 20 74 68 69 73 20 6c 6f 6f 70 2c 20 76 61 in this loop, va
e4e0: 72 69 61 62 6c 65 20 65 53 74 61 74 65 20 6d 61 riable eState ma
e4f0: 79 20 62 65 20 73 65 74 20 74 6f 20 30 2c 20 31 y be set to 0, 1
e500: 20 6f 72 20 32 2c 20 64 65 70 65 6e 64 69 6e 67 or 2, depending
e510: 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 70 . ** on the p
e520: 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 arsing context.
e530: 41 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 20 20 As follows:.
e540: 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 30 3a 20 50 **. ** 0: P
e550: 61 72 73 69 6e 67 20 66 69 6c 65 2d 6e 61 6d 65 arsing file-name
e560: 2e 0a 20 20 20 20 2a 2a 20 20 20 31 3a 20 50 61 .. ** 1: Pa
e570: 72 73 69 6e 67 20 6e 61 6d 65 20 73 65 63 74 69 rsing name secti
e580: 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 6c on of a name=val
e590: 75 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 ue query paramet
e5a0: 65 72 2e 0a 20 20 20 20 2a 2a 20 20 20 32 3a 20 er.. ** 2:
e5b0: 50 61 72 73 69 6e 67 20 76 61 6c 75 65 20 73 65 Parsing value se
e5c0: 63 74 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d ction of a name=
e5d0: 76 61 6c 75 65 20 71 75 65 72 79 20 70 61 72 61 value query para
e5e0: 6d 65 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 meter.. */.
e5f0: 20 20 65 53 74 61 74 65 20 3d 20 30 3b 0a 20 20 eState = 0;.
e600: 20 20 77 68 69 6c 65 28 20 28 63 20 3d 20 7a 55 while( (c = zU
e610: 72 69 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 63 ri[iIn])!=0 && c
e620: 21 3d 27 23 27 20 29 7b 0a 20 20 20 20 20 20 69 !='#' ){. i
e630: 49 6e 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 In++;. if(
e640: 63 3d 3d 27 25 27 20 0a 20 20 20 20 20 20 20 26 c=='%' . &
e650: 26 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 & sqlite3Isxdigi
e660: 74 28 7a 55 72 69 5b 69 49 6e 5d 29 20 0a 20 20 t(zUri[iIn]) .
e670: 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 49 && sqlite3I
e680: 73 78 64 69 67 69 74 28 7a 55 72 69 5b 69 49 6e sxdigit(zUri[iIn
e690: 2b 31 5d 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 +1]) . ){.
e6a0: 20 20 20 20 20 20 20 69 6e 74 20 6f 63 74 65 74 int octet
e6b0: 20 3d 20 28 73 71 6c 69 74 65 33 48 65 78 54 6f = (sqlite3HexTo
e6c0: 49 6e 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d 29 Int(zUri[iIn++])
e6d0: 20 3c 3c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 << 4);.
e6e0: 6f 63 74 65 74 20 2b 3d 20 73 71 6c 69 74 65 33 octet += sqlite3
e6f0: 48 65 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 49 HexToInt(zUri[iI
e700: 6e 2b 2b 5d 29 3b 0a 0a 20 20 20 20 20 20 20 20 n++]);..
e710: 61 73 73 65 72 74 28 20 6f 63 74 65 74 3e 3d 30 assert( octet>=0
e720: 20 26 26 20 6f 63 74 65 74 3c 32 35 36 20 29 3b && octet<256 );
e730: 0a 20 20 20 20 20 20 20 20 69 66 28 20 6f 63 74 . if( oct
e740: 65 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 et==0 ){.
e750: 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 /* This branc
e760: 68 20 69 73 20 74 61 6b 65 6e 20 77 68 65 6e 20 h is taken when
e770: 22 25 30 30 22 20 61 70 70 65 61 72 73 20 77 69 "%00" appears wi
e780: 74 68 69 6e 20 74 68 65 20 55 52 49 2e 20 49 6e thin the URI. In
e790: 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 this.
e7a0: 2a 2a 20 63 61 73 65 20 77 65 20 69 67 6e 6f 72 ** case we ignor
e7b0: 65 20 61 6c 6c 20 74 65 78 74 20 69 6e 20 74 68 e all text in th
e7c0: 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 e remainder of t
e7d0: 68 65 20 70 61 74 68 2c 20 6e 61 6d 65 20 6f 72 he path, name or
e7e0: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 76 61 . ** va
e7f0: 6c 75 65 20 63 75 72 72 65 6e 74 6c 79 20 62 65 lue currently be
e800: 69 6e 67 20 70 61 72 73 65 64 2e 20 53 6f 20 69 ing parsed. So i
e810: 67 6e 6f 72 65 20 74 68 65 20 63 75 72 72 65 6e gnore the curren
e820: 74 20 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 t character.
e830: 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 73 6b 69 ** and ski
e840: 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 22 3f p to the next "?
e850: 22 2c 20 22 3d 22 20 6f 72 20 22 26 22 2c 20 61 ", "=" or "&", a
e860: 73 20 61 70 70 72 6f 70 72 69 61 74 65 2e 20 2a s appropriate. *
e870: 2f 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c /. whil
e880: 65 28 20 28 63 20 3d 20 7a 55 72 69 5b 69 49 6e e( (c = zUri[iIn
e890: 5d 29 21 3d 30 20 26 26 20 63 21 3d 27 23 27 20 ])!=0 && c!='#'
e8a0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26 . &
e8b0: 26 20 28 65 53 74 61 74 65 21 3d 30 20 7c 7c 20 & (eState!=0 ||
e8c0: 63 21 3d 27 3f 27 29 0a 20 20 20 20 20 20 20 20 c!='?').
e8d0: 20 20 20 20 20 20 26 26 20 28 65 53 74 61 74 65 && (eState
e8e0: 21 3d 31 20 7c 7c 20 28 63 21 3d 27 3d 27 20 26 !=1 || (c!='=' &
e8f0: 26 20 63 21 3d 27 26 27 29 29 0a 20 20 20 20 20 & c!='&')).
e900: 20 20 20 20 20 20 20 20 20 26 26 20 28 65 53 74 && (eSt
e910: 61 74 65 21 3d 32 20 7c 7c 20 63 21 3d 27 26 27 ate!=2 || c!='&'
e920: 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20 ). ){.
e930: 20 20 20 20 20 20 20 20 20 20 20 69 49 6e 2b 2b iIn++
e940: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
e950: 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 continue
e960: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
e970: 20 20 20 20 63 20 3d 20 6f 63 74 65 74 3b 0a 20 c = octet;.
e980: 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 65 }else if( e
e990: 53 74 61 74 65 3d 3d 31 20 26 26 20 28 63 3d 3d State==1 && (c==
e9a0: 27 26 27 20 7c 7c 20 63 3d 3d 27 3d 27 29 20 29 '&' || c=='=') )
e9b0: 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a 46 {. if( zF
e9c0: 69 6c 65 5b 69 4f 75 74 2d 31 5d 3d 3d 30 20 29 ile[iOut-1]==0 )
e9d0: 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 {. /* A
e9e0: 6e 20 65 6d 70 74 79 20 6f 70 74 69 6f 6e 20 6e n empty option n
e9f0: 61 6d 65 2e 20 49 67 6e 6f 72 65 20 74 68 69 73 ame. Ignore this
ea00: 20 6f 70 74 69 6f 6e 20 61 6c 74 6f 67 65 74 68 option altogeth
ea10: 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 er. */.
ea20: 20 77 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 6e while( zUri[iIn
ea30: 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 3d ] && zUri[iIn]!=
ea40: 27 23 27 20 26 26 20 7a 55 72 69 5b 69 49 6e 2d '#' && zUri[iIn-
ea50: 31 5d 21 3d 27 26 27 20 29 20 69 49 6e 2b 2b 3b 1]!='&' ) iIn++;
ea60: 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 . conti
ea70: 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 nue;. }.
ea80: 20 20 20 20 20 20 20 69 66 28 20 63 3d 3d 27 26 if( c=='&
ea90: 27 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 7a ' ){. z
eaa0: 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 File[iOut++] = '
eab0: 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c \0';. }el
eac0: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 65 53 se{. eS
ead0: 74 61 74 65 20 3d 20 32 3b 0a 20 20 20 20 20 20 tate = 2;.
eae0: 20 20 7d 0a 20 20 20 20 20 20 20 20 63 20 3d 20 }. c =
eaf0: 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 0;. }else i
eb00: 66 28 20 28 65 53 74 61 74 65 3d 3d 30 20 26 26 f( (eState==0 &&
eb10: 20 63 3d 3d 27 3f 27 29 20 7c 7c 20 28 65 53 74 c=='?') || (eSt
eb20: 61 74 65 3d 3d 32 20 26 26 20 63 3d 3d 27 26 27 ate==2 && c=='&'
eb30: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63 20 3d ) ){. c =
eb40: 20 30 3b 0a 20 20 20 20 20 20 20 20 65 53 74 61 0;. eSta
eb50: 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a te = 1;. }.
eb60: 20 20 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 74 zFile[iOut
eb70: 2b 2b 5d 20 3d 20 63 3b 0a 20 20 20 20 7d 0a 20 ++] = c;. }.
eb80: 20 20 20 69 66 28 20 65 53 74 61 74 65 3d 3d 31 if( eState==1
eb90: 20 29 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d ) zFile[iOut++]
eba0: 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 7a 46 69 = '\0';. zFi
ebb0: 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 le[iOut++] = '\0
ebc0: 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 ';. zFile[iOu
ebd0: 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 0a 20 20 t++] = '\0';..
ebe0: 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 74 68 /* Check if th
ebf0: 65 72 65 20 77 65 72 65 20 61 6e 79 20 6f 70 74 ere were any opt
ec00: 69 6f 6e 73 20 73 70 65 63 69 66 69 65 64 20 74 ions specified t
ec10: 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 69 6e hat should be in
ec20: 74 65 72 70 72 65 74 65 64 20 0a 20 20 20 20 2a terpreted . *
ec30: 2a 20 68 65 72 65 2e 20 4f 70 74 69 6f 6e 73 20 * here. Options
ec40: 74 68 61 74 20 61 72 65 20 69 6e 74 65 72 70 72 that are interpr
ec50: 65 74 65 64 20 68 65 72 65 20 69 6e 63 6c 75 64 eted here includ
ec60: 65 20 22 76 66 73 22 20 61 6e 64 20 74 68 6f 73 e "vfs" and thos
ec70: 65 20 74 68 61 74 0a 20 20 20 20 2a 2a 20 63 6f e that. ** co
ec80: 72 72 65 73 70 6f 6e 64 20 74 6f 20 66 6c 61 67 rrespond to flag
ec90: 73 20 74 68 61 74 20 6d 61 79 20 62 65 20 70 61 s that may be pa
eca0: 73 73 65 64 20 74 6f 20 74 68 65 20 73 71 6c 69 ssed to the sqli
ecb0: 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 0a 20 20 te3_open_v2().
ecc0: 20 20 2a 2a 20 6d 65 74 68 6f 64 2e 20 2a 2f 0a ** method. */.
ecd0: 20 20 20 20 7a 4f 70 74 20 3d 20 26 7a 46 69 6c zOpt = &zFil
ece0: 65 5b 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 e[sqlite3Strlen3
ecf0: 30 28 7a 46 69 6c 65 29 2b 31 5d 3b 0a 20 20 20 0(zFile)+1];.
ed00: 20 77 68 69 6c 65 28 20 7a 4f 70 74 5b 30 5d 20 while( zOpt[0]
ed10: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f 70 ){. int nOp
ed20: 74 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 t = sqlite3Strle
ed30: 6e 33 30 28 7a 4f 70 74 29 3b 0a 20 20 20 20 20 n30(zOpt);.
ed40: 20 63 68 61 72 20 2a 7a 56 61 6c 20 3d 20 26 7a char *zVal = &z
ed50: 4f 70 74 5b 6e 4f 70 74 2b 31 5d 3b 0a 20 20 20 Opt[nOpt+1];.
ed60: 20 20 20 69 6e 74 20 6e 56 61 6c 20 3d 20 73 71 int nVal = sq
ed70: 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 56 lite3Strlen30(zV
ed80: 61 6c 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 al);.. if(
ed90: 6e 4f 70 74 3d 3d 33 20 26 26 20 6d 65 6d 63 6d nOpt==3 && memcm
eda0: 70 28 22 76 66 73 22 2c 20 7a 4f 70 74 2c 20 33 p("vfs", zOpt, 3
edb0: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 )==0 ){.
edc0: 7a 56 66 73 20 3d 20 7a 56 61 6c 3b 0a 20 20 20 zVfs = zVal;.
edd0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
ede0: 20 20 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f 64 struct OpenMod
edf0: 65 20 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f e {. co
ee00: 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 20 nst char *z;.
ee10: 20 20 20 20 20 20 20 69 6e 74 20 6d 6f 64 65 3b int mode;
ee20: 0a 20 20 20 20 20 20 20 20 7d 20 2a 61 4d 6f 64 . } *aMod
ee30: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 63 e = 0;. c
ee40: 68 61 72 20 2a 7a 4d 6f 64 65 54 79 70 65 20 3d har *zModeType =
ee50: 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 0;. int
ee60: 6d 61 73 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 mask = 0;.
ee70: 20 20 69 6e 74 20 6c 69 6d 69 74 20 3d 20 30 3b int limit = 0;
ee80: 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 4f .. if( nO
ee90: 70 74 3d 3d 35 20 26 26 20 6d 65 6d 63 6d 70 28 pt==5 && memcmp(
eea0: 22 63 61 63 68 65 22 2c 20 7a 4f 70 74 2c 20 35 "cache", zOpt, 5
eeb0: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 )==0 ){.
eec0: 20 20 73 74 61 74 69 63 20 73 74 72 75 63 74 20 static struct
eed0: 4f 70 65 6e 4d 6f 64 65 20 61 43 61 63 68 65 4d OpenMode aCacheM
eee0: 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 ode[] = {.
eef0: 20 20 20 20 20 20 7b 20 22 73 68 61 72 65 64 22 { "shared"
ef00: 2c 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 , SQLITE_OPEN_S
ef10: 48 41 52 45 44 43 41 43 48 45 20 7d 2c 0a 20 20 HAREDCACHE },.
ef20: 20 20 20 20 20 20 20 20 20 20 7b 20 22 70 72 69 { "pri
ef30: 76 61 74 65 22 2c 20 53 51 4c 49 54 45 5f 4f 50 vate", SQLITE_OP
ef40: 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 EN_PRIVATECACHE
ef50: 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b },. {
ef60: 20 30 2c 20 30 20 7d 0a 20 20 20 20 20 20 20 20 0, 0 }.
ef70: 20 20 7d 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 };..
ef80: 6d 61 73 6b 20 3d 20 53 51 4c 49 54 45 5f 4f 50 mask = SQLITE_OP
ef90: 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 7c 53 EN_SHAREDCACHE|S
efa0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 QLITE_OPEN_PRIVA
efb0: 54 45 43 41 43 48 45 3b 0a 20 20 20 20 20 20 20 TECACHE;.
efc0: 20 20 20 61 4d 6f 64 65 20 3d 20 61 43 61 63 68 aMode = aCach
efd0: 65 4d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 20 eMode;.
efe0: 20 6c 69 6d 69 74 20 3d 20 6d 61 73 6b 3b 0a 20 limit = mask;.
eff0: 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 zModeTy
f000: 70 65 20 3d 20 22 63 61 63 68 65 22 3b 0a 20 20 pe = "cache";.
f010: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
f020: 69 66 28 20 6e 4f 70 74 3d 3d 34 20 26 26 20 6d if( nOpt==4 && m
f030: 65 6d 63 6d 70 28 22 6d 6f 64 65 22 2c 20 7a 4f emcmp("mode", zO
f040: 70 74 2c 20 34 29 3d 3d 30 20 29 7b 0a 20 20 20 pt, 4)==0 ){.
f050: 20 20 20 20 20 20 20 73 74 61 74 69 63 20 73 74 static st
f060: 72 75 63 74 20 4f 70 65 6e 4d 6f 64 65 20 61 4f ruct OpenMode aO
f070: 70 65 6e 4d 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 penMode[] = {.
f080: 20 20 20 20 20 20 20 20 20 20 7b 20 22 72 6f 22 { "ro"
f090: 2c 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 , SQLITE_OPEN_R
f0a0: 45 41 44 4f 4e 4c 59 20 7d 2c 0a 20 20 20 20 20 EADONLY },.
f0b0: 20 20 20 20 20 20 20 7b 20 22 72 77 22 2c 20 20 { "rw",
f0c0: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
f0d0: 57 52 49 54 45 20 7d 2c 20 0a 20 20 20 20 20 20 WRITE }, .
f0e0: 20 20 20 20 20 20 7b 20 22 72 77 63 22 2c 20 53 { "rwc", S
f0f0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
f100: 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 RITE | SQLITE_OP
f110: 45 4e 5f 43 52 45 41 54 45 20 7d 2c 0a 20 20 20 EN_CREATE },.
f120: 20 20 20 20 20 20 20 20 20 7b 20 30 2c 20 30 20 { 0, 0
f130: 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 3b 0a 0a }. };..
f140: 20 20 20 20 20 20 20 20 20 20 6d 61 73 6b 20 3d mask =
f150: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
f160: 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45 DONLY|SQLITE_OPE
f170: 4e 5f 52 45 41 44 57 52 49 54 45 7c 53 51 4c 49 N_READWRITE|SQLI
f180: 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 3b 0a TE_OPEN_CREATE;.
f190: 20 20 20 20 20 20 20 20 20 20 61 4d 6f 64 65 20 aMode
f1a0: 3d 20 61 4f 70 65 6e 4d 6f 64 65 3b 0a 20 20 20 = aOpenMode;.
f1b0: 20 20 20 20 20 20 20 6c 69 6d 69 74 20 3d 20 6d limit = m
f1c0: 61 73 6b 20 26 20 66 6c 61 67 73 3b 0a 20 20 20 ask & flags;.
f1d0: 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 zModeType
f1e0: 20 3d 20 22 61 63 63 65 73 73 22 3b 0a 20 20 20 = "access";.
f1f0: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 }..
f200: 69 66 28 20 61 4d 6f 64 65 20 29 7b 0a 20 20 20 if( aMode ){.
f210: 20 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 int i;.
f220: 20 20 20 20 20 20 20 20 69 6e 74 20 6d 6f 64 65 int mode
f230: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
f240: 66 6f 72 28 69 3d 30 3b 20 61 4d 6f 64 65 5b 69 for(i=0; aMode[i
f250: 5d 2e 7a 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 ].z; i++){.
f260: 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 const cha
f270: 72 20 2a 7a 20 3d 20 61 4d 6f 64 65 5b 69 5d 2e r *z = aMode[i].
f280: 7a 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 z;. i
f290: 66 28 20 6e 56 61 6c 3d 3d 73 71 6c 69 74 65 33 f( nVal==sqlite3
f2a0: 53 74 72 6c 65 6e 33 30 28 7a 29 20 26 26 20 30 Strlen30(z) && 0
f2b0: 3d 3d 6d 65 6d 63 6d 70 28 7a 56 61 6c 2c 20 7a ==memcmp(zVal, z
f2c0: 2c 20 6e 56 61 6c 29 20 29 7b 0a 20 20 20 20 20 , nVal) ){.
f2d0: 20 20 20 20 20 20 20 20 20 6d 6f 64 65 20 3d 20 mode =
f2e0: 61 4d 6f 64 65 5b 69 5d 2e 6d 6f 64 65 3b 0a 20 aMode[i].mode;.
f2f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
f300: 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ak;.
f310: 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
f320: 20 20 20 20 20 20 20 20 69 66 28 20 6d 6f 64 65 if( mode
f330: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
f340: 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
f350: 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
f360: 6e 6f 20 73 75 63 68 20 25 73 20 6d 6f 64 65 3a no such %s mode:
f370: 20 25 73 22 2c 20 7a 4d 6f 64 65 54 79 70 65 2c %s", zModeType,
f380: 20 7a 56 61 6c 29 3b 0a 20 20 20 20 20 20 20 20 zVal);.
f390: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
f3a0: 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 ERROR;.
f3b0: 20 20 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 goto parse_ur
f3c0: 69 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 20 i_out;.
f3d0: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 }. if(
f3e0: 20 6d 6f 64 65 3e 6c 69 6d 69 74 20 29 7b 0a 20 mode>limit ){.
f3f0: 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 *pzEr
f400: 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d rMsg = sqlite3_m
f410: 70 72 69 6e 74 66 28 22 25 73 20 6d 6f 64 65 20 printf("%s mode
f420: 6e 6f 74 20 61 6c 6c 6f 77 65 64 3a 20 25 73 22 not allowed: %s"
f430: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
f440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f450: 20 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 zModeT
f460: 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20 ype, zVal);.
f470: 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
f480: 49 54 45 5f 50 45 52 4d 3b 0a 20 20 20 20 20 20 ITE_PERM;.
f490: 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 65 goto parse
f4a0: 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 20 _uri_out;.
f4b0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
f4c0: 66 6c 61 67 73 20 3d 20 28 66 6c 61 67 73 20 26 flags = (flags &
f4d0: 20 7e 6d 61 73 6b 29 20 7c 20 6d 6f 64 65 3b 0a ~mask) | mode;.
f4e0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
f4f0: 7d 0a 0a 20 20 20 20 20 20 7a 4f 70 74 20 3d 20 }.. zOpt =
f500: 26 7a 56 61 6c 5b 6e 56 61 6c 2b 31 5d 3b 0a 20 &zVal[nVal+1];.
f510: 20 20 20 7d 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 }.. }else{.
f520: 20 20 20 7a 46 69 6c 65 20 3d 20 73 71 6c 69 74 zFile = sqlit
f530: 65 33 5f 6d 61 6c 6c 6f 63 28 6e 55 72 69 2b 32 e3_malloc(nUri+2
f540: 29 3b 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c );. if( !zFil
f550: 65 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 e ) return SQLIT
f560: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 6d 65 6d E_NOMEM;. mem
f570: 63 70 79 28 7a 46 69 6c 65 2c 20 7a 55 72 69 2c cpy(zFile, zUri,
f580: 20 6e 55 72 69 29 3b 0a 20 20 20 20 7a 46 69 6c nUri);. zFil
f590: 65 5b 6e 55 72 69 5d 20 3d 20 27 5c 30 27 3b 0a e[nUri] = '\0';.
f5a0: 20 20 20 20 7a 46 69 6c 65 5b 6e 55 72 69 2b 31 zFile[nUri+1
f5b0: 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 7d 0a 0a 20 ] = '\0';. }..
f5c0: 20 2a 70 70 56 66 73 20 3d 20 73 71 6c 69 74 65 *ppVfs = sqlite
f5d0: 33 5f 76 66 73 5f 66 69 6e 64 28 7a 56 66 73 29 3_vfs_find(zVfs)
f5e0: 3b 0a 20 20 69 66 28 20 2a 70 70 56 66 73 3d 3d ;. if( *ppVfs==
f5f0: 30 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 72 4d 0 ){. *pzErrM
f600: 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 sg = sqlite3_mpr
f610: 69 6e 74 66 28 22 6e 6f 20 73 75 63 68 20 76 66 intf("no such vf
f620: 73 3a 20 25 73 22 2c 20 7a 56 66 73 29 3b 0a 20 s: %s", zVfs);.
f630: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 rc = SQLITE_E
f640: 52 52 4f 52 3b 0a 20 20 7d 0a 20 70 61 72 73 65 RROR;. }. parse
f650: 5f 75 72 69 5f 6f 75 74 3a 0a 20 20 69 66 28 20 _uri_out:. if(
f660: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
f670: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
f680: 65 28 7a 46 69 6c 65 29 3b 0a 20 20 20 20 7a 46 e(zFile);. zF
f690: 69 6c 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a ile = 0;. }. *
f6a0: 70 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a pFlags = flags;.
f6b0: 20 20 2a 70 7a 46 69 6c 65 20 3d 20 7a 46 69 6c *pzFile = zFil
f6c0: 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a e;. return rc;.
f6d0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 }.../*.** This r
f6e0: 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 outine does the
f6f0: 77 6f 72 6b 20 6f 66 20 6f 70 65 6e 69 6e 67 20 work of opening
f700: 61 20 64 61 74 61 62 61 73 65 20 6f 6e 20 62 65 a database on be
f710: 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 half of.** sqlit
f720: 65 33 5f 6f 70 65 6e 28 29 20 61 6e 64 20 73 71 e3_open() and sq
f730: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 2e 20 lite3_open16().
f740: 54 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c The database fil
f750: 65 6e 61 6d 65 20 22 7a 46 69 6c 65 6e 61 6d 65 ename "zFilename
f760: 22 20 20 0a 2a 2a 20 69 73 20 55 54 46 2d 38 20 " .** is UTF-8
f770: 65 6e 63 6f 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 encoded..*/.stat
f780: 69 63 20 69 6e 74 20 6f 70 65 6e 44 61 74 61 62 ic int openDatab
f790: 61 73 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 ase(. const cha
f7a0: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a r *zFilename, /*
f7b0: 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 Database filena
f7c0: 6d 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 me UTF-8 encoded
f7d0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a */. sqlite3 **
f7e0: 70 70 44 62 2c 20 20 20 20 20 20 20 20 2f 2a 20 ppDb, /*
f7f0: 4f 55 54 3a 20 52 65 74 75 72 6e 65 64 20 64 61 OUT: Returned da
f800: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f tabase handle */
f810: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
f820: 66 6c 61 67 73 2c 20 20 20 20 2f 2a 20 4f 70 65 flags, /* Ope
f830: 72 61 74 69 6f 6e 61 6c 20 66 6c 61 67 73 20 2a rational flags *
f840: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
f850: 7a 56 66 73 20 20 20 20 20 20 20 2f 2a 20 4e 61 zVfs /* Na
f860: 6d 65 20 6f 66 20 74 68 65 20 56 46 53 20 74 6f me of the VFS to
f870: 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c use */.){. sql
f880: 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 ite3 *db;
f890: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
f8a0: 53 74 6f 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 Store allocated
f8b0: 68 61 6e 64 6c 65 20 68 65 72 65 20 2a 2f 0a 20 handle here */.
f8c0: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
f8d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f8e0: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 /* Return code
f8f0: 2a 2f 0a 20 20 69 6e 74 20 69 73 54 68 72 65 61 */. int isThrea
f900: 64 73 61 66 65 3b 20 20 20 20 20 20 20 20 20 20 dsafe;
f910: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 /* True for
f920: 20 74 68 72 65 61 64 73 61 66 65 20 63 6f 6e 6e threadsafe conn
f930: 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 63 68 61 ections */. cha
f940: 72 20 2a 7a 4f 70 65 6e 20 3d 20 30 3b 20 20 20 r *zOpen = 0;
f950: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
f960: 46 69 6c 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e Filename argumen
f970: 74 20 74 6f 20 70 61 73 73 20 74 6f 20 42 74 72 t to pass to Btr
f980: 65 65 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 63 68 eeOpen() */. ch
f990: 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b ar *zErrMsg = 0;
f9a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
f9b0: 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 Error message f
f9c0: 72 6f 6d 20 73 71 6c 69 74 65 33 50 61 72 73 65 rom sqlite3Parse
f9d0: 55 72 69 28 29 20 2a 2f 0a 0a 20 20 2a 70 70 44 Uri() */.. *ppD
f9e0: 62 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 b = 0;.#ifndef S
f9f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 QLITE_OMIT_AUTOI
fa00: 4e 49 54 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 NIT. rc = sqlit
fa10: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b e3_initialize();
fa20: 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 . if( rc ) retu
fa30: 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 0a 0a 20 rn rc;.#endif..
fa40: 20 2f 2a 20 4f 6e 6c 79 20 61 6c 6c 6f 77 20 73 /* Only allow s
fa50: 65 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 ensible combinat
fa60: 69 6f 6e 73 20 6f 66 20 62 69 74 73 20 69 6e 20 ions of bits in
fa70: 74 68 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 the flags argume
fa80: 6e 74 2e 20 20 0a 20 20 2a 2a 20 54 68 72 6f 77 nt. . ** Throw
fa90: 20 61 6e 20 65 72 72 6f 72 20 69 66 20 61 6e 79 an error if any
faa0: 20 6e 6f 6e 2d 73 65 6e 73 65 20 63 6f 6d 62 69 non-sense combi
fab0: 6e 61 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 20 nation is used.
fac0: 20 49 66 20 77 65 0a 20 20 2a 2a 20 64 6f 20 6e If we. ** do n
fad0: 6f 74 20 62 6c 6f 63 6b 20 69 6c 6c 65 67 61 6c ot block illegal
fae0: 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 68 65 combinations he
faf0: 72 65 2c 20 69 74 20 63 6f 75 6c 64 20 74 72 69 re, it could tri
fb00: 67 67 65 72 0a 20 20 2a 2a 20 61 73 73 65 72 74 gger. ** assert
fb10: 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e () statements in
fb20: 20 64 65 65 70 65 72 20 6c 61 79 65 72 73 2e 20 deeper layers.
fb30: 20 53 65 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e Sensible combin
fb40: 61 74 69 6f 6e 73 0a 20 20 2a 2a 20 61 72 65 3a ations. ** are:
fb50: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 31 3a 20 20 . **. ** 1:
fb60: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
fb70: 4f 4e 4c 59 0a 20 20 2a 2a 20 20 32 3a 20 20 53 ONLY. ** 2: S
fb80: 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
fb90: 52 49 54 45 0a 20 20 2a 2a 20 20 36 3a 20 20 53 RITE. ** 6: S
fba0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
fbb0: 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 RITE | SQLITE_OP
fbc0: 45 4e 5f 43 52 45 41 54 45 0a 20 20 2a 2f 0a 20 EN_CREATE. */.
fbd0: 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f assert( SQLITE_
fbe0: 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 20 3d OPEN_READONLY =
fbf0: 3d 20 30 78 30 31 20 29 3b 0a 20 20 61 73 73 65 = 0x01 );. asse
fc00: 72 74 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f rt( SQLITE_OPEN_
fc10: 52 45 41 44 57 52 49 54 45 20 3d 3d 20 30 78 30 READWRITE == 0x0
fc20: 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 2 );. assert( S
fc30: 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 QLITE_OPEN_CREAT
fc40: 45 20 20 20 20 3d 3d 20 30 78 30 34 20 29 3b 0a E == 0x04 );.
fc50: 20 20 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c testcase( (1<<
fc60: 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 32 (flags&7))==0x02
fc70: 20 29 3b 20 2f 2a 20 52 45 41 44 4f 4e 4c 59 20 ); /* READONLY
fc80: 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 28 */. testcase( (
fc90: 31 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 1<<(flags&7))==0
fca0: 78 30 34 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 x04 ); /* READWR
fcb0: 49 54 45 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 ITE */. testcas
fcc0: 65 28 20 28 31 3c 3c 28 66 6c 61 67 73 26 37 29 e( (1<<(flags&7)
fcd0: 29 3d 3d 30 78 34 30 20 29 3b 20 2f 2a 20 52 45 )==0x40 ); /* RE
fce0: 41 44 57 52 49 54 45 20 7c 20 43 52 45 41 54 45 ADWRITE | CREATE
fcf0: 20 2a 2f 0a 20 20 69 66 28 20 28 28 31 3c 3c 28 */. if( ((1<<(
fd00: 66 6c 61 67 73 26 37 29 29 20 26 20 30 78 34 36 flags&7)) & 0x46
fd10: 29 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 )==0 ) return SQ
fd20: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
fd30: 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 ;.. if( sqlite3
fd40: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f GlobalConfig.bCo
fd50: 72 65 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 reMutex==0 ){.
fd60: 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d isThreadsafe =
fd70: 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 0;. }else if(
fd80: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f flags & SQLITE_O
fd90: 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 29 7b 0a 20 PEN_NOMUTEX ){.
fda0: 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 isThreadsafe
fdb0: 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 = 0;. }else if(
fdc0: 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f flags & SQLITE_
fdd0: 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 29 OPEN_FULLMUTEX )
fde0: 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 {. isThreadsa
fdf0: 66 65 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b fe = 1;. }else{
fe00: 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 . isThreadsaf
fe10: 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 e = sqlite3Globa
fe20: 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 lConfig.bFullMut
fe30: 65 78 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c ex;. }. if( fl
fe40: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
fe50: 4e 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 29 N_PRIVATECACHE )
fe60: 7b 0a 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e {. flags &= ~
fe70: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 SQLITE_OPEN_SHAR
fe80: 45 44 43 41 43 48 45 3b 0a 20 20 7d 65 6c 73 65 EDCACHE;. }else
fe90: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
fea0: 61 6c 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 43 alConfig.sharedC
feb0: 61 63 68 65 45 6e 61 62 6c 65 64 20 29 7b 0a 20 acheEnabled ){.
fec0: 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 flags |= SQLI
fed0: 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 TE_OPEN_SHAREDCA
fee0: 43 48 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 CHE;. }.. /* R
fef0: 65 6d 6f 76 65 20 68 61 72 6d 66 75 6c 20 62 69 emove harmful bi
ff00: 74 73 20 66 72 6f 6d 20 74 68 65 20 66 6c 61 67 ts from the flag
ff10: 73 20 70 61 72 61 6d 65 74 65 72 0a 20 20 2a 2a s parameter. **
ff20: 0a 20 20 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 . ** The SQLITE
ff30: 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 61 6e _OPEN_NOMUTEX an
ff40: 64 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 d SQLITE_OPEN_FU
ff50: 4c 4c 4d 55 54 45 58 20 66 6c 61 67 73 20 77 65 LLMUTEX flags we
ff60: 72 65 0a 20 20 2a 2a 20 64 65 61 6c 74 20 77 69 re. ** dealt wi
ff70: 74 68 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f th in the previo
ff80: 75 73 20 63 6f 64 65 20 62 6c 6f 63 6b 2e 20 20 us code block.
ff90: 42 65 73 69 64 65 73 20 74 68 65 73 65 2c 20 74 Besides these, t
ffa0: 68 65 20 6f 6e 6c 79 0a 20 20 2a 2a 20 76 61 6c he only. ** val
ffb0: 69 64 20 69 6e 70 75 74 20 66 6c 61 67 73 20 66 id input flags f
ffc0: 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f or sqlite3_open_
ffd0: 76 32 28 29 20 61 72 65 20 53 51 4c 49 54 45 5f v2() are SQLITE_
ffe0: 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 0a 20 OPEN_READONLY,.
fff0: 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ** SQLITE_OPEN_
10000 52 45 41 44 57 52 49 54 45 2c 20 53 51 4c 49 54 READWRITE, SQLIT
10010 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 53 E_OPEN_CREATE, S
10020 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 QLITE_OPEN_SHARE
10030 44 43 41 43 48 45 2c 0a 20 20 2a 2a 20 53 51 4c DCACHE,. ** SQL
10040 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 ITE_OPEN_PRIVATE
10050 43 41 43 48 45 2c 20 61 6e 64 20 73 6f 6d 65 20 CACHE, and some
10060 72 65 73 65 72 76 65 64 20 62 69 74 73 2e 20 20 reserved bits.
10070 53 69 6c 65 6e 74 6c 79 20 6d 61 73 6b 0a 20 20 Silently mask.
10080 2a 2a 20 6f 66 66 20 61 6c 6c 20 6f 74 68 65 72 ** off all other
10090 20 66 6c 61 67 73 2e 0a 20 20 2a 2f 0a 20 20 66 flags.. */. f
100a0 6c 61 67 73 20 26 3d 20 20 7e 28 20 53 51 4c 49 lags &= ~( SQLI
100b0 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e TE_OPEN_DELETEON
100c0 43 4c 4f 53 45 20 7c 0a 20 20 20 20 20 20 20 20 CLOSE |.
100d0 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
100e0 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 0a 20 EN_EXCLUSIVE |.
100f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
10100 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 LITE_OPEN_MAIN_D
10110 42 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 B |.
10120 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 SQLITE_OPEN_T
10130 45 4d 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 20 EMP_DB | .
10140 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
10150 4f 50 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 OPEN_TRANSIENT_D
10160 42 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 B | .
10170 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
10180 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a MAIN_JOURNAL | .
10190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
101a0 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f QLITE_OPEN_TEMP_
101b0 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 JOURNAL | .
101c0 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
101d0 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c _OPEN_SUBJOURNAL
101e0 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 | .
101f0 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d SQLITE_OPEN_M
10200 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a ASTER_JOURNAL |.
10210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
10220 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 QLITE_OPEN_NOMUT
10230 45 58 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 EX |.
10240 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
10250 46 55 4c 4c 4d 55 54 45 58 20 7c 0a 20 20 20 20 FULLMUTEX |.
10260 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
10270 45 5f 4f 50 45 4e 5f 57 41 4c 0a 20 20 20 20 20 E_OPEN_WAL.
10280 20 20 20 20 20 20 20 20 29 3b 0a 0a 20 20 2f 2a );.. /*
10290 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 Allocate the sq
102a0 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 lite data struct
102b0 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 ure */. db = sq
102c0 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 lite3MallocZero(
102d0 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 sizeof(sqlite3)
102e0 20 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 );. if( db==0
102f0 29 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 ) goto opendb_ou
10300 74 3b 0a 20 20 69 66 28 20 69 73 54 68 72 65 61 t;. if( isThrea
10310 64 73 61 66 65 20 29 7b 0a 20 20 20 20 64 62 2d dsafe ){. db-
10320 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 >mutex = sqlite3
10330 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
10340 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 E_MUTEX_RECURSIV
10350 45 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e E);. if( db->
10360 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 mutex==0 ){.
10370 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 sqlite3_free(d
10380 62 29 3b 0a 20 20 20 20 20 20 64 62 20 3d 20 30 b);. db = 0
10390 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 ;. goto ope
103a0 6e 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 ndb_out;. }.
103b0 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
103c0 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
103d0 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 ex);. db->errMa
103e0 73 6b 20 3d 20 30 78 66 66 3b 0a 20 20 64 62 2d sk = 0xff;. db-
103f0 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e >nDb = 2;. db->
10400 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d magic = SQLITE_M
10410 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d AGIC_BUSY;. db-
10420 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 >aDb = db->aDbSt
10430 61 74 69 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 atic;.. assert(
10440 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 6d sizeof(db->aLim
10450 69 74 29 3d 3d 73 69 7a 65 6f 66 28 61 48 61 72 it)==sizeof(aHar
10460 64 4c 69 6d 69 74 29 20 29 3b 0a 20 20 6d 65 6d dLimit) );. mem
10470 63 70 79 28 64 62 2d 3e 61 4c 69 6d 69 74 2c 20 cpy(db->aLimit,
10480 61 48 61 72 64 4c 69 6d 69 74 2c 20 73 69 7a 65 aHardLimit, size
10490 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 74 29 29 3b of(db->aLimit));
104a0 0a 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 . db->autoCommi
104b0 74 20 3d 20 31 3b 0a 20 20 64 62 2d 3e 6e 65 78 t = 1;. db->nex
104c0 74 41 75 74 6f 76 61 63 20 3d 20 2d 31 3b 0a 20 tAutovac = -1;.
104d0 20 64 62 2d 3e 6e 65 78 74 50 61 67 65 73 69 7a db->nextPagesiz
104e0 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 66 6c 61 e = 0;. db->fla
104f0 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53 68 6f gs |= SQLITE_Sho
10500 72 74 43 6f 6c 4e 61 6d 65 73 20 7c 20 53 51 4c rtColNames | SQL
10510 49 54 45 5f 41 75 74 6f 49 6e 64 65 78 20 7c 20 ITE_AutoIndex |
10520 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 SQLITE_EnableTri
10530 67 67 65 72 0a 23 69 66 20 53 51 4c 49 54 45 5f gger.#if SQLITE_
10540 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 DEFAULT_FILE_FOR
10550 4d 41 54 3c 34 0a 20 20 20 20 20 20 20 20 20 20 MAT<4.
10560 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
10570 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 0a 23 65 LegacyFileFmt.#e
10580 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
10590 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 TE_ENABLE_LOAD_E
105a0 58 54 45 4e 53 49 4f 4e 0a 20 20 20 20 20 20 20 XTENSION.
105b0 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 | SQLI
105c0 54 45 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e TE_LoadExtension
105d0 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
105e0 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 52 TE_DEFAULT_RECUR
105f0 53 49 56 45 5f 54 52 49 47 47 45 52 53 0a 20 20 SIVE_TRIGGERS.
10600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
10610 20 53 51 4c 49 54 45 5f 52 65 63 54 72 69 67 67 SQLITE_RecTrigg
10620 65 72 73 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 ers.#endif.#if d
10630 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
10640 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 FAULT_FOREIGN_KE
10650 59 53 29 20 26 26 20 53 51 4c 49 54 45 5f 44 45 YS) && SQLITE_DE
10660 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 FAULT_FOREIGN_KE
10670 59 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 YS.
10680 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 46 6f 72 | SQLITE_For
10690 65 69 67 6e 4b 65 79 73 0a 23 65 6e 64 69 66 0a eignKeys.#endif.
106a0 20 20 20 20 20 20 3b 0a 20 20 73 71 6c 69 74 65 ;. sqlite
106b0 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 3HashInit(&db->a
106c0 43 6f 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 CollSeq);.#ifnde
106d0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
106e0 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 73 71 6c RTUALTABLE. sql
106f0 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 ite3HashInit(&db
10700 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 65 6e 64 ->aModule);.#end
10710 69 66 0a 0a 20 20 2f 2a 20 41 64 64 20 74 68 65 if.. /* Add the
10720 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 default collati
10730 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41 on sequence BINA
10740 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73 RY. BINARY works
10750 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a for both UTF-8.
10760 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c ** and UTF-16,
10770 20 73 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f so add a versio
10780 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76 n for each to av
10790 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73 oid any unnecess
107a0 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73 ary. ** convers
107b0 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65 ions. The only e
107c0 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63 rror that can oc
107d0 63 75 72 20 68 65 72 65 20 69 73 20 61 20 6d 61 cur here is a ma
107e0 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a lloc() failure..
107f0 20 20 2a 2f 0a 20 20 63 72 65 61 74 65 43 6f 6c */. createCol
10800 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 lation(db, "BINA
10810 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 RY", SQLITE_UTF8
10820 2c 20 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 42 49 , SQLITE_COLL_BI
10830 4e 41 52 59 2c 20 30 2c 0a 20 20 20 20 20 20 20 NARY, 0,.
10840 20 20 20 20 20 20 20 20 20 20 20 62 69 6e 43 6f binCo
10850 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 llFunc, 0);. cr
10860 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 eateCollation(db
10870 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 , "BINARY", SQLI
10880 54 45 5f 55 54 46 31 36 42 45 2c 20 53 51 4c 49 TE_UTF16BE, SQLI
10890 54 45 5f 43 4f 4c 4c 5f 42 49 4e 41 52 59 2c 20 TE_COLL_BINARY,
108a0 30 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 0,.
108b0 20 20 20 20 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 binCollFunc
108c0 2c 20 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f , 0);. createCo
108d0 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e llation(db, "BIN
108e0 41 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 ARY", SQLITE_UTF
108f0 31 36 4c 45 2c 20 53 51 4c 49 54 45 5f 43 4f 4c 16LE, SQLITE_COL
10900 4c 5f 42 49 4e 41 52 59 2c 20 30 2c 0a 20 20 20 L_BINARY, 0,.
10910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 b
10920 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a inCollFunc, 0);.
10930 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
10940 6e 28 64 62 2c 20 22 52 54 52 49 4d 22 2c 20 53 n(db, "RTRIM", S
10950 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 QLITE_UTF8, SQLI
10960 54 45 5f 43 4f 4c 4c 5f 55 53 45 52 2c 20 28 76 TE_COLL_USER, (v
10970 6f 69 64 2a 29 31 2c 0a 20 20 20 20 20 20 20 20 oid*)1,.
10980 20 20 20 20 20 20 20 20 20 20 62 69 6e 43 6f 6c binCol
10990 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 lFunc, 0);. if(
109a0 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
109b0 64 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 d ){. goto op
109c0 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 endb_out;. }.
109d0 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 db->pDfltColl =
109e0 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 sqlite3FindCollS
109f0 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 54 eq(db, SQLITE_UT
10a00 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 30 29 F8, "BINARY", 0)
10a10 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e ;. assert( db->
10a20 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 20 29 3b 0a pDfltColl!=0 );.
10a30 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 64 20 61 . /* Also add a
10a40 20 55 54 46 2d 38 20 63 61 73 65 2d 69 6e 73 65 UTF-8 case-inse
10a50 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 74 69 6f nsitive collatio
10a60 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a 2f 0a 20 n sequence. */.
10a70 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e createCollation
10a80 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c 20 53 (db, "NOCASE", S
10a90 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 QLITE_UTF8, SQLI
10aa0 54 45 5f 43 4f 4c 4c 5f 4e 4f 43 41 53 45 2c 20 TE_COLL_NOCASE,
10ab0 30 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 0,.
10ac0 20 20 20 20 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 nocaseColla
10ad0 74 69 6e 67 46 75 6e 63 2c 20 30 29 3b 0a 0a 20 tingFunc, 0);..
10ae0 20 2f 2a 20 50 61 72 73 65 20 74 68 65 20 66 69 /* Parse the fi
10af0 6c 65 6e 61 6d 65 2f 55 52 49 20 61 72 67 75 6d lename/URI argum
10b00 65 6e 74 2e 20 2a 2f 0a 20 20 64 62 2d 3e 6f 70 ent. */. db->op
10b10 65 6e 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b enFlags = flags;
10b20 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
10b30 61 72 73 65 55 72 69 28 7a 56 66 73 2c 20 7a 46 arseUri(zVfs, zF
10b40 69 6c 65 6e 61 6d 65 2c 20 26 66 6c 61 67 73 2c ilename, &flags,
10b50 20 26 64 62 2d 3e 70 56 66 73 2c 20 26 7a 4f 70 &db->pVfs, &zOp
10b60 65 6e 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 en, &zErrMsg);.
10b70 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
10b80 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 OK ){. if( rc
10b90 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 ==SQLITE_NOMEM )
10ba0 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
10bb0 64 20 3d 20 31 3b 0a 20 20 20 20 73 71 6c 69 74 d = 1;. sqlit
10bc0 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 e3Error(db, rc,
10bd0 7a 45 72 72 4d 73 67 20 3f 20 22 25 73 22 20 3a zErrMsg ? "%s" :
10be0 20 30 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 0, zErrMsg);.
10bf0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a sqlite3_free(z
10c00 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 67 6f 74 ErrMsg);. got
10c10 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
10c20 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 }.. /* Open the
10c30 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 backend databas
10c40 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 e driver */. rc
10c50 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f = sqlite3BtreeO
10c60 70 65 6e 28 64 62 2d 3e 70 56 66 73 2c 20 7a 4f pen(db->pVfs, zO
10c70 70 65 6e 2c 20 64 62 2c 20 26 64 62 2d 3e 61 44 pen, db, &db->aD
10c80 62 5b 30 5d 2e 70 42 74 2c 20 30 2c 0a 20 20 20 b[0].pBt, 0,.
10c90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ca0 20 20 20 20 20 66 6c 61 67 73 20 7c 20 53 51 4c flags | SQL
10cb0 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 ITE_OPEN_MAIN_DB
10cc0 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
10cd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 ITE_OK ){. if
10ce0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 ( rc==SQLITE_IOE
10cf0 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 RR_NOMEM ){.
10d00 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
10d10 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 MEM;. }. s
10d20 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
10d30 72 63 2c 20 30 29 3b 0a 20 20 20 20 67 6f 74 6f rc, 0);. goto
10d40 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d opendb_out;. }
10d50 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 . db->aDb[0].pS
10d60 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 chema = sqlite3S
10d70 63 68 65 6d 61 47 65 74 28 64 62 2c 20 64 62 2d chemaGet(db, db-
10d80 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 >aDb[0].pBt);.
10d90 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 db->aDb[1].pSche
10da0 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 ma = sqlite3Sche
10db0 6d 61 47 65 74 28 64 62 2c 20 30 29 3b 0a 0a 0a maGet(db, 0);...
10dc0 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74 /* The default
10dd0 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 66 6f safety_level fo
10de0 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 r the main datab
10df0 61 73 65 20 69 73 20 27 66 75 6c 6c 27 3b 20 66 ase is 'full'; f
10e00 6f 72 20 74 68 65 20 74 65 6d 70 0a 20 20 2a 2a or the temp. **
10e10 20 64 61 74 61 62 61 73 65 20 69 74 20 69 73 20 database it is
10e20 27 4e 4f 4e 45 27 2e 20 54 68 69 73 20 6d 61 74 'NONE'. This mat
10e30 63 68 65 73 20 74 68 65 20 70 61 67 65 72 20 6c ches the pager l
10e40 61 79 65 72 20 64 65 66 61 75 6c 74 73 2e 20 20 ayer defaults.
10e50 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e 61 44 62 5b . */. db->aDb[
10e60 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 0].zName = "main
10e70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e ";. db->aDb[0].
10e80 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 33 safety_level = 3
10e90 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a ;. db->aDb[1].z
10ea0 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 20 Name = "temp";.
10eb0 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66 65 db->aDb[1].safe
10ec0 74 79 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a 0a 20 ty_level = 1;..
10ed0 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
10ee0 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a ITE_MAGIC_OPEN;.
10ef0 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 if( db->malloc
10f00 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 6f Failed ){. go
10f10 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 to opendb_out;.
10f20 20 7d 0a 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 }.. /* Registe
10f30 72 20 61 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 r all built-in f
10f40 75 6e 63 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f unctions, but do
10f50 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 not attempt to
10f60 72 65 61 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 read the. ** da
10f70 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 79 65 tabase schema ye
10f80 74 2e 20 54 68 69 73 20 69 73 20 64 65 6c 61 79 t. This is delay
10f90 65 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 ed until the fir
10fa0 73 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 st time the data
10fb0 62 61 73 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 base. ** is acc
10fc0 65 73 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 essed.. */. sq
10fd0 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 lite3Error(db, S
10fe0 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 QLITE_OK, 0);.
10ff0 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 sqlite3RegisterB
11000 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 uiltinFunctions(
11010 64 62 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 61 64 20 db);.. /* Load
11020 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 automatic extens
11030 69 6f 6e 73 20 2d 20 65 78 74 65 6e 73 69 6f 6e ions - extension
11040 73 20 74 68 61 74 20 68 61 76 65 20 62 65 65 6e s that have been
11050 20 72 65 67 69 73 74 65 72 65 64 0a 20 20 2a 2a registered. **
11060 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 using the sqlit
11070 65 33 5f 61 75 74 6f 6d 61 74 69 63 5f 65 78 74 e3_automatic_ext
11080 65 6e 73 69 6f 6e 28 29 20 41 50 49 2e 0a 20 20 ension() API..
11090 2a 2f 0a 20 20 73 71 6c 69 74 65 33 41 75 74 6f */. sqlite3Auto
110a0 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 64 LoadExtensions(d
110b0 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 b);. rc = sqlit
110c0 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
110d0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
110e0 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 _OK ){. goto
110f0 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a opendb_out;. }.
11100 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
11110 4e 41 42 4c 45 5f 46 54 53 31 0a 20 20 69 66 28 NABLE_FTS1. if(
11120 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
11130 65 64 20 29 7b 0a 20 20 20 20 65 78 74 65 72 6e ed ){. extern
11140 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 31 int sqlite3Fts1
11150 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a Init(sqlite3*);.
11160 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
11170 46 74 73 31 49 6e 69 74 28 64 62 29 3b 0a 20 20 Fts1Init(db);.
11180 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 }.#endif..#ifdef
11190 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
111a0 54 53 32 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d TS2. if( !db->m
111b0 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 allocFailed && r
111c0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
111d0 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 extern int s
111e0 71 6c 69 74 65 33 46 74 73 32 49 6e 69 74 28 73 qlite3Fts2Init(s
111f0 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 63 qlite3*);. rc
11200 20 3d 20 73 71 6c 69 74 65 33 46 74 73 32 49 6e = sqlite3Fts2In
11210 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
11220 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
11230 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a 20 20 E_ENABLE_FTS3.
11240 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
11250 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
11260 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
11270 20 3d 20 73 71 6c 69 74 65 33 46 74 73 33 49 6e = sqlite3Fts3In
11280 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
11290 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
112a0 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 20 20 69 E_ENABLE_ICU. i
112b0 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
112c0 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 iled && rc==SQLI
112d0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
112e0 3d 20 73 71 6c 69 74 65 33 49 63 75 49 6e 69 74 = sqlite3IcuInit
112f0 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 (db);. }.#endif
11300 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
11310 45 4e 41 42 4c 45 5f 52 54 52 45 45 0a 20 20 69 ENABLE_RTREE. i
11320 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
11330 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 iled && rc==SQLI
11340 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 20 3d TE_OK){. rc =
11350 20 73 71 6c 69 74 65 33 52 74 72 65 65 49 6e 69 sqlite3RtreeIni
11360 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 t(db);. }.#endi
11370 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f f.. sqlite3Erro
11380 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 0a 20 r(db, rc, 0);..
11390 20 2f 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 /* -DSQLITE_DEF
113a0 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
113b0 45 3d 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 E=1 makes EXCLUS
113c0 49 56 45 20 74 68 65 20 64 65 66 61 75 6c 74 20 IVE the default
113d0 6c 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 locking. ** mod
113e0 65 2e 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 e. -DSQLITE_DEF
113f0 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
11400 45 3d 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 E=0 make NORMAL
11410 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b the default lock
11420 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 ing. ** mode.
11430 44 6f 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 Doing nothing at
11440 20 61 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 all also makes
11450 4e 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 NORMAL the defau
11460 6c 74 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 lt.. */.#ifdef
11470 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c SQLITE_DEFAULT_L
11480 4f 43 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 OCKING_MODE. db
11490 2d 3e 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d ->dfltLockMode =
114a0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
114b0 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 LOCKING_MODE;.
114c0 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 6b sqlite3PagerLock
114d0 69 6e 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 ingMode(sqlite3B
114e0 74 72 65 65 50 61 67 65 72 28 64 62 2d 3e 61 44 treePager(db->aD
114f0 62 5b 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 b[0].pBt),.
11500 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11510 20 20 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 SQLITE_DEFA
11520 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 ULT_LOCKING_MODE
11530 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 );.#endif.. /*
11540 45 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 Enable the looka
11550 73 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 side-malloc subs
11560 79 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 70 ystem */. setup
11570 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 2c Lookaside(db, 0,
11580 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
11590 6e 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 nfig.szLookaside
115a0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
115b0 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
115c0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 3GlobalConfig.nL
115d0 6f 6f 6b 61 73 69 64 65 29 3b 0a 0a 20 20 73 71 ookaside);.. sq
115e0 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 lite3_wal_autoch
115f0 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 53 51 4c eckpoint(db, SQL
11600 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f ITE_DEFAULT_WAL_
11610 41 55 54 4f 43 48 45 43 4b 50 4f 49 4e 54 29 3b AUTOCHECKPOINT);
11620 0a 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 ..opendb_out:.
11630 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 4f 70 sqlite3_free(zOp
11640 65 6e 29 3b 0a 20 20 69 66 28 20 64 62 20 29 7b en);. if( db ){
11650 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d . assert( db-
11660 3e 6d 75 74 65 78 21 3d 30 20 7c 7c 20 69 73 54 >mutex!=0 || isT
11670 68 72 65 61 64 73 61 66 65 3d 3d 30 20 7c 7c 20 hreadsafe==0 ||
11680 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
11690 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 3d 3d fig.bFullMutex==
116a0 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 0 );. sqlite3
116b0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
116c0 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 >mutex);. }. r
116d0 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 c = sqlite3_errc
116e0 6f 64 65 28 64 62 29 3b 0a 20 20 69 66 28 20 72 ode(db);. if( r
116f0 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 c==SQLITE_NOMEM
11700 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 ){. sqlite3_c
11710 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 20 64 62 lose(db);. db
11720 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 = 0;. }else if
11730 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
11740 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 ){. db->magic
11750 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f = SQLITE_MAGIC_
11760 53 49 43 4b 3b 0a 20 20 7d 0a 20 20 2a 70 70 44 SICK;. }. *ppD
11770 62 20 3d 20 64 62 3b 0a 20 20 72 65 74 75 72 6e b = db;. return
11780 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
11790 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 0, rc);.}../*.**
117a0 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 Open a new data
117b0 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a base handle..*/.
117c0 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e int sqlite3_open
117d0 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
117e0 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 zFilename, . sq
117f0 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a 29 7b lite3 **ppDb .){
11800 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 61 . return openDa
11810 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61 6d 65 tabase(zFilename
11820 2c 20 70 70 44 62 2c 0a 20 20 20 20 20 20 20 20 , ppDb,.
11830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
11840 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
11850 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 ITE | SQLITE_OPE
11860 4e 5f 43 52 45 41 54 45 2c 20 30 29 3b 0a 7d 0a N_CREATE, 0);.}.
11870 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e int sqlite3_open
11880 5f 76 32 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 _v2(. const cha
11890 72 20 2a 66 69 6c 65 6e 61 6d 65 2c 20 20 20 2f r *filename, /
118a0 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e * Database filen
118b0 61 6d 65 20 28 55 54 46 2d 38 29 20 2a 2f 0a 20 ame (UTF-8) */.
118c0 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c sqlite3 **ppDb,
118d0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
118e0 20 53 51 4c 69 74 65 20 64 62 20 68 61 6e 64 6c SQLite db handl
118f0 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 e */. int flags
11900 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
11910 2a 20 46 6c 61 67 73 20 2a 2f 0a 20 20 63 6f 6e * Flags */. con
11920 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 20 st char *zVfs
11930 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
11940 56 46 53 20 6d 6f 64 75 6c 65 20 74 6f 20 75 73 VFS module to us
11950 65 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 75 72 6e e */.){. return
11960 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 66 69 openDatabase(fi
11970 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c 20 28 75 lename, ppDb, (u
11980 6e 73 69 67 6e 65 64 20 69 6e 74 29 66 6c 61 67 nsigned int)flag
11990 73 2c 20 7a 56 66 73 29 3b 0a 7d 0a 0a 23 69 66 s, zVfs);.}..#if
119a0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
119b0 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f 70 65 _UTF16./*.** Ope
119c0 6e 20 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 n a new database
119d0 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 handle..*/.int
119e0 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 0a sqlite3_open16(.
119f0 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 const void *zF
11a00 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 6c 69 ilename, . sqli
11a10 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a 20 20 te3 **ppDb.){.
11a20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c char const *zFil
11a30 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a 46 69 ename8; /* zFi
11a40 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64 20 69 lename encoded i
11a50 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 61 64 20 n UTF-8 instead
11a60 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20 20 73 of UTF-16 */. s
11a70 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
11a80 61 6c 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 al;. int rc;..
11a90 20 61 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 assert( zFilena
11aa0 6d 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 me );. assert(
11ab0 70 70 44 62 20 29 3b 0a 20 20 2a 70 70 44 62 20 ppDb );. *ppDb
11ac0 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c = 0;.#ifndef SQL
11ad0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 ITE_OMIT_AUTOINI
11ae0 54 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 T. rc = sqlite3
11af0 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 _initialize();.
11b00 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
11b10 20 72 63 3b 0a 23 65 6e 64 69 66 0a 20 20 70 56 rc;.#endif. pV
11b20 61 6c 20 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 al = sqlite3Valu
11b30 65 4e 65 77 28 30 29 3b 0a 20 20 73 71 6c 69 74 eNew(0);. sqlit
11b40 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 70 56 e3ValueSetStr(pV
11b50 61 6c 2c 20 2d 31 2c 20 7a 46 69 6c 65 6e 61 6d al, -1, zFilenam
11b60 65 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e e, SQLITE_UTF16N
11b70 41 54 49 56 45 2c 20 53 51 4c 49 54 45 5f 53 54 ATIVE, SQLITE_ST
11b80 41 54 49 43 29 3b 0a 20 20 7a 46 69 6c 65 6e 61 ATIC);. zFilena
11b90 6d 65 38 20 3d 20 73 71 6c 69 74 65 33 56 61 6c me8 = sqlite3Val
11ba0 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c ueText(pVal, SQL
11bb0 49 54 45 5f 55 54 46 38 29 3b 0a 20 20 69 66 28 ITE_UTF8);. if(
11bc0 20 7a 46 69 6c 65 6e 61 6d 65 38 20 29 7b 0a 20 zFilename8 ){.
11bd0 20 20 20 72 63 20 3d 20 6f 70 65 6e 44 61 74 61 rc = openData
11be0 62 61 73 65 28 7a 46 69 6c 65 6e 61 6d 65 38 2c base(zFilename8,
11bf0 20 70 70 44 62 2c 0a 20 20 20 20 20 20 20 20 20 ppDb,.
11c00 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
11c10 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
11c20 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e TE | SQLITE_OPEN
11c30 5f 43 52 45 41 54 45 2c 20 30 29 3b 0a 20 20 20 _CREATE, 0);.
11c40 20 61 73 73 65 72 74 28 20 2a 70 70 44 62 20 7c assert( *ppDb |
11c50 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d | rc==SQLITE_NOM
11c60 45 4d 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 EM );. if( rc
11c70 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 ==SQLITE_OK && !
11c80 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 2a 70 DbHasProperty(*p
11c90 70 44 62 2c 20 30 2c 20 44 42 5f 53 63 68 65 6d pDb, 0, DB_Schem
11ca0 61 4c 6f 61 64 65 64 29 20 29 7b 0a 20 20 20 20 aLoaded) ){.
11cb0 20 20 45 4e 43 28 2a 70 70 44 62 29 20 3d 20 53 ENC(*ppDb) = S
11cc0 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
11cd0 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 E;. }. }else
11ce0 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
11cf0 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 E_NOMEM;. }. s
11d00 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 qlite3ValueFree(
11d10 70 56 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e pVal);.. return
11d20 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
11d30 30 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 0, rc);.}.#endif
11d40 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
11d50 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 UTF16 */../*.**
11d60 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 Register a new c
11d70 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
11d80 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 e with the datab
11d90 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a ase handle db..*
11da0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 /.int sqlite3_cr
11db0 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a eate_collation(.
11dc0 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a sqlite3* db, .
11dd0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e const char *zN
11de0 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c ame, . int enc,
11df0 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a . void* pCtx,.
11e00 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 int(*xCompare)
11e10 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 (void*,int,const
11e20 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 void*,int,const
11e30 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 void*).){. int
11e40 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc;. sqlite3_m
11e50 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
11e60 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 utex);. assert(
11e70 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
11e80 65 64 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 ed );. rc = cre
11e90 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c ateCollation(db,
11ea0 20 7a 4e 61 6d 65 2c 20 28 75 38 29 65 6e 63 2c zName, (u8)enc,
11eb0 20 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 55 53 45 SQLITE_COLL_USE
11ec0 52 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 R, pCtx, xCompar
11ed0 65 2c 20 30 29 3b 0a 20 20 72 63 20 3d 20 73 71 e, 0);. rc = sq
11ee0 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
11ef0 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
11f00 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
11f10 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
11f20 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
11f30 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c gister a new col
11f40 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
11f50 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
11f60 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a e handle db..*/.
11f70 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 int sqlite3_crea
11f80 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 te_collation_v2(
11f90 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 . sqlite3* db,
11fa0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
11fb0 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 Name, . int enc
11fc0 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c , . void* pCtx,
11fd0 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 . int(*xCompare
11fe0 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
11ff0 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 t void*,int,cons
12000 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 t void*),. void
12010 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 (*xDel)(void*).)
12020 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 {. int rc;. sq
12030 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
12040 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
12050 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c assert( !db->mal
12060 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 locFailed );. r
12070 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 c = createCollat
12080 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 28 ion(db, zName, (
12090 75 38 29 65 6e 63 2c 20 53 51 4c 49 54 45 5f 43 u8)enc, SQLITE_C
120a0 4f 4c 4c 5f 55 53 45 52 2c 20 70 43 74 78 2c 20 OLL_USER, pCtx,
120b0 78 43 6f 6d 70 61 72 65 2c 20 78 44 65 6c 29 3b xCompare, xDel);
120c0 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
120d0 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
120e0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
120f0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
12100 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
12110 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
12120 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a _OMIT_UTF16./*.*
12130 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 * Register a new
12140 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
12150 6e 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 nce with the dat
12160 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e abase handle db.
12170 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
12180 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e create_collation
12190 31 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 16(. sqlite3* d
121a0 62 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 b, . const void
121b0 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 65 *zName,. int e
121c0 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 nc, . void* pCt
121d0 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 x,. int(*xCompa
121e0 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f re)(void*,int,co
121f0 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f nst void*,int,co
12200 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 nst void*).){.
12210 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
12220 4f 4b 3b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d OK;. char *zNam
12230 65 38 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 e8;. sqlite3_mu
12240 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
12250 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 tex);. assert(
12260 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
12270 64 20 29 3b 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 d );. zName8 =
12280 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 sqlite3Utf16to8(
12290 64 62 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 db, zName, -1, S
122a0 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
122b0 45 29 3b 0a 20 20 69 66 28 20 7a 4e 61 6d 65 38 E);. if( zName8
122c0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 63 72 65 ){. rc = cre
122d0 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c ateCollation(db,
122e0 20 7a 4e 61 6d 65 38 2c 20 28 75 38 29 65 6e 63 zName8, (u8)enc
122f0 2c 20 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 55 53 , SQLITE_COLL_US
12300 45 52 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 ER, pCtx, xCompa
12310 72 65 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 re, 0);. sqli
12320 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 4e te3DbFree(db, zN
12330 61 6d 65 38 29 3b 0a 20 20 7d 0a 20 20 72 63 20 ame8);. }. rc
12340 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
12350 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
12360 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
12370 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
12380 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 turn rc;.}.#endi
12390 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 f /* SQLITE_OMIT
123a0 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a _UTF16 */../*.**
123b0 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c Register a coll
123c0 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 ation sequence f
123d0 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 actory callback
123e0 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
123f0 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 e handle.** db.
12400 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 Replace any prev
12410 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 iously installed
12420 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
12430 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a nce factory..*/.
12440 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c int sqlite3_coll
12450 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 ation_needed(.
12460 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 sqlite3 *db, .
12470 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 void *pCollNeede
12480 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 dArg, . void(*x
12490 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 CollNeeded)(void
124a0 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 *,sqlite3*,int e
124b0 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 TextRep,const ch
124c0 61 72 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74 65 ar*).){. sqlite
124d0 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
124e0 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
124f0 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 xCollNeeded = xC
12500 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d ollNeeded;. db-
12510 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d >xCollNeeded16 =
12520 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 0;. db->pCollN
12530 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c eededArg = pColl
12540 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 73 71 6c NeededArg;. sql
12550 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
12560 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
12570 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
12580 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
12590 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a TE_OMIT_UTF16./*
125a0 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
125b0 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
125c0 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 e factory callba
125d0 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ck with the data
125e0 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 base handle.** d
125f0 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 b. Replace any p
12600 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c reviously instal
12610 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 led collation se
12620 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a quence factory..
12630 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
12640 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 ollation_needed1
12650 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 6(. sqlite3 *db
12660 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c , . void *pColl
12670 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f NeededArg, . vo
12680 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 id(*xCollNeeded1
12690 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 6)(void*,sqlite3
126a0 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 *,int eTextRep,c
126b0 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 onst void*).){.
126c0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
126d0 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
126e0 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 . db->xCollNeed
126f0 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 ed = 0;. db->xC
12700 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 43 ollNeeded16 = xC
12710 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 ollNeeded16;. d
12720 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 b->pCollNeededAr
12730 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 g = pCollNeededA
12740 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
12750 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
12760 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
12770 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
12780 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
12790 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 6e T_UTF16 */..#ifn
127a0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
127b0 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a DEPRECATED./*.**
127c0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
127d0 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 68 72 6f s now an anachro
127e0 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 20 74 6f nism. It used to
127f0 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f be used to reco
12800 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a 20 6d 61 ver from a.** ma
12810 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2c 20 lloc() failure,
12820 62 75 74 20 53 51 4c 69 74 65 20 6e 6f 77 20 64 but SQLite now d
12830 6f 65 73 20 74 68 69 73 20 61 75 74 6f 6d 61 74 oes this automat
12840 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 ically..*/.int s
12850 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 qlite3_global_re
12860 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a 20 20 72 cover(void){. r
12870 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
12880 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
12890 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 68 65 Test to see whe
128a0 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
128b0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
128c0 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f 63 6f ion is in autoco
128d0 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20 20 52 mmit.** mode. R
128e0 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 eturn TRUE if it
128f0 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20 69 66 is and FALSE if
12900 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 not. Autocommi
12910 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a 2a 20 t mode is on.**
12920 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 75 74 by default. Aut
12930 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73 61 62 ocommit is disab
12940 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e 20 73 led by a BEGIN s
12950 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 65 tatement and ree
12960 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74 68 65 nabled.** by the
12970 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f 72 20 next COMMIT or
12980 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2a 0a 2a 2a 2a ROLLBACK..**.***
12990 2a 2a 2a 2a 20 54 48 49 53 20 49 53 20 41 4e 20 **** THIS IS AN
129a0 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 41 50 49 EXPERIMENTAL API
129b0 20 41 4e 44 20 49 53 20 53 55 42 4a 45 43 54 20 AND IS SUBJECT
129c0 54 4f 20 43 48 41 4e 47 45 20 2a 2a 2a 2a 2a 2a TO CHANGE ******
129d0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
129e0 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74 28 73 get_autocommit(s
129f0 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 qlite3 *db){. r
12a00 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f 43 6f eturn db->autoCo
12a10 6d 6d 69 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 mmit;.}../*.** T
12a20 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 he following rou
12a30 74 69 6e 65 73 20 61 72 65 20 73 75 62 74 69 74 tines are subtit
12a40 75 74 65 73 20 66 6f 72 20 63 6f 6e 73 74 61 6e utes for constan
12a50 74 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 ts SQLITE_CORRUP
12a60 54 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 49 53 T,.** SQLITE_MIS
12a70 55 53 45 2c 20 53 51 4c 49 54 45 5f 43 41 4e 54 USE, SQLITE_CANT
12a80 4f 50 45 4e 2c 20 53 51 4c 49 54 45 5f 49 4f 45 OPEN, SQLITE_IOE
12a90 52 52 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 RR and possibly
12aa0 6f 74 68 65 72 20 65 72 72 6f 72 0a 2a 2a 20 63 other error.** c
12ab0 6f 6e 73 74 61 6e 74 73 2e 20 20 54 68 65 79 20 onstants. They
12ac0 73 65 72 76 65 72 20 74 77 6f 20 70 75 72 70 6f server two purpo
12ad0 73 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 ses:.**.** 1.
12ae0 20 53 65 72 76 65 20 61 73 20 61 20 63 6f 6e 76 Serve as a conv
12af0 65 6e 69 65 6e 74 20 70 6c 61 63 65 20 74 6f 20 enient place to
12b00 73 65 74 20 61 20 62 72 65 61 6b 70 6f 69 6e 74 set a breakpoint
12b10 20 69 6e 20 61 20 64 65 62 75 67 67 65 72 0a 2a in a debugger.*
12b20 2a 20 20 20 20 20 20 20 74 6f 20 64 65 74 65 63 * to detec
12b30 74 20 77 68 65 6e 20 76 65 72 73 69 6f 6e 20 65 t when version e
12b40 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 73 20 rror conditions
12b50 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 occurs..**.**
12b60 32 2e 20 20 49 6e 76 6f 6b 65 20 73 71 6c 69 74 2. Invoke sqlit
12b70 65 33 5f 6c 6f 67 28 29 20 74 6f 20 70 72 6f 76 e3_log() to prov
12b80 69 64 65 20 74 68 65 20 73 6f 75 72 63 65 20 63 ide the source c
12b90 6f 64 65 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 ode location whe
12ba0 72 65 0a 2a 2a 20 20 20 20 20 20 20 61 20 6c 6f re.** a lo
12bb0 77 2d 6c 65 76 65 6c 20 65 72 72 6f 72 20 69 73 w-level error is
12bc0 20 66 69 72 73 74 20 64 65 74 65 63 74 65 64 2e first detected.
12bd0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 .*/.int sqlite3C
12be0 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 74 20 orruptError(int
12bf0 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 lineno){. testc
12c00 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 ase( sqlite3Glob
12c10 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 alConfig.xLog!=0
12c20 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f );. sqlite3_lo
12c30 67 28 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 g(SQLITE_CORRUPT
12c40 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
12c50 22 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 "database corrup
12c60 74 69 6f 6e 20 61 74 20 6c 69 6e 65 20 25 64 20 tion at line %d
12c70 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 20 20 of [%.10s]",.
12c80 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e 65 6e linen
12c90 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f 73 6f o, 20+sqlite3_so
12ca0 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 65 74 urceid());. ret
12cb0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
12cc0 50 54 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 PT;.}.int sqlite
12cd0 33 4d 69 73 75 73 65 45 72 72 6f 72 28 69 6e 74 3MisuseError(int
12ce0 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 lineno){. test
12cf0 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c 6f case( sqlite3Glo
12d00 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d balConfig.xLog!=
12d10 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 0 );. sqlite3_l
12d20 6f 67 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 og(SQLITE_MISUSE
12d30 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 , .
12d40 20 22 6d 69 73 75 73 65 20 61 74 20 6c 69 6e 65 "misuse at line
12d50 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c %d of [%.10s]",
12d60 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c . l
12d70 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 ineno, 20+sqlite
12d80 33 5f 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 3_sourceid());.
12d90 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
12da0 49 53 55 53 45 3b 0a 7d 0a 69 6e 74 20 73 71 6c ISUSE;.}.int sql
12db0 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f ite3CantopenErro
12dc0 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 r(int lineno){.
12dd0 20 74 65 73 74 63 61 73 65 28 20 73 71 6c 69 74 testcase( sqlit
12de0 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
12df0 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 Log!=0 );. sqli
12e00 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 43 te3_log(SQLITE_C
12e10 41 4e 54 4f 50 45 4e 2c 20 0a 20 20 20 20 20 20 ANTOPEN, .
12e20 20 20 20 20 20 20 20 20 22 63 61 6e 6e 6f 74 20 "cannot
12e30 6f 70 65 6e 20 66 69 6c 65 20 61 74 20 6c 69 6e open file at lin
12e40 65 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 e %d of [%.10s]"
12e50 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
12e60 6c 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 lineno, 20+sqlit
12e70 65 33 5f 73 6f 75 72 63 65 69 64 28 29 29 3b 0a e3_sourceid());.
12e80 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
12e90 43 41 4e 54 4f 50 45 4e 3b 0a 7d 0a 0a 0a 23 69 CANTOPEN;.}...#i
12ea0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
12eb0 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a T_DEPRECATED./*.
12ec0 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 6f 6e ** This is a con
12ed0 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 69 6e 65 venience routine
12ee0 20 74 68 61 74 20 6d 61 6b 65 73 20 73 75 72 65 that makes sure
12ef0 20 74 68 61 74 20 61 6c 6c 20 74 68 72 65 61 64 that all thread
12f00 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 64 61 74 -specific.** dat
12f10 61 20 66 6f 72 20 74 68 69 73 20 74 68 72 65 61 a for this threa
12f20 64 20 68 61 73 20 62 65 65 6e 20 64 65 61 6c 6c d has been deall
12f30 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 ocated..**.** SQ
12f40 4c 69 74 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 Lite no longer u
12f50 73 65 73 20 74 68 72 65 61 64 2d 73 70 65 63 69 ses thread-speci
12f60 66 69 63 20 64 61 74 61 20 73 6f 20 74 68 69 73 fic data so this
12f70 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 77 20 routine is now
12f80 61 0a 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 49 74 20 a.** no-op. It
12f90 69 73 20 72 65 74 61 69 6e 65 64 20 66 6f 72 20 is retained for
12fa0 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d 70 61 historical compa
12fb0 74 69 62 69 6c 69 74 79 2e 0a 2a 2f 0a 76 6f 69 tibility..*/.voi
12fc0 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61 64 d sqlite3_thread
12fd0 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 7b 0a _cleanup(void){.
12fe0 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
12ff0 52 65 74 75 72 6e 20 6d 65 74 61 20 69 6e 66 6f Return meta info
13000 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 20 rmation about a
13010 73 70 65 63 69 66 69 63 20 63 6f 6c 75 6d 6e 20 specific column
13020 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 74 61 of a database ta
13030 62 6c 65 2e 0a 2a 2a 20 53 65 65 20 63 6f 6d 6d ble..** See comm
13040 65 6e 74 20 69 6e 20 73 71 6c 69 74 65 33 2e 68 ent in sqlite3.h
13050 20 28 73 71 6c 69 74 65 2e 68 2e 69 6e 29 20 66 (sqlite.h.in) f
13060 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 23 or details..*/.#
13070 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
13080 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 BLE_COLUMN_METAD
13090 41 54 41 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ATA.int sqlite3_
130a0 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 table_column_met
130b0 61 64 61 74 61 28 0a 20 20 73 71 6c 69 74 65 33 adata(. sqlite3
130c0 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
130d0 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 /* Connecti
130e0 6f 6e 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 on handle */. c
130f0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 onst char *zDbNa
13100 6d 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 44 61 me, /* Da
13110 74 61 62 61 73 65 20 6e 61 6d 65 20 6f 72 20 4e tabase name or N
13120 55 4c 4c 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 ULL */. const c
13130 68 61 72 20 2a 7a 54 61 62 6c 65 4e 61 6d 65 2c har *zTableName,
13140 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 /* Table na
13150 6d 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 me */. const ch
13160 61 72 20 2a 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 2c ar *zColumnName,
13170 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 /* Column na
13180 6d 65 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e me */. char con
13190 73 74 20 2a 2a 70 7a 44 61 74 61 54 79 70 65 2c st **pzDataType,
131a0 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 44 /* OUTPUT: D
131b0 65 63 6c 61 72 65 64 20 64 61 74 61 20 74 79 70 eclared data typ
131c0 65 20 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 e */. char cons
131d0 74 20 2a 2a 70 7a 43 6f 6c 6c 53 65 71 2c 20 20 t **pzCollSeq,
131e0 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 43 6f /* OUTPUT: Co
131f0 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
13200 20 6e 61 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 2a name */. int *
13210 70 4e 6f 74 4e 75 6c 6c 2c 20 20 20 20 20 20 20 pNotNull,
13220 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 /* OUTPUT
13230 3a 20 54 72 75 65 20 69 66 20 4e 4f 54 20 4e 55 : True if NOT NU
13240 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 65 78 LL constraint ex
13250 69 73 74 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 ists */. int *p
13260 50 72 69 6d 61 72 79 4b 65 79 2c 20 20 20 20 20 PrimaryKey,
13270 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a /* OUTPUT:
13280 20 54 72 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 True if column
13290 70 61 72 74 20 6f 66 20 50 4b 20 2a 2f 0a 20 20 part of PK */.
132a0 69 6e 74 20 2a 70 41 75 74 6f 69 6e 63 20 20 20 int *pAutoinc
132b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
132c0 55 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 63 UTPUT: True if c
132d0 6f 6c 75 6d 6e 20 69 73 20 61 75 74 6f 2d 69 6e olumn is auto-in
132e0 63 72 65 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 crement */.){.
132f0 69 6e 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a int rc;. char *
13300 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 54 zErrMsg = 0;. T
13310 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 30 3b 0a able *pTab = 0;.
13320 20 20 43 6f 6c 75 6d 6e 20 2a 70 43 6f 6c 20 3d Column *pCol =
13330 20 30 3b 0a 20 20 69 6e 74 20 69 43 6f 6c 3b 0a 0;. int iCol;.
13340 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a . char const *z
13350 44 61 74 61 54 79 70 65 20 3d 20 30 3b 0a 20 20 DataType = 0;.
13360 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 43 6f 6c char const *zCol
13370 6c 53 65 71 20 3d 20 30 3b 0a 20 20 69 6e 74 20 lSeq = 0;. int
13380 6e 6f 74 6e 75 6c 6c 20 3d 20 30 3b 0a 20 20 69 notnull = 0;. i
13390 6e 74 20 70 72 69 6d 61 72 79 6b 65 79 20 3d 20 nt primarykey =
133a0 30 3b 0a 20 20 69 6e 74 20 61 75 74 6f 69 6e 63 0;. int autoinc
133b0 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 45 6e 73 75 = 0;.. /* Ensu
133c0 72 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 re the database
133d0 73 63 68 65 6d 61 20 68 61 73 20 62 65 65 6e 20 schema has been
133e0 6c 6f 61 64 65 64 20 2a 2f 0a 20 20 73 71 6c 69 loaded */. sqli
133f0 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
13400 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 db->mutex);. sq
13410 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 lite3BtreeEnterA
13420 6c 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 ll(db);. rc = s
13430 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c 20 26 qlite3Init(db, &
13440 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 zErrMsg);. if(
13450 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b SQLITE_OK!=rc ){
13460 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f . goto error_
13470 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4c out;. }.. /* L
13480 6f 63 61 74 65 20 74 68 65 20 74 61 62 6c 65 20 ocate the table
13490 69 6e 20 71 75 65 73 74 69 6f 6e 20 2a 2f 0a 20 in question */.
134a0 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 33 46 pTab = sqlite3F
134b0 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 54 61 indTable(db, zTa
134c0 62 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 bleName, zDbName
134d0 29 3b 0a 20 20 69 66 28 20 21 70 54 61 62 20 7c );. if( !pTab |
134e0 7c 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 74 20 | pTab->pSelect
134f0 29 7b 0a 20 20 20 20 70 54 61 62 20 3d 20 30 3b ){. pTab = 0;
13500 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f . goto error_
13510 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 out;. }.. /* F
13520 69 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66 ind the column f
13530 6f 72 20 77 68 69 63 68 20 69 6e 66 6f 20 69 73 or which info is
13540 20 72 65 71 75 65 73 74 65 64 20 2a 2f 0a 20 20 requested */.
13550 69 66 28 20 73 71 6c 69 74 65 33 49 73 52 6f 77 if( sqlite3IsRow
13560 69 64 28 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 id(zColumnName)
13570 29 7b 0a 20 20 20 20 69 43 6f 6c 20 3d 20 70 54 ){. iCol = pT
13580 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 20 69 ab->iPKey;. i
13590 66 28 20 69 43 6f 6c 3e 3d 30 20 29 7b 0a 20 20 f( iCol>=0 ){.
135a0 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 61 62 pCol = &pTab
135b0 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 ->aCol[iCol];.
135c0 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
135d0 20 66 6f 72 28 69 43 6f 6c 3d 30 3b 20 69 43 6f for(iCol=0; iCo
135e0 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c 3b 20 69 43 l<pTab->nCol; iC
135f0 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 20 70 43 6f ol++){. pCo
13600 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b l = &pTab->aCol[
13610 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 20 69 66 28 iCol];. if(
13620 20 30 3d 3d 73 71 6c 69 74 65 33 53 74 72 49 43 0==sqlite3StrIC
13630 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 6d 65 2c 20 mp(pCol->zName,
13640 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a zColumnName) ){.
13650 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
13660 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
13670 20 69 66 28 20 69 43 6f 6c 3d 3d 70 54 61 62 2d if( iCol==pTab-
13680 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 20 20 20 70 >nCol ){. p
13690 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 67 Tab = 0;. g
136a0 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 oto error_out;.
136b0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 }. }.. /* T
136c0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f he following blo
136d0 63 6b 20 73 74 6f 72 65 73 20 74 68 65 20 6d 65 ck stores the me
136e0 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 ta information t
136f0 68 61 74 20 77 69 6c 6c 20 62 65 20 72 65 74 75 hat will be retu
13700 72 6e 65 64 0a 20 20 2a 2a 20 74 6f 20 74 68 65 rned. ** to the
13710 20 63 61 6c 6c 65 72 20 69 6e 20 6c 6f 63 61 6c caller in local
13720 20 76 61 72 69 61 62 6c 65 73 20 7a 44 61 74 61 variables zData
13730 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 65 71 2c 20 Type, zCollSeq,
13740 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 6d 61 72 79 notnull, primary
13750 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 20 61 75 74 key. ** and aut
13760 6f 69 6e 63 2e 20 41 74 20 74 68 69 73 20 70 6f oinc. At this po
13770 69 6e 74 20 74 68 65 72 65 20 61 72 65 20 74 77 int there are tw
13780 6f 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 3a o possibilities:
13790 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 20 20 20 20 . ** . **
137a0 31 2e 20 54 68 65 20 73 70 65 63 69 66 69 65 64 1. The specified
137b0 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 77 61 73 column name was
137c0 20 72 6f 77 69 64 22 2c 20 22 6f 69 64 22 20 6f rowid", "oid" o
137d0 72 20 22 5f 72 6f 77 69 64 5f 22 20 0a 20 20 2a r "_rowid_" . *
137e0 2a 20 20 20 20 20 20 20 20 61 6e 64 20 74 68 65 * and the
137f0 72 65 20 69 73 20 6e 6f 20 65 78 70 6c 69 63 69 re is no explici
13800 74 6c 79 20 64 65 63 6c 61 72 65 64 20 49 50 4b tly declared IPK
13810 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 2a 2a 0a 20 column. . **.
13820 20 2a 2a 20 20 20 20 20 32 2e 20 54 68 65 20 74 ** 2. The t
13830 61 62 6c 65 20 69 73 20 6e 6f 74 20 61 20 76 69 able is not a vi
13840 65 77 20 61 6e 64 20 74 68 65 20 63 6f 6c 75 6d ew and the colum
13850 6e 20 6e 61 6d 65 20 69 64 65 6e 74 69 66 69 65 n name identifie
13860 64 20 61 6e 20 0a 20 20 2a 2a 20 20 20 20 20 20 d an . **
13870 20 20 65 78 70 6c 69 63 69 74 6c 79 20 64 65 63 explicitly dec
13880 6c 61 72 65 64 20 63 6f 6c 75 6d 6e 2e 20 43 6f lared column. Co
13890 70 79 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 py meta informat
138a0 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 6f 6c 2e 0a ion from *pCol..
138b0 20 20 2a 2f 20 0a 20 20 69 66 28 20 70 43 6f 6c */ . if( pCol
138c0 20 29 7b 0a 20 20 20 20 7a 44 61 74 61 54 79 70 ){. zDataTyp
138d0 65 20 3d 20 70 43 6f 6c 2d 3e 7a 54 79 70 65 3b e = pCol->zType;
138e0 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 3d 20 . zCollSeq =
138f0 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 20 20 pCol->zColl;.
13900 20 6e 6f 74 6e 75 6c 6c 20 3d 20 70 43 6f 6c 2d notnull = pCol-
13910 3e 6e 6f 74 4e 75 6c 6c 21 3d 30 3b 0a 20 20 20 >notNull!=0;.
13920 20 70 72 69 6d 61 72 79 6b 65 79 20 20 3d 20 70 primarykey = p
13930 43 6f 6c 2d 3e 69 73 50 72 69 6d 4b 65 79 21 3d Col->isPrimKey!=
13940 30 3b 0a 20 20 20 20 61 75 74 6f 69 6e 63 20 3d 0;. autoinc =
13950 20 70 54 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 pTab->iPKey==iC
13960 6f 6c 20 26 26 20 28 70 54 61 62 2d 3e 74 61 62 ol && (pTab->tab
13970 46 6c 61 67 73 20 26 20 54 46 5f 41 75 74 6f 69 Flags & TF_Autoi
13980 6e 63 72 65 6d 65 6e 74 29 21 3d 30 3b 0a 20 20 ncrement)!=0;.
13990 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 44 61 74 61 }else{. zData
139a0 54 79 70 65 20 3d 20 22 49 4e 54 45 47 45 52 22 Type = "INTEGER"
139b0 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 79 ;. primarykey
139c0 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 = 1;. }. if(
139d0 21 7a 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20 !zCollSeq ){.
139e0 20 7a 43 6f 6c 6c 53 65 71 20 3d 20 22 42 49 4e zCollSeq = "BIN
139f0 41 52 59 22 3b 0a 20 20 7d 0a 0a 65 72 72 6f 72 ARY";. }..error
13a00 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 _out:. sqlite3B
13a10 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 treeLeaveAll(db)
13a20 3b 0a 0a 20 20 2f 2a 20 57 68 65 74 68 65 72 20 ;.. /* Whether
13a30 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c the function cal
13a40 6c 20 73 75 63 63 65 65 64 65 64 20 6f 72 20 66 l succeeded or f
13a50 61 69 6c 65 64 2c 20 73 65 74 20 74 68 65 20 6f ailed, set the o
13a60 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 73 utput parameters
13a70 0a 20 20 2a 2a 20 74 6f 20 77 68 61 74 65 76 65 . ** to whateve
13a80 72 20 74 68 65 69 72 20 6c 6f 63 61 6c 20 63 6f r their local co
13a90 75 6e 74 65 72 70 61 72 74 73 20 63 6f 6e 74 61 unterparts conta
13aa0 69 6e 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 in. If an error
13ab0 64 69 64 20 6f 63 63 75 72 2c 0a 20 20 2a 2a 20 did occur,. **
13ac0 74 68 69 73 20 68 61 73 20 74 68 65 20 65 66 66 this has the eff
13ad0 65 63 74 20 6f 66 20 7a 65 72 6f 69 6e 67 20 61 ect of zeroing a
13ae0 6c 6c 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 ll output parame
13af0 74 65 72 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 ters.. */. if(
13b00 20 70 7a 44 61 74 61 54 79 70 65 20 29 20 2a 70 pzDataType ) *p
13b10 7a 44 61 74 61 54 79 70 65 20 3d 20 7a 44 61 74 zDataType = zDat
13b20 61 54 79 70 65 3b 0a 20 20 69 66 28 20 70 7a 43 aType;. if( pzC
13b30 6f 6c 6c 53 65 71 20 29 20 2a 70 7a 43 6f 6c 6c ollSeq ) *pzColl
13b40 53 65 71 20 3d 20 7a 43 6f 6c 6c 53 65 71 3b 0a Seq = zCollSeq;.
13b50 20 20 69 66 28 20 70 4e 6f 74 4e 75 6c 6c 20 29 if( pNotNull )
13b60 20 2a 70 4e 6f 74 4e 75 6c 6c 20 3d 20 6e 6f 74 *pNotNull = not
13b70 6e 75 6c 6c 3b 0a 20 20 69 66 28 20 70 50 72 69 null;. if( pPri
13b80 6d 61 72 79 4b 65 79 20 29 20 2a 70 50 72 69 6d maryKey ) *pPrim
13b90 61 72 79 4b 65 79 20 3d 20 70 72 69 6d 61 72 79 aryKey = primary
13ba0 6b 65 79 3b 0a 20 20 69 66 28 20 70 41 75 74 6f key;. if( pAuto
13bb0 69 6e 63 20 29 20 2a 70 41 75 74 6f 69 6e 63 20 inc ) *pAutoinc
13bc0 3d 20 61 75 74 6f 69 6e 63 3b 0a 0a 20 20 69 66 = autoinc;.. if
13bd0 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 72 63 20 ( SQLITE_OK==rc
13be0 26 26 20 21 70 54 61 62 20 29 7b 0a 20 20 20 20 && !pTab ){.
13bf0 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
13c00 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 , zErrMsg);.
13c10 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 zErrMsg = sqlite
13c20 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6e 6f 3MPrintf(db, "no
13c30 20 73 75 63 68 20 74 61 62 6c 65 20 63 6f 6c 75 such table colu
13c40 6d 6e 3a 20 25 73 2e 25 73 22 2c 20 7a 54 61 62 mn: %s.%s", zTab
13c50 6c 65 4e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 leName,.
13c60 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 3b 0a 20 20 zColumnName);.
13c70 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
13c80 52 4f 52 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 ROR;. }. sqlit
13c90 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 e3Error(db, rc,
13ca0 28 7a 45 72 72 4d 73 67 3f 22 25 73 22 3a 30 29 (zErrMsg?"%s":0)
13cb0 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 73 71 , zErrMsg);. sq
13cc0 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
13cd0 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 63 20 3d zErrMsg);. rc =
13ce0 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
13cf0 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 db, rc);. sqlit
13d00 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
13d10 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
13d20 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 urn rc;.}.#endif
13d30 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f ../*.** Sleep fo
13d40 72 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 r a little while
13d50 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d . Return the am
13d60 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 ount of time sle
13d70 70 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 pt..*/.int sqlit
13d80 65 33 5f 73 6c 65 65 70 28 69 6e 74 20 6d 73 29 e3_sleep(int ms)
13d90 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 {. sqlite3_vfs
13da0 2a 70 56 66 73 3b 0a 20 20 69 6e 74 20 72 63 3b *pVfs;. int rc;
13db0 0a 20 20 70 56 66 73 20 3d 20 73 71 6c 69 74 65 . pVfs = sqlite
13dc0 33 5f 76 66 73 5f 66 69 6e 64 28 30 29 3b 0a 20 3_vfs_find(0);.
13dd0 20 69 66 28 20 70 56 66 73 3d 3d 30 20 29 20 72 if( pVfs==0 ) r
13de0 65 74 75 72 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 eturn 0;.. /* T
13df0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 6f 72 his function wor
13e00 6b 73 20 69 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e ks in millisecon
13e10 64 73 2c 20 62 75 74 20 74 68 65 20 75 6e 64 65 ds, but the unde
13e20 72 6c 79 69 6e 67 20 4f 73 53 6c 65 65 70 28 29 rlying OsSleep()
13e30 20 0a 20 20 2a 2a 20 41 50 49 20 75 73 65 73 20 . ** API uses
13e40 6d 69 63 72 6f 73 65 63 6f 6e 64 73 2e 20 48 65 microseconds. He
13e50 6e 63 65 20 74 68 65 20 31 30 30 30 27 73 2e 0a nce the 1000's..
13e60 20 20 2a 2f 0a 20 20 72 63 20 3d 20 28 73 71 6c */. rc = (sql
13e70 69 74 65 33 4f 73 53 6c 65 65 70 28 70 56 66 73 ite3OsSleep(pVfs
13e80 2c 20 31 30 30 30 2a 6d 73 29 2f 31 30 30 30 29 , 1000*ms)/1000)
13e90 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
13ea0 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f ../*.** Enable o
13eb0 72 20 64 69 73 61 62 6c 65 20 74 68 65 20 65 78 r disable the ex
13ec0 74 65 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f tended result co
13ed0 64 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 des..*/.int sqli
13ee0 74 65 33 5f 65 78 74 65 6e 64 65 64 5f 72 65 73 te3_extended_res
13ef0 75 6c 74 5f 63 6f 64 65 73 28 73 71 6c 69 74 65 ult_codes(sqlite
13f00 33 20 2a 64 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 3 *db, int onoff
13f10 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 ){. sqlite3_mut
13f20 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
13f30 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 ex);. db->errMa
13f40 73 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 30 78 66 sk = onoff ? 0xf
13f50 66 66 66 66 66 66 66 20 3a 20 30 78 66 66 3b 0a fffffff : 0xff;.
13f60 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
13f70 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
13f80 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
13f90 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 E_OK;.}../*.** I
13fa0 6e 76 6f 6b 65 20 74 68 65 20 78 46 69 6c 65 43 nvoke the xFileC
13fb0 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 6f 6e ontrol method on
13fc0 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
13fd0 74 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 tabase..*/.int s
13fe0 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 qlite3_file_cont
13ff0 72 6f 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c rol(sqlite3 *db,
14000 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 const char *zDb
14010 4e 61 6d 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f Name, int op, vo
14020 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 69 6e 74 id *pArg){. int
14030 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
14040 4f 52 3b 0a 20 20 69 6e 74 20 69 44 62 3b 0a 20 OR;. int iDb;.
14050 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
14060 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
14070 0a 20 20 69 66 28 20 7a 44 62 4e 61 6d 65 3d 3d . if( zDbName==
14080 30 20 29 7b 0a 20 20 20 20 69 44 62 20 3d 20 30 0 ){. iDb = 0
14090 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 66 ;. }else{. f
140a0 6f 72 28 69 44 62 3d 30 3b 20 69 44 62 3c 64 62 or(iDb=0; iDb<db
140b0 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 7b 0a 20 ->nDb; iDb++){.
140c0 20 20 20 20 20 69 66 28 20 73 74 72 63 6d 70 28 if( strcmp(
140d0 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 db->aDb[iDb].zNa
140e0 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 3d 3d 30 20 me, zDbName)==0
140f0 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 ) break;. }.
14100 20 7d 0a 20 20 69 66 28 20 69 44 62 3c 64 62 2d }. if( iDb<db-
14110 3e 6e 44 62 20 29 7b 0a 20 20 20 20 42 74 72 65 >nDb ){. Btre
14120 65 20 2a 70 42 74 72 65 65 20 3d 20 64 62 2d 3e e *pBtree = db->
14130 61 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 aDb[iDb].pBt;.
14140 20 20 69 66 28 20 70 42 74 72 65 65 20 29 7b 0a if( pBtree ){.
14150 20 20 20 20 20 20 50 61 67 65 72 20 2a 70 50 61 Pager *pPa
14160 67 65 72 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ger;. sqlit
14170 65 33 5f 66 69 6c 65 20 2a 66 64 3b 0a 20 20 20 e3_file *fd;.
14180 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 sqlite3BtreeE
14190 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
141a0 20 20 20 20 70 50 61 67 65 72 20 3d 20 73 71 6c pPager = sql
141b0 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
141c0 42 74 72 65 65 29 3b 0a 20 20 20 20 20 20 61 73 Btree);. as
141d0 73 65 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 sert( pPager!=0
141e0 29 3b 0a 20 20 20 20 20 20 66 64 20 3d 20 73 71 );. fd = sq
141f0 6c 69 74 65 33 50 61 67 65 72 46 69 6c 65 28 70 lite3PagerFile(p
14200 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 61 73 Pager);. as
14210 73 65 72 74 28 20 66 64 21 3d 30 20 29 3b 0a 20 sert( fd!=0 );.
14220 20 20 20 20 20 69 66 28 20 6f 70 3d 3d 53 51 4c if( op==SQL
14230 49 54 45 5f 46 43 4e 54 4c 5f 46 49 4c 45 5f 50 ITE_FCNTL_FILE_P
14240 4f 49 4e 54 45 52 20 29 7b 0a 20 20 20 20 20 20 OINTER ){.
14250 20 20 2a 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 *(sqlite3_file
14260 2a 2a 29 70 41 72 67 20 3d 20 66 64 3b 0a 20 20 **)pArg = fd;.
14270 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
14280 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 E_OK;. }els
14290 65 20 69 66 28 20 66 64 2d 3e 70 4d 65 74 68 6f e if( fd->pMetho
142a0 64 73 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 ds ){. rc
142b0 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
142c0 43 6f 6e 74 72 6f 6c 28 66 64 2c 20 6f 70 2c 20 Control(fd, op,
142d0 70 41 72 67 29 3b 0a 20 20 20 20 20 20 7d 65 6c pArg);. }el
142e0 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d se{. rc =
142f0 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 SQLITE_NOTFOUND
14300 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
14310 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
14320 65 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 7d e(pBtree);. }
14330 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
14340 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
14350 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
14360 72 63 3b 20 20 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rc; .}../*.**
14370 49 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 Interface to the
14380 20 74 65 73 74 69 6e 67 20 6c 6f 67 69 63 2e 0a testing logic..
14390 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 */.int sqlite3_t
143a0 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 69 6e 74 20 est_control(int
143b0 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 69 6e 74 20 op, ...){. int
143c0 72 63 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 rc = 0;.#ifndef
143d0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c SQLITE_OMIT_BUIL
143e0 54 49 4e 5f 54 45 53 54 0a 20 20 76 61 5f 6c 69 TIN_TEST. va_li
143f0 73 74 20 61 70 3b 0a 20 20 76 61 5f 73 74 61 72 st ap;. va_star
14400 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 t(ap, op);. swi
14410 74 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 tch( op ){..
14420 2f 2a 0a 20 20 20 20 2a 2a 20 53 61 76 65 20 74 /*. ** Save t
14430 68 65 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 he current state
14440 20 6f 66 20 74 68 65 20 50 52 4e 47 2e 0a 20 20 of the PRNG..
14450 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
14460 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 LITE_TESTCTRL_PR
14470 4e 47 5f 53 41 56 45 3a 20 7b 0a 20 20 20 20 20 NG_SAVE: {.
14480 20 73 71 6c 69 74 65 33 50 72 6e 67 53 61 76 65 sqlite3PrngSave
14490 53 74 61 74 65 28 29 3b 0a 20 20 20 20 20 20 62 State();. b
144a0 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
144b0 20 2f 2a 0a 20 20 20 20 2a 2a 20 52 65 73 74 6f /*. ** Resto
144c0 72 65 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 re the state of
144d0 74 68 65 20 50 52 4e 47 20 74 6f 20 74 68 65 20 the PRNG to the
144e0 6c 61 73 74 20 73 74 61 74 65 20 73 61 76 65 64 last state saved
144f0 20 75 73 69 6e 67 0a 20 20 20 20 2a 2a 20 50 52 using. ** PR
14500 4e 47 5f 53 41 56 45 2e 20 20 49 66 20 50 52 4e NG_SAVE. If PRN
14510 47 5f 53 41 56 45 20 68 61 73 20 6e 65 76 65 72 G_SAVE has never
14520 20 62 65 66 6f 72 65 20 62 65 65 6e 20 63 61 6c before been cal
14530 6c 65 64 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a led, then. **
14540 20 74 68 69 73 20 76 65 72 62 20 61 63 74 73 20 this verb acts
14550 6c 69 6b 65 20 50 52 4e 47 5f 52 45 53 45 54 2e like PRNG_RESET.
14560 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
14570 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
14580 5f 50 52 4e 47 5f 52 45 53 54 4f 52 45 3a 20 7b _PRNG_RESTORE: {
14590 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 72 . sqlite3Pr
145a0 6e 67 52 65 73 74 6f 72 65 53 74 61 74 65 28 29 ngRestoreState()
145b0 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
145c0 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 }.. /*.
145d0 20 2a 2a 20 52 65 73 65 74 20 74 68 65 20 50 52 ** Reset the PR
145e0 4e 47 20 62 61 63 6b 20 74 6f 20 69 74 73 20 75 NG back to its u
145f0 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 73 74 61 ninitialized sta
14600 74 65 2e 20 20 54 68 65 20 6e 65 78 74 20 63 61 te. The next ca
14610 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c ll. ** to sql
14620 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 ite3_randomness(
14630 29 20 77 69 6c 6c 20 72 65 73 65 65 64 20 74 68 ) will reseed th
14640 65 20 50 52 4e 47 20 75 73 69 6e 67 20 61 20 73 e PRNG using a s
14650 69 6e 67 6c 65 20 63 61 6c 6c 0a 20 20 20 20 2a ingle call. *
14660 2a 20 74 6f 20 74 68 65 20 78 52 61 6e 64 6f 6d * to the xRandom
14670 6e 65 73 73 20 6d 65 74 68 6f 64 20 6f 66 20 74 ness method of t
14680 68 65 20 64 65 66 61 75 6c 74 20 56 46 53 2e 0a he default VFS..
14690 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
146a0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
146b0 50 52 4e 47 5f 52 45 53 45 54 3a 20 7b 0a 20 20 PRNG_RESET: {.
146c0 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 52 sqlite3PrngR
146d0 65 73 65 74 53 74 61 74 65 28 29 3b 0a 20 20 20 esetState();.
146e0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
146f0 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
14700 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
14710 74 72 6f 6c 28 42 49 54 56 45 43 5f 54 45 53 54 trol(BITVEC_TEST
14720 2c 20 73 69 7a 65 2c 20 70 72 6f 67 72 61 6d 29 , size, program)
14730 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 . **. ** R
14740 75 6e 20 61 20 74 65 73 74 20 61 67 61 69 6e 73 un a test agains
14750 74 20 61 20 42 69 74 76 65 63 20 6f 62 6a 65 63 t a Bitvec objec
14760 74 20 6f 66 20 73 69 7a 65 2e 20 20 54 68 65 20 t of size. The
14770 70 72 6f 67 72 61 6d 20 61 72 67 75 6d 65 6e 74 program argument
14780 0a 20 20 20 20 2a 2a 20 69 73 20 61 6e 20 61 72 . ** is an ar
14790 72 61 79 20 6f 66 20 69 6e 74 65 67 65 72 73 20 ray of integers
147a0 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 that defines the
147b0 20 74 65 73 74 2e 20 20 52 65 74 75 72 6e 20 2d test. Return -
147c0 31 20 6f 6e 20 61 0a 20 20 20 20 2a 2a 20 6d 65 1 on a. ** me
147d0 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
147e0 65 72 72 6f 72 2c 20 30 20 6f 6e 20 73 75 63 63 error, 0 on succ
147f0 65 73 73 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f ess, or non-zero
14800 20 66 6f 72 20 61 6e 20 65 72 72 6f 72 2e 0a 20 for an error..
14810 20 20 20 2a 2a 20 53 65 65 20 74 68 65 20 73 71 ** See the sq
14820 6c 69 74 65 33 42 69 74 76 65 63 42 75 69 6c 74 lite3BitvecBuilt
14830 69 6e 54 65 73 74 28 29 20 66 6f 72 20 61 64 64 inTest() for add
14840 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 itional informat
14850 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ion.. */.
14860 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
14870 43 54 52 4c 5f 42 49 54 56 45 43 5f 54 45 53 54 CTRL_BITVEC_TEST
14880 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a : {. int sz
14890 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
148a0 74 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 2a 61 t);. int *a
148b0 50 72 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 Prog = va_arg(ap
148c0 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 20 20 20 72 , int*);. r
148d0 63 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 c = sqlite3Bitve
148e0 63 42 75 69 6c 74 69 6e 54 65 73 74 28 73 7a 2c cBuiltinTest(sz,
148f0 20 61 50 72 6f 67 29 3b 0a 20 20 20 20 20 20 62 aProg);. b
14900 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
14910 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 /*. ** sqli
14920 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
14930 28 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 (BENIGN_MALLOC_H
14940 4f 4f 4b 53 2c 20 78 42 65 67 69 6e 2c 20 78 45 OOKS, xBegin, xE
14950 6e 64 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a nd). **. *
14960 2a 20 52 65 67 69 73 74 65 72 20 68 6f 6f 6b 73 * Register hooks
14970 20 74 6f 20 63 61 6c 6c 20 74 6f 20 69 6e 64 69 to call to indi
14980 63 61 74 65 20 77 68 69 63 68 20 6d 61 6c 6c 6f cate which mallo
14990 63 28 29 20 66 61 69 6c 75 72 65 73 20 0a 20 20 c() failures .
149a0 20 20 2a 2a 20 61 72 65 20 62 65 6e 69 67 6e 2e ** are benign.
149b0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
149c0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
149d0 5f 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 _BENIGN_MALLOC_H
149e0 4f 4f 4b 53 3a 20 7b 0a 20 20 20 20 20 20 74 79 OOKS: {. ty
149f0 70 65 64 65 66 20 76 6f 69 64 20 28 2a 76 6f 69 pedef void (*voi
14a00 64 5f 66 75 6e 63 74 69 6f 6e 29 28 76 6f 69 64 d_function)(void
14a10 29 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 );. void_fu
14a20 6e 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e 42 65 nction xBenignBe
14a30 67 69 6e 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f gin;. void_
14a40 66 75 6e 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e function xBenign
14a50 45 6e 64 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 End;. xBeni
14a60 67 6e 42 65 67 69 6e 20 3d 20 76 61 5f 61 72 67 gnBegin = va_arg
14a70 28 61 70 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 (ap, void_functi
14a80 6f 6e 29 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 on);. xBeni
14a90 67 6e 45 6e 64 20 3d 20 76 61 5f 61 72 67 28 61 gnEnd = va_arg(a
14aa0 70 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e p, void_function
14ab0 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
14ac0 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b BenignMallocHook
14ad0 73 28 78 42 65 6e 69 67 6e 42 65 67 69 6e 2c 20 s(xBenignBegin,
14ae0 78 42 65 6e 69 67 6e 45 6e 64 29 3b 0a 20 20 20 xBenignEnd);.
14af0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
14b00 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
14b10 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
14b20 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
14b30 43 54 52 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 CTRL_PENDING_BYT
14b40 45 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 E, unsigned int
14b50 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a X). **. **
14b60 20 53 65 74 20 74 68 65 20 50 45 4e 44 49 4e 47 Set the PENDING
14b70 20 62 79 74 65 20 74 6f 20 74 68 65 20 76 61 6c byte to the val
14b80 75 65 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65 ue in the argume
14b90 6e 74 2c 20 69 66 20 58 3e 30 2e 0a 20 20 20 20 nt, if X>0..
14ba0 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 ** Make no chang
14bb0 65 73 20 69 66 20 58 3d 3d 30 2e 20 20 52 65 74 es if X==0. Ret
14bc0 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 urn the value of
14bd0 20 74 68 65 20 70 65 6e 64 69 6e 67 20 62 79 74 the pending byt
14be0 65 0a 20 20 20 20 2a 2a 20 61 73 20 69 74 20 65 e. ** as it e
14bf0 78 69 73 74 69 6e 67 20 62 65 66 6f 72 65 20 74 xisting before t
14c00 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20 his routine was
14c10 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 called.. **.
14c20 20 20 20 2a 2a 20 49 4d 50 4f 52 54 41 4e 54 3a ** IMPORTANT:
14c30 20 20 43 68 61 6e 67 69 6e 67 20 74 68 65 20 50 Changing the P
14c40 45 4e 44 49 4e 47 20 62 79 74 65 20 66 72 6f 6d ENDING byte from
14c50 20 30 78 34 30 30 30 30 30 30 30 20 72 65 73 75 0x40000000 resu
14c60 6c 74 73 20 69 6e 0a 20 20 20 20 2a 2a 20 61 6e lts in. ** an
14c70 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 64 61 incompatible da
14c80 74 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 6d tabase file form
14c90 61 74 2e 20 20 43 68 61 6e 67 69 6e 67 20 74 68 at. Changing th
14ca0 65 20 50 45 4e 44 49 4e 47 20 62 79 74 65 0a 20 e PENDING byte.
14cb0 20 20 20 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 ** while any
14cc0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
14cd0 69 6f 6e 20 69 73 20 6f 70 65 6e 20 72 65 73 75 ion is open resu
14ce0 6c 74 73 20 69 6e 20 75 6e 64 65 66 69 6e 65 64 lts in undefined
14cf0 20 61 6e 64 0a 20 20 20 20 2a 2a 20 64 69 6c 65 and. ** dile
14d00 74 65 72 69 6f 75 73 20 62 65 68 61 76 69 6f 72 terious behavior
14d10 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
14d20 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
14d30 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 45 3a 20 L_PENDING_BYTE:
14d40 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 50 45 4e {. rc = PEN
14d50 44 49 4e 47 5f 42 59 54 45 3b 0a 23 69 66 6e 64 DING_BYTE;.#ifnd
14d60 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
14d70 53 44 0a 20 20 20 20 20 20 7b 0a 20 20 20 20 20 SD. {.
14d80 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 unsigned int
14d90 6e 65 77 56 61 6c 20 3d 20 76 61 5f 61 72 67 28 newVal = va_arg(
14da0 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 ap, unsigned int
14db0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e );. if( n
14dc0 65 77 56 61 6c 20 29 20 73 71 6c 69 74 65 33 50 ewVal ) sqlite3P
14dd0 65 6e 64 69 6e 67 42 79 74 65 20 3d 20 6e 65 77 endingByte = new
14de0 56 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e Val;. }.#en
14df0 64 69 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b dif. break;
14e00 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 . }.. /*.
14e10 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 ** sqlite3_t
14e20 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
14e30 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 TE_TESTCTRL_ASSE
14e40 52 54 2c 20 69 6e 74 20 58 29 0a 20 20 20 20 2a RT, int X). *
14e50 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 61 63 *. ** This ac
14e60 74 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 61 20 tion provides a
14e70 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 20 74 6f run-time test to
14e80 20 73 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 see whether or
14e90 6e 6f 74 0a 20 20 20 20 2a 2a 20 61 73 73 65 72 not. ** asser
14ea0 74 28 29 20 77 61 73 20 65 6e 61 62 6c 65 64 20 t() was enabled
14eb0 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e at compile-time.
14ec0 20 20 49 66 20 58 20 69 73 20 74 72 75 65 20 61 If X is true a
14ed0 6e 64 20 61 73 73 65 72 74 28 29 0a 20 20 20 20 nd assert().
14ee0 2a 2a 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 ** is enabled, t
14ef0 68 65 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 hen the return v
14f00 61 6c 75 65 20 69 73 20 74 72 75 65 2e 20 20 49 alue is true. I
14f10 66 20 58 20 69 73 20 74 72 75 65 20 61 6e 64 0a f X is true and.
14f20 20 20 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 ** assert()
14f30 69 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 is disabled, the
14f40 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c n the return val
14f50 75 65 20 69 73 20 7a 65 72 6f 2e 20 20 49 66 20 ue is zero. If
14f60 58 20 69 73 0a 20 20 20 20 2a 2a 20 66 61 6c 73 X is. ** fals
14f70 65 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 e and assert() i
14f80 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 s enabled, then
14f90 74 68 65 20 61 73 73 65 72 74 69 6f 6e 20 66 69 the assertion fi
14fa0 72 65 73 20 61 6e 64 20 74 68 65 0a 20 20 20 20 res and the.
14fb0 2a 2a 20 70 72 6f 63 65 73 73 20 61 62 6f 72 74 ** process abort
14fc0 73 2e 20 20 49 66 20 58 20 69 73 20 66 61 6c 73 s. If X is fals
14fd0 65 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 e and assert() i
14fe0 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e s disabled, then
14ff0 20 74 68 65 0a 20 20 20 20 2a 2a 20 72 65 74 75 the. ** retu
15000 72 6e 20 76 61 6c 75 65 20 69 73 20 7a 65 72 6f rn value is zero
15010 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
15020 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
15030 4c 5f 41 53 53 45 52 54 3a 20 7b 0a 20 20 20 20 L_ASSERT: {.
15040 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 78 volatile int x
15050 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 = 0;. asse
15060 72 74 28 20 28 78 20 3d 20 76 61 5f 61 72 67 28 rt( (x = va_arg(
15070 61 70 2c 69 6e 74 29 29 21 3d 30 20 29 3b 0a 20 ap,int))!=0 );.
15080 20 20 20 20 20 72 63 20 3d 20 78 3b 0a 20 20 20 rc = x;.
15090 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
150a0 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
150b0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
150c0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
150d0 54 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 69 6e TCTRL_ALWAYS, in
150e0 74 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t X). **.
150f0 2a 2a 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 ** This action p
15100 72 6f 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 rovides a run-ti
15110 6d 65 20 74 65 73 74 20 74 6f 20 73 65 65 20 68 me test to see h
15120 6f 77 20 74 68 65 20 41 4c 57 41 59 53 20 61 6e ow the ALWAYS an
15130 64 0a 20 20 20 20 2a 2a 20 4e 45 56 45 52 20 6d d. ** NEVER m
15140 61 63 72 6f 73 20 77 65 72 65 20 64 65 66 69 6e acros were defin
15150 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ed at compile-ti
15160 6d 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a me.. **. *
15170 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c * The return val
15180 75 65 20 69 73 20 41 4c 57 41 59 53 28 58 29 2e ue is ALWAYS(X).
15190 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a . **. **
151a0 20 54 68 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 The recommended
151b0 20 74 65 73 74 20 69 73 20 58 3d 3d 32 2e 20 20 test is X==2.
151c0 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 If the return va
151d0 6c 75 65 20 69 73 20 32 2c 20 74 68 61 74 20 6d lue is 2, that m
151e0 65 61 6e 73 0a 20 20 20 20 2a 2a 20 41 4c 57 41 eans. ** ALWA
151f0 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 YS() and NEVER()
15200 20 61 72 65 20 62 6f 74 68 20 6e 6f 2d 6f 70 20 are both no-op
15210 70 61 73 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 pass-through mac
15220 72 6f 73 2c 20 77 68 69 63 68 20 69 73 20 74 68 ros, which is th
15230 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 e. ** default
15240 20 73 65 74 74 69 6e 67 2e 20 20 49 66 20 74 68 setting. If th
15250 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 e return value i
15260 73 20 31 2c 20 74 68 65 6e 20 41 4c 57 41 59 53 s 1, then ALWAYS
15270 28 29 20 69 73 20 65 69 74 68 65 72 0a 20 20 20 () is either.
15280 20 2a 2a 20 68 61 72 64 2d 63 6f 64 65 64 20 74 ** hard-coded t
15290 6f 20 74 72 75 65 20 6f 72 20 65 6c 73 65 20 69 o true or else i
152a0 74 20 61 73 73 65 72 74 73 20 69 66 20 69 74 73 t asserts if its
152b0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c argument is fal
152c0 73 65 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 se.. ** The f
152d0 69 72 73 74 20 62 65 68 61 76 69 6f 72 20 28 68 irst behavior (h
152e0 61 72 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 ard-coded to tru
152f0 65 29 20 69 73 20 74 68 65 20 63 61 73 65 20 69 e) is the case i
15300 66 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f f. ** SQLITE_
15310 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 20 TESTCTRL_ASSERT
15320 73 68 6f 77 73 20 74 68 61 74 20 61 73 73 65 72 shows that asser
15330 74 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 20 t() is disabled
15340 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 0a 20 and the second.
15350 20 20 20 2a 2a 20 62 65 68 61 76 69 6f 72 20 28 ** behavior (
15360 61 73 73 65 72 74 20 69 66 20 74 68 65 20 61 72 assert if the ar
15370 67 75 6d 65 6e 74 20 74 6f 20 41 4c 57 41 59 53 gument to ALWAYS
15380 28 29 20 69 73 20 66 61 6c 73 65 29 20 69 73 20 () is false) is
15390 74 68 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 the case if.
153a0 2a 2a 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ** SQLITE_TESTCT
153b0 52 4c 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 RL_ASSERT shows
153c0 74 68 61 74 20 61 73 73 65 72 74 28 29 20 69 73 that assert() is
153d0 20 65 6e 61 62 6c 65 64 2e 0a 20 20 20 20 2a 2a enabled.. **
153e0 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 75 6e 2d . ** The run-
153f0 74 69 6d 65 20 74 65 73 74 20 70 72 6f 63 65 64 time test proced
15400 75 72 65 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 73 ure might look s
15410 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 omething like th
15420 69 73 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a is:. **. *
15430 2a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 * if( sqlite3
15440 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 _test_control(SQ
15450 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c LITE_TESTCTRL_AL
15460 57 41 59 53 2c 20 32 29 3d 3d 32 20 29 7b 0a 20 WAYS, 2)==2 ){.
15470 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c ** // AL
15480 57 41 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 WAYS() and NEVER
15490 28 29 20 61 72 65 20 6e 6f 2d 6f 70 20 70 61 73 () are no-op pas
154a0 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 s-through macros
154b0 0a 20 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 . ** }else
154c0 20 69 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 if( sqlite3_tes
154d0 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
154e0 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 _TESTCTRL_ASSERT
154f0 2c 20 31 29 20 29 7b 0a 20 20 20 20 2a 2a 20 20 , 1) ){. **
15500 20 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 // ALWAYS(x)
15510 20 61 73 73 65 72 74 73 20 74 68 61 74 20 78 20 asserts that x
15520 69 73 20 74 72 75 65 2e 20 4e 45 56 45 52 28 78 is true. NEVER(x
15530 29 20 61 73 73 65 72 74 73 20 78 20 69 73 20 66 ) asserts x is f
15540 61 6c 73 65 2e 0a 20 20 20 20 2a 2a 20 20 20 20 alse.. **
15550 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 2a 20 20 20 }else{. **
15560 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 // ALWAYS(x)
15570 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 31 2e is a constant 1.
15580 20 20 4e 45 56 45 52 28 78 29 20 69 73 20 61 20 NEVER(x) is a
15590 63 6f 6e 73 74 61 6e 74 20 30 2e 0a 20 20 20 20 constant 0..
155a0 2a 2a 20 20 20 20 7d 0a 20 20 20 20 2a 2f 0a 20 ** }. */.
155b0 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
155c0 45 53 54 43 54 52 4c 5f 41 4c 57 41 59 53 3a 20 ESTCTRL_ALWAYS:
155d0 7b 0a 20 20 20 20 20 20 69 6e 74 20 78 20 3d 20 {. int x =
155e0 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a va_arg(ap,int);.
155f0 20 20 20 20 20 20 72 63 20 3d 20 41 4c 57 41 59 rc = ALWAY
15600 53 28 78 29 3b 0a 20 20 20 20 20 20 62 72 65 61 S(x);. brea
15610 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
15620 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f sqlite3_test_
15630 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
15640 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 2c ESTCTRL_RESERVE,
15650 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e sqlite3 *db, in
15660 74 20 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t N). **.
15670 2a 2a 20 53 65 74 20 74 68 65 20 6e 52 65 73 65 ** Set the nRese
15680 72 76 65 20 73 69 7a 65 20 74 6f 20 4e 20 66 6f rve size to N fo
15690 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 r the main datab
156a0 61 73 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 ase on the datab
156b0 61 73 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 ase. ** conne
156c0 63 74 69 6f 6e 20 64 62 2e 0a 20 20 20 20 2a 2f ction db.. */
156d0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
156e0 5f 54 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 _TESTCTRL_RESERV
156f0 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 E: {. sqlit
15700 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 e3 *db = va_arg(
15710 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 ap, sqlite3*);.
15720 20 20 20 20 20 69 6e 74 20 78 20 3d 20 76 61 5f int x = va_
15730 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 arg(ap,int);.
15740 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
15750 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
15760 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
15770 42 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 BtreeSetPageSize
15780 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c (db->aDb[0].pBt,
15790 20 30 2c 20 78 2c 20 30 29 3b 0a 20 20 20 20 20 0, x, 0);.
157a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
157b0 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
157c0 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
157d0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c }.. /* sql
157e0 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
157f0 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
15800 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c L_OPTIMIZATIONS,
15810 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e sqlite3 *db, in
15820 74 20 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t N). **.
15830 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 ** Enable or dis
15840 61 62 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 74 able various opt
15850 69 6d 69 7a 61 74 69 6f 6e 73 20 66 6f 72 20 74 imizations for t
15860 65 73 74 69 6e 67 20 70 75 72 70 6f 73 65 73 2e esting purposes.
15870 20 20 54 68 65 20 0a 20 20 20 20 2a 2a 20 61 72 The . ** ar
15880 67 75 6d 65 6e 74 20 4e 20 69 73 20 61 20 62 69 gument N is a bi
15890 74 6d 61 73 6b 20 6f 66 20 6f 70 74 69 6d 69 7a tmask of optimiz
158a0 61 74 69 6f 6e 73 20 74 6f 20 62 65 20 64 69 73 ations to be dis
158b0 61 62 6c 65 64 2e 20 20 46 6f 72 20 6e 6f 72 6d abled. For norm
158c0 61 6c 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 al. ** operat
158d0 69 6f 6e 20 4e 20 73 68 6f 75 6c 64 20 62 65 20 ion N should be
158e0 30 2e 20 20 54 68 65 20 69 64 65 61 20 69 73 20 0. The idea is
158f0 74 68 61 74 20 61 20 74 65 73 74 20 70 72 6f 67 that a test prog
15900 72 61 6d 20 28 6c 69 6b 65 20 74 68 65 0a 20 20 ram (like the.
15910 20 20 2a 2a 20 53 51 4c 20 4c 6f 67 69 63 20 54 ** SQL Logic T
15920 65 73 74 20 6f 72 20 53 4c 54 20 74 65 73 74 20 est or SLT test
15930 6d 6f 64 75 6c 65 29 20 63 61 6e 20 72 75 6e 20 module) can run
15940 74 68 65 20 73 61 6d 65 20 53 51 4c 20 6d 75 6c the same SQL mul
15950 74 69 70 6c 65 20 74 69 6d 65 73 0a 20 20 20 20 tiple times.
15960 2a 2a 20 77 69 74 68 20 76 61 72 69 6f 75 73 20 ** with various
15970 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 64 69 optimizations di
15980 73 61 62 6c 65 64 20 74 6f 20 76 65 72 69 66 79 sabled to verify
15990 20 74 68 61 74 20 74 68 65 20 73 61 6d 65 20 61 that the same a
159a0 6e 73 77 65 72 0a 20 20 20 20 2a 2a 20 69 73 20 nswer. ** is
159b0 6f 62 74 61 69 6e 65 64 20 69 6e 20 65 76 65 72 obtained in ever
159c0 79 20 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 y case.. */.
159d0 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
159e0 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 ESTCTRL_OPTIMIZA
159f0 54 49 4f 4e 53 3a 20 7b 0a 20 20 20 20 20 20 73 TIONS: {. s
15a00 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f qlite3 *db = va_
15a10 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a arg(ap, sqlite3*
15a20 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 78 20 3d );. int x =
15a30 20 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b va_arg(ap,int);
15a40 0a 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 . db->flags
15a50 20 3d 20 28 78 20 26 20 53 51 4c 49 54 45 5f 4f = (x & SQLITE_O
15a60 70 74 4d 61 73 6b 29 20 7c 20 28 64 62 2d 3e 66 ptMask) | (db->f
15a70 6c 61 67 73 20 26 20 7e 53 51 4c 49 54 45 5f 4f lags & ~SQLITE_O
15a80 70 74 4d 61 73 6b 29 3b 0a 20 20 20 20 20 20 62 ptMask);. b
15a90 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 reak;. }..#if
15aa0 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 def SQLITE_N_KEY
15ab0 57 4f 52 44 0a 20 20 20 20 2f 2a 20 73 71 6c 69 WORD. /* sqli
15ac0 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
15ad0 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
15ae0 5f 49 53 4b 45 59 57 4f 52 44 2c 20 63 6f 6e 73 _ISKEYWORD, cons
15af0 74 20 63 68 61 72 20 2a 7a 57 6f 72 64 29 0a 20 t char *zWord).
15b00 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 **. ** If
15b10 7a 57 6f 72 64 20 69 73 20 61 20 6b 65 79 77 6f zWord is a keywo
15b20 72 64 20 72 65 63 6f 67 6e 69 7a 65 64 20 62 79 rd recognized by
15b30 20 74 68 65 20 70 61 72 73 65 72 2c 20 74 68 65 the parser, the
15b40 6e 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 20 n return the.
15b50 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 6b 65 ** number of ke
15b60 79 77 6f 72 64 73 2e 20 20 4f 72 20 69 66 20 7a ywords. Or if z
15b70 57 6f 72 64 20 69 73 20 6e 6f 74 20 61 20 6b 65 Word is not a ke
15b80 79 77 6f 72 64 2c 20 72 65 74 75 72 6e 20 30 2e yword, return 0.
15b90 0a 20 20 20 20 2a 2a 20 0a 20 20 20 20 2a 2a 20 . ** . **
15ba0 54 68 69 73 20 74 65 73 74 20 66 65 61 74 75 72 This test featur
15bb0 65 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 e is only availa
15bc0 62 6c 65 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 ble in the amalg
15bd0 61 6d 61 74 69 6f 6e 20 73 69 6e 63 65 0a 20 20 amation since.
15be0 20 20 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f ** the SQLITE_
15bf0 4e 5f 4b 45 59 57 4f 52 44 20 6d 61 63 72 6f 20 N_KEYWORD macro
15c00 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 69 is not defined i
15c10 6e 20 74 68 69 73 20 66 69 6c 65 20 69 66 20 53 n this file if S
15c20 51 4c 69 74 65 0a 20 20 20 20 2a 2a 20 69 73 20 QLite. ** is
15c30 62 75 69 6c 74 20 75 73 69 6e 67 20 73 65 70 61 built using sepa
15c40 72 61 74 65 20 73 6f 75 72 63 65 20 66 69 6c 65 rate source file
15c50 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
15c60 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
15c70 52 4c 5f 49 53 4b 45 59 57 4f 52 44 3a 20 7b 0a RL_ISKEYWORD: {.
15c80 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 const char
15c90 20 2a 7a 57 6f 72 64 20 3d 20 76 61 5f 61 72 67 *zWord = va_arg
15ca0 28 61 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a (ap, const char*
15cb0 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 3d );. int n =
15cc0 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
15cd0 28 7a 57 6f 72 64 29 3b 0a 20 20 20 20 20 20 72 (zWord);. r
15ce0 63 20 3d 20 28 73 71 6c 69 74 65 33 4b 65 79 77 c = (sqlite3Keyw
15cf0 6f 72 64 43 6f 64 65 28 28 75 38 2a 29 7a 57 6f ordCode((u8*)zWo
15d00 72 64 2c 20 6e 29 21 3d 54 4b 5f 49 44 29 20 3f rd, n)!=TK_ID) ?
15d10 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 SQLITE_N_KEYWOR
15d20 44 20 3a 20 30 3b 0a 20 20 20 20 20 20 62 72 65 D : 0;. bre
15d30 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 ak;. }.#endif
15d40 20 0a 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 .. /* sqlite
15d50 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
15d60 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 QLITE_TESTCTRL_P
15d70 47 48 44 52 53 5a 29 0a 20 20 20 20 2a 2a 0a 20 GHDRSZ). **.
15d80 20 20 20 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 ** Return the
15d90 20 73 69 7a 65 20 6f 66 20 61 20 70 63 61 63 68 size of a pcach
15da0 65 20 68 65 61 64 65 72 20 69 6e 20 62 79 74 65 e header in byte
15db0 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
15dc0 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
15dd0 52 4c 5f 50 47 48 44 52 53 5a 3a 20 7b 0a 20 20 RL_PGHDRSZ: {.
15de0 20 20 20 20 72 63 20 3d 20 73 69 7a 65 6f 66 28 rc = sizeof(
15df0 50 67 48 64 72 29 3b 0a 20 20 20 20 20 20 62 72 PgHdr);. br
15e00 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
15e10 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f /* sqlite3_test_
15e20 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
15e30 45 53 54 43 54 52 4c 5f 53 43 52 41 54 43 48 4d ESTCTRL_SCRATCHM
15e40 41 4c 4c 4f 43 2c 20 73 7a 2c 20 26 70 4e 65 77 ALLOC, sz, &pNew
15e50 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 20 2a 2a , pFree);. **
15e60 0a 20 20 20 20 2a 2a 20 50 61 73 73 20 70 46 72 . ** Pass pFr
15e70 65 65 20 69 6e 74 6f 20 73 71 6c 69 74 65 33 53 ee into sqlite3S
15e80 63 72 61 74 63 68 46 72 65 65 28 29 2e 20 0a 20 cratchFree(). .
15e90 20 20 20 2a 2a 20 49 66 20 73 7a 3e 30 20 74 68 ** If sz>0 th
15ea0 65 6e 20 61 6c 6c 6f 63 61 74 65 20 61 20 73 63 en allocate a sc
15eb0 72 61 74 63 68 20 62 75 66 66 65 72 20 69 6e 74 ratch buffer int
15ec0 6f 20 70 4e 65 77 2e 20 20 0a 20 20 20 20 2a 2f o pNew. . */
15ed0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
15ee0 5f 54 45 53 54 43 54 52 4c 5f 53 43 52 41 54 43 _TESTCTRL_SCRATC
15ef0 48 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 20 20 HMALLOC: {.
15f00 20 76 6f 69 64 20 2a 70 46 72 65 65 2c 20 2a 2a void *pFree, **
15f10 70 70 4e 65 77 3b 0a 20 20 20 20 20 20 69 6e 74 ppNew;. int
15f20 20 73 7a 3b 0a 20 20 20 20 20 20 73 7a 20 3d 20 sz;. sz =
15f30 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
15f40 0a 20 20 20 20 20 20 70 70 4e 65 77 20 3d 20 76 . ppNew = v
15f50 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 2a a_arg(ap, void**
15f60 29 3b 0a 20 20 20 20 20 20 70 46 72 65 65 20 3d );. pFree =
15f70 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
15f80 2a 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 7a *);. if( sz
15f90 20 29 20 2a 70 70 4e 65 77 20 3d 20 73 71 6c 69 ) *ppNew = sqli
15fa0 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f 63 te3ScratchMalloc
15fb0 28 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 (sz);. sqli
15fc0 74 65 33 53 63 72 61 74 63 68 46 72 65 65 28 70 te3ScratchFree(p
15fd0 46 72 65 65 29 3b 0a 20 20 20 20 20 20 62 72 65 Free);. bre
15fe0 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
15ff0 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 * sqlite3_test
16000 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
16010 54 45 53 54 43 54 52 4c 5f 4c 4f 43 41 4c 54 49 TESTCTRL_LOCALTI
16020 4d 45 5f 46 41 55 4c 54 2c 20 69 6e 74 20 6f 6e ME_FAULT, int on
16030 6f 66 66 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 off);. **.
16040 20 2a 2a 20 49 66 20 70 61 72 61 6d 65 74 65 72 ** If parameter
16050 20 6f 6e 6f 66 66 20 69 73 20 6e 6f 6e 2d 7a 65 onoff is non-ze
16060 72 6f 2c 20 63 6f 6e 66 69 67 75 72 65 20 74 68 ro, configure th
16070 65 20 77 72 61 70 70 65 72 73 20 73 6f 20 74 68 e wrappers so th
16080 61 74 20 61 6c 6c 0a 20 20 20 20 2a 2a 20 73 75 at all. ** su
16090 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 bsequent calls t
160a0 6f 20 6c 6f 63 61 6c 74 69 6d 65 28 29 20 61 6e o localtime() an
160b0 64 20 76 61 72 69 61 6e 74 73 20 66 61 69 6c 2e d variants fail.
160c0 20 49 66 20 6f 6e 6f 66 66 20 69 73 20 7a 65 72 If onoff is zer
160d0 6f 2c 0a 20 20 20 20 2a 2a 20 75 6e 64 6f 20 74 o,. ** undo t
160e0 68 69 73 20 73 65 74 74 69 6e 67 2e 0a 20 20 20 his setting..
160f0 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
16100 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4c 4f 43 ITE_TESTCTRL_LOC
16110 41 4c 54 49 4d 45 5f 46 41 55 4c 54 3a 20 7b 0a ALTIME_FAULT: {.
16120 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
16130 62 61 6c 43 6f 6e 66 69 67 2e 62 4c 6f 63 61 6c balConfig.bLocal
16140 74 69 6d 65 46 61 75 6c 74 20 3d 20 76 61 5f 61 timeFault = va_a
16150 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
16160 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
16170 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 . }. va_end(ap
16180 29 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c );.#endif /* SQL
16190 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e ITE_OMIT_BUILTIN
161a0 5f 54 45 53 54 20 2a 2f 0a 20 20 72 65 74 75 72 _TEST */. retur
161b0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
161c0 68 69 73 20 69 73 20 61 20 75 74 69 6c 69 74 79 his is a utility
161d0 20 72 6f 75 74 69 6e 65 2c 20 75 73 65 66 75 6c routine, useful
161e0 20 74 6f 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e to VFS implemen
161f0 74 61 74 69 6f 6e 73 2c 20 74 68 61 74 20 63 68 tations, that ch
16200 65 63 6b 73 0a 2a 2a 20 74 6f 20 73 65 65 20 69 ecks.** to see i
16210 66 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c f a database fil
16220 65 20 77 61 73 20 61 20 55 52 49 20 74 68 61 74 e was a URI that
16230 20 63 6f 6e 74 61 69 6e 65 64 20 61 20 73 70 65 contained a spe
16240 63 69 66 69 63 20 71 75 65 72 79 20 0a 2a 2a 20 cific query .**
16250 70 61 72 61 6d 65 74 65 72 2c 20 61 6e 64 20 69 parameter, and i
16260 66 20 73 6f 20 6f 62 74 61 69 6e 73 20 74 68 65 f so obtains the
16270 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 71 75 value of the qu
16280 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a ery parameter..*
16290 2a 0a 2a 2a 20 54 68 65 20 7a 46 69 6c 65 6e 61 *.** The zFilena
162a0 6d 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 me argument is t
162b0 68 65 20 66 69 6c 65 6e 61 6d 65 20 70 6f 69 6e he filename poin
162c0 74 65 72 20 70 61 73 73 65 64 20 69 6e 74 6f 20 ter passed into
162d0 74 68 65 20 78 4f 70 65 6e 28 29 0a 2a 2a 20 6d the xOpen().** m
162e0 65 74 68 6f 64 20 6f 66 20 61 20 56 46 53 20 69 ethod of a VFS i
162f0 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 mplementation.
16300 54 68 65 20 7a 50 61 72 61 6d 20 61 72 67 75 6d The zParam argum
16310 65 6e 74 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ent is the name
16320 6f 66 20 74 68 65 0a 2a 2a 20 71 75 65 72 79 20 of the.** query
16330 70 61 72 61 6d 65 74 65 72 20 77 65 20 73 65 65 parameter we see
16340 6b 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 k. This routine
16350 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c returns the val
16360 75 65 20 6f 66 20 74 68 65 20 7a 50 61 72 61 6d ue of the zParam
16370 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 66 .** parameter if
16380 20 69 74 20 65 78 69 73 74 73 2e 20 20 49 66 20 it exists. If
16390 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 64 6f the parameter do
163a0 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 74 68 es not exist, th
163b0 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 is routine.** re
163c0 74 75 72 6e 73 20 61 20 4e 55 4c 4c 20 70 6f 69 turns a NULL poi
163d0 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 nter..*/.const c
163e0 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 75 72 69 har *sqlite3_uri
163f0 5f 70 61 72 61 6d 65 74 65 72 28 63 6f 6e 73 74 _parameter(const
16400 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
16410 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 , const char *zP
16420 61 72 61 6d 29 7b 0a 20 20 7a 46 69 6c 65 6e 61 aram){. zFilena
16430 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 me += sqlite3Str
16440 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 len30(zFilename)
16450 20 2b 20 31 3b 0a 20 20 77 68 69 6c 65 28 20 7a + 1;. while( z
16460 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 Filename[0] ){.
16470 20 20 20 69 6e 74 20 78 20 3d 20 73 74 72 63 6d int x = strcm
16480 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 p(zFilename, zPa
16490 72 61 6d 29 3b 0a 20 20 20 20 7a 46 69 6c 65 6e ram);. zFilen
164a0 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 ame += sqlite3St
164b0 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 rlen30(zFilename
164c0 29 20 2b 20 31 3b 0a 20 20 20 20 69 66 28 20 78 ) + 1;. if( x
164d0 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 7a 46 69 ==0 ) return zFi
164e0 6c 65 6e 61 6d 65 3b 0a 20 20 20 20 7a 46 69 6c lename;. zFil
164f0 65 6e 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 ename += sqlite3
16500 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 Strlen30(zFilena
16510 6d 65 29 20 2b 20 31 3b 0a 20 20 7d 0a 20 20 72 me) + 1;. }. r
16520 65 74 75 72 6e 20 30 3b 0a 7d 0a eturn 0;.}.