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 53 51 4c 49 54 y only..*/.SQLIT
0900: 45 5f 41 50 49 20 76 6f 69 64 20 28 53 51 4c 49 E_API void (SQLI
0910: 54 45 5f 43 44 45 43 4c 20 2a 73 71 6c 69 74 65 TE_CDECL *sqlite
0920: 33 49 6f 54 72 61 63 65 29 28 63 6f 6e 73 74 20 3IoTrace)(const
0930: 63 68 61 72 2a 2c 20 2e 2e 2e 29 20 3d 20 30 3b char*, ...) = 0;
0940: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
0950: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
0960: 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 global variable
0970: 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 72 69 points to a stri
0980: 6e 67 20 77 68 69 63 68 20 69 73 20 74 68 65 0a ng which is the.
0990: 2a 2a 20 6e 61 6d 65 20 6f 66 20 61 20 64 69 72 ** name of a dir
09a0: 65 63 74 6f 72 79 2c 20 74 68 65 6e 20 74 68 61 ectory, then tha
09b0: 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 6c 6c t directory will
09c0: 20 62 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 be used to stor
09d0: 65 0a 2a 2a 20 74 65 6d 70 6f 72 61 72 79 20 66 e.** temporary f
09e0: 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 iles..**.** See
09f0: 61 6c 73 6f 20 74 68 65 20 22 50 52 41 47 4d 41 also the "PRAGMA
0a00: 20 74 65 6d 70 5f 73 74 6f 72 65 5f 64 69 72 65 temp_store_dire
0a10: 63 74 6f 72 79 22 20 53 51 4c 20 63 6f 6d 6d 61 ctory" SQL comma
0a20: 6e 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c nd..*/.char *sql
0a30: 69 74 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 74 ite3_temp_direct
0a40: 6f 72 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 ory = 0;../*.**
0a50: 49 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 If the following
0a60: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 global variable
0a70: 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 72 points to a str
0a80: 69 6e 67 20 77 68 69 63 68 20 69 73 20 74 68 65 ing which is the
0a90: 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 61 20 64 69 .** name of a di
0aa0: 72 65 63 74 6f 72 79 2c 20 74 68 65 6e 20 74 68 rectory, then th
0ab0: 61 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 6c at directory wil
0ac0: 6c 20 62 65 20 75 73 65 64 20 74 6f 20 73 74 6f l be used to sto
0ad0: 72 65 0a 2a 2a 20 61 6c 6c 20 64 61 74 61 62 61 re.** all databa
0ae0: 73 65 20 66 69 6c 65 73 20 73 70 65 63 69 66 69 se files specifi
0af0: 65 64 20 77 69 74 68 20 61 20 72 65 6c 61 74 69 ed with a relati
0b00: 76 65 20 70 61 74 68 6e 61 6d 65 2e 0a 2a 2a 0a ve pathname..**.
0b10: 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 68 65 20 ** See also the
0b20: 22 50 52 41 47 4d 41 20 64 61 74 61 5f 73 74 6f "PRAGMA data_sto
0b30: 72 65 5f 64 69 72 65 63 74 6f 72 79 22 20 53 51 re_directory" SQ
0b40: 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f 0a 63 68 L command..*/.ch
0b50: 61 72 20 2a 73 71 6c 69 74 65 33 5f 64 61 74 61 ar *sqlite3_data
0b60: 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 3b 0a _directory = 0;.
0b70: 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a ./*.** Initializ
0b80: 65 20 53 51 4c 69 74 65 2e 20 20 0a 2a 2a 0a 2a e SQLite. .**.*
0b90: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d * This routine m
0ba0: 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 74 6f ust be called to
0bb0: 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 initialize the
0bc0: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
0bd0: 6e 2c 0a 2a 2a 20 56 46 53 2c 20 61 6e 64 20 6d n,.** VFS, and m
0be0: 75 74 65 78 20 73 75 62 73 79 73 74 65 6d 73 20 utex subsystems
0bf0: 70 72 69 6f 72 20 74 6f 20 64 6f 69 6e 67 20 61 prior to doing a
0c00: 6e 79 20 73 65 72 69 6f 75 73 20 77 6f 72 6b 20 ny serious work
0c10: 77 69 74 68 0a 2a 2a 20 53 51 4c 69 74 65 2e 20 with.** SQLite.
0c20: 20 42 75 74 20 61 73 20 6c 6f 6e 67 20 61 73 20 But as long as
0c30: 79 6f 75 20 64 6f 20 6e 6f 74 20 63 6f 6d 70 69 you do not compi
0c40: 6c 65 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4f le with SQLITE_O
0c50: 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 2a 2a 20 MIT_AUTOINIT.**
0c60: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c this routine wil
0c70: 6c 20 62 65 20 63 61 6c 6c 65 64 20 61 75 74 6f l be called auto
0c80: 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 6b 65 79 matically by key
0c90: 20 72 6f 75 74 69 6e 65 73 20 73 75 63 68 20 61 routines such a
0ca0: 73 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 s.** sqlite3_ope
0cb0: 6e 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 n(). .**.** Thi
0cc0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e s routine is a n
0cd0: 6f 2d 6f 70 20 65 78 63 65 70 74 20 6f 6e 20 69 o-op except on i
0ce0: 74 73 20 76 65 72 79 20 66 69 72 73 74 20 63 61 ts very first ca
0cf0: 6c 6c 20 66 6f 72 20 74 68 65 20 70 72 6f 63 65 ll for the proce
0d00: 73 73 2c 0a 2a 2a 20 6f 72 20 66 6f 72 20 74 68 ss,.** or for th
0d10: 65 20 66 69 72 73 74 20 63 61 6c 6c 20 61 66 74 e first call aft
0d20: 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c er a call to sql
0d30: 69 74 65 33 5f 73 68 75 74 64 6f 77 6e 2e 0a 2a ite3_shutdown..*
0d40: 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 74 *.** The first t
0d50: 68 72 65 61 64 20 74 6f 20 63 61 6c 6c 20 74 68 hread to call th
0d60: 69 73 20 72 6f 75 74 69 6e 65 20 72 75 6e 73 20 is routine runs
0d70: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 the initializati
0d80: 6f 6e 20 74 6f 0a 2a 2a 20 63 6f 6d 70 6c 65 74 on to.** complet
0d90: 69 6f 6e 2e 20 20 49 66 20 73 75 62 73 65 71 75 ion. If subsequ
0da0: 65 6e 74 20 74 68 72 65 61 64 73 20 63 61 6c 6c ent threads call
0db0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 62 65 this routine be
0dc0: 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 0a 2a fore the first.*
0dd0: 2a 20 74 68 72 65 61 64 20 68 61 73 20 66 69 6e * thread has fin
0de0: 69 73 68 65 64 20 74 68 65 20 69 6e 69 74 69 61 ished the initia
0df0: 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 lization process
0e00: 2c 20 74 68 65 6e 20 74 68 65 20 73 75 62 73 65 , then the subse
0e10: 71 75 65 6e 74 0a 2a 2a 20 74 68 72 65 61 64 73 quent.** threads
0e20: 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e 74 69 must block unti
0e30: 6c 20 74 68 65 20 66 69 72 73 74 20 74 68 72 65 l the first thre
0e40: 61 64 20 66 69 6e 69 73 68 65 73 20 77 69 74 68 ad finishes with
0e50: 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 the initializat
0e60: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 ion..**.** The f
0e70: 69 72 73 74 20 74 68 72 65 61 64 20 6d 69 67 68 irst thread migh
0e80: 74 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 t call this rout
0e90: 69 6e 65 20 72 65 63 75 72 73 69 76 65 6c 79 2e ine recursively.
0ea0: 20 20 52 65 63 75 72 73 69 76 65 0a 2a 2a 20 63 Recursive.** c
0eb0: 61 6c 6c 73 20 74 6f 20 74 68 69 73 20 72 6f 75 alls to this rou
0ec0: 74 69 6e 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20 tine should not
0ed0: 62 6c 6f 63 6b 2c 20 6f 66 20 63 6f 75 72 73 65 block, of course
0ee0: 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 . Otherwise the
0ef0: 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 .** initializati
0f00: 6f 6e 20 70 72 6f 63 65 73 73 20 77 6f 75 6c 64 on process would
0f10: 20 6e 65 76 65 72 20 63 6f 6d 70 6c 65 74 65 2e never complete.
0f20: 0a 2a 2a 0a 2a 2a 20 4c 65 74 20 58 20 62 65 20 .**.** Let X be
0f30: 74 68 65 20 66 69 72 73 74 20 74 68 72 65 61 64 the first thread
0f40: 20 74 6f 20 65 6e 74 65 72 20 74 68 69 73 20 72 to enter this r
0f50: 6f 75 74 69 6e 65 2e 20 20 4c 65 74 20 59 20 62 outine. Let Y b
0f60: 65 20 73 6f 6d 65 20 6f 74 68 65 72 0a 2a 2a 20 e some other.**
0f70: 74 68 72 65 61 64 2e 20 20 54 68 65 6e 20 77 68 thread. Then wh
0f80: 69 6c 65 20 74 68 65 20 69 6e 69 74 69 61 6c 20 ile the initial
0f90: 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 20 74 68 invocation of th
0fa0: 69 73 20 72 6f 75 74 69 6e 65 20 62 79 20 58 20 is routine by X
0fb0: 69 73 0a 2a 2a 20 69 6e 63 6f 6d 70 6c 65 74 65 is.** incomplete
0fc0: 2c 20 69 74 20 69 73 20 72 65 71 75 69 72 65 64 , it is required
0fd0: 20 74 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 that:.**.**
0fe0: 2a 20 20 43 61 6c 6c 73 20 74 6f 20 74 68 69 73 * Calls to this
0ff0: 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 59 20 routine from Y
1000: 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e 74 69 6c must block until
1010: 20 74 68 65 20 6f 75 74 65 72 2d 6d 6f 73 74 0a the outer-most.
1020: 2a 2a 20 20 20 20 20 20 20 63 61 6c 6c 20 62 79 ** call by
1030: 20 58 20 63 6f 6d 70 6c 65 74 65 73 2e 0a 2a 2a X completes..**
1040: 0a 2a 2a 20 20 20 20 2a 20 20 52 65 63 75 72 73 .** * Recurs
1050: 69 76 65 20 63 61 6c 6c 73 20 74 6f 20 74 68 69 ive calls to thi
1060: 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 74 s routine from t
1070: 68 72 65 61 64 20 58 20 72 65 74 75 72 6e 20 69 hread X return i
1080: 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a 20 20 20 mmediately.**
1090: 20 20 20 20 77 69 74 68 6f 75 74 20 62 6c 6f 63 without bloc
10a0: 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c king..*/.int sql
10b0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
10c0: 76 6f 69 64 29 7b 0a 20 20 4d 55 54 45 58 5f 4c void){. MUTEX_L
10d0: 4f 47 49 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 OGIC( sqlite3_mu
10e0: 74 65 78 20 2a 70 4d 61 73 74 65 72 3b 20 29 20 tex *pMaster; )
10f0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 69 /* The mai
1100: 6e 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 2a n static mutex *
1110: 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 /. int 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 20 20 20 20 20
1140: 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 /* Result code
1150: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
1160: 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 20 69 6e _EXTRA_INIT. in
1170: 74 20 62 52 75 6e 45 78 74 72 61 49 6e 69 74 20 t bRunExtraInit
1180: 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 0;
1190: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 /* Ex
11a0: 74 72 61 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 tra initializati
11b0: 6f 6e 20 6e 65 65 64 65 64 20 2a 2f 0a 23 65 6e on needed */.#en
11c0: 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
11d0: 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 72 63 TE_OMIT_WSD. rc
11e0: 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 5f 69 = sqlite3_wsd_i
11f0: 6e 69 74 28 34 30 39 36 2c 20 32 34 29 3b 0a 20 nit(4096, 24);.
1200: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1210: 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
1220: 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a rc;. }.#endif.
1230: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 66 6f 6c . /* If the fol
1240: 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 28 29 20 lowing assert()
1250: 66 61 69 6c 73 20 6f 6e 20 73 6f 6d 65 20 6f 62 fails on some ob
1260: 73 63 75 72 65 20 70 72 6f 63 65 73 73 6f 72 2f scure processor/
1270: 63 6f 6d 70 69 6c 65 72 0a 20 20 2a 2a 20 63 6f compiler. ** co
1280: 6d 62 69 6e 61 74 69 6f 6e 2c 20 74 68 65 20 77 mbination, the w
1290: 6f 72 6b 2d 61 72 6f 75 6e 64 20 69 73 20 74 6f ork-around is to
12a0: 20 73 65 74 20 74 68 65 20 63 6f 72 72 65 63 74 set the correct
12b0: 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 73 69 pointer. ** si
12c0: 7a 65 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ze at compile-ti
12d0: 6d 65 20 75 73 69 6e 67 20 2d 44 53 51 4c 49 54 me using -DSQLIT
12e0: 45 5f 50 54 52 53 49 5a 45 3d 6e 20 63 6f 6d 70 E_PTRSIZE=n comp
12f0: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 ile-time option
1300: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c */. assert( SQL
1310: 49 54 45 5f 50 54 52 53 49 5a 45 3d 3d 73 69 7a ITE_PTRSIZE==siz
1320: 65 6f 66 28 63 68 61 72 2a 29 20 29 3b 0a 0a 20 eof(char*) );..
1330: 20 2f 2a 20 49 66 20 53 51 4c 69 74 65 20 69 73 /* If SQLite is
1340: 20 61 6c 72 65 61 64 79 20 63 6f 6d 70 6c 65 74 already complet
1350: 65 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c ely initialized,
1360: 20 74 68 65 6e 20 74 68 69 73 20 63 61 6c 6c 0a then this call.
1370: 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f ** to sqlite3_
1380: 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 73 68 6f initialize() sho
1390: 75 6c 64 20 62 65 20 61 20 6e 6f 2d 6f 70 2e 20 uld be a no-op.
13a0: 20 42 75 74 20 74 68 65 20 69 6e 69 74 69 61 6c But the initial
13b0: 69 7a 61 74 69 6f 6e 0a 20 20 2a 2a 20 6d 75 73 ization. ** mus
13c0: 74 20 62 65 20 63 6f 6d 70 6c 65 74 65 2e 20 20 t be complete.
13d0: 53 6f 20 69 73 49 6e 69 74 20 6d 75 73 74 20 6e So isInit must n
13e0: 6f 74 20 62 65 20 73 65 74 20 75 6e 74 69 6c 20 ot be set until
13f0: 74 68 65 20 76 65 72 79 20 65 6e 64 0a 20 20 2a the very end. *
1400: 2a 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e * of this routin
1410: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 73 71 e.. */. if( sq
1420: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1430: 67 2e 69 73 49 6e 69 74 20 29 20 72 65 74 75 72 g.isInit ) retur
1440: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 n SQLITE_OK;..
1450: 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 /* Make sure the
1460: 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 6d mutex subsystem
1470: 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e is initialized.
1480: 20 20 49 66 20 75 6e 61 62 6c 65 20 74 6f 20 0a If unable to .
1490: 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65 20 ** initialize
14a0: 74 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 the mutex subsys
14b0: 74 65 6d 2c 20 72 65 74 75 72 6e 20 65 61 72 6c tem, return earl
14c0: 79 20 77 69 74 68 20 74 68 65 20 65 72 72 6f 72 y with the error
14d0: 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 73 79 .. ** If the sy
14e0: 73 74 65 6d 20 69 73 20 73 6f 20 73 69 63 6b 20 stem is so sick
14f0: 74 68 61 74 20 77 65 20 61 72 65 20 75 6e 61 62 that we are unab
1500: 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 le to allocate a
1510: 20 6d 75 74 65 78 2c 0a 20 20 2a 2a 20 74 68 65 mutex,. ** the
1520: 72 65 20 69 73 20 6e 6f 74 20 6d 75 63 68 20 53 re is not much S
1530: 51 4c 69 74 65 20 69 73 20 67 6f 69 6e 67 20 74 QLite is going t
1540: 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 64 6f 2e o be able to do.
1550: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 6d . **. ** The m
1560: 75 74 65 78 20 73 75 62 73 79 73 74 65 6d 20 6d utex subsystem m
1570: 75 73 74 20 74 61 6b 65 20 63 61 72 65 20 6f 66 ust take care of
1580: 20 73 65 72 69 61 6c 69 7a 69 6e 67 20 69 74 73 serializing its
1590: 20 6f 77 6e 0a 20 20 2a 2a 20 69 6e 69 74 69 61 own. ** initia
15a0: 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 lization.. */.
15b0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 rc = sqlite3Mut
15c0: 65 78 49 6e 69 74 28 29 3b 0a 20 20 69 66 28 20 exInit();. if(
15d0: 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
15e0: 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 65 . /* Initialize
15f0: 20 74 68 65 20 6d 61 6c 6c 6f 63 28 29 20 73 79 the malloc() sy
1600: 73 74 65 6d 20 61 6e 64 20 74 68 65 20 72 65 63 stem and the rec
1610: 75 72 73 69 76 65 20 70 49 6e 69 74 4d 75 74 65 ursive pInitMute
1620: 78 20 6d 75 74 65 78 2e 0a 20 20 2a 2a 20 54 68 x mutex.. ** Th
1630: 69 73 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 is operation is
1640: 70 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65 protected by the
1650: 20 53 54 41 54 49 43 5f 4d 41 53 54 45 52 20 6d STATIC_MASTER m
1660: 75 74 65 78 2e 20 20 4e 6f 74 65 20 74 68 61 74 utex. Note that
1670: 0a 20 20 2a 2a 20 4d 75 74 65 78 41 6c 6c 6f 63 . ** MutexAlloc
1680: 28 29 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 () is called for
1690: 20 61 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 a static mutex
16a0: 70 72 69 6f 72 20 74 6f 20 69 6e 69 74 69 61 6c prior to initial
16b0: 69 7a 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 6d izing the. ** m
16c0: 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 20 alloc subsystem
16d0: 2d 20 74 68 69 73 20 69 6d 70 6c 69 65 73 20 74 - this implies t
16e0: 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 hat the allocati
16f0: 6f 6e 20 6f 66 20 61 20 73 74 61 74 69 63 0a 20 on of a static.
1700: 20 2a 2a 20 6d 75 74 65 78 20 6d 75 73 74 20 6e ** mutex must n
1710: 6f 74 20 72 65 71 75 69 72 65 20 73 75 70 70 6f ot require suppo
1720: 72 74 20 66 72 6f 6d 20 74 68 65 20 6d 61 6c 6c rt from the mall
1730: 6f 63 20 73 75 62 73 79 73 74 65 6d 2e 0a 20 20 oc subsystem..
1740: 2a 2f 0a 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 */. MUTEX_LOGIC
1750: 28 20 70 4d 61 73 74 65 72 20 3d 20 73 71 6c 69 ( pMaster = sqli
1760: 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
1770: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
1780: 43 5f 4d 41 53 54 45 52 29 3b 20 29 0a 20 20 73 C_MASTER); ). s
1790: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
17a0: 65 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 73 er(pMaster);. s
17b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
17c0: 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 74 20 3d ig.isMutexInit =
17d0: 20 31 3b 0a 20 20 69 66 28 20 21 73 71 6c 69 74 1;. if( !sqlit
17e0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
17f0: 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 sMallocInit ){.
1800: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d rc = sqlite3M
1810: 61 6c 6c 6f 63 49 6e 69 74 28 29 3b 0a 20 20 7d allocInit();. }
1820: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
1830: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
1840: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1850: 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 3d 20 31 isMallocInit = 1
1860: 3b 0a 20 20 20 20 69 66 28 20 21 73 71 6c 69 74 ;. if( !sqlit
1870: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
1880: 49 6e 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 InitMutex ){.
1890: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
18a0: 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 Config.pInitMute
18b0: 78 20 3d 0a 20 20 20 20 20 20 20 20 20 20 20 73 x =. s
18c0: 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
18d0: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 52 45 (SQLITE_MUTEX_RE
18e0: 43 55 52 53 49 56 45 29 3b 0a 20 20 20 20 20 20 CURSIVE);.
18f0: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
1900: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 lConfig.bCoreMut
1910: 65 78 20 26 26 20 21 73 71 6c 69 74 65 33 47 6c ex && !sqlite3Gl
1920: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
1930: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 20 20 20 Mutex ){.
1940: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
1950: 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 EM;. }.
1960: 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d }. }. if( rc==
1970: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1980: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1990: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
19a0: 65 78 2b 2b 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 ex++;. }. sqli
19b0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
19c0: 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 pMaster);.. /*
19d0: 49 66 20 72 63 20 69 73 20 6e 6f 74 20 53 51 4c If rc is not SQL
19e0: 49 54 45 5f 4f 4b 20 61 74 20 74 68 69 73 20 70 ITE_OK at this p
19f0: 6f 69 6e 74 2c 20 74 68 65 6e 20 65 69 74 68 65 oint, then eithe
1a00: 72 20 74 68 65 20 6d 61 6c 6c 6f 63 0a 20 20 2a r the malloc. *
1a10: 2a 20 73 75 62 73 79 73 74 65 6d 20 63 6f 75 6c * subsystem coul
1a20: 64 20 6e 6f 74 20 62 65 20 69 6e 69 74 69 61 6c d not be initial
1a30: 69 7a 65 64 20 6f 72 20 74 68 65 20 73 79 73 74 ized or the syst
1a40: 65 6d 20 66 61 69 6c 65 64 20 74 6f 20 61 6c 6c em failed to all
1a50: 6f 63 61 74 65 0a 20 20 2a 2a 20 74 68 65 20 70 ocate. ** the p
1a60: 49 6e 69 74 4d 75 74 65 78 20 6d 75 74 65 78 2e InitMutex mutex.
1a70: 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 Return an error
1a80: 20 69 6e 20 65 69 74 68 65 72 20 63 61 73 65 2e in either case.
1a90: 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d 53 */. if( rc!=S
1aa0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1ab0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a return rc;. }..
1ac0: 20 20 2f 2a 20 44 6f 20 74 68 65 20 72 65 73 74 /* Do the rest
1ad0: 20 6f 66 20 74 68 65 20 69 6e 69 74 69 61 6c 69 of the initiali
1ae0: 7a 61 74 69 6f 6e 20 75 6e 64 65 72 20 74 68 65 zation under the
1af0: 20 72 65 63 75 72 73 69 76 65 20 6d 75 74 65 78 recursive mutex
1b00: 20 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 77 65 so. ** that we
1b10: 20 77 69 6c 6c 20 62 65 20 61 62 6c 65 20 74 6f will be able to
1b20: 20 68 61 6e 64 6c 65 20 72 65 63 75 72 73 69 76 handle recursiv
1b30: 65 20 63 61 6c 6c 73 20 69 6e 74 6f 0a 20 20 2a e calls into. *
1b40: 2a 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 * sqlite3_initia
1b50: 6c 69 7a 65 28 29 2e 20 20 54 68 65 20 72 65 63 lize(). The rec
1b60: 75 72 73 69 76 65 20 63 61 6c 6c 73 20 6e 6f 72 ursive calls nor
1b70: 6d 61 6c 6c 79 20 63 6f 6d 65 20 74 68 72 6f 75 mally come throu
1b80: 67 68 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f gh. ** sqlite3_
1b90: 6f 73 5f 69 6e 69 74 28 29 20 77 68 65 6e 20 69 os_init() when i
1ba0: 74 20 69 6e 76 6f 6b 65 73 20 73 71 6c 69 74 65 t invokes sqlite
1bb0: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 3_vfs_register()
1bc0: 2c 20 62 75 74 20 6f 74 68 65 72 0a 20 20 2a 2a , but other. **
1bd0: 20 72 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 recursive calls
1be0: 20 6d 69 67 68 74 20 61 6c 73 6f 20 62 65 20 70 might also be p
1bf0: 6f 73 73 69 62 6c 65 2e 0a 20 20 2a 2a 0a 20 20 ossible.. **.
1c00: 2a 2a 20 49 4d 50 4c 45 4d 45 4e 54 41 54 49 4f ** IMPLEMENTATIO
1c10: 4e 2d 4f 46 3a 20 52 2d 30 30 31 34 30 2d 33 37 N-OF: R-00140-37
1c20: 34 34 35 20 53 51 4c 69 74 65 20 61 75 74 6f 6d 445 SQLite autom
1c30: 61 74 69 63 61 6c 6c 79 20 73 65 72 69 61 6c 69 atically seriali
1c40: 7a 65 73 20 63 61 6c 6c 73 0a 20 20 2a 2a 20 74 zes calls. ** t
1c50: 6f 20 74 68 65 20 78 49 6e 69 74 20 6d 65 74 68 o the xInit meth
1c60: 6f 64 2c 20 73 6f 20 74 68 65 20 78 49 6e 69 74 od, so the xInit
1c70: 20 6d 65 74 68 6f 64 20 6e 65 65 64 20 6e 6f 74 method need not
1c80: 20 62 65 20 74 68 72 65 61 64 73 61 66 65 2e 0a be threadsafe..
1c90: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f **. ** The fo
1ca0: 6c 6c 6f 77 69 6e 67 20 6d 75 74 65 78 20 69 73 llowing mutex is
1cb0: 20 77 68 61 74 20 73 65 72 69 61 6c 69 7a 65 73 what serializes
1cc0: 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 61 access to the a
1cd0: 70 70 64 65 66 20 70 63 61 63 68 65 20 78 49 6e ppdef pcache xIn
1ce0: 69 74 0a 20 20 2a 2a 20 6d 65 74 68 6f 64 73 2e it. ** methods.
1cf0: 20 20 54 68 65 20 73 71 6c 69 74 65 33 5f 70 63 The sqlite3_pc
1d00: 61 63 68 65 5f 6d 65 74 68 6f 64 73 2e 78 49 6e ache_methods.xIn
1d10: 69 74 28 29 20 61 6c 6c 20 69 73 20 65 6d 62 65 it() all is embe
1d20: 64 64 65 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a dded in the. **
1d30: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 call to sqlite3
1d40: 50 63 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 PcacheInitialize
1d50: 28 29 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 ().. */. sqlit
1d60: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 e3_mutex_enter(s
1d70: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1d80: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a ig.pInitMutex);.
1d90: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
1da0: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
1db0: 3d 3d 30 20 26 26 20 73 71 6c 69 74 65 33 47 6c ==0 && sqlite3Gl
1dc0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f obalConfig.inPro
1dd0: 67 72 65 73 73 3d 3d 30 20 29 7b 0a 20 20 20 20 gress==0 ){.
1de0: 46 75 6e 63 44 65 66 48 61 73 68 20 2a 70 48 61 FuncDefHash *pHa
1df0: 73 68 20 3d 20 26 47 4c 4f 42 41 4c 28 46 75 6e sh = &GLOBAL(Fun
1e00: 63 44 65 66 48 61 73 68 2c 20 73 71 6c 69 74 65 cDefHash, sqlite
1e10: 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 3GlobalFunctions
1e20: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c );. sqlite3Gl
1e30: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f obalConfig.inPro
1e40: 67 72 65 73 73 20 3d 20 31 3b 0a 20 20 20 20 6d gress = 1;. m
1e50: 65 6d 73 65 74 28 70 48 61 73 68 2c 20 30 2c 20 emset(pHash, 0,
1e60: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 47 6c sizeof(sqlite3Gl
1e70: 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 29 29 3b obalFunctions));
1e80: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 67 69 . sqlite3Regi
1e90: 73 74 65 72 47 6c 6f 62 61 6c 46 75 6e 63 74 69 sterGlobalFuncti
1ea0: 6f 6e 73 28 29 3b 0a 20 20 20 20 69 66 28 20 73 ons();. if( s
1eb0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1ec0: 69 67 2e 69 73 50 43 61 63 68 65 49 6e 69 74 3d ig.isPCacheInit=
1ed0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d =0 ){. rc =
1ee0: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 49 6e sqlite3PcacheIn
1ef0: 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 20 20 itialize();.
1f00: 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
1f10: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1f20: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1f30: 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 6e 69 nfig.isPCacheIni
1f40: 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 72 63 20 t = 1;. rc
1f50: 3d 20 73 71 6c 69 74 65 33 4f 73 49 6e 69 74 28 = sqlite3OsInit(
1f60: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
1f70: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1f80: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
1f90: 43 61 63 68 65 42 75 66 66 65 72 53 65 74 75 70 CacheBufferSetup
1fa0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
1fb0: 6f 6e 66 69 67 2e 70 50 61 67 65 2c 20 0a 20 20 onfig.pPage, .
1fc0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 sqlite3G
1fd0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 lobalConfig.szPa
1fe0: 67 65 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 ge, sqlite3Globa
1ff0: 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 29 3b 0a lConfig.nPage);.
2000: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
2010: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
2020: 20 3d 20 31 3b 0a 23 69 66 64 65 66 20 53 51 4c = 1;.#ifdef SQL
2030: 49 54 45 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 ITE_EXTRA_INIT.
2040: 20 20 20 20 20 62 52 75 6e 45 78 74 72 61 49 6e bRunExtraIn
2050: 69 74 20 3d 20 31 3b 0a 23 65 6e 64 69 66 0a 20 it = 1;.#endif.
2060: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
2070: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 GlobalConfig.inP
2080: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 7d rogress = 0;. }
2090: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
20a0: 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 47 6c _leave(sqlite3Gl
20b0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
20c0: 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 47 6f Mutex);.. /* Go
20d0: 20 62 61 63 6b 20 75 6e 64 65 72 20 74 68 65 20 back under the
20e0: 73 74 61 74 69 63 20 6d 75 74 65 78 20 61 6e 64 static mutex and
20f0: 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20 72 65 clean up the re
2100: 63 75 72 73 69 76 65 0a 20 20 2a 2a 20 6d 75 74 cursive. ** mut
2110: 65 78 20 74 6f 20 70 72 65 76 65 6e 74 20 61 20 ex to prevent a
2120: 72 65 73 6f 75 72 63 65 20 6c 65 61 6b 2e 0a 20 resource leak..
2130: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 */. sqlite3_mu
2140: 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 tex_enter(pMaste
2150: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f r);. sqlite3Glo
2160: 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e balConfig.nRefIn
2170: 69 74 4d 75 74 65 78 2d 2d 3b 0a 20 20 69 66 28 itMutex--;. if(
2180: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2190: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
21a0: 65 78 3c 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 ex<=0 ){. ass
21b0: 65 72 74 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 ert( sqlite3Glob
21c0: 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 alConfig.nRefIni
21d0: 74 4d 75 74 65 78 3d 3d 30 20 29 3b 0a 20 20 20 tMutex==0 );.
21e0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 sqlite3_mutex_f
21f0: 72 65 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 ree(sqlite3Globa
2200: 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 lConfig.pInitMut
2210: 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ex);. sqlite3
2220: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e GlobalConfig.pIn
2230: 69 74 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 7d itMutex = 0;. }
2240: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
2250: 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b _leave(pMaster);
2260: 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f .. /* The follo
2270: 77 69 6e 67 20 69 73 20 6a 75 73 74 20 61 20 73 wing is just a s
2280: 61 6e 69 74 79 20 63 68 65 63 6b 20 74 6f 20 6d anity check to m
2290: 61 6b 65 20 73 75 72 65 20 53 51 4c 69 74 65 20 ake sure SQLite
22a0: 68 61 73 0a 20 20 2a 2a 20 62 65 65 6e 20 63 6f has. ** been co
22b0: 6d 70 69 6c 65 64 20 63 6f 72 72 65 63 74 6c 79 mpiled correctly
22c0: 2e 20 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 . It is importa
22d0: 6e 74 20 74 6f 20 72 75 6e 20 74 68 69 73 20 63 nt to run this c
22e0: 6f 64 65 2c 20 62 75 74 0a 20 20 2a 2a 20 77 65 ode, but. ** we
22f0: 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 6f 20 72 don't want to r
2300: 75 6e 20 69 74 20 74 6f 6f 20 6f 66 74 65 6e 20 un it too often
2310: 61 6e 64 20 73 6f 61 6b 20 75 70 20 43 50 55 20 and soak up CPU
2320: 63 79 63 6c 65 73 20 66 6f 72 20 6e 6f 0a 20 20 cycles for no.
2330: 2a 2a 20 72 65 61 73 6f 6e 2e 20 20 53 6f 20 77 ** reason. So w
2340: 65 20 72 75 6e 20 69 74 20 6f 6e 63 65 20 64 75 e run it once du
2350: 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 ring initializat
2360: 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 ion.. */.#ifnde
2370: 66 20 4e 44 45 42 55 47 0a 23 69 66 6e 64 65 66 f NDEBUG.#ifndef
2380: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f SQLITE_OMIT_FLO
2390: 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 2f 2a ATING_POINT. /*
23a0: 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 6f 66 This section of
23b0: 20 63 6f 64 65 27 73 20 6f 6e 6c 79 20 22 6f 75 code's only "ou
23c0: 74 70 75 74 22 20 69 73 20 76 69 61 20 61 73 73 tput" is via ass
23d0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
23e0: 2e 20 2a 2f 0a 20 20 69 66 20 28 20 72 63 3d 3d . */. if ( rc==
23f0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2400: 20 75 36 34 20 78 20 3d 20 28 28 28 75 36 34 29 u64 x = (((u64)
2410: 31 29 3c 3c 36 33 29 2d 31 3b 0a 20 20 20 20 64 1)<<63)-1;. d
2420: 6f 75 62 6c 65 20 79 3b 0a 20 20 20 20 61 73 73 ouble y;. ass
2430: 65 72 74 28 73 69 7a 65 6f 66 28 78 29 3d 3d 38 ert(sizeof(x)==8
2440: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 73 69 );. assert(si
2450: 7a 65 6f 66 28 78 29 3d 3d 73 69 7a 65 6f 66 28 zeof(x)==sizeof(
2460: 79 29 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 y));. memcpy(
2470: 26 79 2c 20 26 78 2c 20 38 29 3b 0a 20 20 20 20 &y, &x, 8);.
2480: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 49 assert( sqlite3I
2490: 73 4e 61 4e 28 79 29 20 29 3b 0a 20 20 7d 0a 23 sNaN(y) );. }.#
24a0: 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 20 20 endif.#endif..
24b0: 2f 2a 20 44 6f 20 65 78 74 72 61 20 69 6e 69 74 /* Do extra init
24c0: 69 61 6c 69 7a 61 74 69 6f 6e 20 73 74 65 70 73 ialization steps
24d0: 20 72 65 71 75 65 73 74 65 64 20 62 79 20 74 68 requested by th
24e0: 65 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 49 e SQLITE_EXTRA_I
24f0: 4e 49 54 0a 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 NIT. ** compile
2500: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 -time option..
2510: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
2520: 5f 45 58 54 52 41 5f 49 4e 49 54 0a 20 20 69 66 _EXTRA_INIT. if
2530: 28 20 62 52 75 6e 45 78 74 72 61 49 6e 69 74 20 ( bRunExtraInit
2540: 29 7b 0a 20 20 20 20 69 6e 74 20 53 51 4c 49 54 ){. int SQLIT
2550: 45 5f 45 58 54 52 41 5f 49 4e 49 54 28 63 6f 6e E_EXTRA_INIT(con
2560: 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 20 20 72 st char*);. r
2570: 63 20 3d 20 53 51 4c 49 54 45 5f 45 58 54 52 41 c = SQLITE_EXTRA
2580: 5f 49 4e 49 54 28 30 29 3b 0a 20 20 7d 0a 23 65 _INIT(0);. }.#e
2590: 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72 ndif.. return r
25a0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 6e 64 6f c;.}../*.** Undo
25b0: 20 74 68 65 20 65 66 66 65 63 74 73 20 6f 66 20 the effects of
25c0: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 sqlite3_initiali
25d0: 7a 65 28 29 2e 20 20 4d 75 73 74 20 6e 6f 74 20 ze(). Must not
25e0: 62 65 20 63 61 6c 6c 65 64 20 77 68 69 6c 65 0a be called while.
25f0: 2a 2a 20 74 68 65 72 65 20 61 72 65 20 6f 75 74 ** there are out
2600: 73 74 61 6e 64 69 6e 67 20 64 61 74 61 62 61 73 standing databas
2610: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 72 e connections or
2620: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
2630: 6f 6e 73 20 6f 72 0a 2a 2a 20 77 68 69 6c 65 20 ons or.** while
2640: 61 6e 79 20 70 61 72 74 20 6f 66 20 53 51 4c 69 any part of SQLi
2650: 74 65 20 69 73 20 6f 74 68 65 72 77 69 73 65 20 te is otherwise
2660: 69 6e 20 75 73 65 20 69 6e 20 61 6e 79 20 74 68 in use in any th
2670: 72 65 61 64 2e 20 20 54 68 69 73 0a 2a 2a 20 72 read. This.** r
2680: 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 20 74 68 outine is not th
2690: 72 65 61 64 73 61 66 65 2e 20 20 42 75 74 20 69 readsafe. But i
26a0: 74 20 69 73 20 73 61 66 65 20 74 6f 20 69 6e 76 t is safe to inv
26b0: 6f 6b 65 20 74 68 69 73 20 72 6f 75 74 69 6e 65 oke this routine
26c0: 0a 2a 2a 20 6f 6e 20 77 68 65 6e 20 53 51 4c 69 .** on when SQLi
26d0: 74 65 20 69 73 20 61 6c 72 65 61 64 79 20 73 68 te is already sh
26e0: 75 74 20 64 6f 77 6e 2e 20 20 49 66 20 53 51 4c ut down. If SQL
26f0: 69 74 65 20 69 73 20 61 6c 72 65 61 64 79 20 73 ite is already s
2700: 68 75 74 20 64 6f 77 6e 0a 2a 2a 20 77 68 65 6e hut down.** when
2710: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
2720: 20 69 6e 76 6f 6b 65 64 2c 20 74 68 65 6e 20 74 invoked, then t
2730: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 his routine is a
2740: 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f 70 2e harmless no-op.
2750: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
2760: 73 68 75 74 64 6f 77 6e 28 76 6f 69 64 29 7b 0a shutdown(void){.
2770: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
2780: 49 54 5f 57 53 44 0a 20 20 69 6e 74 20 72 63 20 IT_WSD. int rc
2790: 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e = sqlite3_wsd_in
27a0: 69 74 28 34 30 39 36 2c 20 32 34 29 3b 0a 20 20 it(4096, 24);.
27b0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
27c0: 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 K ){. return
27d0: 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a rc;. }.#endif..
27e0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
27f0: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
2800: 20 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 ){.#ifdef SQLIT
2810: 45 5f 45 58 54 52 41 5f 53 48 55 54 44 4f 57 4e E_EXTRA_SHUTDOWN
2820: 0a 20 20 20 20 76 6f 69 64 20 53 51 4c 49 54 45 . void SQLITE
2830: 5f 45 58 54 52 41 5f 53 48 55 54 44 4f 57 4e 28 _EXTRA_SHUTDOWN(
2840: 76 6f 69 64 29 3b 0a 20 20 20 20 53 51 4c 49 54 void);. SQLIT
2850: 45 5f 45 58 54 52 41 5f 53 48 55 54 44 4f 57 4e E_EXTRA_SHUTDOWN
2860: 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 ();.#endif. s
2870: 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 28 29 3b qlite3_os_end();
2880: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 . sqlite3_res
2890: 65 74 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 6f et_auto_extensio
28a0: 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 n();. sqlite3
28b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 GlobalConfig.isI
28c0: 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 nit = 0;. }. i
28d0: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
28e0: 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 49 Config.isPCacheI
28f0: 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 nit ){. sqlit
2900: 65 33 50 63 61 63 68 65 53 68 75 74 64 6f 77 6e e3PcacheShutdown
2910: 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 ();. sqlite3G
2920: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 lobalConfig.isPC
2930: 61 63 68 65 49 6e 69 74 20 3d 20 30 3b 0a 20 20 acheInit = 0;.
2940: 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 }. if( sqlite3G
2950: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 lobalConfig.isMa
2960: 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 20 20 20 llocInit ){.
2970: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 sqlite3MallocEnd
2980: 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 ();. sqlite3G
2990: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 61 lobalConfig.isMa
29a0: 6c 6c 6f 63 49 6e 69 74 20 3d 20 30 3b 0a 0a 23 llocInit = 0;..#
29b0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
29c0: 49 54 5f 53 48 55 54 44 4f 57 4e 5f 44 49 52 45 IT_SHUTDOWN_DIRE
29d0: 43 54 4f 52 49 45 53 0a 20 20 20 20 2f 2a 20 54 CTORIES. /* T
29e0: 68 65 20 68 65 61 70 20 73 75 62 73 79 73 74 65 he heap subsyste
29f0: 6d 20 68 61 73 20 6e 6f 77 20 62 65 65 6e 20 73 m has now been s
2a00: 68 75 74 64 6f 77 6e 20 61 6e 64 20 74 68 65 73 hutdown and thes
2a10: 65 20 76 61 6c 75 65 73 20 61 72 65 20 73 75 70 e values are sup
2a20: 70 6f 73 65 64 0a 20 20 20 20 2a 2a 20 74 6f 20 posed. ** to
2a30: 62 65 20 4e 55 4c 4c 20 6f 72 20 70 6f 69 6e 74 be NULL or point
2a40: 20 74 6f 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 to memory that
2a50: 77 61 73 20 6f 62 74 61 69 6e 65 64 20 66 72 6f was obtained fro
2a60: 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 m sqlite3_malloc
2a70: 28 29 2c 0a 20 20 20 20 2a 2a 20 77 68 69 63 68 (),. ** which
2a80: 20 77 6f 75 6c 64 20 72 65 6c 79 20 6f 6e 20 74 would rely on t
2a90: 68 61 74 20 68 65 61 70 20 73 75 62 73 79 73 74 hat heap subsyst
2aa0: 65 6d 3b 20 74 68 65 72 65 66 6f 72 65 2c 20 6d em; therefore, m
2ab0: 61 6b 65 20 73 75 72 65 20 74 68 65 73 65 0a 20 ake sure these.
2ac0: 20 20 20 2a 2a 20 76 61 6c 75 65 73 20 63 61 6e ** values can
2ad0: 6e 6f 74 20 72 65 66 65 72 20 74 6f 20 68 65 61 not refer to hea
2ae0: 70 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77 61 p memory that wa
2af0: 73 20 6a 75 73 74 20 69 6e 76 61 6c 69 64 61 74 s just invalidat
2b00: 65 64 20 77 68 65 6e 20 74 68 65 0a 20 20 20 20 ed when the.
2b10: 2a 2a 20 68 65 61 70 20 73 75 62 73 79 73 74 65 ** heap subsyste
2b20: 6d 20 77 61 73 20 73 68 75 74 64 6f 77 6e 2e 20 m was shutdown.
2b30: 20 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 64 6f This is only do
2b40: 6e 65 20 69 66 20 74 68 65 20 63 75 72 72 65 6e ne if the curren
2b50: 74 20 63 61 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a t call to. **
2b60: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
2b70: 65 73 75 6c 74 65 64 20 69 6e 20 74 68 65 20 68 esulted in the h
2b80: 65 61 70 20 73 75 62 73 79 73 74 65 6d 20 61 63 eap subsystem ac
2b90: 74 75 61 6c 6c 79 20 62 65 69 6e 67 20 73 68 75 tually being shu
2ba0: 74 64 6f 77 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 tdown.. */.
2bb0: 20 20 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 64 sqlite3_data_d
2bc0: 69 72 65 63 74 6f 72 79 20 3d 20 30 3b 0a 20 20 irectory = 0;.
2bd0: 20 20 73 71 6c 69 74 65 33 5f 74 65 6d 70 5f 64 sqlite3_temp_d
2be0: 69 72 65 63 74 6f 72 79 20 3d 20 30 3b 0a 23 65 irectory = 0;.#e
2bf0: 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 28 20 73 ndif. }. if( s
2c00: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2c10: 69 67 2e 69 73 4d 75 74 65 78 49 6e 69 74 20 29 ig.isMutexInit )
2c20: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4d 75 74 {. sqlite3Mut
2c30: 65 78 45 6e 64 28 29 3b 0a 20 20 20 20 73 71 6c exEnd();. sql
2c40: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2c50: 2e 69 73 4d 75 74 65 78 49 6e 69 74 20 3d 20 30 .isMutexInit = 0
2c60: 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
2c70: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
2c80: 0a 2a 2a 20 54 68 69 73 20 41 50 49 20 61 6c 6c .** This API all
2c90: 6f 77 73 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 ows applications
2ca0: 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 67 to modify the g
2cb0: 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 lobal configurat
2cc0: 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 53 51 ion of.** the SQ
2cd0: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 61 74 20 Lite library at
2ce0: 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 run-time..**.**
2cf0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f This routine sho
2d00: 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c uld only be call
2d10: 65 64 20 77 68 65 6e 20 74 68 65 72 65 20 61 72 ed when there ar
2d20: 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 e no outstanding
2d30: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e .** database con
2d40: 6e 65 63 74 69 6f 6e 73 20 6f 72 20 6d 65 6d 6f nections or memo
2d50: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2e 20 ry allocations.
2d60: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
2d70: 20 6e 6f 74 0a 2a 2a 20 74 68 72 65 61 64 73 61 not.** threadsa
2d80: 66 65 2e 20 20 46 61 69 6c 75 72 65 20 74 6f 20 fe. Failure to
2d90: 68 65 65 64 20 74 68 65 73 65 20 77 61 72 6e 69 heed these warni
2da0: 6e 67 73 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 ngs can lead to
2db0: 75 6e 70 72 65 64 69 63 74 61 62 6c 65 0a 2a 2a unpredictable.**
2dc0: 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2f 0a 69 6e behavior..*/.in
2dd0: 74 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 t sqlite3_config
2de0: 28 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 (int op, ...){.
2df0: 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 69 va_list ap;. i
2e00: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
2e10: 4b 3b 0a 0a 20 20 2f 2a 20 73 71 6c 69 74 65 33 K;.. /* sqlite3
2e20: 5f 63 6f 6e 66 69 67 28 29 20 73 68 61 6c 6c 20 _config() shall
2e30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 return SQLITE_MI
2e40: 53 55 53 45 20 69 66 20 69 74 20 69 73 20 69 6e SUSE if it is in
2e50: 76 6f 6b 65 64 20 77 68 69 6c 65 0a 20 20 2a 2a voked while. **
2e60: 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 the SQLite libr
2e70: 61 72 79 20 69 73 20 69 6e 20 75 73 65 2e 20 2a ary is in use. *
2e80: 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 /. if( sqlite3G
2e90: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e lobalConfig.isIn
2ea0: 69 74 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 it ) return SQLI
2eb0: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
2ec0: 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20 . va_start(ap,
2ed0: 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 28 20 6f op);. switch( o
2ee0: 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 4d 75 74 p ){.. /* Mut
2ef0: 65 78 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e ex configuration
2f00: 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 6f 6e 6c options are onl
2f10: 79 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 61 y available in a
2f20: 20 74 68 72 65 61 64 73 61 66 65 0a 20 20 20 20 threadsafe.
2f30: 2a 2a 20 63 6f 6d 70 69 6c 65 2e 0a 20 20 20 20 ** compile..
2f40: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
2f50: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
2f60: 29 20 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 ) && SQLITE_THRE
2f70: 41 44 53 41 46 45 3e 30 20 20 2f 2a 20 49 4d 50 ADSAFE>0 /* IMP
2f80: 3a 20 52 2d 35 34 34 36 36 2d 34 36 37 35 36 20 : R-54466-46756
2f90: 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
2fa0: 54 45 5f 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 TE_CONFIG_SINGLE
2fb0: 54 48 52 45 41 44 3a 20 7b 0a 20 20 20 20 20 20 THREAD: {.
2fc0: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
2fd0: 52 2d 30 32 37 34 38 2d 31 39 30 39 36 20 54 68 R-02748-19096 Th
2fe0: 69 73 20 6f 70 74 69 6f 6e 20 73 65 74 73 20 74 is option sets t
2ff0: 68 65 20 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 he threading mod
3000: 65 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 69 e to. ** Si
3010: 6e 67 6c 65 2d 74 68 72 65 61 64 2e 20 2a 2f 0a ngle-thread. */.
3020: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
3030: 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d balConfig.bCoreM
3040: 75 74 65 78 20 3d 20 30 3b 20 20 2f 2a 20 44 69 utex = 0; /* Di
3050: 73 61 62 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 sable mutex on c
3060: 6f 72 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c ore */. sql
3070: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
3080: 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b .bFullMutex = 0;
3090: 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 6d 75 74 /* Disable mut
30a0: 65 78 20 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e ex on connection
30b0: 73 20 2a 2f 0a 20 20 20 20 20 20 62 72 65 61 6b s */. break
30c0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 ;. }.#endif.#
30d0: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
30e0: 45 5f 54 48 52 45 41 44 53 41 46 45 29 20 26 26 E_THREADSAFE) &&
30f0: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
3100: 46 45 3e 30 20 2f 2a 20 49 4d 50 3a 20 52 2d 32 FE>0 /* IMP: R-2
3110: 30 35 32 30 2d 35 34 30 38 36 20 2a 2f 0a 20 20 0520-54086 */.
3120: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
3130: 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 NFIG_MULTITHREAD
3140: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 : {. /* EVI
3150: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 34 33 37 DENCE-OF: R-1437
3160: 34 2d 34 32 34 36 38 20 54 68 69 73 20 6f 70 74 4-42468 This opt
3170: 69 6f 6e 20 73 65 74 73 20 74 68 65 20 74 68 72 ion sets the thr
3180: 65 61 64 69 6e 67 20 6d 6f 64 65 20 74 6f 0a 20 eading mode to.
3190: 20 20 20 20 20 2a 2a 20 4d 75 6c 74 69 2d 74 68 ** Multi-th
31a0: 72 65 61 64 2e 20 2a 2f 0a 20 20 20 20 20 20 73 read. */. s
31b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
31c0: 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 ig.bCoreMutex =
31d0: 31 3b 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6d 75 1; /* Enable mu
31e0: 74 65 78 20 6f 6e 20 63 6f 72 65 20 2a 2f 0a 20 tex on core */.
31f0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
3200: 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 alConfig.bFullMu
3210: 74 65 78 20 3d 20 30 3b 20 20 2f 2a 20 44 69 73 tex = 0; /* Dis
3220: 61 62 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f able mutex on co
3230: 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 nnections */.
3240: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
3250: 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
3260: 65 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ed(SQLITE_THREAD
3270: 53 41 46 45 29 20 26 26 20 53 51 4c 49 54 45 5f SAFE) && SQLITE_
3280: 54 48 52 45 41 44 53 41 46 45 3e 30 20 2f 2a 20 THREADSAFE>0 /*
3290: 49 4d 50 3a 20 52 2d 35 39 35 39 33 2d 32 31 38 IMP: R-59593-218
32a0: 31 30 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 10 */. case S
32b0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 QLITE_CONFIG_SER
32c0: 49 41 4c 49 5a 45 44 3a 20 7b 0a 20 20 20 20 20 IALIZED: {.
32d0: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
32e0: 20 52 2d 34 31 32 32 30 2d 35 31 38 30 30 20 54 R-41220-51800 T
32f0: 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 74 73 20 his option sets
3300: 74 68 65 20 74 68 72 65 61 64 69 6e 67 20 6d 6f the threading mo
3310: 64 65 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 de to. ** S
3320: 65 72 69 61 6c 69 7a 65 64 2e 20 2a 2f 0a 20 20 erialized. */.
3330: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
3340: 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 lConfig.bCoreMut
3350: 65 78 20 3d 20 31 3b 20 20 2f 2a 20 45 6e 61 62 ex = 1; /* Enab
3360: 6c 65 20 6d 75 74 65 78 20 6f 6e 20 63 6f 72 65 le mutex on core
3370: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
3380: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 3GlobalConfig.bF
3390: 75 6c 6c 4d 75 74 65 78 20 3d 20 31 3b 20 20 2f ullMutex = 1; /
33a0: 2a 20 45 6e 61 62 6c 65 20 6d 75 74 65 78 20 6f * Enable mutex o
33b0: 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f n connections */
33c0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
33d0: 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 }.#endif.#if d
33e0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 efined(SQLITE_TH
33f0: 52 45 41 44 53 41 46 45 29 20 26 26 20 53 51 4c READSAFE) && SQL
3400: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3e 30 ITE_THREADSAFE>0
3410: 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 33 36 36 36 /* IMP: R-63666
3420: 2d 34 38 37 35 35 20 2a 2f 0a 20 20 20 20 63 61 -48755 */. ca
3430: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
3440: 5f 4d 55 54 45 58 3a 20 7b 0a 20 20 20 20 20 20 _MUTEX: {.
3450: 2f 2a 20 53 70 65 63 69 66 79 20 61 6e 20 61 6c /* Specify an al
3460: 74 65 72 6e 61 74 69 76 65 20 6d 75 74 65 78 20 ternative mutex
3470: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a implementation *
3480: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 /. sqlite3G
3490: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 lobalConfig.mute
34a0: 78 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 x = *va_arg(ap,
34b0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 sqlite3_mutex_me
34c0: 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 thods*);. b
34d0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 reak;. }.#end
34e0: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
34f0: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
3500: 29 20 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 ) && SQLITE_THRE
3510: 41 44 53 41 46 45 3e 30 20 2f 2a 20 49 4d 50 3a ADSAFE>0 /* IMP:
3520: 20 52 2d 31 34 34 35 30 2d 33 37 35 39 37 20 2a R-14450-37597 *
3530: 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
3540: 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45 E_CONFIG_GETMUTE
3550: 58 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 X: {. /* Re
3560: 74 72 69 65 76 65 20 74 68 65 20 63 75 72 72 65 trieve the curre
3570: 6e 74 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 nt mutex impleme
3580: 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 ntation */.
3590: 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c *va_arg(ap, sql
35a0: 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f ite3_mutex_metho
35b0: 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c ds*) = sqlite3Gl
35c0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 obalConfig.mutex
35d0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
35e0: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 }.#endif..
35f0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
3600: 46 49 47 5f 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 FIG_MALLOC: {.
3610: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
3620: 4f 46 3a 20 52 2d 35 35 35 39 34 2d 32 31 30 33 OF: R-55594-2103
3630: 30 20 54 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 0 The SQLITE_CON
3640: 46 49 47 5f 4d 41 4c 4c 4f 43 20 6f 70 74 69 6f FIG_MALLOC optio
3650: 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 20 20 20 n takes a.
3660: 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 ** single argume
3670: 6e 74 20 77 68 69 63 68 20 69 73 20 61 20 70 6f nt which is a po
3680: 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 73 74 inter to an inst
3690: 61 6e 63 65 20 6f 66 20 74 68 65 0a 20 20 20 20 ance of the.
36a0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 65 6d ** sqlite3_mem
36b0: 5f 6d 65 74 68 6f 64 73 20 73 74 72 75 63 74 75 _methods structu
36c0: 72 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 re. The argument
36d0: 20 73 70 65 63 69 66 69 65 73 20 61 6c 74 65 72 specifies alter
36e0: 6e 61 74 69 76 65 0a 20 20 20 20 20 20 2a 2a 20 native. **
36f0: 6c 6f 77 2d 6c 65 76 65 6c 20 6d 65 6d 6f 72 79 low-level memory
3700: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 allocation rout
3710: 69 6e 65 73 20 74 6f 20 62 65 20 75 73 65 64 20 ines to be used
3720: 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68 65 20 in place of the
3730: 6d 65 6d 6f 72 79 0a 20 20 20 20 20 20 2a 2a 20 memory. **
3740: 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 74 69 allocation routi
3750: 6e 65 73 20 62 75 69 6c 74 20 69 6e 74 6f 20 53 nes built into S
3760: 51 4c 69 74 65 2e 20 2a 2f 0a 20 20 20 20 20 20 QLite. */.
3770: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3780: 66 69 67 2e 6d 20 3d 20 2a 76 61 5f 61 72 67 28 fig.m = *va_arg(
3790: 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f ap, sqlite3_mem_
37a0: 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 methods*);.
37b0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
37c0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
37d0: 4e 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 NFIG_GETMALLOC:
37e0: 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 {. /* EVIDE
37f0: 4e 43 45 2d 4f 46 3a 20 52 2d 35 31 32 31 33 2d NCE-OF: R-51213-
3800: 34 36 34 31 34 20 54 68 65 20 53 51 4c 49 54 45 46414 The SQLITE
3810: 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c 4c 4f _CONFIG_GETMALLO
3820: 43 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 61 C option takes a
3830: 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 . ** single
3840: 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 argument which
3850: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
3860: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
3870: 68 65 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 he. ** sqli
3880: 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 te3_mem_methods
3890: 73 74 72 75 63 74 75 72 65 2e 20 54 68 65 20 73 structure. The s
38a0: 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f qlite3_mem_metho
38b0: 64 73 20 73 74 72 75 63 74 75 72 65 20 69 73 0a ds structure is.
38c0: 20 20 20 20 20 20 2a 2a 20 66 69 6c 6c 65 64 20 ** filled
38d0: 77 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 with the current
38e0: 6c 79 20 64 65 66 69 6e 65 64 20 6d 65 6d 6f 72 ly defined memor
38f0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 6f 75 y allocation rou
3900: 74 69 6e 65 73 2e 20 2a 2f 0a 20 20 20 20 20 20 tines. */.
3910: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
3920: 6c 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f lConfig.m.xMallo
3930: 63 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 4d 65 c==0 ) sqlite3Me
3940: 6d 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 mSetDefault();.
3950: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
3960: 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 sqlite3_mem_met
3970: 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 hods*) = sqlite3
3980: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a GlobalConfig.m;.
3990: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
39a0: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
39b0: 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 TE_CONFIG_MEMSTA
39c0: 54 55 53 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 TUS: {. /*
39d0: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 EVIDENCE-OF: R-6
39e0: 31 32 37 35 2d 33 35 31 35 37 20 54 68 65 20 53 1275-35157 The S
39f0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d QLITE_CONFIG_MEM
3a00: 53 54 41 54 55 53 20 6f 70 74 69 6f 6e 20 74 61 STATUS option ta
3a10: 6b 65 73 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e kes. ** sin
3a20: 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 gle argument of
3a30: 74 79 70 65 20 69 6e 74 2c 20 69 6e 74 65 72 70 type int, interp
3a40: 72 65 74 65 64 20 61 73 20 61 20 62 6f 6f 6c 65 reted as a boole
3a50: 61 6e 2c 20 77 68 69 63 68 20 65 6e 61 62 6c 65 an, which enable
3a60: 73 0a 20 20 20 20 20 20 2a 2a 20 6f 72 20 64 69 s. ** or di
3a70: 73 61 62 6c 65 73 20 74 68 65 20 63 6f 6c 6c 65 sables the colle
3a80: 63 74 69 6f 6e 20 6f 66 20 6d 65 6d 6f 72 79 20 ction of memory
3a90: 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 69 allocation stati
3aa0: 73 74 69 63 73 2e 20 2a 2f 0a 20 20 20 20 20 20 stics. */.
3ab0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3ac0: 66 69 67 2e 62 4d 65 6d 73 74 61 74 20 3d 20 76 fig.bMemstat = v
3ad0: 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
3ae0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
3af0: 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
3b00: 54 45 5f 43 4f 4e 46 49 47 5f 53 43 52 41 54 43 TE_CONFIG_SCRATC
3b10: 48 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 H: {. /* EV
3b20: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 38 34 IDENCE-OF: R-084
3b30: 30 34 2d 36 30 38 38 37 20 54 68 65 72 65 20 61 04-60887 There a
3b40: 72 65 20 74 68 72 65 65 20 61 72 67 75 6d 65 6e re three argumen
3b50: 74 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 53 ts to. ** S
3b60: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 43 52 QLITE_CONFIG_SCR
3b70: 41 54 43 48 3a 20 41 20 70 6f 69 6e 74 65 72 20 ATCH: A pointer
3b80: 61 6e 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 65 an 8-byte aligne
3b90: 64 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 20 d memory buffer
3ba0: 66 72 6f 6d 0a 20 20 20 20 20 20 2a 2a 20 77 68 from. ** wh
3bb0: 69 63 68 20 74 68 65 20 73 63 72 61 74 63 68 20 ich the scratch
3bc0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 77 69 6c 6c allocations will
3bd0: 20 62 65 20 64 72 61 77 6e 2c 20 74 68 65 20 73 be drawn, the s
3be0: 69 7a 65 20 6f 66 20 65 61 63 68 20 73 63 72 61 ize of each scra
3bf0: 74 63 68 0a 20 20 20 20 20 20 2a 2a 20 61 6c 6c tch. ** all
3c00: 6f 63 61 74 69 6f 6e 20 28 73 7a 29 2c 20 61 6e ocation (sz), an
3c10: 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 d the maximum nu
3c20: 6d 62 65 72 20 6f 66 20 73 63 72 61 74 63 68 20 mber of scratch
3c30: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 28 4e 29 2e allocations (N).
3c40: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
3c50: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 3GlobalConfig.pS
3c60: 63 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 cratch = va_arg(
3c70: 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 ap, void*);.
3c80: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
3c90: 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 onfig.szScratch
3ca0: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
3cb0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
3cc0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 GlobalConfig.nSc
3cd0: 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 ratch = va_arg(a
3ce0: 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 p, int);. b
3cf0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
3d00: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
3d10: 49 47 5f 50 41 47 45 43 41 43 48 45 3a 20 7b 0a IG_PAGECACHE: {.
3d20: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
3d30: 45 2d 4f 46 3a 20 52 2d 33 31 34 30 38 2d 34 30 E-OF: R-31408-40
3d40: 35 31 30 20 54 68 65 72 65 20 61 72 65 20 74 68 510 There are th
3d50: 72 65 65 20 61 72 67 75 6d 65 6e 74 73 20 74 6f ree arguments to
3d60: 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 . ** SQLITE
3d70: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48 _CONFIG_PAGECACH
3d80: 45 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 E: A pointer to
3d90: 38 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 20 6d 8-byte aligned m
3da0: 65 6d 6f 72 79 2c 20 74 68 65 20 73 69 7a 65 0a emory, the size.
3db0: 20 20 20 20 20 20 2a 2a 20 6f 66 20 65 61 63 68 ** of each
3dc0: 20 70 61 67 65 20 62 75 66 66 65 72 20 28 73 7a page buffer (sz
3dd0: 29 2c 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 ), and the numbe
3de0: 72 20 6f 66 20 70 61 67 65 73 20 28 4e 29 2e 20 r of pages (N).
3df0: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
3e00: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 50 61 GlobalConfig.pPa
3e10: 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ge = va_arg(ap,
3e20: 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 void*);. sq
3e30: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3e40: 67 2e 73 7a 50 61 67 65 20 3d 20 76 61 5f 61 72 g.szPage = va_ar
3e50: 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
3e60: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
3e70: 6f 6e 66 69 67 2e 6e 50 61 67 65 20 3d 20 76 61 onfig.nPage = va
3e80: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
3e90: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
3ea0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
3eb0: 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 5f E_CONFIG_PCACHE_
3ec0: 48 44 52 53 5a 3a 20 7b 0a 20 20 20 20 20 20 2f HDRSZ: {. /
3ed0: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
3ee0: 2d 33 39 31 30 30 2d 32 37 33 31 37 20 54 68 65 -39100-27317 The
3ef0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
3f00: 43 41 43 48 45 5f 48 44 52 53 5a 20 6f 70 74 69 CACHE_HDRSZ opti
3f10: 6f 6e 20 74 61 6b 65 73 0a 20 20 20 20 20 20 2a on takes. *
3f20: 2a 20 61 20 73 69 6e 67 6c 65 20 70 61 72 61 6d * a single param
3f30: 65 74 65 72 20 77 68 69 63 68 20 69 73 20 61 20 eter which is a
3f40: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e pointer to an in
3f50: 74 65 67 65 72 20 61 6e 64 20 77 72 69 74 65 73 teger and writes
3f60: 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 into. ** t
3f70: 68 61 74 20 69 6e 74 65 67 65 72 20 74 68 65 20 hat integer the
3f80: 6e 75 6d 62 65 72 20 6f 66 20 65 78 74 72 61 20 number of extra
3f90: 62 79 74 65 73 20 70 65 72 20 70 61 67 65 20 72 bytes per page r
3fa0: 65 71 75 69 72 65 64 20 66 6f 72 20 65 61 63 68 equired for each
3fb0: 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 page. ** i
3fc0: 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f n SQLITE_CONFIG_
3fd0: 50 41 47 45 43 41 43 48 45 2e 20 2a 2f 0a 20 20 PAGECACHE. */.
3fe0: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
3ff0: 69 6e 74 2a 29 20 3d 20 0a 20 20 20 20 20 20 20 int*) = .
4000: 20 20 20 73 71 6c 69 74 65 33 48 65 61 64 65 72 sqlite3Header
4010: 53 69 7a 65 42 74 72 65 65 28 29 20 2b 0a 20 20 SizeBtree() +.
4020: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 48 sqlite3H
4030: 65 61 64 65 72 53 69 7a 65 50 63 61 63 68 65 28 eaderSizePcache(
4040: 29 20 2b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ) +. sq
4050: 6c 69 74 65 33 48 65 61 64 65 72 53 69 7a 65 50 lite3HeaderSizeP
4060: 63 61 63 68 65 31 28 29 3b 0a 20 20 20 20 20 20 cache1();.
4070: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
4080: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
4090: 4e 46 49 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 NFIG_PCACHE: {.
40a0: 20 20 20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f /* no-op */
40b0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
40c0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
40d0: 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 ITE_CONFIG_GETPC
40e0: 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a ACHE: {. /*
40f0: 20 6e 6f 77 20 61 6e 20 65 72 72 6f 72 20 2a 2f now an error */
4100: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
4110: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 TE_ERROR;.
4120: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
4130: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
4140: 4e 46 49 47 5f 50 43 41 43 48 45 32 3a 20 7b 0a NFIG_PCACHE2: {.
4150: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
4160: 45 2d 4f 46 3a 20 52 2d 36 33 33 32 35 2d 34 38 E-OF: R-63325-48
4170: 33 37 38 20 54 68 65 20 53 51 4c 49 54 45 5f 43 378 The SQLITE_C
4180: 4f 4e 46 49 47 5f 50 43 41 43 48 45 32 20 6f 70 ONFIG_PCACHE2 op
4190: 74 69 6f 6e 20 74 61 6b 65 73 20 61 0a 20 20 20 tion takes a.
41a0: 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 61 72 67 ** single arg
41b0: 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 61 ument which is a
41c0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 73 pointer to an s
41d0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
41e0: 74 68 6f 64 73 32 0a 20 20 20 20 20 20 2a 2a 20 thods2. **
41f0: 6f 62 6a 65 63 74 2e 20 54 68 69 73 20 6f 62 6a object. This obj
4200: 65 63 74 20 73 70 65 63 69 66 69 65 73 20 74 68 ect specifies th
4210: 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 61 e interface to a
4220: 20 63 75 73 74 6f 6d 20 70 61 67 65 20 63 61 63 custom page cac
4230: 68 65 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6c he. ** impl
4240: 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 2a 2f 0a 20 ementation. */.
4250: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
4260: 61 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 32 alConfig.pcache2
4270: 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 = *va_arg(ap, s
4280: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
4290: 74 68 6f 64 73 32 2a 29 3b 0a 20 20 20 20 20 20 thods2*);.
42a0: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
42b0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
42c0: 46 49 47 5f 47 45 54 50 43 41 43 48 45 32 3a 20 FIG_GETPCACHE2:
42d0: 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 {. /* EVIDE
42e0: 4e 43 45 2d 4f 46 3a 20 52 2d 32 32 30 33 35 2d NCE-OF: R-22035-
42f0: 34 36 31 38 32 20 54 68 65 20 53 51 4c 49 54 45 46182 The SQLITE
4300: 5f 43 4f 4e 46 49 47 5f 47 45 54 50 43 41 43 48 _CONFIG_GETPCACH
4310: 45 32 20 6f 70 74 69 6f 6e 20 74 61 6b 65 73 20 E2 option takes
4320: 61 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c a. ** singl
4330: 65 20 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 e argument which
4340: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f is a pointer to
4350: 20 61 6e 20 73 71 6c 69 74 65 33 5f 70 63 61 63 an sqlite3_pcac
4360: 68 65 5f 6d 65 74 68 6f 64 73 32 0a 20 20 20 20 he_methods2.
4370: 20 20 2a 2a 20 6f 62 6a 65 63 74 2e 20 53 51 4c ** object. SQL
4380: 69 74 65 20 63 6f 70 69 65 73 20 6f 66 20 74 68 ite copies of th
4390: 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 e current page c
43a0: 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 ache implementat
43b0: 69 6f 6e 20 69 6e 74 6f 0a 20 20 20 20 20 20 2a ion into. *
43c0: 2a 20 74 68 61 74 20 6f 62 6a 65 63 74 2e 20 2a * that object. *
43d0: 2f 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 /. if( sqli
43e0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
43f0: 70 63 61 63 68 65 32 2e 78 49 6e 69 74 3d 3d 30 pcache2.xInit==0
4400: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
4410: 74 65 33 50 43 61 63 68 65 53 65 74 44 65 66 61 te3PCacheSetDefa
4420: 75 6c 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 ult();. }.
4430: 20 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c *va_arg(ap,
4440: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f sqlite3_pcache_
4450: 6d 65 74 68 6f 64 73 32 2a 29 20 3d 20 73 71 6c methods2*) = sql
4460: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4470: 2e 70 63 61 63 68 65 32 3b 0a 20 20 20 20 20 20 .pcache2;.
4480: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 2f 2a break;. }../*
4490: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
44a0: 30 36 36 32 36 2d 31 32 39 31 31 20 54 68 65 20 06626-12911 The
44b0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 SQLITE_CONFIG_HE
44c0: 41 50 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6e 6c AP option is onl
44d0: 79 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 69 y.** available i
44e0: 66 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 f SQLite is comp
44f0: 69 6c 65 64 20 77 69 74 68 20 65 69 74 68 65 72 iled with either
4500: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
4510: 45 4d 53 59 53 33 20 6f 72 0a 2a 2a 20 53 51 4c EMSYS3 or.** SQL
4520: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4530: 53 35 20 61 6e 64 20 72 65 74 75 72 6e 73 20 53 S5 and returns S
4540: 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 66 20 69 QLITE_ERROR if i
4550: 6e 76 6f 6b 65 64 20 6f 74 68 65 72 77 69 73 65 nvoked otherwise
4560: 2e 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 . */.#if defined
4570: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d (SQLITE_ENABLE_M
4580: 45 4d 53 59 53 33 29 20 7c 7c 20 64 65 66 69 6e EMSYS3) || defin
4590: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
45a0: 5f 4d 45 4d 53 59 53 35 29 0a 20 20 20 20 63 61 _MEMSYS5). ca
45b0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
45c0: 5f 48 45 41 50 3a 20 7b 0a 20 20 20 20 20 20 2f _HEAP: {. /
45d0: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
45e0: 2d 31 39 38 35 34 2d 34 32 31 32 36 20 54 68 65 -19854-42126 The
45f0: 72 65 20 61 72 65 20 74 68 72 65 65 20 61 72 67 re are three arg
4600: 75 6d 65 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 uments to.
4610: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ** SQLITE_CONFIG
4620: 5f 48 45 41 50 3a 20 41 6e 20 38 2d 62 79 74 65 _HEAP: An 8-byte
4630: 20 61 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65 72 aligned pointer
4640: 20 74 6f 20 74 68 65 20 6d 65 6d 6f 72 79 2c 20 to the memory,
4650: 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 6e 75 6d the. ** num
4660: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
4670: 74 68 65 20 6d 65 6d 6f 72 79 20 62 75 66 66 65 the memory buffe
4680: 72 2c 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 6d r, and the minim
4690: 75 6d 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 69 um allocation si
46a0: 7a 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ze.. */.
46b0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
46c0: 43 6f 6e 66 69 67 2e 70 48 65 61 70 20 3d 20 76 Config.pHeap = v
46d0: 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 a_arg(ap, void*)
46e0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
46f0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 lobalConfig.nHea
4700: 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 p = va_arg(ap, i
4710: 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 nt);. sqlit
4720: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4730: 6e 52 65 71 20 3d 20 76 61 5f 61 72 67 28 61 70 nReq = va_arg(ap
4740: 2c 20 69 6e 74 29 3b 0a 0a 20 20 20 20 20 20 69 , int);.. i
4750: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
4760: 43 6f 6e 66 69 67 2e 6d 6e 52 65 71 3c 31 20 29 Config.mnReq<1 )
4770: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
4780: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 3GlobalConfig.mn
4790: 52 65 71 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d Req = 1;. }
47a0: 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 else if( sqlite3
47b0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 52 GlobalConfig.mnR
47c0: 65 71 3e 28 31 3c 3c 31 32 29 20 29 7b 0a 20 20 eq>(1<<12) ){.
47d0: 20 20 20 20 20 20 2f 2a 20 63 61 70 20 6d 69 6e /* cap min
47e0: 20 72 65 71 75 65 73 74 20 73 69 7a 65 20 61 74 request size at
47f0: 20 32 5e 31 32 20 2a 2f 0a 20 20 20 20 20 20 20 2^12 */.
4800: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
4810: 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 28 31 3c nfig.mnReq = (1<
4820: 3c 31 32 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 <12);. }..
4830: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
4840: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 GlobalConfig.pHe
4850: 61 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ap==0 ){.
4860: 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
4870: 20 52 2d 34 39 39 32 30 2d 36 30 31 38 39 20 49 R-49920-60189 I
4880: 66 20 74 68 65 20 66 69 72 73 74 20 70 6f 69 6e f the first poin
4890: 74 65 72 20 28 74 68 65 20 6d 65 6d 6f 72 79 20 ter (the memory
48a0: 70 6f 69 6e 74 65 72 29 0a 20 20 20 20 20 20 20 pointer).
48b0: 20 2a 2a 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 ** is NULL, the
48c0: 6e 20 53 51 4c 69 74 65 20 72 65 76 65 72 74 73 n SQLite reverts
48d0: 20 74 6f 20 75 73 69 6e 67 20 69 74 73 20 64 65 to using its de
48e0: 66 61 75 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c fault memory all
48f0: 6f 63 61 74 6f 72 0a 20 20 20 20 20 20 20 20 2a ocator. *
4900: 2a 20 28 74 68 65 20 73 79 73 74 65 6d 20 6d 61 * (the system ma
4910: 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 lloc() implement
4920: 61 74 69 6f 6e 29 2c 20 75 6e 64 6f 69 6e 67 20 ation), undoing
4930: 61 6e 79 20 70 72 69 6f 72 20 69 6e 76 6f 63 61 any prior invoca
4940: 74 69 6f 6e 20 6f 66 0a 20 20 20 20 20 20 20 20 tion of.
4950: 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 ** SQLITE_CONFIG
4960: 5f 4d 41 4c 4c 4f 43 2e 0a 20 20 20 20 20 20 20 _MALLOC..
4970: 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 **. ** S
4980: 65 74 74 69 6e 67 20 73 71 6c 69 74 65 33 47 6c etting sqlite3Gl
4990: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 74 6f 20 obalConfig.m to
49a0: 61 6c 6c 20 7a 65 72 6f 73 20 77 69 6c 6c 20 63 all zeros will c
49b0: 61 75 73 65 20 6d 61 6c 6c 6f 63 20 74 6f 0a 20 ause malloc to.
49c0: 20 20 20 20 20 20 20 2a 2a 20 72 65 76 65 72 74 ** revert
49d0: 20 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 to its default
49e0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 implementation w
49f0: 68 65 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 hen sqlite3_init
4a00: 69 61 6c 69 7a 65 28 29 20 69 73 20 72 75 6e 0a ialize() is run.
4a10: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
4a20: 20 20 20 6d 65 6d 73 65 74 28 26 73 71 6c 69 74 memset(&sqlit
4a30: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4a40: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 , 0, sizeof(sqli
4a50: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
4a60: 6d 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 m));. }else
4a70: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 {. /* EVI
4a80: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 31 30 30 DENCE-OF: R-6100
4a90: 36 2d 30 38 39 31 38 20 49 66 20 74 68 65 20 6d 6-08918 If the m
4aa0: 65 6d 6f 72 79 20 70 6f 69 6e 74 65 72 20 69 73 emory pointer is
4ab0: 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 74 not NULL then t
4ac0: 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6c he. ** al
4ad0: 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 ternative memory
4ae0: 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 65 6e allocator is en
4af0: 67 61 67 65 64 20 74 6f 20 68 61 6e 64 6c 65 20 gaged to handle
4b00: 61 6c 6c 20 6f 66 20 53 51 4c 69 74 65 73 0a 20 all of SQLites.
4b10: 20 20 20 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 ** memory
4b20: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6e 65 65 64 allocation need
4b30: 73 2e 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c s. */.#ifdef SQL
4b40: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
4b50: 53 33 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 S3. sqlit
4b60: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
4b70: 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 = *sqlite3MemGe
4b80: 74 4d 65 6d 73 79 73 33 28 29 3b 0a 23 65 6e 64 tMemsys3();.#end
4b90: 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 if.#ifdef SQLITE
4ba0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 0a _ENABLE_MEMSYS5.
4bb0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 sqlite3G
4bc0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 lobalConfig.m =
4bd0: 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 *sqlite3MemGetMe
4be0: 6d 73 79 73 35 28 29 3b 0a 23 65 6e 64 69 66 0a msys5();.#endif.
4bf0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 }. br
4c00: 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 eak;. }.#endi
4c10: 66 0a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 f.. case SQLI
4c20: 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 TE_CONFIG_LOOKAS
4c30: 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c IDE: {. sql
4c40: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
4c50: 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 76 .szLookaside = v
4c60: 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
4c70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
4c80: 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 balConfig.nLooka
4c90: 73 69 64 65 20 3d 20 76 61 5f 61 72 67 28 61 70 side = va_arg(ap
4ca0: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 , int);. br
4cb0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 0a eak;. }. .
4cc0: 20 20 20 20 2f 2a 20 52 65 63 6f 72 64 20 61 20 /* Record a
4cd0: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6c pointer to the l
4ce0: 6f 67 67 65 72 20 66 75 6e 63 74 69 6f 6e 20 61 ogger function a
4cf0: 6e 64 20 69 74 73 20 66 69 72 73 74 20 61 72 67 nd its first arg
4d00: 75 6d 65 6e 74 2e 0a 20 20 20 20 2a 2a 20 54 68 ument.. ** Th
4d10: 65 20 64 65 66 61 75 6c 74 20 69 73 20 4e 55 4c e default is NUL
4d20: 4c 2e 20 20 4c 6f 67 67 69 6e 67 20 69 73 20 64 L. Logging is d
4d30: 69 73 61 62 6c 65 64 20 69 66 20 74 68 65 20 66 isabled if the f
4d40: 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 unction pointer
4d50: 69 73 0a 20 20 20 20 2a 2a 20 4e 55 4c 4c 2e 0a is. ** NULL..
4d60: 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
4d70: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f SQLITE_CONFIG_LO
4d80: 47 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 4d 53 G: {. /* MS
4d90: 56 43 20 69 73 20 70 69 63 6b 79 20 61 62 6f 75 VC is picky abou
4da0: 74 20 70 75 6c 6c 69 6e 67 20 66 75 6e 63 20 70 t pulling func p
4db0: 74 72 73 20 66 72 6f 6d 20 76 61 20 6c 69 73 74 trs from va list
4dc0: 73 2e 0a 20 20 20 20 20 20 2a 2a 20 68 74 74 70 s.. ** http
4dd0: 3a 2f 2f 73 75 70 70 6f 72 74 2e 6d 69 63 72 6f ://support.micro
4de0: 73 6f 66 74 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 soft.com/kb/4796
4df0: 31 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 1. ** sqlit
4e00: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
4e10: 4c 6f 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c Log = va_arg(ap,
4e20: 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 2c 69 void(*)(void*,i
4e30: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 nt,const char*))
4e40: 3b 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 ;. */.
4e50: 20 74 79 70 65 64 65 66 20 76 6f 69 64 28 2a 4c typedef void(*L
4e60: 4f 47 46 55 4e 43 5f 74 29 28 76 6f 69 64 2a 2c OGFUNC_t)(void*,
4e70: 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 int,const char*)
4e80: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 ;. sqlite3G
4e90: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
4ea0: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 4c 4f = va_arg(ap, LO
4eb0: 47 46 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 GFUNC_t);.
4ec0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
4ed0: 66 69 67 2e 70 4c 6f 67 41 72 67 20 3d 20 76 61 fig.pLogArg = va
4ee0: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b _arg(ap, void*);
4ef0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
4f00: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 45 56 49 44 }.. /* EVID
4f10: 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 35 35 34 38 ENCE-OF: R-55548
4f20: 2d 33 33 38 31 37 20 54 68 65 20 63 6f 6d 70 69 -33817 The compi
4f30: 6c 65 2d 74 69 6d 65 20 73 65 74 74 69 6e 67 20 le-time setting
4f40: 66 6f 72 20 55 52 49 20 66 69 6c 65 6e 61 6d 65 for URI filename
4f50: 73 0a 20 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 s. ** can be
4f60: 63 68 61 6e 67 65 64 20 61 74 20 73 74 61 72 74 changed at start
4f70: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 0a -time using the.
4f80: 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 ** sqlite3_c
4f90: 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e onfig(SQLITE_CON
4fa0: 46 49 47 5f 55 52 49 2c 31 29 20 6f 72 0a 20 20 FIG_URI,1) or.
4fb0: 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e ** sqlite3_con
4fc0: 66 69 67 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 fig(SQLITE_CONFI
4fd0: 47 5f 55 52 49 2c 30 29 20 63 6f 6e 66 69 67 75 G_URI,0) configu
4fe0: 72 61 74 69 6f 6e 20 63 61 6c 6c 73 2e 0a 20 20 ration calls..
4ff0: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
5000: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 55 52 49 3a LITE_CONFIG_URI:
5010: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 {. /* EVID
5020: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 34 35 31 ENCE-OF: R-25451
5030: 2d 36 31 31 32 35 20 54 68 65 20 53 51 4c 49 54 -61125 The SQLIT
5040: 45 5f 43 4f 4e 46 49 47 5f 55 52 49 20 6f 70 74 E_CONFIG_URI opt
5050: 69 6f 6e 20 74 61 6b 65 73 20 61 20 73 69 6e 67 ion takes a sing
5060: 6c 65 0a 20 20 20 20 20 20 2a 2a 20 61 72 67 75 le. ** argu
5070: 6d 65 6e 74 20 6f 66 20 74 79 70 65 20 69 6e 74 ment of type int
5080: 2e 20 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 . If non-zero, t
5090: 68 65 6e 20 55 52 49 20 68 61 6e 64 6c 69 6e 67 hen URI handling
50a0: 20 69 73 20 67 6c 6f 62 61 6c 6c 79 0a 20 20 20 is globally.
50b0: 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e 20 49 ** enabled. I
50c0: 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 f the parameter
50d0: 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 55 52 is zero, then UR
50e0: 49 20 68 61 6e 64 6c 69 6e 67 20 69 73 20 67 6c I handling is gl
50f0: 6f 62 61 6c 6c 79 0a 20 20 20 20 20 20 2a 2a 20 obally. **
5100: 64 69 73 61 62 6c 65 64 2e 20 2a 2f 0a 20 20 20 disabled. */.
5110: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
5120: 43 6f 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 20 Config.bOpenUri
5130: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
5140: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
5150: 20 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 }.. case
5160: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f SQLITE_CONFIG_CO
5170: 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 VERING_INDEX_SCA
5180: 4e 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 N: {. /* EV
5190: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 36 35 IDENCE-OF: R-365
51a0: 39 32 2d 30 32 37 37 32 20 54 68 65 20 53 51 4c 92-02772 The SQL
51b0: 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56 45 52 ITE_CONFIG_COVER
51c0: 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e 0a 20 ING_INDEX_SCAN.
51d0: 20 20 20 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 74 ** option t
51e0: 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 20 69 6e akes a single in
51f0: 74 65 67 65 72 20 61 72 67 75 6d 65 6e 74 20 77 teger argument w
5200: 68 69 63 68 20 69 73 20 69 6e 74 65 72 70 72 65 hich is interpre
5210: 74 65 64 20 61 73 20 61 0a 20 20 20 20 20 20 2a ted as a. *
5220: 2a 20 62 6f 6f 6c 65 61 6e 20 69 6e 20 6f 72 64 * boolean in ord
5230: 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 6f 72 20 er to enable or
5240: 64 69 73 61 62 6c 65 20 74 68 65 20 75 73 65 20 disable the use
5250: 6f 66 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 of covering indi
5260: 63 65 73 20 66 6f 72 0a 20 20 20 20 20 20 2a 2a ces for. **
5270: 20 66 75 6c 6c 20 74 61 62 6c 65 20 73 63 61 6e full table scan
5280: 73 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 6f s in the query o
5290: 70 74 69 6d 69 7a 65 72 2e 20 2a 2f 0a 20 20 20 ptimizer. */.
52a0: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
52b0: 43 6f 6e 66 69 67 2e 62 55 73 65 43 69 73 20 3d Config.bUseCis =
52c0: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
52d0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
52e0: 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c }..#ifdef SQL
52f0: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f ITE_ENABLE_SQLLO
5300: 47 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 G. case SQLIT
5310: 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f 47 3a E_CONFIG_SQLLOG:
5320: 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 {. typedef
5330: 20 76 6f 69 64 28 2a 53 51 4c 4c 4f 47 46 55 4e void(*SQLLOGFUN
5340: 43 5f 74 29 28 76 6f 69 64 2a 2c 20 73 71 6c 69 C_t)(void*, sqli
5350: 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 te3*, const char
5360: 2a 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 73 *, int);. s
5370: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
5380: 69 67 2e 78 53 71 6c 6c 6f 67 20 3d 20 76 61 5f ig.xSqllog = va_
5390: 61 72 67 28 61 70 2c 20 53 51 4c 4c 4f 47 46 55 arg(ap, SQLLOGFU
53a0: 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 73 71 6c NC_t);. sql
53b0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
53c0: 2e 70 53 71 6c 6c 6f 67 41 72 67 20 3d 20 76 61 .pSqllogArg = va
53d0: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 20 2a 29 _arg(ap, void *)
53e0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
53f0: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 }.#endif..
5400: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
5410: 46 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 3a 20 7b FIG_MMAP_SIZE: {
5420: 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e . /* EVIDEN
5430: 43 45 2d 4f 46 3a 20 52 2d 35 38 30 36 33 2d 33 CE-OF: R-58063-3
5440: 38 32 35 38 20 53 51 4c 49 54 45 5f 43 4f 4e 46 8258 SQLITE_CONF
5450: 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 20 74 61 6b IG_MMAP_SIZE tak
5460: 65 73 20 74 77 6f 20 36 34 2d 62 69 74 0a 20 20 es two 64-bit.
5470: 20 20 20 20 2a 2a 20 69 6e 74 65 67 65 72 20 28 ** integer (
5480: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 20 76 sqlite3_int64) v
5490: 61 6c 75 65 73 20 74 68 61 74 20 61 72 65 20 74 alues that are t
54a0: 68 65 20 64 65 66 61 75 6c 74 20 6d 6d 61 70 20 he default mmap
54b0: 73 69 7a 65 20 6c 69 6d 69 74 0a 20 20 20 20 20 size limit.
54c0: 20 2a 2a 20 28 74 68 65 20 64 65 66 61 75 6c 74 ** (the default
54d0: 20 73 65 74 74 69 6e 67 20 66 6f 72 20 50 52 41 setting for PRA
54e0: 47 4d 41 20 6d 6d 61 70 5f 73 69 7a 65 29 20 61 GMA mmap_size) a
54f0: 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 nd the maximum a
5500: 6c 6c 6f 77 65 64 0a 20 20 20 20 20 20 2a 2a 20 llowed. **
5510: 6d 6d 61 70 20 73 69 7a 65 20 6c 69 6d 69 74 2e mmap size limit.
5520: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
5530: 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 20 3d 3_int64 szMmap =
5540: 20 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 va_arg(ap, sqli
5550: 74 65 33 5f 69 6e 74 36 34 29 3b 0a 20 20 20 20 te3_int64);.
5560: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
5570: 6d 78 4d 6d 61 70 20 3d 20 76 61 5f 61 72 67 28 mxMmap = va_arg(
5580: 61 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 ap, sqlite3_int6
5590: 34 29 3b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 4);. /* EVI
55a0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 33 33 36 DENCE-OF: R-5336
55b0: 37 2d 34 33 31 39 30 20 49 66 20 65 69 74 68 65 7-43190 If eithe
55c0: 72 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 r argument to th
55d0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 0a 20 20 20 is option is.
55e0: 20 20 20 2a 2a 20 6e 65 67 61 74 69 76 65 2c 20 ** negative,
55f0: 74 68 65 6e 20 74 68 61 74 20 61 72 67 75 6d 65 then that argume
5600: 6e 74 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f nt is changed to
5610: 20 69 74 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d its compile-tim
5620: 65 20 64 65 66 61 75 6c 74 2e 0a 20 20 20 20 20 e default..
5630: 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 45 56 49 **. ** EVI
5640: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 34 39 39 DENCE-OF: R-3499
5650: 33 2d 34 35 30 33 31 20 54 68 65 20 6d 61 78 69 3-45031 The maxi
5660: 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 6d 6d 61 70 mum allowed mmap
5670: 20 73 69 7a 65 20 77 69 6c 6c 20 62 65 0a 20 20 size will be.
5680: 20 20 20 20 2a 2a 20 73 69 6c 65 6e 74 6c 79 20 ** silently
5690: 74 72 75 6e 63 61 74 65 64 20 69 66 20 6e 65 63 truncated if nec
56a0: 65 73 73 61 72 79 20 73 6f 20 74 68 61 74 20 69 essary so that i
56b0: 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 63 65 65 t does not excee
56c0: 64 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 63 d the. ** c
56d0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6d 61 78 69 ompile-time maxi
56e0: 6d 75 6d 20 6d 6d 61 70 20 73 69 7a 65 20 73 65 mum mmap size se
56f0: 74 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f t by the SQLITE_
5700: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 20 20 MAX_MMAP_SIZE.
5710: 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 ** compile-t
5720: 69 6d 65 20 6f 70 74 69 6f 6e 2e 0a 20 20 20 20 ime option..
5730: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d */. if( m
5740: 78 4d 6d 61 70 3c 30 20 7c 7c 20 6d 78 4d 6d 61 xMmap<0 || mxMma
5750: 70 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 p>SQLITE_MAX_MMA
5760: 50 5f 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 P_SIZE ){.
5770: 20 20 6d 78 4d 6d 61 70 20 3d 20 53 51 4c 49 54 mxMmap = SQLIT
5780: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3b E_MAX_MMAP_SIZE;
5790: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
57a0: 66 28 20 73 7a 4d 6d 61 70 3c 30 20 29 20 73 7a f( szMmap<0 ) sz
57b0: 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f 44 45 Mmap = SQLITE_DE
57c0: 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 3b FAULT_MMAP_SIZE;
57d0: 0a 20 20 20 20 20 20 69 66 28 20 73 7a 4d 6d 61 . if( szMma
57e0: 70 3e 6d 78 4d 6d 61 70 29 20 73 7a 4d 6d 61 70 p>mxMmap) szMmap
57f0: 20 3d 20 6d 78 4d 6d 61 70 3b 0a 20 20 20 20 20 = mxMmap;.
5800: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
5810: 6e 66 69 67 2e 6d 78 4d 6d 61 70 20 3d 20 6d 78 nfig.mxMmap = mx
5820: 4d 6d 61 70 3b 0a 20 20 20 20 20 20 73 71 6c 69 Mmap;. sqli
5830: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
5840: 73 7a 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b szMmap = szMmap;
5850: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
5860: 20 20 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f }..#if SQLITE_
5870: 4f 53 5f 57 49 4e 20 26 26 20 64 65 66 69 6e 65 OS_WIN && define
5880: 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d d(SQLITE_WIN32_M
5890: 41 4c 4c 4f 43 29 20 2f 2a 20 49 4d 50 3a 20 52 ALLOC) /* IMP: R
58a0: 2d 30 34 37 38 30 2d 35 35 38 31 35 20 2a 2f 0a -04780-55815 */.
58b0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
58c0: 43 4f 4e 46 49 47 5f 57 49 4e 33 32 5f 48 45 41 CONFIG_WIN32_HEA
58d0: 50 53 49 5a 45 3a 20 7b 0a 20 20 20 20 20 20 2f PSIZE: {. /
58e0: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
58f0: 2d 33 34 39 32 36 2d 30 33 33 36 30 20 53 51 4c -34926-03360 SQL
5900: 49 54 45 5f 43 4f 4e 46 49 47 5f 57 49 4e 33 32 ITE_CONFIG_WIN32
5910: 5f 48 45 41 50 53 49 5a 45 20 74 61 6b 65 73 20 _HEAPSIZE takes
5920: 61 20 33 32 2d 62 69 74 0a 20 20 20 20 20 20 2a a 32-bit. *
5930: 2a 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 * unsigned integ
5940: 65 72 20 76 61 6c 75 65 20 74 68 61 74 20 73 70 er value that sp
5950: 65 63 69 66 69 65 73 20 74 68 65 20 6d 61 78 69 ecifies the maxi
5960: 6d 75 6d 20 73 69 7a 65 20 6f 66 20 74 68 65 20 mum size of the
5970: 63 72 65 61 74 65 64 0a 20 20 20 20 20 20 2a 2a created. **
5980: 20 68 65 61 70 2e 20 2a 2f 0a 20 20 20 20 20 20 heap. */.
5990: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
59a0: 66 69 67 2e 6e 48 65 61 70 20 3d 20 76 61 5f 61 fig.nHeap = va_a
59b0: 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 rg(ap, int);.
59c0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
59d0: 23 65 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 #endif.. case
59e0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 SQLITE_CONFIG_P
59f0: 4d 41 53 5a 3a 20 7b 0a 20 20 20 20 20 20 73 71 MASZ: {. sq
5a00: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
5a10: 67 2e 73 7a 50 6d 61 20 3d 20 76 61 5f 61 72 67 g.szPma = va_arg
5a20: 28 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e (ap, unsigned in
5a30: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
5a40: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 64 65 66 61 . }.. defa
5a50: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 ult: {. rc
5a60: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a = SQLITE_ERROR;.
5a70: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
5a80: 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 }. }. va_end(
5a90: 61 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ap);. return rc
5aa0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 ;.}../*.** Set u
5ab0: 70 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 p the lookaside
5ac0: 62 75 66 66 65 72 73 20 66 6f 72 20 61 20 64 61 buffers for a da
5ad0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
5ae0: 6e 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c n..** Return SQL
5af0: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 ITE_OK on succes
5b00: 73 2e 20 20 0a 2a 2a 20 49 66 20 6c 6f 6f 6b 61 s. .** If looka
5b10: 73 69 64 65 20 69 73 20 61 6c 72 65 61 64 79 20 side is already
5b20: 61 63 74 69 76 65 2c 20 72 65 74 75 72 6e 20 53 active, return S
5b30: 51 4c 49 54 45 5f 42 55 53 59 2e 0a 2a 2a 0a 2a QLITE_BUSY..**.*
5b40: 2a 20 54 68 65 20 73 7a 20 70 61 72 61 6d 65 74 * The sz paramet
5b50: 65 72 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 er is the number
5b60: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 65 61 63 of bytes in eac
5b70: 68 20 6c 6f 6f 6b 61 73 69 64 65 20 73 6c 6f 74 h lookaside slot
5b80: 2e 0a 2a 2a 20 54 68 65 20 63 6e 74 20 70 61 72 ..** The cnt par
5b90: 61 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e 75 ameter is the nu
5ba0: 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 2e 20 20 mber of slots.
5bb0: 49 66 20 70 53 74 61 72 74 20 69 73 20 4e 55 4c If pStart is NUL
5bc0: 4c 20 74 68 65 0a 2a 2a 20 73 70 61 63 65 20 66 L the.** space f
5bd0: 6f 72 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 or the lookaside
5be0: 20 6d 65 6d 6f 72 79 20 69 73 20 6f 62 74 61 69 memory is obtai
5bf0: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 ned from sqlite3
5c00: 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 49 66 _malloc()..** If
5c10: 20 70 53 74 61 72 74 20 69 73 20 6e 6f 74 20 4e pStart is not N
5c20: 55 4c 4c 20 74 68 65 6e 20 69 74 20 69 73 20 73 ULL then it is s
5c30: 7a 2a 63 6e 74 20 62 79 74 65 73 20 6f 66 20 6d z*cnt bytes of m
5c40: 65 6d 6f 72 79 20 74 6f 20 75 73 65 20 66 6f 72 emory to use for
5c50: 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 .** the lookasid
5c60: 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 e memory..*/.sta
5c70: 74 69 63 20 69 6e 74 20 73 65 74 75 70 4c 6f 6f tic int setupLoo
5c80: 6b 61 73 69 64 65 28 73 71 6c 69 74 65 33 20 2a kaside(sqlite3 *
5c90: 64 62 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 db, void *pBuf,
5ca0: 69 6e 74 20 73 7a 2c 20 69 6e 74 20 63 6e 74 29 int sz, int cnt)
5cb0: 7b 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 72 74 {. void *pStart
5cc0: 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b ;. if( db->look
5cd0: 61 73 69 64 65 2e 6e 4f 75 74 20 29 7b 0a 20 20 aside.nOut ){.
5ce0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
5cf0: 42 55 53 59 3b 0a 20 20 7d 0a 20 20 2f 2a 20 46 BUSY;. }. /* F
5d00: 72 65 65 20 61 6e 79 20 65 78 69 73 74 69 6e 67 ree any existing
5d10: 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 lookaside buffe
5d20: 72 20 66 6f 72 20 74 68 69 73 20 68 61 6e 64 6c r for this handl
5d30: 65 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 6c e before. ** al
5d40: 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 6f locating a new o
5d50: 6e 65 20 73 6f 20 77 65 20 64 6f 6e 27 74 20 68 ne so we don't h
5d60: 61 76 65 20 74 6f 20 68 61 76 65 20 73 70 61 63 ave to have spac
5d70: 65 20 66 6f 72 20 0a 20 20 2a 2a 20 62 6f 74 68 e for . ** both
5d80: 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d at the same tim
5d90: 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 e.. */. if( db
5da0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 6c ->lookaside.bMal
5db0: 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 6c loced ){. sql
5dc0: 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c 6f ite3_free(db->lo
5dd0: 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 3b okaside.pStart);
5de0: 0a 20 20 7d 0a 20 20 2f 2a 20 54 68 65 20 73 69 . }. /* The si
5df0: 7a 65 20 6f 66 20 61 20 6c 6f 6f 6b 61 73 69 64 ze of a lookasid
5e00: 65 20 73 6c 6f 74 20 61 66 74 65 72 20 52 4f 55 e slot after ROU
5e10: 4e 44 44 4f 57 4e 38 20 6e 65 65 64 73 20 74 6f NDDOWN8 needs to
5e20: 20 62 65 20 6c 61 72 67 65 72 0a 20 20 2a 2a 20 be larger. **
5e30: 74 68 61 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 than a pointer t
5e40: 6f 20 62 65 20 75 73 65 66 75 6c 2e 0a 20 20 2a o be useful.. *
5e50: 2f 0a 20 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f /. sz = ROUNDDO
5e60: 57 4e 38 28 73 7a 29 3b 20 20 2f 2a 20 49 4d 50 WN8(sz); /* IMP
5e70: 3a 20 52 2d 33 33 30 33 38 2d 30 39 33 38 32 20 : R-33038-09382
5e80: 2a 2f 0a 20 20 69 66 28 20 73 7a 3c 3d 28 69 6e */. if( sz<=(in
5e90: 74 29 73 69 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 t)sizeof(Lookasi
5ea0: 64 65 53 6c 6f 74 2a 29 20 29 20 73 7a 20 3d 20 deSlot*) ) sz =
5eb0: 30 3b 0a 20 20 69 66 28 20 63 6e 74 3c 30 20 29 0;. if( cnt<0 )
5ec0: 20 63 6e 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 cnt = 0;. if(
5ed0: 73 7a 3d 3d 30 20 7c 7c 20 63 6e 74 3d 3d 30 20 sz==0 || cnt==0
5ee0: 29 7b 0a 20 20 20 20 73 7a 20 3d 20 30 3b 0a 20 ){. sz = 0;.
5ef0: 20 20 20 70 53 74 61 72 74 20 3d 20 30 3b 0a 20 pStart = 0;.
5f00: 20 7d 65 6c 73 65 20 69 66 28 20 70 42 75 66 3d }else if( pBuf=
5f10: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 =0 ){. sqlite
5f20: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
5f30: 6f 63 28 29 3b 0a 20 20 20 20 70 53 74 61 72 74 oc();. pStart
5f40: 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 = sqlite3Malloc
5f50: 28 20 73 7a 2a 63 6e 74 20 29 3b 20 20 2f 2a 20 ( sz*cnt ); /*
5f60: 49 4d 50 3a 20 52 2d 36 31 39 34 39 2d 33 35 37 IMP: R-61949-357
5f70: 32 37 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 27 */. sqlite
5f80: 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3EndBenignMalloc
5f90: 28 29 3b 0a 20 20 20 20 69 66 28 20 70 53 74 61 ();. if( pSta
5fa0: 72 74 20 29 20 63 6e 74 20 3d 20 73 71 6c 69 74 rt ) cnt = sqlit
5fb0: 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 53 74 e3MallocSize(pSt
5fc0: 61 72 74 29 2f 73 7a 3b 0a 20 20 7d 65 6c 73 65 art)/sz;. }else
5fd0: 7b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 20 70 {. pStart = p
5fe0: 42 75 66 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 6c Buf;. }. db->l
5ff0: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 20 ookaside.pStart
6000: 3d 20 70 53 74 61 72 74 3b 0a 20 20 64 62 2d 3e = pStart;. db->
6010: 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 20 lookaside.pFree
6020: 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c 6f 6f 6b 61 = 0;. db->looka
6030: 73 69 64 65 2e 73 7a 20 3d 20 28 75 31 36 29 73 side.sz = (u16)s
6040: 7a 3b 0a 20 20 69 66 28 20 70 53 74 61 72 74 20 z;. if( pStart
6050: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 ){. int i;.
6060: 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 LookasideSlot
6070: 2a 70 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 *p;. assert(
6080: 73 7a 20 3e 20 28 69 6e 74 29 73 69 7a 65 6f 66 sz > (int)sizeof
6090: 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 (LookasideSlot*)
60a0: 20 29 3b 0a 20 20 20 20 70 20 3d 20 28 4c 6f 6f );. p = (Loo
60b0: 6b 61 73 69 64 65 53 6c 6f 74 2a 29 70 53 74 61 kasideSlot*)pSta
60c0: 72 74 3b 0a 20 20 20 20 66 6f 72 28 69 3d 63 6e rt;. for(i=cn
60d0: 74 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b t-1; i>=0; i--){
60e0: 0a 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 . p->pNext
60f0: 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e = db->lookaside.
6100: 70 46 72 65 65 3b 0a 20 20 20 20 20 20 64 62 2d pFree;. db-
6110: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 >lookaside.pFree
6120: 20 3d 20 70 3b 0a 20 20 20 20 20 20 70 20 3d 20 = p;. p =
6130: 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 (LookasideSlot*)
6140: 26 28 28 75 38 2a 29 70 29 5b 73 7a 5d 3b 0a 20 &((u8*)p)[sz];.
6150: 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f }. db->loo
6160: 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 70 3b kaside.pEnd = p;
6170: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
6180: 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 31 3b de.bEnabled = 1;
6190: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
61a0: 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 70 de.bMalloced = p
61b0: 42 75 66 3d 3d 30 20 3f 31 3a 30 3b 0a 20 20 7d Buf==0 ?1:0;. }
61c0: 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 6c 6f else{. db->lo
61d0: 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 20 3d okaside.pStart =
61e0: 20 64 62 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f db;. db->loo
61f0: 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 64 62 kaside.pEnd = db
6200: 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ;. db->lookas
6210: 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 30 ide.bEnabled = 0
6220: 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ;. db->lookas
6230: 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 ide.bMalloced =
6240: 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 0;. }. return
6250: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
6260: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d .** Return the m
6270: 75 74 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 utex associated
6280: 77 69 74 68 20 61 20 64 61 74 61 62 61 73 65 20 with a database
6290: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 connection..*/.s
62a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 qlite3_mutex *sq
62b0: 6c 69 74 65 33 5f 64 62 5f 6d 75 74 65 78 28 73 lite3_db_mutex(s
62c0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 qlite3 *db){.#if
62d0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
62e0: 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
62f0: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
6300: 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
6310: 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
6320: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
6330: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 return 0;. }.#
6340: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 64 endif. return d
6350: 62 2d 3e 6d 75 74 65 78 3b 0a 7d 0a 0a 2f 2a 0a b->mutex;.}../*.
6360: 2a 2a 20 46 72 65 65 20 75 70 20 61 73 20 6d 75 ** Free up as mu
6370: 63 68 20 6d 65 6d 6f 72 79 20 61 73 20 77 65 20 ch memory as we
6380: 63 61 6e 20 66 72 6f 6d 20 74 68 65 20 67 69 76 can from the giv
6390: 65 6e 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 en database.** c
63a0: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e onnection..*/.in
63b0: 74 20 73 71 6c 69 74 65 33 5f 64 62 5f 72 65 6c t sqlite3_db_rel
63c0: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 73 71 6c 69 ease_memory(sqli
63d0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 te3 *db){. int
63e0: 69 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 i;..#ifdef SQLIT
63f0: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
6400: 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
6410: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
6420: 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 b) ) return SQLI
6430: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
6440: 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 #endif. sqlite3
6450: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
6460: 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 >mutex);. sqlit
6470: 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 e3BtreeEnterAll(
6480: 64 62 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 db);. for(i=0;
6490: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b i<db->nDb; i++){
64a0: 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 . Btree *pBt
64b0: 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 = db->aDb[i].pBt
64c0: 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20 29 7b ;. if( pBt ){
64d0: 0a 20 20 20 20 20 20 50 61 67 65 72 20 2a 70 50 . Pager *pP
64e0: 61 67 65 72 20 3d 20 73 71 6c 69 74 65 33 42 74 ager = sqlite3Bt
64f0: 72 65 65 50 61 67 65 72 28 70 42 74 29 3b 0a 20 reePager(pBt);.
6500: 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 sqlite3Page
6510: 72 53 68 72 69 6e 6b 28 70 50 61 67 65 72 29 3b rShrink(pPager);
6520: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c . }. }. sql
6530: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c ite3BtreeLeaveAl
6540: 6c 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 l(db);. sqlite3
6550: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
6560: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
6570: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
6580: 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 61 74 /*.** Configurat
6590: 69 6f 6e 20 73 65 74 74 69 6e 67 73 20 66 6f 72 ion settings for
65a0: 20 61 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 64 an individual d
65b0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
65c0: 6f 6e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 on.*/.int sqlite
65d0: 33 5f 64 62 5f 63 6f 6e 66 69 67 28 73 71 6c 69 3_db_config(sqli
65e0: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6f 70 2c te3 *db, int op,
65f0: 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 ...){. va_list
6600: 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ap;. int rc;.
6610: 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20 6f 70 va_start(ap, op
6620: 29 3b 0a 20 20 73 77 69 74 63 68 28 20 6f 70 20 );. switch( op
6630: 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 ){. case SQLI
6640: 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4c 4f 4f 4b TE_DBCONFIG_LOOK
6650: 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 76 ASIDE: {. v
6660: 6f 69 64 20 2a 70 42 75 66 20 3d 20 76 61 5f 61 oid *pBuf = va_a
6670: 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 20 2f rg(ap, void*); /
6680: 2a 20 49 4d 50 3a 20 52 2d 32 36 38 33 35 2d 31 * IMP: R-26835-1
6690: 30 39 36 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 0964 */. in
66a0: 74 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 t sz = va_arg(ap
66b0: 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 20 2f 2a , int); /*
66c0: 20 49 4d 50 3a 20 52 2d 34 37 38 37 31 2d 32 35 IMP: R-47871-25
66d0: 39 39 34 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 994 */. int
66e0: 20 63 6e 74 20 3d 20 76 61 5f 61 72 67 28 61 70 cnt = va_arg(ap
66f0: 2c 20 69 6e 74 29 3b 20 20 20 20 20 20 2f 2a 20 , int); /*
6700: 49 4d 50 3a 20 52 2d 30 34 34 36 30 2d 35 33 33 IMP: R-04460-533
6710: 38 36 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 86 */. rc =
6720: 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 65 28 setupLookaside(
6730: 64 62 2c 20 70 42 75 66 2c 20 73 7a 2c 20 63 6e db, pBuf, sz, cn
6740: 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
6750: 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 . }. defau
6760: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 73 74 61 74 lt: {. stat
6770: 69 63 20 63 6f 6e 73 74 20 73 74 72 75 63 74 20 ic const struct
6780: 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6f 70 {. int op
6790: 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 70 ; /* The op
67a0: 63 6f 64 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 code */.
67b0: 75 33 32 20 6d 61 73 6b 3b 20 20 20 20 2f 2a 20 u32 mask; /*
67c0: 4d 61 73 6b 20 6f 66 20 74 68 65 20 62 69 74 20 Mask of the bit
67d0: 69 6e 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 73 in sqlite3.flags
67e0: 20 74 6f 20 73 65 74 2f 63 6c 65 61 72 20 2a 2f to set/clear */
67f0: 0a 20 20 20 20 20 20 7d 20 61 46 6c 61 67 4f 70 . } aFlagOp
6800: 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 20 7b [] = {. {
6810: 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 SQLITE_DBCONFIG
6820: 5f 45 4e 41 42 4c 45 5f 46 4b 45 59 2c 20 20 20 _ENABLE_FKEY,
6830: 20 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b SQLITE_ForeignK
6840: 65 79 73 20 20 20 20 7d 2c 0a 20 20 20 20 20 20 eys },.
6850: 20 20 7b 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e { SQLITE_DBCON
6860: 46 49 47 5f 45 4e 41 42 4c 45 5f 54 52 49 47 47 FIG_ENABLE_TRIGG
6870: 45 52 2c 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c ER, SQLITE_Enabl
6880: 65 54 72 69 67 67 65 72 20 20 7d 2c 0a 20 20 20 eTrigger },.
6890: 20 20 20 7d 3b 0a 20 20 20 20 20 20 75 6e 73 69 };. unsi
68a0: 67 6e 65 64 20 69 6e 74 20 69 3b 0a 20 20 20 20 gned int i;.
68b0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
68c0: 52 4f 52 3b 20 2f 2a 20 49 4d 50 3a 20 52 2d 34 ROR; /* IMP: R-4
68d0: 32 37 39 30 2d 32 33 33 37 32 20 2a 2f 0a 20 20 2790-23372 */.
68e0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 41 for(i=0; i<A
68f0: 72 72 61 79 53 69 7a 65 28 61 46 6c 61 67 4f 70 rraySize(aFlagOp
6900: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 ); i++){.
6910: 20 69 66 28 20 61 46 6c 61 67 4f 70 5b 69 5d 2e if( aFlagOp[i].
6920: 6f 70 3d 3d 6f 70 20 29 7b 0a 20 20 20 20 20 20 op==op ){.
6930: 20 20 20 20 69 6e 74 20 6f 6e 6f 66 66 20 3d 20 int onoff =
6940: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
6950: 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 2a . int *
6960: 70 52 65 73 20 3d 20 76 61 5f 61 72 67 28 61 70 pRes = va_arg(ap
6970: 2c 20 69 6e 74 2a 29 3b 0a 20 20 20 20 20 20 20 , int*);.
6980: 20 20 20 69 6e 74 20 6f 6c 64 46 6c 61 67 73 20 int oldFlags
6990: 3d 20 64 62 2d 3e 66 6c 61 67 73 3b 0a 20 20 20 = db->flags;.
69a0: 20 20 20 20 20 20 20 69 66 28 20 6f 6e 6f 66 66 if( onoff
69b0: 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 >0 ){.
69c0: 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 61 db->flags |= a
69d0: 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 3b 0a FlagOp[i].mask;.
69e0: 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 }else
69f0: 69 66 28 20 6f 6e 6f 66 66 3d 3d 30 20 29 7b 0a if( onoff==0 ){.
6a00: 20 20 20 20 20 20 20 20 20 20 20 20 64 62 2d 3e db->
6a10: 66 6c 61 67 73 20 26 3d 20 7e 61 46 6c 61 67 4f flags &= ~aFlagO
6a20: 70 5b 69 5d 2e 6d 61 73 6b 3b 0a 20 20 20 20 20 p[i].mask;.
6a30: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
6a40: 20 69 66 28 20 6f 6c 64 46 6c 61 67 73 21 3d 64 if( oldFlags!=d
6a50: 62 2d 3e 66 6c 61 67 73 20 29 7b 0a 20 20 20 20 b->flags ){.
6a60: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 sqlite3E
6a70: 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 xpirePreparedSta
6a80: 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 tements(db);.
6a90: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
6aa0: 20 20 20 69 66 28 20 70 52 65 73 20 29 7b 0a 20 if( pRes ){.
6ab0: 20 20 20 20 20 20 20 20 20 20 20 2a 70 52 65 73 *pRes
6ac0: 20 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 = (db->flags &
6ad0: 61 46 6c 61 67 4f 70 5b 69 5d 2e 6d 61 73 6b 29 aFlagOp[i].mask)
6ae0: 21 3d 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d !=0;. }
6af0: 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
6b00: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 SQLITE_OK;.
6b10: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
6b20: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
6b30: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
6b40: 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 . }. va_end(ap
6b50: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
6b60: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e }.../*.** Return
6b70: 20 74 72 75 65 20 69 66 20 74 68 65 20 62 75 66 true if the buf
6b80: 66 65 72 20 7a 5b 30 2e 2e 6e 2d 31 5d 20 63 6f fer z[0..n-1] co
6b90: 6e 74 61 69 6e 73 20 61 6c 6c 20 73 70 61 63 65 ntains all space
6ba0: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 s..*/.static int
6bb0: 20 61 6c 6c 53 70 61 63 65 73 28 63 6f 6e 73 74 allSpaces(const
6bc0: 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 char *z, int n)
6bd0: 7b 0a 20 20 77 68 69 6c 65 28 20 6e 3e 30 20 26 {. while( n>0 &
6be0: 26 20 7a 5b 6e 2d 31 5d 3d 3d 27 20 27 20 29 7b & z[n-1]==' ' ){
6bf0: 20 6e 2d 2d 3b 20 7d 0a 20 20 72 65 74 75 72 6e n--; }. return
6c00: 20 6e 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n==0;.}../*.**
6c10: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 This is the defa
6c20: 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 ult collating fu
6c30: 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49 nction named "BI
6c40: 4e 41 52 59 22 20 77 68 69 63 68 20 69 73 20 61 NARY" which is a
6c50: 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62 lways.** availab
6c60: 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 le..**.** If the
6c70: 20 70 61 64 46 6c 61 67 20 61 72 67 75 6d 65 6e padFlag argumen
6c80: 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 t is not NULL th
6c90: 65 6e 20 73 70 61 63 65 20 70 61 64 64 69 6e 67 en space padding
6ca0: 20 61 74 20 74 68 65 20 65 6e 64 0a 2a 2a 20 6f at the end.** o
6cb0: 66 20 73 74 72 69 6e 67 73 20 69 73 20 69 67 6e f strings is ign
6cc0: 6f 72 65 64 2e 20 20 54 68 69 73 20 69 6d 70 6c ored. This impl
6cd0: 65 6d 65 6e 74 73 20 74 68 65 20 52 54 52 49 4d ements the RTRIM
6ce0: 20 63 6f 6c 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 collation..*/.s
6cf0: 74 61 74 69 63 20 69 6e 74 20 62 69 6e 43 6f 6c tatic int binCol
6d00: 6c 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 70 lFunc(. void *p
6d10: 61 64 46 6c 61 67 2c 0a 20 20 69 6e 74 20 6e 4b adFlag,. int nK
6d20: 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey1, const void
6d30: 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b *pKey1,. int nK
6d40: 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey2, const void
6d50: 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 *pKey2.){. int
6d60: 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e 4b 65 rc, n;. n = nKe
6d70: 79 31 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65 79 31 y1<nKey2 ? nKey1
6d80: 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 2f 2a 20 45 : nKey2;. /* E
6d90: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 35 VIDENCE-OF: R-65
6da0: 30 33 33 2d 32 38 34 34 39 20 54 68 65 20 62 75 033-28449 The bu
6db0: 69 6c 74 2d 69 6e 20 42 49 4e 41 52 59 20 63 6f ilt-in BINARY co
6dc0: 6c 6c 61 74 69 6f 6e 20 63 6f 6d 70 61 72 65 73 llation compares
6dd0: 0a 20 20 2a 2a 20 73 74 72 69 6e 67 73 20 62 79 . ** strings by
6de0: 74 65 20 62 79 20 62 79 74 65 20 75 73 69 6e 67 te by byte using
6df0: 20 74 68 65 20 6d 65 6d 63 6d 70 28 29 20 66 75 the memcmp() fu
6e00: 6e 63 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 nction from the
6e10: 73 74 61 6e 64 61 72 64 20 43 0a 20 20 2a 2a 20 standard C. **
6e20: 6c 69 62 72 61 72 79 2e 20 2a 2f 0a 20 20 72 63 library. */. rc
6e30: 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 31 2c = memcmp(pKey1,
6e40: 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 69 66 pKey2, n);. if
6e50: 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 69 ( rc==0 ){. i
6e60: 66 28 20 70 61 64 46 6c 61 67 0a 20 20 20 20 20 f( padFlag.
6e70: 26 26 20 61 6c 6c 53 70 61 63 65 73 28 28 28 63 && allSpaces(((c
6e80: 68 61 72 2a 29 70 4b 65 79 31 29 2b 6e 2c 20 6e har*)pKey1)+n, n
6e90: 4b 65 79 31 2d 6e 29 0a 20 20 20 20 20 26 26 20 Key1-n). &&
6ea0: 61 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 72 allSpaces(((char
6eb0: 2a 29 70 4b 65 79 32 29 2b 6e 2c 20 6e 4b 65 79 *)pKey2)+n, nKey
6ec0: 32 2d 6e 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 2-n). ){.
6ed0: 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
6ee0: 3a 20 52 2d 33 31 36 32 34 2d 32 34 37 33 37 20 : R-31624-24737
6ef0: 52 54 52 49 4d 20 69 73 20 6c 69 6b 65 20 42 49 RTRIM is like BI
6f00: 4e 41 52 59 20 65 78 63 65 70 74 20 74 68 61 74 NARY except that
6f10: 20 65 78 74 72 61 0a 20 20 20 20 20 20 2a 2a 20 extra. **
6f20: 73 70 61 63 65 73 20 61 74 20 74 68 65 20 65 6e spaces at the en
6f30: 64 20 6f 66 20 65 69 74 68 65 72 20 73 74 72 69 d of either stri
6f40: 6e 67 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 ng do not change
6f50: 20 74 68 65 20 72 65 73 75 6c 74 2e 20 49 6e 20 the result. In
6f60: 6f 74 68 65 72 0a 20 20 20 20 20 20 2a 2a 20 77 other. ** w
6f70: 6f 72 64 73 2c 20 73 74 72 69 6e 67 73 20 77 69 ords, strings wi
6f80: 6c 6c 20 63 6f 6d 70 61 72 65 20 65 71 75 61 6c ll compare equal
6f90: 20 74 6f 20 6f 6e 65 20 61 6e 6f 74 68 65 72 20 to one another
6fa0: 61 73 20 6c 6f 6e 67 20 61 73 20 74 68 65 79 0a as long as they.
6fb0: 20 20 20 20 20 20 2a 2a 20 64 69 66 66 65 72 20 ** differ
6fc0: 6f 6e 6c 79 20 69 6e 20 74 68 65 20 6e 75 6d 62 only in the numb
6fd0: 65 72 20 6f 66 20 73 70 61 63 65 73 20 61 74 20 er of spaces at
6fe0: 74 68 65 20 65 6e 64 2e 0a 20 20 20 20 20 20 2a the end.. *
6ff0: 2f 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 /. }else{.
7000: 20 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 rc = nKey1 -
7010: 6e 4b 65 79 32 3b 0a 20 20 20 20 7d 0a 20 20 7d nKey2;. }. }
7020: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
7030: 0a 2f 2a 0a 2a 2a 20 41 6e 6f 74 68 65 72 20 62 ./*.** Another b
7040: 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e uilt-in collatin
7050: 67 20 73 65 71 75 65 6e 63 65 3a 20 4e 4f 43 41 g sequence: NOCA
7060: 53 45 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 SE. .**.** This
7070: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
7080: 63 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 ce is intended t
7090: 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 22 63 o be used for "c
70a0: 61 73 65 20 69 6e 64 65 70 65 6e 64 65 6e 74 0a ase independent.
70b0: 2a 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 ** comparison".
70c0: 53 51 4c 69 74 65 27 73 20 6b 6e 6f 77 6c 65 64 SQLite's knowled
70d0: 67 65 20 6f 66 20 75 70 70 65 72 20 61 6e 64 20 ge of upper and
70e0: 6c 6f 77 65 72 20 63 61 73 65 20 65 71 75 69 76 lower case equiv
70f0: 61 6c 65 6e 74 73 0a 2a 2a 20 65 78 74 65 6e 64 alents.** extend
7100: 73 20 6f 6e 6c 79 20 74 6f 20 74 68 65 20 32 36 s only to the 26
7110: 20 63 68 61 72 61 63 74 65 72 73 20 75 73 65 64 characters used
7120: 20 69 6e 20 74 68 65 20 45 6e 67 6c 69 73 68 20 in the English
7130: 6c 61 6e 67 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 language..**.**
7140: 41 74 20 74 68 65 20 6d 6f 6d 65 6e 74 20 74 68 At the moment th
7150: 65 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 55 54 ere is only a UT
7160: 46 2d 38 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 F-8 implementati
7170: 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e on..*/.static in
7180: 74 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e t nocaseCollatin
7190: 67 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 4e gFunc(. void *N
71a0: 6f 74 55 73 65 64 2c 0a 20 20 69 6e 74 20 6e 4b otUsed,. int nK
71b0: 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey1, const void
71c0: 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b *pKey1,. int nK
71d0: 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 ey2, const void
71e0: 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 *pKey2.){. int
71f0: 72 20 3d 20 73 71 6c 69 74 65 33 53 74 72 4e 49 r = sqlite3StrNI
7200: 43 6d 70 28 0a 20 20 20 20 20 20 28 63 6f 6e 73 Cmp(. (cons
7210: 74 20 63 68 61 72 20 2a 29 70 4b 65 79 31 2c 20 t char *)pKey1,
7220: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 4b (const char *)pK
7230: 65 79 32 2c 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 ey2, (nKey1<nKey
7240: 32 29 3f 6e 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 2)?nKey1:nKey2);
7250: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
7260: 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
7270: 69 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 if( 0==r ){.
7280: 72 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b r = nKey1-nKey2;
7290: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b . }. return r;
72a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
72b0: 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 the ROWID of th
72c0: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e e most recent in
72d0: 73 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 sert.*/.sqlite_i
72e0: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 nt64 sqlite3_las
72f0: 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 t_insert_rowid(s
7300: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 qlite3 *db){.#if
7310: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
7320: 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 E_API_ARMOR. if
7330: 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 ( !sqlite3Safety
7340: 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 CheckOk(db) ){.
7350: 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f (void)SQLITE_
7360: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 MISUSE_BKPT;.
7370: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 return 0;. }.#
7380: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 64 endif. return d
7390: 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d 0a b->lastRowid;.}.
73a0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
73b0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 6e e number of chan
73c0: 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 20 ges in the most
73d0: 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 73 recent call to s
73e0: 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a 2a qlite3_exec()..*
73f0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 68 /.int sqlite3_ch
7400: 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 anges(sqlite3 *d
7410: 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 b){.#ifdef SQLIT
7420: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
7430: 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
7440: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
7450: 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 b) ){. (void)
7460: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
7470: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 PT;. return 0
7480: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 ;. }.#endif. r
7490: 65 74 75 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 eturn db->nChang
74a0: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 e;.}../*.** Retu
74b0: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
74c0: 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 20 74 changes since t
74d0: 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
74e0: 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a le was opened..*
74f0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f /.int sqlite3_to
7500: 74 61 6c 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 tal_changes(sqli
7510: 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 65 66 te3 *db){.#ifdef
7520: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 SQLITE_ENABLE_A
7530: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 PI_ARMOR. if( !
7540: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
7550: 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 ckOk(db) ){.
7560: 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 (void)SQLITE_MIS
7570: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 USE_BKPT;. re
7580: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 turn 0;. }.#end
7590: 69 66 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e if. return db->
75a0: 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a nTotalChange;.}.
75b0: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c ./*.** Close all
75c0: 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 open savepoints
75d0: 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
75e0: 6f 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 65 73 only manipulates
75f0: 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 0a 2a fields of the.*
7600: 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c * database handl
7610: 65 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 6f 65 e object, it doe
7620: 73 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e 79 20 s not close any
7630: 73 61 76 65 70 6f 69 6e 74 73 20 74 68 61 74 20 savepoints that
7640: 6d 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a 20 61 may be open.** a
7650: 74 20 74 68 65 20 62 2d 74 72 65 65 2f 70 61 67 t the b-tree/pag
7660: 65 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 6f 69 er level..*/.voi
7670: 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 d sqlite3CloseSa
7680: 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 65 33 vepoints(sqlite3
7690: 20 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 28 20 *db){. while(
76a0: 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 29 db->pSavepoint )
76b0: 7b 0a 20 20 20 20 53 61 76 65 70 6f 69 6e 74 20 {. Savepoint
76c0: 2a 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 61 76 *pTmp = db->pSav
76d0: 65 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 2d 3e epoint;. db->
76e0: 70 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 54 6d pSavepoint = pTm
76f0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 p->pNext;. sq
7700: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
7710: 70 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 62 2d pTmp);. }. db-
7720: 3e 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b >nSavepoint = 0;
7730: 0a 20 20 64 62 2d 3e 6e 53 74 61 74 65 6d 65 6e . db->nStatemen
7740: 74 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 69 73 54 t = 0;. db->isT
7750: 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 70 6f ransactionSavepo
7760: 69 6e 74 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a int = 0;.}../*.*
7770: 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 64 65 73 * Invoke the des
7780: 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e tructor function
7790: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
77a0: 20 46 75 6e 63 44 65 66 20 70 2c 20 69 66 20 61 FuncDef p, if a
77b0: 6e 79 2e 20 45 78 63 65 70 74 2c 0a 2a 2a 20 69 ny. Except,.** i
77c0: 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 f this is not th
77d0: 65 20 6c 61 73 74 20 63 6f 70 79 20 6f 66 20 74 e last copy of t
77e0: 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 64 6f 20 he function, do
77f0: 6e 6f 74 20 69 6e 76 6f 6b 65 20 69 74 2e 20 4d not invoke it. M
7800: 75 6c 74 69 70 6c 65 0a 2a 2a 20 63 6f 70 69 65 ultiple.** copie
7810: 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 66 75 s of a single fu
7820: 6e 63 74 69 6f 6e 20 61 72 65 20 63 72 65 61 74 nction are creat
7830: 65 64 20 77 68 65 6e 20 63 72 65 61 74 65 5f 66 ed when create_f
7840: 75 6e 63 74 69 6f 6e 28 29 20 69 73 20 63 61 6c unction() is cal
7850: 6c 65 64 0a 2a 2a 20 77 69 74 68 20 53 51 4c 49 led.** with SQLI
7860: 54 45 5f 41 4e 59 20 61 73 20 74 68 65 20 65 6e TE_ANY as the en
7870: 63 6f 64 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 coding..*/.stati
7880: 63 20 76 6f 69 64 20 66 75 6e 63 74 69 6f 6e 44 c void functionD
7890: 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 20 2a estroy(sqlite3 *
78a0: 64 62 2c 20 46 75 6e 63 44 65 66 20 2a 70 29 7b db, FuncDef *p){
78b0: 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f . FuncDestructo
78c0: 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 20 3d r *pDestructor =
78d0: 20 70 2d 3e 70 44 65 73 74 72 75 63 74 6f 72 3b p->pDestructor;
78e0: 0a 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 . if( pDestruct
78f0: 6f 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 72 or ){. pDestr
7900: 75 63 74 6f 72 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 uctor->nRef--;.
7910: 20 20 20 69 66 28 20 70 44 65 73 74 72 75 63 74 if( pDestruct
7920: 6f 72 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 or->nRef==0 ){.
7930: 20 20 20 20 20 70 44 65 73 74 72 75 63 74 6f 72 pDestructor
7940: 2d 3e 78 44 65 73 74 72 6f 79 28 70 44 65 73 74 ->xDestroy(pDest
7950: 72 75 63 74 6f 72 2d 3e 70 55 73 65 72 44 61 74 ructor->pUserDat
7960: 61 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 a);. sqlite
7970: 33 44 62 46 72 65 65 28 64 62 2c 20 70 44 65 73 3DbFree(db, pDes
7980: 74 72 75 63 74 6f 72 29 3b 0a 20 20 20 20 7d 0a tructor);. }.
7990: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 }.}../*.** Dis
79a0: 63 6f 6e 6e 65 63 74 20 61 6c 6c 20 73 71 6c 69 connect all sqli
79b0: 74 65 33 5f 76 74 61 62 20 6f 62 6a 65 63 74 73 te3_vtab objects
79c0: 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 that belong to
79d0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
79e0: 69 6f 6e 0a 2a 2a 20 64 62 2e 20 54 68 69 73 20 ion.** db. This
79f0: 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 64 is called when d
7a00: 62 20 69 73 20 62 65 69 6e 67 20 63 6c 6f 73 65 b is being close
7a10: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 d..*/.static voi
7a20: 64 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 d disconnectAllV
7a30: 74 61 62 28 73 71 6c 69 74 65 33 20 2a 64 62 29 tab(sqlite3 *db)
7a40: 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
7a50: 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
7a60: 4c 45 0a 20 20 69 6e 74 20 69 3b 0a 20 20 73 71 LE. int i;. sq
7a70: 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 lite3BtreeEnterA
7a80: 6c 6c 28 64 62 29 3b 0a 20 20 66 6f 72 28 69 3d ll(db);. for(i=
7a90: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
7aa0: 2b 29 7b 0a 20 20 20 20 53 63 68 65 6d 61 20 2a +){. Schema *
7ab0: 70 53 63 68 65 6d 61 20 3d 20 64 62 2d 3e 61 44 pSchema = db->aD
7ac0: 62 5b 69 5d 2e 70 53 63 68 65 6d 61 3b 0a 20 20 b[i].pSchema;.
7ad0: 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d if( db->aDb[i]
7ae0: 2e 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 .pSchema ){.
7af0: 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b 0a 20 HashElem *p;.
7b00: 20 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 for(p=sqlit
7b10: 65 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 eHashFirst(&pSch
7b20: 65 6d 61 2d 3e 74 62 6c 48 61 73 68 29 3b 20 70 ema->tblHash); p
7b30: 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 ; p=sqliteHashNe
7b40: 78 74 28 70 29 29 7b 0a 20 20 20 20 20 20 20 20 xt(p)){.
7b50: 54 61 62 6c 65 20 2a 70 54 61 62 20 3d 20 28 54 Table *pTab = (T
7b60: 61 62 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 able *)sqliteHas
7b70: 68 44 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 hData(p);.
7b80: 20 20 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 if( IsVirtual(
7b90: 70 54 61 62 29 20 29 20 73 71 6c 69 74 65 33 56 pTab) ) sqlite3V
7ba0: 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 64 62 tabDisconnect(db
7bb0: 2c 20 70 54 61 62 29 3b 0a 20 20 20 20 20 20 7d , pTab);. }
7bc0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c . }. }. sql
7bd0: 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 ite3VtabUnlockLi
7be0: 73 74 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 st(db);. sqlite
7bf0: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 3BtreeLeaveAll(d
7c00: 62 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e 55 53 b);.#else. UNUS
7c10: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 64 62 29 ED_PARAMETER(db)
7c20: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
7c30: 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 * Return TRUE if
7c40: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
7c50: 74 69 6f 6e 20 64 62 20 68 61 73 20 75 6e 66 69 tion db has unfi
7c60: 6e 61 6c 69 7a 65 64 20 70 72 65 70 61 72 65 64 nalized prepared
7c70: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 6f .** statements o
7c80: 72 20 75 6e 66 69 6e 69 73 68 65 64 20 73 71 6c r unfinished sql
7c90: 69 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 ite3_backup obje
7ca0: 63 74 73 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 cts. .*/.static
7cb0: 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 int connectionI
7cc0: 73 42 75 73 79 28 73 71 6c 69 74 65 33 20 2a 64 sBusy(sqlite3 *d
7cd0: 62 29 7b 0a 20 20 69 6e 74 20 6a 3b 0a 20 20 61 b){. int j;. a
7ce0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
7cf0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
7d00: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 tex) );. if( db
7d10: 2d 3e 70 56 64 62 65 20 29 20 72 65 74 75 72 6e ->pVdbe ) return
7d20: 20 31 3b 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 1;. for(j=0; j
7d30: 3c 64 62 2d 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a <db->nDb; j++){.
7d40: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d Btree *pBt =
7d50: 20 64 62 2d 3e 61 44 62 5b 6a 5d 2e 70 42 74 3b db->aDb[j].pBt;
7d60: 0a 20 20 20 20 69 66 28 20 70 42 74 20 26 26 20 . if( pBt &&
7d70: 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e sqlite3BtreeIsIn
7d80: 42 61 63 6b 75 70 28 70 42 74 29 20 29 20 72 65 Backup(pBt) ) re
7d90: 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 72 65 turn 1;. }. re
7da0: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn 0;.}../*.**
7db0: 20 43 6c 6f 73 65 20 61 6e 20 65 78 69 73 74 69 Close an existi
7dc0: 6e 67 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 ng SQLite databa
7dd0: 73 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 se.*/.static int
7de0: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 73 71 sqlite3Close(sq
7df0: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 66 lite3 *db, int f
7e00: 6f 72 63 65 5a 6f 6d 62 69 65 29 7b 0a 20 20 69 orceZombie){. i
7e10: 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 2f 2a f( !db ){. /*
7e20: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
7e30: 36 33 32 35 37 2d 31 31 37 34 30 20 43 61 6c 6c 63257-11740 Call
7e40: 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 ing sqlite3_clos
7e50: 65 28 29 20 6f 72 0a 20 20 20 20 2a 2a 20 73 71 e() or. ** sq
7e60: 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32 28 29 lite3_close_v2()
7e70: 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 70 6f 69 with a NULL poi
7e80: 6e 74 65 72 20 61 72 67 75 6d 65 6e 74 20 69 73 nter argument is
7e90: 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f a harmless no-o
7ea0: 70 2e 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e p. */. return
7eb0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
7ec0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
7ed0: 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f fetyCheckSickOrO
7ee0: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
7ef0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
7f00: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 E_BKPT;. }. sq
7f10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
7f20: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 0a 20 r(db->mutex);..
7f30: 20 2f 2a 20 46 6f 72 63 65 20 78 44 69 73 63 6f /* Force xDisco
7f40: 6e 6e 65 63 74 20 63 61 6c 6c 73 20 6f 6e 20 61 nnect calls on a
7f50: 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ll virtual table
7f60: 73 20 2a 2f 0a 20 20 64 69 73 63 6f 6e 6e 65 63 s */. disconnec
7f70: 74 41 6c 6c 56 74 61 62 28 64 62 29 3b 0a 0a 20 tAllVtab(db);..
7f80: 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 /* If a transac
7f90: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 74 68 tion is open, th
7fa0: 65 20 64 69 73 63 6f 6e 6e 65 63 74 41 6c 6c 56 e disconnectAllV
7fb0: 74 61 62 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 tab() call above
7fc0: 0a 20 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 . ** will not h
7fd0: 61 76 65 20 63 61 6c 6c 65 64 20 74 68 65 20 78 ave called the x
7fe0: 44 69 73 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 Disconnect() met
7ff0: 68 6f 64 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 hod on any virtu
8000: 61 6c 0a 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 al. ** tables i
8010: 6e 20 74 68 65 20 64 62 2d 3e 61 56 54 72 61 6e n the db->aVTran
8020: 73 5b 5d 20 61 72 72 61 79 2e 20 54 68 65 20 66 s[] array. The f
8030: 6f 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 ollowing sqlite3
8040: 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 VtabRollback().
8050: 20 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f ** call will do
8060: 20 73 6f 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 so. We need to
8070: 64 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20 74 do this before t
8080: 68 65 20 63 68 65 63 6b 20 66 6f 72 20 61 63 74 he check for act
8090: 69 76 65 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 ive. ** SQL sta
80a0: 74 65 6d 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 tements below, a
80b0: 73 20 74 68 65 20 76 2d 74 61 62 6c 65 20 69 6d s the v-table im
80c0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 plementation may
80d0: 20 62 65 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a be storing. **
80e0: 20 73 6f 6d 65 20 70 72 65 70 61 72 65 64 20 73 some prepared s
80f0: 74 61 74 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e tatements intern
8100: 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c ally.. */. sql
8110: 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b ite3VtabRollback
8120: 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 4c 65 67 61 (db);.. /* Lega
8130: 63 79 20 62 65 68 61 76 69 6f 72 20 28 73 71 6c cy behavior (sql
8140: 69 74 65 33 5f 63 6c 6f 73 65 28 29 20 62 65 68 ite3_close() beh
8150: 61 76 69 6f 72 29 20 69 73 20 74 6f 20 72 65 74 avior) is to ret
8160: 75 72 6e 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f urn. ** SQLITE_
8170: 42 55 53 59 20 69 66 20 74 68 65 20 63 6f 6e 6e BUSY if the conn
8180: 65 63 74 69 6f 6e 20 63 61 6e 20 6e 6f 74 20 62 ection can not b
8190: 65 20 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 e closed immedia
81a0: 74 65 6c 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 tely.. */. if(
81b0: 20 21 66 6f 72 63 65 5a 6f 6d 62 69 65 20 26 26 !forceZombie &&
81c0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 42 75 73 connectionIsBus
81d0: 79 28 64 62 29 20 29 7b 0a 20 20 20 20 73 71 6c y(db) ){. sql
81e0: 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 ite3ErrorWithMsg
81f0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 (db, SQLITE_BUSY
8200: 2c 20 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f , "unable to clo
8210: 73 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 se due to unfina
8220: 6c 69 7a 65 64 20 22 0a 20 20 20 20 20 20 20 22 lized ". "
8230: 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 75 6e statements or un
8240: 66 69 6e 69 73 68 65 64 20 62 61 63 6b 75 70 73 finished backups
8250: 22 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ");. sqlite3_
8260: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
8270: 6d 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 mutex);. retu
8280: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a rn SQLITE_BUSY;.
8290: 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 }..#ifdef SQLI
82a0: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 TE_ENABLE_SQLLOG
82b0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c . if( sqlite3Gl
82c0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 53 71 6c 6c obalConfig.xSqll
82d0: 6f 67 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6c 6f og ){. /* Clo
82e0: 73 69 6e 67 20 74 68 65 20 68 61 6e 64 6c 65 2e sing the handle.
82f0: 20 46 6f 75 72 74 68 20 70 61 72 61 6d 65 74 65 Fourth paramete
8300: 72 20 69 73 20 70 61 73 73 65 64 20 74 68 65 20 r is passed the
8310: 76 61 6c 75 65 20 32 2e 20 2a 2f 0a 20 20 20 20 value 2. */.
8320: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
8330: 66 69 67 2e 78 53 71 6c 6c 6f 67 28 73 71 6c 69 fig.xSqllog(sqli
8340: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
8350: 70 53 71 6c 6c 6f 67 41 72 67 2c 20 64 62 2c 20 pSqllogArg, db,
8360: 30 2c 20 32 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 0, 2);. }.#endi
8370: 66 0a 0a 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 f.. /* Convert
8380: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 the connection i
8390: 6e 74 6f 20 61 20 7a 6f 6d 62 69 65 20 61 6e 64 nto a zombie and
83a0: 20 74 68 65 6e 20 63 6c 6f 73 65 20 69 74 2e 0a then close it..
83b0: 20 20 2a 2f 0a 20 20 64 62 2d 3e 6d 61 67 69 63 */. db->magic
83c0: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f = SQLITE_MAGIC_
83d0: 5a 4f 4d 42 49 45 3b 0a 20 20 73 71 6c 69 74 65 ZOMBIE;. sqlite
83e0: 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
83f0: 6f 73 65 5a 6f 6d 62 69 65 28 64 62 29 3b 0a 20 oseZombie(db);.
8400: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
8410: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 K;.}../*.** Two
8420: 76 61 72 69 61 74 69 6f 6e 73 20 6f 6e 20 74 68 variations on th
8430: 65 20 70 75 62 6c 69 63 20 69 6e 74 65 72 66 61 e public interfa
8440: 63 65 20 66 6f 72 20 63 6c 6f 73 69 6e 67 20 61 ce for closing a
8450: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
8460: 6e 65 63 74 69 6f 6e 2e 20 54 68 65 20 73 71 6c nection. The sql
8470: 69 74 65 33 5f 63 6c 6f 73 65 28 29 20 76 65 72 ite3_close() ver
8480: 73 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c sion returns SQL
8490: 49 54 45 5f 42 55 53 59 20 61 6e 64 0a 2a 2a 20 ITE_BUSY and.**
84a0: 6c 65 61 76 65 73 20 74 68 65 20 63 6f 6e 6e 65 leaves the conne
84b0: 63 74 69 6f 6e 20 6f 70 74 69 6f 6e 20 69 66 20 ction option if
84c0: 74 68 65 72 65 20 61 72 65 20 75 6e 66 69 6e 61 there are unfina
84d0: 6c 69 7a 65 64 20 70 72 65 70 61 72 65 64 0a 2a lized prepared.*
84e0: 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 6f 72 20 * statements or
84f0: 75 6e 66 69 6e 69 73 68 65 64 20 73 71 6c 69 74 unfinished sqlit
8500: 65 33 5f 62 61 63 6b 75 70 73 2e 20 20 54 68 65 e3_backups. The
8510: 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 sqlite3_close_v
8520: 32 28 29 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 66 2().** version f
8530: 6f 72 63 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 orces the connec
8540: 74 69 6f 6e 20 74 6f 20 62 65 63 6f 6d 65 20 61 tion to become a
8550: 20 7a 6f 6d 62 69 65 20 69 66 20 74 68 65 72 65 zombie if there
8560: 20 61 72 65 0a 2a 2a 20 75 6e 63 6c 6f 73 65 64 are.** unclosed
8570: 20 72 65 73 6f 75 72 63 65 73 2c 20 61 6e 64 20 resources, and
8580: 61 72 72 61 6e 67 65 73 20 66 6f 72 20 64 65 61 arranges for dea
8590: 6c 6c 6f 63 61 74 69 6f 6e 20 77 68 65 6e 20 74 llocation when t
85a0: 68 65 20 6c 61 73 74 0a 2a 2a 20 70 72 65 70 61 he last.** prepa
85b0: 72 65 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 re statement or
85c0: 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 63 sqlite3_backup c
85d0: 6c 6f 73 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 loses..*/.int sq
85e0: 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c 69 lite3_close(sqli
85f0: 74 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e te3 *db){ return
8600: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 sqlite3Close(db
8610: 2c 30 29 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 ,0); }.int sqlit
8620: 65 33 5f 63 6c 6f 73 65 5f 76 32 28 73 71 6c 69 e3_close_v2(sqli
8630: 74 65 33 20 2a 64 62 29 7b 20 72 65 74 75 72 6e te3 *db){ return
8640: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 28 64 62 sqlite3Close(db
8650: 2c 31 29 3b 20 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 ,1); }.../*.** C
8660: 6c 6f 73 65 20 74 68 65 20 6d 75 74 65 78 20 6f lose the mutex o
8670: 6e 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 n database conne
8680: 63 74 69 6f 6e 20 64 62 2e 0a 2a 2a 0a 2a 2a 20 ction db..**.**
8690: 46 75 72 74 68 65 72 6d 6f 72 65 2c 20 69 66 20 Furthermore, if
86a0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
86b0: 69 6f 6e 20 64 62 20 69 73 20 61 20 7a 6f 6d 62 ion db is a zomb
86c0: 69 65 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 74 ie (meaning that
86d0: 20 74 68 65 72 65 0a 2a 2a 20 68 61 73 20 62 65 there.** has be
86e0: 65 6e 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 en a prior call
86f0: 74 6f 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 to sqlite3_close
8700: 28 64 62 29 20 6f 72 20 73 71 6c 69 74 65 33 5f (db) or sqlite3_
8710: 63 6c 6f 73 65 5f 76 32 28 64 62 29 29 20 61 6e close_v2(db)) an
8720: 64 0a 2a 2a 20 65 76 65 72 79 20 73 71 6c 69 74 d.** every sqlit
8730: 65 33 5f 73 74 6d 74 20 68 61 73 20 6e 6f 77 20 e3_stmt has now
8740: 62 65 65 6e 20 66 69 6e 61 6c 69 7a 65 64 20 61 been finalized a
8750: 6e 64 20 65 76 65 72 79 20 73 71 6c 69 74 65 33 nd every sqlite3
8760: 5f 62 61 63 6b 75 70 20 68 61 73 0a 2a 2a 20 66 _backup has.** f
8770: 69 6e 69 73 68 65 64 2c 20 74 68 65 6e 20 66 72 inished, then fr
8780: 65 65 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 ee all resources
8790: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 ..*/.void sqlite
87a0: 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
87b0: 6f 73 65 5a 6f 6d 62 69 65 28 73 71 6c 69 74 65 oseZombie(sqlite
87c0: 33 20 2a 64 62 29 7b 0a 20 20 48 61 73 68 45 6c 3 *db){. HashEl
87d0: 65 6d 20 2a 69 3b 20 20 20 20 20 20 20 20 20 20 em *i;
87e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 73 /* Has
87f0: 68 20 74 61 62 6c 65 20 69 74 65 72 61 74 6f 72 h table iterator
8800: 20 2a 2f 0a 20 20 69 6e 74 20 6a 3b 0a 0a 20 20 */. int j;..
8810: 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 /* If there are
8820: 6f 75 74 73 74 61 6e 64 69 6e 67 20 73 71 6c 69 outstanding sqli
8830: 74 65 33 5f 73 74 6d 74 20 6f 72 20 73 71 6c 69 te3_stmt or sqli
8840: 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 te3_backup objec
8850: 74 73 0a 20 20 2a 2a 20 6f 72 20 69 66 20 74 68 ts. ** or if th
8860: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 e connection has
8870: 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 63 6c not yet been cl
8880: 6f 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f osed by sqlite3_
8890: 63 6c 6f 73 65 5f 76 32 28 29 2c 0a 20 20 2a 2a close_v2(),. **
88a0: 20 74 68 65 6e 20 6a 75 73 74 20 6c 65 61 76 65 then just leave
88b0: 20 74 68 65 20 6d 75 74 65 78 20 61 6e 64 20 72 the mutex and r
88c0: 65 74 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 eturn.. */. if
88d0: 28 20 64 62 2d 3e 6d 61 67 69 63 21 3d 53 51 4c ( db->magic!=SQL
88e0: 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 ITE_MAGIC_ZOMBIE
88f0: 20 7c 7c 20 63 6f 6e 6e 65 63 74 69 6f 6e 49 73 || connectionIs
8900: 42 75 73 79 28 64 62 29 20 29 7b 0a 20 20 20 20 Busy(db) ){.
8910: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
8920: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
8930: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a return;. }.
8940: 0a 20 20 2f 2a 20 49 66 20 77 65 20 72 65 61 63 . /* If we reac
8950: 68 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 69 74 h this point, it
8960: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
8970: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
8980: 69 6f 6e 20 68 61 73 0a 20 20 2a 2a 20 63 6c 6f ion has. ** clo
8990: 73 65 64 20 61 6c 6c 20 73 71 6c 69 74 65 33 5f sed all sqlite3_
89a0: 73 74 6d 74 20 61 6e 64 20 73 71 6c 69 74 65 33 stmt and sqlite3
89b0: 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 _backup objects
89c0: 61 6e 64 20 68 61 73 20 62 65 65 6e 0a 20 20 2a and has been. *
89d0: 2a 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 * passed to sqli
89e0: 74 65 33 5f 63 6c 6f 73 65 20 28 6d 65 61 6e 69 te3_close (meani
89f0: 6e 67 20 74 68 61 74 20 69 74 20 69 73 20 61 20 ng that it is a
8a00: 7a 6f 6d 62 69 65 29 2e 20 20 54 68 65 72 65 66 zombie). Theref
8a10: 6f 72 65 2c 0a 20 20 2a 2a 20 67 6f 20 61 68 65 ore,. ** go ahe
8a20: 61 64 20 61 6e 64 20 66 72 65 65 20 61 6c 6c 20 ad and free all
8a30: 72 65 73 6f 75 72 63 65 73 2e 0a 20 20 2a 2f 0a resources.. */.
8a40: 0a 20 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 . /* If a trans
8a50: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2c 20 action is open,
8a60: 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 54 68 roll it back. Th
8a70: 69 73 20 61 6c 73 6f 20 65 6e 73 75 72 65 73 20 is also ensures
8a80: 74 68 61 74 20 69 66 0a 20 20 2a 2a 20 61 6e 79 that if. ** any
8a90: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
8aa0: 73 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 s have been modi
8ab0: 66 69 65 64 20 62 79 20 61 6e 20 75 6e 63 6f 6d fied by an uncom
8ac0: 6d 69 74 74 65 64 20 74 72 61 6e 73 61 63 74 69 mitted transacti
8ad0: 6f 6e 0a 20 20 2a 2a 20 74 68 65 79 20 61 72 65 on. ** they are
8ae0: 20 72 65 73 65 74 2e 20 41 6e 64 20 74 68 61 74 reset. And that
8af0: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 62 2d the required b-
8b00: 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 68 65 tree mutex is he
8b10: 6c 64 20 74 6f 20 6d 61 6b 65 0a 20 20 2a 2a 20 ld to make. **
8b20: 74 68 65 20 70 61 67 65 72 20 72 6f 6c 6c 62 61 the pager rollba
8b30: 63 6b 20 61 6e 64 20 73 63 68 65 6d 61 20 72 65 ck and schema re
8b40: 73 65 74 20 61 6e 20 61 74 6f 6d 69 63 20 6f 70 set an atomic op
8b50: 65 72 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 73 71 eration. */. sq
8b60: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c lite3RollbackAll
8b70: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b (db, SQLITE_OK);
8b80: 0a 0a 20 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 .. /* Free any
8b90: 6f 75 74 73 74 61 6e 64 69 6e 67 20 53 61 76 65 outstanding Save
8ba0: 70 6f 69 6e 74 20 73 74 72 75 63 74 75 72 65 73 point structures
8bb0: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 43 6c . */. sqlite3Cl
8bc0: 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 64 62 oseSavepoints(db
8bd0: 29 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 );.. /* Close a
8be0: 6c 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ll database conn
8bf0: 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 66 6f 72 ections */. for
8c00: 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e 44 62 3b (j=0; j<db->nDb;
8c10: 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 j++){. struc
8c20: 74 20 44 62 20 2a 70 44 62 20 3d 20 26 64 62 2d t Db *pDb = &db-
8c30: 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 >aDb[j];. if(
8c40: 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 pDb->pBt ){.
8c50: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
8c60: 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a lose(pDb->pBt);.
8c70: 20 20 20 20 20 20 70 44 62 2d 3e 70 42 74 20 3d pDb->pBt =
8c80: 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 6a 21 0;. if( j!
8c90: 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 70 44 =1 ){. pD
8ca0: 62 2d 3e 70 53 63 68 65 6d 61 20 3d 20 30 3b 0a b->pSchema = 0;.
8cb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
8cc0: 7d 0a 20 20 2f 2a 20 43 6c 65 61 72 20 74 68 65 }. /* Clear the
8cd0: 20 54 45 4d 50 20 73 63 68 65 6d 61 20 73 65 70 TEMP schema sep
8ce0: 61 72 61 74 65 6c 79 20 61 6e 64 20 6c 61 73 74 arately and last
8cf0: 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 61 44 */. if( db->aD
8d00: 62 5b 31 5d 2e 70 53 63 68 65 6d 61 20 29 7b 0a b[1].pSchema ){.
8d10: 20 20 20 20 73 71 6c 69 74 65 33 53 63 68 65 6d sqlite3Schem
8d20: 61 43 6c 65 61 72 28 64 62 2d 3e 61 44 62 5b 31 aClear(db->aDb[1
8d30: 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 7d 0a ].pSchema);. }.
8d40: 20 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c sqlite3VtabUnl
8d50: 6f 63 6b 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 ockList(db);..
8d60: 2f 2a 20 46 72 65 65 20 75 70 20 74 68 65 20 61 /* Free up the a
8d70: 72 72 61 79 20 6f 66 20 61 75 78 69 6c 69 61 72 rray of auxiliar
8d80: 79 20 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 y databases */.
8d90: 20 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 sqlite3Collapse
8da0: 44 61 74 61 62 61 73 65 41 72 72 61 79 28 64 62 DatabaseArray(db
8db0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d );. assert( db-
8dc0: 3e 6e 44 62 3c 3d 32 20 29 3b 0a 20 20 61 73 73 >nDb<=2 );. ass
8dd0: 65 72 74 28 20 64 62 2d 3e 61 44 62 3d 3d 64 62 ert( db->aDb==db
8de0: 2d 3e 61 44 62 53 74 61 74 69 63 20 29 3b 0a 0a ->aDbStatic );..
8df0: 20 20 2f 2a 20 54 65 6c 6c 20 74 68 65 20 63 6f /* Tell the co
8e00: 64 65 20 69 6e 20 6e 6f 74 69 66 79 2e 63 20 74 de in notify.c t
8e10: 68 61 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 hat the connecti
8e20: 6f 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 68 6f 6c on no longer hol
8e30: 64 73 20 61 6e 79 0a 20 20 2a 2a 20 6c 6f 63 6b ds any. ** lock
8e40: 73 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 72 s and does not r
8e50: 65 71 75 69 72 65 20 61 6e 79 20 66 75 72 74 68 equire any furth
8e60: 65 72 20 75 6e 6c 6f 63 6b 2d 6e 6f 74 69 66 79 er unlock-notify
8e70: 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 20 20 2a 2f callbacks.. */
8e80: 0a 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 . sqlite3Connec
8e90: 74 69 6f 6e 43 6c 6f 73 65 64 28 64 62 29 3b 0a tionClosed(db);.
8ea0: 0a 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 41 72 . for(j=0; j<Ar
8eb0: 72 61 79 53 69 7a 65 28 64 62 2d 3e 61 46 75 6e raySize(db->aFun
8ec0: 63 2e 61 29 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 c.a); j++){.
8ed0: 46 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 2c 20 FuncDef *pNext,
8ee0: 2a 70 48 61 73 68 2c 20 2a 70 3b 0a 20 20 20 20 *pHash, *p;.
8ef0: 66 6f 72 28 70 3d 64 62 2d 3e 61 46 75 6e 63 2e for(p=db->aFunc.
8f00: 61 5b 6a 5d 3b 20 70 3b 20 70 3d 70 48 61 73 68 a[j]; p; p=pHash
8f10: 29 7b 0a 20 20 20 20 20 20 70 48 61 73 68 20 3d ){. pHash =
8f20: 20 70 2d 3e 70 48 61 73 68 3b 0a 20 20 20 20 20 p->pHash;.
8f30: 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 while( p ){.
8f40: 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 44 65 73 functionDes
8f50: 74 72 6f 79 28 64 62 2c 20 70 29 3b 0a 20 20 20 troy(db, p);.
8f60: 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e pNext = p->
8f70: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 20 20 73 pNext;. s
8f80: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
8f90: 20 70 29 3b 0a 20 20 20 20 20 20 20 20 70 20 3d p);. p =
8fa0: 20 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a pNext;. }.
8fb0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 }. }. for(
8fc0: 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 i=sqliteHashFirs
8fd0: 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 t(&db->aCollSeq)
8fe0: 3b 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 ; i; i=sqliteHas
8ff0: 68 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 43 hNext(i)){. C
9000: 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 ollSeq *pColl =
9010: 28 43 6f 6c 6c 53 65 71 20 2a 29 73 71 6c 69 74 (CollSeq *)sqlit
9020: 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 20 eHashData(i);.
9030: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 61 6e 79 20 /* Invoke any
9040: 64 65 73 74 72 75 63 74 6f 72 73 20 72 65 67 69 destructors regi
9050: 73 74 65 72 65 64 20 66 6f 72 20 63 6f 6c 6c 61 stered for colla
9060: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 75 73 tion sequence us
9070: 65 72 20 64 61 74 61 2e 20 2a 2f 0a 20 20 20 20 er data. */.
9080: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b for(j=0; j<3; j+
9090: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 43 +){. if( pC
90a0: 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 20 29 7b 0a 20 oll[j].xDel ){.
90b0: 20 20 20 20 20 20 20 70 43 6f 6c 6c 5b 6a 5d 2e pColl[j].
90c0: 78 44 65 6c 28 70 43 6f 6c 6c 5b 6a 5d 2e 70 55 xDel(pColl[j].pU
90d0: 73 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ser);. }.
90e0: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 }. sqlite3D
90f0: 62 46 72 65 65 28 64 62 2c 20 70 43 6f 6c 6c 29 bFree(db, pColl)
9100: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 ;. }. sqlite3H
9110: 61 73 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 43 ashClear(&db->aC
9120: 6f 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 66 ollSeq);.#ifndef
9130: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 SQLITE_OMIT_VIR
9140: 54 55 41 4c 54 41 42 4c 45 0a 20 20 66 6f 72 28 TUALTABLE. for(
9150: 69 3d 73 71 6c 69 74 65 48 61 73 68 46 69 72 73 i=sqliteHashFirs
9160: 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b t(&db->aModule);
9170: 20 69 3b 20 69 3d 73 71 6c 69 74 65 48 61 73 68 i; i=sqliteHash
9180: 4e 65 78 74 28 69 29 29 7b 0a 20 20 20 20 4d 6f Next(i)){. Mo
9190: 64 75 6c 65 20 2a 70 4d 6f 64 20 3d 20 28 4d 6f dule *pMod = (Mo
91a0: 64 75 6c 65 20 2a 29 73 71 6c 69 74 65 48 61 73 dule *)sqliteHas
91b0: 68 44 61 74 61 28 69 29 3b 0a 20 20 20 20 69 66 hData(i);. if
91c0: 28 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 ( pMod->xDestroy
91d0: 20 29 7b 0a 20 20 20 20 20 20 70 4d 6f 64 2d 3e ){. pMod->
91e0: 78 44 65 73 74 72 6f 79 28 70 4d 6f 64 2d 3e 70 xDestroy(pMod->p
91f0: 41 75 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Aux);. }.
9200: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
9210: 2c 20 70 4d 6f 64 29 3b 0a 20 20 7d 0a 20 20 73 , pMod);. }. s
9220: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 qlite3HashClear(
9230: 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 &db->aModule);.#
9240: 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 endif.. sqlite3
9250: 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
9260: 5f 4f 4b 29 3b 20 2f 2a 20 44 65 61 6c 6c 6f 63 _OK); /* Dealloc
9270: 61 74 65 73 20 61 6e 79 20 63 61 63 68 65 64 20 ates any cached
9280: 65 72 72 6f 72 20 73 74 72 69 6e 67 73 2e 20 2a error strings. *
9290: 2f 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 /. sqlite3Value
92a0: 46 72 65 65 28 64 62 2d 3e 70 45 72 72 29 3b 0a Free(db->pErr);.
92b0: 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 sqlite3CloseEx
92c0: 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 23 69 tensions(db);.#i
92d0: 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 f SQLITE_USER_AU
92e0: 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 THENTICATION. s
92f0: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e qlite3_free(db->
9300: 61 75 74 68 2e 7a 41 75 74 68 55 73 65 72 29 3b auth.zAuthUser);
9310: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
9320: 64 62 2d 3e 61 75 74 68 2e 7a 41 75 74 68 50 57 db->auth.zAuthPW
9330: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 64 62 2d );.#endif.. db-
9340: 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f >magic = SQLITE_
9350: 4d 41 47 49 43 5f 45 52 52 4f 52 3b 0a 0a 20 20 MAGIC_ERROR;..
9360: 2f 2a 20 54 68 65 20 74 65 6d 70 2d 64 61 74 61 /* The temp-data
9370: 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 61 base schema is a
9380: 6c 6c 6f 63 61 74 65 64 20 64 69 66 66 65 72 65 llocated differe
9390: 6e 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 6f 74 ntly from the ot
93a0: 68 65 72 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 her schema. **
93b0: 6f 62 6a 65 63 74 73 20 28 75 73 69 6e 67 20 73 objects (using s
93c0: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 20 64 69 qliteMalloc() di
93d0: 72 65 63 74 6c 79 2c 20 69 6e 73 74 65 61 64 20 rectly, instead
93e0: 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 of sqlite3BtreeS
93f0: 63 68 65 6d 61 28 29 29 2e 0a 20 20 2a 2a 20 53 chema()).. ** S
9400: 6f 20 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 o it needs to be
9410: 20 66 72 65 65 64 20 68 65 72 65 2e 20 54 6f 64 freed here. Tod
9420: 6f 3a 20 57 68 79 20 6e 6f 74 20 72 6f 6c 6c 20 o: Why not roll
9430: 74 68 65 20 74 65 6d 70 20 73 63 68 65 6d 61 20 the temp schema
9440: 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 65 20 73 61 into. ** the sa
9450: 6d 65 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 me sqliteMalloc(
9460: 29 20 61 73 20 74 68 65 20 6f 6e 65 20 74 68 61 ) as the one tha
9470: 74 20 61 6c 6c 6f 63 61 74 65 73 20 74 68 65 20 t allocates the
9480: 64 61 74 61 62 61 73 65 20 0a 20 20 2a 2a 20 73 database . ** s
9490: 74 72 75 63 74 75 72 65 3f 0a 20 20 2a 2f 0a 20 tructure?. */.
94a0: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
94b0: 62 2c 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 b, db->aDb[1].pS
94c0: 63 68 65 6d 61 29 3b 0a 20 20 73 71 6c 69 74 65 chema);. sqlite
94d0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
94e0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
94f0: 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d magic = SQLITE_M
9500: 41 47 49 43 5f 43 4c 4f 53 45 44 3b 0a 20 20 73 AGIC_CLOSED;. s
9510: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 qlite3_mutex_fre
9520: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
9530: 61 73 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f 6b assert( db->look
9540: 61 73 69 64 65 2e 6e 4f 75 74 3d 3d 30 20 29 3b aside.nOut==0 );
9550: 20 20 2f 2a 20 46 61 69 6c 73 20 6f 6e 20 61 20 /* Fails on a
9560: 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 lookaside memory
9570: 20 6c 65 61 6b 20 2a 2f 0a 20 20 69 66 28 20 64 leak */. if( d
9580: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 b->lookaside.bMa
9590: 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 lloced ){. sq
95a0: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c lite3_free(db->l
95b0: 6f 6f 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 ookaside.pStart)
95c0: 3b 0a 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c ;. }.#ifdef SQL
95d0: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 52 52 ITE_ENABLE_SQLRR
95e0: 0a 20 20 53 52 52 65 63 43 6c 6f 73 65 28 64 62 . SRRecClose(db
95f0: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 73 );.#endif. . s
9600: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 3b qlite3_free(db);
9610: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 .}../*.** Rollba
9620: 63 6b 20 61 6c 6c 20 64 61 74 61 62 61 73 65 20 ck all database
9630: 66 69 6c 65 73 2e 20 20 49 66 20 74 72 69 70 43 files. If tripC
9640: 6f 64 65 20 69 73 20 6e 6f 74 20 53 51 4c 49 54 ode is not SQLIT
9650: 45 5f 4f 4b 2c 20 74 68 65 6e 0a 2a 2a 20 61 6e E_OK, then.** an
9660: 79 20 77 72 69 74 65 20 63 75 72 73 6f 72 73 20 y write cursors
9670: 61 72 65 20 69 6e 76 61 6c 69 64 61 74 65 64 20 are invalidated
9680: 28 22 74 72 69 70 70 65 64 22 20 2d 20 61 73 20 ("tripped" - as
9690: 69 6e 20 22 74 72 69 70 70 69 6e 67 20 61 20 63 in "tripping a c
96a0: 69 72 63 75 69 74 0a 2a 2a 20 62 72 65 61 6b 65 ircuit.** breake
96b0: 72 22 29 20 61 6e 64 20 6d 61 64 65 20 74 6f 20 r") and made to
96c0: 72 65 74 75 72 6e 20 74 72 69 70 43 6f 64 65 20 return tripCode
96d0: 69 66 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 if there are any
96e0: 20 66 75 72 74 68 65 72 0a 2a 2a 20 61 74 74 65 further.** atte
96f0: 6d 70 74 73 20 74 6f 20 75 73 65 20 74 68 61 74 mpts to use that
9700: 20 63 75 72 73 6f 72 2e 20 20 52 65 61 64 20 63 cursor. Read c
9710: 75 72 73 6f 72 73 20 72 65 6d 61 69 6e 20 6f 70 ursors remain op
9720: 65 6e 20 61 6e 64 20 76 61 6c 69 64 0a 2a 2a 20 en and valid.**
9730: 62 75 74 20 61 72 65 20 22 73 61 76 65 64 22 20 but are "saved"
9740: 69 6e 20 63 61 73 65 20 74 68 65 20 74 61 62 6c in case the tabl
9750: 65 20 70 61 67 65 73 20 61 72 65 20 6d 6f 76 65 e pages are move
9760: 64 20 61 72 6f 75 6e 64 2e 0a 2a 2f 0a 76 6f 69 d around..*/.voi
9770: 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 d sqlite3Rollbac
9780: 6b 41 6c 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 kAll(sqlite3 *db
9790: 2c 20 69 6e 74 20 74 72 69 70 43 6f 64 65 29 7b , int tripCode){
97a0: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 . int i;. int
97b0: 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 69 inTrans = 0;. i
97c0: 6e 74 20 73 63 68 65 6d 61 43 68 61 6e 67 65 3b nt schemaChange;
97d0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
97e0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 e3_mutex_held(db
97f0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 ->mutex) );. sq
9800: 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
9810: 4d 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 2f 2a 20 Malloc();.. /*
9820: 4f 62 74 61 69 6e 20 61 6c 6c 20 62 2d 74 72 65 Obtain all b-tre
9830: 65 20 6d 75 74 65 78 65 73 20 62 65 66 6f 72 65 e mutexes before
9840: 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 61 6c 6c making any call
9850: 73 20 74 6f 20 42 74 72 65 65 52 6f 6c 6c 62 61 s to BtreeRollba
9860: 63 6b 28 29 2e 20 0a 20 20 2a 2a 20 54 68 69 73 ck(). . ** This
9870: 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 69 6e is important in
9880: 20 63 61 73 65 20 74 68 65 20 74 72 61 6e 73 61 case the transa
9890: 63 74 69 6f 6e 20 62 65 69 6e 67 20 72 6f 6c 6c ction being roll
98a0: 65 64 20 62 61 63 6b 20 68 61 73 0a 20 20 2a 2a ed back has. **
98b0: 20 6d 6f 64 69 66 69 65 64 20 74 68 65 20 64 61 modified the da
98c0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 49 tabase schema. I
98d0: 66 20 74 68 65 20 62 2d 74 72 65 65 20 6d 75 74 f the b-tree mut
98e0: 65 78 65 73 20 61 72 65 20 6e 6f 74 20 74 61 6b exes are not tak
98f0: 65 6e 0a 20 20 2a 2a 20 68 65 72 65 2c 20 74 68 en. ** here, th
9900: 65 6e 20 61 6e 6f 74 68 65 72 20 73 68 61 72 65 en another share
9910: 64 2d 63 61 63 68 65 20 63 6f 6e 6e 65 63 74 69 d-cache connecti
9920: 6f 6e 20 6d 69 67 68 74 20 73 6e 65 61 6b 20 69 on might sneak i
9930: 6e 20 62 65 74 77 65 65 6e 0a 20 20 2a 2a 20 74 n between. ** t
9940: 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 6c 6c he database roll
9950: 62 61 63 6b 20 61 6e 64 20 73 63 68 65 6d 61 20 back and schema
9960: 72 65 73 65 74 2c 20 77 68 69 63 68 20 63 61 6e reset, which can
9970: 20 63 61 75 73 65 20 66 61 6c 73 65 0a 20 20 2a cause false. *
9980: 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 72 65 70 * corruption rep
9990: 6f 72 74 73 20 69 6e 20 73 6f 6d 65 20 63 61 73 orts in some cas
99a0: 65 73 2e 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 es. */. sqlite
99b0: 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 3BtreeEnterAll(d
99c0: 62 29 3b 0a 20 20 73 63 68 65 6d 61 43 68 61 6e b);. schemaChan
99d0: 67 65 20 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 ge = (db->flags
99e0: 26 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 & SQLITE_InternC
99f0: 68 61 6e 67 65 73 29 21 3d 30 20 26 26 20 64 62 hanges)!=0 && db
9a00: 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 3b 0a ->init.busy==0;.
9a10: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 . for(i=0; i<db
9a20: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 ->nDb; i++){.
9a30: 20 42 74 72 65 65 20 2a 70 20 3d 20 64 62 2d 3e Btree *p = db->
9a40: 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 aDb[i].pBt;.
9a50: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 69 if( p ){. i
9a60: 66 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 f( sqlite3BtreeI
9a70: 73 49 6e 54 72 61 6e 73 28 70 29 20 29 7b 0a 20 sInTrans(p) ){.
9a80: 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 20 3d inTrans =
9a90: 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1;. }.
9aa0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f sqlite3BtreeRo
9ab0: 6c 6c 62 61 63 6b 28 70 2c 20 74 72 69 70 43 6f llback(p, tripCo
9ac0: 64 65 2c 20 21 73 63 68 65 6d 61 43 68 61 6e 67 de, !schemaChang
9ad0: 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 e);. }. }.
9ae0: 73 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 sqlite3VtabRollb
9af0: 61 63 6b 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 ack(db);. sqlit
9b00: 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f e3EndBenignMallo
9b10: 63 28 29 3b 0a 0a 20 20 69 66 28 20 28 64 62 2d c();.. if( (db-
9b20: 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 49 6e >flags&SQLITE_In
9b30: 74 65 72 6e 43 68 61 6e 67 65 73 29 21 3d 30 20 ternChanges)!=0
9b40: 26 26 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 && db->init.busy
9b50: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ==0 ){. sqlit
9b60: 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64 e3ExpirePrepared
9b70: 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a Statements(db);.
9b80: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 sqlite3Reset
9b90: 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e AllSchemasOfConn
9ba0: 65 63 74 69 6f 6e 28 64 62 29 3b 0a 20 20 7d 0a ection(db);. }.
9bb0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
9bc0: 61 76 65 41 6c 6c 28 64 62 29 3b 0a 0a 20 20 2f aveAll(db);.. /
9bd0: 2a 20 41 6e 79 20 64 65 66 65 72 72 65 64 20 63 * Any deferred c
9be0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 onstraint violat
9bf0: 69 6f 6e 73 20 68 61 76 65 20 6e 6f 77 20 62 65 ions have now be
9c00: 65 6e 20 72 65 73 6f 6c 76 65 64 2e 20 2a 2f 0a en resolved. */.
9c10: 20 20 64 62 2d 3e 6e 44 65 66 65 72 72 65 64 43 db->nDeferredC
9c20: 6f 6e 73 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e ons = 0;. db->n
9c30: 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 6e 73 20 DeferredImmCons
9c40: 3d 20 30 3b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 = 0;. db->flags
9c50: 20 26 3d 20 7e 53 51 4c 49 54 45 5f 44 65 66 65 &= ~SQLITE_Defe
9c60: 72 46 4b 73 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f rFKs;.. /* If o
9c70: 6e 65 20 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 ne has been conf
9c80: 69 67 75 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 igured, invoke t
9c90: 68 65 20 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b he rollback-hook
9ca0: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 callback */. i
9cb0: 66 28 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b f( db->xRollback
9cc0: 43 61 6c 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 Callback && (inT
9cd0: 72 61 6e 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 rans || !db->aut
9ce0: 6f 43 6f 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 oCommit) ){.
9cf0: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c db->xRollbackCal
9d00: 6c 62 61 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 lback(db->pRollb
9d10: 61 63 6b 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a ackArg);. }.}..
9d20: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 /*.** Return a s
9d30: 74 61 74 69 63 20 73 74 72 69 6e 67 20 63 6f 6e tatic string con
9d40: 74 61 69 6e 69 6e 67 20 74 68 65 20 6e 61 6d 65 taining the name
9d50: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
9d60: 6f 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 o the error code
9d70: 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 69 6e .** specified in
9d80: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2e 0a 2a the argument..*
9d90: 2f 0a 23 69 66 20 28 64 65 66 69 6e 65 64 28 53 /.#if (defined(S
9da0: 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 26 20 QLITE_DEBUG) &&
9db0: 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 20 7c SQLITE_OS_WIN) |
9dc0: 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 | defined(SQLITE
9dd0: 5f 54 45 53 54 29 0a 63 6f 6e 73 74 20 63 68 61 _TEST).const cha
9de0: 72 20 2a 73 71 6c 69 74 65 33 45 72 72 4e 61 6d r *sqlite3ErrNam
9df0: 65 28 69 6e 74 20 72 63 29 7b 0a 20 20 63 6f 6e e(int rc){. con
9e00: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 20 3d st char *zName =
9e10: 20 30 3b 0a 20 20 69 6e 74 20 69 2c 20 6f 72 69 0;. int i, ori
9e20: 67 52 63 20 3d 20 72 63 3b 0a 20 20 66 6f 72 28 gRc = rc;. for(
9e30: 69 3d 30 3b 20 69 3c 32 20 26 26 20 7a 4e 61 6d i=0; i<2 && zNam
9e40: 65 3d 3d 30 3b 20 69 2b 2b 2c 20 72 63 20 26 3d e==0; i++, rc &=
9e50: 20 30 78 66 66 29 7b 0a 20 20 20 20 73 77 69 74 0xff){. swit
9e60: 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 ch( rc ){.
9e70: 63 61 73 65 20 53 51 4c 49 54 45 5f 4f 4b 3a 20 case SQLITE_OK:
9e80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9e90: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
9ea0: 4f 4b 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 OK";
9eb0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9ec0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 52 52 case SQLITE_ERR
9ed0: 4f 52 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 OR:
9ee0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
9ef0: 5f 45 52 52 4f 52 22 3b 20 20 20 20 20 20 20 20 _ERROR";
9f00: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
9f10: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e case SQLITE_IN
9f20: 54 45 52 4e 41 4c 3a 20 20 20 20 20 20 20 20 20 TERNAL:
9f30: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
9f40: 45 5f 49 4e 54 45 52 4e 41 4c 22 3b 20 20 20 20 E_INTERNAL";
9f50: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
9f60: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 50 case SQLITE_P
9f70: 45 52 4d 3a 20 20 20 20 20 20 20 20 20 20 20 20 ERM:
9f80: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
9f90: 54 45 5f 50 45 52 4d 22 3b 20 20 20 20 20 20 20 TE_PERM";
9fa0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
9fb0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
9fc0: 41 42 4f 52 54 3a 20 20 20 20 20 20 20 20 20 20 ABORT:
9fd0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
9fe0: 49 54 45 5f 41 42 4f 52 54 22 3b 20 20 20 20 20 ITE_ABORT";
9ff0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
a000: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a010: 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 3a _ABORT_ROLLBACK:
a020: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
a030: 4c 49 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 LITE_ABORT_ROLLB
a040: 41 43 4b 22 3b 20 20 20 20 62 72 65 61 6b 3b 0a ACK"; break;.
a050: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a060: 45 5f 42 55 53 59 3a 20 20 20 20 20 20 20 20 20 E_BUSY:
a070: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
a080: 51 4c 49 54 45 5f 42 55 53 59 22 3b 20 20 20 20 QLITE_BUSY";
a090: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
a0a0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a0b0: 54 45 5f 42 55 53 59 5f 52 45 43 4f 56 45 52 59 TE_BUSY_RECOVERY
a0c0: 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 : zName = "
a0d0: 53 51 4c 49 54 45 5f 42 55 53 59 5f 52 45 43 4f SQLITE_BUSY_RECO
a0e0: 56 45 52 59 22 3b 20 20 20 20 20 62 72 65 61 6b VERY"; break
a0f0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a100: 49 54 45 5f 42 55 53 59 5f 53 4e 41 50 53 48 4f ITE_BUSY_SNAPSHO
a110: 54 3a 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 T: zName =
a120: 22 53 51 4c 49 54 45 5f 42 55 53 59 5f 53 4e 41 "SQLITE_BUSY_SNA
a130: 50 53 48 4f 54 22 3b 20 20 20 20 20 62 72 65 61 PSHOT"; brea
a140: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a150: 4c 49 54 45 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 LITE_LOCKED:
a160: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
a170: 20 22 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 22 "SQLITE_LOCKED"
a180: 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 ; bre
a190: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a1a0: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 QLITE_LOCKED_SHA
a1b0: 52 45 44 43 41 43 48 45 3a 20 7a 4e 61 6d 65 20 REDCACHE: zName
a1c0: 3d 20 22 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 = "SQLITE_LOCKED
a1d0: 5f 53 48 41 52 45 44 43 41 43 48 45 22 3b 62 72 _SHAREDCACHE";br
a1e0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a1f0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20 SQLITE_NOMEM:
a200: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
a210: 20 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d = "SQLITE_NOMEM
a220: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 62 "; b
a230: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a240: 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
a250: 3a 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d : zNam
a260: 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 44 e = "SQLITE_READ
a270: 4f 4e 4c 59 22 3b 20 20 20 20 20 20 20 20 20 20 ONLY";
a280: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a290: 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c e SQLITE_READONL
a2a0: 59 5f 52 45 43 4f 56 45 52 59 3a 20 20 7a 4e 61 Y_RECOVERY: zNa
a2b0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 41 me = "SQLITE_REA
a2c0: 44 4f 4e 4c 59 5f 52 45 43 4f 56 45 52 59 22 3b DONLY_RECOVERY";
a2d0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a2e0: 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e se SQLITE_READON
a2f0: 4c 59 5f 43 41 4e 54 4c 4f 43 4b 3a 20 20 7a 4e LY_CANTLOCK: zN
a300: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 45 ame = "SQLITE_RE
a310: 41 44 4f 4e 4c 59 5f 43 41 4e 54 4c 4f 43 4b 22 ADONLY_CANTLOCK"
a320: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 ; break;. c
a330: 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 4f ase SQLITE_READO
a340: 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b 3a 20 20 7a NLY_ROLLBACK: z
a350: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 52 Name = "SQLITE_R
a360: 45 41 44 4f 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b EADONLY_ROLLBACK
a370: 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 "; break;.
a380: 63 61 73 65 20 53 51 4c 49 54 45 5f 52 45 41 44 case SQLITE_READ
a390: 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 3a 20 20 20 ONLY_DBMOVED:
a3a0: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
a3b0: 52 45 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 READONLY_DBMOVED
a3c0: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 "; break;.
a3d0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 54 case SQLITE_INT
a3e0: 45 52 52 55 50 54 3a 20 20 20 20 20 20 20 20 20 ERRUPT:
a3f0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
a400: 5f 49 4e 54 45 52 52 55 50 54 22 3b 20 20 20 20 _INTERRUPT";
a410: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
a420: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
a430: 45 52 52 3a 20 20 20 20 20 20 20 20 20 20 20 20 ERR:
a440: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
a450: 45 5f 49 4f 45 52 52 22 3b 20 20 20 20 20 20 20 E_IOERR";
a460: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
a470: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
a480: 4f 45 52 52 5f 52 45 41 44 3a 20 20 20 20 20 20 OERR_READ:
a490: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
a4a0: 54 45 5f 49 4f 45 52 52 5f 52 45 41 44 22 3b 20 TE_IOERR_READ";
a4b0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
a4c0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
a4d0: 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 IOERR_SHORT_READ
a4e0: 3a 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c : zName = "SQL
a4f0: 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f ITE_IOERR_SHORT_
a500: 52 45 41 44 22 3b 20 20 62 72 65 61 6b 3b 0a 20 READ"; break;.
a510: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
a520: 5f 49 4f 45 52 52 5f 57 52 49 54 45 3a 20 20 20 _IOERR_WRITE:
a530: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
a540: 4c 49 54 45 5f 49 4f 45 52 52 5f 57 52 49 54 45 LITE_IOERR_WRITE
a550: 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a "; break;.
a560: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
a570: 45 5f 49 4f 45 52 52 5f 46 53 59 4e 43 3a 20 20 E_IOERR_FSYNC:
a580: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
a590: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 59 4e QLITE_IOERR_FSYN
a5a0: 43 22 3b 20 20 20 20 20 20 20 62 72 65 61 6b 3b C"; break;
a5b0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
a5c0: 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 46 53 59 TE_IOERR_DIR_FSY
a5d0: 4e 43 3a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 NC: zName = "
a5e0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 SQLITE_IOERR_DIR
a5f0: 5f 46 53 59 4e 43 22 3b 20 20 20 62 72 65 61 6b _FSYNC"; break
a600: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
a610: 49 54 45 5f 49 4f 45 52 52 5f 54 52 55 4e 43 41 ITE_IOERR_TRUNCA
a620: 54 45 3a 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 TE: zName =
a630: 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 54 52 "SQLITE_IOERR_TR
a640: 55 4e 43 41 54 45 22 3b 20 20 20 20 62 72 65 61 UNCATE"; brea
a650: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
a660: 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 LITE_IOERR_FSTAT
a670: 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d : zName =
a680: 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 "SQLITE_IOERR_F
a690: 53 54 41 54 22 3b 20 20 20 20 20 20 20 62 72 65 STAT"; bre
a6a0: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
a6b0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f QLITE_IOERR_UNLO
a6c0: 43 4b 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 CK: zName
a6d0: 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = "SQLITE_IOERR_
a6e0: 55 4e 4c 4f 43 4b 22 3b 20 20 20 20 20 20 62 72 UNLOCK"; br
a6f0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a700: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c SQLITE_IOERR_RDL
a710: 4f 43 4b 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 OCK: zName
a720: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
a730: 5f 52 44 4c 4f 43 4b 22 3b 20 20 20 20 20 20 62 _RDLOCK"; b
a740: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a750: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 SQLITE_IOERR_DE
a760: 4c 45 54 45 3a 20 20 20 20 20 20 20 7a 4e 61 6d LETE: zNam
a770: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
a780: 52 5f 44 45 4c 45 54 45 22 3b 20 20 20 20 20 20 R_DELETE";
a790: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a7a0: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e e SQLITE_IOERR_N
a7b0: 4f 4d 45 4d 3a 20 20 20 20 20 20 20 20 7a 4e 61 OMEM: zNa
a7c0: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
a7d0: 52 52 5f 4e 4f 4d 45 4d 22 3b 20 20 20 20 20 20 RR_NOMEM";
a7e0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a7f0: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
a800: 41 43 43 45 53 53 3a 20 20 20 20 20 20 20 7a 4e ACCESS: zN
a810: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
a820: 45 52 52 5f 41 43 43 45 53 53 22 3b 20 20 20 20 ERR_ACCESS";
a830: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
a840: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
a850: 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f _CHECKRESERVEDLO
a860: 43 4b 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 CK:.
a870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a880: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
a890: 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 ITE_IOERR_CHECKR
a8a0: 45 53 45 52 56 45 44 4c 4f 43 4b 22 3b 20 62 72 ESERVEDLOCK"; br
a8b0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
a8c0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 SQLITE_IOERR_LOC
a8d0: 4b 3a 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 K: zName
a8e0: 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 52 = "SQLITE_IOERR
a8f0: 5f 4c 4f 43 4b 22 3b 20 20 20 20 20 20 20 20 62 _LOCK"; b
a900: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
a910: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c SQLITE_IOERR_CL
a920: 4f 53 45 3a 20 20 20 20 20 20 20 20 7a 4e 61 6d OSE: zNam
a930: 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 52 e = "SQLITE_IOER
a940: 52 5f 43 4c 4f 53 45 22 3b 20 20 20 20 20 20 20 R_CLOSE";
a950: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
a960: 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 e SQLITE_IOERR_D
a970: 49 52 5f 43 4c 4f 53 45 3a 20 20 20 20 7a 4e 61 IR_CLOSE: zNa
a980: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f 45 me = "SQLITE_IOE
a990: 52 52 5f 44 49 52 5f 43 4c 4f 53 45 22 3b 20 20 RR_DIR_CLOSE";
a9a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
a9b0: 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f se SQLITE_IOERR_
a9c0: 53 48 4d 4f 50 45 4e 3a 20 20 20 20 20 20 7a 4e SHMOPEN: zN
a9d0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 4f ame = "SQLITE_IO
a9e0: 45 52 52 5f 53 48 4d 4f 50 45 4e 22 3b 20 20 20 ERR_SHMOPEN";
a9f0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 break;. c
aa00: 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ase SQLITE_IOERR
aa10: 5f 53 48 4d 53 49 5a 45 3a 20 20 20 20 20 20 7a _SHMSIZE: z
aa20: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 49 Name = "SQLITE_I
aa30: 4f 45 52 52 5f 53 48 4d 53 49 5a 45 22 3b 20 20 OERR_SHMSIZE";
aa40: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
aa50: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
aa60: 52 5f 53 48 4d 4c 4f 43 4b 3a 20 20 20 20 20 20 R_SHMLOCK:
aa70: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
aa80: 49 4f 45 52 52 5f 53 48 4d 4c 4f 43 4b 22 3b 20 IOERR_SHMLOCK";
aa90: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
aaa0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 case SQLITE_IOE
aab0: 52 52 5f 53 48 4d 4d 41 50 3a 20 20 20 20 20 20 RR_SHMMAP:
aac0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
aad0: 5f 49 4f 45 52 52 5f 53 48 4d 4d 41 50 22 3b 20 _IOERR_SHMMAP";
aae0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
aaf0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f case SQLITE_IO
ab00: 45 52 52 5f 53 45 45 4b 3a 20 20 20 20 20 20 20 ERR_SEEK:
ab10: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
ab20: 45 5f 49 4f 45 52 52 5f 53 45 45 4b 22 3b 20 20 E_IOERR_SEEK";
ab30: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
ab40: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 case SQLITE_I
ab50: 4f 45 52 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e OERR_DELETE_NOEN
ab60: 54 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 T: zName = "SQLI
ab70: 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 5f TE_IOERR_DELETE_
ab80: 4e 4f 45 4e 54 22 3b 62 72 65 61 6b 3b 0a 20 20 NOENT";break;.
ab90: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
aba0: 49 4f 45 52 52 5f 4d 4d 41 50 3a 20 20 20 20 20 IOERR_MMAP:
abb0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
abc0: 49 54 45 5f 49 4f 45 52 52 5f 4d 4d 41 50 22 3b ITE_IOERR_MMAP";
abd0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
abe0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
abf0: 5f 49 4f 45 52 52 5f 47 45 54 54 45 4d 50 50 41 _IOERR_GETTEMPPA
ac00: 54 48 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 TH: zName = "SQ
ac10: 4c 49 54 45 5f 49 4f 45 52 52 5f 47 45 54 54 45 LITE_IOERR_GETTE
ac20: 4d 50 50 41 54 48 22 3b 20 62 72 65 61 6b 3b 0a MPPATH"; break;.
ac30: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
ac40: 45 5f 49 4f 45 52 52 5f 43 4f 4e 56 50 41 54 48 E_IOERR_CONVPATH
ac50: 3a 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 : zName = "S
ac60: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4f 4e 56 QLITE_IOERR_CONV
ac70: 50 41 54 48 22 3b 20 20 20 20 62 72 65 61 6b 3b PATH"; break;
ac80: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
ac90: 54 45 5f 43 4f 52 52 55 50 54 3a 20 20 20 20 20 TE_CORRUPT:
aca0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
acb0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 22 3b SQLITE_CORRUPT";
acc0: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
acd0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
ace0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 56 54 41 42 ITE_CORRUPT_VTAB
acf0: 3a 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 : zName =
ad00: 22 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f "SQLITE_CORRUPT_
ad10: 56 54 41 42 22 3b 20 20 20 20 20 20 62 72 65 61 VTAB"; brea
ad20: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
ad30: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3a 20 20 LITE_NOTFOUND:
ad40: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
ad50: 20 22 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e "SQLITE_NOTFOUN
ad60: 44 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 D"; bre
ad70: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
ad80: 51 4c 49 54 45 5f 46 55 4c 4c 3a 20 20 20 20 20 QLITE_FULL:
ad90: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
ada0: 3d 20 22 53 51 4c 49 54 45 5f 46 55 4c 4c 22 3b = "SQLITE_FULL";
adb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 br
adc0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
add0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3a SQLITE_CANTOPEN:
ade0: 20 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 zName
adf0: 20 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 4f = "SQLITE_CANTO
ae00: 50 45 4e 22 3b 20 20 20 20 20 20 20 20 20 20 62 PEN"; b
ae10: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
ae20: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
ae30: 5f 4e 4f 54 45 4d 50 44 49 52 3a 20 7a 4e 61 6d _NOTEMPDIR: zNam
ae40: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e 54 e = "SQLITE_CANT
ae50: 4f 50 45 4e 5f 4e 4f 54 45 4d 50 44 49 52 22 3b OPEN_NOTEMPDIR";
ae60: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
ae70: 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 e SQLITE_CANTOPE
ae80: 4e 5f 49 53 44 49 52 3a 20 20 20 20 20 7a 4e 61 N_ISDIR: zNa
ae90: 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 41 4e me = "SQLITE_CAN
aea0: 54 4f 50 45 4e 5f 49 53 44 49 52 22 3b 20 20 20 TOPEN_ISDIR";
aeb0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 break;. ca
aec0: 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 se SQLITE_CANTOP
aed0: 45 4e 5f 46 55 4c 4c 50 41 54 48 3a 20 20 7a 4e EN_FULLPATH: zN
aee0: 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 41 ame = "SQLITE_CA
aef0: 4e 54 4f 50 45 4e 5f 46 55 4c 4c 50 41 54 48 22 NTOPEN_FULLPATH"
af00: 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 ; break;. c
af10: 61 73 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f ase SQLITE_CANTO
af20: 50 45 4e 5f 43 4f 4e 56 50 41 54 48 3a 20 20 7a PEN_CONVPATH: z
af30: 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 Name = "SQLITE_C
af40: 41 4e 54 4f 50 45 4e 5f 43 4f 4e 56 50 41 54 48 ANTOPEN_CONVPATH
af50: 22 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 "; break;.
af60: 63 61 73 65 20 53 51 4c 49 54 45 5f 50 52 4f 54 case SQLITE_PROT
af70: 4f 43 4f 4c 3a 20 20 20 20 20 20 20 20 20 20 20 OCOL:
af80: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
af90: 50 52 4f 54 4f 43 4f 4c 22 3b 20 20 20 20 20 20 PROTOCOL";
afa0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
afb0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 45 4d 50 case SQLITE_EMP
afc0: 54 59 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 TY:
afd0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
afe0: 5f 45 4d 50 54 59 22 3b 20 20 20 20 20 20 20 20 _EMPTY";
aff0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b000: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 case SQLITE_SC
b010: 48 45 4d 41 3a 20 20 20 20 20 20 20 20 20 20 20 HEMA:
b020: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b030: 45 5f 53 43 48 45 4d 41 22 3b 20 20 20 20 20 20 E_SCHEMA";
b040: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b050: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
b060: 4f 4f 42 49 47 3a 20 20 20 20 20 20 20 20 20 20 OOBIG:
b070: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b080: 54 45 5f 54 4f 4f 42 49 47 22 3b 20 20 20 20 20 TE_TOOBIG";
b090: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b0a0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b0b0: 43 4f 4e 53 54 52 41 49 4e 54 3a 20 20 20 20 20 CONSTRAINT:
b0c0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b0d0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 22 3b ITE_CONSTRAINT";
b0e0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
b0f0: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b100: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 55 4e 49 51 _CONSTRAINT_UNIQ
b110: 55 45 3a 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 UE: zName = "SQ
b120: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
b130: 55 4e 49 51 55 45 22 3b 20 62 72 65 61 6b 3b 0a UNIQUE"; break;.
b140: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b150: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 54 52 49 E_CONSTRAINT_TRI
b160: 47 47 45 52 3a 20 7a 4e 61 6d 65 20 3d 20 22 53 GGER: zName = "S
b170: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 QLITE_CONSTRAINT
b180: 5f 54 52 49 47 47 45 52 22 3b 62 72 65 61 6b 3b _TRIGGER";break;
b190: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b1a0: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 4f TE_CONSTRAINT_FO
b1b0: 52 45 49 47 4e 4b 45 59 3a 0a 20 20 20 20 20 20 REIGNKEY:.
b1c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b1d0: 20 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 zName
b1e0: 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 = "SQLITE_CONSTR
b1f0: 41 49 4e 54 5f 46 4f 52 45 49 47 4e 4b 45 59 22 AINT_FOREIGNKEY"
b200: 3b 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 ; break;.
b210: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
b220: 53 54 52 41 49 4e 54 5f 43 48 45 43 4b 3a 20 20 STRAINT_CHECK:
b230: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b240: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 43 48 45 43 _CONSTRAINT_CHEC
b250: 4b 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 K"; break;.
b260: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
b270: 4e 53 54 52 41 49 4e 54 5f 50 52 49 4d 41 52 59 NSTRAINT_PRIMARY
b280: 4b 45 59 3a 0a 20 20 20 20 20 20 20 20 20 20 20 KEY:.
b290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b2a0: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b2b0: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f LITE_CONSTRAINT_
b2c0: 50 52 49 4d 41 52 59 4b 45 59 22 3b 20 20 20 62 PRIMARYKEY"; b
b2d0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 reak;. case
b2e0: 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 SQLITE_CONSTRAI
b2f0: 4e 54 5f 4e 4f 54 4e 55 4c 4c 3a 20 7a 4e 61 6d NT_NOTNULL: zNam
b300: 65 20 3d 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 e = "SQLITE_CONS
b310: 54 52 41 49 4e 54 5f 4e 4f 54 4e 55 4c 4c 22 3b TRAINT_NOTNULL";
b320: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 break;. cas
b330: 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 e SQLITE_CONSTRA
b340: 49 4e 54 5f 43 4f 4d 4d 49 54 48 4f 4f 4b 3a 0a INT_COMMITHOOK:.
b350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b370: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b380: 43 4f 4e 53 54 52 41 49 4e 54 5f 43 4f 4d 4d 49 CONSTRAINT_COMMI
b390: 54 48 4f 4f 4b 22 3b 20 20 20 62 72 65 61 6b 3b THOOK"; break;
b3a0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b3b0: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 56 54 TE_CONSTRAINT_VT
b3c0: 41 42 3a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 AB: zName = "
b3d0: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
b3e0: 54 5f 56 54 41 42 22 3b 20 20 20 62 72 65 61 6b T_VTAB"; break
b3f0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b400: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46 ITE_CONSTRAINT_F
b410: 55 4e 43 54 49 4f 4e 3a 0a 20 20 20 20 20 20 20 UNCTION:.
b420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b430: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
b440: 20 22 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 "SQLITE_CONSTRA
b450: 49 4e 54 5f 46 55 4e 43 54 49 4f 4e 22 3b 20 20 INT_FUNCTION";
b460: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 break;.
b470: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 53 case SQLITE_CONS
b480: 54 52 41 49 4e 54 5f 52 4f 57 49 44 3a 20 20 20 TRAINT_ROWID:
b490: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b4a0: 43 4f 4e 53 54 52 41 49 4e 54 5f 52 4f 57 49 44 CONSTRAINT_ROWID
b4b0: 22 3b 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 "; break;.
b4c0: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 53 case SQLITE_MIS
b4d0: 4d 41 54 43 48 3a 20 20 20 20 20 20 20 20 20 20 MATCH:
b4e0: 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 zName = "SQLITE
b4f0: 5f 4d 49 53 4d 41 54 43 48 22 3b 20 20 20 20 20 _MISMATCH";
b500: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
b510: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4d 49 case SQLITE_MI
b520: 53 55 53 45 3a 20 20 20 20 20 20 20 20 20 20 20 SUSE:
b530: 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 zName = "SQLIT
b540: 45 5f 4d 49 53 55 53 45 22 3b 20 20 20 20 20 20 E_MISUSE";
b550: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
b560: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e case SQLITE_N
b570: 4f 4c 46 53 3a 20 20 20 20 20 20 20 20 20 20 20 OLFS:
b580: 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 zName = "SQLI
b590: 54 45 5f 4e 4f 4c 46 53 22 3b 20 20 20 20 20 20 TE_NOLFS";
b5a0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
b5b0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
b5c0: 41 55 54 48 3a 20 20 20 20 20 20 20 20 20 20 20 AUTH:
b5d0: 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 4c zName = "SQL
b5e0: 49 54 45 5f 41 55 54 48 22 3b 20 20 20 20 20 20 ITE_AUTH";
b5f0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
b600: 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 case SQLITE
b610: 5f 46 4f 52 4d 41 54 3a 20 20 20 20 20 20 20 20 _FORMAT:
b620: 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 51 zName = "SQ
b630: 4c 49 54 45 5f 46 4f 52 4d 41 54 22 3b 20 20 20 LITE_FORMAT";
b640: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
b650: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
b660: 45 5f 52 41 4e 47 45 3a 20 20 20 20 20 20 20 20 E_RANGE:
b670: 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 53 zName = "S
b680: 51 4c 49 54 45 5f 52 41 4e 47 45 22 3b 20 20 20 QLITE_RANGE";
b690: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
b6a0: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b6b0: 54 45 5f 4e 4f 54 41 44 42 3a 20 20 20 20 20 20 TE_NOTADB:
b6c0: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
b6d0: 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 22 3b 20 SQLITE_NOTADB";
b6e0: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
b6f0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b700: 49 54 45 5f 52 4f 57 3a 20 20 20 20 20 20 20 20 ITE_ROW:
b710: 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 zName =
b720: 22 53 51 4c 49 54 45 5f 52 4f 57 22 3b 20 20 20 "SQLITE_ROW";
b730: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
b740: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b750: 4c 49 54 45 5f 4e 4f 54 49 43 45 3a 20 20 20 20 LITE_NOTICE:
b760: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
b770: 20 22 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 22 "SQLITE_NOTICE"
b780: 3b 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 ; bre
b790: 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 ak;. case S
b7a0: 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 QLITE_NOTICE_REC
b7b0: 4f 56 45 52 5f 57 41 4c 3a 20 7a 4e 61 6d 65 20 OVER_WAL: zName
b7c0: 3d 20 22 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 = "SQLITE_NOTICE
b7d0: 5f 52 45 43 4f 56 45 52 5f 57 41 4c 22 3b 62 72 _RECOVER_WAL";br
b7e0: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 eak;. case
b7f0: 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 SQLITE_NOTICE_RE
b800: 43 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 4b 3a 0a COVER_ROLLBACK:.
b810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b830: 7a 4e 61 6d 65 20 3d 20 22 53 51 4c 49 54 45 5f zName = "SQLITE_
b840: 4e 4f 54 49 43 45 5f 52 45 43 4f 56 45 52 5f 52 NOTICE_RECOVER_R
b850: 4f 4c 4c 42 41 43 4b 22 3b 20 62 72 65 61 6b 3b OLLBACK"; break;
b860: 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 . case SQLI
b870: 54 45 5f 57 41 52 4e 49 4e 47 3a 20 20 20 20 20 TE_WARNING:
b880: 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d 20 22 zName = "
b890: 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 22 3b SQLITE_WARNING";
b8a0: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b break
b8b0: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 4c ;. case SQL
b8c0: 49 54 45 5f 57 41 52 4e 49 4e 47 5f 41 55 54 4f ITE_WARNING_AUTO
b8d0: 49 4e 44 45 58 3a 20 20 7a 4e 61 6d 65 20 3d 20 INDEX: zName =
b8e0: 22 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 5f "SQLITE_WARNING_
b8f0: 41 55 54 4f 49 4e 44 45 58 22 3b 20 62 72 65 61 AUTOINDEX"; brea
b900: 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20 53 51 k;. case SQ
b910: 4c 49 54 45 5f 44 4f 4e 45 3a 20 20 20 20 20 20 LITE_DONE:
b920: 20 20 20 20 20 20 20 20 20 7a 4e 61 6d 65 20 3d zName =
b930: 20 22 53 51 4c 49 54 45 5f 44 4f 4e 45 22 3b 20 "SQLITE_DONE";
b940: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
b950: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 ak;. }. }.
b960: 69 66 28 20 7a 4e 61 6d 65 3d 3d 30 20 29 7b 0a if( zName==0 ){.
b970: 20 20 20 20 73 74 61 74 69 63 20 63 68 61 72 20 static char
b980: 7a 42 75 66 5b 35 30 5d 3b 0a 20 20 20 20 73 71 zBuf[50];. sq
b990: 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 73 lite3_snprintf(s
b9a0: 69 7a 65 6f 66 28 7a 42 75 66 29 2c 20 7a 42 75 izeof(zBuf), zBu
b9b0: 66 2c 20 22 53 51 4c 49 54 45 5f 55 4e 4b 4e 4f f, "SQLITE_UNKNO
b9c0: 57 4e 28 25 64 29 22 2c 20 6f 72 69 67 52 63 29 WN(%d)", origRc)
b9d0: 3b 0a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 7a 42 ;. zName = zB
b9e0: 75 66 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e uf;. }. return
b9f0: 20 7a 4e 61 6d 65 3b 0a 7d 0a 23 65 6e 64 69 66 zName;.}.#endif
ba00: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 ../*.** Return a
ba10: 20 73 74 61 74 69 63 20 73 74 72 69 6e 67 20 74 static string t
ba20: 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 hat describes th
ba30: 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 e kind of error
ba40: 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 specified in the
ba50: 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f .** argument..*/
ba60: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c .const char *sql
ba70: 69 74 65 33 45 72 72 53 74 72 28 69 6e 74 20 72 ite3ErrStr(int r
ba80: 63 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e c){. static con
ba90: 73 74 20 63 68 61 72 2a 20 63 6f 6e 73 74 20 61 st char* const a
baa0: 4d 73 67 5b 5d 20 3d 20 7b 0a 20 20 20 20 2f 2a Msg[] = {. /*
bab0: 20 53 51 4c 49 54 45 5f 4f 4b 20 20 20 20 20 20 SQLITE_OK
bac0: 20 20 20 20 2a 2f 20 22 6e 6f 74 20 61 6e 20 65 */ "not an e
bad0: 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 51 rror",. /* SQ
bae0: 4c 49 54 45 5f 45 52 52 4f 52 20 20 20 20 20 20 LITE_ERROR
baf0: 20 2a 2f 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 */ "SQL logic e
bb00: 72 72 6f 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 rror or missing
bb10: 64 61 74 61 62 61 73 65 22 2c 0a 20 20 20 20 2f database",. /
bb20: 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 * SQLITE_INTERNA
bb30: 4c 20 20 20 20 2a 2f 20 30 2c 0a 20 20 20 20 2f L */ 0,. /
bb40: 2a 20 53 51 4c 49 54 45 5f 50 45 52 4d 20 20 20 * SQLITE_PERM
bb50: 20 20 20 20 20 2a 2f 20 22 61 63 63 65 73 73 20 */ "access
bb60: 70 65 72 6d 69 73 73 69 6f 6e 20 64 65 6e 69 65 permission denie
bb70: 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 d",. /* SQLIT
bb80: 45 5f 41 42 4f 52 54 20 20 20 20 20 20 20 2a 2f E_ABORT */
bb90: 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 75 65 "callback reque
bba0: 73 74 65 64 20 71 75 65 72 79 20 61 62 6f 72 74 sted query abort
bbb0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
bbc0: 5f 42 55 53 59 20 20 20 20 20 20 20 20 2a 2f 20 _BUSY */
bbd0: 22 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63 "database is loc
bbe0: 6b 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ked",. /* SQL
bbf0: 49 54 45 5f 4c 4f 43 4b 45 44 20 20 20 20 20 20 ITE_LOCKED
bc00: 2a 2f 20 22 64 61 74 61 62 61 73 65 20 74 61 62 */ "database tab
bc10: 6c 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0a 20 le is locked",.
bc20: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d /* SQLITE_NOM
bc30: 45 4d 20 20 20 20 20 20 20 2a 2f 20 22 6f 75 74 EM */ "out
bc40: 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 0a 20 20 20 of memory",.
bc50: 20 2f 2a 20 53 51 4c 49 54 45 5f 52 45 41 44 4f /* SQLITE_READO
bc60: 4e 4c 59 20 20 20 20 2a 2f 20 22 61 74 74 65 6d NLY */ "attem
bc70: 70 74 20 74 6f 20 77 72 69 74 65 20 61 20 72 65 pt to write a re
bc80: 61 64 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 22 adonly database"
bc90: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
bca0: 49 4e 54 45 52 52 55 50 54 20 20 20 2a 2f 20 22 INTERRUPT */ "
bcb0: 69 6e 74 65 72 72 75 70 74 65 64 22 2c 0a 20 20 interrupted",.
bcc0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4f 45 52 /* SQLITE_IOER
bcd0: 52 20 20 20 20 20 20 20 2a 2f 20 22 64 69 73 6b R */ "disk
bce0: 20 49 2f 4f 20 65 72 72 6f 72 22 2c 0a 20 20 20 I/O error",.
bcf0: 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 /* SQLITE_CORRU
bd00: 50 54 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 PT */ "datab
bd10: 61 73 65 20 64 69 73 6b 20 69 6d 61 67 65 20 69 ase disk image i
bd20: 73 20 6d 61 6c 66 6f 72 6d 65 64 22 2c 0a 20 20 s malformed",.
bd30: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54 46 /* SQLITE_NOTF
bd40: 4f 55 4e 44 20 20 20 20 2a 2f 20 22 75 6e 6b 6e OUND */ "unkn
bd50: 6f 77 6e 20 6f 70 65 72 61 74 69 6f 6e 22 2c 0a own operation",.
bd60: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 46 55 /* SQLITE_FU
bd70: 4c 4c 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61 LL */ "da
bd80: 74 61 62 61 73 65 20 6f 72 20 64 69 73 6b 20 69 tabase or disk i
bd90: 73 20 66 75 6c 6c 22 2c 0a 20 20 20 20 2f 2a 20 s full",. /*
bda0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 SQLITE_CANTOPEN
bdb0: 20 20 20 2a 2f 20 22 75 6e 61 62 6c 65 20 74 6f */ "unable to
bdc0: 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 66 open database f
bdd0: 69 6c 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ile",. /* SQL
bde0: 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 20 20 20 20 ITE_PROTOCOL
bdf0: 2a 2f 20 22 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 */ "locking prot
be00: 6f 63 6f 6c 22 2c 0a 20 20 20 20 2f 2a 20 53 51 ocol",. /* SQ
be10: 4c 49 54 45 5f 45 4d 50 54 59 20 20 20 20 20 20 LITE_EMPTY
be20: 20 2a 2f 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 */ "table conta
be30: 69 6e 73 20 6e 6f 20 64 61 74 61 22 2c 0a 20 20 ins no data",.
be40: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 53 43 48 45 /* SQLITE_SCHE
be50: 4d 41 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 MA */ "data
be60: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 base schema has
be70: 63 68 61 6e 67 65 64 22 2c 0a 20 20 20 20 2f 2a changed",. /*
be80: 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 20 20 SQLITE_TOOBIG
be90: 20 20 20 20 2a 2f 20 22 73 74 72 69 6e 67 20 6f */ "string o
bea0: 72 20 62 6c 6f 62 20 74 6f 6f 20 62 69 67 22 2c r blob too big",
beb0: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 . /* SQLITE_C
bec0: 4f 4e 53 54 52 41 49 4e 54 20 20 2a 2f 20 22 63 ONSTRAINT */ "c
bed0: 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 onstraint failed
bee0: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
bef0: 5f 4d 49 53 4d 41 54 43 48 20 20 20 20 2a 2f 20 _MISMATCH */
bf00: 22 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61 74 "datatype mismat
bf10: 63 68 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 ch",. /* SQLI
bf20: 54 45 5f 4d 49 53 55 53 45 20 20 20 20 20 20 2a TE_MISUSE *
bf30: 2f 20 22 6c 69 62 72 61 72 79 20 72 6f 75 74 69 / "library routi
bf40: 6e 65 20 63 61 6c 6c 65 64 20 6f 75 74 20 6f 66 ne called out of
bf50: 20 73 65 71 75 65 6e 63 65 22 2c 0a 20 20 20 20 sequence",.
bf60: 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 /* SQLITE_NOLFS
bf70: 20 20 20 20 20 20 2a 2f 20 22 6c 61 72 67 65 20 */ "large
bf80: 66 69 6c 65 20 73 75 70 70 6f 72 74 20 69 73 20 file support is
bf90: 64 69 73 61 62 6c 65 64 22 2c 0a 20 20 20 20 2f disabled",. /
bfa0: 2a 20 53 51 4c 49 54 45 5f 41 55 54 48 20 20 20 * SQLITE_AUTH
bfb0: 20 20 20 20 20 2a 2f 20 22 61 75 74 68 6f 72 69 */ "authori
bfc0: 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a zation denied",.
bfd0: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 46 4f /* SQLITE_FO
bfe0: 52 4d 41 54 20 20 20 20 20 20 2a 2f 20 22 61 75 RMAT */ "au
bff0: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 xiliary database
c000: 20 66 6f 72 6d 61 74 20 65 72 72 6f 72 22 2c 0a format error",.
c010: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 52 41 /* SQLITE_RA
c020: 4e 47 45 20 20 20 20 20 20 20 2a 2f 20 22 62 69 NGE */ "bi
c030: 6e 64 20 6f 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 nd or column ind
c040: 65 78 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 22 ex out of range"
c050: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
c060: 4e 4f 54 41 44 42 20 20 20 20 20 20 2a 2f 20 22 NOTADB */ "
c070: 66 69 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65 file is encrypte
c080: 64 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61 d or is not a da
c090: 74 61 62 61 73 65 22 2c 0a 20 20 7d 3b 0a 20 20 tabase",. };.
c0a0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 72 72 const char *zErr
c0b0: 20 3d 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f = "unknown erro
c0c0: 72 22 3b 0a 20 20 73 77 69 74 63 68 28 20 72 63 r";. switch( rc
c0d0: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c ){. case SQL
c0e0: 49 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 ITE_ABORT_ROLLBA
c0f0: 43 4b 3a 20 7b 0a 20 20 20 20 20 20 7a 45 72 72 CK: {. zErr
c100: 20 3d 20 22 61 62 6f 72 74 20 64 75 65 20 74 6f = "abort due to
c110: 20 52 4f 4c 4c 42 41 43 4b 22 3b 0a 20 20 20 20 ROLLBACK";.
c120: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
c130: 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 default: {.
c140: 20 20 20 20 72 63 20 26 3d 20 30 78 66 66 3b 0a rc &= 0xff;.
c150: 20 20 20 20 20 20 69 66 28 20 41 4c 57 41 59 53 if( ALWAYS
c160: 28 72 63 3e 3d 30 29 20 26 26 20 72 63 3c 41 72 (rc>=0) && rc<Ar
c170: 72 61 79 53 69 7a 65 28 61 4d 73 67 29 20 26 26 raySize(aMsg) &&
c180: 20 61 4d 73 67 5b 72 63 5d 21 3d 30 20 29 7b 0a aMsg[rc]!=0 ){.
c190: 20 20 20 20 20 20 20 20 7a 45 72 72 20 3d 20 61 zErr = a
c1a0: 4d 73 67 5b 72 63 5d 3b 0a 20 20 20 20 20 20 7d Msg[rc];. }
c1b0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
c1c0: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
c1d0: 20 7a 45 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 zErr;.}../*.**
c1e0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 This routine imp
c1f0: 6c 65 6d 65 6e 74 73 20 61 20 62 75 73 79 20 63 lements a busy c
c200: 61 6c 6c 62 61 63 6b 20 74 68 61 74 20 73 6c 65 allback that sle
c210: 65 70 73 20 61 6e 64 20 74 72 69 65 73 0a 2a 2a eps and tries.**
c220: 20 61 67 61 69 6e 20 75 6e 74 69 6c 20 61 20 74 again until a t
c230: 69 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 20 imeout value is
c240: 72 65 61 63 68 65 64 2e 20 20 54 68 65 20 74 69 reached. The ti
c250: 6d 65 6f 75 74 20 76 61 6c 75 65 20 69 73 0a 2a meout value is.*
c260: 2a 20 61 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d * an integer num
c270: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f ber of milliseco
c280: 6e 64 73 20 70 61 73 73 65 64 20 69 6e 20 61 73 nds passed in as
c290: 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 the first.** ar
c2a0: 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 gument..*/.stati
c2b0: 63 20 69 6e 74 20 73 71 6c 69 74 65 44 65 66 61 c int sqliteDefa
c2c0: 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 28 ultBusyCallback(
c2d0: 0a 20 76 6f 69 64 20 2a 70 74 72 2c 20 20 20 20 . void *ptr,
c2e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 /* Da
c2f0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
c300: 6e 20 2a 2f 0a 20 69 6e 74 20 63 6f 75 6e 74 20 n */. int count
c310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
c320: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 * Number of time
c330: 73 20 74 61 62 6c 65 20 68 61 73 20 62 65 65 6e s table has been
c340: 20 62 75 73 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 busy */.){.#if
c350: 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 20 7c 7c SQLITE_OS_WIN ||
c360: 20 48 41 56 45 5f 55 53 4c 45 45 50 0a 20 20 73 HAVE_USLEEP. s
c370: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 64 tatic const u8 d
c380: 65 6c 61 79 73 5b 5d 20 3d 0a 20 20 20 20 20 7b elays[] =. {
c390: 20 31 2c 20 32 2c 20 35 2c 20 31 30 2c 20 31 35 1, 2, 5, 10, 15
c3a0: 2c 20 32 30 2c 20 32 35 2c 20 32 35 2c 20 20 32 , 20, 25, 25, 2
c3b0: 35 2c 20 20 35 30 2c 20 20 35 30 2c 20 31 30 30 5, 50, 50, 100
c3c0: 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e };. static con
c3d0: 73 74 20 75 38 20 74 6f 74 61 6c 73 5b 5d 20 3d st u8 totals[] =
c3e0: 0a 20 20 20 20 20 7b 20 30 2c 20 31 2c 20 33 2c . { 0, 1, 3,
c3f0: 20 20 38 2c 20 31 38 2c 20 33 33 2c 20 35 33 2c 8, 18, 33, 53,
c400: 20 37 38 2c 20 31 30 33 2c 20 31 32 38 2c 20 31 78, 103, 128, 1
c410: 37 38 2c 20 32 32 38 20 7d 3b 0a 23 20 64 65 66 78, 228 };.# def
c420: 69 6e 65 20 4e 44 45 4c 41 59 20 41 72 72 61 79 ine NDELAY Array
c430: 53 69 7a 65 28 64 65 6c 61 79 73 29 0a 20 20 73 Size(delays). s
c440: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 28 73 71 qlite3 *db = (sq
c450: 6c 69 74 65 33 20 2a 29 70 74 72 3b 0a 20 20 69 lite3 *)ptr;. i
c460: 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 64 62 2d nt timeout = db-
c470: 3e 62 75 73 79 54 69 6d 65 6f 75 74 3b 0a 20 20 >busyTimeout;.
c480: 69 6e 74 20 64 65 6c 61 79 2c 20 70 72 69 6f 72 int delay, prior
c490: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 6f 75 ;.. assert( cou
c4a0: 6e 74 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 63 nt>=0 );. if( c
c4b0: 6f 75 6e 74 20 3c 20 4e 44 45 4c 41 59 20 29 7b ount < NDELAY ){
c4c0: 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c . delay = del
c4d0: 61 79 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 20 20 ays[count];.
c4e0: 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 5b 63 prior = totals[c
c4f0: 6f 75 6e 74 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a ount];. }else{.
c500: 20 20 20 20 64 65 6c 61 79 20 3d 20 64 65 6c 61 delay = dela
c510: 79 73 5b 4e 44 45 4c 41 59 2d 31 5d 3b 0a 20 20 ys[NDELAY-1];.
c520: 20 20 70 72 69 6f 72 20 3d 20 74 6f 74 61 6c 73 prior = totals
c530: 5b 4e 44 45 4c 41 59 2d 31 5d 20 2b 20 64 65 6c [NDELAY-1] + del
c540: 61 79 2a 28 63 6f 75 6e 74 2d 28 4e 44 45 4c 41 ay*(count-(NDELA
c550: 59 2d 31 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28 Y-1));. }. if(
c560: 20 70 72 69 6f 72 20 2b 20 64 65 6c 61 79 20 3e prior + delay >
c570: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 timeout ){.
c580: 64 65 6c 61 79 20 3d 20 74 69 6d 65 6f 75 74 20 delay = timeout
c590: 2d 20 70 72 69 6f 72 3b 0a 20 20 20 20 69 66 28 - prior;. if(
c5a0: 20 64 65 6c 61 79 3c 3d 30 20 29 20 72 65 74 75 delay<=0 ) retu
c5b0: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 rn 0;. }. sqli
c5c0: 74 65 33 4f 73 53 6c 65 65 70 28 64 62 2d 3e 70 te3OsSleep(db->p
c5d0: 56 66 73 2c 20 64 65 6c 61 79 2a 31 30 30 30 29 Vfs, delay*1000)
c5e0: 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 ;. return 1;.#e
c5f0: 6c 73 65 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 lse. sqlite3 *d
c600: 62 20 3d 20 28 73 71 6c 69 74 65 33 20 2a 29 70 b = (sqlite3 *)p
c610: 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 tr;. int timeou
c620: 74 20 3d 20 28 28 73 71 6c 69 74 65 33 20 2a 29 t = ((sqlite3 *)
c630: 70 74 72 29 2d 3e 62 75 73 79 54 69 6d 65 6f 75 ptr)->busyTimeou
c640: 74 3b 0a 20 20 69 66 28 20 28 63 6f 75 6e 74 2b t;. if( (count+
c650: 31 29 2a 31 30 30 30 20 3e 20 74 69 6d 65 6f 75 1)*1000 > timeou
c660: 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 t ){. return
c670: 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 0;. }. sqlite3
c680: 4f 73 53 6c 65 65 70 28 64 62 2d 3e 70 56 66 73 OsSleep(db->pVfs
c690: 2c 20 31 30 30 30 30 30 30 29 3b 0a 20 20 72 65 , 1000000);. re
c6a0: 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d turn 1;.#endif.}
c6b0: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 ../*.** Invoke t
c6c0: 68 65 20 67 69 76 65 6e 20 62 75 73 79 20 68 61 he given busy ha
c6d0: 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 ndler..**.** Thi
c6e0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
c6f0: 6c 65 64 20 77 68 65 6e 20 61 6e 20 6f 70 65 72 led when an oper
c700: 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 77 69 74 ation failed wit
c710: 68 20 61 20 6c 6f 63 6b 2e 0a 2a 2a 20 49 66 20 h a lock..** If
c720: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 this routine ret
c730: 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 urns non-zero, t
c740: 68 65 20 6c 6f 63 6b 20 69 73 20 72 65 74 72 69 he lock is retri
c750: 65 64 2e 20 20 49 66 20 69 74 0a 2a 2a 20 72 65 ed. If it.** re
c760: 74 75 72 6e 73 20 30 2c 20 74 68 65 20 6f 70 65 turns 0, the ope
c770: 72 61 74 69 6f 6e 20 61 62 6f 72 74 73 20 77 69 ration aborts wi
c780: 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 42 55 53 th an SQLITE_BUS
c790: 59 20 65 72 72 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 Y error..*/.int
c7a0: 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 sqlite3InvokeBus
c7b0: 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61 6e yHandler(BusyHan
c7c0: 64 6c 65 72 20 2a 70 29 7b 0a 20 20 69 6e 74 20 dler *p){. int
c7d0: 72 63 3b 0a 20 20 69 66 28 20 4e 45 56 45 52 28 rc;. if( NEVER(
c7e0: 70 3d 3d 30 29 20 7c 7c 20 70 2d 3e 78 46 75 6e p==0) || p->xFun
c7f0: 63 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 42 75 73 79 c==0 || p->nBusy
c800: 3c 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 <0 ) return 0;.
c810: 20 72 63 20 3d 20 70 2d 3e 78 46 75 6e 63 28 70 rc = p->xFunc(p
c820: 2d 3e 70 41 72 67 2c 20 70 2d 3e 6e 42 75 73 79 ->pArg, p->nBusy
c830: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 );. if( rc==0 )
c840: 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 20 3d {. p->nBusy =
c850: 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 -1;. }else{.
c860: 20 20 70 2d 3e 6e 42 75 73 79 2b 2b 3b 0a 20 20 p->nBusy++;.
c870: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 20 0a }. return rc; .
c880: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
c890: 75 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 62 utine sets the b
c8a0: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 usy callback for
c8b0: 20 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62 an Sqlite datab
c8c0: 61 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 ase to the.** gi
c8d0: 76 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e ven callback fun
c8e0: 63 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67 ction with the g
c8f0: 69 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 0a 2a iven argument..*
c900: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 75 /.int sqlite3_bu
c910: 73 79 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 sy_handler(. sq
c920: 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 69 6e 74 lite3 *db,. int
c930: 20 28 2a 78 42 75 73 79 29 28 76 6f 69 64 2a 2c (*xBusy)(void*,
c940: 69 6e 74 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 int),. void *pA
c950: 72 67 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c rg.){.#ifdef SQL
c960: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
c970: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
c980: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
c990: 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 (db) ) return SQ
c9a0: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
c9b0: 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 ;.#endif. sqlit
c9c0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
c9d0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d b->mutex);. db-
c9e0: 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 78 46 75 >busyHandler.xFu
c9f0: 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20 20 64 62 nc = xBusy;. db
ca00: 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 70 41 ->busyHandler.pA
ca10: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 64 62 2d rg = pArg;. db-
ca20: 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 6e 42 75 >busyHandler.nBu
ca30: 73 79 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 62 75 sy = 0;. db->bu
ca40: 73 79 54 69 6d 65 6f 75 74 20 3d 20 30 3b 0a 20 syTimeout = 0;.
ca50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
ca60: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
ca70: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
ca80: 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 _OK;.}..#ifndef
ca90: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 SQLITE_OMIT_PROG
caa0: 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a RESS_CALLBACK./*
cab0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
cac0: 20 73 65 74 73 20 74 68 65 20 70 72 6f 67 72 65 sets the progre
cad0: 73 73 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 ss callback for
cae0: 61 6e 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 an Sqlite databa
caf0: 73 65 20 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 se to the.** giv
cb00: 65 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 en callback func
cb10: 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 67 69 tion with the gi
cb20: 76 65 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 ven argument. Th
cb30: 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 e progress callb
cb40: 61 63 6b 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 ack will.** be i
cb50: 6e 76 6f 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 nvoked every nOp
cb60: 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f s opcodes..*/.vo
cb70: 69 64 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 id sqlite3_progr
cb80: 65 73 73 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 ess_handler(. s
cb90: 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 69 qlite3 *db, . i
cba0: 6e 74 20 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 nt nOps,. int (
cbb0: 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69 64 *xProgress)(void
cbc0: 2a 29 2c 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 *), . void *pAr
cbd0: 67 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 g.){.#ifdef SQLI
cbe0: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
cbf0: 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
cc00: 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
cc10: 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 db) ){. (void
cc20: 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 )SQLITE_MISUSE_B
cc30: 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b KPT;. return;
cc40: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 . }.#endif. sq
cc50: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
cc60: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
cc70: 69 66 28 20 6e 4f 70 73 3e 30 20 29 7b 0a 20 20 if( nOps>0 ){.
cc80: 20 20 64 62 2d 3e 78 50 72 6f 67 72 65 73 73 20 db->xProgress
cc90: 3d 20 78 50 72 6f 67 72 65 73 73 3b 0a 20 20 20 = xProgress;.
cca0: 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 db->nProgressOp
ccb0: 73 20 3d 20 28 75 6e 73 69 67 6e 65 64 29 6e 4f s = (unsigned)nO
ccc0: 70 73 3b 0a 20 20 20 20 64 62 2d 3e 70 50 72 6f ps;. db->pPro
ccd0: 67 72 65 73 73 41 72 67 20 3d 20 70 41 72 67 3b gressArg = pArg;
cce0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 . }else{. db
ccf0: 2d 3e 78 50 72 6f 67 72 65 73 73 20 3d 20 30 3b ->xProgress = 0;
cd00: 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 65 . db->nProgre
cd10: 73 73 4f 70 73 20 3d 20 30 3b 0a 20 20 20 20 64 ssOps = 0;. d
cd20: 62 2d 3e 70 50 72 6f 67 72 65 73 73 41 72 67 20 b->pProgressArg
cd30: 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 = 0;. }. sqlit
cd40: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
cd50: 62 2d 3e 6d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e b->mutex);.}.#en
cd60: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 dif.../*.** This
cd70: 20 72 6f 75 74 69 6e 65 20 69 6e 73 74 61 6c 6c routine install
cd80: 73 20 61 20 64 65 66 61 75 6c 74 20 62 75 73 79 s a default busy
cd90: 20 68 61 6e 64 6c 65 72 20 74 68 61 74 20 77 61 handler that wa
cda0: 69 74 73 20 66 6f 72 20 74 68 65 0a 2a 2a 20 73 its for the.** s
cdb0: 70 65 63 69 66 69 65 64 20 6e 75 6d 62 65 72 20 pecified number
cdc0: 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 of milliseconds
cdd0: 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
cde0: 20 30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 0..*/.int sqlit
cdf0: 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f 75 74 28 e3_busy_timeout(
ce00: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 sqlite3 *db, int
ce10: 20 6d 73 29 7b 0a 23 69 66 64 65 66 20 53 51 4c ms){.#ifdef SQL
ce20: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
ce30: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
ce40: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
ce50: 28 64 62 29 20 29 20 72 65 74 75 72 6e 20 53 51 (db) ) return SQ
ce60: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
ce70: 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 6d ;.#endif. if( m
ce80: 73 3e 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 s>0 ){. sqlit
ce90: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 e3_busy_handler(
cea0: 64 62 2c 20 73 71 6c 69 74 65 44 65 66 61 75 6c db, sqliteDefaul
ceb0: 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c 20 28 tBusyCallback, (
cec0: 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20 20 20 64 void*)db);. d
ced0: 62 2d 3e 62 75 73 79 54 69 6d 65 6f 75 74 20 3d b->busyTimeout =
cee0: 20 6d 73 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 ms;. }else{.
cef0: 20 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 sqlite3_busy_h
cf00: 61 6e 64 6c 65 72 28 64 62 2c 20 30 2c 20 30 29 andler(db, 0, 0)
cf10: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
cf20: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
cf30: 2a 2a 20 43 61 75 73 65 20 61 6e 79 20 70 65 6e ** Cause any pen
cf40: 64 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 20 74 ding operation t
cf50: 6f 20 73 74 6f 70 20 61 74 20 69 74 73 20 65 61 o stop at its ea
cf60: 72 6c 69 65 73 74 20 6f 70 70 6f 72 74 75 6e 69 rliest opportuni
cf70: 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ty..*/.void sqli
cf80: 74 65 33 5f 69 6e 74 65 72 72 75 70 74 28 73 71 te3_interrupt(sq
cf90: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 64 lite3 *db){.#ifd
cfa0: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
cfb0: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
cfc0: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
cfd0: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
cfe0: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
cff0: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
d000: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 return;. }.#end
d010: 69 66 0a 20 20 64 62 2d 3e 75 31 2e 69 73 49 6e if. db->u1.isIn
d020: 74 65 72 72 75 70 74 65 64 20 3d 20 31 3b 0a 7d terrupted = 1;.}
d030: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 .../*.** This fu
d040: 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 74 6c nction is exactl
d050: 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 71 y the same as sq
d060: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e lite3_create_fun
d070: 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 74 0a ction(), except.
d080: 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 64 65 ** that it is de
d090: 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61 6c signed to be cal
d0a0: 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 6c 20 led by internal
d0b0: 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 65 72 code. The differ
d0c0: 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 74 20 ence is.** that
d0d0: 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 if a malloc() fa
d0e0: 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 5f 63 ils in sqlite3_c
d0f0: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 29 reate_function()
d100: 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a , an error code.
d110: 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 ** is returned a
d120: 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 69 nd the mallocFai
d130: 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 65 64 led flag cleared
d140: 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 . .*/.int sqlite
d150: 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 20 73 3CreateFunc(. s
d160: 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f qlite3 *db,. co
d170: 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 74 nst char *zFunct
d180: 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e ionName,. int n
d190: 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a Arg,. int enc,.
d1a0: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 void *pUserDat
d1b0: 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 6e a,. void (*xFun
d1c0: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 c)(sqlite3_conte
d1d0: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
d1e0: 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 value **),. voi
d1f0: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
d200: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
d210: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
d220: 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e ),. void (*xFin
d230: 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 al)(sqlite3_cont
d240: 65 78 74 2a 29 2c 0a 20 20 46 75 6e 63 44 65 73 ext*),. FuncDes
d250: 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 72 75 tructor *pDestru
d260: 63 74 6f 72 0a 29 7b 0a 20 20 46 75 6e 63 44 65 ctor.){. FuncDe
d270: 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d f *p;. int nNam
d280: 65 3b 0a 20 20 69 6e 74 20 65 78 74 72 61 46 6c e;. int extraFl
d290: 61 67 73 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ags;.. assert(
d2a0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
d2b0: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
d2c0: 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 6f 6e . if( zFunction
d2d0: 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 20 20 Name==0 ||.
d2e0: 20 28 78 46 75 6e 63 20 26 26 20 28 78 46 69 6e (xFunc && (xFin
d2f0: 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 20 7c 7c al || xStep)) ||
d300: 20 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63 20 . (!xFunc
d310: 26 26 20 28 78 46 69 6e 61 6c 20 26 26 20 21 78 && (xFinal && !x
d320: 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 Step)) ||.
d330: 28 21 78 46 75 6e 63 20 26 26 20 28 21 78 46 69 (!xFunc && (!xFi
d340: 6e 61 6c 20 26 26 20 78 53 74 65 70 29 29 20 7c nal && xStep)) |
d350: 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 3c 2d 31 |. (nArg<-1
d360: 20 7c 7c 20 6e 41 72 67 3e 53 51 4c 49 54 45 5f || nArg>SQLITE_
d370: 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 MAX_FUNCTION_ARG
d380: 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c ) ||. (255<
d390: 28 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 (nName = sqlite3
d3a0: 53 74 72 6c 65 6e 33 30 28 20 7a 46 75 6e 63 74 Strlen30( zFunct
d3b0: 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b 0a 20 20 ionName))) ){.
d3c0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d3d0: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d MISUSE_BKPT;. }
d3e0: 0a 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 .. assert( SQLI
d3f0: 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 TE_FUNC_CONSTANT
d400: 3d 3d 53 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 ==SQLITE_DETERMI
d410: 4e 49 53 54 49 43 20 29 3b 0a 20 20 65 78 74 72 NISTIC );. extr
d420: 61 46 6c 61 67 73 20 3d 20 65 6e 63 20 26 20 20 aFlags = enc &
d430: 53 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 SQLITE_DETERMINI
d440: 53 54 49 43 3b 0a 20 20 65 6e 63 20 26 3d 20 28 STIC;. enc &= (
d450: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 4d SQLITE_FUNC_ENCM
d460: 41 53 4b 7c 53 51 4c 49 54 45 5f 41 4e 59 29 3b ASK|SQLITE_ANY);
d470: 0a 20 20 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 . .#ifndef SQLI
d480: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 TE_OMIT_UTF16.
d490: 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 /* If SQLITE_UTF
d4a0: 31 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 16 is specified
d4b0: 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 as the encoding
d4c0: 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 type, transform
d4d0: 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 this. ** to one
d4e0: 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 of SQLITE_UTF16
d4f0: 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 LE or SQLITE_UTF
d500: 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 16BE using the.
d510: 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 ** SQLITE_UTF16
d520: 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 NATIVE macro. SQ
d530: 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f LITE_UTF16 is no
d540: 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c t used internall
d550: 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 y.. **. ** If
d560: 53 51 4c 49 54 45 5f 41 4e 59 20 69 73 20 73 70 SQLITE_ANY is sp
d570: 65 63 69 66 69 65 64 2c 20 61 64 64 20 74 68 72 ecified, add thr
d580: 65 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 ee versions of t
d590: 68 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a he function. **
d5a0: 20 74 6f 20 74 68 65 20 68 61 73 68 20 74 61 62 to the hash tab
d5b0: 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 le.. */. if( e
d5c0: 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 nc==SQLITE_UTF16
d5d0: 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 53 51 ){. enc = SQ
d5e0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
d5f0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 65 6e ;. }else if( en
d600: 63 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 20 29 7b c==SQLITE_ANY ){
d610: 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 . int rc;.
d620: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 rc = sqlite3Cre
d630: 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e ateFunc(db, zFun
d640: 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c ctionName, nArg,
d650: 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 65 78 74 SQLITE_UTF8|ext
d660: 72 61 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 raFlags,.
d670: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 pUserData, xFu
d680: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 nc, xStep, xFina
d690: 6c 2c 20 70 44 65 73 74 72 75 63 74 6f 72 29 3b l, pDestructor);
d6a0: 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
d6b0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
d6c0: 72 63 20 3d 20 73 71 6c 69 74 65 33 43 72 65 61 rc = sqlite3Crea
d6d0: 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 75 6e 63 teFunc(db, zFunc
d6e0: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 tionName, nArg,
d6f0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 7c 65 SQLITE_UTF16LE|e
d700: 78 74 72 61 46 6c 61 67 73 2c 0a 20 20 20 20 20 xtraFlags,.
d710: 20 20 20 20 20 70 55 73 65 72 44 61 74 61 2c 20 pUserData,
d720: 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 xFunc, xStep, xF
d730: 69 6e 61 6c 2c 20 70 44 65 73 74 72 75 63 74 6f inal, pDestructo
d740: 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 r);. }. if
d750: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
d760: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
d770: 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 65 6e rc;. }. en
d780: 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 c = SQLITE_UTF16
d790: 42 45 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 BE;. }.#else.
d7a0: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 enc = SQLITE_UTF
d7b0: 38 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 2f 8;.#endif. . /
d7c0: 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 20 65 78 * Check if an ex
d7d0: 69 73 74 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 isting function
d7e0: 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72 69 64 is being overrid
d7f0: 64 65 6e 20 6f 72 20 64 65 6c 65 74 65 64 2e 20 den or deleted.
d800: 49 66 20 73 6f 2c 0a 20 20 2a 2a 20 61 6e 64 20 If so,. ** and
d810: 74 68 65 72 65 20 61 72 65 20 61 63 74 69 76 65 there are active
d820: 20 56 4d 73 2c 20 74 68 65 6e 20 72 65 74 75 72 VMs, then retur
d830: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 49 n SQLITE_BUSY. I
d840: 66 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a f a function. *
d850: 2a 20 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72 * is being overr
d860: 69 64 64 65 6e 2f 64 65 6c 65 74 65 64 20 62 75 idden/deleted bu
d870: 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 61 t there are no a
d880: 63 74 69 76 65 20 56 4d 73 2c 20 61 6c 6c 6f 77 ctive VMs, allow
d890: 20 74 68 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74 the. ** operat
d8a0: 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 ion to continue
d8b0: 62 75 74 20 69 6e 76 61 6c 69 64 61 74 65 20 61 but invalidate a
d8c0: 6c 6c 20 70 72 65 63 6f 6d 70 69 6c 65 64 20 73 ll precompiled s
d8d0: 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a tatements.. */.
d8e0: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e p = sqlite3Fin
d8f0: 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 dFunction(db, zF
d900: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 unctionName, nNa
d910: 6d 65 2c 20 6e 41 72 67 2c 20 28 75 38 29 65 6e me, nArg, (u8)en
d920: 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 20 26 c, 0);. if( p &
d930: 26 20 28 70 2d 3e 66 75 6e 63 46 6c 61 67 73 20 & (p->funcFlags
d940: 26 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e & SQLITE_FUNC_EN
d950: 43 4d 41 53 4b 29 3d 3d 65 6e 63 20 26 26 20 70 CMASK)==enc && p
d960: 2d 3e 6e 41 72 67 3d 3d 6e 41 72 67 20 29 7b 0a ->nArg==nArg ){.
d970: 20 20 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 if( db->nVdb
d980: 65 41 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 eActive ){.
d990: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 sqlite3ErrorWit
d9a0: 68 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f hMsg(db, SQLITE_
d9b0: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
d9c0: 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 unable to delete
d9d0: 2f 6d 6f 64 69 66 79 20 75 73 65 72 2d 66 75 6e /modify user-fun
d9e0: 63 74 69 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 ction due to act
d9f0: 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 22 29 ive statements")
da00: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
da10: 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
da20: 64 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 d );. retur
da30: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
da40: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
da50: 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 sqlite3ExpirePre
da60: 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 paredStatements(
da70: 64 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a db);. }. }..
da80: 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 69 6e p = sqlite3Fin
da90: 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 dFunction(db, zF
daa0: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 unctionName, nNa
dab0: 6d 65 2c 20 6e 41 72 67 2c 20 28 75 38 29 65 6e me, nArg, (u8)en
dac0: 63 2c 20 31 29 3b 0a 20 20 61 73 73 65 72 74 28 c, 1);. assert(
dad0: 70 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 p || db->mallocF
dae0: 61 69 6c 65 64 29 3b 0a 20 20 69 66 28 20 21 70 ailed);. if( !p
daf0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
db00: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d QLITE_NOMEM;. }
db10: 0a 0a 20 20 2f 2a 20 49 66 20 61 6e 20 6f 6c 64 .. /* If an old
db20: 65 72 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 er version of th
db30: 65 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 e function with
db40: 61 20 63 6f 6e 66 69 67 75 72 65 64 20 64 65 73 a configured des
db50: 74 72 75 63 74 6f 72 20 69 73 0a 20 20 2a 2a 20 tructor is. **
db60: 62 65 69 6e 67 20 72 65 70 6c 61 63 65 64 20 69 being replaced i
db70: 6e 76 6f 6b 65 20 74 68 65 20 64 65 73 74 72 75 nvoke the destru
db80: 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 68 65 ctor function he
db90: 72 65 2e 20 2a 2f 0a 20 20 66 75 6e 63 74 69 6f re. */. functio
dba0: 6e 44 65 73 74 72 6f 79 28 64 62 2c 20 70 29 3b nDestroy(db, p);
dbb0: 0a 0a 20 20 69 66 28 20 70 44 65 73 74 72 75 63 .. if( pDestruc
dbc0: 74 6f 72 20 29 7b 0a 20 20 20 20 70 44 65 73 74 tor ){. pDest
dbd0: 72 75 63 74 6f 72 2d 3e 6e 52 65 66 2b 2b 3b 0a ructor->nRef++;.
dbe0: 20 20 7d 0a 20 20 70 2d 3e 70 44 65 73 74 72 75 }. p->pDestru
dbf0: 63 74 6f 72 20 3d 20 70 44 65 73 74 72 75 63 74 ctor = pDestruct
dc00: 6f 72 3b 0a 20 20 70 2d 3e 66 75 6e 63 46 6c 61 or;. p->funcFla
dc10: 67 73 20 3d 20 28 70 2d 3e 66 75 6e 63 46 6c 61 gs = (p->funcFla
dc20: 67 73 20 26 20 53 51 4c 49 54 45 5f 46 55 4e 43 gs & SQLITE_FUNC
dc30: 5f 45 4e 43 4d 41 53 4b 29 20 7c 20 65 78 74 72 _ENCMASK) | extr
dc40: 61 46 6c 61 67 73 3b 0a 20 20 74 65 73 74 63 61 aFlags;. testca
dc50: 73 65 28 20 70 2d 3e 66 75 6e 63 46 6c 61 67 73 se( p->funcFlags
dc60: 20 26 20 53 51 4c 49 54 45 5f 44 45 54 45 52 4d & SQLITE_DETERM
dc70: 49 4e 49 53 54 49 43 20 29 3b 0a 20 20 70 2d 3e INISTIC );. p->
dc80: 78 46 75 6e 63 20 3d 20 78 46 75 6e 63 3b 0a 20 xFunc = xFunc;.
dc90: 20 70 2d 3e 78 53 74 65 70 20 3d 20 78 53 74 65 p->xStep = xSte
dca0: 70 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 6c 69 7a p;. p->xFinaliz
dcb0: 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 20 70 2d e = xFinal;. p-
dcc0: 3e 70 55 73 65 72 44 61 74 61 20 3d 20 70 55 73 >pUserData = pUs
dcd0: 65 72 44 61 74 61 3b 0a 20 20 70 2d 3e 6e 41 72 erData;. p->nAr
dce0: 67 20 3d 20 28 75 31 36 29 6e 41 72 67 3b 0a 20 g = (u16)nArg;.
dcf0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
dd00: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 K;.}../*.** Crea
dd10: 74 65 20 6e 65 77 20 75 73 65 72 20 66 75 6e 63 te new user func
dd20: 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 tions..*/.int sq
dd30: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e lite3_create_fun
dd40: 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 ction(. sqlite3
dd50: 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 *db,. const ch
dd60: 61 72 20 2a 7a 46 75 6e 63 2c 0a 20 20 69 6e 74 ar *zFunc,. int
dd70: 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 nArg,. int enc
dd80: 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 20 76 ,. void *p,. v
dd90: 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 71 6c oid (*xFunc)(sql
dda0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
ddb0: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
ddc0: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 53 **),. void (*xS
ddd0: 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e tep)(sqlite3_con
dde0: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
ddf0: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 3_value **),. v
de00: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 oid (*xFinal)(sq
de10: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a lite3_context*).
de20: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 ){. return sqli
de30: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 te3_create_funct
de40: 69 6f 6e 5f 76 32 28 64 62 2c 20 7a 46 75 6e 63 ion_v2(db, zFunc
de50: 2c 20 6e 41 72 67 2c 20 65 6e 63 2c 20 70 2c 20 , nArg, enc, p,
de60: 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 0a 20 20 xFunc, xStep,.
de70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
de80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
de90: 20 20 78 46 69 6e 61 6c 2c 20 30 29 3b 0a 7d 0a xFinal, 0);.}.
dea0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
deb0: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 ate_function_v2(
dec0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
ded0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
dee0: 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 41 72 67 2c unc,. int nArg,
def0: 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 6f . int enc,. vo
df00: 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a id *p,. void (*
df10: 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 xFunc)(sqlite3_c
df20: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
df30: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
df40: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 void (*xStep)(s
df50: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
df60: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
df70: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
df80: 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f xFinal)(sqlite3_
df90: 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 76 6f 69 context*),. voi
dfa0: 64 20 28 2a 78 44 65 73 74 72 6f 79 29 28 76 6f d (*xDestroy)(vo
dfb0: 69 64 20 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 id *).){. int r
dfc0: 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 c = SQLITE_ERROR
dfd0: 3b 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 ;. FuncDestruct
dfe0: 6f 72 20 2a 70 41 72 67 20 3d 20 30 3b 0a 0a 23 or *pArg = 0;..#
dff0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
e000: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
e010: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
e020: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
e030: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
e040: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
e050: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c }.#endif. sql
e060: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
e070: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 (db->mutex);. i
e080: 66 28 20 78 44 65 73 74 72 6f 79 20 29 7b 0a 20 f( xDestroy ){.
e090: 20 20 20 70 41 72 67 20 3d 20 28 46 75 6e 63 44 pArg = (FuncD
e0a0: 65 73 74 72 75 63 74 6f 72 20 2a 29 73 71 6c 69 estructor *)sqli
e0b0: 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 te3DbMallocZero(
e0c0: 64 62 2c 20 73 69 7a 65 6f 66 28 46 75 6e 63 44 db, sizeof(FuncD
e0d0: 65 73 74 72 75 63 74 6f 72 29 29 3b 0a 20 20 20 estructor));.
e0e0: 20 69 66 28 20 21 70 41 72 67 20 29 7b 0a 20 20 if( !pArg ){.
e0f0: 20 20 20 20 78 44 65 73 74 72 6f 79 28 70 29 3b xDestroy(p);
e100: 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 75 74 3b . goto out;
e110: 0a 20 20 20 20 7d 0a 20 20 20 20 70 41 72 67 2d . }. pArg-
e120: 3e 78 44 65 73 74 72 6f 79 20 3d 20 78 44 65 73 >xDestroy = xDes
e130: 74 72 6f 79 3b 0a 20 20 20 20 70 41 72 67 2d 3e troy;. pArg->
e140: 70 55 73 65 72 44 61 74 61 20 3d 20 70 3b 0a 20 pUserData = p;.
e150: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
e160: 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 3CreateFunc(db,
e170: 7a 46 75 6e 63 2c 20 6e 41 72 67 2c 20 65 6e 63 zFunc, nArg, enc
e180: 2c 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 , p, xFunc, xSte
e190: 70 2c 20 78 46 69 6e 61 6c 2c 20 70 41 72 67 29 p, xFinal, pArg)
e1a0: 3b 0a 20 20 69 66 28 20 70 41 72 67 20 26 26 20 ;. if( pArg &&
e1b0: 70 41 72 67 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b pArg->nRef==0 ){
e1c0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 . assert( rc!
e1d0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 =SQLITE_OK );.
e1e0: 20 20 78 44 65 73 74 72 6f 79 28 70 29 3b 0a 20 xDestroy(p);.
e1f0: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 sqlite3DbFree
e200: 28 64 62 2c 20 70 41 72 67 29 3b 0a 20 20 7d 0a (db, pArg);. }.
e210: 0a 20 6f 75 74 3a 0a 20 20 72 63 20 3d 20 73 71 . out:. rc = sq
e220: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
e230: 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
e240: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
e250: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
e260: 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 rc;.}..#ifndef
e270: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
e280: 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 6.int sqlite3_cr
e290: 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 31 36 28 eate_function16(
e2a0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
e2b0: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 46 const void *zF
e2c0: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 unctionName,. i
e2d0: 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 nt nArg,. int e
e2e0: 54 65 78 74 52 65 70 2c 0a 20 20 76 6f 69 64 20 TextRep,. void
e2f0: 2a 70 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 *p,. void (*xFu
e300: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
e310: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
e320: 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 6f 69 _value**),. voi
e330: 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 74 d (*xStep)(sqlit
e340: 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c e3_context*,int,
e350: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 sqlite3_value**)
e360: 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 ,. void (*xFina
e370: 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 l)(sqlite3_conte
e380: 78 74 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 xt*).){. int rc
e390: 3b 0a 20 20 63 68 61 72 20 2a 7a 46 75 6e 63 38 ;. char *zFunc8
e3a0: 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ;..#ifdef SQLITE
e3b0: 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
e3c0: 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
e3d0: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
e3e0: 29 20 7c 7c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 ) || zFunctionNa
e3f0: 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 me==0 ) return S
e400: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
e410: 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 T;.#endif. sqli
e420: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
e430: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
e440: 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
e450: 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 46 75 cFailed );. zFu
e460: 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 55 74 66 nc8 = sqlite3Utf
e470: 31 36 74 6f 38 28 64 62 2c 20 7a 46 75 6e 63 74 16to8(db, zFunct
e480: 69 6f 6e 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 4c ionName, -1, SQL
e490: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 29 ITE_UTF16NATIVE)
e4a0: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
e4b0: 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a CreateFunc(db, z
e4c0: 46 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54 65 Func8, nArg, eTe
e4d0: 78 74 52 65 70 2c 20 70 2c 20 78 46 75 6e 63 2c xtRep, p, xFunc,
e4e0: 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 30 xStep, xFinal,0
e4f0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 );. sqlite3DbFr
e500: 65 65 28 64 62 2c 20 7a 46 75 6e 63 38 29 3b 0a ee(db, zFunc8);.
e510: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 rc = sqlite3Ap
e520: 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 iExit(db, rc);.
e530: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
e540: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
e550: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
e560: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 #endif.../*.** D
e570: 65 63 6c 61 72 65 20 74 68 61 74 20 61 20 66 75 eclare that a fu
e580: 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 nction has been
e590: 6f 76 65 72 6c 6f 61 64 65 64 20 62 79 20 61 20 overloaded by a
e5a0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a virtual table..*
e5b0: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 75 6e 63 *.** If the func
e5c0: 74 69 6f 6e 20 61 6c 72 65 61 64 79 20 65 78 69 tion already exi
e5d0: 73 74 73 20 61 73 20 61 20 72 65 67 75 6c 61 72 sts as a regular
e5e0: 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 6f 6e global function
e5f0: 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 20 72 , then.** this r
e600: 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f outine is a no-o
e610: 70 2e 20 20 49 66 20 74 68 65 20 66 75 6e 63 74 p. If the funct
e620: 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 ion does not exi
e630: 73 74 2c 20 74 68 65 6e 20 63 72 65 61 74 65 0a st, then create.
e640: 2a 2a 20 61 20 6e 65 77 20 6f 6e 65 20 74 68 61 ** a new one tha
e650: 74 20 61 6c 77 61 79 73 20 74 68 72 6f 77 73 20 t always throws
e660: 61 20 72 75 6e 2d 74 69 6d 65 20 65 72 72 6f 72 a run-time error
e670: 2e 20 20 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 76 . .**.** When v
e680: 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 69 6e irtual tables in
e690: 74 65 6e 64 20 74 6f 20 70 72 6f 76 69 64 65 20 tend to provide
e6a0: 61 6e 20 6f 76 65 72 6c 6f 61 64 65 64 20 66 75 an overloaded fu
e6b0: 6e 63 74 69 6f 6e 2c 20 74 68 65 79 0a 2a 2a 20 nction, they.**
e6c0: 73 68 6f 75 6c 64 20 63 61 6c 6c 20 74 68 69 73 should call this
e6d0: 20 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6b 65 routine to make
e6e0: 20 73 75 72 65 20 74 68 65 20 67 6c 6f 62 61 6c sure the global
e6f0: 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 73 74 73 function exists
e700: 2e 0a 2a 2a 20 41 20 67 6c 6f 62 61 6c 20 66 75 ..** A global fu
e710: 6e 63 74 69 6f 6e 20 6d 75 73 74 20 65 78 69 73 nction must exis
e720: 74 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 6e t in order for n
e730: 61 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 74 ame resolution t
e740: 6f 20 77 6f 72 6b 0a 2a 2a 20 70 72 6f 70 65 72 o work.** proper
e750: 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ly..*/.int sqlit
e760: 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75 6e 63 e3_overload_func
e770: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 tion(. sqlite3
e780: 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 *db,. const cha
e790: 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 r *zName,. int
e7a0: 6e 41 72 67 0a 29 7b 0a 20 20 69 6e 74 20 6e 4e nArg.){. int nN
e7b0: 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 72 ame = sqlite3Str
e7c0: 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 3b 0a 20 20 len30(zName);.
e7d0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
e7e0: 4f 4b 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 OK;..#ifdef SQLI
e7f0: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
e800: 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
e810: 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
e820: 64 62 29 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 db) || zName==0
e830: 7c 7c 20 6e 41 72 67 3c 2d 32 20 29 7b 0a 20 20 || nArg<-2 ){.
e840: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
e850: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d MISUSE_BKPT;. }
e860: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
e870: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
e880: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
e890: 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 74 sqlite3FindFunct
e8a0: 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e ion(db, zName, n
e8b0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
e8c0: 54 45 5f 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 TE_UTF8, 0)==0 )
e8d0: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
e8e0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 2c e3CreateFunc(db,
e8f0: 20 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 zName, nArg, SQ
e900: 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 LITE_UTF8,.
e910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e920: 20 20 20 20 20 20 30 2c 20 73 71 6c 69 74 65 33 0, sqlite3
e930: 49 6e 76 61 6c 69 64 46 75 6e 63 74 69 6f 6e 2c InvalidFunction,
e940: 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 0, 0, 0);. }.
e950: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 rc = sqlite3Api
e960: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 Exit(db, rc);.
e970: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
e980: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
e990: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
e9a0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
e9b0: 4d 49 54 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 MIT_TRACE./*.**
e9c0: 52 65 67 69 73 74 65 72 20 61 20 74 72 61 63 65 Register a trace
e9d0: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 function. The
e9e0: 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 pArg from the pr
e9f0: 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 eviously registe
ea00: 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 red trace.** is
ea10: 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a returned. .**.*
ea20: 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 * A NULL trace f
ea30: 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 unction means th
ea40: 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 at no tracing is
ea50: 20 65 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f executes. A no
ea60: 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 n-NULL.** trace
ea70: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
ea80: 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 a function that
ea90: 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 is invoked at th
eaa0: 65 20 73 74 61 72 74 20 6f 66 20 65 61 63 68 0a e start of each.
eab0: 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ** SQL statement
eac0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
ead0: 65 33 5f 74 72 61 63 65 28 73 71 6c 69 74 65 33 e3_trace(sqlite3
eae0: 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 *db, void (*xTr
eaf0: 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 ace)(void*,const
eb00: 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 char*), void *p
eb10: 41 72 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f Arg){. void *pO
eb20: 6c 64 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ld;..#ifdef SQLI
eb30: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
eb40: 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 MOR. if( !sqlit
eb50: 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
eb60: 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 db) ){. (void
eb70: 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 )SQLITE_MISUSE_B
eb80: 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 KPT;. return
eb90: 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 0;. }.#endif.
eba0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
ebb0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
ebc0: 20 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 54 72 pOld = db->pTr
ebd0: 61 63 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 54 aceArg;. db->xT
ebe0: 72 61 63 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 race = xTrace;.
ebf0: 20 64 62 2d 3e 70 54 72 61 63 65 41 72 67 20 3d db->pTraceArg =
ec00: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
ec10: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
ec20: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
ec30: 6e 20 70 4f 6c 64 3b 0a 7d 0a 2f 2a 0a 2a 2a 20 n pOld;.}./*.**
ec40: 52 65 67 69 73 74 65 72 20 61 20 70 72 6f 66 69 Register a profi
ec50: 6c 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 le function. Th
ec60: 65 20 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20 e pArg from the
ec70: 70 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 previously regis
ec80: 74 65 72 65 64 20 0a 2a 2a 20 70 72 6f 66 69 6c tered .** profil
ec90: 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 72 65 e function is re
eca0: 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 turned. .**.**
ecb0: 41 20 4e 55 4c 4c 20 70 72 6f 66 69 6c 65 20 66 A NULL profile f
ecc0: 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 unction means th
ecd0: 61 74 20 6e 6f 20 70 72 6f 66 69 6c 69 6e 67 20 at no profiling
ece0: 69 73 20 65 78 65 63 75 74 65 73 2e 20 20 41 20 is executes. A
ecf0: 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 70 72 6f 66 non-NULL.** prof
ed00: 69 6c 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ile is a pointer
ed10: 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 to a function t
ed20: 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 hat is invoked a
ed30: 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
ed40: 20 6f 66 0a 2a 2a 20 65 61 63 68 20 53 51 4c 20 of.** each SQL
ed50: 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 69 statement that i
ed60: 73 20 72 75 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a s run..*/.void *
ed70: 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 sqlite3_profile(
ed80: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
ed90: 20 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 69 6c void (*xProfil
eda0: 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 e)(void*,const c
edb0: 68 61 72 2a 2c 73 71 6c 69 74 65 5f 75 69 6e 74 har*,sqlite_uint
edc0: 36 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 64),. void *pAr
edd0: 67 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c g.){. void *pOl
ede0: 64 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 d;..#ifdef SQLIT
edf0: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
ee00: 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 OR. if( !sqlite
ee10: 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 3SafetyCheckOk(d
ee20: 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 b) ){. (void)
ee30: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
ee40: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 PT;. return 0
ee50: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 ;. }.#endif. s
ee60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
ee70: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
ee80: 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 50 72 6f pOld = db->pPro
ee90: 66 69 6c 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 fileArg;. db->x
eea0: 50 72 6f 66 69 6c 65 20 3d 20 78 50 72 6f 66 69 Profile = xProfi
eeb0: 6c 65 3b 0a 20 20 64 62 2d 3e 70 50 72 6f 66 69 le;. db->pProfi
eec0: 6c 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 leArg = pArg;.
eed0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
eee0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
eef0: 20 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d return pOld;.}
ef00: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
ef10: 45 5f 4f 4d 49 54 5f 54 52 41 43 45 20 2a 2f 0a E_OMIT_TRACE */.
ef20: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
ef30: 61 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65 a function to be
ef40: 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20 61 20 invoked when a
ef50: 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d transaction comm
ef60: 69 74 73 2e 0a 2a 2a 20 49 66 20 74 68 65 20 69 its..** If the i
ef70: 6e 76 6f 6b 65 64 20 66 75 6e 63 74 69 6f 6e 20 nvoked function
ef80: 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f returns non-zero
ef90: 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6d 6d 69 , then the commi
efa0: 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 t becomes a.** r
efb0: 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 ollback..*/.void
efc0: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 *sqlite3_commit
efd0: 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 33 _hook(. sqlite3
efe0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
eff0: 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 65 /* Attach the
f000: 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 61 hook to this da
f010: 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 tabase */. int
f020: 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 (*xCallback)(voi
f030: 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 74 69 6f d*), /* Functio
f040: 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 n to invoke on e
f050: 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 ach commit */.
f060: 76 6f 69 64 20 2a 70 41 72 67 20 20 20 20 20 20 void *pArg
f070: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
f080: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 66 75 6e ument to the fun
f090: 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f ction */.){. vo
f0a0: 69 64 20 2a 70 4f 6c 64 3b 0a 0a 23 69 66 64 65 id *pOld;..#ifde
f0b0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
f0c0: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
f0d0: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
f0e0: 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 eckOk(db) ){.
f0f0: 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 (void)SQLITE_MI
f100: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 SUSE_BKPT;. r
f110: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e eturn 0;. }.#en
f120: 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 dif. sqlite3_mu
f130: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
f140: 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 tex);. pOld = d
f150: 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b 0a 20 b->pCommitArg;.
f160: 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c db->xCommitCall
f170: 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b back = xCallback
f180: 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 ;. db->pCommitA
f190: 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c rg = pArg;. sql
f1a0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
f1b0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
f1c0: 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 0a 2f eturn pOld;.}../
f1d0: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
f1e0: 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 20 69 callback to be i
f1f0: 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 6d 65 nvoked each time
f200: 20 61 20 72 6f 77 20 69 73 20 75 70 64 61 74 65 a row is update
f210: 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 6f d,.** inserted o
f220: 72 20 64 65 6c 65 74 65 64 20 75 73 69 6e 67 20 r deleted using
f230: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f this database co
f240: 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 nnection..*/.voi
f250: 64 20 2a 73 71 6c 69 74 65 33 5f 75 70 64 61 74 d *sqlite3_updat
f260: 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 65 e_hook(. sqlite
f270: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
f280: 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 74 68 /* Attach th
f290: 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 20 64 e hook to this d
f2a0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 6f 69 atabase */. voi
f2b0: 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 76 d (*xCallback)(v
f2c0: 6f 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20 63 6f oid*,int,char co
f2d0: 6e 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e 73 74 nst *,char const
f2e0: 20 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36 34 29 *,sqlite_int64)
f2f0: 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 ,. void *pArg
f300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
f310: 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 Argument to the
f320: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a function */.){.
f330: 20 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a 0a 23 void *pRet;..#
f340: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
f350: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 BLE_API_ARMOR.
f360: 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 if( !sqlite3Safe
f370: 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b tyCheckOk(db) ){
f380: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54 . (void)SQLIT
f390: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 E_MISUSE_BKPT;.
f3a0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d return 0;. }
f3b0: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
f3c0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
f3d0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 52 65 74 ->mutex);. pRet
f3e0: 20 3d 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 = db->pUpdateAr
f3f0: 67 3b 0a 20 20 64 62 2d 3e 78 55 70 64 61 74 65 g;. db->xUpdate
f400: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c Callback = xCall
f410: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 back;. db->pUpd
f420: 61 74 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 ateArg = pArg;.
f430: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
f440: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
f450: 0a 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a . return pRet;.
f460: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 }../*.** Registe
f470: 72 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 r a callback to
f480: 62 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 be invoked each
f490: 74 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 time a transacti
f4a0: 6f 6e 20 69 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 on is rolled.**
f4b0: 62 61 63 6b 20 62 79 20 74 68 69 73 20 64 61 74 back by this dat
f4c0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
f4d0: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
f4e0: 65 33 5f 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b e3_rollback_hook
f4f0: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
f500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
f510: 20 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b Attach the hook
f520: 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 to this databas
f530: 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 e */. void (*xC
f540: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c allback)(void*),
f550: 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 75 6e /* Callback fun
f560: 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 ction */. void
f570: 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 20 *pArg
f580: 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 /* Argument
f590: 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e to the function
f5a0: 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 */.){. void *p
f5b0: 52 65 74 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c Ret;..#ifdef SQL
f5c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
f5d0: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
f5e0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
f5f0: 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
f600: 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
f610: 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
f620: 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
f630: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
f640: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
f650: 0a 20 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 52 . pRet = db->pR
f660: 6f 6c 6c 62 61 63 6b 41 72 67 3b 0a 20 20 64 62 ollbackArg;. db
f670: 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 ->xRollbackCallb
f680: 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b ack = xCallback;
f690: 0a 20 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b . db->pRollback
f6a0: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 Arg = pArg;. sq
f6b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
f6c0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
f6d0: 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a return pRet;.}..
f6e0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
f6f0: 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a 20 54 68 MIT_WAL./*.** Th
f700: 65 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f e sqlite3_wal_ho
f710: 6f 6b 28 29 20 63 61 6c 6c 62 61 63 6b 20 72 65 ok() callback re
f720: 67 69 73 74 65 72 65 64 20 62 79 20 73 71 6c 69 gistered by sqli
f730: 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 63 te3_wal_autochec
f740: 6b 70 6f 69 6e 74 28 29 2e 0a 2a 2a 20 49 6e 76 kpoint()..** Inv
f750: 6f 6b 65 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f oke sqlite3_wal_
f760: 63 68 65 63 6b 70 6f 69 6e 74 20 69 66 20 74 68 checkpoint if th
f770: 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 61 6d e number of fram
f780: 65 73 20 69 6e 20 74 68 65 20 6c 6f 67 20 66 69 es in the log fi
f790: 6c 65 0a 2a 2a 20 69 73 20 67 72 65 61 74 65 72 le.** is greater
f7a0: 20 74 68 61 6e 20 73 71 6c 69 74 65 33 2e 70 57 than sqlite3.pW
f7b0: 61 6c 41 72 67 20 63 61 73 74 20 74 6f 20 61 6e alArg cast to an
f7c0: 20 69 6e 74 65 67 65 72 20 28 74 68 65 20 76 61 integer (the va
f7d0: 6c 75 65 20 63 6f 6e 66 69 67 75 72 65 64 20 62 lue configured b
f7e0: 79 0a 2a 2a 20 77 61 6c 5f 61 75 74 6f 63 68 65 y.** wal_autoche
f7f0: 63 6b 70 6f 69 6e 74 28 29 29 2e 0a 2a 2f 20 0a ckpoint())..*/ .
f800: 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 int sqlite3WalDe
f810: 66 61 75 6c 74 48 6f 6f 6b 28 0a 20 20 76 6f 69 faultHook(. voi
f820: 64 20 2a 70 43 6c 69 65 6e 74 44 61 74 61 2c 20 d *pClientData,
f830: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
f840: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 */. sqlite3 *db
f850: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 , /* C
f860: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 onnection */. c
f870: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 onst char *zDb,
f880: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 /* Databas
f890: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 61 6d e */. int nFram
f8a0: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e /*
f8b0: 20 53 69 7a 65 20 6f 66 20 57 41 4c 20 2a 2f 0a Size of WAL */.
f8c0: 29 7b 0a 20 20 69 66 28 20 6e 46 72 61 6d 65 3e ){. if( nFrame>
f8d0: 3d 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 =SQLITE_PTR_TO_I
f8e0: 4e 54 28 70 43 6c 69 65 6e 74 44 61 74 61 29 20 NT(pClientData)
f8f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 65 ){. sqlite3Be
f900: 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
f910: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 77 );. sqlite3_w
f920: 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 28 64 62 al_checkpoint(db
f930: 2c 20 7a 44 62 29 3b 0a 20 20 20 20 73 71 6c 69 , zDb);. sqli
f940: 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c te3EndBenignMall
f950: 6f 63 28 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 oc();. }. retu
f960: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
f970: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
f980: 5f 4f 4d 49 54 5f 57 41 4c 20 2a 2f 0a 0a 2f 2a _OMIT_WAL */../*
f990: 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 65 20 61 6e .** Configure an
f9a0: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f sqlite3_wal_hoo
f9b0: 6b 28 29 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 k() callback to
f9c0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 68 automatically ch
f9d0: 65 63 6b 70 6f 69 6e 74 0a 2a 2a 20 61 20 64 61 eckpoint.** a da
f9e0: 74 61 62 61 73 65 20 61 66 74 65 72 20 63 6f 6d tabase after com
f9f0: 6d 69 74 74 69 6e 67 20 61 20 74 72 61 6e 73 61 mitting a transa
fa00: 63 74 69 6f 6e 20 69 66 20 74 68 65 72 65 20 61 ction if there a
fa10: 72 65 20 6e 46 72 61 6d 65 20 6f 72 0a 2a 2a 20 re nFrame or.**
fa20: 6d 6f 72 65 20 66 72 61 6d 65 73 20 69 6e 20 74 more frames in t
fa30: 68 65 20 6c 6f 67 20 66 69 6c 65 2e 20 50 61 73 he log file. Pas
fa40: 73 69 6e 67 20 7a 65 72 6f 20 6f 72 20 61 20 6e sing zero or a n
fa50: 65 67 61 74 69 76 65 20 76 61 6c 75 65 20 61 73 egative value as
fa60: 20 74 68 65 0a 2a 2a 20 6e 46 72 61 6d 65 20 70 the.** nFrame p
fa70: 61 72 61 6d 65 74 65 72 20 64 69 73 61 62 6c 65 arameter disable
fa80: 73 20 61 75 74 6f 6d 61 74 69 63 20 63 68 65 63 s automatic chec
fa90: 6b 70 6f 69 6e 74 73 20 65 6e 74 69 72 65 6c 79 kpoints entirely
faa0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c ..**.** The call
fab0: 62 61 63 6b 20 72 65 67 69 73 74 65 72 65 64 20 back registered
fac0: 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
fad0: 20 72 65 70 6c 61 63 65 73 20 61 6e 79 20 65 78 replaces any ex
fae0: 69 73 74 69 6e 67 20 63 61 6c 6c 62 61 63 6b 0a isting callback.
faf0: 2a 2a 20 72 65 67 69 73 74 65 72 65 64 20 75 73 ** registered us
fb00: 69 6e 67 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f ing sqlite3_wal_
fb10: 68 6f 6f 6b 28 29 2e 20 4c 69 6b 65 77 69 73 65 hook(). Likewise
fb20: 2c 20 72 65 67 69 73 74 65 72 69 6e 67 20 61 20 , registering a
fb30: 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 75 73 69 6e callback.** usin
fb40: 67 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f g sqlite3_wal_ho
fb50: 6f 6b 28 29 20 64 69 73 61 62 6c 65 73 20 74 68 ok() disables th
fb60: 65 20 61 75 74 6f 6d 61 74 69 63 20 63 68 65 63 e automatic chec
fb70: 6b 70 6f 69 6e 74 20 6d 65 63 68 61 6e 69 73 6d kpoint mechanism
fb80: 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 65 64 20 62 .** configured b
fb90: 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e y this function.
fba0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
fbb0: 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 wal_autocheckpoi
fbc0: 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 nt(sqlite3 *db,
fbd0: 69 6e 74 20 6e 46 72 61 6d 65 29 7b 0a 23 69 66 int nFrame){.#if
fbe0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
fbf0: 57 41 4c 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 WAL. UNUSED_PAR
fc00: 41 4d 45 54 45 52 28 64 62 29 3b 0a 20 20 55 4e AMETER(db);. UN
fc10: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 6e USED_PARAMETER(n
fc20: 46 72 61 6d 65 29 3b 0a 23 65 6c 73 65 0a 23 69 Frame);.#else.#i
fc30: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
fc40: 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 LE_API_ARMOR. i
fc50: 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
fc60: 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 yCheckOk(db) ) r
fc70: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
fc80: 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 USE_BKPT;.#endif
fc90: 0a 20 20 69 66 28 20 6e 46 72 61 6d 65 3e 30 20 . if( nFrame>0
fca0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 77 ){. sqlite3_w
fcb0: 61 6c 5f 68 6f 6f 6b 28 64 62 2c 20 73 71 6c 69 al_hook(db, sqli
fcc0: 74 65 33 57 61 6c 44 65 66 61 75 6c 74 48 6f 6f te3WalDefaultHoo
fcd0: 6b 2c 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f k, SQLITE_INT_TO
fce0: 5f 50 54 52 28 6e 46 72 61 6d 65 29 29 3b 0a 20 _PTR(nFrame));.
fcf0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
fd00: 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 64 62 2c te3_wal_hook(db,
fd10: 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 0, 0);. }.#end
fd20: 69 66 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 if. return SQLI
fd30: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
fd40: 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 Register a callb
fd50: 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 ack to be invoke
fd60: 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 74 72 d each time a tr
fd70: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 77 72 69 ansaction is wri
fd80: 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 74 68 65 tten.** into the
fd90: 20 77 72 69 74 65 2d 61 68 65 61 64 2d 6c 6f 67 write-ahead-log
fda0: 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 by this databas
fdb0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f e connection..*/
fdc0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 .void *sqlite3_w
fdd0: 61 6c 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 74 al_hook(. sqlit
fde0: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 e3 *db,
fdf0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 74 /* At
fe00: 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 74 6f tach the hook to
fe10: 20 74 68 69 73 20 64 62 20 68 61 6e 64 6c 65 20 this db handle
fe20: 2a 2f 0a 20 20 69 6e 74 28 2a 78 43 61 6c 6c 62 */. int(*xCallb
fe30: 61 63 6b 29 28 76 6f 69 64 20 2a 2c 20 73 71 6c ack)(void *, sql
fe40: 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 ite3*, const cha
fe50: 72 2a 2c 20 69 6e 74 29 2c 0a 20 20 76 6f 69 64 r*, int),. void
fe60: 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
fe70: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
fe80: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 70 61 irst argument pa
fe90: 73 73 65 64 20 74 6f 20 78 43 61 6c 6c 62 61 63 ssed to xCallbac
fea0: 6b 28 29 20 2a 2f 0a 29 7b 0a 23 69 66 6e 64 65 k() */.){.#ifnde
feb0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
fec0: 4c 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a L. void *pRet;.
fed0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
fee0: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 ABLE_API_ARMOR.
fef0: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
ff00: 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 etyCheckOk(db) )
ff10: 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 {. (void)SQLI
ff20: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
ff30: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
ff40: 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 }.#endif. sqlit
ff50: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
ff60: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 52 65 b->mutex);. pRe
ff70: 74 20 3d 20 64 62 2d 3e 70 57 61 6c 41 72 67 3b t = db->pWalArg;
ff80: 0a 20 20 64 62 2d 3e 78 57 61 6c 43 61 6c 6c 62 . db->xWalCallb
ff90: 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b ack = xCallback;
ffa0: 0a 20 20 64 62 2d 3e 70 57 61 6c 41 72 67 20 3d . db->pWalArg =
ffb0: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
ffc0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
ffd0: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
ffe0: 6e 20 70 52 65 74 3b 0a 23 65 6c 73 65 0a 20 20 n pRet;.#else.
fff0: 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69 66 return 0;.#endif
10000 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 70 .}../*.** Checkp
10010 6f 69 6e 74 20 64 61 74 61 62 61 73 65 20 7a 44 oint database zD
10020 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 b..*/.int sqlite
10030 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
10040 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a _v2(. sqlite3 *
10050 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 db,
10060 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
10070 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 se handle */. c
10080 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 2c 20 onst char *zDb,
10090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
100a0 2a 20 4e 61 6d 65 20 6f 66 20 61 74 74 61 63 68 * Name of attach
100b0 65 64 20 64 61 74 61 62 61 73 65 20 28 6f 72 20 ed database (or
100c0 4e 55 4c 4c 29 20 2a 2f 0a 20 20 69 6e 74 20 65 NULL) */. int e
100d0 4d 6f 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 Mode,
100e0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 51 /* SQ
100f0 4c 49 54 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f LITE_CHECKPOINT_
10100 2a 20 76 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 * value */. int
10110 20 2a 70 6e 4c 6f 67 2c 20 20 20 20 20 20 20 20 *pnLog,
10120 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10130 4f 55 54 3a 20 53 69 7a 65 20 6f 66 20 57 41 4c OUT: Size of WAL
10140 20 6c 6f 67 20 69 6e 20 66 72 61 6d 65 73 20 2a log in frames *
10150 2f 0a 20 20 69 6e 74 20 2a 70 6e 43 6b 70 74 20 /. int *pnCkpt
10160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10170 20 20 20 20 2f 2a 20 4f 55 54 3a 20 54 6f 74 61 /* OUT: Tota
10180 6c 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 61 6d l number of fram
10190 65 73 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 20 es checkpointed
101a0 2a 2f 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c */.){.#ifdef SQL
101b0 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 72 ITE_OMIT_WAL. r
101c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
101d0 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 72 63 3b .#else. int rc;
101e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
101f0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
10200 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
10210 20 69 44 62 20 3d 20 53 51 4c 49 54 45 5f 4d 41 iDb = SQLITE_MA
10220 58 5f 41 54 54 41 43 48 45 44 3b 20 20 2f 2a 20 X_ATTACHED; /*
10230 73 71 6c 69 74 65 33 2e 61 44 62 5b 5d 20 69 6e sqlite3.aDb[] in
10240 64 65 78 20 6f 66 20 64 62 20 74 6f 20 63 68 65 dex of db to che
10250 63 6b 70 6f 69 6e 74 20 2a 2f 0a 0a 23 69 66 64 ckpoint */..#ifd
10260 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
10270 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
10280 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
10290 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 heckOk(db) ) ret
102a0 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
102b0 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 0a E_BKPT;.#endif..
102c0 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 /* Initialize
102d0 74 68 65 20 6f 75 74 70 75 74 20 76 61 72 69 61 the output varia
102e0 62 6c 65 73 20 74 6f 20 2d 31 20 69 6e 20 63 61 bles to -1 in ca
102f0 73 65 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 se an error occu
10300 72 73 2e 20 2a 2f 0a 20 20 69 66 28 20 70 6e 4c rs. */. if( pnL
10310 6f 67 20 29 20 2a 70 6e 4c 6f 67 20 3d 20 2d 31 og ) *pnLog = -1
10320 3b 0a 20 20 69 66 28 20 70 6e 43 6b 70 74 20 29 ;. if( pnCkpt )
10330 20 2a 70 6e 43 6b 70 74 20 3d 20 2d 31 3b 0a 0a *pnCkpt = -1;..
10340 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 45 assert( SQLITE
10350 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 _CHECKPOINT_PASS
10360 49 56 45 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 IVE==0 );. asse
10370 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 4b rt( SQLITE_CHECK
10380 50 4f 49 4e 54 5f 46 55 4c 4c 3d 3d 31 20 29 3b POINT_FULL==1 );
10390 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 54 . assert( SQLIT
103a0 45 5f 43 48 45 43 4b 50 4f 49 4e 54 5f 52 45 53 E_CHECKPOINT_RES
103b0 54 41 52 54 3d 3d 32 20 29 3b 0a 20 20 61 73 73 TART==2 );. ass
103c0 65 72 74 28 20 53 51 4c 49 54 45 5f 43 48 45 43 ert( SQLITE_CHEC
103d0 4b 50 4f 49 4e 54 5f 54 52 55 4e 43 41 54 45 3d KPOINT_TRUNCATE=
103e0 3d 33 20 29 3b 0a 20 20 69 66 28 20 65 4d 6f 64 =3 );. if( eMod
103f0 65 3c 53 51 4c 49 54 45 5f 43 48 45 43 4b 50 4f e<SQLITE_CHECKPO
10400 49 4e 54 5f 50 41 53 53 49 56 45 20 7c 7c 20 65 INT_PASSIVE || e
10410 4d 6f 64 65 3e 53 51 4c 49 54 45 5f 43 48 45 43 Mode>SQLITE_CHEC
10420 4b 50 4f 49 4e 54 5f 54 52 55 4e 43 41 54 45 20 KPOINT_TRUNCATE
10430 29 7b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e ){. /* EVIDEN
10440 43 45 2d 4f 46 3a 20 52 2d 30 33 39 39 36 2d 31 CE-OF: R-03996-1
10450 32 30 38 38 20 54 68 65 20 4d 20 70 61 72 61 6d 2088 The M param
10460 65 74 65 72 20 6d 75 73 74 20 62 65 20 61 20 76 eter must be a v
10470 61 6c 69 64 20 63 68 65 63 6b 70 6f 69 6e 74 0a alid checkpoint.
10480 20 20 20 20 2a 2a 20 6d 6f 64 65 3a 20 2a 2f 0a ** mode: */.
10490 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
104a0 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 E_MISUSE;. }..
104b0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
104c0 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
104d0 0a 20 20 69 66 28 20 7a 44 62 20 26 26 20 7a 44 . if( zDb && zD
104e0 62 5b 30 5d 20 29 7b 0a 20 20 20 20 69 44 62 20 b[0] ){. iDb
104f0 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e = sqlite3FindDbN
10500 61 6d 65 28 64 62 2c 20 7a 44 62 29 3b 0a 20 20 ame(db, zDb);.
10510 7d 0a 20 20 69 66 28 20 69 44 62 3c 30 20 29 7b }. if( iDb<0 ){
10520 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
10530 5f 45 52 52 4f 52 3b 0a 20 20 20 20 73 71 6c 69 _ERROR;. sqli
10540 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 te3ErrorWithMsg(
10550 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 db, SQLITE_ERROR
10560 2c 20 22 75 6e 6b 6e 6f 77 6e 20 64 61 74 61 62 , "unknown datab
10570 61 73 65 3a 20 25 73 22 2c 20 7a 44 62 29 3b 0a ase: %s", zDb);.
10580 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d }else{. db-
10590 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e 6e 42 75 >busyHandler.nBu
105a0 73 79 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 3d sy = 0;. rc =
105b0 20 73 71 6c 69 74 65 33 43 68 65 63 6b 70 6f 69 sqlite3Checkpoi
105c0 6e 74 28 64 62 2c 20 69 44 62 2c 20 65 4d 6f 64 nt(db, iDb, eMod
105d0 65 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 6b 70 74 e, pnLog, pnCkpt
105e0 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 );. sqlite3Er
105f0 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 20 7d ror(db, rc);. }
10600 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
10610 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
10620 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
10630 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
10640 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 ;. return rc;.#
10650 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 endif.}.../*.**
10660 43 68 65 63 6b 70 6f 69 6e 74 20 64 61 74 61 62 Checkpoint datab
10670 61 73 65 20 7a 44 62 2e 20 49 66 20 7a 44 62 20 ase zDb. If zDb
10680 69 73 20 4e 55 4c 4c 2c 20 6f 72 20 69 66 20 74 is NULL, or if t
10690 68 65 20 62 75 66 66 65 72 20 7a 44 62 20 70 6f he buffer zDb po
106a0 69 6e 74 73 0a 2a 2a 20 74 6f 20 63 6f 6e 74 61 ints.** to conta
106b0 69 6e 73 20 61 20 7a 65 72 6f 2d 6c 65 6e 67 74 ins a zero-lengt
106c0 68 20 73 74 72 69 6e 67 2c 20 61 6c 6c 20 61 74 h string, all at
106d0 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73 tached databases
106e0 20 61 72 65 20 0a 2a 2a 20 63 68 65 63 6b 70 6f are .** checkpo
106f0 69 6e 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 inted..*/.int sq
10700 6c 69 74 65 33 5f 77 61 6c 5f 63 68 65 63 6b 70 lite3_wal_checkp
10710 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 oint(sqlite3 *db
10720 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 , const char *zD
10730 62 29 7b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 b){. /* EVIDENC
10740 45 2d 4f 46 3a 20 52 2d 34 31 36 31 33 2d 32 30 E-OF: R-41613-20
10750 35 35 33 20 54 68 65 20 73 71 6c 69 74 65 33 5f 553 The sqlite3_
10760 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 28 44 wal_checkpoint(D
10770 2c 58 29 20 69 73 20 65 71 75 69 76 61 6c 65 6e ,X) is equivalen
10780 74 20 74 6f 0a 20 20 2a 2a 20 73 71 6c 69 74 65 t to. ** sqlite
10790 33 5f 77 61 6c 5f 63 68 65 63 6b 70 6f 69 6e 74 3_wal_checkpoint
107a0 5f 76 32 28 44 2c 58 2c 53 51 4c 49 54 45 5f 43 _v2(D,X,SQLITE_C
107b0 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 HECKPOINT_PASSIV
107c0 45 2c 30 2c 30 29 2e 20 2a 2f 0a 20 20 72 65 74 E,0,0). */. ret
107d0 75 72 6e 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f urn sqlite3_wal_
107e0 63 68 65 63 6b 70 6f 69 6e 74 5f 76 32 28 64 62 checkpoint_v2(db
107f0 2c 7a 44 62 2c 53 51 4c 49 54 45 5f 43 48 45 43 ,zDb,SQLITE_CHEC
10800 4b 50 4f 49 4e 54 5f 50 41 53 53 49 56 45 2c 30 KPOINT_PASSIVE,0
10810 2c 30 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 ,0);.}..#ifndef
10820 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
10830 2f 2a 0a 2a 2a 20 52 75 6e 20 61 20 63 68 65 63 /*.** Run a chec
10840 6b 70 6f 69 6e 74 20 6f 6e 20 64 61 74 61 62 61 kpoint on databa
10850 73 65 20 69 44 62 2e 20 54 68 69 73 20 69 73 20 se iDb. This is
10860 61 20 6e 6f 2d 6f 70 20 69 66 20 64 61 74 61 62 a no-op if datab
10870 61 73 65 20 69 44 62 20 69 73 0a 2a 2a 20 6e 6f ase iDb is.** no
10880 74 20 63 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e t currently open
10890 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 0a 2a 2a in WAL mode..**
108a0 0a 2a 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63 .** If a transac
108b0 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 6f 6e 20 tion is open on
108c0 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 69 the database bei
108d0 6e 67 20 63 68 65 63 6b 70 6f 69 6e 74 65 64 2c ng checkpointed,
108e0 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 74 69 this .** functi
108f0 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 on returns SQLIT
10900 45 5f 4c 4f 43 4b 45 44 20 61 6e 64 20 61 20 63 E_LOCKED and a c
10910 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 6e 6f 74 heckpoint is not
10920 20 61 74 74 65 6d 70 74 65 64 2e 20 49 66 20 0a attempted. If .
10930 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 ** an error occu
10940 72 73 20 77 68 69 6c 65 20 72 75 6e 6e 69 6e 67 rs while running
10950 20 74 68 65 20 63 68 65 63 6b 70 6f 69 6e 74 2c the checkpoint,
10960 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
10970 20 63 6f 64 65 20 69 73 20 0a 2a 2a 20 72 65 74 code is .** ret
10980 75 72 6e 65 64 20 28 69 2e 65 2e 20 53 51 4c 49 urned (i.e. SQLI
10990 54 45 5f 49 4f 45 52 52 29 2e 20 4f 74 68 65 72 TE_IOERR). Other
109a0 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f 4b 2e wise, SQLITE_OK.
109b0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 65 78 .**.** The mutex
109c0 20 6f 6e 20 64 61 74 61 62 61 73 65 20 68 61 6e on database han
109d0 64 6c 65 20 64 62 20 73 68 6f 75 6c 64 20 62 65 dle db should be
109e0 20 68 65 6c 64 20 62 79 20 74 68 65 20 63 61 6c held by the cal
109f0 6c 65 72 2e 20 54 68 65 20 6d 75 74 65 78 0a 2a ler. The mutex.*
10a00 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 * associated wit
10a10 68 20 74 68 65 20 73 70 65 63 69 66 69 63 20 62 h the specific b
10a20 2d 74 72 65 65 20 62 65 69 6e 67 20 63 68 65 63 -tree being chec
10a30 6b 70 6f 69 6e 74 65 64 20 69 73 20 74 61 6b 65 kpointed is take
10a40 6e 20 62 79 0a 2a 2a 20 74 68 69 73 20 66 75 6e n by.** this fun
10a50 63 74 69 6f 6e 20 77 68 69 6c 65 20 74 68 65 20 ction while the
10a60 63 68 65 63 6b 70 6f 69 6e 74 20 69 73 20 72 75 checkpoint is ru
10a70 6e 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 nning..**.** If
10a80 69 44 62 20 69 73 20 70 61 73 73 65 64 20 53 51 iDb is passed SQ
10a90 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 LITE_MAX_ATTACHE
10aa0 44 2c 20 74 68 65 6e 20 61 6c 6c 20 61 74 74 61 D, then all atta
10ab0 63 68 65 64 20 64 61 74 61 62 61 73 65 73 20 61 ched databases a
10ac0 72 65 0a 2a 2a 20 63 68 65 63 6b 70 6f 69 6e 74 re.** checkpoint
10ad0 65 64 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 ed. If an error
10ae0 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 69 is encountered i
10af0 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 6d t is returned im
10b00 6d 65 64 69 61 74 65 6c 79 20 2d 0a 2a 2a 20 6e mediately -.** n
10b10 6f 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 o attempt is mad
10b20 65 20 74 6f 20 63 68 65 63 6b 70 6f 69 6e 74 20 e to checkpoint
10b30 61 6e 79 20 72 65 6d 61 69 6e 69 6e 67 20 64 61 any remaining da
10b40 74 61 62 61 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 50 tabases..**.** P
10b50 61 72 61 6d 65 74 65 72 20 65 4d 6f 64 65 20 69 arameter eMode i
10b60 73 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f s one of SQLITE_
10b70 43 48 45 43 4b 50 4f 49 4e 54 5f 50 41 53 53 49 CHECKPOINT_PASSI
10b80 56 45 2c 20 46 55 4c 4c 20 6f 72 20 52 45 53 54 VE, FULL or REST
10b90 41 52 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ART..*/.int sqli
10ba0 74 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 te3Checkpoint(sq
10bb0 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 69 lite3 *db, int i
10bc0 44 62 2c 20 69 6e 74 20 65 4d 6f 64 65 2c 20 69 Db, int eMode, i
10bd0 6e 74 20 2a 70 6e 4c 6f 67 2c 20 69 6e 74 20 2a nt *pnLog, int *
10be0 70 6e 43 6b 70 74 29 7b 0a 20 20 69 6e 74 20 72 pnCkpt){. int r
10bf0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
10c00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
10c10 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
10c20 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 nt i;
10c30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
10c40 2a 20 55 73 65 64 20 74 6f 20 69 74 65 72 61 74 * Used to iterat
10c50 65 20 74 68 72 6f 75 67 68 20 61 74 74 61 63 68 e through attach
10c60 65 64 20 64 62 73 20 2a 2f 0a 20 20 69 6e 74 20 ed dbs */. int
10c70 62 42 75 73 79 20 3d 20 30 3b 20 20 20 20 20 20 bBusy = 0;
10c80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
10c90 72 75 65 20 69 66 20 53 51 4c 49 54 45 5f 42 55 rue if SQLITE_BU
10ca0 53 59 20 68 61 73 20 62 65 65 6e 20 65 6e 63 6f SY has been enco
10cb0 75 6e 74 65 72 65 64 20 2a 2f 0a 0a 20 20 61 73 untered */.. as
10cc0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
10cd0 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 tex_held(db->mut
10ce0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
10cf0 20 21 70 6e 4c 6f 67 20 7c 7c 20 2a 70 6e 4c 6f !pnLog || *pnLo
10d00 67 3d 3d 2d 31 20 29 3b 0a 20 20 61 73 73 65 72 g==-1 );. asser
10d10 74 28 20 21 70 6e 43 6b 70 74 20 7c 7c 20 2a 70 t( !pnCkpt || *p
10d20 6e 43 6b 70 74 3d 3d 2d 31 20 29 3b 0a 0a 20 20 nCkpt==-1 );..
10d30 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e for(i=0; i<db->n
10d40 44 62 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 Db && rc==SQLITE
10d50 5f 4f 4b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 _OK; i++){. i
10d60 66 28 20 69 3d 3d 69 44 62 20 7c 7c 20 69 44 62 f( i==iDb || iDb
10d70 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 ==SQLITE_MAX_ATT
10d80 41 43 48 45 44 20 29 7b 0a 20 20 20 20 20 20 72 ACHED ){. r
10d90 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
10da0 43 68 65 63 6b 70 6f 69 6e 74 28 64 62 2d 3e 61 Checkpoint(db->a
10db0 44 62 5b 69 5d 2e 70 42 74 2c 20 65 4d 6f 64 65 Db[i].pBt, eMode
10dc0 2c 20 70 6e 4c 6f 67 2c 20 70 6e 43 6b 70 74 29 , pnLog, pnCkpt)
10dd0 3b 0a 20 20 20 20 20 20 70 6e 4c 6f 67 20 3d 20 ;. pnLog =
10de0 30 3b 0a 20 20 20 20 20 20 70 6e 43 6b 70 74 20 0;. pnCkpt
10df0 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 72 = 0;. if( r
10e00 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 c==SQLITE_BUSY )
10e10 7b 0a 20 20 20 20 20 20 20 20 62 42 75 73 79 20 {. bBusy
10e20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 72 63 20 = 1;. rc
10e30 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
10e40 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a }. }. }..
10e50 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d 53 51 return (rc==SQ
10e60 4c 49 54 45 5f 4f 4b 20 26 26 20 62 42 75 73 79 LITE_OK && bBusy
10e70 29 20 3f 20 53 51 4c 49 54 45 5f 42 55 53 59 20 ) ? SQLITE_BUSY
10e80 3a 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f : rc;.}.#endif /
10e90 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 * SQLITE_OMIT_WA
10ea0 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 L */../*.** This
10eb0 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
10ec0 73 20 74 72 75 65 20 69 66 20 6d 61 69 6e 2d 6d s true if main-m
10ed0 65 6d 6f 72 79 20 73 68 6f 75 6c 64 20 62 65 20 emory should be
10ee0 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 0a used instead of.
10ef0 2a 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 ** a temporary f
10f00 69 6c 65 20 66 6f 72 20 74 72 61 6e 73 69 65 6e ile for transien
10f10 74 20 70 61 67 65 72 20 66 69 6c 65 73 20 61 6e t pager files an
10f20 64 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 d statement jour
10f30 6e 61 6c 73 2e 0a 2a 2a 20 54 68 65 20 76 61 6c nals..** The val
10f40 75 65 20 72 65 74 75 72 6e 65 64 20 64 65 70 65 ue returned depe
10f50 6e 64 73 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 nds on the value
10f60 20 6f 66 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f of db->temp_sto
10f70 72 65 20 28 72 75 6e 74 69 6d 65 0a 2a 2a 20 70 re (runtime.** p
10f80 61 72 61 6d 65 74 65 72 29 20 61 6e 64 20 74 68 arameter) and th
10f90 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 20 76 e compile time v
10fa0 61 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 alue of SQLITE_T
10fb0 45 4d 50 5f 53 54 4f 52 45 2e 20 54 68 65 0a 2a EMP_STORE. The.*
10fc0 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c * following tabl
10fd0 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 e describes the
10fe0 72 65 6c 61 74 69 6f 6e 73 68 69 70 20 62 65 74 relationship bet
10ff0 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f 20 76 ween these two v
11000 61 6c 75 65 73 0a 2a 2a 20 61 6e 64 20 74 68 69 alues.** and thi
11010 73 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 s functions retu
11020 72 6e 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 rn value..**.**
11030 20 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 SQLITE_TEMP_ST
11040 4f 52 45 20 20 20 20 20 64 62 2d 3e 74 65 6d 70 ORE db->temp
11050 5f 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 61 74 _store Locat
11060 69 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 ion of temporary
11070 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 2d database.** -
11080 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
11090 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -----------
110a0 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d --- --------
110b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
110c0 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 ------.** 0
110d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
110e0 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 20 any
110f0 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 file (
11100 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 31 return 0).** 1
11110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11120 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20 1
11130 20 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 file
11140 20 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 (return 0).**
11150 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 1
11160 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 2
11170 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 memor
11180 79 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a y (return 1).
11190 2a 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 20 ** 1
111a0 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20 0
111b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 fi
111c0 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 le (return
111d0 30 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 20 0).** 2
111e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 20 1
111f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11200 20 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 file (retu
11210 72 6e 20 30 29 0a 2a 2a 20 20 20 32 20 20 20 20 rn 0).** 2
11220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11230 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
11240 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 memory (r
11250 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 32 20 eturn 1).** 2
11260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11270 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 0
11280 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 memory
11290 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 (return 1).**
112a0 20 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3
112b0 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 any
112c0 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 memory
112d0 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a 2a (return 1).*
112e0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 65 6d /.int sqlite3Tem
112f0 70 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 74 20 pInMemory(const
11300 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 sqlite3 *db){.#i
11310 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 f SQLITE_TEMP_ST
11320 4f 52 45 3d 3d 31 0a 20 20 72 65 74 75 72 6e 20 ORE==1. return
11330 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 ( db->temp_store
11340 3d 3d 32 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69 ==2 );.#endif.#i
11350 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 f SQLITE_TEMP_ST
11360 4f 52 45 3d 3d 32 0a 20 20 72 65 74 75 72 6e 20 ORE==2. return
11370 28 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 ( db->temp_store
11380 21 3d 31 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69 !=1 );.#endif.#i
11390 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 f SQLITE_TEMP_ST
113a0 4f 52 45 3d 3d 33 0a 20 20 72 65 74 75 72 6e 20 ORE==3. return
113b0 31 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 1;.#endif.#if SQ
113c0 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3c LITE_TEMP_STORE<
113d0 31 20 7c 7c 20 53 51 4c 49 54 45 5f 54 45 4d 50 1 || SQLITE_TEMP
113e0 5f 53 54 4f 52 45 3e 33 0a 20 20 72 65 74 75 72 _STORE>3. retur
113f0 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f n 0;.#endif.}../
11400 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d *.** Return UTF-
11410 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 8 encoded Englis
11420 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61 h language expla
11430 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f nation of the mo
11440 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 st recent.** err
11450 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 or..*/.const cha
11460 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 r *sqlite3_errms
11470 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a g(sqlite3 *db){.
11480 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b const char *z;
11490 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 . if( !db ){.
114a0 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
114b0 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 4f ErrStr(SQLITE_NO
114c0 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 MEM);. }. if(
114d0 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
114e0 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 eckSickOrOk(db)
114f0 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 ){. return sq
11500 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 lite3ErrStr(SQLI
11510 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 29 3b TE_MISUSE_BKPT);
11520 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
11530 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
11540 75 74 65 78 29 3b 0a 20 20 69 66 28 20 64 62 2d utex);. if( db-
11550 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b >mallocFailed ){
11560 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 . z = sqlite3
11570 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 4f ErrStr(SQLITE_NO
11580 4d 45 4d 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 MEM);. }else{.
11590 20 20 20 74 65 73 74 63 61 73 65 28 20 64 62 2d testcase( db-
115a0 3e 70 45 72 72 3d 3d 30 20 29 3b 0a 20 20 20 20 >pErr==0 );.
115b0 7a 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74 z = (char*)sqlit
115c0 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 e3_value_text(db
115d0 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 61 73 73 ->pErr);. ass
115e0 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 ert( !db->malloc
115f0 46 61 69 6c 65 64 20 29 3b 0a 20 20 20 20 69 66 Failed );. if
11600 28 20 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ( z==0 ){.
11610 7a 20 3d 20 73 71 6c 69 74 65 33 45 72 72 53 74 z = sqlite3ErrSt
11620 72 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 3b 0a r(db->errCode);.
11630 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
11640 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
11650 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
11660 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 turn z;.}..#ifnd
11670 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
11680 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 TF16./*.** Retur
11690 6e 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 n UTF-16 encoded
116a0 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 English languag
116b0 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 e explanation of
116c0 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
116d0 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f .** error..*/.co
116e0 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 nst void *sqlite
116f0 33 5f 65 72 72 6d 73 67 31 36 28 73 71 6c 69 74 3_errmsg16(sqlit
11700 65 33 20 2a 64 62 29 7b 0a 20 20 73 74 61 74 69 e3 *db){. stati
11710 63 20 63 6f 6e 73 74 20 75 31 36 20 6f 75 74 4f c const u16 outO
11720 66 4d 65 6d 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 fMem[] = {. '
11730 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 20 o', 'u', 't', '
11740 27 2c 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 27 ', 'o', 'f', ' '
11750 2c 20 27 6d 27 2c 20 27 65 27 2c 20 27 6d 27 2c , 'm', 'e', 'm',
11760 20 27 6f 27 2c 20 27 72 27 2c 20 27 79 27 2c 20 'o', 'r', 'y',
11770 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 0. };. static
11780 63 6f 6e 73 74 20 75 31 36 20 6d 69 73 75 73 65 const u16 misuse
11790 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6c 27 2c 20 [] = {. 'l',
117a0 27 69 27 2c 20 27 62 27 2c 20 27 72 27 2c 20 27 'i', 'b', 'r', '
117b0 61 27 2c 20 27 72 27 2c 20 27 79 27 2c 20 27 20 a', 'r', 'y', '
117c0 27 2c 20 0a 20 20 20 20 27 72 27 2c 20 27 6f 27 ', . 'r', 'o'
117d0 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 69 27 2c , 'u', 't', 'i',
117e0 20 27 6e 27 2c 20 27 65 27 2c 20 27 20 27 2c 20 'n', 'e', ' ',
117f0 0a 20 20 20 20 27 63 27 2c 20 27 61 27 2c 20 27 . 'c', 'a', '
11800 6c 27 2c 20 27 6c 27 2c 20 27 65 27 2c 20 27 64 l', 'l', 'e', 'd
11810 27 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 6f 27 ', ' ', . 'o'
11820 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c , 'u', 't', ' ',
11830 20 0a 20 20 20 20 27 6f 27 2c 20 27 66 27 2c 20 . 'o', 'f',
11840 27 20 27 2c 20 0a 20 20 20 20 27 73 27 2c 20 27 ' ', . 's', '
11850 65 27 2c 20 27 71 27 2c 20 27 75 27 2c 20 27 65 e', 'q', 'u', 'e
11860 27 2c 20 27 6e 27 2c 20 27 63 27 2c 20 27 65 27 ', 'n', 'c', 'e'
11870 2c 20 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 , 0. };.. cons
11880 74 20 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 66 28 t void *z;. if(
11890 20 21 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 !db ){. retu
118a0 72 6e 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 rn (void *)outOf
118b0 4d 65 6d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 Mem;. }. if( !
118c0 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
118d0 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 ckSickOrOk(db) )
118e0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f {. return (vo
118f0 69 64 20 2a 29 6d 69 73 75 73 65 3b 0a 20 20 7d id *)misuse;. }
11900 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
11910 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
11920 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c );. if( db->mal
11930 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 locFailed ){.
11940 20 7a 20 3d 20 28 76 6f 69 64 20 2a 29 6f 75 74 z = (void *)out
11950 4f 66 4d 65 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a OfMem;. }else{.
11960 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f z = sqlite3_
11970 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d value_text16(db-
11980 3e 70 45 72 72 29 3b 0a 20 20 20 20 69 66 28 20 >pErr);. if(
11990 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 z==0 ){. sq
119a0 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 lite3ErrorWithMs
119b0 67 28 64 62 2c 20 64 62 2d 3e 65 72 72 43 6f 64 g(db, db->errCod
119c0 65 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 e, sqlite3ErrStr
119d0 28 64 62 2d 3e 65 72 72 43 6f 64 65 29 29 3b 0a (db->errCode));.
119e0 20 20 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 z = sqlite
119f0 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 3_value_text16(d
11a00 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 7d 0a b->pErr);. }.
11a10 20 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 28 /* A malloc(
11a20 29 20 6d 61 79 20 68 61 76 65 20 66 61 69 6c 65 ) may have faile
11a30 64 20 77 69 74 68 69 6e 20 74 68 65 20 63 61 6c d within the cal
11a40 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 61 6c l to sqlite3_val
11a50 75 65 5f 74 65 78 74 31 36 28 29 0a 20 20 20 20 ue_text16().
11a60 2a 2a 20 61 62 6f 76 65 2e 20 49 66 20 74 68 69 ** above. If thi
11a70 73 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 74 s is the case, t
11a80 68 65 6e 20 74 68 65 20 64 62 2d 3e 6d 61 6c 6c hen the db->mall
11a90 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 6e 65 ocFailed flag ne
11aa0 65 64 73 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 eds to. ** be
11ab0 20 63 6c 65 61 72 65 64 20 62 65 66 6f 72 65 20 cleared before
11ac0 72 65 74 75 72 6e 69 6e 67 2e 20 44 6f 20 74 68 returning. Do th
11ad0 69 73 20 64 69 72 65 63 74 6c 79 2c 20 69 6e 73 is directly, ins
11ae0 74 65 61 64 20 6f 66 20 76 69 61 0a 20 20 20 20 tead of via.
11af0 2a 2a 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 ** sqlite3ApiExi
11b00 74 28 29 2c 20 74 6f 20 61 76 6f 69 64 20 73 65 t(), to avoid se
11b10 74 74 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 tting the databa
11b20 73 65 20 68 61 6e 64 6c 65 20 65 72 72 6f 72 20 se handle error
11b30 6d 65 73 73 61 67 65 2e 0a 20 20 20 20 2a 2f 0a message.. */.
11b40 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 db->mallocFa
11b50 69 6c 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 iled = 0;. }.
11b60 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
11b70 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
11b80 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 23 65 return z;.}.#e
11b90 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
11ba0 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a MIT_UTF16 */../*
11bb0 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d .** Return the m
11bc0 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 ost recent error
11bd0 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20 code generated
11be0 62 79 20 61 6e 20 53 51 4c 69 74 65 20 72 6f 75 by an SQLite rou
11bf0 74 69 6e 65 2e 20 49 66 20 4e 55 4c 4c 20 69 73 tine. If NULL is
11c00 0a 2a 2a 20 70 61 73 73 65 64 20 74 6f 20 74 68 .** passed to th
11c10 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 77 65 20 is function, we
11c20 61 73 73 75 6d 65 20 61 20 6d 61 6c 6c 6f 63 28 assume a malloc(
11c30 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 20 ) failed during
11c40 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e 0a sqlite3_open()..
11c50 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 */.int sqlite3_e
11c60 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 2a rrcode(sqlite3 *
11c70 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 26 db){. if( db &&
11c80 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
11c90 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
11ca0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
11cb0 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
11cc0 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 62 T;. }. if( !db
11cd0 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 || db->mallocFa
11ce0 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 75 iled ){. retu
11cf0 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
11d00 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 62 . }. return db
11d10 2d 3e 65 72 72 43 6f 64 65 20 26 20 64 62 2d 3e ->errCode & db->
11d20 65 72 72 4d 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 errMask;.}.int s
11d30 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 64 5f qlite3_extended_
11d40 65 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 errcode(sqlite3
11d50 2a 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 *db){. if( db &
11d60 26 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 & !sqlite3Safety
11d70 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 CheckSickOrOk(db
11d80 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
11d90 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
11da0 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 64 PT;. }. if( !d
11db0 62 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 b || db->mallocF
11dc0 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 74 ailed ){. ret
11dd0 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
11de0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 64 ;. }. return d
11df0 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 2f b->errCode;.}../
11e00 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 *.** Return a st
11e10 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72 69 ring that descri
11e20 62 65 73 20 74 68 65 20 6b 69 6e 64 20 6f 66 20 bes the kind of
11e30 65 72 72 6f 72 20 73 70 65 63 69 66 69 65 64 20 error specified
11e40 69 6e 20 74 68 65 0a 2a 2a 20 61 72 67 75 6d 65 in the.** argume
11e50 6e 74 2e 20 20 46 6f 72 20 6e 6f 77 2c 20 74 68 nt. For now, th
11e60 69 73 20 73 69 6d 70 6c 79 20 63 61 6c 6c 73 20 is simply calls
11e70 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 71 6c the internal sql
11e80 69 74 65 33 45 72 72 53 74 72 28 29 0a 2a 2a 20 ite3ErrStr().**
11e90 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 63 6f 6e function..*/.con
11ea0 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
11eb0 5f 65 72 72 73 74 72 28 69 6e 74 20 72 63 29 7b _errstr(int rc){
11ec0 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
11ed0 33 45 72 72 53 74 72 28 72 63 29 3b 0a 7d 0a 0a 3ErrStr(rc);.}..
11ee0 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e /*.** Create a n
11ef0 65 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e ew collating fun
11f00 63 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 ction for databa
11f10 73 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 se "db". The na
11f20 6d 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 me is zName.** a
11f30 6e 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 nd the encoding
11f40 69 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 is enc..*/.stati
11f50 63 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c c int createColl
11f60 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 ation(. sqlite3
11f70 2a 20 64 62 2c 0a 20 20 63 6f 6e 73 74 20 63 68 * db,. const ch
11f80 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 75 38 ar *zName, . u8
11f90 20 65 6e 63 2c 0a 20 20 76 6f 69 64 2a 20 70 43 enc,. void* pC
11fa0 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 tx,. int(*xComp
11fb0 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 are)(void*,int,c
11fc0 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 onst void*,int,c
11fd0 6f 6e 73 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 onst void*),. v
11fe0 6f 69 64 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a oid(*xDel)(void*
11ff0 29 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 71 20 2a ).){. CollSeq *
12000 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 65 6e 63 pColl;. int enc
12010 32 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 2;. . assert(
12020 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
12030 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
12040 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 .. /* If SQLITE
12050 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 _UTF16 is specif
12060 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 ied as the encod
12070 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 ing type, transf
12080 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f orm this. ** to
12090 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 one of SQLITE_U
120a0 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 TF16LE or SQLITE
120b0 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 _UTF16BE using t
120c0 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 he. ** SQLITE_U
120d0 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f TF16NATIVE macro
120e0 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 . SQLITE_UTF16 i
120f0 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 s not used inter
12100 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e nally.. */. en
12110 63 32 20 3d 20 65 6e 63 3b 0a 20 20 74 65 73 74 c2 = enc;. test
12120 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 case( enc2==SQLI
12130 54 45 5f 55 54 46 31 36 20 29 3b 0a 20 20 74 65 TE_UTF16 );. te
12140 73 74 63 61 73 65 28 20 65 6e 63 32 3d 3d 53 51 stcase( enc2==SQ
12150 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e LITE_UTF16_ALIGN
12160 45 44 20 29 3b 0a 20 20 69 66 28 20 65 6e 63 32 ED );. if( enc2
12170 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 7c ==SQLITE_UTF16 |
12180 7c 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 | enc2==SQLITE_U
12190 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 7b 0a TF16_ALIGNED ){.
121a0 20 20 20 20 65 6e 63 32 20 3d 20 53 51 4c 49 54 enc2 = SQLIT
121b0 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 E_UTF16NATIVE;.
121c0 20 7d 0a 20 20 69 66 28 20 65 6e 63 32 3c 53 51 }. if( enc2<SQ
121d0 4c 49 54 45 5f 55 54 46 38 20 7c 7c 20 65 6e 63 LITE_UTF8 || enc
121e0 32 3e 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2>SQLITE_UTF16BE
121f0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
12200 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
12210 54 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 T;. }.. /* Che
12220 63 6b 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 ck if this call
12230 69 73 20 72 65 6d 6f 76 69 6e 67 20 6f 72 20 72 is removing or r
12240 65 70 6c 61 63 69 6e 67 20 61 6e 20 65 78 69 73 eplacing an exis
12250 74 69 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a ting collation .
12260 20 20 2a 2a 20 73 65 71 75 65 6e 63 65 2e 20 49 ** sequence. I
12270 66 20 73 6f 2c 20 61 6e 64 20 74 68 65 72 65 20 f so, and there
12280 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c 20 are active VMs,
12290 72 65 74 75 72 6e 20 62 75 73 79 2e 20 49 66 20 return busy. If
122a0 74 68 65 72 65 0a 20 20 2a 2a 20 61 72 65 20 6e there. ** are n
122b0 6f 20 61 63 74 69 76 65 20 56 4d 73 2c 20 69 6e o active VMs, in
122c0 76 61 6c 69 64 61 74 65 20 61 6e 79 20 70 72 65 validate any pre
122d0 2d 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 6d -compiled statem
122e0 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 43 6f ents.. */. pCo
122f0 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 ll = sqlite3Find
12300 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 CollSeq(db, (u8)
12310 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 30 29 3b enc2, zName, 0);
12320 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 26 26 20 . if( pColl &&
12330 70 43 6f 6c 6c 2d 3e 78 43 6d 70 20 29 7b 0a 20 pColl->xCmp ){.
12340 20 20 20 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 if( db->nVdbe
12350 41 63 74 69 76 65 20 29 7b 0a 20 20 20 20 20 20 Active ){.
12360 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 sqlite3ErrorWith
12370 4d 73 67 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 Msg(db, SQLITE_B
12380 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 USY, . "u
12390 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f nable to delete/
123a0 6d 6f 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f 6e modify collation
123b0 20 73 65 71 75 65 6e 63 65 20 64 75 65 20 74 6f sequence due to
123c0 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e active statemen
123d0 74 73 22 29 3b 0a 20 20 20 20 20 20 72 65 74 75 ts");. retu
123e0 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a rn SQLITE_BUSY;.
123f0 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
12400 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64 53 3ExpirePreparedS
12410 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a 0a tatements(db);..
12420 20 20 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 74 /* If collat
12430 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 70 43 6f ion sequence pCo
12440 6c 6c 20 77 61 73 20 63 72 65 61 74 65 64 20 64 ll was created d
12450 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 61 6c irectly by a cal
12460 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 l to. ** sqli
12470 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 te3_create_colla
12480 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 65 tion, and not ge
12490 6e 65 72 61 74 65 64 20 62 79 20 73 79 6e 74 68 nerated by synth
124a0 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 2a CollSeq(),. *
124b0 2a 20 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 65 * then any copie
124c0 73 20 6d 61 64 65 20 62 79 20 73 79 6e 74 68 43 s made by synthC
124d0 6f 6c 6c 53 65 71 28 29 20 6e 65 65 64 20 74 6f ollSeq() need to
124e0 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 2e be invalidated.
124f0 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 6f . ** Also, co
12500 6c 6c 61 74 69 6f 6e 20 64 65 73 74 72 75 63 74 llation destruct
12510 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 65 or - CollSeq.xDe
12520 6c 28 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 6d l() - function m
12530 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 74 ay need. ** t
12540 6f 20 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 20 o be called..
12550 20 2a 2f 20 0a 20 20 20 20 69 66 28 20 28 70 43 */ . if( (pC
12560 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c 49 oll->enc & ~SQLI
12570 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 TE_UTF16_ALIGNED
12580 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 20 )==enc2 ){.
12590 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 20 CollSeq *aColl
125a0 3d 20 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e = sqlite3HashFin
125b0 64 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c d(&db->aCollSeq,
125c0 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 zName);. i
125d0 6e 74 20 6a 3b 0a 20 20 20 20 20 20 66 6f 72 28 nt j;. for(
125e0 6a 3d 30 3b 20 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a j=0; j<3; j++){.
125f0 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 CollSeq
12600 2a 70 20 3d 20 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a *p = &aColl[j];.
12610 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 if( p->e
12620 6e 63 3d 3d 70 43 6f 6c 6c 2d 3e 65 6e 63 20 29 nc==pColl->enc )
12630 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 {. if(
12640 70 2d 3e 78 44 65 6c 20 29 7b 0a 20 20 20 20 20 p->xDel ){.
12650 20 20 20 20 20 20 20 70 2d 3e 78 44 65 6c 28 70 p->xDel(p
12660 2d 3e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 20 ->pUser);.
12670 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
12680 70 2d 3e 78 43 6d 70 20 3d 20 30 3b 0a 20 20 20 p->xCmp = 0;.
12690 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
126a0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 43 6f 6c }. }.. pCol
126b0 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
126c0 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 38 29 65 ollSeq(db, (u8)e
126d0 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 31 29 3b 0a nc2, zName, 1);.
126e0 20 20 69 66 28 20 70 43 6f 6c 6c 3d 3d 30 20 29 if( pColl==0 )
126f0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
12700 4f 4d 45 4d 3b 0a 20 20 70 43 6f 6c 6c 2d 3e 78 OMEM;. pColl->x
12710 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a Cmp = xCompare;.
12720 20 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d pColl->pUser =
12730 20 70 43 74 78 3b 0a 20 20 70 43 6f 6c 6c 2d 3e pCtx;. pColl->
12740 78 44 65 6c 20 3d 20 78 44 65 6c 3b 0a 20 20 70 xDel = xDel;. p
12750 43 6f 6c 6c 2d 3e 65 6e 63 20 3d 20 28 75 38 29 Coll->enc = (u8)
12760 28 65 6e 63 32 20 7c 20 28 65 6e 63 20 26 20 53 (enc2 | (enc & S
12770 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 QLITE_UTF16_ALIG
12780 4e 45 44 29 29 3b 0a 20 20 73 71 6c 69 74 65 33 NED));. sqlite3
12790 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 Error(db, SQLITE
127a0 5f 4f 4b 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 _OK);. return S
127b0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a QLITE_OK;.}.../*
127c0 0a 2a 2a 20 54 68 69 73 20 61 72 72 61 79 20 64 .** This array d
127d0 65 66 69 6e 65 73 20 68 61 72 64 20 75 70 70 65 efines hard uppe
127e0 72 20 62 6f 75 6e 64 73 20 6f 6e 20 6c 69 6d 69 r bounds on limi
127f0 74 20 76 61 6c 75 65 73 2e 20 20 54 68 65 0a 2a t values. The.*
12800 2a 20 69 6e 69 74 69 61 6c 69 7a 65 72 20 6d 75 * initializer mu
12810 73 74 20 62 65 20 6b 65 70 74 20 69 6e 20 73 79 st be kept in sy
12820 6e 63 20 77 69 74 68 20 74 68 65 20 53 51 4c 49 nc with the SQLI
12830 54 45 5f 4c 49 4d 49 54 5f 2a 0a 2a 2a 20 23 64 TE_LIMIT_*.** #d
12840 65 66 69 6e 65 73 20 69 6e 20 73 71 6c 69 74 65 efines in sqlite
12850 33 2e 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 3.h..*/.static c
12860 6f 6e 73 74 20 69 6e 74 20 61 48 61 72 64 4c 69 onst int aHardLi
12870 6d 69 74 5b 5d 20 3d 20 7b 0a 20 20 53 51 4c 49 mit[] = {. SQLI
12880 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 2c 0a 20 TE_MAX_LENGTH,.
12890 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f SQLITE_MAX_SQL_
128a0 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 LENGTH,. SQLITE
128b0 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 2c 0a 20 20 53 _MAX_COLUMN,. S
128c0 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 QLITE_MAX_EXPR_D
128d0 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d EPTH,. SQLITE_M
128e0 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 AX_COMPOUND_SELE
128f0 43 54 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 CT,. SQLITE_MAX
12900 5f 56 44 42 45 5f 4f 50 2c 0a 20 20 53 51 4c 49 _VDBE_OP,. SQLI
12910 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f TE_MAX_FUNCTION_
12920 41 52 47 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 ARG,. SQLITE_MA
12930 58 5f 41 54 54 41 43 48 45 44 2c 0a 20 20 53 51 X_ATTACHED,. SQ
12940 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 LITE_MAX_LIKE_PA
12950 54 54 45 52 4e 5f 4c 45 4e 47 54 48 2c 0a 20 20 TTERN_LENGTH,.
12960 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
12970 42 4c 45 5f 4e 55 4d 42 45 52 2c 20 20 20 20 20 BLE_NUMBER,
12980 20 2f 2a 20 49 4d 50 3a 20 52 2d 33 38 30 39 31 /* IMP: R-38091
12990 2d 33 32 33 35 32 20 2a 2f 0a 20 20 53 51 4c 49 -32352 */. SQLI
129a0 54 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 TE_MAX_TRIGGER_D
129b0 45 50 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d EPTH,. SQLITE_M
129c0 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 AX_WORKER_THREAD
129d0 53 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b S,.};../*.** Mak
129e0 65 20 73 75 72 65 20 74 68 65 20 68 61 72 64 20 e sure the hard
129f0 6c 69 6d 69 74 73 20 61 72 65 20 73 65 74 20 74 limits are set t
12a00 6f 20 72 65 61 73 6f 6e 61 62 6c 65 20 76 61 6c o reasonable val
12a10 75 65 73 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 ues.*/.#if SQLIT
12a20 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 3c 31 30 30 E_MAX_LENGTH<100
12a30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
12a40 4d 41 58 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 MAX_LENGTH must
12a50 62 65 20 61 74 20 6c 65 61 73 74 20 31 30 30 0a be at least 100.
12a60 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
12a70 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 E_MAX_SQL_LENGTH
12a80 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 51 4c <100.# error SQL
12a90 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
12aa0 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 TH must be at le
12ab0 61 73 74 20 31 30 30 0a 23 65 6e 64 69 66 0a 23 ast 100.#endif.#
12ac0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 if SQLITE_MAX_SQ
12ad0 4c 5f 4c 45 4e 47 54 48 3e 53 51 4c 49 54 45 5f L_LENGTH>SQLITE_
12ae0 4d 41 58 5f 4c 45 4e 47 54 48 0a 23 20 65 72 72 MAX_LENGTH.# err
12af0 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 or SQLITE_MAX_SQ
12b00 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 6e 6f L_LENGTH must no
12b10 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 61 t be greater tha
12b20 6e 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e n SQLITE_MAX_LEN
12b30 47 54 48 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 GTH.#endif.#if S
12b40 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 QLITE_MAX_COMPOU
12b50 4e 44 5f 53 45 4c 45 43 54 3c 32 0a 23 20 65 72 ND_SELECT<2.# er
12b60 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ror SQLITE_MAX_C
12b70 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 20 6d OMPOUND_SELECT m
12b80 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 ust be at least
12b90 32 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 2.#endif.#if SQL
12ba0 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 3c ITE_MAX_VDBE_OP<
12bb0 34 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 40.# error SQLIT
12bc0 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 20 6d 75 E_MAX_VDBE_OP mu
12bd0 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 34 st be at least 4
12be0 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 0.#endif.#if SQL
12bf0 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e ITE_MAX_FUNCTION
12c00 5f 41 52 47 3c 30 20 7c 7c 20 53 51 4c 49 54 45 _ARG<0 || SQLITE
12c10 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 _MAX_FUNCTION_AR
12c20 47 3e 31 30 30 30 0a 23 20 65 72 72 6f 72 20 53 G>1000.# error S
12c30 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 QLITE_MAX_FUNCTI
12c40 4f 4e 5f 41 52 47 20 6d 75 73 74 20 62 65 20 62 ON_ARG must be b
12c50 65 74 77 65 65 6e 20 30 20 61 6e 64 20 31 30 30 etween 0 and 100
12c60 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 0.#endif.#if SQL
12c70 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
12c80 3c 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 <0 || SQLITE_MAX
12c90 5f 41 54 54 41 43 48 45 44 3e 31 32 35 0a 23 20 _ATTACHED>125.#
12ca0 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
12cb0 5f 41 54 54 41 43 48 45 44 20 6d 75 73 74 20 62 _ATTACHED must b
12cc0 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 e between 0 and
12cd0 31 32 35 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 125.#endif.#if S
12ce0 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 QLITE_MAX_LIKE_P
12cf0 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 3c 31 0a ATTERN_LENGTH<1.
12d00 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d # error SQLITE_M
12d10 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f AX_LIKE_PATTERN_
12d20 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 61 LENGTH must be a
12d30 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 66 t least 1.#endif
12d40 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
12d50 43 4f 4c 55 4d 4e 3e 33 32 37 36 37 0a 23 20 65 COLUMN>32767.# e
12d60 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f rror SQLITE_MAX_
12d70 43 4f 4c 55 4d 4e 20 6d 75 73 74 20 6e 6f 74 20 COLUMN must not
12d80 65 78 63 65 65 64 20 33 32 37 36 37 0a 23 65 6e exceed 32767.#en
12d90 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d dif.#if SQLITE_M
12da0 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 AX_TRIGGER_DEPTH
12db0 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 <1.# error SQLIT
12dc0 45 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 E_MAX_TRIGGER_DE
12dd0 50 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c PTH must be at l
12de0 65 61 73 74 20 31 0a 23 65 6e 64 69 66 0a 23 69 east 1.#endif.#i
12df0 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 f SQLITE_MAX_WOR
12e00 4b 45 52 5f 54 48 52 45 41 44 53 3c 30 20 7c 7c KER_THREADS<0 ||
12e10 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b SQLITE_MAX_WORK
12e20 45 52 5f 54 48 52 45 41 44 53 3e 35 30 0a 23 20 ER_THREADS>50.#
12e30 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
12e40 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 _WORKER_THREADS
12e50 6d 75 73 74 20 62 65 20 62 65 74 77 65 65 6e 20 must be between
12e60 30 20 61 6e 64 20 35 30 0a 23 65 6e 64 69 66 0a 0 and 50.#endif.
12e70 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 ../*.** Change t
12e80 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 6c 69 he value of a li
12e90 6d 69 74 2e 20 20 52 65 70 6f 72 74 20 74 68 65 mit. Report the
12ea0 20 6f 6c 64 20 76 61 6c 75 65 2e 0a 2a 2a 20 49 old value..** I
12eb0 66 20 61 6e 20 69 6e 76 61 6c 69 64 20 6c 69 6d f an invalid lim
12ec0 69 74 20 69 6e 64 65 78 20 69 73 20 73 75 70 70 it index is supp
12ed0 6c 69 65 64 2c 20 72 65 70 6f 72 74 20 2d 31 2e lied, report -1.
12ee0 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 6e .** Make no chan
12ef0 67 65 73 20 62 75 74 20 73 74 69 6c 6c 20 72 65 ges but still re
12f00 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 76 61 6c port the old val
12f10 75 65 20 69 66 20 74 68 65 0a 2a 2a 20 6e 65 77 ue if the.** new
12f20 20 6c 69 6d 69 74 20 69 73 20 6e 65 67 61 74 69 limit is negati
12f30 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 77 20 ve..**.** A new
12f40 6c 6f 77 65 72 20 6c 69 6d 69 74 20 64 6f 65 73 lower limit does
12f50 20 6e 6f 74 20 73 68 72 69 6e 6b 20 65 78 69 73 not shrink exis
12f60 74 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 73 2e ting constructs.
12f70 0a 2a 2a 20 49 74 20 6d 65 72 65 6c 79 20 70 72 .** It merely pr
12f80 65 76 65 6e 74 73 20 6e 65 77 20 63 6f 6e 73 74 events new const
12f90 72 75 63 74 73 20 74 68 61 74 20 65 78 63 65 65 ructs that excee
12fa0 64 20 74 68 65 20 6c 69 6d 69 74 0a 2a 2a 20 66 d the limit.** f
12fb0 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e 0a 2a 2f 0a rom forming..*/.
12fc0 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 69 6d 69 int sqlite3_limi
12fd0 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 t(sqlite3 *db, i
12fe0 6e 74 20 6c 69 6d 69 74 49 64 2c 20 69 6e 74 20 nt limitId, int
12ff0 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 20 69 6e 74 newLimit){. int
13000 20 6f 6c 64 4c 69 6d 69 74 3b 0a 0a 23 69 66 64 oldLimit;..#ifd
13010 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
13020 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
13030 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
13040 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
13050 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
13060 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
13070 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 return -1;. }.#
13080 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 45 56 49 44 endif.. /* EVID
13090 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 30 31 38 39 ENCE-OF: R-30189
130a0 2d 35 34 30 39 37 20 46 6f 72 20 65 61 63 68 20 -54097 For each
130b0 6c 69 6d 69 74 20 63 61 74 65 67 6f 72 79 20 53 limit category S
130c0 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4e 41 4d 45 QLITE_LIMIT_NAME
130d0 0a 20 20 2a 2a 20 74 68 65 72 65 20 69 73 20 61 . ** there is a
130e0 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75 6e hard upper boun
130f0 64 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65 d set at compile
13100 2d 74 69 6d 65 20 62 79 20 61 20 43 20 70 72 65 -time by a C pre
13110 70 72 6f 63 65 73 73 6f 72 0a 20 20 2a 2a 20 6d processor. ** m
13120 61 63 72 6f 20 63 61 6c 6c 65 64 20 53 51 4c 49 acro called SQLI
13130 54 45 5f 4d 41 58 5f 4e 41 4d 45 2e 20 28 54 68 TE_MAX_NAME. (Th
13140 65 20 22 5f 4c 49 4d 49 54 5f 22 20 69 6e 20 74 e "_LIMIT_" in t
13150 68 65 20 6e 61 6d 65 20 69 73 20 63 68 61 6e 67 he name is chang
13160 65 64 20 74 6f 0a 20 20 2a 2a 20 22 5f 4d 41 58 ed to. ** "_MAX
13170 5f 22 2e 29 0a 20 20 2a 2f 0a 20 20 61 73 73 65 _".). */. asse
13180 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
13190 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 QLITE_LIMIT_LENG
131a0 54 48 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 5f TH]==SQLITE_MAX_
131b0 4c 45 4e 47 54 48 20 29 3b 0a 20 20 61 73 73 65 LENGTH );. asse
131c0 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
131d0 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 53 51 4c 5f QLITE_LIMIT_SQL_
131e0 4c 45 4e 47 54 48 5d 3d 3d 53 51 4c 49 54 45 5f LENGTH]==SQLITE_
131f0 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 29 MAX_SQL_LENGTH )
13200 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
13210 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
13220 4d 49 54 5f 43 4f 4c 55 4d 4e 5d 3d 3d 53 51 4c MIT_COLUMN]==SQL
13230 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 20 29 ITE_MAX_COLUMN )
13240 3b 0a 20 20 61 73 73 65 72 74 28 20 61 48 61 72 ;. assert( aHar
13250 64 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 dLimit[SQLITE_LI
13260 4d 49 54 5f 45 58 50 52 5f 44 45 50 54 48 5d 3d MIT_EXPR_DEPTH]=
13270 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 =SQLITE_MAX_EXPR
13280 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 65 _DEPTH );. asse
13290 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 rt( aHardLimit[S
132a0 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 43 4f 4d 50 QLITE_LIMIT_COMP
132b0 4f 55 4e 44 5f 53 45 4c 45 43 54 5d 3d 3d 53 51 OUND_SELECT]==SQ
132c0 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e LITE_MAX_COMPOUN
132d0 44 5f 53 45 4c 45 43 54 29 3b 0a 20 20 61 73 73 D_SELECT);. ass
132e0 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b ert( aHardLimit[
132f0 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 56 44 42 SQLITE_LIMIT_VDB
13300 45 5f 4f 50 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 E_OP]==SQLITE_MA
13310 58 5f 56 44 42 45 5f 4f 50 20 29 3b 0a 20 20 61 X_VDBE_OP );. a
13320 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
13330 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 46 t[SQLITE_LIMIT_F
13340 55 4e 43 54 49 4f 4e 5f 41 52 47 5d 3d 3d 53 51 UNCTION_ARG]==SQ
13350 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f LITE_MAX_FUNCTIO
13360 4e 5f 41 52 47 20 29 3b 0a 20 20 61 73 73 65 72 N_ARG );. asser
13370 74 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 t( aHardLimit[SQ
13380 4c 49 54 45 5f 4c 49 4d 49 54 5f 41 54 54 41 43 LITE_LIMIT_ATTAC
13390 48 45 44 5d 3d 3d 53 51 4c 49 54 45 5f 4d 41 58 HED]==SQLITE_MAX
133a0 5f 41 54 54 41 43 48 45 44 20 29 3b 0a 20 20 61 _ATTACHED );. a
133b0 73 73 65 72 74 28 20 61 48 61 72 64 4c 69 6d 69 ssert( aHardLimi
133c0 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c t[SQLITE_LIMIT_L
133d0 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 IKE_PATTERN_LENG
133e0 54 48 5d 3d 3d 0a 20 20 20 20 20 20 20 20 20 20 TH]==.
133f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13400 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13410 20 20 20 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f SQLITE_MAX_
13420 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e LIKE_PATTERN_LEN
13430 47 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 GTH );. assert(
13440 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 aHardLimit[SQLI
13450 54 45 5f 4c 49 4d 49 54 5f 56 41 52 49 41 42 4c TE_LIMIT_VARIABL
13460 45 5f 4e 55 4d 42 45 52 5d 3d 3d 53 51 4c 49 54 E_NUMBER]==SQLIT
13470 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e E_MAX_VARIABLE_N
13480 55 4d 42 45 52 29 3b 0a 20 20 61 73 73 65 72 74 UMBER);. assert
13490 28 20 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c ( aHardLimit[SQL
134a0 49 54 45 5f 4c 49 4d 49 54 5f 54 52 49 47 47 45 ITE_LIMIT_TRIGGE
134b0 52 5f 44 45 50 54 48 5d 3d 3d 53 51 4c 49 54 45 R_DEPTH]==SQLITE
134c0 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 _MAX_TRIGGER_DEP
134d0 54 48 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TH );. assert(
134e0 61 48 61 72 64 4c 69 6d 69 74 5b 53 51 4c 49 54 aHardLimit[SQLIT
134f0 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 E_LIMIT_WORKER_T
13500 48 52 45 41 44 53 5d 3d 3d 53 51 4c 49 54 45 5f HREADS]==SQLITE_
13510 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 MAX_WORKER_THREA
13520 44 53 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 DS );. assert(
13530 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 SQLITE_LIMIT_WOR
13540 4b 45 52 5f 54 48 52 45 41 44 53 3d 3d 28 53 51 KER_THREADS==(SQ
13550 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 2d 31 29 20 LITE_N_LIMIT-1)
13560 29 3b 0a 0a 0a 20 20 69 66 28 20 6c 69 6d 69 74 );... if( limit
13570 49 64 3c 30 20 7c 7c 20 6c 69 6d 69 74 49 64 3e Id<0 || limitId>
13580 3d 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 =SQLITE_N_LIMIT
13590 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 2d 31 ){. return -1
135a0 3b 0a 20 20 7d 0a 20 20 6f 6c 64 4c 69 6d 69 74 ;. }. oldLimit
135b0 20 3d 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 = db->aLimit[li
135c0 6d 69 74 49 64 5d 3b 0a 20 20 69 66 28 20 6e 65 mitId];. if( ne
135d0 77 4c 69 6d 69 74 3e 3d 30 20 29 7b 20 20 20 20 wLimit>=0 ){
135e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
135f0 2a 20 49 4d 50 3a 20 52 2d 35 32 34 37 36 2d 32 * IMP: R-52476-2
13600 38 37 33 32 20 2a 2f 0a 20 20 20 20 69 66 28 20 8732 */. if(
13610 6e 65 77 4c 69 6d 69 74 3e 61 48 61 72 64 4c 69 newLimit>aHardLi
13620 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 20 29 7b 0a mit[limitId] ){.
13630 20 20 20 20 20 20 6e 65 77 4c 69 6d 69 74 20 3d newLimit =
13640 20 61 48 61 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 aHardLimit[limi
13650 74 49 64 5d 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 tId]; /* IMP: R
13660 2d 35 31 34 36 33 2d 32 35 36 33 34 20 2a 2f 0a -51463-25634 */.
13670 20 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e 61 4c }. db->aL
13680 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 20 3d 20 imit[limitId] =
13690 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 7d 0a 20 20 newLimit;. }.
136a0 72 65 74 75 72 6e 20 6f 6c 64 4c 69 6d 69 74 3b return oldLimit;
136b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
136c0 20 20 20 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 /* IMP: R-5
136d0 33 33 34 31 2d 33 35 34 31 39 20 2a 2f 0a 7d 0a 3341-35419 */.}.
136e0 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
136f0 54 45 5f 45 4e 41 42 4c 45 5f 41 55 54 4f 5f 50 TE_ENABLE_AUTO_P
13700 52 4f 46 49 4c 45 29 0a 2f 2a 20 73 74 64 65 72 ROFILE)./* stder
13710 72 20 6c 6f 67 67 69 6e 67 20 2a 2f 0a 76 6f 69 r logging */.voi
13720 64 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f 70 d _sqlite_auto_p
13730 72 6f 66 69 6c 65 28 76 6f 69 64 20 2a 61 75 78 rofile(void *aux
13740 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 , const char *sq
13750 6c 2c 20 75 36 34 20 6e 73 29 3b 0a 76 6f 69 64 l, u64 ns);.void
13760 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f 74 72 _sqlite_auto_tr
13770 61 63 65 28 76 6f 69 64 20 2a 61 75 78 2c 20 63 ace(void *aux, c
13780 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 29 3b onst char *sql);
13790 0a 76 6f 69 64 20 5f 73 71 6c 69 74 65 5f 61 75 .void _sqlite_au
137a0 74 6f 5f 70 72 6f 66 69 6c 65 28 76 6f 69 64 20 to_profile(void
137b0 2a 61 75 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 *aux, const char
137c0 20 2a 73 71 6c 2c 20 75 36 34 20 6e 73 29 20 7b *sql, u64 ns) {
137d0 0a 23 70 72 61 67 6d 61 20 75 6e 75 73 65 64 28 .#pragma unused(
137e0 61 75 78 29 0a 09 66 70 72 69 6e 74 66 28 73 74 aux)..fprintf(st
137f0 64 65 72 72 2c 20 22 51 75 65 72 79 3a 20 25 73 derr, "Query: %s
13800 5c 6e 20 45 78 65 63 75 74 69 6f 6e 20 54 69 6d \n Execution Tim
13810 65 3a 20 25 6c 6c 75 20 6d 73 5c 6e 22 2c 20 73 e: %llu ms\n", s
13820 71 6c 2c 20 6e 73 20 2f 20 31 30 30 30 30 30 30 ql, ns / 1000000
13830 29 3b 0a 7d 0a 76 6f 69 64 20 5f 73 71 6c 69 74 );.}.void _sqlit
13840 65 5f 61 75 74 6f 5f 74 72 61 63 65 28 76 6f 69 e_auto_trace(voi
13850 64 20 2a 61 75 78 2c 20 63 6f 6e 73 74 20 63 68 d *aux, const ch
13860 61 72 20 2a 73 71 6c 29 20 7b 0a 09 66 70 72 69 ar *sql) {..fpri
13870 6e 74 66 28 73 74 64 65 72 72 2c 20 22 54 72 61 ntf(stderr, "Tra
13880 63 65 53 51 4c 28 25 70 29 3a 20 25 73 5c 6e 22 ceSQL(%p): %s\n"
13890 2c 20 61 75 78 2c 20 73 71 6c 29 3b 0a 7d 0a 0a , aux, sql);.}..
138a0 2f 2a 20 73 79 73 6c 6f 67 20 6c 6f 67 67 69 6e /* syslog loggin
138b0 67 20 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c 61 g */.#include <a
138c0 73 6c 2e 68 3e 0a 73 74 61 74 69 63 20 61 73 6c sl.h>.static asl
138d0 63 6c 69 65 6e 74 20 61 75 74 6f 6c 6f 67 5f 63 client autolog_c
138e0 6c 69 65 6e 74 20 3d 20 4e 55 4c 4c 3b 0a 73 74 lient = NULL;.st
138f0 61 74 69 63 20 76 6f 69 64 20 5f 63 6c 6f 73 65 atic void _close
13900 5f 61 73 6c 5f 6c 6f 67 28 29 20 7b 0a 20 20 69 _asl_log() {. i
13910 66 28 20 4e 55 4c 4c 21 3d 61 75 74 6f 6c 6f 67 f( NULL!=autolog
13920 5f 63 6c 69 65 6e 74 20 29 7b 0a 20 20 20 20 61 _client ){. a
13930 73 6c 5f 63 6c 6f 73 65 28 61 75 74 6f 6c 6f 67 sl_close(autolog
13940 5f 63 6c 69 65 6e 74 29 3b 0a 20 20 20 20 61 75 _client);. au
13950 74 6f 6c 6f 67 5f 63 6c 69 65 6e 74 20 3d 20 4e tolog_client = N
13960 55 4c 4c 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 ULL;. }.}.stati
13970 63 20 76 6f 69 64 20 5f 6f 70 65 6e 5f 61 73 6c c void _open_asl
13980 5f 6c 6f 67 28 29 20 7b 0a 20 20 69 66 28 20 4e _log() {. if( N
13990 55 4c 4c 3d 3d 61 75 74 6f 6c 6f 67 5f 63 6c 69 ULL==autolog_cli
139a0 65 6e 74 20 29 7b 0a 20 20 20 20 61 75 74 6f 6c ent ){. autol
139b0 6f 67 5f 63 6c 69 65 6e 74 20 3d 20 61 73 6c 5f og_client = asl_
139c0 6f 70 65 6e 28 22 53 51 4c 69 74 65 22 2c 20 4e open("SQLite", N
139d0 55 4c 4c 2c 20 30 29 3b 0a 20 20 20 20 61 74 65 ULL, 0);. ate
139e0 78 69 74 28 5f 63 6c 6f 73 65 5f 61 73 6c 5f 6c xit(_close_asl_l
139f0 6f 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 76 6f 69 64 og);. }.}..void
13a00 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f 70 72 _sqlite_auto_pr
13a10 6f 66 69 6c 65 5f 73 79 73 6c 6f 67 28 76 6f 69 ofile_syslog(voi
13a20 64 20 2a 61 75 78 2c 20 63 6f 6e 73 74 20 63 68 d *aux, const ch
13a30 61 72 20 2a 73 71 6c 2c 20 75 36 34 20 6e 73 29 ar *sql, u64 ns)
13a40 3b 0a 76 6f 69 64 20 5f 73 71 6c 69 74 65 5f 61 ;.void _sqlite_a
13a50 75 74 6f 5f 74 72 61 63 65 5f 73 79 73 6c 6f 67 uto_trace_syslog
13a60 28 76 6f 69 64 20 2a 61 75 78 2c 20 63 6f 6e 73 (void *aux, cons
13a70 74 20 63 68 61 72 20 2a 73 71 6c 29 3b 0a 76 6f t char *sql);.vo
13a80 69 64 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f id _sqlite_auto_
13a90 70 72 6f 66 69 6c 65 5f 73 79 73 6c 6f 67 28 76 profile_syslog(v
13aa0 6f 69 64 20 2a 61 75 78 2c 20 63 6f 6e 73 74 20 oid *aux, const
13ab0 63 68 61 72 20 2a 73 71 6c 2c 20 75 36 34 20 6e char *sql, u64 n
13ac0 73 29 20 7b 0a 23 70 72 61 67 6d 61 20 75 6e 75 s) {.#pragma unu
13ad0 73 65 64 28 61 75 78 29 0a 09 61 73 6c 5f 6c 6f sed(aux)..asl_lo
13ae0 67 28 61 75 74 6f 6c 6f 67 5f 63 6c 69 65 6e 74 g(autolog_client
13af0 2c 20 4e 55 4c 4c 2c 20 41 53 4c 5f 4c 45 56 45 , NULL, ASL_LEVE
13b00 4c 5f 4e 4f 54 49 43 45 2c 20 22 51 75 65 72 79 L_NOTICE, "Query
13b10 3a 20 25 73 5c 6e 20 45 78 65 63 75 74 69 6f 6e : %s\n Execution
13b20 20 54 69 6d 65 3a 20 25 6c 6c 75 20 6d 73 5c 6e Time: %llu ms\n
13b30 22 2c 20 73 71 6c 2c 20 6e 73 20 2f 20 31 30 30 ", sql, ns / 100
13b40 30 30 30 30 29 3b 0a 7d 0a 76 6f 69 64 20 5f 73 0000);.}.void _s
13b50 71 6c 69 74 65 5f 61 75 74 6f 5f 74 72 61 63 65 qlite_auto_trace
13b60 5f 73 79 73 6c 6f 67 28 76 6f 69 64 20 2a 61 75 _syslog(void *au
13b70 78 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 x, const char *s
13b80 71 6c 29 20 7b 0a 09 61 73 6c 5f 6c 6f 67 28 61 ql) {..asl_log(a
13b90 75 74 6f 6c 6f 67 5f 63 6c 69 65 6e 74 2c 20 4e utolog_client, N
13ba0 55 4c 4c 2c 20 41 53 4c 5f 4c 45 56 45 4c 5f 4e ULL, ASL_LEVEL_N
13bb0 4f 54 49 43 45 2c 20 22 54 72 61 63 65 53 51 4c OTICE, "TraceSQL
13bc0 28 25 70 29 3a 20 25 73 5c 6e 22 2c 20 61 75 78 (%p): %s\n", aux
13bd0 2c 20 73 71 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 , sql);.}.#endif
13be0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
13bf0 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
13c00 20 70 61 72 73 65 20 62 6f 74 68 20 55 52 49 73 parse both URIs
13c10 20 61 6e 64 20 6e 6f 6e 2d 55 52 49 20 66 69 6c and non-URI fil
13c20 65 6e 61 6d 65 73 20 70 61 73 73 65 64 20 62 79 enames passed by
13c30 20 74 68 65 0a 2a 2a 20 75 73 65 72 20 74 6f 20 the.** user to
13c40 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 73 71 API functions sq
13c50 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 6f 72 20 lite3_open() or
13c60 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 sqlite3_open_v2(
13c70 29 2c 20 61 6e 64 20 66 6f 72 20 64 61 74 61 62 ), and for datab
13c80 61 73 65 0a 2a 2a 20 55 52 49 73 20 73 70 65 63 ase.** URIs spec
13c90 69 66 69 65 64 20 61 73 20 70 61 72 74 20 6f 66 ified as part of
13ca0 20 41 54 54 41 43 48 20 73 74 61 74 65 6d 65 6e ATTACH statemen
13cb0 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 ts..**.** The fi
13cc0 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 rst argument to
13cd0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
13ce0 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
13cf0 20 56 46 53 20 74 6f 20 75 73 65 20 28 6f 72 0a VFS to use (or.
13d00 2a 2a 20 61 20 4e 55 4c 4c 20 74 6f 20 73 69 67 ** a NULL to sig
13d10 6e 69 66 79 20 74 68 65 20 64 65 66 61 75 6c 74 nify the default
13d20 20 56 46 53 29 20 69 66 20 74 68 65 20 55 52 49 VFS) if the URI
13d30 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 74 61 69 does not contai
13d40 6e 20 61 20 22 76 66 73 3d 78 78 78 22 0a 2a 2a n a "vfs=xxx".**
13d50 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 query parameter
13d60 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 67 . The second arg
13d70 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 74 ument contains t
13d80 68 65 20 55 52 49 20 28 6f 72 20 6e 6f 6e 2d 55 he URI (or non-U
13d90 52 49 20 66 69 6c 65 6e 61 6d 65 29 0a 2a 2a 20 RI filename).**
13da0 69 74 73 65 6c 66 2e 20 57 68 65 6e 20 74 68 69 itself. When thi
13db0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
13dc0 6c 6c 65 64 20 74 68 65 20 2a 70 46 6c 61 67 73 lled the *pFlags
13dd0 20 76 61 72 69 61 62 6c 65 20 73 68 6f 75 6c 64 variable should
13de0 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 74 68 65 20 contain.** the
13df0 64 65 66 61 75 6c 74 20 66 6c 61 67 73 20 74 6f default flags to
13e00 20 6f 70 65 6e 20 74 68 65 20 64 61 74 61 62 61 open the databa
13e10 73 65 20 68 61 6e 64 6c 65 20 77 69 74 68 2e 20 se handle with.
13e20 54 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 The value stored
13e30 20 69 6e 0a 2a 2a 20 2a 70 46 6c 61 67 73 20 6d in.** *pFlags m
13e40 61 79 20 62 65 20 75 70 64 61 74 65 64 20 62 65 ay be updated be
13e50 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 69 fore returning i
13e60 66 20 74 68 65 20 55 52 49 20 66 69 6c 65 6e 61 f the URI filena
13e70 6d 65 20 63 6f 6e 74 61 69 6e 73 20 0a 2a 2a 20 me contains .**
13e80 22 63 61 63 68 65 3d 78 78 78 22 20 6f 72 20 22 "cache=xxx" or "
13e90 6d 6f 64 65 3d 78 78 78 22 20 71 75 65 72 79 20 mode=xxx" query
13ea0 70 61 72 61 6d 65 74 65 72 73 2e 0a 2a 2a 0a 2a parameters..**.*
13eb0 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c * If successful,
13ec0 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
13ed0 74 75 72 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 turned. In this
13ee0 63 61 73 65 20 2a 70 70 56 66 73 20 69 73 20 73 case *ppVfs is s
13ef0 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 0a 2a et to point to.*
13f00 2a 20 74 68 65 20 56 46 53 20 74 68 61 74 20 73 * the VFS that s
13f10 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 74 6f hould be used to
13f20 20 6f 70 65 6e 20 74 68 65 20 64 61 74 61 62 61 open the databa
13f30 73 65 20 66 69 6c 65 2e 20 2a 70 7a 46 69 6c 65 se file. *pzFile
13f40 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 70 6f is set to.** po
13f50 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 int to a buffer
13f60 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e containing the n
13f70 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 ame of the file
13f80 74 6f 20 6f 70 65 6e 2e 20 49 74 20 69 73 20 74 to open. It is t
13f90 68 65 20 0a 2a 2a 20 72 65 73 70 6f 6e 73 69 62 he .** responsib
13fa0 69 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c ility of the cal
13fb0 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c ler to eventuall
13fc0 79 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 66 y call sqlite3_f
13fd0 72 65 65 28 29 20 74 6f 20 72 65 6c 65 61 73 65 ree() to release
13fe0 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 65 72 2e .** this buffer.
13ff0 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 .**.** If an err
14000 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 or occurs, then
14010 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
14020 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
14030 20 61 6e 64 20 2a 70 7a 45 72 72 4d 73 67 0a 2a and *pzErrMsg.*
14040 2a 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 * may be set to
14050 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 point to a buffe
14060 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 6e 20 r containing an
14070 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 English language
14080 20 65 72 72 6f 72 20 0a 2a 2a 20 6d 65 73 73 61 error .** messa
14090 67 65 2e 20 49 74 20 69 73 20 74 68 65 20 72 65 ge. It is the re
140a0 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 sponsibility of
140b0 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 the caller to ev
140c0 65 6e 74 75 61 6c 6c 79 20 72 65 6c 65 61 73 65 entually release
140d0 0a 2a 2a 20 74 68 69 73 20 62 75 66 66 65 72 20 .** this buffer
140e0 62 79 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 by calling sqlit
140f0 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2f 0a 69 6e e3_free()..*/.in
14100 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 t sqlite3ParseUr
14110 69 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 i(. const char
14120 2a 7a 44 65 66 61 75 6c 74 56 66 73 2c 20 20 20 *zDefaultVfs,
14130 20 20 20 20 20 2f 2a 20 56 46 53 20 74 6f 20 75 /* VFS to u
14140 73 65 20 69 66 20 6e 6f 20 22 76 66 73 3d 78 78 se if no "vfs=xx
14150 78 22 20 71 75 65 72 79 20 6f 70 74 69 6f 6e 20 x" query option
14160 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
14170 2a 7a 55 72 69 2c 20 20 20 20 20 20 20 20 20 20 *zUri,
14180 20 20 20 20 20 2f 2a 20 4e 75 6c 2d 74 65 72 6d /* Nul-term
14190 69 6e 61 74 65 64 20 55 52 49 20 74 6f 20 70 61 inated URI to pa
141a0 72 73 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 rse */. unsigne
141b0 64 20 69 6e 74 20 2a 70 46 6c 61 67 73 2c 20 20 d int *pFlags,
141c0 20 20 20 20 20 20 20 20 20 2f 2a 20 49 4e 2f 4f /* IN/O
141d0 55 54 3a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f UT: SQLITE_OPEN_
141e0 58 58 58 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 XXX flags */. s
141f0 71 6c 69 74 65 33 5f 76 66 73 20 2a 2a 70 70 56 qlite3_vfs **ppV
14200 66 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f fs, /
14210 2a 20 4f 55 54 3a 20 56 46 53 20 74 6f 20 75 73 * OUT: VFS to us
14220 65 20 2a 2f 20 0a 20 20 63 68 61 72 20 2a 2a 70 e */ . char **p
14230 7a 46 69 6c 65 2c 20 20 20 20 20 20 20 20 20 20 zFile,
14240 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
14250 46 69 6c 65 6e 61 6d 65 20 63 6f 6d 70 6f 6e 65 Filename compone
14260 6e 74 20 6f 66 20 55 52 49 20 2a 2f 0a 20 20 63 nt of URI */. c
14270 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 har **pzErrMsg
14280 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
14290 2a 20 4f 55 54 3a 20 45 72 72 6f 72 20 6d 65 73 * OUT: Error mes
142a0 73 61 67 65 20 28 69 66 20 72 63 21 3d 53 51 4c sage (if rc!=SQL
142b0 49 54 45 5f 4f 4b 29 20 2a 2f 0a 29 7b 0a 20 20 ITE_OK) */.){.
142c0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
142d0 4f 4b 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 OK;. unsigned i
142e0 6e 74 20 66 6c 61 67 73 20 3d 20 2a 70 46 6c 61 nt flags = *pFla
142f0 67 73 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 gs;. const char
14300 20 2a 7a 56 66 73 20 3d 20 7a 44 65 66 61 75 6c *zVfs = zDefaul
14310 74 56 66 73 3b 0a 20 20 63 68 61 72 20 2a 7a 46 tVfs;. char *zF
14320 69 6c 65 3b 0a 20 20 63 68 61 72 20 63 3b 0a 20 ile;. char c;.
14330 20 69 6e 74 20 6e 55 72 69 20 3d 20 73 71 6c 69 int nUri = sqli
14340 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 55 72 69 te3Strlen30(zUri
14350 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 2a 70 );.. assert( *p
14360 7a 45 72 72 4d 73 67 3d 3d 30 20 29 3b 0a 0a 20 zErrMsg==0 );..
14370 20 69 66 28 20 28 28 66 6c 61 67 73 20 26 20 53 if( ((flags & S
14380 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29 20 QLITE_OPEN_URI)
14390 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
143a0 4d 50 3a 20 52 2d 34 38 37 32 35 2d 33 32 32 30 MP: R-48725-3220
143b0 36 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 6 */.
143c0 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 || sqlite3Globa
143d0 6c 43 6f 6e 66 69 67 2e 62 4f 70 65 6e 55 72 69 lConfig.bOpenUri
143e0 29 20 2f 2a 20 49 4d 50 3a 20 52 2d 35 31 36 38 ) /* IMP: R-5168
143f0 39 2d 34 36 35 34 38 20 2a 2f 0a 20 20 20 26 26 9-46548 */. &&
14400 20 6e 55 72 69 3e 3d 35 20 26 26 20 6d 65 6d 63 nUri>=5 && memc
14410 6d 70 28 7a 55 72 69 2c 20 22 66 69 6c 65 3a 22 mp(zUri, "file:"
14420 2c 20 35 29 3d 3d 30 20 2f 2a 20 49 4d 50 3a 20 , 5)==0 /* IMP:
14430 52 2d 35 37 38 38 34 2d 33 37 34 39 36 20 2a 2f R-57884-37496 */
14440 0a 20 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a . ){. char *
14450 7a 4f 70 74 3b 0a 20 20 20 20 69 6e 74 20 65 53 zOpt;. int eS
14460 74 61 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 tate;
14470 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 /* Parse
14480 72 20 73 74 61 74 65 20 77 68 65 6e 20 70 61 72 r state when par
14490 73 69 6e 67 20 55 52 49 20 2a 2f 0a 20 20 20 20 sing URI */.
144a0 69 6e 74 20 69 49 6e 3b 20 20 20 20 20 20 20 20 int iIn;
144b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
144c0 20 49 6e 70 75 74 20 63 68 61 72 61 63 74 65 72 Input character
144d0 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 69 6e index */. in
144e0 74 20 69 4f 75 74 20 3d 20 30 3b 20 20 20 20 20 t iOut = 0;
144f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
14500 75 74 70 75 74 20 63 68 61 72 61 63 74 65 72 20 utput character
14510 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 index */. int
14520 20 6e 42 79 74 65 20 3d 20 6e 55 72 69 2b 32 3b nByte = nUri+2;
14530 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 /* By
14540 74 65 73 20 6f 66 20 73 70 61 63 65 20 74 6f 20 tes of space to
14550 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 0a 20 20 20 allocate */..
14560 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 /* Make sure th
14570 65 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 e SQLITE_OPEN_UR
14580 49 20 66 6c 61 67 20 69 73 20 73 65 74 20 74 6f I flag is set to
14590 20 69 6e 64 69 63 61 74 65 20 74 6f 20 74 68 65 indicate to the
145a0 20 56 46 53 20 78 4f 70 65 6e 20 0a 20 20 20 20 VFS xOpen .
145b0 2a 2a 20 6d 65 74 68 6f 64 20 74 68 61 74 20 74 ** method that t
145c0 68 65 72 65 20 6d 61 79 20 62 65 20 65 78 74 72 here may be extr
145d0 61 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 6c a parameters fol
145e0 6c 6f 77 69 6e 67 20 74 68 65 20 66 69 6c 65 2d lowing the file-
145f0 6e 61 6d 65 2e 20 20 2a 2f 0a 20 20 20 20 66 6c name. */. fl
14600 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 ags |= SQLITE_OP
14610 45 4e 5f 55 52 49 3b 0a 0a 20 20 20 20 66 6f 72 EN_URI;.. for
14620 28 69 49 6e 3d 30 3b 20 69 49 6e 3c 6e 55 72 69 (iIn=0; iIn<nUri
14630 3b 20 69 49 6e 2b 2b 29 20 6e 42 79 74 65 20 2b ; iIn++) nByte +
14640 3d 20 28 7a 55 72 69 5b 69 49 6e 5d 3d 3d 27 26 = (zUri[iIn]=='&
14650 27 29 3b 0a 20 20 20 20 7a 46 69 6c 65 20 3d 20 ');. zFile =
14660 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e sqlite3_malloc(n
14670 42 79 74 65 29 3b 0a 20 20 20 20 69 66 28 20 21 Byte);. if( !
14680 7a 46 69 6c 65 20 29 20 72 65 74 75 72 6e 20 53 zFile ) return S
14690 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 0a 20 20 QLITE_NOMEM;..
146a0 20 20 69 49 6e 20 3d 20 35 3b 0a 23 69 66 64 65 iIn = 5;.#ifde
146b0 66 20 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55 f SQLITE_ALLOW_U
146c0 52 49 5f 41 55 54 48 4f 52 49 54 59 0a 20 20 20 RI_AUTHORITY.
146d0 20 69 66 28 20 73 74 72 6e 63 6d 70 28 7a 55 72 if( strncmp(zUr
146e0 69 2b 35 2c 20 22 2f 2f 2f 22 2c 20 33 29 3d 3d i+5, "///", 3)==
146f0 30 20 29 7b 0a 20 20 20 20 20 20 69 49 6e 20 3d 0 ){. iIn =
14700 20 37 3b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 7;. /* The
14710 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e 64 69 following condi
14720 74 69 6f 6e 20 63 61 75 73 65 73 20 55 52 49 73 tion causes URIs
14730 20 77 69 74 68 20 66 69 76 65 20 6c 65 61 64 69 with five leadi
14740 6e 67 20 2f 20 63 68 61 72 61 63 74 65 72 73 0a ng / characters.
14750 20 20 20 20 20 20 2a 2a 20 6c 69 6b 65 20 66 69 ** like fi
14760 6c 65 3a 2f 2f 2f 2f 2f 68 6f 73 74 2f 70 61 74 le://///host/pat
14770 68 20 74 6f 20 62 65 20 63 6f 6e 76 65 72 74 65 h to be converte
14780 64 20 69 6e 74 6f 20 55 4e 43 73 20 6c 69 6b 65 d into UNCs like
14790 20 2f 2f 68 6f 73 74 2f 70 61 74 68 2e 0a 20 20 //host/path..
147a0 20 20 20 20 2a 2a 20 54 68 65 20 63 6f 72 72 65 ** The corre
147b0 63 74 20 55 52 49 20 66 6f 72 20 74 68 61 74 20 ct URI for that
147c0 55 4e 43 20 68 61 73 20 6f 6e 6c 79 20 74 77 6f UNC has only two
147d0 20 6f 72 20 66 6f 75 72 20 6c 65 61 64 69 6e 67 or four leading
147e0 20 2f 20 63 68 61 72 61 63 74 65 72 73 0a 20 20 / characters.
147f0 20 20 20 20 2a 2a 20 66 69 6c 65 3a 2f 2f 68 6f ** file://ho
14800 73 74 2f 70 61 74 68 20 6f 72 20 66 69 6c 65 3a st/path or file:
14810 2f 2f 2f 2f 68 6f 73 74 2f 70 61 74 68 2e 20 20 ////host/path.
14820 42 75 74 20 35 20 6c 65 61 64 69 6e 67 20 73 6c But 5 leading sl
14830 61 73 68 65 73 20 69 73 20 61 20 0a 20 20 20 20 ashes is a .
14840 20 20 2a 2a 20 63 6f 6d 6d 6f 6e 20 65 72 72 6f ** common erro
14850 72 2c 20 77 65 20 61 72 65 20 74 6f 6c 64 2c 20 r, we are told,
14860 73 6f 20 77 65 20 68 61 6e 64 6c 65 20 69 74 20 so we handle it
14870 61 73 20 61 20 73 70 65 63 69 61 6c 20 63 61 73 as a special cas
14880 65 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 e. */. if(
14890 73 74 72 6e 63 6d 70 28 7a 55 72 69 2b 37 2c 20 strncmp(zUri+7,
148a0 22 2f 2f 2f 22 2c 20 33 29 3d 3d 30 20 29 7b 20 "///", 3)==0 ){
148b0 69 49 6e 2b 2b 3b 20 7d 0a 20 20 20 20 7d 65 6c iIn++; }. }el
148c0 73 65 20 69 66 28 20 73 74 72 6e 63 6d 70 28 7a se if( strncmp(z
148d0 55 72 69 2b 35 2c 20 22 2f 2f 6c 6f 63 61 6c 68 Uri+5, "//localh
148e0 6f 73 74 2f 22 2c 20 31 32 29 3d 3d 30 20 29 7b ost/", 12)==0 ){
148f0 0a 20 20 20 20 20 20 69 49 6e 20 3d 20 31 36 3b . iIn = 16;
14900 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 . }.#else.
14910 20 2f 2a 20 44 69 73 63 61 72 64 20 74 68 65 20 /* Discard the
14920 73 63 68 65 6d 65 20 61 6e 64 20 61 75 74 68 6f scheme and autho
14930 72 69 74 79 20 73 65 67 6d 65 6e 74 73 20 6f 66 rity segments of
14940 20 74 68 65 20 55 52 49 2e 20 2a 2f 0a 20 20 20 the URI. */.
14950 20 69 66 28 20 7a 55 72 69 5b 35 5d 3d 3d 27 2f if( zUri[5]=='/
14960 27 20 26 26 20 7a 55 72 69 5b 36 5d 3d 3d 27 2f ' && zUri[6]=='/
14970 27 20 29 7b 0a 20 20 20 20 20 20 69 49 6e 20 3d ' ){. iIn =
14980 20 37 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 7;. while(
14990 20 7a 55 72 69 5b 69 49 6e 5d 20 26 26 20 7a 55 zUri[iIn] && zU
149a0 72 69 5b 69 49 6e 5d 21 3d 27 2f 27 20 29 20 69 ri[iIn]!='/' ) i
149b0 49 6e 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 In++;. if(
149c0 69 49 6e 21 3d 37 20 26 26 20 28 69 49 6e 21 3d iIn!=7 && (iIn!=
149d0 31 36 20 7c 7c 20 6d 65 6d 63 6d 70 28 22 6c 6f 16 || memcmp("lo
149e0 63 61 6c 68 6f 73 74 22 2c 20 26 7a 55 72 69 5b calhost", &zUri[
149f0 37 5d 2c 20 39 29 29 20 29 7b 0a 20 20 20 20 20 7], 9)) ){.
14a00 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 *pzErrMsg = s
14a10 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 qlite3_mprintf("
14a20 69 6e 76 61 6c 69 64 20 75 72 69 20 61 75 74 68 invalid uri auth
14a30 6f 72 69 74 79 3a 20 25 2e 2a 73 22 2c 20 0a 20 ority: %.*s", .
14a40 20 20 20 20 20 20 20 20 20 20 20 69 49 6e 2d 37 iIn-7
14a50 2c 20 26 7a 55 72 69 5b 37 5d 29 3b 0a 20 20 20 , &zUri[7]);.
14a60 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
14a70 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 _ERROR;.
14a80 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 5f 6f goto parse_uri_o
14a90 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ut;. }.
14aa0 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a }.#endif.. /*
14ab0 20 43 6f 70 79 20 74 68 65 20 66 69 6c 65 6e 61 Copy the filena
14ac0 6d 65 20 61 6e 64 20 61 6e 79 20 71 75 65 72 79 me and any query
14ad0 20 70 61 72 61 6d 65 74 65 72 73 20 69 6e 74 6f parameters into
14ae0 20 74 68 65 20 7a 46 69 6c 65 20 62 75 66 66 65 the zFile buffe
14af0 72 2e 20 0a 20 20 20 20 2a 2a 20 44 65 63 6f 64 r. . ** Decod
14b00 65 20 25 48 48 20 65 73 63 61 70 65 20 63 6f 64 e %HH escape cod
14b10 65 73 20 61 6c 6f 6e 67 20 74 68 65 20 77 61 79 es along the way
14b20 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a . . **. **
14b30 20 57 69 74 68 69 6e 20 74 68 69 73 20 6c 6f 6f Within this loo
14b40 70 2c 20 76 61 72 69 61 62 6c 65 20 65 53 74 61 p, variable eSta
14b50 74 65 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f te may be set to
14b60 20 30 2c 20 31 20 6f 72 20 32 2c 20 64 65 70 65 0, 1 or 2, depe
14b70 6e 64 69 6e 67 0a 20 20 20 20 2a 2a 20 6f 6e 20 nding. ** on
14b80 74 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e 74 the parsing cont
14b90 65 78 74 2e 20 41 73 20 66 6f 6c 6c 6f 77 73 3a ext. As follows:
14ba0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 . **. **
14bb0 20 30 3a 20 50 61 72 73 69 6e 67 20 66 69 6c 65 0: Parsing file
14bc0 2d 6e 61 6d 65 2e 0a 20 20 20 20 2a 2a 20 20 20 -name.. **
14bd0 31 3a 20 50 61 72 73 69 6e 67 20 6e 61 6d 65 20 1: Parsing name
14be0 73 65 63 74 69 6f 6e 20 6f 66 20 61 20 6e 61 6d section of a nam
14bf0 65 3d 76 61 6c 75 65 20 71 75 65 72 79 20 70 61 e=value query pa
14c00 72 61 6d 65 74 65 72 2e 0a 20 20 20 20 2a 2a 20 rameter.. **
14c10 20 20 32 3a 20 50 61 72 73 69 6e 67 20 76 61 6c 2: Parsing val
14c20 75 65 20 73 65 63 74 69 6f 6e 20 6f 66 20 61 20 ue section of a
14c30 6e 61 6d 65 3d 76 61 6c 75 65 20 71 75 65 72 79 name=value query
14c40 20 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 20 20 parameter..
14c50 2a 2f 0a 20 20 20 20 65 53 74 61 74 65 20 3d 20 */. eState =
14c60 30 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 63 0;. while( (c
14c70 20 3d 20 7a 55 72 69 5b 69 49 6e 5d 29 21 3d 30 = zUri[iIn])!=0
14c80 20 26 26 20 63 21 3d 27 23 27 20 29 7b 0a 20 20 && c!='#' ){.
14c90 20 20 20 20 69 49 6e 2b 2b 3b 0a 20 20 20 20 20 iIn++;.
14ca0 20 69 66 28 20 63 3d 3d 27 25 27 20 0a 20 20 20 if( c=='%' .
14cb0 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 49 73 && sqlite3Is
14cc0 78 64 69 67 69 74 28 7a 55 72 69 5b 69 49 6e 5d xdigit(zUri[iIn]
14cd0 29 20 0a 20 20 20 20 20 20 20 26 26 20 73 71 6c ) . && sql
14ce0 69 74 65 33 49 73 78 64 69 67 69 74 28 7a 55 72 ite3Isxdigit(zUr
14cf0 69 5b 69 49 6e 2b 31 5d 29 20 0a 20 20 20 20 20 i[iIn+1]) .
14d00 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 ){. int
14d10 6f 63 74 65 74 20 3d 20 28 73 71 6c 69 74 65 33 octet = (sqlite3
14d20 48 65 78 54 6f 49 6e 74 28 7a 55 72 69 5b 69 49 HexToInt(zUri[iI
14d30 6e 2b 2b 5d 29 20 3c 3c 20 34 29 3b 0a 20 20 20 n++]) << 4);.
14d40 20 20 20 20 20 6f 63 74 65 74 20 2b 3d 20 73 71 octet += sq
14d50 6c 69 74 65 33 48 65 78 54 6f 49 6e 74 28 7a 55 lite3HexToInt(zU
14d60 72 69 5b 69 49 6e 2b 2b 5d 29 3b 0a 0a 20 20 20 ri[iIn++]);..
14d70 20 20 20 20 20 61 73 73 65 72 74 28 20 6f 63 74 assert( oct
14d80 65 74 3e 3d 30 20 26 26 20 6f 63 74 65 74 3c 32 et>=0 && octet<2
14d90 35 36 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 56 );. if
14da0 28 20 6f 63 74 65 74 3d 3d 30 20 29 7b 0a 20 20 ( octet==0 ){.
14db0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 /* This
14dc0 62 72 61 6e 63 68 20 69 73 20 74 61 6b 65 6e 20 branch is taken
14dd0 77 68 65 6e 20 22 25 30 30 22 20 61 70 70 65 61 when "%00" appea
14de0 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 55 52 rs within the UR
14df0 49 2e 20 49 6e 20 74 68 69 73 0a 20 20 20 20 20 I. In this.
14e00 20 20 20 20 20 2a 2a 20 63 61 73 65 20 77 65 20 ** case we
14e10 69 67 6e 6f 72 65 20 61 6c 6c 20 74 65 78 74 20 ignore all text
14e20 69 6e 20 74 68 65 20 72 65 6d 61 69 6e 64 65 72 in the remainder
14e30 20 6f 66 20 74 68 65 20 70 61 74 68 2c 20 6e 61 of the path, na
14e40 6d 65 20 6f 72 0a 20 20 20 20 20 20 20 20 20 20 me or.
14e50 2a 2a 20 76 61 6c 75 65 20 63 75 72 72 65 6e 74 ** value current
14e60 6c 79 20 62 65 69 6e 67 20 70 61 72 73 65 64 2e ly being parsed.
14e70 20 53 6f 20 69 67 6e 6f 72 65 20 74 68 65 20 63 So ignore the c
14e80 75 72 72 65 6e 74 20 63 68 61 72 61 63 74 65 72 urrent character
14e90 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 6e . ** an
14ea0 64 20 73 6b 69 70 20 74 6f 20 74 68 65 20 6e 65 d skip to the ne
14eb0 78 74 20 22 3f 22 2c 20 22 3d 22 20 6f 72 20 22 xt "?", "=" or "
14ec0 26 22 2c 20 61 73 20 61 70 70 72 6f 70 72 69 61 &", as appropria
14ed0 74 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 te. */.
14ee0 20 77 68 69 6c 65 28 20 28 63 20 3d 20 7a 55 72 while( (c = zUr
14ef0 69 5b 69 49 6e 5d 29 21 3d 30 20 26 26 20 63 21 i[iIn])!=0 && c!
14f00 3d 27 23 27 20 0a 20 20 20 20 20 20 20 20 20 20 ='#' .
14f10 20 20 20 20 26 26 20 28 65 53 74 61 74 65 21 3d && (eState!=
14f20 30 20 7c 7c 20 63 21 3d 27 3f 27 29 0a 20 20 20 0 || c!='?').
14f30 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 65 && (e
14f40 53 74 61 74 65 21 3d 31 20 7c 7c 20 28 63 21 3d State!=1 || (c!=
14f50 27 3d 27 20 26 26 20 63 21 3d 27 26 27 29 29 0a '=' && c!='&')).
14f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 &&
14f70 20 28 65 53 74 61 74 65 21 3d 32 20 7c 7c 20 63 (eState!=2 || c
14f80 21 3d 27 26 27 29 0a 20 20 20 20 20 20 20 20 20 !='&').
14f90 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
14fa0 69 49 6e 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 iIn++;.
14fb0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e }. con
14fc0 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 7d tinue;. }
14fd0 0a 20 20 20 20 20 20 20 20 63 20 3d 20 6f 63 74 . c = oct
14fe0 65 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 et;. }else
14ff0 69 66 28 20 65 53 74 61 74 65 3d 3d 31 20 26 26 if( eState==1 &&
15000 20 28 63 3d 3d 27 26 27 20 7c 7c 20 63 3d 3d 27 (c=='&' || c=='
15010 3d 27 29 20 29 7b 0a 20 20 20 20 20 20 20 20 69 =') ){. i
15020 66 28 20 7a 46 69 6c 65 5b 69 4f 75 74 2d 31 5d f( zFile[iOut-1]
15030 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
15040 20 2f 2a 20 41 6e 20 65 6d 70 74 79 20 6f 70 74 /* An empty opt
15050 69 6f 6e 20 6e 61 6d 65 2e 20 49 67 6e 6f 72 65 ion name. Ignore
15060 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 6c 74 this option alt
15070 6f 67 65 74 68 65 72 2e 20 2a 2f 0a 20 20 20 20 ogether. */.
15080 20 20 20 20 20 20 77 68 69 6c 65 28 20 7a 55 72 while( zUr
15090 69 5b 69 49 6e 5d 20 26 26 20 7a 55 72 69 5b 69 i[iIn] && zUri[i
150a0 49 6e 5d 21 3d 27 23 27 20 26 26 20 7a 55 72 69 In]!='#' && zUri
150b0 5b 69 49 6e 2d 31 5d 21 3d 27 26 27 20 29 20 69 [iIn-1]!='&' ) i
150c0 49 6e 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20 In++;.
150d0 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 continue;.
150e0 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
150f0 63 3d 3d 27 26 27 20 29 7b 0a 20 20 20 20 20 20 c=='&' ){.
15100 20 20 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b zFile[iOut++
15110 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 ] = '\0';.
15120 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
15130 20 20 20 65 53 74 61 74 65 20 3d 20 32 3b 0a 20 eState = 2;.
15140 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
15150 20 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65 c = 0;. }e
15160 6c 73 65 20 69 66 28 20 28 65 53 74 61 74 65 3d lse if( (eState=
15170 3d 30 20 26 26 20 63 3d 3d 27 3f 27 29 20 7c 7c =0 && c=='?') ||
15180 20 28 65 53 74 61 74 65 3d 3d 32 20 26 26 20 63 (eState==2 && c
15190 3d 3d 27 26 27 29 20 29 7b 0a 20 20 20 20 20 20 =='&') ){.
151a0 20 20 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 c = 0;.
151b0 20 65 53 74 61 74 65 20 3d 20 31 3b 0a 20 20 20 eState = 1;.
151c0 20 20 20 7d 0a 20 20 20 20 20 20 7a 46 69 6c 65 }. zFile
151d0 5b 69 4f 75 74 2b 2b 5d 20 3d 20 63 3b 0a 20 20 [iOut++] = c;.
151e0 20 20 7d 0a 20 20 20 20 69 66 28 20 65 53 74 61 }. if( eSta
151f0 74 65 3d 3d 31 20 29 20 7a 46 69 6c 65 5b 69 4f te==1 ) zFile[iO
15200 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 ut++] = '\0';.
15210 20 20 7a 46 69 6c 65 5b 69 4f 75 74 2b 2b 5d 20 zFile[iOut++]
15220 3d 20 27 5c 30 27 3b 0a 20 20 20 20 7a 46 69 6c = '\0';. zFil
15230 65 5b 69 4f 75 74 2b 2b 5d 20 3d 20 27 5c 30 27 e[iOut++] = '\0'
15240 3b 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 ;.. /* Check
15250 69 66 20 74 68 65 72 65 20 77 65 72 65 20 61 6e if there were an
15260 79 20 6f 70 74 69 6f 6e 73 20 73 70 65 63 69 66 y options specif
15270 69 65 64 20 74 68 61 74 20 73 68 6f 75 6c 64 20 ied that should
15280 62 65 20 69 6e 74 65 72 70 72 65 74 65 64 20 0a be interpreted .
15290 20 20 20 20 2a 2a 20 68 65 72 65 2e 20 4f 70 74 ** here. Opt
152a0 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 69 6e ions that are in
152b0 74 65 72 70 72 65 74 65 64 20 68 65 72 65 20 69 terpreted here i
152c0 6e 63 6c 75 64 65 20 22 76 66 73 22 20 61 6e 64 nclude "vfs" and
152d0 20 74 68 6f 73 65 20 74 68 61 74 0a 20 20 20 20 those that.
152e0 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f ** correspond to
152f0 20 66 6c 61 67 73 20 74 68 61 74 20 6d 61 79 20 flags that may
15300 62 65 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 be passed to the
15310 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 sqlite3_open_v2
15320 28 29 0a 20 20 20 20 2a 2a 20 6d 65 74 68 6f 64 (). ** method
15330 2e 20 2a 2f 0a 20 20 20 20 7a 4f 70 74 20 3d 20 . */. zOpt =
15340 26 7a 46 69 6c 65 5b 73 71 6c 69 74 65 33 53 74 &zFile[sqlite3St
15350 72 6c 65 6e 33 30 28 7a 46 69 6c 65 29 2b 31 5d rlen30(zFile)+1]
15360 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 7a 4f 70 ;. while( zOp
15370 74 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 69 6e t[0] ){. in
15380 74 20 6e 4f 70 74 20 3d 20 73 71 6c 69 74 65 33 t nOpt = sqlite3
15390 53 74 72 6c 65 6e 33 30 28 7a 4f 70 74 29 3b 0a Strlen30(zOpt);.
153a0 20 20 20 20 20 20 63 68 61 72 20 2a 7a 56 61 6c char *zVal
153b0 20 3d 20 26 7a 4f 70 74 5b 6e 4f 70 74 2b 31 5d = &zOpt[nOpt+1]
153c0 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 56 61 6c ;. int nVal
153d0 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e = sqlite3Strlen
153e0 33 30 28 7a 56 61 6c 29 3b 0a 0a 20 20 20 20 20 30(zVal);..
153f0 20 69 66 28 20 6e 4f 70 74 3d 3d 33 20 26 26 20 if( nOpt==3 &&
15400 6d 65 6d 63 6d 70 28 22 76 66 73 22 2c 20 7a 4f memcmp("vfs", zO
15410 70 74 2c 20 33 29 3d 3d 30 20 29 7b 0a 20 20 20 pt, 3)==0 ){.
15420 20 20 20 20 20 7a 56 66 73 20 3d 20 7a 56 61 6c zVfs = zVal
15430 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
15440 20 20 20 20 20 20 20 73 74 72 75 63 74 20 4f 70 struct Op
15450 65 6e 4d 6f 64 65 20 7b 0a 20 20 20 20 20 20 20 enMode {.
15460 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a const char *z
15470 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 ;. int
15480 6d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 7d 20 mode;. }
15490 2a 61 4d 6f 64 65 20 3d 20 30 3b 0a 20 20 20 20 *aMode = 0;.
154a0 20 20 20 20 63 68 61 72 20 2a 7a 4d 6f 64 65 54 char *zModeT
154b0 79 70 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ype = 0;.
154c0 20 69 6e 74 20 6d 61 73 6b 20 3d 20 30 3b 0a 20 int mask = 0;.
154d0 20 20 20 20 20 20 20 69 6e 74 20 6c 69 6d 69 74 int limit
154e0 20 3d 20 30 3b 0a 0a 20 20 20 20 20 20 20 20 69 = 0;.. i
154f0 66 28 20 6e 4f 70 74 3d 3d 35 20 26 26 20 6d 65 f( nOpt==5 && me
15500 6d 63 6d 70 28 22 63 61 63 68 65 22 2c 20 7a 4f mcmp("cache", zO
15510 70 74 2c 20 35 29 3d 3d 30 20 29 7b 0a 20 20 20 pt, 5)==0 ){.
15520 20 20 20 20 20 20 20 73 74 61 74 69 63 20 73 74 static st
15530 72 75 63 74 20 4f 70 65 6e 4d 6f 64 65 20 61 43 ruct OpenMode aC
15540 61 63 68 65 4d 6f 64 65 5b 5d 20 3d 20 7b 0a 20 acheMode[] = {.
15550 20 20 20 20 20 20 20 20 20 20 20 7b 20 22 73 68 { "sh
15560 61 72 65 64 22 2c 20 20 53 51 4c 49 54 45 5f 4f ared", SQLITE_O
15570 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 PEN_SHAREDCACHE
15580 7d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b },. {
15590 20 22 70 72 69 76 61 74 65 22 2c 20 53 51 4c 49 "private", SQLI
155a0 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 TE_OPEN_PRIVATEC
155b0 41 43 48 45 20 7d 2c 0a 20 20 20 20 20 20 20 20 ACHE },.
155c0 20 20 20 20 7b 20 30 2c 20 30 20 7d 0a 20 20 20 { 0, 0 }.
155d0 20 20 20 20 20 20 20 7d 3b 0a 0a 20 20 20 20 20 };..
155e0 20 20 20 20 20 6d 61 73 6b 20 3d 20 53 51 4c 49 mask = SQLI
155f0 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 TE_OPEN_SHAREDCA
15600 43 48 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f CHE|SQLITE_OPEN_
15610 50 52 49 56 41 54 45 43 41 43 48 45 3b 0a 20 20 PRIVATECACHE;.
15620 20 20 20 20 20 20 20 20 61 4d 6f 64 65 20 3d 20 aMode =
15630 61 43 61 63 68 65 4d 6f 64 65 3b 0a 20 20 20 20 aCacheMode;.
15640 20 20 20 20 20 20 6c 69 6d 69 74 20 3d 20 6d 61 limit = ma
15650 73 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7a 4d sk;. zM
15660 6f 64 65 54 79 70 65 20 3d 20 22 63 61 63 68 65 odeType = "cache
15670 22 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 ";. }.
15680 20 20 20 20 20 69 66 28 20 6e 4f 70 74 3d 3d 34 if( nOpt==4
15690 20 26 26 20 6d 65 6d 63 6d 70 28 22 6d 6f 64 65 && memcmp("mode
156a0 22 2c 20 7a 4f 70 74 2c 20 34 29 3d 3d 30 20 29 ", zOpt, 4)==0 )
156b0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 61 74 {. stat
156c0 69 63 20 73 74 72 75 63 74 20 4f 70 65 6e 4d 6f ic struct OpenMo
156d0 64 65 20 61 4f 70 65 6e 4d 6f 64 65 5b 5d 20 3d de aOpenMode[] =
156e0 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b {. {
156f0 20 22 72 6f 22 2c 20 20 53 51 4c 49 54 45 5f 4f "ro", SQLITE_O
15700 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 7d 2c 0a PEN_READONLY },.
15710 20 20 20 20 20 20 20 20 20 20 20 20 7b 20 22 72 { "r
15720 77 22 2c 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e w", SQLITE_OPEN
15730 5f 52 45 41 44 57 52 49 54 45 20 7d 2c 20 0a 20 _READWRITE }, .
15740 20 20 20 20 20 20 20 20 20 20 20 7b 20 22 72 77 { "rw
15750 63 22 2c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f c", SQLITE_OPEN_
15760 52 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 READWRITE | SQLI
15770 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 7d TE_OPEN_CREATE }
15780 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 20 ,. {
15790 22 6d 65 6d 6f 72 79 22 2c 20 53 51 4c 49 54 45 "memory", SQLITE
157a0 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 59 20 7d 2c 0a _OPEN_MEMORY },.
157b0 20 20 20 20 20 20 20 20 20 20 20 20 7b 20 30 2c { 0,
157c0 20 30 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0 }. }
157d0 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 6d 61 73 ;.. mas
157e0 6b 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f k = SQLITE_OPEN_
157f0 52 45 41 44 4f 4e 4c 59 20 7c 20 53 51 4c 49 54 READONLY | SQLIT
15800 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
15810 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
15820 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 | SQLITE_OPE
15830 4e 5f 43 52 45 41 54 45 20 7c 20 53 51 4c 49 54 N_CREATE | SQLIT
15840 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 59 3b 0a 20 E_OPEN_MEMORY;.
15850 20 20 20 20 20 20 20 20 20 61 4d 6f 64 65 20 3d aMode =
15860 20 61 4f 70 65 6e 4d 6f 64 65 3b 0a 20 20 20 20 aOpenMode;.
15870 20 20 20 20 20 20 6c 69 6d 69 74 20 3d 20 6d 61 limit = ma
15880 73 6b 20 26 20 66 6c 61 67 73 3b 0a 20 20 20 20 sk & flags;.
15890 20 20 20 20 20 20 7a 4d 6f 64 65 54 79 70 65 20 zModeType
158a0 3d 20 22 61 63 63 65 73 73 22 3b 0a 20 20 20 20 = "access";.
158b0 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 }.. i
158c0 66 28 20 61 4d 6f 64 65 20 29 7b 0a 20 20 20 20 f( aMode ){.
158d0 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 int i;.
158e0 20 20 20 20 20 20 20 69 6e 74 20 6d 6f 64 65 20 int mode
158f0 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 66 = 0;. f
15900 6f 72 28 69 3d 30 3b 20 61 4d 6f 64 65 5b 69 5d or(i=0; aMode[i]
15910 2e 7a 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 .z; i++){.
15920 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 const char
15930 20 2a 7a 20 3d 20 61 4d 6f 64 65 5b 69 5d 2e 7a *z = aMode[i].z
15940 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
15950 28 20 6e 56 61 6c 3d 3d 73 71 6c 69 74 65 33 53 ( nVal==sqlite3S
15960 74 72 6c 65 6e 33 30 28 7a 29 20 26 26 20 30 3d trlen30(z) && 0=
15970 3d 6d 65 6d 63 6d 70 28 7a 56 61 6c 2c 20 7a 2c =memcmp(zVal, z,
15980 20 6e 56 61 6c 29 20 29 7b 0a 20 20 20 20 20 20 nVal) ){.
15990 20 20 20 20 20 20 20 20 6d 6f 64 65 20 3d 20 61 mode = a
159a0 4d 6f 64 65 5b 69 5d 2e 6d 6f 64 65 3b 0a 20 20 Mode[i].mode;.
159b0 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
159c0 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d k;. }
159d0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
159e0 20 20 20 20 20 20 20 69 66 28 20 6d 6f 64 65 3d if( mode=
159f0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
15a00 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 *pzErrMsg = sq
15a10 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 6e lite3_mprintf("n
15a20 6f 20 73 75 63 68 20 25 73 20 6d 6f 64 65 3a 20 o such %s mode:
15a30 25 73 22 2c 20 7a 4d 6f 64 65 54 79 70 65 2c 20 %s", zModeType,
15a40 7a 56 61 6c 29 3b 0a 20 20 20 20 20 20 20 20 20 zVal);.
15a50 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 rc = SQLITE_E
15a60 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 20 RROR;.
15a70 20 20 67 6f 74 6f 20 70 61 72 73 65 5f 75 72 69 goto parse_uri
15a80 5f 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 20 20 _out;.
15a90 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
15aa0 28 6d 6f 64 65 20 26 20 7e 53 51 4c 49 54 45 5f (mode & ~SQLITE_
15ab0 4f 50 45 4e 5f 4d 45 4d 4f 52 59 29 3e 6c 69 6d OPEN_MEMORY)>lim
15ac0 69 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 it ){.
15ad0 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 *pzErrMsg = sq
15ae0 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 25 lite3_mprintf("%
15af0 73 20 6d 6f 64 65 20 6e 6f 74 20 61 6c 6c 6f 77 s mode not allow
15b00 65 64 3a 20 25 73 22 2c 0a 20 20 20 20 20 20 20 ed: %s",.
15b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15b30 20 7a 4d 6f 64 65 54 79 70 65 2c 20 7a 56 61 6c zModeType, zVal
15b40 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
15b50 63 20 3d 20 53 51 4c 49 54 45 5f 50 45 52 4d 3b c = SQLITE_PERM;
15b60 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 . got
15b70 6f 20 70 61 72 73 65 5f 75 72 69 5f 6f 75 74 3b o parse_uri_out;
15b80 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
15b90 20 20 20 20 20 20 20 66 6c 61 67 73 20 3d 20 28 flags = (
15ba0 66 6c 61 67 73 20 26 20 7e 6d 61 73 6b 29 20 7c flags & ~mask) |
15bb0 20 6d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 7d mode;. }
15bc0 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
15bd0 7a 4f 70 74 20 3d 20 26 7a 56 61 6c 5b 6e 56 61 zOpt = &zVal[nVa
15be0 6c 2b 31 5d 3b 0a 20 20 20 20 7d 0a 0a 20 20 7d l+1];. }.. }
15bf0 65 6c 73 65 7b 0a 20 20 20 20 7a 46 69 6c 65 20 else{. zFile
15c00 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 = sqlite3_malloc
15c10 28 6e 55 72 69 2b 32 29 3b 0a 20 20 20 20 69 66 (nUri+2);. if
15c20 28 20 21 7a 46 69 6c 65 20 29 20 72 65 74 75 72 ( !zFile ) retur
15c30 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a n SQLITE_NOMEM;.
15c40 20 20 20 20 6d 65 6d 63 70 79 28 7a 46 69 6c 65 memcpy(zFile
15c50 2c 20 7a 55 72 69 2c 20 6e 55 72 69 29 3b 0a 20 , zUri, nUri);.
15c60 20 20 20 7a 46 69 6c 65 5b 6e 55 72 69 5d 20 3d zFile[nUri] =
15c70 20 27 5c 30 27 3b 0a 20 20 20 20 7a 46 69 6c 65 '\0';. zFile
15c80 5b 6e 55 72 69 2b 31 5d 20 3d 20 27 5c 30 27 3b [nUri+1] = '\0';
15c90 0a 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e 53 . flags &= ~S
15ca0 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a QLITE_OPEN_URI;.
15cb0 20 20 7d 0a 0a 20 20 2a 70 70 56 66 73 20 3d 20 }.. *ppVfs =
15cc0 73 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 sqlite3_vfs_find
15cd0 28 7a 56 66 73 29 3b 0a 20 20 69 66 28 20 2a 70 (zVfs);. if( *p
15ce0 70 56 66 73 3d 3d 30 20 29 7b 0a 20 20 20 20 2a pVfs==0 ){. *
15cf0 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 pzErrMsg = sqlit
15d00 65 33 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 20 73 e3_mprintf("no s
15d10 75 63 68 20 76 66 73 3a 20 25 73 22 2c 20 7a 56 uch vfs: %s", zV
15d20 66 73 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 fs);. rc = SQ
15d30 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a LITE_ERROR;. }.
15d40 20 70 61 72 73 65 5f 75 72 69 5f 6f 75 74 3a 0a parse_uri_out:.
15d50 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
15d60 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 _OK ){. sqlit
15d70 65 33 5f 66 72 65 65 28 7a 46 69 6c 65 29 3b 0a e3_free(zFile);.
15d80 20 20 20 20 7a 46 69 6c 65 20 3d 20 30 3b 0a 20 zFile = 0;.
15d90 20 7d 0a 20 20 2a 70 46 6c 61 67 73 20 3d 20 66 }. *pFlags = f
15da0 6c 61 67 73 3b 0a 20 20 2a 70 7a 46 69 6c 65 20 lags;. *pzFile
15db0 3d 20 7a 46 69 6c 65 3b 0a 20 20 72 65 74 75 72 = zFile;. retur
15dc0 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 20 64 65 66 n rc;.}..#if def
15dd0 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
15de0 4c 45 5f 41 55 54 4f 5f 50 52 4f 46 49 4c 45 29 LE_AUTO_PROFILE)
15df0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
15e00 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 54 44 45 AUTOLOGGING_STDE
15e10 52 52 20 31 0a 23 64 65 66 69 6e 65 20 53 51 4c RR 1.#define SQL
15e20 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f ITE_AUTOLOGGING_
15e30 53 59 53 4c 4f 47 20 32 0a 73 74 61 74 69 63 20 SYSLOG 2.static
15e40 76 6f 69 64 20 65 6e 61 62 6c 65 41 75 74 6f 4c void enableAutoL
15e50 6f 67 67 69 6e 67 28 0a 20 20 73 71 6c 69 74 65 ogging(. sqlite
15e60 33 20 2a 64 62 0a 29 7b 0a 20 20 63 68 61 72 20 3 *db.){. char
15e70 2a 65 6e 76 70 72 6f 66 69 6c 65 20 3d 20 67 65 *envprofile = ge
15e80 74 65 6e 76 28 22 53 51 4c 49 54 45 5f 41 55 54 tenv("SQLITE_AUT
15e90 4f 5f 50 52 4f 46 49 4c 45 22 29 3b 0a 20 20 0a O_PROFILE");. .
15ea0 20 20 69 66 28 20 65 6e 76 70 72 6f 66 69 6c 65 if( envprofile
15eb0 21 3d 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 69 6e !=NULL ){. in
15ec0 74 20 77 68 65 72 65 20 3d 20 30 3b 0a 20 20 20 t where = 0;.
15ed0 20 69 66 28 20 21 73 74 72 6e 63 61 73 65 63 6d if( !strncasecm
15ee0 70 28 22 31 22 2c 20 65 6e 76 70 72 6f 66 69 6c p("1", envprofil
15ef0 65 2c 20 31 29 20 29 7b 0a 20 20 20 20 20 20 69 e, 1) ){. i
15f00 66 28 20 69 73 61 74 74 79 28 32 29 20 29 7b 0a f( isatty(2) ){.
15f10 20 20 20 20 20 20 20 20 77 68 65 72 65 20 3d 20 where =
15f20 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 SQLITE_AUTOLOGGI
15f30 4e 47 5f 53 54 44 45 52 52 3b 0a 20 20 20 20 20 NG_STDERR;.
15f40 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
15f50 77 68 65 72 65 20 3d 20 53 51 4c 49 54 45 5f 41 where = SQLITE_A
15f60 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 59 53 4c 4f UTOLOGGING_SYSLO
15f70 47 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d G;. }. }
15f80 20 65 6c 73 65 20 69 66 28 20 21 73 74 72 6e 63 else if( !strnc
15f90 61 73 65 63 6d 70 28 22 73 74 64 65 72 72 22 2c asecmp("stderr",
15fa0 20 65 6e 76 70 72 6f 66 69 6c 65 2c 20 36 29 20 envprofile, 6)
15fb0 29 7b 0a 20 20 20 20 20 20 77 68 65 72 65 20 3d ){. where =
15fc0 20 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 SQLITE_AUTOLOGG
15fd0 49 4e 47 5f 53 54 44 45 52 52 3b 0a 20 20 20 20 ING_STDERR;.
15fe0 7d 20 65 6c 73 65 20 69 66 28 20 21 73 74 72 6e } else if( !strn
15ff0 63 61 73 65 63 6d 70 28 22 73 79 73 6c 6f 67 22 casecmp("syslog"
16000 2c 20 65 6e 76 70 72 6f 66 69 6c 65 2c 20 36 29 , envprofile, 6)
16010 20 29 7b 0a 20 20 20 20 20 20 77 68 65 72 65 20 ){. where
16020 3d 20 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 = SQLITE_AUTOLOG
16030 47 49 4e 47 5f 53 59 53 4c 4f 47 3b 0a 20 20 20 GING_SYSLOG;.
16040 20 7d 0a 20 20 20 20 69 66 28 20 77 68 65 72 65 }. if( where
16050 3d 3d 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 ==SQLITE_AUTOLOG
16060 47 49 4e 47 5f 53 54 44 45 52 52 20 29 7b 0a 20 GING_STDERR ){.
16070 20 20 20 20 20 73 71 6c 69 74 65 33 5f 70 72 6f sqlite3_pro
16080 66 69 6c 65 28 64 62 2c 20 5f 73 71 6c 69 74 65 file(db, _sqlite
16090 5f 61 75 74 6f 5f 70 72 6f 66 69 6c 65 2c 20 64 _auto_profile, d
160a0 62 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 b);. }else if
160b0 28 20 77 68 65 72 65 3d 3d 53 51 4c 49 54 45 5f ( where==SQLITE_
160c0 41 55 54 4f 4c 4f 47 47 49 4e 47 5f 53 59 53 4c AUTOLOGGING_SYSL
160d0 4f 47 20 29 7b 0a 20 20 20 20 20 20 5f 6f 70 65 OG ){. _ope
160e0 6e 5f 61 73 6c 5f 6c 6f 67 28 29 3b 0a 20 20 20 n_asl_log();.
160f0 20 20 20 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 sqlite3_profi
16100 6c 65 28 64 62 2c 20 5f 73 71 6c 69 74 65 5f 61 le(db, _sqlite_a
16110 75 74 6f 5f 70 72 6f 66 69 6c 65 5f 73 79 73 6c uto_profile_sysl
16120 6f 67 2c 20 64 62 29 3b 0a 20 20 20 20 7d 0a 20 og, db);. }.
16130 20 7d 0a 20 20 63 68 61 72 20 2a 65 6e 76 74 72 }. char *envtr
16140 61 63 65 20 3d 20 67 65 74 65 6e 76 28 22 53 51 ace = getenv("SQ
16150 4c 49 54 45 5f 41 55 54 4f 5f 54 52 41 43 45 22 LITE_AUTO_TRACE"
16160 29 3b 0a 20 20 69 66 28 20 65 6e 76 74 72 61 63 );. if( envtrac
16170 65 21 3d 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 69 e!=NULL ){. i
16180 6e 74 20 77 68 65 72 65 20 3d 20 30 3b 0a 20 20 nt where = 0;.
16190 20 20 69 66 28 20 21 73 74 72 6e 63 61 73 65 63 if( !strncasec
161a0 6d 70 28 22 31 22 2c 20 65 6e 76 74 72 61 63 65 mp("1", envtrace
161b0 2c 20 31 29 20 29 7b 0a 20 20 20 20 20 20 69 66 , 1) ){. if
161c0 28 20 69 73 61 74 74 79 28 32 29 20 29 7b 0a 20 ( isatty(2) ){.
161d0 20 20 20 20 20 20 20 77 68 65 72 65 20 3d 20 53 where = S
161e0 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e QLITE_AUTOLOGGIN
161f0 47 5f 53 54 44 45 52 52 3b 0a 20 20 20 20 20 20 G_STDERR;.
16200 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 77 }else{. w
16210 68 65 72 65 20 3d 20 53 51 4c 49 54 45 5f 41 55 here = SQLITE_AU
16220 54 4f 4c 4f 47 47 49 4e 47 5f 53 59 53 4c 4f 47 TOLOGGING_SYSLOG
16230 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 ;. }. }
16240 65 6c 73 65 20 69 66 28 20 21 73 74 72 6e 63 61 else if( !strnca
16250 73 65 63 6d 70 28 22 73 74 64 65 72 72 22 2c 20 secmp("stderr",
16260 65 6e 76 74 72 61 63 65 2c 20 36 29 20 29 7b 0a envtrace, 6) ){.
16270 20 20 20 20 20 20 77 68 65 72 65 20 3d 20 53 51 where = SQ
16280 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 LITE_AUTOLOGGING
16290 5f 53 54 44 45 52 52 3b 0a 20 20 20 20 7d 20 65 _STDERR;. } e
162a0 6c 73 65 20 69 66 28 20 21 73 74 72 6e 63 61 73 lse if( !strncas
162b0 65 63 6d 70 28 22 73 79 73 6c 6f 67 22 2c 20 65 ecmp("syslog", e
162c0 6e 76 74 72 61 63 65 2c 20 36 29 20 29 7b 0a 20 nvtrace, 6) ){.
162d0 20 20 20 20 20 77 68 65 72 65 20 3d 20 53 51 4c where = SQL
162e0 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f ITE_AUTOLOGGING_
162f0 53 59 53 4c 4f 47 3b 0a 20 20 20 20 7d 0a 20 20 SYSLOG;. }.
16300 20 20 69 66 28 20 77 68 65 72 65 3d 3d 53 51 4c if( where==SQL
16310 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 4e 47 5f ITE_AUTOLOGGING_
16320 53 54 44 45 52 52 20 29 7b 0a 20 20 20 20 20 20 STDERR ){.
16330 73 71 6c 69 74 65 33 5f 74 72 61 63 65 28 64 62 sqlite3_trace(db
16340 2c 20 5f 73 71 6c 69 74 65 5f 61 75 74 6f 5f 74 , _sqlite_auto_t
16350 72 61 63 65 2c 20 64 62 29 3b 0a 20 20 20 20 7d race, db);. }
16360 65 6c 73 65 20 69 66 28 20 77 68 65 72 65 3d 3d else if( where==
16370 53 51 4c 49 54 45 5f 41 55 54 4f 4c 4f 47 47 49 SQLITE_AUTOLOGGI
16380 4e 47 5f 53 59 53 4c 4f 47 20 29 7b 0a 20 20 20 NG_SYSLOG ){.
16390 20 20 20 5f 6f 70 65 6e 5f 61 73 6c 5f 6c 6f 67 _open_asl_log
163a0 28 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ();. sqlite
163b0 33 5f 74 72 61 63 65 28 64 62 2c 20 5f 73 71 6c 3_trace(db, _sql
163c0 69 74 65 5f 61 75 74 6f 5f 74 72 61 63 65 5f 73 ite_auto_trace_s
163d0 79 73 6c 6f 67 2c 20 64 62 29 3b 0a 20 20 20 20 yslog, db);.
163e0 7d 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a }. }.}.#endif..
163f0 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 /*.** This routi
16400 6e 65 20 64 6f 65 73 20 74 68 65 20 77 6f 72 6b ne does the work
16410 20 6f 66 20 6f 70 65 6e 69 6e 67 20 61 20 64 61 of opening a da
16420 74 61 62 61 73 65 20 6f 6e 20 62 65 68 61 6c 66 tabase on behalf
16430 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f of.** sqlite3_o
16440 70 65 6e 28 29 20 61 6e 64 20 73 71 6c 69 74 65 pen() and sqlite
16450 33 5f 6f 70 65 6e 31 36 28 29 2e 20 54 68 65 20 3_open16(). The
16460 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d database filenam
16470 65 20 22 7a 46 69 6c 65 6e 61 6d 65 22 20 20 0a e "zFilename" .
16480 2a 2a 20 69 73 20 55 54 46 2d 38 20 65 6e 63 6f ** is UTF-8 enco
16490 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ded..*/.static i
164a0 6e 74 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 nt openDatabase(
164b0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
164c0 46 69 6c 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 Filename, /* Dat
164d0 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 abase filename U
164e0 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a TF-8 encoded */.
164f0 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 sqlite3 **ppDb
16500 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a , /* OUT:
16510 20 52 65 74 75 72 6e 65 64 20 64 61 74 61 62 61 Returned databa
16520 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 75 se handle */. u
16530 6e 73 69 67 6e 65 64 20 69 6e 74 20 66 6c 61 67 nsigned int flag
16540 73 2c 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 s, /* Operati
16550 6f 6e 61 6c 20 66 6c 61 67 73 20 2a 2f 0a 20 20 onal flags */.
16560 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 73 const char *zVfs
16570 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
16580 66 20 74 68 65 20 56 46 53 20 74 6f 20 75 73 65 f the VFS to use
16590 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 */.){. sqlite3
165a0 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 *db;
165b0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 /* Stor
165c0 65 20 61 6c 6c 6f 63 61 74 65 64 20 68 61 6e 64 e allocated hand
165d0 6c 65 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 le here */. int
165e0 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
165f0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
16600 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 Return code */.
16610 20 69 6e 74 20 69 73 54 68 72 65 61 64 73 61 66 int isThreadsaf
16620 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
16630 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 74 68 72 /* True for thr
16640 65 61 64 73 61 66 65 20 63 6f 6e 6e 65 63 74 69 eadsafe connecti
16650 6f 6e 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ons */. char *z
16660 4f 70 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 Open = 0;
16670 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 /* File
16680 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 74 6f name argument to
16690 20 70 61 73 73 20 74 6f 20 42 74 72 65 65 4f 70 pass to BtreeOp
166a0 65 6e 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a en() */. char *
166b0 7a 45 72 72 4d 73 67 20 3d 20 30 3b 20 20 20 20 zErrMsg = 0;
166c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 /* Err
166d0 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20 or message from
166e0 73 71 6c 69 74 65 33 50 61 72 73 65 55 72 69 28 sqlite3ParseUri(
166f0 29 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c ) */..#ifdef SQL
16700 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
16710 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 44 62 3d RMOR. if( ppDb=
16720 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =0 ) return SQLI
16730 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
16740 23 65 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 3d #endif. *ppDb =
16750 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 0;.#ifndef SQLI
16760 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 TE_OMIT_AUTOINIT
16770 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f . rc = sqlite3_
16780 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 initialize();.
16790 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
167a0 72 63 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a rc;.#endif.. /*
167b0 20 4f 6e 6c 79 20 61 6c 6c 6f 77 20 73 65 6e 73 Only allow sens
167c0 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e ible combination
167d0 73 20 6f 66 20 62 69 74 73 20 69 6e 20 74 68 65 s of bits in the
167e0 20 66 6c 61 67 73 20 61 72 67 75 6d 65 6e 74 2e flags argument.
167f0 20 20 0a 20 20 2a 2a 20 54 68 72 6f 77 20 61 6e . ** Throw an
16800 20 65 72 72 6f 72 20 69 66 20 61 6e 79 20 6e 6f error if any no
16810 6e 2d 73 65 6e 73 65 20 63 6f 6d 62 69 6e 61 74 n-sense combinat
16820 69 6f 6e 20 69 73 20 75 73 65 64 2e 20 20 49 66 ion is used. If
16830 20 77 65 0a 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 we. ** do not
16840 62 6c 6f 63 6b 20 69 6c 6c 65 67 61 6c 20 63 6f block illegal co
16850 6d 62 69 6e 61 74 69 6f 6e 73 20 68 65 72 65 2c mbinations here,
16860 20 69 74 20 63 6f 75 6c 64 20 74 72 69 67 67 65 it could trigge
16870 72 0a 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 r. ** assert()
16880 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 64 65 statements in de
16890 65 70 65 72 20 6c 61 79 65 72 73 2e 20 20 53 65 eper layers. Se
168a0 6e 73 69 62 6c 65 20 63 6f 6d 62 69 6e 61 74 69 nsible combinati
168b0 6f 6e 73 0a 20 20 2a 2a 20 61 72 65 3a 0a 20 20 ons. ** are:.
168c0 2a 2a 0a 20 20 2a 2a 20 20 31 3a 20 20 53 51 4c **. ** 1: SQL
168d0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
168e0 59 0a 20 20 2a 2a 20 20 32 3a 20 20 53 51 4c 49 Y. ** 2: SQLI
168f0 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
16900 45 0a 20 20 2a 2a 20 20 36 3a 20 20 53 51 4c 49 E. ** 6: SQLI
16910 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
16920 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f E | SQLITE_OPEN_
16930 43 52 45 41 54 45 0a 20 20 2a 2f 0a 20 20 61 73 CREATE. */. as
16940 73 65 72 74 28 20 53 51 4c 49 54 45 5f 4f 50 45 sert( SQLITE_OPE
16950 4e 5f 52 45 41 44 4f 4e 4c 59 20 20 3d 3d 20 30 N_READONLY == 0
16960 78 30 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 x01 );. assert(
16970 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
16980 44 57 52 49 54 45 20 3d 3d 20 30 78 30 32 20 29 DWRITE == 0x02 )
16990 3b 0a 20 20 61 73 73 65 72 74 28 20 53 51 4c 49 ;. assert( SQLI
169a0 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 20 TE_OPEN_CREATE
169b0 20 20 3d 3d 20 30 78 30 34 20 29 3b 0a 20 20 74 == 0x04 );. t
169c0 65 73 74 63 61 73 65 28 20 28 31 3c 3c 28 66 6c estcase( (1<<(fl
169d0 61 67 73 26 37 29 29 3d 3d 30 78 30 32 20 29 3b ags&7))==0x02 );
169e0 20 2f 2a 20 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a /* READONLY */.
169f0 20 20 74 65 73 74 63 61 73 65 28 20 28 31 3c 3c testcase( (1<<
16a00 28 66 6c 61 67 73 26 37 29 29 3d 3d 30 78 30 34 (flags&7))==0x04
16a10 20 29 3b 20 2f 2a 20 52 45 41 44 57 52 49 54 45 ); /* READWRITE
16a20 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 */. testcase(
16a30 28 31 3c 3c 28 66 6c 61 67 73 26 37 29 29 3d 3d (1<<(flags&7))==
16a40 30 78 34 30 20 29 3b 20 2f 2a 20 52 45 41 44 57 0x40 ); /* READW
16a50 52 49 54 45 20 7c 20 43 52 45 41 54 45 20 2a 2f RITE | CREATE */
16a60 0a 20 20 69 66 28 20 28 28 31 3c 3c 28 66 6c 61 . if( ((1<<(fla
16a70 67 73 26 37 29 29 20 26 20 30 78 34 36 29 3d 3d gs&7)) & 0x46)==
16a80 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
16a90 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
16aa0 50 54 3b 20 20 2f 2a 20 49 4d 50 3a 20 52 2d 36 PT; /* IMP: R-6
16ab0 35 34 39 37 2d 34 34 35 39 34 20 2a 2f 0a 20 20 5497-44594 */.
16ac0 7d 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 }.. if( sqlite3
16ad0 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f GlobalConfig.bCo
16ae0 72 65 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 reMutex==0 ){.
16af0 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 3d isThreadsafe =
16b00 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 0;. }else if(
16b10 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f flags & SQLITE_O
16b20 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 29 7b 0a 20 PEN_NOMUTEX ){.
16b30 20 20 20 69 73 54 68 72 65 61 64 73 61 66 65 20 isThreadsafe
16b40 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 = 0;. }else if(
16b50 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f flags & SQLITE_
16b60 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 29 OPEN_FULLMUTEX )
16b70 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 {. isThreadsa
16b80 66 65 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b fe = 1;. }else{
16b90 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 66 . isThreadsaf
16ba0 65 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 e = sqlite3Globa
16bb0 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 lConfig.bFullMut
16bc0 65 78 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c ex;. }. if( fl
16bd0 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
16be0 4e 5f 50 52 49 56 41 54 45 43 41 43 48 45 20 29 N_PRIVATECACHE )
16bf0 7b 0a 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e {. flags &= ~
16c00 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 SQLITE_OPEN_SHAR
16c10 45 44 43 41 43 48 45 3b 0a 20 20 7d 65 6c 73 65 EDCACHE;. }else
16c20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 if( sqlite3Glob
16c30 61 6c 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 43 alConfig.sharedC
16c40 61 63 68 65 45 6e 61 62 6c 65 64 20 29 7b 0a 20 acheEnabled ){.
16c50 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 flags |= SQLI
16c60 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 TE_OPEN_SHAREDCA
16c70 43 48 45 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 CHE;. }.. /* R
16c80 65 6d 6f 76 65 20 68 61 72 6d 66 75 6c 20 62 69 emove harmful bi
16c90 74 73 20 66 72 6f 6d 20 74 68 65 20 66 6c 61 67 ts from the flag
16ca0 73 20 70 61 72 61 6d 65 74 65 72 0a 20 20 2a 2a s parameter. **
16cb0 0a 20 20 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 . ** The SQLITE
16cc0 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 61 6e _OPEN_NOMUTEX an
16cd0 64 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 d SQLITE_OPEN_FU
16ce0 4c 4c 4d 55 54 45 58 20 66 6c 61 67 73 20 77 65 LLMUTEX flags we
16cf0 72 65 0a 20 20 2a 2a 20 64 65 61 6c 74 20 77 69 re. ** dealt wi
16d00 74 68 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f th in the previo
16d10 75 73 20 63 6f 64 65 20 62 6c 6f 63 6b 2e 20 20 us code block.
16d20 42 65 73 69 64 65 73 20 74 68 65 73 65 2c 20 74 Besides these, t
16d30 68 65 20 6f 6e 6c 79 0a 20 20 2a 2a 20 76 61 6c he only. ** val
16d40 69 64 20 69 6e 70 75 74 20 66 6c 61 67 73 20 66 id input flags f
16d50 6f 72 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f or sqlite3_open_
16d60 76 32 28 29 20 61 72 65 20 53 51 4c 49 54 45 5f v2() are SQLITE_
16d70 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 0a 20 OPEN_READONLY,.
16d80 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ** SQLITE_OPEN_
16d90 52 45 41 44 57 52 49 54 45 2c 20 53 51 4c 49 54 READWRITE, SQLIT
16da0 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 53 E_OPEN_CREATE, S
16db0 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 45 QLITE_OPEN_SHARE
16dc0 44 43 41 43 48 45 2c 0a 20 20 2a 2a 20 53 51 4c DCACHE,. ** SQL
16dd0 49 54 45 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 ITE_OPEN_PRIVATE
16de0 43 41 43 48 45 2c 20 61 6e 64 20 73 6f 6d 65 20 CACHE, and some
16df0 72 65 73 65 72 76 65 64 20 62 69 74 73 2e 20 20 reserved bits.
16e00 53 69 6c 65 6e 74 6c 79 20 6d 61 73 6b 0a 20 20 Silently mask.
16e10 2a 2a 20 6f 66 66 20 61 6c 6c 20 6f 74 68 65 72 ** off all other
16e20 20 66 6c 61 67 73 2e 0a 20 20 2a 2f 0a 20 20 66 flags.. */. f
16e30 6c 61 67 73 20 26 3d 20 20 7e 28 20 53 51 4c 49 lags &= ~( SQLI
16e40 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e TE_OPEN_DELETEON
16e50 43 4c 4f 53 45 20 7c 0a 20 20 20 20 20 20 20 20 CLOSE |.
16e60 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
16e70 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 0a 20 EN_EXCLUSIVE |.
16e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
16e90 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 LITE_OPEN_MAIN_D
16ea0 42 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 B |.
16eb0 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 SQLITE_OPEN_T
16ec0 45 4d 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 20 EMP_DB | .
16ed0 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
16ee0 4f 50 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 OPEN_TRANSIENT_D
16ef0 42 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 B | .
16f00 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
16f10 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a MAIN_JOURNAL | .
16f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
16f30 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f QLITE_OPEN_TEMP_
16f40 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 JOURNAL | .
16f50 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
16f60 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c _OPEN_SUBJOURNAL
16f70 20 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 | .
16f80 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d SQLITE_OPEN_M
16f90 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a ASTER_JOURNAL |.
16fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
16fb0 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 QLITE_OPEN_NOMUT
16fc0 45 58 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 EX |.
16fd0 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
16fe0 46 55 4c 4c 4d 55 54 45 58 20 7c 0a 20 20 20 20 FULLMUTEX |.
16ff0 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
17000 45 5f 4f 50 45 4e 5f 57 41 4c 0a 20 20 20 20 20 E_OPEN_WAL.
17010 20 20 20 20 20 20 20 20 29 3b 0a 0a 20 20 2f 2a );.. /*
17020 20 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 Allocate the sq
17030 6c 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 lite data struct
17040 75 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 ure */. db = sq
17050 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 lite3MallocZero(
17060 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 sizeof(sqlite3)
17070 20 29 3b 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 );. if( db==0
17080 29 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 ) goto opendb_ou
17090 74 3b 0a 20 20 69 66 28 20 69 73 54 68 72 65 61 t;. if( isThrea
170a0 64 73 61 66 65 20 29 7b 0a 20 20 20 20 64 62 2d dsafe ){. db-
170b0 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 >mutex = sqlite3
170c0 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
170d0 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49 56 E_MUTEX_RECURSIV
170e0 45 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e E);. if( db->
170f0 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 mutex==0 ){.
17100 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 sqlite3_free(d
17110 62 29 3b 0a 20 20 20 20 20 20 64 62 20 3d 20 30 b);. db = 0
17120 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 ;. goto ope
17130 6e 64 62 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 ndb_out;. }.
17140 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
17150 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
17160 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 ex);. db->errMa
17170 73 6b 20 3d 20 30 78 66 66 3b 0a 20 20 64 62 2d sk = 0xff;. db-
17180 3e 6e 44 62 20 3d 20 32 3b 0a 20 20 64 62 2d 3e >nDb = 2;. db->
17190 6d 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d magic = SQLITE_M
171a0 41 47 49 43 5f 42 55 53 59 3b 0a 20 20 64 62 2d AGIC_BUSY;. db-
171b0 3e 61 44 62 20 3d 20 64 62 2d 3e 61 44 62 53 74 >aDb = db->aDbSt
171c0 61 74 69 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 atic;.. assert(
171d0 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 6d sizeof(db->aLim
171e0 69 74 29 3d 3d 73 69 7a 65 6f 66 28 61 48 61 72 it)==sizeof(aHar
171f0 64 4c 69 6d 69 74 29 20 29 3b 0a 20 20 6d 65 6d dLimit) );. mem
17200 63 70 79 28 64 62 2d 3e 61 4c 69 6d 69 74 2c 20 cpy(db->aLimit,
17210 61 48 61 72 64 4c 69 6d 69 74 2c 20 73 69 7a 65 aHardLimit, size
17220 6f 66 28 64 62 2d 3e 61 4c 69 6d 69 74 29 29 3b of(db->aLimit));
17230 0a 20 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 . db->aLimit[SQ
17240 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 LITE_LIMIT_WORKE
17250 52 5f 54 48 52 45 41 44 53 5d 20 3d 20 53 51 4c R_THREADS] = SQL
17260 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b ITE_DEFAULT_WORK
17270 45 52 5f 54 48 52 45 41 44 53 3b 0a 20 20 64 62 ER_THREADS;. db
17280 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 ->autoCommit = 1
17290 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 41 75 74 6f ;. db->nextAuto
172a0 76 61 63 20 3d 20 2d 31 3b 0a 20 20 64 62 2d 3e vac = -1;. db->
172b0 73 7a 4d 6d 61 70 20 3d 20 73 71 6c 69 74 65 33 szMmap = sqlite3
172c0 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4d GlobalConfig.szM
172d0 6d 61 70 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 50 map;. db->nextP
172e0 61 67 65 73 69 7a 65 20 3d 20 30 3b 0a 20 20 64 agesize = 0;. d
172f0 62 2d 3e 6e 4d 61 78 53 6f 72 74 65 72 4d 6d 61 b->nMaxSorterMma
17300 70 20 3d 20 30 78 37 46 46 46 46 46 46 46 3b 0a p = 0x7FFFFFFF;.
17310 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 db->flags |= S
17320 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 QLITE_ShortColNa
17330 6d 65 73 20 7c 20 53 51 4c 49 54 45 5f 45 6e 61 mes | SQLITE_Ena
17340 62 6c 65 54 72 69 67 67 65 72 20 7c 20 53 51 4c bleTrigger | SQL
17350 49 54 45 5f 43 61 63 68 65 53 70 69 6c 6c 0a 23 ITE_CacheSpill.#
17360 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
17370 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 4d TE_DEFAULT_AUTOM
17380 41 54 49 43 5f 49 4e 44 45 58 29 20 7c 7c 20 53 ATIC_INDEX) || S
17390 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 QLITE_DEFAULT_AU
173a0 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 0a 20 20 TOMATIC_INDEX.
173b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
173c0 20 53 51 4c 49 54 45 5f 41 75 74 6f 49 6e 64 65 SQLITE_AutoInde
173d0 78 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c x.#endif.#if SQL
173e0 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 4b 50 54 ITE_DEFAULT_CKPT
173f0 46 55 4c 4c 46 53 59 4e 43 0a 20 20 20 20 20 20 FULLFSYNC.
17400 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c | SQL
17410 49 54 45 5f 43 6b 70 74 46 75 6c 6c 46 53 79 6e ITE_CkptFullFSyn
17420 63 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c c.#endif.#if SQL
17430 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 ITE_DEFAULT_FILE
17440 5f 46 4f 52 4d 41 54 3c 34 0a 20 20 20 20 20 20 _FORMAT<4.
17450 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 4c | SQL
17460 49 54 45 5f 4c 65 67 61 63 79 46 69 6c 65 46 6d ITE_LegacyFileFm
17470 74 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 t.#endif.#ifdef
17480 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f SQLITE_ENABLE_LO
17490 41 44 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 20 AD_EXTENSION.
174a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
174b0 53 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 6e SQLITE_LoadExten
174c0 73 69 6f 6e 0a 23 65 6e 64 69 66 0a 23 69 66 20 sion.#endif.#if
174d0 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 SQLITE_DEFAULT_R
174e0 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 45 52 ECURSIVE_TRIGGER
174f0 53 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 S.
17500 20 20 20 7c 20 53 51 4c 49 54 45 5f 52 65 63 54 | SQLITE_RecT
17510 72 69 67 67 65 72 73 0a 23 65 6e 64 69 66 0a 23 riggers.#endif.#
17520 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
17530 45 5f 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 47 E_DEFAULT_FOREIG
17540 4e 5f 4b 45 59 53 29 20 26 26 20 53 51 4c 49 54 N_KEYS) && SQLIT
17550 45 5f 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 47 E_DEFAULT_FOREIG
17560 4e 5f 4b 45 59 53 0a 20 20 20 20 20 20 20 20 20 N_KEYS.
17570 20 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 | SQLITE
17580 5f 46 6f 72 65 69 67 6e 4b 65 79 73 0a 23 65 6e _ForeignKeys.#en
17590 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 dif.#if defined(
175a0 53 51 4c 49 54 45 5f 52 45 56 45 52 53 45 5f 55 SQLITE_REVERSE_U
175b0 4e 4f 52 44 45 52 45 44 5f 53 45 4c 45 43 54 53 NORDERED_SELECTS
175c0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
175d0 20 20 20 7c 20 53 51 4c 49 54 45 5f 52 65 76 65 | SQLITE_Reve
175e0 72 73 65 4f 72 64 65 72 0a 23 65 6e 64 69 66 0a rseOrder.#endif.
175f0 20 20 20 20 20 20 3b 0a 20 20 73 71 6c 69 74 65 ;. sqlite
17600 33 48 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 61 3HashInit(&db->a
17610 43 6f 6c 6c 53 65 71 29 3b 0a 23 69 66 6e 64 65 CollSeq);.#ifnde
17620 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
17630 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 73 71 6c RTUALTABLE. sql
17640 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 62 ite3HashInit(&db
17650 2d 3e 61 4d 6f 64 75 6c 65 29 3b 0a 23 65 6e 64 ->aModule);.#end
17660 69 66 0a 0a 20 20 2f 2a 20 41 64 64 20 74 68 65 if.. /* Add the
17670 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 default collati
17680 6f 6e 20 73 65 71 75 65 6e 63 65 20 42 49 4e 41 on sequence BINA
17690 52 59 2e 20 42 49 4e 41 52 59 20 77 6f 72 6b 73 RY. BINARY works
176a0 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38 0a for both UTF-8.
176b0 20 20 2a 2a 20 61 6e 64 20 55 54 46 2d 31 36 2c ** and UTF-16,
176c0 20 73 6f 20 61 64 64 20 61 20 76 65 72 73 69 6f so add a versio
176d0 6e 20 66 6f 72 20 65 61 63 68 20 74 6f 20 61 76 n for each to av
176e0 6f 69 64 20 61 6e 79 20 75 6e 6e 65 63 65 73 73 oid any unnecess
176f0 61 72 79 0a 20 20 2a 2a 20 63 6f 6e 76 65 72 73 ary. ** convers
17700 69 6f 6e 73 2e 20 54 68 65 20 6f 6e 6c 79 20 65 ions. The only e
17710 72 72 6f 72 20 74 68 61 74 20 63 61 6e 20 6f 63 rror that can oc
17720 63 75 72 20 68 65 72 65 20 69 73 20 61 20 6d 61 cur here is a ma
17730 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2e 0a lloc() failure..
17740 20 20 2a 2a 0a 20 20 2a 2a 20 45 56 49 44 45 4e **. ** EVIDEN
17750 43 45 2d 4f 46 3a 20 52 2d 35 32 37 38 36 2d 34 CE-OF: R-52786-4
17760 34 38 37 38 20 53 51 4c 69 74 65 20 64 65 66 69 4878 SQLite defi
17770 6e 65 73 20 74 68 72 65 65 20 62 75 69 6c 74 2d nes three built-
17780 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 0a 20 20 2a in collating. *
17790 2a 20 66 75 6e 63 74 69 6f 6e 73 3a 0a 20 20 2a * functions:. *
177a0 2f 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 /. createCollat
177b0 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 ion(db, "BINARY"
177c0 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 , SQLITE_UTF8, 0
177d0 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 , binCollFunc, 0
177e0 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 );. createColla
177f0 74 69 6f 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 tion(db, "BINARY
17800 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 ", SQLITE_UTF16B
17810 45 2c 20 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e E, 0, binCollFun
17820 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 74 65 43 c, 0);. createC
17830 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 42 49 ollation(db, "BI
17840 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f 55 54 NARY", SQLITE_UT
17850 46 31 36 4c 45 2c 20 30 2c 20 62 69 6e 43 6f 6c F16LE, 0, binCol
17860 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 lFunc, 0);. cre
17870 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c ateCollation(db,
17880 20 22 4e 4f 43 41 53 45 22 2c 20 53 51 4c 49 54 "NOCASE", SQLIT
17890 45 5f 55 54 46 38 2c 20 30 2c 20 6e 6f 63 61 73 E_UTF8, 0, nocas
178a0 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 2c 20 eCollatingFunc,
178b0 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 0);. createColl
178c0 61 74 69 6f 6e 28 64 62 2c 20 22 52 54 52 49 4d ation(db, "RTRIM
178d0 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 ", SQLITE_UTF8,
178e0 28 76 6f 69 64 2a 29 31 2c 20 62 69 6e 43 6f 6c (void*)1, binCol
178f0 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 lFunc, 0);. if(
17900 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
17910 64 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 d ){. goto op
17920 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 endb_out;. }.
17930 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
17940 52 2d 30 38 33 30 38 2d 31 37 32 32 34 20 54 68 R-08308-17224 Th
17950 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 e default collat
17960 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 ing function for
17970 20 61 6c 6c 0a 20 20 2a 2a 20 73 74 72 69 6e 67 all. ** string
17980 73 20 69 73 20 42 49 4e 41 52 59 2e 20 0a 20 20 s is BINARY. .
17990 2a 2f 0a 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f */. db->pDfltCo
179a0 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 ll = sqlite3Find
179b0 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 CollSeq(db, SQLI
179c0 54 45 5f 55 54 46 38 2c 20 22 42 49 4e 41 52 59 TE_UTF8, "BINARY
179d0 22 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 ", 0);. assert(
179e0 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d db->pDfltColl!=
179f0 30 20 29 3b 0a 0a 20 20 2f 2a 20 50 61 72 73 65 0 );.. /* Parse
17a00 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 2f 55 52 the filename/UR
17a10 49 20 61 72 67 75 6d 65 6e 74 2e 20 2a 2f 0a 20 I argument. */.
17a20 20 64 62 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 3d db->openFlags =
17a30 20 66 6c 61 67 73 3b 0a 20 20 72 63 20 3d 20 73 flags;. rc = s
17a40 71 6c 69 74 65 33 50 61 72 73 65 55 72 69 28 7a qlite3ParseUri(z
17a50 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 Vfs, zFilename,
17a60 26 66 6c 61 67 73 2c 20 26 64 62 2d 3e 70 56 66 &flags, &db->pVf
17a70 73 2c 20 26 7a 4f 70 65 6e 2c 20 26 7a 45 72 72 s, &zOpen, &zErr
17a80 4d 73 67 29 3b 0a 20 20 69 66 28 20 72 63 21 3d Msg);. if( rc!=
17a90 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
17aa0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
17ab0 4e 4f 4d 45 4d 20 29 20 64 62 2d 3e 6d 61 6c 6c NOMEM ) db->mall
17ac0 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20 ocFailed = 1;.
17ad0 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 sqlite3ErrorWi
17ae0 74 68 4d 73 67 28 64 62 2c 20 72 63 2c 20 7a 45 thMsg(db, rc, zE
17af0 72 72 4d 73 67 20 3f 20 22 25 73 22 20 3a 20 30 rrMsg ? "%s" : 0
17b00 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 , zErrMsg);.
17b10 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72 sqlite3_free(zEr
17b20 72 4d 73 67 29 3b 0a 20 20 20 20 67 6f 74 6f 20 rMsg);. goto
17b30 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a opendb_out;. }.
17b40 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 62 . /* Open the b
17b50 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 ackend database
17b60 64 72 69 76 65 72 20 2a 2f 0a 20 20 72 63 20 3d driver */. rc =
17b70 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 sqlite3BtreeOpe
17b80 6e 28 64 62 2d 3e 70 56 66 73 2c 20 7a 4f 70 65 n(db->pVfs, zOpe
17b90 6e 2c 20 64 62 2c 20 26 64 62 2d 3e 61 44 62 5b n, db, &db->aDb[
17ba0 30 5d 2e 70 42 74 2c 20 30 2c 0a 20 20 20 20 20 0].pBt, 0,.
17bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17bc0 20 20 20 66 6c 61 67 73 20 7c 20 53 51 4c 49 54 flags | SQLIT
17bd0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 3b E_OPEN_MAIN_DB);
17be0 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
17bf0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
17c00 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 rc==SQLITE_IOERR
17c10 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 _NOMEM ){.
17c20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
17c30 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c M;. }. sql
17c40 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 ite3Error(db, rc
17c50 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e );. goto open
17c60 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 73 71 db_out;. }. sq
17c70 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
17c80 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b db->aDb[0].pBt);
17c90 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 . db->aDb[0].pS
17ca0 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 chema = sqlite3S
17cb0 63 68 65 6d 61 47 65 74 28 64 62 2c 20 64 62 2d chemaGet(db, db-
17cc0 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 >aDb[0].pBt);.
17cd0 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
17ce0 61 69 6c 65 64 20 29 20 45 4e 43 28 64 62 29 20 ailed ) ENC(db)
17cf0 3d 20 53 43 48 45 4d 41 5f 45 4e 43 28 64 62 29 = SCHEMA_ENC(db)
17d00 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
17d10 4c 65 61 76 65 28 64 62 2d 3e 61 44 62 5b 30 5d Leave(db->aDb[0]
17d20 2e 70 42 74 29 3b 0a 20 20 64 62 2d 3e 61 44 62 .pBt);. db->aDb
17d30 5b 31 5d 2e 70 53 63 68 65 6d 61 20 3d 20 73 71 [1].pSchema = sq
17d40 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74 28 64 lite3SchemaGet(d
17d50 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 b, 0);.. /* The
17d60 20 64 65 66 61 75 6c 74 20 73 61 66 65 74 79 5f default safety_
17d70 6c 65 76 65 6c 20 66 6f 72 20 74 68 65 20 6d 61 level for the ma
17d80 69 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 27 in database is '
17d90 66 75 6c 6c 27 3b 20 66 6f 72 20 74 68 65 20 74 full'; for the t
17da0 65 6d 70 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 emp. ** databas
17db0 65 20 69 74 20 69 73 20 27 4e 4f 4e 45 27 2e 20 e it is 'NONE'.
17dc0 54 68 69 73 20 6d 61 74 63 68 65 73 20 74 68 65 This matches the
17dd0 20 70 61 67 65 72 20 6c 61 79 65 72 20 64 65 66 pager layer def
17de0 61 75 6c 74 73 2e 20 20 0a 20 20 2a 2f 0a 20 20 aults. . */.
17df0 64 62 2d 3e 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 db->aDb[0].zName
17e00 20 3d 20 22 6d 61 69 6e 22 3b 0a 20 20 64 62 2d = "main";. db-
17e10 3e 61 44 62 5b 30 5d 2e 73 61 66 65 74 79 5f 6c >aDb[0].safety_l
17e20 65 76 65 6c 20 3d 20 33 3b 0a 20 20 64 62 2d 3e evel = 3;. db->
17e30 61 44 62 5b 31 5d 2e 7a 4e 61 6d 65 20 3d 20 22 aDb[1].zName = "
17e40 74 65 6d 70 22 3b 0a 20 20 64 62 2d 3e 61 44 62 temp";. db->aDb
17e50 5b 31 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c [1].safety_level
17e60 20 3d 20 31 3b 0a 0a 20 20 64 62 2d 3e 6d 61 67 = 1;.. db->mag
17e70 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 ic = SQLITE_MAGI
17e80 43 5f 4f 50 45 4e 3b 0a 20 20 69 66 28 20 64 62 C_OPEN;. if( db
17e90 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
17ea0 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 {. goto opend
17eb0 62 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a b_out;. }.. /*
17ec0 20 52 65 67 69 73 74 65 72 20 61 6c 6c 20 62 75 Register all bu
17ed0 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e 73 ilt-in functions
17ee0 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 61 74 74 , but do not att
17ef0 65 6d 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 empt to read the
17f00 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 73 . ** database s
17f10 63 68 65 6d 61 20 79 65 74 2e 20 54 68 69 73 20 chema yet. This
17f20 69 73 20 64 65 6c 61 79 65 64 20 75 6e 74 69 6c is delayed until
17f30 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 the first time
17f40 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 2a the database. *
17f50 2a 20 69 73 20 61 63 63 65 73 73 65 64 2e 0a 20 * is accessed..
17f60 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 45 72 72 */. sqlite3Err
17f70 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b or(db, SQLITE_OK
17f80 29 3b 0a 20 20 73 71 6c 69 74 65 33 52 65 67 69 );. sqlite3Regi
17f90 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 74 sterBuiltinFunct
17fa0 69 6f 6e 73 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 ions(db);.. /*
17fb0 4c 6f 61 64 20 61 75 74 6f 6d 61 74 69 63 20 65 Load automatic e
17fc0 78 74 65 6e 73 69 6f 6e 73 20 2d 20 65 78 74 65 xtensions - exte
17fd0 6e 73 69 6f 6e 73 20 74 68 61 74 20 68 61 76 65 nsions that have
17fe0 20 62 65 65 6e 20 72 65 67 69 73 74 65 72 65 64 been registered
17ff0 0a 20 20 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 . ** using the
18000 73 71 6c 69 74 65 33 5f 61 75 74 6f 6d 61 74 69 sqlite3_automati
18010 63 5f 65 78 74 65 6e 73 69 6f 6e 28 29 20 41 50 c_extension() AP
18020 49 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 I.. */. rc = s
18030 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 qlite3_errcode(d
18040 62 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 b);. if( rc==SQ
18050 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 LITE_OK ){. s
18060 71 6c 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 qlite3AutoLoadEx
18070 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 20 20 tensions(db);.
18080 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 rc = sqlite3_e
18090 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 20 20 rrcode(db);.
180a0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
180b0 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 K ){. goto
180c0 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 20 20 opendb_out;.
180d0 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }. }..#ifdef SQ
180e0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 31 LITE_ENABLE_FTS1
180f0 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c . if( !db->mall
18100 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 ocFailed ){.
18110 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 extern int sqlit
18120 65 33 46 74 73 31 49 6e 69 74 28 73 71 6c 69 74 e3Fts1Init(sqlit
18130 65 33 2a 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 e3*);. rc = s
18140 71 6c 69 74 65 33 46 74 73 31 49 6e 69 74 28 64 qlite3Fts1Init(d
18150 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a b);. }.#endif..
18160 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
18170 41 42 4c 45 5f 46 54 53 32 0a 20 20 69 66 28 20 ABLE_FTS2. if(
18180 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 !db->mallocFaile
18190 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f d && rc==SQLITE_
181a0 4f 4b 20 29 7b 0a 20 20 20 20 65 78 74 65 72 6e OK ){. extern
181b0 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 32 int sqlite3Fts2
181c0 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a Init(sqlite3*);.
181d0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
181e0 46 74 73 32 49 6e 69 74 28 64 62 29 3b 0a 20 20 Fts2Init(db);.
181f0 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 }.#endif..#ifdef
18200 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
18210 54 53 33 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d TS3. if( !db->m
18220 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 allocFailed && r
18230 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
18240 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
18250 46 74 73 33 49 6e 69 74 28 64 62 29 3b 0a 20 20 Fts3Init(db);.
18260 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 }.#endif..#ifdef
18270 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 SQLITE_ENABLE_I
18280 43 55 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 CU. if( !db->ma
18290 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 llocFailed && rc
182a0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
182b0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 rc = sqlite3I
182c0 63 75 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a cuInit(db);. }.
182d0 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 #endif..#ifdef S
182e0 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 QLITE_ENABLE_RTR
182f0 45 45 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d 61 EE. if( !db->ma
18300 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 63 llocFailed && rc
18310 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 7b 0a 20 20 ==SQLITE_OK){.
18320 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 52 74 rc = sqlite3Rt
18330 72 65 65 49 6e 69 74 28 64 62 29 3b 0a 20 20 7d reeInit(db);. }
18340 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 2d 44 .#endif.. /* -D
18350 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c SQLITE_DEFAULT_L
18360 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 31 20 6d 61 OCKING_MODE=1 ma
18370 6b 65 73 20 45 58 43 4c 55 53 49 56 45 20 74 68 kes EXCLUSIVE th
18380 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e e default lockin
18390 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 2d 44 g. ** mode. -D
183a0 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c SQLITE_DEFAULT_L
183b0 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 30 20 6d 61 OCKING_MODE=0 ma
183c0 6b 65 20 4e 4f 52 4d 41 4c 20 74 68 65 20 64 65 ke NORMAL the de
183d0 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 0a 20 20 fault locking.
183e0 2a 2a 20 6d 6f 64 65 2e 20 20 44 6f 69 6e 67 20 ** mode. Doing
183f0 6e 6f 74 68 69 6e 67 20 61 74 20 61 6c 6c 20 61 nothing at all a
18400 6c 73 6f 20 6d 61 6b 65 73 20 4e 4f 52 4d 41 4c lso makes NORMAL
18410 20 74 68 65 20 64 65 66 61 75 6c 74 2e 0a 20 20 the default..
18420 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
18430 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 _DEFAULT_LOCKING
18440 5f 4d 4f 44 45 0a 20 20 64 62 2d 3e 64 66 6c 74 _MODE. db->dflt
18450 4c 6f 63 6b 4d 6f 64 65 20 3d 20 53 51 4c 49 54 LockMode = SQLIT
18460 45 5f 44 45 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e E_DEFAULT_LOCKIN
18470 47 5f 4d 4f 44 45 3b 0a 20 20 73 71 6c 69 74 65 G_MODE;. sqlite
18480 33 50 61 67 65 72 4c 6f 63 6b 69 6e 67 4d 6f 64 3PagerLockingMod
18490 65 28 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 e(sqlite3BtreePa
184a0 67 65 72 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 ger(db->aDb[0].p
184b0 42 74 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 Bt),.
184c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
184d0 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c 4f QLITE_DEFAULT_LO
184e0 43 4b 49 4e 47 5f 4d 4f 44 45 29 3b 0a 23 65 6e CKING_MODE);.#en
184f0 64 69 66 0a 0a 20 20 69 66 28 20 72 63 20 29 20 dif.. if( rc )
18500 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
18510 20 72 63 29 3b 0a 0a 20 20 2f 2a 20 45 6e 61 62 rc);.. /* Enab
18520 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 le the lookaside
18530 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 -malloc subsyste
18540 6d 20 2a 2f 0a 20 20 73 65 74 75 70 4c 6f 6f 6b m */. setupLook
18550 61 73 69 64 65 28 64 62 2c 20 30 2c 20 73 71 6c aside(db, 0, sql
18560 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
18570 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 2c 0a 20 20 .szLookaside,.
18580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18590 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
185a0 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 balConfig.nLooka
185b0 73 69 64 65 29 3b 0a 0a 20 20 73 71 6c 69 74 65 side);.. sqlite
185c0 33 5f 77 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 3_wal_autocheckp
185d0 6f 69 6e 74 28 64 62 2c 20 53 51 4c 49 54 45 5f oint(db, SQLITE_
185e0 44 45 46 41 55 4c 54 5f 57 41 4c 5f 41 55 54 4f DEFAULT_WAL_AUTO
185f0 43 48 45 43 4b 50 4f 49 4e 54 29 3b 0a 0a 6f 70 CHECKPOINT);..op
18600 65 6e 64 62 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 endb_out:. sqli
18610 74 65 33 5f 66 72 65 65 28 7a 4f 70 65 6e 29 3b te3_free(zOpen);
18620 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20 . if( db ){.
18630 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6d 75 74 assert( db->mut
18640 65 78 21 3d 30 20 7c 7c 20 69 73 54 68 72 65 61 ex!=0 || isThrea
18650 64 73 61 66 65 3d 3d 30 0a 20 20 20 20 20 20 20 dsafe==0.
18660 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c || sqlite3Gl
18670 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c obalConfig.bFull
18680 4d 75 74 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20 Mutex==0 );.
18690 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
186a0 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
186b0 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
186c0 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
186d0 20 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 assert( db!=0
186e0 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f || rc==SQLITE_NO
186f0 4d 45 4d 20 29 3b 0a 20 20 69 66 28 20 72 63 3d MEM );. if( rc=
18700 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b =SQLITE_NOMEM ){
18710 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6c 6f . sqlite3_clo
18720 73 65 28 64 62 29 3b 0a 20 20 20 20 64 62 20 3d se(db);. db =
18730 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 0;. }else if(
18740 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
18750 0a 20 20 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d . db->magic =
18760 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 53 49 SQLITE_MAGIC_SI
18770 43 4b 3b 0a 20 20 7d 0a 23 69 66 20 64 65 66 69 CK;. }.#if defi
18780 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 ned(__APPLE__) &
18790 26 20 45 4e 41 42 4c 45 5f 46 4f 52 43 45 5f 57 & ENABLE_FORCE_W
187a0 41 4c 0a 20 20 69 66 28 20 64 62 20 26 26 20 21 AL. if( db && !
187b0 72 63 20 29 7b 0a 20 20 20 20 69 66 20 28 28 30 rc ){. if ((0
187c0 20 3d 3d 20 61 63 63 65 73 73 28 22 2f 76 61 72 == access("/var
187d0 2f 64 62 2f 65 6e 61 62 6c 65 46 6f 72 63 65 57 /db/enableForceW
187e0 41 4c 22 2c 20 52 5f 4f 4b 29 29 29 20 7b 0a 23 AL", R_OK))) {.#
187f0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
18800 55 47 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 UG. fprintf
18810 28 73 74 64 65 72 72 2c 20 22 53 51 4c 69 74 65 (stderr, "SQLite
18820 20 57 41 4c 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 WAL journal_mod
18830 65 20 45 4e 41 42 4c 45 44 20 62 79 20 64 65 66 e ENABLED by def
18840 61 75 6c 74 2e 5c 6e 22 29 3b 0a 23 65 6e 64 69 ault.\n");.#endi
18850 66 0a 20 20 20 20 20 20 0a 20 20 20 20 20 20 73 f. . s
18860 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62 2c 20 qlite3_exec(db,
18870 22 70 72 61 67 6d 61 20 6a 6f 75 72 6e 61 6c 5f "pragma journal_
18880 6d 6f 64 65 3d 77 61 6c 22 2c 20 4e 55 4c 4c 2c mode=wal", NULL,
18890 20 4e 55 4c 4c 2c 20 4e 55 4c 4c 29 3b 0a 23 69 NULL, NULL);.#i
188a0 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
188b0 47 0a 2f 2f 20 20 20 20 7d 20 65 6c 73 65 20 7b G.// } else {
188c0 0a 2f 2f 20 20 20 20 20 20 66 70 72 69 6e 74 66 .// fprintf
188d0 28 73 74 64 65 72 72 2c 20 22 53 51 4c 69 74 65 (stderr, "SQLite
188e0 20 57 41 4c 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 WAL journal_mod
188f0 65 20 4e 4f 54 20 45 4e 41 42 4c 45 44 20 62 79 e NOT ENABLED by
18900 20 64 65 66 61 75 6c 74 2e 5c 6e 22 29 3b 0a 23 default.\n");.#
18910 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 7d 0a endif. }. }.
18920 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
18930 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
18940 5f 41 55 54 4f 5f 50 52 4f 46 49 4c 45 29 0a 20 _AUTO_PROFILE).
18950 20 69 66 28 20 64 62 20 26 26 20 21 72 63 20 29 if( db && !rc )
18960 7b 0a 20 20 20 20 65 6e 61 62 6c 65 41 75 74 6f {. enableAuto
18970 4c 6f 67 67 69 6e 67 28 64 62 29 3b 0a 20 20 7d Logging(db);. }
18980 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 .#endif. *ppDb
18990 3d 20 64 62 3b 0a 23 69 66 64 65 66 20 53 51 4c = db;.#ifdef SQL
189a0 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 52 52 ITE_ENABLE_SQLRR
189b0 0a 20 20 53 52 52 65 63 4f 70 65 6e 28 64 62 2c . SRRecOpen(db,
189c0 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 66 6c 61 67 zFilename, flag
189d0 73 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 s);.#endif.#ifde
189e0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
189f0 53 51 4c 4c 4f 47 0a 20 20 69 66 28 20 73 71 6c SQLLOG. if( sql
18a00 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
18a10 2e 78 53 71 6c 6c 6f 67 20 29 7b 0a 20 20 20 20 .xSqllog ){.
18a20 2f 2a 20 4f 70 65 6e 69 6e 67 20 61 20 64 62 20 /* Opening a db
18a30 68 61 6e 64 6c 65 2e 20 46 6f 75 72 74 68 20 70 handle. Fourth p
18a40 61 72 61 6d 65 74 65 72 20 69 73 20 70 61 73 73 arameter is pass
18a50 65 64 20 30 2e 20 2a 2f 0a 20 20 20 20 76 6f 69 ed 0. */. voi
18a60 64 20 2a 70 41 72 67 20 3d 20 73 71 6c 69 74 65 d *pArg = sqlite
18a70 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 3GlobalConfig.pS
18a80 71 6c 6c 6f 67 41 72 67 3b 0a 20 20 20 20 73 71 qllogArg;. sq
18a90 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
18aa0 67 2e 78 53 71 6c 6c 6f 67 28 70 41 72 67 2c 20 g.xSqllog(pArg,
18ab0 64 62 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 db, zFilename, 0
18ac0 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 );. }.#endif.
18ad0 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 return sqlite3Ap
18ae0 69 45 78 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a iExit(0, rc);.}.
18af0 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 ./*.** Open a ne
18b00 77 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c w database handl
18b10 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
18b20 33 5f 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 3_open(. const
18b30 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c char *zFilename,
18b40 20 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 . sqlite3 **pp
18b50 44 62 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 Db .){. return
18b60 6f 70 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 openDatabase(zFi
18b70 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c 0a 20 20 lename, ppDb,.
18b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18b90 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
18ba0 52 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 READWRITE | SQLI
18bb0 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 TE_OPEN_CREATE,
18bc0 30 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 0);.}.int sqlite
18bd0 33 5f 6f 70 65 6e 5f 76 32 28 0a 20 20 63 6f 6e 3_open_v2(. con
18be0 73 74 20 63 68 61 72 20 2a 66 69 6c 65 6e 61 6d st char *filenam
18bf0 65 2c 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 e, /* Database
18c00 20 66 69 6c 65 6e 61 6d 65 20 28 55 54 46 2d 38 filename (UTF-8
18c10 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a ) */. sqlite3 *
18c20 2a 70 70 44 62 2c 20 20 20 20 20 20 20 20 20 2f *ppDb, /
18c30 2a 20 4f 55 54 3a 20 53 51 4c 69 74 65 20 64 62 * OUT: SQLite db
18c40 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 handle */. int
18c50 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 flags,
18c60 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 2a 2f /* Flags */
18c70 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
18c80 56 66 73 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 Vfs /* Na
18c90 6d 65 20 6f 66 20 56 46 53 20 6d 6f 64 75 6c 65 me of VFS module
18ca0 20 74 6f 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 to use */.){.
18cb0 72 65 74 75 72 6e 20 6f 70 65 6e 44 61 74 61 62 return openDatab
18cc0 61 73 65 28 66 69 6c 65 6e 61 6d 65 2c 20 70 70 ase(filename, pp
18cd0 44 62 2c 20 28 75 6e 73 69 67 6e 65 64 20 69 6e Db, (unsigned in
18ce0 74 29 66 6c 61 67 73 2c 20 7a 56 66 73 29 3b 0a t)flags, zVfs);.
18cf0 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
18d00 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a E_OMIT_UTF16./*.
18d10 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 ** Open a new da
18d20 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a tabase handle..*
18d30 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 /.int sqlite3_op
18d40 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76 6f en16(. const vo
18d50 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a id *zFilename, .
18d60 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 sqlite3 **ppDb
18d70 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 .){. char const
18d80 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20 20 *zFilename8;
18d90 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e 63 /* zFilename enc
18da0 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69 6e oded in UTF-8 in
18db0 73 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36 20 stead of UTF-16
18dc0 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c */. sqlite3_val
18dd0 75 65 20 2a 70 56 61 6c 3b 0a 20 20 69 6e 74 20 ue *pVal;. int
18de0 72 63 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 rc;..#ifdef SQLI
18df0 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
18e00 4d 4f 52 0a 20 20 69 66 28 20 70 70 44 62 3d 3d MOR. if( ppDb==
18e10 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 0 ) return SQLIT
18e20 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
18e30 65 6e 64 69 66 0a 20 20 2a 70 70 44 62 20 3d 20 endif. *ppDb =
18e40 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 0;.#ifndef SQLIT
18e50 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a E_OMIT_AUTOINIT.
18e60 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 69 rc = sqlite3_i
18e70 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 20 20 69 nitialize();. i
18e80 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
18e90 63 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 c;.#endif. if(
18ea0 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 29 20 7a zFilename==0 ) z
18eb0 46 69 6c 65 6e 61 6d 65 20 3d 20 22 5c 30 30 30 Filename = "\000
18ec0 5c 30 30 30 22 3b 0a 20 20 70 56 61 6c 20 3d 20 \000";. pVal =
18ed0 73 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 sqlite3ValueNew(
18ee0 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 0);. sqlite3Val
18ef0 75 65 53 65 74 53 74 72 28 70 56 61 6c 2c 20 2d ueSetStr(pVal, -
18f00 31 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 53 51 1, zFilename, SQ
18f10 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
18f20 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 , SQLITE_STATIC)
18f30 3b 0a 20 20 7a 46 69 6c 65 6e 61 6d 65 38 20 3d ;. zFilename8 =
18f40 20 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 78 sqlite3ValueTex
18f50 74 28 70 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 t(pVal, SQLITE_U
18f60 54 46 38 29 3b 0a 20 20 69 66 28 20 7a 46 69 6c TF8);. if( zFil
18f70 65 6e 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 ename8 ){. rc
18f80 20 3d 20 6f 70 65 6e 44 61 74 61 62 61 73 65 28 = openDatabase(
18f90 7a 46 69 6c 65 6e 61 6d 65 38 2c 20 70 70 44 62 zFilename8, ppDb
18fa0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
18fb0 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
18fc0 50 45 4e 5f 52 45 41 44 57 52 49 54 45 20 7c 20 PEN_READWRITE |
18fd0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 SQLITE_OPEN_CREA
18fe0 54 45 2c 20 30 29 3b 0a 20 20 20 20 61 73 73 65 TE, 0);. asse
18ff0 72 74 28 20 2a 70 70 44 62 20 7c 7c 20 72 63 3d rt( *ppDb || rc=
19000 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b =SQLITE_NOMEM );
19010 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
19020 49 54 45 5f 4f 4b 20 26 26 20 21 44 62 48 61 73 ITE_OK && !DbHas
19030 50 72 6f 70 65 72 74 79 28 2a 70 70 44 62 2c 20 Property(*ppDb,
19040 30 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 0, DB_SchemaLoad
19050 65 64 29 20 29 7b 0a 20 20 20 20 20 20 53 43 48 ed) ){. SCH
19060 45 4d 41 5f 45 4e 43 28 2a 70 70 44 62 29 20 3d EMA_ENC(*ppDb) =
19070 20 45 4e 43 28 2a 70 70 44 62 29 20 3d 20 53 51 ENC(*ppDb) = SQ
19080 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
19090 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b ;. }. }else{
190a0 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
190b0 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71 _NOMEM;. }. sq
190c0 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 70 lite3ValueFree(p
190d0 56 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 Val);.. return
190e0 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 30 sqlite3ApiExit(0
190f0 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 , rc);.}.#endif
19100 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
19110 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
19120 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f egister a new co
19130 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
19140 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 with the databa
19150 73 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f se handle db..*/
19160 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 .int sqlite3_cre
19170 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 28 0a 20 ate_collation(.
19180 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 sqlite3* db, .
19190 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
191a0 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 me, . int enc,
191b0 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
191c0 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
191d0 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
191e0 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
191f0 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75 void*).){. retu
19200 72 6e 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 rn sqlite3_creat
19210 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 64 e_collation_v2(d
19220 62 2c 20 7a 4e 61 6d 65 2c 20 65 6e 63 2c 20 70 b, zName, enc, p
19230 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 30 Ctx, xCompare, 0
19240 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 );.}../*.** Regi
19250 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 ster a new colla
19260 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 tion sequence wi
19270 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 th the database
19280 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e handle db..*/.in
19290 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
192a0 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 0a 20 _collation_v2(.
192b0 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 sqlite3* db, .
192c0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
192d0 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 2c 20 me, . int enc,
192e0 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
192f0 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
19300 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
19310 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
19320 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 28 2a void*),. void(*
19330 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a xDel)(void*).){.
19340 20 20 69 6e 74 20 72 63 3b 0a 0a 23 69 66 64 65 int rc;..#ifde
19350 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
19360 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
19370 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
19380 65 63 6b 4f 6b 28 64 62 29 20 7c 7c 20 7a 4e 61 eckOk(db) || zNa
19390 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 me==0 ) return S
193a0 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
193b0 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 T;.#endif. sqli
193c0 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
193d0 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
193e0 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
193f0 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 63 20 cFailed );. rc
19400 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f = createCollatio
19410 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 28 75 38 n(db, zName, (u8
19420 29 65 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d )enc, pCtx, xCom
19430 70 61 72 65 2c 20 78 44 65 6c 29 3b 0a 20 20 72 pare, xDel);. r
19440 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
19450 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
19460 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
19470 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
19480 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 return rc;.}..#i
19490 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
194a0 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 T_UTF16./*.** Re
194b0 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c gister a new col
194c0 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
194d0 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
194e0 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a e handle db..*/.
194f0 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 int sqlite3_crea
19500 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a te_collation16(.
19510 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a sqlite3* db, .
19520 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 4e const void *zN
19530 61 6d 65 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 20 ame,. int enc,
19540 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 . void* pCtx,.
19550 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 int(*xCompare)(
19560 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
19570 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
19580 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 void*).){. int
19590 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
195a0 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 38 3b 0a char *zName8;.
195b0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
195c0 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a NABLE_API_ARMOR.
195d0 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
195e0 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 fetyCheckOk(db)
195f0 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 || zName==0 ) re
19600 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 turn SQLITE_MISU
19610 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a SE_BKPT;.#endif.
19620 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
19630 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
19640 3b 0a 20 20 61 73 73 65 72 74 28 20 21 64 62 2d ;. assert( !db-
19650 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b >mallocFailed );
19660 0a 20 20 7a 4e 61 6d 65 38 20 3d 20 73 71 6c 69 . zName8 = sqli
19670 74 65 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 te3Utf16to8(db,
19680 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 zName, -1, SQLIT
19690 45 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a E_UTF16NATIVE);.
196a0 20 20 69 66 28 20 7a 4e 61 6d 65 38 20 29 7b 0a if( zName8 ){.
196b0 20 20 20 20 72 63 20 3d 20 63 72 65 61 74 65 43 rc = createC
196c0 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 ollation(db, zNa
196d0 6d 65 38 2c 20 28 75 38 29 65 6e 63 2c 20 70 43 me8, (u8)enc, pC
196e0 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 30 29 tx, xCompare, 0)
196f0 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 ;. sqlite3DbF
19700 72 65 65 28 64 62 2c 20 7a 4e 61 6d 65 38 29 3b ree(db, zName8);
19710 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
19720 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 te3ApiExit(db, r
19730 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 c);. sqlite3_mu
19740 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
19750 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 tex);. return r
19760 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 c;.}.#endif /* S
19770 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
19780 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 */../*.** Regis
19790 74 65 72 20 61 20 63 6f 6c 6c 61 74 69 6f 6e 20 ter a collation
197a0 73 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 sequence factory
197b0 20 63 61 6c 6c 62 61 63 6b 20 77 69 74 68 20 74 callback with t
197c0 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 he database hand
197d0 6c 65 0a 2a 2a 20 64 62 2e 20 52 65 70 6c 61 63 le.** db. Replac
197e0 65 20 61 6e 79 20 70 72 65 76 69 6f 75 73 6c 79 e any previously
197f0 20 69 6e 73 74 61 6c 6c 65 64 20 63 6f 6c 6c 61 installed colla
19800 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 61 tion sequence fa
19810 63 74 6f 72 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ctory..*/.int sq
19820 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f lite3_collation_
19830 6e 65 65 64 65 64 28 0a 20 20 73 71 6c 69 74 65 needed(. sqlite
19840 33 20 2a 64 62 2c 20 0a 20 20 76 6f 69 64 20 2a 3 *db, . void *
19850 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 2c 20 pCollNeededArg,
19860 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 . void(*xCollNe
19870 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 eded)(void*,sqli
19880 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 te3*,int eTextRe
19890 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 0a 29 p,const char*).)
198a0 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
198b0 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
198c0 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
198d0 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
198e0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
198f0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 _MISUSE_BKPT;.#e
19900 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d ndif. sqlite3_m
19910 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
19920 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 78 43 6f utex);. db->xCo
19930 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 6f 6c 6c llNeeded = xColl
19940 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d 3e 78 43 Needed;. db->xC
19950 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 30 3b ollNeeded16 = 0;
19960 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 . db->pCollNeed
19970 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 edArg = pCollNee
19980 64 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 dedArg;. sqlite
19990 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
199a0 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
199b0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
199c0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
199d0 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a OMIT_UTF16./*.**
199e0 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c Register a coll
199f0 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 ation sequence f
19a00 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 actory callback
19a10 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
19a20 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 e handle.** db.
19a30 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 Replace any prev
19a40 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 iously installed
19a50 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
19a60 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a nce factory..*/.
19a70 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c int sqlite3_coll
19a80 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36 28 0a ation_needed16(.
19a90 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a sqlite3 *db, .
19aa0 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 void *pCollNee
19ab0 64 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 dedArg, . void(
19ac0 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 28 *xCollNeeded16)(
19ad0 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 void*,sqlite3*,i
19ae0 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 nt eTextRep,cons
19af0 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 23 69 66 64 t void*).){.#ifd
19b00 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
19b10 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
19b20 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
19b30 68 65 63 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 heckOk(db) ) ret
19b40 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
19b50 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 E_BKPT;.#endif.
19b60 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
19b70 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
19b80 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 . db->xCollNeed
19b90 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 ed = 0;. db->xC
19ba0 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 43 ollNeeded16 = xC
19bb0 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 ollNeeded16;. d
19bc0 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 b->pCollNeededAr
19bd0 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 g = pCollNeededA
19be0 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
19bf0 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
19c00 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
19c10 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
19c20 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
19c30 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 6e T_UTF16 */..#ifn
19c40 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
19c50 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a DEPRECATED./*.**
19c60 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
19c70 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 68 72 6f s now an anachro
19c80 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 20 74 6f nism. It used to
19c90 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f be used to reco
19ca0 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a 20 6d 61 ver from a.** ma
19cb0 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 2c 20 lloc() failure,
19cc0 62 75 74 20 53 51 4c 69 74 65 20 6e 6f 77 20 64 but SQLite now d
19cd0 6f 65 73 20 74 68 69 73 20 61 75 74 6f 6d 61 74 oes this automat
19ce0 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 73 ically..*/.int s
19cf0 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 qlite3_global_re
19d00 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a 20 20 72 cover(void){. r
19d10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
19d20 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
19d30 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 68 65 Test to see whe
19d40 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
19d50 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
19d60 69 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f 63 6f ion is in autoco
19d70 6d 6d 69 74 0a 2a 2a 20 6d 6f 64 65 2e 20 20 52 mmit.** mode. R
19d80 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 eturn TRUE if it
19d90 20 69 73 20 61 6e 64 20 46 41 4c 53 45 20 69 66 is and FALSE if
19da0 20 6e 6f 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 not. Autocommi
19db0 74 20 6d 6f 64 65 20 69 73 20 6f 6e 0a 2a 2a 20 t mode is on.**
19dc0 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41 75 74 by default. Aut
19dd0 6f 63 6f 6d 6d 69 74 20 69 73 20 64 69 73 61 62 ocommit is disab
19de0 6c 65 64 20 62 79 20 61 20 42 45 47 49 4e 20 73 led by a BEGIN s
19df0 74 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 65 tatement and ree
19e00 6e 61 62 6c 65 64 0a 2a 2a 20 62 79 20 74 68 65 nabled.** by the
19e10 20 6e 65 78 74 20 43 4f 4d 4d 49 54 20 6f 72 20 next COMMIT or
19e20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a 2f 0a 69 6e 74 ROLLBACK..*/.int
19e30 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 sqlite3_get_aut
19e40 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 ocommit(sqlite3
19e50 2a 64 62 29 7b 0a 23 69 66 64 65 66 20 53 51 4c *db){.#ifdef SQL
19e60 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 ITE_ENABLE_API_A
19e70 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69 RMOR. if( !sqli
19e80 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
19e90 28 64 62 29 20 29 7b 0a 20 20 20 20 28 76 6f 69 (db) ){. (voi
19ea0 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f d)SQLITE_MISUSE_
19eb0 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e BKPT;. return
19ec0 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 0;. }.#endif.
19ed0 20 72 65 74 75 72 6e 20 64 62 2d 3e 61 75 74 6f return db->auto
19ee0 43 6f 6d 6d 69 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Commit;.}../*.**
19ef0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 The following r
19f00 6f 75 74 69 6e 65 73 20 61 72 65 20 73 75 62 73 outines are subs
19f10 74 69 74 75 74 65 73 20 66 6f 72 20 63 6f 6e 73 titutes for cons
19f20 74 61 6e 74 73 20 53 51 4c 49 54 45 5f 43 4f 52 tants SQLITE_COR
19f30 52 55 50 54 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f RUPT,.** SQLITE_
19f40 4d 49 53 55 53 45 2c 20 53 51 4c 49 54 45 5f 43 MISUSE, SQLITE_C
19f50 41 4e 54 4f 50 45 4e 2c 20 53 51 4c 49 54 45 5f ANTOPEN, SQLITE_
19f60 49 4f 45 52 52 20 61 6e 64 20 70 6f 73 73 69 62 IOERR and possib
19f70 6c 79 20 6f 74 68 65 72 20 65 72 72 6f 72 0a 2a ly other error.*
19f80 2a 20 63 6f 6e 73 74 61 6e 74 73 2e 20 20 54 68 * constants. Th
19f90 65 79 20 73 65 72 76 65 20 74 77 6f 20 70 75 72 ey serve two pur
19fa0 70 6f 73 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 poses:.**.** 1
19fb0 2e 20 20 53 65 72 76 65 20 61 73 20 61 20 63 6f . Serve as a co
19fc0 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 20 74 nvenient place t
19fd0 6f 20 73 65 74 20 61 20 62 72 65 61 6b 70 6f 69 o set a breakpoi
19fe0 6e 74 20 69 6e 20 61 20 64 65 62 75 67 67 65 72 nt in a debugger
19ff0 0a 2a 2a 20 20 20 20 20 20 20 74 6f 20 64 65 74 .** to det
1a000 65 63 74 20 77 68 65 6e 20 76 65 72 73 69 6f 6e ect when version
1a010 20 65 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e error condition
1a020 73 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 s occurs..**.**
1a030 20 20 32 2e 20 20 49 6e 76 6f 6b 65 20 73 71 6c 2. Invoke sql
1a040 69 74 65 33 5f 6c 6f 67 28 29 20 74 6f 20 70 72 ite3_log() to pr
1a050 6f 76 69 64 65 20 74 68 65 20 73 6f 75 72 63 65 ovide the source
1a060 20 63 6f 64 65 20 6c 6f 63 61 74 69 6f 6e 20 77 code location w
1a070 68 65 72 65 0a 2a 2a 20 20 20 20 20 20 20 61 20 here.** a
1a080 6c 6f 77 2d 6c 65 76 65 6c 20 65 72 72 6f 72 20 low-level error
1a090 69 73 20 66 69 72 73 74 20 64 65 74 65 63 74 65 is first detecte
1a0a0 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
1a0b0 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 3CorruptError(in
1a0c0 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 73 t lineno){. tes
1a0d0 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 6c tcase( sqlite3Gl
1a0e0 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 21 obalConfig.xLog!
1a0f0 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f =0 );. sqlite3_
1a100 6c 6f 67 28 53 51 4c 49 54 45 5f 43 4f 52 52 55 log(SQLITE_CORRU
1a110 50 54 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 PT,.
1a120 20 20 22 64 61 74 61 62 61 73 65 20 63 6f 72 72 "database corr
1a130 75 70 74 69 6f 6e 20 61 74 20 6c 69 6e 65 20 25 uption at line %
1a140 64 20 6f 66 20 5b 25 2e 31 30 73 5d 22 2c 0a 20 d of [%.10s]",.
1a150 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e lin
1a160 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 74 65 33 5f eno, 20+sqlite3_
1a170 73 6f 75 72 63 65 69 64 28 29 29 3b 0a 20 20 72 sourceid());. r
1a180 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
1a190 52 55 50 54 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 RUPT;.}.int sqli
1a1a0 74 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 69 te3MisuseError(i
1a1b0 6e 74 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 74 65 nt lineno){. te
1a1c0 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 47 stcase( sqlite3G
1a1d0 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 4c 6f 67 lobalConfig.xLog
1a1e0 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 !=0 );. sqlite3
1a1f0 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 4d 49 53 55 _log(SQLITE_MISU
1a200 53 45 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 SE, .
1a210 20 20 20 22 6d 69 73 75 73 65 20 61 74 20 6c 69 "misuse at li
1a220 6e 65 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 5d ne %d of [%.10s]
1a230 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
1a240 20 6c 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c 69 lineno, 20+sqli
1a250 74 65 33 5f 73 6f 75 72 63 65 69 64 28 29 29 3b te3_sourceid());
1a260 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
1a270 5f 4d 49 53 55 53 45 3b 0a 7d 0a 69 6e 74 20 73 _MISUSE;.}.int s
1a280 71 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 qlite3CantopenEr
1a290 72 6f 72 28 69 6e 74 20 6c 69 6e 65 6e 6f 29 7b ror(int lineno){
1a2a0 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 71 6c . testcase( sql
1a2b0 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1a2c0 2e 78 4c 6f 67 21 3d 30 20 29 3b 0a 20 20 73 71 .xLog!=0 );. sq
1a2d0 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 lite3_log(SQLITE
1a2e0 5f 43 41 4e 54 4f 50 45 4e 2c 20 0a 20 20 20 20 _CANTOPEN, .
1a2f0 20 20 20 20 20 20 20 20 20 20 22 63 61 6e 6e 6f "canno
1a300 74 20 6f 70 65 6e 20 66 69 6c 65 20 61 74 20 6c t open file at l
1a310 69 6e 65 20 25 64 20 6f 66 20 5b 25 2e 31 30 73 ine %d of [%.10s
1a320 5d 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ]",.
1a330 20 20 6c 69 6e 65 6e 6f 2c 20 32 30 2b 73 71 6c lineno, 20+sql
1a340 69 74 65 33 5f 73 6f 75 72 63 65 69 64 28 29 29 ite3_sourceid())
1a350 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
1a360 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 7d 0a 0a 0a E_CANTOPEN;.}...
1a370 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
1a380 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f MIT_DEPRECATED./
1a390 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 63 *.** This is a c
1a3a0 6f 6e 76 65 6e 69 65 6e 63 65 20 72 6f 75 74 69 onvenience routi
1a3b0 6e 65 20 74 68 61 74 20 6d 61 6b 65 73 20 73 75 ne that makes su
1a3c0 72 65 20 74 68 61 74 20 61 6c 6c 20 74 68 72 65 re that all thre
1a3d0 61 64 2d 73 70 65 63 69 66 69 63 0a 2a 2a 20 64 ad-specific.** d
1a3e0 61 74 61 20 66 6f 72 20 74 68 69 73 20 74 68 72 ata for this thr
1a3f0 65 61 64 20 68 61 73 20 62 65 65 6e 20 64 65 61 ead has been dea
1a400 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 llocated..**.**
1a410 53 51 4c 69 74 65 20 6e 6f 20 6c 6f 6e 67 65 72 SQLite no longer
1a420 20 75 73 65 73 20 74 68 72 65 61 64 2d 73 70 65 uses thread-spe
1a430 63 69 66 69 63 20 64 61 74 61 20 73 6f 20 74 68 cific data so th
1a440 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f is routine is no
1a450 77 20 61 0a 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 49 w a.** no-op. I
1a460 74 20 69 73 20 72 65 74 61 69 6e 65 64 20 66 6f t is retained fo
1a470 72 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d r historical com
1a480 70 61 74 69 62 69 6c 69 74 79 2e 0a 2a 2f 0a 76 patibility..*/.v
1a490 6f 69 64 20 73 71 6c 69 74 65 33 5f 74 68 72 65 oid sqlite3_thre
1a4a0 61 64 5f 63 6c 65 61 6e 75 70 28 76 6f 69 64 29 ad_cleanup(void)
1a4b0 7b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a {.}.#endif../*.*
1a4c0 2a 20 52 65 74 75 72 6e 20 6d 65 74 61 20 69 6e * Return meta in
1a4d0 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
1a4e0 61 20 73 70 65 63 69 66 69 63 20 63 6f 6c 75 6d a specific colum
1a4f0 6e 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 n of a database
1a500 74 61 62 6c 65 2e 0a 2a 2a 20 53 65 65 20 63 6f table..** See co
1a510 6d 6d 65 6e 74 20 69 6e 20 73 71 6c 69 74 65 33 mment in sqlite3
1a520 2e 68 20 28 73 71 6c 69 74 65 2e 68 2e 69 6e 29 .h (sqlite.h.in)
1a530 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f for details..*/
1a540 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 61 62 .int sqlite3_tab
1a550 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 le_column_metada
1a560 74 61 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ta(. sqlite3 *d
1a570 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
1a580 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 /* Connection
1a590 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 handle */. cons
1a5a0 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d 65 2c t char *zDbName,
1a5b0 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1a5c0 61 73 65 20 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c ase name or NULL
1a5d0 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
1a5e0 20 2a 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 20 20 *zTableName,
1a5f0 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20 /* Table name
1a600 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
1a610 2a 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 *zColumnName,
1a620 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 /* Column name
1a630 2a 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 */. char const
1a640 2a 2a 70 7a 44 61 74 61 54 79 70 65 2c 20 20 20 **pzDataType,
1a650 20 2f 2a 20 4f 55 54 50 55 54 3a 20 44 65 63 6c /* OUTPUT: Decl
1a660 61 72 65 64 20 64 61 74 61 20 74 79 70 65 20 2a ared data type *
1a670 2f 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a /. char const *
1a680 2a 70 7a 43 6f 6c 6c 53 65 71 2c 20 20 20 20 20 *pzCollSeq,
1a690 2f 2a 20 4f 55 54 50 55 54 3a 20 43 6f 6c 6c 61 /* OUTPUT: Colla
1a6a0 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 6e 61 tion sequence na
1a6b0 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f me */. int *pNo
1a6c0 74 4e 75 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 tNull,
1a6d0 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 /* OUTPUT: T
1a6e0 72 75 65 20 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 rue if NOT NULL
1a6f0 63 6f 6e 73 74 72 61 69 6e 74 20 65 78 69 73 74 constraint exist
1a700 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 50 72 69 s */. int *pPri
1a710 6d 61 72 79 4b 65 79 2c 20 20 20 20 20 20 20 20 maryKey,
1a720 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 /* OUTPUT: Tr
1a730 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 70 61 72 ue if column par
1a740 74 20 6f 66 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 t of PK */. int
1a750 20 2a 70 41 75 74 6f 69 6e 63 20 20 20 20 20 20 *pAutoinc
1a760 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 /* OUTP
1a770 55 54 3a 20 54 72 75 65 20 69 66 20 63 6f 6c 75 UT: True if colu
1a780 6d 6e 20 69 73 20 61 75 74 6f 2d 69 6e 63 72 65 mn is auto-incre
1a790 6d 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ment */.){. int
1a7a0 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 rc;. char *zEr
1a7b0 72 4d 73 67 20 3d 20 30 3b 0a 20 20 54 61 62 6c rMsg = 0;. Tabl
1a7c0 65 20 2a 70 54 61 62 20 3d 20 30 3b 0a 20 20 43 e *pTab = 0;. C
1a7d0 6f 6c 75 6d 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b olumn *pCol = 0;
1a7e0 0a 20 20 69 6e 74 20 69 43 6f 6c 20 3d 20 30 3b . int iCol = 0;
1a7f0 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a . char const *z
1a800 44 61 74 61 54 79 70 65 20 3d 20 30 3b 0a 20 20 DataType = 0;.
1a810 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 43 6f 6c char const *zCol
1a820 6c 53 65 71 20 3d 20 30 3b 0a 20 20 69 6e 74 20 lSeq = 0;. int
1a830 6e 6f 74 6e 75 6c 6c 20 3d 20 30 3b 0a 20 20 69 notnull = 0;. i
1a840 6e 74 20 70 72 69 6d 61 72 79 6b 65 79 20 3d 20 nt primarykey =
1a850 30 3b 0a 20 20 69 6e 74 20 61 75 74 6f 69 6e 63 0;. int autoinc
1a860 20 3d 20 30 3b 0a 0a 0a 23 69 66 64 65 66 20 53 = 0;...#ifdef S
1a870 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 QLITE_ENABLE_API
1a880 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 _ARMOR. if( !sq
1a890 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
1a8a0 4f 6b 28 64 62 29 20 7c 7c 20 7a 54 61 62 6c 65 Ok(db) || zTable
1a8b0 4e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72 Name==0 ){. r
1a8c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
1a8d0 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 USE_BKPT;. }.#e
1a8e0 6e 64 69 66 0a 0a 20 20 2f 2a 20 45 6e 73 75 72 ndif.. /* Ensur
1a8f0 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 e the database s
1a900 63 68 65 6d 61 20 68 61 73 20 62 65 65 6e 20 6c chema has been l
1a910 6f 61 64 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 oaded */. sqlit
1a920 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
1a930 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c b->mutex);. sql
1a940 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c ite3BtreeEnterAl
1a950 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 l(db);. rc = sq
1a960 6c 69 74 65 33 49 6e 69 74 28 64 62 2c 20 26 7a lite3Init(db, &z
1a970 45 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 53 ErrMsg);. if( S
1a980 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a QLITE_OK!=rc ){.
1a990 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1a9a0 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4c 6f ut;. }.. /* Lo
1a9b0 63 61 74 65 20 74 68 65 20 74 61 62 6c 65 20 69 cate the table i
1a9c0 6e 20 71 75 65 73 74 69 6f 6e 20 2a 2f 0a 20 20 n question */.
1a9d0 70 54 61 62 20 3d 20 73 71 6c 69 74 65 33 46 69 pTab = sqlite3Fi
1a9e0 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a 54 61 62 ndTable(db, zTab
1a9f0 6c 65 4e 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 leName, zDbName)
1aa00 3b 0a 20 20 69 66 28 20 21 70 54 61 62 20 7c 7c ;. if( !pTab ||
1aa10 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 74 20 29 pTab->pSelect )
1aa20 7b 0a 20 20 20 20 70 54 61 62 20 3d 20 30 3b 0a {. pTab = 0;.
1aa30 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1aa40 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 ut;. }.. /* Fi
1aa50 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66 6f nd the column fo
1aa60 72 20 77 68 69 63 68 20 69 6e 66 6f 20 69 73 20 r which info is
1aa70 72 65 71 75 65 73 74 65 64 20 2a 2f 0a 20 20 69 requested */. i
1aa80 66 28 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 3d 3d f( zColumnName==
1aa90 30 20 29 7b 0a 20 20 20 20 2f 2a 20 51 75 65 72 0 ){. /* Quer
1aaa0 79 20 66 6f 72 20 65 78 69 73 74 61 6e 63 65 20 y for existance
1aab0 6f 66 20 74 61 62 6c 65 20 6f 6e 6c 79 20 2a 2f of table only */
1aac0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 66 6f . }else{. fo
1aad0 72 28 69 43 6f 6c 3d 30 3b 20 69 43 6f 6c 3c 70 r(iCol=0; iCol<p
1aae0 54 61 62 2d 3e 6e 43 6f 6c 3b 20 69 43 6f 6c 2b Tab->nCol; iCol+
1aaf0 2b 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d +){. pCol =
1ab00 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f &pTab->aCol[iCo
1ab10 6c 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d l];. if( 0=
1ab20 3d 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 =sqlite3StrICmp(
1ab30 70 43 6f 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 6f pCol->zName, zCo
1ab40 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b 0a 20 20 20 lumnName) ){.
1ab50 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1ab60 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
1ab70 28 20 69 43 6f 6c 3d 3d 70 54 61 62 2d 3e 6e 43 ( iCol==pTab->nC
1ab80 6f 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ol ){. if(
1ab90 48 61 73 52 6f 77 69 64 28 70 54 61 62 29 20 26 HasRowid(pTab) &
1aba0 26 20 73 71 6c 69 74 65 33 49 73 52 6f 77 69 64 & sqlite3IsRowid
1abb0 28 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 20 29 7b (zColumnName) ){
1abc0 0a 20 20 20 20 20 20 20 20 69 43 6f 6c 20 3d 20 . iCol =
1abd0 70 54 61 62 2d 3e 69 50 4b 65 79 3b 0a 20 20 20 pTab->iPKey;.
1abe0 20 20 20 20 20 70 43 6f 6c 20 3d 20 69 43 6f 6c pCol = iCol
1abf0 3e 3d 30 20 3f 20 26 70 54 61 62 2d 3e 61 43 6f >=0 ? &pTab->aCo
1ac00 6c 5b 69 43 6f 6c 5d 20 3a 20 30 3b 0a 20 20 20 l[iCol] : 0;.
1ac10 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1ac20 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 20 20 20 pTab = 0;.
1ac30 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f goto error_o
1ac40 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ut;. }.
1ac50 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 }. }.. /* The
1ac60 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 following block
1ac70 73 74 6f 72 65 73 20 74 68 65 20 6d 65 74 61 20 stores the meta
1ac80 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 information that
1ac90 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
1aca0 64 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 63 61 d. ** to the ca
1acb0 6c 6c 65 72 20 69 6e 20 6c 6f 63 61 6c 20 76 61 ller in local va
1acc0 72 69 61 62 6c 65 73 20 7a 44 61 74 61 54 79 70 riables zDataTyp
1acd0 65 2c 20 7a 43 6f 6c 6c 53 65 71 2c 20 6e 6f 74 e, zCollSeq, not
1ace0 6e 75 6c 6c 2c 20 70 72 69 6d 61 72 79 6b 65 79 null, primarykey
1acf0 0a 20 20 2a 2a 20 61 6e 64 20 61 75 74 6f 69 6e . ** and autoin
1ad00 63 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 c. At this point
1ad10 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 there are two p
1ad20 6f 73 73 69 62 69 6c 69 74 69 65 73 3a 0a 20 20 ossibilities:.
1ad30 2a 2a 20 0a 20 20 2a 2a 20 20 20 20 20 31 2e 20 ** . ** 1.
1ad40 54 68 65 20 73 70 65 63 69 66 69 65 64 20 63 6f The specified co
1ad50 6c 75 6d 6e 20 6e 61 6d 65 20 77 61 73 20 72 6f lumn name was ro
1ad60 77 69 64 22 2c 20 22 6f 69 64 22 20 6f 72 20 22 wid", "oid" or "
1ad70 5f 72 6f 77 69 64 5f 22 20 0a 20 20 2a 2a 20 20 _rowid_" . **
1ad80 20 20 20 20 20 20 61 6e 64 20 74 68 65 72 65 20 and there
1ad90 69 73 20 6e 6f 20 65 78 70 6c 69 63 69 74 6c 79 is no explicitly
1ada0 20 64 65 63 6c 61 72 65 64 20 49 50 4b 20 63 6f declared IPK co
1adb0 6c 75 6d 6e 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a lumn. . **. **
1adc0 20 20 20 20 20 32 2e 20 54 68 65 20 74 61 62 6c 2. The tabl
1add0 65 20 69 73 20 6e 6f 74 20 61 20 76 69 65 77 20 e is not a view
1ade0 61 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e and the column n
1adf0 61 6d 65 20 69 64 65 6e 74 69 66 69 65 64 20 61 ame identified a
1ae00 6e 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 65 n . ** e
1ae10 78 70 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 72 xplicitly declar
1ae20 65 64 20 63 6f 6c 75 6d 6e 2e 20 43 6f 70 79 20 ed column. Copy
1ae30 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
1ae40 20 66 72 6f 6d 20 2a 70 43 6f 6c 2e 0a 20 20 2a from *pCol.. *
1ae50 2f 20 0a 20 20 69 66 28 20 70 43 6f 6c 20 29 7b / . if( pCol ){
1ae60 0a 20 20 20 20 7a 44 61 74 61 54 79 70 65 20 3d . zDataType =
1ae70 20 70 43 6f 6c 2d 3e 7a 54 79 70 65 3b 0a 20 20 pCol->zType;.
1ae80 20 20 7a 43 6f 6c 6c 53 65 71 20 3d 20 70 43 6f zCollSeq = pCo
1ae90 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 20 20 20 6e 6f l->zColl;. no
1aea0 74 6e 75 6c 6c 20 3d 20 70 43 6f 6c 2d 3e 6e 6f tnull = pCol->no
1aeb0 74 4e 75 6c 6c 21 3d 30 3b 0a 20 20 20 20 70 72 tNull!=0;. pr
1aec0 69 6d 61 72 79 6b 65 79 20 20 3d 20 28 70 43 6f imarykey = (pCo
1aed0 6c 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f l->colFlags & CO
1aee0 4c 46 4c 41 47 5f 50 52 49 4d 4b 45 59 29 21 3d LFLAG_PRIMKEY)!=
1aef0 30 3b 0a 20 20 20 20 61 75 74 6f 69 6e 63 20 3d 0;. autoinc =
1af00 20 70 54 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 pTab->iPKey==iC
1af10 6f 6c 20 26 26 20 28 70 54 61 62 2d 3e 74 61 62 ol && (pTab->tab
1af20 46 6c 61 67 73 20 26 20 54 46 5f 41 75 74 6f 69 Flags & TF_Autoi
1af30 6e 63 72 65 6d 65 6e 74 29 21 3d 30 3b 0a 20 20 ncrement)!=0;.
1af40 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 44 61 74 61 }else{. zData
1af50 54 79 70 65 20 3d 20 22 49 4e 54 45 47 45 52 22 Type = "INTEGER"
1af60 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 79 ;. primarykey
1af70 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 = 1;. }. if(
1af80 21 7a 43 6f 6c 6c 53 65 71 20 29 7b 0a 20 20 20 !zCollSeq ){.
1af90 20 7a 43 6f 6c 6c 53 65 71 20 3d 20 22 42 49 4e zCollSeq = "BIN
1afa0 41 52 59 22 3b 0a 20 20 7d 0a 0a 65 72 72 6f 72 ARY";. }..error
1afb0 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 _out:. sqlite3B
1afc0 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 62 29 treeLeaveAll(db)
1afd0 3b 0a 0a 20 20 2f 2a 20 57 68 65 74 68 65 72 20 ;.. /* Whether
1afe0 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c the function cal
1aff0 6c 20 73 75 63 63 65 65 64 65 64 20 6f 72 20 66 l succeeded or f
1b000 61 69 6c 65 64 2c 20 73 65 74 20 74 68 65 20 6f ailed, set the o
1b010 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 73 utput parameters
1b020 0a 20 20 2a 2a 20 74 6f 20 77 68 61 74 65 76 65 . ** to whateve
1b030 72 20 74 68 65 69 72 20 6c 6f 63 61 6c 20 63 6f r their local co
1b040 75 6e 74 65 72 70 61 72 74 73 20 63 6f 6e 74 61 unterparts conta
1b050 69 6e 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 in. If an error
1b060 64 69 64 20 6f 63 63 75 72 2c 0a 20 20 2a 2a 20 did occur,. **
1b070 74 68 69 73 20 68 61 73 20 74 68 65 20 65 66 66 this has the eff
1b080 65 63 74 20 6f 66 20 7a 65 72 6f 69 6e 67 20 61 ect of zeroing a
1b090 6c 6c 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 ll output parame
1b0a0 74 65 72 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 ters.. */. if(
1b0b0 20 70 7a 44 61 74 61 54 79 70 65 20 29 20 2a 70 pzDataType ) *p
1b0c0 7a 44 61 74 61 54 79 70 65 20 3d 20 7a 44 61 74 zDataType = zDat
1b0d0 61 54 79 70 65 3b 0a 20 20 69 66 28 20 70 7a 43 aType;. if( pzC
1b0e0 6f 6c 6c 53 65 71 20 29 20 2a 70 7a 43 6f 6c 6c ollSeq ) *pzColl
1b0f0 53 65 71 20 3d 20 7a 43 6f 6c 6c 53 65 71 3b 0a Seq = zCollSeq;.
1b100 20 20 69 66 28 20 70 4e 6f 74 4e 75 6c 6c 20 29 if( pNotNull )
1b110 20 2a 70 4e 6f 74 4e 75 6c 6c 20 3d 20 6e 6f 74 *pNotNull = not
1b120 6e 75 6c 6c 3b 0a 20 20 69 66 28 20 70 50 72 69 null;. if( pPri
1b130 6d 61 72 79 4b 65 79 20 29 20 2a 70 50 72 69 6d maryKey ) *pPrim
1b140 61 72 79 4b 65 79 20 3d 20 70 72 69 6d 61 72 79 aryKey = primary
1b150 6b 65 79 3b 0a 20 20 69 66 28 20 70 41 75 74 6f key;. if( pAuto
1b160 69 6e 63 20 29 20 2a 70 41 75 74 6f 69 6e 63 20 inc ) *pAutoinc
1b170 3d 20 61 75 74 6f 69 6e 63 3b 0a 0a 20 20 69 66 = autoinc;.. if
1b180 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 72 63 20 ( SQLITE_OK==rc
1b190 26 26 20 21 70 54 61 62 20 29 7b 0a 20 20 20 20 && !pTab ){.
1b1a0 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 sqlite3DbFree(db
1b1b0 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 , zErrMsg);.
1b1c0 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 zErrMsg = sqlite
1b1d0 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6e 6f 3MPrintf(db, "no
1b1e0 20 73 75 63 68 20 74 61 62 6c 65 20 63 6f 6c 75 such table colu
1b1f0 6d 6e 3a 20 25 73 2e 25 73 22 2c 20 7a 54 61 62 mn: %s.%s", zTab
1b200 6c 65 4e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 leName,.
1b210 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 3b 0a 20 20 zColumnName);.
1b220 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
1b230 52 4f 52 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 ROR;. }. sqlit
1b240 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 e3ErrorWithMsg(d
1b250 62 2c 20 72 63 2c 20 28 7a 45 72 72 4d 73 67 3f b, rc, (zErrMsg?
1b260 22 25 73 22 3a 30 29 2c 20 7a 45 72 72 4d 73 67 "%s":0), zErrMsg
1b270 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 );. sqlite3DbFr
1b280 65 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b ee(db, zErrMsg);
1b290 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
1b2a0 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a piExit(db, rc);.
1b2b0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1b2c0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
1b2d0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1b2e0 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f ../*.** Sleep fo
1b2f0 72 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 r a little while
1b300 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d . Return the am
1b310 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 ount of time sle
1b320 70 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 pt..*/.int sqlit
1b330 65 33 5f 73 6c 65 65 70 28 69 6e 74 20 6d 73 29 e3_sleep(int ms)
1b340 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 {. sqlite3_vfs
1b350 2a 70 56 66 73 3b 0a 20 20 69 6e 74 20 72 63 3b *pVfs;. int rc;
1b360 0a 20 20 70 56 66 73 20 3d 20 73 71 6c 69 74 65 . pVfs = sqlite
1b370 33 5f 76 66 73 5f 66 69 6e 64 28 30 29 3b 0a 20 3_vfs_find(0);.
1b380 20 69 66 28 20 70 56 66 73 3d 3d 30 20 29 20 72 if( pVfs==0 ) r
1b390 65 74 75 72 6e 20 30 3b 0a 0a 20 20 2f 2a 20 54 eturn 0;.. /* T
1b3a0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 6f 72 his function wor
1b3b0 6b 73 20 69 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e ks in millisecon
1b3c0 64 73 2c 20 62 75 74 20 74 68 65 20 75 6e 64 65 ds, but the unde
1b3d0 72 6c 79 69 6e 67 20 4f 73 53 6c 65 65 70 28 29 rlying OsSleep()
1b3e0 20 0a 20 20 2a 2a 20 41 50 49 20 75 73 65 73 20 . ** API uses
1b3f0 6d 69 63 72 6f 73 65 63 6f 6e 64 73 2e 20 48 65 microseconds. He
1b400 6e 63 65 20 74 68 65 20 31 30 30 30 27 73 2e 0a nce the 1000's..
1b410 20 20 2a 2f 0a 20 20 72 63 20 3d 20 28 73 71 6c */. rc = (sql
1b420 69 74 65 33 4f 73 53 6c 65 65 70 28 70 56 66 73 ite3OsSleep(pVfs
1b430 2c 20 31 30 30 30 2a 6d 73 29 2f 31 30 30 30 29 , 1000*ms)/1000)
1b440 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1b450 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f ../*.** Enable o
1b460 72 20 64 69 73 61 62 6c 65 20 74 68 65 20 65 78 r disable the ex
1b470 74 65 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f tended result co
1b480 64 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 des..*/.int sqli
1b490 74 65 33 5f 65 78 74 65 6e 64 65 64 5f 72 65 73 te3_extended_res
1b4a0 75 6c 74 5f 63 6f 64 65 73 28 73 71 6c 69 74 65 ult_codes(sqlite
1b4b0 33 20 2a 64 62 2c 20 69 6e 74 20 6f 6e 6f 66 66 3 *db, int onoff
1b4c0 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
1b4d0 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f _ENABLE_API_ARMO
1b4e0 52 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 R. if( !sqlite3
1b4f0 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 SafetyCheckOk(db
1b500 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ) ) return SQLIT
1b510 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 E_MISUSE_BKPT;.#
1b520 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f endif. sqlite3_
1b530 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
1b540 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 65 72 mutex);. db->er
1b550 72 4d 61 73 6b 20 3d 20 6f 6e 6f 66 66 20 3f 20 rMask = onoff ?
1b560 30 78 66 66 66 66 66 66 66 66 20 3a 20 30 78 66 0xffffffff : 0xf
1b570 66 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 f;. sqlite3_mut
1b580 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
1b590 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ex);. return SQ
1b5a0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
1b5b0 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 78 46 69 * Invoke the xFi
1b5c0 6c 65 43 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 leControl method
1b5d0 20 6f 6e 20 61 20 70 61 72 74 69 63 75 6c 61 72 on a particular
1b5e0 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e database..*/.in
1b5f0 74 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63 t sqlite3_file_c
1b600 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 20 2a ontrol(sqlite3 *
1b610 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a db, const char *
1b620 7a 44 62 4e 61 6d 65 2c 20 69 6e 74 20 6f 70 2c zDbName, int op,
1b630 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 void *pArg){.
1b640 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
1b650 45 52 52 4f 52 3b 0a 20 20 42 74 72 65 65 20 2a ERROR;. Btree *
1b660 70 42 74 72 65 65 3b 0a 0a 23 69 66 64 65 66 20 pBtree;..#ifdef
1b670 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 SQLITE_ENABLE_AP
1b680 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 I_ARMOR. if( !s
1b690 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
1b6a0 6b 4f 6b 28 64 62 29 20 29 20 72 65 74 75 72 6e kOk(db) ) return
1b6b0 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
1b6c0 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 KPT;.#endif. sq
1b6d0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
1b6e0 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
1b6f0 70 42 74 72 65 65 20 3d 20 73 71 6c 69 74 65 33 pBtree = sqlite3
1b700 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 64 62 DbNameToBtree(db
1b710 2c 20 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 69 66 , zDbName);. if
1b720 28 20 70 42 74 72 65 65 20 29 7b 0a 20 20 20 20 ( pBtree ){.
1b730 50 61 67 65 72 20 2a 70 50 61 67 65 72 3b 0a 20 Pager *pPager;.
1b740 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 sqlite3_file
1b750 2a 66 64 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 *fd;. sqlite3
1b760 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 BtreeEnter(pBtre
1b770 65 29 3b 0a 20 20 20 20 70 50 61 67 65 72 20 3d e);. pPager =
1b780 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 sqlite3BtreePag
1b790 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 er(pBtree);.
1b7a0 61 73 73 65 72 74 28 20 70 50 61 67 65 72 21 3d assert( pPager!=
1b7b0 30 20 29 3b 0a 20 20 20 20 66 64 20 3d 20 73 71 0 );. fd = sq
1b7c0 6c 69 74 65 33 50 61 67 65 72 46 69 6c 65 28 70 lite3PagerFile(p
1b7d0 50 61 67 65 72 29 3b 0a 20 20 20 20 61 73 73 65 Pager);. asse
1b7e0 72 74 28 20 66 64 21 3d 30 20 29 3b 0a 20 20 20 rt( fd!=0 );.
1b7f0 20 69 66 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f if( op==SQLITE_
1b800 46 43 4e 54 4c 5f 46 49 4c 45 5f 50 4f 49 4e 54 FCNTL_FILE_POINT
1b810 45 52 20 29 7b 0a 20 20 20 20 20 20 2a 28 73 71 ER ){. *(sq
1b820 6c 69 74 65 33 5f 66 69 6c 65 2a 2a 29 70 41 72 lite3_file**)pAr
1b830 67 20 3d 20 66 64 3b 0a 20 20 20 20 20 20 72 63 g = fd;. rc
1b840 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1b850 20 20 7d 65 6c 73 65 20 69 66 28 20 66 64 2d 3e }else if( fd->
1b860 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 pMethods ){.
1b870 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1b880 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 66 64 2c 20 FileControl(fd,
1b890 6f 70 2c 20 70 41 72 67 29 3b 0a 23 69 66 6e 64 op, pArg);.#ifnd
1b8a0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
1b8b0 41 4c 0a 20 20 20 20 20 20 69 66 28 20 28 72 63 AL. if( (rc
1b8c0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 26 26 28 6f ==SQLITE_OK)&&(o
1b8d0 70 3d 3d 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f p==SQLITE_FCNTL_
1b8e0 4c 41 53 54 5f 45 52 52 4e 4f 29 26 26 28 2a 28 LAST_ERRNO)&&(*(
1b8f0 69 6e 74 20 2a 29 70 41 72 67 3d 3d 30 29 20 29 int *)pArg==0) )
1b900 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
1b910 33 5f 66 69 6c 65 20 2a 70 57 61 6c 46 64 20 3d 3_file *pWalFd =
1b920 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 61 6c sqlite3PagerWal
1b930 46 69 6c 65 28 70 50 61 67 65 72 29 3b 0a 20 20 File(pPager);.
1b940 20 20 20 20 20 20 69 66 28 20 70 57 61 6c 46 64 if( pWalFd
1b950 26 26 28 70 57 61 6c 46 64 2d 3e 70 4d 65 74 68 &&(pWalFd->pMeth
1b960 6f 64 73 29 20 29 7b 0a 20 20 20 20 20 20 20 20 ods) ){.
1b970 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1b980 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 70 57 61 6c FileControl(pWal
1b990 46 64 2c 20 6f 70 2c 20 70 41 72 67 29 3b 0a 20 Fd, op, pArg);.
1b9a0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
1b9b0 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 65 6c 73 .#endif. }els
1b9c0 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 e{. rc = SQ
1b9d0 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 20 LITE_NOTFOUND;.
1b9e0 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
1b9f0 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 BtreeLeave(pBtre
1ba00 65 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 e);. }. sqlite
1ba10 33 45 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 3Error(db, rc);.
1ba20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1ba30 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
1ba40 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1ba50 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 72 66 61 63 ../*.** Interfac
1ba60 65 20 74 6f 20 74 68 65 20 74 65 73 74 69 6e 67 e to the testing
1ba70 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 69 6e 74 20 73 logic..*/.int s
1ba80 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1ba90 72 6f 6c 28 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 rol(int op, ...)
1baa0 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a {. int rc = 0;.
1bab0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
1bac0 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 MIT_BUILTIN_TEST
1bad0 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 . va_list ap;.
1bae0 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20 6f 70 va_start(ap, op
1baf0 29 3b 0a 20 20 73 77 69 74 63 68 28 20 6f 70 20 );. switch( op
1bb00 29 7b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a ){.. /*. *
1bb10 2a 20 53 61 76 65 20 74 68 65 20 63 75 72 72 65 * Save the curre
1bb20 6e 74 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 nt state of the
1bb30 50 52 4e 47 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 PRNG.. */.
1bb40 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1bb50 54 43 54 52 4c 5f 50 52 4e 47 5f 53 41 56 45 3a TCTRL_PRNG_SAVE:
1bb60 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
1bb70 50 72 6e 67 53 61 76 65 53 74 61 74 65 28 29 3b PrngSaveState();
1bb80 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1bb90 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
1bba0 2a 2a 20 52 65 73 74 6f 72 65 20 74 68 65 20 73 ** Restore the s
1bbb0 74 61 74 65 20 6f 66 20 74 68 65 20 50 52 4e 47 tate of the PRNG
1bbc0 20 74 6f 20 74 68 65 20 6c 61 73 74 20 73 74 61 to the last sta
1bbd0 74 65 20 73 61 76 65 64 20 75 73 69 6e 67 0a 20 te saved using.
1bbe0 20 20 20 2a 2a 20 50 52 4e 47 5f 53 41 56 45 2e ** PRNG_SAVE.
1bbf0 20 20 49 66 20 50 52 4e 47 5f 53 41 56 45 20 68 If PRNG_SAVE h
1bc00 61 73 20 6e 65 76 65 72 20 62 65 66 6f 72 65 20 as never before
1bc10 62 65 65 6e 20 63 61 6c 6c 65 64 2c 20 74 68 65 been called, the
1bc20 6e 0a 20 20 20 20 2a 2a 20 74 68 69 73 20 76 65 n. ** this ve
1bc30 72 62 20 61 63 74 73 20 6c 69 6b 65 20 50 52 4e rb acts like PRN
1bc40 47 5f 52 45 53 45 54 2e 0a 20 20 20 20 2a 2f 0a G_RESET.. */.
1bc50 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1bc60 54 45 53 54 43 54 52 4c 5f 50 52 4e 47 5f 52 45 TESTCTRL_PRNG_RE
1bc70 53 54 4f 52 45 3a 20 7b 0a 20 20 20 20 20 20 73 STORE: {. s
1bc80 71 6c 69 74 65 33 50 72 6e 67 52 65 73 74 6f 72 qlite3PrngRestor
1bc90 65 53 74 61 74 65 28 29 3b 0a 20 20 20 20 20 20 eState();.
1bca0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
1bcb0 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 52 65 73 65 /*. ** Rese
1bcc0 74 20 74 68 65 20 50 52 4e 47 20 62 61 63 6b 20 t the PRNG back
1bcd0 74 6f 20 69 74 73 20 75 6e 69 6e 69 74 69 61 6c to its uninitial
1bce0 69 7a 65 64 20 73 74 61 74 65 2e 20 20 54 68 65 ized state. The
1bcf0 20 6e 65 78 74 20 63 61 6c 6c 0a 20 20 20 20 2a next call. *
1bd00 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 72 61 6e * to sqlite3_ran
1bd10 64 6f 6d 6e 65 73 73 28 29 20 77 69 6c 6c 20 72 domness() will r
1bd20 65 73 65 65 64 20 74 68 65 20 50 52 4e 47 20 75 eseed the PRNG u
1bd30 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 63 61 sing a single ca
1bd40 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 ll. ** to the
1bd50 20 78 52 61 6e 64 6f 6d 6e 65 73 73 20 6d 65 74 xRandomness met
1bd60 68 6f 64 20 6f 66 20 74 68 65 20 64 65 66 61 75 hod of the defau
1bd70 6c 74 20 56 46 53 2e 0a 20 20 20 20 2a 2f 0a 20 lt VFS.. */.
1bd80 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
1bd90 45 53 54 43 54 52 4c 5f 50 52 4e 47 5f 52 45 53 ESTCTRL_PRNG_RES
1bda0 45 54 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 ET: {. sqli
1bdb0 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 30 te3_randomness(0
1bdc0 2c 30 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b ,0);. break
1bdd0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a ;. }.. /*.
1bde0 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
1bdf0 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 49 54 test_control(BIT
1be00 56 45 43 5f 54 45 53 54 2c 20 73 69 7a 65 2c 20 VEC_TEST, size,
1be10 70 72 6f 67 72 61 6d 29 0a 20 20 20 20 2a 2a 0a program). **.
1be20 20 20 20 20 2a 2a 20 52 75 6e 20 61 20 74 65 73 ** Run a tes
1be30 74 20 61 67 61 69 6e 73 74 20 61 20 42 69 74 76 t against a Bitv
1be40 65 63 20 6f 62 6a 65 63 74 20 6f 66 20 73 69 7a ec object of siz
1be50 65 2e 20 20 54 68 65 20 70 72 6f 67 72 61 6d 20 e. The program
1be60 61 72 67 75 6d 65 6e 74 0a 20 20 20 20 2a 2a 20 argument. **
1be70 69 73 20 61 6e 20 61 72 72 61 79 20 6f 66 20 69 is an array of i
1be80 6e 74 65 67 65 72 73 20 74 68 61 74 20 64 65 66 ntegers that def
1be90 69 6e 65 73 20 74 68 65 20 74 65 73 74 2e 20 20 ines the test.
1bea0 52 65 74 75 72 6e 20 2d 31 20 6f 6e 20 61 0a 20 Return -1 on a.
1beb0 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 20 61 6c 6c ** memory all
1bec0 6f 63 61 74 69 6f 6e 20 65 72 72 6f 72 2c 20 30 ocation error, 0
1bed0 20 6f 6e 20 73 75 63 63 65 73 73 2c 20 6f 72 20 on success, or
1bee0 6e 6f 6e 2d 7a 65 72 6f 20 66 6f 72 20 61 6e 20 non-zero for an
1bef0 65 72 72 6f 72 2e 0a 20 20 20 20 2a 2a 20 53 65 error.. ** Se
1bf00 65 20 74 68 65 20 73 71 6c 69 74 65 33 42 69 74 e the sqlite3Bit
1bf10 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 28 29 vecBuiltinTest()
1bf20 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 for additional
1bf30 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20 20 20 information..
1bf40 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
1bf50 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 49 54 ITE_TESTCTRL_BIT
1bf60 56 45 43 5f 54 45 53 54 3a 20 7b 0a 20 20 20 20 VEC_TEST: {.
1bf70 20 20 69 6e 74 20 73 7a 20 3d 20 76 61 5f 61 72 int sz = va_ar
1bf80 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 g(ap, int);.
1bf90 20 20 69 6e 74 20 2a 61 50 72 6f 67 20 3d 20 76 int *aProg = v
1bfa0 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 2a 29 3b a_arg(ap, int*);
1bfb0 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
1bfc0 74 65 33 42 69 74 76 65 63 42 75 69 6c 74 69 6e te3BitvecBuiltin
1bfd0 54 65 73 74 28 73 7a 2c 20 61 50 72 6f 67 29 3b Test(sz, aProg);
1bfe0 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
1bff0 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 }.. /*.
1c000 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 ** sqlite3_test
1c010 5f 63 6f 6e 74 72 6f 6c 28 46 41 55 4c 54 5f 49 _control(FAULT_I
1c020 4e 53 54 41 4c 4c 2c 20 78 43 61 6c 6c 62 61 63 NSTALL, xCallbac
1c030 6b 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a k). **. **
1c040 20 41 72 72 61 6e 67 65 20 74 6f 20 69 6e 76 6f Arrange to invo
1c050 6b 65 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 77 ke xCallback() w
1c060 68 65 6e 65 76 65 72 20 73 71 6c 69 74 65 33 46 henever sqlite3F
1c070 61 75 6c 74 53 69 6d 28 29 20 69 73 20 63 61 6c aultSim() is cal
1c080 6c 65 64 2c 0a 20 20 20 20 2a 2a 20 69 66 20 78 led,. ** if x
1c090 43 61 6c 6c 62 61 63 6b 20 69 73 20 6e 6f 74 20 Callback is not
1c0a0 4e 55 4c 4c 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 NULL.. **.
1c0b0 20 2a 2a 20 41 73 20 61 20 74 65 73 74 20 6f 66 ** As a test of
1c0c0 20 74 68 65 20 66 61 75 6c 74 20 73 69 6d 75 6c the fault simul
1c0d0 61 74 6f 72 20 6d 65 63 68 61 6e 69 73 6d 20 69 ator mechanism i
1c0e0 74 73 65 6c 66 2c 20 73 71 6c 69 74 65 33 46 61 tself, sqlite3Fa
1c0f0 75 6c 74 53 69 6d 28 30 29 0a 20 20 20 20 2a 2a ultSim(0). **
1c100 20 69 73 20 63 61 6c 6c 65 64 20 69 6d 6d 65 64 is called immed
1c110 69 61 74 65 6c 79 20 61 66 74 65 72 20 69 6e 73 iately after ins
1c120 74 61 6c 6c 69 6e 67 20 74 68 65 20 6e 65 77 20 talling the new
1c130 63 61 6c 6c 62 61 63 6b 20 61 6e 64 20 74 68 65 callback and the
1c140 20 72 65 74 75 72 6e 0a 20 20 20 20 2a 2a 20 76 return. ** v
1c150 61 6c 75 65 20 66 72 6f 6d 20 73 71 6c 69 74 65 alue from sqlite
1c160 33 46 61 75 6c 74 53 69 6d 28 30 29 20 62 65 63 3FaultSim(0) bec
1c170 6f 6d 65 73 20 74 68 65 20 72 65 74 75 72 6e 20 omes the return
1c180 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 73 71 6c 69 from. ** sqli
1c190 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1c1a0 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 ().. */. c
1c1b0 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1c1c0 54 52 4c 5f 46 41 55 4c 54 5f 49 4e 53 54 41 4c TRL_FAULT_INSTAL
1c1d0 4c 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 4d 53 L: {. /* MS
1c1e0 56 43 20 69 73 20 70 69 63 6b 79 20 61 62 6f 75 VC is picky abou
1c1f0 74 20 70 75 6c 6c 69 6e 67 20 66 75 6e 63 20 70 t pulling func p
1c200 74 72 73 20 66 72 6f 6d 20 76 61 20 6c 69 73 74 trs from va list
1c210 73 2e 0a 20 20 20 20 20 20 2a 2a 20 68 74 74 70 s.. ** http
1c220 3a 2f 2f 73 75 70 70 6f 72 74 2e 6d 69 63 72 6f ://support.micro
1c230 73 6f 66 74 2e 63 6f 6d 2f 6b 62 2f 34 37 39 36 soft.com/kb/4796
1c240 31 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 1. ** sqlit
1c250 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 78 e3GlobalConfig.x
1c260 54 65 73 74 43 61 6c 6c 62 61 63 6b 20 3d 20 76 TestCallback = v
1c270 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 28 2a 29 a_arg(ap, int(*)
1c280 28 69 6e 74 29 29 3b 0a 20 20 20 20 20 20 2a 2f (int));. */
1c290 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 20 69 . typedef i
1c2a0 6e 74 28 2a 54 45 53 54 43 41 4c 4c 42 41 43 4b nt(*TESTCALLBACK
1c2b0 46 55 4e 43 5f 74 29 28 69 6e 74 29 3b 0a 20 20 FUNC_t)(int);.
1c2c0 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1c2d0 6c 43 6f 6e 66 69 67 2e 78 54 65 73 74 43 61 6c lConfig.xTestCal
1c2e0 6c 62 61 63 6b 20 3d 20 76 61 5f 61 72 67 28 61 lback = va_arg(a
1c2f0 70 2c 20 54 45 53 54 43 41 4c 4c 42 41 43 4b 46 p, TESTCALLBACKF
1c300 55 4e 43 5f 74 29 3b 0a 20 20 20 20 20 20 72 63 UNC_t);. rc
1c310 20 3d 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 = sqlite3FaultS
1c320 69 6d 28 30 29 3b 0a 20 20 20 20 20 20 62 72 65 im(0);. bre
1c330 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ak;. }.. /
1c340 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 *. ** sqlite
1c350 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 3_test_control(B
1c360 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f ENIGN_MALLOC_HOO
1c370 4b 53 2c 20 78 42 65 67 69 6e 2c 20 78 45 6e 64 KS, xBegin, xEnd
1c380 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 ). **. **
1c390 52 65 67 69 73 74 65 72 20 68 6f 6f 6b 73 20 74 Register hooks t
1c3a0 6f 20 63 61 6c 6c 20 74 6f 20 69 6e 64 69 63 61 o call to indica
1c3b0 74 65 20 77 68 69 63 68 20 6d 61 6c 6c 6f 63 28 te which malloc(
1c3c0 29 20 66 61 69 6c 75 72 65 73 20 0a 20 20 20 20 ) failures .
1c3d0 2a 2a 20 61 72 65 20 62 65 6e 69 67 6e 2e 0a 20 ** are benign..
1c3e0 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1c3f0 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 QLITE_TESTCTRL_B
1c400 45 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f ENIGN_MALLOC_HOO
1c410 4b 53 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 65 KS: {. type
1c420 64 65 66 20 76 6f 69 64 20 28 2a 76 6f 69 64 5f def void (*void_
1c430 66 75 6e 63 74 69 6f 6e 29 28 76 6f 69 64 29 3b function)(void);
1c440 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 . void_func
1c450 74 69 6f 6e 20 78 42 65 6e 69 67 6e 42 65 67 69 tion xBenignBegi
1c460 6e 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 n;. void_fu
1c470 6e 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e 45 6e nction xBenignEn
1c480 64 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e d;. xBenign
1c490 42 65 67 69 6e 20 3d 20 76 61 5f 61 72 67 28 61 Begin = va_arg(a
1c4a0 70 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e p, void_function
1c4b0 29 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e );. xBenign
1c4c0 45 6e 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c End = va_arg(ap,
1c4d0 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b void_function);
1c4e0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 . sqlite3Be
1c4f0 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 nignMallocHooks(
1c500 78 42 65 6e 69 67 6e 42 65 67 69 6e 2c 20 78 42 xBenignBegin, xB
1c510 65 6e 69 67 6e 45 6e 64 29 3b 0a 20 20 20 20 20 enignEnd);.
1c520 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
1c530 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 /*. ** sq
1c540 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 lite3_test_contr
1c550 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ol(SQLITE_TESTCT
1c560 52 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c RL_PENDING_BYTE,
1c570 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 58 29 unsigned int X)
1c580 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 . **. ** S
1c590 65 74 20 74 68 65 20 50 45 4e 44 49 4e 47 20 62 et the PENDING b
1c5a0 79 74 65 20 74 6f 20 74 68 65 20 76 61 6c 75 65 yte to the value
1c5b0 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 in the argument
1c5c0 2c 20 69 66 20 58 3e 30 2e 0a 20 20 20 20 2a 2a , if X>0.. **
1c5d0 20 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 Make no changes
1c5e0 20 69 66 20 58 3d 3d 30 2e 20 20 52 65 74 75 72 if X==0. Retur
1c5f0 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 n the value of t
1c600 68 65 20 70 65 6e 64 69 6e 67 20 62 79 74 65 0a he pending byte.
1c610 20 20 20 20 2a 2a 20 61 73 20 69 74 20 65 78 69 ** as it exi
1c620 73 74 69 6e 67 20 62 65 66 6f 72 65 20 74 68 69 sting before thi
1c630 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 s routine was ca
1c640 6c 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 lled.. **.
1c650 20 2a 2a 20 49 4d 50 4f 52 54 41 4e 54 3a 20 20 ** IMPORTANT:
1c660 43 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 4e Changing the PEN
1c670 44 49 4e 47 20 62 79 74 65 20 66 72 6f 6d 20 30 DING byte from 0
1c680 78 34 30 30 30 30 30 30 30 20 72 65 73 75 6c 74 x40000000 result
1c690 73 20 69 6e 0a 20 20 20 20 2a 2a 20 61 6e 20 69 s in. ** an i
1c6a0 6e 63 6f 6d 70 61 74 69 62 6c 65 20 64 61 74 61 ncompatible data
1c6b0 62 61 73 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 base file format
1c6c0 2e 20 20 43 68 61 6e 67 69 6e 67 20 74 68 65 20 . Changing the
1c6d0 50 45 4e 44 49 4e 47 20 62 79 74 65 0a 20 20 20 PENDING byte.
1c6e0 20 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 64 61 ** while any da
1c6f0 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
1c700 6e 20 69 73 20 6f 70 65 6e 20 72 65 73 75 6c 74 n is open result
1c710 73 20 69 6e 20 75 6e 64 65 66 69 6e 65 64 20 61 s in undefined a
1c720 6e 64 0a 20 20 20 20 2a 2a 20 64 65 6c 65 74 65 nd. ** delete
1c730 72 69 6f 75 73 20 62 65 68 61 76 69 6f 72 2e 0a rious behavior..
1c740 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1c750 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1c760 50 45 4e 44 49 4e 47 5f 42 59 54 45 3a 20 7b 0a PENDING_BYTE: {.
1c770 20 20 20 20 20 20 72 63 20 3d 20 50 45 4e 44 49 rc = PENDI
1c780 4e 47 5f 42 59 54 45 3b 0a 23 69 66 6e 64 65 66 NG_BYTE;.#ifndef
1c790 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 SQLITE_OMIT_WSD
1c7a0 0a 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 20 . {.
1c7b0 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 65 unsigned int ne
1c7c0 77 56 61 6c 20 3d 20 76 61 5f 61 72 67 28 61 70 wVal = va_arg(ap
1c7d0 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 3b , unsigned int);
1c7e0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 65 77 . if( new
1c7f0 56 61 6c 20 29 20 73 71 6c 69 74 65 33 50 65 6e Val ) sqlite3Pen
1c800 64 69 6e 67 42 79 74 65 20 3d 20 6e 65 77 56 61 dingByte = newVa
1c810 6c 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 l;. }.#endi
1c820 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 f. break;.
1c830 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 }.. /*.
1c840 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 65 73 ** sqlite3_tes
1c850 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
1c860 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 _TESTCTRL_ASSERT
1c870 2c 20 69 6e 74 20 58 29 0a 20 20 20 20 2a 2a 0a , int X). **.
1c880 20 20 20 20 2a 2a 20 54 68 69 73 20 61 63 74 69 ** This acti
1c890 6f 6e 20 70 72 6f 76 69 64 65 73 20 61 20 72 75 on provides a ru
1c8a0 6e 2d 74 69 6d 65 20 74 65 73 74 20 74 6f 20 73 n-time test to s
1c8b0 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ee whether or no
1c8c0 74 0a 20 20 20 20 2a 2a 20 61 73 73 65 72 74 28 t. ** assert(
1c8d0 29 20 77 61 73 20 65 6e 61 62 6c 65 64 20 61 74 ) was enabled at
1c8e0 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e 20 20 compile-time.
1c8f0 49 66 20 58 20 69 73 20 74 72 75 65 20 61 6e 64 If X is true and
1c900 20 61 73 73 65 72 74 28 29 0a 20 20 20 20 2a 2a assert(). **
1c910 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 is enabled, the
1c920 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c n the return val
1c930 75 65 20 69 73 20 74 72 75 65 2e 20 20 49 66 20 ue is true. If
1c940 58 20 69 73 20 74 72 75 65 20 61 6e 64 0a 20 20 X is true and.
1c950 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 69 73 ** assert() is
1c960 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 disabled, then
1c970 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 the return value
1c980 20 69 73 20 7a 65 72 6f 2e 20 20 49 66 20 58 20 is zero. If X
1c990 69 73 0a 20 20 20 20 2a 2a 20 66 61 6c 73 65 20 is. ** false
1c9a0 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 73 20 and assert() is
1c9b0 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 enabled, then th
1c9c0 65 20 61 73 73 65 72 74 69 6f 6e 20 66 69 72 65 e assertion fire
1c9d0 73 20 61 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a s and the. **
1c9e0 20 70 72 6f 63 65 73 73 20 61 62 6f 72 74 73 2e process aborts.
1c9f0 20 20 49 66 20 58 20 69 73 20 66 61 6c 73 65 20 If X is false
1ca00 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 73 20 and assert() is
1ca10 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e 20 74 disabled, then t
1ca20 68 65 0a 20 20 20 20 2a 2a 20 72 65 74 75 72 6e he. ** return
1ca30 20 76 61 6c 75 65 20 69 73 20 7a 65 72 6f 2e 0a value is zero..
1ca40 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 */. case
1ca50 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1ca60 41 53 53 45 52 54 3a 20 7b 0a 20 20 20 20 20 20 ASSERT: {.
1ca70 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 78 20 3d volatile int x =
1ca80 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 0;. assert
1ca90 28 20 28 78 20 3d 20 76 61 5f 61 72 67 28 61 70 ( (x = va_arg(ap
1caa0 2c 69 6e 74 29 29 21 3d 30 20 29 3b 0a 20 20 20 ,int))!=0 );.
1cab0 20 20 20 72 63 20 3d 20 78 3b 0a 20 20 20 20 20 rc = x;.
1cac0 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 0a break;. }...
1cad0 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 /*. ** s
1cae0 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1caf0 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
1cb00 54 52 4c 5f 41 4c 57 41 59 53 2c 20 69 6e 74 20 TRL_ALWAYS, int
1cb10 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a X). **. **
1cb20 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 72 6f This action pro
1cb30 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 6d 65 vides a run-time
1cb40 20 74 65 73 74 20 74 6f 20 73 65 65 20 68 6f 77 test to see how
1cb50 20 74 68 65 20 41 4c 57 41 59 53 20 61 6e 64 0a the ALWAYS and.
1cb60 20 20 20 20 2a 2a 20 4e 45 56 45 52 20 6d 61 63 ** NEVER mac
1cb70 72 6f 73 20 77 65 72 65 20 64 65 66 69 6e 65 64 ros were defined
1cb80 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 at compile-time
1cb90 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
1cba0 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 The return value
1cbb0 20 69 73 20 41 4c 57 41 59 53 28 58 29 2e 20 20 is ALWAYS(X).
1cbc0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
1cbd0 68 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 he recommended t
1cbe0 65 73 74 20 69 73 20 58 3d 3d 32 2e 20 20 49 66 est is X==2. If
1cbf0 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 the return valu
1cc00 65 20 69 73 20 32 2c 20 74 68 61 74 20 6d 65 61 e is 2, that mea
1cc10 6e 73 0a 20 20 20 20 2a 2a 20 41 4c 57 41 59 53 ns. ** ALWAYS
1cc20 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 20 61 () and NEVER() a
1cc30 72 65 20 62 6f 74 68 20 6e 6f 2d 6f 70 20 70 61 re both no-op pa
1cc40 73 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 6f ss-through macro
1cc50 73 2c 20 77 68 69 63 68 20 69 73 20 74 68 65 0a s, which is the.
1cc60 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 20 73 ** default s
1cc70 65 74 74 69 6e 67 2e 20 20 49 66 20 74 68 65 20 etting. If the
1cc80 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
1cc90 31 2c 20 74 68 65 6e 20 41 4c 57 41 59 53 28 29 1, then ALWAYS()
1cca0 20 69 73 20 65 69 74 68 65 72 0a 20 20 20 20 2a is either. *
1ccb0 2a 20 68 61 72 64 2d 63 6f 64 65 64 20 74 6f 20 * hard-coded to
1ccc0 74 72 75 65 20 6f 72 20 65 6c 73 65 20 69 74 20 true or else it
1ccd0 61 73 73 65 72 74 73 20 69 66 20 69 74 73 20 61 asserts if its a
1cce0 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c 73 65 rgument is false
1ccf0 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 69 72 .. ** The fir
1cd00 73 74 20 62 65 68 61 76 69 6f 72 20 28 68 61 72 st behavior (har
1cd10 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 65 29 d-coded to true)
1cd20 20 69 73 20 74 68 65 20 63 61 73 65 20 69 66 0a is the case if.
1cd30 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 54 45 ** SQLITE_TE
1cd40 53 54 43 54 52 4c 5f 41 53 53 45 52 54 20 73 68 STCTRL_ASSERT sh
1cd50 6f 77 73 20 74 68 61 74 20 61 73 73 65 72 74 28 ows that assert(
1cd60 29 20 69 73 20 64 69 73 61 62 6c 65 64 20 61 6e ) is disabled an
1cd70 64 20 74 68 65 20 73 65 63 6f 6e 64 0a 20 20 20 d the second.
1cd80 20 2a 2a 20 62 65 68 61 76 69 6f 72 20 28 61 73 ** behavior (as
1cd90 73 65 72 74 20 69 66 20 74 68 65 20 61 72 67 75 sert if the argu
1cda0 6d 65 6e 74 20 74 6f 20 41 4c 57 41 59 53 28 29 ment to ALWAYS()
1cdb0 20 69 73 20 66 61 6c 73 65 29 20 69 73 20 74 68 is false) is th
1cdc0 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 2a 2a e case if. **
1cdd0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1cde0 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 74 68 _ASSERT shows th
1cdf0 61 74 20 61 73 73 65 72 74 28 29 20 69 73 20 65 at assert() is e
1ce00 6e 61 62 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 nabled.. **.
1ce10 20 20 20 2a 2a 20 54 68 65 20 72 75 6e 2d 74 69 ** The run-ti
1ce20 6d 65 20 74 65 73 74 20 70 72 6f 63 65 64 75 72 me test procedur
1ce30 65 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 73 6f 6d e might look som
1ce40 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 ething like this
1ce50 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 :. **. **
1ce60 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 74 if( sqlite3_t
1ce70 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
1ce80 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c 57 41 TE_TESTCTRL_ALWA
1ce90 59 53 2c 20 32 29 3d 3d 32 20 29 7b 0a 20 20 20 YS, 2)==2 ){.
1cea0 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c 57 41 ** // ALWA
1ceb0 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 YS() and NEVER()
1cec0 20 61 72 65 20 6e 6f 2d 6f 70 20 70 61 73 73 2d are no-op pass-
1ced0 74 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 0a 20 through macros.
1cee0 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 20 69 ** }else i
1cef0 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f f( sqlite3_test_
1cf00 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
1cf10 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 2c 20 ESTCTRL_ASSERT,
1cf20 31 29 20 29 7b 0a 20 20 20 20 2a 2a 20 20 20 20 1) ){. **
1cf30 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 61 // ALWAYS(x) a
1cf40 73 73 65 72 74 73 20 74 68 61 74 20 78 20 69 73 sserts that x is
1cf50 20 74 72 75 65 2e 20 4e 45 56 45 52 28 78 29 20 true. NEVER(x)
1cf60 61 73 73 65 72 74 73 20 78 20 69 73 20 66 61 6c asserts x is fal
1cf70 73 65 2e 0a 20 20 20 20 2a 2a 20 20 20 20 7d 65 se.. ** }e
1cf80 6c 73 65 7b 0a 20 20 20 20 2a 2a 20 20 20 20 20 lse{. **
1cf90 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 69 73 // ALWAYS(x) is
1cfa0 20 61 20 63 6f 6e 73 74 61 6e 74 20 31 2e 20 20 a constant 1.
1cfb0 4e 45 56 45 52 28 78 29 20 69 73 20 61 20 63 6f NEVER(x) is a co
1cfc0 6e 73 74 61 6e 74 20 30 2e 0a 20 20 20 20 2a 2a nstant 0.. **
1cfd0 20 20 20 20 7d 0a 20 20 20 20 2a 2f 0a 20 20 20 }. */.
1cfe0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1cff0 54 43 54 52 4c 5f 41 4c 57 41 59 53 3a 20 7b 0a TCTRL_ALWAYS: {.
1d000 20 20 20 20 20 20 69 6e 74 20 78 20 3d 20 76 61 int x = va
1d010 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 _arg(ap,int);.
1d020 20 20 20 20 72 63 20 3d 20 41 4c 57 41 59 53 28 rc = ALWAYS(
1d030 78 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b x);. break;
1d040 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 . }.. /*.
1d050 20 20 20 2a 2a 20 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
1d060 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c test_control(SQL
1d070 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 59 54 ITE_TESTCTRL_BYT
1d080 45 4f 52 44 45 52 29 3b 0a 20 20 20 20 2a 2a 0a EORDER);. **.
1d090 20 20 20 20 2a 2a 20 54 68 65 20 69 6e 74 65 67 ** The integ
1d0a0 65 72 20 72 65 74 75 72 6e 65 64 20 72 65 76 65 er returned reve
1d0b0 61 6c 73 20 74 68 65 20 62 79 74 65 2d 6f 72 64 als the byte-ord
1d0c0 65 72 20 6f 66 20 74 68 65 20 63 6f 6d 70 75 74 er of the comput
1d0d0 65 72 20 6f 6e 20 77 68 69 63 68 0a 20 20 20 20 er on which.
1d0e0 2a 2a 20 53 51 4c 69 74 65 20 69 73 20 72 75 6e ** SQLite is run
1d0f0 6e 69 6e 67 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 ning:. **.
1d100 20 2a 2a 20 20 20 20 20 20 20 31 20 20 20 20 20 ** 1
1d110 62 69 67 2d 65 6e 64 69 61 6e 2c 20 20 20 20 64 big-endian, d
1d120 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 75 6e etermined at run
1d130 2d 74 69 6d 65 0a 20 20 20 20 2a 2a 20 20 20 20 -time. **
1d140 20 20 31 30 20 20 20 20 20 6c 69 74 74 6c 65 2d 10 little-
1d150 65 6e 64 69 61 6e 2c 20 64 65 74 65 72 6d 69 6e endian, determin
1d160 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 ed at run-time.
1d170 20 20 20 2a 2a 20 20 34 33 32 31 30 31 20 20 20 ** 432101
1d180 20 20 62 69 67 2d 65 6e 64 69 61 6e 2c 20 20 20 big-endian,
1d190 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 63 determined at c
1d1a0 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 20 20 ompile-time.
1d1b0 2a 2a 20 20 31 32 33 34 31 30 20 20 20 20 20 6c ** 123410 l
1d1c0 69 74 74 6c 65 2d 65 6e 64 69 61 6e 2c 20 64 65 ittle-endian, de
1d1d0 74 65 72 6d 69 6e 65 64 20 61 74 20 63 6f 6d 70 termined at comp
1d1e0 69 6c 65 2d 74 69 6d 65 0a 20 20 20 20 2a 2f 20 ile-time. */
1d1f0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1d200 5f 54 45 53 54 43 54 52 4c 5f 42 59 54 45 4f 52 _TESTCTRL_BYTEOR
1d210 44 45 52 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 DER: {. rc
1d220 3d 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 = SQLITE_BYTEORD
1d230 45 52 2a 31 30 30 20 2b 20 53 51 4c 49 54 45 5f ER*100 + SQLITE_
1d240 4c 49 54 54 4c 45 45 4e 44 49 41 4e 2a 31 30 20 LITTLEENDIAN*10
1d250 2b 20 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 + SQLITE_BIGENDI
1d260 41 4e 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b AN;. break;
1d270 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 . }.. /*
1d280 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1d290 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1d2a0 54 43 54 52 4c 5f 52 45 53 45 52 56 45 2c 20 73 TCTRL_RESERVE, s
1d2b0 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
1d2c0 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a N). **. **
1d2d0 20 53 65 74 20 74 68 65 20 6e 52 65 73 65 72 76 Set the nReserv
1d2e0 65 20 73 69 7a 65 20 74 6f 20 4e 20 66 6f 72 20 e size to N for
1d2f0 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 the main databas
1d300 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 e on the databas
1d310 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 63 74 e. ** connect
1d320 69 6f 6e 20 64 62 2e 0a 20 20 20 20 2a 2f 0a 20 ion db.. */.
1d330 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
1d340 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 3a ESTCTRL_RESERVE:
1d350 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 {. sqlite3
1d360 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 70 *db = va_arg(ap
1d370 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 , sqlite3*);.
1d380 20 20 20 69 6e 74 20 78 20 3d 20 76 61 5f 61 72 int x = va_ar
1d390 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 20 20 g(ap,int);.
1d3a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
1d3b0 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
1d3c0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 . sqlite3Bt
1d3d0 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 28 64 reeSetPageSize(d
1d3e0 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c 20 30 b->aDb[0].pBt, 0
1d3f0 2c 20 78 2c 20 30 29 3b 0a 20 20 20 20 20 20 73 , x, 0);. s
1d400 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1d410 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
1d420 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
1d430 7d 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c 69 74 }.. /* sqlit
1d440 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1d450 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1d460 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c 20 73 OPTIMIZATIONS, s
1d470 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
1d480 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a N). **. **
1d490 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 Enable or disab
1d4a0 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d le various optim
1d4b0 69 7a 61 74 69 6f 6e 73 20 66 6f 72 20 74 65 73 izations for tes
1d4c0 74 69 6e 67 20 70 75 72 70 6f 73 65 73 2e 20 20 ting purposes.
1d4d0 54 68 65 20 0a 20 20 20 20 2a 2a 20 61 72 67 75 The . ** argu
1d4e0 6d 65 6e 74 20 4e 20 69 73 20 61 20 62 69 74 6d ment N is a bitm
1d4f0 61 73 6b 20 6f 66 20 6f 70 74 69 6d 69 7a 61 74 ask of optimizat
1d500 69 6f 6e 73 20 74 6f 20 62 65 20 64 69 73 61 62 ions to be disab
1d510 6c 65 64 2e 20 20 46 6f 72 20 6e 6f 72 6d 61 6c led. For normal
1d520 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f . ** operatio
1d530 6e 20 4e 20 73 68 6f 75 6c 64 20 62 65 20 30 2e n N should be 0.
1d540 20 20 54 68 65 20 69 64 65 61 20 69 73 20 74 68 The idea is th
1d550 61 74 20 61 20 74 65 73 74 20 70 72 6f 67 72 61 at a test progra
1d560 6d 20 28 6c 69 6b 65 20 74 68 65 0a 20 20 20 20 m (like the.
1d570 2a 2a 20 53 51 4c 20 4c 6f 67 69 63 20 54 65 73 ** SQL Logic Tes
1d580 74 20 6f 72 20 53 4c 54 20 74 65 73 74 20 6d 6f t or SLT test mo
1d590 64 75 6c 65 29 20 63 61 6e 20 72 75 6e 20 74 68 dule) can run th
1d5a0 65 20 73 61 6d 65 20 53 51 4c 20 6d 75 6c 74 69 e same SQL multi
1d5b0 70 6c 65 20 74 69 6d 65 73 0a 20 20 20 20 2a 2a ple times. **
1d5c0 20 77 69 74 68 20 76 61 72 69 6f 75 73 20 6f 70 with various op
1d5d0 74 69 6d 69 7a 61 74 69 6f 6e 73 20 64 69 73 61 timizations disa
1d5e0 62 6c 65 64 20 74 6f 20 76 65 72 69 66 79 20 74 bled to verify t
1d5f0 68 61 74 20 74 68 65 20 73 61 6d 65 20 61 6e 73 hat the same ans
1d600 77 65 72 0a 20 20 20 20 2a 2a 20 69 73 20 6f 62 wer. ** is ob
1d610 74 61 69 6e 65 64 20 69 6e 20 65 76 65 72 79 20 tained in every
1d620 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 case.. */.
1d630 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1d640 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 TCTRL_OPTIMIZATI
1d650 4f 4e 53 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c ONS: {. sql
1d660 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 ite3 *db = va_ar
1d670 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b g(ap, sqlite3*);
1d680 0a 20 20 20 20 20 20 64 62 2d 3e 64 62 4f 70 74 . db->dbOpt
1d690 46 6c 61 67 73 20 3d 20 28 75 31 36 29 28 76 61 Flags = (u16)(va
1d6a0 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 20 26 20 _arg(ap, int) &
1d6b0 30 78 66 66 66 66 29 3b 0a 20 20 20 20 20 20 62 0xffff);. b
1d6c0 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 reak;. }..#if
1d6d0 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 def SQLITE_N_KEY
1d6e0 57 4f 52 44 0a 20 20 20 20 2f 2a 20 73 71 6c 69 WORD. /* sqli
1d6f0 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1d700 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1d710 5f 49 53 4b 45 59 57 4f 52 44 2c 20 63 6f 6e 73 _ISKEYWORD, cons
1d720 74 20 63 68 61 72 20 2a 7a 57 6f 72 64 29 0a 20 t char *zWord).
1d730 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 **. ** If
1d740 7a 57 6f 72 64 20 69 73 20 61 20 6b 65 79 77 6f zWord is a keywo
1d750 72 64 20 72 65 63 6f 67 6e 69 7a 65 64 20 62 79 rd recognized by
1d760 20 74 68 65 20 70 61 72 73 65 72 2c 20 74 68 65 the parser, the
1d770 6e 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 20 n return the.
1d780 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 6b 65 ** number of ke
1d790 79 77 6f 72 64 73 2e 20 20 4f 72 20 69 66 20 7a ywords. Or if z
1d7a0 57 6f 72 64 20 69 73 20 6e 6f 74 20 61 20 6b 65 Word is not a ke
1d7b0 79 77 6f 72 64 2c 20 72 65 74 75 72 6e 20 30 2e yword, return 0.
1d7c0 0a 20 20 20 20 2a 2a 20 0a 20 20 20 20 2a 2a 20 . ** . **
1d7d0 54 68 69 73 20 74 65 73 74 20 66 65 61 74 75 72 This test featur
1d7e0 65 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 e is only availa
1d7f0 62 6c 65 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 ble in the amalg
1d800 61 6d 61 74 69 6f 6e 20 73 69 6e 63 65 0a 20 20 amation since.
1d810 20 20 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f ** the SQLITE_
1d820 4e 5f 4b 45 59 57 4f 52 44 20 6d 61 63 72 6f 20 N_KEYWORD macro
1d830 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 69 is not defined i
1d840 6e 20 74 68 69 73 20 66 69 6c 65 20 69 66 20 53 n this file if S
1d850 51 4c 69 74 65 0a 20 20 20 20 2a 2a 20 69 73 20 QLite. ** is
1d860 62 75 69 6c 74 20 75 73 69 6e 67 20 73 65 70 61 built using sepa
1d870 72 61 74 65 20 73 6f 75 72 63 65 20 66 69 6c 65 rate source file
1d880 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
1d890 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1d8a0 52 4c 5f 49 53 4b 45 59 57 4f 52 44 3a 20 7b 0a RL_ISKEYWORD: {.
1d8b0 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 const char
1d8c0 20 2a 7a 57 6f 72 64 20 3d 20 76 61 5f 61 72 67 *zWord = va_arg
1d8d0 28 61 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a (ap, const char*
1d8e0 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 3d );. int n =
1d8f0 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
1d900 28 7a 57 6f 72 64 29 3b 0a 20 20 20 20 20 20 72 (zWord);. r
1d910 63 20 3d 20 28 73 71 6c 69 74 65 33 4b 65 79 77 c = (sqlite3Keyw
1d920 6f 72 64 43 6f 64 65 28 28 75 38 2a 29 7a 57 6f ordCode((u8*)zWo
1d930 72 64 2c 20 6e 29 21 3d 54 4b 5f 49 44 29 20 3f rd, n)!=TK_ID) ?
1d940 20 53 51 4c 49 54 45 5f 4e 5f 4b 45 59 57 4f 52 SQLITE_N_KEYWOR
1d950 44 20 3a 20 30 3b 0a 20 20 20 20 20 20 62 72 65 D : 0;. bre
1d960 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 ak;. }.#endif
1d970 20 0a 0a 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 .. /* sqlite
1d980 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1d990 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 53 QLITE_TESTCTRL_S
1d9a0 43 52 41 54 43 48 4d 41 4c 4c 4f 43 2c 20 73 7a CRATCHMALLOC, sz
1d9b0 2c 20 26 70 4e 65 77 2c 20 70 46 72 65 65 29 3b , &pNew, pFree);
1d9c0 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 50 . **. ** P
1d9d0 61 73 73 20 70 46 72 65 65 20 69 6e 74 6f 20 73 ass pFree into s
1d9e0 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 65 qlite3ScratchFre
1d9f0 65 28 29 2e 20 0a 20 20 20 20 2a 2a 20 49 66 20 e(). . ** If
1da00 73 7a 3e 30 20 74 68 65 6e 20 61 6c 6c 6f 63 61 sz>0 then alloca
1da10 74 65 20 61 20 73 63 72 61 74 63 68 20 62 75 66 te a scratch buf
1da20 66 65 72 20 69 6e 74 6f 20 70 4e 65 77 2e 20 20 fer into pNew.
1da30 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
1da40 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
1da50 5f 53 43 52 41 54 43 48 4d 41 4c 4c 4f 43 3a 20 _SCRATCHMALLOC:
1da60 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 2a 70 46 {. void *pF
1da70 72 65 65 2c 20 2a 2a 70 70 4e 65 77 3b 0a 20 20 ree, **ppNew;.
1da80 20 20 20 20 69 6e 74 20 73 7a 3b 0a 20 20 20 20 int sz;.
1da90 20 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 sz = va_arg(ap
1daa0 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 70 70 , int);. pp
1dab0 4e 65 77 20 3d 20 76 61 5f 61 72 67 28 61 70 2c New = va_arg(ap,
1dac0 20 76 6f 69 64 2a 2a 29 3b 0a 20 20 20 20 20 20 void**);.
1dad0 70 46 72 65 65 20 3d 20 76 61 5f 61 72 67 28 61 pFree = va_arg(a
1dae0 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 p, void*);.
1daf0 20 69 66 28 20 73 7a 20 29 20 2a 70 70 4e 65 77 if( sz ) *ppNew
1db00 20 3d 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 = sqlite3Scratc
1db10 68 4d 61 6c 6c 6f 63 28 73 7a 29 3b 0a 20 20 20 hMalloc(sz);.
1db20 20 20 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 sqlite3Scratc
1db30 68 46 72 65 65 28 70 46 72 65 65 29 3b 0a 20 20 hFree(pFree);.
1db40 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1db50 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1db60 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1db70 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1db80 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 55 4c 54 2c LOCALTIME_FAULT,
1db90 20 69 6e 74 20 6f 6e 6f 66 66 29 3b 0a 20 20 20 int onoff);.
1dba0 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 70 61 **. ** If pa
1dbb0 72 61 6d 65 74 65 72 20 6f 6e 6f 66 66 20 69 73 rameter onoff is
1dbc0 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 63 6f 6e 66 69 non-zero, confi
1dbd0 67 75 72 65 20 74 68 65 20 77 72 61 70 70 65 72 gure the wrapper
1dbe0 73 20 73 6f 20 74 68 61 74 20 61 6c 6c 0a 20 20 s so that all.
1dbf0 20 20 2a 2a 20 73 75 62 73 65 71 75 65 6e 74 20 ** subsequent
1dc00 63 61 6c 6c 73 20 74 6f 20 6c 6f 63 61 6c 74 69 calls to localti
1dc10 6d 65 28 29 20 61 6e 64 20 76 61 72 69 61 6e 74 me() and variant
1dc20 73 20 66 61 69 6c 2e 20 49 66 20 6f 6e 6f 66 66 s fail. If onoff
1dc30 20 69 73 20 7a 65 72 6f 2c 0a 20 20 20 20 2a 2a is zero,. **
1dc40 20 75 6e 64 6f 20 74 68 69 73 20 73 65 74 74 69 undo this setti
1dc50 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 ng.. */. c
1dc60 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ase SQLITE_TESTC
1dc70 54 52 4c 5f 4c 4f 43 41 4c 54 49 4d 45 5f 46 41 TRL_LOCALTIME_FA
1dc80 55 4c 54 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c ULT: {. sql
1dc90 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
1dca0 2e 62 4c 6f 63 61 6c 74 69 6d 65 46 61 75 6c 74 .bLocaltimeFault
1dcb0 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
1dcc0 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b t);. break;
1dcd0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 . }.. /*
1dce0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
1dcf0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
1dd00 54 43 54 52 4c 5f 4e 45 56 45 52 5f 43 4f 52 52 TCTRL_NEVER_CORR
1dd10 55 50 54 2c 20 69 6e 74 29 3b 0a 20 20 20 20 2a UPT, int);. *
1dd20 2a 0a 20 20 20 20 2a 2a 20 53 65 74 20 6f 72 20 *. ** Set or
1dd30 63 6c 65 61 72 20 61 20 66 6c 61 67 20 74 68 61 clear a flag tha
1dd40 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 t indicates that
1dd50 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1dd60 6c 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 6c le is always wel
1dd70 6c 2d 0a 20 20 20 20 2a 2a 20 66 6f 72 6d 65 64 l-. ** formed
1dd80 20 61 6e 64 20 6e 65 76 65 72 20 63 6f 72 72 75 and never corru
1dd90 70 74 2e 20 20 54 68 69 73 20 66 6c 61 67 20 69 pt. This flag i
1dda0 73 20 63 6c 65 61 72 20 62 79 20 64 65 66 61 75 s clear by defau
1ddb0 6c 74 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 74 lt, indicating t
1ddc0 68 61 74 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 hat. ** datab
1ddd0 61 73 65 20 66 69 6c 65 73 20 6d 69 67 68 74 20 ase files might
1dde0 68 61 76 65 20 61 72 62 69 74 72 61 72 79 20 63 have arbitrary c
1ddf0 6f 72 72 75 70 74 69 6f 6e 2e 20 20 53 65 74 74 orruption. Sett
1de00 69 6e 67 20 74 68 65 20 66 6c 61 67 20 64 75 72 ing the flag dur
1de10 69 6e 67 0a 20 20 20 20 2a 2a 20 74 65 73 74 69 ing. ** testi
1de20 6e 67 20 63 61 75 73 65 73 20 63 65 72 74 61 69 ng causes certai
1de30 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
1de40 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 64 ments in the cod
1de50 65 20 74 6f 20 62 65 20 61 63 74 69 76 61 74 65 e to be activate
1de60 64 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 64 65 d. ** that de
1de70 6d 6f 6e 73 74 72 61 74 20 69 6e 76 61 72 69 61 monstrat invaria
1de80 6e 74 73 20 6f 6e 20 77 65 6c 6c 2d 66 6f 72 6d nts on well-form
1de90 65 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ed database file
1dea0 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 s.. */. ca
1deb0 73 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 se SQLITE_TESTCT
1dec0 52 4c 5f 4e 45 56 45 52 5f 43 4f 52 52 55 50 54 RL_NEVER_CORRUPT
1ded0 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
1dee0 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 65 3GlobalConfig.ne
1def0 76 65 72 43 6f 72 72 75 70 74 20 3d 20 76 61 5f verCorrupt = va_
1df00 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
1df10 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1df20 0a 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 ... /* sqli
1df30 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
1df40 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c (SQLITE_TESTCTRL
1df50 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 2c 20 _VDBE_COVERAGE,
1df60 78 43 61 6c 6c 62 61 63 6b 2c 20 70 74 72 29 3b xCallback, ptr);
1df70 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 . **. ** S
1df80 65 74 20 74 68 65 20 56 44 42 45 20 63 6f 76 65 et the VDBE cove
1df90 72 61 67 65 20 63 61 6c 6c 62 61 63 6b 20 66 75 rage callback fu
1dfa0 6e 63 74 69 6f 6e 20 74 6f 20 78 43 61 6c 6c 62 nction to xCallb
1dfb0 61 63 6b 20 77 69 74 68 20 63 6f 6e 74 65 78 74 ack with context
1dfc0 20 0a 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 . ** pointer
1dfd0 20 70 74 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ptr.. */.
1dfe0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 53 case SQLITE_TES
1dff0 54 43 54 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 TCTRL_VDBE_COVER
1e000 41 47 45 3a 20 7b 0a 23 69 66 64 65 66 20 53 51 AGE: {.#ifdef SQ
1e010 4c 49 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 41 LITE_VDBE_COVERA
1e020 47 45 0a 20 20 20 20 20 20 74 79 70 65 64 65 66 GE. typedef
1e030 20 76 6f 69 64 20 28 2a 62 72 61 6e 63 68 5f 63 void (*branch_c
1e040 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 allback)(void*,i
1e050 6e 74 2c 75 38 2c 75 38 29 3b 0a 20 20 20 20 20 nt,u8,u8);.
1e060 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1e070 6e 66 69 67 2e 78 56 64 62 65 42 72 61 6e 63 68 nfig.xVdbeBranch
1e080 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 62 72 61 = va_arg(ap,bra
1e090 6e 63 68 5f 63 61 6c 6c 62 61 63 6b 29 3b 0a 20 nch_callback);.
1e0a0 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
1e0b0 61 6c 43 6f 6e 66 69 67 2e 70 56 64 62 65 42 72 alConfig.pVdbeBr
1e0c0 61 6e 63 68 41 72 67 20 3d 20 76 61 5f 61 72 67 anchArg = va_arg
1e0d0 28 61 70 2c 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 (ap,void*);.#end
1e0e0 69 66 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a if. break;.
1e0f0 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 20 20 }.. /*
1e100 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
1e110 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
1e120 43 54 52 4c 5f 53 4f 52 54 45 52 5f 4d 4d 41 50 CTRL_SORTER_MMAP
1e130 2c 20 64 62 2c 20 6e 4d 61 78 29 3b 20 2a 2f 0a , db, nMax); */.
1e140 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
1e150 54 45 53 54 43 54 52 4c 5f 53 4f 52 54 45 52 5f TESTCTRL_SORTER_
1e160 4d 4d 41 50 3a 20 7b 0a 20 20 20 20 20 20 73 71 MMAP: {. sq
1e170 6c 69 74 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 lite3 *db = va_a
1e180 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 rg(ap, sqlite3*)
1e190 3b 0a 20 20 20 20 20 20 64 62 2d 3e 6e 4d 61 78 ;. db->nMax
1e1a0 53 6f 72 74 65 72 4d 6d 61 70 20 3d 20 76 61 5f SorterMmap = va_
1e1b0 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 arg(ap, int);.
1e1c0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1e1d0 0a 0a 20 20 20 20 2f 2a 20 20 20 73 71 6c 69 74 .. /* sqlit
1e1e0 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 e3_test_control(
1e1f0 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f SQLITE_TESTCTRL_
1e200 49 53 49 4e 49 54 29 3b 0a 20 20 20 20 2a 2a 0a ISINIT);. **.
1e210 20 20 20 20 2a 2a 20 52 65 74 75 72 6e 20 53 51 ** Return SQ
1e220 4c 49 54 45 5f 4f 4b 20 69 66 20 53 51 4c 69 74 LITE_OK if SQLit
1e230 65 20 68 61 73 20 62 65 65 6e 20 69 6e 69 74 69 e has been initi
1e240 61 6c 69 7a 65 64 20 61 6e 64 20 53 51 4c 49 54 alized and SQLIT
1e250 45 5f 45 52 52 4f 52 20 69 66 0a 20 20 20 20 2a E_ERROR if. *
1e260 2a 20 6e 6f 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 * not.. */.
1e270 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 45 case SQLITE_TE
1e280 53 54 43 54 52 4c 5f 49 53 49 4e 49 54 3a 20 7b STCTRL_ISINIT: {
1e290 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
1e2a0 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 e3GlobalConfig.i
1e2b0 73 49 6e 69 74 3d 3d 30 20 29 20 72 63 20 3d 20 sInit==0 ) rc =
1e2c0 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
1e2d0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
1e2e0 0a 0a 20 20 20 20 2f 2a 20 20 73 71 6c 69 74 65 .. /* sqlite
1e2f0 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
1e300 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 49 QLITE_TESTCTRL_I
1e310 4d 50 4f 53 54 45 52 2c 20 64 62 2c 20 64 62 4e MPOSTER, db, dbN
1e320 61 6d 65 2c 20 6f 6e 4f 66 66 2c 20 74 6e 75 6d ame, onOff, tnum
1e330 29 3b 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a );. **. **
1e340 20 54 68 69 73 20 74 65 73 74 20 63 6f 6e 74 72 This test contr
1e350 6f 6c 20 69 73 20 75 73 65 64 20 74 6f 20 63 72 ol is used to cr
1e360 65 61 74 65 20 69 6d 70 6f 73 74 65 72 20 74 61 eate imposter ta
1e370 62 6c 65 73 2e 20 20 22 64 62 22 20 69 73 20 61 bles. "db" is a
1e380 20 70 6f 69 6e 74 65 72 0a 20 20 20 20 2a 2a 20 pointer. **
1e390 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
1e3a0 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 64 62 4e connection. dbN
1e3b0 61 6d 65 20 69 73 20 74 68 65 20 64 61 74 61 62 ame is the datab
1e3c0 61 73 65 20 6e 61 6d 65 20 28 65 78 3a 20 22 6d ase name (ex: "m
1e3d0 61 69 6e 22 20 6f 72 0a 20 20 20 20 2a 2a 20 22 ain" or. ** "
1e3e0 74 65 6d 70 22 29 20 77 68 69 63 68 20 77 69 6c temp") which wil
1e3f0 6c 20 72 65 63 65 69 76 65 20 74 68 65 20 69 6d l receive the im
1e400 70 6f 73 74 65 72 2e 20 20 22 6f 6e 4f 66 66 22 poster. "onOff"
1e410 20 74 75 72 6e 73 20 69 6d 70 6f 73 74 65 72 20 turns imposter
1e420 6d 6f 64 65 20 6f 6e 0a 20 20 20 20 2a 2a 20 6f mode on. ** o
1e430 72 20 6f 66 66 2e 20 20 22 74 6e 75 6d 22 20 69 r off. "tnum" i
1e440 73 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 s the root page
1e450 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 74 6f of the b-tree to
1e460 20 77 68 69 63 68 20 74 68 65 20 69 6d 70 6f 73 which the impos
1e470 74 65 72 0a 20 20 20 20 2a 2a 20 74 61 62 6c 65 ter. ** table
1e480 20 73 68 6f 75 6c 64 20 63 6f 6e 6e 65 63 74 2e should connect.
1e490 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 . **. ** E
1e4a0 6e 61 62 6c 65 20 69 6d 70 6f 73 74 65 72 20 6d nable imposter m
1e4b0 6f 64 65 20 6f 6e 6c 79 20 77 68 65 6e 20 74 68 ode only when th
1e4c0 65 20 73 63 68 65 6d 61 20 68 61 73 20 61 6c 72 e schema has alr
1e4d0 65 61 64 79 20 62 65 65 6e 20 70 61 72 73 65 64 eady been parsed
1e4e0 2e 20 20 54 68 65 6e 0a 20 20 20 20 2a 2a 20 72 . Then. ** r
1e4f0 75 6e 20 61 20 73 69 6e 67 6c 65 20 43 52 45 41 un a single CREA
1e500 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 TE TABLE stateme
1e510 6e 74 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 nt to construct
1e520 74 68 65 20 69 6d 70 6f 73 74 65 72 20 74 61 62 the imposter tab
1e530 6c 65 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 le in. ** the
1e540 20 70 61 72 73 65 64 20 73 63 68 65 6d 61 2e 20 parsed schema.
1e550 20 54 68 65 6e 20 74 75 72 6e 20 69 6d 70 6f 73 Then turn impos
1e560 74 65 72 20 6d 6f 64 65 20 62 61 63 6b 20 6f 66 ter mode back of
1e570 66 20 61 67 61 69 6e 2e 0a 20 20 20 20 2a 2a 0a f again.. **.
1e580 20 20 20 20 2a 2a 20 49 66 20 6f 6e 4f 66 66 3d ** If onOff=
1e590 3d 30 20 61 6e 64 20 74 6e 75 6d 3e 30 20 74 68 =0 and tnum>0 th
1e5a0 65 6e 20 72 65 73 65 74 20 74 68 65 20 73 63 68 en reset the sch
1e5b0 65 6d 61 20 66 6f 72 20 61 6c 6c 20 64 61 74 61 ema for all data
1e5c0 62 61 73 65 73 2c 20 63 61 75 73 69 6e 67 0a 20 bases, causing.
1e5d0 20 20 20 2a 2a 20 74 68 65 20 73 63 68 65 6d 61 ** the schema
1e5e0 20 74 6f 20 62 65 20 72 65 70 61 72 73 65 64 20 to be reparsed
1e5f0 74 68 65 20 6e 65 78 74 20 74 69 6d 65 20 69 74 the next time it
1e600 20 69 73 20 6e 65 65 64 65 64 2e 20 20 54 68 69 is needed. Thi
1e610 73 20 68 61 73 20 74 68 65 0a 20 20 20 20 2a 2a s has the. **
1e620 20 65 66 66 65 63 74 20 6f 66 20 65 72 61 73 69 effect of erasi
1e630 6e 67 20 61 6c 6c 20 69 6d 70 6f 73 74 65 72 20 ng all imposter
1e640 74 61 62 6c 65 73 2e 0a 20 20 20 20 2a 2f 0a 20 tables.. */.
1e650 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
1e660 45 53 54 43 54 52 4c 5f 49 4d 50 4f 53 54 45 52 ESTCTRL_IMPOSTER
1e670 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 : {. sqlite
1e680 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 61 3 *db = va_arg(a
1e690 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 p, sqlite3*);.
1e6a0 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
1e6b0 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
1e6c0 78 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 69 6e x);. db->in
1e6d0 69 74 2e 69 44 62 20 3d 20 73 71 6c 69 74 65 33 it.iDb = sqlite3
1e6e0 46 69 6e 64 44 62 4e 61 6d 65 28 64 62 2c 20 76 FindDbName(db, v
1e6f0 61 5f 61 72 67 28 61 70 2c 63 6f 6e 73 74 20 63 a_arg(ap,const c
1e700 68 61 72 2a 29 29 3b 0a 20 20 20 20 20 20 64 62 har*));. db
1e710 2d 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 64 62 ->init.busy = db
1e720 2d 3e 69 6e 69 74 2e 69 6d 70 6f 73 74 65 72 54 ->init.imposterT
1e730 61 62 6c 65 20 3d 20 76 61 5f 61 72 67 28 61 70 able = va_arg(ap
1e740 2c 69 6e 74 29 3b 0a 20 20 20 20 20 20 64 62 2d ,int);. db-
1e750 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 >init.newTnum =
1e760 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a va_arg(ap,int);.
1e770 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 69 6e if( db->in
1e780 69 74 2e 62 75 73 79 3d 3d 30 20 26 26 20 64 62 it.busy==0 && db
1e790 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 3e 30 ->init.newTnum>0
1e7a0 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
1e7b0 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d te3ResetAllSchem
1e7c0 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 64 asOfConnection(d
1e7d0 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 b);. }.
1e7e0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1e7f0 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
1e800 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
1e810 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e }. }. va_en
1e820 64 28 61 70 29 3b 0a 23 65 6e 64 69 66 20 2f 2a d(ap);.#endif /*
1e830 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 SQLITE_OMIT_BUI
1e840 4c 54 49 4e 5f 54 45 53 54 20 2a 2f 0a 20 20 72 LTIN_TEST */. r
1e850 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
1e860 2a 2a 20 54 68 69 73 20 69 73 20 61 20 75 74 69 ** This is a uti
1e870 6c 69 74 79 20 72 6f 75 74 69 6e 65 2c 20 75 73 lity routine, us
1e880 65 66 75 6c 20 74 6f 20 56 46 53 20 69 6d 70 6c eful to VFS impl
1e890 65 6d 65 6e 74 61 74 69 6f 6e 73 2c 20 74 68 61 ementations, tha
1e8a0 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 6f 20 73 t checks.** to s
1e8b0 65 65 20 69 66 20 61 20 64 61 74 61 62 61 73 65 ee if a database
1e8c0 20 66 69 6c 65 20 77 61 73 20 61 20 55 52 49 20 file was a URI
1e8d0 74 68 61 74 20 63 6f 6e 74 61 69 6e 65 64 20 61 that contained a
1e8e0 20 73 70 65 63 69 66 69 63 20 71 75 65 72 79 20 specific query
1e8f0 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 2c 20 61 .** parameter, a
1e900 6e 64 20 69 66 20 73 6f 20 6f 62 74 61 69 6e 73 nd if so obtains
1e910 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 the value of th
1e920 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 e query paramete
1e930 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 7a 46 69 r..**.** The zFi
1e940 6c 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 lename argument
1e950 69 73 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 is the filename
1e960 70 6f 69 6e 74 65 72 20 70 61 73 73 65 64 20 69 pointer passed i
1e970 6e 74 6f 20 74 68 65 20 78 4f 70 65 6e 28 29 0a nto the xOpen().
1e980 2a 2a 20 6d 65 74 68 6f 64 20 6f 66 20 61 20 56 ** method of a V
1e990 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f FS implementatio
1e9a0 6e 2e 20 20 54 68 65 20 7a 50 61 72 61 6d 20 61 n. The zParam a
1e9b0 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 6e rgument is the n
1e9c0 61 6d 65 20 6f 66 20 74 68 65 0a 2a 2a 20 71 75 ame of the.** qu
1e9d0 65 72 79 20 70 61 72 61 6d 65 74 65 72 20 77 65 ery parameter we
1e9e0 20 73 65 65 6b 2e 20 20 54 68 69 73 20 72 6f 75 seek. This rou
1e9f0 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65 tine returns the
1ea00 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 7a 50 value of the zP
1ea10 61 72 61 6d 0a 2a 2a 20 70 61 72 61 6d 65 74 65 aram.** paramete
1ea20 72 20 69 66 20 69 74 20 65 78 69 73 74 73 2e 20 r if it exists.
1ea30 20 49 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 If the paramete
1ea40 72 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 r does not exist
1ea50 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a , this routine.*
1ea60 2a 20 72 65 74 75 72 6e 73 20 61 20 4e 55 4c 4c * returns a NULL
1ea70 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 63 6f 6e pointer..*/.con
1ea80 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
1ea90 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 63 _uri_parameter(c
1eaa0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 onst char *zFile
1eab0 6e 61 6d 65 2c 20 63 6f 6e 73 74 20 63 68 61 72 name, const char
1eac0 20 2a 7a 50 61 72 61 6d 29 7b 0a 20 20 69 66 28 *zParam){. if(
1ead0 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c zFilename==0 ||
1eae0 20 7a 50 61 72 61 6d 3d 3d 30 20 29 20 72 65 74 zParam==0 ) ret
1eaf0 75 72 6e 20 30 3b 0a 20 20 7a 46 69 6c 65 6e 61 urn 0;. zFilena
1eb00 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 72 me += sqlite3Str
1eb10 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 len30(zFilename)
1eb20 20 2b 20 31 3b 0a 20 20 77 68 69 6c 65 28 20 7a + 1;. while( z
1eb30 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 Filename[0] ){.
1eb40 20 20 20 69 6e 74 20 78 20 3d 20 73 74 72 63 6d int x = strcm
1eb50 70 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 p(zFilename, zPa
1eb60 72 61 6d 29 3b 0a 20 20 20 20 7a 46 69 6c 65 6e ram);. zFilen
1eb70 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 53 74 ame += sqlite3St
1eb80 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 rlen30(zFilename
1eb90 29 20 2b 20 31 3b 0a 20 20 20 20 69 66 28 20 78 ) + 1;. if( x
1eba0 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 7a 46 69 ==0 ) return zFi
1ebb0 6c 65 6e 61 6d 65 3b 0a 20 20 20 20 7a 46 69 6c lename;. zFil
1ebc0 65 6e 61 6d 65 20 2b 3d 20 73 71 6c 69 74 65 33 ename += sqlite3
1ebd0 53 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 Strlen30(zFilena
1ebe0 6d 65 29 20 2b 20 31 3b 0a 20 20 7d 0a 20 20 72 me) + 1;. }. r
1ebf0 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn 0;.}../*.*
1ec00 2a 20 52 65 74 75 72 6e 20 61 20 62 6f 6f 6c 65 * Return a boole
1ec10 61 6e 20 76 61 6c 75 65 20 66 6f 72 20 61 20 71 an value for a q
1ec20 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a uery parameter..
1ec30 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 75 */.int sqlite3_u
1ec40 72 69 5f 62 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 ri_boolean(const
1ec50 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
1ec60 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 , const char *zP
1ec70 61 72 61 6d 2c 20 69 6e 74 20 62 44 66 6c 74 29 aram, int bDflt)
1ec80 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
1ec90 7a 20 3d 20 73 71 6c 69 74 65 33 5f 75 72 69 5f z = sqlite3_uri_
1eca0 70 61 72 61 6d 65 74 65 72 28 7a 46 69 6c 65 6e parameter(zFilen
1ecb0 61 6d 65 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 20 ame, zParam);.
1ecc0 62 44 66 6c 74 20 3d 20 62 44 66 6c 74 21 3d 30 bDflt = bDflt!=0
1ecd0 3b 0a 20 20 72 65 74 75 72 6e 20 7a 20 3f 20 73 ;. return z ? s
1ece0 71 6c 69 74 65 33 47 65 74 42 6f 6f 6c 65 61 6e qlite3GetBoolean
1ecf0 28 7a 2c 20 62 44 66 6c 74 29 20 3a 20 62 44 66 (z, bDflt) : bDf
1ed00 6c 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 lt;.}../*.** Ret
1ed10 75 72 6e 20 61 20 36 34 2d 62 69 74 20 69 6e 74 urn a 64-bit int
1ed20 65 67 65 72 20 76 61 6c 75 65 20 66 6f 72 20 61 eger value for a
1ed30 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 query parameter
1ed40 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 6e 74 ..*/.sqlite3_int
1ed50 36 34 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 69 64 sqlite3_uri_i
1ed60 6e 74 36 34 28 0a 20 20 63 6f 6e 73 74 20 63 68 nt64(. const ch
1ed70 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
1ed80 20 20 2f 2a 20 46 69 6c 65 6e 61 6d 65 20 61 73 /* Filename as
1ed90 20 70 61 73 73 65 64 20 74 6f 20 78 4f 70 65 6e passed to xOpen
1eda0 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
1edb0 20 2a 7a 50 61 72 61 6d 2c 20 20 20 20 20 20 20 *zParam,
1edc0 2f 2a 20 55 52 49 20 70 61 72 61 6d 65 74 65 72 /* URI parameter
1edd0 20 73 6f 75 67 68 74 20 2a 2f 0a 20 20 73 71 6c sought */. sql
1ede0 69 74 65 33 5f 69 6e 74 36 34 20 62 44 66 6c 74 ite3_int64 bDflt
1edf0 20 20 20 20 20 20 20 2f 2a 20 72 65 74 75 72 6e /* return
1ee00 20 69 66 20 70 61 72 61 6d 65 74 65 72 20 69 73 if parameter is
1ee10 20 6d 69 73 73 69 6e 67 20 2a 2f 0a 29 7b 0a 20 missing */.){.
1ee20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d const char *z =
1ee30 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 sqlite3_uri_par
1ee40 61 6d 65 74 65 72 28 7a 46 69 6c 65 6e 61 6d 65 ameter(zFilename
1ee50 2c 20 7a 50 61 72 61 6d 29 3b 0a 20 20 73 71 6c , zParam);. sql
1ee60 69 74 65 33 5f 69 6e 74 36 34 20 76 3b 0a 20 20 ite3_int64 v;.
1ee70 69 66 28 20 7a 20 26 26 20 73 71 6c 69 74 65 33 if( z && sqlite3
1ee80 44 65 63 4f 72 48 65 78 54 6f 49 36 34 28 7a 2c DecOrHexToI64(z,
1ee90 20 26 76 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 &v)==SQLITE_OK
1eea0 29 7b 0a 20 20 20 20 62 44 66 6c 74 20 3d 20 76 ){. bDflt = v
1eeb0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 62 ;. }. return b
1eec0 44 66 6c 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 Dflt;.}../*.** R
1eed0 65 74 75 72 6e 20 74 68 65 20 42 74 72 65 65 20 eturn the Btree
1eee0 70 6f 69 6e 74 65 72 20 69 64 65 6e 74 69 66 69 pointer identifi
1eef0 65 64 20 62 79 20 7a 44 62 4e 61 6d 65 2e 20 20 ed by zDbName.
1ef00 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 20 6e Return NULL if n
1ef10 6f 74 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 42 74 72 ot found..*/.Btr
1ef20 65 65 20 2a 73 71 6c 69 74 65 33 44 62 4e 61 6d ee *sqlite3DbNam
1ef30 65 54 6f 42 74 72 65 65 28 73 71 6c 69 74 65 33 eToBtree(sqlite3
1ef40 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 *db, const char
1ef50 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 69 6e *zDbName){. in
1ef60 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 t i;. for(i=0;
1ef70 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b i<db->nDb; i++){
1ef80 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44 62 . if( db->aDb
1ef90 5b 69 5d 2e 70 42 74 0a 20 20 20 20 20 26 26 20 [i].pBt. &&
1efa0 28 7a 44 62 4e 61 6d 65 3d 3d 30 20 7c 7c 20 73 (zDbName==0 || s
1efb0 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 7a 44 qlite3StrICmp(zD
1efc0 62 4e 61 6d 65 2c 20 64 62 2d 3e 61 44 62 5b 69 bName, db->aDb[i
1efd0 5d 2e 7a 4e 61 6d 65 29 3d 3d 30 29 0a 20 20 20 ].zName)==0).
1efe0 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1eff0 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b db->aDb[i].pBt;
1f000 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
1f010 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn 0;.}../*.**
1f020 52 65 74 75 72 6e 20 74 68 65 20 66 69 6c 65 6e Return the filen
1f030 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ame of the datab
1f040 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 ase associated w
1f050 69 74 68 20 61 20 64 61 74 61 62 61 73 65 0a 2a ith a database.*
1f060 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f * connection..*/
1f070 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c .const char *sql
1f080 69 74 65 33 5f 64 62 5f 66 69 6c 65 6e 61 6d 65 ite3_db_filename
1f090 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f (sqlite3 *db, co
1f0a0 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 4e 61 6d nst char *zDbNam
1f0b0 65 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 e){. Btree *pBt
1f0c0 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
1f0d0 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 ENABLE_API_ARMOR
1f0e0 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 . if( !sqlite3S
1f0f0 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29 afetyCheckOk(db)
1f100 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 ){. (void)SQ
1f110 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
1f120 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a ;. return 0;.
1f130 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 42 74 }.#endif. pBt
1f140 20 3d 20 73 71 6c 69 74 65 33 44 62 4e 61 6d 65 = sqlite3DbName
1f150 54 6f 42 74 72 65 65 28 64 62 2c 20 7a 44 62 4e ToBtree(db, zDbN
1f160 61 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 ame);. return p
1f170 42 74 20 3f 20 73 71 6c 69 74 65 33 42 74 72 65 Bt ? sqlite3Btre
1f180 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 70 42 74 eGetFilename(pBt
1f190 29 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 ) : 0;.}../*.**
1f1a0 52 65 74 75 72 6e 20 31 20 69 66 20 64 61 74 61 Return 1 if data
1f1b0 62 61 73 65 20 69 73 20 72 65 61 64 2d 6f 6e 6c base is read-onl
1f1c0 79 20 6f 72 20 30 20 69 66 20 72 65 61 64 2f 77 y or 0 if read/w
1f1d0 72 69 74 65 2e 20 20 52 65 74 75 72 6e 20 2d 31 rite. Return -1
1f1e0 20 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 68 20 64 if.** no such d
1f1f0 61 74 61 62 61 73 65 20 65 78 69 73 74 73 2e 0a atabase exists..
1f200 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 */.int sqlite3_d
1f210 62 5f 72 65 61 64 6f 6e 6c 79 28 73 71 6c 69 74 b_readonly(sqlit
1f220 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 e3 *db, const ch
1f230 61 72 20 2a 7a 44 62 4e 61 6d 65 29 7b 0a 20 20 ar *zDbName){.
1f240 42 74 72 65 65 20 2a 70 42 74 3b 0a 23 69 66 64 Btree *pBt;.#ifd
1f250 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
1f260 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 _API_ARMOR. if(
1f270 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
1f280 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 heckOk(db) ){.
1f290 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d (void)SQLITE_M
1f2a0 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 ISUSE_BKPT;.
1f2b0 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 return -1;. }.#
1f2c0 65 6e 64 69 66 0a 20 20 70 42 74 20 3d 20 73 71 endif. pBt = sq
1f2d0 6c 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 72 lite3DbNameToBtr
1f2e0 65 65 28 64 62 2c 20 7a 44 62 4e 61 6d 65 29 3b ee(db, zDbName);
1f2f0 0a 20 20 72 65 74 75 72 6e 20 70 42 74 20 3f 20 . return pBt ?
1f300 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 52 65 sqlite3BtreeIsRe
1f310 61 64 6f 6e 6c 79 28 70 42 74 29 20 3a 20 2d 31 adonly(pBt) : -1
1f320 3b 0a 7d 0a 0a 23 69 66 20 28 53 51 4c 49 54 45 ;.}..#if (SQLITE
1f330 5f 45 4e 41 42 4c 45 5f 41 50 50 4c 45 5f 53 50 _ENABLE_APPLE_SP
1f340 49 3e 30 29 20 26 26 20 64 65 66 69 6e 65 64 28 I>0) && defined(
1f350 5f 5f 41 50 50 4c 45 5f 5f 29 0a 0a 23 69 6e 63 __APPLE__)..#inc
1f360 6c 75 64 65 20 22 73 71 6c 69 74 65 33 5f 70 72 lude "sqlite3_pr
1f370 69 76 61 74 65 2e 68 22 0a 0a 2f 2a 20 0a 2a 2a ivate.h"../* .**
1f380 20 54 65 73 74 69 6e 67 20 61 20 66 69 6c 65 20 Testing a file
1f390 70 61 74 68 20 66 6f 72 20 73 71 6c 69 74 65 20 path for sqlite
1f3a0 6c 6f 63 6b 73 20 68 65 6c 64 20 62 79 20 61 20 locks held by a
1f3b0 70 72 6f 63 65 73 73 20 49 44 2e 20 0a 2a 2a 20 process ID. .**
1f3c0 52 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4c Returns SQLITE_L
1f3d0 4f 43 4b 53 54 41 54 45 5f 4f 4e 20 69 66 20 6c OCKSTATE_ON if l
1f3e0 6f 63 6b 73 20 61 72 65 20 70 72 65 73 65 6e 74 ocks are present
1f3f0 20 6f 6e 20 70 61 74 68 0a 2a 2a 20 74 68 61 74 on path.** that
1f400 20 77 6f 75 6c 64 20 70 72 65 76 65 6e 74 20 77 would prevent w
1f410 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 riting to the da
1f420 74 61 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 5f tabase..*/.int _
1f430 73 71 6c 69 74 65 33 5f 6c 6f 63 6b 73 74 61 74 sqlite3_lockstat
1f440 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 61 e(const char *pa
1f450 74 68 2c 20 70 69 64 5f 74 20 70 69 64 29 7b 0a th, pid_t pid){.
1f460 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
1f470 4e 55 4c 4c 3b 0a 20 20 0a 20 20 69 66 28 20 73 NULL;. . if( s
1f480 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 70 qlite3_open_v2(p
1f490 61 74 68 2c 20 26 64 62 2c 20 53 51 4c 49 54 45 ath, &db, SQLITE
1f4a0 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 2c 20 _OPEN_READONLY,
1f4b0 4e 55 4c 4c 29 20 3d 3d 20 53 51 4c 49 54 45 5f NULL) == SQLITE_
1f4c0 4f 4b 20 29 7b 0a 20 20 20 20 4c 6f 63 6b 73 74 OK ){. Lockst
1f4d0 61 74 65 50 49 44 20 6c 6f 63 6b 73 74 61 74 65 atePID lockstate
1f4e0 20 3d 20 7b 70 69 64 2c 20 2d 31 7d 3b 0a 20 20 = {pid, -1};.
1f4f0 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63 sqlite3_file_c
1f500 6f 6e 74 72 6f 6c 28 64 62 2c 20 4e 55 4c 4c 2c ontrol(db, NULL,
1f510 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4c 4f SQLITE_FCNTL_LO
1f520 43 4b 53 54 41 54 45 5f 50 49 44 2c 20 26 6c 6f CKSTATE_PID, &lo
1f530 63 6b 73 74 61 74 65 29 3b 0a 20 20 20 20 73 71 ckstate);. sq
1f540 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b lite3_close(db);
1f550 0a 20 20 20 20 69 6e 74 20 73 74 61 74 65 20 3d . int state =
1f560 20 6c 6f 63 6b 73 74 61 74 65 2e 73 74 61 74 65 lockstate.state
1f570 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 74 61 ;. return sta
1f580 74 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 4e 55 te;. }. if( NU
1f590 4c 4c 21 3d 64 62 20 29 7b 20 0a 20 20 20 20 73 LL!=db ){ . s
1f5a0 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 64 62 29 qlite3_close(db)
1f5b0 3b 20 2f 2a 20 6e 65 65 64 20 74 6f 20 63 6c 6f ; /* need to clo
1f5c0 73 65 20 65 76 65 6e 20 69 66 20 6f 70 65 6e 20 se even if open
1f5d0 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 returns an error
1f5e0 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e */. }. return
1f5f0 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 53 54 41 54 SQLITE_LOCKSTAT
1f600 45 5f 45 52 52 4f 52 3b 0a 7d 0a 0a 23 65 6e 64 E_ERROR;.}..#end
1f610 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 if /* SQLITE_ENA
1f620 42 4c 45 5f 41 50 50 4c 45 5f 53 50 49 20 2a 2f BLE_APPLE_SPI */
1f630 0a .