0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66 ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69 ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65 te library. The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69 routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 er interface to
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f the library. Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68 utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72 er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79 internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75 SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63 ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a f the library..*
0260: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 /.#include "sqli
0270: 74 65 49 6e 74 2e 68 22 0a 0a 23 69 66 64 65 66 teInt.h"..#ifdef
0280: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
0290: 54 53 33 0a 23 20 69 6e 63 6c 75 64 65 20 22 66 TS3.# include "f
02a0: 74 73 33 2e 68 22 0a 23 65 6e 64 69 66 0a 23 69 ts3.h".#endif.#i
02b0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
02c0: 4c 45 5f 52 54 52 45 45 0a 23 20 69 6e 63 6c 75 LE_RTREE.# inclu
02d0: 64 65 20 22 72 74 72 65 65 2e 68 22 0a 23 65 6e de "rtree.h".#en
02e0: 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
02f0: 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 23 20 69 E_ENABLE_ICU.# i
0300: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 69 63 nclude "sqliteic
0310: 75 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a u.h".#endif../*.
0320: 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f ** The version o
0330: 66 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2f f the library.*/
0340: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
0350: 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 63 6f 6e AMALGAMATION.con
0360: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 33 5f st char sqlite3_
0370: 76 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 version[] = SQLI
0380: 54 45 5f 56 45 52 53 49 4f 4e 3b 0a 23 65 6e 64 TE_VERSION;.#end
0390: 69 66 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 if.const char *s
03a0: 71 6c 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f qlite3_libversio
03b0: 6e 28 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 n(void){ return
03c0: 73 71 6c 69 74 65 33 5f 76 65 72 73 69 6f 6e 3b sqlite3_version;
03d0: 20 7d 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 }.const char *s
03e0: 71 6c 69 74 65 33 5f 73 6f 75 72 63 65 69 64 28 qlite3_sourceid(
03f0: 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 void){ return SQ
0400: 4c 49 54 45 5f 53 4f 55 52 43 45 5f 49 44 3b 20 LITE_SOURCE_ID;
0410: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 69 }.int sqlite3_li
0420: 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 bversion_number(
0430: 76 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 void){ return SQ
0440: 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d LITE_VERSION_NUM
0450: 42 45 52 3b 20 7d 0a 69 6e 74 20 73 71 6c 69 74 BER; }.int sqlit
0460: 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 76 6f e3_threadsafe(vo
0470: 69 64 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 id){ return SQLI
0480: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3b 20 7d TE_THREADSAFE; }
0490: 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 ..#if !defined(S
04a0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 QLITE_OMIT_TRACE
04b0: 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c ) && defined(SQL
04c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 ITE_ENABLE_IOTRA
04d0: 43 45 29 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 CE)./*.** If the
04e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 following funct
04f0: 69 6f 6e 20 70 6f 69 6e 74 65 72 20 69 73 20 6e ion pointer is n
0500: 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 69 66 0a 2a ot NULL and if.*
0510: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f * SQLITE_ENABLE_
0520: 49 4f 54 52 41 43 45 20 69 73 20 65 6e 61 62 6c IOTRACE is enabl
0530: 65 64 2c 20 74 68 65 6e 20 6d 65 73 73 61 67 65 ed, then message
0540: 73 20 64 65 73 63 72 69 62 69 6e 67 0a 2a 2a 20 s describing.**
0550: 49 2f 4f 20 61 63 74 69 76 65 20 61 72 65 20 77 I/O active are w
0560: 72 69 74 74 65 6e 20 75 73 69 6e 67 20 74 68 69 ritten using thi
0570: 73 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 s function. The
0580: 73 65 20 6d 65 73 73 61 67 65 73 0a 2a 2a 20 61 se messages.** a
0590: 72 65 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 re intended for
05a0: 64 65 62 75 67 67 69 6e 67 20 61 63 74 69 76 69 debugging activi
05b0: 74 79 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 64 ty only..*/.void
05c0: 20 28 2a 73 71 6c 69 74 65 33 49 6f 54 72 61 63 (*sqlite3IoTrac
05d0: 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 e)(const char*,
05e0: 2e 2e 2e 29 20 3d 20 30 3b 0a 23 65 6e 64 69 66 ...) = 0;.#endif
05f0: 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 ../*.** If the f
0600: 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 ollowing global
0610: 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 variable points
0620: 74 6f 20 61 20 73 74 72 69 6e 67 20 77 68 69 63 to a string whic
0630: 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d 65 h is the.** name
0640: 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 2c of a directory,
0650: 20 74 68 65 6e 20 74 68 61 74 20 64 69 72 65 63 then that direc
0660: 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 73 65 tory will be use
0670: 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 65 d to store.** te
0680: 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a 2a mporary files..*
0690: 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 68 *.** See also th
06a0: 65 20 22 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 e "PRAGMA temp_s
06b0: 74 6f 72 65 5f 64 69 72 65 63 74 6f 72 79 22 20 tore_directory"
06c0: 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2f 0a SQL command..*/.
06d0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 65 char *sqlite3_te
06e0: 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30 mp_directory = 0
06f0: 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c ;../*.** Initial
0700: 69 7a 65 20 53 51 4c 69 74 65 2e 20 20 0a 2a 2a ize SQLite. .**
0710: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
0720: 20 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 must be called
0730: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 to initialize th
0740: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 e memory allocat
0750: 69 6f 6e 2c 0a 2a 2a 20 56 46 53 2c 20 61 6e 64 ion,.** VFS, and
0760: 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 6d mutex subsystem
0770: 73 20 70 72 69 6f 72 20 74 6f 20 64 6f 69 6e 67 s prior to doing
0780: 20 61 6e 79 20 73 65 72 69 6f 75 73 20 77 6f 72 any serious wor
0790: 6b 20 77 69 74 68 0a 2a 2a 20 53 51 4c 69 74 65 k with.** SQLite
07a0: 2e 20 20 42 75 74 20 61 73 20 6c 6f 6e 67 20 61 . But as long a
07b0: 73 20 79 6f 75 20 64 6f 20 6e 6f 74 20 63 6f 6d s you do not com
07c0: 70 69 6c 65 20 77 69 74 68 20 53 51 4c 49 54 45 pile with SQLITE
07d0: 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 2a _OMIT_AUTOINIT.*
07e0: 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 * this routine w
07f0: 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 61 75 ill be called au
0800: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 6b tomatically by k
0810: 65 79 20 72 6f 75 74 69 6e 65 73 20 73 75 63 68 ey routines such
0820: 20 61 73 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f as.** sqlite3_o
0830: 70 65 6e 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 pen(). .**.** T
0840: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 his routine is a
0850: 20 6e 6f 2d 6f 70 20 65 78 63 65 70 74 20 6f 6e no-op except on
0860: 20 69 74 73 20 76 65 72 79 20 66 69 72 73 74 20 its very first
0870: 63 61 6c 6c 20 66 6f 72 20 74 68 65 20 70 72 6f call for the pro
0880: 63 65 73 73 2c 0a 2a 2a 20 6f 72 20 66 6f 72 20 cess,.** or for
0890: 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20 61 the first call a
08a0: 66 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73 fter a call to s
08b0: 71 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 6e 2e qlite3_shutdown.
08c0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 .**.** The first
08d0: 20 74 68 72 65 61 64 20 74 6f 20 63 61 6c 6c 20 thread to call
08e0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 75 6e this routine run
08f0: 73 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 s the initializa
0900: 74 69 6f 6e 20 74 6f 0a 2a 2a 20 63 6f 6d 70 6c tion to.** compl
0910: 65 74 69 6f 6e 2e 20 20 49 66 20 73 75 62 73 65 etion. If subse
0920: 71 75 65 6e 74 20 74 68 72 65 61 64 73 20 63 61 quent threads ca
0930: 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ll this routine
0940: 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 before the first
0950: 0a 2a 2a 20 74 68 72 65 61 64 20 68 61 73 20 66 .** thread has f
0960: 69 6e 69 73 68 65 64 20 74 68 65 20 69 6e 69 74 inished the init
0970: 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f 63 65 ialization proce
0980: 73 73 2c 20 74 68 65 6e 20 74 68 65 20 73 75 62 ss, then the sub
0990: 73 65 71 75 65 6e 74 0a 2a 2a 20 74 68 72 65 61 sequent.** threa
09a0: 64 73 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e ds must block un
09b0: 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 74 68 til the first th
09c0: 72 65 61 64 20 66 69 6e 69 73 68 65 73 20 77 69 read finishes wi
09d0: 74 68 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a th the initializ
09e0: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ation..**.** The
09f0: 20 66 69 72 73 74 20 74 68 72 65 61 64 20 6d 69 first thread mi
0a00: 67 68 74 20 63 61 6c 6c 20 74 68 69 73 20 72 6f ght call this ro
0a10: 75 74 69 6e 65 20 72 65 63 75 72 73 69 76 65 6c utine recursivel
0a20: 79 2e 20 20 52 65 63 75 72 73 69 76 65 0a 2a 2a y. Recursive.**
0a30: 20 63 61 6c 6c 73 20 74 6f 20 74 68 69 73 20 72 calls to this r
0a40: 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6e 6f outine should no
0a50: 74 20 62 6c 6f 63 6b 2c 20 6f 66 20 63 6f 75 72 t block, of cour
0a60: 73 65 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 se. Otherwise t
0a70: 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 61 he.** initializa
0a80: 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 77 6f 75 tion process wou
0a90: 6c 64 20 6e 65 76 65 72 20 63 6f 6d 70 6c 65 74 ld never complet
0aa0: 65 2e 0a 2a 2a 0a 2a 2a 20 4c 65 74 20 58 20 62 e..**.** Let X b
0ab0: 65 20 74 68 65 20 66 69 72 73 74 20 74 68 72 65 e the first thre
0ac0: 61 64 20 74 6f 20 65 6e 74 65 72 20 74 68 69 73 ad to enter this
0ad0: 20 72 6f 75 74 69 6e 65 2e 20 20 4c 65 74 20 59 routine. Let Y
0ae0: 20 62 65 20 73 6f 6d 65 20 6f 74 68 65 72 0a 2a be some other.*
0af0: 2a 20 74 68 72 65 61 64 2e 20 20 54 68 65 6e 20 * thread. Then
0b00: 77 68 69 6c 65 20 74 68 65 20 69 6e 69 74 69 61 while the initia
0b10: 6c 20 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 20 l invocation of
0b20: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 62 79 20 this routine by
0b30: 58 20 69 73 0a 2a 2a 20 69 6e 63 6f 6d 70 6c 65 X is.** incomple
0b40: 74 65 2c 20 69 74 20 69 73 20 72 65 71 75 69 72 te, it is requir
0b50: 65 64 20 74 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 20 ed that:.**.**
0b60: 20 20 2a 20 20 43 61 6c 6c 73 20 74 6f 20 74 68 * Calls to th
0b70: 69 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 is routine from
0b80: 59 20 6d 75 73 74 20 62 6c 6f 63 6b 20 75 6e 74 Y must block unt
0b90: 69 6c 20 74 68 65 20 6f 75 74 65 72 2d 6d 6f 73 il the outer-mos
0ba0: 74 0a 2a 2a 20 20 20 20 20 20 20 63 61 6c 6c 20 t.** call
0bb0: 62 79 20 58 20 63 6f 6d 70 6c 65 74 65 73 2e 0a by X completes..
0bc0: 2a 2a 0a 2a 2a 20 20 20 20 2a 20 20 52 65 63 75 **.** * Recu
0bd0: 72 73 69 76 65 20 63 61 6c 6c 73 20 74 6f 20 74 rsive calls to t
0be0: 68 69 73 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d his routine from
0bf0: 20 74 68 72 65 61 64 20 58 20 72 65 74 75 72 6e thread X return
0c00: 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a 20 immediately.**
0c10: 20 20 20 20 20 20 77 69 74 68 6f 75 74 20 62 6c without bl
0c20: 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 ocking..*/.int s
0c30: 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a qlite3_initializ
0c40: 65 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 74 e(void){. sqlit
0c50: 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 73 74 65 e3_mutex *pMaste
0c60: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
0c70: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d /* The m
0c80: 61 69 6e 20 73 74 61 74 69 63 20 6d 75 74 65 78 ain static mutex
0c90: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 */. 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 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 /* Result cod
0cd0: 65 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c e */..#ifdef SQL
0ce0: 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 72 ITE_OMIT_WSD. r
0cf0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 77 73 64 5f c = sqlite3_wsd_
0d00: 69 6e 69 74 28 34 30 39 36 2c 20 32 34 29 3b 0a init(4096, 24);.
0d10: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
0d20: 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 _OK ){. retur
0d30: 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 n rc;. }.#endif
0d40: 0a 0a 20 20 2f 2a 20 49 66 20 53 51 4c 69 74 65 .. /* If SQLite
0d50: 20 69 73 20 61 6c 72 65 61 64 79 20 63 6f 6d 70 is already comp
0d60: 6c 65 74 65 6c 79 20 69 6e 69 74 69 61 6c 69 7a letely initializ
0d70: 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 63 61 ed, then this ca
0d80: 6c 6c 0a 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 ll. ** to sqlit
0d90: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 e3_initialize()
0da0: 73 68 6f 75 6c 64 20 62 65 20 61 20 6e 6f 2d 6f should be a no-o
0db0: 70 2e 20 20 42 75 74 20 74 68 65 20 69 6e 69 74 p. But the init
0dc0: 69 61 6c 69 7a 61 74 69 6f 6e 0a 20 20 2a 2a 20 ialization. **
0dd0: 6d 75 73 74 20 62 65 20 63 6f 6d 70 6c 65 74 65 must be complete
0de0: 2e 20 20 53 6f 20 69 73 49 6e 69 74 20 6d 75 73 . So isInit mus
0df0: 74 20 6e 6f 74 20 62 65 20 73 65 74 20 75 6e 74 t not be set unt
0e00: 69 6c 20 74 68 65 20 76 65 72 79 20 65 6e 64 0a il the very end.
0e10: 20 20 2a 2a 20 6f 66 20 74 68 69 73 20 72 6f 75 ** of this rou
0e20: 74 69 6e 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 tine.. */. if(
0e30: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
0e40: 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 65 nfig.isInit ) re
0e50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
0e60: 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 . /* Make sure
0e70: 74 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 the mutex subsys
0e80: 74 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 7a tem is initializ
0e90: 65 64 2e 20 20 49 66 20 75 6e 61 62 6c 65 20 74 ed. If unable t
0ea0: 6f 20 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 o . ** initiali
0eb0: 7a 65 20 74 68 65 20 6d 75 74 65 78 20 73 75 62 ze the mutex sub
0ec0: 73 79 73 74 65 6d 2c 20 72 65 74 75 72 6e 20 65 system, return e
0ed0: 61 72 6c 79 20 77 69 74 68 20 74 68 65 20 65 72 arly with the er
0ee0: 72 6f 72 2e 0a 20 20 2a 2a 20 49 66 20 74 68 65 ror.. ** If the
0ef0: 20 73 79 73 74 65 6d 20 69 73 20 73 6f 20 73 69 system is so si
0f00: 63 6b 20 74 68 61 74 20 77 65 20 61 72 65 20 75 ck that we are u
0f10: 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 nable to allocat
0f20: 65 20 61 20 6d 75 74 65 78 2c 0a 20 20 2a 2a 20 e a mutex,. **
0f30: 74 68 65 72 65 20 69 73 20 6e 6f 74 20 6d 75 63 there is not muc
0f40: 68 20 53 51 4c 69 74 65 20 69 73 20 67 6f 69 6e h SQLite is goin
0f50: 67 20 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 g to be able to
0f60: 64 6f 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 do.. **. ** Th
0f70: 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 74 65 e mutex subsyste
0f80: 6d 20 6d 75 73 74 20 74 61 6b 65 20 63 61 72 65 m must take care
0f90: 20 6f 66 20 73 65 72 69 61 6c 69 7a 69 6e 67 20 of serializing
0fa0: 69 74 73 20 6f 77 6e 0a 20 20 2a 2a 20 69 6e 69 its own. ** ini
0fb0: 74 69 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 2a tialization.. *
0fc0: 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 /. rc = sqlite3
0fd0: 4d 75 74 65 78 49 6e 69 74 28 29 3b 0a 20 20 69 MutexInit();. i
0fe0: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
0ff0: 63 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c c;.. /* Initial
1000: 69 7a 65 20 74 68 65 20 6d 61 6c 6c 6f 63 28 29 ize the malloc()
1010: 20 73 79 73 74 65 6d 20 61 6e 64 20 74 68 65 20 system and the
1020: 72 65 63 75 72 73 69 76 65 20 70 49 6e 69 74 4d recursive pInitM
1030: 75 74 65 78 20 6d 75 74 65 78 2e 0a 20 20 2a 2a utex mutex.. **
1040: 20 54 68 69 73 20 6f 70 65 72 61 74 69 6f 6e 20 This operation
1050: 69 73 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 is protected by
1060: 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 45 the STATIC_MASTE
1070: 52 20 6d 75 74 65 78 2e 20 20 4e 6f 74 65 20 74 R mutex. Note t
1080: 68 61 74 0a 20 20 2a 2a 20 4d 75 74 65 78 41 6c hat. ** MutexAl
1090: 6c 6f 63 28 29 20 69 73 20 63 61 6c 6c 65 64 20 loc() is called
10a0: 66 6f 72 20 61 20 73 74 61 74 69 63 20 6d 75 74 for a static mut
10b0: 65 78 20 70 72 69 6f 72 20 74 6f 20 69 6e 69 74 ex prior to init
10c0: 69 61 6c 69 7a 69 6e 67 20 74 68 65 0a 20 20 2a ializing the. *
10d0: 2a 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 * malloc subsyst
10e0: 65 6d 20 2d 20 74 68 69 73 20 69 6d 70 6c 69 65 em - this implie
10f0: 73 20 74 68 61 74 20 74 68 65 20 61 6c 6c 6f 63 s that the alloc
1100: 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 69 ation of a stati
1110: 63 0a 20 20 2a 2a 20 6d 75 74 65 78 20 6d 75 73 c. ** mutex mus
1120: 74 20 6e 6f 74 20 72 65 71 75 69 72 65 20 73 75 t not require su
1130: 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20 6d pport from the m
1140: 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 2e alloc subsystem.
1150: 0a 20 20 2a 2f 0a 20 20 70 4d 61 73 74 65 72 20 . */. pMaster
1160: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
1170: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
1180: 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b _STATIC_MASTER);
1190: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
11a0: 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 29 3b _enter(pMaster);
11b0: 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c . sqlite3Global
11c0: 43 6f 6e 66 69 67 2e 69 73 4d 75 74 65 78 49 6e Config.isMutexIn
11d0: 69 74 20 3d 20 31 3b 0a 20 20 69 66 28 20 21 73 it = 1;. if( !s
11e0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
11f0: 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 20 ig.isMallocInit
1200: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
1210: 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 29 3b te3MallocInit();
1220: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
1230: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1240: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1250: 66 69 67 2e 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 fig.isMallocInit
1260: 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 21 73 = 1;. if( !s
1270: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1280: 69 67 2e 70 49 6e 69 74 4d 75 74 65 78 20 29 7b ig.pInitMutex ){
1290: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
12a0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
12b0: 4d 75 74 65 78 20 3d 0a 20 20 20 20 20 20 20 20 Mutex =.
12c0: 20 20 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 sqlite3MutexA
12d0: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
12e0: 58 5f 52 45 43 55 52 53 49 56 45 29 3b 0a 20 20 X_RECURSIVE);.
12f0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 if( sqlite3G
1300: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 lobalConfig.bCor
1310: 65 4d 75 74 65 78 20 26 26 20 21 73 71 6c 69 74 eMutex && !sqlit
1320: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
1330: 49 6e 69 74 4d 75 74 65 78 20 29 7b 0a 20 20 20 InitMutex ){.
1340: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1350: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a _NOMEM;. }.
1360: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
1370: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1380: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 . sqlite3Glob
1390: 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 alConfig.nRefIni
13a0: 74 4d 75 74 65 78 2b 2b 3b 0a 20 20 7d 0a 20 20 tMutex++;. }.
13b0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
13c0: 61 76 65 28 70 4d 61 73 74 65 72 29 3b 0a 0a 20 ave(pMaster);..
13d0: 20 2f 2a 20 49 66 20 72 63 20 69 73 20 6e 6f 74 /* If rc is not
13e0: 20 53 51 4c 49 54 45 5f 4f 4b 20 61 74 20 74 68 SQLITE_OK at th
13f0: 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 65 is point, then e
1400: 69 74 68 65 72 20 74 68 65 20 6d 61 6c 6c 6f 63 ither the malloc
1410: 0a 20 20 2a 2a 20 73 75 62 73 79 73 74 65 6d 20 . ** subsystem
1420: 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 69 6e 69 could not be ini
1430: 74 69 61 6c 69 7a 65 64 20 6f 72 20 74 68 65 20 tialized or the
1440: 73 79 73 74 65 6d 20 66 61 69 6c 65 64 20 74 6f system failed to
1450: 20 61 6c 6c 6f 63 61 74 65 0a 20 20 2a 2a 20 74 allocate. ** t
1460: 68 65 20 70 49 6e 69 74 4d 75 74 65 78 20 6d 75 he pInitMutex mu
1470: 74 65 78 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 tex. Return an e
1480: 72 72 6f 72 20 69 6e 20 65 69 74 68 65 72 20 63 rror in either c
1490: 61 73 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 72 ase. */. if( r
14a0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
14b0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
14c0: 20 7d 0a 0a 20 20 2f 2a 20 44 6f 20 74 68 65 20 }.. /* Do the
14d0: 72 65 73 74 20 6f 66 20 74 68 65 20 69 6e 69 74 rest of the init
14e0: 69 61 6c 69 7a 61 74 69 6f 6e 20 75 6e 64 65 72 ialization under
14f0: 20 74 68 65 20 72 65 63 75 72 73 69 76 65 20 6d the recursive m
1500: 75 74 65 78 20 73 6f 0a 20 20 2a 2a 20 74 68 61 utex so. ** tha
1510: 74 20 77 65 20 77 69 6c 6c 20 62 65 20 61 62 6c t we will be abl
1520: 65 20 74 6f 20 68 61 6e 64 6c 65 20 72 65 63 75 e to handle recu
1530: 72 73 69 76 65 20 63 61 6c 6c 73 20 69 6e 74 6f rsive calls into
1540: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6e . ** sqlite3_in
1550: 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 54 68 65 itialize(). The
1560: 20 72 65 63 75 72 73 69 76 65 20 63 61 6c 6c 73 recursive calls
1570: 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6d 65 20 74 normally come t
1580: 68 72 6f 75 67 68 0a 20 20 2a 2a 20 73 71 6c 69 hrough. ** sqli
1590: 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29 20 77 68 te3_os_init() wh
15a0: 65 6e 20 69 74 20 69 6e 76 6f 6b 65 73 20 73 71 en it invokes sq
15b0: 6c 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 lite3_vfs_regist
15c0: 65 72 28 29 2c 20 62 75 74 20 6f 74 68 65 72 0a er(), but other.
15d0: 20 20 2a 2a 20 72 65 63 75 72 73 69 76 65 20 63 ** recursive c
15e0: 61 6c 6c 73 20 6d 69 67 68 74 20 61 6c 73 6f 20 alls might also
15f0: 62 65 20 70 6f 73 73 69 62 6c 65 2e 0a 20 20 2a be possible.. *
1600: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 /. sqlite3_mute
1610: 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 47 x_enter(sqlite3G
1620: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 lobalConfig.pIni
1630: 74 4d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 73 tMutex);. if( s
1640: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
1650: 69 67 2e 69 73 49 6e 69 74 3d 3d 30 20 26 26 20 ig.isInit==0 &&
1660: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
1670: 66 69 67 2e 69 6e 50 72 6f 67 72 65 73 73 3d 3d fig.inProgress==
1680: 30 20 29 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 0 ){. FuncDef
1690: 48 61 73 68 20 2a 70 48 61 73 68 20 3d 20 26 47 Hash *pHash = &G
16a0: 4c 4f 42 41 4c 28 46 75 6e 63 44 65 66 48 61 73 LOBAL(FuncDefHas
16b0: 68 2c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c h, sqlite3Global
16c0: 46 75 6e 63 74 69 6f 6e 73 29 3b 0a 20 20 20 20 Functions);.
16d0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
16e0: 66 69 67 2e 69 6e 50 72 6f 67 72 65 73 73 20 3d fig.inProgress =
16f0: 20 31 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 1;. memset(p
1700: 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28 Hash, 0, sizeof(
1710: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e sqlite3GlobalFun
1720: 63 74 69 6f 6e 73 29 29 3b 0a 20 20 20 20 73 71 ctions));. sq
1730: 6c 69 74 65 33 52 65 67 69 73 74 65 72 47 6c 6f lite3RegisterGlo
1740: 62 61 6c 46 75 6e 63 74 69 6f 6e 73 28 29 3b 0a balFunctions();.
1750: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 if( sqlite3G
1760: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 43 lobalConfig.isPC
1770: 61 63 68 65 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 acheInit==0 ){.
1780: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
1790: 33 50 63 61 63 68 65 49 6e 69 74 69 61 6c 69 7a 3PcacheInitializ
17a0: 65 28 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 e();. }. i
17b0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
17c0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
17d0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
17e0: 50 43 61 63 68 65 49 6e 69 74 20 3d 20 31 3b 0a PCacheInit = 1;.
17f0: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
1800: 65 33 4f 73 49 6e 69 74 28 29 3b 0a 20 20 20 20 e3OsInit();.
1810: 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
1820: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1830: 20 73 71 6c 69 74 65 33 50 43 61 63 68 65 42 75 sqlite3PCacheBu
1840: 66 66 65 72 53 65 74 75 70 28 20 73 71 6c 69 74 fferSetup( sqlit
1850: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 e3GlobalConfig.p
1860: 50 61 67 65 2c 20 0a 20 20 20 20 20 20 20 20 20 Page, .
1870: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1880: 6e 66 69 67 2e 73 7a 50 61 67 65 2c 20 73 71 6c nfig.szPage, sql
1890: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
18a0: 2e 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 73 .nPage);. s
18b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
18c0: 69 67 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 ig.isInit = 1;.
18d0: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
18e0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 6e 50 GlobalConfig.inP
18f0: 72 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 7d rogress = 0;. }
1900: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1910: 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 47 6c _leave(sqlite3Gl
1920: 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 obalConfig.pInit
1930: 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 47 6f Mutex);.. /* Go
1940: 20 62 61 63 6b 20 75 6e 64 65 72 20 74 68 65 20 back under the
1950: 73 74 61 74 69 63 20 6d 75 74 65 78 20 61 6e 64 static mutex and
1960: 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20 72 65 clean up the re
1970: 63 75 72 73 69 76 65 0a 20 20 2a 2a 20 6d 75 74 cursive. ** mut
1980: 65 78 20 74 6f 20 70 72 65 76 65 6e 74 20 61 20 ex to prevent a
1990: 72 65 73 6f 75 72 63 65 20 6c 65 61 6b 2e 0a 20 resource leak..
19a0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 */. sqlite3_mu
19b0: 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 tex_enter(pMaste
19c0: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f r);. sqlite3Glo
19d0: 62 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e balConfig.nRefIn
19e0: 69 74 4d 75 74 65 78 2d 2d 3b 0a 20 20 69 66 28 itMutex--;. if(
19f0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
1a00: 6e 66 69 67 2e 6e 52 65 66 49 6e 69 74 4d 75 74 nfig.nRefInitMut
1a10: 65 78 3c 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 ex<=0 ){. ass
1a20: 65 72 74 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 ert( sqlite3Glob
1a30: 61 6c 43 6f 6e 66 69 67 2e 6e 52 65 66 49 6e 69 alConfig.nRefIni
1a40: 74 4d 75 74 65 78 3d 3d 30 20 29 3b 0a 20 20 20 tMutex==0 );.
1a50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 sqlite3_mutex_f
1a60: 72 65 65 28 73 71 6c 69 74 65 33 47 6c 6f 62 61 ree(sqlite3Globa
1a70: 6c 43 6f 6e 66 69 67 2e 70 49 6e 69 74 4d 75 74 lConfig.pInitMut
1a80: 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ex);. sqlite3
1a90: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 49 6e GlobalConfig.pIn
1aa0: 69 74 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 7d itMutex = 0;. }
1ab0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1ac0: 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 72 29 3b _leave(pMaster);
1ad0: 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f .. /* The follo
1ae0: 77 69 6e 67 20 69 73 20 6a 75 73 74 20 61 20 73 wing is just a s
1af0: 61 6e 69 74 79 20 63 68 65 63 6b 20 74 6f 20 6d anity check to m
1b00: 61 6b 65 20 73 75 72 65 20 53 51 4c 69 74 65 20 ake sure SQLite
1b10: 68 61 73 0a 20 20 2a 2a 20 62 65 65 6e 20 63 6f has. ** been co
1b20: 6d 70 69 6c 65 64 20 63 6f 72 72 65 63 74 6c 79 mpiled correctly
1b30: 2e 20 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 . It is importa
1b40: 6e 74 20 74 6f 20 72 75 6e 20 74 68 69 73 20 63 nt to run this c
1b50: 6f 64 65 2c 20 62 75 74 0a 20 20 2a 2a 20 77 65 ode, but. ** we
1b60: 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 6f 20 72 don't want to r
1b70: 75 6e 20 69 74 20 74 6f 6f 20 6f 66 74 65 6e 20 un it too often
1b80: 61 6e 64 20 73 6f 61 6b 20 75 70 20 43 50 55 20 and soak up CPU
1b90: 63 79 63 6c 65 73 20 66 6f 72 20 6e 6f 0a 20 20 cycles for no.
1ba0: 2a 2a 20 72 65 61 73 6f 6e 2e 20 20 53 6f 20 77 ** reason. So w
1bb0: 65 20 72 75 6e 20 69 74 20 6f 6e 63 65 20 64 75 e run it once du
1bc0: 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 ring initializat
1bd0: 69 6f 6e 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 ion.. */.#ifnde
1be0: 66 20 4e 44 45 42 55 47 0a 23 69 66 6e 64 65 66 f NDEBUG.#ifndef
1bf0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f SQLITE_OMIT_FLO
1c00: 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 2f 2a ATING_POINT. /*
1c10: 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 6f 66 This section of
1c20: 20 63 6f 64 65 27 73 20 6f 6e 6c 79 20 22 6f 75 code's only "ou
1c30: 74 70 75 74 22 20 69 73 20 76 69 61 20 61 73 73 tput" is via ass
1c40: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
1c50: 2e 20 2a 2f 0a 20 20 69 66 20 28 20 72 63 3d 3d . */. if ( rc==
1c60: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1c70: 20 75 36 34 20 78 20 3d 20 28 28 28 75 36 34 29 u64 x = (((u64)
1c80: 31 29 3c 3c 36 33 29 2d 31 3b 0a 20 20 20 20 64 1)<<63)-1;. d
1c90: 6f 75 62 6c 65 20 79 3b 0a 20 20 20 20 61 73 73 ouble y;. ass
1ca0: 65 72 74 28 73 69 7a 65 6f 66 28 78 29 3d 3d 38 ert(sizeof(x)==8
1cb0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 73 69 );. assert(si
1cc0: 7a 65 6f 66 28 78 29 3d 3d 73 69 7a 65 6f 66 28 zeof(x)==sizeof(
1cd0: 79 29 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 y));. memcpy(
1ce0: 26 79 2c 20 26 78 2c 20 38 29 3b 0a 20 20 20 20 &y, &x, 8);.
1cf0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 49 assert( sqlite3I
1d00: 73 4e 61 4e 28 79 29 20 29 3b 0a 20 20 7d 0a 23 sNaN(y) );. }.#
1d10: 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 20 20 endif.#endif..
1d20: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1d30: 0a 2a 2a 20 55 6e 64 6f 20 74 68 65 20 65 66 66 .** Undo the eff
1d40: 65 63 74 73 20 6f 66 20 73 71 6c 69 74 65 33 5f ects of sqlite3_
1d50: 69 6e 69 74 69 61 6c 69 7a 65 28 29 2e 20 20 4d initialize(). M
1d60: 75 73 74 20 6e 6f 74 20 62 65 20 63 61 6c 6c 65 ust not be calle
1d70: 64 20 77 68 69 6c 65 0a 2a 2a 20 74 68 65 72 65 d while.** there
1d80: 20 61 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 are outstanding
1d90: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
1da0: 74 69 6f 6e 73 20 6f 72 20 6d 65 6d 6f 72 79 20 tions or memory
1db0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 6f 72 0a 2a allocations or.*
1dc0: 2a 20 77 68 69 6c 65 20 61 6e 79 20 70 61 72 74 * while any part
1dd0: 20 6f 66 20 53 51 4c 69 74 65 20 69 73 20 6f 74 of SQLite is ot
1de0: 68 65 72 77 69 73 65 20 69 6e 20 75 73 65 20 69 herwise in use i
1df0: 6e 20 61 6e 79 20 74 68 72 65 61 64 2e 20 20 54 n any thread. T
1e00: 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 69 his.** routine i
1e10: 73 20 6e 6f 74 20 74 68 72 65 61 64 73 61 66 65 s not threadsafe
1e20: 2e 20 20 42 75 74 20 69 74 20 69 73 20 73 61 66 . But it is saf
1e30: 65 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 69 73 e to invoke this
1e40: 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 6f 6e 20 77 routine.** on w
1e50: 68 65 6e 20 53 51 4c 69 74 65 20 69 73 20 61 6c hen SQLite is al
1e60: 72 65 61 64 79 20 73 68 75 74 20 64 6f 77 6e 2e ready shut down.
1e70: 20 20 49 66 20 53 51 4c 69 74 65 20 69 73 20 61 If SQLite is a
1e80: 6c 72 65 61 64 79 20 73 68 75 74 20 64 6f 77 6e lready shut down
1e90: 0a 2a 2a 20 77 68 65 6e 20 74 68 69 73 20 72 6f .** when this ro
1ea0: 75 74 69 6e 65 20 69 73 20 69 6e 76 6f 6b 65 64 utine is invoked
1eb0: 2c 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 , then this rout
1ec0: 69 6e 65 20 69 73 20 61 20 68 61 72 6d 6c 65 73 ine is a harmles
1ed0: 73 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 s no-op..*/.int
1ee0: 73 71 6c 69 74 65 33 5f 73 68 75 74 64 6f 77 6e sqlite3_shutdown
1ef0: 28 76 6f 69 64 29 7b 0a 20 20 69 66 28 20 73 71 (void){. if( sq
1f00: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
1f10: 67 2e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20 g.isInit ){.
1f20: 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 28 29 sqlite3_os_end()
1f30: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 ;. sqlite3_re
1f40: 73 65 74 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 set_auto_extensi
1f50: 6f 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 on();. sqlite
1f60: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 3GlobalConfig.is
1f70: 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Init = 0;. }.
1f80: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
1f90: 6c 43 6f 6e 66 69 67 2e 69 73 50 43 61 63 68 65 lConfig.isPCache
1fa0: 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 Init ){. sqli
1fb0: 74 65 33 50 63 61 63 68 65 53 68 75 74 64 6f 77 te3PcacheShutdow
1fc0: 6e 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 n();. sqlite3
1fd0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 50 GlobalConfig.isP
1fe0: 43 61 63 68 65 49 6e 69 74 20 3d 20 30 3b 0a 20 CacheInit = 0;.
1ff0: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 }. if( sqlite3
2000: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
2010: 61 6c 6c 6f 63 49 6e 69 74 20 29 7b 0a 20 20 20 allocInit ){.
2020: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 45 6e sqlite3MallocEn
2030: 64 28 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 d();. sqlite3
2040: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
2050: 61 6c 6c 6f 63 49 6e 69 74 20 3d 20 30 3b 0a 20 allocInit = 0;.
2060: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 }. if( sqlite3
2070: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d GlobalConfig.isM
2080: 75 74 65 78 49 6e 69 74 20 29 7b 0a 20 20 20 20 utexInit ){.
2090: 73 71 6c 69 74 65 33 4d 75 74 65 78 45 6e 64 28 sqlite3MutexEnd(
20a0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c );. sqlite3Gl
20b0: 6f 62 61 6c 43 6f 6e 66 69 67 2e 69 73 4d 75 74 obalConfig.isMut
20c0: 65 78 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a exInit = 0;. }.
20d0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
20e0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 _OK;.}../*.** Th
20f0: 69 73 20 41 50 49 20 61 6c 6c 6f 77 73 20 61 70 is API allows ap
2100: 70 6c 69 63 61 74 69 6f 6e 73 20 74 6f 20 6d 6f plications to mo
2110: 64 69 66 79 20 74 68 65 20 67 6c 6f 62 61 6c 20 dify the global
2120: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 66 configuration of
2130: 0a 2a 2a 20 74 68 65 20 53 51 4c 69 74 65 20 6c .** the SQLite l
2140: 69 62 72 61 72 79 20 61 74 20 72 75 6e 2d 74 69 ibrary at run-ti
2150: 6d 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 me..**.** This r
2160: 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e outine should on
2170: 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 77 68 65 ly be called whe
2180: 6e 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f n there are no o
2190: 75 74 73 74 61 6e 64 69 6e 67 0a 2a 2a 20 64 61 utstanding.** da
21a0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
21b0: 6e 73 20 6f 72 20 6d 65 6d 6f 72 79 20 61 6c 6c ns or memory all
21c0: 6f 63 61 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 ocations. This
21d0: 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 0a 2a routine is not.*
21e0: 2a 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 46 * threadsafe. F
21f0: 61 69 6c 75 72 65 20 74 6f 20 68 65 65 64 20 74 ailure to heed t
2200: 68 65 73 65 20 77 61 72 6e 69 6e 67 73 20 63 61 hese warnings ca
2210: 6e 20 6c 65 61 64 20 74 6f 20 75 6e 70 72 65 64 n lead to unpred
2220: 69 63 74 61 62 6c 65 0a 2a 2a 20 62 65 68 61 76 ictable.** behav
2230: 69 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ior..*/.int sqli
2240: 74 65 33 5f 63 6f 6e 66 69 67 28 69 6e 74 20 6f te3_config(int o
2250: 70 2c 20 2e 2e 2e 29 7b 0a 20 20 76 61 5f 6c 69 p, ...){. va_li
2260: 73 74 20 61 70 3b 0a 20 20 69 6e 74 20 72 63 20 st ap;. int rc
2270: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
2280: 2f 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 /* sqlite3_confi
2290: 67 28 29 20 73 68 61 6c 6c 20 72 65 74 75 72 6e g() shall return
22a0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 69 SQLITE_MISUSE i
22b0: 66 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 20 f it is invoked
22c0: 77 68 69 6c 65 0a 20 20 2a 2a 20 74 68 65 20 53 while. ** the S
22d0: 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 69 73 QLite library is
22e0: 20 69 6e 20 75 73 65 2e 20 2a 2f 0a 20 20 69 66 in use. */. if
22f0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
2300: 6f 6e 66 69 67 2e 69 73 49 6e 69 74 20 29 20 72 onfig.isInit ) r
2310: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 eturn SQLITE_MIS
2320: 55 53 45 3b 0a 0a 20 20 76 61 5f 73 74 61 72 74 USE;.. va_start
2330: 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 (ap, op);. swit
2340: 63 68 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f ch( op ){.. /
2350: 2a 20 4d 75 74 65 78 20 63 6f 6e 66 69 67 75 72 * Mutex configur
2360: 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 72 ation options ar
2370: 65 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 e only available
2380: 20 69 6e 20 61 20 74 68 72 65 61 64 73 61 66 65 in a threadsafe
2390: 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 69 6c 65 2e . ** compile.
23a0: 20 0a 20 20 20 20 2a 2f 0a 23 69 66 20 53 51 4c . */.#if SQL
23b0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 ITE_THREADSAFE.
23c0: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 case SQLITE_C
23d0: 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 ONFIG_SINGLETHRE
23e0: 41 44 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 44 AD: {. /* D
23f0: 69 73 61 62 6c 65 20 61 6c 6c 20 6d 75 74 65 78 isable all mutex
2400: 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c ing */. sql
2410: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2420: 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 30 3b .bCoreMutex = 0;
2430: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2440: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c 6c obalConfig.bFull
2450: 4d 75 74 65 78 20 3d 20 30 3b 0a 20 20 20 20 20 Mutex = 0;.
2460: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
2470: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
2480: 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 NFIG_MULTITHREAD
2490: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 44 69 73 : {. /* Dis
24a0: 61 62 6c 65 20 6d 75 74 65 78 69 6e 67 20 6f 66 able mutexing of
24b0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
24c0: 74 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 20 20 2f tions */. /
24d0: 2a 20 45 6e 61 62 6c 65 20 6d 75 74 65 78 69 6e * Enable mutexin
24e0: 67 20 6f 66 20 63 6f 72 65 20 64 61 74 61 20 73 g of core data s
24f0: 74 72 75 63 74 75 72 65 73 20 2a 2f 0a 20 20 20 tructures */.
2500: 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sqlite3Global
2510: 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 Config.bCoreMute
2520: 78 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 71 6c x = 1;. sql
2530: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
2540: 2e 62 46 75 6c 6c 4d 75 74 65 78 20 3d 20 30 3b .bFullMutex = 0;
2550: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
2560: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c }. case SQL
2570: 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 41 ITE_CONFIG_SERIA
2580: 4c 49 5a 45 44 3a 20 7b 0a 20 20 20 20 20 20 2f LIZED: {. /
2590: 2a 20 45 6e 61 62 6c 65 20 61 6c 6c 20 6d 75 74 * Enable all mut
25a0: 65 78 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 73 exing */. s
25b0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
25c0: 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 3d 20 ig.bCoreMutex =
25d0: 31 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 1;. sqlite3
25e0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 GlobalConfig.bFu
25f0: 6c 6c 4d 75 74 65 78 20 3d 20 31 3b 0a 20 20 20 llMutex = 1;.
2600: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
2610: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f case SQLITE_
2620: 43 4f 4e 46 49 47 5f 4d 55 54 45 58 3a 20 7b 0a CONFIG_MUTEX: {.
2630: 20 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 /* Specify
2640: 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 an alternative
2650: 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 mutex implementa
2660: 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 tion */. sq
2670: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
2680: 67 2e 6d 75 74 65 78 20 3d 20 2a 76 61 5f 61 72 g.mutex = *va_ar
2690: 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f 6d 75 g(ap, sqlite3_mu
26a0: 74 65 78 5f 6d 65 74 68 6f 64 73 2a 29 3b 0a 20 tex_methods*);.
26b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
26c0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
26d0: 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45 E_CONFIG_GETMUTE
26e0: 58 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 X: {. /* Re
26f0: 74 72 69 65 76 65 20 74 68 65 20 63 75 72 72 65 trieve the curre
2700: 6e 74 20 6d 75 74 65 78 20 69 6d 70 6c 65 6d 65 nt mutex impleme
2710: 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 ntation */.
2720: 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 73 71 6c *va_arg(ap, sql
2730: 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f ite3_mutex_metho
2740: 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 6c ds*) = sqlite3Gl
2750: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 obalConfig.mutex
2760: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
2770: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 0a 20 20 }.#endif...
2780: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f case SQLITE_CO
2790: 4e 46 49 47 5f 4d 41 4c 4c 4f 43 3a 20 7b 0a 20 NFIG_MALLOC: {.
27a0: 20 20 20 20 20 2f 2a 20 53 70 65 63 69 66 79 20 /* Specify
27b0: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6d an alternative m
27c0: 61 6c 6c 6f 63 20 69 6d 70 6c 65 6d 65 6e 74 61 alloc implementa
27d0: 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 71 tion */. sq
27e0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
27f0: 67 2e 6d 20 3d 20 2a 76 61 5f 61 72 67 28 61 70 g.m = *va_arg(ap
2800: 2c 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 , sqlite3_mem_me
2810: 74 68 6f 64 73 2a 29 3b 0a 20 20 20 20 20 20 62 thods*);. b
2820: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
2830: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
2840: 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 3a 20 7b 0a IG_GETMALLOC: {.
2850: 20 20 20 20 20 20 2f 2a 20 52 65 74 72 69 65 76 /* Retriev
2860: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 e the current ma
2870: 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 lloc() implement
2880: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 69 ation */. i
2890: 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c f( sqlite3Global
28a0: 43 6f 6e 66 69 67 2e 6d 2e 78 4d 61 6c 6c 6f 63 Config.m.xMalloc
28b0: 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 4d 65 6d ==0 ) sqlite3Mem
28c0: 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 SetDefault();.
28d0: 20 20 20 20 2a 76 61 5f 61 72 67 28 61 70 2c 20 *va_arg(ap,
28e0: 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
28f0: 6f 64 73 2a 29 20 3d 20 73 71 6c 69 74 65 33 47 ods*) = sqlite3G
2900: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 3b 0a 20 lobalConfig.m;.
2910: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
2920: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
2930: 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 E_CONFIG_MEMSTAT
2940: 55 53 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 45 US: {. /* E
2950: 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 nable or disable
2960: 20 74 68 65 20 6d 61 6c 6c 6f 63 20 73 74 61 74 the malloc stat
2970: 75 73 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 2a 2f us collection */
2980: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2990: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 4d 65 6d 73 obalConfig.bMems
29a0: 74 61 74 20 3d 20 76 61 5f 61 72 67 28 61 70 2c tat = va_arg(ap,
29b0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 int);. bre
29c0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 ak;. }. ca
29d0: 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 se SQLITE_CONFIG
29e0: 5f 53 43 52 41 54 43 48 3a 20 7b 0a 20 20 20 20 _SCRATCH: {.
29f0: 20 20 2f 2a 20 44 65 73 69 67 6e 61 74 65 20 61 /* Designate a
2a00: 20 62 75 66 66 65 72 20 66 6f 72 20 73 63 72 61 buffer for scra
2a10: 74 63 68 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 tch memory space
2a20: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
2a30: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 70 53 3GlobalConfig.pS
2a40: 63 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 cratch = va_arg(
2a50: 61 70 2c 20 76 6f 69 64 2a 29 3b 0a 20 20 20 20 ap, void*);.
2a60: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
2a70: 6f 6e 66 69 67 2e 73 7a 53 63 72 61 74 63 68 20 onfig.szScratch
2a80: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
2a90: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
2aa0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 53 63 GlobalConfig.nSc
2ab0: 72 61 74 63 68 20 3d 20 76 61 5f 61 72 67 28 61 ratch = va_arg(a
2ac0: 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 p, int);. b
2ad0: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 reak;. }.
2ae0: 63 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 case SQLITE_CONF
2af0: 49 47 5f 50 41 47 45 43 41 43 48 45 3a 20 7b 0a IG_PAGECACHE: {.
2b00: 20 20 20 20 20 20 2f 2a 20 44 65 73 69 67 6e 61 /* Designa
2b10: 74 65 20 61 20 62 75 66 66 65 72 20 66 6f 72 20 te a buffer for
2b20: 70 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 page cache memor
2b30: 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 20 20 20 y space */.
2b40: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
2b50: 6e 66 69 67 2e 70 50 61 67 65 20 3d 20 76 61 5f nfig.pPage = va_
2b60: 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b 0a arg(ap, void*);.
2b70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f sqlite3Glo
2b80: 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 50 61 67 65 balConfig.szPage
2b90: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
2ba0: 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 t);. sqlite
2bb0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 50 3GlobalConfig.nP
2bc0: 61 67 65 20 3d 20 76 61 5f 61 72 67 28 61 70 2c age = va_arg(ap,
2bd0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 int);. bre
2be0: 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 63 ak;. }.. c
2bf0: 61 73 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 ase SQLITE_CONFI
2c00: 47 5f 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 G_PCACHE: {.
2c10: 20 20 2f 2a 20 53 70 65 63 69 66 79 20 61 6e 20 /* Specify an
2c20: 61 6c 74 65 72 6e 61 74 69 76 65 20 70 61 67 65 alternative page
2c30: 20 63 61 63 68 65 20 69 6d 70 6c 65 6d 65 6e 74 cache implement
2c40: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 73 ation */. s
2c50: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2c60: 69 67 2e 70 63 61 63 68 65 20 3d 20 2a 76 61 5f ig.pcache = *va_
2c70: 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f arg(ap, sqlite3_
2c80: 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a 29 pcache_methods*)
2c90: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
2ca0: 20 20 20 7d 0a 0a 20 20 20 20 63 61 73 65 20 53 }.. case S
2cb0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 QLITE_CONFIG_GET
2cc0: 50 43 41 43 48 45 3a 20 7b 0a 20 20 20 20 20 20 PCACHE: {.
2cd0: 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 if( sqlite3Globa
2ce0: 6c 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 2e 78 lConfig.pcache.x
2cf0: 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Init==0 ){.
2d00: 20 20 20 73 71 6c 69 74 65 33 50 43 61 63 68 65 sqlite3PCache
2d10: 53 65 74 44 65 66 61 75 6c 74 28 29 3b 0a 20 20 SetDefault();.
2d20: 20 20 20 20 7d 0a 20 20 20 20 20 20 2a 76 61 5f }. *va_
2d30: 61 72 67 28 61 70 2c 20 73 71 6c 69 74 65 33 5f arg(ap, sqlite3_
2d40: 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a 29 pcache_methods*)
2d50: 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c = sqlite3Global
2d60: 43 6f 6e 66 69 67 2e 70 63 61 63 68 65 3b 0a 20 Config.pcache;.
2d70: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
2d80: 7d 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 }..#if defined(S
2d90: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d QLITE_ENABLE_MEM
2da0: 53 59 53 33 29 20 7c 7c 20 64 65 66 69 6e 65 64 SYS3) || defined
2db0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d (SQLITE_ENABLE_M
2dc0: 45 4d 53 59 53 35 29 0a 20 20 20 20 63 61 73 65 EMSYS5). case
2dd0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 SQLITE_CONFIG_H
2de0: 45 41 50 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 EAP: {. /*
2df0: 44 65 73 69 67 6e 61 74 65 20 61 20 62 75 66 66 Designate a buff
2e00: 65 72 20 66 6f 72 20 68 65 61 70 20 6d 65 6d 6f er for heap memo
2e10: 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 20 20 ry space */.
2e20: 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 sqlite3GlobalC
2e30: 6f 6e 66 69 67 2e 70 48 65 61 70 20 3d 20 76 61 onfig.pHeap = va
2e40: 5f 61 72 67 28 61 70 2c 20 76 6f 69 64 2a 29 3b _arg(ap, void*);
2e50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 6c . sqlite3Gl
2e60: 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 48 65 61 70 obalConfig.nHeap
2e70: 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e = va_arg(ap, in
2e80: 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 t);. sqlite
2e90: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 6e 3GlobalConfig.mn
2ea0: 52 65 71 20 3d 20 76 61 5f 61 72 67 28 61 70 2c Req = va_arg(ap,
2eb0: 20 69 6e 74 29 3b 0a 0a 20 20 20 20 20 20 69 66 int);.. if
2ec0: 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
2ed0: 6f 6e 66 69 67 2e 70 48 65 61 70 3d 3d 30 20 29 onfig.pHeap==0 )
2ee0: 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 {. /* If
2ef0: 74 68 65 20 68 65 61 70 20 70 6f 69 6e 74 65 72 the heap pointer
2f00: 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 is NULL, then r
2f10: 65 73 74 6f 72 65 20 74 68 65 20 6d 61 6c 6c 6f estore the mallo
2f20: 63 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e c implementation
2f30: 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b . ** back
2f40: 20 74 6f 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 to NULL pointer
2f50: 73 20 74 6f 6f 2e 20 20 54 68 69 73 20 77 69 6c s too. This wil
2f60: 6c 20 63 61 75 73 65 20 74 68 65 20 6d 61 6c 6c l cause the mall
2f70: 6f 63 20 74 6f 20 67 6f 0a 20 20 20 20 20 20 20 oc to go.
2f80: 20 2a 2a 20 62 61 63 6b 20 74 6f 20 69 74 73 20 ** back to its
2f90: 64 65 66 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e default implemen
2fa0: 74 61 74 69 6f 6e 20 77 68 65 6e 20 73 71 6c 69 tation when sqli
2fb0: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
2fc0: 20 69 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 72 is. ** r
2fd0: 75 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 un.. */.
2fe0: 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26 73 memset(&s
2ff0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
3000: 69 67 2e 6d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 ig.m, 0, sizeof(
3010: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3020: 66 69 67 2e 6d 29 29 3b 0a 20 20 20 20 20 20 7d fig.m));. }
3030: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a else{. /*
3040: 20 54 68 65 20 68 65 61 70 20 70 6f 69 6e 74 65 The heap pointe
3050: 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 r is not NULL, t
3060: 68 65 6e 20 69 6e 73 74 61 6c 6c 20 6f 6e 65 20 hen install one
3070: 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a of the. *
3080: 2a 20 6d 65 6d 35 2e 63 2f 6d 65 6d 33 2e 63 20 * mem5.c/mem3.c
3090: 6d 65 74 68 6f 64 73 2e 20 49 66 20 6e 65 69 74 methods. If neit
30a0: 68 65 72 20 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 her ENABLE_MEMSY
30b0: 53 33 20 6e 6f 72 0a 20 20 20 20 20 20 20 20 2a S3 nor. *
30c0: 2a 20 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 * ENABLE_MEMSYS5
30d0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 72 65 74 is defined, ret
30e0: 75 72 6e 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 urn an error..
30f0: 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 66 20 */.#ifdef
3100: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
3110: 4d 53 59 53 33 0a 20 20 20 20 20 20 20 20 73 71 MSYS3. sq
3120: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
3130: 67 2e 6d 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 g.m = *sqlite3Me
3140: 6d 47 65 74 4d 65 6d 73 79 73 33 28 29 3b 0a 23 mGetMemsys3();.#
3150: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
3160: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
3170: 53 35 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 S5. sqlit
3180: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
3190: 20 3d 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 = *sqlite3MemGe
31a0: 74 4d 65 6d 73 79 73 35 28 29 3b 0a 23 65 6e 64 tMemsys5();.#end
31b0: 69 66 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 if. }.
31c0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 break;. }.#e
31d0: 6e 64 69 66 0a 0a 20 20 20 20 63 61 73 65 20 53 ndif.. case S
31e0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 4f QLITE_CONFIG_LOO
31f0: 4b 41 53 49 44 45 3a 20 7b 0a 20 20 20 20 20 20 KASIDE: {.
3200: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e sqlite3GlobalCon
3210: 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 20 fig.szLookaside
3220: 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 = va_arg(ap, int
3230: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
3240: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 6f GlobalConfig.nLo
3250: 6f 6b 61 73 69 64 65 20 3d 20 76 61 5f 61 72 67 okaside = va_arg
3260: 28 61 70 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 (ap, int);.
3270: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 break;. }..
3280: 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 default: {.
3290: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
32a0: 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 62 72 65 ERROR;. bre
32b0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 ak;. }. }.
32c0: 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 20 72 65 va_end(ap);. re
32d0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
32e0: 2a 20 53 65 74 20 75 70 20 74 68 65 20 6c 6f 6f * Set up the loo
32f0: 6b 61 73 69 64 65 20 62 75 66 66 65 72 73 20 66 kaside buffers f
3300: 6f 72 20 61 20 64 61 74 61 62 61 73 65 20 63 6f or a database co
3310: 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2a 20 52 65 74 nnection..** Ret
3320: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e urn SQLITE_OK on
3330: 20 73 75 63 63 65 73 73 2e 20 20 0a 2a 2a 20 49 success. .** I
3340: 66 20 6c 6f 6f 6b 61 73 69 64 65 20 69 73 20 61 f lookaside is a
3350: 6c 72 65 61 64 79 20 61 63 74 69 76 65 2c 20 72 lready active, r
3360: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 eturn SQLITE_BUS
3370: 59 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 7a 20 Y..**.** The sz
3380: 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 68 65 parameter is the
3390: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
33a0: 20 69 6e 20 65 61 63 68 20 6c 6f 6f 6b 61 73 69 in each lookasi
33b0: 64 65 20 73 6c 6f 74 2e 0a 2a 2a 20 54 68 65 20 de slot..** The
33c0: 63 6e 74 20 70 61 72 61 6d 65 74 65 72 20 69 73 cnt parameter is
33d0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 the number of s
33e0: 6c 6f 74 73 2e 20 20 49 66 20 70 53 74 61 72 74 lots. If pStart
33f0: 20 69 73 20 4e 55 4c 4c 20 74 68 65 0a 2a 2a 20 is NULL the.**
3400: 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 6c 6f space for the lo
3410: 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 69 okaside memory i
3420: 73 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 s obtained from
3430: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 sqlite3_malloc()
3440: 2e 0a 2a 2a 20 49 66 20 70 53 74 61 72 74 20 69 ..** If pStart i
3450: 73 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 s not NULL then
3460: 69 74 20 69 73 20 73 7a 2a 63 6e 74 20 62 79 74 it is sz*cnt byt
3470: 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 74 6f 20 es of memory to
3480: 75 73 65 20 66 6f 72 0a 2a 2a 20 74 68 65 20 6c use for.** the l
3490: 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 2e ookaside memory.
34a0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
34b0: 65 74 75 70 4c 6f 6f 6b 61 73 69 64 65 28 73 71 etupLookaside(sq
34c0: 6c 69 74 65 33 20 2a 64 62 2c 20 76 6f 69 64 20 lite3 *db, void
34d0: 2a 70 42 75 66 2c 20 69 6e 74 20 73 7a 2c 20 69 *pBuf, int sz, i
34e0: 6e 74 20 63 6e 74 29 7b 0a 20 20 76 6f 69 64 20 nt cnt){. void
34f0: 2a 70 53 74 61 72 74 3b 0a 20 20 69 66 28 20 64 *pStart;. if( d
3500: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 b->lookaside.nOu
3510: 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 t ){. return
3520: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d SQLITE_BUSY;. }
3530: 0a 20 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 65 . /* Free any e
3540: 78 69 73 74 69 6e 67 20 6c 6f 6f 6b 61 73 69 64 xisting lookasid
3550: 65 20 62 75 66 66 65 72 20 66 6f 72 20 74 68 69 e buffer for thi
3560: 73 20 68 61 6e 64 6c 65 20 62 65 66 6f 72 65 0a s handle before.
3570: 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 69 6e 67 20 ** allocating
3580: 61 20 6e 65 77 20 6f 6e 65 20 73 6f 20 77 65 20 a new one so we
3590: 64 6f 6e 27 74 20 68 61 76 65 20 74 6f 20 68 61 don't have to ha
35a0: 76 65 20 73 70 61 63 65 20 66 6f 72 20 0a 20 20 ve space for .
35b0: 2a 2a 20 62 6f 74 68 20 61 74 20 74 68 65 20 73 ** both at the s
35c0: 61 6d 65 20 74 69 6d 65 2e 0a 20 20 2a 2f 0a 20 ame time.. */.
35d0: 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 if( db->lookasi
35e0: 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a de.bMalloced ){.
35f0: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
3600: 28 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 (db->lookaside.p
3610: 53 74 61 72 74 29 3b 0a 20 20 7d 0a 20 20 2f 2a Start);. }. /*
3620: 20 54 68 65 20 73 69 7a 65 20 6f 66 20 61 20 6c The size of a l
3630: 6f 6f 6b 61 73 69 64 65 20 73 6c 6f 74 20 6e 65 ookaside slot ne
3640: 65 64 73 20 74 6f 20 62 65 20 6c 61 72 67 65 72 eds to be larger
3650: 20 74 68 61 6e 20 61 20 70 6f 69 6e 74 65 72 0a than a pointer.
3660: 20 20 2a 2a 20 74 6f 20 62 65 20 75 73 65 66 75 ** to be usefu
3670: 6c 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 73 7a l.. */. if( sz
3680: 3c 3d 28 69 6e 74 29 73 69 7a 65 6f 66 28 4c 6f <=(int)sizeof(Lo
3690: 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 20 29 20 okasideSlot*) )
36a0: 73 7a 20 3d 20 30 3b 0a 20 20 69 66 28 20 63 6e sz = 0;. if( cn
36b0: 74 3c 30 20 29 20 63 6e 74 20 3d 20 30 3b 0a 20 t<0 ) cnt = 0;.
36c0: 20 69 66 28 20 73 7a 3d 3d 30 20 7c 7c 20 63 6e if( sz==0 || cn
36d0: 74 3d 3d 30 20 29 7b 0a 20 20 20 20 73 7a 20 3d t==0 ){. sz =
36e0: 20 30 3b 0a 20 20 20 20 70 53 74 61 72 74 20 3d 0;. pStart =
36f0: 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 0;. }else if(
3700: 70 42 75 66 3d 3d 30 20 29 7b 0a 20 20 20 20 73 pBuf==0 ){. s
3710: 7a 20 3d 20 52 4f 55 4e 44 38 28 73 7a 29 3b 0a z = ROUND8(sz);.
3720: 20 20 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e sqlite3Begin
3730: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a BenignMalloc();.
3740: 20 20 20 20 70 53 74 61 72 74 20 3d 20 73 71 6c pStart = sql
3750: 69 74 65 33 4d 61 6c 6c 6f 63 28 20 73 7a 2a 63 ite3Malloc( sz*c
3760: 6e 74 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 nt );. sqlite
3770: 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3EndBenignMalloc
3780: 28 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ();. }else{.
3790: 20 73 7a 20 3d 20 52 4f 55 4e 44 44 4f 57 4e 38 sz = ROUNDDOWN8
37a0: 28 73 7a 29 3b 0a 20 20 20 20 70 53 74 61 72 74 (sz);. pStart
37b0: 20 3d 20 70 42 75 66 3b 0a 20 20 7d 0a 20 20 64 = pBuf;. }. d
37c0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 53 74 b->lookaside.pSt
37d0: 61 72 74 20 3d 20 70 53 74 61 72 74 3b 0a 20 20 art = pStart;.
37e0: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 46 db->lookaside.pF
37f0: 72 65 65 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 6c ree = 0;. db->l
3800: 6f 6f 6b 61 73 69 64 65 2e 73 7a 20 3d 20 28 75 ookaside.sz = (u
3810: 31 36 29 73 7a 3b 0a 20 20 69 66 28 20 70 53 74 16)sz;. if( pSt
3820: 61 72 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 art ){. int i
3830: 3b 0a 20 20 20 20 4c 6f 6f 6b 61 73 69 64 65 53 ;. LookasideS
3840: 6c 6f 74 20 2a 70 3b 0a 20 20 20 20 61 73 73 65 lot *p;. asse
3850: 72 74 28 20 73 7a 20 3e 20 28 69 6e 74 29 73 69 rt( sz > (int)si
3860: 7a 65 6f 66 28 4c 6f 6f 6b 61 73 69 64 65 53 6c zeof(LookasideSl
3870: 6f 74 2a 29 20 29 3b 0a 20 20 20 20 70 20 3d 20 ot*) );. p =
3880: 28 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 2a 29 (LookasideSlot*)
3890: 70 53 74 61 72 74 3b 0a 20 20 20 20 66 6f 72 28 pStart;. for(
38a0: 69 3d 63 6e 74 2d 31 3b 20 69 3e 3d 30 3b 20 69 i=cnt-1; i>=0; i
38b0: 2d 2d 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 4e --){. p->pN
38c0: 65 78 74 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 ext = db->lookas
38d0: 69 64 65 2e 70 46 72 65 65 3b 0a 20 20 20 20 20 ide.pFree;.
38e0: 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 db->lookaside.p
38f0: 46 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 20 20 Free = p;.
3900: 70 20 3d 20 28 4c 6f 6f 6b 61 73 69 64 65 53 6c p = (LookasideSl
3910: 6f 74 2a 29 26 28 28 75 38 2a 29 70 29 5b 73 7a ot*)&((u8*)p)[sz
3920: 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d ];. }. db-
3930: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 20 >lookaside.pEnd
3940: 3d 20 70 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f = p;. db->loo
3950: 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 kaside.bEnabled
3960: 3d 20 31 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f = 1;. db->loo
3970: 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 kaside.bMalloced
3980: 20 3d 20 70 42 75 66 3d 3d 30 20 3f 31 3a 30 3b = pBuf==0 ?1:0;
3990: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 . }else{. db
39a0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 45 6e 64 ->lookaside.pEnd
39b0: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f = 0;. db->lo
39c0: 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 okaside.bEnabled
39d0: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f = 0;. db->lo
39e0: 6f 6b 61 73 69 64 65 2e 62 4d 61 6c 6c 6f 63 65 okaside.bMalloce
39f0: 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 d = 0;. }. ret
3a00: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
3a10: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
3a20: 68 65 20 6d 75 74 65 78 20 61 73 73 6f 63 69 61 he mutex associa
3a30: 74 65 64 20 77 69 74 68 20 61 20 64 61 74 61 62 ted with a datab
3a40: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ase connection..
3a50: 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 */.sqlite3_mutex
3a60: 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 6d 75 74 *sqlite3_db_mut
3a70: 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b ex(sqlite3 *db){
3a80: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 6d 75 . return db->mu
3a90: 74 65 78 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f tex;.}../*.** Co
3aa0: 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 65 74 74 nfiguration sett
3ab0: 69 6e 67 73 20 66 6f 72 20 61 6e 20 69 6e 64 69 ings for an indi
3ac0: 76 69 64 75 61 6c 20 64 61 74 61 62 61 73 65 20 vidual database
3ad0: 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2f 0a 69 6e connection.*/.in
3ae0: 74 20 73 71 6c 69 74 65 33 5f 64 62 5f 63 6f 6e t sqlite3_db_con
3af0: 66 69 67 28 73 71 6c 69 74 65 33 20 2a 64 62 2c fig(sqlite3 *db,
3b00: 20 69 6e 74 20 6f 70 2c 20 2e 2e 2e 29 7b 0a 20 int op, ...){.
3b10: 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 69 va_list ap;. i
3b20: 6e 74 20 72 63 3b 0a 20 20 76 61 5f 73 74 61 72 nt rc;. va_star
3b30: 74 28 61 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 t(ap, op);. swi
3b40: 74 63 68 28 20 6f 70 20 29 7b 0a 20 20 20 20 63 tch( op ){. c
3b50: 61 73 65 20 53 51 4c 49 54 45 5f 44 42 43 4f 4e ase SQLITE_DBCON
3b60: 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 45 3a 20 7b FIG_LOOKASIDE: {
3b70: 0a 20 20 20 20 20 20 76 6f 69 64 20 2a 70 42 75 . void *pBu
3b80: 66 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 76 f = va_arg(ap, v
3b90: 6f 69 64 2a 29 3b 0a 20 20 20 20 20 20 69 6e 74 oid*);. int
3ba0: 20 73 7a 20 3d 20 76 61 5f 61 72 67 28 61 70 2c sz = va_arg(ap,
3bb0: 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 69 6e 74 int);. int
3bc0: 20 63 6e 74 20 3d 20 76 61 5f 61 72 67 28 61 70 cnt = va_arg(ap
3bd0: 2c 20 69 6e 74 29 3b 0a 20 20 20 20 20 20 72 63 , int);. rc
3be0: 20 3d 20 73 65 74 75 70 4c 6f 6f 6b 61 73 69 64 = setupLookasid
3bf0: 65 28 64 62 2c 20 70 42 75 66 2c 20 73 7a 2c 20 e(db, pBuf, sz,
3c00: 63 6e 74 29 3b 0a 20 20 20 20 20 20 62 72 65 61 cnt);. brea
3c10: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 k;. }. def
3c20: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 ault: {. rc
3c30: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
3c40: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
3c50: 20 20 7d 0a 20 20 7d 0a 20 20 76 61 5f 65 6e 64 }. }. va_end
3c60: 28 61 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 (ap);. return r
3c70: 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 c;.}.../*.** Ret
3c80: 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 urn true if the
3c90: 62 75 66 66 65 72 20 7a 5b 30 2e 2e 6e 2d 31 5d buffer z[0..n-1]
3ca0: 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 73 70 contains all sp
3cb0: 61 63 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 aces..*/.static
3cc0: 69 6e 74 20 61 6c 6c 53 70 61 63 65 73 28 63 6f int allSpaces(co
3cd0: 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 nst char *z, int
3ce0: 20 6e 29 7b 0a 20 20 77 68 69 6c 65 28 20 6e 3e n){. while( n>
3cf0: 30 20 26 26 20 7a 5b 6e 2d 31 5d 3d 3d 27 20 27 0 && z[n-1]==' '
3d00: 20 29 7b 20 6e 2d 2d 3b 20 7d 0a 20 20 72 65 74 ){ n--; }. ret
3d10: 75 72 6e 20 6e 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 0a urn n==0;.}../*.
3d20: 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 64 ** This is the d
3d30: 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 efault collating
3d40: 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 20 function named
3d50: 22 42 49 4e 41 52 59 22 20 77 68 69 63 68 20 69 "BINARY" which i
3d60: 73 20 61 6c 77 61 79 73 0a 2a 2a 20 61 76 61 69 s always.** avai
3d70: 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 lable..**.** If
3d80: 74 68 65 20 70 61 64 46 6c 61 67 20 61 72 67 75 the padFlag argu
3d90: 6d 65 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c ment is not NULL
3da0: 20 74 68 65 6e 20 73 70 61 63 65 20 70 61 64 64 then space padd
3db0: 69 6e 67 20 61 74 20 74 68 65 20 65 6e 64 0a 2a ing at the end.*
3dc0: 2a 20 6f 66 20 73 74 72 69 6e 67 73 20 69 73 20 * of strings is
3dd0: 69 67 6e 6f 72 65 64 2e 20 20 54 68 69 73 20 69 ignored. This i
3de0: 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 52 54 mplements the RT
3df0: 52 49 4d 20 63 6f 6c 6c 61 74 69 6f 6e 2e 0a 2a RIM collation..*
3e00: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 69 6e /.static int bin
3e10: 43 6f 6c 6c 46 75 6e 63 28 0a 20 20 76 6f 69 64 CollFunc(. void
3e20: 20 2a 70 61 64 46 6c 61 67 2c 0a 20 20 69 6e 74 *padFlag,. int
3e30: 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f nKey1, const vo
3e40: 69 64 20 2a 70 4b 65 79 31 2c 0a 20 20 69 6e 74 id *pKey1,. int
3e50: 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f nKey2, const vo
3e60: 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 69 id *pKey2.){. i
3e70: 6e 74 20 72 63 2c 20 6e 3b 0a 20 20 6e 20 3d 20 nt rc, n;. n =
3e80: 6e 4b 65 79 31 3c 6e 4b 65 79 32 20 3f 20 6e 4b nKey1<nKey2 ? nK
3e90: 65 79 31 20 3a 20 6e 4b 65 79 32 3b 0a 20 20 72 ey1 : nKey2;. r
3ea0: 63 20 3d 20 6d 65 6d 63 6d 70 28 70 4b 65 79 31 c = memcmp(pKey1
3eb0: 2c 20 70 4b 65 79 32 2c 20 6e 29 3b 0a 20 20 69 , pKey2, n);. i
3ec0: 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20 f( rc==0 ){.
3ed0: 69 66 28 20 70 61 64 46 6c 61 67 0a 20 20 20 20 if( padFlag.
3ee0: 20 26 26 20 61 6c 6c 53 70 61 63 65 73 28 28 28 && allSpaces(((
3ef0: 63 68 61 72 2a 29 70 4b 65 79 31 29 2b 6e 2c 20 char*)pKey1)+n,
3f00: 6e 4b 65 79 31 2d 6e 29 0a 20 20 20 20 20 26 26 nKey1-n). &&
3f10: 20 61 6c 6c 53 70 61 63 65 73 28 28 28 63 68 61 allSpaces(((cha
3f20: 72 2a 29 70 4b 65 79 32 29 2b 6e 2c 20 6e 4b 65 r*)pKey2)+n, nKe
3f30: 79 32 2d 6e 29 0a 20 20 20 20 29 7b 0a 20 20 20 y2-n). ){.
3f40: 20 20 20 2f 2a 20 4c 65 61 76 65 20 72 63 20 75 /* Leave rc u
3f50: 6e 63 68 61 6e 67 65 64 20 61 74 20 30 20 2a 2f nchanged at 0 */
3f60: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
3f70: 20 20 72 63 20 3d 20 6e 4b 65 79 31 20 2d 20 6e rc = nKey1 - n
3f80: 4b 65 79 32 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a Key2;. }. }.
3f90: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
3fa0: 2f 2a 0a 2a 2a 20 41 6e 6f 74 68 65 72 20 62 75 /*.** Another bu
3fb0: 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67 ilt-in collating
3fc0: 20 73 65 71 75 65 6e 63 65 3a 20 4e 4f 43 41 53 sequence: NOCAS
3fd0: 45 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 E. .**.** This c
3fe0: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 ollating sequenc
3ff0: 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f e is intended to
4000: 20 62 65 20 75 73 65 64 20 66 6f 72 20 22 63 61 be used for "ca
4010: 73 65 20 69 6e 64 65 70 65 6e 64 61 6e 74 0a 2a se independant.*
4020: 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 22 2e 20 53 * comparison". S
4030: 51 4c 69 74 65 27 73 20 6b 6e 6f 77 6c 65 64 67 QLite's knowledg
4040: 65 20 6f 66 20 75 70 70 65 72 20 61 6e 64 20 6c e of upper and l
4050: 6f 77 65 72 20 63 61 73 65 20 65 71 75 69 76 61 ower case equiva
4060: 6c 65 6e 74 73 0a 2a 2a 20 65 78 74 65 6e 64 73 lents.** extends
4070: 20 6f 6e 6c 79 20 74 6f 20 74 68 65 20 32 36 20 only to the 26
4080: 63 68 61 72 61 63 74 65 72 73 20 75 73 65 64 20 characters used
4090: 69 6e 20 74 68 65 20 45 6e 67 6c 69 73 68 20 6c in the English l
40a0: 61 6e 67 75 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 41 anguage..**.** A
40b0: 74 20 74 68 65 20 6d 6f 6d 65 6e 74 20 74 68 65 t the moment the
40c0: 72 65 20 69 73 20 6f 6e 6c 79 20 61 20 55 54 46 re is only a UTF
40d0: 2d 38 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f -8 implementatio
40e0: 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 n..*/.static int
40f0: 20 6e 6f 63 61 73 65 43 6f 6c 6c 61 74 69 6e 67 nocaseCollating
4100: 46 75 6e 63 28 0a 20 20 76 6f 69 64 20 2a 4e 6f Func(. void *No
4110: 74 55 73 65 64 2c 0a 20 20 69 6e 74 20 6e 4b 65 tUsed,. int nKe
4120: 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a y1, const void *
4130: 70 4b 65 79 31 2c 0a 20 20 69 6e 74 20 6e 4b 65 pKey1,. int nKe
4140: 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a y2, const void *
4150: 70 4b 65 79 32 0a 29 7b 0a 20 20 69 6e 74 20 72 pKey2.){. int r
4160: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 = sqlite3StrNIC
4170: 6d 70 28 0a 20 20 20 20 20 20 28 63 6f 6e 73 74 mp(. (const
4180: 20 63 68 61 72 20 2a 29 70 4b 65 79 31 2c 20 28 char *)pKey1, (
4190: 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 4b 65 const char *)pKe
41a0: 79 32 2c 20 28 6e 4b 65 79 31 3c 6e 4b 65 79 32 y2, (nKey1<nKey2
41b0: 29 3f 6e 4b 65 79 31 3a 6e 4b 65 79 32 29 3b 0a )?nKey1:nKey2);.
41c0: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
41d0: 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 69 ER(NotUsed);. i
41e0: 66 28 20 30 3d 3d 72 20 29 7b 0a 20 20 20 20 72 f( 0==r ){. r
41f0: 20 3d 20 6e 4b 65 79 31 2d 6e 4b 65 79 32 3b 0a = nKey1-nKey2;.
4200: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a }. return r;.
4210: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
4220: 74 68 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 the ROWID of the
4230: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 most recent ins
4240: 65 72 74 0a 2a 2f 0a 73 71 6c 69 74 65 5f 69 6e ert.*/.sqlite_in
4250: 74 36 34 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 t64 sqlite3_last
4260: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 73 71 _insert_rowid(sq
4270: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 lite3 *db){. re
4280: 74 75 72 6e 20 64 62 2d 3e 6c 61 73 74 52 6f 77 turn db->lastRow
4290: 69 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 id;.}../*.** Ret
42a0: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f urn the number o
42b0: 66 20 63 68 61 6e 67 65 73 20 69 6e 20 74 68 65 f changes in the
42c0: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 61 6c most recent cal
42d0: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 65 78 65 l to sqlite3_exe
42e0: 63 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 c()..*/.int sqli
42f0: 74 65 33 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 te3_changes(sqli
4300: 74 65 33 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 te3 *db){. retu
4310: 72 6e 20 64 62 2d 3e 6e 43 68 61 6e 67 65 3b 0a rn db->nChange;.
4320: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
4330: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 the number of ch
4340: 61 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 anges since the
4350: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
4360: 77 61 73 20 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 69 was opened..*/.i
4370: 6e 74 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c nt sqlite3_total
4380: 5f 63 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 _changes(sqlite3
4390: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 *db){. return
43a0: 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65 db->nTotalChange
43b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 ;.}../*.** Close
43c0: 20 61 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f all open savepo
43d0: 69 6e 74 73 2e 20 54 68 69 73 20 66 75 6e 63 74 ints. This funct
43e0: 69 6f 6e 20 6f 6e 6c 79 20 6d 61 6e 69 70 75 6c ion only manipul
43f0: 61 74 65 73 20 66 69 65 6c 64 73 20 6f 66 20 74 ates fields of t
4400: 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 he.** database h
4410: 61 6e 64 6c 65 20 6f 62 6a 65 63 74 2c 20 69 74 andle object, it
4420: 20 64 6f 65 73 20 6e 6f 74 20 63 6c 6f 73 65 20 does not close
4430: 61 6e 79 20 73 61 76 65 70 6f 69 6e 74 73 20 74 any savepoints t
4440: 68 61 74 20 6d 61 79 20 62 65 20 6f 70 65 6e 0a hat may be open.
4450: 2a 2a 20 61 74 20 74 68 65 20 62 2d 74 72 65 65 ** at the b-tree
4460: 2f 70 61 67 65 72 20 6c 65 76 65 6c 2e 0a 2a 2f /pager level..*/
4470: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f .void sqlite3Clo
4480: 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 71 6c seSavepoints(sql
4490: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 77 68 69 ite3 *db){. whi
44a0: 6c 65 28 20 64 62 2d 3e 70 53 61 76 65 70 6f 69 le( db->pSavepoi
44b0: 6e 74 20 29 7b 0a 20 20 20 20 53 61 76 65 70 6f nt ){. Savepo
44c0: 69 6e 74 20 2a 70 54 6d 70 20 3d 20 64 62 2d 3e int *pTmp = db->
44d0: 70 53 61 76 65 70 6f 69 6e 74 3b 0a 20 20 20 20 pSavepoint;.
44e0: 64 62 2d 3e 70 53 61 76 65 70 6f 69 6e 74 20 3d db->pSavepoint =
44f0: 20 70 54 6d 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 pTmp->pNext;.
4500: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
4510: 64 62 2c 20 70 54 6d 70 29 3b 0a 20 20 7d 0a 20 db, pTmp);. }.
4520: 20 64 62 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 20 db->nSavepoint
4530: 3d 20 30 3b 0a 20 20 64 62 2d 3e 6e 53 74 61 74 = 0;. db->nStat
4540: 65 6d 65 6e 74 20 3d 20 30 3b 0a 20 20 64 62 2d ement = 0;. db-
4550: 3e 69 73 54 72 61 6e 73 61 63 74 69 6f 6e 53 61 >isTransactionSa
4560: 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a 7d 0a 0a vepoint = 0;.}..
4570: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 /*.** Close an e
4580: 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64 xisting SQLite d
4590: 61 74 61 62 61 73 65 0a 2a 2f 0a 69 6e 74 20 73 atabase.*/.int s
45a0: 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 73 71 6c qlite3_close(sql
45b0: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 48 61 73 ite3 *db){. Has
45c0: 68 45 6c 65 6d 20 2a 69 3b 0a 20 20 69 6e 74 20 hElem *i;. int
45d0: 6a 3b 0a 0a 20 20 69 66 28 20 21 64 62 20 29 7b j;.. if( !db ){
45e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
45f0: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 TE_OK;. }. if(
4600: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 !sqlite3SafetyC
4610: 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 heckSickOrOk(db)
4620: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
4630: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 QLITE_MISUSE;.
4640: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
4650: 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 x_enter(db->mute
4660: 78 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 52 65 x);.. sqlite3Re
4670: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
4680: 61 28 64 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 a(db, 0);.. /*
4690: 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e If a transaction
46a0: 20 69 73 20 6f 70 65 6e 2c 20 74 68 65 20 52 65 is open, the Re
46b0: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
46c0: 61 28 29 20 63 61 6c 6c 20 61 62 6f 76 65 0a 20 a() call above.
46d0: 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 68 61 76 ** will not hav
46e0: 65 20 63 61 6c 6c 65 64 20 74 68 65 20 78 44 69 e called the xDi
46f0: 73 63 6f 6e 6e 65 63 74 28 29 20 6d 65 74 68 6f sconnect() metho
4700: 64 20 6f 6e 20 61 6e 79 20 76 69 72 74 75 61 6c d on any virtual
4710: 0a 20 20 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 . ** tables in
4720: 74 68 65 20 64 62 2d 3e 61 56 54 72 61 6e 73 5b the db->aVTrans[
4730: 5d 20 61 72 72 61 79 2e 20 54 68 65 20 66 6f 6c ] array. The fol
4740: 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 56 74 lowing sqlite3Vt
4750: 61 62 52 6f 6c 6c 62 61 63 6b 28 29 0a 20 20 2a abRollback(). *
4760: 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 64 6f 20 73 * call will do s
4770: 6f 2e 20 57 65 20 6e 65 65 64 20 74 6f 20 64 6f o. We need to do
4780: 20 74 68 69 73 20 62 65 66 6f 72 65 20 74 68 65 this before the
4790: 20 63 68 65 63 6b 20 66 6f 72 20 61 63 74 69 76 check for activ
47a0: 65 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 e. ** SQL state
47b0: 6d 65 6e 74 73 20 62 65 6c 6f 77 2c 20 61 73 20 ments below, as
47c0: 74 68 65 20 76 2d 74 61 62 6c 65 20 69 6d 70 6c the v-table impl
47d0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 61 79 20 62 ementation may b
47e0: 65 20 73 74 6f 72 69 6e 67 0a 20 20 2a 2a 20 73 e storing. ** s
47f0: 6f 6d 65 20 70 72 65 70 61 72 65 64 20 73 74 61 ome prepared sta
4800: 74 65 6d 65 6e 74 73 20 69 6e 74 65 72 6e 61 6c tements internal
4810: 6c 79 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 ly.. */. sqlit
4820: 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 64 e3VtabRollback(d
4830: 62 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 b);.. /* If the
4840: 72 65 20 61 72 65 20 61 6e 79 20 6f 75 74 73 74 re are any outst
4850: 61 6e 64 69 6e 67 20 56 4d 73 2c 20 72 65 74 75 anding VMs, retu
4860: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 rn SQLITE_BUSY.
4870: 2a 2f 0a 20 20 69 66 28 20 64 62 2d 3e 70 56 64 */. if( db->pVd
4880: 62 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 be ){. sqlite
4890: 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 3Error(db, SQLIT
48a0: 45 5f 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 E_BUSY, .
48b0: 20 22 75 6e 61 62 6c 65 20 74 6f 20 63 6c 6f 73 "unable to clos
48c0: 65 20 64 75 65 20 74 6f 20 75 6e 66 69 6e 61 6c e due to unfinal
48d0: 69 73 65 64 20 73 74 61 74 65 6d 65 6e 74 73 22 ised statements"
48e0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d );. sqlite3_m
48f0: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
4900: 75 74 65 78 29 3b 0a 20 20 20 20 72 65 74 75 72 utex);. retur
4910: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
4920: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c }. assert( sql
4930: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 53 ite3SafetyCheckS
4940: 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 3b 0a 0a ickOrOk(db) );..
4950: 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d for(j=0; j<db-
4960: 3e 6e 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 >nDb; j++){.
4970: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d Btree *pBt = db-
4980: 3e 61 44 62 5b 6a 5d 2e 70 42 74 3b 0a 20 20 20 >aDb[j].pBt;.
4990: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 if( pBt && sqli
49a0: 74 65 33 42 74 72 65 65 49 73 49 6e 42 61 63 6b te3BtreeIsInBack
49b0: 75 70 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 up(pBt) ){.
49c0: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 sqlite3Error(db
49d0: 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 2c 20 0a , SQLITE_BUSY, .
49e0: 20 20 20 20 20 20 20 20 20 20 22 75 6e 61 62 6c "unabl
49f0: 65 20 74 6f 20 63 6c 6f 73 65 20 64 75 65 20 74 e to close due t
4a00: 6f 20 75 6e 66 69 6e 69 73 68 65 64 20 62 61 63 o unfinished bac
4a10: 6b 75 70 20 6f 70 65 72 61 74 69 6f 6e 22 29 3b kup operation");
4a20: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
4a30: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
4a40: 75 74 65 78 29 3b 0a 20 20 20 20 20 20 72 65 74 utex);. ret
4a50: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
4a60: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
4a70: 20 46 72 65 65 20 61 6e 79 20 6f 75 74 73 74 61 Free any outsta
4a80: 6e 64 69 6e 67 20 53 61 76 65 70 6f 69 6e 74 20 nding Savepoint
4a90: 73 74 72 75 63 74 75 72 65 73 2e 20 2a 2f 0a 20 structures. */.
4aa0: 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 76 sqlite3CloseSav
4ab0: 65 70 6f 69 6e 74 73 28 64 62 29 3b 0a 0a 20 20 epoints(db);..
4ac0: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 64 62 2d 3e 6e for(j=0; j<db->n
4ad0: 44 62 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 73 74 Db; j++){. st
4ae0: 72 75 63 74 20 44 62 20 2a 70 44 62 20 3d 20 26 ruct Db *pDb = &
4af0: 64 62 2d 3e 61 44 62 5b 6a 5d 3b 0a 20 20 20 20 db->aDb[j];.
4b00: 69 66 28 20 70 44 62 2d 3e 70 42 74 20 29 7b 0a if( pDb->pBt ){.
4b10: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
4b20: 65 65 43 6c 6f 73 65 28 70 44 62 2d 3e 70 42 74 eeClose(pDb->pBt
4b30: 29 3b 0a 20 20 20 20 20 20 70 44 62 2d 3e 70 42 );. pDb->pB
4b40: 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 t = 0;. if(
4b50: 20 6a 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 j!=1 ){.
4b60: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 20 3d 20 pDb->pSchema =
4b70: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0;. }. }
4b80: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 52 65 . }. sqlite3Re
4b90: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d setInternalSchem
4ba0: 61 28 64 62 2c 20 30 29 3b 0a 0a 20 20 2f 2a 20 a(db, 0);.. /*
4bb0: 54 65 6c 6c 20 74 68 65 20 63 6f 64 65 20 69 6e Tell the code in
4bc0: 20 6e 6f 74 69 66 79 2e 63 20 74 68 61 74 20 74 notify.c that t
4bd0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6e 6f he connection no
4be0: 20 6c 6f 6e 67 65 72 20 68 6f 6c 64 73 20 61 6e longer holds an
4bf0: 79 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 61 6e 64 y. ** locks and
4c00: 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 does not requir
4c10: 65 20 61 6e 79 20 66 75 72 74 68 65 72 20 75 6e e any further un
4c20: 6c 6f 63 6b 2d 6e 6f 74 69 66 79 20 63 61 6c 6c lock-notify call
4c30: 62 61 63 6b 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 backs.. */. sq
4c40: 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 lite3ConnectionC
4c50: 6c 6f 73 65 64 28 64 62 29 3b 0a 0a 20 20 61 73 losed(db);.. as
4c60: 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3c 3d 32 sert( db->nDb<=2
4c70: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 );. assert( db
4c80: 2d 3e 61 44 62 3d 3d 64 62 2d 3e 61 44 62 53 74 ->aDb==db->aDbSt
4c90: 61 74 69 63 20 29 3b 0a 20 20 66 6f 72 28 6a 3d atic );. for(j=
4ca0: 30 3b 20 6a 3c 41 72 72 61 79 53 69 7a 65 28 64 0; j<ArraySize(d
4cb0: 62 2d 3e 61 46 75 6e 63 2e 61 29 3b 20 6a 2b 2b b->aFunc.a); j++
4cc0: 29 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a ){. FuncDef *
4cd0: 70 4e 65 78 74 2c 20 2a 70 48 61 73 68 2c 20 2a pNext, *pHash, *
4ce0: 70 3b 0a 20 20 20 20 66 6f 72 28 70 3d 64 62 2d p;. for(p=db-
4cf0: 3e 61 46 75 6e 63 2e 61 5b 6a 5d 3b 20 70 3b 20 >aFunc.a[j]; p;
4d00: 70 3d 70 48 61 73 68 29 7b 0a 20 20 20 20 20 20 p=pHash){.
4d10: 70 48 61 73 68 20 3d 20 70 2d 3e 70 48 61 73 68 pHash = p->pHash
4d20: 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 70 ;. while( p
4d30: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 ){. pNex
4d40: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 t = p->pNext;.
4d50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 sqlite3DbF
4d60: 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 ree(db, p);.
4d70: 20 20 20 20 70 20 3d 20 70 4e 65 78 74 3b 0a 20 p = pNext;.
4d80: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
4d90: 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 . for(i=sqliteH
4da0: 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 43 ashFirst(&db->aC
4db0: 6f 6c 6c 53 65 71 29 3b 20 69 3b 20 69 3d 73 71 ollSeq); i; i=sq
4dc0: 6c 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 liteHashNext(i))
4dd0: 7b 0a 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 {. CollSeq *p
4de0: 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 20 Coll = (CollSeq
4df0: 2a 29 73 71 6c 69 74 65 48 61 73 68 44 61 74 61 *)sqliteHashData
4e00: 28 69 29 3b 0a 20 20 20 20 2f 2a 20 49 6e 76 6f (i);. /* Invo
4e10: 6b 65 20 61 6e 79 20 64 65 73 74 72 75 63 74 6f ke any destructo
4e20: 72 73 20 72 65 67 69 73 74 65 72 65 64 20 66 6f rs registered fo
4e30: 72 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 r collation sequ
4e40: 65 6e 63 65 20 75 73 65 72 20 64 61 74 61 2e 20 ence user data.
4e50: 2a 2f 0a 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 */. for(j=0;
4e60: 6a 3c 33 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 j<3; j++){.
4e70: 20 69 66 28 20 70 43 6f 6c 6c 5b 6a 5d 2e 78 44 if( pColl[j].xD
4e80: 65 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 el ){. pC
4e90: 6f 6c 6c 5b 6a 5d 2e 78 44 65 6c 28 70 43 6f 6c oll[j].xDel(pCol
4ea0: 6c 5b 6a 5d 2e 70 55 73 65 72 29 3b 0a 20 20 20 l[j].pUser);.
4eb0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 }. }. s
4ec0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
4ed0: 20 70 43 6f 6c 6c 29 3b 0a 20 20 7d 0a 20 20 73 pColl);. }. s
4ee0: 71 6c 69 74 65 33 48 61 73 68 43 6c 65 61 72 28 qlite3HashClear(
4ef0: 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 3b 0a &db->aCollSeq);.
4f00: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
4f10: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
4f20: 0a 20 20 66 6f 72 28 69 3d 73 71 6c 69 74 65 48 . for(i=sqliteH
4f30: 61 73 68 46 69 72 73 74 28 26 64 62 2d 3e 61 4d ashFirst(&db->aM
4f40: 6f 64 75 6c 65 29 3b 20 69 3b 20 69 3d 73 71 6c odule); i; i=sql
4f50: 69 74 65 48 61 73 68 4e 65 78 74 28 69 29 29 7b iteHashNext(i)){
4f60: 0a 20 20 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f . Module *pMo
4f70: 64 20 3d 20 28 4d 6f 64 75 6c 65 20 2a 29 73 71 d = (Module *)sq
4f80: 6c 69 74 65 48 61 73 68 44 61 74 61 28 69 29 3b liteHashData(i);
4f90: 0a 20 20 20 20 69 66 28 20 70 4d 6f 64 2d 3e 78 . if( pMod->x
4fa0: 44 65 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 Destroy ){.
4fb0: 20 70 4d 6f 64 2d 3e 78 44 65 73 74 72 6f 79 28 pMod->xDestroy(
4fc0: 70 4d 6f 64 2d 3e 70 41 75 78 29 3b 0a 20 20 20 pMod->pAux);.
4fd0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 }. sqlite3Db
4fe0: 46 72 65 65 28 64 62 2c 20 70 4d 6f 64 29 3b 0a Free(db, pMod);.
4ff0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 48 61 73 }. sqlite3Has
5000: 68 43 6c 65 61 72 28 26 64 62 2d 3e 61 4d 6f 64 hClear(&db->aMod
5010: 75 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 ule);.#endif..
5020: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
5030: 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 20 SQLITE_OK, 0);
5040: 2f 2a 20 44 65 61 6c 6c 6f 63 61 74 65 73 20 61 /* Deallocates a
5050: 6e 79 20 63 61 63 68 65 64 20 65 72 72 6f 72 20 ny cached error
5060: 73 74 72 69 6e 67 73 2e 20 2a 2f 0a 20 20 69 66 strings. */. if
5070: 28 20 64 62 2d 3e 70 45 72 72 20 29 7b 0a 20 20 ( db->pErr ){.
5080: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 sqlite3ValueFr
5090: 65 65 28 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 ee(db->pErr);.
50a0: 7d 0a 20 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 }. sqlite3Close
50b0: 45 78 74 65 6e 73 69 6f 6e 73 28 64 62 29 3b 0a Extensions(db);.
50c0: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
50d0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f QLITE_MAGIC_ERRO
50e0: 52 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 74 65 6d R;.. /* The tem
50f0: 70 2d 64 61 74 61 62 61 73 65 20 73 63 68 65 6d p-database schem
5100: 61 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 64 a is allocated d
5110: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 ifferently from
5120: 74 68 65 20 6f 74 68 65 72 20 73 63 68 65 6d 61 the other schema
5130: 0a 20 20 2a 2a 20 6f 62 6a 65 63 74 73 20 28 75 . ** objects (u
5140: 73 69 6e 67 20 73 71 6c 69 74 65 4d 61 6c 6c 6f sing sqliteMallo
5150: 63 28 29 20 64 69 72 65 63 74 6c 79 2c 20 69 6e c() directly, in
5160: 73 74 65 61 64 20 6f 66 20 73 71 6c 69 74 65 33 stead of sqlite3
5170: 42 74 72 65 65 53 63 68 65 6d 61 28 29 29 2e 0a BtreeSchema())..
5180: 20 20 2a 2a 20 53 6f 20 69 74 20 6e 65 65 64 73 ** So it needs
5190: 20 74 6f 20 62 65 20 66 72 65 65 64 20 68 65 72 to be freed her
51a0: 65 2e 20 54 6f 64 6f 3a 20 57 68 79 20 6e 6f 74 e. Todo: Why not
51b0: 20 72 6f 6c 6c 20 74 68 65 20 74 65 6d 70 20 73 roll the temp s
51c0: 63 68 65 6d 61 20 69 6e 74 6f 0a 20 20 2a 2a 20 chema into. **
51d0: 74 68 65 20 73 61 6d 65 20 73 71 6c 69 74 65 4d the same sqliteM
51e0: 61 6c 6c 6f 63 28 29 20 61 73 20 74 68 65 20 6f alloc() as the o
51f0: 6e 65 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 65 ne that allocate
5200: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a s the database .
5210: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 3f 0a ** structure?.
5220: 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 44 62 */. sqlite3Db
5230: 46 72 65 65 28 64 62 2c 20 64 62 2d 3e 61 44 62 Free(db, db->aDb
5240: 5b 31 5d 2e 70 53 63 68 65 6d 61 29 3b 0a 20 20 [1].pSchema);.
5250: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
5260: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
5270: 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 db->magic = SQ
5280: 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 LITE_MAGIC_CLOSE
5290: 44 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 D;. sqlite3_mut
52a0: 65 78 5f 66 72 65 65 28 64 62 2d 3e 6d 75 74 65 ex_free(db->mute
52b0: 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 x);. assert( db
52c0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 6e 4f 75 74 ->lookaside.nOut
52d0: 3d 3d 30 20 29 3b 20 20 2f 2a 20 46 61 69 6c 73 ==0 ); /* Fails
52e0: 20 6f 6e 20 61 20 6c 6f 6f 6b 61 73 69 64 65 20 on a lookaside
52f0: 6d 65 6d 6f 72 79 20 6c 65 61 6b 20 2a 2f 0a 20 memory leak */.
5300: 20 69 66 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 if( db->lookasi
5310: 64 65 2e 62 4d 61 6c 6c 6f 63 65 64 20 29 7b 0a de.bMalloced ){.
5320: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
5330: 28 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 70 (db->lookaside.p
5340: 53 74 61 72 74 29 3b 0a 20 20 7d 0a 20 20 73 71 Start);. }. sq
5350: 6c 69 74 65 33 5f 66 72 65 65 28 64 62 29 3b 0a lite3_free(db);.
5360: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
5370: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c OK;.}../*.** Rol
5380: 6c 62 61 63 6b 20 61 6c 6c 20 64 61 74 61 62 61 lback all databa
5390: 73 65 20 66 69 6c 65 73 2e 0a 2a 2f 0a 76 6f 69 se files..*/.voi
53a0: 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 d sqlite3Rollbac
53b0: 6b 41 6c 6c 28 73 71 6c 69 74 65 33 20 2a 64 62 kAll(sqlite3 *db
53c0: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e ){. int i;. in
53d0: 74 20 69 6e 54 72 61 6e 73 20 3d 20 30 3b 0a 20 t inTrans = 0;.
53e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
53f0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e _mutex_held(db->
5400: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
5410: 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 te3BeginBenignMa
5420: 6c 6c 6f 63 28 29 3b 0a 20 20 66 6f 72 28 69 3d lloc();. for(i=
5430: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
5440: 2b 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e +){. if( db->
5450: 61 44 62 5b 69 5d 2e 70 42 74 20 29 7b 0a 20 20 aDb[i].pBt ){.
5460: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 if( sqlite3B
5470: 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 64 62 treeIsInTrans(db
5480: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 29 20 29 7b ->aDb[i].pBt) ){
5490: 0a 20 20 20 20 20 20 20 20 69 6e 54 72 61 6e 73 . inTrans
54a0: 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 1;. }.
54b0: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
54c0: 52 6f 6c 6c 62 61 63 6b 28 64 62 2d 3e 61 44 62 Rollback(db->aDb
54d0: 5b 69 5d 2e 70 42 74 29 3b 0a 20 20 20 20 20 20 [i].pBt);.
54e0: 64 62 2d 3e 61 44 62 5b 69 5d 2e 69 6e 54 72 61 db->aDb[i].inTra
54f0: 6e 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 ns = 0;. }.
5500: 7d 0a 20 20 73 71 6c 69 74 65 33 56 74 61 62 52 }. sqlite3VtabR
5510: 6f 6c 6c 62 61 63 6b 28 64 62 29 3b 0a 20 20 73 ollback(db);. s
5520: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
5530: 61 6c 6c 6f 63 28 29 3b 0a 0a 20 20 69 66 28 20 alloc();.. if(
5540: 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 db->flags&SQLITE
5550: 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 _InternChanges )
5560: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 {. sqlite3Exp
5570: 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
5580: 6d 65 6e 74 73 28 64 62 29 3b 0a 20 20 20 20 73 ments(db);. s
5590: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 qlite3ResetInter
55a0: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 nalSchema(db, 0)
55b0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 6e 79 20 ;. }.. /* Any
55c0: 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 deferred constra
55d0: 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 73 20 68 int violations h
55e0: 61 76 65 20 6e 6f 77 20 62 65 65 6e 20 72 65 73 ave now been res
55f0: 6f 6c 76 65 64 2e 20 2a 2f 0a 20 20 64 62 2d 3e olved. */. db->
5600: 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 20 3d 20 nDeferredCons =
5610: 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 6e 65 20 0;.. /* If one
5620: 68 61 73 20 62 65 65 6e 20 63 6f 6e 66 69 67 75 has been configu
5630: 72 65 64 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 red, invoke the
5640: 72 6f 6c 6c 62 61 63 6b 2d 68 6f 6f 6b 20 63 61 rollback-hook ca
5650: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 66 28 20 llback */. if(
5660: 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c db->xRollbackCal
5670: 6c 62 61 63 6b 20 26 26 20 28 69 6e 54 72 61 6e lback && (inTran
5680: 73 20 7c 7c 20 21 64 62 2d 3e 61 75 74 6f 43 6f s || !db->autoCo
5690: 6d 6d 69 74 29 20 29 7b 0a 20 20 20 20 64 62 2d mmit) ){. db-
56a0: 3e 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 >xRollbackCallba
56b0: 63 6b 28 64 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b ck(db->pRollback
56c0: 41 72 67 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a Arg);. }.}../*.
56d0: 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 74 61 74 ** Return a stat
56e0: 69 63 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 ic string that d
56f0: 65 73 63 72 69 62 65 73 20 74 68 65 20 6b 69 6e escribes the kin
5700: 64 20 6f 66 20 65 72 72 6f 72 20 73 70 65 63 69 d of error speci
5710: 66 69 65 64 20 69 6e 20 74 68 65 0a 2a 2a 20 61 fied in the.** a
5720: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 rgument..*/.cons
5730: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 t char *sqlite3E
5740: 72 72 53 74 72 28 69 6e 74 20 72 63 29 7b 0a 20 rrStr(int rc){.
5750: 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 static const ch
5760: 61 72 2a 20 63 6f 6e 73 74 20 61 4d 73 67 5b 5d ar* const aMsg[]
5770: 20 3d 20 7b 0a 20 20 20 20 2f 2a 20 53 51 4c 49 = {. /* SQLI
5780: 54 45 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 2a TE_OK *
5790: 2f 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 / "not an error"
57a0: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
57b0: 45 52 52 4f 52 20 20 20 20 20 20 20 2a 2f 20 22 ERROR */ "
57c0: 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f 72 20 SQL logic error
57d0: 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74 61 62 or missing datab
57e0: 61 73 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ase",. /* SQL
57f0: 49 54 45 5f 49 4e 54 45 52 4e 41 4c 20 20 20 20 ITE_INTERNAL
5800: 2a 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 53 51 4c */ 0,. /* SQL
5810: 49 54 45 5f 50 45 52 4d 20 20 20 20 20 20 20 20 ITE_PERM
5820: 2a 2f 20 22 61 63 63 65 73 73 20 70 65 72 6d 69 */ "access permi
5830: 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0a 20 ssion denied",.
5840: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 41 42 4f /* SQLITE_ABO
5850: 52 54 20 20 20 20 20 20 20 2a 2f 20 22 63 61 6c RT */ "cal
5860: 6c 62 61 63 6b 20 72 65 71 75 65 73 74 65 64 20 lback requested
5870: 71 75 65 72 79 20 61 62 6f 72 74 22 2c 0a 20 20 query abort",.
5880: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 /* SQLITE_BUSY
5890: 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61 */ "data
58a0: 62 61 73 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c base is locked",
58b0: 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4c . /* SQLITE_L
58c0: 4f 43 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 64 OCKED */ "d
58d0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73 atabase table is
58e0: 20 6c 6f 63 6b 65 64 22 2c 0a 20 20 20 20 2f 2a locked",. /*
58f0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 20 20 SQLITE_NOMEM
5900: 20 20 20 20 2a 2f 20 22 6f 75 74 20 6f 66 20 6d */ "out of m
5910: 65 6d 6f 72 79 22 2c 0a 20 20 20 20 2f 2a 20 53 emory",. /* S
5920: 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 20 20 QLITE_READONLY
5930: 20 20 2a 2f 20 22 61 74 74 65 6d 70 74 20 74 6f */ "attempt to
5940: 20 77 72 69 74 65 20 61 20 72 65 61 64 6f 6e 6c write a readonl
5950: 79 20 64 61 74 61 62 61 73 65 22 2c 0a 20 20 20 y database",.
5960: 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 /* SQLITE_INTER
5970: 52 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 72 RUPT */ "inter
5980: 72 75 70 74 65 64 22 2c 0a 20 20 20 20 2f 2a 20 rupted",. /*
5990: 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 20 20 20 SQLITE_IOERR
59a0: 20 20 20 2a 2f 20 22 64 69 73 6b 20 49 2f 4f 20 */ "disk I/O
59b0: 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 error",. /* S
59c0: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 20 20 QLITE_CORRUPT
59d0: 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 64 */ "database d
59e0: 69 73 6b 20 69 6d 61 67 65 20 69 73 20 6d 61 6c isk image is mal
59f0: 66 6f 72 6d 65 64 22 2c 0a 20 20 20 20 2f 2a 20 formed",. /*
5a00: 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 SQLITE_NOTFOUND
5a10: 20 20 20 2a 2f 20 30 2c 0a 20 20 20 20 2f 2a 20 */ 0,. /*
5a20: 53 51 4c 49 54 45 5f 46 55 4c 4c 20 20 20 20 20 SQLITE_FULL
5a30: 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20 */ "database
5a40: 6f 72 20 64 69 73 6b 20 69 73 20 66 75 6c 6c 22 or disk is full"
5a50: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
5a60: 43 41 4e 54 4f 50 45 4e 20 20 20 20 2a 2f 20 22 CANTOPEN */ "
5a70: 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 unable to open d
5a80: 61 74 61 62 61 73 65 20 66 69 6c 65 22 2c 0a 20 atabase file",.
5a90: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 4f /* SQLITE_PRO
5aa0: 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 30 2c 0a 20 TOCOL */ 0,.
5ab0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4d 50 /* SQLITE_EMP
5ac0: 54 59 20 20 20 20 20 20 20 2a 2f 20 22 74 61 62 TY */ "tab
5ad0: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 64 le contains no d
5ae0: 61 74 61 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c ata",. /* SQL
5af0: 49 54 45 5f 53 43 48 45 4d 41 20 20 20 20 20 20 ITE_SCHEMA
5b00: 2a 2f 20 22 64 61 74 61 62 61 73 65 20 73 63 68 */ "database sch
5b10: 65 6d 61 20 68 61 73 20 63 68 61 6e 67 65 64 22 ema has changed"
5b20: 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f ,. /* SQLITE_
5b30: 54 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f 20 22 TOOBIG */ "
5b40: 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 74 string or blob t
5b50: 6f 6f 20 62 69 67 22 2c 0a 20 20 20 20 2f 2a 20 oo big",. /*
5b60: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e SQLITE_CONSTRAIN
5b70: 54 20 20 2a 2f 20 22 63 6f 6e 73 74 72 61 69 6e T */ "constrain
5b80: 74 20 66 61 69 6c 65 64 22 2c 0a 20 20 20 20 2f t failed",. /
5b90: 2a 20 53 51 4c 49 54 45 5f 4d 49 53 4d 41 54 43 * SQLITE_MISMATC
5ba0: 48 20 20 20 20 2a 2f 20 22 64 61 74 61 74 79 70 H */ "datatyp
5bb0: 65 20 6d 69 73 6d 61 74 63 68 22 2c 0a 20 20 20 e mismatch",.
5bc0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 /* SQLITE_MISUS
5bd0: 45 20 20 20 20 20 20 2a 2f 20 22 6c 69 62 72 61 E */ "libra
5be0: 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65 ry routine calle
5bf0: 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e 63 d out of sequenc
5c00: 65 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 e",. /* SQLIT
5c10: 45 5f 4e 4f 4c 46 53 20 20 20 20 20 20 20 2a 2f E_NOLFS */
5c20: 20 22 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 "large file sup
5c30: 70 6f 72 74 20 69 73 20 64 69 73 61 62 6c 65 64 port is disabled
5c40: 22 2c 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 ",. /* SQLITE
5c50: 5f 41 55 54 48 20 20 20 20 20 20 20 20 2a 2f 20 _AUTH */
5c60: 22 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 64 "authorization d
5c70: 65 6e 69 65 64 22 2c 0a 20 20 20 20 2f 2a 20 53 enied",. /* S
5c80: 51 4c 49 54 45 5f 46 4f 52 4d 41 54 20 20 20 20 QLITE_FORMAT
5c90: 20 20 2a 2f 20 22 61 75 78 69 6c 69 61 72 79 20 */ "auxiliary
5ca0: 64 61 74 61 62 61 73 65 20 66 6f 72 6d 61 74 20 database format
5cb0: 65 72 72 6f 72 22 2c 0a 20 20 20 20 2f 2a 20 53 error",. /* S
5cc0: 51 4c 49 54 45 5f 52 41 4e 47 45 20 20 20 20 20 QLITE_RANGE
5cd0: 20 20 2a 2f 20 22 62 69 6e 64 20 6f 72 20 63 6f */ "bind or co
5ce0: 6c 75 6d 6e 20 69 6e 64 65 78 20 6f 75 74 20 6f lumn index out o
5cf0: 66 20 72 61 6e 67 65 22 2c 0a 20 20 20 20 2f 2a f range",. /*
5d00: 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 20 20 SQLITE_NOTADB
5d10: 20 20 20 20 2a 2f 20 22 66 69 6c 65 20 69 73 20 */ "file is
5d20: 65 6e 63 72 79 70 74 65 64 20 6f 72 20 69 73 20 encrypted or is
5d30: 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 22 2c not a database",
5d40: 0a 20 20 7d 3b 0a 20 20 72 63 20 26 3d 20 30 78 . };. rc &= 0x
5d50: 66 66 3b 0a 20 20 69 66 28 20 41 4c 57 41 59 53 ff;. if( ALWAYS
5d60: 28 72 63 3e 3d 30 29 20 26 26 20 72 63 3c 28 69 (rc>=0) && rc<(i
5d70: 6e 74 29 28 73 69 7a 65 6f 66 28 61 4d 73 67 29 nt)(sizeof(aMsg)
5d80: 2f 73 69 7a 65 6f 66 28 61 4d 73 67 5b 30 5d 29 /sizeof(aMsg[0])
5d90: 29 20 26 26 20 61 4d 73 67 5b 72 63 5d 21 3d 30 ) && aMsg[rc]!=0
5da0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 61 ){. return a
5db0: 4d 73 67 5b 72 63 5d 3b 0a 20 20 7d 65 6c 73 65 Msg[rc];. }else
5dc0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 22 75 6e {. return "un
5dd0: 6b 6e 6f 77 6e 20 65 72 72 6f 72 22 3b 0a 20 20 known error";.
5de0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 }.}../*.** This
5df0: 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e routine implemen
5e00: 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 61 ts a busy callba
5e10: 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 61 ck that sleeps a
5e20: 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 69 nd tries.** agai
5e30: 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f 75 n until a timeou
5e40: 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 68 t value is reach
5e50: 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 74 ed. The timeout
5e60: 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e 20 value is.** an
5e70: 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f integer number o
5e80: 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 70 f milliseconds p
5e90: 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 assed in as the
5ea0: 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e first.** argumen
5eb0: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
5ec0: 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 75 sqliteDefaultBu
5ed0: 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f 69 syCallback(. voi
5ee0: 64 20 2a 70 74 72 2c 20 20 20 20 20 20 20 20 20 d *ptr,
5ef0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 /* Databas
5f00: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a e connection */.
5f10: 20 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 int count
5f20: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
5f30: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 ber of times tab
5f40: 6c 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 le has been busy
5f50: 20 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 */.){.#if SQLIT
5f60: 45 5f 4f 53 5f 57 49 4e 20 7c 7c 20 28 64 65 66 E_OS_WIN || (def
5f70: 69 6e 65 64 28 48 41 56 45 5f 55 53 4c 45 45 50 ined(HAVE_USLEEP
5f80: 29 20 26 26 20 48 41 56 45 5f 55 53 4c 45 45 50 ) && HAVE_USLEEP
5f90: 29 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 ). static const
5fa0: 20 75 38 20 64 65 6c 61 79 73 5b 5d 20 3d 0a 20 u8 delays[] =.
5fb0: 20 20 20 20 7b 20 31 2c 20 32 2c 20 35 2c 20 31 { 1, 2, 5, 1
5fc0: 30 2c 20 31 35 2c 20 32 30 2c 20 32 35 2c 20 32 0, 15, 20, 25, 2
5fd0: 35 2c 20 20 32 35 2c 20 20 35 30 2c 20 20 35 30 5, 25, 50, 50
5fe0: 2c 20 31 30 30 20 7d 3b 0a 20 20 73 74 61 74 69 , 100 };. stati
5ff0: 63 20 63 6f 6e 73 74 20 75 38 20 74 6f 74 61 6c c const u8 total
6000: 73 5b 5d 20 3d 0a 20 20 20 20 20 7b 20 30 2c 20 s[] =. { 0,
6010: 31 2c 20 33 2c 20 20 38 2c 20 31 38 2c 20 33 33 1, 3, 8, 18, 33
6020: 2c 20 35 33 2c 20 37 38 2c 20 31 30 33 2c 20 31 , 53, 78, 103, 1
6030: 32 38 2c 20 31 37 38 2c 20 32 32 38 20 7d 3b 0a 28, 178, 228 };.
6040: 23 20 64 65 66 69 6e 65 20 4e 44 45 4c 41 59 20 # define NDELAY
6050: 28 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 29 2f (sizeof(delays)/
6060: 73 69 7a 65 6f 66 28 64 65 6c 61 79 73 5b 30 5d sizeof(delays[0]
6070: 29 29 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 )). sqlite3 *db
6080: 20 3d 20 28 73 71 6c 69 74 65 33 20 2a 29 70 74 = (sqlite3 *)pt
6090: 72 3b 0a 20 20 69 6e 74 20 74 69 6d 65 6f 75 74 r;. int timeout
60a0: 20 3d 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f = db->busyTimeo
60b0: 75 74 3b 0a 20 20 69 6e 74 20 64 65 6c 61 79 2c ut;. int delay,
60c0: 20 70 72 69 6f 72 3b 0a 0a 20 20 61 73 73 65 72 prior;.. asser
60d0: 74 28 20 63 6f 75 6e 74 3e 3d 30 20 29 3b 0a 20 t( count>=0 );.
60e0: 20 69 66 28 20 63 6f 75 6e 74 20 3c 20 4e 44 45 if( count < NDE
60f0: 4c 41 59 20 29 7b 0a 20 20 20 20 64 65 6c 61 79 LAY ){. delay
6100: 20 3d 20 64 65 6c 61 79 73 5b 63 6f 75 6e 74 5d = delays[count]
6110: 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 74 6f ;. prior = to
6120: 74 61 6c 73 5b 63 6f 75 6e 74 5d 3b 0a 20 20 7d tals[count];. }
6130: 65 6c 73 65 7b 0a 20 20 20 20 64 65 6c 61 79 20 else{. delay
6140: 3d 20 64 65 6c 61 79 73 5b 4e 44 45 4c 41 59 2d = delays[NDELAY-
6150: 31 5d 3b 0a 20 20 20 20 70 72 69 6f 72 20 3d 20 1];. prior =
6160: 74 6f 74 61 6c 73 5b 4e 44 45 4c 41 59 2d 31 5d totals[NDELAY-1]
6170: 20 2b 20 64 65 6c 61 79 2a 28 63 6f 75 6e 74 2d + delay*(count-
6180: 28 4e 44 45 4c 41 59 2d 31 29 29 3b 0a 20 20 7d (NDELAY-1));. }
6190: 0a 20 20 69 66 28 20 70 72 69 6f 72 20 2b 20 64 . if( prior + d
61a0: 65 6c 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 elay > timeout )
61b0: 7b 0a 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 {. delay = ti
61c0: 6d 65 6f 75 74 20 2d 20 70 72 69 6f 72 3b 0a 20 meout - prior;.
61d0: 20 20 20 69 66 28 20 64 65 6c 61 79 3c 3d 30 20 if( delay<=0
61e0: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a ) return 0;. }.
61f0: 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 sqlite3OsSleep
6200: 28 64 62 2d 3e 70 56 66 73 2c 20 64 65 6c 61 79 (db->pVfs, delay
6210: 2a 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e *1000);. return
6220: 20 31 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c 69 1;.#else. sqli
6230: 74 65 33 20 2a 64 62 20 3d 20 28 73 71 6c 69 74 te3 *db = (sqlit
6240: 65 33 20 2a 29 70 74 72 3b 0a 20 20 69 6e 74 20 e3 *)ptr;. int
6250: 74 69 6d 65 6f 75 74 20 3d 20 28 28 73 71 6c 69 timeout = ((sqli
6260: 74 65 33 20 2a 29 70 74 72 29 2d 3e 62 75 73 79 te3 *)ptr)->busy
6270: 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 28 20 28 Timeout;. if( (
6280: 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 20 3e 20 count+1)*1000 >
6290: 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 20 20 72 timeout ){. r
62a0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 73 eturn 0;. }. s
62b0: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 28 64 62 qlite3OsSleep(db
62c0: 2d 3e 70 56 66 73 2c 20 31 30 30 30 30 30 30 29 ->pVfs, 1000000)
62d0: 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 ;. return 1;.#e
62e0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e ndif.}../*.** In
62f0: 76 6f 6b 65 20 74 68 65 20 67 69 76 65 6e 20 62 voke the given b
6300: 75 73 79 20 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a usy handler..**.
6310: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
6320: 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 is called when a
6330: 6e 20 6f 70 65 72 61 74 69 6f 6e 20 66 61 69 6c n operation fail
6340: 65 64 20 77 69 74 68 20 61 20 6c 6f 63 6b 2e 0a ed with a lock..
6350: 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75 74 69 ** If this routi
6360: 6e 65 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a ne returns non-z
6370: 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b 20 69 73 ero, the lock is
6380: 20 72 65 74 72 69 65 64 2e 20 20 49 66 20 69 74 retried. If it
6390: 0a 2a 2a 20 72 65 74 75 72 6e 73 20 30 2c 20 74 .** returns 0, t
63a0: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 62 6f he operation abo
63b0: 72 74 73 20 77 69 74 68 20 61 6e 20 53 51 4c 49 rts with an SQLI
63c0: 54 45 5f 42 55 53 59 20 65 72 72 6f 72 2e 0a 2a TE_BUSY error..*
63d0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 /.int sqlite3Inv
63e0: 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 42 okeBusyHandler(B
63f0: 75 73 79 48 61 6e 64 6c 65 72 20 2a 70 29 7b 0a usyHandler *p){.
6400: 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 int rc;. if(
6410: 4e 45 56 45 52 28 70 3d 3d 30 29 20 7c 7c 20 70 NEVER(p==0) || p
6420: 2d 3e 78 46 75 6e 63 3d 3d 30 20 7c 7c 20 70 2d ->xFunc==0 || p-
6430: 3e 6e 42 75 73 79 3c 30 20 29 20 72 65 74 75 72 >nBusy<0 ) retur
6440: 6e 20 30 3b 0a 20 20 72 63 20 3d 20 70 2d 3e 78 n 0;. rc = p->x
6450: 46 75 6e 63 28 70 2d 3e 70 41 72 67 2c 20 70 2d Func(p->pArg, p-
6460: 3e 6e 42 75 73 79 29 3b 0a 20 20 69 66 28 20 72 >nBusy);. if( r
6470: 63 3d 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 6e c==0 ){. p->n
6480: 42 75 73 79 20 3d 20 2d 31 3b 0a 20 20 7d 65 6c Busy = -1;. }el
6490: 73 65 7b 0a 20 20 20 20 70 2d 3e 6e 42 75 73 79 se{. p->nBusy
64a0: 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ++;. }. return
64b0: 20 72 63 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 rc; .}../*.** T
64c0: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73 his routine sets
64d0: 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 the busy callba
64e0: 63 6b 20 66 6f 72 20 61 6e 20 53 71 6c 69 74 65 ck for an Sqlite
64f0: 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68 65 database to the
6500: 0a 2a 2a 20 67 69 76 65 6e 20 63 61 6c 6c 62 61 .** given callba
6510: 63 6b 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 ck function with
6520: 20 74 68 65 20 67 69 76 65 6e 20 61 72 67 75 6d the given argum
6530: 65 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ent..*/.int sqli
6540: 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 te3_busy_handler
6550: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
6560: 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 79 29 28 . int (*xBusy)(
6570: 76 6f 69 64 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f void*,int),. vo
6580: 69 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 73 71 id *pArg.){. sq
6590: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
65a0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
65b0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e db->busyHandler.
65c0: 78 46 75 6e 63 20 3d 20 78 42 75 73 79 3b 0a 20 xFunc = xBusy;.
65d0: 20 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 db->busyHandler
65e0: 2e 70 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 .pArg = pArg;.
65f0: 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 2e db->busyHandler.
6600: 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 73 71 6c nBusy = 0;. sql
6610: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
6620: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
6630: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
6640: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
6650: 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 TE_OMIT_PROGRESS
6660: 5f 43 41 4c 4c 42 41 43 4b 0a 2f 2a 0a 2a 2a 20 _CALLBACK./*.**
6670: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 This routine set
6680: 73 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 s the progress c
6690: 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 allback for an S
66a0: 71 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 qlite database t
66b0: 6f 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 o the.** given c
66c0: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e allback function
66d0: 20 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 with the given
66e0: 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 20 70 72 argument. The pr
66f0: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 ogress callback
6700: 77 69 6c 6c 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b will.** be invok
6710: 65 64 20 65 76 65 72 79 20 6e 4f 70 73 20 6f 70 ed every nOps op
6720: 63 6f 64 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 codes..*/.void s
6730: 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f qlite3_progress_
6740: 68 61 6e 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 handler(. sqlit
6750: 65 33 20 2a 64 62 2c 20 0a 20 20 69 6e 74 20 6e e3 *db, . int n
6760: 4f 70 73 2c 0a 20 20 69 6e 74 20 28 2a 78 50 72 Ops,. int (*xPr
6770: 6f 67 72 65 73 73 29 28 76 6f 69 64 2a 29 2c 20 ogress)(void*),
6780: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 0a 29 7b . void *pArg.){
6790: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
67a0: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
67b0: 29 3b 0a 20 20 69 66 28 20 6e 4f 70 73 3e 30 20 );. if( nOps>0
67c0: 29 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 6f 67 ){. db->xProg
67d0: 72 65 73 73 20 3d 20 78 50 72 6f 67 72 65 73 73 ress = xProgress
67e0: 3b 0a 20 20 20 20 64 62 2d 3e 6e 50 72 6f 67 72 ;. db->nProgr
67f0: 65 73 73 4f 70 73 20 3d 20 6e 4f 70 73 3b 0a 20 essOps = nOps;.
6800: 20 20 20 64 62 2d 3e 70 50 72 6f 67 72 65 73 73 db->pProgress
6810: 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 7d 65 Arg = pArg;. }e
6820: 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e 78 50 72 lse{. db->xPr
6830: 6f 67 72 65 73 73 20 3d 20 30 3b 0a 20 20 20 20 ogress = 0;.
6840: 64 62 2d 3e 6e 50 72 6f 67 72 65 73 73 4f 70 73 db->nProgressOps
6850: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 50 = 0;. db->pP
6860: 72 6f 67 72 65 73 73 41 72 67 20 3d 20 30 3b 0a rogressArg = 0;.
6870: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
6880: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
6890: 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a tex);.}.#endif..
68a0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ./*.** This rout
68b0: 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 64 ine installs a d
68c0: 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e 64 efault busy hand
68d0: 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 66 ler that waits f
68e0: 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 or the.** specif
68f0: 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 ied number of mi
6900: 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 lliseconds befor
6910: 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a 2a e returning 0..*
6920: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 75 /.int sqlite3_bu
6930: 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 74 sy_timeout(sqlit
6940: 65 33 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b e3 *db, int ms){
6950: 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 . if( ms>0 ){.
6960: 20 20 20 64 62 2d 3e 62 75 73 79 54 69 6d 65 6f db->busyTimeo
6970: 75 74 20 3d 20 6d 73 3b 0a 20 20 20 20 73 71 6c ut = ms;. sql
6980: 69 74 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 ite3_busy_handle
6990: 72 28 64 62 2c 20 73 71 6c 69 74 65 44 65 66 61 r(db, sqliteDefa
69a0: 75 6c 74 42 75 73 79 43 61 6c 6c 62 61 63 6b 2c ultBusyCallback,
69b0: 20 28 76 6f 69 64 2a 29 64 62 29 3b 0a 20 20 7d (void*)db);. }
69c0: 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 else{. sqlite
69d0: 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28 64 3_busy_handler(d
69e0: 62 2c 20 30 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 b, 0, 0);. }.
69f0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
6a00: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 ;.}../*.** Cause
6a10: 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 any pending ope
6a20: 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 ration to stop a
6a30: 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f t its earliest o
6a40: 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 pportunity..*/.v
6a50: 6f 69 64 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 oid sqlite3_inte
6a60: 72 72 75 70 74 28 73 71 6c 69 74 65 33 20 2a 64 rrupt(sqlite3 *d
6a70: 62 29 7b 0a 20 20 64 62 2d 3e 75 31 2e 69 73 49 b){. db->u1.isI
6a80: 6e 74 65 72 72 75 70 74 65 64 20 3d 20 31 3b 0a nterrupted = 1;.
6a90: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 }.../*.** This f
6aa0: 75 6e 63 74 69 6f 6e 20 69 73 20 65 78 61 63 74 unction is exact
6ab0: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 ly the same as s
6ac0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 qlite3_create_fu
6ad0: 6e 63 74 69 6f 6e 28 29 2c 20 65 78 63 65 70 74 nction(), except
6ae0: 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 20 64 .** that it is d
6af0: 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61 esigned to be ca
6b00: 6c 6c 65 64 20 62 79 20 69 6e 74 65 72 6e 61 6c lled by internal
6b10: 20 63 6f 64 65 2e 20 54 68 65 20 64 69 66 66 65 code. The diffe
6b20: 72 65 6e 63 65 20 69 73 0a 2a 2a 20 74 68 61 74 rence is.** that
6b30: 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 if a malloc() f
6b40: 61 69 6c 73 20 69 6e 20 73 71 6c 69 74 65 33 5f ails in sqlite3_
6b50: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28 create_function(
6b60: 29 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ), an error code
6b70: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 20 .** is returned
6b80: 61 6e 64 20 74 68 65 20 6d 61 6c 6c 6f 63 46 61 and the mallocFa
6b90: 69 6c 65 64 20 66 6c 61 67 20 63 6c 65 61 72 65 iled flag cleare
6ba0: 64 2e 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 d. .*/.int sqlit
6bb0: 65 33 43 72 65 61 74 65 46 75 6e 63 28 0a 20 20 e3CreateFunc(.
6bc0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 sqlite3 *db,. c
6bd0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 75 6e 63 onst char *zFunc
6be0: 74 69 6f 6e 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 tionName,. int
6bf0: 6e 41 72 67 2c 0a 20 20 69 6e 74 20 65 6e 63 2c nArg,. int enc,
6c00: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 . void *pUserDa
6c10: 74 61 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 75 ta,. void (*xFu
6c20: 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 nc)(sqlite3_cont
6c30: 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
6c40: 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
6c50: 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c 69 id (*xStep)(sqli
6c60: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
6c70: 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
6c80: 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 *),. void (*xFi
6c90: 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e nal)(sqlite3_con
6ca0: 74 65 78 74 2a 29 0a 29 7b 0a 20 20 46 75 6e 63 text*).){. Func
6cb0: 44 65 66 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 4e Def *p;. int nN
6cc0: 61 6d 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ame;.. assert(
6cd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
6ce0: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
6cf0: 0a 20 20 69 66 28 20 7a 46 75 6e 63 74 69 6f 6e . if( zFunction
6d00: 4e 61 6d 65 3d 3d 30 20 7c 7c 0a 20 20 20 20 20 Name==0 ||.
6d10: 20 28 78 46 75 6e 63 20 26 26 20 28 78 46 69 6e (xFunc && (xFin
6d20: 61 6c 20 7c 7c 20 78 53 74 65 70 29 29 20 7c 7c al || xStep)) ||
6d30: 20 0a 20 20 20 20 20 20 28 21 78 46 75 6e 63 20 . (!xFunc
6d40: 26 26 20 28 78 46 69 6e 61 6c 20 26 26 20 21 78 && (xFinal && !x
6d50: 53 74 65 70 29 29 20 7c 7c 0a 20 20 20 20 20 20 Step)) ||.
6d60: 28 21 78 46 75 6e 63 20 26 26 20 28 21 78 46 69 (!xFunc && (!xFi
6d70: 6e 61 6c 20 26 26 20 78 53 74 65 70 29 29 20 7c nal && xStep)) |
6d80: 7c 0a 20 20 20 20 20 20 28 6e 41 72 67 3c 2d 31 |. (nArg<-1
6d90: 20 7c 7c 20 6e 41 72 67 3e 53 51 4c 49 54 45 5f || nArg>SQLITE_
6da0: 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 MAX_FUNCTION_ARG
6db0: 29 20 7c 7c 0a 20 20 20 20 20 20 28 32 35 35 3c ) ||. (255<
6dc0: 28 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 (nName = sqlite3
6dd0: 53 74 72 6c 65 6e 33 30 28 20 7a 46 75 6e 63 74 Strlen30( zFunct
6de0: 69 6f 6e 4e 61 6d 65 29 29 29 20 29 7b 0a 20 20 ionName))) ){.
6df0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
6e00: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 0a 23 MISUSE;. }. .#
6e10: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
6e20: 49 54 5f 55 54 46 31 36 0a 20 20 2f 2a 20 49 66 IT_UTF16. /* If
6e30: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 20 69 73 SQLITE_UTF16 is
6e40: 20 73 70 65 63 69 66 69 65 64 20 61 73 20 74 68 specified as th
6e50: 65 20 65 6e 63 6f 64 69 6e 67 20 74 79 70 65 2c e encoding type,
6e60: 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 69 73 0a transform this.
6e70: 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 6f 66 20 53 ** to one of S
6e80: 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 20 6f 72 QLITE_UTF16LE or
6e90: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 SQLITE_UTF16BE
6ea0: 75 73 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 53 using the. ** S
6eb0: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
6ec0: 45 20 6d 61 63 72 6f 2e 20 53 51 4c 49 54 45 5f E macro. SQLITE_
6ed0: 55 54 46 31 36 20 69 73 20 6e 6f 74 20 75 73 65 UTF16 is not use
6ee0: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 20 20 d internally..
6ef0: 2a 2a 0a 20 20 2a 2a 20 49 66 20 53 51 4c 49 54 **. ** If SQLIT
6f00: 45 5f 41 4e 59 20 69 73 20 73 70 65 63 69 66 69 E_ANY is specifi
6f10: 65 64 2c 20 61 64 64 20 74 68 72 65 65 20 76 65 ed, add three ve
6f20: 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 75 rsions of the fu
6f30: 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 74 nction. ** to t
6f40: 68 65 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 20 he hash table..
6f50: 20 2a 2f 0a 20 20 69 66 28 20 65 6e 63 3d 3d 53 */. if( enc==S
6f60: 51 4c 49 54 45 5f 55 54 46 31 36 20 29 7b 0a 20 QLITE_UTF16 ){.
6f70: 20 20 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f enc = SQLITE_
6f80: 55 54 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d UTF16NATIVE;. }
6f90: 65 6c 73 65 20 69 66 28 20 65 6e 63 3d 3d 53 51 else if( enc==SQ
6fa0: 4c 49 54 45 5f 41 4e 59 20 29 7b 0a 20 20 20 20 LITE_ANY ){.
6fb0: 69 6e 74 20 72 63 3b 0a 20 20 20 20 72 63 20 3d int rc;. rc =
6fc0: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
6fd0: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e nc(db, zFunction
6fe0: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 51 4c 49 Name, nArg, SQLI
6ff0: 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 20 20 20 TE_UTF8,.
7000: 20 20 70 55 73 65 72 44 61 74 61 2c 20 78 46 75 pUserData, xFu
7010: 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 nc, xStep, xFina
7020: 6c 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d l);. if( rc==
7030: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
7040: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 43 rc = sqlite3C
7050: 72 65 61 74 65 46 75 6e 63 28 64 62 2c 20 7a 46 reateFunc(db, zF
7060: 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c 20 6e 41 72 unctionName, nAr
7070: 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c g, SQLITE_UTF16L
7080: 45 2c 0a 20 20 20 20 20 20 20 20 20 20 70 55 73 E,. pUs
7090: 65 72 44 61 74 61 2c 20 78 46 75 6e 63 2c 20 78 erData, xFunc, x
70a0: 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 Step, xFinal);.
70b0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21 }. if( rc!
70c0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
70d0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
70e0: 20 20 20 7d 0a 20 20 20 20 65 6e 63 20 3d 20 53 }. enc = S
70f0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3b 0a 20 QLITE_UTF16BE;.
7100: 20 7d 0a 23 65 6c 73 65 0a 20 20 65 6e 63 20 3d }.#else. enc =
7110: 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23 65 SQLITE_UTF8;.#e
7120: 6e 64 69 66 0a 20 20 0a 20 20 2f 2a 20 43 68 65 ndif. . /* Che
7130: 63 6b 20 69 66 20 61 6e 20 65 78 69 73 74 69 6e ck if an existin
7140: 67 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 62 65 g function is be
7150: 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e 20 6f ing overridden o
7160: 72 20 64 65 6c 65 74 65 64 2e 20 49 66 20 73 6f r deleted. If so
7170: 2c 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 72 65 ,. ** and there
7180: 20 61 72 65 20 61 63 74 69 76 65 20 56 4d 73 2c are active VMs,
7190: 20 74 68 65 6e 20 72 65 74 75 72 6e 20 53 51 4c then return SQL
71a0: 49 54 45 5f 42 55 53 59 2e 20 49 66 20 61 20 66 ITE_BUSY. If a f
71b0: 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 unction. ** is
71c0: 62 65 69 6e 67 20 6f 76 65 72 72 69 64 64 65 6e being overridden
71d0: 2f 64 65 6c 65 74 65 64 20 62 75 74 20 74 68 65 /deleted but the
71e0: 72 65 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 re are no active
71f0: 20 56 4d 73 2c 20 61 6c 6c 6f 77 20 74 68 65 0a VMs, allow the.
7200: 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 74 ** operation t
7210: 6f 20 63 6f 6e 74 69 6e 75 65 20 62 75 74 20 69 o continue but i
7220: 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c 20 70 72 nvalidate all pr
7230: 65 63 6f 6d 70 69 6c 65 64 20 73 74 61 74 65 6d ecompiled statem
7240: 65 6e 74 73 2e 0a 20 20 2a 2f 0a 20 20 70 20 3d ents.. */. p =
7250: 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 sqlite3FindFunc
7260: 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 74 69 tion(db, zFuncti
7270: 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e onName, nName, n
7280: 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 30 29 Arg, (u8)enc, 0)
7290: 3b 0a 20 20 69 66 28 20 70 20 26 26 20 70 2d 3e ;. if( p && p->
72a0: 69 50 72 65 66 45 6e 63 3d 3d 65 6e 63 20 26 26 iPrefEnc==enc &&
72b0: 20 70 2d 3e 6e 41 72 67 3d 3d 6e 41 72 67 20 29 p->nArg==nArg )
72c0: 7b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61 63 {. if( db->ac
72d0: 74 69 76 65 56 64 62 65 43 6e 74 20 29 7b 0a 20 tiveVdbeCnt ){.
72e0: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
72f0: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 42 55 53 r(db, SQLITE_BUS
7300: 59 2c 20 0a 20 20 20 20 20 20 20 20 22 75 6e 61 Y, . "una
7310: 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 2f 6d 6f ble to delete/mo
7320: 64 69 66 79 20 75 73 65 72 2d 66 75 6e 63 74 69 dify user-functi
7330: 6f 6e 20 64 75 65 20 74 6f 20 61 63 74 69 76 65 on due to active
7340: 20 73 74 61 74 65 6d 65 6e 74 73 22 29 3b 0a 20 statements");.
7350: 20 20 20 20 20 61 73 73 65 72 74 28 20 21 64 62 assert( !db
7360: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
7370: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 ;. return S
7380: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 QLITE_BUSY;.
7390: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c }else{. sql
73a0: 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 ite3ExpirePrepar
73b0: 65 64 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 edStatements(db)
73c0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 ;. }. }.. p
73d0: 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 46 75 = sqlite3FindFu
73e0: 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 46 75 6e 63 nction(db, zFunc
73f0: 74 69 6f 6e 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2c tionName, nName,
7400: 20 6e 41 72 67 2c 20 28 75 38 29 65 6e 63 2c 20 nArg, (u8)enc,
7410: 31 29 3b 0a 20 20 61 73 73 65 72 74 28 70 20 7c 1);. assert(p |
7420: 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c | db->mallocFail
7430: 65 64 29 3b 0a 20 20 69 66 28 20 21 70 20 29 7b ed);. if( !p ){
7440: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
7450: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 TE_NOMEM;. }.
7460: 70 2d 3e 66 6c 61 67 73 20 3d 20 30 3b 0a 20 20 p->flags = 0;.
7470: 70 2d 3e 78 46 75 6e 63 20 3d 20 78 46 75 6e 63 p->xFunc = xFunc
7480: 3b 0a 20 20 70 2d 3e 78 53 74 65 70 20 3d 20 78 ;. p->xStep = x
7490: 53 74 65 70 3b 0a 20 20 70 2d 3e 78 46 69 6e 61 Step;. p->xFina
74a0: 6c 69 7a 65 20 3d 20 78 46 69 6e 61 6c 3b 0a 20 lize = xFinal;.
74b0: 20 70 2d 3e 70 55 73 65 72 44 61 74 61 20 3d 20 p->pUserData =
74c0: 70 55 73 65 72 44 61 74 61 3b 0a 20 20 70 2d 3e pUserData;. p->
74d0: 6e 41 72 67 20 3d 20 28 75 31 36 29 6e 41 72 67 nArg = (u16)nArg
74e0: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
74f0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 E_OK;.}../*.** C
7500: 72 65 61 74 65 20 6e 65 77 20 75 73 65 72 20 66 reate new user f
7510: 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 unctions..*/.int
7520: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
7530: 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 6c 69 function(. sqli
7540: 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e 73 74 te3 *db,. const
7550: 20 63 68 61 72 20 2a 7a 46 75 6e 63 74 69 6f 6e char *zFunction
7560: 4e 61 6d 65 2c 0a 20 20 69 6e 74 20 6e 41 72 67 Name,. int nArg
7570: 2c 0a 20 20 69 6e 74 20 65 6e 63 2c 0a 20 20 76 ,. int enc,. v
7580: 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 oid *p,. void (
7590: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f *xFunc)(sqlite3_
75a0: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
75b0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a ite3_value **),.
75c0: 20 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 void (*xStep)(
75d0: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
75e0: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
75f0: 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 ue **),. void (
7600: 2a 78 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 *xFinal)(sqlite3
7610: 5f 63 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 _context*).){.
7620: 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 int rc;. sqlite
7630: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
7640: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 63 20 3d ->mutex);. rc =
7650: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
7660: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e nc(db, zFunction
7670: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 65 6e 63 2c Name, nArg, enc,
7680: 20 70 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 p, xFunc, xStep
7690: 2c 20 78 46 69 6e 61 6c 29 3b 0a 20 20 72 63 20 , xFinal);. rc
76a0: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 = sqlite3ApiExit
76b0: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69 (db, rc);. sqli
76c0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
76d0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
76e0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e turn rc;.}..#ifn
76f0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
7700: 55 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 UTF16.int sqlite
7710: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 3_create_functio
7720: 6e 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a n16(. sqlite3 *
7730: 64 62 2c 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 db,. const void
7740: 20 2a 7a 46 75 6e 63 74 69 6f 6e 4e 61 6d 65 2c *zFunctionName,
7750: 0a 20 20 69 6e 74 20 6e 41 72 67 2c 0a 20 20 69 . int nArg,. i
7760: 6e 74 20 65 54 65 78 74 52 65 70 2c 0a 20 20 76 nt eTextRep,. v
7770: 6f 69 64 20 2a 70 2c 0a 20 20 76 6f 69 64 20 28 oid *p,. void (
7780: 2a 78 46 75 6e 63 29 28 73 71 6c 69 74 65 33 5f *xFunc)(sqlite3_
7790: 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
77a0: 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 2c 0a 20 ite3_value**),.
77b0: 20 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 void (*xStep)(s
77c0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
77d0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
77e0: 65 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 78 e**),. void (*x
77f0: 46 69 6e 61 6c 29 28 73 71 6c 69 74 65 33 5f 63 Final)(sqlite3_c
7800: 6f 6e 74 65 78 74 2a 29 0a 29 7b 0a 20 20 69 6e ontext*).){. in
7810: 74 20 72 63 3b 0a 20 20 63 68 61 72 20 2a 7a 46 t rc;. char *zF
7820: 75 6e 63 38 3b 0a 20 20 73 71 6c 69 74 65 33 5f unc8;. sqlite3_
7830: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
7840: 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 mutex);. assert
7850: 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 ( !db->mallocFai
7860: 6c 65 64 20 29 3b 0a 20 20 7a 46 75 6e 63 38 20 led );. zFunc8
7870: 3d 20 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f = sqlite3Utf16to
7880: 38 28 64 62 2c 20 7a 46 75 6e 63 74 69 6f 6e 4e 8(db, zFunctionN
7890: 61 6d 65 2c 20 2d 31 29 3b 0a 20 20 72 63 20 3d ame, -1);. rc =
78a0: 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 46 75 sqlite3CreateFu
78b0: 6e 63 28 64 62 2c 20 7a 46 75 6e 63 38 2c 20 6e nc(db, zFunc8, n
78c0: 41 72 67 2c 20 65 54 65 78 74 52 65 70 2c 20 70 Arg, eTextRep, p
78d0: 2c 20 78 46 75 6e 63 2c 20 78 53 74 65 70 2c 20 , xFunc, xStep,
78e0: 78 46 69 6e 61 6c 29 3b 0a 20 20 73 71 6c 69 74 xFinal);. sqlit
78f0: 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 46 75 e3DbFree(db, zFu
7900: 6e 63 38 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c nc8);. rc = sql
7910: 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 ite3ApiExit(db,
7920: 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc);. sqlite3_m
7930: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
7940: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
7950: 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f rc;.}.#endif.../
7960: 2a 0a 2a 2a 20 44 65 63 6c 61 72 65 20 74 68 61 *.** Declare tha
7970: 74 20 61 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 t a function has
7980: 20 62 65 65 6e 20 6f 76 65 72 6c 6f 61 64 65 64 been overloaded
7990: 20 62 79 20 61 20 76 69 72 74 75 61 6c 20 74 61 by a virtual ta
79a0: 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ble..**.** If th
79b0: 65 20 66 75 6e 63 74 69 6f 6e 20 61 6c 72 65 61 e function alrea
79c0: 64 79 20 65 78 69 73 74 73 20 61 73 20 61 20 72 dy exists as a r
79d0: 65 67 75 6c 61 72 20 67 6c 6f 62 61 6c 20 66 75 egular global fu
79e0: 6e 63 74 69 6f 6e 2c 20 74 68 65 6e 0a 2a 2a 20 nction, then.**
79f0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
7a00: 61 20 6e 6f 2d 6f 70 2e 20 20 49 66 20 74 68 65 a no-op. If the
7a10: 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e function does n
7a20: 6f 74 20 65 78 69 73 74 2c 20 74 68 65 6e 20 63 ot exist, then c
7a30: 72 65 61 74 65 0a 2a 2a 20 61 20 6e 65 77 20 6f reate.** a new o
7a40: 6e 65 20 74 68 61 74 20 61 6c 77 61 79 73 20 74 ne that always t
7a50: 68 72 6f 77 73 20 61 20 72 75 6e 2d 74 69 6d 65 hrows a run-time
7a60: 20 65 72 72 6f 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 error. .**.**
7a70: 57 68 65 6e 20 76 69 72 74 75 61 6c 20 74 61 62 When virtual tab
7a80: 6c 65 73 20 69 6e 74 65 6e 64 20 74 6f 20 70 72 les intend to pr
7a90: 6f 76 69 64 65 20 61 6e 20 6f 76 65 72 6c 6f 61 ovide an overloa
7aa0: 64 65 64 20 66 75 6e 63 74 69 6f 6e 2c 20 74 68 ded function, th
7ab0: 65 79 0a 2a 2a 20 73 68 6f 75 6c 64 20 63 61 6c ey.** should cal
7ac0: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 l this routine t
7ad0: 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 o make sure the
7ae0: 67 6c 6f 62 61 6c 20 66 75 6e 63 74 69 6f 6e 20 global function
7af0: 65 78 69 73 74 73 2e 0a 2a 2a 20 41 20 67 6c 6f exists..** A glo
7b00: 62 61 6c 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 bal function mus
7b10: 74 20 65 78 69 73 74 20 69 6e 20 6f 72 64 65 72 t exist in order
7b20: 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75 for name resolu
7b30: 74 69 6f 6e 20 74 6f 20 77 6f 72 6b 0a 2a 2a 20 tion to work.**
7b40: 70 72 6f 70 65 72 6c 79 2e 0a 2a 2f 0a 69 6e 74 properly..*/.int
7b50: 20 73 71 6c 69 74 65 33 5f 6f 76 65 72 6c 6f 61 sqlite3_overloa
7b60: 64 5f 66 75 6e 63 74 69 6f 6e 28 0a 20 20 73 71 d_function(. sq
7b70: 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 63 6f 6e lite3 *db,. con
7b80: 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a st char *zName,.
7b90: 20 20 69 6e 74 20 6e 41 72 67 0a 29 7b 0a 20 20 int nArg.){.
7ba0: 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 int nName = sqli
7bb0: 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4e 61 6d te3Strlen30(zNam
7bc0: 65 29 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 e);. int rc;.
7bd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
7be0: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ter(db->mutex);.
7bf0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 46 69 6e if( sqlite3Fin
7c00: 64 46 75 6e 63 74 69 6f 6e 28 64 62 2c 20 7a 4e dFunction(db, zN
7c10: 61 6d 65 2c 20 6e 4e 61 6d 65 2c 20 6e 41 72 67 ame, nName, nArg
7c20: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 30 , SQLITE_UTF8, 0
7c30: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 )==0 ){. sqli
7c40: 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 64 62 te3CreateFunc(db
7c50: 2c 20 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 53 , zName, nArg, S
7c60: 51 4c 49 54 45 5f 55 54 46 38 2c 0a 20 20 20 20 QLITE_UTF8,.
7c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7c80: 20 20 30 2c 20 73 71 6c 69 74 65 33 49 6e 76 61 0, sqlite3Inva
7c90: 6c 69 64 46 75 6e 63 74 69 6f 6e 2c 20 30 2c 20 lidFunction, 0,
7ca0: 30 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 0);. }. rc = s
7cb0: 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 qlite3ApiExit(db
7cc0: 2c 20 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 , SQLITE_OK);.
7cd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
7ce0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
7cf0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
7d00: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
7d10: 4d 49 54 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 MIT_TRACE./*.**
7d20: 52 65 67 69 73 74 65 72 20 61 20 74 72 61 63 65 Register a trace
7d30: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 function. The
7d40: 70 41 72 67 20 66 72 6f 6d 20 74 68 65 20 70 72 pArg from the pr
7d50: 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 eviously registe
7d60: 72 65 64 20 74 72 61 63 65 0a 2a 2a 20 69 73 20 red trace.** is
7d70: 72 65 74 75 72 6e 65 64 2e 20 20 0a 2a 2a 0a 2a returned. .**.*
7d80: 2a 20 41 20 4e 55 4c 4c 20 74 72 61 63 65 20 66 * A NULL trace f
7d90: 75 6e 63 74 69 6f 6e 20 6d 65 61 6e 73 20 74 68 unction means th
7da0: 61 74 20 6e 6f 20 74 72 61 63 69 6e 67 20 69 73 at no tracing is
7db0: 20 65 78 65 63 75 74 65 73 2e 20 20 41 20 6e 6f executes. A no
7dc0: 6e 2d 4e 55 4c 4c 0a 2a 2a 20 74 72 61 63 65 20 n-NULL.** trace
7dd0: 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
7de0: 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 a function that
7df0: 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 74 68 is invoked at th
7e00: 65 20 73 74 61 72 74 20 6f 66 20 65 61 63 68 0a e start of each.
7e10: 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ** SQL statement
7e20: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
7e30: 65 33 5f 74 72 61 63 65 28 73 71 6c 69 74 65 33 e3_trace(sqlite3
7e40: 20 2a 64 62 2c 20 76 6f 69 64 20 28 2a 78 54 72 *db, void (*xTr
7e50: 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 ace)(void*,const
7e60: 20 63 68 61 72 2a 29 2c 20 76 6f 69 64 20 2a 70 char*), void *p
7e70: 41 72 67 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4f Arg){. void *pO
7e80: 6c 64 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 ld;. sqlite3_mu
7e90: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
7ea0: 74 65 78 29 3b 0a 20 20 70 4f 6c 64 20 3d 20 64 tex);. pOld = d
7eb0: 62 2d 3e 70 54 72 61 63 65 41 72 67 3b 0a 20 20 b->pTraceArg;.
7ec0: 64 62 2d 3e 78 54 72 61 63 65 20 3d 20 78 54 72 db->xTrace = xTr
7ed0: 61 63 65 3b 0a 20 20 64 62 2d 3e 70 54 72 61 63 ace;. db->pTrac
7ee0: 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 eArg = pArg;. s
7ef0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
7f00: 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 ve(db->mutex);.
7f10: 20 72 65 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a return pOld;.}.
7f20: 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 /*.** Register a
7f30: 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f profile functio
7f40: 6e 2e 20 20 54 68 65 20 70 41 72 67 20 66 72 6f n. The pArg fro
7f50: 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c 79 m the previously
7f60: 20 72 65 67 69 73 74 65 72 65 64 20 0a 2a 2a 20 registered .**
7f70: 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e profile function
7f80: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 0a is returned. .
7f90: 2a 2a 0a 2a 2a 20 41 20 4e 55 4c 4c 20 70 72 6f **.** A NULL pro
7fa0: 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 6d 65 file function me
7fb0: 61 6e 73 20 74 68 61 74 20 6e 6f 20 70 72 6f 66 ans that no prof
7fc0: 69 6c 69 6e 67 20 69 73 20 65 78 65 63 75 74 65 iling is execute
7fd0: 73 2e 20 20 41 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a s. A non-NULL.*
7fe0: 2a 20 70 72 6f 66 69 6c 65 20 69 73 20 61 20 70 * profile is a p
7ff0: 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 ointer to a func
8000: 74 69 6f 6e 20 74 68 61 74 20 69 73 20 69 6e 76 tion that is inv
8010: 6f 6b 65 64 20 61 74 20 74 68 65 20 63 6f 6e 63 oked at the conc
8020: 6c 75 73 69 6f 6e 20 6f 66 0a 2a 2a 20 65 61 63 lusion of.** eac
8030: 68 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 h SQL statement
8040: 74 68 61 74 20 69 73 20 72 75 6e 2e 0a 2a 2f 0a that is run..*/.
8050: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 70 72 void *sqlite3_pr
8060: 6f 66 69 6c 65 28 0a 20 20 73 71 6c 69 74 65 33 ofile(. sqlite3
8070: 20 2a 64 62 2c 0a 20 20 76 6f 69 64 20 28 2a 78 *db,. void (*x
8080: 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 Profile)(void*,c
8090: 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 onst char*,sqlit
80a0: 65 5f 75 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 e_uint64),. voi
80b0: 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 76 6f 69 d *pArg.){. voi
80c0: 64 20 2a 70 4f 6c 64 3b 0a 20 20 73 71 6c 69 74 d *pOld;. sqlit
80d0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
80e0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 70 4f 6c b->mutex);. pOl
80f0: 64 20 3d 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 d = db->pProfile
8100: 41 72 67 3b 0a 20 20 64 62 2d 3e 78 50 72 6f 66 Arg;. db->xProf
8110: 69 6c 65 20 3d 20 78 50 72 6f 66 69 6c 65 3b 0a ile = xProfile;.
8120: 20 20 64 62 2d 3e 70 50 72 6f 66 69 6c 65 41 72 db->pProfileAr
8130: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
8140: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
8150: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 db->mutex);. re
8160: 74 75 72 6e 20 70 4f 6c 64 3b 0a 7d 0a 23 65 6e turn pOld;.}.#en
8170: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
8180: 49 54 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 2a IT_TRACE */../**
8190: 2a 20 45 58 50 45 52 49 4d 45 4e 54 41 4c 20 2a * EXPERIMENTAL *
81a0: 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 67 69 73 74 65 **.**.** Registe
81b0: 72 20 61 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 r a function to
81c0: 62 65 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20 be invoked when
81d0: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f a transaction co
81e0: 6d 6d 65 6e 74 73 2e 0a 2a 2a 20 49 66 20 74 68 mments..** If th
81f0: 65 20 69 6e 76 6f 6b 65 64 20 66 75 6e 63 74 69 e invoked functi
8200: 6f 6e 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a on returns non-z
8210: 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 63 6f ero, then the co
8220: 6d 6d 69 74 20 62 65 63 6f 6d 65 73 20 61 0a 2a mmit becomes a.*
8230: 2a 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 76 * rollback..*/.v
8240: 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6d oid *sqlite3_com
8250: 6d 69 74 5f 68 6f 6f 6b 28 0a 20 20 73 71 6c 69 mit_hook(. sqli
8260: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
8270: 20 20 20 20 20 20 2f 2a 20 41 74 74 61 63 68 20 /* Attach
8280: 74 68 65 20 68 6f 6f 6b 20 74 6f 20 74 68 69 73 the hook to this
8290: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 database */. i
82a0: 6e 74 20 28 2a 78 43 61 6c 6c 62 61 63 6b 29 28 nt (*xCallback)(
82b0: 76 6f 69 64 2a 29 2c 20 20 2f 2a 20 46 75 6e 63 void*), /* Func
82c0: 74 69 6f 6e 20 74 6f 20 69 6e 76 6f 6b 65 20 6f tion to invoke o
82d0: 6e 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 2a 2f n each commit */
82e0: 0a 20 20 76 6f 69 64 20 2a 70 41 72 67 20 20 20 . void *pArg
82f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8300: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
8310: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 function */.){.
8320: 20 76 6f 69 64 20 2a 70 4f 6c 64 3b 0a 20 20 73 void *pOld;. s
8330: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
8340: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 er(db->mutex);.
8350: 20 70 4f 6c 64 20 3d 20 64 62 2d 3e 70 43 6f 6d pOld = db->pCom
8360: 6d 69 74 41 72 67 3b 0a 20 20 64 62 2d 3e 78 43 mitArg;. db->xC
8370: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 20 3d 20 ommitCallback =
8380: 78 43 61 6c 6c 62 61 63 6b 3b 0a 20 20 64 62 2d xCallback;. db-
8390: 3e 70 43 6f 6d 6d 69 74 41 72 67 20 3d 20 70 41 >pCommitArg = pA
83a0: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 rg;. sqlite3_mu
83b0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
83c0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 tex);. return p
83d0: 4f 6c 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 Old;.}../*.** Re
83e0: 67 69 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 gister a callbac
83f0: 6b 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 k to be invoked
8400: 65 61 63 68 20 74 69 6d 65 20 61 20 72 6f 77 20 each time a row
8410: 69 73 20 75 70 64 61 74 65 64 2c 0a 2a 2a 20 69 is updated,.** i
8420: 6e 73 65 72 74 65 64 20 6f 72 20 64 65 6c 65 74 nserted or delet
8430: 65 64 20 75 73 69 6e 67 20 74 68 69 73 20 64 61 ed using this da
8440: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
8450: 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 n..*/.void *sqli
8460: 74 65 33 5f 75 70 64 61 74 65 5f 68 6f 6f 6b 28 te3_update_hook(
8470: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
8480: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8490: 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 Attach the hook
84a0: 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 to this database
84b0: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 */. void (*xCa
84c0: 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e llback)(void*,in
84d0: 74 2c 63 68 61 72 20 63 6f 6e 73 74 20 2a 2c 63 t,char const *,c
84e0: 68 61 72 20 63 6f 6e 73 74 20 2a 2c 73 71 6c 69 har const *,sqli
84f0: 74 65 5f 69 6e 74 36 34 29 2c 0a 20 20 76 6f 69 te_int64),. voi
8500: 64 20 2a 70 41 72 67 20 20 20 20 20 20 20 20 20 d *pArg
8510: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
8520: 6e 74 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 nt to the functi
8530: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 on */.){. void
8540: 2a 70 52 65 74 3b 0a 20 20 73 71 6c 69 74 65 33 *pRet;. sqlite3
8550: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d _mutex_enter(db-
8560: 3e 6d 75 74 65 78 29 3b 0a 20 20 70 52 65 74 20 >mutex);. pRet
8570: 3d 20 64 62 2d 3e 70 55 70 64 61 74 65 41 72 67 = db->pUpdateArg
8580: 3b 0a 20 20 64 62 2d 3e 78 55 70 64 61 74 65 43 ;. db->xUpdateC
8590: 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 allback = xCallb
85a0: 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 55 70 64 61 ack;. db->pUpda
85b0: 74 65 41 72 67 20 3d 20 70 41 72 67 3b 0a 20 20 teArg = pArg;.
85c0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
85d0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
85e0: 20 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d return pRet;.}
85f0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 ../*.** Register
8600: 20 61 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 62 a callback to b
8610: 65 20 69 6e 76 6f 6b 65 64 20 65 61 63 68 20 74 e invoked each t
8620: 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f ime a transactio
8630: 6e 20 69 73 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 n is rolled.** b
8640: 61 63 6b 20 62 79 20 74 68 69 73 20 64 61 74 61 ack by this data
8650: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e base connection.
8660: 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
8670: 33 5f 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 28 3_rollback_hook(
8680: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
8690: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
86a0: 41 74 74 61 63 68 20 74 68 65 20 68 6f 6f 6b 20 Attach the hook
86b0: 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 to this database
86c0: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 61 */. void (*xCa
86d0: 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 2c 20 llback)(void*),
86e0: 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 /* Callback func
86f0: 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a tion */. void *
8700: 70 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 pArg
8710: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
8720: 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 to the function
8730: 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 52 */.){. void *pR
8740: 65 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 et;. sqlite3_mu
8750: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
8760: 74 65 78 29 3b 0a 20 20 70 52 65 74 20 3d 20 64 tex);. pRet = d
8770: 62 2d 3e 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b b->pRollbackArg;
8780: 0a 20 20 64 62 2d 3e 78 52 6f 6c 6c 62 61 63 6b . db->xRollback
8790: 43 61 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c Callback = xCall
87a0: 62 61 63 6b 3b 0a 20 20 64 62 2d 3e 70 52 6f 6c back;. db->pRol
87b0: 6c 62 61 63 6b 41 72 67 20 3d 20 70 41 72 67 3b lbackArg = pArg;
87c0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
87d0: 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 _leave(db->mutex
87e0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 52 65 74 );. return pRet
87f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ;.}../*.** This
8800: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
8810: 20 74 72 75 65 20 69 66 20 6d 61 69 6e 2d 6d 65 true if main-me
8820: 6d 6f 72 79 20 73 68 6f 75 6c 64 20 62 65 20 75 mory should be u
8830: 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a sed instead of.*
8840: 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 * a temporary fi
8850: 6c 65 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 le for transient
8860: 20 70 61 67 65 72 20 66 69 6c 65 73 20 61 6e 64 pager files and
8870: 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e statement journ
8880: 61 6c 73 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 als..** The valu
8890: 65 20 72 65 74 75 72 6e 65 64 20 64 65 70 65 6e e returned depen
88a0: 64 73 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 ds on the value
88b0: 6f 66 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 of db->temp_stor
88c0: 65 20 28 72 75 6e 74 69 6d 65 0a 2a 2a 20 70 61 e (runtime.** pa
88d0: 72 61 6d 65 74 65 72 29 20 61 6e 64 20 74 68 65 rameter) and the
88e0: 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 20 76 61 compile time va
88f0: 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 45 lue of SQLITE_TE
8900: 4d 50 5f 53 54 4f 52 45 2e 20 54 68 65 0a 2a 2a MP_STORE. The.**
8910: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 following table
8920: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 72 describes the r
8930: 65 6c 61 74 69 6f 6e 73 68 69 70 20 62 65 74 77 elationship betw
8940: 65 65 6e 20 74 68 65 73 65 20 74 77 6f 20 76 61 een these two va
8950: 6c 75 65 73 0a 2a 2a 20 61 6e 64 20 74 68 69 73 lues.** and this
8960: 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 functions retur
8970: 6e 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 20 n value..**.**
8980: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
8990: 52 45 20 20 20 20 20 64 62 2d 3e 74 65 6d 70 5f RE db->temp_
89a0: 73 74 6f 72 65 20 20 20 20 20 4c 6f 63 61 74 69 store Locati
89b0: 6f 6e 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 on of temporary
89c0: 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 2d 2d database.** --
89d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 ---------------
89e0: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ------------
89f0: 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d -- ---------
8a00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8a10: 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 -----.** 0
8a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8a30: 20 61 6e 79 20 20 20 20 20 20 20 20 20 20 20 20 any
8a40: 20 20 20 20 66 69 6c 65 20 20 20 20 20 20 28 72 file (r
8a50: 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 20 31 20 eturn 0).** 1
8a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8a70: 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 1
8a80: 20 20 20 20 20 20 20 66 69 6c 65 20 20 20 20 20 file
8a90: 20 28 72 65 74 75 72 6e 20 30 29 0a 2a 2a 20 20 (return 0).**
8aa0: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
8ab0: 20 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20 2
8ac0: 20 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 memory
8ad0: 20 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a 2a (return 1).*
8ae0: 2a 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 * 1
8af0: 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20 20 0
8b00: 20 20 20 20 20 20 20 20 20 20 20 20 20 66 69 6c fil
8b10: 65 20 20 20 20 20 20 28 72 65 74 75 72 6e 20 30 e (return 0
8b20: 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 20 20 20 ).** 2
8b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 31 20 20 1
8b40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b50: 66 69 6c 65 20 20 20 20 20 20 28 72 65 74 75 72 file (retur
8b60: 6e 20 30 29 0a 2a 2a 20 20 20 32 20 20 20 20 20 n 0).** 2
8b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8b80: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
8b90: 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 28 72 65 memory (re
8ba0: 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 32 20 20 turn 1).** 2
8bb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8bc0: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 0
8bd0: 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 20 20 20 memory
8be0: 28 72 65 74 75 72 6e 20 31 29 0a 2a 2a 20 20 20 (return 1).**
8bf0: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3
8c00: 20 20 20 20 20 20 61 6e 79 20 20 20 20 20 20 20 any
8c10: 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 79 20 memory
8c20: 20 20 20 28 72 65 74 75 72 6e 20 31 29 0a 2a 2f (return 1).*/
8c30: 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 65 6d 70 .int sqlite3Temp
8c40: 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 74 20 73 InMemory(const s
8c50: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69 66 qlite3 *db){.#if
8c60: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
8c70: 52 45 3d 3d 31 0a 20 20 72 65 74 75 72 6e 20 28 RE==1. return (
8c80: 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 3d db->temp_store=
8c90: 3d 32 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 =2 );.#endif.#if
8ca0: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
8cb0: 52 45 3d 3d 32 0a 20 20 72 65 74 75 72 6e 20 28 RE==2. return (
8cc0: 20 64 62 2d 3e 74 65 6d 70 5f 73 74 6f 72 65 21 db->temp_store!
8cd0: 3d 31 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 =1 );.#endif.#if
8ce0: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
8cf0: 52 45 3d 3d 33 0a 20 20 72 65 74 75 72 6e 20 31 RE==3. return 1
8d00: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c ;.#endif.#if SQL
8d10: 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3c 31 ITE_TEMP_STORE<1
8d20: 20 7c 7c 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f || SQLITE_TEMP_
8d30: 53 54 4f 52 45 3e 33 0a 20 20 72 65 74 75 72 6e STORE>3. return
8d40: 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0;.#endif.}../*
8d50: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
8d60: 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 is called to cr
8d70: 65 61 74 65 20 61 20 63 6f 6e 6e 65 63 74 69 6f eate a connectio
8d80: 6e 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 n to a database
8d90: 42 54 72 65 65 0a 2a 2a 20 64 72 69 76 65 72 2e BTree.** driver.
8da0: 20 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 If zFilename i
8db0: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 s the name of a
8dc0: 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 20 file, then that
8dd0: 66 69 6c 65 20 69 73 0a 2a 2a 20 6f 70 65 6e 65 file is.** opene
8de0: 64 20 61 6e 64 20 75 73 65 64 2e 20 20 49 66 20 d and used. If
8df0: 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 65 zFilename is the
8e00: 20 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 magic name ":me
8e10: 6d 6f 72 79 3a 22 20 74 68 65 6e 0a 2a 2a 20 74 mory:" then.** t
8e20: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 73 he database is s
8e30: 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 tored in memory
8e40: 28 61 6e 64 20 69 73 20 74 68 75 73 20 66 6f 72 (and is thus for
8e50: 67 6f 74 74 65 6e 20 61 73 20 73 6f 6f 6e 20 61 gotten as soon a
8e60: 73 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 s.** the connect
8e70: 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 29 20 ion is closed.)
8e80: 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 If zFilename is
8e90: 20 4e 55 4c 4c 20 74 68 65 6e 20 74 68 65 20 64 NULL then the d
8ea0: 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 20 61 20 atabase.** is a
8eb0: 22 76 69 72 74 75 61 6c 22 20 64 61 74 61 62 61 "virtual" databa
8ec0: 73 65 20 66 6f 72 20 74 72 61 6e 73 69 65 6e 74 se for transient
8ed0: 20 75 73 65 20 6f 6e 6c 79 20 61 6e 64 20 69 73 use only and is
8ee0: 20 64 65 6c 65 74 65 64 20 61 73 0a 2a 2a 20 73 deleted as.** s
8ef0: 6f 6f 6e 20 61 73 20 74 68 65 20 63 6f 6e 6e 65 oon as the conne
8f00: 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e ction is closed.
8f10: 0a 2a 2a 0a 2a 2a 20 41 20 76 69 72 74 75 61 6c .**.** A virtual
8f20: 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 database can be
8f30: 20 65 69 74 68 65 72 20 61 20 64 69 73 6b 20 66 either a disk f
8f40: 69 6c 65 20 28 74 68 61 74 20 69 73 20 61 75 74 ile (that is aut
8f50: 6f 6d 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 64 65 omatically.** de
8f60: 6c 65 74 65 64 20 77 68 65 6e 20 74 68 65 20 66 leted when the f
8f70: 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 29 20 6f ile is closed) o
8f80: 72 20 69 74 20 61 6e 20 62 65 20 68 65 6c 64 20 r it an be held
8f90: 65 6e 74 69 72 65 6c 79 20 69 6e 20 6d 65 6d 6f entirely in memo
8fa0: 72 79 2e 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 ry..** The sqlit
8fb0: 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 29 e3TempInMemory()
8fc0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
8fd0: 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 d to determine w
8fe0: 68 69 63 68 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c hich..*/.int sql
8ff0: 69 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 ite3BtreeFactory
9000: 28 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 (. const sqlite
9010: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 2f 2a 3 *db, /*
9020: 20 4d 61 69 6e 20 64 61 74 61 62 61 73 65 20 77 Main database w
9030: 68 65 6e 20 6f 70 65 6e 69 6e 67 20 61 75 78 20 hen opening aux
9040: 6f 74 68 65 72 77 69 73 65 20 30 20 2a 2f 0a 20 otherwise 0 */.
9050: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 const char *zFi
9060: 6c 65 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 4e 61 lename, /* Na
9070: 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 me of the file c
9080: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 ontaining the BT
9090: 72 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a ree database */.
90a0: 20 20 69 6e 74 20 6f 6d 69 74 4a 6f 75 72 6e 61 int omitJourna
90b0: 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 l, /* i
90c0: 66 20 54 52 55 45 20 74 68 65 6e 20 64 6f 20 6e f TRUE then do n
90d0: 6f 74 20 6a 6f 75 72 6e 61 6c 20 74 68 69 73 20 ot journal this
90e0: 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 file */. int nC
90f0: 61 63 68 65 2c 20 20 20 20 20 20 20 20 20 20 20 ache,
9100: 20 20 20 20 2f 2a 20 48 6f 77 20 6d 61 6e 79 20 /* How many
9110: 70 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 67 pages in the pag
9120: 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 69 6e 74 e cache */. int
9130: 20 76 66 73 46 6c 61 67 73 2c 20 20 20 20 20 20 vfsFlags,
9140: 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 /* Flags
9150: 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 passed through t
9160: 6f 20 76 66 73 4f 70 65 6e 20 2a 2f 0a 20 20 42 o vfsOpen */. B
9170: 74 72 65 65 20 2a 2a 70 70 42 74 72 65 65 20 20 tree **ppBtree
9180: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
9190: 74 65 72 20 74 6f 20 6e 65 77 20 42 74 72 65 65 ter to new Btree
91a0: 20 6f 62 6a 65 63 74 20 77 72 69 74 74 65 6e 20 object written
91b0: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
91c0: 20 62 74 46 6c 61 67 73 20 3d 20 30 3b 0a 20 20 btFlags = 0;.
91d0: 69 6e 74 20 72 63 3b 0a 20 20 0a 20 20 61 73 73 int rc;. . ass
91e0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
91f0: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 ex_held(db->mute
9200: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
9210: 70 70 42 74 72 65 65 20 21 3d 20 30 29 3b 0a 20 ppBtree != 0);.
9220: 20 69 66 28 20 6f 6d 69 74 4a 6f 75 72 6e 61 6c if( omitJournal
9230: 20 29 7b 0a 20 20 20 20 62 74 46 6c 61 67 73 20 ){. btFlags
9240: 7c 3d 20 42 54 52 45 45 5f 4f 4d 49 54 5f 4a 4f |= BTREE_OMIT_JO
9250: 55 52 4e 41 4c 3b 0a 20 20 7d 0a 20 20 69 66 28 URNAL;. }. if(
9260: 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c db->flags & SQL
9270: 49 54 45 5f 4e 6f 52 65 61 64 6c 6f 63 6b 20 29 ITE_NoReadlock )
9280: 7b 0a 20 20 20 20 62 74 46 6c 61 67 73 20 7c 3d {. btFlags |=
9290: 20 42 54 52 45 45 5f 4e 4f 5f 52 45 41 44 4c 4f BTREE_NO_READLO
92a0: 43 4b 3b 0a 20 20 7d 0a 23 69 66 6e 64 65 66 20 CK;. }.#ifndef
92b0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f SQLITE_OMIT_MEMO
92c0: 52 59 44 42 0a 20 20 69 66 28 20 7a 46 69 6c 65 RYDB. if( zFile
92d0: 6e 61 6d 65 3d 3d 30 20 26 26 20 73 71 6c 69 74 name==0 && sqlit
92e0: 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 64 e3TempInMemory(d
92f0: 62 29 20 29 7b 0a 20 20 20 20 7a 46 69 6c 65 6e b) ){. zFilen
9300: 61 6d 65 20 3d 20 22 3a 6d 65 6d 6f 72 79 3a 22 ame = ":memory:"
9310: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 ;. }.#endif..
9320: 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 20 if( (vfsFlags &
9330: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
9340: 5f 44 42 29 21 3d 30 20 26 26 20 28 7a 46 69 6c _DB)!=0 && (zFil
9350: 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 2a 7a 46 69 ename==0 || *zFi
9360: 6c 65 6e 61 6d 65 3d 3d 30 29 20 29 7b 0a 20 20 lename==0) ){.
9370: 20 20 76 66 73 46 6c 61 67 73 20 3d 20 28 76 66 vfsFlags = (vf
9380: 73 46 6c 61 67 73 20 26 20 7e 53 51 4c 49 54 45 sFlags & ~SQLITE
9390: 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 20 7c _OPEN_MAIN_DB) |
93a0: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d SQLITE_OPEN_TEM
93b0: 50 5f 44 42 3b 0a 20 20 7d 0a 20 20 72 63 20 3d P_DB;. }. rc =
93c0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 70 65 sqlite3BtreeOpe
93d0: 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 28 73 71 n(zFilename, (sq
93e0: 6c 69 74 65 33 20 2a 29 64 62 2c 20 70 70 42 74 lite3 *)db, ppBt
93f0: 72 65 65 2c 20 62 74 46 6c 61 67 73 2c 20 76 66 ree, btFlags, vf
9400: 73 46 6c 61 67 73 29 3b 0a 0a 20 20 2f 2a 20 49 sFlags);.. /* I
9410: 66 20 74 68 65 20 42 2d 54 72 65 65 20 77 61 73 f the B-Tree was
9420: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 successfully op
9430: 65 6e 65 64 2c 20 73 65 74 20 74 68 65 20 70 61 ened, set the pa
9440: 67 65 72 2d 63 61 63 68 65 20 73 69 7a 65 20 74 ger-cache size t
9450: 6f 20 74 68 65 0a 20 20 2a 2a 20 64 65 66 61 75 o the. ** defau
9460: 6c 74 20 76 61 6c 75 65 2e 20 45 78 63 65 70 74 lt value. Except
9470: 2c 20 69 66 20 74 68 65 20 63 61 6c 6c 20 74 6f , if the call to
9480: 20 42 74 72 65 65 4f 70 65 6e 28 29 20 72 65 74 BtreeOpen() ret
9490: 75 72 6e 65 64 20 61 20 68 61 6e 64 6c 65 0a 20 urned a handle.
94a0: 20 2a 2a 20 6f 70 65 6e 20 6f 6e 20 61 6e 20 65 ** open on an e
94b0: 78 69 73 74 69 6e 67 20 73 68 61 72 65 64 20 70 xisting shared p
94c0: 61 67 65 72 2d 63 61 63 68 65 2c 20 64 6f 20 6e ager-cache, do n
94d0: 6f 74 20 63 68 61 6e 67 65 20 74 68 65 20 70 61 ot change the pa
94e0: 67 65 72 2d 63 61 63 68 65 20 0a 20 20 2a 2a 20 ger-cache . **
94f0: 73 69 7a 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 size.. */. if(
9500: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
9510: 26 20 30 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 & 0==sqlite3Btre
9520: 65 53 63 68 65 6d 61 28 2a 70 70 42 74 72 65 65 eSchema(*ppBtree
9530: 2c 20 30 2c 20 30 29 20 29 7b 0a 20 20 20 20 73 , 0, 0) ){. s
9540: 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 qlite3BtreeSetCa
9550: 63 68 65 53 69 7a 65 28 2a 70 70 42 74 72 65 65 cheSize(*ppBtree
9560: 2c 20 6e 43 61 63 68 65 29 3b 0a 20 20 7d 0a 20 , nCache);. }.
9570: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
9580: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 55 54 46 2d *.** Return UTF-
9590: 38 20 65 6e 63 6f 64 65 64 20 45 6e 67 6c 69 73 8 encoded Englis
95a0: 68 20 6c 61 6e 67 75 61 67 65 20 65 78 70 6c 61 h language expla
95b0: 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 6f nation of the mo
95c0: 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 65 72 72 st recent.** err
95d0: 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 or..*/.const cha
95e0: 72 20 2a 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 r *sqlite3_errms
95f0: 67 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a g(sqlite3 *db){.
9600: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b const char *z;
9610: 0a 20 20 69 66 28 20 21 64 62 20 29 7b 0a 20 20 . if( !db ){.
9620: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
9630: 45 72 72 53 74 72 28 53 51 4c 49 54 45 5f 4e 4f ErrStr(SQLITE_NO
9640: 4d 45 4d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 MEM);. }. if(
9650: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 !sqlite3SafetyCh
9660: 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 eckSickOrOk(db)
9670: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 ){. return sq
9680: 6c 69 74 65 33 45 72 72 53 74 72 28 53 51 4c 49 lite3ErrStr(SQLI
9690: 54 45 5f 4d 49 53 55 53 45 29 3b 0a 20 20 7d 0a TE_MISUSE);. }.
96a0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
96b0: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
96c0: 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c ;. if( db->mall
96d0: 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 ocFailed ){.
96e0: 7a 20 3d 20 73 71 6c 69 74 65 33 45 72 72 53 74 z = sqlite3ErrSt
96f0: 72 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b r(SQLITE_NOMEM);
9700: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 7a 20 . }else{. z
9710: 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74 65 33 = (char*)sqlite3
9720: 5f 76 61 6c 75 65 5f 74 65 78 74 28 64 62 2d 3e _value_text(db->
9730: 70 45 72 72 29 3b 0a 20 20 20 20 61 73 73 65 72 pErr);. asser
9740: 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 t( !db->mallocFa
9750: 69 6c 65 64 20 29 3b 0a 20 20 20 20 69 66 28 20 iled );. if(
9760: 7a 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 7a 20 z==0 ){. z
9770: 3d 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 = sqlite3ErrStr(
9780: 64 62 2d 3e 65 72 72 43 6f 64 65 29 3b 0a 20 20 db->errCode);.
9790: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 }. }. sqlite
97a0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 3_mutex_leave(db
97b0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 ->mutex);. retu
97c0: 72 6e 20 7a 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 rn z;.}..#ifndef
97d0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 SQLITE_OMIT_UTF
97e0: 31 36 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 16./*.** Return
97f0: 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 45 UTF-16 encoded E
9800: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20 nglish language
9810: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 explanation of t
9820: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a he most recent.*
9830: 2a 20 65 72 72 6f 72 2e 0a 2a 2f 0a 63 6f 6e 73 * error..*/.cons
9840: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f t void *sqlite3_
9850: 65 72 72 6d 73 67 31 36 28 73 71 6c 69 74 65 33 errmsg16(sqlite3
9860: 20 2a 64 62 29 7b 0a 20 20 73 74 61 74 69 63 20 *db){. static
9870: 63 6f 6e 73 74 20 75 31 36 20 6f 75 74 4f 66 4d const u16 outOfM
9880: 65 6d 5b 5d 20 3d 20 7b 0a 20 20 20 20 27 6f 27 em[] = {. 'o'
9890: 2c 20 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c , 'u', 't', ' ',
98a0: 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 27 2c 20 'o', 'f', ' ',
98b0: 27 6d 27 2c 20 27 65 27 2c 20 27 6d 27 2c 20 27 'm', 'e', 'm', '
98c0: 6f 27 2c 20 27 72 27 2c 20 27 79 27 2c 20 30 0a o', 'r', 'y', 0.
98d0: 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f };. static co
98e0: 6e 73 74 20 75 31 36 20 6d 69 73 75 73 65 5b 5d nst u16 misuse[]
98f0: 20 3d 20 7b 0a 20 20 20 20 27 6c 27 2c 20 27 69 = {. 'l', 'i
9900: 27 2c 20 27 62 27 2c 20 27 72 27 2c 20 27 61 27 ', 'b', 'r', 'a'
9910: 2c 20 27 72 27 2c 20 27 79 27 2c 20 27 20 27 2c , 'r', 'y', ' ',
9920: 20 0a 20 20 20 20 27 72 27 2c 20 27 6f 27 2c 20 . 'r', 'o',
9930: 27 75 27 2c 20 27 74 27 2c 20 27 69 27 2c 20 27 'u', 't', 'i', '
9940: 6e 27 2c 20 27 65 27 2c 20 27 20 27 2c 20 0a 20 n', 'e', ' ', .
9950: 20 20 20 27 63 27 2c 20 27 61 27 2c 20 27 6c 27 'c', 'a', 'l'
9960: 2c 20 27 6c 27 2c 20 27 65 27 2c 20 27 64 27 2c , 'l', 'e', 'd',
9970: 20 27 20 27 2c 20 0a 20 20 20 20 27 6f 27 2c 20 ' ', . 'o',
9980: 27 75 27 2c 20 27 74 27 2c 20 27 20 27 2c 20 0a 'u', 't', ' ', .
9990: 20 20 20 20 27 6f 27 2c 20 27 66 27 2c 20 27 20 'o', 'f', '
99a0: 27 2c 20 0a 20 20 20 20 27 73 27 2c 20 27 65 27 ', . 's', 'e'
99b0: 2c 20 27 71 27 2c 20 27 75 27 2c 20 27 65 27 2c , 'q', 'u', 'e',
99c0: 20 27 6e 27 2c 20 27 63 27 2c 20 27 65 27 2c 20 'n', 'c', 'e',
99d0: 30 0a 20 20 7d 3b 0a 0a 20 20 63 6f 6e 73 74 20 0. };.. const
99e0: 76 6f 69 64 20 2a 7a 3b 0a 20 20 69 66 28 20 21 void *z;. if( !
99f0: 64 62 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e db ){. return
9a00: 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 4d 65 (void *)outOfMe
9a10: 6d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 73 71 m;. }. if( !sq
9a20: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
9a30: 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b 0a SickOrOk(db) ){.
9a40: 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 return (void
9a50: 20 2a 29 6d 69 73 75 73 65 3b 0a 20 20 7d 0a 20 *)misuse;. }.
9a60: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
9a70: 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b nter(db->mutex);
9a80: 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f . if( db->mallo
9a90: 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 7a cFailed ){. z
9aa0: 20 3d 20 28 76 6f 69 64 20 2a 29 6f 75 74 4f 66 = (void *)outOf
9ab0: 4d 65 6d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 Mem;. }else{.
9ac0: 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 z = sqlite3_va
9ad0: 6c 75 65 5f 74 65 78 74 31 36 28 64 62 2d 3e 70 lue_text16(db->p
9ae0: 45 72 72 29 3b 0a 20 20 20 20 69 66 28 20 7a 3d Err);. if( z=
9af0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 =0 ){. sqli
9b00: 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 64 te3ValueSetStr(d
9b10: 62 2d 3e 70 45 72 72 2c 20 2d 31 2c 20 73 71 6c b->pErr, -1, sql
9b20: 69 74 65 33 45 72 72 53 74 72 28 64 62 2d 3e 65 ite3ErrStr(db->e
9b30: 72 72 43 6f 64 65 29 2c 0a 20 20 20 20 20 20 20 rrCode),.
9b40: 20 20 20 20 53 51 4c 49 54 45 5f 55 54 46 38 2c SQLITE_UTF8,
9b50: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b SQLITE_STATIC);
9b60: 0a 20 20 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 . z = sqlit
9b70: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28 e3_value_text16(
9b80: 64 62 2d 3e 70 45 72 72 29 3b 0a 20 20 20 20 7d db->pErr);. }
9b90: 0a 20 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 . /* A malloc
9ba0: 28 29 20 6d 61 79 20 68 61 76 65 20 66 61 69 6c () may have fail
9bb0: 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 63 61 ed within the ca
9bc0: 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 61 ll to sqlite3_va
9bd0: 6c 75 65 5f 74 65 78 74 31 36 28 29 0a 20 20 20 lue_text16().
9be0: 20 2a 2a 20 61 62 6f 76 65 2e 20 49 66 20 74 68 ** above. If th
9bf0: 69 73 20 69 73 20 74 68 65 20 63 61 73 65 2c 20 is is the case,
9c00: 74 68 65 6e 20 74 68 65 20 64 62 2d 3e 6d 61 6c then the db->mal
9c10: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 6e locFailed flag n
9c20: 65 65 64 73 20 74 6f 0a 20 20 20 20 2a 2a 20 62 eeds to. ** b
9c30: 65 20 63 6c 65 61 72 65 64 20 62 65 66 6f 72 65 e cleared before
9c40: 20 72 65 74 75 72 6e 69 6e 67 2e 20 44 6f 20 74 returning. Do t
9c50: 68 69 73 20 64 69 72 65 63 74 6c 79 2c 20 69 6e his directly, in
9c60: 73 74 65 61 64 20 6f 66 20 76 69 61 0a 20 20 20 stead of via.
9c70: 20 2a 2a 20 73 71 6c 69 74 65 33 41 70 69 45 78 ** sqlite3ApiEx
9c80: 69 74 28 29 2c 20 74 6f 20 61 76 6f 69 64 20 73 it(), to avoid s
9c90: 65 74 74 69 6e 67 20 74 68 65 20 64 61 74 61 62 etting the datab
9ca0: 61 73 65 20 68 61 6e 64 6c 65 20 65 72 72 6f 72 ase handle error
9cb0: 20 6d 65 73 73 61 67 65 2e 0a 20 20 20 20 2a 2f message.. */
9cc0: 0a 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 . db->mallocF
9cd0: 61 69 6c 65 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 ailed = 0;. }.
9ce0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
9cf0: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
9d00: 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 7d 0a 23 . return z;.}.#
9d10: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
9d20: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f OMIT_UTF16 */../
9d30: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
9d40: 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f most recent erro
9d50: 72 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 r code generated
9d60: 20 62 79 20 61 6e 20 53 51 4c 69 74 65 20 72 6f by an SQLite ro
9d70: 75 74 69 6e 65 2e 20 49 66 20 4e 55 4c 4c 20 69 utine. If NULL i
9d80: 73 0a 2a 2a 20 70 61 73 73 65 64 20 74 6f 20 74 s.** passed to t
9d90: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 77 65 his function, we
9da0: 20 61 73 73 75 6d 65 20 61 20 6d 61 6c 6c 6f 63 assume a malloc
9db0: 28 29 20 66 61 69 6c 65 64 20 64 75 72 69 6e 67 () failed during
9dc0: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 2e sqlite3_open().
9dd0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
9de0: 65 72 72 63 6f 64 65 28 73 71 6c 69 74 65 33 20 errcode(sqlite3
9df0: 2a 64 62 29 7b 0a 20 20 69 66 28 20 64 62 20 26 *db){. if( db &
9e00: 26 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 & !sqlite3Safety
9e10: 43 68 65 63 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 CheckSickOrOk(db
9e20: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
9e30: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 SQLITE_MISUSE;.
9e40: 20 7d 0a 20 20 69 66 28 20 21 64 62 20 7c 7c 20 }. if( !db ||
9e50: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
9e60: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
9e70: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d QLITE_NOMEM;. }
9e80: 0a 20 20 72 65 74 75 72 6e 20 64 62 2d 3e 65 72 . return db->er
9e90: 72 43 6f 64 65 20 26 20 64 62 2d 3e 65 72 72 4d rCode & db->errM
9ea0: 61 73 6b 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 ask;.}.int sqlit
9eb0: 65 33 5f 65 78 74 65 6e 64 65 64 5f 65 72 72 63 e3_extended_errc
9ec0: 6f 64 65 28 73 71 6c 69 74 65 33 20 2a 64 62 29 ode(sqlite3 *db)
9ed0: 7b 0a 20 20 69 66 28 20 64 62 20 26 26 20 21 73 {. if( db && !s
9ee0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
9ef0: 6b 53 69 63 6b 4f 72 4f 6b 28 64 62 29 20 29 7b kSickOrOk(db) ){
9f00: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
9f10: 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 TE_MISUSE;. }.
9f20: 20 69 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e if( !db || db->
9f30: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a mallocFailed ){.
9f40: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
9f50: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 72 E_NOMEM;. }. r
9f60: 65 74 75 72 6e 20 64 62 2d 3e 65 72 72 43 6f 64 eturn db->errCod
9f70: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 e;.}../*.** Crea
9f80: 74 65 20 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 te a new collati
9f90: 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 ng function for
9fa0: 64 61 74 61 62 61 73 65 20 22 64 62 22 2e 20 20 database "db".
9fb0: 54 68 65 20 6e 61 6d 65 20 69 73 20 7a 4e 61 6d The name is zNam
9fc0: 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 65 6e 63 e.** and the enc
9fd0: 6f 64 69 6e 67 20 69 73 20 65 6e 63 2e 0a 2a 2f oding is enc..*/
9fe0: 0a 73 74 61 74 69 63 20 69 6e 74 20 63 72 65 61 .static int crea
9ff0: 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 0a 20 20 73 teCollation(. s
a000: 71 6c 69 74 65 33 2a 20 64 62 2c 0a 20 20 63 6f qlite3* db,. co
a010: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c nst char *zName,
a020: 20 0a 20 20 75 38 20 65 6e 63 2c 0a 20 20 75 38 . u8 enc,. u8
a030: 20 63 6f 6c 6c 54 79 70 65 2c 0a 20 20 76 6f 69 collType,. voi
a040: 64 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a d* pCtx,. int(*
a050: 78 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c xCompare)(void*,
a060: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
a070: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 int,const void*)
a080: 2c 0a 20 20 76 6f 69 64 28 2a 78 44 65 6c 29 28 ,. void(*xDel)(
a090: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 43 6f 6c 6c void*).){. Coll
a0a0: 53 65 71 20 2a 70 43 6f 6c 6c 3b 0a 20 20 69 6e Seq *pColl;. in
a0b0: 74 20 65 6e 63 32 3b 0a 20 20 69 6e 74 20 6e 4e t enc2;. int nN
a0c0: 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 74 72 ame = sqlite3Str
a0d0: 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 3b 0a 20 20 len30(zName);.
a0e0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
a0f0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 e3_mutex_held(db
a100: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f ->mutex) );.. /
a110: 2a 20 49 66 20 53 51 4c 49 54 45 5f 55 54 46 31 * If SQLITE_UTF1
a120: 36 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 6 is specified a
a130: 73 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 74 s the encoding t
a140: 79 70 65 2c 20 74 72 61 6e 73 66 6f 72 6d 20 74 ype, transform t
a150: 68 69 73 0a 20 20 2a 2a 20 74 6f 20 6f 6e 65 20 his. ** to one
a160: 6f 66 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c of SQLITE_UTF16L
a170: 45 20 6f 72 20 53 51 4c 49 54 45 5f 55 54 46 31 E or SQLITE_UTF1
a180: 36 42 45 20 75 73 69 6e 67 20 74 68 65 0a 20 20 6BE using the.
a190: 2a 2a 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e ** SQLITE_UTF16N
a1a0: 41 54 49 56 45 20 6d 61 63 72 6f 2e 20 53 51 4c ATIVE macro. SQL
a1b0: 49 54 45 5f 55 54 46 31 36 20 69 73 20 6e 6f 74 ITE_UTF16 is not
a1c0: 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 used internally
a1d0: 2e 0a 20 20 2a 2f 0a 20 20 65 6e 63 32 20 3d 20 .. */. enc2 =
a1e0: 65 6e 63 3b 0a 20 20 74 65 73 74 63 61 73 65 28 enc;. testcase(
a1f0: 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f 55 54 enc2==SQLITE_UT
a200: 46 31 36 20 29 3b 0a 20 20 74 65 73 74 63 61 73 F16 );. testcas
a210: 65 28 20 65 6e 63 32 3d 3d 53 51 4c 49 54 45 5f e( enc2==SQLITE_
a220: 55 54 46 31 36 5f 41 4c 49 47 4e 45 44 20 29 3b UTF16_ALIGNED );
a230: 0a 20 20 69 66 28 20 65 6e 63 32 3d 3d 53 51 4c . if( enc2==SQL
a240: 49 54 45 5f 55 54 46 31 36 20 7c 7c 20 65 6e 63 ITE_UTF16 || enc
a250: 32 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 5f 2==SQLITE_UTF16_
a260: 41 4c 49 47 4e 45 44 20 29 7b 0a 20 20 20 20 65 ALIGNED ){. e
a270: 6e 63 32 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 nc2 = SQLITE_UTF
a280: 31 36 4e 41 54 49 56 45 3b 0a 20 20 7d 0a 20 20 16NATIVE;. }.
a290: 69 66 28 20 65 6e 63 32 3c 53 51 4c 49 54 45 5f if( enc2<SQLITE_
a2a0: 55 54 46 38 20 7c 7c 20 65 6e 63 32 3e 53 51 4c UTF8 || enc2>SQL
a2b0: 49 54 45 5f 55 54 46 31 36 42 45 20 29 7b 0a 20 ITE_UTF16BE ){.
a2c0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a2d0: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 _MISUSE;. }..
a2e0: 2f 2a 20 43 68 65 63 6b 20 69 66 20 74 68 69 73 /* Check if this
a2f0: 20 63 61 6c 6c 20 69 73 20 72 65 6d 6f 76 69 6e call is removin
a300: 67 20 6f 72 20 72 65 70 6c 61 63 69 6e 67 20 61 g or replacing a
a310: 6e 20 65 78 69 73 74 69 6e 67 20 63 6f 6c 6c 61 n existing colla
a320: 74 69 6f 6e 20 0a 20 20 2a 2a 20 73 65 71 75 65 tion . ** seque
a330: 6e 63 65 2e 20 49 66 20 73 6f 2c 20 61 6e 64 20 nce. If so, and
a340: 74 68 65 72 65 20 61 72 65 20 61 63 74 69 76 65 there are active
a350: 20 56 4d 73 2c 20 72 65 74 75 72 6e 20 62 75 73 VMs, return bus
a360: 79 2e 20 49 66 20 74 68 65 72 65 0a 20 20 2a 2a y. If there. **
a370: 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 56 are no active V
a380: 4d 73 2c 20 69 6e 76 61 6c 69 64 61 74 65 20 61 Ms, invalidate a
a390: 6e 79 20 70 72 65 2d 63 6f 6d 70 69 6c 65 64 20 ny pre-compiled
a3a0: 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 2a 2f statements.. */
a3b0: 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 . pColl = sqlit
a3c0: 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 e3FindCollSeq(db
a3d0: 2c 20 28 75 38 29 65 6e 63 32 2c 20 7a 4e 61 6d , (u8)enc2, zNam
a3e0: 65 2c 20 30 29 3b 0a 20 20 69 66 28 20 70 43 6f e, 0);. if( pCo
a3f0: 6c 6c 20 26 26 20 70 43 6f 6c 6c 2d 3e 78 43 6d ll && pColl->xCm
a400: 70 20 29 7b 0a 20 20 20 20 69 66 28 20 64 62 2d p ){. if( db-
a410: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20 29 >activeVdbeCnt )
a420: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 {. sqlite3E
a430: 72 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f rror(db, SQLITE_
a440: 42 55 53 59 2c 20 0a 20 20 20 20 20 20 20 20 22 BUSY, . "
a450: 75 6e 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 unable to delete
a460: 2f 6d 6f 64 69 66 79 20 63 6f 6c 6c 61 74 69 6f /modify collatio
a470: 6e 20 73 65 71 75 65 6e 63 65 20 64 75 65 20 74 n sequence due t
a480: 6f 20 61 63 74 69 76 65 20 73 74 61 74 65 6d 65 o active stateme
a490: 6e 74 73 22 29 3b 0a 20 20 20 20 20 20 72 65 74 nts");. ret
a4a0: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
a4b0: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
a4c0: 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65 64 e3ExpirePrepared
a4d0: 53 74 61 74 65 6d 65 6e 74 73 28 64 62 29 3b 0a Statements(db);.
a4e0: 0a 20 20 20 20 2f 2a 20 49 66 20 63 6f 6c 6c 61 . /* If colla
a4f0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 70 43 tion sequence pC
a500: 6f 6c 6c 20 77 61 73 20 63 72 65 61 74 65 64 20 oll was created
a510: 64 69 72 65 63 74 6c 79 20 62 79 20 61 20 63 61 directly by a ca
a520: 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c ll to. ** sql
a530: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
a540: 61 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74 20 67 ation, and not g
a550: 65 6e 65 72 61 74 65 64 20 62 79 20 73 79 6e 74 enerated by synt
a560: 68 43 6f 6c 6c 53 65 71 28 29 2c 0a 20 20 20 20 hCollSeq(),.
a570: 2a 2a 20 74 68 65 6e 20 61 6e 79 20 63 6f 70 69 ** then any copi
a580: 65 73 20 6d 61 64 65 20 62 79 20 73 79 6e 74 68 es made by synth
a590: 43 6f 6c 6c 53 65 71 28 29 20 6e 65 65 64 20 74 CollSeq() need t
a5a0: 6f 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 64 o be invalidated
a5b0: 2e 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 63 .. ** Also, c
a5c0: 6f 6c 6c 61 74 69 6f 6e 20 64 65 73 74 72 75 63 ollation destruc
a5d0: 74 6f 72 20 2d 20 43 6f 6c 6c 53 65 71 2e 78 44 tor - CollSeq.xD
a5e0: 65 6c 28 29 20 2d 20 66 75 6e 63 74 69 6f 6e 20 el() - function
a5f0: 6d 61 79 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 may need. **
a600: 74 6f 20 62 65 20 63 61 6c 6c 65 64 2e 0a 20 20 to be called..
a610: 20 20 2a 2f 20 0a 20 20 20 20 69 66 28 20 28 70 */ . if( (p
a620: 43 6f 6c 6c 2d 3e 65 6e 63 20 26 20 7e 53 51 4c Coll->enc & ~SQL
a630: 49 54 45 5f 55 54 46 31 36 5f 41 4c 49 47 4e 45 ITE_UTF16_ALIGNE
a640: 44 29 3d 3d 65 6e 63 32 20 29 7b 0a 20 20 20 20 D)==enc2 ){.
a650: 20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c CollSeq *aColl
a660: 20 3d 20 73 71 6c 69 74 65 33 48 61 73 68 46 69 = sqlite3HashFi
a670: 6e 64 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 nd(&db->aCollSeq
a680: 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b , zName, nName);
a690: 0a 20 20 20 20 20 20 69 6e 74 20 6a 3b 0a 20 20 . int j;.
a6a0: 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 33 for(j=0; j<3
a6b0: 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 ; j++){.
a6c0: 43 6f 6c 6c 53 65 71 20 2a 70 20 3d 20 26 61 43 CollSeq *p = &aC
a6d0: 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 20 20 20 20 oll[j];.
a6e0: 69 66 28 20 70 2d 3e 65 6e 63 3d 3d 70 43 6f 6c if( p->enc==pCol
a6f0: 6c 2d 3e 65 6e 63 20 29 7b 0a 20 20 20 20 20 20 l->enc ){.
a700: 20 20 20 20 69 66 28 20 70 2d 3e 78 44 65 6c 20 if( p->xDel
a710: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 ){. p
a720: 2d 3e 78 44 65 6c 28 70 2d 3e 70 55 73 65 72 29 ->xDel(p->pUser)
a730: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
a740: 20 20 20 20 20 20 20 20 70 2d 3e 78 43 6d 70 20 p->xCmp
a750: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 = 0;. }.
a760: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
a770: 0a 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 .. pColl = sqli
a780: 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 64 te3FindCollSeq(d
a790: 62 2c 20 28 75 38 29 65 6e 63 32 2c 20 7a 4e 61 b, (u8)enc2, zNa
a7a0: 6d 65 2c 20 31 29 3b 0a 20 20 69 66 28 20 70 43 me, 1);. if( pC
a7b0: 6f 6c 6c 20 29 7b 0a 20 20 20 20 70 43 6f 6c 6c oll ){. pColl
a7c0: 2d 3e 78 43 6d 70 20 3d 20 78 43 6f 6d 70 61 72 ->xCmp = xCompar
a7d0: 65 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 70 55 e;. pColl->pU
a7e0: 73 65 72 20 3d 20 70 43 74 78 3b 0a 20 20 20 20 ser = pCtx;.
a7f0: 70 43 6f 6c 6c 2d 3e 78 44 65 6c 20 3d 20 78 44 pColl->xDel = xD
a800: 65 6c 3b 0a 20 20 20 20 70 43 6f 6c 6c 2d 3e 65 el;. pColl->e
a810: 6e 63 20 3d 20 28 75 38 29 28 65 6e 63 32 20 7c nc = (u8)(enc2 |
a820: 20 28 65 6e 63 20 26 20 53 51 4c 49 54 45 5f 55 (enc & SQLITE_U
a830: 54 46 31 36 5f 41 4c 49 47 4e 45 44 29 29 3b 0a TF16_ALIGNED));.
a840: 20 20 20 20 70 43 6f 6c 6c 2d 3e 74 79 70 65 20 pColl->type
a850: 3d 20 63 6f 6c 6c 54 79 70 65 3b 0a 20 20 7d 0a = collType;. }.
a860: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 sqlite3Error(d
a870: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 b, SQLITE_OK, 0)
a880: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
a890: 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 E_OK;.}.../*.**
a8a0: 54 68 69 73 20 61 72 72 61 79 20 64 65 66 69 6e This array defin
a8b0: 65 73 20 68 61 72 64 20 75 70 70 65 72 20 62 6f es hard upper bo
a8c0: 75 6e 64 73 20 6f 6e 20 6c 69 6d 69 74 20 76 61 unds on limit va
a8d0: 6c 75 65 73 2e 20 20 54 68 65 0a 2a 2a 20 69 6e lues. The.** in
a8e0: 69 74 69 61 6c 69 7a 65 72 20 6d 75 73 74 20 62 itializer must b
a8f0: 65 20 6b 65 70 74 20 69 6e 20 73 79 6e 63 20 77 e kept in sync w
a900: 69 74 68 20 74 68 65 20 53 51 4c 49 54 45 5f 4c ith the SQLITE_L
a910: 49 4d 49 54 5f 2a 0a 2a 2a 20 23 64 65 66 69 6e IMIT_*.** #defin
a920: 65 73 20 69 6e 20 73 71 6c 69 74 65 33 2e 68 2e es in sqlite3.h.
a930: 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 .*/.static const
a940: 20 69 6e 74 20 61 48 61 72 64 4c 69 6d 69 74 5b int aHardLimit[
a950: 5d 20 3d 20 7b 0a 20 20 53 51 4c 49 54 45 5f 4d ] = {. SQLITE_M
a960: 41 58 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c AX_LENGTH,. SQL
a970: 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 ITE_MAX_SQL_LENG
a980: 54 48 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 TH,. SQLITE_MAX
a990: 5f 43 4f 4c 55 4d 4e 2c 0a 20 20 53 51 4c 49 54 _COLUMN,. SQLIT
a9a0: 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 E_MAX_EXPR_DEPTH
a9b0: 2c 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 43 ,. SQLITE_MAX_C
a9c0: 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 2c 0a OMPOUND_SELECT,.
a9d0: 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 44 42 SQLITE_MAX_VDB
a9e0: 45 5f 4f 50 2c 0a 20 20 53 51 4c 49 54 45 5f 4d E_OP,. SQLITE_M
a9f0: 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 2c AX_FUNCTION_ARG,
aa00: 0a 20 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 . SQLITE_MAX_AT
aa10: 54 41 43 48 45 44 2c 0a 20 20 53 51 4c 49 54 45 TACHED,. SQLITE
aa20: 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 _MAX_LIKE_PATTER
aa30: 4e 5f 4c 45 4e 47 54 48 2c 0a 20 20 53 51 4c 49 N_LENGTH,. SQLI
aa40: 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f TE_MAX_VARIABLE_
aa50: 4e 55 4d 42 45 52 2c 0a 20 20 53 51 4c 49 54 45 NUMBER,. SQLITE
aa60: 5f 4d 41 58 5f 54 52 49 47 47 45 52 5f 44 45 50 _MAX_TRIGGER_DEP
aa70: 54 48 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 TH,.};../*.** Ma
aa80: 6b 65 20 73 75 72 65 20 74 68 65 20 68 61 72 64 ke sure the hard
aa90: 20 6c 69 6d 69 74 73 20 61 72 65 20 73 65 74 20 limits are set
aaa0: 74 6f 20 72 65 61 73 6f 6e 61 62 6c 65 20 76 61 to reasonable va
aab0: 6c 75 65 73 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 lues.*/.#if SQLI
aac0: 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 3c 31 30 TE_MAX_LENGTH<10
aad0: 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 54 45 0.# error SQLITE
aae0: 5f 4d 41 58 5f 4c 45 4e 47 54 48 20 6d 75 73 74 _MAX_LENGTH must
aaf0: 20 62 65 20 61 74 20 6c 65 61 73 74 20 31 30 30 be at least 100
ab00: 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
ab10: 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 TE_MAX_SQL_LENGT
ab20: 48 3c 31 30 30 0a 23 20 65 72 72 6f 72 20 53 51 H<100.# error SQ
ab30: 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e LITE_MAX_SQL_LEN
ab40: 47 54 48 20 6d 75 73 74 20 62 65 20 61 74 20 6c GTH must be at l
ab50: 65 61 73 74 20 31 30 30 0a 23 65 6e 64 69 66 0a east 100.#endif.
ab60: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 #if SQLITE_MAX_S
ab70: 51 4c 5f 4c 45 4e 47 54 48 3e 53 51 4c 49 54 45 QL_LENGTH>SQLITE
ab80: 5f 4d 41 58 5f 4c 45 4e 47 54 48 0a 23 20 65 72 _MAX_LENGTH.# er
ab90: 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f 53 ror SQLITE_MAX_S
aba0: 51 4c 5f 4c 45 4e 47 54 48 20 6d 75 73 74 20 6e QL_LENGTH must n
abb0: 6f 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 ot be greater th
abc0: 61 6e 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45 an SQLITE_MAX_LE
abd0: 4e 47 54 48 0a 23 65 6e 64 69 66 0a 23 69 66 20 NGTH.#endif.#if
abe0: 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f SQLITE_MAX_COMPO
abf0: 55 4e 44 5f 53 45 4c 45 43 54 3c 32 0a 23 20 65 UND_SELECT<2.# e
ac00: 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f rror SQLITE_MAX_
ac10: 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 20 COMPOUND_SELECT
ac20: 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 must be at least
ac30: 20 32 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 2.#endif.#if SQ
ac40: 4c 49 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 LITE_MAX_VDBE_OP
ac50: 3c 34 30 0a 23 20 65 72 72 6f 72 20 53 51 4c 49 <40.# error SQLI
ac60: 54 45 5f 4d 41 58 5f 56 44 42 45 5f 4f 50 20 6d TE_MAX_VDBE_OP m
ac70: 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 ust be at least
ac80: 34 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 40.#endif.#if SQ
ac90: 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f LITE_MAX_FUNCTIO
aca0: 4e 5f 41 52 47 3c 30 20 7c 7c 20 53 51 4c 49 54 N_ARG<0 || SQLIT
acb0: 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 E_MAX_FUNCTION_A
acc0: 52 47 3e 31 30 30 30 0a 23 20 65 72 72 6f 72 20 RG>1000.# error
acd0: 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 SQLITE_MAX_FUNCT
ace0: 49 4f 4e 5f 41 52 47 20 6d 75 73 74 20 62 65 20 ION_ARG must be
acf0: 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 31 30 between 0 and 10
ad00: 30 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 00.#endif.#if SQ
ad10: 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 LITE_MAX_ATTACHE
ad20: 44 3c 30 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 D<0 || SQLITE_MA
ad30: 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a 23 20 X_ATTACHED>30.#
ad40: 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 error SQLITE_MAX
ad50: 5f 41 54 54 41 43 48 45 44 20 6d 75 73 74 20 62 _ATTACHED must b
ad60: 65 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 e between 0 and
ad70: 33 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 30.#endif.#if SQ
ad80: 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 LITE_MAX_LIKE_PA
ad90: 54 54 45 52 4e 5f 4c 45 4e 47 54 48 3c 31 0a 23 TTERN_LENGTH<1.#
ada0: 20 65 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 error SQLITE_MA
adb0: 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c X_LIKE_PATTERN_L
adc0: 45 4e 47 54 48 20 6d 75 73 74 20 62 65 20 61 74 ENGTH must be at
add0: 20 6c 65 61 73 74 20 31 0a 23 65 6e 64 69 66 0a least 1.#endif.
ade0: 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 #if SQLITE_MAX_V
adf0: 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 3c 31 ARIABLE_NUMBER<1
ae00: 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 || SQLITE_MAX_V
ae10: 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 3e 33 ARIABLE_NUMBER>3
ae20: 32 37 36 37 0a 23 20 65 72 72 6f 72 20 53 51 4c 2767.# error SQL
ae30: 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 ITE_MAX_VARIABLE
ae40: 5f 4e 55 4d 42 45 52 20 6d 75 73 74 20 62 65 20 _NUMBER must be
ae50: 62 65 74 77 65 65 6e 20 31 20 61 6e 64 20 33 32 between 1 and 32
ae60: 37 36 37 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 767.#endif.#if S
ae70: 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e QLITE_MAX_COLUMN
ae80: 3e 33 32 37 36 37 0a 23 20 65 72 72 6f 72 20 53 >32767.# error S
ae90: 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e QLITE_MAX_COLUMN
aea0: 20 6d 75 73 74 20 6e 6f 74 20 65 78 63 65 65 64 must not exceed
aeb0: 20 33 32 37 36 37 0a 23 65 6e 64 69 66 0a 23 69 32767.#endif.#i
aec0: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 54 52 49 f SQLITE_MAX_TRI
aed0: 47 47 45 52 5f 44 45 50 54 48 3c 31 0a 23 20 65 GGER_DEPTH<1.# e
aee0: 72 72 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 5f rror SQLITE_MAX_
aef0: 54 52 49 47 47 45 52 5f 44 45 50 54 48 20 6d 75 TRIGGER_DEPTH mu
af00: 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 31 st be at least 1
af10: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
af20: 43 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 Change the value
af30: 20 6f 66 20 61 20 6c 69 6d 69 74 2e 20 20 52 65 of a limit. Re
af40: 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 76 61 6c port the old val
af50: 75 65 2e 0a 2a 2a 20 49 66 20 61 6e 20 69 6e 76 ue..** If an inv
af60: 61 6c 69 64 20 6c 69 6d 69 74 20 69 6e 64 65 78 alid limit index
af70: 20 69 73 20 73 75 70 70 6c 69 65 64 2c 20 72 65 is supplied, re
af80: 70 6f 72 74 20 2d 31 2e 0a 2a 2a 20 4d 61 6b 65 port -1..** Make
af90: 20 6e 6f 20 63 68 61 6e 67 65 73 20 62 75 74 20 no changes but
afa0: 73 74 69 6c 6c 20 72 65 70 6f 72 74 20 74 68 65 still report the
afb0: 20 6f 6c 64 20 76 61 6c 75 65 20 69 66 20 74 68 old value if th
afc0: 65 0a 2a 2a 20 6e 65 77 20 6c 69 6d 69 74 20 69 e.** new limit i
afd0: 73 20 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 0a 2a s negative..**.*
afe0: 2a 20 41 20 6e 65 77 20 6c 6f 77 65 72 20 6c 69 * A new lower li
aff0: 6d 69 74 20 64 6f 65 73 20 6e 6f 74 20 73 68 72 mit does not shr
b000: 69 6e 6b 20 65 78 69 73 74 69 6e 67 20 63 6f 6e ink existing con
b010: 73 74 72 75 63 74 73 2e 0a 2a 2a 20 49 74 20 6d structs..** It m
b020: 65 72 65 6c 79 20 70 72 65 76 65 6e 74 73 20 6e erely prevents n
b030: 65 77 20 63 6f 6e 73 74 72 75 63 74 73 20 74 68 ew constructs th
b040: 61 74 20 65 78 63 65 65 64 20 74 68 65 20 6c 69 at exceed the li
b050: 6d 69 74 0a 2a 2a 20 66 72 6f 6d 20 66 6f 72 6d mit.** from form
b060: 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ing..*/.int sqli
b070: 74 65 33 5f 6c 69 6d 69 74 28 73 71 6c 69 74 65 te3_limit(sqlite
b080: 33 20 2a 64 62 2c 20 69 6e 74 20 6c 69 6d 69 74 3 *db, int limit
b090: 49 64 2c 20 69 6e 74 20 6e 65 77 4c 69 6d 69 74 Id, int newLimit
b0a0: 29 7b 0a 20 20 69 6e 74 20 6f 6c 64 4c 69 6d 69 ){. int oldLimi
b0b0: 74 3b 0a 20 20 69 66 28 20 6c 69 6d 69 74 49 64 t;. if( limitId
b0c0: 3c 30 20 7c 7c 20 6c 69 6d 69 74 49 64 3e 3d 53 <0 || limitId>=S
b0d0: 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 29 7b QLITE_N_LIMIT ){
b0e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a . return -1;.
b0f0: 20 20 7d 0a 20 20 6f 6c 64 4c 69 6d 69 74 20 3d }. oldLimit =
b100: 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 6d 69 db->aLimit[limi
b110: 74 49 64 5d 3b 0a 20 20 69 66 28 20 6e 65 77 4c tId];. if( newL
b120: 69 6d 69 74 3e 3d 30 20 29 7b 0a 20 20 20 20 69 imit>=0 ){. i
b130: 66 28 20 6e 65 77 4c 69 6d 69 74 3e 61 48 61 72 f( newLimit>aHar
b140: 64 4c 69 6d 69 74 5b 6c 69 6d 69 74 49 64 5d 20 dLimit[limitId]
b150: 29 7b 0a 20 20 20 20 20 20 6e 65 77 4c 69 6d 69 ){. newLimi
b160: 74 20 3d 20 61 48 61 72 64 4c 69 6d 69 74 5b 6c t = aHardLimit[l
b170: 69 6d 69 74 49 64 5d 3b 0a 20 20 20 20 7d 0a 20 imitId];. }.
b180: 20 20 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 6c 69 db->aLimit[li
b190: 6d 69 74 49 64 5d 20 3d 20 6e 65 77 4c 69 6d 69 mitId] = newLimi
b1a0: 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 t;. }. return
b1b0: 6f 6c 64 4c 69 6d 69 74 3b 0a 7d 0a 0a 2f 2a 0a oldLimit;.}../*.
b1c0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
b1d0: 64 6f 65 73 20 74 68 65 20 77 6f 72 6b 20 6f 66 does the work of
b1e0: 20 6f 70 65 6e 69 6e 67 20 61 20 64 61 74 61 62 opening a datab
b1f0: 61 73 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 ase on behalf of
b200: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e .** sqlite3_open
b210: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 6f () and sqlite3_o
b220: 70 65 6e 31 36 28 29 2e 20 54 68 65 20 64 61 74 pen16(). The dat
b230: 61 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 22 abase filename "
b240: 7a 46 69 6c 65 6e 61 6d 65 22 20 20 0a 2a 2a 20 zFilename" .**
b250: 69 73 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 is UTF-8 encoded
b260: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
b270: 6f 70 65 6e 44 61 74 61 62 61 73 65 28 0a 20 20 openDatabase(.
b280: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c const char *zFil
b290: 65 6e 61 6d 65 2c 20 2f 2a 20 44 61 74 61 62 61 ename, /* Databa
b2a0: 73 65 20 66 69 6c 65 6e 61 6d 65 20 55 54 46 2d se filename UTF-
b2b0: 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 73 8 encoded */. s
b2c0: 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 2c 20 20 qlite3 **ppDb,
b2d0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 65 /* OUT: Re
b2e0: 74 75 72 6e 65 64 20 64 61 74 61 62 61 73 65 20 turned database
b2f0: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 75 6e 73 69 handle */. unsi
b300: 67 6e 65 64 20 66 6c 61 67 73 2c 20 20 20 20 20 gned flags,
b310: 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e 61 /* Operationa
b320: 6c 20 66 6c 61 67 73 20 2a 2f 0a 20 20 63 6f 6e l flags */. con
b330: 73 74 20 63 68 61 72 20 2a 7a 56 66 73 20 20 20 st char *zVfs
b340: 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
b350: 68 65 20 56 46 53 20 74 6f 20 75 73 65 20 2a 2f he VFS to use */
b360: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 .){. sqlite3 *d
b370: 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 b;. int rc;. i
b380: 6e 74 20 69 73 54 68 72 65 61 64 73 61 66 65 3b nt isThreadsafe;
b390: 0a 0a 20 20 2a 70 70 44 62 20 3d 20 30 3b 0a 23 .. *ppDb = 0;.#
b3a0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
b3b0: 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 72 63 IT_AUTOINIT. rc
b3c0: 20 3d 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 = sqlite3_initi
b3d0: 61 6c 69 7a 65 28 29 3b 0a 20 20 69 66 28 20 72 alize();. if( r
b3e0: 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 c ) return rc;.#
b3f0: 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 73 71 6c endif.. if( sql
b400: 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 ite3GlobalConfig
b410: 2e 62 43 6f 72 65 4d 75 74 65 78 3d 3d 30 20 29 .bCoreMutex==0 )
b420: 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 61 {. isThreadsa
b430: 66 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 fe = 0;. }else
b440: 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 if( flags & SQLI
b450: 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 20 TE_OPEN_NOMUTEX
b460: 29 7b 0a 20 20 20 20 69 73 54 68 72 65 61 64 73 ){. isThreads
b470: 61 66 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 afe = 0;. }else
b480: 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c if( flags & SQL
b490: 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 ITE_OPEN_FULLMUT
b4a0: 45 58 20 29 7b 0a 20 20 20 20 69 73 54 68 72 65 EX ){. isThre
b4b0: 61 64 73 61 66 65 20 3d 20 31 3b 0a 20 20 7d 65 adsafe = 1;. }e
b4c0: 6c 73 65 7b 0a 20 20 20 20 69 73 54 68 72 65 61 lse{. isThrea
b4d0: 64 73 61 66 65 20 3d 20 73 71 6c 69 74 65 33 47 dsafe = sqlite3G
b4e0: 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 46 75 6c lobalConfig.bFul
b4f0: 6c 4d 75 74 65 78 3b 0a 20 20 7d 0a 20 20 69 66 lMutex;. }. if
b500: 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 ( flags & SQLITE
b510: 5f 4f 50 45 4e 5f 50 52 49 56 41 54 45 43 41 43 _OPEN_PRIVATECAC
b520: 48 45 20 29 7b 0a 20 20 20 20 66 6c 61 67 73 20 HE ){. flags
b530: 26 3d 20 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f &= ~SQLITE_OPEN_
b540: 53 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 7d SHAREDCACHE;. }
b550: 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 else if( sqlite3
b560: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 68 61 GlobalConfig.sha
b570: 72 65 64 43 61 63 68 65 45 6e 61 62 6c 65 64 20 redCacheEnabled
b580: 29 7b 0a 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 ){. flags |=
b590: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 48 41 52 SQLITE_OPEN_SHAR
b5a0: 45 44 43 41 43 48 45 3b 0a 20 20 7d 0a 0a 20 20 EDCACHE;. }..
b5b0: 2f 2a 20 52 65 6d 6f 76 65 20 68 61 72 6d 66 75 /* Remove harmfu
b5c0: 6c 20 62 69 74 73 20 66 72 6f 6d 20 74 68 65 20 l bits from the
b5d0: 66 6c 61 67 73 20 70 61 72 61 6d 65 74 65 72 0a flags parameter.
b5e0: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 53 51 **. ** The SQ
b5f0: 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 LITE_OPEN_NOMUTE
b600: 58 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 50 45 X and SQLITE_OPE
b610: 4e 5f 46 55 4c 4c 4d 55 54 45 58 20 66 6c 61 67 N_FULLMUTEX flag
b620: 73 20 77 65 72 65 0a 20 20 2a 2a 20 64 65 61 6c s were. ** deal
b630: 74 20 77 69 74 68 20 69 6e 20 74 68 65 20 70 72 t with in the pr
b640: 65 76 69 6f 75 73 20 63 6f 64 65 20 62 6c 6f 63 evious code bloc
b650: 6b 2e 20 20 42 65 73 69 64 65 73 20 74 68 65 73 k. Besides thes
b660: 65 2c 20 74 68 65 20 6f 6e 6c 79 0a 20 20 2a 2a e, the only. **
b670: 20 76 61 6c 69 64 20 69 6e 70 75 74 20 66 6c 61 valid input fla
b680: 67 73 20 66 6f 72 20 73 71 6c 69 74 65 33 5f 6f gs for sqlite3_o
b690: 70 65 6e 5f 76 32 28 29 20 61 72 65 20 53 51 4c pen_v2() are SQL
b6a0: 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
b6b0: 59 2c 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f Y,. ** SQLITE_O
b6c0: 50 45 4e 5f 52 45 41 44 57 52 49 54 45 2c 20 61 PEN_READWRITE, a
b6d0: 6e 64 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 nd SQLITE_OPEN_C
b6e0: 52 45 41 54 45 2e 20 20 53 69 6c 65 6e 74 6c 79 REATE. Silently
b6f0: 20 6d 61 73 6b 0a 20 20 2a 2a 20 6f 66 66 20 61 mask. ** off a
b700: 6c 6c 20 6f 74 68 65 72 20 66 6c 61 67 73 2e 0a ll other flags..
b710: 20 20 2a 2f 0a 20 20 66 6c 61 67 73 20 26 3d 20 */. flags &=
b720: 20 7e 28 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ~( SQLITE_OPEN_
b730: 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 20 7c 0a DELETEONCLOSE |.
b740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
b750: 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 QLITE_OPEN_EXCLU
b760: 53 49 56 45 20 7c 0a 20 20 20 20 20 20 20 20 20 SIVE |.
b770: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 SQLITE_OPE
b780: 4e 5f 4d 41 49 4e 5f 44 42 20 7c 0a 20 20 20 20 N_MAIN_DB |.
b790: 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
b7a0: 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 20 7c E_OPEN_TEMP_DB |
b7b0: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
b7c0: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 52 41 SQLITE_OPEN_TRA
b7d0: 4e 53 49 45 4e 54 5f 44 42 20 7c 20 0a 20 20 20 NSIENT_DB | .
b7e0: 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
b7f0: 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 TE_OPEN_MAIN_JOU
b800: 52 4e 41 4c 20 7c 20 0a 20 20 20 20 20 20 20 20 RNAL | .
b810: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
b820: 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 4e 41 4c 20 EN_TEMP_JOURNAL
b830: 7c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 | .
b840: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 SQLITE_OPEN_SU
b850: 42 4a 4f 55 52 4e 41 4c 20 7c 20 0a 20 20 20 20 BJOURNAL | .
b860: 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 SQLIT
b870: 45 5f 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f E_OPEN_MASTER_JO
b880: 55 52 4e 41 4c 20 7c 0a 20 20 20 20 20 20 20 20 URNAL |.
b890: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
b8a0: 45 4e 5f 4e 4f 4d 55 54 45 58 20 7c 0a 20 20 20 EN_NOMUTEX |.
b8b0: 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
b8c0: 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 TE_OPEN_FULLMUTE
b8d0: 58 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 29 X. )
b8e0: 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 ;.. /* Allocate
b8f0: 20 74 68 65 20 73 71 6c 69 74 65 20 64 61 74 61 the sqlite data
b900: 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 structure */.
b910: 64 62 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c db = sqlite3Mall
b920: 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 73 ocZero( sizeof(s
b930: 71 6c 69 74 65 33 29 20 29 3b 0a 20 20 69 66 28 qlite3) );. if(
b940: 20 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20 6f 70 db==0 ) goto op
b950: 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 69 66 28 20 endb_out;. if(
b960: 69 73 54 68 72 65 61 64 73 61 66 65 20 29 7b 0a isThreadsafe ){.
b970: 20 20 20 20 64 62 2d 3e 6d 75 74 65 78 20 3d 20 db->mutex =
b980: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
b990: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 52 c(SQLITE_MUTEX_R
b9a0: 45 43 55 52 53 49 56 45 29 3b 0a 20 20 20 20 69 ECURSIVE);. i
b9b0: 66 28 20 64 62 2d 3e 6d 75 74 65 78 3d 3d 30 20 f( db->mutex==0
b9c0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
b9d0: 5f 66 72 65 65 28 64 62 29 3b 0a 20 20 20 20 20 _free(db);.
b9e0: 20 64 62 20 3d 20 30 3b 0a 20 20 20 20 20 20 67 db = 0;. g
b9f0: 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a oto opendb_out;.
ba00: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 }. }. sqli
ba10: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
ba20: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 db->mutex);. db
ba30: 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30 78 66 66 ->errMask = 0xff
ba40: 3b 0a 20 20 64 62 2d 3e 6e 44 62 20 3d 20 32 3b ;. db->nDb = 2;
ba50: 0a 20 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 . db->magic = S
ba60: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 QLITE_MAGIC_BUSY
ba70: 3b 0a 20 20 64 62 2d 3e 61 44 62 20 3d 20 64 62 ;. db->aDb = db
ba80: 2d 3e 61 44 62 53 74 61 74 69 63 3b 0a 0a 20 20 ->aDbStatic;..
ba90: 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 64 assert( sizeof(d
baa0: 62 2d 3e 61 4c 69 6d 69 74 29 3d 3d 73 69 7a 65 b->aLimit)==size
bab0: 6f 66 28 61 48 61 72 64 4c 69 6d 69 74 29 20 29 of(aHardLimit) )
bac0: 3b 0a 20 20 6d 65 6d 63 70 79 28 64 62 2d 3e 61 ;. memcpy(db->a
bad0: 4c 69 6d 69 74 2c 20 61 48 61 72 64 4c 69 6d 69 Limit, aHardLimi
bae0: 74 2c 20 73 69 7a 65 6f 66 28 64 62 2d 3e 61 4c t, sizeof(db->aL
baf0: 69 6d 69 74 29 29 3b 0a 20 20 64 62 2d 3e 61 75 imit));. db->au
bb00: 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 toCommit = 1;.
bb10: 64 62 2d 3e 6e 65 78 74 41 75 74 6f 76 61 63 20 db->nextAutovac
bb20: 3d 20 2d 31 3b 0a 20 20 64 62 2d 3e 6e 65 78 74 = -1;. db->next
bb30: 50 61 67 65 73 69 7a 65 20 3d 20 30 3b 0a 20 20 Pagesize = 0;.
bb40: 64 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c db->flags |= SQL
bb50: 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 ITE_ShortColName
bb60: 73 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 s.#if SQLITE_DEF
bb70: 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 AULT_FILE_FORMAT
bb80: 3c 34 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 <4.
bb90: 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4c 65 67 | SQLITE_Leg
bba0: 61 63 79 46 69 6c 65 46 6d 74 0a 23 65 6e 64 69 acyFileFmt.#endi
bbb0: 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f f.#ifdef SQLITE_
bbc0: 45 4e 41 42 4c 45 5f 4c 4f 41 44 5f 45 58 54 45 ENABLE_LOAD_EXTE
bbd0: 4e 53 49 4f 4e 0a 20 20 20 20 20 20 20 20 20 20 NSION.
bbe0: 20 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f | SQLITE_
bbf0: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 0a 23 65 LoadExtension.#e
bc00: 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
bc10: 44 45 46 41 55 4c 54 5f 52 45 43 55 52 53 49 56 DEFAULT_RECURSIV
bc20: 45 5f 54 52 49 47 47 45 52 53 0a 20 20 20 20 20 E_TRIGGERS.
bc30: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 53 51 | SQ
bc40: 4c 49 54 45 5f 52 65 63 54 72 69 67 67 65 72 73 LITE_RecTriggers
bc50: 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 3b 0a .#endif. ;.
bc60: 20 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 sqlite3HashIni
bc70: 74 28 26 64 62 2d 3e 61 43 6f 6c 6c 53 65 71 29 t(&db->aCollSeq)
bc80: 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
bc90: 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
bca0: 4c 45 0a 20 20 73 71 6c 69 74 65 33 48 61 73 68 LE. sqlite3Hash
bcb0: 49 6e 69 74 28 26 64 62 2d 3e 61 4d 6f 64 75 6c Init(&db->aModul
bcc0: 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 64 62 e);.#endif.. db
bcd0: 2d 3e 70 56 66 73 20 3d 20 73 71 6c 69 74 65 33 ->pVfs = sqlite3
bce0: 5f 76 66 73 5f 66 69 6e 64 28 7a 56 66 73 29 3b _vfs_find(zVfs);
bcf0: 0a 20 20 69 66 28 20 21 64 62 2d 3e 70 56 66 73 . if( !db->pVfs
bd00: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
bd10: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 73 ITE_ERROR;. s
bd20: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
bd30: 72 63 2c 20 22 6e 6f 20 73 75 63 68 20 76 66 73 rc, "no such vfs
bd40: 3a 20 25 73 22 2c 20 7a 56 66 73 29 3b 0a 20 20 : %s", zVfs);.
bd50: 20 20 67 6f 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 goto opendb_ou
bd60: 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 64 64 t;. }.. /* Add
bd70: 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c the default col
bd80: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
bd90: 42 49 4e 41 52 59 2e 20 42 49 4e 41 52 59 20 77 BINARY. BINARY w
bda0: 6f 72 6b 73 20 66 6f 72 20 62 6f 74 68 20 55 54 orks for both UT
bdb0: 46 2d 38 0a 20 20 2a 2a 20 61 6e 64 20 55 54 46 F-8. ** and UTF
bdc0: 2d 31 36 2c 20 73 6f 20 61 64 64 20 61 20 76 65 -16, so add a ve
bdd0: 72 73 69 6f 6e 20 66 6f 72 20 65 61 63 68 20 74 rsion for each t
bde0: 6f 20 61 76 6f 69 64 20 61 6e 79 20 75 6e 6e 65 o avoid any unne
bdf0: 63 65 73 73 61 72 79 0a 20 20 2a 2a 20 63 6f 6e cessary. ** con
be00: 76 65 72 73 69 6f 6e 73 2e 20 54 68 65 20 6f 6e versions. The on
be10: 6c 79 20 65 72 72 6f 72 20 74 68 61 74 20 63 61 ly error that ca
be20: 6e 20 6f 63 63 75 72 20 68 65 72 65 20 69 73 20 n occur here is
be30: 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 a malloc() failu
be40: 72 65 2e 0a 20 20 2a 2f 0a 20 20 63 72 65 61 74 re.. */. creat
be50: 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 22 eCollation(db, "
be60: 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 5f BINARY", SQLITE_
be70: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 43 4f 4c UTF8, SQLITE_COL
be80: 4c 5f 42 49 4e 41 52 59 2c 20 30 2c 0a 20 20 20 L_BINARY, 0,.
be90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 b
bea0: 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a inCollFunc, 0);.
beb0: 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f createCollatio
bec0: 6e 28 64 62 2c 20 22 42 49 4e 41 52 59 22 2c 20 n(db, "BINARY",
bed0: 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c 20 SQLITE_UTF16BE,
bee0: 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 42 49 4e 41 SQLITE_COLL_BINA
bef0: 52 59 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 20 RY, 0,.
bf00: 20 20 20 20 20 20 20 20 20 62 69 6e 43 6f 6c 6c binColl
bf10: 46 75 6e 63 2c 20 30 29 3b 0a 20 20 63 72 65 61 Func, 0);. crea
bf20: 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 teCollation(db,
bf30: 22 42 49 4e 41 52 59 22 2c 20 53 51 4c 49 54 45 "BINARY", SQLITE
bf40: 5f 55 54 46 31 36 4c 45 2c 20 53 51 4c 49 54 45 _UTF16LE, SQLITE
bf50: 5f 43 4f 4c 4c 5f 42 49 4e 41 52 59 2c 20 30 2c _COLL_BINARY, 0,
bf60: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
bf70: 20 20 20 62 69 6e 43 6f 6c 6c 46 75 6e 63 2c 20 binCollFunc,
bf80: 30 29 3b 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 0);. createColl
bf90: 61 74 69 6f 6e 28 64 62 2c 20 22 52 54 52 49 4d ation(db, "RTRIM
bfa0: 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 ", SQLITE_UTF8,
bfb0: 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 55 53 45 52 SQLITE_COLL_USER
bfc0: 2c 20 28 76 6f 69 64 2a 29 31 2c 0a 20 20 20 20 , (void*)1,.
bfd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 69 bi
bfe0: 6e 43 6f 6c 6c 46 75 6e 63 2c 20 30 29 3b 0a 20 nCollFunc, 0);.
bff0: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( db->mallocF
c000: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 6f 74 ailed ){. got
c010: 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 o opendb_out;.
c020: 7d 0a 20 20 64 62 2d 3e 70 44 66 6c 74 43 6f 6c }. db->pDfltCol
c030: 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 43 l = sqlite3FindC
c040: 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c 49 54 ollSeq(db, SQLIT
c050: 45 5f 55 54 46 38 2c 20 22 42 49 4e 41 52 59 22 E_UTF8, "BINARY"
c060: 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 , 0);. assert(
c070: 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 21 3d 30 db->pDfltColl!=0
c080: 20 29 3b 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 61 );.. /* Also a
c090: 64 64 20 61 20 55 54 46 2d 38 20 63 61 73 65 2d dd a UTF-8 case-
c0a0: 69 6e 73 65 6e 73 69 74 69 76 65 20 63 6f 6c 6c insensitive coll
c0b0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 2e 20 ation sequence.
c0c0: 2a 2f 0a 20 20 63 72 65 61 74 65 43 6f 6c 6c 61 */. createColla
c0d0: 74 69 6f 6e 28 64 62 2c 20 22 4e 4f 43 41 53 45 tion(db, "NOCASE
c0e0: 22 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 ", SQLITE_UTF8,
c0f0: 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 4e 4f 43 41 SQLITE_COLL_NOCA
c100: 53 45 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 20 SE, 0,.
c110: 20 20 20 20 20 20 20 20 20 6e 6f 63 61 73 65 43 nocaseC
c120: 6f 6c 6c 61 74 69 6e 67 46 75 6e 63 2c 20 30 29 ollatingFunc, 0)
c130: 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 ;.. /* Open the
c140: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 backend databas
c150: 65 20 64 72 69 76 65 72 20 2a 2f 0a 20 20 64 62 e driver */. db
c160: 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 66 6c ->openFlags = fl
c170: 61 67 73 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ags;. rc = sqli
c180: 74 65 33 42 74 72 65 65 46 61 63 74 6f 72 79 28 te3BtreeFactory(
c190: 64 62 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 db, zFilename, 0
c1a0: 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 , SQLITE_DEFAULT
c1b0: 5f 43 41 43 48 45 5f 53 49 5a 45 2c 20 0a 20 20 _CACHE_SIZE, .
c1c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c1d0: 20 20 20 20 20 20 20 20 20 66 6c 61 67 73 20 7c flags |
c1e0: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
c1f0: 4e 5f 44 42 2c 0a 20 20 20 20 20 20 20 20 20 20 N_DB,.
c200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c210: 20 26 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 &db->aDb[0].pBt
c220: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
c230: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 ITE_OK ){. if
c240: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 ( rc==SQLITE_IOE
c250: 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 RR_NOMEM ){.
c260: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
c270: 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 MEM;. }. s
c280: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
c290: 72 63 2c 20 30 29 3b 0a 20 20 20 20 67 6f 74 6f rc, 0);. goto
c2a0: 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d opendb_out;. }
c2b0: 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 53 . db->aDb[0].pS
c2c0: 63 68 65 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 chema = sqlite3S
c2d0: 63 68 65 6d 61 47 65 74 28 64 62 2c 20 64 62 2d chemaGet(db, db-
c2e0: 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 >aDb[0].pBt);.
c2f0: 64 62 2d 3e 61 44 62 5b 31 5d 2e 70 53 63 68 65 db->aDb[1].pSche
c300: 6d 61 20 3d 20 73 71 6c 69 74 65 33 53 63 68 65 ma = sqlite3Sche
c310: 6d 61 47 65 74 28 64 62 2c 20 30 29 3b 0a 0a 0a maGet(db, 0);...
c320: 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74 /* The default
c330: 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 66 6f safety_level fo
c340: 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 r the main datab
c350: 61 73 65 20 69 73 20 27 66 75 6c 6c 27 3b 20 66 ase is 'full'; f
c360: 6f 72 20 74 68 65 20 74 65 6d 70 0a 20 20 2a 2a or the temp. **
c370: 20 64 61 74 61 62 61 73 65 20 69 74 20 69 73 20 database it is
c380: 27 4e 4f 4e 45 27 2e 20 54 68 69 73 20 6d 61 74 'NONE'. This mat
c390: 63 68 65 73 20 74 68 65 20 70 61 67 65 72 20 6c ches the pager l
c3a0: 61 79 65 72 20 64 65 66 61 75 6c 74 73 2e 20 20 ayer defaults.
c3b0: 0a 20 20 2a 2f 0a 20 20 64 62 2d 3e 61 44 62 5b . */. db->aDb[
c3c0: 30 5d 2e 7a 4e 61 6d 65 20 3d 20 22 6d 61 69 6e 0].zName = "main
c3d0: 22 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 30 5d 2e ";. db->aDb[0].
c3e0: 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 33 safety_level = 3
c3f0: 3b 0a 20 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 7a ;. db->aDb[1].z
c400: 4e 61 6d 65 20 3d 20 22 74 65 6d 70 22 3b 0a 20 Name = "temp";.
c410: 20 64 62 2d 3e 61 44 62 5b 31 5d 2e 73 61 66 65 db->aDb[1].safe
c420: 74 79 5f 6c 65 76 65 6c 20 3d 20 31 3b 0a 0a 20 ty_level = 1;..
c430: 20 64 62 2d 3e 6d 61 67 69 63 20 3d 20 53 51 4c db->magic = SQL
c440: 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 3b 0a ITE_MAGIC_OPEN;.
c450: 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 if( db->malloc
c460: 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 67 6f Failed ){. go
c470: 74 6f 20 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 to opendb_out;.
c480: 20 7d 0a 0a 20 20 2f 2a 20 52 65 67 69 73 74 65 }.. /* Registe
c490: 72 20 61 6c 6c 20 62 75 69 6c 74 2d 69 6e 20 66 r all built-in f
c4a0: 75 6e 63 74 69 6f 6e 73 2c 20 62 75 74 20 64 6f unctions, but do
c4b0: 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 not attempt to
c4c0: 72 65 61 64 20 74 68 65 0a 20 20 2a 2a 20 64 61 read the. ** da
c4d0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 79 65 tabase schema ye
c4e0: 74 2e 20 54 68 69 73 20 69 73 20 64 65 6c 61 79 t. This is delay
c4f0: 65 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 ed until the fir
c500: 73 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 st time the data
c510: 62 61 73 65 0a 20 20 2a 2a 20 69 73 20 61 63 63 base. ** is acc
c520: 65 73 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 essed.. */. sq
c530: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 lite3Error(db, S
c540: 51 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 QLITE_OK, 0);.
c550: 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 sqlite3RegisterB
c560: 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 uiltinFunctions(
c570: 64 62 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 61 64 20 db);.. /* Load
c580: 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 automatic extens
c590: 69 6f 6e 73 20 2d 20 65 78 74 65 6e 73 69 6f 6e ions - extension
c5a0: 73 20 74 68 61 74 20 68 61 76 65 20 62 65 65 6e s that have been
c5b0: 20 72 65 67 69 73 74 65 72 65 64 0a 20 20 2a 2a registered. **
c5c0: 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 using the sqlit
c5d0: 65 33 5f 61 75 74 6f 6d 61 74 69 63 5f 65 78 74 e3_automatic_ext
c5e0: 65 6e 73 69 6f 6e 28 29 20 41 50 49 2e 0a 20 20 ension() API..
c5f0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 41 75 74 6f */. sqlite3Auto
c600: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 64 LoadExtensions(d
c610: 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 b);. rc = sqlit
c620: 65 33 5f 65 72 72 63 6f 64 65 28 64 62 29 3b 0a e3_errcode(db);.
c630: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
c640: 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 _OK ){. goto
c650: 6f 70 65 6e 64 62 5f 6f 75 74 3b 0a 20 20 7d 0a opendb_out;. }.
c660: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
c670: 4e 41 42 4c 45 5f 46 54 53 31 0a 20 20 69 66 28 NABLE_FTS1. if(
c680: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c !db->mallocFail
c690: 65 64 20 29 7b 0a 20 20 20 20 65 78 74 65 72 6e ed ){. extern
c6a0: 20 69 6e 74 20 73 71 6c 69 74 65 33 46 74 73 31 int sqlite3Fts1
c6b0: 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a Init(sqlite3*);.
c6c0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
c6d0: 46 74 73 31 49 6e 69 74 28 64 62 29 3b 0a 20 20 Fts1Init(db);.
c6e0: 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 }.#endif..#ifdef
c6f0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
c700: 54 53 32 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d TS2. if( !db->m
c710: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 72 allocFailed && r
c720: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
c730: 20 20 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 extern int s
c740: 71 6c 69 74 65 33 46 74 73 32 49 6e 69 74 28 73 qlite3Fts2Init(s
c750: 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 20 72 63 qlite3*);. rc
c760: 20 3d 20 73 71 6c 69 74 65 33 46 74 73 32 49 6e = sqlite3Fts2In
c770: 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
c780: 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
c790: 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a 20 20 E_ENABLE_FTS3.
c7a0: 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 if( !db->mallocF
c7b0: 61 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c ailed && rc==SQL
c7c0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
c7d0: 20 3d 20 73 71 6c 69 74 65 33 46 74 73 33 49 6e = sqlite3Fts3In
c7e0: 69 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 it(db);. }.#end
c7f0: 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
c800: 45 5f 45 4e 41 42 4c 45 5f 49 43 55 0a 20 20 69 E_ENABLE_ICU. i
c810: 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
c820: 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 iled && rc==SQLI
c830: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
c840: 3d 20 73 71 6c 69 74 65 33 49 63 75 49 6e 69 74 = sqlite3IcuInit
c850: 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 (db);. }.#endif
c860: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
c870: 45 4e 41 42 4c 45 5f 52 54 52 45 45 0a 20 20 69 ENABLE_RTREE. i
c880: 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 f( !db->mallocFa
c890: 69 6c 65 64 20 26 26 20 72 63 3d 3d 53 51 4c 49 iled && rc==SQLI
c8a0: 54 45 5f 4f 4b 29 7b 0a 20 20 20 20 72 63 20 3d TE_OK){. rc =
c8b0: 20 73 71 6c 69 74 65 33 52 74 72 65 65 49 6e 69 sqlite3RtreeIni
c8c0: 74 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 t(db);. }.#endi
c8d0: 66 0a 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f f.. sqlite3Erro
c8e0: 72 28 64 62 2c 20 72 63 2c 20 30 29 3b 0a 0a 20 r(db, rc, 0);..
c8f0: 20 2f 2a 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 /* -DSQLITE_DEF
c900: 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
c910: 45 3d 31 20 6d 61 6b 65 73 20 45 58 43 4c 55 53 E=1 makes EXCLUS
c920: 49 56 45 20 74 68 65 20 64 65 66 61 75 6c 74 20 IVE the default
c930: 6c 6f 63 6b 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 locking. ** mod
c940: 65 2e 20 20 2d 44 53 51 4c 49 54 45 5f 44 45 46 e. -DSQLITE_DEF
c950: 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 AULT_LOCKING_MOD
c960: 45 3d 30 20 6d 61 6b 65 20 4e 4f 52 4d 41 4c 20 E=0 make NORMAL
c970: 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b the default lock
c980: 69 6e 67 0a 20 20 2a 2a 20 6d 6f 64 65 2e 20 20 ing. ** mode.
c990: 44 6f 69 6e 67 20 6e 6f 74 68 69 6e 67 20 61 74 Doing nothing at
c9a0: 20 61 6c 6c 20 61 6c 73 6f 20 6d 61 6b 65 73 20 all also makes
c9b0: 4e 4f 52 4d 41 4c 20 74 68 65 20 64 65 66 61 75 NORMAL the defau
c9c0: 6c 74 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 lt.. */.#ifdef
c9d0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c SQLITE_DEFAULT_L
c9e0: 4f 43 4b 49 4e 47 5f 4d 4f 44 45 0a 20 20 64 62 OCKING_MODE. db
c9f0: 2d 3e 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 20 3d ->dfltLockMode =
ca00: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
ca10: 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3b 0a 20 20 LOCKING_MODE;.
ca20: 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 63 6b sqlite3PagerLock
ca30: 69 6e 67 4d 6f 64 65 28 73 71 6c 69 74 65 33 42 ingMode(sqlite3B
ca40: 74 72 65 65 50 61 67 65 72 28 64 62 2d 3e 61 44 treePager(db->aD
ca50: 62 5b 30 5d 2e 70 42 74 29 2c 0a 20 20 20 20 20 b[0].pBt),.
ca60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ca70: 20 20 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 SQLITE_DEFA
ca80: 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 ULT_LOCKING_MODE
ca90: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 );.#endif.. /*
caa0: 45 6e 61 62 6c 65 20 74 68 65 20 6c 6f 6f 6b 61 Enable the looka
cab0: 73 69 64 65 2d 6d 61 6c 6c 6f 63 20 73 75 62 73 side-malloc subs
cac0: 79 73 74 65 6d 20 2a 2f 0a 20 20 73 65 74 75 70 ystem */. setup
cad0: 4c 6f 6f 6b 61 73 69 64 65 28 64 62 2c 20 30 2c Lookaside(db, 0,
cae0: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f sqlite3GlobalCo
caf0: 6e 66 69 67 2e 73 7a 4c 6f 6f 6b 61 73 69 64 65 nfig.szLookaside
cb00: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
cb10: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
cb20: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6e 4c 3GlobalConfig.nL
cb30: 6f 6f 6b 61 73 69 64 65 29 3b 0a 0a 6f 70 65 6e ookaside);..open
cb40: 64 62 5f 6f 75 74 3a 0a 20 20 69 66 28 20 64 62 db_out:. if( db
cb50: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
cb60: 64 62 2d 3e 6d 75 74 65 78 21 3d 30 20 7c 7c 20 db->mutex!=0 ||
cb70: 69 73 54 68 72 65 61 64 73 61 66 65 3d 3d 30 20 isThreadsafe==0
cb80: 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c || sqlite3Global
cb90: 43 6f 6e 66 69 67 2e 62 46 75 6c 6c 4d 75 74 65 Config.bFullMute
cba0: 78 3d 3d 30 20 29 3b 0a 20 20 20 20 73 71 6c 69 x==0 );. sqli
cbb0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
cbc0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a db->mutex);. }.
cbd0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 rc = sqlite3_e
cbe0: 72 72 63 6f 64 65 28 64 62 29 3b 0a 20 20 69 66 rrcode(db);. if
cbf0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d ( rc==SQLITE_NOM
cc00: 45 4d 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 EM ){. sqlite
cc10: 33 5f 63 6c 6f 73 65 28 64 62 29 3b 0a 20 20 20 3_close(db);.
cc20: 20 64 62 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 db = 0;. }else
cc30: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
cc40: 4f 4b 20 29 7b 0a 20 20 20 20 64 62 2d 3e 6d 61 OK ){. db->ma
cc50: 67 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 41 47 gic = SQLITE_MAG
cc60: 49 43 5f 53 49 43 4b 3b 0a 20 20 7d 0a 20 20 2a IC_SICK;. }. *
cc70: 70 70 44 62 20 3d 20 64 62 3b 0a 20 20 72 65 74 ppDb = db;. ret
cc80: 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 urn sqlite3ApiEx
cc90: 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 0a 2f 2a it(0, rc);.}../*
cca0: 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 .** Open a new d
ccb0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a atabase handle..
ccc0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f */.int sqlite3_o
ccd0: 70 65 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 pen(. const cha
cce0: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 r *zFilename, .
ccf0: 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 20 sqlite3 **ppDb
cd00: 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 65 .){. return ope
cd10: 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e nDatabase(zFilen
cd20: 61 6d 65 2c 20 70 70 44 62 2c 0a 20 20 20 20 20 ame, ppDb,.
cd30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cd40: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
cd50: 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f DWRITE | SQLITE_
cd60: 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 29 3b OPEN_CREATE, 0);
cd70: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f .}.int sqlite3_o
cd80: 70 65 6e 5f 76 32 28 0a 20 20 63 6f 6e 73 74 20 pen_v2(. const
cd90: 63 68 61 72 20 2a 66 69 6c 65 6e 61 6d 65 2c 20 char *filename,
cda0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 /* Database fi
cdb0: 6c 65 6e 61 6d 65 20 28 55 54 46 2d 38 29 20 2a lename (UTF-8) *
cdc0: 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 /. sqlite3 **pp
cdd0: 44 62 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4f Db, /* O
cde0: 55 54 3a 20 53 51 4c 69 74 65 20 64 62 20 68 61 UT: SQLite db ha
cdf0: 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c ndle */. int fl
ce00: 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 ags,
ce10: 20 20 2f 2a 20 46 6c 61 67 73 20 2a 2f 0a 20 20 /* Flags */.
ce20: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 56 66 73 const char *zVfs
ce30: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
ce40: 6f 66 20 56 46 53 20 6d 6f 64 75 6c 65 20 74 6f of VFS module to
ce50: 20 75 73 65 20 2a 2f 0a 29 7b 0a 20 20 72 65 74 use */.){. ret
ce60: 75 72 6e 20 6f 70 65 6e 44 61 74 61 62 61 73 65 urn openDatabase
ce70: 28 66 69 6c 65 6e 61 6d 65 2c 20 70 70 44 62 2c (filename, ppDb,
ce80: 20 66 6c 61 67 73 2c 20 7a 56 66 73 29 3b 0a 7d flags, zVfs);.}
ce90: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
cea0: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a _OMIT_UTF16./*.*
ceb0: 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 64 61 74 * Open a new dat
cec0: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f abase handle..*/
ced0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65 .int sqlite3_ope
cee0: 6e 31 36 28 0a 20 20 63 6f 6e 73 74 20 76 6f 69 n16(. const voi
cef0: 64 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 0a 20 d *zFilename, .
cf00: 20 73 71 6c 69 74 65 33 20 2a 2a 70 70 44 62 0a sqlite3 **ppDb.
cf10: 29 7b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 ){. char const
cf20: 2a 7a 46 69 6c 65 6e 61 6d 65 38 3b 20 20 20 2f *zFilename8; /
cf30: 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 65 6e 63 6f * zFilename enco
cf40: 64 65 64 20 69 6e 20 55 54 46 2d 38 20 69 6e 73 ded in UTF-8 ins
cf50: 74 65 61 64 20 6f 66 20 55 54 46 2d 31 36 20 2a tead of UTF-16 *
cf60: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 /. sqlite3_valu
cf70: 65 20 2a 70 56 61 6c 3b 0a 20 20 69 6e 74 20 72 e *pVal;. int r
cf80: 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 7a 46 c;.. assert( zF
cf90: 69 6c 65 6e 61 6d 65 20 29 3b 0a 20 20 61 73 73 ilename );. ass
cfa0: 65 72 74 28 20 70 70 44 62 20 29 3b 0a 20 20 2a ert( ppDb );. *
cfb0: 70 70 44 62 20 3d 20 30 3b 0a 23 69 66 6e 64 65 ppDb = 0;.#ifnde
cfc0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
cfd0: 54 4f 49 4e 49 54 0a 20 20 72 63 20 3d 20 73 71 TOINIT. rc = sq
cfe0: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
cff0: 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 ();. if( rc ) r
d000: 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66 eturn rc;.#endif
d010: 0a 20 20 70 56 61 6c 20 3d 20 73 71 6c 69 74 65 . pVal = sqlite
d020: 33 56 61 6c 75 65 4e 65 77 28 30 29 3b 0a 20 20 3ValueNew(0);.
d030: 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53 sqlite3ValueSetS
d040: 74 72 28 70 56 61 6c 2c 20 2d 31 2c 20 7a 46 69 tr(pVal, -1, zFi
d050: 6c 65 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 55 lename, SQLITE_U
d060: 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c 49 TF16NATIVE, SQLI
d070: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7a 46 TE_STATIC);. zF
d080: 69 6c 65 6e 61 6d 65 38 20 3d 20 73 71 6c 69 74 ilename8 = sqlit
d090: 65 33 56 61 6c 75 65 54 65 78 74 28 70 56 61 6c e3ValueText(pVal
d0a0: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29 3b 0a , SQLITE_UTF8);.
d0b0: 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 38 if( zFilename8
d0c0: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 70 65 ){. rc = ope
d0d0: 6e 44 61 74 61 62 61 73 65 28 7a 46 69 6c 65 6e nDatabase(zFilen
d0e0: 61 6d 65 38 2c 20 70 70 44 62 2c 0a 20 20 20 20 ame8, ppDb,.
d0f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d100: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 SQLITE_OPEN_RE
d110: 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 ADWRITE | SQLITE
d120: 5f 4f 50 45 4e 5f 43 52 45 41 54 45 2c 20 30 29 _OPEN_CREATE, 0)
d130: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 ;. assert( *p
d140: 70 44 62 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 pDb || rc==SQLIT
d150: 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 69 E_NOMEM );. i
d160: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
d170: 20 26 26 20 21 44 62 48 61 73 50 72 6f 70 65 72 && !DbHasProper
d180: 74 79 28 2a 70 70 44 62 2c 20 30 2c 20 44 42 5f ty(*ppDb, 0, DB_
d190: 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b SchemaLoaded) ){
d1a0: 0a 20 20 20 20 20 20 45 4e 43 28 2a 70 70 44 62 . ENC(*ppDb
d1b0: 29 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 31 36 ) = SQLITE_UTF16
d1c0: 4e 41 54 49 56 45 3b 0a 20 20 20 20 7d 0a 20 20 NATIVE;. }.
d1d0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 }else{. rc =
d1e0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
d1f0: 7d 0a 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 }. sqlite3Value
d200: 46 72 65 65 28 70 56 61 6c 29 3b 0a 0a 20 20 72 Free(pVal);.. r
d210: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70 69 eturn sqlite3Api
d220: 45 78 69 74 28 30 2c 20 72 63 29 3b 0a 7d 0a 23 Exit(0, rc);.}.#
d230: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
d240: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f OMIT_UTF16 */../
d250: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
d260: 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 new collation se
d270: 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 65 20 quence with the
d280: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
d290: 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 db..*/.int sqlit
d2a0: 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 e3_create_collat
d2b0: 69 6f 6e 28 0a 20 20 73 71 6c 69 74 65 33 2a 20 ion(. sqlite3*
d2c0: 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 db, . const cha
d2d0: 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e 74 r *zName, . int
d2e0: 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 70 enc, . void* p
d2f0: 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f 6d Ctx,. int(*xCom
d300: 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 2c pare)(void*,int,
d310: 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 2c const void*,int,
d320: 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a const void*).){.
d330: 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 int rc;. sqli
d340: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
d350: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 db->mutex);. as
d360: 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f sert( !db->mallo
d370: 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 72 63 20 cFailed );. rc
d380: 3d 20 63 72 65 61 74 65 43 6f 6c 6c 61 74 69 6f = createCollatio
d390: 6e 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 28 75 38 n(db, zName, (u8
d3a0: 29 65 6e 63 2c 20 53 51 4c 49 54 45 5f 43 4f 4c )enc, SQLITE_COL
d3b0: 4c 5f 55 53 45 52 2c 20 70 43 74 78 2c 20 78 43 L_USER, pCtx, xC
d3c0: 6f 6d 70 61 72 65 2c 20 30 29 3b 0a 20 20 72 63 ompare, 0);. rc
d3d0: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 = sqlite3ApiExi
d3e0: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c t(db, rc);. sql
d3f0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
d400: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
d410: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
d420: 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 6e 65 ** Register a ne
d430: 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 w collation sequ
d440: 65 6e 63 65 20 77 69 74 68 20 74 68 65 20 64 61 ence with the da
d450: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 tabase handle db
d460: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
d470: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f _create_collatio
d480: 6e 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33 2a n_v2(. sqlite3*
d490: 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 db, . const ch
d4a0: 61 72 20 2a 7a 4e 61 6d 65 2c 20 0a 20 20 69 6e ar *zName, . in
d4b0: 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 2a 20 t enc, . void*
d4c0: 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 43 6f pCtx,. int(*xCo
d4d0: 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 6e 74 mpare)(void*,int
d4e0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 6e 74 ,const void*,int
d4f0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 2c 0a 20 ,const void*),.
d500: 20 76 6f 69 64 28 2a 78 44 65 6c 29 28 76 6f 69 void(*xDel)(voi
d510: 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b d*).){. int rc;
d520: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
d530: 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
d540: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 64 62 );. assert( !db
d550: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
d560: 3b 0a 20 20 72 63 20 3d 20 63 72 65 61 74 65 43 ;. rc = createC
d570: 6f 6c 6c 61 74 69 6f 6e 28 64 62 2c 20 7a 4e 61 ollation(db, zNa
d580: 6d 65 2c 20 28 75 38 29 65 6e 63 2c 20 53 51 4c me, (u8)enc, SQL
d590: 49 54 45 5f 43 4f 4c 4c 5f 55 53 45 52 2c 20 70 ITE_COLL_USER, p
d5a0: 43 74 78 2c 20 78 43 6f 6d 70 61 72 65 2c 20 78 Ctx, xCompare, x
d5b0: 44 65 6c 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c Del);. rc = sql
d5c0: 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 ite3ApiExit(db,
d5d0: 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc);. sqlite3_m
d5e0: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
d5f0: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
d600: 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 rc;.}..#ifndef S
d610: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 QLITE_OMIT_UTF16
d620: 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 ./*.** Register
d630: 61 20 6e 65 77 20 63 6f 6c 6c 61 74 69 6f 6e 20 a new collation
d640: 73 65 71 75 65 6e 63 65 20 77 69 74 68 20 74 68 sequence with th
d650: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c e database handl
d660: 65 20 64 62 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c e db..*/.int sql
d670: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
d680: 61 74 69 6f 6e 31 36 28 0a 20 20 73 71 6c 69 74 ation16(. sqlit
d690: 65 33 2a 20 64 62 2c 20 0a 20 20 63 6f 6e 73 74 e3* db, . const
d6a0: 20 76 6f 69 64 20 2a 7a 4e 61 6d 65 2c 0a 20 20 void *zName,.
d6b0: 69 6e 74 20 65 6e 63 2c 20 0a 20 20 76 6f 69 64 int enc, . void
d6c0: 2a 20 70 43 74 78 2c 0a 20 20 69 6e 74 28 2a 78 * pCtx,. int(*x
d6d0: 43 6f 6d 70 61 72 65 29 28 76 6f 69 64 2a 2c 69 Compare)(void*,i
d6e0: 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 69 nt,const void*,i
d6f0: 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a nt,const void*).
d700: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
d710: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 68 61 72 20 LITE_OK;. char
d720: 2a 7a 4e 61 6d 65 38 3b 0a 20 20 73 71 6c 69 74 *zName8;. sqlit
d730: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
d740: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 b->mutex);. ass
d750: 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 ert( !db->malloc
d760: 46 61 69 6c 65 64 20 29 3b 0a 20 20 7a 4e 61 6d Failed );. zNam
d770: 65 38 20 3d 20 73 71 6c 69 74 65 33 55 74 66 31 e8 = sqlite3Utf1
d780: 36 74 6f 38 28 64 62 2c 20 7a 4e 61 6d 65 2c 20 6to8(db, zName,
d790: 2d 31 29 3b 0a 20 20 69 66 28 20 7a 4e 61 6d 65 -1);. if( zName
d7a0: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 63 72 8 ){. rc = cr
d7b0: 65 61 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 64 62 eateCollation(db
d7c0: 2c 20 7a 4e 61 6d 65 38 2c 20 28 75 38 29 65 6e , zName8, (u8)en
d7d0: 63 2c 20 53 51 4c 49 54 45 5f 43 4f 4c 4c 5f 55 c, SQLITE_COLL_U
d7e0: 53 45 52 2c 20 70 43 74 78 2c 20 78 43 6f 6d 70 SER, pCtx, xComp
d7f0: 61 72 65 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c are, 0);. sql
d800: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a ite3DbFree(db, z
d810: 4e 61 6d 65 38 29 3b 0a 20 20 7d 0a 20 20 72 63 Name8);. }. rc
d820: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 = sqlite3ApiExi
d830: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c t(db, rc);. sql
d840: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
d850: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 (db->mutex);. r
d860: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 eturn rc;.}.#end
d870: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
d880: 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a T_UTF16 */../*.*
d890: 2a 20 52 65 67 69 73 74 65 72 20 61 20 63 6f 6c * Register a col
d8a0: 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
d8b0: 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 61 63 6b factory callback
d8c0: 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 with the databa
d8d0: 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e se handle.** db.
d8e0: 20 52 65 70 6c 61 63 65 20 61 6e 79 20 70 72 65 Replace any pre
d8f0: 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 6c 6c 65 viously installe
d900: 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 d collation sequ
d910: 65 6e 63 65 20 66 61 63 74 6f 72 79 2e 0a 2a 2f ence factory..*/
d920: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c .int sqlite3_col
d930: 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 28 0a 20 lation_needed(.
d940: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 0a 20 sqlite3 *db, .
d950: 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 void *pCollNeed
d960: 65 64 41 72 67 2c 20 0a 20 20 76 6f 69 64 28 2a edArg, . void(*
d970: 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 xCollNeeded)(voi
d980: 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 d*,sqlite3*,int
d990: 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 eTextRep,const c
d9a0: 68 61 72 2a 29 0a 29 7b 0a 20 20 73 71 6c 69 74 har*).){. sqlit
d9b0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 e3_mutex_enter(d
d9c0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d b->mutex);. db-
d9d0: 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 20 3d 20 78 >xCollNeeded = x
d9e0: 43 6f 6c 6c 4e 65 65 64 65 64 3b 0a 20 20 64 62 CollNeeded;. db
d9f0: 2d 3e 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 ->xCollNeeded16
da00: 3d 20 30 3b 0a 20 20 64 62 2d 3e 70 43 6f 6c 6c = 0;. db->pColl
da10: 4e 65 65 64 65 64 41 72 67 20 3d 20 70 43 6f 6c NeededArg = pCol
da20: 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 73 71 lNeededArg;. sq
da30: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
da40: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 e(db->mutex);.
da50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
da60: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ;.}..#ifndef SQL
da70: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f ITE_OMIT_UTF16./
da80: 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72 20 61 20 *.** Register a
da90: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
daa0: 63 65 20 66 61 63 74 6f 72 79 20 63 61 6c 6c 62 ce factory callb
dab0: 61 63 6b 20 77 69 74 68 20 74 68 65 20 64 61 74 ack with the dat
dac0: 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 abase handle.**
dad0: 64 62 2e 20 52 65 70 6c 61 63 65 20 61 6e 79 20 db. Replace any
dae0: 70 72 65 76 69 6f 75 73 6c 79 20 69 6e 73 74 61 previously insta
daf0: 6c 6c 65 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 lled collation s
db00: 65 71 75 65 6e 63 65 20 66 61 63 74 6f 72 79 2e equence factory.
db10: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
db20: 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 collation_needed
db30: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 16(. sqlite3 *d
db40: 62 2c 20 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c b, . void *pCol
db50: 6c 4e 65 65 64 65 64 41 72 67 2c 20 0a 20 20 76 lNeededArg, . v
db60: 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 oid(*xCollNeeded
db70: 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 16)(void*,sqlite
db80: 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 3*,int eTextRep,
db90: 63 6f 6e 73 74 20 76 6f 69 64 2a 29 0a 29 7b 0a const void*).){.
dba0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
dbb0: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
dbc0: 3b 0a 20 20 64 62 2d 3e 78 43 6f 6c 6c 4e 65 65 ;. db->xCollNee
dbd0: 64 65 64 20 3d 20 30 3b 0a 20 20 64 62 2d 3e 78 ded = 0;. db->x
dbe0: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 20 3d 20 78 CollNeeded16 = x
dbf0: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 3b 0a 20 20 CollNeeded16;.
dc00: 64 62 2d 3e 70 43 6f 6c 6c 4e 65 65 64 65 64 41 db->pCollNeededA
dc10: 72 67 20 3d 20 70 43 6f 6c 6c 4e 65 65 64 65 64 rg = pCollNeeded
dc20: 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d Arg;. sqlite3_m
dc30: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
dc40: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
dc50: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e SQLITE_OK;.}.#en
dc60: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
dc70: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 23 69 66 IT_UTF16 */..#if
dc80: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
dc90: 5f 47 4c 4f 42 41 4c 52 45 43 4f 56 45 52 0a 23 _GLOBALRECOVER.#
dca0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
dcb0: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a IT_DEPRECATED./*
dcc0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
dcd0: 6e 20 69 73 20 6e 6f 77 20 61 6e 20 61 6e 61 63 n is now an anac
dce0: 68 72 6f 6e 69 73 6d 2e 20 49 74 20 75 73 65 64 hronism. It used
dcf0: 20 74 6f 20 62 65 20 75 73 65 64 20 74 6f 20 72 to be used to r
dd00: 65 63 6f 76 65 72 20 66 72 6f 6d 20 61 0a 2a 2a ecover from a.**
dd10: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 malloc() failur
dd20: 65 2c 20 62 75 74 20 53 51 4c 69 74 65 20 6e 6f e, but SQLite no
dd30: 77 20 64 6f 65 73 20 74 68 69 73 20 61 75 74 6f w does this auto
dd40: 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2f 0a 69 6e matically..*/.in
dd50: 74 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c t sqlite3_global
dd60: 5f 72 65 63 6f 76 65 72 28 76 6f 69 64 29 7b 0a _recover(void){.
dd70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
dd80: 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 23 65 6e OK;.}.#endif.#en
dd90: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 dif../*.** Test
dda0: 74 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 6f to see whether o
ddb0: 72 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 r not the databa
ddc0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 se connection is
ddd0: 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 0a 2a in autocommit.*
dde0: 2a 20 6d 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 * mode. Return
ddf0: 54 52 55 45 20 69 66 20 69 74 20 69 73 20 61 6e TRUE if it is an
de00: 64 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 2e 20 d FALSE if not.
de10: 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 Autocommit mode
de20: 20 69 73 20 6f 6e 0a 2a 2a 20 62 79 20 64 65 66 is on.** by def
de30: 61 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 ault. Autocommi
de40: 74 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 t is disabled by
de50: 20 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65 a BEGIN stateme
de60: 6e 74 20 61 6e 64 20 72 65 65 6e 61 62 6c 65 64 nt and reenabled
de70: 0a 2a 2a 20 62 79 20 74 68 65 20 6e 65 78 74 20 .** by the next
de80: 43 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c 4c 42 41 COMMIT or ROLLBA
de90: 43 4b 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 20 54 CK..**.******* T
dea0: 48 49 53 20 49 53 20 41 4e 20 45 58 50 45 52 49 HIS IS AN EXPERI
deb0: 4d 45 4e 54 41 4c 20 41 50 49 20 41 4e 44 20 49 MENTAL API AND I
dec0: 53 20 53 55 42 4a 45 43 54 20 54 4f 20 43 48 41 S SUBJECT TO CHA
ded0: 4e 47 45 20 2a 2a 2a 2a 2a 2a 0a 2a 2f 0a 69 6e NGE ******.*/.in
dee0: 74 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 t sqlite3_get_au
def0: 74 6f 63 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 tocommit(sqlite3
df00: 20 2a 64 62 29 7b 0a 20 20 72 65 74 75 72 6e 20 *db){. return
df10: 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 3b 0a db->autoCommit;.
df20: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
df30: 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 54 68 65 _DEBUG./*.** The
df40: 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 following routi
df50: 6e 65 20 69 73 20 73 75 62 74 69 74 75 74 65 64 ne is subtituted
df60: 20 66 6f 72 20 63 6f 6e 73 74 61 6e 74 20 53 51 for constant SQ
df70: 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69 6e 0a LITE_CORRUPT in.
df80: 2a 2a 20 64 65 62 75 67 67 69 6e 67 20 62 75 69 ** debugging bui
df90: 6c 64 73 2e 20 20 54 68 69 73 20 70 72 6f 76 69 lds. This provi
dfa0: 64 65 73 20 61 20 77 61 79 20 74 6f 20 73 65 74 des a way to set
dfb0: 20 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 66 6f a breakpoint fo
dfc0: 72 20 77 68 65 6e 0a 2a 2a 20 63 6f 72 72 75 70 r when.** corrup
dfd0: 74 69 6f 6e 20 69 73 20 66 69 72 73 74 20 64 65 tion is first de
dfe0: 74 65 63 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 tected..*/.int s
dff0: 71 6c 69 74 65 33 43 6f 72 72 75 70 74 28 76 6f qlite3Corrupt(vo
e000: 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51 id){. return SQ
e010: 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 7d 0a LITE_CORRUPT;.}.
e020: 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
e030: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 SQLITE_OMIT_DEPR
e040: 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20 54 68 69 ECATED./*.** Thi
e050: 73 20 69 73 20 61 20 63 6f 6e 76 65 6e 69 65 6e s is a convenien
e060: 63 65 20 72 6f 75 74 69 6e 65 20 74 68 61 74 20 ce routine that
e070: 6d 61 6b 65 73 20 73 75 72 65 20 74 68 61 74 20 makes sure that
e080: 61 6c 6c 20 74 68 72 65 61 64 2d 73 70 65 63 69 all thread-speci
e090: 66 69 63 0a 2a 2a 20 64 61 74 61 20 66 6f 72 20 fic.** data for
e0a0: 74 68 69 73 20 74 68 72 65 61 64 20 68 61 73 20 this thread has
e0b0: 62 65 65 6e 20 64 65 61 6c 6c 6f 63 61 74 65 64 been deallocated
e0c0: 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 6e ..**.** SQLite n
e0d0: 6f 20 6c 6f 6e 67 65 72 20 75 73 65 73 20 74 68 o longer uses th
e0e0: 72 65 61 64 2d 73 70 65 63 69 66 69 63 20 64 61 read-specific da
e0f0: 74 61 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 ta so this routi
e100: 6e 65 20 69 73 20 6e 6f 77 20 61 0a 2a 2a 20 6e ne is now a.** n
e110: 6f 2d 6f 70 2e 20 20 49 74 20 69 73 20 72 65 74 o-op. It is ret
e120: 61 69 6e 65 64 20 66 6f 72 20 68 69 73 74 6f 72 ained for histor
e130: 69 63 61 6c 20 63 6f 6d 70 61 74 69 62 69 6c 69 ical compatibili
e140: 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ty..*/.void sqli
e150: 74 65 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e te3_thread_clean
e160: 75 70 28 76 6f 69 64 29 7b 0a 7d 0a 23 65 6e 64 up(void){.}.#end
e170: 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e if../*.** Return
e180: 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f meta informatio
e190: 6e 20 61 62 6f 75 74 20 61 20 73 70 65 63 69 66 n about a specif
e1a0: 69 63 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 20 64 ic column of a d
e1b0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a atabase table..*
e1c0: 2a 20 53 65 65 20 63 6f 6d 6d 65 6e 74 20 69 6e * See comment in
e1d0: 20 73 71 6c 69 74 65 33 2e 68 20 28 73 71 6c 69 sqlite3.h (sqli
e1e0: 74 65 2e 68 2e 69 6e 29 20 66 6f 72 20 64 65 74 te.h.in) for det
e1f0: 61 69 6c 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 ails..*/.#ifdef
e200: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f SQLITE_ENABLE_CO
e210: 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 0a 69 6e LUMN_METADATA.in
e220: 74 20 73 71 6c 69 74 65 33 5f 74 61 62 6c 65 5f t sqlite3_table_
e230: 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61 28 column_metadata(
e240: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
e250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
e260: 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e * Connection han
e270: 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 dle */. const c
e280: 68 61 72 20 2a 7a 44 62 4e 61 6d 65 2c 20 20 20 har *zDbName,
e290: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 /* Database
e2a0: 20 6e 61 6d 65 20 6f 72 20 4e 55 4c 4c 20 2a 2f name or NULL */
e2b0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
e2c0: 54 61 62 6c 65 4e 61 6d 65 2c 20 20 20 20 20 2f TableName, /
e2d0: 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a * Table name */.
e2e0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 const char *zC
e2f0: 6f 6c 75 6d 6e 4e 61 6d 65 2c 20 20 20 20 2f 2a olumnName, /*
e300: 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a Column name */.
e310: 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 char const **p
e320: 7a 44 61 74 61 54 79 70 65 2c 20 20 20 20 2f 2a zDataType, /*
e330: 20 4f 55 54 50 55 54 3a 20 44 65 63 6c 61 72 65 OUTPUT: Declare
e340: 64 20 64 61 74 61 20 74 79 70 65 20 2a 2f 0a 20 d data type */.
e350: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 2a 70 7a char const **pz
e360: 43 6f 6c 6c 53 65 71 2c 20 20 20 20 20 2f 2a 20 CollSeq, /*
e370: 4f 55 54 50 55 54 3a 20 43 6f 6c 6c 61 74 69 6f OUTPUT: Collatio
e380: 6e 20 73 65 71 75 65 6e 63 65 20 6e 61 6d 65 20 n sequence name
e390: 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e 6f 74 4e 75 */. int *pNotNu
e3a0: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
e3b0: 20 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 /* OUTPUT: True
e3c0: 20 69 66 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e if NOT NULL con
e3d0: 73 74 72 61 69 6e 74 20 65 78 69 73 74 73 20 2a straint exists *
e3e0: 2f 0a 20 20 69 6e 74 20 2a 70 50 72 69 6d 61 72 /. int *pPrimar
e3f0: 79 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 yKey,
e400: 2f 2a 20 4f 55 54 50 55 54 3a 20 54 72 75 65 20 /* OUTPUT: True
e410: 69 66 20 63 6f 6c 75 6d 6e 20 70 61 72 74 20 6f if column part o
e420: 66 20 50 4b 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 f PK */. int *p
e430: 41 75 74 6f 69 6e 63 20 20 20 20 20 20 20 20 20 Autoinc
e440: 20 20 20 20 20 20 2f 2a 20 4f 55 54 50 55 54 3a /* OUTPUT:
e450: 20 54 72 75 65 20 69 66 20 63 6f 6c 75 6d 6e 20 True if column
e460: 69 73 20 61 75 74 6f 2d 69 6e 63 72 65 6d 65 6e is auto-incremen
e470: 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 t */.){. int rc
e480: 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 ;. char *zErrMs
e490: 67 20 3d 20 30 3b 0a 20 20 54 61 62 6c 65 20 2a g = 0;. Table *
e4a0: 70 54 61 62 20 3d 20 30 3b 0a 20 20 43 6f 6c 75 pTab = 0;. Colu
e4b0: 6d 6e 20 2a 70 43 6f 6c 20 3d 20 30 3b 0a 20 20 mn *pCol = 0;.
e4c0: 69 6e 74 20 69 43 6f 6c 3b 0a 0a 20 20 63 68 61 int iCol;.. cha
e4d0: 72 20 63 6f 6e 73 74 20 2a 7a 44 61 74 61 54 79 r const *zDataTy
e4e0: 70 65 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 63 pe = 0;. char c
e4f0: 6f 6e 73 74 20 2a 7a 43 6f 6c 6c 53 65 71 20 3d onst *zCollSeq =
e500: 20 30 3b 0a 20 20 69 6e 74 20 6e 6f 74 6e 75 6c 0;. int notnul
e510: 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 70 72 69 l = 0;. int pri
e520: 6d 61 72 79 6b 65 79 20 3d 20 30 3b 0a 20 20 69 marykey = 0;. i
e530: 6e 74 20 61 75 74 6f 69 6e 63 20 3d 20 30 3b 0a nt autoinc = 0;.
e540: 0a 20 20 2f 2a 20 45 6e 73 75 72 65 20 74 68 65 . /* Ensure the
e550: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
e560: 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 64 has been loaded
e570: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 */. sqlite3_mu
e580: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
e590: 74 65 78 29 3b 0a 20 20 28 76 6f 69 64 29 73 71 tex);. (void)sq
e5a0: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 lite3SafetyOn(db
e5b0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
e5c0: 65 45 6e 74 65 72 41 6c 6c 28 64 62 29 3b 0a 20 eEnterAll(db);.
e5d0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 rc = sqlite3Ini
e5e0: 74 28 64 62 2c 20 26 7a 45 72 72 4d 73 67 29 3b t(db, &zErrMsg);
e5f0: 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
e600: 21 3d 72 63 20 29 7b 0a 20 20 20 20 67 6f 74 6f !=rc ){. goto
e610: 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a error_out;. }.
e620: 0a 20 20 2f 2a 20 4c 6f 63 61 74 65 20 74 68 65 . /* Locate the
e630: 20 74 61 62 6c 65 20 69 6e 20 71 75 65 73 74 69 table in questi
e640: 6f 6e 20 2a 2f 0a 20 20 70 54 61 62 20 3d 20 73 on */. pTab = s
e650: 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 qlite3FindTable(
e660: 64 62 2c 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 20 db, zTableName,
e670: 7a 44 62 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 zDbName);. if(
e680: 21 70 54 61 62 20 7c 7c 20 70 54 61 62 2d 3e 70 !pTab || pTab->p
e690: 53 65 6c 65 63 74 20 29 7b 0a 20 20 20 20 70 54 Select ){. pT
e6a0: 61 62 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 6f ab = 0;. goto
e6b0: 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a error_out;. }.
e6c0: 0a 20 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 63 . /* Find the c
e6d0: 6f 6c 75 6d 6e 20 66 6f 72 20 77 68 69 63 68 20 olumn for which
e6e0: 69 6e 66 6f 20 69 73 20 72 65 71 75 65 73 74 65 info is requeste
e6f0: 64 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 d */. if( sqlit
e700: 65 33 49 73 52 6f 77 69 64 28 7a 43 6f 6c 75 6d e3IsRowid(zColum
e710: 6e 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 69 43 nName) ){. iC
e720: 6f 6c 20 3d 20 70 54 61 62 2d 3e 69 50 4b 65 79 ol = pTab->iPKey
e730: 3b 0a 20 20 20 20 69 66 28 20 69 43 6f 6c 3e 3d ;. if( iCol>=
e740: 30 20 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 0 ){. pCol
e750: 3d 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 = &pTab->aCol[iC
e760: 6f 6c 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c ol];. }. }el
e770: 73 65 7b 0a 20 20 20 20 66 6f 72 28 69 43 6f 6c se{. for(iCol
e780: 3d 30 3b 20 69 43 6f 6c 3c 70 54 61 62 2d 3e 6e =0; iCol<pTab->n
e790: 43 6f 6c 3b 20 69 43 6f 6c 2b 2b 29 7b 0a 20 20 Col; iCol++){.
e7a0: 20 20 20 20 70 43 6f 6c 20 3d 20 26 70 54 61 62 pCol = &pTab
e7b0: 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 3b 0a 20 20 ->aCol[iCol];.
e7c0: 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c 69 74 if( 0==sqlit
e7d0: 65 33 53 74 72 49 43 6d 70 28 70 43 6f 6c 2d 3e e3StrICmp(pCol->
e7e0: 7a 4e 61 6d 65 2c 20 7a 43 6f 6c 75 6d 6e 4e 61 zName, zColumnNa
e7f0: 6d 65 29 20 29 7b 0a 20 20 20 20 20 20 20 20 62 me) ){. b
e800: 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
e810: 20 20 7d 0a 20 20 20 20 69 66 28 20 69 43 6f 6c }. if( iCol
e820: 3d 3d 70 54 61 62 2d 3e 6e 43 6f 6c 20 29 7b 0a ==pTab->nCol ){.
e830: 20 20 20 20 20 20 70 54 61 62 20 3d 20 30 3b 0a pTab = 0;.
e840: 20 20 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 goto error
e850: 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a _out;. }. }.
e860: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
e870: 69 6e 67 20 62 6c 6f 63 6b 20 73 74 6f 72 65 73 ing block stores
e880: 20 74 68 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d the meta inform
e890: 61 74 69 6f 6e 20 74 68 61 74 20 77 69 6c 6c 20 ation that will
e8a0: 62 65 20 72 65 74 75 72 6e 65 64 0a 20 20 2a 2a be returned. **
e8b0: 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 69 to the caller i
e8c0: 6e 20 6c 6f 63 61 6c 20 76 61 72 69 61 62 6c 65 n local variable
e8d0: 73 20 7a 44 61 74 61 54 79 70 65 2c 20 7a 43 6f s zDataType, zCo
e8e0: 6c 6c 53 65 71 2c 20 6e 6f 74 6e 75 6c 6c 2c 20 llSeq, notnull,
e8f0: 70 72 69 6d 61 72 79 6b 65 79 0a 20 20 2a 2a 20 primarykey. **
e900: 61 6e 64 20 61 75 74 6f 69 6e 63 2e 20 41 74 20 and autoinc. At
e910: 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 72 65 this point there
e920: 20 61 72 65 20 74 77 6f 20 70 6f 73 73 69 62 69 are two possibi
e930: 6c 69 74 69 65 73 3a 0a 20 20 2a 2a 20 0a 20 20 lities:. ** .
e940: 2a 2a 20 20 20 20 20 31 2e 20 54 68 65 20 73 70 ** 1. The sp
e950: 65 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 20 6e ecified column n
e960: 61 6d 65 20 77 61 73 20 72 6f 77 69 64 22 2c 20 ame was rowid",
e970: 22 6f 69 64 22 20 6f 72 20 22 5f 72 6f 77 69 64 "oid" or "_rowid
e980: 5f 22 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 _" . **
e990: 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 and there is no
e9a0: 65 78 70 6c 69 63 69 74 6c 79 20 64 65 63 6c 61 explicitly decla
e9b0: 72 65 64 20 49 50 4b 20 63 6f 6c 75 6d 6e 2e 20 red IPK column.
e9c0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 32 . **. ** 2
e9d0: 2e 20 54 68 65 20 74 61 62 6c 65 20 69 73 20 6e . The table is n
e9e0: 6f 74 20 61 20 76 69 65 77 20 61 6e 64 20 74 68 ot a view and th
e9f0: 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 69 64 e column name id
ea00: 65 6e 74 69 66 69 65 64 20 61 6e 20 0a 20 20 2a entified an . *
ea10: 2a 20 20 20 20 20 20 20 20 65 78 70 6c 69 63 69 * explici
ea20: 74 6c 79 20 64 65 63 6c 61 72 65 64 20 63 6f 6c tly declared col
ea30: 75 6d 6e 2e 20 43 6f 70 79 20 6d 65 74 61 20 69 umn. Copy meta i
ea40: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 nformation from
ea50: 2a 70 43 6f 6c 2e 0a 20 20 2a 2f 20 0a 20 20 69 *pCol.. */ . i
ea60: 66 28 20 70 43 6f 6c 20 29 7b 0a 20 20 20 20 7a f( pCol ){. z
ea70: 44 61 74 61 54 79 70 65 20 3d 20 70 43 6f 6c 2d DataType = pCol-
ea80: 3e 7a 54 79 70 65 3b 0a 20 20 20 20 7a 43 6f 6c >zType;. zCol
ea90: 6c 53 65 71 20 3d 20 70 43 6f 6c 2d 3e 7a 43 6f lSeq = pCol->zCo
eaa0: 6c 6c 3b 0a 20 20 20 20 6e 6f 74 6e 75 6c 6c 20 ll;. notnull
eab0: 3d 20 70 43 6f 6c 2d 3e 6e 6f 74 4e 75 6c 6c 21 = pCol->notNull!
eac0: 3d 30 3b 0a 20 20 20 20 70 72 69 6d 61 72 79 6b =0;. primaryk
ead0: 65 79 20 20 3d 20 70 43 6f 6c 2d 3e 69 73 50 72 ey = pCol->isPr
eae0: 69 6d 4b 65 79 21 3d 30 3b 0a 20 20 20 20 61 75 imKey!=0;. au
eaf0: 74 6f 69 6e 63 20 3d 20 70 54 61 62 2d 3e 69 50 toinc = pTab->iP
eb00: 4b 65 79 3d 3d 69 43 6f 6c 20 26 26 20 28 70 54 Key==iCol && (pT
eb10: 61 62 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 ab->tabFlags & T
eb20: 46 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 29 F_Autoincrement)
eb30: 21 3d 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 !=0;. }else{.
eb40: 20 20 7a 44 61 74 61 54 79 70 65 20 3d 20 22 49 zDataType = "I
eb50: 4e 54 45 47 45 52 22 3b 0a 20 20 20 20 70 72 69 NTEGER";. pri
eb60: 6d 61 72 79 6b 65 79 20 3d 20 31 3b 0a 20 20 7d marykey = 1;. }
eb70: 0a 20 20 69 66 28 20 21 7a 43 6f 6c 6c 53 65 71 . if( !zCollSeq
eb80: 20 29 7b 0a 20 20 20 20 7a 43 6f 6c 6c 53 65 71 ){. zCollSeq
eb90: 20 3d 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 7d = "BINARY";. }
eba0: 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 73 ..error_out:. s
ebb0: 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
ebc0: 41 6c 6c 28 64 62 29 3b 0a 20 20 28 76 6f 69 64 All(db);. (void
ebd0: 29 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 )sqlite3SafetyOf
ebe0: 66 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 57 68 65 f(db);.. /* Whe
ebf0: 74 68 65 72 20 74 68 65 20 66 75 6e 63 74 69 6f ther the functio
ec00: 6e 20 63 61 6c 6c 20 73 75 63 63 65 65 64 65 64 n call succeeded
ec10: 20 6f 72 20 66 61 69 6c 65 64 2c 20 73 65 74 20 or failed, set
ec20: 74 68 65 20 6f 75 74 70 75 74 20 70 61 72 61 6d the output param
ec30: 65 74 65 72 73 0a 20 20 2a 2a 20 74 6f 20 77 68 eters. ** to wh
ec40: 61 74 65 76 65 72 20 74 68 65 69 72 20 6c 6f 63 atever their loc
ec50: 61 6c 20 63 6f 75 6e 74 65 72 70 61 72 74 73 20 al counterparts
ec60: 63 6f 6e 74 61 69 6e 2e 20 49 66 20 61 6e 20 65 contain. If an e
ec70: 72 72 6f 72 20 64 69 64 20 6f 63 63 75 72 2c 0a rror did occur,.
ec80: 20 20 2a 2a 20 74 68 69 73 20 68 61 73 20 74 68 ** this has th
ec90: 65 20 65 66 66 65 63 74 20 6f 66 20 7a 65 72 6f e effect of zero
eca0: 69 6e 67 20 61 6c 6c 20 6f 75 74 70 75 74 20 70 ing all output p
ecb0: 61 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f 0a arameters.. */.
ecc0: 20 20 69 66 28 20 70 7a 44 61 74 61 54 79 70 65 if( pzDataType
ecd0: 20 29 20 2a 70 7a 44 61 74 61 54 79 70 65 20 3d ) *pzDataType =
ece0: 20 7a 44 61 74 61 54 79 70 65 3b 0a 20 20 69 66 zDataType;. if
ecf0: 28 20 70 7a 43 6f 6c 6c 53 65 71 20 29 20 2a 70 ( pzCollSeq ) *p
ed00: 7a 43 6f 6c 6c 53 65 71 20 3d 20 7a 43 6f 6c 6c zCollSeq = zColl
ed10: 53 65 71 3b 0a 20 20 69 66 28 20 70 4e 6f 74 4e Seq;. if( pNotN
ed20: 75 6c 6c 20 29 20 2a 70 4e 6f 74 4e 75 6c 6c 20 ull ) *pNotNull
ed30: 3d 20 6e 6f 74 6e 75 6c 6c 3b 0a 20 20 69 66 28 = notnull;. if(
ed40: 20 70 50 72 69 6d 61 72 79 4b 65 79 20 29 20 2a pPrimaryKey ) *
ed50: 70 50 72 69 6d 61 72 79 4b 65 79 20 3d 20 70 72 pPrimaryKey = pr
ed60: 69 6d 61 72 79 6b 65 79 3b 0a 20 20 69 66 28 20 imarykey;. if(
ed70: 70 41 75 74 6f 69 6e 63 20 29 20 2a 70 41 75 74 pAutoinc ) *pAut
ed80: 6f 69 6e 63 20 3d 20 61 75 74 6f 69 6e 63 3b 0a oinc = autoinc;.
ed90: 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
eda0: 3d 3d 72 63 20 26 26 20 21 70 54 61 62 20 29 7b ==rc && !pTab ){
edb0: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
edc0: 65 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b ee(db, zErrMsg);
edd0: 0a 20 20 20 20 7a 45 72 72 4d 73 67 20 3d 20 73 . zErrMsg = s
ede0: 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 qlite3MPrintf(db
edf0: 2c 20 22 6e 6f 20 73 75 63 68 20 74 61 62 6c 65 , "no such table
ee00: 20 63 6f 6c 75 6d 6e 3a 20 25 73 2e 25 73 22 2c column: %s.%s",
ee10: 20 7a 54 61 62 6c 65 4e 61 6d 65 2c 0a 20 20 20 zTableName,.
ee20: 20 20 20 20 20 7a 43 6f 6c 75 6d 6e 4e 61 6d 65 zColumnName
ee30: 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 );. rc = SQLI
ee40: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 TE_ERROR;. }.
ee50: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
ee60: 20 72 63 2c 20 28 7a 45 72 72 4d 73 67 3f 22 25 rc, (zErrMsg?"%
ee70: 73 22 3a 30 29 2c 20 7a 45 72 72 4d 73 67 29 3b s":0), zErrMsg);
ee80: 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 . sqlite3DbFree
ee90: 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 (db, zErrMsg);.
eea0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 rc = sqlite3Api
eeb0: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 Exit(db, rc);.
eec0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
eed0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a ave(db->mutex);.
eee0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 return rc;.}.#
eef0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 endif../*.** Sle
ef00: 65 70 20 66 6f 72 20 61 20 6c 69 74 74 6c 65 20 ep for a little
ef10: 77 68 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 74 while. Return t
ef20: 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d he amount of tim
ef30: 65 20 73 6c 65 70 74 2e 0a 2a 2f 0a 69 6e 74 20 e slept..*/.int
ef40: 73 71 6c 69 74 65 33 5f 73 6c 65 65 70 28 69 6e sqlite3_sleep(in
ef50: 74 20 6d 73 29 7b 0a 20 20 73 71 6c 69 74 65 33 t ms){. sqlite3
ef60: 5f 76 66 73 20 2a 70 56 66 73 3b 0a 20 20 69 6e _vfs *pVfs;. in
ef70: 74 20 72 63 3b 0a 20 20 70 56 66 73 20 3d 20 73 t rc;. pVfs = s
ef80: 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 28 qlite3_vfs_find(
ef90: 30 29 3b 0a 20 20 69 66 28 20 70 56 66 73 3d 3d 0);. if( pVfs==
efa0: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 0a 20 0 ) return 0;..
efb0: 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f /* This functio
efc0: 6e 20 77 6f 72 6b 73 20 69 6e 20 6d 69 6c 6c 69 n works in milli
efd0: 73 65 63 6f 6e 64 73 2c 20 62 75 74 20 74 68 65 seconds, but the
efe0: 20 75 6e 64 65 72 6c 79 69 6e 67 20 4f 73 53 6c underlying OsSl
eff0: 65 65 70 28 29 20 0a 20 20 2a 2a 20 41 50 49 20 eep() . ** API
f000: 75 73 65 73 20 6d 69 63 72 6f 73 65 63 6f 6e 64 uses microsecond
f010: 73 2e 20 48 65 6e 63 65 20 74 68 65 20 31 30 30 s. Hence the 100
f020: 30 27 73 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 0's.. */. rc =
f030: 20 28 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 (sqlite3OsSleep
f040: 28 70 56 66 73 2c 20 31 30 30 30 2a 6d 73 29 2f (pVfs, 1000*ms)/
f050: 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 1000);. return
f060: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 rc;.}../*.** Ena
f070: 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 ble or disable t
f080: 68 65 20 65 78 74 65 6e 64 65 64 20 72 65 73 75 he extended resu
f090: 6c 74 20 63 6f 64 65 73 2e 0a 2a 2f 0a 69 6e 74 lt codes..*/.int
f0a0: 20 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 64 65 sqlite3_extende
f0b0: 64 5f 72 65 73 75 6c 74 5f 63 6f 64 65 73 28 73 d_result_codes(s
f0c0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
f0d0: 6f 6e 6f 66 66 29 7b 0a 20 20 73 71 6c 69 74 65 onoff){. sqlite
f0e0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
f0f0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 64 62 2d 3e ->mutex);. db->
f100: 65 72 72 4d 61 73 6b 20 3d 20 6f 6e 6f 66 66 20 errMask = onoff
f110: 3f 20 30 78 66 66 66 66 66 66 66 66 20 3a 20 30 ? 0xffffffff : 0
f120: 78 66 66 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d xff;. sqlite3_m
f130: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
f140: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
f150: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
f160: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 78 .** Invoke the x
f170: 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 6d 65 74 68 FileControl meth
f180: 6f 64 20 6f 6e 20 61 20 70 61 72 74 69 63 75 6c od on a particul
f190: 61 72 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a ar database..*/.
f1a0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 int sqlite3_file
f1b0: 5f 63 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 _control(sqlite3
f1c0: 20 2a 64 62 2c 20 63 6f 6e 73 74 20 63 68 61 72 *db, const char
f1d0: 20 2a 7a 44 62 4e 61 6d 65 2c 20 69 6e 74 20 6f *zDbName, int o
f1e0: 70 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a p, void *pArg){.
f1f0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
f200: 45 5f 45 52 52 4f 52 3b 0a 20 20 69 6e 74 20 69 E_ERROR;. int i
f210: 44 62 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 Db;. sqlite3_mu
f220: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 tex_enter(db->mu
f230: 74 65 78 29 3b 0a 20 20 69 66 28 20 7a 44 62 4e tex);. if( zDbN
f240: 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 44 ame==0 ){. iD
f250: 62 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a b = 0;. }else{.
f260: 20 20 20 20 66 6f 72 28 69 44 62 3d 30 3b 20 69 for(iDb=0; i
f270: 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b Db<db->nDb; iDb+
f280: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74 +){. if( st
f290: 72 63 6d 70 28 64 62 2d 3e 61 44 62 5b 69 44 62 rcmp(db->aDb[iDb
f2a0: 5d 2e 7a 4e 61 6d 65 2c 20 7a 44 62 4e 61 6d 65 ].zName, zDbName
f2b0: 29 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 )==0 ) break;.
f2c0: 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 69 44 }. }. if( iD
f2d0: 62 3c 64 62 2d 3e 6e 44 62 20 29 7b 0a 20 20 20 b<db->nDb ){.
f2e0: 20 42 74 72 65 65 20 2a 70 42 74 72 65 65 20 3d Btree *pBtree =
f2f0: 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 db->aDb[iDb].pB
f300: 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 72 65 t;. if( pBtre
f310: 65 20 29 7b 0a 20 20 20 20 20 20 50 61 67 65 72 e ){. Pager
f320: 20 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 20 20 *pPager;.
f330: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
f340: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ;. sqlite3B
f350: 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 65 treeEnter(pBtree
f360: 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 20 );. pPager
f370: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 = sqlite3BtreePa
f380: 67 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 ger(pBtree);.
f390: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
f3a0: 72 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 66 64 r!=0 );. fd
f3b0: 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 = sqlite3PagerF
f3c0: 69 6c 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 ile(pPager);.
f3d0: 20 20 20 61 73 73 65 72 74 28 20 66 64 21 3d 30 assert( fd!=0
f3e0: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 66 64 );. if( fd
f3f0: 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 ->pMethods ){.
f400: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
f410: 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 e3OsFileControl(
f420: 66 64 2c 20 6f 70 2c 20 70 41 72 67 29 3b 0a 20 fd, op, pArg);.
f430: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
f440: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
f450: 42 74 72 65 65 29 3b 0a 20 20 20 20 7d 0a 20 20 Btree);. }.
f460: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
f470: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 x_leave(db->mute
f480: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b x);. return rc;
f490: 20 20 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 .}../*.** Int
f4a0: 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 74 65 erface to the te
f4b0: 73 74 69 6e 67 20 6c 6f 67 69 63 2e 0a 2a 2f 0a sting logic..*/.
f4c0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 74 65 73 74 int sqlite3_test
f4d0: 5f 63 6f 6e 74 72 6f 6c 28 69 6e 74 20 6f 70 2c _control(int op,
f4e0: 20 2e 2e 2e 29 7b 0a 20 20 69 6e 74 20 72 63 20 ...){. int rc
f4f0: 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c = 0;.#ifndef SQL
f500: 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e ITE_OMIT_BUILTIN
f510: 5f 54 45 53 54 0a 20 20 76 61 5f 6c 69 73 74 20 _TEST. va_list
f520: 61 70 3b 0a 20 20 76 61 5f 73 74 61 72 74 28 61 ap;. va_start(a
f530: 70 2c 20 6f 70 29 3b 0a 20 20 73 77 69 74 63 68 p, op);. switch
f540: 28 20 6f 70 20 29 7b 0a 0a 20 20 20 20 2f 2a 0a ( op ){.. /*.
f550: 20 20 20 20 2a 2a 20 53 61 76 65 20 74 68 65 20 ** Save the
f560: 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 current state of
f570: 20 74 68 65 20 50 52 4e 47 2e 0a 20 20 20 20 2a the PRNG.. *
f580: 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 /. case SQLIT
f590: 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e 47 5f E_TESTCTRL_PRNG_
f5a0: 53 41 56 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 SAVE: {. sq
f5b0: 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 61 lite3PrngSaveSta
f5c0: 74 65 28 29 3b 0a 20 20 20 20 20 20 62 72 65 61 te();. brea
f5d0: 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
f5e0: 0a 20 20 20 20 2a 2a 20 52 65 73 74 6f 72 65 20 . ** Restore
f5f0: 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 the state of the
f600: 20 50 52 4e 47 20 74 6f 20 74 68 65 20 6c 61 73 PRNG to the las
f610: 74 20 73 74 61 74 65 20 73 61 76 65 64 20 75 73 t state saved us
f620: 69 6e 67 0a 20 20 20 20 2a 2a 20 50 52 4e 47 5f ing. ** PRNG_
f630: 53 41 56 45 2e 20 20 49 66 20 50 52 4e 47 5f 53 SAVE. If PRNG_S
f640: 41 56 45 20 68 61 73 20 6e 65 76 65 72 20 62 65 AVE has never be
f650: 66 6f 72 65 20 62 65 65 6e 20 63 61 6c 6c 65 64 fore been called
f660: 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68 , then. ** th
f670: 69 73 20 76 65 72 62 20 61 63 74 73 20 6c 69 6b is verb acts lik
f680: 65 20 50 52 4e 47 5f 52 45 53 45 54 2e 0a 20 20 e PRNG_RESET..
f690: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
f6a0: 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 LITE_TESTCTRL_PR
f6b0: 4e 47 5f 52 45 53 54 4f 52 45 3a 20 7b 0a 20 20 NG_RESTORE: {.
f6c0: 20 20 20 20 73 71 6c 69 74 65 33 50 72 6e 67 52 sqlite3PrngR
f6d0: 65 73 74 6f 72 65 53 74 61 74 65 28 29 3b 0a 20 estoreState();.
f6e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
f6f0: 7d 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a }.. /*. **
f700: 20 52 65 73 65 74 20 74 68 65 20 50 52 4e 47 20 Reset the PRNG
f710: 62 61 63 6b 20 74 6f 20 69 74 73 20 75 6e 69 6e back to its unin
f720: 69 74 69 61 6c 69 7a 65 64 20 73 74 61 74 65 2e itialized state.
f730: 20 20 54 68 65 20 6e 65 78 74 20 63 61 6c 6c 0a The next call.
f740: 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 ** to sqlite
f750: 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 29 20 77 3_randomness() w
f760: 69 6c 6c 20 72 65 73 65 65 64 20 74 68 65 20 50 ill reseed the P
f770: 52 4e 47 20 75 73 69 6e 67 20 61 20 73 69 6e 67 RNG using a sing
f780: 6c 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 le call. ** t
f790: 6f 20 74 68 65 20 78 52 61 6e 64 6f 6d 6e 65 73 o the xRandomnes
f7a0: 73 20 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 s method of the
f7b0: 64 65 66 61 75 6c 74 20 56 46 53 2e 0a 20 20 20 default VFS..
f7c0: 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c */. case SQL
f7d0: 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 52 4e ITE_TESTCTRL_PRN
f7e0: 47 5f 52 45 53 45 54 3a 20 7b 0a 20 20 20 20 20 G_RESET: {.
f7f0: 20 73 71 6c 69 74 65 33 50 72 6e 67 52 65 73 65 sqlite3PrngRese
f800: 74 53 74 61 74 65 28 29 3b 0a 20 20 20 20 20 20 tState();.
f810: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
f820: 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c /*. ** sql
f830: 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
f840: 6c 28 42 49 54 56 45 43 5f 54 45 53 54 2c 20 73 l(BITVEC_TEST, s
f850: 69 7a 65 2c 20 70 72 6f 67 72 61 6d 29 0a 20 20 ize, program).
f860: 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 75 6e 20 **. ** Run
f870: 61 20 74 65 73 74 20 61 67 61 69 6e 73 74 20 61 a test against a
f880: 20 42 69 74 76 65 63 20 6f 62 6a 65 63 74 20 6f Bitvec object o
f890: 66 20 73 69 7a 65 2e 20 20 54 68 65 20 70 72 6f f size. The pro
f8a0: 67 72 61 6d 20 61 72 67 75 6d 65 6e 74 0a 20 20 gram argument.
f8b0: 20 20 2a 2a 20 69 73 20 61 6e 20 61 72 72 61 79 ** is an array
f8c0: 20 6f 66 20 69 6e 74 65 67 65 72 73 20 74 68 61 of integers tha
f8d0: 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 74 65 t defines the te
f8e0: 73 74 2e 20 20 52 65 74 75 72 6e 20 2d 31 20 6f st. Return -1 o
f8f0: 6e 20 61 0a 20 20 20 20 2a 2a 20 6d 65 6d 6f 72 n a. ** memor
f900: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 65 72 72 y allocation err
f910: 6f 72 2c 20 30 20 6f 6e 20 73 75 63 63 65 73 73 or, 0 on success
f920: 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f 20 66 6f , or non-zero fo
f930: 72 20 61 6e 20 65 72 72 6f 72 2e 0a 20 20 20 20 r an error..
f940: 2a 2a 20 53 65 65 20 74 68 65 20 73 71 6c 69 74 ** See the sqlit
f950: 65 33 42 69 74 76 65 63 42 75 69 6c 74 69 6e 54 e3BitvecBuiltinT
f960: 65 73 74 28 29 20 66 6f 72 20 61 64 64 69 74 69 est() for additi
f970: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
f980: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
f990: 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
f9a0: 4c 5f 42 49 54 56 45 43 5f 54 45 53 54 3a 20 7b L_BITVEC_TEST: {
f9b0: 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 20 3d 20 . int sz =
f9c0: 76 61 5f 61 72 67 28 61 70 2c 20 69 6e 74 29 3b va_arg(ap, int);
f9d0: 0a 20 20 20 20 20 20 69 6e 74 20 2a 61 50 72 6f . int *aPro
f9e0: 67 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 69 g = va_arg(ap, i
f9f0: 6e 74 2a 29 3b 0a 20 20 20 20 20 20 72 63 20 3d nt*);. rc =
fa00: 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 sqlite3BitvecBu
fa10: 69 6c 74 69 6e 54 65 73 74 28 73 7a 2c 20 61 50 iltinTest(sz, aP
fa20: 72 6f 67 29 3b 0a 20 20 20 20 20 20 62 72 65 61 rog);. brea
fa30: 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
fa40: 0a 20 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 . ** sqlite3
fa50: 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 42 45 _test_control(BE
fa60: 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b NIGN_MALLOC_HOOK
fa70: 53 2c 20 78 42 65 67 69 6e 2c 20 78 45 6e 64 29 S, xBegin, xEnd)
fa80: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 52 . **. ** R
fa90: 65 67 69 73 74 65 72 20 68 6f 6f 6b 73 20 74 6f egister hooks to
faa0: 20 63 61 6c 6c 20 74 6f 20 69 6e 64 69 63 61 74 call to indicat
fab0: 65 20 77 68 69 63 68 20 6d 61 6c 6c 6f 63 28 29 e which malloc()
fac0: 20 66 61 69 6c 75 72 65 73 20 0a 20 20 20 20 2a failures . *
fad0: 2a 20 61 72 65 20 62 65 6e 69 67 6e 2e 0a 20 20 * are benign..
fae0: 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 */. case SQ
faf0: 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 42 45 LITE_TESTCTRL_BE
fb00: 4e 49 47 4e 5f 4d 41 4c 4c 4f 43 5f 48 4f 4f 4b NIGN_MALLOC_HOOK
fb10: 53 3a 20 7b 0a 20 20 20 20 20 20 74 79 70 65 64 S: {. typed
fb20: 65 66 20 76 6f 69 64 20 28 2a 76 6f 69 64 5f 66 ef void (*void_f
fb30: 75 6e 63 74 69 6f 6e 29 28 76 6f 69 64 29 3b 0a unction)(void);.
fb40: 20 20 20 20 20 20 76 6f 69 64 5f 66 75 6e 63 74 void_funct
fb50: 69 6f 6e 20 78 42 65 6e 69 67 6e 42 65 67 69 6e ion xBenignBegin
fb60: 3b 0a 20 20 20 20 20 20 76 6f 69 64 5f 66 75 6e ;. void_fun
fb70: 63 74 69 6f 6e 20 78 42 65 6e 69 67 6e 45 6e 64 ction xBenignEnd
fb80: 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e 42 ;. xBenignB
fb90: 65 67 69 6e 20 3d 20 76 61 5f 61 72 67 28 61 70 egin = va_arg(ap
fba0: 2c 20 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 , void_function)
fbb0: 3b 0a 20 20 20 20 20 20 78 42 65 6e 69 67 6e 45 ;. xBenignE
fbc0: 6e 64 20 3d 20 76 61 5f 61 72 67 28 61 70 2c 20 nd = va_arg(ap,
fbd0: 76 6f 69 64 5f 66 75 6e 63 74 69 6f 6e 29 3b 0a void_function);.
fbe0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 6e sqlite3Ben
fbf0: 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 78 ignMallocHooks(x
fc00: 42 65 6e 69 67 6e 42 65 67 69 6e 2c 20 78 42 65 BenignBegin, xBe
fc10: 6e 69 67 6e 45 6e 64 29 3b 0a 20 20 20 20 20 20 nignEnd);.
fc20: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 break;. }..
fc30: 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 20 73 71 6c /*. ** sql
fc40: 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
fc50: 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
fc60: 4c 5f 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 L_PENDING_BYTE,
fc70: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 58 29 0a unsigned int X).
fc80: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 53 65 **. ** Se
fc90: 74 20 74 68 65 20 50 45 4e 44 49 4e 47 20 62 79 t the PENDING by
fca0: 74 65 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 te to the value
fcb0: 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2c in the argument,
fcc0: 20 69 66 20 58 3e 30 2e 0a 20 20 20 20 2a 2a 20 if X>0.. **
fcd0: 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 Make no changes
fce0: 69 66 20 58 3d 3d 30 2e 20 20 52 65 74 75 72 6e if X==0. Return
fcf0: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 the value of th
fd00: 65 20 70 65 6e 64 69 6e 67 20 62 79 74 65 0a 20 e pending byte.
fd10: 20 20 20 2a 2a 20 61 73 20 69 74 20 65 78 69 73 ** as it exis
fd20: 74 69 6e 67 20 62 65 66 6f 72 65 20 74 68 69 73 ting before this
fd30: 20 72 6f 75 74 69 6e 65 20 77 61 73 20 63 61 6c routine was cal
fd40: 6c 65 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 led.. **.
fd50: 2a 2a 20 49 4d 50 4f 52 54 41 4e 54 3a 20 20 43 ** IMPORTANT: C
fd60: 68 61 6e 67 69 6e 67 20 74 68 65 20 50 45 4e 44 hanging the PEND
fd70: 49 4e 47 20 62 79 74 65 20 66 72 6f 6d 20 30 78 ING byte from 0x
fd80: 34 30 30 30 30 30 30 30 20 72 65 73 75 6c 74 73 40000000 results
fd90: 20 69 6e 0a 20 20 20 20 2a 2a 20 61 6e 20 69 6e in. ** an in
fda0: 63 6f 6d 70 61 74 69 62 6c 65 20 64 61 74 61 62 compatible datab
fdb0: 61 73 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e ase file format.
fdc0: 20 20 43 68 61 6e 67 69 6e 67 20 74 68 65 20 50 Changing the P
fdd0: 45 4e 44 49 4e 47 20 62 79 74 65 0a 20 20 20 20 ENDING byte.
fde0: 2a 2a 20 77 68 69 6c 65 20 61 6e 79 20 64 61 74 ** while any dat
fdf0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
fe00: 20 69 73 20 6f 70 65 6e 20 72 65 73 75 6c 74 73 is open results
fe10: 20 69 6e 20 75 6e 64 65 66 69 6e 65 64 20 61 6e in undefined an
fe20: 64 0a 20 20 20 20 2a 2a 20 64 69 6c 65 74 65 72 d. ** dileter
fe30: 69 6f 75 73 20 62 65 68 61 76 69 6f 72 2e 0a 20 ious behavior..
fe40: 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
fe50: 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 50 QLITE_TESTCTRL_P
fe60: 45 4e 44 49 4e 47 5f 42 59 54 45 3a 20 7b 0a 20 ENDING_BYTE: {.
fe70: 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e unsigned in
fe80: 74 20 6e 65 77 56 61 6c 20 3d 20 76 61 5f 61 72 t newVal = va_ar
fe90: 67 28 61 70 2c 20 75 6e 73 69 67 6e 65 64 20 69 g(ap, unsigned i
fea0: 6e 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 nt);. rc =
feb0: 73 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 42 79 sqlite3PendingBy
fec0: 74 65 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 65 te;. if( ne
fed0: 77 56 61 6c 20 29 20 73 71 6c 69 74 65 33 50 65 wVal ) sqlite3Pe
fee0: 6e 64 69 6e 67 42 79 74 65 20 3d 20 6e 65 77 56 ndingByte = newV
fef0: 61 6c 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b al;. break;
ff00: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 0a 20 . }.. /*.
ff10: 20 20 20 2a 2a 20 20 73 71 6c 69 74 65 33 5f 74 ** sqlite3_t
ff20: 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
ff30: 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 TE_TESTCTRL_ASSE
ff40: 52 54 2c 20 69 6e 74 20 58 29 0a 20 20 20 20 2a RT, int X). *
ff50: 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 61 63 *. ** This ac
ff60: 74 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 61 20 tion provides a
ff70: 72 75 6e 2d 74 69 6d 65 20 74 65 73 74 20 74 6f run-time test to
ff80: 20 73 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 see whether or
ff90: 6e 6f 74 0a 20 20 20 20 2a 2a 20 61 73 73 65 72 not. ** asser
ffa0: 74 28 29 20 77 61 73 20 65 6e 61 62 6c 65 64 20 t() was enabled
ffb0: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e at compile-time.
ffc0: 20 20 49 66 20 58 20 69 73 20 74 72 75 65 20 61 If X is true a
ffd0: 6e 64 20 61 73 73 65 72 74 28 29 0a 20 20 20 20 nd assert().
ffe0: 2a 2a 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 ** is enabled, t
fff0: 68 65 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 hen the return v
10000 61 6c 75 65 20 69 73 20 74 72 75 65 2e 20 20 49 alue is true. I
10010 66 20 58 20 69 73 20 74 72 75 65 20 61 6e 64 0a f X is true and.
10020 20 20 20 20 2a 2a 20 61 73 73 65 72 74 28 29 20 ** assert()
10030 69 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 is disabled, the
10040 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c n the return val
10050 75 65 20 69 73 20 7a 65 72 6f 2e 20 20 49 66 20 ue is zero. If
10060 58 20 69 73 0a 20 20 20 20 2a 2a 20 66 61 6c 73 X is. ** fals
10070 65 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 e and assert() i
10080 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20 s enabled, then
10090 74 68 65 20 61 73 73 65 72 74 69 6f 6e 20 66 69 the assertion fi
100a0 72 65 73 20 61 6e 64 20 74 68 65 0a 20 20 20 20 res and the.
100b0 2a 2a 20 70 72 6f 63 65 73 73 20 61 62 6f 72 74 ** process abort
100c0 73 2e 20 20 49 66 20 58 20 69 73 20 66 61 6c 73 s. If X is fals
100d0 65 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 69 e and assert() i
100e0 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 65 6e s disabled, then
100f0 20 74 68 65 0a 20 20 20 20 2a 2a 20 72 65 74 75 the. ** retu
10100 72 6e 20 76 61 6c 75 65 20 69 73 20 7a 65 72 6f rn value is zero
10110 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 .. */. cas
10120 65 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 e SQLITE_TESTCTR
10130 4c 5f 41 53 53 45 52 54 3a 20 7b 0a 20 20 20 20 L_ASSERT: {.
10140 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 78 volatile int x
10150 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 = 0;. asse
10160 72 74 28 20 28 78 20 3d 20 76 61 5f 61 72 67 28 rt( (x = va_arg(
10170 61 70 2c 69 6e 74 29 29 21 3d 30 20 29 3b 0a 20 ap,int))!=0 );.
10180 20 20 20 20 20 72 63 20 3d 20 78 3b 0a 20 20 20 rc = x;.
10190 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
101a0 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 .. /*. **
101b0 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
101c0 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
101d0 54 43 54 52 4c 5f 41 4c 57 41 59 53 2c 20 69 6e TCTRL_ALWAYS, in
101e0 74 20 58 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t X). **.
101f0 2a 2a 20 54 68 69 73 20 61 63 74 69 6f 6e 20 70 ** This action p
10200 72 6f 76 69 64 65 73 20 61 20 72 75 6e 2d 74 69 rovides a run-ti
10210 6d 65 20 74 65 73 74 20 74 6f 20 73 65 65 20 68 me test to see h
10220 6f 77 20 74 68 65 20 41 4c 57 41 59 53 20 61 6e ow the ALWAYS an
10230 64 0a 20 20 20 20 2a 2a 20 4e 45 56 45 52 20 6d d. ** NEVER m
10240 61 63 72 6f 73 20 77 65 72 65 20 64 65 66 69 6e acros were defin
10250 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ed at compile-ti
10260 6d 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a me.. **. *
10270 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c * The return val
10280 75 65 20 69 73 20 41 4c 57 41 59 53 28 58 29 2e ue is ALWAYS(X).
10290 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a . **. **
102a0 20 54 68 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 The recommended
102b0 20 74 65 73 74 20 69 73 20 58 3d 3d 32 2e 20 20 test is X==2.
102c0 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 If the return va
102d0 6c 75 65 20 69 73 20 32 2c 20 74 68 61 74 20 6d lue is 2, that m
102e0 65 61 6e 73 0a 20 20 20 20 2a 2a 20 41 4c 57 41 eans. ** ALWA
102f0 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 28 29 YS() and NEVER()
10300 20 61 72 65 20 62 6f 74 68 20 6e 6f 2d 6f 70 20 are both no-op
10310 70 61 73 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 pass-through mac
10320 72 6f 73 2c 20 77 68 69 63 68 20 69 73 20 74 68 ros, which is th
10330 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 e. ** default
10340 20 73 65 74 74 69 6e 67 2e 20 20 49 66 20 74 68 setting. If th
10350 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 e return value i
10360 73 20 31 2c 20 74 68 65 6e 20 41 4c 57 41 59 53 s 1, then ALWAYS
10370 28 29 20 69 73 20 65 69 74 68 65 72 0a 20 20 20 () is either.
10380 20 2a 2a 20 68 61 72 64 2d 63 6f 64 65 64 20 74 ** hard-coded t
10390 6f 20 74 72 75 65 20 6f 72 20 65 6c 73 65 20 69 o true or else i
103a0 74 20 61 73 73 65 72 74 73 20 69 66 20 69 74 73 t asserts if its
103b0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c argument is fal
103c0 73 65 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 se.. ** The f
103d0 69 72 73 74 20 62 65 68 61 76 69 6f 72 20 28 68 irst behavior (h
103e0 61 72 64 2d 63 6f 64 65 64 20 74 6f 20 74 72 75 ard-coded to tru
103f0 65 29 20 69 73 20 74 68 65 20 63 61 73 65 20 69 e) is the case i
10400 66 0a 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f f. ** SQLITE_
10410 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 20 TESTCTRL_ASSERT
10420 73 68 6f 77 73 20 74 68 61 74 20 61 73 73 65 72 shows that asser
10430 74 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 20 t() is disabled
10440 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 0a 20 and the second.
10450 20 20 20 2a 2a 20 62 65 68 61 76 69 6f 72 20 28 ** behavior (
10460 61 73 73 65 72 74 20 69 66 20 74 68 65 20 61 72 assert if the ar
10470 67 75 6d 65 6e 74 20 74 6f 20 41 4c 57 41 59 53 gument to ALWAYS
10480 28 29 20 69 73 20 66 61 6c 73 65 29 20 69 73 20 () is false) is
10490 74 68 65 20 63 61 73 65 20 69 66 0a 20 20 20 20 the case if.
104a0 2a 2a 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ** SQLITE_TESTCT
104b0 52 4c 5f 41 53 53 45 52 54 20 73 68 6f 77 73 20 RL_ASSERT shows
104c0 74 68 61 74 20 61 73 73 65 72 74 28 29 20 69 73 that assert() is
104d0 20 65 6e 61 62 6c 65 64 2e 0a 20 20 20 20 2a 2a enabled.. **
104e0 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 75 6e 2d . ** The run-
104f0 74 69 6d 65 20 74 65 73 74 20 70 72 6f 63 65 64 time test proced
10500 75 72 65 20 6d 69 67 68 74 20 6c 6f 6f 6b 20 73 ure might look s
10510 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 omething like th
10520 69 73 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a is:. **. *
10530 2a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 * if( sqlite3
10540 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 _test_control(SQ
10550 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 41 4c LITE_TESTCTRL_AL
10560 57 41 59 53 2c 20 32 29 3d 3d 32 20 29 7b 0a 20 WAYS, 2)==2 ){.
10570 20 20 20 2a 2a 20 20 20 20 20 20 2f 2f 20 41 4c ** // AL
10580 57 41 59 53 28 29 20 61 6e 64 20 4e 45 56 45 52 WAYS() and NEVER
10590 28 29 20 61 72 65 20 6e 6f 2d 6f 70 20 70 61 73 () are no-op pas
105a0 73 2d 74 68 72 6f 75 67 68 20 6d 61 63 72 6f 73 s-through macros
105b0 0a 20 20 20 20 2a 2a 20 20 20 20 7d 65 6c 73 65 . ** }else
105c0 20 69 66 28 20 73 71 6c 69 74 65 33 5f 74 65 73 if( sqlite3_tes
105d0 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
105e0 5f 54 45 53 54 43 54 52 4c 5f 41 53 53 45 52 54 _TESTCTRL_ASSERT
105f0 2c 20 31 29 20 29 7b 0a 20 20 20 20 2a 2a 20 20 , 1) ){. **
10600 20 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 // ALWAYS(x)
10610 20 61 73 73 65 72 74 73 20 74 68 61 74 20 78 20 asserts that x
10620 69 73 20 74 72 75 65 2e 20 4e 45 56 45 52 28 78 is true. NEVER(x
10630 29 20 61 73 73 65 72 74 73 20 78 20 69 73 20 66 ) asserts x is f
10640 61 6c 73 65 2e 0a 20 20 20 20 2a 2a 20 20 20 20 alse.. **
10650 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 2a 20 20 20 }else{. **
10660 20 20 20 2f 2f 20 41 4c 57 41 59 53 28 78 29 20 // ALWAYS(x)
10670 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 31 2e is a constant 1.
10680 20 20 4e 45 56 45 52 28 78 29 20 69 73 20 61 20 NEVER(x) is a
10690 63 6f 6e 73 74 61 6e 74 20 30 2e 0a 20 20 20 20 constant 0..
106a0 2a 2a 20 20 20 20 7d 0a 20 20 20 20 2a 2f 0a 20 ** }. */.
106b0 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 54 case SQLITE_T
106c0 45 53 54 43 54 52 4c 5f 41 4c 57 41 59 53 3a 20 ESTCTRL_ALWAYS:
106d0 7b 0a 20 20 20 20 20 20 69 6e 74 20 78 20 3d 20 {. int x =
106e0 76 61 5f 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a va_arg(ap,int);.
106f0 20 20 20 20 20 20 72 63 20 3d 20 41 4c 57 41 59 rc = ALWAY
10700 53 28 78 29 3b 0a 20 20 20 20 20 20 62 72 65 61 S(x);. brea
10710 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a k;. }.. /*
10720 20 20 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f sqlite3_test_
10730 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 control(SQLITE_T
10740 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 45 2c ESTCTRL_RESERVE,
10750 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e sqlite3 *db, in
10760 74 20 4e 29 0a 20 20 20 20 2a 2a 0a 20 20 20 20 t N). **.
10770 2a 2a 20 53 65 74 20 74 68 65 20 6e 52 65 73 65 ** Set the nRese
10780 72 76 65 20 73 69 7a 65 20 74 6f 20 4e 20 66 6f rve size to N fo
10790 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 r the main datab
107a0 61 73 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 ase on the datab
107b0 61 73 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 ase. ** conne
107c0 63 74 69 6f 6e 20 64 62 2e 0a 20 20 20 20 2a 2f ction db.. */
107d0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
107e0 5f 54 45 53 54 43 54 52 4c 5f 52 45 53 45 52 56 _TESTCTRL_RESERV
107f0 45 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 E: {. sqlit
10800 65 33 20 2a 64 62 20 3d 20 76 61 5f 61 72 67 28 e3 *db = va_arg(
10810 61 70 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 20 ap, sqlite3*);.
10820 20 20 20 20 20 69 6e 74 20 78 20 3d 20 76 61 5f int x = va_
10830 61 72 67 28 61 70 2c 69 6e 74 29 3b 0a 20 20 20 arg(ap,int);.
10840 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
10850 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 _enter(db->mutex
10860 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
10870 42 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65 BtreeSetPageSize
10880 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 2c (db->aDb[0].pBt,
10890 20 30 2c 20 78 2c 20 30 29 3b 0a 20 20 20 20 20 0, x, 0);.
108a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
108b0 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b eave(db->mutex);
108c0 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 . break;.
108d0 20 20 7d 0a 0a 20 20 7d 0a 20 20 76 61 5f 65 6e }.. }. va_en
108e0 64 28 61 70 29 3b 0a 23 65 6e 64 69 66 20 2f 2a d(ap);.#endif /*
108f0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 SQLITE_OMIT_BUI
10900 4c 54 49 4e 5f 54 45 53 54 20 2a 2f 0a 20 20 72 LTIN_TEST */. r
10910 65 74 75 72 6e 20 72 63 3b 0a 7d 0a eturn rc;.}.