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: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63 *.** $Id: main.c
0270: 2c 76 20 31 2e 35 33 30 20 32 30 30 39 2f 30 32 ,v 1.530 2009/02
0280: 2f 32 36 20 30 37 3a 31 35 3a 35 39 20 64 61 6e /26 07:15:59 dan
0290: 69 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a ielk1977 Exp $.*
02a0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 /.#include "sqli
02b0: 74 65 49 6e 74 2e 68 22 0a 0a 23 69 66 64 65 66 teInt.h"..#ifdef
02c0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
02d0: 54 53 33 0a 23 20 69 6e 63 6c 75 64 65 20 22 66 TS3.# include "f
02e0: 74 73 33 2e 68 22 0a 23 65 6e 64 69 66 0a 23 69 ts3.h".#endif.#i
02f0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
0300: 4c 45 5f 52 54 52 45 45 0a 23 20 69 6e 63 6c 75 LE_RTREE.# inclu
0310: 64 65 20 22 72 74 72 65 65 2e 68 22 0a 23 65 6e de "rtree.h".#en
0320: 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
0330: 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 23 20 69 E_ENABLE_ICU.# i
0340: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 69 63 nclude "sqliteic
0350: 75 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a u.h".#endif../*.
0360: 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f ** The version o
0370: 66 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f f the library.*/
0380: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
0390: 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 63 6f 6e AMALGAMATION.con
03a0: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 33 5f st char sqlite3_
03b0: 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 version[] = SQLI
03c0: 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 23 65 6e 64 TE_VERSION;.#end
03d0: 69 66 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 if.const char *s
03e0: 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f qlite3_libversio
03f0: 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 n(void){ return
0400: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 3b sqlite3_version;
0410: 20 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c }.int sqlite3_l
0420: 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 ibversion_number
0430: 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 (void){ return S
0440: 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e 55 QLITE_VERSION_NU
0450: 4d 42 45 52 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 MBER; }.int sqli
0460: 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 76 te3_threadsafe(v
0470: 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 4c oid){ return SQL
0480: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3b 20 ITE_THREADSAFE;
0490: 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 }..#if !defined(
04a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 SQLITE_OMIT_TRAC
04b0: 45 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 E) && defined(SQ
04c0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 LITE_ENABLE_IOTR
04d0: 41 43 45 29 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 ACE)./*.** If th
04e0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 e following func
04f0: 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 20 tion pointer is
0500: 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 69 66 0a not NULL and if.
0510: 2a 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ** SQLITE_ENABLE
0520: 5f 49 4f 54 52 41 43 45 20 69 73 20 65 6e 61 62 _IOTRACE is enab
0530: 6c 65 64 2c 20 74 68 65 6e 20 6d 65 73 73 61 67 led, then messag
0540: 65 73 20 64 65 73 63 72 69 62 69 6e 67 0a 2a 2a es describing.**
0550: 20 49 2f 4f 20 61 63 74 69 76 65 20 61 72 65 20 I/O active are
0560: 77 72 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 written using th
0570: 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 is function. Th
0580: 65 73 65 20 6d 65 73 73 61 67 65 73 0a 2a 2a 20 ese messages.**
0590: 61 72 65 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 are intended for
05a0: 20 64 65 62 75 67 67 69 6e 67 20 61 63 74 69 76 debugging activ
05b0: 69 74 79 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 ity only..*/.voi
05c0: 64 20 28 2a 73 71 6c 69 74 65 33 49 6f 54 72 61 d (*sqlite3IoTra
05d0: 63 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ce)(const char*,
05e0: 20 2e 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e 64 69 ...) = 0;.#endi
05f0: 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 f../*.** If the
0600: 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c following global
0610: 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 variable points
0620: 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 to a string whi
0630: 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d ch is the.** nam
0640: 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 e of a directory
0650: 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 , then that dire
0660: 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 ctory will be us
0670: 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 ed to store.** t
0680: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a emporary files..
0690: 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 **.** See also t
06a0: 68 65 20 22 50 52 41 47 4d 41 20 74 65 6d 70 5f he "PRAGMA temp_
06b0: 73 74 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 store_directory"
06c0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f SQL command..*/
06d0: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 .char *sqlite3_t
06e0: 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 emp_directory =
06f0: 30 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 0;../*.** Initia
0700: 6c 69 7a 65 20 53 51 4c 69 74 65 2e 20 20 0a 2a lize SQLite. .*
0710: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
0720: 65 20 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 e must be called
0730: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 to initialize t
0740: 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 he memory alloca
0750: 74 69 6f 6e 2c 0a 2a 2a 20 56 46 53 2c 20 61 6e tion,.** VFS, an
0760: 64 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 d mutex subsyste
0770: 6d 73 20 70 72 69 6f 72 20 74 6f 20 64 6f 69 6e ms prior to doin
0780: 67 20 61 6e 79 20 73 65 72 69 6f 75 73 20 77 6f g any serious wo
0790: 72 6b 20 77 69 74 68 0a 2a 2a 20 53 51 4c 69 74 rk with.** SQLit
07a0: 65 2e 20 20 42 75 74 20 61 73 20 6c 6f 6e 67 20 e. But as long
07b0: 61 73 20 79 6f 75 20 64 6f 20 6e 6f 74 20 63 6f as you do not co
07c0: 6d 70 69 6c 65 20 77 69 74 68 20 53 51 4c 49 54 mpile with SQLIT
07d0: 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a E_OMIT_AUTOINIT.
07e0: 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ** this routine
07f0: 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 61 will be called a
0800: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 utomatically by
0810: 6b 65 79 20 72 6f 75 74 69 6e 65 73 20 73 75 63 key routines suc
0820: 68 20 61 73 0a 2a 2a 20 73 71 6c 69 74 65 33 5f h as.** sqlite3_
0830: 6f 70 65 6e 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 open(). .**.**
0840: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
0850: 61 20 6e 6f 2d 6f 70 20 65 78 63 65 70 74 20 6f a no-op except o
0860: 6e 20 69 74 73 20 76 65 72 79 20 66 69 72 73 74 n its very first
0870: 20 63 61 6c 6c 20 66 6f 72 20 74 68 65 20 70 72 call for the pr
0880: 6f 63 65 73 73 2c 0a 2a 2a 20 6f 72 20 66 6f 72 ocess,.** or for
0890: 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20 the first call
08a0: 61 66 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 after a call to
08b0: 73 71 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 6e sqlite3_shutdown
08c0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 ..**.** The firs
08d0: 74 20 74 68 72 65 61 64 20 74 6f 20 63 61 6c 6c t thread to call
08e0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 75 this routine ru
08f0: 6e 73 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a ns the initializ
0900: 61 74 69 6f 6e 20 74 6f 0a 2a 2a 20 63 6f 6d 70 ation to.** comp
0910: 6c 65 74 69 6f 6e 2e 20 20 49 66 20 73 75 62 73 letion. If subs
0920: 65 71 75 65 6e 74 20 74 68 72 65 61 64 73 20 63 equent threads c
0930: 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 all this routine
0940: 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 before the firs
0950: 74 0a 2a 2a 20 74 68 72 65 61 64 20 68 61 73 20 t.** thread has
0960: 66 69 6e 69 73 68 65 64 20 74 68 65 20 69 6e 69 finished the ini
0970: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 63 tialization proc
0980: 65 73 73 2c 20 74 68 65 6e 20 74 68 65 20 73 75 ess, then the su
0990: 62 73 65 71 75 65 6e 74 0a 2a 2a 20 74 68 72 65 bsequent.** thre
09a0: 61 64 73 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 ads must block u
09b0: 6e 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 ntil the first t
09c0: 68 72 65 61 64 20 66 69 6e 69 73 68 65 73 20 77 hread finishes w
09d0: 69 74 68 20 74 68 65 20 69 6e 69 74 69 61 6c 69 ith the initiali
09e0: 7a 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 zation..**.** Th
09f0: 65 20 66 69 72 73 74 20 74 68 72 65 61 64 20 6d e first thread m
0a00: 69 67 68 74 20 63 61 6c 6c 20 74 68 69 73 20 72 ight call this r
0a10: 6f 75 74 69 6e 65 20 72 65 63 75 72 73 69 76 65 outine recursive
0a20: 6c 79 2e 20 20 52 65 63 75 72 73 69 76 65 0a 2a ly. Recursive.*
0a30: 2a 20 63 61 6c 6c 73 20 74 6f 20 74 68 69 73 20 * calls to this
0a40: 72 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6e routine should n
0a50: 6f 74 20 62 6c 6f 63 6b 2c 20 6f 66 20 63 6f 75 ot block, of cou
0a60: 72 73 65 2e 20 20 4f 74 68 65 72 77 69 73 65 20 rse. Otherwise
0a70: 74 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 7a the.** initializ
0a80: 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 77 6f ation process wo
0a90: 75 6c 64 20 6e 65 76 65 72 20 63 6f 6d 70 6c 65 uld never comple
0aa0: 74 65 2e 0a 2a 2a 0a 2a 2a 20 4c 65 74 20 58 20 te..**.** Let X
0ab0: 62 65 20 74 68 65 20 66 69 72 73 74 20 74 68 72 be the first thr
0ac0: 65 61 64 20 74 6f 20 65 6e 74 65 72 20 74 68 69 ead to enter thi
0ad0: 73 20 72 6f 75 74 69 6e 65 2e 20 20 4c 65 74 20 s routine. Let
0ae0: 59 20 62 65 20 73 6f 6d 65 20 6f 74 68 65 72 0a Y be some other.
0af0: 2a 2a 20 74 68 72 65 61 64 2e 20 20 54 68 65 6e ** thread. Then
0b00: 20 77 68 69 6c 65 20 74 68 65 20 69 6e 69 74 69 while the initi
0b10: 61 6c 20 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 al invocation of
0b20: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 62 79 this routine by
0b30: 20 58 20 69 73 0a 2a 2a 20 69 6e 63 6f 6d 70 6c X is.** incompl
0b40: 65 74 65 2c 20 69 74 20 69 73 20 72 65 71 75 69 ete, it is requi
0b50: 72 65 64 20 74 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 red that:.**.**
0b60: 20 20 20 2a 20 20 43 61 6c 6c 73 20 74 6f 20 74 * Calls to t
0b70: 68 69 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d his routine from
0b80: 20 59 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e Y must block un
0b90: 74 69 6c 20 74 68 65 20 6f 75 74 65 72 2d 6d 6f til the outer-mo
0ba0: 73 74 0a 2a 2a 20 20 20 20 20 20 20 63 61 6c 6c st.** call
0bb0: 20 62 79 20 58 20 63 6f 6d 70 6c 65 74 65 73 2e by X completes.
0bc0: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 20 52 65 63 .**.** * Rec
0bd0: 75 72 73 69 76 65 20 63 61 6c 6c 73 20 74 6f 20 ursive calls to
0be0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 66 72 6f this routine fro
0bf0: 6d 20 74 68 72 65 61 64 20 58 20 72 65 74 75 72 m thread X retur
0c00: 6e 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a n immediately.**
0c10: 20 20 20 20 20 20 20 77 69 74 68 6f 75 74 20 62 without b
0c20: 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 locking..*/.int
0c30: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 sqlite3_initiali
0c40: 7a 65 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 ze(void){. sqli
0c50: 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 73 74 te3_mutex *pMast
0c60: 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 er;
0c70: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
0c80: 6d 61 69 6e 20 73 74 61 74 69 63 20 6d 75 74 65 main static mute
0c90: 78 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 x */. int rc;
0ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0cc0: 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f /* Result co
0cd0: 64 65 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 de */..#ifdef SQ
0ce0: 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 LITE_OMIT_WSD.
0cf0: 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 rc = sqlite3_wsd
0d00: 5f 69 6e 69 74 28 34 30 39 36 2c 20 32 34 29 3b _init(4096, 24);
0d10: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
0d20: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 E_OK ){. retu
0d30: 72 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 rn rc;. }.#endi
0d40: 66 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 69 74 f.. /* If SQLit
0d50: 65 20 69 73 20 61 6c 72 65 61 64 79 20 63 6f 6d e is already com
0d60: 70 6c 65 74 65 6c 79 20 69 6e 69 74 69 61 6c 69 pletely initiali
0d70: 7a 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 63 zed, then this c
0d80: 61 6c 6c 0a 20 20 2a 2a 20 74 6f 20 73 71 6c 69 all. ** to sqli
0d90: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
0da0: 20 73 68 6f 75 6c 64 20 62 65 20 61 20 6e 6f 2d should be a no-
0db0: 6f 70 2e 20 20 42 75 74 20 74 68 65 20 69 6e 69 op. But the ini
0dc0: 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 20 20 2a 2a tialization. **
0dd0: 20 6d 75 73 74 20 62 65 20 63 6f 6d 70 6c 65 74 must be complet
0de0: 65 2e 20 20 53 6f 20 69 73 49 6e 69 74 20 6d 75 e. So isInit mu
0df0: 73 74 20 6e 6f 74 20 62 65 20 73 65 74 20 75 6e st not be set un
0e00: 74 69 6c 20 74 68 65 20 76 65 72 79 20 65 6e 64 til the very end
0e10: 0a 20 20 2a 2a 20 6f 66 20 74 68 69 73 20 72 6f . ** of this ro
0e20: 75 74 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 utine.. */. if
0e30: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
0e40: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 onfig.isInit ) r
0e50: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
0e60: 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 .. /* Make sure
0e70: 20 74 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 the mutex subsy
0e80: 73 74 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 stem is initiali
0e90: 7a 65 64 2e 20 20 49 66 20 75 6e 61 62 6c 65 20 zed. If unable
0ea0: 74 6f 20 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c to . ** initial
0eb0: 69 7a 65 20 74 68 65 20 6d 75 74 65 78 20 73 75 ize the mutex su
0ec0: 62 73 79 73 74 65 6d 2c 20 72 65 74 75 72 6e 20 bsystem, return
0ed0: 65 61 72 6c 79 20 77 69 74 68 20 74 68 65 20 65 early with the e
0ee0: 72 72 6f 72 2e 0a 20 20 2a 2a 20 49 66 20 74 68 rror.. ** If th
0ef0: 65 20 73 79 73 74 65 6d 20 69 73 20 73 6f 20 73 e system is so s
0f00: 69 63 6b 20 74 68 61 74 20 77 65 20 61 72 65 20 ick that we are
0f10: 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 unable to alloca
0f20: 74 65 20 61 20 6d 75 74 65 78 2c 0a 20 20 2a 2a te a mutex,. **
0f30: 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 6d 75 there is not mu
0f40: 63 68 20 53 51 4c 69 74 65 20 69 73 20 67 6f 69 ch SQLite is goi
0f50: 6e 67 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f ng to be able to
0f60: 20 64 6f 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 do.. **. ** T
0f70: 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 he mutex subsyst
0f80: 65 6d 20 6d 75 73 74 20 74 61 6b 65 20 63 61 72 em must take car
0f90: 65 20 6f 66 20 73 65 72 69 61 6c 69 7a 69 6e 67 e of serializing
0fa0: 20 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 69 6e its own. ** in
0fb0: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 itialization..
0fc0: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
0fd0: 33 4d 75 74 65 78 49 6e 69 74 28 29 3b 0a 20 20 3MutexInit();.
0fe0: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
0ff0: 72 63 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 rc;.. /* Initia
1000: 6c 69 7a 65 20 74 68 65 20 6d 61 6c 6c 6f 63 28 lize the malloc(
1010: 29 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 65 ) system and the
1020: 20 72 65 63 75 72 73 69 76 65 20 70 49 6e 69 74 recursive pInit
1030: 4d 75 74 65 78 20 6d 75 74 65 78 2e 0a 20 20 2a Mutex mutex.. *
1040: 2a 20 54 68 69 73 20 6f 70 65 72 61 74 69 6f 6e * This operation
1050: 20 69 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 is protected by
1060: 20 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 the STATIC_MAST
1070: 45 52 20 6d 75 74 65 78 2e 20 20 4e 6f 74 65 20 ER mutex. Note
1080: 74 68 61 74 0a 20 20 2a 2a 20 4d 75 74 65 78 41 that. ** MutexA
1090: 6c 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64 lloc() is called
10a0: 20 66 6f 72 20 61 20 73 74 61 74 69 63 20 6d 75 for a static mu
10b0: 74 65 78 20 70 72 69 6f 72 20 74 6f 20 69 6e 69 tex prior to ini
10c0: 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 0a 20 20 tializing the.
10d0: 2a 2a 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 ** malloc subsys
10e0: 74 65 6d 20 2d 20 74 68 69 73 20 69 6d 70 6c 69 tem - this impli
10f0: 65 73 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f es that the allo
1100: 63 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 cation of a stat
1110: 69 63 0a 20 20 2a 2a 20 6d 75 74 65 78 20 6d 75 ic. ** mutex mu
1120: 73 74 20 6e 6f 74 20 72 65 71 75 69 72 65 20 73 st not require s
1130: 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20 upport from the
1140: 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d malloc subsystem
1150: 2e 0a 20 20 2a 2f 0a 20 20 70 4d 61 73 74 65 72 .. */. pMaster
1160: 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 = sqlite3MutexA
1170: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
1180: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 X_STATIC_MASTER)
1190: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
11a0: 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 x_enter(pMaster)
11b0: 3b 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 ;. if( !sqlite3
11c0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
11d0: 61 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 20 20 allocInit ){.
11e0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c rc = sqlite3Mal
11f0: 6c 6f 63 49 6e 69 74 28 29 3b 0a 20 20 7d 0a 20 locInit();. }.
1200: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1210: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 OK ){. sqlite
1220: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1230: 4d 61 6c 6c 6f 63 49 6e 69 74 20 3d 20 31 3b 0a MallocInit = 1;.
1240: 20 20 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 if( !sqlite3
1250: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e GlobalConfig.pIn
1260: 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 20 itMutex ){.
1270: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1280: 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 nfig.pInitMutex
1290: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
12a0: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
12b0: 5f 52 45 43 55 52 53 49 56 45 29 3b 0a 20 20 20 _RECURSIVE);.
12c0: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c if( sqlite3Gl
12d0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 obalConfig.bCore
12e0: 4d 75 74 65 78 20 26 26 20 21 73 71 6c 69 74 65 Mutex && !sqlite
12f0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 3GlobalConfig.pI
1300: 6e 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 nitMutex ){.
1310: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
1320: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 NOMEM;. }.
1330: 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 }. }. if( r
1340: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1350: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
1360: 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 lConfig.nRefInit
1370: 4d 75 74 65 78 2b 2b 3b 0a 20 20 7d 0a 20 20 73 Mutex++;. }. s
1380: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1390: 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 ve(pMaster);..
13a0: 2f 2a 20 49 66 20 75 6e 61 62 6c 65 20 74 6f 20 /* If unable to
13b0: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d initialize the m
13c0: 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 2c alloc subsystem,
13d0: 20 74 68 65 6e 20 72 65 74 75 72 6e 20 65 61 72 then return ear
13e0: 6c 79 2e 0a 20 20 2a 2a 20 54 68 65 72 65 20 69 ly.. ** There i
13f0: 73 20 6c 69 74 74 6c 65 20 68 6f 70 65 20 6f 66 s little hope of
1400: 20 67 65 74 74 69 6e 67 20 53 51 4c 69 74 65 20 getting SQLite
1410: 74 6f 20 72 75 6e 20 69 66 20 74 68 65 20 6d 61 to run if the ma
1420: 6c 6c 6f 63 0a 20 20 2a 2a 20 73 75 62 73 79 73 lloc. ** subsys
1430: 74 65 6d 20 63 61 6e 6e 6f 74 20 62 65 20 69 6e tem cannot be in
1440: 69 74 69 61 6c 69 7a 65 64 2e 0a 20 20 2a 2f 0a itialized.. */.
1450: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1460: 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 _OK ){. retur
1470: 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 n rc;. }.. /*
1480: 44 6f 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 Do the rest of t
1490: 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f he initializatio
14a0: 6e 20 75 6e 64 65 72 20 74 68 65 20 72 65 63 75 n under the recu
14b0: 72 73 69 76 65 20 6d 75 74 65 78 20 73 6f 0a 20 rsive mutex so.
14c0: 20 2a 2a 20 74 68 61 74 20 77 65 20 77 69 6c 6c ** that we will
14d0: 20 62 65 20 61 62 6c 65 20 74 6f 20 68 61 6e 64 be able to hand
14e0: 6c 65 20 72 65 63 75 72 73 69 76 65 20 63 61 6c le recursive cal
14f0: 6c 73 20 69 6e 74 6f 0a 20 20 2a 2a 20 73 71 6c ls into. ** sql
1500: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
1510: 29 2e 20 20 54 68 65 20 72 65 63 75 72 73 69 76 ). The recursiv
1520: 65 20 63 61 6c 6c 73 20 6e 6f 72 6d 61 6c 6c 79 e calls normally
1530: 20 63 6f 6d 65 20 74 68 72 6f 75 67 68 0a 20 20 come through.
1540: 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 73 5f 69 6e ** sqlite3_os_in
1550: 69 74 28 29 20 77 68 65 6e 20 69 74 20 69 6e 76 it() when it inv
1560: 6f 6b 65 73 20 73 71 6c 69 74 65 33 5f 76 66 73 okes sqlite3_vfs
1570: 5f 72 65 67 69 73 74 65 72 28 29 2c 20 62 75 74 _register(), but
1580: 20 6f 74 68 65 72 0a 20 20 2a 2a 20 72 65 63 75 other. ** recu
1590: 72 73 69 76 65 20 63 61 6c 6c 73 20 6d 69 67 68 rsive calls migh
15a0: 74 20 61 6c 73 6f 20 62 65 20 70 6f 73 73 69 62 t also be possib
15b0: 6c 65 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 le.. */. sqlit
15c0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 e3_mutex_enter(s
15d0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
15e0: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a ig.pInitMutex);.
15f0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f if( sqlite3Glo
1600: 62 61 6c 43 6f 6e 66 69 67 2e 69 73 49 6e 69 74 balConfig.isInit
1610: 3d 3d 30 20 26 26 20 73 71 6c 69 74 65 33 47 6c ==0 && sqlite3Gl
1620: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f obalConfig.inPro
1630: 67 72 65 73 73 3d 3d 30 20 29 7b 0a 20 20 20 20 gress==0 ){.
1640: 46 75 6e 63 44 65 66 48 61 73 68 20 2a 70 48 61 FuncDefHash *pHa
1650: 73 68 20 3d 20 26 47 4c 4f 42 41 4c 28 46 75 6e sh = &GLOBAL(Fun
1660: 63 44 65 66 48 61 73 68 2c 20 73 71 6c 69 74 65 cDefHash, sqlite
1670: 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 3GlobalFunctions
1680: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c );. sqlite3Gl
1690: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 72 6f obalConfig.inPro
16a0: 67 72 65 73 73 20 3d 20 31 3b 0a 20 20 20 20 6d gress = 1;. m
16b0: 65 6d 73 65 74 28 70 48 61 73 68 2c 20 30 2c 20 emset(pHash, 0,
16c0: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 47 6c sizeof(sqlite3Gl
16d0: 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 29 29 3b obalFunctions));
16e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 67 69 . sqlite3Regi
16f0: 73 74 65 72 47 6c 6f 62 61 6c 46 75 6e 63 74 69 sterGlobalFuncti
1700: 6f 6e 73 28 29 3b 0a 20 20 20 20 72 63 20 3d 20 ons();. rc =
1710: 73 71 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28 sqlite3_os_init(
1720: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
1730: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1740: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 rc = sqlite3Pc
1750: 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 65 28 29 acheInitialize()
1760: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 ;. sqlite3P
1770: 43 61 63 68 65 42 75 66 66 65 72 53 65 74 75 70 CacheBufferSetup
1780: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
1790: 6f 6e 66 69 67 2e 70 50 61 67 65 2c 20 0a 20 20 onfig.pPage, .
17a0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 sqlite3G
17b0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 lobalConfig.szPa
17c0: 67 65 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 ge, sqlite3Globa
17d0: 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 29 3b 0a lConfig.nPage);.
17e0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
17f0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 3GlobalConfig.in
1800: 50 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 Progress = 0;.
1810: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
1820: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 3d 20 28 onfig.isInit = (
1830: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 rc==SQLITE_OK ?
1840: 31 20 3a 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 1 : 0);. }. sq
1850: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1860: 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 e(sqlite3GlobalC
1870: 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 onfig.pInitMutex
1880: 29 3b 0a 0a 20 20 2f 2a 20 47 6f 20 62 61 63 6b );.. /* Go back
1890: 20 75 6e 64 65 72 20 74 68 65 20 73 74 61 74 69 under the stati
18a0: 63 20 6d 75 74 65 78 20 61 6e 64 20 63 6c 65 61 c mutex and clea
18b0: 6e 20 75 70 20 74 68 65 20 72 65 63 75 72 73 69 n up the recursi
18c0: 76 65 0a 20 20 2a 2a 20 6d 75 74 65 78 20 74 6f ve. ** mutex to
18d0: 20 70 72 65 76 65 6e 74 20 61 20 72 65 73 6f 75 prevent a resou
18e0: 72 63 65 20 6c 65 61 6b 2e 0a 20 20 2a 2f 0a 20 rce leak.. */.
18f0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
1900: 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b 0a 20 nter(pMaster);.
1910: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1920: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
1930: 65 78 2d 2d 3b 0a 20 20 69 66 28 20 73 71 6c 69 ex--;. if( sqli
1940: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
1950: 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 3c 3d 30 nRefInitMutex<=0
1960: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
1970: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1980: 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 65 fig.nRefInitMute
1990: 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 x==0 );. sqli
19a0: 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 73 te3_mutex_free(s
19b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
19c0: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 29 3b 0a ig.pInitMutex);.
19d0: 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 sqlite3Globa
19e0: 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 lConfig.pInitMut
19f0: 65 78 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 ex = 0;. }. sq
1a00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1a10: 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 20 2f e(pMaster);.. /
1a20: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
1a30: 69 73 20 6a 75 73 74 20 61 20 73 61 6e 69 74 79 is just a sanity
1a40: 20 63 68 65 63 6b 20 74 6f 20 6d 61 6b 65 20 73 check to make s
1a50: 75 72 65 20 53 51 4c 69 74 65 20 68 61 73 0a 20 ure SQLite has.
1a60: 20 2a 2a 20 62 65 65 6e 20 63 6f 6d 70 69 6c 65 ** been compile
1a70: 64 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 49 74 d correctly. It
1a80: 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f is important to
1a90: 20 72 75 6e 20 74 68 69 73 20 63 6f 64 65 2c 20 run this code,
1aa0: 62 75 74 0a 20 20 2a 2a 20 77 65 20 64 6f 6e 27 but. ** we don'
1ab0: 74 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 69 74 t want to run it
1ac0: 20 74 6f 6f 20 6f 66 74 65 6e 20 61 6e 64 20 73 too often and s
1ad0: 6f 61 6b 20 75 70 20 43 50 55 20 63 79 63 6c 65 oak up CPU cycle
1ae0: 73 20 66 6f 72 20 6e 6f 0a 20 20 2a 2a 20 72 65 s for no. ** re
1af0: 61 73 6f 6e 2e 20 20 53 6f 20 77 65 20 72 75 6e ason. So we run
1b00: 20 69 74 20 6f 6e 63 65 20 64 75 72 69 6e 67 20 it once during
1b10: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a initialization..
1b20: 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 */.#ifndef NDE
1b30: 42 55 47 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 BUG.#ifndef SQLI
1b40: 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 TE_OMIT_FLOATING
1b50: 5f 50 4f 49 4e 54 0a 20 20 2f 2a 20 54 68 69 73 _POINT. /* This
1b60: 20 73 65 63 74 69 6f 6e 20 6f 66 20 63 6f 64 65 section of code
1b70: 27 73 20 6f 6e 6c 79 20 22 6f 75 74 70 75 74 22 's only "output"
1b80: 20 69 73 20 76 69 61 20 61 73 73 65 72 74 28 29 is via assert()
1b90: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 2a 2f 0a statements. */.
1ba0: 20 20 69 66 20 28 20 72 63 3d 3d 53 51 4c 49 54 if ( rc==SQLIT
1bb0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 75 36 34 20 E_OK ){. u64
1bc0: 78 20 3d 20 28 28 28 75 36 34 29 31 29 3c 3c 36 x = (((u64)1)<<6
1bd0: 33 29 2d 31 3b 0a 20 20 20 20 64 6f 75 62 6c 65 3)-1;. double
1be0: 20 79 3b 0a 20 20 20 20 61 73 73 65 72 74 28 73 y;. assert(s
1bf0: 69 7a 65 6f 66 28 78 29 3d 3d 38 29 3b 0a 20 20 izeof(x)==8);.
1c00: 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66 28 assert(sizeof(
1c10: 78 29 3d 3d 73 69 7a 65 6f 66 28 79 29 29 3b 0a x)==sizeof(y));.
1c20: 20 20 20 20 6d 65 6d 63 70 79 28 26 79 2c 20 26 memcpy(&y, &
1c30: 78 2c 20 38 29 3b 0a 20 20 20 20 61 73 73 65 72 x, 8);. asser
1c40: 74 28 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 t( sqlite3IsNaN(
1c50: 79 29 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 y) );. }.#endif
1c60: 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 .#endif.. retur
1c70: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 n rc;.}../*.** U
1c80: 6e 64 6f 20 74 68 65 20 65 66 66 65 63 74 73 20 ndo the effects
1c90: 6f 66 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 of sqlite3_initi
1ca0: 61 6c 69 7a 65 28 29 2e 20 20 4d 75 73 74 20 6e alize(). Must n
1cb0: 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 77 68 69 ot be called whi
1cc0: 6c 65 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 20 le.** there are
1cd0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 61 74 61 outstanding data
1ce0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
1cf0: 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 or memory alloc
1d00: 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 77 68 69 ations or.** whi
1d10: 6c 65 20 61 6e 79 20 70 61 72 74 20 6f 66 20 53 le any part of S
1d20: 51 4c 69 74 65 20 69 73 20 6f 74 68 65 72 77 69 QLite is otherwi
1d30: 73 65 20 69 6e 20 75 73 65 20 69 6e 20 61 6e 79 se in use in any
1d40: 20 74 68 72 65 61 64 2e 20 20 54 68 69 73 0a 2a thread. This.*
1d50: 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 * routine is not
1d60: 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 4e 6f threadsafe. No
1d70: 74 20 62 79 20 61 20 6c 6f 6e 67 20 73 68 6f 74 t by a long shot
1d80: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1d90: 5f 73 68 75 74 64 6f 77 6e 28 76 6f 69 64 29 7b _shutdown(void){
1da0: 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c . sqlite3Global
1db0: 43 6f 6e 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 Config.isMallocI
1dc0: 6e 69 74 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 nit = 0;. sqlit
1dd0: 65 33 50 63 61 63 68 65 53 68 75 74 64 6f 77 6e e3PcacheShutdown
1de0: 28 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 ();. if( sqlite
1df0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1e00: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
1e10: 74 65 33 5f 6f 73 5f 65 6e 64 28 29 3b 0a 20 20 te3_os_end();.
1e20: 7d 0a 20 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f }. sqlite3Mallo
1e30: 63 45 6e 64 28 29 3b 0a 20 20 73 71 6c 69 74 65 cEnd();. sqlite
1e40: 33 4d 75 74 65 78 45 6e 64 28 29 3b 0a 20 20 73 3MutexEnd();. s
1e50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1e60: 69 67 2e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 ig.isInit = 0;.
1e70: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1e80: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 K;.}../*.** This
1e90: 20 41 50 49 20 61 6c 6c 6f 77 73 20 61 70 70 6c API allows appl
1ea0: 69 63 61 74 69 6f 6e 73 20 74 6f 20 6d 6f 64 69 ications to modi
1eb0: 66 79 20 74 68 65 20 67 6c 6f 62 61 6c 20 63 6f fy the global co
1ec0: 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 66 0a 2a nfiguration of.*
1ed0: 2a 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 * the SQLite lib
1ee0: 72 61 72 79 20 61 74 20 72 75 6e 2d 74 69 6d 65 rary at run-time
1ef0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
1f00: 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 tine should only
1f10: 20 62 65 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 be called when
1f20: 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 there are no out
1f30: 73 74 61 6e 64 69 6e 67 0a 2a 2a 20 64 61 74 61 standing.** data
1f40: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
1f50: 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 or memory alloc
1f60: 61 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 72 6f ations. This ro
1f70: 75 74 69 6e 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 utine is not.**
1f80: 74 68 72 65 61 64 73 61 66 65 2e 20 20 46 61 69 threadsafe. Fai
1f90: 6c 75 72 65 20 74 6f 20 68 65 65 64 20 74 68 65 lure to heed the
1fa0: 73 65 20 77 61 72 6e 69 6e 67 73 20 63 61 6e 20 se warnings can
1fb0: 6c 65 61 64 20 74 6f 20 75 6e 70 72 65 64 69 63 lead to unpredic
1fc0: 74 61 62 6c 65 0a 2a 2a 20 62 65 68 61 76 69 6f table.** behavio
1fd0: 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 r..*/.int sqlite
1fe0: 33 5f 63 6f 6e 66 69 67 28 69 6e 74 20 6f 70 2c 3_config(int op,
1ff0: 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 73 74 ...){. va_list
2000: 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ap;. int rc =
2010: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a SQLITE_OK;.. /*
2020: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 sqlite3_config(
2030: 29 20 73 68 61 6c 6c 20 72 65 74 75 72 6e 20 53 ) shall return S
2040: 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 69 66 20 QLITE_MISUSE if
2050: 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 it is invoked wh
2060: 69 6c 65 0a 20 20 2a 2a 20 74 68 65 20 53 51 4c ile. ** the SQL
2070: 69 74 65 20 6c 69 62 72 61 72 79 20 69 73 20 69 ite library is i
2080: 6e 20 75 73 65 2e 20 2a 2f 0a 20 20 69 66 28 20 n use. */. if(
2090: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
20a0: 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 65 74 fig.isInit ) ret
20b0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
20c0: 45 3b 0a 0a 20 20 76 61 5f 73 74 61 72 74 28 61 E;.. va_start(a
20d0: 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 p, op);. switch
20e0: 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 ( op ){.. /*
20f0: 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 72 61 74 Mutex configurat
2100: 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 ion options are
2110: 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 only available i
2120: 6e 20 61 20 74 68 72 65 61 64 73 61 66 65 0a 20 n a threadsafe.
2130: 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2e 20 0a ** compile. .
2140: 20 20 20 20 2a 2f 0a 23 69 66 20 53 51 4c 49 54 */.#if SQLIT
2150: 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 20 E_THREADSAFE.
2160: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
2170: 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 41 44 FIG_SINGLETHREAD
2180: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 44 69 73 : {. /* Dis
2190: 61 62 6c 65 20 61 6c 6c 20 6d 75 74 65 78 69 6e able all mutexin
21a0: 67 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 g */. sqlit
21b0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
21c0: 43 6f 72 65 4d 75 74 65 78 20 3d 20 30 3b 0a 20 CoreMutex = 0;.
21d0: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
21e0: 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 alConfig.bFullMu
21f0: 74 65 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 62 tex = 0;. b
2200: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
2210: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
2220: 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 3a 20 IG_MULTITHREAD:
2230: 7b 0a 20 20 20 20 20 20 2f 2a 20 44 69 73 61 62 {. /* Disab
2240: 6c 65 20 6d 75 74 65 78 69 6e 67 20 6f 66 20 64 le mutexing of d
2250: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
2260: 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 2f 2a 20 ons */. /*
2270: 45 6e 61 62 6c 65 20 6d 75 74 65 78 69 6e 67 20 Enable mutexing
2280: 6f 66 20 63 6f 72 65 20 64 61 74 61 20 73 74 72 of core data str
2290: 75 63 74 75 72 65 73 20 2a 2f 0a 20 20 20 20 20 uctures */.
22a0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
22b0: 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 nfig.bCoreMutex
22c0: 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 = 1;. sqlit
22d0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 e3GlobalConfig.b
22e0: 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b 0a 20 FullMutex = 0;.
22f0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
2300: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
2310: 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 41 4c 49 E_CONFIG_SERIALI
2320: 5a 45 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 ZED: {. /*
2330: 45 6e 61 62 6c 65 20 61 6c 6c 20 6d 75 74 65 78 Enable all mutex
2340: 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c ing */. sql
2350: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2360: 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 31 3b .bCoreMutex = 1;
2370: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2380: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c obalConfig.bFull
2390: 4d 75 74 65 78 20 3d 20 31 3b 0a 20 20 20 20 20 Mutex = 1;.
23a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
23b0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
23c0: 4e 46 49 47 5f 4d 55 54 45 58 3a 20 7b 0a 20 20 NFIG_MUTEX: {.
23d0: 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 20 61 /* Specify a
23e0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6d 75 n alternative mu
23f0: 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 tex implementati
2400: 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 on */. sqli
2410: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2420: 6d 75 74 65 78 20 3d 20 2a 76 61 5f 61 72 67 28 mutex = *va_arg(
2430: 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ap, sqlite3_mute
2440: 78 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 20 20 x_methods*);.
2450: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
2460: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
2470: 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45 58 3a CONFIG_GETMUTEX:
2480: 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 74 72 {. /* Retr
2490: 69 65 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 ieve the current
24a0: 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 mutex implement
24b0: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 2a ation */. *
24c0: 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c 69 74 va_arg(ap, sqlit
24d0: 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 e3_mutex_methods
24e0: 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 *) = sqlite3Glob
24f0: 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 3b 0a alConfig.mutex;.
2500: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
2510: 20 7d 0a 23 65 6e 64 69 66 0a 0a 0a 20 20 20 20 }.#endif...
2520: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
2530: 49 47 5f 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 20 IG_MALLOC: {.
2540: 20 20 20 2f 2a 20 53 70 65 63 69 66 79 20 61 6e /* Specify an
2550: 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6d 61 6c alternative mal
2560: 6c 6f 63 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 loc implementati
2570: 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 on */. sqli
2580: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
2590: 6d 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 m = *va_arg(ap,
25a0: 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
25b0: 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 72 65 ods*);. bre
25c0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 ak;. }. ca
25d0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
25e0: 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 20 _GETMALLOC: {.
25f0: 20 20 20 20 2f 2a 20 52 65 74 72 69 65 76 65 20 /* Retrieve
2600: 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 6c 6c the current mall
2610: 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 61 74 oc() implementat
2620: 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 ion */. if(
2630: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2640: 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 3d 3d nfig.m.xMalloc==
2650: 30 20 29 20 73 71 6c 69 74 65 33 4d 65 6d 53 65 0 ) sqlite3MemSe
2660: 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 20 20 tDefault();.
2670: 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 *va_arg(ap, sq
2680: 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 lite3_mem_method
2690: 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f s*) = sqlite3Glo
26a0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a 20 20 20 balConfig.m;.
26b0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
26c0: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
26d0: 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 55 53 CONFIG_MEMSTATUS
26e0: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 6e 61 : {. /* Ena
26f0: 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 ble or disable t
2700: 68 65 20 6d 61 6c 6c 6f 63 20 73 74 61 74 75 73 he malloc status
2710: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 2a 2f 0a 20 collection */.
2720: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
2730: 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 74 61 alConfig.bMemsta
2740: 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 t = va_arg(ap, i
2750: 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b nt);. break
2760: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 ;. }. case
2770: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 SQLITE_CONFIG_S
2780: 43 52 41 54 43 48 3a 20 7b 0a 20 20 20 20 20 20 CRATCH: {.
2790: 2f 2a 20 44 65 73 69 67 6e 61 74 65 20 61 20 62 /* Designate a b
27a0: 75 66 66 65 72 20 66 6f 72 20 73 63 72 61 74 63 uffer for scratc
27b0: 68 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 2a h memory space *
27c0: 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 /. sqlite3G
27d0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 63 72 lobalConfig.pScr
27e0: 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 atch = va_arg(ap
27f0: 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 , void*);.
2800: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
2810: 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 3d 20 fig.szScratch =
2820: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
2830: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2840: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 72 61 obalConfig.nScra
2850: 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 70 2c tch = va_arg(ap,
2860: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 int);. bre
2870: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 ak;. }. ca
2880: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
2890: 5f 50 41 47 45 43 41 43 48 45 3a 20 7b 0a 20 20 _PAGECACHE: {.
28a0: 20 20 20 20 2f 2a 20 44 65 73 69 67 6e 61 74 65 /* Designate
28b0: 20 61 20 62 75 66 66 65 72 20 66 6f 72 20 73 63 a buffer for sc
28c0: 72 61 74 63 68 20 6d 65 6d 6f 72 79 20 73 70 61 ratch memory spa
28d0: 63 65 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 ce */. sqli
28e0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
28f0: 70 50 61 67 65 20 3d 20 76 61 5f 61 72 67 28 61 pPage = va_arg(a
2900: 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 p, void*);.
2910: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2920: 6e 66 69 67 2e 73 7a 50 61 67 65 20 3d 20 76 61 nfig.szPage = va
2930: 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 20 _arg(ap, int);.
2940: 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 sqlite3Glob
2950: 61 6c 43 6f 6e 66 69 67 2e 6e 50 61 67 65 20 3d alConfig.nPage =
2960: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
2970: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
2980: 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 53 }.. case S
2990: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 43 41 QLITE_CONFIG_PCA
29a0: 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 CHE: {. /*
29b0: 53 70 65 63 69 66 79 20 61 6e 20 61 6c 74 65 72 Specify an alter
29c0: 6e 61 74 69 76 65 20 6d 61 6c 6c 6f 63 20 69 6d native malloc im
29d0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a plementation */.
29e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
29f0: 62 61 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 balConfig.pcache
2a00: 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 = *va_arg(ap, s
2a10: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
2a20: 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 thods*);. b
2a30: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
2a40: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e case SQLITE_CON
2a50: 46 49 47 5f 47 45 54 50 43 41 43 48 45 3a 20 7b FIG_GETPCACHE: {
2a60: 0a 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 . if( sqlit
2a70: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
2a80: 63 61 63 68 65 2e 78 49 6e 69 74 3d 3d 30 20 29 cache.xInit==0 )
2a90: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
2aa0: 33 50 43 61 63 68 65 53 65 74 44 65 66 61 75 6c 3PCacheSetDefaul
2ab0: 74 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 t();. }.
2ac0: 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 *va_arg(ap, s
2ad0: 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 qlite3_pcache_me
2ae0: 74 68 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 thods*) = sqlite
2af0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 63 3GlobalConfig.pc
2b00: 61 63 68 65 3b 0a 20 20 20 20 20 20 62 72 65 61 ache;. brea
2b10: 6b 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 20 64 65 k;. }..#if de
2b20: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
2b30: 42 4c 45 5f 4d 45 4d 53 59 53 33 29 20 7c 7c 20 BLE_MEMSYS3) ||
2b40: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2b50: 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 29 0a 20 NABLE_MEMSYS5).
2b60: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
2b70: 4f 4e 46 49 47 5f 48 45 41 50 3a 20 7b 0a 20 20 ONFIG_HEAP: {.
2b80: 20 20 20 20 2f 2a 20 44 65 73 69 67 6e 61 74 65 /* Designate
2b90: 20 61 20 62 75 66 66 65 72 20 66 6f 72 20 68 65 a buffer for he
2ba0: 61 70 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 ap memory space
2bb0: 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
2bc0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 GlobalConfig.pHe
2bd0: 61 70 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 ap = va_arg(ap,
2be0: 76 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 73 71 void*);. sq
2bf0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2c00: 67 2e 6e 48 65 61 70 20 3d 20 76 61 5f 61 72 67 g.nHeap = va_arg
2c10: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
2c20: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2c30: 6e 66 69 67 2e 6d 6e 52 65 71 20 3d 20 76 61 5f nfig.mnReq = va_
2c40: 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a 0a 20 arg(ap, int);..
2c50: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
2c60: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 48 65 GlobalConfig.pHe
2c70: 61 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ap==0 ){.
2c80: 20 2f 2a 20 49 66 20 74 68 65 20 68 65 61 70 20 /* If the heap
2c90: 70 6f 69 6e 74 65 72 20 69 73 20 4e 55 4c 4c 2c pointer is NULL,
2ca0: 20 74 68 65 6e 20 72 65 73 74 6f 72 65 20 74 68 then restore th
2cb0: 65 20 6d 61 6c 6c 6f 63 20 69 6d 70 6c 65 6d 65 e malloc impleme
2cc0: 6e 74 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 ntation.
2cd0: 2a 2a 20 62 61 63 6b 20 74 6f 20 4e 55 4c 4c 20 ** back to NULL
2ce0: 70 6f 69 6e 74 65 72 73 20 74 6f 6f 2e 20 20 54 pointers too. T
2cf0: 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 his will cause t
2d00: 68 65 20 6d 61 6c 6c 6f 63 20 74 6f 20 67 6f 0a he malloc to go.
2d10: 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b 20 ** back
2d20: 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 69 to its default i
2d30: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 68 mplementation wh
2d40: 65 6e 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 en sqlite3_initi
2d50: 61 6c 69 7a 65 28 29 20 69 73 0a 20 20 20 20 20 alize() is.
2d60: 20 20 20 2a 2a 20 72 75 6e 2e 0a 20 20 20 20 20 ** run..
2d70: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 */. me
2d80: 6d 73 65 74 28 26 73 71 6c 69 74 65 33 47 6c 6f mset(&sqlite3Glo
2d90: 62 61 6c 43 6f 6e 66 69 67 2e 6d 2c 20 30 2c 20 balConfig.m, 0,
2da0: 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 47 6c sizeof(sqlite3Gl
2db0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 29 29 3b 0a obalConfig.m));.
2dc0: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
2dd0: 20 20 20 20 20 2f 2a 20 54 68 65 20 68 65 61 70 /* The heap
2de0: 20 70 6f 69 6e 74 65 72 20 69 73 20 6e 6f 74 20 pointer is not
2df0: 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 6e 73 74 61 NULL, then insta
2e00: 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65 0a 20 20 ll one of the.
2e10: 20 20 20 20 20 20 2a 2a 20 6d 65 6d 35 2e 63 2f ** mem5.c/
2e20: 6d 65 6d 33 2e 63 20 6d 65 74 68 6f 64 73 2e 20 mem3.c methods.
2e30: 49 66 20 6e 65 69 74 68 65 72 20 45 4e 41 42 4c If neither ENABL
2e40: 45 5f 4d 45 4d 53 59 53 33 20 6e 6f 72 0a 20 20 E_MEMSYS3 nor.
2e50: 20 20 20 20 20 20 2a 2a 20 45 4e 41 42 4c 45 5f ** ENABLE_
2e60: 4d 45 4d 53 59 53 35 20 69 73 20 64 65 66 69 6e MEMSYS5 is defin
2e70: 65 64 2c 20 72 65 74 75 72 6e 20 61 6e 20 65 72 ed, return an er
2e80: 72 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 ror.. **
2e90: 74 68 65 20 64 65 66 61 75 6c 74 20 63 61 73 65 the default case
2ea0: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 65 and return an e
2eb0: 72 72 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f rror.. */
2ec0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
2ed0: 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a 20 20 NABLE_MEMSYS3.
2ee0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
2ef0: 62 61 6c 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 balConfig.m = *s
2f00: 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 qlite3MemGetMems
2f10: 79 73 33 28 29 3b 0a 23 65 6e 64 69 66 0a 23 69 ys3();.#endif.#i
2f20: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
2f30: 4c 45 5f 4d 45 4d 53 59 53 35 0a 20 20 20 20 20 LE_MEMSYS5.
2f40: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2f50: 43 6f 6e 66 69 67 2e 6d 20 3d 20 2a 73 71 6c 69 Config.m = *sqli
2f60: 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 35 te3MemGetMemsys5
2f70: 28 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 ();.#endif.
2f80: 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a }. break;.
2f90: 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }.#endif..
2fa0: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
2fb0: 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 45 3a 20 NFIG_LOOKASIDE:
2fc0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 {. sqlite3G
2fd0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4c 6f lobalConfig.szLo
2fe0: 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 67 okaside = va_arg
2ff0: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
3000: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
3010: 6e 66 69 67 2e 6e 4c 6f 6f 6b 61 73 69 64 65 20 nfig.nLookaside
3020: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
3030: 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a );. break;.
3040: 20 20 20 20 7d 0a 0a 20 20 20 20 64 65 66 61 75 }.. defau
3050: 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d lt: {. rc =
3060: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
3070: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
3080: 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 }. }. va_end(a
3090: 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
30a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 .}../*.** Set up
30b0: 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 62 the lookaside b
30c0: 75 66 66 65 72 73 20 66 6f 72 20 61 20 64 61 74 uffers for a dat
30d0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
30e0: 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 ..** Return SQLI
30f0: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 TE_OK on success
3100: 2e 20 20 0a 2a 2a 20 49 66 20 6c 6f 6f 6b 61 73 . .** If lookas
3110: 69 64 65 20 69 73 20 61 6c 72 65 61 64 79 20 61 ide is already a
3120: 63 74 69 76 65 2c 20 72 65 74 75 72 6e 20 53 51 ctive, return SQ
3130: 4c 49 54 45 5f 42 55 53 59 2e 0a 2a 2a 0a 2a 2a LITE_BUSY..**.**
3140: 20 54 68 65 20 73 7a 20 70 61 72 61 6d 65 74 65 The sz paramete
3150: 72 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 r is the number
3160: 6f 66 20 62 79 74 65 73 20 69 6e 20 65 61 63 68 of bytes in each
3170: 20 6c 6f 6f 6b 61 73 69 64 65 20 73 6c 6f 74 2e lookaside slot.
3180: 0a 2a 2a 20 54 68 65 20 63 6e 74 20 70 61 72 61 .** The cnt para
3190: 6d 65 74 65 72 20 69 73 20 74 68 65 20 6e 75 6d meter is the num
31a0: 62 65 72 20 6f 66 20 73 6c 6f 74 73 2e 20 20 49 ber of slots. I
31b0: 66 20 70 53 74 61 72 74 20 69 73 20 4e 55 4c 4c f pStart is NULL
31c0: 20 74 68 65 0a 2a 2a 20 73 70 61 63 65 20 66 6f the.** space fo
31d0: 72 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 r the lookaside
31e0: 6d 65 6d 6f 72 79 20 69 73 20 6f 62 74 61 69 6e memory is obtain
31f0: 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f ed from sqlite3_
3200: 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 49 66 20 malloc()..** If
3210: 70 53 74 61 72 74 20 69 73 20 6e 6f 74 20 4e 55 pStart is not NU
3220: 4c 4c 20 74 68 65 6e 20 69 74 20 69 73 20 73 7a LL then it is sz
3230: 2a 63 6e 74 20 62 79 74 65 73 20 6f 66 20 6d 65 *cnt bytes of me
3240: 6d 6f 72 79 20 74 6f 20 75 73 65 20 66 6f 72 0a mory to use for.
3250: 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 ** the lookaside
3260: 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 74 memory..*/.stat
3270: 69 63 20 69 6e 74 20 73 65 74 75 70 4c 6f 6f 6b ic int setupLook
3280: 61 73 69 64 65 28 73 71 6c 69 74 65 33 20 2a 64 aside(sqlite3 *d
3290: 62 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 b, void *pBuf, i
32a0: 6e 74 20 73 7a 2c 20 69 6e 74 20 63 6e 74 29 7b nt sz, int cnt){
32b0: 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 72 74 3b . void *pStart;
32c0: 0a 20 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 . if( db->looka
32d0: 73 69 64 65 2e 6e 4f 75 74 20 29 7b 0a 20 20 20 side.nOut ){.
32e0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
32f0: 55 53 59 3b 0a 20 20 7d 0a 20 20 2f 2a 20 46 72 USY;. }. /* Fr
3300: 65 65 20 61 6e 79 20 65 78 69 73 74 69 6e 67 20 ee any existing
3310: 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 72 lookaside buffer
3320: 20 66 6f 72 20 74 68 69 73 20 68 61 6e 64 6c 65 for this handle
3330: 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 6c 6c before. ** all
3340: 6f 63 61 74 69 6e 67 20 61 20 6e 65 77 20 6f 6e ocating a new on
3350: 65 20 73 6f 20 77 65 20 64 6f 6e 27 74 20 68 61 e so we don't ha
3360: 76 65 20 74 6f 20 68 61 76 65 20 73 70 61 63 65 ve to have space
3370: 20 66 6f 72 20 0a 20 20 2a 2a 20 62 6f 74 68 20 for . ** both
3380: 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 at the same time
3390: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 64 62 2d .. */. if( db-
33a0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c >lookaside.bMall
33b0: 6f 63 65 64 20 29 7b 0a 20 20 20 20 73 71 6c 69 oced ){. sqli
33c0: 74 65 33 5f 66 72 65 65 28 64 62 2d 3e 6c 6f 6f te3_free(db->loo
33d0: 6b 61 73 69 64 65 2e 70 53 74 61 72 74 29 3b 0a kaside.pStart);.
33e0: 20 20 7d 0a 20 20 2f 2a 20 54 68 65 20 73 69 7a }. /* The siz
33f0: 65 20 6f 66 20 61 20 6c 6f 6f 6b 61 73 69 64 65 e of a lookaside
3400: 20 73 6c 6f 74 20 6e 65 65 64 73 20 74 6f 20 62 slot needs to b
3410: 65 20 6c 61 72 67 65 72 20 74 68 61 6e 20 61 20 e larger than a
3420: 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 74 6f 20 pointer. ** to
3430: 62 65 20 75 73 65 66 75 6c 2e 0a 20 20 2a 2f 0a be useful.. */.
3440: 20 20 69 66 28 20 73 7a 3c 3d 28 69 6e 74 29 73 if( sz<=(int)s
3450: 69 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 izeof(LookasideS
3460: 6c 6f 74 2a 29 20 29 20 73 7a 20 3d 20 30 3b 0a lot*) ) sz = 0;.
3470: 20 20 69 66 28 20 63 6e 74 3c 30 20 29 20 63 6e if( cnt<0 ) cn
3480: 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 73 7a 3d t = 0;. if( sz=
3490: 3d 30 20 7c 7c 20 63 6e 74 3d 3d 30 20 29 7b 0a =0 || cnt==0 ){.
34a0: 20 20 20 20 73 7a 20 3d 20 30 3b 0a 20 20 20 20 sz = 0;.
34b0: 70 53 74 61 72 74 20 3d 20 30 3b 0a 20 20 7d 65 pStart = 0;. }e
34c0: 6c 73 65 20 69 66 28 20 70 42 75 66 3d 3d 30 20 lse if( pBuf==0
34d0: 29 7b 0a 20 20 20 20 73 7a 20 3d 20 28 73 7a 20 ){. sz = (sz
34e0: 2b 20 37 29 26 7e 37 3b 0a 20 20 20 20 73 71 6c + 7)&~7;. sql
34f0: 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d ite3BeginBenignM
3500: 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 70 53 74 alloc();. pSt
3510: 61 72 74 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c art = sqlite3Mal
3520: 6c 6f 63 28 20 73 7a 2a 63 6e 74 20 29 3b 0a 20 loc( sz*cnt );.
3530: 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e sqlite3EndBen
3540: 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 7d ignMalloc();. }
3550: 65 6c 73 65 7b 0a 20 20 20 20 73 7a 20 3d 20 73 else{. sz = s
3560: 7a 26 7e 37 3b 0a 20 20 20 20 70 53 74 61 72 74 z&~7;. pStart
3570: 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 20 20 64 = pBuf;. }. d
3580: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 b->lookaside.pSt
3590: 61 72 74 20 3d 20 70 53 74 61 72 74 3b 0a 20 20 art = pStart;.
35a0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 db->lookaside.pF
35b0: 72 65 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c ree = 0;. db->l
35c0: 6f 6f 6b 61 73 69 64 65 2e 73 7a 20 3d 20 28 75 ookaside.sz = (u
35d0: 31 36 29 73 7a 3b 0a 20 20 69 66 28 20 70 53 74 16)sz;. if( pSt
35e0: 61 72 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 art ){. int i
35f0: 3b 0a 20 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 ;. LookasideS
3600: 6c 6f 74 20 2a 70 3b 0a 20 20 20 20 61 73 73 65 lot *p;. asse
3610: 72 74 28 20 73 7a 20 3e 20 73 69 7a 65 6f 66 28 rt( sz > sizeof(
3620: 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 20 LookasideSlot*)
3630: 29 3b 0a 20 20 20 20 70 20 3d 20 28 4c 6f 6f 6b );. p = (Look
3640: 61 73 69 64 65 53 6c 6f 74 2a 29 70 53 74 61 72 asideSlot*)pStar
3650: 74 3b 0a 20 20 20 20 66 6f 72 28 69 3d 63 6e 74 t;. for(i=cnt
3660: 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a -1; i>=0; i--){.
3670: 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d p->pNext =
3680: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 db->lookaside.p
3690: 46 72 65 65 3b 0a 20 20 20 20 20 20 64 62 2d 3e Free;. db->
36a0: 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 72 65 65 20 lookaside.pFree
36b0: 3d 20 70 3b 0a 20 20 20 20 20 20 70 20 3d 20 28 = p;. p = (
36c0: 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 26 LookasideSlot*)&
36d0: 28 28 75 38 2a 29 70 29 5b 73 7a 5d 3b 0a 20 20 ((u8*)p)[sz];.
36e0: 20 20 7d 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b }. db->look
36f0: 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 70 3b 0a aside.pEnd = p;.
3700: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 db->lookasid
3710: 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 31 3b 0a e.bEnabled = 1;.
3720: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 db->lookasid
3730: 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 70 42 e.bMalloced = pB
3740: 75 66 3d 3d 30 20 3f 31 3a 30 3b 0a 20 20 7d 65 uf==0 ?1:0;. }e
3750: 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f lse{. db->loo
3760: 6b 61 73 69 64 65 2e 70 45 6e 64 20 3d 20 30 3b kaside.pEnd = 0;
3770: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
3780: 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 30 3b de.bEnabled = 0;
3790: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
37a0: 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 3d 20 30 de.bMalloced = 0
37b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
37c0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
37d0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d 75 ** Return the mu
37e0: 74 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 77 tex associated w
37f0: 69 74 68 20 61 20 64 61 74 61 62 61 73 65 20 63 ith a database c
3800: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 onnection..*/.sq
3810: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c lite3_mutex *sql
3820: 69 74 65 33 5f 64 62 5f 6d 75 74 65 78 28 73 71 ite3_db_mutex(sq
3830: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 lite3 *db){. re
3840: 74 75 72 6e 20 64 62 2d 3e 6d 75 74 65 78 3b 0a turn db->mutex;.
3850: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 }../*.** Configu
3860: 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67 73 20 ration settings
3870: 66 6f 72 20 61 6e 20 69 6e 64 69 76 69 64 75 61 for an individua
3880: 6c 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 l database conne
3890: 63 74 69 6f 6e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ction.*/.int sql
38a0: 69 74 65 33 5f 64 62 5f 63 6f 6e 66 69 67 28 73 ite3_db_config(s
38b0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
38c0: 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c op, ...){. va_l
38d0: 69 73 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 ist ap;. int rc
38e0: 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 2c ;. va_start(ap,
38f0: 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 28 20 op);. switch(
3900: 6f 70 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53 op ){. case S
3910: 51 4c 49 54 45 5f 44 42 43 4f 4e 46 49 47 5f 4c QLITE_DBCONFIG_L
3920: 4f 4f 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 OOKASIDE: {.
3930: 20 20 76 6f 69 64 20 2a 70 42 75 66 20 3d 20 76 void *pBuf = v
3940: 61 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 a_arg(ap, void*)
3950: 3b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 3d ;. int sz =
3960: 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 va_arg(ap, int)
3970: 3b 0a 20 20 20 20 20 20 69 6e 74 20 63 6e 74 20 ;. int cnt
3980: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
3990: 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 65 );. rc = se
39a0: 74 75 70 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c tupLookaside(db,
39b0: 20 70 42 75 66 2c 20 73 7a 2c 20 63 6e 74 29 3b pBuf, sz, cnt);
39c0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
39d0: 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a }. default:
39e0: 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 {. rc = SQ
39f0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 LITE_ERROR;.
3a00: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 break;. }.
3a10: 20 7d 0a 20 20 76 61 5f 65 6e 64 28 61 70 29 3b }. va_end(ap);
3a20: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
3a30: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
3a40: 72 75 65 20 69 66 20 74 68 65 20 62 75 66 66 65 rue if the buffe
3a50: 72 20 7a 5b 30 2e 2e 6e 2d 31 5d 20 63 6f 6e 74 r z[0..n-1] cont
3a60: 61 69 6e 73 20 61 6c 6c 20 73 70 61 63 65 73 2e ains all spaces.
3a70: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
3a80: 6c 6c 53 70 61 63 65 73 28 63 6f 6e 73 74 20 63 llSpaces(const c
3a90: 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b 0a har *z, int n){.
3aa0: 20 20 77 68 69 6c 65 28 20 6e 3e 30 20 26 26 20 while( n>0 &&
3ab0: 7a 5b 6e 2d 31 5d 3d 3d 27 20 27 20 29 7b 20 6e z[n-1]==' ' ){ n
3ac0: 2d 2d 3b 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e --; }. return n
3ad0: 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 ==0;.}../*.** Th
3ae0: 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c is is the defaul
3af0: 74 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 t collating func
3b00: 74 69 6f 6e 20 6e 61 6d 65 64 20 22 42 49 4e 41 tion named "BINA
3b10: 52 59 22 20 77 68 69 63 68 20 69 73 20 61 6c 77 RY" which is alw
3b20: 61 79 73 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 ays.** available
3b30: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 ..**.** If the p
3b40: 61 64 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 adFlag argument
3b50: 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e is not NULL then
3b60: 20 73 70 61 63 65 20 70 61 64 64 69 6e 67 20 61 space padding a
3b70: 74 20 74 68 65 20 65 6e 64 0a 2a 2a 20 6f 66 20 t the end.** of
3b80: 73 74 72 69 6e 67 73 20 69 73 20 69 67 6e 6f 72 strings is ignor
3b90: 65 64 2e 20 20 54 68 69 73 20 69 6d 70 6c 65 6d ed. This implem
3ba0: 65 6e 74 73 20 74 68 65 20 52 54 52 49 4d 20 63 ents the RTRIM c
3bb0: 6f 6c 6c 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 ollation..*/.sta
3bc0: 74 69 63 20 69 6e 74 20 62 69 6e 43 6f 6c 6c 46 tic int binCollF
3bd0: 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 70 61 64 unc(. void *pad
3be0: 46 6c 61 67 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 Flag,. int nKey
3bf0: 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 1, const void *p
3c00: 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 Key1,. int nKey
3c10: 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 2, const void *p
3c20: 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 63 Key2.){. int rc
3c30: 2c 20 6e 3b 0a 20 20 6e 20 3d 20 6e 4b 65 79 31 , n;. n = nKey1
3c40: 3c 6e 4b 65 79 32 20 3f 20 6e 4b 65 79 31 20 3a <nKey2 ? nKey1 :
3c50: 20 6e 4b 65 79 32 3b 0a 20 20 72 63 20 3d 20 6d nKey2;. rc = m
3c60: 65 6d 63 6d 70 28 70 4b 65 79 31 2c 20 70 4b 65 emcmp(pKey1, pKe
3c70: 79 32 2c 20 6e 29 3b 0a 20 20 69 66 28 20 72 63 y2, n);. if( rc
3c80: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 ==0 ){. if( p
3c90: 61 64 46 6c 61 67 0a 20 20 20 20 20 26 26 20 61 adFlag. && a
3ca0: 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 72 2a llSpaces(((char*
3cb0: 29 70 4b 65 79 31 29 2b 6e 2c 20 6e 4b 65 79 31 )pKey1)+n, nKey1
3cc0: 2d 6e 29 0a 20 20 20 20 20 26 26 20 61 6c 6c 53 -n). && allS
3cd0: 70 61 63 65 73 28 28 28 63 68 61 72 2a 29 70 4b paces(((char*)pK
3ce0: 65 79 32 29 2b 6e 2c 20 6e 4b 65 79 32 2d 6e 29 ey2)+n, nKey2-n)
3cf0: 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
3d00: 20 4c 65 61 76 65 20 72 63 20 75 6e 63 68 61 6e Leave rc unchan
3d10: 67 65 64 20 61 74 20 30 20 2a 2f 0a 20 20 20 20 ged at 0 */.
3d20: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 }else{. rc
3d30: 3d 20 6e 4b 65 79 31 20 2d 20 6e 4b 65 79 32 3b = nKey1 - nKey2;
3d40: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
3d50: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
3d60: 20 41 6e 6f 74 68 65 72 20 62 75 69 6c 74 2d 69 Another built-i
3d70: 6e 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 n collating sequ
3d80: 65 6e 63 65 3a 20 4e 4f 43 41 53 45 2e 20 0a 2a ence: NOCASE. .*
3d90: 2a 0a 2a 2a 20 54 68 69 73 20 63 6f 6c 6c 61 74 *.** This collat
3da0: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 ing sequence is
3db0: 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 75 intended to be u
3dc0: 73 65 64 20 66 6f 72 20 22 63 61 73 65 20 69 6e sed for "case in
3dd0: 64 65 70 65 6e 64 61 6e 74 0a 2a 2a 20 63 6f 6d dependant.** com
3de0: 70 61 72 69 73 6f 6e 22 2e 20 53 51 4c 69 74 65 parison". SQLite
3df0: 27 73 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 's knowledge of
3e00: 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 72 20 upper and lower
3e10: 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 case equivalents
3e20: 0a 2a 2a 20 65 78 74 65 6e 64 73 20 6f 6e 6c 79 .** extends only
3e30: 20 74 6f 20 74 68 65 20 32 36 20 63 68 61 72 61 to the 26 chara
3e40: 63 74 65 72 73 20 75 73 65 64 20 69 6e 20 74 68 cters used in th
3e50: 65 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 e English langua
3e60: 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 74 20 74 68 65 ge..**.** At the
3e70: 20 6d 6f 6d 65 6e 74 20 74 68 65 72 65 20 69 73 moment there is
3e80: 20 6f 6e 6c 79 20 61 20 55 54 46 2d 38 20 69 6d only a UTF-8 im
3e90: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2f plementation..*/
3ea0: 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 63 61 .static int noca
3eb0: 73 65 43 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 28 seCollatingFunc(
3ec0: 0a 20 20 76 6f 69 64 20 2a 4e 6f 74 55 73 65 64 . void *NotUsed
3ed0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20 63 ,. int nKey1, c
3ee0: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 31 onst void *pKey1
3ef0: 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c 20 63 ,. int nKey2, c
3f00: 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 32 onst void *pKey2
3f10: 0a 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 73 71 .){. int r = sq
3f20: 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 28 0a 20 lite3StrNICmp(.
3f30: 20 20 20 20 20 28 63 6f 6e 73 74 20 63 68 61 72 (const char
3f40: 20 2a 29 70 4b 65 79 31 2c 20 28 63 6f 6e 73 74 *)pKey1, (const
3f50: 20 63 68 61 72 20 2a 29 70 4b 65 79 32 2c 20 28 char *)pKey2, (
3f60: 6e 4b 65 79 31 3c 6e 4b 65 79 32 29 3f 6e 4b 65 nKey1<nKey2)?nKe
3f70: 79 31 3a 6e 4b 65 79 32 29 3b 0a 20 20 55 4e 55 y1:nKey2);. UNU
3f80: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
3f90: 74 55 73 65 64 29 3b 0a 20 20 69 66 28 20 30 3d tUsed);. if( 0=
3fa0: 3d 72 20 29 7b 0a 20 20 20 20 72 20 3d 20 6e 4b =r ){. r = nK
3fb0: 65 79 31 2d 6e 4b 65 79 32 3b 0a 20 20 7d 0a 20 ey1-nKey2;. }.
3fc0: 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a return r;.}../*
3fd0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 52 .** Return the R
3fe0: 4f 57 49 44 20 6f 66 20 74 68 65 20 6d 6f 73 74 OWID of the most
3ff0: 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 0a 2a recent insert.*
4000: 2f 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 73 /.sqlite_int64 s
4010: 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 qlite3_last_inse
4020: 72 74 5f 72 6f 77 69 64 28 73 71 6c 69 74 65 33 rt_rowid(sqlite3
4030: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 *db){. return
4040: 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 3b 0a 7d db->lastRowid;.}
4050: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
4060: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 he number of cha
4070: 6e 67 65 73 20 69 6e 20 74 68 65 20 6d 6f 73 74 nges in the most
4080: 20 72 65 63 65 6e 74 20 63 61 6c 6c 20 74 6f 20 recent call to
4090: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 2e 0a sqlite3_exec()..
40a0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
40b0: 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a hanges(sqlite3 *
40c0: 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 db){. return db
40d0: 2d 3e 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a ->nChange;.}../*
40e0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
40f0: 75 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 umber of changes
4100: 20 73 69 6e 63 65 20 74 68 65 20 64 61 74 61 62 since the datab
4110: 61 73 65 20 68 61 6e 64 6c 65 20 77 61 73 20 6f ase handle was o
4120: 70 65 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 pened..*/.int sq
4130: 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e lite3_total_chan
4140: 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 ges(sqlite3 *db)
4150: 7b 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6e {. return db->n
4160: 54 6f 74 61 6c 43 68 61 6e 67 65 3b 0a 7d 0a 0a TotalChange;.}..
4170: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 /*.** Close all
4180: 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 2e open savepoints.
4190: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6f This function o
41a0: 6e 6c 79 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 nly manipulates
41b0: 66 69 65 6c 64 73 20 6f 66 20 74 68 65 0a 2a 2a fields of the.**
41c0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
41d0: 20 6f 62 6a 65 63 74 2c 20 69 74 20 64 6f 65 73 object, it does
41e0: 20 6e 6f 74 20 63 6c 6f 73 65 20 61 6e 79 20 73 not close any s
41f0: 61 76 65 70 6f 69 6e 74 73 20 74 68 61 74 20 6d avepoints that m
4200: 61 79 20 62 65 20 6f 70 65 6e 0a 2a 2a 20 61 74 ay be open.** at
4210: 20 74 68 65 20 62 2d 74 72 65 65 2f 70 61 67 65 the b-tree/page
4220: 72 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 76 6f 69 64 r level..*/.void
4230: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 sqlite3CloseSav
4240: 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 65 33 20 epoints(sqlite3
4250: 2a 64 62 29 7b 0a 20 20 77 68 69 6c 65 28 20 64 *db){. while( d
4260: 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 29 7b b->pSavepoint ){
4270: 0a 20 20 20 20 53 61 76 65 70 6f 69 6e 74 20 2a . Savepoint *
4280: 70 54 6d 70 20 3d 20 64 62 2d 3e 70 53 61 76 65 pTmp = db->pSave
4290: 70 6f 69 6e 74 3b 0a 20 20 20 20 64 62 2d 3e 70 point;. db->p
42a0: 53 61 76 65 70 6f 69 6e 74 20 3d 20 70 54 6d 70 Savepoint = pTmp
42b0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c ->pNext;. sql
42c0: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 ite3DbFree(db, p
42d0: 54 6d 70 29 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e Tmp);. }. db->
42e0: 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a nSavepoint = 0;.
42f0: 20 20 64 62 2d 3e 69 73 54 72 61 6e 73 61 63 74 db->isTransact
4300: 69 6f 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 ionSavepoint = 0
4310: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 ;.}../*.** Close
4320: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 53 51 4c an existing SQL
4330: 69 74 65 20 64 61 74 61 62 61 73 65 0a 2a 2f 0a ite database.*/.
4340: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 int sqlite3_clos
4350: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a e(sqlite3 *db){.
4360: 20 20 48 61 73 68 45 6c 65 6d 20 2a 69 3b 0a 20 HashElem *i;.
4370: 20 69 6e 74 20 6a 3b 0a 0a 20 20 69 66 28 20 21 int j;.. if( !
4380: 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e db ){. return
4390: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
43a0: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 if( !sqlite3Sa
43b0: 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f fetyCheckSickOrO
43c0: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 k(db) ){. ret
43d0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
43e0: 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 E;. }. sqlite3
43f0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
4400: 3e 6d 75 74 65 78 29 3b 0a 0a 23 69 66 64 65 66 >mutex);..#ifdef
4410: 20 53 51 4c 49 54 45 5f 53 53 45 0a 20 20 7b 0a SQLITE_SSE. {.
4420: 20 20 20 20 65 78 74 65 72 6e 20 76 6f 69 64 20 extern void
4430: 73 71 6c 69 74 65 33 53 73 65 43 6c 65 61 6e 75 sqlite3SseCleanu
4440: 70 28 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 p(sqlite3*);.
4450: 20 73 71 6c 69 74 65 33 53 73 65 43 6c 65 61 6e sqlite3SseClean
4460: 75 70 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 up(db);. }.#end
4470: 69 66 20 0a 0a 20 20 73 71 6c 69 74 65 33 52 65 if .. sqlite3Re
4480: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
4490: 61 28 64 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 a(db, 0);.. /*
44a0: 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
44b0: 20 69 73 20 6f 70 65 6e 2c 20 74 68 65 20 52 65 is open, the Re
44c0: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
44d0: 61 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 0a 20 a() call above.
44e0: 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 61 76 ** will not hav
44f0: 65 20 63 61 6c 6c 65 64 20 74 68 65 20 78 44 69 e called the xDi
4500: 73 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f sconnect() metho
4510: 64 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 61 6c d on any virtual
4520: 0a 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 . ** tables in
4530: 74 68 65 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b the db->aVTrans[
4540: 5d 20 61 72 72 61 79 2e 20 54 68 65 20 66 6f 6c ] array. The fol
4550: 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 56 74 lowing sqlite3Vt
4560: 61 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 20 2a abRollback(). *
4570: 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 * call will do s
4580: 6f 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 64 6f o. We need to do
4590: 20 74 68 69 73 20 62 65 66 6f 72 65 20 74 68 65 this before the
45a0: 20 63 68 65 63 6b 20 66 6f 72 20 61 63 74 69 76 check for activ
45b0: 65 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 e. ** SQL state
45c0: 6d 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 73 20 ments below, as
45d0: 74 68 65 20 76 2d 74 61 62 6c 65 20 69 6d 70 6c the v-table impl
45e0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 20 62 ementation may b
45f0: 65 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 e storing. ** s
4600: 6f 6d 65 20 70 72 65 70 61 72 65 64 20 73 74 61 ome prepared sta
4610: 74 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e 61 6c tements internal
4620: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 ly.. */. sqlit
4630: 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 e3VtabRollback(d
4640: 62 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 b);.. /* If the
4650: 72 65 20 61 72 65 20 61 6e 79 20 6f 75 74 73 74 re are any outst
4660: 61 6e 64 69 6e 67 20 56 4d 73 2c 20 72 65 74 75 anding VMs, retu
4670: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 rn SQLITE_BUSY.
4680: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70 56 64 */. if( db->pVd
4690: 62 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 be ){. sqlite
46a0: 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 3Error(db, SQLIT
46b0: 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 E_BUSY, .
46c0: 20 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 "unable to clos
46d0: 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c e due to unfinal
46e0: 69 73 65 64 20 73 74 61 74 65 6d 65 6e 74 73 22 ised statements"
46f0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
4700: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
4710: 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 72 utex);. retur
4720: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
4730: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c }. assert( sql
4740: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
4750: 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 3b 0a 0a ickOrOk(db) );..
4760: 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d for(j=0; j<db-
4770: 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 >nDb; j++){.
4780: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d Btree *pBt = db-
4790: 3e 61 44 62 5b 6a 5d 2e 70 42 74 3b 0a 20 20 20 >aDb[j].pBt;.
47a0: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 if( pBt && sqli
47b0: 74 65 33 42 74 72 65 65 49 73 49 6e 42 61 63 6b te3BtreeIsInBack
47c0: 75 70 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 up(pBt) ){.
47d0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
47e0: 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a , SQLITE_BUSY, .
47f0: 20 20 20 20 20 20 20 20 20 20 22 75 6e 61 62 6c "unabl
4800: 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20 74 e to close due t
4810: 6f 20 75 6e 66 69 6e 69 73 68 65 64 20 62 61 63 o unfinished bac
4820: 6b 75 70 20 6f 70 65 72 61 74 69 6f 6e 22 29 3b kup operation");
4830: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
4840: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
4850: 75 74 65 78 29 3b 0a 20 20 20 20 20 20 72 65 74 utex);. ret
4860: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
4870: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
4880: 20 46 72 65 65 20 61 6e 79 20 6f 75 74 73 74 61 Free any outsta
4890: 6e 64 69 6e 67 20 53 61 76 65 70 6f 69 6e 74 20 nding Savepoint
48a0: 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f 0a 20 structures. */.
48b0: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 sqlite3CloseSav
48c0: 65 70 6f 69 6e 74 73 28 64 62 29 3b 0a 0a 20 20 epoints(db);..
48d0: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e for(j=0; j<db->n
48e0: 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 Db; j++){. st
48f0: 72 75 63 74 20 44 62 20 2a 70 44 62 20 3d 20 26 ruct Db *pDb = &
4900: 64 62 2d 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 db->aDb[j];.
4910: 69 66 28 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a if( pDb->pBt ){.
4920: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
4930: 65 65 43 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 eeClose(pDb->pBt
4940: 29 3b 0a 20 20 20 20 20 20 70 44 62 2d 3e 70 42 );. pDb->pB
4950: 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 t = 0;. if(
4960: 20 6a 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 j!=1 ){.
4970: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 20 3d 20 pDb->pSchema =
4980: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0;. }. }
4990: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 . }. sqlite3Re
49a0: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
49b0: 61 28 64 62 2c 20 30 29 3b 0a 20 20 61 73 73 65 a(db, 0);. asse
49c0: 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d 32 20 29 rt( db->nDb<=2 )
49d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e ;. assert( db->
49e0: 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53 74 61 74 aDb==db->aDbStat
49f0: 69 63 20 29 3b 0a 20 20 66 6f 72 28 6a 3d 30 3b ic );. for(j=0;
4a00: 20 6a 3c 41 72 72 61 79 53 69 7a 65 28 64 62 2d j<ArraySize(db-
4a10: 3e 61 46 75 6e 63 2e 61 29 3b 20 6a 2b 2b 29 7b >aFunc.a); j++){
4a20: 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 4e . FuncDef *pN
4a30: 65 78 74 2c 20 2a 70 48 61 73 68 2c 20 2a 70 3b ext, *pHash, *p;
4a40: 0a 20 20 20 20 66 6f 72 28 70 3d 64 62 2d 3e 61 . for(p=db->a
4a50: 46 75 6e 63 2e 61 5b 6a 5d 3b 20 70 3b 20 70 3d Func.a[j]; p; p=
4a60: 70 48 61 73 68 29 7b 0a 20 20 20 20 20 20 70 48 pHash){. pH
4a70: 61 73 68 20 3d 20 70 2d 3e 70 48 61 73 68 3b 0a ash = p->pHash;.
4a80: 20 20 20 20 20 20 77 68 69 6c 65 28 20 70 20 29 while( p )
4a90: 7b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74 20 {. pNext
4aa0: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 = p->pNext;.
4ab0: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
4ac0: 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 e(db, p);.
4ad0: 20 20 70 20 3d 20 70 4e 65 78 74 3b 0a 20 20 20 p = pNext;.
4ae0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 }. }. }.
4af0: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 for(i=sqliteHas
4b00: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 43 6f 6c hFirst(&db->aCol
4b10: 6c 53 65 71 29 3b 20 69 3b 20 69 3d 73 71 6c 69 lSeq); i; i=sqli
4b20: 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a teHashNext(i)){.
4b30: 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f CollSeq *pCo
4b40: 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 20 2a 29 ll = (CollSeq *)
4b50: 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 sqliteHashData(i
4b60: 29 3b 0a 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 );. /* Invoke
4b70: 20 61 6e 79 20 64 65 73 74 72 75 63 74 6f 72 73 any destructors
4b80: 20 72 65 67 69 73 74 65 72 65 64 20 66 6f 72 20 registered for
4b90: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
4ba0: 63 65 20 75 73 65 72 20 64 61 74 61 2e 20 2a 2f ce user data. */
4bb0: 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c . for(j=0; j<
4bc0: 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 69 3; j++){. i
4bd0: 66 28 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c f( pColl[j].xDel
4be0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 6f 6c ){. pCol
4bf0: 6c 5b 6a 5d 2e 78 44 65 6c 28 70 43 6f 6c 6c 5b l[j].xDel(pColl[
4c00: 6a 5d 2e 70 55 73 65 72 29 3b 0a 20 20 20 20 20 j].pUser);.
4c10: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c }. }. sql
4c20: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 ite3DbFree(db, p
4c30: 43 6f 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c Coll);. }. sql
4c40: 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 26 64 ite3HashClear(&d
4c50: 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a 23 69 b->aCollSeq);.#i
4c60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
4c70: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 T_VIRTUALTABLE.
4c80: 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 61 73 for(i=sqliteHas
4c90: 68 46 69 72 73 74 28 26 64 62 2d 3e 61 4d 6f 64 hFirst(&db->aMod
4ca0: 75 6c 65 29 3b 20 69 3b 20 69 3d 73 71 6c 69 74 ule); i; i=sqlit
4cb0: 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b 0a 20 eHashNext(i)){.
4cc0: 20 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 20 Module *pMod
4cd0: 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 6c 69 = (Module *)sqli
4ce0: 74 65 48 61 73 68 44 61 74 61 28 69 29 3b 0a 20 teHashData(i);.
4cf0: 20 20 20 69 66 28 20 70 4d 6f 64 2d 3e 78 44 65 if( pMod->xDe
4d00: 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 20 70 stroy ){. p
4d10: 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 28 70 4d Mod->xDestroy(pM
4d20: 6f 64 2d 3e 70 41 75 78 29 3b 0a 20 20 20 20 7d od->pAux);. }
4d30: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
4d40: 65 65 28 64 62 2c 20 70 4d 6f 64 29 3b 0a 20 20 ee(db, pMod);.
4d50: 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 }. sqlite3HashC
4d60: 6c 65 61 72 28 26 64 62 2d 3e 61 4d 6f 64 75 6c lear(&db->aModul
4d70: 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 e);.#endif.. sq
4d80: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 lite3Error(db, S
4d90: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 2f 2a QLITE_OK, 0); /*
4da0: 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 6e 79 Deallocates any
4db0: 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 73 74 cached error st
4dc0: 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 28 20 rings. */. if(
4dd0: 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 20 20 db->pErr ){.
4de0: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 sqlite3ValueFree
4df0: 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 7d 0a (db->pErr);. }.
4e00: 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 sqlite3CloseEx
4e10: 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a 0a 20 tensions(db);..
4e20: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
4e30: 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 3b ITE_MAGIC_ERROR;
4e40: 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d 70 2d .. /* The temp-
4e50: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 database schema
4e60: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 69 66 is allocated dif
4e70: 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 74 68 ferently from th
4e80: 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61 0a 20 e other schema.
4e90: 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 73 69 ** objects (usi
4ea0: 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 ng sqliteMalloc(
4eb0: 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e 73 74 ) directly, inst
4ec0: 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33 42 74 ead of sqlite3Bt
4ed0: 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a 20 20 reeSchema())..
4ee0: 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 20 74 ** So it needs t
4ef0: 6f 20 62 65 20 66 72 65 65 64 20 68 65 72 65 2e o be freed here.
4f00: 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 20 72 Todo: Why not r
4f10: 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 63 68 oll the temp sch
4f20: 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 74 68 ema into. ** th
4f30: 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d 61 6c e same sqliteMal
4f40: 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f 6e 65 loc() as the one
4f50: 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 73 20 that allocates
4f60: 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 20 20 the database .
4f70: 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a 20 20 ** structure?.
4f80: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 */. sqlite3DbFr
4f90: 65 65 28 64 62 2c 20 64 62 2d 3e 61 44 62 5b 31 ee(db, db->aDb[1
4fa0: 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 73 71 ].pSchema);. sq
4fb0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
4fc0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
4fd0: 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c 49 db->magic = SQLI
4fe0: 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 3b TE_MAGIC_CLOSED;
4ff0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
5000: 5f 66 72 65 65 28 64 62 2d 3e 6d 75 74 65 78 29 _free(db->mutex)
5010: 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e ;. assert( db->
5020: 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 3d 3d lookaside.nOut==
5030: 30 20 29 3b 20 20 2f 2a 20 46 61 69 6c 73 20 6f 0 ); /* Fails o
5040: 6e 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 n a lookaside me
5050: 6d 6f 72 79 20 6c 65 61 6b 20 2a 2f 0a 20 20 69 mory leak */. i
5060: 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 f( db->lookaside
5070: 2e 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a 20 20 .bMalloced ){.
5080: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 64 sqlite3_free(d
5090: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 b->lookaside.pSt
50a0: 61 72 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 art);. }. sqli
50b0: 74 65 33 5f 66 72 65 65 28 64 62 29 3b 0a 20 20 te3_free(db);.
50c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
50d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 ;.}../*.** Rollb
50e0: 61 63 6b 20 61 6c 6c 20 64 61 74 61 62 61 73 65 ack all database
50f0: 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 files..*/.void
5100: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 sqlite3RollbackA
5110: 6c 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b ll(sqlite3 *db){
5120: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 . int i;. int
5130: 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 20 61 inTrans = 0;. a
5140: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
5150: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 utex_held(db->mu
5160: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
5170: 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
5180: 6f 63 28 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b oc();. for(i=0;
5190: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 i<db->nDb; i++)
51a0: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 44 {. if( db->aD
51b0: 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 20 20 b[i].pBt ){.
51c0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 74 72 if( sqlite3Btr
51d0: 65 65 49 73 49 6e 54 72 61 6e 73 28 64 62 2d 3e eeIsInTrans(db->
51e0: 61 44 62 5b 69 5d 2e 70 42 74 29 20 29 7b 0a 20 aDb[i].pBt) ){.
51f0: 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 20 3d inTrans =
5200: 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1;. }.
5210: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f sqlite3BtreeRo
5220: 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 5b 69 llback(db->aDb[i
5230: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 64 62 ].pBt);. db
5240: 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 6e 73 ->aDb[i].inTrans
5250: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a = 0;. }. }.
5260: 20 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f 6c sqlite3VtabRol
5270: 6c 62 61 63 6b 28 64 62 29 3b 0a 20 20 73 71 6c lback(db);. sql
5280: 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c ite3EndBenignMal
5290: 6c 6f 63 28 29 3b 0a 0a 20 20 69 66 28 20 64 62 loc();.. if( db
52a0: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 49 ->flags&SQLITE_I
52b0: 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 7b 0a nternChanges ){.
52c0: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 sqlite3Expir
52d0: 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 ePreparedStateme
52e0: 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 73 71 6c nts(db);. sql
52f0: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 ite3ResetInterna
5300: 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a lSchema(db, 0);.
5310: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 }.. /* If one
5320: 20 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 has been config
5330: 75 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 ured, invoke the
5340: 20 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 rollback-hook c
5350: 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 allback */. if(
5360: 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 db->xRollbackCa
5370: 6c 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 llback && (inTra
5380: 6e 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 ns || !db->autoC
5390: 6f 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 ommit) ){. db
53a0: 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 ->xRollbackCallb
53b0: 61 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 ack(db->pRollbac
53c0: 6b 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a kArg);. }.}../*
53d0: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 .** Return a sta
53e0: 74 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 tic string that
53f0: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 describes the ki
5400: 6e 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 nd of error spec
5410: 69 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 ified in the.**
5420: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e argument..*/.con
5430: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
5440: 45 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a ErrStr(int rc){.
5450: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b const char *z;
5460: 0a 20 20 73 77 69 74 63 68 28 20 72 63 20 26 20 . switch( rc &
5470: 30 78 66 66 20 29 7b 0a 20 20 20 20 63 61 73 65 0xff ){. case
5480: 20 53 51 4c 49 54 45 5f 52 4f 57 3a 0a 20 20 20 SQLITE_ROW:.
5490: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 44 4f 4e case SQLITE_DON
54a0: 45 3a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 E:. case SQLI
54b0: 54 45 5f 4f 4b 3a 20 20 20 20 20 20 20 20 20 7a TE_OK: z
54c0: 20 3d 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 = "not an error
54d0: 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ";
54e0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
54f0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5500: 54 45 5f 45 52 52 4f 52 3a 20 20 20 20 20 20 7a TE_ERROR: z
5510: 20 3d 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 = "SQL logic er
5520: 72 6f 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 ror or missing d
5530: 61 74 61 62 61 73 65 22 3b 20 20 20 62 72 65 61 atabase"; brea
5540: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5550: 54 45 5f 50 45 52 4d 3a 20 20 20 20 20 20 20 7a TE_PERM: z
5560: 20 3d 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 = "access permi
5570: 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 3b 20 20 ssion denied";
5580: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5590: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
55a0: 54 45 5f 41 42 4f 52 54 3a 20 20 20 20 20 20 7a TE_ABORT: z
55b0: 20 3d 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 = "callback req
55c0: 75 65 73 74 65 64 20 71 75 65 72 79 20 61 62 6f uested query abo
55d0: 72 74 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 rt"; brea
55e0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
55f0: 54 45 5f 42 55 53 59 3a 20 20 20 20 20 20 20 7a TE_BUSY: z
5600: 20 3d 20 22 64 61 74 61 62 61 73 65 20 69 73 20 = "database is
5610: 6c 6f 63 6b 65 64 22 3b 20 20 20 20 20 20 20 20 locked";
5620: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5630: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5640: 54 45 5f 4c 4f 43 4b 45 44 3a 20 20 20 20 20 7a TE_LOCKED: z
5650: 20 3d 20 22 64 61 74 61 62 61 73 65 20 74 61 62 = "database tab
5660: 6c 65 20 69 73 20 6c 6f 63 6b 65 64 22 3b 20 20 le is locked";
5670: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5680: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5690: 54 45 5f 4e 4f 4d 45 4d 3a 20 20 20 20 20 20 7a TE_NOMEM: z
56a0: 20 3d 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 = "out of memor
56b0: 79 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 y";
56c0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
56d0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
56e0: 54 45 5f 52 45 41 44 4f 4e 4c 59 3a 20 20 20 7a TE_READONLY: z
56f0: 20 3d 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 = "attempt to w
5700: 72 69 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 rite a readonly
5710: 64 61 74 61 62 61 73 65 22 3b 20 20 62 72 65 61 database"; brea
5720: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5730: 54 45 5f 49 4e 54 45 52 52 55 50 54 3a 20 20 7a TE_INTERRUPT: z
5740: 20 3d 20 22 69 6e 74 65 72 72 75 70 74 65 64 22 = "interrupted"
5750: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
5760: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5770: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5780: 54 45 5f 49 4f 45 52 52 3a 20 20 20 20 20 20 7a TE_IOERR: z
5790: 20 3d 20 22 64 69 73 6b 20 49 2f 4f 20 65 72 72 = "disk I/O err
57a0: 6f 72 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 or";
57b0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
57c0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
57d0: 54 45 5f 43 4f 52 52 55 50 54 3a 20 20 20 20 7a TE_CORRUPT: z
57e0: 20 3d 20 22 64 61 74 61 62 61 73 65 20 64 69 73 = "database dis
57f0: 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f k image is malfo
5800: 72 6d 65 64 22 3b 20 20 20 20 20 20 62 72 65 61 rmed"; brea
5810: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5820: 54 45 5f 46 55 4c 4c 3a 20 20 20 20 20 20 20 7a TE_FULL: z
5830: 20 3d 20 22 64 61 74 61 62 61 73 65 20 6f 72 20 = "database or
5840: 64 69 73 6b 20 69 73 20 66 75 6c 6c 22 3b 20 20 disk is full";
5850: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5860: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5870: 54 45 5f 43 41 4e 54 4f 50 45 4e 3a 20 20 20 7a TE_CANTOPEN: z
5880: 20 3d 20 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 = "unable to op
5890: 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 en database file
58a0: 22 3b 20 20 20 20 20 20 20 20 20 20 62 72 65 61 "; brea
58b0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
58c0: 54 45 5f 45 4d 50 54 59 3a 20 20 20 20 20 20 7a TE_EMPTY: z
58d0: 20 3d 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 = "table contai
58e0: 6e 73 20 6e 6f 20 64 61 74 61 22 3b 20 20 20 20 ns no data";
58f0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5900: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5910: 54 45 5f 53 43 48 45 4d 41 3a 20 20 20 20 20 7a TE_SCHEMA: z
5920: 20 3d 20 22 64 61 74 61 62 61 73 65 20 73 63 68 = "database sch
5930: 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 ema has changed"
5940: 3b 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 ; brea
5950: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5960: 54 45 5f 54 4f 4f 42 49 47 3a 20 20 20 20 20 7a TE_TOOBIG: z
5970: 20 3d 20 22 53 74 72 69 6e 67 20 6f 72 20 42 4c = "String or BL
5980: 4f 42 20 65 78 63 65 65 64 65 64 20 73 69 7a 65 OB exceeded size
5990: 20 6c 69 6d 69 74 22 3b 20 20 20 20 62 72 65 61 limit"; brea
59a0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
59b0: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3a 20 7a TE_CONSTRAINT: z
59c0: 20 3d 20 22 63 6f 6e 73 74 72 61 69 6e 74 20 66 = "constraint f
59d0: 61 69 6c 65 64 22 3b 20 20 20 20 20 20 20 20 20 ailed";
59e0: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
59f0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5a00: 54 45 5f 4d 49 53 4d 41 54 43 48 3a 20 20 20 7a TE_MISMATCH: z
5a10: 20 3d 20 22 64 61 74 61 74 79 70 65 20 6d 69 73 = "datatype mis
5a20: 6d 61 74 63 68 22 3b 20 20 20 20 20 20 20 20 20 match";
5a30: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5a40: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5a50: 54 45 5f 4d 49 53 55 53 45 3a 20 20 20 20 20 7a TE_MISUSE: z
5a60: 20 3d 20 22 6c 69 62 72 61 72 79 20 72 6f 75 74 = "library rout
5a70: 69 6e 65 20 63 61 6c 6c 65 64 20 6f 75 74 20 6f ine called out o
5a80: 66 20 73 65 71 75 65 6e 63 65 22 3b 62 72 65 61 f sequence";brea
5a90: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5aa0: 54 45 5f 4e 4f 4c 46 53 3a 20 20 20 20 20 20 7a TE_NOLFS: z
5ab0: 20 3d 20 22 6c 61 72 67 65 20 66 69 6c 65 20 73 = "large file s
5ac0: 75 70 70 6f 72 74 20 69 73 20 64 69 73 61 62 6c upport is disabl
5ad0: 65 64 22 3b 20 20 20 20 20 20 20 20 62 72 65 61 ed"; brea
5ae0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5af0: 54 45 5f 41 55 54 48 3a 20 20 20 20 20 20 20 7a TE_AUTH: z
5b00: 20 3d 20 22 61 75 74 68 6f 72 69 7a 61 74 69 6f = "authorizatio
5b10: 6e 20 64 65 6e 69 65 64 22 3b 20 20 20 20 20 20 n denied";
5b20: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5b30: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5b40: 54 45 5f 46 4f 52 4d 41 54 3a 20 20 20 20 20 7a TE_FORMAT: z
5b50: 20 3d 20 22 61 75 78 69 6c 69 61 72 79 20 64 61 = "auxiliary da
5b60: 74 61 62 61 73 65 20 66 6f 72 6d 61 74 20 65 72 tabase format er
5b70: 72 6f 72 22 3b 20 20 20 20 20 20 20 62 72 65 61 ror"; brea
5b80: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5b90: 54 45 5f 52 41 4e 47 45 3a 20 20 20 20 20 20 7a TE_RANGE: z
5ba0: 20 3d 20 22 62 69 6e 64 20 6f 72 20 63 6f 6c 75 = "bind or colu
5bb0: 6d 6e 20 69 6e 64 65 78 20 6f 75 74 20 6f 66 20 mn index out of
5bc0: 72 61 6e 67 65 22 3b 20 20 20 20 20 62 72 65 61 range"; brea
5bd0: 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
5be0: 54 45 5f 4e 4f 54 41 44 42 3a 20 20 20 20 20 7a TE_NOTADB: z
5bf0: 20 3d 20 22 66 69 6c 65 20 69 73 20 65 6e 63 72 = "file is encr
5c00: 79 70 74 65 64 20 6f 72 20 69 73 20 6e 6f 74 20 ypted or is not
5c10: 61 20 64 61 74 61 62 61 73 65 22 3b 62 72 65 61 a database";brea
5c20: 6b 3b 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 k;. default:
5c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7a z
5c40: 20 3d 20 22 75 6e 6b 6e 6f 77 6e 20 65 72 72 6f = "unknown erro
5c50: 72 22 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 r";
5c60: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
5c70: 6b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 k;. }. return
5c80: 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 z;.}../*.** This
5c90: 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 routine impleme
5ca0: 6e 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 nts a busy callb
5cb0: 61 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 ack that sleeps
5cc0: 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 and tries.** aga
5cd0: 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f in until a timeo
5ce0: 75 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 ut value is reac
5cf0: 68 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 hed. The timeou
5d00: 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e t value is.** an
5d10: 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 integer number
5d20: 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 of milliseconds
5d30: 70 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 passed in as the
5d40: 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 first.** argume
5d50: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nt..*/.static in
5d60: 74 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 t sqliteDefaultB
5d70: 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f usyCallback(. vo
5d80: 69 64 20 2a 70 74 72 2c 20 20 20 20 20 20 20 20 id *ptr,
5d90: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
5da0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f se connection */
5db0: 0a 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 . int count
5dc0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
5dd0: 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 mber of times ta
5de0: 62 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 ble has been bus
5df0: 79 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 y */.){.#if SQLI
5e00: 54 45 5f 4f 53 5f 57 49 4e 20 7c 7c 20 28 64 65 TE_OS_WIN || (de
5e10: 66 69 6e 65 64 28 48 41 56 45 5f 55 53 4c 45 45 fined(HAVE_USLEE
5e20: 50 29 20 26 26 20 48 41 56 45 5f 55 53 4c 45 45 P) && HAVE_USLEE
5e30: 50 29 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 P). static cons
5e40: 74 20 75 38 20 64 65 6c 61 79 73 5b 5d 20 3d 0a t u8 delays[] =.
5e50: 20 20 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 { 1, 2, 5,
5e60: 31 30 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 10, 15, 20, 25,
5e70: 32 35 2c 20 20 32 35 2c 20 20 35 30 2c 20 20 35 25, 25, 50, 5
5e80: 30 2c 20 31 30 30 20 7d 3b 0a 20 20 73 74 61 74 0, 100 };. stat
5e90: 69 63 20 63 6f 6e 73 74 20 75 38 20 74 6f 74 61 ic const u8 tota
5ea0: 6c 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c ls[] =. { 0,
5eb0: 20 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20 33 1, 3, 8, 18, 3
5ec0: 33 2c 20 35 33 2c 20 37 38 2c 20 31 30 33 2c 20 3, 53, 78, 103,
5ed0: 31 32 38 2c 20 31 37 38 2c 20 32 32 38 20 7d 3b 128, 178, 228 };
5ee0: 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 .# define NDELAY
5ef0: 20 28 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 29 (sizeof(delays)
5f00: 2f 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30 /sizeof(delays[0
5f10: 5d 29 29 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 ])). sqlite3 *d
5f20: 62 20 3d 20 28 73 71 6c 69 74 65 33 20 2a 29 70 b = (sqlite3 *)p
5f30: 74 72 3b 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 tr;. int timeou
5f40: 74 20 3d 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 t = db->busyTime
5f50: 6f 75 74 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 out;. int delay
5f60: 2c 20 70 72 69 6f 72 3b 0a 0a 20 20 61 73 73 65 , prior;.. asse
5f70: 72 74 28 20 63 6f 75 6e 74 3e 3d 30 20 29 3b 0a rt( count>=0 );.
5f80: 20 20 69 66 28 20 63 6f 75 6e 74 20 3c 20 4e 44 if( count < ND
5f90: 45 4c 41 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 ELAY ){. dela
5fa0: 79 20 3d 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 y = delays[count
5fb0: 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 ];. prior = t
5fc0: 6f 74 61 6c 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 otals[count];.
5fd0: 7d 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c 61 79 }else{. delay
5fe0: 20 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c 41 59 = delays[NDELAY
5ff0: 2d 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d -1];. prior =
6000: 20 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 totals[NDELAY-1
6010: 5d 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75 6e 74 ] + delay*(count
6020: 2d 28 4e 44 45 4c 41 59 2d 31 29 29 3b 0a 20 20 -(NDELAY-1));.
6030: 7d 0a 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20 }. if( prior +
6040: 64 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 delay > timeout
6050: 29 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74 ){. delay = t
6060: 69 6d 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a imeout - prior;.
6070: 20 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 if( delay<=0
6080: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d ) return 0;. }
6090: 0a 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 . sqlite3OsSlee
60a0: 70 28 64 62 2d 3e 70 56 66 73 2c 20 64 65 6c 61 p(db->pVfs, dela
60b0: 79 2a 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 y*1000);. retur
60c0: 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c n 1;.#else. sql
60d0: 69 74 65 33 20 2a 64 62 20 3d 20 28 73 71 6c 69 ite3 *db = (sqli
60e0: 74 65 33 20 2a 29 70 74 72 3b 0a 20 20 69 6e 74 te3 *)ptr;. int
60f0: 20 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 71 6c timeout = ((sql
6100: 69 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 75 73 ite3 *)ptr)->bus
6110: 79 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 yTimeout;. if(
6120: 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e (count+1)*1000 >
6130: 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 timeout ){.
6140: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 return 0;. }.
6150: 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 64 sqlite3OsSleep(d
6160: 62 2d 3e 70 56 66 73 2c 20 31 30 30 30 30 30 30 b->pVfs, 1000000
6170: 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 );. return 1;.#
6180: 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 endif.}../*.** I
6190: 6e 76 6f 6b 65 20 74 68 65 20 67 69 76 65 6e 20 nvoke the given
61a0: 62 75 73 79 20 68 61 6e 64 6c 65 72 2e 0a 2a 2a busy handler..**
61b0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
61c0: 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 is called when
61d0: 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 66 61 69 an operation fai
61e0: 6c 65 64 20 77 69 74 68 20 61 20 6c 6f 63 6b 2e led with a lock.
61f0: 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75 74 .** If this rout
6200: 69 6e 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d ine returns non-
6210: 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b 20 69 zero, the lock i
6220: 73 20 72 65 74 72 69 65 64 2e 20 20 49 66 20 69 s retried. If i
6230: 74 0a 2a 2a 20 72 65 74 75 72 6e 73 20 30 2c 20 t.** returns 0,
6240: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 62 the operation ab
6250: 6f 72 74 73 20 77 69 74 68 20 61 6e 20 53 51 4c orts with an SQL
6260: 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 2e 0a ITE_BUSY error..
6270: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e */.int sqlite3In
6280: 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 vokeBusyHandler(
6290: 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 70 29 7b BusyHandler *p){
62a0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 . int rc;. if(
62b0: 20 4e 45 56 45 52 28 70 3d 3d 30 29 20 7c 7c 20 NEVER(p==0) ||
62c0: 70 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c 7c 20 70 p->xFunc==0 || p
62d0: 2d 3e 6e 42 75 73 79 3c 30 20 29 20 72 65 74 75 ->nBusy<0 ) retu
62e0: 72 6e 20 30 3b 0a 20 20 72 63 20 3d 20 70 2d 3e rn 0;. rc = p->
62f0: 78 46 75 6e 63 28 70 2d 3e 70 41 72 67 2c 20 70 xFunc(p->pArg, p
6300: 2d 3e 6e 42 75 73 79 29 3b 0a 20 20 69 66 28 20 ->nBusy);. if(
6310: 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e rc==0 ){. p->
6320: 6e 42 75 73 79 20 3d 20 2d 31 3b 0a 20 20 7d 65 nBusy = -1;. }e
6330: 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 lse{. p->nBus
6340: 79 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 y++;. }. retur
6350: 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 n rc; .}../*.**
6360: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 This routine set
6370: 73 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 s the busy callb
6380: 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74 ack for an Sqlit
6390: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68 e database to th
63a0: 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62 e.** given callb
63b0: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 ack function wit
63c0: 68 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75 h the given argu
63d0: 6d 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ment..*/.int sql
63e0: 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 ite3_busy_handle
63f0: 72 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 r(. sqlite3 *db
6400: 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29 ,. int (*xBusy)
6410: 28 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 (void*,int),. v
6420: 6f 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 73 oid *pArg.){. s
6430: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
6440: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
6450: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
6460: 2e 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a .xFunc = xBusy;.
6470: 20 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 db->busyHandle
6480: 72 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 r.pArg = pArg;.
6490: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
64a0: 2e 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 73 71 .nBusy = 0;. sq
64b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
64c0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
64d0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
64e0: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ;.}..#ifndef SQL
64f0: 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 ITE_OMIT_PROGRES
6500: 53 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a S_CALLBACK./*.**
6510: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 This routine se
6520: 74 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 ts the progress
6530: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 callback for an
6540: 53 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 Sqlite database
6550: 74 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 to the.** given
6560: 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f callback functio
6570: 6e 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e n with the given
6580: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 argument. The p
6590: 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b rogress callback
65a0: 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f will.** be invo
65b0: 6b 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f ked every nOps o
65c0: 70 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 pcodes..*/.void
65d0: 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 sqlite3_progress
65e0: 5f 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 _handler(. sqli
65f0: 74 65 33 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 te3 *db, . int
6600: 6e 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 nOps,. int (*xP
6610: 72 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c rogress)(void*),
6620: 20 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 . void *pArg.)
6630: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 {. sqlite3_mute
6640: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
6650: 78 29 3b 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 x);. if( nOps>0
6660: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f ){. db->xPro
6670: 67 72 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73 gress = xProgres
6680: 73 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 s;. db->nProg
6690: 72 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a ressOps = nOps;.
66a0: 20 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 db->pProgres
66b0: 73 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d sArg = pArg;. }
66c0: 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 else{. db->xP
66d0: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 rogress = 0;.
66e0: 20 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 db->nProgressOp
66f0: 73 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 s = 0;. db->p
6700: 50 72 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b ProgressArg = 0;
6710: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
6720: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
6730: 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a utex);.}.#endif.
6740: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
6750: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 tine installs a
6760: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e default busy han
6770: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 dler that waits
6780: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 for the.** speci
6790: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d fied number of m
67a0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f illiseconds befo
67b0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a re returning 0..
67c0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 */.int sqlite3_b
67d0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 usy_timeout(sqli
67e0: 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 te3 *db, int ms)
67f0: 7b 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a {. if( ms>0 ){.
6800: 20 20 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 db->busyTime
6810: 6f 75 74 20 3d 20 6d 73 3b 0a 20 20 20 20 73 71 out = ms;. sq
6820: 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c lite3_busy_handl
6830: 65 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66 er(db, sqliteDef
6840: 61 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b aultBusyCallback
6850: 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20 , (void*)db);.
6860: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 }else{. sqlit
6870: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 e3_busy_handler(
6880: 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 db, 0, 0);. }.
6890: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
68a0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 K;.}../*.** Caus
68b0: 65 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 e any pending op
68c0: 65 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 eration to stop
68d0: 61 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 at its earliest
68e0: 6f 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a opportunity..*/.
68f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 74 void sqlite3_int
6900: 65 72 72 75 70 74 28 73 71 6c 69 74 65 33 20 2a errupt(sqlite3 *
6910: 64 62 29 7b 0a 20 20 64 62 2d 3e 75 31 2e 69 73 db){. db->u1.is
6920: 49 6e 74 65 72 72 75 70 74 65 64 20 3d 20 31 3b Interrupted = 1;
6930: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}.../*.** This
6940: 66 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 function is exac
6950: 74 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 tly the same as
6960: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 sqlite3_create_f
6970: 75 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 unction(), excep
6980: 74 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 t.** that it is
6990: 64 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 designed to be c
69a0: 61 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 alled by interna
69b0: 6c 20 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 l code. The diff
69c0: 65 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 erence is.** tha
69d0: 74 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 t if a malloc()
69e0: 66 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 fails in sqlite3
69f0: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e _create_function
6a00: 28 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 (), an error cod
6a10: 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 e.** is returned
6a20: 20 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 and the mallocF
6a30: 61 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 ailed flag clear
6a40: 65 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ed. .*/.int sqli
6a50: 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 te3CreateFunc(.
6a60: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 sqlite3 *db,.
6a70: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e const char *zFun
6a80: 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 ctionName,. int
6a90: 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 nArg,. int enc
6aa0: 2c 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 ,. void *pUserD
6ab0: 61 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 ata,. void (*xF
6ac0: 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e unc)(sqlite3_con
6ad0: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
6ae0: 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 3_value **),. v
6af0: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c oid (*xStep)(sql
6b00: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
6b10: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
6b20: 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 **),. void (*xF
6b30: 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f inal)(sqlite3_co
6b40: 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e ntext*).){. Fun
6b50: 63 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e cDef *p;. int n
6b60: 4e 61 6d 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 Name;.. assert(
6b70: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
6b80: 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
6b90: 3b 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 6f ;. if( zFunctio
6ba0: 6e 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 20 nName==0 ||.
6bb0: 20 20 28 78 46 75 6e 63 20 26 26 20 28 78 46 69 (xFunc && (xFi
6bc0: 6e 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 20 7c nal || xStep)) |
6bd0: 7c 20 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63 | . (!xFunc
6be0: 20 26 26 20 28 78 46 69 6e 61 6c 20 26 26 20 21 && (xFinal && !
6bf0: 78 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 xStep)) ||.
6c00: 20 28 21 78 46 75 6e 63 20 26 26 20 28 21 78 46 (!xFunc && (!xF
6c10: 69 6e 61 6c 20 26 26 20 78 53 74 65 70 29 29 20 inal && xStep))
6c20: 7c 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 3c 2d ||. (nArg<-
6c30: 31 20 7c 7c 20 6e 41 72 67 3e 53 51 4c 49 54 45 1 || nArg>SQLITE
6c40: 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 _MAX_FUNCTION_AR
6c50: 47 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 G) ||. (255
6c60: 3c 28 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 <(nName = sqlite
6c70: 33 53 74 72 6c 65 6e 28 64 62 2c 20 7a 46 75 6e 3Strlen(db, zFun
6c80: 63 74 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b 0a ctionName))) ){.
6c90: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 sqlite3Error
6ca0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f (db, SQLITE_ERRO
6cb0: 52 2c 20 22 62 61 64 20 70 61 72 61 6d 65 74 65 R, "bad paramete
6cc0: 72 73 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e rs");. return
6cd0: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
6ce0: 20 7d 0a 20 20 0a 23 69 66 6e 64 65 66 20 53 51 }. .#ifndef SQ
6cf0: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
6d00: 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 /* If SQLITE_U
6d10: 54 46 31 36 20 69 73 20 73 70 65 63 69 66 69 65 TF16 is specifie
6d20: 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 69 6e d as the encodin
6d30: 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 g type, transfor
6d40: 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f m this. ** to o
6d50: 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 ne of SQLITE_UTF
6d60: 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 16LE or SQLITE_U
6d70: 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 68 65 TF16BE using the
6d80: 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 . ** SQLITE_UTF
6d90: 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 16NATIVE macro.
6da0: 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 20 SQLITE_UTF16 is
6db0: 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 6e 61 not used interna
6dc0: 6c 6c 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 lly.. **. ** I
6dd0: 66 20 53 51 4c 49 54 45 5f 41 4e 59 20 69 73 20 f SQLITE_ANY is
6de0: 73 70 65 63 69 66 69 65 64 2c 20 61 64 64 20 74 specified, add t
6df0: 68 72 65 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 hree versions of
6e00: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a 20 20 the function.
6e10: 2a 2a 20 74 6f 20 74 68 65 20 68 61 73 68 20 74 ** to the hash t
6e20: 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 able.. */. if(
6e30: 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54 46 enc==SQLITE_UTF
6e40: 31 36 20 29 7b 0a 20 20 20 20 65 6e 63 20 3d 20 16 ){. enc =
6e50: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 SQLITE_UTF16NATI
6e60: 56 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 VE;. }else if(
6e70: 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 41 4e 59 20 enc==SQLITE_ANY
6e80: 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 ){. int rc;.
6e90: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 rc = sqlite3C
6ea0: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 reateFunc(db, zF
6eb0: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 unctionName, nAr
6ec0: 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 0a g, SQLITE_UTF8,.
6ed0: 20 20 20 20 20 20 20 20 20 70 55 73 65 72 44 61 pUserDa
6ee0: 74 61 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 ta, xFunc, xStep
6ef0: 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 20 20 69 , xFinal);. i
6f00: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
6f10: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
6f20: 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 qlite3CreateFunc
6f30: 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 (db, zFunctionNa
6f40: 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 me, nArg, SQLITE
6f50: 5f 55 54 46 31 36 4c 45 2c 0a 20 20 20 20 20 20 _UTF16LE,.
6f60: 20 20 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 pUserData, x
6f70: 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 Func, xStep, xFi
6f80: 6e 61 6c 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nal);. }.
6f90: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
6fa0: 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 K ){. retur
6fb0: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
6fc0: 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 enc = SQLITE_UTF
6fd0: 31 36 42 45 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 16BE;. }.#else.
6fe0: 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 enc = SQLITE_U
6ff0: 54 46 38 3b 0a 23 65 6e 64 69 66 0a 20 20 0a 20 TF8;.#endif. .
7000: 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 20 /* Check if an
7010: 65 78 69 73 74 69 6e 67 20 66 75 6e 63 74 69 6f existing functio
7020: 6e 20 69 73 20 62 65 69 6e 67 20 6f 76 65 72 72 n is being overr
7030: 69 64 64 65 6e 20 6f 72 20 64 65 6c 65 74 65 64 idden or deleted
7040: 2e 20 49 66 20 73 6f 2c 0a 20 20 2a 2a 20 61 6e . If so,. ** an
7050: 64 20 74 68 65 72 65 20 61 72 65 20 61 63 74 69 d there are acti
7060: 76 65 20 56 4d 73 2c 20 74 68 65 6e 20 72 65 74 ve VMs, then ret
7070: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e urn SQLITE_BUSY.
7080: 20 49 66 20 61 20 66 75 6e 63 74 69 6f 6e 0a 20 If a function.
7090: 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 6f 76 65 ** is being ove
70a0: 72 72 69 64 64 65 6e 2f 64 65 6c 65 74 65 64 20 rridden/deleted
70b0: 62 75 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f but there are no
70c0: 20 61 63 74 69 76 65 20 56 4d 73 2c 20 61 6c 6c active VMs, all
70d0: 6f 77 20 74 68 65 0a 20 20 2a 2a 20 6f 70 65 72 ow the. ** oper
70e0: 61 74 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75 ation to continu
70f0: 65 20 62 75 74 20 69 6e 76 61 6c 69 64 61 74 65 e but invalidate
7100: 20 61 6c 6c 20 70 72 65 63 6f 6d 70 69 6c 65 64 all precompiled
7110: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a statements.. *
7120: 2f 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 46 /. p = sqlite3F
7130: 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 indFunction(db,
7140: 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e zFunctionName, n
7150: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 28 75 38 29 Name, nArg, (u8)
7160: 65 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 enc, 0);. if( p
7170: 20 26 26 20 70 2d 3e 69 50 72 65 66 45 6e 63 3d && p->iPrefEnc=
7180: 3d 65 6e 63 20 26 26 20 70 2d 3e 6e 41 72 67 3d =enc && p->nArg=
7190: 3d 6e 41 72 67 20 29 7b 0a 20 20 20 20 69 66 28 =nArg ){. if(
71a0: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 db->activeVdbeC
71b0: 6e 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 nt ){. sqli
71c0: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c te3Error(db, SQL
71d0: 49 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 ITE_BUSY, .
71e0: 20 20 20 22 75 6e 61 62 6c 65 20 74 6f 20 64 65 "unable to de
71f0: 6c 65 74 65 2f 6d 6f 64 69 66 79 20 75 73 65 72 lete/modify user
7200: 2d 66 75 6e 63 74 69 6f 6e 20 64 75 65 20 74 6f -function due to
7210: 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e active statemen
7220: 74 73 22 29 3b 0a 20 20 20 20 20 20 61 73 73 65 ts");. asse
7230: 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 rt( !db->mallocF
7240: 61 69 6c 65 64 20 29 3b 0a 20 20 20 20 20 20 72 ailed );. r
7250: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 eturn SQLITE_BUS
7260: 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 Y;. }else{.
7270: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 69 72 sqlite3Expir
7280: 65 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 ePreparedStateme
7290: 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 7d 0a 20 nts(db);. }.
72a0: 20 7d 0a 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 }.. p = sqlite
72b0: 33 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 64 62 3FindFunction(db
72c0: 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c , zFunctionName,
72d0: 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 28 75 nName, nArg, (u
72e0: 38 29 65 6e 63 2c 20 31 29 3b 0a 20 20 61 73 73 8)enc, 1);. ass
72f0: 65 72 74 28 70 20 7c 7c 20 64 62 2d 3e 6d 61 6c ert(p || db->mal
7300: 6c 6f 63 46 61 69 6c 65 64 29 3b 0a 20 20 69 66 locFailed);. if
7310: 28 20 21 70 20 29 7b 0a 20 20 20 20 72 65 74 75 ( !p ){. retu
7320: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
7330: 0a 20 20 7d 0a 20 20 70 2d 3e 66 6c 61 67 73 20 . }. p->flags
7340: 3d 20 30 3b 0a 20 20 70 2d 3e 78 46 75 6e 63 20 = 0;. p->xFunc
7350: 3d 20 78 46 75 6e 63 3b 0a 20 20 70 2d 3e 78 53 = xFunc;. p->xS
7360: 74 65 70 20 3d 20 78 53 74 65 70 3b 0a 20 20 70 tep = xStep;. p
7370: 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 3d 20 78 46 ->xFinalize = xF
7380: 69 6e 61 6c 3b 0a 20 20 70 2d 3e 70 55 73 65 72 inal;. p->pUser
7390: 44 61 74 61 20 3d 20 70 55 73 65 72 44 61 74 61 Data = pUserData
73a0: 3b 0a 20 20 70 2d 3e 6e 41 72 67 20 3d 20 28 75 ;. p->nArg = (u
73b0: 31 36 29 6e 41 72 67 3b 0a 20 20 72 65 74 75 72 16)nArg;. retur
73c0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
73d0: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 6e 65 77 /*.** Create new
73e0: 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 73 2e user functions.
73f0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
7400: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 create_function(
7410: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a . sqlite3 *db,.
7420: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
7430: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 unctionName,. i
7440: 6e 74 20 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 nt nArg,. int e
7450: 6e 63 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 nc,. void *p,.
7460: 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 void (*xFunc)(s
7470: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
7480: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
7490: 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a e **),. void (*
74a0: 78 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 xStep)(sqlite3_c
74b0: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
74c0: 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 te3_value **),.
74d0: 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 void (*xFinal)(
74e0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
74f0: 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ).){. int rc;.
7500: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
7510: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
7520: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 . rc = sqlite3C
7530: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 reateFunc(db, zF
7540: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 unctionName, nAr
7550: 67 2c 20 65 6e 63 2c 20 70 2c 20 78 46 75 6e 63 g, enc, p, xFunc
7560: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 , xStep, xFinal)
7570: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
7580: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b ApiExit(db, rc);
7590: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
75a0: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
75b0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
75c0: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
75d0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74 E_OMIT_UTF16.int
75e0: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
75f0: 66 75 6e 63 74 69 6f 6e 31 36 28 0a 20 20 73 71 function16(. sq
7600: 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e lite3 *db,. con
7610: 73 74 20 76 6f 69 64 20 2a 7a 46 75 6e 63 74 69 st void *zFuncti
7620: 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 onName,. int nA
7630: 72 67 2c 0a 20 20 69 6e 74 20 65 54 65 78 74 52 rg,. int eTextR
7640: 65 70 2c 0a 20 20 76 6f 69 64 20 2a 70 2c 0a 20 ep,. void *p,.
7650: 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 void (*xFunc)(s
7660: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
7670: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
7680: 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 e**),. void (*x
7690: 53 74 65 70 29 28 73 71 6c 69 74 65 33 5f 63 6f Step)(sqlite3_co
76a0: 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 ntext*,int,sqlit
76b0: 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 20 76 e3_value**),. v
76c0: 6f 69 64 20 28 2a 78 46 69 6e 61 6c 29 28 73 71 oid (*xFinal)(sq
76d0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 0a lite3_context*).
76e0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 63 ){. int rc;. c
76f0: 68 61 72 20 2a 7a 46 75 6e 63 38 3b 0a 20 20 73 har *zFunc8;. s
7700: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
7710: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
7720: 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 assert( !db->ma
7730: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 llocFailed );.
7740: 7a 46 75 6e 63 38 20 3d 20 73 71 6c 69 74 65 33 zFunc8 = sqlite3
7750: 55 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 46 75 Utf16to8(db, zFu
7760: 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 2d 31 29 3b nctionName, -1);
7770: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 . rc = sqlite3C
7780: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 reateFunc(db, zF
7790: 75 6e 63 38 2c 20 6e 41 72 67 2c 20 65 54 65 78 unc8, nArg, eTex
77a0: 74 52 65 70 2c 20 70 2c 20 78 46 75 6e 63 2c 20 tRep, p, xFunc,
77b0: 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b 0a xStep, xFinal);.
77c0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
77d0: 64 62 2c 20 7a 46 75 6e 63 38 29 3b 0a 20 20 72 db, zFunc8);. r
77e0: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 c = sqlite3ApiEx
77f0: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 it(db, rc);. sq
7800: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
7810: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
7820: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e return rc;.}.#en
7830: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6c dif.../*.** Decl
7840: 61 72 65 20 74 68 61 74 20 61 20 66 75 6e 63 74 are that a funct
7850: 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 6f 76 65 ion has been ove
7860: 72 6c 6f 61 64 65 64 20 62 79 20 61 20 76 69 72 rloaded by a vir
7870: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a tual table..**.*
7880: 2a 20 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f * If the functio
7890: 6e 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 n already exists
78a0: 20 61 73 20 61 20 72 65 67 75 6c 61 72 20 67 6c as a regular gl
78b0: 6f 62 61 6c 20 66 75 6e 63 74 69 6f 6e 2c 20 74 obal function, t
78c0: 68 65 6e 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 hen.** this rout
78d0: 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 ine is a no-op.
78e0: 20 49 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e If the function
78f0: 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c does not exist,
7900: 20 74 68 65 6e 20 63 72 65 61 74 65 0a 2a 2a 20 then create.**
7910: 61 20 6e 65 77 20 6f 6e 65 20 74 68 61 74 20 61 a new one that a
7920: 6c 77 61 79 73 20 74 68 72 6f 77 73 20 61 20 72 lways throws a r
7930: 75 6e 2d 74 69 6d 65 20 65 72 72 6f 72 2e 20 20 un-time error.
7940: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 76 69 72 74 .**.** When virt
7950: 75 61 6c 20 74 61 62 6c 65 73 20 69 6e 74 65 6e ual tables inten
7960: 64 20 74 6f 20 70 72 6f 76 69 64 65 20 61 6e 20 d to provide an
7970: 6f 76 65 72 6c 6f 61 64 65 64 20 66 75 6e 63 74 overloaded funct
7980: 69 6f 6e 2c 20 74 68 65 79 0a 2a 2a 20 73 68 6f ion, they.** sho
7990: 75 6c 64 20 63 61 6c 6c 20 74 68 69 73 20 72 6f uld call this ro
79a0: 75 74 69 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 utine to make su
79b0: 72 65 20 74 68 65 20 67 6c 6f 62 61 6c 20 66 75 re the global fu
79c0: 6e 63 74 69 6f 6e 20 65 78 69 73 74 73 2e 0a 2a nction exists..*
79d0: 2a 20 41 20 67 6c 6f 62 61 6c 20 66 75 6e 63 74 * A global funct
79e0: 69 6f 6e 20 6d 75 73 74 20 65 78 69 73 74 20 69 ion must exist i
79f0: 6e 20 6f 72 64 65 72 20 66 6f 72 20 6e 61 6d 65 n order for name
7a00: 20 72 65 73 6f 6c 75 74 69 6f 6e 20 74 6f 20 77 resolution to w
7a10: 6f 72 6b 0a 2a 2a 20 70 72 6f 70 65 72 6c 79 2e ork.** properly.
7a20: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
7a30: 6f 76 65 72 6c 6f 61 64 5f 66 75 6e 63 74 69 6f overload_functio
7a40: 6e 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 n(. sqlite3 *db
7a50: 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ,. const char *
7a60: 7a 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 zName,. int nAr
7a70: 67 0a 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 g.){. int nName
7a80: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e = sqlite3Strlen
7a90: 28 64 62 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 69 (db, zName);. i
7aa0: 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 nt rc;. sqlite3
7ab0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
7ac0: 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 >mutex);. if( s
7ad0: 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 74 69 qlite3FindFuncti
7ae0: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6e 4e on(db, zName, nN
7af0: 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 ame, nArg, SQLIT
7b00: 45 5f 55 54 46 38 2c 20 30 29 3d 3d 30 20 29 7b E_UTF8, 0)==0 ){
7b10: 0a 20 20 20 20 73 71 6c 69 74 65 33 43 72 65 61 . sqlite3Crea
7b20: 74 65 46 75 6e 63 28 64 62 2c 20 7a 4e 61 6d 65 teFunc(db, zName
7b30: 2c 20 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 , nArg, SQLITE_U
7b40: 54 46 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 TF8,.
7b50: 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 73 71 0, sq
7b60: 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 75 6e 63 lite3InvalidFunc
7b70: 74 69 6f 6e 2c 20 30 2c 20 30 29 3b 0a 20 20 7d tion, 0, 0);. }
7b80: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 . rc = sqlite3A
7b90: 70 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49 54 piExit(db, SQLIT
7ba0: 45 5f 4f 4b 29 3b 0a 20 20 73 71 6c 69 74 65 33 E_OK);. sqlite3
7bb0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
7bc0: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
7bd0: 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 n rc;.}..#ifndef
7be0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 SQLITE_OMIT_TRA
7bf0: 43 45 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 CE./*.** Registe
7c00: 72 20 61 20 74 72 61 63 65 20 66 75 6e 63 74 69 r a trace functi
7c10: 6f 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72 on. The pArg fr
7c20: 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c om the previousl
7c30: 79 20 72 65 67 69 73 74 65 72 65 64 20 74 72 61 y registered tra
7c40: 63 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 ce.** is returne
7c50: 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 20 4e 55 4c d. .**.** A NUL
7c60: 4c 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e L trace function
7c70: 20 6d 65 61 6e 73 20 74 68 61 74 20 6e 6f 20 74 means that no t
7c80: 72 61 63 69 6e 67 20 69 73 20 65 78 65 63 75 74 racing is execut
7c90: 65 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a es. A non-NULL.
7ca0: 2a 2a 20 74 72 61 63 65 20 69 73 20 61 20 70 6f ** trace is a po
7cb0: 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 inter to a funct
7cc0: 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f ion that is invo
7cd0: 6b 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74 ked at the start
7ce0: 20 6f 66 20 65 61 63 68 0a 2a 2a 20 53 51 4c 20 of each.** SQL
7cf0: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f statement..*/.vo
7d00: 69 64 20 2a 73 71 6c 69 74 65 33 5f 74 72 61 63 id *sqlite3_trac
7d10: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 76 e(sqlite3 *db, v
7d20: 6f 69 64 20 28 2a 78 54 72 61 63 65 29 28 76 6f oid (*xTrace)(vo
7d30: 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 id*,const char*)
7d40: 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 , void *pArg){.
7d50: 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a 20 20 73 void *pOld;. s
7d60: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
7d70: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
7d80: 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 54 72 61 pOld = db->pTra
7d90: 63 65 41 72 67 3b 0a 20 20 64 62 2d 3e 78 54 72 ceArg;. db->xTr
7da0: 61 63 65 20 3d 20 78 54 72 61 63 65 3b 0a 20 20 ace = xTrace;.
7db0: 64 62 2d 3e 70 54 72 61 63 65 41 72 67 20 3d 20 db->pTraceArg =
7dc0: 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f pArg;. sqlite3_
7dd0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
7de0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
7df0: 20 70 4f 6c 64 3b 0a 7d 0a 2f 2a 0a 2a 2a 20 52 pOld;.}./*.** R
7e00: 65 67 69 73 74 65 72 20 61 20 70 72 6f 66 69 6c egister a profil
7e10: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 e function. The
7e20: 20 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20 70 pArg from the p
7e30: 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74 reviously regist
7e40: 65 72 65 64 20 0a 2a 2a 20 70 72 6f 66 69 6c 65 ered .** profile
7e50: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 72 65 74 function is ret
7e60: 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 urned. .**.** A
7e70: 20 4e 55 4c 4c 20 70 72 6f 66 69 6c 65 20 66 75 NULL profile fu
7e80: 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 61 nction means tha
7e90: 74 20 6e 6f 20 70 72 6f 66 69 6c 69 6e 67 20 69 t no profiling i
7ea0: 73 20 65 78 65 63 75 74 65 73 2e 20 20 41 20 6e s executes. A n
7eb0: 6f 6e 2d 4e 55 4c 4c 0a 2a 2a 20 70 72 6f 66 69 on-NULL.** profi
7ec0: 6c 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 le is a pointer
7ed0: 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 to a function th
7ee0: 61 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 at is invoked at
7ef0: 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 the conclusion
7f00: 6f 66 0a 2a 2a 20 65 61 63 68 20 53 51 4c 20 73 of.** each SQL s
7f10: 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 69 73 tatement that is
7f20: 20 72 75 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 run..*/.void *s
7f30: 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 0a qlite3_profile(.
7f40: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 sqlite3 *db,.
7f50: 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 69 6c 65 void (*xProfile
7f60: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
7f70: 61 72 2a 2c 73 71 6c 69 74 65 5f 75 69 6e 74 36 ar*,sqlite_uint6
7f80: 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 4),. void *pArg
7f90: 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f 6c 64 .){. void *pOld
7fa0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
7fb0: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
7fc0: 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 62 2d x);. pOld = db-
7fd0: 3e 70 50 72 6f 66 69 6c 65 41 72 67 3b 0a 20 20 >pProfileArg;.
7fe0: 64 62 2d 3e 78 50 72 6f 66 69 6c 65 20 3d 20 78 db->xProfile = x
7ff0: 50 72 6f 66 69 6c 65 3b 0a 20 20 64 62 2d 3e 70 Profile;. db->p
8000: 50 72 6f 66 69 6c 65 41 72 67 20 3d 20 70 41 72 ProfileArg = pAr
8010: 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 g;. sqlite3_mut
8020: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
8030: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4f ex);. return pO
8040: 6c 64 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 ld;.}.#endif /*
8050: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 SQLITE_OMIT_TRAC
8060: 45 20 2a 2f 0a 0a 2f 2a 2a 2a 20 45 58 50 45 52 E */../*** EXPER
8070: 49 4d 45 4e 54 41 4c 20 2a 2a 2a 0a 2a 2a 0a 2a IMENTAL ***.**.*
8080: 2a 20 52 65 67 69 73 74 65 72 20 61 20 66 75 6e * Register a fun
8090: 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f ction to be invo
80a0: 6b 65 64 20 77 68 65 6e 20 61 20 74 72 61 6e 73 ked when a trans
80b0: 61 63 74 69 6f 6e 20 63 6f 6d 6d 65 6e 74 73 2e action comments.
80c0: 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 76 6f 6b .** If the invok
80d0: 65 64 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ed function retu
80e0: 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 rns non-zero, th
80f0: 65 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20 62 65 en the commit be
8100: 63 6f 6d 65 73 20 61 0a 2a 2a 20 72 6f 6c 6c 62 comes a.** rollb
8110: 61 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 ack..*/.void *sq
8120: 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f lite3_commit_hoo
8130: 6b 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 k(. sqlite3 *db
8140: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
8150: 2a 20 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f * Attach the hoo
8160: 6b 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 k to this databa
8170: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 se */. int (*xC
8180: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c allback)(void*),
8190: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f /* Function to
81a0: 20 69 6e 76 6f 6b 65 20 6f 6e 20 65 61 63 68 20 invoke on each
81b0: 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 76 6f 69 64 commit */. void
81c0: 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 20 *pArg
81d0: 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e /* Argumen
81e0: 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f t to the functio
81f0: 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a n */.){. void *
8200: 70 4f 6c 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f pOld;. sqlite3_
8210: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
8220: 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d mutex);. pOld =
8230: 20 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 3b db->pCommitArg;
8240: 0a 20 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 . db->xCommitCa
8250: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 llback = xCallba
8260: 63 6b 3b 0a 20 20 64 62 2d 3e 70 43 6f 6d 6d 69 ck;. db->pCommi
8270: 74 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 tArg = pArg;. s
8280: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
8290: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
82a0: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a return pOld;.}.
82b0: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
82c0: 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 65 a callback to be
82d0: 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 69 invoked each ti
82e0: 6d 65 20 61 20 72 6f 77 20 69 73 20 75 70 64 61 me a row is upda
82f0: 74 65 64 2c 0a 2a 2a 20 69 6e 73 65 72 74 65 64 ted,.** inserted
8300: 20 6f 72 20 64 65 6c 65 74 65 64 20 75 73 69 6e or deleted usin
8310: 67 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 g this database
8320: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 connection..*/.v
8330: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 70 64 oid *sqlite3_upd
8340: 61 74 65 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 ate_hook(. sqli
8350: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
8360: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 /* Attach
8370: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 the hook to this
8380: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 database */. v
8390: 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 oid (*xCallback)
83a0: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 68 61 72 20 (void*,int,char
83b0: 63 6f 6e 73 74 20 2a 2c 63 68 61 72 20 63 6f 6e const *,char con
83c0: 73 74 20 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 36 st *,sqlite_int6
83d0: 34 29 2c 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 4),. void *pArg
83e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
83f0: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 /* Argument to t
8400: 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 he function */.)
8410: 7b 0a 20 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a {. void *pRet;.
8420: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
8430: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
8440: 3b 0a 20 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 ;. pRet = db->p
8450: 55 70 64 61 74 65 41 72 67 3b 0a 20 20 64 62 2d UpdateArg;. db-
8460: 3e 78 55 70 64 61 74 65 43 61 6c 6c 62 61 63 6b >xUpdateCallback
8470: 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 = xCallback;.
8480: 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 20 3d db->pUpdateArg =
8490: 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 pArg;. sqlite3
84a0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d _mutex_leave(db-
84b0: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
84c0: 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a n pRet;.}../*.**
84d0: 20 52 65 67 69 73 74 65 72 20 61 20 63 61 6c 6c Register a call
84e0: 62 61 63 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b back to be invok
84f0: 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20 74 ed each time a t
8500: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f ransaction is ro
8510: 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 62 79 20 lled.** back by
8520: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f this database co
8530: 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 nnection..*/.voi
8540: 64 20 2a 73 71 6c 69 74 65 33 5f 72 6f 6c 6c 62 d *sqlite3_rollb
8550: 61 63 6b 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 ack_hook(. sqli
8560: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
8570: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 /* Attach
8580: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 the hook to this
8590: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 76 database */. v
85a0: 6f 69 64 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 oid (*xCallback)
85b0: 28 76 6f 69 64 2a 29 2c 20 2f 2a 20 43 61 6c 6c (void*), /* Call
85c0: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 2a 2f back function */
85d0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 . void *pArg
85e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
85f0: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
8600: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 function */.){.
8610: 20 76 6f 69 64 20 2a 70 52 65 74 3b 0a 20 20 73 void *pRet;. s
8620: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
8630: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
8640: 20 70 52 65 74 20 3d 20 64 62 2d 3e 70 52 6f 6c pRet = db->pRol
8650: 6c 62 61 63 6b 41 72 67 3b 0a 20 20 64 62 2d 3e lbackArg;. db->
8660: 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 xRollbackCallbac
8670: 6b 20 3d 20 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 k = xCallback;.
8680: 20 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 db->pRollbackAr
8690: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
86a0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
86b0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
86c0: 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f 2a turn pRet;.}../*
86d0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
86e0: 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 is called to cr
86f0: 65 61 74 65 20 61 20 63 6f 6e 6e 65 63 74 69 6f eate a connectio
8700: 6e 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 n to a database
8710: 42 54 72 65 65 0a 2a 2a 20 64 72 69 76 65 72 2e BTree.** driver.
8720: 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 If zFilename i
8730: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 s the name of a
8740: 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 20 file, then that
8750: 66 69 6c 65 20 69 73 0a 2a 2a 20 6f 70 65 6e 65 file is.** opene
8760: 64 20 61 6e 64 20 75 73 65 64 2e 20 20 49 66 20 d and used. If
8770: 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 zFilename is the
8780: 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 magic name ":me
8790: 6d 6f 72 79 3a 22 20 74 68 65 6e 0a 2a 2a 20 74 mory:" then.** t
87a0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 73 he database is s
87b0: 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 tored in memory
87c0: 28 61 6e 64 20 69 73 20 74 68 75 73 20 66 6f 72 (and is thus for
87d0: 67 6f 74 74 65 6e 20 61 73 20 73 6f 6f 6e 20 61 gotten as soon a
87e0: 73 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 s.** the connect
87f0: 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 29 20 ion is closed.)
8800: 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 If zFilename is
8810: 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 20 64 NULL then the d
8820: 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20 61 20 atabase.** is a
8830: 22 76 69 72 74 75 61 6c 22 20 64 61 74 61 62 61 "virtual" databa
8840: 73 65 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 se for transient
8850: 20 75 73 65 20 6f 6e 6c 79 20 61 6e 64 20 69 73 use only and is
8860: 20 64 65 6c 65 74 65 64 20 61 73 0a 2a 2a 20 73 deleted as.** s
8870: 6f 6f 6e 20 61 73 20 74 68 65 20 63 6f 6e 6e 65 oon as the conne
8880: 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e ction is closed.
8890: 0a 2a 2a 0a 2a 2a 20 41 20 76 69 72 74 75 61 6c .**.** A virtual
88a0: 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 database can be
88b0: 20 65 69 74 68 65 72 20 61 20 64 69 73 6b 20 66 either a disk f
88c0: 69 6c 65 20 28 74 68 61 74 20 69 73 20 61 75 74 ile (that is aut
88d0: 6f 6d 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 64 65 omatically.** de
88e0: 6c 65 74 65 64 20 77 68 65 6e 20 74 68 65 20 66 leted when the f
88f0: 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 29 20 6f ile is closed) o
8900: 72 20 69 74 20 61 6e 20 62 65 20 68 65 6c 64 20 r it an be held
8910: 65 6e 74 69 72 65 6c 79 20 69 6e 20 6d 65 6d 6f entirely in memo
8920: 72 79 2c 0a 2a 2a 20 64 65 70 65 6e 64 69 6e 67 ry,.** depending
8930: 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 73 20 6f on the values o
8940: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 54 45 4d f the SQLITE_TEM
8950: 50 5f 53 54 4f 52 45 20 63 6f 6d 70 69 6c 65 2d P_STORE compile-
8960: 74 69 6d 65 20 6d 61 63 72 6f 20 61 6e 64 20 74 time macro and t
8970: 68 65 0a 2a 2a 20 64 62 2d 3e 74 65 6d 70 5f 73 he.** db->temp_s
8980: 74 6f 72 65 20 76 61 72 69 61 62 6c 65 2c 20 61 tore variable, a
8990: 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 ccording to the
89a0: 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 3a following chart:
89b0: 0a 2a 2a 0a 2a 2a 20 20 20 53 51 4c 49 54 45 5f .**.** SQLITE_
89c0: 54 45 4d 50 5f 53 54 4f 52 45 20 20 20 20 20 64 TEMP_STORE d
89d0: 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 20 20 20 b->temp_store
89e0: 20 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 65 Location of te
89f0: 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 mporary database
8a00: 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .** ----------
8a10: 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d ------- ----
8a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d ---------- -
8a30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8a40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a -------------.**
8a50: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 0
8a60: 20 20 20 20 20 20 20 20 20 61 6e 79 20 20 20 20 any
8a70: 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 file
8a80: 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 .** 1
8a90: 20 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 1
8aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 f
8ab0: 69 6c 65 0a 2a 2a 20 20 20 31 20 20 20 20 20 20 ile.** 1
8ac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32 2
8ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8ae0: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 31 20 memory.** 1
8af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b00: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 0
8b10: 20 20 20 20 20 20 20 66 69 6c 65 0a 2a 2a 20 20 file.**
8b20: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
8b30: 20 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 1
8b40: 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 0a 2a file.*
8b50: 2a 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20 * 2
8b60: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20 2
8b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d mem
8b80: 6f 72 79 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 ory.** 2
8b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0
8ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8bb0: 20 20 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 33 20 memory.** 3
8bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8bd0: 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 20 20 any
8be0: 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 0a 2a 2f memory.*/
8bf0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
8c00: 65 46 61 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 eFactory(. cons
8c10: 74 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 t sqlite3 *db,
8c20: 20 20 20 20 20 20 2f 2a 20 4d 61 69 6e 20 64 61 /* Main da
8c30: 74 61 62 61 73 65 20 77 68 65 6e 20 6f 70 65 6e tabase when open
8c40: 69 6e 67 20 61 75 78 20 6f 74 68 65 72 77 69 73 ing aux otherwis
8c50: 65 20 30 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 e 0 */. const c
8c60: 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 har *zFilename,
8c70: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
8c80: 65 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e e file containin
8c90: 67 20 74 68 65 20 42 54 72 65 65 20 64 61 74 61 g the BTree data
8ca0: 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 6d base */. int om
8cb0: 69 74 4a 6f 75 72 6e 61 6c 2c 20 20 20 20 20 20 itJournal,
8cc0: 20 20 20 20 2f 2a 20 69 66 20 54 52 55 45 20 74 /* if TRUE t
8cd0: 68 65 6e 20 64 6f 20 6e 6f 74 20 6a 6f 75 72 6e hen do not journ
8ce0: 61 6c 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a al this file */.
8cf0: 20 20 69 6e 74 20 6e 43 61 63 68 65 2c 20 20 20 int nCache,
8d00: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
8d10: 6f 77 20 6d 61 6e 79 20 70 61 67 65 73 20 69 6e ow many pages in
8d20: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20 the page cache
8d30: 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 */. int vfsFlag
8d40: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f s, /
8d50: 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
8d60: 68 72 6f 75 67 68 20 74 6f 20 76 66 73 4f 70 65 hrough to vfsOpe
8d70: 6e 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 n */. Btree **p
8d80: 70 42 74 72 65 65 20 20 20 20 20 20 20 20 20 20 pBtree
8d90: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e /* Pointer to n
8da0: 65 77 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 ew Btree object
8db0: 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a written here */.
8dc0: 29 7b 0a 20 20 69 6e 74 20 62 74 46 6c 61 67 73 ){. int btFlags
8dd0: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a = 0;. int rc;.
8de0: 20 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
8df0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
8e00: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
8e10: 61 73 73 65 72 74 28 20 70 70 42 74 72 65 65 20 assert( ppBtree
8e20: 21 3d 20 30 29 3b 0a 20 20 69 66 28 20 6f 6d 69 != 0);. if( omi
8e30: 74 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 tJournal ){.
8e40: 62 74 46 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 btFlags |= BTREE
8e50: 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 _OMIT_JOURNAL;.
8e60: 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 66 6c 61 }. if( db->fla
8e70: 67 73 20 26 20 53 51 4c 49 54 45 5f 4e 6f 52 65 gs & SQLITE_NoRe
8e80: 61 64 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 62 74 adlock ){. bt
8e90: 46 6c 61 67 73 20 7c 3d 20 42 54 52 45 45 5f 4e Flags |= BTREE_N
8ea0: 4f 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20 20 7d 0a O_READLOCK;. }.
8eb0: 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 3d if( zFilename=
8ec0: 3d 30 20 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 =0 ){.#if SQLITE
8ed0: 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 30 0a 20 _TEMP_STORE==0.
8ee0: 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 68 69 6e 67 /* Do nothing
8ef0: 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 */.#endif.#ifnd
8f00: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d ef SQLITE_OMIT_M
8f10: 45 4d 4f 52 59 44 42 0a 23 69 66 20 53 51 4c 49 EMORYDB.#if SQLI
8f20: 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 31 TE_TEMP_STORE==1
8f30: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 74 65 6d . if( db->tem
8f40: 70 5f 73 74 6f 72 65 3d 3d 32 20 29 20 7a 46 69 p_store==2 ) zFi
8f50: 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72 lename = ":memor
8f60: 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 y:";.#endif.#if
8f70: 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 SQLITE_TEMP_STOR
8f80: 45 3d 3d 32 0a 20 20 20 20 69 66 28 20 64 62 2d E==2. if( db-
8f90: 3e 74 65 6d 70 5f 73 74 6f 72 65 21 3d 31 20 29 >temp_store!=1 )
8fa0: 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d zFilename = ":m
8fb0: 65 6d 6f 72 79 3a 22 3b 0a 23 65 6e 64 69 66 0a emory:";.#endif.
8fc0: 23 69 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f #if SQLITE_TEMP_
8fd0: 53 54 4f 52 45 3d 3d 33 0a 20 20 20 20 7a 46 69 STORE==3. zFi
8fe0: 6c 65 6e 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72 lename = ":memor
8ff0: 79 3a 22 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 y:";.#endif.#end
9000: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
9010: 54 5f 4d 45 4d 4f 52 59 44 42 20 2a 2f 0a 20 20 T_MEMORYDB */.
9020: 7d 0a 0a 20 20 69 66 28 20 28 76 66 73 46 6c 61 }.. if( (vfsFla
9030: 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e gs & SQLITE_OPEN
9040: 5f 4d 41 49 4e 5f 44 42 29 21 3d 30 20 26 26 20 _MAIN_DB)!=0 &&
9050: 28 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c (zFilename==0 ||
9060: 20 2a 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 29 20 *zFilename==0)
9070: 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 73 20 ){. vfsFlags
9080: 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 7e 53 = (vfsFlags & ~S
9090: 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f QLITE_OPEN_MAIN_
90a0: 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 DB) | SQLITE_OPE
90b0: 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d 0a 20 N_TEMP_DB;. }.
90c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 rc = sqlite3Btr
90d0: 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 eeOpen(zFilename
90e0: 2c 20 28 73 71 6c 69 74 65 33 20 2a 29 64 62 2c , (sqlite3 *)db,
90f0: 20 70 70 42 74 72 65 65 2c 20 62 74 46 6c 61 67 ppBtree, btFlag
9100: 73 2c 20 76 66 73 46 6c 61 67 73 29 3b 0a 0a 20 s, vfsFlags);..
9110: 20 2f 2a 20 49 66 20 74 68 65 20 42 2d 54 72 65 /* If the B-Tre
9120: 65 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c e was successful
9130: 6c 79 20 6f 70 65 6e 65 64 2c 20 73 65 74 20 74 ly opened, set t
9140: 68 65 20 70 61 67 65 72 2d 63 61 63 68 65 20 73 he pager-cache s
9150: 69 7a 65 20 74 6f 20 74 68 65 0a 20 20 2a 2a 20 ize to the. **
9160: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 2e 20 45 default value. E
9170: 78 63 65 70 74 2c 20 69 66 20 74 68 65 20 63 61 xcept, if the ca
9180: 6c 6c 20 74 6f 20 42 74 72 65 65 4f 70 65 6e 28 ll to BtreeOpen(
9190: 29 20 72 65 74 75 72 6e 65 64 20 61 20 68 61 6e ) returned a han
91a0: 64 6c 65 0a 20 20 2a 2a 20 6f 70 65 6e 20 6f 6e dle. ** open on
91b0: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 73 68 61 an existing sha
91c0: 72 65 64 20 70 61 67 65 72 2d 63 61 63 68 65 2c red pager-cache,
91d0: 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 do not change t
91e0: 68 65 20 70 61 67 65 72 2d 63 61 63 68 65 20 0a he pager-cache .
91f0: 20 20 2a 2a 20 73 69 7a 65 2e 0a 20 20 2a 2f 0a ** size.. */.
9200: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
9210: 5f 4f 4b 20 26 26 20 30 3d 3d 73 71 6c 69 74 65 _OK && 0==sqlite
9220: 33 42 74 72 65 65 53 63 68 65 6d 61 28 2a 70 70 3BtreeSchema(*pp
9230: 42 74 72 65 65 2c 20 30 2c 20 30 29 20 29 7b 0a Btree, 0, 0) ){.
9240: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
9250: 53 65 74 43 61 63 68 65 53 69 7a 65 28 2a 70 70 SetCacheSize(*pp
9260: 42 74 72 65 65 2c 20 6e 43 61 63 68 65 29 3b 0a Btree, nCache);.
9270: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
9280: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
9290: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 45 UTF-8 encoded E
92a0: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 nglish language
92b0: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 explanation of t
92c0: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a he most recent.*
92d0: 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 * error..*/.cons
92e0: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f t char *sqlite3_
92f0: 65 72 72 6d 73 67 28 73 71 6c 69 74 65 33 20 2a errmsg(sqlite3 *
9300: 64 62 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 db){. const cha
9310: 72 20 2a 7a 3b 0a 20 20 69 66 28 20 21 64 62 20 r *z;. if( !db
9320: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 ){. return sq
9330: 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 lite3ErrStr(SQLI
9340: 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 TE_NOMEM);. }.
9350: 20 69 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 if( !sqlite3Saf
9360: 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b etyCheckSickOrOk
9370: 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 (db) ){. retu
9380: 72 6e 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 rn sqlite3ErrStr
9390: 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 3b (SQLITE_MISUSE);
93a0: 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d . }. if( db->m
93b0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
93c0: 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 return sqlite
93d0: 33 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 3ErrStr(SQLITE_N
93e0: 4f 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c OMEM);. }. sql
93f0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
9400: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 (db->mutex);. a
9410: 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c ssert( !db->mall
9420: 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 20 ocFailed );. z
9430: 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 = (char*)sqlite3
9440: 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e _value_text(db->
9450: 70 45 72 72 29 3b 0a 20 20 61 73 73 65 72 74 28 pErr);. assert(
9460: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
9470: 65 64 20 29 3b 0a 20 20 69 66 28 20 7a 3d 3d 30 ed );. if( z==0
9480: 20 29 7b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 ){. z = sqli
9490: 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 72 te3ErrStr(db->er
94a0: 72 43 6f 64 65 29 3b 0a 20 20 7d 0a 20 20 73 71 rCode);. }. sq
94b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
94c0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
94d0: 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 0a 23 69 66 return z;.}..#if
94e0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
94f0: 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 74 _UTF16./*.** Ret
9500: 75 72 6e 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 urn UTF-16 encod
9510: 65 64 20 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 ed English langu
9520: 61 67 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 age explanation
9530: 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 of the most rece
9540: 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a nt.** error..*/.
9550: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 const void *sqli
9560: 74 65 33 5f 65 72 72 6d 73 67 31 36 28 73 71 6c te3_errmsg16(sql
9570: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 73 74 61 ite3 *db){. sta
9580: 74 69 63 20 63 6f 6e 73 74 20 75 31 36 20 6f 75 tic const u16 ou
9590: 74 4f 66 4d 65 6d 5b 5d 20 3d 20 7b 0a 20 20 20 tOfMem[] = {.
95a0: 20 27 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 'o', 'u', 't',
95b0: 27 20 27 2c 20 27 6f 27 2c 20 27 66 27 2c 20 27 ' ', 'o', 'f', '
95c0: 20 27 2c 20 27 6d 27 2c 20 27 65 27 2c 20 27 6d ', 'm', 'e', 'm
95d0: 27 2c 20 27 6f 27 2c 20 27 72 27 2c 20 27 79 27 ', 'o', 'r', 'y'
95e0: 2c 20 30 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 , 0. };. stati
95f0: 63 20 63 6f 6e 73 74 20 75 31 36 20 6d 69 73 75 c const u16 misu
9600: 73 65 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6c 27 se[] = {. 'l'
9610: 2c 20 27 69 27 2c 20 27 62 27 2c 20 27 72 27 2c , 'i', 'b', 'r',
9620: 20 27 61 27 2c 20 27 72 27 2c 20 27 79 27 2c 20 'a', 'r', 'y',
9630: 27 20 27 2c 20 0a 20 20 20 20 27 72 27 2c 20 27 ' ', . 'r', '
9640: 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 69 o', 'u', 't', 'i
9650: 27 2c 20 27 6e 27 2c 20 27 65 27 2c 20 27 20 27 ', 'n', 'e', ' '
9660: 2c 20 0a 20 20 20 20 27 63 27 2c 20 27 61 27 2c , . 'c', 'a',
9670: 20 27 6c 27 2c 20 27 6c 27 2c 20 27 65 27 2c 20 'l', 'l', 'e',
9680: 27 64 27 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 'd', ' ', . '
9690: 6f 27 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 20 o', 'u', 't', '
96a0: 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 27 66 27 ', . 'o', 'f'
96b0: 2c 20 27 20 27 2c 20 0a 20 20 20 20 27 73 27 2c , ' ', . 's',
96c0: 20 27 65 27 2c 20 27 71 27 2c 20 27 75 27 2c 20 'e', 'q', 'u',
96d0: 27 65 27 2c 20 27 6e 27 2c 20 27 63 27 2c 20 27 'e', 'n', 'c', '
96e0: 65 27 2c 20 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f e', 0. };.. co
96f0: 6e 73 74 20 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 nst void *z;. i
9700: 66 28 20 21 64 62 20 29 7b 0a 20 20 20 20 72 65 f( !db ){. re
9710: 74 75 72 6e 20 28 76 6f 69 64 20 2a 29 6f 75 74 turn (void *)out
9720: 4f 66 4d 65 6d 3b 0a 20 20 7d 0a 20 20 69 66 28 OfMem;. }. if(
9730: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
9740: 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
9750: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 ){. return (
9760: 76 6f 69 64 20 2a 29 6d 69 73 75 73 65 3b 0a 20 void *)misuse;.
9770: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
9780: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
9790: 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 ex);. assert( !
97a0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
97b0: 20 29 3b 0a 20 20 7a 20 3d 20 73 71 6c 69 74 65 );. z = sqlite
97c0: 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 64 3_value_text16(d
97d0: 62 2d 3e 70 45 72 72 29 3b 0a 20 20 69 66 28 20 b->pErr);. if(
97e0: 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 z==0 ){. sqli
97f0: 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 te3ValueSetStr(d
9800: 62 2d 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c b->pErr, -1, sql
9810: 69 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 ite3ErrStr(db->e
9820: 72 72 43 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 rrCode),.
9830: 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 SQLITE_UTF8, S
9840: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 QLITE_STATIC);.
9850: 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 z = sqlite3_v
9860: 61 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e alue_text16(db->
9870: 70 45 72 72 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 pErr);. }. /*
9880: 41 20 6d 61 6c 6c 6f 63 28 29 20 6d 61 79 20 68 A malloc() may h
9890: 61 76 65 20 66 61 69 6c 65 64 20 77 69 74 68 69 ave failed withi
98a0: 6e 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 n the call to sq
98b0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 lite3_value_text
98c0: 31 36 28 29 0a 20 20 2a 2a 20 61 62 6f 76 65 2e 16(). ** above.
98d0: 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
98e0: 63 61 73 65 2c 20 74 68 65 6e 20 74 68 65 20 64 case, then the d
98f0: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 b->mallocFailed
9900: 66 6c 61 67 20 6e 65 65 64 73 20 74 6f 0a 20 20 flag needs to.
9910: 2a 2a 20 62 65 20 63 6c 65 61 72 65 64 20 62 65 ** be cleared be
9920: 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 20 fore returning.
9930: 44 6f 20 74 68 69 73 20 64 69 72 65 63 74 6c 79 Do this directly
9940: 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 76 69 61 , instead of via
9950: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 41 70 69 . ** sqlite3Api
9960: 45 78 69 74 28 29 2c 20 74 6f 20 61 76 6f 69 64 Exit(), to avoid
9970: 20 73 65 74 74 69 6e 67 20 74 68 65 20 64 61 74 setting the dat
9980: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 65 72 72 abase handle err
9990: 6f 72 20 6d 65 73 73 61 67 65 2e 0a 20 20 2a 2f or message.. */
99a0: 0a 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 . db->mallocFai
99b0: 6c 65 64 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 led = 0;. sqlit
99c0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
99d0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
99e0: 75 72 6e 20 7a 3b 0a 7d 0a 23 65 6e 64 69 66 20 urn z;.}.#endif
99f0: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 /* SQLITE_OMIT_U
9a00: 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 TF16 */../*.** R
9a10: 65 74 75 72 6e 20 74 68 65 20 6d 6f 73 74 20 72 eturn the most r
9a20: 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 ecent error code
9a30: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e generated by an
9a40: 20 53 51 4c 69 74 65 20 72 6f 75 74 69 6e 65 2e SQLite routine.
9a50: 20 49 66 20 4e 55 4c 4c 20 69 73 0a 2a 2a 20 70 If NULL is.** p
9a60: 61 73 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 assed to this fu
9a70: 6e 63 74 69 6f 6e 2c 20 77 65 20 61 73 73 75 6d nction, we assum
9a80: 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 e a malloc() fai
9a90: 6c 65 64 20 64 75 72 69 6e 67 20 73 71 6c 69 74 led during sqlit
9aa0: 65 33 5f 6f 70 65 6e 28 29 2e 0a 2a 2f 0a 69 6e e3_open()..*/.in
9ab0: 74 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 t sqlite3_errcod
9ac0: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a e(sqlite3 *db){.
9ad0: 20 20 69 66 28 20 64 62 20 26 26 20 21 73 71 6c if( db && !sql
9ae0: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
9af0: 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a 20 ickOrOk(db) ){.
9b00: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
9b10: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 69 _MISUSE;. }. i
9b20: 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e 6d 61 f( !db || db->ma
9b30: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 llocFailed ){.
9b40: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
9b50: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 65 74 NOMEM;. }. ret
9b60: 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 65 20 urn db->errCode
9b70: 26 20 64 62 2d 3e 65 72 72 4d 61 73 6b 3b 0a 7d & db->errMask;.}
9b80: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 74 .int sqlite3_ext
9b90: 65 6e 64 65 64 5f 65 72 72 63 6f 64 65 28 73 71 ended_errcode(sq
9ba0: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 66 lite3 *db){. if
9bb0: 28 20 64 62 20 26 26 20 21 73 71 6c 69 74 65 33 ( db && !sqlite3
9bc0: 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f SafetyCheckSickO
9bd0: 72 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 rOk(db) ){. r
9be0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
9bf0: 55 53 45 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 USE;. }. if( !
9c00: 64 62 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 db || db->malloc
9c10: 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 72 65 Failed ){. re
9c20: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
9c30: 4d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 M;. }. return
9c40: 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a db->errCode;.}..
9c50: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e /*.** Create a n
9c60: 65 77 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e ew collating fun
9c70: 63 74 69 6f 6e 20 66 6f 72 20 64 61 74 61 62 61 ction for databa
9c80: 73 65 20 22 64 62 22 2e 20 20 54 68 65 20 6e 61 se "db". The na
9c90: 6d 65 20 69 73 20 7a 4e 61 6d 65 0a 2a 2a 20 61 me is zName.** a
9ca0: 6e 64 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 nd the encoding
9cb0: 69 73 20 65 6e 63 2e 0a 2a 2f 0a 73 74 61 74 69 is enc..*/.stati
9cc0: 63 20 69 6e 74 20 63 72 65 61 74 65 43 6f 6c 6c c int createColl
9cd0: 61 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 ation(. sqlite3
9ce0: 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 * db, . const c
9cf0: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 har *zName, . i
9d00: 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a nt enc, . void*
9d10: 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 pCtx,. int(*xC
9d20: 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e ompare)(void*,in
9d30: 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e t,const void*,in
9d40: 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 2c 0a t,const void*),.
9d50: 20 20 76 6f 69 64 28 2a 78 44 65 6c 29 28 76 6f void(*xDel)(vo
9d60: 69 64 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c 53 65 id*).){. CollSe
9d70: 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 q *pColl;. int
9d80: 65 6e 63 32 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d enc2;. int nNam
9d90: 65 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 e;. . assert(
9da0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
9db0: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
9dc0: 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 49 54 45 .. /* If SQLITE
9dd0: 5f 55 54 46 31 36 20 69 73 20 73 70 65 63 69 66 _UTF16 is specif
9de0: 69 65 64 20 61 73 20 74 68 65 20 65 6e 63 6f 64 ied as the encod
9df0: 69 6e 67 20 74 79 70 65 2c 20 74 72 61 6e 73 66 ing type, transf
9e00: 6f 72 6d 20 74 68 69 73 0a 20 20 2a 2a 20 74 6f orm this. ** to
9e10: 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 55 one of SQLITE_U
9e20: 54 46 31 36 4c 45 20 6f 72 20 53 51 4c 49 54 45 TF16LE or SQLITE
9e30: 5f 55 54 46 31 36 42 45 20 75 73 69 6e 67 20 74 _UTF16BE using t
9e40: 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 he. ** SQLITE_U
9e50: 54 46 31 36 4e 41 54 49 56 45 20 6d 61 63 72 6f TF16NATIVE macro
9e60: 2e 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 . SQLITE_UTF16 i
9e70: 73 20 6e 6f 74 20 75 73 65 64 20 69 6e 74 65 72 s not used inter
9e80: 6e 61 6c 6c 79 2e 0a 20 20 2a 2f 0a 20 20 65 6e nally.. */. en
9e90: 63 32 20 3d 20 65 6e 63 20 26 20 7e 53 51 4c 49 c2 = enc & ~SQLI
9ea0: 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 TE_UTF16_ALIGNED
9eb0: 3b 0a 20 20 69 66 28 20 65 6e 63 32 3d 3d 53 51 ;. if( enc2==SQ
9ec0: 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 20 LITE_UTF16 ){.
9ed0: 20 20 65 6e 63 32 20 3d 20 53 51 4c 49 54 45 5f enc2 = SQLITE_
9ee0: 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d UTF16NATIVE;. }
9ef0: 0a 20 20 69 66 28 20 28 65 6e 63 32 26 7e 33 29 . if( (enc2&~3)
9f00: 21 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 !=0 ){. retur
9f10: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b n SQLITE_MISUSE;
9f20: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b . }.. /* Check
9f30: 20 69 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 if this call is
9f40: 20 72 65 6d 6f 76 69 6e 67 20 6f 72 20 72 65 70 removing or rep
9f50: 6c 61 63 69 6e 67 20 61 6e 20 65 78 69 73 74 69 lacing an existi
9f60: 6e 67 20 63 6f 6c 6c 61 74 69 6f 6e 20 0a 20 20 ng collation .
9f70: 2a 2a 20 73 65 71 75 65 6e 63 65 2e 20 49 66 20 ** sequence. If
9f80: 73 6f 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 so, and there ar
9f90: 65 20 61 63 74 69 76 65 20 56 4d 73 2c 20 72 65 e active VMs, re
9fa0: 74 75 72 6e 20 62 75 73 79 2e 20 49 66 20 74 68 turn busy. If th
9fb0: 65 72 65 0a 20 20 2a 2a 20 61 72 65 20 6e 6f 20 ere. ** are no
9fc0: 61 63 74 69 76 65 20 56 4d 73 2c 20 69 6e 76 61 active VMs, inva
9fd0: 6c 69 64 61 74 65 20 61 6e 79 20 70 72 65 2d 63 lidate any pre-c
9fe0: 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 6d 65 6e ompiled statemen
9ff0: 74 73 2e 0a 20 20 2a 2f 0a 20 20 6e 4e 61 6d 65 ts.. */. nName
a000: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e = sqlite3Strlen
a010: 28 64 62 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 70 (db, zName);. p
a020: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 Coll = sqlite3Fi
a030: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 28 75 ndCollSeq(db, (u
a040: 38 29 65 6e 63 32 2c 20 7a 4e 61 6d 65 2c 20 6e 8)enc2, zName, n
a050: 4e 61 6d 65 2c 20 30 29 3b 0a 20 20 69 66 28 20 Name, 0);. if(
a060: 70 43 6f 6c 6c 20 26 26 20 70 43 6f 6c 6c 2d 3e pColl && pColl->
a070: 78 43 6d 70 20 29 7b 0a 20 20 20 20 69 66 28 20 xCmp ){. if(
a080: 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e db->activeVdbeCn
a090: 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 t ){. sqlit
a0a0: 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 e3Error(db, SQLI
a0b0: 54 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 20 TE_BUSY, .
a0c0: 20 20 22 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c "unable to del
a0d0: 65 74 65 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c 61 ete/modify colla
a0e0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 64 75 tion sequence du
a0f0: 65 20 74 6f 20 61 63 74 69 76 65 20 73 74 61 74 e to active stat
a100: 65 6d 65 6e 74 73 22 29 3b 0a 20 20 20 20 20 20 ements");.
a110: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
a120: 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 SY;. }. sq
a130: 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 lite3ExpirePrepa
a140: 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 redStatements(db
a150: 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 63 6f );.. /* If co
a160: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 llation sequence
a170: 20 70 43 6f 6c 6c 20 77 61 73 20 63 72 65 61 74 pColl was creat
a180: 65 64 20 64 69 72 65 63 74 6c 79 20 62 79 20 61 ed directly by a
a190: 20 63 61 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 call to. **
a1a0: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 sqlite3_create_c
a1b0: 6f 6c 6c 61 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f ollation, and no
a1c0: 74 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 73 t generated by s
a1d0: 79 6e 74 68 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 ynthCollSeq(),.
a1e0: 20 20 20 2a 2a 20 74 68 65 6e 20 61 6e 79 20 63 ** then any c
a1f0: 6f 70 69 65 73 20 6d 61 64 65 20 62 79 20 73 79 opies made by sy
a200: 6e 74 68 43 6f 6c 6c 53 65 71 28 29 20 6e 65 65 nthCollSeq() nee
a210: 64 20 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 61 d to be invalida
a220: 74 65 64 2e 0a 20 20 20 20 2a 2a 20 41 6c 73 6f ted.. ** Also
a230: 2c 20 63 6f 6c 6c 61 74 69 6f 6e 20 64 65 73 74 , collation dest
a240: 72 75 63 74 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 ructor - CollSeq
a250: 2e 78 44 65 6c 28 29 20 2d 20 66 75 6e 63 74 69 .xDel() - functi
a260: 6f 6e 20 6d 61 79 20 6e 65 65 64 0a 20 20 20 20 on may need.
a270: 2a 2a 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 2e ** to be called.
a280: 0a 20 20 20 20 2a 2f 20 0a 20 20 20 20 69 66 28 . */ . if(
a290: 20 28 70 43 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e (pColl->enc & ~
a2a0: 53 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 SQLITE_UTF16_ALI
a2b0: 47 4e 45 44 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 GNED)==enc2 ){.
a2c0: 20 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 CollSeq *aC
a2d0: 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 48 61 73 oll = sqlite3Has
a2e0: 68 46 69 6e 64 28 26 64 62 2d 3e 61 43 6f 6c 6c hFind(&db->aColl
a2f0: 53 65 71 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d Seq, zName, nNam
a300: 65 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 6a 3b e);. int j;
a310: 0a 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 . for(j=0;
a320: 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 j<3; j++){.
a330: 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 20 3d 20 CollSeq *p =
a340: 26 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 20 &aColl[j];.
a350: 20 20 20 69 66 28 20 70 2d 3e 65 6e 63 3d 3d 70 if( p->enc==p
a360: 43 6f 6c 6c 2d 3e 65 6e 63 20 29 7b 0a 20 20 20 Coll->enc ){.
a370: 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 78 44 if( p->xD
a380: 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 el ){.
a390: 20 20 70 2d 3e 78 44 65 6c 28 70 2d 3e 70 55 73 p->xDel(p->pUs
a3a0: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d er);. }
a3b0: 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 78 43 . p->xC
a3c0: 6d 70 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 mp = 0;.
a3d0: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a }. }. }.
a3e0: 20 20 7d 0a 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 }.. pColl = s
a3f0: 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 qlite3FindCollSe
a400: 71 28 64 62 2c 20 28 75 38 29 65 6e 63 32 2c 20 q(db, (u8)enc2,
a410: 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 31 29 zName, nName, 1)
a420: 3b 0a 20 20 69 66 28 20 70 43 6f 6c 6c 20 29 7b ;. if( pColl ){
a430: 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 78 43 6d 70 . pColl->xCmp
a440: 20 3d 20 78 43 6f 6d 70 61 72 65 3b 0a 20 20 20 = xCompare;.
a450: 20 70 43 6f 6c 6c 2d 3e 70 55 73 65 72 20 3d 20 pColl->pUser =
a460: 70 43 74 78 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d pCtx;. pColl-
a470: 3e 78 44 65 6c 20 3d 20 78 44 65 6c 3b 0a 20 20 >xDel = xDel;.
a480: 20 20 70 43 6f 6c 6c 2d 3e 65 6e 63 20 3d 20 28 pColl->enc = (
a490: 75 38 29 28 65 6e 63 32 20 7c 20 28 65 6e 63 20 u8)(enc2 | (enc
a4a0: 26 20 53 51 4c 49 54 45 5f 55 54 46 31 36 5f 41 & SQLITE_UTF16_A
a4b0: 4c 49 47 4e 45 44 29 29 3b 0a 20 20 7d 0a 20 20 LIGNED));. }.
a4c0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
a4d0: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a SQLITE_OK, 0);.
a4e0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
a4f0: 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 OK;.}.../*.** Th
a500: 69 73 20 61 72 72 61 79 20 64 65 66 69 6e 65 73 is array defines
a510: 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75 6e hard upper boun
a520: 64 73 20 6f 6e 20 6c 69 6d 69 74 20 76 61 6c 75 ds on limit valu
a530: 65 73 2e 20 20 54 68 65 0a 2a 2a 20 69 6e 69 74 es. The.** init
a540: 69 61 6c 69 7a 65 72 20 6d 75 73 74 20 62 65 20 ializer must be
a550: 6b 65 70 74 20 69 6e 20 73 79 6e 63 20 77 69 74 kept in sync wit
a560: 68 20 74 68 65 20 53 51 4c 49 54 45 5f 4c 49 4d h the SQLITE_LIM
a570: 49 54 5f 2a 0a 2a 2a 20 23 64 65 66 69 6e 65 73 IT_*.** #defines
a580: 20 69 6e 20 73 71 6c 69 74 65 33 2e 68 2e 0a 2a in sqlite3.h..*
a590: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 69 /.static const i
a5a0: 6e 74 20 61 48 61 72 64 4c 69 6d 69 74 5b 5d 20 nt aHardLimit[]
a5b0: 3d 20 7b 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 = {. SQLITE_MAX
a5c0: 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 54 _LENGTH,. SQLIT
a5d0: 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 E_MAX_SQL_LENGTH
a5e0: 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ,. SQLITE_MAX_C
a5f0: 4f 4c 55 4d 4e 2c 0a 20 20 53 51 4c 49 54 45 5f OLUMN,. SQLITE_
a600: 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 2c 0a MAX_EXPR_DEPTH,.
a610: 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d SQLITE_MAX_COM
a620: 50 4f 55 4e 44 5f 53 45 4c 45 43 54 2c 0a 20 20 POUND_SELECT,.
a630: 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f SQLITE_MAX_VDBE_
a640: 4f 50 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 OP,. SQLITE_MAX
a650: 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 2c 0a 20 _FUNCTION_ARG,.
a660: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 SQLITE_MAX_ATTA
a670: 43 48 45 44 2c 0a 20 20 53 51 4c 49 54 45 5f 4d CHED,. SQLITE_M
a680: 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f AX_LIKE_PATTERN_
a690: 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 54 45 LENGTH,. SQLITE
a6a0: 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e 55 _MAX_VARIABLE_NU
a6b0: 4d 42 45 52 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 MBER,.};../*.**
a6c0: 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 68 61 Make sure the ha
a6d0: 72 64 20 6c 69 6d 69 74 73 20 61 72 65 20 73 65 rd limits are se
a6e0: 74 20 74 6f 20 72 65 61 73 6f 6e 61 62 6c 65 20 t to reasonable
a6f0: 76 61 6c 75 65 73 0a 2a 2f 0a 23 69 66 20 53 51 values.*/.#if SQ
a700: 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 3c LITE_MAX_LENGTH<
a710: 31 30 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 100.# error SQLI
a720: 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 20 6d 75 TE_MAX_LENGTH mu
a730: 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 31 st be at least 1
a740: 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 00.#endif.#if SQ
a750: 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e LITE_MAX_SQL_LEN
a760: 47 54 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 GTH<100.# error
a770: 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c SQLITE_MAX_SQL_L
a780: 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 61 74 ENGTH must be at
a790: 20 6c 65 61 73 74 20 31 30 30 0a 23 65 6e 64 69 least 100.#endi
a7a0: 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 f.#if SQLITE_MAX
a7b0: 5f 53 51 4c 5f 4c 45 4e 47 54 48 3e 53 51 4c 49 _SQL_LENGTH>SQLI
a7c0: 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 0a 23 20 TE_MAX_LENGTH.#
a7d0: 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
a7e0: 5f 53 51 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 _SQL_LENGTH must
a7f0: 20 6e 6f 74 20 62 65 20 67 72 65 61 74 65 72 20 not be greater
a800: 74 68 61 6e 20 53 51 4c 49 54 45 5f 4d 41 58 5f than SQLITE_MAX_
a810: 4c 45 4e 47 54 48 0a 23 65 6e 64 69 66 0a 23 69 LENGTH.#endif.#i
a820: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d f SQLITE_MAX_COM
a830: 50 4f 55 4e 44 5f 53 45 4c 45 43 54 3c 32 0a 23 POUND_SELECT<2.#
a840: 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 error SQLITE_MA
a850: 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 X_COMPOUND_SELEC
a860: 54 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 T must be at lea
a870: 73 74 20 32 0a 23 65 6e 64 69 66 0a 23 69 66 20 st 2.#endif.#if
a880: 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f SQLITE_MAX_VDBE_
a890: 4f 50 3c 34 30 0a 23 20 65 72 72 6f 72 20 53 51 OP<40.# error SQ
a8a0: 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 LITE_MAX_VDBE_OP
a8b0: 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 must be at leas
a8c0: 74 20 34 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 t 40.#endif.#if
a8d0: 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 SQLITE_MAX_FUNCT
a8e0: 49 4f 4e 5f 41 52 47 3c 30 20 7c 7c 20 53 51 4c ION_ARG<0 || SQL
a8f0: 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e ITE_MAX_FUNCTION
a900: 5f 41 52 47 3e 31 30 30 30 0a 23 20 65 72 72 6f _ARG>1000.# erro
a910: 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e r SQLITE_MAX_FUN
a920: 43 54 49 4f 4e 5f 41 52 47 20 6d 75 73 74 20 62 CTION_ARG must b
a930: 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 e between 0 and
a940: 31 30 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 1000.#endif.#if
a950: 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
a960: 48 45 44 3c 30 20 7c 7c 20 53 51 4c 49 54 45 5f HED<0 || SQLITE_
a970: 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a MAX_ATTACHED>30.
a980: 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d # error SQLITE_M
a990: 41 58 5f 41 54 54 41 43 48 45 44 20 6d 75 73 74 AX_ATTACHED must
a9a0: 20 62 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e be between 0 an
a9b0: 64 20 33 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 d 30.#endif.#if
a9c0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f SQLITE_MAX_LIKE_
a9d0: 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54 48 3c 31 PATTERN_LENGTH<1
a9e0: 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f .# error SQLITE_
a9f0: 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e MAX_LIKE_PATTERN
aa00: 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 _LENGTH must be
aa10: 61 74 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 at least 1.#endi
aa20: 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 f.#if SQLITE_MAX
aa30: 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 _VARIABLE_NUMBER
aa40: 3c 31 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 <1.# error SQLIT
aa50: 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e E_MAX_VARIABLE_N
aa60: 55 4d 42 45 52 20 6d 75 73 74 20 62 65 20 61 74 UMBER must be at
aa70: 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 66 0a least 1.#endif.
aa80: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 #if SQLITE_MAX_C
aa90: 4f 4c 55 4d 4e 3e 33 32 37 36 37 0a 23 20 65 72 OLUMN>32767.# er
aaa0: 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ror SQLITE_MAX_C
aab0: 4f 4c 55 4d 4e 20 6d 75 73 74 20 6e 6f 74 20 65 OLUMN must not e
aac0: 78 63 65 65 64 20 33 32 37 36 37 0a 23 65 6e 64 xceed 32767.#end
aad0: 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 if.../*.** Chang
aae0: 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 e the value of a
aaf0: 20 6c 69 6d 69 74 2e 20 20 52 65 70 6f 72 74 20 limit. Report
ab00: 74 68 65 20 6f 6c 64 20 76 61 6c 75 65 2e 0a 2a the old value..*
ab10: 2a 20 49 66 20 61 6e 20 69 6e 76 61 6c 69 64 20 * If an invalid
ab20: 6c 69 6d 69 74 20 69 6e 64 65 78 20 69 73 20 73 limit index is s
ab30: 75 70 70 6c 69 65 64 2c 20 72 65 70 6f 72 74 20 upplied, report
ab40: 2d 31 2e 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 -1..** Make no c
ab50: 68 61 6e 67 65 73 20 62 75 74 20 73 74 69 6c 6c hanges but still
ab60: 20 72 65 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 report the old
ab70: 76 61 6c 75 65 20 69 66 20 74 68 65 0a 2a 2a 20 value if the.**
ab80: 6e 65 77 20 6c 69 6d 69 74 20 69 73 20 6e 65 67 new limit is neg
ab90: 61 74 69 76 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e ative..**.** A n
aba0: 65 77 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 64 ew lower limit d
abb0: 6f 65 73 20 6e 6f 74 20 73 68 72 69 6e 6b 20 65 oes not shrink e
abc0: 78 69 73 74 69 6e 67 20 63 6f 6e 73 74 72 75 63 xisting construc
abd0: 74 73 2e 0a 2a 2a 20 49 74 20 6d 65 72 65 6c 79 ts..** It merely
abe0: 20 70 72 65 76 65 6e 74 73 20 6e 65 77 20 63 6f prevents new co
abf0: 6e 73 74 72 75 63 74 73 20 74 68 61 74 20 65 78 nstructs that ex
ac00: 63 65 65 64 20 74 68 65 20 6c 69 6d 69 74 0a 2a ceed the limit.*
ac10: 2a 20 66 72 6f 6d 20 66 6f 72 6d 69 6e 67 2e 0a * from forming..
ac20: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c */.int sqlite3_l
ac30: 69 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 imit(sqlite3 *db
ac40: 2c 20 69 6e 74 20 6c 69 6d 69 74 49 64 2c 20 69 , int limitId, i
ac50: 6e 74 20 6e 65 77 4c 69 6d 69 74 29 7b 0a 20 20 nt newLimit){.
ac60: 69 6e 74 20 6f 6c 64 4c 69 6d 69 74 3b 0a 20 20 int oldLimit;.
ac70: 69 66 28 20 6c 69 6d 69 74 49 64 3c 30 20 7c 7c if( limitId<0 ||
ac80: 20 6c 69 6d 69 74 49 64 3e 3d 53 51 4c 49 54 45 limitId>=SQLITE
ac90: 5f 4e 5f 4c 49 4d 49 54 20 29 7b 0a 20 20 20 20 _N_LIMIT ){.
aca0: 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 20 return -1;. }.
acb0: 20 6f 6c 64 4c 69 6d 69 74 20 3d 20 64 62 2d 3e oldLimit = db->
acc0: 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 3b aLimit[limitId];
acd0: 0a 20 20 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e . if( newLimit>
ace0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 65 =0 ){. if( ne
acf0: 77 4c 69 6d 69 74 3e 61 48 61 72 64 4c 69 6d 69 wLimit>aHardLimi
ad00: 74 5b 6c 69 6d 69 74 49 64 5d 20 29 7b 0a 20 20 t[limitId] ){.
ad10: 20 20 20 20 6e 65 77 4c 69 6d 69 74 20 3d 20 61 newLimit = a
ad20: 48 61 72 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 HardLimit[limitI
ad30: 64 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 d];. }. db
ad40: 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 ->aLimit[limitId
ad50: 5d 20 3d 20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 ] = newLimit;.
ad60: 7d 0a 20 20 72 65 74 75 72 6e 20 6f 6c 64 4c 69 }. return oldLi
ad70: 6d 69 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 mit;.}../*.** Th
ad80: 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 is routine does
ad90: 74 68 65 20 77 6f 72 6b 20 6f 66 20 6f 70 65 6e the work of open
ada0: 69 6e 67 20 61 20 64 61 74 61 62 61 73 65 20 6f ing a database o
adb0: 6e 20 62 65 68 61 6c 66 20 6f 66 0a 2a 2a 20 73 n behalf of.** s
adc0: 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 20 61 6e qlite3_open() an
add0: 64 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 d sqlite3_open16
ade0: 28 29 2e 20 54 68 65 20 64 61 74 61 62 61 73 65 (). The database
adf0: 20 66 69 6c 65 6e 61 6d 65 20 22 7a 46 69 6c 65 filename "zFile
ae00: 6e 61 6d 65 22 20 20 0a 2a 2a 20 69 73 20 55 54 name" .** is UT
ae10: 46 2d 38 20 65 6e 63 6f 64 65 64 2e 0a 2a 2f 0a F-8 encoded..*/.
ae20: 73 74 61 74 69 63 20 69 6e 74 20 6f 70 65 6e 44 static int openD
ae30: 61 74 61 62 61 73 65 28 0a 20 20 63 6f 6e 73 74 atabase(. const
ae40: 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
ae50: 2c 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 , /* Database fi
ae60: 6c 65 6e 61 6d 65 20 55 54 46 2d 38 20 65 6e 63 lename UTF-8 enc
ae70: 6f 64 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 oded */. sqlite
ae80: 33 20 2a 2a 70 70 44 62 2c 20 20 20 20 20 20 20 3 **ppDb,
ae90: 20 2f 2a 20 4f 55 54 3a 20 52 65 74 75 72 6e 65 /* OUT: Returne
aea0: 64 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c d database handl
aeb0: 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 e */. unsigned
aec0: 66 6c 61 67 73 2c 20 20 20 20 20 20 20 20 2f 2a flags, /*
aed0: 20 4f 70 65 72 61 74 69 6f 6e 61 6c 20 66 6c 61 Operational fla
aee0: 67 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 gs */. const ch
aef0: 61 72 20 2a 7a 56 66 73 20 20 20 20 20 20 20 2f ar *zVfs /
af00: 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 56 46 * Name of the VF
af10: 53 20 74 6f 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 S to use */.){.
af20: 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 sqlite3 *db;.
af30: 69 6e 74 20 72 63 3b 0a 20 20 43 6f 6c 6c 53 65 int rc;. CollSe
af40: 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e 74 20 q *pColl;. int
af50: 69 73 54 68 72 65 61 64 73 61 66 65 3b 0a 0a 23 isThreadsafe;..#
af60: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
af70: 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 63 IT_AUTOINIT. rc
af80: 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 = sqlite3_initi
af90: 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 72 alize();. if( r
afa0: 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 c ) return rc;.#
afb0: 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 73 71 6c endif.. if( sql
afc0: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
afd0: 2e 62 43 6f 72 65 4d 75 74 65 78 3d 3d 30 20 29 .bCoreMutex==0 )
afe0: 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 {. isThreadsa
aff0: 66 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 fe = 0;. }else
b000: 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 if( flags & SQLI
b010: 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 TE_OPEN_NOMUTEX
b020: 29 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 ){. isThreads
b030: 61 66 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 afe = 0;. }else
b040: 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c if( flags & SQL
b050: 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 ITE_OPEN_FULLMUT
b060: 45 58 20 29 7b 0a 20 20 20 20 69 73 54 68 72 65 EX ){. isThre
b070: 61 64 73 61 66 65 20 3d 20 31 3b 0a 20 20 7d 65 adsafe = 1;. }e
b080: 6c 73 65 7b 0a 20 20 20 20 69 73 54 68 72 65 61 lse{. isThrea
b090: 64 73 61 66 65 20 3d 20 73 71 6c 69 74 65 33 47 dsafe = sqlite3G
b0a0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c lobalConfig.bFul
b0b0: 6c 4d 75 74 65 78 3b 0a 20 20 7d 0a 0a 20 20 2f lMutex;. }.. /
b0c0: 2a 20 52 65 6d 6f 76 65 20 68 61 72 6d 66 75 6c * Remove harmful
b0d0: 20 62 69 74 73 20 66 72 6f 6d 20 74 68 65 20 66 bits from the f
b0e0: 6c 61 67 73 20 70 61 72 61 6d 65 74 65 72 20 2a lags parameter *
b0f0: 2f 0a 20 20 66 6c 61 67 73 20 26 3d 20 20 7e 28 /. flags &= ~(
b100: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c SQLITE_OPEN_DEL
b110: 45 54 45 4f 4e 43 4c 4f 53 45 20 7c 0a 20 20 20 ETEONCLOSE |.
b120: 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
b130: 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 TE_OPEN_MAIN_DB
b140: 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
b150: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d SQLITE_OPEN_TEM
b160: 50 5f 44 42 20 7c 20 0a 20 20 20 20 20 20 20 20 P_DB | .
b170: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
b180: 45 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 42 20 EN_TRANSIENT_DB
b190: 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | .
b1a0: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 SQLITE_OPEN_MA
b1b0: 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 IN_JOURNAL | .
b1c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
b1d0: 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f ITE_OPEN_TEMP_JO
b1e0: 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 20 URNAL | .
b1f0: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
b200: 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 7c PEN_SUBJOURNAL |
b210: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
b220: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53 SQLITE_OPEN_MAS
b230: 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 20 TER_JOURNAL |.
b240: 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
b250: 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 ITE_OPEN_NOMUTEX
b260: 20 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |.
b270: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 SQLITE_OPEN_FU
b280: 4c 4c 4d 55 54 45 58 0a 20 20 20 20 20 20 20 20 LLMUTEX.
b290: 20 20 20 20 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c );.. /* Al
b2a0: 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c 69 74 locate the sqlit
b2b0: 65 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 e data structure
b2c0: 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69 74 */. db = sqlit
b2d0: 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 e3MallocZero( si
b2e0: 7a 65 6f 66 28 73 71 6c 69 74 65 33 29 20 29 3b zeof(sqlite3) );
b2f0: 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 20 67 . if( db==0 ) g
b300: 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
b310: 20 20 69 66 28 20 69 73 54 68 72 65 61 64 73 61 if( isThreadsa
b320: 66 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 75 fe ){. db->mu
b330: 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 tex = sqlite3Mut
b340: 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
b350: 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 29 3b UTEX_RECURSIVE);
b360: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 75 74 . if( db->mut
b370: 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 ex==0 ){. s
b380: 71 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 3b qlite3_free(db);
b390: 0a 20 20 20 20 20 20 64 62 20 3d 20 30 3b 0a 20 . db = 0;.
b3a0: 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 goto opendb
b3b0: 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a _out;. }. }.
b3c0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
b3d0: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
b3e0: 3b 0a 20 20 64 62 2d 3e 65 72 72 4d 61 73 6b 20 ;. db->errMask
b3f0: 3d 20 30 78 66 66 3b 0a 20 20 64 62 2d 3e 70 72 = 0xff;. db->pr
b400: 69 6f 72 4e 65 77 52 6f 77 69 64 20 3d 20 30 3b iorNewRowid = 0;
b410: 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b 0a . db->nDb = 2;.
b420: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 db->magic = SQ
b430: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 3b LITE_MAGIC_BUSY;
b440: 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 2d . db->aDb = db-
b450: 3e 61 44 62 53 74 61 74 69 63 3b 0a 0a 20 20 61 >aDbStatic;.. a
b460: 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 64 62 ssert( sizeof(db
b470: 2d 3e 61 4c 69 6d 69 74 29 3d 3d 73 69 7a 65 6f ->aLimit)==sizeo
b480: 66 28 61 48 61 72 64 4c 69 6d 69 74 29 20 29 3b f(aHardLimit) );
b490: 0a 20 20 6d 65 6d 63 70 79 28 64 62 2d 3e 61 4c . memcpy(db->aL
b4a0: 69 6d 69 74 2c 20 61 48 61 72 64 4c 69 6d 69 74 imit, aHardLimit
b4b0: 2c 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c 69 , sizeof(db->aLi
b4c0: 6d 69 74 29 29 3b 0a 20 20 64 62 2d 3e 61 75 74 mit));. db->aut
b4d0: 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 64 oCommit = 1;. d
b4e0: 62 2d 3e 6e 65 78 74 41 75 74 6f 76 61 63 20 3d b->nextAutovac =
b4f0: 20 2d 31 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 50 -1;. db->nextP
b500: 61 67 65 73 69 7a 65 20 3d 20 30 3b 0a 20 20 64 agesize = 0;. d
b510: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 b->flags |= SQLI
b520: 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 TE_ShortColNames
b530: 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 .#if SQLITE_DEFA
b540: 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 3c ULT_FILE_FORMAT<
b550: 34 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4.
b560: 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c 65 67 61 | SQLITE_Lega
b570: 63 79 46 69 6c 65 46 6d 74 0a 23 65 6e 64 69 66 cyFileFmt.#endif
b580: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
b590: 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 4e NABLE_LOAD_EXTEN
b5a0: 53 49 4f 4e 0a 20 20 20 20 20 20 20 20 20 20 20 SION.
b5b0: 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c | SQLITE_L
b5c0: 6f 61 64 45 78 74 65 6e 73 69 6f 6e 0a 23 65 6e oadExtension.#en
b5d0: 64 69 66 0a 20 20 20 20 20 20 3b 0a 20 20 73 71 dif. ;. sq
b5e0: 6c 69 74 65 33 48 61 73 68 49 6e 69 74 28 26 64 lite3HashInit(&d
b5f0: 62 2d 3e 61 43 6f 6c 6c 53 65 71 2c 20 30 29 3b b->aCollSeq, 0);
b600: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
b610: 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
b620: 45 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 E. sqlite3HashI
b630: 6e 69 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c 65 nit(&db->aModule
b640: 2c 20 30 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 , 0);.#endif..
b650: 64 62 2d 3e 70 56 66 73 20 3d 20 73 71 6c 69 74 db->pVfs = sqlit
b660: 65 33 5f 76 66 73 5f 66 69 6e 64 28 7a 56 66 73 e3_vfs_find(zVfs
b670: 29 3b 0a 20 20 69 66 28 20 21 64 62 2d 3e 70 56 );. if( !db->pV
b680: 66 73 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 fs ){. rc = S
b690: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 QLITE_ERROR;.
b6a0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
b6b0: 2c 20 72 63 2c 20 22 6e 6f 20 73 75 63 68 20 76 , rc, "no such v
b6c0: 66 73 3a 20 25 73 22 2c 20 7a 56 66 73 29 3b 0a fs: %s", zVfs);.
b6d0: 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f goto opendb_
b6e0: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 out;. }.. /* A
b6f0: 64 64 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 dd the default c
b700: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
b710: 65 20 42 49 4e 41 52 59 2e 20 42 49 4e 41 52 59 e BINARY. BINARY
b720: 20 77 6f 72 6b 73 20 66 6f 72 20 62 6f 74 68 20 works for both
b730: 55 54 46 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 55 UTF-8. ** and U
b740: 54 46 2d 31 36 2c 20 73 6f 20 61 64 64 20 61 20 TF-16, so add a
b750: 76 65 72 73 69 6f 6e 20 66 6f 72 20 65 61 63 68 version for each
b760: 20 74 6f 20 61 76 6f 69 64 20 61 6e 79 20 75 6e to avoid any un
b770: 6e 65 63 65 73 73 61 72 79 0a 20 20 2a 2a 20 63 necessary. ** c
b780: 6f 6e 76 65 72 73 69 6f 6e 73 2e 20 54 68 65 20 onversions. The
b790: 6f 6e 6c 79 20 65 72 72 6f 72 20 74 68 61 74 20 only error that
b7a0: 63 61 6e 20 6f 63 63 75 72 20 68 65 72 65 20 69 can occur here i
b7b0: 73 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 s a malloc() fai
b7c0: 6c 75 72 65 2e 0a 20 20 2a 2f 0a 20 20 63 72 65 lure.. */. cre
b7d0: 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c ateCollation(db,
b7e0: 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 "BINARY", SQLIT
b7f0: 45 5f 55 54 46 38 2c 20 30 2c 20 62 69 6e 43 6f E_UTF8, 0, binCo
b800: 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 llFunc, 0);. cr
b810: 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 eateCollation(db
b820: 2c 20 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 , "BINARY", SQLI
b830: 54 45 5f 55 54 46 31 36 42 45 2c 20 30 2c 20 62 TE_UTF16BE, 0, b
b840: 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a inCollFunc, 0);.
b850: 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
b860: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 n(db, "BINARY",
b870: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c 20 SQLITE_UTF16LE,
b880: 30 2c 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 0, binCollFunc,
b890: 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 0);. createColl
b8a0: 61 74 69 6f 6e 28 64 62 2c 20 22 52 54 52 49 4d ation(db, "RTRIM
b8b0: 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 ", SQLITE_UTF8,
b8c0: 28 76 6f 69 64 2a 29 31 2c 20 62 69 6e 43 6f 6c (void*)1, binCol
b8d0: 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 20 69 66 28 lFunc, 0);. if(
b8e0: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
b8f0: 64 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 6f 70 d ){. goto op
b900: 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 endb_out;. }.
b910: 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 20 3d 20 db->pDfltColl =
b920: 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 sqlite3FindCollS
b930: 65 71 28 64 62 2c 20 53 51 4c 49 54 45 5f 55 54 eq(db, SQLITE_UT
b940: 46 38 2c 20 22 42 49 4e 41 52 59 22 2c 20 36 2c F8, "BINARY", 6,
b950: 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 0);. assert( d
b960: 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 20 b->pDfltColl!=0
b970: 29 3b 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 64 );.. /* Also ad
b980: 64 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d 69 d a UTF-8 case-i
b990: 6e 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c 61 nsensitive colla
b9a0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 2a tion sequence. *
b9b0: 2f 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 /. createCollat
b9c0: 69 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 22 ion(db, "NOCASE"
b9d0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 , SQLITE_UTF8, 0
b9e0: 2c 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e , nocaseCollatin
b9f0: 67 46 75 6e 63 2c 20 30 29 3b 0a 0a 20 20 2f 2a gFunc, 0);.. /*
ba00: 20 53 65 74 20 66 6c 61 67 73 20 6f 6e 20 74 68 Set flags on th
ba10: 65 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 e built-in colla
ba20: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20 2a ting sequences *
ba30: 2f 0a 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c /. db->pDfltCol
ba40: 6c 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 l->type = SQLITE
ba50: 5f 43 4f 4c 4c 5f 42 49 4e 41 52 59 3b 0a 20 20 _COLL_BINARY;.
ba60: 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 pColl = sqlite3F
ba70: 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53 indCollSeq(db, S
ba80: 51 4c 49 54 45 5f 55 54 46 38 2c 20 22 4e 4f 43 QLITE_UTF8, "NOC
ba90: 41 53 45 22 2c 20 36 2c 20 30 29 3b 0a 20 20 69 ASE", 6, 0);. i
baa0: 66 28 20 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 f( pColl ){.
bab0: 70 43 6f 6c 6c 2d 3e 74 79 70 65 20 3d 20 53 51 pColl->type = SQ
bac0: 4c 49 54 45 5f 43 4f 4c 4c 5f 4e 4f 43 41 53 45 LITE_COLL_NOCASE
bad0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e ;. }.. /* Open
bae0: 20 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 the backend dat
baf0: 61 62 61 73 65 20 64 72 69 76 65 72 20 2a 2f 0a abase driver */.
bb00: 20 20 64 62 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 db->openFlags
bb10: 3d 20 66 6c 61 67 73 3b 0a 20 20 72 63 20 3d 20 = flags;. rc =
bb20: 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 63 74 sqlite3BtreeFact
bb30: 6f 72 79 28 64 62 2c 20 7a 46 69 6c 65 6e 61 6d ory(db, zFilenam
bb40: 65 2c 20 30 2c 20 53 51 4c 49 54 45 5f 44 45 46 e, 0, SQLITE_DEF
bb50: 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 2c AULT_CACHE_SIZE,
bb60: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
bb70: 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6c 61 fla
bb80: 67 73 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e gs | SQLITE_OPEN
bb90: 5f 4d 41 49 4e 5f 44 42 2c 0a 20 20 20 20 20 20 _MAIN_DB,.
bba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bbb0: 20 20 20 20 20 26 64 62 2d 3e 61 44 62 5b 30 5d &db->aDb[0]
bbc0: 2e 70 42 74 29 3b 0a 20 20 69 66 28 20 72 63 21 .pBt);. if( rc!
bbd0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
bbe0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
bbf0: 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a _IOERR_NOMEM ){.
bc00: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
bc10: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 E_NOMEM;. }.
bc20: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 sqlite3Error(
bc30: 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 20 20 db, rc, 0);.
bc40: 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b goto opendb_out;
bc50: 0a 20 20 7d 0a 20 20 64 62 2d 3e 61 44 62 5b 30 . }. db->aDb[0
bc60: 5d 2e 70 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 ].pSchema = sqli
bc70: 74 65 33 53 63 68 65 6d 61 47 65 74 28 64 62 2c te3SchemaGet(db,
bc80: 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 db->aDb[0].pBt)
bc90: 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 ;. db->aDb[1].p
bca0: 53 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 Schema = sqlite3
bcb0: 53 63 68 65 6d 61 47 65 74 28 64 62 2c 20 30 29 SchemaGet(db, 0)
bcc0: 3b 0a 0a 0a 20 20 2f 2a 20 54 68 65 20 64 65 66 ;... /* The def
bcd0: 61 75 6c 74 20 73 61 66 65 74 79 5f 6c 65 76 65 ault safety_leve
bce0: 6c 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 64 l for the main d
bcf0: 61 74 61 62 61 73 65 20 69 73 20 27 66 75 6c 6c atabase is 'full
bd00: 27 3b 20 66 6f 72 20 74 68 65 20 74 65 6d 70 0a '; for the temp.
bd10: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 74 ** database it
bd20: 20 69 73 20 27 4e 4f 4e 45 27 2e 20 54 68 69 73 is 'NONE'. This
bd30: 20 6d 61 74 63 68 65 73 20 74 68 65 20 70 61 67 matches the pag
bd40: 65 72 20 6c 61 79 65 72 20 64 65 66 61 75 6c 74 er layer default
bd50: 73 2e 20 20 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e s. . */. db->
bd60: 61 44 62 5b 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 aDb[0].zName = "
bd70: 6d 61 69 6e 22 3b 0a 20 20 64 62 2d 3e 61 44 62 main";. db->aDb
bd80: 5b 30 5d 2e 73 61 66 65 74 79 5f 6c 65 76 65 6c [0].safety_level
bd90: 20 3d 20 33 3b 0a 23 69 66 6e 64 65 66 20 53 51 = 3;.#ifndef SQ
bda0: 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 LITE_OMIT_TEMPDB
bdb0: 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a 4e . db->aDb[1].zN
bdc0: 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 20 20 ame = "temp";.
bdd0: 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66 65 74 db->aDb[1].safet
bde0: 79 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a 23 65 6e y_level = 1;.#en
bdf0: 64 69 66 0a 0a 20 20 64 62 2d 3e 6d 61 67 69 63 dif.. db->magic
be00: 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f = SQLITE_MAGIC_
be10: 4f 50 45 4e 3b 0a 20 20 69 66 28 20 64 62 2d 3e OPEN;. if( db->
be20: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
be30: 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f goto opendb_
be40: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 out;. }.. /* R
be50: 65 67 69 73 74 65 72 20 61 6c 6c 20 62 75 69 6c egister all buil
be60: 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 t-in functions,
be70: 62 75 74 20 64 6f 20 6e 6f 74 20 61 74 74 65 6d but do not attem
be80: 70 74 20 74 6f 20 72 65 61 64 20 74 68 65 0a 20 pt to read the.
be90: 20 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 ** database sch
bea0: 65 6d 61 20 79 65 74 2e 20 54 68 69 73 20 69 73 ema yet. This is
beb0: 20 64 65 6c 61 79 65 64 20 75 6e 74 69 6c 20 74 delayed until t
bec0: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 he first time th
bed0: 65 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 e database. **
bee0: 69 73 20 61 63 63 65 73 73 65 64 2e 0a 20 20 2a is accessed.. *
bef0: 2f 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 /. sqlite3Error
bf00: 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 (db, SQLITE_OK,
bf10: 30 29 3b 0a 20 20 73 71 6c 69 74 65 33 52 65 67 0);. sqlite3Reg
bf20: 69 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 isterBuiltinFunc
bf30: 74 69 6f 6e 73 28 64 62 29 3b 0a 0a 20 20 2f 2a tions(db);.. /*
bf40: 20 4c 6f 61 64 20 61 75 74 6f 6d 61 74 69 63 20 Load automatic
bf50: 65 78 74 65 6e 73 69 6f 6e 73 20 2d 20 65 78 74 extensions - ext
bf60: 65 6e 73 69 6f 6e 73 20 74 68 61 74 20 68 61 76 ensions that hav
bf70: 65 20 62 65 65 6e 20 72 65 67 69 73 74 65 72 65 e been registere
bf80: 64 0a 20 20 2a 2a 20 75 73 69 6e 67 20 74 68 65 d. ** using the
bf90: 20 73 71 6c 69 74 65 33 5f 61 75 74 6f 6d 61 74 sqlite3_automat
bfa0: 69 63 5f 65 78 74 65 6e 73 69 6f 6e 28 29 20 41 ic_extension() A
bfb0: 50 49 2e 0a 20 20 2a 2f 0a 20 20 28 76 6f 69 64 PI.. */. (void
bfc0: 29 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f 61 64 )sqlite3AutoLoad
bfd0: 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a Extensions(db);.
bfe0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 65 72 if( sqlite3_er
bff0: 72 63 6f 64 65 28 64 62 29 21 3d 53 51 4c 49 54 rcode(db)!=SQLIT
c000: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f E_OK ){. goto
c010: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d opendb_out;. }
c020: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
c030: 45 4e 41 42 4c 45 5f 46 54 53 31 0a 20 20 69 66 ENABLE_FTS1. if
c040: 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
c050: 6c 65 64 20 29 7b 0a 20 20 20 20 65 78 74 65 72 led ){. exter
c060: 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 n int sqlite3Fts
c070: 31 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 1Init(sqlite3*);
c080: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
c090: 33 46 74 73 31 49 6e 69 74 28 64 62 29 3b 0a 20 3Fts1Init(db);.
c0a0: 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 }.#endif..#ifde
c0b0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
c0c0: 46 54 53 32 0a 20 20 69 66 28 20 21 64 62 2d 3e FTS2. if( !db->
c0d0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 mallocFailed &&
c0e0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
c0f0: 0a 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 . extern int
c100: 73 71 6c 69 74 65 33 46 74 73 32 49 6e 69 74 28 sqlite3Fts2Init(
c110: 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 sqlite3*);. r
c120: 63 20 3d 20 73 71 6c 69 74 65 33 46 74 73 32 49 c = sqlite3Fts2I
c130: 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e nit(db);. }.#en
c140: 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
c150: 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a 20 TE_ENABLE_FTS3.
c160: 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 if( !db->malloc
c170: 46 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 Failed && rc==SQ
c180: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
c190: 63 20 3d 20 73 71 6c 69 74 65 33 46 74 73 33 49 c = sqlite3Fts3I
c1a0: 6e 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e nit(db);. }.#en
c1b0: 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
c1c0: 54 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 20 20 TE_ENABLE_ICU.
c1d0: 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
c1e0: 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
c1f0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
c200: 20 3d 20 73 71 6c 69 74 65 33 49 63 75 49 6e 69 = sqlite3IcuIni
c210: 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 t(db);. }.#endi
c220: 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
c230: 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 0a 20 20 _ENABLE_RTREE.
c240: 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
c250: 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
c260: 49 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 20 ITE_OK){. rc
c270: 3d 20 73 71 6c 69 74 65 33 52 74 72 65 65 49 6e = sqlite3RtreeIn
c280: 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
c290: 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 if.. sqlite3Err
c2a0: 6f 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 0a or(db, rc, 0);..
c2b0: 20 20 2f 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 /* -DSQLITE_DE
c2c0: 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f FAULT_LOCKING_MO
c2d0: 44 45 3d 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 DE=1 makes EXCLU
c2e0: 53 49 56 45 20 74 68 65 20 64 65 66 61 75 6c 74 SIVE the default
c2f0: 20 6c 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f locking. ** mo
c300: 64 65 2e 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 de. -DSQLITE_DE
c310: 46 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f FAULT_LOCKING_MO
c320: 44 45 3d 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c DE=0 make NORMAL
c330: 20 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 the default loc
c340: 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 king. ** mode.
c350: 20 44 6f 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 Doing nothing a
c360: 74 20 61 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 t all also makes
c370: 20 4e 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 NORMAL the defa
c380: 75 6c 74 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 ult.. */.#ifdef
c390: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
c3a0: 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 LOCKING_MODE. d
c3b0: 62 2d 3e 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 b->dfltLockMode
c3c0: 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 = SQLITE_DEFAULT
c3d0: 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 _LOCKING_MODE;.
c3e0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 sqlite3PagerLoc
c3f0: 6b 69 6e 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 kingMode(sqlite3
c400: 42 74 72 65 65 50 61 67 65 72 28 64 62 2d 3e 61 BtreePager(db->a
c410: 44 62 5b 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 Db[0].pBt),.
c420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c430: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 44 45 46 SQLITE_DEF
c440: 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
c450: 45 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a E);.#endif.. /*
c460: 20 45 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b Enable the look
c470: 61 73 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 aside-malloc sub
c480: 73 79 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 system */. setu
c490: 70 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 pLookaside(db, 0
c4a0: 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 , sqlite3GlobalC
c4b0: 6f 6e 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 onfig.szLookasid
c4c0: 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 e,.
c4d0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
c4e0: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e e3GlobalConfig.n
c4f0: 4c 6f 6f 6b 61 73 69 64 65 29 3b 0a 0a 6f 70 65 Lookaside);..ope
c500: 6e 64 62 5f 6f 75 74 3a 0a 20 20 69 66 28 20 64 ndb_out:. if( d
c510: 62 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 b ){. assert(
c520: 20 64 62 2d 3e 6d 75 74 65 78 21 3d 30 20 7c 7c db->mutex!=0 ||
c530: 20 69 73 54 68 72 65 61 64 73 61 66 65 3d 3d 30 isThreadsafe==0
c540: 20 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 || sqlite3Globa
c550: 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 lConfig.bFullMut
c560: 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c ex==0 );. sql
c570: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
c580: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d (db->mutex);. }
c590: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f . rc = sqlite3_
c5a0: 65 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 69 errcode(db);. i
c5b0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f f( rc==SQLITE_NO
c5c0: 4d 45 4d 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 MEM ){. sqlit
c5d0: 65 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 e3_close(db);.
c5e0: 20 20 64 62 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 db = 0;. }els
c5f0: 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 e if( rc!=SQLITE
c600: 5f 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d _OK ){. db->m
c610: 61 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 agic = SQLITE_MA
c620: 47 49 43 5f 53 49 43 4b 3b 0a 20 20 7d 0a 20 20 GIC_SICK;. }.
c630: 2a 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65 *ppDb = db;. re
c640: 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 turn sqlite3ApiE
c650: 78 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f xit(0, rc);.}../
c660: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 *.** Open a new
c670: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e database handle.
c680: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
c690: 6f 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 open(. const ch
c6a0: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a ar *zFilename, .
c6b0: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 sqlite3 **ppDb
c6c0: 20 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 .){. return op
c6d0: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 enDatabase(zFile
c6e0: 6e 61 6d 65 2c 20 70 70 44 62 2c 0a 20 20 20 20 name, ppDb,.
c6f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c700: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 SQLITE_OPEN_RE
c710: 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 ADWRITE | SQLITE
c720: 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 29 _OPEN_CREATE, 0)
c730: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ;.}.int sqlite3_
c740: 6f 70 65 6e 5f 76 32 28 0a 20 20 63 6f 6e 73 74 open_v2(. const
c750: 20 63 68 61 72 20 2a 66 69 6c 65 6e 61 6d 65 2c char *filename,
c760: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66 /* Database f
c770: 69 6c 65 6e 61 6d 65 20 28 55 54 46 2d 38 29 20 ilename (UTF-8)
c780: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 */. sqlite3 **p
c790: 70 44 62 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 pDb, /*
c7a0: 4f 55 54 3a 20 53 51 4c 69 74 65 20 64 62 20 68 OUT: SQLite db h
c7b0: 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 66 andle */. int f
c7c0: 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 lags,
c7d0: 20 20 20 2f 2a 20 46 6c 61 67 73 20 2a 2f 0a 20 /* Flags */.
c7e0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 const char *zVf
c7f0: 73 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 s /* Name
c800: 20 6f 66 20 56 46 53 20 6d 6f 64 75 6c 65 20 74 of VFS module t
c810: 6f 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 72 65 o use */.){. re
c820: 74 75 72 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 turn openDatabas
c830: 65 28 66 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 e(filename, ppDb
c840: 2c 20 66 6c 61 67 73 2c 20 7a 56 66 73 29 3b 0a , flags, zVfs);.
c850: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
c860: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a E_OMIT_UTF16./*.
c870: 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 ** Open a new da
c880: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a tabase handle..*
c890: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 /.int sqlite3_op
c8a0: 65 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76 6f en16(. const vo
c8b0: 69 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a id *zFilename, .
c8c0: 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 sqlite3 **ppDb
c8d0: 0a 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 .){. char const
c8e0: 20 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20 20 *zFilename8;
c8f0: 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e 63 /* zFilename enc
c900: 6f 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69 6e oded in UTF-8 in
c910: 73 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36 20 stead of UTF-16
c920: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c */. sqlite3_val
c930: 75 65 20 2a 70 56 61 6c 3b 0a 20 20 69 6e 74 20 ue *pVal;. int
c940: 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 7a rc;.. assert( z
c950: 46 69 6c 65 6e 61 6d 65 20 29 3b 0a 20 20 61 73 Filename );. as
c960: 73 65 72 74 28 20 70 70 44 62 20 29 3b 0a 20 20 sert( ppDb );.
c970: 2a 70 70 44 62 20 3d 20 30 3b 0a 23 69 66 6e 64 *ppDb = 0;.#ifnd
c980: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
c990: 55 54 4f 49 4e 49 54 0a 20 20 72 63 20 3d 20 73 UTOINIT. rc = s
c9a0: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a qlite3_initializ
c9b0: 65 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 e();. if( rc )
c9c0: 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 return rc;.#endi
c9d0: 66 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 74 f. pVal = sqlit
c9e0: 65 33 56 61 6c 75 65 4e 65 77 28 30 29 3b 0a 20 e3ValueNew(0);.
c9f0: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 sqlite3ValueSet
ca00: 53 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46 Str(pVal, -1, zF
ca10: 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f ilename, SQLITE_
ca20: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c UTF16NATIVE, SQL
ca30: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a ITE_STATIC);. z
ca40: 46 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69 Filename8 = sqli
ca50: 74 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 te3ValueText(pVa
ca60: 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b l, SQLITE_UTF8);
ca70: 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 . if( zFilename
ca80: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70 8 ){. rc = op
ca90: 65 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 enDatabase(zFile
caa0: 6e 61 6d 65 38 2c 20 70 70 44 62 2c 0a 20 20 20 name8, ppDb,.
cab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cac0: 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 SQLITE_OPEN_R
cad0: 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 EADWRITE | SQLIT
cae0: 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 E_OPEN_CREATE, 0
caf0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a );. assert( *
cb00: 70 70 44 62 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 ppDb || rc==SQLI
cb10: 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 TE_NOMEM );.
cb20: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
cb30: 4b 20 26 26 20 21 44 62 48 61 73 50 72 6f 70 65 K && !DbHasPrope
cb40: 72 74 79 28 2a 70 70 44 62 2c 20 30 2c 20 44 42 rty(*ppDb, 0, DB
cb50: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 _SchemaLoaded) )
cb60: 7b 0a 20 20 20 20 20 20 45 4e 43 28 2a 70 70 44 {. ENC(*ppD
cb70: 62 29 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 b) = SQLITE_UTF1
cb80: 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 7d 0a 20 6NATIVE;. }.
cb90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d }else{. rc =
cba0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
cbb0: 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 }. sqlite3Valu
cbc0: 65 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a 20 20 eFree(pVal);..
cbd0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 return sqlite3Ap
cbe0: 69 45 78 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a iExit(0, rc);.}.
cbf0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
cc00: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a _OMIT_UTF16 */..
cc10: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
cc20: 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 new collation s
cc30: 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 equence with the
cc40: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
cc50: 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 db..*/.int sqli
cc60: 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 te3_create_colla
cc70: 74 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a tion(. sqlite3*
cc80: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 db, . const ch
cc90: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e ar *zName, . in
cca0: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 t enc, . void*
ccb0: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f pCtx,. int(*xCo
ccc0: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 mpare)(void*,int
ccd0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 ,const void*,int
cce0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b ,const void*).){
ccf0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c . int rc;. sql
cd00: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
cd10: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 (db->mutex);. a
cd20: 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c ssert( !db->mall
cd30: 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 63 ocFailed );. rc
cd40: 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 = createCollati
cd50: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 65 6e on(db, zName, en
cd60: 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 72 c, pCtx, xCompar
cd70: 65 2c 20 30 29 3b 0a 20 20 72 63 20 3d 20 73 71 e, 0);. rc = sq
cd80: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
cd90: 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
cda0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
cdb0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
cdc0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
cdd0: 67 69 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c gister a new col
cde0: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
cdf0: 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
ce00: 65 20 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a e handle db..*/.
ce10: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 int sqlite3_crea
ce20: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76 32 28 te_collation_v2(
ce30: 0a 20 20 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 . sqlite3* db,
ce40: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
ce50: 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 20 65 6e 63 Name, . int enc
ce60: 2c 20 0a 20 20 76 6f 69 64 2a 20 70 43 74 78 2c , . void* pCtx,
ce70: 0a 20 20 69 6e 74 28 2a 78 43 6f 6d 70 61 72 65 . int(*xCompare
ce80: 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
ce90: 74 20 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 t void*,int,cons
cea0: 74 20 76 6f 69 64 2a 29 2c 0a 20 20 76 6f 69 64 t void*),. void
ceb0: 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 (*xDel)(void*).)
cec0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 {. int rc;. sq
ced0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
cee0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
cef0: 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c assert( !db->mal
cf00: 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 locFailed );. r
cf10: 63 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 c = createCollat
cf20: 69 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 65 ion(db, zName, e
cf30: 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 nc, pCtx, xCompa
cf40: 72 65 2c 20 78 44 65 6c 29 3b 0a 20 20 72 63 20 re, xDel);. rc
cf50: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
cf60: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
cf70: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
cf80: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
cf90: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e turn rc;.}..#ifn
cfa0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
cfb0: 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 52 65 67 69 UTF16./*.** Regi
cfc0: 73 74 65 72 20 61 20 6e 65 77 20 63 6f 6c 6c 61 ster a new colla
cfd0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 77 69 tion sequence wi
cfe0: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 th the database
cff0: 68 61 6e 64 6c 65 20 64 62 2e 0a 2a 2f 0a 69 6e handle db..*/.in
d000: 74 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 t sqlite3_create
d010: 5f 63 6f 6c 6c 61 74 69 6f 6e 31 36 28 0a 20 20 _collation16(.
d020: 73 71 6c 69 74 65 33 2a 20 64 62 2c 20 0a 20 20 sqlite3* db, .
d030: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 4e 61 6d const void *zNam
d040: 65 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 20 0a 20 e,. int enc, .
d050: 20 76 6f 69 64 2a 20 70 43 74 78 2c 0a 20 20 69 void* pCtx,. i
d060: 6e 74 28 2a 78 43 6f 6d 70 61 72 65 29 28 76 6f nt(*xCompare)(vo
d070: 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f id*,int,const vo
d080: 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f id*,int,const vo
d090: 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 id*).){. int rc
d0a0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
d0b0: 63 68 61 72 20 2a 7a 4e 61 6d 65 38 3b 0a 20 20 char *zName8;.
d0c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
d0d0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
d0e0: 20 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d assert( !db->m
d0f0: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 allocFailed );.
d100: 20 7a 4e 61 6d 65 38 20 3d 20 73 71 6c 69 74 65 zName8 = sqlite
d110: 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 4e 3Utf16to8(db, zN
d120: 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 69 66 28 20 ame, -1);. if(
d130: 7a 4e 61 6d 65 38 20 29 7b 0a 20 20 20 20 72 63 zName8 ){. rc
d140: 20 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 = createCollati
d150: 6f 6e 28 64 62 2c 20 7a 4e 61 6d 65 38 2c 20 65 on(db, zName8, e
d160: 6e 63 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 61 nc, pCtx, xCompa
d170: 72 65 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 re, 0);. sqli
d180: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 4e te3DbFree(db, zN
d190: 61 6d 65 38 29 3b 0a 20 20 7d 0a 20 20 72 63 20 ame8);. }. rc
d1a0: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
d1b0: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
d1c0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
d1d0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
d1e0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 turn rc;.}.#endi
d1f0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 f /* SQLITE_OMIT
d200: 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a _UTF16 */../*.**
d210: 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c 6c Register a coll
d220: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 ation sequence f
d230: 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b 20 actory callback
d240: 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73 with the databas
d250: 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 e handle.** db.
d260: 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 76 Replace any prev
d270: 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 64 iously installed
d280: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
d290: 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f 0a nce factory..*/.
d2a0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c int sqlite3_coll
d2b0: 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 20 ation_needed(.
d2c0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 20 sqlite3 *db, .
d2d0: 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 void *pCollNeede
d2e0: 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a 78 dArg, . void(*x
d2f0: 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 CollNeeded)(void
d300: 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 *,sqlite3*,int e
d310: 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 TextRep,const ch
d320: 61 72 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74 65 ar*).){. sqlite
d330: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
d340: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
d350: 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 43 xCollNeeded = xC
d360: 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 2d ollNeeded;. db-
d370: 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d >xCollNeeded16 =
d380: 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c 4e 0;. db->pCollN
d390: 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c 6c eededArg = pColl
d3a0: 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 73 71 6c NeededArg;. sql
d3b0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
d3c0: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
d3d0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
d3e0: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
d3f0: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a TE_OMIT_UTF16./*
d400: 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 .** Register a c
d410: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
d420: 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 e factory callba
d430: 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 61 ck with the data
d440: 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 base handle.** d
d450: 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 b. Replace any p
d460: 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c reviously instal
d470: 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 led collation se
d480: 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a quence factory..
d490: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 */.int sqlite3_c
d4a0: 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 31 ollation_needed1
d4b0: 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 6(. sqlite3 *db
d4c0: 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c , . void *pColl
d4d0: 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 6f NeededArg, . vo
d4e0: 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 id(*xCollNeeded1
d4f0: 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 6)(void*,sqlite3
d500: 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 *,int eTextRep,c
d510: 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a 20 onst void*).){.
d520: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
d530: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
d540: 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 64 . db->xCollNeed
d550: 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 43 ed = 0;. db->xC
d560: 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 43 ollNeeded16 = xC
d570: 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 64 ollNeeded16;. d
d580: 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 b->pCollNeededAr
d590: 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 41 g = pCollNeededA
d5a0: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
d5b0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
d5c0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
d5d0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
d5e0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
d5f0: 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 6e T_UTF16 */..#ifn
d600: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
d610: 47 4c 4f 42 41 4c 52 45 43 4f 56 45 52 0a 23 69 GLOBALRECOVER.#i
d620: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
d630: 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a T_DEPRECATED./*.
d640: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
d650: 20 69 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 68 is now an anach
d660: 72 6f 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 20 ronism. It used
d670: 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 to be used to re
d680: 63 6f 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a 20 cover from a.**
d690: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 malloc() failure
d6a0: 2c 20 62 75 74 20 53 51 4c 69 74 65 20 6e 6f 77 , but SQLite now
d6b0: 20 64 6f 65 73 20 74 68 69 73 20 61 75 74 6f 6d does this autom
d6c0: 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e 74 atically..*/.int
d6d0: 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f sqlite3_global_
d6e0: 72 65 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a 20 recover(void){.
d6f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
d700: 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 23 65 6e 64 K;.}.#endif.#end
d710: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 74 if../*.** Test t
d720: 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 6f 72 o see whether or
d730: 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 73 not the databas
d740: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 e connection is
d750: 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 0a 2a 2a in autocommit.**
d760: 20 6d 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 54 mode. Return T
d770: 52 55 45 20 69 66 20 69 74 20 69 73 20 61 6e 64 RUE if it is and
d780: 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 2e 20 20 FALSE if not.
d790: 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 20 Autocommit mode
d7a0: 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64 65 66 61 is on.** by defa
d7b0: 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 74 ult. Autocommit
d7c0: 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 20 is disabled by
d7d0: 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65 6e a BEGIN statemen
d7e0: 74 20 61 6e 64 20 72 65 65 6e 61 62 6c 65 64 0a t and reenabled.
d7f0: 2a 2a 20 62 79 20 74 68 65 20 6e 65 78 74 20 43 ** by the next C
d800: 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c 42 41 43 OMMIT or ROLLBAC
d810: 4b 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 20 54 48 K..**.******* TH
d820: 49 53 20 49 53 20 41 4e 20 45 58 50 45 52 49 4d IS IS AN EXPERIM
d830: 45 4e 54 41 4c 20 41 50 49 20 41 4e 44 20 49 53 ENTAL API AND IS
d840: 20 53 55 42 4a 45 43 54 20 54 4f 20 43 48 41 4e SUBJECT TO CHAN
d850: 47 45 20 2a 2a 2a 2a 2a 2a 0a 2a 2f 0a 69 6e 74 GE ******.*/.int
d860: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 sqlite3_get_aut
d870: 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 ocommit(sqlite3
d880: 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 64 *db){. return d
d890: 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 3b 0a 7d b->autoCommit;.}
d8a0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
d8b0: 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 54 68 65 20 DEBUG./*.** The
d8c0: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e following routin
d8d0: 65 20 69 73 20 73 75 62 74 69 74 75 74 65 64 20 e is subtituted
d8e0: 66 6f 72 20 63 6f 6e 73 74 61 6e 74 20 53 51 4c for constant SQL
d8f0: 49 54 45 5f 43 4f 52 52 55 50 54 20 69 6e 0a 2a ITE_CORRUPT in.*
d900: 2a 20 64 65 62 75 67 67 69 6e 67 20 62 75 69 6c * debugging buil
d910: 64 73 2e 20 20 54 68 69 73 20 70 72 6f 76 69 64 ds. This provid
d920: 65 73 20 61 20 77 61 79 20 74 6f 20 73 65 74 20 es a way to set
d930: 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 66 6f 72 a breakpoint for
d940: 20 77 68 65 6e 0a 2a 2a 20 63 6f 72 72 75 70 74 when.** corrupt
d950: 69 6f 6e 20 69 73 20 66 69 72 73 74 20 64 65 74 ion is first det
d960: 65 63 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ected..*/.int sq
d970: 6c 69 74 65 33 43 6f 72 72 75 70 74 28 76 6f 69 lite3Corrupt(voi
d980: 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c d){. return SQL
d990: 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 7d 0a 23 ITE_CORRUPT;.}.#
d9a0: 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
d9b0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 QLITE_OMIT_DEPRE
d9c0: 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 68 69 73 CATED./*.** This
d9d0: 20 69 73 20 61 20 63 6f 6e 76 65 6e 69 65 6e 63 is a convenienc
d9e0: 65 20 72 6f 75 74 69 6e 65 20 74 68 61 74 20 6d e routine that m
d9f0: 61 6b 65 73 20 73 75 72 65 20 74 68 61 74 20 61 akes sure that a
da00: 6c 6c 20 74 68 72 65 61 64 2d 73 70 65 63 69 66 ll thread-specif
da10: 69 63 0a 2a 2a 20 64 61 74 61 20 66 6f 72 20 74 ic.** data for t
da20: 68 69 73 20 74 68 72 65 61 64 20 68 61 73 20 62 his thread has b
da30: 65 65 6e 20 64 65 61 6c 6c 6f 63 61 74 65 64 2e een deallocated.
da40: 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 6e 6f .**.** SQLite no
da50: 20 6c 6f 6e 67 65 72 20 75 73 65 73 20 74 68 72 longer uses thr
da60: 65 61 64 2d 73 70 65 63 69 66 69 63 20 64 61 74 ead-specific dat
da70: 61 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 6e a so this routin
da80: 65 20 69 73 20 6e 6f 77 20 61 0a 2a 2a 20 6e 6f e is now a.** no
da90: 2d 6f 70 2e 20 20 49 74 20 69 73 20 72 65 74 61 -op. It is reta
daa0: 69 6e 65 64 20 66 6f 72 20 68 69 73 74 6f 72 69 ined for histori
dab0: 63 61 6c 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 cal compatibilit
dac0: 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 y..*/.void sqlit
dad0: 65 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 e3_thread_cleanu
dae0: 70 28 76 6f 69 64 29 7b 0a 7d 0a 23 65 6e 64 69 p(void){.}.#endi
daf0: 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 f../*.** Return
db00: 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e meta information
db10: 20 61 62 6f 75 74 20 61 20 73 70 65 63 69 66 69 about a specifi
db20: 63 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 20 64 61 c column of a da
db30: 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2a tabase table..**
db40: 20 53 65 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 See comment in
db50: 73 71 6c 69 74 65 33 2e 68 20 28 73 71 6c 69 74 sqlite3.h (sqlit
db60: 65 2e 68 2e 69 6e 29 20 66 6f 72 20 64 65 74 61 e.h.in) for deta
db70: 69 6c 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ils..*/.#ifdef S
db80: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c QLITE_ENABLE_COL
db90: 55 4d 4e 5f 4d 45 54 41 44 41 54 41 0a 69 6e 74 UMN_METADATA.int
dba0: 20 73 71 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63 sqlite3_table_c
dbb0: 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61 28 0a olumn_metadata(.
dbc0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
dbd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
dbe0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 Connection hand
dbf0: 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 le */. const ch
dc00: 61 72 20 2a 7a 44 62 4e 61 6d 65 2c 20 20 20 20 ar *zDbName,
dc10: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
dc20: 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a name or NULL */.
dc30: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 const char *zT
dc40: 61 62 6c 65 4e 61 6d 65 2c 20 20 20 20 20 2f 2a ableName, /*
dc50: 20 54 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 Table name */.
dc60: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f const char *zCo
dc70: 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 20 2f 2a 20 lumnName, /*
dc80: 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 20 Column name */.
dc90: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a char const **pz
dca0: 44 61 74 61 54 79 70 65 2c 20 20 20 20 2f 2a 20 DataType, /*
dcb0: 4f 55 54 50 55 54 3a 20 44 65 63 6c 61 72 65 64 OUTPUT: Declared
dcc0: 20 64 61 74 61 20 74 79 70 65 20 2a 2f 0a 20 20 data type */.
dcd0: 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a 43 char const **pzC
dce0: 6f 6c 6c 53 65 71 2c 20 20 20 20 20 2f 2a 20 4f ollSeq, /* O
dcf0: 55 54 50 55 54 3a 20 43 6f 6c 6c 61 74 69 6f 6e UTPUT: Collation
dd00: 20 73 65 71 75 65 6e 63 65 20 6e 61 6d 65 20 2a sequence name *
dd10: 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f 74 4e 75 6c /. int *pNotNul
dd20: 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
dd30: 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 /* OUTPUT: True
dd40: 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 if NOT NULL cons
dd50: 74 72 61 69 6e 74 20 65 78 69 73 74 73 20 2a 2f traint exists */
dd60: 0a 20 20 69 6e 74 20 2a 70 50 72 69 6d 61 72 79 . int *pPrimary
dd70: 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f Key, /
dd80: 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 69 * OUTPUT: True i
dd90: 66 20 63 6f 6c 75 6d 6e 20 70 61 72 74 20 6f 66 f column part of
dda0: 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 41 PK */. int *pA
ddb0: 75 74 6f 69 6e 63 20 20 20 20 20 20 20 20 20 20 utoinc
ddc0: 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a 20 /* OUTPUT:
ddd0: 54 72 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 True if column i
dde0: 73 20 61 75 74 6f 2d 69 6e 63 72 65 6d 65 6e 74 s auto-increment
ddf0: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b */.){. int rc;
de00: 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 . char *zErrMsg
de10: 20 3d 20 30 3b 0a 20 20 54 61 62 6c 65 20 2a 70 = 0;. Table *p
de20: 54 61 62 20 3d 20 30 3b 0a 20 20 43 6f 6c 75 6d Tab = 0;. Colum
de30: 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b 0a 20 20 69 n *pCol = 0;. i
de40: 6e 74 20 69 43 6f 6c 3b 0a 0a 20 20 63 68 61 72 nt iCol;.. char
de50: 20 63 6f 6e 73 74 20 2a 7a 44 61 74 61 54 79 70 const *zDataTyp
de60: 65 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 63 6f e = 0;. char co
de70: 6e 73 74 20 2a 7a 43 6f 6c 6c 53 65 71 20 3d 20 nst *zCollSeq =
de80: 30 3b 0a 20 20 69 6e 74 20 6e 6f 74 6e 75 6c 6c 0;. int notnull
de90: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 70 72 69 6d = 0;. int prim
dea0: 61 72 79 6b 65 79 20 3d 20 30 3b 0a 20 20 69 6e arykey = 0;. in
deb0: 74 20 61 75 74 6f 69 6e 63 20 3d 20 30 3b 0a 0a t autoinc = 0;..
dec0: 20 20 2f 2a 20 45 6e 73 75 72 65 20 74 68 65 20 /* Ensure the
ded0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 database schema
dee0: 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 has been loaded
def0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 */. sqlite3_mut
df00: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
df10: 65 78 29 3b 0a 20 20 28 76 6f 69 64 29 73 71 6c ex);. (void)sql
df20: 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 ite3SafetyOn(db)
df30: 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
df40: 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 20 EnterAll(db);.
df50: 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 rc = sqlite3Init
df60: 28 64 62 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a (db, &zErrMsg);.
df70: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 if( SQLITE_OK!
df80: 3d 72 63 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 =rc ){. goto
df90: 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a error_out;. }..
dfa0: 20 20 2f 2a 20 4c 6f 63 61 74 65 20 74 68 65 20 /* Locate the
dfb0: 74 61 62 6c 65 20 69 6e 20 71 75 65 73 74 69 6f table in questio
dfc0: 6e 20 2a 2f 0a 20 20 70 54 61 62 20 3d 20 73 71 n */. pTab = sq
dfd0: 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 64 lite3FindTable(d
dfe0: 62 2c 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 7a b, zTableName, z
dff0: 44 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 21 DbName);. if( !
e000: 70 54 61 62 20 7c 7c 20 70 54 61 62 2d 3e 70 53 pTab || pTab->pS
e010: 65 6c 65 63 74 20 29 7b 0a 20 20 20 20 70 54 61 elect ){. pTa
e020: 62 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 6f 20 b = 0;. goto
e030: 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a error_out;. }..
e040: 20 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 63 6f /* Find the co
e050: 6c 75 6d 6e 20 66 6f 72 20 77 68 69 63 68 20 69 lumn for which i
e060: 6e 66 6f 20 69 73 20 72 65 71 75 65 73 74 65 64 nfo is requested
e070: 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65 */. if( sqlite
e080: 33 49 73 52 6f 77 69 64 28 7a 43 6f 6c 75 6d 6e 3IsRowid(zColumn
e090: 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 69 43 6f Name) ){. iCo
e0a0: 6c 20 3d 20 70 54 61 62 2d 3e 69 50 4b 65 79 3b l = pTab->iPKey;
e0b0: 0a 20 20 20 20 69 66 28 20 69 43 6f 6c 3e 3d 30 . if( iCol>=0
e0c0: 20 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d ){. pCol =
e0d0: 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f &pTab->aCol[iCo
e0e0: 6c 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 l];. }. }els
e0f0: 65 7b 0a 20 20 20 20 66 6f 72 28 69 43 6f 6c 3d e{. for(iCol=
e100: 30 3b 20 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e 43 0; iCol<pTab->nC
e110: 6f 6c 3b 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 20 ol; iCol++){.
e120: 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d pCol = &pTab-
e130: 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 20 >aCol[iCol];.
e140: 20 20 20 69 66 28 20 30 3d 3d 73 71 6c 69 74 65 if( 0==sqlite
e150: 33 53 74 72 49 43 6d 70 28 70 43 6f 6c 2d 3e 7a 3StrICmp(pCol->z
e160: 4e 61 6d 65 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 6d Name, zColumnNam
e170: 65 29 20 29 7b 0a 20 20 20 20 20 20 20 20 62 72 e) ){. br
e180: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 eak;. }.
e190: 20 7d 0a 20 20 20 20 69 66 28 20 69 43 6f 6c 3d }. if( iCol=
e1a0: 3d 70 54 61 62 2d 3e 6e 43 6f 6c 20 29 7b 0a 20 =pTab->nCol ){.
e1b0: 20 20 20 20 20 70 54 61 62 20 3d 20 30 3b 0a 20 pTab = 0;.
e1c0: 20 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f goto error_
e1d0: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a out;. }. }..
e1e0: 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 /* The followi
e1f0: 6e 67 20 62 6c 6f 63 6b 20 73 74 6f 72 65 73 20 ng block stores
e200: 74 68 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 the meta informa
e210: 74 69 6f 6e 20 74 68 61 74 20 77 69 6c 6c 20 62 tion that will b
e220: 65 20 72 65 74 75 72 6e 65 64 0a 20 20 2a 2a 20 e returned. **
e230: 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 69 6e to the caller in
e240: 20 6c 6f 63 61 6c 20 76 61 72 69 61 62 6c 65 73 local variables
e250: 20 7a 44 61 74 61 54 79 70 65 2c 20 7a 43 6f 6c zDataType, zCol
e260: 6c 53 65 71 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 70 lSeq, notnull, p
e270: 72 69 6d 61 72 79 6b 65 79 0a 20 20 2a 2a 20 61 rimarykey. ** a
e280: 6e 64 20 61 75 74 6f 69 6e 63 2e 20 41 74 20 74 nd autoinc. At t
e290: 68 69 73 20 70 6f 69 6e 74 20 74 68 65 72 65 20 his point there
e2a0: 61 72 65 20 74 77 6f 20 70 6f 73 73 69 62 69 6c are two possibil
e2b0: 69 74 69 65 73 3a 0a 20 20 2a 2a 20 0a 20 20 2a ities:. ** . *
e2c0: 2a 20 20 20 20 20 31 2e 20 54 68 65 20 73 70 65 * 1. The spe
e2d0: 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 cified column na
e2e0: 6d 65 20 77 61 73 20 72 6f 77 69 64 22 2c 20 22 me was rowid", "
e2f0: 6f 69 64 22 20 6f 72 20 22 5f 72 6f 77 69 64 5f oid" or "_rowid_
e300: 22 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 61 " . ** a
e310: 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 65 nd there is no e
e320: 78 70 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 72 xplicitly declar
e330: 65 64 20 49 50 4b 20 63 6f 6c 75 6d 6e 2e 20 0a ed IPK column. .
e340: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 32 2e **. ** 2.
e350: 20 54 68 65 20 74 61 62 6c 65 20 69 73 20 6e 6f The table is no
e360: 74 20 61 20 76 69 65 77 20 61 6e 64 20 74 68 65 t a view and the
e370: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 69 64 65 column name ide
e380: 6e 74 69 66 69 65 64 20 61 6e 20 0a 20 20 2a 2a ntified an . **
e390: 20 20 20 20 20 20 20 20 65 78 70 6c 69 63 69 74 explicit
e3a0: 6c 79 20 64 65 63 6c 61 72 65 64 20 63 6f 6c 75 ly declared colu
e3b0: 6d 6e 2e 20 43 6f 70 79 20 6d 65 74 61 20 69 6e mn. Copy meta in
e3c0: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 2a formation from *
e3d0: 70 43 6f 6c 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 pCol.. */ . if
e3e0: 28 20 70 43 6f 6c 20 29 7b 0a 20 20 20 20 7a 44 ( pCol ){. zD
e3f0: 61 74 61 54 79 70 65 20 3d 20 70 43 6f 6c 2d 3e ataType = pCol->
e400: 7a 54 79 70 65 3b 0a 20 20 20 20 7a 43 6f 6c 6c zType;. zColl
e410: 53 65 71 20 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c Seq = pCol->zCol
e420: 6c 3b 0a 20 20 20 20 6e 6f 74 6e 75 6c 6c 20 3d l;. notnull =
e430: 20 70 43 6f 6c 2d 3e 6e 6f 74 4e 75 6c 6c 21 3d pCol->notNull!=
e440: 30 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b 65 0;. primaryke
e450: 79 20 20 3d 20 70 43 6f 6c 2d 3e 69 73 50 72 69 y = pCol->isPri
e460: 6d 4b 65 79 21 3d 30 3b 0a 20 20 20 20 61 75 74 mKey!=0;. aut
e470: 6f 69 6e 63 20 3d 20 70 54 61 62 2d 3e 69 50 4b oinc = pTab->iPK
e480: 65 79 3d 3d 69 43 6f 6c 20 26 26 20 28 70 54 61 ey==iCol && (pTa
e490: 62 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 b->tabFlags & TF
e4a0: 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 29 21 _Autoincrement)!
e4b0: 3d 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 =0;. }else{.
e4c0: 20 7a 44 61 74 61 54 79 70 65 20 3d 20 22 49 4e zDataType = "IN
e4d0: 54 45 47 45 52 22 3b 0a 20 20 20 20 70 72 69 6d TEGER";. prim
e4e0: 61 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 7d 0a arykey = 1;. }.
e4f0: 20 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 71 20 if( !zCollSeq
e500: 29 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 20 ){. zCollSeq
e510: 3d 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 7d 0a = "BINARY";. }.
e520: 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 73 71 .error_out:. sq
e530: 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 lite3BtreeLeaveA
e540: 6c 6c 28 64 62 29 3b 0a 20 20 28 76 6f 69 64 29 ll(db);. (void)
e550: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 sqlite3SafetyOff
e560: 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 57 68 65 74 (db);.. /* Whet
e570: 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 6f 6e her the function
e580: 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 64 20 call succeeded
e590: 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 20 74 or failed, set t
e5a0: 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 he output parame
e5b0: 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 68 61 ters. ** to wha
e5c0: 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f 63 61 tever their loca
e5d0: 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 20 63 l counterparts c
e5e0: 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 65 72 ontain. If an er
e5f0: 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c 0a 20 ror did occur,.
e600: 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 68 65 ** this has the
e610: 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 6f 69 effect of zeroi
e620: 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 70 61 ng all output pa
e630: 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f 0a 20 rameters.. */.
e640: 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 65 20 if( pzDataType
e650: 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 3d 20 ) *pzDataType =
e660: 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 66 28 zDataType;. if(
e670: 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a 70 7a pzCollSeq ) *pz
e680: 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c 6c 53 CollSeq = zCollS
e690: 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 4e 75 eq;. if( pNotNu
e6a0: 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c 20 3d ll ) *pNotNull =
e6b0: 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 28 20 notnull;. if(
e6c0: 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 2a 70 pPrimaryKey ) *p
e6d0: 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 72 69 PrimaryKey = pri
e6e0: 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 20 70 marykey;. if( p
e6f0: 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 74 6f Autoinc ) *pAuto
e700: 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b 0a 0a inc = autoinc;..
e710: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d if( SQLITE_OK=
e720: 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 7b 0a =rc && !pTab ){.
e730: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
e740: 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a e(db, zErrMsg);.
e750: 20 20 20 20 7a 45 72 72 4d 73 67 20 3d 20 73 71 zErrMsg = sq
e760: 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c lite3MPrintf(db,
e770: 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 20 "no such table
e780: 63 6f 6c 75 6d 6e 3a 20 25 73 2e 25 73 22 2c 20 column: %s.%s",
e790: 7a 54 61 62 6c 65 4e 61 6d 65 2c 0a 20 20 20 20 zTableName,.
e7a0: 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 29 zColumnName)
e7b0: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 ;. rc = SQLIT
e7c0: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 73 E_ERROR;. }. s
e7d0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
e7e0: 72 63 2c 20 28 7a 45 72 72 4d 73 67 3f 22 25 73 rc, (zErrMsg?"%s
e7f0: 22 3a 30 29 2c 20 7a 45 72 72 4d 73 67 29 3b 0a ":0), zErrMsg);.
e800: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
e810: 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 db, zErrMsg);.
e820: 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 rc = sqlite3ApiE
e830: 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 xit(db, rc);. s
e840: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
e850: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
e860: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 return rc;.}.#e
e870: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 ndif../*.** Slee
e880: 70 20 66 6f 72 20 61 20 6c 69 74 74 6c 65 20 77 p for a little w
e890: 68 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 74 68 hile. Return th
e8a0: 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 e amount of time
e8b0: 20 73 6c 65 70 74 2e 0a 2a 2f 0a 69 6e 74 20 73 slept..*/.int s
e8c0: 71 6c 69 74 65 33 5f 73 6c 65 65 70 28 69 6e 74 qlite3_sleep(int
e8d0: 20 6d 73 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f ms){. sqlite3_
e8e0: 76 66 73 20 2a 70 56 66 73 3b 0a 20 20 69 6e 74 vfs *pVfs;. int
e8f0: 20 72 63 3b 0a 20 20 70 56 66 73 20 3d 20 73 71 rc;. pVfs = sq
e900: 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 28 30 lite3_vfs_find(0
e910: 29 3b 0a 20 20 69 66 28 20 70 56 66 73 3d 3d 30 );. if( pVfs==0
e920: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 0a 20 20 ) return 0;..
e930: 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e /* This function
e940: 20 77 6f 72 6b 73 20 69 6e 20 6d 69 6c 6c 69 73 works in millis
e950: 65 63 6f 6e 64 73 2c 20 62 75 74 20 74 68 65 20 econds, but the
e960: 75 6e 64 65 72 6c 79 69 6e 67 20 4f 73 53 6c 65 underlying OsSle
e970: 65 70 28 29 20 0a 20 20 2a 2a 20 41 50 49 20 75 ep() . ** API u
e980: 73 65 73 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 ses microseconds
e990: 2e 20 48 65 6e 63 65 20 74 68 65 20 31 30 30 30 . Hence the 1000
e9a0: 27 73 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 's.. */. rc =
e9b0: 28 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 (sqlite3OsSleep(
e9c0: 70 56 66 73 2c 20 31 30 30 30 2a 6d 73 29 2f 31 pVfs, 1000*ms)/1
e9d0: 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 000);. return r
e9e0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 c;.}../*.** Enab
e9f0: 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 le or disable th
ea00: 65 20 65 78 74 65 6e 64 65 64 20 72 65 73 75 6c e extended resul
ea10: 74 20 63 6f 64 65 73 2e 0a 2a 2f 0a 69 6e 74 20 t codes..*/.int
ea20: 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 64 sqlite3_extended
ea30: 5f 72 65 73 75 6c 74 5f 63 6f 64 65 73 28 73 71 _result_codes(sq
ea40: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6f lite3 *db, int o
ea50: 6e 6f 66 66 29 7b 0a 20 20 73 71 6c 69 74 65 33 noff){. sqlite3
ea60: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
ea70: 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e 65 >mutex);. db->e
ea80: 72 72 4d 61 73 6b 20 3d 20 6f 6e 6f 66 66 20 3f rrMask = onoff ?
ea90: 20 30 78 66 66 66 66 66 66 66 66 20 3a 20 30 78 0xffffffff : 0x
eaa0: 66 66 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 ff;. sqlite3_mu
eab0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
eac0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 tex);. return S
ead0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
eae0: 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 78 46 ** Invoke the xF
eaf0: 69 6c 65 43 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f ileControl metho
eb00: 64 20 6f 6e 20 61 20 70 61 72 74 69 63 75 6c 61 d on a particula
eb10: 72 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 69 r database..*/.i
eb20: 6e 74 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 5f nt sqlite3_file_
eb30: 63 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 20 control(sqlite3
eb40: 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 *db, const char
eb50: 2a 7a 44 62 4e 61 6d 65 2c 20 69 6e 74 20 6f 70 *zDbName, int op
eb60: 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 , void *pArg){.
eb70: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
eb80: 5f 45 52 52 4f 52 3b 0a 20 20 69 6e 74 20 69 44 _ERROR;. int iD
eb90: 62 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 b;. sqlite3_mut
eba0: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
ebb0: 65 78 29 3b 0a 20 20 69 66 28 20 7a 44 62 4e 61 ex);. if( zDbNa
ebc0: 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 44 62 me==0 ){. iDb
ebd0: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 0;. }else{.
ebe0: 20 20 20 66 6f 72 28 69 44 62 3d 30 3b 20 69 44 for(iDb=0; iD
ebf0: 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b b<db->nDb; iDb++
ec00: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 ){. if( str
ec10: 63 6d 70 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d cmp(db->aDb[iDb]
ec20: 2e 7a 4e 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 29 .zName, zDbName)
ec30: 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 ==0 ) break;.
ec40: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 69 44 62 }. }. if( iDb
ec50: 3c 64 62 2d 3e 6e 44 62 20 29 7b 0a 20 20 20 20 <db->nDb ){.
ec60: 42 74 72 65 65 20 2a 70 42 74 72 65 65 20 3d 20 Btree *pBtree =
ec70: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
ec80: 3b 0a 20 20 20 20 69 66 28 20 70 42 74 72 65 65 ;. if( pBtree
ec90: 20 29 7b 0a 20 20 20 20 20 20 50 61 67 65 72 20 ){. Pager
eca0: 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 20 20 73 *pPager;. s
ecb0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b qlite3_file *fd;
ecc0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 . sqlite3Bt
ecd0: 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 reeEnter(pBtree)
ece0: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 20 3d ;. pPager =
ecf0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 sqlite3BtreePag
ed00: 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 20 er(pBtree);.
ed10: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
ed20: 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 66 64 20 !=0 );. fd
ed30: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 = sqlite3PagerFi
ed40: 6c 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 le(pPager);.
ed50: 20 20 61 73 73 65 72 74 28 20 66 64 21 3d 30 20 assert( fd!=0
ed60: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 66 64 2d );. if( fd-
ed70: 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 >pMethods ){.
ed80: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
ed90: 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 66 3OsFileControl(f
eda0: 64 2c 20 6f 70 2c 20 70 41 72 67 29 3b 0a 20 20 d, op, pArg);.
edb0: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 }. sqli
edc0: 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 42 te3BtreeLeave(pB
edd0: 74 72 65 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d tree);. }. }
ede0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
edf0: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
ee00: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 20 );. return rc;
ee10: 20 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 .}../*.** Inte
ee20: 72 66 61 63 65 20 74 6f 20 74 68 65 20 74 65 73 rface to the tes
ee30: 74 69 6e 67 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 69 ting logic..*/.i
ee40: 6e 74 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f nt sqlite3_test_
ee50: 63 6f 6e 74 72 6f 6c 28 69 6e 74 20 6f 70 2c 20 control(int op,
ee60: 2e 2e 2e 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ...){. int rc =
ee70: 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 0;.#ifndef SQLI
ee80: 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f TE_OMIT_BUILTIN_
ee90: 54 45 53 54 0a 20 20 76 61 5f 6c 69 73 74 20 61 TEST. va_list a
eea0: 70 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 70 p;. va_start(ap
eeb0: 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 28 , op);. switch(
eec0: 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 0a 20 op ){.. /*.
eed0: 20 20 20 2a 2a 20 53 61 76 65 20 74 68 65 20 63 ** Save the c
eee0: 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 urrent state of
eef0: 74 68 65 20 50 52 4e 47 2e 0a 20 20 20 20 2a 2f the PRNG.. */
ef00: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
ef10: 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e 47 5f 53 _TESTCTRL_PRNG_S
ef20: 41 56 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c AVE: {. sql
ef30: 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 61 74 ite3PrngSaveStat
ef40: 65 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b e();. break
ef50: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a ;. }.. /*.
ef60: 20 20 20 20 2a 2a 20 52 65 73 74 6f 72 65 20 74 ** Restore t
ef70: 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 he state of the
ef80: 50 52 4e 47 20 74 6f 20 74 68 65 20 6c 61 73 74 PRNG to the last
ef90: 20 73 74 61 74 65 20 73 61 76 65 64 20 75 73 69 state saved usi
efa0: 6e 67 0a 20 20 20 20 2a 2a 20 50 52 4e 47 5f 53 ng. ** PRNG_S
efb0: 41 56 45 2e 20 20 49 66 20 50 52 4e 47 5f 53 41 AVE. If PRNG_SA
efc0: 56 45 20 68 61 73 20 6e 65 76 65 72 20 62 65 66 VE has never bef
efd0: 6f 72 65 20 62 65 65 6e 20 63 61 6c 6c 65 64 2c ore been called,
efe0: 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68 69 then. ** thi
eff0: 73 20 76 65 72 62 20 61 63 74 73 20 6c 69 6b 65 s verb acts like
f000: 20 50 52 4e 47 5f 52 45 53 45 54 2e 0a 20 20 20 PRNG_RESET..
f010: 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
f020: 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e ITE_TESTCTRL_PRN
f030: 47 5f 52 45 53 54 4f 52 45 3a 20 7b 0a 20 20 20 G_RESTORE: {.
f040: 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 52 65 sqlite3PrngRe
f050: 73 74 6f 72 65 53 74 61 74 65 28 29 3b 0a 20 20 storeState();.
f060: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
f070: 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
f080: 52 65 73 65 74 20 74 68 65 20 50 52 4e 47 20 62 Reset the PRNG b
f090: 61 63 6b 20 74 6f 20 69 74 73 20 75 6e 69 6e 69 ack to its unini
f0a0: 74 69 61 6c 69 7a 65 64 20 73 74 61 74 65 2e 20 tialized state.
f0b0: 20 54 68 65 20 6e 65 78 74 20 63 61 6c 6c 0a 20 The next call.
f0c0: 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 ** to sqlite3
f0d0: 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 29 20 77 69 _randomness() wi
f0e0: 6c 6c 20 72 65 73 65 65 64 20 74 68 65 20 50 52 ll reseed the PR
f0f0: 4e 47 20 75 73 69 6e 67 20 61 20 73 69 6e 67 6c NG using a singl
f100: 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f e call. ** to
f110: 20 74 68 65 20 78 52 61 6e 64 6f 6d 6e 65 73 73 the xRandomness
f120: 20 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 64 method of the d
f130: 65 66 61 75 6c 74 20 56 46 53 2e 0a 20 20 20 20 efault VFS..
f140: 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 */. case SQLI
f150: 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e 47 TE_TESTCTRL_PRNG
f160: 5f 52 45 53 45 54 3a 20 7b 0a 20 20 20 20 20 20 _RESET: {.
f170: 73 71 6c 69 74 65 33 50 72 6e 67 52 65 73 65 74 sqlite3PrngReset
f180: 53 74 61 74 65 28 29 3b 0a 20 20 20 20 20 20 62 State();. b
f190: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
f1a0: 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 /*. ** sqli
f1b0: 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
f1c0: 28 42 49 54 56 45 43 5f 54 45 53 54 2c 20 73 69 (BITVEC_TEST, si
f1d0: 7a 65 2c 20 70 72 6f 67 72 61 6d 29 0a 20 20 20 ze, program).
f1e0: 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 75 6e 20 61 **. ** Run a
f1f0: 20 74 65 73 74 20 61 67 61 69 6e 73 74 20 61 20 test against a
f200: 42 69 74 76 65 63 20 6f 62 6a 65 63 74 20 6f 66 Bitvec object of
f210: 20 73 69 7a 65 2e 20 20 54 68 65 20 70 72 6f 67 size. The prog
f220: 72 61 6d 20 61 72 67 75 6d 65 6e 74 0a 20 20 20 ram argument.
f230: 20 2a 2a 20 69 73 20 61 6e 20 61 72 72 61 79 20 ** is an array
f240: 6f 66 20 69 6e 74 65 67 65 72 73 20 74 68 61 74 of integers that
f250: 20 64 65 66 69 6e 65 73 20 74 68 65 20 74 65 73 defines the tes
f260: 74 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 6f 6e t. Return -1 on
f270: 20 61 0a 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 79 a. ** memory
f280: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 65 72 72 6f allocation erro
f290: 72 2c 20 30 20 6f 6e 20 73 75 63 63 65 73 73 2c r, 0 on success,
f2a0: 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f 20 66 6f 72 or non-zero for
f2b0: 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 20 20 2a an error.. *
f2c0: 2a 20 53 65 65 20 74 68 65 20 73 71 6c 69 74 65 * See the sqlite
f2d0: 33 42 69 74 76 65 63 42 75 69 6c 74 69 6e 54 65 3BitvecBuiltinTe
f2e0: 73 74 28 29 20 66 6f 72 20 61 64 64 69 74 69 6f st() for additio
f2f0: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e nal information.
f300: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 . */. case
f310: 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
f320: 5f 42 49 54 56 45 43 5f 54 45 53 54 3a 20 7b 0a _BITVEC_TEST: {.
f330: 20 20 20 20 20 20 69 6e 74 20 73 7a 20 3d 20 76 int sz = v
f340: 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b 0a a_arg(ap, int);.
f350: 20 20 20 20 20 20 69 6e 74 20 2a 61 50 72 6f 67 int *aProg
f360: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
f370: 74 2a 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 t*);. rc =
f380: 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 69 sqlite3BitvecBui
f390: 6c 74 69 6e 54 65 73 74 28 73 7a 2c 20 61 50 72 ltinTest(sz, aPr
f3a0: 6f 67 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b og);. break
f3b0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a ;. }.. /*.
f3c0: 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f ** sqlite3_
f3d0: 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 45 4e test_control(BEN
f3e0: 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 IGN_MALLOC_HOOKS
f3f0: 2c 20 78 42 65 67 69 6e 2c 20 78 45 6e 64 29 0a , xBegin, xEnd).
f400: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 65 **. ** Re
f410: 67 69 73 74 65 72 20 68 6f 6f 6b 73 20 74 6f 20 gister hooks to
f420: 63 61 6c 6c 20 74 6f 20 69 6e 64 69 63 61 74 65 call to indicate
f430: 20 77 68 69 63 68 20 6d 61 6c 6c 6f 63 28 29 20 which malloc()
f440: 66 61 69 6c 75 72 65 73 20 0a 20 20 20 20 2a 2a failures . **
f450: 20 61 72 65 20 62 65 6e 69 67 6e 2e 0a 20 20 20 are benign..
f460: 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
f470: 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 45 4e ITE_TESTCTRL_BEN
f480: 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b 53 IGN_MALLOC_HOOKS
f490: 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 65 : {. typede
f4a0: 66 20 76 6f 69 64 20 28 2a 76 6f 69 64 5f 66 75 f void (*void_fu
f4b0: 6e 63 74 69 6f 6e 29 28 76 6f 69 64 29 3b 0a 20 nction)(void);.
f4c0: 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 69 void_functi
f4d0: 6f 6e 20 78 42 65 6e 69 67 6e 42 65 67 69 6e 3b on xBenignBegin;
f4e0: 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 . void_func
f4f0: 74 69 6f 6e 20 78 42 65 6e 69 67 6e 45 6e 64 3b tion xBenignEnd;
f500: 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e 42 65 . xBenignBe
f510: 67 69 6e 20 3d 20 76 61 5f 61 72 67 28 61 70 2c gin = va_arg(ap,
f520: 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b void_function);
f530: 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e 45 6e . xBenignEn
f540: 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 d = va_arg(ap, v
f550: 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a 20 oid_function);.
f560: 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 6e 69 sqlite3Beni
f570: 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 78 42 gnMallocHooks(xB
f580: 65 6e 69 67 6e 42 65 67 69 6e 2c 20 78 42 65 6e enignBegin, xBen
f590: 69 67 6e 45 6e 64 29 3b 0a 20 20 20 20 20 20 62 ignEnd);. b
f5a0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 reak;. }..
f5b0: 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 /*. ** sqli
f5c0: 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c te3_test_control
f5d0: 28 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 75 (PENDING_BYTE, u
f5e0: 6e 73 69 67 6e 65 64 20 69 6e 74 20 58 29 0a 20 nsigned int X).
f5f0: 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 74 **. ** Set
f600: 20 74 68 65 20 50 45 4e 44 49 4e 47 20 62 79 74 the PENDING byt
f610: 65 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 69 e to the value i
f620: 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2c 20 n the argument,
f630: 69 66 20 58 3e 30 2e 0a 20 20 20 20 2a 2a 20 4d if X>0.. ** M
f640: 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 ake no changes i
f650: 66 20 58 3d 3d 30 2e 20 20 52 65 74 75 72 6e 20 f X==0. Return
f660: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 the value of the
f670: 20 70 65 6e 64 69 6e 67 20 62 79 74 65 0a 20 20 pending byte.
f680: 20 20 2a 2a 20 61 73 20 69 74 20 65 78 69 73 74 ** as it exist
f690: 69 6e 67 20 62 65 66 6f 72 65 20 74 68 69 73 20 ing before this
f6a0: 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c routine was call
f6b0: 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a ed.. **. *
f6c0: 2a 20 49 4d 50 4f 52 54 41 4e 54 3a 20 20 43 68 * IMPORTANT: Ch
f6d0: 61 6e 67 69 6e 67 20 74 68 65 20 50 45 4e 44 49 anging the PENDI
f6e0: 4e 47 20 62 79 74 65 20 66 72 6f 6d 20 30 78 34 NG byte from 0x4
f6f0: 30 30 30 30 30 30 30 20 72 65 73 75 6c 74 73 20 0000000 results
f700: 69 6e 0a 20 20 20 20 2a 2a 20 61 6e 20 69 6e 63 in. ** an inc
f710: 6f 6d 70 61 74 69 62 6c 65 20 64 61 74 61 62 61 ompatible databa
f720: 73 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 se file format.
f730: 20 43 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 Changing the PE
f740: 4e 44 49 4e 47 20 62 79 74 65 0a 20 20 20 20 2a NDING byte. *
f750: 2a 20 77 68 69 6c 65 20 61 6e 79 20 64 61 74 61 * while any data
f760: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
f770: 69 73 20 6f 70 65 6e 20 72 65 73 75 6c 74 73 20 is open results
f780: 69 6e 20 75 6e 64 65 66 69 6e 65 64 20 61 6e 64 in undefined and
f790: 0a 20 20 20 20 2a 2a 20 64 69 6c 65 74 65 72 69 . ** dileteri
f7a0: 6f 75 73 20 62 65 68 61 76 69 6f 72 2e 0a 20 20 ous behavior..
f7b0: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
f7c0: 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 45 LITE_TESTCTRL_PE
f7d0: 4e 44 49 4e 47 5f 42 59 54 45 3a 20 7b 0a 20 20 NDING_BYTE: {.
f7e0: 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 unsigned int
f7f0: 20 6e 65 77 56 61 6c 20 3d 20 76 61 5f 61 72 67 newVal = va_arg
f800: 28 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 6e (ap, unsigned in
f810: 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 t);. rc = s
f820: 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 42 79 74 qlite3PendingByt
f830: 65 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 65 77 e;. if( new
f840: 56 61 6c 20 29 20 73 71 6c 69 74 65 33 50 65 6e Val ) sqlite3Pen
f850: 64 69 6e 67 42 79 74 65 20 3d 20 6e 65 77 56 61 dingByte = newVa
f860: 6c 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a l;. break;.
f870: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 }. }. va_e
f880: 6e 64 28 61 70 29 3b 0a 23 65 6e 64 69 66 20 2f nd(ap);.#endif /
f890: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 * SQLITE_OMIT_BU
f8a0: 49 4c 54 49 4e 5f 54 45 53 54 20 2a 2f 0a 20 20 ILTIN_TEST */.
f8b0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a return rc;.}.