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 56 54 41 42 0a 69 6e 74 20 LE_STMTVTAB.int
0380: 73 71 6c 69 74 65 33 53 74 6d 74 56 74 61 62 49 sqlite3StmtVtabI
0390: 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 nit(sqlite3*);.#
03a0: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
03b0: 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 35 0a ITE_ENABLE_FTS5.
03c0: 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 35 49 int sqlite3Fts5I
03d0: 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 nit(sqlite3*);.#
03e0: 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
03f0: 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 QLITE_AMALGAMATI
0400: 4f 4e 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 ON./* IMPLEMENTA
0410: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 34 36 36 35 36 TION-OF: R-46656
0420: 2d 34 35 31 35 36 20 54 68 65 20 73 71 6c 69 74 -45156 The sqlit
0430: 65 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 73 74 72 e3_version[] str
0440: 69 6e 67 20 63 6f 6e 73 74 61 6e 74 0a 2a 2a 20 ing constant.**
0450: 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 74 65 78 contains the tex
0460: 74 20 6f 66 20 53 51 4c 49 54 45 5f 56 45 52 53 t of SQLITE_VERS
0470: 49 4f 4e 20 6d 61 63 72 6f 2e 20 0a 2a 2f 0a 63 ION macro. .*/.c
0480: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 onst char sqlite
0490: 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 3_version[] = SQ
04a0: 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 23 65 LITE_VERSION;.#e
04b0: 6e 64 69 66 0a 0a 2f 2a 20 49 4d 50 4c 45 4d 45 ndif../* IMPLEME
04c0: 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 35 33 NTATION-OF: R-53
04d0: 35 33 36 2d 34 32 35 37 35 20 54 68 65 20 73 71 536-42575 The sq
04e0: 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e lite3_libversion
04f0: 28 29 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 () function retu
0500: 72 6e 73 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72 rns.** a pointer
0510: 20 74 6f 20 74 68 65 20 74 6f 20 74 68 65 20 73 to the to the s
0520: 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 5b 5d qlite3_version[]
0530: 20 73 74 72 69 6e 67 20 63 6f 6e 73 74 61 6e 74 string constant
0540: 2e 20 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 . .*/.const char
0550: 20 2a 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 *sqlite3_libver
0560: 73 69 6f 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 sion(void){ retu
0570: 72 6e 20 73 71 6c 69 74 65 33 5f 76 65 72 73 69 rn sqlite3_versi
0580: 6f 6e 3b 20 7d 0a 0a 2f 2a 20 49 4d 50 4c 45 4d on; }../* IMPLEM
0590: 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 36 ENTATION-OF: R-6
05a0: 33 31 32 34 2d 33 39 33 30 30 20 54 68 65 20 73 3124-39300 The s
05b0: 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 64 28 qlite3_sourceid(
05c0: 29 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 ) function retur
05d0: 6e 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 ns a.** pointer
05e0: 74 6f 20 61 20 73 74 72 69 6e 67 20 63 6f 6e 73 to a string cons
05f0: 74 61 6e 74 20 77 68 6f 73 65 20 76 61 6c 75 65 tant whose value
0600: 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 is the same as
0610: 74 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 53 4f the.** SQLITE_SO
0620: 55 52 43 45 5f 49 44 20 43 20 70 72 65 70 72 6f URCE_ID C prepro
0630: 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e 20 0a 2a cessor macro. .*
0640: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 /.const char *sq
0650: 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 64 28 76 lite3_sourceid(v
0660: 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 4c oid){ return SQL
0670: 49 54 45 5f 53 4f 55 52 43 45 5f 49 44 3b 20 7d ITE_SOURCE_ID; }
0680: 0a 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 ../* IMPLEMENTAT
0690: 49 4f 4e 2d 4f 46 3a 20 52 2d 33 35 32 31 30 2d ION-OF: R-35210-
06a0: 36 33 35 30 38 20 54 68 65 20 73 71 6c 69 74 65 63508 The sqlite
06b0: 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 3_libversion_num
06c0: 62 65 72 28 29 20 66 75 6e 63 74 69 6f 6e 0a 2a ber() function.*
06d0: 2a 20 72 65 74 75 72 6e 73 20 61 6e 20 69 6e 74 * returns an int
06e0: 65 67 65 72 20 65 71 75 61 6c 20 74 6f 20 53 51 eger equal to SQ
06f0: 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d LITE_VERSION_NUM
0700: 42 45 52 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 BER..*/.int sqli
0710: 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e te3_libversion_n
0720: 75 6d 62 65 72 28 76 6f 69 64 29 7b 20 72 65 74 umber(void){ ret
0730: 75 72 6e 20 53 51 4c 49 54 45 5f 56 45 52 53 49 urn SQLITE_VERSI
0740: 4f 4e 5f 4e 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a ON_NUMBER; }../*
0750: 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d IMPLEMENTATION-
0760: 4f 46 3a 20 52 2d 32 30 37 39 30 2d 31 34 30 32 OF: R-20790-1402
0770: 35 20 54 68 65 20 73 71 6c 69 74 65 33 5f 74 68 5 The sqlite3_th
0780: 72 65 61 64 73 61 66 65 28 29 20 66 75 6e 63 74 readsafe() funct
0790: 69 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 7a ion returns.** z
07a0: 65 72 6f 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 ero if and only
07b0: 69 66 20 53 51 4c 69 74 65 20 77 61 73 20 63 6f if SQLite was co
07c0: 6d 70 69 6c 65 64 20 77 69 74 68 20 6d 75 74 65 mpiled with mute
07d0: 78 69 6e 67 20 63 6f 64 65 20 6f 6d 69 74 74 65 xing code omitte
07e0: 64 20 64 75 65 20 74 6f 0a 2a 2a 20 74 68 65 20 d due to.** the
07f0: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 SQLITE_THREADSAF
0800: 45 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f E compile-time o
0810: 70 74 69 6f 6e 20 62 65 69 6e 67 20 73 65 74 20 ption being set
0820: 74 6f 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c to 0..*/.int sql
0830: 69 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 ite3_threadsafe(
0840: 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 void){ return SQ
0850: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3b LITE_THREADSAFE;
0860: 20 7d 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e 20 63 }../*.** When c
0870: 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 74 65 73 ompiling the tes
0880: 74 20 66 69 78 74 75 72 65 20 6f 72 20 77 69 74 t fixture or wit
0890: 68 20 64 65 62 75 67 67 69 6e 67 20 65 6e 61 62 h debugging enab
08a0: 6c 65 64 20 28 6f 6e 20 57 69 6e 33 32 29 2c 0a led (on Win32),.
08b0: 2a 2a 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 ** this variable
08c0: 20 62 65 69 6e 67 20 73 65 74 20 74 6f 20 6e 6f being set to no
08d0: 6e 2d 7a 65 72 6f 20 77 69 6c 6c 20 63 61 75 73 n-zero will caus
08e0: 65 20 4f 53 54 52 41 43 45 20 6d 61 63 72 6f 73 e OSTRACE macros
08f0: 20 74 6f 20 65 6d 69 74 0a 2a 2a 20 65 78 74 72 to emit.** extr
0900: 61 20 64 69 61 67 6e 6f 73 74 69 63 20 69 6e 66 a diagnostic inf
0910: 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 ormation..*/.#if
0920: 64 65 66 20 53 51 4c 49 54 45 5f 48 41 56 45 5f def SQLITE_HAVE_
0930: 4f 53 5f 54 52 41 43 45 0a 23 20 69 66 6e 64 65 OS_TRACE.# ifnde
0940: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 5f 4f f SQLITE_DEBUG_O
0950: 53 5f 54 52 41 43 45 0a 23 20 20 20 64 65 66 69 S_TRACE.# defi
0960: 6e 65 20 53 51 4c 49 54 45 5f 44 45 42 55 47 5f ne SQLITE_DEBUG_
0970: 4f 53 5f 54 52 41 43 45 20 30 0a 23 20 65 6e 64 OS_TRACE 0.# end
0980: 69 66 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 if. int sqlite3
0990: 4f 53 54 72 61 63 65 20 3d 20 53 51 4c 49 54 45 OSTrace = SQLITE
09a0: 5f 44 45 42 55 47 5f 4f 53 5f 54 52 41 43 45 3b _DEBUG_OS_TRACE;
09b0: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 21 64 65 .#endif..#if !de
09c0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
09d0: 54 5f 54 52 41 43 45 29 20 26 26 20 64 65 66 69 T_TRACE) && defi
09e0: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
09f0: 45 5f 49 4f 54 52 41 43 45 29 0a 2f 2a 0a 2a 2a E_IOTRACE)./*.**
0a00: 20 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e If the followin
0a10: 67 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 g function point
0a20: 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 er is not NULL a
0a30: 6e 64 20 69 66 0a 2a 2a 20 53 51 4c 49 54 45 5f nd if.** SQLITE_
0a40: 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 20 69 ENABLE_IOTRACE i
0a50: 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 s enabled, then
0a60: 6d 65 73 73 61 67 65 73 20 64 65 73 63 72 69 62 messages describ
0a70: 69 6e 67 0a 2a 2a 20 49 2f 4f 20 61 63 74 69 76 ing.** I/O activ
0a80: 65 20 61 72 65 20 77 72 69 74 74 65 6e 20 75 73 e are written us
0a90: 69 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f ing this functio
0aa0: 6e 2e 20 20 54 68 65 73 65 20 6d 65 73 73 61 67 n. These messag
0ab0: 65 73 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e 64 es.** are intend
0ac0: 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 ed for debugging
0ad0: 20 61 63 74 69 76 69 74 79 20 6f 6e 6c 79 2e 0a activity only..
0ae0: 2a 2f 0a 53 51 4c 49 54 45 5f 41 50 49 20 76 6f */.SQLITE_API vo
0af0: 69 64 20 28 53 51 4c 49 54 45 5f 43 44 45 43 4c id (SQLITE_CDECL
0b00: 20 2a 73 71 6c 69 74 65 33 49 6f 54 72 61 63 65 *sqlite3IoTrace
0b10: 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e )(const char*, .
0b20: 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a ..) = 0;.#endif.
0b30: 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 6f ./*.** If the fo
0b40: 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 llowing global v
0b50: 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 74 ariable points t
0b60: 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 63 68 o a string which
0b70: 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d 65 20 is the.** name
0b80: 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 2c 20 of a directory,
0b90: 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 63 74 then that direct
0ba0: 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 65 64 ory will be used
0bb0: 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 65 6d to store.** tem
0bc0: 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a 2a 2a porary files..**
0bd0: 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 68 65 .** See also the
0be0: 20 22 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 74 "PRAGMA temp_st
0bf0: 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 20 53 ore_directory" S
0c00: 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f 0a 63 QL command..*/.c
0c10: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 65 6d har *sqlite3_tem
0c20: 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 3b p_directory = 0;
0c30: 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 ../*.** If the f
0c40: 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 ollowing global
0c50: 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 variable points
0c60: 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 63 to a string whic
0c70: 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d 65 h is the.** name
0c80: 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 2c of a directory,
0c90: 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 63 then that direc
0ca0: 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 65 tory will be use
0cb0: 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 61 6c d to store.** al
0cc0: 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 l database files
0cd0: 20 73 70 65 63 69 66 69 65 64 20 77 69 74 68 20 specified with
0ce0: 61 20 72 65 6c 61 74 69 76 65 20 70 61 74 68 6e a relative pathn
0cf0: 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 ame..**.** See a
0d00: 6c 73 6f 20 74 68 65 20 22 50 52 41 47 4d 41 20 lso the "PRAGMA
0d10: 64 61 74 61 5f 73 74 6f 72 65 5f 64 69 72 65 63 data_store_direc
0d20: 74 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d 61 6e tory" SQL comman
0d30: 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69 d..*/.char *sqli
0d40: 74 65 33 5f 64 61 74 61 5f 64 69 72 65 63 74 6f te3_data_directo
0d50: 72 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 ry = 0;../*.** I
0d60: 6e 69 74 69 61 6c 69 7a 65 20 53 51 4c 69 74 65 nitialize SQLite
0d70: 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 . .**.** This r
0d80: 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 65 20 63 outine must be c
0d90: 61 6c 6c 65 64 20 74 6f 20 69 6e 69 74 69 61 6c alled to initial
0da0: 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 ize the memory a
0db0: 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 56 46 llocation,.** VF
0dc0: 53 2c 20 61 6e 64 20 6d 75 74 65 78 20 73 75 62 S, and mutex sub
0dd0: 73 79 73 74 65 6d 73 20 70 72 69 6f 72 20 74 6f systems prior to
0de0: 20 64 6f 69 6e 67 20 61 6e 79 20 73 65 72 69 6f doing any serio
0df0: 75 73 20 77 6f 72 6b 20 77 69 74 68 0a 2a 2a 20 us work with.**
0e00: 53 51 4c 69 74 65 2e 20 20 42 75 74 20 61 73 20 SQLite. But as
0e10: 6c 6f 6e 67 20 61 73 20 79 6f 75 20 64 6f 20 6e long as you do n
0e20: 6f 74 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 ot compile with
0e30: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
0e40: 49 4e 49 54 0a 2a 2a 20 74 68 69 73 20 72 6f 75 INIT.** this rou
0e50: 74 69 6e 65 20 77 69 6c 6c 20 62 65 20 63 61 6c tine will be cal
0e60: 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c led automaticall
0e70: 79 20 62 79 20 6b 65 79 20 72 6f 75 74 69 6e 65 y by key routine
0e80: 73 20 73 75 63 68 20 61 73 0a 2a 2a 20 73 71 6c s such as.** sql
0e90: 69 74 65 33 5f 6f 70 65 6e 28 29 2e 20 20 0a 2a ite3_open(). .*
0ea0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
0eb0: 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 65 78 63 e is a no-op exc
0ec0: 65 70 74 20 6f 6e 20 69 74 73 20 76 65 72 79 20 ept on its very
0ed0: 66 69 72 73 74 20 63 61 6c 6c 20 66 6f 72 20 74 first call for t
0ee0: 68 65 20 70 72 6f 63 65 73 73 2c 0a 2a 2a 20 6f he process,.** o
0ef0: 72 20 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 r for the first
0f00: 63 61 6c 6c 20 61 66 74 65 72 20 61 20 63 61 6c call after a cal
0f10: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 73 68 75 l to sqlite3_shu
0f20: 74 64 6f 77 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 tdown..**.** The
0f30: 20 66 69 72 73 74 20 74 68 72 65 61 64 20 74 6f first thread to
0f40: 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 call this routi
0f50: 6e 65 20 72 75 6e 73 20 74 68 65 20 69 6e 69 74 ne runs the init
0f60: 69 61 6c 69 7a 61 74 69 6f 6e 20 74 6f 0a 2a 2a ialization to.**
0f70: 20 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 20 49 66 completion. If
0f80: 20 73 75 62 73 65 71 75 65 6e 74 20 74 68 72 65 subsequent thre
0f90: 61 64 73 20 63 61 6c 6c 20 74 68 69 73 20 72 6f ads call this ro
0fa0: 75 74 69 6e 65 20 62 65 66 6f 72 65 20 74 68 65 utine before the
0fb0: 20 66 69 72 73 74 0a 2a 2a 20 74 68 72 65 61 64 first.** thread
0fc0: 20 68 61 73 20 66 69 6e 69 73 68 65 64 20 74 68 has finished th
0fd0: 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e e initialization
0fe0: 20 70 72 6f 63 65 73 73 2c 20 74 68 65 6e 20 74 process, then t
0ff0: 68 65 20 73 75 62 73 65 71 75 65 6e 74 0a 2a 2a he subsequent.**
1000: 20 74 68 72 65 61 64 73 20 6d 75 73 74 20 62 6c threads must bl
1010: 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 66 69 ock until the fi
1020: 72 73 74 20 74 68 72 65 61 64 20 66 69 6e 69 73 rst thread finis
1030: 68 65 73 20 77 69 74 68 20 74 68 65 20 69 6e 69 hes with the ini
1040: 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 2a 2a 0a tialization..**.
1050: 2a 2a 20 54 68 65 20 66 69 72 73 74 20 74 68 72 ** The first thr
1060: 65 61 64 20 6d 69 67 68 74 20 63 61 6c 6c 20 74 ead might call t
1070: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 63 75 his routine recu
1080: 72 73 69 76 65 6c 79 2e 20 20 52 65 63 75 72 73 rsively. Recurs
1090: 69 76 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 ive.** calls to
10a0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f this routine sho
10b0: 75 6c 64 20 6e 6f 74 20 62 6c 6f 63 6b 2c 20 6f uld not block, o
10c0: 66 20 63 6f 75 72 73 65 2e 20 20 4f 74 68 65 72 f course. Other
10d0: 77 69 73 65 20 74 68 65 0a 2a 2a 20 69 6e 69 74 wise the.** init
10e0: 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 63 65 ialization proce
10f0: 73 73 20 77 6f 75 6c 64 20 6e 65 76 65 72 20 63 ss would never c
1100: 6f 6d 70 6c 65 74 65 2e 0a 2a 2a 0a 2a 2a 20 4c omplete..**.** L
1110: 65 74 20 58 20 62 65 20 74 68 65 20 66 69 72 73 et X be the firs
1120: 74 20 74 68 72 65 61 64 20 74 6f 20 65 6e 74 65 t thread to ente
1130: 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 r this routine.
1140: 20 4c 65 74 20 59 20 62 65 20 73 6f 6d 65 20 6f Let Y be some o
1150: 74 68 65 72 0a 2a 2a 20 74 68 72 65 61 64 2e 20 ther.** thread.
1160: 20 54 68 65 6e 20 77 68 69 6c 65 20 74 68 65 20 Then while the
1170: 69 6e 69 74 69 61 6c 20 69 6e 76 6f 63 61 74 69 initial invocati
1180: 6f 6e 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 on of this routi
1190: 6e 65 20 62 79 20 58 20 69 73 0a 2a 2a 20 69 6e ne by X is.** in
11a0: 63 6f 6d 70 6c 65 74 65 2c 20 69 74 20 69 73 20 complete, it is
11b0: 72 65 71 75 69 72 65 64 20 74 68 61 74 3a 0a 2a required that:.*
11c0: 2a 0a 2a 2a 20 20 20 20 2a 20 20 43 61 6c 6c 73 *.** * Calls
11d0: 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 to this routine
11e0: 20 66 72 6f 6d 20 59 20 6d 75 73 74 20 62 6c 6f from Y must blo
11f0: 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 6f 75 74 ck until the out
1200: 65 72 2d 6d 6f 73 74 0a 2a 2a 20 20 20 20 20 20 er-most.**
1210: 20 63 61 6c 6c 20 62 79 20 58 20 63 6f 6d 70 6c call by X compl
1220: 65 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a etes..**.** *
1230: 20 20 52 65 63 75 72 73 69 76 65 20 63 61 6c 6c Recursive call
1240: 73 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69 6e s to this routin
1250: 65 20 66 72 6f 6d 20 74 68 72 65 61 64 20 58 20 e from thread X
1260: 72 65 74 75 72 6e 20 69 6d 6d 65 64 69 61 74 65 return immediate
1270: 6c 79 0a 2a 2a 20 20 20 20 20 20 20 77 69 74 68 ly.** with
1280: 6f 75 74 20 62 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f out blocking..*/
1290: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6e 69 .int sqlite3_ini
12a0: 74 69 61 6c 69 7a 65 28 76 6f 69 64 29 7b 0a 20 tialize(void){.
12b0: 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 MUTEX_LOGIC( sq
12c0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 lite3_mutex *pMa
12d0: 73 74 65 72 3b 20 29 20 20 20 20 20 20 20 2f 2a ster; ) /*
12e0: 20 54 68 65 20 6d 61 69 6e 20 73 74 61 74 69 63 The main static
12f0: 20 6d 75 74 65 78 20 2a 2f 0a 20 20 69 6e 74 20 mutex */. int
1300: 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 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 2f 2a 20 52 65 73 75 /* Resu
1330: 6c 74 20 63 6f 64 65 20 2a 2f 0a 23 69 66 64 65 lt code */.#ifde
1340: 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 f SQLITE_EXTRA_I
1350: 4e 49 54 0a 20 20 69 6e 74 20 62 52 75 6e 45 78 NIT. int bRunEx
1360: 74 72 61 49 6e 69 74 20 3d 20 30 3b 20 20 20 20 traInit = 0;
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1380: 20 20 20 2f 2a 20 45 78 74 72 61 20 69 6e 69 74 /* Extra init
1390: 69 61 6c 69 7a 61 74 69 6f 6e 20 6e 65 65 64 65 ialization neede
13a0: 64 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 23 69 66 d */.#endif..#if
13b0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
13c0: 57 53 44 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 WSD. rc = sqlit
13d0: 65 33 5f 77 73 64 5f 69 6e 69 74 28 34 30 39 36 e3_wsd_init(4096
13e0: 2c 20 32 34 29 3b 0a 20 20 69 66 28 20 72 63 21 , 24);. if( rc!
13f0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1400: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
1410: 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 49 66 .#endif.. /* If
1420: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 the following a
1430: 73 73 65 72 74 28 29 20 66 61 69 6c 73 20 6f 6e ssert() fails on
1440: 20 73 6f 6d 65 20 6f 62 73 63 75 72 65 20 70 72 some obscure pr
1450: 6f 63 65 73 73 6f 72 2f 63 6f 6d 70 69 6c 65 72 ocessor/compiler
1460: 0a 20 20 2a 2a 20 63 6f 6d 62 69 6e 61 74 69 6f . ** combinatio
1470: 6e 2c 20 74 68 65 20 77 6f 72 6b 2d 61 72 6f 75 n, the work-arou
1480: 6e 64 20 69 73 20 74 6f 20 73 65 74 20 74 68 65 nd is to set the
1490: 20 63 6f 72 72 65 63 74 20 70 6f 69 6e 74 65 72 correct pointer
14a0: 0a 20 20 2a 2a 20 73 69 7a 65 20 61 74 20 63 6f . ** size at co
14b0: 6d 70 69 6c 65 2d 74 69 6d 65 20 75 73 69 6e 67 mpile-time using
14c0: 20 2d 44 53 51 4c 49 54 45 5f 50 54 52 53 49 5a -DSQLITE_PTRSIZ
14d0: 45 3d 6e 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 E=n compile-time
14e0: 20 6f 70 74 69 6f 6e 20 2a 2f 0a 20 20 61 73 73 option */. ass
14f0: 65 72 74 28 20 53 51 4c 49 54 45 5f 50 54 52 53 ert( SQLITE_PTRS
1500: 49 5a 45 3d 3d 73 69 7a 65 6f 66 28 63 68 61 72 IZE==sizeof(char
1510: 2a 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 53 *) );.. /* If S
1520: 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 64 79 QLite is already
1530: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 6e 69 74 completely init
1540: 69 61 6c 69 7a 65 64 2c 20 74 68 65 6e 20 74 68 ialized, then th
1550: 69 73 20 63 61 6c 6c 0a 20 20 2a 2a 20 74 6f 20 is call. ** to
1560: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 sqlite3_initiali
1570: 7a 65 28 29 20 73 68 6f 75 6c 64 20 62 65 20 61 ze() should be a
1580: 20 6e 6f 2d 6f 70 2e 20 20 42 75 74 20 74 68 65 no-op. But the
1590: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a initialization.
15a0: 20 20 2a 2a 20 6d 75 73 74 20 62 65 20 63 6f 6d ** must be com
15b0: 70 6c 65 74 65 2e 20 20 53 6f 20 69 73 49 6e 69 plete. So isIni
15c0: 74 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 73 65 t must not be se
15d0: 74 20 75 6e 74 69 6c 20 74 68 65 20 76 65 72 79 t until the very
15e0: 20 65 6e 64 0a 20 20 2a 2a 20 6f 66 20 74 68 69 end. ** of thi
15f0: 73 20 72 6f 75 74 69 6e 65 2e 0a 20 20 2a 2f 0a s routine.. */.
1600: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
1610: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
1620: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
1630: 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 _OK;.. /* Make
1640: 73 75 72 65 20 74 68 65 20 6d 75 74 65 78 20 73 sure the mutex s
1650: 75 62 73 79 73 74 65 6d 20 69 73 20 69 6e 69 74 ubsystem is init
1660: 69 61 6c 69 7a 65 64 2e 20 20 49 66 20 75 6e 61 ialized. If una
1670: 62 6c 65 20 74 6f 20 0a 20 20 2a 2a 20 69 6e 69 ble to . ** ini
1680: 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 75 74 65 tialize the mute
1690: 78 20 73 75 62 73 79 73 74 65 6d 2c 20 72 65 74 x subsystem, ret
16a0: 75 72 6e 20 65 61 72 6c 79 20 77 69 74 68 20 74 urn early with t
16b0: 68 65 20 65 72 72 6f 72 2e 0a 20 20 2a 2a 20 49 he error.. ** I
16c0: 66 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 f the system is
16d0: 73 6f 20 73 69 63 6b 20 74 68 61 74 20 77 65 20 so sick that we
16e0: 61 72 65 20 75 6e 61 62 6c 65 20 74 6f 20 61 6c are unable to al
16f0: 6c 6f 63 61 74 65 20 61 20 6d 75 74 65 78 2c 0a locate a mutex,.
1700: 20 20 2a 2a 20 74 68 65 72 65 20 69 73 20 6e 6f ** there is no
1710: 74 20 6d 75 63 68 20 53 51 4c 69 74 65 20 69 73 t much SQLite is
1720: 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 61 62 6c going to be abl
1730: 65 20 74 6f 20 64 6f 2e 0a 20 20 2a 2a 0a 20 20 e to do.. **.
1740: 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 73 75 62 ** The mutex sub
1750: 73 79 73 74 65 6d 20 6d 75 73 74 20 74 61 6b 65 system must take
1760: 20 63 61 72 65 20 6f 66 20 73 65 72 69 61 6c 69 care of seriali
1770: 7a 69 6e 67 20 69 74 73 20 6f 77 6e 0a 20 20 2a zing its own. *
1780: 2a 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e * initialization
1790: 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 .. */. rc = sq
17a0: 6c 69 74 65 33 4d 75 74 65 78 49 6e 69 74 28 29 lite3MutexInit()
17b0: 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 ;. if( rc ) ret
17c0: 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 49 6e urn rc;.. /* In
17d0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 61 6c itialize the mal
17e0: 6c 6f 63 28 29 20 73 79 73 74 65 6d 20 61 6e 64 loc() system and
17f0: 20 74 68 65 20 72 65 63 75 72 73 69 76 65 20 70 the recursive p
1800: 49 6e 69 74 4d 75 74 65 78 20 6d 75 74 65 78 2e InitMutex mutex.
1810: 0a 20 20 2a 2a 20 54 68 69 73 20 6f 70 65 72 61 . ** This opera
1820: 74 69 6f 6e 20 69 73 20 70 72 6f 74 65 63 74 65 tion is protecte
1830: 64 20 62 79 20 74 68 65 20 53 54 41 54 49 43 5f d by the STATIC_
1840: 4d 41 53 54 45 52 20 6d 75 74 65 78 2e 20 20 4e MASTER mutex. N
1850: 6f 74 65 20 74 68 61 74 0a 20 20 2a 2a 20 4d 75 ote that. ** Mu
1860: 74 65 78 41 6c 6c 6f 63 28 29 20 69 73 20 63 61 texAlloc() is ca
1870: 6c 6c 65 64 20 66 6f 72 20 61 20 73 74 61 74 69 lled for a stati
1880: 63 20 6d 75 74 65 78 20 70 72 69 6f 72 20 74 6f c mutex prior to
1890: 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 initializing th
18a0: 65 0a 20 20 2a 2a 20 6d 61 6c 6c 6f 63 20 73 75 e. ** malloc su
18b0: 62 73 79 73 74 65 6d 20 2d 20 74 68 69 73 20 69 bsystem - this i
18c0: 6d 70 6c 69 65 73 20 74 68 61 74 20 74 68 65 20 mplies that the
18d0: 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 61 20 allocation of a
18e0: 73 74 61 74 69 63 0a 20 20 2a 2a 20 6d 75 74 65 static. ** mute
18f0: 78 20 6d 75 73 74 20 6e 6f 74 20 72 65 71 75 69 x must not requi
1900: 72 65 20 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 re support from
1910: 74 68 65 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 the malloc subsy
1920: 73 74 65 6d 2e 0a 20 20 2a 2f 0a 20 20 4d 55 54 stem.. */. MUT
1930: 45 58 5f 4c 4f 47 49 43 28 20 70 4d 61 73 74 65 EX_LOGIC( pMaste
1940: 72 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 r = sqlite3Mutex
1950: 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 Alloc(SQLITE_MUT
1960: 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 EX_STATIC_MASTER
1970: 29 3b 20 29 0a 20 20 73 71 6c 69 74 65 33 5f 6d ); ). sqlite3_m
1980: 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 utex_enter(pMast
1990: 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 6c er);. sqlite3Gl
19a0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 obalConfig.isMut
19b0: 65 78 49 6e 69 74 20 3d 20 31 3b 0a 20 20 69 66 exInit = 1;. if
19c0: 28 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c ( !sqlite3Global
19d0: 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 Config.isMallocI
19e0: 6e 69 74 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 nit ){. rc =
19f0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 sqlite3MallocIni
1a00: 74 28 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 t();. }. if( r
1a10: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1a20: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1a30: 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 lConfig.isMalloc
1a40: 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 69 66 Init = 1;. if
1a50: 28 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c ( !sqlite3Global
1a60: 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 Config.pInitMute
1a70: 78 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 x ){. sqlit
1a80: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
1a90: 49 6e 69 74 4d 75 74 65 78 20 3d 0a 20 20 20 20 InitMutex =.
1aa0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 75 sqlite3Mu
1ab0: 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f texAlloc(SQLITE_
1ac0: 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 29 MUTEX_RECURSIVE)
1ad0: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 ;. if( sqli
1ae0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1af0: 62 43 6f 72 65 4d 75 74 65 78 20 26 26 20 21 73 bCoreMutex && !s
1b00: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1b10: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 29 7b ig.pInitMutex ){
1b20: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
1b30: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
1b40: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
1b50: 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }. if( rc==SQL
1b60: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 ITE_OK ){. sq
1b70: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1b80: 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 2b g.nRefInitMutex+
1b90: 2b 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 +;. }. sqlite3
1ba0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 _mutex_leave(pMa
1bb0: 73 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 ster);.. /* If
1bc0: 72 63 20 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 rc is not SQLITE
1bd0: 5f 4f 4b 20 61 74 20 74 68 69 73 20 70 6f 69 6e _OK at this poin
1be0: 74 2c 20 74 68 65 6e 20 65 69 74 68 65 72 20 74 t, then either t
1bf0: 68 65 20 6d 61 6c 6c 6f 63 0a 20 20 2a 2a 20 73 he malloc. ** s
1c00: 75 62 73 79 73 74 65 6d 20 63 6f 75 6c 64 20 6e ubsystem could n
1c10: 6f 74 20 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 ot be initialize
1c20: 64 20 6f 72 20 74 68 65 20 73 79 73 74 65 6d 20 d or the system
1c30: 66 61 69 6c 65 64 20 74 6f 20 61 6c 6c 6f 63 61 failed to alloca
1c40: 74 65 0a 20 20 2a 2a 20 74 68 65 20 70 49 6e 69 te. ** the pIni
1c50: 74 4d 75 74 65 78 20 6d 75 74 65 78 2e 20 52 65 tMutex mutex. Re
1c60: 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 69 6e turn an error in
1c70: 20 65 69 74 68 65 72 20 63 61 73 65 2e 20 20 2a either case. *
1c80: 2f 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 /. if( rc!=SQLI
1c90: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 TE_OK ){. ret
1ca0: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f urn rc;. }.. /
1cb0: 2a 20 44 6f 20 74 68 65 20 72 65 73 74 20 6f 66 * Do the rest of
1cc0: 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 the initializat
1cd0: 69 6f 6e 20 75 6e 64 65 72 20 74 68 65 20 72 65 ion under the re
1ce0: 63 75 72 73 69 76 65 20 6d 75 74 65 78 20 73 6f cursive mutex so
1cf0: 0a 20 20 2a 2a 20 74 68 61 74 20 77 65 20 77 69 . ** that we wi
1d00: 6c 6c 20 62 65 20 61 62 6c 65 20 74 6f 20 68 61 ll be able to ha
1d10: 6e 64 6c 65 20 72 65 63 75 72 73 69 76 65 20 63 ndle recursive c
1d20: 61 6c 6c 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 73 alls into. ** s
1d30: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a qlite3_initializ
1d40: 65 28 29 2e 20 20 54 68 65 20 72 65 63 75 72 73 e(). The recurs
1d50: 69 76 65 20 63 61 6c 6c 73 20 6e 6f 72 6d 61 6c ive calls normal
1d60: 6c 79 20 63 6f 6d 65 20 74 68 72 6f 75 67 68 0a ly come through.
1d70: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 73 5f ** sqlite3_os_
1d80: 69 6e 69 74 28 29 20 77 68 65 6e 20 69 74 20 69 init() when it i
1d90: 6e 76 6f 6b 65 73 20 73 71 6c 69 74 65 33 5f 76 nvokes sqlite3_v
1da0: 66 73 5f 72 65 67 69 73 74 65 72 28 29 2c 20 62 fs_register(), b
1db0: 75 74 20 6f 74 68 65 72 0a 20 20 2a 2a 20 72 65 ut other. ** re
1dc0: 63 75 72 73 69 76 65 20 63 61 6c 6c 73 20 6d 69 cursive calls mi
1dd0: 67 68 74 20 61 6c 73 6f 20 62 65 20 70 6f 73 73 ght also be poss
1de0: 69 62 6c 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ible.. **. **
1df0: 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f IMPLEMENTATION-O
1e00: 46 3a 20 52 2d 30 30 31 34 30 2d 33 37 34 34 35 F: R-00140-37445
1e10: 20 53 51 4c 69 74 65 20 61 75 74 6f 6d 61 74 69 SQLite automati
1e20: 63 61 6c 6c 79 20 73 65 72 69 61 6c 69 7a 65 73 cally serializes
1e30: 20 63 61 6c 6c 73 0a 20 20 2a 2a 20 74 6f 20 74 calls. ** to t
1e40: 68 65 20 78 49 6e 69 74 20 6d 65 74 68 6f 64 2c he xInit method,
1e50: 20 73 6f 20 74 68 65 20 78 49 6e 69 74 20 6d 65 so the xInit me
1e60: 74 68 6f 64 20 6e 65 65 64 20 6e 6f 74 20 62 65 thod need not be
1e70: 20 74 68 72 65 61 64 73 61 66 65 2e 0a 20 20 2a threadsafe.. *
1e80: 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f *. ** The follo
1e90: 77 69 6e 67 20 6d 75 74 65 78 20 69 73 20 77 68 wing mutex is wh
1ea0: 61 74 20 73 65 72 69 61 6c 69 7a 65 73 20 61 63 at serializes ac
1eb0: 63 65 73 73 20 74 6f 20 74 68 65 20 61 70 70 64 cess to the appd
1ec0: 65 66 20 70 63 61 63 68 65 20 78 49 6e 69 74 0a ef pcache xInit.
1ed0: 20 20 2a 2a 20 6d 65 74 68 6f 64 73 2e 20 20 54 ** methods. T
1ee0: 68 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 he sqlite3_pcach
1ef0: 65 5f 6d 65 74 68 6f 64 73 2e 78 49 6e 69 74 28 e_methods.xInit(
1f00: 29 20 61 6c 6c 20 69 73 20 65 6d 62 65 64 64 65 ) all is embedde
1f10: 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 63 61 d in the. ** ca
1f20: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 63 61 ll to sqlite3Pca
1f30: 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 2e cheInitialize().
1f40: 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f . */. sqlite3_
1f50: 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 mutex_enter(sqli
1f60: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1f70: 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a 20 20 69 pInitMutex);. i
1f80: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
1f90: 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 3d 3d 30 Config.isInit==0
1fa0: 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 && sqlite3Globa
1fb0: 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 72 65 lConfig.inProgre
1fc0: 73 73 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c ss==0 ){. sql
1fd0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1fe0: 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 31 3b .inProgress = 1;
1ff0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
2000: 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 20 NABLE_SQLLOG.
2010: 20 7b 0a 20 20 20 20 20 20 65 78 74 65 72 6e 20 {. extern
2020: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 69 void sqlite3_ini
2030: 74 5f 73 71 6c 6c 6f 67 28 76 6f 69 64 29 3b 0a t_sqllog(void);.
2040: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e sqlite3_in
2050: 69 74 5f 73 71 6c 6c 6f 67 28 29 3b 0a 20 20 20 it_sqllog();.
2060: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 6d 65 }.#endif. me
2070: 6d 73 65 74 28 26 73 71 6c 69 74 65 33 42 75 69 mset(&sqlite3Bui
2080: 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 2c 20 30 ltinFunctions, 0
2090: 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 , sizeof(sqlite3
20a0: 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 BuiltinFunctions
20b0: 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 ));. sqlite3R
20c0: 65 67 69 73 74 65 72 42 75 69 6c 74 69 6e 46 75 egisterBuiltinFu
20d0: 6e 63 74 69 6f 6e 73 28 29 3b 0a 20 20 20 20 69 nctions();. i
20e0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
20f0: 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 Config.isPCacheI
2100: 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 nit==0 ){.
2110: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 rc = sqlite3Pcac
2120: 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a heInitialize();.
2130: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
2140: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2150: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
2160: 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 alConfig.isPCach
2170: 65 49 6e 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 eInit = 1;.
2180: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 49 rc = sqlite3OsI
2190: 6e 69 74 28 29 3b 0a 20 20 20 20 7d 0a 20 20 20 nit();. }.
21a0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
21b0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 OK ){. sqli
21c0: 74 65 33 50 43 61 63 68 65 42 75 66 66 65 72 53 te3PCacheBufferS
21d0: 65 74 75 70 28 20 73 71 6c 69 74 65 33 47 6c 6f etup( sqlite3Glo
21e0: 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 2c balConfig.pPage,
21f0: 20 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 . sqli
2200: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2210: 73 7a 50 61 67 65 2c 20 73 71 6c 69 74 65 33 47 szPage, sqlite3G
2220: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 lobalConfig.nPag
2230: 65 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 e);. sqlite
2240: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
2250: 49 6e 69 74 20 3d 20 31 3b 0a 23 69 66 64 65 66 Init = 1;.#ifdef
2260: 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e SQLITE_EXTRA_IN
2270: 49 54 0a 20 20 20 20 20 20 62 52 75 6e 45 78 74 IT. bRunExt
2280: 72 61 49 6e 69 74 20 3d 20 31 3b 0a 23 65 6e 64 raInit = 1;.#end
2290: 69 66 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c if. }. sql
22a0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
22b0: 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d 20 30 3b .inProgress = 0;
22c0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
22d0: 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 utex_leave(sqlit
22e0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
22f0: 49 6e 69 74 4d 75 74 65 78 29 3b 0a 0a 20 20 2f InitMutex);.. /
2300: 2a 20 47 6f 20 62 61 63 6b 20 75 6e 64 65 72 20 * Go back under
2310: 74 68 65 20 73 74 61 74 69 63 20 6d 75 74 65 78 the static mutex
2320: 20 61 6e 64 20 63 6c 65 61 6e 20 75 70 20 74 68 and clean up th
2330: 65 20 72 65 63 75 72 73 69 76 65 0a 20 20 2a 2a e recursive. **
2340: 20 6d 75 74 65 78 20 74 6f 20 70 72 65 76 65 6e mutex to preven
2350: 74 20 61 20 72 65 73 6f 75 72 63 65 20 6c 65 61 t a resource lea
2360: 6b 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 k.. */. sqlite
2370: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 3_mutex_enter(pM
2380: 61 73 74 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 aster);. sqlite
2390: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 3GlobalConfig.nR
23a0: 65 66 49 6e 69 74 4d 75 74 65 78 2d 2d 3b 0a 20 efInitMutex--;.
23b0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
23c0: 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 alConfig.nRefIni
23d0: 74 4d 75 74 65 78 3c 3d 30 20 29 7b 0a 20 20 20 tMutex<=0 ){.
23e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
23f0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 GlobalConfig.nRe
2400: 66 49 6e 69 74 4d 75 74 65 78 3d 3d 30 20 29 3b fInitMutex==0 );
2410: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 . sqlite3_mut
2420: 65 78 5f 66 72 65 65 28 73 71 6c 69 74 65 33 47 ex_free(sqlite3G
2430: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 lobalConfig.pIni
2440: 74 4d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c tMutex);. sql
2450: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2460: 2e 70 49 6e 69 74 4d 75 74 65 78 20 3d 20 30 3b .pInitMutex = 0;
2470: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
2480: 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 73 74 utex_leave(pMast
2490: 65 72 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 er);.. /* The f
24a0: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 6a 75 73 74 ollowing is just
24b0: 20 61 20 73 61 6e 69 74 79 20 63 68 65 63 6b 20 a sanity check
24c0: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 53 51 4c to make sure SQL
24d0: 69 74 65 20 68 61 73 0a 20 20 2a 2a 20 62 65 65 ite has. ** bee
24e0: 6e 20 63 6f 6d 70 69 6c 65 64 20 63 6f 72 72 65 n compiled corre
24f0: 63 74 6c 79 2e 20 20 49 74 20 69 73 20 69 6d 70 ctly. It is imp
2500: 6f 72 74 61 6e 74 20 74 6f 20 72 75 6e 20 74 68 ortant to run th
2510: 69 73 20 63 6f 64 65 2c 20 62 75 74 0a 20 20 2a is code, but. *
2520: 2a 20 77 65 20 64 6f 6e 27 74 20 77 61 6e 74 20 * we don't want
2530: 74 6f 20 72 75 6e 20 69 74 20 74 6f 6f 20 6f 66 to run it too of
2540: 74 65 6e 20 61 6e 64 20 73 6f 61 6b 20 75 70 20 ten and soak up
2550: 43 50 55 20 63 79 63 6c 65 73 20 66 6f 72 20 6e CPU cycles for n
2560: 6f 0a 20 20 2a 2a 20 72 65 61 73 6f 6e 2e 20 20 o. ** reason.
2570: 53 6f 20 77 65 20 72 75 6e 20 69 74 20 6f 6e 63 So we run it onc
2580: 65 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c e during initial
2590: 69 7a 61 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 ization.. */.#i
25a0: 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 23 69 66 fndef NDEBUG.#if
25b0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
25c0: 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a _FLOATING_POINT.
25d0: 20 20 2f 2a 20 54 68 69 73 20 73 65 63 74 69 6f /* This sectio
25e0: 6e 20 6f 66 20 63 6f 64 65 27 73 20 6f 6e 6c 79 n of code's only
25f0: 20 22 6f 75 74 70 75 74 22 20 69 73 20 76 69 61 "output" is via
2600: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
2610: 65 6e 74 73 2e 20 2a 2f 0a 20 20 69 66 20 28 20 ents. */. if (
2620: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2630: 0a 20 20 20 20 75 36 34 20 78 20 3d 20 28 28 28 . u64 x = (((
2640: 75 36 34 29 31 29 3c 3c 36 33 29 2d 31 3b 0a 20 u64)1)<<63)-1;.
2650: 20 20 20 64 6f 75 62 6c 65 20 79 3b 0a 20 20 20 double y;.
2660: 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 28 78 assert(sizeof(x
2670: 29 3d 3d 38 29 3b 0a 20 20 20 20 61 73 73 65 72 )==8);. asser
2680: 74 28 73 69 7a 65 6f 66 28 78 29 3d 3d 73 69 7a t(sizeof(x)==siz
2690: 65 6f 66 28 79 29 29 3b 0a 20 20 20 20 6d 65 6d eof(y));. mem
26a0: 63 70 79 28 26 79 2c 20 26 78 2c 20 38 29 3b 0a cpy(&y, &x, 8);.
26b0: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
26c0: 74 65 33 49 73 4e 61 4e 28 79 29 20 29 3b 0a 20 te3IsNaN(y) );.
26d0: 20 7d 0a 23 65 6e 64 69 66 0a 23 65 6e 64 69 66 }.#endif.#endif
26e0: 0a 0a 20 20 2f 2a 20 44 6f 20 65 78 74 72 61 20 .. /* Do extra
26f0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 73 initialization s
2700: 74 65 70 73 20 72 65 71 75 65 73 74 65 64 20 62 teps requested b
2710: 79 20 74 68 65 20 53 51 4c 49 54 45 5f 45 58 54 y the SQLITE_EXT
2720: 52 41 5f 49 4e 49 54 0a 20 20 2a 2a 20 63 6f 6d RA_INIT. ** com
2730: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e pile-time option
2740: 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 .. */.#ifdef SQ
2750: 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a LITE_EXTRA_INIT.
2760: 20 20 69 66 28 20 62 52 75 6e 45 78 74 72 61 49 if( bRunExtraI
2770: 6e 69 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 53 nit ){. int S
2780: 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 QLITE_EXTRA_INIT
2790: 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 (const char*);.
27a0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 rc = SQLITE_E
27b0: 58 54 52 41 5f 49 4e 49 54 28 30 29 3b 0a 20 20 XTRA_INIT(0);.
27c0: 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 }.#endif.. retu
27d0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
27e0: 55 6e 64 6f 20 74 68 65 20 65 66 66 65 63 74 73 Undo the effects
27f0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 of sqlite3_init
2800: 69 61 6c 69 7a 65 28 29 2e 20 20 4d 75 73 74 20 ialize(). Must
2810: 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 77 68 not be called wh
2820: 69 6c 65 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 ile.** there are
2830: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 61 74 outstanding dat
2840: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
2850: 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f s or memory allo
2860: 63 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 77 68 cations or.** wh
2870: 69 6c 65 20 61 6e 79 20 70 61 72 74 20 6f 66 20 ile any part of
2880: 53 51 4c 69 74 65 20 69 73 20 6f 74 68 65 72 77 SQLite is otherw
2890: 69 73 65 20 69 6e 20 75 73 65 20 69 6e 20 61 6e ise in use in an
28a0: 79 20 74 68 72 65 61 64 2e 20 20 54 68 69 73 0a y thread. This.
28b0: 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f ** routine is no
28c0: 74 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 42 t threadsafe. B
28d0: 75 74 20 69 74 20 69 73 20 73 61 66 65 20 74 6f ut it is safe to
28e0: 20 69 6e 76 6f 6b 65 20 74 68 69 73 20 72 6f 75 invoke this rou
28f0: 74 69 6e 65 0a 2a 2a 20 6f 6e 20 77 68 65 6e 20 tine.** on when
2900: 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 64 SQLite is alread
2910: 79 20 73 68 75 74 20 64 6f 77 6e 2e 20 20 49 66 y shut down. If
2920: 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 65 61 SQLite is alrea
2930: 64 79 20 73 68 75 74 20 64 6f 77 6e 0a 2a 2a 20 dy shut down.**
2940: 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e when this routin
2950: 65 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 e is invoked, th
2960: 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 en this routine
2970: 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f is a harmless no
2980: 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 -op..*/.int sqli
2990: 74 65 33 5f 73 68 75 74 64 6f 77 6e 28 76 6f 69 te3_shutdown(voi
29a0: 64 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 d){.#ifdef SQLIT
29b0: 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 69 6e 74 E_OMIT_WSD. int
29c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 rc = sqlite3_ws
29d0: 64 5f 69 6e 69 74 28 34 30 39 36 2c 20 32 34 29 d_init(4096, 24)
29e0: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
29f0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 TE_OK ){. ret
2a00: 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 urn rc;. }.#end
2a10: 69 66 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 if.. if( sqlite
2a20: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
2a30: 49 6e 69 74 20 29 7b 0a 23 69 66 64 65 66 20 53 Init ){.#ifdef S
2a40: 51 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 QLITE_EXTRA_SHUT
2a50: 44 4f 57 4e 0a 20 20 20 20 76 6f 69 64 20 53 51 DOWN. void SQ
2a60: 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 44 LITE_EXTRA_SHUTD
2a70: 4f 57 4e 28 76 6f 69 64 29 3b 0a 20 20 20 20 53 OWN(void);. S
2a80: 51 4c 49 54 45 5f 45 58 54 52 41 5f 53 48 55 54 QLITE_EXTRA_SHUT
2a90: 44 4f 57 4e 28 29 3b 0a 23 65 6e 64 69 66 0a 20 DOWN();.#endif.
2aa0: 20 20 20 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e sqlite3_os_en
2ab0: 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 d();. sqlite3
2ac0: 5f 72 65 73 65 74 5f 61 75 74 6f 5f 65 78 74 65 _reset_auto_exte
2ad0: 6e 73 69 6f 6e 28 29 3b 0a 20 20 20 20 73 71 6c nsion();. sql
2ae0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2af0: 2e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d .isInit = 0;. }
2b00: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
2b10: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 obalConfig.isPCa
2b20: 63 68 65 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 cheInit ){. s
2b30: 71 6c 69 74 65 33 50 63 61 63 68 65 53 68 75 74 qlite3PcacheShut
2b40: 64 6f 77 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 down();. sqli
2b50: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2b60: 69 73 50 43 61 63 68 65 49 6e 69 74 20 3d 20 30 isPCacheInit = 0
2b70: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 ;. }. if( sqli
2b80: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2b90: 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a isMallocInit ){.
2ba0: 20 20 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f sqlite3Mallo
2bb0: 63 45 6e 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 cEnd();. sqli
2bc0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2bd0: 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 3d 20 30 isMallocInit = 0
2be0: 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ;..#ifndef SQLIT
2bf0: 45 5f 4f 4d 49 54 5f 53 48 55 54 44 4f 57 4e 5f E_OMIT_SHUTDOWN_
2c00: 44 49 52 45 43 54 4f 52 49 45 53 0a 20 20 20 20 DIRECTORIES.
2c10: 2f 2a 20 54 68 65 20 68 65 61 70 20 73 75 62 73 /* The heap subs
2c20: 79 73 74 65 6d 20 68 61 73 20 6e 6f 77 20 62 65 ystem has now be
2c30: 65 6e 20 73 68 75 74 64 6f 77 6e 20 61 6e 64 20 en shutdown and
2c40: 74 68 65 73 65 20 76 61 6c 75 65 73 20 61 72 65 these values are
2c50: 20 73 75 70 70 6f 73 65 64 0a 20 20 20 20 2a 2a supposed. **
2c60: 20 74 6f 20 62 65 20 4e 55 4c 4c 20 6f 72 20 70 to be NULL or p
2c70: 6f 69 6e 74 20 74 6f 20 6d 65 6d 6f 72 79 20 74 oint to memory t
2c80: 68 61 74 20 77 61 73 20 6f 62 74 61 69 6e 65 64 hat was obtained
2c90: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 from sqlite3_ma
2ca0: 6c 6c 6f 63 28 29 2c 0a 20 20 20 20 2a 2a 20 77 lloc(),. ** w
2cb0: 68 69 63 68 20 77 6f 75 6c 64 20 72 65 6c 79 20 hich would rely
2cc0: 6f 6e 20 74 68 61 74 20 68 65 61 70 20 73 75 62 on that heap sub
2cd0: 73 79 73 74 65 6d 3b 20 74 68 65 72 65 66 6f 72 system; therefor
2ce0: 65 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 e, make sure the
2cf0: 73 65 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 73 se. ** values
2d00: 20 63 61 6e 6e 6f 74 20 72 65 66 65 72 20 74 6f cannot refer to
2d10: 20 68 65 61 70 20 6d 65 6d 6f 72 79 20 74 68 61 heap memory tha
2d20: 74 20 77 61 73 20 6a 75 73 74 20 69 6e 76 61 6c t was just inval
2d30: 69 64 61 74 65 64 20 77 68 65 6e 20 74 68 65 0a idated when the.
2d40: 20 20 20 20 2a 2a 20 68 65 61 70 20 73 75 62 73 ** heap subs
2d50: 79 73 74 65 6d 20 77 61 73 20 73 68 75 74 64 6f ystem was shutdo
2d60: 77 6e 2e 20 20 54 68 69 73 20 69 73 20 6f 6e 6c wn. This is onl
2d70: 79 20 64 6f 6e 65 20 69 66 20 74 68 65 20 63 75 y done if the cu
2d80: 72 72 65 6e 74 20 63 61 6c 6c 20 74 6f 0a 20 20 rrent call to.
2d90: 20 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 ** this functi
2da0: 6f 6e 20 72 65 73 75 6c 74 65 64 20 69 6e 20 74 on resulted in t
2db0: 68 65 20 68 65 61 70 20 73 75 62 73 79 73 74 65 he heap subsyste
2dc0: 6d 20 61 63 74 75 61 6c 6c 79 20 62 65 69 6e 67 m actually being
2dd0: 20 73 68 75 74 64 6f 77 6e 2e 0a 20 20 20 20 2a shutdown.. *
2de0: 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 64 61 /. sqlite3_da
2df0: 74 61 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 ta_directory = 0
2e00: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 74 65 ;. sqlite3_te
2e10: 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 mp_directory = 0
2e20: 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 ;.#endif. }. i
2e30: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
2e40: 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e Config.isMutexIn
2e50: 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 it ){. sqlite
2e60: 33 4d 75 74 65 78 45 6e 64 28 29 3b 0a 20 20 20 3MutexEnd();.
2e70: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2e80: 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 74 nfig.isMutexInit
2e90: 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 = 0;. }.. ret
2ea0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
2eb0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 41 50 49 ../*.** This API
2ec0: 20 61 6c 6c 6f 77 73 20 61 70 70 6c 69 63 61 74 allows applicat
2ed0: 69 6f 6e 73 20 74 6f 20 6d 6f 64 69 66 79 20 74 ions to modify t
2ee0: 68 65 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 he global config
2ef0: 75 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 uration of.** th
2f00: 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 e SQLite library
2f10: 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2a at run-time..**
2f20: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
2f30: 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 should only be
2f40: 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 72 called when ther
2f50: 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e e are no outstan
2f60: 64 69 6e 67 0a 2a 2a 20 64 61 74 61 62 61 73 65 ding.** database
2f70: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 72 20 connections or
2f80: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
2f90: 6e 73 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e ns. This routin
2fa0: 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 74 68 72 65 e is not.** thre
2fb0: 61 64 73 61 66 65 2e 20 20 46 61 69 6c 75 72 65 adsafe. Failure
2fc0: 20 74 6f 20 68 65 65 64 20 74 68 65 73 65 20 77 to heed these w
2fd0: 61 72 6e 69 6e 67 73 20 63 61 6e 20 6c 65 61 64 arnings can lead
2fe0: 20 74 6f 20 75 6e 70 72 65 64 69 63 74 61 62 6c to unpredictabl
2ff0: 65 0a 2a 2a 20 62 65 68 61 76 69 6f 72 2e 0a 2a e.** behavior..*
3000: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f /.int sqlite3_co
3010: 6e 66 69 67 28 69 6e 74 20 6f 70 2c 20 2e 2e 2e nfig(int op, ...
3020: 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b ){. va_list ap;
3030: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
3040: 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 73 71 6c TE_OK;.. /* sql
3050: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 73 68 ite3_config() sh
3060: 61 6c 6c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 all return SQLIT
3070: 45 5f 4d 49 53 55 53 45 20 69 66 20 69 74 20 69 E_MISUSE if it i
3080: 73 20 69 6e 76 6f 6b 65 64 20 77 68 69 6c 65 0a s invoked while.
3090: 20 20 2a 2a 20 74 68 65 20 53 51 4c 69 74 65 20 ** the SQLite
30a0: 6c 69 62 72 61 72 79 20 69 73 20 69 6e 20 75 73 library is in us
30b0: 65 2e 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 e. */. if( sqli
30c0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
30d0: 69 73 49 6e 69 74 20 29 20 72 65 74 75 72 6e 20 isInit ) return
30e0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
30f0: 50 54 3b 0a 0a 20 20 76 61 5f 73 74 61 72 74 28 PT;.. va_start(
3100: 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 ap, op);. switc
3110: 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a h( op ){.. /*
3120: 20 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 72 61 Mutex configura
3130: 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 72 65 tion options are
3140: 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 only available
3150: 69 6e 20 61 20 74 68 72 65 61 64 73 61 66 65 0a in a threadsafe.
3160: 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2e 0a ** compile..
3170: 20 20 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e */.#if defin
3180: 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ed(SQLITE_THREAD
3190: 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f SAFE) && SQLITE_
31a0: 54 48 52 45 41 44 53 41 46 45 3e 30 20 20 2f 2a THREADSAFE>0 /*
31b0: 20 49 4d 50 3a 20 52 2d 35 34 34 36 36 2d 34 36 IMP: R-54466-46
31c0: 37 35 36 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 756 */. case
31d0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 49 SQLITE_CONFIG_SI
31e0: 4e 47 4c 45 54 48 52 45 41 44 3a 20 7b 0a 20 20 NGLETHREAD: {.
31f0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
3200: 4f 46 3a 20 52 2d 30 32 37 34 38 2d 31 39 30 39 OF: R-02748-1909
3210: 36 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 6 This option se
3220: 74 73 20 74 68 65 20 74 68 72 65 61 64 69 6e 67 ts the threading
3230: 20 6d 6f 64 65 20 74 6f 0a 20 20 20 20 20 20 2a mode to. *
3240: 2a 20 53 69 6e 67 6c 65 2d 74 68 72 65 61 64 2e * Single-thread.
3250: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
3260: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 3GlobalConfig.bC
3270: 6f 72 65 4d 75 74 65 78 20 3d 20 30 3b 20 20 2f oreMutex = 0; /
3280: 2a 20 44 69 73 61 62 6c 65 20 6d 75 74 65 78 20 * Disable mutex
3290: 6f 6e 20 63 6f 72 65 20 2a 2f 0a 20 20 20 20 20 on core */.
32a0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
32b0: 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 nfig.bFullMutex
32c0: 3d 20 30 3b 20 20 2f 2a 20 44 69 73 61 62 6c 65 = 0; /* Disable
32d0: 20 6d 75 74 65 78 20 6f 6e 20 63 6f 6e 6e 65 63 mutex on connec
32e0: 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 62 tions */. b
32f0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 reak;. }.#end
3300: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
3310: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
3320: 29 20 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 ) && SQLITE_THRE
3330: 41 44 53 41 46 45 3e 30 20 2f 2a 20 49 4d 50 3a ADSAFE>0 /* IMP:
3340: 20 52 2d 32 30 35 32 30 2d 35 34 30 38 36 20 2a R-20520-54086 *
3350: 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
3360: 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48 E_CONFIG_MULTITH
3370: 52 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a READ: {. /*
3380: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
3390: 31 34 33 37 34 2d 34 32 34 36 38 20 54 68 69 73 14374-42468 This
33a0: 20 6f 70 74 69 6f 6e 20 73 65 74 73 20 74 68 65 option sets the
33b0: 20 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 20 threading mode
33c0: 74 6f 0a 20 20 20 20 20 20 2a 2a 20 4d 75 6c 74 to. ** Mult
33d0: 69 2d 74 68 72 65 61 64 2e 20 2a 2f 0a 20 20 20 i-thread. */.
33e0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
33f0: 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 Config.bCoreMute
3400: 78 20 3d 20 31 3b 20 20 2f 2a 20 45 6e 61 62 6c x = 1; /* Enabl
3410: 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f 72 65 20 e mutex on core
3420: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
3430: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 GlobalConfig.bFu
3440: 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 20 20 2f 2a llMutex = 0; /*
3450: 20 44 69 73 61 62 6c 65 20 6d 75 74 65 78 20 6f Disable mutex o
3460: 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f n connections */
3470: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
3480: 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 }.#endif.#if d
3490: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 efined(SQLITE_TH
34a0: 52 45 41 44 53 41 46 45 29 20 26 26 20 53 51 4c READSAFE) && SQL
34b0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 ITE_THREADSAFE>0
34c0: 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 39 35 39 33 /* IMP: R-59593
34d0: 2d 32 31 38 31 30 20 2a 2f 0a 20 20 20 20 63 61 -21810 */. ca
34e0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
34f0: 5f 53 45 52 49 41 4c 49 5a 45 44 3a 20 7b 0a 20 _SERIALIZED: {.
3500: 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
3510: 2d 4f 46 3a 20 52 2d 34 31 32 32 30 2d 35 31 38 -OF: R-41220-518
3520: 30 30 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 00 This option s
3530: 65 74 73 20 74 68 65 20 74 68 72 65 61 64 69 6e ets the threadin
3540: 67 20 6d 6f 64 65 20 74 6f 0a 20 20 20 20 20 20 g mode to.
3550: 2a 2a 20 53 65 72 69 61 6c 69 7a 65 64 2e 20 2a ** Serialized. *
3560: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 /. sqlite3G
3570: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 lobalConfig.bCor
3580: 65 4d 75 74 65 78 20 3d 20 31 3b 20 20 2f 2a 20 eMutex = 1; /*
3590: 45 6e 61 62 6c 65 20 6d 75 74 65 78 20 6f 6e 20 Enable mutex on
35a0: 63 6f 72 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 core */. sq
35b0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
35c0: 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 31 g.bFullMutex = 1
35d0: 3b 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6d 75 74 ; /* Enable mut
35e0: 65 78 20 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e ex on connection
35f0: 73 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 6b s */. break
3600: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 ;. }.#endif.#
3610: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
3620: 45 5f 54 48 52 45 41 44 53 41 46 45 29 20 26 26 E_THREADSAFE) &&
3630: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
3640: 46 45 3e 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 FE>0 /* IMP: R-6
3650: 33 36 36 36 2d 34 38 37 35 35 20 2a 2f 0a 20 20 3666-48755 */.
3660: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
3670: 4e 46 49 47 5f 4d 55 54 45 58 3a 20 7b 0a 20 20 NFIG_MUTEX: {.
3680: 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 20 61 /* Specify a
3690: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6d 75 n alternative mu
36a0: 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 tex implementati
36b0: 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 on */. sqli
36c0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
36d0: 6d 75 74 65 78 20 3d 20 2a 76 61 5f 61 72 67 28 mutex = *va_arg(
36e0: 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ap, sqlite3_mute
36f0: 78 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 x_methods*);.
3700: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
3710: 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
3720: 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ed(SQLITE_THREAD
3730: 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f SAFE) && SQLITE_
3740: 54 48 52 45 41 44 53 41 46 45 3e 30 20 2f 2a 20 THREADSAFE>0 /*
3750: 49 4d 50 3a 20 52 2d 31 34 34 35 30 2d 33 37 35 IMP: R-14450-375
3760: 39 37 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 97 */. case S
3770: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 QLITE_CONFIG_GET
3780: 4d 55 54 45 58 3a 20 7b 0a 20 20 20 20 20 20 2f MUTEX: {. /
3790: 2a 20 52 65 74 72 69 65 76 65 20 74 68 65 20 63 * Retrieve the c
37a0: 75 72 72 65 6e 74 20 6d 75 74 65 78 20 69 6d 70 urrent mutex imp
37b0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 lementation */.
37c0: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
37d0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d sqlite3_mutex_m
37e0: 65 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 ethods*) = sqlit
37f0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3800: 75 74 65 78 3b 0a 20 20 20 20 20 20 62 72 65 61 utex;. brea
3810: 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a k;. }.#endif.
3820: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
3830: 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 3a 20 _CONFIG_MALLOC:
3840: 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 {. /* EVIDE
3850: 4e 43 45 2d 4f 46 3a 20 52 2d 35 35 35 39 34 2d NCE-OF: R-55594-
3860: 32 31 30 33 30 20 54 68 65 20 53 51 4c 49 54 45 21030 The SQLITE
3870: 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 20 6f _CONFIG_MALLOC o
3880: 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 ption takes a.
3890: 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 ** single ar
38a0: 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 gument which is
38b0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 a pointer to an
38c0: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 0a instance of the.
38d0: 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 ** sqlite3
38e0: 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 73 74 72 _mem_methods str
38f0: 75 63 74 75 72 65 2e 20 54 68 65 20 61 72 67 75 ucture. The argu
3900: 6d 65 6e 74 20 73 70 65 63 69 66 69 65 73 20 61 ment specifies a
3910: 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 20 20 20 lternative.
3920: 20 2a 2a 20 6c 6f 77 2d 6c 65 76 65 6c 20 6d 65 ** low-level me
3930: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
3940: 72 6f 75 74 69 6e 65 73 20 74 6f 20 62 65 20 75 routines to be u
3950: 73 65 64 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 sed in place of
3960: 74 68 65 20 6d 65 6d 6f 72 79 0a 20 20 20 20 20 the memory.
3970: 20 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 ** allocation r
3980: 6f 75 74 69 6e 65 73 20 62 75 69 6c 74 20 69 6e outines built in
3990: 74 6f 20 53 51 4c 69 74 65 2e 20 2a 2f 0a 20 20 to SQLite. */.
39a0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
39b0: 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 76 61 5f lConfig.m = *va_
39c0: 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f arg(ap, sqlite3_
39d0: 6d 65 6d 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 mem_methods*);.
39e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
39f0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
3a00: 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c 4c E_CONFIG_GETMALL
3a10: 4f 43 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 OC: {. /* E
3a20: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 31 VIDENCE-OF: R-51
3a30: 32 31 33 2d 34 36 34 31 34 20 54 68 65 20 53 51 213-46414 The SQ
3a40: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d LITE_CONFIG_GETM
3a50: 41 4c 4c 4f 43 20 6f 70 74 69 6f 6e 20 74 61 6b ALLOC option tak
3a60: 65 73 20 61 0a 20 20 20 20 20 20 2a 2a 20 73 69 es a. ** si
3a70: 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 68 ngle argument wh
3a80: 69 63 68 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ich is a pointer
3a90: 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 to an instance
3aa0: 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 of the. **
3ab0: 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
3ac0: 6f 64 73 20 73 74 72 75 63 74 75 72 65 2e 20 54 ods structure. T
3ad0: 68 65 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d he sqlite3_mem_m
3ae0: 65 74 68 6f 64 73 20 73 74 72 75 63 74 75 72 65 ethods structure
3af0: 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c is. ** fil
3b00: 6c 65 64 20 77 69 74 68 20 74 68 65 20 63 75 72 led with the cur
3b10: 72 65 6e 74 6c 79 20 64 65 66 69 6e 65 64 20 6d rently defined m
3b20: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
3b30: 20 72 6f 75 74 69 6e 65 73 2e 20 2a 2f 0a 20 20 routines. */.
3b40: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 if( sqlite3G
3b50: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d lobalConfig.m.xM
3b60: 61 6c 6c 6f 63 3d 3d 30 20 29 20 73 71 6c 69 74 alloc==0 ) sqlit
3b70: 65 33 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 28 e3MemSetDefault(
3b80: 29 3b 0a 20 20 20 20 20 20 2a 76 61 5f 61 72 67 );. *va_arg
3b90: 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d (ap, sqlite3_mem
3ba0: 5f 6d 65 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c _methods*) = sql
3bb0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3bc0: 2e 6d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b .m;. break;
3bd0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
3be0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 SQLITE_CONFIG_ME
3bf0: 4d 53 54 41 54 55 53 3a 20 7b 0a 20 20 20 20 20 MSTATUS: {.
3c00: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
3c10: 20 52 2d 36 31 32 37 35 2d 33 35 31 35 37 20 54 R-61275-35157 T
3c20: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 he SQLITE_CONFIG
3c30: 5f 4d 45 4d 53 54 41 54 55 53 20 6f 70 74 69 6f _MEMSTATUS optio
3c40: 6e 20 74 61 6b 65 73 0a 20 20 20 20 20 20 2a 2a n takes. **
3c50: 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 single argument
3c60: 20 6f 66 20 74 79 70 65 20 69 6e 74 2c 20 69 6e of type int, in
3c70: 74 65 72 70 72 65 74 65 64 20 61 73 20 61 20 62 terpreted as a b
3c80: 6f 6f 6c 65 61 6e 2c 20 77 68 69 63 68 20 65 6e oolean, which en
3c90: 61 62 6c 65 73 0a 20 20 20 20 20 20 2a 2a 20 6f ables. ** o
3ca0: 72 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 63 r disables the c
3cb0: 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 6d 65 6d ollection of mem
3cc0: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 ory allocation s
3cd0: 74 61 74 69 73 74 69 63 73 2e 20 2a 2f 0a 20 20 tatistics. */.
3ce0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3cf0: 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 74 lConfig.bMemstat
3d00: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
3d10: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
3d20: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
3d30: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 43 SQLITE_CONFIG_SC
3d40: 52 41 54 43 48 3a 20 7b 0a 20 20 20 20 20 20 2f RATCH: {. /
3d50: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
3d60: 2d 30 38 34 30 34 2d 36 30 38 38 37 20 54 68 65 -08404-60887 The
3d70: 72 65 20 61 72 65 20 74 68 72 65 65 20 61 72 67 re are three arg
3d80: 75 6d 65 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 uments to.
3d90: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ** SQLITE_CONFIG
3da0: 5f 53 43 52 41 54 43 48 3a 20 41 20 70 6f 69 6e _SCRATCH: A poin
3db0: 74 65 72 20 61 6e 20 38 2d 62 79 74 65 20 61 6c ter an 8-byte al
3dc0: 69 67 6e 65 64 20 6d 65 6d 6f 72 79 20 62 75 66 igned memory buf
3dd0: 66 65 72 20 66 72 6f 6d 0a 20 20 20 20 20 20 2a fer from. *
3de0: 2a 20 77 68 69 63 68 20 74 68 65 20 73 63 72 61 * which the scra
3df0: 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 tch allocations
3e00: 77 69 6c 6c 20 62 65 20 64 72 61 77 6e 2c 20 74 will be drawn, t
3e10: 68 65 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 he size of each
3e20: 73 63 72 61 74 63 68 0a 20 20 20 20 20 20 2a 2a scratch. **
3e30: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 28 73 7a 29 allocation (sz)
3e40: 2c 20 61 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 , and the maximu
3e50: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 73 63 72 61 m number of scra
3e60: 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 tch allocations
3e70: 28 4e 29 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 (N). */. sq
3e80: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3e90: 67 2e 70 53 63 72 61 74 63 68 20 3d 20 76 61 5f g.pScratch = va_
3ea0: 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a arg(ap, void*);.
3eb0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3ec0: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 53 63 72 61 balConfig.szScra
3ed0: 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 2c tch = va_arg(ap,
3ee0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c int);. sql
3ef0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3f00: 2e 6e 53 63 72 61 74 63 68 20 3d 20 76 61 5f 61 .nScratch = va_a
3f10: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
3f20: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
3f30: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
3f40: 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 45 CONFIG_PAGECACHE
3f50: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 : {. /* EVI
3f60: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 38 37 36 DENCE-OF: R-1876
3f70: 31 2d 33 36 36 30 31 20 54 68 65 72 65 20 61 72 1-36601 There ar
3f80: 65 20 74 68 72 65 65 20 61 72 67 75 6d 65 6e 74 e three argument
3f90: 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 51 s to. ** SQ
3fa0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 LITE_CONFIG_PAGE
3fb0: 43 41 43 48 45 3a 20 41 20 70 6f 69 6e 74 65 72 CACHE: A pointer
3fc0: 20 74 6f 20 38 2d 62 79 74 65 20 61 6c 69 67 6e to 8-byte align
3fd0: 65 64 20 6d 65 6d 6f 72 79 20 28 70 4d 65 6d 29 ed memory (pMem)
3fe0: 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 73 ,. ** the s
3ff0: 69 7a 65 20 6f 66 20 65 61 63 68 20 70 61 67 65 ize of each page
4000: 20 63 61 63 68 65 20 6c 69 6e 65 20 28 73 7a 29 cache line (sz)
4010: 2c 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 , and the number
4020: 20 6f 66 20 63 61 63 68 65 20 6c 69 6e 65 73 0a of cache lines.
4030: 20 20 20 20 20 20 2a 2a 20 28 4e 29 2e 20 2a 2f ** (N). */
4040: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
4050: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 obalConfig.pPage
4060: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f = va_arg(ap, vo
4070: 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 id*);. sqli
4080: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4090: 73 7a 50 61 67 65 20 3d 20 76 61 5f 61 72 67 28 szPage = va_arg(
40a0: 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 ap, int);.
40b0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
40c0: 66 69 67 2e 6e 50 61 67 65 20 3d 20 76 61 5f 61 fig.nPage = va_a
40d0: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
40e0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
40f0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
4100: 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 5f 48 44 CONFIG_PCACHE_HD
4110: 52 53 5a 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 RSZ: {. /*
4120: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 EVIDENCE-OF: R-3
4130: 39 31 30 30 2d 32 37 33 31 37 20 54 68 65 20 53 9100-27317 The S
4140: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 QLITE_CONFIG_PCA
4150: 43 48 45 5f 48 44 52 53 5a 20 6f 70 74 69 6f 6e CHE_HDRSZ option
4160: 20 74 61 6b 65 73 0a 20 20 20 20 20 20 2a 2a 20 takes. **
4170: 61 20 73 69 6e 67 6c 65 20 70 61 72 61 6d 65 74 a single paramet
4180: 65 72 20 77 68 69 63 68 20 69 73 20 61 20 70 6f er which is a po
4190: 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 74 65 inter to an inte
41a0: 67 65 72 20 61 6e 64 20 77 72 69 74 65 73 20 69 ger and writes i
41b0: 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 nto. ** tha
41c0: 74 20 69 6e 74 65 67 65 72 20 74 68 65 20 6e 75 t integer the nu
41d0: 6d 62 65 72 20 6f 66 20 65 78 74 72 61 20 62 79 mber of extra by
41e0: 74 65 73 20 70 65 72 20 70 61 67 65 20 72 65 71 tes per page req
41f0: 75 69 72 65 64 20 66 6f 72 20 65 61 63 68 20 70 uired for each p
4200: 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 age. ** in
4210: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 SQLITE_CONFIG_PA
4220: 47 45 43 41 43 48 45 2e 20 2a 2f 0a 20 20 20 20 GECACHE. */.
4230: 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 69 6e *va_arg(ap, in
4240: 74 2a 29 20 3d 20 0a 20 20 20 20 20 20 20 20 20 t*) = .
4250: 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 53 69 sqlite3HeaderSi
4260: 7a 65 42 74 72 65 65 28 29 20 2b 0a 20 20 20 20 zeBtree() +.
4270: 20 20 20 20 20 20 73 71 6c 69 74 65 33 48 65 61 sqlite3Hea
4280: 64 65 72 53 69 7a 65 50 63 61 63 68 65 28 29 20 derSizePcache()
4290: 2b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 +. sqli
42a0: 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 63 61 te3HeaderSizePca
42b0: 63 68 65 31 28 29 3b 0a 20 20 20 20 20 20 62 72 che1();. br
42c0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
42d0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
42e0: 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 IG_PCACHE: {.
42f0: 20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 20 /* no-op */.
4300: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
4310: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
4320: 45 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 E_CONFIG_GETPCAC
4330: 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 6e HE: {. /* n
4340: 6f 77 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 ow an error */.
4350: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
4360: 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 _ERROR;. br
4370: 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 eak;. }..
4380: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
4390: 49 47 5f 50 43 41 43 48 45 32 3a 20 7b 0a 20 20 IG_PCACHE2: {.
43a0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
43b0: 4f 46 3a 20 52 2d 36 33 33 32 35 2d 34 38 33 37 OF: R-63325-4837
43c0: 38 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 8 The SQLITE_CON
43d0: 46 49 47 5f 50 43 41 43 48 45 32 20 6f 70 74 69 FIG_PCACHE2 opti
43e0: 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 20 20 on takes a.
43f0: 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 6d ** single argum
4400: 65 6e 74 20 77 68 69 63 68 20 69 73 20 61 20 70 ent which is a p
4410: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 73 71 6c ointer to an sql
4420: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 ite3_pcache_meth
4430: 6f 64 73 32 0a 20 20 20 20 20 20 2a 2a 20 6f 62 ods2. ** ob
4440: 6a 65 63 74 2e 20 54 68 69 73 20 6f 62 6a 65 63 ject. This objec
4450: 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 t specifies the
4460: 69 6e 74 65 72 66 61 63 65 20 74 6f 20 61 20 63 interface to a c
4470: 75 73 74 6f 6d 20 70 61 67 65 20 63 61 63 68 65 ustom page cache
4480: 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6c 65 6d . ** implem
4490: 65 6e 74 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20 entation. */.
44a0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
44b0: 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 32 20 3d Config.pcache2 =
44c0: 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c *va_arg(ap, sql
44d0: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 ite3_pcache_meth
44e0: 6f 64 73 32 2a 29 3b 0a 20 20 20 20 20 20 62 72 ods2*);. br
44f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 eak;. }. c
4500: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
4510: 47 5f 47 45 54 50 43 41 43 48 45 32 3a 20 7b 0a G_GETPCACHE2: {.
4520: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
4530: 45 2d 4f 46 3a 20 52 2d 32 32 30 33 35 2d 34 36 E-OF: R-22035-46
4540: 31 38 32 20 54 68 65 20 53 51 4c 49 54 45 5f 43 182 The SQLITE_C
4550: 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 48 45 32 ONFIG_GETPCACHE2
4560: 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a option takes a.
4570: 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 ** single
4580: 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 argument which i
4590: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 s a pointer to a
45a0: 6e 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 n sqlite3_pcache
45b0: 5f 6d 65 74 68 6f 64 73 32 0a 20 20 20 20 20 20 _methods2.
45c0: 2a 2a 20 6f 62 6a 65 63 74 2e 20 53 51 4c 69 74 ** object. SQLit
45d0: 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 65 20 e copies of the
45e0: 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 61 63 current page cac
45f0: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f he implementatio
4600: 6e 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 n into. **
4610: 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a that object. */.
4620: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
4630: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 63 3GlobalConfig.pc
4640: 61 63 68 65 32 2e 78 49 6e 69 74 3d 3d 30 20 29 ache2.xInit==0 )
4650: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
4660: 33 50 43 61 63 68 65 53 65 74 44 65 66 61 75 6c 3PCacheSetDefaul
4670: 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 t();. }.
4680: 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 *va_arg(ap, s
4690: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
46a0: 74 68 6f 64 73 32 2a 29 20 3d 20 73 71 6c 69 74 thods2*) = sqlit
46b0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
46c0: 63 61 63 68 65 32 3b 0a 20 20 20 20 20 20 62 72 cache2;. br
46d0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 2f 2a 20 45 eak;. }../* E
46e0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 36 VIDENCE-OF: R-06
46f0: 36 32 36 2d 31 32 39 31 31 20 54 68 65 20 53 51 626-12911 The SQ
4700: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 LITE_CONFIG_HEAP
4710: 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 0a option is only.
4720: 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 69 66 20 ** available if
4730: 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c SQLite is compil
4740: 65 64 20 77 69 74 68 20 65 69 74 68 65 72 20 53 ed with either S
4750: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d QLITE_ENABLE_MEM
4760: 53 59 53 33 20 6f 72 0a 2a 2a 20 53 51 4c 49 54 SYS3 or.** SQLIT
4770: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 E_ENABLE_MEMSYS5
4780: 20 61 6e 64 20 72 65 74 75 72 6e 73 20 53 51 4c and returns SQL
4790: 49 54 45 5f 45 52 52 4f 52 20 69 66 20 69 6e 76 ITE_ERROR if inv
47a0: 6f 6b 65 64 20 6f 74 68 65 72 77 69 73 65 2e 20 oked otherwise.
47b0: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
47c0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d QLITE_ENABLE_MEM
47d0: 53 59 53 33 29 20 7c 7c 20 64 65 66 69 6e 65 64 SYS3) || defined
47e0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d (SQLITE_ENABLE_M
47f0: 45 4d 53 59 53 35 29 0a 20 20 20 20 63 61 73 65 EMSYS5). case
4800: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 SQLITE_CONFIG_H
4810: 45 41 50 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 EAP: {. /*
4820: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 EVIDENCE-OF: R-1
4830: 39 38 35 34 2d 34 32 31 32 36 20 54 68 65 72 65 9854-42126 There
4840: 20 61 72 65 20 74 68 72 65 65 20 61 72 67 75 6d are three argum
4850: 65 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a ents to. **
4860: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 SQLITE_CONFIG_H
4870: 45 41 50 3a 20 41 6e 20 38 2d 62 79 74 65 20 61 EAP: An 8-byte a
4880: 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65 72 20 74 ligned pointer t
4890: 6f 20 74 68 65 20 6d 65 6d 6f 72 79 2c 20 74 68 o the memory, th
48a0: 65 0a 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 e. ** numbe
48b0: 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 74 68 r of bytes in th
48c0: 65 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 2c e memory buffer,
48d0: 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 6d 75 6d and the minimum
48e0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 7a 65 allocation size
48f0: 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
4900: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
4910: 6e 66 69 67 2e 70 48 65 61 70 20 3d 20 76 61 5f nfig.pHeap = va_
4920: 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a arg(ap, void*);.
4930: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
4940: 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 70 20 balConfig.nHeap
4950: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
4960: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
4970: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 GlobalConfig.mnR
4980: 65 71 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 eq = va_arg(ap,
4990: 69 6e 74 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 int);.. if(
49a0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
49b0: 6e 66 69 67 2e 6d 6e 52 65 71 3c 31 20 29 7b 0a nfig.mnReq<1 ){.
49c0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 sqlite3G
49d0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 lobalConfig.mnRe
49e0: 71 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 65 6c q = 1;. }el
49f0: 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c se if( sqlite3Gl
4a00: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 obalConfig.mnReq
4a10: 3e 28 31 3c 3c 31 32 29 20 29 7b 0a 20 20 20 20 >(1<<12) ){.
4a20: 20 20 20 20 2f 2a 20 63 61 70 20 6d 69 6e 20 72 /* cap min r
4a30: 65 71 75 65 73 74 20 73 69 7a 65 20 61 74 20 32 equest size at 2
4a40: 5e 31 32 20 2a 2f 0a 20 20 20 20 20 20 20 20 73 ^12 */. s
4a50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
4a60: 69 67 2e 6d 6e 52 65 71 20 3d 20 28 31 3c 3c 31 ig.mnReq = (1<<1
4a70: 32 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 2);. }..
4a80: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c if( sqlite3Gl
4a90: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 61 70 obalConfig.pHeap
4aa0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ==0 ){. /
4ab0: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
4ac0: 2d 34 39 39 32 30 2d 36 30 31 38 39 20 49 66 20 -49920-60189 If
4ad0: 74 68 65 20 66 69 72 73 74 20 70 6f 69 6e 74 65 the first pointe
4ae0: 72 20 28 74 68 65 20 6d 65 6d 6f 72 79 20 70 6f r (the memory po
4af0: 69 6e 74 65 72 29 0a 20 20 20 20 20 20 20 20 2a inter). *
4b00: 2a 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 * is NULL, then
4b10: 53 51 4c 69 74 65 20 72 65 76 65 72 74 73 20 74 SQLite reverts t
4b20: 6f 20 75 73 69 6e 67 20 69 74 73 20 64 65 66 61 o using its defa
4b30: 75 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 ult memory alloc
4b40: 61 74 6f 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 ator. **
4b50: 28 74 68 65 20 73 79 73 74 65 6d 20 6d 61 6c 6c (the system mall
4b60: 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 61 74 oc() implementat
4b70: 69 6f 6e 29 2c 20 75 6e 64 6f 69 6e 67 20 61 6e ion), undoing an
4b80: 79 20 70 72 69 6f 72 20 69 6e 76 6f 63 61 74 69 y prior invocati
4b90: 6f 6e 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a on of. **
4ba0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d SQLITE_CONFIG_M
4bb0: 41 4c 4c 4f 43 2e 0a 20 20 20 20 20 20 20 20 2a ALLOC.. *
4bc0: 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 65 74 *. ** Set
4bd0: 74 69 6e 67 20 73 71 6c 69 74 65 33 47 6c 6f 62 ting sqlite3Glob
4be0: 61 6c 43 6f 6e 66 69 67 2e 6d 20 74 6f 20 61 6c alConfig.m to al
4bf0: 6c 20 7a 65 72 6f 73 20 77 69 6c 6c 20 63 61 75 l zeros will cau
4c00: 73 65 20 6d 61 6c 6c 6f 63 20 74 6f 0a 20 20 20 se malloc to.
4c10: 20 20 20 20 20 2a 2a 20 72 65 76 65 72 74 20 74 ** revert t
4c20: 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 69 6d o its default im
4c30: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 68 65 plementation whe
4c40: 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 n sqlite3_initia
4c50: 6c 69 7a 65 28 29 20 69 73 20 72 75 6e 0a 20 20 lize() is run.
4c60: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
4c70: 20 6d 65 6d 73 65 74 28 26 73 71 6c 69 74 65 33 memset(&sqlite3
4c80: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2c 20 GlobalConfig.m,
4c90: 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 0, sizeof(sqlite
4ca0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 29 3GlobalConfig.m)
4cb0: 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a );. }else{.
4cc0: 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 /* EVIDE
4cd0: 4e 43 45 2d 4f 46 3a 20 52 2d 36 31 30 30 36 2d NCE-OF: R-61006-
4ce0: 30 38 39 31 38 20 49 66 20 74 68 65 20 6d 65 6d 08918 If the mem
4cf0: 6f 72 79 20 70 6f 69 6e 74 65 72 20 69 73 20 6e ory pointer is n
4d00: 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 ot NULL then the
4d10: 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6c 74 65 . ** alte
4d20: 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 61 rnative memory a
4d30: 6c 6c 6f 63 61 74 6f 72 20 69 73 20 65 6e 67 61 llocator is enga
4d40: 67 65 64 20 74 6f 20 68 61 6e 64 6c 65 20 61 6c ged to handle al
4d50: 6c 20 6f 66 20 53 51 4c 69 74 65 73 0a 20 20 20 l of SQLites.
4d60: 20 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 20 61 ** memory a
4d70: 6c 6c 6f 63 61 74 69 6f 6e 20 6e 65 65 64 73 2e llocation needs.
4d80: 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
4d90: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 E_ENABLE_MEMSYS3
4da0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
4db0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d GlobalConfig.m =
4dc0: 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d *sqlite3MemGetM
4dd0: 65 6d 73 79 73 33 28 29 3b 0a 23 65 6e 64 69 66 emsys3();.#endif
4de0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
4df0: 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 0a 20 20 NABLE_MEMSYS5.
4e00: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
4e10: 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 balConfig.m = *s
4e20: 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 qlite3MemGetMems
4e30: 79 73 35 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20 ys5();.#endif.
4e40: 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 }. brea
4e50: 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a k;. }.#endif.
4e60: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
4e70: 5f 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 _CONFIG_LOOKASID
4e80: 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 E: {. sqlit
4e90: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 e3GlobalConfig.s
4ea0: 7a 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f zLookaside = va_
4eb0: 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
4ec0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4ed0: 6c 43 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 lConfig.nLookasi
4ee0: 64 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 de = va_arg(ap,
4ef0: 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 int);. brea
4f00: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 0a 20 20 k;. }. .
4f10: 20 20 2f 2a 20 52 65 63 6f 72 64 20 61 20 70 6f /* Record a po
4f20: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6c 6f 67 inter to the log
4f30: 67 65 72 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 ger function and
4f40: 20 69 74 73 20 66 69 72 73 74 20 61 72 67 75 6d its first argum
4f50: 65 6e 74 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 ent.. ** The
4f60: 64 65 66 61 75 6c 74 20 69 73 20 4e 55 4c 4c 2e default is NULL.
4f70: 20 20 4c 6f 67 67 69 6e 67 20 69 73 20 64 69 73 Logging is dis
4f80: 61 62 6c 65 64 20 69 66 20 74 68 65 20 66 75 6e abled if the fun
4f90: 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 ction pointer is
4fa0: 0a 20 20 20 20 2a 2a 20 4e 55 4c 4c 2e 0a 20 20 . ** NULL..
4fb0: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
4fc0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 47 3a LITE_CONFIG_LOG:
4fd0: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 4d 53 56 43 {. /* MSVC
4fe0: 20 69 73 20 70 69 63 6b 79 20 61 62 6f 75 74 20 is picky about
4ff0: 70 75 6c 6c 69 6e 67 20 66 75 6e 63 20 70 74 72 pulling func ptr
5000: 73 20 66 72 6f 6d 20 76 61 20 6c 69 73 74 73 2e s from va lists.
5010: 0a 20 20 20 20 20 20 2a 2a 20 68 74 74 70 3a 2f . ** http:/
5020: 2f 73 75 70 70 6f 72 74 2e 6d 69 63 72 6f 73 6f /support.microso
5030: 66 74 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a ft.com/kb/47961.
5040: 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 ** sqlite3
5050: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f GlobalConfig.xLo
5060: 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 g = va_arg(ap, v
5070: 6f 69 64 28 2a 29 28 76 6f 69 64 2a 2c 69 6e 74 oid(*)(void*,int
5080: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 3b 0a ,const char*));.
5090: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 74 */. t
50a0: 79 70 65 64 65 66 20 76 6f 69 64 28 2a 4c 4f 47 ypedef void(*LOG
50b0: 46 55 4e 43 5f 74 29 28 76 6f 69 64 2a 2c 69 6e FUNC_t)(void*,in
50c0: 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a t,const char*);.
50d0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
50e0: 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 20 3d balConfig.xLog =
50f0: 20 76 61 5f 61 72 67 28 61 70 2c 20 4c 4f 47 46 va_arg(ap, LOGF
5100: 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 UNC_t);. sq
5110: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
5120: 67 2e 70 4c 6f 67 41 72 67 20 3d 20 76 61 5f 61 g.pLogArg = va_a
5130: 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 rg(ap, void*);.
5140: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
5150: 7d 0a 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e }.. /* EVIDEN
5160: 43 45 2d 4f 46 3a 20 52 2d 35 35 35 34 38 2d 33 CE-OF: R-55548-3
5170: 33 38 31 37 20 54 68 65 20 63 6f 6d 70 69 6c 65 3817 The compile
5180: 2d 74 69 6d 65 20 73 65 74 74 69 6e 67 20 66 6f -time setting fo
5190: 72 20 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 0a r URI filenames.
51a0: 20 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 63 68 ** can be ch
51b0: 61 6e 67 65 64 20 61 74 20 73 74 61 72 74 2d 74 anged at start-t
51c0: 69 6d 65 20 75 73 69 6e 67 20 74 68 65 0a 20 20 ime using the.
51d0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e ** sqlite3_con
51e0: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 fig(SQLITE_CONFI
51f0: 47 5f 55 52 49 2c 31 29 20 6f 72 0a 20 20 20 20 G_URI,1) or.
5200: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 ** sqlite3_confi
5210: 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f g(SQLITE_CONFIG_
5220: 55 52 49 2c 30 29 20 63 6f 6e 66 69 67 75 72 61 URI,0) configura
5230: 74 69 6f 6e 20 63 61 6c 6c 73 2e 0a 20 20 20 20 tion calls..
5240: 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
5250: 54 45 5f 43 4f 4e 46 49 47 5f 55 52 49 3a 20 7b TE_CONFIG_URI: {
5260: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
5270: 43 45 2d 4f 46 3a 20 52 2d 32 35 34 35 31 2d 36 CE-OF: R-25451-6
5280: 31 31 32 35 20 54 68 65 20 53 51 4c 49 54 45 5f 1125 The SQLITE_
5290: 43 4f 4e 46 49 47 5f 55 52 49 20 6f 70 74 69 6f CONFIG_URI optio
52a0: 6e 20 74 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 n takes a single
52b0: 0a 20 20 20 20 20 20 2a 2a 20 61 72 67 75 6d 65 . ** argume
52c0: 6e 74 20 6f 66 20 74 79 70 65 20 69 6e 74 2e 20 nt of type int.
52d0: 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 If non-zero, the
52e0: 6e 20 55 52 49 20 68 61 6e 64 6c 69 6e 67 20 69 n URI handling i
52f0: 73 20 67 6c 6f 62 61 6c 6c 79 0a 20 20 20 20 20 s globally.
5300: 20 2a 2a 20 65 6e 61 62 6c 65 64 2e 20 49 66 20 ** enabled. If
5310: 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 69 73 the parameter is
5320: 20 7a 65 72 6f 2c 20 74 68 65 6e 20 55 52 49 20 zero, then URI
5330: 68 61 6e 64 6c 69 6e 67 20 69 73 20 67 6c 6f 62 handling is glob
5340: 61 6c 6c 79 0a 20 20 20 20 20 20 2a 2a 20 64 69 ally. ** di
5350: 73 61 62 6c 65 64 2e 20 2a 2f 0a 20 20 20 20 20 sabled. */.
5360: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
5370: 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 20 3d 20 nfig.bOpenUri =
5380: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
5390: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
53a0: 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 53 51 }.. case SQ
53b0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 LITE_CONFIG_COVE
53c0: 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e 3a RING_INDEX_SCAN:
53d0: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 {. /* EVID
53e0: 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 36 35 39 32 ENCE-OF: R-36592
53f0: 2d 30 32 37 37 32 20 54 68 65 20 53 51 4c 49 54 -02772 The SQLIT
5400: 45 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e E_CONFIG_COVERIN
5410: 47 5f 49 4e 44 45 58 5f 53 43 41 4e 0a 20 20 20 G_INDEX_SCAN.
5420: 20 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 74 61 6b ** option tak
5430: 65 73 20 61 20 73 69 6e 67 6c 65 20 69 6e 74 65 es a single inte
5440: 67 65 72 20 61 72 67 75 6d 65 6e 74 20 77 68 69 ger argument whi
5450: 63 68 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 ch is interprete
5460: 64 20 61 73 20 61 0a 20 20 20 20 20 20 2a 2a 20 d as a. **
5470: 62 6f 6f 6c 65 61 6e 20 69 6e 20 6f 72 64 65 72 boolean in order
5480: 20 74 6f 20 65 6e 61 62 6c 65 20 6f 72 20 64 69 to enable or di
5490: 73 61 62 6c 65 20 74 68 65 20 75 73 65 20 6f 66 sable the use of
54a0: 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 covering indice
54b0: 73 20 66 6f 72 0a 20 20 20 20 20 20 2a 2a 20 66 s for. ** f
54c0: 75 6c 6c 20 74 61 62 6c 65 20 73 63 61 6e 73 20 ull table scans
54d0: 69 6e 20 74 68 65 20 71 75 65 72 79 20 6f 70 74 in the query opt
54e0: 69 6d 69 7a 65 72 2e 20 2a 2f 0a 20 20 20 20 20 imizer. */.
54f0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
5500: 6e 66 69 67 2e 62 55 73 65 43 69 73 20 3d 20 76 nfig.bUseCis = v
5510: 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
5520: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
5530: 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }..#ifdef SQLIT
5540: 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a E_ENABLE_SQLLOG.
5550: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
5560: 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f 47 3a 20 7b CONFIG_SQLLOG: {
5570: 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 20 76 . typedef v
5580: 6f 69 64 28 2a 53 51 4c 4c 4f 47 46 55 4e 43 5f oid(*SQLLOGFUNC_
5590: 74 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69 74 65 t)(void*, sqlite
55a0: 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 3*, const char*,
55b0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c int);. sql
55c0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
55d0: 2e 78 53 71 6c 6c 6f 67 20 3d 20 76 61 5f 61 72 .xSqllog = va_ar
55e0: 67 28 61 70 2c 20 53 51 4c 4c 4f 47 46 55 4e 43 g(ap, SQLLOGFUNC
55f0: 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 _t);. sqlit
5600: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
5610: 53 71 6c 6c 6f 67 41 72 67 20 3d 20 76 61 5f 61 SqllogArg = va_a
5620: 72 67 28 61 70 2c 20 76 6f 69 64 20 2a 29 3b 0a rg(ap, void *);.
5630: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
5640: 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 63 }.#endif.. c
5650: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
5660: 47 5f 4d 4d 41 50 5f 53 49 5a 45 3a 20 7b 0a 20 G_MMAP_SIZE: {.
5670: 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
5680: 2d 4f 46 3a 20 52 2d 35 38 30 36 33 2d 33 38 32 -OF: R-58063-382
5690: 35 38 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 58 SQLITE_CONFIG
56a0: 5f 4d 4d 41 50 5f 53 49 5a 45 20 74 61 6b 65 73 _MMAP_SIZE takes
56b0: 20 74 77 6f 20 36 34 2d 62 69 74 0a 20 20 20 20 two 64-bit.
56c0: 20 20 2a 2a 20 69 6e 74 65 67 65 72 20 28 73 71 ** integer (sq
56d0: 6c 69 74 65 33 5f 69 6e 74 36 34 29 20 76 61 6c lite3_int64) val
56e0: 75 65 73 20 74 68 61 74 20 61 72 65 20 74 68 65 ues that are the
56f0: 20 64 65 66 61 75 6c 74 20 6d 6d 61 70 20 73 69 default mmap si
5700: 7a 65 20 6c 69 6d 69 74 0a 20 20 20 20 20 20 2a ze limit. *
5710: 2a 20 28 74 68 65 20 64 65 66 61 75 6c 74 20 73 * (the default s
5720: 65 74 74 69 6e 67 20 66 6f 72 20 50 52 41 47 4d etting for PRAGM
5730: 41 20 6d 6d 61 70 5f 73 69 7a 65 29 20 61 6e 64 A mmap_size) and
5740: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 6c 6c the maximum all
5750: 6f 77 65 64 0a 20 20 20 20 20 20 2a 2a 20 6d 6d owed. ** mm
5760: 61 70 20 73 69 7a 65 20 6c 69 6d 69 74 2e 20 2a ap size limit. *
5770: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f /. sqlite3_
5780: 69 6e 74 36 34 20 73 7a 4d 6d 61 70 20 3d 20 76 int64 szMmap = v
5790: 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 a_arg(ap, sqlite
57a0: 33 5f 69 6e 74 36 34 29 3b 0a 20 20 20 20 20 20 3_int64);.
57b0: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6d 78 sqlite3_int64 mx
57c0: 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 61 70 Mmap = va_arg(ap
57d0: 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 , sqlite3_int64)
57e0: 3b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 ;. /* EVIDE
57f0: 4e 43 45 2d 4f 46 3a 20 52 2d 35 33 33 36 37 2d NCE-OF: R-53367-
5800: 34 33 31 39 30 20 49 66 20 65 69 74 68 65 72 20 43190 If either
5810: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 argument to this
5820: 20 6f 70 74 69 6f 6e 20 69 73 0a 20 20 20 20 20 option is.
5830: 20 2a 2a 20 6e 65 67 61 74 69 76 65 2c 20 74 68 ** negative, th
5840: 65 6e 20 74 68 61 74 20 61 72 67 75 6d 65 6e 74 en that argument
5850: 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f 20 69 is changed to i
5860: 74 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 ts compile-time
5870: 64 65 66 61 75 6c 74 2e 0a 20 20 20 20 20 20 2a default.. *
5880: 2a 0a 20 20 20 20 20 20 2a 2a 20 45 56 49 44 45 *. ** EVIDE
5890: 4e 43 45 2d 4f 46 3a 20 52 2d 33 34 39 39 33 2d NCE-OF: R-34993-
58a0: 34 35 30 33 31 20 54 68 65 20 6d 61 78 69 6d 75 45031 The maximu
58b0: 6d 20 61 6c 6c 6f 77 65 64 20 6d 6d 61 70 20 73 m allowed mmap s
58c0: 69 7a 65 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 ize will be.
58d0: 20 20 2a 2a 20 73 69 6c 65 6e 74 6c 79 20 74 72 ** silently tr
58e0: 75 6e 63 61 74 65 64 20 69 66 20 6e 65 63 65 73 uncated if neces
58f0: 73 61 72 79 20 73 6f 20 74 68 61 74 20 69 74 20 sary so that it
5900: 64 6f 65 73 20 6e 6f 74 20 65 78 63 65 65 64 20 does not exceed
5910: 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6d the. ** com
5920: 70 69 6c 65 2d 74 69 6d 65 20 6d 61 78 69 6d 75 pile-time maximu
5930: 6d 20 6d 6d 61 70 20 73 69 7a 65 20 73 65 74 20 m mmap size set
5940: 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 by the SQLITE_MA
5950: 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 20 20 20 20 X_MMAP_SIZE.
5960: 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d ** compile-tim
5970: 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 e option..
5980: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d 78 4d */. if( mxM
5990: 6d 61 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 70 3e map<0 || mxMmap>
59a0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
59b0: 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 20 20 SIZE ){.
59c0: 6d 78 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f mxMmap = SQLITE_
59d0: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 MAX_MMAP_SIZE;.
59e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 }. if(
59f0: 20 73 7a 4d 6d 61 70 3c 30 20 29 20 73 7a 4d 6d szMmap<0 ) szMm
5a00: 61 70 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 ap = SQLITE_DEFA
5a10: 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 ULT_MMAP_SIZE;.
5a20: 20 20 20 20 20 69 66 28 20 73 7a 4d 6d 61 70 3e if( szMmap>
5a30: 6d 78 4d 6d 61 70 29 20 73 7a 4d 6d 61 70 20 3d mxMmap) szMmap =
5a40: 20 6d 78 4d 6d 61 70 3b 0a 20 20 20 20 20 20 73 mxMmap;. s
5a50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
5a60: 69 67 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 4d 6d ig.mxMmap = mxMm
5a70: 61 70 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ap;. sqlite
5a80: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
5a90: 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b 0a 20 Mmap = szMmap;.
5aa0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
5ab0: 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4f 53 }..#if SQLITE_OS
5ac0: 5f 57 49 4e 20 26 26 20 64 65 66 69 6e 65 64 28 _WIN && defined(
5ad0: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
5ae0: 4c 4f 43 29 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 LOC) /* IMP: R-0
5af0: 34 37 38 30 2d 35 35 38 31 35 20 2a 2f 0a 20 20 4780-55815 */.
5b00: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
5b10: 4e 46 49 47 5f 57 49 4e 33 32 5f 48 45 41 50 53 NFIG_WIN32_HEAPS
5b20: 49 5a 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 IZE: {. /*
5b30: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 EVIDENCE-OF: R-3
5b40: 34 39 32 36 2d 30 33 33 36 30 20 53 51 4c 49 54 4926-03360 SQLIT
5b50: 45 5f 43 4f 4e 46 49 47 5f 57 49 4e 33 32 5f 48 E_CONFIG_WIN32_H
5b60: 45 41 50 53 49 5a 45 20 74 61 6b 65 73 20 61 20 EAPSIZE takes a
5b70: 33 32 2d 62 69 74 0a 20 20 20 20 20 20 2a 2a 20 32-bit. **
5b80: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
5b90: 20 76 61 6c 75 65 20 74 68 61 74 20 73 70 65 63 value that spec
5ba0: 69 66 69 65 73 20 74 68 65 20 6d 61 78 69 6d 75 ifies the maximu
5bb0: 6d 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63 72 m size of the cr
5bc0: 65 61 74 65 64 0a 20 20 20 20 20 20 2a 2a 20 68 eated. ** h
5bd0: 65 61 70 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 eap. */. sq
5be0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
5bf0: 67 2e 6e 48 65 61 70 20 3d 20 76 61 5f 61 72 67 g.nHeap = va_arg
5c00: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
5c10: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 break;. }.#e
5c20: 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 20 53 ndif.. case S
5c30: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 4d 41 QLITE_CONFIG_PMA
5c40: 53 5a 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 SZ: {. sqli
5c50: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
5c60: 73 7a 50 6d 61 20 3d 20 76 61 5f 61 72 67 28 61 szPma = va_arg(a
5c70: 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 p, unsigned int)
5c80: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
5c90: 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 53 }.. case S
5ca0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 54 4d QLITE_CONFIG_STM
5cb0: 54 4a 52 4e 4c 5f 53 50 49 4c 4c 3a 20 7b 0a 20 TJRNL_SPILL: {.
5cc0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
5cd0: 61 6c 43 6f 6e 66 69 67 2e 6e 53 74 6d 74 53 70 alConfig.nStmtSp
5ce0: 69 6c 6c 20 3d 20 76 61 5f 61 72 67 28 61 70 2c ill = va_arg(ap,
5cf0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 int);. bre
5d00: 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 64 ak;. }.. d
5d10: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 efault: {.
5d20: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
5d30: 52 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a R;. break;.
5d40: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 }. }. va_e
5d50: 6e 64 28 61 70 29 3b 0a 20 20 72 65 74 75 72 6e nd(ap);. return
5d60: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 rc;.}../*.** Se
5d70: 74 20 75 70 20 74 68 65 20 6c 6f 6f 6b 61 73 69 t up the lookasi
5d80: 64 65 20 62 75 66 66 65 72 73 20 66 6f 72 20 61 de buffers for a
5d90: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
5da0: 74 69 6f 6e 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 tion..** Return
5db0: 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 SQLITE_OK on suc
5dc0: 63 65 73 73 2e 20 20 0a 2a 2a 20 49 66 20 6c 6f cess. .** If lo
5dd0: 6f 6b 61 73 69 64 65 20 69 73 20 61 6c 72 65 61 okaside is alrea
5de0: 64 79 20 61 63 74 69 76 65 2c 20 72 65 74 75 72 dy active, retur
5df0: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 0a 2a n SQLITE_BUSY..*
5e00: 2a 0a 2a 2a 20 54 68 65 20 73 7a 20 70 61 72 61 *.** The sz para
5e10: 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e 75 6d meter is the num
5e20: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
5e30: 65 61 63 68 20 6c 6f 6f 6b 61 73 69 64 65 20 73 each lookaside s
5e40: 6c 6f 74 2e 0a 2a 2a 20 54 68 65 20 63 6e 74 20 lot..** The cnt
5e50: 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 68 65 parameter is the
5e60: 20 6e 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 number of slots
5e70: 2e 20 20 49 66 20 70 53 74 61 72 74 20 69 73 20 . If pStart is
5e80: 4e 55 4c 4c 20 74 68 65 0a 2a 2a 20 73 70 61 63 NULL the.** spac
5e90: 65 20 66 6f 72 20 74 68 65 20 6c 6f 6f 6b 61 73 e for the lookas
5ea0: 69 64 65 20 6d 65 6d 6f 72 79 20 69 73 20 6f 62 ide memory is ob
5eb0: 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 tained from sqli
5ec0: 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a te3_malloc()..**
5ed0: 20 49 66 20 70 53 74 61 72 74 20 69 73 20 6e 6f If pStart is no
5ee0: 74 20 4e 55 4c 4c 20 74 68 65 6e 20 69 74 20 69 t NULL then it i
5ef0: 73 20 73 7a 2a 63 6e 74 20 62 79 74 65 73 20 6f s sz*cnt bytes o
5f00: 66 20 6d 65 6d 6f 72 79 20 74 6f 20 75 73 65 20 f memory to use
5f10: 66 6f 72 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 for.** the looka
5f20: 73 69 64 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a side memory..*/.
5f30: 73 74 61 74 69 63 20 69 6e 74 20 73 65 74 75 70 static int setup
5f40: 4c 6f 6f 6b 61 73 69 64 65 28 73 71 6c 69 74 65 Lookaside(sqlite
5f50: 33 20 2a 64 62 2c 20 76 6f 69 64 20 2a 70 42 75 3 *db, void *pBu
5f60: 66 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 63 f, int sz, int c
5f70: 6e 74 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c nt){.#ifndef SQL
5f80: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49 ITE_OMIT_LOOKASI
5f90: 44 45 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 72 DE. void *pStar
5fa0: 74 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f t;. if( db->loo
5fb0: 6b 61 73 69 64 65 2e 6e 4f 75 74 20 29 7b 0a 20 kaside.nOut ){.
5fc0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
5fd0: 5f 42 55 53 59 3b 0a 20 20 7d 0a 20 20 2f 2a 20 _BUSY;. }. /*
5fe0: 46 72 65 65 20 61 6e 79 20 65 78 69 73 74 69 6e Free any existin
5ff0: 67 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 g lookaside buff
6000: 65 72 20 66 6f 72 20 74 68 69 73 20 68 61 6e 64 er for this hand
6010: 6c 65 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 le before. ** a
6020: 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 llocating a new
6030: 6f 6e 65 20 73 6f 20 77 65 20 64 6f 6e 27 74 20 one so we don't
6040: 68 61 76 65 20 74 6f 20 68 61 76 65 20 73 70 61 have to have spa
6050: 63 65 20 66 6f 72 20 0a 20 20 2a 2a 20 62 6f 74 ce for . ** bot
6060: 68 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 h at the same ti
6070: 6d 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 me.. */. if( d
6080: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 b->lookaside.bMa
6090: 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 lloced ){. sq
60a0: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c lite3_free(db->l
60b0: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 ookaside.pStart)
60c0: 3b 0a 20 20 7d 0a 20 20 2f 2a 20 54 68 65 20 73 ;. }. /* The s
60d0: 69 7a 65 20 6f 66 20 61 20 6c 6f 6f 6b 61 73 69 ize of a lookasi
60e0: 64 65 20 73 6c 6f 74 20 61 66 74 65 72 20 52 4f de slot after RO
60f0: 55 4e 44 44 4f 57 4e 38 20 6e 65 65 64 73 20 74 UNDDOWN8 needs t
6100: 6f 20 62 65 20 6c 61 72 67 65 72 0a 20 20 2a 2a o be larger. **
6110: 20 74 68 61 6e 20 61 20 70 6f 69 6e 74 65 72 20 than a pointer
6120: 74 6f 20 62 65 20 75 73 65 66 75 6c 2e 0a 20 20 to be useful..
6130: 2a 2f 0a 20 20 73 7a 20 3d 20 52 4f 55 4e 44 44 */. sz = ROUNDD
6140: 4f 57 4e 38 28 73 7a 29 3b 20 20 2f 2a 20 49 4d OWN8(sz); /* IM
6150: 50 3a 20 52 2d 33 33 30 33 38 2d 30 39 33 38 32 P: R-33038-09382
6160: 20 2a 2f 0a 20 20 69 66 28 20 73 7a 3c 3d 28 69 */. if( sz<=(i
6170: 6e 74 29 73 69 7a 65 6f 66 28 4c 6f 6f 6b 61 73 nt)sizeof(Lookas
6180: 69 64 65 53 6c 6f 74 2a 29 20 29 20 73 7a 20 3d ideSlot*) ) sz =
6190: 20 30 3b 0a 20 20 69 66 28 20 63 6e 74 3c 30 20 0;. if( cnt<0
61a0: 29 20 63 6e 74 20 3d 20 30 3b 0a 20 20 69 66 28 ) cnt = 0;. if(
61b0: 20 73 7a 3d 3d 30 20 7c 7c 20 63 6e 74 3d 3d 30 sz==0 || cnt==0
61c0: 20 29 7b 0a 20 20 20 20 73 7a 20 3d 20 30 3b 0a ){. sz = 0;.
61d0: 20 20 20 20 70 53 74 61 72 74 20 3d 20 30 3b 0a pStart = 0;.
61e0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 42 75 66 }else if( pBuf
61f0: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ==0 ){. sqlit
6200: 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c e3BeginBenignMal
6210: 6c 6f 63 28 29 3b 0a 20 20 20 20 70 53 74 61 72 loc();. pStar
6220: 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f t = sqlite3Mallo
6230: 63 28 20 73 7a 2a 63 6e 74 20 29 3b 20 20 2f 2a c( sz*cnt ); /*
6240: 20 49 4d 50 3a 20 52 2d 36 31 39 34 39 2d 33 35 IMP: R-61949-35
6250: 37 32 37 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 727 */. sqlit
6260: 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f e3EndBenignMallo
6270: 63 28 29 3b 0a 20 20 20 20 69 66 28 20 70 53 74 c();. if( pSt
6280: 61 72 74 20 29 20 63 6e 74 20 3d 20 73 71 6c 69 art ) cnt = sqli
6290: 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 53 te3MallocSize(pS
62a0: 74 61 72 74 29 2f 73 7a 3b 0a 20 20 7d 65 6c 73 tart)/sz;. }els
62b0: 65 7b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 e{. pStart =
62c0: 70 42 75 66 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e pBuf;. }. db->
62d0: 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 lookaside.pStart
62e0: 20 3d 20 70 53 74 61 72 74 3b 0a 20 20 64 62 2d = pStart;. db-
62f0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 >lookaside.pFree
6300: 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c 6f 6f 6b = 0;. db->look
6310: 61 73 69 64 65 2e 73 7a 20 3d 20 28 75 31 36 29 aside.sz = (u16)
6320: 73 7a 3b 0a 20 20 69 66 28 20 70 53 74 61 72 74 sz;. if( pStart
6330: 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
6340: 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 LookasideSlot
6350: 20 2a 70 3b 0a 20 20 20 20 61 73 73 65 72 74 28 *p;. assert(
6360: 20 73 7a 20 3e 20 28 69 6e 74 29 73 69 7a 65 6f sz > (int)sizeo
6370: 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a f(LookasideSlot*
6380: 29 20 29 3b 0a 20 20 20 20 70 20 3d 20 28 4c 6f ) );. p = (Lo
6390: 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 70 53 74 okasideSlot*)pSt
63a0: 61 72 74 3b 0a 20 20 20 20 66 6f 72 28 69 3d 63 art;. for(i=c
63b0: 6e 74 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 nt-1; i>=0; i--)
63c0: 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 {. p->pNext
63d0: 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 = db->lookaside
63e0: 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 20 64 62 .pFree;. db
63f0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 ->lookaside.pFre
6400: 65 20 3d 20 70 3b 0a 20 20 20 20 20 20 70 20 3d e = p;. p =
6410: 20 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a (LookasideSlot*
6420: 29 26 28 28 75 38 2a 29 70 29 5b 73 7a 5d 3b 0a )&((u8*)p)[sz];.
6430: 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e 6c 6f }. db->lo
6440: 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 70 okaside.pEnd = p
6450: 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ;. db->lookas
6460: 69 64 65 2e 62 44 69 73 61 62 6c 65 20 3d 20 30 ide.bDisable = 0
6470: 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ;. db->lookas
6480: 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 ide.bMalloced =
6490: 70 42 75 66 3d 3d 30 20 3f 31 3a 30 3b 0a 20 20 pBuf==0 ?1:0;.
64a0: 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 6c }else{. db->l
64b0: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 20 ookaside.pStart
64c0: 3d 20 64 62 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f = db;. db->lo
64d0: 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 64 okaside.pEnd = d
64e0: 62 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 b;. db->looka
64f0: 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20 3d 20 side.bDisable =
6500: 31 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 1;. db->looka
6510: 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d side.bMalloced =
6520: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 0;. }.#endif /
6530: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f * SQLITE_OMIT_LO
6540: 4f 4b 41 53 49 44 45 20 2a 2f 0a 20 20 72 65 74 OKASIDE */. ret
6550: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
6560: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
6570: 68 65 20 6d 75 74 65 78 20 61 73 73 6f 63 69 61 he mutex associa
6580: 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61 62 ted with a datab
6590: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ase connection..
65a0: 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 */.sqlite3_mutex
65b0: 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 6d 75 74 *sqlite3_db_mut
65c0: 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b ex(sqlite3 *db){
65d0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
65e0: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
65f0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
6600: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
6610: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
6620: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
6630: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
6640: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 }.#endif. retu
6650: 72 6e 20 64 62 2d 3e 6d 75 74 65 78 3b 0a 7d 0a rn db->mutex;.}.
6660: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 75 70 20 61 ./*.** Free up a
6670: 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73 s much memory as
6680: 20 77 65 20 63 61 6e 20 66 72 6f 6d 20 74 68 65 we can from the
6690: 20 67 69 76 65 6e 20 64 61 74 61 62 61 73 65 0a given database.
66a0: 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a ** connection..*
66b0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 /.int sqlite3_db
66c0: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 _release_memory(
66d0: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 sqlite3 *db){.
66e0: 69 6e 74 20 69 3b 0a 0a 23 69 66 64 65 66 20 53 int i;..#ifdef S
66f0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
6700: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
6710: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
6720: 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 Ok(db) ) return
6730: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
6740: 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c PT;.#endif. sql
6750: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
6760: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 (db->mutex);. s
6770: 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
6780: 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 69 All(db);. for(i
6790: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 =0; i<db->nDb; i
67a0: 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 20 2a ++){. Btree *
67b0: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d pBt = db->aDb[i]
67c0: 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 .pBt;. if( pB
67d0: 74 20 29 7b 0a 20 20 20 20 20 20 50 61 67 65 72 t ){. Pager
67e0: 20 2a 70 50 61 67 65 72 20 3d 20 73 71 6c 69 74 *pPager = sqlit
67f0: 65 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 e3BtreePager(pBt
6800: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
6810: 50 61 67 65 72 53 68 72 69 6e 6b 28 70 50 61 67 PagerShrink(pPag
6820: 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 er);. }. }.
6830: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
6840: 76 65 41 6c 6c 28 64 62 29 3b 0a 20 20 73 71 6c veAll(db);. sql
6850: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
6860: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
6870: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6880: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 6c 75 73 68 20 .}../*.** Flush
6890: 61 6e 79 20 64 69 72 74 79 20 70 61 67 65 73 20 any dirty pages
68a0: 69 6e 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 in the pager-cac
68b0: 68 65 20 66 6f 72 20 61 6e 79 20 61 74 74 61 63 he for any attac
68c0: 68 65 64 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 hed database.**
68d0: 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e 74 20 to disk..*/.int
68e0: 73 71 6c 69 74 65 33 5f 64 62 5f 63 61 63 68 65 sqlite3_db_cache
68f0: 66 6c 75 73 68 28 73 71 6c 69 74 65 33 20 2a 64 flush(sqlite3 *d
6900: 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 b){. int i;. i
6910: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
6920: 4b 3b 0a 20 20 69 6e 74 20 62 53 65 65 6e 42 75 K;. int bSeenBu
6930: 73 79 20 3d 20 30 3b 0a 0a 23 69 66 64 65 66 20 sy = 0;..#ifdef
6940: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
6950: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
6960: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
6970: 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e kOk(db) ) return
6980: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
6990: 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 KPT;.#endif. sq
69a0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
69b0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
69c0: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
69d0: 72 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 rAll(db);. for(
69e0: 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f i=0; rc==SQLITE_
69f0: 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b OK && i<db->nDb;
6a00: 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 i++){. Btree
6a10: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b *pBt = db->aDb[
6a20: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 i].pBt;. if(
6a30: 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 pBt && sqlite3Bt
6a40: 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 reeIsInTrans(pBt
6a50: 29 20 29 7b 0a 20 20 20 20 20 20 50 61 67 65 72 ) ){. Pager
6a60: 20 2a 70 50 61 67 65 72 20 3d 20 73 71 6c 69 74 *pPager = sqlit
6a70: 65 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 e3BtreePager(pBt
6a80: 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
6a90: 6c 69 74 65 33 50 61 67 65 72 46 6c 75 73 68 28 lite3PagerFlush(
6aa0: 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 69 pPager);. i
6ab0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 f( rc==SQLITE_BU
6ac0: 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 62 53 SY ){. bS
6ad0: 65 65 6e 42 75 73 79 20 3d 20 31 3b 0a 20 20 20 eenBusy = 1;.
6ae0: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
6af0: 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 _OK;. }.
6b00: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 }. }. sqlite3
6b10: 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 BtreeLeaveAll(db
6b20: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 );. sqlite3_mut
6b30: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
6b40: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 28 ex);. return ((
6b50: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
6b60: 20 62 53 65 65 6e 42 75 73 79 29 20 3f 20 53 51 bSeenBusy) ? SQ
6b70: 4c 49 54 45 5f 42 55 53 59 20 3a 20 72 63 29 3b LITE_BUSY : rc);
6b80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 .}../*.** Config
6b90: 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67 73 uration settings
6ba0: 20 66 6f 72 20 61 6e 20 69 6e 64 69 76 69 64 75 for an individu
6bb0: 61 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e al database conn
6bc0: 65 63 74 69 6f 6e 0a 2a 2f 0a 69 6e 74 20 73 71 ection.*/.int sq
6bd0: 6c 69 74 65 33 5f 64 62 5f 63 6f 6e 66 69 67 28 lite3_db_config(
6be0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
6bf0: 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f op, ...){. va_
6c00: 6c 69 73 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 list ap;. int r
6c10: 63 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 c;. va_start(ap
6c20: 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 28 , op);. switch(
6c30: 20 6f 70 20 29 7b 0a 20 20 20 20 63 61 73 65 20 op ){. case
6c40: 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f SQLITE_DBCONFIG_
6c50: 4d 41 49 4e 44 42 4e 41 4d 45 3a 20 7b 0a 20 20 MAINDBNAME: {.
6c60: 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 36 /* IMP: R-06
6c70: 38 32 34 2d 32 38 35 33 31 20 2a 2f 0a 20 20 20 824-28531 */.
6c80: 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 33 36 32 /* IMP: R-362
6c90: 35 37 2d 35 32 31 32 35 20 2a 2f 0a 20 20 20 20 57-52125 */.
6ca0: 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a 44 62 db->aDb[0].zDb
6cb0: 53 4e 61 6d 65 20 3d 20 76 61 5f 61 72 67 28 61 SName = va_arg(a
6cc0: 70 2c 63 68 61 72 2a 29 3b 0a 20 20 20 20 20 20 p,char*);.
6cd0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
6ce0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
6cf0: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
6d00: 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b TE_DBCONFIG_LOOK
6d10: 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 76 ASIDE: {. v
6d20: 6f 69 64 20 2a 70 42 75 66 20 3d 20 76 61 5f 61 oid *pBuf = va_a
6d30: 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 20 2f rg(ap, void*); /
6d40: 2a 20 49 4d 50 3a 20 52 2d 32 36 38 33 35 2d 31 * IMP: R-26835-1
6d50: 30 39 36 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 0964 */. in
6d60: 74 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 t sz = va_arg(ap
6d70: 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 20 2f 2a , int); /*
6d80: 20 49 4d 50 3a 20 52 2d 34 37 38 37 31 2d 32 35 IMP: R-47871-25
6d90: 39 39 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 994 */. int
6da0: 20 63 6e 74 20 3d 20 76 61 5f 61 72 67 28 61 70 cnt = va_arg(ap
6db0: 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 2f 2a 20 , int); /*
6dc0: 49 4d 50 3a 20 52 2d 30 34 34 36 30 2d 35 33 33 IMP: R-04460-533
6dd0: 38 36 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 86 */. rc =
6de0: 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 65 28 setupLookaside(
6df0: 64 62 2c 20 70 42 75 66 2c 20 73 7a 2c 20 63 6e db, pBuf, sz, cn
6e00: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
6e10: 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 . }. defau
6e20: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 73 74 61 74 lt: {. stat
6e30: 69 63 20 63 6f 6e 73 74 20 73 74 72 75 63 74 20 ic const struct
6e40: 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6f 70 {. int op
6e50: 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 70 ; /* The op
6e60: 63 6f 64 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 code */.
6e70: 75 33 32 20 6d 61 73 6b 3b 20 20 20 20 2f 2a 20 u32 mask; /*
6e80: 4d 61 73 6b 20 6f 66 20 74 68 65 20 62 69 74 20 Mask of the bit
6e90: 69 6e 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 73 in sqlite3.flags
6ea0: 20 74 6f 20 73 65 74 2f 63 6c 65 61 72 20 2a 2f to set/clear */
6eb0: 0a 20 20 20 20 20 20 7d 20 61 46 6c 61 67 4f 70 . } aFlagOp
6ec0: 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 7b [] = {. {
6ed0: 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 SQLITE_DBCONFIG
6ee0: 5f 45 4e 41 42 4c 45 5f 46 4b 45 59 2c 20 20 20 _ENABLE_FKEY,
6ef0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 46 SQLITE_F
6f00: 6f 72 65 69 67 6e 4b 65 79 73 20 20 20 20 7d 2c oreignKeys },
6f10: 0a 20 20 20 20 20 20 20 20 7b 20 53 51 4c 49 54 . { SQLIT
6f20: 45 5f 44 42 43 4f 4e 46 49 47 5f 45 4e 41 42 4c E_DBCONFIG_ENABL
6f30: 45 5f 54 52 49 47 47 45 52 2c 20 20 20 20 20 20 E_TRIGGER,
6f40: 20 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 SQLITE_EnableT
6f50: 72 69 67 67 65 72 20 20 7d 2c 0a 20 20 20 20 20 rigger },.
6f60: 20 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f { SQLITE_DBCO
6f70: 4e 46 49 47 5f 45 4e 41 42 4c 45 5f 46 54 53 33 NFIG_ENABLE_FTS3
6f80: 5f 54 4f 4b 45 4e 49 5a 45 52 2c 20 53 51 4c 49 _TOKENIZER, SQLI
6f90: 54 45 5f 46 74 73 33 54 6f 6b 65 6e 69 7a 65 72 TE_Fts3Tokenizer
6fa0: 20 20 7d 2c 0a 20 20 20 20 20 20 20 20 7b 20 53 },. { S
6fb0: 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 45 QLITE_DBCONFIG_E
6fc0: 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 4e NABLE_LOAD_EXTEN
6fd0: 53 49 4f 4e 2c 20 53 51 4c 49 54 45 5f 4c 6f 61 SION, SQLITE_Loa
6fe0: 64 45 78 74 65 6e 73 69 6f 6e 20 20 7d 2c 0a 20 dExtension },.
6ff0: 20 20 20 20 20 20 20 7b 20 53 51 4c 49 54 45 5f { SQLITE_
7000: 44 42 43 4f 4e 46 49 47 5f 4e 4f 5f 43 4b 50 54 DBCONFIG_NO_CKPT
7010: 5f 4f 4e 5f 43 4c 4f 53 45 2c 20 20 20 20 20 20 _ON_CLOSE,
7020: 53 51 4c 49 54 45 5f 4e 6f 43 6b 70 74 4f 6e 43 SQLITE_NoCkptOnC
7030: 6c 6f 73 65 20 20 7d 2c 0a 20 20 20 20 20 20 20 lose },.
7040: 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 { SQLITE_DBCONF
7050: 49 47 5f 45 4e 41 42 4c 45 5f 51 50 53 47 2c 20 IG_ENABLE_QPSG,
7060: 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
7070: 5f 45 6e 61 62 6c 65 51 50 53 47 20 20 20 20 20 _EnableQPSG
7080: 7d 2c 0a 20 20 20 20 20 20 7d 3b 0a 20 20 20 20 },. };.
7090: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69 unsigned int i
70a0: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c ;. rc = SQL
70b0: 49 54 45 5f 45 52 52 4f 52 3b 20 2f 2a 20 49 4d ITE_ERROR; /* IM
70c0: 50 3a 20 52 2d 34 32 37 39 30 2d 32 33 33 37 32 P: R-42790-23372
70d0: 20 2a 2f 0a 20 20 20 20 20 20 66 6f 72 28 69 3d */. for(i=
70e0: 30 3b 20 69 3c 41 72 72 61 79 53 69 7a 65 28 61 0; i<ArraySize(a
70f0: 46 6c 61 67 4f 70 29 3b 20 69 2b 2b 29 7b 0a 20 FlagOp); i++){.
7100: 20 20 20 20 20 20 20 69 66 28 20 61 46 6c 61 67 if( aFlag
7110: 4f 70 5b 69 5d 2e 6f 70 3d 3d 6f 70 20 29 7b 0a Op[i].op==op ){.
7120: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6f 6e int on
7130: 6f 66 66 20 3d 20 76 61 5f 61 72 67 28 61 70 2c off = va_arg(ap,
7140: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 20 int);.
7150: 20 69 6e 74 20 2a 70 52 65 73 20 3d 20 76 61 5f int *pRes = va_
7160: 61 72 67 28 61 70 2c 20 69 6e 74 2a 29 3b 0a 20 arg(ap, int*);.
7170: 20 20 20 20 20 20 20 20 20 69 6e 74 20 6f 6c 64 int old
7180: 46 6c 61 67 73 20 3d 20 64 62 2d 3e 66 6c 61 67 Flags = db->flag
7190: 73 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 s;. if(
71a0: 20 6f 6e 6f 66 66 3e 30 20 29 7b 0a 20 20 20 20 onoff>0 ){.
71b0: 20 20 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 db->flag
71c0: 73 20 7c 3d 20 61 46 6c 61 67 4f 70 5b 69 5d 2e s |= aFlagOp[i].
71d0: 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 mask;.
71e0: 7d 65 6c 73 65 20 69 66 28 20 6f 6e 6f 66 66 3d }else if( onoff=
71f0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
7200: 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e db->flags &= ~
7210: 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 3b aFlagOp[i].mask;
7220: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
7230: 20 20 20 20 20 20 20 69 66 28 20 6f 6c 64 46 6c if( oldFl
7240: 61 67 73 21 3d 64 62 2d 3e 66 6c 61 67 73 20 29 ags!=db->flags )
7250: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 {. sq
7260: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 lite3ExpirePrepa
7270: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 redStatements(db
7280: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
7290: 20 20 20 20 20 20 20 20 20 69 66 28 20 70 52 65 if( pRe
72a0: 73 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 s ){.
72b0: 20 2a 70 52 65 73 20 3d 20 28 64 62 2d 3e 66 6c *pRes = (db->fl
72c0: 61 67 73 20 26 20 61 46 6c 61 67 4f 70 5b 69 5d ags & aFlagOp[i]
72d0: 2e 6d 61 73 6b 29 21 3d 30 3b 0a 20 20 20 20 20 .mask)!=0;.
72e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
72f0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
7300: 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b . break
7310: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
7320: 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b }. break;
7330: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f . }. }. va_
7340: 65 6e 64 28 61 70 29 3b 0a 20 20 72 65 74 75 72 end(ap);. retur
7350: 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 n rc;.}.../*.**
7360: 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 Return true if t
7370: 68 65 20 62 75 66 66 65 72 20 7a 5b 30 2e 2e 6e he buffer z[0..n
7380: 2d 31 5d 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c -1] contains all
7390: 20 73 70 61 63 65 73 2e 0a 2a 2f 0a 73 74 61 74 spaces..*/.stat
73a0: 69 63 20 69 6e 74 20 61 6c 6c 53 70 61 63 65 73 ic int allSpaces
73b0: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 (const char *z,
73c0: 69 6e 74 20 6e 29 7b 0a 20 20 77 68 69 6c 65 28 int n){. while(
73d0: 20 6e 3e 30 20 26 26 20 7a 5b 6e 2d 31 5d 3d 3d n>0 && z[n-1]==
73e0: 27 20 27 20 29 7b 20 6e 2d 2d 3b 20 7d 0a 20 20 ' ' ){ n--; }.
73f0: 72 65 74 75 72 6e 20 6e 3d 3d 30 3b 0a 7d 0a 0a return n==0;.}..
7400: 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68 /*.** This is th
7410: 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 e default collat
7420: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d ing function nam
7430: 65 64 20 22 42 49 4e 41 52 59 22 20 77 68 69 63 ed "BINARY" whic
7440: 68 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 h is always.** a
7450: 76 61 69 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 vailable..**.**
7460: 49 66 20 74 68 65 20 70 61 64 46 6c 61 67 20 61 If the padFlag a
7470: 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 74 20 4e rgument is not N
7480: 55 4c 4c 20 74 68 65 6e 20 73 70 61 63 65 20 70 ULL then space p
7490: 61 64 64 69 6e 67 20 61 74 20 74 68 65 20 65 6e adding at the en
74a0: 64 0a 2a 2a 20 6f 66 20 73 74 72 69 6e 67 73 20 d.** of strings
74b0: 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 54 68 69 is ignored. Thi
74c0: 73 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 s implements the
74d0: 20 52 54 52 49 4d 20 63 6f 6c 6c 61 74 69 6f 6e RTRIM collation
74e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
74f0: 62 69 6e 43 6f 6c 6c 46 75 6e 63 28 0a 20 20 76 binCollFunc(. v
7500: 6f 69 64 20 2a 70 61 64 46 6c 61 67 2c 0a 20 20 oid *padFlag,.
7510: 69 6e 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 int nKey1, const
7520: 20 76 6f 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 void *pKey1,.
7530: 69 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 int nKey2, const
7540: 20 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a void *pKey2.){.
7550: 20 20 69 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e int rc, n;. n
7560: 20 3d 20 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f = nKey1<nKey2 ?
7570: 20 6e 4b 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a nKey1 : nKey2;.
7580: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
7590: 3a 20 52 2d 36 35 30 33 33 2d 32 38 34 34 39 20 : R-65033-28449
75a0: 54 68 65 20 62 75 69 6c 74 2d 69 6e 20 42 49 4e The built-in BIN
75b0: 41 52 59 20 63 6f 6c 6c 61 74 69 6f 6e 20 63 6f ARY collation co
75c0: 6d 70 61 72 65 73 0a 20 20 2a 2a 20 73 74 72 69 mpares. ** stri
75d0: 6e 67 73 20 62 79 74 65 20 62 79 20 62 79 74 65 ngs byte by byte
75e0: 20 75 73 69 6e 67 20 74 68 65 20 6d 65 6d 63 6d using the memcm
75f0: 70 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f p() function fro
7600: 6d 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 43 m the standard C
7610: 0a 20 20 2a 2a 20 6c 69 62 72 61 72 79 2e 20 2a . ** library. *
7620: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 4b 65 79 /. assert( pKey
7630: 31 20 26 26 20 70 4b 65 79 32 20 29 3b 0a 20 20 1 && pKey2 );.
7640: 72 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 rc = memcmp(pKey
7650: 31 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 1, pKey2, n);.
7660: 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 if( rc==0 ){.
7670: 20 69 66 28 20 70 61 64 46 6c 61 67 0a 20 20 20 if( padFlag.
7680: 20 20 26 26 20 61 6c 6c 53 70 61 63 65 73 28 28 && allSpaces((
7690: 28 63 68 61 72 2a 29 70 4b 65 79 31 29 2b 6e 2c (char*)pKey1)+n,
76a0: 20 6e 4b 65 79 31 2d 6e 29 0a 20 20 20 20 20 26 nKey1-n). &
76b0: 26 20 61 6c 6c 53 70 61 63 65 73 28 28 28 63 68 & allSpaces(((ch
76c0: 61 72 2a 29 70 4b 65 79 32 29 2b 6e 2c 20 6e 4b ar*)pKey2)+n, nK
76d0: 65 79 32 2d 6e 29 0a 20 20 20 20 29 7b 0a 20 20 ey2-n). ){.
76e0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
76f0: 4f 46 3a 20 52 2d 33 31 36 32 34 2d 32 34 37 33 OF: R-31624-2473
7700: 37 20 52 54 52 49 4d 20 69 73 20 6c 69 6b 65 20 7 RTRIM is like
7710: 42 49 4e 41 52 59 20 65 78 63 65 70 74 20 74 68 BINARY except th
7720: 61 74 20 65 78 74 72 61 0a 20 20 20 20 20 20 2a at extra. *
7730: 2a 20 73 70 61 63 65 73 20 61 74 20 74 68 65 20 * spaces at the
7740: 65 6e 64 20 6f 66 20 65 69 74 68 65 72 20 73 74 end of either st
7750: 72 69 6e 67 20 64 6f 20 6e 6f 74 20 63 68 61 6e ring do not chan
7760: 67 65 20 74 68 65 20 72 65 73 75 6c 74 2e 20 49 ge the result. I
7770: 6e 20 6f 74 68 65 72 0a 20 20 20 20 20 20 2a 2a n other. **
7780: 20 77 6f 72 64 73 2c 20 73 74 72 69 6e 67 73 20 words, strings
7790: 77 69 6c 6c 20 63 6f 6d 70 61 72 65 20 65 71 75 will compare equ
77a0: 61 6c 20 74 6f 20 6f 6e 65 20 61 6e 6f 74 68 65 al to one anothe
77b0: 72 20 61 73 20 6c 6f 6e 67 20 61 73 20 74 68 65 r as long as the
77c0: 79 0a 20 20 20 20 20 20 2a 2a 20 64 69 66 66 65 y. ** diffe
77d0: 72 20 6f 6e 6c 79 20 69 6e 20 74 68 65 20 6e 75 r only in the nu
77e0: 6d 62 65 72 20 6f 66 20 73 70 61 63 65 73 20 61 mber of spaces a
77f0: 74 20 74 68 65 20 65 6e 64 2e 0a 20 20 20 20 20 t the end..
7800: 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 */. }else{.
7810: 20 20 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 rc = nKey1
7820: 2d 20 6e 4b 65 79 32 3b 0a 20 20 20 20 7d 0a 20 - nKey2;. }.
7830: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
7840: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6e 6f 74 68 65 72 }../*.** Another
7850: 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 built-in collat
7860: 69 6e 67 20 73 65 71 75 65 6e 63 65 3a 20 4e 4f ing sequence: NO
7870: 43 41 53 45 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 CASE. .**.** Thi
7880: 73 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 s collating sequ
7890: 65 6e 63 65 20 69 73 20 69 6e 74 65 6e 64 65 64 ence is intended
78a0: 20 74 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 to be used for
78b0: 22 63 61 73 65 20 69 6e 64 65 70 65 6e 64 65 6e "case independen
78c0: 74 0a 2a 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 22 t.** comparison"
78d0: 2e 20 53 51 4c 69 74 65 27 73 20 6b 6e 6f 77 6c . SQLite's knowl
78e0: 65 64 67 65 20 6f 66 20 75 70 70 65 72 20 61 6e edge of upper an
78f0: 64 20 6c 6f 77 65 72 20 63 61 73 65 20 65 71 75 d lower case equ
7900: 69 76 61 6c 65 6e 74 73 0a 2a 2a 20 65 78 74 65 ivalents.** exte
7910: 6e 64 73 20 6f 6e 6c 79 20 74 6f 20 74 68 65 20 nds only to the
7920: 32 36 20 63 68 61 72 61 63 74 65 72 73 20 75 73 26 characters us
7930: 65 64 20 69 6e 20 74 68 65 20 45 6e 67 6c 69 73 ed in the Englis
7940: 68 20 6c 61 6e 67 75 61 67 65 2e 0a 2a 2a 0a 2a h language..**.*
7950: 2a 20 41 74 20 74 68 65 20 6d 6f 6d 65 6e 74 20 * At the moment
7960: 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 there is only a
7970: 55 54 46 2d 38 20 69 6d 70 6c 65 6d 65 6e 74 61 UTF-8 implementa
7980: 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tion..*/.static
7990: 69 6e 74 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 int nocaseCollat
79a0: 69 6e 67 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 ingFunc(. void
79b0: 2a 4e 6f 74 55 73 65 64 2c 0a 20 20 69 6e 74 20 *NotUsed,. int
79c0: 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 nKey1, const voi
79d0: 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 d *pKey1,. int
79e0: 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 nKey2, const voi
79f0: 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e d *pKey2.){. in
7a00: 74 20 72 20 3d 20 73 71 6c 69 74 65 33 53 74 72 t r = sqlite3Str
7a10: 4e 49 43 6d 70 28 0a 20 20 20 20 20 20 28 63 6f NICmp(. (co
7a20: 6e 73 74 20 63 68 61 72 20 2a 29 70 4b 65 79 31 nst char *)pKey1
7a30: 2c 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 , (const char *)
7a40: 70 4b 65 79 32 2c 20 28 6e 4b 65 79 31 3c 6e 4b pKey2, (nKey1<nK
7a50: 65 79 32 29 3f 6e 4b 65 79 31 3a 6e 4b 65 79 32 ey2)?nKey1:nKey2
7a60: 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 );. UNUSED_PARA
7a70: 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a METER(NotUsed);.
7a80: 20 20 69 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 if( 0==r ){.
7a90: 20 20 72 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 r = nKey1-nKey
7aa0: 32 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 2;. }. return
7ab0: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 r;.}../*.** Retu
7ac0: 72 6e 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20 rn the ROWID of
7ad0: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 the most recent
7ae0: 69 6e 73 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 insert.*/.sqlite
7af0: 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6c _int64 sqlite3_l
7b00: 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 ast_insert_rowid
7b10: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 (sqlite3 *db){.#
7b20: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
7b30: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
7b40: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
7b50: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
7b60: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 . (void)SQLIT
7b70: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
7b80: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d return 0;. }
7b90: 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e .#endif. return
7ba0: 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a db->lastRowid;.
7bb0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 }../*.** Set the
7bc0: 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 value returned
7bd0: 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6c by the sqlite3_l
7be0: 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 ast_insert_rowid
7bf0: 28 29 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e () API function.
7c00: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
7c10: 5f 73 65 74 5f 6c 61 73 74 5f 69 6e 73 65 72 74 _set_last_insert
7c20: 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 33 20 2a _rowid(sqlite3 *
7c30: 64 62 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 db, sqlite3_int6
7c40: 34 20 69 52 6f 77 69 64 29 7b 0a 23 69 66 64 65 4 iRowid){.#ifde
7c50: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
7c60: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
7c70: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
7c80: 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
7c90: 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 (void)SQLITE_MI
7ca0: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 SUSE_BKPT;. r
7cb0: 65 74 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 eturn;. }.#endi
7cc0: 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
7cd0: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
7ce0: 78 29 3b 0a 20 20 64 62 2d 3e 6c 61 73 74 52 6f x);. db->lastRo
7cf0: 77 69 64 20 3d 20 69 52 6f 77 69 64 3b 0a 20 20 wid = iRowid;.
7d00: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
7d10: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
7d20: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
7d30: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 the number of ch
7d40: 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 anges in the mos
7d50: 74 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f t recent call to
7d60: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e sqlite3_exec().
7d70: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
7d80: 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 changes(sqlite3
7d90: 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *db){.#ifdef SQL
7da0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
7db0: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
7dc0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
7dd0: 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
7de0: 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
7df0: 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
7e00: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
7e10: 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 43 68 61 return db->nCha
7e20: 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 nge;.}../*.** Re
7e30: 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 turn the number
7e40: 6f 66 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 of changes since
7e50: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
7e60: 6e 64 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 2e ndle was opened.
7e70: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
7e80: 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 28 73 71 total_changes(sq
7e90: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 lite3 *db){.#ifd
7ea0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
7eb0: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
7ec0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
7ed0: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
7ee0: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
7ef0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
7f00: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 return 0;. }.#e
7f10: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 64 62 ndif. return db
7f20: 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a ->nTotalChange;.
7f30: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 }../*.** Close a
7f40: 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e ll open savepoin
7f50: 74 73 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f ts. This functio
7f60: 6e 20 6f 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 n only manipulat
7f70: 65 73 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 es fields of the
7f80: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e .** database han
7f90: 64 6c 65 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 dle object, it d
7fa0: 6f 65 73 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e oes not close an
7fb0: 79 20 73 61 76 65 70 6f 69 6e 74 73 20 74 68 61 y savepoints tha
7fc0: 74 20 6d 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a t may be open.**
7fd0: 20 61 74 20 74 68 65 20 62 2d 74 72 65 65 2f 70 at the b-tree/p
7fe0: 61 67 65 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 ager level..*/.v
7ff0: 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 oid sqlite3Close
8000: 53 61 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 Savepoints(sqlit
8010: 65 33 20 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 e3 *db){. while
8020: 28 20 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 ( db->pSavepoint
8030: 20 29 7b 0a 20 20 20 20 53 61 76 65 70 6f 69 6e ){. Savepoin
8040: 74 20 2a 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 t *pTmp = db->pS
8050: 61 76 65 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 avepoint;. db
8060: 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 ->pSavepoint = p
8070: 54 6d 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 Tmp->pNext;.
8080: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
8090: 2c 20 70 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 , pTmp);. }. d
80a0: 62 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 b->nSavepoint =
80b0: 30 3b 0a 20 20 64 62 2d 3e 6e 53 74 61 74 65 6d 0;. db->nStatem
80c0: 65 6e 74 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 69 ent = 0;. db->i
80d0: 73 54 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 sTransactionSave
80e0: 70 6f 69 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a point = 0;.}../*
80f0: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 .** Invoke the d
8100: 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 estructor functi
8110: 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 on associated wi
8120: 74 68 20 46 75 6e 63 44 65 66 20 70 2c 20 69 66 th FuncDef p, if
8130: 20 61 6e 79 2e 20 45 78 63 65 70 74 2c 0a 2a 2a any. Except,.**
8140: 20 69 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 if this is not
8150: 74 68 65 20 6c 61 73 74 20 63 6f 70 79 20 6f 66 the last copy of
8160: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 64 the function, d
8170: 6f 20 6e 6f 74 20 69 6e 76 6f 6b 65 20 69 74 2e o not invoke it.
8180: 20 4d 75 6c 74 69 70 6c 65 0a 2a 2a 20 63 6f 70 Multiple.** cop
8190: 69 65 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 ies of a single
81a0: 66 75 6e 63 74 69 6f 6e 20 61 72 65 20 63 72 65 function are cre
81b0: 61 74 65 64 20 77 68 65 6e 20 63 72 65 61 74 65 ated when create
81c0: 5f 66 75 6e 63 74 69 6f 6e 28 29 20 69 73 20 63 _function() is c
81d0: 61 6c 6c 65 64 0a 2a 2a 20 77 69 74 68 20 53 51 alled.** with SQ
81e0: 4c 49 54 45 5f 41 4e 59 20 61 73 20 74 68 65 20 LITE_ANY as the
81f0: 65 6e 63 6f 64 69 6e 67 2e 0a 2a 2f 0a 73 74 61 encoding..*/.sta
8200: 74 69 63 20 76 6f 69 64 20 66 75 6e 63 74 69 6f tic void functio
8210: 6e 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 nDestroy(sqlite3
8220: 20 2a 64 62 2c 20 46 75 6e 63 44 65 66 20 2a 70 *db, FuncDef *p
8230: 29 7b 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 ){. FuncDestruc
8240: 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 tor *pDestructor
8250: 20 3d 20 70 2d 3e 75 2e 70 44 65 73 74 72 75 63 = p->u.pDestruc
8260: 74 6f 72 3b 0a 20 20 69 66 28 20 70 44 65 73 74 tor;. if( pDest
8270: 72 75 63 74 6f 72 20 29 7b 0a 20 20 20 20 70 44 ructor ){. pD
8280: 65 73 74 72 75 63 74 6f 72 2d 3e 6e 52 65 66 2d estructor->nRef-
8290: 2d 3b 0a 20 20 20 20 69 66 28 20 70 44 65 73 74 -;. if( pDest
82a0: 72 75 63 74 6f 72 2d 3e 6e 52 65 66 3d 3d 30 20 ructor->nRef==0
82b0: 29 7b 0a 20 20 20 20 20 20 70 44 65 73 74 72 75 ){. pDestru
82c0: 63 74 6f 72 2d 3e 78 44 65 73 74 72 6f 79 28 70 ctor->xDestroy(p
82d0: 44 65 73 74 72 75 63 74 6f 72 2d 3e 70 55 73 65 Destructor->pUse
82e0: 72 44 61 74 61 29 3b 0a 20 20 20 20 20 20 73 71 rData);. sq
82f0: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
8300: 70 44 65 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 pDestructor);.
8310: 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
8320: 20 44 69 73 63 6f 6e 6e 65 63 74 20 61 6c 6c 20 Disconnect all
8330: 73 71 6c 69 74 65 33 5f 76 74 61 62 20 6f 62 6a sqlite3_vtab obj
8340: 65 63 74 73 20 74 68 61 74 20 62 65 6c 6f 6e 67 ects that belong
8350: 20 74 6f 20 64 61 74 61 62 61 73 65 20 63 6f 6e to database con
8360: 6e 65 63 74 69 6f 6e 0a 2a 2a 20 64 62 2e 20 54 nection.** db. T
8370: 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 77 68 his is called wh
8380: 65 6e 20 64 62 20 69 73 20 62 65 69 6e 67 20 63 en db is being c
8390: 6c 6f 73 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 losed..*/.static
83a0: 20 76 6f 69 64 20 64 69 73 63 6f 6e 6e 65 63 74 void disconnect
83b0: 41 6c 6c 56 74 61 62 28 73 71 6c 69 74 65 33 20 AllVtab(sqlite3
83c0: 2a 64 62 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 *db){.#ifndef SQ
83d0: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
83e0: 4c 54 41 42 4c 45 0a 20 20 69 6e 74 20 69 3b 0a LTABLE. int i;.
83f0: 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a 20 HashElem *p;.
8400: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
8410: 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 erAll(db);. for
8420: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b (i=0; i<db->nDb;
8430: 20 69 2b 2b 29 7b 0a 20 20 20 20 53 63 68 65 6d i++){. Schem
8440: 61 20 2a 70 53 63 68 65 6d 61 20 3d 20 64 62 2d a *pSchema = db-
8450: 3e 61 44 62 5b 69 5d 2e 70 53 63 68 65 6d 61 3b >aDb[i].pSchema;
8460: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44 62 . if( db->aDb
8470: 5b 69 5d 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 [i].pSchema ){.
8480: 20 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 for(p=sqlit
8490: 65 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 eHashFirst(&pSch
84a0: 65 6d 61 2d 3e 74 62 6c 48 61 73 68 29 3b 20 70 ema->tblHash); p
84b0: 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 ; p=sqliteHashNe
84c0: 78 74 28 70 29 29 7b 0a 20 20 20 20 20 20 20 20 xt(p)){.
84d0: 54 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 28 54 Table *pTab = (T
84e0: 61 62 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 able *)sqliteHas
84f0: 68 44 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 hData(p);.
8500: 20 20 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 if( IsVirtual(
8510: 70 54 61 62 29 20 29 20 73 71 6c 69 74 65 33 56 pTab) ) sqlite3V
8520: 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 64 62 tabDisconnect(db
8530: 2c 20 70 54 61 62 29 3b 0a 20 20 20 20 20 20 7d , pTab);. }
8540: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 . }. }. for
8550: 28 70 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 (p=sqliteHashFir
8560: 73 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 st(&db->aModule)
8570: 3b 20 70 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 ; p; p=sqliteHas
8580: 68 4e 65 78 74 28 70 29 29 7b 0a 20 20 20 20 4d hNext(p)){. M
8590: 6f 64 75 6c 65 20 2a 70 4d 6f 64 20 3d 20 28 4d odule *pMod = (M
85a0: 6f 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 odule *)sqliteHa
85b0: 73 68 44 61 74 61 28 70 29 3b 0a 20 20 20 20 69 shData(p);. i
85c0: 66 28 20 70 4d 6f 64 2d 3e 70 45 70 6f 54 61 62 f( pMod->pEpoTab
85d0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
85e0: 33 56 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 3VtabDisconnect(
85f0: 64 62 2c 20 70 4d 6f 64 2d 3e 70 45 70 6f 54 61 db, pMod->pEpoTa
8600: 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 b);. }. }.
8610: 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 sqlite3VtabUnloc
8620: 6b 4c 69 73 74 28 64 62 29 3b 0a 20 20 73 71 6c kList(db);. sql
8630: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c ite3BtreeLeaveAl
8640: 6c 28 64 62 29 3b 0a 23 65 6c 73 65 0a 20 20 55 l(db);.#else. U
8650: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
8660: 64 62 29 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f db);.#endif.}../
8670: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 *.** Return TRUE
8680: 20 69 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e if database con
8690: 6e 65 63 74 69 6f 6e 20 64 62 20 68 61 73 20 75 nection db has u
86a0: 6e 66 69 6e 61 6c 69 7a 65 64 20 70 72 65 70 61 nfinalized prepa
86b0: 72 65 64 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 red.** statement
86c0: 73 20 6f 72 20 75 6e 66 69 6e 69 73 68 65 64 20 s or unfinished
86d0: 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 6f sqlite3_backup o
86e0: 62 6a 65 63 74 73 2e 20 20 0a 2a 2f 0a 73 74 61 bjects. .*/.sta
86f0: 74 69 63 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69 tic int connecti
8700: 6f 6e 49 73 42 75 73 79 28 73 71 6c 69 74 65 33 onIsBusy(sqlite3
8710: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 6a 3b 0a *db){. int j;.
8720: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
8730: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3_mutex_held(db-
8740: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
8750: 20 64 62 2d 3e 70 56 64 62 65 20 29 20 72 65 74 db->pVdbe ) ret
8760: 75 72 6e 20 31 3b 0a 20 20 66 6f 72 28 6a 3d 30 urn 1;. for(j=0
8770: 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b ; j<db->nDb; j++
8780: 29 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 ){. Btree *pB
8790: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 6a 5d 2e 70 t = db->aDb[j].p
87a0: 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20 Bt;. if( pBt
87b0: 26 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 && sqlite3BtreeI
87c0: 73 49 6e 42 61 63 6b 75 70 28 70 42 74 29 20 29 sInBackup(pBt) )
87d0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 return 1;. }.
87e0: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a return 0;.}../*
87f0: 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 .** Close an exi
8800: 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64 61 74 sting SQLite dat
8810: 61 62 61 73 65 0a 2a 2f 0a 73 74 61 74 69 63 20 abase.*/.static
8820: 69 6e 74 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 int sqlite3Close
8830: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e (sqlite3 *db, in
8840: 74 20 66 6f 72 63 65 5a 6f 6d 62 69 65 29 7b 0a t forceZombie){.
8850: 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 20 if( !db ){.
8860: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
8870: 20 52 2d 36 33 32 35 37 2d 31 31 37 34 30 20 43 R-63257-11740 C
8880: 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 alling sqlite3_c
8890: 6c 6f 73 65 28 29 20 6f 72 0a 20 20 20 20 2a 2a lose() or. **
88a0: 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 sqlite3_close_v
88b0: 32 28 29 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 2() with a NULL
88c0: 70 6f 69 6e 74 65 72 20 61 72 67 75 6d 65 6e 74 pointer argument
88d0: 20 69 73 20 61 20 68 61 72 6d 6c 65 73 73 20 6e is a harmless n
88e0: 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 20 20 72 65 74 o-op. */. ret
88f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
8900: 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 }. if( !sqlite
8910: 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 3SafetyCheckSick
8920: 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 OrOk(db) ){.
8930: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
8940: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 SUSE_BKPT;. }.
8950: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
8960: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
8970: 0a 20 20 69 66 28 20 64 62 2d 3e 6d 54 72 61 63 . if( db->mTrac
8980: 65 20 26 20 53 51 4c 49 54 45 5f 54 52 41 43 45 e & SQLITE_TRACE
8990: 5f 43 4c 4f 53 45 20 29 7b 0a 20 20 20 20 64 62 _CLOSE ){. db
89a0: 2d 3e 78 54 72 61 63 65 28 53 51 4c 49 54 45 5f ->xTrace(SQLITE_
89b0: 54 52 41 43 45 5f 43 4c 4f 53 45 2c 20 64 62 2d TRACE_CLOSE, db-
89c0: 3e 70 54 72 61 63 65 41 72 67 2c 20 64 62 2c 20 >pTraceArg, db,
89d0: 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 6f 0);. }.. /* Fo
89e0: 72 63 65 20 78 44 69 73 63 6f 6e 6e 65 63 74 20 rce xDisconnect
89f0: 63 61 6c 6c 73 20 6f 6e 20 61 6c 6c 20 76 69 72 calls on all vir
8a00: 74 75 61 6c 20 74 61 62 6c 65 73 20 2a 2f 0a 20 tual tables */.
8a10: 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 disconnectAllVt
8a20: 61 62 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 49 66 ab(db);.. /* If
8a30: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
8a40: 73 20 6f 70 65 6e 2c 20 74 68 65 20 64 69 73 63 s open, the disc
8a50: 6f 6e 6e 65 63 74 41 6c 6c 56 74 61 62 28 29 20 onnectAllVtab()
8a60: 63 61 6c 6c 20 61 62 6f 76 65 0a 20 20 2a 2a 20 call above. **
8a70: 77 69 6c 6c 20 6e 6f 74 20 68 61 76 65 20 63 61 will not have ca
8a80: 6c 6c 65 64 20 74 68 65 20 78 44 69 73 63 6f 6e lled the xDiscon
8a90: 6e 65 63 74 28 29 20 6d 65 74 68 6f 64 20 6f 6e nect() method on
8aa0: 20 61 6e 79 20 76 69 72 74 75 61 6c 0a 20 20 2a any virtual. *
8ab0: 2a 20 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20 * tables in the
8ac0: 64 62 2d 3e 61 56 54 72 61 6e 73 5b 5d 20 61 72 db->aVTrans[] ar
8ad0: 72 61 79 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 ray. The followi
8ae0: 6e 67 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f ng sqlite3VtabRo
8af0: 6c 6c 62 61 63 6b 28 29 0a 20 20 2a 2a 20 63 61 llback(). ** ca
8b00: 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 6f 2e 20 57 ll will do so. W
8b10: 65 20 6e 65 65 64 20 74 6f 20 64 6f 20 74 68 69 e need to do thi
8b20: 73 20 62 65 66 6f 72 65 20 74 68 65 20 63 68 65 s before the che
8b30: 63 6b 20 66 6f 72 20 61 63 74 69 76 65 0a 20 20 ck for active.
8b40: 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ** SQL statement
8b50: 73 20 62 65 6c 6f 77 2c 20 61 73 20 74 68 65 20 s below, as the
8b60: 76 2d 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e v-table implemen
8b70: 74 61 74 69 6f 6e 20 6d 61 79 20 62 65 20 73 74 tation may be st
8b80: 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 6f 6d 65 20 oring. ** some
8b90: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
8ba0: 6e 74 73 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a nts internally..
8bb0: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 74 */. sqlite3Vt
8bc0: 61 62 52 6f 6c 6c 62 61 63 6b 28 64 62 29 3b 0a abRollback(db);.
8bd0: 0a 20 20 2f 2a 20 4c 65 67 61 63 79 20 62 65 68 . /* Legacy beh
8be0: 61 76 69 6f 72 20 28 73 71 6c 69 74 65 33 5f 63 avior (sqlite3_c
8bf0: 6c 6f 73 65 28 29 20 62 65 68 61 76 69 6f 72 29 lose() behavior)
8c00: 20 69 73 20 74 6f 20 72 65 74 75 72 6e 0a 20 20 is to return.
8c10: 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 ** SQLITE_BUSY i
8c20: 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e f the connection
8c30: 20 63 61 6e 20 6e 6f 74 20 62 65 20 63 6c 6f 73 can not be clos
8c40: 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 0a ed immediately..
8c50: 20 20 2a 2f 0a 20 20 69 66 28 20 21 66 6f 72 63 */. if( !forc
8c60: 65 5a 6f 6d 62 69 65 20 26 26 20 63 6f 6e 6e 65 eZombie && conne
8c70: 63 74 69 6f 6e 49 73 42 75 73 79 28 64 62 29 20 ctionIsBusy(db)
8c80: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 ){. sqlite3Er
8c90: 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 53 rorWithMsg(db, S
8ca0: 51 4c 49 54 45 5f 42 55 53 59 2c 20 22 75 6e 61 QLITE_BUSY, "una
8cb0: 62 6c 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 ble to close due
8cc0: 20 74 6f 20 75 6e 66 69 6e 61 6c 69 7a 65 64 20 to unfinalized
8cd0: 22 0a 20 20 20 20 20 20 20 22 73 74 61 74 65 6d ". "statem
8ce0: 65 6e 74 73 20 6f 72 20 75 6e 66 69 6e 69 73 68 ents or unfinish
8cf0: 65 64 20 62 61 63 6b 75 70 73 22 29 3b 0a 20 20 ed backups");.
8d00: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
8d10: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
8d20: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
8d30: 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a 0a 23 ITE_BUSY;. }..#
8d40: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
8d50: 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 69 66 28 BLE_SQLLOG. if(
8d60: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
8d70: 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 29 7b 0a nfig.xSqllog ){.
8d80: 20 20 20 20 2f 2a 20 43 6c 6f 73 69 6e 67 20 74 /* Closing t
8d90: 68 65 20 68 61 6e 64 6c 65 2e 20 46 6f 75 72 74 he handle. Fourt
8da0: 68 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 70 h parameter is p
8db0: 61 73 73 65 64 20 74 68 65 20 76 61 6c 75 65 20 assed the value
8dc0: 32 2e 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 2. */. sqlite
8dd0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 53 3GlobalConfig.xS
8de0: 71 6c 6c 6f 67 28 73 71 6c 69 74 65 33 47 6c 6f qllog(sqlite3Glo
8df0: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 71 6c 6c 6f balConfig.pSqllo
8e00: 67 41 72 67 2c 20 64 62 2c 20 30 2c 20 32 29 3b gArg, db, 0, 2);
8e10: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f . }.#endif.. /
8e20: 2a 20 43 6f 6e 76 65 72 74 20 74 68 65 20 63 6f * Convert the co
8e30: 6e 6e 65 63 74 69 6f 6e 20 69 6e 74 6f 20 61 20 nnection into a
8e40: 7a 6f 6d 62 69 65 20 61 6e 64 20 74 68 65 6e 20 zombie and then
8e50: 63 6c 6f 73 65 20 69 74 2e 0a 20 20 2a 2f 0a 20 close it.. */.
8e60: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
8e70: 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 ITE_MAGIC_ZOMBIE
8e80: 3b 0a 20 20 73 71 6c 69 74 65 33 4c 65 61 76 65 ;. sqlite3Leave
8e90: 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d MutexAndCloseZom
8ea0: 62 69 65 28 64 62 29 3b 0a 20 20 72 65 74 75 72 bie(db);. retur
8eb0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
8ec0: 2f 2a 0a 2a 2a 20 54 77 6f 20 76 61 72 69 61 74 /*.** Two variat
8ed0: 69 6f 6e 73 20 6f 6e 20 74 68 65 20 70 75 62 6c ions on the publ
8ee0: 69 63 20 69 6e 74 65 72 66 61 63 65 20 66 6f 72 ic interface for
8ef0: 20 63 6c 6f 73 69 6e 67 20 61 20 64 61 74 61 62 closing a datab
8f00: 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f ase.** connectio
8f10: 6e 2e 20 54 68 65 20 73 71 6c 69 74 65 33 5f 63 n. The sqlite3_c
8f20: 6c 6f 73 65 28 29 20 76 65 72 73 69 6f 6e 20 72 lose() version r
8f30: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 42 55 eturns SQLITE_BU
8f40: 53 59 20 61 6e 64 0a 2a 2a 20 6c 65 61 76 65 73 SY and.** leaves
8f50: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
8f60: 6f 70 74 69 6f 6e 20 69 66 20 74 68 65 72 65 20 option if there
8f70: 61 72 65 20 75 6e 66 69 6e 61 6c 69 7a 65 64 20 are unfinalized
8f80: 70 72 65 70 61 72 65 64 0a 2a 2a 20 73 74 61 74 prepared.** stat
8f90: 65 6d 65 6e 74 73 20 6f 72 20 75 6e 66 69 6e 69 ements or unfini
8fa0: 73 68 65 64 20 73 71 6c 69 74 65 33 5f 62 61 63 shed sqlite3_bac
8fb0: 6b 75 70 73 2e 20 20 54 68 65 20 73 71 6c 69 74 kups. The sqlit
8fc0: 65 33 5f 63 6c 6f 73 65 5f 76 32 28 29 0a 2a 2a e3_close_v2().**
8fd0: 20 76 65 72 73 69 6f 6e 20 66 6f 72 63 65 73 20 version forces
8fe0: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 the connection t
8ff0: 6f 20 62 65 63 6f 6d 65 20 61 20 7a 6f 6d 62 69 o become a zombi
9000: 65 20 69 66 20 74 68 65 72 65 20 61 72 65 0a 2a e if there are.*
9010: 2a 20 75 6e 63 6c 6f 73 65 64 20 72 65 73 6f 75 * unclosed resou
9020: 72 63 65 73 2c 20 61 6e 64 20 61 72 72 61 6e 67 rces, and arrang
9030: 65 73 20 66 6f 72 20 64 65 61 6c 6c 6f 63 61 74 es for deallocat
9040: 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 6c 61 73 ion when the las
9050: 74 0a 2a 2a 20 70 72 65 70 61 72 65 20 73 74 61 t.** prepare sta
9060: 74 65 6d 65 6e 74 20 6f 72 20 73 71 6c 69 74 65 tement or sqlite
9070: 33 5f 62 61 63 6b 75 70 20 63 6c 6f 73 65 73 2e 3_backup closes.
9080: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
9090: 63 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a 64 close(sqlite3 *d
90a0: 62 29 7b 20 72 65 74 75 72 6e 20 73 71 6c 69 74 b){ return sqlit
90b0: 65 33 43 6c 6f 73 65 28 64 62 2c 30 29 3b 20 7d e3Close(db,0); }
90c0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f .int sqlite3_clo
90d0: 73 65 5f 76 32 28 73 71 6c 69 74 65 33 20 2a 64 se_v2(sqlite3 *d
90e0: 62 29 7b 20 72 65 74 75 72 6e 20 73 71 6c 69 74 b){ return sqlit
90f0: 65 33 43 6c 6f 73 65 28 64 62 2c 31 29 3b 20 7d e3Close(db,1); }
9100: 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 74 .../*.** Close t
9110: 68 65 20 6d 75 74 65 78 20 6f 6e 20 64 61 74 61 he mutex on data
9120: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
9130: 64 62 2e 0a 2a 2a 0a 2a 2a 20 46 75 72 74 68 65 db..**.** Furthe
9140: 72 6d 6f 72 65 2c 20 69 66 20 64 61 74 61 62 61 rmore, if databa
9150: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64 62 se connection db
9160: 20 69 73 20 61 20 7a 6f 6d 62 69 65 20 28 6d 65 is a zombie (me
9170: 61 6e 69 6e 67 20 74 68 61 74 20 74 68 65 72 65 aning that there
9180: 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 61 20 70 .** has been a p
9190: 72 69 6f 72 20 63 61 6c 6c 20 74 6f 20 73 71 6c rior call to sql
91a0: 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 20 6f ite3_close(db) o
91b0: 72 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f r sqlite3_close_
91c0: 76 32 28 64 62 29 29 20 61 6e 64 0a 2a 2a 20 65 v2(db)) and.** e
91d0: 76 65 72 79 20 73 71 6c 69 74 65 33 5f 73 74 6d very sqlite3_stm
91e0: 74 20 68 61 73 20 6e 6f 77 20 62 65 65 6e 20 66 t has now been f
91f0: 69 6e 61 6c 69 7a 65 64 20 61 6e 64 20 65 76 65 inalized and eve
9200: 72 79 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 ry sqlite3_backu
9210: 70 20 68 61 73 0a 2a 2a 20 66 69 6e 69 73 68 65 p has.** finishe
9220: 64 2c 20 74 68 65 6e 20 66 72 65 65 20 61 6c 6c d, then free all
9230: 20 72 65 73 6f 75 72 63 65 73 2e 0a 2a 2f 0a 76 resources..*/.v
9240: 6f 69 64 20 73 71 6c 69 74 65 33 4c 65 61 76 65 oid sqlite3Leave
9250: 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d MutexAndCloseZom
9260: 62 69 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 bie(sqlite3 *db)
9270: 7b 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b {. HashElem *i;
9280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9290: 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c /* Hash tabl
92a0: 65 20 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 e iterator */.
92b0: 69 6e 74 20 6a 3b 0a 0a 20 20 2f 2a 20 49 66 20 int j;.. /* If
92c0: 74 68 65 72 65 20 61 72 65 20 6f 75 74 73 74 61 there are outsta
92d0: 6e 64 69 6e 67 20 73 71 6c 69 74 65 33 5f 73 74 nding sqlite3_st
92e0: 6d 74 20 6f 72 20 73 71 6c 69 74 65 33 5f 62 61 mt or sqlite3_ba
92f0: 63 6b 75 70 20 6f 62 6a 65 63 74 73 0a 20 20 2a ckup objects. *
9300: 2a 20 6f 72 20 69 66 20 74 68 65 20 63 6f 6e 6e * or if the conn
9310: 65 63 74 69 6f 6e 20 68 61 73 20 6e 6f 74 20 79 ection has not y
9320: 65 74 20 62 65 65 6e 20 63 6c 6f 73 65 64 20 62 et been closed b
9330: 79 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f y sqlite3_close_
9340: 76 32 28 29 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 v2(),. ** then
9350: 6a 75 73 74 20 6c 65 61 76 65 20 74 68 65 20 6d just leave the m
9360: 75 74 65 78 20 61 6e 64 20 72 65 74 75 72 6e 2e utex and return.
9370: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e . */. if( db->
9380: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 magic!=SQLITE_MA
9390: 47 49 43 5f 5a 4f 4d 42 49 45 20 7c 7c 20 63 6f GIC_ZOMBIE || co
93a0: 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 79 28 64 nnectionIsBusy(d
93b0: 62 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 b) ){. sqlite
93c0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
93d0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65 ->mutex);. re
93e0: 74 75 72 6e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 turn;. }.. /*
93f0: 49 66 20 77 65 20 72 65 61 63 68 20 74 68 69 73 If we reach this
9400: 20 70 6f 69 6e 74 2c 20 69 74 20 6d 65 61 6e 73 point, it means
9410: 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 that the databa
9420: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 se connection ha
9430: 73 0a 20 20 2a 2a 20 63 6c 6f 73 65 64 20 61 6c s. ** closed al
9440: 6c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 61 l sqlite3_stmt a
9450: 6e 64 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 nd sqlite3_backu
9460: 70 20 6f 62 6a 65 63 74 73 20 61 6e 64 20 68 61 p objects and ha
9470: 73 20 62 65 65 6e 0a 20 20 2a 2a 20 70 61 73 73 s been. ** pass
9480: 65 64 20 74 6f 20 73 71 6c 69 74 65 33 5f 63 6c ed to sqlite3_cl
9490: 6f 73 65 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 ose (meaning tha
94a0: 74 20 69 74 20 69 73 20 61 20 7a 6f 6d 62 69 65 t it is a zombie
94b0: 29 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 0a 20 ). Therefore,.
94c0: 20 2a 2a 20 67 6f 20 61 68 65 61 64 20 61 6e 64 ** go ahead and
94d0: 20 66 72 65 65 20 61 6c 6c 20 72 65 73 6f 75 72 free all resour
94e0: 63 65 73 2e 0a 20 20 2a 2f 0a 0a 20 20 2f 2a 20 ces.. */.. /*
94f0: 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
9500: 20 69 73 20 6f 70 65 6e 2c 20 72 6f 6c 6c 20 69 is open, roll i
9510: 74 20 62 61 63 6b 2e 20 54 68 69 73 20 61 6c 73 t back. This als
9520: 6f 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 69 o ensures that i
9530: 66 0a 20 20 2a 2a 20 61 6e 79 20 64 61 74 61 62 f. ** any datab
9540: 61 73 65 20 73 63 68 65 6d 61 73 20 68 61 76 65 ase schemas have
9550: 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 62 been modified b
9560: 79 20 61 6e 20 75 6e 63 6f 6d 6d 69 74 74 65 64 y an uncommitted
9570: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a transaction. *
9580: 2a 20 74 68 65 79 20 61 72 65 20 72 65 73 65 74 * they are reset
9590: 2e 20 41 6e 64 20 74 68 61 74 20 74 68 65 20 72 . And that the r
95a0: 65 71 75 69 72 65 64 20 62 2d 74 72 65 65 20 6d equired b-tree m
95b0: 75 74 65 78 20 69 73 20 68 65 6c 64 20 74 6f 20 utex is held to
95c0: 6d 61 6b 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 make. ** the pa
95d0: 67 65 72 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 ger rollback and
95e0: 20 73 63 68 65 6d 61 20 72 65 73 65 74 20 61 6e schema reset an
95f0: 20 61 74 6f 6d 69 63 20 6f 70 65 72 61 74 69 6f atomic operatio
9600: 6e 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 52 n. */. sqlite3R
9610: 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 2c 20 53 ollbackAll(db, S
9620: 51 4c 49 54 45 5f 4f 4b 29 3b 0a 0a 20 20 2f 2a QLITE_OK);.. /*
9630: 20 46 72 65 65 20 61 6e 79 20 6f 75 74 73 74 61 Free any outsta
9640: 6e 64 69 6e 67 20 53 61 76 65 70 6f 69 6e 74 20 nding Savepoint
9650: 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f 0a 20 structures. */.
9660: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 sqlite3CloseSav
9670: 65 70 6f 69 6e 74 73 28 64 62 29 3b 0a 0a 20 20 epoints(db);..
9680: 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 64 61 74 /* Close all dat
9690: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
96a0: 73 20 2a 2f 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 s */. for(j=0;
96b0: 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b j<db->nDb; j++){
96c0: 0a 20 20 20 20 73 74 72 75 63 74 20 44 62 20 2a . struct Db *
96d0: 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 6a pDb = &db->aDb[j
96e0: 5d 3b 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e ];. if( pDb->
96f0: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c pBt ){. sql
9700: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70 ite3BtreeClose(p
9710: 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 20 20 Db->pBt);.
9720: 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a 20 20 pDb->pBt = 0;.
9730: 20 20 20 20 69 66 28 20 6a 21 3d 31 20 29 7b 0a if( j!=1 ){.
9740: 20 20 20 20 20 20 20 20 70 44 62 2d 3e 70 53 63 pDb->pSc
9750: 68 65 6d 61 20 3d 20 30 3b 0a 20 20 20 20 20 20 hema = 0;.
9760: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 2f 2a }. }. }. /*
9770: 20 43 6c 65 61 72 20 74 68 65 20 54 45 4d 50 20 Clear the TEMP
9780: 73 63 68 65 6d 61 20 73 65 70 61 72 61 74 65 6c schema separatel
9790: 79 20 61 6e 64 20 6c 61 73 74 20 2a 2f 0a 20 20 y and last */.
97a0: 69 66 28 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 if( db->aDb[1].p
97b0: 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 73 71 Schema ){. sq
97c0: 6c 69 74 65 33 53 63 68 65 6d 61 43 6c 65 61 72 lite3SchemaClear
97d0: 28 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 (db->aDb[1].pSch
97e0: 65 6d 61 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 ema);. }. sqli
97f0: 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 te3VtabUnlockLis
9800: 74 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 46 72 65 t(db);.. /* Fre
9810: 65 20 75 70 20 74 68 65 20 61 72 72 61 79 20 6f e up the array o
9820: 66 20 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 f auxiliary data
9830: 62 61 73 65 73 20 2a 2f 0a 20 20 73 71 6c 69 74 bases */. sqlit
9840: 65 33 43 6f 6c 6c 61 70 73 65 44 61 74 61 62 61 e3CollapseDataba
9850: 73 65 41 72 72 61 79 28 64 62 29 3b 0a 20 20 61 seArray(db);. a
9860: 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d ssert( db->nDb<=
9870: 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 2 );. assert( d
9880: 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53 b->aDb==db->aDbS
9890: 74 61 74 69 63 20 29 3b 0a 0a 20 20 2f 2a 20 54 tatic );.. /* T
98a0: 65 6c 6c 20 74 68 65 20 63 6f 64 65 20 69 6e 20 ell the code in
98b0: 6e 6f 74 69 66 79 2e 63 20 74 68 61 74 20 74 68 notify.c that th
98c0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6e 6f 20 e connection no
98d0: 6c 6f 6e 67 65 72 20 68 6f 6c 64 73 20 61 6e 79 longer holds any
98e0: 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 61 6e 64 20 . ** locks and
98f0: 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 does not require
9900: 20 61 6e 79 20 66 75 72 74 68 65 72 20 75 6e 6c any further unl
9910: 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c 6c 62 ock-notify callb
9920: 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c acks.. */. sql
9930: 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c ite3ConnectionCl
9940: 6f 73 65 64 28 64 62 29 3b 0a 0a 20 20 66 6f 72 osed(db);.. for
9950: 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 (i=sqliteHashFir
9960: 73 74 28 26 64 62 2d 3e 61 46 75 6e 63 29 3b 20 st(&db->aFunc);
9970: 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e i; i=sqliteHashN
9980: 65 78 74 28 69 29 29 7b 0a 20 20 20 20 46 75 6e ext(i)){. Fun
9990: 63 44 65 66 20 2a 70 4e 65 78 74 2c 20 2a 70 3b cDef *pNext, *p;
99a0: 0a 20 20 20 20 70 20 3d 20 73 71 6c 69 74 65 48 . p = sqliteH
99b0: 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20 ashData(i);.
99c0: 64 6f 7b 0a 20 20 20 20 20 20 66 75 6e 63 74 69 do{. functi
99d0: 6f 6e 44 65 73 74 72 6f 79 28 64 62 2c 20 70 29 onDestroy(db, p)
99e0: 3b 0a 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20 ;. pNext =
99f0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 p->pNext;.
9a00: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
9a10: 2c 20 70 29 3b 0a 20 20 20 20 20 20 70 20 3d 20 , p);. p =
9a20: 70 4e 65 78 74 3b 0a 20 20 20 20 7d 77 68 69 6c pNext;. }whil
9a30: 65 28 20 70 20 29 3b 0a 20 20 7d 0a 20 20 73 71 e( p );. }. sq
9a40: 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 lite3HashClear(&
9a50: 64 62 2d 3e 61 46 75 6e 63 29 3b 0a 20 20 66 6f db->aFunc);. fo
9a60: 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 r(i=sqliteHashFi
9a70: 72 73 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 rst(&db->aCollSe
9a80: 71 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 q); i; i=sqliteH
9a90: 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 ashNext(i)){.
9aa0: 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 CollSeq *pColl
9ab0: 3d 20 28 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c = (CollSeq *)sql
9ac0: 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a iteHashData(i);.
9ad0: 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 61 6e /* Invoke an
9ae0: 79 20 64 65 73 74 72 75 63 74 6f 72 73 20 72 65 y destructors re
9af0: 67 69 73 74 65 72 65 64 20 66 6f 72 20 63 6f 6c gistered for col
9b00: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
9b10: 75 73 65 72 20 64 61 74 61 2e 20 2a 2f 0a 20 20 user data. */.
9b20: 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 3b 20 for(j=0; j<3;
9b30: 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 j++){. if(
9b40: 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 20 29 7b pColl[j].xDel ){
9b50: 0a 20 20 20 20 20 20 20 20 70 43 6f 6c 6c 5b 6a . pColl[j
9b60: 5d 2e 78 44 65 6c 28 70 43 6f 6c 6c 5b 6a 5d 2e ].xDel(pColl[j].
9b70: 70 55 73 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a pUser);. }.
9b80: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
9b90: 33 44 62 46 72 65 65 28 64 62 2c 20 70 43 6f 6c 3DbFree(db, pCol
9ba0: 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 l);. }. sqlite
9bb0: 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 3HashClear(&db->
9bc0: 61 43 6f 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 aCollSeq);.#ifnd
9bd0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ef SQLITE_OMIT_V
9be0: 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 66 6f IRTUALTABLE. fo
9bf0: 72 28 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 r(i=sqliteHashFi
9c00: 72 73 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 rst(&db->aModule
9c10: 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 ); i; i=sqliteHa
9c20: 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 shNext(i)){.
9c30: 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 20 3d 20 28 Module *pMod = (
9c40: 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 48 Module *)sqliteH
9c50: 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20 ashData(i);.
9c60: 69 66 28 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 if( pMod->xDestr
9c70: 6f 79 20 29 7b 0a 20 20 20 20 20 20 70 4d 6f 64 oy ){. pMod
9c80: 2d 3e 78 44 65 73 74 72 6f 79 28 70 4d 6f 64 2d ->xDestroy(pMod-
9c90: 3e 70 41 75 78 29 3b 0a 20 20 20 20 7d 0a 20 20 >pAux);. }.
9ca0: 20 20 73 71 6c 69 74 65 33 56 74 61 62 45 70 6f sqlite3VtabEpo
9cb0: 6e 79 6d 6f 75 73 54 61 62 6c 65 43 6c 65 61 72 nymousTableClear
9cc0: 28 64 62 2c 20 70 4d 6f 64 29 3b 0a 20 20 20 20 (db, pMod);.
9cd0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
9ce0: 2c 20 70 4d 6f 64 29 3b 0a 20 20 7d 0a 20 20 73 , pMod);. }. s
9cf0: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 qlite3HashClear(
9d00: 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 &db->aModule);.#
9d10: 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 endif.. sqlite3
9d20: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
9d30: 5f 4f 4b 29 3b 20 2f 2a 20 44 65 61 6c 6c 6f 63 _OK); /* Dealloc
9d40: 61 74 65 73 20 61 6e 79 20 63 61 63 68 65 64 20 ates any cached
9d50: 65 72 72 6f 72 20 73 74 72 69 6e 67 73 2e 20 2a error strings. *
9d60: 2f 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 /. sqlite3Value
9d70: 46 72 65 65 28 64 62 2d 3e 70 45 72 72 29 3b 0a Free(db->pErr);.
9d80: 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 sqlite3CloseEx
9d90: 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 23 69 tensions(db);.#i
9da0: 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 f SQLITE_USER_AU
9db0: 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 THENTICATION. s
9dc0: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e qlite3_free(db->
9dd0: 61 75 74 68 2e 7a 41 75 74 68 55 73 65 72 29 3b auth.zAuthUser);
9de0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
9df0: 64 62 2d 3e 61 75 74 68 2e 7a 41 75 74 68 50 57 db->auth.zAuthPW
9e00: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 64 62 2d );.#endif.. db-
9e10: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
9e20: 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 0a 20 20 MAGIC_ERROR;..
9e30: 2f 2a 20 54 68 65 20 74 65 6d 70 2d 64 61 74 61 /* The temp-data
9e40: 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 61 base schema is a
9e50: 6c 6c 6f 63 61 74 65 64 20 64 69 66 66 65 72 65 llocated differe
9e60: 6e 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 6f 74 ntly from the ot
9e70: 68 65 72 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 her schema. **
9e80: 6f 62 6a 65 63 74 73 20 28 75 73 69 6e 67 20 73 objects (using s
9e90: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 64 69 qliteMalloc() di
9ea0: 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 20 rectly, instead
9eb0: 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 of sqlite3BtreeS
9ec0: 63 68 65 6d 61 28 29 29 2e 0a 20 20 2a 2a 20 53 chema()).. ** S
9ed0: 6f 20 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 o it needs to be
9ee0: 20 66 72 65 65 64 20 68 65 72 65 2e 20 54 6f 64 freed here. Tod
9ef0: 6f 3a 20 57 68 79 20 6e 6f 74 20 72 6f 6c 6c 20 o: Why not roll
9f00: 74 68 65 20 74 65 6d 70 20 73 63 68 65 6d 61 20 the temp schema
9f10: 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20 73 61 into. ** the sa
9f20: 6d 65 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 me sqliteMalloc(
9f30: 29 20 61 73 20 74 68 65 20 6f 6e 65 20 74 68 61 ) as the one tha
9f40: 74 20 61 6c 6c 6f 63 61 74 65 73 20 74 68 65 20 t allocates the
9f50: 64 61 74 61 62 61 73 65 20 0a 20 20 2a 2a 20 73 database . ** s
9f60: 74 72 75 63 74 75 72 65 3f 0a 20 20 2a 2f 0a 20 tructure?. */.
9f70: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
9f80: 62 2c 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 b, db->aDb[1].pS
9f90: 63 68 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 chema);. sqlite
9fa0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
9fb0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
9fc0: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d magic = SQLITE_M
9fd0: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 AGIC_CLOSED;. s
9fe0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 qlite3_mutex_fre
9ff0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
a000: 61 73 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f 6b assert( db->look
a010: 61 73 69 64 65 2e 6e 4f 75 74 3d 3d 30 20 29 3b aside.nOut==0 );
a020: 20 20 2f 2a 20 46 61 69 6c 73 20 6f 6e 20 61 20 /* Fails on a
a030: 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 lookaside memory
a040: 20 6c 65 61 6b 20 2a 2f 0a 20 20 69 66 28 20 64 leak */. if( d
a050: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 b->lookaside.bMa
a060: 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 lloced ){. sq
a070: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c lite3_free(db->l
a080: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 ookaside.pStart)
a090: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
a0a0: 66 72 65 65 28 64 62 29 3b 0a 7d 0a 0a 2f 2a 0a free(db);.}../*.
a0b0: 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 ** Rollback all
a0c0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 20 database files.
a0d0: 20 49 66 20 74 72 69 70 43 6f 64 65 20 69 73 20 If tripCode is
a0e0: 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 74 not SQLITE_OK, t
a0f0: 68 65 6e 0a 2a 2a 20 61 6e 79 20 77 72 69 74 65 hen.** any write
a100: 20 63 75 72 73 6f 72 73 20 61 72 65 20 69 6e 76 cursors are inv
a110: 61 6c 69 64 61 74 65 64 20 28 22 74 72 69 70 70 alidated ("tripp
a120: 65 64 22 20 2d 20 61 73 20 69 6e 20 22 74 72 69 ed" - as in "tri
a130: 70 70 69 6e 67 20 61 20 63 69 72 63 75 69 74 0a pping a circuit.
a140: 2a 2a 20 62 72 65 61 6b 65 72 22 29 20 61 6e 64 ** breaker") and
a150: 20 6d 61 64 65 20 74 6f 20 72 65 74 75 72 6e 20 made to return
a160: 74 72 69 70 43 6f 64 65 20 69 66 20 74 68 65 72 tripCode if ther
a170: 65 20 61 72 65 20 61 6e 79 20 66 75 72 74 68 65 e are any furthe
a180: 72 0a 2a 2a 20 61 74 74 65 6d 70 74 73 20 74 6f r.** attempts to
a190: 20 75 73 65 20 74 68 61 74 20 63 75 72 73 6f 72 use that cursor
a1a0: 2e 20 20 52 65 61 64 20 63 75 72 73 6f 72 73 20 . Read cursors
a1b0: 72 65 6d 61 69 6e 20 6f 70 65 6e 20 61 6e 64 20 remain open and
a1c0: 76 61 6c 69 64 0a 2a 2a 20 62 75 74 20 61 72 65 valid.** but are
a1d0: 20 22 73 61 76 65 64 22 20 69 6e 20 63 61 73 65 "saved" in case
a1e0: 20 74 68 65 20 74 61 62 6c 65 20 70 61 67 65 73 the table pages
a1f0: 20 61 72 65 20 6d 6f 76 65 64 20 61 72 6f 75 6e are moved aroun
a200: 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 d..*/.void sqlit
a210: 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 e3RollbackAll(sq
a220: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 74 lite3 *db, int t
a230: 72 69 70 43 6f 64 65 29 7b 0a 20 20 69 6e 74 20 ripCode){. int
a240: 69 3b 0a 20 20 69 6e 74 20 69 6e 54 72 61 6e 73 i;. int inTrans
a250: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 73 63 68 65 = 0;. int sche
a260: 6d 61 43 68 61 6e 67 65 3b 0a 20 20 61 73 73 65 maChange;. asse
a270: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
a280: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 x_held(db->mutex
a290: 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 65 ) );. sqlite3Be
a2a0: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
a2b0: 29 3b 0a 0a 20 20 2f 2a 20 4f 62 74 61 69 6e 20 );.. /* Obtain
a2c0: 61 6c 6c 20 62 2d 74 72 65 65 20 6d 75 74 65 78 all b-tree mutex
a2d0: 65 73 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e 67 es before making
a2e0: 20 61 6e 79 20 63 61 6c 6c 73 20 74 6f 20 42 74 any calls to Bt
a2f0: 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 2e 20 0a reeRollback(). .
a300: 20 20 2a 2a 20 54 68 69 73 20 69 73 20 69 6d 70 ** This is imp
a310: 6f 72 74 61 6e 74 20 69 6e 20 63 61 73 65 20 74 ortant in case t
a320: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 he transaction b
a330: 65 69 6e 67 20 72 6f 6c 6c 65 64 20 62 61 63 6b eing rolled back
a340: 20 68 61 73 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 has. ** modifi
a350: 65 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ed the database
a360: 73 63 68 65 6d 61 2e 20 49 66 20 74 68 65 20 62 schema. If the b
a370: 2d 74 72 65 65 20 6d 75 74 65 78 65 73 20 61 72 -tree mutexes ar
a380: 65 20 6e 6f 74 20 74 61 6b 65 6e 0a 20 20 2a 2a e not taken. **
a390: 20 68 65 72 65 2c 20 74 68 65 6e 20 61 6e 6f 74 here, then anot
a3a0: 68 65 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 her shared-cache
a3b0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 69 67 68 connection migh
a3c0: 74 20 73 6e 65 61 6b 20 69 6e 20 62 65 74 77 65 t sneak in betwe
a3d0: 65 6e 0a 20 20 2a 2a 20 74 68 65 20 64 61 74 61 en. ** the data
a3e0: 62 61 73 65 20 72 6f 6c 6c 62 61 63 6b 20 61 6e base rollback an
a3f0: 64 20 73 63 68 65 6d 61 20 72 65 73 65 74 2c 20 d schema reset,
a400: 77 68 69 63 68 20 63 61 6e 20 63 61 75 73 65 20 which can cause
a410: 66 61 6c 73 65 0a 20 20 2a 2a 20 63 6f 72 72 75 false. ** corru
a420: 70 74 69 6f 6e 20 72 65 70 6f 72 74 73 20 69 6e ption reports in
a430: 20 73 6f 6d 65 20 63 61 73 65 73 2e 20 20 2a 2f some cases. */
a440: 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
a450: 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 73 nterAll(db);. s
a460: 63 68 65 6d 61 43 68 61 6e 67 65 20 3d 20 28 64 chemaChange = (d
a470: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 b->flags & SQLIT
a480: 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 29 E_InternChanges)
a490: 21 3d 30 20 26 26 20 64 62 2d 3e 69 6e 69 74 2e !=0 && db->init.
a4a0: 62 75 73 79 3d 3d 30 3b 0a 0a 20 20 66 6f 72 28 busy==0;.. for(
a4b0: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 i=0; i<db->nDb;
a4c0: 69 2b 2b 29 7b 0a 20 20 20 20 42 74 72 65 65 20 i++){. Btree
a4d0: 2a 70 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e *p = db->aDb[i].
a4e0: 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 20 29 pBt;. if( p )
a4f0: 7b 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 {. if( sqli
a500: 74 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e te3BtreeIsInTran
a510: 73 28 70 29 20 29 7b 0a 20 20 20 20 20 20 20 20 s(p) ){.
a520: 69 6e 54 72 61 6e 73 20 3d 20 31 3b 0a 20 20 20 inTrans = 1;.
a530: 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 }. sqlit
a540: 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 e3BtreeRollback(
a550: 70 2c 20 74 72 69 70 43 6f 64 65 2c 20 21 73 63 p, tripCode, !sc
a560: 68 65 6d 61 43 68 61 6e 67 65 29 3b 0a 20 20 20 hemaChange);.
a570: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 }. }. sqlite3
a580: 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 62 29 VtabRollback(db)
a590: 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 ;. sqlite3EndBe
a5a0: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 nignMalloc();..
a5b0: 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 if( (db->flags&
a5c0: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 SQLITE_InternCha
a5d0: 6e 67 65 73 29 21 3d 30 20 26 26 20 64 62 2d 3e nges)!=0 && db->
a5e0: 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a init.busy==0 ){.
a5f0: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 sqlite3Expir
a600: 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 ePreparedStateme
a610: 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 73 71 6c nts(db);. sql
a620: 69 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 ite3ResetAllSche
a630: 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 masOfConnection(
a640: 64 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 db);. }. sqlit
a650: 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 e3BtreeLeaveAll(
a660: 64 62 29 3b 0a 0a 20 20 2f 2a 20 41 6e 79 20 64 db);.. /* Any d
a670: 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 eferred constrai
a680: 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 73 20 68 61 nt violations ha
a690: 76 65 20 6e 6f 77 20 62 65 65 6e 20 72 65 73 6f ve now been reso
a6a0: 6c 76 65 64 2e 20 2a 2f 0a 20 20 64 62 2d 3e 6e lved. */. db->n
a6b0: 44 65 66 65 72 72 65 64 43 6f 6e 73 20 3d 20 30 DeferredCons = 0
a6c0: 3b 0a 20 20 64 62 2d 3e 6e 44 65 66 65 72 72 65 ;. db->nDeferre
a6d0: 64 49 6d 6d 43 6f 6e 73 20 3d 20 30 3b 0a 20 20 dImmCons = 0;.
a6e0: 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 db->flags &= ~SQ
a6f0: 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 3b 0a 0a LITE_DeferFKs;..
a700: 20 20 2f 2a 20 49 66 20 6f 6e 65 20 68 61 73 20 /* If one has
a710: 62 65 65 6e 20 63 6f 6e 66 69 67 75 72 65 64 2c been configured,
a720: 20 69 6e 76 6f 6b 65 20 74 68 65 20 72 6f 6c 6c invoke the roll
a730: 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 6c 6c 62 61 back-hook callba
a740: 63 6b 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e ck */. if( db->
a750: 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 xRollbackCallbac
a760: 6b 20 26 26 20 28 69 6e 54 72 61 6e 73 20 7c 7c k && (inTrans ||
a770: 20 21 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 !db->autoCommit
a780: 29 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 52 6f ) ){. db->xRo
a790: 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 64 llbackCallback(d
a7a0: 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 29 b->pRollbackArg)
a7b0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 ;. }.}../*.** R
a7c0: 65 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 eturn a static s
a7d0: 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 tring containing
a7e0: 20 74 68 65 20 6e 61 6d 65 20 63 6f 72 72 65 73 the name corres
a7f0: 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 65 ponding to the e
a800: 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 73 70 65 rror code.** spe
a810: 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 61 72 cified in the ar
a820: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 20 64 gument..*/.#if d
a830: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4e 45 efined(SQLITE_NE
a840: 45 44 5f 45 52 52 5f 4e 41 4d 45 29 0a 63 6f 6e ED_ERR_NAME).con
a850: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
a860: 45 72 72 4e 61 6d 65 28 69 6e 74 20 72 63 29 7b ErrName(int rc){
a870: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
a880: 4e 61 6d 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 Name = 0;. int
a890: 69 2c 20 6f 72 69 67 52 63 20 3d 20 72 63 3b 0a i, origRc = rc;.
a8a0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 32 20 26 for(i=0; i<2 &
a8b0: 26 20 7a 4e 61 6d 65 3d 3d 30 3b 20 69 2b 2b 2c & zName==0; i++,
a8c0: 20 72 63 20 26 3d 20 30 78 66 66 29 7b 0a 20 20 rc &= 0xff){.
a8d0: 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a switch( rc ){.
a8e0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a8f0: 45 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 20 20 E_OK:
a900: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
a910: 51 4c 49 54 45 5f 4f 4b 22 3b 20 20 20 20 20 20 QLITE_OK";
a920: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
a930: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a940: 54 45 5f 45 52 52 4f 52 3a 20 20 20 20 20 20 20 TE_ERROR:
a950: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
a960: 53 51 4c 49 54 45 5f 45 52 52 4f 52 22 3b 20 20 SQLITE_ERROR";
a970: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
a980: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a990: 49 54 45 5f 49 4e 54 45 52 4e 41 4c 3a 20 20 20 ITE_INTERNAL:
a9a0: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
a9b0: 22 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c "SQLITE_INTERNAL
a9c0: 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 "; brea
a9d0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a9e0: 4c 49 54 45 5f 50 45 52 4d 3a 20 20 20 20 20 20 LITE_PERM:
a9f0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
aa00: 20 22 53 51 4c 49 54 45 5f 50 45 52 4d 22 3b 20 "SQLITE_PERM";
aa10: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
aa20: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
aa30: 51 4c 49 54 45 5f 41 42 4f 52 54 3a 20 20 20 20 QLITE_ABORT:
aa40: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
aa50: 3d 20 22 53 51 4c 49 54 45 5f 41 42 4f 52 54 22 = "SQLITE_ABORT"
aa60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 ; br
aa70: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
aa80: 53 51 4c 49 54 45 5f 41 42 4f 52 54 5f 52 4f 4c SQLITE_ABORT_ROL
aa90: 4c 42 41 43 4b 3a 20 20 20 20 20 7a 4e 61 6d 65 LBACK: zName
aaa0: 20 3d 20 22 53 51 4c 49 54 45 5f 41 42 4f 52 54 = "SQLITE_ABORT
aab0: 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 20 20 20 62 _ROLLBACK"; b
aac0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
aad0: 20 53 51 4c 49 54 45 5f 42 55 53 59 3a 20 20 20 SQLITE_BUSY:
aae0: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
aaf0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 42 55 53 59 e = "SQLITE_BUSY
ab00: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
ab10: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
ab20: 65 20 53 51 4c 49 54 45 5f 42 55 53 59 5f 52 45 e SQLITE_BUSY_RE
ab30: 43 4f 56 45 52 59 3a 20 20 20 20 20 20 7a 4e 61 COVERY: zNa
ab40: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 42 55 53 me = "SQLITE_BUS
ab50: 59 5f 52 45 43 4f 56 45 52 59 22 3b 20 20 20 20 Y_RECOVERY";
ab60: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
ab70: 73 65 20 53 51 4c 49 54 45 5f 42 55 53 59 5f 53 se SQLITE_BUSY_S
ab80: 4e 41 50 53 48 4f 54 3a 20 20 20 20 20 20 7a 4e NAPSHOT: zN
ab90: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 42 55 ame = "SQLITE_BU
aba0: 53 59 5f 53 4e 41 50 53 48 4f 54 22 3b 20 20 20 SY_SNAPSHOT";
abb0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
abc0: 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 ase SQLITE_LOCKE
abd0: 44 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a D: z
abe0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4c Name = "SQLITE_L
abf0: 4f 43 4b 45 44 22 3b 20 20 20 20 20 20 20 20 20 OCKED";
ac00: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
ac10: 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b case SQLITE_LOCK
ac20: 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 3a 20 ED_SHAREDCACHE:
ac30: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
ac40: 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 LOCKED_SHAREDCAC
ac50: 48 45 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 HE";break;.
ac60: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d case SQLITE_NOM
ac70: 45 4d 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 EM:
ac80: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
ac90: 5f 4e 4f 4d 45 4d 22 3b 20 20 20 20 20 20 20 20 _NOMEM";
aca0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
acb0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45 case SQLITE_RE
acc0: 41 44 4f 4e 4c 59 3a 20 20 20 20 20 20 20 20 20 ADONLY:
acd0: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
ace0: 45 5f 52 45 41 44 4f 4e 4c 59 22 3b 20 20 20 20 E_READONLY";
acf0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
ad00: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 case SQLITE_R
ad10: 45 41 44 4f 4e 4c 59 5f 52 45 43 4f 56 45 52 59 EADONLY_RECOVERY
ad20: 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 : zName = "SQLI
ad30: 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 45 43 4f TE_READONLY_RECO
ad40: 56 45 52 59 22 3b 20 62 72 65 61 6b 3b 0a 20 20 VERY"; break;.
ad50: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
ad60: 52 45 41 44 4f 4e 4c 59 5f 43 41 4e 54 4c 4f 43 READONLY_CANTLOC
ad70: 4b 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c K: zName = "SQL
ad80: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 41 4e ITE_READONLY_CAN
ad90: 54 4c 4f 43 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 TLOCK"; break;.
ada0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
adb0: 5f 52 45 41 44 4f 4e 4c 59 5f 52 4f 4c 4c 42 41 _READONLY_ROLLBA
adc0: 43 4b 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 CK: zName = "SQ
add0: 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 4f LITE_READONLY_RO
ade0: 4c 4c 42 41 43 4b 22 3b 20 62 72 65 61 6b 3b 0a LLBACK"; break;.
adf0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
ae00: 45 5f 52 45 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 E_READONLY_DBMOV
ae10: 45 44 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 ED: zName = "S
ae20: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 44 QLITE_READONLY_D
ae30: 42 4d 4f 56 45 44 22 3b 20 20 62 72 65 61 6b 3b BMOVED"; break;
ae40: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
ae50: 54 45 5f 49 4e 54 45 52 52 55 50 54 3a 20 20 20 TE_INTERRUPT:
ae60: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
ae70: 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 SQLITE_INTERRUPT
ae80: 22 3b 20 20 20 20 20 20 20 20 20 62 72 65 61 6b "; break
ae90: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
aea0: 49 54 45 5f 49 4f 45 52 52 3a 20 20 20 20 20 20 ITE_IOERR:
aeb0: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
aec0: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 22 3b 20 "SQLITE_IOERR";
aed0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
aee0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
aef0: 4c 49 54 45 5f 49 4f 45 52 52 5f 52 45 41 44 3a LITE_IOERR_READ:
af00: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
af10: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 "SQLITE_IOERR_R
af20: 45 41 44 22 3b 20 20 20 20 20 20 20 20 62 72 65 EAD"; bre
af30: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
af40: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 QLITE_IOERR_SHOR
af50: 54 5f 52 45 41 44 3a 20 20 20 7a 4e 61 6d 65 20 T_READ: zName
af60: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
af70: 53 48 4f 52 54 5f 52 45 41 44 22 3b 20 20 62 72 SHORT_READ"; br
af80: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
af90: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 57 52 49 SQLITE_IOERR_WRI
afa0: 54 45 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 TE: zName
afb0: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
afc0: 5f 57 52 49 54 45 22 3b 20 20 20 20 20 20 20 62 _WRITE"; b
afd0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
afe0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 SQLITE_IOERR_FS
aff0: 59 4e 43 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d YNC: zNam
b000: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
b010: 52 5f 46 53 59 4e 43 22 3b 20 20 20 20 20 20 20 R_FSYNC";
b020: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b030: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 e SQLITE_IOERR_D
b040: 49 52 5f 46 53 59 4e 43 3a 20 20 20 20 7a 4e 61 IR_FSYNC: zNa
b050: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
b060: 52 52 5f 44 49 52 5f 46 53 59 4e 43 22 3b 20 20 RR_DIR_FSYNC";
b070: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
b080: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
b090: 54 52 55 4e 43 41 54 45 3a 20 20 20 20 20 7a 4e TRUNCATE: zN
b0a0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
b0b0: 45 52 52 5f 54 52 55 4e 43 41 54 45 22 3b 20 20 ERR_TRUNCATE";
b0c0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
b0d0: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
b0e0: 5f 46 53 54 41 54 3a 20 20 20 20 20 20 20 20 7a _FSTAT: z
b0f0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
b100: 4f 45 52 52 5f 46 53 54 41 54 22 3b 20 20 20 20 OERR_FSTAT";
b110: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
b120: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
b130: 52 5f 55 4e 4c 4f 43 4b 3a 20 20 20 20 20 20 20 R_UNLOCK:
b140: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b150: 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 22 3b 20 20 IOERR_UNLOCK";
b160: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
b170: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
b180: 52 52 5f 52 44 4c 4f 43 4b 3a 20 20 20 20 20 20 RR_RDLOCK:
b190: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b1a0: 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b 22 3b 20 _IOERR_RDLOCK";
b1b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b1c0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
b1d0: 45 52 52 5f 44 45 4c 45 54 45 3a 20 20 20 20 20 ERR_DELETE:
b1e0: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b1f0: 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 22 3b E_IOERR_DELETE";
b200: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b210: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
b220: 4f 45 52 52 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 OERR_NOMEM:
b230: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b240: 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 22 3b TE_IOERR_NOMEM";
b250: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b260: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b270: 49 4f 45 52 52 5f 41 43 43 45 53 53 3a 20 20 20 IOERR_ACCESS:
b280: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b290: 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 45 53 53 ITE_IOERR_ACCESS
b2a0: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 "; break;.
b2b0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b2c0: 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 _IOERR_CHECKRESE
b2d0: 52 56 45 44 4c 4f 43 4b 3a 0a 20 20 20 20 20 20 RVEDLOCK:.
b2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b2f0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
b300: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
b310: 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 CHECKRESERVEDLOC
b320: 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 K"; break;.
b330: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
b340: 52 52 5f 4c 4f 43 4b 3a 20 20 20 20 20 20 20 20 RR_LOCK:
b350: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b360: 5f 49 4f 45 52 52 5f 4c 4f 43 4b 22 3b 20 20 20 _IOERR_LOCK";
b370: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b380: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
b390: 45 52 52 5f 43 4c 4f 53 45 3a 20 20 20 20 20 20 ERR_CLOSE:
b3a0: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b3b0: 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 22 3b 20 E_IOERR_CLOSE";
b3c0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b3d0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
b3e0: 4f 45 52 52 5f 44 49 52 5f 43 4c 4f 53 45 3a 20 OERR_DIR_CLOSE:
b3f0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b400: 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 43 4c 4f TE_IOERR_DIR_CLO
b410: 53 45 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 SE"; break;.
b420: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b430: 49 4f 45 52 52 5f 53 48 4d 4f 50 45 4e 3a 20 20 IOERR_SHMOPEN:
b440: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b450: 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4f 50 45 ITE_IOERR_SHMOPE
b460: 4e 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 N"; break;.
b470: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b480: 5f 49 4f 45 52 52 5f 53 48 4d 53 49 5a 45 3a 20 _IOERR_SHMSIZE:
b490: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b4a0: 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 53 49 LITE_IOERR_SHMSI
b4b0: 5a 45 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a ZE"; break;.
b4c0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b4d0: 45 5f 49 4f 45 52 52 5f 53 48 4d 4c 4f 43 4b 3a E_IOERR_SHMLOCK:
b4e0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
b4f0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4c QLITE_IOERR_SHML
b500: 4f 43 4b 22 3b 20 20 20 20 20 62 72 65 61 6b 3b OCK"; break;
b510: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b520: 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4d 41 50 3a TE_IOERR_SHMMAP:
b530: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
b540: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d SQLITE_IOERR_SHM
b550: 4d 41 50 22 3b 20 20 20 20 20 20 62 72 65 61 6b MAP"; break
b560: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b570: 49 54 45 5f 49 4f 45 52 52 5f 53 45 45 4b 3a 20 ITE_IOERR_SEEK:
b580: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
b590: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 45 "SQLITE_IOERR_SE
b5a0: 45 4b 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 EK"; brea
b5b0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b5c0: 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 LITE_IOERR_DELET
b5d0: 45 5f 4e 4f 45 4e 54 3a 20 7a 4e 61 6d 65 20 3d E_NOENT: zName =
b5e0: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 "SQLITE_IOERR_D
b5f0: 45 4c 45 54 45 5f 4e 4f 45 4e 54 22 3b 62 72 65 ELETE_NOENT";bre
b600: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
b610: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4d 4d 41 50 QLITE_IOERR_MMAP
b620: 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 : zName
b630: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
b640: 4d 4d 41 50 22 3b 20 20 20 20 20 20 20 20 62 72 MMAP"; br
b650: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
b660: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 47 45 54 SQLITE_IOERR_GET
b670: 54 45 4d 50 50 41 54 48 3a 20 20 7a 4e 61 6d 65 TEMPPATH: zName
b680: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
b690: 5f 47 45 54 54 45 4d 50 50 41 54 48 22 3b 20 62 _GETTEMPPATH"; b
b6a0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
b6b0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4f SQLITE_IOERR_CO
b6c0: 4e 56 50 41 54 48 3a 20 20 20 20 20 7a 4e 61 6d NVPATH: zNam
b6d0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
b6e0: 52 5f 43 4f 4e 56 50 41 54 48 22 3b 20 20 20 20 R_CONVPATH";
b6f0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b700: 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 e SQLITE_CORRUPT
b710: 3a 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 : zNa
b720: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 52 me = "SQLITE_COR
b730: 52 55 50 54 22 3b 20 20 20 20 20 20 20 20 20 20 RUPT";
b740: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
b750: 73 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 se SQLITE_CORRUP
b760: 54 5f 56 54 41 42 3a 20 20 20 20 20 20 20 7a 4e T_VTAB: zN
b770: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f ame = "SQLITE_CO
b780: 52 52 55 50 54 5f 56 54 41 42 22 3b 20 20 20 20 RRUPT_VTAB";
b790: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
b7a0: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f ase SQLITE_NOTFO
b7b0: 55 4e 44 3a 20 20 20 20 20 20 20 20 20 20 20 7a UND: z
b7c0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e Name = "SQLITE_N
b7d0: 4f 54 46 4f 55 4e 44 22 3b 20 20 20 20 20 20 20 OTFOUND";
b7e0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
b7f0: 63 61 73 65 20 53 51 4c 49 54 45 5f 46 55 4c 4c case SQLITE_FULL
b800: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :
b810: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b820: 46 55 4c 4c 22 3b 20 20 20 20 20 20 20 20 20 20 FULL";
b830: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
b840: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e case SQLITE_CAN
b850: 54 4f 50 45 4e 3a 20 20 20 20 20 20 20 20 20 20 TOPEN:
b860: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b870: 5f 43 41 4e 54 4f 50 45 4e 22 3b 20 20 20 20 20 _CANTOPEN";
b880: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b890: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 41 case SQLITE_CA
b8a0: 4e 54 4f 50 45 4e 5f 4e 4f 54 45 4d 50 44 49 52 NTOPEN_NOTEMPDIR
b8b0: 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 : zName = "SQLIT
b8c0: 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 45 4d E_CANTOPEN_NOTEM
b8d0: 50 44 49 52 22 3b 62 72 65 61 6b 3b 0a 20 20 20 PDIR";break;.
b8e0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
b8f0: 41 4e 54 4f 50 45 4e 5f 49 53 44 49 52 3a 20 20 ANTOPEN_ISDIR:
b900: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b910: 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 44 49 TE_CANTOPEN_ISDI
b920: 52 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 R"; break;.
b930: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b940: 43 41 4e 54 4f 50 45 4e 5f 46 55 4c 4c 50 41 54 CANTOPEN_FULLPAT
b950: 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c H: zName = "SQL
b960: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 55 4c ITE_CANTOPEN_FUL
b970: 4c 50 41 54 48 22 3b 20 62 72 65 61 6b 3b 0a 20 LPATH"; break;.
b980: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b990: 5f 43 41 4e 54 4f 50 45 4e 5f 43 4f 4e 56 50 41 _CANTOPEN_CONVPA
b9a0: 54 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 TH: zName = "SQ
b9b0: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 43 4f LITE_CANTOPEN_CO
b9c0: 4e 56 50 41 54 48 22 3b 20 62 72 65 61 6b 3b 0a NVPATH"; break;.
b9d0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b9e0: 45 5f 50 52 4f 54 4f 43 4f 4c 3a 20 20 20 20 20 E_PROTOCOL:
b9f0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
ba00: 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 22 3b QLITE_PROTOCOL";
ba10: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
ba20: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
ba30: 54 45 5f 45 4d 50 54 59 3a 20 20 20 20 20 20 20 TE_EMPTY:
ba40: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
ba50: 53 51 4c 49 54 45 5f 45 4d 50 54 59 22 3b 20 20 SQLITE_EMPTY";
ba60: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
ba70: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
ba80: 49 54 45 5f 53 43 48 45 4d 41 3a 20 20 20 20 20 ITE_SCHEMA:
ba90: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
baa0: 22 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 22 3b "SQLITE_SCHEMA";
bab0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
bac0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
bad0: 4c 49 54 45 5f 54 4f 4f 42 49 47 3a 20 20 20 20 LITE_TOOBIG:
bae0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
baf0: 20 22 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 22 "SQLITE_TOOBIG"
bb00: 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 ; bre
bb10: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
bb20: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
bb30: 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 : zName
bb40: 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 = "SQLITE_CONSTR
bb50: 41 49 4e 54 22 3b 20 20 20 20 20 20 20 20 62 72 AINT"; br
bb60: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
bb70: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
bb80: 54 5f 55 4e 49 51 55 45 3a 20 20 7a 4e 61 6d 65 T_UNIQUE: zName
bb90: 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 = "SQLITE_CONST
bba0: 52 41 49 4e 54 5f 55 4e 49 51 55 45 22 3b 20 62 RAINT_UNIQUE"; b
bbb0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
bbc0: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
bbd0: 4e 54 5f 54 52 49 47 47 45 52 3a 20 7a 4e 61 6d NT_TRIGGER: zNam
bbe0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
bbf0: 54 52 41 49 4e 54 5f 54 52 49 47 47 45 52 22 3b TRAINT_TRIGGER";
bc00: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
bc10: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
bc20: 49 4e 54 5f 46 4f 52 45 49 47 4e 4b 45 59 3a 0a INT_FOREIGNKEY:.
bc30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bc40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bc50: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
bc60: 43 4f 4e 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 CONSTRAINT_FOREI
bc70: 47 4e 4b 45 59 22 3b 20 20 20 62 72 65 61 6b 3b GNKEY"; break;
bc80: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
bc90: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 43 48 TE_CONSTRAINT_CH
bca0: 45 43 4b 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 22 ECK: zName = "
bcb0: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
bcc0: 54 5f 43 48 45 43 4b 22 3b 20 20 62 72 65 61 6b T_CHECK"; break
bcd0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
bce0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 50 ITE_CONSTRAINT_P
bcf0: 52 49 4d 41 52 59 4b 45 59 3a 0a 20 20 20 20 20 RIMARYKEY:.
bd00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bd10: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
bd20: 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 = "SQLITE_CONST
bd30: 52 41 49 4e 54 5f 50 52 49 4d 41 52 59 4b 45 59 RAINT_PRIMARYKEY
bd40: 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 "; break;.
bd50: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
bd60: 4e 53 54 52 41 49 4e 54 5f 4e 4f 54 4e 55 4c 4c NSTRAINT_NOTNULL
bd70: 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 : zName = "SQLIT
bd80: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4e 4f 54 E_CONSTRAINT_NOT
bd90: 4e 55 4c 4c 22 3b 62 72 65 61 6b 3b 0a 20 20 20 NULL";break;.
bda0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
bdb0: 4f 4e 53 54 52 41 49 4e 54 5f 43 4f 4d 4d 49 54 ONSTRAINT_COMMIT
bdc0: 48 4f 4f 4b 3a 0a 20 20 20 20 20 20 20 20 20 20 HOOK:.
bdd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bde0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
bdf0: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
be00: 5f 43 4f 4d 4d 49 54 48 4f 4f 4b 22 3b 20 20 20 _COMMITHOOK";
be10: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
be20: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
be30: 49 4e 54 5f 56 54 41 42 3a 20 20 20 20 7a 4e 61 INT_VTAB: zNa
be40: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e me = "SQLITE_CON
be50: 53 54 52 41 49 4e 54 5f 56 54 41 42 22 3b 20 20 STRAINT_VTAB";
be60: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
be70: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 se SQLITE_CONSTR
be80: 41 49 4e 54 5f 46 55 4e 43 54 49 4f 4e 3a 0a 20 AINT_FUNCTION:.
be90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bea0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a z
beb0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
bec0: 4f 4e 53 54 52 41 49 4e 54 5f 46 55 4e 43 54 49 ONSTRAINT_FUNCTI
bed0: 4f 4e 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a ON"; break;.
bee0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
bef0: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 52 4f 57 E_CONSTRAINT_ROW
bf00: 49 44 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 ID: zName = "S
bf10: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
bf20: 5f 52 4f 57 49 44 22 3b 20 20 62 72 65 61 6b 3b _ROWID"; break;
bf30: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
bf40: 54 45 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20 20 TE_MISMATCH:
bf50: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
bf60: 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 48 22 SQLITE_MISMATCH"
bf70: 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b ; break
bf80: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
bf90: 49 54 45 5f 4d 49 53 55 53 45 3a 20 20 20 20 20 ITE_MISUSE:
bfa0: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
bfb0: 22 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 22 3b "SQLITE_MISUSE";
bfc0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
bfd0: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
bfe0: 4c 49 54 45 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 LITE_NOLFS:
bff0: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
c000: 20 22 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 22 3b "SQLITE_NOLFS";
c010: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
c020: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
c030: 51 4c 49 54 45 5f 41 55 54 48 3a 20 20 20 20 20 QLITE_AUTH:
c040: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
c050: 3d 20 22 53 51 4c 49 54 45 5f 41 55 54 48 22 3b = "SQLITE_AUTH";
c060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 br
c070: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
c080: 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 3a 20 20 SQLITE_FORMAT:
c090: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
c0a0: 20 3d 20 22 53 51 4c 49 54 45 5f 46 4f 52 4d 41 = "SQLITE_FORMA
c0b0: 54 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 T"; b
c0c0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
c0d0: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 3a 20 20 SQLITE_RANGE:
c0e0: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
c0f0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 41 4e 47 e = "SQLITE_RANG
c100: 45 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 E";
c110: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
c120: 65 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3a e SQLITE_NOTADB:
c130: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
c140: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 54 me = "SQLITE_NOT
c150: 41 44 42 22 3b 20 20 20 20 20 20 20 20 20 20 20 ADB";
c160: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
c170: 73 65 20 53 51 4c 49 54 45 5f 52 4f 57 3a 20 20 se SQLITE_ROW:
c180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
c190: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 4f ame = "SQLITE_RO
c1a0: 57 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 W";
c1b0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
c1c0: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 49 43 ase SQLITE_NOTIC
c1d0: 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a E: z
c1e0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e Name = "SQLITE_N
c1f0: 4f 54 49 43 45 22 3b 20 20 20 20 20 20 20 20 20 OTICE";
c200: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
c210: 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 49 case SQLITE_NOTI
c220: 43 45 5f 52 45 43 4f 56 45 52 5f 57 41 4c 3a 20 CE_RECOVER_WAL:
c230: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
c240: 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 57 NOTICE_RECOVER_W
c250: 41 4c 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 AL";break;.
c260: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 54 case SQLITE_NOT
c270: 49 43 45 5f 52 45 43 4f 56 45 52 5f 52 4f 4c 4c ICE_RECOVER_ROLL
c280: 42 41 43 4b 3a 0a 20 20 20 20 20 20 20 20 20 20 BACK:.
c290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c2a0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
c2b0: 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 QLITE_NOTICE_REC
c2c0: 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 OVER_ROLLBACK";
c2d0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
c2e0: 65 20 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 e SQLITE_WARNING
c2f0: 3a 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 : zNa
c300: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 57 41 52 me = "SQLITE_WAR
c310: 4e 49 4e 47 22 3b 20 20 20 20 20 20 20 20 20 20 NING";
c320: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
c330: 73 65 20 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e se SQLITE_WARNIN
c340: 47 5f 41 55 54 4f 49 4e 44 45 58 3a 20 20 7a 4e G_AUTOINDEX: zN
c350: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 57 41 ame = "SQLITE_WA
c360: 52 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 58 22 RNING_AUTOINDEX"
c370: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 ; break;. c
c380: 61 73 65 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3a ase SQLITE_DONE:
c390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a z
c3a0: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 44 Name = "SQLITE_D
c3b0: 4f 4e 45 22 3b 20 20 20 20 20 20 20 20 20 20 20 ONE";
c3c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
c3d0: 20 20 7d 0a 20 20 69 66 28 20 7a 4e 61 6d 65 3d }. if( zName=
c3e0: 3d 30 20 29 7b 0a 20 20 20 20 73 74 61 74 69 63 =0 ){. static
c3f0: 20 63 68 61 72 20 7a 42 75 66 5b 35 30 5d 3b 0a char zBuf[50];.
c400: 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 sqlite3_snpr
c410: 69 6e 74 66 28 73 69 7a 65 6f 66 28 7a 42 75 66 intf(sizeof(zBuf
c420: 29 2c 20 7a 42 75 66 2c 20 22 53 51 4c 49 54 45 ), zBuf, "SQLITE
c430: 5f 55 4e 4b 4e 4f 57 4e 28 25 64 29 22 2c 20 6f _UNKNOWN(%d)", o
c440: 72 69 67 52 63 29 3b 0a 20 20 20 20 7a 4e 61 6d rigRc);. zNam
c450: 65 20 3d 20 7a 42 75 66 3b 0a 20 20 7d 0a 20 20 e = zBuf;. }.
c460: 72 65 74 75 72 6e 20 7a 4e 61 6d 65 3b 0a 7d 0a return zName;.}.
c470: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 #endif../*.** Re
c480: 74 75 72 6e 20 61 20 73 74 61 74 69 63 20 73 74 turn a static st
c490: 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69 ring that descri
c4a0: 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20 bes the kind of
c4b0: 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20 error specified
c4c0: 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65 in the.** argume
c4d0: 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 nt..*/.const cha
c4e0: 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 74 72 r *sqlite3ErrStr
c4f0: 28 69 6e 74 20 72 63 29 7b 0a 20 20 73 74 61 74 (int rc){. stat
c500: 69 63 20 63 6f 6e 73 74 20 63 68 61 72 2a 20 63 ic const char* c
c510: 6f 6e 73 74 20 61 4d 73 67 5b 5d 20 3d 20 7b 0a onst aMsg[] = {.
c520: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4b /* SQLITE_OK
c530: 20 20 20 20 20 20 20 20 20 20 2a 2f 20 22 6e 6f */ "no
c540: 74 20 61 6e 20 65 72 72 6f 72 22 2c 0a 20 20 20 t an error",.
c550: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 /* SQLITE_ERROR
c560: 20 20 20 20 20 20 20 2a 2f 20 22 53 51 4c 20 6c */ "SQL l
c570: 6f 67 69 63 20 65 72 72 6f 72 22 2c 0a 20 20 20 ogic error",.
c580: 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 /* SQLITE_INTER
c590: 4e 41 4c 20 20 20 20 2a 2f 20 30 2c 0a 20 20 20 NAL */ 0,.
c5a0: 20 2f 2a 20 53 51 4c 49 54 45 5f 50 45 52 4d 20 /* SQLITE_PERM
c5b0: 20 20 20 20 20 20 20 2a 2f 20 22 61 63 63 65 73 */ "acces
c5c0: 73 20 70 65 72 6d 69 73 73 69 6f 6e 20 64 65 6e s permission den
c5d0: 69 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ied",. /* SQL
c5e0: 49 54 45 5f 41 42 4f 52 54 20 20 20 20 20 20 20 ITE_ABORT
c5f0: 2a 2f 20 22 71 75 65 72 79 20 61 62 6f 72 74 65 */ "query aborte
c600: 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 d",. /* SQLIT
c610: 45 5f 42 55 53 59 20 20 20 20 20 20 20 20 2a 2f E_BUSY */
c620: 20 22 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f "database is lo
c630: 63 6b 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 cked",. /* SQ
c640: 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 20 20 20 20 LITE_LOCKED
c650: 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 74 61 */ "database ta
c660: 62 6c 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0a ble is locked",.
c670: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f /* SQLITE_NO
c680: 4d 45 4d 20 20 20 20 20 20 20 2a 2f 20 22 6f 75 MEM */ "ou
c690: 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 0a 20 20 t of memory",.
c6a0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 52 45 41 44 /* SQLITE_READ
c6b0: 4f 4e 4c 59 20 20 20 20 2a 2f 20 22 61 74 74 65 ONLY */ "atte
c6c0: 6d 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72 mpt to write a r
c6d0: 65 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 eadonly database
c6e0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
c6f0: 5f 49 4e 54 45 52 52 55 50 54 20 20 20 2a 2f 20 _INTERRUPT */
c700: 22 69 6e 74 65 72 72 75 70 74 65 64 22 2c 0a 20 "interrupted",.
c710: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4f 45 /* SQLITE_IOE
c720: 52 52 20 20 20 20 20 20 20 2a 2f 20 22 64 69 73 RR */ "dis
c730: 6b 20 49 2f 4f 20 65 72 72 6f 72 22 2c 0a 20 20 k I/O error",.
c740: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 /* SQLITE_CORR
c750: 55 50 54 20 20 20 20 20 2a 2f 20 22 64 61 74 61 UPT */ "data
c760: 62 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20 base disk image
c770: 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22 2c 0a 20 is malformed",.
c780: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 /* SQLITE_NOT
c790: 46 4f 55 4e 44 20 20 20 20 2a 2f 20 22 75 6e 6b FOUND */ "unk
c7a0: 6e 6f 77 6e 20 6f 70 65 72 61 74 69 6f 6e 22 2c nown operation",
c7b0: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 46 . /* SQLITE_F
c7c0: 55 4c 4c 20 20 20 20 20 20 20 20 2a 2f 20 22 64 ULL */ "d
c7d0: 61 74 61 62 61 73 65 20 6f 72 20 64 69 73 6b 20 atabase or disk
c7e0: 69 73 20 66 75 6c 6c 22 2c 0a 20 20 20 20 2f 2a is full",. /*
c7f0: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
c800: 20 20 20 20 2a 2f 20 22 75 6e 61 62 6c 65 20 74 */ "unable t
c810: 6f 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 o open database
c820: 66 69 6c 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 file",. /* SQ
c830: 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 20 20 20 LITE_PROTOCOL
c840: 20 2a 2f 20 22 6c 6f 63 6b 69 6e 67 20 70 72 6f */ "locking pro
c850: 74 6f 63 6f 6c 22 2c 0a 20 20 20 20 2f 2a 20 53 tocol",. /* S
c860: 51 4c 49 54 45 5f 45 4d 50 54 59 20 20 20 20 20 QLITE_EMPTY
c870: 20 20 2a 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 53 */ 0,. /* 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 62 61 64 USE */ "bad
c970: 20 70 61 72 61 6d 65 74 65 72 20 6f 72 20 6f 74 parameter or ot
c980: 68 65 72 20 41 50 49 20 6d 69 73 75 73 65 22 2c her API misuse",
c990: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
c9a0: 49 53 41 42 4c 45 5f 4c 46 53 0a 20 20 20 20 2f ISABLE_LFS. /
c9b0: 2a 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 20 * SQLITE_NOLFS
c9c0: 20 20 20 20 20 2a 2f 20 22 6c 61 72 67 65 20 66 */ "large f
c9d0: 69 6c 65 20 73 75 70 70 6f 72 74 20 69 73 20 64 ile support is d
c9e0: 69 73 61 62 6c 65 64 22 2c 0a 23 65 6c 73 65 0a isabled",.#else.
c9f0: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f /* SQLITE_NO
ca00: 4c 46 53 20 20 20 20 20 20 20 2a 2f 20 30 2c 0a LFS */ 0,.
ca10: 23 65 6e 64 69 66 0a 20 20 20 20 2f 2a 20 53 51 #endif. /* SQ
ca20: 4c 49 54 45 5f 41 55 54 48 20 20 20 20 20 20 20 LITE_AUTH
ca30: 20 2a 2f 20 22 61 75 74 68 6f 72 69 7a 61 74 69 */ "authorizati
ca40: 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 on denied",.
ca50: 2f 2a 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 /* SQLITE_FORMAT
ca60: 20 20 20 20 20 20 2a 2f 20 30 2c 0a 20 20 20 20 */ 0,.
ca70: 2f 2a 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 /* SQLITE_RANGE
ca80: 20 20 20 20 20 20 2a 2f 20 22 63 6f 6c 75 6d 6e */ "column
ca90: 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20 72 61 index out of ra
caa0: 6e 67 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c nge",. /* SQL
cab0: 49 54 45 5f 4e 4f 54 41 44 42 20 20 20 20 20 20 ITE_NOTADB
cac0: 2a 2f 20 22 66 69 6c 65 20 69 73 20 6e 6f 74 20 */ "file is not
cad0: 61 20 64 61 74 61 62 61 73 65 22 2c 0a 20 20 7d a database",. }
cae0: 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ;. const char *
caf0: 7a 45 72 72 20 3d 20 22 75 6e 6b 6e 6f 77 6e 20 zErr = "unknown
cb00: 65 72 72 6f 72 22 3b 0a 20 20 73 77 69 74 63 68 error";. switch
cb10: 28 20 72 63 20 29 7b 0a 20 20 20 20 63 61 73 65 ( rc ){. case
cb20: 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 5f 52 4f SQLITE_ABORT_RO
cb30: 4c 4c 42 41 43 4b 3a 20 7b 0a 20 20 20 20 20 20 LLBACK: {.
cb40: 7a 45 72 72 20 3d 20 22 61 62 6f 72 74 20 64 75 zErr = "abort du
cb50: 65 20 74 6f 20 52 4f 4c 4c 42 41 43 4b 22 3b 0a e to ROLLBACK";.
cb60: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
cb70: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 }. default:
cb80: 7b 0a 20 20 20 20 20 20 72 63 20 26 3d 20 30 78 {. rc &= 0x
cb90: 66 66 3b 0a 20 20 20 20 20 20 69 66 28 20 41 4c ff;. if( AL
cba0: 57 41 59 53 28 72 63 3e 3d 30 29 20 26 26 20 72 WAYS(rc>=0) && r
cbb0: 63 3c 41 72 72 61 79 53 69 7a 65 28 61 4d 73 67 c<ArraySize(aMsg
cbc0: 29 20 26 26 20 61 4d 73 67 5b 72 63 5d 21 3d 30 ) && aMsg[rc]!=0
cbd0: 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 45 72 72 ){. zErr
cbe0: 20 3d 20 61 4d 73 67 5b 72 63 5d 3b 0a 20 20 20 = aMsg[rc];.
cbf0: 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b }. break
cc00: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
cc10: 74 75 72 6e 20 7a 45 72 72 3b 0a 7d 0a 0a 2f 2a turn zErr;.}../*
cc20: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
cc30: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 20 62 75 implements a bu
cc40: 73 79 20 63 61 6c 6c 62 61 63 6b 20 74 68 61 74 sy callback that
cc50: 20 73 6c 65 65 70 73 20 61 6e 64 20 74 72 69 65 sleeps and trie
cc60: 73 0a 2a 2a 20 61 67 61 69 6e 20 75 6e 74 69 6c s.** again until
cc70: 20 61 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 a timeout value
cc80: 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 54 68 is reached. Th
cc90: 65 20 74 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 e timeout value
cca0: 69 73 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 is.** an integer
ccb0: 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c 69 number of milli
ccc0: 73 65 63 6f 6e 64 73 20 70 61 73 73 65 64 20 69 seconds passed i
ccd0: 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a n as the first.*
cce0: 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 * argument..*/.s
ccf0: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 tatic int sqlite
cd00: 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 DefaultBusyCallb
cd10: 61 63 6b 28 0a 20 76 6f 69 64 20 2a 70 74 72 2c ack(. void *ptr,
cd20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
cd30: 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 * Database conne
cd40: 63 74 69 6f 6e 20 2a 2f 0a 20 69 6e 74 20 63 6f ction */. int co
cd50: 75 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20 unt
cd60: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
cd70: 74 69 6d 65 73 20 74 61 62 6c 65 20 68 61 73 20 times table has
cd80: 62 65 65 6e 20 62 75 73 79 20 2a 2f 0a 29 7b 0a been busy */.){.
cd90: 23 69 66 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 #if SQLITE_OS_WI
cda0: 4e 20 7c 7c 20 48 41 56 45 5f 55 53 4c 45 45 50 N || HAVE_USLEEP
cdb0: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 . static const
cdc0: 75 38 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 u8 delays[] =.
cdd0: 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 30 { 1, 2, 5, 10
cde0: 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 35 , 15, 20, 25, 25
cdf0: 2c 20 20 32 35 2c 20 20 35 30 2c 20 20 35 30 2c , 25, 50, 50,
ce00: 20 31 30 30 20 7d 3b 0a 20 20 73 74 61 74 69 63 100 };. static
ce10: 20 63 6f 6e 73 74 20 75 38 20 74 6f 74 61 6c 73 const u8 totals
ce20: 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 31 [] =. { 0, 1
ce30: 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 2c , 3, 8, 18, 33,
ce40: 20 35 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 32 53, 78, 103, 12
ce50: 38 2c 20 31 37 38 2c 20 32 32 38 20 7d 3b 0a 23 8, 178, 228 };.#
ce60: 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 41 define NDELAY A
ce70: 72 72 61 79 53 69 7a 65 28 64 65 6c 61 79 73 29 rraySize(delays)
ce80: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d . sqlite3 *db =
ce90: 20 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 3b (sqlite3 *)ptr;
cea0: 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d . int timeout =
ceb0: 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 db->busyTimeout
cec0: 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c 20 70 ;. int delay, p
ced0: 72 69 6f 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 rior;.. assert(
cee0: 20 63 6f 75 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 count>=0 );. i
cef0: 66 28 20 63 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 f( count < NDELA
cf00: 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d Y ){. delay =
cf10: 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a delays[count];.
cf20: 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 prior = tota
cf30: 6c 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c ls[count];. }el
cf40: 73 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 se{. delay =
cf50: 64 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d 31 5d delays[NDELAY-1]
cf60: 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f ;. prior = to
cf70: 74 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b tals[NDELAY-1] +
cf80: 20 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d 28 4e delay*(count-(N
cf90: 44 45 4c 41 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 DELAY-1));. }.
cfa0: 20 69 66 28 20 70 72 69 6f 72 20 2b 20 64 65 6c if( prior + del
cfb0: 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a ay > timeout ){.
cfc0: 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 delay = time
cfd0: 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20 20 20 out - prior;.
cfe0: 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 20 29 20 if( delay<=0 )
cff0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 return 0;. }.
d000: 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 64 sqlite3OsSleep(d
d010: 62 2d 3e 70 56 66 73 2c 20 64 65 6c 61 79 2a 31 b->pVfs, delay*1
d020: 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 000);. return 1
d030: 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c 69 74 65 ;.#else. sqlite
d040: 33 20 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 33 3 *db = (sqlite3
d050: 20 2a 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 69 *)ptr;. int ti
d060: 6d 65 6f 75 74 20 3d 20 28 28 73 71 6c 69 74 65 meout = ((sqlite
d070: 33 20 2a 29 70 74 72 29 2d 3e 62 75 73 79 54 69 3 *)ptr)->busyTi
d080: 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 63 6f meout;. if( (co
d090: 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 74 69 unt+1)*1000 > ti
d0a0: 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 65 74 meout ){. ret
d0b0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c urn 0;. }. sql
d0c0: 69 74 65 33 4f 73 53 6c 65 65 70 28 64 62 2d 3e ite3OsSleep(db->
d0d0: 70 56 66 73 2c 20 31 30 30 30 30 30 30 29 3b 0a pVfs, 1000000);.
d0e0: 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 return 1;.#end
d0f0: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f if.}../*.** Invo
d100: 6b 65 20 74 68 65 20 67 69 76 65 6e 20 62 75 73 ke the given bus
d110: 79 20 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a y handler..**.**
d120: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
d130: 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 6e 20 called when an
d140: 6f 70 65 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 operation failed
d150: 20 77 69 74 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a with a lock..**
d160: 20 49 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 If this routine
d170: 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 returns non-zer
d180: 6f 2c 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 72 o, the lock is r
d190: 65 74 72 69 65 64 2e 20 20 49 66 20 69 74 0a 2a etried. If it.*
d1a0: 2a 20 72 65 74 75 72 6e 73 20 30 2c 20 74 68 65 * returns 0, the
d1b0: 20 6f 70 65 72 61 74 69 6f 6e 20 61 62 6f 72 74 operation abort
d1c0: 73 20 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 s with an SQLITE
d1d0: 5f 42 55 53 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a _BUSY error..*/.
d1e0: 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b int sqlite3Invok
d1f0: 65 42 75 73 79 48 61 6e 64 6c 65 72 28 42 75 73 eBusyHandler(Bus
d200: 79 48 61 6e 64 6c 65 72 20 2a 70 29 7b 0a 20 20 yHandler *p){.
d210: 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 4e 45 int rc;. if( NE
d220: 56 45 52 28 70 3d 3d 30 29 20 7c 7c 20 70 2d 3e VER(p==0) || p->
d230: 78 46 75 6e 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e xFunc==0 || p->n
d240: 42 75 73 79 3c 30 20 29 20 72 65 74 75 72 6e 20 Busy<0 ) return
d250: 30 3b 0a 20 20 72 63 20 3d 20 70 2d 3e 78 46 75 0;. rc = p->xFu
d260: 6e 63 28 70 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e nc(p->pArg, p->n
d270: 42 75 73 79 29 3b 0a 20 20 69 66 28 20 72 63 3d Busy);. if( rc=
d280: 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 =0 ){. p->nBu
d290: 73 79 20 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 sy = -1;. }else
d2a0: 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 2b 2b {. p->nBusy++
d2b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
d2c0: 63 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 c; .}../*.** Thi
d2d0: 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 s routine sets t
d2e0: 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b he busy callback
d2f0: 20 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 for an Sqlite d
d300: 61 74 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a atabase to the.*
d310: 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b * given callback
d320: 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 function with t
d330: 68 65 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e he given argumen
d340: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
d350: 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 0a 3_busy_handler(.
d360: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 sqlite3 *db,.
d370: 20 69 6e 74 20 28 2a 78 42 75 73 79 29 28 76 6f int (*xBusy)(vo
d380: 69 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 id*,int),. void
d390: 20 2a 70 41 72 67 0a 29 7b 0a 23 69 66 64 65 66 *pArg.){.#ifdef
d3a0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
d3b0: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
d3c0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
d3d0: 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 ckOk(db) ) retur
d3e0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
d3f0: 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 BKPT;.#endif. s
d400: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
d410: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
d420: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
d430: 2e 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a .xFunc = xBusy;.
d440: 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 db->busyHandle
d450: 72 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 r.pArg = pArg;.
d460: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
d470: 2e 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 64 62 .nBusy = 0;. db
d480: 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 20 3d 20 ->busyTimeout =
d490: 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 0;. sqlite3_mut
d4a0: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
d4b0: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ex);. return SQ
d4c0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e LITE_OK;.}..#ifn
d4d0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
d4e0: 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 PROGRESS_CALLBAC
d4f0: 4b 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 K./*.** This rou
d500: 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 70 72 tine sets the pr
d510: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 ogress callback
d520: 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 20 64 61 for an Sqlite da
d530: 74 61 62 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a tabase to the.**
d540: 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 given callback
d550: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 68 function with th
d560: 65 20 67 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 e given argument
d570: 2e 20 54 68 65 20 70 72 6f 67 72 65 73 73 20 63 . The progress c
d580: 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 allback will.**
d590: 62 65 20 69 6e 76 6f 6b 65 64 20 65 76 65 72 79 be invoked every
d5a0: 20 6e 4f 70 73 20 6f 70 63 6f 64 65 73 2e 0a 2a nOps opcodes..*
d5b0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 70 /.void sqlite3_p
d5c0: 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 rogress_handler(
d5d0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
d5e0: 0a 20 20 69 6e 74 20 6e 4f 70 73 2c 0a 20 20 69 . int nOps,. i
d5f0: 6e 74 20 28 2a 78 50 72 6f 67 72 65 73 73 29 28 nt (*xProgress)(
d600: 76 6f 69 64 2a 29 2c 20 0a 20 20 76 6f 69 64 20 void*), . void
d610: 2a 70 41 72 67 0a 29 7b 0a 23 69 66 64 65 66 20 *pArg.){.#ifdef
d620: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
d630: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
d640: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
d650: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
d660: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
d670: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
d680: 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a urn;. }.#endif.
d690: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
d6a0: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
d6b0: 3b 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 29 ;. if( nOps>0 )
d6c0: 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 72 {. db->xProgr
d6d0: 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 3b ess = xProgress;
d6e0: 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 . db->nProgre
d6f0: 73 73 4f 70 73 20 3d 20 28 75 6e 73 69 67 6e 65 ssOps = (unsigne
d700: 64 29 6e 4f 70 73 3b 0a 20 20 20 20 64 62 2d 3e d)nOps;. db->
d710: 70 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 70 pProgressArg = p
d720: 41 72 67 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 Arg;. }else{.
d730: 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 db->xProgress
d740: 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72 = 0;. db->nPr
d750: 6f 67 72 65 73 73 4f 70 73 20 3d 20 30 3b 0a 20 ogressOps = 0;.
d760: 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 db->pProgress
d770: 41 72 67 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 Arg = 0;. }. s
d780: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
d790: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 7d ve(db->mutex);.}
d7a0: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
d7b0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6e 73 This routine ins
d7c0: 74 61 6c 6c 73 20 61 20 64 65 66 61 75 6c 74 20 talls a default
d7d0: 62 75 73 79 20 68 61 6e 64 6c 65 72 20 74 68 61 busy handler tha
d7e0: 74 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 0a t waits for the.
d7f0: 2a 2a 20 73 70 65 63 69 66 69 65 64 20 6e 75 6d ** specified num
d800: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f ber of milliseco
d810: 6e 64 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 nds before retur
d820: 6e 69 6e 67 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 ning 0..*/.int s
d830: 71 6c 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 qlite3_busy_time
d840: 6f 75 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c out(sqlite3 *db,
d850: 20 69 6e 74 20 6d 73 29 7b 0a 23 69 66 64 65 66 int ms){.#ifdef
d860: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
d870: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
d880: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
d890: 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 ckOk(db) ) retur
d8a0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
d8b0: 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 69 BKPT;.#endif. i
d8c0: 66 28 20 6d 73 3e 30 20 29 7b 0a 20 20 20 20 73 f( ms>0 ){. s
d8d0: 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 qlite3_busy_hand
d8e0: 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 ler(db, sqliteDe
d8f0: 66 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 faultBusyCallbac
d900: 6b 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a 20 k, (void*)db);.
d910: 20 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f db->busyTimeo
d920: 75 74 20 3d 20 6d 73 3b 0a 20 20 7d 65 6c 73 65 ut = ms;. }else
d930: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62 75 {. sqlite3_bu
d940: 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 30 sy_handler(db, 0
d950: 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 , 0);. }. retu
d960: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
d970: 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 20 61 6e 79 ./*.** Cause any
d980: 20 70 65 6e 64 69 6e 67 20 6f 70 65 72 61 74 69 pending operati
d990: 6f 6e 20 74 6f 20 73 74 6f 70 20 61 74 20 69 74 on to stop at it
d9a0: 73 20 65 61 72 6c 69 65 73 74 20 6f 70 70 6f 72 s earliest oppor
d9b0: 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 tunity..*/.void
d9c0: 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 72 75 70 sqlite3_interrup
d9d0: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a t(sqlite3 *db){.
d9e0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
d9f0: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
da00: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
da10: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 26 etyCheckOk(db) &
da20: 26 20 28 64 62 3d 3d 30 20 7c 7c 20 64 62 2d 3e & (db==0 || db->
da30: 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f 4d 41 magic!=SQLITE_MA
da40: 47 49 43 5f 5a 4f 4d 42 49 45 29 20 29 7b 0a 20 GIC_ZOMBIE) ){.
da50: 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
da60: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
da70: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e return;. }.#en
da80: 64 69 66 0a 20 20 64 62 2d 3e 75 31 2e 69 73 49 dif. db->u1.isI
da90: 6e 74 65 72 72 75 70 74 65 64 20 3d 20 31 3b 0a nterrupted = 1;.
daa0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 }.../*.** This f
dab0: 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 74 unction is exact
dac0: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 ly the same as s
dad0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 qlite3_create_fu
dae0: 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 74 nction(), except
daf0: 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 64 .** that it is d
db00: 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61 esigned to be ca
db10: 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 6c lled by internal
db20: 20 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 65 code. The diffe
db30: 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 74 rence is.** that
db40: 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 if a malloc() f
db50: 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 5f ails in sqlite3_
db60: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 create_function(
db70: 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ), an error code
db80: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 .** is returned
db90: 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 and the mallocFa
dba0: 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 65 iled flag cleare
dbb0: 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 d. .*/.int sqlit
dbc0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 20 e3CreateFunc(.
dbd0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
dbe0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 onst char *zFunc
dbf0: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 tionName,. int
dc00: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c nArg,. int enc,
dc10: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 . void *pUserDa
dc20: 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 46 ta,. void (*xSF
dc30: 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e unc)(sqlite3_con
dc40: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
dc50: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 3_value **),. v
dc60: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c oid (*xStep)(sql
dc70: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
dc80: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
dc90: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 **),. void (*xF
dca0: 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f inal)(sqlite3_co
dcb0: 6e 74 65 78 74 2a 29 2c 0a 20 20 46 75 6e 63 44 ntext*),. FuncD
dcc0: 65 73 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 estructor *pDest
dcd0: 72 75 63 74 6f 72 0a 29 7b 0a 20 20 46 75 6e 63 ructor.){. Func
dce0: 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e Def *p;. int nN
dcf0: 61 6d 65 3b 0a 20 20 69 6e 74 20 65 78 74 72 61 ame;. int extra
dd00: 46 6c 61 67 73 3b 0a 0a 20 20 61 73 73 65 72 74 Flags;.. assert
dd10: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
dd20: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
dd30: 29 3b 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 );. if( zFuncti
dd40: 6f 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 onName==0 ||.
dd50: 20 20 20 28 78 53 46 75 6e 63 20 26 26 20 28 78 (xSFunc && (x
dd60: 46 69 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 Final || xStep))
dd70: 20 7c 7c 20 0a 20 20 20 20 20 20 28 21 78 53 46 || . (!xSF
dd80: 75 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 26 unc && (xFinal &
dd90: 26 20 21 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 & !xStep)) ||.
dda0: 20 20 20 20 28 21 78 53 46 75 6e 63 20 26 26 20 (!xSFunc &&
ddb0: 28 21 78 46 69 6e 61 6c 20 26 26 20 78 53 74 65 (!xFinal && xSte
ddc0: 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 28 6e 41 p)) ||. (nA
ddd0: 72 67 3c 2d 31 20 7c 7c 20 6e 41 72 67 3e 53 51 rg<-1 || nArg>SQ
dde0: 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f LITE_MAX_FUNCTIO
ddf0: 4e 5f 41 52 47 29 20 7c 7c 0a 20 20 20 20 20 20 N_ARG) ||.
de00: 28 32 35 35 3c 28 6e 4e 61 6d 65 20 3d 20 73 71 (255<(nName = sq
de10: 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 20 7a lite3Strlen30( z
de20: 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 FunctionName)))
de30: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
de40: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
de50: 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 ;. }.. assert(
de60: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e SQLITE_FUNC_CON
de70: 53 54 41 4e 54 3d 3d 53 51 4c 49 54 45 5f 44 45 STANT==SQLITE_DE
de80: 54 45 52 4d 49 4e 49 53 54 49 43 20 29 3b 0a 20 TERMINISTIC );.
de90: 20 65 78 74 72 61 46 6c 61 67 73 20 3d 20 65 6e extraFlags = en
dea0: 63 20 26 20 20 53 51 4c 49 54 45 5f 44 45 54 45 c & SQLITE_DETE
deb0: 52 4d 49 4e 49 53 54 49 43 3b 0a 20 20 65 6e 63 RMINISTIC;. enc
dec0: 20 26 3d 20 28 53 51 4c 49 54 45 5f 46 55 4e 43 &= (SQLITE_FUNC
ded0: 5f 45 4e 43 4d 41 53 4b 7c 53 51 4c 49 54 45 5f _ENCMASK|SQLITE_
dee0: 41 4e 59 29 3b 0a 20 20 0a 23 69 66 6e 64 65 66 ANY);. .#ifndef
def0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
df00: 31 36 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 16. /* If SQLIT
df10: 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69 E_UTF16 is speci
df20: 66 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f fied as the enco
df30: 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 ding type, trans
df40: 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 form this. ** t
df50: 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f o one of SQLITE_
df60: 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 UTF16LE or SQLIT
df70: 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 E_UTF16BE using
df80: 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f the. ** SQLITE_
df90: 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 UTF16NATIVE macr
dfa0: 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 o. SQLITE_UTF16
dfb0: 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 is not used inte
dfc0: 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a rnally.. **. *
dfd0: 2a 20 49 66 20 53 51 4c 49 54 45 5f 41 4e 59 20 * If SQLITE_ANY
dfe0: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 61 64 is specified, ad
dff0: 64 20 74 68 72 65 65 20 76 65 72 73 69 6f 6e 73 d three versions
e000: 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e of the function
e010: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 68 61 73 . ** to the has
e020: 68 20 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 h table.. */.
e030: 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f if( enc==SQLITE_
e040: 55 54 46 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 UTF16 ){. enc
e050: 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e = SQLITE_UTF16N
e060: 41 54 49 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69 ATIVE;. }else i
e070: 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41 f( enc==SQLITE_A
e080: 4e 59 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 NY ){. int rc
e090: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
e0a0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c e3CreateFunc(db,
e0b0: 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 zFunctionName,
e0c0: 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 nArg, SQLITE_UTF
e0d0: 38 7c 65 78 74 72 61 46 6c 61 67 73 2c 0a 20 20 8|extraFlags,.
e0e0: 20 20 20 20 20 20 20 70 55 73 65 72 44 61 74 61 pUserData
e0f0: 2c 20 78 53 46 75 6e 63 2c 20 78 53 74 65 70 2c , xSFunc, xStep,
e100: 20 78 46 69 6e 61 6c 2c 20 70 44 65 73 74 72 75 xFinal, pDestru
e110: 63 74 6f 72 29 3b 0a 20 20 20 20 69 66 28 20 72 ctor);. if( r
e120: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
e130: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
e140: 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c e3CreateFunc(db,
e150: 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 zFunctionName,
e160: 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 nArg, SQLITE_UTF
e170: 31 36 4c 45 7c 65 78 74 72 61 46 6c 61 67 73 2c 16LE|extraFlags,
e180: 0a 20 20 20 20 20 20 20 20 20 20 70 55 73 65 72 . pUser
e190: 44 61 74 61 2c 20 78 53 46 75 6e 63 2c 20 78 53 Data, xSFunc, xS
e1a0: 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 70 44 65 tep, xFinal, pDe
e1b0: 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 7d structor);. }
e1c0: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
e1d0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
e1e0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
e1f0: 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 . enc = SQLIT
e200: 45 5f 55 54 46 31 36 42 45 3b 0a 20 20 7d 0a 23 E_UTF16BE;. }.#
e210: 65 6c 73 65 0a 20 20 65 6e 63 20 3d 20 53 51 4c else. enc = SQL
e220: 49 54 45 5f 55 54 46 38 3b 0a 23 65 6e 64 69 66 ITE_UTF8;.#endif
e230: 0a 20 20 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 . . /* Check i
e240: 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20 66 75 f an existing fu
e250: 6e 63 74 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 nction is being
e260: 6f 76 65 72 72 69 64 64 65 6e 20 6f 72 20 64 65 overridden or de
e270: 6c 65 74 65 64 2e 20 49 66 20 73 6f 2c 0a 20 20 leted. If so,.
e280: 2a 2a 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 ** and there are
e290: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 74 68 65 active VMs, the
e2a0: 6e 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f n return SQLITE_
e2b0: 42 55 53 59 2e 20 49 66 20 61 20 66 75 6e 63 74 BUSY. If a funct
e2c0: 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 62 65 69 6e ion. ** is bein
e2d0: 67 20 6f 76 65 72 72 69 64 64 65 6e 2f 64 65 6c g overridden/del
e2e0: 65 74 65 64 20 62 75 74 20 74 68 65 72 65 20 61 eted but there a
e2f0: 72 65 20 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 re no active VMs
e300: 2c 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20 2a 2a , allow the. **
e310: 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 63 6f operation to co
e320: 6e 74 69 6e 75 65 20 62 75 74 20 69 6e 76 61 6c ntinue but inval
e330: 69 64 61 74 65 20 61 6c 6c 20 70 72 65 63 6f 6d idate all precom
e340: 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e 74 73 piled statements
e350: 2e 0a 20 20 2a 2f 0a 20 20 70 20 3d 20 73 71 6c .. */. p = sql
e360: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e ite3FindFunction
e370: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 (db, zFunctionNa
e380: 6d 65 2c 20 6e 41 72 67 2c 20 28 75 38 29 65 6e me, nArg, (u8)en
e390: 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 c, 0);. if( p &
e3a0: 26 20 28 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 & (p->funcFlags
e3b0: 26 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e & SQLITE_FUNC_EN
e3c0: 43 4d 41 53 4b 29 3d 3d 65 6e 63 20 26 26 20 70 CMASK)==enc && p
e3d0: 2d 3e 6e 41 72 67 3d 3d 6e 41 72 67 20 29 7b 0a ->nArg==nArg ){.
e3e0: 20 20 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 if( db->nVdb
e3f0: 65 41 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 eActive ){.
e400: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 sqlite3ErrorWit
e410: 68 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f hMsg(db, SQLITE_
e420: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
e430: 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 unable to delete
e440: 2f 6d 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e /modify user-fun
e450: 63 74 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 ction due to act
e460: 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 ive statements")
e470: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
e480: 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
e490: 64 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 d );. retur
e4a0: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
e4b0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
e4c0: 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 sqlite3ExpirePre
e4d0: 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 paredStatements(
e4e0: 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a db);. }. }..
e4f0: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e p = sqlite3Fin
e500: 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 dFunction(db, zF
e510: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 unctionName, nAr
e520: 67 2c 20 28 75 38 29 65 6e 63 2c 20 31 29 3b 0a g, (u8)enc, 1);.
e530: 20 20 61 73 73 65 72 74 28 70 20 7c 7c 20 64 62 assert(p || db
e540: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 29 3b ->mallocFailed);
e550: 0a 20 20 69 66 28 20 21 70 20 29 7b 0a 20 20 20 . if( !p ){.
e560: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
e570: 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a OMEM_BKPT;. }..
e580: 20 20 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 65 72 /* If an older
e590: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
e5a0: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 function with a
e5b0: 63 6f 6e 66 69 67 75 72 65 64 20 64 65 73 74 72 configured destr
e5c0: 75 63 74 6f 72 20 69 73 0a 20 20 2a 2a 20 62 65 uctor is. ** be
e5d0: 69 6e 67 20 72 65 70 6c 61 63 65 64 20 69 6e 76 ing replaced inv
e5e0: 6f 6b 65 20 74 68 65 20 64 65 73 74 72 75 63 74 oke the destruct
e5f0: 6f 72 20 66 75 6e 63 74 69 6f 6e 20 68 65 72 65 or function here
e600: 2e 20 2a 2f 0a 20 20 66 75 6e 63 74 69 6f 6e 44 . */. functionD
e610: 65 73 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 0a estroy(db, p);..
e620: 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 6f if( pDestructo
e630: 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 r ){. pDestru
e640: 63 74 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 ctor->nRef++;.
e650: 7d 0a 20 20 70 2d 3e 75 2e 70 44 65 73 74 72 75 }. p->u.pDestru
e660: 63 74 6f 72 20 3d 20 70 44 65 73 74 72 75 63 74 ctor = pDestruct
e670: 6f 72 3b 0a 20 20 70 2d 3e 66 75 6e 63 46 6c 61 or;. p->funcFla
e680: 67 73 20 3d 20 28 70 2d 3e 66 75 6e 63 46 6c 61 gs = (p->funcFla
e690: 67 73 20 26 20 53 51 4c 49 54 45 5f 46 55 4e 43 gs & SQLITE_FUNC
e6a0: 5f 45 4e 43 4d 41 53 4b 29 20 7c 20 65 78 74 72 _ENCMASK) | extr
e6b0: 61 46 6c 61 67 73 3b 0a 20 20 74 65 73 74 63 61 aFlags;. testca
e6c0: 73 65 28 20 70 2d 3e 66 75 6e 63 46 6c 61 67 73 se( p->funcFlags
e6d0: 20 26 20 53 51 4c 49 54 45 5f 44 45 54 45 52 4d & SQLITE_DETERM
e6e0: 49 4e 49 53 54 49 43 20 29 3b 0a 20 20 70 2d 3e INISTIC );. p->
e6f0: 78 53 46 75 6e 63 20 3d 20 78 53 46 75 6e 63 20 xSFunc = xSFunc
e700: 3f 20 78 53 46 75 6e 63 20 3a 20 78 53 74 65 70 ? xSFunc : xStep
e710: 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 ;. p->xFinalize
e720: 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e = xFinal;. p->
e730: 70 55 73 65 72 44 61 74 61 20 3d 20 70 55 73 65 pUserData = pUse
e740: 72 44 61 74 61 3b 0a 20 20 70 2d 3e 6e 41 72 67 rData;. p->nArg
e750: 20 3d 20 28 75 31 36 29 6e 41 72 67 3b 0a 20 20 = (u16)nArg;.
e760: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
e770: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 ;.}../*.** Creat
e780: 65 20 6e 65 77 20 75 73 65 72 20 66 75 6e 63 74 e new user funct
e790: 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ions..*/.int sql
e7a0: 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 ite3_create_func
e7b0: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 tion(. sqlite3
e7c0: 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 *db,. const cha
e7d0: 72 20 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e 74 20 r *zFunc,. int
e7e0: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c nArg,. int enc,
e7f0: 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 6f . void *p,. vo
e800: 69 64 20 28 2a 78 53 46 75 6e 63 29 28 73 71 6c id (*xSFunc)(sql
e810: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
e820: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
e830: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 **),. void (*xS
e840: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e tep)(sqlite3_con
e850: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
e860: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 3_value **),. v
e870: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 oid (*xFinal)(sq
e880: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a lite3_context*).
e890: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
e8a0: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
e8b0: 69 6f 6e 5f 76 32 28 64 62 2c 20 7a 46 75 6e 63 ion_v2(db, zFunc
e8c0: 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 , nArg, enc, p,
e8d0: 78 53 46 75 6e 63 2c 20 78 53 74 65 70 2c 0a 20 xSFunc, xStep,.
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 20 20 20 20 20 20 20
e900: 20 20 20 78 46 69 6e 61 6c 2c 20 30 29 3b 0a 7d xFinal, 0);.}
e910: 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 ..int sqlite3_cr
e920: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 eate_function_v2
e930: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
e940: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
e950: 46 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Func,. int nArg
e960: 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 ,. int enc,. v
e970: 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 oid *p,. void (
e980: 2a 78 53 46 75 6e 63 29 28 73 71 6c 69 74 65 33 *xSFunc)(sqlite3
e990: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
e9a0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c lite3_value **),
e9b0: 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 . void (*xStep)
e9c0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
e9d0: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
e9e0: 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 lue **),. void
e9f0: 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 (*xFinal)(sqlite
ea00: 33 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 76 3_context*),. v
ea10: 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29 28 oid (*xDestroy)(
ea20: 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 69 6e 74 void *).){. int
ea30: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
ea40: 4f 52 3b 0a 20 20 46 75 6e 63 44 65 73 74 72 75 OR;. FuncDestru
ea50: 63 74 6f 72 20 2a 70 41 72 67 20 3d 20 30 3b 0a ctor *pArg = 0;.
ea60: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
ea70: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
ea80: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
ea90: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
eaa0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
eab0: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
eac0: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 ;. }.#endif. s
ead0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
eae0: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
eaf0: 20 69 66 28 20 78 44 65 73 74 72 6f 79 20 29 7b if( xDestroy ){
eb00: 0a 20 20 20 20 70 41 72 67 20 3d 20 28 46 75 6e . pArg = (Fun
eb10: 63 44 65 73 74 72 75 63 74 6f 72 20 2a 29 73 71 cDestructor *)sq
eb20: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 lite3DbMallocZer
eb30: 6f 28 64 62 2c 20 73 69 7a 65 6f 66 28 46 75 6e o(db, sizeof(Fun
eb40: 63 44 65 73 74 72 75 63 74 6f 72 29 29 3b 0a 20 cDestructor));.
eb50: 20 20 20 69 66 28 20 21 70 41 72 67 20 29 7b 0a if( !pArg ){.
eb60: 20 20 20 20 20 20 78 44 65 73 74 72 6f 79 28 70 xDestroy(p
eb70: 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 75 );. goto ou
eb80: 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 41 72 t;. }. pAr
eb90: 67 2d 3e 78 44 65 73 74 72 6f 79 20 3d 20 78 44 g->xDestroy = xD
eba0: 65 73 74 72 6f 79 3b 0a 20 20 20 20 70 41 72 67 estroy;. pArg
ebb0: 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 3b ->pUserData = p;
ebc0: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
ebd0: 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 te3CreateFunc(db
ebe0: 2c 20 7a 46 75 6e 63 2c 20 6e 41 72 67 2c 20 65 , zFunc, nArg, e
ebf0: 6e 63 2c 20 70 2c 20 78 53 46 75 6e 63 2c 20 78 nc, p, xSFunc, x
ec00: 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 70 41 Step, xFinal, pA
ec10: 72 67 29 3b 0a 20 20 69 66 28 20 70 41 72 67 20 rg);. if( pArg
ec20: 26 26 20 70 41 72 67 2d 3e 6e 52 65 66 3d 3d 30 && pArg->nRef==0
ec30: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
ec40: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b rc!=SQLITE_OK );
ec50: 0a 20 20 20 20 78 44 65 73 74 72 6f 79 28 70 29 . xDestroy(p)
ec60: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 ;. sqlite3DbF
ec70: 72 65 65 28 64 62 2c 20 70 41 72 67 29 3b 0a 20 ree(db, pArg);.
ec80: 20 7d 0a 0a 20 6f 75 74 3a 0a 20 20 72 63 20 3d }.. out:. rc =
ec90: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 sqlite3ApiExit(
eca0: 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 db, rc);. sqlit
ecb0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
ecc0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
ecd0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 urn rc;.}..#ifnd
ece0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
ecf0: 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 TF16.int sqlite3
ed00: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e _create_function
ed10: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 16(. sqlite3 *d
ed20: 62 2c 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 b,. const void
ed30: 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a *zFunctionName,.
ed40: 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e int nArg,. in
ed50: 74 20 65 54 65 78 74 52 65 70 2c 0a 20 20 76 6f t eTextRep,. vo
ed60: 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a id *p,. void (*
ed70: 78 53 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f xSFunc)(sqlite3_
ed80: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
ed90: 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 ite3_value**),.
eda0: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 void (*xStep)(s
edb0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
edc0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
edd0: 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 e**),. void (*x
ede0: 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 Final)(sqlite3_c
edf0: 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e ontext*).){. in
ee00: 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 46 t rc;. char *zF
ee10: 75 6e 63 38 3b 0a 0a 23 69 66 64 65 66 20 53 51 unc8;..#ifdef SQ
ee20: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
ee30: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
ee40: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
ee50: 6b 28 64 62 29 20 7c 7c 20 7a 46 75 6e 63 74 69 k(db) || zFuncti
ee60: 6f 6e 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 onName==0 ) retu
ee70: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
ee80: 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 _BKPT;.#endif.
ee90: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
eea0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
eeb0: 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d assert( !db->m
eec0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 allocFailed );.
eed0: 20 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 zFunc8 = sqlite
eee0: 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 46 3Utf16to8(db, zF
eef0: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 2d 31 2c unctionName, -1,
ef00: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
ef10: 49 56 45 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c IVE);. rc = sql
ef20: 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 ite3CreateFunc(d
ef30: 62 2c 20 7a 46 75 6e 63 38 2c 20 6e 41 72 67 2c b, zFunc8, nArg,
ef40: 20 65 54 65 78 74 52 65 70 2c 20 70 2c 20 78 53 eTextRep, p, xS
ef50: 46 75 6e 63 2c 78 53 74 65 70 2c 78 46 69 6e 61 Func,xStep,xFina
ef60: 6c 2c 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 l,0);. sqlite3D
ef70: 62 46 72 65 65 28 64 62 2c 20 7a 46 75 6e 63 38 bFree(db, zFunc8
ef80: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
ef90: 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3ApiExit(db, rc)
efa0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
efb0: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
efc0: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b x);. return rc;
efd0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a .}.#endif.../*.*
efe0: 2a 20 44 65 63 6c 61 72 65 20 74 68 61 74 20 61 * Declare that a
eff0: 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 function has be
f000: 65 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 62 79 en overloaded by
f010: 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 a virtual table
f020: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 ..**.** If the f
f030: 75 6e 63 74 69 6f 6e 20 61 6c 72 65 61 64 79 20 unction already
f040: 65 78 69 73 74 73 20 61 73 20 61 20 72 65 67 75 exists as a regu
f050: 6c 61 72 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 lar global funct
f060: 69 6f 6e 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 ion, then.** thi
f070: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e s routine is a n
f080: 6f 2d 6f 70 2e 20 20 49 66 20 74 68 65 20 66 75 o-op. If the fu
f090: 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 nction does not
f0a0: 65 78 69 73 74 2c 20 74 68 65 6e 20 63 72 65 61 exist, then crea
f0b0: 74 65 0a 2a 2a 20 61 20 6e 65 77 20 6f 6e 65 20 te.** a new one
f0c0: 74 68 61 74 20 61 6c 77 61 79 73 20 74 68 72 6f that always thro
f0d0: 77 73 20 61 20 72 75 6e 2d 74 69 6d 65 20 65 72 ws a run-time er
f0e0: 72 6f 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 57 68 65 ror. .**.** Whe
f0f0: 6e 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 n virtual tables
f100: 20 69 6e 74 65 6e 64 20 74 6f 20 70 72 6f 76 69 intend to provi
f110: 64 65 20 61 6e 20 6f 76 65 72 6c 6f 61 64 65 64 de an overloaded
f120: 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 65 79 0a function, they.
f130: 2a 2a 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 ** should call t
f140: 68 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 6d his routine to m
f150: 61 6b 65 20 73 75 72 65 20 74 68 65 20 67 6c 6f ake sure the glo
f160: 62 61 6c 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 bal function exi
f170: 73 74 73 2e 0a 2a 2a 20 41 20 67 6c 6f 62 61 6c sts..** A global
f180: 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 65 function must e
f190: 78 69 73 74 20 69 6e 20 6f 72 64 65 72 20 66 6f xist in order fo
f1a0: 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75 74 69 6f r name resolutio
f1b0: 6e 20 74 6f 20 77 6f 72 6b 0a 2a 2a 20 70 72 6f n to work.** pro
f1c0: 70 65 72 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 perly..*/.int sq
f1d0: 6c 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 lite3_overload_f
f1e0: 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 unction(. sqlit
f1f0: 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 e3 *db,. const
f200: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 char *zName,. i
f210: 6e 74 20 6e 41 72 67 0a 29 7b 0a 20 20 69 6e 74 nt nArg.){. int
f220: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
f230: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
f240: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
f250: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
f260: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
f270: 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 || zName==0 ||
f280: 6e 41 72 67 3c 2d 32 20 29 7b 0a 20 20 20 20 72 nArg<-2 ){. r
f290: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
f2a0: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 USE_BKPT;. }.#e
f2b0: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
f2c0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
f2d0: 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 6c utex);. if( sql
f2e0: 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e ite3FindFunction
f2f0: 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 41 72 67 (db, zName, nArg
f300: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 , SQLITE_UTF8, 0
f310: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d )==0 ){. rc =
f320: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
f330: 6e 63 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 41 nc(db, zName, nA
f340: 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c rg, SQLITE_UTF8,
f350: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
f360: 20 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 73 0, s
f370: 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 75 6e qlite3InvalidFun
f380: 63 74 69 6f 6e 2c 20 30 2c 20 30 2c 20 30 29 3b ction, 0, 0, 0);
f390: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
f3a0: 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 te3ApiExit(db, r
f3b0: 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 c);. sqlite3_mu
f3c0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
f3d0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 tex);. return r
f3e0: 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 c;.}..#ifndef SQ
f3f0: 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a LITE_OMIT_TRACE.
f400: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
f410: 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 2e trace function.
f420: 20 20 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 The pArg from
f430: 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 the previously r
f440: 65 67 69 73 74 65 72 65 64 20 74 72 61 63 65 0a egistered trace.
f450: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 ** is returned.
f460: 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 74 .**.** A NULL t
f470: 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 race function me
f480: 61 6e 73 20 74 68 61 74 20 6e 6f 20 74 72 61 63 ans that no trac
f490: 69 6e 67 20 69 73 20 65 78 65 63 75 74 65 73 2e ing is executes.
f4a0: 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 A non-NULL.**
f4b0: 74 72 61 63 65 20 69 73 20 61 20 70 6f 69 6e 74 trace is a point
f4c0: 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e er to a function
f4d0: 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 that is invoked
f4e0: 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 at the start of
f4f0: 20 65 61 63 68 0a 2a 2a 20 53 51 4c 20 73 74 61 each.** SQL sta
f500: 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 6e 64 tement..*/.#ifnd
f510: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ef SQLITE_OMIT_D
f520: 45 50 52 45 43 41 54 45 44 0a 76 6f 69 64 20 2a EPRECATED.void *
f530: 73 71 6c 69 74 65 33 5f 74 72 61 63 65 28 73 71 sqlite3_trace(sq
f540: 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 28 lite3 *db, void(
f550: 2a 78 54 72 61 63 65 29 28 76 6f 69 64 2a 2c 63 *xTrace)(void*,c
f560: 6f 6e 73 74 20 63 68 61 72 2a 29 2c 20 76 6f 69 onst char*), voi
f570: 64 20 2a 70 41 72 67 29 7b 0a 20 20 76 6f 69 64 d *pArg){. void
f580: 20 2a 70 4f 6c 64 3b 0a 0a 23 69 66 64 65 66 20 *pOld;..#ifdef
f590: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
f5a0: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
f5b0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
f5c0: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
f5d0: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
f5e0: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
f5f0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 urn 0;. }.#endi
f600: 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
f610: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
f620: 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d x);. pOld = db-
f630: 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 64 62 >pTraceArg;. db
f640: 2d 3e 6d 54 72 61 63 65 20 3d 20 78 54 72 61 63 ->mTrace = xTrac
f650: 65 20 3f 20 53 51 4c 49 54 45 5f 54 52 41 43 45 e ? SQLITE_TRACE
f660: 5f 4c 45 47 41 43 59 20 3a 20 30 3b 0a 20 20 64 _LEGACY : 0;. d
f670: 62 2d 3e 78 54 72 61 63 65 20 3d 20 28 69 6e 74 b->xTrace = (int
f680: 28 2a 29 28 75 33 32 2c 76 6f 69 64 2a 2c 76 6f (*)(u32,void*,vo
f690: 69 64 2a 2c 76 6f 69 64 2a 29 29 78 54 72 61 63 id*,void*))xTrac
f6a0: 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 65 41 e;. db->pTraceA
f6b0: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
f6c0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
f6d0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
f6e0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 eturn pOld;.}.#e
f6f0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
f700: 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 20 2a MIT_DEPRECATED *
f710: 2f 0a 0a 2f 2a 20 52 65 67 69 73 74 65 72 20 61 /../* Register a
f720: 20 74 72 61 63 65 20 63 61 6c 6c 62 61 63 6b 20 trace callback
f730: 75 73 69 6e 67 20 74 68 65 20 76 65 72 73 69 6f using the versio
f740: 6e 2d 32 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a n-2 interface..*
f750: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 72 /.int sqlite3_tr
f760: 61 63 65 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 ace_v2(. sqlite
f770: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
f780: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f790: 20 20 20 20 20 2f 2a 20 54 72 61 63 65 20 74 68 /* Trace th
f7a0: 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f is connection */
f7b0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 6d 54 72 61 . unsigned mTra
f7c0: 63 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ce,
f7d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
f7e0: 20 4d 61 73 6b 20 6f 66 20 65 76 65 6e 74 73 20 Mask of events
f7f0: 74 6f 20 62 65 20 74 72 61 63 65 64 20 2a 2f 0a to be traced */.
f800: 20 20 69 6e 74 28 2a 78 54 72 61 63 65 29 28 75 int(*xTrace)(u
f810: 6e 73 69 67 6e 65 64 2c 76 6f 69 64 2a 2c 76 6f nsigned,void*,vo
f820: 69 64 2a 2c 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 id*,void*), /*
f830: 43 61 6c 6c 62 61 63 6b 20 74 6f 20 69 6e 76 6f Callback to invo
f840: 6b 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 ke */. void *pA
f850: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rg
f860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f870: 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 2a 2f /* Context */
f880: 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .){.#ifdef SQLIT
f890: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
f8a0: 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
f8b0: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
f8c0: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
f8d0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
f8e0: 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a KPT;. }.#endif.
f8f0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
f900: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
f910: 3b 0a 20 20 69 66 28 20 6d 54 72 61 63 65 3d 3d ;. if( mTrace==
f920: 30 20 29 20 78 54 72 61 63 65 20 3d 20 30 3b 0a 0 ) xTrace = 0;.
f930: 20 20 69 66 28 20 78 54 72 61 63 65 3d 3d 30 20 if( xTrace==0
f940: 29 20 6d 54 72 61 63 65 20 3d 20 30 3b 0a 20 20 ) mTrace = 0;.
f950: 64 62 2d 3e 6d 54 72 61 63 65 20 3d 20 6d 54 72 db->mTrace = mTr
f960: 61 63 65 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 ace;. db->xTrac
f970: 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64 62 e = xTrace;. db
f980: 2d 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70 41 ->pTraceArg = pA
f990: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
f9a0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
f9b0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
f9c0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
f9d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
f9e0: 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a _DEPRECATED./*.*
f9f0: 2a 20 52 65 67 69 73 74 65 72 20 61 20 70 72 6f * Register a pro
fa00: 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 file function.
fa10: 54 68 65 20 70 41 72 67 20 66 72 6f 6d 20 74 68 The pArg from th
fa20: 65 20 70 72 65 76 69 6f 75 73 6c 79 20 72 65 67 e previously reg
fa30: 69 73 74 65 72 65 64 20 0a 2a 2a 20 70 72 6f 66 istered .** prof
fa40: 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 ile function is
fa50: 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a returned. .**.*
fa60: 2a 20 41 20 4e 55 4c 4c 20 70 72 6f 66 69 6c 65 * A NULL profile
fa70: 20 66 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 function means
fa80: 74 68 61 74 20 6e 6f 20 70 72 6f 66 69 6c 69 6e that no profilin
fa90: 67 20 69 73 20 65 78 65 63 75 74 65 73 2e 20 20 g is executes.
faa0: 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 70 72 A non-NULL.** pr
fab0: 6f 66 69 6c 65 20 69 73 20 61 20 70 6f 69 6e 74 ofile is a point
fac0: 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e er to a function
fad0: 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 that is invoked
fae0: 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 at the conclusi
faf0: 6f 6e 20 6f 66 0a 2a 2a 20 65 61 63 68 20 53 51 on of.** each SQ
fb00: 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 L statement that
fb10: 20 69 73 20 72 75 6e 2e 0a 2a 2f 0a 76 6f 69 64 is run..*/.void
fb20: 20 2a 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c *sqlite3_profil
fb30: 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 e(. sqlite3 *db
fb40: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 ,. void (*xProf
fb50: 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 ile)(void*,const
fb60: 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f 75 69 char*,sqlite_ui
fb70: 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 nt64),. void *p
fb80: 41 72 67 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 Arg.){. void *p
fb90: 4f 6c 64 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c Old;..#ifdef SQL
fba0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
fbb0: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
fbc0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
fbd0: 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
fbe0: 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
fbf0: 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
fc00: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
fc10: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
fc20: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
fc30: 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 50 . pOld = db->pP
fc40: 72 6f 66 69 6c 65 41 72 67 3b 0a 20 20 64 62 2d rofileArg;. db-
fc50: 3e 78 50 72 6f 66 69 6c 65 20 3d 20 78 50 72 6f >xProfile = xPro
fc60: 66 69 6c 65 3b 0a 20 20 64 62 2d 3e 70 50 72 6f file;. db->pPro
fc70: 66 69 6c 65 41 72 67 20 3d 20 70 41 72 67 3b 0a fileArg = pArg;.
fc80: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
fc90: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
fca0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b ;. return pOld;
fcb0: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
fcc0: 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 ITE_OMIT_DEPRECA
fcd0: 54 45 44 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a TED */.#endif /*
fce0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 SQLITE_OMIT_TRA
fcf0: 43 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 CE */../*.** Reg
fd00: 69 73 74 65 72 20 61 20 66 75 6e 63 74 69 6f 6e ister a function
fd10: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 77 to be invoked w
fd20: 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f hen a transactio
fd30: 6e 20 63 6f 6d 6d 69 74 73 2e 0a 2a 2a 20 49 66 n commits..** If
fd40: 20 74 68 65 20 69 6e 76 6f 6b 65 64 20 66 75 6e the invoked fun
fd50: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f ction returns no
fd60: 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 n-zero, then the
fd70: 20 63 6f 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20 commit becomes
fd80: 61 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a a.** rollback..*
fd90: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f /.void *sqlite3_
fda0: 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 commit_hook(. s
fdb0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 qlite3 *db,
fdc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 /* Atta
fdd0: 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 ch the hook to t
fde0: 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a his database */.
fdf0: 20 20 69 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63 int (*xCallbac
fe00: 6b 29 28 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 k)(void*), /* F
fe10: 75 6e 63 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b unction to invok
fe20: 65 20 6f 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74 e on each commit
fe30: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 */. void *pArg
fe40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
fe50: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 /* Argument to t
fe60: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 he function */.)
fe70: 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a {. void *pOld;.
fe80: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
fe90: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
fea0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
feb0: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
fec0: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
fed0: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
fee0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
fef0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 }.#endif. sqli
ff00: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
ff10: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f db->mutex);. pO
ff20: 6c 64 20 3d 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 ld = db->pCommit
ff30: 41 72 67 3b 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d Arg;. db->xComm
ff40: 69 74 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 itCallback = xCa
ff50: 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 llback;. db->pC
ff60: 6f 6d 6d 69 74 41 72 67 20 3d 20 70 41 72 67 3b ommitArg = pArg;
ff70: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
ff80: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
ff90: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 );. return pOld
ffa0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 ;.}../*.** Regis
ffb0: 74 65 72 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 ter a callback t
ffc0: 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 o be invoked eac
ffd0: 68 20 74 69 6d 65 20 61 20 72 6f 77 20 69 73 20 h time a row is
ffe0: 75 70 64 61 74 65 64 2c 0a 2a 2a 20 69 6e 73 65 updated,.** inse
fff0: 72 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64 20 rted or deleted
10000 75 73 69 6e 67 20 74 68 69 73 20 64 61 74 61 62 using this datab
10010 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ase connection..
10020 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 */.void *sqlite3
10030 5f 75 70 64 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 _update_hook(.
10040 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
10050 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 /* Att
10060 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 ach the hook to
10070 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f this database */
10080 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 . void (*xCallb
10090 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 ack)(void*,int,c
100a0 68 61 72 20 63 6f 6e 73 74 20 2a 2c 63 68 61 72 har const *,char
100b0 20 63 6f 6e 73 74 20 2a 2c 73 71 6c 69 74 65 5f const *,sqlite_
100c0 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 20 2a int64),. void *
100d0 70 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 pArg
100e0 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
100f0 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 to the function
10100 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 */.){. void *pR
10110 65 74 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 et;..#ifdef SQLI
10120 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
10130 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
10140 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
10150 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 db) ){. (void
10160 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 )SQLITE_MISUSE_B
10170 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 KPT;. return
10180 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 0;. }.#endif.
10190 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
101a0 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
101b0 20 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 55 70 pRet = db->pUp
101c0 64 61 74 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 dateArg;. db->x
101d0 55 70 64 61 74 65 43 61 6c 6c 62 61 63 6b 20 3d UpdateCallback =
101e0 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 xCallback;. db
101f0 2d 3e 70 55 70 64 61 74 65 41 72 67 20 3d 20 70 ->pUpdateArg = p
10200 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d Arg;. sqlite3_m
10210 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
10220 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
10230 70 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 pRet;.}../*.** R
10240 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 61 egister a callba
10250 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 ck to be invoked
10260 20 65 61 63 68 20 74 69 6d 65 20 61 20 74 72 61 each time a tra
10270 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c nsaction is roll
10280 65 64 0a 2a 2a 20 62 61 63 6b 20 62 79 20 74 68 ed.** back by th
10290 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e is database conn
102a0 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 ection..*/.void
102b0 2a 73 71 6c 69 74 65 33 5f 72 6f 6c 6c 62 61 63 *sqlite3_rollbac
102c0 6b 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 k_hook(. sqlite
102d0 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
102e0 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 /* Attach th
102f0 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 e hook to this d
10300 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 atabase */. voi
10310 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 d (*xCallback)(v
10320 6f 69 64 2a 29 2c 20 2f 2a 20 43 61 6c 6c 62 61 oid*), /* Callba
10330 63 6b 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 ck function */.
10340 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 void *pArg
10350 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
10360 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 gument to the fu
10370 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 nction */.){. v
10380 6f 69 64 20 2a 70 52 65 74 3b 0a 0a 23 69 66 64 oid *pRet;..#ifd
10390 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
103a0 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
103b0 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
103c0 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
103d0 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
103e0 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
103f0 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 return 0;. }.#e
10400 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
10410 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
10420 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 utex);. pRet =
10430 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 db->pRollbackArg
10440 3b 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 ;. db->xRollbac
10450 6b 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c kCallback = xCal
10460 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 52 6f lback;. db->pRo
10470 6c 6c 62 61 63 6b 41 72 67 20 3d 20 70 41 72 67 llbackArg = pArg
10480 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
10490 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
104a0 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 65 x);. return pRe
104b0 74 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c t;.}..#ifdef SQL
104c0 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 ITE_ENABLE_PREUP
104d0 44 41 54 45 5f 48 4f 4f 4b 0a 2f 2a 0a 2a 2a 20 DATE_HOOK./*.**
104e0 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 Register a callb
104f0 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 ack to be invoke
10500 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 72 6f d each time a ro
10510 77 20 69 73 20 75 70 64 61 74 65 64 2c 0a 2a 2a w is updated,.**
10520 20 69 6e 73 65 72 74 65 64 20 6f 72 20 64 65 6c inserted or del
10530 65 74 65 64 20 75 73 69 6e 67 20 74 68 69 73 20 eted using this
10540 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
10550 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 ion..*/.void *sq
10560 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f lite3_preupdate_
10570 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 hook(. sqlite3
10580 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 *db,
10590 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 /* Attach the
105a0 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 hook to this dat
105b0 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 28 abase */. void(
105c0 2a 78 43 61 6c 6c 62 61 63 6b 29 28 20 20 20 20 *xCallback)(
105d0 20 20 20 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b /* Callback
105e0 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 function */.
105f0 20 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c void*,sqlite3*,
10600 69 6e 74 2c 63 68 61 72 20 63 6f 6e 73 74 2a 2c int,char const*,
10610 63 68 61 72 20 63 6f 6e 73 74 2a 2c 73 71 6c 69 char const*,sqli
10620 74 65 33 5f 69 6e 74 36 34 2c 73 71 6c 69 74 65 te3_int64,sqlite
10630 33 5f 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 64 3_int64),. void
10640 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
10650 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 63 /* First c
10660 61 6c 6c 62 61 63 6b 20 61 72 67 75 6d 65 6e 74 allback argument
10670 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 */.){. void *p
10680 52 65 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d Ret;. sqlite3_m
10690 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
106a0 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 utex);. pRet =
106b0 64 62 2d 3e 70 50 72 65 55 70 64 61 74 65 41 72 db->pPreUpdateAr
106c0 67 3b 0a 20 20 64 62 2d 3e 78 50 72 65 55 70 64 g;. db->xPreUpd
106d0 61 74 65 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 ateCallback = xC
106e0 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 allback;. db->p
106f0 50 72 65 55 70 64 61 74 65 41 72 67 20 3d 20 70 PreUpdateArg = p
10700 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d Arg;. sqlite3_m
10710 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
10720 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
10730 70 52 65 74 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f pRet;.}.#endif /
10740 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f * SQLITE_ENABLE_
10750 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a PREUPDATE_HOOK *
10760 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 /..#ifndef SQLIT
10770 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a E_OMIT_WAL./*.**
10780 20 54 68 65 20 73 71 6c 69 74 65 33 5f 77 61 6c The sqlite3_wal
10790 5f 68 6f 6f 6b 28 29 20 63 61 6c 6c 62 61 63 6b _hook() callback
107a0 20 72 65 67 69 73 74 65 72 65 64 20 62 79 20 73 registered by s
107b0 71 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 qlite3_wal_autoc
107c0 68 65 63 6b 70 6f 69 6e 74 28 29 2e 0a 2a 2a 20 heckpoint()..**
107d0 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 5f 77 Invoke sqlite3_w
107e0 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 20 69 66 al_checkpoint if
107f0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 the number of f
10800 72 61 6d 65 73 20 69 6e 20 74 68 65 20 6c 6f 67 rames in the log
10810 20 66 69 6c 65 0a 2a 2a 20 69 73 20 67 72 65 61 file.** is grea
10820 74 65 72 20 74 68 61 6e 20 73 71 6c 69 74 65 33 ter than sqlite3
10830 2e 70 57 61 6c 41 72 67 20 63 61 73 74 20 74 6f .pWalArg cast to
10840 20 61 6e 20 69 6e 74 65 67 65 72 20 28 74 68 65 an integer (the
10850 20 76 61 6c 75 65 20 63 6f 6e 66 69 67 75 72 65 value configure
10860 64 20 62 79 0a 2a 2a 20 77 61 6c 5f 61 75 74 6f d by.** wal_auto
10870 63 68 65 63 6b 70 6f 69 6e 74 28 29 29 2e 0a 2a checkpoint())..*
10880 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 / .int sqlite3Wa
10890 6c 44 65 66 61 75 6c 74 48 6f 6f 6b 28 0a 20 20 lDefaultHook(.
108a0 76 6f 69 64 20 2a 70 43 6c 69 65 6e 74 44 61 74 void *pClientDat
108b0 61 2c 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 a, /* Argume
108c0 6e 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 nt */. sqlite3
108d0 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 2f *db, /
108e0 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a * Connection */.
108f0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 const char *zD
10900 62 2c 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 b, /* Data
10910 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 base */. int nF
10920 72 61 6d 65 20 20 20 20 20 20 20 20 20 20 20 20 rame
10930 20 2f 2a 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 /* Size of WAL
10940 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 6e 46 72 61 */.){. if( nFra
10950 6d 65 3e 3d 53 51 4c 49 54 45 5f 50 54 52 5f 54 me>=SQLITE_PTR_T
10960 4f 5f 49 4e 54 28 70 43 6c 69 65 6e 74 44 61 74 O_INT(pClientDat
10970 61 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 a) ){. sqlite
10980 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
10990 6f 63 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 oc();. sqlite
109a0 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
109b0 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 20 20 73 (db, zDb);. s
109c0 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
109d0 61 6c 6c 6f 63 28 29 3b 0a 20 20 7d 0a 20 20 72 alloc();. }. r
109e0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
109f0 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
10a00 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f 0a ITE_OMIT_WAL */.
10a10 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 ./*.** Configure
10a20 20 61 6e 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f an sqlite3_wal_
10a30 68 6f 6f 6b 28 29 20 63 61 6c 6c 62 61 63 6b 20 hook() callback
10a40 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 to automatically
10a50 20 63 68 65 63 6b 70 6f 69 6e 74 0a 2a 2a 20 61 checkpoint.** a
10a60 20 64 61 74 61 62 61 73 65 20 61 66 74 65 72 20 database after
10a70 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 74 72 61 committing a tra
10a80 6e 73 61 63 74 69 6f 6e 20 69 66 20 74 68 65 72 nsaction if ther
10a90 65 20 61 72 65 20 6e 46 72 61 6d 65 20 6f 72 0a e are nFrame or.
10aa0 2a 2a 20 6d 6f 72 65 20 66 72 61 6d 65 73 20 69 ** more frames i
10ab0 6e 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 2e 20 n the log file.
10ac0 50 61 73 73 69 6e 67 20 7a 65 72 6f 20 6f 72 20 Passing zero or
10ad0 61 20 6e 65 67 61 74 69 76 65 20 76 61 6c 75 65 a negative value
10ae0 20 61 73 20 74 68 65 0a 2a 2a 20 6e 46 72 61 6d as the.** nFram
10af0 65 20 70 61 72 61 6d 65 74 65 72 20 64 69 73 61 e parameter disa
10b00 62 6c 65 73 20 61 75 74 6f 6d 61 74 69 63 20 63 bles automatic c
10b10 68 65 63 6b 70 6f 69 6e 74 73 20 65 6e 74 69 72 heckpoints entir
10b20 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 ely..**.** The c
10b30 61 6c 6c 62 61 63 6b 20 72 65 67 69 73 74 65 72 allback register
10b40 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
10b50 69 6f 6e 20 72 65 70 6c 61 63 65 73 20 61 6e 79 ion replaces any
10b60 20 65 78 69 73 74 69 6e 67 20 63 61 6c 6c 62 61 existing callba
10b70 63 6b 0a 2a 2a 20 72 65 67 69 73 74 65 72 65 64 ck.** registered
10b80 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 77 using sqlite3_w
10b90 61 6c 5f 68 6f 6f 6b 28 29 2e 20 4c 69 6b 65 77 al_hook(). Likew
10ba0 69 73 65 2c 20 72 65 67 69 73 74 65 72 69 6e 67 ise, registering
10bb0 20 61 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 75 a callback.** u
10bc0 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 77 61 6c sing sqlite3_wal
10bd0 5f 68 6f 6f 6b 28 29 20 64 69 73 61 62 6c 65 73 _hook() disables
10be0 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 63 the automatic c
10bf0 68 65 63 6b 70 6f 69 6e 74 20 6d 65 63 68 61 6e heckpoint mechan
10c00 69 73 6d 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 65 ism.** configure
10c10 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
10c20 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 on..*/.int sqlit
10c30 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b e3_wal_autocheck
10c40 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 point(sqlite3 *d
10c50 62 2c 20 69 6e 74 20 6e 46 72 61 6d 65 29 7b 0a b, int nFrame){.
10c60 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
10c70 49 54 5f 57 41 4c 0a 20 20 55 4e 55 53 45 44 5f IT_WAL. UNUSED_
10c80 50 41 52 41 4d 45 54 45 52 28 64 62 29 3b 0a 20 PARAMETER(db);.
10c90 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
10ca0 52 28 6e 46 72 61 6d 65 29 3b 0a 23 65 6c 73 65 R(nFrame);.#else
10cb0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
10cc0 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
10cd0 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
10ce0 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
10cf0 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
10d00 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e MISUSE_BKPT;.#en
10d10 64 69 66 0a 20 20 69 66 28 20 6e 46 72 61 6d 65 dif. if( nFrame
10d20 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 >0 ){. sqlite
10d30 33 5f 77 61 6c 5f 68 6f 6f 6b 28 64 62 2c 20 73 3_wal_hook(db, s
10d40 71 6c 69 74 65 33 57 61 6c 44 65 66 61 75 6c 74 qlite3WalDefault
10d50 48 6f 6f 6b 2c 20 53 51 4c 49 54 45 5f 49 4e 54 Hook, SQLITE_INT
10d60 5f 54 4f 5f 50 54 52 28 6e 46 72 61 6d 65 29 29 _TO_PTR(nFrame))
10d70 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
10d80 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 qlite3_wal_hook(
10d90 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 23 db, 0, 0);. }.#
10da0 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 53 endif. return S
10db0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
10dc0 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 61 ** Register a ca
10dd0 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 llback to be inv
10de0 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 oked each time a
10df0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
10e00 77 72 69 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 written.** into
10e10 74 68 65 20 77 72 69 74 65 2d 61 68 65 61 64 2d the write-ahead-
10e20 6c 6f 67 20 62 79 20 74 68 69 73 20 64 61 74 61 log by this data
10e30 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e base connection.
10e40 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
10e50 33 5f 77 61 6c 5f 68 6f 6f 6b 28 0a 20 20 73 71 3_wal_hook(. sq
10e60 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
10e70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
10e80 20 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b Attach the hook
10e90 20 74 6f 20 74 68 69 73 20 64 62 20 68 61 6e 64 to this db hand
10ea0 6c 65 20 2a 2f 0a 20 20 69 6e 74 28 2a 78 43 61 le */. int(*xCa
10eb0 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a 2c 20 llback)(void *,
10ec0 73 71 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 sqlite3*, const
10ed0 63 68 61 72 2a 2c 20 69 6e 74 29 2c 0a 20 20 76 char*, int),. v
10ee0 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 20 oid *pArg
10ef0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
10f00 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 * First argument
10f10 20 70 61 73 73 65 64 20 74 6f 20 78 43 61 6c 6c passed to xCall
10f20 62 61 63 6b 28 29 20 2a 2f 0a 29 7b 0a 23 69 66 back() */.){.#if
10f30 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
10f40 5f 57 41 4c 0a 20 20 76 6f 69 64 20 2a 70 52 65 _WAL. void *pRe
10f50 74 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 t;.#ifdef SQLITE
10f60 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
10f70 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
10f80 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
10f90 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 ) ){. (void)S
10fa0 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
10fb0 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b T;. return 0;
10fc0 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 . }.#endif. sq
10fd0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
10fe0 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
10ff0 70 52 65 74 20 3d 20 64 62 2d 3e 70 57 61 6c 41 pRet = db->pWalA
11000 72 67 3b 0a 20 20 64 62 2d 3e 78 57 61 6c 43 61 rg;. db->xWalCa
11010 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 llback = xCallba
11020 63 6b 3b 0a 20 20 64 62 2d 3e 70 57 61 6c 41 72 ck;. db->pWalAr
11030 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
11040 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
11050 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
11060 74 75 72 6e 20 70 52 65 74 3b 0a 23 65 6c 73 65 turn pRet;.#else
11070 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e . return 0;.#en
11080 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 dif.}../*.** Che
11090 63 6b 70 6f 69 6e 74 20 64 61 74 61 62 61 73 65 ckpoint database
110a0 20 7a 44 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c zDb..*/.int sql
110b0 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f ite3_wal_checkpo
110c0 69 6e 74 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 int_v2(. sqlite
110d0 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
110e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 /* Dat
110f0 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a abase handle */.
11100 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 const char *zD
11110 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
11120 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 61 74 74 /* Name of att
11130 61 63 68 65 64 20 64 61 74 61 62 61 73 65 20 28 ached database (
11140 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 69 6e or NULL) */. in
11150 74 20 65 4d 6f 64 65 2c 20 20 20 20 20 20 20 20 t eMode,
11160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
11170 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 SQLITE_CHECKPOI
11180 4e 54 5f 2a 20 76 61 6c 75 65 20 2a 2f 0a 20 20 NT_* value */.
11190 69 6e 74 20 2a 70 6e 4c 6f 67 2c 20 20 20 20 20 int *pnLog,
111a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
111b0 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 20 6f 66 20 /* OUT: Size of
111c0 57 41 4c 20 6c 6f 67 20 69 6e 20 66 72 61 6d 65 WAL log in frame
111d0 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 43 6b s */. int *pnCk
111e0 70 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 pt
111f0 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 /* OUT: T
11200 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 66 otal number of f
11210 72 61 6d 65 73 20 63 68 65 63 6b 70 6f 69 6e 74 rames checkpoint
11220 65 64 20 2a 2f 0a 29 7b 0a 23 69 66 64 65 66 20 ed */.){.#ifdef
11230 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
11240 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
11250 4f 4b 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 OK;.#else. int
11260 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
11270 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
11280 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
11290 69 6e 74 20 69 44 62 20 3d 20 53 51 4c 49 54 45 int iDb = SQLITE
112a0 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3b 20 20 _MAX_ATTACHED;
112b0 2f 2a 20 73 71 6c 69 74 65 33 2e 61 44 62 5b 5d /* sqlite3.aDb[]
112c0 20 69 6e 64 65 78 20 6f 66 20 64 62 20 74 6f 20 index of db to
112d0 63 68 65 63 6b 70 6f 69 6e 74 20 2a 2f 0a 0a 23 checkpoint */..#
112e0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
112f0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
11300 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
11310 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 tyCheckOk(db) )
11320 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
11330 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
11340 66 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 f.. /* Initiali
11350 7a 65 20 74 68 65 20 6f 75 74 70 75 74 20 76 61 ze the output va
11360 72 69 61 62 6c 65 73 20 74 6f 20 2d 31 20 69 6e riables to -1 in
11370 20 63 61 73 65 20 61 6e 20 65 72 72 6f 72 20 6f case an error o
11380 63 63 75 72 73 2e 20 2a 2f 0a 20 20 69 66 28 20 ccurs. */. if(
11390 70 6e 4c 6f 67 20 29 20 2a 70 6e 4c 6f 67 20 3d pnLog ) *pnLog =
113a0 20 2d 31 3b 0a 20 20 69 66 28 20 70 6e 43 6b 70 -1;. if( pnCkp
113b0 74 20 29 20 2a 70 6e 43 6b 70 74 20 3d 20 2d 31 t ) *pnCkpt = -1
113c0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c ;.. assert( SQL
113d0 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 ITE_CHECKPOINT_P
113e0 41 53 53 49 56 45 3d 3d 30 20 29 3b 0a 20 20 61 ASSIVE==0 );. a
113f0 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 ssert( SQLITE_CH
11400 45 43 4b 50 4f 49 4e 54 5f 46 55 4c 4c 3d 3d 31 ECKPOINT_FULL==1
11410 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 );. assert( SQ
11420 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
11430 52 45 53 54 41 52 54 3d 3d 32 20 29 3b 0a 20 20 RESTART==2 );.
11440 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 43 assert( SQLITE_C
11450 48 45 43 4b 50 4f 49 4e 54 5f 54 52 55 4e 43 41 HECKPOINT_TRUNCA
11460 54 45 3d 3d 33 20 29 3b 0a 20 20 69 66 28 20 65 TE==3 );. if( e
11470 4d 6f 64 65 3c 53 51 4c 49 54 45 5f 43 48 45 43 Mode<SQLITE_CHEC
11480 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 20 7c KPOINT_PASSIVE |
11490 7c 20 65 4d 6f 64 65 3e 53 51 4c 49 54 45 5f 43 | eMode>SQLITE_C
114a0 48 45 43 4b 50 4f 49 4e 54 5f 54 52 55 4e 43 41 HECKPOINT_TRUNCA
114b0 54 45 20 29 7b 0a 20 20 20 20 2f 2a 20 45 56 49 TE ){. /* EVI
114c0 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 33 39 39 DENCE-OF: R-0399
114d0 36 2d 31 32 30 38 38 20 54 68 65 20 4d 20 70 61 6-12088 The M pa
114e0 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 65 20 rameter must be
114f0 61 20 76 61 6c 69 64 20 63 68 65 63 6b 70 6f 69 a valid checkpoi
11500 6e 74 0a 20 20 20 20 2a 2a 20 6d 6f 64 65 3a 20 nt. ** mode:
11510 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 */. return SQ
11520 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d LITE_MISUSE;. }
11530 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 .. sqlite3_mute
11540 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
11550 78 29 3b 0a 20 20 69 66 28 20 7a 44 62 20 26 26 x);. if( zDb &&
11560 20 7a 44 62 5b 30 5d 20 29 7b 0a 20 20 20 20 69 zDb[0] ){. i
11570 44 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 Db = sqlite3Find
11580 44 62 4e 61 6d 65 28 64 62 2c 20 7a 44 62 29 3b DbName(db, zDb);
11590 0a 20 20 7d 0a 20 20 69 66 28 20 69 44 62 3c 30 . }. if( iDb<0
115a0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
115b0 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 73 ITE_ERROR;. s
115c0 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d qlite3ErrorWithM
115d0 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 sg(db, SQLITE_ER
115e0 52 4f 52 2c 20 22 75 6e 6b 6e 6f 77 6e 20 64 61 ROR, "unknown da
115f0 74 61 62 61 73 65 3a 20 25 73 22 2c 20 7a 44 62 tabase: %s", zDb
11600 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
11610 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e db->busyHandler.
11620 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 20 20 72 nBusy = 0;. r
11630 63 20 3d 20 73 71 6c 69 74 65 33 43 68 65 63 6b c = sqlite3Check
11640 70 6f 69 6e 74 28 64 62 2c 20 69 44 62 2c 20 65 point(db, iDb, e
11650 4d 6f 64 65 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 Mode, pnLog, pnC
11660 6b 70 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 kpt);. sqlite
11670 33 45 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 3Error(db, rc);.
11680 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
11690 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 e3ApiExit(db, rc
116a0 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 );.. /* If ther
116b0 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 e are no active
116c0 73 74 61 74 65 6d 65 6e 74 73 2c 20 63 6c 65 61 statements, clea
116d0 72 20 74 68 65 20 69 6e 74 65 72 72 75 70 74 20 r the interrupt
116e0 66 6c 61 67 20 61 74 20 74 68 69 73 0a 20 20 2a flag at this. *
116f0 2a 20 70 6f 69 6e 74 2e 20 20 2a 2f 0a 20 20 69 * point. */. i
11700 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 74 69 f( db->nVdbeActi
11710 76 65 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d ve==0 ){. db-
11720 3e 75 31 2e 69 73 49 6e 74 65 72 72 75 70 74 65 >u1.isInterrupte
11730 64 20 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 73 71 d = 0;. }.. sq
11740 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
11750 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
11760 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
11770 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 f.}.../*.** Chec
11780 6b 70 6f 69 6e 74 20 64 61 74 61 62 61 73 65 20 kpoint database
11790 7a 44 62 2e 20 49 66 20 7a 44 62 20 69 73 20 4e zDb. If zDb is N
117a0 55 4c 4c 2c 20 6f 72 20 69 66 20 74 68 65 20 62 ULL, or if the b
117b0 75 66 66 65 72 20 7a 44 62 20 70 6f 69 6e 74 73 uffer zDb points
117c0 0a 2a 2a 20 74 6f 20 63 6f 6e 74 61 69 6e 73 20 .** to contains
117d0 61 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 20 73 74 a zero-length st
117e0 72 69 6e 67 2c 20 61 6c 6c 20 61 74 74 61 63 68 ring, all attach
117f0 65 64 20 64 61 74 61 62 61 73 65 73 20 61 72 65 ed databases are
11800 20 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 .** checkpointe
11810 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
11820 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
11830 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f (sqlite3 *db, co
11840 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 29 7b 0a nst char *zDb){.
11850 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
11860 3a 20 52 2d 34 31 36 31 33 2d 32 30 35 35 33 20 : R-41613-20553
11870 54 68 65 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f The sqlite3_wal_
11880 63 68 65 63 6b 70 6f 69 6e 74 28 44 2c 58 29 20 checkpoint(D,X)
11890 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f is equivalent to
118a0 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 77 61 . ** sqlite3_wa
118b0 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 l_checkpoint_v2(
118c0 44 2c 58 2c 53 51 4c 49 54 45 5f 43 48 45 43 4b D,X,SQLITE_CHECK
118d0 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 30 2c POINT_PASSIVE,0,
118e0 30 29 2e 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 0). */. return
118f0 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 sqlite3_wal_chec
11900 6b 70 6f 69 6e 74 5f 76 32 28 64 62 2c 7a 44 62 kpoint_v2(db,zDb
11910 2c 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 ,SQLITE_CHECKPOI
11920 4e 54 5f 50 41 53 53 49 56 45 2c 30 2c 30 29 3b NT_PASSIVE,0,0);
11930 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
11940 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a TE_OMIT_WAL./*.*
11950 2a 20 52 75 6e 20 61 20 63 68 65 63 6b 70 6f 69 * Run a checkpoi
11960 6e 74 20 6f 6e 20 64 61 74 61 62 61 73 65 20 69 nt on database i
11970 44 62 2e 20 54 68 69 73 20 69 73 20 61 20 6e 6f Db. This is a no
11980 2d 6f 70 20 69 66 20 64 61 74 61 62 61 73 65 20 -op if database
11990 69 44 62 20 69 73 0a 2a 2a 20 6e 6f 74 20 63 75 iDb is.** not cu
119a0 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 69 6e 20 rrently open in
119b0 57 41 4c 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 WAL mode..**.**
119c0 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
119d0 20 69 73 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 is open on the
119e0 64 61 74 61 62 61 73 65 20 62 65 69 6e 67 20 63 database being c
119f0 68 65 63 6b 70 6f 69 6e 74 65 64 2c 20 74 68 69 heckpointed, thi
11a00 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72 s .** function r
11a10 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4c 4f eturns SQLITE_LO
11a20 43 4b 45 44 20 61 6e 64 20 61 20 63 68 65 63 6b CKED and a check
11a30 70 6f 69 6e 74 20 69 73 20 6e 6f 74 20 61 74 74 point is not att
11a40 65 6d 70 74 65 64 2e 20 49 66 20 0a 2a 2a 20 61 empted. If .** a
11a50 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 n error occurs w
11a60 68 69 6c 65 20 72 75 6e 6e 69 6e 67 20 74 68 65 hile running the
11a70 20 63 68 65 63 6b 70 6f 69 6e 74 2c 20 61 6e 20 checkpoint, an
11a80 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
11a90 65 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 e is .** returne
11aa0 64 20 28 69 2e 65 2e 20 53 51 4c 49 54 45 5f 49 d (i.e. SQLITE_I
11ab0 4f 45 52 52 29 2e 20 4f 74 68 65 72 77 69 73 65 OERR). Otherwise
11ac0 2c 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a , SQLITE_OK..**.
11ad0 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 6f 6e 20 ** The mutex on
11ae0 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
11af0 64 62 20 73 68 6f 75 6c 64 20 62 65 20 68 65 6c db should be hel
11b00 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 2e d by the caller.
11b10 20 54 68 65 20 6d 75 74 65 78 0a 2a 2a 20 61 73 The mutex.** as
11b20 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
11b30 65 20 73 70 65 63 69 66 69 63 20 62 2d 74 72 65 e specific b-tre
11b40 65 20 62 65 69 6e 67 20 63 68 65 63 6b 70 6f 69 e being checkpoi
11b50 6e 74 65 64 20 69 73 20 74 61 6b 65 6e 20 62 79 nted is taken by
11b60 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 6f .** this functio
11b70 6e 20 77 68 69 6c 65 20 74 68 65 20 63 68 65 63 n while the chec
11b80 6b 70 6f 69 6e 74 20 69 73 20 72 75 6e 6e 69 6e kpoint is runnin
11b90 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 69 44 62 20 g..**.** If iDb
11ba0 69 73 20 70 61 73 73 65 64 20 53 51 4c 49 54 45 is passed SQLITE
11bb0 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 2c 20 74 _MAX_ATTACHED, t
11bc0 68 65 6e 20 61 6c 6c 20 61 74 74 61 63 68 65 64 hen all attached
11bd0 20 64 61 74 61 62 61 73 65 73 20 61 72 65 0a 2a databases are.*
11be0 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 2e 20 * checkpointed.
11bf0 49 66 20 61 6e 20 65 72 72 6f 72 20 69 73 20 65 If an error is e
11c00 6e 63 6f 75 6e 74 65 72 65 64 20 69 74 20 69 73 ncountered it is
11c10 20 72 65 74 75 72 6e 65 64 20 69 6d 6d 65 64 69 returned immedi
11c20 61 74 65 6c 79 20 2d 0a 2a 2a 20 6e 6f 20 61 74 ately -.** no at
11c30 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f tempt is made to
11c40 20 63 68 65 63 6b 70 6f 69 6e 74 20 61 6e 79 20 checkpoint any
11c50 72 65 6d 61 69 6e 69 6e 67 20 64 61 74 61 62 61 remaining databa
11c60 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d ses..**.** Param
11c70 65 74 65 72 20 65 4d 6f 64 65 20 69 73 20 6f 6e eter eMode is on
11c80 65 20 6f 66 20 53 51 4c 49 54 45 5f 43 48 45 43 e of SQLITE_CHEC
11c90 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 20 KPOINT_PASSIVE,
11ca0 46 55 4c 4c 20 6f 72 20 52 45 53 54 41 52 54 2e FULL or RESTART.
11cb0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 .*/.int sqlite3C
11cc0 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 heckpoint(sqlite
11cd0 33 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 3 *db, int iDb,
11ce0 69 6e 74 20 65 4d 6f 64 65 2c 20 69 6e 74 20 2a int eMode, int *
11cf0 70 6e 4c 6f 67 2c 20 69 6e 74 20 2a 70 6e 43 6b pnLog, int *pnCk
11d00 70 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 pt){. int rc =
11d10 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
11d20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
11d30 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 code */. int i
11d40 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
11d50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 /* Us
11d60 65 64 20 74 6f 20 69 74 65 72 61 74 65 20 74 68 ed to iterate th
11d70 72 6f 75 67 68 20 61 74 74 61 63 68 65 64 20 64 rough attached d
11d80 62 73 20 2a 2f 0a 20 20 69 6e 74 20 62 42 75 73 bs */. int bBus
11d90 79 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 y = 0;
11da0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
11db0 69 66 20 53 51 4c 49 54 45 5f 42 55 53 59 20 68 if SQLITE_BUSY h
11dc0 61 73 20 62 65 65 6e 20 65 6e 63 6f 75 6e 74 65 as been encounte
11dd0 72 65 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 red */.. assert
11de0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
11df0 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
11e00 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 6e );. assert( !pn
11e10 4c 6f 67 20 7c 7c 20 2a 70 6e 4c 6f 67 3d 3d 2d Log || *pnLog==-
11e20 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 1 );. assert( !
11e30 70 6e 43 6b 70 74 20 7c 7c 20 2a 70 6e 43 6b 70 pnCkpt || *pnCkp
11e40 74 3d 3d 2d 31 20 29 3b 0a 0a 20 20 66 6f 72 28 t==-1 );.. for(
11e50 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 20 26 i=0; i<db->nDb &
11e60 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b & rc==SQLITE_OK;
11e70 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 69 i++){. if( i
11e80 3d 3d 69 44 62 20 7c 7c 20 69 44 62 3d 3d 53 51 ==iDb || iDb==SQ
11e90 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 LITE_MAX_ATTACHE
11ea0 44 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 D ){. rc =
11eb0 73 71 6c 69 74 65 33 42 74 72 65 65 43 68 65 63 sqlite3BtreeChec
11ec0 6b 70 6f 69 6e 74 28 64 62 2d 3e 61 44 62 5b 69 kpoint(db->aDb[i
11ed0 5d 2e 70 42 74 2c 20 65 4d 6f 64 65 2c 20 70 6e ].pBt, eMode, pn
11ee0 4c 6f 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 Log, pnCkpt);.
11ef0 20 20 20 20 70 6e 4c 6f 67 20 3d 20 30 3b 0a 20 pnLog = 0;.
11f00 20 20 20 20 20 70 6e 43 6b 70 74 20 3d 20 30 3b pnCkpt = 0;
11f10 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
11f20 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 QLITE_BUSY ){.
11f30 20 20 20 20 20 20 62 42 75 73 79 20 3d 20 31 3b bBusy = 1;
11f40 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
11f50 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
11f60 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 . }. }.. re
11f70 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 turn (rc==SQLITE
11f80 5f 4f 4b 20 26 26 20 62 42 75 73 79 29 20 3f 20 _OK && bBusy) ?
11f90 53 51 4c 49 54 45 5f 42 55 53 59 20 3a 20 72 63 SQLITE_BUSY : rc
11fa0 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
11fb0 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f LITE_OMIT_WAL */
11fc0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
11fd0 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 72 ction returns tr
11fe0 75 65 20 69 66 20 6d 61 69 6e 2d 6d 65 6d 6f 72 ue if main-memor
11ff0 79 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 y should be used
12000 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20 61 instead of.** a
12010 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 temporary file
12020 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 20 70 61 for transient pa
12030 67 65 72 20 66 69 6c 65 73 20 61 6e 64 20 73 74 ger files and st
12040 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 73 atement journals
12050 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 72 ..** The value r
12060 65 74 75 72 6e 65 64 20 64 65 70 65 6e 64 73 20 eturned depends
12070 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 on the value of
12080 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 28 db->temp_store (
12090 72 75 6e 74 69 6d 65 0a 2a 2a 20 70 61 72 61 6d runtime.** param
120a0 65 74 65 72 29 20 61 6e 64 20 74 68 65 20 63 6f eter) and the co
120b0 6d 70 69 6c 65 20 74 69 6d 65 20 76 61 6c 75 65 mpile time value
120c0 20 6f 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f of SQLITE_TEMP_
120d0 53 54 4f 52 45 2e 20 54 68 65 0a 2a 2a 20 66 6f STORE. The.** fo
120e0 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 64 65 llowing table de
120f0 73 63 72 69 62 65 73 20 74 68 65 20 72 65 6c 61 scribes the rela
12100 74 69 6f 6e 73 68 69 70 20 62 65 74 77 65 65 6e tionship between
12110 20 74 68 65 73 65 20 74 77 6f 20 76 61 6c 75 65 these two value
12120 73 0a 2a 2a 20 61 6e 64 20 74 68 69 73 20 66 75 s.** and this fu
12130 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e 20 76 nctions return v
12140 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 53 51 alue..**.** SQ
12150 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 20 LITE_TEMP_STORE
12160 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f db->temp_sto
12170 72 65 20 20 20 20 20 4c 6f 63 61 74 69 6f 6e 20 re Location
12180 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 of temporary dat
12190 61 62 61 73 65 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d abase.** -----
121a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 ------------
121b0 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 --------------
121c0 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ------------
121d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
121e0 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 20 20 20 --.** 0
121f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e an
12200 79 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y
12210 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 file (retu
12220 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 20 20 20 rn 0).** 1
12230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12240 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
12250 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 72 file (r
12260 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 eturn 0).** 1
12270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12280 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 2
12290 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 memory
122a0 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 (return 1).**
122b0 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
122c0 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 0
122d0 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 file
122e0 20 20 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a (return 0).*
122f0 2a 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 * 2
12300 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 1
12310 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c fil
12320 65 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 30 e (return 0
12330 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 20 20 ).** 2
12340 20 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 2
12350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12360 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 74 75 72 memory (retur
12370 6e 20 31 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 n 1).** 2
12380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12390 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
123a0 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 memory (re
123b0 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 33 20 20 turn 1).** 3
123c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
123d0 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 any
123e0 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 memory
123f0 28 72 65 74 75 72 6e 20 31 29 0a 2a 2f 0a 69 6e (return 1).*/.in
12400 74 20 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d t sqlite3TempInM
12410 65 6d 6f 72 79 28 63 6f 6e 73 74 20 73 71 6c 69 emory(const sqli
12420 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 20 53 51 te3 *db){.#if SQ
12430 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
12440 3d 31 0a 20 20 72 65 74 75 72 6e 20 28 20 64 62 =1. return ( db
12450 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 ->temp_store==2
12460 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 );.#endif.#if SQ
12470 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
12480 3d 32 0a 20 20 72 65 74 75 72 6e 20 28 20 64 62 =2. return ( db
12490 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 21 3d 31 20 ->temp_store!=1
124a0 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 );.#endif.#if SQ
124b0 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
124c0 3d 33 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 =3. UNUSED_PARA
124d0 4d 45 54 45 52 28 64 62 29 3b 0a 20 20 72 65 74 METER(db);. ret
124e0 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 23 69 urn 1;.#endif.#i
124f0 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 f SQLITE_TEMP_ST
12500 4f 52 45 3c 31 20 7c 7c 20 53 51 4c 49 54 45 5f ORE<1 || SQLITE_
12510 54 45 4d 50 5f 53 54 4f 52 45 3e 33 0a 20 20 55 TEMP_STORE>3. U
12520 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
12530 64 62 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b db);. return 0;
12540 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
12550 20 52 65 74 75 72 6e 20 55 54 46 2d 38 20 65 6e Return UTF-8 en
12560 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 coded English la
12570 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 nguage explanati
12580 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 on of the most r
12590 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a ecent.** error..
125a0 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
125b0 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 73 71 qlite3_errmsg(sq
125c0 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 63 6f lite3 *db){. co
125d0 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69 nst char *z;. i
125e0 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 72 65 f( !db ){. re
125f0 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 turn sqlite3ErrS
12600 74 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f tr(SQLITE_NOMEM_
12610 42 4b 50 54 29 3b 0a 20 20 7d 0a 20 20 69 66 28 BKPT);. }. if(
12620 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
12630 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
12640 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 ){. return s
12650 71 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 4c qlite3ErrStr(SQL
12660 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 29 ITE_MISUSE_BKPT)
12670 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
12680 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
12690 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 64 62 mutex);. if( db
126a0 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
126b0 7b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 {. z = sqlite
126c0 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 3ErrStr(SQLITE_N
126d0 4f 4d 45 4d 5f 42 4b 50 54 29 3b 0a 20 20 7d 65 OMEM_BKPT);. }e
126e0 6c 73 65 7b 0a 20 20 20 20 74 65 73 74 63 61 73 lse{. testcas
126f0 65 28 20 64 62 2d 3e 70 45 72 72 3d 3d 30 20 29 e( db->pErr==0 )
12700 3b 0a 20 20 20 20 7a 20 3d 20 28 63 68 61 72 2a ;. z = (char*
12710 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 )sqlite3_value_t
12720 65 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 ext(db->pErr);.
12730 20 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e assert( !db->
12740 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a mallocFailed );.
12750 20 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 7b 0a if( z==0 ){.
12760 20 20 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 z = sqlite
12770 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 72 43 3ErrStr(db->errC
12780 6f 64 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a ode);. }. }.
12790 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
127a0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
127b0 3b 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a ;. return z;.}.
127c0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
127d0 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a OMIT_UTF16./*.**
127e0 20 52 65 74 75 72 6e 20 55 54 46 2d 31 36 20 65 Return UTF-16 e
127f0 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c ncoded English l
12800 61 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 anguage explanat
12810 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 ion of the most
12820 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e recent.** error.
12830 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a .*/.const void *
12840 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 sqlite3_errmsg16
12850 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 (sqlite3 *db){.
12860 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 31 static const u1
12870 36 20 6f 75 74 4f 66 4d 65 6d 5b 5d 20 3d 20 7b 6 outOfMem[] = {
12880 0a 20 20 20 20 27 6f 27 2c 20 27 75 27 2c 20 27 . 'o', 'u', '
12890 74 27 2c 20 27 20 27 2c 20 27 6f 27 2c 20 27 66 t', ' ', 'o', 'f
128a0 27 2c 20 27 20 27 2c 20 27 6d 27 2c 20 27 65 27 ', ' ', 'm', 'e'
128b0 2c 20 27 6d 27 2c 20 27 6f 27 2c 20 27 72 27 2c , 'm', 'o', 'r',
128c0 20 27 79 27 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 'y', 0. };. s
128d0 74 61 74 69 63 20 63 6f 6e 73 74 20 75 31 36 20 tatic const u16
128e0 6d 69 73 75 73 65 5b 5d 20 3d 20 7b 0a 20 20 20 misuse[] = {.
128f0 20 27 62 27 2c 20 27 61 27 2c 20 27 64 27 2c 20 'b', 'a', 'd',
12900 27 20 27 2c 20 27 70 27 2c 20 27 61 27 2c 20 27 ' ', 'p', 'a', '
12910 72 27 2c 20 27 61 27 2c 20 27 6d 27 2c 20 27 65 r', 'a', 'm', 'e
12920 27 2c 20 27 74 27 2c 20 27 65 27 2c 20 27 72 27 ', 't', 'e', 'r'
12930 2c 20 27 20 27 2c 0a 20 20 20 20 27 6f 27 2c 20 , ' ',. 'o',
12940 27 72 27 2c 20 27 20 27 2c 20 27 6f 27 2c 20 27 'r', ' ', 'o', '
12950 74 27 2c 20 27 68 27 2c 20 27 65 27 2c 20 27 72 t', 'h', 'e', 'r
12960 27 2c 20 27 20 27 2c 20 27 41 27 2c 20 27 50 27 ', ' ', 'A', 'P'
12970 2c 20 27 49 27 2c 20 27 20 27 2c 0a 20 20 20 20 , 'I', ' ',.
12980 27 6d 27 2c 20 27 69 27 2c 20 27 73 27 2c 20 27 'm', 'i', 's', '
12990 75 27 2c 20 27 73 27 2c 20 27 65 27 2c 20 30 0a u', 's', 'e', 0.
129a0 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 76 6f };.. const vo
129b0 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 62 id *z;. if( !db
129c0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 ){. return (
129d0 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 6d 3b void *)outOfMem;
129e0 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 . }. if( !sqli
129f0 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 te3SafetyCheckSi
12a00 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 ckOrOk(db) ){.
12a10 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a return (void *
12a20 29 6d 69 73 75 73 65 3b 0a 20 20 7d 0a 20 20 73 )misuse;. }. s
12a30 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
12a40 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
12a50 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
12a60 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d ailed ){. z =
12a70 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 (void *)outOfMe
12a80 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 m;. }else{.
12a90 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 z = sqlite3_valu
12aa0 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 e_text16(db->pEr
12ab0 72 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 r);. if( z==0
12ac0 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
12ad0 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 3ErrorWithMsg(db
12ae0 2c 20 64 62 2d 3e 65 72 72 43 6f 64 65 2c 20 73 , db->errCode, s
12af0 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 2d qlite3ErrStr(db-
12b00 3e 65 72 72 43 6f 64 65 29 29 3b 0a 20 20 20 20 >errCode));.
12b10 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 z = sqlite3_va
12b20 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 lue_text16(db->p
12b30 45 72 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Err);. }.
12b40 2f 2a 20 41 20 6d 61 6c 6c 6f 63 28 29 20 6d 61 /* A malloc() ma
12b50 79 20 68 61 76 65 20 66 61 69 6c 65 64 20 77 69 y have failed wi
12b60 74 68 69 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f thin the call to
12b70 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
12b80 65 78 74 31 36 28 29 0a 20 20 20 20 2a 2a 20 61 ext16(). ** a
12b90 62 6f 76 65 2e 20 49 66 20 74 68 69 73 20 69 73 bove. If this is
12ba0 20 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 20 the case, then
12bb0 74 68 65 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 the db->mallocFa
12bc0 69 6c 65 64 20 66 6c 61 67 20 6e 65 65 64 73 20 iled flag needs
12bd0 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 63 6c 65 to. ** be cle
12be0 61 72 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 ared before retu
12bf0 72 6e 69 6e 67 2e 20 44 6f 20 74 68 69 73 20 64 rning. Do this d
12c00 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 irectly, instead
12c10 20 6f 66 20 76 69 61 0a 20 20 20 20 2a 2a 20 73 of via. ** s
12c20 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 29 2c qlite3ApiExit(),
12c30 20 74 6f 20 61 76 6f 69 64 20 73 65 74 74 69 6e to avoid settin
12c40 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 g the database h
12c50 61 6e 64 6c 65 20 65 72 72 6f 72 20 6d 65 73 73 andle error mess
12c60 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 age.. */.
12c70 73 71 6c 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 sqlite3OomClear(
12c80 64 62 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 db);. }. sqlit
12c90 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
12ca0 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
12cb0 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 urn z;.}.#endif
12cc0 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
12cd0 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
12ce0 65 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20 72 eturn the most r
12cf0 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 ecent error code
12d00 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e generated by an
12d10 20 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65 2e SQLite routine.
12d20 20 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 If NULL is.** p
12d30 61 73 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 assed to this fu
12d40 6e 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75 6d nction, we assum
12d50 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 e a malloc() fai
12d60 6c 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69 74 led during sqlit
12d70 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e e3_open()..*/.in
12d80 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 t sqlite3_errcod
12d90 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a e(sqlite3 *db){.
12da0 20 20 69 66 28 20 64 62 20 26 26 20 21 73 71 6c if( db && !sql
12db0 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
12dc0 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 ickOrOk(db) ){.
12dd0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
12de0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
12df0 7d 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 64 }. if( !db || d
12e00 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
12e10 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
12e20 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
12e30 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 . }. return db
12e40 2d 3e 65 72 72 43 6f 64 65 20 26 20 64 62 2d 3e ->errCode & db->
12e50 65 72 72 4d 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 errMask;.}.int s
12e60 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 64 5f qlite3_extended_
12e70 65 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 errcode(sqlite3
12e80 2a 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 *db){. if( db &
12e90 26 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 & !sqlite3Safety
12ea0 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 CheckSickOrOk(db
12eb0 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
12ec0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
12ed0 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 PT;. }. if( !d
12ee0 62 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 b || db->mallocF
12ef0 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 ailed ){. ret
12f00 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
12f10 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 65 74 _BKPT;. }. ret
12f20 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 3b urn db->errCode;
12f30 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 .}.int sqlite3_s
12f40 79 73 74 65 6d 5f 65 72 72 6e 6f 28 73 71 6c 69 ystem_errno(sqli
12f50 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
12f60 72 6e 20 64 62 20 3f 20 64 62 2d 3e 69 53 79 73 rn db ? db->iSys
12f70 45 72 72 6e 6f 20 3a 20 30 3b 0a 7d 20 20 0a 0a Errno : 0;.} ..
12f80 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 /*.** Return a s
12f90 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 tring that descr
12fa0 69 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 ibes the kind of
12fb0 20 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 error specified
12fc0 20 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d in the.** argum
12fd0 65 6e 74 2e 20 20 46 6f 72 20 6e 6f 77 2c 20 74 ent. For now, t
12fe0 68 69 73 20 73 69 6d 70 6c 79 20 63 61 6c 6c 73 his simply calls
12ff0 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 71 the internal sq
13000 6c 69 74 65 33 45 72 72 53 74 72 28 29 0a 2a 2a lite3ErrStr().**
13010 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 63 6f function..*/.co
13020 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
13030 33 5f 65 72 72 73 74 72 28 69 6e 74 20 72 63 29 3_errstr(int rc)
13040 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 {. return sqlit
13050 65 33 45 72 72 53 74 72 28 72 63 29 3b 0a 7d 0a e3ErrStr(rc);.}.
13060 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 ./*.** Create a
13070 6e 65 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 new collating fu
13080 6e 63 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 nction for datab
13090 61 73 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e ase "db". The n
130a0 61 6d 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 ame is zName.**
130b0 61 6e 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 and the encoding
130c0 20 69 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 is enc..*/.stat
130d0 69 63 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c ic int createCol
130e0 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 lation(. sqlite
130f0 33 2a 20 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 3* db,. const c
13100 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 75 har *zName, . u
13110 38 20 65 6e 63 2c 0a 20 20 76 6f 69 64 2a 20 70 8 enc,. void* p
13120 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d Ctx,. int(*xCom
13130 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c pare)(void*,int,
13140 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c const void*,int,
13150 63 6f 6e 73 74 20 76 6f 69 64 2a 29 2c 0a 20 20 const void*),.
13160 76 6f 69 64 28 2a 78 44 65 6c 29 28 76 6f 69 64 void(*xDel)(void
13170 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 *).){. CollSeq
13180 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 65 6e *pColl;. int en
13190 63 32 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 c2;. . assert(
131a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
131b0 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
131c0 3b 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 ;.. /* If SQLIT
131d0 45 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69 E_UTF16 is speci
131e0 66 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f fied as the enco
131f0 64 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 ding type, trans
13200 66 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 form this. ** t
13210 6f 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f o one of SQLITE_
13220 55 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 UTF16LE or SQLIT
13230 45 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 E_UTF16BE using
13240 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f the. ** SQLITE_
13250 55 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 UTF16NATIVE macr
13260 6f 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 o. SQLITE_UTF16
13270 69 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 is not used inte
13280 72 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 rnally.. */. e
13290 6e 63 32 20 3d 20 65 6e 63 3b 0a 20 20 74 65 73 nc2 = enc;. tes
132a0 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c tcase( enc2==SQL
132b0 49 54 45 5f 55 54 46 31 36 20 29 3b 0a 20 20 74 ITE_UTF16 );. t
132c0 65 73 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 estcase( enc2==S
132d0 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 QLITE_UTF16_ALIG
132e0 4e 45 44 20 29 3b 0a 20 20 69 66 28 20 65 6e 63 NED );. if( enc
132f0 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 2==SQLITE_UTF16
13300 7c 7c 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f || enc2==SQLITE_
13310 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 7b UTF16_ALIGNED ){
13320 0a 20 20 20 20 65 6e 63 32 20 3d 20 53 51 4c 49 . enc2 = SQLI
13330 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a TE_UTF16NATIVE;.
13340 20 20 7d 0a 20 20 69 66 28 20 65 6e 63 32 3c 53 }. if( enc2<S
13350 51 4c 49 54 45 5f 55 54 46 38 20 7c 7c 20 65 6e QLITE_UTF8 || en
13360 63 32 3e 53 51 4c 49 54 45 5f 55 54 46 31 36 42 c2>SQLITE_UTF16B
13370 45 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 E ){. return
13380 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
13390 50 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 PT;. }.. /* Ch
133a0 65 63 6b 20 69 66 20 74 68 69 73 20 63 61 6c 6c eck if this call
133b0 20 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f 72 20 is removing or
133c0 72 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 78 69 replacing an exi
133d0 73 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 sting collation
133e0 0a 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 2e 20 . ** sequence.
133f0 49 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 72 65 If so, and there
13400 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c are active VMs,
13410 20 72 65 74 75 72 6e 20 62 75 73 79 2e 20 49 66 return busy. If
13420 20 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 65 20 there. ** are
13430 6e 6f 20 61 63 74 69 76 65 20 56 4d 73 2c 20 69 no active VMs, i
13440 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 70 72 nvalidate any pr
13450 65 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 e-compiled state
13460 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 43 ments.. */. pC
13470 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e oll = sqlite3Fin
13480 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 dCollSeq(db, (u8
13490 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 30 29 )enc2, zName, 0)
134a0 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 26 ;. if( pColl &&
134b0 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a pColl->xCmp ){.
134c0 20 20 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 if( db->nVdb
134d0 65 41 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 eActive ){.
134e0 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 sqlite3ErrorWit
134f0 68 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f hMsg(db, SQLITE_
13500 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
13510 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 unable to delete
13520 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f /modify collatio
13530 6e 20 73 65 71 75 65 6e 63 65 20 64 75 65 20 74 n sequence due t
13540 6f 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 o active stateme
13550 6e 74 73 22 29 3b 0a 20 20 20 20 20 20 72 65 74 nts");. ret
13560 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
13570 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
13580 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64 e3ExpirePrepared
13590 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a Statements(db);.
135a0 0a 20 20 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 . /* If colla
135b0 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 70 43 tion sequence pC
135c0 6f 6c 6c 20 77 61 73 20 63 72 65 61 74 65 64 20 oll was created
135d0 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 61 directly by a ca
135e0 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c ll to. ** sql
135f0 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
13600 61 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 ation, and not g
13610 65 6e 65 72 61 74 65 64 20 62 79 20 73 79 6e 74 enerated by synt
13620 68 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 hCollSeq(),.
13630 2a 2a 20 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 ** then any copi
13640 65 73 20 6d 61 64 65 20 62 79 20 73 79 6e 74 68 es made by synth
13650 43 6f 6c 6c 53 65 71 28 29 20 6e 65 65 64 20 74 CollSeq() need t
13660 6f 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 o be invalidated
13670 2e 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 .. ** Also, c
13680 6f 6c 6c 61 74 69 6f 6e 20 64 65 73 74 72 75 63 ollation destruc
13690 74 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 tor - CollSeq.xD
136a0 65 6c 28 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 el() - function
136b0 6d 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 may need. **
136c0 74 6f 20 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 to be called..
136d0 20 20 2a 2f 20 0a 20 20 20 20 69 66 28 20 28 70 */ . if( (p
136e0 43 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c Coll->enc & ~SQL
136f0 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 ITE_UTF16_ALIGNE
13700 44 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 D)==enc2 ){.
13710 20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c CollSeq *aColl
13720 20 3d 20 73 71 6c 69 74 65 33 48 61 73 68 46 69 = sqlite3HashFi
13730 6e 64 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 nd(&db->aCollSeq
13740 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 , zName);.
13750 69 6e 74 20 6a 3b 0a 20 20 20 20 20 20 66 6f 72 int j;. for
13760 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b (j=0; j<3; j++){
13770 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 . CollSeq
13780 20 2a 70 20 3d 20 26 61 43 6f 6c 6c 5b 6a 5d 3b *p = &aColl[j];
13790 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e . if( p->
137a0 65 6e 63 3d 3d 70 43 6f 6c 6c 2d 3e 65 6e 63 20 enc==pColl->enc
137b0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 ){. if(
137c0 20 70 2d 3e 78 44 65 6c 20 29 7b 0a 20 20 20 20 p->xDel ){.
137d0 20 20 20 20 20 20 20 20 70 2d 3e 78 44 65 6c 28 p->xDel(
137e0 70 2d 3e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 p->pUser);.
137f0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
13800 20 70 2d 3e 78 43 6d 70 20 3d 20 30 3b 0a 20 20 p->xCmp = 0;.
13810 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
13820 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 43 6f }. }.. pCo
13830 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 ll = sqlite3Find
13840 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 CollSeq(db, (u8)
13850 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 31 29 3b enc2, zName, 1);
13860 0a 20 20 69 66 28 20 70 43 6f 6c 6c 3d 3d 30 20 . if( pColl==0
13870 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
13880 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 70 43 NOMEM_BKPT;. pC
13890 6f 6c 6c 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d oll->xCmp = xCom
138a0 70 61 72 65 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 70 pare;. pColl->p
138b0 55 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 70 User = pCtx;. p
138c0 43 6f 6c 6c 2d 3e 78 44 65 6c 20 3d 20 78 44 65 Coll->xDel = xDe
138d0 6c 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 l;. pColl->enc
138e0 3d 20 28 75 38 29 28 65 6e 63 32 20 7c 20 28 65 = (u8)(enc2 | (e
138f0 6e 63 20 26 20 53 51 4c 49 54 45 5f 55 54 46 31 nc & SQLITE_UTF1
13900 36 5f 41 4c 49 47 4e 45 44 29 29 3b 0a 20 20 73 6_ALIGNED));. s
13910 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
13920 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 72 65 SQLITE_OK);. re
13930 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
13940 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 61 }.../*.** This a
13950 72 72 61 79 20 64 65 66 69 6e 65 73 20 68 61 72 rray defines har
13960 64 20 75 70 70 65 72 20 62 6f 75 6e 64 73 20 6f d upper bounds o
13970 6e 20 6c 69 6d 69 74 20 76 61 6c 75 65 73 2e 20 n limit values.
13980 20 54 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 The.** initiali
13990 7a 65 72 20 6d 75 73 74 20 62 65 20 6b 65 70 74 zer must be kept
139a0 20 69 6e 20 73 79 6e 63 20 77 69 74 68 20 74 68 in sync with th
139b0 65 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 2a e SQLITE_LIMIT_*
139c0 0a 2a 2a 20 23 64 65 66 69 6e 65 73 20 69 6e 20 .** #defines in
139d0 73 71 6c 69 74 65 33 2e 68 2e 0a 2a 2f 0a 73 74 sqlite3.h..*/.st
139e0 61 74 69 63 20 63 6f 6e 73 74 20 69 6e 74 20 61 atic const int a
139f0 48 61 72 64 4c 69 6d 69 74 5b 5d 20 3d 20 7b 0a HardLimit[] = {.
13a00 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e SQLITE_MAX_LEN
13a10 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 GTH,. SQLITE_MA
13a20 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 2c 0a 20 20 X_SQL_LENGTH,.
13a30 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d SQLITE_MAX_COLUM
13a40 4e 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f N,. SQLITE_MAX_
13a50 45 58 50 52 5f 44 45 50 54 48 2c 0a 20 20 53 51 EXPR_DEPTH,. SQ
13a60 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e LITE_MAX_COMPOUN
13a70 44 5f 53 45 4c 45 43 54 2c 0a 20 20 53 51 4c 49 D_SELECT,. SQLI
13a80 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 2c 0a TE_MAX_VDBE_OP,.
13a90 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e SQLITE_MAX_FUN
13aa0 43 54 49 4f 4e 5f 41 52 47 2c 0a 20 20 53 51 4c CTION_ARG,. SQL
13ab0 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
13ac0 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c ,. SQLITE_MAX_L
13ad0 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
13ae0 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 TH,. SQLITE_MAX
13af0 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 _VARIABLE_NUMBER
13b00 2c 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 , /* IMP: R
13b10 2d 33 38 30 39 31 2d 33 32 33 35 32 20 2a 2f 0a -38091-32352 */.
13b20 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 SQLITE_MAX_TRI
13b30 47 47 45 52 5f 44 45 50 54 48 2c 0a 20 20 53 51 GGER_DEPTH,. SQ
13b40 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f LITE_MAX_WORKER_
13b50 54 48 52 45 41 44 53 2c 0a 7d 3b 0a 0a 2f 2a 0a THREADS,.};../*.
13b60 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 ** Make sure the
13b70 20 68 61 72 64 20 6c 69 6d 69 74 73 20 61 72 65 hard limits are
13b80 20 73 65 74 20 74 6f 20 72 65 61 73 6f 6e 61 62 set to reasonab
13b90 6c 65 20 76 61 6c 75 65 73 0a 2a 2f 0a 23 69 66 le values.*/.#if
13ba0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 SQLITE_MAX_LENG
13bb0 54 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 TH<100.# error S
13bc0 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 QLITE_MAX_LENGTH
13bd0 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 must be at leas
13be0 74 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 t 100.#endif.#if
13bf0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f SQLITE_MAX_SQL_
13c00 4c 45 4e 47 54 48 3c 31 30 30 0a 23 20 65 72 72 LENGTH<100.# err
13c10 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 or SQLITE_MAX_SQ
13c20 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 L_LENGTH must be
13c30 20 61 74 20 6c 65 61 73 74 20 31 30 30 0a 23 65 at least 100.#e
13c40 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
13c50 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 3e 53 MAX_SQL_LENGTH>S
13c60 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 QLITE_MAX_LENGTH
13c70 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
13c80 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 6d MAX_SQL_LENGTH m
13c90 75 73 74 20 6e 6f 74 20 62 65 20 67 72 65 61 74 ust not be great
13ca0 65 72 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4d er than SQLITE_M
13cb0 41 58 5f 4c 45 4e 47 54 48 0a 23 65 6e 64 69 66 AX_LENGTH.#endif
13cc0 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
13cd0 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 3c COMPOUND_SELECT<
13ce0 32 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 2.# error SQLITE
13cf0 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 _MAX_COMPOUND_SE
13d00 4c 45 43 54 20 6d 75 73 74 20 62 65 20 61 74 20 LECT must be at
13d10 6c 65 61 73 74 20 32 0a 23 65 6e 64 69 66 0a 23 least 2.#endif.#
13d20 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 if SQLITE_MAX_VD
13d30 42 45 5f 4f 50 3c 34 30 0a 23 20 65 72 72 6f 72 BE_OP<40.# error
13d40 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 SQLITE_MAX_VDBE
13d50 5f 4f 50 20 6d 75 73 74 20 62 65 20 61 74 20 6c _OP must be at l
13d60 65 61 73 74 20 34 30 0a 23 65 6e 64 69 66 0a 23 east 40.#endif.#
13d70 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 if SQLITE_MAX_FU
13d80 4e 43 54 49 4f 4e 5f 41 52 47 3c 30 20 7c 7c 20 NCTION_ARG<0 ||
13d90 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 SQLITE_MAX_FUNCT
13da0 49 4f 4e 5f 41 52 47 3e 31 32 37 0a 23 20 65 72 ION_ARG>127.# er
13db0 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 ror SQLITE_MAX_F
13dc0 55 4e 43 54 49 4f 4e 5f 41 52 47 20 6d 75 73 74 UNCTION_ARG must
13dd0 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e be between 0 an
13de0 64 20 31 32 37 0a 23 65 6e 64 69 66 0a 23 69 66 d 127.#endif.#if
13df0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 SQLITE_MAX_ATTA
13e00 43 48 45 44 3c 30 20 7c 7c 20 53 51 4c 49 54 45 CHED<0 || SQLITE
13e10 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 31 32 _MAX_ATTACHED>12
13e20 35 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5.# error SQLITE
13e30 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 6d 75 _MAX_ATTACHED mu
13e40 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 st be between 0
13e50 61 6e 64 20 31 32 35 0a 23 65 6e 64 69 66 0a 23 and 125.#endif.#
13e60 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 if SQLITE_MAX_LI
13e70 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 KE_PATTERN_LENGT
13e80 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 H<1.# error SQLI
13e90 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 TE_MAX_LIKE_PATT
13ea0 45 52 4e 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 ERN_LENGTH must
13eb0 62 65 20 61 74 20 6c 65 61 73 74 20 31 0a 23 65 be at least 1.#e
13ec0 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
13ed0 4d 41 58 5f 43 4f 4c 55 4d 4e 3e 33 32 37 36 37 MAX_COLUMN>32767
13ee0 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
13ef0 4d 41 58 5f 43 4f 4c 55 4d 4e 20 6d 75 73 74 20 MAX_COLUMN must
13f00 6e 6f 74 20 65 78 63 65 65 64 20 33 32 37 36 37 not exceed 32767
13f10 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
13f20 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 TE_MAX_TRIGGER_D
13f30 45 50 54 48 3c 31 0a 23 20 65 72 72 6f 72 20 53 EPTH<1.# error S
13f40 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 QLITE_MAX_TRIGGE
13f50 52 5f 44 45 50 54 48 20 6d 75 73 74 20 62 65 20 R_DEPTH must be
13f60 61 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 at least 1.#endi
13f70 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 f.#if SQLITE_MAX
13f80 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3c _WORKER_THREADS<
13f90 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 0 || SQLITE_MAX_
13fa0 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3e 35 WORKER_THREADS>5
13fb0 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 0.# error SQLITE
13fc0 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
13fd0 41 44 53 20 6d 75 73 74 20 62 65 20 62 65 74 77 ADS must be betw
13fe0 65 65 6e 20 30 20 61 6e 64 20 35 30 0a 23 65 6e een 0 and 50.#en
13ff0 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e dif.../*.** Chan
14000 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ge the value of
14010 61 20 6c 69 6d 69 74 2e 20 20 52 65 70 6f 72 74 a limit. Report
14020 20 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 2e 0a the old value..
14030 2a 2a 20 49 66 20 61 6e 20 69 6e 76 61 6c 69 64 ** If an invalid
14040 20 6c 69 6d 69 74 20 69 6e 64 65 78 20 69 73 20 limit index is
14050 73 75 70 70 6c 69 65 64 2c 20 72 65 70 6f 72 74 supplied, report
14060 20 2d 31 2e 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 -1..** Make no
14070 63 68 61 6e 67 65 73 20 62 75 74 20 73 74 69 6c changes but stil
14080 6c 20 72 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 l report the old
14090 20 76 61 6c 75 65 20 69 66 20 74 68 65 0a 2a 2a value if the.**
140a0 20 6e 65 77 20 6c 69 6d 69 74 20 69 73 20 6e 65 new limit is ne
140b0 67 61 74 69 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 gative..**.** A
140c0 6e 65 77 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 new lower limit
140d0 64 6f 65 73 20 6e 6f 74 20 73 68 72 69 6e 6b 20 does not shrink
140e0 65 78 69 73 74 69 6e 67 20 63 6f 6e 73 74 72 75 existing constru
140f0 63 74 73 2e 0a 2a 2a 20 49 74 20 6d 65 72 65 6c cts..** It merel
14100 79 20 70 72 65 76 65 6e 74 73 20 6e 65 77 20 63 y prevents new c
14110 6f 6e 73 74 72 75 63 74 73 20 74 68 61 74 20 65 onstructs that e
14120 78 63 65 65 64 20 74 68 65 20 6c 69 6d 69 74 0a xceed the limit.
14130 2a 2a 20 66 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e ** from forming.
14140 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
14150 6c 69 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 limit(sqlite3 *d
14160 62 2c 20 69 6e 74 20 6c 69 6d 69 74 49 64 2c 20 b, int limitId,
14170 69 6e 74 20 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 int newLimit){.
14180 20 69 6e 74 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a int oldLimit;..
14190 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
141a0 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
141b0 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
141c0 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
141d0 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
141e0 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
141f0 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 return -1;.
14200 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
14210 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 EVIDENCE-OF: R-3
14220 30 31 38 39 2d 35 34 30 39 37 20 46 6f 72 20 65 0189-54097 For e
14230 61 63 68 20 6c 69 6d 69 74 20 63 61 74 65 67 6f ach limit catego
14240 72 79 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f ry SQLITE_LIMIT_
14250 4e 41 4d 45 0a 20 20 2a 2a 20 74 68 65 72 65 20 NAME. ** there
14260 69 73 20 61 20 68 61 72 64 20 75 70 70 65 72 20 is a hard upper
14270 62 6f 75 6e 64 20 73 65 74 20 61 74 20 63 6f 6d bound set at com
14280 70 69 6c 65 2d 74 69 6d 65 20 62 79 20 61 20 43 pile-time by a C
14290 20 70 72 65 70 72 6f 63 65 73 73 6f 72 0a 20 20 preprocessor.
142a0 2a 2a 20 6d 61 63 72 6f 20 63 61 6c 6c 65 64 20 ** macro called
142b0 53 51 4c 49 54 45 5f 4d 41 58 5f 4e 41 4d 45 2e SQLITE_MAX_NAME.
142c0 20 28 54 68 65 20 22 5f 4c 49 4d 49 54 5f 22 20 (The "_LIMIT_"
142d0 69 6e 20 74 68 65 20 6e 61 6d 65 20 69 73 20 63 in the name is c
142e0 68 61 6e 67 65 64 20 74 6f 0a 20 20 2a 2a 20 22 hanged to. ** "
142f0 5f 4d 41 58 5f 22 2e 29 0a 20 20 2a 2f 0a 20 20 _MAX_".). */.
14300 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14310 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14320 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c 49 54 45 5f LENGTH]==SQLITE_
14330 4d 41 58 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 MAX_LENGTH );.
14340 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14350 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14360 53 51 4c 5f 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c SQL_LENGTH]==SQL
14370 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
14380 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
14390 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
143a0 45 5f 4c 49 4d 49 54 5f 43 4f 4c 55 4d 4e 5d 3d E_LIMIT_COLUMN]=
143b0 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 =SQLITE_MAX_COLU
143c0 4d 4e 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 MN );. assert(
143d0 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
143e0 45 5f 4c 49 4d 49 54 5f 45 58 50 52 5f 44 45 50 E_LIMIT_EXPR_DEP
143f0 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f TH]==SQLITE_MAX_
14400 45 58 50 52 5f 44 45 50 54 48 20 29 3b 0a 20 20 EXPR_DEPTH );.
14410 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
14420 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
14430 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 5d COMPOUND_SELECT]
14440 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d ==SQLITE_MAX_COM
14450 50 4f 55 4e 44 5f 53 45 4c 45 43 54 29 3b 0a 20 POUND_SELECT);.
14460 20 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 assert( aHardLi
14470 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 mit[SQLITE_LIMIT
14480 5f 56 44 42 45 5f 4f 50 5d 3d 3d 53 51 4c 49 54 _VDBE_OP]==SQLIT
14490 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 20 29 3b E_MAX_VDBE_OP );
144a0 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
144b0 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
144c0 49 54 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d IT_FUNCTION_ARG]
144d0 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e ==SQLITE_MAX_FUN
144e0 43 54 49 4f 4e 5f 41 52 47 20 29 3b 0a 20 20 61 CTION_ARG );. a
144f0 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
14500 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 41 t[SQLITE_LIMIT_A
14510 54 54 41 43 48 45 44 5d 3d 3d 53 51 4c 49 54 45 TTACHED]==SQLITE
14520 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 20 29 3b _MAX_ATTACHED );
14530 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 64 . assert( aHard
14540 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d Limit[SQLITE_LIM
14550 49 54 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f IT_LIKE_PATTERN_
14560 4c 45 4e 47 54 48 5d 3d 3d 0a 20 20 20 20 20 20 LENGTH]==.
14570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14590 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
145a0 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e MAX_LIKE_PATTERN
145b0 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 _LENGTH );. ass
145c0 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
145d0 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 56 41 52 SQLITE_LIMIT_VAR
145e0 49 41 42 4c 45 5f 4e 55 4d 42 45 52 5d 3d 3d 53 IABLE_NUMBER]==S
145f0 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 QLITE_MAX_VARIAB
14600 4c 45 5f 4e 55 4d 42 45 52 29 3b 0a 20 20 61 73 LE_NUMBER);. as
14610 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 sert( aHardLimit
14620 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 54 52 [SQLITE_LIMIT_TR
14630 49 47 47 45 52 5f 44 45 50 54 48 5d 3d 3d 53 51 IGGER_DEPTH]==SQ
14640 4c 49 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 LITE_MAX_TRIGGER
14650 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 _DEPTH );. asse
14660 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
14670 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b QLITE_LIMIT_WORK
14680 45 52 5f 54 48 52 45 41 44 53 5d 3d 3d 53 51 4c ER_THREADS]==SQL
14690 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
146a0 48 52 45 41 44 53 20 29 3b 0a 20 20 61 73 73 65 HREADS );. asse
146b0 72 74 28 20 53 51 4c 49 54 45 5f 4c 49 4d 49 54 rt( SQLITE_LIMIT
146c0 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3d _WORKER_THREADS=
146d0 3d 28 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 =(SQLITE_N_LIMIT
146e0 2d 31 29 20 29 3b 0a 0a 0a 20 20 69 66 28 20 6c -1) );... if( l
146f0 69 6d 69 74 49 64 3c 30 20 7c 7c 20 6c 69 6d 69 imitId<0 || limi
14700 74 49 64 3e 3d 53 51 4c 49 54 45 5f 4e 5f 4c 49 tId>=SQLITE_N_LI
14710 4d 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72 MIT ){. retur
14720 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 6f 6c 64 4c n -1;. }. oldL
14730 69 6d 69 74 20 3d 20 64 62 2d 3e 61 4c 69 6d 69 imit = db->aLimi
14740 74 5b 6c 69 6d 69 74 49 64 5d 3b 0a 20 20 69 66 t[limitId];. if
14750 28 20 6e 65 77 4c 69 6d 69 74 3e 3d 30 20 29 7b ( newLimit>=0 ){
14760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14770 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 32 34 /* IMP: R-524
14780 37 36 2d 32 38 37 33 32 20 2a 2f 0a 20 20 20 20 76-28732 */.
14790 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 61 48 61 if( newLimit>aHa
147a0 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d rdLimit[limitId]
147b0 20 29 7b 0a 20 20 20 20 20 20 6e 65 77 4c 69 6d ){. newLim
147c0 69 74 20 3d 20 61 48 61 72 64 4c 69 6d 69 74 5b it = aHardLimit[
147d0 6c 69 6d 69 74 49 64 5d 3b 20 20 2f 2a 20 49 4d limitId]; /* IM
147e0 50 3a 20 52 2d 35 31 34 36 33 2d 32 35 36 33 34 P: R-51463-25634
147f0 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 */. }. db
14800 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 ->aLimit[limitId
14810 5d 20 3d 20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 ] = newLimit;.
14820 7d 0a 20 20 72 65 74 75 72 6e 20 6f 6c 64 4c 69 }. return oldLi
14830 6d 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 mit;
14840 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a /* IMP:
14850 20 52 2d 35 33 33 34 31 2d 33 35 34 31 39 20 2a R-53341-35419 *
14860 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 /.}../*.** This
14870 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 function is used
14880 20 74 6f 20 70 61 72 73 65 20 62 6f 74 68 20 55 to parse both U
14890 52 49 73 20 61 6e 64 20 6e 6f 6e 2d 55 52 49 20 RIs and non-URI
148a0 66 69 6c 65 6e 61 6d 65 73 20 70 61 73 73 65 64 filenames passed
148b0 20 62 79 20 74 68 65 0a 2a 2a 20 75 73 65 72 20 by the.** user
148c0 74 6f 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 to API functions
148d0 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 sqlite3_open()
148e0 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f or sqlite3_open_
148f0 76 32 28 29 2c 20 61 6e 64 20 66 6f 72 20 64 61 v2(), and for da
14900 74 61 62 61 73 65 0a 2a 2a 20 55 52 49 73 20 73 tabase.** URIs s
14910 70 65 63 69 66 69 65 64 20 61 73 20 70 61 72 74 pecified as part
14920 20 6f 66 20 41 54 54 41 43 48 20 73 74 61 74 65 of ATTACH state
14930 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ments..**.** The
14940 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 first argument
14950 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e to this function
14960 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 is the name of
14970 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 20 28 the VFS to use (
14980 6f 72 0a 2a 2a 20 61 20 4e 55 4c 4c 20 74 6f 20 or.** a NULL to
14990 73 69 67 6e 69 66 79 20 74 68 65 20 64 65 66 61 signify the defa
149a0 75 6c 74 20 56 46 53 29 20 69 66 20 74 68 65 20 ult VFS) if the
149b0 55 52 49 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e URI does not con
149c0 74 61 69 6e 20 61 20 22 76 66 73 3d 78 78 78 22 tain a "vfs=xxx"
149d0 0a 2a 2a 20 71 75 65 72 79 20 70 61 72 61 6d 65 .** query parame
149e0 74 65 72 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 ter. The second
149f0 61 72 67 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e argument contain
14a00 73 20 74 68 65 20 55 52 49 20 28 6f 72 20 6e 6f s the URI (or no
14a10 6e 2d 55 52 49 20 66 69 6c 65 6e 61 6d 65 29 0a n-URI filename).
14a20 2a 2a 20 69 74 73 65 6c 66 2e 20 57 68 65 6e 20 ** itself. When
14a30 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
14a40 20 63 61 6c 6c 65 64 20 74 68 65 20 2a 70 46 6c called the *pFl
14a50 61 67 73 20 76 61 72 69 61 62 6c 65 20 73 68 6f ags variable sho
14a60 75 6c 64 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 74 uld contain.** t
14a70 68 65 20 64 65 66 61 75 6c 74 20 66 6c 61 67 73 he default flags
14a80 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 61 74 to open the dat
14a90 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 69 74 abase handle wit
14aa0 68 2e 20 54 68 65 20 76 61 6c 75 65 20 73 74 6f h. The value sto
14ab0 72 65 64 20 69 6e 0a 2a 2a 20 2a 70 46 6c 61 67 red in.** *pFlag
14ac0 73 20 6d 61 79 20 62 65 20 75 70 64 61 74 65 64 s may be updated
14ad0 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
14ae0 67 20 69 66 20 74 68 65 20 55 52 49 20 66 69 6c g if the URI fil
14af0 65 6e 61 6d 65 20 63 6f 6e 74 61 69 6e 73 20 0a ename contains .
14b00 2a 2a 20 22 63 61 63 68 65 3d 78 78 78 22 20 6f ** "cache=xxx" o
14b10 72 20 22 6d 6f 64 65 3d 78 78 78 22 20 71 75 65 r "mode=xxx" que
14b20 72 79 20 70 61 72 61 6d 65 74 65 72 73 2e 0a 2a ry parameters..*
14b30 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 *.** If successf
14b40 75 6c 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 ul, SQLITE_OK is
14b50 20 72 65 74 75 72 6e 65 64 2e 20 49 6e 20 74 68 returned. In th
14b60 69 73 20 63 61 73 65 20 2a 70 70 56 66 73 20 69 is case *ppVfs i
14b70 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 s set to point t
14b80 6f 0a 2a 2a 20 74 68 65 20 56 46 53 20 74 68 61 o.** the VFS tha
14b90 74 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 t should be used
14ba0 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 64 61 74 to open the dat
14bb0 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 70 7a 46 abase file. *pzF
14bc0 69 6c 65 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a ile is set to.**
14bd0 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 point to a buff
14be0 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 er containing th
14bf0 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 e name of the fi
14c00 6c 65 20 74 6f 20 6f 70 65 6e 2e 20 49 74 20 69 le to open. It i
14c10 73 20 74 68 65 20 0a 2a 2a 20 72 65 73 70 6f 6e s the .** respon
14c20 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 sibility of the
14c30 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 caller to eventu
14c40 61 6c 6c 79 20 63 61 6c 6c 20 73 71 6c 69 74 65 ally call sqlite
14c50 33 5f 66 72 65 65 28 29 20 74 6f 20 72 65 6c 65 3_free() to rele
14c60 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 ase.** this buff
14c70 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 er..**.** If an
14c80 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
14c90 65 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 en an SQLite err
14ca0 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
14cb0 6e 65 64 20 61 6e 64 20 2a 70 7a 45 72 72 4d 73 ned and *pzErrMs
14cc0 67 0a 2a 2a 20 6d 61 79 20 62 65 20 73 65 74 20 g.** may be set
14cd0 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 to point to a bu
14ce0 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ffer containing
14cf0 61 6e 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 an English langu
14d00 61 67 65 20 65 72 72 6f 72 20 0a 2a 2a 20 6d 65 age error .** me
14d10 73 73 61 67 65 2e 20 49 74 20 69 73 20 74 68 65 ssage. It is the
14d20 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 responsibility
14d30 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f of the caller to
14d40 20 65 76 65 6e 74 75 61 6c 6c 79 20 72 65 6c 65 eventually rele
14d50 61 73 65 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 ase.** this buff
14d60 65 72 20 62 79 20 63 61 6c 6c 69 6e 67 20 73 71 er by calling sq
14d70 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2f lite3_free()..*/
14d80 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 .int sqlite3Pars
14d90 65 55 72 69 28 0a 20 20 63 6f 6e 73 74 20 63 68 eUri(. const ch
14da0 61 72 20 2a 7a 44 65 66 61 75 6c 74 56 66 73 2c ar *zDefaultVfs,
14db0 20 20 20 20 20 20 20 20 2f 2a 20 56 46 53 20 74 /* VFS t
14dc0 6f 20 75 73 65 20 69 66 20 6e 6f 20 22 76 66 73 o use if no "vfs
14dd0 3d 78 78 78 22 20 71 75 65 72 79 20 6f 70 74 69 =xxx" query opti
14de0 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 on */. const ch
14df0 61 72 20 2a 7a 55 72 69 2c 20 20 20 20 20 20 20 ar *zUri,
14e00 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6c 2d 74 /* Nul-t
14e10 65 72 6d 69 6e 61 74 65 64 20 55 52 49 20 74 6f erminated URI to
14e20 20 70 61 72 73 65 20 2a 2f 0a 20 20 75 6e 73 69 parse */. unsi
14e30 67 6e 65 64 20 69 6e 74 20 2a 70 46 6c 61 67 73 gned int *pFlags
14e40 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 , /* I
14e50 4e 2f 4f 55 54 3a 20 53 51 4c 49 54 45 5f 4f 50 N/OUT: SQLITE_OP
14e60 45 4e 5f 58 58 58 20 66 6c 61 67 73 20 2a 2f 0a EN_XXX flags */.
14e70 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2a sqlite3_vfs **
14e80 70 70 56 66 73 2c 20 20 20 20 20 20 20 20 20 20 ppVfs,
14e90 20 20 2f 2a 20 4f 55 54 3a 20 56 46 53 20 74 6f /* OUT: VFS to
14ea0 20 75 73 65 20 2a 2f 20 0a 20 20 63 68 61 72 20 use */ . char
14eb0 2a 2a 70 7a 46 69 6c 65 2c 20 20 20 20 20 20 20 **pzFile,
14ec0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
14ed0 54 3a 20 46 69 6c 65 6e 61 6d 65 20 63 6f 6d 70 T: Filename comp
14ee0 6f 6e 65 6e 74 20 6f 66 20 55 52 49 20 2a 2f 0a onent of URI */.
14ef0 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 char **pzErrMs
14f00 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g
14f10 20 20 2f 2a 20 4f 55 54 3a 20 45 72 72 6f 72 20 /* OUT: Error
14f20 6d 65 73 73 61 67 65 20 28 69 66 20 72 63 21 3d message (if rc!=
14f30 53 51 4c 49 54 45 5f 4f 4b 29 20 2a 2f 0a 29 7b SQLITE_OK) */.){
14f40 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
14f50 54 45 5f 4f 4b 3b 0a 20 20 75 6e 73 69 67 6e 65 TE_OK;. unsigne
14f60 64 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 2a 70 d int flags = *p
14f70 46 6c 61 67 73 3b 0a 20 20 63 6f 6e 73 74 20 63 Flags;. const c
14f80 68 61 72 20 2a 7a 56 66 73 20 3d 20 7a 44 65 66 har *zVfs = zDef
14f90 61 75 6c 74 56 66 73 3b 0a 20 20 63 68 61 72 20 aultVfs;. char
14fa0 2a 7a 46 69 6c 65 3b 0a 20 20 63 68 61 72 20 63 *zFile;. char c
14fb0 3b 0a 20 20 69 6e 74 20 6e 55 72 69 20 3d 20 73 ;. int nUri = s
14fc0 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
14fd0 55 72 69 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 Uri);.. assert(
14fe0 20 2a 70 7a 45 72 72 4d 73 67 3d 3d 30 20 29 3b *pzErrMsg==0 );
14ff0 0a 0a 20 20 69 66 28 20 28 28 66 6c 61 67 73 20 .. if( ((flags
15000 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 & SQLITE_OPEN_UR
15010 49 29 20 20 20 20 20 20 20 20 20 20 20 20 20 2f I) /
15020 2a 20 49 4d 50 3a 20 52 2d 34 38 37 32 35 2d 33 * IMP: R-48725-3
15030 32 32 30 36 20 2a 2f 0a 20 20 20 20 20 20 20 20 2206 */.
15040 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c || sqlite3Gl
15050 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4f 70 65 6e obalConfig.bOpen
15060 55 72 69 29 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 Uri) /* IMP: R-5
15070 31 36 38 39 2d 34 36 35 34 38 20 2a 2f 0a 20 20 1689-46548 */.
15080 20 26 26 20 6e 55 72 69 3e 3d 35 20 26 26 20 6d && nUri>=5 && m
15090 65 6d 63 6d 70 28 7a 55 72 69 2c 20 22 66 69 6c emcmp(zUri, "fil
150a0 65 3a 22 2c 20 35 29 3d 3d 30 20 2f 2a 20 49 4d e:", 5)==0 /* IM
150b0 50 3a 20 52 2d 35 37 38 38 34 2d 33 37 34 39 36 P: R-57884-37496
150c0 20 2a 2f 0a 20 20 29 7b 0a 20 20 20 20 63 68 61 */. ){. cha
150d0 72 20 2a 7a 4f 70 74 3b 0a 20 20 20 20 69 6e 74 r *zOpt;. int
150e0 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 20 20 eState;
150f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
15100 72 73 65 72 20 73 74 61 74 65 20 77 68 65 6e 20 rser state when
15110 70 61 72 73 69 6e 67 20 55 52 49 20 2a 2f 0a 20 parsing URI */.
15120 20 20 20 69 6e 74 20 69 49 6e 3b 20 20 20 20 20 int iIn;
15130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15140 20 2f 2a 20 49 6e 70 75 74 20 63 68 61 72 61 63 /* Input charac
15150 74 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 ter index */.
15160 20 69 6e 74 20 69 4f 75 74 20 3d 20 30 3b 20 20 int iOut = 0;
15170 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
15180 2a 20 4f 75 74 70 75 74 20 63 68 61 72 61 63 74 * Output charact
15190 65 72 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 er index */.
151a0 75 36 34 20 6e 42 79 74 65 20 3d 20 6e 55 72 69 u64 nByte = nUri
151b0 2b 32 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a +2; /*
151c0 20 42 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 Bytes of space
151d0 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 0a to allocate */..
151e0 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 /* Make sure
151f0 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 50 45 4e the SQLITE_OPEN
15200 5f 55 52 49 20 66 6c 61 67 20 69 73 20 73 65 74 _URI flag is set
15210 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 6f 20 to indicate to
15220 74 68 65 20 56 46 53 20 78 4f 70 65 6e 20 0a 20 the VFS xOpen .
15230 20 20 20 2a 2a 20 6d 65 74 68 6f 64 20 74 68 61 ** method tha
15240 74 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 65 t there may be e
15250 78 74 72 61 20 70 61 72 61 6d 65 74 65 72 73 20 xtra parameters
15260 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 66 69 following the fi
15270 6c 65 2d 6e 61 6d 65 2e 20 20 2a 2f 0a 20 20 20 le-name. */.
15280 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 flags |= SQLITE
15290 5f 4f 50 45 4e 5f 55 52 49 3b 0a 0a 20 20 20 20 _OPEN_URI;..
152a0 66 6f 72 28 69 49 6e 3d 30 3b 20 69 49 6e 3c 6e for(iIn=0; iIn<n
152b0 55 72 69 3b 20 69 49 6e 2b 2b 29 20 6e 42 79 74 Uri; iIn++) nByt
152c0 65 20 2b 3d 20 28 7a 55 72 69 5b 69 49 6e 5d 3d e += (zUri[iIn]=
152d0 3d 27 26 27 29 3b 0a 20 20 20 20 7a 46 69 6c 65 ='&');. zFile
152e0 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f = sqlite3_mallo
152f0 63 36 34 28 6e 42 79 74 65 29 3b 0a 20 20 20 20 c64(nByte);.
15300 69 66 28 20 21 7a 46 69 6c 65 20 29 20 72 65 74 if( !zFile ) ret
15310 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
15320 5f 42 4b 50 54 3b 0a 0a 20 20 20 20 69 49 6e 20 _BKPT;.. iIn
15330 3d 20 35 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 = 5;.#ifdef SQLI
15340 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54 TE_ALLOW_URI_AUT
15350 48 4f 52 49 54 59 0a 20 20 20 20 69 66 28 20 73 HORITY. if( s
15360 74 72 6e 63 6d 70 28 7a 55 72 69 2b 35 2c 20 22 trncmp(zUri+5, "
15370 2f 2f 2f 22 2c 20 33 29 3d 3d 30 20 29 7b 0a 20 ///", 3)==0 ){.
15380 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 iIn = 7;.
15390 20 20 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f /* The follo
153a0 77 69 6e 67 20 63 6f 6e 64 69 74 69 6f 6e 20 63 wing condition c
153b0 61 75 73 65 73 20 55 52 49 73 20 77 69 74 68 20 auses URIs with
153c0 66 69 76 65 20 6c 65 61 64 69 6e 67 20 2f 20 63 five leading / c
153d0 68 61 72 61 63 74 65 72 73 0a 20 20 20 20 20 20 haracters.
153e0 2a 2a 20 6c 69 6b 65 20 66 69 6c 65 3a 2f 2f 2f ** like file:///
153f0 2f 2f 68 6f 73 74 2f 70 61 74 68 20 74 6f 20 62 //host/path to b
15400 65 20 63 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f e converted into
15410 20 55 4e 43 73 20 6c 69 6b 65 20 2f 2f 68 6f 73 UNCs like //hos
15420 74 2f 70 61 74 68 2e 0a 20 20 20 20 20 20 2a 2a t/path.. **
15430 20 54 68 65 20 63 6f 72 72 65 63 74 20 55 52 49 The correct URI
15440 20 66 6f 72 20 74 68 61 74 20 55 4e 43 20 68 61 for that UNC ha
15450 73 20 6f 6e 6c 79 20 74 77 6f 20 6f 72 20 66 6f s only two or fo
15460 75 72 20 6c 65 61 64 69 6e 67 20 2f 20 63 68 61 ur leading / cha
15470 72 61 63 74 65 72 73 0a 20 20 20 20 20 20 2a 2a racters. **
15480 20 66 69 6c 65 3a 2f 2f 68 6f 73 74 2f 70 61 74 file://host/pat
15490 68 20 6f 72 20 66 69 6c 65 3a 2f 2f 2f 2f 68 6f h or file:////ho
154a0 73 74 2f 70 61 74 68 2e 20 20 42 75 74 20 35 20 st/path. But 5
154b0 6c 65 61 64 69 6e 67 20 73 6c 61 73 68 65 73 20 leading slashes
154c0 69 73 20 61 20 0a 20 20 20 20 20 20 2a 2a 20 63 is a . ** c
154d0 6f 6d 6d 6f 6e 20 65 72 72 6f 72 2c 20 77 65 20 ommon error, we
154e0 61 72 65 20 74 6f 6c 64 2c 20 73 6f 20 77 65 20 are told, so we
154f0 68 61 6e 64 6c 65 20 69 74 20 61 73 20 61 20 73 handle it as a s
15500 70 65 63 69 61 6c 20 63 61 73 65 2e 20 2a 2f 0a pecial case. */.
15510 20 20 20 20 20 20 69 66 28 20 73 74 72 6e 63 6d if( strncm
15520 70 28 7a 55 72 69 2b 37 2c 20 22 2f 2f 2f 22 2c p(zUri+7, "///",
15530 20 33 29 3d 3d 30 20 29 7b 20 69 49 6e 2b 2b 3b 3)==0 ){ iIn++;
15540 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 }. }else if(
15550 20 73 74 72 6e 63 6d 70 28 7a 55 72 69 2b 35 2c strncmp(zUri+5,
15560 20 22 2f 2f 6c 6f 63 61 6c 68 6f 73 74 2f 22 2c "//localhost/",
15570 20 31 32 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 12)==0 ){.
15580 20 69 49 6e 20 3d 20 31 36 3b 0a 20 20 20 20 7d iIn = 16;. }
15590 0a 23 65 6c 73 65 0a 20 20 20 20 2f 2a 20 44 69 .#else. /* Di
155a0 73 63 61 72 64 20 74 68 65 20 73 63 68 65 6d 65 scard the scheme
155b0 20 61 6e 64 20 61 75 74 68 6f 72 69 74 79 20 73 and authority s
155c0 65 67 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 55 egments of the U
155d0 52 49 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 7a RI. */. if( z
155e0 55 72 69 5b 35 5d 3d 3d 27 2f 27 20 26 26 20 7a Uri[5]=='/' && z
155f0 55 72 69 5b 36 5d 3d 3d 27 2f 27 20 29 7b 0a 20 Uri[6]=='/' ){.
15600 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a 20 20 iIn = 7;.
15610 20 20 20 20 77 68 69 6c 65 28 20 7a 55 72 69 5b while( zUri[
15620 69 49 6e 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e iIn] && zUri[iIn
15630 5d 21 3d 27 2f 27 20 29 20 69 49 6e 2b 2b 3b 0a ]!='/' ) iIn++;.
15640 20 20 20 20 20 20 69 66 28 20 69 49 6e 21 3d 37 if( iIn!=7
15650 20 26 26 20 28 69 49 6e 21 3d 31 36 20 7c 7c 20 && (iIn!=16 ||
15660 6d 65 6d 63 6d 70 28 22 6c 6f 63 61 6c 68 6f 73 memcmp("localhos
15670 74 22 2c 20 26 7a 55 72 69 5b 37 5d 2c 20 39 29 t", &zUri[7], 9)
15680 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a ) ){. *pz
15690 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 ErrMsg = sqlite3
156a0 5f 6d 70 72 69 6e 74 66 28 22 69 6e 76 61 6c 69 _mprintf("invali
156b0 64 20 75 72 69 20 61 75 74 68 6f 72 69 74 79 3a d uri authority:
156c0 20 25 2e 2a 73 22 2c 20 0a 20 20 20 20 20 20 20 %.*s", .
156d0 20 20 20 20 20 69 49 6e 2d 37 2c 20 26 7a 55 72 iIn-7, &zUr
156e0 69 5b 37 5d 29 3b 0a 20 20 20 20 20 20 20 20 72 i[7]);. r
156f0 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
15700 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 ;. goto p
15710 61 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 arse_uri_out;.
15720 20 20 20 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 }. }.#end
15730 69 66 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 if.. /* Copy
15740 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 6e 64 the filename and
15750 20 61 6e 79 20 71 75 65 72 79 20 70 61 72 61 6d any query param
15760 65 74 65 72 73 20 69 6e 74 6f 20 74 68 65 20 7a eters into the z
15770 46 69 6c 65 20 62 75 66 66 65 72 2e 20 0a 20 20 File buffer. .
15780 20 20 2a 2a 20 44 65 63 6f 64 65 20 25 48 48 20 ** Decode %HH
15790 65 73 63 61 70 65 20 63 6f 64 65 73 20 61 6c 6f escape codes alo
157a0 6e 67 20 74 68 65 20 77 61 79 2e 20 0a 20 20 20 ng the way. .
157b0 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 69 74 68 69 **. ** Withi
157c0 6e 20 74 68 69 73 20 6c 6f 6f 70 2c 20 76 61 72 n this loop, var
157d0 69 61 62 6c 65 20 65 53 74 61 74 65 20 6d 61 79 iable eState may
157e0 20 62 65 20 73 65 74 20 74 6f 20 30 2c 20 31 20 be set to 0, 1
157f0 6f 72 20 32 2c 20 64 65 70 65 6e 64 69 6e 67 0a or 2, depending.
15800 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 ** on the pa
15810 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 41 rsing context. A
15820 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 20 20 2a s follows:. *
15830 2a 0a 20 20 20 20 2a 2a 20 20 20 30 3a 20 50 61 *. ** 0: Pa
15840 72 73 69 6e 67 20 66 69 6c 65 2d 6e 61 6d 65 2e rsing file-name.
15850 0a 20 20 20 20 2a 2a 20 20 20 31 3a 20 50 61 72 . ** 1: Par
15860 73 69 6e 67 20 6e 61 6d 65 20 73 65 63 74 69 6f sing name sectio
15870 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 6c 75 n of a name=valu
15880 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 e query paramete
15890 72 2e 0a 20 20 20 20 2a 2a 20 20 20 32 3a 20 50 r.. ** 2: P
158a0 61 72 73 69 6e 67 20 76 61 6c 75 65 20 73 65 63 arsing value sec
158b0 74 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 tion of a name=v
158c0 61 6c 75 65 20 71 75 65 72 79 20 70 61 72 61 6d alue query param
158d0 65 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 eter.. */.
158e0 20 65 53 74 61 74 65 20 3d 20 30 3b 0a 20 20 20 eState = 0;.
158f0 20 77 68 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 while( (c = zUr
15900 69 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 i[iIn])!=0 && c!
15910 3d 27 23 27 20 29 7b 0a 20 20 20 20 20 20 69 49 ='#' ){. iI
15920 6e 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 63 n++;. if( c
15930 3d 3d 27 25 27 20 0a 20 20 20 20 20 20 20 26 26 =='%' . &&
15940 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 sqlite3Isxdigit
15950 28 7a 55 72 69 5b 69 49 6e 5d 29 20 0a 20 20 20 (zUri[iIn]) .
15960 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 49 73 && sqlite3Is
15970 78 64 69 67 69 74 28 7a 55 72 69 5b 69 49 6e 2b xdigit(zUri[iIn+
15980 31 5d 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 1]) . ){.
15990 20 20 20 20 20 20 69 6e 74 20 6f 63 74 65 74 20 int octet
159a0 3d 20 28 73 71 6c 69 74 65 33 48 65 78 54 6f 49 = (sqlite3HexToI
159b0 6e 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d 29 20 nt(zUri[iIn++])
159c0 3c 3c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 6f << 4);. o
159d0 63 74 65 74 20 2b 3d 20 73 71 6c 69 74 65 33 48 ctet += sqlite3H
159e0 65 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 49 6e exToInt(zUri[iIn
159f0 2b 2b 5d 29 3b 0a 0a 20 20 20 20 20 20 20 20 61 ++]);.. a
15a00 73 73 65 72 74 28 20 6f 63 74 65 74 3e 3d 30 20 ssert( octet>=0
15a10 26 26 20 6f 63 74 65 74 3c 32 35 36 20 29 3b 0a && octet<256 );.
15a20 20 20 20 20 20 20 20 20 69 66 28 20 6f 63 74 65 if( octe
15a30 74 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 t==0 ){.#ifndef
15a40 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 52 SQLITE_ENABLE_UR
15a50 49 5f 30 30 5f 45 52 52 4f 52 0a 20 20 20 20 20 I_00_ERROR.
15a60 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 /* This bra
15a70 6e 63 68 20 69 73 20 74 61 6b 65 6e 20 77 68 65 nch is taken whe
15a80 6e 20 22 25 30 30 22 20 61 70 70 65 61 72 73 20 n "%00" appears
15a90 77 69 74 68 69 6e 20 74 68 65 20 55 52 49 2e 20 within the URI.
15aa0 49 6e 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 In this.
15ab0 20 20 2a 2a 20 63 61 73 65 20 77 65 20 69 67 6e ** case we ign
15ac0 6f 72 65 20 61 6c 6c 20 74 65 78 74 20 69 6e 20 ore all text in
15ad0 74 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 the remainder of
15ae0 20 74 68 65 20 70 61 74 68 2c 20 6e 61 6d 65 20 the path, name
15af0 6f 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 or. **
15b00 76 61 6c 75 65 20 63 75 72 72 65 6e 74 6c 79 20 value currently
15b10 62 65 69 6e 67 20 70 61 72 73 65 64 2e 20 53 6f being parsed. So
15b20 20 69 67 6e 6f 72 65 20 74 68 65 20 63 75 72 72 ignore the curr
15b30 65 6e 74 20 63 68 61 72 61 63 74 65 72 0a 20 20 ent character.
15b40 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 73 ** and s
15b50 6b 69 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 kip to the next
15b60 22 3f 22 2c 20 22 3d 22 20 6f 72 20 22 26 22 2c "?", "=" or "&",
15b70 20 61 73 20 61 70 70 72 6f 70 72 69 61 74 65 2e as appropriate.
15b80 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 77 68 */. wh
15b90 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 69 5b 69 ile( (c = zUri[i
15ba0 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 3d 27 23 In])!=0 && c!='#
15bb0 27 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ' .
15bc0 20 26 26 20 28 65 53 74 61 74 65 21 3d 30 20 7c && (eState!=0 |
15bd0 7c 20 63 21 3d 27 3f 27 29 0a 20 20 20 20 20 20 | c!='?').
15be0 20 20 20 20 20 20 20 20 26 26 20 28 65 53 74 61 && (eSta
15bf0 74 65 21 3d 31 20 7c 7c 20 28 63 21 3d 27 3d 27 te!=1 || (c!='='
15c00 20 26 26 20 63 21 3d 27 26 27 29 29 0a 20 20 20 && c!='&')).
15c10 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 65 && (e
15c20 53 74 61 74 65 21 3d 32 20 7c 7c 20 63 21 3d 27 State!=2 || c!='
15c30 26 27 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b &'). ){
15c40 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 49 6e . iIn
15c50 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ++;. }.
15c60 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e contin
15c70 75 65 3b 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 ue;.#else.
15c80 20 20 20 20 2f 2a 20 49 66 20 45 4e 41 42 4c 45 /* If ENABLE
15c90 5f 55 52 49 5f 30 30 5f 45 52 52 4f 52 20 69 73 _URI_00_ERROR is
15ca0 20 64 65 66 69 6e 65 64 2c 20 22 25 30 30 22 20 defined, "%00"
15cb0 69 6e 20 61 20 55 52 49 20 69 73 20 61 6e 20 65 in a URI is an e
15cc0 72 72 6f 72 2e 20 2a 2f 0a 20 20 20 20 20 20 20 rror. */.
15cd0 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
15ce0 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
15cf0 75 6e 65 78 70 65 63 74 65 64 20 25 25 30 30 20 unexpected %%00
15d00 69 6e 20 75 72 69 22 29 3b 0a 20 20 20 20 20 20 in uri");.
15d10 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
15d20 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 ERROR;.
15d30 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 5f goto parse_uri_
15d40 6f 75 74 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 out;.#endif.
15d50 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 63 20 }. c
15d60 3d 20 6f 63 74 65 74 3b 0a 20 20 20 20 20 20 7d = octet;. }
15d70 65 6c 73 65 20 69 66 28 20 65 53 74 61 74 65 3d else if( eState=
15d80 3d 31 20 26 26 20 28 63 3d 3d 27 26 27 20 7c 7c =1 && (c=='&' ||
15d90 20 63 3d 3d 27 3d 27 29 20 29 7b 0a 20 20 20 20 c=='=') ){.
15da0 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b 69 4f if( zFile[iO
15db0 75 74 2d 31 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 ut-1]==0 ){.
15dc0 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 6d 70 74 /* An empt
15dd0 79 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 2e 20 49 y option name. I
15de0 67 6e 6f 72 65 20 74 68 69 73 20 6f 70 74 69 6f gnore this optio
15df0 6e 20 61 6c 74 6f 67 65 74 68 65 72 2e 20 2a 2f n altogether. */
15e00 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 . while
15e10 28 20 7a 55 72 69 5b 69 49 6e 5d 20 26 26 20 7a ( zUri[iIn] && z
15e20 55 72 69 5b 69 49 6e 5d 21 3d 27 23 27 20 26 26 Uri[iIn]!='#' &&
15e30 20 7a 55 72 69 5b 69 49 6e 2d 31 5d 21 3d 27 26 zUri[iIn-1]!='&
15e40 27 20 29 20 69 49 6e 2b 2b 3b 0a 20 20 20 20 20 ' ) iIn++;.
15e50 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 continue;.
15e60 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
15e70 20 69 66 28 20 63 3d 3d 27 26 27 20 29 7b 0a 20 if( c=='&' ){.
15e80 20 20 20 20 20 20 20 20 20 7a 46 69 6c 65 5b 69 zFile[i
15e90 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 Out++] = '\0';.
15ea0 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
15eb0 20 20 20 20 20 20 20 20 65 53 74 61 74 65 20 3d eState =
15ec0 20 32 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 2;. }.
15ed0 20 20 20 20 20 20 63 20 3d 20 30 3b 0a 20 20 20 c = 0;.
15ee0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 65 53 }else if( (eS
15ef0 74 61 74 65 3d 3d 30 20 26 26 20 63 3d 3d 27 3f tate==0 && c=='?
15f00 27 29 20 7c 7c 20 28 65 53 74 61 74 65 3d 3d 32 ') || (eState==2
15f10 20 26 26 20 63 3d 3d 27 26 27 29 20 29 7b 0a 20 && c=='&') ){.
15f20 20 20 20 20 20 20 20 63 20 3d 20 30 3b 0a 20 20 c = 0;.
15f30 20 20 20 20 20 20 65 53 74 61 74 65 20 3d 20 31 eState = 1
15f40 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
15f50 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 zFile[iOut++] =
15f60 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
15f70 20 65 53 74 61 74 65 3d 3d 31 20 29 20 7a 46 69 eState==1 ) zFi
15f80 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 le[iOut++] = '\0
15f90 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 ';. zFile[iOu
15fa0 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 t++] = '\0';.
15fb0 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d zFile[iOut++] =
15fc0 20 27 5c 30 27 3b 0a 0a 20 20 20 20 2f 2a 20 43 '\0';.. /* C
15fd0 68 65 63 6b 20 69 66 20 74 68 65 72 65 20 77 65 heck if there we
15fe0 72 65 20 61 6e 79 20 6f 70 74 69 6f 6e 73 20 73 re any options s
15ff0 70 65 63 69 66 69 65 64 20 74 68 61 74 20 73 68 pecified that sh
16000 6f 75 6c 64 20 62 65 20 69 6e 74 65 72 70 72 65 ould be interpre
16010 74 65 64 20 0a 20 20 20 20 2a 2a 20 68 65 72 65 ted . ** here
16020 2e 20 4f 70 74 69 6f 6e 73 20 74 68 61 74 20 61 . Options that a
16030 72 65 20 69 6e 74 65 72 70 72 65 74 65 64 20 68 re interpreted h
16040 65 72 65 20 69 6e 63 6c 75 64 65 20 22 76 66 73 ere include "vfs
16050 22 20 61 6e 64 20 74 68 6f 73 65 20 74 68 61 74 " and those that
16060 0a 20 20 20 20 2a 2a 20 63 6f 72 72 65 73 70 6f . ** correspo
16070 6e 64 20 74 6f 20 66 6c 61 67 73 20 74 68 61 74 nd to flags that
16080 20 6d 61 79 20 62 65 20 70 61 73 73 65 64 20 74 may be passed t
16090 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6f 70 o the sqlite3_op
160a0 65 6e 5f 76 32 28 29 0a 20 20 20 20 2a 2a 20 6d en_v2(). ** m
160b0 65 74 68 6f 64 2e 20 2a 2f 0a 20 20 20 20 7a 4f ethod. */. zO
160c0 70 74 20 3d 20 26 7a 46 69 6c 65 5b 73 71 6c 69 pt = &zFile[sqli
160d0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c te3Strlen30(zFil
160e0 65 29 2b 31 5d 3b 0a 20 20 20 20 77 68 69 6c 65 e)+1];. while
160f0 28 20 7a 4f 70 74 5b 30 5d 20 29 7b 0a 20 20 20 ( zOpt[0] ){.
16100 20 20 20 69 6e 74 20 6e 4f 70 74 20 3d 20 73 71 int nOpt = sq
16110 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4f lite3Strlen30(zO
16120 70 74 29 3b 0a 20 20 20 20 20 20 63 68 61 72 20 pt);. char
16130 2a 7a 56 61 6c 20 3d 20 26 7a 4f 70 74 5b 6e 4f *zVal = &zOpt[nO
16140 70 74 2b 31 5d 3b 0a 20 20 20 20 20 20 69 6e 74 pt+1];. int
16150 20 6e 56 61 6c 20 3d 20 73 71 6c 69 74 65 33 53 nVal = sqlite3S
16160 74 72 6c 65 6e 33 30 28 7a 56 61 6c 29 3b 0a 0a trlen30(zVal);..
16170 20 20 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d if( nOpt==
16180 33 20 26 26 20 6d 65 6d 63 6d 70 28 22 76 66 73 3 && memcmp("vfs
16190 22 2c 20 7a 4f 70 74 2c 20 33 29 3d 3d 30 20 29 ", zOpt, 3)==0 )
161a0 7b 0a 20 20 20 20 20 20 20 20 7a 56 66 73 20 3d {. zVfs =
161b0 20 7a 56 61 6c 3b 0a 20 20 20 20 20 20 7d 65 6c zVal;. }el
161c0 73 65 7b 0a 20 20 20 20 20 20 20 20 73 74 72 75 se{. stru
161d0 63 74 20 4f 70 65 6e 4d 6f 64 65 20 7b 0a 20 20 ct OpenMode {.
161e0 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 const ch
161f0 61 72 20 2a 7a 3b 0a 20 20 20 20 20 20 20 20 20 ar *z;.
16200 20 69 6e 74 20 6d 6f 64 65 3b 0a 20 20 20 20 20 int mode;.
16210 20 20 20 7d 20 2a 61 4d 6f 64 65 20 3d 20 30 3b } *aMode = 0;
16220 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a . char *z
16230 4d 6f 64 65 54 79 70 65 20 3d 20 30 3b 0a 20 20 ModeType = 0;.
16240 20 20 20 20 20 20 69 6e 74 20 6d 61 73 6b 20 3d int mask =
16250 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 0;. int
16260 6c 69 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 20 20 limit = 0;..
16270 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d 35 20 if( nOpt==5
16280 26 26 20 6d 65 6d 63 6d 70 28 22 63 61 63 68 65 && memcmp("cache
16290 22 2c 20 7a 4f 70 74 2c 20 35 29 3d 3d 30 20 29 ", zOpt, 5)==0 )
162a0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 61 74 {. stat
162b0 69 63 20 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f ic struct OpenMo
162c0 64 65 20 61 43 61 63 68 65 4d 6f 64 65 5b 5d 20 de aCacheMode[]
162d0 3d 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 = {.
162e0 7b 20 22 73 68 61 72 65 64 22 2c 20 20 53 51 4c { "shared", SQL
162f0 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 ITE_OPEN_SHAREDC
16300 41 43 48 45 20 7d 2c 0a 20 20 20 20 20 20 20 20 ACHE },.
16310 20 20 20 20 7b 20 22 70 72 69 76 61 74 65 22 2c { "private",
16320 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 49 SQLITE_OPEN_PRI
16330 56 41 54 45 43 41 43 48 45 20 7d 2c 0a 20 20 20 VATECACHE },.
16340 20 20 20 20 20 20 20 20 20 7b 20 30 2c 20 30 20 { 0, 0
16350 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 3b 0a 0a }. };..
16360 20 20 20 20 20 20 20 20 20 20 6d 61 73 6b 20 3d mask =
16370 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 SQLITE_OPEN_SHA
16380 52 45 44 43 41 43 48 45 7c 53 51 4c 49 54 45 5f REDCACHE|SQLITE_
16390 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 OPEN_PRIVATECACH
163a0 45 3b 0a 20 20 20 20 20 20 20 20 20 20 61 4d 6f E;. aMo
163b0 64 65 20 3d 20 61 43 61 63 68 65 4d 6f 64 65 3b de = aCacheMode;
163c0 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d 69 74 . limit
163d0 20 3d 20 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 = mask;.
163e0 20 20 20 7a 4d 6f 64 65 54 79 70 65 20 3d 20 22 zModeType = "
163f0 63 61 63 68 65 22 3b 0a 20 20 20 20 20 20 20 20 cache";.
16400 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 4f }. if( nO
16410 70 74 3d 3d 34 20 26 26 20 6d 65 6d 63 6d 70 28 pt==4 && memcmp(
16420 22 6d 6f 64 65 22 2c 20 7a 4f 70 74 2c 20 34 29 "mode", zOpt, 4)
16430 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
16440 20 73 74 61 74 69 63 20 73 74 72 75 63 74 20 4f static struct O
16450 70 65 6e 4d 6f 64 65 20 61 4f 70 65 6e 4d 6f 64 penMode aOpenMod
16460 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 e[] = {.
16470 20 20 20 20 7b 20 22 72 6f 22 2c 20 20 53 51 4c { "ro", SQL
16480 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
16490 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 Y },.
164a0 20 7b 20 22 72 77 22 2c 20 20 53 51 4c 49 54 45 { "rw", SQLITE
164b0 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 _OPEN_READWRITE
164c0 7d 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 }, .
164d0 7b 20 22 72 77 63 22 2c 20 53 51 4c 49 54 45 5f { "rwc", SQLITE_
164e0 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c OPEN_READWRITE |
164f0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 SQLITE_OPEN_CRE
16500 41 54 45 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 ATE },.
16510 20 20 20 7b 20 22 6d 65 6d 6f 72 79 22 2c 20 53 { "memory", S
16520 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
16530 59 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 Y },.
16540 20 7b 20 30 2c 20 30 20 7d 0a 20 20 20 20 20 20 { 0, 0 }.
16550 20 20 20 20 7d 3b 0a 0a 20 20 20 20 20 20 20 20 };..
16560 20 20 6d 61 73 6b 20 3d 20 53 51 4c 49 54 45 5f mask = SQLITE_
16570 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 7c 20 OPEN_READONLY |
16580 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
16590 57 52 49 54 45 0a 20 20 20 20 20 20 20 20 20 20 WRITE.
165a0 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 | SQLIT
165b0 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 7c 20 E_OPEN_CREATE |
165c0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f SQLITE_OPEN_MEMO
165d0 52 59 3b 0a 20 20 20 20 20 20 20 20 20 20 61 4d RY;. aM
165e0 6f 64 65 20 3d 20 61 4f 70 65 6e 4d 6f 64 65 3b ode = aOpenMode;
165f0 0a 20 20 20 20 20 20 20 20 20 20 6c 69 6d 69 74 . limit
16600 20 3d 20 6d 61 73 6b 20 26 20 66 6c 61 67 73 3b = mask & flags;
16610 0a 20 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 . zMode
16620 54 79 70 65 20 3d 20 22 61 63 63 65 73 73 22 3b Type = "access";
16630 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 . }..
16640 20 20 20 20 69 66 28 20 61 4d 6f 64 65 20 29 7b if( aMode ){
16650 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 . int i
16660 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 ;. int
16670 6d 6f 64 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 mode = 0;.
16680 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 61 4d 6f for(i=0; aMo
16690 64 65 5b 69 5d 2e 7a 3b 20 69 2b 2b 29 7b 0a 20 de[i].z; i++){.
166a0 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
166b0 20 63 68 61 72 20 2a 7a 20 3d 20 61 4d 6f 64 65 char *z = aMode
166c0 5b 69 5d 2e 7a 3b 0a 20 20 20 20 20 20 20 20 20 [i].z;.
166d0 20 20 20 69 66 28 20 6e 56 61 6c 3d 3d 73 71 6c if( nVal==sql
166e0 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 20 ite3Strlen30(z)
166f0 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 28 7a 56 61 && 0==memcmp(zVa
16700 6c 2c 20 7a 2c 20 6e 56 61 6c 29 20 29 7b 0a 20 l, z, nVal) ){.
16710 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 mod
16720 65 20 3d 20 61 4d 6f 64 65 5b 69 5d 2e 6d 6f 64 e = aMode[i].mod
16730 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 e;.
16740 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
16750 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
16760 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
16770 6d 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 mode==0 ){.
16780 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 *pzErrMsg
16790 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e = sqlite3_mprin
167a0 74 66 28 22 6e 6f 20 73 75 63 68 20 25 73 20 6d tf("no such %s m
167b0 6f 64 65 3a 20 25 73 22 2c 20 7a 4d 6f 64 65 54 ode: %s", zModeT
167c0 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20 ype, zVal);.
167d0 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
167e0 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 ITE_ERROR;.
167f0 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 72 73 goto pars
16800 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 20 20 e_uri_out;.
16810 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
16820 20 69 66 28 20 28 6d 6f 64 65 20 26 20 7e 53 51 if( (mode & ~SQ
16830 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 59 LITE_OPEN_MEMORY
16840 29 3e 6c 69 6d 69 74 20 29 7b 0a 20 20 20 20 20 )>limit ){.
16850 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 *pzErrMsg
16860 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e = sqlite3_mprin
16870 74 66 28 22 25 73 20 6d 6f 64 65 20 6e 6f 74 20 tf("%s mode not
16880 61 6c 6c 6f 77 65 64 3a 20 25 73 22 2c 0a 20 20 allowed: %s",.
16890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
168a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
168b0 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 2c zModeType,
168c0 20 7a 56 61 6c 29 3b 0a 20 20 20 20 20 20 20 20 zVal);.
168d0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
168e0 50 45 52 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 PERM;.
168f0 20 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 goto parse_uri
16900 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 20 20 _out;.
16910 7d 0a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 }. flag
16920 73 20 3d 20 28 66 6c 61 67 73 20 26 20 7e 6d 61 s = (flags & ~ma
16930 73 6b 29 20 7c 20 6d 6f 64 65 3b 0a 20 20 20 20 sk) | mode;.
16940 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 }. }..
16950 20 20 20 20 20 7a 4f 70 74 20 3d 20 26 7a 56 61 zOpt = &zVa
16960 6c 5b 6e 56 61 6c 2b 31 5d 3b 0a 20 20 20 20 7d l[nVal+1];. }
16970 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a .. }else{. z
16980 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d File = sqlite3_m
16990 61 6c 6c 6f 63 36 34 28 6e 55 72 69 2b 32 29 3b alloc64(nUri+2);
169a0 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c 65 20 . if( !zFile
169b0 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
169c0 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
169d0 69 66 28 20 6e 55 72 69 20 29 7b 0a 20 20 20 20 if( nUri ){.
169e0 20 20 6d 65 6d 63 70 79 28 7a 46 69 6c 65 2c 20 memcpy(zFile,
169f0 7a 55 72 69 2c 20 6e 55 72 69 29 3b 0a 20 20 20 zUri, nUri);.
16a00 20 7d 0a 20 20 20 20 7a 46 69 6c 65 5b 6e 55 72 }. zFile[nUr
16a10 69 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 7a i] = '\0';. z
16a20 46 69 6c 65 5b 6e 55 72 69 2b 31 5d 20 3d 20 27 File[nUri+1] = '
16a30 5c 30 27 3b 0a 20 20 20 20 66 6c 61 67 73 20 26 \0';. flags &
16a40 3d 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 = ~SQLITE_OPEN_U
16a50 52 49 3b 0a 20 20 7d 0a 0a 20 20 2a 70 70 56 66 RI;. }.. *ppVf
16a60 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 66 73 5f s = sqlite3_vfs_
16a70 66 69 6e 64 28 7a 56 66 73 29 3b 0a 20 20 69 66 find(zVfs);. if
16a80 28 20 2a 70 70 56 66 73 3d 3d 30 20 29 7b 0a 20 ( *ppVfs==0 ){.
16a90 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
16aa0 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
16ab0 6e 6f 20 73 75 63 68 20 76 66 73 3a 20 25 73 22 no such vfs: %s"
16ac0 2c 20 7a 56 66 73 29 3b 0a 20 20 20 20 72 63 20 , zVfs);. rc
16ad0 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
16ae0 20 20 7d 0a 20 70 61 72 73 65 5f 75 72 69 5f 6f }. parse_uri_o
16af0 75 74 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 ut:. if( rc!=SQ
16b00 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 LITE_OK ){. s
16b10 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 69 6c qlite3_free(zFil
16b20 65 29 3b 0a 20 20 20 20 7a 46 69 6c 65 20 3d 20 e);. zFile =
16b30 30 3b 0a 20 20 7d 0a 20 20 2a 70 46 6c 61 67 73 0;. }. *pFlags
16b40 20 3d 20 66 6c 61 67 73 3b 0a 20 20 2a 70 7a 46 = flags;. *pzF
16b50 69 6c 65 20 3d 20 7a 46 69 6c 65 3b 0a 20 20 72 ile = zFile;. r
16b60 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
16b70 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
16b80 20 64 6f 65 73 20 74 68 65 20 77 6f 72 6b 20 6f does the work o
16b90 66 20 6f 70 65 6e 69 6e 67 20 61 20 64 61 74 61 f opening a data
16ba0 62 61 73 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f base on behalf o
16bb0 66 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 f.** sqlite3_ope
16bc0 6e 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f n() and sqlite3_
16bd0 6f 70 65 6e 31 36 28 29 2e 20 54 68 65 20 64 61 open16(). The da
16be0 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 tabase filename
16bf0 22 7a 46 69 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a "zFilename" .**
16c00 20 69 73 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 is UTF-8 encode
16c10 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
16c20 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20 openDatabase(.
16c30 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 const char *zFi
16c40 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62 lename, /* Datab
16c50 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46 ase filename UTF
16c60 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 -8 encoded */.
16c70 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c 20 sqlite3 **ppDb,
16c80 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 /* OUT: R
16c90 65 74 75 72 6e 65 64 20 64 61 74 61 62 61 73 65 eturned database
16ca0 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 75 6e 73 handle */. uns
16cb0 69 67 6e 65 64 20 69 6e 74 20 66 6c 61 67 73 2c igned int flags,
16cc0 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e /* Operation
16cd0 61 6c 20 66 6c 61 67 73 20 2a 2f 0a 20 20 63 6f al flags */. co
16ce0 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 nst char *zVfs
16cf0 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
16d00 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 20 2a the VFS to use *
16d10 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a /.){. sqlite3 *
16d20 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 db;
16d30 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 /* Store
16d40 61 6c 6c 6f 63 61 74 65 64 20 68 61 6e 64 6c 65 allocated handle
16d50 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 72 here */. int r
16d60 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
16d70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
16d80 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
16d90 6e 74 20 69 73 54 68 72 65 61 64 73 61 66 65 3b nt isThreadsafe;
16da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
16db0 2a 20 54 72 75 65 20 66 6f 72 20 74 68 72 65 61 * True for threa
16dc0 64 73 61 66 65 20 63 6f 6e 6e 65 63 74 69 6f 6e dsafe connection
16dd0 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4f 70 s */. char *zOp
16de0 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 en = 0;
16df0 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 6e 61 /* Filena
16e00 6d 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 70 me argument to p
16e10 61 73 73 20 74 6f 20 42 74 72 65 65 4f 70 65 6e ass to BtreeOpen
16e20 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 () */. char *zE
16e30 72 72 4d 73 67 20 3d 20 30 3b 20 20 20 20 20 20 rrMsg = 0;
16e40 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 /* Error
16e50 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20 73 71 message from sq
16e60 6c 69 74 65 33 50 61 72 73 65 55 72 69 28 29 20 lite3ParseUri()
16e70 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
16e80 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
16e90 4f 52 0a 20 20 69 66 28 20 70 70 44 62 3d 3d 30 OR. if( ppDb==0
16ea0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
16eb0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
16ec0 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 3d 20 30 ndif. *ppDb = 0
16ed0 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
16ee0 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 _OMIT_AUTOINIT.
16ef0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e rc = sqlite3_in
16f00 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 itialize();. if
16f10 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
16f20 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 ;.#endif.. if(
16f30 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
16f40 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 3d 3d fig.bCoreMutex==
16f50 30 20 29 7b 0a 20 20 20 20 69 73 54 68 72 65 61 0 ){. isThrea
16f60 64 73 61 66 65 20 3d 20 30 3b 0a 20 20 7d 65 6c dsafe = 0;. }el
16f70 73 65 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 se if( flags & S
16f80 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 QLITE_OPEN_NOMUT
16f90 45 58 20 29 7b 0a 20 20 20 20 69 73 54 68 72 65 EX ){. isThre
16fa0 61 64 73 61 66 65 20 3d 20 30 3b 0a 20 20 7d 65 adsafe = 0;. }e
16fb0 6c 73 65 20 69 66 28 20 66 6c 61 67 73 20 26 20 lse if( flags &
16fc0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c SQLITE_OPEN_FULL
16fd0 4d 55 54 45 58 20 29 7b 0a 20 20 20 20 69 73 54 MUTEX ){. isT
16fe0 68 72 65 61 64 73 61 66 65 20 3d 20 31 3b 0a 20 hreadsafe = 1;.
16ff0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 73 54 68 }else{. isTh
17000 72 65 61 64 73 61 66 65 20 3d 20 73 71 6c 69 74 readsafe = sqlit
17010 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
17020 46 75 6c 6c 4d 75 74 65 78 3b 0a 20 20 7d 0a 20 FullMutex;. }.
17030 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c if( flags & SQL
17040 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 ITE_OPEN_PRIVATE
17050 43 41 43 48 45 20 29 7b 0a 20 20 20 20 66 6c 61 CACHE ){. fla
17060 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4f 50 gs &= ~SQLITE_OP
17070 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 3b 0a EN_SHAREDCACHE;.
17080 20 20 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69 }else if( sqli
17090 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
170a0 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c sharedCacheEnabl
170b0 65 64 20 29 7b 0a 20 20 20 20 66 6c 61 67 73 20 ed ){. flags
170c0 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 |= SQLITE_OPEN_S
170d0 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 7d 0a HAREDCACHE;. }.
170e0 0a 20 20 2f 2a 20 52 65 6d 6f 76 65 20 68 61 72 . /* Remove har
170f0 6d 66 75 6c 20 62 69 74 73 20 66 72 6f 6d 20 74 mful bits from t
17100 68 65 20 66 6c 61 67 73 20 70 61 72 61 6d 65 74 he flags paramet
17110 65 72 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 er. **. ** The
17120 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d SQLITE_OPEN_NOM
17130 55 54 45 58 20 61 6e 64 20 53 51 4c 49 54 45 5f UTEX and SQLITE_
17140 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 66 OPEN_FULLMUTEX f
17150 6c 61 67 73 20 77 65 72 65 0a 20 20 2a 2a 20 64 lags were. ** d
17160 65 61 6c 74 20 77 69 74 68 20 69 6e 20 74 68 65 ealt with in the
17170 20 70 72 65 76 69 6f 75 73 20 63 6f 64 65 20 62 previous code b
17180 6c 6f 63 6b 2e 20 20 42 65 73 69 64 65 73 20 74 lock. Besides t
17190 68 65 73 65 2c 20 74 68 65 20 6f 6e 6c 79 0a 20 hese, the only.
171a0 20 2a 2a 20 76 61 6c 69 64 20 69 6e 70 75 74 20 ** valid input
171b0 66 6c 61 67 73 20 66 6f 72 20 73 71 6c 69 74 65 flags for sqlite
171c0 33 5f 6f 70 65 6e 5f 76 32 28 29 20 61 72 65 20 3_open_v2() are
171d0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
171e0 4f 4e 4c 59 2c 0a 20 20 2a 2a 20 53 51 4c 49 54 ONLY,. ** SQLIT
171f0 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
17200 2c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 , SQLITE_OPEN_CR
17210 45 41 54 45 2c 20 53 51 4c 49 54 45 5f 4f 50 45 EATE, SQLITE_OPE
17220 4e 5f 53 48 41 52 45 44 43 41 43 48 45 2c 0a 20 N_SHAREDCACHE,.
17230 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ** SQLITE_OPEN_
17240 50 52 49 56 41 54 45 43 41 43 48 45 2c 20 61 6e PRIVATECACHE, an
17250 64 20 73 6f 6d 65 20 72 65 73 65 72 76 65 64 20 d some reserved
17260 62 69 74 73 2e 20 20 53 69 6c 65 6e 74 6c 79 20 bits. Silently
17270 6d 61 73 6b 0a 20 20 2a 2a 20 6f 66 66 20 61 6c mask. ** off al
17280 6c 20 6f 74 68 65 72 20 66 6c 61 67 73 2e 0a 20 l other flags..
17290 20 2a 2f 0a 20 20 66 6c 61 67 73 20 26 3d 20 20 */. flags &=
172a0 7e 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 ~( SQLITE_OPEN_D
172b0 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 20 7c 0a 20 ELETEONCLOSE |.
172c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
172d0 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 LITE_OPEN_EXCLUS
172e0 49 56 45 20 7c 0a 20 20 20 20 20 20 20 20 20 20 IVE |.
172f0 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
17300 5f 4d 41 49 4e 5f 44 42 20 7c 0a 20 20 20 20 20 _MAIN_DB |.
17310 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
17320 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 20 7c 20 _OPEN_TEMP_DB |
17330 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
17340 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 52 41 4e SQLITE_OPEN_TRAN
17350 53 49 45 4e 54 5f 44 42 20 7c 20 0a 20 20 20 20 SIENT_DB | .
17360 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
17370 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
17380 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 20 20 20 NAL | .
17390 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
173a0 4e 5f 54 45 4d 50 5f 4a 4f 55 52 4e 41 4c 20 7c N_TEMP_JOURNAL |
173b0 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
173c0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 42 SQLITE_OPEN_SUB
173d0 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 JOURNAL | .
173e0 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
173f0 5f 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 _OPEN_MASTER_JOU
17400 52 4e 41 4c 20 7c 0a 20 20 20 20 20 20 20 20 20 RNAL |.
17410 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
17420 4e 5f 4e 4f 4d 55 54 45 58 20 7c 0a 20 20 20 20 N_NOMUTEX |.
17430 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
17440 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 E_OPEN_FULLMUTEX
17450 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
17460 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 57 41 SQLITE_OPEN_WA
17470 4c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 29 L. )
17480 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 ;.. /* Allocate
17490 20 74 68 65 20 73 71 6c 69 74 65 20 64 61 74 61 the sqlite data
174a0 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 structure */.
174b0 64 62 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c db = sqlite3Mall
174c0 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 73 ocZero( sizeof(s
174d0 71 6c 69 74 65 33 29 20 29 3b 0a 20 20 69 66 28 qlite3) );. if(
174e0 20 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 db==0 ) goto op
174f0 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 69 66 28 20 endb_out;. if(
17500 69 73 54 68 72 65 61 64 73 61 66 65 20 29 7b 0a isThreadsafe ){.
17510 20 20 20 20 64 62 2d 3e 6d 75 74 65 78 20 3d 20 db->mutex =
17520 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
17530 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 52 c(SQLITE_MUTEX_R
17540 45 43 55 52 53 49 56 45 29 3b 0a 20 20 20 20 69 ECURSIVE);. i
17550 66 28 20 64 62 2d 3e 6d 75 74 65 78 3d 3d 30 20 f( db->mutex==0
17560 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
17570 5f 66 72 65 65 28 64 62 29 3b 0a 20 20 20 20 20 _free(db);.
17580 20 64 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 67 db = 0;. g
17590 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
175a0 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
175b0 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
175c0 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 db->mutex);. db
175d0 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30 78 66 66 ->errMask = 0xff
175e0 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b ;. db->nDb = 2;
175f0 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
17600 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 QLITE_MAGIC_BUSY
17610 3b 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 ;. db->aDb = db
17620 2d 3e 61 44 62 53 74 61 74 69 63 3b 0a 0a 20 20 ->aDbStatic;..
17630 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 64 assert( sizeof(d
17640 62 2d 3e 61 4c 69 6d 69 74 29 3d 3d 73 69 7a 65 b->aLimit)==size
17650 6f 66 28 61 48 61 72 64 4c 69 6d 69 74 29 20 29 of(aHardLimit) )
17660 3b 0a 20 20 6d 65 6d 63 70 79 28 64 62 2d 3e 61 ;. memcpy(db->a
17670 4c 69 6d 69 74 2c 20 61 48 61 72 64 4c 69 6d 69 Limit, aHardLimi
17680 74 2c 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c t, sizeof(db->aL
17690 69 6d 69 74 29 29 3b 0a 20 20 64 62 2d 3e 61 4c imit));. db->aL
176a0 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 imit[SQLITE_LIMI
176b0 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 T_WORKER_THREADS
176c0 5d 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 ] = SQLITE_DEFAU
176d0 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 LT_WORKER_THREAD
176e0 53 3b 0a 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d S;. db->autoCom
176f0 6d 69 74 20 3d 20 31 3b 0a 20 20 64 62 2d 3e 6e mit = 1;. db->n
17700 65 78 74 41 75 74 6f 76 61 63 20 3d 20 2d 31 3b extAutovac = -1;
17710 0a 20 20 64 62 2d 3e 73 7a 4d 6d 61 70 20 3d 20 . db->szMmap =
17720 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
17730 66 69 67 2e 73 7a 4d 6d 61 70 3b 0a 20 20 64 62 fig.szMmap;. db
17740 2d 3e 6e 65 78 74 50 61 67 65 73 69 7a 65 20 3d ->nextPagesize =
17750 20 30 3b 0a 20 20 64 62 2d 3e 6e 4d 61 78 53 6f 0;. db->nMaxSo
17760 72 74 65 72 4d 6d 61 70 20 3d 20 30 78 37 46 46 rterMmap = 0x7FF
17770 46 46 46 46 46 3b 0a 20 20 64 62 2d 3e 66 6c 61 FFFFF;. db->fla
17780 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 53 68 6f gs |= SQLITE_Sho
17790 72 74 43 6f 6c 4e 61 6d 65 73 20 7c 20 53 51 4c rtColNames | SQL
177a0 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 67 67 65 ITE_EnableTrigge
177b0 72 20 7c 20 53 51 4c 49 54 45 5f 43 61 63 68 65 r | SQLITE_Cache
177c0 53 70 69 6c 6c 0a 23 69 66 20 21 64 65 66 69 6e Spill.#if !defin
177d0 65 64 28 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ed(SQLITE_DEFAUL
177e0 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 T_AUTOMATIC_INDE
177f0 58 29 20 7c 7c 20 53 51 4c 49 54 45 5f 44 45 46 X) || SQLITE_DEF
17800 41 55 4c 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 AULT_AUTOMATIC_I
17810 4e 44 45 58 0a 20 20 20 20 20 20 20 20 20 20 20 NDEX.
17820 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 41 | SQLITE_A
17830 75 74 6f 49 6e 64 65 78 0a 23 65 6e 64 69 66 0a utoIndex.#endif.
17840 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 #if SQLITE_DEFAU
17850 4c 54 5f 43 4b 50 54 46 55 4c 4c 46 53 59 4e 43 LT_CKPTFULLFSYNC
17860 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
17870 20 20 7c 20 53 51 4c 49 54 45 5f 43 6b 70 74 46 | SQLITE_CkptF
17880 75 6c 6c 46 53 79 6e 63 0a 23 65 6e 64 69 66 0a ullFSync.#endif.
17890 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 #if SQLITE_DEFAU
178a0 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 3c 34 LT_FILE_FORMAT<4
178b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
178c0 20 20 7c 20 53 51 4c 49 54 45 5f 4c 65 67 61 63 | SQLITE_Legac
178d0 79 46 69 6c 65 46 6d 74 0a 23 65 6e 64 69 66 0a yFileFmt.#endif.
178e0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
178f0 41 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 ABLE_LOAD_EXTENS
17900 49 4f 4e 0a 20 20 20 20 20 20 20 20 20 20 20 20 ION.
17910 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c 6f | SQLITE_Lo
17920 61 64 45 78 74 65 6e 73 69 6f 6e 0a 23 65 6e 64 adExtension.#end
17930 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 if.#if SQLITE_DE
17940 46 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 5f FAULT_RECURSIVE_
17950 54 52 49 47 47 45 52 53 0a 20 20 20 20 20 20 20 TRIGGERS.
17960 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 | SQLI
17970 54 45 5f 52 65 63 54 72 69 67 67 65 72 73 0a 23 TE_RecTriggers.#
17980 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 endif.#if define
17990 64 28 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 d(SQLITE_DEFAULT
179a0 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 53 29 20 26 _FOREIGN_KEYS) &
179b0 26 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 & SQLITE_DEFAULT
179c0 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 53 0a 20 20 _FOREIGN_KEYS.
179d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
179e0 20 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b SQLITE_ForeignK
179f0 65 79 73 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 eys.#endif.#if d
17a00 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 52 45 efined(SQLITE_RE
17a10 56 45 52 53 45 5f 55 4e 4f 52 44 45 52 45 44 5f VERSE_UNORDERED_
17a20 53 45 4c 45 43 54 53 29 0a 20 20 20 20 20 20 20 SELECTS).
17a30 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 | SQLI
17a40 54 45 5f 52 65 76 65 72 73 65 4f 72 64 65 72 0a TE_ReverseOrder.
17a50 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
17a60 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
17a70 5f 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 _OVERSIZE_CELL_C
17a80 48 45 43 4b 29 0a 20 20 20 20 20 20 20 20 20 20 HECK).
17a90 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
17aa0 43 65 6c 6c 53 69 7a 65 43 6b 0a 23 65 6e 64 69 CellSizeCk.#endi
17ab0 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 f.#if defined(SQ
17ac0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 LITE_ENABLE_FTS3
17ad0 5f 54 4f 4b 45 4e 49 5a 45 52 29 0a 20 20 20 20 _TOKENIZER).
17ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 | S
17af0 51 4c 49 54 45 5f 46 74 73 33 54 6f 6b 65 6e 69 QLITE_Fts3Tokeni
17b00 7a 65 72 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 zer.#endif.#if d
17b10 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e efined(SQLITE_EN
17b20 41 42 4c 45 5f 51 50 53 47 29 0a 20 20 20 20 20 ABLE_QPSG).
17b30 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 | SQ
17b40 4c 49 54 45 5f 45 6e 61 62 6c 65 51 50 53 47 0a LITE_EnableQPSG.
17b50 23 65 6e 64 69 66 0a 20 20 20 20 20 20 3b 0a 20 #endif. ;.
17b60 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74 sqlite3HashInit
17b70 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b (&db->aCollSeq);
17b80 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
17b90 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
17ba0 45 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 E. sqlite3HashI
17bb0 6e 69 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 nit(&db->aModule
17bc0 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 );.#endif.. /*
17bd0 41 64 64 20 74 68 65 20 64 65 66 61 75 6c 74 20 Add the default
17be0 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
17bf0 63 65 20 42 49 4e 41 52 59 2e 20 42 49 4e 41 52 ce BINARY. BINAR
17c00 59 20 77 6f 72 6b 73 20 66 6f 72 20 62 6f 74 68 Y works for both
17c10 20 55 54 46 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 UTF-8. ** and
17c20 55 54 46 2d 31 36 2c 20 73 6f 20 61 64 64 20 61 UTF-16, so add a
17c30 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 65 61 63 version for eac
17c40 68 20 74 6f 20 61 76 6f 69 64 20 61 6e 79 20 75 h to avoid any u
17c50 6e 6e 65 63 65 73 73 61 72 79 0a 20 20 2a 2a 20 nnecessary. **
17c60 63 6f 6e 76 65 72 73 69 6f 6e 73 2e 20 54 68 65 conversions. The
17c70 20 6f 6e 6c 79 20 65 72 72 6f 72 20 74 68 61 74 only error that
17c80 20 63 61 6e 20 6f 63 63 75 72 20 68 65 72 65 20 can occur here
17c90 69 73 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 is a malloc() fa
17ca0 69 6c 75 72 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a ilure.. **. **
17cb0 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
17cc0 35 32 37 38 36 2d 34 34 38 37 38 20 53 51 4c 69 52786-44878 SQLi
17cd0 74 65 20 64 65 66 69 6e 65 73 20 74 68 72 65 65 te defines three
17ce0 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 built-in collat
17cf0 69 6e 67 0a 20 20 2a 2a 20 66 75 6e 63 74 69 6f ing. ** functio
17d00 6e 73 3a 0a 20 20 2a 2f 0a 20 20 63 72 65 61 74 ns:. */. creat
17d10 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 73 eCollation(db, s
17d20 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 59 2c qlite3StrBINARY,
17d30 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c SQLITE_UTF8, 0,
17d40 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 binCollFunc, 0)
17d50 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 ;. createCollat
17d60 69 6f 6e 28 64 62 2c 20 73 71 6c 69 74 65 33 53 ion(db, sqlite3S
17d70 74 72 42 49 4e 41 52 59 2c 20 53 51 4c 49 54 45 trBINARY, SQLITE
17d80 5f 55 54 46 31 36 42 45 2c 20 30 2c 20 62 69 6e _UTF16BE, 0, bin
17d90 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 CollFunc, 0);.
17da0 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 createCollation(
17db0 64 62 2c 20 73 71 6c 69 74 65 33 53 74 72 42 49 db, sqlite3StrBI
17dc0 4e 41 52 59 2c 20 53 51 4c 49 54 45 5f 55 54 46 NARY, SQLITE_UTF
17dd0 31 36 4c 45 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 16LE, 0, binColl
17de0 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 Func, 0);. crea
17df0 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
17e00 22 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54 45 "NOCASE", SQLITE
17e10 5f 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73 65 _UTF8, 0, nocase
17e20 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 2c 20 30 CollatingFunc, 0
17e30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 );. createColla
17e40 74 69 6f 6e 28 64 62 2c 20 22 52 54 52 49 4d 22 tion(db, "RTRIM"
17e50 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 28 , SQLITE_UTF8, (
17e60 76 6f 69 64 2a 29 31 2c 20 62 69 6e 43 6f 6c 6c void*)1, binColl
17e70 46 75 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 Func, 0);. if(
17e80 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
17e90 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 ){. goto ope
17ea0 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 2f ndb_out;. }. /
17eb0 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
17ec0 2d 30 38 33 30 38 2d 31 37 32 32 34 20 54 68 65 -08308-17224 The
17ed0 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 default collati
17ee0 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 ng function for
17ef0 61 6c 6c 0a 20 20 2a 2a 20 73 74 72 69 6e 67 73 all. ** strings
17f00 20 69 73 20 42 49 4e 41 52 59 2e 20 0a 20 20 2a is BINARY. . *
17f10 2f 0a 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c /. db->pDfltCol
17f20 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
17f30 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 54 ollSeq(db, SQLIT
17f40 45 5f 55 54 46 38 2c 20 73 71 6c 69 74 65 33 53 E_UTF8, sqlite3S
17f50 74 72 42 49 4e 41 52 59 2c 20 30 29 3b 0a 20 20 trBINARY, 0);.
17f60 61 73 73 65 72 74 28 20 64 62 2d 3e 70 44 66 6c assert( db->pDfl
17f70 74 43 6f 6c 6c 21 3d 30 20 29 3b 0a 0a 20 20 2f tColl!=0 );.. /
17f80 2a 20 50 61 72 73 65 20 74 68 65 20 66 69 6c 65 * Parse the file
17f90 6e 61 6d 65 2f 55 52 49 20 61 72 67 75 6d 65 6e name/URI argumen
17fa0 74 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4f 6e 6c 79 t. **. ** Only
17fb0 20 61 6c 6c 6f 77 20 73 65 6e 73 69 62 6c 65 20 allow sensible
17fc0 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 6f 66 20 combinations of
17fd0 62 69 74 73 20 69 6e 20 74 68 65 20 66 6c 61 67 bits in the flag
17fe0 73 20 61 72 67 75 6d 65 6e 74 2e 20 20 0a 20 20 s argument. .
17ff0 2a 2a 20 54 68 72 6f 77 20 61 6e 20 65 72 72 6f ** Throw an erro
18000 72 20 69 66 20 61 6e 79 20 6e 6f 6e 2d 73 65 6e r if any non-sen
18010 73 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 69 se combination i
18020 73 20 75 73 65 64 2e 20 20 49 66 20 77 65 0a 20 s used. If we.
18030 20 2a 2a 20 64 6f 20 6e 6f 74 20 62 6c 6f 63 6b ** do not block
18040 20 69 6c 6c 65 67 61 6c 20 63 6f 6d 62 69 6e 61 illegal combina
18050 74 69 6f 6e 73 20 68 65 72 65 2c 20 69 74 20 63 tions here, it c
18060 6f 75 6c 64 20 74 72 69 67 67 65 72 0a 20 20 2a ould trigger. *
18070 2a 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 * assert() state
18080 6d 65 6e 74 73 20 69 6e 20 64 65 65 70 65 72 20 ments in deeper
18090 6c 61 79 65 72 73 2e 20 20 53 65 6e 73 69 62 6c layers. Sensibl
180a0 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 0a 20 e combinations.
180b0 20 2a 2a 20 61 72 65 3a 0a 20 20 2a 2a 0a 20 20 ** are:. **.
180c0 2a 2a 20 20 31 3a 20 20 53 51 4c 49 54 45 5f 4f ** 1: SQLITE_O
180d0 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 0a 20 20 2a PEN_READONLY. *
180e0 2a 20 20 32 3a 20 20 53 51 4c 49 54 45 5f 4f 50 * 2: SQLITE_OP
180f0 45 4e 5f 52 45 41 44 57 52 49 54 45 0a 20 20 2a EN_READWRITE. *
18100 2a 20 20 36 3a 20 20 53 51 4c 49 54 45 5f 4f 50 * 6: SQLITE_OP
18110 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 53 EN_READWRITE | S
18120 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 QLITE_OPEN_CREAT
18130 45 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e 6f 70 65 E. */. db->ope
18140 6e 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a nFlags = flags;.
18150 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 assert( SQLITE
18160 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 20 _OPEN_READONLY
18170 3d 3d 20 30 78 30 31 20 29 3b 0a 20 20 61 73 73 == 0x01 );. ass
18180 65 72 74 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e ert( SQLITE_OPEN
18190 5f 52 45 41 44 57 52 49 54 45 20 3d 3d 20 30 78 _READWRITE == 0x
181a0 30 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 02 );. assert(
181b0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 SQLITE_OPEN_CREA
181c0 54 45 20 20 20 20 3d 3d 20 30 78 30 34 20 29 3b TE == 0x04 );
181d0 0a 20 20 74 65 73 74 63 61 73 65 28 20 28 31 3c . testcase( (1<
181e0 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 <(flags&7))==0x0
181f0 32 20 29 3b 20 2f 2a 20 52 45 41 44 4f 4e 4c 59 2 ); /* READONLY
18200 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 */. testcase(
18210 28 31 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d (1<<(flags&7))==
18220 30 78 30 34 20 29 3b 20 2f 2a 20 52 45 41 44 57 0x04 ); /* READW
18230 52 49 54 45 20 2a 2f 0a 20 20 74 65 73 74 63 61 RITE */. testca
18240 73 65 28 20 28 31 3c 3c 28 66 6c 61 67 73 26 37 se( (1<<(flags&7
18250 29 29 3d 3d 30 78 34 30 20 29 3b 20 2f 2a 20 52 ))==0x40 ); /* R
18260 45 41 44 57 52 49 54 45 20 7c 20 43 52 45 41 54 EADWRITE | CREAT
18270 45 20 2a 2f 0a 20 20 69 66 28 20 28 28 31 3c 3c E */. if( ((1<<
18280 28 66 6c 61 67 73 26 37 29 29 20 26 20 30 78 34 (flags&7)) & 0x4
18290 36 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 6)==0 ){. rc
182a0 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f = SQLITE_MISUSE_
182b0 42 4b 50 54 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 BKPT; /* IMP: R
182c0 2d 36 35 34 39 37 2d 34 34 35 39 34 20 2a 2f 0a -65497-44594 */.
182d0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 }else{. rc
182e0 3d 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 = sqlite3ParseUr
182f0 69 28 7a 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d i(zVfs, zFilenam
18300 65 2c 20 26 66 6c 61 67 73 2c 20 26 64 62 2d 3e e, &flags, &db->
18310 70 56 66 73 2c 20 26 7a 4f 70 65 6e 2c 20 26 7a pVfs, &zOpen, &z
18320 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 69 ErrMsg);. }. i
18330 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
18340 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d ){. if( rc==
18350 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 20 73 SQLITE_NOMEM ) s
18360 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 qlite3OomFault(d
18370 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 b);. sqlite3E
18380 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 rrorWithMsg(db,
18390 72 63 2c 20 7a 45 72 72 4d 73 67 20 3f 20 22 25 rc, zErrMsg ? "%
183a0 73 22 20 3a 20 30 2c 20 7a 45 72 72 4d 73 67 29 s" : 0, zErrMsg)
183b0 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 ;. sqlite3_fr
183c0 65 65 28 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 ee(zErrMsg);.
183d0 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 goto opendb_out
183e0 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e ;. }.. /* Open
183f0 20 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 the backend dat
18400 61 62 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a abase driver */.
18410 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 rc = sqlite3Bt
18420 72 65 65 4f 70 65 6e 28 64 62 2d 3e 70 56 66 73 reeOpen(db->pVfs
18430 2c 20 7a 4f 70 65 6e 2c 20 64 62 2c 20 26 64 62 , zOpen, db, &db
18440 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c 20 30 2c ->aDb[0].pBt, 0,
18450 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
18460 20 20 20 20 20 20 20 20 20 66 6c 61 67 73 20 7c flags |
18470 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
18480 4e 5f 44 42 29 3b 0a 20 20 69 66 28 20 72 63 21 N_DB);. if( rc!
18490 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
184a0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
184b0 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a _IOERR_NOMEM ){.
184c0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
184d0 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
184e0 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 }. sqlite3E
184f0 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 20 rror(db, rc);.
18500 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 goto opendb_ou
18510 74 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 t;. }. sqlite3
18520 42 74 72 65 65 45 6e 74 65 72 28 64 62 2d 3e 61 BtreeEnter(db->a
18530 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 62 Db[0].pBt);. db
18540 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d 61 ->aDb[0].pSchema
18550 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 = sqlite3Schema
18560 47 65 74 28 64 62 2c 20 64 62 2d 3e 61 44 62 5b Get(db, db->aDb[
18570 30 5d 2e 70 42 74 29 3b 0a 20 20 69 66 28 20 21 0].pBt);. if( !
18580 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
18590 20 29 20 45 4e 43 28 64 62 29 20 3d 20 53 43 48 ) ENC(db) = SCH
185a0 45 4d 41 5f 45 4e 43 28 64 62 29 3b 0a 20 20 73 EMA_ENC(db);. s
185b0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
185c0 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 (db->aDb[0].pBt)
185d0 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 ;. db->aDb[1].p
185e0 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 Schema = sqlite3
185f0 53 63 68 65 6d 61 47 65 74 28 64 62 2c 20 30 29 SchemaGet(db, 0)
18600 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 64 65 66 61 ;.. /* The defa
18610 75 6c 74 20 73 61 66 65 74 79 5f 6c 65 76 65 6c ult safety_level
18620 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 64 61 for the main da
18630 74 61 62 61 73 65 20 69 73 20 46 55 4c 4c 3b 20 tabase is FULL;
18640 66 6f 72 20 74 68 65 20 74 65 6d 70 0a 20 20 2a for the temp. *
18650 2a 20 64 61 74 61 62 61 73 65 20 69 74 20 69 73 * database it is
18660 20 4f 46 46 2e 20 54 68 69 73 20 6d 61 74 63 68 OFF. This match
18670 65 73 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 es the pager lay
18680 65 72 20 64 65 66 61 75 6c 74 73 2e 20 20 0a 20 er defaults. .
18690 20 2a 2f 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d */. db->aDb[0]
186a0 2e 7a 44 62 53 4e 61 6d 65 20 3d 20 22 6d 61 69 .zDbSName = "mai
186b0 6e 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d n";. db->aDb[0]
186c0 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 .safety_level =
186d0 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 SQLITE_DEFAULT_S
186e0 59 4e 43 48 52 4f 4e 4f 55 53 2b 31 3b 0a 20 20 YNCHRONOUS+1;.
186f0 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 44 62 53 4e db->aDb[1].zDbSN
18700 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 20 20 ame = "temp";.
18710 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66 65 74 db->aDb[1].safet
18720 79 5f 6c 65 76 65 6c 20 3d 20 50 41 47 45 52 5f y_level = PAGER_
18730 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4f 46 46 3b SYNCHRONOUS_OFF;
18740 0a 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 .. db->magic =
18750 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 SQLITE_MAGIC_OPE
18760 4e 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c N;. if( db->mal
18770 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 locFailed ){.
18780 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 goto opendb_out
18790 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 67 69 ;. }.. /* Regi
187a0 73 74 65 72 20 61 6c 6c 20 62 75 69 6c 74 2d 69 ster all built-i
187b0 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62 75 74 n functions, but
187c0 20 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 do not attempt
187d0 74 6f 20 72 65 61 64 20 74 68 65 0a 20 20 2a 2a to read the. **
187e0 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
187f0 20 79 65 74 2e 20 54 68 69 73 20 69 73 20 64 65 yet. This is de
18800 6c 61 79 65 64 20 75 6e 74 69 6c 20 74 68 65 20 layed until the
18810 66 69 72 73 74 20 74 69 6d 65 20 74 68 65 20 64 first time the d
18820 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 20 atabase. ** is
18830 61 63 63 65 73 73 65 64 2e 0a 20 20 2a 2f 0a 20 accessed.. */.
18840 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
18850 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 , SQLITE_OK);.
18860 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 50 sqlite3RegisterP
18870 65 72 43 6f 6e 6e 65 63 74 69 6f 6e 42 75 69 6c erConnectionBuil
18880 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 64 62 29 tinFunctions(db)
18890 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
188a0 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a 0a 23 _errcode(db);..#
188b0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
188c0 42 4c 45 5f 46 54 53 35 0a 20 20 2f 2a 20 52 65 BLE_FTS5. /* Re
188d0 67 69 73 74 65 72 20 61 6e 79 20 62 75 69 6c 74 gister any built
188e0 2d 69 6e 20 46 54 53 35 20 6d 6f 64 75 6c 65 20 -in FTS5 module
188f0 62 65 66 6f 72 65 20 6c 6f 61 64 69 6e 67 20 74 before loading t
18900 68 65 20 61 75 74 6f 6d 61 74 69 63 0a 20 20 2a he automatic. *
18910 2a 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 54 68 * extensions. Th
18920 69 73 20 61 6c 6c 6f 77 73 20 61 75 74 6f 6d 61 is allows automa
18930 74 69 63 20 65 78 74 65 6e 73 69 6f 6e 73 20 74 tic extensions t
18940 6f 20 72 65 67 69 73 74 65 72 20 46 54 53 35 20 o register FTS5
18950 0a 20 20 2a 2a 20 74 6f 6b 65 6e 69 7a 65 72 73 . ** tokenizers
18960 20 61 6e 64 20 61 75 78 69 6c 69 61 72 79 20 66 and auxiliary f
18970 75 6e 63 74 69 6f 6e 73 2e 20 20 2a 2f 0a 20 20 unctions. */.
18980 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
18990 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
189a0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
189b0 20 3d 20 73 71 6c 69 74 65 33 46 74 73 35 49 6e = sqlite3Fts5In
189c0 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
189d0 69 66 0a 0a 20 20 2f 2a 20 4c 6f 61 64 20 61 75 if.. /* Load au
189e0 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 69 6f tomatic extensio
189f0 6e 73 20 2d 20 65 78 74 65 6e 73 69 6f 6e 73 20 ns - extensions
18a00 74 68 61 74 20 68 61 76 65 20 62 65 65 6e 20 72 that have been r
18a10 65 67 69 73 74 65 72 65 64 0a 20 20 2a 2a 20 75 egistered. ** u
18a20 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 sing the sqlite3
18a30 5f 61 75 74 6f 6d 61 74 69 63 5f 65 78 74 65 6e _automatic_exten
18a40 73 69 6f 6e 28 29 20 41 50 49 2e 0a 20 20 2a 2f sion() API.. */
18a50 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
18a60 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
18a70 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 6e te3AutoLoadExten
18a80 73 69 6f 6e 73 28 64 62 29 3b 0a 20 20 20 20 72 sions(db);. r
18a90 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 c = sqlite3_errc
18aa0 6f 64 65 28 64 62 29 3b 0a 20 20 20 20 69 66 28 ode(db);. if(
18ab0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
18ac0 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 {. goto ope
18ad0 6e 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 ndb_out;. }.
18ae0 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }..#ifdef SQLIT
18af0 45 5f 45 4e 41 42 4c 45 5f 46 54 53 31 0a 20 20 E_ENABLE_FTS1.
18b00 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
18b10 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 65 78 74 ailed ){. ext
18b20 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 46 ern int sqlite3F
18b30 74 73 31 49 6e 69 74 28 73 71 6c 69 74 65 33 2a ts1Init(sqlite3*
18b40 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
18b50 74 65 33 46 74 73 31 49 6e 69 74 28 64 62 29 3b te3Fts1Init(db);
18b60 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 . }.#endif..#if
18b70 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
18b80 45 5f 46 54 53 32 0a 20 20 69 66 28 20 21 64 62 E_FTS2. if( !db
18b90 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 ->mallocFailed &
18ba0 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
18bb0 29 7b 0a 20 20 20 20 65 78 74 65 72 6e 20 69 6e ){. extern in
18bc0 74 20 73 71 6c 69 74 65 33 46 74 73 32 49 6e 69 t sqlite3Fts2Ini
18bd0 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 t(sqlite3*);.
18be0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 46 74 73 rc = sqlite3Fts
18bf0 32 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 2Init(db);. }.#
18c00 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 endif..#ifdef SQ
18c10 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 LITE_ENABLE_FTS3
18c20 20 2f 2a 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c /* automaticall
18c30 79 20 64 65 66 69 6e 65 64 20 62 79 20 53 51 4c y defined by SQL
18c40 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 20 ITE_ENABLE_FTS4
18c50 2a 2f 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 */. if( !db->ma
18c60 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 llocFailed && rc
18c70 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
18c80 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 46 rc = sqlite3F
18c90 74 73 33 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d ts3Init(db);. }
18ca0 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
18cb0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 SQLITE_ENABLE_IC
18cc0 55 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c U. if( !db->mal
18cd0 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 3d locFailed && rc=
18ce0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
18cf0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 63 rc = sqlite3Ic
18d00 75 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 uInit(db);. }.#
18d10 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 endif..#ifdef SQ
18d20 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 LITE_ENABLE_RTRE
18d30 45 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c E. if( !db->mal
18d40 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 3d locFailed && rc=
18d50 3d 53 51 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 20 =SQLITE_OK){.
18d60 20 72 63 20 3d 20 73 71 6c 69 74 65 33 52 74 72 rc = sqlite3Rtr
18d70 65 65 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a eeInit(db);. }.
18d80 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 #endif..#ifdef S
18d90 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 44 42 53 QLITE_ENABLE_DBS
18da0 54 41 54 5f 56 54 41 42 0a 20 20 69 66 28 20 21 TAT_VTAB. if( !
18db0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
18dc0 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f && rc==SQLITE_O
18dd0 4b 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c K){. rc = sql
18de0 69 74 65 33 44 62 73 74 61 74 52 65 67 69 73 74 ite3DbstatRegist
18df0 65 72 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 er(db);. }.#end
18e00 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
18e10 45 5f 45 4e 41 42 4c 45 5f 4a 53 4f 4e 31 0a 20 E_ENABLE_JSON1.
18e20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 if( !db->malloc
18e30 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 Failed && rc==SQ
18e40 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 LITE_OK){. rc
18e50 20 3d 20 73 71 6c 69 74 65 33 4a 73 6f 6e 31 49 = sqlite3Json1I
18e60 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e nit(db);. }.#en
18e70 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
18e80 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d 54 56 54 TE_ENABLE_STMTVT
18e90 41 42 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 AB. if( !db->ma
18ea0 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 llocFailed && rc
18eb0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 ==SQLITE_OK){.
18ec0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 53 74 rc = sqlite3St
18ed0 6d 74 56 74 61 62 49 6e 69 74 28 64 62 29 3b 0a mtVtabInit(db);.
18ee0 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a }.#endif.. /*
18ef0 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 4c -DSQLITE_DEFAUL
18f00 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 31 T_LOCKING_MODE=1
18f10 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 49 56 45 makes EXCLUSIVE
18f20 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 the default loc
18f30 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 king. ** mode.
18f40 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 41 55 4c -DSQLITE_DEFAUL
18f50 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 30 T_LOCKING_MODE=0
18f60 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 74 68 65 make NORMAL the
18f70 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 default locking
18f80 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 44 6f 69 . ** mode. Doi
18f90 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 20 61 6c ng nothing at al
18fa0 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 4e 4f 52 l also makes NOR
18fb0 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c 74 2e MAL the default.
18fc0 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c . */.#ifdef SQL
18fd0 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b ITE_DEFAULT_LOCK
18fe0 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 2d 3e 64 ING_MODE. db->d
18ff0 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d 20 53 51 fltLockMode = SQ
19000 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 LITE_DEFAULT_LOC
19010 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 73 71 6c KING_MODE;. sql
19020 69 74 65 33 50 61 67 65 72 4c 6f 63 6b 69 6e 67 ite3PagerLocking
19030 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 74 72 65 Mode(sqlite3Btre
19040 65 50 61 67 65 72 28 64 62 2d 3e 61 44 62 5b 30 ePager(db->aDb[0
19050 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 20 20 20 ].pBt),.
19060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19070 20 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 SQLITE_DEFAULT
19080 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 29 3b 0a _LOCKING_MODE);.
19090 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 72 63 #endif.. if( rc
190a0 20 29 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 ) sqlite3Error(
190b0 64 62 2c 20 72 63 29 3b 0a 0a 20 20 2f 2a 20 45 db, rc);.. /* E
190c0 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 73 nable the lookas
190d0 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 79 ide-malloc subsy
190e0 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 70 4c stem */. setupL
190f0 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 2c 20 ookaside(db, 0,
19100 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
19110 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 2c fig.szLookaside,
19120 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
19130 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
19140 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f GlobalConfig.nLo
19150 6f 6b 61 73 69 64 65 29 3b 0a 0a 20 20 73 71 6c okaside);.. sql
19160 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 ite3_wal_autoche
19170 63 6b 70 6f 69 6e 74 28 64 62 2c 20 53 51 4c 49 ckpoint(db, SQLI
19180 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f 41 TE_DEFAULT_WAL_A
19190 55 54 4f 43 48 45 43 4b 50 4f 49 4e 54 29 3b 0a UTOCHECKPOINT);.
191a0 0a 6f 70 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 69 .opendb_out:. i
191b0 66 28 20 64 62 20 29 7b 0a 20 20 20 20 61 73 73 f( db ){. ass
191c0 65 72 74 28 20 64 62 2d 3e 6d 75 74 65 78 21 3d ert( db->mutex!=
191d0 30 20 7c 7c 20 69 73 54 68 72 65 61 64 73 61 66 0 || isThreadsaf
191e0 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 e==0.
191f0 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c || sqlite3Global
19200 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 Config.bFullMute
19210 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 x==0 );. sqli
19220 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
19230 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a db->mutex);. }.
19240 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 rc = sqlite3_e
19250 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 61 73 rrcode(db);. as
19260 73 65 72 74 28 20 64 62 21 3d 30 20 7c 7c 20 72 sert( db!=0 || r
19270 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 c==SQLITE_NOMEM
19280 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
19290 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 ITE_NOMEM ){.
192a0 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 sqlite3_close(d
192b0 62 29 3b 0a 20 20 20 20 64 62 20 3d 20 30 3b 0a b);. db = 0;.
192c0 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d }else if( rc!=
192d0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
192e0 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
192f0 49 54 45 5f 4d 41 47 49 43 5f 53 49 43 4b 3b 0a ITE_MAGIC_SICK;.
19300 20 20 7d 0a 20 20 2a 70 70 44 62 20 3d 20 64 62 }. *ppDb = db
19310 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
19320 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 ENABLE_SQLLOG.
19330 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
19340 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 lConfig.xSqllog
19350 29 7b 0a 20 20 20 20 2f 2a 20 4f 70 65 6e 69 6e ){. /* Openin
19360 67 20 61 20 64 62 20 68 61 6e 64 6c 65 2e 20 46 g a db handle. F
19370 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 72 20 ourth parameter
19380 69 73 20 70 61 73 73 65 64 20 30 2e 20 2a 2f 0a is passed 0. */.
19390 20 20 20 20 76 6f 69 64 20 2a 70 41 72 67 20 3d void *pArg =
193a0 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
193b0 6e 66 69 67 2e 70 53 71 6c 6c 6f 67 41 72 67 3b nfig.pSqllogArg;
193c0 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
193d0 61 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 alConfig.xSqllog
193e0 28 70 41 72 67 2c 20 64 62 2c 20 7a 46 69 6c 65 (pArg, db, zFile
193f0 6e 61 6d 65 2c 20 30 29 3b 0a 20 20 7d 0a 23 65 name, 0);. }.#e
19400 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 ndif.#if defined
19410 28 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 (SQLITE_HAS_CODE
19420 43 29 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c C). if( rc==SQL
19430 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 63 6f ITE_OK ){. co
19440 6e 73 74 20 63 68 61 72 20 2a 7a 4b 65 79 3b 0a nst char *zKey;.
19450 20 20 20 20 69 66 28 20 28 7a 4b 65 79 20 3d 20 if( (zKey =
19460 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 sqlite3_uri_para
19470 6d 65 74 65 72 28 7a 4f 70 65 6e 2c 20 22 68 65 meter(zOpen, "he
19480 78 6b 65 79 22 29 29 21 3d 30 20 26 26 20 7a 4b xkey"))!=0 && zK
19490 65 79 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 75 ey[0] ){. u
194a0 38 20 69 42 79 74 65 3b 0a 20 20 20 20 20 20 69 8 iByte;. i
194b0 6e 74 20 69 3b 0a 20 20 20 20 20 20 63 68 61 72 nt i;. char
194c0 20 7a 44 65 63 6f 64 65 64 5b 34 30 5d 3b 0a 20 zDecoded[40];.
194d0 20 20 20 20 20 66 6f 72 28 69 3d 30 2c 20 69 42 for(i=0, iB
194e0 79 74 65 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28 yte=0; i<sizeof(
194f0 7a 44 65 63 6f 64 65 64 29 2a 32 20 26 26 20 73 zDecoded)*2 && s
19500 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 7a qlite3Isxdigit(z
19510 4b 65 79 5b 69 5d 29 3b 20 69 2b 2b 29 7b 0a 20 Key[i]); i++){.
19520 20 20 20 20 20 20 20 69 42 79 74 65 20 3d 20 28 iByte = (
19530 69 42 79 74 65 3c 3c 34 29 20 2b 20 73 71 6c 69 iByte<<4) + sqli
19540 74 65 33 48 65 78 54 6f 49 6e 74 28 7a 4b 65 79 te3HexToInt(zKey
19550 5b 69 5d 29 3b 0a 20 20 20 20 20 20 20 20 69 66 [i]);. if
19560 28 20 28 69 26 31 29 21 3d 30 20 29 20 7a 44 65 ( (i&1)!=0 ) zDe
19570 63 6f 64 65 64 5b 69 2f 32 5d 20 3d 20 69 42 79 coded[i/2] = iBy
19580 74 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 te;. }.
19590 20 20 73 71 6c 69 74 65 33 5f 6b 65 79 5f 76 32 sqlite3_key_v2
195a0 28 64 62 2c 20 30 2c 20 7a 44 65 63 6f 64 65 64 (db, 0, zDecoded
195b0 2c 20 69 2f 32 29 3b 0a 20 20 20 20 7d 65 6c 73 , i/2);. }els
195c0 65 20 69 66 28 20 28 7a 4b 65 79 20 3d 20 73 71 e if( (zKey = sq
195d0 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 lite3_uri_parame
195e0 74 65 72 28 7a 4f 70 65 6e 2c 20 22 6b 65 79 22 ter(zOpen, "key"
195f0 29 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 ))!=0 ){. s
19600 71 6c 69 74 65 33 5f 6b 65 79 5f 76 32 28 64 62 qlite3_key_v2(db
19610 2c 20 30 2c 20 7a 4b 65 79 2c 20 73 71 6c 69 74 , 0, zKey, sqlit
19620 65 33 53 74 72 6c 65 6e 33 30 28 7a 4b 65 79 29 e3Strlen30(zKey)
19630 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e );. }. }.#en
19640 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 dif. sqlite3_fr
19650 65 65 28 7a 4f 70 65 6e 29 3b 0a 20 20 72 65 74 ee(zOpen);. ret
19660 75 72 6e 20 72 63 20 26 20 30 78 66 66 3b 0a 7d urn rc & 0xff;.}
19670 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e ../*.** Open a n
19680 65 77 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 ew database hand
19690 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 le..*/.int sqlit
196a0 65 33 5f 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 e3_open(. const
196b0 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
196c0 2c 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 , . sqlite3 **p
196d0 70 44 62 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e pDb .){. return
196e0 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 openDatabase(zF
196f0 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c 0a 20 ilename, ppDb,.
19700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19710 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
19720 5f 52 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c _READWRITE | SQL
19730 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c ITE_OPEN_CREATE,
19740 20 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 0);.}.int sqlit
19750 65 33 5f 6f 70 65 6e 5f 76 32 28 0a 20 20 63 6f e3_open_v2(. co
19760 6e 73 74 20 63 68 61 72 20 2a 66 69 6c 65 6e 61 nst char *filena
19770 6d 65 2c 20 20 20 2f 2a 20 44 61 74 61 62 61 73 me, /* Databas
19780 65 20 66 69 6c 65 6e 61 6d 65 20 28 55 54 46 2d e filename (UTF-
19790 38 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 8) */. sqlite3
197a0 2a 2a 70 70 44 62 2c 20 20 20 20 20 20 20 20 20 **ppDb,
197b0 2f 2a 20 4f 55 54 3a 20 53 51 4c 69 74 65 20 64 /* OUT: SQLite d
197c0 62 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e b handle */. in
197d0 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 20 t flags,
197e0 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 2a /* Flags *
197f0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
19800 7a 56 66 73 20 20 20 20 20 20 20 20 2f 2a 20 4e zVfs /* N
19810 61 6d 65 20 6f 66 20 56 46 53 20 6d 6f 64 75 6c ame of VFS modul
19820 65 20 74 6f 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 e to use */.){.
19830 20 72 65 74 75 72 6e 20 6f 70 65 6e 44 61 74 61 return openData
19840 62 61 73 65 28 66 69 6c 65 6e 61 6d 65 2c 20 70 base(filename, p
19850 70 44 62 2c 20 28 75 6e 73 69 67 6e 65 64 20 69 pDb, (unsigned i
19860 6e 74 29 66 6c 61 67 73 2c 20 7a 56 66 73 29 3b nt)flags, zVfs);
19870 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
19880 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a TE_OMIT_UTF16./*
19890 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 .** Open a new d
198a0 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a atabase handle..
198b0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f */.int sqlite3_o
198c0 70 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76 pen16(. const v
198d0 6f 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 oid *zFilename,
198e0 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 . sqlite3 **ppD
198f0 62 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73 b.){. char cons
19900 74 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20 t *zFilename8;
19910 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e /* zFilename en
19920 63 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69 coded in UTF-8 i
19930 6e 73 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36 nstead of UTF-16
19940 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 */. sqlite3_va
19950 6c 75 65 20 2a 70 56 61 6c 3b 0a 20 20 69 6e 74 lue *pVal;. int
19960 20 72 63 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c rc;..#ifdef SQL
19970 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
19980 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 44 62 3d RMOR. if( ppDb=
19990 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =0 ) return SQLI
199a0 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
199b0 23 65 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 3d #endif. *ppDb =
199c0 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 0;.#ifndef SQLI
199d0 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 TE_OMIT_AUTOINIT
199e0 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f . rc = sqlite3_
199f0 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 initialize();.
19a00 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
19a10 72 63 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 rc;.#endif. if(
19a20 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 29 20 zFilename==0 )
19a30 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 5c 30 30 zFilename = "\00
19a40 30 5c 30 30 30 22 3b 0a 20 20 70 56 61 6c 20 3d 0\000";. pVal =
19a50 20 73 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 sqlite3ValueNew
19a60 28 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 (0);. sqlite3Va
19a70 6c 75 65 53 65 74 53 74 72 28 70 56 61 6c 2c 20 lueSetStr(pVal,
19a80 2d 31 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 53 -1, zFilename, S
19a90 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
19aa0 45 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 E, SQLITE_STATIC
19ab0 29 3b 0a 20 20 7a 46 69 6c 65 6e 61 6d 65 38 20 );. zFilename8
19ac0 3d 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 = sqlite3ValueTe
19ad0 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f xt(pVal, SQLITE_
19ae0 55 54 46 38 29 3b 0a 20 20 69 66 28 20 7a 46 69 UTF8);. if( zFi
19af0 6c 65 6e 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 lename8 ){. r
19b00 63 20 3d 20 6f 70 65 6e 44 61 74 61 62 61 73 65 c = openDatabase
19b10 28 7a 46 69 6c 65 6e 61 6d 65 38 2c 20 70 70 44 (zFilename8, ppD
19b20 62 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 b,.
19b30 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
19b40 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c OPEN_READWRITE |
19b50 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 SQLITE_OPEN_CRE
19b60 41 54 45 2c 20 30 29 3b 0a 20 20 20 20 61 73 73 ATE, 0);. ass
19b70 65 72 74 28 20 2a 70 70 44 62 20 7c 7c 20 72 63 ert( *ppDb || rc
19b80 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 ==SQLITE_NOMEM )
19b90 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
19ba0 4c 49 54 45 5f 4f 4b 20 26 26 20 21 44 62 48 61 LITE_OK && !DbHa
19bb0 73 50 72 6f 70 65 72 74 79 28 2a 70 70 44 62 2c sProperty(*ppDb,
19bc0 20 30 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 0, DB_SchemaLoa
19bd0 64 65 64 29 20 29 7b 0a 20 20 20 20 20 20 53 43 ded) ){. SC
19be0 48 45 4d 41 5f 45 4e 43 28 2a 70 70 44 62 29 20 HEMA_ENC(*ppDb)
19bf0 3d 20 45 4e 43 28 2a 70 70 44 62 29 20 3d 20 53 = ENC(*ppDb) = S
19c00 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
19c10 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 E;. }. }else
19c20 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
19c30 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
19c40 7d 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 }. sqlite3Value
19c50 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a 20 20 72 Free(pVal);.. r
19c60 65 74 75 72 6e 20 72 63 20 26 20 30 78 66 66 3b eturn rc & 0xff;
19c70 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
19c80 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a ITE_OMIT_UTF16 *
19c90 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 /../*.** Registe
19ca0 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f r a new collatio
19cb0 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 n sequence with
19cc0 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e the database han
19cd0 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 dle db..*/.int s
19ce0 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
19cf0 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 llation(. sqlit
19d00 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 e3* db, . const
19d10 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 char *zName, .
19d20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 int enc, . voi
19d30 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a d* pCtx,. int(*
19d40 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c xCompare)(void*,
19d50 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
19d60 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 int,const void*)
19d70 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c .){. return sql
19d80 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
19d90 61 74 69 6f 6e 5f 76 32 28 64 62 2c 20 7a 4e 61 ation_v2(db, zNa
19da0 6d 65 2c 20 65 6e 63 2c 20 70 43 74 78 2c 20 78 me, enc, pCtx, x
19db0 43 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 7d 0a 0a Compare, 0);.}..
19dc0 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
19dd0 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 new collation s
19de0 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 equence with the
19df0 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
19e00 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 db..*/.int sqli
19e10 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 te3_create_colla
19e20 74 69 6f 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 tion_v2(. sqlit
19e30 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 e3* db, . const
19e40 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 char *zName, .
19e50 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 int enc, . voi
19e60 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a d* pCtx,. int(*
19e70 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c xCompare)(void*,
19e80 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
19e90 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 int,const void*)
19ea0 2c 0a 20 20 76 6f 69 64 28 2a 78 44 65 6c 29 28 ,. void(*xDel)(
19eb0 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 void*).){. int
19ec0 72 63 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 rc;..#ifdef SQLI
19ed0 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
19ee0 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
19ef0 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
19f00 64 62 29 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 db) || zName==0
19f10 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
19f20 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e MISUSE_BKPT;.#en
19f30 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
19f40 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
19f50 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 tex);. assert(
19f60 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
19f70 64 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 65 61 d );. rc = crea
19f80 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
19f90 7a 4e 61 6d 65 2c 20 28 75 38 29 65 6e 63 2c 20 zName, (u8)enc,
19fa0 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 pCtx, xCompare,
19fb0 78 44 65 6c 29 3b 0a 20 20 72 63 20 3d 20 73 71 xDel);. rc = sq
19fc0 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
19fd0 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
19fe0 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
19ff0 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
1a000 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 rc;.}..#ifndef
1a010 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
1a020 36 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 6./*.** Register
1a030 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e a new collation
1a040 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 sequence with t
1a050 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
1a060 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 le db..*/.int sq
1a070 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c lite3_create_col
1a080 6c 61 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 lation16(. sqli
1a090 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 te3* db, . cons
1a0a0 74 20 76 6f 69 64 20 2a 7a 4e 61 6d 65 2c 0a 20 t void *zName,.
1a0b0 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 int enc, . voi
1a0c0 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a d* pCtx,. int(*
1a0d0 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c xCompare)(void*,
1a0e0 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
1a0f0 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 int,const void*)
1a100 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 .){. int rc = S
1a110 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 68 61 72 QLITE_OK;. char
1a120 20 2a 7a 4e 61 6d 65 38 3b 0a 0a 23 69 66 64 65 *zName8;..#ifde
1a130 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
1a140 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
1a150 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
1a160 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 7a 4e 61 eckOk(db) || zNa
1a170 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 me==0 ) return S
1a180 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
1a190 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 T;.#endif. sqli
1a1a0 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
1a1b0 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
1a1c0 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
1a1d0 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 4e 61 cFailed );. zNa
1a1e0 6d 65 38 20 3d 20 73 71 6c 69 74 65 33 55 74 66 me8 = sqlite3Utf
1a1f0 31 36 74 6f 38 28 64 62 2c 20 7a 4e 61 6d 65 2c 16to8(db, zName,
1a200 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 -1, SQLITE_UTF1
1a210 36 4e 41 54 49 56 45 29 3b 0a 20 20 69 66 28 20 6NATIVE);. if(
1a220 7a 4e 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 zName8 ){. rc
1a230 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 = createCollati
1a240 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c 20 28 on(db, zName8, (
1a250 75 38 29 65 6e 63 2c 20 70 43 74 78 2c 20 78 43 u8)enc, pCtx, xC
1a260 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 20 20 20 20 ompare, 0);.
1a270 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
1a280 2c 20 7a 4e 61 6d 65 38 29 3b 0a 20 20 7d 0a 20 , zName8);. }.
1a290 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 rc = sqlite3Api
1a2a0 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 Exit(db, rc);.
1a2b0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
1a2c0 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
1a2d0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 return rc;.}.#
1a2e0 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
1a2f0 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f OMIT_UTF16 */../
1a300 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
1a310 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
1a320 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 ce factory callb
1a330 61 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 ack with the dat
1a340 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 abase handle.**
1a350 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 db. Replace any
1a360 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 previously insta
1a370 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 lled collation s
1a380 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e equence factory.
1a390 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
1a3a0 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 collation_needed
1a3b0 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
1a3c0 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e . void *pCollN
1a3d0 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 eededArg, . voi
1a3e0 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 d(*xCollNeeded)(
1a3f0 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 void*,sqlite3*,i
1a400 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 nt eTextRep,cons
1a410 74 20 63 68 61 72 2a 29 0a 29 7b 0a 23 69 66 64 t char*).){.#ifd
1a420 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
1a430 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
1a440 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
1a450 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 heckOk(db) ) ret
1a460 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
1a470 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 E_BKPT;.#endif.
1a480 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
1a490 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
1a4a0 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 . db->xCollNeed
1a4b0 65 64 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 65 64 ed = xCollNeeded
1a4c0 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 ;. db->xCollNee
1a4d0 64 65 64 31 36 20 3d 20 30 3b 0a 20 20 64 62 2d ded16 = 0;. db-
1a4e0 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 >pCollNeededArg
1a4f0 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 = pCollNeededArg
1a500 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
1a510 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
1a520 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c x);. return SQL
1a530 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 ITE_OK;.}..#ifnd
1a540 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
1a550 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 TF16./*.** Regis
1a560 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 ter a collation
1a570 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 sequence factory
1a580 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 callback with t
1a590 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
1a5a0 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 le.** db. Replac
1a5b0 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 e any previously
1a5c0 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 installed colla
1a5d0 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 tion sequence fa
1a5e0 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ctory..*/.int sq
1a5f0 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f lite3_collation_
1a600 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71 6c 69 needed16(. sqli
1a610 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 te3 *db, . void
1a620 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 *pCollNeededArg
1a630 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c , . void(*xColl
1a640 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64 2a 2c Needed16)(void*,
1a650 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 sqlite3*,int eTe
1a660 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f 69 64 xtRep,const void
1a670 2a 29 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *).){.#ifdef SQL
1a680 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
1a690 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
1a6a0 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
1a6b0 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 (db) ) return SQ
1a6c0 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
1a6d0 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 ;.#endif. sqlit
1a6e0 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1a6f0 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d b->mutex);. db-
1a700 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 30 >xCollNeeded = 0
1a710 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 ;. db->xCollNee
1a720 64 65 64 31 36 20 3d 20 78 43 6f 6c 6c 4e 65 65 ded16 = xCollNee
1a730 64 65 64 31 36 3b 0a 20 20 64 62 2d 3e 70 43 6f ded16;. db->pCo
1a740 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20 70 43 llNeededArg = pC
1a750 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 ollNeededArg;.
1a760 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
1a770 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
1a780 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1a790 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 OK;.}.#endif /*
1a7a0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
1a7b0 36 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 6 */..#ifndef SQ
1a7c0 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
1a7d0 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ATED./*.** This
1a7e0 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 77 20 function is now
1a7f0 61 6e 20 61 6e 61 63 68 72 6f 6e 69 73 6d 2e 20 an anachronism.
1a800 49 74 20 75 73 65 64 20 74 6f 20 62 65 20 75 73 It used to be us
1a810 65 64 20 74 6f 20 72 65 63 6f 76 65 72 20 66 72 ed to recover fr
1a820 6f 6d 20 61 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 om a.** malloc()
1a830 20 66 61 69 6c 75 72 65 2c 20 62 75 74 20 53 51 failure, but SQ
1a840 4c 69 74 65 20 6e 6f 77 20 64 6f 65 73 20 74 68 Lite now does th
1a850 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 is automatically
1a860 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1a870 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76 65 72 28 _global_recover(
1a880 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 void){. return
1a890 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e SQLITE_OK;.}.#en
1a8a0 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 dif../*.** Test
1a8b0 74 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 6f to see whether o
1a8c0 72 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 r not the databa
1a8d0 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 se connection is
1a8e0 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 0a 2a in autocommit.*
1a8f0 2a 20 6d 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 * mode. Return
1a900 54 52 55 45 20 69 66 20 69 74 20 69 73 20 61 6e TRUE if it is an
1a910 64 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 2e 20 d FALSE if not.
1a920 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 Autocommit mode
1a930 20 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64 65 66 is on.** by def
1a940 61 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 ault. Autocommi
1a950 74 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 t is disabled by
1a960 20 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65 a BEGIN stateme
1a970 6e 74 20 61 6e 64 20 72 65 65 6e 61 62 6c 65 64 nt and reenabled
1a980 0a 2a 2a 20 62 79 20 74 68 65 20 6e 65 78 74 20 .** by the next
1a990 43 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c 42 41 COMMIT or ROLLBA
1a9a0 43 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 CK..*/.int sqlit
1a9b0 65 33 5f 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 e3_get_autocommi
1a9c0 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a t(sqlite3 *db){.
1a9d0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
1a9e0 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
1a9f0 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
1aa00 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
1aa10 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
1aa20 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
1aa30 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
1aa40 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 }.#endif. retur
1aa50 6e 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 n db->autoCommit
1aa60 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 ;.}../*.** The f
1aa70 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 ollowing routine
1aa80 73 20 61 72 65 20 73 75 62 73 74 69 74 75 74 65 s are substitute
1aa90 73 20 66 6f 72 20 63 6f 6e 73 74 61 6e 74 73 20 s for constants
1aaa0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c 0a SQLITE_CORRUPT,.
1aab0 2a 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 ** SQLITE_MISUSE
1aac0 2c 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 , SQLITE_CANTOPE
1aad0 4e 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 N, SQLITE_NOMEM
1aae0 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 6f 74 68 and possibly oth
1aaf0 65 72 20 65 72 72 6f 72 0a 2a 2a 20 63 6f 6e 73 er error.** cons
1ab00 74 61 6e 74 73 2e 20 20 54 68 65 79 20 73 65 72 tants. They ser
1ab10 76 65 20 74 77 6f 20 70 75 72 70 6f 73 65 73 3a ve two purposes:
1ab20 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 20 53 65 72 .**.** 1. Ser
1ab30 76 65 20 61 73 20 61 20 63 6f 6e 76 65 6e 69 65 ve as a convenie
1ab40 6e 74 20 70 6c 61 63 65 20 74 6f 20 73 65 74 20 nt place to set
1ab50 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 69 6e 20 a breakpoint in
1ab60 61 20 64 65 62 75 67 67 65 72 0a 2a 2a 20 20 20 a debugger.**
1ab70 20 20 20 20 74 6f 20 64 65 74 65 63 74 20 77 68 to detect wh
1ab80 65 6e 20 76 65 72 73 69 6f 6e 20 65 72 72 6f 72 en version error
1ab90 20 63 6f 6e 64 69 74 69 6f 6e 73 20 6f 63 63 75 conditions occu
1aba0 72 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e 20 20 rs..**.** 2.
1abb0 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 5f 6c Invoke sqlite3_l
1abc0 6f 67 28 29 20 74 6f 20 70 72 6f 76 69 64 65 20 og() to provide
1abd0 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 the source code
1abe0 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 0a 2a location where.*
1abf0 2a 20 20 20 20 20 20 20 61 20 6c 6f 77 2d 6c 65 * a low-le
1ac00 76 65 6c 20 65 72 72 6f 72 20 69 73 20 66 69 72 vel error is fir
1ac10 73 74 20 64 65 74 65 63 74 65 64 2e 0a 2a 2f 0a st detected..*/.
1ac20 73 74 61 74 69 63 20 69 6e 74 20 72 65 70 6f 72 static int repor
1ac30 74 45 72 72 6f 72 28 69 6e 74 20 69 45 72 72 2c tError(int iErr,
1ac40 20 69 6e 74 20 6c 69 6e 65 6e 6f 2c 20 63 6f 6e int lineno, con
1ac50 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 29 7b st char *zType){
1ac60 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 69 . sqlite3_log(i
1ac70 45 72 72 2c 20 22 25 73 20 61 74 20 6c 69 6e 65 Err, "%s at line
1ac80 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c %d of [%.10s]",
1ac90 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a . z
1aca0 54 79 70 65 2c 20 6c 69 6e 65 6e 6f 2c 20 32 30 Type, lineno, 20
1acb0 2b 73 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 +sqlite3_sourcei
1acc0 64 28 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 69 d());. return i
1acd0 45 72 72 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 Err;.}.int sqlit
1ace0 65 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 e3CorruptError(i
1acf0 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 nt lineno){. te
1ad00 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 stcase( sqlite3G
1ad10 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
1ad20 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 !=0 );. return
1ad30 72 65 70 6f 72 74 45 72 72 6f 72 28 53 51 4c 49 reportError(SQLI
1ad40 54 45 5f 43 4f 52 52 55 50 54 2c 20 6c 69 6e 65 TE_CORRUPT, line
1ad50 6e 6f 2c 20 22 64 61 74 61 62 61 73 65 20 63 6f no, "database co
1ad60 72 72 75 70 74 69 6f 6e 22 29 3b 0a 7d 0a 69 6e rruption");.}.in
1ad70 74 20 73 71 6c 69 74 65 33 4d 69 73 75 73 65 45 t sqlite3MisuseE
1ad80 72 72 6f 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 rror(int lineno)
1ad90 7b 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 71 {. testcase( sq
1ada0 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1adb0 67 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 72 g.xLog!=0 );. r
1adc0 65 74 75 72 6e 20 72 65 70 6f 72 74 45 72 72 6f eturn reportErro
1add0 72 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c r(SQLITE_MISUSE,
1ade0 20 6c 69 6e 65 6e 6f 2c 20 22 6d 69 73 75 73 65 lineno, "misuse
1adf0 22 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 ");.}.int sqlite
1ae00 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f 72 28 69 3CantopenError(i
1ae10 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 nt lineno){. te
1ae20 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 stcase( sqlite3G
1ae30 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
1ae40 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 !=0 );. return
1ae50 72 65 70 6f 72 74 45 72 72 6f 72 28 53 51 4c 49 reportError(SQLI
1ae60 54 45 5f 43 41 4e 54 4f 50 45 4e 2c 20 6c 69 6e TE_CANTOPEN, lin
1ae70 65 6e 6f 2c 20 22 63 61 6e 6e 6f 74 20 6f 70 65 eno, "cannot ope
1ae80 6e 20 66 69 6c 65 22 29 3b 0a 7d 0a 23 69 66 64 n file");.}.#ifd
1ae90 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
1aea0 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 int sqlite3Corru
1aeb0 70 74 50 67 6e 6f 45 72 72 6f 72 28 69 6e 74 20 ptPgnoError(int
1aec0 6c 69 6e 65 6e 6f 2c 20 50 67 6e 6f 20 70 67 6e lineno, Pgno pgn
1aed0 6f 29 7b 0a 20 20 63 68 61 72 20 7a 4d 73 67 5b o){. char zMsg[
1aee0 31 30 30 5d 3b 0a 20 20 73 71 6c 69 74 65 33 5f 100];. sqlite3_
1aef0 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 snprintf(sizeof(
1af00 7a 4d 73 67 29 2c 20 7a 4d 73 67 2c 20 22 64 61 zMsg), zMsg, "da
1af10 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
1af20 6e 20 70 61 67 65 20 25 64 22 2c 20 70 67 6e 6f n page %d", pgno
1af30 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 );. testcase( s
1af40 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1af50 69 67 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 ig.xLog!=0 );.
1af60 72 65 74 75 72 6e 20 72 65 70 6f 72 74 45 72 72 return reportErr
1af70 6f 72 28 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 or(SQLITE_CORRUP
1af80 54 2c 20 6c 69 6e 65 6e 6f 2c 20 7a 4d 73 67 29 T, lineno, zMsg)
1af90 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 4e ;.}.int sqlite3N
1afa0 6f 6d 65 6d 45 72 72 6f 72 28 69 6e 74 20 6c 69 omemError(int li
1afb0 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 neno){. testcas
1afc0 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c e( sqlite3Global
1afd0 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 Config.xLog!=0 )
1afe0 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 70 6f 72 ;. return repor
1aff0 74 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 4e 4f tError(SQLITE_NO
1b000 4d 45 4d 2c 20 6c 69 6e 65 6e 6f 2c 20 22 4f 4f MEM, lineno, "OO
1b010 4d 22 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 M");.}.int sqlit
1b020 65 33 49 6f 65 72 72 6e 6f 6d 65 6d 45 72 72 6f e3IoerrnomemErro
1b030 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 r(int lineno){.
1b040 20 74 65 73 74 63 61 73 65 28 20 73 71 6c 69 74 testcase( sqlit
1b050 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
1b060 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 Log!=0 );. retu
1b070 72 6e 20 72 65 70 6f 72 74 45 72 72 6f 72 28 53 rn reportError(S
1b080 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 QLITE_IOERR_NOME
1b090 4d 2c 20 6c 69 6e 65 6e 6f 2c 20 22 49 2f 4f 20 M, lineno, "I/O
1b0a0 4f 4f 4d 20 65 72 72 6f 72 22 29 3b 0a 7d 0a 23 OOM error");.}.#
1b0b0 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
1b0c0 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 QLITE_OMIT_DEPRE
1b0d0 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 68 69 73 CATED./*.** This
1b0e0 20 69 73 20 61 20 63 6f 6e 76 65 6e 69 65 6e 63 is a convenienc
1b0f0 65 20 72 6f 75 74 69 6e 65 20 74 68 61 74 20 6d e routine that m
1b100 61 6b 65 73 20 73 75 72 65 20 74 68 61 74 20 61 akes sure that a
1b110 6c 6c 20 74 68 72 65 61 64 2d 73 70 65 63 69 66 ll thread-specif
1b120 69 63 0a 2a 2a 20 64 61 74 61 20 66 6f 72 20 74 ic.** data for t
1b130 68 69 73 20 74 68 72 65 61 64 20 68 61 73 20 62 his thread has b
1b140 65 65 6e 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e een deallocated.
1b150 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 6e 6f .**.** SQLite no
1b160 20 6c 6f 6e 67 65 72 20 75 73 65 73 20 74 68 72 longer uses thr
1b170 65 61 64 2d 73 70 65 63 69 66 69 63 20 64 61 74 ead-specific dat
1b180 61 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 6e a so this routin
1b190 65 20 69 73 20 6e 6f 77 20 61 0a 2a 2a 20 6e 6f e is now a.** no
1b1a0 2d 6f 70 2e 20 20 49 74 20 69 73 20 72 65 74 61 -op. It is reta
1b1b0 69 6e 65 64 20 66 6f 72 20 68 69 73 74 6f 72 69 ined for histori
1b1c0 63 61 6c 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 cal compatibilit
1b1d0 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 y..*/.void sqlit
1b1e0 65 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 e3_thread_cleanu
1b1f0 70 28 76 6f 69 64 29 7b 0a 7d 0a 23 65 6e 64 69 p(void){.}.#endi
1b200 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 f../*.** Return
1b210 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
1b220 20 61 62 6f 75 74 20 61 20 73 70 65 63 69 66 69 about a specifi
1b230 63 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 20 64 61 c column of a da
1b240 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2a tabase table..**
1b250 20 53 65 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 See comment in
1b260 73 71 6c 69 74 65 33 2e 68 20 28 73 71 6c 69 74 sqlite3.h (sqlit
1b270 65 2e 68 2e 69 6e 29 20 66 6f 72 20 64 65 74 61 e.h.in) for deta
1b280 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ils..*/.int sqli
1b290 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e te3_table_column
1b2a0 5f 6d 65 74 61 64 61 74 61 28 0a 20 20 73 71 6c _metadata(. sql
1b2b0 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 ite3 *db,
1b2c0 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e /* Conn
1b2d0 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 2a 2f ection handle */
1b2e0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
1b2f0 44 62 4e 61 6d 65 2c 20 20 20 20 20 20 20 20 2f DbName, /
1b300 2a 20 44 61 74 61 62 61 73 65 20 6e 61 6d 65 20 * Database name
1b310 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 6f 6e or NULL */. con
1b320 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c 65 4e st char *zTableN
1b330 61 6d 65 2c 20 20 20 20 20 2f 2a 20 54 61 62 6c ame, /* Tabl
1b340 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 6f 6e 73 e name */. cons
1b350 74 20 63 68 61 72 20 2a 7a 43 6f 6c 75 6d 6e 4e t char *zColumnN
1b360 61 6d 65 2c 20 20 20 20 2f 2a 20 43 6f 6c 75 6d ame, /* Colum
1b370 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 63 68 61 72 n name */. char
1b380 20 63 6f 6e 73 74 20 2a 2a 70 7a 44 61 74 61 54 const **pzDataT
1b390 79 70 65 2c 20 20 20 20 2f 2a 20 4f 55 54 50 55 ype, /* OUTPU
1b3a0 54 3a 20 44 65 63 6c 61 72 65 64 20 64 61 74 61 T: Declared data
1b3b0 20 74 79 70 65 20 2a 2f 0a 20 20 63 68 61 72 20 type */. char
1b3c0 63 6f 6e 73 74 20 2a 2a 70 7a 43 6f 6c 6c 53 65 const **pzCollSe
1b3d0 71 2c 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 q, /* OUTPUT
1b3e0 3a 20 43 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 : Collation sequ
1b3f0 65 6e 63 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 69 ence name */. i
1b400 6e 74 20 2a 70 4e 6f 74 4e 75 6c 6c 2c 20 20 20 nt *pNotNull,
1b410 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
1b420 54 50 55 54 3a 20 54 72 75 65 20 69 66 20 4e 4f TPUT: True if NO
1b430 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e T NULL constrain
1b440 74 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 69 6e t exists */. in
1b450 74 20 2a 70 50 72 69 6d 61 72 79 4b 65 79 2c 20 t *pPrimaryKey,
1b460 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
1b470 50 55 54 3a 20 54 72 75 65 20 69 66 20 63 6f 6c PUT: True if col
1b480 75 6d 6e 20 70 61 72 74 20 6f 66 20 50 4b 20 2a umn part of PK *
1b490 2f 0a 20 20 69 6e 74 20 2a 70 41 75 74 6f 69 6e /. int *pAutoin
1b4a0 63 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c
1b4b0 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 /* OUTPUT: True
1b4c0 69 66 20 63 6f 6c 75 6d 6e 20 69 73 20 61 75 74 if column is aut
1b4d0 6f 2d 69 6e 63 72 65 6d 65 6e 74 20 2a 2f 0a 29 o-increment */.)
1b4e0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 68 {. int rc;. ch
1b4f0 61 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b ar *zErrMsg = 0;
1b500 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 20 3d . Table *pTab =
1b510 20 30 3b 0a 20 20 43 6f 6c 75 6d 6e 20 2a 70 43 0;. Column *pC
1b520 6f 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 43 ol = 0;. int iC
1b530 6f 6c 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 63 ol = 0;. char c
1b540 6f 6e 73 74 20 2a 7a 44 61 74 61 54 79 70 65 20 onst *zDataType
1b550 3d 20 30 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 = 0;. char cons
1b560 74 20 2a 7a 43 6f 6c 6c 53 65 71 20 3d 20 30 3b t *zCollSeq = 0;
1b570 0a 20 20 69 6e 74 20 6e 6f 74 6e 75 6c 6c 20 3d . int notnull =
1b580 20 30 3b 0a 20 20 69 6e 74 20 70 72 69 6d 61 72 0;. int primar
1b590 79 6b 65 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 ykey = 0;. int
1b5a0 61 75 74 6f 69 6e 63 20 3d 20 30 3b 0a 0a 0a 23 autoinc = 0;...#
1b5b0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
1b5c0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
1b5d0 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
1b5e0 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c 7c tyCheckOk(db) ||
1b5f0 20 7a 54 61 62 6c 65 4e 61 6d 65 3d 3d 30 20 29 zTableName==0 )
1b600 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
1b610 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
1b620 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f . }.#endif.. /
1b630 2a 20 45 6e 73 75 72 65 20 74 68 65 20 64 61 74 * Ensure the dat
1b640 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 abase schema has
1b650 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a been loaded */.
1b660 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1b670 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
1b680 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
1b690 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 EnterAll(db);.
1b6a0 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 rc = sqlite3Init
1b6b0 28 64 62 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a (db, &zErrMsg);.
1b6c0 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 if( SQLITE_OK!
1b6d0 3d 72 63 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 =rc ){. goto
1b6e0 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a error_out;. }..
1b6f0 20 20 2f 2a 20 4c 6f 63 61 74 65 20 74 68 65 20 /* Locate the
1b700 74 61 62 6c 65 20 69 6e 20 71 75 65 73 74 69 6f table in questio
1b710 6e 20 2a 2f 0a 20 20 70 54 61 62 20 3d 20 73 71 n */. pTab = sq
1b720 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 64 lite3FindTable(d
1b730 62 2c 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 7a b, zTableName, z
1b740 44 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 21 DbName);. if( !
1b750 70 54 61 62 20 7c 7c 20 70 54 61 62 2d 3e 70 53 pTab || pTab->pS
1b760 65 6c 65 63 74 20 29 7b 0a 20 20 20 20 70 54 61 elect ){. pTa
1b770 62 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 6f 20 b = 0;. goto
1b780 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a error_out;. }..
1b790 20 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 63 6f /* Find the co
1b7a0 6c 75 6d 6e 20 66 6f 72 20 77 68 69 63 68 20 69 lumn for which i
1b7b0 6e 66 6f 20 69 73 20 72 65 71 75 65 73 74 65 64 nfo is requested
1b7c0 20 2a 2f 0a 20 20 69 66 28 20 7a 43 6f 6c 75 6d */. if( zColum
1b7d0 6e 4e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 nName==0 ){.
1b7e0 2f 2a 20 51 75 65 72 79 20 66 6f 72 20 65 78 69 /* Query for exi
1b7f0 73 74 61 6e 63 65 20 6f 66 20 74 61 62 6c 65 20 stance of table
1b800 6f 6e 6c 79 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b only */. }else{
1b810 0a 20 20 20 20 66 6f 72 28 69 43 6f 6c 3d 30 3b . for(iCol=0;
1b820 20 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 6f 6c iCol<pTab->nCol
1b830 3b 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 20 20 ; iCol++){.
1b840 20 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 pCol = &pTab->a
1b850 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 20 20 Col[iCol];.
1b860 20 69 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 53 if( 0==sqlite3S
1b870 74 72 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 4e 61 trICmp(pCol->zNa
1b880 6d 65 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 me, zColumnName)
1b890 20 29 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 ){. brea
1b8a0 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
1b8b0 0a 20 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 70 . if( iCol==p
1b8c0 54 61 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 20 20 Tab->nCol ){.
1b8d0 20 20 20 69 66 28 20 48 61 73 52 6f 77 69 64 28 if( HasRowid(
1b8e0 70 54 61 62 29 20 26 26 20 73 71 6c 69 74 65 33 pTab) && sqlite3
1b8f0 49 73 52 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 4e IsRowid(zColumnN
1b900 61 6d 65 29 20 29 7b 0a 20 20 20 20 20 20 20 20 ame) ){.
1b910 69 43 6f 6c 20 3d 20 70 54 61 62 2d 3e 69 50 4b iCol = pTab->iPK
1b920 65 79 3b 0a 20 20 20 20 20 20 20 20 70 43 6f 6c ey;. pCol
1b930 20 3d 20 69 43 6f 6c 3e 3d 30 20 3f 20 26 70 54 = iCol>=0 ? &pT
1b940 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 20 3a ab->aCol[iCol] :
1b950 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0;. }else{
1b960 0a 20 20 20 20 20 20 20 20 70 54 61 62 20 3d 20 . pTab =
1b970 30 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 0;. goto
1b980 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20 error_out;.
1b990 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 }. }. }..
1b9a0 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
1b9b0 20 62 6c 6f 63 6b 20 73 74 6f 72 65 73 20 74 68 block stores th
1b9c0 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 e meta informati
1b9d0 6f 6e 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 on that will be
1b9e0 72 65 74 75 72 6e 65 64 0a 20 20 2a 2a 20 74 6f returned. ** to
1b9f0 20 74 68 65 20 63 61 6c 6c 65 72 20 69 6e 20 6c the caller in l
1ba00 6f 63 61 6c 20 76 61 72 69 61 62 6c 65 73 20 7a ocal variables z
1ba10 44 61 74 61 54 79 70 65 2c 20 7a 43 6f 6c 6c 53 DataType, zCollS
1ba20 65 71 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 72 69 eq, notnull, pri
1ba30 6d 61 72 79 6b 65 79 0a 20 20 2a 2a 20 61 6e 64 marykey. ** and
1ba40 20 61 75 74 6f 69 6e 63 2e 20 41 74 20 74 68 69 autoinc. At thi
1ba50 73 20 70 6f 69 6e 74 20 74 68 65 72 65 20 61 72 s point there ar
1ba60 65 20 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74 e two possibilit
1ba70 69 65 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a 2a 20 ies:. ** . **
1ba80 20 20 20 20 31 2e 20 54 68 65 20 73 70 65 63 69 1. The speci
1ba90 66 69 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 fied column name
1baa0 20 77 61 73 20 72 6f 77 69 64 22 2c 20 22 6f 69 was rowid", "oi
1bab0 64 22 20 6f 72 20 22 5f 72 6f 77 69 64 5f 22 20 d" or "_rowid_"
1bac0 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 61 6e 64 . ** and
1bad0 20 74 68 65 72 65 20 69 73 20 6e 6f 20 65 78 70 there is no exp
1bae0 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 licitly declared
1baf0 20 49 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a 20 20 IPK column. .
1bb00 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 32 2e 20 54 **. ** 2. T
1bb10 68 65 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 he table is not
1bb20 61 20 76 69 65 77 20 61 6e 64 20 74 68 65 20 63 a view and the c
1bb30 6f 6c 75 6d 6e 20 6e 61 6d 65 20 69 64 65 6e 74 olumn name ident
1bb40 69 66 69 65 64 20 61 6e 20 0a 20 20 2a 2a 20 20 ified an . **
1bb50 20 20 20 20 20 20 65 78 70 6c 69 63 69 74 6c 79 explicitly
1bb60 20 64 65 63 6c 61 72 65 64 20 63 6f 6c 75 6d 6e declared column
1bb70 2e 20 43 6f 70 79 20 6d 65 74 61 20 69 6e 66 6f . Copy meta info
1bb80 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 2a 70 43 rmation from *pC
1bb90 6f 6c 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 ol.. */ . if(
1bba0 70 43 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 61 74 pCol ){. zDat
1bbb0 61 54 79 70 65 20 3d 20 73 71 6c 69 74 65 33 43 aType = sqlite3C
1bbc0 6f 6c 75 6d 6e 54 79 70 65 28 70 43 6f 6c 2c 30 olumnType(pCol,0
1bbd0 29 3b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 );. zCollSeq
1bbe0 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 = pCol->zColl;.
1bbf0 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d 20 70 43 6f notnull = pCo
1bc00 6c 2d 3e 6e 6f 74 4e 75 6c 6c 21 3d 30 3b 0a 20 l->notNull!=0;.
1bc10 20 20 20 70 72 69 6d 61 72 79 6b 65 79 20 20 3d primarykey =
1bc20 20 28 70 43 6f 6c 2d 3e 63 6f 6c 46 6c 61 67 73 (pCol->colFlags
1bc30 20 26 20 43 4f 4c 46 4c 41 47 5f 50 52 49 4d 4b & COLFLAG_PRIMK
1bc40 45 59 29 21 3d 30 3b 0a 20 20 20 20 61 75 74 6f EY)!=0;. auto
1bc50 69 6e 63 20 3d 20 70 54 61 62 2d 3e 69 50 4b 65 inc = pTab->iPKe
1bc60 79 3d 3d 69 43 6f 6c 20 26 26 20 28 70 54 61 62 y==iCol && (pTab
1bc70 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f ->tabFlags & TF_
1bc80 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 29 21 3d Autoincrement)!=
1bc90 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 0;. }else{.
1bca0 7a 44 61 74 61 54 79 70 65 20 3d 20 22 49 4e 54 zDataType = "INT
1bcb0 45 47 45 52 22 3b 0a 20 20 20 20 70 72 69 6d 61 EGER";. prima
1bcc0 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 7d 0a 20 rykey = 1;. }.
1bcd0 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 71 20 29 if( !zCollSeq )
1bce0 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 3d {. zCollSeq =
1bcf0 20 73 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 sqlite3StrBINAR
1bd00 59 3b 0a 20 20 7d 0a 0a 65 72 72 6f 72 5f 6f 75 Y;. }..error_ou
1bd10 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 t:. sqlite3Btre
1bd20 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 3b 0a 0a eLeaveAll(db);..
1bd30 20 20 2f 2a 20 57 68 65 74 68 65 72 20 74 68 65 /* Whether the
1bd40 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 20 73 function call s
1bd50 75 63 63 65 65 64 65 64 20 6f 72 20 66 61 69 6c ucceeded or fail
1bd60 65 64 2c 20 73 65 74 20 74 68 65 20 6f 75 74 70 ed, set the outp
1bd70 75 74 20 70 61 72 61 6d 65 74 65 72 73 0a 20 20 ut parameters.
1bd80 2a 2a 20 74 6f 20 77 68 61 74 65 76 65 72 20 74 ** to whatever t
1bd90 68 65 69 72 20 6c 6f 63 61 6c 20 63 6f 75 6e 74 heir local count
1bda0 65 72 70 61 72 74 73 20 63 6f 6e 74 61 69 6e 2e erparts contain.
1bdb0 20 49 66 20 61 6e 20 65 72 72 6f 72 20 64 69 64 If an error did
1bdc0 20 6f 63 63 75 72 2c 0a 20 20 2a 2a 20 74 68 69 occur,. ** thi
1bdd0 73 20 68 61 73 20 74 68 65 20 65 66 66 65 63 74 s has the effect
1bde0 20 6f 66 20 7a 65 72 6f 69 6e 67 20 61 6c 6c 20 of zeroing all
1bdf0 6f 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 output parameter
1be00 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 7a s.. */. if( pz
1be10 44 61 74 61 54 79 70 65 20 29 20 2a 70 7a 44 61 DataType ) *pzDa
1be20 74 61 54 79 70 65 20 3d 20 7a 44 61 74 61 54 79 taType = zDataTy
1be30 70 65 3b 0a 20 20 69 66 28 20 70 7a 43 6f 6c 6c pe;. if( pzColl
1be40 53 65 71 20 29 20 2a 70 7a 43 6f 6c 6c 53 65 71 Seq ) *pzCollSeq
1be50 20 3d 20 7a 43 6f 6c 6c 53 65 71 3b 0a 20 20 69 = zCollSeq;. i
1be60 66 28 20 70 4e 6f 74 4e 75 6c 6c 20 29 20 2a 70 f( pNotNull ) *p
1be70 4e 6f 74 4e 75 6c 6c 20 3d 20 6e 6f 74 6e 75 6c NotNull = notnul
1be80 6c 3b 0a 20 20 69 66 28 20 70 50 72 69 6d 61 72 l;. if( pPrimar
1be90 79 4b 65 79 20 29 20 2a 70 50 72 69 6d 61 72 79 yKey ) *pPrimary
1bea0 4b 65 79 20 3d 20 70 72 69 6d 61 72 79 6b 65 79 Key = primarykey
1beb0 3b 0a 20 20 69 66 28 20 70 41 75 74 6f 69 6e 63 ;. if( pAutoinc
1bec0 20 29 20 2a 70 41 75 74 6f 69 6e 63 20 3d 20 61 ) *pAutoinc = a
1bed0 75 74 6f 69 6e 63 3b 0a 0a 20 20 69 66 28 20 53 utoinc;.. if( S
1bee0 51 4c 49 54 45 5f 4f 4b 3d 3d 72 63 20 26 26 20 QLITE_OK==rc &&
1bef0 21 70 54 61 62 20 29 7b 0a 20 20 20 20 73 71 6c !pTab ){. sql
1bf00 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a ite3DbFree(db, z
1bf10 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 7a 45 72 ErrMsg);. zEr
1bf20 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 4d 50 rMsg = sqlite3MP
1bf30 72 69 6e 74 66 28 64 62 2c 20 22 6e 6f 20 73 75 rintf(db, "no su
1bf40 63 68 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 3a ch table column:
1bf50 20 25 73 2e 25 73 22 2c 20 7a 54 61 62 6c 65 4e %s.%s", zTableN
1bf60 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 7a 43 6f ame,. zCo
1bf70 6c 75 6d 6e 4e 61 6d 65 29 3b 0a 20 20 20 20 72 lumnName);. r
1bf80 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
1bf90 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 ;. }. sqlite3E
1bfa0 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 rrorWithMsg(db,
1bfb0 72 63 2c 20 28 7a 45 72 72 4d 73 67 3f 22 25 73 rc, (zErrMsg?"%s
1bfc0 22 3a 30 29 2c 20 7a 45 72 72 4d 73 67 29 3b 0a ":0), zErrMsg);.
1bfd0 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
1bfe0 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 db, zErrMsg);.
1bff0 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 rc = sqlite3ApiE
1c000 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 xit(db, rc);. s
1c010 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1c020 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
1c030 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1c040 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72 20 61 *.** Sleep for a
1c050 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e 20 20 little while.
1c060 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75 6e Return the amoun
1c070 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 70 74 2e t of time slept.
1c080 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
1c090 73 6c 65 65 70 28 69 6e 74 20 6d 73 29 7b 0a 20 sleep(int ms){.
1c0a0 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 sqlite3_vfs *pV
1c0b0 66 73 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 fs;. int rc;.
1c0c0 70 56 66 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 pVfs = sqlite3_v
1c0d0 66 73 5f 66 69 6e 64 28 30 29 3b 0a 20 20 69 66 fs_find(0);. if
1c0e0 28 20 70 56 66 73 3d 3d 30 20 29 20 72 65 74 75 ( pVfs==0 ) retu
1c0f0 72 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 rn 0;.. /* This
1c100 20 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 function works
1c110 69 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 2c in milliseconds,
1c120 20 62 75 74 20 74 68 65 20 75 6e 64 65 72 6c 79 but the underly
1c130 69 6e 67 20 4f 73 53 6c 65 65 70 28 29 20 0a 20 ing OsSleep() .
1c140 20 2a 2a 20 41 50 49 20 75 73 65 73 20 6d 69 63 ** API uses mic
1c150 72 6f 73 65 63 6f 6e 64 73 2e 20 48 65 6e 63 65 roseconds. Hence
1c160 20 74 68 65 20 31 30 30 30 27 73 2e 0a 20 20 2a the 1000's.. *
1c170 2f 0a 20 20 72 63 20 3d 20 28 73 71 6c 69 74 65 /. rc = (sqlite
1c180 33 4f 73 53 6c 65 65 70 28 70 56 66 73 2c 20 31 3OsSleep(pVfs, 1
1c190 30 30 30 2a 6d 73 29 2f 31 30 30 30 29 3b 0a 20 000*ms)/1000);.
1c1a0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1c1b0 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 *.** Enable or d
1c1c0 69 73 61 62 6c 65 20 74 68 65 20 65 78 74 65 6e isable the exten
1c1d0 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 73 ded result codes
1c1e0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1c1f0 5f 65 78 74 65 6e 64 65 64 5f 72 65 73 75 6c 74 _extended_result
1c200 5f 63 6f 64 65 73 28 73 71 6c 69 74 65 33 20 2a _codes(sqlite3 *
1c210 64 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 7b 0a db, int onoff){.
1c220 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
1c230 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
1c240 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
1c250 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
1c260 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
1c270 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
1c280 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
1c290 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
1c2a0 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 ex);. db->errMa
1c2b0 73 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 30 78 66 sk = onoff ? 0xf
1c2c0 66 66 66 66 66 66 66 20 3a 20 30 78 66 66 3b 0a fffffff : 0xff;.
1c2d0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1c2e0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
1c2f0 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
1c300 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 E_OK;.}../*.** I
1c310 6e 76 6f 6b 65 20 74 68 65 20 78 46 69 6c 65 43 nvoke the xFileC
1c320 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 6f 6e ontrol method on
1c330 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
1c340 74 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 tabase..*/.int s
1c350 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 qlite3_file_cont
1c360 72 6f 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c rol(sqlite3 *db,
1c370 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 const char *zDb
1c380 4e 61 6d 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f Name, int op, vo
1c390 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 69 6e 74 id *pArg){. int
1c3a0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
1c3b0 4f 52 3b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 OR;. Btree *pBt
1c3c0 72 65 65 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c ree;..#ifdef SQL
1c3d0 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
1c3e0 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
1c3f0 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
1c400 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 (db) ) return SQ
1c410 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
1c420 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 ;.#endif. sqlit
1c430 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1c440 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 42 74 b->mutex);. pBt
1c450 72 65 65 20 3d 20 73 71 6c 69 74 65 33 44 62 4e ree = sqlite3DbN
1c460 61 6d 65 54 6f 42 74 72 65 65 28 64 62 2c 20 7a ameToBtree(db, z
1c470 44 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 DbName);. if( p
1c480 42 74 72 65 65 20 29 7b 0a 20 20 20 20 50 61 67 Btree ){. Pag
1c490 65 72 20 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 er *pPager;.
1c4a0 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
1c4b0 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 ;. sqlite3Btr
1c4c0 65 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b eeEnter(pBtree);
1c4d0 0a 20 20 20 20 70 50 61 67 65 72 20 3d 20 73 71 . pPager = sq
1c4e0 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
1c4f0 70 42 74 72 65 65 29 3b 0a 20 20 20 20 61 73 73 pBtree);. ass
1c500 65 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 29 ert( pPager!=0 )
1c510 3b 0a 20 20 20 20 66 64 20 3d 20 73 71 6c 69 74 ;. fd = sqlit
1c520 65 33 50 61 67 65 72 46 69 6c 65 28 70 50 61 67 e3PagerFile(pPag
1c530 65 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 er);. assert(
1c540 20 66 64 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 fd!=0 );. if
1c550 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 46 43 4e ( op==SQLITE_FCN
1c560 54 4c 5f 46 49 4c 45 5f 50 4f 49 4e 54 45 52 20 TL_FILE_POINTER
1c570 29 7b 0a 20 20 20 20 20 20 2a 28 73 71 6c 69 74 ){. *(sqlit
1c580 65 33 5f 66 69 6c 65 2a 2a 29 70 41 72 67 20 3d e3_file**)pArg =
1c590 20 66 64 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 fd;. rc =
1c5a0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
1c5b0 65 6c 73 65 20 69 66 28 20 6f 70 3d 3d 53 51 4c else if( op==SQL
1c5c0 49 54 45 5f 46 43 4e 54 4c 5f 56 46 53 5f 50 4f ITE_FCNTL_VFS_PO
1c5d0 49 4e 54 45 52 20 29 7b 0a 20 20 20 20 20 20 2a INTER ){. *
1c5e0 28 73 71 6c 69 74 65 33 5f 76 66 73 2a 2a 29 70 (sqlite3_vfs**)p
1c5f0 41 72 67 20 3d 20 73 71 6c 69 74 65 33 50 61 67 Arg = sqlite3Pag
1c600 65 72 56 66 73 28 70 50 61 67 65 72 29 3b 0a 20 erVfs(pPager);.
1c610 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1c620 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 _OK;. }else i
1c630 66 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 46 43 f( op==SQLITE_FC
1c640 4e 54 4c 5f 4a 4f 55 52 4e 41 4c 5f 50 4f 49 4e NTL_JOURNAL_POIN
1c650 54 45 52 20 29 7b 0a 20 20 20 20 20 20 2a 28 73 TER ){. *(s
1c660 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2a 29 70 41 qlite3_file**)pA
1c670 72 67 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rg = sqlite3Page
1c680 72 4a 72 6e 6c 46 69 6c 65 28 70 50 61 67 65 72 rJrnlFile(pPager
1c690 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 );. rc = SQ
1c6a0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c LITE_OK;. }el
1c6b0 73 65 20 69 66 28 20 66 64 2d 3e 70 4d 65 74 68 se if( fd->pMeth
1c6c0 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 72 63 20 ods ){. rc
1c6d0 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 = sqlite3OsFileC
1c6e0 6f 6e 74 72 6f 6c 28 66 64 2c 20 6f 70 2c 20 70 ontrol(fd, op, p
1c6f0 41 72 67 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b Arg);. }else{
1c700 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
1c710 54 45 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 20 20 20 TE_NOTFOUND;.
1c720 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 }. sqlite3Bt
1c730 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 29 reeLeave(pBtree)
1c740 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
1c750 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
1c760 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
1c770 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e rc;.}../*.** In
1c780 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 74 terface to the t
1c790 65 73 74 69 6e 67 20 6c 6f 67 69 63 2e 0a 2a 2f esting logic..*/
1c7a0 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 65 73 .int sqlite3_tes
1c7b0 74 5f 63 6f 6e 74 72 6f 6c 28 69 6e 74 20 6f 70 t_control(int op
1c7c0 2c 20 2e 2e 2e 29 7b 0a 20 20 69 6e 74 20 72 63 , ...){. int rc
1c7d0 20 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51 4c = 0;.#ifdef SQL
1c7e0 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a 20 ITE_UNTESTABLE.
1c7f0 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
1c800 52 28 6f 70 29 3b 0a 23 65 6c 73 65 0a 20 20 76 R(op);.#else. v
1c810 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 76 61 5f a_list ap;. va_
1c820 73 74 61 72 74 28 61 70 2c 20 6f 70 29 3b 0a 20 start(ap, op);.
1c830 20 73 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 0a switch( op ){..
1c840 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 53 61 /*. ** Sa
1c850 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 ve the current s
1c860 74 61 74 65 20 6f 66 20 74 68 65 20 50 52 4e 47 tate of the PRNG
1c870 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1c880 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1c890 4c 5f 50 52 4e 47 5f 53 41 56 45 3a 20 7b 0a 20 L_PRNG_SAVE: {.
1c8a0 20 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 sqlite3Prng
1c8b0 53 61 76 65 53 74 61 74 65 28 29 3b 0a 20 20 20 SaveState();.
1c8c0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1c8d0 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 52 . /*. ** R
1c8e0 65 73 74 6f 72 65 20 74 68 65 20 73 74 61 74 65 estore the state
1c8f0 20 6f 66 20 74 68 65 20 50 52 4e 47 20 74 6f 20 of the PRNG to
1c900 74 68 65 20 6c 61 73 74 20 73 74 61 74 65 20 73 the last state s
1c910 61 76 65 64 20 75 73 69 6e 67 0a 20 20 20 20 2a aved using. *
1c920 2a 20 50 52 4e 47 5f 53 41 56 45 2e 20 20 49 66 * PRNG_SAVE. If
1c930 20 50 52 4e 47 5f 53 41 56 45 20 68 61 73 20 6e PRNG_SAVE has n
1c940 65 76 65 72 20 62 65 66 6f 72 65 20 62 65 65 6e ever before been
1c950 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 0a 20 20 called, then.
1c960 20 20 2a 2a 20 74 68 69 73 20 76 65 72 62 20 61 ** this verb a
1c970 63 74 73 20 6c 69 6b 65 20 50 52 4e 47 5f 52 45 cts like PRNG_RE
1c980 53 45 54 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 SET.. */.
1c990 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
1c9a0 43 54 52 4c 5f 50 52 4e 47 5f 52 45 53 54 4f 52 CTRL_PRNG_RESTOR
1c9b0 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 E: {. sqlit
1c9c0 65 33 50 72 6e 67 52 65 73 74 6f 72 65 53 74 61 e3PrngRestoreSta
1c9d0 74 65 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 te();. brea
1c9e0 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
1c9f0 0a 20 20 20 20 2a 2a 20 52 65 73 65 74 20 74 68 . ** Reset th
1ca00 65 20 50 52 4e 47 20 62 61 63 6b 20 74 6f 20 69 e PRNG back to i
1ca10 74 73 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 ts uninitialized
1ca20 20 73 74 61 74 65 2e 20 20 54 68 65 20 6e 65 78 state. The nex
1ca30 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f t call. ** to
1ca40 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e sqlite3_randomn
1ca50 65 73 73 28 29 20 77 69 6c 6c 20 72 65 73 65 65 ess() will resee
1ca60 64 20 74 68 65 20 50 52 4e 47 20 75 73 69 6e 67 d the PRNG using
1ca70 20 61 20 73 69 6e 67 6c 65 20 63 61 6c 6c 0a 20 a single call.
1ca80 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 78 52 61 ** to the xRa
1ca90 6e 64 6f 6d 6e 65 73 73 20 6d 65 74 68 6f 64 20 ndomness method
1caa0 6f 66 20 74 68 65 20 64 65 66 61 75 6c 74 20 56 of the default V
1cab0 46 53 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 FS.. */. c
1cac0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1cad0 54 52 4c 5f 50 52 4e 47 5f 52 45 53 45 54 3a 20 TRL_PRNG_RESET:
1cae0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f {. sqlite3_
1caf0 72 61 6e 64 6f 6d 6e 65 73 73 28 30 2c 30 29 3b randomness(0,0);
1cb00 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1cb10 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
1cb20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 ** sqlite3_test
1cb30 5f 63 6f 6e 74 72 6f 6c 28 42 49 54 56 45 43 5f _control(BITVEC_
1cb40 54 45 53 54 2c 20 73 69 7a 65 2c 20 70 72 6f 67 TEST, size, prog
1cb50 72 61 6d 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ram). **.
1cb60 2a 2a 20 52 75 6e 20 61 20 74 65 73 74 20 61 67 ** Run a test ag
1cb70 61 69 6e 73 74 20 61 20 42 69 74 76 65 63 20 6f ainst a Bitvec o
1cb80 62 6a 65 63 74 20 6f 66 20 73 69 7a 65 2e 20 20 bject of size.
1cb90 54 68 65 20 70 72 6f 67 72 61 6d 20 61 72 67 75 The program argu
1cba0 6d 65 6e 74 0a 20 20 20 20 2a 2a 20 69 73 20 61 ment. ** is a
1cbb0 6e 20 61 72 72 61 79 20 6f 66 20 69 6e 74 65 67 n array of integ
1cbc0 65 72 73 20 74 68 61 74 20 64 65 66 69 6e 65 73 ers that defines
1cbd0 20 74 68 65 20 74 65 73 74 2e 20 20 52 65 74 75 the test. Retu
1cbe0 72 6e 20 2d 31 20 6f 6e 20 61 0a 20 20 20 20 2a rn -1 on a. *
1cbf0 2a 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 * memory allocat
1cc00 69 6f 6e 20 65 72 72 6f 72 2c 20 30 20 6f 6e 20 ion error, 0 on
1cc10 73 75 63 63 65 73 73 2c 20 6f 72 20 6e 6f 6e 2d success, or non-
1cc20 7a 65 72 6f 20 66 6f 72 20 61 6e 20 65 72 72 6f zero for an erro
1cc30 72 2e 0a 20 20 20 20 2a 2a 20 53 65 65 20 74 68 r.. ** See th
1cc40 65 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 e sqlite3BitvecB
1cc50 75 69 6c 74 69 6e 54 65 73 74 28 29 20 66 6f 72 uiltinTest() for
1cc60 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f additional info
1cc70 72 6d 61 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a rmation.. */.
1cc80 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1cc90 54 45 53 54 43 54 52 4c 5f 42 49 54 56 45 43 5f TESTCTRL_BITVEC_
1cca0 54 45 53 54 3a 20 7b 0a 20 20 20 20 20 20 69 6e TEST: {. in
1ccb0 74 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 t sz = va_arg(ap
1ccc0 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 69 6e , int);. in
1ccd0 74 20 2a 61 50 72 6f 67 20 3d 20 76 61 5f 61 72 t *aProg = va_ar
1cce0 67 28 61 70 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 g(ap, int*);.
1ccf0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
1cd00 69 74 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 itvecBuiltinTest
1cd10 28 73 7a 2c 20 61 50 72 6f 67 29 3b 0a 20 20 20 (sz, aProg);.
1cd20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1cd30 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
1cd40 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
1cd50 74 72 6f 6c 28 46 41 55 4c 54 5f 49 4e 53 54 41 trol(FAULT_INSTA
1cd60 4c 4c 2c 20 78 43 61 6c 6c 62 61 63 6b 29 0a 20 LL, xCallback).
1cd70 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 72 72 **. ** Arr
1cd80 61 6e 67 65 20 74 6f 20 69 6e 76 6f 6b 65 20 78 ange to invoke x
1cd90 43 61 6c 6c 62 61 63 6b 28 29 20 77 68 65 6e 65 Callback() whene
1cda0 76 65 72 20 73 71 6c 69 74 65 33 46 61 75 6c 74 ver sqlite3Fault
1cdb0 53 69 6d 28 29 20 69 73 20 63 61 6c 6c 65 64 2c Sim() is called,
1cdc0 0a 20 20 20 20 2a 2a 20 69 66 20 78 43 61 6c 6c . ** if xCall
1cdd0 62 61 63 6b 20 69 73 20 6e 6f 74 20 4e 55 4c 4c back is not NULL
1cde0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1cdf0 41 73 20 61 20 74 65 73 74 20 6f 66 20 74 68 65 As a test of the
1ce00 20 66 61 75 6c 74 20 73 69 6d 75 6c 61 74 6f 72 fault simulator
1ce10 20 6d 65 63 68 61 6e 69 73 6d 20 69 74 73 65 6c mechanism itsel
1ce20 66 2c 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 f, sqlite3FaultS
1ce30 69 6d 28 30 29 0a 20 20 20 20 2a 2a 20 69 73 20 im(0). ** is
1ce40 63 61 6c 6c 65 64 20 69 6d 6d 65 64 69 61 74 65 called immediate
1ce50 6c 79 20 61 66 74 65 72 20 69 6e 73 74 61 6c 6c ly after install
1ce60 69 6e 67 20 74 68 65 20 6e 65 77 20 63 61 6c 6c ing the new call
1ce70 62 61 63 6b 20 61 6e 64 20 74 68 65 20 72 65 74 back and the ret
1ce80 75 72 6e 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 urn. ** value
1ce90 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 46 61 75 from sqlite3Fau
1cea0 6c 74 53 69 6d 28 30 29 20 62 65 63 6f 6d 65 73 ltSim(0) becomes
1ceb0 20 74 68 65 20 72 65 74 75 72 6e 20 66 72 6f 6d the return from
1cec0 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f . ** sqlite3_
1ced0 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 2e 0a test_control()..
1cee0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1cef0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1cf00 46 41 55 4c 54 5f 49 4e 53 54 41 4c 4c 3a 20 7b FAULT_INSTALL: {
1cf10 0a 20 20 20 20 20 20 2f 2a 20 4d 53 56 43 20 69 . /* MSVC i
1cf20 73 20 70 69 63 6b 79 20 61 62 6f 75 74 20 70 75 s picky about pu
1cf30 6c 6c 69 6e 67 20 66 75 6e 63 20 70 74 72 73 20 lling func ptrs
1cf40 66 72 6f 6d 20 76 61 20 6c 69 73 74 73 2e 0a 20 from va lists..
1cf50 20 20 20 20 20 2a 2a 20 68 74 74 70 3a 2f 2f 73 ** http://s
1cf60 75 70 70 6f 72 74 2e 6d 69 63 72 6f 73 6f 66 74 upport.microsoft
1cf70 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a 20 20 .com/kb/47961.
1cf80 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c ** sqlite3Gl
1cf90 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 54 65 73 74 obalConfig.xTest
1cfa0 43 61 6c 6c 62 61 63 6b 20 3d 20 76 61 5f 61 72 Callback = va_ar
1cfb0 67 28 61 70 2c 20 69 6e 74 28 2a 29 28 69 6e 74 g(ap, int(*)(int
1cfc0 29 29 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ));. */.
1cfd0 20 20 20 74 79 70 65 64 65 66 20 69 6e 74 28 2a typedef int(*
1cfe0 54 45 53 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 TESTCALLBACKFUNC
1cff0 5f 74 29 28 69 6e 74 29 3b 0a 20 20 20 20 20 20 _t)(int);.
1d000 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1d010 66 69 67 2e 78 54 65 73 74 43 61 6c 6c 62 61 63 fig.xTestCallbac
1d020 6b 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 54 k = va_arg(ap, T
1d030 45 53 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 5f ESTCALLBACKFUNC_
1d040 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 t);. rc = s
1d050 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d 28 30 qlite3FaultSim(0
1d060 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
1d070 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 }.. /*.
1d080 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 ** sqlite3_te
1d090 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 45 4e 49 47 st_control(BENIG
1d0a0 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 2c 20 N_MALLOC_HOOKS,
1d0b0 78 42 65 67 69 6e 2c 20 78 45 6e 64 29 0a 20 20 xBegin, xEnd).
1d0c0 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 65 67 69 **. ** Regi
1d0d0 73 74 65 72 20 68 6f 6f 6b 73 20 74 6f 20 63 61 ster hooks to ca
1d0e0 6c 6c 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 ll to indicate w
1d0f0 68 69 63 68 20 6d 61 6c 6c 6f 63 28 29 20 66 61 hich malloc() fa
1d100 69 6c 75 72 65 73 20 0a 20 20 20 20 2a 2a 20 61 ilures . ** a
1d110 72 65 20 62 65 6e 69 67 6e 2e 0a 20 20 20 20 2a re benign.. *
1d120 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
1d130 45 5f 54 45 53 54 43 54 52 4c 5f 42 45 4e 49 47 E_TESTCTRL_BENIG
1d140 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 3a 20 N_MALLOC_HOOKS:
1d150 7b 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 20 {. typedef
1d160 76 6f 69 64 20 28 2a 76 6f 69 64 5f 66 75 6e 63 void (*void_func
1d170 74 69 6f 6e 29 28 76 6f 69 64 29 3b 0a 20 20 20 tion)(void);.
1d180 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e void_function
1d190 20 78 42 65 6e 69 67 6e 42 65 67 69 6e 3b 0a 20 xBenignBegin;.
1d1a0 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 void_functi
1d1b0 6f 6e 20 78 42 65 6e 69 67 6e 45 6e 64 3b 0a 20 on xBenignEnd;.
1d1c0 20 20 20 20 20 78 42 65 6e 69 67 6e 42 65 67 69 xBenignBegi
1d1d0 6e 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 n = va_arg(ap, v
1d1e0 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 oid_function);.
1d1f0 20 20 20 20 20 78 42 65 6e 69 67 6e 45 6e 64 20 xBenignEnd
1d200 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
1d210 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 20 20 d_function);.
1d220 20 20 20 73 71 6c 69 74 65 33 42 65 6e 69 67 6e sqlite3Benign
1d230 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 78 42 65 6e MallocHooks(xBen
1d240 69 67 6e 42 65 67 69 6e 2c 20 78 42 65 6e 69 67 ignBegin, xBenig
1d250 6e 45 6e 64 29 3b 0a 20 20 20 20 20 20 62 72 65 nEnd);. bre
1d260 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1d270 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 *. ** sqlite
1d280 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1d290 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 QLITE_TESTCTRL_P
1d2a0 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 75 6e 73 ENDING_BYTE, uns
1d2b0 69 67 6e 65 64 20 69 6e 74 20 58 29 0a 20 20 20 igned int X).
1d2c0 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 **. ** Set t
1d2d0 68 65 20 50 45 4e 44 49 4e 47 20 62 79 74 65 20 he PENDING byte
1d2e0 74 6f 20 74 68 65 20 76 61 6c 75 65 20 69 6e 20 to the value in
1d2f0 74 68 65 20 61 72 67 75 6d 65 6e 74 2c 20 69 66 the argument, if
1d300 20 58 3e 30 2e 0a 20 20 20 20 2a 2a 20 4d 61 6b X>0.. ** Mak
1d310 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 20 e no changes if
1d320 58 3d 3d 30 2e 20 20 52 65 74 75 72 6e 20 74 68 X==0. Return th
1d330 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 e value of the p
1d340 65 6e 64 69 6e 67 20 62 79 74 65 0a 20 20 20 20 ending byte.
1d350 2a 2a 20 61 73 20 69 74 20 65 78 69 73 74 69 6e ** as it existin
1d360 67 20 62 65 66 6f 72 65 20 74 68 69 73 20 72 6f g before this ro
1d370 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 64 utine was called
1d380 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1d390 49 4d 50 4f 52 54 41 4e 54 3a 20 20 43 68 61 6e IMPORTANT: Chan
1d3a0 67 69 6e 67 20 74 68 65 20 50 45 4e 44 49 4e 47 ging the PENDING
1d3b0 20 62 79 74 65 20 66 72 6f 6d 20 30 78 34 30 30 byte from 0x400
1d3c0 30 30 30 30 30 20 72 65 73 75 6c 74 73 20 69 6e 00000 results in
1d3d0 0a 20 20 20 20 2a 2a 20 61 6e 20 69 6e 63 6f 6d . ** an incom
1d3e0 70 61 74 69 62 6c 65 20 64 61 74 61 62 61 73 65 patible database
1d3f0 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 20 43 file format. C
1d400 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 4e 44 hanging the PEND
1d410 49 4e 47 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 ING byte. **
1d420 77 68 69 6c 65 20 61 6e 79 20 64 61 74 61 62 61 while any databa
1d430 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 se connection is
1d440 20 6f 70 65 6e 20 72 65 73 75 6c 74 73 20 69 6e open results in
1d450 20 75 6e 64 65 66 69 6e 65 64 20 61 6e 64 0a 20 undefined and.
1d460 20 20 20 2a 2a 20 64 65 6c 65 74 65 72 69 6f 75 ** deleteriou
1d470 73 20 62 65 68 61 76 69 6f 72 2e 0a 20 20 20 20 s behavior..
1d480 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1d490 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 45 4e 44 TE_TESTCTRL_PEND
1d4a0 49 4e 47 5f 42 59 54 45 3a 20 7b 0a 20 20 20 20 ING_BYTE: {.
1d4b0 20 20 72 63 20 3d 20 50 45 4e 44 49 4e 47 5f 42 rc = PENDING_B
1d4c0 59 54 45 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c YTE;.#ifndef SQL
1d4d0 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 20 ITE_OMIT_WSD.
1d4e0 20 20 20 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 {. uns
1d4f0 69 67 6e 65 64 20 69 6e 74 20 6e 65 77 56 61 6c igned int newVal
1d500 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 75 6e = va_arg(ap, un
1d510 73 69 67 6e 65 64 20 69 6e 74 29 3b 0a 20 20 20 signed int);.
1d520 20 20 20 20 20 69 66 28 20 6e 65 77 56 61 6c 20 if( newVal
1d530 29 20 73 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 ) sqlite3Pending
1d540 42 79 74 65 20 3d 20 6e 65 77 56 61 6c 3b 0a 20 Byte = newVal;.
1d550 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
1d560 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1d570 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
1d580 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1d590 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1d5a0 54 43 54 52 4c 5f 41 53 53 45 52 54 2c 20 69 6e TCTRL_ASSERT, in
1d5b0 74 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t X). **.
1d5c0 2a 2a 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 ** This action p
1d5d0 72 6f 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 rovides a run-ti
1d5e0 6d 65 20 74 65 73 74 20 74 6f 20 73 65 65 20 77 me test to see w
1d5f0 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 0a 20 20 hether or not.
1d600 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 77 61 ** assert() wa
1d610 73 20 65 6e 61 62 6c 65 64 20 61 74 20 63 6f 6d s enabled at com
1d620 70 69 6c 65 2d 74 69 6d 65 2e 20 20 49 66 20 58 pile-time. If X
1d630 20 69 73 20 74 72 75 65 20 61 6e 64 20 61 73 73 is true and ass
1d640 65 72 74 28 29 0a 20 20 20 20 2a 2a 20 69 73 20 ert(). ** is
1d650 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 enabled, then th
1d660 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 e return value i
1d670 73 20 74 72 75 65 2e 20 20 49 66 20 58 20 69 73 s true. If X is
1d680 20 74 72 75 65 20 61 6e 64 0a 20 20 20 20 2a 2a true and. **
1d690 20 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 assert() is dis
1d6a0 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 abled, then the
1d6b0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1d6c0 7a 65 72 6f 2e 20 20 49 66 20 58 20 69 73 0a 20 zero. If X is.
1d6d0 20 20 20 2a 2a 20 66 61 6c 73 65 20 61 6e 64 20 ** false and
1d6e0 61 73 73 65 72 74 28 29 20 69 73 20 65 6e 61 62 assert() is enab
1d6f0 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 61 73 led, then the as
1d700 73 65 72 74 69 6f 6e 20 66 69 72 65 73 20 61 6e sertion fires an
1d710 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 72 6f d the. ** pro
1d720 63 65 73 73 20 61 62 6f 72 74 73 2e 20 20 49 66 cess aborts. If
1d730 20 58 20 69 73 20 66 61 6c 73 65 20 61 6e 64 20 X is false and
1d740 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 61 assert() is disa
1d750 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 20 bled, then the.
1d760 20 20 20 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c ** return val
1d770 75 65 20 69 73 20 7a 65 72 6f 2e 0a 20 20 20 20 ue is zero..
1d780 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1d790 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 TE_TESTCTRL_ASSE
1d7a0 52 54 3a 20 7b 0a 20 20 20 20 20 20 76 6f 6c 61 RT: {. vola
1d7b0 74 69 6c 65 20 69 6e 74 20 78 20 3d 20 30 3b 0a tile int x = 0;.
1d7c0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 2f 2a assert( /*
1d7d0 73 69 64 65 2d 65 66 66 65 63 74 73 2d 6f 6b 2a side-effects-ok*
1d7e0 2f 20 28 78 20 3d 20 76 61 5f 61 72 67 28 61 70 / (x = va_arg(ap
1d7f0 2c 69 6e 74 29 29 21 3d 30 20 29 3b 0a 20 20 20 ,int))!=0 );.
1d800 20 20 20 72 63 20 3d 20 78 3b 0a 20 20 20 20 20 rc = x;.
1d810 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 0a break;. }...
1d820 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
1d830 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1d840 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
1d850 54 52 4c 5f 41 4c 57 41 59 53 2c 20 69 6e 74 20 TRL_ALWAYS, int
1d860 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a X). **. **
1d870 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 72 6f This action pro
1d880 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 6d 65 vides a run-time
1d890 20 74 65 73 74 20 74 6f 20 73 65 65 20 68 6f 77 test to see how
1d8a0 20 74 68 65 20 41 4c 57 41 59 53 20 61 6e 64 0a the ALWAYS and.
1d8b0 20 20 20 20 2a 2a 20 4e 45 56 45 52 20 6d 61 63 ** NEVER mac
1d8c0 72 6f 73 20 77 65 72 65 20 64 65 66 69 6e 65 64 ros were defined
1d8d0 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 at compile-time
1d8e0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1d8f0 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 The return value
1d900 20 69 73 20 41 4c 57 41 59 53 28 58 29 2e 20 20 is ALWAYS(X).
1d910 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
1d920 68 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 he recommended t
1d930 65 73 74 20 69 73 20 58 3d 3d 32 2e 20 20 49 66 est is X==2. If
1d940 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 the return valu
1d950 65 20 69 73 20 32 2c 20 74 68 61 74 20 6d 65 61 e is 2, that mea
1d960 6e 73 0a 20 20 20 20 2a 2a 20 41 4c 57 41 59 53 ns. ** ALWAYS
1d970 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 20 61 () and NEVER() a
1d980 72 65 20 62 6f 74 68 20 6e 6f 2d 6f 70 20 70 61 re both no-op pa
1d990 73 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 6f ss-through macro
1d9a0 73 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 0a s, which is the.
1d9b0 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 20 73 ** default s
1d9c0 65 74 74 69 6e 67 2e 20 20 49 66 20 74 68 65 20 etting. If the
1d9d0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1d9e0 31 2c 20 74 68 65 6e 20 41 4c 57 41 59 53 28 29 1, then ALWAYS()
1d9f0 20 69 73 20 65 69 74 68 65 72 0a 20 20 20 20 2a is either. *
1da00 2a 20 68 61 72 64 2d 63 6f 64 65 64 20 74 6f 20 * hard-coded to
1da10 74 72 75 65 20 6f 72 20 65 6c 73 65 20 69 74 20 true or else it
1da20 61 73 73 65 72 74 73 20 69 66 20 69 74 73 20 61 asserts if its a
1da30 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c 73 65 rgument is false
1da40 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 69 72 .. ** The fir
1da50 73 74 20 62 65 68 61 76 69 6f 72 20 28 68 61 72 st behavior (har
1da60 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 65 29 d-coded to true)
1da70 20 69 73 20 74 68 65 20 63 61 73 65 20 69 66 0a is the case if.
1da80 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 54 45 ** SQLITE_TE
1da90 53 54 43 54 52 4c 5f 41 53 53 45 52 54 20 73 68 STCTRL_ASSERT sh
1daa0 6f 77 73 20 74 68 61 74 20 61 73 73 65 72 74 28 ows that assert(
1dab0 29 20 69 73 20 64 69 73 61 62 6c 65 64 20 61 6e ) is disabled an
1dac0 64 20 74 68 65 20 73 65 63 6f 6e 64 0a 20 20 20 d the second.
1dad0 20 2a 2a 20 62 65 68 61 76 69 6f 72 20 28 61 73 ** behavior (as
1dae0 73 65 72 74 20 69 66 20 74 68 65 20 61 72 67 75 sert if the argu
1daf0 6d 65 6e 74 20 74 6f 20 41 4c 57 41 59 53 28 29 ment to ALWAYS()
1db00 20 69 73 20 66 61 6c 73 65 29 20 69 73 20 74 68 is false) is th
1db10 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 2a 2a e case if. **
1db20 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1db30 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 74 68 _ASSERT shows th
1db40 61 74 20 61 73 73 65 72 74 28 29 20 69 73 20 65 at assert() is e
1db50 6e 61 62 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 nabled.. **.
1db60 20 20 20 2a 2a 20 54 68 65 20 72 75 6e 2d 74 69 ** The run-ti
1db70 6d 65 20 74 65 73 74 20 70 72 6f 63 65 64 75 72 me test procedur
1db80 65 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 73 6f 6d e might look som
1db90 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 ething like this
1dba0 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 :. **. **
1dbb0 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 74 if( sqlite3_t
1dbc0 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1dbd0 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c 57 41 TE_TESTCTRL_ALWA
1dbe0 59 53 2c 20 32 29 3d 3d 32 20 29 7b 0a 20 20 20 YS, 2)==2 ){.
1dbf0 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c 57 41 ** // ALWA
1dc00 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 YS() and NEVER()
1dc10 20 61 72 65 20 6e 6f 2d 6f 70 20 70 61 73 73 2d are no-op pass-
1dc20 74 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 0a 20 through macros.
1dc30 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 20 69 ** }else i
1dc40 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f f( sqlite3_test_
1dc50 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1dc60 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 2c 20 ESTCTRL_ASSERT,
1dc70 31 29 20 29 7b 0a 20 20 20 20 2a 2a 20 20 20 20 1) ){. **
1dc80 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 61 // ALWAYS(x) a
1dc90 73 73 65 72 74 73 20 74 68 61 74 20 78 20 69 73 sserts that x is
1dca0 20 74 72 75 65 2e 20 4e 45 56 45 52 28 78 29 20 true. NEVER(x)
1dcb0 61 73 73 65 72 74 73 20 78 20 69 73 20 66 61 6c asserts x is fal
1dcc0 73 65 2e 0a 20 20 20 20 2a 2a 20 20 20 20 7d 65 se.. ** }e
1dcd0 6c 73 65 7b 0a 20 20 20 20 2a 2a 20 20 20 20 20 lse{. **
1dce0 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 69 73 // ALWAYS(x) is
1dcf0 20 61 20 63 6f 6e 73 74 61 6e 74 20 31 2e 20 20 a constant 1.
1dd00 4e 45 56 45 52 28 78 29 20 69 73 20 61 20 63 6f NEVER(x) is a co
1dd10 6e 73 74 61 6e 74 20 30 2e 0a 20 20 20 20 2a 2a nstant 0.. **
1dd20 20 20 20 20 7d 0a 20 20 20 20 2a 2f 0a 20 20 20 }. */.
1dd30 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1dd40 54 43 54 52 4c 5f 41 4c 57 41 59 53 3a 20 7b 0a TCTRL_ALWAYS: {.
1dd50 20 20 20 20 20 20 69 6e 74 20 78 20 3d 20 76 61 int x = va
1dd60 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 _arg(ap,int);.
1dd70 20 20 20 20 72 63 20 3d 20 41 4c 57 41 59 53 28 rc = ALWAYS(
1dd80 78 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b x);. break;
1dd90 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 . }.. /*.
1dda0 20 20 20 2a 2a 20 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
1ddb0 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1ddc0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 59 54 ITE_TESTCTRL_BYT
1ddd0 45 4f 52 44 45 52 29 3b 0a 20 20 20 20 2a 2a 0a EORDER);. **.
1dde0 20 20 20 20 2a 2a 20 54 68 65 20 69 6e 74 65 67 ** The integ
1ddf0 65 72 20 72 65 74 75 72 6e 65 64 20 72 65 76 65 er returned reve
1de00 61 6c 73 20 74 68 65 20 62 79 74 65 2d 6f 72 64 als the byte-ord
1de10 65 72 20 6f 66 20 74 68 65 20 63 6f 6d 70 75 74 er of the comput
1de20 65 72 20 6f 6e 20 77 68 69 63 68 0a 20 20 20 20 er on which.
1de30 2a 2a 20 53 51 4c 69 74 65 20 69 73 20 72 75 6e ** SQLite is run
1de40 6e 69 6e 67 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 ning:. **.
1de50 20 2a 2a 20 20 20 20 20 20 20 31 20 20 20 20 20 ** 1
1de60 62 69 67 2d 65 6e 64 69 61 6e 2c 20 20 20 20 64 big-endian, d
1de70 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 75 6e etermined at run
1de80 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 20 20 -time. **
1de90 20 20 31 30 20 20 20 20 20 6c 69 74 74 6c 65 2d 10 little-
1dea0 65 6e 64 69 61 6e 2c 20 64 65 74 65 72 6d 69 6e endian, determin
1deb0 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 ed at run-time.
1dec0 20 20 20 2a 2a 20 20 34 33 32 31 30 31 20 20 20 ** 432101
1ded0 20 20 62 69 67 2d 65 6e 64 69 61 6e 2c 20 20 20 big-endian,
1dee0 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 63 determined at c
1def0 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 20 20 ompile-time.
1df00 2a 2a 20 20 31 32 33 34 31 30 20 20 20 20 20 6c ** 123410 l
1df10 69 74 74 6c 65 2d 65 6e 64 69 61 6e 2c 20 64 65 ittle-endian, de
1df20 74 65 72 6d 69 6e 65 64 20 61 74 20 63 6f 6d 70 termined at comp
1df30 69 6c 65 2d 74 69 6d 65 0a 20 20 20 20 2a 2f 20 ile-time. */
1df40 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1df50 5f 54 45 53 54 43 54 52 4c 5f 42 59 54 45 4f 52 _TESTCTRL_BYTEOR
1df60 44 45 52 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 DER: {. rc
1df70 3d 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 = SQLITE_BYTEORD
1df80 45 52 2a 31 30 30 20 2b 20 53 51 4c 49 54 45 5f ER*100 + SQLITE_
1df90 4c 49 54 54 4c 45 45 4e 44 49 41 4e 2a 31 30 20 LITTLEENDIAN*10
1dfa0 2b 20 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 + SQLITE_BIGENDI
1dfb0 41 4e 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b AN;. break;
1dfc0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 . }.. /*
1dfd0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1dfe0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1dff0 54 43 54 52 4c 5f 52 45 53 45 52 56 45 2c 20 73 TCTRL_RESERVE, s
1e000 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
1e010 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a N). **. **
1e020 20 53 65 74 20 74 68 65 20 6e 52 65 73 65 72 76 Set the nReserv
1e030 65 20 73 69 7a 65 20 74 6f 20 4e 20 66 6f 72 20 e size to N for
1e040 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 the main databas
1e050 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 e on the databas
1e060 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 63 74 e. ** connect
1e070 69 6f 6e 20 64 62 2e 0a 20 20 20 20 2a 2f 0a 20 ion db.. */.
1e080 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
1e090 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 3a ESTCTRL_RESERVE:
1e0a0 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
1e0b0 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 70 *db = va_arg(ap
1e0c0 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 , sqlite3*);.
1e0d0 20 20 20 69 6e 74 20 78 20 3d 20 76 61 5f 61 72 int x = va_ar
1e0e0 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 20 20 g(ap,int);.
1e0f0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
1e100 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
1e110 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 . sqlite3Bt
1e120 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 28 64 reeSetPageSize(d
1e130 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c 20 30 b->aDb[0].pBt, 0
1e140 2c 20 78 2c 20 30 29 3b 0a 20 20 20 20 20 20 73 , x, 0);. s
1e150 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1e160 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
1e170 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1e180 7d 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c 69 74 }.. /* sqlit
1e190 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1e1a0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1e1b0 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c 20 73 OPTIMIZATIONS, s
1e1c0 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
1e1d0 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a N). **. **
1e1e0 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 Enable or disab
1e1f0 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d le various optim
1e200 69 7a 61 74 69 6f 6e 73 20 66 6f 72 20 74 65 73 izations for tes
1e210 74 69 6e 67 20 70 75 72 70 6f 73 65 73 2e 20 20 ting purposes.
1e220 54 68 65 20 0a 20 20 20 20 2a 2a 20 61 72 67 75 The . ** argu
1e230 6d 65 6e 74 20 4e 20 69 73 20 61 20 62 69 74 6d ment N is a bitm
1e240 61 73 6b 20 6f 66 20 6f 70 74 69 6d 69 7a 61 74 ask of optimizat
1e250 69 6f 6e 73 20 74 6f 20 62 65 20 64 69 73 61 62 ions to be disab
1e260 6c 65 64 2e 20 20 46 6f 72 20 6e 6f 72 6d 61 6c led. For normal
1e270 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f . ** operatio
1e280 6e 20 4e 20 73 68 6f 75 6c 64 20 62 65 20 30 2e n N should be 0.
1e290 20 20 54 68 65 20 69 64 65 61 20 69 73 20 74 68 The idea is th
1e2a0 61 74 20 61 20 74 65 73 74 20 70 72 6f 67 72 61 at a test progra
1e2b0 6d 20 28 6c 69 6b 65 20 74 68 65 0a 20 20 20 20 m (like the.
1e2c0 2a 2a 20 53 51 4c 20 4c 6f 67 69 63 20 54 65 73 ** SQL Logic Tes
1e2d0 74 20 6f 72 20 53 4c 54 20 74 65 73 74 20 6d 6f t or SLT test mo
1e2e0 64 75 6c 65 29 20 63 61 6e 20 72 75 6e 20 74 68 dule) can run th
1e2f0 65 20 73 61 6d 65 20 53 51 4c 20 6d 75 6c 74 69 e same SQL multi
1e300 70 6c 65 20 74 69 6d 65 73 0a 20 20 20 20 2a 2a ple times. **
1e310 20 77 69 74 68 20 76 61 72 69 6f 75 73 20 6f 70 with various op
1e320 74 69 6d 69 7a 61 74 69 6f 6e 73 20 64 69 73 61 timizations disa
1e330 62 6c 65 64 20 74 6f 20 76 65 72 69 66 79 20 74 bled to verify t
1e340 68 61 74 20 74 68 65 20 73 61 6d 65 20 61 6e 73 hat the same ans
1e350 77 65 72 0a 20 20 20 20 2a 2a 20 69 73 20 6f 62 wer. ** is ob
1e360 74 61 69 6e 65 64 20 69 6e 20 65 76 65 72 79 20 tained in every
1e370 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 case.. */.
1e380 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1e390 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 TCTRL_OPTIMIZATI
1e3a0 4f 4e 53 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c ONS: {. sql
1e3b0 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 ite3 *db = va_ar
1e3c0 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b g(ap, sqlite3*);
1e3d0 0a 20 20 20 20 20 20 64 62 2d 3e 64 62 4f 70 74 . db->dbOpt
1e3e0 46 6c 61 67 73 20 3d 20 28 75 31 36 29 28 76 61 Flags = (u16)(va
1e3f0 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 20 26 20 _arg(ap, int) &
1e400 30 78 66 66 66 66 29 3b 0a 20 20 20 20 20 20 62 0xffff);. b
1e410 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 reak;. }..#if
1e420 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 def SQLITE_N_KEY
1e430 57 4f 52 44 0a 20 20 20 20 2f 2a 20 73 71 6c 69 WORD. /* sqli
1e440 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1e450 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1e460 5f 49 53 4b 45 59 57 4f 52 44 2c 20 63 6f 6e 73 _ISKEYWORD, cons
1e470 74 20 63 68 61 72 20 2a 7a 57 6f 72 64 29 0a 20 t char *zWord).
1e480 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 **. ** If
1e490 7a 57 6f 72 64 20 69 73 20 61 20 6b 65 79 77 6f zWord is a keywo
1e4a0 72 64 20 72 65 63 6f 67 6e 69 7a 65 64 20 62 79 rd recognized by
1e4b0 20 74 68 65 20 70 61 72 73 65 72 2c 20 74 68 65 the parser, the
1e4c0 6e 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 20 n return the.
1e4d0 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 6b 65 ** number of ke
1e4e0 79 77 6f 72 64 73 2e 20 20 4f 72 20 69 66 20 7a ywords. Or if z
1e4f0 57 6f 72 64 20 69 73 20 6e 6f 74 20 61 20 6b 65 Word is not a ke
1e500 79 77 6f 72 64 2c 20 72 65 74 75 72 6e 20 30 2e yword, return 0.
1e510 0a 20 20 20 20 2a 2a 20 0a 20 20 20 20 2a 2a 20 . ** . **
1e520 54 68 69 73 20 74 65 73 74 20 66 65 61 74 75 72 This test featur
1e530 65 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 e is only availa
1e540 62 6c 65 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 ble in the amalg
1e550 61 6d 61 74 69 6f 6e 20 73 69 6e 63 65 0a 20 20 amation since.
1e560 20 20 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f ** the SQLITE_
1e570 4e 5f 4b 45 59 57 4f 52 44 20 6d 61 63 72 6f 20 N_KEYWORD macro
1e580 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 69 is not defined i
1e590 6e 20 74 68 69 73 20 66 69 6c 65 20 69 66 20 53 n this file if S
1e5a0 51 4c 69 74 65 0a 20 20 20 20 2a 2a 20 69 73 20 QLite. ** is
1e5b0 62 75 69 6c 74 20 75 73 69 6e 67 20 73 65 70 61 built using sepa
1e5c0 72 61 74 65 20 73 6f 75 72 63 65 20 66 69 6c 65 rate source file
1e5d0 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
1e5e0 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1e5f0 52 4c 5f 49 53 4b 45 59 57 4f 52 44 3a 20 7b 0a RL_ISKEYWORD: {.
1e600 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 const char
1e610 20 2a 7a 57 6f 72 64 20 3d 20 76 61 5f 61 72 67 *zWord = va_arg
1e620 28 61 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a (ap, const char*
1e630 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 3d );. int n =
1e640 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
1e650 28 7a 57 6f 72 64 29 3b 0a 20 20 20 20 20 20 72 (zWord);. r
1e660 63 20 3d 20 28 73 71 6c 69 74 65 33 4b 65 79 77 c = (sqlite3Keyw
1e670 6f 72 64 43 6f 64 65 28 28 75 38 2a 29 7a 57 6f ordCode((u8*)zWo
1e680 72 64 2c 20 6e 29 21 3d 54 4b 5f 49 44 29 20 3f rd, n)!=TK_ID) ?
1e690 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 SQLITE_N_KEYWOR
1e6a0 44 20 3a 20 30 3b 0a 20 20 20 20 20 20 62 72 65 D : 0;. bre
1e6b0 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 ak;. }.#endif
1e6c0 20 0a 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 .. /* sqlite
1e6d0 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1e6e0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 53 QLITE_TESTCTRL_S
1e6f0 43 52 41 54 43 48 4d 41 4c 4c 4f 43 2c 20 73 7a CRATCHMALLOC, sz
1e700 2c 20 26 70 4e 65 77 2c 20 70 46 72 65 65 29 3b , &pNew, pFree);
1e710 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 50 . **. ** P
1e720 61 73 73 20 70 46 72 65 65 20 69 6e 74 6f 20 73 ass pFree into s
1e730 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 65 qlite3ScratchFre
1e740 65 28 29 2e 20 0a 20 20 20 20 2a 2a 20 49 66 20 e(). . ** If
1e750 73 7a 3e 30 20 74 68 65 6e 20 61 6c 6c 6f 63 61 sz>0 then alloca
1e760 74 65 20 61 20 73 63 72 61 74 63 68 20 62 75 66 te a scratch buf
1e770 66 65 72 20 69 6e 74 6f 20 70 4e 65 77 2e 20 20 fer into pNew.
1e780 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
1e790 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1e7a0 5f 53 43 52 41 54 43 48 4d 41 4c 4c 4f 43 3a 20 _SCRATCHMALLOC:
1e7b0 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 2a 70 46 {. void *pF
1e7c0 72 65 65 2c 20 2a 2a 70 70 4e 65 77 3b 0a 20 20 ree, **ppNew;.
1e7d0 20 20 20 20 69 6e 74 20 73 7a 3b 0a 20 20 20 20 int sz;.
1e7e0 20 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 sz = va_arg(ap
1e7f0 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 70 70 , int);. pp
1e800 4e 65 77 20 3d 20 76 61 5f 61 72 67 28 61 70 2c New = va_arg(ap,
1e810 20 76 6f 69 64 2a 2a 29 3b 0a 20 20 20 20 20 20 void**);.
1e820 70 46 72 65 65 20 3d 20 76 61 5f 61 72 67 28 61 pFree = va_arg(a
1e830 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 p, void*);.
1e840 20 69 66 28 20 73 7a 20 29 20 2a 70 70 4e 65 77 if( sz ) *ppNew
1e850 20 3d 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 = sqlite3Scratc
1e860 68 4d 61 6c 6c 6f 63 28 73 7a 29 3b 0a 20 20 20 hMalloc(sz);.
1e870 20 20 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 sqlite3Scratc
1e880 68 46 72 65 65 28 70 46 72 65 65 29 3b 0a 20 20 hFree(pFree);.
1e890 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1e8a0 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1e8b0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1e8c0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1e8d0 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 55 4c 54 2c LOCALTIME_FAULT,
1e8e0 20 69 6e 74 20 6f 6e 6f 66 66 29 3b 0a 20 20 20 int onoff);.
1e8f0 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 70 61 **. ** If pa
1e900 72 61 6d 65 74 65 72 20 6f 6e 6f 66 66 20 69 73 rameter onoff is
1e910 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 63 6f 6e 66 69 non-zero, confi
1e920 67 75 72 65 20 74 68 65 20 77 72 61 70 70 65 72 gure the wrapper
1e930 73 20 73 6f 20 74 68 61 74 20 61 6c 6c 0a 20 20 s so that all.
1e940 20 20 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20 ** subsequent
1e950 63 61 6c 6c 73 20 74 6f 20 6c 6f 63 61 6c 74 69 calls to localti
1e960 6d 65 28 29 20 61 6e 64 20 76 61 72 69 61 6e 74 me() and variant
1e970 73 20 66 61 69 6c 2e 20 49 66 20 6f 6e 6f 66 66 s fail. If onoff
1e980 20 69 73 20 7a 65 72 6f 2c 0a 20 20 20 20 2a 2a is zero,. **
1e990 20 75 6e 64 6f 20 74 68 69 73 20 73 65 74 74 69 undo this setti
1e9a0 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 ng.. */. c
1e9b0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1e9c0 54 52 4c 5f 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 TRL_LOCALTIME_FA
1e9d0 55 4c 54 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c ULT: {. sql
1e9e0 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1e9f0 2e 62 4c 6f 63 61 6c 74 69 6d 65 46 61 75 6c 74 .bLocaltimeFault
1ea00 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
1ea10 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
1ea20 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 . }.. /*
1ea30 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1ea40 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1ea50 54 43 54 52 4c 5f 4e 45 56 45 52 5f 43 4f 52 52 TCTRL_NEVER_CORR
1ea60 55 50 54 2c 20 69 6e 74 29 3b 0a 20 20 20 20 2a UPT, int);. *
1ea70 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 6f 72 20 *. ** Set or
1ea80 63 6c 65 61 72 20 61 20 66 6c 61 67 20 74 68 61 clear a flag tha
1ea90 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 t indicates that
1eaa0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1eab0 6c 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 6c le is always wel
1eac0 6c 2d 0a 20 20 20 20 2a 2a 20 66 6f 72 6d 65 64 l-. ** formed
1ead0 20 61 6e 64 20 6e 65 76 65 72 20 63 6f 72 72 75 and never corru
1eae0 70 74 2e 20 20 54 68 69 73 20 66 6c 61 67 20 69 pt. This flag i
1eaf0 73 20 63 6c 65 61 72 20 62 79 20 64 65 66 61 75 s clear by defau
1eb00 6c 74 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 74 lt, indicating t
1eb10 68 61 74 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 hat. ** datab
1eb20 61 73 65 20 66 69 6c 65 73 20 6d 69 67 68 74 20 ase files might
1eb30 68 61 76 65 20 61 72 62 69 74 72 61 72 79 20 63 have arbitrary c
1eb40 6f 72 72 75 70 74 69 6f 6e 2e 20 20 53 65 74 74 orruption. Sett
1eb50 69 6e 67 20 74 68 65 20 66 6c 61 67 20 64 75 72 ing the flag dur
1eb60 69 6e 67 0a 20 20 20 20 2a 2a 20 74 65 73 74 69 ing. ** testi
1eb70 6e 67 20 63 61 75 73 65 73 20 63 65 72 74 61 69 ng causes certai
1eb80 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
1eb90 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 64 ments in the cod
1eba0 65 20 74 6f 20 62 65 20 61 63 74 69 76 61 74 65 e to be activate
1ebb0 64 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 64 65 d. ** that de
1ebc0 6d 6f 6e 73 74 72 61 74 20 69 6e 76 61 72 69 61 monstrat invaria
1ebd0 6e 74 73 20 6f 6e 20 77 65 6c 6c 2d 66 6f 72 6d nts on well-form
1ebe0 65 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ed database file
1ebf0 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
1ec00 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1ec10 52 4c 5f 4e 45 56 45 52 5f 43 4f 52 52 55 50 54 RL_NEVER_CORRUPT
1ec20 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
1ec30 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 65 3GlobalConfig.ne
1ec40 76 65 72 43 6f 72 72 75 70 74 20 3d 20 76 61 5f verCorrupt = va_
1ec50 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
1ec60 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1ec70 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 68 65 .. /* Set the
1ec80 20 74 68 72 65 73 68 6f 6c 64 20 61 74 20 77 68 threshold at wh
1ec90 69 63 68 20 4f 50 5f 4f 6e 63 65 20 63 6f 75 6e ich OP_Once coun
1eca0 74 65 72 73 20 72 65 73 65 74 20 62 61 63 6b 20 ters reset back
1ecb0 74 6f 20 7a 65 72 6f 2e 0a 20 20 20 20 2a 2a 20 to zero.. **
1ecc0 42 79 20 64 65 66 61 75 6c 74 20 74 68 69 73 20 By default this
1ecd0 69 73 20 30 78 37 66 66 66 66 66 66 65 20 28 6f is 0x7ffffffe (o
1ece0 76 65 72 20 32 20 62 69 6c 6c 69 6f 6e 29 2c 20 ver 2 billion),
1ecf0 62 75 74 20 74 68 61 74 20 76 61 6c 75 65 20 69 but that value i
1ed00 73 0a 20 20 20 20 2a 2a 20 74 6f 6f 20 62 69 67 s. ** too big
1ed10 20 74 6f 20 74 65 73 74 20 69 6e 20 61 20 72 65 to test in a re
1ed20 61 73 6f 6e 61 62 6c 65 20 61 6d 6f 75 6e 74 20 asonable amount
1ed30 6f 66 20 74 69 6d 65 2c 20 73 6f 20 74 68 69 73 of time, so this
1ed40 20 63 6f 6e 74 72 6f 6c 20 69 73 0a 20 20 20 20 control is.
1ed50 2a 2a 20 70 72 6f 76 69 64 65 64 20 74 6f 20 73 ** provided to s
1ed60 65 74 20 61 20 73 6d 61 6c 6c 20 61 6e 64 20 65 et a small and e
1ed70 61 73 69 6c 79 20 72 65 61 63 68 61 62 6c 65 20 asily reachable
1ed80 72 65 73 65 74 20 76 61 6c 75 65 2e 0a 20 20 20 reset value..
1ed90 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1eda0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4f 4e 43 ITE_TESTCTRL_ONC
1edb0 45 5f 52 45 53 45 54 5f 54 48 52 45 53 48 4f 4c E_RESET_THRESHOL
1edc0 44 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 D: {. sqlit
1edd0 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1ede0 4f 6e 63 65 52 65 73 65 74 54 68 72 65 73 68 6f OnceResetThresho
1edf0 6c 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ld = va_arg(ap,
1ee00 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 int);. brea
1ee10 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
1ee20 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f sqlite3_test_
1ee30 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1ee40 45 53 54 43 54 52 4c 5f 56 44 42 45 5f 43 4f 56 ESTCTRL_VDBE_COV
1ee50 45 52 41 47 45 2c 20 78 43 61 6c 6c 62 61 63 6b ERAGE, xCallback
1ee60 2c 20 70 74 72 29 3b 0a 20 20 20 20 2a 2a 0a 20 , ptr);. **.
1ee70 20 20 20 2a 2a 20 53 65 74 20 74 68 65 20 56 44 ** Set the VD
1ee80 42 45 20 63 6f 76 65 72 61 67 65 20 63 61 6c 6c BE coverage call
1ee90 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 74 6f back function to
1eea0 20 78 43 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 xCallback with
1eeb0 63 6f 6e 74 65 78 74 20 0a 20 20 20 20 2a 2a 20 context . **
1eec0 70 6f 69 6e 74 65 72 20 70 74 72 2e 0a 20 20 20 pointer ptr..
1eed0 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1eee0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 56 44 42 ITE_TESTCTRL_VDB
1eef0 45 5f 43 4f 56 45 52 41 47 45 3a 20 7b 0a 23 69 E_COVERAGE: {.#i
1ef00 66 64 65 66 20 53 51 4c 49 54 45 5f 56 44 42 45 fdef SQLITE_VDBE
1ef10 5f 43 4f 56 45 52 41 47 45 0a 20 20 20 20 20 20 _COVERAGE.
1ef20 74 79 70 65 64 65 66 20 76 6f 69 64 20 28 2a 62 typedef void (*b
1ef30 72 61 6e 63 68 5f 63 61 6c 6c 62 61 63 6b 29 28 ranch_callback)(
1ef40 76 6f 69 64 2a 2c 69 6e 74 2c 75 38 2c 75 38 29 void*,int,u8,u8)
1ef50 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
1ef60 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 56 64 62 lobalConfig.xVdb
1ef70 65 42 72 61 6e 63 68 20 3d 20 76 61 5f 61 72 67 eBranch = va_arg
1ef80 28 61 70 2c 62 72 61 6e 63 68 5f 63 61 6c 6c 62 (ap,branch_callb
1ef90 61 63 6b 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 ack);. sqli
1efa0 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1efb0 70 56 64 62 65 42 72 61 6e 63 68 41 72 67 20 3d pVdbeBranchArg =
1efc0 20 76 61 5f 61 72 67 28 61 70 2c 76 6f 69 64 2a va_arg(ap,void*
1efd0 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 );.#endif.
1efe0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1eff0 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 /* sqlite3_t
1f000 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1f010 54 45 5f 54 45 53 54 43 54 52 4c 5f 53 4f 52 54 TE_TESTCTRL_SORT
1f020 45 52 5f 4d 4d 41 50 2c 20 64 62 2c 20 6e 4d 61 ER_MMAP, db, nMa
1f030 78 29 3b 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 x); */. case
1f040 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1f050 53 4f 52 54 45 52 5f 4d 4d 41 50 3a 20 7b 0a 20 SORTER_MMAP: {.
1f060 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 sqlite3 *db
1f070 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 73 71 = va_arg(ap, sq
1f080 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 20 20 64 lite3*);. d
1f090 62 2d 3e 6e 4d 61 78 53 6f 72 74 65 72 4d 6d 61 b->nMaxSorterMma
1f0a0 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 p = va_arg(ap, i
1f0b0 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nt);. break
1f0c0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
1f0d0 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 sqlite3_test_c
1f0e0 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 ontrol(SQLITE_TE
1f0f0 53 54 43 54 52 4c 5f 49 53 49 4e 49 54 29 3b 0a STCTRL_ISINIT);.
1f100 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 65 **. ** Re
1f110 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 turn SQLITE_OK i
1f120 66 20 53 51 4c 69 74 65 20 68 61 73 20 62 65 65 f SQLite has bee
1f130 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 61 6e n initialized an
1f140 64 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 d SQLITE_ERROR i
1f150 66 0a 20 20 20 20 2a 2a 20 6e 6f 74 2e 0a 20 20 f. ** not..
1f160 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
1f170 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 LITE_TESTCTRL_IS
1f180 49 4e 49 54 3a 20 7b 0a 20 20 20 20 20 20 69 66 INIT: {. if
1f190 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
1f1a0 6f 6e 66 69 67 2e 69 73 49 6e 69 74 3d 3d 30 20 onfig.isInit==0
1f1b0 29 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 ) rc = SQLITE_ER
1f1c0 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 65 61 6b ROR;. break
1f1d0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
1f1e0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1f1f0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1f200 54 43 54 52 4c 5f 49 4d 50 4f 53 54 45 52 2c 20 TCTRL_IMPOSTER,
1f210 64 62 2c 20 64 62 4e 61 6d 65 2c 20 6f 6e 4f 66 db, dbName, onOf
1f220 66 2c 20 74 6e 75 6d 29 3b 0a 20 20 20 20 2a 2a f, tnum);. **
1f230 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 74 65 73 . ** This tes
1f240 74 20 63 6f 6e 74 72 6f 6c 20 69 73 20 75 73 65 t control is use
1f250 64 20 74 6f 20 63 72 65 61 74 65 20 69 6d 70 6f d to create impo
1f260 73 74 65 72 20 74 61 62 6c 65 73 2e 20 20 22 64 ster tables. "d
1f270 62 22 20 69 73 20 61 20 70 6f 69 6e 74 65 72 0a b" is a pointer.
1f280 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 64 61 ** to the da
1f290 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1f2a0 6e 2e 20 20 64 62 4e 61 6d 65 20 69 73 20 74 68 n. dbName is th
1f2b0 65 20 64 61 74 61 62 61 73 65 20 6e 61 6d 65 20 e database name
1f2c0 28 65 78 3a 20 22 6d 61 69 6e 22 20 6f 72 0a 20 (ex: "main" or.
1f2d0 20 20 20 2a 2a 20 22 74 65 6d 70 22 29 20 77 68 ** "temp") wh
1f2e0 69 63 68 20 77 69 6c 6c 20 72 65 63 65 69 76 65 ich will receive
1f2f0 20 74 68 65 20 69 6d 70 6f 73 74 65 72 2e 20 20 the imposter.
1f300 22 6f 6e 4f 66 66 22 20 74 75 72 6e 73 20 69 6d "onOff" turns im
1f310 70 6f 73 74 65 72 20 6d 6f 64 65 20 6f 6e 0a 20 poster mode on.
1f320 20 20 20 2a 2a 20 6f 72 20 6f 66 66 2e 20 20 22 ** or off. "
1f330 74 6e 75 6d 22 20 69 73 20 74 68 65 20 72 6f 6f tnum" is the roo
1f340 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 62 2d t page of the b-
1f350 74 72 65 65 20 74 6f 20 77 68 69 63 68 20 74 68 tree to which th
1f360 65 20 69 6d 70 6f 73 74 65 72 0a 20 20 20 20 2a e imposter. *
1f370 2a 20 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 63 * table should c
1f380 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 2a 2a 0a 20 onnect.. **.
1f390 20 20 20 2a 2a 20 45 6e 61 62 6c 65 20 69 6d 70 ** Enable imp
1f3a0 6f 73 74 65 72 20 6d 6f 64 65 20 6f 6e 6c 79 20 oster mode only
1f3b0 77 68 65 6e 20 74 68 65 20 73 63 68 65 6d 61 20 when the schema
1f3c0 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
1f3d0 20 70 61 72 73 65 64 2e 20 20 54 68 65 6e 0a 20 parsed. Then.
1f3e0 20 20 20 2a 2a 20 72 75 6e 20 61 20 73 69 6e 67 ** run a sing
1f3f0 6c 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 le CREATE TABLE
1f400 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 63 6f 6e statement to con
1f410 73 74 72 75 63 74 20 74 68 65 20 69 6d 70 6f 73 struct the impos
1f420 74 65 72 20 74 61 62 6c 65 20 69 6e 0a 20 20 20 ter table in.
1f430 20 2a 2a 20 74 68 65 20 70 61 72 73 65 64 20 73 ** the parsed s
1f440 63 68 65 6d 61 2e 20 20 54 68 65 6e 20 74 75 72 chema. Then tur
1f450 6e 20 69 6d 70 6f 73 74 65 72 20 6d 6f 64 65 20 n imposter mode
1f460 62 61 63 6b 20 6f 66 66 20 61 67 61 69 6e 2e 0a back off again..
1f470 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 **. ** If
1f480 20 6f 6e 4f 66 66 3d 3d 30 20 61 6e 64 20 74 6e onOff==0 and tn
1f490 75 6d 3e 30 20 74 68 65 6e 20 72 65 73 65 74 20 um>0 then reset
1f4a0 74 68 65 20 73 63 68 65 6d 61 20 66 6f 72 20 61 the schema for a
1f4b0 6c 6c 20 64 61 74 61 62 61 73 65 73 2c 20 63 61 ll databases, ca
1f4c0 75 73 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 65 using. ** the
1f4d0 20 73 63 68 65 6d 61 20 74 6f 20 62 65 20 72 65 schema to be re
1f4e0 70 61 72 73 65 64 20 74 68 65 20 6e 65 78 74 20 parsed the next
1f4f0 74 69 6d 65 20 69 74 20 69 73 20 6e 65 65 64 65 time it is neede
1f500 64 2e 20 20 54 68 69 73 20 68 61 73 20 74 68 65 d. This has the
1f510 0a 20 20 20 20 2a 2a 20 65 66 66 65 63 74 20 6f . ** effect o
1f520 66 20 65 72 61 73 69 6e 67 20 61 6c 6c 20 69 6d f erasing all im
1f530 70 6f 73 74 65 72 20 74 61 62 6c 65 73 2e 0a 20 poster tables..
1f540 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1f550 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 QLITE_TESTCTRL_I
1f560 4d 50 4f 53 54 45 52 3a 20 7b 0a 20 20 20 20 20 MPOSTER: {.
1f570 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 sqlite3 *db = v
1f580 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 a_arg(ap, sqlite
1f590 33 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 3*);. sqlit
1f5a0 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1f5b0 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 b->mutex);.
1f5c0 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62 20 3d 20 db->init.iDb =
1f5d0 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d sqlite3FindDbNam
1f5e0 65 28 64 62 2c 20 76 61 5f 61 72 67 28 61 70 2c e(db, va_arg(ap,
1f5f0 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 3b 0a 20 const char*));.
1f600 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 db->init.bu
1f610 73 79 20 3d 20 64 62 2d 3e 69 6e 69 74 2e 69 6d sy = db->init.im
1f620 70 6f 73 74 65 72 54 61 62 6c 65 20 3d 20 76 61 posterTable = va
1f630 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 _arg(ap,int);.
1f640 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 6e 65 77 db->init.new
1f650 54 6e 75 6d 20 3d 20 76 61 5f 61 72 67 28 61 70 Tnum = va_arg(ap
1f660 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 69 66 28 ,int);. if(
1f670 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d db->init.busy==
1f680 30 20 26 26 20 64 62 2d 3e 69 6e 69 74 2e 6e 65 0 && db->init.ne
1f690 77 54 6e 75 6d 3e 30 20 29 7b 0a 20 20 20 20 20 wTnum>0 ){.
1f6a0 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 41 sqlite3ResetA
1f6b0 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 llSchemasOfConne
1f6c0 63 74 69 6f 6e 28 64 62 29 3b 0a 20 20 20 20 20 ction(db);.
1f6d0 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
1f6e0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
1f6f0 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 62 >mutex);. b
1f700 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a reak;. }. }.
1f710 20 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 23 65 va_end(ap);.#e
1f720 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 55 ndif /* SQLITE_U
1f730 4e 54 45 53 54 41 42 4c 45 20 2a 2f 0a 20 20 72 NTESTABLE */. r
1f740 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
1f750 2a 2a 20 54 68 69 73 20 69 73 20 61 20 75 74 69 ** This is a uti
1f760 6c 69 74 79 20 72 6f 75 74 69 6e 65 2c 20 75 73 lity routine, us
1f770 65 66 75 6c 20 74 6f 20 56 46 53 20 69 6d 70 6c eful to VFS impl
1f780 65 6d 65 6e 74 61 74 69 6f 6e 73 2c 20 74 68 61 ementations, tha
1f790 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 6f 20 73 t checks.** to s
1f7a0 65 65 20 69 66 20 61 20 64 61 74 61 62 61 73 65 ee if a database
1f7b0 20 66 69 6c 65 20 77 61 73 20 61 20 55 52 49 20 file was a URI
1f7c0 74 68 61 74 20 63 6f 6e 74 61 69 6e 65 64 20 61 that contained a
1f7d0 20 73 70 65 63 69 66 69 63 20 71 75 65 72 79 20 specific query
1f7e0 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 2c 20 61 .** parameter, a
1f7f0 6e 64 20 69 66 20 73 6f 20 6f 62 74 61 69 6e 73 nd if so obtains
1f800 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 the value of th
1f810 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 e query paramete
1f820 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 7a 46 69 r..**.** The zFi
1f830 6c 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 lename argument
1f840 69 73 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 is the filename
1f850 70 6f 69 6e 74 65 72 20 70 61 73 73 65 64 20 69 pointer passed i
1f860 6e 74 6f 20 74 68 65 20 78 4f 70 65 6e 28 29 0a nto the xOpen().
1f870 2a 2a 20 6d 65 74 68 6f 64 20 6f 66 20 61 20 56 ** method of a V
1f880 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f FS implementatio
1f890 6e 2e 20 20 54 68 65 20 7a 50 61 72 61 6d 20 61 n. The zParam a
1f8a0 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 6e rgument is the n
1f8b0 61 6d 65 20 6f 66 20 74 68 65 0a 2a 2a 20 71 75 ame of the.** qu
1f8c0 65 72 79 20 70 61 72 61 6d 65 74 65 72 20 77 65 ery parameter we
1f8d0 20 73 65 65 6b 2e 20 20 54 68 69 73 20 72 6f 75 seek. This rou
1f8e0 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65 tine returns the
1f8f0 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7a 50 value of the zP
1f900 61 72 61 6d 0a 2a 2a 20 70 61 72 61 6d 65 74 65 aram.** paramete
1f910 72 20 69 66 20 69 74 20 65 78 69 73 74 73 2e 20 r if it exists.
1f920 20 49 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 If the paramete
1f930 72 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 r does not exist
1f940 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a , this routine.*
1f950 2a 20 72 65 74 75 72 6e 73 20 61 20 4e 55 4c 4c * returns a NULL
1f960 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e pointer..*/.con
1f970 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
1f980 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 63 _uri_parameter(c
1f990 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 onst char *zFile
1f9a0 6e 61 6d 65 2c 20 63 6f 6e 73 74 20 63 68 61 72 name, const char
1f9b0 20 2a 7a 50 61 72 61 6d 29 7b 0a 20 20 69 66 28 *zParam){. if(
1f9c0 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c zFilename==0 ||
1f9d0 20 7a 50 61 72 61 6d 3d 3d 30 20 29 20 72 65 74 zParam==0 ) ret
1f9e0 75 72 6e 20 30 3b 0a 20 20 7a 46 69 6c 65 6e 61 urn 0;. zFilena
1f9f0 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 me += sqlite3Str
1fa00 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 len30(zFilename)
1fa10 20 2b 20 31 3b 0a 20 20 77 68 69 6c 65 28 20 7a + 1;. while( z
1fa20 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 Filename[0] ){.
1fa30 20 20 20 69 6e 74 20 78 20 3d 20 73 74 72 63 6d int x = strcm
1fa40 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 p(zFilename, zPa
1fa50 72 61 6d 29 3b 0a 20 20 20 20 7a 46 69 6c 65 6e ram);. zFilen
1fa60 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 ame += sqlite3St
1fa70 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 rlen30(zFilename
1fa80 29 20 2b 20 31 3b 0a 20 20 20 20 69 66 28 20 78 ) + 1;. if( x
1fa90 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 7a 46 69 ==0 ) return zFi
1faa0 6c 65 6e 61 6d 65 3b 0a 20 20 20 20 7a 46 69 6c lename;. zFil
1fab0 65 6e 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 ename += sqlite3
1fac0 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 Strlen30(zFilena
1fad0 6d 65 29 20 2b 20 31 3b 0a 20 20 7d 0a 20 20 72 me) + 1;. }. r
1fae0 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn 0;.}../*.*
1faf0 2a 20 52 65 74 75 72 6e 20 61 20 62 6f 6f 6c 65 * Return a boole
1fb00 61 6e 20 76 61 6c 75 65 20 66 6f 72 20 61 20 71 an value for a q
1fb10 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a uery parameter..
1fb20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 75 */.int sqlite3_u
1fb30 72 69 5f 62 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 ri_boolean(const
1fb40 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
1fb50 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 , const char *zP
1fb60 61 72 61 6d 2c 20 69 6e 74 20 62 44 66 6c 74 29 aram, int bDflt)
1fb70 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
1fb80 7a 20 3d 20 73 71 6c 69 74 65 33 5f 75 72 69 5f z = sqlite3_uri_
1fb90 70 61 72 61 6d 65 74 65 72 28 7a 46 69 6c 65 6e parameter(zFilen
1fba0 61 6d 65 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 20 ame, zParam);.
1fbb0 62 44 66 6c 74 20 3d 20 62 44 66 6c 74 21 3d 30 bDflt = bDflt!=0
1fbc0 3b 0a 20 20 72 65 74 75 72 6e 20 7a 20 3f 20 73 ;. return z ? s
1fbd0 71 6c 69 74 65 33 47 65 74 42 6f 6f 6c 65 61 6e qlite3GetBoolean
1fbe0 28 7a 2c 20 62 44 66 6c 74 29 20 3a 20 62 44 66 (z, bDflt) : bDf
1fbf0 6c 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 lt;.}../*.** Ret
1fc00 75 72 6e 20 61 20 36 34 2d 62 69 74 20 69 6e 74 urn a 64-bit int
1fc10 65 67 65 72 20 76 61 6c 75 65 20 66 6f 72 20 61 eger value for a
1fc20 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 query parameter
1fc30 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74 ..*/.sqlite3_int
1fc40 36 34 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 69 64 sqlite3_uri_i
1fc50 6e 74 36 34 28 0a 20 20 63 6f 6e 73 74 20 63 68 nt64(. const ch
1fc60 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
1fc70 20 20 2f 2a 20 46 69 6c 65 6e 61 6d 65 20 61 73 /* Filename as
1fc80 20 70 61 73 73 65 64 20 74 6f 20 78 4f 70 65 6e passed to xOpen
1fc90 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
1fca0 20 2a 7a 50 61 72 61 6d 2c 20 20 20 20 20 20 20 *zParam,
1fcb0 2f 2a 20 55 52 49 20 70 61 72 61 6d 65 74 65 72 /* URI parameter
1fcc0 20 73 6f 75 67 68 74 20 2a 2f 0a 20 20 73 71 6c sought */. sql
1fcd0 69 74 65 33 5f 69 6e 74 36 34 20 62 44 66 6c 74 ite3_int64 bDflt
1fce0 20 20 20 20 20 20 20 2f 2a 20 72 65 74 75 72 6e /* return
1fcf0 20 69 66 20 70 61 72 61 6d 65 74 65 72 20 69 73 if parameter is
1fd00 20 6d 69 73 73 69 6e 67 20 2a 2f 0a 29 7b 0a 20 missing */.){.
1fd10 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d const char *z =
1fd20 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 sqlite3_uri_par
1fd30 61 6d 65 74 65 72 28 7a 46 69 6c 65 6e 61 6d 65 ameter(zFilename
1fd40 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 20 73 71 6c , zParam);. sql
1fd50 69 74 65 33 5f 69 6e 74 36 34 20 76 3b 0a 20 20 ite3_int64 v;.
1fd60 69 66 28 20 7a 20 26 26 20 73 71 6c 69 74 65 33 if( z && sqlite3
1fd70 44 65 63 4f 72 48 65 78 54 6f 49 36 34 28 7a 2c DecOrHexToI64(z,
1fd80 20 26 76 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 &v)==SQLITE_OK
1fd90 29 7b 0a 20 20 20 20 62 44 66 6c 74 20 3d 20 76 ){. bDflt = v
1fda0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 62 ;. }. return b
1fdb0 44 66 6c 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 Dflt;.}../*.** R
1fdc0 65 74 75 72 6e 20 74 68 65 20 42 74 72 65 65 20 eturn the Btree
1fdd0 70 6f 69 6e 74 65 72 20 69 64 65 6e 74 69 66 69 pointer identifi
1fde0 65 64 20 62 79 20 7a 44 62 4e 61 6d 65 2e 20 20 ed by zDbName.
1fdf0 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 20 6e Return NULL if n
1fe00 6f 74 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 42 74 72 ot found..*/.Btr
1fe10 65 65 20 2a 73 71 6c 69 74 65 33 44 62 4e 61 6d ee *sqlite3DbNam
1fe20 65 54 6f 42 74 72 65 65 28 73 71 6c 69 74 65 33 eToBtree(sqlite3
1fe30 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 *db, const char
1fe40 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 69 6e *zDbName){. in
1fe50 74 20 69 44 62 20 3d 20 7a 44 62 4e 61 6d 65 20 t iDb = zDbName
1fe60 3f 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e ? sqlite3FindDbN
1fe70 61 6d 65 28 64 62 2c 20 7a 44 62 4e 61 6d 65 29 ame(db, zDbName)
1fe80 20 3a 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 69 : 0;. return i
1fe90 44 62 3c 30 20 3f 20 30 20 3a 20 64 62 2d 3e 61 Db<0 ? 0 : db->a
1fea0 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 7d 0a 0a Db[iDb].pBt;.}..
1feb0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
1fec0 20 66 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65 filename of the
1fed0 20 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 database associ
1fee0 61 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61 ated with a data
1fef0 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 base.** connecti
1ff00 6f 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 on..*/.const cha
1ff10 72 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 66 69 r *sqlite3_db_fi
1ff20 6c 65 6e 61 6d 65 28 73 71 6c 69 74 65 33 20 2a lename(sqlite3 *
1ff30 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
1ff40 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 42 74 72 65 zDbName){. Btre
1ff50 65 20 2a 70 42 74 3b 0a 23 69 66 64 65 66 20 53 e *pBt;.#ifdef S
1ff60 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
1ff70 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
1ff80 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
1ff90 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 Ok(db) ){. (v
1ffa0 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 oid)SQLITE_MISUS
1ffb0 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 E_BKPT;. retu
1ffc0 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 rn 0;. }.#endif
1ffd0 0a 20 20 70 42 74 20 3d 20 73 71 6c 69 74 65 33 . pBt = sqlite3
1ffe0 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 64 62 DbNameToBtree(db
1fff0 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 72 65 , zDbName);. re
20000 74 75 72 6e 20 70 42 74 20 3f 20 73 71 6c 69 74 turn pBt ? sqlit
20010 65 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 e3BtreeGetFilena
20020 6d 65 28 70 42 74 29 20 3a 20 30 3b 0a 7d 0a 0a me(pBt) : 0;.}..
20030 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 31 20 69 /*.** Return 1 i
20040 66 20 64 61 74 61 62 61 73 65 20 69 73 20 72 65 f database is re
20050 61 64 2d 6f 6e 6c 79 20 6f 72 20 30 20 69 66 20 ad-only or 0 if
20060 72 65 61 64 2f 77 72 69 74 65 2e 20 20 52 65 74 read/write. Ret
20070 75 72 6e 20 2d 31 20 69 66 0a 2a 2a 20 6e 6f 20 urn -1 if.** no
20080 73 75 63 68 20 64 61 74 61 62 61 73 65 20 65 78 such database ex
20090 69 73 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ists..*/.int sql
200a0 69 74 65 33 5f 64 62 5f 72 65 61 64 6f 6e 6c 79 ite3_db_readonly
200b0 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f (sqlite3 *db, co
200c0 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d nst char *zDbNam
200d0 65 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 e){. Btree *pBt
200e0 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
200f0 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
20100 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
20110 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
20120 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
20130 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
20140 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b ;. return -1;
20150 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 42 . }.#endif. pB
20160 74 20 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 6d t = sqlite3DbNam
20170 65 54 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 62 eToBtree(db, zDb
20180 4e 61 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 Name);. return
20190 70 42 74 20 3f 20 73 71 6c 69 74 65 33 42 74 72 pBt ? sqlite3Btr
201a0 65 65 49 73 52 65 61 64 6f 6e 6c 79 28 70 42 74 eeIsReadonly(pBt
201b0 29 20 3a 20 2d 31 3b 0a 7d 0a 0a 23 69 66 64 65 ) : -1;.}..#ifde
201c0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
201d0 53 4e 41 50 53 48 4f 54 0a 2f 2a 0a 2a 2a 20 4f SNAPSHOT./*.** O
201e0 62 74 61 69 6e 20 61 20 73 6e 61 70 73 68 6f 74 btain a snapshot
201f0 20 68 61 6e 64 6c 65 20 66 6f 72 20 74 68 65 20 handle for the
20200 73 6e 61 70 73 68 6f 74 20 6f 66 20 64 61 74 61 snapshot of data
20210 62 61 73 65 20 7a 44 62 20 63 75 72 72 65 6e 74 base zDb current
20220 6c 79 20 0a 2a 2a 20 62 65 69 6e 67 20 72 65 61 ly .** being rea
20230 64 20 62 79 20 68 61 6e 64 6c 65 20 64 62 2e 0a d by handle db..
20240 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 */.int sqlite3_s
20250 6e 61 70 73 68 6f 74 5f 67 65 74 28 0a 20 20 73 napshot_get(. s
20260 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 63 qlite3 *db, . c
20270 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 2c 0a onst char *zDb,.
20280 20 20 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 sqlite3_snapsh
20290 6f 74 20 2a 2a 70 70 53 6e 61 70 73 68 6f 74 0a ot **ppSnapshot.
202a0 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
202b0 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 23 69 66 6e LITE_ERROR;.#ifn
202c0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
202d0 57 41 4c 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 WAL..#ifdef SQLI
202e0 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
202f0 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
20300 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
20310 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 db) ){. retur
20320 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
20330 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 BKPT;. }.#endif
20340 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
20350 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
20360 29 3b 0a 0a 20 20 69 66 28 20 64 62 2d 3e 61 75 );.. if( db->au
20370 74 6f 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 toCommit==0 ){.
20380 20 20 20 69 6e 74 20 69 44 62 20 3d 20 73 71 6c int iDb = sql
20390 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 64 ite3FindDbName(d
203a0 62 2c 20 7a 44 62 29 3b 0a 20 20 20 20 69 66 28 b, zDb);. if(
203b0 20 69 44 62 3d 3d 30 20 7c 7c 20 69 44 62 3e 31 iDb==0 || iDb>1
203c0 20 29 7b 0a 20 20 20 20 20 20 42 74 72 65 65 20 ){. Btree
203d0 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 *pBt = db->aDb[i
203e0 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 Db].pBt;. i
203f0 66 28 20 30 3d 3d 73 71 6c 69 74 65 33 42 74 72 f( 0==sqlite3Btr
20400 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 eeIsInTrans(pBt)
20410 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
20420 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 sqlite3BtreeBeg
20430 69 6e 54 72 61 6e 73 28 70 42 74 2c 20 30 29 3b inTrans(pBt, 0);
20440 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d . if( rc=
20450 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
20460 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
20470 69 74 65 33 50 61 67 65 72 53 6e 61 70 73 68 6f ite3PagerSnapsho
20480 74 47 65 74 28 73 71 6c 69 74 65 33 42 74 72 65 tGet(sqlite3Btre
20490 65 50 61 67 65 72 28 70 42 74 29 2c 20 70 70 53 ePager(pBt), ppS
204a0 6e 61 70 73 68 6f 74 29 3b 0a 20 20 20 20 20 20 napshot);.
204b0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
204c0 7d 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33 }. }.. sqlite3
204d0 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
204e0 3e 6d 75 74 65 78 29 3b 0a 23 65 6e 64 69 66 20 >mutex);.#endif
204f0 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 /* SQLITE_OMIT
20500 5f 57 41 4c 20 2a 2f 0a 20 20 72 65 74 75 72 6e _WAL */. return
20510 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 rc;.}../*.** Op
20520 65 6e 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 en a read-transa
20530 63 74 69 6f 6e 20 6f 6e 20 74 68 65 20 73 6e 61 ction on the sna
20540 70 73 68 6f 74 20 69 64 65 6e 64 69 66 69 65 64 pshot idendified
20550 20 62 79 20 70 53 6e 61 70 73 68 6f 74 2e 0a 2a by pSnapshot..*
20560 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 6e /.int sqlite3_sn
20570 61 70 73 68 6f 74 5f 6f 70 65 6e 28 0a 20 20 73 apshot_open(. s
20580 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 63 qlite3 *db, . c
20590 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 onst char *zDb,
205a0 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 . sqlite3_snaps
205b0 68 6f 74 20 2a 70 53 6e 61 70 73 68 6f 74 0a 29 hot *pSnapshot.)
205c0 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
205d0 49 54 45 5f 45 52 52 4f 52 3b 0a 23 69 66 6e 64 ITE_ERROR;.#ifnd
205e0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
205f0 41 4c 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 AL..#ifdef SQLIT
20600 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
20610 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
20620 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
20630 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e b) ){. return
20640 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
20650 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a KPT;. }.#endif.
20660 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
20670 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
20680 3b 0a 20 20 69 66 28 20 64 62 2d 3e 61 75 74 6f ;. if( db->auto
20690 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 Commit==0 ){.
206a0 20 69 6e 74 20 69 44 62 3b 0a 20 20 20 20 69 44 int iDb;. iD
206b0 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 44 b = sqlite3FindD
206c0 62 4e 61 6d 65 28 64 62 2c 20 7a 44 62 29 3b 0a bName(db, zDb);.
206d0 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 7c if( iDb==0 |
206e0 7c 20 69 44 62 3e 31 20 29 7b 0a 20 20 20 20 20 | iDb>1 ){.
206f0 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 Btree *pBt = db
20700 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a ->aDb[iDb].pBt;.
20710 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c if( 0==sql
20720 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61 ite3BtreeIsInRea
20730 64 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 dTrans(pBt) ){.
20740 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
20750 74 65 33 50 61 67 65 72 53 6e 61 70 73 68 6f 74 te3PagerSnapshot
20760 4f 70 65 6e 28 73 71 6c 69 74 65 33 42 74 72 65 Open(sqlite3Btre
20770 65 50 61 67 65 72 28 70 42 74 29 2c 20 70 53 6e ePager(pBt), pSn
20780 61 70 73 68 6f 74 29 3b 0a 20 20 20 20 20 20 20 apshot);.
20790 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
207a0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
207b0 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
207c0 65 42 65 67 69 6e 54 72 61 6e 73 28 70 42 74 2c eBeginTrans(pBt,
207d0 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 0);. s
207e0 71 6c 69 74 65 33 50 61 67 65 72 53 6e 61 70 73 qlite3PagerSnaps
207f0 68 6f 74 4f 70 65 6e 28 73 71 6c 69 74 65 33 42 hotOpen(sqlite3B
20800 74 72 65 65 50 61 67 65 72 28 70 42 74 29 2c 20 treePager(pBt),
20810 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 0);. }.
20820 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
20830 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
20840 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
20850 29 3b 0a 23 65 6e 64 69 66 20 20 20 2f 2a 20 53 );.#endif /* S
20860 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a QLITE_OMIT_WAL *
20870 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d /. return rc;.}
20880 0a 0a 2f 2a 0a 2a 2a 20 52 65 63 6f 76 65 72 20 ../*.** Recover
20890 61 73 20 6d 61 6e 79 20 73 6e 61 70 73 68 6f 74 as many snapshot
208a0 73 20 61 73 20 70 6f 73 73 69 62 6c 65 20 66 72 s as possible fr
208b0 6f 6d 20 74 68 65 20 77 61 6c 20 66 69 6c 65 20 om the wal file
208c0 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0a associated with.
208d0 2a 2a 20 73 63 68 65 6d 61 20 7a 44 62 20 6f 66 ** schema zDb of
208e0 20 64 61 74 61 62 61 73 65 20 64 62 2e 0a 2a 2f database db..*/
208f0 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 6e 61 .int sqlite3_sna
20900 70 73 68 6f 74 5f 72 65 63 6f 76 65 72 28 73 71 pshot_recover(sq
20910 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 lite3 *db, const
20920 20 63 68 61 72 20 2a 7a 44 62 29 7b 0a 20 20 69 char *zDb){. i
20930 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 nt rc = SQLITE_E
20940 52 52 4f 52 3b 0a 20 20 69 6e 74 20 69 44 62 3b RROR;. int iDb;
20950 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
20960 4f 4d 49 54 5f 57 41 4c 0a 0a 23 69 66 64 65 66 OMIT_WAL..#ifdef
20970 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
20980 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
20990 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
209a0 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
209b0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
209c0 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 SUSE_BKPT;. }.#
209d0 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 endif.. sqlite3
209e0 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
209f0 3e 6d 75 74 65 78 29 3b 0a 20 20 69 44 62 20 3d >mutex);. iDb =
20a00 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 sqlite3FindDbNa
20a10 6d 65 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 69 me(db, zDb);. i
20a20 66 28 20 69 44 62 3d 3d 30 20 7c 7c 20 69 44 62 f( iDb==0 || iDb
20a30 3e 31 20 29 7b 0a 20 20 20 20 42 74 72 65 65 20 >1 ){. Btree
20a40 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 *pBt = db->aDb[i
20a50 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 Db].pBt;. if(
20a60 20 30 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65 0==sqlite3Btree
20a70 49 73 49 6e 52 65 61 64 54 72 61 6e 73 28 70 42 IsInReadTrans(pB
20a80 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d t) ){. rc =
20a90 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 sqlite3BtreeBeg
20aa0 69 6e 54 72 61 6e 73 28 70 42 74 2c 20 30 29 3b inTrans(pBt, 0);
20ab0 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
20ac0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
20ad0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
20ae0 50 61 67 65 72 53 6e 61 70 73 68 6f 74 52 65 63 PagerSnapshotRec
20af0 6f 76 65 72 28 73 71 6c 69 74 65 33 42 74 72 65 over(sqlite3Btre
20b00 65 50 61 67 65 72 28 70 42 74 29 29 3b 0a 20 20 ePager(pBt));.
20b10 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
20b20 65 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 eeCommit(pBt);.
20b30 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
20b40 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
20b50 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
20b60 29 3b 0a 23 65 6e 64 69 66 20 20 20 2f 2a 20 53 );.#endif /* S
20b70 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a QLITE_OMIT_WAL *
20b80 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d /. return rc;.}
20b90 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 20 73 ../*.** Free a s
20ba0 6e 61 70 73 68 6f 74 20 68 61 6e 64 6c 65 20 6f napshot handle o
20bb0 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c btained from sql
20bc0 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 67 65 ite3_snapshot_ge
20bd0 74 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c t()..*/.void sql
20be0 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 66 72 ite3_snapshot_fr
20bf0 65 65 28 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 ee(sqlite3_snaps
20c00 68 6f 74 20 2a 70 53 6e 61 70 73 68 6f 74 29 7b hot *pSnapshot){
20c10 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
20c20 70 53 6e 61 70 73 68 6f 74 29 3b 0a 7d 0a 23 65 pSnapshot);.}.#e
20c30 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 ndif /* SQLITE_E
20c40 4e 41 42 4c 45 5f 53 4e 41 50 53 48 4f 54 20 2a NABLE_SNAPSHOT *
20c50 2f 0a 0a 53 51 4c 49 54 45 5f 45 58 50 45 52 49 /..SQLITE_EXPERI
20c60 4d 45 4e 54 41 4c 20 69 6e 74 20 73 71 6c 69 74 MENTAL int sqlit
20c70 65 33 5f 77 61 6c 5f 69 6e 66 6f 28 0a 20 20 73 e3_wal_info(. s
20c80 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 qlite3 *db, cons
20c90 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 0a 20 20 t char *zDb, .
20ca0 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 2a 70 6e unsigned int *pn
20cb0 50 72 69 6f 72 2c 20 75 6e 73 69 67 6e 65 64 20 Prior, unsigned
20cc0 69 6e 74 20 2a 70 6e 46 72 61 6d 65 0a 29 7b 0a int *pnFrame.){.
20cd0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
20ce0 45 5f 4f 4b 3b 0a 0a 23 69 66 6e 64 65 66 20 53 E_OK;..#ifndef S
20cf0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
20d00 20 42 74 72 65 65 20 2a 70 42 74 3b 0a 20 20 69 Btree *pBt;. i
20d10 6e 74 20 69 44 62 3b 0a 0a 23 69 66 64 65 66 20 nt iDb;..#ifdef
20d20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
20d30 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
20d40 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
20d50 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 kOk(db) ){. r
20d60 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
20d70 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 USE_BKPT;. }.#e
20d80 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 5f ndif.. sqlite3_
20d90 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
20da0 6d 75 74 65 78 29 3b 0a 20 20 69 44 62 20 3d 20 mutex);. iDb =
20db0 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d sqlite3FindDbNam
20dc0 65 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 69 66 e(db, zDb);. if
20dd0 28 20 69 44 62 3c 30 20 29 7b 0a 20 20 20 20 72 ( iDb<0 ){. r
20de0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 eturn SQLITE_ERR
20df0 4f 52 3b 0a 20 20 7d 0a 20 20 70 42 74 20 3d 20 OR;. }. pBt =
20e00 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
20e10 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
20e20 50 61 67 65 72 57 61 6c 49 6e 66 6f 28 73 71 6c PagerWalInfo(sql
20e30 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
20e40 42 74 29 2c 20 70 6e 50 72 69 6f 72 2c 20 70 6e Bt), pnPrior, pn
20e50 46 72 61 6d 65 29 3b 0a 20 20 73 71 6c 69 74 65 Frame);. sqlite
20e60 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
20e70 2d 3e 6d 75 74 65 78 29 3b 0a 23 65 6e 64 69 66 ->mutex);.#endif
20e80 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 /* SQLITE_OMI
20e90 54 5f 57 41 4c 20 2a 2f 0a 0a 20 20 72 65 74 75 T_WAL */.. retu
20ea0 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 rn rc;.}..#ifnde
20eb0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f f SQLITE_OMIT_CO
20ec0 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 49 41 47 MPILEOPTION_DIAG
20ed0 53 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 68 S./*.** Given th
20ee0 65 20 6e 61 6d 65 20 6f 66 20 61 20 63 6f 6d 70 e name of a comp
20ef0 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2c ile-time option,
20f00 20 72 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 return true if
20f10 74 68 61 74 20 6f 70 74 69 6f 6e 0a 2a 2a 20 77 that option.** w
20f20 61 73 20 75 73 65 64 20 61 6e 64 20 66 61 6c 73 as used and fals
20f30 65 20 69 66 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 e if not..**.**
20f40 54 68 65 20 6e 61 6d 65 20 63 61 6e 20 6f 70 74 The name can opt
20f50 69 6f 6e 61 6c 6c 79 20 62 65 67 69 6e 20 77 69 ionally begin wi
20f60 74 68 20 22 53 51 4c 49 54 45 5f 22 20 62 75 74 th "SQLITE_" but
20f70 20 74 68 65 20 22 53 51 4c 49 54 45 5f 22 20 70 the "SQLITE_" p
20f80 72 65 66 69 78 0a 2a 2a 20 69 73 20 6e 6f 74 20 refix.** is not
20f90 72 65 71 75 69 72 65 64 20 66 6f 72 20 61 20 6d required for a m
20fa0 61 74 63 68 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c atch..*/.int sql
20fb0 69 74 65 33 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 ite3_compileopti
20fc0 6f 6e 5f 75 73 65 64 28 63 6f 6e 73 74 20 63 68 on_used(const ch
20fd0 61 72 20 2a 7a 4f 70 74 4e 61 6d 65 29 7b 0a 20 ar *zOptName){.
20fe0 20 69 6e 74 20 69 2c 20 6e 3b 0a 20 20 69 6e 74 int i, n;. int
20ff0 20 6e 4f 70 74 3b 0a 20 20 63 6f 6e 73 74 20 63 nOpt;. const c
21000 68 61 72 20 2a 2a 61 7a 43 6f 6d 70 69 6c 65 4f har **azCompileO
21010 70 74 3b 0a 20 0a 23 69 66 20 53 51 4c 49 54 45 pt;. .#if SQLITE
21020 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
21030 52 0a 20 20 69 66 28 20 7a 4f 70 74 4e 61 6d 65 R. if( zOptName
21040 3d 3d 30 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 ==0 ){. (void
21050 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 )SQLITE_MISUSE_B
21060 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 KPT;. return
21070 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 0;. }.#endif..
21080 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 20 3d 20 azCompileOpt =
21090 73 71 6c 69 74 65 33 43 6f 6d 70 69 6c 65 4f 70 sqlite3CompileOp
210a0 74 69 6f 6e 73 28 26 6e 4f 70 74 29 3b 0a 0a 20 tions(&nOpt);..
210b0 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 72 4e if( sqlite3StrN
210c0 49 43 6d 70 28 7a 4f 70 74 4e 61 6d 65 2c 20 22 ICmp(zOptName, "
210d0 53 51 4c 49 54 45 5f 22 2c 20 37 29 3d 3d 30 20 SQLITE_", 7)==0
210e0 29 20 7a 4f 70 74 4e 61 6d 65 20 2b 3d 20 37 3b ) zOptName += 7;
210f0 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 53 74 . n = sqlite3St
21100 72 6c 65 6e 33 30 28 7a 4f 70 74 4e 61 6d 65 29 rlen30(zOptName)
21110 3b 0a 0a 20 20 2f 2a 20 53 69 6e 63 65 20 6e 4f ;.. /* Since nO
21120 70 74 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 69 pt is normally i
21130 6e 20 73 69 6e 67 6c 65 20 64 69 67 69 74 73 2c n single digits,
21140 20 61 20 6c 69 6e 65 61 72 20 73 65 61 72 63 68 a linear search
21150 20 69 73 20 0a 20 20 2a 2a 20 61 64 65 71 75 61 is . ** adequa
21160 74 65 2e 20 4e 6f 20 6e 65 65 64 20 66 6f 72 20 te. No need for
21170 61 20 62 69 6e 61 72 79 20 73 65 61 72 63 68 2e a binary search.
21180 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 */. for(i=0; i
21190 3c 6e 4f 70 74 3b 20 69 2b 2b 29 7b 0a 20 20 20 <nOpt; i++){.
211a0 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 72 4e if( sqlite3StrN
211b0 49 43 6d 70 28 7a 4f 70 74 4e 61 6d 65 2c 20 61 ICmp(zOptName, a
211c0 7a 43 6f 6d 70 69 6c 65 4f 70 74 5b 69 5d 2c 20 zCompileOpt[i],
211d0 6e 29 3d 3d 30 0a 20 20 20 20 20 26 26 20 73 71 n)==0. && sq
211e0 6c 69 74 65 33 49 73 49 64 43 68 61 72 28 28 75 lite3IsIdChar((u
211f0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 61 7a 43 nsigned char)azC
21200 6f 6d 70 69 6c 65 4f 70 74 5b 69 5d 5b 6e 5d 29 ompileOpt[i][n])
21210 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 ==0. ){.
21220 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d return 1;. }
21230 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b . }. return 0;
21240 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
21250 20 74 68 65 20 4e 2d 74 68 20 63 6f 6d 70 69 6c the N-th compil
21260 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 73 74 e-time option st
21270 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20 6f ring. If N is o
21280 75 74 20 6f 66 20 72 61 6e 67 65 2c 0a 2a 2a 20 ut of range,.**
21290 72 65 74 75 72 6e 20 61 20 4e 55 4c 4c 20 70 6f return a NULL po
212a0 69 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 inter..*/.const
212b0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f char *sqlite3_co
212c0 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 67 65 74 28 mpileoption_get(
212d0 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 6e 4f int N){. int nO
212e0 70 74 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 pt;. const char
212f0 20 2a 2a 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 3b **azCompileOpt;
21300 0a 20 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 20 . azCompileOpt
21310 3d 20 73 71 6c 69 74 65 33 43 6f 6d 70 69 6c 65 = sqlite3Compile
21320 4f 70 74 69 6f 6e 73 28 26 6e 4f 70 74 29 3b 0a Options(&nOpt);.
21330 20 20 69 66 28 20 4e 3e 3d 30 20 26 26 20 4e 3c if( N>=0 && N<
21340 6e 4f 70 74 20 29 7b 0a 20 20 20 20 72 65 74 75 nOpt ){. retu
21350 72 6e 20 61 7a 43 6f 6d 70 69 6c 65 4f 70 74 5b rn azCompileOpt[
21360 4e 5d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e N];. }. return
21370 20 30 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 0;.}.#endif /*
21380 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50 SQLITE_OMIT_COMP
21390 49 4c 45 4f 50 54 49 4f 4e 5f 44 49 41 47 53 20 ILEOPTION_DIAGS
213a0 2a 2f 0a */.