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 23 69 66 64 u.h".#endif.#ifd
0320: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
0330: 5f 4a 53 4f 4e 31 0a 69 6e 74 20 73 71 6c 69 74 _JSON1.int sqlit
0340: 65 33 4a 73 6f 6e 31 49 6e 69 74 28 73 71 6c 69 e3Json1Init(sqli
0350: 74 65 33 2a 29 3b 0a 23 65 6e 64 69 66 0a 23 69 te3*);.#endif.#i
0360: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
0370: 4c 45 5f 53 54 4d 54 53 56 54 41 42 0a 69 6e 74 LE_STMTSVTAB.int
0380: 20 73 71 6c 69 74 65 33 53 74 6d 74 73 56 74 61 sqlite3StmtsVta
0390: 62 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b bInit(sqlite3*);
03a0: 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 .#endif.#ifdef S
03b0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 QLITE_ENABLE_FTS
03c0: 35 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 5.int sqlite3Fts
03d0: 35 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 5Init(sqlite3*);
03e0: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 .#endif..#ifndef
03f0: 20 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 SQLITE_AMALGAMA
0400: 54 49 4f 4e 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e TION./* IMPLEMEN
0410: 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 34 36 36 TATION-OF: R-466
0420: 35 36 2d 34 35 31 35 36 20 54 68 65 20 73 71 6c 56-45156 The sql
0430: 69 74 65 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 73 ite3_version[] s
0440: 74 72 69 6e 67 20 63 6f 6e 73 74 61 6e 74 0a 2a tring constant.*
0450: 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 74 * contains the t
0460: 65 78 74 20 6f 66 20 53 51 4c 49 54 45 5f 56 45 ext of SQLITE_VE
0470: 52 53 49 4f 4e 20 6d 61 63 72 6f 2e 20 0a 2a 2f RSION macro. .*/
0480: 0a 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 .const char sqli
0490: 74 65 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 te3_version[] =
04a0: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a SQLITE_VERSION;.
04b0: 23 65 6e 64 69 66 0a 0a 2f 2a 20 49 4d 50 4c 45 #endif../* IMPLE
04c0: 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d MENTATION-OF: R-
04d0: 35 33 35 33 36 2d 34 32 35 37 35 20 54 68 65 20 53536-42575 The
04e0: 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 sqlite3_libversi
04f0: 6f 6e 28 29 20 66 75 6e 63 74 69 6f 6e 20 72 65 on() function re
0500: 74 75 72 6e 73 0a 2a 2a 20 61 20 70 6f 69 6e 74 turns.** a point
0510: 65 72 20 74 6f 20 74 68 65 20 74 6f 20 74 68 65 er to the to the
0520: 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e sqlite3_version
0530: 5b 5d 20 73 74 72 69 6e 67 20 63 6f 6e 73 74 61 [] string consta
0540: 6e 74 2e 20 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 nt. .*/.const ch
0550: 61 72 20 2a 73 71 6c 69 74 65 33 5f 6c 69 62 76 ar *sqlite3_libv
0560: 65 72 73 69 6f 6e 28 76 6f 69 64 29 7b 20 72 65 ersion(void){ re
0570: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 65 72 turn sqlite3_ver
0580: 73 69 6f 6e 3b 20 7d 0a 0a 2f 2a 20 49 4d 50 4c sion; }../* IMPL
0590: 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 EMENTATION-OF: R
05a0: 2d 36 33 31 32 34 2d 33 39 33 30 30 20 54 68 65 -63124-39300 The
05b0: 20 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 sqlite3_sourcei
05c0: 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 d() function ret
05d0: 75 72 6e 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 urns a.** pointe
05e0: 72 20 74 6f 20 61 20 73 74 72 69 6e 67 20 63 6f r to a string co
05f0: 6e 73 74 61 6e 74 20 77 68 6f 73 65 20 76 61 6c nstant whose val
0600: 75 65 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 ue is the same a
0610: 73 20 74 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f s the.** SQLITE_
0620: 53 4f 55 52 43 45 5f 49 44 20 43 20 70 72 65 70 SOURCE_ID C prep
0630: 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e 20 rocessor macro.
0640: 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
0650: 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 64 sqlite3_sourceid
0660: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 (void){ return S
0670: 51 4c 49 54 45 5f 53 4f 55 52 43 45 5f 49 44 3b QLITE_SOURCE_ID;
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 33 35 32 31 ATION-OF: R-3521
06a0: 30 2d 36 33 35 30 38 20 54 68 65 20 73 71 6c 69 0-63508 The sqli
06b0: 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e te3_libversion_n
06c0: 75 6d 62 65 72 28 29 20 66 75 6e 63 74 69 6f 6e umber() function
06d0: 0a 2a 2a 20 72 65 74 75 72 6e 73 20 61 6e 20 69 .** returns an i
06e0: 6e 74 65 67 65 72 20 65 71 75 61 6c 20 74 6f 20 nteger equal to
06f0: 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e SQLITE_VERSION_N
0700: 55 4d 42 45 52 2e 0a 2a 2f 0a 69 6e 74 20 73 71 UMBER..*/.int sq
0710: 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e lite3_libversion
0720: 5f 6e 75 6d 62 65 72 28 76 6f 69 64 29 7b 20 72 _number(void){ r
0730: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 56 45 52 eturn SQLITE_VER
0740: 53 49 4f 4e 5f 4e 55 4d 42 45 52 3b 20 7d 0a 0a SION_NUMBER; }..
0750: 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f /* IMPLEMENTATIO
0760: 4e 2d 4f 46 3a 20 52 2d 32 30 37 39 30 2d 31 34 N-OF: R-20790-14
0770: 30 32 35 20 54 68 65 20 73 71 6c 69 74 65 33 5f 025 The sqlite3_
0780: 74 68 72 65 61 64 73 61 66 65 28 29 20 66 75 6e threadsafe() fun
0790: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a ction returns.**
07a0: 20 7a 65 72 6f 20 69 66 20 61 6e 64 20 6f 6e 6c zero if and onl
07b0: 79 20 69 66 20 53 51 4c 69 74 65 20 77 61 73 20 y if SQLite was
07c0: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 6d 75 compiled with mu
07d0: 74 65 78 69 6e 67 20 63 6f 64 65 20 6f 6d 69 74 texing code omit
07e0: 74 65 64 20 64 75 65 20 74 6f 0a 2a 2a 20 74 68 ted due to.** th
07f0: 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 e SQLITE_THREADS
0800: 41 46 45 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 AFE compile-time
0810: 20 6f 70 74 69 6f 6e 20 62 65 69 6e 67 20 73 65 option being se
0820: 74 20 74 6f 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 t to 0..*/.int s
0830: 71 6c 69 74 65 33 5f 74 68 72 65 61 64 73 61 66 qlite3_threadsaf
0840: 65 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 e(void){ return
0850: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 SQLITE_THREADSAF
0860: 45 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e E; }../*.** When
0870: 20 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 74 compiling the t
0880: 65 73 74 20 66 69 78 74 75 72 65 20 6f 72 20 77 est fixture or w
0890: 69 74 68 20 64 65 62 75 67 67 69 6e 67 20 65 6e ith debugging en
08a0: 61 62 6c 65 64 20 28 6f 6e 20 57 69 6e 33 32 29 abled (on Win32)
08b0: 2c 0a 2a 2a 20 74 68 69 73 20 76 61 72 69 61 62 ,.** this variab
08c0: 6c 65 20 62 65 69 6e 67 20 73 65 74 20 74 6f 20 le being set to
08d0: 6e 6f 6e 2d 7a 65 72 6f 20 77 69 6c 6c 20 63 61 non-zero will ca
08e0: 75 73 65 20 4f 53 54 52 41 43 45 20 6d 61 63 72 use OSTRACE macr
08f0: 6f 73 20 74 6f 20 65 6d 69 74 0a 2a 2a 20 65 78 os to emit.** ex
0900: 74 72 61 20 64 69 61 67 6e 6f 73 74 69 63 20 69 tra diagnostic i
0910: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 nformation..*/.#
0920: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 56 ifdef SQLITE_HAV
0930: 45 5f 4f 53 5f 54 52 41 43 45 0a 23 20 69 66 6e E_OS_TRACE.# ifn
0940: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
0950: 5f 4f 53 5f 54 52 41 43 45 0a 23 20 20 20 64 65 _OS_TRACE.# de
0960: 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 42 55 fine SQLITE_DEBU
0970: 47 5f 4f 53 5f 54 52 41 43 45 20 30 0a 23 20 65 G_OS_TRACE 0.# e
0980: 6e 64 69 66 0a 20 20 69 6e 74 20 73 71 6c 69 74 ndif. int sqlit
0990: 65 33 4f 53 54 72 61 63 65 20 3d 20 53 51 4c 49 e3OSTrace = SQLI
09a0: 54 45 5f 44 45 42 55 47 5f 4f 53 5f 54 52 41 43 TE_DEBUG_OS_TRAC
09b0: 45 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 21 E;.#endif..#if !
09c0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
09d0: 4d 49 54 5f 54 52 41 43 45 29 20 26 26 20 64 65 MIT_TRACE) && de
09e0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
09f0: 42 4c 45 5f 49 4f 54 52 41 43 45 29 0a 2f 2a 0a BLE_IOTRACE)./*.
0a00: 2a 2a 20 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ** If the follow
0a10: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 ing function poi
0a20: 6e 74 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c nter is not NULL
0a30: 20 61 6e 64 20 69 66 0a 2a 2a 20 53 51 4c 49 54 and if.** SQLIT
0a40: 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 E_ENABLE_IOTRACE
0a50: 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 is enabled, the
0a60: 6e 20 6d 65 73 73 61 67 65 73 20 64 65 73 63 72 n messages descr
0a70: 69 62 69 6e 67 0a 2a 2a 20 49 2f 4f 20 61 63 74 ibing.** I/O act
0a80: 69 76 65 20 61 72 65 20 77 72 69 74 74 65 6e 20 ive are written
0a90: 75 73 69 6e 67 20 74 68 69 73 20 66 75 6e 63 74 using this funct
0aa0: 69 6f 6e 2e 20 20 54 68 65 73 65 20 6d 65 73 73 ion. These mess
0ab0: 61 67 65 73 0a 2a 2a 20 61 72 65 20 69 6e 74 65 ages.** are inte
0ac0: 6e 64 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 nded for debuggi
0ad0: 6e 67 20 61 63 74 69 76 69 74 79 20 6f 6e 6c 79 ng activity only
0ae0: 2e 0a 2a 2f 0a 53 51 4c 49 54 45 5f 41 50 49 20 ..*/.SQLITE_API
0af0: 76 6f 69 64 20 28 53 51 4c 49 54 45 5f 43 44 45 void (SQLITE_CDE
0b00: 43 4c 20 2a 73 71 6c 69 74 65 33 49 6f 54 72 61 CL *sqlite3IoTra
0b10: 63 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ce)(const char*,
0b20: 20 2e 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e 64 69 ...) = 0;.#endi
0b30: 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 f../*.** If the
0b40: 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c following global
0b50: 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 variable points
0b60: 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 to a string whi
0b70: 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d ch is the.** nam
0b80: 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 e of a directory
0b90: 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 , then that dire
0ba0: 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 ctory will be us
0bb0: 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 ed to store.** t
0bc0: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a emporary files..
0bd0: 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 **.** See also t
0be0: 68 65 20 22 50 52 41 47 4d 41 20 74 65 6d 70 5f he "PRAGMA temp_
0bf0: 73 74 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 store_directory"
0c00: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f SQL command..*/
0c10: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 .char *sqlite3_t
0c20: 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 emp_directory =
0c30: 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 0;../*.** If the
0c40: 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 following globa
0c50: 6c 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 l variable point
0c60: 73 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 s to a string wh
0c70: 69 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 ich is the.** na
0c80: 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 me of a director
0c90: 79 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 y, then that dir
0ca0: 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 ectory will be u
0cb0: 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 sed to store.**
0cc0: 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c all database fil
0cd0: 65 73 20 73 70 65 63 69 66 69 65 64 20 77 69 74 es specified wit
0ce0: 68 20 61 20 72 65 6c 61 74 69 76 65 20 70 61 74 h a relative pat
0cf0: 68 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 hname..**.** See
0d00: 20 61 6c 73 6f 20 74 68 65 20 22 50 52 41 47 4d also the "PRAGM
0d10: 41 20 64 61 74 61 5f 73 74 6f 72 65 5f 64 69 72 A data_store_dir
0d20: 65 63 74 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d ectory" SQL comm
0d30: 61 6e 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 and..*/.char *sq
0d40: 6c 69 74 65 33 5f 64 61 74 61 5f 64 69 72 65 63 lite3_data_direc
0d50: 74 6f 72 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a tory = 0;../*.**
0d60: 20 49 6e 69 74 69 61 6c 69 7a 65 20 53 51 4c 69 Initialize SQLi
0d70: 74 65 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 te. .**.** This
0d80: 20 72 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 65 routine must be
0d90: 20 63 61 6c 6c 65 64 20 74 6f 20 69 6e 69 74 69 called to initi
0da0: 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 alize the memory
0db0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 allocation,.**
0dc0: 56 46 53 2c 20 61 6e 64 20 6d 75 74 65 78 20 73 VFS, and mutex s
0dd0: 75 62 73 79 73 74 65 6d 73 20 70 72 69 6f 72 20 ubsystems prior
0de0: 74 6f 20 64 6f 69 6e 67 20 61 6e 79 20 73 65 72 to doing any ser
0df0: 69 6f 75 73 20 77 6f 72 6b 20 77 69 74 68 0a 2a ious work with.*
0e00: 2a 20 53 51 4c 69 74 65 2e 20 20 42 75 74 20 61 * SQLite. But a
0e10: 73 20 6c 6f 6e 67 20 61 73 20 79 6f 75 20 64 6f s long as you do
0e20: 20 6e 6f 74 20 63 6f 6d 70 69 6c 65 20 77 69 74 not compile wit
0e30: 68 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 h SQLITE_OMIT_AU
0e40: 54 4f 49 4e 49 54 0a 2a 2a 20 74 68 69 73 20 72 TOINIT.** this r
0e50: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 62 65 20 63 outine will be c
0e60: 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61 alled automatica
0e70: 6c 6c 79 20 62 79 20 6b 65 79 20 72 6f 75 74 69 lly by key routi
0e80: 6e 65 73 20 73 75 63 68 20 61 73 0a 2a 2a 20 73 nes such as.** s
0e90: 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 20 20 qlite3_open().
0ea0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
0eb0: 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 65 ine is a no-op e
0ec0: 78 63 65 70 74 20 6f 6e 20 69 74 73 20 76 65 72 xcept on its ver
0ed0: 79 20 66 69 72 73 74 20 63 61 6c 6c 20 66 6f 72 y first call for
0ee0: 20 74 68 65 20 70 72 6f 63 65 73 73 2c 0a 2a 2a the process,.**
0ef0: 20 6f 72 20 66 6f 72 20 74 68 65 20 66 69 72 73 or for the firs
0f00: 74 20 63 61 6c 6c 20 61 66 74 65 72 20 61 20 63 t call after a c
0f10: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 73 all to sqlite3_s
0f20: 68 75 74 64 6f 77 6e 2e 0a 2a 2a 0a 2a 2a 20 54 hutdown..**.** T
0f30: 68 65 20 66 69 72 73 74 20 74 68 72 65 61 64 20 he first thread
0f40: 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 to call this rou
0f50: 74 69 6e 65 20 72 75 6e 73 20 74 68 65 20 69 6e tine runs the in
0f60: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 74 6f 0a itialization to.
0f70: 2a 2a 20 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 20 ** completion.
0f80: 49 66 20 73 75 62 73 65 71 75 65 6e 74 20 74 68 If subsequent th
0f90: 72 65 61 64 73 20 63 61 6c 6c 20 74 68 69 73 20 reads call this
0fa0: 72 6f 75 74 69 6e 65 20 62 65 66 6f 72 65 20 74 routine before t
0fb0: 68 65 20 66 69 72 73 74 0a 2a 2a 20 74 68 72 65 he first.** thre
0fc0: 61 64 20 68 61 73 20 66 69 6e 69 73 68 65 64 20 ad has finished
0fd0: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 the initializati
0fe0: 6f 6e 20 70 72 6f 63 65 73 73 2c 20 74 68 65 6e on process, then
0ff0: 20 74 68 65 20 73 75 62 73 65 71 75 65 6e 74 0a the subsequent.
1000: 2a 2a 20 74 68 72 65 61 64 73 20 6d 75 73 74 20 ** threads must
1010: 62 6c 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 block until the
1020: 66 69 72 73 74 20 74 68 72 65 61 64 20 66 69 6e first thread fin
1030: 69 73 68 65 73 20 77 69 74 68 20 74 68 65 20 69 ishes with the i
1040: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 2a nitialization..*
1050: 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 74 *.** The first t
1060: 68 72 65 61 64 20 6d 69 67 68 74 20 63 61 6c 6c hread might call
1070: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 this routine re
1080: 63 75 72 73 69 76 65 6c 79 2e 20 20 52 65 63 75 cursively. Recu
1090: 72 73 69 76 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 rsive.** calls t
10a0: 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 73 o this routine s
10b0: 68 6f 75 6c 64 20 6e 6f 74 20 62 6c 6f 63 6b 2c hould not block,
10c0: 20 6f 66 20 63 6f 75 72 73 65 2e 20 20 4f 74 68 of course. Oth
10d0: 65 72 77 69 73 65 20 74 68 65 0a 2a 2a 20 69 6e erwise the.** in
10e0: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f itialization pro
10f0: 63 65 73 73 20 77 6f 75 6c 64 20 6e 65 76 65 72 cess would never
1100: 20 63 6f 6d 70 6c 65 74 65 2e 0a 2a 2a 0a 2a 2a complete..**.**
1110: 20 4c 65 74 20 58 20 62 65 20 74 68 65 20 66 69 Let X be the fi
1120: 72 73 74 20 74 68 72 65 61 64 20 74 6f 20 65 6e rst thread to en
1130: 74 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ter this routine
1140: 2e 20 20 4c 65 74 20 59 20 62 65 20 73 6f 6d 65 . Let Y be some
1150: 20 6f 74 68 65 72 0a 2a 2a 20 74 68 72 65 61 64 other.** thread
1160: 2e 20 20 54 68 65 6e 20 77 68 69 6c 65 20 74 68 . Then while th
1170: 65 20 69 6e 69 74 69 61 6c 20 69 6e 76 6f 63 61 e initial invoca
1180: 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 72 6f 75 tion of this rou
1190: 74 69 6e 65 20 62 79 20 58 20 69 73 0a 2a 2a 20 tine by X is.**
11a0: 69 6e 63 6f 6d 70 6c 65 74 65 2c 20 69 74 20 69 incomplete, it i
11b0: 73 20 72 65 71 75 69 72 65 64 20 74 68 61 74 3a s required that:
11c0: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 20 43 61 6c .**.** * Cal
11d0: 6c 73 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69 ls to this routi
11e0: 6e 65 20 66 72 6f 6d 20 59 20 6d 75 73 74 20 62 ne from Y must b
11f0: 6c 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 6f lock until the o
1200: 75 74 65 72 2d 6d 6f 73 74 0a 2a 2a 20 20 20 20 uter-most.**
1210: 20 20 20 63 61 6c 6c 20 62 79 20 58 20 63 6f 6d call by X com
1220: 70 6c 65 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 pletes..**.**
1230: 20 2a 20 20 52 65 63 75 72 73 69 76 65 20 63 61 * Recursive ca
1240: 6c 6c 73 20 74 6f 20 74 68 69 73 20 72 6f 75 74 lls to this rout
1250: 69 6e 65 20 66 72 6f 6d 20 74 68 72 65 61 64 20 ine from thread
1260: 58 20 72 65 74 75 72 6e 20 69 6d 6d 65 64 69 61 X return immedia
1270: 74 65 6c 79 0a 2a 2a 20 20 20 20 20 20 20 77 69 tely.** wi
1280: 74 68 6f 75 74 20 62 6c 6f 63 6b 69 6e 67 2e 0a thout blocking..
1290: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 */.int sqlite3_i
12a0: 6e 69 74 69 61 6c 69 7a 65 28 76 6f 69 64 29 7b nitialize(void){
12b0: 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 . MUTEX_LOGIC(
12c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 sqlite3_mutex *p
12d0: 4d 61 73 74 65 72 3b 20 29 20 20 20 20 20 20 20 Master; )
12e0: 2f 2a 20 54 68 65 20 6d 61 69 6e 20 73 74 61 74 /* The main stat
12f0: 69 63 20 6d 75 74 65 78 20 2a 2f 0a 20 20 69 6e ic mutex */. in
1300: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
1310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1320: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
1330: 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 23 69 66 sult code */.#if
1340: 64 65 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 def SQLITE_EXTRA
1350: 5f 49 4e 49 54 0a 20 20 69 6e 74 20 62 52 75 6e _INIT. int bRun
1360: 45 78 74 72 61 49 6e 69 74 20 3d 20 30 3b 20 20 ExtraInit = 0;
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1380: 20 20 20 20 20 2f 2a 20 45 78 74 72 61 20 69 6e /* Extra in
1390: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6e 65 65 itialization nee
13a0: 64 65 64 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 23 ded */.#endif..#
13b0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 ifdef SQLITE_OMI
13c0: 54 5f 57 53 44 0a 20 20 72 63 20 3d 20 73 71 6c T_WSD. rc = sql
13d0: 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 34 30 ite3_wsd_init(40
13e0: 39 36 2c 20 32 34 29 3b 0a 20 20 69 66 28 20 72 96, 24);. if( r
13f0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1400: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1410: 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
1420: 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 If the following
1430: 20 61 73 73 65 72 74 28 29 20 66 61 69 6c 73 20 assert() fails
1440: 6f 6e 20 73 6f 6d 65 20 6f 62 73 63 75 72 65 20 on some obscure
1450: 70 72 6f 63 65 73 73 6f 72 2f 63 6f 6d 70 69 6c processor/compil
1460: 65 72 0a 20 20 2a 2a 20 63 6f 6d 62 69 6e 61 74 er. ** combinat
1470: 69 6f 6e 2c 20 74 68 65 20 77 6f 72 6b 2d 61 72 ion, the work-ar
1480: 6f 75 6e 64 20 69 73 20 74 6f 20 73 65 74 20 74 ound is to set t
1490: 68 65 20 63 6f 72 72 65 63 74 20 70 6f 69 6e 74 he correct point
14a0: 65 72 0a 20 20 2a 2a 20 73 69 7a 65 20 61 74 20 er. ** size at
14b0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 75 73 69 compile-time usi
14c0: 6e 67 20 2d 44 53 51 4c 49 54 45 5f 50 54 52 53 ng -DSQLITE_PTRS
14d0: 49 5a 45 3d 6e 20 63 6f 6d 70 69 6c 65 2d 74 69 IZE=n compile-ti
14e0: 6d 65 20 6f 70 74 69 6f 6e 20 2a 2f 0a 20 20 61 me option */. a
14f0: 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 50 54 ssert( SQLITE_PT
1500: 52 53 49 5a 45 3d 3d 73 69 7a 65 6f 66 28 63 68 RSIZE==sizeof(ch
1510: 61 72 2a 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 ar*) );.. /* If
1520: 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 SQLite is alrea
1530: 64 79 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 6e dy completely in
1540: 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 6e 20 itialized, then
1550: 74 68 69 73 20 63 61 6c 6c 0a 20 20 2a 2a 20 74 this call. ** t
1560: 6f 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 o sqlite3_initia
1570: 6c 69 7a 65 28 29 20 73 68 6f 75 6c 64 20 62 65 lize() should be
1580: 20 61 20 6e 6f 2d 6f 70 2e 20 20 42 75 74 20 74 a no-op. But t
1590: 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f he initializatio
15a0: 6e 0a 20 20 2a 2a 20 6d 75 73 74 20 62 65 20 63 n. ** must be c
15b0: 6f 6d 70 6c 65 74 65 2e 20 20 53 6f 20 69 73 49 omplete. So isI
15c0: 6e 69 74 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 nit must not be
15d0: 73 65 74 20 75 6e 74 69 6c 20 74 68 65 20 76 65 set until the ve
15e0: 72 79 20 65 6e 64 0a 20 20 2a 2a 20 6f 66 20 74 ry end. ** of t
15f0: 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 20 20 2a his routine.. *
1600: 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 /. if( sqlite3G
1610: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e lobalConfig.isIn
1620: 69 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 it ) return SQLI
1630: 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 4d 61 6b TE_OK;.. /* Mak
1640: 65 20 73 75 72 65 20 74 68 65 20 6d 75 74 65 78 e sure the mutex
1650: 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 69 6e subsystem is in
1660: 69 74 69 61 6c 69 7a 65 64 2e 20 20 49 66 20 75 itialized. If u
1670: 6e 61 62 6c 65 20 74 6f 20 0a 20 20 2a 2a 20 69 nable to . ** i
1680: 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 75 nitialize the mu
1690: 74 65 78 20 73 75 62 73 79 73 74 65 6d 2c 20 72 tex subsystem, r
16a0: 65 74 75 72 6e 20 65 61 72 6c 79 20 77 69 74 68 eturn early with
16b0: 20 74 68 65 20 65 72 72 6f 72 2e 0a 20 20 2a 2a the error.. **
16c0: 20 49 66 20 74 68 65 20 73 79 73 74 65 6d 20 69 If the system i
16d0: 73 20 73 6f 20 73 69 63 6b 20 74 68 61 74 20 77 s so sick that w
16e0: 65 20 61 72 65 20 75 6e 61 62 6c 65 20 74 6f 20 e are unable to
16f0: 61 6c 6c 6f 63 61 74 65 20 61 20 6d 75 74 65 78 allocate a mutex
1700: 2c 0a 20 20 2a 2a 20 74 68 65 72 65 20 69 73 20 ,. ** there is
1710: 6e 6f 74 20 6d 75 63 68 20 53 51 4c 69 74 65 20 not much SQLite
1720: 69 73 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 61 is going to be a
1730: 62 6c 65 20 74 6f 20 64 6f 2e 0a 20 20 2a 2a 0a ble to do.. **.
1740: 20 20 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 73 ** The mutex s
1750: 75 62 73 79 73 74 65 6d 20 6d 75 73 74 20 74 61 ubsystem must ta
1760: 6b 65 20 63 61 72 65 20 6f 66 20 73 65 72 69 61 ke care of seria
1770: 6c 69 7a 69 6e 67 20 69 74 73 20 6f 77 6e 0a 20 lizing its own.
1780: 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 ** initializati
1790: 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 on.. */. rc =
17a0: 73 71 6c 69 74 65 33 4d 75 74 65 78 49 6e 69 74 sqlite3MutexInit
17b0: 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 ();. if( rc ) r
17c0: 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 eturn rc;.. /*
17d0: 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d Initialize the m
17e0: 61 6c 6c 6f 63 28 29 20 73 79 73 74 65 6d 20 61 alloc() system a
17f0: 6e 64 20 74 68 65 20 72 65 63 75 72 73 69 76 65 nd the recursive
1800: 20 70 49 6e 69 74 4d 75 74 65 78 20 6d 75 74 65 pInitMutex mute
1810: 78 2e 0a 20 20 2a 2a 20 54 68 69 73 20 6f 70 65 x.. ** This ope
1820: 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 74 65 63 ration is protec
1830: 74 65 64 20 62 79 20 74 68 65 20 53 54 41 54 49 ted by the STATI
1840: 43 5f 4d 41 53 54 45 52 20 6d 75 74 65 78 2e 20 C_MASTER mutex.
1850: 20 4e 6f 74 65 20 74 68 61 74 0a 20 20 2a 2a 20 Note that. **
1860: 4d 75 74 65 78 41 6c 6c 6f 63 28 29 20 69 73 20 MutexAlloc() is
1870: 63 61 6c 6c 65 64 20 66 6f 72 20 61 20 73 74 61 called for a sta
1880: 74 69 63 20 6d 75 74 65 78 20 70 72 69 6f 72 20 tic mutex prior
1890: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 to initializing
18a0: 74 68 65 0a 20 20 2a 2a 20 6d 61 6c 6c 6f 63 20 the. ** malloc
18b0: 73 75 62 73 79 73 74 65 6d 20 2d 20 74 68 69 73 subsystem - this
18c0: 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 74 68 implies that th
18d0: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 e allocation of
18e0: 61 20 73 74 61 74 69 63 0a 20 20 2a 2a 20 6d 75 a static. ** mu
18f0: 74 65 78 20 6d 75 73 74 20 6e 6f 74 20 72 65 71 tex must not req
1900: 75 69 72 65 20 73 75 70 70 6f 72 74 20 66 72 6f uire support fro
1910: 6d 20 74 68 65 20 6d 61 6c 6c 6f 63 20 73 75 62 m the malloc sub
1920: 73 79 73 74 65 6d 2e 0a 20 20 2a 2f 0a 20 20 4d system.. */. M
1930: 55 54 45 58 5f 4c 4f 47 49 43 28 20 70 4d 61 73 UTEX_LOGIC( pMas
1940: 74 65 72 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 ter = sqlite3Mut
1950: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
1960: 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 UTEX_STATIC_MAST
1970: 45 52 29 3b 20 29 0a 20 20 73 71 6c 69 74 65 33 ER); ). sqlite3
1980: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 _mutex_enter(pMa
1990: 73 74 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 ster);. sqlite3
19a0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
19b0: 75 74 65 78 49 6e 69 74 20 3d 20 31 3b 0a 20 20 utexInit = 1;.
19c0: 69 66 28 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 if( !sqlite3Glob
19d0: 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f alConfig.isMallo
19e0: 63 49 6e 69 74 20 29 7b 0a 20 20 20 20 72 63 20 cInit ){. rc
19f0: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 = sqlite3MallocI
1a00: 6e 69 74 28 29 3b 0a 20 20 7d 0a 20 20 69 66 28 nit();. }. if(
1a10: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1a20: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f {. sqlite3Glo
1a30: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c balConfig.isMall
1a40: 6f 63 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 ocInit = 1;.
1a50: 69 66 28 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 if( !sqlite3Glob
1a60: 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 alConfig.pInitMu
1a70: 74 65 78 20 29 7b 0a 20 20 20 20 20 20 73 71 6c tex ){. sql
1a80: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1a90: 2e 70 49 6e 69 74 4d 75 74 65 78 20 3d 0a 20 20 .pInitMutex =.
1aa0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
1ab0: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
1ac0: 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 E_MUTEX_RECURSIV
1ad0: 45 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71 E);. if( sq
1ae0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1af0: 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 26 26 20 g.bCoreMutex &&
1b00: 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f !sqlite3GlobalCo
1b10: 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 nfig.pInitMutex
1b20: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
1b30: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
1b40: 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d T;. }. }
1b50: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
1b60: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1b70: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1b80: 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 fig.nRefInitMute
1b90: 78 2b 2b 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 x++;. }. sqlit
1ba0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 e3_mutex_leave(p
1bb0: 4d 61 73 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 49 Master);.. /* I
1bc0: 66 20 72 63 20 69 73 20 6e 6f 74 20 53 51 4c 49 f rc is not SQLI
1bd0: 54 45 5f 4f 4b 20 61 74 20 74 68 69 73 20 70 6f TE_OK at this po
1be0: 69 6e 74 2c 20 74 68 65 6e 20 65 69 74 68 65 72 int, then either
1bf0: 20 74 68 65 20 6d 61 6c 6c 6f 63 0a 20 20 2a 2a the malloc. **
1c00: 20 73 75 62 73 79 73 74 65 6d 20 63 6f 75 6c 64 subsystem could
1c10: 20 6e 6f 74 20 62 65 20 69 6e 69 74 69 61 6c 69 not be initiali
1c20: 7a 65 64 20 6f 72 20 74 68 65 20 73 79 73 74 65 zed or the syste
1c30: 6d 20 66 61 69 6c 65 64 20 74 6f 20 61 6c 6c 6f m failed to allo
1c40: 63 61 74 65 0a 20 20 2a 2a 20 74 68 65 20 70 49 cate. ** the pI
1c50: 6e 69 74 4d 75 74 65 78 20 6d 75 74 65 78 2e 20 nitMutex mutex.
1c60: 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 Return an error
1c70: 69 6e 20 65 69 74 68 65 72 20 63 61 73 65 2e 20 in either case.
1c80: 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d 53 51 */. if( rc!=SQ
1c90: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
1ca0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 eturn rc;. }..
1cb0: 20 2f 2a 20 44 6f 20 74 68 65 20 72 65 73 74 20 /* Do the rest
1cc0: 6f 66 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a of the initializ
1cd0: 61 74 69 6f 6e 20 75 6e 64 65 72 20 74 68 65 20 ation under the
1ce0: 72 65 63 75 72 73 69 76 65 20 6d 75 74 65 78 20 recursive mutex
1cf0: 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 77 65 20 so. ** that we
1d00: 77 69 6c 6c 20 62 65 20 61 62 6c 65 20 74 6f 20 will be able to
1d10: 68 61 6e 64 6c 65 20 72 65 63 75 72 73 69 76 65 handle recursive
1d20: 20 63 61 6c 6c 73 20 69 6e 74 6f 0a 20 20 2a 2a calls into. **
1d30: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c sqlite3_initial
1d40: 69 7a 65 28 29 2e 20 20 54 68 65 20 72 65 63 75 ize(). The recu
1d50: 72 73 69 76 65 20 63 61 6c 6c 73 20 6e 6f 72 6d rsive calls norm
1d60: 61 6c 6c 79 20 63 6f 6d 65 20 74 68 72 6f 75 67 ally come throug
1d70: 68 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f h. ** sqlite3_o
1d80: 73 5f 69 6e 69 74 28 29 20 77 68 65 6e 20 69 74 s_init() when it
1d90: 20 69 6e 76 6f 6b 65 73 20 73 71 6c 69 74 65 33 invokes sqlite3
1da0: 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 2c _vfs_register(),
1db0: 20 62 75 74 20 6f 74 68 65 72 0a 20 20 2a 2a 20 but other. **
1dc0: 72 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 recursive calls
1dd0: 6d 69 67 68 74 20 61 6c 73 6f 20 62 65 20 70 6f might also be po
1de0: 73 73 69 62 6c 65 2e 0a 20 20 2a 2a 0a 20 20 2a ssible.. **. *
1df0: 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e * IMPLEMENTATION
1e00: 2d 4f 46 3a 20 52 2d 30 30 31 34 30 2d 33 37 34 -OF: R-00140-374
1e10: 34 35 20 53 51 4c 69 74 65 20 61 75 74 6f 6d 61 45 SQLite automa
1e20: 74 69 63 61 6c 6c 79 20 73 65 72 69 61 6c 69 7a tically serializ
1e30: 65 73 20 63 61 6c 6c 73 0a 20 20 2a 2a 20 74 6f es calls. ** to
1e40: 20 74 68 65 20 78 49 6e 69 74 20 6d 65 74 68 6f the xInit metho
1e50: 64 2c 20 73 6f 20 74 68 65 20 78 49 6e 69 74 20 d, so the xInit
1e60: 6d 65 74 68 6f 64 20 6e 65 65 64 20 6e 6f 74 20 method need not
1e70: 62 65 20 74 68 72 65 61 64 73 61 66 65 2e 0a 20 be threadsafe..
1e80: 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f 6c **. ** The fol
1e90: 6c 6f 77 69 6e 67 20 6d 75 74 65 78 20 69 73 20 lowing mutex is
1ea0: 77 68 61 74 20 73 65 72 69 61 6c 69 7a 65 73 20 what serializes
1eb0: 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 61 70 access to the ap
1ec0: 70 64 65 66 20 70 63 61 63 68 65 20 78 49 6e 69 pdef pcache xIni
1ed0: 74 0a 20 20 2a 2a 20 6d 65 74 68 6f 64 73 2e 20 t. ** methods.
1ee0: 20 54 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 The sqlite3_pca
1ef0: 63 68 65 5f 6d 65 74 68 6f 64 73 2e 78 49 6e 69 che_methods.xIni
1f00: 74 28 29 20 61 6c 6c 20 69 73 20 65 6d 62 65 64 t() all is embed
1f10: 64 65 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 ded in the. **
1f20: 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 call to sqlite3P
1f30: 63 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 cacheInitialize(
1f40: 29 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ).. */. sqlite
1f50: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 71 3_mutex_enter(sq
1f60: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1f70: 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a 20 g.pInitMutex);.
1f80: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
1f90: 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 3d alConfig.isInit=
1fa0: 3d 30 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f =0 && sqlite3Glo
1fb0: 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 balConfig.inProg
1fc0: 72 65 73 73 3d 3d 30 20 29 7b 0a 20 20 20 20 73 ress==0 ){. s
1fd0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1fe0: 69 67 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 ig.inProgress =
1ff0: 31 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 1;.#ifdef SQLITE
2000: 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 _ENABLE_SQLLOG.
2010: 20 20 20 7b 0a 20 20 20 20 20 20 65 78 74 65 72 {. exter
2020: 6e 20 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 n void sqlite3_i
2030: 6e 69 74 5f 73 71 6c 6c 6f 67 28 76 6f 69 64 29 nit_sqllog(void)
2040: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
2050: 69 6e 69 74 5f 73 71 6c 6c 6f 67 28 29 3b 0a 20 init_sqllog();.
2060: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
2070: 6d 65 6d 73 65 74 28 26 73 71 6c 69 74 65 33 42 memset(&sqlite3B
2080: 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 2c uiltinFunctions,
2090: 20 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 0, sizeof(sqlit
20a0: 65 33 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f e3BuiltinFunctio
20b0: 6e 73 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 ns));. sqlite
20c0: 33 52 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 3RegisterBuiltin
20d0: 46 75 6e 63 74 69 6f 6e 73 28 29 3b 0a 20 20 20 Functions();.
20e0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
20f0: 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 alConfig.isPCach
2100: 65 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 eInit==0 ){.
2110: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 rc = sqlite3Pc
2120: 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 acheInitialize()
2130: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
2140: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2150: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2160: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 obalConfig.isPCa
2170: 63 68 65 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 cheInit = 1;.
2180: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
2190: 73 49 6e 69 74 28 29 3b 0a 20 20 20 20 7d 0a 20 sInit();. }.
21a0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
21b0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 E_OK ){. sq
21c0: 6c 69 74 65 33 50 43 61 63 68 65 42 75 66 66 65 lite3PCacheBuffe
21d0: 72 53 65 74 75 70 28 20 73 71 6c 69 74 65 33 47 rSetup( sqlite3G
21e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 lobalConfig.pPag
21f0: 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 73 71 e, . sq
2200: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2210: 67 2e 73 7a 50 61 67 65 2c 20 73 71 6c 69 74 65 g.szPage, sqlite
2220: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 3GlobalConfig.nP
2230: 61 67 65 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 age);. sqli
2240: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2250: 69 73 49 6e 69 74 20 3d 20 31 3b 0a 23 69 66 64 isInit = 1;.#ifd
2260: 65 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f ef SQLITE_EXTRA_
2270: 49 4e 49 54 0a 20 20 20 20 20 20 62 52 75 6e 45 INIT. bRunE
2280: 78 74 72 61 49 6e 69 74 20 3d 20 31 3b 0a 23 65 xtraInit = 1;.#e
2290: 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 20 73 ndif. }. s
22a0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
22b0: 69 67 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 ig.inProgress =
22c0: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 0;. }. sqlite3
22d0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c _mutex_leave(sql
22e0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
22f0: 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a 0a 20 .pInitMutex);..
2300: 20 2f 2a 20 47 6f 20 62 61 63 6b 20 75 6e 64 65 /* Go back unde
2310: 72 20 74 68 65 20 73 74 61 74 69 63 20 6d 75 74 r the static mut
2320: 65 78 20 61 6e 64 20 63 6c 65 61 6e 20 75 70 20 ex and clean up
2330: 74 68 65 20 72 65 63 75 72 73 69 76 65 0a 20 20 the recursive.
2340: 2a 2a 20 6d 75 74 65 78 20 74 6f 20 70 72 65 76 ** mutex to prev
2350: 65 6e 74 20 61 20 72 65 73 6f 75 72 63 65 20 6c ent a resource l
2360: 65 61 6b 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 eak.. */. sqli
2370: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
2380: 70 4d 61 73 74 65 72 29 3b 0a 20 20 73 71 6c 69 pMaster);. sqli
2390: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
23a0: 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 2d 2d 3b nRefInitMutex--;
23b0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
23c0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 obalConfig.nRefI
23d0: 6e 69 74 4d 75 74 65 78 3c 3d 30 20 29 7b 0a 20 nitMutex<=0 ){.
23e0: 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
23f0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e e3GlobalConfig.n
2400: 52 65 66 49 6e 69 74 4d 75 74 65 78 3d 3d 30 20 RefInitMutex==0
2410: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
2420: 75 74 65 78 5f 66 72 65 65 28 73 71 6c 69 74 65 utex_free(sqlite
2430: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 3GlobalConfig.pI
2440: 6e 69 74 4d 75 74 65 78 29 3b 0a 20 20 20 20 73 nitMutex);. s
2450: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2460: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 3d 20 ig.pInitMutex =
2470: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 0;. }. sqlite3
2480: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 _mutex_leave(pMa
2490: 73 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 ster);.. /* The
24a0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 6a 75 following is ju
24b0: 73 74 20 61 20 73 61 6e 69 74 79 20 63 68 65 63 st a sanity chec
24c0: 6b 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 53 k to make sure S
24d0: 51 4c 69 74 65 20 68 61 73 0a 20 20 2a 2a 20 62 QLite has. ** b
24e0: 65 65 6e 20 63 6f 6d 70 69 6c 65 64 20 63 6f 72 een compiled cor
24f0: 72 65 63 74 6c 79 2e 20 20 49 74 20 69 73 20 69 rectly. It is i
2500: 6d 70 6f 72 74 61 6e 74 20 74 6f 20 72 75 6e 20 mportant to run
2510: 74 68 69 73 20 63 6f 64 65 2c 20 62 75 74 0a 20 this code, but.
2520: 20 2a 2a 20 77 65 20 64 6f 6e 27 74 20 77 61 6e ** we don't wan
2530: 74 20 74 6f 20 72 75 6e 20 69 74 20 74 6f 6f 20 t to run it too
2540: 6f 66 74 65 6e 20 61 6e 64 20 73 6f 61 6b 20 75 often and soak u
2550: 70 20 43 50 55 20 63 79 63 6c 65 73 20 66 6f 72 p CPU cycles for
2560: 20 6e 6f 0a 20 20 2a 2a 20 72 65 61 73 6f 6e 2e no. ** reason.
2570: 20 20 53 6f 20 77 65 20 72 75 6e 20 69 74 20 6f So we run it o
2580: 6e 63 65 20 64 75 72 69 6e 67 20 69 6e 69 74 69 nce during initi
2590: 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 2a 2f 0a alization.. */.
25a0: 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 23 #ifndef NDEBUG.#
25b0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
25c0: 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e IT_FLOATING_POIN
25d0: 54 0a 20 20 2f 2a 20 54 68 69 73 20 73 65 63 74 T. /* This sect
25e0: 69 6f 6e 20 6f 66 20 63 6f 64 65 27 73 20 6f 6e ion of code's on
25f0: 6c 79 20 22 6f 75 74 70 75 74 22 20 69 73 20 76 ly "output" is v
2600: 69 61 20 61 73 73 65 72 74 28 29 20 73 74 61 74 ia assert() stat
2610: 65 6d 65 6e 74 73 2e 20 2a 2f 0a 20 20 69 66 20 ements. */. if
2620: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2630: 29 7b 0a 20 20 20 20 75 36 34 20 78 20 3d 20 28 ){. u64 x = (
2640: 28 28 75 36 34 29 31 29 3c 3c 36 33 29 2d 31 3b ((u64)1)<<63)-1;
2650: 0a 20 20 20 20 64 6f 75 62 6c 65 20 79 3b 0a 20 . double y;.
2660: 20 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 assert(sizeof
2670: 28 78 29 3d 3d 38 29 3b 0a 20 20 20 20 61 73 73 (x)==8);. ass
2680: 65 72 74 28 73 69 7a 65 6f 66 28 78 29 3d 3d 73 ert(sizeof(x)==s
2690: 69 7a 65 6f 66 28 79 29 29 3b 0a 20 20 20 20 6d izeof(y));. m
26a0: 65 6d 63 70 79 28 26 79 2c 20 26 78 2c 20 38 29 emcpy(&y, &x, 8)
26b0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 ;. assert( sq
26c0: 6c 69 74 65 33 49 73 4e 61 4e 28 79 29 20 29 3b lite3IsNaN(y) );
26d0: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 23 65 6e 64 . }.#endif.#end
26e0: 69 66 0a 0a 20 20 2f 2a 20 44 6f 20 65 78 74 72 if.. /* Do extr
26f0: 61 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e a initialization
2700: 20 73 74 65 70 73 20 72 65 71 75 65 73 74 65 64 steps requested
2710: 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 45 by the SQLITE_E
2720: 58 54 52 41 5f 49 4e 49 54 0a 20 20 2a 2a 20 63 XTRA_INIT. ** c
2730: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 ompile-time opti
2740: 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 on.. */.#ifdef
2750: 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 SQLITE_EXTRA_INI
2760: 54 0a 20 20 69 66 28 20 62 52 75 6e 45 78 74 72 T. if( bRunExtr
2770: 61 49 6e 69 74 20 29 7b 0a 20 20 20 20 69 6e 74 aInit ){. int
2780: 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e SQLITE_EXTRA_IN
2790: 49 54 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b IT(const char*);
27a0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
27b0: 5f 45 58 54 52 41 5f 49 4e 49 54 28 30 29 3b 0a _EXTRA_INIT(0);.
27c0: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 }.#endif.. re
27d0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
27e0: 2a 20 55 6e 64 6f 20 74 68 65 20 65 66 66 65 63 * Undo the effec
27f0: 74 73 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 6e ts of sqlite3_in
2800: 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 4d 75 73 itialize(). Mus
2810: 74 20 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 t not be called
2820: 77 68 69 6c 65 0a 2a 2a 20 74 68 65 72 65 20 61 while.** there a
2830: 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 re outstanding d
2840: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
2850: 6f 6e 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c ons or memory al
2860: 6c 6f 63 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 locations or.**
2870: 77 68 69 6c 65 20 61 6e 79 20 70 61 72 74 20 6f while any part o
2880: 66 20 53 51 4c 69 74 65 20 69 73 20 6f 74 68 65 f SQLite is othe
2890: 72 77 69 73 65 20 69 6e 20 75 73 65 20 69 6e 20 rwise in use in
28a0: 61 6e 79 20 74 68 72 65 61 64 2e 20 20 54 68 69 any thread. Thi
28b0: 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 s.** routine is
28c0: 6e 6f 74 20 74 68 72 65 61 64 73 61 66 65 2e 20 not threadsafe.
28d0: 20 42 75 74 20 69 74 20 69 73 20 73 61 66 65 20 But it is safe
28e0: 74 6f 20 69 6e 76 6f 6b 65 20 74 68 69 73 20 72 to invoke this r
28f0: 6f 75 74 69 6e 65 0a 2a 2a 20 6f 6e 20 77 68 65 outine.** on whe
2900: 6e 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 n SQLite is alre
2910: 61 64 79 20 73 68 75 74 20 64 6f 77 6e 2e 20 20 ady shut down.
2920: 49 66 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 If SQLite is alr
2930: 65 61 64 79 20 73 68 75 74 20 64 6f 77 6e 0a 2a eady shut down.*
2940: 2a 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 * when this rout
2950: 69 6e 65 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 ine is invoked,
2960: 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e then this routin
2970: 65 20 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 e is a harmless
2980: 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 no-op..*/.int sq
2990: 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 6e 28 76 lite3_shutdown(v
29a0: 6f 69 64 29 7b 0a 23 69 66 64 65 66 20 53 51 4c oid){.#ifdef SQL
29b0: 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 69 ITE_OMIT_WSD. i
29c0: 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f nt rc = sqlite3_
29d0: 77 73 64 5f 69 6e 69 74 28 34 30 39 36 2c 20 32 wsd_init(4096, 2
29e0: 34 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4);. if( rc!=SQ
29f0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
2a00: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 eturn rc;. }.#e
2a10: 6e 64 69 66 0a 0a 20 20 69 66 28 20 73 71 6c 69 ndif.. if( sqli
2a20: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2a30: 69 73 49 6e 69 74 20 29 7b 0a 23 69 66 64 65 66 isInit ){.#ifdef
2a40: 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 SQLITE_EXTRA_SH
2a50: 55 54 44 4f 57 4e 0a 20 20 20 20 76 6f 69 64 20 UTDOWN. void
2a60: 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 SQLITE_EXTRA_SHU
2a70: 54 44 4f 57 4e 28 76 6f 69 64 29 3b 0a 20 20 20 TDOWN(void);.
2a80: 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 SQLITE_EXTRA_SH
2a90: 55 54 44 4f 57 4e 28 29 3b 0a 23 65 6e 64 69 66 UTDOWN();.#endif
2aa0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6f 73 5f . sqlite3_os_
2ab0: 65 6e 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 end();. sqlit
2ac0: 65 33 5f 72 65 73 65 74 5f 61 75 74 6f 5f 65 78 e3_reset_auto_ex
2ad0: 74 65 6e 73 69 6f 6e 28 29 3b 0a 20 20 20 20 73 tension();. s
2ae0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2af0: 69 67 2e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 ig.isInit = 0;.
2b00: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 }. if( sqlite3
2b10: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 GlobalConfig.isP
2b20: 43 61 63 68 65 49 6e 69 74 20 29 7b 0a 20 20 20 CacheInit ){.
2b30: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 68 sqlite3PcacheSh
2b40: 75 74 64 6f 77 6e 28 29 3b 0a 20 20 20 20 73 71 utdown();. sq
2b50: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2b60: 67 2e 69 73 50 43 61 63 68 65 49 6e 69 74 20 3d g.isPCacheInit =
2b70: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 0;. }. if( sq
2b80: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2b90: 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 29 g.isMallocInit )
2ba0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c {. sqlite3Mal
2bb0: 6c 6f 63 45 6e 64 28 29 3b 0a 20 20 20 20 73 71 locEnd();. sq
2bc0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2bd0: 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 3d g.isMallocInit =
2be0: 20 30 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 0;..#ifndef SQL
2bf0: 49 54 45 5f 4f 4d 49 54 5f 53 48 55 54 44 4f 57 ITE_OMIT_SHUTDOW
2c00: 4e 5f 44 49 52 45 43 54 4f 52 49 45 53 0a 20 20 N_DIRECTORIES.
2c10: 20 20 2f 2a 20 54 68 65 20 68 65 61 70 20 73 75 /* The heap su
2c20: 62 73 79 73 74 65 6d 20 68 61 73 20 6e 6f 77 20 bsystem has now
2c30: 62 65 65 6e 20 73 68 75 74 64 6f 77 6e 20 61 6e been shutdown an
2c40: 64 20 74 68 65 73 65 20 76 61 6c 75 65 73 20 61 d these values a
2c50: 72 65 20 73 75 70 70 6f 73 65 64 0a 20 20 20 20 re supposed.
2c60: 2a 2a 20 74 6f 20 62 65 20 4e 55 4c 4c 20 6f 72 ** to be NULL or
2c70: 20 70 6f 69 6e 74 20 74 6f 20 6d 65 6d 6f 72 79 point to memory
2c80: 20 74 68 61 74 20 77 61 73 20 6f 62 74 61 69 6e that was obtain
2c90: 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f ed from sqlite3_
2ca0: 6d 61 6c 6c 6f 63 28 29 2c 0a 20 20 20 20 2a 2a malloc(),. **
2cb0: 20 77 68 69 63 68 20 77 6f 75 6c 64 20 72 65 6c which would rel
2cc0: 79 20 6f 6e 20 74 68 61 74 20 68 65 61 70 20 73 y on that heap s
2cd0: 75 62 73 79 73 74 65 6d 3b 20 74 68 65 72 65 66 ubsystem; theref
2ce0: 6f 72 65 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 ore, make sure t
2cf0: 68 65 73 65 0a 20 20 20 20 2a 2a 20 76 61 6c 75 hese. ** valu
2d00: 65 73 20 63 61 6e 6e 6f 74 20 72 65 66 65 72 20 es cannot refer
2d10: 74 6f 20 68 65 61 70 20 6d 65 6d 6f 72 79 20 74 to heap memory t
2d20: 68 61 74 20 77 61 73 20 6a 75 73 74 20 69 6e 76 hat was just inv
2d30: 61 6c 69 64 61 74 65 64 20 77 68 65 6e 20 74 68 alidated when th
2d40: 65 0a 20 20 20 20 2a 2a 20 68 65 61 70 20 73 75 e. ** heap su
2d50: 62 73 79 73 74 65 6d 20 77 61 73 20 73 68 75 74 bsystem was shut
2d60: 64 6f 77 6e 2e 20 20 54 68 69 73 20 69 73 20 6f down. This is o
2d70: 6e 6c 79 20 64 6f 6e 65 20 69 66 20 74 68 65 20 nly done if the
2d80: 63 75 72 72 65 6e 74 20 63 61 6c 6c 20 74 6f 0a current call to.
2d90: 20 20 20 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 ** this func
2da0: 74 69 6f 6e 20 72 65 73 75 6c 74 65 64 20 69 6e tion resulted in
2db0: 20 74 68 65 20 68 65 61 70 20 73 75 62 73 79 73 the heap subsys
2dc0: 74 65 6d 20 61 63 74 75 61 6c 6c 79 20 62 65 69 tem actually bei
2dd0: 6e 67 20 73 68 75 74 64 6f 77 6e 2e 0a 20 20 20 ng shutdown..
2de0: 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 5f */. sqlite3_
2df0: 64 61 74 61 5f 64 69 72 65 63 74 6f 72 79 20 3d data_directory =
2e00: 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 0;. sqlite3_
2e10: 74 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d temp_directory =
2e20: 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 0;.#endif. }.
2e30: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
2e40: 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 alConfig.isMutex
2e50: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
2e60: 74 65 33 4d 75 74 65 78 45 6e 64 28 29 3b 0a 20 te3MutexEnd();.
2e70: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2e80: 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e Config.isMutexIn
2e90: 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 it = 0;. }.. r
2ea0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2eb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 41 .}../*.** This A
2ec0: 50 49 20 61 6c 6c 6f 77 73 20 61 70 70 6c 69 63 PI allows applic
2ed0: 61 74 69 6f 6e 73 20 74 6f 20 6d 6f 64 69 66 79 ations to modify
2ee0: 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 the global conf
2ef0: 69 67 75 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 iguration of.**
2f00: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 the SQLite libra
2f10: 72 79 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a ry at run-time..
2f20: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
2f30: 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 ne should only b
2f40: 65 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 e called when th
2f50: 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 ere are no outst
2f60: 61 6e 64 69 6e 67 0a 2a 2a 20 64 61 74 61 62 61 anding.** databa
2f70: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f se connections o
2f80: 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 r memory allocat
2f90: 69 6f 6e 73 2e 20 20 54 68 69 73 20 72 6f 75 74 ions. This rout
2fa0: 69 6e 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 74 68 ine is not.** th
2fb0: 72 65 61 64 73 61 66 65 2e 20 20 46 61 69 6c 75 readsafe. Failu
2fc0: 72 65 20 74 6f 20 68 65 65 64 20 74 68 65 73 65 re to heed these
2fd0: 20 77 61 72 6e 69 6e 67 73 20 63 61 6e 20 6c 65 warnings can le
2fe0: 61 64 20 74 6f 20 75 6e 70 72 65 64 69 63 74 61 ad to unpredicta
2ff0: 62 6c 65 0a 2a 2a 20 62 65 68 61 76 69 6f 72 2e ble.** behavior.
3000: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
3010: 63 6f 6e 66 69 67 28 69 6e 74 20 6f 70 2c 20 2e config(int op, .
3020: 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 ..){. va_list a
3030: 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 p;. int rc = SQ
3040: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 73 LITE_OK;.. /* s
3050: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 qlite3_config()
3060: 73 68 61 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c shall return SQL
3070: 49 54 45 5f 4d 49 53 55 53 45 20 69 66 20 69 74 ITE_MISUSE if it
3080: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 69 6c is invoked whil
3090: 65 0a 20 20 2a 2a 20 74 68 65 20 53 51 4c 69 74 e. ** the SQLit
30a0: 65 20 6c 69 62 72 61 72 79 20 69 73 20 69 6e 20 e library is in
30b0: 75 73 65 2e 20 2a 2f 0a 20 20 69 66 28 20 73 71 use. */. if( sq
30c0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
30d0: 67 2e 69 73 49 6e 69 74 20 29 20 72 65 74 75 72 g.isInit ) retur
30e0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
30f0: 42 4b 50 54 3b 0a 0a 20 20 76 61 5f 73 74 61 72 BKPT;.. va_star
3100: 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 t(ap, op);. swi
3110: 74 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 tch( op ){..
3120: 2f 2a 20 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 /* Mutex configu
3130: 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 ration options a
3140: 72 65 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c re only availabl
3150: 65 20 69 6e 20 61 20 74 68 72 65 61 64 73 61 66 e in a threadsaf
3160: 65 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 e. ** compile
3170: 2e 0a 20 20 20 20 2a 2f 0a 23 69 66 20 64 65 66 .. */.#if def
3180: 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 ined(SQLITE_THRE
3190: 41 44 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 ADSAFE) && SQLIT
31a0: 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 20 20 E_THREADSAFE>0
31b0: 2f 2a 20 49 4d 50 3a 20 52 2d 35 34 34 36 36 2d /* IMP: R-54466-
31c0: 34 36 37 35 36 20 2a 2f 0a 20 20 20 20 63 61 73 46756 */. cas
31d0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
31e0: 53 49 4e 47 4c 45 54 48 52 45 41 44 3a 20 7b 0a SINGLETHREAD: {.
31f0: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
3200: 45 2d 4f 46 3a 20 52 2d 30 32 37 34 38 2d 31 39 E-OF: R-02748-19
3210: 30 39 36 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 096 This option
3220: 73 65 74 73 20 74 68 65 20 74 68 72 65 61 64 69 sets the threadi
3230: 6e 67 20 6d 6f 64 65 20 74 6f 0a 20 20 20 20 20 ng mode to.
3240: 20 2a 2a 20 53 69 6e 67 6c 65 2d 74 68 72 65 61 ** Single-threa
3250: 64 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 d. */. sqli
3260: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3270: 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 30 3b 20 bCoreMutex = 0;
3280: 20 2f 2a 20 44 69 73 61 62 6c 65 20 6d 75 74 65 /* Disable mute
3290: 78 20 6f 6e 20 63 6f 72 65 20 2a 2f 0a 20 20 20 x on core */.
32a0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
32b0: 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 Config.bFullMute
32c0: 78 20 3d 20 30 3b 20 20 2f 2a 20 44 69 73 61 62 x = 0; /* Disab
32d0: 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f 6e 6e le mutex on conn
32e0: 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 ections */.
32f0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 break;. }.#e
3300: 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 ndif.#if defined
3310: 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 (SQLITE_THREADSA
3320: 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f 54 48 FE) && SQLITE_TH
3330: 52 45 41 44 53 41 46 45 3e 30 20 2f 2a 20 49 4d READSAFE>0 /* IM
3340: 50 3a 20 52 2d 32 30 35 32 30 2d 35 34 30 38 36 P: R-20520-54086
3350: 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
3360: 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 ITE_CONFIG_MULTI
3370: 54 48 52 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 THREAD: {.
3380: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
3390: 52 2d 31 34 33 37 34 2d 34 32 34 36 38 20 54 68 R-14374-42468 Th
33a0: 69 73 20 6f 70 74 69 6f 6e 20 73 65 74 73 20 74 is option sets t
33b0: 68 65 20 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 he threading mod
33c0: 65 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 4d 75 e to. ** Mu
33d0: 6c 74 69 2d 74 68 72 65 61 64 2e 20 2a 2f 0a 20 lti-thread. */.
33e0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
33f0: 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 alConfig.bCoreMu
3400: 74 65 78 20 3d 20 31 3b 20 20 2f 2a 20 45 6e 61 tex = 1; /* Ena
3410: 62 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f 72 ble mutex on cor
3420: 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 e */. sqlit
3430: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
3440: 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 20 20 FullMutex = 0;
3450: 2f 2a 20 44 69 73 61 62 6c 65 20 6d 75 74 65 78 /* Disable mutex
3460: 20 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 on connections
3470: 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a */. break;.
3480: 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 }.#endif.#if
3490: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
34a0: 54 48 52 45 41 44 53 41 46 45 29 20 26 26 20 53 THREADSAFE) && S
34b0: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
34c0: 3e 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 39 35 >0 /* IMP: R-595
34d0: 39 33 2d 32 31 38 31 30 20 2a 2f 0a 20 20 20 20 93-21810 */.
34e0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
34f0: 49 47 5f 53 45 52 49 41 4c 49 5a 45 44 3a 20 7b IG_SERIALIZED: {
3500: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
3510: 43 45 2d 4f 46 3a 20 52 2d 34 31 32 32 30 2d 35 CE-OF: R-41220-5
3520: 31 38 30 30 20 54 68 69 73 20 6f 70 74 69 6f 6e 1800 This option
3530: 20 73 65 74 73 20 74 68 65 20 74 68 72 65 61 64 sets the thread
3540: 69 6e 67 20 6d 6f 64 65 20 74 6f 0a 20 20 20 20 ing mode to.
3550: 20 20 2a 2a 20 53 65 72 69 61 6c 69 7a 65 64 2e ** Serialized.
3560: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
3570: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 3GlobalConfig.bC
3580: 6f 72 65 4d 75 74 65 78 20 3d 20 31 3b 20 20 2f oreMutex = 1; /
3590: 2a 20 45 6e 61 62 6c 65 20 6d 75 74 65 78 20 6f * Enable mutex o
35a0: 6e 20 63 6f 72 65 20 2a 2f 0a 20 20 20 20 20 20 n core */.
35b0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
35c0: 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d fig.bFullMutex =
35d0: 20 31 3b 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6d 1; /* Enable m
35e0: 75 74 65 78 20 6f 6e 20 63 6f 6e 6e 65 63 74 69 utex on connecti
35f0: 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 ons */. bre
3600: 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 ak;. }.#endif
3610: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
3620: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 29 20 ITE_THREADSAFE)
3630: 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 && SQLITE_THREAD
3640: 53 41 46 45 3e 30 20 2f 2a 20 49 4d 50 3a 20 52 SAFE>0 /* IMP: R
3650: 2d 36 33 36 36 36 2d 34 38 37 35 35 20 2a 2f 0a -63666-48755 */.
3660: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
3670: 43 4f 4e 46 49 47 5f 4d 55 54 45 58 3a 20 7b 0a CONFIG_MUTEX: {.
3680: 20 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 /* Specify
3690: 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 an alternative
36a0: 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 mutex implementa
36b0: 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 tion */. sq
36c0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
36d0: 67 2e 6d 75 74 65 78 20 3d 20 2a 76 61 5f 61 72 g.mutex = *va_ar
36e0: 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 75 g(ap, sqlite3_mu
36f0: 74 65 78 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 tex_methods*);.
3700: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
3710: 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 }.#endif.#if def
3720: 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 ined(SQLITE_THRE
3730: 41 44 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 ADSAFE) && SQLIT
3740: 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 20 2f E_THREADSAFE>0 /
3750: 2a 20 49 4d 50 3a 20 52 2d 31 34 34 35 30 2d 33 * IMP: R-14450-3
3760: 37 35 39 37 20 2a 2f 0a 20 20 20 20 63 61 73 65 7597 */. case
3770: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 SQLITE_CONFIG_G
3780: 45 54 4d 55 54 45 58 3a 20 7b 0a 20 20 20 20 20 ETMUTEX: {.
3790: 20 2f 2a 20 52 65 74 72 69 65 76 65 20 74 68 65 /* Retrieve the
37a0: 20 63 75 72 72 65 6e 74 20 6d 75 74 65 78 20 69 current mutex i
37b0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f mplementation */
37c0: 0a 20 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 . *va_arg(a
37d0: 70 2c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 p, sqlite3_mutex
37e0: 5f 6d 65 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c _methods*) = sql
37f0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3800: 2e 6d 75 74 65 78 3b 0a 20 20 20 20 20 20 62 72 .mutex;. br
3810: 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 eak;. }.#endi
3820: 66 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 f.. case SQLI
3830: 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 TE_CONFIG_MALLOC
3840: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 : {. /* EVI
3850: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 35 35 39 DENCE-OF: R-5559
3860: 34 2d 32 31 30 33 30 20 54 68 65 20 53 51 4c 49 4-21030 The SQLI
3870: 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 TE_CONFIG_MALLOC
3880: 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a option takes a.
3890: 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 ** single
38a0: 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 argument which i
38b0: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 s a pointer to a
38c0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
38d0: 65 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 e. ** sqlit
38e0: 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 73 e3_mem_methods s
38f0: 74 72 75 63 74 75 72 65 2e 20 54 68 65 20 61 72 tructure. The ar
3900: 67 75 6d 65 6e 74 20 73 70 65 63 69 66 69 65 73 gument specifies
3910: 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 20 alternative.
3920: 20 20 20 2a 2a 20 6c 6f 77 2d 6c 65 76 65 6c 20 ** low-level
3930: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
3940: 6e 20 72 6f 75 74 69 6e 65 73 20 74 6f 20 62 65 n routines to be
3950: 20 75 73 65 64 20 69 6e 20 70 6c 61 63 65 20 6f used in place o
3960: 66 20 74 68 65 20 6d 65 6d 6f 72 79 0a 20 20 20 f the memory.
3970: 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e ** allocation
3980: 20 72 6f 75 74 69 6e 65 73 20 62 75 69 6c 74 20 routines built
3990: 69 6e 74 6f 20 53 51 4c 69 74 65 2e 20 2a 2f 0a into SQLite. */.
39a0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
39b0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 76 balConfig.m = *v
39c0: 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 a_arg(ap, sqlite
39d0: 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 2a 29 3b 3_mem_methods*);
39e0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
39f0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
3a00: 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 41 ITE_CONFIG_GETMA
3a10: 4c 4c 4f 43 3a 20 7b 0a 20 20 20 20 20 20 2f 2a LLOC: {. /*
3a20: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
3a30: 35 31 32 31 33 2d 34 36 34 31 34 20 54 68 65 20 51213-46414 The
3a40: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 SQLITE_CONFIG_GE
3a50: 54 4d 41 4c 4c 4f 43 20 6f 70 74 69 6f 6e 20 74 TMALLOC option t
3a60: 61 6b 65 73 20 61 0a 20 20 20 20 20 20 2a 2a 20 akes a. **
3a70: 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 single argument
3a80: 77 68 69 63 68 20 69 73 20 61 20 70 6f 69 6e 74 which is a point
3a90: 65 72 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63 er to an instanc
3aa0: 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a e of the. *
3ab0: 2a 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 * sqlite3_mem_me
3ac0: 74 68 6f 64 73 20 73 74 72 75 63 74 75 72 65 2e thods structure.
3ad0: 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6d 65 6d The sqlite3_mem
3ae0: 5f 6d 65 74 68 6f 64 73 20 73 74 72 75 63 74 75 _methods structu
3af0: 72 65 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 66 re is. ** f
3b00: 69 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 63 illed with the c
3b10: 75 72 72 65 6e 74 6c 79 20 64 65 66 69 6e 65 64 urrently defined
3b20: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
3b30: 6f 6e 20 72 6f 75 74 69 6e 65 73 2e 20 2a 2f 0a on routines. */.
3b40: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
3b50: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 3GlobalConfig.m.
3b60: 78 4d 61 6c 6c 6f 63 3d 3d 30 20 29 20 73 71 6c xMalloc==0 ) sql
3b70: 69 74 65 33 4d 65 6d 53 65 74 44 65 66 61 75 6c ite3MemSetDefaul
3b80: 74 28 29 3b 0a 20 20 20 20 20 20 2a 76 61 5f 61 t();. *va_a
3b90: 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d rg(ap, sqlite3_m
3ba0: 65 6d 5f 6d 65 74 68 6f 64 73 2a 29 20 3d 20 73 em_methods*) = s
3bb0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3bc0: 69 67 2e 6d 3b 0a 20 20 20 20 20 20 62 72 65 61 ig.m;. brea
3bd0: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 k;. }. cas
3be0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3bf0: 4d 45 4d 53 54 41 54 55 53 3a 20 7b 0a 20 20 20 MEMSTATUS: {.
3c00: 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
3c10: 46 3a 20 52 2d 36 31 32 37 35 2d 33 35 31 35 37 F: R-61275-35157
3c20: 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 The SQLITE_CONF
3c30: 49 47 5f 4d 45 4d 53 54 41 54 55 53 20 6f 70 74 IG_MEMSTATUS opt
3c40: 69 6f 6e 20 74 61 6b 65 73 0a 20 20 20 20 20 20 ion takes.
3c50: 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 ** single argume
3c60: 6e 74 20 6f 66 20 74 79 70 65 20 69 6e 74 2c 20 nt of type int,
3c70: 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 20 61 interpreted as a
3c80: 20 62 6f 6f 6c 65 61 6e 2c 20 77 68 69 63 68 20 boolean, which
3c90: 65 6e 61 62 6c 65 73 0a 20 20 20 20 20 20 2a 2a enables. **
3ca0: 20 6f 72 20 64 69 73 61 62 6c 65 73 20 74 68 65 or disables the
3cb0: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 6d collection of m
3cc0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
3cd0: 20 73 74 61 74 69 73 74 69 63 73 2e 20 2a 2f 0a statistics. */.
3ce0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3cf0: 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 balConfig.bMemst
3d00: 61 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 at = va_arg(ap,
3d10: 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 int);. brea
3d20: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 k;. }. cas
3d30: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3d40: 53 43 52 41 54 43 48 3a 20 7b 0a 20 20 20 20 20 SCRATCH: {.
3d50: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
3d60: 20 52 2d 30 38 34 30 34 2d 36 30 38 38 37 20 54 R-08404-60887 T
3d70: 68 65 72 65 20 61 72 65 20 74 68 72 65 65 20 61 here are three a
3d80: 72 67 75 6d 65 6e 74 73 20 74 6f 0a 20 20 20 20 rguments to.
3d90: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 ** SQLITE_CONF
3da0: 49 47 5f 53 43 52 41 54 43 48 3a 20 41 20 70 6f IG_SCRATCH: A po
3db0: 69 6e 74 65 72 20 61 6e 20 38 2d 62 79 74 65 20 inter an 8-byte
3dc0: 61 6c 69 67 6e 65 64 20 6d 65 6d 6f 72 79 20 62 aligned memory b
3dd0: 75 66 66 65 72 20 66 72 6f 6d 0a 20 20 20 20 20 uffer from.
3de0: 20 2a 2a 20 77 68 69 63 68 20 74 68 65 20 73 63 ** which the sc
3df0: 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e ratch allocation
3e00: 73 20 77 69 6c 6c 20 62 65 20 64 72 61 77 6e 2c s will be drawn,
3e10: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 65 61 63 the size of eac
3e20: 68 20 73 63 72 61 74 63 68 0a 20 20 20 20 20 20 h scratch.
3e30: 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 28 73 ** allocation (s
3e40: 7a 29 2c 20 61 6e 64 20 74 68 65 20 6d 61 78 69 z), and the maxi
3e50: 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 73 63 mum number of sc
3e60: 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e ratch allocation
3e70: 73 20 28 4e 29 2e 20 2a 2f 0a 20 20 20 20 20 20 s (N). */.
3e80: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3e90: 66 69 67 2e 70 53 63 72 61 74 63 68 20 3d 20 76 fig.pScratch = v
3ea0: 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 a_arg(ap, void*)
3eb0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
3ec0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 lobalConfig.szSc
3ed0: 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 ratch = va_arg(a
3ee0: 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 p, int);. s
3ef0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3f00: 69 67 2e 6e 53 63 72 61 74 63 68 20 3d 20 76 61 ig.nScratch = va
3f10: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
3f20: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
3f30: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
3f40: 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 E_CONFIG_PAGECAC
3f50: 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 HE: {. /* E
3f60: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 38 VIDENCE-OF: R-18
3f70: 37 36 31 2d 33 36 36 30 31 20 54 68 65 72 65 20 761-36601 There
3f80: 61 72 65 20 74 68 72 65 65 20 61 72 67 75 6d 65 are three argume
3f90: 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 nts to. **
3fa0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 SQLITE_CONFIG_PA
3fb0: 47 45 43 41 43 48 45 3a 20 41 20 70 6f 69 6e 74 GECACHE: A point
3fc0: 65 72 20 74 6f 20 38 2d 62 79 74 65 20 61 6c 69 er to 8-byte ali
3fd0: 67 6e 65 64 20 6d 65 6d 6f 72 79 20 28 70 4d 65 gned memory (pMe
3fe0: 6d 29 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 m),. ** the
3ff0: 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 70 61 size of each pa
4000: 67 65 20 63 61 63 68 65 20 6c 69 6e 65 20 28 73 ge cache line (s
4010: 7a 29 2c 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 z), and the numb
4020: 65 72 20 6f 66 20 63 61 63 68 65 20 6c 69 6e 65 er of cache line
4030: 73 0a 20 20 20 20 20 20 2a 2a 20 28 4e 29 2e 20 s. ** (N).
4040: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
4050: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 GlobalConfig.pPa
4060: 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ge = va_arg(ap,
4070: 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 void*);. sq
4080: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
4090: 67 2e 73 7a 50 61 67 65 20 3d 20 76 61 5f 61 72 g.szPage = va_ar
40a0: 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
40b0: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
40c0: 6f 6e 66 69 67 2e 6e 50 61 67 65 20 3d 20 76 61 onfig.nPage = va
40d0: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
40e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
40f0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
4100: 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 5f E_CONFIG_PCACHE_
4110: 48 44 52 53 5a 3a 20 7b 0a 20 20 20 20 20 20 2f HDRSZ: {. /
4120: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
4130: 2d 33 39 31 30 30 2d 32 37 33 31 37 20 54 68 65 -39100-27317 The
4140: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
4150: 43 41 43 48 45 5f 48 44 52 53 5a 20 6f 70 74 69 CACHE_HDRSZ opti
4160: 6f 6e 20 74 61 6b 65 73 0a 20 20 20 20 20 20 2a on takes. *
4170: 2a 20 61 20 73 69 6e 67 6c 65 20 70 61 72 61 6d * a single param
4180: 65 74 65 72 20 77 68 69 63 68 20 69 73 20 61 20 eter which is a
4190: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e pointer to an in
41a0: 74 65 67 65 72 20 61 6e 64 20 77 72 69 74 65 73 teger and writes
41b0: 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 into. ** t
41c0: 68 61 74 20 69 6e 74 65 67 65 72 20 74 68 65 20 hat integer the
41d0: 6e 75 6d 62 65 72 20 6f 66 20 65 78 74 72 61 20 number of extra
41e0: 62 79 74 65 73 20 70 65 72 20 70 61 67 65 20 72 bytes per page r
41f0: 65 71 75 69 72 65 64 20 66 6f 72 20 65 61 63 68 equired for each
4200: 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 page. ** i
4210: 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f n SQLITE_CONFIG_
4220: 50 41 47 45 43 41 43 48 45 2e 20 2a 2f 0a 20 20 PAGECACHE. */.
4230: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
4240: 69 6e 74 2a 29 20 3d 20 0a 20 20 20 20 20 20 20 int*) = .
4250: 20 20 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 sqlite3Header
4260: 53 69 7a 65 42 74 72 65 65 28 29 20 2b 0a 20 20 SizeBtree() +.
4270: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 48 sqlite3H
4280: 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 65 28 eaderSizePcache(
4290: 29 20 2b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ) +. sq
42a0: 6c 69 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 lite3HeaderSizeP
42b0: 63 61 63 68 65 31 28 29 3b 0a 20 20 20 20 20 20 cache1();.
42c0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
42d0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
42e0: 4e 46 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 NFIG_PCACHE: {.
42f0: 20 20 20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f /* no-op */
4300: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
4310: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
4320: 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 ITE_CONFIG_GETPC
4330: 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a ACHE: {. /*
4340: 20 6e 6f 77 20 61 6e 20 65 72 72 6f 72 20 2a 2f now an error */
4350: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
4360: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 TE_ERROR;.
4370: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
4380: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
4390: 4e 46 49 47 5f 50 43 41 43 48 45 32 3a 20 7b 0a NFIG_PCACHE2: {.
43a0: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
43b0: 45 2d 4f 46 3a 20 52 2d 36 33 33 32 35 2d 34 38 E-OF: R-63325-48
43c0: 33 37 38 20 54 68 65 20 53 51 4c 49 54 45 5f 43 378 The SQLITE_C
43d0: 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 20 6f 70 ONFIG_PCACHE2 op
43e0: 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 tion takes a.
43f0: 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 ** single arg
4400: 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 61 ument which is a
4410: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 73 pointer to an s
4420: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
4430: 74 68 6f 64 73 32 0a 20 20 20 20 20 20 2a 2a 20 thods2. **
4440: 6f 62 6a 65 63 74 2e 20 54 68 69 73 20 6f 62 6a object. This obj
4450: 65 63 74 20 73 70 65 63 69 66 69 65 73 20 74 68 ect specifies th
4460: 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 61 e interface to a
4470: 20 63 75 73 74 6f 6d 20 70 61 67 65 20 63 61 63 custom page cac
4480: 68 65 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6c he. ** impl
4490: 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 2a 2f 0a 20 ementation. */.
44a0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
44b0: 61 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 32 alConfig.pcache2
44c0: 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 = *va_arg(ap, s
44d0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
44e0: 74 68 6f 64 73 32 2a 29 3b 0a 20 20 20 20 20 20 thods2*);.
44f0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
4500: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
4510: 46 49 47 5f 47 45 54 50 43 41 43 48 45 32 3a 20 FIG_GETPCACHE2:
4520: 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 {. /* EVIDE
4530: 4e 43 45 2d 4f 46 3a 20 52 2d 32 32 30 33 35 2d NCE-OF: R-22035-
4540: 34 36 31 38 32 20 54 68 65 20 53 51 4c 49 54 45 46182 The SQLITE
4550: 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 48 _CONFIG_GETPCACH
4560: 45 32 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 E2 option takes
4570: 61 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c a. ** singl
4580: 65 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 e argument which
4590: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f is a pointer to
45a0: 20 61 6e 20 73 71 6c 69 74 65 33 5f 70 63 61 63 an sqlite3_pcac
45b0: 68 65 5f 6d 65 74 68 6f 64 73 32 0a 20 20 20 20 he_methods2.
45c0: 20 20 2a 2a 20 6f 62 6a 65 63 74 2e 20 53 51 4c ** object. SQL
45d0: 69 74 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 ite copies of th
45e0: 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 e current page c
45f0: 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 ache implementat
4600: 69 6f 6e 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a ion into. *
4610: 2a 20 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 2a * that object. *
4620: 2f 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 /. if( sqli
4630: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4640: 70 63 61 63 68 65 32 2e 78 49 6e 69 74 3d 3d 30 pcache2.xInit==0
4650: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
4660: 74 65 33 50 43 61 63 68 65 53 65 74 44 65 66 61 te3PCacheSetDefa
4670: 75 6c 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 ult();. }.
4680: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
4690: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f sqlite3_pcache_
46a0: 6d 65 74 68 6f 64 73 32 2a 29 20 3d 20 73 71 6c methods2*) = sql
46b0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
46c0: 2e 70 63 61 63 68 65 32 3b 0a 20 20 20 20 20 20 .pcache2;.
46d0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 2f 2a break;. }../*
46e0: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
46f0: 30 36 36 32 36 2d 31 32 39 31 31 20 54 68 65 20 06626-12911 The
4700: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 SQLITE_CONFIG_HE
4710: 41 50 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6e 6c AP option is onl
4720: 79 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 69 y.** available i
4730: 66 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 f SQLite is comp
4740: 69 6c 65 64 20 77 69 74 68 20 65 69 74 68 65 72 iled with either
4750: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
4760: 45 4d 53 59 53 33 20 6f 72 0a 2a 2a 20 53 51 4c EMSYS3 or.** SQL
4770: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4780: 53 35 20 61 6e 64 20 72 65 74 75 72 6e 73 20 53 S5 and returns S
4790: 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 66 20 69 QLITE_ERROR if i
47a0: 6e 76 6f 6b 65 64 20 6f 74 68 65 72 77 69 73 65 nvoked otherwise
47b0: 2e 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 . */.#if defined
47c0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d (SQLITE_ENABLE_M
47d0: 45 4d 53 59 53 33 29 20 7c 7c 20 64 65 66 69 6e EMSYS3) || defin
47e0: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
47f0: 5f 4d 45 4d 53 59 53 35 29 0a 20 20 20 20 63 61 _MEMSYS5). ca
4800: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
4810: 5f 48 45 41 50 3a 20 7b 0a 20 20 20 20 20 20 2f _HEAP: {. /
4820: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
4830: 2d 31 39 38 35 34 2d 34 32 31 32 36 20 54 68 65 -19854-42126 The
4840: 72 65 20 61 72 65 20 74 68 72 65 65 20 61 72 67 re are three arg
4850: 75 6d 65 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 uments to.
4860: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ** SQLITE_CONFIG
4870: 5f 48 45 41 50 3a 20 41 6e 20 38 2d 62 79 74 65 _HEAP: An 8-byte
4880: 20 61 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65 72 aligned pointer
4890: 20 74 6f 20 74 68 65 20 6d 65 6d 6f 72 79 2c 20 to the memory,
48a0: 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 6e 75 6d the. ** num
48b0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
48c0: 74 68 65 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 the memory buffe
48d0: 72 2c 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 6d r, and the minim
48e0: 75 6d 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 um allocation si
48f0: 7a 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ze.. */.
4900: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
4910: 43 6f 6e 66 69 67 2e 70 48 65 61 70 20 3d 20 76 Config.pHeap = v
4920: 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 a_arg(ap, void*)
4930: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
4940: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 lobalConfig.nHea
4950: 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 p = va_arg(ap, i
4960: 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
4970: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4980: 6e 52 65 71 20 3d 20 76 61 5f 61 72 67 28 61 70 nReq = va_arg(ap
4990: 2c 20 69 6e 74 29 3b 0a 0a 20 20 20 20 20 20 69 , int);.. i
49a0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
49b0: 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 3c 31 20 29 Config.mnReq<1 )
49c0: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
49d0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 3GlobalConfig.mn
49e0: 52 65 71 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d Req = 1;. }
49f0: 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 else if( sqlite3
4a00: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 GlobalConfig.mnR
4a10: 65 71 3e 28 31 3c 3c 31 32 29 20 29 7b 0a 20 20 eq>(1<<12) ){.
4a20: 20 20 20 20 20 20 2f 2a 20 63 61 70 20 6d 69 6e /* cap min
4a30: 20 72 65 71 75 65 73 74 20 73 69 7a 65 20 61 74 request size at
4a40: 20 32 5e 31 32 20 2a 2f 0a 20 20 20 20 20 20 20 2^12 */.
4a50: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
4a60: 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 28 31 3c nfig.mnReq = (1<
4a70: 3c 31 32 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 <12);. }..
4a80: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
4a90: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 GlobalConfig.pHe
4aa0: 61 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ap==0 ){.
4ab0: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
4ac0: 20 52 2d 34 39 39 32 30 2d 36 30 31 38 39 20 49 R-49920-60189 I
4ad0: 66 20 74 68 65 20 66 69 72 73 74 20 70 6f 69 6e f the first poin
4ae0: 74 65 72 20 28 74 68 65 20 6d 65 6d 6f 72 79 20 ter (the memory
4af0: 70 6f 69 6e 74 65 72 29 0a 20 20 20 20 20 20 20 pointer).
4b00: 20 2a 2a 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 ** is NULL, the
4b10: 6e 20 53 51 4c 69 74 65 20 72 65 76 65 72 74 73 n SQLite reverts
4b20: 20 74 6f 20 75 73 69 6e 67 20 69 74 73 20 64 65 to using its de
4b30: 66 61 75 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c fault memory all
4b40: 6f 63 61 74 6f 72 0a 20 20 20 20 20 20 20 20 2a ocator. *
4b50: 2a 20 28 74 68 65 20 73 79 73 74 65 6d 20 6d 61 * (the system ma
4b60: 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 lloc() implement
4b70: 61 74 69 6f 6e 29 2c 20 75 6e 64 6f 69 6e 67 20 ation), undoing
4b80: 61 6e 79 20 70 72 69 6f 72 20 69 6e 76 6f 63 61 any prior invoca
4b90: 74 69 6f 6e 20 6f 66 0a 20 20 20 20 20 20 20 20 tion of.
4ba0: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ** SQLITE_CONFIG
4bb0: 5f 4d 41 4c 4c 4f 43 2e 0a 20 20 20 20 20 20 20 _MALLOC..
4bc0: 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 **. ** S
4bd0: 65 74 74 69 6e 67 20 73 71 6c 69 74 65 33 47 6c etting sqlite3Gl
4be0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 74 6f 20 obalConfig.m to
4bf0: 61 6c 6c 20 7a 65 72 6f 73 20 77 69 6c 6c 20 63 all zeros will c
4c00: 61 75 73 65 20 6d 61 6c 6c 6f 63 20 74 6f 0a 20 ause malloc to.
4c10: 20 20 20 20 20 20 20 2a 2a 20 72 65 76 65 72 74 ** revert
4c20: 20 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 to its default
4c30: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 implementation w
4c40: 68 65 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 hen sqlite3_init
4c50: 69 61 6c 69 7a 65 28 29 20 69 73 20 72 75 6e 0a ialize() is run.
4c60: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
4c70: 20 20 20 6d 65 6d 73 65 74 28 26 73 71 6c 69 74 memset(&sqlit
4c80: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4c90: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 , 0, sizeof(sqli
4ca0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4cb0: 6d 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 m));. }else
4cc0: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 {. /* EVI
4cd0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 31 30 30 DENCE-OF: R-6100
4ce0: 36 2d 30 38 39 31 38 20 49 66 20 74 68 65 20 6d 6-08918 If the m
4cf0: 65 6d 6f 72 79 20 70 6f 69 6e 74 65 72 20 69 73 emory pointer is
4d00: 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 74 not NULL then t
4d10: 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6c he. ** al
4d20: 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 ternative memory
4d30: 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 65 6e allocator is en
4d40: 67 61 67 65 64 20 74 6f 20 68 61 6e 64 6c 65 20 gaged to handle
4d50: 61 6c 6c 20 6f 66 20 53 51 4c 69 74 65 73 0a 20 all of SQLites.
4d60: 20 20 20 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 ** memory
4d70: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6e 65 65 64 allocation need
4d80: 73 2e 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c s. */.#ifdef SQL
4d90: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4da0: 53 33 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 S3. sqlit
4db0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4dc0: 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 = *sqlite3MemGe
4dd0: 74 4d 65 6d 73 79 73 33 28 29 3b 0a 23 65 6e 64 tMemsys3();.#end
4de0: 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 if.#ifdef SQLITE
4df0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 0a _ENABLE_MEMSYS5.
4e00: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 sqlite3G
4e10: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 lobalConfig.m =
4e20: 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 *sqlite3MemGetMe
4e30: 6d 73 79 73 35 28 29 3b 0a 23 65 6e 64 69 66 0a msys5();.#endif.
4e40: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 }. br
4e50: 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 eak;. }.#endi
4e60: 66 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 f.. case SQLI
4e70: 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 TE_CONFIG_LOOKAS
4e80: 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c IDE: {. sql
4e90: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4ea0: 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 76 .szLookaside = v
4eb0: 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
4ec0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
4ed0: 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 balConfig.nLooka
4ee0: 73 69 64 65 20 3d 20 76 61 5f 61 72 67 28 61 70 side = va_arg(ap
4ef0: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
4f00: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 0a eak;. }. .
4f10: 20 20 20 20 2f 2a 20 52 65 63 6f 72 64 20 61 20 /* Record a
4f20: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6c pointer to the l
4f30: 6f 67 67 65 72 20 66 75 6e 63 74 69 6f 6e 20 61 ogger function a
4f40: 6e 64 20 69 74 73 20 66 69 72 73 74 20 61 72 67 nd its first arg
4f50: 75 6d 65 6e 74 2e 0a 20 20 20 20 2a 2a 20 54 68 ument.. ** Th
4f60: 65 20 64 65 66 61 75 6c 74 20 69 73 20 4e 55 4c e default is NUL
4f70: 4c 2e 20 20 4c 6f 67 67 69 6e 67 20 69 73 20 64 L. Logging is d
4f80: 69 73 61 62 6c 65 64 20 69 66 20 74 68 65 20 66 isabled if the f
4f90: 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 unction pointer
4fa0: 69 73 0a 20 20 20 20 2a 2a 20 4e 55 4c 4c 2e 0a is. ** NULL..
4fb0: 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
4fc0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f SQLITE_CONFIG_LO
4fd0: 47 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 4d 53 G: {. /* MS
4fe0: 56 43 20 69 73 20 70 69 63 6b 79 20 61 62 6f 75 VC is picky abou
4ff0: 74 20 70 75 6c 6c 69 6e 67 20 66 75 6e 63 20 70 t pulling func p
5000: 74 72 73 20 66 72 6f 6d 20 76 61 20 6c 69 73 74 trs from va list
5010: 73 2e 0a 20 20 20 20 20 20 2a 2a 20 68 74 74 70 s.. ** http
5020: 3a 2f 2f 73 75 70 70 6f 72 74 2e 6d 69 63 72 6f ://support.micro
5030: 73 6f 66 74 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 soft.com/kb/4796
5040: 31 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 1. ** sqlit
5050: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
5060: 4c 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c Log = va_arg(ap,
5070: 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 2c 69 void(*)(void*,i
5080: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 nt,const char*))
5090: 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 ;. */.
50a0: 20 74 79 70 65 64 65 66 20 76 6f 69 64 28 2a 4c typedef void(*L
50b0: 4f 47 46 55 4e 43 5f 74 29 28 76 6f 69 64 2a 2c OGFUNC_t)(void*,
50c0: 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 int,const char*)
50d0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
50e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
50f0: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 4c 4f = va_arg(ap, LO
5100: 47 46 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 GFUNC_t);.
5110: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
5120: 66 69 67 2e 70 4c 6f 67 41 72 67 20 3d 20 76 61 fig.pLogArg = va
5130: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b _arg(ap, void*);
5140: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
5150: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 45 56 49 44 }.. /* EVID
5160: 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 35 35 34 38 ENCE-OF: R-55548
5170: 2d 33 33 38 31 37 20 54 68 65 20 63 6f 6d 70 69 -33817 The compi
5180: 6c 65 2d 74 69 6d 65 20 73 65 74 74 69 6e 67 20 le-time setting
5190: 66 6f 72 20 55 52 49 20 66 69 6c 65 6e 61 6d 65 for URI filename
51a0: 73 0a 20 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 s. ** can be
51b0: 63 68 61 6e 67 65 64 20 61 74 20 73 74 61 72 74 changed at start
51c0: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 0a -time using the.
51d0: 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 ** sqlite3_c
51e0: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e onfig(SQLITE_CON
51f0: 46 49 47 5f 55 52 49 2c 31 29 20 6f 72 0a 20 20 FIG_URI,1) or.
5200: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e ** sqlite3_con
5210: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 fig(SQLITE_CONFI
5220: 47 5f 55 52 49 2c 30 29 20 63 6f 6e 66 69 67 75 G_URI,0) configu
5230: 72 61 74 69 6f 6e 20 63 61 6c 6c 73 2e 0a 20 20 ration calls..
5240: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
5250: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 55 52 49 3a LITE_CONFIG_URI:
5260: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 {. /* EVID
5270: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 34 35 31 ENCE-OF: R-25451
5280: 2d 36 31 31 32 35 20 54 68 65 20 53 51 4c 49 54 -61125 The SQLIT
5290: 45 5f 43 4f 4e 46 49 47 5f 55 52 49 20 6f 70 74 E_CONFIG_URI opt
52a0: 69 6f 6e 20 74 61 6b 65 73 20 61 20 73 69 6e 67 ion takes a sing
52b0: 6c 65 0a 20 20 20 20 20 20 2a 2a 20 61 72 67 75 le. ** argu
52c0: 6d 65 6e 74 20 6f 66 20 74 79 70 65 20 69 6e 74 ment of type int
52d0: 2e 20 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 . If non-zero, t
52e0: 68 65 6e 20 55 52 49 20 68 61 6e 64 6c 69 6e 67 hen URI handling
52f0: 20 69 73 20 67 6c 6f 62 61 6c 6c 79 0a 20 20 20 is globally.
5300: 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e 20 49 ** enabled. I
5310: 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 f the parameter
5320: 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 55 52 is zero, then UR
5330: 49 20 68 61 6e 64 6c 69 6e 67 20 69 73 20 67 6c I handling is gl
5340: 6f 62 61 6c 6c 79 0a 20 20 20 20 20 20 2a 2a 20 obally. **
5350: 64 69 73 61 62 6c 65 64 2e 20 2a 2f 0a 20 20 20 disabled. */.
5360: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
5370: 43 6f 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 20 Config.bOpenUri
5380: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
5390: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
53a0: 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 }.. case
53b0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f SQLITE_CONFIG_CO
53c0: 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 VERING_INDEX_SCA
53d0: 4e 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 N: {. /* EV
53e0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 36 35 IDENCE-OF: R-365
53f0: 39 32 2d 30 32 37 37 32 20 54 68 65 20 53 51 4c 92-02772 The SQL
5400: 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 ITE_CONFIG_COVER
5410: 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e 0a 20 ING_INDEX_SCAN.
5420: 20 20 20 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 74 ** option t
5430: 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 20 69 6e akes a single in
5440: 74 65 67 65 72 20 61 72 67 75 6d 65 6e 74 20 77 teger argument w
5450: 68 69 63 68 20 69 73 20 69 6e 74 65 72 70 72 65 hich is interpre
5460: 74 65 64 20 61 73 20 61 0a 20 20 20 20 20 20 2a ted as a. *
5470: 2a 20 62 6f 6f 6c 65 61 6e 20 69 6e 20 6f 72 64 * boolean in ord
5480: 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 6f 72 20 er to enable or
5490: 64 69 73 61 62 6c 65 20 74 68 65 20 75 73 65 20 disable the use
54a0: 6f 66 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 of covering indi
54b0: 63 65 73 20 66 6f 72 0a 20 20 20 20 20 20 2a 2a ces for. **
54c0: 20 66 75 6c 6c 20 74 61 62 6c 65 20 73 63 61 6e full table scan
54d0: 73 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 6f s in the query o
54e0: 70 74 69 6d 69 7a 65 72 2e 20 2a 2f 0a 20 20 20 ptimizer. */.
54f0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
5500: 43 6f 6e 66 69 67 2e 62 55 73 65 43 69 73 20 3d Config.bUseCis =
5510: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
5520: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
5530: 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c }..#ifdef SQL
5540: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f ITE_ENABLE_SQLLO
5550: 47 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 G. case SQLIT
5560: 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f 47 3a E_CONFIG_SQLLOG:
5570: 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 {. typedef
5580: 20 76 6f 69 64 28 2a 53 51 4c 4c 4f 47 46 55 4e void(*SQLLOGFUN
5590: 43 5f 74 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69 C_t)(void*, sqli
55a0: 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 te3*, const char
55b0: 2a 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 *, int);. s
55c0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
55d0: 69 67 2e 78 53 71 6c 6c 6f 67 20 3d 20 76 61 5f ig.xSqllog = va_
55e0: 61 72 67 28 61 70 2c 20 53 51 4c 4c 4f 47 46 55 arg(ap, SQLLOGFU
55f0: 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 6c NC_t);. sql
5600: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
5610: 2e 70 53 71 6c 6c 6f 67 41 72 67 20 3d 20 76 61 .pSqllogArg = va
5620: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 20 2a 29 _arg(ap, void *)
5630: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
5640: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 }.#endif..
5650: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
5660: 46 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 3a 20 7b FIG_MMAP_SIZE: {
5670: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
5680: 43 45 2d 4f 46 3a 20 52 2d 35 38 30 36 33 2d 33 CE-OF: R-58063-3
5690: 38 32 35 38 20 53 51 4c 49 54 45 5f 43 4f 4e 46 8258 SQLITE_CONF
56a0: 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 20 74 61 6b IG_MMAP_SIZE tak
56b0: 65 73 20 74 77 6f 20 36 34 2d 62 69 74 0a 20 20 es two 64-bit.
56c0: 20 20 20 20 2a 2a 20 69 6e 74 65 67 65 72 20 28 ** integer (
56d0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 20 76 sqlite3_int64) v
56e0: 61 6c 75 65 73 20 74 68 61 74 20 61 72 65 20 74 alues that are t
56f0: 68 65 20 64 65 66 61 75 6c 74 20 6d 6d 61 70 20 he default mmap
5700: 73 69 7a 65 20 6c 69 6d 69 74 0a 20 20 20 20 20 size limit.
5710: 20 2a 2a 20 28 74 68 65 20 64 65 66 61 75 6c 74 ** (the default
5720: 20 73 65 74 74 69 6e 67 20 66 6f 72 20 50 52 41 setting for PRA
5730: 47 4d 41 20 6d 6d 61 70 5f 73 69 7a 65 29 20 61 GMA mmap_size) a
5740: 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 nd the maximum a
5750: 6c 6c 6f 77 65 64 0a 20 20 20 20 20 20 2a 2a 20 llowed. **
5760: 6d 6d 61 70 20 73 69 7a 65 20 6c 69 6d 69 74 2e mmap size limit.
5770: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
5780: 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 20 3d 3_int64 szMmap =
5790: 20 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 va_arg(ap, sqli
57a0: 74 65 33 5f 69 6e 74 36 34 29 3b 0a 20 20 20 20 te3_int64);.
57b0: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
57c0: 6d 78 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 mxMmap = va_arg(
57d0: 61 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 ap, sqlite3_int6
57e0: 34 29 3b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 4);. /* EVI
57f0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 33 33 36 DENCE-OF: R-5336
5800: 37 2d 34 33 31 39 30 20 49 66 20 65 69 74 68 65 7-43190 If eithe
5810: 72 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 r argument to th
5820: 69 73 20 6f 70 74 69 6f 6e 20 69 73 0a 20 20 20 is option is.
5830: 20 20 20 2a 2a 20 6e 65 67 61 74 69 76 65 2c 20 ** negative,
5840: 74 68 65 6e 20 74 68 61 74 20 61 72 67 75 6d 65 then that argume
5850: 6e 74 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f nt is changed to
5860: 20 69 74 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d its compile-tim
5870: 65 20 64 65 66 61 75 6c 74 2e 0a 20 20 20 20 20 e default..
5880: 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 45 56 49 **. ** EVI
5890: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 34 39 39 DENCE-OF: R-3499
58a0: 33 2d 34 35 30 33 31 20 54 68 65 20 6d 61 78 69 3-45031 The maxi
58b0: 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 6d 6d 61 70 mum allowed mmap
58c0: 20 73 69 7a 65 20 77 69 6c 6c 20 62 65 0a 20 20 size will be.
58d0: 20 20 20 20 2a 2a 20 73 69 6c 65 6e 74 6c 79 20 ** silently
58e0: 74 72 75 6e 63 61 74 65 64 20 69 66 20 6e 65 63 truncated if nec
58f0: 65 73 73 61 72 79 20 73 6f 20 74 68 61 74 20 69 essary so that i
5900: 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 63 65 65 t does not excee
5910: 64 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 63 d the. ** c
5920: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6d 61 78 69 ompile-time maxi
5930: 6d 75 6d 20 6d 6d 61 70 20 73 69 7a 65 20 73 65 mum mmap size se
5940: 74 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f t by the SQLITE_
5950: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 20 20 MAX_MMAP_SIZE.
5960: 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 ** compile-t
5970: 69 6d 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 20 20 ime option..
5980: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d */. if( m
5990: 78 4d 6d 61 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 xMmap<0 || mxMma
59a0: 70 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 p>SQLITE_MAX_MMA
59b0: 50 5f 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 P_SIZE ){.
59c0: 20 20 6d 78 4d 6d 61 70 20 3d 20 53 51 4c 49 54 mxMmap = SQLIT
59d0: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b E_MAX_MMAP_SIZE;
59e0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
59f0: 66 28 20 73 7a 4d 6d 61 70 3c 30 20 29 20 73 7a f( szMmap<0 ) sz
5a00: 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f 44 45 Mmap = SQLITE_DE
5a10: 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 3b FAULT_MMAP_SIZE;
5a20: 0a 20 20 20 20 20 20 69 66 28 20 73 7a 4d 6d 61 . if( szMma
5a30: 70 3e 6d 78 4d 6d 61 70 29 20 73 7a 4d 6d 61 70 p>mxMmap) szMmap
5a40: 20 3d 20 6d 78 4d 6d 61 70 3b 0a 20 20 20 20 20 = mxMmap;.
5a50: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
5a60: 6e 66 69 67 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 nfig.mxMmap = mx
5a70: 4d 6d 61 70 3b 0a 20 20 20 20 20 20 73 71 6c 69 Mmap;. sqli
5a80: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
5a90: 73 7a 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b szMmap = szMmap;
5aa0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
5ab0: 20 20 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f }..#if SQLITE_
5ac0: 4f 53 5f 57 49 4e 20 26 26 20 64 65 66 69 6e 65 OS_WIN && define
5ad0: 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d d(SQLITE_WIN32_M
5ae0: 41 4c 4c 4f 43 29 20 2f 2a 20 49 4d 50 3a 20 52 ALLOC) /* IMP: R
5af0: 2d 30 34 37 38 30 2d 35 35 38 31 35 20 2a 2f 0a -04780-55815 */.
5b00: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
5b10: 43 4f 4e 46 49 47 5f 57 49 4e 33 32 5f 48 45 41 CONFIG_WIN32_HEA
5b20: 50 53 49 5a 45 3a 20 7b 0a 20 20 20 20 20 20 2f PSIZE: {. /
5b30: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
5b40: 2d 33 34 39 32 36 2d 30 33 33 36 30 20 53 51 4c -34926-03360 SQL
5b50: 49 54 45 5f 43 4f 4e 46 49 47 5f 57 49 4e 33 32 ITE_CONFIG_WIN32
5b60: 5f 48 45 41 50 53 49 5a 45 20 74 61 6b 65 73 20 _HEAPSIZE takes
5b70: 61 20 33 32 2d 62 69 74 0a 20 20 20 20 20 20 2a a 32-bit. *
5b80: 2a 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 * unsigned integ
5b90: 65 72 20 76 61 6c 75 65 20 74 68 61 74 20 73 70 er value that sp
5ba0: 65 63 69 66 69 65 73 20 74 68 65 20 6d 61 78 69 ecifies the maxi
5bb0: 6d 75 6d 20 73 69 7a 65 20 6f 66 20 74 68 65 20 mum size of the
5bc0: 63 72 65 61 74 65 64 0a 20 20 20 20 20 20 2a 2a created. **
5bd0: 20 68 65 61 70 2e 20 2a 2f 0a 20 20 20 20 20 20 heap. */.
5be0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
5bf0: 66 69 67 2e 6e 48 65 61 70 20 3d 20 76 61 5f 61 fig.nHeap = va_a
5c00: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
5c10: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
5c20: 23 65 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 #endif.. case
5c30: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
5c40: 4d 41 53 5a 3a 20 7b 0a 20 20 20 20 20 20 73 71 MASZ: {. sq
5c50: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
5c60: 67 2e 73 7a 50 6d 61 20 3d 20 76 61 5f 61 72 67 g.szPma = va_arg
5c70: 28 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e (ap, unsigned in
5c80: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
5c90: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 . }.. case
5ca0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 SQLITE_CONFIG_S
5cb0: 54 4d 54 4a 52 4e 4c 5f 53 50 49 4c 4c 3a 20 7b TMTJRNL_SPILL: {
5cc0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
5cd0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 74 6d 74 obalConfig.nStmt
5ce0: 53 70 69 6c 6c 20 3d 20 76 61 5f 61 72 67 28 61 Spill = va_arg(a
5cf0: 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 p, int);. b
5d00: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
5d10: 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 default: {.
5d20: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
5d30: 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 65 61 6b ROR;. break
5d40: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 ;. }. }. va
5d50: 5f 65 6e 64 28 61 70 29 3b 0a 20 20 72 65 74 75 _end(ap);. retu
5d60: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
5d70: 53 65 74 20 75 70 20 74 68 65 20 6c 6f 6f 6b 61 Set up the looka
5d80: 73 69 64 65 20 62 75 66 66 65 72 73 20 66 6f 72 side buffers for
5d90: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e a database conn
5da0: 65 63 74 69 6f 6e 2e 0a 2a 2a 20 52 65 74 75 72 ection..** Retur
5db0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 n SQLITE_OK on s
5dc0: 75 63 63 65 73 73 2e 20 20 0a 2a 2a 20 49 66 20 uccess. .** If
5dd0: 6c 6f 6f 6b 61 73 69 64 65 20 69 73 20 61 6c 72 lookaside is alr
5de0: 65 61 64 79 20 61 63 74 69 76 65 2c 20 72 65 74 eady active, ret
5df0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e urn SQLITE_BUSY.
5e00: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 7a 20 70 61 .**.** The sz pa
5e10: 72 61 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e rameter is the n
5e20: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 umber of bytes i
5e30: 6e 20 65 61 63 68 20 6c 6f 6f 6b 61 73 69 64 65 n each lookaside
5e40: 20 73 6c 6f 74 2e 0a 2a 2a 20 54 68 65 20 63 6e slot..** The cn
5e50: 74 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 t parameter is t
5e60: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 6c 6f he number of slo
5e70: 74 73 2e 20 20 49 66 20 70 53 74 61 72 74 20 69 ts. If pStart i
5e80: 73 20 4e 55 4c 4c 20 74 68 65 0a 2a 2a 20 73 70 s NULL the.** sp
5e90: 61 63 65 20 66 6f 72 20 74 68 65 20 6c 6f 6f 6b ace for the look
5ea0: 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 69 73 20 aside memory is
5eb0: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 obtained from sq
5ec0: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a lite3_malloc()..
5ed0: 2a 2a 20 49 66 20 70 53 74 61 72 74 20 69 73 20 ** If pStart is
5ee0: 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 69 74 not NULL then it
5ef0: 20 69 73 20 73 7a 2a 63 6e 74 20 62 79 74 65 73 is sz*cnt bytes
5f00: 20 6f 66 20 6d 65 6d 6f 72 79 20 74 6f 20 75 73 of memory to us
5f10: 65 20 66 6f 72 0a 2a 2a 20 74 68 65 20 6c 6f 6f e for.** the loo
5f20: 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 2e 0a 2a kaside memory..*
5f30: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 /.static int set
5f40: 75 70 4c 6f 6f 6b 61 73 69 64 65 28 73 71 6c 69 upLookaside(sqli
5f50: 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 te3 *db, void *p
5f60: 42 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 Buf, int sz, int
5f70: 20 63 6e 74 29 7b 0a 23 69 66 6e 64 65 66 20 53 cnt){.#ifndef S
5f80: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 QLITE_OMIT_LOOKA
5f90: 53 49 44 45 0a 20 20 76 6f 69 64 20 2a 70 53 74 SIDE. void *pSt
5fa0: 61 72 74 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6c art;. if( db->l
5fb0: 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 20 29 7b ookaside.nOut ){
5fc0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
5fd0: 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a 20 20 2f TE_BUSY;. }. /
5fe0: 2a 20 46 72 65 65 20 61 6e 79 20 65 78 69 73 74 * Free any exist
5ff0: 69 6e 67 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ing lookaside bu
6000: 66 66 65 72 20 66 6f 72 20 74 68 69 73 20 68 61 ffer for this ha
6010: 6e 64 6c 65 20 62 65 66 6f 72 65 0a 20 20 2a 2a ndle before. **
6020: 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 allocating a ne
6030: 77 20 6f 6e 65 20 73 6f 20 77 65 20 64 6f 6e 27 w one so we don'
6040: 74 20 68 61 76 65 20 74 6f 20 68 61 76 65 20 73 t have to have s
6050: 70 61 63 65 20 66 6f 72 20 0a 20 20 2a 2a 20 62 pace for . ** b
6060: 6f 74 68 20 61 74 20 74 68 65 20 73 61 6d 65 20 oth at the same
6070: 74 69 6d 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 time.. */. if(
6080: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 db->lookaside.b
6090: 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 Malloced ){.
60a0: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d sqlite3_free(db-
60b0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 >lookaside.pStar
60c0: 74 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 54 68 65 t);. }. /* The
60d0: 20 73 69 7a 65 20 6f 66 20 61 20 6c 6f 6f 6b 61 size of a looka
60e0: 73 69 64 65 20 73 6c 6f 74 20 61 66 74 65 72 20 side slot after
60f0: 52 4f 55 4e 44 44 4f 57 4e 38 20 6e 65 65 64 73 ROUNDDOWN8 needs
6100: 20 74 6f 20 62 65 20 6c 61 72 67 65 72 0a 20 20 to be larger.
6110: 2a 2a 20 74 68 61 6e 20 61 20 70 6f 69 6e 74 65 ** than a pointe
6120: 72 20 74 6f 20 62 65 20 75 73 65 66 75 6c 2e 0a r to be useful..
6130: 20 20 2a 2f 0a 20 20 73 7a 20 3d 20 52 4f 55 4e */. sz = ROUN
6140: 44 44 4f 57 4e 38 28 73 7a 29 3b 20 20 2f 2a 20 DDOWN8(sz); /*
6150: 49 4d 50 3a 20 52 2d 33 33 30 33 38 2d 30 39 33 IMP: R-33038-093
6160: 38 32 20 2a 2f 0a 20 20 69 66 28 20 73 7a 3c 3d 82 */. if( sz<=
6170: 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f 6f 6b (int)sizeof(Look
6180: 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 20 73 7a asideSlot*) ) sz
6190: 20 3d 20 30 3b 0a 20 20 69 66 28 20 63 6e 74 3c = 0;. if( cnt<
61a0: 30 20 29 20 63 6e 74 20 3d 20 30 3b 0a 20 20 69 0 ) cnt = 0;. i
61b0: 66 28 20 73 7a 3d 3d 30 20 7c 7c 20 63 6e 74 3d f( sz==0 || cnt=
61c0: 3d 30 20 29 7b 0a 20 20 20 20 73 7a 20 3d 20 30 =0 ){. sz = 0
61d0: 3b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 30 ;. pStart = 0
61e0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 42 ;. }else if( pB
61f0: 75 66 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c uf==0 ){. sql
6200: 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d ite3BeginBenignM
6210: 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 70 53 74 alloc();. pSt
6220: 61 72 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c art = sqlite3Mal
6230: 6c 6f 63 28 20 73 7a 2a 63 6e 74 20 29 3b 20 20 loc( sz*cnt );
6240: 2f 2a 20 49 4d 50 3a 20 52 2d 36 31 39 34 39 2d /* IMP: R-61949-
6250: 33 35 37 32 37 20 2a 2f 0a 20 20 20 20 73 71 6c 35727 */. sql
6260: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c ite3EndBenignMal
6270: 6c 6f 63 28 29 3b 0a 20 20 20 20 69 66 28 20 70 loc();. if( p
6280: 53 74 61 72 74 20 29 20 63 6e 74 20 3d 20 73 71 Start ) cnt = sq
6290: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 lite3MallocSize(
62a0: 70 53 74 61 72 74 29 2f 73 7a 3b 0a 20 20 7d 65 pStart)/sz;. }e
62b0: 6c 73 65 7b 0a 20 20 20 20 70 53 74 61 72 74 20 lse{. pStart
62c0: 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 20 20 64 62 = pBuf;. }. db
62d0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 ->lookaside.pSta
62e0: 72 74 20 3d 20 70 53 74 61 72 74 3b 0a 20 20 64 rt = pStart;. d
62f0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 b->lookaside.pFr
6300: 65 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c 6f ee = 0;. db->lo
6310: 6f 6b 61 73 69 64 65 2e 73 7a 20 3d 20 28 75 31 okaside.sz = (u1
6320: 36 29 73 7a 3b 0a 20 20 69 66 28 20 70 53 74 61 6)sz;. if( pSta
6330: 72 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b rt ){. int i;
6340: 0a 20 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c . LookasideSl
6350: 6f 74 20 2a 70 3b 0a 20 20 20 20 61 73 73 65 72 ot *p;. asser
6360: 74 28 20 73 7a 20 3e 20 28 69 6e 74 29 73 69 7a t( sz > (int)siz
6370: 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f eof(LookasideSlo
6380: 74 2a 29 20 29 3b 0a 20 20 20 20 70 20 3d 20 28 t*) );. p = (
6390: 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 70 LookasideSlot*)p
63a0: 53 74 61 72 74 3b 0a 20 20 20 20 66 6f 72 28 69 Start;. for(i
63b0: 3d 63 6e 74 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d =cnt-1; i>=0; i-
63c0: 2d 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 -){. p->pNe
63d0: 78 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 xt = db->lookasi
63e0: 64 65 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 de.pFree;.
63f0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 db->lookaside.pF
6400: 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 20 20 70 ree = p;. p
6410: 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f = (LookasideSlo
6420: 74 2a 29 26 28 28 75 38 2a 29 70 29 5b 73 7a 5d t*)&((u8*)p)[sz]
6430: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e ;. }. db->
6440: 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d lookaside.pEnd =
6450: 20 70 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b p;. db->look
6460: 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20 3d aside.bDisable =
6470: 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 0;. db->look
6480: 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 aside.bMalloced
6490: 3d 20 70 42 75 66 3d 3d 30 20 3f 31 3a 30 3b 0a = pBuf==0 ?1:0;.
64a0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d }else{. db-
64b0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 >lookaside.pStar
64c0: 74 20 3d 20 64 62 3b 0a 20 20 20 20 64 62 2d 3e t = db;. db->
64d0: 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d lookaside.pEnd =
64e0: 20 64 62 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f db;. db->loo
64f0: 6b 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20 kaside.bDisable
6500: 3d 20 31 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f = 1;. db->loo
6510: 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 kaside.bMalloced
6520: 20 3d 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 = 0;. }.#endif
6530: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
6540: 4c 4f 4f 4b 41 53 49 44 45 20 2a 2f 0a 20 20 72 LOOKASIDE */. r
6550: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6560: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
6570: 20 74 68 65 20 6d 75 74 65 78 20 61 73 73 6f 63 the mutex assoc
6580: 69 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74 iated with a dat
6590: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
65a0: 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75 74 ..*/.sqlite3_mut
65b0: 65 78 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 6d ex *sqlite3_db_m
65c0: 75 74 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 utex(sqlite3 *db
65d0: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
65e0: 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
65f0: 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
6600: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
6610: 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 ) ){. (void)S
6620: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
6630: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b T;. return 0;
6640: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 . }.#endif. re
6650: 74 75 72 6e 20 64 62 2d 3e 6d 75 74 65 78 3b 0a turn db->mutex;.
6660: 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 75 70 }../*.** Free up
6670: 20 61 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 as much memory
6680: 61 73 20 77 65 20 63 61 6e 20 66 72 6f 6d 20 74 as we can from t
6690: 68 65 20 67 69 76 65 6e 20 64 61 74 61 62 61 73 he given databas
66a0: 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e e.** connection.
66b0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
66c0: 64 62 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 db_release_memor
66d0: 79 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a y(sqlite3 *db){.
66e0: 20 20 69 6e 74 20 69 3b 0a 0a 23 69 66 64 65 66 int i;..#ifdef
66f0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
6700: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
6710: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
6720: 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 ckOk(db) ) retur
6730: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
6740: 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 BKPT;.#endif. s
6750: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
6760: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
6770: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
6780: 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 erAll(db);. for
6790: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b (i=0; i<db->nDb;
67a0: 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 i++){. Btree
67b0: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b *pBt = db->aDb[
67c0: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 i].pBt;. if(
67d0: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 50 61 67 pBt ){. Pag
67e0: 65 72 20 2a 70 50 61 67 65 72 20 3d 20 73 71 6c er *pPager = sql
67f0: 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
6800: 42 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 Bt);. sqlit
6810: 65 33 50 61 67 65 72 53 68 72 69 6e 6b 28 70 50 e3PagerShrink(pP
6820: 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d ager);. }. }
6830: 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
6840: 65 61 76 65 41 6c 6c 28 64 62 29 3b 0a 20 20 73 eaveAll(db);. s
6850: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
6860: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
6870: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
6880: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 6c 75 73 K;.}../*.** Flus
6890: 68 20 61 6e 79 20 64 69 72 74 79 20 70 61 67 65 h any dirty page
68a0: 73 20 69 6e 20 74 68 65 20 70 61 67 65 72 2d 63 s in the pager-c
68b0: 61 63 68 65 20 66 6f 72 20 61 6e 79 20 61 74 74 ache for any att
68c0: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 0a 2a ached database.*
68d0: 2a 20 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e * to disk..*/.in
68e0: 74 20 73 71 6c 69 74 65 33 5f 64 62 5f 63 61 63 t sqlite3_db_cac
68f0: 68 65 66 6c 75 73 68 28 73 71 6c 69 74 65 33 20 heflush(sqlite3
6900: 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 *db){. int i;.
6910: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
6920: 5f 4f 4b 3b 0a 20 20 69 6e 74 20 62 53 65 65 6e _OK;. int bSeen
6930: 42 75 73 79 20 3d 20 30 3b 0a 0a 23 69 66 64 65 Busy = 0;..#ifde
6940: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
6950: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
6960: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
6970: 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 eckOk(db) ) retu
6980: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
6990: 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 _BKPT;.#endif.
69a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
69b0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
69c0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
69d0: 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f terAll(db);. fo
69e0: 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 r(i=0; rc==SQLIT
69f0: 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 E_OK && i<db->nD
6a00: 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 72 b; i++){. Btr
6a10: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 ee *pBt = db->aD
6a20: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 b[i].pBt;. if
6a30: 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 ( pBt && sqlite3
6a40: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 BtreeIsInTrans(p
6a50: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 50 61 67 Bt) ){. Pag
6a60: 65 72 20 2a 70 50 61 67 65 72 20 3d 20 73 71 6c er *pPager = sql
6a70: 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
6a80: 42 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 Bt);. rc =
6a90: 73 71 6c 69 74 65 33 50 61 67 65 72 46 6c 75 73 sqlite3PagerFlus
6aa0: 68 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 h(pPager);.
6ab0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
6ac0: 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 BUSY ){.
6ad0: 62 53 65 65 6e 42 75 73 79 20 3d 20 31 3b 0a 20 bSeenBusy = 1;.
6ae0: 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
6af0: 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 TE_OK;. }.
6b00: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 }. }. sqlit
6b10: 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 e3BtreeLeaveAll(
6b20: 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d db);. sqlite3_m
6b30: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
6b40: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
6b50: 28 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ((rc==SQLITE_OK
6b60: 26 26 20 62 53 65 65 6e 42 75 73 79 29 20 3f 20 && bSeenBusy) ?
6b70: 53 51 4c 49 54 45 5f 42 55 53 59 20 3a 20 72 63 SQLITE_BUSY : rc
6b80: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 );.}../*.** Conf
6b90: 69 67 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e iguration settin
6ba0: 67 73 20 66 6f 72 20 61 6e 20 69 6e 64 69 76 69 gs for an indivi
6bb0: 64 75 61 6c 20 64 61 74 61 62 61 73 65 20 63 6f dual database co
6bc0: 6e 6e 65 63 74 69 6f 6e 0a 2a 2f 0a 69 6e 74 20 nnection.*/.int
6bd0: 73 71 6c 69 74 65 33 5f 64 62 5f 63 6f 6e 66 69 sqlite3_db_confi
6be0: 67 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 g(sqlite3 *db, i
6bf0: 6e 74 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 nt op, ...){. v
6c00: 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 69 6e 74 a_list ap;. int
6c10: 20 72 63 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 rc;. va_start(
6c20: 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 ap, op);. switc
6c30: 68 28 20 6f 70 20 29 7b 0a 20 20 20 20 63 61 73 h( op ){. cas
6c40: 65 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 e SQLITE_DBCONFI
6c50: 47 5f 4d 41 49 4e 44 42 4e 41 4d 45 3a 20 7b 0a G_MAINDBNAME: {.
6c60: 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 30 5d db->aDb[0]
6c70: 2e 7a 44 62 53 4e 61 6d 65 20 3d 20 76 61 5f 61 .zDbSName = va_a
6c80: 72 67 28 61 70 2c 63 68 61 72 2a 29 3b 0a 20 20 rg(ap,char*);.
6c90: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
6ca0: 4f 4b 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b OK;. break;
6cb0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
6cc0: 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f SQLITE_DBCONFIG_
6cd0: 4c 4f 4f 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 LOOKASIDE: {.
6ce0: 20 20 20 76 6f 69 64 20 2a 70 42 75 66 20 3d 20 void *pBuf =
6cf0: 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a va_arg(ap, void*
6d00: 29 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 32 36 38 ); /* IMP: R-268
6d10: 33 35 2d 31 30 39 36 34 20 2a 2f 0a 20 20 20 20 35-10964 */.
6d20: 20 20 69 6e 74 20 73 7a 20 3d 20 76 61 5f 61 72 int sz = va_ar
6d30: 67 28 61 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 g(ap, int);
6d40: 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 37 38 37 /* IMP: R-4787
6d50: 31 2d 32 35 39 39 34 20 2a 2f 0a 20 20 20 20 20 1-25994 */.
6d60: 20 69 6e 74 20 63 6e 74 20 3d 20 76 61 5f 61 72 int cnt = va_ar
6d70: 67 28 61 70 2c 20 69 6e 74 29 3b 20 20 20 20 20 g(ap, int);
6d80: 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 34 34 36 30 /* IMP: R-04460
6d90: 2d 35 33 33 38 36 20 2a 2f 0a 20 20 20 20 20 20 -53386 */.
6da0: 72 63 20 3d 20 73 65 74 75 70 4c 6f 6f 6b 61 73 rc = setupLookas
6db0: 69 64 65 28 64 62 2c 20 70 42 75 66 2c 20 73 7a ide(db, pBuf, sz
6dc0: 2c 20 63 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , cnt);. br
6dd0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 eak;. }. d
6de0: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 efault: {.
6df0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 74 72 static const str
6e00: 75 63 74 20 7b 0a 20 20 20 20 20 20 20 20 69 6e uct {. in
6e10: 74 20 6f 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 t op; /* Th
6e20: 65 20 6f 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 e opcode */.
6e30: 20 20 20 20 75 33 32 20 6d 61 73 6b 3b 20 20 20 u32 mask;
6e40: 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 74 68 65 20 /* Mask of the
6e50: 62 69 74 20 69 6e 20 73 71 6c 69 74 65 33 2e 66 bit in sqlite3.f
6e60: 6c 61 67 73 20 74 6f 20 73 65 74 2f 63 6c 65 61 lags to set/clea
6e70: 72 20 2a 2f 0a 20 20 20 20 20 20 7d 20 61 46 6c r */. } aFl
6e80: 61 67 4f 70 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 agOp[] = {.
6e90: 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f { SQLITE_DBCO
6ea0: 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 46 4b 45 59 NFIG_ENABLE_FKEY
6eb0: 2c 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 , SQLI
6ec0: 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 20 TE_ForeignKeys
6ed0: 20 20 7d 2c 0a 20 20 20 20 20 20 20 20 7b 20 53 },. { S
6ee0: 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 45 QLITE_DBCONFIG_E
6ef0: 4e 41 42 4c 45 5f 54 52 49 47 47 45 52 2c 20 20 NABLE_TRIGGER,
6f00: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 45 6e 61 SQLITE_Ena
6f10: 62 6c 65 54 72 69 67 67 65 72 20 20 7d 2c 0a 20 bleTrigger },.
6f20: 20 20 20 20 20 20 20 7b 20 53 51 4c 49 54 45 5f { SQLITE_
6f30: 44 42 43 4f 4e 46 49 47 5f 45 4e 41 42 4c 45 5f DBCONFIG_ENABLE_
6f40: 46 54 53 33 5f 54 4f 4b 45 4e 49 5a 45 52 2c 20 FTS3_TOKENIZER,
6f50: 53 51 4c 49 54 45 5f 46 74 73 33 54 6f 6b 65 6e SQLITE_Fts3Token
6f60: 69 7a 65 72 20 20 7d 2c 0a 20 20 20 20 20 20 20 izer },.
6f70: 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 { SQLITE_DBCONF
6f80: 49 47 5f 45 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 IG_ENABLE_LOAD_E
6f90: 58 54 45 4e 53 49 4f 4e 2c 20 53 51 4c 49 54 45 XTENSION, SQLITE
6fa0: 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 20 20 _LoadExtension
6fb0: 7d 2c 0a 20 20 20 20 20 20 20 20 7b 20 53 51 4c },. { SQL
6fc0: 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4e 4f 5f ITE_DBCONFIG_NO_
6fd0: 43 4b 50 54 5f 4f 4e 5f 43 4c 4f 53 45 2c 20 20 CKPT_ON_CLOSE,
6fe0: 20 20 20 20 53 51 4c 49 54 45 5f 4e 6f 43 6b 70 SQLITE_NoCkp
6ff0: 74 4f 6e 43 6c 6f 73 65 20 20 7d 2c 0a 20 20 20 tOnClose },.
7000: 20 20 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 { SQLITE_DB
7010: 43 4f 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 51 50 CONFIG_ENABLE_QP
7020: 53 47 2c 20 20 20 20 20 20 20 20 20 20 20 53 51 SG, SQ
7030: 4c 49 54 45 5f 45 6e 61 62 6c 65 51 50 53 47 20 LITE_EnableQPSG
7040: 20 20 20 20 7d 2c 0a 20 20 20 20 20 20 7d 3b 0a },. };.
7050: 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 unsigned i
7060: 6e 74 20 69 3b 0a 20 20 20 20 20 20 72 63 20 3d nt i;. rc =
7070: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 20 2f SQLITE_ERROR; /
7080: 2a 20 49 4d 50 3a 20 52 2d 34 32 37 39 30 2d 32 * IMP: R-42790-2
7090: 33 33 37 32 20 2a 2f 0a 20 20 20 20 20 20 66 6f 3372 */. fo
70a0: 72 28 69 3d 30 3b 20 69 3c 41 72 72 61 79 53 69 r(i=0; i<ArraySi
70b0: 7a 65 28 61 46 6c 61 67 4f 70 29 3b 20 69 2b 2b ze(aFlagOp); i++
70c0: 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 61 ){. if( a
70d0: 46 6c 61 67 4f 70 5b 69 5d 2e 6f 70 3d 3d 6f 70 FlagOp[i].op==op
70e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e ){. in
70f0: 74 20 6f 6e 6f 66 66 20 3d 20 76 61 5f 61 72 67 t onoff = va_arg
7100: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
7110: 20 20 20 20 20 69 6e 74 20 2a 70 52 65 73 20 3d int *pRes =
7120: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 2a va_arg(ap, int*
7130: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 );. int
7140: 20 6f 6c 64 46 6c 61 67 73 20 3d 20 64 62 2d 3e oldFlags = db->
7150: 66 6c 61 67 73 3b 0a 20 20 20 20 20 20 20 20 20 flags;.
7160: 20 69 66 28 20 6f 6e 6f 66 66 3e 30 20 29 7b 0a if( onoff>0 ){.
7170: 20 20 20 20 20 20 20 20 20 20 20 20 64 62 2d 3e db->
7180: 66 6c 61 67 73 20 7c 3d 20 61 46 6c 61 67 4f 70 flags |= aFlagOp
7190: 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 20 20 20 20 20 [i].mask;.
71a0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 6e }else if( on
71b0: 6f 66 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 off==0 ){.
71c0: 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 db->flags
71d0: 26 3d 20 7e 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d &= ~aFlagOp[i].m
71e0: 61 73 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d ask;. }
71f0: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6f . if( o
7200: 6c 64 46 6c 61 67 73 21 3d 64 62 2d 3e 66 6c 61 ldFlags!=db->fla
7210: 67 73 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 gs ){.
7220: 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 sqlite3ExpireP
7230: 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 reparedStatement
7240: 73 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 20 s(db);.
7250: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 }. if(
7260: 20 70 52 65 73 20 29 7b 0a 20 20 20 20 20 20 20 pRes ){.
7270: 20 20 20 20 20 2a 70 52 65 73 20 3d 20 28 64 62 *pRes = (db
7280: 2d 3e 66 6c 61 67 73 20 26 20 61 46 6c 61 67 4f ->flags & aFlagO
7290: 70 5b 69 5d 2e 6d 61 73 6b 29 21 3d 30 3b 0a 20 p[i].mask)!=0;.
72a0: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
72b0: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
72c0: 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 62 _OK;. b
72d0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a reak;. }.
72e0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 }. br
72f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 eak;. }. }.
7300: 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 20 72 va_end(ap);. r
7310: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
7320: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 .** Return true
7330: 69 66 20 74 68 65 20 62 75 66 66 65 72 20 7a 5b if the buffer z[
7340: 30 2e 2e 6e 2d 31 5d 20 63 6f 6e 74 61 69 6e 73 0..n-1] contains
7350: 20 61 6c 6c 20 73 70 61 63 65 73 2e 0a 2a 2f 0a all spaces..*/.
7360: 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 53 70 static int allSp
7370: 61 63 65 73 28 63 6f 6e 73 74 20 63 68 61 72 20 aces(const char
7380: 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 77 68 *z, int n){. wh
7390: 69 6c 65 28 20 6e 3e 30 20 26 26 20 7a 5b 6e 2d ile( n>0 && z[n-
73a0: 31 5d 3d 3d 27 20 27 20 29 7b 20 6e 2d 2d 3b 20 1]==' ' ){ n--;
73b0: 7d 0a 20 20 72 65 74 75 72 6e 20 6e 3d 3d 30 3b }. return n==0;
73c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 .}../*.** This i
73d0: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f s the default co
73e0: 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 69 6f 6e llating function
73f0: 20 6e 61 6d 65 64 20 22 42 49 4e 41 52 59 22 20 named "BINARY"
7400: 77 68 69 63 68 20 69 73 20 61 6c 77 61 79 73 0a which is always.
7410: 2a 2a 20 61 76 61 69 6c 61 62 6c 65 2e 0a 2a 2a ** available..**
7420: 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 64 46 6c .** If the padFl
7430: 61 67 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e ag argument is n
7440: 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 73 70 61 ot NULL then spa
7450: 63 65 20 70 61 64 64 69 6e 67 20 61 74 20 74 68 ce padding at th
7460: 65 20 65 6e 64 0a 2a 2a 20 6f 66 20 73 74 72 69 e end.** of stri
7470: 6e 67 73 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 ngs is ignored.
7480: 20 54 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74 73 This implements
7490: 20 74 68 65 20 52 54 52 49 4d 20 63 6f 6c 6c 61 the RTRIM colla
74a0: 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
74b0: 69 6e 74 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 28 int binCollFunc(
74c0: 0a 20 20 76 6f 69 64 20 2a 70 61 64 46 6c 61 67 . void *padFlag
74d0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 ,. int nKey1, c
74e0: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 onst void *pKey1
74f0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 ,. int nKey2, c
7500: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 onst void *pKey2
7510: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 2c 20 6e 3b .){. int rc, n;
7520: 0a 20 20 6e 20 3d 20 6e 4b 65 79 31 3c 6e 4b 65 . n = nKey1<nKe
7530: 79 32 20 3f 20 6e 4b 65 79 31 20 3a 20 6e 4b 65 y2 ? nKey1 : nKe
7540: 79 32 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 y2;. /* EVIDENC
7550: 45 2d 4f 46 3a 20 52 2d 36 35 30 33 33 2d 32 38 E-OF: R-65033-28
7560: 34 34 39 20 54 68 65 20 62 75 69 6c 74 2d 69 6e 449 The built-in
7570: 20 42 49 4e 41 52 59 20 63 6f 6c 6c 61 74 69 6f BINARY collatio
7580: 6e 20 63 6f 6d 70 61 72 65 73 0a 20 20 2a 2a 20 n compares. **
7590: 73 74 72 69 6e 67 73 20 62 79 74 65 20 62 79 20 strings byte by
75a0: 62 79 74 65 20 75 73 69 6e 67 20 74 68 65 20 6d byte using the m
75b0: 65 6d 63 6d 70 28 29 20 66 75 6e 63 74 69 6f 6e emcmp() function
75c0: 20 66 72 6f 6d 20 74 68 65 20 73 74 61 6e 64 61 from the standa
75d0: 72 64 20 43 0a 20 20 2a 2a 20 6c 69 62 72 61 72 rd C. ** librar
75e0: 79 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 y. */. assert(
75f0: 70 4b 65 79 31 20 26 26 20 70 4b 65 79 32 20 29 pKey1 && pKey2 )
7600: 3b 0a 20 20 72 63 20 3d 20 6d 65 6d 63 6d 70 28 ;. rc = memcmp(
7610: 70 4b 65 79 31 2c 20 70 4b 65 79 32 2c 20 6e 29 pKey1, pKey2, n)
7620: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b ;. if( rc==0 ){
7630: 0a 20 20 20 20 69 66 28 20 70 61 64 46 6c 61 67 . if( padFlag
7640: 0a 20 20 20 20 20 26 26 20 61 6c 6c 53 70 61 63 . && allSpac
7650: 65 73 28 28 28 63 68 61 72 2a 29 70 4b 65 79 31 es(((char*)pKey1
7660: 29 2b 6e 2c 20 6e 4b 65 79 31 2d 6e 29 0a 20 20 )+n, nKey1-n).
7670: 20 20 20 26 26 20 61 6c 6c 53 70 61 63 65 73 28 && allSpaces(
7680: 28 28 63 68 61 72 2a 29 70 4b 65 79 32 29 2b 6e ((char*)pKey2)+n
7690: 2c 20 6e 4b 65 79 32 2d 6e 29 0a 20 20 20 20 29 , nKey2-n). )
76a0: 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 {. /* EVIDE
76b0: 4e 43 45 2d 4f 46 3a 20 52 2d 33 31 36 32 34 2d NCE-OF: R-31624-
76c0: 32 34 37 33 37 20 52 54 52 49 4d 20 69 73 20 6c 24737 RTRIM is l
76d0: 69 6b 65 20 42 49 4e 41 52 59 20 65 78 63 65 70 ike BINARY excep
76e0: 74 20 74 68 61 74 20 65 78 74 72 61 0a 20 20 20 t that extra.
76f0: 20 20 20 2a 2a 20 73 70 61 63 65 73 20 61 74 20 ** spaces at
7700: 74 68 65 20 65 6e 64 20 6f 66 20 65 69 74 68 65 the end of eithe
7710: 72 20 73 74 72 69 6e 67 20 64 6f 20 6e 6f 74 20 r string do not
7720: 63 68 61 6e 67 65 20 74 68 65 20 72 65 73 75 6c change the resul
7730: 74 2e 20 49 6e 20 6f 74 68 65 72 0a 20 20 20 20 t. In other.
7740: 20 20 2a 2a 20 77 6f 72 64 73 2c 20 73 74 72 69 ** words, stri
7750: 6e 67 73 20 77 69 6c 6c 20 63 6f 6d 70 61 72 65 ngs will compare
7760: 20 65 71 75 61 6c 20 74 6f 20 6f 6e 65 20 61 6e equal to one an
7770: 6f 74 68 65 72 20 61 73 20 6c 6f 6e 67 20 61 73 other as long as
7780: 20 74 68 65 79 0a 20 20 20 20 20 20 2a 2a 20 64 they. ** d
7790: 69 66 66 65 72 20 6f 6e 6c 79 20 69 6e 20 74 68 iffer only in th
77a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 70 61 63 e number of spac
77b0: 65 73 20 61 74 20 74 68 65 20 65 6e 64 2e 0a 20 es at the end..
77c0: 20 20 20 20 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 */. }els
77d0: 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 6e 4b e{. rc = nK
77e0: 65 79 31 20 2d 20 6e 4b 65 79 32 3b 0a 20 20 20 ey1 - nKey2;.
77f0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
7800: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6e 6f rc;.}../*.** Ano
7810: 74 68 65 72 20 62 75 69 6c 74 2d 69 6e 20 63 6f ther built-in co
7820: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
7830: 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a 2a 0a 2a 2a : NOCASE. .**.**
7840: 20 54 68 69 73 20 63 6f 6c 6c 61 74 69 6e 67 20 This collating
7850: 73 65 71 75 65 6e 63 65 20 69 73 20 69 6e 74 65 sequence is inte
7860: 6e 64 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 nded to be used
7870: 66 6f 72 20 22 63 61 73 65 20 69 6e 64 65 70 65 for "case indepe
7880: 6e 64 65 6e 74 0a 2a 2a 20 63 6f 6d 70 61 72 69 ndent.** compari
7890: 73 6f 6e 22 2e 20 53 51 4c 69 74 65 27 73 20 6b son". SQLite's k
78a0: 6e 6f 77 6c 65 64 67 65 20 6f 66 20 75 70 70 65 nowledge of uppe
78b0: 72 20 61 6e 64 20 6c 6f 77 65 72 20 63 61 73 65 r and lower case
78c0: 20 65 71 75 69 76 61 6c 65 6e 74 73 0a 2a 2a 20 equivalents.**
78d0: 65 78 74 65 6e 64 73 20 6f 6e 6c 79 20 74 6f 20 extends only to
78e0: 74 68 65 20 32 36 20 63 68 61 72 61 63 74 65 72 the 26 character
78f0: 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 45 6e s used in the En
7900: 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 2e 0a glish language..
7910: 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 20 6d 6f 6d **.** At the mom
7920: 65 6e 74 20 74 68 65 72 65 20 69 73 20 6f 6e 6c ent there is onl
7930: 79 20 61 20 55 54 46 2d 38 20 69 6d 70 6c 65 6d y a UTF-8 implem
7940: 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 entation..*/.sta
7950: 74 69 63 20 69 6e 74 20 6e 6f 63 61 73 65 43 6f tic int nocaseCo
7960: 6c 6c 61 74 69 6e 67 46 75 6e 63 28 0a 20 20 76 llatingFunc(. v
7970: 6f 69 64 20 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 oid *NotUsed,.
7980: 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 int nKey1, const
7990: 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 void *pKey1,.
79a0: 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 int nKey2, const
79b0: 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a void *pKey2.){.
79c0: 20 20 69 6e 74 20 72 20 3d 20 73 71 6c 69 74 65 int r = sqlite
79d0: 33 53 74 72 4e 49 43 6d 70 28 0a 20 20 20 20 20 3StrNICmp(.
79e0: 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 (const char *)p
79f0: 4b 65 79 31 2c 20 28 63 6f 6e 73 74 20 63 68 61 Key1, (const cha
7a00: 72 20 2a 29 70 4b 65 79 32 2c 20 28 6e 4b 65 79 r *)pKey2, (nKey
7a10: 31 3c 6e 4b 65 79 32 29 3f 6e 4b 65 79 31 3a 6e 1<nKey2)?nKey1:n
7a20: 4b 65 79 32 29 3b 0a 20 20 55 4e 55 53 45 44 5f Key2);. UNUSED_
7a30: 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 PARAMETER(NotUse
7a40: 64 29 3b 0a 20 20 69 66 28 20 30 3d 3d 72 20 29 d);. if( 0==r )
7a50: 7b 0a 20 20 20 20 72 20 3d 20 6e 4b 65 79 31 2d {. r = nKey1-
7a60: 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 20 72 65 74 nKey2;. }. ret
7a70: 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn r;.}../*.**
7a80: 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49 44 Return the ROWID
7a90: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 of the most rec
7aa0: 65 6e 74 20 69 6e 73 65 72 74 0a 2a 2f 0a 73 71 ent insert.*/.sq
7ab0: 6c 69 74 65 5f 69 6e 74 36 34 20 73 71 6c 69 74 lite_int64 sqlit
7ac0: 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 e3_last_insert_r
7ad0: 6f 77 69 64 28 73 71 6c 69 74 65 33 20 2a 64 62 owid(sqlite3 *db
7ae0: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
7af0: 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
7b00: 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
7b10: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
7b20: 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 ) ){. (void)S
7b30: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
7b40: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b T;. return 0;
7b50: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 . }.#endif. re
7b60: 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 turn db->lastRow
7b70: 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 id;.}../*.** Set
7b80: 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 the value retur
7b90: 6e 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 ned by the sqlit
7ba0: 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 e3_last_insert_r
7bb0: 6f 77 69 64 28 29 20 41 50 49 20 66 75 6e 63 74 owid() API funct
7bc0: 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c ion..*/.void sql
7bd0: 69 74 65 33 5f 73 65 74 5f 6c 61 73 74 5f 69 6e ite3_set_last_in
7be0: 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 sert_rowid(sqlit
7bf0: 65 33 20 2a 64 62 2c 20 73 71 6c 69 74 65 33 5f e3 *db, sqlite3_
7c00: 69 6e 74 36 34 20 69 52 6f 77 69 64 29 7b 0a 23 int64 iRowid){.#
7c10: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
7c20: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
7c30: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
7c40: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
7c50: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 . (void)SQLIT
7c60: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
7c70: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 23 return;. }.#
7c80: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
7c90: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
7ca0: 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 6c 61 mutex);. db->la
7cb0: 73 74 52 6f 77 69 64 20 3d 20 69 52 6f 77 69 64 stRowid = iRowid
7cc0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
7cd0: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
7ce0: 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 x);.}../*.** Ret
7cf0: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f urn the number o
7d00: 66 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 f changes in the
7d10: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c most recent cal
7d20: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 l to sqlite3_exe
7d30: 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 c()..*/.int sqli
7d40: 74 65 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 te3_changes(sqli
7d50: 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 te3 *db){.#ifdef
7d60: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
7d70: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
7d80: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
7d90: 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
7da0: 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 (void)SQLITE_MIS
7db0: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 USE_BKPT;. re
7dc0: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 turn 0;. }.#end
7dd0: 69 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e if. return db->
7de0: 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a nChange;.}../*.*
7df0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
7e00: 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20 73 ber of changes s
7e10: 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 61 73 ince the databas
7e20: 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f 70 65 e handle was ope
7e30: 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ned..*/.int sqli
7e40: 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67 65 te3_total_change
7e50: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a s(sqlite3 *db){.
7e60: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
7e70: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
7e80: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
7e90: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
7ea0: 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
7eb0: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
7ec0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
7ed0: 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 }.#endif. retur
7ee0: 6e 20 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e n db->nTotalChan
7ef0: 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f ge;.}../*.** Clo
7f00: 73 65 20 61 6c 6c 20 6f 70 65 6e 20 73 61 76 65 se all open save
7f10: 70 6f 69 6e 74 73 2e 20 54 68 69 73 20 66 75 6e points. This fun
7f20: 63 74 69 6f 6e 20 6f 6e 6c 79 20 6d 61 6e 69 70 ction only manip
7f30: 75 6c 61 74 65 73 20 66 69 65 6c 64 73 20 6f 66 ulates fields of
7f40: 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 the.** database
7f50: 20 68 61 6e 64 6c 65 20 6f 62 6a 65 63 74 2c 20 handle object,
7f60: 69 74 20 64 6f 65 73 20 6e 6f 74 20 63 6c 6f 73 it does not clos
7f70: 65 20 61 6e 79 20 73 61 76 65 70 6f 69 6e 74 73 e any savepoints
7f80: 20 74 68 61 74 20 6d 61 79 20 62 65 20 6f 70 65 that may be ope
7f90: 6e 0a 2a 2a 20 61 74 20 74 68 65 20 62 2d 74 72 n.** at the b-tr
7fa0: 65 65 2f 70 61 67 65 72 20 6c 65 76 65 6c 2e 0a ee/pager level..
7fb0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 */.void sqlite3C
7fc0: 6c 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 loseSavepoints(s
7fd0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 77 qlite3 *db){. w
7fe0: 68 69 6c 65 28 20 64 62 2d 3e 70 53 61 76 65 70 hile( db->pSavep
7ff0: 6f 69 6e 74 20 29 7b 0a 20 20 20 20 53 61 76 65 oint ){. Save
8000: 70 6f 69 6e 74 20 2a 70 54 6d 70 20 3d 20 64 62 point *pTmp = db
8010: 2d 3e 70 53 61 76 65 70 6f 69 6e 74 3b 0a 20 20 ->pSavepoint;.
8020: 20 20 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 db->pSavepoint
8030: 20 3d 20 70 54 6d 70 2d 3e 70 4e 65 78 74 3b 0a = pTmp->pNext;.
8040: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
8050: 65 28 64 62 2c 20 70 54 6d 70 29 3b 0a 20 20 7d e(db, pTmp);. }
8060: 0a 20 20 64 62 2d 3e 6e 53 61 76 65 70 6f 69 6e . db->nSavepoin
8070: 74 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e 53 74 t = 0;. db->nSt
8080: 61 74 65 6d 65 6e 74 20 3d 20 30 3b 0a 20 20 64 atement = 0;. d
8090: 62 2d 3e 69 73 54 72 61 6e 73 61 63 74 69 6f 6e b->isTransaction
80a0: 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a 7d Savepoint = 0;.}
80b0: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 ../*.** Invoke t
80c0: 68 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 he destructor fu
80d0: 6e 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 nction associate
80e0: 64 20 77 69 74 68 20 46 75 6e 63 44 65 66 20 70 d with FuncDef p
80f0: 2c 20 69 66 20 61 6e 79 2e 20 45 78 63 65 70 74 , if any. Except
8100: 2c 0a 2a 2a 20 69 66 20 74 68 69 73 20 69 73 20 ,.** if this is
8110: 6e 6f 74 20 74 68 65 20 6c 61 73 74 20 63 6f 70 not the last cop
8120: 79 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f y of the functio
8130: 6e 2c 20 64 6f 20 6e 6f 74 20 69 6e 76 6f 6b 65 n, do not invoke
8140: 20 69 74 2e 20 4d 75 6c 74 69 70 6c 65 0a 2a 2a it. Multiple.**
8150: 20 63 6f 70 69 65 73 20 6f 66 20 61 20 73 69 6e copies of a sin
8160: 67 6c 65 20 66 75 6e 63 74 69 6f 6e 20 61 72 65 gle function are
8170: 20 63 72 65 61 74 65 64 20 77 68 65 6e 20 63 72 created when cr
8180: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 20 eate_function()
8190: 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 77 69 74 is called.** wit
81a0: 68 20 53 51 4c 49 54 45 5f 41 4e 59 20 61 73 20 h SQLITE_ANY as
81b0: 74 68 65 20 65 6e 63 6f 64 69 6e 67 2e 0a 2a 2f the encoding..*/
81c0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 75 6e .static void fun
81d0: 63 74 69 6f 6e 44 65 73 74 72 6f 79 28 73 71 6c ctionDestroy(sql
81e0: 69 74 65 33 20 2a 64 62 2c 20 46 75 6e 63 44 65 ite3 *db, FuncDe
81f0: 66 20 2a 70 29 7b 0a 20 20 46 75 6e 63 44 65 73 f *p){. FuncDes
8200: 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 72 75 tructor *pDestru
8210: 63 74 6f 72 20 3d 20 70 2d 3e 75 2e 70 44 65 73 ctor = p->u.pDes
8220: 74 72 75 63 74 6f 72 3b 0a 20 20 69 66 28 20 70 tructor;. if( p
8230: 44 65 73 74 72 75 63 74 6f 72 20 29 7b 0a 20 20 Destructor ){.
8240: 20 20 70 44 65 73 74 72 75 63 74 6f 72 2d 3e 6e pDestructor->n
8250: 52 65 66 2d 2d 3b 0a 20 20 20 20 69 66 28 20 70 Ref--;. if( p
8260: 44 65 73 74 72 75 63 74 6f 72 2d 3e 6e 52 65 66 Destructor->nRef
8270: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 44 65 ==0 ){. pDe
8280: 73 74 72 75 63 74 6f 72 2d 3e 78 44 65 73 74 72 structor->xDestr
8290: 6f 79 28 70 44 65 73 74 72 75 63 74 6f 72 2d 3e oy(pDestructor->
82a0: 70 55 73 65 72 44 61 74 61 29 3b 0a 20 20 20 20 pUserData);.
82b0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
82c0: 64 62 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 db, pDestructor)
82d0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
82e0: 2a 0a 2a 2a 20 44 69 73 63 6f 6e 6e 65 63 74 20 *.** Disconnect
82f0: 61 6c 6c 20 73 71 6c 69 74 65 33 5f 76 74 61 62 all sqlite3_vtab
8300: 20 6f 62 6a 65 63 74 73 20 74 68 61 74 20 62 65 objects that be
8310: 6c 6f 6e 67 20 74 6f 20 64 61 74 61 62 61 73 65 long to database
8320: 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 64 connection.** d
8330: 62 2e 20 54 68 69 73 20 69 73 20 63 61 6c 6c 65 b. This is calle
8340: 64 20 77 68 65 6e 20 64 62 20 69 73 20 62 65 69 d when db is bei
8350: 6e 67 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 73 74 ng closed..*/.st
8360: 61 74 69 63 20 76 6f 69 64 20 64 69 73 63 6f 6e atic void discon
8370: 6e 65 63 74 41 6c 6c 56 74 61 62 28 73 71 6c 69 nectAllVtab(sqli
8380: 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 6e 64 65 te3 *db){.#ifnde
8390: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
83a0: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69 6e 74 RTUALTABLE. int
83b0: 20 69 3b 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a i;. HashElem *
83c0: 70 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 p;. sqlite3Btre
83d0: 65 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 eEnterAll(db);.
83e0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e for(i=0; i<db->
83f0: 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 53 nDb; i++){. S
8400: 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 20 3d chema *pSchema =
8410: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63 68 db->aDb[i].pSch
8420: 65 6d 61 3b 0a 20 20 20 20 69 66 28 20 64 62 2d ema;. if( db-
8430: 3e 61 44 62 5b 69 5d 2e 70 53 63 68 65 6d 61 20 >aDb[i].pSchema
8440: 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 70 3d 73 ){. for(p=s
8450: 71 6c 69 74 65 48 61 73 68 46 69 72 73 74 28 26 qliteHashFirst(&
8460: 70 53 63 68 65 6d 61 2d 3e 74 62 6c 48 61 73 68 pSchema->tblHash
8470: 29 3b 20 70 3b 20 70 3d 73 71 6c 69 74 65 48 61 ); p; p=sqliteHa
8480: 73 68 4e 65 78 74 28 70 29 29 7b 0a 20 20 20 20 shNext(p)){.
8490: 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 20 Table *pTab
84a0: 3d 20 28 54 61 62 6c 65 20 2a 29 73 71 6c 69 74 = (Table *)sqlit
84b0: 65 48 61 73 68 44 61 74 61 28 70 29 3b 0a 20 20 eHashData(p);.
84c0: 20 20 20 20 20 20 69 66 28 20 49 73 56 69 72 74 if( IsVirt
84d0: 75 61 6c 28 70 54 61 62 29 20 29 20 73 71 6c 69 ual(pTab) ) sqli
84e0: 74 65 33 56 74 61 62 44 69 73 63 6f 6e 6e 65 63 te3VtabDisconnec
84f0: 74 28 64 62 2c 20 70 54 61 62 29 3b 0a 20 20 20 t(db, pTab);.
8500: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 }. }. }.
8510: 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 48 61 73 for(p=sqliteHas
8520: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 4d 6f 64 hFirst(&db->aMod
8530: 75 6c 65 29 3b 20 70 3b 20 70 3d 73 71 6c 69 74 ule); p; p=sqlit
8540: 65 48 61 73 68 4e 65 78 74 28 70 29 29 7b 0a 20 eHashNext(p)){.
8550: 20 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 20 Module *pMod
8560: 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 = (Module *)sqli
8570: 74 65 48 61 73 68 44 61 74 61 28 70 29 3b 0a 20 teHashData(p);.
8580: 20 20 20 69 66 28 20 70 4d 6f 64 2d 3e 70 45 70 if( pMod->pEp
8590: 6f 54 61 62 20 29 7b 0a 20 20 20 20 20 20 73 71 oTab ){. sq
85a0: 6c 69 74 65 33 56 74 61 62 44 69 73 63 6f 6e 6e lite3VtabDisconn
85b0: 65 63 74 28 64 62 2c 20 70 4d 6f 64 2d 3e 70 45 ect(db, pMod->pE
85c0: 70 6f 54 61 62 29 3b 0a 20 20 20 20 7d 0a 20 20 poTab);. }.
85d0: 7d 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 55 }. sqlite3VtabU
85e0: 6e 6c 6f 63 6b 4c 69 73 74 28 64 62 29 3b 0a 20 nlockList(db);.
85f0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
8600: 76 65 41 6c 6c 28 64 62 29 3b 0a 23 65 6c 73 65 veAll(db);.#else
8610: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
8620: 54 45 52 28 64 62 29 3b 0a 23 65 6e 64 69 66 0a TER(db);.#endif.
8630: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
8640: 54 52 55 45 20 69 66 20 64 61 74 61 62 61 73 65 TRUE if database
8650: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64 62 20 68 connection db h
8660: 61 73 20 75 6e 66 69 6e 61 6c 69 7a 65 64 20 70 as unfinalized p
8670: 72 65 70 61 72 65 64 0a 2a 2a 20 73 74 61 74 65 repared.** state
8680: 6d 65 6e 74 73 20 6f 72 20 75 6e 66 69 6e 69 73 ments or unfinis
8690: 68 65 64 20 73 71 6c 69 74 65 33 5f 62 61 63 6b hed sqlite3_back
86a0: 75 70 20 6f 62 6a 65 63 74 73 2e 20 20 0a 2a 2f up objects. .*/
86b0: 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6f 6e 6e .static int conn
86c0: 65 63 74 69 6f 6e 49 73 42 75 73 79 28 73 71 6c ectionIsBusy(sql
86d0: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 ite3 *db){. int
86e0: 20 6a 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 j;. assert( sq
86f0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
8700: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 (db->mutex) );.
8710: 20 69 66 28 20 64 62 2d 3e 70 56 64 62 65 20 29 if( db->pVdbe )
8720: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 66 6f 72 return 1;. for
8730: 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b (j=0; j<db->nDb;
8740: 20 6a 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 j++){. Btree
8750: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b *pBt = db->aDb[
8760: 6a 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 j].pBt;. if(
8770: 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 pBt && sqlite3Bt
8780: 72 65 65 49 73 49 6e 42 61 63 6b 75 70 28 70 42 reeIsInBackup(pB
8790: 74 29 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 t) ) return 1;.
87a0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d }. return 0;.}
87b0: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e ../*.** Close an
87c0: 20 65 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 existing SQLite
87d0: 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a 73 74 61 database.*/.sta
87e0: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 43 tic int sqlite3C
87f0: 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a 64 62 lose(sqlite3 *db
8800: 2c 20 69 6e 74 20 66 6f 72 63 65 5a 6f 6d 62 69 , int forceZombi
8810: 65 29 7b 0a 20 20 69 66 28 20 21 64 62 20 29 7b e){. if( !db ){
8820: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
8830: 2d 4f 46 3a 20 52 2d 36 33 32 35 37 2d 31 31 37 -OF: R-63257-117
8840: 34 30 20 43 61 6c 6c 69 6e 67 20 73 71 6c 69 74 40 Calling sqlit
8850: 65 33 5f 63 6c 6f 73 65 28 29 20 6f 72 0a 20 20 e3_close() or.
8860: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6c 6f ** sqlite3_clo
8870: 73 65 5f 76 32 28 29 20 77 69 74 68 20 61 20 4e se_v2() with a N
8880: 55 4c 4c 20 70 6f 69 6e 74 65 72 20 61 72 67 75 ULL pointer argu
8890: 6d 65 6e 74 20 69 73 20 61 20 68 61 72 6d 6c 65 ment is a harmle
88a0: 73 73 20 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 20 ss no-op. */.
88b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
88c0: 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 K;. }. if( !sq
88d0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
88e0: 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a SickOrOk(db) ){.
88f0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
8900: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
8910: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
8920: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
8930: 65 78 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d ex);. if( db->m
8940: 54 72 61 63 65 20 26 20 53 51 4c 49 54 45 5f 54 Trace & SQLITE_T
8950: 52 41 43 45 5f 43 4c 4f 53 45 20 29 7b 0a 20 20 RACE_CLOSE ){.
8960: 20 20 64 62 2d 3e 78 54 72 61 63 65 28 53 51 4c db->xTrace(SQL
8970: 49 54 45 5f 54 52 41 43 45 5f 43 4c 4f 53 45 2c ITE_TRACE_CLOSE,
8980: 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 2c 20 db->pTraceArg,
8990: 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f db, 0);. }.. /
89a0: 2a 20 46 6f 72 63 65 20 78 44 69 73 63 6f 6e 6e * Force xDisconn
89b0: 65 63 74 20 63 61 6c 6c 73 20 6f 6e 20 61 6c 6c ect calls on all
89c0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
89d0: 2a 2f 0a 20 20 64 69 73 63 6f 6e 6e 65 63 74 41 */. disconnectA
89e0: 6c 6c 56 74 61 62 28 64 62 29 3b 0a 0a 20 20 2f llVtab(db);.. /
89f0: 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 * If a transacti
8a00: 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 74 68 65 20 on is open, the
8a10: 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 61 disconnectAllVta
8a20: 62 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 0a 20 b() call above.
8a30: 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 61 76 ** will not hav
8a40: 65 20 63 61 6c 6c 65 64 20 74 68 65 20 78 44 69 e called the xDi
8a50: 73 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f sconnect() metho
8a60: 64 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 61 6c d on any virtual
8a70: 0a 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 . ** tables in
8a80: 74 68 65 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b the db->aVTrans[
8a90: 5d 20 61 72 72 61 79 2e 20 54 68 65 20 66 6f 6c ] array. The fol
8aa0: 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 56 74 lowing sqlite3Vt
8ab0: 61 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 20 2a abRollback(). *
8ac0: 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 * call will do s
8ad0: 6f 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 64 6f o. We need to do
8ae0: 20 74 68 69 73 20 62 65 66 6f 72 65 20 74 68 65 this before the
8af0: 20 63 68 65 63 6b 20 66 6f 72 20 61 63 74 69 76 check for activ
8b00: 65 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 e. ** SQL state
8b10: 6d 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 73 20 ments below, as
8b20: 74 68 65 20 76 2d 74 61 62 6c 65 20 69 6d 70 6c the v-table impl
8b30: 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 20 62 ementation may b
8b40: 65 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 e storing. ** s
8b50: 6f 6d 65 20 70 72 65 70 61 72 65 64 20 73 74 61 ome prepared sta
8b60: 74 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e 61 6c tements internal
8b70: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 ly.. */. sqlit
8b80: 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 e3VtabRollback(d
8b90: 62 29 3b 0a 0a 20 20 2f 2a 20 4c 65 67 61 63 79 b);.. /* Legacy
8ba0: 20 62 65 68 61 76 69 6f 72 20 28 73 71 6c 69 74 behavior (sqlit
8bb0: 65 33 5f 63 6c 6f 73 65 28 29 20 62 65 68 61 76 e3_close() behav
8bc0: 69 6f 72 29 20 69 73 20 74 6f 20 72 65 74 75 72 ior) is to retur
8bd0: 6e 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 42 55 n. ** SQLITE_BU
8be0: 53 59 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 SY if the connec
8bf0: 74 69 6f 6e 20 63 61 6e 20 6e 6f 74 20 62 65 20 tion can not be
8c00: 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 74 65 closed immediate
8c10: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 ly.. */. if( !
8c20: 66 6f 72 63 65 5a 6f 6d 62 69 65 20 26 26 20 63 forceZombie && c
8c30: 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 79 28 onnectionIsBusy(
8c40: 64 62 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 db) ){. sqlit
8c50: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 e3ErrorWithMsg(d
8c60: 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 b, SQLITE_BUSY,
8c70: 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 65 "unable to close
8c80: 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c 69 due to unfinali
8c90: 7a 65 64 20 22 0a 20 20 20 20 20 20 20 22 73 74 zed ". "st
8ca0: 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e 66 69 atements or unfi
8cb0: 6e 69 73 68 65 64 20 62 61 63 6b 75 70 73 22 29 nished backups")
8cc0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 ;. sqlite3_mu
8cd0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
8ce0: 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e tex);. return
8cf0: 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 SQLITE_BUSY;.
8d00: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
8d10: 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 _ENABLE_SQLLOG.
8d20: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
8d30: 61 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 alConfig.xSqllog
8d40: 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6c 6f 73 69 ){. /* Closi
8d50: 6e 67 20 74 68 65 20 68 61 6e 64 6c 65 2e 20 46 ng the handle. F
8d60: 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 72 20 ourth parameter
8d70: 69 73 20 70 61 73 73 65 64 20 74 68 65 20 76 61 is passed the va
8d80: 6c 75 65 20 32 2e 20 2a 2f 0a 20 20 20 20 73 71 lue 2. */. sq
8d90: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
8da0: 67 2e 78 53 71 6c 6c 6f 67 28 73 71 6c 69 74 65 g.xSqllog(sqlite
8db0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 3GlobalConfig.pS
8dc0: 71 6c 6c 6f 67 41 72 67 2c 20 64 62 2c 20 30 2c qllogArg, db, 0,
8dd0: 20 32 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 2);. }.#endif.
8de0: 0a 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 74 68 . /* Convert th
8df0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 6e 74 e connection int
8e00: 6f 20 61 20 7a 6f 6d 62 69 65 20 61 6e 64 20 74 o a zombie and t
8e10: 68 65 6e 20 63 6c 6f 73 65 20 69 74 2e 0a 20 20 hen close it..
8e20: 2a 2f 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d */. db->magic =
8e30: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 5a 4f SQLITE_MAGIC_ZO
8e40: 4d 42 49 45 3b 0a 20 20 73 71 6c 69 74 65 33 4c MBIE;. sqlite3L
8e50: 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f 73 eaveMutexAndClos
8e60: 65 5a 6f 6d 62 69 65 28 64 62 29 3b 0a 20 20 72 eZombie(db);. r
8e70: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
8e80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 76 61 .}../*.** Two va
8e90: 72 69 61 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 riations on the
8ea0: 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 63 65 public interface
8eb0: 20 66 6f 72 20 63 6c 6f 73 69 6e 67 20 61 20 64 for closing a d
8ec0: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 atabase.** conne
8ed0: 63 74 69 6f 6e 2e 20 54 68 65 20 73 71 6c 69 74 ction. The sqlit
8ee0: 65 33 5f 63 6c 6f 73 65 28 29 20 76 65 72 73 69 e3_close() versi
8ef0: 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 on returns SQLIT
8f00: 45 5f 42 55 53 59 20 61 6e 64 0a 2a 2a 20 6c 65 E_BUSY and.** le
8f10: 61 76 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 aves the connect
8f20: 69 6f 6e 20 6f 70 74 69 6f 6e 20 69 66 20 74 68 ion option if th
8f30: 65 72 65 20 61 72 65 20 75 6e 66 69 6e 61 6c 69 ere are unfinali
8f40: 7a 65 64 20 70 72 65 70 61 72 65 64 0a 2a 2a 20 zed prepared.**
8f50: 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e statements or un
8f60: 66 69 6e 69 73 68 65 64 20 73 71 6c 69 74 65 33 finished sqlite3
8f70: 5f 62 61 63 6b 75 70 73 2e 20 20 54 68 65 20 73 _backups. The s
8f80: 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32 28 qlite3_close_v2(
8f90: 29 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 66 6f 72 ).** version for
8fa0: 63 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 ces the connecti
8fb0: 6f 6e 20 74 6f 20 62 65 63 6f 6d 65 20 61 20 7a on to become a z
8fc0: 6f 6d 62 69 65 20 69 66 20 74 68 65 72 65 20 61 ombie if there a
8fd0: 72 65 0a 2a 2a 20 75 6e 63 6c 6f 73 65 64 20 72 re.** unclosed r
8fe0: 65 73 6f 75 72 63 65 73 2c 20 61 6e 64 20 61 72 esources, and ar
8ff0: 72 61 6e 67 65 73 20 66 6f 72 20 64 65 61 6c 6c ranges for deall
9000: 6f 63 61 74 69 6f 6e 20 77 68 65 6e 20 74 68 65 ocation when the
9010: 20 6c 61 73 74 0a 2a 2a 20 70 72 65 70 61 72 65 last.** prepare
9020: 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 73 71 statement or sq
9030: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 63 6c 6f lite3_backup clo
9040: 73 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ses..*/.int sqli
9050: 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65 te3_close(sqlite
9060: 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 73 3 *db){ return s
9070: 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 2c 30 qlite3Close(db,0
9080: 29 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 ); }.int sqlite3
9090: 5f 63 6c 6f 73 65 5f 76 32 28 73 71 6c 69 74 65 _close_v2(sqlite
90a0: 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 73 3 *db){ return s
90b0: 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 2c 31 qlite3Close(db,1
90c0: 29 3b 20 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f ); }.../*.** Clo
90d0: 73 65 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 se the mutex on
90e0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
90f0: 69 6f 6e 20 64 62 2e 0a 2a 2a 0a 2a 2a 20 46 75 ion db..**.** Fu
9100: 72 74 68 65 72 6d 6f 72 65 2c 20 69 66 20 64 61 rthermore, if da
9110: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
9120: 6e 20 64 62 20 69 73 20 61 20 7a 6f 6d 62 69 65 n db is a zombie
9130: 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 74 (meaning that t
9140: 68 65 72 65 0a 2a 2a 20 68 61 73 20 62 65 65 6e here.** has been
9150: 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f a prior call to
9160: 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 sqlite3_close(d
9170: 62 29 20 6f 72 20 73 71 6c 69 74 65 33 5f 63 6c b) or sqlite3_cl
9180: 6f 73 65 5f 76 32 28 64 62 29 29 20 61 6e 64 0a ose_v2(db)) and.
9190: 2a 2a 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 ** every sqlite3
91a0: 5f 73 74 6d 74 20 68 61 73 20 6e 6f 77 20 62 65 _stmt has now be
91b0: 65 6e 20 66 69 6e 61 6c 69 7a 65 64 20 61 6e 64 en finalized and
91c0: 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 5f 62 every sqlite3_b
91d0: 61 63 6b 75 70 20 68 61 73 0a 2a 2a 20 66 69 6e ackup has.** fin
91e0: 69 73 68 65 64 2c 20 74 68 65 6e 20 66 72 65 65 ished, then free
91f0: 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 2e 0a all resources..
9200: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4c */.void sqlite3L
9210: 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f 73 eaveMutexAndClos
9220: 65 5a 6f 6d 62 69 65 28 73 71 6c 69 74 65 33 20 eZombie(sqlite3
9230: 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d *db){. HashElem
9240: 20 2a 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 *i;
9250: 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 20 /* Hash
9260: 74 61 62 6c 65 20 69 74 65 72 61 74 6f 72 20 2a table iterator *
9270: 2f 0a 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 2f 2a /. int j;.. /*
9280: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f 75 If there are ou
9290: 74 73 74 61 6e 64 69 6e 67 20 73 71 6c 69 74 65 tstanding sqlite
92a0: 33 5f 73 74 6d 74 20 6f 72 20 73 71 6c 69 74 65 3_stmt or sqlite
92b0: 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 3_backup objects
92c0: 0a 20 20 2a 2a 20 6f 72 20 69 66 20 74 68 65 20 . ** or if the
92d0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 6e connection has n
92e0: 6f 74 20 79 65 74 20 62 65 65 6e 20 63 6c 6f 73 ot yet been clos
92f0: 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 6c ed by sqlite3_cl
9300: 6f 73 65 5f 76 32 28 29 2c 0a 20 20 2a 2a 20 74 ose_v2(),. ** t
9310: 68 65 6e 20 6a 75 73 74 20 6c 65 61 76 65 20 74 hen just leave t
9320: 68 65 20 6d 75 74 65 78 20 61 6e 64 20 72 65 74 he mutex and ret
9330: 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 urn.. */. if(
9340: 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 db->magic!=SQLIT
9350: 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 20 7c E_MAGIC_ZOMBIE |
9360: 7c 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 | connectionIsBu
9370: 73 79 28 64 62 29 20 29 7b 0a 20 20 20 20 73 71 sy(db) ){. sq
9380: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
9390: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
93a0: 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 0a 20 return;. }..
93b0: 20 2f 2a 20 49 66 20 77 65 20 72 65 61 63 68 20 /* If we reach
93c0: 74 68 69 73 20 70 6f 69 6e 74 2c 20 69 74 20 6d this point, it m
93d0: 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 64 61 eans that the da
93e0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
93f0: 6e 20 68 61 73 0a 20 20 2a 2a 20 63 6c 6f 73 65 n has. ** close
9400: 64 20 61 6c 6c 20 73 71 6c 69 74 65 33 5f 73 74 d all sqlite3_st
9410: 6d 74 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 62 mt and sqlite3_b
9420: 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 61 6e ackup objects an
9430: 64 20 68 61 73 20 62 65 65 6e 0a 20 20 2a 2a 20 d has been. **
9440: 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 passed to sqlite
9450: 33 5f 63 6c 6f 73 65 20 28 6d 65 61 6e 69 6e 67 3_close (meaning
9460: 20 74 68 61 74 20 69 74 20 69 73 20 61 20 7a 6f that it is a zo
9470: 6d 62 69 65 29 2e 20 20 54 68 65 72 65 66 6f 72 mbie). Therefor
9480: 65 2c 0a 20 20 2a 2a 20 67 6f 20 61 68 65 61 64 e,. ** go ahead
9490: 20 61 6e 64 20 66 72 65 65 20 61 6c 6c 20 72 65 and free all re
94a0: 73 6f 75 72 63 65 73 2e 0a 20 20 2a 2f 0a 0a 20 sources.. */..
94b0: 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 /* If a transac
94c0: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 72 6f tion is open, ro
94d0: 6c 6c 20 69 74 20 62 61 63 6b 2e 20 54 68 69 73 ll it back. This
94e0: 20 61 6c 73 6f 20 65 6e 73 75 72 65 73 20 74 68 also ensures th
94f0: 61 74 20 69 66 0a 20 20 2a 2a 20 61 6e 79 20 64 at if. ** any d
9500: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 73 20 atabase schemas
9510: 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 69 have been modifi
9520: 65 64 20 62 79 20 61 6e 20 75 6e 63 6f 6d 6d 69 ed by an uncommi
9530: 74 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e tted transaction
9540: 0a 20 20 2a 2a 20 74 68 65 79 20 61 72 65 20 72 . ** they are r
9550: 65 73 65 74 2e 20 41 6e 64 20 74 68 61 74 20 74 eset. And that t
9560: 68 65 20 72 65 71 75 69 72 65 64 20 62 2d 74 72 he required b-tr
9570: 65 65 20 6d 75 74 65 78 20 69 73 20 68 65 6c 64 ee mutex is held
9580: 20 74 6f 20 6d 61 6b 65 0a 20 20 2a 2a 20 74 68 to make. ** th
9590: 65 20 70 61 67 65 72 20 72 6f 6c 6c 62 61 63 6b e pager rollback
95a0: 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 73 65 and schema rese
95b0: 74 20 61 6e 20 61 74 6f 6d 69 63 20 6f 70 65 72 t an atomic oper
95c0: 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 73 71 6c 69 ation. */. sqli
95d0: 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 te3RollbackAll(d
95e0: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 0a b, SQLITE_OK);..
95f0: 20 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 6f 75 /* Free any ou
9600: 74 73 74 61 6e 64 69 6e 67 20 53 61 76 65 70 6f tstanding Savepo
9610: 69 6e 74 20 73 74 72 75 63 74 75 72 65 73 2e 20 int structures.
9620: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 */. sqlite3Clos
9630: 65 53 61 76 65 70 6f 69 6e 74 73 28 64 62 29 3b eSavepoints(db);
9640: 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c .. /* Close all
9650: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
9660: 74 69 6f 6e 73 20 2a 2f 0a 20 20 66 6f 72 28 6a tions */. for(j
9670: 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a =0; j<db->nDb; j
9680: 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 ++){. struct
9690: 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e 61 Db *pDb = &db->a
96a0: 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 70 Db[j];. if( p
96b0: 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 Db->pBt ){.
96c0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f sqlite3BtreeClo
96d0: 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 se(pDb->pBt);.
96e0: 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30 pDb->pBt = 0
96f0: 3b 0a 20 20 20 20 20 20 69 66 28 20 6a 21 3d 31 ;. if( j!=1
9700: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 62 2d ){. pDb-
9710: 3e 70 53 63 68 65 6d 61 20 3d 20 30 3b 0a 20 20 >pSchema = 0;.
9720: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
9730: 20 20 2f 2a 20 43 6c 65 61 72 20 74 68 65 20 54 /* Clear the T
9740: 45 4d 50 20 73 63 68 65 6d 61 20 73 65 70 61 72 EMP schema separ
9750: 61 74 65 6c 79 20 61 6e 64 20 6c 61 73 74 20 2a ately and last *
9760: 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b /. if( db->aDb[
9770: 31 5d 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 1].pSchema ){.
9780: 20 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 43 sqlite3SchemaC
9790: 6c 65 61 72 28 64 62 2d 3e 61 44 62 5b 31 5d 2e lear(db->aDb[1].
97a0: 70 53 63 68 65 6d 61 29 3b 0a 20 20 7d 0a 20 20 pSchema);. }.
97b0: 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 sqlite3VtabUnloc
97c0: 6b 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 2f 2a kList(db);.. /*
97d0: 20 46 72 65 65 20 75 70 20 74 68 65 20 61 72 72 Free up the arr
97e0: 61 79 20 6f 66 20 61 75 78 69 6c 69 61 72 79 20 ay of auxiliary
97f0: 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 73 databases */. s
9800: 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 61 qlite3CollapseDa
9810: 74 61 62 61 73 65 41 72 72 61 79 28 64 62 29 3b tabaseArray(db);
9820: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e . assert( db->n
9830: 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 Db<=2 );. asser
9840: 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e t( db->aDb==db->
9850: 61 44 62 53 74 61 74 69 63 20 29 3b 0a 0a 20 20 aDbStatic );..
9860: 2f 2a 20 54 65 6c 6c 20 74 68 65 20 63 6f 64 65 /* Tell the code
9870: 20 69 6e 20 6e 6f 74 69 66 79 2e 63 20 74 68 61 in notify.c tha
9880: 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e t the connection
9890: 20 6e 6f 20 6c 6f 6e 67 65 72 20 68 6f 6c 64 73 no longer holds
98a0: 20 61 6e 79 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 any. ** locks
98b0: 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 and does not req
98c0: 75 69 72 65 20 61 6e 79 20 66 75 72 74 68 65 72 uire any further
98d0: 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 unlock-notify c
98e0: 61 6c 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 allbacks.. */.
98f0: 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
9900: 6f 6e 43 6c 6f 73 65 64 28 64 62 29 3b 0a 0a 20 onClosed(db);..
9910: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 for(i=sqliteHas
9920: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 46 75 6e hFirst(&db->aFun
9930: 63 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 c); i; i=sqliteH
9940: 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 ashNext(i)){.
9950: 20 46 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 2c FuncDef *pNext,
9960: 20 2a 70 3b 0a 20 20 20 20 70 20 3d 20 73 71 6c *p;. p = sql
9970: 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a iteHashData(i);.
9980: 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 66 75 do{. fu
9990: 6e 63 74 69 6f 6e 44 65 73 74 72 6f 79 28 64 62 nctionDestroy(db
99a0: 2c 20 70 29 3b 0a 20 20 20 20 20 20 70 4e 65 78 , p);. pNex
99b0: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 t = p->pNext;.
99c0: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
99d0: 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 e(db, p);.
99e0: 70 20 3d 20 70 4e 65 78 74 3b 0a 20 20 20 20 7d p = pNext;. }
99f0: 77 68 69 6c 65 28 20 70 20 29 3b 0a 20 20 7d 0a while( p );. }.
9a00: 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 6c 65 sqlite3HashCle
9a10: 61 72 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 0a ar(&db->aFunc);.
9a20: 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 for(i=sqliteHa
9a30: 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 43 6f shFirst(&db->aCo
9a40: 6c 6c 53 65 71 29 3b 20 69 3b 20 69 3d 73 71 6c llSeq); i; i=sql
9a50: 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b iteHashNext(i)){
9a60: 0a 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 . CollSeq *pC
9a70: 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 20 2a oll = (CollSeq *
9a80: 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 )sqliteHashData(
9a90: 69 29 3b 0a 20 20 20 20 2f 2a 20 49 6e 76 6f 6b i);. /* Invok
9aa0: 65 20 61 6e 79 20 64 65 73 74 72 75 63 74 6f 72 e any destructor
9ab0: 73 20 72 65 67 69 73 74 65 72 65 64 20 66 6f 72 s registered for
9ac0: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
9ad0: 6e 63 65 20 75 73 65 72 20 64 61 74 61 2e 20 2a nce user data. *
9ae0: 2f 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a /. for(j=0; j
9af0: 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 <3; j++){.
9b00: 69 66 28 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 65 if( pColl[j].xDe
9b10: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 6f l ){. pCo
9b20: 6c 6c 5b 6a 5d 2e 78 44 65 6c 28 70 43 6f 6c 6c ll[j].xDel(pColl
9b30: 5b 6a 5d 2e 70 55 73 65 72 29 3b 0a 20 20 20 20 [j].pUser);.
9b40: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 }. }. sq
9b50: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
9b60: 70 43 6f 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 pColl);. }. sq
9b70: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 lite3HashClear(&
9b80: 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a 23 db->aCollSeq);.#
9b90: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
9ba0: 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
9bb0: 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 for(i=sqliteHa
9bc0: 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 4d 6f shFirst(&db->aMo
9bd0: 64 75 6c 65 29 3b 20 69 3b 20 69 3d 73 71 6c 69 dule); i; i=sqli
9be0: 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a teHashNext(i)){.
9bf0: 20 20 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 Module *pMod
9c00: 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c = (Module *)sql
9c10: 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a iteHashData(i);.
9c20: 20 20 20 20 69 66 28 20 70 4d 6f 64 2d 3e 78 44 if( pMod->xD
9c30: 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 20 estroy ){.
9c40: 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 28 70 pMod->xDestroy(p
9c50: 4d 6f 64 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20 Mod->pAux);.
9c60: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 56 74 61 }. sqlite3Vta
9c70: 62 45 70 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 43 bEponymousTableC
9c80: 6c 65 61 72 28 64 62 2c 20 70 4d 6f 64 29 3b 0a lear(db, pMod);.
9c90: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
9ca0: 65 28 64 62 2c 20 70 4d 6f 64 29 3b 0a 20 20 7d e(db, pMod);. }
9cb0: 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 6c . sqlite3HashCl
9cc0: 65 61 72 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 ear(&db->aModule
9cd0: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c );.#endif.. sql
9ce0: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 ite3Error(db, SQ
9cf0: 4c 49 54 45 5f 4f 4b 29 3b 20 2f 2a 20 44 65 61 LITE_OK); /* Dea
9d00: 6c 6c 6f 63 61 74 65 73 20 61 6e 79 20 63 61 63 llocates any cac
9d10: 68 65 64 20 65 72 72 6f 72 20 73 74 72 69 6e 67 hed error string
9d20: 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 s. */. sqlite3V
9d30: 61 6c 75 65 46 72 65 65 28 64 62 2d 3e 70 45 72 alueFree(db->pEr
9d40: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f r);. sqlite3Clo
9d50: 73 65 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 seExtensions(db)
9d60: 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 55 53 45 ;.#if SQLITE_USE
9d70: 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 4f 4e R_AUTHENTICATION
9d80: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
9d90: 64 62 2d 3e 61 75 74 68 2e 7a 41 75 74 68 55 73 db->auth.zAuthUs
9da0: 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 er);. sqlite3_f
9db0: 72 65 65 28 64 62 2d 3e 61 75 74 68 2e 7a 41 75 ree(db->auth.zAu
9dc0: 74 68 50 57 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 thPW);.#endif..
9dd0: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
9de0: 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b ITE_MAGIC_ERROR;
9df0: 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d 70 2d .. /* The temp-
9e00: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 database schema
9e10: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 66 is allocated dif
9e20: 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 74 68 ferently from th
9e30: 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61 0a 20 e other schema.
9e40: 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 73 69 ** objects (usi
9e50: 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 ng sqliteMalloc(
9e60: 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 ) directly, inst
9e70: 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33 42 74 ead of sqlite3Bt
9e80: 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a 20 20 reeSchema())..
9e90: 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 20 74 ** So it needs t
9ea0: 6f 20 62 65 20 66 72 65 65 64 20 68 65 72 65 2e o be freed here.
9eb0: 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 20 72 Todo: Why not r
9ec0: 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 63 68 oll the temp sch
9ed0: 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 ema into. ** th
9ee0: 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d 61 6c e same sqliteMal
9ef0: 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f 6e 65 loc() as the one
9f00: 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 73 20 that allocates
9f10: 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 20 20 the database .
9f20: 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a 20 20 ** structure?.
9f30: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 */. sqlite3DbFr
9f40: 65 65 28 64 62 2c 20 64 62 2d 3e 61 44 62 5b 31 ee(db, db->aDb[1
9f50: 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 73 71 ].pSchema);. sq
9f60: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
9f70: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
9f80: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 db->magic = SQLI
9f90: 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b TE_MAGIC_CLOSED;
9fa0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
9fb0: 5f 66 72 65 65 28 64 62 2d 3e 6d 75 74 65 78 29 _free(db->mutex)
9fc0: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e ;. assert( db->
9fd0: 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 3d 3d lookaside.nOut==
9fe0: 30 20 29 3b 20 20 2f 2a 20 46 61 69 6c 73 20 6f 0 ); /* Fails o
9ff0: 6e 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 n a lookaside me
a000: 6d 6f 72 79 20 6c 65 61 6b 20 2a 2f 0a 20 20 69 mory leak */. i
a010: 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 f( db->lookaside
a020: 2e 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 .bMalloced ){.
a030: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 sqlite3_free(d
a040: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 b->lookaside.pSt
a050: 61 72 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 art);. }. sqli
a060: 74 65 33 5f 66 72 65 65 28 64 62 29 3b 0a 7d 0a te3_free(db);.}.
a070: 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 ./*.** Rollback
a080: 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c all database fil
a090: 65 73 2e 20 20 49 66 20 74 72 69 70 43 6f 64 65 es. If tripCode
a0a0: 20 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f 4f is not SQLITE_O
a0b0: 4b 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 79 20 77 K, then.** any w
a0c0: 72 69 74 65 20 63 75 72 73 6f 72 73 20 61 72 65 rite cursors are
a0d0: 20 69 6e 76 61 6c 69 64 61 74 65 64 20 28 22 74 invalidated ("t
a0e0: 72 69 70 70 65 64 22 20 2d 20 61 73 20 69 6e 20 ripped" - as in
a0f0: 22 74 72 69 70 70 69 6e 67 20 61 20 63 69 72 63 "tripping a circ
a100: 75 69 74 0a 2a 2a 20 62 72 65 61 6b 65 72 22 29 uit.** breaker")
a110: 20 61 6e 64 20 6d 61 64 65 20 74 6f 20 72 65 74 and made to ret
a120: 75 72 6e 20 74 72 69 70 43 6f 64 65 20 69 66 20 urn tripCode if
a130: 74 68 65 72 65 20 61 72 65 20 61 6e 79 20 66 75 there are any fu
a140: 72 74 68 65 72 0a 2a 2a 20 61 74 74 65 6d 70 74 rther.** attempt
a150: 73 20 74 6f 20 75 73 65 20 74 68 61 74 20 63 75 s to use that cu
a160: 72 73 6f 72 2e 20 20 52 65 61 64 20 63 75 72 73 rsor. Read curs
a170: 6f 72 73 20 72 65 6d 61 69 6e 20 6f 70 65 6e 20 ors remain open
a180: 61 6e 64 20 76 61 6c 69 64 0a 2a 2a 20 62 75 74 and valid.** but
a190: 20 61 72 65 20 22 73 61 76 65 64 22 20 69 6e 20 are "saved" in
a1a0: 63 61 73 65 20 74 68 65 20 74 61 62 6c 65 20 70 case the table p
a1b0: 61 67 65 73 20 61 72 65 20 6d 6f 76 65 64 20 61 ages are moved a
a1c0: 72 6f 75 6e 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 round..*/.void s
a1d0: 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c qlite3RollbackAl
a1e0: 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 l(sqlite3 *db, i
a1f0: 6e 74 20 74 72 69 70 43 6f 64 65 29 7b 0a 20 20 nt tripCode){.
a200: 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 69 6e 54 int i;. int inT
a210: 72 61 6e 73 20 3d 20 30 3b 0a 20 20 69 6e 74 20 rans = 0;. int
a220: 73 63 68 65 6d 61 43 68 61 6e 67 65 3b 0a 20 20 schemaChange;.
a230: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
a240: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d mutex_held(db->m
a250: 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 utex) );. sqlit
a260: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c e3BeginBenignMal
a270: 6c 6f 63 28 29 3b 0a 0a 20 20 2f 2a 20 4f 62 74 loc();.. /* Obt
a280: 61 69 6e 20 61 6c 6c 20 62 2d 74 72 65 65 20 6d ain all b-tree m
a290: 75 74 65 78 65 73 20 62 65 66 6f 72 65 20 6d 61 utexes before ma
a2a0: 6b 69 6e 67 20 61 6e 79 20 63 61 6c 6c 73 20 74 king any calls t
a2b0: 6f 20 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 o BtreeRollback(
a2c0: 29 2e 20 0a 20 20 2a 2a 20 54 68 69 73 20 69 73 ). . ** This is
a2d0: 20 69 6d 70 6f 72 74 61 6e 74 20 69 6e 20 63 61 important in ca
a2e0: 73 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 se the transacti
a2f0: 6f 6e 20 62 65 69 6e 67 20 72 6f 6c 6c 65 64 20 on being rolled
a300: 62 61 63 6b 20 68 61 73 0a 20 20 2a 2a 20 6d 6f back has. ** mo
a310: 64 69 66 69 65 64 20 74 68 65 20 64 61 74 61 62 dified the datab
a320: 61 73 65 20 73 63 68 65 6d 61 2e 20 49 66 20 74 ase schema. If t
a330: 68 65 20 62 2d 74 72 65 65 20 6d 75 74 65 78 65 he b-tree mutexe
a340: 73 20 61 72 65 20 6e 6f 74 20 74 61 6b 65 6e 0a s are not taken.
a350: 20 20 2a 2a 20 68 65 72 65 2c 20 74 68 65 6e 20 ** here, then
a360: 61 6e 6f 74 68 65 72 20 73 68 61 72 65 64 2d 63 another shared-c
a370: 61 63 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 ache connection
a380: 6d 69 67 68 74 20 73 6e 65 61 6b 20 69 6e 20 62 might sneak in b
a390: 65 74 77 65 65 6e 0a 20 20 2a 2a 20 74 68 65 20 etween. ** the
a3a0: 64 61 74 61 62 61 73 65 20 72 6f 6c 6c 62 61 63 database rollbac
a3b0: 6b 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 73 k and schema res
a3c0: 65 74 2c 20 77 68 69 63 68 20 63 61 6e 20 63 61 et, which can ca
a3d0: 75 73 65 20 66 61 6c 73 65 0a 20 20 2a 2a 20 63 use false. ** c
a3e0: 6f 72 72 75 70 74 69 6f 6e 20 72 65 70 6f 72 74 orruption report
a3f0: 73 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 2e s in some cases.
a400: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 */. sqlite3Bt
a410: 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b reeEnterAll(db);
a420: 0a 20 20 73 63 68 65 6d 61 43 68 61 6e 67 65 20 . schemaChange
a430: 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 = (db->flags & S
a440: 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e QLITE_InternChan
a450: 67 65 73 29 21 3d 30 20 26 26 20 64 62 2d 3e 69 ges)!=0 && db->i
a460: 6e 69 74 2e 62 75 73 79 3d 3d 30 3b 0a 0a 20 20 nit.busy==0;..
a470: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e for(i=0; i<db->n
a480: 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 Db; i++){. Bt
a490: 72 65 65 20 2a 70 20 3d 20 64 62 2d 3e 61 44 62 ree *p = db->aDb
a4a0: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 [i].pBt;. if(
a4b0: 20 70 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 p ){. if(
a4c0: 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e sqlite3BtreeIsIn
a4d0: 54 72 61 6e 73 28 70 29 20 29 7b 0a 20 20 20 20 Trans(p) ){.
a4e0: 20 20 20 20 69 6e 54 72 61 6e 73 20 3d 20 31 3b inTrans = 1;
a4f0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 . }. s
a500: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 qlite3BtreeRollb
a510: 61 63 6b 28 70 2c 20 74 72 69 70 43 6f 64 65 2c ack(p, tripCode,
a520: 20 21 73 63 68 65 6d 61 43 68 61 6e 67 65 29 3b !schemaChange);
a530: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c . }. }. sql
a540: 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b ite3VtabRollback
a550: 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 (db);. sqlite3E
a560: 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 ndBenignMalloc()
a570: 3b 0a 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 6c ;.. if( (db->fl
a580: 61 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 ags&SQLITE_Inter
a590: 6e 43 68 61 6e 67 65 73 29 21 3d 30 20 26 26 20 nChanges)!=0 &&
a5a0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 db->init.busy==0
a5b0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 ){. sqlite3E
a5c0: 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 xpirePreparedSta
a5d0: 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 tements(db);.
a5e0: 20 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c sqlite3ResetAll
a5f0: 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 SchemasOfConnect
a600: 69 6f 6e 28 64 62 29 3b 0a 20 20 7d 0a 20 20 73 ion(db);. }. s
a610: 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
a620: 41 6c 6c 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 41 All(db);.. /* A
a630: 6e 79 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 ny deferred cons
a640: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e traint violation
a650: 73 20 68 61 76 65 20 6e 6f 77 20 62 65 65 6e 20 s have now been
a660: 72 65 73 6f 6c 76 65 64 2e 20 2a 2f 0a 20 20 64 resolved. */. d
a670: 62 2d 3e 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 b->nDeferredCons
a680: 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e 44 65 66 = 0;. db->nDef
a690: 65 72 72 65 64 49 6d 6d 43 6f 6e 73 20 3d 20 30 erredImmCons = 0
a6a0: 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d ;. db->flags &=
a6b0: 20 7e 53 51 4c 49 54 45 5f 44 65 66 65 72 46 4b ~SQLITE_DeferFK
a6c0: 73 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 20 s;.. /* If one
a6d0: 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 75 has been configu
a6e0: 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 red, invoke the
a6f0: 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 rollback-hook ca
a700: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 20 llback */. if(
a710: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c db->xRollbackCal
a720: 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 6e lback && (inTran
a730: 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 6f s || !db->autoCo
a740: 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 2d mmit) ){. db-
a750: 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 >xRollbackCallba
a760: 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b ck(db->pRollback
a770: 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a Arg);. }.}../*.
a780: 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 ** Return a stat
a790: 69 63 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 ic string contai
a7a0: 6e 69 6e 67 20 74 68 65 20 6e 61 6d 65 20 63 6f ning the name co
a7b0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 rresponding to t
a7c0: 68 65 20 65 72 72 6f 72 20 63 6f 64 65 0a 2a 2a he error code.**
a7d0: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 specified in th
a7e0: 65 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 23 e argument..*/.#
a7f0: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
a800: 45 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 29 E_NEED_ERR_NAME)
a810: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c .const char *sql
a820: 69 74 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 20 ite3ErrName(int
a830: 72 63 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 rc){. const cha
a840: 72 20 2a 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20 20 r *zName = 0;.
a850: 69 6e 74 20 69 2c 20 6f 72 69 67 52 63 20 3d 20 int i, origRc =
a860: 72 63 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 rc;. for(i=0; i
a870: 3c 32 20 26 26 20 7a 4e 61 6d 65 3d 3d 30 3b 20 <2 && zName==0;
a880: 69 2b 2b 2c 20 72 63 20 26 3d 20 30 78 66 66 29 i++, rc &= 0xff)
a890: 7b 0a 20 20 20 20 73 77 69 74 63 68 28 20 72 63 {. switch( rc
a8a0: 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ){. case S
a8b0: 51 4c 49 54 45 5f 4f 4b 3a 20 20 20 20 20 20 20 QLITE_OK:
a8c0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
a8d0: 3d 20 22 53 51 4c 49 54 45 5f 4f 4b 22 3b 20 20 = "SQLITE_OK";
a8e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 br
a8f0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a900: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3a 20 20 20 SQLITE_ERROR:
a910: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
a920: 20 3d 20 22 53 51 4c 49 54 45 5f 45 52 52 4f 52 = "SQLITE_ERROR
a930: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 "; b
a940: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a950: 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c SQLITE_INTERNAL
a960: 3a 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d : zNam
a970: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4e 54 45 e = "SQLITE_INTE
a980: 52 4e 41 4c 22 3b 20 20 20 20 20 20 20 20 20 20 RNAL";
a990: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a9a0: 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a 20 20 e SQLITE_PERM:
a9b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
a9c0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 50 45 52 me = "SQLITE_PER
a9d0: 4d 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 M";
a9e0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a9f0: 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 3a se SQLITE_ABORT:
aa00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
aa10: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 42 ame = "SQLITE_AB
aa20: 4f 52 54 22 3b 20 20 20 20 20 20 20 20 20 20 20 ORT";
aa30: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
aa40: 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 ase SQLITE_ABORT
aa50: 5f 52 4f 4c 4c 42 41 43 4b 3a 20 20 20 20 20 7a _ROLLBACK: z
aa60: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 Name = "SQLITE_A
aa70: 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 BORT_ROLLBACK";
aa80: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
aa90: 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 case SQLITE_BUSY
aaa0: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :
aab0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
aac0: 42 55 53 59 22 3b 20 20 20 20 20 20 20 20 20 20 BUSY";
aad0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aae0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 53 case SQLITE_BUS
aaf0: 59 5f 52 45 43 4f 56 45 52 59 3a 20 20 20 20 20 Y_RECOVERY:
ab00: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
ab10: 5f 42 55 53 59 5f 52 45 43 4f 56 45 52 59 22 3b _BUSY_RECOVERY";
ab20: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
ab30: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 case SQLITE_BU
ab40: 53 59 5f 53 4e 41 50 53 48 4f 54 3a 20 20 20 20 SY_SNAPSHOT:
ab50: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
ab60: 45 5f 42 55 53 59 5f 53 4e 41 50 53 48 4f 54 22 E_BUSY_SNAPSHOT"
ab70: 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 ; break;.
ab80: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c case SQLITE_L
ab90: 4f 43 4b 45 44 3a 20 20 20 20 20 20 20 20 20 20 OCKED:
aba0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
abb0: 54 45 5f 4c 4f 43 4b 45 44 22 3b 20 20 20 20 20 TE_LOCKED";
abc0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
abd0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
abe0: 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 LOCKED_SHAREDCAC
abf0: 48 45 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c HE: zName = "SQL
ac00: 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 ITE_LOCKED_SHARE
ac10: 44 43 41 43 48 45 22 3b 62 72 65 61 6b 3b 0a 20 DCACHE";break;.
ac20: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
ac30: 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 20 20 20 _NOMEM:
ac40: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
ac50: 4c 49 54 45 5f 4e 4f 4d 45 4d 22 3b 20 20 20 20 LITE_NOMEM";
ac60: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
ac70: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
ac80: 45 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 20 20 E_READONLY:
ac90: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
aca0: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 22 3b QLITE_READONLY";
acb0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
acc0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
acd0: 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 45 43 4f TE_READONLY_RECO
ace0: 56 45 52 59 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 VERY: zName = "
acf0: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f SQLITE_READONLY_
ad00: 52 45 43 4f 56 45 52 59 22 3b 20 62 72 65 61 6b RECOVERY"; break
ad10: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
ad20: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 41 4e ITE_READONLY_CAN
ad30: 54 4c 4f 43 4b 3a 20 20 7a 4e 61 6d 65 20 3d 20 TLOCK: zName =
ad40: 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 "SQLITE_READONLY
ad50: 5f 43 41 4e 54 4c 4f 43 4b 22 3b 20 62 72 65 61 _CANTLOCK"; brea
ad60: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
ad70: 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 4f LITE_READONLY_RO
ad80: 4c 4c 42 41 43 4b 3a 20 20 7a 4e 61 6d 65 20 3d LLBACK: zName =
ad90: 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c "SQLITE_READONL
ada0: 59 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 62 72 65 Y_ROLLBACK"; bre
adb0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
adc0: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 44 QLITE_READONLY_D
add0: 42 4d 4f 56 45 44 3a 20 20 20 7a 4e 61 6d 65 20 BMOVED: zName
ade0: 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e = "SQLITE_READON
adf0: 4c 59 5f 44 42 4d 4f 56 45 44 22 3b 20 20 62 72 LY_DBMOVED"; br
ae00: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
ae10: 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 SQLITE_INTERRUPT
ae20: 3a 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 : zName
ae30: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4e 54 45 52 = "SQLITE_INTER
ae40: 52 55 50 54 22 3b 20 20 20 20 20 20 20 20 20 62 RUPT"; b
ae50: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
ae60: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3a 20 20 SQLITE_IOERR:
ae70: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
ae80: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
ae90: 52 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 R";
aea0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
aeb0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 e SQLITE_IOERR_R
aec0: 45 41 44 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 EAD: zNa
aed0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
aee0: 52 52 5f 52 45 41 44 22 3b 20 20 20 20 20 20 20 RR_READ";
aef0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
af00: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
af10: 53 48 4f 52 54 5f 52 45 41 44 3a 20 20 20 7a 4e SHORT_READ: zN
af20: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
af30: 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 22 3b ERR_SHORT_READ";
af40: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
af50: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
af60: 5f 57 52 49 54 45 3a 20 20 20 20 20 20 20 20 7a _WRITE: z
af70: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
af80: 4f 45 52 52 5f 57 52 49 54 45 22 3b 20 20 20 20 OERR_WRITE";
af90: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
afa0: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
afb0: 52 5f 46 53 59 4e 43 3a 20 20 20 20 20 20 20 20 R_FSYNC:
afc0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
afd0: 49 4f 45 52 52 5f 46 53 59 4e 43 22 3b 20 20 20 IOERR_FSYNC";
afe0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aff0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
b000: 52 52 5f 44 49 52 5f 46 53 59 4e 43 3a 20 20 20 RR_DIR_FSYNC:
b010: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b020: 5f 49 4f 45 52 52 5f 44 49 52 5f 46 53 59 4e 43 _IOERR_DIR_FSYNC
b030: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 "; break;.
b040: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
b050: 45 52 52 5f 54 52 55 4e 43 41 54 45 3a 20 20 20 ERR_TRUNCATE:
b060: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b070: 45 5f 49 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 E_IOERR_TRUNCATE
b080: 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 "; break;.
b090: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
b0a0: 4f 45 52 52 5f 46 53 54 41 54 3a 20 20 20 20 20 OERR_FSTAT:
b0b0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b0c0: 54 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 22 3b TE_IOERR_FSTAT";
b0d0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b0e0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b0f0: 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3a 20 20 20 IOERR_UNLOCK:
b100: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b110: 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b ITE_IOERR_UNLOCK
b120: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 "; break;.
b130: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b140: 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b 3a 20 20 _IOERR_RDLOCK:
b150: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b160: 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 LITE_IOERR_RDLOC
b170: 4b 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a K"; break;.
b180: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b190: 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 3a 20 E_IOERR_DELETE:
b1a0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
b1b0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 QLITE_IOERR_DELE
b1c0: 54 45 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b TE"; break;
b1d0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b1e0: 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3a 20 TE_IOERR_NOMEM:
b1f0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
b200: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d SQLITE_IOERR_NOM
b210: 45 4d 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b EM"; break
b220: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b230: 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 45 53 53 ITE_IOERR_ACCESS
b240: 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 : zName =
b250: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 41 43 "SQLITE_IOERR_AC
b260: 43 45 53 53 22 3b 20 20 20 20 20 20 62 72 65 61 CESS"; brea
b270: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b280: 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b LITE_IOERR_CHECK
b290: 52 45 53 45 52 56 45 44 4c 4f 43 4b 3a 0a 20 20 RESERVEDLOCK:.
b2a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
b2c0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
b2d0: 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45 ERR_CHECKRESERVE
b2e0: 44 4c 4f 43 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 DLOCK"; break;.
b2f0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b300: 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3a 20 20 20 20 _IOERR_LOCK:
b310: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b320: 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 22 LITE_IOERR_LOCK"
b330: 3b 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a ; break;.
b340: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b350: 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 3a 20 20 E_IOERR_CLOSE:
b360: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
b370: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 QLITE_IOERR_CLOS
b380: 45 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b E"; break;
b390: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b3a0: 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 43 4c 4f TE_IOERR_DIR_CLO
b3b0: 53 45 3a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 SE: zName = "
b3c0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 SQLITE_IOERR_DIR
b3d0: 5f 43 4c 4f 53 45 22 3b 20 20 20 62 72 65 61 6b _CLOSE"; break
b3e0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b3f0: 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4f 50 45 ITE_IOERR_SHMOPE
b400: 4e 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 N: zName =
b410: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 "SQLITE_IOERR_SH
b420: 4d 4f 50 45 4e 22 3b 20 20 20 20 20 62 72 65 61 MOPEN"; brea
b430: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b440: 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 53 49 LITE_IOERR_SHMSI
b450: 5a 45 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d ZE: zName =
b460: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 "SQLITE_IOERR_S
b470: 48 4d 53 49 5a 45 22 3b 20 20 20 20 20 62 72 65 HMSIZE"; bre
b480: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
b490: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4c QLITE_IOERR_SHML
b4a0: 4f 43 4b 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 OCK: zName
b4b0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
b4c0: 53 48 4d 4c 4f 43 4b 22 3b 20 20 20 20 20 62 72 SHMLOCK"; br
b4d0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
b4e0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d SQLITE_IOERR_SHM
b4f0: 4d 41 50 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 MAP: zName
b500: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
b510: 5f 53 48 4d 4d 41 50 22 3b 20 20 20 20 20 20 62 _SHMMAP"; b
b520: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
b530: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 45 SQLITE_IOERR_SE
b540: 45 4b 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d EK: zNam
b550: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
b560: 52 5f 53 45 45 4b 22 3b 20 20 20 20 20 20 20 20 R_SEEK";
b570: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b580: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 e SQLITE_IOERR_D
b590: 45 4c 45 54 45 5f 4e 4f 45 4e 54 3a 20 7a 4e 61 ELETE_NOENT: zNa
b5a0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
b5b0: 52 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54 22 RR_DELETE_NOENT"
b5c0: 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 ;break;. ca
b5d0: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
b5e0: 4d 4d 41 50 3a 20 20 20 20 20 20 20 20 20 7a 4e MMAP: zN
b5f0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
b600: 45 52 52 5f 4d 4d 41 50 22 3b 20 20 20 20 20 20 ERR_MMAP";
b610: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
b620: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
b630: 5f 47 45 54 54 45 4d 50 50 41 54 48 3a 20 20 7a _GETTEMPPATH: z
b640: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
b650: 4f 45 52 52 5f 47 45 54 54 45 4d 50 50 41 54 48 OERR_GETTEMPPATH
b660: 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 "; break;.
b670: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
b680: 52 5f 43 4f 4e 56 50 41 54 48 3a 20 20 20 20 20 R_CONVPATH:
b690: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b6a0: 49 4f 45 52 52 5f 43 4f 4e 56 50 41 54 48 22 3b IOERR_CONVPATH";
b6b0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
b6c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 case SQLITE_COR
b6d0: 52 55 50 54 3a 20 20 20 20 20 20 20 20 20 20 20 RUPT:
b6e0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b6f0: 5f 43 4f 52 52 55 50 54 22 3b 20 20 20 20 20 20 _CORRUPT";
b700: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b710: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
b720: 52 52 55 50 54 5f 56 54 41 42 3a 20 20 20 20 20 RRUPT_VTAB:
b730: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b740: 45 5f 43 4f 52 52 55 50 54 5f 56 54 41 42 22 3b E_CORRUPT_VTAB";
b750: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b760: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
b770: 4f 54 46 4f 55 4e 44 3a 20 20 20 20 20 20 20 20 OTFOUND:
b780: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b790: 54 45 5f 4e 4f 54 46 4f 55 4e 44 22 3b 20 20 20 TE_NOTFOUND";
b7a0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b7b0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b7c0: 46 55 4c 4c 3a 20 20 20 20 20 20 20 20 20 20 20 FULL:
b7d0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b7e0: 49 54 45 5f 46 55 4c 4c 22 3b 20 20 20 20 20 20 ITE_FULL";
b7f0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
b800: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b810: 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 20 20 20 _CANTOPEN:
b820: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b830: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 22 3b 20 LITE_CANTOPEN";
b840: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
b850: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b860: 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 45 4d E_CANTOPEN_NOTEM
b870: 50 44 49 52 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 PDIR: zName = "S
b880: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e QLITE_CANTOPEN_N
b890: 4f 54 45 4d 50 44 49 52 22 3b 62 72 65 61 6b 3b OTEMPDIR";break;
b8a0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b8b0: 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 44 49 TE_CANTOPEN_ISDI
b8c0: 52 3a 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 R: zName = "
b8d0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
b8e0: 49 53 44 49 52 22 3b 20 20 20 20 62 72 65 61 6b ISDIR"; break
b8f0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b900: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 55 4c ITE_CANTOPEN_FUL
b910: 4c 50 41 54 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 LPATH: zName =
b920: 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e "SQLITE_CANTOPEN
b930: 5f 46 55 4c 4c 50 41 54 48 22 3b 20 62 72 65 61 _FULLPATH"; brea
b940: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b950: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 43 4f LITE_CANTOPEN_CO
b960: 4e 56 50 41 54 48 3a 20 20 7a 4e 61 6d 65 20 3d NVPATH: zName =
b970: 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 "SQLITE_CANTOPE
b980: 4e 5f 43 4f 4e 56 50 41 54 48 22 3b 20 62 72 65 N_CONVPATH"; bre
b990: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
b9a0: 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3a 20 QLITE_PROTOCOL:
b9b0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
b9c0: 3d 20 22 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 = "SQLITE_PROTOC
b9d0: 4f 4c 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 OL"; br
b9e0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
b9f0: 53 51 4c 49 54 45 5f 45 4d 50 54 59 3a 20 20 20 SQLITE_EMPTY:
ba00: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
ba10: 20 3d 20 22 53 51 4c 49 54 45 5f 45 4d 50 54 59 = "SQLITE_EMPTY
ba20: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 "; b
ba30: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
ba40: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 3a 20 SQLITE_SCHEMA:
ba50: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
ba60: 65 20 3d 20 22 53 51 4c 49 54 45 5f 53 43 48 45 e = "SQLITE_SCHE
ba70: 4d 41 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 MA";
ba80: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
ba90: 65 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3a e SQLITE_TOOBIG:
baa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
bab0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 54 4f 4f me = "SQLITE_TOO
bac0: 42 49 47 22 3b 20 20 20 20 20 20 20 20 20 20 20 BIG";
bad0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
bae0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 se SQLITE_CONSTR
baf0: 41 49 4e 54 3a 20 20 20 20 20 20 20 20 20 7a 4e AINT: zN
bb00: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f ame = "SQLITE_CO
bb10: 4e 53 54 52 41 49 4e 54 22 3b 20 20 20 20 20 20 NSTRAINT";
bb20: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
bb30: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 ase SQLITE_CONST
bb40: 52 41 49 4e 54 5f 55 4e 49 51 55 45 3a 20 20 7a RAINT_UNIQUE: z
bb50: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
bb60: 4f 4e 53 54 52 41 49 4e 54 5f 55 4e 49 51 55 45 ONSTRAINT_UNIQUE
bb70: 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 "; break;.
bb80: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 case SQLITE_CONS
bb90: 54 52 41 49 4e 54 5f 54 52 49 47 47 45 52 3a 20 TRAINT_TRIGGER:
bba0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
bbb0: 43 4f 4e 53 54 52 41 49 4e 54 5f 54 52 49 47 47 CONSTRAINT_TRIGG
bbc0: 45 52 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 ER";break;.
bbd0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
bbe0: 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 47 4e 4b STRAINT_FOREIGNK
bbf0: 45 59 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 EY:.
bc00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bc10: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
bc20: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 ITE_CONSTRAINT_F
bc30: 4f 52 45 49 47 4e 4b 45 59 22 3b 20 20 20 62 72 OREIGNKEY"; br
bc40: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
bc50: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
bc60: 54 5f 43 48 45 43 4b 3a 20 20 20 7a 4e 61 6d 65 T_CHECK: zName
bc70: 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 = "SQLITE_CONST
bc80: 52 41 49 4e 54 5f 43 48 45 43 4b 22 3b 20 20 62 RAINT_CHECK"; b
bc90: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
bca0: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
bcb0: 4e 54 5f 50 52 49 4d 41 52 59 4b 45 59 3a 0a 20 NT_PRIMARYKEY:.
bcc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bcd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a z
bce0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
bcf0: 4f 4e 53 54 52 41 49 4e 54 5f 50 52 49 4d 41 52 ONSTRAINT_PRIMAR
bd00: 59 4b 45 59 22 3b 20 20 20 62 72 65 61 6b 3b 0a YKEY"; break;.
bd10: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
bd20: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4e 4f 54 E_CONSTRAINT_NOT
bd30: 4e 55 4c 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 NULL: zName = "S
bd40: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
bd50: 5f 4e 4f 54 4e 55 4c 4c 22 3b 62 72 65 61 6b 3b _NOTNULL";break;
bd60: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
bd70: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 43 4f TE_CONSTRAINT_CO
bd80: 4d 4d 49 54 48 4f 4f 4b 3a 0a 20 20 20 20 20 20 MMITHOOK:.
bd90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bda0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
bdb0: 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 = "SQLITE_CONSTR
bdc0: 41 49 4e 54 5f 43 4f 4d 4d 49 54 48 4f 4f 4b 22 AINT_COMMITHOOK"
bdd0: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 ; break;.
bde0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
bdf0: 53 54 52 41 49 4e 54 5f 56 54 41 42 3a 20 20 20 STRAINT_VTAB:
be00: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
be10: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 56 54 41 42 _CONSTRAINT_VTAB
be20: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 "; break;.
be30: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
be40: 4e 53 54 52 41 49 4e 54 5f 46 55 4e 43 54 49 4f NSTRAINT_FUNCTIO
be50: 4e 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 N:.
be60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
be70: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
be80: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 55 TE_CONSTRAINT_FU
be90: 4e 43 54 49 4f 4e 22 3b 20 20 20 20 20 62 72 65 NCTION"; bre
bea0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
beb0: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
bec0: 5f 52 4f 57 49 44 3a 20 20 20 7a 4e 61 6d 65 20 _ROWID: zName
bed0: 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 = "SQLITE_CONSTR
bee0: 41 49 4e 54 5f 52 4f 57 49 44 22 3b 20 20 62 72 AINT_ROWID"; br
bef0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
bf00: 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 48 3a SQLITE_MISMATCH:
bf10: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
bf20: 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 4d 41 = "SQLITE_MISMA
bf30: 54 43 48 22 3b 20 20 20 20 20 20 20 20 20 20 62 TCH"; b
bf40: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
bf50: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3a 20 SQLITE_MISUSE:
bf60: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
bf70: 65 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 55 e = "SQLITE_MISU
bf80: 53 45 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 SE";
bf90: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
bfa0: 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3a 20 e SQLITE_NOLFS:
bfb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
bfc0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 4c me = "SQLITE_NOL
bfd0: 46 53 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 FS";
bfe0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
bff0: 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 3a 20 se SQLITE_AUTH:
c000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
c010: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 41 55 ame = "SQLITE_AU
c020: 54 48 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 TH";
c030: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
c040: 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 ase SQLITE_FORMA
c050: 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a T: z
c060: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 46 Name = "SQLITE_F
c070: 4f 52 4d 41 54 22 3b 20 20 20 20 20 20 20 20 20 ORMAT";
c080: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
c090: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 4e 47 case SQLITE_RANG
c0a0: 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 E:
c0b0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
c0c0: 52 41 4e 47 45 22 3b 20 20 20 20 20 20 20 20 20 RANGE";
c0d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
c0e0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 case SQLITE_NOT
c0f0: 41 44 42 3a 20 20 20 20 20 20 20 20 20 20 20 20 ADB:
c100: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
c110: 5f 4e 4f 54 41 44 42 22 3b 20 20 20 20 20 20 20 _NOTADB";
c120: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
c130: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 4f case SQLITE_RO
c140: 57 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 W:
c150: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
c160: 45 5f 52 4f 57 22 3b 20 20 20 20 20 20 20 20 20 E_ROW";
c170: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
c180: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
c190: 4f 54 49 43 45 3a 20 20 20 20 20 20 20 20 20 20 OTICE:
c1a0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
c1b0: 54 45 5f 4e 4f 54 49 43 45 22 3b 20 20 20 20 20 TE_NOTICE";
c1c0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
c1d0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
c1e0: 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 57 NOTICE_RECOVER_W
c1f0: 41 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c AL: zName = "SQL
c200: 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 ITE_NOTICE_RECOV
c210: 45 52 5f 57 41 4c 22 3b 62 72 65 61 6b 3b 0a 20 ER_WAL";break;.
c220: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
c230: 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f _NOTICE_RECOVER_
c240: 52 4f 4c 4c 42 41 43 4b 3a 0a 20 20 20 20 20 20 ROLLBACK:.
c250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c260: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
c270: 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 = "SQLITE_NOTICE
c280: 5f 52 45 43 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 _RECOVER_ROLLBAC
c290: 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 K"; break;.
c2a0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 57 41 52 case SQLITE_WAR
c2b0: 4e 49 4e 47 3a 20 20 20 20 20 20 20 20 20 20 20 NING:
c2c0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
c2d0: 5f 57 41 52 4e 49 4e 47 22 3b 20 20 20 20 20 20 _WARNING";
c2e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
c2f0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 57 41 case SQLITE_WA
c300: 52 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 58 3a RNING_AUTOINDEX:
c310: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
c320: 45 5f 57 41 52 4e 49 4e 47 5f 41 55 54 4f 49 4e E_WARNING_AUTOIN
c330: 44 45 58 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 DEX"; break;.
c340: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 case SQLITE_D
c350: 4f 4e 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 ONE:
c360: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
c370: 54 45 5f 44 4f 4e 45 22 3b 20 20 20 20 20 20 20 TE_DONE";
c380: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
c390: 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 7a 4e }. }. if( zN
c3a0: 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 ame==0 ){. st
c3b0: 61 74 69 63 20 63 68 61 72 20 7a 42 75 66 5b 35 atic char zBuf[5
c3c0: 30 5d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 0];. sqlite3_
c3d0: 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 snprintf(sizeof(
c3e0: 7a 42 75 66 29 2c 20 7a 42 75 66 2c 20 22 53 51 zBuf), zBuf, "SQ
c3f0: 4c 49 54 45 5f 55 4e 4b 4e 4f 57 4e 28 25 64 29 LITE_UNKNOWN(%d)
c400: 22 2c 20 6f 72 69 67 52 63 29 3b 0a 20 20 20 20 ", origRc);.
c410: 7a 4e 61 6d 65 20 3d 20 7a 42 75 66 3b 0a 20 20 zName = zBuf;.
c420: 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e 61 6d 65 }. return zName
c430: 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a ;.}.#endif../*.*
c440: 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 * Return a stati
c450: 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 c string that de
c460: 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e 64 scribes the kind
c470: 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69 66 of error specif
c480: 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 ied in the.** ar
c490: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 gument..*/.const
c4a0: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 char *sqlite3Er
c4b0: 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 rStr(int rc){.
c4c0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 static const cha
c4d0: 72 2a 20 63 6f 6e 73 74 20 61 4d 73 67 5b 5d 20 r* const aMsg[]
c4e0: 3d 20 7b 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 = {. /* SQLIT
c4f0: 45 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 2a 2f E_OK */
c500: 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 2c "not an error",
c510: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 . /* SQLITE_E
c520: 52 52 4f 52 20 20 20 20 20 20 20 2a 2f 20 22 53 RROR */ "S
c530: 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 6f QL logic error o
c540: 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 61 r missing databa
c550: 73 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 se",. /* SQLI
c560: 54 45 5f 49 4e 54 45 52 4e 41 4c 20 20 20 20 2a TE_INTERNAL *
c570: 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 / 0,. /* SQLI
c580: 54 45 5f 50 45 52 4d 20 20 20 20 20 20 20 20 2a TE_PERM *
c590: 2f 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 73 / "access permis
c5a0: 73 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 sion denied",.
c5b0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 41 42 4f 52 /* SQLITE_ABOR
c5c0: 54 20 20 20 20 20 20 20 2a 2f 20 22 63 61 6c 6c T */ "call
c5d0: 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 71 back requested q
c5e0: 75 65 72 79 20 61 62 6f 72 74 22 2c 0a 20 20 20 uery abort",.
c5f0: 20 2f 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 /* SQLITE_BUSY
c600: 20 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 */ "datab
c610: 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0a ase is locked",.
c620: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4c 4f /* SQLITE_LO
c630: 43 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 64 61 CKED */ "da
c640: 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 20 tabase table is
c650: 6c 6f 63 6b 65 64 22 2c 0a 20 20 20 20 2f 2a 20 locked",. /*
c660: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 20 20 SQLITE_NOMEM
c670: 20 20 20 2a 2f 20 22 6f 75 74 20 6f 66 20 6d 65 */ "out of me
c680: 6d 6f 72 79 22 2c 0a 20 20 20 20 2f 2a 20 53 51 mory",. /* SQ
c690: 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 20 20 LITE_READONLY
c6a0: 20 2a 2f 20 22 61 74 74 65 6d 70 74 20 74 6f 20 */ "attempt to
c6b0: 77 72 69 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 write a readonly
c6c0: 20 64 61 74 61 62 61 73 65 22 2c 0a 20 20 20 20 database",.
c6d0: 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 /* SQLITE_INTERR
c6e0: 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 72 72 UPT */ "interr
c6f0: 75 70 74 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 upted",. /* S
c700: 51 4c 49 54 45 5f 49 4f 45 52 52 20 20 20 20 20 QLITE_IOERR
c710: 20 20 2a 2f 20 22 64 69 73 6b 20 49 2f 4f 20 65 */ "disk I/O e
c720: 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 51 rror",. /* SQ
c730: 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 20 20 20 LITE_CORRUPT
c740: 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 64 69 */ "database di
c750: 73 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 sk image is malf
c760: 6f 72 6d 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 ormed",. /* S
c770: 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 20 QLITE_NOTFOUND
c780: 20 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 6f 70 */ "unknown op
c790: 65 72 61 74 69 6f 6e 22 2c 0a 20 20 20 20 2f 2a eration",. /*
c7a0: 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 20 20 20 SQLITE_FULL
c7b0: 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 */ "database
c7c0: 20 6f 72 20 64 69 73 6b 20 69 73 20 66 75 6c 6c or disk is full
c7d0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
c7e0: 5f 43 41 4e 54 4f 50 45 4e 20 20 20 20 2a 2f 20 _CANTOPEN */
c7f0: 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 "unable to open
c800: 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 2c 0a database file",.
c810: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 /* SQLITE_PR
c820: 4f 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 6c 6f OTOCOL */ "lo
c830: 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 22 2c cking protocol",
c840: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 . /* SQLITE_E
c850: 4d 50 54 59 20 20 20 20 20 20 20 2a 2f 20 22 74 MPTY */ "t
c860: 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f able contains no
c870: 20 64 61 74 61 22 2c 0a 20 20 20 20 2f 2a 20 53 data",. /* S
c880: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 20 20 20 QLITE_SCHEMA
c890: 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 73 */ "database s
c8a0: 63 68 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 chema has change
c8b0: 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 d",. /* SQLIT
c8c0: 45 5f 54 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f E_TOOBIG */
c8d0: 20 22 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 "string or blob
c8e0: 20 74 6f 6f 20 62 69 67 22 2c 0a 20 20 20 20 2f too big",. /
c8f0: 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 * SQLITE_CONSTRA
c900: 49 4e 54 20 20 2a 2f 20 22 63 6f 6e 73 74 72 61 INT */ "constra
c910: 69 6e 74 20 66 61 69 6c 65 64 22 2c 0a 20 20 20 int failed",.
c920: 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 /* SQLITE_MISMA
c930: 54 43 48 20 20 20 20 2a 2f 20 22 64 61 74 61 74 TCH */ "datat
c940: 79 70 65 20 6d 69 73 6d 61 74 63 68 22 2c 0a 20 ype mismatch",.
c950: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 /* SQLITE_MIS
c960: 55 53 45 20 20 20 20 20 20 2a 2f 20 22 6c 69 62 USE */ "lib
c970: 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c rary routine cal
c980: 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 led out of seque
c990: 6e 63 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c nce",. /* SQL
c9a0: 49 54 45 5f 4e 4f 4c 46 53 20 20 20 20 20 20 20 ITE_NOLFS
c9b0: 2a 2f 20 22 6c 61 72 67 65 20 66 69 6c 65 20 73 */ "large file s
c9c0: 75 70 70 6f 72 74 20 69 73 20 64 69 73 61 62 6c upport is disabl
c9d0: 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ed",. /* SQLI
c9e0: 54 45 5f 41 55 54 48 20 20 20 20 20 20 20 20 2a TE_AUTH *
c9f0: 2f 20 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e / "authorization
ca00: 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 2f 2a denied",. /*
ca10: 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 20 20 SQLITE_FORMAT
ca20: 20 20 20 20 2a 2f 20 22 61 75 78 69 6c 69 61 72 */ "auxiliar
ca30: 79 20 64 61 74 61 62 61 73 65 20 66 6f 72 6d 61 y database forma
ca40: 74 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a t error",. /*
ca50: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 20 20 SQLITE_RANGE
ca60: 20 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f 72 20 */ "bind or
ca70: 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f 75 74 column index out
ca80: 20 6f 66 20 72 61 6e 67 65 22 2c 0a 20 20 20 20 of range",.
ca90: 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 /* SQLITE_NOTADB
caa0: 20 20 20 20 20 20 2a 2f 20 22 66 69 6c 65 20 69 */ "file i
cab0: 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72 20 69 s encrypted or i
cac0: 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 s not a database
cad0: 22 2c 0a 20 20 7d 3b 0a 20 20 63 6f 6e 73 74 20 ",. };. const
cae0: 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 22 75 6e char *zErr = "un
caf0: 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 0a 20 20 known error";.
cb00: 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a 20 20 switch( rc ){.
cb10: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 case SQLITE_AB
cb20: 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 7b 0a ORT_ROLLBACK: {.
cb30: 20 20 20 20 20 20 7a 45 72 72 20 3d 20 22 61 62 zErr = "ab
cb40: 6f 72 74 20 64 75 65 20 74 6f 20 52 4f 4c 4c 42 ort due to ROLLB
cb50: 41 43 4b 22 3b 0a 20 20 20 20 20 20 62 72 65 61 ACK";. brea
cb60: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 k;. }. def
cb70: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 ault: {. rc
cb80: 20 26 3d 20 30 78 66 66 3b 0a 20 20 20 20 20 20 &= 0xff;.
cb90: 69 66 28 20 41 4c 57 41 59 53 28 72 63 3e 3d 30 if( ALWAYS(rc>=0
cba0: 29 20 26 26 20 72 63 3c 41 72 72 61 79 53 69 7a ) && rc<ArraySiz
cbb0: 65 28 61 4d 73 67 29 20 26 26 20 61 4d 73 67 5b e(aMsg) && aMsg[
cbc0: 72 63 5d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 rc]!=0 ){.
cbd0: 20 20 7a 45 72 72 20 3d 20 61 4d 73 67 5b 72 63 zErr = aMsg[rc
cbe0: 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 ];. }.
cbf0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
cc00: 7d 0a 20 20 72 65 74 75 72 6e 20 7a 45 72 72 3b }. return zErr;
cc10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 .}../*.** This r
cc20: 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 outine implement
cc30: 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 63 s a busy callbac
cc40: 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 6e k that sleeps an
cc50: 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 6e d tries.** again
cc60: 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 74 until a timeout
cc70: 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 65 value is reache
cc80: 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 20 d. The timeout
cc90: 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 69 value is.** an i
cca0: 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 nteger number of
ccb0: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 61 milliseconds pa
ccc0: 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 66 ssed in as the f
ccd0: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 irst.** argument
cce0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
ccf0: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 sqliteDefaultBus
cd00: 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 64 yCallback(. void
cd10: 20 2a 70 74 72 2c 20 20 20 20 20 20 20 20 20 20 *ptr,
cd20: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 /* Database
cd30: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 connection */.
cd40: 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 int count
cd50: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
cd60: 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c er of times tabl
cd70: 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 e has been busy
cd80: 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 */.){.#if SQLITE
cd90: 5f 4f 53 5f 57 49 4e 20 7c 7c 20 48 41 56 45 5f _OS_WIN || HAVE_
cda0: 55 53 4c 45 45 50 0a 20 20 73 74 61 74 69 63 20 USLEEP. static
cdb0: 63 6f 6e 73 74 20 75 38 20 64 65 6c 61 79 73 5b const u8 delays[
cdc0: 5d 20 3d 0a 20 20 20 20 20 7b 20 31 2c 20 32 2c ] =. { 1, 2,
cdd0: 20 35 2c 20 31 30 2c 20 31 35 2c 20 32 30 2c 20 5, 10, 15, 20,
cde0: 32 35 2c 20 32 35 2c 20 20 32 35 2c 20 20 35 30 25, 25, 25, 50
cdf0: 2c 20 20 35 30 2c 20 31 30 30 20 7d 3b 0a 20 20 , 50, 100 };.
ce00: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 static const u8
ce10: 74 6f 74 61 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 totals[] =.
ce20: 7b 20 30 2c 20 31 2c 20 33 2c 20 20 38 2c 20 31 { 0, 1, 3, 8, 1
ce30: 38 2c 20 33 33 2c 20 35 33 2c 20 37 38 2c 20 31 8, 33, 53, 78, 1
ce40: 30 33 2c 20 31 32 38 2c 20 31 37 38 2c 20 32 32 03, 128, 178, 22
ce50: 38 20 7d 3b 0a 23 20 64 65 66 69 6e 65 20 4e 44 8 };.# define ND
ce60: 45 4c 41 59 20 41 72 72 61 79 53 69 7a 65 28 64 ELAY ArraySize(d
ce70: 65 6c 61 79 73 29 0a 20 20 73 71 6c 69 74 65 33 elays). sqlite3
ce80: 20 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 33 20 *db = (sqlite3
ce90: 2a 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d *)ptr;. int tim
cea0: 65 6f 75 74 20 3d 20 64 62 2d 3e 62 75 73 79 54 eout = db->busyT
ceb0: 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65 imeout;. int de
cec0: 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 61 lay, prior;.. a
ced0: 73 73 65 72 74 28 20 63 6f 75 6e 74 3e 3d 30 20 ssert( count>=0
cee0: 29 3b 0a 20 20 69 66 28 20 63 6f 75 6e 74 20 3c );. if( count <
cef0: 20 4e 44 45 4c 41 59 20 29 7b 0a 20 20 20 20 64 NDELAY ){. d
cf00: 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b 63 6f elay = delays[co
cf10: 75 6e 74 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 unt];. prior
cf20: 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 6e 74 5d 3b = totals[count];
cf30: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 . }else{. de
cf40: 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 lay = delays[NDE
cf50: 4c 41 59 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f LAY-1];. prio
cf60: 72 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 r = totals[NDELA
cf70: 59 2d 31 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f Y-1] + delay*(co
cf80: 75 6e 74 2d 28 4e 44 45 4c 41 59 2d 31 29 29 3b unt-(NDELAY-1));
cf90: 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 69 6f 72 . }. if( prior
cfa0: 20 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f + delay > timeo
cfb0: 75 74 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 ut ){. delay
cfc0: 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70 72 69 6f = timeout - prio
cfd0: 72 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 r;. if( delay
cfe0: 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a <=0 ) return 0;.
cff0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 }. sqlite3OsS
d000: 6c 65 65 70 28 64 62 2d 3e 70 56 66 73 2c 20 64 leep(db->pVfs, d
d010: 65 6c 61 79 2a 31 30 30 30 29 3b 0a 20 20 72 65 elay*1000);. re
d020: 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 turn 1;.#else.
d030: 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 28 73 sqlite3 *db = (s
d040: 71 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a 20 20 qlite3 *)ptr;.
d050: 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 28 int timeout = ((
d060: 73 71 6c 69 74 65 33 20 2a 29 70 74 72 29 2d 3e sqlite3 *)ptr)->
d070: 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 busyTimeout;. i
d080: 66 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 f( (count+1)*100
d090: 30 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 0 > timeout ){.
d0a0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d return 0;. }
d0b0: 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 . sqlite3OsSlee
d0c0: 70 28 64 62 2d 3e 70 56 66 73 2c 20 31 30 30 30 p(db->pVfs, 1000
d0d0: 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 000);. return 1
d0e0: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
d0f0: 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 67 69 76 * Invoke the giv
d100: 65 6e 20 62 75 73 79 20 68 61 6e 64 6c 65 72 2e en busy handler.
d110: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
d120: 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 ine is called wh
d130: 65 6e 20 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 en an operation
d140: 66 61 69 6c 65 64 20 77 69 74 68 20 61 20 6c 6f failed with a lo
d150: 63 6b 2e 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 ck..** If this r
d160: 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 6e outine returns n
d170: 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 on-zero, the loc
d180: 6b 20 69 73 20 72 65 74 72 69 65 64 2e 20 20 49 k is retried. I
d190: 66 20 69 74 0a 2a 2a 20 72 65 74 75 72 6e 73 20 f it.** returns
d1a0: 30 2c 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 0, the operation
d1b0: 20 61 62 6f 72 74 73 20 77 69 74 68 20 61 6e 20 aborts with an
d1c0: 53 51 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f SQLITE_BUSY erro
d1d0: 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 r..*/.int sqlite
d1e0: 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 3InvokeBusyHandl
d1f0: 65 72 28 42 75 73 79 48 61 6e 64 6c 65 72 20 2a er(BusyHandler *
d200: 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 p){. int rc;.
d210: 69 66 28 20 4e 45 56 45 52 28 70 3d 3d 30 29 20 if( NEVER(p==0)
d220: 7c 7c 20 70 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c || p->xFunc==0 |
d230: 7c 20 70 2d 3e 6e 42 75 73 79 3c 30 20 29 20 72 | p->nBusy<0 ) r
d240: 65 74 75 72 6e 20 30 3b 0a 20 20 72 63 20 3d 20 eturn 0;. rc =
d250: 70 2d 3e 78 46 75 6e 63 28 70 2d 3e 70 41 72 67 p->xFunc(p->pArg
d260: 2c 20 70 2d 3e 6e 42 75 73 79 29 3b 0a 20 20 69 , p->nBusy);. i
d270: 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 f( rc==0 ){.
d280: 70 2d 3e 6e 42 75 73 79 20 3d 20 2d 31 3b 0a 20 p->nBusy = -1;.
d290: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e }else{. p->n
d2a0: 42 75 73 79 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 Busy++;. }. re
d2b0: 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a turn rc; .}../*.
d2c0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
d2d0: 73 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 sets the busy ca
d2e0: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 llback for an Sq
d2f0: 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f lite database to
d300: 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 the.** given ca
d310: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 llback function
d320: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 with the given a
d330: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 rgument..*/.int
d340: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e sqlite3_busy_han
d350: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 20 dler(. sqlite3
d360: 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 *db,. int (*xBu
d370: 73 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a sy)(void*,int),.
d380: 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a void *pArg.){.
d390: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
d3a0: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
d3b0: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
d3c0: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
d3d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
d3e0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
d3f0: 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
d400: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
d410: 65 78 29 3b 0a 20 20 64 62 2d 3e 62 75 73 79 48 ex);. db->busyH
d420: 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20 3d 20 78 andler.xFunc = x
d430: 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62 75 73 79 Busy;. db->busy
d440: 48 61 6e 64 6c 65 72 2e 70 41 72 67 20 3d 20 70 Handler.pArg = p
d450: 41 72 67 3b 0a 20 20 64 62 2d 3e 62 75 73 79 48 Arg;. db->busyH
d460: 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d 20 30 andler.nBusy = 0
d470: 3b 0a 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 ;. db->busyTime
d480: 6f 75 74 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 out = 0;. sqlit
d490: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
d4a0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
d4b0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
d4c0: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
d4d0: 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 _OMIT_PROGRESS_C
d4e0: 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 54 68 ALLBACK./*.** Th
d4f0: 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 is routine sets
d500: 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c the progress cal
d510: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c lback for an Sql
d520: 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 ite database to
d530: 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c the.** given cal
d540: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 lback function w
d550: 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 ith the given ar
d560: 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 6f 67 gument. The prog
d570: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 77 69 ress callback wi
d580: 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 ll.** be invoked
d590: 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 63 6f every nOps opco
d5a0: 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c des..*/.void sql
d5b0: 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 ite3_progress_ha
d5c0: 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 33 ndler(. sqlite3
d5d0: 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e 4f 70 *db, . int nOp
d5e0: 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 s,. int (*xProg
d5f0: 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 0a 20 ress)(void*), .
d600: 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 23 void *pArg.){.#
d610: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
d620: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
d630: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
d640: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
d650: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 . (void)SQLIT
d660: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
d670: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 23 return;. }.#
d680: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
d690: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
d6a0: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 6e 4f mutex);. if( nO
d6b0: 70 73 3e 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e ps>0 ){. db->
d6c0: 78 50 72 6f 67 72 65 73 73 20 3d 20 78 50 72 6f xProgress = xPro
d6d0: 67 72 65 73 73 3b 0a 20 20 20 20 64 62 2d 3e 6e gress;. db->n
d6e0: 50 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 28 75 ProgressOps = (u
d6f0: 6e 73 69 67 6e 65 64 29 6e 4f 70 73 3b 0a 20 20 nsigned)nOps;.
d700: 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 db->pProgressA
d710: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 6c rg = pArg;. }el
d720: 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f se{. db->xPro
d730: 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 64 gress = 0;. d
d740: 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 b->nProgressOps
d750: 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 = 0;. db->pPr
d760: 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b 0a 20 ogressArg = 0;.
d770: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
d780: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
d790: 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a ex);.}.#endif...
d7a0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 /*.** This routi
d7b0: 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 65 ne installs a de
d7c0: 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 6c fault busy handl
d7d0: 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66 6f er that waits fo
d7e0: 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 r the.** specifi
d7f0: 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c ed number of mil
d800: 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 liseconds before
d810: 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a 2f returning 0..*/
d820: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 75 73 .int sqlite3_bus
d830: 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 65 y_timeout(sqlite
d840: 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b 0a 3 *db, int ms){.
d850: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
d860: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
d870: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
d880: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
d890: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
d8a0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
d8b0: 69 66 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b if. if( ms>0 ){
d8c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62 75 73 . sqlite3_bus
d8d0: 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 73 71 y_handler(db, sq
d8e0: 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 79 43 liteDefaultBusyC
d8f0: 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29 allback, (void*)
d900: 64 62 29 3b 0a 20 20 20 20 64 62 2d 3e 62 75 73 db);. db->bus
d910: 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 3b 0a 20 yTimeout = ms;.
d920: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
d930: 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 te3_busy_handler
d940: 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a (db, 0, 0);. }.
d950: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d960: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 OK;.}../*.** Cau
d970: 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f se any pending o
d980: 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 peration to stop
d990: 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 at its earliest
d9a0: 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f opportunity..*/
d9b0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e .void sqlite3_in
d9c0: 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 33 20 terrupt(sqlite3
d9d0: 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *db){.#ifdef SQL
d9e0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
d9f0: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
da00: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
da10: 28 64 62 29 20 26 26 20 28 64 62 3d 3d 30 20 7c (db) && (db==0 |
da20: 7c 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c | db->magic!=SQL
da30: 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 ITE_MAGIC_ZOMBIE
da40: 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 ) ){. (void)S
da50: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
da60: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 T;. return;.
da70: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 64 62 2d 3e }.#endif. db->
da80: 75 31 2e 69 73 49 6e 74 65 72 72 75 70 74 65 64 u1.isInterrupted
da90: 20 3d 20 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 = 1;.}.../*.**
daa0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
dab0: 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d exactly the sam
dac0: 65 20 61 73 20 73 71 6c 69 74 65 33 5f 63 72 65 e as sqlite3_cre
dad0: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 ate_function(),
dae0: 65 78 63 65 70 74 0a 2a 2a 20 74 68 61 74 20 69 except.** that i
daf0: 74 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f t is designed to
db00: 20 62 65 20 63 61 6c 6c 65 64 20 62 79 20 69 6e be called by in
db10: 74 65 72 6e 61 6c 20 63 6f 64 65 2e 20 54 68 65 ternal code. The
db20: 20 64 69 66 66 65 72 65 6e 63 65 20 69 73 0a 2a difference is.*
db30: 2a 20 74 68 61 74 20 69 66 20 61 20 6d 61 6c 6c * that if a mall
db40: 6f 63 28 29 20 66 61 69 6c 73 20 69 6e 20 73 71 oc() fails in sq
db50: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e lite3_create_fun
db60: 63 74 69 6f 6e 28 29 2c 20 61 6e 20 65 72 72 6f ction(), an erro
db70: 72 20 63 6f 64 65 0a 2a 2a 20 69 73 20 72 65 74 r code.** is ret
db80: 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 6d 61 urned and the ma
db90: 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 llocFailed flag
dba0: 63 6c 65 61 72 65 64 2e 20 0a 2a 2f 0a 69 6e 74 cleared. .*/.int
dbb0: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
dbc0: 6e 63 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 nc(. sqlite3 *d
dbd0: 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 b,. const char
dbe0: 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a *zFunctionName,.
dbf0: 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e int nArg,. in
dc00: 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 t enc,. void *p
dc10: 55 73 65 72 44 61 74 61 2c 0a 20 20 76 6f 69 64 UserData,. void
dc20: 20 28 2a 78 53 46 75 6e 63 29 28 73 71 6c 69 74 (*xSFunc)(sqlit
dc30: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
dc40: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
dc50: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 ),. void (*xSte
dc60: 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 p)(sqlite3_conte
dc70: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
dc80: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 value **),. voi
dc90: 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 d (*xFinal)(sqli
dca0: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 te3_context*),.
dcb0: 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 FuncDestructor
dcc0: 2a 70 44 65 73 74 72 75 63 74 6f 72 0a 29 7b 0a *pDestructor.){.
dcd0: 20 20 46 75 6e 63 44 65 66 20 2a 70 3b 0a 20 20 FuncDef *p;.
dce0: 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 20 69 6e 74 int nName;. int
dcf0: 20 65 78 74 72 61 46 6c 61 67 73 3b 0a 0a 20 20 extraFlags;..
dd00: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
dd10: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d mutex_held(db->m
dd20: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 7a utex) );. if( z
dd30: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20 FunctionName==0
dd40: 7c 7c 0a 20 20 20 20 20 20 28 78 53 46 75 6e 63 ||. (xSFunc
dd50: 20 26 26 20 28 78 46 69 6e 61 6c 20 7c 7c 20 78 && (xFinal || x
dd60: 53 74 65 70 29 29 20 7c 7c 20 0a 20 20 20 20 20 Step)) || .
dd70: 20 28 21 78 53 46 75 6e 63 20 26 26 20 28 78 46 (!xSFunc && (xF
dd80: 69 6e 61 6c 20 26 26 20 21 78 53 74 65 70 29 29 inal && !xStep))
dd90: 20 7c 7c 0a 20 20 20 20 20 20 28 21 78 53 46 75 ||. (!xSFu
dda0: 6e 63 20 26 26 20 28 21 78 46 69 6e 61 6c 20 26 nc && (!xFinal &
ddb0: 26 20 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 & xStep)) ||.
ddc0: 20 20 20 28 6e 41 72 67 3c 2d 31 20 7c 7c 20 6e (nArg<-1 || n
ddd0: 41 72 67 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 46 Arg>SQLITE_MAX_F
dde0: 55 4e 43 54 49 4f 4e 5f 41 52 47 29 20 7c 7c 0a UNCTION_ARG) ||.
ddf0: 20 20 20 20 20 20 28 32 35 35 3c 28 6e 4e 61 6d (255<(nNam
de00: 65 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 e = sqlite3Strle
de10: 6e 33 30 28 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 n30( zFunctionNa
de20: 6d 65 29 29 29 20 29 7b 0a 20 20 20 20 72 65 74 me))) ){. ret
de30: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
de40: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 61 E_BKPT;. }.. a
de50: 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 46 55 ssert( SQLITE_FU
de60: 4e 43 5f 43 4f 4e 53 54 41 4e 54 3d 3d 53 51 4c NC_CONSTANT==SQL
de70: 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 ITE_DETERMINISTI
de80: 43 20 29 3b 0a 20 20 65 78 74 72 61 46 6c 61 67 C );. extraFlag
de90: 73 20 3d 20 65 6e 63 20 26 20 20 53 51 4c 49 54 s = enc & SQLIT
dea0: 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 43 3b E_DETERMINISTIC;
deb0: 0a 20 20 65 6e 63 20 26 3d 20 28 53 51 4c 49 54 . enc &= (SQLIT
dec0: 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 7c 53 E_FUNC_ENCMASK|S
ded0: 51 4c 49 54 45 5f 41 4e 59 29 3b 0a 20 20 0a 23 QLITE_ANY);. .#
dee0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
def0: 49 54 5f 55 54 46 31 36 0a 20 20 2f 2a 20 49 66 IT_UTF16. /* If
df00: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 SQLITE_UTF16 is
df10: 20 73 70 65 63 69 66 69 65 64 20 61 73 20 74 68 specified as th
df20: 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c e encoding type,
df30: 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a transform this.
df40: 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53 ** to one of S
df50: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 QLITE_UTF16LE or
df60: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 SQLITE_UTF16BE
df70: 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53 using the. ** S
df80: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
df90: 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f E macro. SQLITE_
dfa0: 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75 73 65 UTF16 is not use
dfb0: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 d internally..
dfc0: 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c 49 54 **. ** If SQLIT
dfd0: 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69 66 69 E_ANY is specifi
dfe0: 65 64 2c 20 61 64 64 20 74 68 72 65 65 20 76 65 ed, add three ve
dff0: 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 75 rsions of the fu
e000: 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 74 nction. ** to t
e010: 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 20 he hash table..
e020: 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 */. if( enc==S
e030: 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 QLITE_UTF16 ){.
e040: 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f enc = SQLITE_
e050: 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d UTF16NATIVE;. }
e060: 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d 53 51 else if( enc==SQ
e070: 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20 20 20 LITE_ANY ){.
e080: 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63 20 3d int rc;. rc =
e090: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
e0a0: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e nc(db, zFunction
e0b0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
e0c0: 54 45 5f 55 54 46 38 7c 65 78 74 72 61 46 6c 61 TE_UTF8|extraFla
e0d0: 67 73 2c 0a 20 20 20 20 20 20 20 20 20 70 55 73 gs,. pUs
e0e0: 65 72 44 61 74 61 2c 20 78 53 46 75 6e 63 2c 20 erData, xSFunc,
e0f0: 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 70 xStep, xFinal, p
e100: 44 65 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 Destructor);.
e110: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
e120: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d OK ){. rc =
e130: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
e140: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e nc(db, zFunction
e150: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
e160: 54 45 5f 55 54 46 31 36 4c 45 7c 65 78 74 72 61 TE_UTF16LE|extra
e170: 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 20 20 Flags,.
e180: 20 70 55 73 65 72 44 61 74 61 2c 20 78 53 46 75 pUserData, xSFu
e190: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 nc, xStep, xFina
e1a0: 6c 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b l, pDestructor);
e1b0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
e1c0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
e1d0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
e1e0: 0a 20 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d . }. enc =
e1f0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b SQLITE_UTF16BE;
e200: 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 . }.#else. enc
e210: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a = SQLITE_UTF8;.
e220: 23 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 #endif. . /* C
e230: 68 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 heck if an exist
e240: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 ing function is
e250: 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e being overridden
e260: 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 or deleted. If
e270: 73 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 so,. ** and the
e280: 72 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d re are active VM
e290: 73 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 s, then return S
e2a0: 51 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 QLITE_BUSY. If a
e2b0: 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 function. ** i
e2c0: 73 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 s being overridd
e2d0: 65 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 en/deleted but t
e2e0: 68 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 here are no acti
e2f0: 76 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 ve VMs, allow th
e300: 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e e. ** operation
e310: 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 to continue but
e320: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 invalidate all
e330: 70 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 precompiled stat
e340: 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 ements.. */. p
e350: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
e360: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
e370: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 tionName, nArg,
e380: 28 75 38 29 65 6e 63 2c 20 30 29 3b 0a 20 20 69 (u8)enc, 0);. i
e390: 66 28 20 70 20 26 26 20 28 70 2d 3e 66 75 6e 63 f( p && (p->func
e3a0: 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 46 Flags & SQLITE_F
e3b0: 55 4e 43 5f 45 4e 43 4d 41 53 4b 29 3d 3d 65 6e UNC_ENCMASK)==en
e3c0: 63 20 26 26 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 c && p->nArg==nA
e3d0: 72 67 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 rg ){. if( db
e3e0: 2d 3e 6e 56 64 62 65 41 63 74 69 76 65 20 29 7b ->nVdbeActive ){
e3f0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 . sqlite3Er
e400: 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 53 rorWithMsg(db, S
e410: 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 QLITE_BUSY, .
e420: 20 20 20 20 20 22 75 6e 61 62 6c 65 20 74 6f 20 "unable to
e430: 64 65 6c 65 74 65 2f 6d 6f 64 69 66 79 20 75 73 delete/modify us
e440: 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 75 65 20 er-function due
e450: 74 6f 20 61 63 74 69 76 65 20 73 74 61 74 65 6d to active statem
e460: 65 6e 74 73 22 29 3b 0a 20 20 20 20 20 20 61 73 ents");. as
e470: 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
e480: 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 20 20 20 cFailed );.
e490: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
e4a0: 55 53 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a USY;. }else{.
e4b0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 sqlite3Exp
e4c0: 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
e4d0: 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 7d ments(db);. }
e4e0: 0a 20 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69 . }.. p = sqli
e4f0: 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 te3FindFunction(
e500: 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d db, zFunctionNam
e510: 65 2c 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 e, nArg, (u8)enc
e520: 2c 20 31 29 3b 0a 20 20 61 73 73 65 72 74 28 70 , 1);. assert(p
e530: 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 || db->mallocFa
e540: 69 6c 65 64 29 3b 0a 20 20 69 66 28 20 21 70 20 iled);. if( !p
e550: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
e560: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
e570: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 61 6e . }.. /* If an
e580: 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 20 6f older version o
e590: 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 77 f the function w
e5a0: 69 74 68 20 61 20 63 6f 6e 66 69 67 75 72 65 64 ith a configured
e5b0: 20 64 65 73 74 72 75 63 74 6f 72 20 69 73 0a 20 destructor is.
e5c0: 20 2a 2a 20 62 65 69 6e 67 20 72 65 70 6c 61 63 ** being replac
e5d0: 65 64 20 69 6e 76 6f 6b 65 20 74 68 65 20 64 65 ed invoke the de
e5e0: 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f structor functio
e5f0: 6e 20 68 65 72 65 2e 20 2a 2f 0a 20 20 66 75 6e n here. */. fun
e600: 63 74 69 6f 6e 44 65 73 74 72 6f 79 28 64 62 2c ctionDestroy(db,
e610: 20 70 29 3b 0a 0a 20 20 69 66 28 20 70 44 65 73 p);.. if( pDes
e620: 74 72 75 63 74 6f 72 20 29 7b 0a 20 20 20 20 70 tructor ){. p
e630: 44 65 73 74 72 75 63 74 6f 72 2d 3e 6e 52 65 66 Destructor->nRef
e640: 2b 2b 3b 0a 20 20 7d 0a 20 20 70 2d 3e 75 2e 70 ++;. }. p->u.p
e650: 44 65 73 74 72 75 63 74 6f 72 20 3d 20 70 44 65 Destructor = pDe
e660: 73 74 72 75 63 74 6f 72 3b 0a 20 20 70 2d 3e 66 structor;. p->f
e670: 75 6e 63 46 6c 61 67 73 20 3d 20 28 70 2d 3e 66 uncFlags = (p->f
e680: 75 6e 63 46 6c 61 67 73 20 26 20 53 51 4c 49 54 uncFlags & SQLIT
e690: 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 29 20 E_FUNC_ENCMASK)
e6a0: 7c 20 65 78 74 72 61 46 6c 61 67 73 3b 0a 20 20 | extraFlags;.
e6b0: 74 65 73 74 63 61 73 65 28 20 70 2d 3e 66 75 6e testcase( p->fun
e6c0: 63 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f cFlags & SQLITE_
e6d0: 44 45 54 45 52 4d 49 4e 49 53 54 49 43 20 29 3b DETERMINISTIC );
e6e0: 0a 20 20 70 2d 3e 78 53 46 75 6e 63 20 3d 20 78 . p->xSFunc = x
e6f0: 53 46 75 6e 63 20 3f 20 78 53 46 75 6e 63 20 3a SFunc ? xSFunc :
e700: 20 78 53 74 65 70 3b 0a 20 20 70 2d 3e 78 46 69 xStep;. p->xFi
e710: 6e 61 6c 69 7a 65 20 3d 20 78 46 69 6e 61 6c 3b nalize = xFinal;
e720: 0a 20 20 70 2d 3e 70 55 73 65 72 44 61 74 61 20 . p->pUserData
e730: 3d 20 70 55 73 65 72 44 61 74 61 3b 0a 20 20 70 = pUserData;. p
e740: 2d 3e 6e 41 72 67 20 3d 20 28 75 31 36 29 6e 41 ->nArg = (u16)nA
e750: 72 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c rg;. return SQL
e760: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
e770: 20 43 72 65 61 74 65 20 6e 65 77 20 75 73 65 72 Create new user
e780: 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 functions..*/.i
e790: 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 nt sqlite3_creat
e7a0: 65 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 e_function(. sq
e7b0: 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e lite3 *db,. con
e7c0: 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 2c 0a st char *zFunc,.
e7d0: 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e int nArg,. in
e7e0: 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 t enc,. void *p
e7f0: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 46 75 6e ,. void (*xSFun
e800: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 c)(sqlite3_conte
e810: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
e820: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 value **),. voi
e830: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
e840: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
e850: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
e860: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e ),. void (*xFin
e870: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 al)(sqlite3_cont
e880: 65 78 74 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 ext*).){. retur
e890: 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 n sqlite3_create
e8a0: 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 64 62 2c _function_v2(db,
e8b0: 20 7a 46 75 6e 63 2c 20 6e 41 72 67 2c 20 65 6e zFunc, nArg, en
e8c0: 63 2c 20 70 2c 20 78 53 46 75 6e 63 2c 20 78 53 c, p, xSFunc, xS
e8d0: 74 65 70 2c 0a 20 20 20 20 20 20 20 20 20 20 20 tep,.
e8e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e8f0: 20 20 20 20 20 20 20 20 20 78 46 69 6e 61 6c 2c xFinal,
e900: 20 30 29 3b 0a 7d 0a 0a 69 6e 74 20 73 71 6c 69 0);.}..int sqli
e910: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
e920: 69 6f 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 ion_v2(. sqlite
e930: 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3 *db,. const c
e940: 68 61 72 20 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e har *zFunc,. in
e950: 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e t nArg,. int en
e960: 63 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 c,. void *p,.
e970: 76 6f 69 64 20 28 2a 78 53 46 75 6e 63 29 28 73 void (*xSFunc)(s
e980: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
e990: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
e9a0: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
e9b0: 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 xStep)(sqlite3_c
e9c0: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
e9d0: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
e9e0: 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 void (*xFinal)(
e9f0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
ea00: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 73 ),. void (*xDes
ea10: 74 72 6f 79 29 28 76 6f 69 64 20 2a 29 0a 29 7b troy)(void *).){
ea20: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
ea30: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 46 75 6e 63 TE_ERROR;. Func
ea40: 44 65 73 74 72 75 63 74 6f 72 20 2a 70 41 72 67 Destructor *pArg
ea50: 20 3d 20 30 3b 0a 0a 23 69 66 64 65 66 20 53 51 = 0;..#ifdef SQ
ea60: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
ea70: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
ea80: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
ea90: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
eaa0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
eab0: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 E_BKPT;. }.#end
eac0: 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
ead0: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
eae0: 65 78 29 3b 0a 20 20 69 66 28 20 78 44 65 73 74 ex);. if( xDest
eaf0: 72 6f 79 20 29 7b 0a 20 20 20 20 70 41 72 67 20 roy ){. pArg
eb00: 3d 20 28 46 75 6e 63 44 65 73 74 72 75 63 74 6f = (FuncDestructo
eb10: 72 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c r *)sqlite3DbMal
eb20: 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 locZero(db, size
eb30: 6f 66 28 46 75 6e 63 44 65 73 74 72 75 63 74 6f of(FuncDestructo
eb40: 72 29 29 3b 0a 20 20 20 20 69 66 28 20 21 70 41 r));. if( !pA
eb50: 72 67 20 29 7b 0a 20 20 20 20 20 20 78 44 65 73 rg ){. xDes
eb60: 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 20 20 67 troy(p);. g
eb70: 6f 74 6f 20 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 oto out;. }.
eb80: 20 20 20 70 41 72 67 2d 3e 78 44 65 73 74 72 6f pArg->xDestro
eb90: 79 20 3d 20 78 44 65 73 74 72 6f 79 3b 0a 20 20 y = xDestroy;.
eba0: 20 20 70 41 72 67 2d 3e 70 55 73 65 72 44 61 74 pArg->pUserDat
ebb0: 61 20 3d 20 70 3b 0a 20 20 7d 0a 20 20 72 63 20 a = p;. }. rc
ebc0: 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 = sqlite3CreateF
ebd0: 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 2c 20 6e unc(db, zFunc, n
ebe0: 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 53 46 Arg, enc, p, xSF
ebf0: 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e unc, xStep, xFin
ec00: 61 6c 2c 20 70 41 72 67 29 3b 0a 20 20 69 66 28 al, pArg);. if(
ec10: 20 70 41 72 67 20 26 26 20 70 41 72 67 2d 3e 6e pArg && pArg->n
ec20: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 Ref==0 ){. as
ec30: 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
ec40: 5f 4f 4b 20 29 3b 0a 20 20 20 20 78 44 65 73 74 _OK );. xDest
ec50: 72 6f 79 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 roy(p);. sqli
ec60: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 41 te3DbFree(db, pA
ec70: 72 67 29 3b 0a 20 20 7d 0a 0a 20 6f 75 74 3a 0a rg);. }.. out:.
ec80: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 rc = sqlite3Ap
ec90: 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 iExit(db, rc);.
eca0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
ecb0: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
ecc0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
ecd0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
ece0: 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 OMIT_UTF16.int s
ecf0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 qlite3_create_fu
ed00: 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 nction16(. sqli
ed10: 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 te3 *db,. const
ed20: 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 6f 6e void *zFunction
ed30: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Name,. int nArg
ed40: 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 52 65 70 ,. int eTextRep
ed50: 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 ,. void *p,. v
ed60: 6f 69 64 20 28 2a 78 53 46 75 6e 63 29 28 73 71 oid (*xSFunc)(sq
ed70: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
ed80: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
ed90: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 **),. void (*xS
eda0: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e tep)(sqlite3_con
edb0: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
edc0: 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 3_value**),. vo
edd0: 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c id (*xFinal)(sql
ede0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 ite3_context*).)
edf0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 {. int rc;. ch
ee00: 61 72 20 2a 7a 46 75 6e 63 38 3b 0a 0a 23 69 66 ar *zFunc8;..#if
ee10: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
ee20: 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
ee30: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
ee40: 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 7a CheckOk(db) || z
ee50: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d 30 20 FunctionName==0
ee60: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
ee70: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e MISUSE_BKPT;.#en
ee80: 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
ee90: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
eea0: 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 tex);. assert(
eeb0: 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
eec0: 64 20 29 3b 0a 20 20 7a 46 75 6e 63 38 20 3d 20 d );. zFunc8 =
eed0: 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 sqlite3Utf16to8(
eee0: 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d db, zFunctionNam
eef0: 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 e, -1, SQLITE_UT
ef00: 46 31 36 4e 41 54 49 56 45 29 3b 0a 20 20 72 63 F16NATIVE);. rc
ef10: 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 = sqlite3Create
ef20: 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 38 2c Func(db, zFunc8,
ef30: 20 6e 41 72 67 2c 20 65 54 65 78 74 52 65 70 2c nArg, eTextRep,
ef40: 20 70 2c 20 78 53 46 75 6e 63 2c 78 53 74 65 70 p, xSFunc,xStep
ef50: 2c 78 46 69 6e 61 6c 2c 30 29 3b 0a 20 20 73 71 ,xFinal,0);. sq
ef60: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
ef70: 7a 46 75 6e 63 38 29 3b 0a 20 20 72 63 20 3d 20 zFunc8);. rc =
ef80: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
ef90: 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 b, rc);. sqlite
efa0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
efb0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
efc0: 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a rn rc;.}.#endif.
efd0: 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6c 61 72 65 20 ../*.** Declare
efe0: 74 68 61 74 20 61 20 66 75 6e 63 74 69 6f 6e 20 that a function
eff0: 68 61 73 20 62 65 65 6e 20 6f 76 65 72 6c 6f 61 has been overloa
f000: 64 65 64 20 62 79 20 61 20 76 69 72 74 75 61 6c ded by a virtual
f010: 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 table..**.** If
f020: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 61 6c the function al
f030: 72 65 61 64 79 20 65 78 69 73 74 73 20 61 73 20 ready exists as
f040: 61 20 72 65 67 75 6c 61 72 20 67 6c 6f 62 61 6c a regular global
f050: 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 6e 0a function, then.
f060: 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ** this routine
f070: 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 20 49 66 20 is a no-op. If
f080: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 the function doe
f090: 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 74 68 65 s not exist, the
f0a0: 6e 20 63 72 65 61 74 65 0a 2a 2a 20 61 20 6e 65 n create.** a ne
f0b0: 77 20 6f 6e 65 20 74 68 61 74 20 61 6c 77 61 79 w one that alway
f0c0: 73 20 74 68 72 6f 77 73 20 61 20 72 75 6e 2d 74 s throws a run-t
f0d0: 69 6d 65 20 65 72 72 6f 72 2e 20 20 0a 2a 2a 0a ime error. .**.
f0e0: 2a 2a 20 57 68 65 6e 20 76 69 72 74 75 61 6c 20 ** When virtual
f0f0: 74 61 62 6c 65 73 20 69 6e 74 65 6e 64 20 74 6f tables intend to
f100: 20 70 72 6f 76 69 64 65 20 61 6e 20 6f 76 65 72 provide an over
f110: 6c 6f 61 64 65 64 20 66 75 6e 63 74 69 6f 6e 2c loaded function,
f120: 20 74 68 65 79 0a 2a 2a 20 73 68 6f 75 6c 64 20 they.** should
f130: 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e call this routin
f140: 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 e to make sure t
f150: 68 65 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 he global functi
f160: 6f 6e 20 65 78 69 73 74 73 2e 0a 2a 2a 20 41 20 on exists..** A
f170: 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 6f 6e 20 global function
f180: 6d 75 73 74 20 65 78 69 73 74 20 69 6e 20 6f 72 must exist in or
f190: 64 65 72 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 der for name res
f1a0: 6f 6c 75 74 69 6f 6e 20 74 6f 20 77 6f 72 6b 0a olution to work.
f1b0: 2a 2a 20 70 72 6f 70 65 72 6c 79 2e 0a 2a 2f 0a ** properly..*/.
f1c0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 76 65 72 int sqlite3_over
f1d0: 6c 6f 61 64 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 load_function(.
f1e0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 sqlite3 *db,.
f1f0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d const char *zNam
f200: 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 0a 29 7b e,. int nArg.){
f210: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
f220: 54 45 5f 4f 4b 3b 0a 0a 23 69 66 64 65 66 20 53 TE_OK;..#ifdef S
f230: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
f240: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
f250: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
f260: 4f 6b 28 64 62 29 20 7c 7c 20 7a 4e 61 6d 65 3d Ok(db) || zName=
f270: 3d 30 20 7c 7c 20 6e 41 72 67 3c 2d 32 20 29 7b =0 || nArg<-2 ){
f280: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
f290: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
f2a0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c }.#endif. sql
f2b0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
f2c0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 (db->mutex);. i
f2d0: 66 28 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 f( sqlite3FindFu
f2e0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 nction(db, zName
f2f0: 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 , nArg, SQLITE_U
f300: 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 TF8, 0)==0 ){.
f310: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 rc = sqlite3Cr
f320: 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 4e 61 eateFunc(db, zNa
f330: 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 me, nArg, SQLITE
f340: 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 20 _UTF8,.
f350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f360: 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 76 61 0, sqlite3Inva
f370: 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 2c 20 lidFunction, 0,
f380: 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 63 20 0, 0);. }. rc
f390: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
f3a0: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
f3b0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
f3c0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
f3d0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e turn rc;.}..#ifn
f3e0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
f3f0: 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 69 TRACE./*.** Regi
f400: 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75 6e ster a trace fun
f410: 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 ction. The pArg
f420: 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f from the previo
f430: 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 usly registered
f440: 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 trace.** is retu
f450: 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 rned. .**.** A
f460: 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 74 NULL trace funct
f470: 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e ion means that n
f480: 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 65 o tracing is exe
f490: 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 cutes. A non-NU
f4a0: 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 61 LL.** trace is a
f4b0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 pointer to a fu
f4c0: 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 nction that is i
f4d0: 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 74 nvoked at the st
f4e0: 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 53 art of each.** S
f4f0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f QL statement..*/
f500: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
f510: 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a OMIT_DEPRECATED.
f520: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72 void *sqlite3_tr
f530: 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c ace(sqlite3 *db,
f540: 20 76 6f 69 64 28 2a 78 54 72 61 63 65 29 28 76 void(*xTrace)(v
f550: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
f560: 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a ), void *pArg){.
f570: 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a 0a 23 void *pOld;..#
f580: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
f590: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
f5a0: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
f5b0: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
f5c0: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 . (void)SQLIT
f5d0: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
f5e0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d return 0;. }
f5f0: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
f600: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
f610: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c 64 ->mutex);. pOld
f620: 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 = db->pTraceArg
f630: 3b 0a 20 20 64 62 2d 3e 6d 54 72 61 63 65 20 3d ;. db->mTrace =
f640: 20 78 54 72 61 63 65 20 3f 20 53 51 4c 49 54 45 xTrace ? SQLITE
f650: 5f 54 52 41 43 45 5f 4c 45 47 41 43 59 20 3a 20 _TRACE_LEGACY :
f660: 30 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 20 0;. db->xTrace
f670: 3d 20 28 69 6e 74 28 2a 29 28 75 33 32 2c 76 6f = (int(*)(u32,vo
f680: 69 64 2a 2c 76 6f 69 64 2a 2c 76 6f 69 64 2a 29 id*,void*,void*)
f690: 29 78 54 72 61 63 65 3b 0a 20 20 64 62 2d 3e 70 )xTrace;. db->p
f6a0: 54 72 61 63 65 41 72 67 20 3d 20 70 41 72 67 3b TraceArg = pArg;
f6b0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
f6c0: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
f6d0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 );. return pOld
f6e0: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
f6f0: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
f700: 41 54 45 44 20 2a 2f 0a 0a 2f 2a 20 52 65 67 69 ATED */../* Regi
f710: 73 74 65 72 20 61 20 74 72 61 63 65 20 63 61 6c ster a trace cal
f720: 6c 62 61 63 6b 20 75 73 69 6e 67 20 74 68 65 20 lback using the
f730: 76 65 72 73 69 6f 6e 2d 32 20 69 6e 74 65 72 66 version-2 interf
f740: 61 63 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ace..*/.int sqli
f750: 74 65 33 5f 74 72 61 63 65 5f 76 32 28 0a 20 20 te3_trace_v2(.
f760: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
f770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f780: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
f790: 61 63 65 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 ace this connect
f7a0: 69 6f 6e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 ion */. unsigne
f7b0: 64 20 6d 54 72 61 63 65 2c 20 20 20 20 20 20 20 d mTrace,
f7c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f7d0: 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 65 /* Mask of e
f7e0: 76 65 6e 74 73 20 74 6f 20 62 65 20 74 72 61 63 vents to be trac
f7f0: 65 64 20 2a 2f 0a 20 20 69 6e 74 28 2a 78 54 72 ed */. int(*xTr
f800: 61 63 65 29 28 75 6e 73 69 67 6e 65 64 2c 76 6f ace)(unsigned,vo
f810: 69 64 2a 2c 76 6f 69 64 2a 2c 76 6f 69 64 2a 29 id*,void*,void*)
f820: 2c 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 74 , /* Callback t
f830: 6f 20 69 6e 76 6f 6b 65 20 2a 2f 0a 20 20 76 6f o invoke */. vo
f840: 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 id *pArg
f850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f860: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 /* Cont
f870: 65 78 74 20 2a 2f 0a 29 7b 0a 23 69 66 64 65 66 ext */.){.#ifdef
f880: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
f890: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
f8a0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
f8b0: 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
f8c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
f8d0: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 SUSE_BKPT;. }.#
f8e0: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
f8f0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
f900: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 6d 54 mutex);. if( mT
f910: 72 61 63 65 3d 3d 30 20 29 20 78 54 72 61 63 65 race==0 ) xTrace
f920: 20 3d 20 30 3b 0a 20 20 69 66 28 20 78 54 72 61 = 0;. if( xTra
f930: 63 65 3d 3d 30 20 29 20 6d 54 72 61 63 65 20 3d ce==0 ) mTrace =
f940: 20 30 3b 0a 20 20 64 62 2d 3e 6d 54 72 61 63 65 0;. db->mTrace
f950: 20 3d 20 6d 54 72 61 63 65 3b 0a 20 20 64 62 2d = mTrace;. db-
f960: 3e 78 54 72 61 63 65 20 3d 20 78 54 72 61 63 65 >xTrace = xTrace
f970: 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65 41 72 ;. db->pTraceAr
f980: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
f990: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
f9a0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
f9b0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
f9c0: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
f9d0: 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 E_OMIT_DEPRECATE
f9e0: 44 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 D./*.** Register
f9f0: 20 61 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 a profile funct
fa00: 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 ion. The pArg f
fa10: 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 rom the previous
fa20: 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 0a 2a ly registered .*
fa30: 2a 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 * profile functi
fa40: 6f 6e 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 on is returned.
fa50: 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 .**.** A NULL p
fa60: 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 rofile function
fa70: 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 70 72 means that no pr
fa80: 6f 66 69 6c 69 6e 67 20 69 73 20 65 78 65 63 75 ofiling is execu
fa90: 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c tes. A non-NULL
faa0: 0a 2a 2a 20 70 72 6f 66 69 6c 65 20 69 73 20 61 .** profile is a
fab0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 pointer to a fu
fac0: 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 nction that is i
fad0: 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f nvoked at the co
fae0: 6e 63 6c 75 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 nclusion of.** e
faf0: 61 63 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e ach SQL statemen
fb00: 74 20 74 68 61 74 20 69 73 20 72 75 6e 2e 0a 2a t that is run..*
fb10: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
fb20: 70 72 6f 66 69 6c 65 28 0a 20 20 73 71 6c 69 74 profile(. sqlit
fb30: 65 33 20 2a 64 62 2c 0a 20 20 76 6f 69 64 20 28 e3 *db,. void (
fb40: 2a 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a *xProfile)(void*
fb50: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c ,const char*,sql
fb60: 69 74 65 5f 75 69 6e 74 36 34 29 2c 0a 20 20 76 ite_uint64),. v
fb70: 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 76 oid *pArg.){. v
fb80: 6f 69 64 20 2a 70 4f 6c 64 3b 0a 0a 23 69 66 64 oid *pOld;..#ifd
fb90: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
fba0: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
fbb0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
fbc0: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
fbd0: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
fbe0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
fbf0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 return 0;. }.#e
fc00: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
fc10: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
fc20: 75 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 utex);. pOld =
fc30: 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 67 3b db->pProfileArg;
fc40: 0a 20 20 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 . db->xProfile
fc50: 3d 20 78 50 72 6f 66 69 6c 65 3b 0a 20 20 64 62 = xProfile;. db
fc60: 2d 3e 70 50 72 6f 66 69 6c 65 41 72 67 20 3d 20 ->pProfileArg =
fc70: 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f pArg;. sqlite3_
fc80: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
fc90: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
fca0: 20 70 4f 6c 64 3b 0a 7d 0a 23 65 6e 64 69 66 20 pOld;.}.#endif
fcb0: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 /* SQLITE_OMIT_D
fcc0: 45 50 52 45 43 41 54 45 44 20 2a 2f 0a 23 65 6e EPRECATED */.#en
fcd0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
fce0: 49 54 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 0a IT_TRACE */../*.
fcf0: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 66 75 ** Register a fu
fd00: 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 nction to be inv
fd10: 6f 6b 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e oked when a tran
fd20: 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 2e saction commits.
fd30: 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 76 6f 6b .** If the invok
fd40: 65 64 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ed function retu
fd50: 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 rns non-zero, th
fd60: 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 en the commit be
fd70: 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 comes a.** rollb
fd80: 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 ack..*/.void *sq
fd90: 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f lite3_commit_hoo
fda0: 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 k(. sqlite3 *db
fdb0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
fdc0: 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f * Attach the hoo
fdd0: 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 k to this databa
fde0: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 se */. int (*xC
fdf0: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c allback)(void*),
fe00: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f /* Function to
fe10: 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 invoke on each
fe20: 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 commit */. void
fe30: 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
fe40: 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e /* Argumen
fe50: 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f t to the functio
fe60: 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a n */.){. void *
fe70: 70 4f 6c 64 3b 0a 0a 23 69 66 64 65 66 20 53 51 pOld;..#ifdef SQ
fe80: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
fe90: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
fea0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
feb0: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f k(db) ){. (vo
fec0: 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 id)SQLITE_MISUSE
fed0: 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 _BKPT;. retur
fee0: 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a n 0;. }.#endif.
fef0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
ff00: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
ff10: 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 ;. pOld = db->p
ff20: 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d CommitArg;. db-
ff30: 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b >xCommitCallback
ff40: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 = xCallback;.
ff50: 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d db->pCommitArg =
ff60: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
ff70: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
ff80: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
ff90: 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n pOld;.}../*.**
ffa0: 20 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c Register a call
ffb0: 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b back to be invok
ffc0: 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 72 ed each time a r
ffd0: 6f 77 20 69 73 20 75 70 64 61 74 65 64 2c 0a 2a ow is updated,.*
ffe0: 2a 20 69 6e 73 65 72 74 65 64 20 6f 72 20 64 65 * inserted or de
fff0: 6c 65 74 65 64 20 75 73 69 6e 67 20 74 68 69 73 leted using this
10000 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
10010 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 tion..*/.void *s
10020 71 6c 69 74 65 33 5f 75 70 64 61 74 65 5f 68 6f qlite3_update_ho
10030 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ok(. sqlite3 *d
10040 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
10050 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f /* Attach the ho
10060 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 ok to this datab
10070 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a ase */. void (*
10080 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a xCallback)(void*
10090 2c 69 6e 74 2c 63 68 61 72 20 63 6f 6e 73 74 20 ,int,char const
100a0 2a 2c 63 68 61 72 20 63 6f 6e 73 74 20 2a 2c 73 *,char const *,s
100b0 71 6c 69 74 65 5f 69 6e 74 36 34 29 2c 0a 20 20 qlite_int64),.
100c0 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 void *pArg
100d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
100e0 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e ument to the fun
100f0 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f ction */.){. vo
10100 69 64 20 2a 70 52 65 74 3b 0a 0a 23 69 66 64 65 id *pRet;..#ifde
10110 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
10120 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
10130 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
10140 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
10150 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 (void)SQLITE_MI
10160 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 SUSE_BKPT;. r
10170 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e eturn 0;. }.#en
10180 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
10190 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
101a0 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 64 tex);. pRet = d
101b0 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b 0a 20 b->pUpdateArg;.
101c0 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61 6c 6c db->xUpdateCall
101d0 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b back = xCallback
101e0 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 65 41 ;. db->pUpdateA
101f0 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
10200 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
10210 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
10220 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f eturn pRet;.}../
10230 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
10240 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 callback to be i
10250 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 nvoked each time
10260 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
10270 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b s rolled.** back
10280 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 by this databas
10290 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f e connection..*/
102a0 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 .void *sqlite3_r
102b0 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20 ollback_hook(.
102c0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
102d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 /* Att
102e0 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 ach the hook to
102f0 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f this database */
10300 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 . void (*xCallb
10310 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a 20 ack)(void*), /*
10320 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f Callback functio
10330 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 n */. void *pAr
10340 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g
10350 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
10360 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a the function */.
10370 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 3b ){. void *pRet;
10380 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
10390 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
103a0 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
103b0 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
103c0 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
103d0 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
103e0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a ;. return 0;.
103f0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c }.#endif. sql
10400 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
10410 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 (db->mutex);. p
10420 52 65 74 20 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 Ret = db->pRollb
10430 61 63 6b 41 72 67 3b 0a 20 20 64 62 2d 3e 78 52 ackArg;. db->xR
10440 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 ollbackCallback
10450 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 = xCallback;. d
10460 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 20 b->pRollbackArg
10470 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 = pArg;. sqlite
10480 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
10490 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
104a0 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 23 69 66 64 rn pRet;.}..#ifd
104b0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
104c0 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a _PREUPDATE_HOOK.
104d0 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
104e0 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 callback to be
104f0 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d invoked each tim
10500 65 20 61 20 72 6f 77 20 69 73 20 75 70 64 61 74 e a row is updat
10510 65 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 ed,.** inserted
10520 6f 72 20 64 65 6c 65 74 65 64 20 75 73 69 6e 67 or deleted using
10530 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 this database c
10540 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f onnection..*/.vo
10550 69 64 20 2a 73 71 6c 69 74 65 33 5f 70 72 65 75 id *sqlite3_preu
10560 70 64 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 pdate_hook(. sq
10570 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
10580 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 /* Attac
10590 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 h the hook to th
105a0 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 is database */.
105b0 20 76 6f 69 64 28 2a 78 43 61 6c 6c 62 61 63 6b void(*xCallback
105c0 29 28 20 20 20 20 20 20 20 20 20 2f 2a 20 43 61 )( /* Ca
105d0 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 llback function
105e0 2a 2f 0a 20 20 20 20 76 6f 69 64 2a 2c 73 71 6c */. void*,sql
105f0 69 74 65 33 2a 2c 69 6e 74 2c 63 68 61 72 20 63 ite3*,int,char c
10600 6f 6e 73 74 2a 2c 63 68 61 72 20 63 6f 6e 73 74 onst*,char const
10610 2a 2c 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 2c *,sqlite3_int64,
10620 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 2c 0a sqlite3_int64),.
10630 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 void *pArg
10640 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
10650 69 72 73 74 20 63 61 6c 6c 62 61 63 6b 20 61 72 irst callback ar
10660 67 75 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 76 gument */.){. v
10670 6f 69 64 20 2a 70 52 65 74 3b 0a 20 20 73 71 6c oid *pRet;. sql
10680 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
10690 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 (db->mutex);. p
106a0 52 65 74 20 3d 20 64 62 2d 3e 70 50 72 65 55 70 Ret = db->pPreUp
106b0 64 61 74 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 dateArg;. db->x
106c0 50 72 65 55 70 64 61 74 65 43 61 6c 6c 62 61 63 PreUpdateCallbac
106d0 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 k = xCallback;.
106e0 20 64 62 2d 3e 70 50 72 65 55 70 64 61 74 65 41 db->pPreUpdateA
106f0 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
10700 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
10710 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
10720 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 23 65 eturn pRet;.}.#e
10730 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 ndif /* SQLITE_E
10740 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f NABLE_PREUPDATE_
10750 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 HOOK */..#ifndef
10760 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
10770 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 ./*.** The sqlit
10780 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 63 61 e3_wal_hook() ca
10790 6c 6c 62 61 63 6b 20 72 65 67 69 73 74 65 72 65 llback registere
107a0 64 20 62 79 20 73 71 6c 69 74 65 33 5f 77 61 6c d by sqlite3_wal
107b0 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 28 _autocheckpoint(
107c0 29 2e 0a 2a 2a 20 49 6e 76 6f 6b 65 20 73 71 6c )..** Invoke sql
107d0 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f ite3_wal_checkpo
107e0 69 6e 74 20 69 66 20 74 68 65 20 6e 75 6d 62 65 int if the numbe
107f0 72 20 6f 66 20 66 72 61 6d 65 73 20 69 6e 20 74 r of frames in t
10800 68 65 20 6c 6f 67 20 66 69 6c 65 0a 2a 2a 20 69 he log file.** i
10810 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 73 s greater than s
10820 71 6c 69 74 65 33 2e 70 57 61 6c 41 72 67 20 63 qlite3.pWalArg c
10830 61 73 74 20 74 6f 20 61 6e 20 69 6e 74 65 67 65 ast to an intege
10840 72 20 28 74 68 65 20 76 61 6c 75 65 20 63 6f 6e r (the value con
10850 66 69 67 75 72 65 64 20 62 79 0a 2a 2a 20 77 61 figured by.** wa
10860 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 l_autocheckpoint
10870 28 29 29 2e 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c ())..*/ .int sql
10880 69 74 65 33 57 61 6c 44 65 66 61 75 6c 74 48 6f ite3WalDefaultHo
10890 6f 6b 28 0a 20 20 76 6f 69 64 20 2a 70 43 6c 69 ok(. void *pCli
108a0 65 6e 74 44 61 74 61 2c 20 20 20 20 20 2f 2a 20 entData, /*
108b0 41 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 73 71 Argument */. sq
108c0 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
108d0 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 /* Connecti
108e0 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 on */. const ch
108f0 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 20 20 2f ar *zDb, /
10900 2a 20 44 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 * Database */.
10910 69 6e 74 20 6e 46 72 61 6d 65 20 20 20 20 20 20 int nFrame
10920 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
10930 66 20 57 41 4c 20 2a 2f 0a 29 7b 0a 20 20 69 66 f WAL */.){. if
10940 28 20 6e 46 72 61 6d 65 3e 3d 53 51 4c 49 54 45 ( nFrame>=SQLITE
10950 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 43 6c 69 _PTR_TO_INT(pCli
10960 65 6e 74 44 61 74 61 29 20 29 7b 0a 20 20 20 20 entData) ){.
10970 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 sqlite3BeginBeni
10980 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 gnMalloc();.
10990 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 sqlite3_wal_chec
109a0 6b 70 6f 69 6e 74 28 64 62 2c 20 7a 44 62 29 3b kpoint(db, zDb);
109b0 0a 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 . sqlite3EndB
109c0 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 enignMalloc();.
109d0 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
109e0 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 TE_OK;.}.#endif
109f0 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 /* SQLITE_OMIT_W
10a00 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e AL */../*.** Con
10a10 66 69 67 75 72 65 20 61 6e 20 73 71 6c 69 74 65 figure an sqlite
10a20 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 63 61 6c 3_wal_hook() cal
10a30 6c 62 61 63 6b 20 74 6f 20 61 75 74 6f 6d 61 74 lback to automat
10a40 69 63 61 6c 6c 79 20 63 68 65 63 6b 70 6f 69 6e ically checkpoin
10a50 74 0a 2a 2a 20 61 20 64 61 74 61 62 61 73 65 20 t.** a database
10a60 61 66 74 65 72 20 63 6f 6d 6d 69 74 74 69 6e 67 after committing
10a70 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
10a80 66 20 74 68 65 72 65 20 61 72 65 20 6e 46 72 61 f there are nFra
10a90 6d 65 20 6f 72 0a 2a 2a 20 6d 6f 72 65 20 66 72 me or.** more fr
10aa0 61 6d 65 73 20 69 6e 20 74 68 65 20 6c 6f 67 20 ames in the log
10ab0 66 69 6c 65 2e 20 50 61 73 73 69 6e 67 20 7a 65 file. Passing ze
10ac0 72 6f 20 6f 72 20 61 20 6e 65 67 61 74 69 76 65 ro or a negative
10ad0 20 76 61 6c 75 65 20 61 73 20 74 68 65 0a 2a 2a value as the.**
10ae0 20 6e 46 72 61 6d 65 20 70 61 72 61 6d 65 74 65 nFrame paramete
10af0 72 20 64 69 73 61 62 6c 65 73 20 61 75 74 6f 6d r disables autom
10b00 61 74 69 63 20 63 68 65 63 6b 70 6f 69 6e 74 73 atic checkpoints
10b10 20 65 6e 74 69 72 65 6c 79 2e 0a 2a 2a 0a 2a 2a entirely..**.**
10b20 20 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 65 The callback re
10b30 67 69 73 74 65 72 65 64 20 62 79 20 74 68 69 73 gistered by this
10b40 20 66 75 6e 63 74 69 6f 6e 20 72 65 70 6c 61 63 function replac
10b50 65 73 20 61 6e 79 20 65 78 69 73 74 69 6e 67 20 es any existing
10b60 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 72 65 67 69 callback.** regi
10b70 73 74 65 72 65 64 20 75 73 69 6e 67 20 73 71 6c stered using sql
10b80 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 2e ite3_wal_hook().
10b90 20 4c 69 6b 65 77 69 73 65 2c 20 72 65 67 69 73 Likewise, regis
10ba0 74 65 72 69 6e 67 20 61 20 63 61 6c 6c 62 61 63 tering a callbac
10bb0 6b 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 k.** using sqlit
10bc0 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 64 69 e3_wal_hook() di
10bd0 73 61 62 6c 65 73 20 74 68 65 20 61 75 74 6f 6d sables the autom
10be0 61 74 69 63 20 63 68 65 63 6b 70 6f 69 6e 74 20 atic checkpoint
10bf0 6d 65 63 68 61 6e 69 73 6d 0a 2a 2a 20 63 6f 6e mechanism.** con
10c00 66 69 67 75 72 65 64 20 62 79 20 74 68 69 73 20 figured by this
10c10 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 function..*/.int
10c20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 sqlite3_wal_aut
10c30 6f 63 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 ocheckpoint(sqli
10c40 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6e 46 72 te3 *db, int nFr
10c50 61 6d 65 29 7b 0a 23 69 66 64 65 66 20 53 51 4c ame){.#ifdef SQL
10c60 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 55 ITE_OMIT_WAL. U
10c70 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
10c80 64 62 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 db);. UNUSED_PA
10c90 52 41 4d 45 54 45 52 28 6e 46 72 61 6d 65 29 3b RAMETER(nFrame);
10ca0 0a 23 65 6c 73 65 0a 23 69 66 64 65 66 20 53 51 .#else.#ifdef SQ
10cb0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
10cc0 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
10cd0 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
10ce0 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 k(db) ) return S
10cf0 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
10d00 54 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 T;.#endif. if(
10d10 6e 46 72 61 6d 65 3e 30 20 29 7b 0a 20 20 20 20 nFrame>0 ){.
10d20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b sqlite3_wal_hook
10d30 28 64 62 2c 20 73 71 6c 69 74 65 33 57 61 6c 44 (db, sqlite3WalD
10d40 65 66 61 75 6c 74 48 6f 6f 6b 2c 20 53 51 4c 49 efaultHook, SQLI
10d50 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 6e 46 TE_INT_TO_PTR(nF
10d60 72 61 6d 65 29 29 3b 0a 20 20 7d 65 6c 73 65 7b rame));. }else{
10d70 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c . sqlite3_wal
10d80 5f 68 6f 6f 6b 28 64 62 2c 20 30 2c 20 30 29 3b _hook(db, 0, 0);
10d90 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 . }.#endif. re
10da0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
10db0 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 }../*.** Registe
10dc0 72 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 r a callback to
10dd0 62 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 be invoked each
10de0 74 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 time a transacti
10df0 6f 6e 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a on is written.**
10e00 20 69 6e 74 6f 20 74 68 65 20 77 72 69 74 65 2d into the write-
10e10 61 68 65 61 64 2d 6c 6f 67 20 62 79 20 74 68 69 ahead-log by thi
10e20 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 s database conne
10e30 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a ction..*/.void *
10e40 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b sqlite3_wal_hook
10e50 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
10e60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10e70 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 /* Attach th
10e80 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 e hook to this d
10e90 62 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e b handle */. in
10ea0 74 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f t(*xCallback)(vo
10eb0 69 64 20 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 id *, sqlite3*,
10ec0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 const char*, int
10ed0 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 ),. void *pArg
10ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ef0 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
10f00 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f gument passed to
10f10 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a xCallback() */.
10f20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ){.#ifndef SQLIT
10f30 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 76 6f 69 E_OMIT_WAL. voi
10f40 64 20 2a 70 52 65 74 3b 0a 23 69 66 64 65 66 20 d *pRet;.#ifdef
10f50 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
10f60 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
10f70 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
10f80 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
10f90 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
10fa0 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
10fb0 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 urn 0;. }.#endi
10fc0 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
10fd0 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
10fe0 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 64 62 2d x);. pRet = db-
10ff0 3e 70 57 61 6c 41 72 67 3b 0a 20 20 64 62 2d 3e >pWalArg;. db->
11000 78 57 61 6c 43 61 6c 6c 62 61 63 6b 20 3d 20 78 xWalCallback = x
11010 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e Callback;. db->
11020 70 57 61 6c 41 72 67 20 3d 20 70 41 72 67 3b 0a pWalArg = pArg;.
11030 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
11040 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
11050 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b ;. return pRet;
11060 0a 23 65 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 .#else. return
11070 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 0;.#endif.}../*.
11080 2a 2a 20 43 68 65 63 6b 70 6f 69 6e 74 20 64 61 ** Checkpoint da
11090 74 61 62 61 73 65 20 7a 44 62 2e 0a 2a 2f 0a 69 tabase zDb..*/.i
110a0 6e 74 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 nt sqlite3_wal_c
110b0 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 0a 20 20 heckpoint_v2(.
110c0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
110d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
110e0 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 /* Database hand
110f0 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 le */. const ch
11100 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 20 20 20 ar *zDb,
11110 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
11120 6f 66 20 61 74 74 61 63 68 65 64 20 64 61 74 61 of attached data
11130 62 61 73 65 20 28 6f 72 20 4e 55 4c 4c 29 20 2a base (or NULL) *
11140 2f 0a 20 20 69 6e 74 20 65 4d 6f 64 65 2c 20 20 /. int eMode,
11150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11160 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 48 /* SQLITE_CH
11170 45 43 4b 50 4f 49 4e 54 5f 2a 20 76 61 6c 75 65 ECKPOINT_* value
11180 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4c 6f 67 */. int *pnLog
11190 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
111a0 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 /* OUT: Si
111b0 7a 65 20 6f 66 20 57 41 4c 20 6c 6f 67 20 69 6e ze of WAL log in
111c0 20 66 72 61 6d 65 73 20 2a 2f 0a 20 20 69 6e 74 frames */. int
111d0 20 2a 70 6e 43 6b 70 74 20 20 20 20 20 20 20 20 *pnCkpt
111e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
111f0 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 OUT: Total numbe
11200 72 20 6f 66 20 66 72 61 6d 65 73 20 63 68 65 63 r of frames chec
11210 6b 70 6f 69 6e 74 65 64 20 2a 2f 0a 29 7b 0a 23 kpointed */.){.#
11220 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 ifdef SQLITE_OMI
11230 54 5f 57 41 4c 0a 20 20 72 65 74 75 72 6e 20 53 T_WAL. return S
11240 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6c 73 65 0a QLITE_OK;.#else.
11250 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
11260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11270 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
11280 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 20 3d 20 */. int iDb =
11290 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
112a0 48 45 44 3b 20 20 2f 2a 20 73 71 6c 69 74 65 33 HED; /* sqlite3
112b0 2e 61 44 62 5b 5d 20 69 6e 64 65 78 20 6f 66 20 .aDb[] index of
112c0 64 62 20 74 6f 20 63 68 65 63 6b 70 6f 69 6e 74 db to checkpoint
112d0 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 */..#ifdef SQLI
112e0 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
112f0 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
11300 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
11310 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c db) ) return SQL
11320 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
11330 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 49 6e .#endif.. /* In
11340 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6f 75 74 itialize the out
11350 70 75 74 20 76 61 72 69 61 62 6c 65 73 20 74 6f put variables to
11360 20 2d 31 20 69 6e 20 63 61 73 65 20 61 6e 20 65 -1 in case an e
11370 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 2a 2f 0a rror occurs. */.
11380 20 20 69 66 28 20 70 6e 4c 6f 67 20 29 20 2a 70 if( pnLog ) *p
11390 6e 4c 6f 67 20 3d 20 2d 31 3b 0a 20 20 69 66 28 nLog = -1;. if(
113a0 20 70 6e 43 6b 70 74 20 29 20 2a 70 6e 43 6b 70 pnCkpt ) *pnCkp
113b0 74 20 3d 20 2d 31 3b 0a 0a 20 20 61 73 73 65 72 t = -1;.. asser
113c0 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 t( SQLITE_CHECKP
113d0 4f 49 4e 54 5f 50 41 53 53 49 56 45 3d 3d 30 20 OINT_PASSIVE==0
113e0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c );. assert( SQL
113f0 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 46 ITE_CHECKPOINT_F
11400 55 4c 4c 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 ULL==1 );. asse
11410 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 4b rt( SQLITE_CHECK
11420 50 4f 49 4e 54 5f 52 45 53 54 41 52 54 3d 3d 32 POINT_RESTART==2
11430 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 );. assert( SQ
11440 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
11450 54 52 55 4e 43 41 54 45 3d 3d 33 20 29 3b 0a 20 TRUNCATE==3 );.
11460 20 69 66 28 20 65 4d 6f 64 65 3c 53 51 4c 49 54 if( eMode<SQLIT
11470 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 E_CHECKPOINT_PAS
11480 53 49 56 45 20 7c 7c 20 65 4d 6f 64 65 3e 53 51 SIVE || eMode>SQ
11490 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
114a0 54 52 55 4e 43 41 54 45 20 29 7b 0a 20 20 20 20 TRUNCATE ){.
114b0 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
114c0 52 2d 30 33 39 39 36 2d 31 32 30 38 38 20 54 68 R-03996-12088 Th
114d0 65 20 4d 20 70 61 72 61 6d 65 74 65 72 20 6d 75 e M parameter mu
114e0 73 74 20 62 65 20 61 20 76 61 6c 69 64 20 63 68 st be a valid ch
114f0 65 63 6b 70 6f 69 6e 74 0a 20 20 20 20 2a 2a 20 eckpoint. **
11500 6d 6f 64 65 3a 20 2a 2f 0a 20 20 20 20 72 65 74 mode: */. ret
11510 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
11520 45 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 E;. }.. sqlite
11530 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
11540 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
11550 7a 44 62 20 26 26 20 7a 44 62 5b 30 5d 20 29 7b zDb && zDb[0] ){
11560 0a 20 20 20 20 69 44 62 20 3d 20 73 71 6c 69 74 . iDb = sqlit
11570 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c e3FindDbName(db,
11580 20 7a 44 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 zDb);. }. if(
11590 20 69 44 62 3c 30 20 29 7b 0a 20 20 20 20 72 63 iDb<0 ){. rc
115a0 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
115b0 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f . sqlite3Erro
115c0 72 57 69 74 68 4d 73 67 28 64 62 2c 20 53 51 4c rWithMsg(db, SQL
115d0 49 54 45 5f 45 52 52 4f 52 2c 20 22 75 6e 6b 6e ITE_ERROR, "unkn
115e0 6f 77 6e 20 64 61 74 61 62 61 73 65 3a 20 25 73 own database: %s
115f0 22 2c 20 7a 44 62 29 3b 0a 20 20 7d 65 6c 73 65 ", zDb);. }else
11600 7b 0a 20 20 20 20 64 62 2d 3e 62 75 73 79 48 61 {. db->busyHa
11610 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d 20 30 3b ndler.nBusy = 0;
11620 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
11630 33 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 3Checkpoint(db,
11640 69 44 62 2c 20 65 4d 6f 64 65 2c 20 70 6e 4c 6f iDb, eMode, pnLo
11650 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 20 20 g, pnCkpt);.
11660 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
11670 20 72 63 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d rc);. }. rc =
11680 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
11690 64 62 2c 20 72 63 29 3b 0a 0a 20 20 2f 2a 20 49 db, rc);.. /* I
116a0 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 61 f there are no a
116b0 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 ctive statements
116c0 2c 20 63 6c 65 61 72 20 74 68 65 20 69 6e 74 65 , clear the inte
116d0 72 72 75 70 74 20 66 6c 61 67 20 61 74 20 74 68 rrupt flag at th
116e0 69 73 0a 20 20 2a 2a 20 70 6f 69 6e 74 2e 20 20 is. ** point.
116f0 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 */. if( db->nVd
11700 62 65 41 63 74 69 76 65 3d 3d 30 20 29 7b 0a 20 beActive==0 ){.
11710 20 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 db->u1.isInte
11720 72 72 75 70 74 65 64 20 3d 20 30 3b 0a 20 20 7d rrupted = 0;. }
11730 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 .. sqlite3_mute
11740 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
11750 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b x);. return rc;
11760 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a .#endif.}.../*.*
11770 2a 20 43 68 65 63 6b 70 6f 69 6e 74 20 64 61 74 * Checkpoint dat
11780 61 62 61 73 65 20 7a 44 62 2e 20 49 66 20 7a 44 abase zDb. If zD
11790 62 20 69 73 20 4e 55 4c 4c 2c 20 6f 72 20 69 66 b is NULL, or if
117a0 20 74 68 65 20 62 75 66 66 65 72 20 7a 44 62 20 the buffer zDb
117b0 70 6f 69 6e 74 73 0a 2a 2a 20 74 6f 20 63 6f 6e points.** to con
117c0 74 61 69 6e 73 20 61 20 7a 65 72 6f 2d 6c 65 6e tains a zero-len
117d0 67 74 68 20 73 74 72 69 6e 67 2c 20 61 6c 6c 20 gth string, all
117e0 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 attached databas
117f0 65 73 20 61 72 65 20 0a 2a 2a 20 63 68 65 63 6b es are .** check
11800 70 6f 69 6e 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 pointed..*/.int
11810 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 sqlite3_wal_chec
11820 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a kpoint(sqlite3 *
11830 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
11840 7a 44 62 29 7b 0a 20 20 2f 2a 20 45 56 49 44 45 zDb){. /* EVIDE
11850 4e 43 45 2d 4f 46 3a 20 52 2d 34 31 36 31 33 2d NCE-OF: R-41613-
11860 32 30 35 35 33 20 54 68 65 20 73 71 6c 69 74 65 20553 The sqlite
11870 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
11880 28 44 2c 58 29 20 69 73 20 65 71 75 69 76 61 6c (D,X) is equival
11890 65 6e 74 20 74 6f 0a 20 20 2a 2a 20 73 71 6c 69 ent to. ** sqli
118a0 74 65 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 te3_wal_checkpoi
118b0 6e 74 5f 76 32 28 44 2c 58 2c 53 51 4c 49 54 45 nt_v2(D,X,SQLITE
118c0 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 _CHECKPOINT_PASS
118d0 49 56 45 2c 30 2c 30 29 2e 20 2a 2f 0a 20 20 72 IVE,0,0). */. r
118e0 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 77 61 eturn sqlite3_wa
118f0 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 l_checkpoint_v2(
11900 64 62 2c 7a 44 62 2c 53 51 4c 49 54 45 5f 43 48 db,zDb,SQLITE_CH
11910 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 ECKPOINT_PASSIVE
11920 2c 30 2c 30 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 ,0,0);.}..#ifnde
11930 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
11940 4c 0a 2f 2a 0a 2a 2a 20 52 75 6e 20 61 20 63 68 L./*.** Run a ch
11950 65 63 6b 70 6f 69 6e 74 20 6f 6e 20 64 61 74 61 eckpoint on data
11960 62 61 73 65 20 69 44 62 2e 20 54 68 69 73 20 69 base iDb. This i
11970 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 64 61 74 s a no-op if dat
11980 61 62 61 73 65 20 69 44 62 20 69 73 0a 2a 2a 20 abase iDb is.**
11990 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 70 not currently op
119a0 65 6e 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 0a en in WAL mode..
119b0 2a 2a 0a 2a 2a 20 49 66 20 61 20 74 72 61 6e 73 **.** If a trans
119c0 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 6f action is open o
119d0 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 n the database b
119e0 65 69 6e 67 20 63 68 65 63 6b 70 6f 69 6e 74 65 eing checkpointe
119f0 64 2c 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 d, this .** func
11a00 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c tion returns SQL
11a10 49 54 45 5f 4c 4f 43 4b 45 44 20 61 6e 64 20 61 ITE_LOCKED and a
11a20 20 63 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 6e checkpoint is n
11a30 6f 74 20 61 74 74 65 6d 70 74 65 64 2e 20 49 66 ot attempted. If
11a40 20 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63 .** an error oc
11a50 63 75 72 73 20 77 68 69 6c 65 20 72 75 6e 6e 69 curs while runni
11a60 6e 67 20 74 68 65 20 63 68 65 63 6b 70 6f 69 6e ng the checkpoin
11a70 74 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 t, an SQLite err
11a80 6f 72 20 63 6f 64 65 20 69 73 20 0a 2a 2a 20 72 or code is .** r
11a90 65 74 75 72 6e 65 64 20 28 69 2e 65 2e 20 53 51 eturned (i.e. SQ
11aa0 4c 49 54 45 5f 49 4f 45 52 52 29 2e 20 4f 74 68 LITE_IOERR). Oth
11ab0 65 72 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f erwise, SQLITE_O
11ac0 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 K..**.** The mut
11ad0 65 78 20 6f 6e 20 64 61 74 61 62 61 73 65 20 68 ex on database h
11ae0 61 6e 64 6c 65 20 64 62 20 73 68 6f 75 6c 64 20 andle db should
11af0 62 65 20 68 65 6c 64 20 62 79 20 74 68 65 20 63 be held by the c
11b00 61 6c 6c 65 72 2e 20 54 68 65 20 6d 75 74 65 78 aller. The mutex
11b10 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77 .** associated w
11b20 69 74 68 20 74 68 65 20 73 70 65 63 69 66 69 63 ith the specific
11b30 20 62 2d 74 72 65 65 20 62 65 69 6e 67 20 63 68 b-tree being ch
11b40 65 63 6b 70 6f 69 6e 74 65 64 20 69 73 20 74 61 eckpointed is ta
11b50 6b 65 6e 20 62 79 0a 2a 2a 20 74 68 69 73 20 66 ken by.** this f
11b60 75 6e 63 74 69 6f 6e 20 77 68 69 6c 65 20 74 68 unction while th
11b70 65 20 63 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 e checkpoint is
11b80 72 75 6e 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 running..**.** I
11b90 66 20 69 44 62 20 69 73 20 70 61 73 73 65 64 20 f iDb is passed
11ba0 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
11bb0 48 45 44 2c 20 74 68 65 6e 20 61 6c 6c 20 61 74 HED, then all at
11bc0 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73 tached databases
11bd0 20 61 72 65 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 are.** checkpoi
11be0 6e 74 65 64 2e 20 49 66 20 61 6e 20 65 72 72 6f nted. If an erro
11bf0 72 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 r is encountered
11c00 20 69 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 it is returned
11c10 69 6d 6d 65 64 69 61 74 65 6c 79 20 2d 0a 2a 2a immediately -.**
11c20 20 6e 6f 20 61 74 74 65 6d 70 74 20 69 73 20 6d no attempt is m
11c30 61 64 65 20 74 6f 20 63 68 65 63 6b 70 6f 69 6e ade to checkpoin
11c40 74 20 61 6e 79 20 72 65 6d 61 69 6e 69 6e 67 20 t any remaining
11c50 64 61 74 61 62 61 73 65 73 2e 0a 2a 2a 0a 2a 2a databases..**.**
11c60 20 50 61 72 61 6d 65 74 65 72 20 65 4d 6f 64 65 Parameter eMode
11c70 20 69 73 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 is one of SQLIT
11c80 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 E_CHECKPOINT_PAS
11c90 53 49 56 45 2c 20 46 55 4c 4c 20 6f 72 20 52 45 SIVE, FULL or RE
11ca0 53 54 41 52 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 START..*/.int sq
11cb0 6c 69 74 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 lite3Checkpoint(
11cc0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
11cd0 20 69 44 62 2c 20 69 6e 74 20 65 4d 6f 64 65 2c iDb, int eMode,
11ce0 20 69 6e 74 20 2a 70 6e 4c 6f 67 2c 20 69 6e 74 int *pnLog, int
11cf0 20 2a 70 6e 43 6b 70 74 29 7b 0a 20 20 69 6e 74 *pnCkpt){. int
11d00 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
11d10 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
11d20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 Return code */.
11d30 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 int i;
11d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11d50 20 2f 2a 20 55 73 65 64 20 74 6f 20 69 74 65 72 /* Used to iter
11d60 61 74 65 20 74 68 72 6f 75 67 68 20 61 74 74 61 ate through atta
11d70 63 68 65 64 20 64 62 73 20 2a 2f 0a 20 20 69 6e ched dbs */. in
11d80 74 20 62 42 75 73 79 20 3d 20 30 3b 20 20 20 20 t bBusy = 0;
11d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
11da0 20 54 72 75 65 20 69 66 20 53 51 4c 49 54 45 5f True if SQLITE_
11db0 42 55 53 59 20 68 61 73 20 62 65 65 6e 20 65 6e BUSY has been en
11dc0 63 6f 75 6e 74 65 72 65 64 20 2a 2f 0a 0a 20 20 countered */..
11dd0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
11de0 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d mutex_held(db->m
11df0 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
11e00 74 28 20 21 70 6e 4c 6f 67 20 7c 7c 20 2a 70 6e t( !pnLog || *pn
11e10 4c 6f 67 3d 3d 2d 31 20 29 3b 0a 20 20 61 73 73 Log==-1 );. ass
11e20 65 72 74 28 20 21 70 6e 43 6b 70 74 20 7c 7c 20 ert( !pnCkpt ||
11e30 2a 70 6e 43 6b 70 74 3d 3d 2d 31 20 29 3b 0a 0a *pnCkpt==-1 );..
11e40 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d for(i=0; i<db-
11e50 3e 6e 44 62 20 26 26 20 72 63 3d 3d 53 51 4c 49 >nDb && rc==SQLI
11e60 54 45 5f 4f 4b 3b 20 69 2b 2b 29 7b 0a 20 20 20 TE_OK; i++){.
11e70 20 69 66 28 20 69 3d 3d 69 44 62 20 7c 7c 20 69 if( i==iDb || i
11e80 44 62 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 41 Db==SQLITE_MAX_A
11e90 54 54 41 43 48 45 44 20 29 7b 0a 20 20 20 20 20 TTACHED ){.
11ea0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 rc = sqlite3Btr
11eb0 65 65 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2d eeCheckpoint(db-
11ec0 3e 61 44 62 5b 69 5d 2e 70 42 74 2c 20 65 4d 6f >aDb[i].pBt, eMo
11ed0 64 65 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 6b 70 de, pnLog, pnCkp
11ee0 74 29 3b 0a 20 20 20 20 20 20 70 6e 4c 6f 67 20 t);. pnLog
11ef0 3d 20 30 3b 0a 20 20 20 20 20 20 70 6e 43 6b 70 = 0;. pnCkp
11f00 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 t = 0;. if(
11f10 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 rc==SQLITE_BUSY
11f20 20 29 7b 0a 20 20 20 20 20 20 20 20 62 42 75 73 ){. bBus
11f30 79 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 y = 1;. r
11f40 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
11f50 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
11f60 0a 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d .. return (rc==
11f70 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 42 75 SQLITE_OK && bBu
11f80 73 79 29 20 3f 20 53 51 4c 49 54 45 5f 42 55 53 sy) ? SQLITE_BUS
11f90 59 20 3a 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 Y : rc;.}.#endif
11fa0 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
11fb0 57 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 WAL */../*.** Th
11fc0 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
11fd0 72 6e 73 20 74 72 75 65 20 69 66 20 6d 61 69 6e rns true if main
11fe0 2d 6d 65 6d 6f 72 79 20 73 68 6f 75 6c 64 20 62 -memory should b
11ff0 65 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f e used instead o
12000 66 0a 2a 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 f.** a temporary
12010 20 66 69 6c 65 20 66 6f 72 20 74 72 61 6e 73 69 file for transi
12020 65 6e 74 20 70 61 67 65 72 20 66 69 6c 65 73 20 ent pager files
12030 61 6e 64 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f and statement jo
12040 75 72 6e 61 6c 73 2e 0a 2a 2a 20 54 68 65 20 76 urnals..** The v
12050 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 64 65 alue returned de
12060 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 76 61 6c pends on the val
12070 75 65 20 6f 66 20 64 62 2d 3e 74 65 6d 70 5f 73 ue of db->temp_s
12080 74 6f 72 65 20 28 72 75 6e 74 69 6d 65 0a 2a 2a tore (runtime.**
12090 20 70 61 72 61 6d 65 74 65 72 29 20 61 6e 64 20 parameter) and
120a0 74 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 the compile time
120b0 20 76 61 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 value of SQLITE
120c0 5f 54 45 4d 50 5f 53 54 4f 52 45 2e 20 54 68 65 _TEMP_STORE. The
120d0 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 .** following ta
120e0 62 6c 65 20 64 65 73 63 72 69 62 65 73 20 74 68 ble describes th
120f0 65 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 20 62 e relationship b
12100 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f etween these two
12110 20 76 61 6c 75 65 73 0a 2a 2a 20 61 6e 64 20 74 values.** and t
12120 68 69 73 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 his functions re
12130 74 75 72 6e 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a turn value..**.*
12140 2a 20 20 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f * SQLITE_TEMP_
12150 53 54 4f 52 45 20 20 20 20 20 64 62 2d 3e 74 65 STORE db->te
12160 6d 70 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 mp_store Loc
12170 61 74 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 ation of tempora
12180 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 ry database.**
12190 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ---------------
121a0 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d -- ---------
121b0 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d ----- ------
121c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
121d0 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 --------.** 0
121e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
121f0 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 any
12200 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 file
12210 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 (return 0).**
12220 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
12230 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 1
12240 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 file
12250 20 20 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a (return 0).*
12260 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 * 1
12270 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 2
12280 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d mem
12290 6f 72 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 ory (return 1
122a0 29 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 20 20 ).** 1
122b0 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20 0
122c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
122d0 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 file (retur
122e0 6e 20 30 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 n 0).** 2
122f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12300 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
12310 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 file (re
12320 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 32 20 20 turn 0).** 2
12330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12340 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 20 2
12350 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 memory
12360 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 (return 1).**
12370 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
12380 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 0
12390 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 memory
123a0 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a (return 1).**
123b0 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20 20 3
123c0 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 any
123d0 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f memo
123e0 72 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 ry (return 1)
123f0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 .*/.int sqlite3T
12400 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 empInMemory(cons
12410 74 20 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a t sqlite3 *db){.
12420 23 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f #if SQLITE_TEMP_
12430 53 54 4f 52 45 3d 3d 31 0a 20 20 72 65 74 75 72 STORE==1. retur
12440 6e 20 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f n ( db->temp_sto
12450 72 65 3d 3d 32 20 29 3b 0a 23 65 6e 64 69 66 0a re==2 );.#endif.
12460 23 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f #if SQLITE_TEMP_
12470 53 54 4f 52 45 3d 3d 32 0a 20 20 72 65 74 75 72 STORE==2. retur
12480 6e 20 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f n ( db->temp_sto
12490 72 65 21 3d 31 20 29 3b 0a 23 65 6e 64 69 66 0a re!=1 );.#endif.
124a0 23 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f #if SQLITE_TEMP_
124b0 53 54 4f 52 45 3d 3d 33 0a 20 20 55 4e 55 53 45 STORE==3. UNUSE
124c0 44 5f 50 41 52 41 4d 45 54 45 52 28 64 62 29 3b D_PARAMETER(db);
124d0 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e . return 1;.#en
124e0 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 dif.#if SQLITE_T
124f0 45 4d 50 5f 53 54 4f 52 45 3c 31 20 7c 7c 20 53 EMP_STORE<1 || S
12500 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
12510 3e 33 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 >3. UNUSED_PARA
12520 4d 45 54 45 52 28 64 62 29 3b 0a 20 20 72 65 74 METER(db);. ret
12530 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a urn 0;.#endif.}.
12540 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 ./*.** Return UT
12550 46 2d 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c F-8 encoded Engl
12560 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 ish language exp
12570 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 lanation of the
12580 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 most recent.** e
12590 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 rror..*/.const c
125a0 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 har *sqlite3_err
125b0 6d 73 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 msg(sqlite3 *db)
125c0 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
125d0 7a 3b 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a z;. if( !db ){.
125e0 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 return sqlit
125f0 65 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f e3ErrStr(SQLITE_
12600 4e 4f 4d 45 4d 5f 42 4b 50 54 29 3b 0a 20 20 7d NOMEM_BKPT);. }
12610 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
12620 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 afetyCheckSickOr
12630 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 Ok(db) ){. re
12640 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 turn sqlite3ErrS
12650 74 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 tr(SQLITE_MISUSE
12660 5f 42 4b 50 54 29 3b 0a 20 20 7d 0a 20 20 73 71 _BKPT);. }. sq
12670 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
12680 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
12690 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 if( db->mallocFa
126a0 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d 20 iled ){. z =
126b0 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 sqlite3ErrStr(SQ
126c0 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 29 LITE_NOMEM_BKPT)
126d0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 74 ;. }else{. t
126e0 65 73 74 63 61 73 65 28 20 64 62 2d 3e 70 45 72 estcase( db->pEr
126f0 72 3d 3d 30 20 29 3b 0a 20 20 20 20 7a 20 3d 20 r==0 );. z =
12700 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76 (char*)sqlite3_v
12710 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e 70 45 alue_text(db->pE
12720 72 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 rr);. assert(
12730 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
12740 65 64 20 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d ed );. if( z=
12750 3d 30 20 29 7b 0a 20 20 20 20 20 20 7a 20 3d 20 =0 ){. z =
12760 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 sqlite3ErrStr(db
12770 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 20 20 ->errCode);.
12780 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f }. }. sqlite3_
12790 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
127a0 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
127b0 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 z;.}..#ifndef S
127c0 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
127d0 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 ./*.** Return UT
127e0 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 F-16 encoded Eng
127f0 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 lish language ex
12800 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 planation of the
12810 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 most recent.**
12820 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 error..*/.const
12830 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 void *sqlite3_er
12840 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a rmsg16(sqlite3 *
12850 64 62 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f db){. static co
12860 6e 73 74 20 75 31 36 20 6f 75 74 4f 66 4d 65 6d nst u16 outOfMem
12870 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6f 27 2c 20 [] = {. 'o',
12880 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 27 'u', 't', ' ', '
12890 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 20 27 6d o', 'f', ' ', 'm
128a0 27 2c 20 27 65 27 2c 20 27 6d 27 2c 20 27 6f 27 ', 'e', 'm', 'o'
128b0 2c 20 27 72 27 2c 20 27 79 27 2c 20 30 0a 20 20 , 'r', 'y', 0.
128c0 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 };. static cons
128d0 74 20 75 31 36 20 6d 69 73 75 73 65 5b 5d 20 3d t u16 misuse[] =
128e0 20 7b 0a 20 20 20 20 27 6c 27 2c 20 27 69 27 2c {. 'l', 'i',
128f0 20 27 62 27 2c 20 27 72 27 2c 20 27 61 27 2c 20 'b', 'r', 'a',
12900 27 72 27 2c 20 27 79 27 2c 20 27 20 27 2c 20 0a 'r', 'y', ' ', .
12910 20 20 20 20 27 72 27 2c 20 27 6f 27 2c 20 27 75 'r', 'o', 'u
12920 27 2c 20 27 74 27 2c 20 27 69 27 2c 20 27 6e 27 ', 't', 'i', 'n'
12930 2c 20 27 65 27 2c 20 27 20 27 2c 20 0a 20 20 20 , 'e', ' ', .
12940 20 27 63 27 2c 20 27 61 27 2c 20 27 6c 27 2c 20 'c', 'a', 'l',
12950 27 6c 27 2c 20 27 65 27 2c 20 27 64 27 2c 20 27 'l', 'e', 'd', '
12960 20 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 27 75 ', . 'o', 'u
12970 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 0a 20 20 ', 't', ' ', .
12980 20 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 'o', 'f', ' ',
12990 20 0a 20 20 20 20 27 73 27 2c 20 27 65 27 2c 20 . 's', 'e',
129a0 27 71 27 2c 20 27 75 27 2c 20 27 65 27 2c 20 27 'q', 'u', 'e', '
129b0 6e 27 2c 20 27 63 27 2c 20 27 65 27 2c 20 30 0a n', 'c', 'e', 0.
129c0 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 76 6f };.. const vo
129d0 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 62 id *z;. if( !db
129e0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 ){. return (
129f0 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 6d 3b void *)outOfMem;
12a00 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 . }. if( !sqli
12a10 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 te3SafetyCheckSi
12a20 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 ckOrOk(db) ){.
12a30 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a return (void *
12a40 29 6d 69 73 75 73 65 3b 0a 20 20 7d 0a 20 20 73 )misuse;. }. s
12a50 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
12a60 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
12a70 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
12a80 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d ailed ){. z =
12a90 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 (void *)outOfMe
12aa0 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 m;. }else{.
12ab0 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 z = sqlite3_valu
12ac0 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 e_text16(db->pEr
12ad0 72 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 r);. if( z==0
12ae0 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
12af0 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 3ErrorWithMsg(db
12b00 2c 20 64 62 2d 3e 65 72 72 43 6f 64 65 2c 20 73 , db->errCode, s
12b10 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 2d qlite3ErrStr(db-
12b20 3e 65 72 72 43 6f 64 65 29 29 3b 0a 20 20 20 20 >errCode));.
12b30 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 z = sqlite3_va
12b40 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 lue_text16(db->p
12b50 45 72 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Err);. }.
12b60 2f 2a 20 41 20 6d 61 6c 6c 6f 63 28 29 20 6d 61 /* A malloc() ma
12b70 79 20 68 61 76 65 20 66 61 69 6c 65 64 20 77 69 y have failed wi
12b80 74 68 69 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f thin the call to
12b90 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
12ba0 65 78 74 31 36 28 29 0a 20 20 20 20 2a 2a 20 61 ext16(). ** a
12bb0 62 6f 76 65 2e 20 49 66 20 74 68 69 73 20 69 73 bove. If this is
12bc0 20 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 20 the case, then
12bd0 74 68 65 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 the db->mallocFa
12be0 69 6c 65 64 20 66 6c 61 67 20 6e 65 65 64 73 20 iled flag needs
12bf0 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 63 6c 65 to. ** be cle
12c00 61 72 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 ared before retu
12c10 72 6e 69 6e 67 2e 20 44 6f 20 74 68 69 73 20 64 rning. Do this d
12c20 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 irectly, instead
12c30 20 6f 66 20 76 69 61 0a 20 20 20 20 2a 2a 20 73 of via. ** s
12c40 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 29 2c qlite3ApiExit(),
12c50 20 74 6f 20 61 76 6f 69 64 20 73 65 74 74 69 6e to avoid settin
12c60 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 g the database h
12c70 61 6e 64 6c 65 20 65 72 72 6f 72 20 6d 65 73 73 andle error mess
12c80 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 age.. */.
12c90 73 71 6c 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 sqlite3OomClear(
12ca0 64 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 db);. }. sqlit
12cb0 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
12cc0 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
12cd0 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 urn z;.}.#endif
12ce0 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
12cf0 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
12d00 65 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20 72 eturn the most r
12d10 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 ecent error code
12d20 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e generated by an
12d30 20 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65 2e SQLite routine.
12d40 20 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 If NULL is.** p
12d50 61 73 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 assed to this fu
12d60 6e 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75 6d nction, we assum
12d70 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 e a malloc() fai
12d80 6c 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69 74 led during sqlit
12d90 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e e3_open()..*/.in
12da0 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 t sqlite3_errcod
12db0 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a e(sqlite3 *db){.
12dc0 20 20 69 66 28 20 64 62 20 26 26 20 21 73 71 6c if( db && !sql
12dd0 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
12de0 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 ickOrOk(db) ){.
12df0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
12e00 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
12e10 7d 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 64 }. if( !db || d
12e20 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
12e30 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
12e40 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
12e50 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 . }. return db
12e60 2d 3e 65 72 72 43 6f 64 65 20 26 20 64 62 2d 3e ->errCode & db->
12e70 65 72 72 4d 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 errMask;.}.int s
12e80 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 64 5f qlite3_extended_
12e90 65 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 errcode(sqlite3
12ea0 2a 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 *db){. if( db &
12eb0 26 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 & !sqlite3Safety
12ec0 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 CheckSickOrOk(db
12ed0 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
12ee0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
12ef0 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 PT;. }. if( !d
12f00 62 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 b || db->mallocF
12f10 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 ailed ){. ret
12f20 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
12f30 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 65 74 _BKPT;. }. ret
12f40 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 3b urn db->errCode;
12f50 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 .}.int sqlite3_s
12f60 79 73 74 65 6d 5f 65 72 72 6e 6f 28 73 71 6c 69 ystem_errno(sqli
12f70 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
12f80 72 6e 20 64 62 20 3f 20 64 62 2d 3e 69 53 79 73 rn db ? db->iSys
12f90 45 72 72 6e 6f 20 3a 20 30 3b 0a 7d 20 20 0a 0a Errno : 0;.} ..
12fa0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 /*.** Return a s
12fb0 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 tring that descr
12fc0 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 ibes the kind of
12fd0 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 error specified
12fe0 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d in the.** argum
12ff0 65 6e 74 2e 20 20 46 6f 72 20 6e 6f 77 2c 20 74 ent. For now, t
13000 68 69 73 20 73 69 6d 70 6c 79 20 63 61 6c 6c 73 his simply calls
13010 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 71 the internal sq
13020 6c 69 74 65 33 45 72 72 53 74 72 28 29 0a 2a 2a lite3ErrStr().**
13030 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 63 6f function..*/.co
13040 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
13050 33 5f 65 72 72 73 74 72 28 69 6e 74 20 72 63 29 3_errstr(int rc)
13060 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 {. return sqlit
13070 65 33 45 72 72 53 74 72 28 72 63 29 3b 0a 7d 0a e3ErrStr(rc);.}.
13080 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 ./*.** Create a
13090 6e 65 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 new collating fu
130a0 6e 63 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 nction for datab
130b0 61 73 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e ase "db". The n
130c0 61 6d 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 ame is zName.**
130d0 61 6e 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 and the encoding
130e0 20 69 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 is enc..*/.stat
130f0 69 63 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c ic int createCol
13100 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 lation(. sqlite
13110 33 2a 20 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3* db,. const c
13120 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 75 har *zName, . u
13130 38 20 65 6e 63 2c 0a 20 20 76 6f 69 64 2a 20 70 8 enc,. void* p
13140 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d Ctx,. int(*xCom
13150 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c pare)(void*,int,
13160 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c const void*,int,
13170 63 6f 6e 73 74 20 76 6f 69 64 2a 29 2c 0a 20 20 const void*),.
13180 76 6f 69 64 28 2a 78 44 65 6c 29 28 76 6f 69 64 void(*xDel)(void
13190 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 *).){. CollSeq
131a0 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 65 6e *pColl;. int en
131b0 63 32 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 c2;. . assert(
131c0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
131d0 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
131e0 3b 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 ;.. /* If SQLIT
131f0 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69 E_UTF16 is speci
13200 66 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f fied as the enco
13210 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 ding type, trans
13220 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 form this. ** t
13230 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f o one of SQLITE_
13240 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 UTF16LE or SQLIT
13250 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 E_UTF16BE using
13260 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f the. ** SQLITE_
13270 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 UTF16NATIVE macr
13280 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 o. SQLITE_UTF16
13290 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 is not used inte
132a0 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 rnally.. */. e
132b0 6e 63 32 20 3d 20 65 6e 63 3b 0a 20 20 74 65 73 nc2 = enc;. tes
132c0 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c tcase( enc2==SQL
132d0 49 54 45 5f 55 54 46 31 36 20 29 3b 0a 20 20 74 ITE_UTF16 );. t
132e0 65 73 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 estcase( enc2==S
132f0 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 QLITE_UTF16_ALIG
13300 4e 45 44 20 29 3b 0a 20 20 69 66 28 20 65 6e 63 NED );. if( enc
13310 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 2==SQLITE_UTF16
13320 7c 7c 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f || enc2==SQLITE_
13330 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 7b UTF16_ALIGNED ){
13340 0a 20 20 20 20 65 6e 63 32 20 3d 20 53 51 4c 49 . enc2 = SQLI
13350 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a TE_UTF16NATIVE;.
13360 20 20 7d 0a 20 20 69 66 28 20 65 6e 63 32 3c 53 }. if( enc2<S
13370 51 4c 49 54 45 5f 55 54 46 38 20 7c 7c 20 65 6e QLITE_UTF8 || en
13380 63 32 3e 53 51 4c 49 54 45 5f 55 54 46 31 36 42 c2>SQLITE_UTF16B
13390 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 E ){. return
133a0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
133b0 50 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 PT;. }.. /* Ch
133c0 65 63 6b 20 69 66 20 74 68 69 73 20 63 61 6c 6c eck if this call
133d0 20 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f 72 20 is removing or
133e0 72 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 78 69 replacing an exi
133f0 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 sting collation
13400 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 2e 20 . ** sequence.
13410 49 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 72 65 If so, and there
13420 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c are active VMs,
13430 20 72 65 74 75 72 6e 20 62 75 73 79 2e 20 49 66 return busy. If
13440 20 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 65 20 there. ** are
13450 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 2c 20 69 no active VMs, i
13460 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 70 72 nvalidate any pr
13470 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 e-compiled state
13480 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 43 ments.. */. pC
13490 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e oll = sqlite3Fin
134a0 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 dCollSeq(db, (u8
134b0 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 30 29 )enc2, zName, 0)
134c0 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 26 ;. if( pColl &&
134d0 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a pColl->xCmp ){.
134e0 20 20 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 if( db->nVdb
134f0 65 41 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 eActive ){.
13500 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 sqlite3ErrorWit
13510 68 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f hMsg(db, SQLITE_
13520 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
13530 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 unable to delete
13540 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f /modify collatio
13550 6e 20 73 65 71 75 65 6e 63 65 20 64 75 65 20 74 n sequence due t
13560 6f 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 o active stateme
13570 6e 74 73 22 29 3b 0a 20 20 20 20 20 20 72 65 74 nts");. ret
13580 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
13590 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
135a0 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64 e3ExpirePrepared
135b0 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a Statements(db);.
135c0 0a 20 20 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 . /* If colla
135d0 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 70 43 tion sequence pC
135e0 6f 6c 6c 20 77 61 73 20 63 72 65 61 74 65 64 20 oll was created
135f0 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 61 directly by a ca
13600 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c ll to. ** sql
13610 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
13620 61 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 ation, and not g
13630 65 6e 65 72 61 74 65 64 20 62 79 20 73 79 6e 74 enerated by synt
13640 68 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 hCollSeq(),.
13650 2a 2a 20 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 ** then any copi
13660 65 73 20 6d 61 64 65 20 62 79 20 73 79 6e 74 68 es made by synth
13670 43 6f 6c 6c 53 65 71 28 29 20 6e 65 65 64 20 74 CollSeq() need t
13680 6f 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 o be invalidated
13690 2e 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 .. ** Also, c
136a0 6f 6c 6c 61 74 69 6f 6e 20 64 65 73 74 72 75 63 ollation destruc
136b0 74 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 tor - CollSeq.xD
136c0 65 6c 28 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 el() - function
136d0 6d 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 may need. **
136e0 74 6f 20 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 to be called..
136f0 20 20 2a 2f 20 0a 20 20 20 20 69 66 28 20 28 70 */ . if( (p
13700 43 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c Coll->enc & ~SQL
13710 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 ITE_UTF16_ALIGNE
13720 44 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 D)==enc2 ){.
13730 20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c CollSeq *aColl
13740 20 3d 20 73 71 6c 69 74 65 33 48 61 73 68 46 69 = sqlite3HashFi
13750 6e 64 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 nd(&db->aCollSeq
13760 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 , zName);.
13770 69 6e 74 20 6a 3b 0a 20 20 20 20 20 20 66 6f 72 int j;. for
13780 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b (j=0; j<3; j++){
13790 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 . CollSeq
137a0 20 2a 70 20 3d 20 26 61 43 6f 6c 6c 5b 6a 5d 3b *p = &aColl[j];
137b0 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e . if( p->
137c0 65 6e 63 3d 3d 70 43 6f 6c 6c 2d 3e 65 6e 63 20 enc==pColl->enc
137d0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 ){. if(
137e0 20 70 2d 3e 78 44 65 6c 20 29 7b 0a 20 20 20 20 p->xDel ){.
137f0 20 20 20 20 20 20 20 20 70 2d 3e 78 44 65 6c 28 p->xDel(
13800 70 2d 3e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 p->pUser);.
13810 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
13820 20 70 2d 3e 78 43 6d 70 20 3d 20 30 3b 0a 20 20 p->xCmp = 0;.
13830 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
13840 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 43 6f }. }.. pCo
13850 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 ll = sqlite3Find
13860 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 CollSeq(db, (u8)
13870 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 31 29 3b enc2, zName, 1);
13880 0a 20 20 69 66 28 20 70 43 6f 6c 6c 3d 3d 30 20 . if( pColl==0
13890 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
138a0 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 70 43 NOMEM_BKPT;. pC
138b0 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d oll->xCmp = xCom
138c0 70 61 72 65 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 70 pare;. pColl->p
138d0 55 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 70 User = pCtx;. p
138e0 43 6f 6c 6c 2d 3e 78 44 65 6c 20 3d 20 78 44 65 Coll->xDel = xDe
138f0 6c 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 l;. pColl->enc
13900 3d 20 28 75 38 29 28 65 6e 63 32 20 7c 20 28 65 = (u8)(enc2 | (e
13910 6e 63 20 26 20 53 51 4c 49 54 45 5f 55 54 46 31 nc & SQLITE_UTF1
13920 36 5f 41 4c 49 47 4e 45 44 29 29 3b 0a 20 20 73 6_ALIGNED));. s
13930 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
13940 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 72 65 SQLITE_OK);. re
13950 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
13960 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 61 }.../*.** This a
13970 72 72 61 79 20 64 65 66 69 6e 65 73 20 68 61 72 rray defines har
13980 64 20 75 70 70 65 72 20 62 6f 75 6e 64 73 20 6f d upper bounds o
13990 6e 20 6c 69 6d 69 74 20 76 61 6c 75 65 73 2e 20 n limit values.
139a0 20 54 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 The.** initiali
139b0 7a 65 72 20 6d 75 73 74 20 62 65 20 6b 65 70 74 zer must be kept
139c0 20 69 6e 20 73 79 6e 63 20 77 69 74 68 20 74 68 in sync with th
139d0 65 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 2a e SQLITE_LIMIT_*
139e0 0a 2a 2a 20 23 64 65 66 69 6e 65 73 20 69 6e 20 .** #defines in
139f0 73 71 6c 69 74 65 33 2e 68 2e 0a 2a 2f 0a 73 74 sqlite3.h..*/.st
13a00 61 74 69 63 20 63 6f 6e 73 74 20 69 6e 74 20 61 atic const int a
13a10 48 61 72 64 4c 69 6d 69 74 5b 5d 20 3d 20 7b 0a HardLimit[] = {.
13a20 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e SQLITE_MAX_LEN
13a30 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 GTH,. SQLITE_MA
13a40 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 2c 0a 20 20 X_SQL_LENGTH,.
13a50 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d SQLITE_MAX_COLUM
13a60 4e 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f N,. SQLITE_MAX_
13a70 45 58 50 52 5f 44 45 50 54 48 2c 0a 20 20 53 51 EXPR_DEPTH,. SQ
13a80 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e LITE_MAX_COMPOUN
13a90 44 5f 53 45 4c 45 43 54 2c 0a 20 20 53 51 4c 49 D_SELECT,. SQLI
13aa0 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 2c 0a TE_MAX_VDBE_OP,.
13ab0 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e SQLITE_MAX_FUN
13ac0 43 54 49 4f 4e 5f 41 52 47 2c 0a 20 20 53 51 4c CTION_ARG,. SQL
13ad0 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
13ae0 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c ,. SQLITE_MAX_L
13af0 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
13b00 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 TH,. SQLITE_MAX
13b10 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 _VARIABLE_NUMBER
13b20 2c 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 , /* IMP: R
13b30 2d 33 38 30 39 31 2d 33 32 33 35 32 20 2a 2f 0a -38091-32352 */.
13b40 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 SQLITE_MAX_TRI
13b50 47 47 45 52 5f 44 45 50 54 48 2c 0a 20 20 53 51 GGER_DEPTH,. SQ
13b60 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f LITE_MAX_WORKER_
13b70 54 48 52 45 41 44 53 2c 0a 7d 3b 0a 0a 2f 2a 0a THREADS,.};../*.
13b80 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 ** Make sure the
13b90 20 68 61 72 64 20 6c 69 6d 69 74 73 20 61 72 65 hard limits are
13ba0 20 73 65 74 20 74 6f 20 72 65 61 73 6f 6e 61 62 set to reasonab
13bb0 6c 65 20 76 61 6c 75 65 73 0a 2a 2f 0a 23 69 66 le values.*/.#if
13bc0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 SQLITE_MAX_LENG
13bd0 54 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 TH<100.# error S
13be0 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 QLITE_MAX_LENGTH
13bf0 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 must be at leas
13c00 74 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 t 100.#endif.#if
13c10 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f SQLITE_MAX_SQL_
13c20 4c 45 4e 47 54 48 3c 31 30 30 0a 23 20 65 72 72 LENGTH<100.# err
13c30 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 or SQLITE_MAX_SQ
13c40 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 L_LENGTH must be
13c50 20 61 74 20 6c 65 61 73 74 20 31 30 30 0a 23 65 at least 100.#e
13c60 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
13c70 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 3e 53 MAX_SQL_LENGTH>S
13c80 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 QLITE_MAX_LENGTH
13c90 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
13ca0 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 6d MAX_SQL_LENGTH m
13cb0 75 73 74 20 6e 6f 74 20 62 65 20 67 72 65 61 74 ust not be great
13cc0 65 72 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4d er than SQLITE_M
13cd0 41 58 5f 4c 45 4e 47 54 48 0a 23 65 6e 64 69 66 AX_LENGTH.#endif
13ce0 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
13cf0 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 3c COMPOUND_SELECT<
13d00 32 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 2.# error SQLITE
13d10 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 _MAX_COMPOUND_SE
13d20 4c 45 43 54 20 6d 75 73 74 20 62 65 20 61 74 20 LECT must be at
13d30 6c 65 61 73 74 20 32 0a 23 65 6e 64 69 66 0a 23 least 2.#endif.#
13d40 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 if SQLITE_MAX_VD
13d50 42 45 5f 4f 50 3c 34 30 0a 23 20 65 72 72 6f 72 BE_OP<40.# error
13d60 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 SQLITE_MAX_VDBE
13d70 5f 4f 50 20 6d 75 73 74 20 62 65 20 61 74 20 6c _OP must be at l
13d80 65 61 73 74 20 34 30 0a 23 65 6e 64 69 66 0a 23 east 40.#endif.#
13d90 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 if SQLITE_MAX_FU
13da0 4e 43 54 49 4f 4e 5f 41 52 47 3c 30 20 7c 7c 20 NCTION_ARG<0 ||
13db0 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 SQLITE_MAX_FUNCT
13dc0 49 4f 4e 5f 41 52 47 3e 31 32 37 0a 23 20 65 72 ION_ARG>127.# er
13dd0 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 ror SQLITE_MAX_F
13de0 55 4e 43 54 49 4f 4e 5f 41 52 47 20 6d 75 73 74 UNCTION_ARG must
13df0 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e be between 0 an
13e00 64 20 31 32 37 0a 23 65 6e 64 69 66 0a 23 69 66 d 127.#endif.#if
13e10 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 SQLITE_MAX_ATTA
13e20 43 48 45 44 3c 30 20 7c 7c 20 53 51 4c 49 54 45 CHED<0 || SQLITE
13e30 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 31 32 _MAX_ATTACHED>12
13e40 35 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5.# error SQLITE
13e50 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 6d 75 _MAX_ATTACHED mu
13e60 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 st be between 0
13e70 61 6e 64 20 31 32 35 0a 23 65 6e 64 69 66 0a 23 and 125.#endif.#
13e80 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 if SQLITE_MAX_LI
13e90 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 KE_PATTERN_LENGT
13ea0 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 H<1.# error SQLI
13eb0 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 TE_MAX_LIKE_PATT
13ec0 45 52 4e 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 ERN_LENGTH must
13ed0 62 65 20 61 74 20 6c 65 61 73 74 20 31 0a 23 65 be at least 1.#e
13ee0 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
13ef0 4d 41 58 5f 43 4f 4c 55 4d 4e 3e 33 32 37 36 37 MAX_COLUMN>32767
13f00 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
13f10 4d 41 58 5f 43 4f 4c 55 4d 4e 20 6d 75 73 74 20 MAX_COLUMN must
13f20 6e 6f 74 20 65 78 63 65 65 64 20 33 32 37 36 37 not exceed 32767
13f30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
13f40 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 TE_MAX_TRIGGER_D
13f50 45 50 54 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 EPTH<1.# error S
13f60 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 QLITE_MAX_TRIGGE
13f70 52 5f 44 45 50 54 48 20 6d 75 73 74 20 62 65 20 R_DEPTH must be
13f80 61 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 at least 1.#endi
13f90 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 f.#if SQLITE_MAX
13fa0 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3c _WORKER_THREADS<
13fb0 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 0 || SQLITE_MAX_
13fc0 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3e 35 WORKER_THREADS>5
13fd0 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 0.# error SQLITE
13fe0 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
13ff0 41 44 53 20 6d 75 73 74 20 62 65 20 62 65 74 77 ADS must be betw
14000 65 65 6e 20 30 20 61 6e 64 20 35 30 0a 23 65 6e een 0 and 50.#en
14010 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e dif.../*.** Chan
14020 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ge the value of
14030 61 20 6c 69 6d 69 74 2e 20 20 52 65 70 6f 72 74 a limit. Report
14040 20 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 2e 0a the old value..
14050 2a 2a 20 49 66 20 61 6e 20 69 6e 76 61 6c 69 64 ** If an invalid
14060 20 6c 69 6d 69 74 20 69 6e 64 65 78 20 69 73 20 limit index is
14070 73 75 70 70 6c 69 65 64 2c 20 72 65 70 6f 72 74 supplied, report
14080 20 2d 31 2e 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 -1..** Make no
14090 63 68 61 6e 67 65 73 20 62 75 74 20 73 74 69 6c changes but stil
140a0 6c 20 72 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 l report the old
140b0 20 76 61 6c 75 65 20 69 66 20 74 68 65 0a 2a 2a value if the.**
140c0 20 6e 65 77 20 6c 69 6d 69 74 20 69 73 20 6e 65 new limit is ne
140d0 67 61 74 69 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 gative..**.** A
140e0 6e 65 77 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 new lower limit
140f0 64 6f 65 73 20 6e 6f 74 20 73 68 72 69 6e 6b 20 does not shrink
14100 65 78 69 73 74 69 6e 67 20 63 6f 6e 73 74 72 75 existing constru
14110 63 74 73 2e 0a 2a 2a 20 49 74 20 6d 65 72 65 6c cts..** It merel
14120 79 20 70 72 65 76 65 6e 74 73 20 6e 65 77 20 63 y prevents new c
14130 6f 6e 73 74 72 75 63 74 73 20 74 68 61 74 20 65 onstructs that e
14140 78 63 65 65 64 20 74 68 65 20 6c 69 6d 69 74 0a xceed the limit.
14150 2a 2a 20 66 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e ** from forming.
14160 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
14170 6c 69 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 limit(sqlite3 *d
14180 62 2c 20 69 6e 74 20 6c 69 6d 69 74 49 64 2c 20 b, int limitId,
14190 69 6e 74 20 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 int newLimit){.
141a0 20 69 6e 74 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a int oldLimit;..
141b0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
141c0 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
141d0 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
141e0 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
141f0 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
14200 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
14210 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 return -1;.
14220 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
14230 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 EVIDENCE-OF: R-3
14240 30 31 38 39 2d 35 34 30 39 37 20 46 6f 72 20 65 0189-54097 For e
14250 61 63 68 20 6c 69 6d 69 74 20 63 61 74 65 67 6f ach limit catego
14260 72 79 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f ry SQLITE_LIMIT_
14270 4e 41 4d 45 0a 20 20 2a 2a 20 74 68 65 72 65 20 NAME. ** there
14280 69 73 20 61 20 68 61 72 64 20 75 70 70 65 72 20 is a hard upper
14290 62 6f 75 6e 64 20 73 65 74 20 61 74 20 63 6f 6d bound set at com
142a0 70 69 6c 65 2d 74 69 6d 65 20 62 79 20 61 20 43 pile-time by a C
142b0 20 70 72 65 70 72 6f 63 65 73 73 6f 72 0a 20 20 preprocessor.
142c0 2a 2a 20 6d 61 63 72 6f 20 63 61 6c 6c 65 64 20 ** macro called
142d0 53 51 4c 49 54 45 5f 4d 41 58 5f 4e 41 4d 45 2e SQLITE_MAX_NAME.
142e0 20 28 54 68 65 20 22 5f 4c 49 4d 49 54 5f 22 20 (The "_LIMIT_"
142f0 69 6e 20 74 68 65 20 6e 61 6d 65 20 69 73 20 63 in the name is c
14300 68 61 6e 67 65 64 20 74 6f 0a 20 20 2a 2a 20 22 hanged to. ** "
14310 5f 4d 41 58 5f 22 2e 29 0a 20 20 2a 2f 0a 20 20 _MAX_".). */.
14320 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14330 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14340 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c 49 54 45 5f LENGTH]==SQLITE_
14350 4d 41 58 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 MAX_LENGTH );.
14360 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14370 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14380 53 51 4c 5f 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c SQL_LENGTH]==SQL
14390 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
143a0 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
143b0 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
143c0 45 5f 4c 49 4d 49 54 5f 43 4f 4c 55 4d 4e 5d 3d E_LIMIT_COLUMN]=
143d0 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 =SQLITE_MAX_COLU
143e0 4d 4e 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 MN );. assert(
143f0 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
14400 45 5f 4c 49 4d 49 54 5f 45 58 50 52 5f 44 45 50 E_LIMIT_EXPR_DEP
14410 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f TH]==SQLITE_MAX_
14420 45 58 50 52 5f 44 45 50 54 48 20 29 3b 0a 20 20 EXPR_DEPTH );.
14430 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14440 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14450 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 5d COMPOUND_SELECT]
14460 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d ==SQLITE_MAX_COM
14470 50 4f 55 4e 44 5f 53 45 4c 45 43 54 29 3b 0a 20 POUND_SELECT);.
14480 20 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 assert( aHardLi
14490 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 mit[SQLITE_LIMIT
144a0 5f 56 44 42 45 5f 4f 50 5d 3d 3d 53 51 4c 49 54 _VDBE_OP]==SQLIT
144b0 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 20 29 3b E_MAX_VDBE_OP );
144c0 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
144d0 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
144e0 49 54 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d IT_FUNCTION_ARG]
144f0 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e ==SQLITE_MAX_FUN
14500 43 54 49 4f 4e 5f 41 52 47 20 29 3b 0a 20 20 61 CTION_ARG );. a
14510 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
14520 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 41 t[SQLITE_LIMIT_A
14530 54 54 41 43 48 45 44 5d 3d 3d 53 51 4c 49 54 45 TTACHED]==SQLITE
14540 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 29 3b _MAX_ATTACHED );
14550 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
14560 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
14570 49 54 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f IT_LIKE_PATTERN_
14580 4c 45 4e 47 54 48 5d 3d 3d 0a 20 20 20 20 20 20 LENGTH]==.
14590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
145a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
145b0 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
145c0 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e MAX_LIKE_PATTERN
145d0 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 _LENGTH );. ass
145e0 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
145f0 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 56 41 52 SQLITE_LIMIT_VAR
14600 49 41 42 4c 45 5f 4e 55 4d 42 45 52 5d 3d 3d 53 IABLE_NUMBER]==S
14610 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 QLITE_MAX_VARIAB
14620 4c 45 5f 4e 55 4d 42 45 52 29 3b 0a 20 20 61 73 LE_NUMBER);. as
14630 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 sert( aHardLimit
14640 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 54 52 [SQLITE_LIMIT_TR
14650 49 47 47 45 52 5f 44 45 50 54 48 5d 3d 3d 53 51 IGGER_DEPTH]==SQ
14660 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 LITE_MAX_TRIGGER
14670 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 _DEPTH );. asse
14680 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
14690 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b QLITE_LIMIT_WORK
146a0 45 52 5f 54 48 52 45 41 44 53 5d 3d 3d 53 51 4c ER_THREADS]==SQL
146b0 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
146c0 48 52 45 41 44 53 20 29 3b 0a 20 20 61 73 73 65 HREADS );. asse
146d0 72 74 28 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 rt( SQLITE_LIMIT
146e0 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3d _WORKER_THREADS=
146f0 3d 28 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 =(SQLITE_N_LIMIT
14700 2d 31 29 20 29 3b 0a 0a 0a 20 20 69 66 28 20 6c -1) );... if( l
14710 69 6d 69 74 49 64 3c 30 20 7c 7c 20 6c 69 6d 69 imitId<0 || limi
14720 74 49 64 3e 3d 53 51 4c 49 54 45 5f 4e 5f 4c 49 tId>=SQLITE_N_LI
14730 4d 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72 MIT ){. retur
14740 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 6f 6c 64 4c n -1;. }. oldL
14750 69 6d 69 74 20 3d 20 64 62 2d 3e 61 4c 69 6d 69 imit = db->aLimi
14760 74 5b 6c 69 6d 69 74 49 64 5d 3b 0a 20 20 69 66 t[limitId];. if
14770 28 20 6e 65 77 4c 69 6d 69 74 3e 3d 30 20 29 7b ( newLimit>=0 ){
14780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14790 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 32 34 /* IMP: R-524
147a0 37 36 2d 32 38 37 33 32 20 2a 2f 0a 20 20 20 20 76-28732 */.
147b0 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 61 48 61 if( newLimit>aHa
147c0 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d rdLimit[limitId]
147d0 20 29 7b 0a 20 20 20 20 20 20 6e 65 77 4c 69 6d ){. newLim
147e0 69 74 20 3d 20 61 48 61 72 64 4c 69 6d 69 74 5b it = aHardLimit[
147f0 6c 69 6d 69 74 49 64 5d 3b 20 20 2f 2a 20 49 4d limitId]; /* IM
14800 50 3a 20 52 2d 35 31 34 36 33 2d 32 35 36 33 34 P: R-51463-25634
14810 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 */. }. db
14820 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 ->aLimit[limitId
14830 5d 20 3d 20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 ] = newLimit;.
14840 7d 0a 20 20 72 65 74 75 72 6e 20 6f 6c 64 4c 69 }. return oldLi
14850 6d 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 mit;
14860 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a /* IMP:
14870 20 52 2d 35 33 33 34 31 2d 33 35 34 31 39 20 2a R-53341-35419 *
14880 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 /.}../*.** This
14890 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 function is used
148a0 20 74 6f 20 70 61 72 73 65 20 62 6f 74 68 20 55 to parse both U
148b0 52 49 73 20 61 6e 64 20 6e 6f 6e 2d 55 52 49 20 RIs and non-URI
148c0 66 69 6c 65 6e 61 6d 65 73 20 70 61 73 73 65 64 filenames passed
148d0 20 62 79 20 74 68 65 0a 2a 2a 20 75 73 65 72 20 by the.** user
148e0 74 6f 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 to API functions
148f0 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 sqlite3_open()
14900 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f or sqlite3_open_
14910 76 32 28 29 2c 20 61 6e 64 20 66 6f 72 20 64 61 v2(), and for da
14920 74 61 62 61 73 65 0a 2a 2a 20 55 52 49 73 20 73 tabase.** URIs s
14930 70 65 63 69 66 69 65 64 20 61 73 20 70 61 72 74 pecified as part
14940 20 6f 66 20 41 54 54 41 43 48 20 73 74 61 74 65 of ATTACH state
14950 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ments..**.** The
14960 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 first argument
14970 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e to this function
14980 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 is the name of
14990 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 20 28 the VFS to use (
149a0 6f 72 0a 2a 2a 20 61 20 4e 55 4c 4c 20 74 6f 20 or.** a NULL to
149b0 73 69 67 6e 69 66 79 20 74 68 65 20 64 65 66 61 signify the defa
149c0 75 6c 74 20 56 46 53 29 20 69 66 20 74 68 65 20 ult VFS) if the
149d0 55 52 49 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e URI does not con
149e0 74 61 69 6e 20 61 20 22 76 66 73 3d 78 78 78 22 tain a "vfs=xxx"
149f0 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 61 6d 65 .** query parame
14a00 74 65 72 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 ter. The second
14a10 61 72 67 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e argument contain
14a20 73 20 74 68 65 20 55 52 49 20 28 6f 72 20 6e 6f s the URI (or no
14a30 6e 2d 55 52 49 20 66 69 6c 65 6e 61 6d 65 29 0a n-URI filename).
14a40 2a 2a 20 69 74 73 65 6c 66 2e 20 57 68 65 6e 20 ** itself. When
14a50 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
14a60 20 63 61 6c 6c 65 64 20 74 68 65 20 2a 70 46 6c called the *pFl
14a70 61 67 73 20 76 61 72 69 61 62 6c 65 20 73 68 6f ags variable sho
14a80 75 6c 64 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 74 uld contain.** t
14a90 68 65 20 64 65 66 61 75 6c 74 20 66 6c 61 67 73 he default flags
14aa0 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 61 74 to open the dat
14ab0 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 69 74 abase handle wit
14ac0 68 2e 20 54 68 65 20 76 61 6c 75 65 20 73 74 6f h. The value sto
14ad0 72 65 64 20 69 6e 0a 2a 2a 20 2a 70 46 6c 61 67 red in.** *pFlag
14ae0 73 20 6d 61 79 20 62 65 20 75 70 64 61 74 65 64 s may be updated
14af0 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
14b00 67 20 69 66 20 74 68 65 20 55 52 49 20 66 69 6c g if the URI fil
14b10 65 6e 61 6d 65 20 63 6f 6e 74 61 69 6e 73 20 0a ename contains .
14b20 2a 2a 20 22 63 61 63 68 65 3d 78 78 78 22 20 6f ** "cache=xxx" o
14b30 72 20 22 6d 6f 64 65 3d 78 78 78 22 20 71 75 65 r "mode=xxx" que
14b40 72 79 20 70 61 72 61 6d 65 74 65 72 73 2e 0a 2a ry parameters..*
14b50 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 *.** If successf
14b60 75 6c 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 ul, SQLITE_OK is
14b70 20 72 65 74 75 72 6e 65 64 2e 20 49 6e 20 74 68 returned. In th
14b80 69 73 20 63 61 73 65 20 2a 70 70 56 66 73 20 69 is case *ppVfs i
14b90 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 s set to point t
14ba0 6f 0a 2a 2a 20 74 68 65 20 56 46 53 20 74 68 61 o.** the VFS tha
14bb0 74 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 t should be used
14bc0 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 61 74 to open the dat
14bd0 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 70 7a 46 abase file. *pzF
14be0 69 6c 65 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a ile is set to.**
14bf0 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 point to a buff
14c00 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 er containing th
14c10 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 e name of the fi
14c20 6c 65 20 74 6f 20 6f 70 65 6e 2e 20 49 74 20 69 le to open. It i
14c30 73 20 74 68 65 20 0a 2a 2a 20 72 65 73 70 6f 6e s the .** respon
14c40 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 sibility of the
14c50 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 caller to eventu
14c60 61 6c 6c 79 20 63 61 6c 6c 20 73 71 6c 69 74 65 ally call sqlite
14c70 33 5f 66 72 65 65 28 29 20 74 6f 20 72 65 6c 65 3_free() to rele
14c80 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 ase.** this buff
14c90 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 er..**.** If an
14ca0 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
14cb0 65 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 en an SQLite err
14cc0 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
14cd0 6e 65 64 20 61 6e 64 20 2a 70 7a 45 72 72 4d 73 ned and *pzErrMs
14ce0 67 0a 2a 2a 20 6d 61 79 20 62 65 20 73 65 74 20 g.** may be set
14cf0 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 to point to a bu
14d00 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ffer containing
14d10 61 6e 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 an English langu
14d20 61 67 65 20 65 72 72 6f 72 20 0a 2a 2a 20 6d 65 age error .** me
14d30 73 73 61 67 65 2e 20 49 74 20 69 73 20 74 68 65 ssage. It is the
14d40 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 responsibility
14d50 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f of the caller to
14d60 20 65 76 65 6e 74 75 61 6c 6c 79 20 72 65 6c 65 eventually rele
14d70 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 ase.** this buff
14d80 65 72 20 62 79 20 63 61 6c 6c 69 6e 67 20 73 71 er by calling sq
14d90 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2f lite3_free()..*/
14da0 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 .int sqlite3Pars
14db0 65 55 72 69 28 0a 20 20 63 6f 6e 73 74 20 63 68 eUri(. const ch
14dc0 61 72 20 2a 7a 44 65 66 61 75 6c 74 56 66 73 2c ar *zDefaultVfs,
14dd0 20 20 20 20 20 20 20 20 2f 2a 20 56 46 53 20 74 /* VFS t
14de0 6f 20 75 73 65 20 69 66 20 6e 6f 20 22 76 66 73 o use if no "vfs
14df0 3d 78 78 78 22 20 71 75 65 72 79 20 6f 70 74 69 =xxx" query opti
14e00 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 on */. const ch
14e10 61 72 20 2a 7a 55 72 69 2c 20 20 20 20 20 20 20 ar *zUri,
14e20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6c 2d 74 /* Nul-t
14e30 65 72 6d 69 6e 61 74 65 64 20 55 52 49 20 74 6f erminated URI to
14e40 20 70 61 72 73 65 20 2a 2f 0a 20 20 75 6e 73 69 parse */. unsi
14e50 67 6e 65 64 20 69 6e 74 20 2a 70 46 6c 61 67 73 gned int *pFlags
14e60 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 , /* I
14e70 4e 2f 4f 55 54 3a 20 53 51 4c 49 54 45 5f 4f 50 N/OUT: SQLITE_OP
14e80 45 4e 5f 58 58 58 20 66 6c 61 67 73 20 2a 2f 0a EN_XXX flags */.
14e90 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2a sqlite3_vfs **
14ea0 70 70 56 66 73 2c 20 20 20 20 20 20 20 20 20 20 ppVfs,
14eb0 20 20 2f 2a 20 4f 55 54 3a 20 56 46 53 20 74 6f /* OUT: VFS to
14ec0 20 75 73 65 20 2a 2f 20 0a 20 20 63 68 61 72 20 use */ . char
14ed0 2a 2a 70 7a 46 69 6c 65 2c 20 20 20 20 20 20 20 **pzFile,
14ee0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
14ef0 54 3a 20 46 69 6c 65 6e 61 6d 65 20 63 6f 6d 70 T: Filename comp
14f00 6f 6e 65 6e 74 20 6f 66 20 55 52 49 20 2a 2f 0a onent of URI */.
14f10 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 char **pzErrMs
14f20 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g
14f30 20 20 2f 2a 20 4f 55 54 3a 20 45 72 72 6f 72 20 /* OUT: Error
14f40 6d 65 73 73 61 67 65 20 28 69 66 20 72 63 21 3d message (if rc!=
14f50 53 51 4c 49 54 45 5f 4f 4b 29 20 2a 2f 0a 29 7b SQLITE_OK) */.){
14f60 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
14f70 54 45 5f 4f 4b 3b 0a 20 20 75 6e 73 69 67 6e 65 TE_OK;. unsigne
14f80 64 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 2a 70 d int flags = *p
14f90 46 6c 61 67 73 3b 0a 20 20 63 6f 6e 73 74 20 63 Flags;. const c
14fa0 68 61 72 20 2a 7a 56 66 73 20 3d 20 7a 44 65 66 har *zVfs = zDef
14fb0 61 75 6c 74 56 66 73 3b 0a 20 20 63 68 61 72 20 aultVfs;. char
14fc0 2a 7a 46 69 6c 65 3b 0a 20 20 63 68 61 72 20 63 *zFile;. char c
14fd0 3b 0a 20 20 69 6e 74 20 6e 55 72 69 20 3d 20 73 ;. int nUri = s
14fe0 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
14ff0 55 72 69 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 Uri);.. assert(
15000 20 2a 70 7a 45 72 72 4d 73 67 3d 3d 30 20 29 3b *pzErrMsg==0 );
15010 0a 0a 20 20 69 66 28 20 28 28 66 6c 61 67 73 20 .. if( ((flags
15020 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 & SQLITE_OPEN_UR
15030 49 29 20 20 20 20 20 20 20 20 20 20 20 20 20 2f I) /
15040 2a 20 49 4d 50 3a 20 52 2d 34 38 37 32 35 2d 33 * IMP: R-48725-3
15050 32 32 30 36 20 2a 2f 0a 20 20 20 20 20 20 20 20 2206 */.
15060 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c || sqlite3Gl
15070 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4f 70 65 6e obalConfig.bOpen
15080 55 72 69 29 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 Uri) /* IMP: R-5
15090 31 36 38 39 2d 34 36 35 34 38 20 2a 2f 0a 20 20 1689-46548 */.
150a0 20 26 26 20 6e 55 72 69 3e 3d 35 20 26 26 20 6d && nUri>=5 && m
150b0 65 6d 63 6d 70 28 7a 55 72 69 2c 20 22 66 69 6c emcmp(zUri, "fil
150c0 65 3a 22 2c 20 35 29 3d 3d 30 20 2f 2a 20 49 4d e:", 5)==0 /* IM
150d0 50 3a 20 52 2d 35 37 38 38 34 2d 33 37 34 39 36 P: R-57884-37496
150e0 20 2a 2f 0a 20 20 29 7b 0a 20 20 20 20 63 68 61 */. ){. cha
150f0 72 20 2a 7a 4f 70 74 3b 0a 20 20 20 20 69 6e 74 r *zOpt;. int
15100 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 20 20 eState;
15110 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
15120 72 73 65 72 20 73 74 61 74 65 20 77 68 65 6e 20 rser state when
15130 70 61 72 73 69 6e 67 20 55 52 49 20 2a 2f 0a 20 parsing URI */.
15140 20 20 20 69 6e 74 20 69 49 6e 3b 20 20 20 20 20 int iIn;
15150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15160 20 2f 2a 20 49 6e 70 75 74 20 63 68 61 72 61 63 /* Input charac
15170 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 ter index */.
15180 20 69 6e 74 20 69 4f 75 74 20 3d 20 30 3b 20 20 int iOut = 0;
15190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
151a0 2a 20 4f 75 74 70 75 74 20 63 68 61 72 61 63 74 * Output charact
151b0 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 er index */.
151c0 75 36 34 20 6e 42 79 74 65 20 3d 20 6e 55 72 69 u64 nByte = nUri
151d0 2b 32 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a +2; /*
151e0 20 42 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 Bytes of space
151f0 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 0a to allocate */..
15200 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 /* Make sure
15210 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 50 45 4e the SQLITE_OPEN
15220 5f 55 52 49 20 66 6c 61 67 20 69 73 20 73 65 74 _URI flag is set
15230 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 6f 20 to indicate to
15240 74 68 65 20 56 46 53 20 78 4f 70 65 6e 20 0a 20 the VFS xOpen .
15250 20 20 20 2a 2a 20 6d 65 74 68 6f 64 20 74 68 61 ** method tha
15260 74 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 65 t there may be e
15270 78 74 72 61 20 70 61 72 61 6d 65 74 65 72 73 20 xtra parameters
15280 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 66 69 following the fi
15290 6c 65 2d 6e 61 6d 65 2e 20 20 2a 2f 0a 20 20 20 le-name. */.
152a0 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 flags |= SQLITE
152b0 5f 4f 50 45 4e 5f 55 52 49 3b 0a 0a 20 20 20 20 _OPEN_URI;..
152c0 66 6f 72 28 69 49 6e 3d 30 3b 20 69 49 6e 3c 6e for(iIn=0; iIn<n
152d0 55 72 69 3b 20 69 49 6e 2b 2b 29 20 6e 42 79 74 Uri; iIn++) nByt
152e0 65 20 2b 3d 20 28 7a 55 72 69 5b 69 49 6e 5d 3d e += (zUri[iIn]=
152f0 3d 27 26 27 29 3b 0a 20 20 20 20 7a 46 69 6c 65 ='&');. zFile
15300 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f = sqlite3_mallo
15310 63 36 34 28 6e 42 79 74 65 29 3b 0a 20 20 20 20 c64(nByte);.
15320 69 66 28 20 21 7a 46 69 6c 65 20 29 20 72 65 74 if( !zFile ) ret
15330 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
15340 5f 42 4b 50 54 3b 0a 0a 20 20 20 20 69 49 6e 20 _BKPT;.. iIn
15350 3d 20 35 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 = 5;.#ifdef SQLI
15360 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54 TE_ALLOW_URI_AUT
15370 48 4f 52 49 54 59 0a 20 20 20 20 69 66 28 20 73 HORITY. if( s
15380 74 72 6e 63 6d 70 28 7a 55 72 69 2b 35 2c 20 22 trncmp(zUri+5, "
15390 2f 2f 2f 22 2c 20 33 29 3d 3d 30 20 29 7b 0a 20 ///", 3)==0 ){.
153a0 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 iIn = 7;.
153b0 20 20 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f /* The follo
153c0 77 69 6e 67 20 63 6f 6e 64 69 74 69 6f 6e 20 63 wing condition c
153d0 61 75 73 65 73 20 55 52 49 73 20 77 69 74 68 20 auses URIs with
153e0 66 69 76 65 20 6c 65 61 64 69 6e 67 20 2f 20 63 five leading / c
153f0 68 61 72 61 63 74 65 72 73 0a 20 20 20 20 20 20 haracters.
15400 2a 2a 20 6c 69 6b 65 20 66 69 6c 65 3a 2f 2f 2f ** like file:///
15410 2f 2f 68 6f 73 74 2f 70 61 74 68 20 74 6f 20 62 //host/path to b
15420 65 20 63 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f e converted into
15430 20 55 4e 43 73 20 6c 69 6b 65 20 2f 2f 68 6f 73 UNCs like //hos
15440 74 2f 70 61 74 68 2e 0a 20 20 20 20 20 20 2a 2a t/path.. **
15450 20 54 68 65 20 63 6f 72 72 65 63 74 20 55 52 49 The correct URI
15460 20 66 6f 72 20 74 68 61 74 20 55 4e 43 20 68 61 for that UNC ha
15470 73 20 6f 6e 6c 79 20 74 77 6f 20 6f 72 20 66 6f s only two or fo
15480 75 72 20 6c 65 61 64 69 6e 67 20 2f 20 63 68 61 ur leading / cha
15490 72 61 63 74 65 72 73 0a 20 20 20 20 20 20 2a 2a racters. **
154a0 20 66 69 6c 65 3a 2f 2f 68 6f 73 74 2f 70 61 74 file://host/pat
154b0 68 20 6f 72 20 66 69 6c 65 3a 2f 2f 2f 2f 68 6f h or file:////ho
154c0 73 74 2f 70 61 74 68 2e 20 20 42 75 74 20 35 20 st/path. But 5
154d0 6c 65 61 64 69 6e 67 20 73 6c 61 73 68 65 73 20 leading slashes
154e0 69 73 20 61 20 0a 20 20 20 20 20 20 2a 2a 20 63 is a . ** c
154f0 6f 6d 6d 6f 6e 20 65 72 72 6f 72 2c 20 77 65 20 ommon error, we
15500 61 72 65 20 74 6f 6c 64 2c 20 73 6f 20 77 65 20 are told, so we
15510 68 61 6e 64 6c 65 20 69 74 20 61 73 20 61 20 73 handle it as a s
15520 70 65 63 69 61 6c 20 63 61 73 65 2e 20 2a 2f 0a pecial case. */.
15530 20 20 20 20 20 20 69 66 28 20 73 74 72 6e 63 6d if( strncm
15540 70 28 7a 55 72 69 2b 37 2c 20 22 2f 2f 2f 22 2c p(zUri+7, "///",
15550 20 33 29 3d 3d 30 20 29 7b 20 69 49 6e 2b 2b 3b 3)==0 ){ iIn++;
15560 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 }. }else if(
15570 20 73 74 72 6e 63 6d 70 28 7a 55 72 69 2b 35 2c strncmp(zUri+5,
15580 20 22 2f 2f 6c 6f 63 61 6c 68 6f 73 74 2f 22 2c "//localhost/",
15590 20 31 32 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 12)==0 ){.
155a0 20 69 49 6e 20 3d 20 31 36 3b 0a 20 20 20 20 7d iIn = 16;. }
155b0 0a 23 65 6c 73 65 0a 20 20 20 20 2f 2a 20 44 69 .#else. /* Di
155c0 73 63 61 72 64 20 74 68 65 20 73 63 68 65 6d 65 scard the scheme
155d0 20 61 6e 64 20 61 75 74 68 6f 72 69 74 79 20 73 and authority s
155e0 65 67 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 55 egments of the U
155f0 52 49 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 7a RI. */. if( z
15600 55 72 69 5b 35 5d 3d 3d 27 2f 27 20 26 26 20 7a Uri[5]=='/' && z
15610 55 72 69 5b 36 5d 3d 3d 27 2f 27 20 29 7b 0a 20 Uri[6]=='/' ){.
15620 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 iIn = 7;.
15630 20 20 20 20 77 68 69 6c 65 28 20 7a 55 72 69 5b while( zUri[
15640 69 49 6e 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e iIn] && zUri[iIn
15650 5d 21 3d 27 2f 27 20 29 20 69 49 6e 2b 2b 3b 0a ]!='/' ) iIn++;.
15660 20 20 20 20 20 20 69 66 28 20 69 49 6e 21 3d 37 if( iIn!=7
15670 20 26 26 20 28 69 49 6e 21 3d 31 36 20 7c 7c 20 && (iIn!=16 ||
15680 6d 65 6d 63 6d 70 28 22 6c 6f 63 61 6c 68 6f 73 memcmp("localhos
15690 74 22 2c 20 26 7a 55 72 69 5b 37 5d 2c 20 39 29 t", &zUri[7], 9)
156a0 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a ) ){. *pz
156b0 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 ErrMsg = sqlite3
156c0 5f 6d 70 72 69 6e 74 66 28 22 69 6e 76 61 6c 69 _mprintf("invali
156d0 64 20 75 72 69 20 61 75 74 68 6f 72 69 74 79 3a d uri authority:
156e0 20 25 2e 2a 73 22 2c 20 0a 20 20 20 20 20 20 20 %.*s", .
156f0 20 20 20 20 20 69 49 6e 2d 37 2c 20 26 7a 55 72 iIn-7, &zUr
15700 69 5b 37 5d 29 3b 0a 20 20 20 20 20 20 20 20 72 i[7]);. r
15710 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
15720 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 ;. goto p
15730 61 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 arse_uri_out;.
15740 20 20 20 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 }. }.#end
15750 69 66 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 if.. /* Copy
15760 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 6e 64 the filename and
15770 20 61 6e 79 20 71 75 65 72 79 20 70 61 72 61 6d any query param
15780 65 74 65 72 73 20 69 6e 74 6f 20 74 68 65 20 7a eters into the z
15790 46 69 6c 65 20 62 75 66 66 65 72 2e 20 0a 20 20 File buffer. .
157a0 20 20 2a 2a 20 44 65 63 6f 64 65 20 25 48 48 20 ** Decode %HH
157b0 65 73 63 61 70 65 20 63 6f 64 65 73 20 61 6c 6f escape codes alo
157c0 6e 67 20 74 68 65 20 77 61 79 2e 20 0a 20 20 20 ng the way. .
157d0 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 69 74 68 69 **. ** Withi
157e0 6e 20 74 68 69 73 20 6c 6f 6f 70 2c 20 76 61 72 n this loop, var
157f0 69 61 62 6c 65 20 65 53 74 61 74 65 20 6d 61 79 iable eState may
15800 20 62 65 20 73 65 74 20 74 6f 20 30 2c 20 31 20 be set to 0, 1
15810 6f 72 20 32 2c 20 64 65 70 65 6e 64 69 6e 67 0a or 2, depending.
15820 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 ** on the pa
15830 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 41 rsing context. A
15840 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 20 20 2a s follows:. *
15850 2a 0a 20 20 20 20 2a 2a 20 20 20 30 3a 20 50 61 *. ** 0: Pa
15860 72 73 69 6e 67 20 66 69 6c 65 2d 6e 61 6d 65 2e rsing file-name.
15870 0a 20 20 20 20 2a 2a 20 20 20 31 3a 20 50 61 72 . ** 1: Par
15880 73 69 6e 67 20 6e 61 6d 65 20 73 65 63 74 69 6f sing name sectio
15890 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 6c 75 n of a name=valu
158a0 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 e query paramete
158b0 72 2e 0a 20 20 20 20 2a 2a 20 20 20 32 3a 20 50 r.. ** 2: P
158c0 61 72 73 69 6e 67 20 76 61 6c 75 65 20 73 65 63 arsing value sec
158d0 74 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 tion of a name=v
158e0 61 6c 75 65 20 71 75 65 72 79 20 70 61 72 61 6d alue query param
158f0 65 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 eter.. */.
15900 20 65 53 74 61 74 65 20 3d 20 30 3b 0a 20 20 20 eState = 0;.
15910 20 77 68 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 while( (c = zUr
15920 69 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 i[iIn])!=0 && c!
15930 3d 27 23 27 20 29 7b 0a 20 20 20 20 20 20 69 49 ='#' ){. iI
15940 6e 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 63 n++;. if( c
15950 3d 3d 27 25 27 20 0a 20 20 20 20 20 20 20 26 26 =='%' . &&
15960 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 sqlite3Isxdigit
15970 28 7a 55 72 69 5b 69 49 6e 5d 29 20 0a 20 20 20 (zUri[iIn]) .
15980 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 49 73 && sqlite3Is
15990 78 64 69 67 69 74 28 7a 55 72 69 5b 69 49 6e 2b xdigit(zUri[iIn+
159a0 31 5d 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 1]) . ){.
159b0 20 20 20 20 20 20 69 6e 74 20 6f 63 74 65 74 20 int octet
159c0 3d 20 28 73 71 6c 69 74 65 33 48 65 78 54 6f 49 = (sqlite3HexToI
159d0 6e 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d 29 20 nt(zUri[iIn++])
159e0 3c 3c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 6f << 4);. o
159f0 63 74 65 74 20 2b 3d 20 73 71 6c 69 74 65 33 48 ctet += sqlite3H
15a00 65 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 49 6e exToInt(zUri[iIn
15a10 2b 2b 5d 29 3b 0a 0a 20 20 20 20 20 20 20 20 61 ++]);.. a
15a20 73 73 65 72 74 28 20 6f 63 74 65 74 3e 3d 30 20 ssert( octet>=0
15a30 26 26 20 6f 63 74 65 74 3c 32 35 36 20 29 3b 0a && octet<256 );.
15a40 20 20 20 20 20 20 20 20 69 66 28 20 6f 63 74 65 if( octe
15a50 74 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 t==0 ){.#ifndef
15a60 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 52 SQLITE_ENABLE_UR
15a70 49 5f 30 30 5f 45 52 52 4f 52 0a 20 20 20 20 20 I_00_ERROR.
15a80 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 /* This bra
15a90 6e 63 68 20 69 73 20 74 61 6b 65 6e 20 77 68 65 nch is taken whe
15aa0 6e 20 22 25 30 30 22 20 61 70 70 65 61 72 73 20 n "%00" appears
15ab0 77 69 74 68 69 6e 20 74 68 65 20 55 52 49 2e 20 within the URI.
15ac0 49 6e 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 In this.
15ad0 20 20 2a 2a 20 63 61 73 65 20 77 65 20 69 67 6e ** case we ign
15ae0 6f 72 65 20 61 6c 6c 20 74 65 78 74 20 69 6e 20 ore all text in
15af0 74 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 the remainder of
15b00 20 74 68 65 20 70 61 74 68 2c 20 6e 61 6d 65 20 the path, name
15b10 6f 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 or. **
15b20 76 61 6c 75 65 20 63 75 72 72 65 6e 74 6c 79 20 value currently
15b30 62 65 69 6e 67 20 70 61 72 73 65 64 2e 20 53 6f being parsed. So
15b40 20 69 67 6e 6f 72 65 20 74 68 65 20 63 75 72 72 ignore the curr
15b50 65 6e 74 20 63 68 61 72 61 63 74 65 72 0a 20 20 ent character.
15b60 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 73 ** and s
15b70 6b 69 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 kip to the next
15b80 22 3f 22 2c 20 22 3d 22 20 6f 72 20 22 26 22 2c "?", "=" or "&",
15b90 20 61 73 20 61 70 70 72 6f 70 72 69 61 74 65 2e as appropriate.
15ba0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 77 68 */. wh
15bb0 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 69 5b 69 ile( (c = zUri[i
15bc0 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 3d 27 23 In])!=0 && c!='#
15bd0 27 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ' .
15be0 20 26 26 20 28 65 53 74 61 74 65 21 3d 30 20 7c && (eState!=0 |
15bf0 7c 20 63 21 3d 27 3f 27 29 0a 20 20 20 20 20 20 | c!='?').
15c00 20 20 20 20 20 20 20 20 26 26 20 28 65 53 74 61 && (eSta
15c10 74 65 21 3d 31 20 7c 7c 20 28 63 21 3d 27 3d 27 te!=1 || (c!='='
15c20 20 26 26 20 63 21 3d 27 26 27 29 29 0a 20 20 20 && c!='&')).
15c30 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 65 && (e
15c40 53 74 61 74 65 21 3d 32 20 7c 7c 20 63 21 3d 27 State!=2 || c!='
15c50 26 27 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b &'). ){
15c60 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 49 6e . iIn
15c70 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ++;. }.
15c80 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e contin
15c90 75 65 3b 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 ue;.#else.
15ca0 20 20 20 20 2f 2a 20 49 66 20 45 4e 41 42 4c 45 /* If ENABLE
15cb0 5f 55 52 49 5f 30 30 5f 45 52 52 4f 52 20 69 73 _URI_00_ERROR is
15cc0 20 64 65 66 69 6e 65 64 2c 20 22 25 30 30 22 20 defined, "%00"
15cd0 69 6e 20 61 20 55 52 49 20 69 73 20 61 6e 20 65 in a URI is an e
15ce0 72 72 6f 72 2e 20 2a 2f 0a 20 20 20 20 20 20 20 rror. */.
15cf0 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
15d00 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
15d10 75 6e 65 78 70 65 63 74 65 64 20 25 25 30 30 20 unexpected %%00
15d20 69 6e 20 75 72 69 22 29 3b 0a 20 20 20 20 20 20 in uri");.
15d30 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
15d40 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 ERROR;.
15d50 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 5f goto parse_uri_
15d60 6f 75 74 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 out;.#endif.
15d70 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 63 20 }. c
15d80 3d 20 6f 63 74 65 74 3b 0a 20 20 20 20 20 20 7d = octet;. }
15d90 65 6c 73 65 20 69 66 28 20 65 53 74 61 74 65 3d else if( eState=
15da0 3d 31 20 26 26 20 28 63 3d 3d 27 26 27 20 7c 7c =1 && (c=='&' ||
15db0 20 63 3d 3d 27 3d 27 29 20 29 7b 0a 20 20 20 20 c=='=') ){.
15dc0 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b 69 4f if( zFile[iO
15dd0 75 74 2d 31 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 ut-1]==0 ){.
15de0 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 6d 70 74 /* An empt
15df0 79 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 2e 20 49 y option name. I
15e00 67 6e 6f 72 65 20 74 68 69 73 20 6f 70 74 69 6f gnore this optio
15e10 6e 20 61 6c 74 6f 67 65 74 68 65 72 2e 20 2a 2f n altogether. */
15e20 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 . while
15e30 28 20 7a 55 72 69 5b 69 49 6e 5d 20 26 26 20 7a ( zUri[iIn] && z
15e40 55 72 69 5b 69 49 6e 5d 21 3d 27 23 27 20 26 26 Uri[iIn]!='#' &&
15e50 20 7a 55 72 69 5b 69 49 6e 2d 31 5d 21 3d 27 26 zUri[iIn-1]!='&
15e60 27 20 29 20 69 49 6e 2b 2b 3b 0a 20 20 20 20 20 ' ) iIn++;.
15e70 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 continue;.
15e80 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
15e90 20 69 66 28 20 63 3d 3d 27 26 27 20 29 7b 0a 20 if( c=='&' ){.
15ea0 20 20 20 20 20 20 20 20 20 7a 46 69 6c 65 5b 69 zFile[i
15eb0 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 Out++] = '\0';.
15ec0 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
15ed0 20 20 20 20 20 20 20 20 65 53 74 61 74 65 20 3d eState =
15ee0 20 32 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 2;. }.
15ef0 20 20 20 20 20 20 63 20 3d 20 30 3b 0a 20 20 20 c = 0;.
15f00 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 65 53 }else if( (eS
15f10 74 61 74 65 3d 3d 30 20 26 26 20 63 3d 3d 27 3f tate==0 && c=='?
15f20 27 29 20 7c 7c 20 28 65 53 74 61 74 65 3d 3d 32 ') || (eState==2
15f30 20 26 26 20 63 3d 3d 27 26 27 29 20 29 7b 0a 20 && c=='&') ){.
15f40 20 20 20 20 20 20 20 63 20 3d 20 30 3b 0a 20 20 c = 0;.
15f50 20 20 20 20 20 20 65 53 74 61 74 65 20 3d 20 31 eState = 1
15f60 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
15f70 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 zFile[iOut++] =
15f80 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
15f90 20 65 53 74 61 74 65 3d 3d 31 20 29 20 7a 46 69 eState==1 ) zFi
15fa0 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 le[iOut++] = '\0
15fb0 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 ';. zFile[iOu
15fc0 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 t++] = '\0';.
15fd0 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d zFile[iOut++] =
15fe0 20 27 5c 30 27 3b 0a 0a 20 20 20 20 2f 2a 20 43 '\0';.. /* C
15ff0 68 65 63 6b 20 69 66 20 74 68 65 72 65 20 77 65 heck if there we
16000 72 65 20 61 6e 79 20 6f 70 74 69 6f 6e 73 20 73 re any options s
16010 70 65 63 69 66 69 65 64 20 74 68 61 74 20 73 68 pecified that sh
16020 6f 75 6c 64 20 62 65 20 69 6e 74 65 72 70 72 65 ould be interpre
16030 74 65 64 20 0a 20 20 20 20 2a 2a 20 68 65 72 65 ted . ** here
16040 2e 20 4f 70 74 69 6f 6e 73 20 74 68 61 74 20 61 . Options that a
16050 72 65 20 69 6e 74 65 72 70 72 65 74 65 64 20 68 re interpreted h
16060 65 72 65 20 69 6e 63 6c 75 64 65 20 22 76 66 73 ere include "vfs
16070 22 20 61 6e 64 20 74 68 6f 73 65 20 74 68 61 74 " and those that
16080 0a 20 20 20 20 2a 2a 20 63 6f 72 72 65 73 70 6f . ** correspo
16090 6e 64 20 74 6f 20 66 6c 61 67 73 20 74 68 61 74 nd to flags that
160a0 20 6d 61 79 20 62 65 20 70 61 73 73 65 64 20 74 may be passed t
160b0 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6f 70 o the sqlite3_op
160c0 65 6e 5f 76 32 28 29 0a 20 20 20 20 2a 2a 20 6d en_v2(). ** m
160d0 65 74 68 6f 64 2e 20 2a 2f 0a 20 20 20 20 7a 4f ethod. */. zO
160e0 70 74 20 3d 20 26 7a 46 69 6c 65 5b 73 71 6c 69 pt = &zFile[sqli
160f0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c te3Strlen30(zFil
16100 65 29 2b 31 5d 3b 0a 20 20 20 20 77 68 69 6c 65 e)+1];. while
16110 28 20 7a 4f 70 74 5b 30 5d 20 29 7b 0a 20 20 20 ( zOpt[0] ){.
16120 20 20 20 69 6e 74 20 6e 4f 70 74 20 3d 20 73 71 int nOpt = sq
16130 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4f lite3Strlen30(zO
16140 70 74 29 3b 0a 20 20 20 20 20 20 63 68 61 72 20 pt);. char
16150 2a 7a 56 61 6c 20 3d 20 26 7a 4f 70 74 5b 6e 4f *zVal = &zOpt[nO
16160 70 74 2b 31 5d 3b 0a 20 20 20 20 20 20 69 6e 74 pt+1];. int
16170 20 6e 56 61 6c 20 3d 20 73 71 6c 69 74 65 33 53 nVal = sqlite3S
16180 74 72 6c 65 6e 33 30 28 7a 56 61 6c 29 3b 0a 0a trlen30(zVal);..
16190 20 20 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d if( nOpt==
161a0 33 20 26 26 20 6d 65 6d 63 6d 70 28 22 76 66 73 3 && memcmp("vfs
161b0 22 2c 20 7a 4f 70 74 2c 20 33 29 3d 3d 30 20 29 ", zOpt, 3)==0 )
161c0 7b 0a 20 20 20 20 20 20 20 20 7a 56 66 73 20 3d {. zVfs =
161d0 20 7a 56 61 6c 3b 0a 20 20 20 20 20 20 7d 65 6c zVal;. }el
161e0 73 65 7b 0a 20 20 20 20 20 20 20 20 73 74 72 75 se{. stru
161f0 63 74 20 4f 70 65 6e 4d 6f 64 65 20 7b 0a 20 20 ct OpenMode {.
16200 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 const ch
16210 61 72 20 2a 7a 3b 0a 20 20 20 20 20 20 20 20 20 ar *z;.
16220 20 69 6e 74 20 6d 6f 64 65 3b 0a 20 20 20 20 20 int mode;.
16230 20 20 20 7d 20 2a 61 4d 6f 64 65 20 3d 20 30 3b } *aMode = 0;
16240 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a . char *z
16250 4d 6f 64 65 54 79 70 65 20 3d 20 30 3b 0a 20 20 ModeType = 0;.
16260 20 20 20 20 20 20 69 6e 74 20 6d 61 73 6b 20 3d int mask =
16270 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 0;. int
16280 6c 69 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 20 20 limit = 0;..
16290 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d 35 20 if( nOpt==5
162a0 26 26 20 6d 65 6d 63 6d 70 28 22 63 61 63 68 65 && memcmp("cache
162b0 22 2c 20 7a 4f 70 74 2c 20 35 29 3d 3d 30 20 29 ", zOpt, 5)==0 )
162c0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 61 74 {. stat
162d0 69 63 20 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f ic struct OpenMo
162e0 64 65 20 61 43 61 63 68 65 4d 6f 64 65 5b 5d 20 de aCacheMode[]
162f0 3d 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 = {.
16300 7b 20 22 73 68 61 72 65 64 22 2c 20 20 53 51 4c { "shared", SQL
16310 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 ITE_OPEN_SHAREDC
16320 41 43 48 45 20 7d 2c 0a 20 20 20 20 20 20 20 20 ACHE },.
16330 20 20 20 20 7b 20 22 70 72 69 76 61 74 65 22 2c { "private",
16340 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 49 SQLITE_OPEN_PRI
16350 56 41 54 45 43 41 43 48 45 20 7d 2c 0a 20 20 20 VATECACHE },.
16360 20 20 20 20 20 20 20 20 20 7b 20 30 2c 20 30 20 { 0, 0
16370 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 3b 0a 0a }. };..
16380 20 20 20 20 20 20 20 20 20 20 6d 61 73 6b 20 3d mask =
16390 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 SQLITE_OPEN_SHA
163a0 52 45 44 43 41 43 48 45 7c 53 51 4c 49 54 45 5f REDCACHE|SQLITE_
163b0 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 OPEN_PRIVATECACH
163c0 45 3b 0a 20 20 20 20 20 20 20 20 20 20 61 4d 6f E;. aMo
163d0 64 65 20 3d 20 61 43 61 63 68 65 4d 6f 64 65 3b de = aCacheMode;
163e0 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d 69 74 . limit
163f0 20 3d 20 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 = mask;.
16400 20 20 20 7a 4d 6f 64 65 54 79 70 65 20 3d 20 22 zModeType = "
16410 63 61 63 68 65 22 3b 0a 20 20 20 20 20 20 20 20 cache";.
16420 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 4f }. if( nO
16430 70 74 3d 3d 34 20 26 26 20 6d 65 6d 63 6d 70 28 pt==4 && memcmp(
16440 22 6d 6f 64 65 22 2c 20 7a 4f 70 74 2c 20 34 29 "mode", zOpt, 4)
16450 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
16460 20 73 74 61 74 69 63 20 73 74 72 75 63 74 20 4f static struct O
16470 70 65 6e 4d 6f 64 65 20 61 4f 70 65 6e 4d 6f 64 penMode aOpenMod
16480 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 e[] = {.
16490 20 20 20 20 7b 20 22 72 6f 22 2c 20 20 53 51 4c { "ro", SQL
164a0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
164b0 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 Y },.
164c0 20 7b 20 22 72 77 22 2c 20 20 53 51 4c 49 54 45 { "rw", SQLITE
164d0 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 _OPEN_READWRITE
164e0 7d 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 }, .
164f0 7b 20 22 72 77 63 22 2c 20 53 51 4c 49 54 45 5f { "rwc", SQLITE_
16500 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c OPEN_READWRITE |
16510 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 SQLITE_OPEN_CRE
16520 41 54 45 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 ATE },.
16530 20 20 20 7b 20 22 6d 65 6d 6f 72 79 22 2c 20 53 { "memory", S
16540 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
16550 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 Y },.
16560 20 7b 20 30 2c 20 30 20 7d 0a 20 20 20 20 20 20 { 0, 0 }.
16570 20 20 20 20 7d 3b 0a 0a 20 20 20 20 20 20 20 20 };..
16580 20 20 6d 61 73 6b 20 3d 20 53 51 4c 49 54 45 5f mask = SQLITE_
16590 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 7c 20 OPEN_READONLY |
165a0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
165b0 57 52 49 54 45 0a 20 20 20 20 20 20 20 20 20 20 WRITE.
165c0 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
165d0 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 7c 20 E_OPEN_CREATE |
165e0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f SQLITE_OPEN_MEMO
165f0 52 59 3b 0a 20 20 20 20 20 20 20 20 20 20 61 4d RY;. aM
16600 6f 64 65 20 3d 20 61 4f 70 65 6e 4d 6f 64 65 3b ode = aOpenMode;
16610 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d 69 74 . limit
16620 20 3d 20 6d 61 73 6b 20 26 20 66 6c 61 67 73 3b = mask & flags;
16630 0a 20 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 . zMode
16640 54 79 70 65 20 3d 20 22 61 63 63 65 73 73 22 3b Type = "access";
16650 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 . }..
16660 20 20 20 20 69 66 28 20 61 4d 6f 64 65 20 29 7b if( aMode ){
16670 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 . int i
16680 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 ;. int
16690 6d 6f 64 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 mode = 0;.
166a0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 61 4d 6f for(i=0; aMo
166b0 64 65 5b 69 5d 2e 7a 3b 20 69 2b 2b 29 7b 0a 20 de[i].z; i++){.
166c0 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
166d0 20 63 68 61 72 20 2a 7a 20 3d 20 61 4d 6f 64 65 char *z = aMode
166e0 5b 69 5d 2e 7a 3b 0a 20 20 20 20 20 20 20 20 20 [i].z;.
166f0 20 20 20 69 66 28 20 6e 56 61 6c 3d 3d 73 71 6c if( nVal==sql
16700 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 20 ite3Strlen30(z)
16710 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 28 7a 56 61 && 0==memcmp(zVa
16720 6c 2c 20 7a 2c 20 6e 56 61 6c 29 20 29 7b 0a 20 l, z, nVal) ){.
16730 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 mod
16740 65 20 3d 20 61 4d 6f 64 65 5b 69 5d 2e 6d 6f 64 e = aMode[i].mod
16750 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 e;.
16760 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
16770 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
16780 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
16790 6d 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 mode==0 ){.
167a0 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 *pzErrMsg
167b0 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e = sqlite3_mprin
167c0 74 66 28 22 6e 6f 20 73 75 63 68 20 25 73 20 6d tf("no such %s m
167d0 6f 64 65 3a 20 25 73 22 2c 20 7a 4d 6f 64 65 54 ode: %s", zModeT
167e0 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20 ype, zVal);.
167f0 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
16800 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 ITE_ERROR;.
16810 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 goto pars
16820 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 e_uri_out;.
16830 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
16840 20 69 66 28 20 28 6d 6f 64 65 20 26 20 7e 53 51 if( (mode & ~SQ
16850 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 59 LITE_OPEN_MEMORY
16860 29 3e 6c 69 6d 69 74 20 29 7b 0a 20 20 20 20 20 )>limit ){.
16870 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 *pzErrMsg
16880 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e = sqlite3_mprin
16890 74 66 28 22 25 73 20 6d 6f 64 65 20 6e 6f 74 20 tf("%s mode not
168a0 61 6c 6c 6f 77 65 64 3a 20 25 73 22 2c 0a 20 20 allowed: %s",.
168b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
168c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
168d0 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 2c zModeType,
168e0 20 7a 56 61 6c 29 3b 0a 20 20 20 20 20 20 20 20 zVal);.
168f0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
16900 50 45 52 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 PERM;.
16910 20 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 goto parse_uri
16920 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 20 20 _out;.
16930 7d 0a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 }. flag
16940 73 20 3d 20 28 66 6c 61 67 73 20 26 20 7e 6d 61 s = (flags & ~ma
16950 73 6b 29 20 7c 20 6d 6f 64 65 3b 0a 20 20 20 20 sk) | mode;.
16960 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 }. }..
16970 20 20 20 20 20 7a 4f 70 74 20 3d 20 26 7a 56 61 zOpt = &zVa
16980 6c 5b 6e 56 61 6c 2b 31 5d 3b 0a 20 20 20 20 7d l[nVal+1];. }
16990 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a .. }else{. z
169a0 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d File = sqlite3_m
169b0 61 6c 6c 6f 63 36 34 28 6e 55 72 69 2b 32 29 3b alloc64(nUri+2);
169c0 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c 65 20 . if( !zFile
169d0 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
169e0 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
169f0 69 66 28 20 6e 55 72 69 20 29 7b 0a 20 20 20 20 if( nUri ){.
16a00 20 20 6d 65 6d 63 70 79 28 7a 46 69 6c 65 2c 20 memcpy(zFile,
16a10 7a 55 72 69 2c 20 6e 55 72 69 29 3b 0a 20 20 20 zUri, nUri);.
16a20 20 7d 0a 20 20 20 20 7a 46 69 6c 65 5b 6e 55 72 }. zFile[nUr
16a30 69 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 7a i] = '\0';. z
16a40 46 69 6c 65 5b 6e 55 72 69 2b 31 5d 20 3d 20 27 File[nUri+1] = '
16a50 5c 30 27 3b 0a 20 20 20 20 66 6c 61 67 73 20 26 \0';. flags &
16a60 3d 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 = ~SQLITE_OPEN_U
16a70 52 49 3b 0a 20 20 7d 0a 0a 20 20 2a 70 70 56 66 RI;. }.. *ppVf
16a80 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 66 73 5f s = sqlite3_vfs_
16a90 66 69 6e 64 28 7a 56 66 73 29 3b 0a 20 20 69 66 find(zVfs);. if
16aa0 28 20 2a 70 70 56 66 73 3d 3d 30 20 29 7b 0a 20 ( *ppVfs==0 ){.
16ab0 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
16ac0 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
16ad0 6e 6f 20 73 75 63 68 20 76 66 73 3a 20 25 73 22 no such vfs: %s"
16ae0 2c 20 7a 56 66 73 29 3b 0a 20 20 20 20 72 63 20 , zVfs);. rc
16af0 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
16b00 20 20 7d 0a 20 70 61 72 73 65 5f 75 72 69 5f 6f }. parse_uri_o
16b10 75 74 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 ut:. if( rc!=SQ
16b20 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 LITE_OK ){. s
16b30 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 69 6c qlite3_free(zFil
16b40 65 29 3b 0a 20 20 20 20 7a 46 69 6c 65 20 3d 20 e);. zFile =
16b50 30 3b 0a 20 20 7d 0a 20 20 2a 70 46 6c 61 67 73 0;. }. *pFlags
16b60 20 3d 20 66 6c 61 67 73 3b 0a 20 20 2a 70 7a 46 = flags;. *pzF
16b70 69 6c 65 20 3d 20 7a 46 69 6c 65 3b 0a 20 20 72 ile = zFile;. r
16b80 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
16b90 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
16ba0 20 64 6f 65 73 20 74 68 65 20 77 6f 72 6b 20 6f does the work o
16bb0 66 20 6f 70 65 6e 69 6e 67 20 61 20 64 61 74 61 f opening a data
16bc0 62 61 73 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f base on behalf o
16bd0 66 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 f.** sqlite3_ope
16be0 6e 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f n() and sqlite3_
16bf0 6f 70 65 6e 31 36 28 29 2e 20 54 68 65 20 64 61 open16(). The da
16c00 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 tabase filename
16c10 22 7a 46 69 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a "zFilename" .**
16c20 20 69 73 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 is UTF-8 encode
16c30 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
16c40 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20 openDatabase(.
16c50 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 const char *zFi
16c60 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62 lename, /* Datab
16c70 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46 ase filename UTF
16c80 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 -8 encoded */.
16c90 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c 20 sqlite3 **ppDb,
16ca0 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 /* OUT: R
16cb0 65 74 75 72 6e 65 64 20 64 61 74 61 62 61 73 65 eturned database
16cc0 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 75 6e 73 handle */. uns
16cd0 69 67 6e 65 64 20 69 6e 74 20 66 6c 61 67 73 2c igned int flags,
16ce0 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e /* Operation
16cf0 61 6c 20 66 6c 61 67 73 20 2a 2f 0a 20 20 63 6f al flags */. co
16d00 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 nst char *zVfs
16d10 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
16d20 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 20 2a the VFS to use *
16d30 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a /.){. sqlite3 *
16d40 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 db;
16d50 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 /* Store
16d60 61 6c 6c 6f 63 61 74 65 64 20 68 61 6e 64 6c 65 allocated handle
16d70 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 72 here */. int r
16d80 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
16d90 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
16da0 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
16db0 6e 74 20 69 73 54 68 72 65 61 64 73 61 66 65 3b nt isThreadsafe;
16dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
16dd0 2a 20 54 72 75 65 20 66 6f 72 20 74 68 72 65 61 * True for threa
16de0 64 73 61 66 65 20 63 6f 6e 6e 65 63 74 69 6f 6e dsafe connection
16df0 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4f 70 s */. char *zOp
16e00 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 en = 0;
16e10 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 6e 61 /* Filena
16e20 6d 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 70 me argument to p
16e30 61 73 73 20 74 6f 20 42 74 72 65 65 4f 70 65 6e ass to BtreeOpen
16e40 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 () */. char *zE
16e50 72 72 4d 73 67 20 3d 20 30 3b 20 20 20 20 20 20 rrMsg = 0;
16e60 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 /* Error
16e70 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20 73 71 message from sq
16e80 6c 69 74 65 33 50 61 72 73 65 55 72 69 28 29 20 lite3ParseUri()
16e90 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
16ea0 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
16eb0 4f 52 0a 20 20 69 66 28 20 70 70 44 62 3d 3d 30 OR. if( ppDb==0
16ec0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
16ed0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
16ee0 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 3d 20 30 ndif. *ppDb = 0
16ef0 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
16f00 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 _OMIT_AUTOINIT.
16f10 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e rc = sqlite3_in
16f20 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 itialize();. if
16f30 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
16f40 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 4f ;.#endif.. /* O
16f50 6e 6c 79 20 61 6c 6c 6f 77 20 73 65 6e 73 69 62 nly allow sensib
16f60 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 le combinations
16f70 6f 66 20 62 69 74 73 20 69 6e 20 74 68 65 20 66 of bits in the f
16f80 6c 61 67 73 20 61 72 67 75 6d 65 6e 74 2e 20 20 lags argument.
16f90 0a 20 20 2a 2a 20 54 68 72 6f 77 20 61 6e 20 65 . ** Throw an e
16fa0 72 72 6f 72 20 69 66 20 61 6e 79 20 6e 6f 6e 2d rror if any non-
16fb0 73 65 6e 73 65 20 63 6f 6d 62 69 6e 61 74 69 6f sense combinatio
16fc0 6e 20 69 73 20 75 73 65 64 2e 20 20 49 66 20 77 n is used. If w
16fd0 65 0a 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 62 6c e. ** do not bl
16fe0 6f 63 6b 20 69 6c 6c 65 67 61 6c 20 63 6f 6d 62 ock illegal comb
16ff0 69 6e 61 74 69 6f 6e 73 20 68 65 72 65 2c 20 69 inations here, i
17000 74 20 63 6f 75 6c 64 20 74 72 69 67 67 65 72 0a t could trigger.
17010 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 73 74 ** assert() st
17020 61 74 65 6d 65 6e 74 73 20 69 6e 20 64 65 65 70 atements in deep
17030 65 72 20 6c 61 79 65 72 73 2e 20 20 53 65 6e 73 er layers. Sens
17040 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e ible combination
17050 73 0a 20 20 2a 2a 20 61 72 65 3a 0a 20 20 2a 2a s. ** are:. **
17060 0a 20 20 2a 2a 20 20 31 3a 20 20 53 51 4c 49 54 . ** 1: SQLIT
17070 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 0a E_OPEN_READONLY.
17080 20 20 2a 2a 20 20 32 3a 20 20 53 51 4c 49 54 45 ** 2: SQLITE
17090 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 0a _OPEN_READWRITE.
170a0 20 20 2a 2a 20 20 36 3a 20 20 53 51 4c 49 54 45 ** 6: SQLITE
170b0 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 _OPEN_READWRITE
170c0 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 | SQLITE_OPEN_CR
170d0 45 41 54 45 0a 20 20 2a 2f 0a 20 20 61 73 73 65 EATE. */. asse
170e0 72 74 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f rt( SQLITE_OPEN_
170f0 52 45 41 44 4f 4e 4c 59 20 20 3d 3d 20 30 78 30 READONLY == 0x0
17100 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 1 );. assert( S
17110 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
17120 52 49 54 45 20 3d 3d 20 30 78 30 32 20 29 3b 0a RITE == 0x02 );.
17130 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 assert( SQLITE
17140 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 20 20 20 _OPEN_CREATE
17150 3d 3d 20 30 78 30 34 20 29 3b 0a 20 20 74 65 73 == 0x04 );. tes
17160 74 63 61 73 65 28 20 28 31 3c 3c 28 66 6c 61 67 tcase( (1<<(flag
17170 73 26 37 29 29 3d 3d 30 78 30 32 20 29 3b 20 2f s&7))==0x02 ); /
17180 2a 20 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a 20 20 * READONLY */.
17190 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c 28 66 testcase( (1<<(f
171a0 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 34 20 29 lags&7))==0x04 )
171b0 3b 20 2f 2a 20 52 45 41 44 57 52 49 54 45 20 2a ; /* READWRITE *
171c0 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 28 31 /. testcase( (1
171d0 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 <<(flags&7))==0x
171e0 34 30 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 49 40 ); /* READWRI
171f0 54 45 20 7c 20 43 52 45 41 54 45 20 2a 2f 0a 20 TE | CREATE */.
17200 20 69 66 28 20 28 28 31 3c 3c 28 66 6c 61 67 73 if( ((1<<(flags
17210 26 37 29 29 20 26 20 30 78 34 36 29 3d 3d 30 20 &7)) & 0x46)==0
17220 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
17230 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
17240 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 35 34 ; /* IMP: R-654
17250 39 37 2d 34 34 35 39 34 20 2a 2f 0a 20 20 7d 0a 97-44594 */. }.
17260 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
17270 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 obalConfig.bCore
17280 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 Mutex==0 ){.
17290 69 73 54 68 72 65 61 64 73 61 66 65 20 3d 20 30 isThreadsafe = 0
172a0 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 6c ;. }else if( fl
172b0 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
172c0 4e 5f 4e 4f 4d 55 54 45 58 20 29 7b 0a 20 20 20 N_NOMUTEX ){.
172d0 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d 20 isThreadsafe =
172e0 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 0;. }else if( f
172f0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
17300 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 29 7b 0a EN_FULLMUTEX ){.
17310 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 isThreadsafe
17320 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 1;. }else{.
17330 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 isThreadsafe
17340 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 = sqlite3GlobalC
17350 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 onfig.bFullMutex
17360 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 ;. }. if( flag
17370 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
17380 50 52 49 56 41 54 45 43 41 43 48 45 20 29 7b 0a PRIVATECACHE ){.
17390 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e 53 51 flags &= ~SQ
173a0 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 LITE_OPEN_SHARED
173b0 43 41 43 48 45 3b 0a 20 20 7d 65 6c 73 65 20 69 CACHE;. }else i
173c0 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
173d0 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 43 61 63 Config.sharedCac
173e0 68 65 45 6e 61 62 6c 65 64 20 29 7b 0a 20 20 20 heEnabled ){.
173f0 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 flags |= SQLITE
17400 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 _OPEN_SHAREDCACH
17410 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 6d E;. }.. /* Rem
17420 6f 76 65 20 68 61 72 6d 66 75 6c 20 62 69 74 73 ove harmful bits
17430 20 66 72 6f 6d 20 74 68 65 20 66 6c 61 67 73 20 from the flags
17440 70 61 72 61 6d 65 74 65 72 0a 20 20 2a 2a 0a 20 parameter. **.
17450 20 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4f ** The SQLITE_O
17460 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 61 6e 64 20 PEN_NOMUTEX and
17470 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c SQLITE_OPEN_FULL
17480 4d 55 54 45 58 20 66 6c 61 67 73 20 77 65 72 65 MUTEX flags were
17490 0a 20 20 2a 2a 20 64 65 61 6c 74 20 77 69 74 68 . ** dealt with
174a0 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 in the previous
174b0 20 63 6f 64 65 20 62 6c 6f 63 6b 2e 20 20 42 65 code block. Be
174c0 73 69 64 65 73 20 74 68 65 73 65 2c 20 74 68 65 sides these, the
174d0 20 6f 6e 6c 79 0a 20 20 2a 2a 20 76 61 6c 69 64 only. ** valid
174e0 20 69 6e 70 75 74 20 66 6c 61 67 73 20 66 6f 72 input flags for
174f0 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 sqlite3_open_v2
17500 28 29 20 61 72 65 20 53 51 4c 49 54 45 5f 4f 50 () are SQLITE_OP
17510 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 0a 20 20 2a EN_READONLY,. *
17520 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 * SQLITE_OPEN_RE
17530 41 44 57 52 49 54 45 2c 20 53 51 4c 49 54 45 5f ADWRITE, SQLITE_
17540 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 53 51 4c OPEN_CREATE, SQL
17550 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 ITE_OPEN_SHAREDC
17560 41 43 48 45 2c 0a 20 20 2a 2a 20 53 51 4c 49 54 ACHE,. ** SQLIT
17570 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 E_OPEN_PRIVATECA
17580 43 48 45 2c 20 61 6e 64 20 73 6f 6d 65 20 72 65 CHE, and some re
17590 73 65 72 76 65 64 20 62 69 74 73 2e 20 20 53 69 served bits. Si
175a0 6c 65 6e 74 6c 79 20 6d 61 73 6b 0a 20 20 2a 2a lently mask. **
175b0 20 6f 66 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 off all other f
175c0 6c 61 67 73 2e 0a 20 20 2a 2f 0a 20 20 66 6c 61 lags.. */. fla
175d0 67 73 20 26 3d 20 20 7e 28 20 53 51 4c 49 54 45 gs &= ~( SQLITE
175e0 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c _OPEN_DELETEONCL
175f0 4f 53 45 20 7c 0a 20 20 20 20 20 20 20 20 20 20 OSE |.
17600 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
17610 5f 45 58 43 4c 55 53 49 56 45 20 7c 0a 20 20 20 _EXCLUSIVE |.
17620 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
17630 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 TE_OPEN_MAIN_DB
17640 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
17650 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d SQLITE_OPEN_TEM
17660 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 20 20 20 P_DB | .
17670 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
17680 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 42 20 EN_TRANSIENT_DB
17690 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | .
176a0 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 SQLITE_OPEN_MA
176b0 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 IN_JOURNAL | .
176c0 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
176d0 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f ITE_OPEN_TEMP_JO
176e0 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 20 URNAL | .
176f0 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
17700 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 7c PEN_SUBJOURNAL |
17710 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
17720 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53 SQLITE_OPEN_MAS
17730 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 20 TER_JOURNAL |.
17740 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
17750 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 ITE_OPEN_NOMUTEX
17760 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
17770 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 SQLITE_OPEN_FU
17780 4c 4c 4d 55 54 45 58 20 7c 0a 20 20 20 20 20 20 LLMUTEX |.
17790 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
177a0 4f 50 45 4e 5f 57 41 4c 0a 20 20 20 20 20 20 20 OPEN_WAL.
177b0 20 20 20 20 20 20 29 3b 0a 0a 20 20 2f 2a 20 41 );.. /* A
177c0 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c 69 llocate the sqli
177d0 74 65 20 64 61 74 61 20 73 74 72 75 63 74 75 72 te data structur
177e0 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69 e */. db = sqli
177f0 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 te3MallocZero( s
17800 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 20 29 izeof(sqlite3) )
17810 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20 ;. if( db==0 )
17820 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b goto opendb_out;
17830 0a 20 20 69 66 28 20 69 73 54 68 72 65 61 64 73 . if( isThreads
17840 61 66 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d afe ){. db->m
17850 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 utex = sqlite3Mu
17860 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f texAlloc(SQLITE_
17870 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 29 MUTEX_RECURSIVE)
17880 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 75 ;. if( db->mu
17890 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 tex==0 ){.
178a0 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 sqlite3_free(db)
178b0 3b 0a 20 20 20 20 20 20 64 62 20 3d 20 30 3b 0a ;. db = 0;.
178c0 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 goto opend
178d0 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d b_out;. }. }
178e0 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
178f0 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
17900 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 6b );. db->errMask
17910 20 3d 20 30 78 66 66 3b 0a 20 20 64 62 2d 3e 6e = 0xff;. db->n
17920 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e 6d 61 Db = 2;. db->ma
17930 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 gic = SQLITE_MAG
17940 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d 3e 61 IC_BUSY;. db->a
17950 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 61 74 Db = db->aDbStat
17960 69 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 ic;.. assert( s
17970 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 74 izeof(db->aLimit
17980 29 3d 3d 73 69 7a 65 6f 66 28 61 48 61 72 64 4c )==sizeof(aHardL
17990 69 6d 69 74 29 20 29 3b 0a 20 20 6d 65 6d 63 70 imit) );. memcp
179a0 79 28 64 62 2d 3e 61 4c 69 6d 69 74 2c 20 61 48 y(db->aLimit, aH
179b0 61 72 64 4c 69 6d 69 74 2c 20 73 69 7a 65 6f 66 ardLimit, sizeof
179c0 28 64 62 2d 3e 61 4c 69 6d 69 74 29 29 3b 0a 20 (db->aLimit));.
179d0 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 db->aLimit[SQLI
179e0 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f TE_LIMIT_WORKER_
179f0 54 48 52 45 41 44 53 5d 20 3d 20 53 51 4c 49 54 THREADS] = SQLIT
17a00 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 E_DEFAULT_WORKER
17a10 5f 54 48 52 45 41 44 53 3b 0a 20 20 64 62 2d 3e _THREADS;. db->
17a20 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a autoCommit = 1;.
17a30 20 20 64 62 2d 3e 6e 65 78 74 41 75 74 6f 76 61 db->nextAutova
17a40 63 20 3d 20 2d 31 3b 0a 20 20 64 62 2d 3e 73 7a c = -1;. db->sz
17a50 4d 6d 61 70 20 3d 20 73 71 6c 69 74 65 33 47 6c Mmap = sqlite3Gl
17a60 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4d 6d 61 obalConfig.szMma
17a70 70 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 50 61 67 p;. db->nextPag
17a80 65 73 69 7a 65 20 3d 20 30 3b 0a 20 20 64 62 2d esize = 0;. db-
17a90 3e 6e 4d 61 78 53 6f 72 74 65 72 4d 6d 61 70 20 >nMaxSorterMmap
17aa0 3d 20 30 78 37 46 46 46 46 46 46 46 3b 0a 20 20 = 0x7FFFFFFF;.
17ab0 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c db->flags |= SQL
17ac0 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 ITE_ShortColName
17ad0 73 20 7c 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c s | SQLITE_Enabl
17ae0 65 54 72 69 67 67 65 72 20 7c 20 53 51 4c 49 54 eTrigger | SQLIT
17af0 45 5f 43 61 63 68 65 53 70 69 6c 6c 0a 23 69 66 E_CacheSpill.#if
17b00 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
17b10 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 4d 41 54 _DEFAULT_AUTOMAT
17b20 49 43 5f 49 4e 44 45 58 29 20 7c 7c 20 53 51 4c IC_INDEX) || SQL
17b30 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f ITE_DEFAULT_AUTO
17b40 4d 41 54 49 43 5f 49 4e 44 45 58 0a 20 20 20 20 MATIC_INDEX.
17b50 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 | S
17b60 51 4c 49 54 45 5f 41 75 74 6f 49 6e 64 65 78 0a QLITE_AutoIndex.
17b70 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
17b80 45 5f 44 45 46 41 55 4c 54 5f 43 4b 50 54 46 55 E_DEFAULT_CKPTFU
17b90 4c 4c 46 53 59 4e 43 0a 20 20 20 20 20 20 20 20 LLFSYNC.
17ba0 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
17bb0 45 5f 43 6b 70 74 46 75 6c 6c 46 53 79 6e 63 0a E_CkptFullFSync.
17bc0 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
17bd0 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 E_DEFAULT_FILE_F
17be0 4f 52 4d 41 54 3c 34 0a 20 20 20 20 20 20 20 20 ORMAT<4.
17bf0 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
17c00 45 5f 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 0a E_LegacyFileFmt.
17c10 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 #endif.#ifdef SQ
17c20 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 41 44 LITE_ENABLE_LOAD
17c30 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 20 20 20 _EXTENSION.
17c40 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 | SQ
17c50 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 6e 73 69 LITE_LoadExtensi
17c60 6f 6e 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 on.#endif.#if SQ
17c70 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 LITE_DEFAULT_REC
17c80 55 52 53 49 56 45 5f 54 52 49 47 47 45 52 53 0a URSIVE_TRIGGERS.
17c90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17ca0 20 7c 20 53 51 4c 49 54 45 5f 52 65 63 54 72 69 | SQLITE_RecTri
17cb0 67 67 65 72 73 0a 23 65 6e 64 69 66 0a 23 69 66 ggers.#endif.#if
17cc0 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
17cd0 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f DEFAULT_FOREIGN_
17ce0 4b 45 59 53 29 20 26 26 20 53 51 4c 49 54 45 5f KEYS) && SQLITE_
17cf0 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f DEFAULT_FOREIGN_
17d00 4b 45 59 53 0a 20 20 20 20 20 20 20 20 20 20 20 KEYS.
17d10 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 46 | SQLITE_F
17d20 6f 72 65 69 67 6e 4b 65 79 73 0a 23 65 6e 64 69 oreignKeys.#endi
17d30 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 f.#if defined(SQ
17d40 4c 49 54 45 5f 52 45 56 45 52 53 45 5f 55 4e 4f LITE_REVERSE_UNO
17d50 52 44 45 52 45 44 5f 53 45 4c 45 43 54 53 29 0a RDERED_SELECTS).
17d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17d70 20 7c 20 53 51 4c 49 54 45 5f 52 65 76 65 72 73 | SQLITE_Revers
17d80 65 4f 72 64 65 72 0a 23 65 6e 64 69 66 0a 23 69 eOrder.#endif.#i
17d90 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
17da0 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 5a 45 _ENABLE_OVERSIZE
17db0 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 0a 20 20 20 _CELL_CHECK).
17dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
17dd0 53 51 4c 49 54 45 5f 43 65 6c 6c 53 69 7a 65 43 SQLITE_CellSizeC
17de0 6b 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 k.#endif.#if def
17df0 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
17e00 4c 45 5f 46 54 53 33 5f 54 4f 4b 45 4e 49 5a 45 LE_FTS3_TOKENIZE
17e10 52 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 R).
17e20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 46 74 73 | SQLITE_Fts
17e30 33 54 6f 6b 65 6e 69 7a 65 72 0a 23 65 6e 64 69 3Tokenizer.#endi
17e40 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 f.#if defined(SQ
17e50 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 51 50 53 47 LITE_ENABLE_QPSG
17e60 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
17e70 20 20 20 7c 20 53 51 4c 49 54 45 5f 45 6e 61 62 | SQLITE_Enab
17e80 6c 65 51 50 53 47 0a 23 65 6e 64 69 66 0a 20 20 leQPSG.#endif.
17e90 20 20 20 20 3b 0a 20 20 73 71 6c 69 74 65 33 48 ;. sqlite3H
17ea0 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f ashInit(&db->aCo
17eb0 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 20 llSeq);.#ifndef
17ec0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
17ed0 55 41 4c 54 41 42 4c 45 0a 20 20 73 71 6c 69 74 UALTABLE. sqlit
17ee0 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e e3HashInit(&db->
17ef0 61 4d 6f 64 75 6c 65 29 3b 0a 23 65 6e 64 69 66 aModule);.#endif
17f00 0a 0a 20 20 2f 2a 20 41 64 64 20 74 68 65 20 64 .. /* Add the d
17f10 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e efault collation
17f20 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41 52 59 sequence BINARY
17f30 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73 20 66 . BINARY works f
17f40 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a 20 20 or both UTF-8.
17f50 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c 20 73 ** and UTF-16, s
17f60 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f 6e 20 o add a version
17f70 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76 6f 69 for each to avoi
17f80 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73 61 72 d any unnecessar
17f90 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73 69 6f y. ** conversio
17fa0 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65 72 72 ns. The only err
17fb0 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63 63 75 or that can occu
17fc0 72 20 68 65 72 65 20 69 73 20 61 20 6d 61 6c 6c r here is a mall
17fd0 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 oc() failure..
17fe0 2a 2a 0a 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 **. ** EVIDENCE
17ff0 2d 4f 46 3a 20 52 2d 35 32 37 38 36 2d 34 34 38 -OF: R-52786-448
18000 37 38 20 53 51 4c 69 74 65 20 64 65 66 69 6e 65 78 SQLite define
18010 73 20 74 68 72 65 65 20 62 75 69 6c 74 2d 69 6e s three built-in
18020 20 63 6f 6c 6c 61 74 69 6e 67 0a 20 20 2a 2a 20 collating. **
18030 66 75 6e 63 74 69 6f 6e 73 3a 0a 20 20 2a 2f 0a functions:. */.
18040 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
18050 6e 28 64 62 2c 20 73 71 6c 69 74 65 33 53 74 72 n(db, sqlite3Str
18060 42 49 4e 41 52 59 2c 20 53 51 4c 49 54 45 5f 55 BINARY, SQLITE_U
18070 54 46 38 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 TF8, 0, binCollF
18080 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 74 unc, 0);. creat
18090 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 73 eCollation(db, s
180a0 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 59 2c qlite3StrBINARY,
180b0 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c SQLITE_UTF16BE,
180c0 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 0, binCollFunc,
180d0 20 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 0);. createCol
180e0 6c 61 74 69 6f 6e 28 64 62 2c 20 73 71 6c 69 74 lation(db, sqlit
180f0 65 33 53 74 72 42 49 4e 41 52 59 2c 20 53 51 4c e3StrBINARY, SQL
18100 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 30 2c 20 ITE_UTF16LE, 0,
18110 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b binCollFunc, 0);
18120 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 . createCollati
18130 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 2c on(db, "NOCASE",
18140 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c SQLITE_UTF8, 0,
18150 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 nocaseCollating
18160 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 Func, 0);. crea
18170 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
18180 22 52 54 52 49 4d 22 2c 20 53 51 4c 49 54 45 5f "RTRIM", SQLITE_
18190 55 54 46 38 2c 20 28 76 6f 69 64 2a 29 31 2c 20 UTF8, (void*)1,
181a0 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b binCollFunc, 0);
181b0 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f . if( db->mallo
181c0 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 cFailed ){. g
181d0 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
181e0 20 20 7d 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 }. /* EVIDENC
181f0 45 2d 4f 46 3a 20 52 2d 30 38 33 30 38 2d 31 37 E-OF: R-08308-17
18200 32 32 34 20 54 68 65 20 64 65 66 61 75 6c 74 20 224 The default
18210 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 69 collating functi
18220 6f 6e 20 66 6f 72 20 61 6c 6c 0a 20 20 2a 2a 20 on for all. **
18230 73 74 72 69 6e 67 73 20 69 73 20 42 49 4e 41 52 strings is BINAR
18240 59 2e 20 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e 70 Y. . */. db->p
18250 44 66 6c 74 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 DfltColl = sqlit
18260 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 e3FindCollSeq(db
18270 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 73 , SQLITE_UTF8, s
18280 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 59 2c qlite3StrBINARY,
18290 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 0);. assert( d
182a0 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 20 b->pDfltColl!=0
182b0 29 3b 0a 0a 20 20 2f 2a 20 50 61 72 73 65 20 74 );.. /* Parse t
182c0 68 65 20 66 69 6c 65 6e 61 6d 65 2f 55 52 49 20 he filename/URI
182d0 61 72 67 75 6d 65 6e 74 2e 20 2a 2f 0a 20 20 64 argument. */. d
182e0 62 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 66 b->openFlags = f
182f0 6c 61 67 73 3b 0a 20 20 72 63 20 3d 20 73 71 6c lags;. rc = sql
18300 69 74 65 33 50 61 72 73 65 55 72 69 28 7a 56 66 ite3ParseUri(zVf
18310 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 26 66 s, zFilename, &f
18320 6c 61 67 73 2c 20 26 64 62 2d 3e 70 56 66 73 2c lags, &db->pVfs,
18330 20 26 7a 4f 70 65 6e 2c 20 26 7a 45 72 72 4d 73 &zOpen, &zErrMs
18340 67 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 g);. if( rc!=SQ
18350 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
18360 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f f( rc==SQLITE_NO
18370 4d 45 4d 20 29 20 73 71 6c 69 74 65 33 4f 6f 6d MEM ) sqlite3Oom
18380 46 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 73 Fault(db);. s
18390 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d qlite3ErrorWithM
183a0 73 67 28 64 62 2c 20 72 63 2c 20 7a 45 72 72 4d sg(db, rc, zErrM
183b0 73 67 20 3f 20 22 25 73 22 20 3a 20 30 2c 20 7a sg ? "%s" : 0, z
183c0 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c ErrMsg);. sql
183d0 69 74 65 33 5f 66 72 65 65 28 7a 45 72 72 4d 73 ite3_free(zErrMs
183e0 67 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 g);. goto ope
183f0 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 ndb_out;. }..
18400 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 61 63 6b /* Open the back
18410 65 6e 64 20 64 61 74 61 62 61 73 65 20 64 72 69 end database dri
18420 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 ver */. rc = sq
18430 6c 69 74 65 33 42 74 72 65 65 4f 70 65 6e 28 64 lite3BtreeOpen(d
18440 62 2d 3e 70 56 66 73 2c 20 7a 4f 70 65 6e 2c 20 b->pVfs, zOpen,
18450 64 62 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e db, &db->aDb[0].
18460 70 42 74 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 pBt, 0,.
18470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18480 66 6c 61 67 73 20 7c 20 53 51 4c 49 54 45 5f 4f flags | SQLITE_O
18490 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 3b 0a 20 20 PEN_MAIN_DB);.
184a0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
184b0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d K ){. if( rc=
184c0 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f =SQLITE_IOERR_NO
184d0 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 72 63 20 MEM ){. rc
184e0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 = SQLITE_NOMEM_B
184f0 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 KPT;. }. s
18500 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
18510 72 63 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 rc);. goto op
18520 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 endb_out;. }.
18530 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
18540 72 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 r(db->aDb[0].pBt
18550 29 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e );. db->aDb[0].
18560 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 pSchema = sqlite
18570 33 53 63 68 65 6d 61 47 65 74 28 64 62 2c 20 64 3SchemaGet(db, d
18580 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a b->aDb[0].pBt);.
18590 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f if( !db->mallo
185a0 63 46 61 69 6c 65 64 20 29 20 45 4e 43 28 64 62 cFailed ) ENC(db
185b0 29 20 3d 20 53 43 48 45 4d 41 5f 45 4e 43 28 64 ) = SCHEMA_ENC(d
185c0 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 b);. sqlite3Btr
185d0 65 65 4c 65 61 76 65 28 64 62 2d 3e 61 44 62 5b eeLeave(db->aDb[
185e0 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 2d 3e 61 0].pBt);. db->a
185f0 44 62 5b 31 5d 2e 70 53 63 68 65 6d 61 20 3d 20 Db[1].pSchema =
18600 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74 sqlite3SchemaGet
18610 28 64 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 54 (db, 0);.. /* T
18620 68 65 20 64 65 66 61 75 6c 74 20 73 61 66 65 74 he default safet
18630 79 5f 6c 65 76 65 6c 20 66 6f 72 20 74 68 65 20 y_level for the
18640 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 69 73 main database is
18650 20 46 55 4c 4c 3b 20 66 6f 72 20 74 68 65 20 74 FULL; for the t
18660 65 6d 70 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 emp. ** databas
18670 65 20 69 74 20 69 73 20 4f 46 46 2e 20 54 68 69 e it is OFF. Thi
18680 73 20 6d 61 74 63 68 65 73 20 74 68 65 20 70 61 s matches the pa
18690 67 65 72 20 6c 61 79 65 72 20 64 65 66 61 75 6c ger layer defaul
186a0 74 73 2e 20 20 0a 20 20 2a 2f 0a 20 20 64 62 2d ts. . */. db-
186b0 3e 61 44 62 5b 30 5d 2e 7a 44 62 53 4e 61 6d 65 >aDb[0].zDbSName
186c0 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 20 64 62 2d = "main";. db-
186d0 3e 61 44 62 5b 30 5d 2e 73 61 66 65 74 79 5f 6c >aDb[0].safety_l
186e0 65 76 65 6c 20 3d 20 53 51 4c 49 54 45 5f 44 45 evel = SQLITE_DE
186f0 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 FAULT_SYNCHRONOU
18700 53 2b 31 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 S+1;. db->aDb[1
18710 5d 2e 7a 44 62 53 4e 61 6d 65 20 3d 20 22 74 65 ].zDbSName = "te
18720 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 mp";. db->aDb[1
18730 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d ].safety_level =
18740 20 50 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e 4f PAGER_SYNCHRONO
18750 55 53 5f 4f 46 46 3b 0a 0a 20 20 64 62 2d 3e 6d US_OFF;.. db->m
18760 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 agic = SQLITE_MA
18770 47 49 43 5f 4f 50 45 4e 3b 0a 20 20 69 66 28 20 GIC_OPEN;. if(
18780 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
18790 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 ){. goto ope
187a0 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 ndb_out;. }..
187b0 2f 2a 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 /* Register all
187c0 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f built-in functio
187d0 6e 73 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 ns, but do not a
187e0 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 ttempt to read t
187f0 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 he. ** database
18800 20 73 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 schema yet. Thi
18810 73 20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 s is delayed unt
18820 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 69 6d il the first tim
18830 65 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 e the database.
18840 20 2a 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e ** is accessed.
18850 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 45 . */. sqlite3E
18860 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f rror(db, SQLITE_
18870 4f 4b 29 3b 0a 20 20 73 71 6c 69 74 65 33 52 65 OK);. sqlite3Re
18880 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 65 63 74 gisterPerConnect
18890 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 ionBuiltinFuncti
188a0 6f 6e 73 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 ons(db);. rc =
188b0 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 sqlite3_errcode(
188c0 64 62 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c db);..#ifdef SQL
188d0 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 35 0a ITE_ENABLE_FTS5.
188e0 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 61 6e /* Register an
188f0 79 20 62 75 69 6c 74 2d 69 6e 20 46 54 53 35 20 y built-in FTS5
18900 6d 6f 64 75 6c 65 20 62 65 66 6f 72 65 20 6c 6f module before lo
18910 61 64 69 6e 67 20 74 68 65 20 61 75 74 6f 6d 61 ading the automa
18920 74 69 63 0a 20 20 2a 2a 20 65 78 74 65 6e 73 69 tic. ** extensi
18930 6f 6e 73 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 ons. This allows
18940 20 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e automatic exten
18950 73 69 6f 6e 73 20 74 6f 20 72 65 67 69 73 74 65 sions to registe
18960 72 20 46 54 53 35 20 0a 20 20 2a 2a 20 74 6f 6b r FTS5 . ** tok
18970 65 6e 69 7a 65 72 73 20 61 6e 64 20 61 75 78 69 enizers and auxi
18980 6c 69 61 72 79 20 66 75 6e 63 74 69 6f 6e 73 2e liary functions.
18990 20 20 2a 2f 0a 20 20 69 66 28 20 21 64 62 2d 3e */. if( !db->
189a0 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 mallocFailed &&
189b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
189c0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
189d0 33 46 74 73 35 49 6e 69 74 28 64 62 29 3b 0a 20 3Fts5Init(db);.
189e0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
189f0 4c 6f 61 64 20 61 75 74 6f 6d 61 74 69 63 20 65 Load automatic e
18a00 78 74 65 6e 73 69 6f 6e 73 20 2d 20 65 78 74 65 xtensions - exte
18a10 6e 73 69 6f 6e 73 20 74 68 61 74 20 68 61 76 65 nsions that have
18a20 20 62 65 65 6e 20 72 65 67 69 73 74 65 72 65 64 been registered
18a30 0a 20 20 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 . ** using the
18a40 73 71 6c 69 74 65 33 5f 61 75 74 6f 6d 61 74 69 sqlite3_automati
18a50 63 5f 65 78 74 65 6e 73 69 6f 6e 28 29 20 41 50 c_extension() AP
18a60 49 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 I.. */. if( rc
18a70 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
18a80 20 20 20 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f sqlite3AutoLo
18a90 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 adExtensions(db)
18aa0 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
18ab0 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
18ac0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
18ad0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 TE_OK ){. g
18ae0 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
18af0 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 }. }..#ifde
18b00 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
18b10 46 54 53 31 0a 20 20 69 66 28 20 21 64 62 2d 3e FTS1. if( !db->
18b20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
18b30 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 extern int s
18b40 71 6c 69 74 65 33 46 74 73 31 49 6e 69 74 28 73 qlite3Fts1Init(s
18b50 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 63 qlite3*);. rc
18b60 20 3d 20 73 71 6c 69 74 65 33 46 74 73 31 49 6e = sqlite3Fts1In
18b70 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
18b80 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
18b90 45 5f 45 4e 41 42 4c 45 5f 46 54 53 32 0a 20 20 E_ENABLE_FTS2.
18ba0 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
18bb0 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
18bc0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 65 78 ITE_OK ){. ex
18bd0 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 tern int sqlite3
18be0 46 74 73 32 49 6e 69 74 28 73 71 6c 69 74 65 33 Fts2Init(sqlite3
18bf0 2a 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c *);. rc = sql
18c00 69 74 65 33 46 74 73 32 49 6e 69 74 28 64 62 29 ite3Fts2Init(db)
18c10 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 ;. }.#endif..#i
18c20 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
18c30 4c 45 5f 46 54 53 33 20 2f 2a 20 61 75 74 6f 6d LE_FTS3 /* autom
18c40 61 74 69 63 61 6c 6c 79 20 64 65 66 69 6e 65 64 atically defined
18c50 20 62 79 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c by SQLITE_ENABL
18c60 45 5f 46 54 53 34 20 2a 2f 0a 20 20 69 66 28 20 E_FTS4 */. if(
18c70 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
18c80 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f d && rc==SQLITE_
18c90 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 OK ){. rc = s
18ca0 71 6c 69 74 65 33 46 74 73 33 49 6e 69 74 28 64 qlite3Fts3Init(d
18cb0 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a b);. }.#endif..
18cc0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
18cd0 41 42 4c 45 5f 49 43 55 0a 20 20 69 66 28 20 21 ABLE_ICU. if( !
18ce0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
18cf0 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f && rc==SQLITE_O
18d00 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 K ){. rc = sq
18d10 6c 69 74 65 33 49 63 75 49 6e 69 74 28 64 62 29 lite3IcuInit(db)
18d20 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 ;. }.#endif..#i
18d30 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
18d40 4c 45 5f 52 54 52 45 45 0a 20 20 69 66 28 20 21 LE_RTREE. if( !
18d50 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
18d60 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f && rc==SQLITE_O
18d70 4b 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c K){. rc = sql
18d80 69 74 65 33 52 74 72 65 65 49 6e 69 74 28 64 62 ite3RtreeInit(db
18d90 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 );. }.#endif..#
18da0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
18db0 42 4c 45 5f 44 42 53 54 41 54 5f 56 54 41 42 0a BLE_DBSTAT_VTAB.
18dc0 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f if( !db->mallo
18dd0 63 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 cFailed && rc==S
18de0 51 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 QLITE_OK){. r
18df0 63 20 3d 20 73 71 6c 69 74 65 33 44 62 73 74 61 c = sqlite3Dbsta
18e00 74 52 65 67 69 73 74 65 72 28 64 62 29 3b 0a 20 tRegister(db);.
18e10 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 }.#endif..#ifde
18e20 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
18e30 4a 53 4f 4e 31 0a 20 20 69 66 28 20 21 64 62 2d JSON1. if( !db-
18e40 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 >mallocFailed &&
18e50 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 7b rc==SQLITE_OK){
18e60 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
18e70 33 4a 73 6f 6e 31 49 6e 69 74 28 64 62 29 3b 0a 3Json1Init(db);.
18e80 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 }.#endif..#ifd
18e90 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
18ea0 5f 53 54 4d 54 53 56 54 41 42 0a 20 20 69 66 28 _STMTSVTAB. if(
18eb0 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
18ec0 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 ed && rc==SQLITE
18ed0 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 _OK){. rc = s
18ee0 71 6c 69 74 65 33 53 74 6d 74 73 56 74 61 62 49 qlite3StmtsVtabI
18ef0 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e nit(db);. }.#en
18f00 64 69 66 0a 0a 20 20 2f 2a 20 2d 44 53 51 4c 49 dif.. /* -DSQLI
18f10 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 TE_DEFAULT_LOCKI
18f20 4e 47 5f 4d 4f 44 45 3d 31 20 6d 61 6b 65 73 20 NG_MODE=1 makes
18f30 45 58 43 4c 55 53 49 56 45 20 74 68 65 20 64 65 EXCLUSIVE the de
18f40 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 0a 20 20 fault locking.
18f50 2a 2a 20 6d 6f 64 65 2e 20 20 2d 44 53 51 4c 49 ** mode. -DSQLI
18f60 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 TE_DEFAULT_LOCKI
18f70 4e 47 5f 4d 4f 44 45 3d 30 20 6d 61 6b 65 20 4e NG_MODE=0 make N
18f80 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c ORMAL the defaul
18f90 74 20 6c 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d t locking. ** m
18fa0 6f 64 65 2e 20 20 44 6f 69 6e 67 20 6e 6f 74 68 ode. Doing noth
18fb0 69 6e 67 20 61 74 20 61 6c 6c 20 61 6c 73 6f 20 ing at all also
18fc0 6d 61 6b 65 73 20 4e 4f 52 4d 41 4c 20 74 68 65 makes NORMAL the
18fd0 20 64 65 66 61 75 6c 74 2e 0a 20 20 2a 2f 0a 23 default.. */.#
18fe0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 ifdef SQLITE_DEF
18ff0 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
19000 45 0a 20 20 64 62 2d 3e 64 66 6c 74 4c 6f 63 6b E. db->dfltLock
19010 4d 6f 64 65 20 3d 20 53 51 4c 49 54 45 5f 44 45 Mode = SQLITE_DE
19020 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f FAULT_LOCKING_MO
19030 44 45 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 DE;. sqlite3Pag
19040 65 72 4c 6f 63 6b 69 6e 67 4d 6f 64 65 28 73 71 erLockingMode(sq
19050 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
19060 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 2c db->aDb[0].pBt),
19070 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
19080 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
19090 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e E_DEFAULT_LOCKIN
190a0 47 5f 4d 4f 44 45 29 3b 0a 23 65 6e 64 69 66 0a G_MODE);.#endif.
190b0 0a 20 20 69 66 28 20 72 63 20 29 20 73 71 6c 69 . if( rc ) sqli
190c0 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 29 te3Error(db, rc)
190d0 3b 0a 0a 20 20 2f 2a 20 45 6e 61 62 6c 65 20 74 ;.. /* Enable t
190e0 68 65 20 6c 6f 6f 6b 61 73 69 64 65 2d 6d 61 6c he lookaside-mal
190f0 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 20 2a 2f loc subsystem */
19100 0a 20 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 . setupLookasid
19110 65 28 64 62 2c 20 30 2c 20 73 71 6c 69 74 65 33 e(db, 0, sqlite3
19120 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c GlobalConfig.szL
19130 6f 6f 6b 61 73 69 64 65 2c 0a 20 20 20 20 20 20 ookaside,.
19140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19150 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
19160 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 64 65 onfig.nLookaside
19170 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 77 61 );.. sqlite3_wa
19180 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 l_autocheckpoint
19190 28 64 62 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 (db, SQLITE_DEFA
191a0 55 4c 54 5f 57 41 4c 5f 41 55 54 4f 43 48 45 43 ULT_WAL_AUTOCHEC
191b0 4b 50 4f 49 4e 54 29 3b 0a 0a 6f 70 65 6e 64 62 KPOINT);..opendb
191c0 5f 6f 75 74 3a 0a 20 20 69 66 28 20 64 62 20 29 _out:. if( db )
191d0 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62 {. assert( db
191e0 2d 3e 6d 75 74 65 78 21 3d 30 20 7c 7c 20 69 73 ->mutex!=0 || is
191f0 54 68 72 65 61 64 73 61 66 65 3d 3d 30 0a 20 20 Threadsafe==0.
19200 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 || sqli
19210 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
19220 62 46 75 6c 6c 4d 75 74 65 78 3d 3d 30 20 29 3b bFullMutex==0 );
19230 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 . sqlite3_mut
19240 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
19250 65 78 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 ex);. }. rc =
19260 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 sqlite3_errcode(
19270 64 62 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 db);. assert( d
19280 62 21 3d 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 b!=0 || rc==SQLI
19290 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 69 66 TE_NOMEM );. if
192a0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d ( rc==SQLITE_NOM
192b0 45 4d 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 EM ){. sqlite
192c0 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 3_close(db);.
192d0 20 64 62 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 db = 0;. }else
192e0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
192f0 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 61 OK ){. db->ma
19300 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 gic = SQLITE_MAG
19310 49 43 5f 53 49 43 4b 3b 0a 20 20 7d 0a 20 20 2a IC_SICK;. }. *
19320 70 70 44 62 20 3d 20 64 62 3b 0a 23 69 66 64 65 ppDb = db;.#ifde
19330 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
19340 53 51 4c 4c 4f 47 0a 20 20 69 66 28 20 73 71 6c SQLLOG. if( sql
19350 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
19360 2e 78 53 71 6c 6c 6f 67 20 29 7b 0a 20 20 20 20 .xSqllog ){.
19370 2f 2a 20 4f 70 65 6e 69 6e 67 20 61 20 64 62 20 /* Opening a db
19380 68 61 6e 64 6c 65 2e 20 46 6f 75 72 74 68 20 70 handle. Fourth p
19390 61 72 61 6d 65 74 65 72 20 69 73 20 70 61 73 73 arameter is pass
193a0 65 64 20 30 2e 20 2a 2f 0a 20 20 20 20 76 6f 69 ed 0. */. voi
193b0 64 20 2a 70 41 72 67 20 3d 20 73 71 6c 69 74 65 d *pArg = sqlite
193c0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 3GlobalConfig.pS
193d0 71 6c 6c 6f 67 41 72 67 3b 0a 20 20 20 20 73 71 qllogArg;. sq
193e0 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
193f0 67 2e 78 53 71 6c 6c 6f 67 28 70 41 72 67 2c 20 g.xSqllog(pArg,
19400 64 62 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 db, zFilename, 0
19410 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 );. }.#endif.#i
19420 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
19430 5f 48 41 53 5f 43 4f 44 45 43 29 0a 20 20 69 66 _HAS_CODEC). if
19440 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
19450 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 ){. const cha
19460 72 20 2a 7a 4b 65 79 3b 0a 20 20 20 20 69 66 28 r *zKey;. if(
19470 20 28 7a 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 (zKey = sqlite3
19480 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 7a _uri_parameter(z
19490 4f 70 65 6e 2c 20 22 68 65 78 6b 65 79 22 29 29 Open, "hexkey"))
194a0 21 3d 30 20 26 26 20 7a 4b 65 79 5b 30 5d 20 29 !=0 && zKey[0] )
194b0 7b 0a 20 20 20 20 20 20 75 38 20 69 42 79 74 65 {. u8 iByte
194c0 3b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 ;. int i;.
194d0 20 20 20 20 20 63 68 61 72 20 7a 44 65 63 6f 64 char zDecod
194e0 65 64 5b 34 30 5d 3b 0a 20 20 20 20 20 20 66 6f ed[40];. fo
194f0 72 28 69 3d 30 2c 20 69 42 79 74 65 3d 30 3b 20 r(i=0, iByte=0;
19500 69 3c 73 69 7a 65 6f 66 28 7a 44 65 63 6f 64 65 i<sizeof(zDecode
19510 64 29 2a 32 20 26 26 20 73 71 6c 69 74 65 33 49 d)*2 && sqlite3I
19520 73 78 64 69 67 69 74 28 7a 4b 65 79 5b 69 5d 29 sxdigit(zKey[i])
19530 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 ; i++){.
19540 69 42 79 74 65 20 3d 20 28 69 42 79 74 65 3c 3c iByte = (iByte<<
19550 34 29 20 2b 20 73 71 6c 69 74 65 33 48 65 78 54 4) + sqlite3HexT
19560 6f 49 6e 74 28 7a 4b 65 79 5b 69 5d 29 3b 0a 20 oInt(zKey[i]);.
19570 20 20 20 20 20 20 20 69 66 28 20 28 69 26 31 29 if( (i&1)
19580 21 3d 30 20 29 20 7a 44 65 63 6f 64 65 64 5b 69 !=0 ) zDecoded[i
19590 2f 32 5d 20 3d 20 69 42 79 74 65 3b 0a 20 20 20 /2] = iByte;.
195a0 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 }. sqlit
195b0 65 33 5f 6b 65 79 5f 76 32 28 64 62 2c 20 30 2c e3_key_v2(db, 0,
195c0 20 7a 44 65 63 6f 64 65 64 2c 20 69 2f 32 29 3b zDecoded, i/2);
195d0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 . }else if( (
195e0 7a 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 5f 75 zKey = sqlite3_u
195f0 72 69 5f 70 61 72 61 6d 65 74 65 72 28 7a 4f 70 ri_parameter(zOp
19600 65 6e 2c 20 22 6b 65 79 22 29 29 21 3d 30 20 29 en, "key"))!=0 )
19610 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f {. sqlite3_
19620 6b 65 79 5f 76 32 28 64 62 2c 20 30 2c 20 7a 4b key_v2(db, 0, zK
19630 65 79 2c 20 73 71 6c 69 74 65 33 53 74 72 6c 65 ey, sqlite3Strle
19640 6e 33 30 28 7a 4b 65 79 29 29 3b 0a 20 20 20 20 n30(zKey));.
19650 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 }. }.#endif. s
19660 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 4f 70 65 qlite3_free(zOpe
19670 6e 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 20 n);. return rc
19680 26 20 30 78 66 66 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a & 0xff;.}../*.**
19690 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 Open a new data
196a0 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a base handle..*/.
196b0 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e int sqlite3_open
196c0 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
196d0 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 zFilename, . sq
196e0 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a 29 7b lite3 **ppDb .){
196f0 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 61 . return openDa
19700 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61 6d 65 tabase(zFilename
19710 2c 20 70 70 44 62 2c 0a 20 20 20 20 20 20 20 20 , ppDb,.
19720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
19730 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
19740 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 ITE | SQLITE_OPE
19750 4e 5f 43 52 45 41 54 45 2c 20 30 29 3b 0a 7d 0a N_CREATE, 0);.}.
19760 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e int sqlite3_open
19770 5f 76 32 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 _v2(. const cha
19780 72 20 2a 66 69 6c 65 6e 61 6d 65 2c 20 20 20 2f r *filename, /
19790 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 6e * Database filen
197a0 61 6d 65 20 28 55 54 46 2d 38 29 20 2a 2f 0a 20 ame (UTF-8) */.
197b0 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c sqlite3 **ppDb,
197c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
197d0 20 53 51 4c 69 74 65 20 64 62 20 68 61 6e 64 6c SQLite db handl
197e0 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 e */. int flags
197f0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
19800 2a 20 46 6c 61 67 73 20 2a 2f 0a 20 20 63 6f 6e * Flags */. con
19810 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 20 st char *zVfs
19820 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
19830 56 46 53 20 6d 6f 64 75 6c 65 20 74 6f 20 75 73 VFS module to us
19840 65 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 75 72 6e e */.){. return
19850 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 66 69 openDatabase(fi
19860 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c 20 28 75 lename, ppDb, (u
19870 6e 73 69 67 6e 65 64 20 69 6e 74 29 66 6c 61 67 nsigned int)flag
19880 73 2c 20 7a 56 66 73 29 3b 0a 7d 0a 0a 23 69 66 s, zVfs);.}..#if
19890 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
198a0 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f 70 65 _UTF16./*.** Ope
198b0 6e 20 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 n a new database
198c0 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 handle..*/.int
198d0 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 0a sqlite3_open16(.
198e0 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 const void *zF
198f0 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 6c 69 ilename, . sqli
19900 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a 20 20 te3 **ppDb.){.
19910 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c char const *zFil
19920 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a 46 69 ename8; /* zFi
19930 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64 20 69 lename encoded i
19940 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 61 64 20 n UTF-8 instead
19950 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20 20 73 of UTF-16 */. s
19960 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 qlite3_value *pV
19970 61 6c 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 23 al;. int rc;..#
19980 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
19990 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
199a0 69 66 28 20 70 70 44 62 3d 3d 30 20 29 20 72 65 if( ppDb==0 ) re
199b0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
199c0 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a SE_BKPT;.#endif.
199d0 20 20 2a 70 70 44 62 20 3d 20 30 3b 0a 23 69 66 *ppDb = 0;.#if
199e0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
199f0 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 63 20 3d _AUTOINIT. rc =
19a00 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c sqlite3_initial
19a10 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 72 63 20 ize();. if( rc
19a20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e ) return rc;.#en
19a30 64 69 66 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e dif. if( zFilen
19a40 61 6d 65 3d 3d 30 20 29 20 7a 46 69 6c 65 6e 61 ame==0 ) zFilena
19a50 6d 65 20 3d 20 22 5c 30 30 30 5c 30 30 30 22 3b me = "\000\000";
19a60 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 74 65 . pVal = sqlite
19a70 33 56 61 6c 75 65 4e 65 77 28 30 29 3b 0a 20 20 3ValueNew(0);.
19a80 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53 sqlite3ValueSetS
19a90 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46 69 tr(pVal, -1, zFi
19aa0 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55 lename, SQLITE_U
19ab0 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 TF16NATIVE, SQLI
19ac0 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 46 TE_STATIC);. zF
19ad0 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69 74 ilename8 = sqlit
19ae0 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c e3ValueText(pVal
19af0 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a , SQLITE_UTF8);.
19b00 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 38 if( zFilename8
19b10 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70 65 ){. rc = ope
19b20 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e nDatabase(zFilen
19b30 61 6d 65 38 2c 20 70 70 44 62 2c 0a 20 20 20 20 ame8, ppDb,.
19b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19b50 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 SQLITE_OPEN_RE
19b60 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 ADWRITE | SQLITE
19b70 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 29 _OPEN_CREATE, 0)
19b80 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 ;. assert( *p
19b90 70 44 62 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 pDb || rc==SQLIT
19ba0 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 69 E_NOMEM );. i
19bb0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
19bc0 20 26 26 20 21 44 62 48 61 73 50 72 6f 70 65 72 && !DbHasProper
19bd0 74 79 28 2a 70 70 44 62 2c 20 30 2c 20 44 42 5f ty(*ppDb, 0, DB_
19be0 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b SchemaLoaded) ){
19bf0 0a 20 20 20 20 20 20 53 43 48 45 4d 41 5f 45 4e . SCHEMA_EN
19c00 43 28 2a 70 70 44 62 29 20 3d 20 45 4e 43 28 2a C(*ppDb) = ENC(*
19c10 70 70 44 62 29 20 3d 20 53 51 4c 49 54 45 5f 55 ppDb) = SQLITE_U
19c20 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 TF16NATIVE;.
19c30 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 }. }else{. r
19c40 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
19c50 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 6c _BKPT;. }. sql
19c60 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 70 56 ite3ValueFree(pV
19c70 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 72 al);.. return r
19c80 63 20 26 20 30 78 66 66 3b 0a 7d 0a 23 65 6e 64 c & 0xff;.}.#end
19c90 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
19ca0 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a T_UTF16 */../*.*
19cb0 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 * Register a new
19cc0 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
19cd0 6e 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 nce with the dat
19ce0 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e abase handle db.
19cf0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
19d00 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e create_collation
19d10 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c (. sqlite3* db,
19d20 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a . const char *
19d30 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e zName, . int en
19d40 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 c, . void* pCtx
19d50 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 ,. int(*xCompar
19d60 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e e)(void*,int,con
19d70 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e st void*,int,con
19d80 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 st void*).){. r
19d90 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 63 72 eturn sqlite3_cr
19da0 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 eate_collation_v
19db0 32 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 65 6e 63 2(db, zName, enc
19dc0 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 , pCtx, xCompare
19dd0 2c 20 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 , 0);.}../*.** R
19de0 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f egister a new co
19df0 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
19e00 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 with the databa
19e10 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f se handle db..*/
19e20 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
19e30 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 ate_collation_v2
19e40 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c (. sqlite3* db,
19e50 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a . const char *
19e60 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e zName, . int en
19e70 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 c, . void* pCtx
19e80 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 ,. int(*xCompar
19e90 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e e)(void*,int,con
19ea0 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e st void*,int,con
19eb0 73 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 st void*),. voi
19ec0 64 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a d(*xDel)(void*).
19ed0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 23 69 ){. int rc;..#i
19ee0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
19ef0 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 LE_API_ARMOR. i
19f00 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
19f10 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 yCheckOk(db) ||
19f20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 zName==0 ) retur
19f30 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
19f40 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 BKPT;.#endif. s
19f50 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
19f60 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
19f70 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 assert( !db->ma
19f80 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 llocFailed );.
19f90 72 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 rc = createColla
19fa0 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 tion(db, zName,
19fb0 28 75 38 29 65 6e 63 2c 20 70 43 74 78 2c 20 78 (u8)enc, pCtx, x
19fc0 43 6f 6d 70 61 72 65 2c 20 78 44 65 6c 29 3b 0a Compare, xDel);.
19fd0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 rc = sqlite3Ap
19fe0 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 iExit(db, rc);.
19ff0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
1a000 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
1a010 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
1a020 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
1a030 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a OMIT_UTF16./*.**
1a040 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 Register a new
1a050 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
1a060 63 65 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ce with the data
1a070 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a base handle db..
1a080 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
1a090 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 reate_collation1
1a0a0 36 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 6(. sqlite3* db
1a0b0 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 , . const void
1a0c0 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 65 6e *zName,. int en
1a0d0 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 c, . void* pCtx
1a0e0 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 ,. int(*xCompar
1a0f0 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e e)(void*,int,con
1a100 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e st void*,int,con
1a110 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 st void*).){. i
1a120 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1a130 4b 3b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 K;. char *zName
1a140 38 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 8;..#ifdef SQLIT
1a150 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
1a160 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
1a170 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
1a180 62 29 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29 b) || zName==0 )
1a190 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
1a1a0 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
1a1b0 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
1a1c0 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
1a1d0 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 ex);. assert( !
1a1e0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
1a1f0 20 29 3b 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 73 );. zName8 = s
1a200 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 64 qlite3Utf16to8(d
1a210 62 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 b, zName, -1, SQ
1a220 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
1a230 29 3b 0a 20 20 69 66 28 20 7a 4e 61 6d 65 38 20 );. if( zName8
1a240 29 7b 0a 20 20 20 20 72 63 20 3d 20 63 72 65 61 ){. rc = crea
1a250 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
1a260 7a 4e 61 6d 65 38 2c 20 28 75 38 29 65 6e 63 2c zName8, (u8)enc,
1a270 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c pCtx, xCompare,
1a280 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 0);. sqlite3
1a290 44 62 46 72 65 65 28 64 62 2c 20 7a 4e 61 6d 65 DbFree(db, zName
1a2a0 38 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 8);. }. rc = s
1a2b0 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 qlite3ApiExit(db
1a2c0 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 , rc);. sqlite3
1a2d0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
1a2e0 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
1a2f0 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f n rc;.}.#endif /
1a300 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
1a310 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 F16 */../*.** Re
1a320 67 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 gister a collati
1a330 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 on sequence fact
1a340 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 ory callback wit
1a350 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 h the database h
1a360 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 andle.** db. Rep
1a370 6c 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 lace any previou
1a380 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f sly installed co
1a390 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
1a3a0 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 factory..*/.int
1a3b0 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 sqlite3_collati
1a3c0 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 73 71 6c on_needed(. sql
1a3d0 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 ite3 *db, . voi
1a3e0 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 d *pCollNeededAr
1a3f0 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c g, . void(*xCol
1a400 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 lNeeded)(void*,s
1a410 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 qlite3*,int eTex
1a420 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a tRep,const char*
1a430 29 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 ).){.#ifdef SQLI
1a440 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
1a450 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
1a460 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
1a470 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c db) ) return SQL
1a480 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
1a490 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
1a4a0 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
1a4b0 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
1a4c0 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 xCollNeeded = xC
1a4d0 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d ollNeeded;. db-
1a4e0 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d >xCollNeeded16 =
1a4f0 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 0;. db->pCollN
1a500 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c eededArg = pColl
1a510 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 73 71 6c NeededArg;. sql
1a520 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
1a530 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
1a540 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1a550 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
1a560 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a TE_OMIT_UTF16./*
1a570 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
1a580 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
1a590 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 e factory callba
1a5a0 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ck with the data
1a5b0 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 base handle.** d
1a5c0 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 b. Replace any p
1a5d0 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c reviously instal
1a5e0 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 led collation se
1a5f0 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a quence factory..
1a600 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
1a610 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 ollation_needed1
1a620 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 6(. sqlite3 *db
1a630 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c , . void *pColl
1a640 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f NeededArg, . vo
1a650 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 id(*xCollNeeded1
1a660 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 6)(void*,sqlite3
1a670 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 *,int eTextRep,c
1a680 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 23 onst void*).){.#
1a690 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
1a6a0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
1a6b0 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
1a6c0 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 tyCheckOk(db) )
1a6d0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
1a6e0 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
1a6f0 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
1a700 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
1a710 78 29 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e x);. db->xCollN
1a720 65 65 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d eeded = 0;. db-
1a730 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d >xCollNeeded16 =
1a740 20 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a xCollNeeded16;.
1a750 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 db->pCollNeede
1a760 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 dArg = pCollNeed
1a770 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 edArg;. sqlite3
1a780 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
1a790 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
1a7a0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
1a7b0 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
1a7c0 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 OMIT_UTF16 */..#
1a7d0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1a7e0 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a IT_DEPRECATED./*
1a7f0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
1a800 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 n is now an anac
1a810 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 hronism. It used
1a820 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 to be used to r
1a830 65 63 6f 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a ecover from a.**
1a840 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 malloc() failur
1a850 65 2c 20 62 75 74 20 53 51 4c 69 74 65 20 6e 6f e, but SQLite no
1a860 77 20 64 6f 65 73 20 74 68 69 73 20 61 75 74 6f w does this auto
1a870 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e matically..*/.in
1a880 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c t sqlite3_global
1a890 5f 72 65 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a _recover(void){.
1a8a0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1a8b0 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a OK;.}.#endif../*
1a8c0 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 .** Test to see
1a8d0 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 whether or not t
1a8e0 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e he database conn
1a8f0 65 63 74 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 ection is in aut
1a900 6f 63 6f 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e ocommit.** mode.
1a910 20 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 Return TRUE if
1a920 20 69 74 20 69 73 20 61 6e 64 20 46 41 4c 53 45 it is and FALSE
1a930 20 69 66 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f if not. Autoco
1a940 6d 6d 69 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a mmit mode is on.
1a950 2a 2a 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 ** by default.
1a960 41 75 74 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 Autocommit is di
1a970 73 61 62 6c 65 64 20 62 79 20 61 20 42 45 47 49 sabled by a BEGI
1a980 4e 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 N statement and
1a990 72 65 65 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 reenabled.** by
1a9a0 74 68 65 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 the next COMMIT
1a9b0 6f 72 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2f 0a or ROLLBACK..*/.
1a9c0 69 6e 74 20 73 71 6c 69 74 65 33 5f 67 65 74 5f int sqlite3_get_
1a9d0 61 75 74 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 autocommit(sqlit
1a9e0 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 e3 *db){.#ifdef
1a9f0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
1aa00 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
1aa10 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
1aa20 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
1aa30 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
1aa40 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
1aa50 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 urn 0;. }.#endi
1aa60 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 61 f. return db->a
1aa70 75 74 6f 43 6f 6d 6d 69 74 3b 0a 7d 0a 0a 2f 2a utoCommit;.}../*
1aa80 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
1aa90 67 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 73 g routines are s
1aaa0 75 62 73 74 69 74 75 74 65 73 20 66 6f 72 20 63 ubstitutes for c
1aab0 6f 6e 73 74 61 6e 74 73 20 53 51 4c 49 54 45 5f onstants SQLITE_
1aac0 43 4f 52 52 55 50 54 2c 0a 2a 2a 20 53 51 4c 49 CORRUPT,.** SQLI
1aad0 54 45 5f 4d 49 53 55 53 45 2c 20 53 51 4c 49 54 TE_MISUSE, SQLIT
1aae0 45 5f 43 41 4e 54 4f 50 45 4e 2c 20 53 51 4c 49 E_CANTOPEN, SQLI
1aaf0 54 45 5f 4e 4f 4d 45 4d 20 61 6e 64 20 70 6f 73 TE_NOMEM and pos
1ab00 73 69 62 6c 79 20 6f 74 68 65 72 20 65 72 72 6f sibly other erro
1ab10 72 0a 2a 2a 20 63 6f 6e 73 74 61 6e 74 73 2e 20 r.** constants.
1ab20 20 54 68 65 79 20 73 65 72 76 65 20 74 77 6f 20 They serve two
1ab30 70 75 72 70 6f 73 65 73 3a 0a 2a 2a 0a 2a 2a 20 purposes:.**.**
1ab40 20 20 31 2e 20 20 53 65 72 76 65 20 61 73 20 61 1. Serve as a
1ab50 20 63 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 convenient plac
1ab60 65 20 74 6f 20 73 65 74 20 61 20 62 72 65 61 6b e to set a break
1ab70 70 6f 69 6e 74 20 69 6e 20 61 20 64 65 62 75 67 point in a debug
1ab80 67 65 72 0a 2a 2a 20 20 20 20 20 20 20 74 6f 20 ger.** to
1ab90 64 65 74 65 63 74 20 77 68 65 6e 20 76 65 72 73 detect when vers
1aba0 69 6f 6e 20 65 72 72 6f 72 20 63 6f 6e 64 69 74 ion error condit
1abb0 69 6f 6e 73 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a ions occurs..**.
1abc0 2a 2a 20 20 20 32 2e 20 20 49 6e 76 6f 6b 65 20 ** 2. Invoke
1abd0 73 71 6c 69 74 65 33 5f 6c 6f 67 28 29 20 74 6f sqlite3_log() to
1abe0 20 70 72 6f 76 69 64 65 20 74 68 65 20 73 6f 75 provide the sou
1abf0 72 63 65 20 63 6f 64 65 20 6c 6f 63 61 74 69 6f rce code locatio
1ac00 6e 20 77 68 65 72 65 0a 2a 2a 20 20 20 20 20 20 n where.**
1ac10 20 61 20 6c 6f 77 2d 6c 65 76 65 6c 20 65 72 72 a low-level err
1ac20 6f 72 20 69 73 20 66 69 72 73 74 20 64 65 74 65 or is first dete
1ac30 63 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 cted..*/.static
1ac40 69 6e 74 20 72 65 70 6f 72 74 45 72 72 6f 72 28 int reportError(
1ac50 69 6e 74 20 69 45 72 72 2c 20 69 6e 74 20 6c 69 int iErr, int li
1ac60 6e 65 6e 6f 2c 20 63 6f 6e 73 74 20 63 68 61 72 neno, const char
1ac70 20 2a 7a 54 79 70 65 29 7b 0a 20 20 73 71 6c 69 *zType){. sqli
1ac80 74 65 33 5f 6c 6f 67 28 69 45 72 72 2c 20 22 25 te3_log(iErr, "%
1ac90 73 20 61 74 20 6c 69 6e 65 20 25 64 20 6f 66 20 s at line %d of
1aca0 5b 25 2e 31 30 73 5d 22 2c 0a 20 20 20 20 20 20 [%.10s]",.
1acb0 20 20 20 20 20 20 20 20 7a 54 79 70 65 2c 20 6c zType, l
1acc0 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 ineno, 20+sqlite
1acd0 33 5f 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 3_sourceid());.
1ace0 20 72 65 74 75 72 6e 20 69 45 72 72 3b 0a 7d 0a return iErr;.}.
1acf0 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 int sqlite3Corru
1ad00 70 74 45 72 72 6f 72 28 69 6e 74 20 6c 69 6e 65 ptError(int line
1ad10 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 65 28 no){. testcase(
1ad20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1ad30 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a nfig.xLog!=0 );.
1ad40 20 20 72 65 74 75 72 6e 20 72 65 70 6f 72 74 45 return reportE
1ad50 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 4f 52 52 rror(SQLITE_CORR
1ad60 55 50 54 2c 20 6c 69 6e 65 6e 6f 2c 20 22 64 61 UPT, lineno, "da
1ad70 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
1ad80 6e 22 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 n");.}.int sqlit
1ad90 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 69 6e e3MisuseError(in
1ada0 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 t lineno){. tes
1adb0 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c tcase( sqlite3Gl
1adc0 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 obalConfig.xLog!
1add0 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 =0 );. return r
1ade0 65 70 6f 72 74 45 72 72 6f 72 28 53 51 4c 49 54 eportError(SQLIT
1adf0 45 5f 4d 49 53 55 53 45 2c 20 6c 69 6e 65 6e 6f E_MISUSE, lineno
1ae00 2c 20 22 6d 69 73 75 73 65 22 29 3b 0a 7d 0a 69 , "misuse");.}.i
1ae10 6e 74 20 73 71 6c 69 74 65 33 43 61 6e 74 6f 70 nt sqlite3Cantop
1ae20 65 6e 45 72 72 6f 72 28 69 6e 74 20 6c 69 6e 65 enError(int line
1ae30 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 65 28 no){. testcase(
1ae40 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1ae50 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a nfig.xLog!=0 );.
1ae60 20 20 72 65 74 75 72 6e 20 72 65 70 6f 72 74 45 return reportE
1ae70 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 41 4e 54 rror(SQLITE_CANT
1ae80 4f 50 45 4e 2c 20 6c 69 6e 65 6e 6f 2c 20 22 63 OPEN, lineno, "c
1ae90 61 6e 6e 6f 74 20 6f 70 65 6e 20 66 69 6c 65 22 annot open file"
1aea0 29 3b 0a 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 );.}.#ifdef SQLI
1aeb0 54 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 6c TE_DEBUG.int sql
1aec0 69 74 65 33 43 6f 72 72 75 70 74 50 67 6e 6f 45 ite3CorruptPgnoE
1aed0 72 72 6f 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 2c rror(int lineno,
1aee0 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 63 Pgno pgno){. c
1aef0 68 61 72 20 7a 4d 73 67 5b 31 30 30 5d 3b 0a 20 har zMsg[100];.
1af00 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 sqlite3_snprint
1af10 66 28 73 69 7a 65 6f 66 28 7a 4d 73 67 29 2c 20 f(sizeof(zMsg),
1af20 7a 4d 73 67 2c 20 22 64 61 74 61 62 61 73 65 20 zMsg, "database
1af30 63 6f 72 72 75 70 74 69 6f 6e 20 70 61 67 65 20 corruption page
1af40 25 64 22 2c 20 70 67 6e 6f 29 3b 0a 20 20 74 65 %d", pgno);. te
1af50 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 stcase( sqlite3G
1af60 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
1af70 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 !=0 );. return
1af80 72 65 70 6f 72 74 45 72 72 6f 72 28 53 51 4c 49 reportError(SQLI
1af90 54 45 5f 43 4f 52 52 55 50 54 2c 20 6c 69 6e 65 TE_CORRUPT, line
1afa0 6e 6f 2c 20 7a 4d 73 67 29 3b 0a 7d 0a 69 6e 74 no, zMsg);.}.int
1afb0 20 73 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 72 72 sqlite3NomemErr
1afc0 6f 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a or(int lineno){.
1afd0 20 20 74 65 73 74 63 61 73 65 28 20 73 71 6c 69 testcase( sqli
1afe0 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1aff0 78 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 72 65 74 xLog!=0 );. ret
1b000 75 72 6e 20 72 65 70 6f 72 74 45 72 72 6f 72 28 urn reportError(
1b010 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2c 20 6c 69 SQLITE_NOMEM, li
1b020 6e 65 6e 6f 2c 20 22 4f 4f 4d 22 29 3b 0a 7d 0a neno, "OOM");.}.
1b030 69 6e 74 20 73 71 6c 69 74 65 33 49 6f 65 72 72 int sqlite3Ioerr
1b040 6e 6f 6d 65 6d 45 72 72 6f 72 28 69 6e 74 20 6c nomemError(int l
1b050 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 ineno){. testca
1b060 73 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 se( sqlite3Globa
1b070 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 lConfig.xLog!=0
1b080 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 70 6f );. return repo
1b090 72 74 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 rtError(SQLITE_I
1b0a0 4f 45 52 52 5f 4e 4f 4d 45 4d 2c 20 6c 69 6e 65 OERR_NOMEM, line
1b0b0 6e 6f 2c 20 22 49 2f 4f 20 4f 4f 4d 20 65 72 72 no, "I/O OOM err
1b0c0 6f 72 22 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a or");.}.#endif..
1b0d0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
1b0e0 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f MIT_DEPRECATED./
1b0f0 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 *.** This is a c
1b100 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 69 onvenience routi
1b110 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73 75 ne that makes su
1b120 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72 65 re that all thre
1b130 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 64 ad-specific.** d
1b140 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68 72 ata for this thr
1b150 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65 61 ead has been dea
1b160 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 llocated..**.**
1b170 53 51 4c 69 74 65 20 6e 6f 20 6c 6f 6e 67 65 72 SQLite no longer
1b180 20 75 73 65 73 20 74 68 72 65 61 64 2d 73 70 65 uses thread-spe
1b190 63 69 66 69 63 20 64 61 74 61 20 73 6f 20 74 68 cific data so th
1b1a0 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f is routine is no
1b1b0 77 20 61 0a 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 49 w a.** no-op. I
1b1c0 74 20 69 73 20 72 65 74 61 69 6e 65 64 20 66 6f t is retained fo
1b1d0 72 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d r historical com
1b1e0 70 61 74 69 62 69 6c 69 74 79 2e 0a 2a 2f 0a 76 patibility..*/.v
1b1f0 6f 69 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 oid sqlite3_thre
1b200 61 64 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 ad_cleanup(void)
1b210 7b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a {.}.#endif../*.*
1b220 2a 20 52 65 74 75 72 6e 20 6d 65 74 61 20 69 6e * Return meta in
1b230 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
1b240 61 20 73 70 65 63 69 66 69 63 20 63 6f 6c 75 6d a specific colum
1b250 6e 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 n of a database
1b260 74 61 62 6c 65 2e 0a 2a 2a 20 53 65 65 20 63 6f table..** See co
1b270 6d 6d 65 6e 74 20 69 6e 20 73 71 6c 69 74 65 33 mment in sqlite3
1b280 2e 68 20 28 73 71 6c 69 74 65 2e 68 2e 69 6e 29 .h (sqlite.h.in)
1b290 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f for details..*/
1b2a0 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 61 62 .int sqlite3_tab
1b2b0 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 le_column_metada
1b2c0 74 61 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ta(. sqlite3 *d
1b2d0 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
1b2e0 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 /* Connection
1b2f0 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 handle */. cons
1b300 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 2c t char *zDbName,
1b310 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1b320 61 73 65 20 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c ase name or NULL
1b330 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
1b340 20 2a 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 20 20 *zTableName,
1b350 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20 /* Table name
1b360 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
1b370 2a 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 *zColumnName,
1b380 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 /* Column name
1b390 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 */. char const
1b3a0 2a 2a 70 7a 44 61 74 61 54 79 70 65 2c 20 20 20 **pzDataType,
1b3b0 20 2f 2a 20 4f 55 54 50 55 54 3a 20 44 65 63 6c /* OUTPUT: Decl
1b3c0 61 72 65 64 20 64 61 74 61 20 74 79 70 65 20 2a ared data type *
1b3d0 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a /. char const *
1b3e0 2a 70 7a 43 6f 6c 6c 53 65 71 2c 20 20 20 20 20 *pzCollSeq,
1b3f0 2f 2a 20 4f 55 54 50 55 54 3a 20 43 6f 6c 6c 61 /* OUTPUT: Colla
1b400 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 6e 61 tion sequence na
1b410 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f me */. int *pNo
1b420 74 4e 75 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 tNull,
1b430 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 /* OUTPUT: T
1b440 72 75 65 20 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 rue if NOT NULL
1b450 63 6f 6e 73 74 72 61 69 6e 74 20 65 78 69 73 74 constraint exist
1b460 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 50 72 69 s */. int *pPri
1b470 6d 61 72 79 4b 65 79 2c 20 20 20 20 20 20 20 20 maryKey,
1b480 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 /* OUTPUT: Tr
1b490 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 70 61 72 ue if column par
1b4a0 74 20 6f 66 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 t of PK */. int
1b4b0 20 2a 70 41 75 74 6f 69 6e 63 20 20 20 20 20 20 *pAutoinc
1b4c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 /* OUTP
1b4d0 55 54 3a 20 54 72 75 65 20 69 66 20 63 6f 6c 75 UT: True if colu
1b4e0 6d 6e 20 69 73 20 61 75 74 6f 2d 69 6e 63 72 65 mn is auto-incre
1b4f0 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ment */.){. int
1b500 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 rc;. char *zEr
1b510 72 4d 73 67 20 3d 20 30 3b 0a 20 20 54 61 62 6c rMsg = 0;. Tabl
1b520 65 20 2a 70 54 61 62 20 3d 20 30 3b 0a 20 20 43 e *pTab = 0;. C
1b530 6f 6c 75 6d 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b olumn *pCol = 0;
1b540 0a 20 20 69 6e 74 20 69 43 6f 6c 20 3d 20 30 3b . int iCol = 0;
1b550 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a . char const *z
1b560 44 61 74 61 54 79 70 65 20 3d 20 30 3b 0a 20 20 DataType = 0;.
1b570 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 43 6f 6c char const *zCol
1b580 6c 53 65 71 20 3d 20 30 3b 0a 20 20 69 6e 74 20 lSeq = 0;. int
1b590 6e 6f 74 6e 75 6c 6c 20 3d 20 30 3b 0a 20 20 69 notnull = 0;. i
1b5a0 6e 74 20 70 72 69 6d 61 72 79 6b 65 79 20 3d 20 nt primarykey =
1b5b0 30 3b 0a 20 20 69 6e 74 20 61 75 74 6f 69 6e 63 0;. int autoinc
1b5c0 20 3d 20 30 3b 0a 0a 0a 23 69 66 64 65 66 20 53 = 0;...#ifdef S
1b5d0 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
1b5e0 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
1b5f0 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
1b600 4f 6b 28 64 62 29 20 7c 7c 20 7a 54 61 62 6c 65 Ok(db) || zTable
1b610 4e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72 Name==0 ){. r
1b620 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
1b630 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 USE_BKPT;. }.#e
1b640 6e 64 69 66 0a 0a 20 20 2f 2a 20 45 6e 73 75 72 ndif.. /* Ensur
1b650 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 e the database s
1b660 63 68 65 6d 61 20 68 61 73 20 62 65 65 6e 20 6c chema has been l
1b670 6f 61 64 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 oaded */. sqlit
1b680 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1b690 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c b->mutex);. sql
1b6a0 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c ite3BtreeEnterAl
1b6b0 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 l(db);. rc = sq
1b6c0 6c 69 74 65 33 49 6e 69 74 28 64 62 2c 20 26 7a lite3Init(db, &z
1b6d0 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 53 ErrMsg);. if( S
1b6e0 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a QLITE_OK!=rc ){.
1b6f0 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1b700 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4c 6f ut;. }.. /* Lo
1b710 63 61 74 65 20 74 68 65 20 74 61 62 6c 65 20 69 cate the table i
1b720 6e 20 71 75 65 73 74 69 6f 6e 20 2a 2f 0a 20 20 n question */.
1b730 70 54 61 62 20 3d 20 73 71 6c 69 74 65 33 46 69 pTab = sqlite3Fi
1b740 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 54 61 62 ndTable(db, zTab
1b750 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 leName, zDbName)
1b760 3b 0a 20 20 69 66 28 20 21 70 54 61 62 20 7c 7c ;. if( !pTab ||
1b770 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 74 20 29 pTab->pSelect )
1b780 7b 0a 20 20 20 20 70 54 61 62 20 3d 20 30 3b 0a {. pTab = 0;.
1b790 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1b7a0 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 ut;. }.. /* Fi
1b7b0 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66 6f nd the column fo
1b7c0 72 20 77 68 69 63 68 20 69 6e 66 6f 20 69 73 20 r which info is
1b7d0 72 65 71 75 65 73 74 65 64 20 2a 2f 0a 20 20 69 requested */. i
1b7e0 66 28 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 3d 3d f( zColumnName==
1b7f0 30 20 29 7b 0a 20 20 20 20 2f 2a 20 51 75 65 72 0 ){. /* Quer
1b800 79 20 66 6f 72 20 65 78 69 73 74 61 6e 63 65 20 y for existance
1b810 6f 66 20 74 61 62 6c 65 20 6f 6e 6c 79 20 2a 2f of table only */
1b820 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 66 6f . }else{. fo
1b830 72 28 69 43 6f 6c 3d 30 3b 20 69 43 6f 6c 3c 70 r(iCol=0; iCol<p
1b840 54 61 62 2d 3e 6e 43 6f 6c 3b 20 69 43 6f 6c 2b Tab->nCol; iCol+
1b850 2b 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d +){. pCol =
1b860 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f &pTab->aCol[iCo
1b870 6c 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d l];. if( 0=
1b880 3d 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 =sqlite3StrICmp(
1b890 70 43 6f 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 6f pCol->zName, zCo
1b8a0 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a 20 20 20 lumnName) ){.
1b8b0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1b8c0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
1b8d0 28 20 69 43 6f 6c 3d 3d 70 54 61 62 2d 3e 6e 43 ( iCol==pTab->nC
1b8e0 6f 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ol ){. if(
1b8f0 48 61 73 52 6f 77 69 64 28 70 54 61 62 29 20 26 HasRowid(pTab) &
1b900 26 20 73 71 6c 69 74 65 33 49 73 52 6f 77 69 64 & sqlite3IsRowid
1b910 28 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b (zColumnName) ){
1b920 0a 20 20 20 20 20 20 20 20 69 43 6f 6c 20 3d 20 . iCol =
1b930 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 pTab->iPKey;.
1b940 20 20 20 20 20 70 43 6f 6c 20 3d 20 69 43 6f 6c pCol = iCol
1b950 3e 3d 30 20 3f 20 26 70 54 61 62 2d 3e 61 43 6f >=0 ? &pTab->aCo
1b960 6c 5b 69 43 6f 6c 5d 20 3a 20 30 3b 0a 20 20 20 l[iCol] : 0;.
1b970 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1b980 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 pTab = 0;.
1b990 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1b9a0 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ut;. }.
1b9b0 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 }. }.. /* The
1b9c0 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 following block
1b9d0 73 74 6f 72 65 73 20 74 68 65 20 6d 65 74 61 20 stores the meta
1b9e0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 information that
1b9f0 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
1ba00 64 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 63 61 d. ** to the ca
1ba10 6c 6c 65 72 20 69 6e 20 6c 6f 63 61 6c 20 76 61 ller in local va
1ba20 72 69 61 62 6c 65 73 20 7a 44 61 74 61 54 79 70 riables zDataTyp
1ba30 65 2c 20 7a 43 6f 6c 6c 53 65 71 2c 20 6e 6f 74 e, zCollSeq, not
1ba40 6e 75 6c 6c 2c 20 70 72 69 6d 61 72 79 6b 65 79 null, primarykey
1ba50 0a 20 20 2a 2a 20 61 6e 64 20 61 75 74 6f 69 6e . ** and autoin
1ba60 63 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 c. At this point
1ba70 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 there are two p
1ba80 6f 73 73 69 62 69 6c 69 74 69 65 73 3a 0a 20 20 ossibilities:.
1ba90 2a 2a 20 0a 20 20 2a 2a 20 20 20 20 20 31 2e 20 ** . ** 1.
1baa0 54 68 65 20 73 70 65 63 69 66 69 65 64 20 63 6f The specified co
1bab0 6c 75 6d 6e 20 6e 61 6d 65 20 77 61 73 20 72 6f lumn name was ro
1bac0 77 69 64 22 2c 20 22 6f 69 64 22 20 6f 72 20 22 wid", "oid" or "
1bad0 5f 72 6f 77 69 64 5f 22 20 0a 20 20 2a 2a 20 20 _rowid_" . **
1bae0 20 20 20 20 20 20 61 6e 64 20 74 68 65 72 65 20 and there
1baf0 69 73 20 6e 6f 20 65 78 70 6c 69 63 69 74 6c 79 is no explicitly
1bb00 20 64 65 63 6c 61 72 65 64 20 49 50 4b 20 63 6f declared IPK co
1bb10 6c 75 6d 6e 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a lumn. . **. **
1bb20 20 20 20 20 20 32 2e 20 54 68 65 20 74 61 62 6c 2. The tabl
1bb30 65 20 69 73 20 6e 6f 74 20 61 20 76 69 65 77 20 e is not a view
1bb40 61 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e and the column n
1bb50 61 6d 65 20 69 64 65 6e 74 69 66 69 65 64 20 61 ame identified a
1bb60 6e 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 65 n . ** e
1bb70 78 70 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 72 xplicitly declar
1bb80 65 64 20 63 6f 6c 75 6d 6e 2e 20 43 6f 70 79 20 ed column. Copy
1bb90 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
1bba0 20 66 72 6f 6d 20 2a 70 43 6f 6c 2e 0a 20 20 2a from *pCol.. *
1bbb0 2f 20 0a 20 20 69 66 28 20 70 43 6f 6c 20 29 7b / . if( pCol ){
1bbc0 0a 20 20 20 20 7a 44 61 74 61 54 79 70 65 20 3d . zDataType =
1bbd0 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 54 79 sqlite3ColumnTy
1bbe0 70 65 28 70 43 6f 6c 2c 30 29 3b 0a 20 20 20 20 pe(pCol,0);.
1bbf0 7a 43 6f 6c 6c 53 65 71 20 3d 20 70 43 6f 6c 2d zCollSeq = pCol-
1bc00 3e 7a 43 6f 6c 6c 3b 0a 20 20 20 20 6e 6f 74 6e >zColl;. notn
1bc10 75 6c 6c 20 3d 20 70 43 6f 6c 2d 3e 6e 6f 74 4e ull = pCol->notN
1bc20 75 6c 6c 21 3d 30 3b 0a 20 20 20 20 70 72 69 6d ull!=0;. prim
1bc30 61 72 79 6b 65 79 20 20 3d 20 28 70 43 6f 6c 2d arykey = (pCol-
1bc40 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 >colFlags & COLF
1bc50 4c 41 47 5f 50 52 49 4d 4b 45 59 29 21 3d 30 3b LAG_PRIMKEY)!=0;
1bc60 0a 20 20 20 20 61 75 74 6f 69 6e 63 20 3d 20 70 . autoinc = p
1bc70 54 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c Tab->iPKey==iCol
1bc80 20 26 26 20 28 70 54 61 62 2d 3e 74 61 62 46 6c && (pTab->tabFl
1bc90 61 67 73 20 26 20 54 46 5f 41 75 74 6f 69 6e 63 ags & TF_Autoinc
1bca0 72 65 6d 65 6e 74 29 21 3d 30 3b 0a 20 20 7d 65 rement)!=0;. }e
1bcb0 6c 73 65 7b 0a 20 20 20 20 7a 44 61 74 61 54 79 lse{. zDataTy
1bcc0 70 65 20 3d 20 22 49 4e 54 45 47 45 52 22 3b 0a pe = "INTEGER";.
1bcd0 20 20 20 20 70 72 69 6d 61 72 79 6b 65 79 20 3d primarykey =
1bce0 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 7a 1;. }. if( !z
1bcf0 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20 20 7a CollSeq ){. z
1bd00 43 6f 6c 6c 53 65 71 20 3d 20 73 71 6c 69 74 65 CollSeq = sqlite
1bd10 33 53 74 72 42 49 4e 41 52 59 3b 0a 20 20 7d 0a 3StrBINARY;. }.
1bd20 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 73 71 .error_out:. sq
1bd30 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 lite3BtreeLeaveA
1bd40 6c 6c 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 57 68 ll(db);.. /* Wh
1bd50 65 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 ether the functi
1bd60 6f 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 on call succeede
1bd70 64 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 d or failed, set
1bd80 20 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 the output para
1bd90 6d 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 meters. ** to w
1bda0 68 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f hatever their lo
1bdb0 63 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 cal counterparts
1bdc0 20 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 contain. If an
1bdd0 65 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c error did occur,
1bde0 0a 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 . ** this has t
1bdf0 68 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 he effect of zer
1be00 6f 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 oing all output
1be10 70 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f parameters.. */
1be20 0a 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 . if( pzDataTyp
1be30 65 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 e ) *pzDataType
1be40 3d 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 = zDataType;. i
1be50 66 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a f( pzCollSeq ) *
1be60 70 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c pzCollSeq = zCol
1be70 6c 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 lSeq;. if( pNot
1be80 4e 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c Null ) *pNotNull
1be90 20 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 = notnull;. if
1bea0 28 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 ( pPrimaryKey )
1beb0 2a 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 *pPrimaryKey = p
1bec0 72 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 rimarykey;. if(
1bed0 20 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 pAutoinc ) *pAu
1bee0 74 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b toinc = autoinc;
1bef0 0a 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f .. if( SQLITE_O
1bf00 4b 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 K==rc && !pTab )
1bf10 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 {. sqlite3DbF
1bf20 72 65 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 ree(db, zErrMsg)
1bf30 3b 0a 20 20 20 20 7a 45 72 72 4d 73 67 20 3d 20 ;. zErrMsg =
1bf40 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 sqlite3MPrintf(d
1bf50 62 2c 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c b, "no such tabl
1bf60 65 20 63 6f 6c 75 6d 6e 3a 20 25 73 2e 25 73 22 e column: %s.%s"
1bf70 2c 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 0a 20 20 , zTableName,.
1bf80 20 20 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d zColumnNam
1bf90 65 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c e);. rc = SQL
1bfa0 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 ITE_ERROR;. }.
1bfb0 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 sqlite3ErrorWit
1bfc0 68 4d 73 67 28 64 62 2c 20 72 63 2c 20 28 7a 45 hMsg(db, rc, (zE
1bfd0 72 72 4d 73 67 3f 22 25 73 22 3a 30 29 2c 20 7a rrMsg?"%s":0), z
1bfe0 45 72 72 4d 73 67 29 3b 0a 20 20 73 71 6c 69 74 ErrMsg);. sqlit
1bff0 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72 e3DbFree(db, zEr
1c000 72 4d 73 67 29 3b 0a 20 20 72 63 20 3d 20 73 71 rMsg);. rc = sq
1c010 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
1c020 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
1c030 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
1c040 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
1c050 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6c rc;.}../*.** Sl
1c060 65 65 70 20 66 6f 72 20 61 20 6c 69 74 74 6c 65 eep for a little
1c070 20 77 68 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 while. Return
1c080 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 the amount of ti
1c090 6d 65 20 73 6c 65 70 74 2e 0a 2a 2f 0a 69 6e 74 me slept..*/.int
1c0a0 20 73 71 6c 69 74 65 33 5f 73 6c 65 65 70 28 69 sqlite3_sleep(i
1c0b0 6e 74 20 6d 73 29 7b 0a 20 20 73 71 6c 69 74 65 nt ms){. sqlite
1c0c0 33 5f 76 66 73 20 2a 70 56 66 73 3b 0a 20 20 69 3_vfs *pVfs;. i
1c0d0 6e 74 20 72 63 3b 0a 20 20 70 56 66 73 20 3d 20 nt rc;. pVfs =
1c0e0 73 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 sqlite3_vfs_find
1c0f0 28 30 29 3b 0a 20 20 69 66 28 20 70 56 66 73 3d (0);. if( pVfs=
1c100 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 0a =0 ) return 0;..
1c110 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 /* This functi
1c120 6f 6e 20 77 6f 72 6b 73 20 69 6e 20 6d 69 6c 6c on works in mill
1c130 69 73 65 63 6f 6e 64 73 2c 20 62 75 74 20 74 68 iseconds, but th
1c140 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 4f 73 53 e underlying OsS
1c150 6c 65 65 70 28 29 20 0a 20 20 2a 2a 20 41 50 49 leep() . ** API
1c160 20 75 73 65 73 20 6d 69 63 72 6f 73 65 63 6f 6e uses microsecon
1c170 64 73 2e 20 48 65 6e 63 65 20 74 68 65 20 31 30 ds. Hence the 10
1c180 30 30 27 73 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 00's.. */. rc
1c190 3d 20 28 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 = (sqlite3OsSlee
1c1a0 70 28 70 56 66 73 2c 20 31 30 30 30 2a 6d 73 29 p(pVfs, 1000*ms)
1c1b0 2f 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e /1000);. return
1c1c0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 6e rc;.}../*.** En
1c1d0 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 able or disable
1c1e0 74 68 65 20 65 78 74 65 6e 64 65 64 20 72 65 73 the extended res
1c1f0 75 6c 74 20 63 6f 64 65 73 2e 0a 2a 2f 0a 69 6e ult codes..*/.in
1c200 74 20 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 t sqlite3_extend
1c210 65 64 5f 72 65 73 75 6c 74 5f 63 6f 64 65 73 28 ed_result_codes(
1c220 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
1c230 20 6f 6e 6f 66 66 29 7b 0a 23 69 66 64 65 66 20 onoff){.#ifdef
1c240 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
1c250 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
1c260 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
1c270 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e kOk(db) ) return
1c280 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
1c290 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 KPT;.#endif. sq
1c2a0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
1c2b0 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
1c2c0 64 62 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 6f 6e db->errMask = on
1c2d0 6f 66 66 20 3f 20 30 78 66 66 66 66 66 66 66 66 off ? 0xffffffff
1c2e0 20 3a 20 30 78 66 66 3b 0a 20 20 73 71 6c 69 74 : 0xff;. sqlit
1c2f0 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
1c300 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
1c310 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
1c320 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 ../*.** Invoke t
1c330 68 65 20 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 he xFileControl
1c340 6d 65 74 68 6f 64 20 6f 6e 20 61 20 70 61 72 74 method on a part
1c350 69 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 2e icular database.
1c360 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
1c370 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c 28 73 71 6c file_control(sql
1c380 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 ite3 *db, const
1c390 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 2c 20 69 char *zDbName, i
1c3a0 6e 74 20 6f 70 2c 20 76 6f 69 64 20 2a 70 41 72 nt op, void *pAr
1c3b0 67 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 g){. int rc = S
1c3c0 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 42 QLITE_ERROR;. B
1c3d0 74 72 65 65 20 2a 70 42 74 72 65 65 3b 0a 0a 23 tree *pBtree;..#
1c3e0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
1c3f0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
1c400 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
1c410 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 tyCheckOk(db) )
1c420 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
1c430 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
1c440 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
1c450 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
1c460 78 29 3b 0a 20 20 70 42 74 72 65 65 20 3d 20 73 x);. pBtree = s
1c470 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 qlite3DbNameToBt
1c480 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 6d 65 29 ree(db, zDbName)
1c490 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 20 29 ;. if( pBtree )
1c4a0 7b 0a 20 20 20 20 50 61 67 65 72 20 2a 70 50 61 {. Pager *pPa
1c4b0 67 65 72 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ger;. sqlite3
1c4c0 5f 66 69 6c 65 20 2a 66 64 3b 0a 20 20 20 20 73 _file *fd;. s
1c4d0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1c4e0 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 70 50 (pBtree);. pP
1c4f0 61 67 65 72 20 3d 20 73 71 6c 69 74 65 33 42 74 ager = sqlite3Bt
1c500 72 65 65 50 61 67 65 72 28 70 42 74 72 65 65 29 reePager(pBtree)
1c510 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
1c520 61 67 65 72 21 3d 30 20 29 3b 0a 20 20 20 20 66 ager!=0 );. f
1c530 64 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 d = sqlite3Pager
1c540 46 69 6c 65 28 70 50 61 67 65 72 29 3b 0a 20 20 File(pPager);.
1c550 20 20 61 73 73 65 72 74 28 20 66 64 21 3d 30 20 assert( fd!=0
1c560 29 3b 0a 20 20 20 20 69 66 28 20 6f 70 3d 3d 53 );. if( op==S
1c570 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 46 49 4c 45 QLITE_FCNTL_FILE
1c580 5f 50 4f 49 4e 54 45 52 20 29 7b 0a 20 20 20 20 _POINTER ){.
1c590 20 20 2a 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 *(sqlite3_file
1c5a0 2a 2a 29 70 41 72 67 20 3d 20 66 64 3b 0a 20 20 **)pArg = fd;.
1c5b0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
1c5c0 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 OK;. }else if
1c5d0 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 46 43 4e ( op==SQLITE_FCN
1c5e0 54 4c 5f 56 46 53 5f 50 4f 49 4e 54 45 52 20 29 TL_VFS_POINTER )
1c5f0 7b 0a 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 {. *(sqlite
1c600 33 5f 76 66 73 2a 2a 29 70 41 72 67 20 3d 20 73 3_vfs**)pArg = s
1c610 71 6c 69 74 65 33 50 61 67 65 72 56 66 73 28 70 qlite3PagerVfs(p
1c620 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 72 63 Pager);. rc
1c630 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1c640 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 70 3d 3d }else if( op==
1c650 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4a 4f 55 SQLITE_FCNTL_JOU
1c660 52 4e 41 4c 5f 50 4f 49 4e 54 45 52 20 29 7b 0a RNAL_POINTER ){.
1c670 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 33 5f *(sqlite3_
1c680 66 69 6c 65 2a 2a 29 70 41 72 67 20 3d 20 73 71 file**)pArg = sq
1c690 6c 69 74 65 33 50 61 67 65 72 4a 72 6e 6c 46 69 lite3PagerJrnlFi
1c6a0 6c 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 le(pPager);.
1c6b0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
1c6c0 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
1c6d0 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a fd->pMethods ){.
1c6e0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
1c6f0 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 e3OsFileControl(
1c700 66 64 2c 20 6f 70 2c 20 70 41 72 67 29 3b 0a 20 fd, op, pArg);.
1c710 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1c720 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 46 rc = SQLITE_NOTF
1c730 4f 55 4e 44 3b 0a 20 20 20 20 7d 0a 20 20 20 20 OUND;. }.
1c740 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1c750 65 28 70 42 74 72 65 65 29 3b 0a 20 20 7d 0a 20 e(pBtree);. }.
1c760 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
1c770 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
1c780 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
1c790 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 72 66 61 63 65 ./*.** Interface
1c7a0 20 74 6f 20 74 68 65 20 74 65 73 74 69 6e 67 20 to the testing
1c7b0 6c 6f 67 69 63 2e 0a 2a 2f 0a 69 6e 74 20 73 71 logic..*/.int sq
1c7c0 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 lite3_test_contr
1c7d0 6f 6c 28 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 7b ol(int op, ...){
1c7e0 0a 20 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a 23 . int rc = 0;.#
1c7f0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 54 ifdef SQLITE_UNT
1c800 45 53 54 41 42 4c 45 0a 20 20 55 4e 55 53 45 44 ESTABLE. UNUSED
1c810 5f 50 41 52 41 4d 45 54 45 52 28 6f 70 29 3b 0a _PARAMETER(op);.
1c820 23 65 6c 73 65 0a 20 20 76 61 5f 6c 69 73 74 20 #else. va_list
1c830 61 70 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 ap;. va_start(a
1c840 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 p, op);. switch
1c850 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 0a ( op ){.. /*.
1c860 20 20 20 20 2a 2a 20 53 61 76 65 20 74 68 65 20 ** Save the
1c870 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 current state of
1c880 20 74 68 65 20 50 52 4e 47 2e 0a 20 20 20 20 2a the PRNG.. *
1c890 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
1c8a0 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e 47 5f E_TESTCTRL_PRNG_
1c8b0 53 41 56 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 SAVE: {. sq
1c8c0 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 61 lite3PrngSaveSta
1c8d0 74 65 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 te();. brea
1c8e0 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
1c8f0 0a 20 20 20 20 2a 2a 20 52 65 73 74 6f 72 65 20 . ** Restore
1c900 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 the state of the
1c910 20 50 52 4e 47 20 74 6f 20 74 68 65 20 6c 61 73 PRNG to the las
1c920 74 20 73 74 61 74 65 20 73 61 76 65 64 20 75 73 t state saved us
1c930 69 6e 67 0a 20 20 20 20 2a 2a 20 50 52 4e 47 5f ing. ** PRNG_
1c940 53 41 56 45 2e 20 20 49 66 20 50 52 4e 47 5f 53 SAVE. If PRNG_S
1c950 41 56 45 20 68 61 73 20 6e 65 76 65 72 20 62 65 AVE has never be
1c960 66 6f 72 65 20 62 65 65 6e 20 63 61 6c 6c 65 64 fore been called
1c970 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68 , then. ** th
1c980 69 73 20 76 65 72 62 20 61 63 74 73 20 6c 69 6b is verb acts lik
1c990 65 20 50 52 4e 47 5f 52 45 53 45 54 2e 0a 20 20 e PRNG_RESET..
1c9a0 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
1c9b0 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 LITE_TESTCTRL_PR
1c9c0 4e 47 5f 52 45 53 54 4f 52 45 3a 20 7b 0a 20 20 NG_RESTORE: {.
1c9d0 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 52 sqlite3PrngR
1c9e0 65 73 74 6f 72 65 53 74 61 74 65 28 29 3b 0a 20 estoreState();.
1c9f0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1ca00 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a }.. /*. **
1ca10 20 52 65 73 65 74 20 74 68 65 20 50 52 4e 47 20 Reset the PRNG
1ca20 62 61 63 6b 20 74 6f 20 69 74 73 20 75 6e 69 6e back to its unin
1ca30 69 74 69 61 6c 69 7a 65 64 20 73 74 61 74 65 2e itialized state.
1ca40 20 20 54 68 65 20 6e 65 78 74 20 63 61 6c 6c 0a The next call.
1ca50 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 ** to sqlite
1ca60 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 29 20 77 3_randomness() w
1ca70 69 6c 6c 20 72 65 73 65 65 64 20 74 68 65 20 50 ill reseed the P
1ca80 52 4e 47 20 75 73 69 6e 67 20 61 20 73 69 6e 67 RNG using a sing
1ca90 6c 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 le call. ** t
1caa0 6f 20 74 68 65 20 78 52 61 6e 64 6f 6d 6e 65 73 o the xRandomnes
1cab0 73 20 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 s method of the
1cac0 64 65 66 61 75 6c 74 20 56 46 53 2e 0a 20 20 20 default VFS..
1cad0 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1cae0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e ITE_TESTCTRL_PRN
1caf0 47 5f 52 45 53 45 54 3a 20 7b 0a 20 20 20 20 20 G_RESET: {.
1cb00 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e sqlite3_randomn
1cb10 65 73 73 28 30 2c 30 29 3b 0a 20 20 20 20 20 20 ess(0,0);.
1cb20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1cb30 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c /*. ** sql
1cb40 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
1cb50 6c 28 42 49 54 56 45 43 5f 54 45 53 54 2c 20 73 l(BITVEC_TEST, s
1cb60 69 7a 65 2c 20 70 72 6f 67 72 61 6d 29 0a 20 20 ize, program).
1cb70 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 75 6e 20 **. ** Run
1cb80 61 20 74 65 73 74 20 61 67 61 69 6e 73 74 20 61 a test against a
1cb90 20 42 69 74 76 65 63 20 6f 62 6a 65 63 74 20 6f Bitvec object o
1cba0 66 20 73 69 7a 65 2e 20 20 54 68 65 20 70 72 6f f size. The pro
1cbb0 67 72 61 6d 20 61 72 67 75 6d 65 6e 74 0a 20 20 gram argument.
1cbc0 20 20 2a 2a 20 69 73 20 61 6e 20 61 72 72 61 79 ** is an array
1cbd0 20 6f 66 20 69 6e 74 65 67 65 72 73 20 74 68 61 of integers tha
1cbe0 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 74 65 t defines the te
1cbf0 73 74 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 6f st. Return -1 o
1cc00 6e 20 61 0a 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 n a. ** memor
1cc10 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 65 72 72 y allocation err
1cc20 6f 72 2c 20 30 20 6f 6e 20 73 75 63 63 65 73 73 or, 0 on success
1cc30 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f 20 66 6f , or non-zero fo
1cc40 72 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 20 20 r an error..
1cc50 2a 2a 20 53 65 65 20 74 68 65 20 73 71 6c 69 74 ** See the sqlit
1cc60 65 33 42 69 74 76 65 63 42 75 69 6c 74 69 6e 54 e3BitvecBuiltinT
1cc70 65 73 74 28 29 20 66 6f 72 20 61 64 64 69 74 69 est() for additi
1cc80 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
1cc90 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1cca0 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1ccb0 4c 5f 42 49 54 56 45 43 5f 54 45 53 54 3a 20 7b L_BITVEC_TEST: {
1ccc0 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 3d 20 . int sz =
1ccd0 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
1cce0 0a 20 20 20 20 20 20 69 6e 74 20 2a 61 50 72 6f . int *aPro
1ccf0 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 g = va_arg(ap, i
1cd00 6e 74 2a 29 3b 0a 20 20 20 20 20 20 72 63 20 3d nt*);. rc =
1cd10 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 sqlite3BitvecBu
1cd20 69 6c 74 69 6e 54 65 73 74 28 73 7a 2c 20 61 50 iltinTest(sz, aP
1cd30 72 6f 67 29 3b 0a 20 20 20 20 20 20 62 72 65 61 rog);. brea
1cd40 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
1cd50 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 . ** sqlite3
1cd60 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 46 41 _test_control(FA
1cd70 55 4c 54 5f 49 4e 53 54 41 4c 4c 2c 20 78 43 61 ULT_INSTALL, xCa
1cd80 6c 6c 62 61 63 6b 29 0a 20 20 20 20 2a 2a 0a 20 llback). **.
1cd90 20 20 20 2a 2a 20 41 72 72 61 6e 67 65 20 74 6f ** Arrange to
1cda0 20 69 6e 76 6f 6b 65 20 78 43 61 6c 6c 62 61 63 invoke xCallbac
1cdb0 6b 28 29 20 77 68 65 6e 65 76 65 72 20 73 71 6c k() whenever sql
1cdc0 69 74 65 33 46 61 75 6c 74 53 69 6d 28 29 20 69 ite3FaultSim() i
1cdd0 73 20 63 61 6c 6c 65 64 2c 0a 20 20 20 20 2a 2a s called,. **
1cde0 20 69 66 20 78 43 61 6c 6c 62 61 63 6b 20 69 73 if xCallback is
1cdf0 20 6e 6f 74 20 4e 55 4c 4c 2e 0a 20 20 20 20 2a not NULL.. *
1ce00 2a 0a 20 20 20 20 2a 2a 20 41 73 20 61 20 74 65 *. ** As a te
1ce10 73 74 20 6f 66 20 74 68 65 20 66 61 75 6c 74 20 st of the fault
1ce20 73 69 6d 75 6c 61 74 6f 72 20 6d 65 63 68 61 6e simulator mechan
1ce30 69 73 6d 20 69 74 73 65 6c 66 2c 20 73 71 6c 69 ism itself, sqli
1ce40 74 65 33 46 61 75 6c 74 53 69 6d 28 30 29 0a 20 te3FaultSim(0).
1ce50 20 20 20 2a 2a 20 69 73 20 63 61 6c 6c 65 64 20 ** is called
1ce60 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 immediately afte
1ce70 72 20 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 r installing the
1ce80 20 6e 65 77 20 63 61 6c 6c 62 61 63 6b 20 61 6e new callback an
1ce90 64 20 74 68 65 20 72 65 74 75 72 6e 0a 20 20 20 d the return.
1cea0 20 2a 2a 20 76 61 6c 75 65 20 66 72 6f 6d 20 73 ** value from s
1ceb0 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d 28 30 qlite3FaultSim(0
1cec0 29 20 62 65 63 6f 6d 65 73 20 74 68 65 20 72 65 ) becomes the re
1ced0 74 75 72 6e 20 66 72 6f 6d 0a 20 20 20 20 2a 2a turn from. **
1cee0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1cef0 6e 74 72 6f 6c 28 29 2e 0a 20 20 20 20 2a 2f 0a ntrol().. */.
1cf00 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1cf10 54 45 53 54 43 54 52 4c 5f 46 41 55 4c 54 5f 49 TESTCTRL_FAULT_I
1cf20 4e 53 54 41 4c 4c 3a 20 7b 0a 20 20 20 20 20 20 NSTALL: {.
1cf30 2f 2a 20 4d 53 56 43 20 69 73 20 70 69 63 6b 79 /* MSVC is picky
1cf40 20 61 62 6f 75 74 20 70 75 6c 6c 69 6e 67 20 66 about pulling f
1cf50 75 6e 63 20 70 74 72 73 20 66 72 6f 6d 20 76 61 unc ptrs from va
1cf60 20 6c 69 73 74 73 2e 0a 20 20 20 20 20 20 2a 2a lists.. **
1cf70 20 68 74 74 70 3a 2f 2f 73 75 70 70 6f 72 74 2e http://support.
1cf80 6d 69 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 6b 62 microsoft.com/kb
1cf90 2f 34 37 39 36 31 0a 20 20 20 20 20 20 2a 2a 20 /47961. **
1cfa0 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1cfb0 66 69 67 2e 78 54 65 73 74 43 61 6c 6c 62 61 63 fig.xTestCallbac
1cfc0 6b 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 k = va_arg(ap, i
1cfd0 6e 74 28 2a 29 28 69 6e 74 29 29 3b 0a 20 20 20 nt(*)(int));.
1cfe0 20 20 20 2a 2f 0a 20 20 20 20 20 20 74 79 70 65 */. type
1cff0 64 65 66 20 69 6e 74 28 2a 54 45 53 54 43 41 4c def int(*TESTCAL
1d000 4c 42 41 43 4b 46 55 4e 43 5f 74 29 28 69 6e 74 LBACKFUNC_t)(int
1d010 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
1d020 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 54 65 GlobalConfig.xTe
1d030 73 74 43 61 6c 6c 62 61 63 6b 20 3d 20 76 61 5f stCallback = va_
1d040 61 72 67 28 61 70 2c 20 54 45 53 54 43 41 4c 4c arg(ap, TESTCALL
1d050 42 41 43 4b 46 55 4e 43 5f 74 29 3b 0a 20 20 20 BACKFUNC_t);.
1d060 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 46 rc = sqlite3F
1d070 61 75 6c 74 53 69 6d 28 30 29 3b 0a 20 20 20 20 aultSim(0);.
1d080 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a break;. }..
1d090 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
1d0a0 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1d0b0 72 6f 6c 28 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f rol(BENIGN_MALLO
1d0c0 43 5f 48 4f 4f 4b 53 2c 20 78 42 65 67 69 6e 2c C_HOOKS, xBegin,
1d0d0 20 78 45 6e 64 29 0a 20 20 20 20 2a 2a 0a 20 20 xEnd). **.
1d0e0 20 20 2a 2a 20 52 65 67 69 73 74 65 72 20 68 6f ** Register ho
1d0f0 6f 6b 73 20 74 6f 20 63 61 6c 6c 20 74 6f 20 69 oks to call to i
1d100 6e 64 69 63 61 74 65 20 77 68 69 63 68 20 6d 61 ndicate which ma
1d110 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 73 20 lloc() failures
1d120 0a 20 20 20 20 2a 2a 20 61 72 65 20 62 65 6e 69 . ** are beni
1d130 67 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 gn.. */. c
1d140 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1d150 54 52 4c 5f 42 45 4e 49 47 4e 5f 4d 41 4c 4c 4f TRL_BENIGN_MALLO
1d160 43 5f 48 4f 4f 4b 53 3a 20 7b 0a 20 20 20 20 20 C_HOOKS: {.
1d170 20 74 79 70 65 64 65 66 20 76 6f 69 64 20 28 2a typedef void (*
1d180 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 28 76 void_function)(v
1d190 6f 69 64 29 3b 0a 20 20 20 20 20 20 76 6f 69 64 oid);. void
1d1a0 5f 66 75 6e 63 74 69 6f 6e 20 78 42 65 6e 69 67 _function xBenig
1d1b0 6e 42 65 67 69 6e 3b 0a 20 20 20 20 20 20 76 6f nBegin;. vo
1d1c0 69 64 5f 66 75 6e 63 74 69 6f 6e 20 78 42 65 6e id_function xBen
1d1d0 69 67 6e 45 6e 64 3b 0a 20 20 20 20 20 20 78 42 ignEnd;. xB
1d1e0 65 6e 69 67 6e 42 65 67 69 6e 20 3d 20 76 61 5f enignBegin = va_
1d1f0 61 72 67 28 61 70 2c 20 76 6f 69 64 5f 66 75 6e arg(ap, void_fun
1d200 63 74 69 6f 6e 29 3b 0a 20 20 20 20 20 20 78 42 ction);. xB
1d210 65 6e 69 67 6e 45 6e 64 20 3d 20 76 61 5f 61 72 enignEnd = va_ar
1d220 67 28 61 70 2c 20 76 6f 69 64 5f 66 75 6e 63 74 g(ap, void_funct
1d230 69 6f 6e 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 ion);. sqli
1d240 74 65 33 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 48 te3BenignMallocH
1d250 6f 6f 6b 73 28 78 42 65 6e 69 67 6e 42 65 67 69 ooks(xBenignBegi
1d260 6e 2c 20 78 42 65 6e 69 67 6e 45 6e 64 29 3b 0a n, xBenignEnd);.
1d270 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1d280 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a }.. /*. *
1d290 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f * sqlite3_test_
1d2a0 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1d2b0 45 53 54 43 54 52 4c 5f 50 45 4e 44 49 4e 47 5f ESTCTRL_PENDING_
1d2c0 42 59 54 45 2c 20 75 6e 73 69 67 6e 65 64 20 69 BYTE, unsigned i
1d2d0 6e 74 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 nt X). **.
1d2e0 20 2a 2a 20 53 65 74 20 74 68 65 20 50 45 4e 44 ** Set the PEND
1d2f0 49 4e 47 20 62 79 74 65 20 74 6f 20 74 68 65 20 ING byte to the
1d300 76 61 6c 75 65 20 69 6e 20 74 68 65 20 61 72 67 value in the arg
1d310 75 6d 65 6e 74 2c 20 69 66 20 58 3e 30 2e 0a 20 ument, if X>0..
1d320 20 20 20 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 ** Make no ch
1d330 61 6e 67 65 73 20 69 66 20 58 3d 3d 30 2e 20 20 anges if X==0.
1d340 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 Return the value
1d350 20 6f 66 20 74 68 65 20 70 65 6e 64 69 6e 67 20 of the pending
1d360 62 79 74 65 0a 20 20 20 20 2a 2a 20 61 73 20 69 byte. ** as i
1d370 74 20 65 78 69 73 74 69 6e 67 20 62 65 66 6f 72 t existing befor
1d380 65 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 e this routine w
1d390 61 73 20 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a as called.. *
1d3a0 2a 0a 20 20 20 20 2a 2a 20 49 4d 50 4f 52 54 41 *. ** IMPORTA
1d3b0 4e 54 3a 20 20 43 68 61 6e 67 69 6e 67 20 74 68 NT: Changing th
1d3c0 65 20 50 45 4e 44 49 4e 47 20 62 79 74 65 20 66 e PENDING byte f
1d3d0 72 6f 6d 20 30 78 34 30 30 30 30 30 30 30 20 72 rom 0x40000000 r
1d3e0 65 73 75 6c 74 73 20 69 6e 0a 20 20 20 20 2a 2a esults in. **
1d3f0 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 an incompatible
1d400 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 66 database file f
1d410 6f 72 6d 61 74 2e 20 20 43 68 61 6e 67 69 6e 67 ormat. Changing
1d420 20 74 68 65 20 50 45 4e 44 49 4e 47 20 62 79 74 the PENDING byt
1d430 65 0a 20 20 20 20 2a 2a 20 77 68 69 6c 65 20 61 e. ** while a
1d440 6e 79 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ny database conn
1d450 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 72 ection is open r
1d460 65 73 75 6c 74 73 20 69 6e 20 75 6e 64 65 66 69 esults in undefi
1d470 6e 65 64 20 61 6e 64 0a 20 20 20 20 2a 2a 20 64 ned and. ** d
1d480 65 6c 65 74 65 72 69 6f 75 73 20 62 65 68 61 76 eleterious behav
1d490 69 6f 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ior.. */.
1d4a0 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
1d4b0 43 54 52 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 CTRL_PENDING_BYT
1d4c0 45 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 E: {. rc =
1d4d0 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 23 69 PENDING_BYTE;.#i
1d4e0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
1d4f0 54 5f 57 53 44 0a 20 20 20 20 20 20 7b 0a 20 20 T_WSD. {.
1d500 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 unsigned i
1d510 6e 74 20 6e 65 77 56 61 6c 20 3d 20 76 61 5f 61 nt newVal = va_a
1d520 72 67 28 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 rg(ap, unsigned
1d530 69 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 69 66 int);. if
1d540 28 20 6e 65 77 56 61 6c 20 29 20 73 71 6c 69 74 ( newVal ) sqlit
1d550 65 33 50 65 6e 64 69 6e 67 42 79 74 65 20 3d 20 e3PendingByte =
1d560 6e 65 77 56 61 6c 3b 0a 20 20 20 20 20 20 7d 0a newVal;. }.
1d570 23 65 6e 64 69 66 0a 20 20 20 20 20 20 62 72 65 #endif. bre
1d580 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1d590 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 *. ** sqlite
1d5a0 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1d5b0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 QLITE_TESTCTRL_A
1d5c0 53 53 45 52 54 2c 20 69 6e 74 20 58 29 0a 20 20 SSERT, int X).
1d5d0 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 **. ** This
1d5e0 20 61 63 74 69 6f 6e 20 70 72 6f 76 69 64 65 73 action provides
1d5f0 20 61 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 a run-time test
1d600 20 74 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 to see whether
1d610 6f 72 20 6e 6f 74 0a 20 20 20 20 2a 2a 20 61 73 or not. ** as
1d620 73 65 72 74 28 29 20 77 61 73 20 65 6e 61 62 6c sert() was enabl
1d630 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ed at compile-ti
1d640 6d 65 2e 20 20 49 66 20 58 20 69 73 20 74 72 75 me. If X is tru
1d650 65 20 61 6e 64 20 61 73 73 65 72 74 28 29 0a 20 e and assert().
1d660 20 20 20 2a 2a 20 69 73 20 65 6e 61 62 6c 65 64 ** is enabled
1d670 2c 20 74 68 65 6e 20 74 68 65 20 72 65 74 75 72 , then the retur
1d680 6e 20 76 61 6c 75 65 20 69 73 20 74 72 75 65 2e n value is true.
1d690 20 20 49 66 20 58 20 69 73 20 74 72 75 65 20 61 If X is true a
1d6a0 6e 64 0a 20 20 20 20 2a 2a 20 61 73 73 65 72 74 nd. ** assert
1d6b0 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 2c 20 () is disabled,
1d6c0 74 68 65 6e 20 74 68 65 20 72 65 74 75 72 6e 20 then the return
1d6d0 76 61 6c 75 65 20 69 73 20 7a 65 72 6f 2e 20 20 value is zero.
1d6e0 49 66 20 58 20 69 73 0a 20 20 20 20 2a 2a 20 66 If X is. ** f
1d6f0 61 6c 73 65 20 61 6e 64 20 61 73 73 65 72 74 28 alse and assert(
1d700 29 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 ) is enabled, th
1d710 65 6e 20 74 68 65 20 61 73 73 65 72 74 69 6f 6e en the assertion
1d720 20 66 69 72 65 73 20 61 6e 64 20 74 68 65 0a 20 fires and the.
1d730 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 61 62 ** process ab
1d740 6f 72 74 73 2e 20 20 49 66 20 58 20 69 73 20 66 orts. If X is f
1d750 61 6c 73 65 20 61 6e 64 20 61 73 73 65 72 74 28 alse and assert(
1d760 29 20 69 73 20 64 69 73 61 62 6c 65 64 2c 20 74 ) is disabled, t
1d770 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 72 hen the. ** r
1d780 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 7a eturn value is z
1d790 65 72 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ero.. */.
1d7a0 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
1d7b0 43 54 52 4c 5f 41 53 53 45 52 54 3a 20 7b 0a 20 CTRL_ASSERT: {.
1d7c0 20 20 20 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e volatile in
1d7d0 74 20 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 t x = 0;. a
1d7e0 73 73 65 72 74 28 20 2f 2a 73 69 64 65 2d 65 66 ssert( /*side-ef
1d7f0 66 65 63 74 73 2d 6f 6b 2a 2f 20 28 78 20 3d 20 fects-ok*/ (x =
1d800 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 29 21 va_arg(ap,int))!
1d810 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20 3d =0 );. rc =
1d820 20 78 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b x;. break;
1d830 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 20 2f 2a 0a . }... /*.
1d840 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
1d850 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1d860 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c 57 ITE_TESTCTRL_ALW
1d870 41 59 53 2c 20 69 6e 74 20 58 29 0a 20 20 20 20 AYS, int X).
1d880 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 61 **. ** This a
1d890 63 74 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 61 ction provides a
1d8a0 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 20 74 run-time test t
1d8b0 6f 20 73 65 65 20 68 6f 77 20 74 68 65 20 41 4c o see how the AL
1d8c0 57 41 59 53 20 61 6e 64 0a 20 20 20 20 2a 2a 20 WAYS and. **
1d8d0 4e 45 56 45 52 20 6d 61 63 72 6f 73 20 77 65 72 NEVER macros wer
1d8e0 65 20 64 65 66 69 6e 65 64 20 61 74 20 63 6f 6d e defined at com
1d8f0 70 69 6c 65 2d 74 69 6d 65 2e 0a 20 20 20 20 2a pile-time.. *
1d900 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 65 74 *. ** The ret
1d910 75 72 6e 20 76 61 6c 75 65 20 69 73 20 41 4c 57 urn value is ALW
1d920 41 59 53 28 58 29 2e 20 20 0a 20 20 20 20 2a 2a AYS(X). . **
1d930 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 65 63 6f . ** The reco
1d940 6d 6d 65 6e 64 65 64 20 74 65 73 74 20 69 73 20 mmended test is
1d950 58 3d 3d 32 2e 20 20 49 66 20 74 68 65 20 72 65 X==2. If the re
1d960 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 32 2c turn value is 2,
1d970 20 74 68 61 74 20 6d 65 61 6e 73 0a 20 20 20 20 that means.
1d980 2a 2a 20 41 4c 57 41 59 53 28 29 20 61 6e 64 20 ** ALWAYS() and
1d990 4e 45 56 45 52 28 29 20 61 72 65 20 62 6f 74 68 NEVER() are both
1d9a0 20 6e 6f 2d 6f 70 20 70 61 73 73 2d 74 68 72 6f no-op pass-thro
1d9b0 75 67 68 20 6d 61 63 72 6f 73 2c 20 77 68 69 63 ugh macros, whic
1d9c0 68 20 69 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 h is the. **
1d9d0 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 2e default setting.
1d9e0 20 20 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 If the return
1d9f0 76 61 6c 75 65 20 69 73 20 31 2c 20 74 68 65 6e value is 1, then
1da00 20 41 4c 57 41 59 53 28 29 20 69 73 20 65 69 74 ALWAYS() is eit
1da10 68 65 72 0a 20 20 20 20 2a 2a 20 68 61 72 64 2d her. ** hard-
1da20 63 6f 64 65 64 20 74 6f 20 74 72 75 65 20 6f 72 coded to true or
1da30 20 65 6c 73 65 20 69 74 20 61 73 73 65 72 74 73 else it asserts
1da40 20 69 66 20 69 74 73 20 61 72 67 75 6d 65 6e 74 if its argument
1da50 20 69 73 20 66 61 6c 73 65 2e 0a 20 20 20 20 2a is false.. *
1da60 2a 20 54 68 65 20 66 69 72 73 74 20 62 65 68 61 * The first beha
1da70 76 69 6f 72 20 28 68 61 72 64 2d 63 6f 64 65 64 vior (hard-coded
1da80 20 74 6f 20 74 72 75 65 29 20 69 73 20 74 68 65 to true) is the
1da90 20 63 61 73 65 20 69 66 0a 20 20 20 20 2a 2a 20 case if. **
1daa0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1dab0 41 53 53 45 52 54 20 73 68 6f 77 73 20 74 68 61 ASSERT shows tha
1dac0 74 20 61 73 73 65 72 74 28 29 20 69 73 20 64 69 t assert() is di
1dad0 73 61 62 6c 65 64 20 61 6e 64 20 74 68 65 20 73 sabled and the s
1dae0 65 63 6f 6e 64 0a 20 20 20 20 2a 2a 20 62 65 68 econd. ** beh
1daf0 61 76 69 6f 72 20 28 61 73 73 65 72 74 20 69 66 avior (assert if
1db00 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f the argument to
1db10 20 41 4c 57 41 59 53 28 29 20 69 73 20 66 61 6c ALWAYS() is fal
1db20 73 65 29 20 69 73 20 74 68 65 20 63 61 73 65 20 se) is the case
1db30 69 66 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 if. ** SQLITE
1db40 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 _TESTCTRL_ASSERT
1db50 20 73 68 6f 77 73 20 74 68 61 74 20 61 73 73 65 shows that asse
1db60 72 74 28 29 20 69 73 20 65 6e 61 62 6c 65 64 2e rt() is enabled.
1db70 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
1db80 68 65 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 he run-time test
1db90 20 70 72 6f 63 65 64 75 72 65 20 6d 69 67 68 74 procedure might
1dba0 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 6e 67 20 look something
1dbb0 6c 69 6b 65 20 74 68 69 73 3a 0a 20 20 20 20 2a like this:. *
1dbc0 2a 0a 20 20 20 20 2a 2a 20 20 20 20 69 66 28 20 *. ** if(
1dbd0 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
1dbe0 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
1dbf0 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 32 29 3d CTRL_ALWAYS, 2)=
1dc00 3d 32 20 29 7b 0a 20 20 20 20 2a 2a 20 20 20 20 =2 ){. **
1dc10 20 20 2f 2f 20 41 4c 57 41 59 53 28 29 20 61 6e // ALWAYS() an
1dc20 64 20 4e 45 56 45 52 28 29 20 61 72 65 20 6e 6f d NEVER() are no
1dc30 2d 6f 70 20 70 61 73 73 2d 74 68 72 6f 75 67 68 -op pass-through
1dc40 20 6d 61 63 72 6f 73 0a 20 20 20 20 2a 2a 20 20 macros. **
1dc50 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69 }else if( sqli
1dc60 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1dc70 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1dc80 5f 41 53 53 45 52 54 2c 20 31 29 20 29 7b 0a 20 _ASSERT, 1) ){.
1dc90 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c ** // AL
1dca0 57 41 59 53 28 78 29 20 61 73 73 65 72 74 73 20 WAYS(x) asserts
1dcb0 74 68 61 74 20 78 20 69 73 20 74 72 75 65 2e 20 that x is true.
1dcc0 4e 45 56 45 52 28 78 29 20 61 73 73 65 72 74 73 NEVER(x) asserts
1dcd0 20 78 20 69 73 20 66 61 6c 73 65 2e 0a 20 20 20 x is false..
1dce0 20 2a 2a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 ** }else{.
1dcf0 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c 57 ** // ALW
1dd00 41 59 53 28 78 29 20 69 73 20 61 20 63 6f 6e 73 AYS(x) is a cons
1dd10 74 61 6e 74 20 31 2e 20 20 4e 45 56 45 52 28 78 tant 1. NEVER(x
1dd20 29 20 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 ) is a constant
1dd30 30 2e 0a 20 20 20 20 2a 2a 20 20 20 20 7d 0a 20 0.. ** }.
1dd40 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1dd50 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 QLITE_TESTCTRL_A
1dd60 4c 57 41 59 53 3a 20 7b 0a 20 20 20 20 20 20 69 LWAYS: {. i
1dd70 6e 74 20 78 20 3d 20 76 61 5f 61 72 67 28 61 70 nt x = va_arg(ap
1dd80 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 72 63 20 ,int);. rc
1dd90 3d 20 41 4c 57 41 59 53 28 78 29 3b 0a 20 20 20 = ALWAYS(x);.
1dda0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1ddb0 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
1ddc0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1ddd0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1dde0 54 43 54 52 4c 5f 42 59 54 45 4f 52 44 45 52 29 TCTRL_BYTEORDER)
1ddf0 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 ;. **. **
1de00 54 68 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 The integer retu
1de10 72 6e 65 64 20 72 65 76 65 61 6c 73 20 74 68 65 rned reveals the
1de20 20 62 79 74 65 2d 6f 72 64 65 72 20 6f 66 20 74 byte-order of t
1de30 68 65 20 63 6f 6d 70 75 74 65 72 20 6f 6e 20 77 he computer on w
1de40 68 69 63 68 0a 20 20 20 20 2a 2a 20 53 51 4c 69 hich. ** SQLi
1de50 74 65 20 69 73 20 72 75 6e 6e 69 6e 67 3a 0a 20 te is running:.
1de60 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 20 **. **
1de70 20 20 20 31 20 20 20 20 20 62 69 67 2d 65 6e 64 1 big-end
1de80 69 61 6e 2c 20 20 20 20 64 65 74 65 72 6d 69 6e ian, determin
1de90 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 ed at run-time.
1dea0 20 20 20 2a 2a 20 20 20 20 20 20 31 30 20 20 20 ** 10
1deb0 20 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61 6e 2c little-endian,
1dec0 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 determined at r
1ded0 75 6e 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 un-time. **
1dee0 34 33 32 31 30 31 20 20 20 20 20 62 69 67 2d 65 432101 big-e
1def0 6e 64 69 61 6e 2c 20 20 20 20 64 65 74 65 72 6d ndian, determ
1df00 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d ined at compile-
1df10 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 31 32 33 time. ** 123
1df20 34 31 30 20 20 20 20 20 6c 69 74 74 6c 65 2d 65 410 little-e
1df30 6e 64 69 61 6e 2c 20 64 65 74 65 72 6d 69 6e 65 ndian, determine
1df40 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d d at compile-tim
1df50 65 0a 20 20 20 20 2a 2f 20 0a 20 20 20 20 63 61 e. */ . ca
1df60 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1df70 52 4c 5f 42 59 54 45 4f 52 44 45 52 3a 20 7b 0a RL_BYTEORDER: {.
1df80 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
1df90 45 5f 42 59 54 45 4f 52 44 45 52 2a 31 30 30 20 E_BYTEORDER*100
1dfa0 2b 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 + SQLITE_LITTLEE
1dfb0 4e 44 49 41 4e 2a 31 30 20 2b 20 53 51 4c 49 54 NDIAN*10 + SQLIT
1dfc0 45 5f 42 49 47 45 4e 44 49 41 4e 3b 0a 20 20 20 E_BIGENDIAN;.
1dfd0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1dfe0 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 . /* sqlite
1dff0 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1e000 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 52 QLITE_TESTCTRL_R
1e010 45 53 45 52 56 45 2c 20 73 71 6c 69 74 65 33 20 ESERVE, sqlite3
1e020 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 20 20 20 *db, int N).
1e030 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 68 **. ** Set th
1e040 65 20 6e 52 65 73 65 72 76 65 20 73 69 7a 65 20 e nReserve size
1e050 74 6f 20 4e 20 66 6f 72 20 74 68 65 20 6d 61 69 to N for the mai
1e060 6e 20 64 61 74 61 62 61 73 65 20 6f 6e 20 74 68 n database on th
1e070 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 2a e database. *
1e080 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64 62 2e * connection db.
1e090 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
1e0a0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1e0b0 5f 52 45 53 45 52 56 45 3a 20 7b 0a 20 20 20 20 _RESERVE: {.
1e0c0 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
1e0d0 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 va_arg(ap, sqlit
1e0e0 65 33 2a 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 e3*);. int
1e0f0 78 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 69 6e x = va_arg(ap,in
1e100 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 t);. sqlite
1e110 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
1e120 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 ->mutex);.
1e130 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 50 sqlite3BtreeSetP
1e140 61 67 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b ageSize(db->aDb[
1e150 30 5d 2e 70 42 74 2c 20 30 2c 20 78 2c 20 30 29 0].pBt, 0, x, 0)
1e160 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
1e170 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
1e180 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 62 72 mutex);. br
1e190 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
1e1a0 2f 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 /* sqlite3_test
1e1b0 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
1e1c0 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a TESTCTRL_OPTIMIZ
1e1d0 41 54 49 4f 4e 53 2c 20 73 71 6c 69 74 65 33 20 ATIONS, sqlite3
1e1e0 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 20 20 20 *db, int N).
1e1f0 2a 2a 0a 20 20 20 20 2a 2a 20 45 6e 61 62 6c 65 **. ** Enable
1e200 20 6f 72 20 64 69 73 61 62 6c 65 20 76 61 72 69 or disable vari
1e210 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ous optimization
1e220 73 20 66 6f 72 20 74 65 73 74 69 6e 67 20 70 75 s for testing pu
1e230 72 70 6f 73 65 73 2e 20 20 54 68 65 20 0a 20 20 rposes. The .
1e240 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 20 4e 20 ** argument N
1e250 69 73 20 61 20 62 69 74 6d 61 73 6b 20 6f 66 20 is a bitmask of
1e260 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 74 6f optimizations to
1e270 20 62 65 20 64 69 73 61 62 6c 65 64 2e 20 20 46 be disabled. F
1e280 6f 72 20 6e 6f 72 6d 61 6c 0a 20 20 20 20 2a 2a or normal. **
1e290 20 6f 70 65 72 61 74 69 6f 6e 20 4e 20 73 68 6f operation N sho
1e2a0 75 6c 64 20 62 65 20 30 2e 20 20 54 68 65 20 69 uld be 0. The i
1e2b0 64 65 61 20 69 73 20 74 68 61 74 20 61 20 74 65 dea is that a te
1e2c0 73 74 20 70 72 6f 67 72 61 6d 20 28 6c 69 6b 65 st program (like
1e2d0 20 74 68 65 0a 20 20 20 20 2a 2a 20 53 51 4c 20 the. ** SQL
1e2e0 4c 6f 67 69 63 20 54 65 73 74 20 6f 72 20 53 4c Logic Test or SL
1e2f0 54 20 74 65 73 74 20 6d 6f 64 75 6c 65 29 20 63 T test module) c
1e300 61 6e 20 72 75 6e 20 74 68 65 20 73 61 6d 65 20 an run the same
1e310 53 51 4c 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d SQL multiple tim
1e320 65 73 0a 20 20 20 20 2a 2a 20 77 69 74 68 20 76 es. ** with v
1e330 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 arious optimizat
1e340 69 6f 6e 73 20 64 69 73 61 62 6c 65 64 20 74 6f ions disabled to
1e350 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 verify that the
1e360 20 73 61 6d 65 20 61 6e 73 77 65 72 0a 20 20 20 same answer.
1e370 20 2a 2a 20 69 73 20 6f 62 74 61 69 6e 65 64 20 ** is obtained
1e380 69 6e 20 65 76 65 72 79 20 63 61 73 65 2e 0a 20 in every case..
1e390 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1e3a0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4f QLITE_TESTCTRL_O
1e3b0 50 54 49 4d 49 5a 41 54 49 4f 4e 53 3a 20 7b 0a PTIMIZATIONS: {.
1e3c0 20 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 sqlite3 *d
1e3d0 62 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 73 b = va_arg(ap, s
1e3e0 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 20 20 qlite3*);.
1e3f0 64 62 2d 3e 64 62 4f 70 74 46 6c 61 67 73 20 3d db->dbOptFlags =
1e400 20 28 75 31 36 29 28 76 61 5f 61 72 67 28 61 70 (u16)(va_arg(ap
1e410 2c 20 69 6e 74 29 20 26 20 30 78 66 66 66 66 29 , int) & 0xffff)
1e420 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
1e430 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c }..#ifdef SQL
1e440 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 44 0a 20 20 ITE_N_KEYWORD.
1e450 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 /* sqlite3_tes
1e460 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
1e470 5f 54 45 53 54 43 54 52 4c 5f 49 53 4b 45 59 57 _TESTCTRL_ISKEYW
1e480 4f 52 44 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 ORD, const char
1e490 2a 7a 57 6f 72 64 29 0a 20 20 20 20 2a 2a 0a 20 *zWord). **.
1e4a0 20 20 20 2a 2a 20 49 66 20 7a 57 6f 72 64 20 69 ** If zWord i
1e4b0 73 20 61 20 6b 65 79 77 6f 72 64 20 72 65 63 6f s a keyword reco
1e4c0 67 6e 69 7a 65 64 20 62 79 20 74 68 65 20 70 61 gnized by the pa
1e4d0 72 73 65 72 2c 20 74 68 65 6e 20 72 65 74 75 72 rser, then retur
1e4e0 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 6e 75 6d n the. ** num
1e4f0 62 65 72 20 6f 66 20 6b 65 79 77 6f 72 64 73 2e ber of keywords.
1e500 20 20 4f 72 20 69 66 20 7a 57 6f 72 64 20 69 73 Or if zWord is
1e510 20 6e 6f 74 20 61 20 6b 65 79 77 6f 72 64 2c 20 not a keyword,
1e520 72 65 74 75 72 6e 20 30 2e 0a 20 20 20 20 2a 2a return 0.. **
1e530 20 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 74 65 . ** This te
1e540 73 74 20 66 65 61 74 75 72 65 20 69 73 20 6f 6e st feature is on
1e550 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 ly available in
1e560 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e the amalgamation
1e570 20 73 69 6e 63 65 0a 20 20 20 20 2a 2a 20 74 68 since. ** th
1e580 65 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f e SQLITE_N_KEYWO
1e590 52 44 20 6d 61 63 72 6f 20 69 73 20 6e 6f 74 20 RD macro is not
1e5a0 64 65 66 69 6e 65 64 20 69 6e 20 74 68 69 73 20 defined in this
1e5b0 66 69 6c 65 20 69 66 20 53 51 4c 69 74 65 0a 20 file if SQLite.
1e5c0 20 20 20 2a 2a 20 69 73 20 62 75 69 6c 74 20 75 ** is built u
1e5d0 73 69 6e 67 20 73 65 70 61 72 61 74 65 20 73 6f sing separate so
1e5e0 75 72 63 65 20 66 69 6c 65 73 2e 0a 20 20 20 20 urce files..
1e5f0 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1e600 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 4b 45 TE_TESTCTRL_ISKE
1e610 59 57 4f 52 44 3a 20 7b 0a 20 20 20 20 20 20 63 YWORD: {. c
1e620 6f 6e 73 74 20 63 68 61 72 20 2a 7a 57 6f 72 64 onst char *zWord
1e630 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 63 6f = va_arg(ap, co
1e640 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 20 20 nst char*);.
1e650 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69 74 65 int n = sqlite
1e660 33 53 74 72 6c 65 6e 33 30 28 7a 57 6f 72 64 29 3Strlen30(zWord)
1e670 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 28 73 71 ;. rc = (sq
1e680 6c 69 74 65 33 4b 65 79 77 6f 72 64 43 6f 64 65 lite3KeywordCode
1e690 28 28 75 38 2a 29 7a 57 6f 72 64 2c 20 6e 29 21 ((u8*)zWord, n)!
1e6a0 3d 54 4b 5f 49 44 29 20 3f 20 53 51 4c 49 54 45 =TK_ID) ? SQLITE
1e6b0 5f 4e 5f 4b 45 59 57 4f 52 44 20 3a 20 30 3b 0a _N_KEYWORD : 0;.
1e6c0 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1e6d0 20 7d 0a 23 65 6e 64 69 66 20 0a 0a 20 20 20 20 }.#endif ..
1e6e0 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f /* sqlite3_test_
1e6f0 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1e700 45 53 54 43 54 52 4c 5f 53 43 52 41 54 43 48 4d ESTCTRL_SCRATCHM
1e710 41 4c 4c 4f 43 2c 20 73 7a 2c 20 26 70 4e 65 77 ALLOC, sz, &pNew
1e720 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 20 2a 2a , pFree);. **
1e730 0a 20 20 20 20 2a 2a 20 50 61 73 73 20 70 46 72 . ** Pass pFr
1e740 65 65 20 69 6e 74 6f 20 73 71 6c 69 74 65 33 53 ee into sqlite3S
1e750 63 72 61 74 63 68 46 72 65 65 28 29 2e 20 0a 20 cratchFree(). .
1e760 20 20 20 2a 2a 20 49 66 20 73 7a 3e 30 20 74 68 ** If sz>0 th
1e770 65 6e 20 61 6c 6c 6f 63 61 74 65 20 61 20 73 63 en allocate a sc
1e780 72 61 74 63 68 20 62 75 66 66 65 72 20 69 6e 74 ratch buffer int
1e790 6f 20 70 4e 65 77 2e 20 20 0a 20 20 20 20 2a 2f o pNew. . */
1e7a0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1e7b0 5f 54 45 53 54 43 54 52 4c 5f 53 43 52 41 54 43 _TESTCTRL_SCRATC
1e7c0 48 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 20 20 HMALLOC: {.
1e7d0 20 76 6f 69 64 20 2a 70 46 72 65 65 2c 20 2a 2a void *pFree, **
1e7e0 70 70 4e 65 77 3b 0a 20 20 20 20 20 20 69 6e 74 ppNew;. int
1e7f0 20 73 7a 3b 0a 20 20 20 20 20 20 73 7a 20 3d 20 sz;. sz =
1e800 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
1e810 0a 20 20 20 20 20 20 70 70 4e 65 77 20 3d 20 76 . ppNew = v
1e820 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 2a a_arg(ap, void**
1e830 29 3b 0a 20 20 20 20 20 20 70 46 72 65 65 20 3d );. pFree =
1e840 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
1e850 2a 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 7a *);. if( sz
1e860 20 29 20 2a 70 70 4e 65 77 20 3d 20 73 71 6c 69 ) *ppNew = sqli
1e870 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f 63 te3ScratchMalloc
1e880 28 73 7a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 (sz);. sqli
1e890 74 65 33 53 63 72 61 74 63 68 46 72 65 65 28 70 te3ScratchFree(p
1e8a0 46 72 65 65 29 3b 0a 20 20 20 20 20 20 62 72 65 Free);. bre
1e8b0 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1e8c0 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 * sqlite3_test
1e8d0 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
1e8e0 54 45 53 54 43 54 52 4c 5f 4c 4f 43 41 4c 54 49 TESTCTRL_LOCALTI
1e8f0 4d 45 5f 46 41 55 4c 54 2c 20 69 6e 74 20 6f 6e ME_FAULT, int on
1e900 6f 66 66 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 off);. **.
1e910 20 2a 2a 20 49 66 20 70 61 72 61 6d 65 74 65 72 ** If parameter
1e920 20 6f 6e 6f 66 66 20 69 73 20 6e 6f 6e 2d 7a 65 onoff is non-ze
1e930 72 6f 2c 20 63 6f 6e 66 69 67 75 72 65 20 74 68 ro, configure th
1e940 65 20 77 72 61 70 70 65 72 73 20 73 6f 20 74 68 e wrappers so th
1e950 61 74 20 61 6c 6c 0a 20 20 20 20 2a 2a 20 73 75 at all. ** su
1e960 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 bsequent calls t
1e970 6f 20 6c 6f 63 61 6c 74 69 6d 65 28 29 20 61 6e o localtime() an
1e980 64 20 76 61 72 69 61 6e 74 73 20 66 61 69 6c 2e d variants fail.
1e990 20 49 66 20 6f 6e 6f 66 66 20 69 73 20 7a 65 72 If onoff is zer
1e9a0 6f 2c 0a 20 20 20 20 2a 2a 20 75 6e 64 6f 20 74 o,. ** undo t
1e9b0 68 69 73 20 73 65 74 74 69 6e 67 2e 0a 20 20 20 his setting..
1e9c0 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1e9d0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4c 4f 43 ITE_TESTCTRL_LOC
1e9e0 41 4c 54 49 4d 45 5f 46 41 55 4c 54 3a 20 7b 0a ALTIME_FAULT: {.
1e9f0 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
1ea00 62 61 6c 43 6f 6e 66 69 67 2e 62 4c 6f 63 61 6c balConfig.bLocal
1ea10 74 69 6d 65 46 61 75 6c 74 20 3d 20 76 61 5f 61 timeFault = va_a
1ea20 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
1ea30 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1ea40 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 . /* sqlite
1ea50 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1ea60 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4e QLITE_TESTCTRL_N
1ea70 45 56 45 52 5f 43 4f 52 52 55 50 54 2c 20 69 6e EVER_CORRUPT, in
1ea80 74 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a t);. **. *
1ea90 2a 20 53 65 74 20 6f 72 20 63 6c 65 61 72 20 61 * Set or clear a
1eaa0 20 66 6c 61 67 20 74 68 61 74 20 69 6e 64 69 63 flag that indic
1eab0 61 74 65 73 20 74 68 61 74 20 74 68 65 20 64 61 ates that the da
1eac0 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 61 tabase file is a
1ead0 6c 77 61 79 73 20 77 65 6c 6c 2d 0a 20 20 20 20 lways well-.
1eae0 2a 2a 20 66 6f 72 6d 65 64 20 61 6e 64 20 6e 65 ** formed and ne
1eaf0 76 65 72 20 63 6f 72 72 75 70 74 2e 20 20 54 68 ver corrupt. Th
1eb00 69 73 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 is flag is clear
1eb10 20 62 79 20 64 65 66 61 75 6c 74 2c 20 69 6e 64 by default, ind
1eb20 69 63 61 74 69 6e 67 20 74 68 61 74 0a 20 20 20 icating that.
1eb30 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c ** database fil
1eb40 65 73 20 6d 69 67 68 74 20 68 61 76 65 20 61 72 es might have ar
1eb50 62 69 74 72 61 72 79 20 63 6f 72 72 75 70 74 69 bitrary corrupti
1eb60 6f 6e 2e 20 20 53 65 74 74 69 6e 67 20 74 68 65 on. Setting the
1eb70 20 66 6c 61 67 20 64 75 72 69 6e 67 0a 20 20 20 flag during.
1eb80 20 2a 2a 20 74 65 73 74 69 6e 67 20 63 61 75 73 ** testing caus
1eb90 65 73 20 63 65 72 74 61 69 6e 20 61 73 73 65 72 es certain asser
1eba0 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 69 t() statements i
1ebb0 6e 20 74 68 65 20 63 6f 64 65 20 74 6f 20 62 65 n the code to be
1ebc0 20 61 63 74 69 76 61 74 65 64 0a 20 20 20 20 2a activated. *
1ebd0 2a 20 74 68 61 74 20 64 65 6d 6f 6e 73 74 72 61 * that demonstra
1ebe0 74 20 69 6e 76 61 72 69 61 6e 74 73 20 6f 6e 20 t invariants on
1ebf0 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 well-formed data
1ec00 62 61 73 65 20 66 69 6c 65 73 2e 0a 20 20 20 20 base files..
1ec10 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1ec20 54 45 5f 54 45 53 54 43 54 52 4c 5f 4e 45 56 45 TE_TESTCTRL_NEVE
1ec30 52 5f 43 4f 52 52 55 50 54 3a 20 7b 0a 20 20 20 R_CORRUPT: {.
1ec40 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
1ec50 43 6f 6e 66 69 67 2e 6e 65 76 65 72 43 6f 72 72 Config.neverCorr
1ec60 75 70 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c upt = va_arg(ap,
1ec70 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 int);. bre
1ec80 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1ec90 2a 20 53 65 74 20 74 68 65 20 74 68 72 65 73 68 * Set the thresh
1eca0 6f 6c 64 20 61 74 20 77 68 69 63 68 20 4f 50 5f old at which OP_
1ecb0 4f 6e 63 65 20 63 6f 75 6e 74 65 72 73 20 72 65 Once counters re
1ecc0 73 65 74 20 62 61 63 6b 20 74 6f 20 7a 65 72 6f set back to zero
1ecd0 2e 0a 20 20 20 20 2a 2a 20 42 79 20 64 65 66 61 .. ** By defa
1ece0 75 6c 74 20 74 68 69 73 20 69 73 20 30 78 37 66 ult this is 0x7f
1ecf0 66 66 66 66 66 65 20 28 6f 76 65 72 20 32 20 62 fffffe (over 2 b
1ed00 69 6c 6c 69 6f 6e 29 2c 20 62 75 74 20 74 68 61 illion), but tha
1ed10 74 20 76 61 6c 75 65 20 69 73 0a 20 20 20 20 2a t value is. *
1ed20 2a 20 74 6f 6f 20 62 69 67 20 74 6f 20 74 65 73 * too big to tes
1ed30 74 20 69 6e 20 61 20 72 65 61 73 6f 6e 61 62 6c t in a reasonabl
1ed40 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 e amount of time
1ed50 2c 20 73 6f 20 74 68 69 73 20 63 6f 6e 74 72 6f , so this contro
1ed60 6c 20 69 73 0a 20 20 20 20 2a 2a 20 70 72 6f 76 l is. ** prov
1ed70 69 64 65 64 20 74 6f 20 73 65 74 20 61 20 73 6d ided to set a sm
1ed80 61 6c 6c 20 61 6e 64 20 65 61 73 69 6c 79 20 72 all and easily r
1ed90 65 61 63 68 61 62 6c 65 20 72 65 73 65 74 20 76 eachable reset v
1eda0 61 6c 75 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 alue.. */.
1edb0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1edc0 54 43 54 52 4c 5f 4f 4e 43 45 5f 52 45 53 45 54 TCTRL_ONCE_RESET
1edd0 5f 54 48 52 45 53 48 4f 4c 44 3a 20 7b 0a 20 20 _THRESHOLD: {.
1ede0 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1edf0 6c 43 6f 6e 66 69 67 2e 69 4f 6e 63 65 52 65 73 lConfig.iOnceRes
1ee00 65 74 54 68 72 65 73 68 6f 6c 64 20 3d 20 76 61 etThreshold = va
1ee10 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
1ee20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1ee30 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 }.. /* sqli
1ee40 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1ee50 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1ee60 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 2c 20 _VDBE_COVERAGE,
1ee70 78 43 61 6c 6c 62 61 63 6b 2c 20 70 74 72 29 3b xCallback, ptr);
1ee80 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 . **. ** S
1ee90 65 74 20 74 68 65 20 56 44 42 45 20 63 6f 76 65 et the VDBE cove
1eea0 72 61 67 65 20 63 61 6c 6c 62 61 63 6b 20 66 75 rage callback fu
1eeb0 6e 63 74 69 6f 6e 20 74 6f 20 78 43 61 6c 6c 62 nction to xCallb
1eec0 61 63 6b 20 77 69 74 68 20 63 6f 6e 74 65 78 74 ack with context
1eed0 20 0a 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 . ** pointer
1eee0 20 70 74 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ptr.. */.
1eef0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1ef00 54 43 54 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 TCTRL_VDBE_COVER
1ef10 41 47 45 3a 20 7b 0a 23 69 66 64 65 66 20 53 51 AGE: {.#ifdef SQ
1ef20 4c 49 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 41 LITE_VDBE_COVERA
1ef30 47 45 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 GE. typedef
1ef40 20 76 6f 69 64 20 28 2a 62 72 61 6e 63 68 5f 63 void (*branch_c
1ef50 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 allback)(void*,i
1ef60 6e 74 2c 75 38 2c 75 38 29 3b 0a 20 20 20 20 20 nt,u8,u8);.
1ef70 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1ef80 6e 66 69 67 2e 78 56 64 62 65 42 72 61 6e 63 68 nfig.xVdbeBranch
1ef90 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 62 72 61 = va_arg(ap,bra
1efa0 6e 63 68 5f 63 61 6c 6c 62 61 63 6b 29 3b 0a 20 nch_callback);.
1efb0 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
1efc0 61 6c 43 6f 6e 66 69 67 2e 70 56 64 62 65 42 72 alConfig.pVdbeBr
1efd0 61 6e 63 68 41 72 67 20 3d 20 76 61 5f 61 72 67 anchArg = va_arg
1efe0 28 61 70 2c 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 (ap,void*);.#end
1eff0 69 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a if. break;.
1f000 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 }.. /*
1f010 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
1f020 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
1f030 43 54 52 4c 5f 53 4f 52 54 45 52 5f 4d 4d 41 50 CTRL_SORTER_MMAP
1f040 2c 20 64 62 2c 20 6e 4d 61 78 29 3b 20 2a 2f 0a , db, nMax); */.
1f050 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1f060 54 45 53 54 43 54 52 4c 5f 53 4f 52 54 45 52 5f TESTCTRL_SORTER_
1f070 4d 4d 41 50 3a 20 7b 0a 20 20 20 20 20 20 73 71 MMAP: {. sq
1f080 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 lite3 *db = va_a
1f090 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 rg(ap, sqlite3*)
1f0a0 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e 4d 61 78 ;. db->nMax
1f0b0 53 6f 72 74 65 72 4d 6d 61 70 20 3d 20 76 61 5f SorterMmap = va_
1f0c0 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
1f0d0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1f0e0 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1f0f0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1f100 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1f110 49 53 49 4e 49 54 29 3b 0a 20 20 20 20 2a 2a 0a ISINIT);. **.
1f120 20 20 20 20 2a 2a 20 52 65 74 75 72 6e 20 53 51 ** Return SQ
1f130 4c 49 54 45 5f 4f 4b 20 69 66 20 53 51 4c 69 74 LITE_OK if SQLit
1f140 65 20 68 61 73 20 62 65 65 6e 20 69 6e 69 74 69 e has been initi
1f150 61 6c 69 7a 65 64 20 61 6e 64 20 53 51 4c 49 54 alized and SQLIT
1f160 45 5f 45 52 52 4f 52 20 69 66 0a 20 20 20 20 2a E_ERROR if. *
1f170 2a 20 6e 6f 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 * not.. */.
1f180 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 case SQLITE_TE
1f190 53 54 43 54 52 4c 5f 49 53 49 4e 49 54 3a 20 7b STCTRL_ISINIT: {
1f1a0 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
1f1b0 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1f1c0 73 49 6e 69 74 3d 3d 30 20 29 20 72 63 20 3d 20 sInit==0 ) rc =
1f1d0 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
1f1e0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1f1f0 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c 69 74 65 .. /* sqlite
1f200 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1f210 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 QLITE_TESTCTRL_I
1f220 4d 50 4f 53 54 45 52 2c 20 64 62 2c 20 64 62 4e MPOSTER, db, dbN
1f230 61 6d 65 2c 20 6f 6e 4f 66 66 2c 20 74 6e 75 6d ame, onOff, tnum
1f240 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a );. **. **
1f250 20 54 68 69 73 20 74 65 73 74 20 63 6f 6e 74 72 This test contr
1f260 6f 6c 20 69 73 20 75 73 65 64 20 74 6f 20 63 72 ol is used to cr
1f270 65 61 74 65 20 69 6d 70 6f 73 74 65 72 20 74 61 eate imposter ta
1f280 62 6c 65 73 2e 20 20 22 64 62 22 20 69 73 20 61 bles. "db" is a
1f290 20 70 6f 69 6e 74 65 72 0a 20 20 20 20 2a 2a 20 pointer. **
1f2a0 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
1f2b0 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 64 62 4e connection. dbN
1f2c0 61 6d 65 20 69 73 20 74 68 65 20 64 61 74 61 62 ame is the datab
1f2d0 61 73 65 20 6e 61 6d 65 20 28 65 78 3a 20 22 6d ase name (ex: "m
1f2e0 61 69 6e 22 20 6f 72 0a 20 20 20 20 2a 2a 20 22 ain" or. ** "
1f2f0 74 65 6d 70 22 29 20 77 68 69 63 68 20 77 69 6c temp") which wil
1f300 6c 20 72 65 63 65 69 76 65 20 74 68 65 20 69 6d l receive the im
1f310 70 6f 73 74 65 72 2e 20 20 22 6f 6e 4f 66 66 22 poster. "onOff"
1f320 20 74 75 72 6e 73 20 69 6d 70 6f 73 74 65 72 20 turns imposter
1f330 6d 6f 64 65 20 6f 6e 0a 20 20 20 20 2a 2a 20 6f mode on. ** o
1f340 72 20 6f 66 66 2e 20 20 22 74 6e 75 6d 22 20 69 r off. "tnum" i
1f350 73 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 s the root page
1f360 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 74 6f of the b-tree to
1f370 20 77 68 69 63 68 20 74 68 65 20 69 6d 70 6f 73 which the impos
1f380 74 65 72 0a 20 20 20 20 2a 2a 20 74 61 62 6c 65 ter. ** table
1f390 20 73 68 6f 75 6c 64 20 63 6f 6e 6e 65 63 74 2e should connect.
1f3a0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 . **. ** E
1f3b0 6e 61 62 6c 65 20 69 6d 70 6f 73 74 65 72 20 6d nable imposter m
1f3c0 6f 64 65 20 6f 6e 6c 79 20 77 68 65 6e 20 74 68 ode only when th
1f3d0 65 20 73 63 68 65 6d 61 20 68 61 73 20 61 6c 72 e schema has alr
1f3e0 65 61 64 79 20 62 65 65 6e 20 70 61 72 73 65 64 eady been parsed
1f3f0 2e 20 20 54 68 65 6e 0a 20 20 20 20 2a 2a 20 72 . Then. ** r
1f400 75 6e 20 61 20 73 69 6e 67 6c 65 20 43 52 45 41 un a single CREA
1f410 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 TE TABLE stateme
1f420 6e 74 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 nt to construct
1f430 74 68 65 20 69 6d 70 6f 73 74 65 72 20 74 61 62 the imposter tab
1f440 6c 65 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 le in. ** the
1f450 20 70 61 72 73 65 64 20 73 63 68 65 6d 61 2e 20 parsed schema.
1f460 20 54 68 65 6e 20 74 75 72 6e 20 69 6d 70 6f 73 Then turn impos
1f470 74 65 72 20 6d 6f 64 65 20 62 61 63 6b 20 6f 66 ter mode back of
1f480 66 20 61 67 61 69 6e 2e 0a 20 20 20 20 2a 2a 0a f again.. **.
1f490 20 20 20 20 2a 2a 20 49 66 20 6f 6e 4f 66 66 3d ** If onOff=
1f4a0 3d 30 20 61 6e 64 20 74 6e 75 6d 3e 30 20 74 68 =0 and tnum>0 th
1f4b0 65 6e 20 72 65 73 65 74 20 74 68 65 20 73 63 68 en reset the sch
1f4c0 65 6d 61 20 66 6f 72 20 61 6c 6c 20 64 61 74 61 ema for all data
1f4d0 62 61 73 65 73 2c 20 63 61 75 73 69 6e 67 0a 20 bases, causing.
1f4e0 20 20 20 2a 2a 20 74 68 65 20 73 63 68 65 6d 61 ** the schema
1f4f0 20 74 6f 20 62 65 20 72 65 70 61 72 73 65 64 20 to be reparsed
1f500 74 68 65 20 6e 65 78 74 20 74 69 6d 65 20 69 74 the next time it
1f510 20 69 73 20 6e 65 65 64 65 64 2e 20 20 54 68 69 is needed. Thi
1f520 73 20 68 61 73 20 74 68 65 0a 20 20 20 20 2a 2a s has the. **
1f530 20 65 66 66 65 63 74 20 6f 66 20 65 72 61 73 69 effect of erasi
1f540 6e 67 20 61 6c 6c 20 69 6d 70 6f 73 74 65 72 20 ng all imposter
1f550 74 61 62 6c 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 tables.. */.
1f560 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
1f570 45 53 54 43 54 52 4c 5f 49 4d 50 4f 53 54 45 52 ESTCTRL_IMPOSTER
1f580 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
1f590 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 3 *db = va_arg(a
1f5a0 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 p, sqlite3*);.
1f5b0 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
1f5c0 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
1f5d0 78 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 69 6e x);. db->in
1f5e0 69 74 2e 69 44 62 20 3d 20 73 71 6c 69 74 65 33 it.iDb = sqlite3
1f5f0 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c 20 76 FindDbName(db, v
1f600 61 5f 61 72 67 28 61 70 2c 63 6f 6e 73 74 20 63 a_arg(ap,const c
1f610 68 61 72 2a 29 29 3b 0a 20 20 20 20 20 20 64 62 har*));. db
1f620 2d 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 64 62 ->init.busy = db
1f630 2d 3e 69 6e 69 74 2e 69 6d 70 6f 73 74 65 72 54 ->init.imposterT
1f640 61 62 6c 65 20 3d 20 76 61 5f 61 72 67 28 61 70 able = va_arg(ap
1f650 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 64 62 2d ,int);. db-
1f660 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 >init.newTnum =
1f670 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a va_arg(ap,int);.
1f680 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 69 6e if( db->in
1f690 69 74 2e 62 75 73 79 3d 3d 30 20 26 26 20 64 62 it.busy==0 && db
1f6a0 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 3e 30 ->init.newTnum>0
1f6b0 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
1f6c0 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d te3ResetAllSchem
1f6d0 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 64 asOfConnection(d
1f6e0 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 b);. }.
1f6f0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1f700 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
1f710 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
1f720 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e }. }. va_en
1f730 64 28 61 70 29 3b 0a 23 65 6e 64 69 66 20 2f 2a d(ap);.#endif /*
1f740 20 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 SQLITE_UNTESTAB
1f750 4c 45 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 LE */. return r
1f760 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
1f770 20 69 73 20 61 20 75 74 69 6c 69 74 79 20 72 6f is a utility ro
1f780 75 74 69 6e 65 2c 20 75 73 65 66 75 6c 20 74 6f utine, useful to
1f790 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 VFS implementat
1f7a0 69 6f 6e 73 2c 20 74 68 61 74 20 63 68 65 63 6b ions, that check
1f7b0 73 0a 2a 2a 20 74 6f 20 73 65 65 20 69 66 20 61 s.** to see if a
1f7c0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
1f7d0 61 73 20 61 20 55 52 49 20 74 68 61 74 20 63 6f as a URI that co
1f7e0 6e 74 61 69 6e 65 64 20 61 20 73 70 65 63 69 66 ntained a specif
1f7f0 69 63 20 71 75 65 72 79 20 0a 2a 2a 20 70 61 72 ic query .** par
1f800 61 6d 65 74 65 72 2c 20 61 6e 64 20 69 66 20 73 ameter, and if s
1f810 6f 20 6f 62 74 61 69 6e 73 20 74 68 65 20 76 61 o obtains the va
1f820 6c 75 65 20 6f 66 20 74 68 65 20 71 75 65 72 79 lue of the query
1f830 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2a 0a 2a parameter..**.*
1f840 2a 20 54 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 * The zFilename
1f850 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 argument is the
1f860 66 69 6c 65 6e 61 6d 65 20 70 6f 69 6e 74 65 72 filename pointer
1f870 20 70 61 73 73 65 64 20 69 6e 74 6f 20 74 68 65 passed into the
1f880 20 78 4f 70 65 6e 28 29 0a 2a 2a 20 6d 65 74 68 xOpen().** meth
1f890 6f 64 20 6f 66 20 61 20 56 46 53 20 69 6d 70 6c od of a VFS impl
1f8a0 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 ementation. The
1f8b0 20 7a 50 61 72 61 6d 20 61 72 67 75 6d 65 6e 74 zParam argument
1f8c0 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 is the name of
1f8d0 74 68 65 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 the.** query par
1f8e0 61 6d 65 74 65 72 20 77 65 20 73 65 65 6b 2e 20 ameter we seek.
1f8f0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 This routine re
1f900 74 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 turns the value
1f910 6f 66 20 74 68 65 20 7a 50 61 72 61 6d 0a 2a 2a of the zParam.**
1f920 20 70 61 72 61 6d 65 74 65 72 20 69 66 20 69 74 parameter if it
1f930 20 65 78 69 73 74 73 2e 20 20 49 66 20 74 68 65 exists. If the
1f940 20 70 61 72 61 6d 65 74 65 72 20 64 6f 65 73 20 parameter does
1f950 6e 6f 74 20 65 78 69 73 74 2c 20 74 68 69 73 20 not exist, this
1f960 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72 routine.** retur
1f970 6e 73 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 ns a NULL pointe
1f980 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 r..*/.const char
1f990 20 2a 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 *sqlite3_uri_pa
1f9a0 72 61 6d 65 74 65 72 28 63 6f 6e 73 74 20 63 68 rameter(const ch
1f9b0 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 ar *zFilename, c
1f9c0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 72 61 onst char *zPara
1f9d0 6d 29 7b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e m){. if( zFilen
1f9e0 61 6d 65 3d 3d 30 20 7c 7c 20 7a 50 61 72 61 6d ame==0 || zParam
1f9f0 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a ==0 ) return 0;.
1fa00 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 73 zFilename += s
1fa10 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
1fa20 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 3b 0a 20 Filename) + 1;.
1fa30 20 77 68 69 6c 65 28 20 7a 46 69 6c 65 6e 61 6d while( zFilenam
1fa40 65 5b 30 5d 20 29 7b 0a 20 20 20 20 69 6e 74 20 e[0] ){. int
1fa50 78 20 3d 20 73 74 72 63 6d 70 28 7a 46 69 6c 65 x = strcmp(zFile
1fa60 6e 61 6d 65 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 name, zParam);.
1fa70 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 3d 20 zFilename +=
1fa80 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
1fa90 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 3b 0a zFilename) + 1;.
1faa0 20 20 20 20 69 66 28 20 78 3d 3d 30 20 29 20 72 if( x==0 ) r
1fab0 65 74 75 72 6e 20 7a 46 69 6c 65 6e 61 6d 65 3b eturn zFilename;
1fac0 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b . zFilename +
1fad0 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
1fae0 30 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 0(zFilename) + 1
1faf0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 ;. }. return 0
1fb00 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
1fb10 6e 20 61 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 n a boolean valu
1fb20 65 20 66 6f 72 20 61 20 71 75 65 72 79 20 70 61 e for a query pa
1fb30 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 69 6e 74 20 rameter..*/.int
1fb40 73 71 6c 69 74 65 33 5f 75 72 69 5f 62 6f 6f 6c sqlite3_uri_bool
1fb50 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a ean(const char *
1fb60 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 6f 6e 73 74 zFilename, const
1fb70 20 63 68 61 72 20 2a 7a 50 61 72 61 6d 2c 20 69 char *zParam, i
1fb80 6e 74 20 62 44 66 6c 74 29 7b 0a 20 20 63 6f 6e nt bDflt){. con
1fb90 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c st char *z = sql
1fba0 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 ite3_uri_paramet
1fbb0 65 72 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 er(zFilename, zP
1fbc0 61 72 61 6d 29 3b 0a 20 20 62 44 66 6c 74 20 3d aram);. bDflt =
1fbd0 20 62 44 66 6c 74 21 3d 30 3b 0a 20 20 72 65 74 bDflt!=0;. ret
1fbe0 75 72 6e 20 7a 20 3f 20 73 71 6c 69 74 65 33 47 urn z ? sqlite3G
1fbf0 65 74 42 6f 6f 6c 65 61 6e 28 7a 2c 20 62 44 66 etBoolean(z, bDf
1fc00 6c 74 29 20 3a 20 62 44 66 6c 74 3b 0a 7d 0a 0a lt) : bDflt;.}..
1fc10 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 36 /*.** Return a 6
1fc20 34 2d 62 69 74 20 69 6e 74 65 67 65 72 20 76 61 4-bit integer va
1fc30 6c 75 65 20 66 6f 72 20 61 20 71 75 65 72 79 20 lue for a query
1fc40 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 73 71 parameter..*/.sq
1fc50 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 lite3_int64 sqli
1fc60 74 65 33 5f 75 72 69 5f 69 6e 74 36 34 28 0a 20 te3_uri_int64(.
1fc70 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 const char *zFi
1fc80 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 46 69 lename, /* Fi
1fc90 6c 65 6e 61 6d 65 20 61 73 20 70 61 73 73 65 64 lename as passed
1fca0 20 74 6f 20 78 4f 70 65 6e 20 2a 2f 0a 20 20 63 to xOpen */. c
1fcb0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 72 61 onst char *zPara
1fcc0 6d 2c 20 20 20 20 20 20 20 2f 2a 20 55 52 49 20 m, /* URI
1fcd0 70 61 72 61 6d 65 74 65 72 20 73 6f 75 67 68 74 parameter sought
1fce0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e */. sqlite3_in
1fcf0 74 36 34 20 62 44 66 6c 74 20 20 20 20 20 20 20 t64 bDflt
1fd00 2f 2a 20 72 65 74 75 72 6e 20 69 66 20 70 61 72 /* return if par
1fd10 61 6d 65 74 65 72 20 69 73 20 6d 69 73 73 69 6e ameter is missin
1fd20 67 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 g */.){. const
1fd30 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c 69 74 65 char *z = sqlite
1fd40 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 3_uri_parameter(
1fd50 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 72 61 zFilename, zPara
1fd60 6d 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e m);. sqlite3_in
1fd70 74 36 34 20 76 3b 0a 20 20 69 66 28 20 7a 20 26 t64 v;. if( z &
1fd80 26 20 73 71 6c 69 74 65 33 44 65 63 4f 72 48 65 & sqlite3DecOrHe
1fd90 78 54 6f 49 36 34 28 7a 2c 20 26 76 29 3d 3d 53 xToI64(z, &v)==S
1fda0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1fdb0 62 44 66 6c 74 20 3d 20 76 3b 0a 20 20 7d 0a 20 bDflt = v;. }.
1fdc0 20 72 65 74 75 72 6e 20 62 44 66 6c 74 3b 0a 7d return bDflt;.}
1fdd0 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
1fde0 68 65 20 42 74 72 65 65 20 70 6f 69 6e 74 65 72 he Btree pointer
1fdf0 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 7a identified by z
1fe00 44 62 4e 61 6d 65 2e 20 20 52 65 74 75 72 6e 20 DbName. Return
1fe10 4e 55 4c 4c 20 69 66 20 6e 6f 74 20 66 6f 75 6e NULL if not foun
1fe20 64 2e 0a 2a 2f 0a 42 74 72 65 65 20 2a 73 71 6c d..*/.Btree *sql
1fe30 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 ite3DbNameToBtre
1fe40 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 e(sqlite3 *db, c
1fe50 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 onst char *zDbNa
1fe60 6d 65 29 7b 0a 20 20 69 6e 74 20 69 44 62 20 3d me){. int iDb =
1fe70 20 7a 44 62 4e 61 6d 65 20 3f 20 73 71 6c 69 74 zDbName ? sqlit
1fe80 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c e3FindDbName(db,
1fe90 20 7a 44 62 4e 61 6d 65 29 20 3a 20 30 3b 0a 20 zDbName) : 0;.
1fea0 20 72 65 74 75 72 6e 20 69 44 62 3c 30 20 3f 20 return iDb<0 ?
1feb0 30 20 3a 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 0 : db->aDb[iDb]
1fec0 2e 70 42 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 .pBt;.}../*.** R
1fed0 65 74 75 72 6e 20 74 68 65 20 66 69 6c 65 6e 61 eturn the filena
1fee0 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 me of the databa
1fef0 73 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 se associated wi
1ff00 74 68 20 61 20 64 61 74 61 62 61 73 65 0a 2a 2a th a database.**
1ff10 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a connection..*/.
1ff20 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 const char *sqli
1ff30 74 65 33 5f 64 62 5f 66 69 6c 65 6e 61 6d 65 28 te3_db_filename(
1ff40 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e sqlite3 *db, con
1ff50 73 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 st char *zDbName
1ff60 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 3b ){. Btree *pBt;
1ff70 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
1ff80 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
1ff90 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
1ffa0 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
1ffb0 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
1ffc0 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
1ffd0 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
1ffe0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 42 74 20 }.#endif. pBt
1fff0 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 = sqlite3DbNameT
20000 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 oBtree(db, zDbNa
20010 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 42 me);. return pB
20020 74 20 3f 20 73 71 6c 69 74 65 33 42 74 72 65 65 t ? sqlite3Btree
20030 47 65 74 46 69 6c 65 6e 61 6d 65 28 70 42 74 29 GetFilename(pBt)
20040 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 : 0;.}../*.** R
20050 65 74 75 72 6e 20 31 20 69 66 20 64 61 74 61 62 eturn 1 if datab
20060 61 73 65 20 69 73 20 72 65 61 64 2d 6f 6e 6c 79 ase is read-only
20070 20 6f 72 20 30 20 69 66 20 72 65 61 64 2f 77 72 or 0 if read/wr
20080 69 74 65 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 ite. Return -1
20090 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 68 20 64 61 if.** no such da
200a0 74 61 62 61 73 65 20 65 78 69 73 74 73 2e 0a 2a tabase exists..*
200b0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 /.int sqlite3_db
200c0 5f 72 65 61 64 6f 6e 6c 79 28 73 71 6c 69 74 65 _readonly(sqlite
200d0 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 3 *db, const cha
200e0 72 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 42 r *zDbName){. B
200f0 74 72 65 65 20 2a 70 42 74 3b 0a 23 69 66 64 65 tree *pBt;.#ifde
20100 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
20110 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
20120 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
20130 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
20140 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 (void)SQLITE_MI
20150 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 SUSE_BKPT;. r
20160 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 65 eturn -1;. }.#e
20170 6e 64 69 66 0a 20 20 70 42 74 20 3d 20 73 71 6c ndif. pBt = sql
20180 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 ite3DbNameToBtre
20190 65 28 64 62 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a e(db, zDbName);.
201a0 20 20 72 65 74 75 72 6e 20 70 42 74 20 3f 20 73 return pBt ? s
201b0 71 6c 69 74 65 33 42 74 72 65 65 49 73 52 65 61 qlite3BtreeIsRea
201c0 64 6f 6e 6c 79 28 70 42 74 29 20 3a 20 2d 31 3b donly(pBt) : -1;
201d0 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .}..#ifdef SQLIT
201e0 45 5f 45 4e 41 42 4c 45 5f 53 4e 41 50 53 48 4f E_ENABLE_SNAPSHO
201f0 54 0a 2f 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20 61 T./*.** Obtain a
20200 20 73 6e 61 70 73 68 6f 74 20 68 61 6e 64 6c 65 snapshot handle
20210 20 66 6f 72 20 74 68 65 20 73 6e 61 70 73 68 6f for the snapsho
20220 74 20 6f 66 20 64 61 74 61 62 61 73 65 20 7a 44 t of database zD
20230 62 20 63 75 72 72 65 6e 74 6c 79 20 0a 2a 2a 20 b currently .**
20240 62 65 69 6e 67 20 72 65 61 64 20 62 79 20 68 61 being read by ha
20250 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 ndle db..*/.int
20260 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 sqlite3_snapshot
20270 5f 67 65 74 28 0a 20 20 73 71 6c 69 74 65 33 20 _get(. sqlite3
20280 2a 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 *db, . const ch
20290 61 72 20 2a 7a 44 62 2c 0a 20 20 73 71 6c 69 74 ar *zDb,. sqlit
202a0 65 33 5f 73 6e 61 70 73 68 6f 74 20 2a 2a 70 70 e3_snapshot **pp
202b0 53 6e 61 70 73 68 6f 74 0a 29 7b 0a 20 20 69 6e Snapshot.){. in
202c0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 t rc = SQLITE_ER
202d0 52 4f 52 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c ROR;.#ifndef SQL
202e0 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 0a 23 69 ITE_OMIT_WAL..#i
202f0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
20300 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 LE_API_ARMOR. i
20310 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
20320 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a yCheckOk(db) ){.
20330 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
20340 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
20350 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 }.#endif. sqli
20360 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
20370 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 0a 20 20 69 db->mutex);.. i
20380 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 f( db->autoCommi
20390 74 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 t==0 ){. int
203a0 69 44 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e iDb = sqlite3Fin
203b0 64 44 62 4e 61 6d 65 28 64 62 2c 20 7a 44 62 29 dDbName(db, zDb)
203c0 3b 0a 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 ;. if( iDb==0
203d0 20 7c 7c 20 69 44 62 3e 31 20 29 7b 0a 20 20 20 || iDb>1 ){.
203e0 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 Btree *pBt =
203f0 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
20400 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 ;. if( 0==s
20410 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54 qlite3BtreeIsInT
20420 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 20 20 rans(pBt) ){.
20430 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
20440 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 3BtreeBeginTrans
20450 28 70 42 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 (pBt, 0);.
20460 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
20470 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
20480 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
20490 65 72 53 6e 61 70 73 68 6f 74 47 65 74 28 73 71 erSnapshotGet(sq
204a0 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
204b0 70 42 74 29 2c 20 70 70 53 6e 61 70 73 68 6f 74 pBt), ppSnapshot
204c0 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
204d0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a }. }. }..
204e0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
204f0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
20500 3b 0a 23 65 6e 64 69 66 20 20 20 2f 2a 20 53 51 ;.#endif /* SQ
20510 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f LITE_OMIT_WAL */
20520 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
20530 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 72 65 ./*.** Open a re
20540 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f ad-transaction o
20550 6e 20 74 68 65 20 73 6e 61 70 73 68 6f 74 20 69 n the snapshot i
20560 64 65 6e 64 69 66 69 65 64 20 62 79 20 70 53 6e dendified by pSn
20570 61 70 73 68 6f 74 2e 0a 2a 2f 0a 69 6e 74 20 73 apshot..*/.int s
20580 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f qlite3_snapshot_
20590 6f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 open(. sqlite3
205a0 2a 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 *db, . const ch
205b0 61 72 20 2a 7a 44 62 2c 20 0a 20 20 73 71 6c 69 ar *zDb, . sqli
205c0 74 65 33 5f 73 6e 61 70 73 68 6f 74 20 2a 70 53 te3_snapshot *pS
205d0 6e 61 70 73 68 6f 74 0a 29 7b 0a 20 20 69 6e 74 napshot.){. int
205e0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
205f0 4f 52 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 OR;.#ifndef SQLI
20600 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 0a 23 69 66 TE_OMIT_WAL..#if
20610 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
20620 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
20630 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
20640 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
20650 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
20660 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
20670 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 }.#endif. sqlit
20680 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
20690 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 b->mutex);. if(
206a0 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 3d db->autoCommit=
206b0 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 44 =0 ){. int iD
206c0 62 3b 0a 20 20 20 20 69 44 62 20 3d 20 73 71 6c b;. iDb = sql
206d0 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 ite3FindDbName(d
206e0 62 2c 20 7a 44 62 29 3b 0a 20 20 20 20 69 66 28 b, zDb);. if(
206f0 20 69 44 62 3d 3d 30 20 7c 7c 20 69 44 62 3e 31 iDb==0 || iDb>1
20700 20 29 7b 0a 20 20 20 20 20 20 42 74 72 65 65 20 ){. Btree
20710 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 *pBt = db->aDb[i
20720 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 Db].pBt;. i
20730 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 42 74 72 f( 0==sqlite3Btr
20740 65 65 49 73 49 6e 52 65 61 64 54 72 61 6e 73 28 eeIsInReadTrans(
20750 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20 pBt) ){.
20760 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
20770 72 53 6e 61 70 73 68 6f 74 4f 70 65 6e 28 73 71 rSnapshotOpen(sq
20780 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
20790 70 42 74 29 2c 20 70 53 6e 61 70 73 68 6f 74 29 pBt), pSnapshot)
207a0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
207b0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
207c0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
207d0 6c 69 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 lite3BtreeBeginT
207e0 72 61 6e 73 28 70 42 74 2c 20 30 29 3b 0a 20 20 rans(pBt, 0);.
207f0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 sqlite3P
20800 61 67 65 72 53 6e 61 70 73 68 6f 74 4f 70 65 6e agerSnapshotOpen
20810 28 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 (sqlite3BtreePag
20820 65 72 28 70 42 74 29 2c 20 30 29 3b 0a 20 20 20 er(pBt), 0);.
20830 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
20840 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 }. }.. sqli
20850 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
20860 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 23 65 6e 64 db->mutex);.#end
20870 69 66 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4f if /* SQLITE_O
20880 4d 49 54 5f 57 41 4c 20 2a 2f 0a 20 20 72 65 74 MIT_WAL */. ret
20890 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
208a0 20 52 65 63 6f 76 65 72 20 61 73 20 6d 61 6e 79 Recover as many
208b0 20 73 6e 61 70 73 68 6f 74 73 20 61 73 20 70 6f snapshots as po
208c0 73 73 69 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 ssible from the
208d0 77 61 6c 20 66 69 6c 65 20 61 73 73 6f 63 69 61 wal file associa
208e0 74 65 64 20 77 69 74 68 0a 2a 2a 20 73 63 68 65 ted with.** sche
208f0 6d 61 20 7a 44 62 20 6f 66 20 64 61 74 61 62 61 ma zDb of databa
20900 73 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 se db..*/.int sq
20910 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 72 lite3_snapshot_r
20920 65 63 6f 76 65 72 28 73 71 6c 69 74 65 33 20 2a ecover(sqlite3 *
20930 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
20940 7a 44 62 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d zDb){. int rc =
20950 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
20960 20 69 6e 74 20 69 44 62 3b 0a 23 69 66 6e 64 65 int iDb;.#ifnde
20970 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
20980 4c 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 L..#ifdef SQLITE
20990 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
209a0 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
209b0 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
209c0 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
209d0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
209e0 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a PT;. }.#endif..
209f0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
20a00 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
20a10 3b 0a 20 20 69 44 62 20 3d 20 73 71 6c 69 74 65 ;. iDb = sqlite
20a20 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c 20 3FindDbName(db,
20a30 7a 44 62 29 3b 0a 20 20 69 66 28 20 69 44 62 3d zDb);. if( iDb=
20a40 3d 30 20 7c 7c 20 69 44 62 3e 31 20 29 7b 0a 20 =0 || iDb>1 ){.
20a50 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 Btree *pBt =
20a60 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
20a70 3b 0a 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c ;. if( 0==sql
20a80 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61 ite3BtreeIsInRea
20a90 64 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 dTrans(pBt) ){.
20aa0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
20ab0 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 3BtreeBeginTrans
20ac0 28 70 42 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 (pBt, 0);.
20ad0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
20ae0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 K ){. rc
20af0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 6e = sqlite3PagerSn
20b00 61 70 73 68 6f 74 52 65 63 6f 76 65 72 28 73 71 apshotRecover(sq
20b10 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
20b20 70 42 74 29 29 3b 0a 20 20 20 20 20 20 20 20 73 pBt));. s
20b30 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 qlite3BtreeCommi
20b40 74 28 70 42 74 29 3b 0a 20 20 20 20 20 20 7d 0a t(pBt);. }.
20b50 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
20b60 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
20b70 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 23 65 6e 64 db->mutex);.#end
20b80 69 66 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4f if /* SQLITE_O
20b90 4d 49 54 5f 57 41 4c 20 2a 2f 0a 20 20 72 65 74 MIT_WAL */. ret
20ba0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
20bb0 20 46 72 65 65 20 61 20 73 6e 61 70 73 68 6f 74 Free a snapshot
20bc0 20 68 61 6e 64 6c 65 20 6f 62 74 61 69 6e 65 64 handle obtained
20bd0 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 73 6e from sqlite3_sn
20be0 61 70 73 68 6f 74 5f 67 65 74 28 29 2e 0a 2a 2f apshot_get()..*/
20bf0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 6e .void sqlite3_sn
20c00 61 70 73 68 6f 74 5f 66 72 65 65 28 73 71 6c 69 apshot_free(sqli
20c10 74 65 33 5f 73 6e 61 70 73 68 6f 74 20 2a 70 53 te3_snapshot *pS
20c20 6e 61 70 73 68 6f 74 29 7b 0a 20 20 73 71 6c 69 napshot){. sqli
20c30 74 65 33 5f 66 72 65 65 28 70 53 6e 61 70 73 68 te3_free(pSnapsh
20c40 6f 74 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a ot);.}.#endif /*
20c50 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
20c60 4e 41 50 53 48 4f 54 20 2a 2f 0a 0a 23 69 66 6e NAPSHOT */..#ifn
20c70 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
20c80 43 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 49 COMPILEOPTION_DI
20c90 41 47 53 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 AGS./*.** Given
20ca0 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 63 6f the name of a co
20cb0 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f mpile-time optio
20cc0 6e 2c 20 72 65 74 75 72 6e 20 74 72 75 65 20 69 n, return true i
20cd0 66 20 74 68 61 74 20 6f 70 74 69 6f 6e 0a 2a 2a f that option.**
20ce0 20 77 61 73 20 75 73 65 64 20 61 6e 64 20 66 61 was used and fa
20cf0 6c 73 65 20 69 66 20 6e 6f 74 2e 0a 2a 2a 0a 2a lse if not..**.*
20d00 2a 20 54 68 65 20 6e 61 6d 65 20 63 61 6e 20 6f * The name can o
20d10 70 74 69 6f 6e 61 6c 6c 79 20 62 65 67 69 6e 20 ptionally begin
20d20 77 69 74 68 20 22 53 51 4c 49 54 45 5f 22 20 62 with "SQLITE_" b
20d30 75 74 20 74 68 65 20 22 53 51 4c 49 54 45 5f 22 ut the "SQLITE_"
20d40 20 70 72 65 66 69 78 0a 2a 2a 20 69 73 20 6e 6f prefix.** is no
20d50 74 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 61 t required for a
20d60 20 6d 61 74 63 68 2e 0a 2a 2f 0a 69 6e 74 20 73 match..*/.int s
20d70 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 6f 70 qlite3_compileop
20d80 74 69 6f 6e 5f 75 73 65 64 28 63 6f 6e 73 74 20 tion_used(const
20d90 63 68 61 72 20 2a 7a 4f 70 74 4e 61 6d 65 29 7b char *zOptName){
20da0 0a 20 20 69 6e 74 20 69 2c 20 6e 3b 0a 20 20 69 . int i, n;. i
20db0 6e 74 20 6e 4f 70 74 3b 0a 20 20 63 6f 6e 73 74 nt nOpt;. const
20dc0 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6d 70 69 6c char **azCompil
20dd0 65 4f 70 74 3b 0a 20 0a 23 69 66 20 53 51 4c 49 eOpt;. .#if SQLI
20de0 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
20df0 4d 4f 52 0a 20 20 69 66 28 20 7a 4f 70 74 4e 61 MOR. if( zOptNa
20e00 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 28 76 6f me==0 ){. (vo
20e10 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 id)SQLITE_MISUSE
20e20 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 _BKPT;. retur
20e30 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a n 0;. }.#endif.
20e40 0a 20 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 20 . azCompileOpt
20e50 3d 20 73 71 6c 69 74 65 33 43 6f 6d 70 69 6c 65 = sqlite3Compile
20e60 4f 70 74 69 6f 6e 73 28 26 6e 4f 70 74 29 3b 0a Options(&nOpt);.
20e70 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 . if( sqlite3St
20e80 72 4e 49 43 6d 70 28 7a 4f 70 74 4e 61 6d 65 2c rNICmp(zOptName,
20e90 20 22 53 51 4c 49 54 45 5f 22 2c 20 37 29 3d 3d "SQLITE_", 7)==
20ea0 30 20 29 20 7a 4f 70 74 4e 61 6d 65 20 2b 3d 20 0 ) zOptName +=
20eb0 37 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 7;. n = sqlite3
20ec0 53 74 72 6c 65 6e 33 30 28 7a 4f 70 74 4e 61 6d Strlen30(zOptNam
20ed0 65 29 3b 0a 0a 20 20 2f 2a 20 53 69 6e 63 65 20 e);.. /* Since
20ee0 6e 4f 70 74 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 nOpt is normally
20ef0 20 69 6e 20 73 69 6e 67 6c 65 20 64 69 67 69 74 in single digit
20f00 73 2c 20 61 20 6c 69 6e 65 61 72 20 73 65 61 72 s, a linear sear
20f10 63 68 20 69 73 20 0a 20 20 2a 2a 20 61 64 65 71 ch is . ** adeq
20f20 75 61 74 65 2e 20 4e 6f 20 6e 65 65 64 20 66 6f uate. No need fo
20f30 72 20 61 20 62 69 6e 61 72 79 20 73 65 61 72 63 r a binary searc
20f40 68 2e 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b h. */. for(i=0;
20f50 20 69 3c 6e 4f 70 74 3b 20 69 2b 2b 29 7b 0a 20 i<nOpt; i++){.
20f60 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 if( sqlite3St
20f70 72 4e 49 43 6d 70 28 7a 4f 70 74 4e 61 6d 65 2c rNICmp(zOptName,
20f80 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 5b 69 5d azCompileOpt[i]
20f90 2c 20 6e 29 3d 3d 30 0a 20 20 20 20 20 26 26 20 , n)==0. &&
20fa0 73 71 6c 69 74 65 33 49 73 49 64 43 68 61 72 28 sqlite3IsIdChar(
20fb0 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 61 (unsigned char)a
20fc0 7a 43 6f 6d 70 69 6c 65 4f 70 74 5b 69 5d 5b 6e zCompileOpt[i][n
20fd0 5d 29 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20 20 ])==0. ){.
20fe0 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 return 1;.
20ff0 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
21000 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
21010 72 6e 20 74 68 65 20 4e 2d 74 68 20 63 6f 6d 70 rn the N-th comp
21020 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 ile-time option
21030 73 74 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 string. If N is
21040 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 0a 2a out of range,.*
21050 2a 20 72 65 74 75 72 6e 20 61 20 4e 55 4c 4c 20 * return a NULL
21060 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 pointer..*/.cons
21070 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f t char *sqlite3_
21080 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 67 65 compileoption_ge
21090 74 28 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 t(int N){. int
210a0 6e 4f 70 74 3b 0a 20 20 63 6f 6e 73 74 20 63 68 nOpt;. const ch
210b0 61 72 20 2a 2a 61 7a 43 6f 6d 70 69 6c 65 4f 70 ar **azCompileOp
210c0 74 3b 0a 20 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 t;. azCompileOp
210d0 74 20 3d 20 73 71 6c 69 74 65 33 43 6f 6d 70 69 t = sqlite3Compi
210e0 6c 65 4f 70 74 69 6f 6e 73 28 26 6e 4f 70 74 29 leOptions(&nOpt)
210f0 3b 0a 20 20 69 66 28 20 4e 3e 3d 30 20 26 26 20 ;. if( N>=0 &&
21100 4e 3c 6e 4f 70 74 20 29 7b 0a 20 20 20 20 72 65 N<nOpt ){. re
21110 74 75 72 6e 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 turn azCompileOp
21120 74 5b 4e 5d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 t[N];. }. retu
21130 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f rn 0;.}.#endif /
21140 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f * SQLITE_OMIT_CO
21150 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 49 41 47 MPILEOPTION_DIAG
21160 53 20 2a 2f 0a S */.