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 53 SQLITE_ENABLE_S
0290: 51 4c 52 52 0a 23 20 69 6e 63 6c 75 64 65 20 22 QLRR.# include "
02a0: 73 71 6c 72 72 2e 68 22 0a 23 65 6e 64 69 66 20 sqlrr.h".#endif
02b0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
02c0: 4e 41 42 4c 45 5f 46 54 53 33 0a 23 20 69 6e 63 NABLE_FTS3.# inc
02d0: 6c 75 64 65 20 22 66 74 73 33 2e 68 22 0a 23 65 lude "fts3.h".#e
02e0: 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
02f0: 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 0a TE_ENABLE_RTREE.
0300: 23 20 69 6e 63 6c 75 64 65 20 22 72 74 72 65 65 # include "rtree
0310: 2e 68 22 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 .h".#endif.#ifde
0320: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
0330: 49 43 55 0a 23 20 69 6e 63 6c 75 64 65 20 22 73 ICU.# include "s
0340: 71 6c 69 74 65 69 63 75 2e 68 22 0a 23 65 6e 64 qliteicu.h".#end
0350: 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 if..#ifndef SQLI
0360: 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a TE_AMALGAMATION.
0370: 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f /* IMPLEMENTATIO
0380: 4e 2d 4f 46 3a 20 52 2d 34 36 36 35 36 2d 34 35 N-OF: R-46656-45
0390: 31 35 36 20 54 68 65 20 73 71 6c 69 74 65 33 5f 156 The sqlite3_
03a0: 76 65 72 73 69 6f 6e 5b 5d 20 73 74 72 69 6e 67 version[] string
03b0: 20 63 6f 6e 73 74 61 6e 74 0a 2a 2a 20 63 6f 6e constant.** con
03c0: 74 61 69 6e 73 20 74 68 65 20 74 65 78 74 20 6f tains the text o
03d0: 66 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e f SQLITE_VERSION
03e0: 20 6d 61 63 72 6f 2e 20 0a 2a 2f 0a 63 6f 6e 73 macro. .*/.cons
03f0: 74 20 63 68 61 72 20 73 71 6c 69 74 65 33 5f 76 t char sqlite3_v
0400: 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54 ersion[] = SQLIT
0410: 45 5f 56 45 52 53 49 4f 4e 3b 0a 23 65 6e 64 69 E_VERSION;.#endi
0420: 66 0a 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 f../* IMPLEMENTA
0430: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 35 33 35 33 36 TION-OF: R-53536
0440: 2d 34 32 35 37 35 20 54 68 65 20 73 71 6c 69 74 -42575 The sqlit
0450: 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 28 29 20 e3_libversion()
0460: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
0470: 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f .** a pointer to
0480: 20 74 68 65 20 74 6f 20 74 68 65 20 73 71 6c 69 the to the sqli
0490: 74 65 33 5f 76 65 72 73 69 6f 6e 5b 5d 20 73 74 te3_version[] st
04a0: 72 69 6e 67 20 63 6f 6e 73 74 61 6e 74 2e 20 0a ring constant. .
04b0: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
04c0: 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f qlite3_libversio
04d0: 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 n(void){ return
04e0: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 3b sqlite3_version;
04f0: 20 7d 0a 0a 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54 }../* IMPLEMENT
0500: 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 36 33 31 32 ATION-OF: R-6312
0510: 34 2d 33 39 33 30 30 20 54 68 65 20 73 71 6c 69 4-39300 The sqli
0520: 74 65 33 5f 73 6f 75 72 63 65 69 64 28 29 20 66 te3_sourceid() f
0530: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
0540: 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 a.** pointer to
0550: 61 20 73 74 72 69 6e 67 20 63 6f 6e 73 74 61 6e a string constan
0560: 74 20 77 68 6f 73 65 20 76 61 6c 75 65 20 69 73 t whose value is
0570: 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 the same as the
0580: 0a 2a 2a 20 53 51 4c 49 54 45 5f 53 4f 55 52 43 .** SQLITE_SOURC
0590: 45 5f 49 44 20 43 20 70 72 65 70 72 6f 63 65 73 E_ID C preproces
05a0: 73 6f 72 20 6d 61 63 72 6f 2e 20 0a 2a 2f 0a 63 sor macro. .*/.c
05b0: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
05c0: 65 33 5f 73 6f 75 72 63 65 69 64 28 76 6f 69 64 e3_sourceid(void
05d0: 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ){ return SQLITE
05e0: 5f 53 4f 55 52 43 45 5f 49 44 3b 20 7d 0a 0a 2f _SOURCE_ID; }../
05f0: 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e * IMPLEMENTATION
0600: 2d 4f 46 3a 20 52 2d 33 35 32 31 30 2d 36 33 35 -OF: R-35210-635
0610: 30 38 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6c 08 The sqlite3_l
0620: 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 ibversion_number
0630: 28 29 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 72 () function.** r
0640: 65 74 75 72 6e 73 20 61 6e 20 69 6e 74 65 67 65 eturns an intege
0650: 72 20 65 71 75 61 6c 20 74 6f 20 53 51 4c 49 54 r equal to SQLIT
0660: 45 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d 42 45 52 E_VERSION_NUMBER
0670: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
0680: 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 _libversion_numb
0690: 65 72 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e er(void){ return
06a0: 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f SQLITE_VERSION_
06b0: 4e 55 4d 42 45 52 3b 20 7d 0a 0a 2f 2a 20 49 4d NUMBER; }../* IM
06c0: 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a PLEMENTATION-OF:
06d0: 20 52 2d 32 30 37 39 30 2d 31 34 30 32 35 20 54 R-20790-14025 T
06e0: 68 65 20 73 71 6c 69 74 65 33 5f 74 68 72 65 61 he sqlite3_threa
06f0: 64 73 61 66 65 28 29 20 66 75 6e 63 74 69 6f 6e dsafe() function
0700: 20 72 65 74 75 72 6e 73 0a 2a 2a 20 7a 65 72 6f returns.** zero
0710: 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 69 66 20 if and only if
0720: 53 51 4c 69 74 65 20 77 61 73 20 63 6f 6d 70 69 SQLite was compi
0730: 6c 65 64 20 77 69 74 68 20 6d 75 74 65 78 69 6e led with mutexin
0740: 67 20 63 6f 64 65 20 6f 6d 69 74 74 65 64 20 64 g code omitted d
0750: 75 65 20 74 6f 0a 2a 2a 20 74 68 65 20 53 51 4c ue to.** the SQL
0760: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 63 ITE_THREADSAFE c
0770: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 ompile-time opti
0780: 6f 6e 20 62 65 69 6e 67 20 73 65 74 20 74 6f 20 on being set to
0790: 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 0..*/.int sqlite
07a0: 33 5f 74 68 72 65 61 64 73 61 66 65 28 76 6f 69 3_threadsafe(voi
07b0: 64 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 54 d){ return SQLIT
07c0: 45 5f 54 48 52 45 41 44 53 41 46 45 3b 20 7d 0a E_THREADSAFE; }.
07d0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 .#if !defined(SQ
07e0: 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 29 LITE_OMIT_TRACE)
07f0: 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 && defined(SQLI
0800: 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 TE_ENABLE_IOTRAC
0810: 45 29 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 E)./*.** If the
0820: 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 following functi
0830: 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 20 6e 6f on pointer is no
0840: 74 20 4e 55 4c 4c 20 61 6e 64 20 69 66 0a 2a 2a t NULL and if.**
0850: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 SQLITE_ENABLE_I
0860: 4f 54 52 41 43 45 20 69 73 20 65 6e 61 62 6c 65 OTRACE is enable
0870: 64 2c 20 74 68 65 6e 20 6d 65 73 73 61 67 65 73 d, then messages
0880: 20 64 65 73 63 72 69 62 69 6e 67 0a 2a 2a 20 49 describing.** I
0890: 2f 4f 20 61 63 74 69 76 65 20 61 72 65 20 77 72 /O active are wr
08a0: 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 69 73 itten using this
08b0: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 73 function. Thes
08c0: 65 20 6d 65 73 73 61 67 65 73 0a 2a 2a 20 61 72 e messages.** ar
08d0: 65 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 64 e intended for d
08e0: 65 62 75 67 67 69 6e 67 20 61 63 74 69 76 69 74 ebugging activit
08f0: 79 20 6f 6e 6c 79 2e 0a 2a 2f 0a 2f 2a 20 6e 6f y only..*/./* no
0900: 74 2d 70 72 69 76 61 74 65 20 2a 2f 20 76 6f 69 t-private */ voi
0910: 64 20 28 2a 73 71 6c 69 74 65 33 49 6f 54 72 61 d (*sqlite3IoTra
0920: 63 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ce)(const char*,
0930: 20 2e 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e 64 69 ...) = 0;.#endi
0940: 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 f../*.** If the
0950: 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c following global
0960: 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 variable points
0970: 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 to a string whi
0980: 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d ch is the.** nam
0990: 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 e of a directory
09a0: 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 , then that dire
09b0: 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 ctory will be us
09c0: 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 ed to store.** t
09d0: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a emporary files..
09e0: 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 **.** See also t
09f0: 68 65 20 22 50 52 41 47 4d 41 20 74 65 6d 70 5f he "PRAGMA temp_
0a00: 73 74 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 store_directory"
0a10: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f SQL command..*/
0a20: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 .char *sqlite3_t
0a30: 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 emp_directory =
0a40: 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 0;../*.** If the
0a50: 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 following globa
0a60: 6c 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 l variable point
0a70: 73 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 s to a string wh
0a80: 69 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 ich is the.** na
0a90: 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 me of a director
0aa0: 79 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 y, then that dir
0ab0: 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 ectory will be u
0ac0: 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 sed to store.**
0ad0: 61 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c all database fil
0ae0: 65 73 20 73 70 65 63 69 66 69 65 64 20 77 69 74 es specified wit
0af0: 68 20 61 20 72 65 6c 61 74 69 76 65 20 70 61 74 h a relative pat
0b00: 68 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 hname..**.** See
0b10: 20 61 6c 73 6f 20 74 68 65 20 22 50 52 41 47 4d also the "PRAGM
0b20: 41 20 64 61 74 61 5f 73 74 6f 72 65 5f 64 69 72 A data_store_dir
0b30: 65 63 74 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d ectory" SQL comm
0b40: 61 6e 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 and..*/.char *sq
0b50: 6c 69 74 65 33 5f 64 61 74 61 5f 64 69 72 65 63 lite3_data_direc
0b60: 74 6f 72 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a tory = 0;../*.**
0b70: 20 49 6e 69 74 69 61 6c 69 7a 65 20 53 51 4c 69 Initialize SQLi
0b80: 74 65 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 te. .**.** This
0b90: 20 72 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 65 routine must be
0ba0: 20 63 61 6c 6c 65 64 20 74 6f 20 69 6e 69 74 69 called to initi
0bb0: 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 alize the memory
0bc0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 allocation,.**
0bd0: 56 46 53 2c 20 61 6e 64 20 6d 75 74 65 78 20 73 VFS, and mutex s
0be0: 75 62 73 79 73 74 65 6d 73 20 70 72 69 6f 72 20 ubsystems prior
0bf0: 74 6f 20 64 6f 69 6e 67 20 61 6e 79 20 73 65 72 to doing any ser
0c00: 69 6f 75 73 20 77 6f 72 6b 20 77 69 74 68 0a 2a ious work with.*
0c10: 2a 20 53 51 4c 69 74 65 2e 20 20 42 75 74 20 61 * SQLite. But a
0c20: 73 20 6c 6f 6e 67 20 61 73 20 79 6f 75 20 64 6f s long as you do
0c30: 20 6e 6f 74 20 63 6f 6d 70 69 6c 65 20 77 69 74 not compile wit
0c40: 68 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 h SQLITE_OMIT_AU
0c50: 54 4f 49 4e 49 54 0a 2a 2a 20 74 68 69 73 20 72 TOINIT.** this r
0c60: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 62 65 20 63 outine will be c
0c70: 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61 alled automatica
0c80: 6c 6c 79 20 62 79 20 6b 65 79 20 72 6f 75 74 69 lly by key routi
0c90: 6e 65 73 20 73 75 63 68 20 61 73 0a 2a 2a 20 73 nes such as.** s
0ca0: 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 20 20 qlite3_open().
0cb0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
0cc0: 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 65 ine is a no-op e
0cd0: 78 63 65 70 74 20 6f 6e 20 69 74 73 20 76 65 72 xcept on its ver
0ce0: 79 20 66 69 72 73 74 20 63 61 6c 6c 20 66 6f 72 y first call for
0cf0: 20 74 68 65 20 70 72 6f 63 65 73 73 2c 0a 2a 2a the process,.**
0d00: 20 6f 72 20 66 6f 72 20 74 68 65 20 66 69 72 73 or for the firs
0d10: 74 20 63 61 6c 6c 20 61 66 74 65 72 20 61 20 63 t call after a c
0d20: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 73 all to sqlite3_s
0d30: 68 75 74 64 6f 77 6e 2e 0a 2a 2a 0a 2a 2a 20 54 hutdown..**.** T
0d40: 68 65 20 66 69 72 73 74 20 74 68 72 65 61 64 20 he first thread
0d50: 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 to call this rou
0d60: 74 69 6e 65 20 72 75 6e 73 20 74 68 65 20 69 6e tine runs the in
0d70: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 74 6f 0a itialization to.
0d80: 2a 2a 20 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 20 ** completion.
0d90: 49 66 20 73 75 62 73 65 71 75 65 6e 74 20 74 68 If subsequent th
0da0: 72 65 61 64 73 20 63 61 6c 6c 20 74 68 69 73 20 reads call this
0db0: 72 6f 75 74 69 6e 65 20 62 65 66 6f 72 65 20 74 routine before t
0dc0: 68 65 20 66 69 72 73 74 0a 2a 2a 20 74 68 72 65 he first.** thre
0dd0: 61 64 20 68 61 73 20 66 69 6e 69 73 68 65 64 20 ad has finished
0de0: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 the initializati
0df0: 6f 6e 20 70 72 6f 63 65 73 73 2c 20 74 68 65 6e on process, then
0e00: 20 74 68 65 20 73 75 62 73 65 71 75 65 6e 74 0a the subsequent.
0e10: 2a 2a 20 74 68 72 65 61 64 73 20 6d 75 73 74 20 ** threads must
0e20: 62 6c 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 block until the
0e30: 66 69 72 73 74 20 74 68 72 65 61 64 20 66 69 6e first thread fin
0e40: 69 73 68 65 73 20 77 69 74 68 20 74 68 65 20 69 ishes with the i
0e50: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 2a nitialization..*
0e60: 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 74 *.** The first t
0e70: 68 72 65 61 64 20 6d 69 67 68 74 20 63 61 6c 6c hread might call
0e80: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 this routine re
0e90: 63 75 72 73 69 76 65 6c 79 2e 20 20 52 65 63 75 cursively. Recu
0ea0: 72 73 69 76 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 rsive.** calls t
0eb0: 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 73 o this routine s
0ec0: 68 6f 75 6c 64 20 6e 6f 74 20 62 6c 6f 63 6b 2c hould not block,
0ed0: 20 6f 66 20 63 6f 75 72 73 65 2e 20 20 4f 74 68 of course. Oth
0ee0: 65 72 77 69 73 65 20 74 68 65 0a 2a 2a 20 69 6e erwise the.** in
0ef0: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f itialization pro
0f00: 63 65 73 73 20 77 6f 75 6c 64 20 6e 65 76 65 72 cess would never
0f10: 20 63 6f 6d 70 6c 65 74 65 2e 0a 2a 2a 0a 2a 2a complete..**.**
0f20: 20 4c 65 74 20 58 20 62 65 20 74 68 65 20 66 69 Let X be the fi
0f30: 72 73 74 20 74 68 72 65 61 64 20 74 6f 20 65 6e rst thread to en
0f40: 74 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ter this routine
0f50: 2e 20 20 4c 65 74 20 59 20 62 65 20 73 6f 6d 65 . Let Y be some
0f60: 20 6f 74 68 65 72 0a 2a 2a 20 74 68 72 65 61 64 other.** thread
0f70: 2e 20 20 54 68 65 6e 20 77 68 69 6c 65 20 74 68 . Then while th
0f80: 65 20 69 6e 69 74 69 61 6c 20 69 6e 76 6f 63 61 e initial invoca
0f90: 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 72 6f 75 tion of this rou
0fa0: 74 69 6e 65 20 62 79 20 58 20 69 73 0a 2a 2a 20 tine by X is.**
0fb0: 69 6e 63 6f 6d 70 6c 65 74 65 2c 20 69 74 20 69 incomplete, it i
0fc0: 73 20 72 65 71 75 69 72 65 64 20 74 68 61 74 3a s required that:
0fd0: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 20 43 61 6c .**.** * Cal
0fe0: 6c 73 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69 ls to this routi
0ff0: 6e 65 20 66 72 6f 6d 20 59 20 6d 75 73 74 20 62 ne from Y must b
1000: 6c 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65 20 6f lock until the o
1010: 75 74 65 72 2d 6d 6f 73 74 0a 2a 2a 20 20 20 20 uter-most.**
1020: 20 20 20 63 61 6c 6c 20 62 79 20 58 20 63 6f 6d call by X com
1030: 70 6c 65 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 pletes..**.**
1040: 20 2a 20 20 52 65 63 75 72 73 69 76 65 20 63 61 * Recursive ca
1050: 6c 6c 73 20 74 6f 20 74 68 69 73 20 72 6f 75 74 lls to this rout
1060: 69 6e 65 20 66 72 6f 6d 20 74 68 72 65 61 64 20 ine from thread
1070: 58 20 72 65 74 75 72 6e 20 69 6d 6d 65 64 69 61 X return immedia
1080: 74 65 6c 79 0a 2a 2a 20 20 20 20 20 20 20 77 69 tely.** wi
1090: 74 68 6f 75 74 20 62 6c 6f 63 6b 69 6e 67 2e 0a thout blocking..
10a0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 */.int sqlite3_i
10b0: 6e 69 74 69 61 6c 69 7a 65 28 76 6f 69 64 29 7b nitialize(void){
10c0: 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 . MUTEX_LOGIC(
10d0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 sqlite3_mutex *p
10e0: 4d 61 73 74 65 72 3b 20 29 20 20 20 20 20 20 20 Master; )
10f0: 2f 2a 20 54 68 65 20 6d 61 69 6e 20 73 74 61 74 /* The main stat
1100: 69 63 20 6d 75 74 65 78 20 2a 2f 0a 20 20 69 6e ic mutex */. in
1110: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
1120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1130: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
1140: 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 23 69 66 sult code */.#if
1150: 64 65 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 def SQLITE_EXTRA
1160: 5f 49 4e 49 54 0a 20 20 69 6e 74 20 62 52 75 6e _INIT. int bRun
1170: 45 78 74 72 61 49 6e 69 74 20 3d 20 30 3b 20 20 ExtraInit = 0;
1180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1190: 20 20 20 20 20 2f 2a 20 45 78 74 72 61 20 69 6e /* Extra in
11a0: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6e 65 65 itialization nee
11b0: 64 65 64 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 23 ded */.#endif..#
11c0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 ifdef SQLITE_OMI
11d0: 54 5f 57 53 44 0a 20 20 72 63 20 3d 20 73 71 6c T_WSD. rc = sql
11e0: 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 34 30 ite3_wsd_init(40
11f0: 39 36 2c 20 32 34 29 3b 0a 20 20 69 66 28 20 72 96, 24);. if( r
1200: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1210: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1220: 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
1230: 49 66 20 53 51 4c 69 74 65 20 69 73 20 61 6c 72 If SQLite is alr
1240: 65 61 64 79 20 63 6f 6d 70 6c 65 74 65 6c 79 20 eady completely
1250: 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 initialized, the
1260: 6e 20 74 68 69 73 20 63 61 6c 6c 0a 20 20 2a 2a n this call. **
1270: 20 74 6f 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 to sqlite3_init
1280: 69 61 6c 69 7a 65 28 29 20 73 68 6f 75 6c 64 20 ialize() should
1290: 62 65 20 61 20 6e 6f 2d 6f 70 2e 20 20 42 75 74 be a no-op. But
12a0: 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 the initializat
12b0: 69 6f 6e 0a 20 20 2a 2a 20 6d 75 73 74 20 62 65 ion. ** must be
12c0: 20 63 6f 6d 70 6c 65 74 65 2e 20 20 53 6f 20 69 complete. So i
12d0: 73 49 6e 69 74 20 6d 75 73 74 20 6e 6f 74 20 62 sInit must not b
12e0: 65 20 73 65 74 20 75 6e 74 69 6c 20 74 68 65 20 e set until the
12f0: 76 65 72 79 20 65 6e 64 0a 20 20 2a 2a 20 6f 66 very end. ** of
1300: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 20 this routine..
1310: 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65 */. if( sqlite
1320: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1330: 49 6e 69 74 20 29 20 72 65 74 75 72 6e 20 53 51 Init ) return SQ
1340: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 4d LITE_OK;.. /* M
1350: 61 6b 65 20 73 75 72 65 20 74 68 65 20 6d 75 74 ake sure the mut
1360: 65 78 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 ex subsystem is
1370: 69 6e 69 74 69 61 6c 69 7a 65 64 2e 20 20 49 66 initialized. If
1380: 20 75 6e 61 62 6c 65 20 74 6f 20 0a 20 20 2a 2a unable to . **
1390: 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 initialize the
13a0: 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 6d 2c mutex subsystem,
13b0: 20 72 65 74 75 72 6e 20 65 61 72 6c 79 20 77 69 return early wi
13c0: 74 68 20 74 68 65 20 65 72 72 6f 72 2e 0a 20 20 th the error..
13d0: 2a 2a 20 49 66 20 74 68 65 20 73 79 73 74 65 6d ** If the system
13e0: 20 69 73 20 73 6f 20 73 69 63 6b 20 74 68 61 74 is so sick that
13f0: 20 77 65 20 61 72 65 20 75 6e 61 62 6c 65 20 74 we are unable t
1400: 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6d 75 74 o allocate a mut
1410: 65 78 2c 0a 20 20 2a 2a 20 74 68 65 72 65 20 69 ex,. ** there i
1420: 73 20 6e 6f 74 20 6d 75 63 68 20 53 51 4c 69 74 s not much SQLit
1430: 65 20 69 73 20 67 6f 69 6e 67 20 74 6f 20 62 65 e is going to be
1440: 20 61 62 6c 65 20 74 6f 20 64 6f 2e 0a 20 20 2a able to do.. *
1450: 2a 0a 20 20 2a 2a 20 54 68 65 20 6d 75 74 65 78 *. ** The mutex
1460: 20 73 75 62 73 79 73 74 65 6d 20 6d 75 73 74 20 subsystem must
1470: 74 61 6b 65 20 63 61 72 65 20 6f 66 20 73 65 72 take care of ser
1480: 69 61 6c 69 7a 69 6e 67 20 69 74 73 20 6f 77 6e ializing its own
1490: 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 61 . ** initializa
14a0: 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 tion.. */. rc
14b0: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 49 6e = sqlite3MutexIn
14c0: 69 74 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29 it();. if( rc )
14d0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f return rc;.. /
14e0: 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 * Initialize the
14f0: 20 6d 61 6c 6c 6f 63 28 29 20 73 79 73 74 65 6d malloc() system
1500: 20 61 6e 64 20 74 68 65 20 72 65 63 75 72 73 69 and the recursi
1510: 76 65 20 70 49 6e 69 74 4d 75 74 65 78 20 6d 75 ve pInitMutex mu
1520: 74 65 78 2e 0a 20 20 2a 2a 20 54 68 69 73 20 6f tex.. ** This o
1530: 70 65 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 74 peration is prot
1540: 65 63 74 65 64 20 62 79 20 74 68 65 20 53 54 41 ected by the STA
1550: 54 49 43 5f 4d 41 53 54 45 52 20 6d 75 74 65 78 TIC_MASTER mutex
1560: 2e 20 20 4e 6f 74 65 20 74 68 61 74 0a 20 20 2a . Note that. *
1570: 2a 20 4d 75 74 65 78 41 6c 6c 6f 63 28 29 20 69 * MutexAlloc() i
1580: 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 61 20 73 s called for a s
1590: 74 61 74 69 63 20 6d 75 74 65 78 20 70 72 69 6f tatic mutex prio
15a0: 72 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 69 6e r to initializin
15b0: 67 20 74 68 65 0a 20 20 2a 2a 20 6d 61 6c 6c 6f g the. ** mallo
15c0: 63 20 73 75 62 73 79 73 74 65 6d 20 2d 20 74 68 c subsystem - th
15d0: 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 is implies that
15e0: 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f the allocation o
15f0: 66 20 61 20 73 74 61 74 69 63 0a 20 20 2a 2a 20 f a static. **
1600: 6d 75 74 65 78 20 6d 75 73 74 20 6e 6f 74 20 72 mutex must not r
1610: 65 71 75 69 72 65 20 73 75 70 70 6f 72 74 20 66 equire support f
1620: 72 6f 6d 20 74 68 65 20 6d 61 6c 6c 6f 63 20 73 rom the malloc s
1630: 75 62 73 79 73 74 65 6d 2e 0a 20 20 2a 2f 0a 20 ubsystem.. */.
1640: 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 70 4d MUTEX_LOGIC( pM
1650: 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65 33 4d aster = sqlite3M
1660: 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 utexAlloc(SQLITE
1670: 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 _MUTEX_STATIC_MA
1680: 53 54 45 52 29 3b 20 29 0a 20 20 73 71 6c 69 74 STER); ). sqlit
1690: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
16a0: 4d 61 73 74 65 72 29 3b 0a 20 20 73 71 6c 69 74 Master);. sqlit
16b0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
16c0: 73 4d 75 74 65 78 49 6e 69 74 20 3d 20 31 3b 0a sMutexInit = 1;.
16d0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 47 6c if( !sqlite3Gl
16e0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c obalConfig.isMal
16f0: 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 20 20 20 72 locInit ){. r
1700: 63 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f c = sqlite3Mallo
1710: 63 49 6e 69 74 28 29 3b 0a 20 20 7d 0a 20 20 69 cInit();. }. i
1720: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1730: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 ){. sqlite3G
1740: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 lobalConfig.isMa
1750: 6c 6c 6f 63 49 6e 69 74 20 3d 20 31 3b 0a 20 20 llocInit = 1;.
1760: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 47 6c if( !sqlite3Gl
1770: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
1780: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 20 20 73 Mutex ){. s
1790: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
17a0: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 3d 0a ig.pInitMutex =.
17b0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
17c0: 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c e3MutexAlloc(SQL
17d0: 49 54 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 ITE_MUTEX_RECURS
17e0: 49 56 45 29 3b 0a 20 20 20 20 20 20 69 66 28 20 IVE);. if(
17f0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1800: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 26 fig.bCoreMutex &
1810: 26 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c & !sqlite3Global
1820: 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 Config.pInitMute
1830: 78 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 x ){. rc
1840: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a = SQLITE_NOMEM;.
1850: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1860: 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 }. if( rc==SQLI
1870: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
1880: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1890: 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 2b 2b .nRefInitMutex++
18a0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
18b0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 73 mutex_leave(pMas
18c0: 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 72 ter);.. /* If r
18d0: 63 20 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f c is not SQLITE_
18e0: 4f 4b 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 OK at this point
18f0: 2c 20 74 68 65 6e 20 65 69 74 68 65 72 20 74 68 , then either th
1900: 65 20 6d 61 6c 6c 6f 63 0a 20 20 2a 2a 20 73 75 e malloc. ** su
1910: 62 73 79 73 74 65 6d 20 63 6f 75 6c 64 20 6e 6f bsystem could no
1920: 74 20 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 t be initialized
1930: 20 6f 72 20 74 68 65 20 73 79 73 74 65 6d 20 66 or the system f
1940: 61 69 6c 65 64 20 74 6f 20 61 6c 6c 6f 63 61 74 ailed to allocat
1950: 65 0a 20 20 2a 2a 20 74 68 65 20 70 49 6e 69 74 e. ** the pInit
1960: 4d 75 74 65 78 20 6d 75 74 65 78 2e 20 52 65 74 Mutex mutex. Ret
1970: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 69 6e 20 urn an error in
1980: 65 69 74 68 65 72 20 63 61 73 65 2e 20 20 2a 2f either case. */
1990: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
19a0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 E_OK ){. retu
19b0: 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a rn rc;. }.. /*
19c0: 20 44 6f 20 74 68 65 20 72 65 73 74 20 6f 66 20 Do the rest of
19d0: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 the initializati
19e0: 6f 6e 20 75 6e 64 65 72 20 74 68 65 20 72 65 63 on under the rec
19f0: 75 72 73 69 76 65 20 6d 75 74 65 78 20 73 6f 0a ursive mutex so.
1a00: 20 20 2a 2a 20 74 68 61 74 20 77 65 20 77 69 6c ** that we wil
1a10: 6c 20 62 65 20 61 62 6c 65 20 74 6f 20 68 61 6e l be able to han
1a20: 64 6c 65 20 72 65 63 75 72 73 69 76 65 20 63 61 dle recursive ca
1a30: 6c 6c 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 73 71 lls into. ** sq
1a40: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
1a50: 28 29 2e 20 20 54 68 65 20 72 65 63 75 72 73 69 (). The recursi
1a60: 76 65 20 63 61 6c 6c 73 20 6e 6f 72 6d 61 6c 6c ve calls normall
1a70: 79 20 63 6f 6d 65 20 74 68 72 6f 75 67 68 0a 20 y come through.
1a80: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 73 5f 69 ** sqlite3_os_i
1a90: 6e 69 74 28 29 20 77 68 65 6e 20 69 74 20 69 6e nit() when it in
1aa0: 76 6f 6b 65 73 20 73 71 6c 69 74 65 33 5f 76 66 vokes sqlite3_vf
1ab0: 73 5f 72 65 67 69 73 74 65 72 28 29 2c 20 62 75 s_register(), bu
1ac0: 74 20 6f 74 68 65 72 0a 20 20 2a 2a 20 72 65 63 t other. ** rec
1ad0: 75 72 73 69 76 65 20 63 61 6c 6c 73 20 6d 69 67 ursive calls mig
1ae0: 68 74 20 61 6c 73 6f 20 62 65 20 70 6f 73 73 69 ht also be possi
1af0: 62 6c 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 ble.. **. ** I
1b00: 4d 50 4c 45 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 MPLEMENTATION-OF
1b10: 3a 20 52 2d 30 30 31 34 30 2d 33 37 34 34 35 20 : R-00140-37445
1b20: 53 51 4c 69 74 65 20 61 75 74 6f 6d 61 74 69 63 SQLite automatic
1b30: 61 6c 6c 79 20 73 65 72 69 61 6c 69 7a 65 73 20 ally serializes
1b40: 63 61 6c 6c 73 0a 20 20 2a 2a 20 74 6f 20 74 68 calls. ** to th
1b50: 65 20 78 49 6e 69 74 20 6d 65 74 68 6f 64 2c 20 e xInit method,
1b60: 73 6f 20 74 68 65 20 78 49 6e 69 74 20 6d 65 74 so the xInit met
1b70: 68 6f 64 20 6e 65 65 64 20 6e 6f 74 20 62 65 20 hod need not be
1b80: 74 68 72 65 61 64 73 61 66 65 2e 0a 20 20 2a 2a threadsafe.. **
1b90: 0a 20 20 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . ** The follow
1ba0: 69 6e 67 20 6d 75 74 65 78 20 69 73 20 77 68 61 ing mutex is wha
1bb0: 74 20 73 65 72 69 61 6c 69 7a 65 73 20 61 63 63 t serializes acc
1bc0: 65 73 73 20 74 6f 20 74 68 65 20 61 70 70 64 65 ess to the appde
1bd0: 66 20 70 63 61 63 68 65 20 78 49 6e 69 74 0a 20 f pcache xInit.
1be0: 20 2a 2a 20 6d 65 74 68 6f 64 73 2e 20 20 54 68 ** methods. Th
1bf0: 65 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 e sqlite3_pcache
1c00: 5f 6d 65 74 68 6f 64 73 2e 78 49 6e 69 74 28 29 _methods.xInit()
1c10: 20 61 6c 6c 20 69 73 20 65 6d 62 65 64 64 65 64 all is embedded
1c20: 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 63 61 6c in the. ** cal
1c30: 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 63 61 63 l to sqlite3Pcac
1c40: 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 2e 0a heInitialize()..
1c50: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d */. sqlite3_m
1c60: 75 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 utex_enter(sqlit
1c70: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
1c80: 49 6e 69 74 4d 75 74 65 78 29 3b 0a 20 20 69 66 InitMutex);. if
1c90: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
1ca0: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 3d 3d 30 20 onfig.isInit==0
1cb0: 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c && sqlite3Global
1cc0: 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 72 65 73 Config.inProgres
1cd0: 73 3d 3d 30 20 29 7b 0a 20 20 20 20 46 75 6e 63 s==0 ){. Func
1ce0: 44 65 66 48 61 73 68 20 2a 70 48 61 73 68 20 3d DefHash *pHash =
1cf0: 20 26 47 4c 4f 42 41 4c 28 46 75 6e 63 44 65 66 &GLOBAL(FuncDef
1d00: 48 61 73 68 2c 20 73 71 6c 69 74 65 33 47 6c 6f Hash, sqlite3Glo
1d10: 62 61 6c 46 75 6e 63 74 69 6f 6e 73 29 3b 0a 20 balFunctions);.
1d20: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
1d30: 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 72 65 73 Config.inProgres
1d40: 73 20 3d 20 31 3b 0a 20 20 20 20 6d 65 6d 73 65 s = 1;. memse
1d50: 74 28 70 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 t(pHash, 0, size
1d60: 6f 66 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c of(sqlite3Global
1d70: 46 75 6e 63 74 69 6f 6e 73 29 29 3b 0a 20 20 20 Functions));.
1d80: 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 sqlite3Register
1d90: 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 28 GlobalFunctions(
1da0: 29 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 );. if( sqlit
1db0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1dc0: 73 50 43 61 63 68 65 49 6e 69 74 3d 3d 30 20 29 sPCacheInit==0 )
1dd0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
1de0: 69 74 65 33 50 63 61 63 68 65 49 6e 69 74 69 61 ite3PcacheInitia
1df0: 6c 69 7a 65 28 29 3b 0a 20 20 20 20 7d 0a 20 20 lize();. }.
1e00: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1e10: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c _OK ){. sql
1e20: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1e30: 2e 69 73 50 43 61 63 68 65 49 6e 69 74 20 3d 20 .isPCacheInit =
1e40: 31 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 1;. rc = sq
1e50: 6c 69 74 65 33 4f 73 49 6e 69 74 28 29 3b 0a 20 lite3OsInit();.
1e60: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d }. if( rc=
1e70: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1e80: 20 20 20 20 73 71 6c 69 74 65 33 50 43 61 63 68 sqlite3PCach
1e90: 65 42 75 66 66 65 72 53 65 74 75 70 28 20 73 71 eBufferSetup( sq
1ea0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1eb0: 67 2e 70 50 61 67 65 2c 20 0a 20 20 20 20 20 20 g.pPage, .
1ec0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1ed0: 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 2c 20 lConfig.szPage,
1ee0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1ef0: 66 69 67 2e 6e 50 61 67 65 29 3b 0a 20 20 20 20 fig.nPage);.
1f00: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
1f10: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 3d 20 31 onfig.isInit = 1
1f20: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
1f30: 45 58 54 52 41 5f 49 4e 49 54 0a 20 20 20 20 20 EXTRA_INIT.
1f40: 20 62 52 75 6e 45 78 74 72 61 49 6e 69 74 20 3d bRunExtraInit =
1f50: 20 31 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 1;.#endif. }
1f60: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
1f70: 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f 67 72 alConfig.inProgr
1f80: 65 73 73 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 ess = 0;. }. s
1f90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1fa0: 76 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c ve(sqlite3Global
1fb0: 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 Config.pInitMute
1fc0: 78 29 3b 0a 0a 20 20 2f 2a 20 47 6f 20 62 61 63 x);.. /* Go bac
1fd0: 6b 20 75 6e 64 65 72 20 74 68 65 20 73 74 61 74 k under the stat
1fe0: 69 63 20 6d 75 74 65 78 20 61 6e 64 20 63 6c 65 ic mutex and cle
1ff0: 61 6e 20 75 70 20 74 68 65 20 72 65 63 75 72 73 an up the recurs
2000: 69 76 65 0a 20 20 2a 2a 20 6d 75 74 65 78 20 74 ive. ** mutex t
2010: 6f 20 70 72 65 76 65 6e 74 20 61 20 72 65 73 6f o prevent a reso
2020: 75 72 63 65 20 6c 65 61 6b 2e 0a 20 20 2a 2f 0a urce leak.. */.
2030: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
2040: 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a enter(pMaster);.
2050: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
2060: 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 onfig.nRefInitMu
2070: 74 65 78 2d 2d 3b 0a 20 20 69 66 28 20 73 71 6c tex--;. if( sql
2080: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2090: 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 3c 3d .nRefInitMutex<=
20a0: 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 0 ){. assert(
20b0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
20c0: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
20d0: 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c ex==0 );. sql
20e0: 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 ite3_mutex_free(
20f0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2100: 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b fig.pInitMutex);
2110: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
2120: 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 alConfig.pInitMu
2130: 74 65 78 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 tex = 0;. }. s
2140: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
2150: 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 ve(pMaster);..
2160: 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
2170: 20 69 73 20 6a 75 73 74 20 61 20 73 61 6e 69 74 is just a sanit
2180: 79 20 63 68 65 63 6b 20 74 6f 20 6d 61 6b 65 20 y check to make
2190: 73 75 72 65 20 53 51 4c 69 74 65 20 68 61 73 0a sure SQLite has.
21a0: 20 20 2a 2a 20 62 65 65 6e 20 63 6f 6d 70 69 6c ** been compil
21b0: 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 49 ed correctly. I
21c0: 74 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 t is important t
21d0: 6f 20 72 75 6e 20 74 68 69 73 20 63 6f 64 65 2c o run this code,
21e0: 20 62 75 74 0a 20 20 2a 2a 20 77 65 20 64 6f 6e but. ** we don
21f0: 27 74 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 69 't want to run i
2200: 74 20 74 6f 6f 20 6f 66 74 65 6e 20 61 6e 64 20 t too often and
2210: 73 6f 61 6b 20 75 70 20 43 50 55 20 63 79 63 6c soak up CPU cycl
2220: 65 73 20 66 6f 72 20 6e 6f 0a 20 20 2a 2a 20 72 es for no. ** r
2230: 65 61 73 6f 6e 2e 20 20 53 6f 20 77 65 20 72 75 eason. So we ru
2240: 6e 20 69 74 20 6f 6e 63 65 20 64 75 72 69 6e 67 n it once during
2250: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e initialization.
2260: 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 . */.#ifndef ND
2270: 45 42 55 47 0a 23 69 66 6e 64 65 66 20 53 51 4c EBUG.#ifndef SQL
2280: 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e ITE_OMIT_FLOATIN
2290: 47 5f 50 4f 49 4e 54 0a 20 20 2f 2a 20 54 68 69 G_POINT. /* Thi
22a0: 73 20 73 65 63 74 69 6f 6e 20 6f 66 20 63 6f 64 s section of cod
22b0: 65 27 73 20 6f 6e 6c 79 20 22 6f 75 74 70 75 74 e's only "output
22c0: 22 20 69 73 20 76 69 61 20 61 73 73 65 72 74 28 " is via assert(
22d0: 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 2a 2f ) statements. */
22e0: 0a 20 20 69 66 20 28 20 72 63 3d 3d 53 51 4c 49 . if ( rc==SQLI
22f0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 75 36 34 TE_OK ){. u64
2300: 20 78 20 3d 20 28 28 28 75 36 34 29 31 29 3c 3c x = (((u64)1)<<
2310: 36 33 29 2d 31 3b 0a 20 20 20 20 64 6f 75 62 6c 63)-1;. doubl
2320: 65 20 79 3b 0a 20 20 20 20 61 73 73 65 72 74 28 e y;. assert(
2330: 73 69 7a 65 6f 66 28 78 29 3d 3d 38 29 3b 0a 20 sizeof(x)==8);.
2340: 20 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 assert(sizeof
2350: 28 78 29 3d 3d 73 69 7a 65 6f 66 28 79 29 29 3b (x)==sizeof(y));
2360: 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 79 2c 20 . memcpy(&y,
2370: 26 78 2c 20 38 29 3b 0a 20 20 20 20 61 73 73 65 &x, 8);. asse
2380: 72 74 28 20 73 71 6c 69 74 65 33 49 73 4e 61 4e rt( sqlite3IsNaN
2390: 28 79 29 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 (y) );. }.#endi
23a0: 66 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 44 f.#endif.. /* D
23b0: 6f 20 65 78 74 72 61 20 69 6e 69 74 69 61 6c 69 o extra initiali
23c0: 7a 61 74 69 6f 6e 20 73 74 65 70 73 20 72 65 71 zation steps req
23d0: 75 65 73 74 65 64 20 62 79 20 74 68 65 20 53 51 uested by the SQ
23e0: 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a LITE_EXTRA_INIT.
23f0: 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d ** compile-tim
2400: 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 e option.. */.#
2410: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 58 54 ifdef SQLITE_EXT
2420: 52 41 5f 49 4e 49 54 0a 20 20 69 66 28 20 62 52 RA_INIT. if( bR
2430: 75 6e 45 78 74 72 61 49 6e 69 74 20 29 7b 0a 20 unExtraInit ){.
2440: 20 20 20 69 6e 74 20 53 51 4c 49 54 45 5f 45 58 int SQLITE_EX
2450: 54 52 41 5f 49 4e 49 54 28 63 6f 6e 73 74 20 63 TRA_INIT(const c
2460: 68 61 72 2a 29 3b 0a 20 20 20 20 72 63 20 3d 20 har*);. rc =
2470: 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 SQLITE_EXTRA_INI
2480: 54 28 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 T(0);. }.#endif
2490: 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
24a0: 0a 0a 2f 2a 0a 2a 2a 20 55 6e 64 6f 20 74 68 65 ../*.** Undo the
24b0: 20 65 66 66 65 63 74 73 20 6f 66 20 73 71 6c 69 effects of sqli
24c0: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
24d0: 2e 20 20 4d 75 73 74 20 6e 6f 74 20 62 65 20 63 . Must not be c
24e0: 61 6c 6c 65 64 20 77 68 69 6c 65 0a 2a 2a 20 74 alled while.** t
24f0: 68 65 72 65 20 61 72 65 20 6f 75 74 73 74 61 6e here are outstan
2500: 64 69 6e 67 20 64 61 74 61 62 61 73 65 20 63 6f ding database co
2510: 6e 6e 65 63 74 69 6f 6e 73 20 6f 72 20 6d 65 6d nnections or mem
2520: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 ory allocations
2530: 6f 72 0a 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 or.** while any
2540: 70 61 72 74 20 6f 66 20 53 51 4c 69 74 65 20 69 part of SQLite i
2550: 73 20 6f 74 68 65 72 77 69 73 65 20 69 6e 20 75 s otherwise in u
2560: 73 65 20 69 6e 20 61 6e 79 20 74 68 72 65 61 64 se in any thread
2570: 2e 20 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 . This.** routi
2580: 6e 65 20 69 73 20 6e 6f 74 20 74 68 72 65 61 64 ne is not thread
2590: 73 61 66 65 2e 20 20 42 75 74 20 69 74 20 69 73 safe. But it is
25a0: 20 73 61 66 65 20 74 6f 20 69 6e 76 6f 6b 65 20 safe to invoke
25b0: 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 this routine.**
25c0: 6f 6e 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 on when SQLite i
25d0: 73 20 61 6c 72 65 61 64 79 20 73 68 75 74 20 64 s already shut d
25e0: 6f 77 6e 2e 20 20 49 66 20 53 51 4c 69 74 65 20 own. If SQLite
25f0: 69 73 20 61 6c 72 65 61 64 79 20 73 68 75 74 20 is already shut
2600: 64 6f 77 6e 0a 2a 2a 20 77 68 65 6e 20 74 68 69 down.** when thi
2610: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 69 6e 76 s routine is inv
2620: 6f 6b 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 oked, then this
2630: 72 6f 75 74 69 6e 65 20 69 73 20 61 20 68 61 72 routine is a har
2640: 6d 6c 65 73 73 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a mless no-op..*/.
2650: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 68 75 74 int sqlite3_shut
2660: 64 6f 77 6e 28 76 6f 69 64 29 7b 0a 23 69 66 64 down(void){.#ifd
2670: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
2680: 53 44 0a 20 20 69 6e 74 20 72 63 20 3d 20 73 71 SD. int rc = sq
2690: 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 34 lite3_wsd_init(4
26a0: 30 39 36 2c 20 32 34 29 3b 0a 20 20 69 66 28 20 096, 24);. if(
26b0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
26c0: 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a . return rc;.
26d0: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 }.#endif.. if
26e0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
26f0: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 7b 0a onfig.isInit ){.
2700: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 58 #ifdef SQLITE_EX
2710: 54 52 41 5f 53 48 55 54 44 4f 57 4e 0a 20 20 20 TRA_SHUTDOWN.
2720: 20 76 6f 69 64 20 53 51 4c 49 54 45 5f 45 58 54 void SQLITE_EXT
2730: 52 41 5f 53 48 55 54 44 4f 57 4e 28 76 6f 69 64 RA_SHUTDOWN(void
2740: 29 3b 0a 20 20 20 20 53 51 4c 49 54 45 5f 45 58 );. SQLITE_EX
2750: 54 52 41 5f 53 48 55 54 44 4f 57 4e 28 29 3b 0a TRA_SHUTDOWN();.
2760: 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 #endif. sqlit
2770: 65 33 5f 6f 73 5f 65 6e 64 28 29 3b 0a 20 20 20 e3_os_end();.
2780: 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 5f 61 sqlite3_reset_a
2790: 75 74 6f 5f 65 78 74 65 6e 73 69 6f 6e 28 29 3b uto_extension();
27a0: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
27b0: 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 alConfig.isInit
27c0: 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 = 0;. }. if( s
27d0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
27e0: 69 67 2e 69 73 50 43 61 63 68 65 49 6e 69 74 20 ig.isPCacheInit
27f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 63 ){. sqlite3Pc
2800: 61 63 68 65 53 68 75 74 64 6f 77 6e 28 29 3b 0a acheShutdown();.
2810: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
2820: 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 lConfig.isPCache
2830: 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Init = 0;. }.
2840: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
2850: 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 lConfig.isMalloc
2860: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
2870: 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 29 3b 0a te3MallocEnd();.
2880: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
2890: 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 lConfig.isMalloc
28a0: 49 6e 69 74 20 3d 20 30 3b 0a 0a 23 69 66 6e 64 Init = 0;..#ifnd
28b0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
28c0: 48 55 54 44 4f 57 4e 5f 44 49 52 45 43 54 4f 52 HUTDOWN_DIRECTOR
28d0: 49 45 53 0a 20 20 20 20 2f 2a 20 54 68 65 20 68 IES. /* The h
28e0: 65 61 70 20 73 75 62 73 79 73 74 65 6d 20 68 61 eap subsystem ha
28f0: 73 20 6e 6f 77 20 62 65 65 6e 20 73 68 75 74 64 s now been shutd
2900: 6f 77 6e 20 61 6e 64 20 74 68 65 73 65 20 76 61 own and these va
2910: 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f 73 65 lues are suppose
2920: 64 0a 20 20 20 20 2a 2a 20 74 6f 20 62 65 20 4e d. ** to be N
2930: 55 4c 4c 20 6f 72 20 70 6f 69 6e 74 20 74 6f 20 ULL or point to
2940: 6d 65 6d 6f 72 79 20 74 68 61 74 20 77 61 73 20 memory that was
2950: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 obtained from sq
2960: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2c 0a lite3_malloc(),.
2970: 20 20 20 20 2a 2a 20 77 68 69 63 68 20 77 6f 75 ** which wou
2980: 6c 64 20 72 65 6c 79 20 6f 6e 20 74 68 61 74 20 ld rely on that
2990: 68 65 61 70 20 73 75 62 73 79 73 74 65 6d 3b 20 heap subsystem;
29a0: 74 68 65 72 65 66 6f 72 65 2c 20 6d 61 6b 65 20 therefore, make
29b0: 73 75 72 65 20 74 68 65 73 65 0a 20 20 20 20 2a sure these. *
29c0: 2a 20 76 61 6c 75 65 73 20 63 61 6e 6e 6f 74 20 * values cannot
29d0: 72 65 66 65 72 20 74 6f 20 68 65 61 70 20 6d 65 refer to heap me
29e0: 6d 6f 72 79 20 74 68 61 74 20 77 61 73 20 6a 75 mory that was ju
29f0: 73 74 20 69 6e 76 61 6c 69 64 61 74 65 64 20 77 st invalidated w
2a00: 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 68 hen the. ** h
2a10: 65 61 70 20 73 75 62 73 79 73 74 65 6d 20 77 61 eap subsystem wa
2a20: 73 20 73 68 75 74 64 6f 77 6e 2e 20 20 54 68 69 s shutdown. Thi
2a30: 73 20 69 73 20 6f 6e 6c 79 20 64 6f 6e 65 20 69 s is only done i
2a40: 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 61 f the current ca
2a50: 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 74 68 69 ll to. ** thi
2a60: 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 73 75 6c s function resul
2a70: 74 65 64 20 69 6e 20 74 68 65 20 68 65 61 70 20 ted in the heap
2a80: 73 75 62 73 79 73 74 65 6d 20 61 63 74 75 61 6c subsystem actual
2a90: 6c 79 20 62 65 69 6e 67 20 73 68 75 74 64 6f 77 ly being shutdow
2aa0: 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 71 n.. */. sq
2ab0: 6c 69 74 65 33 5f 64 61 74 61 5f 64 69 72 65 63 lite3_data_direc
2ac0: 74 6f 72 79 20 3d 20 30 3b 0a 20 20 20 20 73 71 tory = 0;. sq
2ad0: 6c 69 74 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 lite3_temp_direc
2ae0: 74 6f 72 79 20 3d 20 30 3b 0a 23 65 6e 64 69 66 tory = 0;.#endif
2af0: 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 . }. if( sqlit
2b00: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
2b10: 73 4d 75 74 65 78 49 6e 69 74 20 29 7b 0a 20 20 sMutexInit ){.
2b20: 20 20 73 71 6c 69 74 65 33 4d 75 74 65 78 45 6e sqlite3MutexEn
2b30: 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 d();. sqlite3
2b40: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
2b50: 75 74 65 78 49 6e 69 74 20 3d 20 30 3b 0a 20 20 utexInit = 0;.
2b60: 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }.. return SQLI
2b70: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
2b80: 54 68 69 73 20 41 50 49 20 61 6c 6c 6f 77 73 20 This API allows
2b90: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 6f 20 applications to
2ba0: 6d 6f 64 69 66 79 20 74 68 65 20 67 6c 6f 62 61 modify the globa
2bb0: 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 l configuration
2bc0: 6f 66 0a 2a 2a 20 74 68 65 20 53 51 4c 69 74 65 of.** the SQLite
2bd0: 20 6c 69 62 72 61 72 79 20 61 74 20 72 75 6e 2d library at run-
2be0: 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 time..**.** This
2bf0: 20 72 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 routine should
2c00: 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 77 only be called w
2c10: 68 65 6e 20 74 68 65 72 65 20 61 72 65 20 6e 6f hen there are no
2c20: 20 6f 75 74 73 74 61 6e 64 69 6e 67 0a 2a 2a 20 outstanding.**
2c30: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
2c40: 69 6f 6e 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 ions or memory a
2c50: 6c 6c 6f 63 61 74 69 6f 6e 73 2e 20 20 54 68 69 llocations. Thi
2c60: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 s routine is not
2c70: 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2e 20 .** threadsafe.
2c80: 20 46 61 69 6c 75 72 65 20 74 6f 20 68 65 65 64 Failure to heed
2c90: 20 74 68 65 73 65 20 77 61 72 6e 69 6e 67 73 20 these warnings
2ca0: 63 61 6e 20 6c 65 61 64 20 74 6f 20 75 6e 70 72 can lead to unpr
2cb0: 65 64 69 63 74 61 62 6c 65 0a 2a 2a 20 62 65 68 edictable.** beh
2cc0: 61 76 69 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 avior..*/.int sq
2cd0: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 69 6e 74 lite3_config(int
2ce0: 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f op, ...){. va_
2cf0: 6c 69 73 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 list ap;. int r
2d00: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a c = SQLITE_OK;..
2d10: 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e /* sqlite3_con
2d20: 66 69 67 28 29 20 73 68 61 6c 6c 20 72 65 74 75 fig() shall retu
2d30: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
2d40: 20 69 66 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 if it is invoke
2d50: 64 20 77 68 69 6c 65 0a 20 20 2a 2a 20 74 68 65 d while. ** the
2d60: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 SQLite library
2d70: 69 73 20 69 6e 20 75 73 65 2e 20 2a 2f 0a 20 20 is in use. */.
2d80: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
2d90: 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 lConfig.isInit )
2da0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
2db0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 0a 20 20 76 ISUSE_BKPT;.. v
2dc0: 61 5f 73 74 61 72 74 28 61 70 2c 20 6f 70 29 3b a_start(ap, op);
2dd0: 0a 20 20 73 77 69 74 63 68 28 20 6f 70 20 29 7b . switch( op ){
2de0: 0a 0a 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 63 .. /* Mutex c
2df0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 onfiguration opt
2e00: 69 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 20 61 76 ions are only av
2e10: 61 69 6c 61 62 6c 65 20 69 6e 20 61 20 74 68 72 ailable in a thr
2e20: 65 61 64 73 61 66 65 0a 20 20 20 20 2a 2a 20 63 eadsafe. ** c
2e30: 6f 6d 70 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 23 ompile.. */.#
2e40: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
2e50: 45 5f 54 48 52 45 41 44 53 41 46 45 29 20 26 26 E_THREADSAFE) &&
2e60: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
2e70: 46 45 3e 30 20 20 2f 2a 20 49 4d 50 3a 20 52 2d FE>0 /* IMP: R-
2e80: 35 34 34 36 36 2d 34 36 37 35 36 20 2a 2f 0a 20 54466-46756 */.
2e90: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
2ea0: 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 ONFIG_SINGLETHRE
2eb0: 41 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 AD: {. /* E
2ec0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 32 VIDENCE-OF: R-02
2ed0: 37 34 38 2d 31 39 30 39 36 20 54 68 69 73 20 6f 748-19096 This o
2ee0: 70 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 74 ption sets the t
2ef0: 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 20 74 6f hreading mode to
2f00: 0a 20 20 20 20 20 20 2a 2a 20 53 69 6e 67 6c 65 . ** Single
2f10: 2d 74 68 72 65 61 64 2e 20 2a 2f 0a 20 20 20 20 -thread. */.
2f20: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
2f30: 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
2f40: 20 3d 20 30 3b 20 20 2f 2a 20 44 69 73 61 62 6c = 0; /* Disabl
2f50: 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f 72 65 20 e mutex on core
2f60: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
2f70: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 GlobalConfig.bFu
2f80: 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 20 20 2f 2a llMutex = 0; /*
2f90: 20 44 69 73 61 62 6c 65 20 6d 75 74 65 78 20 6f Disable mutex o
2fa0: 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f n connections */
2fb0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
2fc0: 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 }.#endif.#if d
2fd0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 efined(SQLITE_TH
2fe0: 52 45 41 44 53 41 46 45 29 20 26 26 20 53 51 4c READSAFE) && SQL
2ff0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 ITE_THREADSAFE>0
3000: 20 2f 2a 20 49 4d 50 3a 20 52 2d 32 30 35 32 30 /* IMP: R-20520
3010: 2d 35 34 30 38 36 20 2a 2f 0a 20 20 20 20 63 61 -54086 */. ca
3020: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
3030: 5f 4d 55 4c 54 49 54 48 52 45 41 44 3a 20 7b 0a _MULTITHREAD: {.
3040: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
3050: 45 2d 4f 46 3a 20 52 2d 31 34 33 37 34 2d 34 32 E-OF: R-14374-42
3060: 34 36 38 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 468 This option
3070: 73 65 74 73 20 74 68 65 20 74 68 72 65 61 64 69 sets the threadi
3080: 6e 67 20 6d 6f 64 65 20 74 6f 0a 20 20 20 20 20 ng mode to.
3090: 20 2a 2a 20 4d 75 6c 74 69 2d 74 68 72 65 61 64 ** Multi-thread
30a0: 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 . */. sqlit
30b0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
30c0: 43 6f 72 65 4d 75 74 65 78 20 3d 20 31 3b 20 20 CoreMutex = 1;
30d0: 2f 2a 20 45 6e 61 62 6c 65 20 6d 75 74 65 78 20 /* Enable mutex
30e0: 6f 6e 20 63 6f 72 65 20 2a 2f 0a 20 20 20 20 20 on core */.
30f0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3100: 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 20 nfig.bFullMutex
3110: 3d 20 30 3b 20 20 2f 2a 20 44 69 73 61 62 6c 65 = 0; /* Disable
3120: 20 6d 75 74 65 78 20 6f 6e 20 63 6f 6e 6e 65 63 mutex on connec
3130: 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 62 tions */. b
3140: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 reak;. }.#end
3150: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
3160: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
3170: 29 20 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 ) && SQLITE_THRE
3180: 41 44 53 41 46 45 3e 30 20 2f 2a 20 49 4d 50 3a ADSAFE>0 /* IMP:
3190: 20 52 2d 35 39 35 39 33 2d 32 31 38 31 30 20 2a R-59593-21810 *
31a0: 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
31b0: 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 41 4c 49 E_CONFIG_SERIALI
31c0: 5a 45 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 ZED: {. /*
31d0: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 EVIDENCE-OF: R-4
31e0: 31 32 32 30 2d 35 31 38 30 30 20 54 68 69 73 20 1220-51800 This
31f0: 6f 70 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20 option sets the
3200: 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 20 74 threading mode t
3210: 6f 0a 20 20 20 20 20 20 2a 2a 20 53 65 72 69 61 o. ** Seria
3220: 6c 69 7a 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 lized. */.
3230: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3240: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d fig.bCoreMutex =
3250: 20 31 3b 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6d 1; /* Enable m
3260: 75 74 65 78 20 6f 6e 20 63 6f 72 65 20 2a 2f 0a utex on core */.
3270: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3280: 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d balConfig.bFullM
3290: 75 74 65 78 20 3d 20 31 3b 20 20 2f 2a 20 45 6e utex = 1; /* En
32a0: 61 62 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f able mutex on co
32b0: 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 nnections */.
32c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
32d0: 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
32e0: 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ed(SQLITE_THREAD
32f0: 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f SAFE) && SQLITE_
3300: 54 48 52 45 41 44 53 41 46 45 3e 30 20 2f 2a 20 THREADSAFE>0 /*
3310: 49 4d 50 3a 20 52 2d 36 33 36 36 36 2d 34 38 37 IMP: R-63666-487
3320: 35 35 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 55 */. case S
3330: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 54 QLITE_CONFIG_MUT
3340: 45 58 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 53 EX: {. /* S
3350: 70 65 63 69 66 79 20 61 6e 20 61 6c 74 65 72 6e pecify an altern
3360: 61 74 69 76 65 20 6d 75 74 65 78 20 69 6d 70 6c ative mutex impl
3370: 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 ementation */.
3380: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3390: 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 20 3d 20 lConfig.mutex =
33a0: 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 *va_arg(ap, sqli
33b0: 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 te3_mutex_method
33c0: 73 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b s*);. break
33d0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 ;. }.#endif.#
33e0: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
33f0: 45 5f 54 48 52 45 41 44 53 41 46 45 29 20 26 26 E_THREADSAFE) &&
3400: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
3410: 46 45 3e 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 31 FE>0 /* IMP: R-1
3420: 34 34 35 30 2d 33 37 35 39 37 20 2a 2f 0a 20 20 4450-37597 */.
3430: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
3440: 4e 46 49 47 5f 47 45 54 4d 55 54 45 58 3a 20 7b NFIG_GETMUTEX: {
3450: 0a 20 20 20 20 20 20 2f 2a 20 52 65 74 72 69 65 . /* Retrie
3460: 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d ve the current m
3470: 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 74 utex implementat
3480: 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 2a 76 61 ion */. *va
3490: 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 _arg(ap, sqlite3
34a0: 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 2a 29 _mutex_methods*)
34b0: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c = sqlite3Global
34c0: 43 6f 6e 66 69 67 2e 6d 75 74 65 78 3b 0a 20 20 Config.mutex;.
34d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
34e0: 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 .#endif.. cas
34f0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3500: 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 20 20 20 MALLOC: {.
3510: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
3520: 52 2d 35 35 35 39 34 2d 32 31 30 33 30 20 54 68 R-55594-21030 Th
3530: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
3540: 4d 41 4c 4c 4f 43 20 6f 70 74 69 6f 6e 20 74 61 MALLOC option ta
3550: 6b 65 73 20 61 0a 20 20 20 20 20 20 2a 2a 20 73 kes a. ** s
3560: 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 ingle argument w
3570: 68 69 63 68 20 69 73 20 61 20 70 6f 69 6e 74 65 hich is a pointe
3580: 72 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 r to an instance
3590: 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a of the. **
35a0: 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 sqlite3_mem_met
35b0: 68 6f 64 73 20 73 74 72 75 63 74 75 72 65 2e 20 hods structure.
35c0: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 73 70 65 The argument spe
35d0: 63 69 66 69 65 73 20 61 6c 74 65 72 6e 61 74 69 cifies alternati
35e0: 76 65 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 77 2d ve. ** low-
35f0: 6c 65 76 65 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c level memory all
3600: 6f 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 73 ocation routines
3610: 20 74 6f 20 62 65 20 75 73 65 64 20 69 6e 20 70 to be used in p
3620: 6c 61 63 65 20 6f 66 20 74 68 65 20 6d 65 6d 6f lace of the memo
3630: 72 79 0a 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f ry. ** allo
3640: 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 73 20 cation routines
3650: 62 75 69 6c 74 20 69 6e 74 6f 20 53 51 4c 69 74 built into SQLit
3660: 65 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 e. */. sqli
3670: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
3680: 6d 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 m = *va_arg(ap,
3690: 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
36a0: 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 ods*);. bre
36b0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 ak;. }. ca
36c0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
36d0: 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 _GETMALLOC: {.
36e0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
36f0: 4f 46 3a 20 52 2d 35 31 32 31 33 2d 34 36 34 31 OF: R-51213-4641
3700: 34 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 4 The SQLITE_CON
3710: 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 20 6f 70 FIG_GETMALLOC op
3720: 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 tion takes a.
3730: 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 ** single arg
3740: 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 61 ument which is a
3750: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 pointer to an i
3760: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 0a 20 nstance of the.
3770: 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f ** sqlite3_
3780: 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 73 74 72 75 mem_methods stru
3790: 63 74 75 72 65 2e 20 54 68 65 20 73 71 6c 69 74 cture. The sqlit
37a0: 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 73 e3_mem_methods s
37b0: 74 72 75 63 74 75 72 65 20 69 73 0a 20 20 20 20 tructure is.
37c0: 20 20 2a 2a 20 66 69 6c 6c 65 64 20 77 69 74 68 ** filled with
37d0: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 64 the currently d
37e0: 65 66 69 6e 65 64 20 6d 65 6d 6f 72 79 20 61 6c efined memory al
37f0: 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 location routine
3800: 73 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 s. */. if(
3810: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3820: 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 3d 3d 30 fig.m.xMalloc==0
3830: 20 29 20 73 71 6c 69 74 65 33 4d 65 6d 53 65 74 ) sqlite3MemSet
3840: 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 20 20 20 Default();.
3850: 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c *va_arg(ap, sql
3860: 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 ite3_mem_methods
3870: 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 *) = sqlite3Glob
3880: 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a 20 20 20 20 alConfig.m;.
3890: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
38a0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
38b0: 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 55 53 3a ONFIG_MEMSTATUS:
38c0: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 {. /* EVID
38d0: 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 31 32 37 35 ENCE-OF: R-61275
38e0: 2d 33 35 31 35 37 20 54 68 65 20 53 51 4c 49 54 -35157 The SQLIT
38f0: 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 E_CONFIG_MEMSTAT
3900: 55 53 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 0a US option takes.
3910: 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 ** single
3920: 61 72 67 75 6d 65 6e 74 20 6f 66 20 74 79 70 65 argument of type
3930: 20 69 6e 74 2c 20 69 6e 74 65 72 70 72 65 74 65 int, interprete
3940: 64 20 61 73 20 61 20 62 6f 6f 6c 65 61 6e 2c 20 d as a boolean,
3950: 77 68 69 63 68 20 65 6e 61 62 6c 65 73 0a 20 20 which enables.
3960: 20 20 20 20 2a 2a 20 6f 72 20 64 69 73 61 62 6c ** or disabl
3970: 65 73 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f es the collectio
3980: 6e 20 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f n of memory allo
3990: 63 61 74 69 6f 6e 20 73 74 61 74 69 73 74 69 63 cation statistic
39a0: 73 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 s. */. sqli
39b0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
39c0: 62 4d 65 6d 73 74 61 74 20 3d 20 76 61 5f 61 72 bMemstat = va_ar
39d0: 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
39e0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
39f0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
3a00: 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 3a 20 7b ONFIG_SCRATCH: {
3a10: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
3a20: 43 45 2d 4f 46 3a 20 52 2d 30 38 34 30 34 2d 36 CE-OF: R-08404-6
3a30: 30 38 38 37 20 54 68 65 72 65 20 61 72 65 20 74 0887 There are t
3a40: 68 72 65 65 20 61 72 67 75 6d 65 6e 74 73 20 74 hree arguments t
3a50: 6f 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c 49 54 o. ** SQLIT
3a60: 45 5f 43 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 E_CONFIG_SCRATCH
3a70: 3a 20 41 20 70 6f 69 6e 74 65 72 20 61 6e 20 38 : A pointer an 8
3a80: 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 20 6d 65 -byte aligned me
3a90: 6d 6f 72 79 20 62 75 66 66 65 72 20 66 72 6f 6d mory buffer from
3aa0: 0a 20 20 20 20 20 20 2a 2a 20 77 68 69 63 68 20 . ** which
3ab0: 74 68 65 20 73 63 72 61 74 63 68 20 61 6c 6c 6f the scratch allo
3ac0: 63 61 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 cations will be
3ad0: 64 72 61 77 6e 2c 20 74 68 65 20 73 69 7a 65 20 drawn, the size
3ae0: 6f 66 20 65 61 63 68 20 73 63 72 61 74 63 68 0a of each scratch.
3af0: 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 ** allocat
3b00: 69 6f 6e 20 28 73 7a 29 2c 20 61 6e 64 20 74 68 ion (sz), and th
3b10: 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 e maximum number
3b20: 20 6f 66 20 73 63 72 61 74 63 68 20 61 6c 6c 6f of scratch allo
3b30: 63 61 74 69 6f 6e 73 20 28 4e 29 2e 20 2a 2f 0a cations (N). */.
3b40: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3b50: 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 61 74 balConfig.pScrat
3b60: 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ch = va_arg(ap,
3b70: 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 void*);. sq
3b80: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3b90: 67 2e 73 7a 53 63 72 61 74 63 68 20 3d 20 76 61 g.szScratch = va
3ba0: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
3bb0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
3bc0: 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72 61 74 63 alConfig.nScratc
3bd0: 68 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 h = va_arg(ap, i
3be0: 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nt);. break
3bf0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 ;. }. case
3c00: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
3c10: 41 47 45 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 AGECACHE: {.
3c20: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
3c30: 3a 20 52 2d 33 31 34 30 38 2d 34 30 35 31 30 20 : R-31408-40510
3c40: 54 68 65 72 65 20 61 72 65 20 74 68 72 65 65 20 There are three
3c50: 61 72 67 75 6d 65 6e 74 73 20 74 6f 0a 20 20 20 arguments to.
3c60: 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e ** SQLITE_CON
3c70: 46 49 47 5f 50 41 47 45 43 41 43 48 45 3a 20 41 FIG_PAGECACHE: A
3c80: 20 70 6f 69 6e 74 65 72 20 74 6f 20 38 2d 62 79 pointer to 8-by
3c90: 74 65 20 61 6c 69 67 6e 65 64 20 6d 65 6d 6f 72 te aligned memor
3ca0: 79 2c 20 74 68 65 20 73 69 7a 65 0a 20 20 20 20 y, the size.
3cb0: 20 20 2a 2a 20 6f 66 20 65 61 63 68 20 70 61 67 ** of each pag
3cc0: 65 20 62 75 66 66 65 72 20 28 73 7a 29 2c 20 61 e buffer (sz), a
3cd0: 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 nd the number of
3ce0: 20 70 61 67 65 73 20 28 4e 29 2e 20 2a 2f 0a 20 pages (N). */.
3cf0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
3d00: 61 6c 43 6f 6e 66 69 67 2e 70 50 61 67 65 20 3d alConfig.pPage =
3d10: 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 va_arg(ap, void
3d20: 2a 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 *);. sqlite
3d30: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
3d40: 50 61 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 Page = va_arg(ap
3d50: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 , int);. sq
3d60: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3d70: 67 2e 6e 50 61 67 65 20 3d 20 76 61 5f 61 72 67 g.nPage = va_arg
3d80: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
3d90: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
3da0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
3db0: 4e 46 49 47 5f 50 43 41 43 48 45 5f 48 44 52 53 NFIG_PCACHE_HDRS
3dc0: 5a 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 Z: {. /* EV
3dd0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 39 31 IDENCE-OF: R-391
3de0: 30 30 2d 32 37 33 31 37 20 54 68 65 20 53 51 4c 00-27317 The SQL
3df0: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 ITE_CONFIG_PCACH
3e00: 45 5f 48 44 52 53 5a 20 6f 70 74 69 6f 6e 20 74 E_HDRSZ option t
3e10: 61 6b 65 73 0a 20 20 20 20 20 20 2a 2a 20 61 20 akes. ** a
3e20: 73 69 6e 67 6c 65 20 70 61 72 61 6d 65 74 65 72 single parameter
3e30: 20 77 68 69 63 68 20 69 73 20 61 20 70 6f 69 6e which is a poin
3e40: 74 65 72 20 74 6f 20 61 6e 20 69 6e 74 65 67 65 ter to an intege
3e50: 72 20 61 6e 64 20 77 72 69 74 65 73 20 69 6e 74 r and writes int
3e60: 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20 o. ** that
3e70: 69 6e 74 65 67 65 72 20 74 68 65 20 6e 75 6d 62 integer the numb
3e80: 65 72 20 6f 66 20 65 78 74 72 61 20 62 79 74 65 er of extra byte
3e90: 73 20 70 65 72 20 70 61 67 65 20 72 65 71 75 69 s per page requi
3ea0: 72 65 64 20 66 6f 72 20 65 61 63 68 20 70 61 67 red for each pag
3eb0: 65 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 53 51 e. ** in SQ
3ec0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45 LITE_CONFIG_PAGE
3ed0: 43 41 43 48 45 2e 20 2a 2f 0a 20 20 20 20 20 20 CACHE. */.
3ee0: 2a 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 2a *va_arg(ap, int*
3ef0: 29 20 3d 20 0a 20 20 20 20 20 20 20 20 20 20 73 ) = . s
3f00: 71 6c 69 74 65 33 48 65 61 64 65 72 53 69 7a 65 qlite3HeaderSize
3f10: 42 74 72 65 65 28 29 20 2b 0a 20 20 20 20 20 20 Btree() +.
3f20: 20 20 20 20 73 71 6c 69 74 65 33 48 65 61 64 65 sqlite3Heade
3f30: 72 53 69 7a 65 50 63 61 63 68 65 28 29 20 2b 0a rSizePcache() +.
3f40: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
3f50: 33 48 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 3HeaderSizePcach
3f60: 65 31 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 e1();. brea
3f70: 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 k;. }.. ca
3f80: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
3f90: 5f 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 _PCACHE: {.
3fa0: 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 20 20 20 /* no-op */.
3fb0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
3fc0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
3fd0: 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 48 45 CONFIG_GETPCACHE
3fe0: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 6e 6f 77 : {. /* now
3ff0: 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 20 an error */.
4000: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 rc = SQLITE_E
4010: 52 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 65 61 RROR;. brea
4020: 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 k;. }.. ca
4030: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
4040: 5f 50 43 41 43 48 45 32 3a 20 7b 0a 20 20 20 20 _PCACHE2: {.
4050: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
4060: 3a 20 52 2d 36 33 33 32 35 2d 34 38 33 37 38 20 : R-63325-48378
4070: 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 The SQLITE_CONFI
4080: 47 5f 50 43 41 43 48 45 32 20 6f 70 74 69 6f 6e G_PCACHE2 option
4090: 20 74 61 6b 65 73 20 61 0a 20 20 20 20 20 20 2a takes a. *
40a0: 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e * single argumen
40b0: 74 20 77 68 69 63 68 20 69 73 20 61 20 70 6f 69 t which is a poi
40c0: 6e 74 65 72 20 74 6f 20 61 6e 20 73 71 6c 69 74 nter to an sqlit
40d0: 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 e3_pcache_method
40e0: 73 32 0a 20 20 20 20 20 20 2a 2a 20 6f 62 6a 65 s2. ** obje
40f0: 63 74 2e 20 54 68 69 73 20 6f 62 6a 65 63 74 20 ct. This object
4100: 73 70 65 63 69 66 69 65 73 20 74 68 65 20 69 6e specifies the in
4110: 74 65 72 66 61 63 65 20 74 6f 20 61 20 63 75 73 terface to a cus
4120: 74 6f 6d 20 70 61 67 65 20 63 61 63 68 65 0a 20 tom page cache.
4130: 20 20 20 20 20 2a 2a 20 69 6d 70 6c 65 6d 65 6e ** implemen
4140: 74 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20 20 20 tation. */.
4150: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
4160: 6e 66 69 67 2e 70 63 61 63 68 65 32 20 3d 20 2a nfig.pcache2 = *
4170: 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 va_arg(ap, sqlit
4180: 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 e3_pcache_method
4190: 73 32 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 61 s2*);. brea
41a0: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 k;. }. cas
41b0: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
41c0: 47 45 54 50 43 41 43 48 45 32 3a 20 7b 0a 20 20 GETPCACHE2: {.
41d0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
41e0: 4f 46 3a 20 52 2d 32 32 30 33 35 2d 34 36 31 38 OF: R-22035-4618
41f0: 32 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 2 The SQLITE_CON
4200: 46 49 47 5f 47 45 54 50 43 41 43 48 45 32 20 6f FIG_GETPCACHE2 o
4210: 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 ption takes a.
4220: 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 ** single ar
4230: 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 gument which is
4240: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 a pointer to an
4250: 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d sqlite3_pcache_m
4260: 65 74 68 6f 64 73 32 0a 20 20 20 20 20 20 2a 2a ethods2. **
4270: 20 6f 62 6a 65 63 74 2e 20 53 51 4c 69 74 65 20 object. SQLite
4280: 63 6f 70 69 65 73 20 6f 66 20 74 68 65 20 63 75 copies of the cu
4290: 72 72 65 6e 74 20 70 61 67 65 20 63 61 63 68 65 rrent page cache
42a0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
42b0: 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 into. ** th
42c0: 61 74 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20 20 at object. */.
42d0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 if( sqlite3G
42e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 63 61 63 lobalConfig.pcac
42f0: 68 65 32 2e 78 49 6e 69 74 3d 3d 30 20 29 7b 0a he2.xInit==0 ){.
4300: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 sqlite3P
4310: 43 61 63 68 65 53 65 74 44 65 66 61 75 6c 74 28 CacheSetDefault(
4320: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
4330: 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c *va_arg(ap, sql
4340: 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 ite3_pcache_meth
4350: 6f 64 73 32 2a 29 20 3d 20 73 71 6c 69 74 65 33 ods2*) = sqlite3
4360: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 63 61 GlobalConfig.pca
4370: 63 68 65 32 3b 0a 20 20 20 20 20 20 62 72 65 61 che2;. brea
4380: 6b 3b 0a 20 20 20 20 7d 0a 0a 2f 2a 20 45 56 49 k;. }../* EVI
4390: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 36 36 32 DENCE-OF: R-0662
43a0: 36 2d 31 32 39 31 31 20 54 68 65 20 53 51 4c 49 6-12911 The SQLI
43b0: 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 20 6f TE_CONFIG_HEAP o
43c0: 70 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 0a 2a 2a ption is only.**
43d0: 20 61 76 61 69 6c 61 62 6c 65 20 69 66 20 53 51 available if SQ
43e0: 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64 Lite is compiled
43f0: 20 77 69 74 68 20 65 69 74 68 65 72 20 53 51 4c with either SQL
4400: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4410: 53 33 20 6f 72 0a 2a 2a 20 53 51 4c 49 54 45 5f S3 or.** SQLITE_
4420: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 20 61 ENABLE_MEMSYS5 a
4430: 6e 64 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 nd returns SQLIT
4440: 45 5f 45 52 52 4f 52 20 69 66 20 69 6e 76 6f 6b E_ERROR if invok
4450: 65 64 20 6f 74 68 65 72 77 69 73 65 2e 20 2a 2f ed otherwise. */
4460: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
4470: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4480: 53 33 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 S3) || defined(S
4490: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d QLITE_ENABLE_MEM
44a0: 53 59 53 35 29 0a 20 20 20 20 63 61 73 65 20 53 SYS5). case S
44b0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 QLITE_CONFIG_HEA
44c0: 50 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 P: {. /* EV
44d0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 39 38 IDENCE-OF: R-198
44e0: 35 34 2d 34 32 31 32 36 20 54 68 65 72 65 20 61 54-42126 There a
44f0: 72 65 20 74 68 72 65 65 20 61 72 67 75 6d 65 6e re three argumen
4500: 74 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 ts to. ** S
4510: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 QLITE_CONFIG_HEA
4520: 50 3a 20 41 6e 20 38 2d 62 79 74 65 20 61 6c 69 P: An 8-byte ali
4530: 67 6e 65 64 20 70 6f 69 6e 74 65 72 20 74 6f 20 gned pointer to
4540: 74 68 65 20 6d 65 6d 6f 72 79 2c 20 74 68 65 0a the memory, the.
4550: 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 ** number
4560: 6f 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 of bytes in the
4570: 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 2c 20 61 memory buffer, a
4580: 6e 64 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 61 nd the minimum a
4590: 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 7a 65 2e 0a llocation size..
45a0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 */. s
45b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
45c0: 69 67 2e 70 48 65 61 70 20 3d 20 76 61 5f 61 72 ig.pHeap = va_ar
45d0: 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 g(ap, void*);.
45e0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
45f0: 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 70 20 3d 20 lConfig.nHeap =
4600: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
4610: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
4620: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 obalConfig.mnReq
4630: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
4640: 74 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 73 t);.. if( s
4650: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
4660: 69 67 2e 6d 6e 52 65 71 3c 31 20 29 7b 0a 20 20 ig.mnReq<1 ){.
4670: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
4680: 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 20 balConfig.mnReq
4690: 3d 20 31 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 = 1;. }else
46a0: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
46b0: 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 3e 28 alConfig.mnReq>(
46c0: 31 3c 3c 31 32 29 20 29 7b 0a 20 20 20 20 20 20 1<<12) ){.
46d0: 20 20 2f 2a 20 63 61 70 20 6d 69 6e 20 72 65 71 /* cap min req
46e0: 75 65 73 74 20 73 69 7a 65 20 61 74 20 32 5e 31 uest size at 2^1
46f0: 32 20 2a 2f 0a 20 20 20 20 20 20 20 20 73 71 6c 2 */. sql
4700: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4710: 2e 6d 6e 52 65 71 20 3d 20 28 31 3c 3c 31 32 29 .mnReq = (1<<12)
4720: 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
4730: 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
4740: 61 6c 43 6f 6e 66 69 67 2e 70 48 65 61 70 3d 3d alConfig.pHeap==
4750: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 0 ){. /*
4760: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 EVIDENCE-OF: R-4
4770: 39 39 32 30 2d 36 30 31 38 39 20 49 66 20 74 68 9920-60189 If th
4780: 65 20 66 69 72 73 74 20 70 6f 69 6e 74 65 72 20 e first pointer
4790: 28 74 68 65 20 6d 65 6d 6f 72 79 20 70 6f 69 6e (the memory poin
47a0: 74 65 72 29 0a 20 20 20 20 20 20 20 20 2a 2a 20 ter). **
47b0: 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 53 51 is NULL, then SQ
47c0: 4c 69 74 65 20 72 65 76 65 72 74 73 20 74 6f 20 Lite reverts to
47d0: 75 73 69 6e 67 20 69 74 73 20 64 65 66 61 75 6c using its defaul
47e0: 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 t memory allocat
47f0: 6f 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 28 74 or. ** (t
4800: 68 65 20 73 79 73 74 65 6d 20 6d 61 6c 6c 6f 63 he system malloc
4810: 28 29 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f () implementatio
4820: 6e 29 2c 20 75 6e 64 6f 69 6e 67 20 61 6e 79 20 n), undoing any
4830: 70 72 69 6f 72 20 69 6e 76 6f 63 61 74 69 6f 6e prior invocation
4840: 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 of. ** S
4850: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c QLITE_CONFIG_MAL
4860: 4c 4f 43 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a LOC.. **.
4870: 20 20 20 20 20 20 20 20 2a 2a 20 53 65 74 74 69 ** Setti
4880: 6e 67 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c ng sqlite3Global
4890: 43 6f 6e 66 69 67 2e 6d 20 74 6f 20 61 6c 6c 20 Config.m to all
48a0: 7a 65 72 6f 73 20 77 69 6c 6c 20 63 61 75 73 65 zeros will cause
48b0: 20 6d 61 6c 6c 6f 63 20 74 6f 0a 20 20 20 20 20 malloc to.
48c0: 20 20 20 2a 2a 20 72 65 76 65 72 74 20 74 6f 20 ** revert to
48d0: 69 74 73 20 64 65 66 61 75 6c 74 20 69 6d 70 6c its default impl
48e0: 65 6d 65 6e 74 61 74 69 6f 6e 20 77 68 65 6e 20 ementation when
48f0: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 sqlite3_initiali
4900: 7a 65 28 29 20 69 73 20 72 75 6e 0a 20 20 20 20 ze() is run.
4910: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d */. m
4920: 65 6d 73 65 74 28 26 73 71 6c 69 74 65 33 47 6c emset(&sqlite3Gl
4930: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 2c 20 30 2c obalConfig.m, 0,
4940: 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 47 sizeof(sqlite3G
4950: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 29 29 3b lobalConfig.m));
4960: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
4970: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
4980: 45 2d 4f 46 3a 20 52 2d 36 31 30 30 36 2d 30 38 E-OF: R-61006-08
4990: 39 31 38 20 49 66 20 74 68 65 20 6d 65 6d 6f 72 918 If the memor
49a0: 79 20 70 6f 69 6e 74 65 72 20 69 73 20 6e 6f 74 y pointer is not
49b0: 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 0a 20 NULL then the.
49c0: 20 20 20 20 20 20 20 2a 2a 20 61 6c 74 65 72 6e ** altern
49d0: 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 61 6c 6c ative memory all
49e0: 6f 63 61 74 6f 72 20 69 73 20 65 6e 67 61 67 65 ocator is engage
49f0: 64 20 74 6f 20 68 61 6e 64 6c 65 20 61 6c 6c 20 d to handle all
4a00: 6f 66 20 53 51 4c 69 74 65 73 0a 20 20 20 20 20 of SQLites.
4a10: 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c 6c ** memory all
4a20: 6f 63 61 74 69 6f 6e 20 6e 65 65 64 73 2e 20 2a ocation needs. *
4a30: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
4a40: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a 20 ENABLE_MEMSYS3.
4a50: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c sqlite3Gl
4a60: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a obalConfig.m = *
4a70: 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d sqlite3MemGetMem
4a80: 73 79 73 33 28 29 3b 0a 23 65 6e 64 69 66 0a 23 sys3();.#endif.#
4a90: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
4aa0: 42 4c 45 5f 4d 45 4d 53 59 53 35 0a 20 20 20 20 BLE_MEMSYS5.
4ab0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4ac0: 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 71 6c lConfig.m = *sql
4ad0: 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 ite3MemGetMemsys
4ae0: 35 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 5();.#endif.
4af0: 20 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b }. break;
4b00: 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 . }.#endif..
4b10: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
4b20: 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 45 3a ONFIG_LOOKASIDE:
4b30: 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
4b40: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c GlobalConfig.szL
4b50: 6f 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 ookaside = va_ar
4b60: 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
4b70: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
4b80: 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 64 65 onfig.nLookaside
4b90: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
4ba0: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
4bb0: 0a 20 20 20 20 7d 0a 20 20 20 20 0a 20 20 20 20 . }. .
4bc0: 2f 2a 20 52 65 63 6f 72 64 20 61 20 70 6f 69 6e /* Record a poin
4bd0: 74 65 72 20 74 6f 20 74 68 65 20 6c 6f 67 67 65 ter to the logge
4be0: 72 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 69 r function and i
4bf0: 74 73 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e ts first argumen
4c00: 74 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 64 65 t.. ** The de
4c10: 66 61 75 6c 74 20 69 73 20 4e 55 4c 4c 2e 20 20 fault is NULL.
4c20: 4c 6f 67 67 69 6e 67 20 69 73 20 64 69 73 61 62 Logging is disab
4c30: 6c 65 64 20 69 66 20 74 68 65 20 66 75 6e 63 74 led if the funct
4c40: 69 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 0a 20 ion pointer is.
4c50: 20 20 20 2a 2a 20 4e 55 4c 4c 2e 0a 20 20 20 20 ** NULL..
4c60: 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
4c70: 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 47 3a 20 7b TE_CONFIG_LOG: {
4c80: 0a 20 20 20 20 20 20 2f 2a 20 4d 53 56 43 20 69 . /* MSVC i
4c90: 73 20 70 69 63 6b 79 20 61 62 6f 75 74 20 70 75 s picky about pu
4ca0: 6c 6c 69 6e 67 20 66 75 6e 63 20 70 74 72 73 20 lling func ptrs
4cb0: 66 72 6f 6d 20 76 61 20 6c 69 73 74 73 2e 0a 20 from va lists..
4cc0: 20 20 20 20 20 2a 2a 20 68 74 74 70 3a 2f 2f 73 ** http://s
4cd0: 75 70 70 6f 72 74 2e 6d 69 63 72 6f 73 6f 66 74 upport.microsoft
4ce0: 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a 20 20 .com/kb/47961.
4cf0: 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c ** sqlite3Gl
4d00: 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 20 obalConfig.xLog
4d10: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
4d20: 64 28 2a 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 d(*)(void*,int,c
4d30: 6f 6e 73 74 20 63 68 61 72 2a 29 29 3b 0a 20 20 onst char*));.
4d40: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 74 79 70 */. typ
4d50: 65 64 65 66 20 76 6f 69 64 28 2a 4c 4f 47 46 55 edef void(*LOGFU
4d60: 4e 43 5f 74 29 28 76 6f 69 64 2a 2c 69 6e 74 2c NC_t)(void*,int,
4d70: 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
4d80: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
4d90: 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 20 3d 20 76 lConfig.xLog = v
4da0: 61 5f 61 72 67 28 61 70 2c 20 4c 4f 47 46 55 4e a_arg(ap, LOGFUN
4db0: 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 C_t);. sqli
4dc0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4dd0: 70 4c 6f 67 41 72 67 20 3d 20 76 61 5f 61 72 67 pLogArg = va_arg
4de0: 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 (ap, void*);.
4df0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
4e00: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
4e10: 2d 4f 46 3a 20 52 2d 35 35 35 34 38 2d 33 33 38 -OF: R-55548-338
4e20: 31 37 20 54 68 65 20 63 6f 6d 70 69 6c 65 2d 74 17 The compile-t
4e30: 69 6d 65 20 73 65 74 74 69 6e 67 20 66 6f 72 20 ime setting for
4e40: 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 0a 20 20 URI filenames.
4e50: 20 20 2a 2a 20 63 61 6e 20 62 65 20 63 68 61 6e ** can be chan
4e60: 67 65 64 20 61 74 20 73 74 61 72 74 2d 74 69 6d ged at start-tim
4e70: 65 20 75 73 69 6e 67 20 74 68 65 0a 20 20 20 20 e using the.
4e80: 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 ** sqlite3_confi
4e90: 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f g(SQLITE_CONFIG_
4ea0: 55 52 49 2c 31 29 20 6f 72 0a 20 20 20 20 2a 2a URI,1) or. **
4eb0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 sqlite3_config(
4ec0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 55 52 SQLITE_CONFIG_UR
4ed0: 49 2c 30 29 20 63 6f 6e 66 69 67 75 72 61 74 69 I,0) configurati
4ee0: 6f 6e 20 63 61 6c 6c 73 2e 0a 20 20 20 20 2a 2f on calls.. */
4ef0: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
4f00: 5f 43 4f 4e 46 49 47 5f 55 52 49 3a 20 7b 0a 20 _CONFIG_URI: {.
4f10: 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
4f20: 2d 4f 46 3a 20 52 2d 32 35 34 35 31 2d 36 31 31 -OF: R-25451-611
4f30: 32 35 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 25 The SQLITE_CO
4f40: 4e 46 49 47 5f 55 52 49 20 6f 70 74 69 6f 6e 20 NFIG_URI option
4f50: 74 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 0a 20 takes a single.
4f60: 20 20 20 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 ** argument
4f70: 20 6f 66 20 74 79 70 65 20 69 6e 74 2e 20 49 66 of type int. If
4f80: 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 non-zero, then
4f90: 55 52 49 20 68 61 6e 64 6c 69 6e 67 20 69 73 20 URI handling is
4fa0: 67 6c 6f 62 61 6c 6c 79 0a 20 20 20 20 20 20 2a globally. *
4fb0: 2a 20 65 6e 61 62 6c 65 64 2e 20 49 66 20 74 68 * enabled. If th
4fc0: 65 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 7a e parameter is z
4fd0: 65 72 6f 2c 20 74 68 65 6e 20 55 52 49 20 68 61 ero, then URI ha
4fe0: 6e 64 6c 69 6e 67 20 69 73 20 67 6c 6f 62 61 6c ndling is global
4ff0: 6c 79 0a 20 20 20 20 20 20 2a 2a 20 64 69 73 61 ly. ** disa
5000: 62 6c 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 73 bled. */. s
5010: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
5020: 69 67 2e 62 4f 70 65 6e 55 72 69 20 3d 20 76 61 ig.bOpenUri = va
5030: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
5040: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
5050: 7d 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }.. case SQLI
5060: 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 TE_CONFIG_COVERI
5070: 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e 3a 20 7b NG_INDEX_SCAN: {
5080: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
5090: 43 45 2d 4f 46 3a 20 52 2d 33 36 35 39 32 2d 30 CE-OF: R-36592-0
50a0: 32 37 37 32 20 54 68 65 20 53 51 4c 49 54 45 5f 2772 The SQLITE_
50b0: 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f CONFIG_COVERING_
50c0: 49 4e 44 45 58 5f 53 43 41 4e 0a 20 20 20 20 20 INDEX_SCAN.
50d0: 20 2a 2a 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 ** option takes
50e0: 20 61 20 73 69 6e 67 6c 65 20 69 6e 74 65 67 65 a single intege
50f0: 72 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 r argument which
5100: 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 is interpreted
5110: 61 73 20 61 0a 20 20 20 20 20 20 2a 2a 20 62 6f as a. ** bo
5120: 6f 6c 65 61 6e 20 69 6e 20 6f 72 64 65 72 20 74 olean in order t
5130: 6f 20 65 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 o enable or disa
5140: 62 6c 65 20 74 68 65 20 75 73 65 20 6f 66 20 63 ble the use of c
5150: 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 73 20 overing indices
5160: 66 6f 72 0a 20 20 20 20 20 20 2a 2a 20 66 75 6c for. ** ful
5170: 6c 20 74 61 62 6c 65 20 73 63 61 6e 73 20 69 6e l table scans in
5180: 20 74 68 65 20 71 75 65 72 79 20 6f 70 74 69 6d the query optim
5190: 69 7a 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 73 izer. */. s
51a0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
51b0: 69 67 2e 62 55 73 65 43 69 73 20 3d 20 76 61 5f ig.bUseCis = va_
51c0: 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
51d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
51e0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
51f0: 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 ENABLE_SQLLOG.
5200: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
5210: 4e 46 49 47 5f 53 51 4c 4c 4f 47 3a 20 7b 0a 20 NFIG_SQLLOG: {.
5220: 20 20 20 20 20 74 79 70 65 64 65 66 20 76 6f 69 typedef voi
5230: 64 28 2a 53 51 4c 4c 4f 47 46 55 4e 43 5f 74 29 d(*SQLLOGFUNC_t)
5240: 28 76 6f 69 64 2a 2c 20 73 71 6c 69 74 65 33 2a (void*, sqlite3*
5250: 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 , const char*, i
5260: 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
5270: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
5280: 53 71 6c 6c 6f 67 20 3d 20 76 61 5f 61 72 67 28 Sqllog = va_arg(
5290: 61 70 2c 20 53 51 4c 4c 4f 47 46 55 4e 43 5f 74 ap, SQLLOGFUNC_t
52a0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
52b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 71 GlobalConfig.pSq
52c0: 6c 6c 6f 67 41 72 67 20 3d 20 76 61 5f 61 72 67 llogArg = va_arg
52d0: 28 61 70 2c 20 76 6f 69 64 20 2a 29 3b 0a 20 20 (ap, void *);.
52e0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
52f0: 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 .#endif.. cas
5300: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f e SQLITE_CONFIG_
5310: 4d 4d 41 50 5f 53 49 5a 45 3a 20 7b 0a 20 20 20 MMAP_SIZE: {.
5320: 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
5330: 46 3a 20 52 2d 35 38 30 36 33 2d 33 38 32 35 38 F: R-58063-38258
5340: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d SQLITE_CONFIG_M
5350: 4d 41 50 5f 53 49 5a 45 20 74 61 6b 65 73 20 74 MAP_SIZE takes t
5360: 77 6f 20 36 34 2d 62 69 74 0a 20 20 20 20 20 20 wo 64-bit.
5370: 2a 2a 20 69 6e 74 65 67 65 72 20 28 73 71 6c 69 ** integer (sqli
5380: 74 65 33 5f 69 6e 74 36 34 29 20 76 61 6c 75 65 te3_int64) value
5390: 73 20 74 68 61 74 20 61 72 65 20 74 68 65 20 64 s that are the d
53a0: 65 66 61 75 6c 74 20 6d 6d 61 70 20 73 69 7a 65 efault mmap size
53b0: 20 6c 69 6d 69 74 0a 20 20 20 20 20 20 2a 2a 20 limit. **
53c0: 28 74 68 65 20 64 65 66 61 75 6c 74 20 73 65 74 (the default set
53d0: 74 69 6e 67 20 66 6f 72 20 50 52 41 47 4d 41 20 ting for PRAGMA
53e0: 6d 6d 61 70 5f 73 69 7a 65 29 20 61 6e 64 20 74 mmap_size) and t
53f0: 68 65 20 6d 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 he maximum allow
5400: 65 64 0a 20 20 20 20 20 20 2a 2a 20 6d 6d 61 70 ed. ** mmap
5410: 20 73 69 7a 65 20 6c 69 6d 69 74 2e 20 2a 2f 0a size limit. */.
5420: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e sqlite3_in
5430: 74 36 34 20 73 7a 4d 6d 61 70 20 3d 20 76 61 5f t64 szMmap = va_
5440: 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f arg(ap, sqlite3_
5450: 69 6e 74 36 34 29 3b 0a 20 20 20 20 20 20 73 71 int64);. sq
5460: 6c 69 74 65 33 5f 69 6e 74 36 34 20 6d 78 4d 6d lite3_int64 mxMm
5470: 61 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ap = va_arg(ap,
5480: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 3b 0a sqlite3_int64);.
5490: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
54a0: 45 2d 4f 46 3a 20 52 2d 35 33 33 36 37 2d 34 33 E-OF: R-53367-43
54b0: 31 39 30 20 49 66 20 65 69 74 68 65 72 20 61 72 190 If either ar
54c0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 6f gument to this o
54d0: 70 74 69 6f 6e 20 69 73 0a 20 20 20 20 20 20 2a ption is. *
54e0: 2a 20 6e 65 67 61 74 69 76 65 2c 20 74 68 65 6e * negative, then
54f0: 20 74 68 61 74 20 61 72 67 75 6d 65 6e 74 20 69 that argument i
5500: 73 20 63 68 61 6e 67 65 64 20 74 6f 20 69 74 73 s changed to its
5510: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 64 65 compile-time de
5520: 66 61 75 6c 74 2e 0a 20 20 20 20 20 20 2a 2a 0a fault.. **.
5530: 20 20 20 20 20 20 2a 2a 20 45 56 49 44 45 4e 43 ** EVIDENC
5540: 45 2d 4f 46 3a 20 52 2d 33 34 39 39 33 2d 34 35 E-OF: R-34993-45
5550: 30 33 31 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 031 The maximum
5560: 61 6c 6c 6f 77 65 64 20 6d 6d 61 70 20 73 69 7a allowed mmap siz
5570: 65 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 20 20 e will be.
5580: 2a 2a 20 73 69 6c 65 6e 74 6c 79 20 74 72 75 6e ** silently trun
5590: 63 61 74 65 64 20 69 66 20 6e 65 63 65 73 73 61 cated if necessa
55a0: 72 79 20 73 6f 20 74 68 61 74 20 69 74 20 64 6f ry so that it do
55b0: 65 73 20 6e 6f 74 20 65 78 63 65 65 64 20 74 68 es not exceed th
55c0: 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6d 70 69 e. ** compi
55d0: 6c 65 2d 74 69 6d 65 20 6d 61 78 69 6d 75 6d 20 le-time maximum
55e0: 6d 6d 61 70 20 73 69 7a 65 20 73 65 74 20 62 79 mmap size set by
55f0: 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f the SQLITE_MAX_
5600: 4d 4d 41 50 5f 53 49 5a 45 0a 20 20 20 20 20 20 MMAP_SIZE.
5610: 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 ** compile-time
5620: 6f 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f option.. */
5630: 0a 20 20 20 20 20 20 69 66 28 20 6d 78 4d 6d 61 . if( mxMma
5640: 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 70 3e 53 51 p<0 || mxMmap>SQ
5650: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 LITE_MAX_MMAP_SI
5660: 5a 45 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 78 ZE ){. mx
5670: 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f 4d 41 Mmap = SQLITE_MA
5680: 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 20 20 X_MMAP_SIZE;.
5690: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 73 }. if( s
56a0: 7a 4d 6d 61 70 3c 30 20 29 20 73 7a 4d 6d 61 70 zMmap<0 ) szMmap
56b0: 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c = SQLITE_DEFAUL
56c0: 54 5f 4d 4d 41 50 5f 53 49 5a 45 3b 0a 20 20 20 T_MMAP_SIZE;.
56d0: 20 20 20 69 66 28 20 73 7a 4d 6d 61 70 3e 6d 78 if( szMmap>mx
56e0: 4d 6d 61 70 29 20 73 7a 4d 6d 61 70 20 3d 20 6d Mmap) szMmap = m
56f0: 78 4d 6d 61 70 3b 0a 20 20 20 20 20 20 73 71 6c xMmap;. sql
5700: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
5710: 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 4d 6d 61 70 .mxMmap = mxMmap
5720: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
5730: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4d 6d lobalConfig.szMm
5740: 61 70 20 3d 20 73 7a 4d 6d 61 70 3b 0a 20 20 20 ap = szMmap;.
5750: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
5760: 0a 23 69 66 20 53 51 4c 49 54 45 5f 4f 53 5f 57 .#if SQLITE_OS_W
5770: 49 4e 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 IN && defined(SQ
5780: 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f LITE_WIN32_MALLO
5790: 43 29 20 2f 2a 20 49 4d 50 3a 20 52 2d 30 34 37 C) /* IMP: R-047
57a0: 38 30 2d 35 35 38 31 35 20 2a 2f 0a 20 20 20 20 80-55815 */.
57b0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
57c0: 49 47 5f 57 49 4e 33 32 5f 48 45 41 50 53 49 5a IG_WIN32_HEAPSIZ
57d0: 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 E: {. /* EV
57e0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 34 39 IDENCE-OF: R-349
57f0: 32 36 2d 30 33 33 36 30 20 53 51 4c 49 54 45 5f 26-03360 SQLITE_
5800: 43 4f 4e 46 49 47 5f 57 49 4e 33 32 5f 48 45 41 CONFIG_WIN32_HEA
5810: 50 53 49 5a 45 20 74 61 6b 65 73 20 61 20 33 32 PSIZE takes a 32
5820: 2d 62 69 74 0a 20 20 20 20 20 20 2a 2a 20 75 6e -bit. ** un
5830: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 76 signed integer v
5840: 61 6c 75 65 20 74 68 61 74 20 73 70 65 63 69 66 alue that specif
5850: 69 65 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 ies the maximum
5860: 73 69 7a 65 20 6f 66 20 74 68 65 20 63 72 65 61 size of the crea
5870: 74 65 64 0a 20 20 20 20 20 20 2a 2a 20 68 65 61 ted. ** hea
5880: 70 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 p. */. sqli
5890: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
58a0: 6e 48 65 61 70 20 3d 20 76 61 5f 61 72 67 28 61 nHeap = va_arg(a
58b0: 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 p, int);. b
58c0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 reak;. }.#end
58d0: 69 66 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c if.. case SQL
58e0: 49 54 45 5f 43 4f 4e 46 49 47 5f 50 4d 41 53 5a ITE_CONFIG_PMASZ
58f0: 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
5900: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 3GlobalConfig.sz
5910: 50 6d 61 20 3d 20 76 61 5f 61 72 67 28 61 70 2c Pma = va_arg(ap,
5920: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 3b 0a unsigned int);.
5930: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
5940: 20 7d 0a 0a 20 20 20 20 64 65 66 61 75 6c 74 3a }.. default:
5950: 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 {. rc = SQ
5960: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 LITE_ERROR;.
5970: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
5980: 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 29 3b }. va_end(ap);
5990: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
59a0: 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 20 74 68 ./*.** Set up th
59b0: 65 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 e lookaside buff
59c0: 65 72 73 20 66 6f 72 20 61 20 64 61 74 61 62 61 ers for a databa
59d0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a se connection..*
59e0: 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f * Return SQLITE_
59f0: 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 OK on success.
5a00: 0a 2a 2a 20 49 66 20 6c 6f 6f 6b 61 73 69 64 65 .** If lookaside
5a10: 20 69 73 20 61 6c 72 65 61 64 79 20 61 63 74 69 is already acti
5a20: 76 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ve, return SQLIT
5a30: 45 5f 42 55 53 59 2e 0a 2a 2a 0a 2a 2a 20 54 68 E_BUSY..**.** Th
5a40: 65 20 73 7a 20 70 61 72 61 6d 65 74 65 72 20 69 e sz parameter i
5a50: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
5a60: 62 79 74 65 73 20 69 6e 20 65 61 63 68 20 6c 6f bytes in each lo
5a70: 6f 6b 61 73 69 64 65 20 73 6c 6f 74 2e 0a 2a 2a okaside slot..**
5a80: 20 54 68 65 20 63 6e 74 20 70 61 72 61 6d 65 74 The cnt paramet
5a90: 65 72 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 er is the number
5aa0: 20 6f 66 20 73 6c 6f 74 73 2e 20 20 49 66 20 70 of slots. If p
5ab0: 53 74 61 72 74 20 69 73 20 4e 55 4c 4c 20 74 68 Start is NULL th
5ac0: 65 0a 2a 2a 20 73 70 61 63 65 20 66 6f 72 20 74 e.** space for t
5ad0: 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d he lookaside mem
5ae0: 6f 72 79 20 69 73 20 6f 62 74 61 69 6e 65 64 20 ory is obtained
5af0: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c from sqlite3_mal
5b00: 6c 6f 63 28 29 2e 0a 2a 2a 20 49 66 20 70 53 74 loc()..** If pSt
5b10: 61 72 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 art is not NULL
5b20: 74 68 65 6e 20 69 74 20 69 73 20 73 7a 2a 63 6e then it is sz*cn
5b30: 74 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 t bytes of memor
5b40: 79 20 74 6f 20 75 73 65 20 66 6f 72 0a 2a 2a 20 y to use for.**
5b50: 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 the lookaside me
5b60: 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 mory..*/.static
5b70: 69 6e 74 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 int setupLookasi
5b80: 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 de(sqlite3 *db,
5b90: 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 void *pBuf, int
5ba0: 73 7a 2c 20 69 6e 74 20 63 6e 74 29 7b 0a 20 20 sz, int cnt){.
5bb0: 76 6f 69 64 20 2a 70 53 74 61 72 74 3b 0a 20 20 void *pStart;.
5bc0: 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 if( db->lookasid
5bd0: 65 2e 6e 4f 75 74 20 29 7b 0a 20 20 20 20 72 65 e.nOut ){. re
5be0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 turn SQLITE_BUSY
5bf0: 3b 0a 20 20 7d 0a 20 20 2f 2a 20 46 72 65 65 20 ;. }. /* Free
5c00: 61 6e 79 20 65 78 69 73 74 69 6e 67 20 6c 6f 6f any existing loo
5c10: 6b 61 73 69 64 65 20 62 75 66 66 65 72 20 66 6f kaside buffer fo
5c20: 72 20 74 68 69 73 20 68 61 6e 64 6c 65 20 62 65 r this handle be
5c30: 66 6f 72 65 0a 20 20 2a 2a 20 61 6c 6c 6f 63 61 fore. ** alloca
5c40: 74 69 6e 67 20 61 20 6e 65 77 20 6f 6e 65 20 73 ting a new one s
5c50: 6f 20 77 65 20 64 6f 6e 27 74 20 68 61 76 65 20 o we don't have
5c60: 74 6f 20 68 61 76 65 20 73 70 61 63 65 20 66 6f to have space fo
5c70: 72 20 0a 20 20 2a 2a 20 62 6f 74 68 20 61 74 20 r . ** both at
5c80: 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 20 the same time..
5c90: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f */. if( db->lo
5ca0: 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 okaside.bMalloce
5cb0: 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 d ){. sqlite3
5cc0: 5f 66 72 65 65 28 64 62 2d 3e 6c 6f 6f 6b 61 73 _free(db->lookas
5cd0: 69 64 65 2e 70 53 74 61 72 74 29 3b 0a 20 20 7d ide.pStart);. }
5ce0: 0a 20 20 2f 2a 20 54 68 65 20 73 69 7a 65 20 6f . /* The size o
5cf0: 66 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 73 6c f a lookaside sl
5d00: 6f 74 20 61 66 74 65 72 20 52 4f 55 4e 44 44 4f ot after ROUNDDO
5d10: 57 4e 38 20 6e 65 65 64 73 20 74 6f 20 62 65 20 WN8 needs to be
5d20: 6c 61 72 67 65 72 0a 20 20 2a 2a 20 74 68 61 6e larger. ** than
5d30: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 62 65 a pointer to be
5d40: 20 75 73 65 66 75 6c 2e 0a 20 20 2a 2f 0a 20 20 useful.. */.
5d50: 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 28 sz = ROUNDDOWN8(
5d60: 73 7a 29 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d sz); /* IMP: R-
5d70: 33 33 30 33 38 2d 30 39 33 38 32 20 2a 2f 0a 20 33038-09382 */.
5d80: 20 69 66 28 20 73 7a 3c 3d 28 69 6e 74 29 73 69 if( sz<=(int)si
5d90: 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c zeof(LookasideSl
5da0: 6f 74 2a 29 20 29 20 73 7a 20 3d 20 30 3b 0a 20 ot*) ) sz = 0;.
5db0: 20 69 66 28 20 63 6e 74 3c 30 20 29 20 63 6e 74 if( cnt<0 ) cnt
5dc0: 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 7a 3d 3d = 0;. if( sz==
5dd0: 30 20 7c 7c 20 63 6e 74 3d 3d 30 20 29 7b 0a 20 0 || cnt==0 ){.
5de0: 20 20 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 70 sz = 0;. p
5df0: 53 74 61 72 74 20 3d 20 30 3b 0a 20 20 7d 65 6c Start = 0;. }el
5e00: 73 65 20 69 66 28 20 70 42 75 66 3d 3d 30 20 29 se if( pBuf==0 )
5e10: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 65 67 {. sqlite3Beg
5e20: 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 inBenignMalloc()
5e30: 3b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 73 ;. pStart = s
5e40: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a qlite3Malloc( sz
5e50: 2a 63 6e 74 20 29 3b 20 20 2f 2a 20 49 4d 50 3a *cnt ); /* IMP:
5e60: 20 52 2d 36 31 39 34 39 2d 33 35 37 32 37 20 2a R-61949-35727 *
5e70: 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 /. sqlite3End
5e80: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a BenignMalloc();.
5e90: 20 20 20 20 69 66 28 20 70 53 74 61 72 74 20 29 if( pStart )
5ea0: 20 63 6e 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 cnt = sqlite3Ma
5eb0: 6c 6c 6f 63 53 69 7a 65 28 70 53 74 61 72 74 29 llocSize(pStart)
5ec0: 2f 73 7a 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 /sz;. }else{.
5ed0: 20 20 70 53 74 61 72 74 20 3d 20 70 42 75 66 3b pStart = pBuf;
5ee0: 0a 20 20 7d 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 . }. db->looka
5ef0: 73 69 64 65 2e 70 53 74 61 72 74 20 3d 20 70 53 side.pStart = pS
5f00: 74 61 72 74 3b 0a 20 20 64 62 2d 3e 6c 6f 6f 6b tart;. db->look
5f10: 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 30 3b aside.pFree = 0;
5f20: 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 . db->lookaside
5f30: 2e 73 7a 20 3d 20 28 75 31 36 29 73 7a 3b 0a 20 .sz = (u16)sz;.
5f40: 20 69 66 28 20 70 53 74 61 72 74 20 29 7b 0a 20 if( pStart ){.
5f50: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 4c 6f int i;. Lo
5f60: 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 3b 0a okasideSlot *p;.
5f70: 20 20 20 20 61 73 73 65 72 74 28 20 73 7a 20 3e assert( sz >
5f80: 20 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f 6f (int)sizeof(Loo
5f90: 6b 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 3b 0a kasideSlot*) );.
5fa0: 20 20 20 20 70 20 3d 20 28 4c 6f 6f 6b 61 73 69 p = (Lookasi
5fb0: 64 65 53 6c 6f 74 2a 29 70 53 74 61 72 74 3b 0a deSlot*)pStart;.
5fc0: 20 20 20 20 66 6f 72 28 69 3d 63 6e 74 2d 31 3b for(i=cnt-1;
5fd0: 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 i>=0; i--){.
5fe0: 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 64 62 p->pNext = db
5ff0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 ->lookaside.pFre
6000: 65 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6c 6f 6f e;. db->loo
6010: 6b 61 73 69 64 65 2e 70 46 72 65 65 20 3d 20 70 kaside.pFree = p
6020: 3b 0a 20 20 20 20 20 20 70 20 3d 20 28 4c 6f 6f ;. p = (Loo
6030: 6b 61 73 69 64 65 53 6c 6f 74 2a 29 26 28 28 75 kasideSlot*)&((u
6040: 38 2a 29 70 29 5b 73 7a 5d 3b 0a 20 20 20 20 7d 8*)p)[sz];. }
6050: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
6060: 64 65 2e 70 45 6e 64 20 3d 20 70 3b 0a 20 20 20 de.pEnd = p;.
6070: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 db->lookaside.b
6080: 45 6e 61 62 6c 65 64 20 3d 20 31 3b 0a 20 20 20 Enabled = 1;.
6090: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 db->lookaside.b
60a0: 4d 61 6c 6c 6f 63 65 64 20 3d 20 70 42 75 66 3d Malloced = pBuf=
60b0: 3d 30 20 3f 31 3a 30 3b 0a 20 20 7d 65 6c 73 65 =0 ?1:0;. }else
60c0: 7b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 {. db->lookas
60d0: 69 64 65 2e 70 53 74 61 72 74 20 3d 20 64 62 3b ide.pStart = db;
60e0: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
60f0: 64 65 2e 70 45 6e 64 20 3d 20 64 62 3b 0a 20 20 de.pEnd = db;.
6100: 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e db->lookaside.
6110: 62 45 6e 61 62 6c 65 64 20 3d 20 30 3b 0a 20 20 bEnabled = 0;.
6120: 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e db->lookaside.
6130: 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 30 3b 0a 20 bMalloced = 0;.
6140: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
6150: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
6160: 52 65 74 75 72 6e 20 74 68 65 20 6d 75 74 65 78 Return the mutex
6170: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
6180: 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e a database conn
6190: 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c 69 74 ection..*/.sqlit
61a0: 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 e3_mutex *sqlite
61b0: 33 5f 64 62 5f 6d 75 74 65 78 28 73 71 6c 69 74 3_db_mutex(sqlit
61c0: 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 e3 *db){.#ifdef
61d0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
61e0: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
61f0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
6200: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
6210: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
6220: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
6230: 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 urn 0;. }.#endi
6240: 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6d f. return db->m
6250: 75 74 65 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 utex;.}../*.** F
6260: 72 65 65 20 75 70 20 61 73 20 6d 75 63 68 20 6d ree up as much m
6270: 65 6d 6f 72 79 20 61 73 20 77 65 20 63 61 6e 20 emory as we can
6280: 66 72 6f 6d 20 74 68 65 20 67 69 76 65 6e 20 64 from the given d
6290: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 atabase.** conne
62a0: 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ction..*/.int sq
62b0: 6c 69 74 65 33 5f 64 62 5f 72 65 6c 65 61 73 65 lite3_db_release
62c0: 5f 6d 65 6d 6f 72 79 28 73 71 6c 69 74 65 33 20 _memory(sqlite3
62d0: 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 0a *db){. int i;..
62e0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
62f0: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
6300: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
6310: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
6320: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
6330: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
6340: 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 if. sqlite3_mut
6350: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
6360: 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ex);. sqlite3Bt
6370: 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b reeEnterAll(db);
6380: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 . for(i=0; i<db
6390: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 ->nDb; i++){.
63a0: 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 Btree *pBt = db
63b0: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 ->aDb[i].pBt;.
63c0: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 if( pBt ){.
63d0: 20 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 Pager *pPager
63e0: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 = sqlite3BtreeP
63f0: 61 67 65 72 28 70 42 74 29 3b 0a 20 20 20 20 20 ager(pBt);.
6400: 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 68 72 sqlite3PagerShr
6410: 69 6e 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 ink(pPager);.
6420: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 }. }. sqlite3
6430: 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 BtreeLeaveAll(db
6440: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 );. sqlite3_mut
6450: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
6460: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ex);. return SQ
6470: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
6480: 2a 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 * Configuration
6490: 73 65 74 74 69 6e 67 73 20 66 6f 72 20 61 6e 20 settings for an
64a0: 69 6e 64 69 76 69 64 75 61 6c 20 64 61 74 61 62 individual datab
64b0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a ase connection.*
64c0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 /.int sqlite3_db
64d0: 5f 63 6f 6e 66 69 67 28 73 71 6c 69 74 65 33 20 _config(sqlite3
64e0: 2a 64 62 2c 20 69 6e 74 20 6f 70 2c 20 2e 2e 2e *db, int op, ...
64f0: 29 7b 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b ){. va_list ap;
6500: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 76 61 5f . int rc;. va_
6510: 73 74 61 72 74 28 61 70 2c 20 6f 70 29 3b 0a 20 start(ap, op);.
6520: 20 73 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 20 switch( op ){.
6530: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 case SQLITE_D
6540: 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 BCONFIG_LOOKASID
6550: 45 3a 20 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 E: {. void
6560: 2a 70 42 75 66 20 3d 20 76 61 5f 61 72 67 28 61 *pBuf = va_arg(a
6570: 70 2c 20 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 4d p, void*); /* IM
6580: 50 3a 20 52 2d 32 36 38 33 35 2d 31 30 39 36 34 P: R-26835-10964
6590: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 7a */. int sz
65a0: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
65b0: 74 29 3b 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 t); /* IMP
65c0: 3a 20 52 2d 34 37 38 37 31 2d 32 35 39 39 34 20 : R-47871-25994
65d0: 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 63 6e 74 */. int cnt
65e0: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
65f0: 74 29 3b 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a t); /* IMP:
6600: 20 52 2d 30 34 34 36 30 2d 35 33 33 38 36 20 2a R-04460-53386 *
6610: 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 73 65 74 /. rc = set
6620: 75 70 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 upLookaside(db,
6630: 70 42 75 66 2c 20 73 7a 2c 20 63 6e 74 29 3b 0a pBuf, sz, cnt);.
6640: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
6650: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 }. default:
6660: 7b 0a 20 20 20 20 20 20 73 74 61 74 69 63 20 63 {. static c
6670: 6f 6e 73 74 20 73 74 72 75 63 74 20 7b 0a 20 20 onst struct {.
6680: 20 20 20 20 20 20 69 6e 74 20 6f 70 3b 20 20 20 int op;
6690: 20 20 20 2f 2a 20 54 68 65 20 6f 70 63 6f 64 65 /* The opcode
66a0: 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 32 20 */. u32
66b0: 6d 61 73 6b 3b 20 20 20 20 2f 2a 20 4d 61 73 6b mask; /* Mask
66c0: 20 6f 66 20 74 68 65 20 62 69 74 20 69 6e 20 73 of the bit in s
66d0: 71 6c 69 74 65 33 2e 66 6c 61 67 73 20 74 6f 20 qlite3.flags to
66e0: 73 65 74 2f 63 6c 65 61 72 20 2a 2f 0a 20 20 20 set/clear */.
66f0: 20 20 20 7d 20 61 46 6c 61 67 4f 70 5b 5d 20 3d } aFlagOp[] =
6700: 20 7b 0a 20 20 20 20 20 20 20 20 7b 20 53 51 4c {. { SQL
6710: 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 45 4e 41 ITE_DBCONFIG_ENA
6720: 42 4c 45 5f 46 4b 45 59 2c 20 20 20 20 53 51 4c BLE_FKEY, SQL
6730: 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 ITE_ForeignKeys
6740: 20 20 20 7d 2c 0a 20 20 20 20 20 20 20 20 7b 20 },. {
6750: 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f SQLITE_DBCONFIG_
6760: 45 4e 41 42 4c 45 5f 54 52 49 47 47 45 52 2c 20 ENABLE_TRIGGER,
6770: 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 SQLITE_EnableTri
6780: 67 67 65 72 20 20 7d 2c 0a 20 20 20 20 20 20 7d gger },. }
6790: 3b 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 ;. unsigned
67a0: 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 72 63 int i;. rc
67b0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
67c0: 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 32 37 39 30 /* IMP: R-42790
67d0: 2d 32 33 33 37 32 20 2a 2f 0a 20 20 20 20 20 20 -23372 */.
67e0: 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72 61 79 for(i=0; i<Array
67f0: 53 69 7a 65 28 61 46 6c 61 67 4f 70 29 3b 20 69 Size(aFlagOp); i
6800: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 ++){. if(
6810: 20 61 46 6c 61 67 4f 70 5b 69 5d 2e 6f 70 3d 3d aFlagOp[i].op==
6820: 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 op ){.
6830: 69 6e 74 20 6f 6e 6f 66 66 20 3d 20 76 61 5f 61 int onoff = va_a
6840: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
6850: 20 20 20 20 20 20 20 69 6e 74 20 2a 70 52 65 73 int *pRes
6860: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
6870: 74 2a 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 t*);. i
6880: 6e 74 20 6f 6c 64 46 6c 61 67 73 20 3d 20 64 62 nt oldFlags = db
6890: 2d 3e 66 6c 61 67 73 3b 0a 20 20 20 20 20 20 20 ->flags;.
68a0: 20 20 20 69 66 28 20 6f 6e 6f 66 66 3e 30 20 29 if( onoff>0 )
68b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 64 62 {. db
68c0: 2d 3e 66 6c 61 67 73 20 7c 3d 20 61 46 6c 61 67 ->flags |= aFlag
68d0: 4f 70 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 20 20 20 Op[i].mask;.
68e0: 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
68f0: 6f 6e 6f 66 66 3d 3d 30 20 29 7b 0a 20 20 20 20 onoff==0 ){.
6900: 20 20 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 db->flag
6910: 73 20 26 3d 20 7e 61 46 6c 61 67 4f 70 5b 69 5d s &= ~aFlagOp[i]
6920: 2e 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 20 20 .mask;.
6930: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 }. if(
6940: 20 6f 6c 64 46 6c 61 67 73 21 3d 64 62 2d 3e 66 oldFlags!=db->f
6950: 6c 61 67 73 20 29 7b 0a 20 20 20 20 20 20 20 20 lags ){.
6960: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 sqlite3Expir
6970: 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 ePreparedStateme
6980: 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 20 20 20 nts(db);.
6990: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 }. i
69a0: 66 28 20 70 52 65 73 20 29 7b 0a 20 20 20 20 20 f( pRes ){.
69b0: 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 28 *pRes = (
69c0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 61 46 6c 61 db->flags & aFla
69d0: 67 4f 70 5b 69 5d 2e 6d 61 73 6b 29 21 3d 30 3b gOp[i].mask)!=0;
69e0: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
69f0: 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
6a00: 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 TE_OK;.
6a10: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
6a20: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
6a30: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d break;. }. }
6a40: 0a 20 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 . va_end(ap);.
6a50: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
6a60: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 /*.** Return tru
6a70: 65 20 69 66 20 74 68 65 20 62 75 66 66 65 72 20 e if the buffer
6a80: 7a 5b 30 2e 2e 6e 2d 31 5d 20 63 6f 6e 74 61 69 z[0..n-1] contai
6a90: 6e 73 20 61 6c 6c 20 73 70 61 63 65 73 2e 0a 2a ns all spaces..*
6aa0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c /.static int all
6ab0: 53 70 61 63 65 73 28 63 6f 6e 73 74 20 63 68 61 Spaces(const cha
6ac0: 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 r *z, int n){.
6ad0: 77 68 69 6c 65 28 20 6e 3e 30 20 26 26 20 7a 5b while( n>0 && z[
6ae0: 6e 2d 31 5d 3d 3d 27 20 27 20 29 7b 20 6e 2d 2d n-1]==' ' ){ n--
6af0: 3b 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 3d 3d ; }. return n==
6b00: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 0;.}../*.** This
6b10: 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 is the default
6b20: 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 69 collating functi
6b30: 6f 6e 20 6e 61 6d 65 64 20 22 42 49 4e 41 52 59 on named "BINARY
6b40: 22 20 77 68 69 63 68 20 69 73 20 61 6c 77 61 79 " which is alway
6b50: 73 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 2e 0a s.** available..
6b60: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 64 **.** If the pad
6b70: 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 69 73 Flag argument is
6b80: 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 73 not NULL then s
6b90: 70 61 63 65 20 70 61 64 64 69 6e 67 20 61 74 20 pace padding at
6ba0: 74 68 65 20 65 6e 64 0a 2a 2a 20 6f 66 20 73 74 the end.** of st
6bb0: 72 69 6e 67 73 20 69 73 20 69 67 6e 6f 72 65 64 rings is ignored
6bc0: 2e 20 20 54 68 69 73 20 69 6d 70 6c 65 6d 65 6e . This implemen
6bd0: 74 73 20 74 68 65 20 52 54 52 49 4d 20 63 6f 6c ts the RTRIM col
6be0: 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 lation..*/.stati
6bf0: 63 20 69 6e 74 20 62 69 6e 43 6f 6c 6c 46 75 6e c int binCollFun
6c00: 63 28 0a 20 20 76 6f 69 64 20 2a 70 61 64 46 6c c(. void *padFl
6c10: 61 67 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c ag,. int nKey1,
6c20: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
6c30: 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c y1,. int nKey2,
6c40: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
6c50: 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 63 2c 20 y2.){. int rc,
6c60: 6e 3b 0a 20 20 6e 20 3d 20 6e 4b 65 79 31 3c 6e n;. n = nKey1<n
6c70: 4b 65 79 32 20 3f 20 6e 4b 65 79 31 20 3a 20 6e Key2 ? nKey1 : n
6c80: 4b 65 79 32 3b 0a 20 20 2f 2a 20 45 56 49 44 45 Key2;. /* EVIDE
6c90: 4e 43 45 2d 4f 46 3a 20 52 2d 36 35 30 33 33 2d NCE-OF: R-65033-
6ca0: 32 38 34 34 39 20 54 68 65 20 62 75 69 6c 74 2d 28449 The built-
6cb0: 69 6e 20 42 49 4e 41 52 59 20 63 6f 6c 6c 61 74 in BINARY collat
6cc0: 69 6f 6e 20 63 6f 6d 70 61 72 65 73 0a 20 20 2a ion compares. *
6cd0: 2a 20 73 74 72 69 6e 67 73 20 62 79 74 65 20 62 * strings byte b
6ce0: 79 20 62 79 74 65 20 75 73 69 6e 67 20 74 68 65 y byte using the
6cf0: 20 6d 65 6d 63 6d 70 28 29 20 66 75 6e 63 74 69 memcmp() functi
6d00: 6f 6e 20 66 72 6f 6d 20 74 68 65 20 73 74 61 6e on from the stan
6d10: 64 61 72 64 20 43 0a 20 20 2a 2a 20 6c 69 62 72 dard C. ** libr
6d20: 61 72 79 2e 20 2a 2f 0a 20 20 72 63 20 3d 20 6d ary. */. rc = m
6d30: 65 6d 63 6d 70 28 70 4b 65 79 31 2c 20 70 4b 65 emcmp(pKey1, pKe
6d40: 79 32 2c 20 6e 29 3b 0a 20 20 69 66 28 20 72 63 y2, n);. if( rc
6d50: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 ==0 ){. if( p
6d60: 61 64 46 6c 61 67 0a 20 20 20 20 20 26 26 20 61 adFlag. && a
6d70: 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 72 2a llSpaces(((char*
6d80: 29 70 4b 65 79 31 29 2b 6e 2c 20 6e 4b 65 79 31 )pKey1)+n, nKey1
6d90: 2d 6e 29 0a 20 20 20 20 20 26 26 20 61 6c 6c 53 -n). && allS
6da0: 70 61 63 65 73 28 28 28 63 68 61 72 2a 29 70 4b paces(((char*)pK
6db0: 65 79 32 29 2b 6e 2c 20 6e 4b 65 79 32 2d 6e 29 ey2)+n, nKey2-n)
6dc0: 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
6dd0: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
6de0: 33 31 36 32 34 2d 32 34 37 33 37 20 52 54 52 49 31624-24737 RTRI
6df0: 4d 20 69 73 20 6c 69 6b 65 20 42 49 4e 41 52 59 M is like BINARY
6e00: 20 65 78 63 65 70 74 20 74 68 61 74 20 65 78 74 except that ext
6e10: 72 61 0a 20 20 20 20 20 20 2a 2a 20 73 70 61 63 ra. ** spac
6e20: 65 73 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 es at the end of
6e30: 20 65 69 74 68 65 72 20 73 74 72 69 6e 67 20 64 either string d
6e40: 6f 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 68 65 o not change the
6e50: 20 72 65 73 75 6c 74 2e 20 49 6e 20 6f 74 68 65 result. In othe
6e60: 72 0a 20 20 20 20 20 20 2a 2a 20 77 6f 72 64 73 r. ** words
6e70: 2c 20 73 74 72 69 6e 67 73 20 77 69 6c 6c 20 63 , strings will c
6e80: 6f 6d 70 61 72 65 20 65 71 75 61 6c 20 74 6f 20 ompare equal to
6e90: 6f 6e 65 20 61 6e 6f 74 68 65 72 20 61 73 20 6c one another as l
6ea0: 6f 6e 67 20 61 73 20 74 68 65 79 0a 20 20 20 20 ong as they.
6eb0: 20 20 2a 2a 20 64 69 66 66 65 72 20 6f 6e 6c 79 ** differ only
6ec0: 20 69 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f in the number o
6ed0: 66 20 73 70 61 63 65 73 20 61 74 20 74 68 65 20 f spaces at the
6ee0: 65 6e 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 end.. */.
6ef0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
6f00: 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 79 c = nKey1 - nKey
6f10: 32 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 2;. }. }. r
6f20: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
6f30: 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 ** Another built
6f40: 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 -in collating se
6f50: 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 quence: NOCASE.
6f60: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c .**.** This coll
6f70: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 ating sequence i
6f80: 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 s intended to be
6f90: 20 75 73 65 64 20 66 6f 72 20 22 63 61 73 65 20 used for "case
6fa0: 69 6e 64 65 70 65 6e 64 65 6e 74 0a 2a 2a 20 63 independent.** c
6fb0: 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 omparison". SQLi
6fc0: 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f te's knowledge o
6fd0: 66 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 f upper and lowe
6fe0: 72 20 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e r case equivalen
6ff0: 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e ts.** extends on
7000: 6c 79 20 74 6f 20 74 68 65 20 32 36 20 63 68 61 ly to the 26 cha
7010: 72 61 63 74 65 72 73 20 75 73 65 64 20 69 6e 20 racters used in
7020: 74 68 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 the English lang
7030: 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 uage..**.** At t
7040: 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 he moment there
7050: 69 73 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 is only a UTF-8
7060: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a implementation..
7070: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f */.static int no
7080: 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e caseCollatingFun
7090: 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 c(. void *NotUs
70a0: 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c ed,. int nKey1,
70b0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
70c0: 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c y1,. int nKey2,
70d0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 const void *pKe
70e0: 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 y2.){. int r =
70f0: 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28 sqlite3StrNICmp(
7100: 0a 20 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68 . (const ch
7110: 61 72 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e ar *)pKey1, (con
7120: 73 74 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c st char *)pKey2,
7130: 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e (nKey1<nKey2)?n
7140: 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 55 Key1:nKey2);. U
7150: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
7160: 4e 6f 74 55 73 65 64 29 3b 0a 20 20 69 66 28 20 NotUsed);. if(
7170: 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 0==r ){. r =
7180: 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d nKey1-nKey2;. }
7190: 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a . return r;.}..
71a0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
71b0: 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f ROWID of the mo
71c0: 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 st recent insert
71d0: 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 .*/.sqlite_int64
71e0: 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e sqlite3_last_in
71f0: 73 65 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 sert_rowid(sqlit
7200: 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 e3 *db){.#ifdef
7210: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
7220: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
7230: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
7240: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 kOk(db) ){. (
7250: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 void)SQLITE_MISU
7260: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 SE_BKPT;. ret
7270: 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 urn 0;. }.#endi
7280: 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6c f. return db->l
7290: 61 73 74 52 6f 77 69 64 3b 0a 7d 0a 0a 2f 2a 0a astRowid;.}../*.
72a0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 ** Return the nu
72b0: 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20 mber of changes
72c0: 69 6e 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 in the most rece
72d0: 6e 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 nt call to sqlit
72e0: 65 33 5f 65 78 65 63 28 29 2e 0a 2a 2f 0a 69 6e e3_exec()..*/.in
72f0: 74 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 t sqlite3_change
7300: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a s(sqlite3 *db){.
7310: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
7320: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
7330: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
7340: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
7350: 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
7360: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
7370: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
7380: 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 }.#endif. retur
7390: 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d n db->nChange;.}
73a0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
73b0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 he number of cha
73c0: 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 64 nges since the d
73d0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 77 atabase handle w
73e0: 61 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69 6e as opened..*/.in
73f0: 74 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f t sqlite3_total_
7400: 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 changes(sqlite3
7410: 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *db){.#ifdef SQL
7420: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
7430: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
7440: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
7450: 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
7460: 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
7470: 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
7480: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
7490: 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e 54 6f 74 return db->nTot
74a0: 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a alChange;.}../*.
74b0: 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 6f 70 65 ** Close all ope
74c0: 6e 20 73 61 76 65 70 6f 69 6e 74 73 2e 20 54 68 n savepoints. Th
74d0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 6c 79 is function only
74e0: 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 66 69 65 manipulates fie
74f0: 6c 64 73 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 lds of the.** da
7500: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 6f 62 tabase handle ob
7510: 6a 65 63 74 2c 20 69 74 20 64 6f 65 73 20 6e 6f ject, it does no
7520: 74 20 63 6c 6f 73 65 20 61 6e 79 20 73 61 76 65 t close any save
7530: 70 6f 69 6e 74 73 20 74 68 61 74 20 6d 61 79 20 points that may
7540: 62 65 20 6f 70 65 6e 0a 2a 2a 20 61 74 20 74 68 be open.** at th
7550: 65 20 62 2d 74 72 65 65 2f 70 61 67 65 72 20 6c e b-tree/pager l
7560: 65 76 65 6c 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 evel..*/.void sq
7570: 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 65 70 6f lite3CloseSavepo
7580: 69 6e 74 73 28 73 71 6c 69 74 65 33 20 2a 64 62 ints(sqlite3 *db
7590: 29 7b 0a 20 20 77 68 69 6c 65 28 20 64 62 2d 3e ){. while( db->
75a0: 70 53 61 76 65 70 6f 69 6e 74 20 29 7b 0a 20 20 pSavepoint ){.
75b0: 20 20 53 61 76 65 70 6f 69 6e 74 20 2a 70 54 6d Savepoint *pTm
75c0: 70 20 3d 20 64 62 2d 3e 70 53 61 76 65 70 6f 69 p = db->pSavepoi
75d0: 6e 74 3b 0a 20 20 20 20 64 62 2d 3e 70 53 61 76 nt;. db->pSav
75e0: 65 70 6f 69 6e 74 20 3d 20 70 54 6d 70 2d 3e 70 epoint = pTmp->p
75f0: 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 Next;. sqlite
7600: 33 44 62 46 72 65 65 28 64 62 2c 20 70 54 6d 70 3DbFree(db, pTmp
7610: 29 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6e 53 61 );. }. db->nSa
7620: 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a 20 20 64 vepoint = 0;. d
7630: 62 2d 3e 6e 53 74 61 74 65 6d 65 6e 74 20 3d 20 b->nStatement =
7640: 30 3b 0a 20 20 64 62 2d 3e 69 73 54 72 61 6e 73 0;. db->isTrans
7650: 61 63 74 69 6f 6e 53 61 76 65 70 6f 69 6e 74 20 actionSavepoint
7660: 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e = 0;.}../*.** In
7670: 76 6f 6b 65 20 74 68 65 20 64 65 73 74 72 75 63 voke the destruc
7680: 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 tor function ass
7690: 6f 63 69 61 74 65 64 20 77 69 74 68 20 46 75 6e ociated with Fun
76a0: 63 44 65 66 20 70 2c 20 69 66 20 61 6e 79 2e 20 cDef p, if any.
76b0: 45 78 63 65 70 74 2c 0a 2a 2a 20 69 66 20 74 68 Except,.** if th
76c0: 69 73 20 69 73 20 6e 6f 74 20 74 68 65 20 6c 61 is is not the la
76d0: 73 74 20 63 6f 70 79 20 6f 66 20 74 68 65 20 66 st copy of the f
76e0: 75 6e 63 74 69 6f 6e 2c 20 64 6f 20 6e 6f 74 20 unction, do not
76f0: 69 6e 76 6f 6b 65 20 69 74 2e 20 4d 75 6c 74 69 invoke it. Multi
7700: 70 6c 65 0a 2a 2a 20 63 6f 70 69 65 73 20 6f 66 ple.** copies of
7710: 20 61 20 73 69 6e 67 6c 65 20 66 75 6e 63 74 69 a single functi
7720: 6f 6e 20 61 72 65 20 63 72 65 61 74 65 64 20 77 on are created w
7730: 68 65 6e 20 63 72 65 61 74 65 5f 66 75 6e 63 74 hen create_funct
7740: 69 6f 6e 28 29 20 69 73 20 63 61 6c 6c 65 64 0a ion() is called.
7750: 2a 2a 20 77 69 74 68 20 53 51 4c 49 54 45 5f 41 ** with SQLITE_A
7760: 4e 59 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 NY as the encodi
7770: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ng..*/.static vo
7780: 69 64 20 66 75 6e 63 74 69 6f 6e 44 65 73 74 72 id functionDestr
7790: 6f 79 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 oy(sqlite3 *db,
77a0: 46 75 6e 63 44 65 66 20 2a 70 29 7b 0a 20 20 46 FuncDef *p){. F
77b0: 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 uncDestructor *p
77c0: 44 65 73 74 72 75 63 74 6f 72 20 3d 20 70 2d 3e Destructor = p->
77d0: 70 44 65 73 74 72 75 63 74 6f 72 3b 0a 20 20 69 pDestructor;. i
77e0: 66 28 20 70 44 65 73 74 72 75 63 74 6f 72 20 29 f( pDestructor )
77f0: 7b 0a 20 20 20 20 70 44 65 73 74 72 75 63 74 6f {. pDestructo
7800: 72 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 20 20 69 r->nRef--;. i
7810: 66 28 20 70 44 65 73 74 72 75 63 74 6f 72 2d 3e f( pDestructor->
7820: 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 nRef==0 ){.
7830: 20 70 44 65 73 74 72 75 63 74 6f 72 2d 3e 78 44 pDestructor->xD
7840: 65 73 74 72 6f 79 28 70 44 65 73 74 72 75 63 74 estroy(pDestruct
7850: 6f 72 2d 3e 70 55 73 65 72 44 61 74 61 29 3b 0a or->pUserData);.
7860: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 sqlite3DbF
7870: 72 65 65 28 64 62 2c 20 70 44 65 73 74 72 75 63 ree(db, pDestruc
7880: 74 6f 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a tor);. }. }.
7890: 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 6f 6e 6e }../*.** Disconn
78a0: 65 63 74 20 61 6c 6c 20 73 71 6c 69 74 65 33 5f ect all sqlite3_
78b0: 76 74 61 62 20 6f 62 6a 65 63 74 73 20 74 68 61 vtab objects tha
78c0: 74 20 62 65 6c 6f 6e 67 20 74 6f 20 64 61 74 61 t belong to data
78d0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a base connection.
78e0: 2a 2a 20 64 62 2e 20 54 68 69 73 20 69 73 20 63 ** db. This is c
78f0: 61 6c 6c 65 64 20 77 68 65 6e 20 64 62 20 69 73 alled when db is
7900: 20 62 65 69 6e 67 20 63 6c 6f 73 65 64 2e 0a 2a being closed..*
7910: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 64 69 /.static void di
7920: 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 61 62 28 sconnectAllVtab(
7930: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 sqlite3 *db){.#i
7940: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
7950: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 T_VIRTUALTABLE.
7960: 20 69 6e 74 20 69 3b 0a 20 20 73 71 6c 69 74 65 int i;. sqlite
7970: 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 3BtreeEnterAll(d
7980: 62 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 b);. for(i=0; i
7990: 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a <db->nDb; i++){.
79a0: 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 Schema *pSch
79b0: 65 6d 61 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d ema = db->aDb[i]
79c0: 2e 70 53 63 68 65 6d 61 3b 0a 20 20 20 20 69 66 .pSchema;. if
79d0: 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63 ( db->aDb[i].pSc
79e0: 68 65 6d 61 20 29 7b 0a 20 20 20 20 20 20 48 61 hema ){. Ha
79f0: 73 68 45 6c 65 6d 20 2a 70 3b 0a 20 20 20 20 20 shElem *p;.
7a00: 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 48 61 73 for(p=sqliteHas
7a10: 68 46 69 72 73 74 28 26 70 53 63 68 65 6d 61 2d hFirst(&pSchema-
7a20: 3e 74 62 6c 48 61 73 68 29 3b 20 70 3b 20 70 3d >tblHash); p; p=
7a30: 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28 70 sqliteHashNext(p
7a40: 29 29 7b 0a 20 20 20 20 20 20 20 20 54 61 62 6c )){. Tabl
7a50: 65 20 2a 70 54 61 62 20 3d 20 28 54 61 62 6c 65 e *pTab = (Table
7a60: 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 *)sqliteHashDat
7a70: 61 28 70 29 3b 0a 20 20 20 20 20 20 20 20 69 66 a(p);. if
7a80: 28 20 49 73 56 69 72 74 75 61 6c 28 70 54 61 62 ( IsVirtual(pTab
7a90: 29 20 29 20 73 71 6c 69 74 65 33 56 74 61 62 44 ) ) sqlite3VtabD
7aa0: 69 73 63 6f 6e 6e 65 63 74 28 64 62 2c 20 70 54 isconnect(db, pT
7ab0: 61 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ab);. }.
7ac0: 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 }. }. sqlite3
7ad0: 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 64 VtabUnlockList(d
7ae0: 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 b);. sqlite3Btr
7af0: 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 3b 0a eeLeaveAll(db);.
7b00: 23 65 6c 73 65 0a 20 20 55 4e 55 53 45 44 5f 50 #else. UNUSED_P
7b10: 41 52 41 4d 45 54 45 52 28 64 62 29 3b 0a 23 65 ARAMETER(db);.#e
7b20: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 ndif.}../*.** Re
7b30: 74 75 72 6e 20 54 52 55 45 20 69 66 20 64 61 74 turn TRUE if dat
7b40: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
7b50: 20 64 62 20 68 61 73 20 75 6e 66 69 6e 61 6c 69 db has unfinali
7b60: 7a 65 64 20 70 72 65 70 61 72 65 64 0a 2a 2a 20 zed prepared.**
7b70: 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e statements or un
7b80: 66 69 6e 69 73 68 65 64 20 73 71 6c 69 74 65 33 finished sqlite3
7b90: 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 2e _backup objects.
7ba0: 20 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 .*/.static int
7bb0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 connectionIsBus
7bc0: 79 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a y(sqlite3 *db){.
7bd0: 20 20 69 6e 74 20 6a 3b 0a 20 20 61 73 73 65 72 int j;. asser
7be0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
7bf0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 _held(db->mutex)
7c00: 20 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 70 56 );. if( db->pV
7c10: 64 62 65 20 29 20 72 65 74 75 72 6e 20 31 3b 0a dbe ) return 1;.
7c20: 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d for(j=0; j<db-
7c30: 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 >nDb; j++){.
7c40: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d Btree *pBt = db-
7c50: 3e 61 44 62 5b 6a 5d 2e 70 42 74 3b 0a 20 20 20 >aDb[j].pBt;.
7c60: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 if( pBt && sqli
7c70: 74 65 33 42 74 72 65 65 49 73 49 6e 42 61 63 6b te3BtreeIsInBack
7c80: 75 70 28 70 42 74 29 20 29 20 72 65 74 75 72 6e up(pBt) ) return
7c90: 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 1;. }. return
7ca0: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 0;.}../*.** Clo
7cb0: 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 20 53 se an existing S
7cc0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a 2a QLite database.*
7cd0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c /.static int sql
7ce0: 69 74 65 33 43 6c 6f 73 65 28 73 71 6c 69 74 65 ite3Close(sqlite
7cf0: 33 20 2a 64 62 2c 20 69 6e 74 20 66 6f 72 63 65 3 *db, int force
7d00: 5a 6f 6d 62 69 65 29 7b 0a 20 20 69 66 28 20 21 Zombie){. if( !
7d10: 64 62 20 29 7b 0a 20 20 20 20 2f 2a 20 45 56 49 db ){. /* EVI
7d20: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 33 32 35 DENCE-OF: R-6325
7d30: 37 2d 31 31 37 34 30 20 43 61 6c 6c 69 6e 67 20 7-11740 Calling
7d40: 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 29 20 sqlite3_close()
7d50: 6f 72 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 or. ** sqlite
7d60: 33 5f 63 6c 6f 73 65 5f 76 32 28 29 20 77 69 74 3_close_v2() wit
7d70: 68 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 h a NULL pointer
7d80: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 68 argument is a h
7d90: 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f 70 2e 20 2a armless no-op. *
7da0: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
7db0: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 ITE_OK;. }. if
7dc0: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
7dd0: 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 CheckSickOrOk(db
7de0: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
7df0: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
7e00: 50 54 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 PT;. }. sqlite
7e10: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
7e20: 2d 3e 6d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 ->mutex);.. /*
7e30: 46 6f 72 63 65 20 78 44 69 73 63 6f 6e 6e 65 63 Force xDisconnec
7e40: 74 20 63 61 6c 6c 73 20 6f 6e 20 61 6c 6c 20 76 t calls on all v
7e50: 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 2a 2f irtual tables */
7e60: 0a 20 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c . disconnectAll
7e70: 56 74 61 62 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 Vtab(db);.. /*
7e80: 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
7e90: 20 69 73 20 6f 70 65 6e 2c 20 74 68 65 20 64 69 is open, the di
7ea0: 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 74 61 62 28 sconnectAllVtab(
7eb0: 29 20 63 61 6c 6c 20 61 62 6f 76 65 0a 20 20 2a ) call above. *
7ec0: 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 61 76 65 20 * will not have
7ed0: 63 61 6c 6c 65 64 20 74 68 65 20 78 44 69 73 63 called the xDisc
7ee0: 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f 64 20 onnect() method
7ef0: 6f 6e 20 61 6e 79 20 76 69 72 74 75 61 6c 0a 20 on any virtual.
7f00: 20 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 74 68 ** tables in th
7f10: 65 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b 5d 20 e db->aVTrans[]
7f20: 61 72 72 61 79 2e 20 54 68 65 20 66 6f 6c 6c 6f array. The follo
7f30: 77 69 6e 67 20 73 71 6c 69 74 65 33 56 74 61 62 wing sqlite3Vtab
7f40: 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 20 2a 2a 20 Rollback(). **
7f50: 63 61 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 6f 2e call will do so.
7f60: 20 57 65 20 6e 65 65 64 20 74 6f 20 64 6f 20 74 We need to do t
7f70: 68 69 73 20 62 65 66 6f 72 65 20 74 68 65 20 63 his before the c
7f80: 68 65 63 6b 20 66 6f 72 20 61 63 74 69 76 65 0a heck for active.
7f90: 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 ** SQL stateme
7fa0: 6e 74 73 20 62 65 6c 6f 77 2c 20 61 73 20 74 68 nts below, as th
7fb0: 65 20 76 2d 74 61 62 6c 65 20 69 6d 70 6c 65 6d e v-table implem
7fc0: 65 6e 74 61 74 69 6f 6e 20 6d 61 79 20 62 65 20 entation may be
7fd0: 73 74 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 6f 6d storing. ** som
7fe0: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 e prepared state
7ff0: 6d 65 6e 74 73 20 69 6e 74 65 72 6e 61 6c 6c 79 ments internally
8000: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
8010: 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 62 29 VtabRollback(db)
8020: 3b 0a 0a 20 20 2f 2a 20 4c 65 67 61 63 79 20 62 ;.. /* Legacy b
8030: 65 68 61 76 69 6f 72 20 28 73 71 6c 69 74 65 33 ehavior (sqlite3
8040: 5f 63 6c 6f 73 65 28 29 20 62 65 68 61 76 69 6f _close() behavio
8050: 72 29 20 69 73 20 74 6f 20 72 65 74 75 72 6e 0a r) is to return.
8060: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 ** SQLITE_BUSY
8070: 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 if the connecti
8080: 6f 6e 20 63 61 6e 20 6e 6f 74 20 62 65 20 63 6c on can not be cl
8090: 6f 73 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 osed immediately
80a0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 66 6f .. */. if( !fo
80b0: 72 63 65 5a 6f 6d 62 69 65 20 26 26 20 63 6f 6e rceZombie && con
80c0: 6e 65 63 74 69 6f 6e 49 73 42 75 73 79 28 64 62 nectionIsBusy(db
80d0: 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) ){. sqlite3
80e0: 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c ErrorWithMsg(db,
80f0: 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 22 75 SQLITE_BUSY, "u
8100: 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 65 20 64 nable to close d
8110: 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c 69 7a 65 ue to unfinalize
8120: 64 20 22 0a 20 20 20 20 20 20 20 22 73 74 61 74 d ". "stat
8130: 65 6d 65 6e 74 73 20 6f 72 20 75 6e 66 69 6e 69 ements or unfini
8140: 73 68 65 64 20 62 61 63 6b 75 70 73 22 29 3b 0a shed backups");.
8150: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
8160: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
8170: 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 x);. return S
8180: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a QLITE_BUSY;. }.
8190: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
81a0: 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 69 NABLE_SQLLOG. i
81b0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
81c0: 43 6f 6e 66 69 67 2e 78 53 71 6c 6c 6f 67 20 29 Config.xSqllog )
81d0: 7b 0a 20 20 20 20 2f 2a 20 43 6c 6f 73 69 6e 67 {. /* Closing
81e0: 20 74 68 65 20 68 61 6e 64 6c 65 2e 20 46 6f 75 the handle. Fou
81f0: 72 74 68 20 70 61 72 61 6d 65 74 65 72 20 69 73 rth parameter is
8200: 20 70 61 73 73 65 64 20 74 68 65 20 76 61 6c 75 passed the valu
8210: 65 20 32 2e 20 2a 2f 0a 20 20 20 20 73 71 6c 69 e 2. */. sqli
8220: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
8230: 78 53 71 6c 6c 6f 67 28 73 71 6c 69 74 65 33 47 xSqllog(sqlite3G
8240: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 71 6c lobalConfig.pSql
8250: 6c 6f 67 41 72 67 2c 20 64 62 2c 20 30 2c 20 32 logArg, db, 0, 2
8260: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 );. }.#endif..
8270: 20 2f 2a 20 43 6f 6e 76 65 72 74 20 74 68 65 20 /* Convert the
8280: 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 6e 74 6f 20 connection into
8290: 61 20 7a 6f 6d 62 69 65 20 61 6e 64 20 74 68 65 a zombie and the
82a0: 6e 20 63 6c 6f 73 65 20 69 74 2e 0a 20 20 2a 2f n close it.. */
82b0: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
82c0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 QLITE_MAGIC_ZOMB
82d0: 49 45 3b 0a 20 20 73 71 6c 69 74 65 33 4c 65 61 IE;. sqlite3Lea
82e0: 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a veMutexAndCloseZ
82f0: 6f 6d 62 69 65 28 64 62 29 3b 0a 20 20 72 65 74 ombie(db);. ret
8300: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
8310: 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 76 61 72 69 ../*.** Two vari
8320: 61 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 70 75 ations on the pu
8330: 62 6c 69 63 20 69 6e 74 65 72 66 61 63 65 20 66 blic interface f
8340: 6f 72 20 63 6c 6f 73 69 6e 67 20 61 20 64 61 74 or closing a dat
8350: 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 abase.** connect
8360: 69 6f 6e 2e 20 54 68 65 20 73 71 6c 69 74 65 33 ion. The sqlite3
8370: 5f 63 6c 6f 73 65 28 29 20 76 65 72 73 69 6f 6e _close() version
8380: 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f returns SQLITE_
8390: 42 55 53 59 20 61 6e 64 0a 2a 2a 20 6c 65 61 76 BUSY and.** leav
83a0: 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f es the connectio
83b0: 6e 20 6f 70 74 69 6f 6e 20 69 66 20 74 68 65 72 n option if ther
83c0: 65 20 61 72 65 20 75 6e 66 69 6e 61 6c 69 7a 65 e are unfinalize
83d0: 64 20 70 72 65 70 61 72 65 64 0a 2a 2a 20 73 74 d prepared.** st
83e0: 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e 66 69 atements or unfi
83f0: 6e 69 73 68 65 64 20 73 71 6c 69 74 65 33 5f 62 nished sqlite3_b
8400: 61 63 6b 75 70 73 2e 20 20 54 68 65 20 73 71 6c ackups. The sql
8410: 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32 28 29 0a ite3_close_v2().
8420: 2a 2a 20 76 65 72 73 69 6f 6e 20 66 6f 72 63 65 ** version force
8430: 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e s the connection
8440: 20 74 6f 20 62 65 63 6f 6d 65 20 61 20 7a 6f 6d to become a zom
8450: 62 69 65 20 69 66 20 74 68 65 72 65 20 61 72 65 bie if there are
8460: 0a 2a 2a 20 75 6e 63 6c 6f 73 65 64 20 72 65 73 .** unclosed res
8470: 6f 75 72 63 65 73 2c 20 61 6e 64 20 61 72 72 61 ources, and arra
8480: 6e 67 65 73 20 66 6f 72 20 64 65 61 6c 6c 6f 63 nges for dealloc
8490: 61 74 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 6c ation when the l
84a0: 61 73 74 0a 2a 2a 20 70 72 65 70 61 72 65 20 73 ast.** prepare s
84b0: 74 61 74 65 6d 65 6e 74 20 6f 72 20 73 71 6c 69 tatement or sqli
84c0: 74 65 33 5f 62 61 63 6b 75 70 20 63 6c 6f 73 65 te3_backup close
84d0: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
84e0: 33 5f 63 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 3_close(sqlite3
84f0: 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 73 71 6c *db){ return sql
8500: 69 74 65 33 43 6c 6f 73 65 28 64 62 2c 30 29 3b ite3Close(db,0);
8510: 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 }.int sqlite3_c
8520: 6c 6f 73 65 5f 76 32 28 73 71 6c 69 74 65 33 20 lose_v2(sqlite3
8530: 2a 64 62 29 7b 20 72 65 74 75 72 6e 20 73 71 6c *db){ return sql
8540: 69 74 65 33 43 6c 6f 73 65 28 64 62 2c 31 29 3b ite3Close(db,1);
8550: 20 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 }.../*.** Close
8560: 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 64 61 the mutex on da
8570: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
8580: 6e 20 64 62 2e 0a 2a 2a 0a 2a 2a 20 46 75 72 74 n db..**.** Furt
8590: 68 65 72 6d 6f 72 65 2c 20 69 66 20 64 61 74 61 hermore, if data
85a0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
85b0: 64 62 20 69 73 20 61 20 7a 6f 6d 62 69 65 20 28 db is a zombie (
85c0: 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 74 68 65 meaning that the
85d0: 72 65 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 61 re.** has been a
85e0: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 20 73 prior call to s
85f0: 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 qlite3_close(db)
8600: 20 6f 72 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 or sqlite3_clos
8610: 65 5f 76 32 28 64 62 29 29 20 61 6e 64 0a 2a 2a e_v2(db)) and.**
8620: 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 5f 73 every sqlite3_s
8630: 74 6d 74 20 68 61 73 20 6e 6f 77 20 62 65 65 6e tmt has now been
8640: 20 66 69 6e 61 6c 69 7a 65 64 20 61 6e 64 20 65 finalized and e
8650: 76 65 72 79 20 73 71 6c 69 74 65 33 5f 62 61 63 very sqlite3_bac
8660: 6b 75 70 20 68 61 73 0a 2a 2a 20 66 69 6e 69 73 kup has.** finis
8670: 68 65 64 2c 20 74 68 65 6e 20 66 72 65 65 20 61 hed, then free a
8680: 6c 6c 20 72 65 73 6f 75 72 63 65 73 2e 0a 2a 2f ll resources..*/
8690: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4c 65 61 .void sqlite3Lea
86a0: 76 65 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a veMutexAndCloseZ
86b0: 6f 6d 62 69 65 28 73 71 6c 69 74 65 33 20 2a 64 ombie(sqlite3 *d
86c0: 62 29 7b 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a b){. HashElem *
86d0: 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
86e0: 20 20 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 /* Hash ta
86f0: 62 6c 65 20 69 74 65 72 61 74 6f 72 20 2a 2f 0a ble iterator */.
8700: 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 2f 2a 20 49 int j;.. /* I
8710: 66 20 74 68 65 72 65 20 61 72 65 20 6f 75 74 73 f there are outs
8720: 74 61 6e 64 69 6e 67 20 73 71 6c 69 74 65 33 5f tanding sqlite3_
8730: 73 74 6d 74 20 6f 72 20 73 71 6c 69 74 65 33 5f stmt or sqlite3_
8740: 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 0a 20 backup objects.
8750: 20 2a 2a 20 6f 72 20 69 66 20 74 68 65 20 63 6f ** or if the co
8760: 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 6e 6f 74 nnection has not
8770: 20 79 65 74 20 62 65 65 6e 20 63 6c 6f 73 65 64 yet been closed
8780: 20 62 79 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 by sqlite3_clos
8790: 65 5f 76 32 28 29 2c 0a 20 20 2a 2a 20 74 68 65 e_v2(),. ** the
87a0: 6e 20 6a 75 73 74 20 6c 65 61 76 65 20 74 68 65 n just leave the
87b0: 20 6d 75 74 65 78 20 61 6e 64 20 72 65 74 75 72 mutex and retur
87c0: 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 n.. */. if( db
87d0: 2d 3e 6d 61 67 69 63 21 3d 53 51 4c 49 54 45 5f ->magic!=SQLITE_
87e0: 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 20 7c 7c 20 MAGIC_ZOMBIE ||
87f0: 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 79 connectionIsBusy
8800: 28 64 62 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 (db) ){. sqli
8810: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
8820: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 db->mutex);.
8830: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 0a 20 20 2f return;. }.. /
8840: 2a 20 49 66 20 77 65 20 72 65 61 63 68 20 74 68 * If we reach th
8850: 69 73 20 70 6f 69 6e 74 2c 20 69 74 20 6d 65 61 is point, it mea
8860: 6e 73 20 74 68 61 74 20 74 68 65 20 64 61 74 61 ns that the data
8870: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
8880: 68 61 73 0a 20 20 2a 2a 20 63 6c 6f 73 65 64 20 has. ** closed
8890: 61 6c 6c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 all sqlite3_stmt
88a0: 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 62 61 63 and sqlite3_bac
88b0: 6b 75 70 20 6f 62 6a 65 63 74 73 20 61 6e 64 20 kup objects and
88c0: 68 61 73 20 62 65 65 6e 0a 20 20 2a 2a 20 70 61 has been. ** pa
88d0: 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 33 5f ssed to sqlite3_
88e0: 63 6c 6f 73 65 20 28 6d 65 61 6e 69 6e 67 20 74 close (meaning t
88f0: 68 61 74 20 69 74 20 69 73 20 61 20 7a 6f 6d 62 hat it is a zomb
8900: 69 65 29 2e 20 20 54 68 65 72 65 66 6f 72 65 2c ie). Therefore,
8910: 0a 20 20 2a 2a 20 67 6f 20 61 68 65 61 64 20 61 . ** go ahead a
8920: 6e 64 20 66 72 65 65 20 61 6c 6c 20 72 65 73 6f nd free all reso
8930: 75 72 63 65 73 2e 0a 20 20 2a 2f 0a 0a 20 20 2f urces.. */.. /
8940: 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 * If a transacti
8950: 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 72 6f 6c 6c on is open, roll
8960: 20 69 74 20 62 61 63 6b 2e 20 54 68 69 73 20 61 it back. This a
8970: 6c 73 6f 20 65 6e 73 75 72 65 73 20 74 68 61 74 lso ensures that
8980: 20 69 66 0a 20 20 2a 2a 20 61 6e 79 20 64 61 74 if. ** any dat
8990: 61 62 61 73 65 20 73 63 68 65 6d 61 73 20 68 61 abase schemas ha
89a0: 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 ve been modified
89b0: 20 62 79 20 61 6e 20 75 6e 63 6f 6d 6d 69 74 74 by an uncommitt
89c0: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 ed transaction.
89d0: 20 2a 2a 20 74 68 65 79 20 61 72 65 20 72 65 73 ** they are res
89e0: 65 74 2e 20 41 6e 64 20 74 68 61 74 20 74 68 65 et. And that the
89f0: 20 72 65 71 75 69 72 65 64 20 62 2d 74 72 65 65 required b-tree
8a00: 20 6d 75 74 65 78 20 69 73 20 68 65 6c 64 20 74 mutex is held t
8a10: 6f 20 6d 61 6b 65 0a 20 20 2a 2a 20 74 68 65 20 o make. ** the
8a20: 70 61 67 65 72 20 72 6f 6c 6c 62 61 63 6b 20 61 pager rollback a
8a30: 6e 64 20 73 63 68 65 6d 61 20 72 65 73 65 74 20 nd schema reset
8a40: 61 6e 20 61 74 6f 6d 69 63 20 6f 70 65 72 61 74 an atomic operat
8a50: 69 6f 6e 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ion. */. sqlite
8a60: 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 2c 3RollbackAll(db,
8a70: 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 0a 20 20 SQLITE_OK);..
8a80: 2f 2a 20 46 72 65 65 20 61 6e 79 20 6f 75 74 73 /* Free any outs
8a90: 74 61 6e 64 69 6e 67 20 53 61 76 65 70 6f 69 6e tanding Savepoin
8aa0: 74 20 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f t structures. */
8ab0: 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 . sqlite3CloseS
8ac0: 61 76 65 70 6f 69 6e 74 73 28 64 62 29 3b 0a 0a avepoints(db);..
8ad0: 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 64 /* Close all d
8ae0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
8af0: 6f 6e 73 20 2a 2f 0a 20 20 66 6f 72 28 6a 3d 30 ons */. for(j=0
8b00: 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b ; j<db->nDb; j++
8b10: 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 44 62 ){. struct Db
8b20: 20 2a 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 *pDb = &db->aDb
8b30: 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 70 44 62 [j];. if( pDb
8b40: 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 20 73 ->pBt ){. s
8b50: 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 qlite3BtreeClose
8b60: 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 20 20 (pDb->pBt);.
8b70: 20 20 70 44 62 2d 3e 70 42 74 20 3d 20 30 3b 0a pDb->pBt = 0;.
8b80: 20 20 20 20 20 20 69 66 28 20 6a 21 3d 31 20 29 if( j!=1 )
8b90: 7b 0a 20 20 20 20 20 20 20 20 70 44 62 2d 3e 70 {. pDb->p
8ba0: 53 63 68 65 6d 61 20 3d 20 30 3b 0a 20 20 20 20 Schema = 0;.
8bb0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 }. }. }.
8bc0: 2f 2a 20 43 6c 65 61 72 20 74 68 65 20 54 45 4d /* Clear the TEM
8bd0: 50 20 73 63 68 65 6d 61 20 73 65 70 61 72 61 74 P schema separat
8be0: 65 6c 79 20 61 6e 64 20 6c 61 73 74 20 2a 2f 0a ely and last */.
8bf0: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 31 5d if( db->aDb[1]
8c00: 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 .pSchema ){.
8c10: 73 71 6c 69 74 65 33 53 63 68 65 6d 61 43 6c 65 sqlite3SchemaCle
8c20: 61 72 28 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 ar(db->aDb[1].pS
8c30: 63 68 65 6d 61 29 3b 0a 20 20 7d 0a 20 20 73 71 chema);. }. sq
8c40: 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c lite3VtabUnlockL
8c50: 69 73 74 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 46 ist(db);.. /* F
8c60: 72 65 65 20 75 70 20 74 68 65 20 61 72 72 61 79 ree up the array
8c70: 20 6f 66 20 61 75 78 69 6c 69 61 72 79 20 64 61 of auxiliary da
8c80: 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 73 71 6c tabases */. sql
8c90: 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 61 74 61 ite3CollapseData
8ca0: 62 61 73 65 41 72 72 61 79 28 64 62 29 3b 0a 20 baseArray(db);.
8cb0: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 assert( db->nDb
8cc0: 3c 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 <=2 );. assert(
8cd0: 20 64 62 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 db->aDb==db->aD
8ce0: 62 53 74 61 74 69 63 20 29 3b 0a 0a 20 20 2f 2a bStatic );.. /*
8cf0: 20 54 65 6c 6c 20 74 68 65 20 63 6f 64 65 20 69 Tell the code i
8d00: 6e 20 6e 6f 74 69 66 79 2e 63 20 74 68 61 74 20 n notify.c that
8d10: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6e the connection n
8d20: 6f 20 6c 6f 6e 67 65 72 20 68 6f 6c 64 73 20 61 o longer holds a
8d30: 6e 79 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 61 6e ny. ** locks an
8d40: 64 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 d does not requi
8d50: 72 65 20 61 6e 79 20 66 75 72 74 68 65 72 20 75 re any further u
8d60: 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c nlock-notify cal
8d70: 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 20 73 lbacks.. */. s
8d80: 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e qlite3Connection
8d90: 43 6c 6f 73 65 64 28 64 62 29 3b 0a 0a 20 20 66 Closed(db);.. f
8da0: 6f 72 28 6a 3d 30 3b 20 6a 3c 41 72 72 61 79 53 or(j=0; j<ArrayS
8db0: 69 7a 65 28 64 62 2d 3e 61 46 75 6e 63 2e 61 29 ize(db->aFunc.a)
8dc0: 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 46 75 6e 63 ; j++){. Func
8dd0: 44 65 66 20 2a 70 4e 65 78 74 2c 20 2a 70 48 61 Def *pNext, *pHa
8de0: 73 68 2c 20 2a 70 3b 0a 20 20 20 20 66 6f 72 28 sh, *p;. for(
8df0: 70 3d 64 62 2d 3e 61 46 75 6e 63 2e 61 5b 6a 5d p=db->aFunc.a[j]
8e00: 3b 20 70 3b 20 70 3d 70 48 61 73 68 29 7b 0a 20 ; p; p=pHash){.
8e10: 20 20 20 20 20 70 48 61 73 68 20 3d 20 70 2d 3e pHash = p->
8e20: 70 48 61 73 68 3b 0a 20 20 20 20 20 20 77 68 69 pHash;. whi
8e30: 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 20 20 20 le( p ){.
8e40: 20 66 75 6e 63 74 69 6f 6e 44 65 73 74 72 6f 79 functionDestroy
8e50: 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 20 (db, p);.
8e60: 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 pNext = p->pNex
8e70: 74 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 t;. sqlit
8e80: 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 29 3b e3DbFree(db, p);
8e90: 0a 20 20 20 20 20 20 20 20 70 20 3d 20 70 4e 65 . p = pNe
8ea0: 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 xt;. }.
8eb0: 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d 73 71 }. }. for(i=sq
8ec0: 6c 69 74 65 48 61 73 68 46 69 72 73 74 28 26 64 liteHashFirst(&d
8ed0: 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 20 69 3b b->aCollSeq); i;
8ee0: 20 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 i=sqliteHashNex
8ef0: 74 28 69 29 29 7b 0a 20 20 20 20 43 6f 6c 6c 53 t(i)){. CollS
8f00: 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c eq *pColl = (Col
8f10: 6c 53 65 71 20 2a 29 73 71 6c 69 74 65 48 61 73 lSeq *)sqliteHas
8f20: 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20 2f 2a hData(i);. /*
8f30: 20 49 6e 76 6f 6b 65 20 61 6e 79 20 64 65 73 74 Invoke any dest
8f40: 72 75 63 74 6f 72 73 20 72 65 67 69 73 74 65 72 ructors register
8f50: 65 64 20 66 6f 72 20 63 6f 6c 6c 61 74 69 6f 6e ed for collation
8f60: 20 73 65 71 75 65 6e 63 65 20 75 73 65 72 20 64 sequence user d
8f70: 61 74 61 2e 20 2a 2f 0a 20 20 20 20 66 6f 72 28 ata. */. for(
8f80: 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a j=0; j<3; j++){.
8f90: 20 20 20 20 20 20 69 66 28 20 70 43 6f 6c 6c 5b if( pColl[
8fa0: 6a 5d 2e 78 44 65 6c 20 29 7b 0a 20 20 20 20 20 j].xDel ){.
8fb0: 20 20 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c pColl[j].xDel
8fc0: 28 70 43 6f 6c 6c 5b 6a 5d 2e 70 55 73 65 72 29 (pColl[j].pUser)
8fd0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
8fe0: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
8ff0: 65 28 64 62 2c 20 70 43 6f 6c 6c 29 3b 0a 20 20 e(db, pColl);.
9000: 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 }. sqlite3HashC
9010: 6c 65 61 72 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 lear(&db->aCollS
9020: 65 71 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c eq);.#ifndef SQL
9030: 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
9040: 54 41 42 4c 45 0a 20 20 66 6f 72 28 69 3d 73 71 TABLE. for(i=sq
9050: 6c 69 74 65 48 61 73 68 46 69 72 73 74 28 26 64 liteHashFirst(&d
9060: 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 20 69 3b 20 b->aModule); i;
9070: 69 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 78 74 i=sqliteHashNext
9080: 28 69 29 29 7b 0a 20 20 20 20 4d 6f 64 75 6c 65 (i)){. Module
9090: 20 2a 70 4d 6f 64 20 3d 20 28 4d 6f 64 75 6c 65 *pMod = (Module
90a0: 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 *)sqliteHashDat
90b0: 61 28 69 29 3b 0a 20 20 20 20 69 66 28 20 70 4d a(i);. if( pM
90c0: 6f 64 2d 3e 78 44 65 73 74 72 6f 79 20 29 7b 0a od->xDestroy ){.
90d0: 20 20 20 20 20 20 70 4d 6f 64 2d 3e 78 44 65 73 pMod->xDes
90e0: 74 72 6f 79 28 70 4d 6f 64 2d 3e 70 41 75 78 29 troy(pMod->pAux)
90f0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
9100: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 4d te3DbFree(db, pM
9110: 6f 64 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 od);. }. sqlit
9120: 65 33 48 61 73 68 43 6c 65 61 72 28 26 64 62 2d e3HashClear(&db-
9130: 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 65 6e 64 69 >aModule);.#endi
9140: 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f f.. sqlite3Erro
9150: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 r(db, SQLITE_OK)
9160: 3b 20 2f 2a 20 44 65 61 6c 6c 6f 63 61 74 65 73 ; /* Deallocates
9170: 20 61 6e 79 20 63 61 63 68 65 64 20 65 72 72 6f any cached erro
9180: 72 20 73 74 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 r strings. */.
9190: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 sqlite3ValueFree
91a0: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 73 71 (db->pErr);. sq
91b0: 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 lite3CloseExtens
91c0: 69 6f 6e 73 28 64 62 29 3b 0a 23 69 66 20 53 51 ions(db);.#if SQ
91d0: 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 4e LITE_USER_AUTHEN
91e0: 54 49 43 41 54 49 4f 4e 0a 20 20 73 71 6c 69 74 TICATION. sqlit
91f0: 65 33 5f 66 72 65 65 28 64 62 2d 3e 61 75 74 68 e3_free(db->auth
9200: 2e 7a 41 75 74 68 55 73 65 72 29 3b 0a 20 20 73 .zAuthUser);. s
9210: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e qlite3_free(db->
9220: 61 75 74 68 2e 7a 41 75 74 68 50 57 29 3b 0a 23 auth.zAuthPW);.#
9230: 65 6e 64 69 66 0a 0a 20 20 64 62 2d 3e 6d 61 67 endif.. db->mag
9240: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 ic = SQLITE_MAGI
9250: 43 5f 45 52 52 4f 52 3b 0a 0a 20 20 2f 2a 20 54 C_ERROR;.. /* T
9260: 68 65 20 74 65 6d 70 2d 64 61 74 61 62 61 73 65 he temp-database
9270: 20 73 63 68 65 6d 61 20 69 73 20 61 6c 6c 6f 63 schema is alloc
9280: 61 74 65 64 20 64 69 66 66 65 72 65 6e 74 6c 79 ated differently
9290: 20 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 20 from the other
92a0: 73 63 68 65 6d 61 0a 20 20 2a 2a 20 6f 62 6a 65 schema. ** obje
92b0: 63 74 73 20 28 75 73 69 6e 67 20 73 71 6c 69 74 cts (using sqlit
92c0: 65 4d 61 6c 6c 6f 63 28 29 20 64 69 72 65 63 74 eMalloc() direct
92d0: 6c 79 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 73 ly, instead of s
92e0: 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 6d qlite3BtreeSchem
92f0: 61 28 29 29 2e 0a 20 20 2a 2a 20 53 6f 20 69 74 a()).. ** So it
9300: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 66 72 65 needs to be fre
9310: 65 64 20 68 65 72 65 2e 20 54 6f 64 6f 3a 20 57 ed here. Todo: W
9320: 68 79 20 6e 6f 74 20 72 6f 6c 6c 20 74 68 65 20 hy not roll the
9330: 74 65 6d 70 20 73 63 68 65 6d 61 20 69 6e 74 6f temp schema into
9340: 0a 20 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 73 . ** the same s
9350: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 61 73 qliteMalloc() as
9360: 20 74 68 65 20 6f 6e 65 20 74 68 61 74 20 61 6c the one that al
9370: 6c 6f 63 61 74 65 73 20 74 68 65 20 64 61 74 61 locates the data
9380: 62 61 73 65 20 0a 20 20 2a 2a 20 73 74 72 75 63 base . ** struc
9390: 74 75 72 65 3f 0a 20 20 2a 2f 0a 20 20 73 71 6c ture?. */. sql
93a0: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 64 ite3DbFree(db, d
93b0: 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 6d b->aDb[1].pSchem
93c0: 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 a);. sqlite3_mu
93d0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
93e0: 74 65 78 29 3b 0a 20 20 64 62 2d 3e 6d 61 67 69 tex);. db->magi
93f0: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 c = SQLITE_MAGIC
9400: 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 71 6c 69 74 _CLOSED;. sqlit
9410: 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 64 62 e3_mutex_free(db
9420: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 ->mutex);. asse
9430: 72 74 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 rt( db->lookasid
9440: 65 2e 6e 4f 75 74 3d 3d 30 20 29 3b 20 20 2f 2a e.nOut==0 ); /*
9450: 20 46 61 69 6c 73 20 6f 6e 20 61 20 6c 6f 6f 6b Fails on a look
9460: 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 6c 65 61 aside memory lea
9470: 6b 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 6c k */. if( db->l
9480: 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 ookaside.bMalloc
9490: 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ed ){. sqlite
94a0: 33 5f 66 72 65 65 28 64 62 2d 3e 6c 6f 6f 6b 61 3_free(db->looka
94b0: 73 69 64 65 2e 70 53 74 61 72 74 29 3b 0a 20 20 side.pStart);.
94c0: 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f }.#ifdef SQLITE_
94d0: 45 4e 41 42 4c 45 5f 53 51 4c 52 52 0a 20 20 53 ENABLE_SQLRR. S
94e0: 52 52 65 63 43 6c 6f 73 65 28 64 62 29 3b 0a 23 RRecClose(db);.#
94f0: 65 6e 64 69 66 0a 20 20 0a 20 20 73 71 6c 69 74 endif. . sqlit
9500: 65 33 5f 66 72 65 65 28 64 62 29 3b 0a 7d 0a 0a e3_free(db);.}..
9510: 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 /*.** Rollback a
9520: 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ll database file
9530: 73 2e 20 20 49 66 20 74 72 69 70 43 6f 64 65 20 s. If tripCode
9540: 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b is not SQLITE_OK
9550: 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e 79 20 77 72 , then.** any wr
9560: 69 74 65 20 63 75 72 73 6f 72 73 20 61 72 65 20 ite cursors are
9570: 69 6e 76 61 6c 69 64 61 74 65 64 20 28 22 74 72 invalidated ("tr
9580: 69 70 70 65 64 22 20 2d 20 61 73 20 69 6e 20 22 ipped" - as in "
9590: 74 72 69 70 70 69 6e 67 20 61 20 63 69 72 63 75 tripping a circu
95a0: 69 74 0a 2a 2a 20 62 72 65 61 6b 65 72 22 29 20 it.** breaker")
95b0: 61 6e 64 20 6d 61 64 65 20 74 6f 20 72 65 74 75 and made to retu
95c0: 72 6e 20 74 72 69 70 43 6f 64 65 20 69 66 20 74 rn tripCode if t
95d0: 68 65 72 65 20 61 72 65 20 61 6e 79 20 66 75 72 here are any fur
95e0: 74 68 65 72 0a 2a 2a 20 61 74 74 65 6d 70 74 73 ther.** attempts
95f0: 20 74 6f 20 75 73 65 20 74 68 61 74 20 63 75 72 to use that cur
9600: 73 6f 72 2e 20 20 52 65 61 64 20 63 75 72 73 6f sor. Read curso
9610: 72 73 20 72 65 6d 61 69 6e 20 6f 70 65 6e 20 61 rs remain open a
9620: 6e 64 20 76 61 6c 69 64 0a 2a 2a 20 62 75 74 20 nd valid.** but
9630: 61 72 65 20 22 73 61 76 65 64 22 20 69 6e 20 63 are "saved" in c
9640: 61 73 65 20 74 68 65 20 74 61 62 6c 65 20 70 61 ase the table pa
9650: 67 65 73 20 61 72 65 20 6d 6f 76 65 64 20 61 72 ges are moved ar
9660: 6f 75 6e 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 ound..*/.void sq
9670: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c lite3RollbackAll
9680: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e (sqlite3 *db, in
9690: 74 20 74 72 69 70 43 6f 64 65 29 7b 0a 20 20 69 t tripCode){. i
96a0: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 69 6e 54 72 nt i;. int inTr
96b0: 61 6e 73 20 3d 20 30 3b 0a 20 20 69 6e 74 20 73 ans = 0;. int s
96c0: 63 68 65 6d 61 43 68 61 6e 67 65 3b 0a 20 20 61 chemaChange;. a
96d0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
96e0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
96f0: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
9700: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
9710: 6f 63 28 29 3b 0a 0a 20 20 2f 2a 20 4f 62 74 61 oc();.. /* Obta
9720: 69 6e 20 61 6c 6c 20 62 2d 74 72 65 65 20 6d 75 in all b-tree mu
9730: 74 65 78 65 73 20 62 65 66 6f 72 65 20 6d 61 6b texes before mak
9740: 69 6e 67 20 61 6e 79 20 63 61 6c 6c 73 20 74 6f ing any calls to
9750: 20 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 BtreeRollback()
9760: 2e 20 0a 20 20 2a 2a 20 54 68 69 73 20 69 73 20 . . ** This is
9770: 69 6d 70 6f 72 74 61 6e 74 20 69 6e 20 63 61 73 important in cas
9780: 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f e the transactio
9790: 6e 20 62 65 69 6e 67 20 72 6f 6c 6c 65 64 20 62 n being rolled b
97a0: 61 63 6b 20 68 61 73 0a 20 20 2a 2a 20 6d 6f 64 ack has. ** mod
97b0: 69 66 69 65 64 20 74 68 65 20 64 61 74 61 62 61 ified the databa
97c0: 73 65 20 73 63 68 65 6d 61 2e 20 49 66 20 74 68 se schema. If th
97d0: 65 20 62 2d 74 72 65 65 20 6d 75 74 65 78 65 73 e b-tree mutexes
97e0: 20 61 72 65 20 6e 6f 74 20 74 61 6b 65 6e 0a 20 are not taken.
97f0: 20 2a 2a 20 68 65 72 65 2c 20 74 68 65 6e 20 61 ** here, then a
9800: 6e 6f 74 68 65 72 20 73 68 61 72 65 64 2d 63 61 nother shared-ca
9810: 63 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d che connection m
9820: 69 67 68 74 20 73 6e 65 61 6b 20 69 6e 20 62 65 ight sneak in be
9830: 74 77 65 65 6e 0a 20 20 2a 2a 20 74 68 65 20 64 tween. ** the d
9840: 61 74 61 62 61 73 65 20 72 6f 6c 6c 62 61 63 6b atabase rollback
9850: 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 73 65 and schema rese
9860: 74 2c 20 77 68 69 63 68 20 63 61 6e 20 63 61 75 t, which can cau
9870: 73 65 20 66 61 6c 73 65 0a 20 20 2a 2a 20 63 6f se false. ** co
9880: 72 72 75 70 74 69 6f 6e 20 72 65 70 6f 72 74 73 rruption reports
9890: 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 2e 20 in some cases.
98a0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 */. sqlite3Btr
98b0: 65 65 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a eeEnterAll(db);.
98c0: 20 20 73 63 68 65 6d 61 43 68 61 6e 67 65 20 3d schemaChange =
98d0: 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 (db->flags & SQ
98e0: 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 LITE_InternChang
98f0: 65 73 29 21 3d 30 20 26 26 20 64 62 2d 3e 69 6e es)!=0 && db->in
9900: 69 74 2e 62 75 73 79 3d 3d 30 3b 0a 0a 20 20 66 it.busy==0;.. f
9910: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 or(i=0; i<db->nD
9920: 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 42 74 72 b; i++){. Btr
9930: 65 65 20 2a 70 20 3d 20 64 62 2d 3e 61 44 62 5b ee *p = db->aDb[
9940: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 i].pBt;. if(
9950: 70 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 p ){. if( s
9960: 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54 qlite3BtreeIsInT
9970: 72 61 6e 73 28 70 29 20 29 7b 0a 20 20 20 20 20 rans(p) ){.
9980: 20 20 20 69 6e 54 72 61 6e 73 20 3d 20 31 3b 0a inTrans = 1;.
9990: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 }. sq
99a0: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 lite3BtreeRollba
99b0: 63 6b 28 70 2c 20 74 72 69 70 43 6f 64 65 2c 20 ck(p, tripCode,
99c0: 21 73 63 68 65 6d 61 43 68 61 6e 67 65 29 3b 0a !schemaChange);.
99d0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
99e0: 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 te3VtabRollback(
99f0: 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 6e db);. sqlite3En
9a00: 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b dBenignMalloc();
9a10: 0a 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 .. if( (db->fla
9a20: 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e gs&SQLITE_Intern
9a30: 43 68 61 6e 67 65 73 29 21 3d 30 20 26 26 20 64 Changes)!=0 && d
9a40: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 b->init.busy==0
9a50: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 ){. sqlite3Ex
9a60: 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 pirePreparedStat
9a70: 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 ements(db);.
9a80: 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c 53 sqlite3ResetAllS
9a90: 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69 chemasOfConnecti
9aa0: 6f 6e 28 64 62 29 3b 0a 20 20 7d 0a 20 20 73 71 on(db);. }. sq
9ab0: 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 lite3BtreeLeaveA
9ac0: 6c 6c 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 41 6e ll(db);.. /* An
9ad0: 79 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 y deferred const
9ae0: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 73 raint violations
9af0: 20 68 61 76 65 20 6e 6f 77 20 62 65 65 6e 20 72 have now been r
9b00: 65 73 6f 6c 76 65 64 2e 20 2a 2f 0a 20 20 64 62 esolved. */. db
9b10: 2d 3e 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 20 ->nDeferredCons
9b20: 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e 44 65 66 65 = 0;. db->nDefe
9b30: 72 72 65 64 49 6d 6d 43 6f 6e 73 20 3d 20 30 3b rredImmCons = 0;
9b40: 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 . db->flags &=
9b50: 7e 53 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 ~SQLITE_DeferFKs
9b60: 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 20 68 ;.. /* If one h
9b70: 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 75 72 as been configur
9b80: 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 72 ed, invoke the r
9b90: 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 6c ollback-hook cal
9ba0: 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 20 64 lback */. if( d
9bb0: 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c b->xRollbackCall
9bc0: 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 6e 73 back && (inTrans
9bd0: 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 6f 6d || !db->autoCom
9be0: 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 2d 3e mit) ){. db->
9bf0: 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 xRollbackCallbac
9c00: 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 k(db->pRollbackA
9c10: 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a rg);. }.}../*.*
9c20: 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 69 * Return a stati
9c30: 63 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e c string contain
9c40: 69 6e 67 20 74 68 65 20 6e 61 6d 65 20 63 6f 72 ing the name cor
9c50: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 responding to th
9c60: 65 20 65 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 e error code.**
9c70: 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 specified in the
9c80: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 argument..*/.#i
9c90: 66 20 28 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f (defined(SQLIT
9ca0: 45 5f 44 45 42 55 47 29 20 26 26 20 53 51 4c 49 E_DEBUG) && SQLI
9cb0: 54 45 5f 4f 53 5f 57 49 4e 29 20 7c 7c 20 64 65 TE_OS_WIN) || de
9cc0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53 fined(SQLITE_TES
9cd0: 54 29 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 T).const char *s
9ce0: 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 69 6e qlite3ErrName(in
9cf0: 74 20 72 63 29 7b 0a 20 20 63 6f 6e 73 74 20 63 t rc){. const c
9d00: 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 30 3b 0a har *zName = 0;.
9d10: 20 20 69 6e 74 20 69 2c 20 6f 72 69 67 52 63 20 int i, origRc
9d20: 3d 20 72 63 3b 0a 20 20 66 6f 72 28 69 3d 30 3b = rc;. for(i=0;
9d30: 20 69 3c 32 20 26 26 20 7a 4e 61 6d 65 3d 3d 30 i<2 && zName==0
9d40: 3b 20 69 2b 2b 2c 20 72 63 20 26 3d 20 30 78 66 ; i++, rc &= 0xf
9d50: 66 29 7b 0a 20 20 20 20 73 77 69 74 63 68 28 20 f){. switch(
9d60: 72 63 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 rc ){. case
9d70: 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 20 20 20 20 SQLITE_OK:
9d80: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
9d90: 65 20 3d 20 22 53 51 4c 49 54 45 5f 4f 4b 22 3b e = "SQLITE_OK";
9da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9db0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
9dc0: 65 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3a 20 e SQLITE_ERROR:
9dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
9de0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 45 52 52 me = "SQLITE_ERR
9df0: 4f 52 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 OR";
9e00: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
9e10: 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e se SQLITE_INTERN
9e20: 41 4c 3a 20 20 20 20 20 20 20 20 20 20 20 7a 4e AL: zN
9e30: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4e ame = "SQLITE_IN
9e40: 54 45 52 4e 41 4c 22 3b 20 20 20 20 20 20 20 20 TERNAL";
9e50: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
9e60: 61 73 65 20 53 51 4c 49 54 45 5f 50 45 52 4d 3a ase SQLITE_PERM:
9e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a z
9e80: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 50 Name = "SQLITE_P
9e90: 45 52 4d 22 3b 20 20 20 20 20 20 20 20 20 20 20 ERM";
9ea0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
9eb0: 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f 52 case SQLITE_ABOR
9ec0: 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 T:
9ed0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
9ee0: 41 42 4f 52 54 22 3b 20 20 20 20 20 20 20 20 20 ABORT";
9ef0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9f00: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 41 42 4f case SQLITE_ABO
9f10: 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 20 20 20 RT_ROLLBACK:
9f20: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9f30: 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 22 _ABORT_ROLLBACK"
9f40: 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 ; break;.
9f50: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 55 case SQLITE_BU
9f60: 53 59 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 SY:
9f70: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
9f80: 45 5f 42 55 53 59 22 3b 20 20 20 20 20 20 20 20 E_BUSY";
9f90: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
9fa0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 42 case SQLITE_B
9fb0: 55 53 59 5f 52 45 43 4f 56 45 52 59 3a 20 20 20 USY_RECOVERY:
9fc0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
9fd0: 54 45 5f 42 55 53 59 5f 52 45 43 4f 56 45 52 59 TE_BUSY_RECOVERY
9fe0: 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 "; break;.
9ff0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
a000: 42 55 53 59 5f 53 4e 41 50 53 48 4f 54 3a 20 20 BUSY_SNAPSHOT:
a010: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
a020: 49 54 45 5f 42 55 53 59 5f 53 4e 41 50 53 48 4f ITE_BUSY_SNAPSHO
a030: 54 22 3b 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 T"; break;.
a040: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a050: 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 20 20 20 _LOCKED:
a060: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
a070: 4c 49 54 45 5f 4c 4f 43 4b 45 44 22 3b 20 20 20 LITE_LOCKED";
a080: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
a090: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a0a0: 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 E_LOCKED_SHAREDC
a0b0: 41 43 48 45 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 ACHE: zName = "S
a0c0: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 QLITE_LOCKED_SHA
a0d0: 52 45 44 43 41 43 48 45 22 3b 62 72 65 61 6b 3b REDCACHE";break;
a0e0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a0f0: 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 20 TE_NOMEM:
a100: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
a110: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 22 3b 20 20 SQLITE_NOMEM";
a120: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
a130: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a140: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 ITE_READONLY:
a150: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
a160: 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 "SQLITE_READONLY
a170: 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 "; brea
a180: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a190: 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 52 45 LITE_READONLY_RE
a1a0: 43 4f 56 45 52 59 3a 20 20 7a 4e 61 6d 65 20 3d COVERY: zName =
a1b0: 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c "SQLITE_READONL
a1c0: 59 5f 52 45 43 4f 56 45 52 59 22 3b 20 62 72 65 Y_RECOVERY"; bre
a1d0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a1e0: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 QLITE_READONLY_C
a1f0: 41 4e 54 4c 4f 43 4b 3a 20 20 7a 4e 61 6d 65 20 ANTLOCK: zName
a200: 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e = "SQLITE_READON
a210: 4c 59 5f 43 41 4e 54 4c 4f 43 4b 22 3b 20 62 72 LY_CANTLOCK"; br
a220: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a230: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f SQLITE_READONLY_
a240: 52 4f 4c 4c 42 41 43 4b 3a 20 20 7a 4e 61 6d 65 ROLLBACK: zName
a250: 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 4f = "SQLITE_READO
a260: 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b 22 3b 20 62 NLY_ROLLBACK"; b
a270: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a280: 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
a290: 5f 44 42 4d 4f 56 45 44 3a 20 20 20 7a 4e 61 6d _DBMOVED: zNam
a2a0: 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 e = "SQLITE_READ
a2b0: 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 22 3b 20 20 ONLY_DBMOVED";
a2c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a2d0: 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 e SQLITE_INTERRU
a2e0: 50 54 3a 20 20 20 20 20 20 20 20 20 20 7a 4e 61 PT: zNa
a2f0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4e 54 me = "SQLITE_INT
a300: 45 52 52 55 50 54 22 3b 20 20 20 20 20 20 20 20 ERRUPT";
a310: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a320: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3a se SQLITE_IOERR:
a330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e zN
a340: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
a350: 45 52 52 22 3b 20 20 20 20 20 20 20 20 20 20 20 ERR";
a360: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
a370: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
a380: 5f 52 45 41 44 3a 20 20 20 20 20 20 20 20 20 7a _READ: z
a390: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
a3a0: 4f 45 52 52 5f 52 45 41 44 22 3b 20 20 20 20 20 OERR_READ";
a3b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
a3c0: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
a3d0: 52 5f 53 48 4f 52 54 5f 52 45 41 44 3a 20 20 20 R_SHORT_READ:
a3e0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
a3f0: 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 IOERR_SHORT_READ
a400: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 "; break;.
a410: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
a420: 52 52 5f 57 52 49 54 45 3a 20 20 20 20 20 20 20 RR_WRITE:
a430: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
a440: 5f 49 4f 45 52 52 5f 57 52 49 54 45 22 3b 20 20 _IOERR_WRITE";
a450: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
a460: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
a470: 45 52 52 5f 46 53 59 4e 43 3a 20 20 20 20 20 20 ERR_FSYNC:
a480: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
a490: 45 5f 49 4f 45 52 52 5f 46 53 59 4e 43 22 3b 20 E_IOERR_FSYNC";
a4a0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
a4b0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
a4c0: 4f 45 52 52 5f 44 49 52 5f 46 53 59 4e 43 3a 20 OERR_DIR_FSYNC:
a4d0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
a4e0: 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 46 53 59 TE_IOERR_DIR_FSY
a4f0: 4e 43 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 NC"; break;.
a500: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
a510: 49 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 3a 20 IOERR_TRUNCATE:
a520: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
a530: 49 54 45 5f 49 4f 45 52 52 5f 54 52 55 4e 43 41 ITE_IOERR_TRUNCA
a540: 54 45 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 TE"; break;.
a550: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a560: 5f 49 4f 45 52 52 5f 46 53 54 41 54 3a 20 20 20 _IOERR_FSTAT:
a570: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
a580: 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 LITE_IOERR_FSTAT
a590: 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a "; break;.
a5a0: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a5b0: 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3a 20 E_IOERR_UNLOCK:
a5c0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
a5d0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f QLITE_IOERR_UNLO
a5e0: 43 4b 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b CK"; break;
a5f0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a600: 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b 3a TE_IOERR_RDLOCK:
a610: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
a620: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c SQLITE_IOERR_RDL
a630: 4f 43 4b 22 3b 20 20 20 20 20 20 62 72 65 61 6b OCK"; break
a640: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a650: 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 ITE_IOERR_DELETE
a660: 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 : zName =
a670: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 "SQLITE_IOERR_DE
a680: 4c 45 54 45 22 3b 20 20 20 20 20 20 62 72 65 61 LETE"; brea
a690: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a6a0: 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d LITE_IOERR_NOMEM
a6b0: 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d : zName =
a6c0: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e "SQLITE_IOERR_N
a6d0: 4f 4d 45 4d 22 3b 20 20 20 20 20 20 20 62 72 65 OMEM"; bre
a6e0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a6f0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 45 QLITE_IOERR_ACCE
a700: 53 53 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 SS: zName
a710: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
a720: 41 43 43 45 53 53 22 3b 20 20 20 20 20 20 62 72 ACCESS"; br
a730: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a740: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 SQLITE_IOERR_CHE
a750: 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3a 0a CKRESERVEDLOCK:.
a760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a780: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
a790: 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 IOERR_CHECKRESER
a7a0: 56 45 44 4c 4f 43 4b 22 3b 20 62 72 65 61 6b 3b VEDLOCK"; break;
a7b0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a7c0: 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3a 20 20 TE_IOERR_LOCK:
a7d0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
a7e0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 SQLITE_IOERR_LOC
a7f0: 4b 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 6b K"; break
a800: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a810: 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 3a ITE_IOERR_CLOSE:
a820: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
a830: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c "SQLITE_IOERR_CL
a840: 4f 53 45 22 3b 20 20 20 20 20 20 20 62 72 65 61 OSE"; brea
a850: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a860: 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 43 LITE_IOERR_DIR_C
a870: 4c 4f 53 45 3a 20 20 20 20 7a 4e 61 6d 65 20 3d LOSE: zName =
a880: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 "SQLITE_IOERR_D
a890: 49 52 5f 43 4c 4f 53 45 22 3b 20 20 20 62 72 65 IR_CLOSE"; bre
a8a0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a8b0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4f QLITE_IOERR_SHMO
a8c0: 50 45 4e 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 PEN: zName
a8d0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
a8e0: 53 48 4d 4f 50 45 4e 22 3b 20 20 20 20 20 62 72 SHMOPEN"; br
a8f0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a900: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d SQLITE_IOERR_SHM
a910: 53 49 5a 45 3a 20 20 20 20 20 20 7a 4e 61 6d 65 SIZE: zName
a920: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
a930: 5f 53 48 4d 53 49 5a 45 22 3b 20 20 20 20 20 62 _SHMSIZE"; b
a940: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a950: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 SQLITE_IOERR_SH
a960: 4d 4c 4f 43 4b 3a 20 20 20 20 20 20 7a 4e 61 6d MLOCK: zNam
a970: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
a980: 52 5f 53 48 4d 4c 4f 43 4b 22 3b 20 20 20 20 20 R_SHMLOCK";
a990: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a9a0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 e SQLITE_IOERR_S
a9b0: 48 4d 4d 41 50 3a 20 20 20 20 20 20 20 7a 4e 61 HMMAP: zNa
a9c0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
a9d0: 52 52 5f 53 48 4d 4d 41 50 22 3b 20 20 20 20 20 RR_SHMMAP";
a9e0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a9f0: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
aa00: 53 45 45 4b 3a 20 20 20 20 20 20 20 20 20 7a 4e SEEK: zN
aa10: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
aa20: 45 52 52 5f 53 45 45 4b 22 3b 20 20 20 20 20 20 ERR_SEEK";
aa30: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
aa40: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
aa50: 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54 3a 20 7a _DELETE_NOENT: z
aa60: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
aa70: 4f 45 52 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e OERR_DELETE_NOEN
aa80: 54 22 3b 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 T";break;.
aa90: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
aaa0: 52 5f 4d 4d 41 50 3a 20 20 20 20 20 20 20 20 20 R_MMAP:
aab0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
aac0: 49 4f 45 52 52 5f 4d 4d 41 50 22 3b 20 20 20 20 IOERR_MMAP";
aad0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aae0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
aaf0: 52 52 5f 47 45 54 54 45 4d 50 50 41 54 48 3a 20 RR_GETTEMPPATH:
ab00: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
ab10: 5f 49 4f 45 52 52 5f 47 45 54 54 45 4d 50 50 41 _IOERR_GETTEMPPA
ab20: 54 48 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 TH"; break;.
ab30: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
ab40: 45 52 52 5f 43 4f 4e 56 50 41 54 48 3a 20 20 20 ERR_CONVPATH:
ab50: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
ab60: 45 5f 49 4f 45 52 52 5f 43 4f 4e 56 50 41 54 48 E_IOERR_CONVPATH
ab70: 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 "; break;.
ab80: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
ab90: 4f 52 52 55 50 54 3a 20 20 20 20 20 20 20 20 20 ORRUPT:
aba0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
abb0: 54 45 5f 43 4f 52 52 55 50 54 22 3b 20 20 20 20 TE_CORRUPT";
abc0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
abd0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
abe0: 43 4f 52 52 55 50 54 5f 56 54 41 42 3a 20 20 20 CORRUPT_VTAB:
abf0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
ac00: 49 54 45 5f 43 4f 52 52 55 50 54 5f 56 54 41 42 ITE_CORRUPT_VTAB
ac10: 22 3b 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 "; break;.
ac20: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
ac30: 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 20 20 20 20 _NOTFOUND:
ac40: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
ac50: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 22 3b 20 LITE_NOTFOUND";
ac60: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
ac70: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
ac80: 45 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 20 20 E_FULL:
ac90: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
aca0: 51 4c 49 54 45 5f 46 55 4c 4c 22 3b 20 20 20 20 QLITE_FULL";
acb0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
acc0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
acd0: 54 45 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 20 TE_CANTOPEN:
ace0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
acf0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 22 SQLITE_CANTOPEN"
ad00: 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b ; break
ad10: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
ad20: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 4e 4f 54 ITE_CANTOPEN_NOT
ad30: 45 4d 50 44 49 52 3a 20 7a 4e 61 6d 65 20 3d 20 EMPDIR: zName =
ad40: 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e "SQLITE_CANTOPEN
ad50: 5f 4e 4f 54 45 4d 50 44 49 52 22 3b 62 72 65 61 _NOTEMPDIR";brea
ad60: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
ad70: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 49 53 LITE_CANTOPEN_IS
ad80: 44 49 52 3a 20 20 20 20 20 7a 4e 61 6d 65 20 3d DIR: zName =
ad90: 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 "SQLITE_CANTOPE
ada0: 4e 5f 49 53 44 49 52 22 3b 20 20 20 20 62 72 65 N_ISDIR"; bre
adb0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
adc0: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 46 QLITE_CANTOPEN_F
add0: 55 4c 4c 50 41 54 48 3a 20 20 7a 4e 61 6d 65 20 ULLPATH: zName
ade0: 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 = "SQLITE_CANTOP
adf0: 45 4e 5f 46 55 4c 4c 50 41 54 48 22 3b 20 62 72 EN_FULLPATH"; br
ae00: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
ae10: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
ae20: 43 4f 4e 56 50 41 54 48 3a 20 20 7a 4e 61 6d 65 CONVPATH: zName
ae30: 20 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f = "SQLITE_CANTO
ae40: 50 45 4e 5f 43 4f 4e 56 50 41 54 48 22 3b 20 62 PEN_CONVPATH"; b
ae50: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
ae60: 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c SQLITE_PROTOCOL
ae70: 3a 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d : zNam
ae80: 65 20 3d 20 22 53 51 4c 49 54 45 5f 50 52 4f 54 e = "SQLITE_PROT
ae90: 4f 43 4f 4c 22 3b 20 20 20 20 20 20 20 20 20 20 OCOL";
aea0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
aeb0: 65 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 3a 20 e SQLITE_EMPTY:
aec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 zNa
aed0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 45 4d 50 me = "SQLITE_EMP
aee0: 54 59 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 TY";
aef0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
af00: 73 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 se SQLITE_SCHEMA
af10: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e : zN
af20: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 53 43 ame = "SQLITE_SC
af30: 48 45 4d 41 22 3b 20 20 20 20 20 20 20 20 20 20 HEMA";
af40: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
af50: 61 73 65 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 ase SQLITE_TOOBI
af60: 47 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a G: z
af70: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 54 Name = "SQLITE_T
af80: 4f 4f 42 49 47 22 3b 20 20 20 20 20 20 20 20 20 OOBIG";
af90: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
afa0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 case SQLITE_CONS
afb0: 54 52 41 49 4e 54 3a 20 20 20 20 20 20 20 20 20 TRAINT:
afc0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
afd0: 43 4f 4e 53 54 52 41 49 4e 54 22 3b 20 20 20 20 CONSTRAINT";
afe0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aff0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
b000: 53 54 52 41 49 4e 54 5f 55 4e 49 51 55 45 3a 20 STRAINT_UNIQUE:
b010: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b020: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 55 4e 49 51 _CONSTRAINT_UNIQ
b030: 55 45 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 UE"; break;.
b040: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
b050: 4e 53 54 52 41 49 4e 54 5f 54 52 49 47 47 45 52 NSTRAINT_TRIGGER
b060: 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 : zName = "SQLIT
b070: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 54 52 49 E_CONSTRAINT_TRI
b080: 47 47 45 52 22 3b 62 72 65 61 6b 3b 0a 20 20 20 GGER";break;.
b090: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
b0a0: 4f 4e 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 47 ONSTRAINT_FOREIG
b0b0: 4e 4b 45 59 3a 0a 20 20 20 20 20 20 20 20 20 20 NKEY:.
b0c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b0d0: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
b0e0: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
b0f0: 5f 46 4f 52 45 49 47 4e 4b 45 59 22 3b 20 20 20 _FOREIGNKEY";
b100: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b110: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
b120: 49 4e 54 5f 43 48 45 43 4b 3a 20 20 20 7a 4e 61 INT_CHECK: zNa
b130: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e me = "SQLITE_CON
b140: 53 54 52 41 49 4e 54 5f 43 48 45 43 4b 22 3b 20 STRAINT_CHECK";
b150: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
b160: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 se SQLITE_CONSTR
b170: 41 49 4e 54 5f 50 52 49 4d 41 52 59 4b 45 59 3a AINT_PRIMARYKEY:
b180: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
b190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b1a0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b1b0: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 50 52 49 4d _CONSTRAINT_PRIM
b1c0: 41 52 59 4b 45 59 22 3b 20 20 20 62 72 65 61 6b ARYKEY"; break
b1d0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b1e0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4e ITE_CONSTRAINT_N
b1f0: 4f 54 4e 55 4c 4c 3a 20 7a 4e 61 6d 65 20 3d 20 OTNULL: zName =
b200: 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 "SQLITE_CONSTRAI
b210: 4e 54 5f 4e 4f 54 4e 55 4c 4c 22 3b 62 72 65 61 NT_NOTNULL";brea
b220: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b230: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
b240: 43 4f 4d 4d 49 54 48 4f 4f 4b 3a 0a 20 20 20 20 COMMITHOOK:.
b250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b260: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
b270: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
b280: 54 52 41 49 4e 54 5f 43 4f 4d 4d 49 54 48 4f 4f TRAINT_COMMITHOO
b290: 4b 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 K"; break;.
b2a0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
b2b0: 4f 4e 53 54 52 41 49 4e 54 5f 56 54 41 42 3a 20 ONSTRAINT_VTAB:
b2c0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b2d0: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 56 54 TE_CONSTRAINT_VT
b2e0: 41 42 22 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 AB"; break;.
b2f0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b300: 43 4f 4e 53 54 52 41 49 4e 54 5f 46 55 4e 43 54 CONSTRAINT_FUNCT
b310: 49 4f 4e 3a 0a 20 20 20 20 20 20 20 20 20 20 20 ION:.
b320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b330: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b340: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
b350: 46 55 4e 43 54 49 4f 4e 22 3b 20 20 20 20 20 62 FUNCTION"; b
b360: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
b370: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
b380: 4e 54 5f 52 4f 57 49 44 3a 20 20 20 7a 4e 61 6d NT_ROWID: zNam
b390: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
b3a0: 54 52 41 49 4e 54 5f 52 4f 57 49 44 22 3b 20 20 TRAINT_ROWID";
b3b0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b3c0: 65 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 e SQLITE_MISMATC
b3d0: 48 3a 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 H: zNa
b3e0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 53 me = "SQLITE_MIS
b3f0: 4d 41 54 43 48 22 3b 20 20 20 20 20 20 20 20 20 MATCH";
b400: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
b410: 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 se SQLITE_MISUSE
b420: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e : zN
b430: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4d 49 ame = "SQLITE_MI
b440: 53 55 53 45 22 3b 20 20 20 20 20 20 20 20 20 20 SUSE";
b450: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
b460: 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 ase SQLITE_NOLFS
b470: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a : z
b480: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e Name = "SQLITE_N
b490: 4f 4c 46 53 22 3b 20 20 20 20 20 20 20 20 20 20 OLFS";
b4a0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
b4b0: 63 61 73 65 20 53 51 4c 49 54 45 5f 41 55 54 48 case SQLITE_AUTH
b4c0: 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 :
b4d0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b4e0: 41 55 54 48 22 3b 20 20 20 20 20 20 20 20 20 20 AUTH";
b4f0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
b500: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4f 52 case SQLITE_FOR
b510: 4d 41 54 3a 20 20 20 20 20 20 20 20 20 20 20 20 MAT:
b520: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b530: 5f 46 4f 52 4d 41 54 22 3b 20 20 20 20 20 20 20 _FORMAT";
b540: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b550: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 52 41 case SQLITE_RA
b560: 4e 47 45 3a 20 20 20 20 20 20 20 20 20 20 20 20 NGE:
b570: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b580: 45 5f 52 41 4e 47 45 22 3b 20 20 20 20 20 20 20 E_RANGE";
b590: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b5a0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
b5b0: 4f 54 41 44 42 3a 20 20 20 20 20 20 20 20 20 20 OTADB:
b5c0: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b5d0: 54 45 5f 4e 4f 54 41 44 42 22 3b 20 20 20 20 20 TE_NOTADB";
b5e0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b5f0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b600: 52 4f 57 3a 20 20 20 20 20 20 20 20 20 20 20 20 ROW:
b610: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b620: 49 54 45 5f 52 4f 57 22 3b 20 20 20 20 20 20 20 ITE_ROW";
b630: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
b640: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b650: 5f 4e 4f 54 49 43 45 3a 20 20 20 20 20 20 20 20 _NOTICE:
b660: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b670: 4c 49 54 45 5f 4e 4f 54 49 43 45 22 3b 20 20 20 LITE_NOTICE";
b680: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
b690: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b6a0: 45 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 E_NOTICE_RECOVER
b6b0: 5f 57 41 4c 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 _WAL: zName = "S
b6c0: 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 QLITE_NOTICE_REC
b6d0: 4f 56 45 52 5f 57 41 4c 22 3b 62 72 65 61 6b 3b OVER_WAL";break;
b6e0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b6f0: 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 TE_NOTICE_RECOVE
b700: 52 5f 52 4f 4c 4c 42 41 43 4b 3a 0a 20 20 20 20 R_ROLLBACK:.
b710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b720: 20 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d zNam
b730: 65 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 54 49 e = "SQLITE_NOTI
b740: 43 45 5f 52 45 43 4f 56 45 52 5f 52 4f 4c 4c 42 CE_RECOVER_ROLLB
b750: 41 43 4b 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 ACK"; break;.
b760: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 57 case SQLITE_W
b770: 41 52 4e 49 4e 47 3a 20 20 20 20 20 20 20 20 20 ARNING:
b780: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b790: 54 45 5f 57 41 52 4e 49 4e 47 22 3b 20 20 20 20 TE_WARNING";
b7a0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b7b0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b7c0: 57 41 52 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 WARNING_AUTOINDE
b7d0: 58 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c X: zName = "SQL
b7e0: 49 54 45 5f 57 41 52 4e 49 4e 47 5f 41 55 54 4f ITE_WARNING_AUTO
b7f0: 49 4e 44 45 58 22 3b 20 62 72 65 61 6b 3b 0a 20 INDEX"; break;.
b800: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b810: 5f 44 4f 4e 45 3a 20 20 20 20 20 20 20 20 20 20 _DONE:
b820: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b830: 4c 49 54 45 5f 44 4f 4e 45 22 3b 20 20 20 20 20 LITE_DONE";
b840: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
b850: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
b860: 7a 4e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 zName==0 ){.
b870: 73 74 61 74 69 63 20 63 68 61 72 20 7a 42 75 66 static char zBuf
b880: 5b 35 30 5d 3b 0a 20 20 20 20 73 71 6c 69 74 65 [50];. sqlite
b890: 33 5f 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 3_snprintf(sizeo
b8a0: 66 28 7a 42 75 66 29 2c 20 7a 42 75 66 2c 20 22 f(zBuf), zBuf, "
b8b0: 53 51 4c 49 54 45 5f 55 4e 4b 4e 4f 57 4e 28 25 SQLITE_UNKNOWN(%
b8c0: 64 29 22 2c 20 6f 72 69 67 52 63 29 3b 0a 20 20 d)", origRc);.
b8d0: 20 20 7a 4e 61 6d 65 20 3d 20 7a 42 75 66 3b 0a zName = zBuf;.
b8e0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 4e 61 }. return zNa
b8f0: 6d 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a me;.}.#endif../*
b900: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 .** Return a sta
b910: 74 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 tic string that
b920: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 describes the ki
b930: 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 nd of error spec
b940: 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 ified in the.**
b950: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e argument..*/.con
b960: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
b970: 45 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a ErrStr(int rc){.
b980: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 static const c
b990: 68 61 72 2a 20 63 6f 6e 73 74 20 61 4d 73 67 5b har* const aMsg[
b9a0: 5d 20 3d 20 7b 0a 20 20 20 20 2f 2a 20 53 51 4c ] = {. /* SQL
b9b0: 49 54 45 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 ITE_OK
b9c0: 2a 2f 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 */ "not an error
b9d0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
b9e0: 5f 45 52 52 4f 52 20 20 20 20 20 20 20 2a 2f 20 _ERROR */
b9f0: 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 "SQL logic error
ba00: 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 or missing data
ba10: 62 61 73 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 base",. /* SQ
ba20: 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c 20 20 20 LITE_INTERNAL
ba30: 20 2a 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 53 51 */ 0,. /* SQ
ba40: 4c 49 54 45 5f 50 45 52 4d 20 20 20 20 20 20 20 LITE_PERM
ba50: 20 2a 2f 20 22 61 63 63 65 73 73 20 70 65 72 6d */ "access perm
ba60: 69 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a ission denied",.
ba70: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 41 42 /* SQLITE_AB
ba80: 4f 52 54 20 20 20 20 20 20 20 2a 2f 20 22 63 61 ORT */ "ca
ba90: 6c 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 llback requested
baa0: 20 71 75 65 72 79 20 61 62 6f 72 74 22 2c 0a 20 query abort",.
bab0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 42 55 53 /* SQLITE_BUS
bac0: 59 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61 74 Y */ "dat
bad0: 61 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 abase is locked"
bae0: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
baf0: 4c 4f 43 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 LOCKED */ "
bb00: 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 database table i
bb10: 73 20 6c 6f 63 6b 65 64 22 2c 0a 20 20 20 20 2f s locked",. /
bb20: 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 * SQLITE_NOMEM
bb30: 20 20 20 20 20 2a 2f 20 22 6f 75 74 20 6f 66 20 */ "out of
bb40: 6d 65 6d 6f 72 79 22 2c 0a 20 20 20 20 2f 2a 20 memory",. /*
bb50: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 SQLITE_READONLY
bb60: 20 20 20 2a 2f 20 22 61 74 74 65 6d 70 74 20 74 */ "attempt t
bb70: 6f 20 77 72 69 74 65 20 61 20 72 65 61 64 6f 6e o write a readon
bb80: 6c 79 20 64 61 74 61 62 61 73 65 22 2c 0a 20 20 ly database",.
bb90: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 /* SQLITE_INTE
bba0: 52 52 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 RRUPT */ "inte
bbb0: 72 72 75 70 74 65 64 22 2c 0a 20 20 20 20 2f 2a rrupted",. /*
bbc0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 20 20 SQLITE_IOERR
bbd0: 20 20 20 20 2a 2f 20 22 64 69 73 6b 20 49 2f 4f */ "disk I/O
bbe0: 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 error",. /*
bbf0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 20 SQLITE_CORRUPT
bc00: 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 */ "database
bc10: 64 69 73 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 disk image is ma
bc20: 6c 66 6f 72 6d 65 64 22 2c 0a 20 20 20 20 2f 2a lformed",. /*
bc30: 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 SQLITE_NOTFOUND
bc40: 20 20 20 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 */ "unknown
bc50: 6f 70 65 72 61 74 69 6f 6e 22 2c 0a 20 20 20 20 operation",.
bc60: 2f 2a 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 20 /* SQLITE_FULL
bc70: 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 */ "databa
bc80: 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20 66 75 se or disk is fu
bc90: 6c 6c 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ll",. /* SQLI
bca0: 54 45 5f 43 41 4e 54 4f 50 45 4e 20 20 20 20 2a TE_CANTOPEN *
bcb0: 2f 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 / "unable to ope
bcc0: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 n database file"
bcd0: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
bce0: 50 52 4f 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 PROTOCOL */ "
bcf0: 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c locking protocol
bd00: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
bd10: 5f 45 4d 50 54 59 20 20 20 20 20 20 20 2a 2f 20 _EMPTY */
bd20: 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73 20 "table contains
bd30: 6e 6f 20 64 61 74 61 22 2c 0a 20 20 20 20 2f 2a no data",. /*
bd40: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 20 SQLITE_SCHEMA
bd50: 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 */ "database
bd60: 20 73 63 68 65 6d 61 20 68 61 73 20 63 68 61 6e schema has chan
bd70: 67 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ged",. /* SQL
bd80: 49 54 45 5f 54 4f 4f 42 49 47 20 20 20 20 20 20 ITE_TOOBIG
bd90: 2a 2f 20 22 73 74 72 69 6e 67 20 6f 72 20 62 6c */ "string or bl
bda0: 6f 62 20 74 6f 6f 20 62 69 67 22 2c 0a 20 20 20 ob too big",.
bdb0: 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 /* SQLITE_CONST
bdc0: 52 41 49 4e 54 20 20 2a 2f 20 22 63 6f 6e 73 74 RAINT */ "const
bdd0: 72 61 69 6e 74 20 66 61 69 6c 65 64 22 2c 0a 20 raint failed",.
bde0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 /* SQLITE_MIS
bdf0: 4d 41 54 43 48 20 20 20 20 2a 2f 20 22 64 61 74 MATCH */ "dat
be00: 61 74 79 70 65 20 6d 69 73 6d 61 74 63 68 22 2c atype mismatch",
be10: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4d . /* SQLITE_M
be20: 49 53 55 53 45 20 20 20 20 20 20 2a 2f 20 22 6c ISUSE */ "l
be30: 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20 63 ibrary routine c
be40: 61 6c 6c 65 64 20 6f 75 74 20 6f 66 20 73 65 71 alled out of seq
be50: 75 65 6e 63 65 22 2c 0a 20 20 20 20 2f 2a 20 53 uence",. /* S
be60: 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 20 20 20 20 QLITE_NOLFS
be70: 20 20 2a 2f 20 22 6c 61 72 67 65 20 66 69 6c 65 */ "large file
be80: 20 73 75 70 70 6f 72 74 20 69 73 20 64 69 73 61 support is disa
be90: 62 6c 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 bled",. /* SQ
bea0: 4c 49 54 45 5f 41 55 54 48 20 20 20 20 20 20 20 LITE_AUTH
beb0: 20 2a 2f 20 22 61 75 74 68 6f 72 69 7a 61 74 69 */ "authorizati
bec0: 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 20 20 20 on denied",.
bed0: 2f 2a 20 53 51 4c 49 54 45 5f 46 4f 52 4d 41 54 /* SQLITE_FORMAT
bee0: 20 20 20 20 20 20 2a 2f 20 22 61 75 78 69 6c 69 */ "auxili
bef0: 61 72 79 20 64 61 74 61 62 61 73 65 20 66 6f 72 ary database for
bf00: 6d 61 74 20 65 72 72 6f 72 22 2c 0a 20 20 20 20 mat error",.
bf10: 2f 2a 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 /* SQLITE_RANGE
bf20: 20 20 20 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f */ "bind o
bf30: 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f r column index o
bf40: 75 74 20 6f 66 20 72 61 6e 67 65 22 2c 0a 20 20 ut of range",.
bf50: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 41 /* SQLITE_NOTA
bf60: 44 42 20 20 20 20 20 20 2a 2f 20 22 66 69 6c 65 DB */ "file
bf70: 20 69 73 20 65 6e 63 72 79 70 74 65 64 20 6f 72 is encrypted or
bf80: 20 69 73 20 6e 6f 74 20 61 20 64 61 74 61 62 61 is not a databa
bf90: 73 65 22 2c 0a 20 20 7d 3b 0a 20 20 63 6f 6e 73 se",. };. cons
bfa0: 74 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 22 t char *zErr = "
bfb0: 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 0a unknown error";.
bfc0: 20 20 73 77 69 74 63 68 28 20 72 63 20 29 7b 0a switch( rc ){.
bfd0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
bfe0: 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a 20 ABORT_ROLLBACK:
bff0: 7b 0a 20 20 20 20 20 20 7a 45 72 72 20 3d 20 22 {. zErr = "
c000: 61 62 6f 72 74 20 64 75 65 20 74 6f 20 52 4f 4c abort due to ROL
c010: 4c 42 41 43 4b 22 3b 0a 20 20 20 20 20 20 62 72 LBACK";. br
c020: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 eak;. }. d
c030: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 efault: {.
c040: 72 63 20 26 3d 20 30 78 66 66 3b 0a 20 20 20 20 rc &= 0xff;.
c050: 20 20 69 66 28 20 41 4c 57 41 59 53 28 72 63 3e if( ALWAYS(rc>
c060: 3d 30 29 20 26 26 20 72 63 3c 41 72 72 61 79 53 =0) && rc<ArrayS
c070: 69 7a 65 28 61 4d 73 67 29 20 26 26 20 61 4d 73 ize(aMsg) && aMs
c080: 67 5b 72 63 5d 21 3d 30 20 29 7b 0a 20 20 20 20 g[rc]!=0 ){.
c090: 20 20 20 20 7a 45 72 72 20 3d 20 61 4d 73 67 5b zErr = aMsg[
c0a0: 72 63 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 rc];. }.
c0b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
c0c0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 45 72 }. return zEr
c0d0: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 r;.}../*.** This
c0e0: 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 routine impleme
c0f0: 6e 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 nts a busy callb
c100: 61 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 ack that sleeps
c110: 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 and tries.** aga
c120: 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f in until a timeo
c130: 75 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 ut value is reac
c140: 68 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 hed. The timeou
c150: 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e t value is.** an
c160: 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 integer number
c170: 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 of milliseconds
c180: 70 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 passed in as the
c190: 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 first.** argume
c1a0: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nt..*/.static in
c1b0: 74 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 t sqliteDefaultB
c1c0: 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f usyCallback(. vo
c1d0: 69 64 20 2a 70 74 72 2c 20 20 20 20 20 20 20 20 id *ptr,
c1e0: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
c1f0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f se connection */
c200: 0a 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 . int count
c210: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
c220: 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 mber of times ta
c230: 62 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 ble has been bus
c240: 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 y */.){.#if SQLI
c250: 54 45 5f 4f 53 5f 57 49 4e 20 7c 7c 20 48 41 56 TE_OS_WIN || HAV
c260: 45 5f 55 53 4c 45 45 50 0a 20 20 73 74 61 74 69 E_USLEEP. stati
c270: 63 20 63 6f 6e 73 74 20 75 38 20 64 65 6c 61 79 c const u8 delay
c280: 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 31 2c 20 s[] =. { 1,
c290: 32 2c 20 35 2c 20 31 30 2c 20 31 35 2c 20 32 30 2, 5, 10, 15, 20
c2a0: 2c 20 32 35 2c 20 32 35 2c 20 20 32 35 2c 20 20 , 25, 25, 25,
c2b0: 35 30 2c 20 20 35 30 2c 20 31 30 30 20 7d 3b 0a 50, 50, 100 };.
c2c0: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 static const u
c2d0: 38 20 74 6f 74 61 6c 73 5b 5d 20 3d 0a 20 20 20 8 totals[] =.
c2e0: 20 20 7b 20 30 2c 20 31 2c 20 33 2c 20 20 38 2c { 0, 1, 3, 8,
c2f0: 20 31 38 2c 20 33 33 2c 20 35 33 2c 20 37 38 2c 18, 33, 53, 78,
c300: 20 31 30 33 2c 20 31 32 38 2c 20 31 37 38 2c 20 103, 128, 178,
c310: 32 32 38 20 7d 3b 0a 23 20 64 65 66 69 6e 65 20 228 };.# define
c320: 4e 44 45 4c 41 59 20 41 72 72 61 79 53 69 7a 65 NDELAY ArraySize
c330: 28 64 65 6c 61 79 73 29 0a 20 20 73 71 6c 69 74 (delays). sqlit
c340: 65 33 20 2a 64 62 20 3d 20 28 73 71 6c 69 74 65 e3 *db = (sqlite
c350: 33 20 2a 29 70 74 72 3b 0a 20 20 69 6e 74 20 74 3 *)ptr;. int t
c360: 69 6d 65 6f 75 74 20 3d 20 64 62 2d 3e 62 75 73 imeout = db->bus
c370: 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 yTimeout;. int
c380: 64 65 6c 61 79 2c 20 70 72 69 6f 72 3b 0a 0a 20 delay, prior;..
c390: 20 61 73 73 65 72 74 28 20 63 6f 75 6e 74 3e 3d assert( count>=
c3a0: 30 20 29 3b 0a 20 20 69 66 28 20 63 6f 75 6e 74 0 );. if( count
c3b0: 20 3c 20 4e 44 45 4c 41 59 20 29 7b 0a 20 20 20 < NDELAY ){.
c3c0: 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b delay = delays[
c3d0: 63 6f 75 6e 74 5d 3b 0a 20 20 20 20 70 72 69 6f count];. prio
c3e0: 72 20 3d 20 74 6f 74 61 6c 73 5b 63 6f 75 6e 74 r = totals[count
c3f0: 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 ];. }else{.
c400: 64 65 6c 61 79 20 3d 20 64 65 6c 61 79 73 5b 4e delay = delays[N
c410: 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 20 20 70 72 DELAY-1];. pr
c420: 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 4e 44 45 ior = totals[NDE
c430: 4c 41 59 2d 31 5d 20 2b 20 64 65 6c 61 79 2a 28 LAY-1] + delay*(
c440: 63 6f 75 6e 74 2d 28 4e 44 45 4c 41 59 2d 31 29 count-(NDELAY-1)
c450: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 72 69 );. }. if( pri
c460: 6f 72 20 2b 20 64 65 6c 61 79 20 3e 20 74 69 6d or + delay > tim
c470: 65 6f 75 74 20 29 7b 0a 20 20 20 20 64 65 6c 61 eout ){. dela
c480: 79 20 3d 20 74 69 6d 65 6f 75 74 20 2d 20 70 72 y = timeout - pr
c490: 69 6f 72 3b 0a 20 20 20 20 69 66 28 20 64 65 6c ior;. if( del
c4a0: 61 79 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 30 ay<=0 ) return 0
c4b0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f ;. }. sqlite3O
c4c0: 73 53 6c 65 65 70 28 64 62 2d 3e 70 56 66 73 2c sSleep(db->pVfs,
c4d0: 20 64 65 6c 61 79 2a 31 30 30 30 29 3b 0a 20 20 delay*1000);.
c4e0: 72 65 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a return 1;.#else.
c4f0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
c500: 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a (sqlite3 *)ptr;.
c510: 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 int timeout =
c520: 28 28 73 71 6c 69 74 65 33 20 2a 29 70 74 72 29 ((sqlite3 *)ptr)
c530: 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20 ->busyTimeout;.
c540: 20 69 66 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 if( (count+1)*1
c550: 30 30 30 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 000 > timeout ){
c560: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
c570: 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c }. sqlite3OsSl
c580: 65 65 70 28 64 62 2d 3e 70 56 66 73 2c 20 31 30 eep(db->pVfs, 10
c590: 30 30 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 00000);. return
c5a0: 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 1;.#endif.}../*
c5b0: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 67 .** Invoke the g
c5c0: 69 76 65 6e 20 62 75 73 79 20 68 61 6e 64 6c 65 iven busy handle
c5d0: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f r..**.** This ro
c5e0: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 utine is called
c5f0: 77 68 65 6e 20 61 6e 20 6f 70 65 72 61 74 69 6f when an operatio
c600: 6e 20 66 61 69 6c 65 64 20 77 69 74 68 20 61 20 n failed with a
c610: 6c 6f 63 6b 2e 0a 2a 2a 20 49 66 20 74 68 69 73 lock..** If this
c620: 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73 routine returns
c630: 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c non-zero, the l
c640: 6f 63 6b 20 69 73 20 72 65 74 72 69 65 64 2e 20 ock is retried.
c650: 20 49 66 20 69 74 0a 2a 2a 20 72 65 74 75 72 6e If it.** return
c660: 73 20 30 2c 20 74 68 65 20 6f 70 65 72 61 74 69 s 0, the operati
c670: 6f 6e 20 61 62 6f 72 74 73 20 77 69 74 68 20 61 on aborts with a
c680: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 20 65 72 n SQLITE_BUSY er
c690: 72 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ror..*/.int sqli
c6a0: 74 65 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e te3InvokeBusyHan
c6b0: 64 6c 65 72 28 42 75 73 79 48 61 6e 64 6c 65 72 dler(BusyHandler
c6c0: 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a *p){. int rc;.
c6d0: 20 20 69 66 28 20 4e 45 56 45 52 28 70 3d 3d 30 if( NEVER(p==0
c6e0: 29 20 7c 7c 20 70 2d 3e 78 46 75 6e 63 3d 3d 30 ) || p->xFunc==0
c6f0: 20 7c 7c 20 70 2d 3e 6e 42 75 73 79 3c 30 20 29 || p->nBusy<0 )
c700: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 63 20 return 0;. rc
c710: 3d 20 70 2d 3e 78 46 75 6e 63 28 70 2d 3e 70 41 = p->xFunc(p->pA
c720: 72 67 2c 20 70 2d 3e 6e 42 75 73 79 29 3b 0a 20 rg, p->nBusy);.
c730: 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 if( rc==0 ){.
c740: 20 20 70 2d 3e 6e 42 75 73 79 20 3d 20 2d 31 3b p->nBusy = -1;
c750: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d . }else{. p-
c760: 3e 6e 42 75 73 79 2b 2b 3b 0a 20 20 7d 0a 20 20 >nBusy++;. }.
c770: 72 65 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f return rc; .}../
c780: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
c790: 65 20 73 65 74 73 20 74 68 65 20 62 75 73 79 20 e sets the busy
c7a0: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 callback for an
c7b0: 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 Sqlite database
c7c0: 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 to the.** given
c7d0: 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f callback functio
c7e0: 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e n with the given
c7f0: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e argument..*/.in
c800: 74 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 t sqlite3_busy_h
c810: 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 andler(. sqlite
c820: 33 20 2a 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 3 *db,. int (*x
c830: 42 75 73 79 29 28 76 6f 69 64 2a 2c 69 6e 74 29 Busy)(void*,int)
c840: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 ,. void *pArg.)
c850: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
c860: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
c870: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
c880: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
c890: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
c8a0: 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
c8b0: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
c8c0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
c8d0: 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 62 75 73 utex);. db->bus
c8e0: 79 48 61 6e 64 6c 65 72 2e 78 46 75 6e 63 20 3d yHandler.xFunc =
c8f0: 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 62 75 xBusy;. db->bu
c900: 73 79 48 61 6e 64 6c 65 72 2e 70 41 72 67 20 3d syHandler.pArg =
c910: 20 70 41 72 67 3b 0a 20 20 64 62 2d 3e 62 75 73 pArg;. db->bus
c920: 79 48 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d yHandler.nBusy =
c930: 20 30 3b 0a 20 20 64 62 2d 3e 62 75 73 79 54 69 0;. db->busyTi
c940: 6d 65 6f 75 74 20 3d 20 30 3b 0a 20 20 73 71 6c meout = 0;. sql
c950: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
c960: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
c970: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
c980: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
c990: 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 TE_OMIT_PROGRESS
c9a0: 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 _CALLBACK./*.**
c9b0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 This routine set
c9c0: 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 s the progress c
c9d0: 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 allback for an S
c9e0: 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 qlite database t
c9f0: 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 o the.** given c
ca00: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e allback function
ca10: 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 with the given
ca20: 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 argument. The pr
ca30: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 ogress callback
ca40: 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b will.** be invok
ca50: 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 ed every nOps op
ca60: 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 codes..*/.void s
ca70: 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f qlite3_progress_
ca80: 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 handler(. sqlit
ca90: 65 33 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e e3 *db, . int n
caa0: 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 Ops,. int (*xPr
cab0: 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 ogress)(void*),
cac0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b . void *pArg.){
cad0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
cae0: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
caf0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
cb00: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
cb10: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
cb20: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
cb30: 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d . return;. }
cb40: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
cb50: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
cb60: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
cb70: 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 20 20 64 62 nOps>0 ){. db
cb80: 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 78 50 ->xProgress = xP
cb90: 72 6f 67 72 65 73 73 3b 0a 20 20 20 20 64 62 2d rogress;. db-
cba0: 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 20 3d 20 >nProgressOps =
cbb0: 28 75 6e 73 69 67 6e 65 64 29 6e 4f 70 73 3b 0a (unsigned)nOps;.
cbc0: 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 db->pProgres
cbd0: 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d sArg = pArg;. }
cbe0: 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 else{. db->xP
cbf0: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 rogress = 0;.
cc00: 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 db->nProgressOp
cc10: 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 s = 0;. db->p
cc20: 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b ProgressArg = 0;
cc30: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
cc40: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
cc50: 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a utex);.}.#endif.
cc60: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
cc70: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 tine installs a
cc80: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e default busy han
cc90: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 dler that waits
cca0: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 for the.** speci
ccb0: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d fied number of m
ccc0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f illiseconds befo
ccd0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a re returning 0..
cce0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 */.int sqlite3_b
ccf0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 usy_timeout(sqli
cd00: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 te3 *db, int ms)
cd10: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
cd20: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
cd30: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
cd40: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
cd50: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
cd60: 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
cd70: 6e 64 69 66 0a 20 20 69 66 28 20 6d 73 3e 30 20 ndif. if( ms>0
cd80: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62 ){. sqlite3_b
cd90: 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 62 2c 20 usy_handler(db,
cda0: 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 73 sqliteDefaultBus
cdb0: 79 43 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 yCallback, (void
cdc0: 2a 29 64 62 29 3b 0a 20 20 20 20 64 62 2d 3e 62 *)db);. db->b
cdd0: 75 73 79 54 69 6d 65 6f 75 74 20 3d 20 6d 73 3b usyTimeout = ms;
cde0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 . }else{. sq
cdf0: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c lite3_busy_handl
ce00: 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 er(db, 0, 0);.
ce10: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
ce20: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 E_OK;.}../*.** C
ce30: 61 75 73 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 ause any pending
ce40: 20 6f 70 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 operation to st
ce50: 6f 70 20 61 74 20 69 74 73 20 65 61 72 6c 69 65 op at its earlie
ce60: 73 74 20 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a st opportunity..
ce70: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f */.void sqlite3_
ce80: 69 6e 74 65 72 72 75 70 74 28 73 71 6c 69 74 65 interrupt(sqlite
ce90: 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 3 *db){.#ifdef S
cea0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
ceb0: 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
cec0: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
ced0: 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 Ok(db) ){. (v
cee0: 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 oid)SQLITE_MISUS
cef0: 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 E_BKPT;. retu
cf00: 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 rn;. }.#endif.
cf10: 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 72 72 db->u1.isInterr
cf20: 75 70 74 65 64 20 3d 20 31 3b 0a 7d 0a 0a 0a 2f upted = 1;.}.../
cf30: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
cf40: 6f 6e 20 69 73 20 65 78 61 63 74 6c 79 20 74 68 on is exactly th
cf50: 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74 65 e same as sqlite
cf60: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 3_create_functio
cf70: 6e 28 29 2c 20 65 78 63 65 70 74 0a 2a 2a 20 74 n(), except.** t
cf80: 68 61 74 20 69 74 20 69 73 20 64 65 73 69 67 6e hat it is design
cf90: 65 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 ed to be called
cfa0: 62 79 20 69 6e 74 65 72 6e 61 6c 20 63 6f 64 65 by internal code
cfb0: 2e 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 . The difference
cfc0: 20 69 73 0a 2a 2a 20 74 68 61 74 20 69 66 20 61 is.** that if a
cfd0: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 73 20 malloc() fails
cfe0: 69 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 in sqlite3_creat
cff0: 65 5f 66 75 6e 63 74 69 6f 6e 28 29 2c 20 61 6e e_function(), an
d000: 20 65 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 69 error code.** i
d010: 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74 s returned and t
d020: 68 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 he mallocFailed
d030: 66 6c 61 67 20 63 6c 65 61 72 65 64 2e 20 0a 2a flag cleared. .*
d040: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 72 65 /.int sqlite3Cre
d050: 61 74 65 46 75 6e 63 28 0a 20 20 73 71 6c 69 74 ateFunc(. sqlit
d060: 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 e3 *db,. const
d070: 63 68 61 72 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e char *zFunctionN
d080: 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c ame,. int nArg,
d090: 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f . int enc,. vo
d0a0: 69 64 20 2a 70 55 73 65 72 44 61 74 61 2c 0a 20 id *pUserData,.
d0b0: 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 void (*xFunc)(s
d0c0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
d0d0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
d0e0: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
d0f0: 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 xStep)(sqlite3_c
d100: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
d110: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
d120: 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 void (*xFinal)(
d130: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
d140: 29 2c 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 ),. FuncDestruc
d150: 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 tor *pDestructor
d160: 0a 29 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 .){. FuncDef *p
d170: 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 0a 20 ;. int nName;.
d180: 20 69 6e 74 20 65 78 74 72 61 46 6c 61 67 73 3b int extraFlags;
d190: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
d1a0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 te3_mutex_held(d
d1b0: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 b->mutex) );. i
d1c0: 66 28 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 f( zFunctionName
d1d0: 3d 3d 30 20 7c 7c 0a 20 20 20 20 20 20 28 78 46 ==0 ||. (xF
d1e0: 75 6e 63 20 26 26 20 28 78 46 69 6e 61 6c 20 7c unc && (xFinal |
d1f0: 7c 20 78 53 74 65 70 29 29 20 7c 7c 20 0a 20 20 | xStep)) || .
d200: 20 20 20 20 28 21 78 46 75 6e 63 20 26 26 20 28 (!xFunc && (
d210: 78 46 69 6e 61 6c 20 26 26 20 21 78 53 74 65 70 xFinal && !xStep
d220: 29 29 20 7c 7c 0a 20 20 20 20 20 20 28 21 78 46 )) ||. (!xF
d230: 75 6e 63 20 26 26 20 28 21 78 46 69 6e 61 6c 20 unc && (!xFinal
d240: 26 26 20 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 && xStep)) ||.
d250: 20 20 20 20 28 6e 41 72 67 3c 2d 31 20 7c 7c 20 (nArg<-1 ||
d260: 6e 41 72 67 3e 53 51 4c 49 54 45 5f 4d 41 58 5f nArg>SQLITE_MAX_
d270: 46 55 4e 43 54 49 4f 4e 5f 41 52 47 29 20 7c 7c FUNCTION_ARG) ||
d280: 0a 20 20 20 20 20 20 28 32 35 35 3c 28 6e 4e 61 . (255<(nNa
d290: 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c me = sqlite3Strl
d2a0: 65 6e 33 30 28 20 7a 46 75 6e 63 74 69 6f 6e 4e en30( zFunctionN
d2b0: 61 6d 65 29 29 29 20 29 7b 0a 20 20 20 20 72 65 ame))) ){. re
d2c0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
d2d0: 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 SE_BKPT;. }..
d2e0: 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 46 assert( SQLITE_F
d2f0: 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 3d 3d 53 51 UNC_CONSTANT==SQ
d300: 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 LITE_DETERMINIST
d310: 49 43 20 29 3b 0a 20 20 65 78 74 72 61 46 6c 61 IC );. extraFla
d320: 67 73 20 3d 20 65 6e 63 20 26 20 20 53 51 4c 49 gs = enc & SQLI
d330: 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 43 TE_DETERMINISTIC
d340: 3b 0a 20 20 65 6e 63 20 26 3d 20 28 53 51 4c 49 ;. enc &= (SQLI
d350: 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 7c TE_FUNC_ENCMASK|
d360: 53 51 4c 49 54 45 5f 41 4e 59 29 3b 0a 20 20 0a SQLITE_ANY);. .
d370: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
d380: 4d 49 54 5f 55 54 46 31 36 0a 20 20 2f 2a 20 49 MIT_UTF16. /* I
d390: 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 f SQLITE_UTF16 i
d3a0: 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 74 s specified as t
d3b0: 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 he encoding type
d3c0: 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 , transform this
d3d0: 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 . ** to one of
d3e0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 6f SQLITE_UTF16LE o
d3f0: 72 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 r SQLITE_UTF16BE
d400: 20 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 using the. **
d410: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 SQLITE_UTF16NATI
d420: 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 VE macro. SQLITE
d430: 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75 73 _UTF16 is not us
d440: 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 ed internally..
d450: 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c 49 **. ** If SQLI
d460: 54 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69 66 TE_ANY is specif
d470: 69 65 64 2c 20 61 64 64 20 74 68 72 65 65 20 76 ied, add three v
d480: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 ersions of the f
d490: 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 unction. ** to
d4a0: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e 0a the hash table..
d4b0: 20 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d */. if( enc==
d4c0: 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a SQLITE_UTF16 ){.
d4d0: 20 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 enc = SQLITE
d4e0: 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 _UTF16NATIVE;.
d4f0: 7d 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d 53 }else if( enc==S
d500: 51 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20 20 QLITE_ANY ){.
d510: 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63 20 int rc;. rc
d520: 3d 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 = sqlite3CreateF
d530: 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f unc(db, zFunctio
d540: 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c nName, nArg, SQL
d550: 49 54 45 5f 55 54 46 38 7c 65 78 74 72 61 46 6c ITE_UTF8|extraFl
d560: 61 67 73 2c 0a 20 20 20 20 20 20 20 20 20 70 55 ags,. pU
d570: 73 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c 20 serData, xFunc,
d580: 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 70 xStep, xFinal, p
d590: 44 65 73 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 Destructor);.
d5a0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
d5b0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d OK ){. rc =
d5c0: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
d5d0: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e nc(db, zFunction
d5e0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
d5f0: 54 45 5f 55 54 46 31 36 4c 45 7c 65 78 74 72 61 TE_UTF16LE|extra
d600: 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 20 20 Flags,.
d610: 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 6e pUserData, xFun
d620: 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c c, xStep, xFinal
d630: 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b 0a , pDestructor);.
d640: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
d650: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
d660: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
d670: 20 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d 20 }. enc =
d680: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a SQLITE_UTF16BE;.
d690: 20 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 20 }.#else. enc
d6a0: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23 = SQLITE_UTF8;.#
d6b0: 65 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 68 endif. . /* Ch
d6c0: 65 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 69 eck if an existi
d6d0: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 62 ng function is b
d6e0: 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e 20 eing overridden
d6f0: 6f 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 73 or deleted. If s
d700: 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 72 o,. ** and ther
d710: 65 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 e are active VMs
d720: 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 51 , then return SQ
d730: 4c 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 20 LITE_BUSY. If a
d740: 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 function. ** is
d750: 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 being overridde
d760: 6e 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 68 n/deleted but th
d770: 65 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76 ere are no activ
d780: 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 65 e VMs, allow the
d790: 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 . ** operation
d7a0: 74 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 20 to continue but
d7b0: 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 70 invalidate all p
d7c0: 72 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 recompiled state
d7d0: 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 20 ments.. */. p
d7e0: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e = sqlite3FindFun
d7f0: 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 ction(db, zFunct
d800: 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 ionName, nName,
d810: 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 30 nArg, (u8)enc, 0
d820: 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 28 70 );. if( p && (p
d830: 2d 3e 66 75 6e 63 46 6c 61 67 73 20 26 20 53 51 ->funcFlags & SQ
d840: 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 LITE_FUNC_ENCMAS
d850: 4b 29 3d 3d 65 6e 63 20 26 26 20 70 2d 3e 6e 41 K)==enc && p->nA
d860: 72 67 3d 3d 6e 41 72 67 20 29 7b 0a 20 20 20 20 rg==nArg ){.
d870: 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 74 if( db->nVdbeAct
d880: 69 76 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ive ){. sql
d890: 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 ite3ErrorWithMsg
d8a0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 (db, SQLITE_BUSY
d8b0: 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 62 , . "unab
d8c0: 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 le to delete/mod
d8d0: 69 66 79 20 75 73 65 72 2d 66 75 6e 63 74 69 6f ify user-functio
d8e0: 6e 20 64 75 65 20 74 6f 20 61 63 74 69 76 65 20 n due to active
d8f0: 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 20 statements");.
d900: 20 20 20 20 61 73 73 65 72 74 28 20 21 64 62 2d assert( !db-
d910: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b >mallocFailed );
d920: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
d930: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d LITE_BUSY;. }
d940: 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 else{. sqli
d950: 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 te3ExpirePrepare
d960: 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b dStatements(db);
d970: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 20 . }. }.. p
d980: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e = sqlite3FindFun
d990: 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 ction(db, zFunct
d9a0: 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 ionName, nName,
d9b0: 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 31 nArg, (u8)enc, 1
d9c0: 29 3b 0a 20 20 61 73 73 65 72 74 28 70 20 7c 7c );. assert(p ||
d9d0: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
d9e0: 64 29 3b 0a 20 20 69 66 28 20 21 70 20 29 7b 0a d);. if( !p ){.
d9f0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
da00: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a 20 20 E_NOMEM;. }..
da10: 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 65 72 20 76 /* If an older v
da20: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 75 ersion of the fu
da30: 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 63 6f nction with a co
da40: 6e 66 69 67 75 72 65 64 20 64 65 73 74 72 75 63 nfigured destruc
da50: 74 6f 72 20 69 73 0a 20 20 2a 2a 20 62 65 69 6e tor is. ** bein
da60: 67 20 72 65 70 6c 61 63 65 64 20 69 6e 76 6f 6b g replaced invok
da70: 65 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72 e the destructor
da80: 20 66 75 6e 63 74 69 6f 6e 20 68 65 72 65 2e 20 function here.
da90: 2a 2f 0a 20 20 66 75 6e 63 74 69 6f 6e 44 65 73 */. functionDes
daa0: 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 0a 20 20 troy(db, p);..
dab0: 69 66 28 20 70 44 65 73 74 72 75 63 74 6f 72 20 if( pDestructor
dac0: 29 7b 0a 20 20 20 20 70 44 65 73 74 72 75 63 74 ){. pDestruct
dad0: 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 7d 0a or->nRef++;. }.
dae0: 20 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f 72 p->pDestructor
daf0: 20 3d 20 70 44 65 73 74 72 75 63 74 6f 72 3b 0a = pDestructor;.
db00: 20 20 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 3d p->funcFlags =
db10: 20 28 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 26 (p->funcFlags &
db20: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 SQLITE_FUNC_ENC
db30: 4d 41 53 4b 29 20 7c 20 65 78 74 72 61 46 6c 61 MASK) | extraFla
db40: 67 73 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 gs;. testcase(
db50: 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 26 20 53 p->funcFlags & S
db60: 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 QLITE_DETERMINIS
db70: 54 49 43 20 29 3b 0a 20 20 70 2d 3e 78 46 75 6e TIC );. p->xFun
db80: 63 20 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d 3e c = xFunc;. p->
db90: 78 53 74 65 70 20 3d 20 78 53 74 65 70 3b 0a 20 xStep = xStep;.
dba0: 20 70 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 p->xFinalize =
dbb0: 78 46 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55 73 xFinal;. p->pUs
dbc0: 65 72 44 61 74 61 20 3d 20 70 55 73 65 72 44 61 erData = pUserDa
dbd0: 74 61 3b 0a 20 20 70 2d 3e 6e 41 72 67 20 3d 20 ta;. p->nArg =
dbe0: 28 75 31 36 29 6e 41 72 67 3b 0a 20 20 72 65 74 (u16)nArg;. ret
dbf0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
dc00: 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 6e ../*.** Create n
dc10: 65 77 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e ew user function
dc20: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
dc30: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 3_create_functio
dc40: 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 n(. sqlite3 *db
dc50: 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ,. const char *
dc60: 7a 46 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 41 72 zFunc,. int nAr
dc70: 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 g,. int enc,.
dc80: 76 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 void *p,. void
dc90: 28 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 (*xFunc)(sqlite3
dca0: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
dcb0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c lite3_value **),
dcc0: 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 . void (*xStep)
dcd0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
dce0: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
dcf0: 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 lue **),. void
dd00: 28 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 (*xFinal)(sqlite
dd10: 33 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 3_context*).){.
dd20: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f return sqlite3_
dd30: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f create_function_
dd40: 76 32 28 64 62 2c 20 7a 46 75 6e 63 2c 20 6e 41 v2(db, zFunc, nA
dd50: 72 67 2c 20 65 6e 63 2c 20 70 2c 20 78 46 75 6e rg, enc, p, xFun
dd60: 63 2c 20 78 53 74 65 70 2c 0a 20 20 20 20 20 20 c, xStep,.
dd70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dd80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 78 46 xF
dd90: 69 6e 61 6c 2c 20 30 29 3b 0a 7d 0a 0a 69 6e 74 inal, 0);.}..int
dda0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
ddb0: 66 75 6e 63 74 69 6f 6e 5f 76 32 28 0a 20 20 73 function_v2(. s
ddc0: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f qlite3 *db,. co
ddd0: 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 2c nst char *zFunc,
dde0: 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 . int nArg,. i
ddf0: 6e 74 20 65 6e 63 2c 0a 20 20 76 6f 69 64 20 2a nt enc,. void *
de00: 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e p,. void (*xFun
de10: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 c)(sqlite3_conte
de20: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
de30: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 value **),. voi
de40: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
de50: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
de60: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
de70: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e ),. void (*xFin
de80: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 al)(sqlite3_cont
de90: 65 78 74 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a ext*),. void (*
dea0: 78 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a xDestroy)(void *
deb0: 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ).){. int rc =
dec0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
ded0: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a FuncDestructor *
dee0: 70 41 72 67 20 3d 20 30 3b 0a 0a 23 69 66 64 65 pArg = 0;..#ifde
def0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
df00: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
df10: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
df20: 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
df30: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
df40: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a ISUSE_BKPT;. }.
df50: 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 #endif. sqlite3
df60: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
df70: 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 78 >mutex);. if( x
df80: 44 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 70 Destroy ){. p
df90: 41 72 67 20 3d 20 28 46 75 6e 63 44 65 73 74 72 Arg = (FuncDestr
dfa0: 75 63 74 6f 72 20 2a 29 73 71 6c 69 74 65 33 44 uctor *)sqlite3D
dfb0: 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 bMallocZero(db,
dfc0: 73 69 7a 65 6f 66 28 46 75 6e 63 44 65 73 74 72 sizeof(FuncDestr
dfd0: 75 63 74 6f 72 29 29 3b 0a 20 20 20 20 69 66 28 uctor));. if(
dfe0: 20 21 70 41 72 67 20 29 7b 0a 20 20 20 20 20 20 !pArg ){.
dff0: 78 44 65 73 74 72 6f 79 28 70 29 3b 0a 20 20 20 xDestroy(p);.
e000: 20 20 20 67 6f 74 6f 20 6f 75 74 3b 0a 20 20 20 goto out;.
e010: 20 7d 0a 20 20 20 20 70 41 72 67 2d 3e 78 44 65 }. pArg->xDe
e020: 73 74 72 6f 79 20 3d 20 78 44 65 73 74 72 6f 79 stroy = xDestroy
e030: 3b 0a 20 20 20 20 70 41 72 67 2d 3e 70 55 73 65 ;. pArg->pUse
e040: 72 44 61 74 61 20 3d 20 70 3b 0a 20 20 7d 0a 20 rData = p;. }.
e050: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 rc = sqlite3Cre
e060: 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e ateFunc(db, zFun
e070: 63 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c c, nArg, enc, p,
e080: 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 xFunc, xStep, x
e090: 46 69 6e 61 6c 2c 20 70 41 72 67 29 3b 0a 20 20 Final, pArg);.
e0a0: 69 66 28 20 70 41 72 67 20 26 26 20 70 41 72 67 if( pArg && pArg
e0b0: 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 ->nRef==0 ){.
e0c0: 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
e0d0: 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 78 44 ITE_OK );. xD
e0e0: 65 73 74 72 6f 79 28 70 29 3b 0a 20 20 20 20 73 estroy(p);. s
e0f0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
e100: 20 70 41 72 67 29 3b 0a 20 20 7d 0a 0a 20 6f 75 pArg);. }.. ou
e110: 74 3a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 t:. rc = sqlite
e120: 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3ApiExit(db, rc)
e130: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
e140: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
e150: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b x);. return rc;
e160: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
e170: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e TE_OMIT_UTF16.in
e180: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
e190: 5f 66 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 _function16(. s
e1a0: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f qlite3 *db,. co
e1b0: 6e 73 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 nst void *zFunct
e1c0: 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e ionName,. int n
e1d0: 41 72 67 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 Arg,. int eText
e1e0: 52 65 70 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a Rep,. void *p,.
e1f0: 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 void (*xFunc)(
e200: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
e210: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
e220: 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a ue**),. void (*
e230: 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 xStep)(sqlite3_c
e240: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
e250: 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 te3_value**),.
e260: 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 void (*xFinal)(s
e270: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 qlite3_context*)
e280: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 .){. int rc;.
e290: 63 68 61 72 20 2a 7a 46 75 6e 63 38 3b 0a 0a 23 char *zFunc8;..#
e2a0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
e2b0: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
e2c0: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
e2d0: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c 7c tyCheckOk(db) ||
e2e0: 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 3d 3d zFunctionName==
e2f0: 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 0 ) return SQLIT
e300: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
e310: 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
e320: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
e330: 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 mutex);. assert
e340: 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
e350: 6c 65 64 20 29 3b 0a 20 20 7a 46 75 6e 63 38 20 led );. zFunc8
e360: 3d 20 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f = sqlite3Utf16to
e370: 38 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 8(db, zFunctionN
e380: 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f ame, -1, SQLITE_
e390: 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 20 20 UTF16NATIVE);.
e3a0: 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 rc = sqlite3Crea
e3b0: 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 teFunc(db, zFunc
e3c0: 38 2c 20 6e 41 72 67 2c 20 65 54 65 78 74 52 65 8, nArg, eTextRe
e3d0: 70 2c 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 p, p, xFunc, xSt
e3e0: 65 70 2c 20 78 46 69 6e 61 6c 2c 30 29 3b 0a 20 ep, xFinal,0);.
e3f0: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
e400: 62 2c 20 7a 46 75 6e 63 38 29 3b 0a 20 20 72 63 b, zFunc8);. rc
e410: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 = sqlite3ApiExi
e420: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c t(db, rc);. sql
e430: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
e440: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
e450: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 eturn rc;.}.#end
e460: 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6c 61 if.../*.** Decla
e470: 72 65 20 74 68 61 74 20 61 20 66 75 6e 63 74 69 re that a functi
e480: 6f 6e 20 68 61 73 20 62 65 65 6e 20 6f 76 65 72 on has been over
e490: 6c 6f 61 64 65 64 20 62 79 20 61 20 76 69 72 74 loaded by a virt
e4a0: 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a ual table..**.**
e4b0: 20 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e If the function
e4c0: 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 20 already exists
e4d0: 61 73 20 61 20 72 65 67 75 6c 61 72 20 67 6c 6f as a regular glo
e4e0: 62 61 6c 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 bal function, th
e4f0: 65 6e 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 en.** this routi
e500: 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 20 ne is a no-op.
e510: 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 If the function
e520: 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 does not exist,
e530: 74 68 65 6e 20 63 72 65 61 74 65 0a 2a 2a 20 61 then create.** a
e540: 20 6e 65 77 20 6f 6e 65 20 74 68 61 74 20 61 6c new one that al
e550: 77 61 79 73 20 74 68 72 6f 77 73 20 61 20 72 75 ways throws a ru
e560: 6e 2d 74 69 6d 65 20 65 72 72 6f 72 2e 20 20 0a n-time error. .
e570: 2a 2a 0a 2a 2a 20 57 68 65 6e 20 76 69 72 74 75 **.** When virtu
e580: 61 6c 20 74 61 62 6c 65 73 20 69 6e 74 65 6e 64 al tables intend
e590: 20 74 6f 20 70 72 6f 76 69 64 65 20 61 6e 20 6f to provide an o
e5a0: 76 65 72 6c 6f 61 64 65 64 20 66 75 6e 63 74 69 verloaded functi
e5b0: 6f 6e 2c 20 74 68 65 79 0a 2a 2a 20 73 68 6f 75 on, they.** shou
e5c0: 6c 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 ld call this rou
e5d0: 74 69 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 tine to make sur
e5e0: 65 20 74 68 65 20 67 6c 6f 62 61 6c 20 66 75 6e e the global fun
e5f0: 63 74 69 6f 6e 20 65 78 69 73 74 73 2e 0a 2a 2a ction exists..**
e600: 20 41 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 A global functi
e610: 6f 6e 20 6d 75 73 74 20 65 78 69 73 74 20 69 6e on must exist in
e620: 20 6f 72 64 65 72 20 66 6f 72 20 6e 61 6d 65 20 order for name
e630: 72 65 73 6f 6c 75 74 69 6f 6e 20 74 6f 20 77 6f resolution to wo
e640: 72 6b 0a 2a 2a 20 70 72 6f 70 65 72 6c 79 2e 0a rk.** properly..
e650: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f */.int sqlite3_o
e660: 76 65 72 6c 6f 61 64 5f 66 75 6e 63 74 69 6f 6e verload_function
e670: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
e680: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
e690: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Name,. int nArg
e6a0: 0a 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 20 .){. int nName
e6b0: 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
e6c0: 30 28 7a 4e 61 6d 65 29 3b 0a 20 20 69 6e 74 20 0(zName);. int
e6d0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
e6e0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
e6f0: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
e700: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
e710: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
e720: 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 7c 7c 20 6e || zName==0 || n
e730: 41 72 67 3c 2d 32 20 29 7b 0a 20 20 20 20 72 65 Arg<-2 ){. re
e740: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
e750: 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e SE_BKPT;. }.#en
e760: 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
e770: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
e780: 74 65 78 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 tex);. if( sqli
e790: 74 65 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 te3FindFunction(
e7a0: 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 db, zName, nName
e7b0: 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 , nArg, SQLITE_U
e7c0: 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 TF8, 0)==0 ){.
e7d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 rc = sqlite3Cr
e7e0: 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 4e 61 eateFunc(db, zNa
e7f0: 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 me, nArg, SQLITE
e800: 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 20 20 _UTF8,.
e810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e820: 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 76 61 0, sqlite3Inva
e830: 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 2c 20 lidFunction, 0,
e840: 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 63 20 0, 0);. }. rc
e850: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
e860: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
e870: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
e880: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
e890: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e turn rc;.}..#ifn
e8a0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
e8b0: 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 69 TRACE./*.** Regi
e8c0: 73 74 65 72 20 61 20 74 72 61 63 65 20 66 75 6e ster a trace fun
e8d0: 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 ction. The pArg
e8e0: 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f from the previo
e8f0: 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 usly registered
e900: 74 72 61 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 trace.** is retu
e910: 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 rned. .**.** A
e920: 4e 55 4c 4c 20 74 72 61 63 65 20 66 75 6e 63 74 NULL trace funct
e930: 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e ion means that n
e940: 6f 20 74 72 61 63 69 6e 67 20 69 73 20 65 78 65 o tracing is exe
e950: 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 cutes. A non-NU
e960: 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 69 73 20 61 LL.** trace is a
e970: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 pointer to a fu
e980: 6e 63 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 nction that is i
e990: 6e 76 6f 6b 65 64 20 61 74 20 74 68 65 20 73 74 nvoked at the st
e9a0: 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 53 art of each.** S
e9b0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f QL statement..*/
e9c0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 .void *sqlite3_t
e9d0: 72 61 63 65 28 73 71 6c 69 74 65 33 20 2a 64 62 race(sqlite3 *db
e9e0: 2c 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 29 , void (*xTrace)
e9f0: 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 (void*,const cha
ea00: 72 2a 29 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 r*), void *pArg)
ea10: 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a {. void *pOld;.
ea20: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
ea30: 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
ea40: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
ea50: 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
ea60: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c ){. (void)SQL
ea70: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
ea80: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
ea90: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 }.#endif. sqli
eaa0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
eab0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f db->mutex);. pO
eac0: 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 63 65 41 ld = db->pTraceA
ead0: 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 61 63 65 rg;. db->xTrace
eae0: 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 64 62 2d = xTrace;. db-
eaf0: 3e 70 54 72 61 63 65 41 72 67 20 3d 20 70 41 72 >pTraceArg = pAr
eb00: 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 g;. sqlite3_mut
eb10: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
eb20: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f ex);. return pO
eb30: 6c 64 3b 0a 7d 0a 2f 2a 0a 2a 2a 20 52 65 67 69 ld;.}./*.** Regi
eb40: 73 74 65 72 20 61 20 70 72 6f 66 69 6c 65 20 66 ster a profile f
eb50: 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 70 41 unction. The pA
eb60: 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 rg from the prev
eb70: 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 iously registere
eb80: 64 20 0a 2a 2a 20 70 72 6f 66 69 6c 65 20 66 75 d .** profile fu
eb90: 6e 63 74 69 6f 6e 20 69 73 20 72 65 74 75 72 6e nction is return
eba0: 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 ed. .**.** A NU
ebb0: 4c 4c 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 LL profile funct
ebc0: 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 6e ion means that n
ebd0: 6f 20 70 72 6f 66 69 6c 69 6e 67 20 69 73 20 65 o profiling is e
ebe0: 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f 6e 2d xecutes. A non-
ebf0: 4e 55 4c 4c 0a 2a 2a 20 70 72 6f 66 69 6c 65 20 NULL.** profile
ec00: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
ec10: 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 a function that
ec20: 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 is invoked at th
ec30: 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 0a e conclusion of.
ec40: 2a 2a 20 65 61 63 68 20 53 51 4c 20 73 74 61 74 ** each SQL stat
ec50: 65 6d 65 6e 74 20 74 68 61 74 20 69 73 20 72 75 ement that is ru
ec60: 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 n..*/.void *sqli
ec70: 74 65 33 5f 70 72 6f 66 69 6c 65 28 0a 20 20 73 te3_profile(. s
ec80: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 76 6f qlite3 *db,. vo
ec90: 69 64 20 28 2a 78 50 72 6f 66 69 6c 65 29 28 76 id (*xProfile)(v
eca0: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
ecb0: 2c 73 71 6c 69 74 65 5f 75 69 6e 74 36 34 29 2c ,sqlite_uint64),
ecc0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b . void *pArg.){
ecd0: 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a 0a . void *pOld;..
ece0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
ecf0: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
ed00: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
ed10: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
ed20: 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
ed30: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
ed40: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
ed50: 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 }.#endif. sqlit
ed60: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
ed70: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c b->mutex);. pOl
ed80: 64 20 3d 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 d = db->pProfile
ed90: 41 72 67 3b 0a 20 20 64 62 2d 3e 78 50 72 6f 66 Arg;. db->xProf
eda0: 69 6c 65 20 3d 20 78 50 72 6f 66 69 6c 65 3b 0a ile = xProfile;.
edb0: 20 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 db->pProfileAr
edc0: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
edd0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
ede0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
edf0: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 6e turn pOld;.}.#en
ee00: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
ee10: 49 54 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 0a IT_TRACE */../*.
ee20: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 66 75 ** Register a fu
ee30: 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 nction to be inv
ee40: 6f 6b 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e oked when a tran
ee50: 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 2e saction commits.
ee60: 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 76 6f 6b .** If the invok
ee70: 65 64 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ed function retu
ee80: 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 rns non-zero, th
ee90: 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 en the commit be
eea0: 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 comes a.** rollb
eeb0: 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 ack..*/.void *sq
eec0: 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f lite3_commit_hoo
eed0: 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 k(. sqlite3 *db
eee0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
eef0: 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f * Attach the hoo
ef00: 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 k to this databa
ef10: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 se */. int (*xC
ef20: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c allback)(void*),
ef30: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f /* Function to
ef40: 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 invoke on each
ef50: 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 commit */. void
ef60: 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
ef70: 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e /* Argumen
ef80: 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f t to the functio
ef90: 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a n */.){. void *
efa0: 70 4f 6c 64 3b 0a 0a 23 69 66 64 65 66 20 53 51 pOld;..#ifdef SQ
efb0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
efc0: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
efd0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
efe0: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f k(db) ){. (vo
eff0: 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 id)SQLITE_MISUSE
f000: 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 _BKPT;. retur
f010: 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a n 0;. }.#endif.
f020: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
f030: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
f040: 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 ;. pOld = db->p
f050: 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d CommitArg;. db-
f060: 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b >xCommitCallback
f070: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 = xCallback;.
f080: 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d db->pCommitArg =
f090: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
f0a0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
f0b0: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
f0c0: 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n pOld;.}../*.**
f0d0: 20 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c Register a call
f0e0: 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b back to be invok
f0f0: 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 72 ed each time a r
f100: 6f 77 20 69 73 20 75 70 64 61 74 65 64 2c 0a 2a ow is updated,.*
f110: 2a 20 69 6e 73 65 72 74 65 64 20 6f 72 20 64 65 * inserted or de
f120: 6c 65 74 65 64 20 75 73 69 6e 67 20 74 68 69 73 leted using this
f130: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
f140: 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 tion..*/.void *s
f150: 71 6c 69 74 65 33 5f 75 70 64 61 74 65 5f 68 6f qlite3_update_ho
f160: 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ok(. sqlite3 *d
f170: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
f180: 2f 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f /* Attach the ho
f190: 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 ok to this datab
f1a0: 61 73 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a ase */. void (*
f1b0: 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a xCallback)(void*
f1c0: 2c 69 6e 74 2c 63 68 61 72 20 63 6f 6e 73 74 20 ,int,char const
f1d0: 2a 2c 63 68 61 72 20 63 6f 6e 73 74 20 2a 2c 73 *,char const *,s
f1e0: 71 6c 69 74 65 5f 69 6e 74 36 34 29 2c 0a 20 20 qlite_int64),.
f1f0: 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 void *pArg
f200: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
f210: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e ument to the fun
f220: 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f ction */.){. vo
f230: 69 64 20 2a 70 52 65 74 3b 0a 0a 23 69 66 64 65 id *pRet;..#ifde
f240: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
f250: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
f260: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
f270: 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
f280: 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 (void)SQLITE_MI
f290: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 SUSE_BKPT;. r
f2a0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e eturn 0;. }.#en
f2b0: 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
f2c0: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
f2d0: 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 64 tex);. pRet = d
f2e0: 62 2d 3e 70 55 70 64 61 74 65 41 72 67 3b 0a 20 b->pUpdateArg;.
f2f0: 20 64 62 2d 3e 78 55 70 64 61 74 65 43 61 6c 6c db->xUpdateCall
f300: 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b back = xCallback
f310: 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 74 65 41 ;. db->pUpdateA
f320: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
f330: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
f340: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
f350: 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f eturn pRet;.}../
f360: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
f370: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 callback to be i
f380: 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 nvoked each time
f390: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
f3a0: 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b s rolled.** back
f3b0: 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 by this databas
f3c0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f e connection..*/
f3d0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 72 .void *sqlite3_r
f3e0: 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20 ollback_hook(.
f3f0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
f400: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 74 /* Att
f410: 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 ach the hook to
f420: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f this database */
f430: 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 6c 6c 62 . void (*xCallb
f440: 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 2f 2a 20 ack)(void*), /*
f450: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f Callback functio
f460: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 n */. void *pAr
f470: 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g
f480: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
f490: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a the function */.
f4a0: 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 3b ){. void *pRet;
f4b0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
f4c0: 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
f4d0: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
f4e0: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
f4f0: 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
f500: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
f510: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a ;. return 0;.
f520: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c }.#endif. sql
f530: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
f540: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 (db->mutex);. p
f550: 52 65 74 20 3d 20 64 62 2d 3e 70 52 6f 6c 6c 62 Ret = db->pRollb
f560: 61 63 6b 41 72 67 3b 0a 20 20 64 62 2d 3e 78 52 ackArg;. db->xR
f570: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 ollbackCallback
f580: 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 = xCallback;. d
f590: 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 20 b->pRollbackArg
f5a0: 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 = pArg;. sqlite
f5b0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
f5c0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
f5d0: 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 23 69 66 6e rn pRet;.}..#ifn
f5e0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
f5f0: 57 41 4c 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 71 WAL./*.** The sq
f600: 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 lite3_wal_hook()
f610: 20 63 61 6c 6c 62 61 63 6b 20 72 65 67 69 73 74 callback regist
f620: 65 72 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f ered by sqlite3_
f630: 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 wal_autocheckpoi
f640: 6e 74 28 29 2e 0a 2a 2a 20 49 6e 76 6f 6b 65 20 nt()..** Invoke
f650: 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 sqlite3_wal_chec
f660: 6b 70 6f 69 6e 74 20 69 66 20 74 68 65 20 6e 75 kpoint if the nu
f670: 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 69 mber of frames i
f680: 6e 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 0a 2a n the log file.*
f690: 2a 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 * is greater tha
f6a0: 6e 20 73 71 6c 69 74 65 33 2e 70 57 61 6c 41 72 n sqlite3.pWalAr
f6b0: 67 20 63 61 73 74 20 74 6f 20 61 6e 20 69 6e 74 g cast to an int
f6c0: 65 67 65 72 20 28 74 68 65 20 76 61 6c 75 65 20 eger (the value
f6d0: 63 6f 6e 66 69 67 75 72 65 64 20 62 79 0a 2a 2a configured by.**
f6e0: 20 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f wal_autocheckpo
f6f0: 69 6e 74 28 29 29 2e 0a 2a 2f 20 0a 69 6e 74 20 int())..*/ .int
f700: 73 71 6c 69 74 65 33 57 61 6c 44 65 66 61 75 6c sqlite3WalDefaul
f710: 74 48 6f 6f 6b 28 0a 20 20 76 6f 69 64 20 2a 70 tHook(. void *p
f720: 43 6c 69 65 6e 74 44 61 74 61 2c 20 20 20 20 20 ClientData,
f730: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 /* Argument */.
f740: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
f750: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 /* Conne
f760: 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 ction */. const
f770: 20 63 68 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 char *zDb,
f780: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 2a 2f /* Database */
f790: 0a 20 20 69 6e 74 20 6e 46 72 61 6d 65 20 20 20 . int nFrame
f7a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a /* Siz
f7b0: 65 20 6f 66 20 57 41 4c 20 2a 2f 0a 29 7b 0a 20 e of WAL */.){.
f7c0: 20 69 66 28 20 6e 46 72 61 6d 65 3e 3d 53 51 4c if( nFrame>=SQL
f7d0: 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 ITE_PTR_TO_INT(p
f7e0: 43 6c 69 65 6e 74 44 61 74 61 29 20 29 7b 0a 20 ClientData) ){.
f7f0: 20 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 sqlite3BeginB
f800: 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 enignMalloc();.
f810: 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 sqlite3_wal_c
f820: 68 65 63 6b 70 6f 69 6e 74 28 64 62 2c 20 7a 44 heckpoint(db, zD
f830: 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 b);. sqlite3E
f840: 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 ndBenignMalloc()
f850: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
f860: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
f870: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
f880: 54 5f 57 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 T_WAL */../*.**
f890: 43 6f 6e 66 69 67 75 72 65 20 61 6e 20 73 71 6c Configure an sql
f8a0: 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20 ite3_wal_hook()
f8b0: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 61 75 74 6f callback to auto
f8c0: 6d 61 74 69 63 61 6c 6c 79 20 63 68 65 63 6b 70 matically checkp
f8d0: 6f 69 6e 74 0a 2a 2a 20 61 20 64 61 74 61 62 61 oint.** a databa
f8e0: 73 65 20 61 66 74 65 72 20 63 6f 6d 6d 69 74 74 se after committ
f8f0: 69 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 6f ing a transactio
f900: 6e 20 69 66 20 74 68 65 72 65 20 61 72 65 20 6e n if there are n
f910: 46 72 61 6d 65 20 6f 72 0a 2a 2a 20 6d 6f 72 65 Frame or.** more
f920: 20 66 72 61 6d 65 73 20 69 6e 20 74 68 65 20 6c frames in the l
f930: 6f 67 20 66 69 6c 65 2e 20 50 61 73 73 69 6e 67 og file. Passing
f940: 20 7a 65 72 6f 20 6f 72 20 61 20 6e 65 67 61 74 zero or a negat
f950: 69 76 65 20 76 61 6c 75 65 20 61 73 20 74 68 65 ive value as the
f960: 0a 2a 2a 20 6e 46 72 61 6d 65 20 70 61 72 61 6d .** nFrame param
f970: 65 74 65 72 20 64 69 73 61 62 6c 65 73 20 61 75 eter disables au
f980: 74 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f 69 tomatic checkpoi
f990: 6e 74 73 20 65 6e 74 69 72 65 6c 79 2e 0a 2a 2a nts entirely..**
f9a0: 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 62 61 63 6b .** The callback
f9b0: 20 72 65 67 69 73 74 65 72 65 64 20 62 79 20 74 registered by t
f9c0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 70 his function rep
f9d0: 6c 61 63 65 73 20 61 6e 79 20 65 78 69 73 74 69 laces any existi
f9e0: 6e 67 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 72 ng callback.** r
f9f0: 65 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 20 egistered using
fa00: 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b sqlite3_wal_hook
fa10: 28 29 2e 20 4c 69 6b 65 77 69 73 65 2c 20 72 65 (). Likewise, re
fa20: 67 69 73 74 65 72 69 6e 67 20 61 20 63 61 6c 6c gistering a call
fa30: 62 61 63 6b 0a 2a 2a 20 75 73 69 6e 67 20 73 71 back.** using sq
fa40: 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 lite3_wal_hook()
fa50: 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 75 disables the au
fa60: 74 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f 69 tomatic checkpoi
fa70: 6e 74 20 6d 65 63 68 61 6e 69 73 6d 0a 2a 2a 20 nt mechanism.**
fa80: 63 6f 6e 66 69 67 75 72 65 64 20 62 79 20 74 68 configured by th
fa90: 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a is function..*/.
faa0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f int sqlite3_wal_
fab0: 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 28 73 autocheckpoint(s
fac0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
fad0: 6e 46 72 61 6d 65 29 7b 0a 23 69 66 64 65 66 20 nFrame){.#ifdef
fae0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
faf0: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
fb00: 45 52 28 64 62 29 3b 0a 20 20 55 4e 55 53 45 44 ER(db);. UNUSED
fb10: 5f 50 41 52 41 4d 45 54 45 52 28 6e 46 72 61 6d _PARAMETER(nFram
fb20: 65 29 3b 0a 23 65 6c 73 65 0a 23 69 66 64 65 66 e);.#else.#ifdef
fb30: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
fb40: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
fb50: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
fb60: 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 ckOk(db) ) retur
fb70: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
fb80: 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 69 BKPT;.#endif. i
fb90: 66 28 20 6e 46 72 61 6d 65 3e 30 20 29 7b 0a 20 f( nFrame>0 ){.
fba0: 20 20 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 sqlite3_wal_h
fbb0: 6f 6f 6b 28 64 62 2c 20 73 71 6c 69 74 65 33 57 ook(db, sqlite3W
fbc0: 61 6c 44 65 66 61 75 6c 74 48 6f 6f 6b 2c 20 53 alDefaultHook, S
fbd0: 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 QLITE_INT_TO_PTR
fbe0: 28 6e 46 72 61 6d 65 29 29 3b 0a 20 20 7d 65 6c (nFrame));. }el
fbf0: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f se{. sqlite3_
fc00: 77 61 6c 5f 68 6f 6f 6b 28 64 62 2c 20 30 2c 20 wal_hook(db, 0,
fc10: 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0);. }.#endif.
fc20: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
fc30: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 K;.}../*.** Regi
fc40: 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 6b 20 ster a callback
fc50: 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 65 61 to be invoked ea
fc60: 63 68 20 74 69 6d 65 20 61 20 74 72 61 6e 73 61 ch time a transa
fc70: 63 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 6e ction is written
fc80: 0a 2a 2a 20 69 6e 74 6f 20 74 68 65 20 77 72 69 .** into the wri
fc90: 74 65 2d 61 68 65 61 64 2d 6c 6f 67 20 62 79 20 te-ahead-log by
fca0: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f this database co
fcb0: 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 nnection..*/.voi
fcc0: 64 20 2a 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 d *sqlite3_wal_h
fcd0: 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a ook(. sqlite3 *
fce0: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 db,
fcf0: 20 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 /* Attach
fd00: 20 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 the hook to thi
fd10: 73 20 64 62 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 s db handle */.
fd20: 20 69 6e 74 28 2a 78 43 61 6c 6c 62 61 63 6b 29 int(*xCallback)
fd30: 28 76 6f 69 64 20 2a 2c 20 73 71 6c 69 74 65 33 (void *, sqlite3
fd40: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
fd50: 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 int),. void *pA
fd60: 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rg
fd70: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
fd80: 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 argument passed
fd90: 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 to xCallback()
fda0: 2a 2f 0a 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 */.){.#ifndef SQ
fdb0: 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 LITE_OMIT_WAL.
fdc0: 76 6f 69 64 20 2a 70 52 65 74 3b 0a 23 69 66 64 void *pRet;.#ifd
fdd0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
fde0: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
fdf0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
fe00: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
fe10: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
fe20: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
fe30: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 return 0;. }.#e
fe40: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
fe50: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
fe60: 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 utex);. pRet =
fe70: 64 62 2d 3e 70 57 61 6c 41 72 67 3b 0a 20 20 64 db->pWalArg;. d
fe80: 62 2d 3e 78 57 61 6c 43 61 6c 6c 62 61 63 6b 20 b->xWalCallback
fe90: 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 = xCallback;. d
fea0: 62 2d 3e 70 57 61 6c 41 72 67 20 3d 20 70 41 72 b->pWalArg = pAr
feb0: 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 g;. sqlite3_mut
fec0: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
fed0: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 ex);. return pR
fee0: 65 74 3b 0a 23 65 6c 73 65 0a 20 20 72 65 74 75 et;.#else. retu
fef0: 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a rn 0;.#endif.}..
ff00: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 70 6f 69 6e 74 /*.** Checkpoint
ff10: 20 64 61 74 61 62 61 73 65 20 7a 44 62 2e 0a 2a database zDb..*
ff20: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 77 61 /.int sqlite3_wa
ff30: 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 l_checkpoint_v2(
ff40: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
ff50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ff60: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 /* Database h
ff70: 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 andle */. const
ff80: 20 63 68 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 char *zDb,
ff90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 /* Na
ffa0: 6d 65 20 6f 66 20 61 74 74 61 63 68 65 64 20 64 me of attached d
ffb0: 61 74 61 62 61 73 65 20 28 6f 72 20 4e 55 4c 4c atabase (or NULL
ffc0: 29 20 2a 2f 0a 20 20 69 6e 74 20 65 4d 6f 64 65 ) */. int eMode
ffd0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
ffe0: 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 /* SQLITE
fff0: 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 2a 20 76 61 _CHECKPOINT_* va
10000 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e lue */. int *pn
10010 4c 6f 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 Log,
10020 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
10030 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 6c 6f 67 Size of WAL log
10040 20 69 6e 20 66 72 61 6d 65 73 20 2a 2f 0a 20 20 in frames */.
10050 69 6e 74 20 2a 70 6e 43 6b 70 74 20 20 20 20 20 int *pnCkpt
10060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10070 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 6c 20 6e 75 /* OUT: Total nu
10080 6d 62 65 72 20 6f 66 20 66 72 61 6d 65 73 20 63 mber of frames c
10090 68 65 63 6b 70 6f 69 6e 74 65 64 20 2a 2f 0a 29 heckpointed */.)
100a0 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
100b0 4f 4d 49 54 5f 57 41 4c 0a 20 20 72 65 74 75 72 OMIT_WAL. retur
100c0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6c n SQLITE_OK;.#el
100d0 73 65 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 se. int rc;
100e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
100f0 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
10100 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 ode */. int iDb
10110 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 = SQLITE_MAX_AT
10120 54 41 43 48 45 44 3b 20 20 2f 2a 20 73 71 6c 69 TACHED; /* sqli
10130 74 65 33 2e 61 44 62 5b 5d 20 69 6e 64 65 78 20 te3.aDb[] index
10140 6f 66 20 64 62 20 74 6f 20 63 68 65 63 6b 70 6f of db to checkpo
10150 69 6e 74 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 int */..#ifdef S
10160 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
10170 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
10180 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
10190 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 Ok(db) ) return
101a0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
101b0 50 54 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a PT;.#endif.. /*
101c0 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 Initialize the
101d0 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65 73 output variables
101e0 20 74 6f 20 2d 31 20 69 6e 20 63 61 73 65 20 61 to -1 in case a
101f0 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 n error occurs.
10200 2a 2f 0a 20 20 69 66 28 20 70 6e 4c 6f 67 20 29 */. if( pnLog )
10210 20 2a 70 6e 4c 6f 67 20 3d 20 2d 31 3b 0a 20 20 *pnLog = -1;.
10220 69 66 28 20 70 6e 43 6b 70 74 20 29 20 2a 70 6e if( pnCkpt ) *pn
10230 43 6b 70 74 20 3d 20 2d 31 3b 0a 0a 20 20 61 73 Ckpt = -1;.. as
10240 73 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 sert( SQLITE_CHE
10250 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 3d CKPOINT_PASSIVE=
10260 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
10270 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e SQLITE_CHECKPOIN
10280 54 5f 46 55 4c 4c 3d 3d 31 20 29 3b 0a 20 20 61 T_FULL==1 );. a
10290 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 ssert( SQLITE_CH
102a0 45 43 4b 50 4f 49 4e 54 5f 52 45 53 54 41 52 54 ECKPOINT_RESTART
102b0 3d 3d 32 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==2 );. assert(
102c0 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 SQLITE_CHECKPOI
102d0 4e 54 5f 54 52 55 4e 43 41 54 45 3d 3d 33 20 29 NT_TRUNCATE==3 )
102e0 3b 0a 20 20 69 66 28 20 65 4d 6f 64 65 3c 53 51 ;. if( eMode<SQ
102f0 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
10300 50 41 53 53 49 56 45 20 7c 7c 20 65 4d 6f 64 65 PASSIVE || eMode
10310 3e 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 >SQLITE_CHECKPOI
10320 4e 54 5f 54 52 55 4e 43 41 54 45 20 29 7b 0a 20 NT_TRUNCATE ){.
10330 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f /* EVIDENCE-O
10340 46 3a 20 52 2d 30 33 39 39 36 2d 31 32 30 38 38 F: R-03996-12088
10350 20 54 68 65 20 4d 20 70 61 72 61 6d 65 74 65 72 The M parameter
10360 20 6d 75 73 74 20 62 65 20 61 20 76 61 6c 69 64 must be a valid
10370 20 63 68 65 63 6b 70 6f 69 6e 74 0a 20 20 20 20 checkpoint.
10380 2a 2a 20 6d 6f 64 65 3a 20 2a 2f 0a 20 20 20 20 ** mode: */.
10390 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
103a0 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c SUSE;. }.. sql
103b0 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
103c0 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 (db->mutex);. i
103d0 66 28 20 7a 44 62 20 26 26 20 7a 44 62 5b 30 5d f( zDb && zDb[0]
103e0 20 29 7b 0a 20 20 20 20 69 44 62 20 3d 20 73 71 ){. iDb = sq
103f0 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 lite3FindDbName(
10400 64 62 2c 20 7a 44 62 29 3b 0a 20 20 7d 0a 20 20 db, zDb);. }.
10410 69 66 28 20 69 44 62 3c 30 20 29 7b 0a 20 20 20 if( iDb<0 ){.
10420 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
10430 4f 52 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 OR;. sqlite3E
10440 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 rrorWithMsg(db,
10450 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20 22 75 SQLITE_ERROR, "u
10460 6e 6b 6e 6f 77 6e 20 64 61 74 61 62 61 73 65 3a nknown database:
10470 20 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20 7d 65 %s", zDb);. }e
10480 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 62 75 73 lse{. db->bus
10490 79 48 61 6e 64 6c 65 72 2e 6e 42 75 73 79 20 3d yHandler.nBusy =
104a0 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 0;. rc = sql
104b0 69 74 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 64 ite3Checkpoint(d
104c0 62 2c 20 69 44 62 2c 20 65 4d 6f 64 65 2c 20 70 b, iDb, eMode, p
104d0 6e 4c 6f 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 nLog, pnCkpt);.
104e0 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
104f0 64 62 2c 20 72 63 29 3b 0a 20 20 7d 0a 20 20 72 db, rc);. }. r
10500 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
10510 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
10520 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
10530 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
10540 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
10550 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 f.}.../*.** Chec
10560 6b 70 6f 69 6e 74 20 64 61 74 61 62 61 73 65 20 kpoint database
10570 7a 44 62 2e 20 49 66 20 7a 44 62 20 69 73 20 4e zDb. If zDb is N
10580 55 4c 4c 2c 20 6f 72 20 69 66 20 74 68 65 20 62 ULL, or if the b
10590 75 66 66 65 72 20 7a 44 62 20 70 6f 69 6e 74 73 uffer zDb points
105a0 0a 2a 2a 20 74 6f 20 63 6f 6e 74 61 69 6e 73 20 .** to contains
105b0 61 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 20 73 74 a zero-length st
105c0 72 69 6e 67 2c 20 61 6c 6c 20 61 74 74 61 63 68 ring, all attach
105d0 65 64 20 64 61 74 61 62 61 73 65 73 20 61 72 65 ed databases are
105e0 20 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 .** checkpointe
105f0 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
10600 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
10610 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f (sqlite3 *db, co
10620 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 29 7b 0a nst char *zDb){.
10630 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
10640 3a 20 52 2d 34 31 36 31 33 2d 32 30 35 35 33 20 : R-41613-20553
10650 54 68 65 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f The sqlite3_wal_
10660 63 68 65 63 6b 70 6f 69 6e 74 28 44 2c 58 29 20 checkpoint(D,X)
10670 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f is equivalent to
10680 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 77 61 . ** sqlite3_wa
10690 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 l_checkpoint_v2(
106a0 44 2c 58 2c 53 51 4c 49 54 45 5f 43 48 45 43 4b D,X,SQLITE_CHECK
106b0 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 30 2c POINT_PASSIVE,0,
106c0 30 29 2e 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 0). */. return
106d0 73 71 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 sqlite3_wal_chec
106e0 6b 70 6f 69 6e 74 5f 76 32 28 64 62 2c 7a 44 62 kpoint_v2(db,zDb
106f0 2c 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 ,SQLITE_CHECKPOI
10700 4e 54 5f 50 41 53 53 49 56 45 2c 30 2c 30 29 3b NT_PASSIVE,0,0);
10710 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
10720 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a TE_OMIT_WAL./*.*
10730 2a 20 52 75 6e 20 61 20 63 68 65 63 6b 70 6f 69 * Run a checkpoi
10740 6e 74 20 6f 6e 20 64 61 74 61 62 61 73 65 20 69 nt on database i
10750 44 62 2e 20 54 68 69 73 20 69 73 20 61 20 6e 6f Db. This is a no
10760 2d 6f 70 20 69 66 20 64 61 74 61 62 61 73 65 20 -op if database
10770 69 44 62 20 69 73 0a 2a 2a 20 6e 6f 74 20 63 75 iDb is.** not cu
10780 72 72 65 6e 74 6c 79 20 6f 70 65 6e 20 69 6e 20 rrently open in
10790 57 41 4c 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 WAL mode..**.**
107a0 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
107b0 20 69 73 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 is open on the
107c0 64 61 74 61 62 61 73 65 20 62 65 69 6e 67 20 63 database being c
107d0 68 65 63 6b 70 6f 69 6e 74 65 64 2c 20 74 68 69 heckpointed, thi
107e0 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72 s .** function r
107f0 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4c 4f eturns SQLITE_LO
10800 43 4b 45 44 20 61 6e 64 20 61 20 63 68 65 63 6b CKED and a check
10810 70 6f 69 6e 74 20 69 73 20 6e 6f 74 20 61 74 74 point is not att
10820 65 6d 70 74 65 64 2e 20 49 66 20 0a 2a 2a 20 61 empted. If .** a
10830 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 n error occurs w
10840 68 69 6c 65 20 72 75 6e 6e 69 6e 67 20 74 68 65 hile running the
10850 20 63 68 65 63 6b 70 6f 69 6e 74 2c 20 61 6e 20 checkpoint, an
10860 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
10870 65 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 e is .** returne
10880 64 20 28 69 2e 65 2e 20 53 51 4c 49 54 45 5f 49 d (i.e. SQLITE_I
10890 4f 45 52 52 29 2e 20 4f 74 68 65 72 77 69 73 65 OERR). Otherwise
108a0 2c 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a , SQLITE_OK..**.
108b0 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 6f 6e 20 ** The mutex on
108c0 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
108d0 64 62 20 73 68 6f 75 6c 64 20 62 65 20 68 65 6c db should be hel
108e0 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 2e d by the caller.
108f0 20 54 68 65 20 6d 75 74 65 78 0a 2a 2a 20 61 73 The mutex.** as
10900 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
10910 65 20 73 70 65 63 69 66 69 63 20 62 2d 74 72 65 e specific b-tre
10920 65 20 62 65 69 6e 67 20 63 68 65 63 6b 70 6f 69 e being checkpoi
10930 6e 74 65 64 20 69 73 20 74 61 6b 65 6e 20 62 79 nted is taken by
10940 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 6f .** this functio
10950 6e 20 77 68 69 6c 65 20 74 68 65 20 63 68 65 63 n while the chec
10960 6b 70 6f 69 6e 74 20 69 73 20 72 75 6e 6e 69 6e kpoint is runnin
10970 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 69 44 62 20 g..**.** If iDb
10980 69 73 20 70 61 73 73 65 64 20 53 51 4c 49 54 45 is passed SQLITE
10990 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 2c 20 74 _MAX_ATTACHED, t
109a0 68 65 6e 20 61 6c 6c 20 61 74 74 61 63 68 65 64 hen all attached
109b0 20 64 61 74 61 62 61 73 65 73 20 61 72 65 0a 2a databases are.*
109c0 2a 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 2e 20 * checkpointed.
109d0 49 66 20 61 6e 20 65 72 72 6f 72 20 69 73 20 65 If an error is e
109e0 6e 63 6f 75 6e 74 65 72 65 64 20 69 74 20 69 73 ncountered it is
109f0 20 72 65 74 75 72 6e 65 64 20 69 6d 6d 65 64 69 returned immedi
10a00 61 74 65 6c 79 20 2d 0a 2a 2a 20 6e 6f 20 61 74 ately -.** no at
10a10 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f tempt is made to
10a20 20 63 68 65 63 6b 70 6f 69 6e 74 20 61 6e 79 20 checkpoint any
10a30 72 65 6d 61 69 6e 69 6e 67 20 64 61 74 61 62 61 remaining databa
10a40 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d ses..**.** Param
10a50 65 74 65 72 20 65 4d 6f 64 65 20 69 73 20 6f 6e eter eMode is on
10a60 65 20 6f 66 20 53 51 4c 49 54 45 5f 43 48 45 43 e of SQLITE_CHEC
10a70 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 20 KPOINT_PASSIVE,
10a80 46 55 4c 4c 20 6f 72 20 52 45 53 54 41 52 54 2e FULL or RESTART.
10a90 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 .*/.int sqlite3C
10aa0 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 heckpoint(sqlite
10ab0 33 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 3 *db, int iDb,
10ac0 69 6e 74 20 65 4d 6f 64 65 2c 20 69 6e 74 20 2a int eMode, int *
10ad0 70 6e 4c 6f 67 2c 20 69 6e 74 20 2a 70 6e 43 6b pnLog, int *pnCk
10ae0 70 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 pt){. int rc =
10af0 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
10b00 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
10b10 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 code */. int i
10b20 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
10b30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 /* Us
10b40 65 64 20 74 6f 20 69 74 65 72 61 74 65 20 74 68 ed to iterate th
10b50 72 6f 75 67 68 20 61 74 74 61 63 68 65 64 20 64 rough attached d
10b60 62 73 20 2a 2f 0a 20 20 69 6e 74 20 62 42 75 73 bs */. int bBus
10b70 79 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 y = 0;
10b80 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
10b90 69 66 20 53 51 4c 49 54 45 5f 42 55 53 59 20 68 if SQLITE_BUSY h
10ba0 61 73 20 62 65 65 6e 20 65 6e 63 6f 75 6e 74 65 as been encounte
10bb0 72 65 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 red */.. assert
10bc0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
10bd0 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
10be0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 6e );. assert( !pn
10bf0 4c 6f 67 20 7c 7c 20 2a 70 6e 4c 6f 67 3d 3d 2d Log || *pnLog==-
10c00 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 1 );. assert( !
10c10 70 6e 43 6b 70 74 20 7c 7c 20 2a 70 6e 43 6b 70 pnCkpt || *pnCkp
10c20 74 3d 3d 2d 31 20 29 3b 0a 0a 20 20 66 6f 72 28 t==-1 );.. for(
10c30 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 20 26 i=0; i<db->nDb &
10c40 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b & rc==SQLITE_OK;
10c50 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 69 i++){. if( i
10c60 3d 3d 69 44 62 20 7c 7c 20 69 44 62 3d 3d 53 51 ==iDb || iDb==SQ
10c70 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 LITE_MAX_ATTACHE
10c80 44 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 D ){. rc =
10c90 73 71 6c 69 74 65 33 42 74 72 65 65 43 68 65 63 sqlite3BtreeChec
10ca0 6b 70 6f 69 6e 74 28 64 62 2d 3e 61 44 62 5b 69 kpoint(db->aDb[i
10cb0 5d 2e 70 42 74 2c 20 65 4d 6f 64 65 2c 20 70 6e ].pBt, eMode, pn
10cc0 4c 6f 67 2c 20 70 6e 43 6b 70 74 29 3b 0a 20 20 Log, pnCkpt);.
10cd0 20 20 20 20 70 6e 4c 6f 67 20 3d 20 30 3b 0a 20 pnLog = 0;.
10ce0 20 20 20 20 20 70 6e 43 6b 70 74 20 3d 20 30 3b pnCkpt = 0;
10cf0 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
10d00 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 QLITE_BUSY ){.
10d10 20 20 20 20 20 20 62 42 75 73 79 20 3d 20 31 3b bBusy = 1;
10d20 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
10d30 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
10d40 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 . }. }.. re
10d50 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 turn (rc==SQLITE
10d60 5f 4f 4b 20 26 26 20 62 42 75 73 79 29 20 3f 20 _OK && bBusy) ?
10d70 53 51 4c 49 54 45 5f 42 55 53 59 20 3a 20 72 63 SQLITE_BUSY : rc
10d80 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
10d90 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f LITE_OMIT_WAL */
10da0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
10db0 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 72 ction returns tr
10dc0 75 65 20 69 66 20 6d 61 69 6e 2d 6d 65 6d 6f 72 ue if main-memor
10dd0 79 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 y should be used
10de0 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20 61 instead of.** a
10df0 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 temporary file
10e00 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 20 70 61 for transient pa
10e10 67 65 72 20 66 69 6c 65 73 20 61 6e 64 20 73 74 ger files and st
10e20 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 73 atement journals
10e30 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 72 ..** The value r
10e40 65 74 75 72 6e 65 64 20 64 65 70 65 6e 64 73 20 eturned depends
10e50 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 on the value of
10e60 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 28 db->temp_store (
10e70 72 75 6e 74 69 6d 65 0a 2a 2a 20 70 61 72 61 6d runtime.** param
10e80 65 74 65 72 29 20 61 6e 64 20 74 68 65 20 63 6f eter) and the co
10e90 6d 70 69 6c 65 20 74 69 6d 65 20 76 61 6c 75 65 mpile time value
10ea0 20 6f 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f of SQLITE_TEMP_
10eb0 53 54 4f 52 45 2e 20 54 68 65 0a 2a 2a 20 66 6f STORE. The.** fo
10ec0 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 64 65 llowing table de
10ed0 73 63 72 69 62 65 73 20 74 68 65 20 72 65 6c 61 scribes the rela
10ee0 74 69 6f 6e 73 68 69 70 20 62 65 74 77 65 65 6e tionship between
10ef0 20 74 68 65 73 65 20 74 77 6f 20 76 61 6c 75 65 these two value
10f00 73 0a 2a 2a 20 61 6e 64 20 74 68 69 73 20 66 75 s.** and this fu
10f10 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e 20 76 nctions return v
10f20 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 53 51 alue..**.** SQ
10f30 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 20 LITE_TEMP_STORE
10f40 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f db->temp_sto
10f50 72 65 20 20 20 20 20 4c 6f 63 61 74 69 6f 6e 20 re Location
10f60 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 of temporary dat
10f70 61 62 61 73 65 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d abase.** -----
10f80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 ------------
10f90 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 --------------
10fa0 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ------------
10fb0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10fc0 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 20 20 20 --.** 0
10fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e an
10fe0 79 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y
10ff0 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 file (retu
11000 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 20 20 20 rn 0).** 1
11010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11020 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
11030 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 72 file (r
11040 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 eturn 0).** 1
11050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11060 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 2
11070 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 memory
11080 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 (return 1).**
11090 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
110a0 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 0
110b0 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 file
110c0 20 20 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a (return 0).*
110d0 2a 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 * 2
110e0 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 1
110f0 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c fil
11100 65 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 30 e (return 0
11110 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 20 20 ).** 2
11120 20 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20 2
11130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11140 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 74 75 72 memory (retur
11150 6e 20 31 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 n 1).** 2
11160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11170 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
11180 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 memory (re
11190 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 33 20 20 turn 1).** 3
111a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
111b0 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 any
111c0 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 memory
111d0 28 72 65 74 75 72 6e 20 31 29 0a 2a 2f 0a 69 6e (return 1).*/.in
111e0 74 20 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d t sqlite3TempInM
111f0 65 6d 6f 72 79 28 63 6f 6e 73 74 20 73 71 6c 69 emory(const sqli
11200 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 20 53 51 te3 *db){.#if SQ
11210 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
11220 3d 31 0a 20 20 72 65 74 75 72 6e 20 28 20 64 62 =1. return ( db
11230 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 3d 3d 32 20 ->temp_store==2
11240 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 );.#endif.#if SQ
11250 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
11260 3d 32 0a 20 20 72 65 74 75 72 6e 20 28 20 64 62 =2. return ( db
11270 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 21 3d 31 20 ->temp_store!=1
11280 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 );.#endif.#if SQ
11290 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d LITE_TEMP_STORE=
112a0 3d 33 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 =3. return 1;.#
112b0 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
112c0 5f 54 45 4d 50 5f 53 54 4f 52 45 3c 31 20 7c 7c _TEMP_STORE<1 ||
112d0 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
112e0 52 45 3e 33 0a 20 20 72 65 74 75 72 6e 20 30 3b RE>3. return 0;
112f0 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
11300 20 52 65 74 75 72 6e 20 55 54 46 2d 38 20 65 6e Return UTF-8 en
11310 63 6f 64 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 coded English la
11320 6e 67 75 61 67 65 20 65 78 70 6c 61 6e 61 74 69 nguage explanati
11330 6f 6e 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 on of the most r
11340 65 63 65 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a ecent.** error..
11350 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 */.const char *s
11360 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 73 71 qlite3_errmsg(sq
11370 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 63 6f lite3 *db){. co
11380 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 69 nst char *z;. i
11390 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 72 65 f( !db ){. re
113a0 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 turn sqlite3ErrS
113b0 74 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 tr(SQLITE_NOMEM)
113c0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c ;. }. if( !sql
113d0 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
113e0 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 ickOrOk(db) ){.
113f0 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
11400 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4d 3ErrStr(SQLITE_M
11410 49 53 55 53 45 5f 42 4b 50 54 29 3b 0a 20 20 7d ISUSE_BKPT);. }
11420 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
11430 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
11440 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c );. if( db->mal
11450 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 locFailed ){.
11460 20 7a 20 3d 20 73 71 6c 69 74 65 33 45 72 72 53 z = sqlite3ErrS
11470 74 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 tr(SQLITE_NOMEM)
11480 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 74 ;. }else{. t
11490 65 73 74 63 61 73 65 28 20 64 62 2d 3e 70 45 72 estcase( db->pEr
114a0 72 3d 3d 30 20 29 3b 0a 20 20 20 20 7a 20 3d 20 r==0 );. z =
114b0 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 76 (char*)sqlite3_v
114c0 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e 70 45 alue_text(db->pE
114d0 72 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 rr);. assert(
114e0 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
114f0 65 64 20 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d ed );. if( z=
11500 3d 30 20 29 7b 0a 20 20 20 20 20 20 7a 20 3d 20 =0 ){. z =
11510 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 sqlite3ErrStr(db
11520 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 20 20 ->errCode);.
11530 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f }. }. sqlite3_
11540 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
11550 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
11560 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 z;.}..#ifndef S
11570 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
11580 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 ./*.** Return UT
11590 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45 6e 67 F-16 encoded Eng
115a0 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 78 lish language ex
115b0 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 planation of the
115c0 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 most recent.**
115d0 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 error..*/.const
115e0 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 65 72 void *sqlite3_er
115f0 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33 20 2a rmsg16(sqlite3 *
11600 64 62 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f db){. static co
11610 6e 73 74 20 75 31 36 20 6f 75 74 4f 66 4d 65 6d nst u16 outOfMem
11620 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6f 27 2c 20 [] = {. 'o',
11630 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 27 'u', 't', ' ', '
11640 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 20 27 6d o', 'f', ' ', 'm
11650 27 2c 20 27 65 27 2c 20 27 6d 27 2c 20 27 6f 27 ', 'e', 'm', 'o'
11660 2c 20 27 72 27 2c 20 27 79 27 2c 20 30 0a 20 20 , 'r', 'y', 0.
11670 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 };. static cons
11680 74 20 75 31 36 20 6d 69 73 75 73 65 5b 5d 20 3d t u16 misuse[] =
11690 20 7b 0a 20 20 20 20 27 6c 27 2c 20 27 69 27 2c {. 'l', 'i',
116a0 20 27 62 27 2c 20 27 72 27 2c 20 27 61 27 2c 20 'b', 'r', 'a',
116b0 27 72 27 2c 20 27 79 27 2c 20 27 20 27 2c 20 0a 'r', 'y', ' ', .
116c0 20 20 20 20 27 72 27 2c 20 27 6f 27 2c 20 27 75 'r', 'o', 'u
116d0 27 2c 20 27 74 27 2c 20 27 69 27 2c 20 27 6e 27 ', 't', 'i', 'n'
116e0 2c 20 27 65 27 2c 20 27 20 27 2c 20 0a 20 20 20 , 'e', ' ', .
116f0 20 27 63 27 2c 20 27 61 27 2c 20 27 6c 27 2c 20 'c', 'a', 'l',
11700 27 6c 27 2c 20 27 65 27 2c 20 27 64 27 2c 20 27 'l', 'e', 'd', '
11710 20 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 27 75 ', . 'o', 'u
11720 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 0a 20 20 ', 't', ' ', .
11730 20 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 'o', 'f', ' ',
11740 20 0a 20 20 20 20 27 73 27 2c 20 27 65 27 2c 20 . 's', 'e',
11750 27 71 27 2c 20 27 75 27 2c 20 27 65 27 2c 20 27 'q', 'u', 'e', '
11760 6e 27 2c 20 27 63 27 2c 20 27 65 27 2c 20 30 0a n', 'c', 'e', 0.
11770 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 76 6f };.. const vo
11780 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 62 id *z;. if( !db
11790 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 ){. return (
117a0 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 6d 3b void *)outOfMem;
117b0 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 6c 69 . }. if( !sqli
117c0 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 te3SafetyCheckSi
117d0 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 ckOrOk(db) ){.
117e0 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20 2a return (void *
117f0 29 6d 69 73 75 73 65 3b 0a 20 20 7d 0a 20 20 73 )misuse;. }. s
11800 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
11810 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
11820 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
11830 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a 20 3d ailed ){. z =
11840 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 (void *)outOfMe
11850 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 m;. }else{.
11860 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 z = sqlite3_valu
11870 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 45 72 e_text16(db->pEr
11880 72 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d 3d 30 r);. if( z==0
11890 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
118a0 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 3ErrorWithMsg(db
118b0 2c 20 64 62 2d 3e 65 72 72 43 6f 64 65 2c 20 73 , db->errCode, s
118c0 71 6c 69 74 65 33 45 72 72 53 74 72 28 64 62 2d qlite3ErrStr(db-
118d0 3e 65 72 72 43 6f 64 65 29 29 3b 0a 20 20 20 20 >errCode));.
118e0 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 z = sqlite3_va
118f0 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 lue_text16(db->p
11900 45 72 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Err);. }.
11910 2f 2a 20 41 20 6d 61 6c 6c 6f 63 28 29 20 6d 61 /* A malloc() ma
11920 79 20 68 61 76 65 20 66 61 69 6c 65 64 20 77 69 y have failed wi
11930 74 68 69 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f thin the call to
11940 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
11950 65 78 74 31 36 28 29 0a 20 20 20 20 2a 2a 20 61 ext16(). ** a
11960 62 6f 76 65 2e 20 49 66 20 74 68 69 73 20 69 73 bove. If this is
11970 20 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e 20 the case, then
11980 74 68 65 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 the db->mallocFa
11990 69 6c 65 64 20 66 6c 61 67 20 6e 65 65 64 73 20 iled flag needs
119a0 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 63 6c 65 to. ** be cle
119b0 61 72 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 ared before retu
119c0 72 6e 69 6e 67 2e 20 44 6f 20 74 68 69 73 20 64 rning. Do this d
119d0 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 irectly, instead
119e0 20 6f 66 20 76 69 61 0a 20 20 20 20 2a 2a 20 73 of via. ** s
119f0 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 29 2c qlite3ApiExit(),
11a00 20 74 6f 20 61 76 6f 69 64 20 73 65 74 74 69 6e to avoid settin
11a10 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 g the database h
11a20 61 6e 64 6c 65 20 65 72 72 6f 72 20 6d 65 73 73 andle error mess
11a30 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 age.. */.
11a40 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
11a50 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 = 0;. }. sqli
11a60 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
11a70 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
11a80 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66 turn z;.}.#endif
11a90 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
11aa0 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 UTF16 */../*.**
11ab0 52 65 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20 Return the most
11ac0 72 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 recent error cod
11ad0 65 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 e generated by a
11ae0 6e 20 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65 n SQLite routine
11af0 2e 20 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 . If NULL is.**
11b00 70 61 73 73 65 64 20 74 6f 20 74 68 69 73 20 66 passed to this f
11b10 75 6e 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75 unction, we assu
11b20 6d 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 me a malloc() fa
11b30 69 6c 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69 iled during sqli
11b40 74 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69 te3_open()..*/.i
11b50 6e 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f nt sqlite3_errco
11b60 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b de(sqlite3 *db){
11b70 0a 20 20 69 66 28 20 64 62 20 26 26 20 21 73 71 . if( db && !sq
11b80 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
11b90 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a SickOrOk(db) ){.
11ba0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
11bb0 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
11bc0 20 7d 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 }. if( !db ||
11bd0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
11be0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
11bf0 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d QLITE_NOMEM;. }
11c00 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 72 . return db->er
11c10 72 43 6f 64 65 20 26 20 64 62 2d 3e 65 72 72 4d rCode & db->errM
11c20 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 ask;.}.int sqlit
11c30 65 33 5f 65 78 74 65 6e 64 65 64 5f 65 72 72 63 e3_extended_errc
11c40 6f 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 ode(sqlite3 *db)
11c50 7b 0a 20 20 69 66 28 20 64 62 20 26 26 20 21 73 {. if( db && !s
11c60 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
11c70 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b kSickOrOk(db) ){
11c80 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
11c90 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
11ca0 20 20 7d 0a 20 20 69 66 28 20 21 64 62 20 7c 7c }. if( !db ||
11cb0 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
11cc0 64 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 d ){. return
11cd0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
11ce0 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 }. return db->e
11cf0 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a rrCode;.}../*.**
11d00 20 52 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 Return a string
11d10 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20 that describes
11d20 74 68 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f the kind of erro
11d30 72 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 r specified in t
11d40 68 65 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 20 he.** argument.
11d50 20 46 6f 72 20 6e 6f 77 2c 20 74 68 69 73 20 73 For now, this s
11d60 69 6d 70 6c 79 20 63 61 6c 6c 73 20 74 68 65 20 imply calls the
11d70 69 6e 74 65 72 6e 61 6c 20 73 71 6c 69 74 65 33 internal sqlite3
11d80 45 72 72 53 74 72 28 29 0a 2a 2a 20 66 75 6e 63 ErrStr().** func
11d90 74 69 6f 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 tion..*/.const c
11da0 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 har *sqlite3_err
11db0 73 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 20 72 str(int rc){. r
11dc0 65 74 75 72 6e 20 73 71 6c 69 74 65 33 45 72 72 eturn sqlite3Err
11dd0 53 74 72 28 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a Str(rc);.}../*.*
11de0 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 63 * Create a new c
11df0 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 69 6f ollating functio
11e00 6e 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 22 n for database "
11e10 64 62 22 2e 20 20 54 68 65 20 6e 61 6d 65 20 69 db". The name i
11e20 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 6e 64 20 74 s zName.** and t
11e30 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 65 he encoding is e
11e40 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nc..*/.static in
11e50 74 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f t createCollatio
11e60 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 n(. sqlite3* db
11e70 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ,. const char *
11e80 7a 4e 61 6d 65 2c 20 0a 20 20 75 38 20 65 6e 63 zName, . u8 enc
11e90 2c 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a ,. void* pCtx,.
11ea0 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 int(*xCompare)
11eb0 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 (void*,int,const
11ec0 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 void*,int,const
11ed0 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 28 void*),. void(
11ee0 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b *xDel)(void*).){
11ef0 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c . CollSeq *pCol
11f00 6c 3b 0a 20 20 69 6e 74 20 65 6e 63 32 3b 0a 20 l;. int enc2;.
11f10 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 . assert( sqli
11f20 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 te3_mutex_held(d
11f30 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 b->mutex) );..
11f40 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 /* If SQLITE_UTF
11f50 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 16 is specified
11f60 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 as the encoding
11f70 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 type, transform
11f80 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 this. ** to one
11f90 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 of SQLITE_UTF16
11fa0 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 LE or SQLITE_UTF
11fb0 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 16BE using the.
11fc0 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 ** SQLITE_UTF16
11fd0 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 NATIVE macro. SQ
11fe0 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f LITE_UTF16 is no
11ff0 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c t used internall
12000 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e 63 32 20 3d y.. */. enc2 =
12010 20 65 6e 63 3b 0a 20 20 74 65 73 74 63 61 73 65 enc;. testcase
12020 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 ( enc2==SQLITE_U
12030 54 46 31 36 20 29 3b 0a 20 20 74 65 73 74 63 61 TF16 );. testca
12040 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 se( enc2==SQLITE
12050 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 _UTF16_ALIGNED )
12060 3b 0a 20 20 69 66 28 20 65 6e 63 32 3d 3d 53 51 ;. if( enc2==SQ
12070 4c 49 54 45 5f 55 54 46 31 36 20 7c 7c 20 65 6e LITE_UTF16 || en
12080 63 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 c2==SQLITE_UTF16
12090 5f 41 4c 49 47 4e 45 44 20 29 7b 0a 20 20 20 20 _ALIGNED ){.
120a0 65 6e 63 32 20 3d 20 53 51 4c 49 54 45 5f 55 54 enc2 = SQLITE_UT
120b0 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 20 F16NATIVE;. }.
120c0 20 69 66 28 20 65 6e 63 32 3c 53 51 4c 49 54 45 if( enc2<SQLITE
120d0 5f 55 54 46 38 20 7c 7c 20 65 6e 63 32 3e 53 51 _UTF8 || enc2>SQ
120e0 4c 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b 0a LITE_UTF16BE ){.
120f0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
12100 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
12110 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 }.. /* Check i
12120 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 72 f this call is r
12130 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 70 6c 61 emoving or repla
12140 63 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 cing an existing
12150 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 20 2a 2a collation . **
12160 20 73 65 71 75 65 6e 63 65 2e 20 49 66 20 73 6f sequence. If so
12170 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 , and there are
12180 61 63 74 69 76 65 20 56 4d 73 2c 20 72 65 74 75 active VMs, retu
12190 72 6e 20 62 75 73 79 2e 20 49 66 20 74 68 65 72 rn busy. If ther
121a0 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f 20 61 63 e. ** are no ac
121b0 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 61 6c 69 tive VMs, invali
121c0 64 61 74 65 20 61 6e 79 20 70 72 65 2d 63 6f 6d date any pre-com
121d0 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e 74 73 piled statements
121e0 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f 6c 6c 20 3d .. */. pColl =
121f0 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c sqlite3FindColl
12200 53 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 32 Seq(db, (u8)enc2
12210 2c 20 7a 4e 61 6d 65 2c 20 30 29 3b 0a 20 20 69 , zName, 0);. i
12220 66 28 20 70 43 6f 6c 6c 20 26 26 20 70 43 6f 6c f( pColl && pCol
12230 6c 2d 3e 78 43 6d 70 20 29 7b 0a 20 20 20 20 69 l->xCmp ){. i
12240 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 74 69 f( db->nVdbeActi
12250 76 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 ve ){. sqli
12260 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 te3ErrorWithMsg(
12270 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c db, SQLITE_BUSY,
12280 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 62 6c . "unabl
12290 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f 64 69 e to delete/modi
122a0 66 79 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 fy collation seq
122b0 75 65 6e 63 65 20 64 75 65 20 74 6f 20 61 63 74 uence due to act
122c0 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 ive statements")
122d0 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
122e0 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 QLITE_BUSY;.
122f0 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 }. sqlite3Exp
12300 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
12310 6d 65 6e 74 73 28 64 62 29 3b 0a 0a 20 20 20 20 ments(db);..
12320 2f 2a 20 49 66 20 63 6f 6c 6c 61 74 69 6f 6e 20 /* If collation
12330 73 65 71 75 65 6e 63 65 20 70 43 6f 6c 6c 20 77 sequence pColl w
12340 61 73 20 63 72 65 61 74 65 64 20 64 69 72 65 63 as created direc
12350 74 6c 79 20 62 79 20 61 20 63 61 6c 6c 20 74 6f tly by a call to
12360 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f . ** sqlite3_
12370 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e create_collation
12380 2c 20 61 6e 64 20 6e 6f 74 20 67 65 6e 65 72 61 , and not genera
12390 74 65 64 20 62 79 20 73 79 6e 74 68 43 6f 6c 6c ted by synthColl
123a0 53 65 71 28 29 2c 0a 20 20 20 20 2a 2a 20 74 68 Seq(),. ** th
123b0 65 6e 20 61 6e 79 20 63 6f 70 69 65 73 20 6d 61 en any copies ma
123c0 64 65 20 62 79 20 73 79 6e 74 68 43 6f 6c 6c 53 de by synthCollS
123d0 65 71 28 29 20 6e 65 65 64 20 74 6f 20 62 65 20 eq() need to be
123e0 69 6e 76 61 6c 69 64 61 74 65 64 2e 0a 20 20 20 invalidated..
123f0 20 2a 2a 20 41 6c 73 6f 2c 20 63 6f 6c 6c 61 74 ** Also, collat
12400 69 6f 6e 20 64 65 73 74 72 75 63 74 6f 72 20 2d ion destructor -
12410 20 43 6f 6c 6c 53 65 71 2e 78 44 65 6c 28 29 20 CollSeq.xDel()
12420 2d 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 6e - function may n
12430 65 65 64 0a 20 20 20 20 2a 2a 20 74 6f 20 62 65 eed. ** to be
12440 20 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a 2f 20 called.. */
12450 0a 20 20 20 20 69 66 28 20 28 70 43 6f 6c 6c 2d . if( (pColl-
12460 3e 65 6e 63 20 26 20 7e 53 51 4c 49 54 45 5f 55 >enc & ~SQLITE_U
12470 54 46 31 36 5f 41 4c 49 47 4e 45 44 29 3d 3d 65 TF16_ALIGNED)==e
12480 6e 63 32 20 29 7b 0a 20 20 20 20 20 20 43 6f 6c nc2 ){. Col
12490 6c 53 65 71 20 2a 61 43 6f 6c 6c 20 3d 20 73 71 lSeq *aColl = sq
124a0 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 26 64 lite3HashFind(&d
124b0 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 7a 4e 61 b->aCollSeq, zNa
124c0 6d 65 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6a me);. int j
124d0 3b 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b ;. for(j=0;
124e0 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 j<3; j++){.
124f0 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 20 3d CollSeq *p =
12500 20 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 &aColl[j];.
12510 20 20 20 20 69 66 28 20 70 2d 3e 65 6e 63 3d 3d if( p->enc==
12520 70 43 6f 6c 6c 2d 3e 65 6e 63 20 29 7b 0a 20 20 pColl->enc ){.
12530 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 78 if( p->x
12540 44 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Del ){.
12550 20 20 20 70 2d 3e 78 44 65 6c 28 70 2d 3e 70 55 p->xDel(p->pU
12560 73 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ser);.
12570 7d 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 78 }. p->x
12580 43 6d 70 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 Cmp = 0;.
12590 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
125a0 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c 20 3d 20 . }.. pColl =
125b0 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 sqlite3FindCollS
125c0 65 71 28 64 62 2c 20 28 75 38 29 65 6e 63 32 2c eq(db, (u8)enc2,
125d0 20 7a 4e 61 6d 65 2c 20 31 29 3b 0a 20 20 69 66 zName, 1);. if
125e0 28 20 70 43 6f 6c 6c 3d 3d 30 20 29 20 72 65 74 ( pColl==0 ) ret
125f0 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
12600 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 ;. pColl->xCmp
12610 3d 20 78 43 6f 6d 70 61 72 65 3b 0a 20 20 70 43 = xCompare;. pC
12620 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d 20 70 43 74 oll->pUser = pCt
12630 78 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 44 65 6c x;. pColl->xDel
12640 20 3d 20 78 44 65 6c 3b 0a 20 20 70 43 6f 6c 6c = xDel;. pColl
12650 2d 3e 65 6e 63 20 3d 20 28 75 38 29 28 65 6e 63 ->enc = (u8)(enc
12660 32 20 7c 20 28 65 6e 63 20 26 20 53 51 4c 49 54 2 | (enc & SQLIT
12670 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 29 E_UTF16_ALIGNED)
12680 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f );. sqlite3Erro
12690 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 r(db, SQLITE_OK)
126a0 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
126b0 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 E_OK;.}.../*.**
126c0 54 68 69 73 20 61 72 72 61 79 20 64 65 66 69 6e This array defin
126d0 65 73 20 68 61 72 64 20 75 70 70 65 72 20 62 6f es hard upper bo
126e0 75 6e 64 73 20 6f 6e 20 6c 69 6d 69 74 20 76 61 unds on limit va
126f0 6c 75 65 73 2e 20 20 54 68 65 0a 2a 2a 20 69 6e lues. The.** in
12700 69 74 69 61 6c 69 7a 65 72 20 6d 75 73 74 20 62 itializer must b
12710 65 20 6b 65 70 74 20 69 6e 20 73 79 6e 63 20 77 e kept in sync w
12720 69 74 68 20 74 68 65 20 53 51 4c 49 54 45 5f 4c ith the SQLITE_L
12730 49 4d 49 54 5f 2a 0a 2a 2a 20 23 64 65 66 69 6e IMIT_*.** #defin
12740 65 73 20 69 6e 20 73 71 6c 69 74 65 33 2e 68 2e es in sqlite3.h.
12750 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 .*/.static const
12760 20 69 6e 74 20 61 48 61 72 64 4c 69 6d 69 74 5b int aHardLimit[
12770 5d 20 3d 20 7b 0a 20 20 53 51 4c 49 54 45 5f 4d ] = {. SQLITE_M
12780 41 58 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c AX_LENGTH,. SQL
12790 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
127a0 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 TH,. SQLITE_MAX
127b0 5f 43 4f 4c 55 4d 4e 2c 0a 20 20 53 51 4c 49 54 _COLUMN,. SQLIT
127c0 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 E_MAX_EXPR_DEPTH
127d0 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ,. SQLITE_MAX_C
127e0 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 2c 0a OMPOUND_SELECT,.
127f0 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 SQLITE_MAX_VDB
12800 45 5f 4f 50 2c 0a 20 20 53 51 4c 49 54 45 5f 4d E_OP,. SQLITE_M
12810 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 2c AX_FUNCTION_ARG,
12820 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 . SQLITE_MAX_AT
12830 54 41 43 48 45 44 2c 0a 20 20 53 51 4c 49 54 45 TACHED,. SQLITE
12840 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 _MAX_LIKE_PATTER
12850 4e 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 N_LENGTH,. SQLI
12860 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f TE_MAX_VARIABLE_
12870 4e 55 4d 42 45 52 2c 20 20 20 20 20 20 2f 2a 20 NUMBER, /*
12880 49 4d 50 3a 20 52 2d 33 38 30 39 31 2d 33 32 33 IMP: R-38091-323
12890 35 32 20 2a 2f 0a 20 20 53 51 4c 49 54 45 5f 4d 52 */. SQLITE_M
128a0 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 AX_TRIGGER_DEPTH
128b0 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 ,. SQLITE_MAX_W
128c0 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 2c 0a 7d ORKER_THREADS,.}
128d0 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 ;../*.** Make su
128e0 72 65 20 74 68 65 20 68 61 72 64 20 6c 69 6d 69 re the hard limi
128f0 74 73 20 61 72 65 20 73 65 74 20 74 6f 20 72 65 ts are set to re
12900 61 73 6f 6e 61 62 6c 65 20 76 61 6c 75 65 73 0a asonable values.
12910 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 */.#if SQLITE_MA
12920 58 5f 4c 45 4e 47 54 48 3c 31 30 30 0a 23 20 65 X_LENGTH<100.# e
12930 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f rror SQLITE_MAX_
12940 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 61 LENGTH must be a
12950 74 20 6c 65 61 73 74 20 31 30 30 0a 23 65 6e 64 t least 100.#end
12960 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 if.#if SQLITE_MA
12970 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 3c 31 30 30 X_SQL_LENGTH<100
12980 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
12990 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 6d MAX_SQL_LENGTH m
129a0 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 ust be at least
129b0 31 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 100.#endif.#if S
129c0 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 QLITE_MAX_SQL_LE
129d0 4e 47 54 48 3e 53 51 4c 49 54 45 5f 4d 41 58 5f NGTH>SQLITE_MAX_
129e0 4c 45 4e 47 54 48 0a 23 20 65 72 72 6f 72 20 53 LENGTH.# error S
129f0 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 QLITE_MAX_SQL_LE
12a00 4e 47 54 48 20 6d 75 73 74 20 6e 6f 74 20 62 65 NGTH must not be
12a10 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 53 51 greater than SQ
12a20 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 0a LITE_MAX_LENGTH.
12a30 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
12a40 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 E_MAX_COMPOUND_S
12a50 45 4c 45 43 54 3c 32 0a 23 20 65 72 72 6f 72 20 ELECT<2.# error
12a60 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f SQLITE_MAX_COMPO
12a70 55 4e 44 5f 53 45 4c 45 43 54 20 6d 75 73 74 20 UND_SELECT must
12a80 62 65 20 61 74 20 6c 65 61 73 74 20 32 0a 23 65 be at least 2.#e
12a90 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
12aa0 4d 41 58 5f 56 44 42 45 5f 4f 50 3c 34 30 0a 23 MAX_VDBE_OP<40.#
12ab0 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 error SQLITE_MA
12ac0 58 5f 56 44 42 45 5f 4f 50 20 6d 75 73 74 20 62 X_VDBE_OP must b
12ad0 65 20 61 74 20 6c 65 61 73 74 20 34 30 0a 23 65 e at least 40.#e
12ae0 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
12af0 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 MAX_FUNCTION_ARG
12b00 3c 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 <0 || SQLITE_MAX
12b10 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 3e 31 30 _FUNCTION_ARG>10
12b20 30 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 00.# error SQLIT
12b30 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 E_MAX_FUNCTION_A
12b40 52 47 20 6d 75 73 74 20 62 65 20 62 65 74 77 65 RG must be betwe
12b50 65 6e 20 30 20 61 6e 64 20 31 30 30 30 0a 23 65 en 0 and 1000.#e
12b60 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
12b70 4d 41 58 5f 41 54 54 41 43 48 45 44 3c 30 20 7c MAX_ATTACHED<0 |
12b80 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 | SQLITE_MAX_ATT
12b90 41 43 48 45 44 3e 31 32 35 0a 23 20 65 72 72 6f ACHED>125.# erro
12ba0 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 r SQLITE_MAX_ATT
12bb0 41 43 48 45 44 20 6d 75 73 74 20 62 65 20 62 65 ACHED must be be
12bc0 74 77 65 65 6e 20 30 20 61 6e 64 20 31 32 35 0a tween 0 and 125.
12bd0 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
12be0 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 E_MAX_LIKE_PATTE
12bf0 52 4e 5f 4c 45 4e 47 54 48 3c 31 0a 23 20 65 72 RN_LENGTH<1.# er
12c00 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c ror SQLITE_MAX_L
12c10 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
12c20 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 TH must be at le
12c30 61 73 74 20 31 0a 23 65 6e 64 69 66 0a 23 69 66 ast 1.#endif.#if
12c40 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 SQLITE_MAX_COLU
12c50 4d 4e 3e 33 32 37 36 37 0a 23 20 65 72 72 6f 72 MN>32767.# error
12c60 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 SQLITE_MAX_COLU
12c70 4d 4e 20 6d 75 73 74 20 6e 6f 74 20 65 78 63 65 MN must not exce
12c80 65 64 20 33 32 37 36 37 0a 23 65 6e 64 69 66 0a ed 32767.#endif.
12c90 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 54 #if SQLITE_MAX_T
12ca0 52 49 47 47 45 52 5f 44 45 50 54 48 3c 31 0a 23 RIGGER_DEPTH<1.#
12cb0 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 error SQLITE_MA
12cc0 58 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 20 X_TRIGGER_DEPTH
12cd0 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 must be at least
12ce0 20 31 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 1.#endif.#if SQ
12cf0 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f LITE_MAX_WORKER_
12d00 54 48 52 45 41 44 53 3c 30 20 7c 7c 20 53 51 4c THREADS<0 || SQL
12d10 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
12d20 48 52 45 41 44 53 3e 35 30 0a 23 20 65 72 72 6f HREADS>50.# erro
12d30 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 r SQLITE_MAX_WOR
12d40 4b 45 52 5f 54 48 52 45 41 44 53 20 6d 75 73 74 KER_THREADS must
12d50 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e be between 0 an
12d60 64 20 35 30 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a d 50.#endif.../*
12d70 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 76 .** Change the v
12d80 61 6c 75 65 20 6f 66 20 61 20 6c 69 6d 69 74 2e alue of a limit.
12d90 20 20 52 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 Report the old
12da0 20 76 61 6c 75 65 2e 0a 2a 2a 20 49 66 20 61 6e value..** If an
12db0 20 69 6e 76 61 6c 69 64 20 6c 69 6d 69 74 20 69 invalid limit i
12dc0 6e 64 65 78 20 69 73 20 73 75 70 70 6c 69 65 64 ndex is supplied
12dd0 2c 20 72 65 70 6f 72 74 20 2d 31 2e 0a 2a 2a 20 , report -1..**
12de0 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 Make no changes
12df0 62 75 74 20 73 74 69 6c 6c 20 72 65 70 6f 72 74 but still report
12e00 20 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 20 69 the old value i
12e10 66 20 74 68 65 0a 2a 2a 20 6e 65 77 20 6c 69 6d f the.** new lim
12e20 69 74 20 69 73 20 6e 65 67 61 74 69 76 65 2e 0a it is negative..
12e30 2a 2a 0a 2a 2a 20 41 20 6e 65 77 20 6c 6f 77 65 **.** A new lowe
12e40 72 20 6c 69 6d 69 74 20 64 6f 65 73 20 6e 6f 74 r limit does not
12e50 20 73 68 72 69 6e 6b 20 65 78 69 73 74 69 6e 67 shrink existing
12e60 20 63 6f 6e 73 74 72 75 63 74 73 2e 0a 2a 2a 20 constructs..**
12e70 49 74 20 6d 65 72 65 6c 79 20 70 72 65 76 65 6e It merely preven
12e80 74 73 20 6e 65 77 20 63 6f 6e 73 74 72 75 63 74 ts new construct
12e90 73 20 74 68 61 74 20 65 78 63 65 65 64 20 74 68 s that exceed th
12ea0 65 20 6c 69 6d 69 74 0a 2a 2a 20 66 72 6f 6d 20 e limit.** from
12eb0 66 6f 72 6d 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 forming..*/.int
12ec0 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74 28 73 71 sqlite3_limit(sq
12ed0 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6c lite3 *db, int l
12ee0 69 6d 69 74 49 64 2c 20 69 6e 74 20 6e 65 77 4c imitId, int newL
12ef0 69 6d 69 74 29 7b 0a 20 20 69 6e 74 20 6f 6c 64 imit){. int old
12f00 4c 69 6d 69 74 3b 0a 0a 23 69 66 64 65 66 20 53 Limit;..#ifdef S
12f10 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
12f20 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
12f30 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
12f40 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 Ok(db) ){. (v
12f50 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 oid)SQLITE_MISUS
12f60 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 E_BKPT;. retu
12f70 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 65 6e 64 69 rn -1;. }.#endi
12f80 66 0a 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 f.. /* EVIDENCE
12f90 2d 4f 46 3a 20 52 2d 33 30 31 38 39 2d 35 34 30 -OF: R-30189-540
12fa0 39 37 20 46 6f 72 20 65 61 63 68 20 6c 69 6d 69 97 For each limi
12fb0 74 20 63 61 74 65 67 6f 72 79 20 53 51 4c 49 54 t category SQLIT
12fc0 45 5f 4c 49 4d 49 54 5f 4e 41 4d 45 0a 20 20 2a E_LIMIT_NAME. *
12fd0 2a 20 74 68 65 72 65 20 69 73 20 61 20 68 61 72 * there is a har
12fe0 64 20 75 70 70 65 72 20 62 6f 75 6e 64 20 73 65 d upper bound se
12ff0 74 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d t at compile-tim
13000 65 20 62 79 20 61 20 43 20 70 72 65 70 72 6f 63 e by a C preproc
13010 65 73 73 6f 72 0a 20 20 2a 2a 20 6d 61 63 72 6f essor. ** macro
13020 20 63 61 6c 6c 65 64 20 53 51 4c 49 54 45 5f 4d called SQLITE_M
13030 41 58 5f 4e 41 4d 45 2e 20 28 54 68 65 20 22 5f AX_NAME. (The "_
13040 4c 49 4d 49 54 5f 22 20 69 6e 20 74 68 65 20 6e LIMIT_" in the n
13050 61 6d 65 20 69 73 20 63 68 61 6e 67 65 64 20 74 ame is changed t
13060 6f 0a 20 20 2a 2a 20 22 5f 4d 41 58 5f 22 2e 29 o. ** "_MAX_".)
13070 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
13080 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
13090 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d 3d E_LIMIT_LENGTH]=
130a0 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 =SQLITE_MAX_LENG
130b0 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
130c0 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
130d0 45 5f 4c 49 4d 49 54 5f 53 51 4c 5f 4c 45 4e 47 E_LIMIT_SQL_LENG
130e0 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f TH]==SQLITE_MAX_
130f0 53 51 4c 5f 4c 45 4e 47 54 48 20 29 3b 0a 20 20 SQL_LENGTH );.
13100 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
13110 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
13120 43 4f 4c 55 4d 4e 5d 3d 3d 53 51 4c 49 54 45 5f COLUMN]==SQLITE_
13130 4d 41 58 5f 43 4f 4c 55 4d 4e 20 29 3b 0a 20 20 MAX_COLUMN );.
13140 61 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d assert( aHardLim
13150 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f it[SQLITE_LIMIT_
13160 45 58 50 52 5f 44 45 50 54 48 5d 3d 3d 53 51 4c EXPR_DEPTH]==SQL
13170 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 ITE_MAX_EXPR_DEP
13180 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
13190 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
131a0 45 5f 4c 49 4d 49 54 5f 43 4f 4d 50 4f 55 4e 44 E_LIMIT_COMPOUND
131b0 5f 53 45 4c 45 43 54 5d 3d 3d 53 51 4c 49 54 45 _SELECT]==SQLITE
131c0 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 _MAX_COMPOUND_SE
131d0 4c 45 43 54 29 3b 0a 20 20 61 73 73 65 72 74 28 LECT);. assert(
131e0 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 aHardLimit[SQLI
131f0 54 45 5f 4c 49 4d 49 54 5f 56 44 42 45 5f 4f 50 TE_LIMIT_VDBE_OP
13200 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 ]==SQLITE_MAX_VD
13210 42 45 5f 4f 50 20 29 3b 0a 20 20 61 73 73 65 72 BE_OP );. asser
13220 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
13230 4c 49 54 45 5f 4c 49 4d 49 54 5f 46 55 4e 43 54 LITE_LIMIT_FUNCT
13240 49 4f 4e 5f 41 52 47 5d 3d 3d 53 51 4c 49 54 45 ION_ARG]==SQLITE
13250 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 _MAX_FUNCTION_AR
13260 47 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 G );. assert( a
13270 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 HardLimit[SQLITE
13280 5f 4c 49 4d 49 54 5f 41 54 54 41 43 48 45 44 5d _LIMIT_ATTACHED]
13290 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 ==SQLITE_MAX_ATT
132a0 41 43 48 45 44 20 29 3b 0a 20 20 61 73 73 65 72 ACHED );. asser
132b0 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
132c0 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 49 4b 45 5f LITE_LIMIT_LIKE_
132d0 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 5d 3d PATTERN_LENGTH]=
132e0 3d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 =.
132f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13300 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13310 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 SQLITE_MAX_LIKE
13320 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 20 _PATTERN_LENGTH
13330 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 );. assert( aHa
13340 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c rdLimit[SQLITE_L
13350 49 4d 49 54 5f 56 41 52 49 41 42 4c 45 5f 4e 55 IMIT_VARIABLE_NU
13360 4d 42 45 52 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 MBER]==SQLITE_MA
13370 58 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 X_VARIABLE_NUMBE
13380 52 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 R);. assert( aH
13390 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f ardLimit[SQLITE_
133a0 4c 49 4d 49 54 5f 54 52 49 47 47 45 52 5f 44 45 LIMIT_TRIGGER_DE
133b0 50 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 PTH]==SQLITE_MAX
133c0 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 20 29 _TRIGGER_DEPTH )
133d0 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
133e0 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
133f0 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 MIT_WORKER_THREA
13400 44 53 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f DS]==SQLITE_MAX_
13410 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 29 WORKER_THREADS )
13420 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 ;. assert( SQLI
13430 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f TE_LIMIT_WORKER_
13440 54 48 52 45 41 44 53 3d 3d 28 53 51 4c 49 54 45 THREADS==(SQLITE
13450 5f 4e 5f 4c 49 4d 49 54 2d 31 29 20 29 3b 0a 0a _N_LIMIT-1) );..
13460 0a 20 20 69 66 28 20 6c 69 6d 69 74 49 64 3c 30 . if( limitId<0
13470 20 7c 7c 20 6c 69 6d 69 74 49 64 3e 3d 53 51 4c || limitId>=SQL
13480 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 29 7b 0a 20 ITE_N_LIMIT ){.
13490 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 return -1;.
134a0 7d 0a 20 20 6f 6c 64 4c 69 6d 69 74 20 3d 20 64 }. oldLimit = d
134b0 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 b->aLimit[limitI
134c0 64 5d 3b 0a 20 20 69 66 28 20 6e 65 77 4c 69 6d d];. if( newLim
134d0 69 74 3e 3d 30 20 29 7b 20 20 20 20 20 20 20 20 it>=0 ){
134e0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4d /* IM
134f0 50 3a 20 52 2d 35 32 34 37 36 2d 32 38 37 33 32 P: R-52476-28732
13500 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e 65 77 4c */. if( newL
13510 69 6d 69 74 3e 61 48 61 72 64 4c 69 6d 69 74 5b imit>aHardLimit[
13520 6c 69 6d 69 74 49 64 5d 20 29 7b 0a 20 20 20 20 limitId] ){.
13530 20 20 6e 65 77 4c 69 6d 69 74 20 3d 20 61 48 61 newLimit = aHa
13540 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d rdLimit[limitId]
13550 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 31 34 ; /* IMP: R-514
13560 36 33 2d 32 35 36 33 34 20 2a 2f 0a 20 20 20 20 63-25634 */.
13570 7d 0a 20 20 20 20 64 62 2d 3e 61 4c 69 6d 69 74 }. db->aLimit
13580 5b 6c 69 6d 69 74 49 64 5d 20 3d 20 6e 65 77 4c [limitId] = newL
13590 69 6d 69 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 imit;. }. retu
135a0 72 6e 20 6f 6c 64 4c 69 6d 69 74 3b 20 20 20 20 rn oldLimit;
135b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
135c0 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 33 33 34 31 /* IMP: R-53341
135d0 2d 33 35 34 31 39 20 2a 2f 0a 7d 0a 23 69 66 20 -35419 */.}.#if
135e0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
135f0 4e 41 42 4c 45 5f 41 55 54 4f 5f 50 52 4f 46 49 NABLE_AUTO_PROFI
13600 4c 45 29 0a 2f 2a 20 73 74 64 65 72 72 20 6c 6f LE)./* stderr lo
13610 67 67 69 6e 67 20 2a 2f 0a 76 6f 69 64 20 5f 73 gging */.void _s
13620 71 6c 69 74 65 5f 61 75 74 6f 5f 70 72 6f 66 69 qlite_auto_profi
13630 6c 65 28 76 6f 69 64 20 2a 61 75 78 2c 20 63 6f le(void *aux, co
13640 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 2c 20 75 nst char *sql, u
13650 36 34 20 6e 73 29 3b 0a 76 6f 69 64 20 5f 73 71 64 ns);.void _sq
13660 6c 69 74 65 5f 61 75 74 6f 5f 74 72 61 63 65 28 lite_auto_trace(
13670 76 6f 69 64 20 2a 61 75 78 2c 20 63 6f 6e 73 74 void *aux, const
13680 20 63 68 61 72 20 2a 73 71 6c 29 3b 0a 76 6f 69 char *sql);.voi
13690 64 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f 70 d _sqlite_auto_p
136a0 72 6f 66 69 6c 65 28 76 6f 69 64 20 2a 61 75 78 rofile(void *aux
136b0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 , const char *sq
136c0 6c 2c 20 75 36 34 20 6e 73 29 20 7b 0a 23 70 72 l, u64 ns) {.#pr
136d0 61 67 6d 61 20 75 6e 75 73 65 64 28 61 75 78 29 agma unused(aux)
136e0 0a 09 66 70 72 69 6e 74 66 28 73 74 64 65 72 72 ..fprintf(stderr
136f0 2c 20 22 51 75 65 72 79 3a 20 25 73 5c 6e 20 45 , "Query: %s\n E
13700 78 65 63 75 74 69 6f 6e 20 54 69 6d 65 3a 20 25 xecution Time: %
13710 6c 6c 75 20 6d 73 5c 6e 22 2c 20 73 71 6c 2c 20 llu ms\n", sql,
13720 6e 73 20 2f 20 31 30 30 30 30 30 30 29 3b 0a 7d ns / 1000000);.}
13730 0a 76 6f 69 64 20 5f 73 71 6c 69 74 65 5f 61 75 .void _sqlite_au
13740 74 6f 5f 74 72 61 63 65 28 76 6f 69 64 20 2a 61 to_trace(void *a
13750 75 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ux, const char *
13760 73 71 6c 29 20 7b 0a 09 66 70 72 69 6e 74 66 28 sql) {..fprintf(
13770 73 74 64 65 72 72 2c 20 22 54 72 61 63 65 53 51 stderr, "TraceSQ
13780 4c 28 25 70 29 3a 20 25 73 5c 6e 22 2c 20 61 75 L(%p): %s\n", au
13790 78 2c 20 73 71 6c 29 3b 0a 7d 0a 0a 2f 2a 20 73 x, sql);.}../* s
137a0 79 73 6c 6f 67 20 6c 6f 67 67 69 6e 67 20 2a 2f yslog logging */
137b0 0a 23 69 6e 63 6c 75 64 65 20 3c 61 73 6c 2e 68 .#include <asl.h
137c0 3e 0a 73 74 61 74 69 63 20 61 73 6c 63 6c 69 65 >.static aslclie
137d0 6e 74 20 61 75 74 6f 6c 6f 67 5f 63 6c 69 65 6e nt autolog_clien
137e0 74 20 3d 20 4e 55 4c 4c 3b 0a 73 74 61 74 69 63 t = NULL;.static
137f0 20 76 6f 69 64 20 5f 63 6c 6f 73 65 5f 61 73 6c void _close_asl
13800 5f 6c 6f 67 28 29 20 7b 0a 20 20 69 66 28 20 4e _log() {. if( N
13810 55 4c 4c 21 3d 61 75 74 6f 6c 6f 67 5f 63 6c 69 ULL!=autolog_cli
13820 65 6e 74 20 29 7b 0a 20 20 20 20 61 73 6c 5f 63 ent ){. asl_c
13830 6c 6f 73 65 28 61 75 74 6f 6c 6f 67 5f 63 6c 69 lose(autolog_cli
13840 65 6e 74 29 3b 0a 20 20 20 20 61 75 74 6f 6c 6f ent);. autolo
13850 67 5f 63 6c 69 65 6e 74 20 3d 20 4e 55 4c 4c 3b g_client = NULL;
13860 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f . }.}.static vo
13870 69 64 20 5f 6f 70 65 6e 5f 61 73 6c 5f 6c 6f 67 id _open_asl_log
13880 28 29 20 7b 0a 20 20 69 66 28 20 4e 55 4c 4c 3d () {. if( NULL=
13890 3d 61 75 74 6f 6c 6f 67 5f 63 6c 69 65 6e 74 20 =autolog_client
138a0 29 7b 0a 20 20 20 20 61 75 74 6f 6c 6f 67 5f 63 ){. autolog_c
138b0 6c 69 65 6e 74 20 3d 20 61 73 6c 5f 6f 70 65 6e lient = asl_open
138c0 28 22 53 51 4c 69 74 65 22 2c 20 4e 55 4c 4c 2c ("SQLite", NULL,
138d0 20 30 29 3b 0a 20 20 20 20 61 74 65 78 69 74 28 0);. atexit(
138e0 5f 63 6c 6f 73 65 5f 61 73 6c 5f 6c 6f 67 29 3b _close_asl_log);
138f0 0a 20 20 7d 0a 7d 0a 0a 76 6f 69 64 20 5f 73 71 . }.}..void _sq
13900 6c 69 74 65 5f 61 75 74 6f 5f 70 72 6f 66 69 6c lite_auto_profil
13910 65 5f 73 79 73 6c 6f 67 28 76 6f 69 64 20 2a 61 e_syslog(void *a
13920 75 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ux, const char *
13930 73 71 6c 2c 20 75 36 34 20 6e 73 29 3b 0a 76 6f sql, u64 ns);.vo
13940 69 64 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f id _sqlite_auto_
13950 74 72 61 63 65 5f 73 79 73 6c 6f 67 28 76 6f 69 trace_syslog(voi
13960 64 20 2a 61 75 78 2c 20 63 6f 6e 73 74 20 63 68 d *aux, const ch
13970 61 72 20 2a 73 71 6c 29 3b 0a 76 6f 69 64 20 5f ar *sql);.void _
13980 73 71 6c 69 74 65 5f 61 75 74 6f 5f 70 72 6f 66 sqlite_auto_prof
13990 69 6c 65 5f 73 79 73 6c 6f 67 28 76 6f 69 64 20 ile_syslog(void
139a0 2a 61 75 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 *aux, const char
139b0 20 2a 73 71 6c 2c 20 75 36 34 20 6e 73 29 20 7b *sql, u64 ns) {
139c0 0a 23 70 72 61 67 6d 61 20 75 6e 75 73 65 64 28 .#pragma unused(
139d0 61 75 78 29 0a 09 61 73 6c 5f 6c 6f 67 28 61 75 aux)..asl_log(au
139e0 74 6f 6c 6f 67 5f 63 6c 69 65 6e 74 2c 20 4e 55 tolog_client, NU
139f0 4c 4c 2c 20 41 53 4c 5f 4c 45 56 45 4c 5f 4e 4f LL, ASL_LEVEL_NO
13a00 54 49 43 45 2c 20 22 51 75 65 72 79 3a 20 25 73 TICE, "Query: %s
13a10 5c 6e 20 45 78 65 63 75 74 69 6f 6e 20 54 69 6d \n Execution Tim
13a20 65 3a 20 25 6c 6c 75 20 6d 73 5c 6e 22 2c 20 73 e: %llu ms\n", s
13a30 71 6c 2c 20 6e 73 20 2f 20 31 30 30 30 30 30 30 ql, ns / 1000000
13a40 29 3b 0a 7d 0a 76 6f 69 64 20 5f 73 71 6c 69 74 );.}.void _sqlit
13a50 65 5f 61 75 74 6f 5f 74 72 61 63 65 5f 73 79 73 e_auto_trace_sys
13a60 6c 6f 67 28 76 6f 69 64 20 2a 61 75 78 2c 20 63 log(void *aux, c
13a70 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 29 20 onst char *sql)
13a80 7b 0a 09 61 73 6c 5f 6c 6f 67 28 61 75 74 6f 6c {..asl_log(autol
13a90 6f 67 5f 63 6c 69 65 6e 74 2c 20 4e 55 4c 4c 2c og_client, NULL,
13aa0 20 41 53 4c 5f 4c 45 56 45 4c 5f 4e 4f 54 49 43 ASL_LEVEL_NOTIC
13ab0 45 2c 20 22 54 72 61 63 65 53 51 4c 28 25 70 29 E, "TraceSQL(%p)
13ac0 3a 20 25 73 5c 6e 22 2c 20 61 75 78 2c 20 73 71 : %s\n", aux, sq
13ad0 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a l);.}.#endif../*
13ae0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
13af0 6e 20 69 73 20 75 73 65 64 20 74 6f 20 70 61 72 n is used to par
13b00 73 65 20 62 6f 74 68 20 55 52 49 73 20 61 6e 64 se both URIs and
13b10 20 6e 6f 6e 2d 55 52 49 20 66 69 6c 65 6e 61 6d non-URI filenam
13b20 65 73 20 70 61 73 73 65 64 20 62 79 20 74 68 65 es passed by the
13b30 0a 2a 2a 20 75 73 65 72 20 74 6f 20 41 50 49 20 .** user to API
13b40 66 75 6e 63 74 69 6f 6e 73 20 73 71 6c 69 74 65 functions sqlite
13b50 33 5f 6f 70 65 6e 28 29 20 6f 72 20 73 71 6c 69 3_open() or sqli
13b60 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 2c 20 61 te3_open_v2(), a
13b70 6e 64 20 66 6f 72 20 64 61 74 61 62 61 73 65 0a nd for database.
13b80 2a 2a 20 55 52 49 73 20 73 70 65 63 69 66 69 65 ** URIs specifie
13b90 64 20 61 73 20 70 61 72 74 20 6f 66 20 41 54 54 d as part of ATT
13ba0 41 43 48 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a ACH statements..
13bb0 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 **.** The first
13bc0 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 argument to this
13bd0 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 74 68 65 function is the
13be0 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 56 46 53 name of the VFS
13bf0 20 74 6f 20 75 73 65 20 28 6f 72 0a 2a 2a 20 61 to use (or.** a
13c00 20 4e 55 4c 4c 20 74 6f 20 73 69 67 6e 69 66 79 NULL to signify
13c10 20 74 68 65 20 64 65 66 61 75 6c 74 20 56 46 53 the default VFS
13c20 29 20 69 66 20 74 68 65 20 55 52 49 20 64 6f 65 ) if the URI doe
13c30 73 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 61 20 s not contain a
13c40 22 76 66 73 3d 78 78 78 22 0a 2a 2a 20 71 75 65 "vfs=xxx".** que
13c50 72 79 20 70 61 72 61 6d 65 74 65 72 2e 20 54 68 ry parameter. Th
13c60 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
13c70 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 55 t contains the U
13c80 52 49 20 28 6f 72 20 6e 6f 6e 2d 55 52 49 20 66 RI (or non-URI f
13c90 69 6c 65 6e 61 6d 65 29 0a 2a 2a 20 69 74 73 65 ilename).** itse
13ca0 6c 66 2e 20 57 68 65 6e 20 74 68 69 73 20 66 75 lf. When this fu
13cb0 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
13cc0 20 74 68 65 20 2a 70 46 6c 61 67 73 20 76 61 72 the *pFlags var
13cd0 69 61 62 6c 65 20 73 68 6f 75 6c 64 20 63 6f 6e iable should con
13ce0 74 61 69 6e 0a 2a 2a 20 74 68 65 20 64 65 66 61 tain.** the defa
13cf0 75 6c 74 20 66 6c 61 67 73 20 74 6f 20 6f 70 65 ult flags to ope
13d00 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 n the database h
13d10 61 6e 64 6c 65 20 77 69 74 68 2e 20 54 68 65 20 andle with. The
13d20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 0a value stored in.
13d30 2a 2a 20 2a 70 46 6c 61 67 73 20 6d 61 79 20 62 ** *pFlags may b
13d40 65 20 75 70 64 61 74 65 64 20 62 65 66 6f 72 65 e updated before
13d50 20 72 65 74 75 72 6e 69 6e 67 20 69 66 20 74 68 returning if th
13d60 65 20 55 52 49 20 66 69 6c 65 6e 61 6d 65 20 63 e URI filename c
13d70 6f 6e 74 61 69 6e 73 20 0a 2a 2a 20 22 63 61 63 ontains .** "cac
13d80 68 65 3d 78 78 78 22 20 6f 72 20 22 6d 6f 64 65 he=xxx" or "mode
13d90 3d 78 78 78 22 20 71 75 65 72 79 20 70 61 72 61 =xxx" query para
13da0 6d 65 74 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 meters..**.** If
13db0 20 73 75 63 63 65 73 73 66 75 6c 2c 20 53 51 4c successful, SQL
13dc0 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
13dd0 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ed. In this case
13de0 20 2a 70 70 56 66 73 20 69 73 20 73 65 74 20 74 *ppVfs is set t
13df0 6f 20 70 6f 69 6e 74 20 74 6f 0a 2a 2a 20 74 68 o point to.** th
13e00 65 20 56 46 53 20 74 68 61 74 20 73 68 6f 75 6c e VFS that shoul
13e10 64 20 62 65 20 75 73 65 64 20 74 6f 20 6f 70 65 d be used to ope
13e20 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
13e30 69 6c 65 2e 20 2a 70 7a 46 69 6c 65 20 69 73 20 ile. *pzFile is
13e40 73 65 74 20 74 6f 0a 2a 2a 20 70 6f 69 6e 74 20 set to.** point
13e50 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f 6e 74 to a buffer cont
13e60 61 69 6e 69 6e 67 20 74 68 65 20 6e 61 6d 65 20 aining the name
13e70 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f 20 6f of the file to o
13e80 70 65 6e 2e 20 49 74 20 69 73 20 74 68 65 20 0a pen. It is the .
13e90 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 ** responsibilit
13ea0 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
13eb0 74 6f 20 65 76 65 6e 74 75 61 6c 6c 79 20 63 61 to eventually ca
13ec0 6c 6c 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 ll sqlite3_free(
13ed0 29 20 74 6f 20 72 65 6c 65 61 73 65 0a 2a 2a 20 ) to release.**
13ee0 74 68 69 73 20 62 75 66 66 65 72 2e 0a 2a 2a 0a this buffer..**.
13ef0 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f ** If an error o
13f00 63 63 75 72 73 2c 20 74 68 65 6e 20 61 6e 20 53 ccurs, then an S
13f10 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 QLite error code
13f20 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 is returned and
13f30 20 2a 70 7a 45 72 72 4d 73 67 0a 2a 2a 20 6d 61 *pzErrMsg.** ma
13f40 79 20 62 65 20 73 65 74 20 74 6f 20 70 6f 69 6e y be set to poin
13f50 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f t to a buffer co
13f60 6e 74 61 69 6e 69 6e 67 20 61 6e 20 45 6e 67 6c ntaining an Engl
13f70 69 73 68 20 6c 61 6e 67 75 61 67 65 20 65 72 72 ish language err
13f80 6f 72 20 0a 2a 2a 20 6d 65 73 73 61 67 65 2e 20 or .** message.
13f90 49 74 20 69 73 20 74 68 65 20 72 65 73 70 6f 6e It is the respon
13fa0 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 sibility of the
13fb0 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 caller to eventu
13fc0 61 6c 6c 79 20 72 65 6c 65 61 73 65 0a 2a 2a 20 ally release.**
13fd0 74 68 69 73 20 62 75 66 66 65 72 20 62 79 20 63 this buffer by c
13fe0 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 5f 66 alling sqlite3_f
13ff0 72 65 65 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ree()..*/.int sq
14000 6c 69 74 65 33 50 61 72 73 65 55 72 69 28 0a 20 lite3ParseUri(.
14010 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 65 const char *zDe
14020 66 61 75 6c 74 56 66 73 2c 20 20 20 20 20 20 20 faultVfs,
14030 20 2f 2a 20 56 46 53 20 74 6f 20 75 73 65 20 69 /* VFS to use i
14040 66 20 6e 6f 20 22 76 66 73 3d 78 78 78 22 20 71 f no "vfs=xxx" q
14050 75 65 72 79 20 6f 70 74 69 6f 6e 20 2a 2f 0a 20 uery option */.
14060 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 55 72 const char *zUr
14070 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 i,
14080 20 2f 2a 20 4e 75 6c 2d 74 65 72 6d 69 6e 61 74 /* Nul-terminat
14090 65 64 20 55 52 49 20 74 6f 20 70 61 72 73 65 20 ed URI to parse
140a0 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e */. unsigned in
140b0 74 20 2a 70 46 6c 61 67 73 2c 20 20 20 20 20 20 t *pFlags,
140c0 20 20 20 20 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20 /* IN/OUT:
140d0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 58 58 58 20 SQLITE_OPEN_XXX
140e0 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 flags */. sqlit
140f0 65 33 5f 76 66 73 20 2a 2a 70 70 56 66 73 2c 20 e3_vfs **ppVfs,
14100 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
14110 54 3a 20 56 46 53 20 74 6f 20 75 73 65 20 2a 2f T: VFS to use */
14120 20 0a 20 20 63 68 61 72 20 2a 2a 70 7a 46 69 6c . char **pzFil
14130 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
14140 20 20 20 20 2f 2a 20 4f 55 54 3a 20 46 69 6c 65 /* OUT: File
14150 6e 61 6d 65 20 63 6f 6d 70 6f 6e 65 6e 74 20 6f name component o
14160 66 20 55 52 49 20 2a 2f 0a 20 20 63 68 61 72 20 f URI */. char
14170 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 **pzErrMsg
14180 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
14190 54 3a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 T: Error message
141a0 20 28 69 66 20 72 63 21 3d 53 51 4c 49 54 45 5f (if rc!=SQLITE_
141b0 4f 4b 29 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 OK) */.){. int
141c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
141d0 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 66 unsigned int f
141e0 6c 61 67 73 20 3d 20 2a 70 46 6c 61 67 73 3b 0a lags = *pFlags;.
141f0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 const char *zV
14200 66 73 20 3d 20 7a 44 65 66 61 75 6c 74 56 66 73 fs = zDefaultVfs
14210 3b 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c 65 3b ;. char *zFile;
14220 0a 20 20 63 68 61 72 20 63 3b 0a 20 20 69 6e 74 . char c;. int
14230 20 6e 55 72 69 20 3d 20 73 71 6c 69 74 65 33 53 nUri = sqlite3S
14240 74 72 6c 65 6e 33 30 28 7a 55 72 69 29 3b 0a 0a trlen30(zUri);..
14250 20 20 61 73 73 65 72 74 28 20 2a 70 7a 45 72 72 assert( *pzErr
14260 4d 73 67 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 Msg==0 );.. if(
14270 20 28 28 66 6c 61 67 73 20 26 20 53 51 4c 49 54 ((flags & SQLIT
14280 45 5f 4f 50 45 4e 5f 55 52 49 29 20 20 20 20 20 E_OPEN_URI)
14290 20 20 20 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 /* IMP:
142a0 52 2d 34 38 37 32 35 2d 33 32 32 30 36 20 2a 2f R-48725-32206 */
142b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 . ||
142c0 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
142d0 66 69 67 2e 62 4f 70 65 6e 55 72 69 29 20 2f 2a fig.bOpenUri) /*
142e0 20 49 4d 50 3a 20 52 2d 35 31 36 38 39 2d 34 36 IMP: R-51689-46
142f0 35 34 38 20 2a 2f 0a 20 20 20 26 26 20 6e 55 72 548 */. && nUr
14300 69 3e 3d 35 20 26 26 20 6d 65 6d 63 6d 70 28 7a i>=5 && memcmp(z
14310 55 72 69 2c 20 22 66 69 6c 65 3a 22 2c 20 35 29 Uri, "file:", 5)
14320 3d 3d 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 37 ==0 /* IMP: R-57
14330 38 38 34 2d 33 37 34 39 36 20 2a 2f 0a 20 20 29 884-37496 */. )
14340 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4f 70 74 {. char *zOpt
14350 3b 0a 20 20 20 20 69 6e 74 20 65 53 74 61 74 65 ;. int eState
14360 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
14370 20 20 20 20 2f 2a 20 50 61 72 73 65 72 20 73 74 /* Parser st
14380 61 74 65 20 77 68 65 6e 20 70 61 72 73 69 6e 67 ate when parsing
14390 20 55 52 49 20 2a 2f 0a 20 20 20 20 69 6e 74 20 URI */. int
143a0 69 49 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 iIn;
143b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 70 /* Inp
143c0 75 74 20 63 68 61 72 61 63 74 65 72 20 69 6e 64 ut character ind
143d0 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4f ex */. int iO
143e0 75 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 ut = 0;
143f0 20 20 20 20 20 20 20 20 2f 2a 20 4f 75 74 70 75 /* Outpu
14400 74 20 63 68 61 72 61 63 74 65 72 20 69 6e 64 65 t character inde
14410 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 42 79 x */. int nBy
14420 74 65 20 3d 20 6e 55 72 69 2b 32 3b 20 20 20 20 te = nUri+2;
14430 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 /* Bytes
14440 6f 66 20 73 70 61 63 65 20 74 6f 20 61 6c 6c 6f of space to allo
14450 63 61 74 65 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 cate */.. /*
14460 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 53 51 Make sure the SQ
14470 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 20 66 6c LITE_OPEN_URI fl
14480 61 67 20 69 73 20 73 65 74 20 74 6f 20 69 6e 64 ag is set to ind
14490 69 63 61 74 65 20 74 6f 20 74 68 65 20 56 46 53 icate to the VFS
144a0 20 78 4f 70 65 6e 20 0a 20 20 20 20 2a 2a 20 6d xOpen . ** m
144b0 65 74 68 6f 64 20 74 68 61 74 20 74 68 65 72 65 ethod that there
144c0 20 6d 61 79 20 62 65 20 65 78 74 72 61 20 70 61 may be extra pa
144d0 72 61 6d 65 74 65 72 73 20 66 6f 6c 6c 6f 77 69 rameters followi
144e0 6e 67 20 74 68 65 20 66 69 6c 65 2d 6e 61 6d 65 ng the file-name
144f0 2e 20 20 2a 2f 0a 20 20 20 20 66 6c 61 67 73 20 . */. flags
14500 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 |= SQLITE_OPEN_U
14510 52 49 3b 0a 0a 20 20 20 20 66 6f 72 28 69 49 6e RI;.. for(iIn
14520 3d 30 3b 20 69 49 6e 3c 6e 55 72 69 3b 20 69 49 =0; iIn<nUri; iI
14530 6e 2b 2b 29 20 6e 42 79 74 65 20 2b 3d 20 28 7a n++) nByte += (z
14540 55 72 69 5b 69 49 6e 5d 3d 3d 27 26 27 29 3b 0a Uri[iIn]=='&');.
14550 20 20 20 20 7a 46 69 6c 65 20 3d 20 73 71 6c 69 zFile = sqli
14560 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e 42 79 74 65 te3_malloc(nByte
14570 29 3b 0a 20 20 20 20 69 66 28 20 21 7a 46 69 6c );. if( !zFil
14580 65 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 e ) return SQLIT
14590 45 5f 4e 4f 4d 45 4d 3b 0a 0a 20 20 20 20 69 49 E_NOMEM;.. iI
145a0 6e 20 3d 20 35 3b 0a 23 69 66 64 65 66 20 53 51 n = 5;.#ifdef SQ
145b0 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 LITE_ALLOW_URI_A
145c0 55 54 48 4f 52 49 54 59 0a 20 20 20 20 69 66 28 UTHORITY. if(
145d0 20 73 74 72 6e 63 6d 70 28 7a 55 72 69 2b 35 2c strncmp(zUri+5,
145e0 20 22 2f 2f 2f 22 2c 20 33 29 3d 3d 30 20 29 7b "///", 3)==0 ){
145f0 0a 20 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a . iIn = 7;.
14600 20 20 20 20 20 20 2f 2a 20 54 68 65 20 66 6f 6c /* The fol
14610 6c 6f 77 69 6e 67 20 63 6f 6e 64 69 74 69 6f 6e lowing condition
14620 20 63 61 75 73 65 73 20 55 52 49 73 20 77 69 74 causes URIs wit
14630 68 20 66 69 76 65 20 6c 65 61 64 69 6e 67 20 2f h five leading /
14640 20 63 68 61 72 61 63 74 65 72 73 0a 20 20 20 20 characters.
14650 20 20 2a 2a 20 6c 69 6b 65 20 66 69 6c 65 3a 2f ** like file:/
14660 2f 2f 2f 2f 68 6f 73 74 2f 70 61 74 68 20 74 6f ////host/path to
14670 20 62 65 20 63 6f 6e 76 65 72 74 65 64 20 69 6e be converted in
14680 74 6f 20 55 4e 43 73 20 6c 69 6b 65 20 2f 2f 68 to UNCs like //h
14690 6f 73 74 2f 70 61 74 68 2e 0a 20 20 20 20 20 20 ost/path..
146a0 2a 2a 20 54 68 65 20 63 6f 72 72 65 63 74 20 55 ** The correct U
146b0 52 49 20 66 6f 72 20 74 68 61 74 20 55 4e 43 20 RI for that UNC
146c0 68 61 73 20 6f 6e 6c 79 20 74 77 6f 20 6f 72 20 has only two or
146d0 66 6f 75 72 20 6c 65 61 64 69 6e 67 20 2f 20 63 four leading / c
146e0 68 61 72 61 63 74 65 72 73 0a 20 20 20 20 20 20 haracters.
146f0 2a 2a 20 66 69 6c 65 3a 2f 2f 68 6f 73 74 2f 70 ** file://host/p
14700 61 74 68 20 6f 72 20 66 69 6c 65 3a 2f 2f 2f 2f ath or file:////
14710 68 6f 73 74 2f 70 61 74 68 2e 20 20 42 75 74 20 host/path. But
14720 35 20 6c 65 61 64 69 6e 67 20 73 6c 61 73 68 65 5 leading slashe
14730 73 20 69 73 20 61 20 0a 20 20 20 20 20 20 2a 2a s is a . **
14740 20 63 6f 6d 6d 6f 6e 20 65 72 72 6f 72 2c 20 77 common error, w
14750 65 20 61 72 65 20 74 6f 6c 64 2c 20 73 6f 20 77 e are told, so w
14760 65 20 68 61 6e 64 6c 65 20 69 74 20 61 73 20 61 e handle it as a
14770 20 73 70 65 63 69 61 6c 20 63 61 73 65 2e 20 2a special case. *
14780 2f 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 6e /. if( strn
14790 63 6d 70 28 7a 55 72 69 2b 37 2c 20 22 2f 2f 2f cmp(zUri+7, "///
147a0 22 2c 20 33 29 3d 3d 30 20 29 7b 20 69 49 6e 2b ", 3)==0 ){ iIn+
147b0 2b 3b 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 +; }. }else i
147c0 66 28 20 73 74 72 6e 63 6d 70 28 7a 55 72 69 2b f( strncmp(zUri+
147d0 35 2c 20 22 2f 2f 6c 6f 63 61 6c 68 6f 73 74 2f 5, "//localhost/
147e0 22 2c 20 31 32 29 3d 3d 30 20 29 7b 0a 20 20 20 ", 12)==0 ){.
147f0 20 20 20 69 49 6e 20 3d 20 31 36 3b 0a 20 20 20 iIn = 16;.
14800 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 2f 2a 20 }.#else. /*
14810 44 69 73 63 61 72 64 20 74 68 65 20 73 63 68 65 Discard the sche
14820 6d 65 20 61 6e 64 20 61 75 74 68 6f 72 69 74 79 me and authority
14830 20 73 65 67 6d 65 6e 74 73 20 6f 66 20 74 68 65 segments of the
14840 20 55 52 49 2e 20 2a 2f 0a 20 20 20 20 69 66 28 URI. */. if(
14850 20 7a 55 72 69 5b 35 5d 3d 3d 27 2f 27 20 26 26 zUri[5]=='/' &&
14860 20 7a 55 72 69 5b 36 5d 3d 3d 27 2f 27 20 29 7b zUri[6]=='/' ){
14870 0a 20 20 20 20 20 20 69 49 6e 20 3d 20 37 3b 0a . iIn = 7;.
14880 20 20 20 20 20 20 77 68 69 6c 65 28 20 7a 55 72 while( zUr
14890 69 5b 69 49 6e 5d 20 26 26 20 7a 55 72 69 5b 69 i[iIn] && zUri[i
148a0 49 6e 5d 21 3d 27 2f 27 20 29 20 69 49 6e 2b 2b In]!='/' ) iIn++
148b0 3b 0a 20 20 20 20 20 20 69 66 28 20 69 49 6e 21 ;. if( iIn!
148c0 3d 37 20 26 26 20 28 69 49 6e 21 3d 31 36 20 7c =7 && (iIn!=16 |
148d0 7c 20 6d 65 6d 63 6d 70 28 22 6c 6f 63 61 6c 68 | memcmp("localh
148e0 6f 73 74 22 2c 20 26 7a 55 72 69 5b 37 5d 2c 20 ost", &zUri[7],
148f0 39 29 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 9)) ){. *
14900 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 pzErrMsg = sqlit
14910 65 33 5f 6d 70 72 69 6e 74 66 28 22 69 6e 76 61 e3_mprintf("inva
14920 6c 69 64 20 75 72 69 20 61 75 74 68 6f 72 69 74 lid uri authorit
14930 79 3a 20 25 2e 2a 73 22 2c 20 0a 20 20 20 20 20 y: %.*s", .
14940 20 20 20 20 20 20 20 69 49 6e 2d 37 2c 20 26 7a iIn-7, &z
14950 55 72 69 5b 37 5d 29 3b 0a 20 20 20 20 20 20 20 Uri[7]);.
14960 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 rc = SQLITE_ERR
14970 4f 52 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f OR;. goto
14980 20 70 61 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a parse_uri_out;.
14990 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 23 65 }. }.#e
149a0 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 ndif.. /* Cop
149b0 79 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 y the filename a
149c0 6e 64 20 61 6e 79 20 71 75 65 72 79 20 70 61 72 nd any query par
149d0 61 6d 65 74 65 72 73 20 69 6e 74 6f 20 74 68 65 ameters into the
149e0 20 7a 46 69 6c 65 20 62 75 66 66 65 72 2e 20 0a zFile buffer. .
149f0 20 20 20 20 2a 2a 20 44 65 63 6f 64 65 20 25 48 ** Decode %H
14a00 48 20 65 73 63 61 70 65 20 63 6f 64 65 73 20 61 H escape codes a
14a10 6c 6f 6e 67 20 74 68 65 20 77 61 79 2e 20 0a 20 long the way. .
14a20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 57 69 74 **. ** Wit
14a30 68 69 6e 20 74 68 69 73 20 6c 6f 6f 70 2c 20 76 hin this loop, v
14a40 61 72 69 61 62 6c 65 20 65 53 74 61 74 65 20 6d ariable eState m
14a50 61 79 20 62 65 20 73 65 74 20 74 6f 20 30 2c 20 ay be set to 0,
14a60 31 20 6f 72 20 32 2c 20 64 65 70 65 6e 64 69 6e 1 or 2, dependin
14a70 67 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 g. ** on the
14a80 70 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e parsing context.
14a90 20 41 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 20 As follows:.
14aa0 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 30 3a 20 **. ** 0:
14ab0 50 61 72 73 69 6e 67 20 66 69 6c 65 2d 6e 61 6d Parsing file-nam
14ac0 65 2e 0a 20 20 20 20 2a 2a 20 20 20 31 3a 20 50 e.. ** 1: P
14ad0 61 72 73 69 6e 67 20 6e 61 6d 65 20 73 65 63 74 arsing name sect
14ae0 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 3d 76 61 ion of a name=va
14af0 6c 75 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 lue query parame
14b00 74 65 72 2e 0a 20 20 20 20 2a 2a 20 20 20 32 3a ter.. ** 2:
14b10 20 50 61 72 73 69 6e 67 20 76 61 6c 75 65 20 73 Parsing value s
14b20 65 63 74 69 6f 6e 20 6f 66 20 61 20 6e 61 6d 65 ection of a name
14b30 3d 76 61 6c 75 65 20 71 75 65 72 79 20 70 61 72 =value query par
14b40 61 6d 65 74 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 ameter.. */.
14b50 20 20 20 65 53 74 61 74 65 20 3d 20 30 3b 0a 20 eState = 0;.
14b60 20 20 20 77 68 69 6c 65 28 20 28 63 20 3d 20 7a while( (c = z
14b70 55 72 69 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 Uri[iIn])!=0 &&
14b80 63 21 3d 27 23 27 20 29 7b 0a 20 20 20 20 20 20 c!='#' ){.
14b90 69 49 6e 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 iIn++;. if(
14ba0 20 63 3d 3d 27 25 27 20 0a 20 20 20 20 20 20 20 c=='%' .
14bb0 26 26 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 && sqlite3Isxdig
14bc0 69 74 28 7a 55 72 69 5b 69 49 6e 5d 29 20 0a 20 it(zUri[iIn]) .
14bd0 20 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 && sqlite3
14be0 49 73 78 64 69 67 69 74 28 7a 55 72 69 5b 69 49 Isxdigit(zUri[iI
14bf0 6e 2b 31 5d 29 20 0a 20 20 20 20 20 20 29 7b 0a n+1]) . ){.
14c00 20 20 20 20 20 20 20 20 69 6e 74 20 6f 63 74 65 int octe
14c10 74 20 3d 20 28 73 71 6c 69 74 65 33 48 65 78 54 t = (sqlite3HexT
14c20 6f 49 6e 74 28 7a 55 72 69 5b 69 49 6e 2b 2b 5d oInt(zUri[iIn++]
14c30 29 20 3c 3c 20 34 29 3b 0a 20 20 20 20 20 20 20 ) << 4);.
14c40 20 6f 63 74 65 74 20 2b 3d 20 73 71 6c 69 74 65 octet += sqlite
14c50 33 48 65 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 3HexToInt(zUri[i
14c60 49 6e 2b 2b 5d 29 3b 0a 0a 20 20 20 20 20 20 20 In++]);..
14c70 20 61 73 73 65 72 74 28 20 6f 63 74 65 74 3e 3d assert( octet>=
14c80 30 20 26 26 20 6f 63 74 65 74 3c 32 35 36 20 29 0 && octet<256 )
14c90 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6f 63 ;. if( oc
14ca0 74 65 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 tet==0 ){.
14cb0 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e /* This bran
14cc0 63 68 20 69 73 20 74 61 6b 65 6e 20 77 68 65 6e ch is taken when
14cd0 20 22 25 30 30 22 20 61 70 70 65 61 72 73 20 77 "%00" appears w
14ce0 69 74 68 69 6e 20 74 68 65 20 55 52 49 2e 20 49 ithin the URI. I
14cf0 6e 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 n this.
14d00 20 2a 2a 20 63 61 73 65 20 77 65 20 69 67 6e 6f ** case we igno
14d10 72 65 20 61 6c 6c 20 74 65 78 74 20 69 6e 20 74 re all text in t
14d20 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 he remainder of
14d30 74 68 65 20 70 61 74 68 2c 20 6e 61 6d 65 20 6f the path, name o
14d40 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 76 r. ** v
14d50 61 6c 75 65 20 63 75 72 72 65 6e 74 6c 79 20 62 alue currently b
14d60 65 69 6e 67 20 70 61 72 73 65 64 2e 20 53 6f 20 eing parsed. So
14d70 69 67 6e 6f 72 65 20 74 68 65 20 63 75 72 72 65 ignore the curre
14d80 6e 74 20 63 68 61 72 61 63 74 65 72 0a 20 20 20 nt character.
14d90 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 73 6b ** and sk
14da0 69 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 22 ip to the next "
14db0 3f 22 2c 20 22 3d 22 20 6f 72 20 22 26 22 2c 20 ?", "=" or "&",
14dc0 61 73 20 61 70 70 72 6f 70 72 69 61 74 65 2e 20 as appropriate.
14dd0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 */. whi
14de0 6c 65 28 20 28 63 20 3d 20 7a 55 72 69 5b 69 49 le( (c = zUri[iI
14df0 6e 5d 29 21 3d 30 20 26 26 20 63 21 3d 27 23 27 n])!=0 && c!='#'
14e00 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
14e10 26 26 20 28 65 53 74 61 74 65 21 3d 30 20 7c 7c && (eState!=0 ||
14e20 20 63 21 3d 27 3f 27 29 0a 20 20 20 20 20 20 20 c!='?').
14e30 20 20 20 20 20 20 20 26 26 20 28 65 53 74 61 74 && (eStat
14e40 65 21 3d 31 20 7c 7c 20 28 63 21 3d 27 3d 27 20 e!=1 || (c!='='
14e50 26 26 20 63 21 3d 27 26 27 29 29 0a 20 20 20 20 && c!='&')).
14e60 20 20 20 20 20 20 20 20 20 20 26 26 20 28 65 53 && (eS
14e70 74 61 74 65 21 3d 32 20 7c 7c 20 63 21 3d 27 26 tate!=2 || c!='&
14e80 27 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a '). ){.
14e90 20 20 20 20 20 20 20 20 20 20 20 20 69 49 6e 2b iIn+
14ea0 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 +;. }.
14eb0 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 continu
14ec0 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 e;. }.
14ed0 20 20 20 20 20 63 20 3d 20 6f 63 74 65 74 3b 0a c = octet;.
14ee0 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
14ef0 65 53 74 61 74 65 3d 3d 31 20 26 26 20 28 63 3d eState==1 && (c=
14f00 3d 27 26 27 20 7c 7c 20 63 3d 3d 27 3d 27 29 20 ='&' || c=='=')
14f10 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a ){. if( z
14f20 46 69 6c 65 5b 69 4f 75 74 2d 31 5d 3d 3d 30 20 File[iOut-1]==0
14f30 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ){. /*
14f40 41 6e 20 65 6d 70 74 79 20 6f 70 74 69 6f 6e 20 An empty option
14f50 6e 61 6d 65 2e 20 49 67 6e 6f 72 65 20 74 68 69 name. Ignore thi
14f60 73 20 6f 70 74 69 6f 6e 20 61 6c 74 6f 67 65 74 s option altoget
14f70 68 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 her. */.
14f80 20 20 77 68 69 6c 65 28 20 7a 55 72 69 5b 69 49 while( zUri[iI
14f90 6e 5d 20 26 26 20 7a 55 72 69 5b 69 49 6e 5d 21 n] && zUri[iIn]!
14fa0 3d 27 23 27 20 26 26 20 7a 55 72 69 5b 69 49 6e ='#' && zUri[iIn
14fb0 2d 31 5d 21 3d 27 26 27 20 29 20 69 49 6e 2b 2b -1]!='&' ) iIn++
14fc0 3b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 ;. cont
14fd0 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a inue;. }.
14fe0 20 20 20 20 20 20 20 20 69 66 28 20 63 3d 3d 27 if( c=='
14ff0 26 27 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 &' ){.
15000 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 zFile[iOut++] =
15010 27 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 7d 65 '\0';. }e
15020 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 65 lse{. e
15030 53 74 61 74 65 20 3d 20 32 3b 0a 20 20 20 20 20 State = 2;.
15040 20 20 20 7d 0a 20 20 20 20 20 20 20 20 63 20 3d }. c =
15050 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 0;. }else
15060 69 66 28 20 28 65 53 74 61 74 65 3d 3d 30 20 26 if( (eState==0 &
15070 26 20 63 3d 3d 27 3f 27 29 20 7c 7c 20 28 65 53 & c=='?') || (eS
15080 74 61 74 65 3d 3d 32 20 26 26 20 63 3d 3d 27 26 tate==2 && c=='&
15090 27 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63 20 ') ){. c
150a0 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 65 53 74 = 0;. eSt
150b0 61 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d ate = 1;. }
150c0 0a 20 20 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 . zFile[iOu
150d0 74 2b 2b 5d 20 3d 20 63 3b 0a 20 20 20 20 7d 0a t++] = c;. }.
150e0 20 20 20 20 69 66 28 20 65 53 74 61 74 65 3d 3d if( eState==
150f0 31 20 29 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 1 ) zFile[iOut++
15100 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 7a 46 ] = '\0';. zF
15110 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c ile[iOut++] = '\
15120 30 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 69 4f 0';. zFile[iO
15130 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 0a 20 ut++] = '\0';..
15140 20 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 74 /* Check if t
15150 68 65 72 65 20 77 65 72 65 20 61 6e 79 20 6f 70 here were any op
15160 74 69 6f 6e 73 20 73 70 65 63 69 66 69 65 64 20 tions specified
15170 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 69 that should be i
15180 6e 74 65 72 70 72 65 74 65 64 20 0a 20 20 20 20 nterpreted .
15190 2a 2a 20 68 65 72 65 2e 20 4f 70 74 69 6f 6e 73 ** here. Options
151a0 20 74 68 61 74 20 61 72 65 20 69 6e 74 65 72 70 that are interp
151b0 72 65 74 65 64 20 68 65 72 65 20 69 6e 63 6c 75 reted here inclu
151c0 64 65 20 22 76 66 73 22 20 61 6e 64 20 74 68 6f de "vfs" and tho
151d0 73 65 20 74 68 61 74 0a 20 20 20 20 2a 2a 20 63 se that. ** c
151e0 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 66 6c 61 orrespond to fla
151f0 67 73 20 74 68 61 74 20 6d 61 79 20 62 65 20 70 gs that may be p
15200 61 73 73 65 64 20 74 6f 20 74 68 65 20 73 71 6c assed to the sql
15210 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 0a 20 ite3_open_v2().
15220 20 20 20 2a 2a 20 6d 65 74 68 6f 64 2e 20 2a 2f ** method. */
15230 0a 20 20 20 20 7a 4f 70 74 20 3d 20 26 7a 46 69 . zOpt = &zFi
15240 6c 65 5b 73 71 6c 69 74 65 33 53 74 72 6c 65 6e le[sqlite3Strlen
15250 33 30 28 7a 46 69 6c 65 29 2b 31 5d 3b 0a 20 20 30(zFile)+1];.
15260 20 20 77 68 69 6c 65 28 20 7a 4f 70 74 5b 30 5d while( zOpt[0]
15270 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f ){. int nO
15280 70 74 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c pt = sqlite3Strl
15290 65 6e 33 30 28 7a 4f 70 74 29 3b 0a 20 20 20 20 en30(zOpt);.
152a0 20 20 63 68 61 72 20 2a 7a 56 61 6c 20 3d 20 26 char *zVal = &
152b0 7a 4f 70 74 5b 6e 4f 70 74 2b 31 5d 3b 0a 20 20 zOpt[nOpt+1];.
152c0 20 20 20 20 69 6e 74 20 6e 56 61 6c 20 3d 20 73 int nVal = s
152d0 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
152e0 56 61 6c 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 Val);.. if(
152f0 20 6e 4f 70 74 3d 3d 33 20 26 26 20 6d 65 6d 63 nOpt==3 && memc
15300 6d 70 28 22 76 66 73 22 2c 20 7a 4f 70 74 2c 20 mp("vfs", zOpt,
15310 33 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 3)==0 ){.
15320 20 7a 56 66 73 20 3d 20 7a 56 61 6c 3b 0a 20 20 zVfs = zVal;.
15330 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
15340 20 20 20 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f struct OpenMo
15350 64 65 20 7b 0a 20 20 20 20 20 20 20 20 20 20 63 de {. c
15360 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 onst char *z;.
15370 20 20 20 20 20 20 20 20 69 6e 74 20 6d 6f 64 65 int mode
15380 3b 0a 20 20 20 20 20 20 20 20 7d 20 2a 61 4d 6f ;. } *aMo
15390 64 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 de = 0;.
153a0 63 68 61 72 20 2a 7a 4d 6f 64 65 54 79 70 65 20 char *zModeType
153b0 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 = 0;. int
153c0 20 6d 61 73 6b 20 3d 20 30 3b 0a 20 20 20 20 20 mask = 0;.
153d0 20 20 20 69 6e 74 20 6c 69 6d 69 74 20 3d 20 30 int limit = 0
153e0 3b 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e ;.. if( n
153f0 4f 70 74 3d 3d 35 20 26 26 20 6d 65 6d 63 6d 70 Opt==5 && memcmp
15400 28 22 63 61 63 68 65 22 2c 20 7a 4f 70 74 2c 20 ("cache", zOpt,
15410 35 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 5)==0 ){.
15420 20 20 20 73 74 61 74 69 63 20 73 74 72 75 63 74 static struct
15430 20 4f 70 65 6e 4d 6f 64 65 20 61 43 61 63 68 65 OpenMode aCache
15440 4d 6f 64 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 Mode[] = {.
15450 20 20 20 20 20 20 20 7b 20 22 73 68 61 72 65 64 { "shared
15460 22 2c 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ", SQLITE_OPEN_
15470 53 48 41 52 45 44 43 41 43 48 45 20 7d 2c 0a 20 SHAREDCACHE },.
15480 20 20 20 20 20 20 20 20 20 20 20 7b 20 22 70 72 { "pr
15490 69 76 61 74 65 22 2c 20 53 51 4c 49 54 45 5f 4f ivate", SQLITE_O
154a0 50 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 45 PEN_PRIVATECACHE
154b0 20 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 },.
154c0 7b 20 30 2c 20 30 20 7d 0a 20 20 20 20 20 20 20 { 0, 0 }.
154d0 20 20 20 7d 3b 0a 0a 20 20 20 20 20 20 20 20 20 };..
154e0 20 6d 61 73 6b 20 3d 20 53 51 4c 49 54 45 5f 4f mask = SQLITE_O
154f0 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 7c PEN_SHAREDCACHE|
15500 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 SQLITE_OPEN_PRIV
15510 41 54 45 43 41 43 48 45 3b 0a 20 20 20 20 20 20 ATECACHE;.
15520 20 20 20 20 61 4d 6f 64 65 20 3d 20 61 43 61 63 aMode = aCac
15530 68 65 4d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 heMode;.
15540 20 20 6c 69 6d 69 74 20 3d 20 6d 61 73 6b 3b 0a limit = mask;.
15550 20 20 20 20 20 20 20 20 20 20 7a 4d 6f 64 65 54 zModeT
15560 79 70 65 20 3d 20 22 63 61 63 68 65 22 3b 0a 20 ype = "cache";.
15570 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
15580 20 69 66 28 20 6e 4f 70 74 3d 3d 34 20 26 26 20 if( nOpt==4 &&
15590 6d 65 6d 63 6d 70 28 22 6d 6f 64 65 22 2c 20 7a memcmp("mode", z
155a0 4f 70 74 2c 20 34 29 3d 3d 30 20 29 7b 0a 20 20 Opt, 4)==0 ){.
155b0 20 20 20 20 20 20 20 20 73 74 61 74 69 63 20 73 static s
155c0 74 72 75 63 74 20 4f 70 65 6e 4d 6f 64 65 20 61 truct OpenMode a
155d0 4f 70 65 6e 4d 6f 64 65 5b 5d 20 3d 20 7b 0a 20 OpenMode[] = {.
155e0 20 20 20 20 20 20 20 20 20 20 20 7b 20 22 72 6f { "ro
155f0 22 2c 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ", SQLITE_OPEN_
15600 52 45 41 44 4f 4e 4c 59 20 7d 2c 0a 20 20 20 20 READONLY },.
15610 20 20 20 20 20 20 20 20 7b 20 22 72 77 22 2c 20 { "rw",
15620 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
15630 44 57 52 49 54 45 20 7d 2c 20 0a 20 20 20 20 20 DWRITE }, .
15640 20 20 20 20 20 20 20 7b 20 22 72 77 63 22 2c 20 { "rwc",
15650 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
15660 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f WRITE | SQLITE_O
15670 50 45 4e 5f 43 52 45 41 54 45 20 7d 2c 0a 20 20 PEN_CREATE },.
15680 20 20 20 20 20 20 20 20 20 20 7b 20 22 6d 65 6d { "mem
15690 6f 72 79 22 2c 20 53 51 4c 49 54 45 5f 4f 50 45 ory", SQLITE_OPE
156a0 4e 5f 4d 45 4d 4f 52 59 20 7d 2c 0a 20 20 20 20 N_MEMORY },.
156b0 20 20 20 20 20 20 20 20 7b 20 30 2c 20 30 20 7d { 0, 0 }
156c0 0a 20 20 20 20 20 20 20 20 20 20 7d 3b 0a 0a 20 . };..
156d0 20 20 20 20 20 20 20 20 20 6d 61 73 6b 20 3d 20 mask =
156e0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
156f0 4f 4e 4c 59 20 7c 20 53 51 4c 49 54 45 5f 4f 50 ONLY | SQLITE_OP
15700 45 4e 5f 52 45 41 44 57 52 49 54 45 0a 20 20 20 EN_READWRITE.
15710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15720 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 | SQLITE_OPEN_CR
15730 45 41 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 EATE | SQLITE_OP
15740 45 4e 5f 4d 45 4d 4f 52 59 3b 0a 20 20 20 20 20 EN_MEMORY;.
15750 20 20 20 20 20 61 4d 6f 64 65 20 3d 20 61 4f 70 aMode = aOp
15760 65 6e 4d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 enMode;.
15770 20 20 6c 69 6d 69 74 20 3d 20 6d 61 73 6b 20 26 limit = mask &
15780 20 66 6c 61 67 73 3b 0a 20 20 20 20 20 20 20 20 flags;.
15790 20 20 7a 4d 6f 64 65 54 79 70 65 20 3d 20 22 61 zModeType = "a
157a0 63 63 65 73 73 22 3b 0a 20 20 20 20 20 20 20 20 ccess";.
157b0 7d 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 61 }.. if( a
157c0 4d 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 20 20 Mode ){.
157d0 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 int i;.
157e0 20 20 20 69 6e 74 20 6d 6f 64 65 20 3d 20 30 3b int mode = 0;
157f0 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 . for(i
15800 3d 30 3b 20 61 4d 6f 64 65 5b 69 5d 2e 7a 3b 20 =0; aMode[i].z;
15810 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 i++){.
15820 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 const char *z
15830 3d 20 61 4d 6f 64 65 5b 69 5d 2e 7a 3b 0a 20 20 = aMode[i].z;.
15840 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6e 56 if( nV
15850 61 6c 3d 3d 73 71 6c 69 74 65 33 53 74 72 6c 65 al==sqlite3Strle
15860 6e 33 30 28 7a 29 20 26 26 20 30 3d 3d 6d 65 6d n30(z) && 0==mem
15870 63 6d 70 28 7a 56 61 6c 2c 20 7a 2c 20 6e 56 61 cmp(zVal, z, nVa
15880 6c 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 l) ){.
15890 20 20 20 20 6d 6f 64 65 20 3d 20 61 4d 6f 64 65 mode = aMode
158a0 5b 69 5d 2e 6d 6f 64 65 3b 0a 20 20 20 20 20 20 [i].mode;.
158b0 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
158c0 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
158d0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
158e0 20 20 20 69 66 28 20 6d 6f 64 65 3d 3d 30 20 29 if( mode==0 )
158f0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 {. *p
15900 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 zErrMsg = sqlite
15910 33 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 20 73 75 3_mprintf("no su
15920 63 68 20 25 73 20 6d 6f 64 65 3a 20 25 73 22 2c ch %s mode: %s",
15930 20 7a 4d 6f 64 65 54 79 70 65 2c 20 7a 56 61 6c zModeType, zVal
15940 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
15950 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
15960 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f ;. go
15970 74 6f 20 70 61 72 73 65 5f 75 72 69 5f 6f 75 74 to parse_uri_out
15980 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
15990 20 20 20 20 20 20 20 20 69 66 28 20 28 6d 6f 64 if( (mod
159a0 65 20 26 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e e & ~SQLITE_OPEN
159b0 5f 4d 45 4d 4f 52 59 29 3e 6c 69 6d 69 74 20 29 _MEMORY)>limit )
159c0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 {. *p
159d0 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 zErrMsg = sqlite
159e0 33 5f 6d 70 72 69 6e 74 66 28 22 25 73 20 6d 6f 3_mprintf("%s mo
159f0 64 65 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 3a 20 de not allowed:
15a00 25 73 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 %s",.
15a10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15a20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a 4d 6f zMo
15a30 64 65 54 79 70 65 2c 20 7a 56 61 6c 29 3b 0a 20 deType, zVal);.
15a40 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
15a50 53 51 4c 49 54 45 5f 50 45 52 4d 3b 0a 20 20 20 SQLITE_PERM;.
15a60 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 goto pa
15a70 72 73 65 5f 75 72 69 5f 6f 75 74 3b 0a 20 20 20 rse_uri_out;.
15a80 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
15a90 20 20 20 66 6c 61 67 73 20 3d 20 28 66 6c 61 67 flags = (flag
15aa0 73 20 26 20 7e 6d 61 73 6b 29 20 7c 20 6d 6f 64 s & ~mask) | mod
15ab0 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 e;. }.
15ac0 20 20 20 7d 0a 0a 20 20 20 20 20 20 7a 4f 70 74 }.. zOpt
15ad0 20 3d 20 26 7a 56 61 6c 5b 6e 56 61 6c 2b 31 5d = &zVal[nVal+1]
15ae0 3b 0a 20 20 20 20 7d 0a 0a 20 20 7d 65 6c 73 65 ;. }.. }else
15af0 7b 0a 20 20 20 20 7a 46 69 6c 65 20 3d 20 73 71 {. zFile = sq
15b00 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e 55 72 lite3_malloc(nUr
15b10 69 2b 32 29 3b 0a 20 20 20 20 69 66 28 20 21 7a i+2);. if( !z
15b20 46 69 6c 65 20 29 20 72 65 74 75 72 6e 20 53 51 File ) return SQ
15b30 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
15b40 6d 65 6d 63 70 79 28 7a 46 69 6c 65 2c 20 7a 55 memcpy(zFile, zU
15b50 72 69 2c 20 6e 55 72 69 29 3b 0a 20 20 20 20 7a ri, nUri);. z
15b60 46 69 6c 65 5b 6e 55 72 69 5d 20 3d 20 27 5c 30 File[nUri] = '\0
15b70 27 3b 0a 20 20 20 20 7a 46 69 6c 65 5b 6e 55 72 ';. zFile[nUr
15b80 69 2b 31 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 i+1] = '\0';.
15b90 20 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 flags &= ~SQLIT
15ba0 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a 20 20 7d 0a E_OPEN_URI;. }.
15bb0 0a 20 20 2a 70 70 56 66 73 20 3d 20 73 71 6c 69 . *ppVfs = sqli
15bc0 74 65 33 5f 76 66 73 5f 66 69 6e 64 28 7a 56 66 te3_vfs_find(zVf
15bd0 73 29 3b 0a 20 20 69 66 28 20 2a 70 70 56 66 73 s);. if( *ppVfs
15be0 3d 3d 30 20 29 7b 0a 20 20 20 20 2a 70 7a 45 72 ==0 ){. *pzEr
15bf0 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d rMsg = sqlite3_m
15c00 70 72 69 6e 74 66 28 22 6e 6f 20 73 75 63 68 20 printf("no such
15c10 76 66 73 3a 20 25 73 22 2c 20 7a 56 66 73 29 3b vfs: %s", zVfs);
15c20 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
15c30 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 70 61 72 _ERROR;. }. par
15c40 73 65 5f 75 72 69 5f 6f 75 74 3a 0a 20 20 69 66 se_uri_out:. if
15c50 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
15c60 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 ){. sqlite3_f
15c70 72 65 65 28 7a 46 69 6c 65 29 3b 0a 20 20 20 20 ree(zFile);.
15c80 7a 46 69 6c 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 zFile = 0;. }.
15c90 20 2a 70 46 6c 61 67 73 20 3d 20 66 6c 61 67 73 *pFlags = flags
15ca0 3b 0a 20 20 2a 70 7a 46 69 6c 65 20 3d 20 7a 46 ;. *pzFile = zF
15cb0 69 6c 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ile;. return rc
15cc0 3b 0a 7d 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 ;.}..#if defined
15cd0 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 (SQLITE_ENABLE_A
15ce0 55 54 4f 5f 50 52 4f 46 49 4c 45 29 0a 23 64 65 UTO_PROFILE).#de
15cf0 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 55 54 4f fine SQLITE_AUTO
15d00 4c 4f 47 47 49 4e 47 5f 53 54 44 45 52 52 20 31 LOGGING_STDERR 1
15d10 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
15d20 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 59 53 4c AUTOLOGGING_SYSL
15d30 4f 47 20 32 0a 73 74 61 74 69 63 20 76 6f 69 64 OG 2.static void
15d40 20 65 6e 61 62 6c 65 41 75 74 6f 4c 6f 67 67 69 enableAutoLoggi
15d50 6e 67 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ng(. sqlite3 *d
15d60 62 0a 29 7b 0a 20 20 63 68 61 72 20 2a 65 6e 76 b.){. char *env
15d70 70 72 6f 66 69 6c 65 20 3d 20 67 65 74 65 6e 76 profile = getenv
15d80 28 22 53 51 4c 49 54 45 5f 41 55 54 4f 5f 50 52 ("SQLITE_AUTO_PR
15d90 4f 46 49 4c 45 22 29 3b 0a 20 20 0a 20 20 69 66 OFILE");. . if
15da0 28 20 65 6e 76 70 72 6f 66 69 6c 65 21 3d 4e 55 ( envprofile!=NU
15db0 4c 4c 20 29 7b 0a 20 20 20 20 69 6e 74 20 77 68 LL ){. int wh
15dc0 65 72 65 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 ere = 0;. if(
15dd0 20 21 73 74 72 6e 63 61 73 65 63 6d 70 28 22 31 !strncasecmp("1
15de0 22 2c 20 65 6e 76 70 72 6f 66 69 6c 65 2c 20 31 ", envprofile, 1
15df0 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 ) ){. if( i
15e00 73 61 74 74 79 28 32 29 20 29 7b 0a 20 20 20 20 satty(2) ){.
15e10 20 20 20 20 77 68 65 72 65 20 3d 20 53 51 4c 49 where = SQLI
15e20 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 TE_AUTOLOGGING_S
15e30 54 44 45 52 52 3b 0a 20 20 20 20 20 20 7d 65 6c TDERR;. }el
15e40 73 65 7b 0a 20 20 20 20 20 20 20 20 77 68 65 72 se{. wher
15e50 65 20 3d 20 53 51 4c 49 54 45 5f 41 55 54 4f 4c e = SQLITE_AUTOL
15e60 4f 47 47 49 4e 47 5f 53 59 53 4c 4f 47 3b 0a 20 OGGING_SYSLOG;.
15e70 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c 73 }. } els
15e80 65 20 69 66 28 20 21 73 74 72 6e 63 61 73 65 63 e if( !strncasec
15e90 6d 70 28 22 73 74 64 65 72 72 22 2c 20 65 6e 76 mp("stderr", env
15ea0 70 72 6f 66 69 6c 65 2c 20 36 29 20 29 7b 0a 20 profile, 6) ){.
15eb0 20 20 20 20 20 77 68 65 72 65 20 3d 20 53 51 4c where = SQL
15ec0 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f ITE_AUTOLOGGING_
15ed0 53 54 44 45 52 52 3b 0a 20 20 20 20 7d 20 65 6c STDERR;. } el
15ee0 73 65 20 69 66 28 20 21 73 74 72 6e 63 61 73 65 se if( !strncase
15ef0 63 6d 70 28 22 73 79 73 6c 6f 67 22 2c 20 65 6e cmp("syslog", en
15f00 76 70 72 6f 66 69 6c 65 2c 20 36 29 20 29 7b 0a vprofile, 6) ){.
15f10 20 20 20 20 20 20 77 68 65 72 65 20 3d 20 53 51 where = SQ
15f20 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 LITE_AUTOLOGGING
15f30 5f 53 59 53 4c 4f 47 3b 0a 20 20 20 20 7d 0a 20 _SYSLOG;. }.
15f40 20 20 20 69 66 28 20 77 68 65 72 65 3d 3d 53 51 if( where==SQ
15f50 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 LITE_AUTOLOGGING
15f60 5f 53 54 44 45 52 52 20 29 7b 0a 20 20 20 20 20 _STDERR ){.
15f70 20 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 sqlite3_profile
15f80 28 64 62 2c 20 5f 73 71 6c 69 74 65 5f 61 75 74 (db, _sqlite_aut
15f90 6f 5f 70 72 6f 66 69 6c 65 2c 20 64 62 29 3b 0a o_profile, db);.
15fa0 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 77 68 }else if( wh
15fb0 65 72 65 3d 3d 53 51 4c 49 54 45 5f 41 55 54 4f ere==SQLITE_AUTO
15fc0 4c 4f 47 47 49 4e 47 5f 53 59 53 4c 4f 47 20 29 LOGGING_SYSLOG )
15fd0 7b 0a 20 20 20 20 20 20 5f 6f 70 65 6e 5f 61 73 {. _open_as
15fe0 6c 5f 6c 6f 67 28 29 3b 0a 20 20 20 20 20 20 73 l_log();. s
15ff0 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 64 qlite3_profile(d
16000 62 2c 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f b, _sqlite_auto_
16010 70 72 6f 66 69 6c 65 5f 73 79 73 6c 6f 67 2c 20 profile_syslog,
16020 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 db);. }. }.
16030 20 63 68 61 72 20 2a 65 6e 76 74 72 61 63 65 20 char *envtrace
16040 3d 20 67 65 74 65 6e 76 28 22 53 51 4c 49 54 45 = getenv("SQLITE
16050 5f 41 55 54 4f 5f 54 52 41 43 45 22 29 3b 0a 20 _AUTO_TRACE");.
16060 20 69 66 28 20 65 6e 76 74 72 61 63 65 21 3d 4e if( envtrace!=N
16070 55 4c 4c 20 29 7b 0a 20 20 20 20 69 6e 74 20 77 ULL ){. int w
16080 68 65 72 65 20 3d 20 30 3b 0a 20 20 20 20 69 66 here = 0;. if
16090 28 20 21 73 74 72 6e 63 61 73 65 63 6d 70 28 22 ( !strncasecmp("
160a0 31 22 2c 20 65 6e 76 74 72 61 63 65 2c 20 31 29 1", envtrace, 1)
160b0 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 73 ){. if( is
160c0 61 74 74 79 28 32 29 20 29 7b 0a 20 20 20 20 20 atty(2) ){.
160d0 20 20 20 77 68 65 72 65 20 3d 20 53 51 4c 49 54 where = SQLIT
160e0 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 54 E_AUTOLOGGING_ST
160f0 44 45 52 52 3b 0a 20 20 20 20 20 20 7d 65 6c 73 DERR;. }els
16100 65 7b 0a 20 20 20 20 20 20 20 20 77 68 65 72 65 e{. where
16110 20 3d 20 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f = SQLITE_AUTOLO
16120 47 47 49 4e 47 5f 53 59 53 4c 4f 47 3b 0a 20 20 GGING_SYSLOG;.
16130 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c 73 65 }. } else
16140 20 69 66 28 20 21 73 74 72 6e 63 61 73 65 63 6d if( !strncasecm
16150 70 28 22 73 74 64 65 72 72 22 2c 20 65 6e 76 74 p("stderr", envt
16160 72 61 63 65 2c 20 36 29 20 29 7b 0a 20 20 20 20 race, 6) ){.
16170 20 20 77 68 65 72 65 20 3d 20 53 51 4c 49 54 45 where = SQLITE
16180 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 54 44 _AUTOLOGGING_STD
16190 45 52 52 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 ERR;. } else
161a0 69 66 28 20 21 73 74 72 6e 63 61 73 65 63 6d 70 if( !strncasecmp
161b0 28 22 73 79 73 6c 6f 67 22 2c 20 65 6e 76 74 72 ("syslog", envtr
161c0 61 63 65 2c 20 36 29 20 29 7b 0a 20 20 20 20 20 ace, 6) ){.
161d0 20 77 68 65 72 65 20 3d 20 53 51 4c 49 54 45 5f where = SQLITE_
161e0 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 59 53 4c AUTOLOGGING_SYSL
161f0 4f 47 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 OG;. }. if
16200 28 20 77 68 65 72 65 3d 3d 53 51 4c 49 54 45 5f ( where==SQLITE_
16210 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 54 44 45 AUTOLOGGING_STDE
16220 52 52 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 RR ){. sqli
16230 74 65 33 5f 74 72 61 63 65 28 64 62 2c 20 5f 73 te3_trace(db, _s
16240 71 6c 69 74 65 5f 61 75 74 6f 5f 74 72 61 63 65 qlite_auto_trace
16250 2c 20 64 62 29 3b 0a 20 20 20 20 7d 65 6c 73 65 , db);. }else
16260 20 69 66 28 20 77 68 65 72 65 3d 3d 53 51 4c 49 if( where==SQLI
16270 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 TE_AUTOLOGGING_S
16280 59 53 4c 4f 47 20 29 7b 0a 20 20 20 20 20 20 5f YSLOG ){. _
16290 6f 70 65 6e 5f 61 73 6c 5f 6c 6f 67 28 29 3b 0a open_asl_log();.
162a0 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 74 72 sqlite3_tr
162b0 61 63 65 28 64 62 2c 20 5f 73 71 6c 69 74 65 5f ace(db, _sqlite_
162c0 61 75 74 6f 5f 74 72 61 63 65 5f 73 79 73 6c 6f auto_trace_syslo
162d0 67 2c 20 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 g, db);. }.
162e0 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a }.}.#endif../*.*
162f0 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 * This routine d
16300 6f 65 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 oes the work of
16310 6f 70 65 6e 69 6e 67 20 61 20 64 61 74 61 62 61 opening a databa
16320 73 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 0a se on behalf of.
16330 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 ** sqlite3_open(
16340 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 6f 70 ) and sqlite3_op
16350 65 6e 31 36 28 29 2e 20 54 68 65 20 64 61 74 61 en16(). The data
16360 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 22 7a base filename "z
16370 46 69 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a 20 69 Filename" .** i
16380 73 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 2e s UTF-8 encoded.
16390 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6f .*/.static int o
163a0 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20 20 63 penDatabase(. c
163b0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 onst char *zFile
163c0 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62 61 73 name, /* Databas
163d0 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46 2d 38 e filename UTF-8
163e0 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 73 71 encoded */. sq
163f0 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c 20 20 20 lite3 **ppDb,
16400 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 65 74 /* OUT: Ret
16410 75 72 6e 65 64 20 64 61 74 61 62 61 73 65 20 68 urned database h
16420 61 6e 64 6c 65 20 2a 2f 0a 20 20 75 6e 73 69 67 andle */. unsig
16430 6e 65 64 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 ned int flags,
16440 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e 61 6c /* Operational
16450 20 66 6c 61 67 73 20 2a 2f 0a 20 20 63 6f 6e 73 flags */. cons
16460 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 20 20 t char *zVfs
16470 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
16480 65 20 56 46 53 20 74 6f 20 75 73 65 20 2a 2f 0a e VFS to use */.
16490 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 ){. sqlite3 *db
164a0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
164b0 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 61 6c /* Store al
164c0 6c 6f 63 61 74 65 64 20 68 61 6e 64 6c 65 20 68 located handle h
164d0 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b ere */. int rc;
164e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
164f0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
16500 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
16510 20 69 73 54 68 72 65 61 64 73 61 66 65 3b 20 20 isThreadsafe;
16520 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
16530 54 72 75 65 20 66 6f 72 20 74 68 72 65 61 64 73 True for threads
16540 61 66 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 afe connections
16550 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4f 70 65 6e */. char *zOpen
16560 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
16570 20 20 20 20 20 2f 2a 20 46 69 6c 65 6e 61 6d 65 /* Filename
16580 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 70 61 73 argument to pas
16590 73 20 74 6f 20 42 74 72 65 65 4f 70 65 6e 28 29 s to BtreeOpen()
165a0 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 */. char *zErr
165b0 4d 73 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 Msg = 0;
165c0 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 6d /* Error m
165d0 65 73 73 61 67 65 20 66 72 6f 6d 20 73 71 6c 69 essage from sqli
165e0 74 65 33 50 61 72 73 65 55 72 69 28 29 20 2a 2f te3ParseUri() */
165f0 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
16600 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
16610 0a 20 20 69 66 28 20 70 70 44 62 3d 3d 30 20 29 . if( ppDb==0 )
16620 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d return SQLITE_M
16630 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 ISUSE_BKPT;.#end
16640 69 66 0a 20 20 2a 70 70 44 62 20 3d 20 30 3b 0a if. *ppDb = 0;.
16650 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
16660 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 MIT_AUTOINIT. r
16670 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 c = sqlite3_init
16680 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 ialize();. if(
16690 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
166a0 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 4f 6e 6c #endif.. /* Onl
166b0 79 20 61 6c 6c 6f 77 20 73 65 6e 73 69 62 6c 65 y allow sensible
166c0 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 6f 66 combinations of
166d0 20 62 69 74 73 20 69 6e 20 74 68 65 20 66 6c 61 bits in the fla
166e0 67 73 20 61 72 67 75 6d 65 6e 74 2e 20 20 0a 20 gs argument. .
166f0 20 2a 2a 20 54 68 72 6f 77 20 61 6e 20 65 72 72 ** Throw an err
16700 6f 72 20 69 66 20 61 6e 79 20 6e 6f 6e 2d 73 65 or if any non-se
16710 6e 73 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 nse combination
16720 69 73 20 75 73 65 64 2e 20 20 49 66 20 77 65 0a is used. If we.
16730 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 62 6c 6f 63 ** do not bloc
16740 6b 20 69 6c 6c 65 67 61 6c 20 63 6f 6d 62 69 6e k illegal combin
16750 61 74 69 6f 6e 73 20 68 65 72 65 2c 20 69 74 20 ations here, it
16760 63 6f 75 6c 64 20 74 72 69 67 67 65 72 0a 20 20 could trigger.
16770 2a 2a 20 61 73 73 65 72 74 28 29 20 73 74 61 74 ** assert() stat
16780 65 6d 65 6e 74 73 20 69 6e 20 64 65 65 70 65 72 ements in deeper
16790 20 6c 61 79 65 72 73 2e 20 20 53 65 6e 73 69 62 layers. Sensib
167a0 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 0a le combinations.
167b0 20 20 2a 2a 20 61 72 65 3a 0a 20 20 2a 2a 0a 20 ** are:. **.
167c0 20 2a 2a 20 20 31 3a 20 20 53 51 4c 49 54 45 5f ** 1: SQLITE_
167d0 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 0a 20 20 OPEN_READONLY.
167e0 2a 2a 20 20 32 3a 20 20 53 51 4c 49 54 45 5f 4f ** 2: SQLITE_O
167f0 50 45 4e 5f 52 45 41 44 57 52 49 54 45 0a 20 20 PEN_READWRITE.
16800 2a 2a 20 20 36 3a 20 20 53 51 4c 49 54 45 5f 4f ** 6: SQLITE_O
16810 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 PEN_READWRITE |
16820 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 SQLITE_OPEN_CREA
16830 54 45 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 TE. */. assert
16840 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 ( SQLITE_OPEN_RE
16850 41 44 4f 4e 4c 59 20 20 3d 3d 20 30 78 30 31 20 ADONLY == 0x01
16860 29 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c );. assert( SQL
16870 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
16880 54 45 20 3d 3d 20 30 78 30 32 20 29 3b 0a 20 20 TE == 0x02 );.
16890 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 5f 4f assert( SQLITE_O
168a0 50 45 4e 5f 43 52 45 41 54 45 20 20 20 20 3d 3d PEN_CREATE ==
168b0 20 30 78 30 34 20 29 3b 0a 20 20 74 65 73 74 63 0x04 );. testc
168c0 61 73 65 28 20 28 31 3c 3c 28 66 6c 61 67 73 26 ase( (1<<(flags&
168d0 37 29 29 3d 3d 30 78 30 32 20 29 3b 20 2f 2a 20 7))==0x02 ); /*
168e0 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a 20 20 74 65 READONLY */. te
168f0 73 74 63 61 73 65 28 20 28 31 3c 3c 28 66 6c 61 stcase( (1<<(fla
16900 67 73 26 37 29 29 3d 3d 30 78 30 34 20 29 3b 20 gs&7))==0x04 );
16910 2f 2a 20 52 45 41 44 57 52 49 54 45 20 2a 2f 0a /* READWRITE */.
16920 20 20 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c testcase( (1<<
16930 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 34 30 (flags&7))==0x40
16940 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 49 54 45 ); /* READWRITE
16950 20 7c 20 43 52 45 41 54 45 20 2a 2f 0a 20 20 69 | CREATE */. i
16960 66 28 20 28 28 31 3c 3c 28 66 6c 61 67 73 26 37 f( ((1<<(flags&7
16970 29 29 20 26 20 30 78 34 36 29 3d 3d 30 20 29 7b )) & 0x46)==0 ){
16980 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
16990 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 20 TE_MISUSE_BKPT;
169a0 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 35 34 39 37 /* IMP: R-65497
169b0 2d 34 34 35 39 34 20 2a 2f 0a 20 20 7d 0a 0a 20 -44594 */. }..
169c0 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
169d0 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 alConfig.bCoreMu
169e0 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 69 73 tex==0 ){. is
169f0 54 68 72 65 61 64 73 61 66 65 20 3d 20 30 3b 0a Threadsafe = 0;.
16a00 20 20 7d 65 6c 73 65 20 69 66 28 20 66 6c 61 67 }else if( flag
16a10 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
16a20 4e 4f 4d 55 54 45 58 20 29 7b 0a 20 20 20 20 69 NOMUTEX ){. i
16a30 73 54 68 72 65 61 64 73 61 66 65 20 3d 20 30 3b sThreadsafe = 0;
16a40 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66 6c 61 . }else if( fla
16a50 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e gs & SQLITE_OPEN
16a60 5f 46 55 4c 4c 4d 55 54 45 58 20 29 7b 0a 20 20 _FULLMUTEX ){.
16a70 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d isThreadsafe =
16a80 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 1;. }else{.
16a90 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d 20 isThreadsafe =
16aa0 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
16ab0 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 78 3b 0a fig.bFullMutex;.
16ac0 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73 20 }. if( flags
16ad0 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 50 52 & SQLITE_OPEN_PR
16ae0 49 56 41 54 45 43 41 43 48 45 20 29 7b 0a 20 20 IVATECACHE ){.
16af0 20 20 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 flags &= ~SQLI
16b00 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 TE_OPEN_SHAREDCA
16b10 43 48 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 CHE;. }else if(
16b20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
16b30 6e 66 69 67 2e 73 68 61 72 65 64 43 61 63 68 65 nfig.sharedCache
16b40 45 6e 61 62 6c 65 64 20 29 7b 0a 20 20 20 20 66 Enabled ){. f
16b50 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 4f lags |= SQLITE_O
16b60 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 3b PEN_SHAREDCACHE;
16b70 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 6d 6f 76 . }.. /* Remov
16b80 65 20 68 61 72 6d 66 75 6c 20 62 69 74 73 20 66 e harmful bits f
16b90 72 6f 6d 20 74 68 65 20 66 6c 61 67 73 20 70 61 rom the flags pa
16ba0 72 61 6d 65 74 65 72 0a 20 20 2a 2a 0a 20 20 2a rameter. **. *
16bb0 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 50 45 * The SQLITE_OPE
16bc0 4e 5f 4e 4f 4d 55 54 45 58 20 61 6e 64 20 53 51 N_NOMUTEX and SQ
16bd0 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 LITE_OPEN_FULLMU
16be0 54 45 58 20 66 6c 61 67 73 20 77 65 72 65 0a 20 TEX flags were.
16bf0 20 2a 2a 20 64 65 61 6c 74 20 77 69 74 68 20 69 ** dealt with i
16c00 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 63 n the previous c
16c10 6f 64 65 20 62 6c 6f 63 6b 2e 20 20 42 65 73 69 ode block. Besi
16c20 64 65 73 20 74 68 65 73 65 2c 20 74 68 65 20 6f des these, the o
16c30 6e 6c 79 0a 20 20 2a 2a 20 76 61 6c 69 64 20 69 nly. ** valid i
16c40 6e 70 75 74 20 66 6c 61 67 73 20 66 6f 72 20 73 nput flags for s
16c50 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 qlite3_open_v2()
16c60 20 61 72 65 20 53 51 4c 49 54 45 5f 4f 50 45 4e are SQLITE_OPEN
16c70 5f 52 45 41 44 4f 4e 4c 59 2c 0a 20 20 2a 2a 20 _READONLY,. **
16c80 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
16c90 57 52 49 54 45 2c 20 53 51 4c 49 54 45 5f 4f 50 WRITE, SQLITE_OP
16ca0 45 4e 5f 43 52 45 41 54 45 2c 20 53 51 4c 49 54 EN_CREATE, SQLIT
16cb0 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 43 E_OPEN_SHAREDCAC
16cc0 48 45 2c 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f HE,. ** SQLITE_
16cd0 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 43 48 OPEN_PRIVATECACH
16ce0 45 2c 20 61 6e 64 20 73 6f 6d 65 20 72 65 73 65 E, and some rese
16cf0 72 76 65 64 20 62 69 74 73 2e 20 20 53 69 6c 65 rved bits. Sile
16d00 6e 74 6c 79 20 6d 61 73 6b 0a 20 20 2a 2a 20 6f ntly mask. ** o
16d10 66 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 6c 61 ff all other fla
16d20 67 73 2e 0a 20 20 2a 2f 0a 20 20 66 6c 61 67 73 gs.. */. flags
16d30 20 26 3d 20 20 7e 28 20 53 51 4c 49 54 45 5f 4f &= ~( SQLITE_O
16d40 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 PEN_DELETEONCLOS
16d50 45 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 E |.
16d60 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 SQLITE_OPEN_E
16d70 58 43 4c 55 53 49 56 45 20 7c 0a 20 20 20 20 20 XCLUSIVE |.
16d80 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
16d90 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 7c 0a _OPEN_MAIN_DB |.
16da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
16db0 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f QLITE_OPEN_TEMP_
16dc0 44 42 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 DB | .
16dd0 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e SQLITE_OPEN
16de0 5f 54 52 41 4e 53 49 45 4e 54 5f 44 42 20 7c 20 _TRANSIENT_DB |
16df0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
16e00 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
16e10 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 _JOURNAL | .
16e20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
16e30 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 E_OPEN_TEMP_JOUR
16e40 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 20 20 20 NAL | .
16e50 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
16e60 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 7c 20 0a N_SUBJOURNAL | .
16e70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
16e80 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53 54 45 QLITE_OPEN_MASTE
16e90 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 20 20 20 R_JOURNAL |.
16ea0 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
16eb0 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 7c E_OPEN_NOMUTEX |
16ec0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
16ed0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c SQLITE_OPEN_FULL
16ee0 4d 55 54 45 58 20 7c 0a 20 20 20 20 20 20 20 20 MUTEX |.
16ef0 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
16f00 45 4e 5f 57 41 4c 0a 20 20 20 20 20 20 20 20 20 EN_WAL.
16f10 20 20 20 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c );.. /* All
16f20 6f 63 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 ocate the sqlite
16f30 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 20 data structure
16f40 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 65 */. db = sqlite
16f50 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 3MallocZero( siz
16f60 65 6f 66 28 73 71 6c 69 74 65 33 29 20 29 3b 0a eof(sqlite3) );.
16f70 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 6f if( db==0 ) go
16f80 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 to opendb_out;.
16f90 20 69 66 28 20 69 73 54 68 72 65 61 64 73 61 66 if( isThreadsaf
16fa0 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 75 74 e ){. db->mut
16fb0 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 ex = sqlite3Mute
16fc0 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
16fd0 54 45 58 5f 52 45 43 55 52 53 49 56 45 29 3b 0a TEX_RECURSIVE);.
16fe0 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 75 74 65 if( db->mute
16ff0 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 x==0 ){. sq
17000 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 3b 0a lite3_free(db);.
17010 20 20 20 20 20 20 64 62 20 3d 20 30 3b 0a 20 20 db = 0;.
17020 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f goto opendb_
17030 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 out;. }. }.
17040 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
17050 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
17060 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 6b 20 3d . db->errMask =
17070 20 30 78 66 66 3b 0a 20 20 64 62 2d 3e 6e 44 62 0xff;. db->nDb
17080 20 3d 20 32 3b 0a 20 20 64 62 2d 3e 6d 61 67 69 = 2;. db->magi
17090 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 c = SQLITE_MAGIC
170a0 5f 42 55 53 59 3b 0a 20 20 64 62 2d 3e 61 44 62 _BUSY;. db->aDb
170b0 20 3d 20 64 62 2d 3e 61 44 62 53 74 61 74 69 63 = db->aDbStatic
170c0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 69 7a ;.. assert( siz
170d0 65 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 74 29 3d eof(db->aLimit)=
170e0 3d 73 69 7a 65 6f 66 28 61 48 61 72 64 4c 69 6d =sizeof(aHardLim
170f0 69 74 29 20 29 3b 0a 20 20 6d 65 6d 63 70 79 28 it) );. memcpy(
17100 64 62 2d 3e 61 4c 69 6d 69 74 2c 20 61 48 61 72 db->aLimit, aHar
17110 64 4c 69 6d 69 74 2c 20 73 69 7a 65 6f 66 28 64 dLimit, sizeof(d
17120 62 2d 3e 61 4c 69 6d 69 74 29 29 3b 0a 20 20 64 b->aLimit));. d
17130 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 b->aLimit[SQLITE
17140 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 _LIMIT_WORKER_TH
17150 52 45 41 44 53 5d 20 3d 20 53 51 4c 49 54 45 5f READS] = SQLITE_
17160 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 DEFAULT_WORKER_T
17170 48 52 45 41 44 53 3b 0a 20 20 64 62 2d 3e 61 75 HREADS;. db->au
17180 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 toCommit = 1;.
17190 64 62 2d 3e 6e 65 78 74 41 75 74 6f 76 61 63 20 db->nextAutovac
171a0 3d 20 2d 31 3b 0a 20 20 64 62 2d 3e 73 7a 4d 6d = -1;. db->szMm
171b0 61 70 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 ap = sqlite3Glob
171c0 61 6c 43 6f 6e 66 69 67 2e 73 7a 4d 6d 61 70 3b alConfig.szMmap;
171d0 0a 20 20 64 62 2d 3e 6e 65 78 74 50 61 67 65 73 . db->nextPages
171e0 69 7a 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e ize = 0;. db->n
171f0 4d 61 78 53 6f 72 74 65 72 4d 6d 61 70 20 3d 20 MaxSorterMmap =
17200 30 78 37 46 46 46 46 46 46 46 3b 0a 20 20 64 62 0x7FFFFFFF;. db
17210 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 ->flags |= SQLIT
17220 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 20 E_ShortColNames
17230 7c 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 | SQLITE_EnableT
17240 72 69 67 67 65 72 20 7c 20 53 51 4c 49 54 45 5f rigger | SQLITE_
17250 43 61 63 68 65 53 70 69 6c 6c 0a 23 69 66 20 21 CacheSpill.#if !
17260 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 defined(SQLITE_D
17270 45 46 41 55 4c 54 5f 41 55 54 4f 4d 41 54 49 43 EFAULT_AUTOMATIC
17280 5f 49 4e 44 45 58 29 20 7c 7c 20 53 51 4c 49 54 _INDEX) || SQLIT
17290 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 4d 41 E_DEFAULT_AUTOMA
172a0 54 49 43 5f 49 4e 44 45 58 0a 20 20 20 20 20 20 TIC_INDEX.
172b0 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c | SQL
172c0 49 54 45 5f 41 75 74 6f 49 6e 64 65 78 0a 23 65 ITE_AutoIndex.#e
172d0 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
172e0 44 45 46 41 55 4c 54 5f 43 4b 50 54 46 55 4c 4c DEFAULT_CKPTFULL
172f0 46 53 59 4e 43 0a 20 20 20 20 20 20 20 20 20 20 FSYNC.
17300 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
17310 43 6b 70 74 46 75 6c 6c 46 53 79 6e 63 0a 23 65 CkptFullFSync.#e
17320 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
17330 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 DEFAULT_FILE_FOR
17340 4d 41 54 3c 34 0a 20 20 20 20 20 20 20 20 20 20 MAT<4.
17350 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
17360 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 0a 23 65 LegacyFileFmt.#e
17370 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
17380 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 TE_ENABLE_LOAD_E
17390 58 54 45 4e 53 49 4f 4e 0a 20 20 20 20 20 20 20 XTENSION.
173a0 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 | SQLI
173b0 54 45 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e TE_LoadExtension
173c0 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
173d0 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 52 TE_DEFAULT_RECUR
173e0 53 49 56 45 5f 54 52 49 47 47 45 52 53 0a 20 20 SIVE_TRIGGERS.
173f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
17400 20 53 51 4c 49 54 45 5f 52 65 63 54 72 69 67 67 SQLITE_RecTrigg
17410 65 72 73 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 ers.#endif.#if d
17420 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
17430 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 FAULT_FOREIGN_KE
17440 59 53 29 20 26 26 20 53 51 4c 49 54 45 5f 44 45 YS) && SQLITE_DE
17450 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 FAULT_FOREIGN_KE
17460 59 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 YS.
17470 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 46 6f 72 | SQLITE_For
17480 65 69 67 6e 4b 65 79 73 0a 23 65 6e 64 69 66 0a eignKeys.#endif.
17490 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
174a0 54 45 5f 52 45 56 45 52 53 45 5f 55 4e 4f 52 44 TE_REVERSE_UNORD
174b0 45 52 45 44 5f 53 45 4c 45 43 54 53 29 0a 20 20 ERED_SELECTS).
174c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
174d0 20 53 51 4c 49 54 45 5f 52 65 76 65 72 73 65 4f SQLITE_ReverseO
174e0 72 64 65 72 0a 23 65 6e 64 69 66 0a 20 20 20 20 rder.#endif.
174f0 20 20 3b 0a 20 20 73 71 6c 69 74 65 33 48 61 73 ;. sqlite3Has
17500 68 49 6e 69 74 28 26 64 62 2d 3e 61 43 6f 6c 6c hInit(&db->aColl
17510 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 Seq);.#ifndef SQ
17520 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
17530 4c 54 41 42 4c 45 0a 20 20 73 71 6c 69 74 65 33 LTABLE. sqlite3
17540 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 4d HashInit(&db->aM
17550 6f 64 75 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 0a odule);.#endif..
17560 20 20 2f 2a 20 41 64 64 20 74 68 65 20 64 65 66 /* Add the def
17570 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 ault collation s
17580 65 71 75 65 6e 63 65 20 42 49 4e 41 52 59 2e 20 equence BINARY.
17590 42 49 4e 41 52 59 20 77 6f 72 6b 73 20 66 6f 72 BINARY works for
175a0 20 62 6f 74 68 20 55 54 46 2d 38 0a 20 20 2a 2a both UTF-8. **
175b0 20 61 6e 64 20 55 54 46 2d 31 36 2c 20 73 6f 20 and UTF-16, so
175c0 61 64 64 20 61 20 76 65 72 73 69 6f 6e 20 66 6f add a version fo
175d0 72 20 65 61 63 68 20 74 6f 20 61 76 6f 69 64 20 r each to avoid
175e0 61 6e 79 20 75 6e 6e 65 63 65 73 73 61 72 79 0a any unnecessary.
175f0 20 20 2a 2a 20 63 6f 6e 76 65 72 73 69 6f 6e 73 ** conversions
17600 2e 20 54 68 65 20 6f 6e 6c 79 20 65 72 72 6f 72 . The only error
17610 20 74 68 61 74 20 63 61 6e 20 6f 63 63 75 72 20 that can occur
17620 68 65 72 65 20 69 73 20 61 20 6d 61 6c 6c 6f 63 here is a malloc
17630 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 2a 2a () failure.. **
17640 0a 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f . ** EVIDENCE-O
17650 46 3a 20 52 2d 35 32 37 38 36 2d 34 34 38 37 38 F: R-52786-44878
17660 20 53 51 4c 69 74 65 20 64 65 66 69 6e 65 73 20 SQLite defines
17670 74 68 72 65 65 20 62 75 69 6c 74 2d 69 6e 20 63 three built-in c
17680 6f 6c 6c 61 74 69 6e 67 0a 20 20 2a 2a 20 66 75 ollating. ** fu
17690 6e 63 74 69 6f 6e 73 3a 0a 20 20 2a 2f 0a 20 20 nctions:. */.
176a0 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 createCollation(
176b0 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 db, "BINARY", SQ
176c0 4c 49 54 45 5f 55 54 46 38 2c 20 30 2c 20 62 69 LITE_UTF8, 0, bi
176d0 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 nCollFunc, 0);.
176e0 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e createCollation
176f0 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 (db, "BINARY", S
17700 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 30 QLITE_UTF16BE, 0
17710 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 , binCollFunc, 0
17720 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 );. createColla
17730 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 tion(db, "BINARY
17740 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c ", SQLITE_UTF16L
17750 45 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e E, 0, binCollFun
17760 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 74 65 43 c, 0);. createC
17770 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 4e 4f ollation(db, "NO
17780 43 41 53 45 22 2c 20 53 51 4c 49 54 45 5f 55 54 CASE", SQLITE_UT
17790 46 38 2c 20 30 2c 20 6e 6f 63 61 73 65 43 6f 6c F8, 0, nocaseCol
177a0 6c 61 74 69 6e 67 46 75 6e 63 2c 20 30 29 3b 0a latingFunc, 0);.
177b0 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
177c0 6e 28 64 62 2c 20 22 52 54 52 49 4d 22 2c 20 53 n(db, "RTRIM", S
177d0 51 4c 49 54 45 5f 55 54 46 38 2c 20 28 76 6f 69 QLITE_UTF8, (voi
177e0 64 2a 29 31 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e d*)1, binCollFun
177f0 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 64 62 2d c, 0);. if( db-
17800 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b >mallocFailed ){
17810 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 . goto opendb
17820 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 2f 2a 20 45 _out;. }. /* E
17830 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 38 VIDENCE-OF: R-08
17840 33 30 38 2d 31 37 32 32 34 20 54 68 65 20 64 65 308-17224 The de
17850 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 fault collating
17860 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 61 6c 6c function for all
17870 0a 20 20 2a 2a 20 73 74 72 69 6e 67 73 20 69 73 . ** strings is
17880 20 42 49 4e 41 52 59 2e 20 0a 20 20 2a 2f 0a 20 BINARY. . */.
17890 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d db->pDfltColl =
178a0 20 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c sqlite3FindColl
178b0 53 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 Seq(db, SQLITE_U
178c0 54 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 30 TF8, "BINARY", 0
178d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d );. assert( db-
178e0 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 20 29 3b >pDfltColl!=0 );
178f0 0a 0a 20 20 2f 2a 20 50 61 72 73 65 20 74 68 65 .. /* Parse the
17900 20 66 69 6c 65 6e 61 6d 65 2f 55 52 49 20 61 72 filename/URI ar
17910 67 75 6d 65 6e 74 2e 20 2a 2f 0a 20 20 64 62 2d gument. */. db-
17920 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 66 6c 61 >openFlags = fla
17930 67 73 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 gs;. rc = sqlit
17940 65 33 50 61 72 73 65 55 72 69 28 7a 56 66 73 2c e3ParseUri(zVfs,
17950 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 26 66 6c 61 zFilename, &fla
17960 67 73 2c 20 26 64 62 2d 3e 70 56 66 73 2c 20 26 gs, &db->pVfs, &
17970 7a 4f 70 65 6e 2c 20 26 7a 45 72 72 4d 73 67 29 zOpen, &zErrMsg)
17980 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
17990 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 TE_OK ){. if(
179a0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc==SQLITE_NOME
179b0 4d 20 29 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 M ) db->mallocFa
179c0 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 73 71 iled = 1;. sq
179d0 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 lite3ErrorWithMs
179e0 67 28 64 62 2c 20 72 63 2c 20 7a 45 72 72 4d 73 g(db, rc, zErrMs
179f0 67 20 3f 20 22 25 73 22 20 3a 20 30 2c 20 7a 45 g ? "%s" : 0, zE
17a00 72 72 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 rrMsg);. sqli
17a10 74 65 33 5f 66 72 65 65 28 7a 45 72 72 4d 73 67 te3_free(zErrMsg
17a20 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e );. goto open
17a30 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f db_out;. }.. /
17a40 2a 20 4f 70 65 6e 20 74 68 65 20 62 61 63 6b 65 * Open the backe
17a50 6e 64 20 64 61 74 61 62 61 73 65 20 64 72 69 76 nd database driv
17a60 65 72 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c er */. rc = sql
17a70 69 74 65 33 42 74 72 65 65 4f 70 65 6e 28 64 62 ite3BtreeOpen(db
17a80 2d 3e 70 56 66 73 2c 20 7a 4f 70 65 6e 2c 20 64 ->pVfs, zOpen, d
17a90 62 2c 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 b, &db->aDb[0].p
17aa0 42 74 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 20 Bt, 0,.
17ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 f
17ac0 6c 61 67 73 20 7c 20 53 51 4c 49 54 45 5f 4f 50 lags | SQLITE_OP
17ad0 45 4e 5f 4d 41 49 4e 5f 44 42 29 3b 0a 20 20 69 EN_MAIN_DB);. i
17ae0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
17af0 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d ){. if( rc==
17b00 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d SQLITE_IOERR_NOM
17b10 45 4d 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d EM ){. rc =
17b20 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
17b30 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
17b40 45 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 Error(db, rc);.
17b50 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f goto opendb_o
17b60 75 74 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 ut;. }. sqlite
17b70 33 42 74 72 65 65 45 6e 74 65 72 28 64 62 2d 3e 3BtreeEnter(db->
17b80 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 64 aDb[0].pBt);. d
17b90 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d b->aDb[0].pSchem
17ba0 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 6d a = sqlite3Schem
17bb0 61 47 65 74 28 64 62 2c 20 64 62 2d 3e 61 44 62 aGet(db, db->aDb
17bc0 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 69 66 28 20 [0].pBt);. if(
17bd0 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
17be0 64 20 29 20 45 4e 43 28 64 62 29 20 3d 20 53 43 d ) ENC(db) = SC
17bf0 48 45 4d 41 5f 45 4e 43 28 64 62 29 3b 0a 20 20 HEMA_ENC(db);.
17c00 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
17c10 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 e(db->aDb[0].pBt
17c20 29 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e );. db->aDb[1].
17c30 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 pSchema = sqlite
17c40 33 53 63 68 65 6d 61 47 65 74 28 64 62 2c 20 30 3SchemaGet(db, 0
17c50 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 64 65 66 );.. /* The def
17c60 61 75 6c 74 20 73 61 66 65 74 79 5f 6c 65 76 65 ault safety_leve
17c70 6c 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 64 l for the main d
17c80 61 74 61 62 61 73 65 20 69 73 20 27 66 75 6c 6c atabase is 'full
17c90 27 3b 20 66 6f 72 20 74 68 65 20 74 65 6d 70 0a '; for the temp.
17ca0 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 74 ** database it
17cb0 20 69 73 20 27 4e 4f 4e 45 27 2e 20 54 68 69 73 is 'NONE'. This
17cc0 20 6d 61 74 63 68 65 73 20 74 68 65 20 70 61 67 matches the pag
17cd0 65 72 20 6c 61 79 65 72 20 64 65 66 61 75 6c 74 er layer default
17ce0 73 2e 20 20 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e s. . */. db->
17cf0 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 aDb[0].zName = "
17d00 6d 61 69 6e 22 3b 0a 20 20 64 62 2d 3e 61 44 62 main";. db->aDb
17d10 5b 30 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c [0].safety_level
17d20 20 3d 20 33 3b 0a 20 20 64 62 2d 3e 61 44 62 5b = 3;. db->aDb[
17d30 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 74 65 6d 70 1].zName = "temp
17d40 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e ";. db->aDb[1].
17d50 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 31 safety_level = 1
17d60 3b 0a 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d ;.. db->magic =
17d70 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 SQLITE_MAGIC_OP
17d80 45 4e 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 EN;. if( db->ma
17d90 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 llocFailed ){.
17da0 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 goto opendb_ou
17db0 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 67 t;. }.. /* Reg
17dc0 69 73 74 65 72 20 61 6c 6c 20 62 75 69 6c 74 2d ister all built-
17dd0 69 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 62 75 in functions, bu
17de0 74 20 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70 74 t do not attempt
17df0 20 74 6f 20 72 65 61 64 20 74 68 65 0a 20 20 2a to read the. *
17e00 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d * database schem
17e10 61 20 79 65 74 2e 20 54 68 69 73 20 69 73 20 64 a yet. This is d
17e20 65 6c 61 79 65 64 20 75 6e 74 69 6c 20 74 68 65 elayed until the
17e30 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 65 20 first time the
17e40 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 69 73 database. ** is
17e50 20 61 63 63 65 73 73 65 64 2e 0a 20 20 2a 2f 0a accessed.. */.
17e60 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 sqlite3Error(d
17e70 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 b, SQLITE_OK);.
17e80 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 sqlite3Register
17e90 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 BuiltinFunctions
17ea0 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 61 64 (db);.. /* Load
17eb0 20 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e automatic exten
17ec0 73 69 6f 6e 73 20 2d 20 65 78 74 65 6e 73 69 6f sions - extensio
17ed0 6e 73 20 74 68 61 74 20 68 61 76 65 20 62 65 65 ns that have bee
17ee0 6e 20 72 65 67 69 73 74 65 72 65 64 0a 20 20 2a n registered. *
17ef0 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 * using the sqli
17f00 74 65 33 5f 61 75 74 6f 6d 61 74 69 63 5f 65 78 te3_automatic_ex
17f10 74 65 6e 73 69 6f 6e 28 29 20 41 50 49 2e 0a 20 tension() API..
17f20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 */. rc = sqlit
17f30 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
17f40 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
17f50 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 _OK ){. sqlit
17f60 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 6e 73 e3AutoLoadExtens
17f70 69 6f 6e 73 28 64 62 29 3b 0a 20 20 20 20 72 63 ions(db);. rc
17f80 20 3d 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f = sqlite3_errco
17f90 64 65 28 64 62 29 3b 0a 20 20 20 20 69 66 28 20 de(db);. if(
17fa0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
17fb0 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e . goto open
17fc0 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 db_out;. }.
17fd0 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
17fe0 5f 45 4e 41 42 4c 45 5f 46 54 53 31 0a 20 20 69 _ENABLE_FTS1. i
17ff0 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
18000 69 6c 65 64 20 29 7b 0a 20 20 20 20 65 78 74 65 iled ){. exte
18010 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 rn int sqlite3Ft
18020 73 31 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 s1Init(sqlite3*)
18030 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
18040 65 33 46 74 73 31 49 6e 69 74 28 64 62 29 3b 0a e3Fts1Init(db);.
18050 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 }.#endif..#ifd
18060 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
18070 5f 46 54 53 32 0a 20 20 69 66 28 20 21 64 62 2d _FTS2. if( !db-
18080 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 >mallocFailed &&
18090 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
180a0 7b 0a 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 {. extern int
180b0 20 73 71 6c 69 74 65 33 46 74 73 32 49 6e 69 74 sqlite3Fts2Init
180c0 28 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 (sqlite3*);.
180d0 72 63 20 3d 20 73 71 6c 69 74 65 33 46 74 73 32 rc = sqlite3Fts2
180e0 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 Init(db);. }.#e
180f0 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
18100 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a ITE_ENABLE_FTS3.
18110 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f if( !db->mallo
18120 63 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 cFailed && rc==S
18130 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
18140 72 63 20 3d 20 73 71 6c 69 74 65 33 46 74 73 33 rc = sqlite3Fts3
18150 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 Init(db);. }.#e
18160 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
18170 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 20 ITE_ENABLE_ICU.
18180 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 if( !db->malloc
18190 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 Failed && rc==SQ
181a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
181b0 63 20 3d 20 73 71 6c 69 74 65 33 49 63 75 49 6e c = sqlite3IcuIn
181c0 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
181d0 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
181e0 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 0a 20 E_ENABLE_RTREE.
181f0 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 if( !db->malloc
18200 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 Failed && rc==SQ
18210 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 LITE_OK){. rc
18220 20 3d 20 73 71 6c 69 74 65 33 52 74 72 65 65 49 = sqlite3RtreeI
18230 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e nit(db);. }.#en
18240 64 69 66 0a 0a 20 20 2f 2a 20 2d 44 53 51 4c 49 dif.. /* -DSQLI
18250 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 TE_DEFAULT_LOCKI
18260 4e 47 5f 4d 4f 44 45 3d 31 20 6d 61 6b 65 73 20 NG_MODE=1 makes
18270 45 58 43 4c 55 53 49 56 45 20 74 68 65 20 64 65 EXCLUSIVE the de
18280 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 0a 20 20 fault locking.
18290 2a 2a 20 6d 6f 64 65 2e 20 20 2d 44 53 51 4c 49 ** mode. -DSQLI
182a0 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 TE_DEFAULT_LOCKI
182b0 4e 47 5f 4d 4f 44 45 3d 30 20 6d 61 6b 65 20 4e NG_MODE=0 make N
182c0 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 6c ORMAL the defaul
182d0 74 20 6c 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d t locking. ** m
182e0 6f 64 65 2e 20 20 44 6f 69 6e 67 20 6e 6f 74 68 ode. Doing noth
182f0 69 6e 67 20 61 74 20 61 6c 6c 20 61 6c 73 6f 20 ing at all also
18300 6d 61 6b 65 73 20 4e 4f 52 4d 41 4c 20 74 68 65 makes NORMAL the
18310 20 64 65 66 61 75 6c 74 2e 0a 20 20 2a 2f 0a 23 default.. */.#
18320 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 ifdef SQLITE_DEF
18330 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
18340 45 0a 20 20 64 62 2d 3e 64 66 6c 74 4c 6f 63 6b E. db->dfltLock
18350 4d 6f 64 65 20 3d 20 53 51 4c 49 54 45 5f 44 45 Mode = SQLITE_DE
18360 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f FAULT_LOCKING_MO
18370 44 45 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 DE;. sqlite3Pag
18380 65 72 4c 6f 63 6b 69 6e 67 4d 6f 64 65 28 73 71 erLockingMode(sq
18390 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 lite3BtreePager(
183a0 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 2c db->aDb[0].pBt),
183b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
183c0 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
183d0 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e E_DEFAULT_LOCKIN
183e0 47 5f 4d 4f 44 45 29 3b 0a 23 65 6e 64 69 66 0a G_MODE);.#endif.
183f0 0a 20 20 69 66 28 20 72 63 20 29 20 73 71 6c 69 . if( rc ) sqli
18400 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 29 te3Error(db, rc)
18410 3b 0a 0a 20 20 2f 2a 20 45 6e 61 62 6c 65 20 74 ;.. /* Enable t
18420 68 65 20 6c 6f 6f 6b 61 73 69 64 65 2d 6d 61 6c he lookaside-mal
18430 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 20 2a 2f loc subsystem */
18440 0a 20 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 . setupLookasid
18450 65 28 64 62 2c 20 30 2c 20 73 71 6c 69 74 65 33 e(db, 0, sqlite3
18460 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c GlobalConfig.szL
18470 6f 6f 6b 61 73 69 64 65 2c 0a 20 20 20 20 20 20 ookaside,.
18480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18490 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
184a0 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 64 65 onfig.nLookaside
184b0 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 77 61 );.. sqlite3_wa
184c0 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74 l_autocheckpoint
184d0 28 64 62 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 (db, SQLITE_DEFA
184e0 55 4c 54 5f 57 41 4c 5f 41 55 54 4f 43 48 45 43 ULT_WAL_AUTOCHEC
184f0 4b 50 4f 49 4e 54 29 3b 0a 0a 6f 70 65 6e 64 62 KPOINT);..opendb
18500 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 5f _out:. sqlite3_
18510 66 72 65 65 28 7a 4f 70 65 6e 29 3b 0a 20 20 69 free(zOpen);. i
18520 66 28 20 64 62 20 29 7b 0a 20 20 20 20 61 73 73 f( db ){. ass
18530 65 72 74 28 20 64 62 2d 3e 6d 75 74 65 78 21 3d ert( db->mutex!=
18540 30 20 7c 7c 20 69 73 54 68 72 65 61 64 73 61 66 0 || isThreadsaf
18550 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 e==0.
18560 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c || sqlite3Global
18570 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 Config.bFullMute
18580 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 x==0 );. sqli
18590 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
185a0 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a db->mutex);. }.
185b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 rc = sqlite3_e
185c0 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 61 73 rrcode(db);. as
185d0 73 65 72 74 28 20 64 62 21 3d 30 20 7c 7c 20 72 sert( db!=0 || r
185e0 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 c==SQLITE_NOMEM
185f0 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
18600 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 ITE_NOMEM ){.
18610 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 sqlite3_close(d
18620 62 29 3b 0a 20 20 20 20 64 62 20 3d 20 30 3b 0a b);. db = 0;.
18630 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d }else if( rc!=
18640 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
18650 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
18660 49 54 45 5f 4d 41 47 49 43 5f 53 49 43 4b 3b 0a ITE_MAGIC_SICK;.
18670 20 20 7d 0a 23 69 66 20 64 65 66 69 6e 65 64 28 }.#if defined(
18680 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 45 4e __APPLE__) && EN
18690 41 42 4c 45 5f 46 4f 52 43 45 5f 57 41 4c 0a 20 ABLE_FORCE_WAL.
186a0 20 69 66 28 20 64 62 20 26 26 20 21 72 63 20 29 if( db && !rc )
186b0 7b 0a 20 20 20 20 69 66 20 28 28 30 20 3d 3d 20 {. if ((0 ==
186c0 61 63 63 65 73 73 28 22 2f 76 61 72 2f 64 62 2f access("/var/db/
186d0 65 6e 61 62 6c 65 46 6f 72 63 65 57 41 4c 22 2c enableForceWAL",
186e0 20 52 5f 4f 4b 29 29 29 20 7b 0a 23 69 66 64 65 R_OK))) {.#ifde
186f0 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
18700 20 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 fprintf(std
18710 65 72 72 2c 20 22 53 51 4c 69 74 65 20 57 41 4c err, "SQLite WAL
18720 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 45 4e journal_mode EN
18730 41 42 4c 45 44 20 62 79 20 64 65 66 61 75 6c 74 ABLED by default
18740 2e 5c 6e 22 29 3b 0a 23 65 6e 64 69 66 0a 20 20 .\n");.#endif.
18750 20 20 20 20 0a 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
18760 65 33 5f 65 78 65 63 28 64 62 2c 20 22 70 72 61 e3_exec(db, "pra
18770 67 6d 61 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 gma journal_mode
18780 3d 77 61 6c 22 2c 20 4e 55 4c 4c 2c 20 4e 55 4c =wal", NULL, NUL
18790 4c 2c 20 4e 55 4c 4c 29 3b 0a 23 69 66 64 65 66 L, NULL);.#ifdef
187a0 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2f SQLITE_DEBUG.//
187b0 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 2f 2f 20 } else {.//
187c0 20 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 fprintf(std
187d0 65 72 72 2c 20 22 53 51 4c 69 74 65 20 57 41 4c err, "SQLite WAL
187e0 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 4e 4f journal_mode NO
187f0 54 20 45 4e 41 42 4c 45 44 20 62 79 20 64 65 66 T ENABLED by def
18800 61 75 6c 74 2e 5c 6e 22 29 3b 0a 23 65 6e 64 69 ault.\n");.#endi
18810 66 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 f. }. }.#end
18820 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
18830 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 55 54 QLITE_ENABLE_AUT
18840 4f 5f 50 52 4f 46 49 4c 45 29 0a 20 20 69 66 28 O_PROFILE). if(
18850 20 64 62 20 26 26 20 21 72 63 20 29 7b 0a 20 20 db && !rc ){.
18860 20 20 65 6e 61 62 6c 65 41 75 74 6f 4c 6f 67 67 enableAutoLogg
18870 69 6e 67 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e ing(db);. }.#en
18880 64 69 66 0a 20 20 2a 70 70 44 62 20 3d 20 64 62 dif. *ppDb = db
18890 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
188a0 45 4e 41 42 4c 45 5f 53 51 4c 52 52 0a 20 20 53 ENABLE_SQLRR. S
188b0 52 52 65 63 4f 70 65 6e 28 64 62 2c 20 7a 46 69 RRecOpen(db, zFi
188c0 6c 65 6e 61 6d 65 2c 20 66 6c 61 67 73 29 3b 0a lename, flags);.
188d0 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 #endif.#ifdef SQ
188e0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c LITE_ENABLE_SQLL
188f0 4f 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 OG. if( sqlite3
18900 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 53 71 GlobalConfig.xSq
18910 6c 6c 6f 67 20 29 7b 0a 20 20 20 20 2f 2a 20 4f llog ){. /* O
18920 70 65 6e 69 6e 67 20 61 20 64 62 20 68 61 6e 64 pening a db hand
18930 6c 65 2e 20 46 6f 75 72 74 68 20 70 61 72 61 6d le. Fourth param
18940 65 74 65 72 20 69 73 20 70 61 73 73 65 64 20 30 eter is passed 0
18950 2e 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20 2a 70 . */. void *p
18960 41 72 67 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f Arg = sqlite3Glo
18970 62 61 6c 43 6f 6e 66 69 67 2e 70 53 71 6c 6c 6f balConfig.pSqllo
18980 67 41 72 67 3b 0a 20 20 20 20 73 71 6c 69 74 65 gArg;. sqlite
18990 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 53 3GlobalConfig.xS
189a0 71 6c 6c 6f 67 28 70 41 72 67 2c 20 64 62 2c 20 qllog(pArg, db,
189b0 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 29 3b 0a 20 zFilename, 0);.
189c0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 }.#endif. retu
189d0 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 rn sqlite3ApiExi
189e0 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a t(0, rc);.}../*.
189f0 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 ** Open a new da
18a00 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a tabase handle..*
18a10 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 /.int sqlite3_op
18a20 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 en(. const char
18a30 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 *zFilename, .
18a40 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 0a sqlite3 **ppDb .
18a50 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 6e ){. return open
18a60 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e 61 Database(zFilena
18a70 6d 65 2c 20 70 70 44 62 2c 0a 20 20 20 20 20 20 me, ppDb,.
18a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18a90 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
18aa0 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f WRITE | SQLITE_O
18ab0 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 29 3b 0a PEN_CREATE, 0);.
18ac0 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 }.int sqlite3_op
18ad0 65 6e 5f 76 32 28 0a 20 20 63 6f 6e 73 74 20 63 en_v2(. const c
18ae0 68 61 72 20 2a 66 69 6c 65 6e 61 6d 65 2c 20 20 har *filename,
18af0 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c /* Database fil
18b00 65 6e 61 6d 65 20 28 55 54 46 2d 38 29 20 2a 2f ename (UTF-8) */
18b10 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 . sqlite3 **ppD
18b20 62 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 b, /* OU
18b30 54 3a 20 53 51 4c 69 74 65 20 64 62 20 68 61 6e T: SQLite db han
18b40 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 dle */. int fla
18b50 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 gs,
18b60 20 2f 2a 20 46 6c 61 67 73 20 2a 2f 0a 20 20 63 /* Flags */. c
18b70 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 onst char *zVfs
18b80 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
18b90 66 20 56 46 53 20 6d 6f 64 75 6c 65 20 74 6f 20 f VFS module to
18ba0 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 75 use */.){. retu
18bb0 72 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 rn openDatabase(
18bc0 66 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c 20 filename, ppDb,
18bd0 28 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 66 6c (unsigned int)fl
18be0 61 67 73 2c 20 7a 56 66 73 29 3b 0a 7d 0a 0a 23 ags, zVfs);.}..#
18bf0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
18c00 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 4f IT_UTF16./*.** O
18c10 70 65 6e 20 61 20 6e 65 77 20 64 61 74 61 62 61 pen a new databa
18c20 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 69 6e se handle..*/.in
18c30 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 t sqlite3_open16
18c40 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a (. const void *
18c50 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 20 73 71 zFilename, . sq
18c60 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a 29 7b 0a lite3 **ppDb.){.
18c70 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 46 char const *zF
18c80 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f 2a 20 7a ilename8; /* z
18c90 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f 64 65 64 Filename encoded
18ca0 20 69 6e 20 55 54 46 2d 38 20 69 6e 73 74 65 61 in UTF-8 instea
18cb0 64 20 6f 66 20 55 54 46 2d 31 36 20 2a 2f 0a 20 d of UTF-16 */.
18cc0 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a sqlite3_value *
18cd0 70 56 61 6c 3b 0a 20 20 69 6e 74 20 72 63 3b 0a pVal;. int rc;.
18ce0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
18cf0 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
18d00 20 20 69 66 28 20 70 70 44 62 3d 3d 30 20 29 20 if( ppDb==0 )
18d10 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
18d20 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
18d30 66 0a 20 20 2a 70 70 44 62 20 3d 20 30 3b 0a 23 f. *ppDb = 0;.#
18d40 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
18d50 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 63 IT_AUTOINIT. rc
18d60 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 = sqlite3_initi
18d70 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 72 alize();. if( r
18d80 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 c ) return rc;.#
18d90 65 6e 64 69 66 0a 20 20 69 66 28 20 7a 46 69 6c endif. if( zFil
18da0 65 6e 61 6d 65 3d 3d 30 20 29 20 7a 46 69 6c 65 ename==0 ) zFile
18db0 6e 61 6d 65 20 3d 20 22 5c 30 30 30 5c 30 30 30 name = "\000\000
18dc0 22 3b 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 ";. pVal = sqli
18dd0 74 65 33 56 61 6c 75 65 4e 65 77 28 30 29 3b 0a te3ValueNew(0);.
18de0 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 sqlite3ValueSe
18df0 74 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a tStr(pVal, -1, z
18e00 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 Filename, SQLITE
18e10 5f 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 _UTF16NATIVE, SQ
18e20 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 LITE_STATIC);.
18e30 7a 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c zFilename8 = sql
18e40 69 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 ite3ValueText(pV
18e50 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 al, SQLITE_UTF8)
18e60 3b 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d ;. if( zFilenam
18e70 65 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f e8 ){. rc = o
18e80 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c penDatabase(zFil
18e90 65 6e 61 6d 65 38 2c 20 70 70 44 62 2c 0a 20 20 ename8, ppDb,.
18ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18eb0 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
18ec0 52 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 READWRITE | SQLI
18ed0 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 TE_OPEN_CREATE,
18ee0 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 0);. assert(
18ef0 2a 70 70 44 62 20 7c 7c 20 72 63 3d 3d 53 51 4c *ppDb || rc==SQL
18f00 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 ITE_NOMEM );.
18f10 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
18f20 4f 4b 20 26 26 20 21 44 62 48 61 73 50 72 6f 70 OK && !DbHasProp
18f30 65 72 74 79 28 2a 70 70 44 62 2c 20 30 2c 20 44 erty(*ppDb, 0, D
18f40 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 B_SchemaLoaded)
18f50 29 7b 0a 20 20 20 20 20 20 53 43 48 45 4d 41 5f ){. SCHEMA_
18f60 45 4e 43 28 2a 70 70 44 62 29 20 3d 20 45 4e 43 ENC(*ppDb) = ENC
18f70 28 2a 70 70 44 62 29 20 3d 20 53 51 4c 49 54 45 (*ppDb) = SQLITE
18f80 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 _UTF16NATIVE;.
18f90 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
18fa0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
18fb0 45 4d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 EM;. }. sqlite
18fc0 33 56 61 6c 75 65 46 72 65 65 28 70 56 61 6c 29 3ValueFree(pVal)
18fd0 3b 0a 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ;.. return sqli
18fe0 74 65 33 41 70 69 45 78 69 74 28 30 2c 20 72 63 te3ApiExit(0, rc
18ff0 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 );.}.#endif /* S
19000 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
19010 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 */../*.** Regis
19020 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 ter a new collat
19030 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 ion sequence wit
19040 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 h the database h
19050 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 andle db..*/.int
19060 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
19070 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 71 6c collation(. sql
19080 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e ite3* db, . con
19090 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 st char *zName,
190a0 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 . int enc, . v
190b0 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 oid* pCtx,. int
190c0 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 (*xCompare)(void
190d0 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
190e0 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
190f0 2a 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 *).){. return s
19100 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
19110 6c 6c 61 74 69 6f 6e 5f 76 32 28 64 62 2c 20 7a llation_v2(db, z
19120 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 43 74 78 2c Name, enc, pCtx,
19130 20 78 43 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 7d xCompare, 0);.}
19140 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 ../*.** Register
19150 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e a new collation
19160 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 sequence with t
19170 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
19180 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 le db..*/.int sq
19190 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c lite3_create_col
191a0 6c 61 74 69 6f 6e 5f 76 32 28 0a 20 20 73 71 6c lation_v2(. sql
191b0 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e ite3* db, . con
191c0 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 st char *zName,
191d0 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 . int enc, . v
191e0 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 oid* pCtx,. int
191f0 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 (*xCompare)(void
19200 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
19210 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
19220 2a 29 2c 0a 20 20 76 6f 69 64 28 2a 78 44 65 6c *),. void(*xDel
19230 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e )(void*).){. in
19240 74 20 72 63 3b 0a 0a 23 69 66 64 65 66 20 53 51 t rc;..#ifdef SQ
19250 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
19260 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c ARMOR. if( !sql
19270 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
19280 6b 28 64 62 29 20 7c 7c 20 7a 4e 61 6d 65 3d 3d k(db) || zName==
19290 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 0 ) return SQLIT
192a0 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
192b0 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
192c0 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
192d0 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 mutex);. assert
192e0 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
192f0 6c 65 64 20 29 3b 0a 20 20 72 63 20 3d 20 63 72 led );. rc = cr
19300 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 eateCollation(db
19310 2c 20 7a 4e 61 6d 65 2c 20 28 75 38 29 65 6e 63 , zName, (u8)enc
19320 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 , pCtx, xCompare
19330 2c 20 78 44 65 6c 29 3b 0a 20 20 72 63 20 3d 20 , xDel);. rc =
19340 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 sqlite3ApiExit(d
19350 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 b, rc);. sqlite
19360 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
19370 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
19380 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 rn rc;.}..#ifnde
19390 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 f SQLITE_OMIT_UT
193a0 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 F16./*.** Regist
193b0 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 er a new collati
193c0 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 74 68 on sequence with
193d0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
193e0 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 ndle db..*/.int
193f0 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 sqlite3_create_c
19400 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a 20 20 73 71 ollation16(. sq
19410 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f lite3* db, . co
19420 6e 73 74 20 76 6f 69 64 20 2a 7a 4e 61 6d 65 2c nst void *zName,
19430 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 . int enc, . v
19440 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 oid* pCtx,. int
19450 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 (*xCompare)(void
19460 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
19470 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 *,int,const void
19480 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d *).){. int rc =
19490 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 68 SQLITE_OK;. ch
194a0 61 72 20 2a 7a 4e 61 6d 65 38 3b 0a 0a 23 69 66 ar *zName8;..#if
194b0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
194c0 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
194d0 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
194e0 43 68 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 7a CheckOk(db) || z
194f0 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e Name==0 ) return
19500 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
19510 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 KPT;.#endif. sq
19520 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
19530 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
19540 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c assert( !db->mal
19550 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a locFailed );. z
19560 4e 61 6d 65 38 20 3d 20 73 71 6c 69 74 65 33 55 Name8 = sqlite3U
19570 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 4e 61 6d tf16to8(db, zNam
19580 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f 55 54 e, -1, SQLITE_UT
19590 46 31 36 4e 41 54 49 56 45 29 3b 0a 20 20 69 66 F16NATIVE);. if
195a0 28 20 7a 4e 61 6d 65 38 20 29 7b 0a 20 20 20 20 ( zName8 ){.
195b0 72 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 rc = createColla
195c0 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c tion(db, zName8,
195d0 20 28 75 38 29 65 6e 63 2c 20 70 43 74 78 2c 20 (u8)enc, pCtx,
195e0 78 43 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 20 20 xCompare, 0);.
195f0 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
19600 64 62 2c 20 7a 4e 61 6d 65 38 29 3b 0a 20 20 7d db, zName8);. }
19610 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
19620 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
19630 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
19640 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
19650 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
19660 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
19670 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a E_OMIT_UTF16 */.
19680 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
19690 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 a collation sequ
196a0 65 6e 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c ence factory cal
196b0 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20 64 lback with the d
196c0 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a atabase handle.*
196d0 2a 20 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e * db. Replace an
196e0 79 20 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 y previously ins
196f0 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e talled collation
19700 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 sequence factor
19710 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 y..*/.int sqlite
19720 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 3_collation_need
19730 65 64 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ed(. sqlite3 *d
19740 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c b, . void *pCol
19750 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 lNeededArg, . v
19760 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 oid(*xCollNeeded
19770 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a )(void*,sqlite3*
19780 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f ,int eTextRep,co
19790 6e 73 74 20 63 68 61 72 2a 29 0a 29 7b 0a 23 69 nst char*).){.#i
197a0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
197b0 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 LE_API_ARMOR. i
197c0 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
197d0 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 yCheckOk(db) ) r
197e0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
197f0 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 USE_BKPT;.#endif
19800 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
19810 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
19820 29 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 );. db->xCollNe
19830 65 64 65 64 20 3d 20 78 43 6f 6c 6c 4e 65 65 64 eded = xCollNeed
19840 65 64 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e ed;. db->xCollN
19850 65 65 64 65 64 31 36 20 3d 20 30 3b 0a 20 20 64 eeded16 = 0;. d
19860 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 b->pCollNeededAr
19870 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 g = pCollNeededA
19880 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
19890 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
198a0 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
198b0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
198c0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
198d0 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 _UTF16./*.** Reg
198e0 69 73 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f ister a collatio
198f0 6e 20 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f n sequence facto
19900 72 79 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 ry callback with
19910 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
19920 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c ndle.** db. Repl
19930 61 63 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 ace any previous
19940 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c ly installed col
19950 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
19960 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 factory..*/.int
19970 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f sqlite3_collatio
19980 6e 5f 6e 65 65 64 65 64 31 36 28 0a 20 20 73 71 n_needed16(. sq
19990 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 76 6f lite3 *db, . vo
199a0 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 id *pCollNeededA
199b0 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 43 6f rg, . void(*xCo
199c0 6c 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64 llNeeded16)(void
199d0 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 *,sqlite3*,int e
199e0 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f TextRep,const vo
199f0 69 64 2a 29 0a 29 7b 0a 23 69 66 64 65 66 20 53 id*).){.#ifdef S
19a00 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
19a10 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
19a20 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
19a30 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 Ok(db) ) return
19a40 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
19a50 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c PT;.#endif. sql
19a60 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
19a70 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 (db->mutex);. d
19a80 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d b->xCollNeeded =
19a90 20 30 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 0;. db->xCollN
19aa0 65 65 64 65 64 31 36 20 3d 20 78 43 6f 6c 6c 4e eeded16 = xCollN
19ab0 65 65 64 65 64 31 36 3b 0a 20 20 64 62 2d 3e 70 eeded16;. db->p
19ac0 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 20 3d 20 CollNeededArg =
19ad0 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a pCollNeededArg;.
19ae0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
19af0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
19b00 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
19b10 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f E_OK;.}.#endif /
19b20 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 * SQLITE_OMIT_UT
19b30 46 31 36 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 F16 */..#ifndef
19b40 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 SQLITE_OMIT_DEPR
19b50 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 68 69 ECATED./*.** Thi
19b60 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f s function is no
19b70 77 20 61 6e 20 61 6e 61 63 68 72 6f 6e 69 73 6d w an anachronism
19b80 2e 20 49 74 20 75 73 65 64 20 74 6f 20 62 65 20 . It used to be
19b90 75 73 65 64 20 74 6f 20 72 65 63 6f 76 65 72 20 used to recover
19ba0 66 72 6f 6d 20 61 0a 2a 2a 20 6d 61 6c 6c 6f 63 from a.** malloc
19bb0 28 29 20 66 61 69 6c 75 72 65 2c 20 62 75 74 20 () failure, but
19bc0 53 51 4c 69 74 65 20 6e 6f 77 20 64 6f 65 73 20 SQLite now does
19bd0 74 68 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c this automatical
19be0 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ly..*/.int sqlit
19bf0 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76 65 e3_global_recove
19c00 72 28 76 6f 69 64 29 7b 0a 20 20 72 65 74 75 72 r(void){. retur
19c10 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 n SQLITE_OK;.}.#
19c20 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 endif../*.** Tes
19c30 74 20 74 6f 20 73 65 65 20 77 68 65 74 68 65 72 t to see whether
19c40 20 6f 72 20 6e 6f 74 20 74 68 65 20 64 61 74 61 or not the data
19c50 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
19c60 69 73 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 is in autocommit
19c70 0a 2a 2a 20 6d 6f 64 65 2e 20 20 52 65 74 75 72 .** mode. Retur
19c80 6e 20 54 52 55 45 20 69 66 20 69 74 20 69 73 20 n TRUE if it is
19c90 61 6e 64 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 and FALSE if not
19ca0 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f . Autocommit mo
19cb0 64 65 20 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64 de is on.** by d
19cc0 65 66 61 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d efault. Autocom
19cd0 6d 69 74 20 69 73 20 64 69 73 61 62 6c 65 64 20 mit is disabled
19ce0 62 79 20 61 20 42 45 47 49 4e 20 73 74 61 74 65 by a BEGIN state
19cf0 6d 65 6e 74 20 61 6e 64 20 72 65 65 6e 61 62 6c ment and reenabl
19d00 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 6e 65 78 ed.** by the nex
19d10 74 20 43 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c t COMMIT or ROLL
19d20 42 41 43 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c BACK..*/.int sql
19d30 69 74 65 33 5f 67 65 74 5f 61 75 74 6f 63 6f 6d ite3_get_autocom
19d40 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 mit(sqlite3 *db)
19d50 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
19d60 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
19d70 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
19d80 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
19d90 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
19da0 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
19db0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a ;. return 0;.
19dc0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 }.#endif. ret
19dd0 75 72 6e 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d urn db->autoComm
19de0 69 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 it;.}../*.** The
19df0 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 following routi
19e00 6e 65 73 20 61 72 65 20 73 75 62 73 74 69 74 75 nes are substitu
19e10 74 65 73 20 66 6f 72 20 63 6f 6e 73 74 61 6e 74 tes for constant
19e20 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 s SQLITE_CORRUPT
19e30 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 ,.** SQLITE_MISU
19e40 53 45 2c 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f SE, SQLITE_CANTO
19e50 50 45 4e 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 PEN, SQLITE_IOER
19e60 52 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 6f R and possibly o
19e70 74 68 65 72 20 65 72 72 6f 72 0a 2a 2a 20 63 6f ther error.** co
19e80 6e 73 74 61 6e 74 73 2e 20 20 54 68 65 79 20 73 nstants. They s
19e90 65 72 76 65 20 74 77 6f 20 70 75 72 70 6f 73 65 erve two purpose
19ea0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 2e 20 20 53 s:.**.** 1. S
19eb0 65 72 76 65 20 61 73 20 61 20 63 6f 6e 76 65 6e erve as a conven
19ec0 69 65 6e 74 20 70 6c 61 63 65 20 74 6f 20 73 65 ient place to se
19ed0 74 20 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 69 t a breakpoint i
19ee0 6e 20 61 20 64 65 62 75 67 67 65 72 0a 2a 2a 20 n a debugger.**
19ef0 20 20 20 20 20 20 74 6f 20 64 65 74 65 63 74 20 to detect
19f00 77 68 65 6e 20 76 65 72 73 69 6f 6e 20 65 72 72 when version err
19f10 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 73 20 6f 63 or conditions oc
19f20 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 2e curs..**.** 2.
19f30 20 20 49 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33 Invoke sqlite3
19f40 5f 6c 6f 67 28 29 20 74 6f 20 70 72 6f 76 69 64 _log() to provid
19f50 65 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 e the source cod
19f60 65 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 e location where
19f70 0a 2a 2a 20 20 20 20 20 20 20 61 20 6c 6f 77 2d .** a low-
19f80 6c 65 76 65 6c 20 65 72 72 6f 72 20 69 73 20 66 level error is f
19f90 69 72 73 74 20 64 65 74 65 63 74 65 64 2e 0a 2a irst detected..*
19fa0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 /.int sqlite3Cor
19fb0 72 75 70 74 45 72 72 6f 72 28 69 6e 74 20 6c 69 ruptError(int li
19fc0 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 73 neno){. testcas
19fd0 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c e( sqlite3Global
19fe0 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 29 Config.xLog!=0 )
19ff0 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 ;. sqlite3_log(
1a000 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c 0a SQLITE_CORRUPT,.
1a010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 64 "d
1a020 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 atabase corrupti
1a030 6f 6e 20 61 74 20 6c 69 6e 65 20 25 64 20 6f 66 on at line %d of
1a040 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 20 20 20 20 [%.10s]",.
1a050 20 20 20 20 20 20 20 20 20 6c 69 6e 65 6e 6f 2c lineno,
1a060 20 32 30 2b 73 71 6c 69 74 65 33 5f 73 6f 75 72 20+sqlite3_sour
1a070 63 65 69 64 28 29 29 3b 0a 20 20 72 65 74 75 72 ceid());. retur
1a080 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
1a090 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d ;.}.int sqlite3M
1a0a0 69 73 75 73 65 45 72 72 6f 72 28 69 6e 74 20 6c isuseError(int l
1a0b0 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 74 63 61 ineno){. testca
1a0c0 73 65 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 se( sqlite3Globa
1a0d0 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 3d 30 20 lConfig.xLog!=0
1a0e0 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 );. sqlite3_log
1a0f0 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 (SQLITE_MISUSE,
1a100 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 . "
1a110 6d 69 73 75 73 65 20 61 74 20 6c 69 6e 65 20 25 misuse at line %
1a120 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 d of [%.10s]",.
1a130 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e lin
1a140 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f eno, 20+sqlite3_
1a150 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 sourceid());. r
1a160 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
1a170 55 53 45 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 USE;.}.int sqlit
1a180 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f 72 28 e3CantopenError(
1a190 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 int lineno){. t
1a1a0 65 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 estcase( sqlite3
1a1b0 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f GlobalConfig.xLo
1a1c0 67 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 g!=0 );. sqlite
1a1d0 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 43 41 4e 3_log(SQLITE_CAN
1a1e0 54 4f 50 45 4e 2c 20 0a 20 20 20 20 20 20 20 20 TOPEN, .
1a1f0 20 20 20 20 20 20 22 63 61 6e 6e 6f 74 20 6f 70 "cannot op
1a200 65 6e 20 66 69 6c 65 20 61 74 20 6c 69 6e 65 20 en file at line
1a210 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a %d of [%.10s]",.
1a220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 li
1a230 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 neno, 20+sqlite3
1a240 5f 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 20 _sourceid());.
1a250 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 return SQLITE_CA
1a260 4e 54 4f 50 45 4e 3b 0a 7d 0a 0a 0a 23 69 66 6e NTOPEN;.}...#ifn
1a270 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1a280 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a DEPRECATED./*.**
1a290 20 54 68 69 73 20 69 73 20 61 20 63 6f 6e 76 65 This is a conve
1a2a0 6e 69 65 6e 63 65 20 72 6f 75 74 69 6e 65 20 74 nience routine t
1a2b0 68 61 74 20 6d 61 6b 65 73 20 73 75 72 65 20 74 hat makes sure t
1a2c0 68 61 74 20 61 6c 6c 20 74 68 72 65 61 64 2d 73 hat all thread-s
1a2d0 70 65 63 69 66 69 63 0a 2a 2a 20 64 61 74 61 20 pecific.** data
1a2e0 66 6f 72 20 74 68 69 73 20 74 68 72 65 61 64 20 for this thread
1a2f0 68 61 73 20 62 65 65 6e 20 64 65 61 6c 6c 6f 63 has been dealloc
1a300 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 ated..**.** SQLi
1a310 74 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73 65 te no longer use
1a320 73 20 74 68 72 65 61 64 2d 73 70 65 63 69 66 69 s thread-specifi
1a330 63 20 64 61 74 61 20 73 6f 20 74 68 69 73 20 72 c data so this r
1a340 6f 75 74 69 6e 65 20 69 73 20 6e 6f 77 20 61 0a outine is now a.
1a350 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 49 74 20 69 73 ** no-op. It is
1a360 20 72 65 74 61 69 6e 65 64 20 66 6f 72 20 68 69 retained for hi
1a370 73 74 6f 72 69 63 61 6c 20 63 6f 6d 70 61 74 69 storical compati
1a380 62 69 6c 69 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 bility..*/.void
1a390 73 71 6c 69 74 65 33 5f 74 68 72 65 61 64 5f 63 sqlite3_thread_c
1a3a0 6c 65 61 6e 75 70 28 76 6f 69 64 29 7b 0a 7d 0a leanup(void){.}.
1a3b0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 #endif../*.** Re
1a3c0 74 75 72 6e 20 6d 65 74 61 20 69 6e 66 6f 72 6d turn meta inform
1a3d0 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 20 73 70 ation about a sp
1a3e0 65 63 69 66 69 63 20 63 6f 6c 75 6d 6e 20 6f 66 ecific column of
1a3f0 20 61 20 64 61 74 61 62 61 73 65 20 74 61 62 6c a database tabl
1a400 65 2e 0a 2a 2a 20 53 65 65 20 63 6f 6d 6d 65 6e e..** See commen
1a410 74 20 69 6e 20 73 71 6c 69 74 65 33 2e 68 20 28 t in sqlite3.h (
1a420 73 71 6c 69 74 65 2e 68 2e 69 6e 29 20 66 6f 72 sqlite.h.in) for
1a430 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 details..*/.int
1a440 20 73 71 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63 sqlite3_table_c
1a450 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61 28 0a olumn_metadata(.
1a460 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
1a470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1a480 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 Connection hand
1a490 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 le */. const ch
1a4a0 61 72 20 2a 7a 44 62 4e 61 6d 65 2c 20 20 20 20 ar *zDbName,
1a4b0 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
1a4c0 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a name or NULL */.
1a4d0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 const char *zT
1a4e0 61 62 6c 65 4e 61 6d 65 2c 20 20 20 20 20 2f 2a ableName, /*
1a4f0 20 54 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 Table name */.
1a500 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f const char *zCo
1a510 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 20 2f 2a 20 lumnName, /*
1a520 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 20 Column name */.
1a530 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a char const **pz
1a540 44 61 74 61 54 79 70 65 2c 20 20 20 20 2f 2a 20 DataType, /*
1a550 4f 55 54 50 55 54 3a 20 44 65 63 6c 61 72 65 64 OUTPUT: Declared
1a560 20 64 61 74 61 20 74 79 70 65 20 2a 2f 0a 20 20 data type */.
1a570 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 43 char const **pzC
1a580 6f 6c 6c 53 65 71 2c 20 20 20 20 20 2f 2a 20 4f ollSeq, /* O
1a590 55 54 50 55 54 3a 20 43 6f 6c 6c 61 74 69 6f 6e UTPUT: Collation
1a5a0 20 73 65 71 75 65 6e 63 65 20 6e 61 6d 65 20 2a sequence name *
1a5b0 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f 74 4e 75 6c /. int *pNotNul
1a5c0 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
1a5d0 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 /* OUTPUT: True
1a5e0 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 if NOT NULL cons
1a5f0 74 72 61 69 6e 74 20 65 78 69 73 74 73 20 2a 2f traint exists */
1a600 0a 20 20 69 6e 74 20 2a 70 50 72 69 6d 61 72 79 . int *pPrimary
1a610 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f Key, /
1a620 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 69 * OUTPUT: True i
1a630 66 20 63 6f 6c 75 6d 6e 20 70 61 72 74 20 6f 66 f column part of
1a640 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 PK */. int *pA
1a650 75 74 6f 69 6e 63 20 20 20 20 20 20 20 20 20 20 utoinc
1a660 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 /* OUTPUT:
1a670 54 72 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 True if column i
1a680 73 20 61 75 74 6f 2d 69 6e 63 72 65 6d 65 6e 74 s auto-increment
1a690 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b */.){. int rc;
1a6a0 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 . char *zErrMsg
1a6b0 20 3d 20 30 3b 0a 20 20 54 61 62 6c 65 20 2a 70 = 0;. Table *p
1a6c0 54 61 62 20 3d 20 30 3b 0a 20 20 43 6f 6c 75 6d Tab = 0;. Colum
1a6d0 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b 0a 20 20 69 n *pCol = 0;. i
1a6e0 6e 74 20 69 43 6f 6c 20 3d 20 30 3b 0a 20 20 63 nt iCol = 0;. c
1a6f0 68 61 72 20 63 6f 6e 73 74 20 2a 7a 44 61 74 61 har const *zData
1a700 54 79 70 65 20 3d 20 30 3b 0a 20 20 63 68 61 72 Type = 0;. char
1a710 20 63 6f 6e 73 74 20 2a 7a 43 6f 6c 6c 53 65 71 const *zCollSeq
1a720 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 6f 74 6e = 0;. int notn
1a730 75 6c 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 70 ull = 0;. int p
1a740 72 69 6d 61 72 79 6b 65 79 20 3d 20 30 3b 0a 20 rimarykey = 0;.
1a750 20 69 6e 74 20 61 75 74 6f 69 6e 63 20 3d 20 30 int autoinc = 0
1a760 3b 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 ;...#ifdef SQLIT
1a770 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
1a780 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
1a790 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
1a7a0 62 29 20 7c 7c 20 7a 54 61 62 6c 65 4e 61 6d 65 b) || zTableName
1a7b0 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
1a7c0 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f n SQLITE_MISUSE_
1a7d0 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 BKPT;. }.#endif
1a7e0 0a 0a 20 20 2f 2a 20 45 6e 73 75 72 65 20 74 68 .. /* Ensure th
1a7f0 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d e database schem
1a800 61 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 a has been loade
1a810 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d d */. sqlite3_m
1a820 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
1a830 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 33 utex);. sqlite3
1a840 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 62 BtreeEnterAll(db
1a850 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
1a860 33 49 6e 69 74 28 64 62 2c 20 26 7a 45 72 72 4d 3Init(db, &zErrM
1a870 73 67 29 3b 0a 20 20 69 66 28 20 53 51 4c 49 54 sg);. if( SQLIT
1a880 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 E_OK!=rc ){.
1a890 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a goto error_out;.
1a8a0 20 20 7d 0a 0a 20 20 2f 2a 20 4c 6f 63 61 74 65 }.. /* Locate
1a8b0 20 74 68 65 20 74 61 62 6c 65 20 69 6e 20 71 75 the table in qu
1a8c0 65 73 74 69 6f 6e 20 2a 2f 0a 20 20 70 54 61 62 estion */. pTab
1a8d0 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54 61 = sqlite3FindTa
1a8e0 62 6c 65 28 64 62 2c 20 7a 54 61 62 6c 65 4e 61 ble(db, zTableNa
1a8f0 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 me, zDbName);.
1a900 69 66 28 20 21 70 54 61 62 20 7c 7c 20 70 54 61 if( !pTab || pTa
1a910 62 2d 3e 70 53 65 6c 65 63 74 20 29 7b 0a 20 20 b->pSelect ){.
1a920 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 pTab = 0;.
1a930 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a goto error_out;.
1a940 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 6e 64 20 74 }.. /* Find t
1a950 68 65 20 63 6f 6c 75 6d 6e 20 66 6f 72 20 77 68 he column for wh
1a960 69 63 68 20 69 6e 66 6f 20 69 73 20 72 65 71 75 ich info is requ
1a970 65 73 74 65 64 20 2a 2f 0a 20 20 69 66 28 20 7a ested */. if( z
1a980 43 6f 6c 75 6d 6e 4e 61 6d 65 3d 3d 30 20 29 7b ColumnName==0 ){
1a990 0a 20 20 20 20 2f 2a 20 51 75 65 72 79 20 66 6f . /* Query fo
1a9a0 72 20 65 78 69 73 74 61 6e 63 65 20 6f 66 20 74 r existance of t
1a9b0 61 62 6c 65 20 6f 6e 6c 79 20 2a 2f 0a 20 20 7d able only */. }
1a9c0 65 6c 73 65 7b 0a 20 20 20 20 66 6f 72 28 69 43 else{. for(iC
1a9d0 6f 6c 3d 30 3b 20 69 43 6f 6c 3c 70 54 61 62 2d ol=0; iCol<pTab-
1a9e0 3e 6e 43 6f 6c 3b 20 69 43 6f 6c 2b 2b 29 7b 0a >nCol; iCol++){.
1a9f0 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 pCol = &pT
1aa00 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a ab->aCol[iCol];.
1aa10 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c if( 0==sql
1aa20 69 74 65 33 53 74 72 49 43 6d 70 28 70 43 6f 6c ite3StrICmp(pCol
1aa30 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 6f 6c 75 6d 6e ->zName, zColumn
1aa40 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 20 20 20 Name) ){.
1aa50 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a break;. }.
1aa60 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 43 }. if( iC
1aa70 6f 6c 3d 3d 70 54 61 62 2d 3e 6e 43 6f 6c 20 29 ol==pTab->nCol )
1aa80 7b 0a 20 20 20 20 20 20 69 66 28 20 48 61 73 52 {. if( HasR
1aa90 6f 77 69 64 28 70 54 61 62 29 20 26 26 20 73 71 owid(pTab) && sq
1aaa0 6c 69 74 65 33 49 73 52 6f 77 69 64 28 7a 43 6f lite3IsRowid(zCo
1aab0 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a 20 20 20 lumnName) ){.
1aac0 20 20 20 20 20 69 43 6f 6c 20 3d 20 70 54 61 62 iCol = pTab
1aad0 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 20 20 20 20 ->iPKey;.
1aae0 20 70 43 6f 6c 20 3d 20 69 43 6f 6c 3e 3d 30 20 pCol = iCol>=0
1aaf0 3f 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 ? &pTab->aCol[iC
1ab00 6f 6c 5d 20 3a 20 30 3b 0a 20 20 20 20 20 20 7d ol] : 0;. }
1ab10 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 54 else{. pT
1ab20 61 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ab = 0;.
1ab30 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a goto error_out;.
1ab40 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1ab50 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c }.. /* The foll
1ab60 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 73 74 6f 72 owing block stor
1ab70 65 73 20 74 68 65 20 6d 65 74 61 20 69 6e 66 6f es the meta info
1ab80 72 6d 61 74 69 6f 6e 20 74 68 61 74 20 77 69 6c rmation that wil
1ab90 6c 20 62 65 20 72 65 74 75 72 6e 65 64 0a 20 20 l be returned.
1aba0 2a 2a 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 ** to the caller
1abb0 20 69 6e 20 6c 6f 63 61 6c 20 76 61 72 69 61 62 in local variab
1abc0 6c 65 73 20 7a 44 61 74 61 54 79 70 65 2c 20 7a les zDataType, z
1abd0 43 6f 6c 6c 53 65 71 2c 20 6e 6f 74 6e 75 6c 6c CollSeq, notnull
1abe0 2c 20 70 72 69 6d 61 72 79 6b 65 79 0a 20 20 2a , primarykey. *
1abf0 2a 20 61 6e 64 20 61 75 74 6f 69 6e 63 2e 20 41 * and autoinc. A
1ac00 74 20 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 t this point the
1ac10 72 65 20 61 72 65 20 74 77 6f 20 70 6f 73 73 69 re are two possi
1ac20 62 69 6c 69 74 69 65 73 3a 0a 20 20 2a 2a 20 0a bilities:. ** .
1ac30 20 20 2a 2a 20 20 20 20 20 31 2e 20 54 68 65 20 ** 1. The
1ac40 73 70 65 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e specified column
1ac50 20 6e 61 6d 65 20 77 61 73 20 72 6f 77 69 64 22 name was rowid"
1ac60 2c 20 22 6f 69 64 22 20 6f 72 20 22 5f 72 6f 77 , "oid" or "_row
1ac70 69 64 5f 22 20 0a 20 20 2a 2a 20 20 20 20 20 20 id_" . **
1ac80 20 20 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e and there is n
1ac90 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 64 65 63 o explicitly dec
1aca0 6c 61 72 65 64 20 49 50 4b 20 63 6f 6c 75 6d 6e lared IPK column
1acb0 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 . . **. **
1acc0 20 32 2e 20 54 68 65 20 74 61 62 6c 65 20 69 73 2. The table is
1acd0 20 6e 6f 74 20 61 20 76 69 65 77 20 61 6e 64 20 not a view and
1ace0 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 the column name
1acf0 69 64 65 6e 74 69 66 69 65 64 20 61 6e 20 0a 20 identified an .
1ad00 20 2a 2a 20 20 20 20 20 20 20 20 65 78 70 6c 69 ** expli
1ad10 63 69 74 6c 79 20 64 65 63 6c 61 72 65 64 20 63 citly declared c
1ad20 6f 6c 75 6d 6e 2e 20 43 6f 70 79 20 6d 65 74 61 olumn. Copy meta
1ad30 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f information fro
1ad40 6d 20 2a 70 43 6f 6c 2e 0a 20 20 2a 2f 20 0a 20 m *pCol.. */ .
1ad50 20 69 66 28 20 70 43 6f 6c 20 29 7b 0a 20 20 20 if( pCol ){.
1ad60 20 7a 44 61 74 61 54 79 70 65 20 3d 20 70 43 6f zDataType = pCo
1ad70 6c 2d 3e 7a 54 79 70 65 3b 0a 20 20 20 20 7a 43 l->zType;. zC
1ad80 6f 6c 6c 53 65 71 20 3d 20 70 43 6f 6c 2d 3e 7a ollSeq = pCol->z
1ad90 43 6f 6c 6c 3b 0a 20 20 20 20 6e 6f 74 6e 75 6c Coll;. notnul
1ada0 6c 20 3d 20 70 43 6f 6c 2d 3e 6e 6f 74 4e 75 6c l = pCol->notNul
1adb0 6c 21 3d 30 3b 0a 20 20 20 20 70 72 69 6d 61 72 l!=0;. primar
1adc0 79 6b 65 79 20 20 3d 20 28 70 43 6f 6c 2d 3e 63 ykey = (pCol->c
1add0 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 olFlags & COLFLA
1ade0 47 5f 50 52 49 4d 4b 45 59 29 21 3d 30 3b 0a 20 G_PRIMKEY)!=0;.
1adf0 20 20 20 61 75 74 6f 69 6e 63 20 3d 20 70 54 61 autoinc = pTa
1ae00 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c 20 26 b->iPKey==iCol &
1ae10 26 20 28 70 54 61 62 2d 3e 74 61 62 46 6c 61 67 & (pTab->tabFlag
1ae20 73 20 26 20 54 46 5f 41 75 74 6f 69 6e 63 72 65 s & TF_Autoincre
1ae30 6d 65 6e 74 29 21 3d 30 3b 0a 20 20 7d 65 6c 73 ment)!=0;. }els
1ae40 65 7b 0a 20 20 20 20 7a 44 61 74 61 54 79 70 65 e{. zDataType
1ae50 20 3d 20 22 49 4e 54 45 47 45 52 22 3b 0a 20 20 = "INTEGER";.
1ae60 20 20 70 72 69 6d 61 72 79 6b 65 79 20 3d 20 31 primarykey = 1
1ae70 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 7a 43 6f ;. }. if( !zCo
1ae80 6c 6c 53 65 71 20 29 7b 0a 20 20 20 20 7a 43 6f llSeq ){. zCo
1ae90 6c 6c 53 65 71 20 3d 20 22 42 49 4e 41 52 59 22 llSeq = "BINARY"
1aea0 3b 0a 20 20 7d 0a 0a 65 72 72 6f 72 5f 6f 75 74 ;. }..error_out
1aeb0 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 :. sqlite3Btree
1aec0 4c 65 61 76 65 41 6c 6c 28 64 62 29 3b 0a 0a 20 LeaveAll(db);..
1aed0 20 2f 2a 20 57 68 65 74 68 65 72 20 74 68 65 20 /* Whether the
1aee0 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 20 73 75 function call su
1aef0 63 63 65 65 64 65 64 20 6f 72 20 66 61 69 6c 65 cceeded or faile
1af00 64 2c 20 73 65 74 20 74 68 65 20 6f 75 74 70 75 d, set the outpu
1af10 74 20 70 61 72 61 6d 65 74 65 72 73 0a 20 20 2a t parameters. *
1af20 2a 20 74 6f 20 77 68 61 74 65 76 65 72 20 74 68 * to whatever th
1af30 65 69 72 20 6c 6f 63 61 6c 20 63 6f 75 6e 74 65 eir local counte
1af40 72 70 61 72 74 73 20 63 6f 6e 74 61 69 6e 2e 20 rparts contain.
1af50 49 66 20 61 6e 20 65 72 72 6f 72 20 64 69 64 20 If an error did
1af60 6f 63 63 75 72 2c 0a 20 20 2a 2a 20 74 68 69 73 occur,. ** this
1af70 20 68 61 73 20 74 68 65 20 65 66 66 65 63 74 20 has the effect
1af80 6f 66 20 7a 65 72 6f 69 6e 67 20 61 6c 6c 20 6f of zeroing all o
1af90 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 73 utput parameters
1afa0 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 7a 44 .. */. if( pzD
1afb0 61 74 61 54 79 70 65 20 29 20 2a 70 7a 44 61 74 ataType ) *pzDat
1afc0 61 54 79 70 65 20 3d 20 7a 44 61 74 61 54 79 70 aType = zDataTyp
1afd0 65 3b 0a 20 20 69 66 28 20 70 7a 43 6f 6c 6c 53 e;. if( pzCollS
1afe0 65 71 20 29 20 2a 70 7a 43 6f 6c 6c 53 65 71 20 eq ) *pzCollSeq
1aff0 3d 20 7a 43 6f 6c 6c 53 65 71 3b 0a 20 20 69 66 = zCollSeq;. if
1b000 28 20 70 4e 6f 74 4e 75 6c 6c 20 29 20 2a 70 4e ( pNotNull ) *pN
1b010 6f 74 4e 75 6c 6c 20 3d 20 6e 6f 74 6e 75 6c 6c otNull = notnull
1b020 3b 0a 20 20 69 66 28 20 70 50 72 69 6d 61 72 79 ;. if( pPrimary
1b030 4b 65 79 20 29 20 2a 70 50 72 69 6d 61 72 79 4b Key ) *pPrimaryK
1b040 65 79 20 3d 20 70 72 69 6d 61 72 79 6b 65 79 3b ey = primarykey;
1b050 0a 20 20 69 66 28 20 70 41 75 74 6f 69 6e 63 20 . if( pAutoinc
1b060 29 20 2a 70 41 75 74 6f 69 6e 63 20 3d 20 61 75 ) *pAutoinc = au
1b070 74 6f 69 6e 63 3b 0a 0a 20 20 69 66 28 20 53 51 toinc;.. if( SQ
1b080 4c 49 54 45 5f 4f 4b 3d 3d 72 63 20 26 26 20 21 LITE_OK==rc && !
1b090 70 54 61 62 20 29 7b 0a 20 20 20 20 73 71 6c 69 pTab ){. sqli
1b0a0 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 te3DbFree(db, zE
1b0b0 72 72 4d 73 67 29 3b 0a 20 20 20 20 7a 45 72 72 rrMsg);. zErr
1b0c0 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 Msg = sqlite3MPr
1b0d0 69 6e 74 66 28 64 62 2c 20 22 6e 6f 20 73 75 63 intf(db, "no suc
1b0e0 68 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 3a 20 h table column:
1b0f0 25 73 2e 25 73 22 2c 20 7a 54 61 62 6c 65 4e 61 %s.%s", zTableNa
1b100 6d 65 2c 0a 20 20 20 20 20 20 20 20 7a 43 6f 6c me,. zCol
1b110 75 6d 6e 4e 61 6d 65 29 3b 0a 20 20 20 20 72 63 umnName);. rc
1b120 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
1b130 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 72 . }. sqlite3Er
1b140 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 72 rorWithMsg(db, r
1b150 63 2c 20 28 7a 45 72 72 4d 73 67 3f 22 25 73 22 c, (zErrMsg?"%s"
1b160 3a 30 29 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 :0), zErrMsg);.
1b170 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
1b180 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 b, zErrMsg);. r
1b190 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
1b1a0 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
1b1b0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1b1c0 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
1b1d0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1b1e0 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72 20 61 20 .** Sleep for a
1b1f0 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e 20 20 52 little while. R
1b200 65 74 75 72 6e 20 74 68 65 20 61 6d 6f 75 6e 74 eturn the amount
1b210 20 6f 66 20 74 69 6d 65 20 73 6c 65 70 74 2e 0a of time slept..
1b220 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 */.int sqlite3_s
1b230 6c 65 65 70 28 69 6e 74 20 6d 73 29 7b 0a 20 20 leep(int ms){.
1b240 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 sqlite3_vfs *pVf
1b250 73 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 s;. int rc;. p
1b260 56 66 73 20 3d 20 73 71 6c 69 74 65 33 5f 76 66 Vfs = sqlite3_vf
1b270 73 5f 66 69 6e 64 28 30 29 3b 0a 20 20 69 66 28 s_find(0);. if(
1b280 20 70 56 66 73 3d 3d 30 20 29 20 72 65 74 75 72 pVfs==0 ) retur
1b290 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 n 0;.. /* This
1b2a0 66 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 69 function works i
1b2b0 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 2c 20 n milliseconds,
1b2c0 62 75 74 20 74 68 65 20 75 6e 64 65 72 6c 79 69 but the underlyi
1b2d0 6e 67 20 4f 73 53 6c 65 65 70 28 29 20 0a 20 20 ng OsSleep() .
1b2e0 2a 2a 20 41 50 49 20 75 73 65 73 20 6d 69 63 72 ** API uses micr
1b2f0 6f 73 65 63 6f 6e 64 73 2e 20 48 65 6e 63 65 20 oseconds. Hence
1b300 74 68 65 20 31 30 30 30 27 73 2e 0a 20 20 2a 2f the 1000's.. */
1b310 0a 20 20 72 63 20 3d 20 28 73 71 6c 69 74 65 33 . rc = (sqlite3
1b320 4f 73 53 6c 65 65 70 28 70 56 66 73 2c 20 31 30 OsSleep(pVfs, 10
1b330 30 30 2a 6d 73 29 2f 31 30 30 30 29 3b 0a 20 20 00*ms)/1000);.
1b340 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1b350 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 .** Enable or di
1b360 73 61 62 6c 65 20 74 68 65 20 65 78 74 65 6e 64 sable the extend
1b370 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 73 2e ed result codes.
1b380 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
1b390 65 78 74 65 6e 64 65 64 5f 72 65 73 75 6c 74 5f extended_result_
1b3a0 63 6f 64 65 73 28 73 71 6c 69 74 65 33 20 2a 64 codes(sqlite3 *d
1b3b0 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 29 7b 0a 23 b, int onoff){.#
1b3c0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
1b3d0 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
1b3e0 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
1b3f0 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 tyCheckOk(db) )
1b400 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
1b410 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 SUSE_BKPT;.#endi
1b420 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f. sqlite3_mute
1b430 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
1b440 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 x);. db->errMas
1b450 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 30 78 66 66 k = onoff ? 0xff
1b460 66 66 66 66 66 66 20 3a 20 30 78 66 66 3b 0a 20 ffffff : 0xff;.
1b470 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
1b480 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
1b490 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
1b4a0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e _OK;.}../*.** In
1b4b0 76 6f 6b 65 20 74 68 65 20 78 46 69 6c 65 43 6f voke the xFileCo
1b4c0 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 6f 6e 20 ntrol method on
1b4d0 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 a particular dat
1b4e0 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 abase..*/.int sq
1b4f0 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
1b500 6f 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 ol(sqlite3 *db,
1b510 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e const char *zDbN
1b520 61 6d 65 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69 ame, int op, voi
1b530 64 20 2a 70 41 72 67 29 7b 0a 20 20 69 6e 74 20 d *pArg){. int
1b540 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
1b550 52 3b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 R;. Btree *pBtr
1b560 65 65 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ee;..#ifdef SQLI
1b570 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
1b580 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
1b590 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
1b5a0 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c db) ) return SQL
1b5b0 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
1b5c0 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
1b5d0 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
1b5e0 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 42 74 72 ->mutex);. pBtr
1b5f0 65 65 20 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 ee = sqlite3DbNa
1b600 6d 65 54 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 meToBtree(db, zD
1b610 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 42 bName);. if( pB
1b620 74 72 65 65 20 29 7b 0a 20 20 20 20 50 61 67 65 tree ){. Page
1b630 72 20 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 73 r *pPager;. s
1b640 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b qlite3_file *fd;
1b650 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
1b660 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a eEnter(pBtree);.
1b670 20 20 20 20 70 50 61 67 65 72 20 3d 20 73 71 6c pPager = sql
1b680 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 ite3BtreePager(p
1b690 42 74 72 65 65 29 3b 0a 20 20 20 20 61 73 73 65 Btree);. asse
1b6a0 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 29 3b rt( pPager!=0 );
1b6b0 0a 20 20 20 20 66 64 20 3d 20 73 71 6c 69 74 65 . fd = sqlite
1b6c0 33 50 61 67 65 72 46 69 6c 65 28 70 50 61 67 65 3PagerFile(pPage
1b6d0 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 r);. assert(
1b6e0 66 64 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 fd!=0 );. if(
1b6f0 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 46 43 4e 54 op==SQLITE_FCNT
1b700 4c 5f 46 49 4c 45 5f 50 4f 49 4e 54 45 52 20 29 L_FILE_POINTER )
1b710 7b 0a 20 20 20 20 20 20 2a 28 73 71 6c 69 74 65 {. *(sqlite
1b720 33 5f 66 69 6c 65 2a 2a 29 70 41 72 67 20 3d 20 3_file**)pArg =
1b730 66 64 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 fd;. rc = S
1b740 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 QLITE_OK;. }e
1b750 6c 73 65 20 69 66 28 20 66 64 2d 3e 70 4d 65 74 lse if( fd->pMet
1b760 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 72 63 hods ){. rc
1b770 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
1b780 43 6f 6e 74 72 6f 6c 28 66 64 2c 20 6f 70 2c 20 Control(fd, op,
1b790 70 41 72 67 29 3b 0a 23 69 66 6e 64 65 66 20 53 pArg);.#ifndef S
1b7a0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
1b7b0 20 20 20 20 20 69 66 28 20 28 72 63 3d 3d 53 51 if( (rc==SQ
1b7c0 4c 49 54 45 5f 4f 4b 29 26 26 28 6f 70 3d 3d 53 LITE_OK)&&(op==S
1b7d0 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4c 41 53 54 QLITE_FCNTL_LAST
1b7e0 5f 45 52 52 4e 4f 29 26 26 28 2a 28 69 6e 74 20 _ERRNO)&&(*(int
1b7f0 2a 29 70 41 72 67 3d 3d 30 29 20 29 7b 0a 20 20 *)pArg==0) ){.
1b800 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 sqlite3_fi
1b810 6c 65 20 2a 70 57 61 6c 46 64 20 3d 20 73 71 6c le *pWalFd = sql
1b820 69 74 65 33 50 61 67 65 72 57 61 6c 46 69 6c 65 ite3PagerWalFile
1b830 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
1b840 20 20 69 66 28 20 70 57 61 6c 46 64 26 26 28 70 if( pWalFd&&(p
1b850 57 61 6c 46 64 2d 3e 70 4d 65 74 68 6f 64 73 29 WalFd->pMethods)
1b860 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
1b870 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
1b880 43 6f 6e 74 72 6f 6c 28 70 57 61 6c 46 64 2c 20 Control(pWalFd,
1b890 6f 70 2c 20 70 41 72 67 29 3b 0a 20 20 20 20 20 op, pArg);.
1b8a0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 65 6e }. }.#en
1b8b0 64 69 66 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 dif. }else{.
1b8c0 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1b8d0 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 20 20 20 20 7d _NOTFOUND;. }
1b8e0 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
1b8f0 65 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a eLeave(pBtree);.
1b900 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 45 72 72 }. sqlite3Err
1b910 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 or(db, rc);. sq
1b920 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1b930 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
1b940 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1b950 0a 2a 2a 20 49 6e 74 65 72 66 61 63 65 20 74 6f .** Interface to
1b960 20 74 68 65 20 74 65 73 74 69 6e 67 20 6c 6f 67 the testing log
1b970 69 63 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ic..*/.int sqlit
1b980 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1b990 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 int op, ...){.
1b9a0 69 6e 74 20 72 63 20 3d 20 30 3b 0a 23 69 66 6e int rc = 0;.#ifn
1b9b0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1b9c0 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 20 20 76 BUILTIN_TEST. v
1b9d0 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 76 61 5f a_list ap;. va_
1b9e0 73 74 61 72 74 28 61 70 2c 20 6f 70 29 3b 0a 20 start(ap, op);.
1b9f0 20 73 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 0a switch( op ){..
1ba00 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 53 61 /*. ** Sa
1ba10 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 ve the current s
1ba20 74 61 74 65 20 6f 66 20 74 68 65 20 50 52 4e 47 tate of the PRNG
1ba30 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1ba40 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1ba50 4c 5f 50 52 4e 47 5f 53 41 56 45 3a 20 7b 0a 20 L_PRNG_SAVE: {.
1ba60 20 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 sqlite3Prng
1ba70 53 61 76 65 53 74 61 74 65 28 29 3b 0a 20 20 20 SaveState();.
1ba80 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1ba90 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 52 . /*. ** R
1baa0 65 73 74 6f 72 65 20 74 68 65 20 73 74 61 74 65 estore the state
1bab0 20 6f 66 20 74 68 65 20 50 52 4e 47 20 74 6f 20 of the PRNG to
1bac0 74 68 65 20 6c 61 73 74 20 73 74 61 74 65 20 73 the last state s
1bad0 61 76 65 64 20 75 73 69 6e 67 0a 20 20 20 20 2a aved using. *
1bae0 2a 20 50 52 4e 47 5f 53 41 56 45 2e 20 20 49 66 * PRNG_SAVE. If
1baf0 20 50 52 4e 47 5f 53 41 56 45 20 68 61 73 20 6e PRNG_SAVE has n
1bb00 65 76 65 72 20 62 65 66 6f 72 65 20 62 65 65 6e ever before been
1bb10 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 0a 20 20 called, then.
1bb20 20 20 2a 2a 20 74 68 69 73 20 76 65 72 62 20 61 ** this verb a
1bb30 63 74 73 20 6c 69 6b 65 20 50 52 4e 47 5f 52 45 cts like PRNG_RE
1bb40 53 45 54 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 SET.. */.
1bb50 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
1bb60 43 54 52 4c 5f 50 52 4e 47 5f 52 45 53 54 4f 52 CTRL_PRNG_RESTOR
1bb70 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 E: {. sqlit
1bb80 65 33 50 72 6e 67 52 65 73 74 6f 72 65 53 74 61 e3PrngRestoreSta
1bb90 74 65 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 te();. brea
1bba0 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
1bbb0 0a 20 20 20 20 2a 2a 20 52 65 73 65 74 20 74 68 . ** Reset th
1bbc0 65 20 50 52 4e 47 20 62 61 63 6b 20 74 6f 20 69 e PRNG back to i
1bbd0 74 73 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 ts uninitialized
1bbe0 20 73 74 61 74 65 2e 20 20 54 68 65 20 6e 65 78 state. The nex
1bbf0 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f t call. ** to
1bc00 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e sqlite3_randomn
1bc10 65 73 73 28 29 20 77 69 6c 6c 20 72 65 73 65 65 ess() will resee
1bc20 64 20 74 68 65 20 50 52 4e 47 20 75 73 69 6e 67 d the PRNG using
1bc30 20 61 20 73 69 6e 67 6c 65 20 63 61 6c 6c 0a 20 a single call.
1bc40 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 78 52 61 ** to the xRa
1bc50 6e 64 6f 6d 6e 65 73 73 20 6d 65 74 68 6f 64 20 ndomness method
1bc60 6f 66 20 74 68 65 20 64 65 66 61 75 6c 74 20 56 of the default V
1bc70 46 53 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 FS.. */. c
1bc80 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1bc90 54 52 4c 5f 50 52 4e 47 5f 52 45 53 45 54 3a 20 TRL_PRNG_RESET:
1bca0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f {. sqlite3_
1bcb0 72 61 6e 64 6f 6d 6e 65 73 73 28 30 2c 30 29 3b randomness(0,0);
1bcc0 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1bcd0 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
1bce0 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 ** sqlite3_test
1bcf0 5f 63 6f 6e 74 72 6f 6c 28 42 49 54 56 45 43 5f _control(BITVEC_
1bd00 54 45 53 54 2c 20 73 69 7a 65 2c 20 70 72 6f 67 TEST, size, prog
1bd10 72 61 6d 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ram). **.
1bd20 2a 2a 20 52 75 6e 20 61 20 74 65 73 74 20 61 67 ** Run a test ag
1bd30 61 69 6e 73 74 20 61 20 42 69 74 76 65 63 20 6f ainst a Bitvec o
1bd40 62 6a 65 63 74 20 6f 66 20 73 69 7a 65 2e 20 20 bject of size.
1bd50 54 68 65 20 70 72 6f 67 72 61 6d 20 61 72 67 75 The program argu
1bd60 6d 65 6e 74 0a 20 20 20 20 2a 2a 20 69 73 20 61 ment. ** is a
1bd70 6e 20 61 72 72 61 79 20 6f 66 20 69 6e 74 65 67 n array of integ
1bd80 65 72 73 20 74 68 61 74 20 64 65 66 69 6e 65 73 ers that defines
1bd90 20 74 68 65 20 74 65 73 74 2e 20 20 52 65 74 75 the test. Retu
1bda0 72 6e 20 2d 31 20 6f 6e 20 61 0a 20 20 20 20 2a rn -1 on a. *
1bdb0 2a 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 * memory allocat
1bdc0 69 6f 6e 20 65 72 72 6f 72 2c 20 30 20 6f 6e 20 ion error, 0 on
1bdd0 73 75 63 63 65 73 73 2c 20 6f 72 20 6e 6f 6e 2d success, or non-
1bde0 7a 65 72 6f 20 66 6f 72 20 61 6e 20 65 72 72 6f zero for an erro
1bdf0 72 2e 0a 20 20 20 20 2a 2a 20 53 65 65 20 74 68 r.. ** See th
1be00 65 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 e sqlite3BitvecB
1be10 75 69 6c 74 69 6e 54 65 73 74 28 29 20 66 6f 72 uiltinTest() for
1be20 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f additional info
1be30 72 6d 61 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a rmation.. */.
1be40 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1be50 54 45 53 54 43 54 52 4c 5f 42 49 54 56 45 43 5f TESTCTRL_BITVEC_
1be60 54 45 53 54 3a 20 7b 0a 20 20 20 20 20 20 69 6e TEST: {. in
1be70 74 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 t sz = va_arg(ap
1be80 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 69 6e , int);. in
1be90 74 20 2a 61 50 72 6f 67 20 3d 20 76 61 5f 61 72 t *aProg = va_ar
1bea0 67 28 61 70 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 g(ap, int*);.
1beb0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
1bec0 69 74 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 itvecBuiltinTest
1bed0 28 73 7a 2c 20 61 50 72 6f 67 29 3b 0a 20 20 20 (sz, aProg);.
1bee0 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
1bef0 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 . /*. **
1bf00 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
1bf10 74 72 6f 6c 28 46 41 55 4c 54 5f 49 4e 53 54 41 trol(FAULT_INSTA
1bf20 4c 4c 2c 20 78 43 61 6c 6c 62 61 63 6b 29 0a 20 LL, xCallback).
1bf30 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 72 72 **. ** Arr
1bf40 61 6e 67 65 20 74 6f 20 69 6e 76 6f 6b 65 20 78 ange to invoke x
1bf50 43 61 6c 6c 62 61 63 6b 28 29 20 77 68 65 6e 65 Callback() whene
1bf60 76 65 72 20 73 71 6c 69 74 65 33 46 61 75 6c 74 ver sqlite3Fault
1bf70 53 69 6d 28 29 20 69 73 20 63 61 6c 6c 65 64 2c Sim() is called,
1bf80 0a 20 20 20 20 2a 2a 20 69 66 20 78 43 61 6c 6c . ** if xCall
1bf90 62 61 63 6b 20 69 73 20 6e 6f 74 20 4e 55 4c 4c back is not NULL
1bfa0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1bfb0 41 73 20 61 20 74 65 73 74 20 6f 66 20 74 68 65 As a test of the
1bfc0 20 66 61 75 6c 74 20 73 69 6d 75 6c 61 74 6f 72 fault simulator
1bfd0 20 6d 65 63 68 61 6e 69 73 6d 20 69 74 73 65 6c mechanism itsel
1bfe0 66 2c 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 f, sqlite3FaultS
1bff0 69 6d 28 30 29 0a 20 20 20 20 2a 2a 20 69 73 20 im(0). ** is
1c000 63 61 6c 6c 65 64 20 69 6d 6d 65 64 69 61 74 65 called immediate
1c010 6c 79 20 61 66 74 65 72 20 69 6e 73 74 61 6c 6c ly after install
1c020 69 6e 67 20 74 68 65 20 6e 65 77 20 63 61 6c 6c ing the new call
1c030 62 61 63 6b 20 61 6e 64 20 74 68 65 20 72 65 74 back and the ret
1c040 75 72 6e 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 urn. ** value
1c050 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 46 61 75 from sqlite3Fau
1c060 6c 74 53 69 6d 28 30 29 20 62 65 63 6f 6d 65 73 ltSim(0) becomes
1c070 20 74 68 65 20 72 65 74 75 72 6e 20 66 72 6f 6d the return from
1c080 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f . ** sqlite3_
1c090 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 2e 0a test_control()..
1c0a0 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1c0b0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1c0c0 46 41 55 4c 54 5f 49 4e 53 54 41 4c 4c 3a 20 7b FAULT_INSTALL: {
1c0d0 0a 20 20 20 20 20 20 2f 2a 20 4d 53 56 43 20 69 . /* MSVC i
1c0e0 73 20 70 69 63 6b 79 20 61 62 6f 75 74 20 70 75 s picky about pu
1c0f0 6c 6c 69 6e 67 20 66 75 6e 63 20 70 74 72 73 20 lling func ptrs
1c100 66 72 6f 6d 20 76 61 20 6c 69 73 74 73 2e 0a 20 from va lists..
1c110 20 20 20 20 20 2a 2a 20 68 74 74 70 3a 2f 2f 73 ** http://s
1c120 75 70 70 6f 72 74 2e 6d 69 63 72 6f 73 6f 66 74 upport.microsoft
1c130 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 31 0a 20 20 .com/kb/47961.
1c140 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 47 6c ** sqlite3Gl
1c150 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 54 65 73 74 obalConfig.xTest
1c160 43 61 6c 6c 62 61 63 6b 20 3d 20 76 61 5f 61 72 Callback = va_ar
1c170 67 28 61 70 2c 20 69 6e 74 28 2a 29 28 69 6e 74 g(ap, int(*)(int
1c180 29 29 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ));. */.
1c190 20 20 20 74 79 70 65 64 65 66 20 69 6e 74 28 2a typedef int(*
1c1a0 54 45 53 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 TESTCALLBACKFUNC
1c1b0 5f 74 29 28 69 6e 74 29 3b 0a 20 20 20 20 20 20 _t)(int);.
1c1c0 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1c1d0 66 69 67 2e 78 54 65 73 74 43 61 6c 6c 62 61 63 fig.xTestCallbac
1c1e0 6b 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 54 k = va_arg(ap, T
1c1f0 45 53 54 43 41 4c 4c 42 41 43 4b 46 55 4e 43 5f ESTCALLBACKFUNC_
1c200 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 t);. rc = s
1c210 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d 28 30 qlite3FaultSim(0
1c220 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
1c230 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 }.. /*.
1c240 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 ** sqlite3_te
1c250 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 45 4e 49 47 st_control(BENIG
1c260 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 2c 20 N_MALLOC_HOOKS,
1c270 78 42 65 67 69 6e 2c 20 78 45 6e 64 29 0a 20 20 xBegin, xEnd).
1c280 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 65 67 69 **. ** Regi
1c290 73 74 65 72 20 68 6f 6f 6b 73 20 74 6f 20 63 61 ster hooks to ca
1c2a0 6c 6c 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 ll to indicate w
1c2b0 68 69 63 68 20 6d 61 6c 6c 6f 63 28 29 20 66 61 hich malloc() fa
1c2c0 69 6c 75 72 65 73 20 0a 20 20 20 20 2a 2a 20 61 ilures . ** a
1c2d0 72 65 20 62 65 6e 69 67 6e 2e 0a 20 20 20 20 2a re benign.. *
1c2e0 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
1c2f0 45 5f 54 45 53 54 43 54 52 4c 5f 42 45 4e 49 47 E_TESTCTRL_BENIG
1c300 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 3a 20 N_MALLOC_HOOKS:
1c310 7b 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 20 {. typedef
1c320 76 6f 69 64 20 28 2a 76 6f 69 64 5f 66 75 6e 63 void (*void_func
1c330 74 69 6f 6e 29 28 76 6f 69 64 29 3b 0a 20 20 20 tion)(void);.
1c340 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e void_function
1c350 20 78 42 65 6e 69 67 6e 42 65 67 69 6e 3b 0a 20 xBenignBegin;.
1c360 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 void_functi
1c370 6f 6e 20 78 42 65 6e 69 67 6e 45 6e 64 3b 0a 20 on xBenignEnd;.
1c380 20 20 20 20 20 78 42 65 6e 69 67 6e 42 65 67 69 xBenignBegi
1c390 6e 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 n = va_arg(ap, v
1c3a0 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 oid_function);.
1c3b0 20 20 20 20 20 78 42 65 6e 69 67 6e 45 6e 64 20 xBenignEnd
1c3c0 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
1c3d0 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 20 20 d_function);.
1c3e0 20 20 20 73 71 6c 69 74 65 33 42 65 6e 69 67 6e sqlite3Benign
1c3f0 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 78 42 65 6e MallocHooks(xBen
1c400 69 67 6e 42 65 67 69 6e 2c 20 78 42 65 6e 69 67 ignBegin, xBenig
1c410 6e 45 6e 64 29 3b 0a 20 20 20 20 20 20 62 72 65 nEnd);. bre
1c420 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1c430 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 *. ** sqlite
1c440 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1c450 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 QLITE_TESTCTRL_P
1c460 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 75 6e 73 ENDING_BYTE, uns
1c470 69 67 6e 65 64 20 69 6e 74 20 58 29 0a 20 20 20 igned int X).
1c480 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 **. ** Set t
1c490 68 65 20 50 45 4e 44 49 4e 47 20 62 79 74 65 20 he PENDING byte
1c4a0 74 6f 20 74 68 65 20 76 61 6c 75 65 20 69 6e 20 to the value in
1c4b0 74 68 65 20 61 72 67 75 6d 65 6e 74 2c 20 69 66 the argument, if
1c4c0 20 58 3e 30 2e 0a 20 20 20 20 2a 2a 20 4d 61 6b X>0.. ** Mak
1c4d0 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 20 e no changes if
1c4e0 58 3d 3d 30 2e 20 20 52 65 74 75 72 6e 20 74 68 X==0. Return th
1c4f0 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 70 e value of the p
1c500 65 6e 64 69 6e 67 20 62 79 74 65 0a 20 20 20 20 ending byte.
1c510 2a 2a 20 61 73 20 69 74 20 65 78 69 73 74 69 6e ** as it existin
1c520 67 20 62 65 66 6f 72 65 20 74 68 69 73 20 72 6f g before this ro
1c530 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 64 utine was called
1c540 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1c550 49 4d 50 4f 52 54 41 4e 54 3a 20 20 43 68 61 6e IMPORTANT: Chan
1c560 67 69 6e 67 20 74 68 65 20 50 45 4e 44 49 4e 47 ging the PENDING
1c570 20 62 79 74 65 20 66 72 6f 6d 20 30 78 34 30 30 byte from 0x400
1c580 30 30 30 30 30 20 72 65 73 75 6c 74 73 20 69 6e 00000 results in
1c590 0a 20 20 20 20 2a 2a 20 61 6e 20 69 6e 63 6f 6d . ** an incom
1c5a0 70 61 74 69 62 6c 65 20 64 61 74 61 62 61 73 65 patible database
1c5b0 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 20 43 file format. C
1c5c0 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 4e 44 hanging the PEND
1c5d0 49 4e 47 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 ING byte. **
1c5e0 77 68 69 6c 65 20 61 6e 79 20 64 61 74 61 62 61 while any databa
1c5f0 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 se connection is
1c600 20 6f 70 65 6e 20 72 65 73 75 6c 74 73 20 69 6e open results in
1c610 20 75 6e 64 65 66 69 6e 65 64 20 61 6e 64 0a 20 undefined and.
1c620 20 20 20 2a 2a 20 64 65 6c 65 74 65 72 69 6f 75 ** deleteriou
1c630 73 20 62 65 68 61 76 69 6f 72 2e 0a 20 20 20 20 s behavior..
1c640 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1c650 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 45 4e 44 TE_TESTCTRL_PEND
1c660 49 4e 47 5f 42 59 54 45 3a 20 7b 0a 20 20 20 20 ING_BYTE: {.
1c670 20 20 72 63 20 3d 20 50 45 4e 44 49 4e 47 5f 42 rc = PENDING_B
1c680 59 54 45 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c YTE;.#ifndef SQL
1c690 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 20 ITE_OMIT_WSD.
1c6a0 20 20 20 7b 0a 20 20 20 20 20 20 20 20 75 6e 73 {. uns
1c6b0 69 67 6e 65 64 20 69 6e 74 20 6e 65 77 56 61 6c igned int newVal
1c6c0 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 75 6e = va_arg(ap, un
1c6d0 73 69 67 6e 65 64 20 69 6e 74 29 3b 0a 20 20 20 signed int);.
1c6e0 20 20 20 20 20 69 66 28 20 6e 65 77 56 61 6c 20 if( newVal
1c6f0 29 20 73 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 ) sqlite3Pending
1c700 42 79 74 65 20 3d 20 6e 65 77 56 61 6c 3b 0a 20 Byte = newVal;.
1c710 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
1c720 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1c730 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
1c740 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1c750 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1c760 54 43 54 52 4c 5f 41 53 53 45 52 54 2c 20 69 6e TCTRL_ASSERT, in
1c770 74 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t X). **.
1c780 2a 2a 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 ** This action p
1c790 72 6f 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 rovides a run-ti
1c7a0 6d 65 20 74 65 73 74 20 74 6f 20 73 65 65 20 77 me test to see w
1c7b0 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 0a 20 20 hether or not.
1c7c0 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 77 61 ** assert() wa
1c7d0 73 20 65 6e 61 62 6c 65 64 20 61 74 20 63 6f 6d s enabled at com
1c7e0 70 69 6c 65 2d 74 69 6d 65 2e 20 20 49 66 20 58 pile-time. If X
1c7f0 20 69 73 20 74 72 75 65 20 61 6e 64 20 61 73 73 is true and ass
1c800 65 72 74 28 29 0a 20 20 20 20 2a 2a 20 69 73 20 ert(). ** is
1c810 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 enabled, then th
1c820 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 e return value i
1c830 73 20 74 72 75 65 2e 20 20 49 66 20 58 20 69 73 s true. If X is
1c840 20 74 72 75 65 20 61 6e 64 0a 20 20 20 20 2a 2a true and. **
1c850 20 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 assert() is dis
1c860 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 abled, then the
1c870 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1c880 7a 65 72 6f 2e 20 20 49 66 20 58 20 69 73 0a 20 zero. If X is.
1c890 20 20 20 2a 2a 20 66 61 6c 73 65 20 61 6e 64 20 ** false and
1c8a0 61 73 73 65 72 74 28 29 20 69 73 20 65 6e 61 62 assert() is enab
1c8b0 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 61 73 led, then the as
1c8c0 73 65 72 74 69 6f 6e 20 66 69 72 65 73 20 61 6e sertion fires an
1c8d0 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 72 6f d the. ** pro
1c8e0 63 65 73 73 20 61 62 6f 72 74 73 2e 20 20 49 66 cess aborts. If
1c8f0 20 58 20 69 73 20 66 61 6c 73 65 20 61 6e 64 20 X is false and
1c900 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 61 assert() is disa
1c910 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 20 bled, then the.
1c920 20 20 20 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c ** return val
1c930 75 65 20 69 73 20 7a 65 72 6f 2e 0a 20 20 20 20 ue is zero..
1c940 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
1c950 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 TE_TESTCTRL_ASSE
1c960 52 54 3a 20 7b 0a 20 20 20 20 20 20 76 6f 6c 61 RT: {. vola
1c970 74 69 6c 65 20 69 6e 74 20 78 20 3d 20 30 3b 0a tile int x = 0;.
1c980 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 78 assert( (x
1c990 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 = va_arg(ap,int
1c9a0 29 29 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 ))!=0 );. r
1c9b0 63 20 3d 20 78 3b 0a 20 20 20 20 20 20 62 72 65 c = x;. bre
1c9c0 61 6b 3b 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 20 ak;. }...
1c9d0 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 /*. ** sqlit
1c9e0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1c9f0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1ca00 41 4c 57 41 59 53 2c 20 69 6e 74 20 58 29 0a 20 ALWAYS, int X).
1ca10 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 **. ** Thi
1ca20 73 20 61 63 74 69 6f 6e 20 70 72 6f 76 69 64 65 s action provide
1ca30 73 20 61 20 72 75 6e 2d 74 69 6d 65 20 74 65 73 s a run-time tes
1ca40 74 20 74 6f 20 73 65 65 20 68 6f 77 20 74 68 65 t to see how the
1ca50 20 41 4c 57 41 59 53 20 61 6e 64 0a 20 20 20 20 ALWAYS and.
1ca60 2a 2a 20 4e 45 56 45 52 20 6d 61 63 72 6f 73 20 ** NEVER macros
1ca70 77 65 72 65 20 64 65 66 69 6e 65 64 20 61 74 20 were defined at
1ca80 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e 0a 20 20 compile-time..
1ca90 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 **. ** The
1caa0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1cab0 41 4c 57 41 59 53 28 58 29 2e 20 20 0a 20 20 20 ALWAYS(X). .
1cac0 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 **. ** The r
1cad0 65 63 6f 6d 6d 65 6e 64 65 64 20 74 65 73 74 20 ecommended test
1cae0 69 73 20 58 3d 3d 32 2e 20 20 49 66 20 74 68 65 is X==2. If the
1caf0 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 return value is
1cb00 20 32 2c 20 74 68 61 74 20 6d 65 61 6e 73 0a 20 2, that means.
1cb10 20 20 20 2a 2a 20 41 4c 57 41 59 53 28 29 20 61 ** ALWAYS() a
1cb20 6e 64 20 4e 45 56 45 52 28 29 20 61 72 65 20 62 nd NEVER() are b
1cb30 6f 74 68 20 6e 6f 2d 6f 70 20 70 61 73 73 2d 74 oth no-op pass-t
1cb40 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 2c 20 77 hrough macros, w
1cb50 68 69 63 68 20 69 73 20 74 68 65 0a 20 20 20 20 hich is the.
1cb60 2a 2a 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 ** default setti
1cb70 6e 67 2e 20 20 49 66 20 74 68 65 20 72 65 74 75 ng. If the retu
1cb80 72 6e 20 76 61 6c 75 65 20 69 73 20 31 2c 20 74 rn value is 1, t
1cb90 68 65 6e 20 41 4c 57 41 59 53 28 29 20 69 73 20 hen ALWAYS() is
1cba0 65 69 74 68 65 72 0a 20 20 20 20 2a 2a 20 68 61 either. ** ha
1cbb0 72 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 65 rd-coded to true
1cbc0 20 6f 72 20 65 6c 73 65 20 69 74 20 61 73 73 65 or else it asse
1cbd0 72 74 73 20 69 66 20 69 74 73 20 61 72 67 75 6d rts if its argum
1cbe0 65 6e 74 20 69 73 20 66 61 6c 73 65 2e 0a 20 20 ent is false..
1cbf0 20 20 2a 2a 20 54 68 65 20 66 69 72 73 74 20 62 ** The first b
1cc00 65 68 61 76 69 6f 72 20 28 68 61 72 64 2d 63 6f ehavior (hard-co
1cc10 64 65 64 20 74 6f 20 74 72 75 65 29 20 69 73 20 ded to true) is
1cc20 74 68 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 the case if.
1cc30 2a 2a 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ** SQLITE_TESTCT
1cc40 52 4c 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 RL_ASSERT shows
1cc50 74 68 61 74 20 61 73 73 65 72 74 28 29 20 69 73 that assert() is
1cc60 20 64 69 73 61 62 6c 65 64 20 61 6e 64 20 74 68 disabled and th
1cc70 65 20 73 65 63 6f 6e 64 0a 20 20 20 20 2a 2a 20 e second. **
1cc80 62 65 68 61 76 69 6f 72 20 28 61 73 73 65 72 74 behavior (assert
1cc90 20 69 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 if the argument
1cca0 20 74 6f 20 41 4c 57 41 59 53 28 29 20 69 73 20 to ALWAYS() is
1ccb0 66 61 6c 73 65 29 20 69 73 20 74 68 65 20 63 61 false) is the ca
1ccc0 73 65 20 69 66 0a 20 20 20 20 2a 2a 20 53 51 4c se if. ** SQL
1ccd0 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 ITE_TESTCTRL_ASS
1cce0 45 52 54 20 73 68 6f 77 73 20 74 68 61 74 20 61 ERT shows that a
1ccf0 73 73 65 72 74 28 29 20 69 73 20 65 6e 61 62 6c ssert() is enabl
1cd00 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a ed.. **. *
1cd10 2a 20 54 68 65 20 72 75 6e 2d 74 69 6d 65 20 74 * The run-time t
1cd20 65 73 74 20 70 72 6f 63 65 64 75 72 65 20 6d 69 est procedure mi
1cd30 67 68 74 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 ght look somethi
1cd40 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 0a 20 20 ng like this:.
1cd50 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 20 69 **. ** i
1cd60 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f f( sqlite3_test_
1cd70 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1cd80 45 53 54 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 ESTCTRL_ALWAYS,
1cd90 32 29 3d 3d 32 20 29 7b 0a 20 20 20 20 2a 2a 20 2)==2 ){. **
1cda0 20 20 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 29 // ALWAYS()
1cdb0 20 61 6e 64 20 4e 45 56 45 52 28 29 20 61 72 65 and NEVER() are
1cdc0 20 6e 6f 2d 6f 70 20 70 61 73 73 2d 74 68 72 6f no-op pass-thro
1cdd0 75 67 68 20 6d 61 63 72 6f 73 0a 20 20 20 20 2a ugh macros. *
1cde0 2a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73 * }else if( s
1cdf0 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1ce00 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
1ce10 54 52 4c 5f 41 53 53 45 52 54 2c 20 31 29 20 29 TRL_ASSERT, 1) )
1ce20 7b 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f {. ** //
1ce30 20 41 4c 57 41 59 53 28 78 29 20 61 73 73 65 72 ALWAYS(x) asser
1ce40 74 73 20 74 68 61 74 20 78 20 69 73 20 74 72 75 ts that x is tru
1ce50 65 2e 20 4e 45 56 45 52 28 78 29 20 61 73 73 65 e. NEVER(x) asse
1ce60 72 74 73 20 78 20 69 73 20 66 61 6c 73 65 2e 0a rts x is false..
1ce70 20 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 7b ** }else{
1ce80 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 . ** //
1ce90 41 4c 57 41 59 53 28 78 29 20 69 73 20 61 20 63 ALWAYS(x) is a c
1cea0 6f 6e 73 74 61 6e 74 20 31 2e 20 20 4e 45 56 45 onstant 1. NEVE
1ceb0 52 28 78 29 20 69 73 20 61 20 63 6f 6e 73 74 61 R(x) is a consta
1cec0 6e 74 20 30 2e 0a 20 20 20 20 2a 2a 20 20 20 20 nt 0.. **
1ced0 7d 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 }. */. cas
1cee0 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1cef0 4c 5f 41 4c 57 41 59 53 3a 20 7b 0a 20 20 20 20 L_ALWAYS: {.
1cf00 20 20 69 6e 74 20 78 20 3d 20 76 61 5f 61 72 67 int x = va_arg
1cf10 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 (ap,int);.
1cf20 72 63 20 3d 20 41 4c 57 41 59 53 28 78 29 3b 0a rc = ALWAYS(x);.
1cf30 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1cf40 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a }.. /*. *
1cf50 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 * sqlite3_test
1cf60 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f _control(SQLITE_
1cf70 54 45 53 54 43 54 52 4c 5f 42 59 54 45 4f 52 44 TESTCTRL_BYTEORD
1cf80 45 52 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ER);. **.
1cf90 2a 2a 20 54 68 65 20 69 6e 74 65 67 65 72 20 72 ** The integer r
1cfa0 65 74 75 72 6e 65 64 20 72 65 76 65 61 6c 73 20 eturned reveals
1cfb0 74 68 65 20 62 79 74 65 2d 6f 72 64 65 72 20 6f the byte-order o
1cfc0 66 20 74 68 65 20 63 6f 6d 70 75 74 65 72 20 6f f the computer o
1cfd0 6e 20 77 68 69 63 68 0a 20 20 20 20 2a 2a 20 53 n which. ** S
1cfe0 51 4c 69 74 65 20 69 73 20 72 75 6e 6e 69 6e 67 QLite is running
1cff0 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 :. **. **
1d000 20 20 20 20 20 20 31 20 20 20 20 20 62 69 67 2d 1 big-
1d010 65 6e 64 69 61 6e 2c 20 20 20 20 64 65 74 65 72 endian, deter
1d020 6d 69 6e 65 64 20 61 74 20 72 75 6e 2d 74 69 6d mined at run-tim
1d030 65 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 31 30 e. ** 10
1d040 20 20 20 20 20 6c 69 74 74 6c 65 2d 65 6e 64 69 little-endi
1d050 61 6e 2c 20 64 65 74 65 72 6d 69 6e 65 64 20 61 an, determined a
1d060 74 20 72 75 6e 2d 74 69 6d 65 0a 20 20 20 20 2a t run-time. *
1d070 2a 20 20 34 33 32 31 30 31 20 20 20 20 20 62 69 * 432101 bi
1d080 67 2d 65 6e 64 69 61 6e 2c 20 20 20 20 64 65 74 g-endian, det
1d090 65 72 6d 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 ermined at compi
1d0a0 6c 65 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 le-time. **
1d0b0 31 32 33 34 31 30 20 20 20 20 20 6c 69 74 74 6c 123410 littl
1d0c0 65 2d 65 6e 64 69 61 6e 2c 20 64 65 74 65 72 6d e-endian, determ
1d0d0 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d ined at compile-
1d0e0 74 69 6d 65 0a 20 20 20 20 2a 2f 20 0a 20 20 20 time. */ .
1d0f0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1d100 54 43 54 52 4c 5f 42 59 54 45 4f 52 44 45 52 3a TCTRL_BYTEORDER:
1d110 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 {. rc = SQ
1d120 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 2a 31 LITE_BYTEORDER*1
1d130 30 30 20 2b 20 53 51 4c 49 54 45 5f 4c 49 54 54 00 + SQLITE_LITT
1d140 4c 45 45 4e 44 49 41 4e 2a 31 30 20 2b 20 53 51 LEENDIAN*10 + SQ
1d150 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 3b 0a LITE_BIGENDIAN;.
1d160 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1d170 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c }.. /* sql
1d180 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
1d190 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
1d1a0 4c 5f 52 45 53 45 52 56 45 2c 20 73 71 6c 69 74 L_RESERVE, sqlit
1d1b0 65 33 20 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 e3 *db, int N).
1d1c0 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 **. ** Set
1d1d0 20 74 68 65 20 6e 52 65 73 65 72 76 65 20 73 69 the nReserve si
1d1e0 7a 65 20 74 6f 20 4e 20 66 6f 72 20 74 68 65 20 ze to N for the
1d1f0 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 6f 6e main database on
1d200 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
1d210 20 20 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 ** connection
1d220 64 62 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 db.. */. c
1d230 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1d240 54 52 4c 5f 52 45 53 45 52 56 45 3a 20 7b 0a 20 TRL_RESERVE: {.
1d250 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 sqlite3 *db
1d260 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 73 71 = va_arg(ap, sq
1d270 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 20 20 69 lite3*);. i
1d280 6e 74 20 78 20 3d 20 76 61 5f 61 72 67 28 61 70 nt x = va_arg(ap
1d290 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c ,int);. sql
1d2a0 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
1d2b0 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 (db->mutex);.
1d2c0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 sqlite3BtreeS
1d2d0 65 74 50 61 67 65 53 69 7a 65 28 64 62 2d 3e 61 etPageSize(db->a
1d2e0 44 62 5b 30 5d 2e 70 42 74 2c 20 30 2c 20 78 2c Db[0].pBt, 0, x,
1d2f0 20 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 0);. sqlit
1d300 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
1d310 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 20 b->mutex);.
1d320 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
1d330 20 20 20 2f 2a 20 20 73 71 6c 69 74 65 33 5f 74 /* sqlite3_t
1d340 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1d350 54 45 5f 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 TE_TESTCTRL_OPTI
1d360 4d 49 5a 41 54 49 4f 4e 53 2c 20 73 71 6c 69 74 MIZATIONS, sqlit
1d370 65 33 20 2a 64 62 2c 20 69 6e 74 20 4e 29 0a 20 e3 *db, int N).
1d380 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 6e 61 **. ** Ena
1d390 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 76 ble or disable v
1d3a0 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 arious optimizat
1d3b0 69 6f 6e 73 20 66 6f 72 20 74 65 73 74 69 6e 67 ions for testing
1d3c0 20 70 75 72 70 6f 73 65 73 2e 20 20 54 68 65 20 purposes. The
1d3d0 0a 20 20 20 20 2a 2a 20 61 72 67 75 6d 65 6e 74 . ** argument
1d3e0 20 4e 20 69 73 20 61 20 62 69 74 6d 61 73 6b 20 N is a bitmask
1d3f0 6f 66 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 of optimizations
1d400 20 74 6f 20 62 65 20 64 69 73 61 62 6c 65 64 2e to be disabled.
1d410 20 20 46 6f 72 20 6e 6f 72 6d 61 6c 0a 20 20 20 For normal.
1d420 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 4e 20 ** operation N
1d430 73 68 6f 75 6c 64 20 62 65 20 30 2e 20 20 54 68 should be 0. Th
1d440 65 20 69 64 65 61 20 69 73 20 74 68 61 74 20 61 e idea is that a
1d450 20 74 65 73 74 20 70 72 6f 67 72 61 6d 20 28 6c test program (l
1d460 69 6b 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 53 ike the. ** S
1d470 51 4c 20 4c 6f 67 69 63 20 54 65 73 74 20 6f 72 QL Logic Test or
1d480 20 53 4c 54 20 74 65 73 74 20 6d 6f 64 75 6c 65 SLT test module
1d490 29 20 63 61 6e 20 72 75 6e 20 74 68 65 20 73 61 ) can run the sa
1d4a0 6d 65 20 53 51 4c 20 6d 75 6c 74 69 70 6c 65 20 me SQL multiple
1d4b0 74 69 6d 65 73 0a 20 20 20 20 2a 2a 20 77 69 74 times. ** wit
1d4c0 68 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 h various optimi
1d4d0 7a 61 74 69 6f 6e 73 20 64 69 73 61 62 6c 65 64 zations disabled
1d4e0 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 to verify that
1d4f0 74 68 65 20 73 61 6d 65 20 61 6e 73 77 65 72 0a the same answer.
1d500 20 20 20 20 2a 2a 20 69 73 20 6f 62 74 61 69 6e ** is obtain
1d510 65 64 20 69 6e 20 65 76 65 72 79 20 63 61 73 65 ed in every case
1d520 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1d530 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1d540 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 3a L_OPTIMIZATIONS:
1d550 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
1d560 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 70 *db = va_arg(ap
1d570 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 , sqlite3*);.
1d580 20 20 20 64 62 2d 3e 64 62 4f 70 74 46 6c 61 67 db->dbOptFlag
1d590 73 20 3d 20 28 75 31 36 29 28 76 61 5f 61 72 67 s = (u16)(va_arg
1d5a0 28 61 70 2c 20 69 6e 74 29 20 26 20 30 78 66 66 (ap, int) & 0xff
1d5b0 66 66 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b ff);. break
1d5c0 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 ;. }..#ifdef
1d5d0 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 44 SQLITE_N_KEYWORD
1d5e0 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f . /* sqlite3_
1d5f0 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1d600 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 4b ITE_TESTCTRL_ISK
1d610 45 59 57 4f 52 44 2c 20 63 6f 6e 73 74 20 63 68 EYWORD, const ch
1d620 61 72 20 2a 7a 57 6f 72 64 29 0a 20 20 20 20 2a ar *zWord). *
1d630 2a 0a 20 20 20 20 2a 2a 20 49 66 20 7a 57 6f 72 *. ** If zWor
1d640 64 20 69 73 20 61 20 6b 65 79 77 6f 72 64 20 72 d is a keyword r
1d650 65 63 6f 67 6e 69 7a 65 64 20 62 79 20 74 68 65 ecognized by the
1d660 20 70 61 72 73 65 72 2c 20 74 68 65 6e 20 72 65 parser, then re
1d670 74 75 72 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 turn the. **
1d680 6e 75 6d 62 65 72 20 6f 66 20 6b 65 79 77 6f 72 number of keywor
1d690 64 73 2e 20 20 4f 72 20 69 66 20 7a 57 6f 72 64 ds. Or if zWord
1d6a0 20 69 73 20 6e 6f 74 20 61 20 6b 65 79 77 6f 72 is not a keywor
1d6b0 64 2c 20 72 65 74 75 72 6e 20 30 2e 0a 20 20 20 d, return 0..
1d6c0 20 2a 2a 20 0a 20 20 20 20 2a 2a 20 54 68 69 73 ** . ** This
1d6d0 20 74 65 73 74 20 66 65 61 74 75 72 65 20 69 73 test feature is
1d6e0 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 only available
1d6f0 69 6e 20 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 in the amalgamat
1d700 69 6f 6e 20 73 69 6e 63 65 0a 20 20 20 20 2a 2a ion since. **
1d710 20 74 68 65 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 the SQLITE_N_KE
1d720 59 57 4f 52 44 20 6d 61 63 72 6f 20 69 73 20 6e YWORD macro is n
1d730 6f 74 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 ot defined in th
1d740 69 73 20 66 69 6c 65 20 69 66 20 53 51 4c 69 74 is file if SQLit
1d750 65 0a 20 20 20 20 2a 2a 20 69 73 20 62 75 69 6c e. ** is buil
1d760 74 20 75 73 69 6e 67 20 73 65 70 61 72 61 74 65 t using separate
1d770 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 20 source files..
1d780 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1d790 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 QLITE_TESTCTRL_I
1d7a0 53 4b 45 59 57 4f 52 44 3a 20 7b 0a 20 20 20 20 SKEYWORD: {.
1d7b0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 57 const char *zW
1d7c0 6f 72 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c ord = va_arg(ap,
1d7d0 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 const char*);.
1d7e0 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c int n = sql
1d7f0 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 57 6f ite3Strlen30(zWo
1d800 72 64 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 rd);. rc =
1d810 28 73 71 6c 69 74 65 33 4b 65 79 77 6f 72 64 43 (sqlite3KeywordC
1d820 6f 64 65 28 28 75 38 2a 29 7a 57 6f 72 64 2c 20 ode((u8*)zWord,
1d830 6e 29 21 3d 54 4b 5f 49 44 29 20 3f 20 53 51 4c n)!=TK_ID) ? SQL
1d840 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 44 20 3a 20 ITE_N_KEYWORD :
1d850 30 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0;. break;.
1d860 20 20 20 20 7d 0a 23 65 6e 64 69 66 20 0a 0a 20 }.#endif ..
1d870 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 74 65 /* sqlite3_te
1d880 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 st_control(SQLIT
1d890 45 5f 54 45 53 54 43 54 52 4c 5f 53 43 52 41 54 E_TESTCTRL_SCRAT
1d8a0 43 48 4d 41 4c 4c 4f 43 2c 20 73 7a 2c 20 26 70 CHMALLOC, sz, &p
1d8b0 4e 65 77 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 New, pFree);.
1d8c0 20 2a 2a 0a 20 20 20 20 2a 2a 20 50 61 73 73 20 **. ** Pass
1d8d0 70 46 72 65 65 20 69 6e 74 6f 20 73 71 6c 69 74 pFree into sqlit
1d8e0 65 33 53 63 72 61 74 63 68 46 72 65 65 28 29 2e e3ScratchFree().
1d8f0 20 0a 20 20 20 20 2a 2a 20 49 66 20 73 7a 3e 30 . ** If sz>0
1d900 20 74 68 65 6e 20 61 6c 6c 6f 63 61 74 65 20 61 then allocate a
1d910 20 73 63 72 61 74 63 68 20 62 75 66 66 65 72 20 scratch buffer
1d920 69 6e 74 6f 20 70 4e 65 77 2e 20 20 0a 20 20 20 into pNew. .
1d930 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1d940 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 53 43 52 ITE_TESTCTRL_SCR
1d950 41 54 43 48 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 ATCHMALLOC: {.
1d960 20 20 20 20 76 6f 69 64 20 2a 70 46 72 65 65 2c void *pFree,
1d970 20 2a 2a 70 70 4e 65 77 3b 0a 20 20 20 20 20 20 **ppNew;.
1d980 69 6e 74 20 73 7a 3b 0a 20 20 20 20 20 20 73 7a int sz;. sz
1d990 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
1d9a0 74 29 3b 0a 20 20 20 20 20 20 70 70 4e 65 77 20 t);. ppNew
1d9b0 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 = va_arg(ap, voi
1d9c0 64 2a 2a 29 3b 0a 20 20 20 20 20 20 70 46 72 65 d**);. pFre
1d9d0 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 e = va_arg(ap, v
1d9e0 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 69 66 28 oid*);. if(
1d9f0 20 73 7a 20 29 20 2a 70 70 4e 65 77 20 3d 20 73 sz ) *ppNew = s
1da00 71 6c 69 74 65 33 53 63 72 61 74 63 68 4d 61 6c qlite3ScratchMal
1da10 6c 6f 63 28 73 7a 29 3b 0a 20 20 20 20 20 20 73 loc(sz);. s
1da20 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 65 qlite3ScratchFre
1da30 65 28 70 46 72 65 65 29 3b 0a 20 20 20 20 20 20 e(pFree);.
1da40 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1da50 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 /* sqlite3_t
1da60 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1da70 54 45 5f 54 45 53 54 43 54 52 4c 5f 4c 4f 43 41 TE_TESTCTRL_LOCA
1da80 4c 54 49 4d 45 5f 46 41 55 4c 54 2c 20 69 6e 74 LTIME_FAULT, int
1da90 20 6f 6e 6f 66 66 29 3b 0a 20 20 20 20 2a 2a 0a onoff);. **.
1daa0 20 20 20 20 2a 2a 20 49 66 20 70 61 72 61 6d 65 ** If parame
1dab0 74 65 72 20 6f 6e 6f 66 66 20 69 73 20 6e 6f 6e ter onoff is non
1dac0 2d 7a 65 72 6f 2c 20 63 6f 6e 66 69 67 75 72 65 -zero, configure
1dad0 20 74 68 65 20 77 72 61 70 70 65 72 73 20 73 6f the wrappers so
1dae0 20 74 68 61 74 20 61 6c 6c 0a 20 20 20 20 2a 2a that all. **
1daf0 20 73 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c subsequent call
1db00 73 20 74 6f 20 6c 6f 63 61 6c 74 69 6d 65 28 29 s to localtime()
1db10 20 61 6e 64 20 76 61 72 69 61 6e 74 73 20 66 61 and variants fa
1db20 69 6c 2e 20 49 66 20 6f 6e 6f 66 66 20 69 73 20 il. If onoff is
1db30 7a 65 72 6f 2c 0a 20 20 20 20 2a 2a 20 75 6e 64 zero,. ** und
1db40 6f 20 74 68 69 73 20 73 65 74 74 69 6e 67 2e 0a o this setting..
1db50 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1db60 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1db70 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 55 4c 54 3a LOCALTIME_FAULT:
1db80 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
1db90 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4c 6f GlobalConfig.bLo
1dba0 63 61 6c 74 69 6d 65 46 61 75 6c 74 20 3d 20 76 caltimeFault = v
1dbb0 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
1dbc0 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1dbd0 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c }.. /* sql
1dbe0 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
1dbf0 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
1dc00 4c 5f 4e 45 56 45 52 5f 43 4f 52 52 55 50 54 2c L_NEVER_CORRUPT,
1dc10 20 69 6e 74 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 int);. **.
1dc20 20 20 2a 2a 20 53 65 74 20 6f 72 20 63 6c 65 61 ** Set or clea
1dc30 72 20 61 20 66 6c 61 67 20 74 68 61 74 20 69 6e r a flag that in
1dc40 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 dicates that the
1dc50 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 database file i
1dc60 73 20 61 6c 77 61 79 73 20 77 65 6c 6c 2d 0a 20 s always well-.
1dc70 20 20 20 2a 2a 20 66 6f 72 6d 65 64 20 61 6e 64 ** formed and
1dc80 20 6e 65 76 65 72 20 63 6f 72 72 75 70 74 2e 20 never corrupt.
1dc90 20 54 68 69 73 20 66 6c 61 67 20 69 73 20 63 6c This flag is cl
1dca0 65 61 72 20 62 79 20 64 65 66 61 75 6c 74 2c 20 ear by default,
1dcb0 69 6e 64 69 63 61 74 69 6e 67 20 74 68 61 74 0a indicating that.
1dcc0 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 ** database
1dcd0 66 69 6c 65 73 20 6d 69 67 68 74 20 68 61 76 65 files might have
1dce0 20 61 72 62 69 74 72 61 72 79 20 63 6f 72 72 75 arbitrary corru
1dcf0 70 74 69 6f 6e 2e 20 20 53 65 74 74 69 6e 67 20 ption. Setting
1dd00 74 68 65 20 66 6c 61 67 20 64 75 72 69 6e 67 0a the flag during.
1dd10 20 20 20 20 2a 2a 20 74 65 73 74 69 6e 67 20 63 ** testing c
1dd20 61 75 73 65 73 20 63 65 72 74 61 69 6e 20 61 73 auses certain as
1dd30 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
1dd40 73 20 69 6e 20 74 68 65 20 63 6f 64 65 20 74 6f s in the code to
1dd50 20 62 65 20 61 63 74 69 76 61 74 65 64 0a 20 20 be activated.
1dd60 20 20 2a 2a 20 74 68 61 74 20 64 65 6d 6f 6e 73 ** that demons
1dd70 74 72 61 74 20 69 6e 76 61 72 69 61 6e 74 73 20 trat invariants
1dd80 6f 6e 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 on well-formed d
1dd90 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e 0a 20 atabase files..
1dda0 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1ddb0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4e QLITE_TESTCTRL_N
1ddc0 45 56 45 52 5f 43 4f 52 52 55 50 54 3a 20 7b 0a EVER_CORRUPT: {.
1ddd0 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
1dde0 62 61 6c 43 6f 6e 66 69 67 2e 6e 65 76 65 72 43 balConfig.neverC
1ddf0 6f 72 72 75 70 74 20 3d 20 76 61 5f 61 72 67 28 orrupt = va_arg(
1de00 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 ap, int);.
1de10 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 0a 20 break;. }...
1de20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f /* sqlite3_
1de30 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1de40 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 56 44 42 ITE_TESTCTRL_VDB
1de50 45 5f 43 4f 56 45 52 41 47 45 2c 20 78 43 61 6c E_COVERAGE, xCal
1de60 6c 62 61 63 6b 2c 20 70 74 72 29 3b 0a 20 20 20 lback, ptr);.
1de70 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 74 **. ** Set t
1de80 68 65 20 56 44 42 45 20 63 6f 76 65 72 61 67 65 he VDBE coverage
1de90 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 callback functi
1dea0 6f 6e 20 74 6f 20 78 43 61 6c 6c 62 61 63 6b 20 on to xCallback
1deb0 77 69 74 68 20 63 6f 6e 74 65 78 74 20 0a 20 20 with context .
1dec0 20 20 2a 2a 20 70 6f 69 6e 74 65 72 20 70 74 72 ** pointer ptr
1ded0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
1dee0 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
1def0 4c 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 3a L_VDBE_COVERAGE:
1df00 20 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 {.#ifdef SQLITE
1df10 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 0a 20 _VDBE_COVERAGE.
1df20 20 20 20 20 20 74 79 70 65 64 65 66 20 76 6f 69 typedef voi
1df30 64 20 28 2a 62 72 61 6e 63 68 5f 63 61 6c 6c 62 d (*branch_callb
1df40 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 75 ack)(void*,int,u
1df50 38 2c 75 38 29 3b 0a 20 20 20 20 20 20 73 71 6c 8,u8);. sql
1df60 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1df70 2e 78 56 64 62 65 42 72 61 6e 63 68 20 3d 20 76 .xVdbeBranch = v
1df80 61 5f 61 72 67 28 61 70 2c 62 72 61 6e 63 68 5f a_arg(ap,branch_
1df90 63 61 6c 6c 62 61 63 6b 29 3b 0a 20 20 20 20 20 callback);.
1dfa0 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1dfb0 6e 66 69 67 2e 70 56 64 62 65 42 72 61 6e 63 68 nfig.pVdbeBranch
1dfc0 41 72 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c Arg = va_arg(ap,
1dfd0 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 20 void*);.#endif.
1dfe0 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1dff0 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 }.. /* sqli
1e000 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1e010 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1e020 5f 53 4f 52 54 45 52 5f 4d 4d 41 50 2c 20 64 62 _SORTER_MMAP, db
1e030 2c 20 6e 4d 61 78 29 3b 20 2a 2f 0a 20 20 20 20 , nMax); */.
1e040 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 case SQLITE_TEST
1e050 43 54 52 4c 5f 53 4f 52 54 45 52 5f 4d 4d 41 50 CTRL_SORTER_MMAP
1e060 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
1e070 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 3 *db = va_arg(a
1e080 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 p, sqlite3*);.
1e090 20 20 20 20 64 62 2d 3e 6e 4d 61 78 53 6f 72 74 db->nMaxSort
1e0a0 65 72 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 erMmap = va_arg(
1e0b0 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 ap, int);.
1e0c0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1e0d0 20 20 2f 2a 20 20 20 73 71 6c 69 74 65 33 5f 74 /* sqlite3_t
1e0e0 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1e0f0 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 53 49 4e TE_TESTCTRL_ISIN
1e100 49 54 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 IT);. **.
1e110 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 ** Return SQLITE
1e120 5f 4f 4b 20 69 66 20 53 51 4c 69 74 65 20 68 61 _OK if SQLite ha
1e130 73 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 7a s been initializ
1e140 65 64 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 52 ed and SQLITE_ER
1e150 52 4f 52 20 69 66 0a 20 20 20 20 2a 2a 20 6e 6f ROR if. ** no
1e160 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 t.. */. ca
1e170 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1e180 52 4c 5f 49 53 49 4e 49 54 3a 20 7b 0a 20 20 20 RL_ISINIT: {.
1e190 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c if( sqlite3Gl
1e1a0 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 obalConfig.isIni
1e1b0 74 3d 3d 30 20 29 20 72 63 20 3d 20 53 51 4c 49 t==0 ) rc = SQLI
1e1c0 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 TE_ERROR;.
1e1d0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1e1e0 20 20 2f 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 /* sqlite3_te
1e1f0 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 st_control(SQLIT
1e200 45 5f 54 45 53 54 43 54 52 4c 5f 49 4d 50 4f 53 E_TESTCTRL_IMPOS
1e210 54 45 52 2c 20 64 62 2c 20 64 62 4e 61 6d 65 2c TER, db, dbName,
1e220 20 6f 6e 4f 66 66 2c 20 74 6e 75 6d 29 3b 0a 20 onOff, tnum);.
1e230 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 **. ** Thi
1e240 73 20 74 65 73 74 20 63 6f 6e 74 72 6f 6c 20 69 s test control i
1e250 73 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 s used to create
1e260 20 69 6d 70 6f 73 74 65 72 20 74 61 62 6c 65 73 imposter tables
1e270 2e 20 20 22 64 62 22 20 69 73 20 61 20 70 6f 69 . "db" is a poi
1e280 6e 74 65 72 0a 20 20 20 20 2a 2a 20 74 6f 20 74 nter. ** to t
1e290 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e he database conn
1e2a0 65 63 74 69 6f 6e 2e 20 20 64 62 4e 61 6d 65 20 ection. dbName
1e2b0 69 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 is the database
1e2c0 6e 61 6d 65 20 28 65 78 3a 20 22 6d 61 69 6e 22 name (ex: "main"
1e2d0 20 6f 72 0a 20 20 20 20 2a 2a 20 22 74 65 6d 70 or. ** "temp
1e2e0 22 29 20 77 68 69 63 68 20 77 69 6c 6c 20 72 65 ") which will re
1e2f0 63 65 69 76 65 20 74 68 65 20 69 6d 70 6f 73 74 ceive the impost
1e300 65 72 2e 20 20 22 6f 6e 4f 66 66 22 20 74 75 72 er. "onOff" tur
1e310 6e 73 20 69 6d 70 6f 73 74 65 72 20 6d 6f 64 65 ns imposter mode
1e320 20 6f 6e 0a 20 20 20 20 2a 2a 20 6f 72 20 6f 66 on. ** or of
1e330 66 2e 20 20 22 74 6e 75 6d 22 20 69 73 20 74 68 f. "tnum" is th
1e340 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 e root page of t
1e350 68 65 20 62 2d 74 72 65 65 20 74 6f 20 77 68 69 he b-tree to whi
1e360 63 68 20 74 68 65 20 69 6d 70 6f 73 74 65 72 0a ch the imposter.
1e370 20 20 20 20 2a 2a 20 74 61 62 6c 65 20 73 68 6f ** table sho
1e380 75 6c 64 20 63 6f 6e 6e 65 63 74 2e 0a 20 20 20 uld connect..
1e390 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 6e 61 62 6c **. ** Enabl
1e3a0 65 20 69 6d 70 6f 73 74 65 72 20 6d 6f 64 65 20 e imposter mode
1e3b0 6f 6e 6c 79 20 77 68 65 6e 20 74 68 65 20 73 63 only when the sc
1e3c0 68 65 6d 61 20 68 61 73 20 61 6c 72 65 61 64 79 hema has already
1e3d0 20 62 65 65 6e 20 70 61 72 73 65 64 2e 20 20 54 been parsed. T
1e3e0 68 65 6e 0a 20 20 20 20 2a 2a 20 72 75 6e 20 61 hen. ** run a
1e3f0 20 73 69 6e 67 6c 65 20 43 52 45 41 54 45 20 54 single CREATE T
1e400 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 74 ABLE statement t
1e410 6f 20 63 6f 6e 73 74 72 75 63 74 20 74 68 65 20 o construct the
1e420 69 6d 70 6f 73 74 65 72 20 74 61 62 6c 65 20 69 imposter table i
1e430 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 70 61 72 n. ** the par
1e440 73 65 64 20 73 63 68 65 6d 61 2e 20 20 54 68 65 sed schema. The
1e450 6e 20 74 75 72 6e 20 69 6d 70 6f 73 74 65 72 20 n turn imposter
1e460 6d 6f 64 65 20 62 61 63 6b 20 6f 66 66 20 61 67 mode back off ag
1e470 61 69 6e 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ain.. **.
1e480 2a 2a 20 49 66 20 6f 6e 4f 66 66 3d 3d 30 20 61 ** If onOff==0 a
1e490 6e 64 20 74 6e 75 6d 3e 30 20 74 68 65 6e 20 72 nd tnum>0 then r
1e4a0 65 73 65 74 20 74 68 65 20 73 63 68 65 6d 61 20 eset the schema
1e4b0 66 6f 72 20 61 6c 6c 20 64 61 74 61 62 61 73 65 for all database
1e4c0 73 2c 20 63 61 75 73 69 6e 67 0a 20 20 20 20 2a s, causing. *
1e4d0 2a 20 74 68 65 20 73 63 68 65 6d 61 20 74 6f 20 * the schema to
1e4e0 62 65 20 72 65 70 61 72 73 65 64 20 74 68 65 20 be reparsed the
1e4f0 6e 65 78 74 20 74 69 6d 65 20 69 74 20 69 73 20 next time it is
1e500 6e 65 65 64 65 64 2e 20 20 54 68 69 73 20 68 61 needed. This ha
1e510 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 65 66 66 s the. ** eff
1e520 65 63 74 20 6f 66 20 65 72 61 73 69 6e 67 20 61 ect of erasing a
1e530 6c 6c 20 69 6d 70 6f 73 74 65 72 20 74 61 62 6c ll imposter tabl
1e540 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 es.. */. c
1e550 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1e560 54 52 4c 5f 49 4d 50 4f 53 54 45 52 3a 20 7b 0a TRL_IMPOSTER: {.
1e570 20 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 sqlite3 *d
1e580 62 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 73 b = va_arg(ap, s
1e590 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 20 20 qlite3*);.
1e5a0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
1e5b0 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
1e5c0 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 db->init.i
1e5d0 44 62 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 Db = sqlite3Find
1e5e0 44 62 4e 61 6d 65 28 64 62 2c 20 76 61 5f 61 72 DbName(db, va_ar
1e5f0 67 28 61 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a g(ap,const char*
1e600 29 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 69 6e ));. db->in
1e610 69 74 2e 62 75 73 79 20 3d 20 64 62 2d 3e 69 6e it.busy = db->in
1e620 69 74 2e 69 6d 70 6f 73 74 65 72 54 61 62 6c 65 it.imposterTable
1e630 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 = va_arg(ap,int
1e640 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 69 6e 69 );. db->ini
1e650 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 76 61 5f 61 t.newTnum = va_a
1e660 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 20 rg(ap,int);.
1e670 20 20 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 62 if( db->init.b
1e680 75 73 79 3d 3d 30 20 26 26 20 64 62 2d 3e 69 6e usy==0 && db->in
1e690 69 74 2e 6e 65 77 54 6e 75 6d 3e 30 20 29 7b 0a it.newTnum>0 ){.
1e6a0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 sqlite3R
1e6b0 65 73 65 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 esetAllSchemasOf
1e6c0 43 6f 6e 6e 65 63 74 69 6f 6e 28 64 62 29 3b 0a Connection(db);.
1e6d0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 }. sq
1e6e0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1e6f0 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
1e700 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1e710 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 . }. va_end(ap
1e720 29 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c );.#endif /* SQL
1e730 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e ITE_OMIT_BUILTIN
1e740 5f 54 45 53 54 20 2a 2f 0a 20 20 72 65 74 75 72 _TEST */. retur
1e750 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
1e760 68 69 73 20 69 73 20 61 20 75 74 69 6c 69 74 79 his is a utility
1e770 20 72 6f 75 74 69 6e 65 2c 20 75 73 65 66 75 6c routine, useful
1e780 20 74 6f 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e to VFS implemen
1e790 74 61 74 69 6f 6e 73 2c 20 74 68 61 74 20 63 68 tations, that ch
1e7a0 65 63 6b 73 0a 2a 2a 20 74 6f 20 73 65 65 20 69 ecks.** to see i
1e7b0 66 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c f a database fil
1e7c0 65 20 77 61 73 20 61 20 55 52 49 20 74 68 61 74 e was a URI that
1e7d0 20 63 6f 6e 74 61 69 6e 65 64 20 61 20 73 70 65 contained a spe
1e7e0 63 69 66 69 63 20 71 75 65 72 79 20 0a 2a 2a 20 cific query .**
1e7f0 70 61 72 61 6d 65 74 65 72 2c 20 61 6e 64 20 69 parameter, and i
1e800 66 20 73 6f 20 6f 62 74 61 69 6e 73 20 74 68 65 f so obtains the
1e810 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 71 75 value of the qu
1e820 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a ery parameter..*
1e830 2a 0a 2a 2a 20 54 68 65 20 7a 46 69 6c 65 6e 61 *.** The zFilena
1e840 6d 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 me argument is t
1e850 68 65 20 66 69 6c 65 6e 61 6d 65 20 70 6f 69 6e he filename poin
1e860 74 65 72 20 70 61 73 73 65 64 20 69 6e 74 6f 20 ter passed into
1e870 74 68 65 20 78 4f 70 65 6e 28 29 0a 2a 2a 20 6d the xOpen().** m
1e880 65 74 68 6f 64 20 6f 66 20 61 20 56 46 53 20 69 ethod of a VFS i
1e890 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 mplementation.
1e8a0 54 68 65 20 7a 50 61 72 61 6d 20 61 72 67 75 6d The zParam argum
1e8b0 65 6e 74 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ent is the name
1e8c0 6f 66 20 74 68 65 0a 2a 2a 20 71 75 65 72 79 20 of the.** query
1e8d0 70 61 72 61 6d 65 74 65 72 20 77 65 20 73 65 65 parameter we see
1e8e0 6b 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 k. This routine
1e8f0 20 72 65 74 75 72 6e 73 20 74 68 65 20 76 61 6c returns the val
1e900 75 65 20 6f 66 20 74 68 65 20 7a 50 61 72 61 6d ue of the zParam
1e910 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 66 .** parameter if
1e920 20 69 74 20 65 78 69 73 74 73 2e 20 20 49 66 20 it exists. If
1e930 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 64 6f the parameter do
1e940 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 74 68 es not exist, th
1e950 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 is routine.** re
1e960 74 75 72 6e 73 20 61 20 4e 55 4c 4c 20 70 6f 69 turns a NULL poi
1e970 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 nter..*/.const c
1e980 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 75 72 69 har *sqlite3_uri
1e990 5f 70 61 72 61 6d 65 74 65 72 28 63 6f 6e 73 74 _parameter(const
1e9a0 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
1e9b0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 , const char *zP
1e9c0 61 72 61 6d 29 7b 0a 20 20 69 66 28 20 7a 46 69 aram){. if( zFi
1e9d0 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 7a 50 61 lename==0 || zPa
1e9e0 72 61 6d 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 ram==0 ) return
1e9f0 30 3b 0a 20 20 7a 46 69 6c 65 6e 61 6d 65 20 2b 0;. zFilename +
1ea00 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 = sqlite3Strlen3
1ea10 30 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 31 0(zFilename) + 1
1ea20 3b 0a 20 20 77 68 69 6c 65 28 20 7a 46 69 6c 65 ;. while( zFile
1ea30 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 69 name[0] ){. i
1ea40 6e 74 20 78 20 3d 20 73 74 72 63 6d 70 28 7a 46 nt x = strcmp(zF
1ea50 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 72 61 6d 29 ilename, zParam)
1ea60 3b 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 ;. zFilename
1ea70 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e += sqlite3Strlen
1ea80 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 30(zFilename) +
1ea90 31 3b 0a 20 20 20 20 69 66 28 20 78 3d 3d 30 20 1;. if( x==0
1eaa0 29 20 72 65 74 75 72 6e 20 7a 46 69 6c 65 6e 61 ) return zFilena
1eab0 6d 65 3b 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d me;. zFilenam
1eac0 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 6c e += sqlite3Strl
1ead0 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 20 en30(zFilename)
1eae0 2b 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 + 1;. }. retur
1eaf0 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 n 0;.}../*.** Re
1eb00 74 75 72 6e 20 61 20 62 6f 6f 6c 65 61 6e 20 76 turn a boolean v
1eb10 61 6c 75 65 20 66 6f 72 20 61 20 71 75 65 72 79 alue for a query
1eb20 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 69 parameter..*/.i
1eb30 6e 74 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 62 nt sqlite3_uri_b
1eb40 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 oolean(const cha
1eb50 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 63 6f r *zFilename, co
1eb60 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 72 61 6d nst char *zParam
1eb70 2c 20 69 6e 74 20 62 44 66 6c 74 29 7b 0a 20 20 , int bDflt){.
1eb80 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 const char *z =
1eb90 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 sqlite3_uri_para
1eba0 6d 65 74 65 72 28 7a 46 69 6c 65 6e 61 6d 65 2c meter(zFilename,
1ebb0 20 7a 50 61 72 61 6d 29 3b 0a 20 20 62 44 66 6c zParam);. bDfl
1ebc0 74 20 3d 20 62 44 66 6c 74 21 3d 30 3b 0a 20 20 t = bDflt!=0;.
1ebd0 72 65 74 75 72 6e 20 7a 20 3f 20 73 71 6c 69 74 return z ? sqlit
1ebe0 65 33 47 65 74 42 6f 6f 6c 65 61 6e 28 7a 2c 20 e3GetBoolean(z,
1ebf0 62 44 66 6c 74 29 20 3a 20 62 44 66 6c 74 3b 0a bDflt) : bDflt;.
1ec00 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
1ec10 61 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 a 64-bit integer
1ec20 20 76 61 6c 75 65 20 66 6f 72 20 61 20 71 75 65 value for a que
1ec30 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2f ry parameter..*/
1ec40 0a 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 .sqlite3_int64 s
1ec50 71 6c 69 74 65 33 5f 75 72 69 5f 69 6e 74 36 34 qlite3_uri_int64
1ec60 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
1ec70 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a zFilename, /*
1ec80 20 46 69 6c 65 6e 61 6d 65 20 61 73 20 70 61 73 Filename as pas
1ec90 73 65 64 20 74 6f 20 78 4f 70 65 6e 20 2a 2f 0a sed to xOpen */.
1eca0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 const char *zP
1ecb0 61 72 61 6d 2c 20 20 20 20 20 20 20 2f 2a 20 55 aram, /* U
1ecc0 52 49 20 70 61 72 61 6d 65 74 65 72 20 73 6f 75 RI parameter sou
1ecd0 67 68 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ght */. sqlite3
1ece0 5f 69 6e 74 36 34 20 62 44 66 6c 74 20 20 20 20 _int64 bDflt
1ecf0 20 20 20 2f 2a 20 72 65 74 75 72 6e 20 69 66 20 /* return if
1ed00 70 61 72 61 6d 65 74 65 72 20 69 73 20 6d 69 73 parameter is mis
1ed10 73 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e sing */.){. con
1ed20 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c st char *z = sql
1ed30 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 ite3_uri_paramet
1ed40 65 72 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 er(zFilename, zP
1ed50 61 72 61 6d 29 3b 0a 20 20 73 71 6c 69 74 65 33 aram);. sqlite3
1ed60 5f 69 6e 74 36 34 20 76 3b 0a 20 20 69 66 28 20 _int64 v;. if(
1ed70 7a 20 26 26 20 73 71 6c 69 74 65 33 44 65 63 4f z && sqlite3DecO
1ed80 72 48 65 78 54 6f 49 36 34 28 7a 2c 20 26 76 29 rHexToI64(z, &v)
1ed90 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1eda0 20 20 20 62 44 66 6c 74 20 3d 20 76 3b 0a 20 20 bDflt = v;.
1edb0 7d 0a 20 20 72 65 74 75 72 6e 20 62 44 66 6c 74 }. return bDflt
1edc0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
1edd0 6e 20 74 68 65 20 42 74 72 65 65 20 70 6f 69 6e n the Btree poin
1ede0 74 65 72 20 69 64 65 6e 74 69 66 69 65 64 20 62 ter identified b
1edf0 79 20 7a 44 62 4e 61 6d 65 2e 20 20 52 65 74 75 y zDbName. Retu
1ee00 72 6e 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 20 66 rn NULL if not f
1ee10 6f 75 6e 64 2e 0a 2a 2f 0a 42 74 72 65 65 20 2a ound..*/.Btree *
1ee20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 sqlite3DbNameToB
1ee30 74 72 65 65 28 73 71 6c 69 74 65 33 20 2a 64 62 tree(sqlite3 *db
1ee40 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 , const char *zD
1ee50 62 4e 61 6d 65 29 7b 0a 20 20 69 6e 74 20 69 3b bName){. int i;
1ee60 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 . for(i=0; i<db
1ee70 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 ->nDb; i++){.
1ee80 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e if( db->aDb[i].
1ee90 70 42 74 0a 20 20 20 20 20 26 26 20 28 7a 44 62 pBt. && (zDb
1eea0 4e 61 6d 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 Name==0 || sqlit
1eeb0 65 33 53 74 72 49 43 6d 70 28 7a 44 62 4e 61 6d e3StrICmp(zDbNam
1eec0 65 2c 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 7a 4e e, db->aDb[i].zN
1eed0 61 6d 65 29 3d 3d 30 29 0a 20 20 20 20 29 7b 0a ame)==0). ){.
1eee0 20 20 20 20 20 20 72 65 74 75 72 6e 20 64 62 2d return db-
1eef0 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 >aDb[i].pBt;.
1ef00 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
1ef10 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
1ef20 72 6e 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 rn the filename
1ef30 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
1ef40 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
1ef50 61 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f a database.** co
1ef60 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 63 6f 6e nnection..*/.con
1ef70 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
1ef80 5f 64 62 5f 66 69 6c 65 6e 61 6d 65 28 73 71 6c _db_filename(sql
1ef90 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 ite3 *db, const
1efa0 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a char *zDbName){.
1efb0 20 20 42 74 72 65 65 20 2a 70 42 74 3b 0a 23 69 Btree *pBt;.#i
1efc0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
1efd0 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 LE_API_ARMOR. i
1efe0 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
1eff0 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a yCheckOk(db) ){.
1f000 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 (void)SQLITE
1f010 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 _MISUSE_BKPT;.
1f020 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a return 0;. }.
1f030 23 65 6e 64 69 66 0a 20 20 70 42 74 20 3d 20 73 #endif. pBt = s
1f040 71 6c 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 qlite3DbNameToBt
1f050 72 65 65 28 64 62 2c 20 7a 44 62 4e 61 6d 65 29 ree(db, zDbName)
1f060 3b 0a 20 20 72 65 74 75 72 6e 20 70 42 74 20 3f ;. return pBt ?
1f070 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
1f080 46 69 6c 65 6e 61 6d 65 28 70 42 74 29 20 3a 20 Filename(pBt) :
1f090 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
1f0a0 72 6e 20 31 20 69 66 20 64 61 74 61 62 61 73 65 rn 1 if database
1f0b0 20 69 73 20 72 65 61 64 2d 6f 6e 6c 79 20 6f 72 is read-only or
1f0c0 20 30 20 69 66 20 72 65 61 64 2f 77 72 69 74 65 0 if read/write
1f0d0 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 69 66 0a . Return -1 if.
1f0e0 2a 2a 20 6e 6f 20 73 75 63 68 20 64 61 74 61 62 ** no such datab
1f0f0 61 73 65 20 65 78 69 73 74 73 2e 0a 2a 2f 0a 69 ase exists..*/.i
1f100 6e 74 20 73 71 6c 69 74 65 33 5f 64 62 5f 72 65 nt sqlite3_db_re
1f110 61 64 6f 6e 6c 79 28 73 71 6c 69 74 65 33 20 2a adonly(sqlite3 *
1f120 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
1f130 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 42 74 72 65 zDbName){. Btre
1f140 65 20 2a 70 42 74 3b 0a 23 69 66 64 65 66 20 53 e *pBt;.#ifdef S
1f150 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
1f160 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
1f170 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
1f180 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 Ok(db) ){. (v
1f190 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 oid)SQLITE_MISUS
1f1a0 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 E_BKPT;. retu
1f1b0 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 65 6e 64 69 rn -1;. }.#endi
1f1c0 66 0a 20 20 70 42 74 20 3d 20 73 71 6c 69 74 65 f. pBt = sqlite
1f1d0 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 64 3DbNameToBtree(d
1f1e0 62 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 72 b, zDbName);. r
1f1f0 65 74 75 72 6e 20 70 42 74 20 3f 20 73 71 6c 69 eturn pBt ? sqli
1f200 74 65 33 42 74 72 65 65 49 73 52 65 61 64 6f 6e te3BtreeIsReadon
1f210 6c 79 28 70 42 74 29 20 3a 20 2d 31 3b 0a 7d 0a ly(pBt) : -1;.}.
1f220 0a 23 69 66 20 28 53 51 4c 49 54 45 5f 45 4e 41 .#if (SQLITE_ENA
1f230 42 4c 45 5f 41 50 50 4c 45 5f 53 50 49 3e 30 29 BLE_APPLE_SPI>0)
1f240 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 && defined(__AP
1f250 50 4c 45 5f 5f 29 0a 0a 23 69 6e 63 6c 75 64 65 PLE__)..#include
1f260 20 22 73 71 6c 69 74 65 33 5f 70 72 69 76 61 74 "sqlite3_privat
1f270 65 2e 68 22 0a 0a 2f 2a 20 0a 2a 2a 20 54 65 73 e.h"../* .** Tes
1f280 74 69 6e 67 20 61 20 66 69 6c 65 20 70 61 74 68 ting a file path
1f290 20 66 6f 72 20 73 71 6c 69 74 65 20 6c 6f 63 6b for sqlite lock
1f2a0 73 20 68 65 6c 64 20 62 79 20 61 20 70 72 6f 63 s held by a proc
1f2b0 65 73 73 20 49 44 2e 20 0a 2a 2a 20 52 65 74 75 ess ID. .** Retu
1f2c0 72 6e 73 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 53 rns SQLITE_LOCKS
1f2d0 54 41 54 45 5f 4f 4e 20 69 66 20 6c 6f 63 6b 73 TATE_ON if locks
1f2e0 20 61 72 65 20 70 72 65 73 65 6e 74 20 6f 6e 20 are present on
1f2f0 70 61 74 68 0a 2a 2a 20 74 68 61 74 20 77 6f 75 path.** that wou
1f300 6c 64 20 70 72 65 76 65 6e 74 20 77 72 69 74 69 ld prevent writi
1f310 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ng to the databa
1f320 73 65 2e 0a 2a 2f 0a 69 6e 74 20 5f 73 71 6c 69 se..*/.int _sqli
1f330 74 65 33 5f 6c 6f 63 6b 73 74 61 74 65 28 63 6f te3_lockstate(co
1f340 6e 73 74 20 63 68 61 72 20 2a 70 61 74 68 2c 20 nst char *path,
1f350 70 69 64 5f 74 20 70 69 64 29 7b 0a 20 20 73 71 pid_t pid){. sq
1f360 6c 69 74 65 33 20 2a 64 62 20 3d 20 4e 55 4c 4c lite3 *db = NULL
1f370 3b 0a 20 20 0a 20 20 69 66 28 20 73 71 6c 69 74 ;. . if( sqlit
1f380 65 33 5f 6f 70 65 6e 5f 76 32 28 70 61 74 68 2c e3_open_v2(path,
1f390 20 26 64 62 2c 20 53 51 4c 49 54 45 5f 4f 50 45 &db, SQLITE_OPE
1f3a0 4e 5f 52 45 41 44 4f 4e 4c 59 2c 20 4e 55 4c 4c N_READONLY, NULL
1f3b0 29 20 3d 3d 20 53 51 4c 49 54 45 5f 4f 4b 20 29 ) == SQLITE_OK )
1f3c0 7b 0a 20 20 20 20 4c 6f 63 6b 73 74 61 74 65 50 {. LockstateP
1f3d0 49 44 20 6c 6f 63 6b 73 74 61 74 65 20 3d 20 7b ID lockstate = {
1f3e0 70 69 64 2c 20 2d 31 7d 3b 0a 20 20 20 20 73 71 pid, -1};. sq
1f3f0 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
1f400 6f 6c 28 64 62 2c 20 4e 55 4c 4c 2c 20 53 51 4c ol(db, NULL, SQL
1f410 49 54 45 5f 46 43 4e 54 4c 5f 4c 4f 43 4b 53 54 ITE_FCNTL_LOCKST
1f420 41 54 45 5f 50 49 44 2c 20 26 6c 6f 63 6b 73 74 ATE_PID, &lockst
1f430 61 74 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 ate);. sqlite
1f440 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 3_close(db);.
1f450 20 69 6e 74 20 73 74 61 74 65 20 3d 20 6c 6f 63 int state = loc
1f460 6b 73 74 61 74 65 2e 73 74 61 74 65 3b 0a 20 20 kstate.state;.
1f470 20 20 72 65 74 75 72 6e 20 73 74 61 74 65 3b 0a return state;.
1f480 20 20 7d 0a 20 20 69 66 28 20 4e 55 4c 4c 21 3d }. if( NULL!=
1f490 64 62 20 29 7b 20 0a 20 20 20 20 73 71 6c 69 74 db ){ . sqlit
1f4a0 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b 20 2f 2a e3_close(db); /*
1f4b0 20 6e 65 65 64 20 74 6f 20 63 6c 6f 73 65 20 65 need to close e
1f4c0 76 65 6e 20 69 66 20 6f 70 65 6e 20 72 65 74 75 ven if open retu
1f4d0 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a rns an error */.
1f4e0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
1f4f0 49 54 45 5f 4c 4f 43 4b 53 54 41 54 45 5f 45 52 ITE_LOCKSTATE_ER
1f500 52 4f 52 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f ROR;.}..#endif /
1f510 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f * SQLITE_ENABLE_
1f520 41 50 50 4c 45 5f 53 50 49 20 2a 2f 0a APPLE_SPI */.